@estiva-app/ui 0.33.0 → 0.34.0

package/src/eslint/no-copied-look.ts

@@ -0,0 +1,203 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs'
+import { dirname, join, relative, resolve } from 'node:path'
+import type { Rule } from 'eslint'
+import type ts from 'typescript'
+import { ESCAPE_MESSAGES, isEscaped } from './escape'
+import { classUnits, componentsOf, copies, looksOf, parseForLooks, sharedLooksOf, type ClassUnit } from './looks-of'
+
+/**
+ * UIG-25: a component's look typed again by hand. **A warning, never an error**
+ * (Katerina, 13 September): a copy is found by how alike two lists are, and
+ * likeness is a judgement — a warning gets read, a guess that blocks gets
+ * switched off.
+ *
+ * Every class list in the file (see `looks-of.ts` for where one is read) is
+ * compared, by its look words alone, against the looks of every catalogued
+ * part in another file. A list is a copy when it shares `MIN_SHARED` look words
+ * with one of a part's looks, covering `MIN_COVER` of the shorter of the two.
+ *
+ * - **In an app**, the parts are the package's — read from the catalogue the
+ *   installed package ships (`@estiva-app/ui/registry.json`, its `looks`) — and
+ *   the app's own exported components, read from its `src`. So a part added to
+ *   either is covered the day it is added, with no list kept here. The fix:
+ *   use the part.
+ * - **In the package**, the parts are its own. The fix: write the look once in
+ *   `src/looks.ts` and use it in both.
+ *
+ * Left alone: a part's look in its own file, and a component named like the
+ * part it wraps (Peek's `Avatar` over the package's). A constant imported from
+ * another file is a look written once, not a copy. Peek and Ship copying each
+ * other is not seen here — each app knows only itself and the package — and
+ * is counted by `gates:status`.
+ */
+
+interface Look {
+  part: string
+  file: string
+  look: string[]
+  /** The installed package's part, this repo's own part, or a shared look (`…_CLASSES`) this repo writes once. */
+  from: 'package' | 'own' | 'shared'
+}
+
+const packageDirCache = new Map<string, string | null>()
+function packageDirOf(file: string): string | null {
+  const start = dirname(resolve(file))
+  if (packageDirCache.has(start)) return packageDirCache.get(start) ?? null
+  let dir = start
+  for (;;) {
+    if (existsSync(join(dir, 'package.json'))) break
+    const up = dirname(dir)
+    if (up === dir) {
+      dir = ''
+      break
+    }
+    dir = up
+  }
+  packageDirCache.set(start, dir || null)
+  return dir || null
+}
+
+const PACKAGE = '@estiva-app/ui'
+const nameOf = (dir: string) => {
+  try {
+    return (JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8')) as { name?: string }).name
+  } catch {
+    return undefined
+  }
+}
+
+/** The installed package's parts and their looks, from the catalogue it ships. */
+const shippedCache = new Map<string, { mtime: number; looks: Look[] }>()
+function shippedLooks(appDir: string): Look[] {
+  for (let dir = appDir; ; dir = dirname(dir)) {
+    const file = join(dir, 'node_modules', PACKAGE, 'registry.json')
+    if (existsSync(file)) {
+      const mtime = statSync(file).mtimeMs
+      const cached = shippedCache.get(file)
+      if (cached && cached.mtime === mtime) return cached.looks
+      let looks: Look[] = []
+      try {
+        const registry = JSON.parse(readFileSync(file, 'utf8')) as { entries: { name: string; sourceFile: string; looks?: string[] }[] }
+        looks = registry.entries.flatMap((e) => (e.looks ?? []).map((l) => ({ part: e.name, file: e.sourceFile, look: l.split(' '), from: 'package' as const })))
+      } catch {
+        // A catalogue that does not parse is its own check's business.
+      }
+      shippedCache.set(file, { mtime, looks })
+      return looks
+    }
+    if (dirname(dir) === dir) return []
+  }
+}
+
+/** The names a file exports. */
+function exportedNames(source: ts.SourceFile): Set<string> {
+  const names = new Set<string>()
+  const text = source.text
+  for (const m of text.matchAll(/export\s+(?:default\s+)?(?:function|const)\s+([A-Z]\w*)/g)) names.add(m[1])
+  for (const m of text.matchAll(/export\s*\{([^}]*)\}/g)) for (const part of m[1].split(',')) {
+    const name = part.trim().split(/\s+as\s+/).pop()
+    if (name && /^[A-Z]/.test(name)) names.add(name)
+  }
+  return names
+}
+
+/** A repo's own exported components and their looks, from its `src`. */
+const ownCache = new Map<string, { mtime: number; looks: Look[] }>()
+function ownLooks(repoDir: string): Look[] {
+  const out: Look[] = []
+  const walk = (dir: string) => {
+    let names: string[] = []
+    try {
+      names = readdirSync(dir)
+    } catch {
+      return
+    }
+    for (const name of names) {
+      if (name === 'node_modules' || name === 'dist') continue
+      const path = join(dir, name)
+      if (statSync(path).isDirectory()) walk(path)
+      else if (/\.tsx?$/.test(name) && !/\.(?:stories|test)\.tsx?$/.test(name) && !name.endsWith('.d.ts')) {
+        const mtime = statSync(path).mtimeMs
+        let cached = ownCache.get(path)
+        if (!cached || cached.mtime !== mtime) {
+          const text = readFileSync(path, 'utf8')
+          const source = parseForLooks(path, text)
+          const exported = name.endsWith('.tsx') ? [...componentsOf(source).keys()].filter((n) => exportedNames(source).has(n)) : []
+          const file = relative(repoDir, path).replace(/\\/g, '/')
+          const looks: Look[] = [...looksOf(source, exported)].flatMap(([part, lists]) => lists.map((l) => ({ part, file, look: l.split(' '), from: 'own' as const })))
+          // A shared look written once (`…_CLASSES`): a copy of it is told to use it.
+          if (text.includes('_CLASSES')) for (const [part, lists] of sharedLooksOf(source)) for (const l of lists) looks.push({ part, file, look: l.split(' '), from: 'shared' })
+          cached = { mtime, looks }
+          ownCache.set(path, cached)
+        }
+        out.push(...cached.looks)
+      }
+    }
+  }
+  walk(join(repoDir, 'src'))
+  return out
+}
+
+export const noCopiedLook: Rule.RuleModule = {
+  meta: {
+    type: 'suggestion',
+    docs: { description: "A part's look typed again by hand, where the part (or a shared look) should be used" },
+    schema: [],
+    messages: {
+      usePart:
+        "This class list is `{{part}}`'s look, typed again ({{count}} words: {{words}}). Use `{{part}}` from {{from}}: a copy looks right today and stays behind the day `{{part}}` changes.",
+      shareIt:
+        'This look is also written in `{{part}}` ({{file}}): {{words}}. Write it once in src/looks.ts and use it in both, so the two cannot drift apart.',
+      useShared:
+        'This class list is `{{part}}` ({{file}}), typed again: {{words}}. Use `{{part}}`: a look written once cannot drift apart.',
+      ...ESCAPE_MESSAGES,
+    },
+  },
+  create(context) {
+    const file = context.filename
+    const repoDir = packageDirOf(file)
+    if (!repoDir) return {}
+    const inPackage = nameOf(repoDir) === PACKAGE
+    return {
+      Program() {
+        const here = relative(repoDir, file).replace(/\\/g, '/')
+        const source = parseForLooks(file, context.sourceCode.text)
+        const declared = new Set(componentsOf(source).keys())
+        const looks = [...(inPackage ? [] : shippedLooks(repoDir)), ...ownLooks(repoDir)].filter((l) => l.file !== here && !declared.has(l.part))
+        if (!looks.length) return
+        const units = classUnits(source)
+        // A string inside a className is read with it; report the className once.
+        const within = (u: ClassUnit) => units.some((o) => o !== u && o.via === 'attribute' && u.via === 'literal' && u.start >= o.start && u.end <= o.end)
+        const reported = new Set<number>()
+        for (const unit of units) {
+          if (within(unit) || reported.has(unit.start)) continue
+          let best: { look: Look; shared: string[] } | null = null
+          for (const look of looks) {
+            // A shared look is compared with the package's parts only: the parts here that use it are not its copies.
+            if (unit.shared && look.from !== 'package') continue
+            const shared = copies(unit.look, look.look)
+            // On a tie, the shared look: using it is the whole fix.
+            if (shared && (!best || shared.length > best.shared.length || (shared.length === best.shared.length && look.from === 'shared'))) best = { look, shared }
+          }
+          if (!best) continue
+          // A className built from a constant of this file is reported once, at the constant.
+          const found = best
+          if (unit.via === 'attribute' && units.some((o) => o.via === 'literal' && !within(o) && found.shared.every((w) => o.look.includes(w)) && looks.some((l) => copies(o.look, l.look)))) continue
+          const loc = { start: context.sourceCode.getLocFromIndex(unit.start), end: context.sourceCode.getLocFromIndex(unit.end) }
+          const at = { start: context.sourceCode.getLocFromIndex(unit.anchor), end: loc.end }
+          if (isEscaped(context, { loc: at, range: [unit.anchor, unit.end] })) continue
+          reported.add(unit.start)
+          const words = best.shared.map((w) => `\`${w}\``).join(' ')
+          if (best.look.from === 'shared') context.report({ loc, messageId: 'useShared', data: { part: best.look.part, file: best.look.file, words } })
+          else if (inPackage) context.report({ loc, messageId: 'shareIt', data: { part: best.look.part, file: best.look.file, words } })
+          else
+            context.report({
+              loc,
+              messageId: 'usePart',
+              data: { part: best.look.part, count: String(best.shared.length), words, from: best.look.from === 'package' ? PACKAGE : `\`${best.look.file}\`` },
+            })
+        }
+      },
+    }
+  },
+}

package/src/eslint/no-restyled-part.ts

@@ -119,7 +119,7 @@ export const PART_LOOK_PROPS: Record<string, string[]> = {
   Reaction: ['pressed'],
   ReactionPicker: ['surface'],
   SectionHeader: ['hover'],
-  SectionLabel: ['tone'],
+  SectionLabel: ['tone', 'truncate'],
   Select: ['size'],
   Tabs: ['size'],
   TextInput: ['size'],

package/src/gates/app-checks.ts

@@ -230,7 +230,7 @@ export function appChecks(h: GateHelpers, { app = '.', page, chain = { ref: 'UIG
       { what: 'a title= is an error naming WithTooltip', run: probe(`import { Button } from '@estiva-app/ui'\n${component('<Button title="Delete">x</Button>')}`, 'error', 'WithTooltip') },
     ]),
     ticket('UIG-25', [
-      { what: "SectionLabel's class list, typed by hand, is a warning", run: probe(component('<span className="text-[10px] uppercase tracking-wide text-text-muted">Label</span>'), 'warning', 'SectionLabel') },
+      { what: "SectionLabel's class list, typed by hand, is a warning", run: probe(component('<span className="text-h5 leading-3 signal:font-mono signal:text-small signal:uppercase signal:tracking-widest text-text-secondary">Label</span>'), 'warning', 'SectionLabel') },
     ]),
     ticket('UIG-27', [
       { what: 'the installed package has Link', run: () => h.contains(installed, /\bLink\b/, 'the installed @estiva-app/ui exports Link') },

package/src/gates/create-app.test.ts

@@ -59,7 +59,7 @@ describe('create-estiva-app', () => {
 
   it('starts the count at zero and keeps the CI job named gate', () => {
     const count = JSON.parse(files['.gates-count.json'])
-    expect(Object.values(count.rules)).toEqual([{ errors: 0, warnings: 0, escapes: 0 }, { errors: 0, warnings: 0, escapes: 0 }, { errors: 0, warnings: 0, escapes: 0 }, { errors: 0, warnings: 0, escapes: 0 }, { errors: 0, warnings: 0, escapes: 0 }, { errors: 0, warnings: 0, escapes: 0 }])
+    expect(Object.values(count.rules)).toEqual([{ errors: 0, warnings: 0, escapes: 0 }, { errors: 0, warnings: 0, escapes: 0 }, { errors: 0, warnings: 0, escapes: 0 }, { errors: 0, warnings: 0, escapes: 0 }, { errors: 0, warnings: 0, escapes: 0 }, { errors: 0, warnings: 0, escapes: 0 }, { errors: 0, warnings: 0, escapes: 0 }])
     expect(files['.github/workflows/deploy.yml']).toMatch(/\n {2}gate:\n[\s\S]*npm run lint:rules/)
     expect(files['docs/GATES-DEBT.md']).toContain('Nothing.')
   })

package/src/gates/gates.test.ts

@@ -153,7 +153,7 @@ describe('writeGateCount', () => {
     const written = JSON.parse(readFileSync(join(dir, '.gates-count.json'), 'utf8'))
     expect(written).toMatchObject({ schemaVersion: 1, repo: 'probe' })
     expect(written.rules['estiva/no-raw-element']).toEqual({ errors: 0, warnings: 0, escapes: 1 })
-    expect(Object.keys(written.rules)).toEqual(['estiva/no-raw-element', 'estiva/no-rebuilt-behaviour', 'estiva/no-restyled-part', 'estiva/no-handmade-header', 'estiva/no-handmade-empty-state', 'estiva/no-native-title'])
+    expect(Object.keys(written.rules)).toEqual(['estiva/no-raw-element', 'estiva/no-rebuilt-behaviour', 'estiva/no-restyled-part', 'estiva/no-handmade-header', 'estiva/no-handmade-empty-state', 'estiva/no-native-title', 'estiva/no-copied-look'])
 
     expect((await writeGateCount({ root: dir, repo: 'probe' })).changed).toBe(false)
 

package/src/looks.ts

@@ -0,0 +1,42 @@
+/**
+ * Looks two or more parts share, written once (UIG-25).
+ *
+ * A look typed again by hand draws the same today and drifts the day one of
+ * them changes: nothing fails, one screen just looks slightly off. So a look
+ * more than one part wears lives here, and each part takes it from here. The
+ * lint that finds a copied look reads a class list wherever it is written; a
+ * constant of classes ends in `_CLASSES`, so it is read as one.
+ *
+ * Only looks — colour, text, border, corner, shadow. Where a part sits and how
+ * much room it takes stay in the part.
+ */
+
+/** A field's box: TextInput and Textarea. The hairline strengthens on hover; focus comes after it, so a focused field keeps its colour under the pointer. */
+export const FIELD_BOX_CLASSES = 'bg-bg-inset border border-border-default hover:border-border-strong focus:border-border-focus rounded-lg'
+
+/** What a field's words look like, typed or waiting: TextInput, Textarea and Select. */
+export const FIELD_TEXT_CLASSES = 'text-text-primary placeholder:text-text-muted'
+
+/** A field that cannot be used: TextInput, Textarea and Select. */
+export const FIELD_DISABLED_CLASSES = 'disabled:pointer-events-none disabled:bg-bg-disabled disabled:text-text-disabled'
+
+/** The ring a focused field wears in Signal: TextInput and Textarea. */
+export const FIELD_FOCUS_RING_CLASSES = 'signal:transition-shadow signal:focus:shadow-focus-ring'
+
+/** A field's two sizes, its padding and its words: TextInput, Textarea (default only) and Select. The small one is the small Select's trigger. */
+export const FIELD_SIZE_CLASSES = {
+  default: 'px-3 py-2 text-input-value',
+  small: 'h-6 min-h-6 px-2 text-caption',
+} as const
+
+/** The box around an input that sits inside it, before its focus look: SearchInput and ChipInput. */
+export const FIELD_SHELL_CLASSES = 'bg-bg-inset border border-border-default hover:border-border-strong rounded-lg transition-colors'
+
+/** A panel that floats over the page: Menu's panel and Tooltip. */
+export const FLOATING_SURFACE_CLASSES = 'rounded-lg border border-border-default bg-bg-elevated shadow-lg'
+
+/** A chip's words: Chip's label and Reaction's count. */
+export const CHIP_TEXT_CLASSES = 'text-chip signal:font-mono signal:text-small signal:font-semibold signal:tabular-nums'
+
+/** Words typed straight into an input with no box of its own: SearchInput and ChipInput. */
+export const BARE_INPUT_CLASSES = 'bg-transparent text-text-primary placeholder:text-text-muted outline-none'

package/src/registry/app.ts

@@ -37,6 +37,7 @@ import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs'
 import { basename, dirname, extname, join, relative, resolve, sep } from 'node:path'
 import ts from 'typescript'
 import { firstSentence, pageOpening, readModule, sanitize, toId, PACKAGE_IMPORT, type Resolved } from './build'
+import { looksOf, parseForLooks } from '../eslint/looks-of'
 import { SCHEMA_VERSION, type AppFacts, type EntryClass, type FileWithoutPart, type Registry, type RegistryEntry } from './schema'
 
 export interface AppBuildOptions {
@@ -820,6 +821,8 @@ export function buildAppRegistry({ root = process.cwd(), repo, packageRegistry,
       storyId,
       docPage: pageText ? page : null,
       app: facts_,
+      // A part handed on from the package looks like the package's (UIG-25).
+      looks: pass ? [] : (looksOf(parseForLooks(join(root, p.file), facts.get(p.file)!.source), [p.name]).get(p.name) ?? []),
     })
   }
 

package/src/registry/build.ts

@@ -19,6 +19,7 @@ import { existsSync, readFileSync, readdirSync } from 'node:fs'
 import { join } from 'node:path'
 import ts from 'typescript'
 import { OWNED_BEHAVIOURS } from '../eslint/index'
+import { looksOf, parseForLooks } from '../eslint/looks-of'
 import { SCHEMA_VERSION, type EntryBehaviour, type EntryKind, type EntryProp, type EntryVariant, type Registry, type RegistryEntry } from './schema'
 
 export interface BuildOptions {
@@ -594,6 +595,12 @@ export function buildRegistry({ root = process.cwd(), repo = 'estiva-ui' }: Buil
 
   const problems: string[] = []
   const entries: RegistryEntry[] = []
+  // What each part looks like (UIG-25), read once per file.
+  const looksCache = new Map<string, ReturnType<typeof parseForLooks>>()
+  const looksFor = (file: string, name: string) => {
+    if (!looksCache.has(file)) looksCache.set(file, parseForLooks(join(src, file.replace(/^src\//, '')), readFileSync(join(src, file.replace(/^src\//, '')), 'utf8')))
+    return looksOf(looksCache.get(file)!, [name]).get(name) ?? []
+  }
 
   for (const value of values) {
     const module = moduleOf(value.module)
@@ -641,6 +648,7 @@ export function buildRegistry({ root = process.cwd(), repo = 'estiva-ui' }: Buil
       storyId: title && story ? toId(title, story) : null,
       docPage: pageFile,
       app: null,
+      looks: kindOf(value.name) === 'component' ? looksFor(module.file, value.name) : [],
     })
   }
 

package/src/registry/registry.test.ts

@@ -176,7 +176,7 @@ describe('the registry builds', () => {
 
   it('reads them however the component was written', () => {
     // Written out at the parameter, with no named type at all.
-    expect(entry('SectionLabel').variants).toEqual([{ prop: 'tone', values: ['primary', 'secondary'] }])
+    expect(entry('SectionLabel').variants).toEqual([{ prop: 'tone', values: ['primary', 'secondary', 'muted'] }])
     // forwardRef: the props are its second type argument, and the inner
     // function's parameter is bare.
     expect(entry('TextInput').variants).toEqual([{ prop: 'size', values: ['default', 'small'] }])

package/src/registry/schema.ts

@@ -177,6 +177,14 @@ export interface RegistryEntry {
   docPage: string | null
   /** An app's part: its class and the evidence for it (UIG-13). `null` on the package's own entries. */
   app: AppFacts | null
+  /**
+   * What it looks like: each class list it writes, as its look words
+   * (colour, text, border, corner, shadow — never placement), those with four
+   * or more (UIG-25). What `estiva/no-copied-look` compares a hand-typed list
+   * against. Empty for a part that only places others; absent in a catalogue
+   * built before 0.34.0.
+   */
+  looks?: string[]
 }
 
 /** A name that is exported and deliberately not an entry. Empty today; the count still has to reconcile. */
@@ -329,6 +337,7 @@ export function validateRegistry(value: unknown): string[] {
     else for (const behaviour of entry.ownsBehaviours) {
       if (!isFilledString(behaviour?.id) || !isFilledString(behaviour?.behaviour)) fail(at('ownsBehaviours') + ' has a malformed entry')
     }
+    if (entry.looks !== undefined && !(Array.isArray(entry.looks) && entry.looks.every(isFilledString))) fail(at('looks') + ' is not a list of class lists')
     for (const key of ['docsId', 'storyId', 'docPage'] as const) {
       const held = entry[key]
       if (!(held === null || isFilledString(held))) fail(at(key) + ' is neither a string nor null')

package/dist/registry/app-FXN4EI34.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-import {
-  buildAppRegistry
-} from "./chunk-XCBN2EKW.js";
-import "./chunk-NJN4MQAM.js";
-import "./chunk-E4JNV7PC.js";
-export {
-  buildAppRegistry
-};
-//# sourceMappingURL=app-FXN4EI34.js.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/registry/schema.ts"],
-  "sourcesContent": ["/**\n * The catalogue's shape (UIG-12, seam S2 in docs/GATES.md \u00A716).\n *\n * A **data source read by machines first** and rendered second \u2014 not a\n * documentation generator. The skill (UIG-20), the copy detector (UIG-25) and\n * the merged search (UIG-19) all read this and nothing else, so the field\n * names are the contract and `schemaVersion` is what makes a change to them\n * detectable.\n *\n * Names are plain and ours. Open-sourcing is far off; when it comes, a\n * renaming pass is one version bump, and guessing at a public vocabulary now\n * would cost every reader between here and there.\n */\n\n/**\n * Raise this whenever a field is added, removed or given a new meaning. A\n * reader that knows version N and is handed N+1 must be able to say so rather\n * than silently read a field that moved.\n */\nexport const SCHEMA_VERSION = 2\n\n/** What a name is, which decides how a reader offers it. */\nexport type EntryKind =\n  /** Draws something. Used in JSX. */\n  | 'component'\n  /** A React hook: `use\u2026`, callable only inside a component. */\n  | 'hook'\n  /** A function or a constant. Neither of the above. */\n  | 'helper'\n\n/** Where an entry's one-line purpose was read from. */\nexport type PurposeSource =\n  /** The `.mdx` page's opening paragraph \u2014 the name has a page of its own. */\n  | 'page'\n  /** The doc comment above the export \u2014 the name is documented on a sibling's page. */\n  | 'comment'\n  /** An app's file that holds this one part: the comment at the top of the file (UIG-13). */\n  | 'file'\n  /** An app's pass-on: the part is the package's, and says so (UIG-13). */\n  | 'package'\n\n/**\n * Which of four kinds an app's part is (UIG-13), or that nothing uses it.\n *\n * Worked out from the code, never from the folder a file sits in: Peek's\n * `components/ui` holds one-line pass-ons beside 187-line components.\n */\nexport type EntryClass =\n  /** Its file only hands a package part on, so the app keeps its own import path. */\n  | 're-export'\n  /** Used in two or more places in the app. Gets a usage page (UIG-17, UIG-18). */\n  | 'reusable'\n  /** Used in one place. Needs only its purpose line. */\n  | 'one-off'\n  /** Reusable, and everything it uses is already in the package: it could move there. Katerina rules. */\n  | 'promote-candidate'\n  /** No file of the app uses it: only its stories or tests, or nothing. Listed, never deleted by the catalogue. */\n  | 'unused'\n\n/**\n * What the catalogue knows about a part that lives in an app (UIG-13). `null`\n * on the package's own entries.\n */\nexport interface AppFacts {\n  class: EntryClass\n  /** Why it has that class, in words: the evidence, or the written reason. */\n  reason: string\n  /**\n   * `true` when the class is written beside the part (`@registry <class>: <reason>`\n   * in its comment) rather than worked out \u2014 \"general, though one screen uses it yet\".\n   */\n  written: boolean\n  /** A pass-on's part, as `Name` for the package's and `Name from <package>` for another's. `null` otherwise. */\n  handsOn: string | null\n  /**\n   * The app's files that use it, relative to the app: every file that imports it,\n   * and its own file when something else there draws it. Stories and tests are not\n   * uses \u2014 a part only they reach is unused.\n   */\n  usedIn: string[]\n  /**\n   * What ties it to this app: each import that is neither in the package's own\n   * dependencies nor an app file that is itself untied. Empty means it could\n   * live in the package as it is.\n   */\n  tiedTo: string[]\n  /** The package part with the same name, when there is one: the reader should see both. */\n  packageNamesake: string | null\n  /** Imported as `import X from \u2026` rather than `import { X } from \u2026`. */\n  defaultExport: boolean\n}\n\n/** A file in an app's target set that holds no part, and why, in words. */\nexport interface FileWithoutPart {\n  file: string\n  reason: string\n}\n\nexport type EntryStatus = 'stable' | 'migrating' | 'deprecated'\n\n/** A prop that takes one of a known set of words, and the set. */\nexport interface EntryVariant {\n  prop: string\n  values: string[]\n}\n\n/**\n * One prop a component declares itself.\n *\n * **Itself**, not what it inherits: a component that extends\n * `ComponentPropsWithRef<'div'>` would otherwise drag in every DOM attribute,\n * which is noise in a catalogue whose whole point is a short answer.\n */\nexport interface EntryProp {\n  name: string\n  /**\n   * What it takes, in a word a person reads: `true/false`, `number`, `text`,\n   * `anything`, `a handler`, the words themselves for a set (`left | right`),\n   * or the type as written where none of those fit.\n   */\n  takes: string\n  required: boolean\n  /** The first sentence of the prop's own comment, where it has one. */\n  note: string | null\n}\n\n/** A behaviour this component owns, from UIG-8's enumeration. */\nexport interface EntryBehaviour {\n  /** `OwnedBehaviour.id` \u2014 `portal`, `walking`, `scroll`\u2026 */\n  id: string\n  /** What a person notices it doing, in words. */\n  behaviour: string\n}\n\nexport interface RegistryEntry {\n  /** The exported name, exactly as `index.ts` exports it. */\n  name: string\n  /** Which library it came from: `estiva-ui`, or the app that owns it. */\n  repo: string\n  kind: EntryKind\n  /** What a caller actually types. */\n  importPath: string\n  /** The file the name is declared in, relative to the repo. Several names share one file. */\n  sourceFile: string\n  /** One line: what it is for. Never empty \u2014 the build fails instead. */\n  purpose: string\n  purposeFrom: PurposeSource\n  /**\n   * Every prop it declares itself \u2014 what it can do. This is the field a reader\n   * asks \"does it already do X?\" of, before writing X by hand.\n   */\n  props: EntryProp[]\n  /**\n   * The subset of `props` that takes one of a known set of words, structured.\n   * Kept beside `props` because it is what a search ranks well on, and what a\n   * caller most often needs named back at them.\n   */\n  variants: EntryVariant[]\n  /** What it owns, so a caller never rebuilds it (UIG-8). Empty for most. */\n  ownsBehaviours: EntryBehaviour[]\n  status: EntryStatus\n  /**\n   * Which migration stage plans to change it.\n   *\n   * Always `null` here. The migration's plan lives in `K:/Estiva/migration\n   * docs`, which is not in this repo and is not in CI \u2014 and a copy kept here by\n   * hand is the drifting list this whole project exists to remove. The field\n   * stays in the schema because a later ticket may have a source a build can\n   * read; until then a reader gets an honest `null` rather than a stale number.\n   */\n  migrationStage: number | null\n  /** The `.mdx` page's Storybook id, or `null` where the name has no page of its own. */\n  docsId: string | null\n  /** A story that shows it, by Storybook id. `null` where nothing renders it alone. */\n  storyId: string | null\n  /** The `.mdx` path, relative to the repo, or `null`. */\n  docPage: string | null\n  /** An app's part: its class and the evidence for it (UIG-13). `null` on the package's own entries. */\n  app: AppFacts | null\n}\n\n/** A name that is exported and deliberately not an entry. Empty today; the count still has to reconcile. */\nexport interface RegistryExclusion {\n  name: string\n  reason: string\n}\n\nexport interface Registry {\n  schemaVersion: number\n  builtFrom: {\n    /**\n     * `package`: the package's catalogue, committed and shipped. `app`: one app's,\n     * built fresh from its code each time and never committed \u2014 Peek and Ship are\n     * private, the package is public (Katerina, 18 September 2026).\n     */\n    kind: 'package' | 'app'\n    repo: string\n    /** The package the entries are imported from, or the app's own name. */\n    package: string\n    packageVersion: string\n    /**\n     * The package: value exports counted in `index.ts`. An app: parts found in its\n     * files. `entries + excluded` must equal it.\n     */\n    exports: number\n    /** Type-only exports, which are not entries. Recorded so the count reconciles. `0` for an app. */\n    typeExports: number\n    /**\n     * An app only: its `.tsx` files outside stories and tests. Each one either holds\n     * an entry or is in `filesWithoutParts`. `null` for the package.\n     */\n    files: number | null\n  }\n  /**\n   * How to turn an id into a link. There is no Storybook on the internet yet\n   * (UIG-19), so an absolute URL committed here would resolve nowhere: the\n   * reader joins its own base to these.\n   */\n  storybook: {\n    docsPath: string\n    storyPath: string\n    devUrl: string\n  }\n  entries: RegistryEntry[]\n  excluded: RegistryExclusion[]\n  /** An app's `.tsx` files that hold no part, each with its reason. Empty for the package. */\n  filesWithoutParts: FileWithoutPart[]\n}\n\nconst KINDS: EntryKind[] = ['component', 'hook', 'helper']\nconst STATUSES: EntryStatus[] = ['stable', 'migrating', 'deprecated']\nconst SOURCES: PurposeSource[] = ['page', 'comment', 'file', 'package']\nexport const CLASSES: EntryClass[] = ['re-export', 'reusable', 'one-off', 'promote-candidate', 'unused']\n\nconst isString = (v: unknown): v is string => typeof v === 'string'\nconst isFilledString = (v: unknown): v is string => isString(v) && v.trim().length > 0\n\n/**\n * Check a registry against this schema. Returns every problem, not the first:\n * a build that reports one missing purpose per run costs one run per entry.\n *\n * An empty list is the only pass. CI runs this on the committed file.\n */\nexport function validateRegistry(value: unknown): string[] {\n  const problems: string[] = []\n  const fail = (message: string) => problems.push(message)\n\n  if (typeof value !== 'object' || value === null) return ['the registry is not an object']\n  const registry = value as Partial<Registry>\n\n  if (registry.schemaVersion !== SCHEMA_VERSION) fail(`schemaVersion is ${String(registry.schemaVersion)}, expected ${SCHEMA_VERSION}`)\n\n  const built = registry.builtFrom\n  let isApp = false\n  if (typeof built !== 'object' || built === null) fail('builtFrom is missing')\n  else {\n    if (built.kind !== 'package' && built.kind !== 'app') fail(`builtFrom.kind is ${String(built.kind)}, expected package or app`)\n    isApp = built.kind === 'app'\n    if (!isFilledString(built.repo)) fail('builtFrom.repo is missing')\n    if (!isFilledString(built.package)) fail('builtFrom.package is missing')\n    if (!isFilledString(built.packageVersion)) fail('builtFrom.packageVersion is missing')\n    if (typeof built.exports !== 'number') fail('builtFrom.exports is not a number')\n    if (typeof built.typeExports !== 'number') fail('builtFrom.typeExports is not a number')\n    if (isApp ? typeof built.files !== 'number' : built.files !== null) fail(`builtFrom.files is ${String(built.files)}: a number for an app, null for the package`)\n  }\n\n  const book = registry.storybook\n  if (typeof book !== 'object' || book === null) fail('storybook is missing')\n  else {\n    for (const key of ['docsPath', 'storyPath', 'devUrl'] as const) {\n      if (!isFilledString(book[key])) fail(`storybook.${key} is missing`)\n    }\n    if (isString(book.docsPath) && !book.docsPath.includes('{docsId}')) fail('storybook.docsPath does not carry {docsId}')\n    if (isString(book.storyPath) && !book.storyPath.includes('{storyId}')) fail('storybook.storyPath does not carry {storyId}')\n  }\n\n  const entries = registry.entries\n  const excluded = registry.excluded\n  const withoutParts = registry.filesWithoutParts\n  if (!Array.isArray(entries)) return [...problems, 'entries is not an array']\n  if (!Array.isArray(excluded)) return [...problems, 'excluded is not an array']\n  if (!Array.isArray(withoutParts)) return [...problems, 'filesWithoutParts is not an array']\n  // An app with no part of its own yet is still an app: only the package must have entries.\n  if (entries.length === 0 && !isApp) fail('entries is empty')\n\n  // The package's names are unique; an app may have two parts of one name in two\n  // files, and the catalogue says which is which rather than refusing the app.\n  const seen = new Set<string>()\n  const seenNames = new Set<string>()\n  for (const [i, raw] of entries.entries()) {\n    const at = (field: string) => `entries[${i}] (${isString((raw as RegistryEntry)?.name) ? (raw as RegistryEntry).name : '?'}).${field}`\n    if (typeof raw !== 'object' || raw === null) {\n      fail(`entries[${i}] is not an object`)\n      continue\n    }\n    const entry = raw as Partial<RegistryEntry>\n    const key = isApp ? `${String(entry.sourceFile)}#${String(entry.name)}` : String(entry.name)\n    if (!isFilledString(entry.name)) fail(at('name') + ' is missing')\n    else if (seen.has(key)) fail(`${entry.name} appears twice${isApp ? ` in ${String(entry.sourceFile)}` : ''}`)\n    else {\n      seen.add(key)\n      seenNames.add(entry.name)\n    }\n\n    if (!isFilledString(entry.repo)) fail(at('repo') + ' is missing')\n    if (!isFilledString(entry.importPath)) fail(at('importPath') + ' is missing')\n    if (!isFilledString(entry.sourceFile)) fail(at('sourceFile') + ' is missing')\n    // The reason this schema exists: an entry with no purpose is an entry the\n    // search cannot find and the skill cannot quote.\n    if (!isFilledString(entry.purpose)) fail(at('purpose') + ' is empty')\n    if (!KINDS.includes(entry.kind as EntryKind)) fail(at('kind') + ` is ${String(entry.kind)}`)\n    if (!SOURCES.includes(entry.purposeFrom as PurposeSource)) fail(at('purposeFrom') + ` is ${String(entry.purposeFrom)}`)\n    if (!STATUSES.includes(entry.status as EntryStatus)) fail(at('status') + ` is ${String(entry.status)}`)\n    if (!(entry.migrationStage === null || typeof entry.migrationStage === 'number')) fail(at('migrationStage') + ' is neither a number nor null')\n    if (!Array.isArray(entry.props)) fail(at('props') + ' is not an array')\n    else\n      for (const prop of entry.props) {\n        if (!isFilledString(prop?.name) || !isFilledString(prop?.takes) || typeof prop?.required !== 'boolean') fail(at('props') + ' has a malformed entry')\n        else if (!(prop.note === null || isFilledString(prop.note))) fail(at('props') + `.${prop.name}.note is neither a string nor null`)\n      }\n    if (!Array.isArray(entry.variants)) fail(at('variants') + ' is not an array')\n    else\n      for (const variant of entry.variants) {\n        if (!isFilledString(variant?.prop) || !Array.isArray(variant?.values) || variant.values.length === 0) fail(at('variants') + ' has a malformed entry')\n        // variants is a view of props, never a second source that can disagree.\n        else if (Array.isArray(entry.props) && !entry.props.some((prop) => prop?.name === variant.prop)) fail(at('variants') + `.${variant.prop} is not one of its props`)\n      }\n    if (!Array.isArray(entry.ownsBehaviours)) fail(at('ownsBehaviours') + ' is not an array')\n    else for (const behaviour of entry.ownsBehaviours) {\n      if (!isFilledString(behaviour?.id) || !isFilledString(behaviour?.behaviour)) fail(at('ownsBehaviours') + ' has a malformed entry')\n    }\n    for (const key of ['docsId', 'storyId', 'docPage'] as const) {\n      const held = entry[key]\n      if (!(held === null || isFilledString(held))) fail(at(key) + ' is neither a string nor null')\n    }\n    // \"Every storyUrl resolves, or is recorded as absent with a reason\" \u2014 the\n    // reason is enforced rather than written down: only something that draws\n    // nothing may have nowhere to be looked at. A component with no story is\n    // already an error of UIG-5's component-has-a-story; this stops the\n    // catalogue quietly carrying one.\n    //\n    // The package only. An app's parts are described before they are drawn:\n    // absence of a story says nothing about whether a part is reused, and UIG-19\n    // is where a reusable one must have one.\n    if (!isApp && entry.kind === 'component' && (entry.docsId === null || entry.storyId === null)) {\n      fail(at('docsId') + ' is null, and only a helper or a hook may have no page or story')\n    }\n\n    if (!isApp) {\n      if (entry.app !== null) fail(at('app') + ' is set on a package entry')\n    } else {\n      problems.push(...validateAppFacts(entry, at))\n    }\n  }\n\n  for (const [i, raw] of excluded.entries()) {\n    const gap = raw as Partial<RegistryExclusion>\n    if (!isFilledString(gap?.name)) fail(`excluded[${i}].name is missing`)\n    if (!isFilledString(gap?.reason)) fail(`excluded[${i}].reason is missing`)\n    if (!isApp && isString(gap?.name) && seenNames.has(gap.name)) fail(`${gap.name} is both an entry and excluded`)\n  }\n\n  // Completeness (the ticket's acceptance): every value export is either an\n  // entry or an exclusion with a reason. Averaging the difference away is the\n  // failure this check exists to make impossible.\n  const counted = entries.length + excluded.length\n  if (typeof built === 'object' && built !== null && typeof built.exports === 'number' && counted !== built.exports) {\n    fail(`${entries.length} entries + ${excluded.length} excluded = ${counted}, but ${isApp ? 'the app has' : 'index.ts exports'} ${built.exports} ${isApp ? 'parts' : 'values'}`)\n  }\n\n  // And an app's files: every one either holds a part or says why it does not.\n  const fileProblems: string[] = []\n  const withParts = new Set(entries.map((entry) => (entry as RegistryEntry).sourceFile))\n  for (const [i, raw] of withoutParts.entries()) {\n    const gap = raw as Partial<FileWithoutPart>\n    if (!isFilledString(gap?.file)) fileProblems.push(`filesWithoutParts[${i}].file is missing`)\n    else if (withParts.has(gap.file)) fileProblems.push(`${gap.file} holds a part and is listed as holding none`)\n    if (!isFilledString(gap?.reason)) fileProblems.push(`filesWithoutParts[${i}].reason is missing`)\n  }\n  if (!isApp && withoutParts.length) fileProblems.push('filesWithoutParts is for an app; the package lists its exports instead')\n  if (isApp && typeof built === 'object' && built !== null && typeof built.files === 'number' && withParts.size + withoutParts.length !== built.files) {\n    fileProblems.push(`${withParts.size} files hold a part + ${withoutParts.length} hold none = ${withParts.size + withoutParts.length}, but the app has ${built.files} files`)\n  }\n  problems.push(...fileProblems)\n\n  return problems\n}\n\n/**\n * An app entry's class must be what its own evidence says, unless it is written\n * beside the part with a reason. A pass-on is a fact about the file, so it can\n * never be written, and only a pass-on hands a part on.\n */\nfunction validateAppFacts(entry: Partial<RegistryEntry>, at: (field: string) => string): string[] {\n  const problems: string[] = []\n  const fail = (message: string) => problems.push(message)\n  const facts = entry.app\n  if (typeof facts !== 'object' || facts === null) return [at('app') + ' is missing on an app entry']\n  if (!CLASSES.includes(facts.class)) fail(at('app.class') + ` is ${String(facts.class)}`)\n  if (!isFilledString(facts.reason)) fail(at('app.reason') + ' is empty')\n  if (typeof facts.written !== 'boolean') fail(at('app.written') + ' is not true/false')\n  if (typeof facts.defaultExport !== 'boolean') fail(at('app.defaultExport') + ' is not true/false')\n  if (!Array.isArray(facts.usedIn) || !facts.usedIn.every(isFilledString)) fail(at('app.usedIn') + ' is not a list of files')\n  if (!Array.isArray(facts.tiedTo) || !facts.tiedTo.every(isFilledString)) fail(at('app.tiedTo') + ' is not a list')\n  if (!(facts.handsOn === null || isFilledString(facts.handsOn))) fail(at('app.handsOn') + ' is neither a name nor null')\n  if (!(facts.packageNamesake === null || isFilledString(facts.packageNamesake))) fail(at('app.packageNamesake') + ' is neither a name nor null')\n  if (problems.length) return problems\n\n  const passOn = facts.class === 're-export'\n  if (passOn !== (facts.handsOn !== null)) fail(at('app.handsOn') + (passOn ? ' is missing on a pass-on' : ' is set on a part that is not a pass-on'))\n  if (passOn !== (entry.purposeFrom === 'package')) fail(at('purposeFrom') + (passOn ? ' must be package on a pass-on' : ' is package on a part that is not a pass-on'))\n  if (passOn && facts.written) fail(at('app.written') + ': a pass-on is read from the file, never written')\n  if (!facts.written && !passOn) {\n    const uses = facts.usedIn.length\n    const expected: EntryClass = uses === 0 ? 'unused' : uses === 1 ? 'one-off' : facts.tiedTo.length ? 'reusable' : 'promote-candidate'\n    if (facts.class !== expected) fail(at('app.class') + ` is ${facts.class}, but its evidence (${uses} uses, ${facts.tiedTo.length} ties) says ${expected}`)\n  }\n  return problems\n}\n"],
-  "mappings": "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",
-  "names": ["key"]
-}