@estiva-app/ui 0.20.0 → 0.21.1

package/dist/gates/index.js

@@ -0,0 +1,417 @@
+#!/usr/bin/env node
+import {
+  ENGINE,
+  helpers,
+  runHook,
+  runStatus,
+  writeGateCount
+} from "./chunk-AUXD4GCY.js";
+import {
+  appFiles,
+  askNpm,
+  createApp,
+  themes
+} from "./chunk-ZGJ2J5NU.js";
+
+// src/gates/token-lint.ts
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import betterTailwindcss from "eslint-plugin-better-tailwindcss";
+import { getDefaultSelectors } from "eslint-plugin-better-tailwindcss/defaults";
+import { parser as typescriptParser } from "typescript-eslint";
+var TOKEN_LINT_IGNORES = ["dist/", "storybook-static/", "node_modules/"];
+var CLASS_MAP_SELECTOR = {
+  kind: "variable",
+  name: "^(?:[A-Z][A-Z0-9_]*_(?:STYLES|CLASSES)|[a-z][a-zA-Z0-9]*(?:Styles|Classes))$",
+  match: [{ type: "strings" }, { type: "objectValues" }]
+};
+var WORDS = {
+  app: {
+    ramp: "Tailwind's type ramp is not a token. Use the ramp from the package: text-body-2, text-caption, text-h3, text-btn-default...",
+    palette: "Tailwind's palette is not a token. Use a colour from the package (bg-bg-surface, text-text-primary, border-border-subtle...); a colour with no token is a missing token.",
+    raw: "A raw colour is a missing token: add it to the package (tokens.css in every theme block, and the preset), or say why not in an eslint-disable comment.",
+    opacity: "An opacity modifier on a token colour compiles to nothing. A transparent colour is a token of its own (D16): add it to the package.",
+    type: "$0 is type written by hand. A token from the package sets the size, line height, letter spacing and weight together (text-body-2, text-caption, text-h5...); if none fits, add one to the package, or say why not in an eslint-disable comment.",
+    corner: "$0 is a corner written by hand, and no token has it. Use a corner from the package (rounded-sm 4px, rounded-md 6px, rounded-lg 8px...), or say why not in an eslint-disable comment.",
+    shadow: "$0 is a shadow written by hand. Use a shadow from the package (shadow-sm, shadow-md, shadow-focus-ring, drop-shadow-glow-success...); a shadow with no token is a missing token."
+  },
+  package: {
+    ramp: "Tailwind's type ramp is not a token. Use the ramp in tailwind-preset.js: text-body-2, text-caption, text-h3, text-btn-default...",
+    palette: "Tailwind's palette is not a token. Use a colour from tailwind-preset.js (bg-bg-surface, text-text-primary, border-border-subtle...); a colour with no token is a missing token.",
+    raw: "A raw colour is a missing token: add it to tokens.css in every theme block and to the preset, or say why not in an eslint-disable comment.",
+    opacity: "An opacity modifier on a token colour compiles to nothing. A transparent colour is a token of its own (D16): add it to tokens.css in every theme block and to the preset.",
+    type: "$0 is type written by hand. A token from tailwind-preset.js sets the size, line height, letter spacing and weight together (text-body-2, text-caption, text-h5...); if none fits, add one to the preset and to cn.ts, or say why not in an eslint-disable comment.",
+    corner: "$0 is a corner written by hand, and no token has it. Use a corner from tailwind-preset.js (rounded-sm 4px, rounded-md 6px, rounded-lg 8px...), or say why not in an eslint-disable comment.",
+    shadow: "$0 is a shadow written by hand. Use a shadow from tailwind-preset.js (shadow-sm, shadow-md, shadow-focus-ring, drop-shadow-glow-success...); a shadow with no token is a missing token."
+  }
+};
+function tokenLint({ tailwindConfig = "tailwind.config.js", audience = "app" } = {}) {
+  const words = WORDS[audience];
+  return {
+    files: ["**/*.{ts,tsx}"],
+    languageOptions: {
+      parser: typescriptParser,
+      parserOptions: { ecmaFeatures: { jsx: true } }
+    },
+    plugins: { "better-tailwindcss": betterTailwindcss },
+    settings: {
+      "better-tailwindcss": {
+        tailwindConfig,
+        selectors: [...getDefaultSelectors(), CLASS_MAP_SELECTOR]
+      }
+    },
+    rules: {
+      "better-tailwindcss/no-unknown-classes": "error",
+      "better-tailwindcss/no-restricted-classes": [
+        "error",
+        {
+          restrict: [
+            { pattern: "^(?:[a-z0-9-]+:)*text-(?:xs|sm|base|lg|xl|[2-9]xl)$", message: words.ramp },
+            {
+              pattern: "^(?:[a-z0-9-]+:)*(?:text|bg|border|ring|outline|fill|stroke|decoration|divide|placeholder|from|via|to|accent|caret|shadow)-(?:black|white|slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)(?:-[0-9]{2,3})?(?:/[0-9]{1,3})?$",
+              message: words.palette
+            },
+            { pattern: "^(?:[a-z0-9-]+:)*[a-z-]+-\\[[^\\]]*(?:#[0-9a-fA-F]{3}|rgba?\\(|hsla?\\(|oklch\\()", message: words.raw },
+            {
+              pattern: "^(?:[a-z0-9-]+:)*(?:text|bg|border|ring|outline|fill|stroke|decoration|divide|placeholder|from|via|to|accent|caret|shadow)-(?:bg|text|border|accent|info|warning|success|error)-[a-z-]+/[0-9]{1,3}$",
+              message: words.opacity
+            }
+          ]
+        }
+      ]
+    }
+  };
+}
+var V = "^(?:(?:[^:\\[\\]\\s]|\\[[^\\]]*\\])+:)*!?";
+var NOT_COLOUR = "(?!color:|#|rgba?\\(|hsla?\\(|oklch\\(|var\\()";
+var HAND_WRITTEN = {
+  type: `${V}(?:text-\\[${NOT_COLOUR}|text-\\[length:|leading-\\[|tracking-\\[)[^\\]]+\\](?:/\\S*)?$`,
+  corner: `${V}rounded(?:-(?:t|r|b|l|s|e|tl|tr|br|bl|ss|se|es|ee))?-\\[[^\\]]+\\]$`,
+  shadow: `${V}(?:shadow|drop-shadow)-\\[(?!color:)[^\\]]+\\]$`,
+  spacing: `${V}-?(?:w|h|size|min-w|min-h|max-w|max-h|p[xytrblse]?|m[xytrblse]?|gap(?:-[xy])?|space-[xy]|inset(?:-[xy])?|top|right|bottom|left|translate-[xy]|basis|indent|scroll-[mp][xytrblse]?|border-spacing(?:-[xy])?)-\\[[^\\]]+\\]$`,
+  width: `${V}(?:border(?:-[xytrblse])?|divide-[xy]|outline|ring|ring-offset)-\\[(?:length:)?-?[0-9.]+(?:px|rem|em)?\\]$`
+};
+var INLINE_STYLE_TOKEN_PROPERTIES = "/^(color|background|backgroundColor|backgroundImage|fill|stroke|fontSize|border|borderTop|borderRight|borderBottom|borderLeft|borderBlock|borderInline|borderStyle|boxShadow|textShadow)$|Color$/";
+function loadPreset() {
+  const require2 = createRequire(import.meta.url);
+  const loadConfig = require2("tailwindcss/loadConfig");
+  return loadConfig(fileURLToPath(new URL("../../tailwind-preset.js", import.meta.url)));
+}
+function tokenValues({ audience = "app" } = {}) {
+  const words = WORDS[audience];
+  const preset = loadPreset();
+  const tokensBySize = {};
+  for (const [name, value] of Object.entries(preset.theme.extend.fontSize)) {
+    const size = Array.isArray(value) ? value[0] : value;
+    (tokensBySize[size] ??= []).push(`text-${name}`);
+  }
+  const cornersBySize = {};
+  for (const [name, size] of Object.entries(preset.theme.extend.borderRadius)) (cornersBySize[size] ??= []).push(name === "DEFAULT" ? "rounded" : `rounded-${name}`);
+  return {
+    files: ["**/*.{ts,tsx}"],
+    ignores: ["**/*.test.ts", "**/*.test.tsx"],
+    plugins: { "token-values": betterTailwindcss, "token-spacing": betterTailwindcss },
+    rules: {
+      "token-values/no-restricted-classes": [
+        "error",
+        {
+          restrict: [
+            ...Object.entries(tokensBySize).map(([size, names]) => ({
+              pattern: `${V}text-\\[${size.replace(".", "\\.")}\\](?:/\\S*)?$`,
+              message: `$0 is the type ramp written by hand. Use ${names.join(" or ")}.`
+            })),
+            {
+              pattern: HAND_WRITTEN.type,
+              message: words.type
+            },
+            ...Object.entries(cornersBySize).map(([size, names]) => ({
+              pattern: `${V}rounded(?:-(?:t|r|b|l|s|e|tl|tr|br|bl|ss|se|es|ee))?-\\[${size.replace(".", "\\.")}\\]$`,
+              message: `$0 is a corner written by hand. Use ${names.join(" or ")} (with the same side, if it has one).`
+            })),
+            {
+              pattern: HAND_WRITTEN.corner,
+              message: words.corner
+            },
+            {
+              pattern: HAND_WRITTEN.shadow,
+              message: words.shadow
+            }
+          ]
+        }
+      ],
+      "token-spacing/no-restricted-classes": [
+        "warn",
+        {
+          restrict: [
+            {
+              pattern: HAND_WRITTEN.spacing,
+              message: "$0 is a size or a space written by hand. Use a step of the spacing scale (p-3, h-9, gap-2...) if one fits. Reported, not blocked."
+            },
+            {
+              pattern: HAND_WRITTEN.width,
+              message: "$0 is a border or ring width written by hand. Use border, border-2, ring-1... if one fits. Reported, not blocked."
+            }
+          ]
+        }
+      ],
+      "no-restricted-syntax": [
+        "error",
+        {
+          selector: `JSXAttribute[name.name="style"] > JSXExpressionContainer > ObjectExpression > Property[key.name=${INLINE_STYLE_TOKEN_PROPERTIES}]`,
+          message: "An inline style that sets a colour, a font size, a border or a shadow is outside the token contract: use a token class. If the value is computed (a palette, a size from a prop), say why in an eslint-disable comment. Width, height and transforms are fine."
+        }
+      ]
+    }
+  };
+}
+
+// src/gates/gate-config.ts
+import betterTailwindcss2 from "eslint-plugin-better-tailwindcss";
+import { parser as typescriptParser2 } from "typescript-eslint";
+import estiva from "../eslint/index.js";
+function gateLint({ audience = "app" } = {}) {
+  return {
+    ...audience === "package" ? estiva.configs.package : estiva.configs.recommended,
+    files: audience === "package" ? ["src/**/*.tsx"] : ["src/**/*.{ts,tsx}"],
+    ignores: ["**/*.test.ts", "**/*.test.tsx"],
+    languageOptions: {
+      parser: typescriptParser2,
+      parserOptions: { ecmaFeatures: { jsx: true } }
+    }
+  };
+}
+function gateConfig({ audience = "app", quiet = {}, ignores = [] } = {}) {
+  return [
+    { ignores: [...TOKEN_LINT_IGNORES, ...ignores] },
+    {
+      plugins: {
+        ...quiet,
+        "better-tailwindcss": betterTailwindcss2,
+        "token-values": betterTailwindcss2,
+        "token-spacing": betterTailwindcss2
+      },
+      // Every other config's directives are unused here, because their rules are
+      // off here. Reporting them would be this config complaining about the
+      // others' business.
+      linterOptions: { reportUnusedDisableDirectives: "off" }
+    },
+    gateLint({ audience })
+  ];
+}
+
+// src/gates/app-checks.ts
+var APP_TICKET_TITLES = {
+  "UIG-2": "The tracking rails \u2014 GATES.md, the status script, the guide committed",
+  "UIG-3": "Tracer bullet \u2014 one rule, end to end, blocking in Peek",
+  "UIG-4": "The same chain, blocking in Ship",
+  "UIG-6": "Branch protection \u2014 the backstop, all three repos",
+  "UIG-7": "Lint rule \u2014 every remaining raw element",
+  "UIG-8": "Lint rule \u2014 forbid the reach",
+  "UIG-9": "Lint rule \u2014 the className allow-list",
+  "UIG-13": "The registry widens to Peek's 115 and Ship's 74, with classification",
+  "UIG-19": "Lock the contract in CI, and make the three Storybooks one search",
+  "UIG-20": "The Claude skill, reading the registry",
+  "UIG-21": "CLAUDE.md becomes an index, not a lecture",
+  "UIG-22": "Fingerprint \u2014 a hand-made header row",
+  "UIG-23": "Fingerprint \u2014 a hand-made empty state",
+  "UIG-24": "Fingerprint \u2014 a browser tooltip where ours belongs",
+  "UIG-25": "Fingerprint \u2014 a component copied out by hand",
+  "UIG-27": "The components the apps had to build themselves \u2014 Link, ProgressBar, EmptyState padding",
+  "UIG-28": "Close the two holes in the token contract \u2014 arbitrary values, and inline style",
+  "UIG-30": "RichText \u2014 one component that draws a message's text, for both apps",
+  "UIG-32": "Peek and Ship take their gate pieces from the package"
+};
+function all(h, steps, label) {
+  return async () => {
+    for (const step of steps) {
+      const r = await step();
+      if (r.result !== "pass") return r;
+    }
+    return h.PASS(label);
+  };
+}
+function appChecks(h, { app = ".", page, chain = { ref: "UIG-3", owner: false }, tokenConfigs = ["eslint.tokens.config.js", "eslint.config.js"], headers = ["ContainerHeader", "SectionHeader"] }) {
+  const WEB = app === "." ? "" : `${app.replace(/\/$/, "")}/`;
+  const cwd = app === "." ? void 0 : app;
+  const PROBE = "src/components/__gates_probe__.tsx";
+  const GATES = "eslint.gates.config.js";
+  const at = (rel) => `${WEB}${rel}`;
+  const probe = (code, expect, mentions, file = PROBE, config = GATES) => () => h.lint({ ...cwd ? { cwd } : {}, config, file, code, expect, mentions });
+  const component = (body) => `export function Probe() {
+  return ${body}
+}
+`;
+  const installed = at("node_modules/@estiva-app/ui/dist/index.d.ts");
+  const realPage = () => h.lint({ ...cwd ? { cwd } : {}, config: GATES, file: page, code: h.read(at(page)), expect: "none" });
+  const button = component('<button type="button">x</button>');
+  const ticket = (ref, checks, owner = false) => ({ ref, title: APP_TICKET_TITLES[ref], owner, checks });
+  const tokenProbe = (code, expect, mentions, file = PROBE) => all(h, tokenConfigs.map((config) => probe(code, expect, mentions, file, config)), `${tokenConfigs.join(" and ")}: as expected`);
+  return [
+    ticket("UIG-2", [
+      { what: "npm run gates:status is wired", run: () => h.script("package.json", "gates:status") }
+    ]),
+    ticket(chain.ref, [
+      { what: "the gate lint config loads", run: () => h.loads(at(GATES)) },
+      { what: `${at("package.json")} has lint:rules`, run: () => h.script(at("package.json"), "lint:rules") },
+      { what: "CI runs lint:rules", run: () => h.ci("lint:rules") },
+      { what: "the committed hook runs the gate lint", run: () => h.hook(".claude/settings.json", "gates") },
+      { what: ".gates-count.json is committed and parses", run: () => h.json(h.exists(".gates-count.json") ? ".gates-count.json" : at(".gates-count.json")) },
+      { what: "a raw <button> is an error naming Button", run: probe(button, "error", "Button") },
+      { what: "the same in a story", run: probe(button, "error", "Button", "src/stories/__gates_probe__.stories.tsx") },
+      { what: "a test file is not checked, while source is", run: async () => {
+        const source = await probe(button, "error", "Button")();
+        if (source.result !== "pass") return h.FAIL(`source is not checked yet, so this proves nothing: ${source.detail}`);
+        return probe(button, "none", void 0, "src/components/__gates_probe__.test.tsx")();
+      } },
+      { what: "the debt list exists", run: () => h.file("docs/GATES-DEBT.md") }
+    ], chain.owner),
+    ticket("UIG-6", [
+      { what: "GitHub requires the check gate to merge into main", run: () => h.protectedBranch(/^gate$/) },
+      { what: "CI's job gate runs lint:rules", run: () => h.ciJob("gate", "lint:rules") }
+    ]),
+    ticket("UIG-7", [
+      { what: "a raw <input> is an error naming TextInput", run: probe(component("<input />"), "error", "TextInput") },
+      { what: "a raw <a> is an error naming Link", run: all(h, [probe(component('<a href="/topics">Topics</a>'), "error", "Link"), probe(component('<a href="/issues">Issues</a>'), "error", "Link")], "a raw <a> is an error naming Link") },
+      { what: "a raw <form> is an error naming Form, and a file input one naming FilePicker", run: async () => {
+        const form = await probe(component("<form />"), "error", "`Form`")();
+        if (form.result !== "pass") return form;
+        return probe(component('<input type="file" />'), "error", "FilePicker")();
+      } },
+      { what: "<textarea>, <select>, <dialog> and <label> name Textarea, Select, DialogShell and Field", run: async () => {
+        for (const [element, part] of [["textarea", "Textarea"], ["select", "Select"], ["dialog", "DialogShell"], ["label", "Field"]]) {
+          const one = await probe(component(`<${element} />`), "error", `\`${part}\``)();
+          if (one.result !== "pass") return one;
+        }
+        return h.PASS("all four are errors, each naming its part");
+      } },
+      { what: "an element the package has no part for is an error that says to ask for one", run: probe(component('<iframe title="Map" />'), "error", "ask Katerina") },
+      { what: "an escaped element is not an error, while the same element is", run: async () => {
+        const raw = await probe(component("<form />"), "error")();
+        if (raw.result !== "pass") return h.FAIL(`a raw <form> is not caught yet, so this proves nothing: ${raw.detail}`);
+        return probe("export function Probe() {\n  return (\n    // @estiva-escape: a probe that keeps its element on purpose\n    <form />\n  )\n}\n", "none")();
+      } },
+      { what: "a real page, full of elements that are not controls, gets no error", run: realPage }
+    ]),
+    ticket("UIG-8", [
+      { what: "a Base UI import is an error naming the part built on it", run: probe("import { Popover } from '@base-ui/react/popover'\nexport const Probe = Popover\n", "error", "`Popover`") },
+      { what: "createPortal is an error naming the floating parts", run: probe("import { createPortal } from 'react-dom'\nexport const Probe = (to: HTMLElement) => createPortal(<span />, to)\n", "error", "`DialogShell`") },
+      { what: "a key listener on the whole page is an error, in a .ts file too", run: probe("export function listen() {\n  window.addEventListener('keydown', () => {})\n}\n", "error", "`DialogShell`", "src/lib/__gates_probe__.ts") },
+      { what: "arrow keys by hand are an error; Enter in a field is not", run: async () => {
+        const arrows = await probe("export const onKeyDown = (e: KeyboardEvent) => e.key === 'ArrowDown'\n", "error", "`Menu`", "src/lib/__gates_probe__.ts")();
+        if (arrows.result !== "pass") return arrows;
+        return probe("export const onKeyDown = (e: KeyboardEvent) => e.key === 'Enter'\n", "none", void 0, "src/lib/__gates_probe__.ts")();
+      } },
+      { what: 'a hand-written role="option" is an error naming Select', run: probe(component('<div role="option" />'), "error", "`Select`") },
+      { what: "tabIndex={0} on a div is an error; tabIndex={-1} is not", run: async () => {
+        const zero = await probe(component("<div tabIndex={0} />"), "error", "`Button`")();
+        if (zero.result !== "pass") return h.FAIL(`tabIndex={0} is not caught yet, so this proves nothing: ${zero.detail}`);
+        return probe(component("<div tabIndex={-1} />"), "none")();
+      } },
+      { what: "overflow-y-auto is an error naming ScrollArea", run: probe(component('<div className="h-64 overflow-y-auto" />'), "error", "`ScrollArea`") },
+      { what: "an escaped listener is not an error, while the same listener is", run: async () => {
+        const raw = await probe("export function listen() {\n  document.addEventListener('mousedown', () => {})\n}\n", "error", void 0, "src/lib/__gates_probe__.ts")();
+        if (raw.result !== "pass") return h.FAIL(`a page listener is not caught yet, so this proves nothing: ${raw.detail}`);
+        return probe("export function listen() {\n  // @estiva-escape: a probe that keeps its listener on purpose\n  document.addEventListener('mousedown', () => {})\n}\n", "none", void 0, "src/lib/__gates_probe__.ts")();
+      } },
+      { what: "a real page gets no error", run: realPage }
+    ]),
+    ticket("UIG-9", [
+      { what: "a border passed into Button is an error naming Button", run: probe(`import { Button } from '@estiva-app/ui'
+${component('<Button className="border">x</Button>')}`, "error", "on `Button` changes how it looks") },
+      { what: "placement passed into Button is not", run: probe(`import { Button } from '@estiva-app/ui'
+${component('<Button className="mt-2 w-full flex-1 relative">x</Button>')}`, "none") },
+      { what: "an escaped look is not an error, while the same look is", run: async () => {
+        const raw = await probe(`import { Link } from '@estiva-app/ui'
+${component('<Link href="/x" className="after:absolute after:inset-0">x</Link>')}`, "error", "`Link`")();
+        if (raw.result !== "pass") return h.FAIL(`a restyled part is not caught yet, so this proves nothing: ${raw.detail}`);
+        return probe(`import { Link } from '@estiva-app/ui'
+export function Probe() {
+  return (
+    // @estiva-escape: a probe that keeps its row link on purpose
+    <Link href="/x" className="after:absolute after:inset-0">x</Link>
+  )
+}
+`, "none")();
+      } },
+      { what: "a real page gets no error", run: realPage }
+    ]),
+    ticket("UIG-13", [
+      { what: "registry.json is committed and has entries", run: () => h.json(h.exists("registry.json") ? "registry.json" : at("registry.json"), (d) => (d.entries ?? d.components ?? []).length > 0, "registry.json has entries") }
+    ]),
+    ticket("UIG-19", [
+      { what: "the usage-page contract runs in CI", run: () => h.ci(/[\w:-]*contract[\w:-]*/) }
+    ]),
+    ticket("UIG-20", [
+      { what: "a committed skill runs ui:find", run: () => h.listFiles(".claude/skills", (n) => n === "SKILL.md").some((f) => h.read(f).includes("ui:find")) ? h.PASS("a skill runs ui:find") : h.FAIL("no skill in .claude/skills runs ui:find") }
+    ]),
+    ticket("UIG-21", [
+      { what: "path-scoped instructions exist", run: () => h.listFiles(".claude/rules", (n) => n.endsWith(".md")).some((f) => /^paths:/m.test(h.read(f))) ? h.PASS(".claude/rules has paths: instructions") : h.FAIL("no .claude/rules file with paths:") }
+    ]),
+    ticket("UIG-22", [
+      { what: "a hand-made header row is an error naming the header part", run: all(h, headers.map((name) => probe(component(`<section className="flex flex-col"><div className="flex items-center px-3 py-2"><span>${name === "SectionHeader" ? "Issues" : "Folders"}</span></div><div /></section>`), "error", name)), "a hand-made header row is an error naming the header part") }
+    ]),
+    ticket("UIG-23", [
+      { what: "a hand-made empty line is an error naming EmptyState", run: probe('export function Probe({ items }: { items: string[] }) {\n  return <div>{items.length === 0 ? <p className="text-text-secondary">Nothing here</p> : items.map((i) => <span key={i}>{i}</span>)}</div>\n}\n', "error", "EmptyState") }
+    ]),
+    ticket("UIG-24", [
+      { what: "a title= is an error naming WithTooltip", run: probe(`import { Button } from '@estiva-app/ui'
+${component('<Button title="Delete">x</Button>')}`, "error", "WithTooltip") }
+    ]),
+    ticket("UIG-25", [
+      { what: "SectionLabel's class list, typed by hand, is a warning", run: probe(component('<span className="text-[10px] uppercase tracking-wide text-text-muted">Label</span>'), "warning", "SectionLabel") }
+    ]),
+    ticket("UIG-27", [
+      { what: "the installed package has Link", run: () => h.contains(installed, /\bLink\b/, "the installed @estiva-app/ui exports Link") },
+      { what: "the installed package has ProgressBar", run: () => h.contains(installed, /\bProgressBar\b/, "the installed @estiva-app/ui exports ProgressBar") }
+    ]),
+    ticket("UIG-28", [
+      { what: "text-[14px] is an error", run: tokenProbe(component('<div className="text-[14px]">x</div>'), "error") },
+      { what: "a colour in an inline style is an error", run: tokenProbe(component("<div style={{ backgroundColor: '#ff0000' }}>x</div>"), "error") },
+      { what: "h-[240px] is a warning", run: tokenProbe(component('<div className="h-[240px]">x</div>'), "warning") },
+      { what: "h-[240px] is not an error", run: tokenProbe(component('<div className="h-[240px]">x</div>'), "none") },
+      { what: "a hand-written line height behind an arbitrary variant is an error", run: tokenProbe(component('<div className="[&_p]:leading-[1.4]">x</div>'), "error") },
+      { what: "a raw colour in a class is an error (the pattern that matched nothing, R1)", run: tokenProbe(component('<div className="bg-[#5c69dc]">x</div>'), "error", "raw colour") },
+      { what: "a width and height from a prop pass", run: tokenProbe("export function Probe({ size }: { size: number }) {\n  return <div style={{ width: size, height: size }}>x</div>\n}\n", "none") },
+      { what: "a test file is not checked for hand-written values, while source is", run: all(h, tokenConfigs.map((config) => async () => {
+        const code = component(`<div className="text-[14px]" style={{ color: 'red' }}>x</div>`);
+        const source = await probe(code, "error", void 0, PROBE, config)();
+        if (source.result !== "pass") return h.FAIL(`source is not checked yet, so this proves nothing: ${source.detail}`);
+        return probe(code, "none", void 0, "src/components/__gates_probe__.test.tsx", config)();
+      }), "a test file is not checked for hand-written values, while source is") }
+    ]),
+    ticket("UIG-30", [
+      { what: "the installed package has RichText", run: () => h.contains(installed, /\bRichText\b/, "the installed @estiva-app/ui exports RichText") }
+    ]),
+    // Katerina's ruling of 17 September (docs/GATES.md §23): one copy, in the package. An app made
+    // by create-estiva-app passes this from its first commit; Peek and Ship do once UIG-32 lands.
+    ticket("UIG-32", [
+      { what: "the gate pieces come from the package, and no repo keeps a copy", run: all(h, [
+        () => h.contains(at("eslint.gates.config.js"), /from '@estiva-app\/ui\/gates'/, "the gate config imports @estiva-app/ui/gates"),
+        () => h.hook(".claude/settings.json", "@estiva-app/ui/dist/gates/cli.js"),
+        // `estiva-gates status` where npm can find the command; by path where it cannot,
+        // because the install is in the app's folder and the script is in the repo's top one (Ship).
+        () => h.contains("package.json", /"gates:status":\s*"[^"]*(?:estiva-gates|@estiva-app\/ui\/dist\/gates\/cli\.js)[^"]*status/, "gates:status runs the package's engine"),
+        () => h.exists("scripts/gates-status.mjs") ? h.FAIL("scripts/gates-status.mjs is a copy of the status engine: run estiva-gates status instead") : h.PASS("no copy of the status engine")
+      ], "the gate config, the hook and gates:status are the package's; no copy of the engine") }
+    ])
+  ];
+}
+export {
+  APP_TICKET_TITLES,
+  ENGINE,
+  TOKEN_LINT_IGNORES,
+  appChecks,
+  appFiles,
+  askNpm,
+  createApp,
+  gateConfig,
+  gateLint,
+  helpers,
+  runHook,
+  runStatus,
+  themes,
+  tokenLint,
+  tokenValues,
+  writeGateCount
+};
+//# sourceMappingURL=index.js.map

package/dist/gates/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/gates/token-lint.ts", "../../src/gates/gate-config.ts", "../../src/gates/app-checks.ts"],
+  "sourcesContent": ["/// <reference types=\"node\" />\n/**\n * The token contract as lint settings, written once (docs/GATES.md \u00A723).\n *\n * Until UIG-10 this block was pasted into every repo: `eslint.config.js` here,\n * `eslint.tokens.js` in Peek, `eslint.config.js` in Ship. Katerina ruled on 17 September that a\n * gate piece ships in the package and an app imports it, so this is that one\n * copy. Peek and Ship move onto it in UIG-32.\n *\n * Two configs, as the copies had:\n *\n * - `tokenLint` \u2014 a class Tailwind does not generate (the doubled token name,\n *   `bg-bg-surface`), Tailwind's own type ramp or palette, a raw colour, an\n *   opacity modifier on a token colour.\n * - `tokenValues` \u2014 UIG-28: type, corners and shadows written by hand, and an\n *   inline style that sets a colour (errors); heights, spacing and border\n *   widths written by hand (warnings, never blocking).\n *\n * The patterns are the same for everyone. Only the words differ: an app is told\n * to use \"the package\", the package is told to add the token to `tokens.css`.\n * Measured on 17 September: the UIG-28 block was byte for byte the same in Peek\n * and Ship, and this repository's had the same patterns with seven messages\n * worded for the package.\n *\n * Where the plugin looks: every `className`, every `cn()` / `clsx()` argument,\n * and the values of a class map whose name ends in `Styles` / `_STYLES` or\n * `Classes` / `_CLASSES`. A class map named any other way is invisible to it.\n *\n * Tests are out of `tokenValues` (ruling of 13 September): a test mounts markup\n * to test it. A kept hand-written value says why:\n * `// eslint-disable-next-line <rule> -- @estiva-escape: <reason>` (A2).\n */\nimport { createRequire } from 'node:module'\nimport { fileURLToPath } from 'node:url'\nimport type { Linter } from 'eslint'\nimport betterTailwindcss from 'eslint-plugin-better-tailwindcss'\nimport { getDefaultSelectors } from 'eslint-plugin-better-tailwindcss/defaults'\nimport { parser as typescriptParser } from 'typescript-eslint'\n\n/** Who reads the messages. */\nexport type TokenAudience = 'app' | 'package'\n\nexport interface TokenLintOptions {\n  /** The Tailwind config the unknown-class rule reads, relative to where ESLint runs. */\n  tailwindConfig?: string\n  /** `app` (the default) names the package; `package` names `tokens.css` and the preset. */\n  audience?: TokenAudience\n}\n\n/** What the token lint never reads: build output. */\nexport const TOKEN_LINT_IGNORES = ['dist/', 'storybook-static/', 'node_modules/']\n\nconst CLASS_MAP_SELECTOR = {\n  kind: 'variable',\n  name: '^(?:[A-Z][A-Z0-9_]*_(?:STYLES|CLASSES)|[a-z][a-zA-Z0-9]*(?:Styles|Classes))$',\n  match: [{ type: 'strings' }, { type: 'objectValues' }],\n}\n\nconst WORDS = {\n  app: {\n    ramp: \"Tailwind's type ramp is not a token. Use the ramp from the package: text-body-2, text-caption, text-h3, text-btn-default...\",\n    palette: \"Tailwind's palette is not a token. Use a colour from the package (bg-bg-surface, text-text-primary, border-border-subtle...); a colour with no token is a missing token.\",\n    raw: 'A raw colour is a missing token: add it to the package (tokens.css in every theme block, and the preset), or say why not in an eslint-disable comment.',\n    opacity: 'An opacity modifier on a token colour compiles to nothing. A transparent colour is a token of its own (D16): add it to the package.',\n    type: '$0 is type written by hand. A token from the package sets the size, line height, letter spacing and weight together (text-body-2, text-caption, text-h5...); if none fits, add one to the package, or say why not in an eslint-disable comment.',\n    corner: '$0 is a corner written by hand, and no token has it. Use a corner from the package (rounded-sm 4px, rounded-md 6px, rounded-lg 8px...), or say why not in an eslint-disable comment.',\n    shadow: '$0 is a shadow written by hand. Use a shadow from the package (shadow-sm, shadow-md, shadow-focus-ring, drop-shadow-glow-success...); a shadow with no token is a missing token.',\n  },\n  package: {\n    ramp: \"Tailwind's type ramp is not a token. Use the ramp in tailwind-preset.js: text-body-2, text-caption, text-h3, text-btn-default...\",\n    palette: \"Tailwind's palette is not a token. Use a colour from tailwind-preset.js (bg-bg-surface, text-text-primary, border-border-subtle...); a colour with no token is a missing token.\",\n    raw: 'A raw colour is a missing token: add it to tokens.css in every theme block and to the preset, or say why not in an eslint-disable comment.',\n    opacity: 'An opacity modifier on a token colour compiles to nothing. A transparent colour is a token of its own (D16): add it to tokens.css in every theme block and to the preset.',\n    type: '$0 is type written by hand. A token from tailwind-preset.js sets the size, line height, letter spacing and weight together (text-body-2, text-caption, text-h5...); if none fits, add one to the preset and to cn.ts, or say why not in an eslint-disable comment.',\n    corner: '$0 is a corner written by hand, and no token has it. Use a corner from tailwind-preset.js (rounded-sm 4px, rounded-md 6px, rounded-lg 8px...), or say why not in an eslint-disable comment.',\n    shadow: '$0 is a shadow written by hand. Use a shadow from tailwind-preset.js (shadow-sm, shadow-md, shadow-focus-ring, drop-shadow-glow-success...); a shadow with no token is a missing token.',\n  },\n} satisfies Record<TokenAudience, Record<string, string>>\n\n/**\n * The class rules. `no-unknown-classes` reads the app's own Tailwind config, so\n * it knows exactly what the preset and the app generate.\n */\nexport function tokenLint({ tailwindConfig = 'tailwind.config.js', audience = 'app' }: TokenLintOptions = {}): Linter.Config {\n  const words = WORDS[audience]\n  return {\n    files: ['**/*.{ts,tsx}'],\n    languageOptions: {\n      parser: typescriptParser,\n      parserOptions: { ecmaFeatures: { jsx: true } },\n    },\n    plugins: { 'better-tailwindcss': betterTailwindcss },\n    settings: {\n      'better-tailwindcss': {\n        tailwindConfig,\n        selectors: [...getDefaultSelectors(), CLASS_MAP_SELECTOR],\n      },\n    },\n    rules: {\n      'better-tailwindcss/no-unknown-classes': 'error',\n      'better-tailwindcss/no-restricted-classes': [\n        'error',\n        {\n          restrict: [\n            { pattern: '^(?:[a-z0-9-]+:)*text-(?:xs|sm|base|lg|xl|[2-9]xl)$', message: words.ramp },\n            {\n              pattern:\n                '^(?:[a-z0-9-]+:)*(?:text|bg|border|ring|outline|fill|stroke|decoration|divide|placeholder|from|via|to|accent|caret|shadow)-(?:black|white|slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)(?:-[0-9]{2,3})?(?:/[0-9]{1,3})?$',\n              message: words.palette,\n            },\n            { pattern: '^(?:[a-z0-9-]+:)*[a-z-]+-\\\\[[^\\\\]]*(?:#[0-9a-fA-F]{3}|rgba?\\\\(|hsla?\\\\(|oklch\\\\()', message: words.raw },\n            {\n              pattern: '^(?:[a-z0-9-]+:)*(?:text|bg|border|ring|outline|fill|stroke|decoration|divide|placeholder|from|via|to|accent|caret|shadow)-(?:bg|text|border|accent|info|warning|success|error)-[a-z-]+/[0-9]{1,3}$',\n              message: words.opacity,\n            },\n          ],\n        },\n      ],\n    },\n  }\n}\n\n// UIG-28's patterns. The variant part reads arbitrary variants too\n// (`[&_pre]:`, `data-[state]:`, `group-hover/row:`). A colour inside `text-[\u2026]`\n// is left to the raw-colour rule of `tokenLint`.\nconst V = '^(?:(?:[^:\\\\[\\\\]\\\\s]|\\\\[[^\\\\]]*\\\\])+:)*!?'\nconst NOT_COLOUR = '(?!color:|#|rgba?\\\\(|hsla?\\\\(|oklch\\\\(|var\\\\()'\nconst HAND_WRITTEN = {\n  type: `${V}(?:text-\\\\[${NOT_COLOUR}|text-\\\\[length:|leading-\\\\[|tracking-\\\\[)[^\\\\]]+\\\\](?:/\\\\S*)?$`,\n  corner: `${V}rounded(?:-(?:t|r|b|l|s|e|tl|tr|br|bl|ss|se|es|ee))?-\\\\[[^\\\\]]+\\\\]$`,\n  shadow: `${V}(?:shadow|drop-shadow)-\\\\[(?!color:)[^\\\\]]+\\\\]$`,\n  spacing: `${V}-?(?:w|h|size|min-w|min-h|max-w|max-h|p[xytrblse]?|m[xytrblse]?|gap(?:-[xy])?|space-[xy]|inset(?:-[xy])?|top|right|bottom|left|translate-[xy]|basis|indent|scroll-[mp][xytrblse]?|border-spacing(?:-[xy])?)-\\\\[[^\\\\]]+\\\\]$`,\n  width: `${V}(?:border(?:-[xytrblse])?|divide-[xy]|outline|ring|ring-offset)-\\\\[(?:length:)?-?[0-9.]+(?:px|rem|em)?\\\\]$`,\n}\n\nconst INLINE_STYLE_TOKEN_PROPERTIES =\n  '/^(color|background|backgroundColor|backgroundImage|fill|stroke|fontSize|border|borderTop|borderRight|borderBottom|borderLeft|borderBlock|borderInline|borderStyle|boxShadow|textShadow)$|Color$/'\n\ninterface Preset {\n  theme: { extend: { fontSize: Record<string, string | [string, unknown]>; borderRadius: Record<string, string> } }\n}\n\n/**\n * The preset, loaded the way Tailwind loads it: it imports `tailwindcss/plugin`,\n * which a plain `import` cannot resolve. Read from beside this module, so an app\n * and this repository read the one preset the package ships.\n */\nfunction loadPreset(): Preset {\n  const require = createRequire(import.meta.url)\n  const loadConfig = require('tailwindcss/loadConfig') as (path: string) => Preset\n  return loadConfig(fileURLToPath(new URL('../../tailwind-preset.js', import.meta.url)))\n}\n\n/**\n * UIG-28: the values the tokens already name, written by hand (Katerina's\n * rulings B11, B12, C3 of 13 September and R2 of 15 September). Register it\n * after `tokenLint`, whose parser and plugin settings it borrows. Under its own\n * rule names, `token-values` and `token-spacing` (the same plugin twice, so one\n * runs as errors and one as warnings): an escape for a hand-written size then\n * cannot also silence a raw colour on the same line.\n */\nexport function tokenValues({ audience = 'app' }: Pick<TokenLintOptions, 'audience'> = {}): Linter.Config {\n  const words = WORDS[audience]\n  const preset = loadPreset()\n  // `text-[14px]` names the token of that size, read from the preset, so the\n  // message stays true when the ramp changes.\n  const tokensBySize: Record<string, string[]> = {}\n  for (const [name, value] of Object.entries(preset.theme.extend.fontSize)) {\n    const size = Array.isArray(value) ? value[0] : value\n    ;(tokensBySize[size] ??= []).push(`text-${name}`)\n  }\n  const cornersBySize: Record<string, string[]> = {}\n  for (const [name, size] of Object.entries(preset.theme.extend.borderRadius)) (cornersBySize[size] ??= []).push(name === 'DEFAULT' ? 'rounded' : `rounded-${name}`)\n\n  return {\n    files: ['**/*.{ts,tsx}'],\n    ignores: ['**/*.test.ts', '**/*.test.tsx'],\n    plugins: { 'token-values': betterTailwindcss, 'token-spacing': betterTailwindcss },\n    rules: {\n      'token-values/no-restricted-classes': [\n        'error',\n        {\n          restrict: [\n            ...Object.entries(tokensBySize).map(([size, names]) => ({\n              pattern: `${V}text-\\\\[${size.replace('.', '\\\\.')}\\\\](?:/\\\\S*)?$`,\n              message: `$0 is the type ramp written by hand. Use ${names.join(' or ')}.`,\n            })),\n            {\n              pattern: HAND_WRITTEN.type,\n              message: words.type,\n            },\n            ...Object.entries(cornersBySize).map(([size, names]) => ({\n              pattern: `${V}rounded(?:-(?:t|r|b|l|s|e|tl|tr|br|bl|ss|se|es|ee))?-\\\\[${size.replace('.', '\\\\.')}\\\\]$`,\n              message: `$0 is a corner written by hand. Use ${names.join(' or ')} (with the same side, if it has one).`,\n            })),\n            {\n              pattern: HAND_WRITTEN.corner,\n              message: words.corner,\n            },\n            {\n              pattern: HAND_WRITTEN.shadow,\n              message: words.shadow,\n            },\n          ],\n        },\n      ],\n      'token-spacing/no-restricted-classes': [\n        'warn',\n        {\n          restrict: [\n            {\n              pattern: HAND_WRITTEN.spacing,\n              message: '$0 is a size or a space written by hand. Use a step of the spacing scale (p-3, h-9, gap-2...) if one fits. Reported, not blocked.',\n            },\n            {\n              pattern: HAND_WRITTEN.width,\n              message: '$0 is a border or ring width written by hand. Use border, border-2, ring-1... if one fits. Reported, not blocked.',\n            },\n          ],\n        },\n      ],\n      'no-restricted-syntax': [\n        'error',\n        {\n          selector: `JSXAttribute[name.name=\"style\"] > JSXExpressionContainer > ObjectExpression > Property[key.name=${INLINE_STYLE_TOKEN_PROPERTIES}]`,\n          message: 'An inline style that sets a colour, a font size, a border or a shadow is outside the token contract: use a token class. If the value is computed (a palette, a size from a prop), say why in an eslint-disable comment. Width, height and transforms are fine.',\n        },\n      ],\n    },\n  }\n}\n", "/// <reference types=\"node\" />\n/**\n * Where the UI Guardrails' rules apply, written once (docs/GATES.md \u00A723).\n *\n * Until UIG-10 every repo wrote this itself: `eslint.gates.js` (the rules and\n * where they apply) and `eslint.gates.config.js` (the gate: those rules alone)\n * in Peek, in Ship's `web/`, and here pointed inward. The rules were always the\n * package's; these two files were copies. Now they are two functions.\n *\n * Where: every `.ts` and `.tsx` under `src`, stories included (a story is what\n * people read and copy), tests not (a test mounts markup to test it) \u2014\n * Katerina's rulings of 13 September; `.ts` since UIG-8. This package's own\n * inward set reads `.tsx` only, as it always has.\n *\n * A place that keeps something says why, on the line above:\n * `// @estiva-escape: <reason>`, or `{/* @estiva-escape: <reason> *\\/}` as a\n * JSX child. Never `eslint-disable`: the count refuses it.\n */\nimport type { ESLint, Linter } from 'eslint'\nimport betterTailwindcss from 'eslint-plugin-better-tailwindcss'\nimport { parser as typescriptParser } from 'typescript-eslint'\nimport estiva from '../eslint/index'\nimport { TOKEN_LINT_IGNORES } from './token-lint'\n\nexport interface GateConfigOptions {\n  /** `app` (the default) runs `configs.recommended`; `package` runs this package's inward set. */\n  audience?: 'app' | 'package'\n  /**\n   * Plugins whose `eslint-disable` directives appear in the source, registered\n   * here with every rule off. ESLint refuses a directive for a rule it does not\n   * know, so without them the gate would fail on another lint's comments.\n   * The token lint's names are registered already.\n   */\n  quiet?: Record<string, ESLint.Plugin>\n  /** Folders the gate never reads, beside build output. */\n  ignores?: string[]\n}\n\n/**\n * The rules and where they apply \u2014 one config object, to add beside\n * everything else an app's `eslint.config.js` runs, so an editor shows a\n * refusal where the element is typed.\n */\nexport function gateLint({ audience = 'app' }: Pick<GateConfigOptions, 'audience'> = {}): Linter.Config {\n  return {\n    ...(audience === 'package' ? estiva.configs.package : estiva.configs.recommended),\n    files: audience === 'package' ? ['src/**/*.tsx'] : ['src/**/*.{ts,tsx}'],\n    ignores: ['**/*.test.ts', '**/*.test.tsx'],\n    languageOptions: {\n      parser: typescriptParser,\n      parserOptions: { ecmaFeatures: { jsx: true } },\n    },\n  }\n}\n\n/**\n * The gate: the rules on their own \u2014 `npm run lint:rules`, CI's job `gate`, and\n * the config the editor hook lints a proposed write with. It fails on a gate\n * rule and on nothing else, so a backlog in the full lint never blocks it.\n */\nexport function gateConfig({ audience = 'app', quiet = {}, ignores = [] }: GateConfigOptions = {}): Linter.Config[] {\n  return [\n    { ignores: [...TOKEN_LINT_IGNORES, ...ignores] },\n    {\n      plugins: {\n        ...quiet,\n        'better-tailwindcss': betterTailwindcss,\n        'token-values': betterTailwindcss,\n        'token-spacing': betterTailwindcss,\n      },\n      // Every other config's directives are unused here, because their rules are\n      // off here. Reporting them would be this config complaining about the\n      // others' business.\n      linterOptions: { reportUnusedDisableDirectives: 'off' },\n    },\n    gateLint({ audience }),\n  ]\n}\n", "/// <reference types=\"node\" />\n/**\n * The gate checks every app runs, written once (docs/GATES.md \u00A723).\n *\n * Until UIG-10 Peek and Ship each wrote them into their own\n * `scripts/gates-checks.mjs`. 65 different checks for finished tickets, counted\n * on 17 September: 28 were identical in both, 21 were the same check written two\n * ways, 2 read each app's real page, and 14 read code only one app has. This is\n * the first three groups as one list. The fourth stays in the app's own checks\n * file, beside this list.\n *\n * Where Peek and Ship wrote one check two ways, the check here runs both, so it\n * passes wherever either did: the raw-link probe with both of their texts, the\n * token probes against each token config the app has.\n *\n * `scripts/gates-compare.mjs` holds this list to Peek's and Ship's: every check\n * of theirs must be here, or be about code only that app has, or the comparison\n * fails and names it.\n *\n * A check for a ticket not built yet is a first guess at the evidence, taken\n * from the ticket's own text; the ticket that builds it changes it here.\n */\nimport type { CheckResult, GateCheck, GateHelpers, GateTicket } from './status'\n\nexport interface AppCheckOptions {\n  /** Where the app is inside the repository: `web` in Ship, `.` elsewhere. */\n  app?: string\n  /** A real page of the app, relative to the app, full of elements that are not controls. */\n  page: string\n  /** The ticket the gate chain is listed under, and whether this repo owns it: UIG-3 in Peek, UIG-4 in Ship. */\n  chain?: { ref: string; owner: boolean }\n  /** The token lint configs the app has, relative to the app. */\n  tokenConfigs?: string[]\n  /** The name of the app's header component a hand-made header row should name (UIG-22's first guess). */\n  headers?: string[]\n}\n\nexport const APP_TICKET_TITLES: Record<string, string> = {\n  'UIG-2': 'The tracking rails \u2014 GATES.md, the status script, the guide committed',\n  'UIG-3': 'Tracer bullet \u2014 one rule, end to end, blocking in Peek',\n  'UIG-4': 'The same chain, blocking in Ship',\n  'UIG-6': 'Branch protection \u2014 the backstop, all three repos',\n  'UIG-7': 'Lint rule \u2014 every remaining raw element',\n  'UIG-8': 'Lint rule \u2014 forbid the reach',\n  'UIG-9': 'Lint rule \u2014 the className allow-list',\n  'UIG-13': \"The registry widens to Peek's 115 and Ship's 74, with classification\",\n  'UIG-19': 'Lock the contract in CI, and make the three Storybooks one search',\n  'UIG-20': 'The Claude skill, reading the registry',\n  'UIG-21': 'CLAUDE.md becomes an index, not a lecture',\n  'UIG-22': 'Fingerprint \u2014 a hand-made header row',\n  'UIG-23': 'Fingerprint \u2014 a hand-made empty state',\n  'UIG-24': 'Fingerprint \u2014 a browser tooltip where ours belongs',\n  'UIG-25': 'Fingerprint \u2014 a component copied out by hand',\n  'UIG-27': 'The components the apps had to build themselves \u2014 Link, ProgressBar, EmptyState padding',\n  'UIG-28': 'Close the two holes in the token contract \u2014 arbitrary values, and inline style',\n  'UIG-30': 'RichText \u2014 one component that draws a message\\'s text, for both apps',\n  'UIG-32': 'Peek and Ship take their gate pieces from the package',\n}\n\n/** Run several checks as one: the first that does not pass is the answer. */\nfunction all(h: GateHelpers, steps: (() => CheckResult | Promise<CheckResult>)[], label: string): () => Promise<CheckResult> {\n  return async () => {\n    for (const step of steps) {\n      const r = await step()\n      if (r.result !== 'pass') return r\n    }\n    return h.PASS(label)\n  }\n}\n\nexport function appChecks(h: GateHelpers, { app = '.', page, chain = { ref: 'UIG-3', owner: false }, tokenConfigs = ['eslint.tokens.config.js', 'eslint.config.js'], headers = ['ContainerHeader', 'SectionHeader'] }: AppCheckOptions): GateTicket[] {\n  const WEB = app === '.' ? '' : `${app.replace(/\\/$/, '')}/`\n  const cwd = app === '.' ? undefined : app\n  const PROBE = 'src/components/__gates_probe__.tsx'\n  const GATES = 'eslint.gates.config.js'\n  const at = (rel: string) => `${WEB}${rel}`\n  const probe = (code: string, expect: 'error' | 'warning' | 'none', mentions?: string, file = PROBE, config = GATES) => () =>\n    h.lint({ ...(cwd ? { cwd } : {}), config, file, code, expect, mentions })\n  const component = (body: string) => `export function Probe() {\\n  return ${body}\\n}\\n`\n  const installed = at('node_modules/@estiva-app/ui/dist/index.d.ts')\n  const realPage = (): Promise<CheckResult> => h.lint({ ...(cwd ? { cwd } : {}), config: GATES, file: page, code: h.read(at(page)), expect: 'none' })\n  const button = component('<button type=\"button\">x</button>')\n  const ticket = (ref: string, checks: GateCheck[], owner = false): GateTicket => ({ ref, title: APP_TICKET_TITLES[ref], owner, checks })\n\n  const tokenProbe = (code: string, expect: 'error' | 'warning' | 'none', mentions?: string, file = PROBE) =>\n    all(h, tokenConfigs.map((config) => probe(code, expect, mentions, file, config)), `${tokenConfigs.join(' and ')}: as expected`)\n\n  return [\n    ticket('UIG-2', [\n      { what: 'npm run gates:status is wired', run: () => h.script('package.json', 'gates:status') },\n    ]),\n    ticket(chain.ref, [\n      { what: 'the gate lint config loads', run: () => h.loads(at(GATES)) },\n      { what: `${at('package.json')} has lint:rules`, run: () => h.script(at('package.json'), 'lint:rules') },\n      { what: 'CI runs lint:rules', run: () => h.ci('lint:rules') },\n      { what: 'the committed hook runs the gate lint', run: () => h.hook('.claude/settings.json', 'gates') },\n      { what: '.gates-count.json is committed and parses', run: () => h.json(h.exists('.gates-count.json') ? '.gates-count.json' : at('.gates-count.json')) },\n      { what: 'a raw <button> is an error naming Button', run: probe(button, 'error', 'Button') },\n      { what: 'the same in a story', run: probe(button, 'error', 'Button', 'src/stories/__gates_probe__.stories.tsx') },\n      { what: 'a test file is not checked, while source is', run: async () => {\n        const source = await probe(button, 'error', 'Button')()\n        if (source.result !== 'pass') return h.FAIL(`source is not checked yet, so this proves nothing: ${source.detail}`)\n        return probe(button, 'none', undefined, 'src/components/__gates_probe__.test.tsx')()\n      } },\n      { what: 'the debt list exists', run: () => h.file('docs/GATES-DEBT.md') },\n    ], chain.owner),\n    ticket('UIG-6', [\n      { what: 'GitHub requires the check gate to merge into main', run: () => h.protectedBranch(/^gate$/) },\n      { what: \"CI's job gate runs lint:rules\", run: () => h.ciJob('gate', 'lint:rules') },\n    ]),\n    ticket('UIG-7', [\n      { what: 'a raw <input> is an error naming TextInput', run: probe(component('<input />'), 'error', 'TextInput') },\n      { what: 'a raw <a> is an error naming Link', run: all(h, [probe(component('<a href=\"/topics\">Topics</a>'), 'error', 'Link'), probe(component('<a href=\"/issues\">Issues</a>'), 'error', 'Link')], 'a raw <a> is an error naming Link') },\n      { what: 'a raw <form> is an error naming Form, and a file input one naming FilePicker', run: async () => {\n        const form = await probe(component('<form />'), 'error', '`Form`')()\n        if (form.result !== 'pass') return form\n        return probe(component('<input type=\"file\" />'), 'error', 'FilePicker')()\n      } },\n      { what: '<textarea>, <select>, <dialog> and <label> name Textarea, Select, DialogShell and Field', run: async () => {\n        for (const [element, part] of [['textarea', 'Textarea'], ['select', 'Select'], ['dialog', 'DialogShell'], ['label', 'Field']]) {\n          const one = await probe(component(`<${element} />`), 'error', `\\`${part}\\``)()\n          if (one.result !== 'pass') return one\n        }\n        return h.PASS('all four are errors, each naming its part')\n      } },\n      { what: 'an element the package has no part for is an error that says to ask for one', run: probe(component('<iframe title=\"Map\" />'), 'error', 'ask Katerina') },\n      { what: 'an escaped element is not an error, while the same element is', run: async () => {\n        const raw = await probe(component('<form />'), 'error')()\n        if (raw.result !== 'pass') return h.FAIL(`a raw <form> is not caught yet, so this proves nothing: ${raw.detail}`)\n        return probe('export function Probe() {\\n  return (\\n    // @estiva-escape: a probe that keeps its element on purpose\\n    <form />\\n  )\\n}\\n', 'none')()\n      } },\n      { what: 'a real page, full of elements that are not controls, gets no error', run: realPage },\n    ]),\n    ticket('UIG-8', [\n      { what: 'a Base UI import is an error naming the part built on it', run: probe(\"import { Popover } from '@base-ui/react/popover'\\nexport const Probe = Popover\\n\", 'error', '`Popover`') },\n      { what: 'createPortal is an error naming the floating parts', run: probe(\"import { createPortal } from 'react-dom'\\nexport const Probe = (to: HTMLElement) => createPortal(<span />, to)\\n\", 'error', '`DialogShell`') },\n      { what: 'a key listener on the whole page is an error, in a .ts file too', run: probe(\"export function listen() {\\n  window.addEventListener('keydown', () => {})\\n}\\n\", 'error', '`DialogShell`', 'src/lib/__gates_probe__.ts') },\n      { what: 'arrow keys by hand are an error; Enter in a field is not', run: async () => {\n        const arrows = await probe(\"export const onKeyDown = (e: KeyboardEvent) => e.key === 'ArrowDown'\\n\", 'error', '`Menu`', 'src/lib/__gates_probe__.ts')()\n        if (arrows.result !== 'pass') return arrows\n        return probe(\"export const onKeyDown = (e: KeyboardEvent) => e.key === 'Enter'\\n\", 'none', undefined, 'src/lib/__gates_probe__.ts')()\n      } },\n      { what: 'a hand-written role=\"option\" is an error naming Select', run: probe(component('<div role=\"option\" />'), 'error', '`Select`') },\n      { what: 'tabIndex={0} on a div is an error; tabIndex={-1} is not', run: async () => {\n        const zero = await probe(component('<div tabIndex={0} />'), 'error', '`Button`')()\n        if (zero.result !== 'pass') return h.FAIL(`tabIndex={0} is not caught yet, so this proves nothing: ${zero.detail}`)\n        return probe(component('<div tabIndex={-1} />'), 'none')()\n      } },\n      { what: 'overflow-y-auto is an error naming ScrollArea', run: probe(component('<div className=\"h-64 overflow-y-auto\" />'), 'error', '`ScrollArea`') },\n      { what: 'an escaped listener is not an error, while the same listener is', run: async () => {\n        const raw = await probe(\"export function listen() {\\n  document.addEventListener('mousedown', () => {})\\n}\\n\", 'error', undefined, 'src/lib/__gates_probe__.ts')()\n        if (raw.result !== 'pass') return h.FAIL(`a page listener is not caught yet, so this proves nothing: ${raw.detail}`)\n        return probe(\"export function listen() {\\n  // @estiva-escape: a probe that keeps its listener on purpose\\n  document.addEventListener('mousedown', () => {})\\n}\\n\", 'none', undefined, 'src/lib/__gates_probe__.ts')()\n      } },\n      { what: 'a real page gets no error', run: realPage },\n    ]),\n    ticket('UIG-9', [\n      { what: 'a border passed into Button is an error naming Button', run: probe(`import { Button } from '@estiva-app/ui'\\n${component('<Button className=\"border\">x</Button>')}`, 'error', 'on `Button` changes how it looks') },\n      { what: 'placement passed into Button is not', run: probe(`import { Button } from '@estiva-app/ui'\\n${component('<Button className=\"mt-2 w-full flex-1 relative\">x</Button>')}`, 'none') },\n      { what: 'an escaped look is not an error, while the same look is', run: async () => {\n        const raw = await probe(`import { Link } from '@estiva-app/ui'\\n${component('<Link href=\"/x\" className=\"after:absolute after:inset-0\">x</Link>')}`, 'error', '`Link`')()\n        if (raw.result !== 'pass') return h.FAIL(`a restyled part is not caught yet, so this proves nothing: ${raw.detail}`)\n        return probe(`import { Link } from '@estiva-app/ui'\\nexport function Probe() {\\n  return (\\n    // @estiva-escape: a probe that keeps its row link on purpose\\n    <Link href=\"/x\" className=\"after:absolute after:inset-0\">x</Link>\\n  )\\n}\\n`, 'none')()\n      } },\n      { what: 'a real page gets no error', run: realPage },\n    ]),\n    ticket('UIG-13', [\n      { what: 'registry.json is committed and has entries', run: () => h.json(h.exists('registry.json') ? 'registry.json' : at('registry.json'), (d) => ((d as { entries?: unknown[]; components?: unknown[] }).entries ?? (d as { components?: unknown[] }).components ?? []).length > 0, 'registry.json has entries') },\n    ]),\n    ticket('UIG-19', [\n      { what: 'the usage-page contract runs in CI', run: () => h.ci(/[\\w:-]*contract[\\w:-]*/) },\n    ]),\n    ticket('UIG-20', [\n      { what: 'a committed skill runs ui:find', run: () => (h.listFiles('.claude/skills', (n) => n === 'SKILL.md').some((f) => h.read(f).includes('ui:find')) ? h.PASS('a skill runs ui:find') : h.FAIL('no skill in .claude/skills runs ui:find')) },\n    ]),\n    ticket('UIG-21', [\n      { what: 'path-scoped instructions exist', run: () => (h.listFiles('.claude/rules', (n) => n.endsWith('.md')).some((f) => /^paths:/m.test(h.read(f))) ? h.PASS('.claude/rules has paths: instructions') : h.FAIL('no .claude/rules file with paths:')) },\n    ]),\n    ticket('UIG-22', [\n      { what: 'a hand-made header row is an error naming the header part', run: all(h, headers.map((name) => probe(component(`<section className=\"flex flex-col\"><div className=\"flex items-center px-3 py-2\"><span>${name === 'SectionHeader' ? 'Issues' : 'Folders'}</span></div><div /></section>`), 'error', name)), 'a hand-made header row is an error naming the header part') },\n    ]),\n    ticket('UIG-23', [\n      { what: 'a hand-made empty line is an error naming EmptyState', run: probe(\"export function Probe({ items }: { items: string[] }) {\\n  return <div>{items.length === 0 ? <p className=\\\"text-text-secondary\\\">Nothing here</p> : items.map((i) => <span key={i}>{i}</span>)}</div>\\n}\\n\", 'error', 'EmptyState') },\n    ]),\n    ticket('UIG-24', [\n      { what: 'a title= is an error naming WithTooltip', run: probe(`import { Button } from '@estiva-app/ui'\\n${component('<Button title=\"Delete\">x</Button>')}`, 'error', 'WithTooltip') },\n    ]),\n    ticket('UIG-25', [\n      { what: \"SectionLabel's class list, typed by hand, is a warning\", run: probe(component('<span className=\"text-[10px] uppercase tracking-wide text-text-muted\">Label</span>'), 'warning', 'SectionLabel') },\n    ]),\n    ticket('UIG-27', [\n      { what: 'the installed package has Link', run: () => h.contains(installed, /\\bLink\\b/, 'the installed @estiva-app/ui exports Link') },\n      { what: 'the installed package has ProgressBar', run: () => h.contains(installed, /\\bProgressBar\\b/, 'the installed @estiva-app/ui exports ProgressBar') },\n    ]),\n    ticket('UIG-28', [\n      { what: 'text-[14px] is an error', run: tokenProbe(component('<div className=\"text-[14px]\">x</div>'), 'error') },\n      { what: 'a colour in an inline style is an error', run: tokenProbe(component(\"<div style={{ backgroundColor: '#ff0000' }}>x</div>\"), 'error') },\n      { what: 'h-[240px] is a warning', run: tokenProbe(component('<div className=\"h-[240px]\">x</div>'), 'warning') },\n      { what: 'h-[240px] is not an error', run: tokenProbe(component('<div className=\"h-[240px]\">x</div>'), 'none') },\n      { what: 'a hand-written line height behind an arbitrary variant is an error', run: tokenProbe(component('<div className=\"[&_p]:leading-[1.4]\">x</div>'), 'error') },\n      { what: 'a raw colour in a class is an error (the pattern that matched nothing, R1)', run: tokenProbe(component('<div className=\"bg-[#5c69dc]\">x</div>'), 'error', 'raw colour') },\n      { what: 'a width and height from a prop pass', run: tokenProbe(\"export function Probe({ size }: { size: number }) {\\n  return <div style={{ width: size, height: size }}>x</div>\\n}\\n\", 'none') },\n      { what: 'a test file is not checked for hand-written values, while source is', run: all(h, tokenConfigs.map((config) => async () => {\n        const code = component(\"<div className=\\\"text-[14px]\\\" style={{ color: 'red' }}>x</div>\")\n        const source = await probe(code, 'error', undefined, PROBE, config)()\n        if (source.result !== 'pass') return h.FAIL(`source is not checked yet, so this proves nothing: ${source.detail}`)\n        return probe(code, 'none', undefined, 'src/components/__gates_probe__.test.tsx', config)()\n      }), 'a test file is not checked for hand-written values, while source is') },\n    ]),\n    ticket('UIG-30', [\n      { what: 'the installed package has RichText', run: () => h.contains(installed, /\\bRichText\\b/, 'the installed @estiva-app/ui exports RichText') },\n    ]),\n    // Katerina's ruling of 17 September (docs/GATES.md \u00A723): one copy, in the package. An app made\n    // by create-estiva-app passes this from its first commit; Peek and Ship do once UIG-32 lands.\n    ticket('UIG-32', [\n      { what: 'the gate pieces come from the package, and no repo keeps a copy', run: all(h, [\n        () => h.contains(at('eslint.gates.config.js'), /from '@estiva-app\\/ui\\/gates'/, 'the gate config imports @estiva-app/ui/gates'),\n        () => h.hook('.claude/settings.json', '@estiva-app/ui/dist/gates/cli.js'),\n        // `estiva-gates status` where npm can find the command; by path where it cannot,\n        // because the install is in the app's folder and the script is in the repo's top one (Ship).\n        () => h.contains('package.json', /\"gates:status\":\\s*\"[^\"]*(?:estiva-gates|@estiva-app\\/ui\\/dist\\/gates\\/cli\\.js)[^\"]*status/, \"gates:status runs the package's engine\"),\n        () => (h.exists('scripts/gates-status.mjs') ? h.FAIL('scripts/gates-status.mjs is a copy of the status engine: run estiva-gates status instead') : h.PASS('no copy of the status engine')),\n      ], 'the gate config, the hook and gates:status are the package\\'s; no copy of the engine') },\n    ]),\n  ]\n}\n"],
+  "mappings": "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",
+  "names": ["require", "betterTailwindcss", "typescriptParser", "typescriptParser", "betterTailwindcss"]
+}

package/dist/gates/status.d.ts

@@ -0,0 +1,88 @@
+export type CheckResult = {
+    result: 'pass' | 'fail' | 'part' | 'unknown';
+    detail: string;
+};
+type Maybe<T> = T | Promise<T>;
+export interface LintProbe {
+    /** The folder ESLint runs from, relative to the repo: `web` in Ship. */
+    cwd?: string;
+    /** The config file, relative to `cwd`. */
+    config: string;
+    /** The path the text is linted as, relative to `cwd`. Nothing is written. */
+    file: string;
+    code: string;
+    expect: 'error' | 'warning' | 'none';
+    /** Words the expected message must contain. */
+    mentions?: string;
+}
+/** The helpers a checks file is written with. */
+export interface GateHelpers {
+    PASS(detail: string): CheckResult;
+    FAIL(detail: string): CheckResult;
+    PART(detail: string): CheckResult;
+    UNKNOWN(detail: string): CheckResult;
+    exists(rel: string): boolean;
+    read(rel: string): string;
+    listFiles(rel: string, test: (name: string, path: string) => boolean): string[];
+    file(rel: string): CheckResult;
+    committed(rel: string): CheckResult;
+    contains(rel: string, needle: string | RegExp, label?: string): CheckResult;
+    lacks(rel: string, needle: string | RegExp, label?: string): CheckResult;
+    script(pkgRel: string, name: string): CheckResult;
+    loads(rel: string): Promise<CheckResult>;
+    ci(script: string | RegExp): CheckResult;
+    ciJob(job: string, script: string): CheckResult;
+    hook(settingsRel: string, needle: string): CheckResult;
+    json(rel: string, test?: (data: unknown) => boolean, label?: string): CheckResult;
+    lint(probe: LintProbe): Promise<CheckResult>;
+    protectedBranch(pattern: RegExp): CheckResult;
+    gh(args: string[], label: string): CheckResult;
+    share(files: string[], test: (file: string) => boolean, label: string): CheckResult;
+}
+export interface GateCheck {
+    what: string;
+    run: () => Maybe<CheckResult>;
+    aggregate?: boolean;
+}
+export interface GateTicket {
+    ref: string;
+    title?: string;
+    owner: boolean;
+    checks: GateCheck[];
+}
+export interface TicketListEntry {
+    ref: string;
+    owner: string;
+    title: string;
+    parts?: string[];
+    aggregate?: boolean;
+}
+export interface GateSpec {
+    repo: string;
+    tickets: GateTicket[];
+    /** estiva-ui only: every ticket, and the repos it joins in. */
+    all?: TicketListEntry[];
+    /** estiva-ui only: the repos beside it. `app` is the folder its app sits in: `web` in Ship. */
+    siblings?: {
+        name: string;
+        path: string;
+        env: string;
+        app?: string;
+    }[];
+}
+/** What a report says ran it. A copy of the old script reports a hash instead. */
+export declare const ENGINE: string;
+/** The helpers, bound to one repository. */
+export declare function helpers(ROOT: string): GateHelpers;
+export interface StatusOptions {
+    /** The repository to report on. */
+    root?: string;
+    /** The folder that holds the app, relative to `root`: `web` in Ship, `.` elsewhere. */
+    app?: string;
+    json?: boolean;
+    detail?: boolean;
+}
+/** Print where the project stands. Returns what was printed, or the JSON report. */
+export declare function runStatus({ root, app, json, detail }?: StatusOptions): Promise<string>;
+export {};
+//# sourceMappingURL=status.d.ts.map