Skip to content

anbeime/skill / skills/hairline/hairline

hairline

Flagged

一句话生成跟随鼠标的交互式等轴测线框图(单文件、零依赖、双击即开),或把已有 SVG/Logo 重建为可交互线框。

FileKindSize
.github/FUNDING.ymlconfig20 B
.github/workflows/ci.ymlconfig1.2 KB
.github/workflows/consumers.ymlconfig954 B
.github/workflows/publish.ymlconfig3.0 KB
.gitignoreother351 B
.npmrcother55 B
CHANGELOG.mdmarkdown7.6 KB
CONTRIBUTING.mdmarkdown4.5 KB
LICENSEother1.0 KB
README.mdmarkdown11.5 KB
SKILL.mdskill md1.2 KB
apps/site/.gitignoreother82 B
apps/site/.vitest/json/output.jsonconfig22.3 KB
apps/site/app/docs/page.tsxother2.9 KB
apps/site/app/docs/sections.tsxother8.1 KB
apps/site/app/figures/page.tsxother2.4 KB
apps/site/app/globals.cssother43.7 KB
apps/site/app/inspo/page.tsxother14.0 KB
apps/site/app/layout.tsxother978 B
apps/site/app/llms.txt/route.tsscript228 B
apps/site/app/og/page.tsxother1.5 KB
apps/site/app/page.tsxother1.7 KB
apps/site/app/robots.tsscript382 B
apps/site/app/sitemap.tsscript382 B
apps/site/app/skills/page.tsxother6.2 KB
apps/site/components/anchor.tsxother1.3 KB
apps/site/components/assembly.tsxother10.2 KB
apps/site/components/catalogue.tsxother18.6 KB
apps/site/components/chrome.tsxother2.3 KB
apps/site/components/code-block.tsxother895 B
apps/site/components/command.tsxother1.6 KB
apps/site/components/copy.tsxother2.6 KB
apps/site/components/example-frame.tsxother3.1 KB
apps/site/components/install.tsxother1.7 KB
apps/site/components/made-frame.tsxother2.0 KB
apps/site/components/rail.tsxother11.0 KB
apps/site/components/skill-link.tsxother861 B
apps/site/components/tabs.tsxother4.1 KB
apps/site/next.config.mjsscript493 B
apps/site/package.jsonmanifest927 B
apps/site/playwright.config.tsscript485 B
apps/site/postcss.config.mjsscript60 B
apps/site/public/icon.svgother262 B
apps/site/public/inspo/craft.webpbinary61.9 KB
apps/site/public/inspo/dissection.webpbinary177.4 KB
apps/site/public/inspo/figures.webpbinary56.9 KB
apps/site/public/inspo/linear.webpbinary15.6 KB
apps/site/public/inspo/tune.webpbinary58.5 KB
apps/site/public/og.pngbinary94.3 KB
apps/site/public/skill/hairline-clearance.htmlother39.5 KB
apps/site/public/skill/hairline-cursor-tab.htmlother43.4 KB
apps/site/public/skill/hairline-deploy-liftoff.htmlother43.3 KB
apps/site/public/skill/hairline-firecrawl-reader.htmlother46.6 KB
apps/site/public/skill/hairline-funnel.htmlother40.4 KB
apps/site/public/skill/hairline-linear-cycle.htmlother43.5 KB
apps/site/public/skill/hairline-mastra.htmlother44.6 KB
apps/site/public/skill/hairline-notion.htmlother41.5 KB
apps/site/public/skill/hairline-resend-belt.htmlother46.5 KB
apps/site/public/skill/hairline-sidings.htmlother43.1 KB
apps/site/public/skill/hairline-storm.htmlother42.6 KB
apps/site/public/skill/hairline-vercel.htmlother40.6 KB
apps/site/test/catalogue.test.tsscript2.7 KB
apps/site/test/docs.test.tsscript8.9 KB
apps/site/test/figures.spec.tsscript15.0 KB
apps/site/test/share.test.tsscript652 B
apps/site/test/site.spec.tsscript44.8 KB
apps/site/test/skill.spec.tsscript17.8 KB
apps/site/test/skill.test.tsscript5.4 KB
apps/site/tsconfig.jsonconfig444 B
apps/site/turbo.jsonconfig364 B
apps/site/vercel.jsonconfig214 B
apps/site/vitest.config.tsscript265 B
assets/hero.gifbinary3.7 MB
fixtures/next-app/.gitignoreother123 B
fixtures/next-app/app/layout.tsxother281 B
fixtures/next-app/app/page.tsxother587 B
fixtures/next-app/app/registry/page.tsxother714 B
fixtures/next-app/app/vanilla.tsxother353 B
fixtures/next-app/next.config.mjsscript104 B
fixtures/next-app/package.jsonmanifest364 B
fixtures/next-app/tsconfig.jsonconfig590 B
fixtures/vite-vanilla/.gitignoreother38 B
fixtures/vite-vanilla/index.htmlother1.3 KB
fixtures/vite-vanilla/package.jsonmanifest245 B
fixtures/vite-vanilla/src/main.tsscript1.3 KB
fixtures/vite-vanilla/tsconfig.jsonconfig248 B
package.jsonmanifest895 B
packages/hairline/package.jsonmanifest2.4 KB
packages/hairline/playwright.config.tsscript637 B
packages/hairline/src/core/iso.tsscript9.1 KB
packages/hairline/src/core/motion.tsscript3.8 KB
packages/hairline/src/core/stage.tsscript15.0 KB
packages/hairline/src/core/styles.tsscript4.1 KB
packages/hairline/src/figures/basket.tsscript9.5 KB
packages/hairline/src/figures/branches.tsscript7.7 KB
packages/hairline/src/figures/cabinet.tsscript7.8 KB
packages/hairline/src/figures/dish.tsscript9.7 KB
packages/hairline/src/figures/drawer.tsscript7.5 KB
packages/hairline/src/figures/elevator.tsscript7.6 KB
packages/hairline/src/figures/exploded.tsscript5.2 KB
packages/hairline/src/figures/format.tsscript6.2 KB
packages/hairline/src/figures/hub.tsscript8.6 KB
packages/hairline/src/figures/keyboard.tsscript6.3 KB
packages/hairline/src/figures/laptop.tsscript7.3 KB
packages/hairline/src/figures/lockers.tsscript7.6 KB
packages/hairline/src/figures/loupe.tsscript6.1 KB
packages/hairline/src/figures/padlock.tsscript7.7 KB
packages/hairline/src/figures/patch.tsscript10.1 KB
packages/hairline/src/figures/phone.tsscript9.6 KB
packages/hairline/src/figures/phosphor.tsscript5.6 KB
packages/hairline/src/figures/plot.tsscript5.4 KB
packages/hairline/src/figures/plug.tsscript9.7 KB
packages/hairline/src/figures/query.tsscript8.8 KB
packages/hairline/src/figures/rail.tsscript4.9 KB
packages/hairline/src/figures/rebuild.tsscript10.3 KB
packages/hairline/src/figures/relay.tsscript8.0 KB
packages/hairline/src/figures/riffle-geometry.tsscript4.2 KB
packages/hairline/src/figures/riffle.tsscript5.2 KB
packages/hairline/src/figures/router.tsscript6.4 KB
packages/hairline/src/figures/settle.tsscript8.6 KB
packages/hairline/src/figures/sieve.tsscript5.9 KB
packages/hairline/src/figures/slow.tsscript7.2 KB
packages/hairline/src/figures/stack.tsscript5.5 KB
packages/hairline/src/figures/terminal.tsscript8.1 KB
packages/hairline/src/figures/terrain.tsscript4.4 KB
packages/hairline/src/figures/turntable-geometry.tsscript3.9 KB
packages/hairline/src/figures/turntable.tsscript6.5 KB
packages/hairline/src/figures/vault.tsscript9.8 KB
packages/hairline/src/index.tsscript17.9 KB
packages/hairline/src/intensity.tsscript3.2 KB
packages/hairline/src/mount.tsscript6.5 KB
packages/hairline/src/react.tsxother9.5 KB
packages/hairline/src/slab.tsscript3.1 KB
packages/hairline/test/browser/entry.tsscript1.4 KB
packages/hairline/test/browser/figures.spec.tsscript6.3 KB
packages/hairline/test/browser/harness.htmlother321 B
packages/hairline/test/browser/look.spec.tsscript9.5 KB
packages/hairline/test/browser/parity.spec.tsscript2.4 KB
packages/hairline/test/browser/read.spec.tsscript8.9 KB
packages/hairline/test/browser/serve.mjsscript1.7 KB
packages/hairline/test/browser/skill.spec.tsscript12.3 KB
packages/hairline/test/browser/theme.spec.tsscript3.9 KB
packages/hairline/test/dom.tsscript3.0 KB
packages/hairline/test/geometry.test.tsscript2.8 KB
packages/hairline/test/intensity.test.tsscript2.1 KB
packages/hairline/test/mount.test.tsscript33.1 KB
packages/hairline/test/parity/capture.mjsscript3.6 KB
packages/hairline/test/parity/clock.jsscript3.8 KB
packages/hairline/test/parity/driver.mjsscript1.9 KB
packages/hairline/test/parity/golden/exploded.jsonconfig24.7 KB
packages/hairline/test/parity/golden/phosphor.jsonconfig28.5 KB
packages/hairline/test/parity/golden/riffle.jsonconfig137.5 KB
packages/hairline/test/parity/golden/slow.jsonconfig41.4 KB
packages/hairline/test/parity/golden/terrain.jsonconfig216.7 KB
packages/hairline/test/parity/golden/turntable.jsonconfig32.3 KB
packages/hairline/test/parity/scripts.mjsscript2.8 KB
packages/hairline/test/react.test.tsxother7.5 KB
packages/hairline/test/skill/adopt.test.tsscript1.4 KB
packages/hairline/test/skill/build.test.tsscript3.3 KB
packages/hairline/test/skill/fixtures/broken.txtmarkdown19 B
packages/hairline/test/skill/fixtures/compound.svgother148 B
packages/hairline/test/skill/fixtures/illustrator.svgother334 B
packages/hairline/test/skill/fixtures/light.svgother123 B
packages/hairline/test/skill/fixtures/mark.svgother226 B
packages/hairline/test/skill/fixtures/mixed.svgother530 B
packages/hairline/test/skill/fixtures/moved.svgother182 B
packages/hairline/test/skill/fixtures/nested.svgother274 B
packages/hairline/test/skill/fixtures/rocket.svgother577 B
packages/hairline/test/skill/fixtures/scripted.svgother199 B
packages/hairline/test/skill/kernel.test.tsscript1.8 KB
packages/hairline/test/skill/look.test.tsscript2.2 KB
packages/hairline/test/skill/read.test.tsscript9.5 KB
packages/hairline/test/skill/shape.test.tsscript8.6 KB
packages/hairline/test/skill/validate.test.tsscript10.1 KB
packages/hairline/test/ssr.test.tsxother1.1 KB
packages/hairline/test/stage.test.tsscript11.6 KB
packages/hairline/test/types.test-d.tsxother4.9 KB
packages/hairline/tsconfig.jsonconfig212 B
packages/hairline/tsup.config.tsscript844 B
packages/hairline/vitest.config.tsscript163 B
pnpm-lock.yamlmanifest129.1 KB
pnpm-workspace.yamlconfig142 B
registry/build.mjsscript1.8 KB
registry/src/hairline.tsxother4.7 KB
registry/validate.mjsscript2.2 KB
scripts/base-url.mjsscript1.4 KB
scripts/changelog.mjsscript1.3 KB
scripts/consumers.mjsscript7.4 KB
scripts/kernel.mjsscript8.8 KB
scripts/og.mjsscript1.7 KB
scripts/release.mjsscript8.0 KB
tsconfig.base.jsonconfig442 B
turbo.jsonconfig620 B

apps/site/components/rail.tsx

View on GitHub
"use client";

import { useEffect, useLayoutEffect, useRef, useState, type CSSProperties, type ReactNode } from "react";

export type RailIcon = "bolt" | "braces" | "stack" | "book" | "sparkle" | "path";
export type RailGroup = { title: string; icon: RailIcon; color: string; items: { id: string; title: string }[] };

const svg = (children: ReactNode) => (
  <svg viewBox="0 0 16 16" width="16" height="16" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
    {children}
  </svg>
);

/** A group's mark, drawn in the group's colour: a light fill under a line, as the page's other icons are drawn. */
const ICONS: Record<RailIcon, ReactNode> = {
  bolt: svg(<path d="M9 1.75 3.5 9h4L7 14.25 12.5 7h-4L9 1.75Z" fill="currentColor" fillOpacity=".2" />),
  braces: svg(
    <>
      <rect x="1.75" y="2.75" width="12.5" height="10.5" rx="2.5" fill="currentColor" fillOpacity=".2" stroke="none" />
      <path d="M6 5c-1 0-1.25.5-1.25 1.25v.5C4.75 7.5 4.5 8 3.75 8c.75 0 1 .5 1 1.25v.5C4.75 10.5 5 11 6 11M10 5c1 0 1.25.5 1.25 1.25v.5c0 .75.25 1.25 1 1.25-.75 0-1 .5-1 1.25v.5c0 .75-.25 1.25-1.25 1.25" />
    </>,
  ),
  stack: svg(
    <>
      <path d="m8 2 6 3-6 3-6-3 6-3Z" fill="currentColor" fillOpacity=".2" />
      <path d="m2 8 6 3 6-3M2 11l6 3 6-3" />
    </>,
  ),
  book: svg(
    <>
      <path d="M2.5 3.25A1.5 1.5 0 0 1 4 1.75h9.5v10H4a1.5 1.5 0 0 0-1.5 1.5v-10Z" fill="currentColor" fillOpacity=".16" />
      <path d="M2.5 13.25a1.5 1.5 0 0 0 1.5 1.5h9.5v-3" />
    </>,
  ),
  sparkle: svg(
    <>
      <path d="M8 1.75c.4 3.1 1.9 4.6 5 5-3.1.4-4.6 1.9-5 5-.4-3.1-1.9-4.6-5-5 3.1-.4 4.6-1.9 5-5Z" fill="currentColor" fillOpacity=".2" />
      <path d="M12.75 11.25v2.5M11.5 12.5H14" />
    </>,
  ),
  path: svg(
    <>
      <path d="M3 13c.5-5 3.5-9.5 10-10" />
      <rect x="1.75" y="11.75" width="2.5" height="2.5" rx=".6" fill="currentColor" fillOpacity=".2" />
      <rect x="11.75" y="1.75" width="2.5" height="2.5" rx=".6" fill="currentColor" fillOpacity=".2" />
    </>,
  ),
};

/**
 * The section in view: the first one, in page order, inside a band from under the sticky chrome (a section's
 * scroll-margin-top, read each time, as it differs on a phone) to 30% down the viewport. Null in a gap between two
 * sections, where the mark stays put.
 */
function inView(sections: HTMLElement[]): string | null {
  const first = sections[0].id;
  const last = sections[sections.length - 1].id;
  const top = parseFloat(getComputedStyle(sections[0]).scrollMarginTop) || 0;
  const bottom = window.innerHeight * 0.3;
  if (window.innerHeight + window.scrollY >= document.documentElement.scrollHeight - 2) {
    // the last section is too short to reach the band, so the end of the page marks it; unless the reader asked for
    // a section the page could only bring into view, on a screen taller than what is left below it
    const asked = sections.find((s) => `#${s.id}` === window.location.hash);
    const at = asked?.getBoundingClientRect();
    return asked && at && at.top >= 0 && at.top < window.innerHeight ? asked.id : last;
  }
  const hit = sections.find((s) => {
    const at = s.getBoundingClientRect();
    // a pixel of slack: the section scrolled to sits flush under the chrome, and the one before can end a fraction below
    return at.bottom > top + 1 && at.top < bottom;
  });
  if (hit) return hit.id;
  // above the first section nothing is in the band, so the first is marked, as at the top
  return sections[0].getBoundingClientRect().top >= bottom ? first : null;
}

/**
 * Puts the strip's dot by the marked link's text, on its centre line. The first time, the dot appears in place; after
 * that it flies there.
 */
function place(list: HTMLElement | null, active: string) {
  const dot = list?.querySelector<HTMLElement>(".doc-dot");
  const link = list?.querySelector<HTMLElement>(`a[href="#${active}"]`);
  if (!list || !dot || !link || !list.clientWidth) return;
  const box = list.getBoundingClientRect();
  const at = link.getBoundingClientRect();
  const x = at.left - box.left + list.scrollLeft + parseFloat(getComputedStyle(link).paddingLeft);
  const y = at.top - box.top + list.scrollTop + (at.height - dot.offsetHeight) / 2;
  dot.style.translate = `${x}px ${y}px`;
  live(list);
}

/**
 * Draws the rail's line to the marked link: each group's trunk reaches down to where the marked row's arm starts to
 * bend (6px over its centre) and a pixel into it, so the two meet with no seam, or back up to nothing in the other
 * groups. The row's arm and tip take it from there, in CSS. Measured in fractions of a pixel, as the arm is placed.
 */
function reach(nav: HTMLElement | null, active: string) {
  if (!nav?.clientWidth) return;
  for (const list of nav.querySelectorAll<HTMLElement>("ul")) {
    const row = list.querySelector(`a[href="#${active}"]`)?.parentElement;
    let f = 0;
    if (row) {
      const box = list.getBoundingClientRect();
      const at = row.getBoundingClientRect();
      // the trunk runs from 2px over the list to its foot
      f = (at.top - box.top + at.height / 2 - 6 + 1 + 2) / (box.height + 2);
    }
    list.style.setProperty("--reach", String(f));
  }
  live(nav);
}

/** Transitions start once the first mark has been drawn, so the page opens with it in place. */
function live(el: HTMLElement) {
  if (!el.hasAttribute("data-live")) requestAnimationFrame(() => requestAnimationFrame(() => el.setAttribute("data-live", "")));
}

/**
 * A page's anchors, in the craft of a rail: fixed at the column's left edge from 1100px, each group's links hung off
 * its mark on a hairline; one sideways strip under the top bar below it. All are plain links, so they work without
 * JavaScript. The script marks the section in view, and nothing is marked until it runs: in the rail the line to it
 * is drawn in its group's colour and only its group stays lit; in the strip a dot flies to it.
 * A link picked by hand marks its section at once, and the mark holds while the page glides there.
 */
export function Rail({ label, groups }: { label: string; groups: RailGroup[] }) {
  const [active, setActive] = useState<string | null>(null);
  const [edges, setEdges] = useState({ start: false, end: false });
  const column = useRef<HTMLElement>(null);
  const strip = useRef<HTMLDivElement>(null);
  const held = useRef(0);
  const items = groups.flatMap((g) => g.items);
  const ids = items.map((s) => s.id).join(" ");

  useEffect(() => {
    const sections = ids.split(" ").map((id) => document.getElementById(id)).filter((el): el is HTMLElement => el !== null);
    if (!sections.length) return;
    let timer = 0;
    const pick = () => {
      if (performance.now() < held.current) return;
      const id = inView(sections);
      if (id) setActive(id);
    };
    const release = () => {
      held.current = 0;
      pick();
    };
    // a long glide outlasts the first second: while the page still moves, the mark stays held
    const scrolled = () => {
      if (held.current) {
        held.current = Math.max(held.current, performance.now() + 200);
        clearTimeout(timer);
        timer = window.setTimeout(release, held.current - performance.now());
        return;
      }
      pick();
    };
    const hold = (event: MouseEvent) => {
      const a = (event.target as Element | null)?.closest<HTMLAnchorElement>("a[href^='#']");
      const id = a?.hash.slice(1);
      if (!id || !sections.some((s) => s.id === id)) return;
      setActive(id);
      held.current = performance.now() + 1000;
      clearTimeout(timer);
      timer = window.setTimeout(release, 1000);
    };
    pick();
    window.addEventListener("scroll", scrolled, { passive: true });
    window.addEventListener("scrollend", release);
    window.addEventListener("resize", pick);
    document.addEventListener("click", hold);
    // the browser has already scrolled to a deep link's section, at once; the reader's own clicks from here on glide
    document.documentElement.dataset.smooth = "";
    return () => {
      clearTimeout(timer);
      window.removeEventListener("scroll", scrolled);
      window.removeEventListener("scrollend", release);
      window.removeEventListener("resize", pick);
      document.removeEventListener("click", hold);
      delete document.documentElement.dataset.smooth;
    };
  }, [ids]);

  useEffect(() => {
    const el = strip.current;
    if (!el) return;
    const measure = () => setEdges({ start: el.scrollLeft > 1, end: el.scrollLeft + el.clientWidth < el.scrollWidth - 1 });
    measure();
    el.addEventListener("scroll", measure, { passive: true });
    const resize = new ResizeObserver(measure);
    resize.observe(el);
    return () => {
      el.removeEventListener("scroll", measure);
      resize.disconnect();
    };
  }, []);

  // before paint, so the mark is never drawn by a link that is no longer marked
  useLayoutEffect(() => {
    if (!active) return;
    reach(column.current, active);
    place(strip.current, active);
    // a list that was hidden shows, or the window changes width: the line and the dot keep to their link
    const resize = new ResizeObserver(() => {
      reach(column.current, active);
      place(strip.current, active);
    });
    for (const el of [column.current, strip.current]) if (el) resize.observe(el);
    return () => resize.disconnect();
  }, [active]);

  // Brings the marked item into the strip by scrolling the strip alone. scrollIntoView would also scroll the
  // page, and would cut short the smooth scroll a click on the strip has just started.
  useEffect(() => {
    const el = strip.current;
    const item = el?.querySelector<HTMLElement>(`a[href="#${active}"]`);
    if (!el || !item || !el.clientWidth) return;
    const pad = 24;
    const box = el.getBoundingClientRect();
    const at = item.getBoundingClientRect();
    if (at.left - pad < box.left) el.scrollTo({ left: el.scrollLeft + at.left - pad - box.left });
    else if (at.right + pad > box.right) el.scrollTo({ left: el.scrollLeft + at.right + pad - box.right });
  }, [active]);

  const link = (id: string, title: string) => (
    <li key={id}>
      <a href={`#${id}`} className="doc-link" aria-current={id === active ? "location" : undefined}>
        <span>{title}</span>
      </a>
    </li>
  );
  const dot = active && <span className="doc-dot" aria-hidden />;
  const tint = (color: string) => ({ "--gc": color }) as CSSProperties;

  return (
    <>
      <aside className="rail fade-mask-y">
        <nav ref={column} aria-label={label} className="doc-sidebar">
          {groups.map((group) => (
            <div key={group.title} className="rail-group" style={tint(group.color)}>
              <p className="rail-title">{ICONS[group.icon]}{group.title}</p>
              <ul>{group.items.map((s) => link(s.id, s.title))}</ul>
            </div>
          ))}
        </nav>
      </aside>
      <nav aria-label={label} className="doc-strip">
        <div ref={strip} className="doc-strip-scroll" data-start={edges.start || undefined} data-end={edges.end || undefined}>
          <ul>{items.map((s) => link(s.id, s.title))}</ul>
          {dot}
        </div>
      </nav>
    </>
  );
}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall