@estiva-app/ui 0.21.0 → 0.22.0

package/dist/registry/chunk-QDYGB3QN.js

@@ -0,0 +1,352 @@
+#!/usr/bin/env node
+import {
+  SCHEMA_VERSION
+} from "./chunk-MRSBS5OP.js";
+
+// src/registry/build.ts
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import ts from "typescript";
+import { OWNED_BEHAVIOURS } from "../eslint/index.js";
+var PACKAGE_IMPORT = "@estiva-app/ui";
+function sanitize(name) {
+  return name.toLowerCase().replace(/[ ’–—―′¿'`~!@#$%^&*()_|+\-=?;:'",.<>{}[\]\\/]/g, "-").replace(/-+/g, "-").replace(/^-+/, "").replace(/-+$/, "");
+}
+function storyNameFromExport(key) {
+  return key.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/([a-zA-Z])([0-9])/g, "$1 $2").replace(/([0-9])([a-zA-Z])/g, "$1 $2").replace(/[_-]+/g, " ").trim();
+}
+var toId = (title, name) => `${sanitize(title)}--${sanitize(storyNameFromExport(name))}`;
+function readIndexExports(source) {
+  const file = ts.createSourceFile("index.ts", source, ts.ScriptTarget.Latest, true);
+  const found = [];
+  for (const statement of file.statements) {
+    if (!ts.isExportDeclaration(statement)) continue;
+    const from = statement.moduleSpecifier;
+    const clause = statement.exportClause;
+    if (!from || !ts.isStringLiteral(from) || !clause || !ts.isNamedExports(clause)) continue;
+    for (const element of clause.elements) {
+      found.push({ name: element.name.text, module: from.text.replace(/^\.\//, ""), isType: statement.isTypeOnly || element.isTypeOnly });
+    }
+  }
+  return found;
+}
+function docAbove(source, node, headerPos = null) {
+  const ranges = ts.getLeadingCommentRanges(source, node.getFullStart()) ?? [];
+  const jsdoc = ranges.filter((range) => source.slice(range.pos, range.pos + 3) === "/**").pop();
+  if (!jsdoc) return "";
+  if (headerPos !== null && jsdoc.pos === headerPos) return "";
+  const between = source.slice(jsdoc.end, node.getStart());
+  if (between.trim() !== "") return "";
+  return source.slice(jsdoc.pos, jsdoc.end).split(/\r?\n/).map((line) => line.trim().replace(/^\/\*\*/, "").replace(/\*\/$/, "").replace(/^\*/, "").trim()).join("\n").trim();
+}
+function firstSentence(prose) {
+  const flat = prose.split(/\n\s*\n/)[0].split("\n").filter((line2) => !line2.trim().startsWith("@")).join(" ").replace(/\*\*/g, "").replace(/\s+/g, " ").trim();
+  const parts = flat.split(/(?<=[.!?])\s+(?=[A-Z`'"‘“])/);
+  let line = parts[0] ?? "";
+  if (line.length < 40 && parts[1]) line = `${line} ${parts[1]}`;
+  return line.trim();
+}
+function pageOpening(mdx) {
+  const lines = mdx.split(/\r?\n/);
+  const heading = lines.findIndex((line) => /^#\s+\S/.test(line));
+  if (heading < 0) return "";
+  const paragraph = [];
+  for (const line of lines.slice(heading + 1)) {
+    const text = line.trim();
+    if (text === "") {
+      if (paragraph.length) break;
+      continue;
+    }
+    if (text.startsWith("<") || text.startsWith("#")) break;
+    paragraph.push(text);
+  }
+  return paragraph.join(" ");
+}
+function propName(member) {
+  if (!member.name) return null;
+  if (ts.isIdentifier(member.name) || ts.isStringLiteral(member.name)) return member.name.text;
+  return null;
+}
+function literalUnion(type, aliases, seen = /* @__PURE__ */ new Set()) {
+  if (!type) return null;
+  if (ts.isTypeReferenceNode(type) && ts.isIdentifier(type.typeName)) {
+    const name = type.typeName.text;
+    if (seen.has(name)) return null;
+    seen.add(name);
+    const alias = aliases.get(name);
+    return alias ? literalUnion(alias, aliases, seen) : null;
+  }
+  if (ts.isLiteralTypeNode(type) && ts.isStringLiteral(type.literal)) return [type.literal.text];
+  if (!ts.isUnionTypeNode(type)) return null;
+  const values = [];
+  for (const member of type.types) {
+    if (member.kind === ts.SyntaxKind.UndefinedKeyword || member.kind === ts.SyntaxKind.NullKeyword) continue;
+    const inner = literalUnion(member, aliases, seen);
+    if (!inner) return null;
+    values.push(...inner);
+  }
+  return values.length > 1 ? values : null;
+}
+function readModule(source, sibling = () => void 0) {
+  const file = ts.createSourceFile("module.tsx", source, ts.ScriptTarget.Latest, true);
+  const declarations = /* @__PURE__ */ new Map();
+  const aliases = /* @__PURE__ */ new Map();
+  const shapes = /* @__PURE__ */ new Map();
+  const bases = /* @__PURE__ */ new Map();
+  const importedFrom = /* @__PURE__ */ new Map();
+  const propsTypeOf = (parameters) => parameters[0]?.type;
+  const propsOfInitializer = (initializer) => {
+    if (!initializer) return void 0;
+    if (ts.isArrowFunction(initializer) || ts.isFunctionExpression(initializer)) return propsTypeOf(initializer.parameters);
+    if (ts.isCallExpression(initializer)) {
+      const callee = ts.isPropertyAccessExpression(initializer.expression) ? initializer.expression.name.text : ts.isIdentifier(initializer.expression) ? initializer.expression.text : "";
+      if (callee === "forwardRef" && initializer.typeArguments?.[1]) return initializer.typeArguments[1];
+      const wrapped = initializer.arguments.find((argument) => ts.isArrowFunction(argument) || ts.isFunctionExpression(argument));
+      if (wrapped) return propsTypeOf(wrapped.parameters);
+    }
+    return void 0;
+  };
+  const opening = file.statements.find((statement) => !ts.isImportDeclaration(statement));
+  const headerPos = opening ? (ts.getLeadingCommentRanges(source, opening.getFullStart()) ?? []).find((range) => source.slice(range.pos, range.pos + 3) === "/**")?.pos ?? null : null;
+  for (const statement of file.statements) {
+    if (ts.isImportDeclaration(statement) && ts.isStringLiteral(statement.moduleSpecifier)) {
+      const bindings = statement.importClause?.namedBindings;
+      if (bindings && ts.isNamedImports(bindings)) {
+        for (const element of bindings.elements) importedFrom.set(element.name.text, statement.moduleSpecifier.text);
+      }
+    }
+    if (ts.isTypeAliasDeclaration(statement)) aliases.set(statement.name.text, statement.type);
+    if (ts.isInterfaceDeclaration(statement)) {
+      shapes.set(statement.name.text, [...statement.members]);
+      const extended = (statement.heritageClauses ?? []).flatMap((clause) => [...clause.types]);
+      if (extended.length) bases.set(statement.name.text, extended);
+    }
+    if (ts.isTypeAliasDeclaration(statement) && ts.isTypeLiteralNode(statement.type)) shapes.set(statement.name.text, [...statement.type.members]);
+    const exported = ts.canHaveModifiers(statement) && ts.getModifiers(statement)?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+    if (!exported) continue;
+    const doc = docAbove(source, statement, headerPos);
+    const deprecated = /(^|\n)@deprecated\b/.test(doc) || /\*\s*@deprecated\b/.test(source.slice(Math.max(0, statement.getFullStart()), statement.getStart()));
+    if (ts.isFunctionDeclaration(statement) && statement.name) {
+      declarations.set(statement.name.text, { doc, deprecated, propsType: propsTypeOf(statement.parameters) });
+      continue;
+    }
+    if (ts.isVariableStatement(statement)) {
+      for (const declaration of statement.declarationList.declarations) {
+        if (!ts.isIdentifier(declaration.name)) continue;
+        declarations.set(declaration.name.text, { doc, deprecated, propsType: propsOfInitializer(declaration.initializer) });
+      }
+    }
+  }
+  const EMPTY = { props: [], variants: [] };
+  const keysOf = (type) => {
+    if (!type) return null;
+    if (ts.isLiteralTypeNode(type) && ts.isStringLiteral(type.literal)) return [type.literal.text];
+    if (!ts.isUnionTypeNode(type)) return null;
+    const keys = [];
+    for (const member of type.types) {
+      if (!ts.isLiteralTypeNode(member) || !ts.isStringLiteral(member.literal)) return null;
+      keys.push(member.literal.text);
+    }
+    return keys;
+  };
+  const narrow = (resolved, how, keys) => {
+    if (!keys) return resolved;
+    const named = new Set(keys);
+    const keep = (name) => how === "Omit" ? !named.has(name) : named.has(name);
+    return { props: resolved.props.filter((prop) => keep(prop.name)), variants: resolved.variants.filter((variant) => keep(variant.prop)) };
+  };
+  const merge = (parts) => {
+    const props = [];
+    const variants = [];
+    const seenProp = /* @__PURE__ */ new Set();
+    const seenVariant = /* @__PURE__ */ new Set();
+    for (const part of parts) {
+      for (const prop of part.props) if (!seenProp.has(prop.name)) seenProp.add(prop.name), props.push(prop);
+      for (const variant of part.variants) if (!seenVariant.has(variant.prop)) seenVariant.add(variant.prop), variants.push(variant);
+    }
+    return { props, variants };
+  };
+  const takes = (type, values) => {
+    if (values) return values.join(" | ");
+    if (!type) return "anything";
+    const written = type.getText(file).replace(/\s+/g, " ").trim();
+    if (written === "boolean") return "true/false";
+    if (written === "number") return "number";
+    if (written === "string") return "text";
+    if (/^React(Node|Element)\b/.test(written)) return "anything";
+    if (written.includes("=>")) return "a handler";
+    return written.length > 60 ? `${written.slice(0, 57)}\u2026` : written;
+  };
+  const fromMembers = (members) => {
+    const props = [];
+    const variants = [];
+    for (const member of members) {
+      const name = propName(member);
+      if (name === null || !ts.isPropertySignature(member)) continue;
+      const values = literalUnion(member.type, aliases);
+      const note = firstSentence(docAbove(source, member));
+      props.push({ name, takes: takes(member.type, values), required: !member.questionToken, note: note || null });
+      if (values) variants.push({ prop: name, values });
+    }
+    return { props, variants };
+  };
+  const resolveNode = (type, seen) => {
+    if (!type || seen.size > 12) return EMPTY;
+    if (ts.isTypeLiteralNode(type)) return fromMembers(type.members);
+    if (ts.isIntersectionTypeNode(type)) return merge(type.types.map((side) => resolveNode(side, seen)));
+    if (ts.isTypeReferenceNode(type) && ts.isIdentifier(type.typeName)) {
+      const named = type.typeName.text;
+      if (named === "Omit" || named === "Pick") {
+        return narrow(resolveNode(type.typeArguments?.[0], seen), named, keysOf(type.typeArguments?.[1]));
+      }
+      return resolveName(named, seen);
+    }
+    return EMPTY;
+  };
+  const resolveBase = (base, seen) => {
+    if (!ts.isIdentifier(base.expression)) return EMPTY;
+    const named = base.expression.text;
+    if (named === "Omit" || named === "Pick") {
+      return narrow(resolveNode(base.typeArguments?.[0], seen), named, keysOf(base.typeArguments?.[1]));
+    }
+    return resolveName(named, seen);
+  };
+  function resolveName(name, seen) {
+    if (seen.has(name) || seen.size > 12) return EMPTY;
+    seen.add(name);
+    const own = shapes.get(name);
+    if (own) {
+      const inherited = (bases.get(name) ?? []).map((base) => resolveBase(base, seen));
+      return merge([fromMembers(own), ...inherited]);
+    }
+    const alias = aliases.get(name);
+    if (alias) return resolveNode(alias, seen);
+    const from = importedFrom.get(name);
+    return (from?.startsWith("./") ? sibling(from.slice(2), name) : void 0) ?? EMPTY;
+  }
+  const resolve = (propsType) => resolveNode(propsType, /* @__PURE__ */ new Set());
+  return { declarations, resolve, resolveName: (name) => resolveName(name, /* @__PURE__ */ new Set()) };
+}
+function readStories(source) {
+  const file = ts.createSourceFile("x.stories.tsx", source, ts.ScriptTarget.Latest, true);
+  let title = null;
+  const stories = [];
+  for (const statement of file.statements) {
+    if (ts.isVariableStatement(statement)) {
+      for (const declaration of statement.declarationList.declarations) {
+        if (!ts.isIdentifier(declaration.name)) continue;
+        const initializer = declaration.initializer;
+        const object = initializer && ts.isSatisfiesExpression(initializer) ? initializer.expression : initializer;
+        if (declaration.name.text === "meta" && object && ts.isObjectLiteralExpression(object)) {
+          for (const property of object.properties) {
+            if (ts.isPropertyAssignment(property) && ts.isIdentifier(property.name) && property.name.text === "title" && ts.isStringLiteral(property.initializer)) {
+              title = property.initializer.text;
+            }
+          }
+        }
+        const exported = ts.getModifiers(statement)?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+        if (exported && declaration.name.text !== "meta") stories.push(declaration.name.text);
+      }
+    }
+  }
+  return { title, stories };
+}
+var isAllCaps = (name) => /^[A-Z0-9_]+$/.test(name);
+function kindOf(name) {
+  if (/^use[A-Z]/.test(name)) return "hook";
+  return /^[A-Z]/.test(name) && !isAllCaps(name) ? "component" : "helper";
+}
+function behavioursOf(name) {
+  return OWNED_BEHAVIOURS.filter((owned) => owned.owners.includes(name)).map((owned) => ({ id: owned.id, behaviour: owned.behaviour }));
+}
+function buildRegistry({ root = process.cwd(), repo = "estiva-ui" } = {}) {
+  const src = join(root, "src");
+  const manifest = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+  const files = new Set(readdirSync(src));
+  const exported = readIndexExports(readFileSync(join(src, "index.ts"), "utf8"));
+  const values = exported.filter((entry) => !entry.isType);
+  const modules = /* @__PURE__ */ new Map();
+  const moduleOf = (name) => {
+    const held = modules.get(name);
+    if (held) return held;
+    const file = [".tsx", ".ts"].map((extension) => `${name}${extension}`).find((candidate) => files.has(candidate));
+    if (!file) throw new Error(`src/index.ts exports from './${name}', which is not a file in src/`);
+    const read = { ...readModule(readFileSync(join(src, file), "utf8"), (module, typeName) => moduleOf(module).resolveName(typeName)), file: `src/${file}` };
+    modules.set(name, read);
+    return read;
+  };
+  const problems = [];
+  const entries = [];
+  for (const value of values) {
+    const module = moduleOf(value.module);
+    const declared = module.declarations.get(value.name);
+    if (!declared) {
+      problems.push(`${value.name} is exported from './${value.module}' but is not declared there`);
+      continue;
+    }
+    const pageFile = files.has(`${value.name}.mdx`) ? `src/${value.name}.mdx` : null;
+    const fromPage = pageFile ? firstSentence(pageOpening(readFileSync(join(root, pageFile), "utf8"))) : "";
+    const fromComment = firstSentence(declared.doc);
+    const purpose = fromPage || fromComment;
+    if (!purpose) {
+      problems.push(`${value.name} has no purpose: no opening paragraph on its page, and no doc comment above it in ${module.file}`);
+      continue;
+    }
+    const storiesFile = files.has(`${value.name}.stories.tsx`) ? `${value.name}.stories.tsx` : files.has(`${value.module}.stories.tsx`) ? `${value.module}.stories.tsx` : null;
+    const stories = storiesFile ? readStories(readFileSync(join(src, storiesFile), "utf8")) : { title: null, stories: [] };
+    const title = stories.title;
+    const story = stories.stories.includes(value.name) ? value.name : stories.stories[0];
+    const shape = module.resolve(declared.propsType);
+    entries.push({
+      name: value.name,
+      repo,
+      kind: kindOf(value.name),
+      importPath: PACKAGE_IMPORT,
+      sourceFile: module.file,
+      purpose,
+      purposeFrom: fromPage ? "page" : "comment",
+      props: shape.props,
+      variants: shape.variants,
+      ownsBehaviours: behavioursOf(value.name),
+      status: declared.deprecated ? "deprecated" : "stable",
+      migrationStage: null,
+      docsId: title ? `${sanitize(title)}--docs` : null,
+      storyId: title && story ? toId(title, story) : null,
+      docPage: pageFile
+    });
+  }
+  if (problems.length) throw new Error(`the registry cannot be built:
+  ${problems.join("\n  ")}`);
+  entries.sort((a, b) => a.name.localeCompare(b.name));
+  return {
+    schemaVersion: SCHEMA_VERSION,
+    builtFrom: {
+      repo,
+      package: manifest.name,
+      packageVersion: manifest.version,
+      exports: values.length,
+      typeExports: exported.length - values.length
+    },
+    storybook: {
+      docsPath: "/?path=/docs/{docsId}",
+      storyPath: "/?path=/story/{storyId}",
+      devUrl: "http://localhost:6008"
+    },
+    entries,
+    // Nothing is excluded: every value export is an entry, helpers and the one
+    // hook included, each marked by `kind`. The field stays because the count
+    // has to reconcile out loud — see validateRegistry.
+    excluded: []
+  };
+}
+function serializeRegistry(registry) {
+  return `${JSON.stringify(registry, null, 2)}
+`;
+}
+
+export {
+  readIndexExports,
+  buildRegistry,
+  serializeRegistry
+};
+//# sourceMappingURL=chunk-QDYGB3QN.js.map

package/dist/registry/chunk-QDYGB3QN.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/registry/build.ts"],
+  "sourcesContent": ["/// <reference types=\"node\" />\n/**\n * The catalogue's builder (UIG-12): it reads the code and writes\n * `registry.json`. Nothing here is kept by hand, and CI rebuilds it and fails\n * on a difference, so the file cannot drift from what it describes.\n *\n * **Why a parser and not a regex.** This package's components are flat in\n * `src/`, with `.tsx`, `.mdx`, `.stories.tsx` and sometimes `.test.tsx` side by\n * side, and **a file is not a component**: eleven files export more than one\n * name \u2014 `Menu.tsx` alone exports seven \u2014 and `Skeleton.tsx` exports no\n * `Skeleton` at all. Pairing by filename gets `FieldLine`, `MenuItem` and every\n * one of those wrong. The target set is what `src/index.ts` exports, read with\n * TypeScript's own parser, and everything else is looked up from there.\n *\n * TypeScript is the app's own install, as it is for the gate pieces\n * (`build.mjs`): every package this names stays external.\n */\nimport { existsSync, readFileSync, readdirSync } from 'node:fs'\nimport { join } from 'node:path'\nimport ts from 'typescript'\nimport { OWNED_BEHAVIOURS } from '../eslint/index'\nimport { SCHEMA_VERSION, type EntryBehaviour, type EntryKind, type EntryProp, type EntryVariant, type Registry, type RegistryEntry } from './schema'\n\nexport interface BuildOptions {\n  /** The repository's top folder. */\n  root?: string\n  /** The name this registry's entries are recorded under. One repo per registry until UIG-13. */\n  repo?: string\n}\n\n/** One name as `index.ts` exports it. */\ninterface RawExport {\n  name: string\n  /** The sibling it comes from, without `./`. */\n  module: string\n  isType: boolean\n}\n\n/** What the parser found above and about one exported declaration. */\ninterface Declared {\n  /** The doc comment, cleaned, or `''`. */\n  doc: string\n  deprecated: boolean\n  /**\n   * Its first parameter's type, as written. Kept as the node and resolved after\n   * the whole file is walked: a props interface is often declared *below* the\n   * component that takes it.\n   */\n  propsType?: ts.TypeNode\n}\n\nconst PACKAGE_IMPORT = '@estiva-app/ui'\n\n/**\n * Storybook's own `sanitize`, which is what turns a title and a story's export\n * name into the id in the URL. Copied rather than imported: `storybook` is a\n * dev dependency of this repo and must not become a runtime dependency of the\n * builder, which apps run. A test holds this to the ids a real Storybook build\n * produces.\n */\nfunction sanitize(name: string): string {\n  return name\n    .toLowerCase()\n    .replace(/[ \u2019\u2013\u2014\u2015\u2032\u00BF'`~!@#$%^&*()_|+\\-=?;:'\",.<>{}[\\]\\\\/]/g, '-')\n    .replace(/-+/g, '-')\n    .replace(/^-+/, '')\n    .replace(/-+$/, '')\n}\n\n/**\n * Storybook's `storyNameFromExport`, which is lodash's `startCase`: an export\n * called `WithCounts` is the story \"With Counts\", and its id is\n * `navigation-tabs--with-counts`, not `--withcounts`.\n *\n * Measured against a real `storybook build` (2026-09-18): without this, 11 of\n * the 81 ids resolved nowhere \u2014 every export whose name is more than one word.\n * Written out rather than pulled from lodash or `@storybook/csf`, neither of\n * which may become a runtime dependency of a builder that apps run.\n */\nfunction storyNameFromExport(key: string): string {\n  return key\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')\n    .replace(/([a-zA-Z])([0-9])/g, '$1 $2')\n    .replace(/([0-9])([a-zA-Z])/g, '$1 $2')\n    .replace(/[_-]+/g, ' ')\n    .trim()\n}\n\nconst toId = (title: string, name: string) => `${sanitize(title)}--${sanitize(storyNameFromExport(name))}`\n\n/** Read `src/index.ts`. Its `export { \u2026 } from './Sibling'` statements are the target set. */\nexport function readIndexExports(source: string): RawExport[] {\n  const file = ts.createSourceFile('index.ts', source, ts.ScriptTarget.Latest, true)\n  const found: RawExport[] = []\n  for (const statement of file.statements) {\n    if (!ts.isExportDeclaration(statement)) continue\n    const from = statement.moduleSpecifier\n    const clause = statement.exportClause\n    if (!from || !ts.isStringLiteral(from) || !clause || !ts.isNamedExports(clause)) continue\n    for (const element of clause.elements) {\n      found.push({ name: element.name.text, module: from.text.replace(/^\\.\\//, ''), isType: statement.isTypeOnly || element.isTypeOnly })\n    }\n  }\n  return found\n}\n\n/**\n * The doc comment immediately above a declaration, cleaned of its markers.\n * `''` when there is none.\n *\n * `headerPos` is where the **file's** own header comment starts, and a\n * declaration never gets to claim it. Measured: `Skeleton.tsx` opens with a\n * paragraph about the whole family and `export function SkeletonBar` follows it\n * directly, so the bar was given the family's description \u2014 right-looking, and\n * wrong. Refusing it turns that into a build failure with the export's name in\n * it, which is a line somebody then writes.\n */\nfunction docAbove(source: string, node: ts.Node, headerPos: number | null = null): string {\n  const ranges = ts.getLeadingCommentRanges(source, node.getFullStart()) ?? []\n  const jsdoc = ranges.filter((range) => source.slice(range.pos, range.pos + 3) === '/**').pop()\n  if (!jsdoc) return ''\n  if (headerPos !== null && jsdoc.pos === headerPos) return ''\n  // Only a comment that sits against the declaration describes it: anything\n  // with a blank line or another statement between them is about something else.\n  const between = source.slice(jsdoc.end, node.getStart())\n  if (between.trim() !== '') return ''\n  return source\n    .slice(jsdoc.pos, jsdoc.end)\n    .split(/\\r?\\n/)\n    .map((line) => line.trim().replace(/^\\/\\*\\*/, '').replace(/\\*\\/$/, '').replace(/^\\*/, '').trim())\n    .join('\\n')\n    .trim()\n}\n\n/**\n * The first sentence of a block of prose, which is the purpose.\n *\n * A sentence ends at `.`, `!` or `?` followed by a space and something that\n * starts a new one. A very short first sentence takes the next as well \u2014\n * \"A list of actions from a trigger.\" is a purpose; \"One row, two parts.\" is\n * not, on its own.\n */\nfunction firstSentence(prose: string): string {\n  const flat = prose\n    .split(/\\n\\s*\\n/)[0]\n    .split('\\n')\n    .filter((line) => !line.trim().startsWith('@'))\n    .join(' ')\n    .replace(/\\*\\*/g, '')\n    .replace(/\\s+/g, ' ')\n    .trim()\n  const parts = flat.split(/(?<=[.!?])\\s+(?=[A-Z`'\"\u2018\u201C])/)\n  let line = parts[0] ?? ''\n  if (line.length < 40 && parts[1]) line = `${line} ${parts[1]}`\n  return line.trim()\n}\n\n/** A page's opening paragraph: everything between its `# Heading` and the first blank line. */\nfunction pageOpening(mdx: string): string {\n  const lines = mdx.split(/\\r?\\n/)\n  const heading = lines.findIndex((line) => /^#\\s+\\S/.test(line))\n  if (heading < 0) return ''\n  const paragraph: string[] = []\n  for (const line of lines.slice(heading + 1)) {\n    const text = line.trim()\n    if (text === '') {\n      if (paragraph.length) break\n      continue\n    }\n    // A canvas, an import or the next heading: the opening paragraph is over,\n    // or there never was one.\n    if (text.startsWith('<') || text.startsWith('#')) break\n    paragraph.push(text)\n  }\n  return paragraph.join(' ')\n}\n\n/**\n * A property's name, however it is written.\n *\n * **A quoted name is a name.** `'aria-label'?: string` cannot be written as an\n * identifier, so a reader that takes identifiers only drops it \u2014 and with it\n * every accessible name this package declares. Found by comparing against\n * `react-docgen`, a parser with none of this one's assumptions: 13 props over\n * 10 files, two of them required (`Reaction`, `Toolbar`).\n */\nfunction propName(member: ts.TypeElement): string | null {\n  if (!member.name) return null\n  if (ts.isIdentifier(member.name) || ts.isStringLiteral(member.name)) return member.name.text\n  return null\n}\n\n/** A union of string literals, following one local type alias if the property points at one. */\nfunction literalUnion(type: ts.TypeNode | undefined, aliases: Map<string, ts.TypeNode>, seen = new Set<string>()): string[] | null {\n  if (!type) return null\n  if (ts.isTypeReferenceNode(type) && ts.isIdentifier(type.typeName)) {\n    const name = type.typeName.text\n    if (seen.has(name)) return null\n    seen.add(name)\n    const alias = aliases.get(name)\n    return alias ? literalUnion(alias, aliases, seen) : null\n  }\n  if (ts.isLiteralTypeNode(type) && ts.isStringLiteral(type.literal)) return [type.literal.text]\n  if (!ts.isUnionTypeNode(type)) return null\n  const values: string[] = []\n  for (const member of type.types) {\n    // `'small' | 'default' | undefined` is still a set of two words.\n    if (member.kind === ts.SyntaxKind.UndefinedKeyword || member.kind === ts.SyntaxKind.NullKeyword) continue\n    const inner = literalUnion(member, aliases, seen)\n    if (!inner) return null\n    values.push(...inner)\n  }\n  return values.length > 1 ? values : null\n}\n\n/** Everything one sibling file says about the names it exports. */\n/** A type\u2019s finished props and word-choices, read by the module that declares them. */\ninterface Resolved {\n  props: EntryProp[]\n  variants: EntryVariant[]\n}\n\n/** Ask another file of this package for a type it declares, already resolved. */\ntype Sibling = (module: string, typeName: string) => Resolved | undefined\n\nfunction readModule(source: string, sibling: Sibling = () => undefined) {\n  const file = ts.createSourceFile('module.tsx', source, ts.ScriptTarget.Latest, true)\n  const declarations = new Map<string, Declared>()\n  const aliases = new Map<string, ts.TypeNode>()\n  const shapes = new Map<string, ts.TypeElement[]>()\n  /** What each interface extends, as written \u2014 `Omit<IdentityMenuProps, 'compact'>` and all. */\n  const bases = new Map<string, ts.ExpressionWithTypeArguments[]>()\n  /** Which module each imported name came from. */\n  const importedFrom = new Map<string, string>()\n\n  const propsTypeOf = (parameters: readonly ts.ParameterDeclaration[]): ts.TypeNode | undefined => parameters[0]?.type\n\n  /**\n   * The props type of `const X = \u2026`.\n   *\n   * A plain function expression carries it on its first parameter. `forwardRef`\n   * carries it as its **second type argument** and leaves the inner function's\n   * parameter bare \u2014 `TextInput`, whose `size` was missed until this read it.\n   */\n  const propsOfInitializer = (initializer: ts.Expression | undefined): ts.TypeNode | undefined => {\n    if (!initializer) return undefined\n    if (ts.isArrowFunction(initializer) || ts.isFunctionExpression(initializer)) return propsTypeOf(initializer.parameters)\n    if (ts.isCallExpression(initializer)) {\n      const callee = ts.isPropertyAccessExpression(initializer.expression) ? initializer.expression.name.text : ts.isIdentifier(initializer.expression) ? initializer.expression.text : ''\n      if (callee === 'forwardRef' && initializer.typeArguments?.[1]) return initializer.typeArguments[1]\n      // `memo(function X({ \u2026 }: Props) { \u2026 })` and anything else that wraps a\n      // function written out at the call.\n      const wrapped = initializer.arguments.find((argument) => ts.isArrowFunction(argument) || ts.isFunctionExpression(argument))\n      if (wrapped) return propsTypeOf((wrapped as ts.ArrowFunction | ts.FunctionExpression).parameters)\n    }\n    return undefined\n  }\n\n  // The file's header comment: the first `/**` above the first thing that is\n  // not an import. It belongs to the file, whatever export happens to follow it.\n  const opening = file.statements.find((statement) => !ts.isImportDeclaration(statement))\n  const headerPos = opening ? ((ts.getLeadingCommentRanges(source, opening.getFullStart()) ?? []).find((range) => source.slice(range.pos, range.pos + 3) === '/**')?.pos ?? null) : null\n\n  for (const statement of file.statements) {\n    if (ts.isImportDeclaration(statement) && ts.isStringLiteral(statement.moduleSpecifier)) {\n      const bindings = statement.importClause?.namedBindings\n      if (bindings && ts.isNamedImports(bindings)) {\n        for (const element of bindings.elements) importedFrom.set(element.name.text, statement.moduleSpecifier.text)\n      }\n    }\n    if (ts.isTypeAliasDeclaration(statement)) aliases.set(statement.name.text, statement.type)\n    if (ts.isInterfaceDeclaration(statement)) {\n      shapes.set(statement.name.text, [...statement.members])\n      // The whole clause, not its name: `extends Omit<IdentityMenuProps,\n      // 'compact'>` reads as the name `Omit` and loses both the type it wraps\n      // and the key it drops.\n      const extended = (statement.heritageClauses ?? []).flatMap((clause) => [...clause.types])\n      if (extended.length) bases.set(statement.name.text, extended)\n    }\n    if (ts.isTypeAliasDeclaration(statement) && ts.isTypeLiteralNode(statement.type)) shapes.set(statement.name.text, [...statement.type.members])\n\n    const exported = ts.canHaveModifiers(statement) && ts.getModifiers(statement)?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)\n    if (!exported) continue\n    const doc = docAbove(source, statement, headerPos)\n    const deprecated = /(^|\\n)@deprecated\\b/.test(doc) || /\\*\\s*@deprecated\\b/.test(source.slice(Math.max(0, statement.getFullStart()), statement.getStart()))\n\n    if (ts.isFunctionDeclaration(statement) && statement.name) {\n      declarations.set(statement.name.text, { doc, deprecated, propsType: propsTypeOf(statement.parameters) })\n      continue\n    }\n    if (ts.isVariableStatement(statement)) {\n      for (const declaration of statement.declarationList.declarations) {\n        if (!ts.isIdentifier(declaration.name)) continue\n        declarations.set(declaration.name.text, { doc, deprecated, propsType: propsOfInitializer(declaration.initializer) })\n      }\n    }\n  }\n  /**\n   * A type's props and its word-choices, **resolved in the file that declares\n   * them**.\n   *\n   * This is the whole shape of the thing, and the reason for it is a bug that\n   * looked like nothing: a `ts.TypeElement` carries positions into *its own*\n   * source text, so handing a sibling's node to this file's `getText`, `aliases`\n   * and `docAbove` reads the wrong file at those offsets. `ToolbarButton` came\n   * out with `variant: \"ats over what it a\"` and `children: \"omeAndEndK\"` \u2014\n   * real prop names, and slices of another file for their types. Nothing caught\n   * it: the names were right, and the cross-check against `react-docgen`\n   * compared names.\n   *\n   * So a sibling never returns nodes. It returns finished props, read by the\n   * module that owns them, and this file only merges them.\n   */\n  const EMPTY: Resolved = { props: [], variants: [] }\n\n  /** The keys named by an `Omit`/`Pick` argument: `'a'` or `'a' | 'b'`. */\n  const keysOf = (type: ts.TypeNode | undefined): string[] | null => {\n    if (!type) return null\n    if (ts.isLiteralTypeNode(type) && ts.isStringLiteral(type.literal)) return [type.literal.text]\n    if (!ts.isUnionTypeNode(type)) return null\n    const keys: string[] = []\n    for (const member of type.types) {\n      if (!ts.isLiteralTypeNode(member) || !ts.isStringLiteral(member.literal)) return null\n      keys.push(member.literal.text)\n    }\n    return keys\n  }\n\n  /** `Omit` drops the keys it names, `Pick` keeps only them. Unreadable keys change nothing. */\n  const narrow = (resolved: Resolved, how: 'Omit' | 'Pick', keys: string[] | null): Resolved => {\n    if (!keys) return resolved\n    const named = new Set(keys)\n    const keep = (name: string) => (how === 'Omit' ? !named.has(name) : named.has(name))\n    return { props: resolved.props.filter((prop) => keep(prop.name)), variants: resolved.variants.filter((variant) => keep(variant.prop)) }\n  }\n\n  /** The first of each name wins, so what a type declares itself beats what it inherits. */\n  const merge = (parts: Resolved[]): Resolved => {\n    const props: EntryProp[] = []\n    const variants: EntryVariant[] = []\n    const seenProp = new Set<string>()\n    const seenVariant = new Set<string>()\n    for (const part of parts) {\n      for (const prop of part.props) if (!seenProp.has(prop.name)) (seenProp.add(prop.name), props.push(prop))\n      for (const variant of part.variants) if (!seenVariant.has(variant.prop)) (seenVariant.add(variant.prop), variants.push(variant))\n    }\n    return { props, variants }\n  }\n\n  /**\n   * What a prop takes, in a word a person reads. The type as written is the\n   * fallback, not the answer: `(next: string) => void` tells a reader nothing\n   * they cannot guess, and \"a handler\" tells them what to pass.\n   */\n  const takes = (type: ts.TypeNode | undefined, values: string[] | null): string => {\n    if (values) return values.join(' | ')\n    if (!type) return 'anything'\n    const written = type.getText(file).replace(/\\s+/g, ' ').trim()\n    if (written === 'boolean') return 'true/false'\n    if (written === 'number') return 'number'\n    if (written === 'string') return 'text'\n    if (/^React(Node|Element)\\b/.test(written)) return 'anything'\n    if (written.includes('=>')) return 'a handler'\n    return written.length > 60 ? `${written.slice(0, 57)}\u2026` : written\n  }\n\n  /** Members of this file, read with this file's text and aliases. */\n  const fromMembers = (members: readonly ts.TypeElement[]): Resolved => {\n    const props: EntryProp[] = []\n    const variants: EntryVariant[] = []\n    for (const member of members) {\n      const name = propName(member)\n      if (name === null || !ts.isPropertySignature(member)) continue\n      const values = literalUnion(member.type, aliases)\n      const note = firstSentence(docAbove(source, member))\n      props.push({ name, takes: takes(member.type, values), required: !member.questionToken, note: note || null })\n      if (values) variants.push({ prop: name, values })\n    }\n    return { props, variants }\n  }\n\n  const resolveNode = (type: ts.TypeNode | undefined, seen: Set<string>): Resolved => {\n    if (!type || seen.size > 12) return EMPTY\n    // `{ tone?: 'primary' | 'secondary' }` written out at the parameter.\n    if (ts.isTypeLiteralNode(type)) return fromMembers(type.members)\n    if (ts.isIntersectionTypeNode(type)) return merge(type.types.map((side) => resolveNode(side, seen)))\n    if (ts.isTypeReferenceNode(type) && ts.isIdentifier(type.typeName)) {\n      const named = type.typeName.text\n      if (named === 'Omit' || named === 'Pick') {\n        return narrow(resolveNode(type.typeArguments?.[0], seen), named, keysOf(type.typeArguments?.[1]))\n      }\n      return resolveName(named, seen)\n    }\n    return EMPTY\n  }\n\n  /** A heritage clause is not a `TypeNode`, and carries the same `Omit<\u2026>` shapes. */\n  const resolveBase = (base: ts.ExpressionWithTypeArguments, seen: Set<string>): Resolved => {\n    if (!ts.isIdentifier(base.expression)) return EMPTY\n    const named = base.expression.text\n    if (named === 'Omit' || named === 'Pick') {\n      return narrow(resolveNode(base.typeArguments?.[0], seen), named, keysOf(base.typeArguments?.[1]))\n    }\n    return resolveName(named, seen)\n  }\n\n  /**\n   * A named type: its own props, plus everything it extends **within this\n   * package**.\n   *\n   * It stops at React and Base UI on purpose. `ToolbarButtonProps extends\n   * IconButtonProps` is ours, and `variant`, `pressed` and `tooltip` are things\n   * `ToolbarButton` genuinely takes; `ButtonProps extends\n   * ComponentPropsWithRef<'button'>` is the DOM, and listing `onCopy` and\n   * `spellCheck` would bury the answer. The rule is where the type is declared,\n   * not what it is called.\n   */\n  function resolveName(name: string, seen: Set<string>): Resolved {\n    if (seen.has(name) || seen.size > 12) return EMPTY\n    seen.add(name)\n    const own = shapes.get(name)\n    if (own) {\n      const inherited = (bases.get(name) ?? []).map((base) => resolveBase(base, seen))\n      return merge([fromMembers(own), ...inherited])\n    }\n    // `type ToolbarInputProps = TextInputProps` \u2014 an alias, not an interface.\n    const alias = aliases.get(name)\n    if (alias) return resolveNode(alias, seen)\n    // Not declared here at all. Follow the import, but only into this package.\n    const from = importedFrom.get(name)\n    return (from?.startsWith('./') ? sibling(from.slice(2), name) : undefined) ?? EMPTY\n  }\n\n  /** What one declaration's first parameter takes. */\n  const resolve = (propsType: ts.TypeNode | undefined): Resolved => resolveNode(propsType, new Set())\n\n  return { declarations, resolve, resolveName: (name: string) => resolveName(name, new Set()) }\n}\n\n/** The `title` a stories file gives Storybook, and the stories it exports. */\nfunction readStories(source: string): { title: string | null; stories: string[] } {\n  const file = ts.createSourceFile('x.stories.tsx', source, ts.ScriptTarget.Latest, true)\n  let title: string | null = null\n  const stories: string[] = []\n  for (const statement of file.statements) {\n    if (ts.isVariableStatement(statement)) {\n      for (const declaration of statement.declarationList.declarations) {\n        if (!ts.isIdentifier(declaration.name)) continue\n        const initializer = declaration.initializer\n        const object = initializer && ts.isSatisfiesExpression(initializer) ? initializer.expression : initializer\n        if (declaration.name.text === 'meta' && object && ts.isObjectLiteralExpression(object)) {\n          for (const property of object.properties) {\n            if (ts.isPropertyAssignment(property) && ts.isIdentifier(property.name) && property.name.text === 'title' && ts.isStringLiteral(property.initializer)) {\n              title = property.initializer.text\n            }\n          }\n        }\n        const exported = ts.getModifiers(statement)?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)\n        if (exported && declaration.name.text !== 'meta') stories.push(declaration.name.text)\n      }\n    }\n  }\n  return { title, stories }\n}\n\nconst isAllCaps = (name: string) => /^[A-Z0-9_]+$/.test(name)\n\n/** What a name is. A constant and a function are both helpers; only a `use\u2026` is a hook. */\nfunction kindOf(name: string): EntryKind {\n  if (/^use[A-Z]/.test(name)) return 'hook'\n  return /^[A-Z]/.test(name) && !isAllCaps(name) ? 'component' : 'helper'\n}\n\n/** What UIG-8's enumeration says this component owns. */\nfunction behavioursOf(name: string): EntryBehaviour[] {\n  return OWNED_BEHAVIOURS.filter((owned) => owned.owners.includes(name)).map((owned) => ({ id: owned.id, behaviour: owned.behaviour }))\n}\n\n/**\n * Read the repository and return the catalogue.\n *\n * Throws on anything it cannot explain \u2014 a missing sibling, a name with no\n * purpose anywhere. A registry that quietly drops what it could not read is\n * worse than no registry, because a reader cannot tell the difference between\n * \"we have nothing for that\" and \"the builder gave up\".\n */\nexport function buildRegistry({ root = process.cwd(), repo = 'estiva-ui' }: BuildOptions = {}): Registry {\n  const src = join(root, 'src')\n  const manifest = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')) as { name: string; version: string }\n  const files = new Set(readdirSync(src))\n  const exported = readIndexExports(readFileSync(join(src, 'index.ts'), 'utf8'))\n  const values = exported.filter((entry) => !entry.isType)\n\n  type Module = ReturnType<typeof readModule> & { file: string }\n  const modules = new Map<string, Module>()\n  const moduleOf = (name: string): Module => {\n    const held = modules.get(name)\n    if (held) return held\n    const file = ['.tsx', '.ts'].map((extension) => `${name}${extension}`).find((candidate) => files.has(candidate))\n    if (!file) throw new Error(`src/index.ts exports from './${name}', which is not a file in src/`)\n    // The callback lets one file's props type reach a type declared in another\n    // \u2014 `ToolbarButtonProps extends IconButtonProps`. It is only called later,\n    // by which time this module is in the cache, so the recursion terminates.\n    const read = { ...readModule(readFileSync(join(src, file), 'utf8'), (module, typeName) => moduleOf(module).resolveName(typeName)), file: `src/${file}` }\n    modules.set(name, read)\n    return read\n  }\n\n  const problems: string[] = []\n  const entries: RegistryEntry[] = []\n\n  for (const value of values) {\n    const module = moduleOf(value.module)\n    const declared = module.declarations.get(value.name)\n    if (!declared) {\n      problems.push(`${value.name} is exported from './${value.module}' but is not declared there`)\n      continue\n    }\n\n    // A name with a page of its own takes its purpose from the page; the rest\n    // are documented on a sibling's page, and take it from the comment above\n    // the export. Every one of them has one \u2014 the build fails below if not.\n    const pageFile = files.has(`${value.name}.mdx`) ? `src/${value.name}.mdx` : null\n    const fromPage = pageFile ? firstSentence(pageOpening(readFileSync(join(root, pageFile), 'utf8'))) : ''\n    const fromComment = firstSentence(declared.doc)\n    const purpose = fromPage || fromComment\n    if (!purpose) {\n      problems.push(`${value.name} has no purpose: no opening paragraph on its page, and no doc comment above it in ${module.file}`)\n      continue\n    }\n\n    // A name with stories of its own uses them; otherwise the sibling's, which\n    // is the page that documents it.\n    const storiesFile = files.has(`${value.name}.stories.tsx`) ? `${value.name}.stories.tsx` : files.has(`${value.module}.stories.tsx`) ? `${value.module}.stories.tsx` : null\n    const stories = storiesFile ? readStories(readFileSync(join(src, storiesFile), 'utf8')) : { title: null, stories: [] }\n    const title = stories.title\n    const story = stories.stories.includes(value.name) ? value.name : stories.stories[0]\n\n    const shape = module.resolve(declared.propsType)\n\n    entries.push({\n      name: value.name,\n      repo,\n      kind: kindOf(value.name),\n      importPath: PACKAGE_IMPORT,\n      sourceFile: module.file,\n      purpose,\n      purposeFrom: fromPage ? 'page' : 'comment',\n      props: shape.props,\n      variants: shape.variants,\n      ownsBehaviours: behavioursOf(value.name),\n      status: declared.deprecated ? 'deprecated' : 'stable',\n      migrationStage: null,\n      docsId: title ? `${sanitize(title)}--docs` : null,\n      storyId: title && story ? toId(title, story) : null,\n      docPage: pageFile,\n    })\n  }\n\n  if (problems.length) throw new Error(`the registry cannot be built:\\n  ${problems.join('\\n  ')}`)\n\n  entries.sort((a, b) => a.name.localeCompare(b.name))\n\n  return {\n    schemaVersion: SCHEMA_VERSION,\n    builtFrom: {\n      repo,\n      package: manifest.name,\n      packageVersion: manifest.version,\n      exports: values.length,\n      typeExports: exported.length - values.length,\n    },\n    storybook: {\n      docsPath: '/?path=/docs/{docsId}',\n      storyPath: '/?path=/story/{storyId}',\n      devUrl: 'http://localhost:6008',\n    },\n    entries,\n    // Nothing is excluded: every value export is an entry, helpers and the one\n    // hook included, each marked by `kind`. The field stays because the count\n    // has to reconcile out loud \u2014 see validateRegistry.\n    excluded: [],\n  }\n}\n\n/** The committed file's text, so a check and a write produce the same bytes. */\nexport function serializeRegistry(registry: Registry): string {\n  return `${JSON.stringify(registry, null, 2)}\\n`\n}\n"],
+  "mappings": ";;;;;;AAiBA,SAAqB,cAAc,mBAAmB;AACtD,SAAS,YAAY;AACrB,OAAO,QAAQ;AACf,SAAS,wBAAwB;AA+BjC,IAAM,iBAAiB;AASvB,SAAS,SAAS,MAAsB;AACtC,SAAO,KACJ,YAAY,EACZ,QAAQ,kDAAkD,GAAG,EAC7D,QAAQ,OAAO,GAAG,EAClB,QAAQ,OAAO,EAAE,EACjB,QAAQ,OAAO,EAAE;AACtB;AAYA,SAAS,oBAAoB,KAAqB;AAChD,SAAO,IACJ,QAAQ,sBAAsB,OAAO,EACrC,QAAQ,yBAAyB,OAAO,EACxC,QAAQ,sBAAsB,OAAO,EACrC,QAAQ,sBAAsB,OAAO,EACrC,QAAQ,UAAU,GAAG,EACrB,KAAK;AACV;AAEA,IAAM,OAAO,CAAC,OAAe,SAAiB,GAAG,SAAS,KAAK,CAAC,KAAK,SAAS,oBAAoB,IAAI,CAAC,CAAC;AAGjG,SAAS,iBAAiB,QAA6B;AAC5D,QAAM,OAAO,GAAG,iBAAiB,YAAY,QAAQ,GAAG,aAAa,QAAQ,IAAI;AACjF,QAAM,QAAqB,CAAC;AAC5B,aAAW,aAAa,KAAK,YAAY;AACvC,QAAI,CAAC,GAAG,oBAAoB,SAAS,EAAG;AACxC,UAAM,OAAO,UAAU;AACvB,UAAM,SAAS,UAAU;AACzB,QAAI,CAAC,QAAQ,CAAC,GAAG,gBAAgB,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,eAAe,MAAM,EAAG;AACjF,eAAW,WAAW,OAAO,UAAU;AACrC,YAAM,KAAK,EAAE,MAAM,QAAQ,KAAK,MAAM,QAAQ,KAAK,KAAK,QAAQ,SAAS,EAAE,GAAG,QAAQ,UAAU,cAAc,QAAQ,WAAW,CAAC;AAAA,IACpI;AAAA,EACF;AACA,SAAO;AACT;AAaA,SAAS,SAAS,QAAgB,MAAe,YAA2B,MAAc;AACxF,QAAM,SAAS,GAAG,wBAAwB,QAAQ,KAAK,aAAa,CAAC,KAAK,CAAC;AAC3E,QAAM,QAAQ,OAAO,OAAO,CAAC,UAAU,OAAO,MAAM,MAAM,KAAK,MAAM,MAAM,CAAC,MAAM,KAAK,EAAE,IAAI;AAC7F,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,cAAc,QAAQ,MAAM,QAAQ,UAAW,QAAO;AAG1D,QAAM,UAAU,OAAO,MAAM,MAAM,KAAK,KAAK,SAAS,CAAC;AACvD,MAAI,QAAQ,KAAK,MAAM,GAAI,QAAO;AAClC,SAAO,OACJ,MAAM,MAAM,KAAK,MAAM,GAAG,EAC1B,MAAM,OAAO,EACb,IAAI,CAAC,SAAS,KAAK,KAAK,EAAE,QAAQ,WAAW,EAAE,EAAE,QAAQ,SAAS,EAAE,EAAE,QAAQ,OAAO,EAAE,EAAE,KAAK,CAAC,EAC/F,KAAK,IAAI,EACT,KAAK;AACV;AAUA,SAAS,cAAc,OAAuB;AAC5C,QAAM,OAAO,MACV,MAAM,SAAS,EAAE,CAAC,EAClB,MAAM,IAAI,EACV,OAAO,CAACA,UAAS,CAACA,MAAK,KAAK,EAAE,WAAW,GAAG,CAAC,EAC7C,KAAK,GAAG,EACR,QAAQ,SAAS,EAAE,EACnB,QAAQ,QAAQ,GAAG,EACnB,KAAK;AACR,QAAM,QAAQ,KAAK,MAAM,6BAA6B;AACtD,MAAI,OAAO,MAAM,CAAC,KAAK;AACvB,MAAI,KAAK,SAAS,MAAM,MAAM,CAAC,EAAG,QAAO,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC;AAC5D,SAAO,KAAK,KAAK;AACnB;AAGA,SAAS,YAAY,KAAqB;AACxC,QAAM,QAAQ,IAAI,MAAM,OAAO;AAC/B,QAAM,UAAU,MAAM,UAAU,CAAC,SAAS,UAAU,KAAK,IAAI,CAAC;AAC9D,MAAI,UAAU,EAAG,QAAO;AACxB,QAAM,YAAsB,CAAC;AAC7B,aAAW,QAAQ,MAAM,MAAM,UAAU,CAAC,GAAG;AAC3C,UAAM,OAAO,KAAK,KAAK;AACvB,QAAI,SAAS,IAAI;AACf,UAAI,UAAU,OAAQ;AACtB;AAAA,IACF;AAGA,QAAI,KAAK,WAAW,GAAG,KAAK,KAAK,WAAW,GAAG,EAAG;AAClD,cAAU,KAAK,IAAI;AAAA,EACrB;AACA,SAAO,UAAU,KAAK,GAAG;AAC3B;AAWA,SAAS,SAAS,QAAuC;AACvD,MAAI,CAAC,OAAO,KAAM,QAAO;AACzB,MAAI,GAAG,aAAa,OAAO,IAAI,KAAK,GAAG,gBAAgB,OAAO,IAAI,EAAG,QAAO,OAAO,KAAK;AACxF,SAAO;AACT;AAGA,SAAS,aAAa,MAA+B,SAAmC,OAAO,oBAAI,IAAY,GAAoB;AACjI,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,GAAG,oBAAoB,IAAI,KAAK,GAAG,aAAa,KAAK,QAAQ,GAAG;AAClE,UAAM,OAAO,KAAK,SAAS;AAC3B,QAAI,KAAK,IAAI,IAAI,EAAG,QAAO;AAC3B,SAAK,IAAI,IAAI;AACb,UAAM,QAAQ,QAAQ,IAAI,IAAI;AAC9B,WAAO,QAAQ,aAAa,OAAO,SAAS,IAAI,IAAI;AAAA,EACtD;AACA,MAAI,GAAG,kBAAkB,IAAI,KAAK,GAAG,gBAAgB,KAAK,OAAO,EAAG,QAAO,CAAC,KAAK,QAAQ,IAAI;AAC7F,MAAI,CAAC,GAAG,gBAAgB,IAAI,EAAG,QAAO;AACtC,QAAM,SAAmB,CAAC;AAC1B,aAAW,UAAU,KAAK,OAAO;AAE/B,QAAI,OAAO,SAAS,GAAG,WAAW,oBAAoB,OAAO,SAAS,GAAG,WAAW,YAAa;AACjG,UAAM,QAAQ,aAAa,QAAQ,SAAS,IAAI;AAChD,QAAI,CAAC,MAAO,QAAO;AACnB,WAAO,KAAK,GAAG,KAAK;AAAA,EACtB;AACA,SAAO,OAAO,SAAS,IAAI,SAAS;AACtC;AAYA,SAAS,WAAW,QAAgB,UAAmB,MAAM,QAAW;AACtE,QAAM,OAAO,GAAG,iBAAiB,cAAc,QAAQ,GAAG,aAAa,QAAQ,IAAI;AACnF,QAAM,eAAe,oBAAI,IAAsB;AAC/C,QAAM,UAAU,oBAAI,IAAyB;AAC7C,QAAM,SAAS,oBAAI,IAA8B;AAEjD,QAAM,QAAQ,oBAAI,IAA8C;AAEhE,QAAM,eAAe,oBAAI,IAAoB;AAE7C,QAAM,cAAc,CAAC,eAA4E,WAAW,CAAC,GAAG;AAShH,QAAM,qBAAqB,CAAC,gBAAoE;AAC9F,QAAI,CAAC,YAAa,QAAO;AACzB,QAAI,GAAG,gBAAgB,WAAW,KAAK,GAAG,qBAAqB,WAAW,EAAG,QAAO,YAAY,YAAY,UAAU;AACtH,QAAI,GAAG,iBAAiB,WAAW,GAAG;AACpC,YAAM,SAAS,GAAG,2BAA2B,YAAY,UAAU,IAAI,YAAY,WAAW,KAAK,OAAO,GAAG,aAAa,YAAY,UAAU,IAAI,YAAY,WAAW,OAAO;AAClL,UAAI,WAAW,gBAAgB,YAAY,gBAAgB,CAAC,EAAG,QAAO,YAAY,cAAc,CAAC;AAGjG,YAAM,UAAU,YAAY,UAAU,KAAK,CAAC,aAAa,GAAG,gBAAgB,QAAQ,KAAK,GAAG,qBAAqB,QAAQ,CAAC;AAC1H,UAAI,QAAS,QAAO,YAAa,QAAqD,UAAU;AAAA,IAClG;AACA,WAAO;AAAA,EACT;AAIA,QAAM,UAAU,KAAK,WAAW,KAAK,CAAC,cAAc,CAAC,GAAG,oBAAoB,SAAS,CAAC;AACtF,QAAM,YAAY,WAAY,GAAG,wBAAwB,QAAQ,QAAQ,aAAa,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,UAAU,OAAO,MAAM,MAAM,KAAK,MAAM,MAAM,CAAC,MAAM,KAAK,GAAG,OAAO,OAAQ;AAElL,aAAW,aAAa,KAAK,YAAY;AACvC,QAAI,GAAG,oBAAoB,SAAS,KAAK,GAAG,gBAAgB,UAAU,eAAe,GAAG;AACtF,YAAM,WAAW,UAAU,cAAc;AACzC,UAAI,YAAY,GAAG,eAAe,QAAQ,GAAG;AAC3C,mBAAW,WAAW,SAAS,SAAU,cAAa,IAAI,QAAQ,KAAK,MAAM,UAAU,gBAAgB,IAAI;AAAA,MAC7G;AAAA,IACF;AACA,QAAI,GAAG,uBAAuB,SAAS,EAAG,SAAQ,IAAI,UAAU,KAAK,MAAM,UAAU,IAAI;AACzF,QAAI,GAAG,uBAAuB,SAAS,GAAG;AACxC,aAAO,IAAI,UAAU,KAAK,MAAM,CAAC,GAAG,UAAU,OAAO,CAAC;AAItD,YAAM,YAAY,UAAU,mBAAmB,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,KAAK,CAAC;AACxF,UAAI,SAAS,OAAQ,OAAM,IAAI,UAAU,KAAK,MAAM,QAAQ;AAAA,IAC9D;AACA,QAAI,GAAG,uBAAuB,SAAS,KAAK,GAAG,kBAAkB,UAAU,IAAI,EAAG,QAAO,IAAI,UAAU,KAAK,MAAM,CAAC,GAAG,UAAU,KAAK,OAAO,CAAC;AAE7I,UAAM,WAAW,GAAG,iBAAiB,SAAS,KAAK,GAAG,aAAa,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,aAAa;AACjI,QAAI,CAAC,SAAU;AACf,UAAM,MAAM,SAAS,QAAQ,WAAW,SAAS;AACjD,UAAM,aAAa,sBAAsB,KAAK,GAAG,KAAK,qBAAqB,KAAK,OAAO,MAAM,KAAK,IAAI,GAAG,UAAU,aAAa,CAAC,GAAG,UAAU,SAAS,CAAC,CAAC;AAEzJ,QAAI,GAAG,sBAAsB,SAAS,KAAK,UAAU,MAAM;AACzD,mBAAa,IAAI,UAAU,KAAK,MAAM,EAAE,KAAK,YAAY,WAAW,YAAY,UAAU,UAAU,EAAE,CAAC;AACvG;AAAA,IACF;AACA,QAAI,GAAG,oBAAoB,SAAS,GAAG;AACrC,iBAAW,eAAe,UAAU,gBAAgB,cAAc;AAChE,YAAI,CAAC,GAAG,aAAa,YAAY,IAAI,EAAG;AACxC,qBAAa,IAAI,YAAY,KAAK,MAAM,EAAE,KAAK,YAAY,WAAW,mBAAmB,YAAY,WAAW,EAAE,CAAC;AAAA,MACrH;AAAA,IACF;AAAA,EACF;AAiBA,QAAM,QAAkB,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,EAAE;AAGlD,QAAM,SAAS,CAAC,SAAmD;AACjE,QAAI,CAAC,KAAM,QAAO;AAClB,QAAI,GAAG,kBAAkB,IAAI,KAAK,GAAG,gBAAgB,KAAK,OAAO,EAAG,QAAO,CAAC,KAAK,QAAQ,IAAI;AAC7F,QAAI,CAAC,GAAG,gBAAgB,IAAI,EAAG,QAAO;AACtC,UAAM,OAAiB,CAAC;AACxB,eAAW,UAAU,KAAK,OAAO;AAC/B,UAAI,CAAC,GAAG,kBAAkB,MAAM,KAAK,CAAC,GAAG,gBAAgB,OAAO,OAAO,EAAG,QAAO;AACjF,WAAK,KAAK,OAAO,QAAQ,IAAI;AAAA,IAC/B;AACA,WAAO;AAAA,EACT;AAGA,QAAM,SAAS,CAAC,UAAoB,KAAsB,SAAoC;AAC5F,QAAI,CAAC,KAAM,QAAO;AAClB,UAAM,QAAQ,IAAI,IAAI,IAAI;AAC1B,UAAM,OAAO,CAAC,SAAkB,QAAQ,SAAS,CAAC,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI;AAClF,WAAO,EAAE,OAAO,SAAS,MAAM,OAAO,CAAC,SAAS,KAAK,KAAK,IAAI,CAAC,GAAG,UAAU,SAAS,SAAS,OAAO,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,EAAE;AAAA,EACxI;AAGA,QAAM,QAAQ,CAAC,UAAgC;AAC7C,UAAM,QAAqB,CAAC;AAC5B,UAAM,WAA2B,CAAC;AAClC,UAAM,WAAW,oBAAI,IAAY;AACjC,UAAM,cAAc,oBAAI,IAAY;AACpC,eAAW,QAAQ,OAAO;AACxB,iBAAW,QAAQ,KAAK,MAAO,KAAI,CAAC,SAAS,IAAI,KAAK,IAAI,EAAG,CAAC,SAAS,IAAI,KAAK,IAAI,GAAG,MAAM,KAAK,IAAI;AACtG,iBAAW,WAAW,KAAK,SAAU,KAAI,CAAC,YAAY,IAAI,QAAQ,IAAI,EAAG,CAAC,YAAY,IAAI,QAAQ,IAAI,GAAG,SAAS,KAAK,OAAO;AAAA,IAChI;AACA,WAAO,EAAE,OAAO,SAAS;AAAA,EAC3B;AAOA,QAAM,QAAQ,CAAC,MAA+B,WAAoC;AAChF,QAAI,OAAQ,QAAO,OAAO,KAAK,KAAK;AACpC,QAAI,CAAC,KAAM,QAAO;AAClB,UAAM,UAAU,KAAK,QAAQ,IAAI,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAK;AAC7D,QAAI,YAAY,UAAW,QAAO;AAClC,QAAI,YAAY,SAAU,QAAO;AACjC,QAAI,YAAY,SAAU,QAAO;AACjC,QAAI,yBAAyB,KAAK,OAAO,EAAG,QAAO;AACnD,QAAI,QAAQ,SAAS,IAAI,EAAG,QAAO;AACnC,WAAO,QAAQ,SAAS,KAAK,GAAG,QAAQ,MAAM,GAAG,EAAE,CAAC,WAAM;AAAA,EAC5D;AAGA,QAAM,cAAc,CAAC,YAAiD;AACpE,UAAM,QAAqB,CAAC;AAC5B,UAAM,WAA2B,CAAC;AAClC,eAAW,UAAU,SAAS;AAC5B,YAAM,OAAO,SAAS,MAAM;AAC5B,UAAI,SAAS,QAAQ,CAAC,GAAG,oBAAoB,MAAM,EAAG;AACtD,YAAM,SAAS,aAAa,OAAO,MAAM,OAAO;AAChD,YAAM,OAAO,cAAc,SAAS,QAAQ,MAAM,CAAC;AACnD,YAAM,KAAK,EAAE,MAAM,OAAO,MAAM,OAAO,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,eAAe,MAAM,QAAQ,KAAK,CAAC;AAC3G,UAAI,OAAQ,UAAS,KAAK,EAAE,MAAM,MAAM,OAAO,CAAC;AAAA,IAClD;AACA,WAAO,EAAE,OAAO,SAAS;AAAA,EAC3B;AAEA,QAAM,cAAc,CAAC,MAA+B,SAAgC;AAClF,QAAI,CAAC,QAAQ,KAAK,OAAO,GAAI,QAAO;AAEpC,QAAI,GAAG,kBAAkB,IAAI,EAAG,QAAO,YAAY,KAAK,OAAO;AAC/D,QAAI,GAAG,uBAAuB,IAAI,EAAG,QAAO,MAAM,KAAK,MAAM,IAAI,CAAC,SAAS,YAAY,MAAM,IAAI,CAAC,CAAC;AACnG,QAAI,GAAG,oBAAoB,IAAI,KAAK,GAAG,aAAa,KAAK,QAAQ,GAAG;AAClE,YAAM,QAAQ,KAAK,SAAS;AAC5B,UAAI,UAAU,UAAU,UAAU,QAAQ;AACxC,eAAO,OAAO,YAAY,KAAK,gBAAgB,CAAC,GAAG,IAAI,GAAG,OAAO,OAAO,KAAK,gBAAgB,CAAC,CAAC,CAAC;AAAA,MAClG;AACA,aAAO,YAAY,OAAO,IAAI;AAAA,IAChC;AACA,WAAO;AAAA,EACT;AAGA,QAAM,cAAc,CAAC,MAAsC,SAAgC;AACzF,QAAI,CAAC,GAAG,aAAa,KAAK,UAAU,EAAG,QAAO;AAC9C,UAAM,QAAQ,KAAK,WAAW;AAC9B,QAAI,UAAU,UAAU,UAAU,QAAQ;AACxC,aAAO,OAAO,YAAY,KAAK,gBAAgB,CAAC,GAAG,IAAI,GAAG,OAAO,OAAO,KAAK,gBAAgB,CAAC,CAAC,CAAC;AAAA,IAClG;AACA,WAAO,YAAY,OAAO,IAAI;AAAA,EAChC;AAaA,WAAS,YAAY,MAAc,MAA6B;AAC9D,QAAI,KAAK,IAAI,IAAI,KAAK,KAAK,OAAO,GAAI,QAAO;AAC7C,SAAK,IAAI,IAAI;AACb,UAAM,MAAM,OAAO,IAAI,IAAI;AAC3B,QAAI,KAAK;AACP,YAAM,aAAa,MAAM,IAAI,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,YAAY,MAAM,IAAI,CAAC;AAC/E,aAAO,MAAM,CAAC,YAAY,GAAG,GAAG,GAAG,SAAS,CAAC;AAAA,IAC/C;AAEA,UAAM,QAAQ,QAAQ,IAAI,IAAI;AAC9B,QAAI,MAAO,QAAO,YAAY,OAAO,IAAI;AAEzC,UAAM,OAAO,aAAa,IAAI,IAAI;AAClC,YAAQ,MAAM,WAAW,IAAI,IAAI,QAAQ,KAAK,MAAM,CAAC,GAAG,IAAI,IAAI,WAAc;AAAA,EAChF;AAGA,QAAM,UAAU,CAAC,cAAiD,YAAY,WAAW,oBAAI,IAAI,CAAC;AAElG,SAAO,EAAE,cAAc,SAAS,aAAa,CAAC,SAAiB,YAAY,MAAM,oBAAI,IAAI,CAAC,EAAE;AAC9F;AAGA,SAAS,YAAY,QAA6D;AAChF,QAAM,OAAO,GAAG,iBAAiB,iBAAiB,QAAQ,GAAG,aAAa,QAAQ,IAAI;AACtF,MAAI,QAAuB;AAC3B,QAAM,UAAoB,CAAC;AAC3B,aAAW,aAAa,KAAK,YAAY;AACvC,QAAI,GAAG,oBAAoB,SAAS,GAAG;AACrC,iBAAW,eAAe,UAAU,gBAAgB,cAAc;AAChE,YAAI,CAAC,GAAG,aAAa,YAAY,IAAI,EAAG;AACxC,cAAM,cAAc,YAAY;AAChC,cAAM,SAAS,eAAe,GAAG,sBAAsB,WAAW,IAAI,YAAY,aAAa;AAC/F,YAAI,YAAY,KAAK,SAAS,UAAU,UAAU,GAAG,0BAA0B,MAAM,GAAG;AACtF,qBAAW,YAAY,OAAO,YAAY;AACxC,gBAAI,GAAG,qBAAqB,QAAQ,KAAK,GAAG,aAAa,SAAS,IAAI,KAAK,SAAS,KAAK,SAAS,WAAW,GAAG,gBAAgB,SAAS,WAAW,GAAG;AACrJ,sBAAQ,SAAS,YAAY;AAAA,YAC/B;AAAA,UACF;AAAA,QACF;AACA,cAAM,WAAW,GAAG,aAAa,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,aAAa;AAC/F,YAAI,YAAY,YAAY,KAAK,SAAS,OAAQ,SAAQ,KAAK,YAAY,KAAK,IAAI;AAAA,MACtF;AAAA,IACF;AAAA,EACF;AACA,SAAO,EAAE,OAAO,QAAQ;AAC1B;AAEA,IAAM,YAAY,CAAC,SAAiB,eAAe,KAAK,IAAI;AAG5D,SAAS,OAAO,MAAyB;AACvC,MAAI,YAAY,KAAK,IAAI,EAAG,QAAO;AACnC,SAAO,SAAS,KAAK,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,cAAc;AACjE;AAGA,SAAS,aAAa,MAAgC;AACpD,SAAO,iBAAiB,OAAO,CAAC,UAAU,MAAM,OAAO,SAAS,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,MAAM,IAAI,WAAW,MAAM,UAAU,EAAE;AACtI;AAUO,SAAS,cAAc,EAAE,OAAO,QAAQ,IAAI,GAAG,OAAO,YAAY,IAAkB,CAAC,GAAa;AACvG,QAAM,MAAM,KAAK,MAAM,KAAK;AAC5B,QAAM,WAAW,KAAK,MAAM,aAAa,KAAK,MAAM,cAAc,GAAG,MAAM,CAAC;AAC5E,QAAM,QAAQ,IAAI,IAAI,YAAY,GAAG,CAAC;AACtC,QAAM,WAAW,iBAAiB,aAAa,KAAK,KAAK,UAAU,GAAG,MAAM,CAAC;AAC7E,QAAM,SAAS,SAAS,OAAO,CAAC,UAAU,CAAC,MAAM,MAAM;AAGvD,QAAM,UAAU,oBAAI,IAAoB;AACxC,QAAM,WAAW,CAAC,SAAyB;AACzC,UAAM,OAAO,QAAQ,IAAI,IAAI;AAC7B,QAAI,KAAM,QAAO;AACjB,UAAM,OAAO,CAAC,QAAQ,KAAK,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,SAAS,EAAE,EAAE,KAAK,CAAC,cAAc,MAAM,IAAI,SAAS,CAAC;AAC/G,QAAI,CAAC,KAAM,OAAM,IAAI,MAAM,gCAAgC,IAAI,gCAAgC;AAI/F,UAAM,OAAO,EAAE,GAAG,WAAW,aAAa,KAAK,KAAK,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,aAAa,SAAS,MAAM,EAAE,YAAY,QAAQ,CAAC,GAAG,MAAM,OAAO,IAAI,GAAG;AACvJ,YAAQ,IAAI,MAAM,IAAI;AACtB,WAAO;AAAA,EACT;AAEA,QAAM,WAAqB,CAAC;AAC5B,QAAM,UAA2B,CAAC;AAElC,aAAW,SAAS,QAAQ;AAC1B,UAAM,SAAS,SAAS,MAAM,MAAM;AACpC,UAAM,WAAW,OAAO,aAAa,IAAI,MAAM,IAAI;AACnD,QAAI,CAAC,UAAU;AACb,eAAS,KAAK,GAAG,MAAM,IAAI,wBAAwB,MAAM,MAAM,6BAA6B;AAC5F;AAAA,IACF;AAKA,UAAM,WAAW,MAAM,IAAI,GAAG,MAAM,IAAI,MAAM,IAAI,OAAO,MAAM,IAAI,SAAS;AAC5E,UAAM,WAAW,WAAW,cAAc,YAAY,aAAa,KAAK,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,IAAI;AACrG,UAAM,cAAc,cAAc,SAAS,GAAG;AAC9C,UAAM,UAAU,YAAY;AAC5B,QAAI,CAAC,SAAS;AACZ,eAAS,KAAK,GAAG,MAAM,IAAI,qFAAqF,OAAO,IAAI,EAAE;AAC7H;AAAA,IACF;AAIA,UAAM,cAAc,MAAM,IAAI,GAAG,MAAM,IAAI,cAAc,IAAI,GAAG,MAAM,IAAI,iBAAiB,MAAM,IAAI,GAAG,MAAM,MAAM,cAAc,IAAI,GAAG,MAAM,MAAM,iBAAiB;AACtK,UAAM,UAAU,cAAc,YAAY,aAAa,KAAK,KAAK,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,OAAO,MAAM,SAAS,CAAC,EAAE;AACrH,UAAM,QAAQ,QAAQ;AACtB,UAAM,QAAQ,QAAQ,QAAQ,SAAS,MAAM,IAAI,IAAI,MAAM,OAAO,QAAQ,QAAQ,CAAC;AAEnF,UAAM,QAAQ,OAAO,QAAQ,SAAS,SAAS;AAE/C,YAAQ,KAAK;AAAA,MACX,MAAM,MAAM;AAAA,MACZ;AAAA,MACA,MAAM,OAAO,MAAM,IAAI;AAAA,MACvB,YAAY;AAAA,MACZ,YAAY,OAAO;AAAA,MACnB;AAAA,MACA,aAAa,WAAW,SAAS;AAAA,MACjC,OAAO,MAAM;AAAA,MACb,UAAU,MAAM;AAAA,MAChB,gBAAgB,aAAa,MAAM,IAAI;AAAA,MACvC,QAAQ,SAAS,aAAa,eAAe;AAAA,MAC7C,gBAAgB;AAAA,MAChB,QAAQ,QAAQ,GAAG,SAAS,KAAK,CAAC,WAAW;AAAA,MAC7C,SAAS,SAAS,QAAQ,KAAK,OAAO,KAAK,IAAI;AAAA,MAC/C,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAEA,MAAI,SAAS,OAAQ,OAAM,IAAI,MAAM;AAAA,IAAoC,SAAS,KAAK,MAAM,CAAC,EAAE;AAEhG,UAAQ,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAEnD,SAAO;AAAA,IACL,eAAe;AAAA,IACf,WAAW;AAAA,MACT;AAAA,MACA,SAAS,SAAS;AAAA,MAClB,gBAAgB,SAAS;AAAA,MACzB,SAAS,OAAO;AAAA,MAChB,aAAa,SAAS,SAAS,OAAO;AAAA,IACxC;AAAA,IACA,WAAW;AAAA,MACT,UAAU;AAAA,MACV,WAAW;AAAA,MACX,QAAQ;AAAA,IACV;AAAA,IACA;AAAA;AAAA;AAAA;AAAA,IAIA,UAAU,CAAC;AAAA,EACb;AACF;AAGO,SAAS,kBAAkB,UAA4B;AAC5D,SAAO,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAAA;AAC7C;",
+  "names": ["line"]
+}

package/dist/registry/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/registry/cli.ts"],"names":[],"mappings":""}

package/dist/registry/cli.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import {
+  findInRegistry,
+  formatFindings
+} from "./chunk-IJNCYVH4.js";
+import {
+  validateRegistry
+} from "./chunk-MRSBS5OP.js";
+
+// src/registry/cli.ts
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+var builder = () => import("./build-GOVLABI6.js");
+var [command, ...rest] = process.argv.slice(2);
+var flag = (name) => rest.includes(`--${name}`);
+var value = (name) => {
+  const at = rest.indexOf(`--${name}`);
+  return at === -1 ? void 0 : rest[at + 1];
+};
+var plain = () => {
+  const out = [];
+  for (let i = 0; i < rest.length; i++) {
+    if (rest[i].startsWith("--")) {
+      if (rest[i] === "--limit" || rest[i] === "--out" || rest[i] === "--file") i += 1;
+      continue;
+    }
+    out.push(rest[i]);
+  }
+  return out;
+};
+function registryPath() {
+  const named = value("file");
+  if (named) return resolve(named);
+  const here = resolve(process.cwd(), "registry.json");
+  if (existsSync(here)) return here;
+  return fileURLToPath(new URL("../../registry.json", import.meta.url));
+}
+function readRegistry() {
+  const path = registryPath();
+  if (!existsSync(path)) throw new Error(`no registry.json at ${path} \u2014 run "estiva-ui build" in the library first`);
+  const registry = JSON.parse(readFileSync(path, "utf8"));
+  const problems = validateRegistry(registry);
+  if (problems.length) throw new Error(`${path} does not match the schema:
+  ${problems.join("\n  ")}`);
+  return registry;
+}
+async function main() {
+  switch (command) {
+    case "find": {
+      const query = plain().join(" ");
+      if (!query.trim()) {
+        process.stderr.write("estiva-ui find <words\u2026> \u2014 what the thing you need does, in words\n");
+        return 1;
+      }
+      const registry = readRegistry();
+      const limit = Number(value("limit") ?? 5);
+      const findings = findInRegistry(registry, query, { limit: Number.isFinite(limit) && limit > 0 ? limit : 5 });
+      if (flag("json")) {
+        process.stdout.write(`${JSON.stringify(findings.map((finding) => finding.entry), null, 2)}
+`);
+        return 0;
+      }
+      process.stdout.write(`${formatFindings(registry, findings, query)}
+`);
+      return 0;
+    }
+    case "build": {
+      const { buildRegistry, serializeRegistry } = await builder();
+      const out = resolve(value("out") ?? "registry.json");
+      const registry = buildRegistry();
+      const problems = validateRegistry(registry);
+      if (problems.length) {
+        process.stderr.write(`the registry this build produced does not match its own schema:
+  ${problems.join("\n  ")}
+`);
+        return 1;
+      }
+      writeFileSync(out, serializeRegistry(registry), "utf8");
+      process.stdout.write(`${out}: ${registry.entries.length} entries from ${registry.builtFrom.exports} exports
+`);
+      return 0;
+    }
+    case "check": {
+      const { buildRegistry, serializeRegistry } = await builder();
+      const path = registryPath();
+      const built = buildRegistry();
+      const problems = validateRegistry(built);
+      if (problems.length) {
+        process.stderr.write(`the registry does not match its own schema:
+  ${problems.join("\n  ")}
+`);
+        return 1;
+      }
+      if (!existsSync(path)) {
+        process.stderr.write(`${path} is missing \u2014 run "npm run registry"
+`);
+        return 1;
+      }
+      if (readFileSync(path, "utf8").replace(/\r\n/g, "\n") !== serializeRegistry(built)) {
+        process.stderr.write(`${path} is not what the code produces \u2014 run "npm run registry" and commit the result
+`);
+        return 1;
+      }
+      process.stdout.write(`${path}: current, ${built.entries.length} entries from ${built.builtFrom.exports} exports
+`);
+      return 0;
+    }
+    default:
+      process.stderr.write("estiva-ui <find | build | check>\n");
+      return 1;
+  }
+}
+try {
+  process.exitCode = await main();
+} catch (error) {
+  process.stderr.write(`${error instanceof Error ? error.message : String(error)}
+`);
+  process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/registry/cli.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/registry/cli.ts"],
+  "sourcesContent": ["/// <reference types=\"node\" />\n/**\n * `estiva-ui` \u2014 the catalogue as a command (UIG-12; docs/GATES.md \u00A723 for why\n * it ships in the package rather than as a script pasted into each repo).\n *\n *   estiva-ui find <words\u2026> [--json] [--limit n]   what do we have for this?\n *   estiva-ui build [--out <path>]                 write registry.json\n *   estiva-ui check                                rebuild and compare; CI runs this\n *\n * `find` reads the committed `registry.json`: the one in the folder it is run\n * from, else the one shipped inside the installed package. So an app can ask\n * the question without a checkout of this repo. `build` and `check` read the\n * source, so they only mean anything inside the library they describe.\n */\nimport { existsSync, readFileSync, writeFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { findInRegistry, formatFindings } from './find'\nimport { validateRegistry, type Registry } from './schema'\n\n/**\n * The builder, loaded only when it is used.\n *\n * It reads TypeScript with TypeScript, and `typescript` is a dev dependency of\n * the app that installs this package \u2014 a real one in Peek, Ship and this repo,\n * and possibly absent elsewhere. `find` needs none of it: it reads a JSON file.\n * A static import made the bundler put the whole builder in the same chunk as\n * `find`, so `npx estiva-ui find \u2026` died with ERR_MODULE_NOT_FOUND before\n * opening the file it needed.\n */\nconst builder = () => import('./build')\n\nconst [command, ...rest] = process.argv.slice(2)\nconst flag = (name: string) => rest.includes(`--${name}`)\nconst value = (name: string) => {\n  const at = rest.indexOf(`--${name}`)\n  return at === -1 ? undefined : rest[at + 1]\n}\n/** Everything that is not a flag or a flag's value: the words of the question. */\nconst plain = () => {\n  const out: string[] = []\n  for (let i = 0; i < rest.length; i++) {\n    if (rest[i].startsWith('--')) {\n      if (rest[i] === '--limit' || rest[i] === '--out' || rest[i] === '--file') i += 1\n      continue\n    }\n    out.push(rest[i])\n  }\n  return out\n}\n\n/** The committed file: where it is run, else the copy inside the installed package. */\nfunction registryPath(): string {\n  const named = value('file')\n  if (named) return resolve(named)\n  const here = resolve(process.cwd(), 'registry.json')\n  if (existsSync(here)) return here\n  // dist/registry/cli.js \u2192 the package's own root.\n  return fileURLToPath(new URL('../../registry.json', import.meta.url))\n}\n\nfunction readRegistry(): Registry {\n  const path = registryPath()\n  if (!existsSync(path)) throw new Error(`no registry.json at ${path} \u2014 run \"estiva-ui build\" in the library first`)\n  const registry = JSON.parse(readFileSync(path, 'utf8')) as Registry\n  const problems = validateRegistry(registry)\n  // A malformed catalogue is worse than none: it would answer, wrongly.\n  if (problems.length) throw new Error(`${path} does not match the schema:\\n  ${problems.join('\\n  ')}`)\n  return registry\n}\n\nasync function main(): Promise<number> {\n  switch (command) {\n    case 'find': {\n      const query = plain().join(' ')\n      if (!query.trim()) {\n        process.stderr.write('estiva-ui find <words\u2026> \u2014 what the thing you need does, in words\\n')\n        return 1\n      }\n      const registry = readRegistry()\n      const limit = Number(value('limit') ?? 5)\n      const findings = findInRegistry(registry, query, { limit: Number.isFinite(limit) && limit > 0 ? limit : 5 })\n      if (flag('json')) {\n        process.stdout.write(`${JSON.stringify(findings.map((finding) => finding.entry), null, 2)}\\n`)\n        return 0\n      }\n      process.stdout.write(`${formatFindings(registry, findings, query)}\\n`)\n      // Nothing found is not a failure \u2014 it is the answer that sends a session\n      // to ask rather than to invent.\n      return 0\n    }\n\n    case 'build': {\n      const { buildRegistry, serializeRegistry } = await builder()\n      const out = resolve(value('out') ?? 'registry.json')\n      const registry = buildRegistry()\n      const problems = validateRegistry(registry)\n      if (problems.length) {\n        process.stderr.write(`the registry this build produced does not match its own schema:\\n  ${problems.join('\\n  ')}\\n`)\n        return 1\n      }\n      writeFileSync(out, serializeRegistry(registry), 'utf8')\n      process.stdout.write(`${out}: ${registry.entries.length} entries from ${registry.builtFrom.exports} exports\\n`)\n      return 0\n    }\n\n    case 'check': {\n      const { buildRegistry, serializeRegistry } = await builder()\n      const path = registryPath()\n      const built = buildRegistry()\n      const problems = validateRegistry(built)\n      if (problems.length) {\n        process.stderr.write(`the registry does not match its own schema:\\n  ${problems.join('\\n  ')}\\n`)\n        return 1\n      }\n      if (!existsSync(path)) {\n        process.stderr.write(`${path} is missing \u2014 run \"npm run registry\"\\n`)\n        return 1\n      }\n      // Byte for byte. The point of the check is that the committed file cannot\n      // drift from the code; \"near enough\" is drift.\n      if (readFileSync(path, 'utf8').replace(/\\r\\n/g, '\\n') !== serializeRegistry(built)) {\n        process.stderr.write(`${path} is not what the code produces \u2014 run \"npm run registry\" and commit the result\\n`)\n        return 1\n      }\n      process.stdout.write(`${path}: current, ${built.entries.length} entries from ${built.builtFrom.exports} exports\\n`)\n      return 0\n    }\n\n    default:\n      process.stderr.write('estiva-ui <find | build | check>\\n')\n      return 1\n  }\n}\n\ntry {\n  process.exitCode = await main()\n} catch (error) {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n  process.exitCode = 1\n}\n"],
+  "mappings": ";;;;;;;;;;AAcA,SAAS,YAAY,cAAc,qBAAqB;AACxD,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAc9B,IAAM,UAAU,MAAM,OAAO,qBAAS;AAEtC,IAAM,CAAC,SAAS,GAAG,IAAI,IAAI,QAAQ,KAAK,MAAM,CAAC;AAC/C,IAAM,OAAO,CAAC,SAAiB,KAAK,SAAS,KAAK,IAAI,EAAE;AACxD,IAAM,QAAQ,CAAC,SAAiB;AAC9B,QAAM,KAAK,KAAK,QAAQ,KAAK,IAAI,EAAE;AACnC,SAAO,OAAO,KAAK,SAAY,KAAK,KAAK,CAAC;AAC5C;AAEA,IAAM,QAAQ,MAAM;AAClB,QAAM,MAAgB,CAAC;AACvB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,QAAI,KAAK,CAAC,EAAE,WAAW,IAAI,GAAG;AAC5B,UAAI,KAAK,CAAC,MAAM,aAAa,KAAK,CAAC,MAAM,WAAW,KAAK,CAAC,MAAM,SAAU,MAAK;AAC/E;AAAA,IACF;AACA,QAAI,KAAK,KAAK,CAAC,CAAC;AAAA,EAClB;AACA,SAAO;AACT;AAGA,SAAS,eAAuB;AAC9B,QAAM,QAAQ,MAAM,MAAM;AAC1B,MAAI,MAAO,QAAO,QAAQ,KAAK;AAC/B,QAAM,OAAO,QAAQ,QAAQ,IAAI,GAAG,eAAe;AACnD,MAAI,WAAW,IAAI,EAAG,QAAO;AAE7B,SAAO,cAAc,IAAI,IAAI,uBAAuB,YAAY,GAAG,CAAC;AACtE;AAEA,SAAS,eAAyB;AAChC,QAAM,OAAO,aAAa;AAC1B,MAAI,CAAC,WAAW,IAAI,EAAG,OAAM,IAAI,MAAM,uBAAuB,IAAI,oDAA+C;AACjH,QAAM,WAAW,KAAK,MAAM,aAAa,MAAM,MAAM,CAAC;AACtD,QAAM,WAAW,iBAAiB,QAAQ;AAE1C,MAAI,SAAS,OAAQ,OAAM,IAAI,MAAM,GAAG,IAAI;AAAA,IAAkC,SAAS,KAAK,MAAM,CAAC,EAAE;AACrG,SAAO;AACT;AAEA,eAAe,OAAwB;AACrC,UAAQ,SAAS;AAAA,IACf,KAAK,QAAQ;AACX,YAAM,QAAQ,MAAM,EAAE,KAAK,GAAG;AAC9B,UAAI,CAAC,MAAM,KAAK,GAAG;AACjB,gBAAQ,OAAO,MAAM,8EAAoE;AACzF,eAAO;AAAA,MACT;AACA,YAAM,WAAW,aAAa;AAC9B,YAAM,QAAQ,OAAO,MAAM,OAAO,KAAK,CAAC;AACxC,YAAM,WAAW,eAAe,UAAU,OAAO,EAAE,OAAO,OAAO,SAAS,KAAK,KAAK,QAAQ,IAAI,QAAQ,EAAE,CAAC;AAC3G,UAAI,KAAK,MAAM,GAAG;AAChB,gBAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,SAAS,IAAI,CAAC,YAAY,QAAQ,KAAK,GAAG,MAAM,CAAC,CAAC;AAAA,CAAI;AAC7F,eAAO;AAAA,MACT;AACA,cAAQ,OAAO,MAAM,GAAG,eAAe,UAAU,UAAU,KAAK,CAAC;AAAA,CAAI;AAGrE,aAAO;AAAA,IACT;AAAA,IAEA,KAAK,SAAS;AACZ,YAAM,EAAE,eAAe,kBAAkB,IAAI,MAAM,QAAQ;AAC3D,YAAM,MAAM,QAAQ,MAAM,KAAK,KAAK,eAAe;AACnD,YAAM,WAAW,cAAc;AAC/B,YAAM,WAAW,iBAAiB,QAAQ;AAC1C,UAAI,SAAS,QAAQ;AACnB,gBAAQ,OAAO,MAAM;AAAA,IAAsE,SAAS,KAAK,MAAM,CAAC;AAAA,CAAI;AACpH,eAAO;AAAA,MACT;AACA,oBAAc,KAAK,kBAAkB,QAAQ,GAAG,MAAM;AACtD,cAAQ,OAAO,MAAM,GAAG,GAAG,KAAK,SAAS,QAAQ,MAAM,iBAAiB,SAAS,UAAU,OAAO;AAAA,CAAY;AAC9G,aAAO;AAAA,IACT;AAAA,IAEA,KAAK,SAAS;AACZ,YAAM,EAAE,eAAe,kBAAkB,IAAI,MAAM,QAAQ;AAC3D,YAAM,OAAO,aAAa;AAC1B,YAAM,QAAQ,cAAc;AAC5B,YAAM,WAAW,iBAAiB,KAAK;AACvC,UAAI,SAAS,QAAQ;AACnB,gBAAQ,OAAO,MAAM;AAAA,IAAkD,SAAS,KAAK,MAAM,CAAC;AAAA,CAAI;AAChG,eAAO;AAAA,MACT;AACA,UAAI,CAAC,WAAW,IAAI,GAAG;AACrB,gBAAQ,OAAO,MAAM,GAAG,IAAI;AAAA,CAAwC;AACpE,eAAO;AAAA,MACT;AAGA,UAAI,aAAa,MAAM,MAAM,EAAE,QAAQ,SAAS,IAAI,MAAM,kBAAkB,KAAK,GAAG;AAClF,gBAAQ,OAAO,MAAM,GAAG,IAAI;AAAA,CAAiF;AAC7G,eAAO;AAAA,MACT;AACA,cAAQ,OAAO,MAAM,GAAG,IAAI,cAAc,MAAM,QAAQ,MAAM,iBAAiB,MAAM,UAAU,OAAO;AAAA,CAAY;AAClH,aAAO;AAAA,IACT;AAAA,IAEA;AACE,cAAQ,OAAO,MAAM,oCAAoC;AACzD,aAAO;AAAA,EACX;AACF;AAEA,IAAI;AACF,UAAQ,WAAW,MAAM,KAAK;AAChC,SAAS,OAAO;AACd,UAAQ,OAAO,MAAM,GAAG,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,CAAI;AAClF,UAAQ,WAAW;AACrB;",
+  "names": []
+}

package/dist/registry/find.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The catalogue's reader (UIG-12): `ui:find <words>`.
+ *
+ * It exists to prove the format. A schema nobody consumes is a schema nobody
+ * has tested, and the questions it has to answer are regression tests, not the
+ * scope: "floating panel" must find `Popover`, "scrolling" `ScrollArea`,
+ * "empty" `EmptyState`.
+ *
+ * It is also the answer to "what do we have for this?", which is the question
+ * the wall cannot answer: a lint rule refuses the wrong thing, and this is
+ * where the right one is named (UIG-20 makes a session ask it first).
+ */
+import type { Registry, RegistryEntry } from './schema';
+export interface Finding {
+    entry: RegistryEntry;
+    /** How many of the query's words matched anywhere. Ranked on this first. */
+    matched: number;
+    score: number;
+    /** Which fields matched, for the reader to say why. */
+    where: string[];
+    /**
+     * The props the query named **by name**, so the answer shows those rather
+     * than all of them. A prop whose note merely carries one of the words counts
+     * towards the score and is not shown: on "floating panel", six of `Popover`'s
+     * notes say "panel", and printing all six buries the answer.
+     */
+    props: string[];
+}
+/**
+ * Search name, purpose, behaviours and variants.
+ *
+ * A row that answers more of the question comes first, whatever it scored:
+ * "floating panel" has to reach `Popover`, whose purpose carries both words,
+ * over `MenuPanel`, whose name carries one of them loudly.
+ */
+export declare function findInRegistry(registry: Registry, query: string, { limit }?: {
+    limit?: number;
+}): Finding[];
+/** `http://localhost:6008/?path=/docs/overlays-popover--docs`, or `null` where the entry has no page. */
+export declare function docsLink(registry: Registry, entry: RegistryEntry): string | null;
+/** What the command prints: the import line first, because that is what the reader came for. */
+export declare function formatFindings(registry: Registry, findings: Finding[], query: string): string;
+//# sourceMappingURL=find.d.ts.map