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

packages/hairline/test/skill/validate.test.ts

View on GitHub
import { execFileSync, spawnSync } from "node:child_process";
import { mkdtempSync, readFileSync, symlinkSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { fileURLToPath } from "node:url";
import { describe, expect, it } from "vitest";
import { same } from "../../../../skills/hairline-create/validate.mjs";

/**
 * validate.mjs passes the two examples and fails a page broken in one way,
 * naming that way and no other. The broken pages are Terrain with one change.
 */
const SKILL = fileURLToPath(new URL("../../../../skills/hairline-create/", import.meta.url));
const dir = mkdtempSync(join(tmpdir(), "hl-validate-"));
const terrain = readFileSync(SKILL + "examples/terrain.js", "utf8");
let n = 0;

/** Builds a figure's page, changes the page if asked, and validates it. */
function check(figure: string, change?: (page: string) => string, script = SKILL + "validate.mjs") {
  const src = join(dir, `f${++n}.js`), out = join(dir, `f${n}.html`);
  writeFileSync(src, figure);
  execFileSync("node", [SKILL + "build.mjs", src, out]);
  if (change) writeFileSync(out, change(readFileSync(out, "utf8")));
  const run = spawnSync("node", [script, out], { encoding: "utf8" });
  return { status: run.status, out: run.stdout, err: run.stderr };
}
/** Terrain with a line of code just before its declaration. */
const plus = (code: string) => terrain.replace("hairline({", () => `${code}\nhairline({`);

describe("pages that pass", () => {
  for (const name of ["terrain", "riffle"]) {
    it(`the ${name} example`, () => {
      const figure = readFileSync(`${SKILL}examples/${name}.js`, "utf8");
      expect(figure.trim().split("\n").length).toBeLessThanOrEqual(200);
      const run = check(figure);
      expect(run.err).toBe("");
      expect(run.status).toBe(0);
      expect(run.out).toMatch(/^ok .*kernel and bench intact/);
    });
  }

  it("a page saved with CRLF line endings", () => {
    expect(check(terrain, (page) => page.replace(/\n/g, "\r\n")).status).toBe(0);
  });

  it("a range that falls, as Slow's does", () => {
    expect(check(terrain.replace("range: [1.5, 3, 5]", "range: [5, 3, 1.5]")).status).toBe(0);
  });

  it("through a symlink to the skill folder", () => {
    const link = join(dir, "linked");
    symlinkSync(SKILL, link);
    const run = check(terrain, undefined, join(link, "validate.mjs"));
    expect(run.status).toBe(0);
    expect(run.out).toMatch(/^ok /);
  });
});

/** Honest code that only looks like a broken rule: a good figure with any of these changes still passes. */
const HONEST: [why: string, figure: string][] = [
  ["an identifier named gradient, for a slope", plus("const gradient = 0.5;")],
  ["a read-out with a number sign", plus('const label = "pillar #101";')],
  ["the word import in a string", plus('const note = "import";')],
  ["the word import inside a longer name", plus("const important = true;")],
  ["a name that starts with import, before a comma", plus("const [important, b] = [1, 2];")],
  ["a name that starts with import, as an argument", plus("f(imported, 1);")],
  ["a tset given a delay of 0, with a call among its values", plus("HL.tset(HL.tween(0), Math.max(1, 2), performance.now(), 0);")],
  ["a name that ends in tset", plus("const offset = (a, b) => a + b;\noffset(1, 2);")],
  ["a tset written in a string", plus('const note = "tset(a, b)";')],
  ["a handle returned in shorthand, { set, destroy }", terrain.replace(
    /return \{\n {4}set: (\(v\) => \{[^\n]*\}),\n {4}destroy: bag\.dispose,\n {2}\};/,
    (_, set) => `const set = ${set};\n  const destroy = bag.dispose;\n  return { set, destroy };`,
  )],
];

describe("honest changes that pass", () => {
  it("each change is made", () => {
    for (const [why, figure] of HONEST) expect(figure, why).not.toBe(terrain);
  });
  for (const [why, figure] of HONEST) {
    it(why, () => {
      const run = check(figure);
      expect(run.err).toBe("");
      expect(run.status).toBe(0);
    });
  }
});

const BROKEN: [id: string, why: string, figure: string, change?: (page: string) => string][] = [
  ["kernel", "the kernel was edited", terrain, (page) => page.replace("var HL = ", "var HL = /* mine */ ")],
  ["bench", "the bench was edited", terrain, (page) => page.replace("</main>", "<p>better</p></main>")],
  ["text", "a text element", plus('mk("text", {}, document.querySelector("svg"));')],
  ["text", "markup written as a string", plus('document.querySelector("svg").innerHTML = "";')],
  ["paint", "a fill of its own", plus('mk("path", { fill: "red" });')],
  ["paint", "a stroke width of its own", plus('mk("path", { "stroke-width": 2 });')],
  ["paint", "an inline style", plus('document.body.style.background = "#000";')],
  ["paint", "a colour in hex", plus('const ink = "#a1b2c3";')],
  ["paint", "an opacity of its own", plus('mk("path", { opacity: 0.5 });')],
  ["paint", "a stroke opacity of its own", plus('mk("path", { "stroke-opacity": 0.5 });')],
  ["paint", "a fill opacity of its own", plus('mk("path", { "fill-opacity": 0.5 });')],
  ["paint", "an opacity set by hand", plus('svg.setAttribute("opacity", "0.5");')],
  ["paint", "a gradient element", plus('mk("linearGradient", {});')],
  ["outside", "a fetch", plus('fetch("https://example.com/data.json");')],
  ["outside", "a node made by hand", plus('document.createElementNS("http://www.w3.org/2000/svg", "path");')],
  ["outside", "a script tag in a string", plus('const s = "</script>";')],
  ["outside", "an import statement", plus('import { x } from "./x.js";')],
  ["outside", "a default import", plus('import x from "./x.js";')],
  ["outside", "a namespace import", plus('import * as x from "./x.js";')],
  ["outside", "a dynamic import", plus('import("./x.js");')],
  ["outside", "a URL in a string", plus('const u = "https://example.com/a.json";')],
  ["clock", "its own frame", plus("requestAnimationFrame(() => {});")],
  ["clock", "its own timer", plus("setTimeout(() => {}, 100);")],
  ["clock", "an SMIL animate element", plus('mk("animate", { dur: "1s", repeatCount: "indefinite" });')],
  ["clock", "an SMIL animateTransform element", plus('mk("animateTransform", { type: "rotate", dur: "1s", repeatCount: "indefinite" });')],
  ["clock", "an SMIL animateMotion element", plus("mk('animateMotion', { dur: \"1s\", repeatCount: \"indefinite\" });")],
  ["clock", "a timer after a // in a string", plus('const s = "a // b"; setTimeout(() => {}, 1);')],
  ["clock", "no kernel loop", terrain.replace("register(stage,", "((s, t) => ({ wake() {}, unregister() {} }))(stage,")],
  ["tween", "a tset without its delay", plus("HL.tset(HL.tween(0), 1, performance.now());")],
  ["tween", "a tset without its delay, with a call among its values", plus("HL.tset(HL.tween(0), Math.max(1, 2), performance.now());")],
  ["hit", "a box measured on screen", plus("stage.getBoundingClientRect();")],
  ["hit", "its own listener", plus('stage.addEventListener("pointermove", () => {});')],
  ["hit", "no pointer", terrain.replace("bag.add(pointer(stage,", "bag.add(((s, h) => () => {})(stage,")],
  ["readout", "no read-out", terrain.replace(/read\.textContent = [^;]+;/g, "")],
  ["handle", "no set, beside a Map's set", plus("new Map().set(1, 2);").replace("set: (v) =>", "put: (v) =>")],
  ["handle", "no destroy", terrain.replace("destroy: bag.dispose", "stop: bag.dispose")],
  ["declare", "no means", terrain.replace(/\n {2}means: .*\n/, "\n")],
  ["declare", "a range that turns back", terrain.replace("range: [1.5, 3, 5]", "range: [1.5, 5, 3]")],
  ["declare", "a rule that does not exist", terrain.replace("rules: [1, 3, 5, 9]", "rules: [1, 11]")],
  ["declare", "no declaration", terrain.replace(/hairline\(\{[\s\S]*$/, "")],
  ["tour", "no tour", terrain.replace(/\n {2}tour: .*\n/, "\n")],
  ["tour", "two stops", terrain.replace(/tour: \[.*\],/, "tour: [[128, 150], null],")],
  ["tour", "seven stops", terrain.replace(/tour: \[.*\],/, "tour: [[10, 10], [20, 20], [30, 30], [40, 40], [50, 50], [60, 60], null],")],
  ["tour", "a stop outside the viewBox", terrain.replace("[272, 150]", "[500, 100]")],
  ["tour", "every stop null", terrain.replace(/tour: \[.*\],/, "tour: [null, null, null],")],
  ["tour", "a figure that starts its own tour", plus("HL.tour(stage, [[1, 2]]);")],
  ["length", "over 200 lines", plus(Array.from({ length: 200 }, (_, i) => `const pad${i} = ${i};`).join("\n"))],  ["parse", "a const declared twice, so the module never loads", plus("const twice = 1;\nconst twice = 2;")],
];

describe("pages that fail, each for its own reason", () => {
  for (const [id, why, figure, change] of BROKEN) {
    it(`${id}: ${why}`, () => {
      const run = check(figure, change);
      expect(run.status).toBe(1);
      const ids = run.err.split("\n").map((line) => /^([a-z]+): /.exec(line)?.[1]).filter(Boolean);
      expect(ids.length).toBeGreaterThan(0);
      expect([...new Set(ids)]).toEqual([id]);
      expect(run.err).toMatch(/\d+ to fix in /);
    });
  }
});

it("says how to call it when it is given nothing, and when the file is not there", () => {
  const none = spawnSync("node", [SKILL + "validate.mjs"], { encoding: "utf8" });
  expect(none.status).toBe(2);
  expect(none.stderr).toContain("usage: node validate.mjs <page.html>");
  const gone = spawnSync("node", [SKILL + "validate.mjs", join(dir, "nope.html")], { encoding: "utf8" });
  expect(gone.status).toBe(2);
  expect(gone.stderr).toContain("cannot read");
});

it("knows a path that differs only in the case of its drive letter is the same path on Windows, and only there", () => {
  expect(same("C:\\x\\validate.mjs", "c:\\x\\validate.mjs", "win32")).toBe(true);
  expect(same("C:\\x\\validate.mjs", "c:\\x\\validate.mjs", "darwin")).toBe(false);
  expect(same("/x/validate.mjs", "/x/validate.mjs", "darwin")).toBe(true);
  expect(same("C:\\x\\validate.mjs", "C:\\x\\validate.mjs", "win32")).toBe(true);
});

it("names the syntax error that stops the figure loading, and its line", () => {
  const run = check(plus("const twice = 1;\nconst twice = 2;"));
  expect(run.status).toBe(1);
  expect(run.err).toContain("Identifier 'twice' has already been declared");
  const line = plus("const twice = 1;\nconst twice = 2;").trim().split("\n").indexOf("const twice = 2;") + 1;
  expect(run.err).toContain(`line ${line}`);
});
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