@estiva-app/ui 0.26.0 → 0.28.0

package/dist/registry/contract.d.ts

@@ -0,0 +1,29 @@
+import type { Registry } from './schema';
+/** The four headings, in the order a page carries them. */
+export declare const PAGE_SECTIONS: readonly ["When", "When not", "How", "What it owns"];
+/** The classes that owe a page and a picture. */
+export declare const CONTRACT_KINDS: readonly ["reusable", "promote-candidate"];
+/**
+ * Why a page breaks the contract, or null when it keeps it.
+ *
+ * Read on normalised text: the apps are checked out with CRLF on Windows.
+ */
+export declare function pageProblem(source: string): string | null;
+/** Whether a page records where the part is drawn, in place of a story of its own. */
+export declare function hasSeenIn(source: string): boolean;
+/**
+ * Every catalogue link that names a story or a docs page its Storybook does not
+ * have (UIG-19: a dead link is a build failure, not a dead end found six weeks
+ * later). `ids` is every entry id in the Storybook's own index — what
+ * `storybook index` writes — so this is Storybook's answer, not a guess at how
+ * it builds an id.
+ */
+export declare function linkProblems(registry: Registry, ids: ReadonlySet<string>): string[];
+/**
+ * Every way an app's catalogue breaks the contract, one line each, naming the
+ * part, its file and what to do. Empty when it keeps it.
+ *
+ * `root` is the app's own folder: the one its catalogue's paths are relative to.
+ */
+export declare function contractProblems(registry: Registry, root: string): string[];
+//# sourceMappingURL=contract.d.ts.map

package/dist/registry/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/registry/contract.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,2DAA2D;AAC3D,eAAO,MAAM,aAAa,sDAAuD,CAAA;AAEjF,iDAAiD;AACjD,eAAO,MAAM,cAAc,4CAA6C,CAAA;AAKxE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBzD;AAED,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CASnF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB3E"}

package/dist/registry/gated-5CPIUQAW.js

@@ -0,0 +1,230 @@
+#!/usr/bin/env node
+
+// src/registry/gated.ts
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+import ts from "typescript";
+var parse = (file, text) => ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+function declared(sf, name) {
+  let found = null;
+  const unwrap = (e) => {
+    if (!e) return null;
+    if (ts.isArrowFunction(e) || ts.isFunctionExpression(e)) return e;
+    if (ts.isCallExpression(e)) return unwrap(e.arguments[0]);
+    if (ts.isParenthesizedExpression(e) || ts.isAsExpression(e) || ts.isSatisfiesExpression(e)) return unwrap(e.expression);
+    return null;
+  };
+  for (const s of sf.statements) {
+    if (ts.isFunctionDeclaration(s) && s.name?.text === name) found = s;
+    if (ts.isVariableStatement(s)) {
+      for (const d of s.declarationList.declarations) if (ts.isIdentifier(d.name) && d.name.text === name) found = unwrap(d.initializer);
+    }
+  }
+  return found;
+}
+function propsOf(fn) {
+  const locals = /* @__PURE__ */ new Map();
+  const first = fn.parameters[0];
+  if (!first) return { locals, object: null };
+  if (ts.isObjectBindingPattern(first.name)) {
+    for (const el of first.name.elements) {
+      if (el.dotDotDotToken || !ts.isIdentifier(el.name)) continue;
+      const prop = el.propertyName && ts.isIdentifier(el.propertyName) ? el.propertyName.text : el.name.text;
+      locals.set(el.name.text, prop);
+    }
+    return { locals, object: null };
+  }
+  return { locals, object: ts.isIdentifier(first.name) ? first.name.text : null };
+}
+var drawsJsx = (node) => {
+  let yes = false;
+  const walk = (n) => {
+    if (yes) return;
+    if (ts.isJsxElement(n) || ts.isJsxSelfClosingElement(n) || ts.isJsxFragment(n)) yes = true;
+    else ts.forEachChild(n, walk);
+  };
+  walk(node);
+  return yes;
+};
+function gates(fn) {
+  const { locals, object } = propsOf(fn);
+  const out = /* @__PURE__ */ new Set();
+  const propIn = (e) => {
+    while (ts.isParenthesizedExpression(e) || ts.isNonNullExpression(e)) e = e.expression;
+    if (ts.isPrefixUnaryExpression(e) && e.operator === ts.SyntaxKind.ExclamationToken && ts.isPrefixUnaryExpression(e.operand)) return propIn(e.operand.operand);
+    if (ts.isBinaryExpression(e) && [ts.SyntaxKind.ExclamationEqualsToken, ts.SyntaxKind.ExclamationEqualsEqualsToken].includes(e.operatorToken.kind)) return propIn(e.left);
+    if (ts.isIdentifier(e)) return locals.get(e.text) ?? null;
+    if (object && ts.isPropertyAccessExpression(e) && ts.isIdentifier(e.expression) && e.expression.text === object) return e.name.text;
+    return null;
+  };
+  const walk = (n) => {
+    if (n !== fn && ts.isFunctionDeclaration(n)) return;
+    if (ts.isJsxExpression(n) && n.expression) {
+      const e = n.expression;
+      if (ts.isBinaryExpression(e) && e.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken && drawsJsx(e.right)) {
+        const p = propIn(e.left);
+        if (p) out.add(p);
+      }
+      if (ts.isConditionalExpression(e) && drawsJsx(e.whenTrue) && !drawsJsx(e.whenFalse)) {
+        const p = propIn(e.condition);
+        if (p) out.add(p);
+      }
+    }
+    ts.forEachChild(n, walk);
+  };
+  if (fn.body) walk(fn.body);
+  return out;
+}
+var ANY = "*";
+function passed(sf, tags) {
+  const out = /* @__PURE__ */ new Set();
+  const consts = /* @__PURE__ */ new Map();
+  for (const s of sf.statements) {
+    if (!ts.isVariableStatement(s)) continue;
+    for (const d of s.declarationList.declarations) if (ts.isIdentifier(d.name) && d.initializer && ts.isObjectLiteralExpression(d.initializer)) consts.set(d.name.text, d.initializer);
+  }
+  const keysOf = (o, seen) => {
+    for (const p of o.properties) {
+      if (ts.isSpreadAssignment(p)) {
+        const e = p.expression;
+        const name = ts.isIdentifier(e) ? e.text : ts.isPropertyAccessExpression(e) && ts.isIdentifier(e.expression) && e.name.text === "args" ? `${e.expression.text}.args` : null;
+        let target2;
+        if (name && !seen.has(name)) {
+          if (!name.endsWith(".args")) target2 = consts.get(name);
+          else {
+            const story = consts.get(name.slice(0, -".args".length));
+            const args = story?.properties.find((q) => ts.isPropertyAssignment(q) && ts.isIdentifier(q.name) && q.name.text === "args");
+            if (args && ts.isPropertyAssignment(args) && ts.isObjectLiteralExpression(args.initializer)) target2 = args.initializer;
+          }
+        }
+        if (target2) keysOf(target2, /* @__PURE__ */ new Set([...seen, name]));
+        else out.add(ANY);
+      } else if (p.name && (ts.isIdentifier(p.name) || ts.isStringLiteral(p.name))) out.add(p.name.text);
+    }
+  };
+  const walk = (n) => {
+    if (ts.isPropertyAssignment(n) && ts.isIdentifier(n.name) && n.name.text === "args") {
+      if (ts.isObjectLiteralExpression(n.initializer)) keysOf(n.initializer, /* @__PURE__ */ new Set());
+      else out.add(ANY);
+    }
+    if ((ts.isJsxSelfClosingElement(n) || ts.isJsxOpeningElement(n)) && tags.includes(n.tagName.getText(sf))) {
+      for (const a of n.attributes.properties) {
+        if (ts.isJsxAttribute(a)) out.add(a.name.getText(sf));
+        else if (ts.isJsxSpreadAttribute(a)) {
+          const target2 = ts.isIdentifier(a.expression) ? consts.get(a.expression.text) : void 0;
+          if (target2) keysOf(target2, /* @__PURE__ */ new Set());
+          else if (!(ts.isIdentifier(a.expression) && a.expression.text === "args")) out.add(ANY);
+        }
+      }
+    }
+    ts.forEachChild(n, walk);
+  };
+  walk(sf);
+  return out;
+}
+function storyFiles(root) {
+  const out = [];
+  const walk = (dir) => {
+    for (const name of readdirSync(dir)) {
+      if (name === "node_modules" || name.startsWith(".")) continue;
+      const path = join(dir, name);
+      if (statSync(path).isDirectory()) walk(path);
+      else if (/\.stories\.tsx?$/.test(name)) out.push(path);
+    }
+  };
+  if (existsSync(join(root, "src"))) walk(join(root, "src"));
+  return out;
+}
+function handsOn(fn, sf) {
+  const { locals, object } = propsOf(fn);
+  const out = [];
+  const walk = (n) => {
+    if (n !== fn && ts.isFunctionDeclaration(n)) return;
+    if (ts.isJsxSelfClosingElement(n) || ts.isJsxOpeningElement(n)) {
+      const tag = n.tagName.getText(sf);
+      if (/^[A-Z]/.test(tag)) {
+        for (const a of n.attributes.properties) {
+          if (!ts.isJsxAttribute(a) || !a.initializer || !ts.isJsxExpression(a.initializer) || !a.initializer.expression) continue;
+          const e = a.initializer.expression;
+          const prop = ts.isIdentifier(e) ? locals.get(e.text) : object && ts.isPropertyAccessExpression(e) && ts.isIdentifier(e.expression) && e.expression.text === object ? e.name.text : void 0;
+          if (prop) out.push({ tag, attr: a.name.getText(sf), prop });
+        }
+      }
+    }
+    ts.forEachChild(n, walk);
+  };
+  if (fn.body) walk(fn.body);
+  return out;
+}
+function target(from, spec, root) {
+  if (spec.startsWith(".")) return join(dirname(from), spec).replace(/\.[jt]sx?$/, "");
+  if (spec.startsWith("@/")) return join(root, "src", spec.slice(2)).replace(/\.[jt]sx?$/, "");
+  return null;
+}
+function gatedFindings(registry, root, { kinds = ["reusable", "promote-candidate"], pictured = "own" } = {}) {
+  const findings = [];
+  const stories = storyFiles(root).map((file) => ({ file, sf: parse(file, readFileSync(file, "utf8")) }));
+  const sources = /* @__PURE__ */ new Map();
+  const sourceOf = (rel) => {
+    const path = join(root, rel);
+    if (!sources.has(path)) {
+      if (!existsSync(path)) return null;
+      sources.set(path, parse(path, readFileSync(path, "utf8")));
+    }
+    return sources.get(path);
+  };
+  const fileOf = new Map(registry.entries.filter((e) => e.kind === "component").map((e) => [e.name, e.sourceFile]));
+  const givenTo = /* @__PURE__ */ new Map();
+  const storiesOf = (name, rel) => {
+    const key = `${rel}#${name}`;
+    if (!givenTo.has(key)) {
+      const own = join(root, rel).replace(/\.[jt]sx?$/, "");
+      const drawing = stories.filter(
+        ({ file, sf: s }) => s.statements.some((st) => ts.isImportDeclaration(st) && ts.isStringLiteral(st.moduleSpecifier) && target(file, st.moduleSpecifier.text, root) === own)
+      );
+      givenTo.set(key, { drawn: drawing.length > 0, given: new Set(drawing.flatMap(({ sf: s }) => [...passed(s, [name, `${name}View`])])) });
+    }
+    return givenTo.get(key);
+  };
+  const memo = /* @__PURE__ */ new Map();
+  const gatesOf = (name, sf, depth) => {
+    const key = `${sf.fileName}#${name}`;
+    if (memo.has(key)) return memo.get(key);
+    memo.set(key, /* @__PURE__ */ new Set());
+    const fn = declared(sf, name);
+    const out = fn ? gates(fn) : /* @__PURE__ */ new Set();
+    if (fn && depth < 3) {
+      for (const { tag, attr, prop } of handsOn(fn, sf)) {
+        if (out.has(prop) || /Dialog$/.test(tag)) continue;
+        const here = declared(sf, tag) ? sf : fileOf.has(tag) ? sourceOf(fileOf.get(tag)) : null;
+        if (!here || !gatesOf(tag, here, depth + 1).has(attr)) continue;
+        const theirs = fileOf.get(tag);
+        if (pictured === "anywhere" && theirs && here !== sf) {
+          const { given } = storiesOf(tag, theirs);
+          if (given.has(attr) || given.has(ANY)) continue;
+        }
+        out.add(prop);
+      }
+    }
+    memo.set(key, out);
+    return out;
+  };
+  for (const entry of registry.entries) {
+    const cls = entry.app?.class ?? "component";
+    if (!kinds.includes(cls) || entry.kind !== "component") continue;
+    const sf = sourceOf(entry.sourceFile);
+    if (!sf) continue;
+    const { drawn, given } = storiesOf(entry.name, entry.sourceFile);
+    if (!drawn || given.has(ANY)) continue;
+    for (const name of [entry.name, `${entry.name}View`]) {
+      for (const prop of gatesOf(name, sf, 0)) {
+        if (!given.has(prop)) findings.push({ part: entry.name, file: entry.sourceFile.split("\\").join("/"), prop, in: name });
+      }
+    }
+  }
+  return findings;
+}
+export {
+  gatedFindings
+};
+//# sourceMappingURL=gated-5CPIUQAW.js.map

package/dist/registry/gated-5CPIUQAW.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/registry/gated.ts"],
+  "sourcesContent": ["/**\n * What a part draws only when a prop is passed, and no story passes it (UIG-19,\n * Katerina's ruling 5).\n *\n * `{onReply && <IconButton \u2026 />}` works in the app, because the app passes\n * `onReply`. In Storybook nothing does, so the button is simply not there. It\n * reads as a broken behaviour rather than a missing fixture, and it hides the\n * very state a reviewer came to see. UIG-17 found five in Peek by hand: Reply on\n * ConversationCard, Edit and Delete on ReplyCard, Rename and Copy link on\n * TopicMoreMenu, Open original on ThreadPanel.\n *\n * Read with TypeScript, part by part. The gate is looked for only inside the\n * part's own function (and its `\u2026View` half, when the stories draw that),\n * because a file is not a component: UIG-17's first scan blamed ReplyCard for\n * two props that belong to a menu declared beside it. A story passes a prop by\n * naming it in an `args` object or as an attribute on the part's tag, anywhere\n * in a story file that imports the part's file.\n */\nimport { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'\nimport { basename, dirname, join, relative } from 'node:path'\nimport ts from 'typescript'\nimport type { Registry } from './schema'\n\nexport interface GatedFinding {\n  part: string\n  file: string\n  prop: string\n  /** The part or view whose body holds the gate. */\n  in: string\n}\n\nconst parse = (file: string, text: string) => ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX)\n\n/** The function a name is declared as: `function X`, `const X = (\u2026) =>`, `memo(\u2026)`, `forwardRef(\u2026)`. */\nfunction declared(sf: ts.SourceFile, name: string): ts.FunctionLikeDeclaration | null {\n  let found: ts.FunctionLikeDeclaration | null = null\n  const unwrap = (e: ts.Expression | undefined): ts.FunctionLikeDeclaration | null => {\n    if (!e) return null\n    if (ts.isArrowFunction(e) || ts.isFunctionExpression(e)) return e\n    if (ts.isCallExpression(e)) return unwrap(e.arguments[0])\n    if (ts.isParenthesizedExpression(e) || ts.isAsExpression(e) || ts.isSatisfiesExpression(e)) return unwrap(e.expression)\n    return null\n  }\n  for (const s of sf.statements) {\n    if (ts.isFunctionDeclaration(s) && s.name?.text === name) found = s\n    if (ts.isVariableStatement(s)) for (const d of s.declarationList.declarations) if (ts.isIdentifier(d.name) && d.name.text === name) found = unwrap(d.initializer)\n  }\n  return found\n}\n\n/** The props a function takes, by the name its body uses: `{ onReply, owner: who }` \u2192 onReply\u2192onReply, who\u2192owner. */\nfunction propsOf(fn: ts.FunctionLikeDeclaration): { locals: Map<string, string>; object: string | null } {\n  const locals = new Map<string, string>()\n  const first = fn.parameters[0]\n  if (!first) return { locals, object: null }\n  if (ts.isObjectBindingPattern(first.name)) {\n    for (const el of first.name.elements) {\n      if (el.dotDotDotToken || !ts.isIdentifier(el.name)) continue\n      const prop = el.propertyName && ts.isIdentifier(el.propertyName) ? el.propertyName.text : el.name.text\n      locals.set(el.name.text, prop)\n    }\n    return { locals, object: null }\n  }\n  return { locals, object: ts.isIdentifier(first.name) ? first.name.text : null }\n}\n\nconst drawsJsx = (node: ts.Node): boolean => {\n  let yes = false\n  const walk = (n: ts.Node) => {\n    if (yes) return\n    if (ts.isJsxElement(n) || ts.isJsxSelfClosingElement(n) || ts.isJsxFragment(n)) yes = true\n    else ts.forEachChild(n, walk)\n  }\n  walk(node)\n  return yes\n}\n\n/** Every prop that gates something drawn: `{p && <X/>}`, `{p ? <X/> : null}`, `{!!p && \u2026}`, `{p != null && \u2026}`. */\nfunction gates(fn: ts.FunctionLikeDeclaration): Set<string> {\n  const { locals, object } = propsOf(fn)\n  const out = new Set<string>()\n  const propIn = (e: ts.Expression): string | null => {\n    while (ts.isParenthesizedExpression(e) || ts.isNonNullExpression(e)) e = e.expression\n    if (ts.isPrefixUnaryExpression(e) && e.operator === ts.SyntaxKind.ExclamationToken && ts.isPrefixUnaryExpression(e.operand)) return propIn(e.operand.operand)\n    if (ts.isBinaryExpression(e) && [ts.SyntaxKind.ExclamationEqualsToken, ts.SyntaxKind.ExclamationEqualsEqualsToken].includes(e.operatorToken.kind)) return propIn(e.left)\n    if (ts.isIdentifier(e)) return locals.get(e.text) ?? null\n    if (object && ts.isPropertyAccessExpression(e) && ts.isIdentifier(e.expression) && e.expression.text === object) return e.name.text\n    return null\n  }\n  const walk = (n: ts.Node) => {\n    // A function declared inside is its own component or handler: not this part's markup.\n    if (n !== fn && ts.isFunctionDeclaration(n)) return\n    if (ts.isJsxExpression(n) && n.expression) {\n      const e = n.expression\n      if (ts.isBinaryExpression(e) && e.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken && drawsJsx(e.right)) {\n        const p = propIn(e.left)\n        if (p) out.add(p)\n      }\n      if (ts.isConditionalExpression(e) && drawsJsx(e.whenTrue) && !drawsJsx(e.whenFalse)) {\n        const p = propIn(e.condition)\n        if (p) out.add(p)\n      }\n    }\n    ts.forEachChild(n, walk)\n  }\n  if (fn.body) walk(fn.body)\n  return out\n}\n\n/** Stands for \"every prop\": a spread the reader cannot open might pass any of them. */\nconst ANY = '*'\n\n/**\n * Every prop name a story file passes: keys of any `args` object, and\n * attributes on the named tags. A spread of an object declared in the same\n * file is opened (`args: { replyCount: 3, ...replyRow }`); one it cannot open\n * \u2014 an import, a call \u2014 counts as passing everything, so the check stays quiet\n * rather than wrong.\n */\nfunction passed(sf: ts.SourceFile, tags: string[]): Set<string> {\n  const out = new Set<string>()\n  const consts = new Map<string, ts.ObjectLiteralExpression>()\n  for (const s of sf.statements) {\n    if (!ts.isVariableStatement(s)) continue\n    for (const d of s.declarationList.declarations) if (ts.isIdentifier(d.name) && d.initializer && ts.isObjectLiteralExpression(d.initializer)) consts.set(d.name.text, d.initializer)\n  }\n  const keysOf = (o: ts.ObjectLiteralExpression, seen: Set<string>) => {\n    for (const p of o.properties) {\n      if (ts.isSpreadAssignment(p)) {\n        // `...replyRow`, or another story's args: `...Topic.args`.\n        const e = p.expression\n        const name = ts.isIdentifier(e) ? e.text : ts.isPropertyAccessExpression(e) && ts.isIdentifier(e.expression) && e.name.text === 'args' ? `${e.expression.text}.args` : null\n        let target: ts.ObjectLiteralExpression | undefined\n        if (name && !seen.has(name)) {\n          if (!name.endsWith('.args')) target = consts.get(name)\n          else {\n            const story = consts.get(name.slice(0, -'.args'.length))\n            const args = story?.properties.find((q) => ts.isPropertyAssignment(q) && ts.isIdentifier(q.name) && q.name.text === 'args')\n            if (args && ts.isPropertyAssignment(args) && ts.isObjectLiteralExpression(args.initializer)) target = args.initializer\n          }\n        }\n        if (target) keysOf(target, new Set([...seen, name!]))\n        else out.add(ANY)\n      } else if (p.name && (ts.isIdentifier(p.name) || ts.isStringLiteral(p.name))) out.add(p.name.text)\n    }\n  }\n  const walk = (n: ts.Node) => {\n    if (ts.isPropertyAssignment(n) && ts.isIdentifier(n.name) && n.name.text === 'args') {\n      if (ts.isObjectLiteralExpression(n.initializer)) keysOf(n.initializer, new Set())\n      else out.add(ANY)\n    }\n    if ((ts.isJsxSelfClosingElement(n) || ts.isJsxOpeningElement(n)) && tags.includes(n.tagName.getText(sf))) {\n      for (const a of n.attributes.properties) {\n        if (ts.isJsxAttribute(a)) out.add(a.name.getText(sf))\n        else if (ts.isJsxSpreadAttribute(a)) {\n          const target = ts.isIdentifier(a.expression) ? consts.get(a.expression.text) : undefined\n          if (target) keysOf(target, new Set())\n          // `{...args}` hands on what `args` holds, and those are read where they are written.\n          else if (!(ts.isIdentifier(a.expression) && a.expression.text === 'args')) out.add(ANY)\n        }\n      }\n    }\n    ts.forEachChild(n, walk)\n  }\n  walk(sf)\n  return out\n}\n\nfunction storyFiles(root: string): string[] {\n  const out: string[] = []\n  const walk = (dir: string) => {\n    for (const name of readdirSync(dir)) {\n      if (name === 'node_modules' || name.startsWith('.')) continue\n      const path = join(dir, name)\n      if (statSync(path).isDirectory()) walk(path)\n      else if (/\\.stories\\.tsx?$/.test(name)) out.push(path)\n    }\n  }\n  if (existsSync(join(root, 'src'))) walk(join(root, 'src'))\n  return out\n}\n\n/** The props a part hands straight on to another tag: `<QuickActions onReply={onReply} />` \u2192 QuickActions, onReply, onReply. */\nfunction handsOn(fn: ts.FunctionLikeDeclaration, sf: ts.SourceFile): { tag: string; attr: string; prop: string }[] {\n  const { locals, object } = propsOf(fn)\n  const out: { tag: string; attr: string; prop: string }[] = []\n  const walk = (n: ts.Node) => {\n    if (n !== fn && ts.isFunctionDeclaration(n)) return\n    if (ts.isJsxSelfClosingElement(n) || ts.isJsxOpeningElement(n)) {\n      const tag = n.tagName.getText(sf)\n      if (/^[A-Z]/.test(tag)) {\n        for (const a of n.attributes.properties) {\n          if (!ts.isJsxAttribute(a) || !a.initializer || !ts.isJsxExpression(a.initializer) || !a.initializer.expression) continue\n          const e = a.initializer.expression\n          const prop = ts.isIdentifier(e) ? locals.get(e.text) : object && ts.isPropertyAccessExpression(e) && ts.isIdentifier(e.expression) && e.expression.text === object ? e.name.text : undefined\n          if (prop) out.push({ tag, attr: a.name.getText(sf), prop })\n        }\n      }\n    }\n    ts.forEachChild(n, walk)\n  }\n  if (fn.body) walk(fn.body)\n  return out\n}\n\n/** Where a module specifier points, without its extension: `./X`, or Vite's `@/` for `src/`. */\nfunction target(from: string, spec: string, root: string): string | null {\n  if (spec.startsWith('.')) return join(dirname(from), spec).replace(/\\.[jt]sx?$/, '')\n  if (spec.startsWith('@/')) return join(root, 'src', spec.slice(2)).replace(/\\.[jt]sx?$/, '')\n  return null\n}\n\n/**\n * Every prop that gates something a part draws, where some story draws the\n * part and none of those stories passes the prop.\n *\n * \"Draws the part\" means a story file imports the part's own file \u2014 its own\n * stories, or an umbrella sheet such as Peek's Overlays/Menus, which is how\n * TopicMoreMenu lost Rename and Copy link. A gate a part only hands on counts\n * as its own: ConversationCard hands `onReply` to the strip that draws Reply,\n * so a ConversationCard story that never passes it shows no Reply. Followed\n * three parts deep at most.\n */\nexport interface GatedOptions {\n  /** The classes checked. The contract's by default. */\n  kinds?: readonly string[]\n  /**\n   * `own`: a part's own stories show everything it can draw \u2014 ConversationCard's\n   * stories must show Reply. `anywhere`: a handed-on gate counts as shown when\n   * the part it is handed to has a story that shows it. Katerina rules which.\n   */\n  pictured?: 'own' | 'anywhere'\n}\n\nexport function gatedFindings(registry: Registry, root: string, { kinds = ['reusable', 'promote-candidate'], pictured = 'own' }: GatedOptions = {}): GatedFinding[] {\n  const findings: GatedFinding[] = []\n  const stories = storyFiles(root).map((file) => ({ file, sf: parse(file, readFileSync(file, 'utf8')) }))\n  const sources = new Map<string, ts.SourceFile>()\n  const sourceOf = (rel: string): ts.SourceFile | null => {\n    const path = join(root, rel)\n    if (!sources.has(path)) {\n      if (!existsSync(path)) return null\n      sources.set(path, parse(path, readFileSync(path, 'utf8')))\n    }\n    return sources.get(path)!\n  }\n  const fileOf = new Map(registry.entries.filter((e) => e.kind === 'component').map((e) => [e.name, e.sourceFile]))\n\n  /** The story files that import a file, and every prop they pass to the part or its view. */\n  const givenTo = new Map<string, { drawn: boolean; given: Set<string> }>()\n  const storiesOf = (name: string, rel: string) => {\n    const key = `${rel}#${name}`\n    if (!givenTo.has(key)) {\n      const own = join(root, rel).replace(/\\.[jt]sx?$/, '')\n      const drawing = stories.filter(({ file, sf: s }) =>\n        s.statements.some((st) => ts.isImportDeclaration(st) && ts.isStringLiteral(st.moduleSpecifier) && target(file, st.moduleSpecifier.text, root) === own),\n      )\n      givenTo.set(key, { drawn: drawing.length > 0, given: new Set(drawing.flatMap(({ sf: s }) => [...passed(s, [name, `${name}View`])])) })\n    }\n    return givenTo.get(key)!\n  }\n\n  const memo = new Map<string, Set<string>>()\n  /** The props a named part gates on, its own and those it hands to a part that gates. */\n  const gatesOf = (name: string, sf: ts.SourceFile, depth: number): Set<string> => {\n    const key = `${sf.fileName}#${name}`\n    if (memo.has(key)) return memo.get(key)!\n    memo.set(key, new Set())\n    const fn = declared(sf, name)\n    const out = fn ? gates(fn) : new Set<string>()\n    if (fn && depth < 3) {\n      for (const { tag, attr, prop } of handsOn(fn, sf)) {\n        // A dialog is shut in a story until someone opens it, so nothing it draws\n        // is missing from the picture (Katerina, 23 September).\n        if (out.has(prop) || /Dialog$/.test(tag)) continue\n        const here = declared(sf, tag) ? sf : fileOf.has(tag) ? sourceOf(fileOf.get(tag)!) : null\n        if (!here || !gatesOf(tag, here, depth + 1).has(attr)) continue\n        // Already pictured one level down: CollapsibleSection hands `trailing` to\n        // SectionHeader, and SectionHeader's own story shows the slot.\n        const theirs = fileOf.get(tag)\n        if (pictured === 'anywhere' && theirs && here !== sf) {\n          const { given } = storiesOf(tag, theirs)\n          if (given.has(attr) || given.has(ANY)) continue\n        }\n        out.add(prop)\n      }\n    }\n    memo.set(key, out)\n    return out\n  }\n\n  for (const entry of registry.entries) {\n    // The package's entries carry no app class: every one of its components is one.\n    const cls = entry.app?.class ?? 'component'\n    if (!kinds.includes(cls) || entry.kind !== 'component') continue\n    const sf = sourceOf(entry.sourceFile)\n    if (!sf) continue\n    const { drawn, given } = storiesOf(entry.name, entry.sourceFile)\n    // No story draws it at all: the contract's \"drawn nowhere\" says so, not this.\n    if (!drawn || given.has(ANY)) continue\n    for (const name of [entry.name, `${entry.name}View`]) {\n      for (const prop of gatesOf(name, sf, 0)) {\n        if (!given.has(prop)) findings.push({ part: entry.name, file: entry.sourceFile.split('\\\\').join('/'), prop, in: name })\n      }\n    }\n  }\n  return findings\n}\n"],
+  "mappings": "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",
+  "names": ["target"]
+}

package/dist/registry/gated.d.ts

@@ -0,0 +1,31 @@
+import type { Registry } from './schema';
+export interface GatedFinding {
+    part: string;
+    file: string;
+    prop: string;
+    /** The part or view whose body holds the gate. */
+    in: string;
+}
+/**
+ * Every prop that gates something a part draws, where some story draws the
+ * part and none of those stories passes the prop.
+ *
+ * "Draws the part" means a story file imports the part's own file — its own
+ * stories, or an umbrella sheet such as Peek's Overlays/Menus, which is how
+ * TopicMoreMenu lost Rename and Copy link. A gate a part only hands on counts
+ * as its own: ConversationCard hands `onReply` to the strip that draws Reply,
+ * so a ConversationCard story that never passes it shows no Reply. Followed
+ * three parts deep at most.
+ */
+export interface GatedOptions {
+    /** The classes checked. The contract's by default. */
+    kinds?: readonly string[];
+    /**
+     * `own`: a part's own stories show everything it can draw — ConversationCard's
+     * stories must show Reply. `anywhere`: a handed-on gate counts as shown when
+     * the part it is handed to has a story that shows it. Katerina rules which.
+     */
+    pictured?: 'own' | 'anywhere';
+}
+export declare function gatedFindings(registry: Registry, root: string, { kinds, pictured }?: GatedOptions): GatedFinding[];
+//# sourceMappingURL=gated.d.ts.map

package/dist/registry/gated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gated.d.ts","sourceRoot":"","sources":["../../src/registry/gated.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAA;CACX;AAuLD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;CAC9B;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAyC,EAAE,QAAgB,EAAE,GAAE,YAAiB,GAAG,YAAY,EAAE,CAyElK"}

package/dist/registry/index.d.ts

@@ -12,6 +12,7 @@
  */
 export { buildRegistry, readIndexExports, serializeRegistry, type BuildOptions } from './build';
 export { buildAppRegistry, type AppBuildOptions } from './app';
+export { CONTRACT_KINDS, PAGE_SECTIONS, contractProblems, hasSeenIn, linkProblems, pageProblem } from './contract';
 export { docsLink, findInRegistries, findInRegistry, formatFindings, type Finding } from './find';
 export { CLASSES, SCHEMA_VERSION, validateRegistry, type AppFacts, type EntryBehaviour, type EntryClass, type FileWithoutPart, type EntryKind, type EntryStatus, type EntryVariant, type PurposeSource, type Registry, type RegistryEntry, type RegistryExclusion, } from './schema';
 //# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AAC/F,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,OAAO,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAA;AACjG,OAAO,EACL,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AAC/F,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,OAAO,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAClH,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAA;AACjG,OAAO,EACL,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAA"}

package/dist/registry/index.js

@@ -1,13 +1,19 @@
 #!/usr/bin/env node
 import {
+  CONTRACT_KINDS,
+  PAGE_SECTIONS,
+  contractProblems,
   docsLink,
   findInRegistries,
   findInRegistry,
-  formatFindings
-} from "./chunk-W2B2G7OE.js";
+  formatFindings,
+  hasSeenIn,
+  linkProblems,
+  pageProblem
+} from "./chunk-6OH3TWGF.js";
 import {
   buildAppRegistry
-} from "./chunk-WMFF3MPP.js";
+} from "./chunk-XCBN2EKW.js";
 import {
   buildRegistry,
   readIndexExports,
@@ -20,13 +26,19 @@ import {
 } from "./chunk-E4JNV7PC.js";
 export {
   CLASSES,
+  CONTRACT_KINDS,
+  PAGE_SECTIONS,
   SCHEMA_VERSION,
   buildAppRegistry,
   buildRegistry,
+  contractProblems,
   docsLink,
   findInRegistries,
   findInRegistry,
   formatFindings,
+  hasSeenIn,
+  linkProblems,
+  pageProblem,
   readIndexExports,
   serializeRegistry,
   validateRegistry

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@estiva-app/ui",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "description": "Estiva's design tokens (the contract) and a small set of primitives (a convenience) for every Estiva app.",
   "type": "module",
   "license": "MIT",

package/registry.json

@@ -4,7 +4,7 @@
     "kind": "package",
     "repo": "estiva-ui",
     "package": "@estiva-app/ui",
-    "packageVersion": "0.26.0",
+    "packageVersion": "0.28.0",
     "exports": 87,
     "typeExports": 96,
     "files": null

package/src/CollapsibleSection.stories.tsx

@@ -1,5 +1,6 @@
 import type { Meta, StoryObj } from '@storybook/react-vite'
 import { IconPlus } from '@tabler/icons-react'
+import { Chip } from './Chip'
 import { CollapsibleSection } from './CollapsibleSection'
 import { NavItem } from './NavItem'
 
@@ -33,6 +34,11 @@ export const WithActions: Story = {
   args: { actions: [{ icon: <IconPlus size={16} stroke={1.5} />, tooltip: 'Add', onClick: () => {} }] },
 }
 
+/** A count beside the title, held on screen whether the section is open or closed. */
+export const WithTrailing: Story = {
+  args: { trailing: <Chip type="brand" label="2" /> },
+}
+
 /** Close it and reload the page: still closed. This browser remembers, under the key. */
 export const Remembered: Story = { args: { storageKey: 'estiva-ui.stories.collapsible-section' } }
 

package/src/ListColumn.stories.tsx

@@ -59,6 +59,12 @@ export const Default: Story = {
   render: (args) => <ListColumn {...args}>{rows(6)}</ListColumn>,
 }
 
+/** `chevron`: a chevron after the title, as ContainerHeader draws it, for a column whose title opens something. */
+export const WithChevron: Story = {
+  args: { title: 'Items', chevron: true, actions },
+  render: (args) => <ListColumn {...args}>{rows(6)}</ListColumn>,
+}
+
 /**
  * Groups. Each is headed by a package part, never by a row drawn by hand: a
  * group that folds is a `CollapsibleSection`; a group that does not fold is a