@estiva-app/ui 0.22.0 → 0.23.0

package/dist/registry/schema.d.ts

@@ -16,7 +16,7 @@
  * reader that knows version N and is handed N+1 must be able to say so rather
  * than silently read a field that moved.
  */
-export declare const SCHEMA_VERSION = 1;
+export declare const SCHEMA_VERSION = 2;
 /** What a name is, which decides how a reader offers it. */
 export type EntryKind = 
 /** Draws something. Used in JSX. */
@@ -30,7 +30,65 @@ export type PurposeSource =
 /** The `.mdx` page's opening paragraph — the name has a page of its own. */
 'page'
 /** The doc comment above the export — the name is documented on a sibling's page. */
- | 'comment';
+ | 'comment'
+/** An app's file that holds this one part: the comment at the top of the file (UIG-13). */
+ | 'file'
+/** An app's pass-on: the part is the package's, and says so (UIG-13). */
+ | 'package';
+/**
+ * Which of four kinds an app's part is (UIG-13), or that nothing uses it.
+ *
+ * Worked out from the code, never from the folder a file sits in: Peek's
+ * `components/ui` holds one-line pass-ons beside 187-line components.
+ */
+export type EntryClass = 
+/** Its file only hands a package part on, so the app keeps its own import path. */
+'re-export'
+/** Used in two or more places in the app. Gets a usage page (UIG-17, UIG-18). */
+ | 'reusable'
+/** Used in one place. Needs only its purpose line. */
+ | 'one-off'
+/** Reusable, and everything it uses is already in the package: it could move there. Katerina rules. */
+ | 'promote-candidate'
+/** No file of the app uses it: only its stories or tests, or nothing. Listed, never deleted by the catalogue. */
+ | 'unused';
+/**
+ * What the catalogue knows about a part that lives in an app (UIG-13). `null`
+ * on the package's own entries.
+ */
+export interface AppFacts {
+    class: EntryClass;
+    /** Why it has that class, in words: the evidence, or the written reason. */
+    reason: string;
+    /**
+     * `true` when the class is written beside the part (`@registry <class>: <reason>`
+     * in its comment) rather than worked out — "general, though one screen uses it yet".
+     */
+    written: boolean;
+    /** A pass-on's part, as `Name` for the package's and `Name from <package>` for another's. `null` otherwise. */
+    handsOn: string | null;
+    /**
+     * The app's files that use it, relative to the app: every file that imports it,
+     * and its own file when something else there draws it. Stories and tests are not
+     * uses — a part only they reach is unused.
+     */
+    usedIn: string[];
+    /**
+     * What ties it to this app: each import that is neither in the package's own
+     * dependencies nor an app file that is itself untied. Empty means it could
+     * live in the package as it is.
+     */
+    tiedTo: string[];
+    /** The package part with the same name, when there is one: the reader should see both. */
+    packageNamesake: string | null;
+    /** Imported as `import X from …` rather than `import { X } from …`. */
+    defaultExport: boolean;
+}
+/** A file in an app's target set that holds no part, and why, in words. */
+export interface FileWithoutPart {
+    file: string;
+    reason: string;
+}
 export type EntryStatus = 'stable' | 'migrating' | 'deprecated';
 /** A prop that takes one of a known set of words, and the set. */
 export interface EntryVariant {
@@ -66,7 +124,7 @@ export interface EntryBehaviour {
 export interface RegistryEntry {
     /** The exported name, exactly as `index.ts` exports it. */
     name: string;
-    /** Which library it came from. One repo per registry until UIG-13 merges them. */
+    /** Which library it came from: `estiva-ui`, or the app that owns it. */
     repo: string;
     kind: EntryKind;
     /** What a caller actually types. */
@@ -106,6 +164,8 @@ export interface RegistryEntry {
     storyId: string | null;
     /** The `.mdx` path, relative to the repo, or `null`. */
     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;
 }
 /** A name that is exported and deliberately not an entry. Empty today; the count still has to reconcile. */
 export interface RegistryExclusion {
@@ -115,14 +175,28 @@ export interface RegistryExclusion {
 export interface Registry {
     schemaVersion: number;
     builtFrom: {
+        /**
+         * `package`: the package's catalogue, committed and shipped. `app`: one app's,
+         * built fresh from its code each time and never committed — Peek and Ship are
+         * private, the package is public (Katerina, 18 September 2026).
+         */
+        kind: 'package' | 'app';
         repo: string;
-        /** The npm package the entries are imported from. */
+        /** The package the entries are imported from, or the app's own name. */
         package: string;
         packageVersion: string;
-        /** Value exports counted in `index.ts`. `entries + excluded` must equal it. */
+        /**
+         * The package: value exports counted in `index.ts`. An app: parts found in its
+         * files. `entries + excluded` must equal it.
+         */
         exports: number;
-        /** Type-only exports, which are not entries. Recorded so the count reconciles. */
+        /** Type-only exports, which are not entries. Recorded so the count reconciles. `0` for an app. */
         typeExports: number;
+        /**
+         * An app only: its `.tsx` files outside stories and tests. Each one either holds
+         * an entry or is in `filesWithoutParts`. `null` for the package.
+         */
+        files: number | null;
     };
     /**
      * How to turn an id into a link. There is no Storybook on the internet yet
@@ -136,7 +210,10 @@ export interface Registry {
     };
     entries: RegistryEntry[];
     excluded: RegistryExclusion[];
+    /** An app's `.tsx` files that hold no part, each with its reason. Empty for the package. */
+    filesWithoutParts: FileWithoutPart[];
 }
+export declare const CLASSES: EntryClass[];
 /**
  * Check a registry against this schema. Returns every problem, not the first:
  * a build that reports one missing purpose per run costs one run per entry.

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/registry/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc,IAAI,CAAA;AAE/B,4DAA4D;AAC5D,MAAM,MAAM,SAAS;AACnB,oCAAoC;AAClC,WAAW;AACb,8DAA8D;GAC5D,MAAM;AACR,sDAAsD;GACpD,QAAQ,CAAA;AAEZ,uDAAuD;AACvD,MAAM,MAAM,aAAa;AACvB,4EAA4E;AAC1E,MAAM;AACR,qFAAqF;GACnF,SAAS,CAAA;AAEb,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAA;AAE/D,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;IACjB,sEAAsE;IACtE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAED,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAA;IACV,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,SAAS,CAAA;IACf,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,UAAU,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,aAAa,CAAA;IAC1B;;;OAGG;IACH,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB;;;;OAIG;IACH,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,2EAA2E;IAC3E,cAAc,EAAE,cAAc,EAAE,CAAA;IAChC,MAAM,EAAE,WAAW,CAAA;IACnB;;;;;;;;OAQG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,uFAAuF;IACvF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,qFAAqF;IACrF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,wDAAwD;IACxD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,4GAA4G;AAC5G,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAA;QACZ,qDAAqD;QACrD,OAAO,EAAE,MAAM,CAAA;QACf,cAAc,EAAE,MAAM,CAAA;QACtB,+EAA+E;QAC/E,OAAO,EAAE,MAAM,CAAA;QACf,kFAAkF;QAClF,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;IACD;;;;OAIG;IACH,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAC9B;AASD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAwGzD"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/registry/schema.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@estiva-app/ui",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Estiva's design tokens (the contract) and a small set of primitives (a convenience) for every Estiva app.",
   "type": "module",
   "license": "MIT",
@@ -66,7 +66,7 @@
     "preregistry:check": "node build.mjs",
     "registry:check": "node dist/registry/cli.js check",
     "preui:find": "node build.mjs",
-    "ui:find": "node dist/registry/cli.js find",
+    "ui:find": "node dist/registry/cli.js find --also peek=../peek --also ship=../ship/web",
     "prepublishOnly": "npm run build"
   },
   "peerDependencies": {