@nanisoft/prism-ui 0.5.0 → 0.6.0

package/dist/theming/index.d.ts

@@ -0,0 +1,173 @@
+/**
+ * The Prism theming vocabulary: pack and mode are two independent axes.
+ *
+ * `data-pack` selects the palette and `.dark` selects the mode; neither implies
+ * the other (ticket 07). `default` is the selectable neutral pack id, and its
+ * markup is the absence of the attribute. Everything here is pure and
+ * isomorphic so a Server Component can render the declarative form without a
+ * client runtime. There is no theme factory and no override object: the pack
+ * and mode are the whole API.
+ */
+export declare const PACKS: readonly ["default", "blush", "mint", "lavender", "sky", "peach"];
+export type PackId = (typeof PACKS)[number];
+export declare const MODES: readonly ["light", "dark"];
+export type Mode = (typeof MODES)[number];
+export declare const PACK_ATTRIBUTE = "data-pack";
+export declare const DEFAULT_STORAGE_KEY = "prism-theme";
+/**
+ * The root attribute that records where the active pack and mode came from.
+ *
+ * This is a contract, not markup. The boot script is its only writer, and the
+ * provider never touches it, because two writers would make the recorded origin
+ * a race rather than a record. The value is always one of `THEME_ORIGINS` and is
+ * written on every path the script reaches, including a stored value that could
+ * not be parsed: an absent attribute cannot be told from an unread one, and a
+ * theme that fell through to the default is exactly the case a reader needs to
+ * see named.
+ *
+ * It is not `data-theme`, which `MIGRATION.md` retires. It carries the
+ * provenance of a resolution, never a pack.
+ */
+export declare const THEME_ORIGIN_ATTRIBUTE = "data-theme-origin";
+/**
+ * The closed set the boot script may write to `THEME_ORIGIN_ATTRIBUTE`.
+ *
+ *   - `stored`   a valid `{ pack, mode }` pair was in the key this line writes.
+ *   - `legacy`   the key was empty and a key this line no longer writes held a
+ *                recoverable mode, so that decision was taken and carried over.
+ *   - `unparsed` the key held a value that is not a pair. The theme fell
+ *                through whole, and the value was left in place, because it is
+ *                the only record that this reader ever chose anything.
+ *   - `document` the key was empty and the root element's own attributes
+ *                supplied the theme.
+ *   - `default`  neither did, so the consumer's own defaults apply.
+ *
+ * `legacy` and `unparsed` are why the set is five and not three: a
+ * three-value set records that the theme came from somewhere but cannot
+ * distinguish "never chose" from "chose, and the value no longer parses", which
+ * is the one distinction a storage migration has to be retired against.
+ */
+export declare const THEME_ORIGINS: readonly ["stored", "legacy", "document", "default", "unparsed"];
+export type ThemeOrigin = (typeof THEME_ORIGINS)[number];
+/**
+ * Keys earlier lines of this package wrote and this line does not.
+ *
+ * `prism-theme-mode` was the shared chrome key: the mode setter wrote it, and
+ * only the mode setter, as a bare `'light'` or `'dark'` string, because the pack
+ * was fixed per site and the mode was the one choice that travelled across
+ * sites. The value is not a `{ pack, mode }` pair and can never collide with one
+ * this line writes, so reading it costs nothing and recovers a real decision.
+ *
+ * The list is the migration's own expiry. Every key in it is a clause the boot
+ * script carries and prices, and the migration is retired by deleting the last
+ * entry: the clause's live population is then empty, the gate reports it, and
+ * the byte ceiling's generation allowance falls to zero with it. Nothing here
+ * is bounded by a date or a version number.
+ */
+export declare const LEGACY_MODE_STORAGE_KEYS: readonly ["prism-theme-mode"];
+/**
+ * Reads a persisted `{ pack, mode }` object.
+ *
+ * Returns `null` for anything that is not a valid pair, so a corrupt or
+ * superseded stored value falls back to the defaults rather than to a pack that
+ * does not exist. Parsing is deliberately strict: the store is owned by
+ * `PrismProvider`, which always writes this exact shape.
+ */
+export declare function parseStoredTheme(raw: string | null): {
+    pack: PackId;
+    mode: Mode;
+} | null;
+/**
+ * What `resolveTheme` was given, and nothing else.
+ *
+ * The three readers are all the same question asked of different state: what
+ * does this reader believe, what has the server rendered, and what is the
+ * consumer's own default. `stored` and `legacy` are raw strings exactly as the
+ * store holds them, so a corrupt value is visible to the rule rather than
+ * normalised away by a caller.
+ */
+export type ThemeResolutionInput = {
+    /** Raw contents of the key this line writes, or `null` when it is absent. */
+    stored: string | null;
+    /** Raw contents of one key this line no longer writes, or `null`. */
+    legacy: string | null;
+    /** `data-pack` on the root element as rendered, valid or not. */
+    documentPack: string | null;
+    /** Whether the root element carries `.dark` as rendered. */
+    documentDark: boolean;
+    defaultPack: PackId;
+    defaultMode: Mode;
+};
+export type ThemeResolution = {
+    pack: PackId;
+    mode: Mode;
+    /** Which source named the pair, for `THEME_ORIGIN_ATTRIBUTE`. */
+    origin: ThemeOrigin;
+};
+/**
+ * The one resolution rule. `PrismProvider` calls it, and the boot script
+ * implements it as a string, and the equivalence gate runs both over one table
+ * because the string cannot import it.
+ *
+ * A serialised function is not a way to share it. The build minifies, a renamed
+ * identifier inside the script's own `try` would throw there and the catch
+ * would fail open, leaving a silent no-op on every page; so the honest shape is
+ * one implementation plus a gate that can fail, not two copies that look
+ * aligned.
+ *
+ * The order, and why each step is where it is:
+ *
+ *   1. A valid pair in the key this line writes wins outright. A decision
+ *      recorded as a pair is a decision, and it is the only source that names
+ *      both axes at once.
+ *   2. A value that is present but is not a pair falls through WHOLE. It is not
+ *      repaired field by field, because a half-applied pair is a theme neither
+ *      the reader nor the server chose, and because repairing it would make the
+ *      two readers disagree about what "a valid mode" means. The value is also
+ *      not cleared: it is the only record that this reader ever chose, and the
+ *      origin is `unparsed` so a reader can see that it is there and unusable.
+ *   3. Only an absent key reaches the keys this line no longer writes. A present
+ *      but unusable value is a record of an intent and outranks an older one.
+ *   4. The root element's own attributes, which is what a server rendered and
+ *      what must survive hydration rather than flash to the default.
+ *   5. The consumer's defaults, which is the site's decision, not the reader's.
+ *
+ * Every step names its own source, so the pack and the mode always come from
+ * the same one. That is the whole-vs-half property, and it is structural rather
+ * than a check.
+ */
+export declare function resolveTheme({ stored, legacy, documentPack, documentDark, defaultPack, defaultMode, }: ThemeResolutionInput): ThemeResolution;
+/**
+ * The first key in `LEGACY_MODE_STORAGE_KEYS` that holds a recoverable mode.
+ *
+ * Returned with the key that held it, because the recovery has to retire that
+ * key and no other. Order is the list's order, and the list is short enough
+ * that the loop is not worth a comment about its cost.
+ */
+export declare function readLegacyMode(read: (key: string) => string | null): {
+    key: string;
+    mode: Mode;
+} | null;
+/**
+ * Turns a pack and a mode into the markup attributes that express them.
+ *
+ * Returns attributes, never CSS values: a Server Component spreads the result
+ * onto `<html>` and gets the declarative form with no client runtime. `default`
+ * is expressed by omitting `data-pack`; light is expressed by omitting `dark`.
+ *
+ * `mode` is optional because a server cannot know the reader's mode, and a
+ * required one is that impossibility written into the type: the only way to ask
+ * for a boundary with no mode class of its own would be to pass `'light'` as a
+ * guess, and the guess is wrong for half of them. Omitting it is the honest
+ * spelling of "wear the mode of the element carrying `.dark`", which is what the
+ * token build's descendant selector implements. `pack` stays required, because an
+ * element carrying neither axis is not a theme boundary.
+ */
+export declare function themeAttributes({ pack, mode, }: {
+    pack: PackId;
+    mode?: Mode;
+}): {
+    'data-pack'?: string;
+    className?: string;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theming/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,KAAK,mEAAoE,CAAA;AACtF,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3C,eAAO,MAAM,KAAK,4BAA6B,CAAA;AAC/C,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzC,eAAO,MAAM,cAAc,cAAc,CAAA;AACzC,eAAO,MAAM,mBAAmB,gBAAgB,CAAA;AAEhD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,sBAAsB,CAAA;AAEzD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,kEAAmE,CAAA;AAC7F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB,+BAAgC,CAAA;AAUrE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,CAgBxF;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,6EAA6E;IAC7E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,qEAAqE;IACrE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,iEAAiE;IACjE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,4DAA4D;IAC5D,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,IAAI,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,IAAI,CAAA;IACV,iEAAiE;IACjE,MAAM,EAAE,WAAW,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,EAAE,oBAAoB,GAAG,eAAe,CAoBxC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GACnC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,CAMpC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,IAAI,GACL,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,IAAI,CAAA;CACZ,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAK/C"}

package/dist/theming/index.js

@@ -0,0 +1,186 @@
+/**
+ * The Prism theming vocabulary: pack and mode are two independent axes.
+ *
+ * `data-pack` selects the palette and `.dark` selects the mode; neither implies
+ * the other (ticket 07). `default` is the selectable neutral pack id, and its
+ * markup is the absence of the attribute. Everything here is pure and
+ * isomorphic so a Server Component can render the declarative form without a
+ * client runtime. There is no theme factory and no override object: the pack
+ * and mode are the whole API.
+ */
+export const PACKS = ['default', 'blush', 'mint', 'lavender', 'sky', 'peach'];
+export const MODES = ['light', 'dark'];
+export const PACK_ATTRIBUTE = 'data-pack';
+export const DEFAULT_STORAGE_KEY = 'prism-theme';
+/**
+ * The root attribute that records where the active pack and mode came from.
+ *
+ * This is a contract, not markup. The boot script is its only writer, and the
+ * provider never touches it, because two writers would make the recorded origin
+ * a race rather than a record. The value is always one of `THEME_ORIGINS` and is
+ * written on every path the script reaches, including a stored value that could
+ * not be parsed: an absent attribute cannot be told from an unread one, and a
+ * theme that fell through to the default is exactly the case a reader needs to
+ * see named.
+ *
+ * It is not `data-theme`, which `MIGRATION.md` retires. It carries the
+ * provenance of a resolution, never a pack.
+ */
+export const THEME_ORIGIN_ATTRIBUTE = 'data-theme-origin';
+/**
+ * The closed set the boot script may write to `THEME_ORIGIN_ATTRIBUTE`.
+ *
+ *   - `stored`   a valid `{ pack, mode }` pair was in the key this line writes.
+ *   - `legacy`   the key was empty and a key this line no longer writes held a
+ *                recoverable mode, so that decision was taken and carried over.
+ *   - `unparsed` the key held a value that is not a pair. The theme fell
+ *                through whole, and the value was left in place, because it is
+ *                the only record that this reader ever chose anything.
+ *   - `document` the key was empty and the root element's own attributes
+ *                supplied the theme.
+ *   - `default`  neither did, so the consumer's own defaults apply.
+ *
+ * `legacy` and `unparsed` are why the set is five and not three: a
+ * three-value set records that the theme came from somewhere but cannot
+ * distinguish "never chose" from "chose, and the value no longer parses", which
+ * is the one distinction a storage migration has to be retired against.
+ */
+export const THEME_ORIGINS = ['stored', 'legacy', 'document', 'default', 'unparsed'];
+/**
+ * Keys earlier lines of this package wrote and this line does not.
+ *
+ * `prism-theme-mode` was the shared chrome key: the mode setter wrote it, and
+ * only the mode setter, as a bare `'light'` or `'dark'` string, because the pack
+ * was fixed per site and the mode was the one choice that travelled across
+ * sites. The value is not a `{ pack, mode }` pair and can never collide with one
+ * this line writes, so reading it costs nothing and recovers a real decision.
+ *
+ * The list is the migration's own expiry. Every key in it is a clause the boot
+ * script carries and prices, and the migration is retired by deleting the last
+ * entry: the clause's live population is then empty, the gate reports it, and
+ * the byte ceiling's generation allowance falls to zero with it. Nothing here
+ * is bounded by a date or a version number.
+ */
+export const LEGACY_MODE_STORAGE_KEYS = ['prism-theme-mode'];
+function isPack(value) {
+    return typeof value === 'string' && PACKS.includes(value);
+}
+function isMode(value) {
+    return typeof value === 'string' && MODES.includes(value);
+}
+/**
+ * Reads a persisted `{ pack, mode }` object.
+ *
+ * Returns `null` for anything that is not a valid pair, so a corrupt or
+ * superseded stored value falls back to the defaults rather than to a pack that
+ * does not exist. Parsing is deliberately strict: the store is owned by
+ * `PrismProvider`, which always writes this exact shape.
+ */
+export function parseStoredTheme(raw) {
+    if (!raw)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const { pack, mode } = parsed;
+    if (!isPack(pack) || !isMode(mode))
+        return null;
+    return { pack, mode };
+}
+/**
+ * The one resolution rule. `PrismProvider` calls it, and the boot script
+ * implements it as a string, and the equivalence gate runs both over one table
+ * because the string cannot import it.
+ *
+ * A serialised function is not a way to share it. The build minifies, a renamed
+ * identifier inside the script's own `try` would throw there and the catch
+ * would fail open, leaving a silent no-op on every page; so the honest shape is
+ * one implementation plus a gate that can fail, not two copies that look
+ * aligned.
+ *
+ * The order, and why each step is where it is:
+ *
+ *   1. A valid pair in the key this line writes wins outright. A decision
+ *      recorded as a pair is a decision, and it is the only source that names
+ *      both axes at once.
+ *   2. A value that is present but is not a pair falls through WHOLE. It is not
+ *      repaired field by field, because a half-applied pair is a theme neither
+ *      the reader nor the server chose, and because repairing it would make the
+ *      two readers disagree about what "a valid mode" means. The value is also
+ *      not cleared: it is the only record that this reader ever chose, and the
+ *      origin is `unparsed` so a reader can see that it is there and unusable.
+ *   3. Only an absent key reaches the keys this line no longer writes. A present
+ *      but unusable value is a record of an intent and outranks an older one.
+ *   4. The root element's own attributes, which is what a server rendered and
+ *      what must survive hydration rather than flash to the default.
+ *   5. The consumer's defaults, which is the site's decision, not the reader's.
+ *
+ * Every step names its own source, so the pack and the mode always come from
+ * the same one. That is the whole-vs-half property, and it is structural rather
+ * than a check.
+ */
+export function resolveTheme({ stored, legacy, documentPack, documentDark, defaultPack, defaultMode, }) {
+    const pair = parseStoredTheme(stored);
+    if (pair)
+        return { pack: pair.pack, mode: pair.mode, origin: 'stored' };
+    const renderedPack = isPack(documentPack) ? documentPack : null;
+    const renderedMode = documentDark ? 'dark' : null;
+    const fromDocument = () => ({
+        pack: renderedPack ?? defaultPack,
+        mode: renderedMode ?? defaultMode,
+        origin: 'document',
+    });
+    // A value the store holds with content, and `parseStoredTheme` did not accept.
+    const held = stored !== null && stored !== '';
+    if (held)
+        return { ...fromDocument(), origin: 'unparsed' };
+    if (isMode(legacy))
+        return { pack: defaultPack, mode: legacy, origin: 'legacy' };
+    if (renderedPack !== null || renderedMode !== null)
+        return fromDocument();
+    return { pack: defaultPack, mode: defaultMode, origin: 'default' };
+}
+/**
+ * The first key in `LEGACY_MODE_STORAGE_KEYS` that holds a recoverable mode.
+ *
+ * Returned with the key that held it, because the recovery has to retire that
+ * key and no other. Order is the list's order, and the list is short enough
+ * that the loop is not worth a comment about its cost.
+ */
+export function readLegacyMode(read) {
+    for (const key of LEGACY_MODE_STORAGE_KEYS) {
+        const value = read(key);
+        if (isMode(value))
+            return { key, mode: value };
+    }
+    return null;
+}
+/**
+ * Turns a pack and a mode into the markup attributes that express them.
+ *
+ * Returns attributes, never CSS values: a Server Component spreads the result
+ * onto `<html>` and gets the declarative form with no client runtime. `default`
+ * is expressed by omitting `data-pack`; light is expressed by omitting `dark`.
+ *
+ * `mode` is optional because a server cannot know the reader's mode, and a
+ * required one is that impossibility written into the type: the only way to ask
+ * for a boundary with no mode class of its own would be to pass `'light'` as a
+ * guess, and the guess is wrong for half of them. Omitting it is the honest
+ * spelling of "wear the mode of the element carrying `.dark`", which is what the
+ * token build's descendant selector implements. `pack` stays required, because an
+ * element carrying neither axis is not a theme boundary.
+ */
+export function themeAttributes({ pack, mode, }) {
+    const attributes = {};
+    if (pack !== 'default')
+        attributes[PACK_ATTRIBUTE] = pack;
+    if (mode === 'dark')
+        attributes.className = 'dark';
+    return attributes;
+}

package/package.json

@@ -1,48 +1,119 @@
 {
   "name": "@nanisoft/prism-ui",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
-  "description": "Component + block source of truth, published as a shadcn registry.",
+  "description": "Prism's React component, block and page library.",
   "license": "MIT",
   "author": "NaniSoft",
   "homepage": "https://prism.nanisoft.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/NaniSoft/prism.git",
+    "url": "git+https://github.com/NaniSoft/prism.git",
     "directory": "packages/ui"
   },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "types": "./dist/index.d.ts",
   "exports": {
-    "./components/*": "./src/components/*.tsx",
-    "./registry.json": "./registry.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./provider": {
+      "types": "./dist/provider/index.d.ts",
+      "default": "./dist/provider/index.js"
+    },
+    "./components": {
+      "types": "./dist/components/index.d.ts",
+      "default": "./dist/components/index.js"
+    },
+    "./components/*": {
+      "types": "./dist/components/ui/*.d.ts",
+      "default": "./dist/components/ui/*.js"
+    },
+    "./blocks": {
+      "types": "./dist/blocks/index.d.ts",
+      "default": "./dist/blocks/index.js"
+    },
+    "./blocks/*": {
+      "types": "./dist/blocks/*/index.d.ts",
+      "default": "./dist/blocks/*/index.js"
+    },
+    "./pages": {
+      "types": "./dist/pages/index.d.ts",
+      "default": "./dist/pages/index.js"
+    },
+    "./pages/*": {
+      "types": "./dist/pages/*/index.d.ts",
+      "default": "./dist/pages/*/index.js"
+    },
+    "./theming": {
+      "types": "./dist/theming/index.d.ts",
+      "default": "./dist/theming/index.js"
+    },
+    "./catalog": {
+      "types": "./dist/catalog.d.ts",
+      "default": "./dist/catalog.js"
+    },
+    "./styles.css": "./dist/styles.css",
     "./package.json": "./package.json"
   },
   "files": [
-    "src",
-    "registry.json",
-    "public/r",
-    "components.json"
+    "dist",
+    "THIRD-PARTY-NOTICES.md"
   ],
+  "engines": {
+    "node": ">=22.14.0"
+  },
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "sync": "node scripts/sync-registry.mjs",
-    "validate": "node scripts/validate-registry.mjs",
-    "build": "pnpm sync && pnpm validate && shadcn build",
-    "typecheck": "tsc --noEmit"
-  },
   "dependencies": {
     "@base-ui/react": "^1.0.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.545.0",
-    "tailwind-merge": "^3.3.1"
+    "tailwind-merge": "^3.3.1",
+    "@nanisoft/prism-tokens": "0.6.0"
   },
   "devDependencies": {
+    "@tailwindcss/postcss": "^4.3.3",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/user-event": "^14.6.1",
     "@types/node": "^22.0.0",
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",
+    "axe-core": "^4.13.0",
+    "esbuild": "^0.28.0",
+    "jsdom": "^26.1.0",
+    "postcss": "^8.5.28",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
     "shadcn": "^3.6.0",
-    "typescript": "^5.7.0"
+    "tailwindcss": "^4.3.3",
+    "typescript": "^5.7.0",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "sync": "node scripts/sync-registry.mjs",
+    "validate": "node scripts/validate-registry.mjs",
+    "build": "node scripts/build.mjs && pnpm sync && pnpm validate && node scripts/check-catalogue.mjs && shadcn build && node scripts/check-surface.mjs && node scripts/check-focus-indicators.mjs && node scripts/check-item-docs.mjs && node scripts/check-block-copy.mjs && node scripts/check-item-category.mjs && node scripts/check-block-imports.mjs",
+    "check": "node scripts/validate-registry.mjs && node scripts/check-catalogue.mjs && node scripts/check-surface.mjs && node scripts/check-focus-indicators.mjs && node scripts/check-pack-boundary.mjs && node scripts/check-vector-ink.mjs && node scripts/check-client-budget.mjs && node scripts/check-theme-resolution.mjs && node scripts/check-boot-budget.mjs && node scripts/check-item-docs.mjs && node scripts/check-block-copy.mjs && node scripts/check-item-category.mjs && node scripts/check-block-imports.mjs",
+    "check:vector-ink": "node scripts/check-vector-ink.mjs",
+    "check:client-budget": "node scripts/check-client-budget.mjs",
+    "check:pack-boundary": "node scripts/check-pack-boundary.mjs",
+    "check:theme-resolution": "node scripts/check-theme-resolution.mjs",
+    "check:boot-budget": "node scripts/check-boot-budget.mjs",
+    "check:catalogue": "node scripts/check-catalogue.mjs",
+    "check:focus-indicators": "node scripts/check-focus-indicators.mjs",
+    "check:item-docs": "node scripts/check-item-docs.mjs",
+    "check:block-copy": "node scripts/check-block-copy.mjs",
+    "check:item-category": "node scripts/check-item-category.mjs",
+    "check:block-imports": "node scripts/check-block-imports.mjs",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
-}
+}

package/components.json

@@ -1,21 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "base-nova",
-  "rsc": true,
-  "tsx": true,
-  "tailwind": {
-    "config": "",
-    "css": "src/app/globals.css",
-    "baseColor": "neutral",
-    "cssVariables": true,
-    "prefix": ""
-  },
-  "iconLibrary": "lucide",
-  "aliases": {
-    "components": "@/components",
-    "utils": "@/lib/utils",
-    "ui": "@/components/ui",
-    "lib": "@/lib",
-    "hooks": "@/hooks"
-  }
-}

package/public/r/badge.json

@@ -1,26 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "badge",
-  "title": "Badge",
-  "description": "Shared badge primitive. Installed automatically as a dependency of any block that uses it.",
-  "dependencies": [
-    "class-variance-authority",
-    "clsx",
-    "tailwind-merge"
-  ],
-  "files": [
-    {
-      "path": "src/components/ui/badge.tsx",
-      "content": "import { cva, type VariantProps } from 'class-variance-authority'\nimport type { ComponentProps } from 'react'\n\nimport { cn } from '@/lib/utils'\n\nconst badgeVariants = cva(\n  'inline-flex w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded-md border px-2 py-0.5 text-xs font-medium whitespace-nowrap transition-colors',\n  {\n    variants: {\n      variant: {\n        default: 'bg-primary text-primary-foreground border-transparent',\n        secondary: 'bg-secondary text-secondary-foreground border-transparent',\n        destructive: 'bg-destructive text-destructive-foreground border-transparent',\n        success: 'bg-success text-success-foreground border-transparent',\n        warning: 'bg-warning text-warning-foreground border-transparent',\n        outline: 'text-foreground border-border',\n      },\n    },\n    defaultVariants: { variant: 'default' },\n  },\n)\n\nfunction Badge({\n  className,\n  variant,\n  ...props\n}: ComponentProps<'span'> & VariantProps<typeof badgeVariants>) {\n  return (\n    <span\n      data-slot=\"badge\"\n      className={cn(badgeVariants({ variant }), className)}\n      {...props}\n    />\n  )\n}\n\nexport { Badge, badgeVariants }\n",
-      "type": "registry:component",
-      "target": "components/ui/badge.tsx"
-    },
-    {
-      "path": "src/lib/utils.ts",
-      "content": "import { type ClassValue, clsx } from 'clsx'\nimport { twMerge } from 'tailwind-merge'\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs))\n}\n",
-      "type": "registry:lib",
-      "target": "lib/utils.ts"
-    }
-  ],
-  "type": "registry:component"
-}

package/public/r/button.json

@@ -1,26 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "button",
-  "title": "Button",
-  "description": "Shared button primitive. Installed automatically as a dependency of any block that uses it.",
-  "dependencies": [
-    "class-variance-authority",
-    "clsx",
-    "tailwind-merge"
-  ],
-  "files": [
-    {
-      "path": "src/components/ui/button.tsx",
-      "content": "import { cva, type VariantProps } from 'class-variance-authority'\nimport type { ComponentProps } from 'react'\n\nimport { cn } from '@/lib/utils'\n\nconst buttonVariants = cva(\n  // The focus ring is `ring-ring` at full strength, not shadcn's stock\n  // `focus-visible:ring-ring/50`. The token build pins `--ring` to a step that\n  // clears 3:1 against the surface, and half alpha throws that away: 50% of this\n  // ring composites to between 1.14:1 and 2.74:1 against every surface in all\n  // six themes and clears 3:1 in none of them, which fails WCAG 1.4.11 on the one\n  // indicator a keyboard user has. The stock value is kept here deliberately as a\n  // deviation from upstream: a consumer's button must not fail the threshold the\n  // ring exists to meet.\n  \"inline-flex shrink-0 items-center justify-center gap-2 rounded-md text-sm font-medium outline-none transition-[color,box-shadow,background-color] disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 [&_svg]:shrink-0 focus-visible:border-ring focus-visible:ring-ring focus-visible:ring-[3px] aria-invalid:ring-destructive/20 aria-invalid:border-destructive\",\n  {\n    variants: {\n      variant: {\n        default: 'bg-primary text-primary-foreground shadow-xs hover:bg-primary/90',\n        destructive:\n          'bg-destructive text-destructive-foreground shadow-xs hover:bg-destructive/90',\n        outline:\n          'border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground',\n        secondary:\n          'bg-secondary text-secondary-foreground shadow-xs hover:bg-secondary/80',\n        ghost: 'hover:bg-accent hover:text-accent-foreground',\n        // `primary` is a surface token, not a text token: in the pastel themes it\n        // compiles to a light tint (e.g. #ec88a0) that fails 4.5:1 on the page\n        // background. Link text uses the foreground and keeps the underline as its\n        // affordance, so emphasis comes from weight rather than a failing colour.\n        link: 'text-foreground underline-offset-4 hover:underline',\n      },\n      // Touch targets are enlarged by input method, not by viewport. The\n      // metrics below are the designed desktop sizes and stay untouched for\n      // mouse and trackpad; only a coarse pointer — finger or stylus — gets\n      // the 44px iOS/Android HIG target. `pointer-coarse:` compiles to\n      // `@media (pointer: coarse)` inside `@layer utilities`, which lands\n      // after the base utility in the cascade, so it wins without needing\n      // `!important` or a specificity fight.\n      //\n      // `min-w-11` is what makes the second axis safe: an icon-only `default`\n      // is `size-4` plus `px-3` = 40px wide and an icon-only `sm` is `size-4`\n      // plus `px-2.5` = 36px, so growing the height alone would still leave\n      // both under 44px across. The coarse padding step on `default` lifts the\n      // common cases clear of the floor outright, and `min-w-11` backstops\n      // whatever content a consumer passes.\n      size: {\n        default:\n          'h-9 px-4 py-2 has-[>svg]:px-3 pointer-coarse:h-11 pointer-coarse:min-w-11 pointer-coarse:px-5 pointer-coarse:has-[>svg]:px-4',\n        sm: 'h-8 gap-1.5 rounded-md px-3 has-[>svg]:px-2.5 pointer-coarse:h-11 pointer-coarse:min-w-11',\n        lg: 'h-10 rounded-md px-6 has-[>svg]:px-4 pointer-coarse:h-11',\n        icon: 'size-9 pointer-coarse:size-11',\n      },\n    },\n    defaultVariants: {\n      variant: 'default',\n      size: 'default',\n    },\n  },\n)\n\nfunction Button({\n  className,\n  variant,\n  size,\n  ...props\n}: ComponentProps<'button'> & VariantProps<typeof buttonVariants>) {\n  return (\n    <button\n      data-slot=\"button\"\n      className={cn(buttonVariants({ variant, size, className }))}\n      {...props}\n    />\n  )\n}\n\nexport { Button, buttonVariants }\n",
-      "type": "registry:component",
-      "target": "components/ui/button.tsx"
-    },
-    {
-      "path": "src/lib/utils.ts",
-      "content": "import { type ClassValue, clsx } from 'clsx'\nimport { twMerge } from 'tailwind-merge'\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs))\n}\n",
-      "type": "registry:lib",
-      "target": "lib/utils.ts"
-    }
-  ],
-  "type": "registry:component"
-}

package/public/r/card.json

@@ -1,25 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
-  "name": "card",
-  "title": "Card",
-  "description": "Shared card primitive. Installed automatically as a dependency of any block that uses it.",
-  "dependencies": [
-    "clsx",
-    "tailwind-merge"
-  ],
-  "files": [
-    {
-      "path": "src/components/ui/card.tsx",
-      "content": "import type { ComponentProps } from 'react'\n\nimport { cn } from '@/lib/utils'\n\nfunction Card({ className, ...props }: ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"card\"\n      className={cn(\n        'bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction CardHeader({ className, ...props }: ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"card-header\"\n      className={cn(\n        '@container/card-header grid auto-rows-min items-start gap-1.5 px-6',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction CardTitle({ className, ...props }: ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"card-title\"\n      className={cn('font-semibold leading-none', className)}\n      {...props}\n    />\n  )\n}\n\nfunction CardDescription({ className, ...props }: ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"card-description\"\n      className={cn('text-muted-foreground text-sm', className)}\n      {...props}\n    />\n  )\n}\n\nfunction CardContent({ className, ...props }: ComponentProps<'div'>) {\n  return <div data-slot=\"card-content\" className={cn('px-6', className)} {...props} />\n}\n\nfunction CardFooter({ className, ...props }: ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"card-footer\"\n      className={cn('flex items-center px-6', className)}\n      {...props}\n    />\n  )\n}\n\nexport { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter }\n",
-      "type": "registry:component",
-      "target": "components/ui/card.tsx"
-    },
-    {
-      "path": "src/lib/utils.ts",
-      "content": "import { type ClassValue, clsx } from 'clsx'\nimport { twMerge } from 'tailwind-merge'\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs))\n}\n",
-      "type": "registry:lib",
-      "target": "lib/utils.ts"
-    }
-  ],
-  "type": "registry:component"
-}