@teamix-evo/registry 0.3.0 → 0.6.0

package/dist/index.d.ts

@@ -223,13 +223,27 @@ declare const SkillEntrySchema: z.ZodObject<{
      * coding-conventions, baseline design-rules) leave it unset.
      *
      * When present, the CLI installs this skill ONLY if the consumer's
-     * `.teamix-evo/design/pack.lock.json` records the same variant. MUST equal
-     * the variant directory name in `@teamix-evo/design/variants/<name>/`.
+     * `.teamix-evo/tokens-lock.json` records the same variant. MUST equal
+     * the variant directory name in `@teamix-evo/tokens/variants/<name>/`.
      *
      * Mirrors `UiEntrySchema.variant` semantics in @teamix-evo/biz-ui &
      * @teamix-evo/templates per ADR 0014.
      */
     variant: z.ZodOptional<z.ZodString>;
+    /**
+     * Default install scope for this skill. Per ADR 0033.
+     *
+     * - `"global"`  — entry skill (lifecycle / orchestrator). `skills add` in
+     *                 project scope SKIPS these unless explicitly named on the
+     *                 command line (then installs with a warning). Recommended
+     *                 to install once via `skills add <id> --scope global`.
+     * - `"project"` — variant content skill (default when omitted). Installed
+     *                 with the project that uses it.
+     *
+     * `undefined` is treated as `"project"` — old manifests without this field
+     * still validate.
+     */
+    scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     source: string;
@@ -240,6 +254,7 @@ declare const SkillEntrySchema: z.ZodObject<{
     name: string;
     template?: boolean | undefined;
     managedRegions?: string[] | undefined;
+    scope?: "project" | "global" | undefined;
     variant?: string | undefined;
 }, {
     id: string;
@@ -251,6 +266,7 @@ declare const SkillEntrySchema: z.ZodObject<{
     template?: boolean | undefined;
     managedRegions?: string[] | undefined;
     ides?: ("qoder" | "claude")[] | undefined;
+    scope?: "project" | "global" | undefined;
     variant?: string | undefined;
 }>;
 /**
@@ -299,13 +315,27 @@ declare const SkillsPackageManifestSchema: z.ZodObject<{
          * coding-conventions, baseline design-rules) leave it unset.
          *
          * When present, the CLI installs this skill ONLY if the consumer's
-         * `.teamix-evo/design/pack.lock.json` records the same variant. MUST equal
-         * the variant directory name in `@teamix-evo/design/variants/<name>/`.
+         * `.teamix-evo/tokens-lock.json` records the same variant. MUST equal
+         * the variant directory name in `@teamix-evo/tokens/variants/<name>/`.
          *
          * Mirrors `UiEntrySchema.variant` semantics in @teamix-evo/biz-ui &
          * @teamix-evo/templates per ADR 0014.
          */
         variant: z.ZodOptional<z.ZodString>;
+        /**
+         * Default install scope for this skill. Per ADR 0033.
+         *
+         * - `"global"`  — entry skill (lifecycle / orchestrator). `skills add` in
+         *                 project scope SKIPS these unless explicitly named on the
+         *                 command line (then installs with a warning). Recommended
+         *                 to install once via `skills add <id> --scope global`.
+         * - `"project"` — variant content skill (default when omitted). Installed
+         *                 with the project that uses it.
+         *
+         * `undefined` is treated as `"project"` — old manifests without this field
+         * still validate.
+         */
+        scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
     }, "strip", z.ZodTypeAny, {
         id: string;
         source: string;
@@ -316,6 +346,7 @@ declare const SkillsPackageManifestSchema: z.ZodObject<{
         name: string;
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
+        scope?: "project" | "global" | undefined;
         variant?: string | undefined;
     }, {
         id: string;
@@ -327,6 +358,7 @@ declare const SkillsPackageManifestSchema: z.ZodObject<{
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
         ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
         variant?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -346,6 +378,7 @@ declare const SkillsPackageManifestSchema: z.ZodObject<{
         name: string;
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
+        scope?: "project" | "global" | undefined;
         variant?: string | undefined;
     }[];
     $schema?: string | undefined;
@@ -366,6 +399,7 @@ declare const SkillsPackageManifestSchema: z.ZodObject<{
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
         ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
         variant?: string | undefined;
     }[];
     $schema?: string | undefined;
@@ -443,8 +477,8 @@ declare const UiEntrySchema: z.ZodObject<{
     }>, "many">;
     /**
      * Optional path to an AI-readable meta document (frontmatter + Markdown).
-     * When set, CLI install drops it at `.teamix-evo/design/components/<id>.meta.md`
-     * for design's ai-rules to consume.
+     * Read directly from `@teamix-evo/ui` by MCP at runtime — no consumer-side
+     * copy is written (per ADR 0020 §3).
      */
     meta: z.ZodOptional<z.ZodString>;
     /** Other UI entries this one depends on (e.g. "button" depends on "cn") */
@@ -543,7 +577,7 @@ declare const UiPackageManifestSchema: z.ZodObject<{
     }, {
         'teamix-evo': string;
     }>;
-    /** Flat list of entries shipped by this package */
+    /** Active list of entries shipped (and exposed) by this package. */
     entries: z.ZodArray<z.ZodObject<{
         /** Unique entry identifier within the ui package (e.g. "button") */
         id: z.ZodString;
@@ -572,8 +606,8 @@ declare const UiPackageManifestSchema: z.ZodObject<{
         }>, "many">;
         /**
          * Optional path to an AI-readable meta document (frontmatter + Markdown).
-         * When set, CLI install drops it at `.teamix-evo/design/components/<id>.meta.md`
-         * for design's ai-rules to consume.
+         * Read directly from `@teamix-evo/ui` by MCP at runtime — no consumer-side
+         * copy is written (per ADR 0020 §3).
          */
         meta: z.ZodOptional<z.ZodString>;
         /** Other UI entries this one depends on (e.g. "button" depends on "cn") */
@@ -652,6 +686,123 @@ declare const UiPackageManifestSchema: z.ZodObject<{
         deprecatedReason?: string | undefined;
         replacedBy?: string | undefined;
     }>, "many">;
+    /**
+     * Archived entries that are kept in source for Storybook documentation only
+     * and are NOT exposed through the active distribution chain. Per ADR 0028:
+     *   - `teamix-evo ui add <id>` rejects ids found here unless `--include-deprecated` is passed
+     *   - MCP `list_components` / `find_components` exclude these by default
+     *   - Storybook keeps the story under `废弃 · Deprecated/` with a banner
+     * Optional for backwards compatibility — older manifests without this field
+     * still validate.
+     */
+    deprecatedEntries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Unique entry identifier within the ui package (e.g. "button") */
+        id: z.ZodString;
+        /** Display name (e.g. "Button") */
+        name: z.ZodString;
+        /** Entry type */
+        type: z.ZodEnum<["component", "hook", "util", "block", "template"]>;
+        /** One-line description for entry discovery and AI guidance */
+        description: z.ZodString;
+        /** Files this entry ships (typically 1) */
+        files: z.ZodArray<z.ZodObject<{
+            /** Source path relative to the ui package root (e.g. "src/components/button/button.tsx") */
+            source: z.ZodString;
+            /** Which alias this file resolves under in the consumer project */
+            targetAlias: z.ZodEnum<["components", "hooks", "utils", "lib", "business", "templates"]>;
+            /** Filename written under the alias directory (e.g. "button.tsx") */
+            targetName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }, {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }>, "many">;
+        /**
+         * Optional path to an AI-readable meta document (frontmatter + Markdown).
+         * Read directly from `@teamix-evo/ui` by MCP at runtime — no consumer-side
+         * copy is written (per ADR 0020 §3).
+         */
+        meta: z.ZodOptional<z.ZodString>;
+        /** Other UI entries this one depends on (e.g. "button" depends on "cn") */
+        registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** npm dependencies required by this entry (name → semver range) */
+        dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /**
+         * How CLI handles this entry on `ui upgrade`.
+         * Defaults to `frozen` — user-owned source code, untouched after first install.
+         * Upgrade is handled by AI + skill flow (no CLI rewrite). See PLAN §10.9.
+         */
+        updateStrategy: z.ZodDefault<z.ZodEnum<["frozen", "regenerable", "managed"]>>;
+        /**
+         * Whether the source file should be passed through Handlebars before write.
+         * Most entries don't need templating (use import-rewrite transformer instead).
+         */
+        template: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * Maturity / lifecycle status of this entry. Defaults to `stable`.
+         * See {@link UiEntryStatusSchema} for semantics.
+         */
+        status: z.ZodDefault<z.ZodEnum<["stable", "experimental", "deprecated"]>>;
+        /**
+         * Free-text rationale shown to consumers when `status` is `deprecated`.
+         * Should explain why the entry is going away and what replaces it.
+         */
+        deprecatedReason: z.ZodOptional<z.ZodString>;
+        /**
+         * If this entry is `deprecated`, the id of the entry that supersedes it.
+         * Consumers (and AI) should migrate to `replacedBy` rather than this entry.
+         */
+        replacedBy: z.ZodOptional<z.ZodString>;
+        /**
+         * Variant identifier when this entry is shipped from a variant-aware
+         * package (`@teamix-evo/biz-ui` or `@teamix-evo/templates` per ADR 0014).
+         * Optional — entries from `@teamix-evo/ui` (variant-agnostic) leave it unset.
+         * MUST equal the variant directory name when present.
+         */
+        variant: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        status: "stable" | "experimental" | "deprecated";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        template?: boolean | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }, {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+        template?: boolean | undefined;
+        status?: "stable" | "experimental" | "deprecated" | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     entries: {
         id: string;
@@ -680,6 +831,26 @@ declare const UiPackageManifestSchema: z.ZodObject<{
         'teamix-evo': string;
     };
     $schema?: string | undefined;
+    deprecatedEntries?: {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        status: "stable" | "experimental" | "deprecated";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        template?: boolean | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }[] | undefined;
 }, {
     entries: {
         id: string;
@@ -708,53 +879,60 @@ declare const UiPackageManifestSchema: z.ZodObject<{
         'teamix-evo': string;
     };
     $schema?: string | undefined;
+    deprecatedEntries?: {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+        template?: boolean | undefined;
+        status?: "stable" | "experimental" | "deprecated" | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }[] | undefined;
 }>;
 
 /**
- * Design Pack manifest schema.
- *
- * Per [ADR 0010](../../../../docs/adr/0010-design-default-and-variants.md) the
- * design system is structured as one **default** baseline + N **variants**:
+ * `@teamix-evo/tokens` package manifest schema.
  *
- *   packages/design/
- *     ├── default/                <- B-end neutral baseline (always present)
- *     │   ├── pack.json           <- this schema (no `extends`)
- *     │   └── ... (philosophy/, foundations/, patterns/, scenarios/)
- *     ├── variants/
- *     │   ├── _template/          <- minimal scaffold for new variants
- *     │   │   └── pack.json       <- this schema, extends: "default"
- *     │   ├── opentrek/
- *     │   │   ├── pack.json       <- this schema, extends: "default"
- *     │   │   └── ... (only files differing from default)
- *     │   └── uni-manager/
- *     │       └── pack.json
- *     └── manifest.json           <- top-level catalog (lists default + variants)
+ * Per [ADR 0020](../../../../docs/adr/0020-design-to-tokens-skill-fusion.md)
+ * the package is now a pure, variant-list catalog — no `default/` baseline,
+ * no per-variant `pack.json`, no walk-and-merge inheritance:
  *
- * The `pack.json` carries **only the protocol identity** of one pack; file
- * lists are NOT declared here — the loader walks the filesystem under the
- * pack root and lets file-level override merge happen at install time.
+ *   packages/tokens/
+ *     ├── manifest.json           <- this schema (top-level catalog)
+ *     └── variants/
+ *         ├── opentrek/
+ *         │   ├── theme.css       <- Tailwind v4 @theme source of truth
+ *         │   └── base.tokens.json
+ *         └── uni-manager/
+ *             ├── theme.css
+ *             └── base.tokens.json
  *
- * Rationale: variant authors who add a new file (e.g. a new Markdown pattern)
- * shouldn't have to register it in `pack.json`. The filesystem is the single
- * source of truth (P2). See ADR 0010 §7 for the schema-simplification
- * rationale.
+ * Each variant is a complete, self-contained token set (ADR 0020 §3). The
+ * catalog is the single source of truth for variant identity + advertised
+ * files; the validator (`packages/tokens/scripts/validate-variants.ts`)
+ * enforces parity between catalog entries and on-disk variant directories.
  */
 
 /**
- * Soft cross-package links advertised by a design pack.
- *
- * When a consumer installs design `<variant>`, the CLI MAY check that the
- * matching biz-ui / templates variant exists in the workspace / npm and
- * prompt the user to install it too. The link is **soft** — packs may exist
- * without their biz-ui or templates counterparts, especially in early
- * development.
+ * Soft cross-package links advertised by a variant.
  *
  * Format: `<package-spec>#<variant-name>`, e.g. `@teamix-evo/biz-ui#opentrek`.
+ * The link is **soft** — the linked package may not exist yet.
  *
- * Linked field for `templates` added per [ADR 0014 2026-05-18 amendment](../../../../docs/adr/0014-ui-biz-ui-templates-tier.md)
- * (templates became variant-aware mirroring biz-ui).
+ * Templates link added per [ADR 0014 amendment](../../../../docs/adr/0014-ui-biz-ui-templates-tier.md).
  */
-declare const DesignPackLinkedSchema: z.ZodObject<{
+declare const TokensPackLinkedSchema: z.ZodObject<{
     'biz-ui': z.ZodOptional<z.ZodString>;
     templates: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -765,32 +943,24 @@ declare const DesignPackLinkedSchema: z.ZodObject<{
     'biz-ui'?: string | undefined;
 }>;
 /**
- * Design pack manifest schema.
- *
- * Describes ONE pack (either the default baseline or one variant). Files are
- * not declared — the loader walks the pack root.
+ * One variant entry in the top-level catalog.
  */
-declare const DesignPackManifestSchema: z.ZodObject<{
-    $schema: z.ZodOptional<z.ZodString>;
-    schemaVersion: z.ZodLiteral<1>;
-    /**
-     * Pack identifier.
-     * - `"default"` for the built-in baseline (only valid name when `extends` is absent)
-     * - lowercase kebab-case for variants (`opentrek`, `uni-manager`, `acme-erp`, `_template`)
-     */
-    name: z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodLiteral<"_template">]>, z.ZodLiteral<"default">]>;
+declare const TokensVariantEntrySchema: z.ZodObject<{
+    /** Variant id — lowercase kebab-case. */
+    name: z.ZodString;
     /** Human-readable display name (e.g. "OpenTrek" for variant id "opentrek"). */
     displayName: z.ZodString;
-    /** Semver. */
+    /** Variant version — semver. May trail the package version when only a subset of variants change. */
     version: z.ZodString;
+    /** Optional one-liner description; surfaced in `tokens list-variants` output. */
+    description: z.ZodOptional<z.ZodString>;
     /**
-     * Parent pack name. Required for variants, must be omitted for `default`.
-     * Currently only `"default"` is a valid parent.
+     * Files this variant advertises, paths relative to the tokens package root
+     * (e.g. `variants/opentrek/theme.css`). The validator walks these to
+     * confirm presence; the CLI consumes them at install time.
      */
-    extends: z.ZodOptional<z.ZodString>;
-    /** Optional one-liner; useful for `design list-variants` output. */
-    description: z.ZodOptional<z.ZodString>;
-    /** Soft cross-package links (biz-ui / templates with same variant name). */
+    files: z.ZodArray<z.ZodString, "many">;
+    /** Soft cross-package links (biz-ui / templates with the same variant name). */
     linked: z.ZodOptional<z.ZodObject<{
         'biz-ui': z.ZodOptional<z.ZodString>;
         templates: z.ZodOptional<z.ZodString>;
@@ -802,46 +972,42 @@ declare const DesignPackManifestSchema: z.ZodObject<{
         'biz-ui'?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: 1;
     displayName: string;
     version: string;
     name: string;
-    $schema?: string | undefined;
+    files: string[];
     description?: string | undefined;
-    extends?: string | undefined;
     linked?: {
         templates?: string | undefined;
         'biz-ui'?: string | undefined;
     } | undefined;
 }, {
-    schemaVersion: 1;
     displayName: string;
     version: string;
     name: string;
-    $schema?: string | undefined;
+    files: string[];
     description?: string | undefined;
-    extends?: string | undefined;
     linked?: {
         templates?: string | undefined;
         'biz-ui'?: string | undefined;
     } | undefined;
 }>;
-type DesignPackManifest = z.infer<typeof DesignPackManifestSchema>;
-type DesignPackLinked = z.infer<typeof DesignPackLinkedSchema>;
+type TokensVariantEntry = z.infer<typeof TokensVariantEntrySchema>;
+type TokensPackLinked = z.infer<typeof TokensPackLinkedSchema>;
 /**
- * Top-level catalog of all packs in `@teamix-evo/design`.
+ * Top-level catalog of all variants in `@teamix-evo/tokens`.
  *
- * Lives at `packages/design/manifest.json`. Lists the default baseline + all
- * variants the package ships. The catalog is regenerable via
- * `pnpm --filter @teamix-evo/design validate` — variant directories are the
- * source of truth.
+ * Lives at `packages/tokens/manifest.json`. Lists every variant the package
+ * ships. The catalog is hand-edited (or regenerable via
+ * `pnpm --filter @teamix-evo/tokens validate`); variant directories on disk
+ * are the source of truth for file content.
  */
-declare const DesignPackageManifestSchema: z.ZodObject<{
+declare const TokensPackageManifestSchema: z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
     schemaVersion: z.ZodLiteral<1>;
-    /** Always `"design"` for this package. */
-    package: z.ZodLiteral<"design">;
-    /** Semver of the entire design package. */
+    /** Always `"tokens"` — disambiguates from other teamix-evo package manifests. */
+    package: z.ZodLiteral<"tokens">;
+    /** Semver of the entire tokens package. */
     version: z.ZodString;
     /** Engine compatibility. */
     engines: z.ZodObject<{
@@ -851,85 +1017,25 @@ declare const DesignPackageManifestSchema: z.ZodObject<{
     }, {
         'teamix-evo': string;
     }>;
-    /** The default baseline pack — always present. */
-    default: z.ZodObject<{
-        $schema: z.ZodOptional<z.ZodString>;
-        schemaVersion: z.ZodLiteral<1>;
-        /**
-         * Pack identifier.
-         * - `"default"` for the built-in baseline (only valid name when `extends` is absent)
-         * - lowercase kebab-case for variants (`opentrek`, `uni-manager`, `acme-erp`, `_template`)
-         */
-        name: z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodLiteral<"_template">]>, z.ZodLiteral<"default">]>;
-        /** Human-readable display name (e.g. "OpenTrek" for variant id "opentrek"). */
-        displayName: z.ZodString;
-        /** Semver. */
-        version: z.ZodString;
-        /**
-         * Parent pack name. Required for variants, must be omitted for `default`.
-         * Currently only `"default"` is a valid parent.
-         */
-        extends: z.ZodOptional<z.ZodString>;
-        /** Optional one-liner; useful for `design list-variants` output. */
-        description: z.ZodOptional<z.ZodString>;
-        /** Soft cross-package links (biz-ui / templates with same variant name). */
-        linked: z.ZodOptional<z.ZodObject<{
-            'biz-ui': z.ZodOptional<z.ZodString>;
-            templates: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            templates?: string | undefined;
-            'biz-ui'?: string | undefined;
-        }, {
-            templates?: string | undefined;
-            'biz-ui'?: string | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        schemaVersion: 1;
-        displayName: string;
-        version: string;
-        name: string;
-        $schema?: string | undefined;
-        description?: string | undefined;
-        extends?: string | undefined;
-        linked?: {
-            templates?: string | undefined;
-            'biz-ui'?: string | undefined;
-        } | undefined;
-    }, {
-        schemaVersion: 1;
-        displayName: string;
-        version: string;
-        name: string;
-        $schema?: string | undefined;
-        description?: string | undefined;
-        extends?: string | undefined;
-        linked?: {
-            templates?: string | undefined;
-            'biz-ui'?: string | undefined;
-        } | undefined;
-    }>;
-    /** All shipped variants (excluding `_template/`). */
+    /** Optional package-level description. */
+    description: z.ZodOptional<z.ZodString>;
+    /** All shipped variants (excluding scaffold dirs that begin with `_`). */
     variants: z.ZodArray<z.ZodObject<{
-        $schema: z.ZodOptional<z.ZodString>;
-        schemaVersion: z.ZodLiteral<1>;
-        /**
-         * Pack identifier.
-         * - `"default"` for the built-in baseline (only valid name when `extends` is absent)
-         * - lowercase kebab-case for variants (`opentrek`, `uni-manager`, `acme-erp`, `_template`)
-         */
-        name: z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodLiteral<"_template">]>, z.ZodLiteral<"default">]>;
+        /** Variant id — lowercase kebab-case. */
+        name: z.ZodString;
         /** Human-readable display name (e.g. "OpenTrek" for variant id "opentrek"). */
         displayName: z.ZodString;
-        /** Semver. */
+        /** Variant version — semver. May trail the package version when only a subset of variants change. */
         version: z.ZodString;
+        /** Optional one-liner description; surfaced in `tokens list-variants` output. */
+        description: z.ZodOptional<z.ZodString>;
         /**
-         * Parent pack name. Required for variants, must be omitted for `default`.
-         * Currently only `"default"` is a valid parent.
+         * Files this variant advertises, paths relative to the tokens package root
+         * (e.g. `variants/opentrek/theme.css`). The validator walks these to
+         * confirm presence; the CLI consumes them at install time.
          */
-        extends: z.ZodOptional<z.ZodString>;
-        /** Optional one-liner; useful for `design list-variants` output. */
-        description: z.ZodOptional<z.ZodString>;
-        /** Soft cross-package links (biz-ui / templates with same variant name). */
+        files: z.ZodArray<z.ZodString, "many">;
+        /** Soft cross-package links (biz-ui / templates with the same variant name). */
         linked: z.ZodOptional<z.ZodObject<{
             'biz-ui': z.ZodOptional<z.ZodString>;
             templates: z.ZodOptional<z.ZodString>;
@@ -941,121 +1047,85 @@ declare const DesignPackageManifestSchema: z.ZodObject<{
             'biz-ui'?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: 1;
         displayName: string;
         version: string;
         name: string;
-        $schema?: string | undefined;
+        files: string[];
         description?: string | undefined;
-        extends?: string | undefined;
         linked?: {
             templates?: string | undefined;
             'biz-ui'?: string | undefined;
         } | undefined;
     }, {
-        schemaVersion: 1;
         displayName: string;
         version: string;
         name: string;
-        $schema?: string | undefined;
+        files: string[];
         description?: string | undefined;
-        extends?: string | undefined;
         linked?: {
             templates?: string | undefined;
             'biz-ui'?: string | undefined;
         } | undefined;
     }>, "many">;
+    /**
+     * Reserved for future shared assets that span variants (e.g. browser
+     * quirks resets co-shipped at the package root). Empty array today.
+     */
+    shared: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     schemaVersion: 1;
-    package: "design";
+    package: "tokens";
     version: string;
     engines: {
         'teamix-evo': string;
     };
-    default: {
-        schemaVersion: 1;
-        displayName: string;
-        version: string;
-        name: string;
-        $schema?: string | undefined;
-        description?: string | undefined;
-        extends?: string | undefined;
-        linked?: {
-            templates?: string | undefined;
-            'biz-ui'?: string | undefined;
-        } | undefined;
-    };
     variants: {
-        schemaVersion: 1;
         displayName: string;
         version: string;
         name: string;
-        $schema?: string | undefined;
+        files: string[];
         description?: string | undefined;
-        extends?: string | undefined;
         linked?: {
             templates?: string | undefined;
             'biz-ui'?: string | undefined;
         } | undefined;
     }[];
     $schema?: string | undefined;
+    description?: string | undefined;
+    shared?: string[] | undefined;
 }, {
     schemaVersion: 1;
-    package: "design";
+    package: "tokens";
     version: string;
     engines: {
         'teamix-evo': string;
     };
-    default: {
-        schemaVersion: 1;
-        displayName: string;
-        version: string;
-        name: string;
-        $schema?: string | undefined;
-        description?: string | undefined;
-        extends?: string | undefined;
-        linked?: {
-            templates?: string | undefined;
-            'biz-ui'?: string | undefined;
-        } | undefined;
-    };
     variants: {
-        schemaVersion: 1;
         displayName: string;
         version: string;
         name: string;
-        $schema?: string | undefined;
+        files: string[];
         description?: string | undefined;
-        extends?: string | undefined;
         linked?: {
             templates?: string | undefined;
             'biz-ui'?: string | undefined;
         } | undefined;
     }[];
     $schema?: string | undefined;
+    description?: string | undefined;
+    shared?: string[] | undefined;
 }>;
-type DesignPackageManifest = z.infer<typeof DesignPackageManifestSchema>;
+type TokensPackageManifest = z.infer<typeof TokensPackageManifestSchema>;
 /**
  * Consumer-side lock file written to
- * `.teamix-evo/design/pack.lock.json` after `design init`.
+ * `.teamix-evo/tokens-lock.json` after `tokens init`.
  *
- * Records which default + variant version was installed so future
- * `design upgrade` / `doctor` / AI tooling can reason about install state
- * without re-walking the source.
+ * Records which tokens variant + version was installed. There is no longer a
+ * `default` field — every variant is self-contained per ADR 0020.
  */
-declare const DesignPackLockSchema: z.ZodObject<{
+declare const TokensPackLockSchema: z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
     schemaVersion: z.ZodLiteral<1>;
-    default: z.ZodObject<{
-        version: z.ZodString;
-        from: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        version: string;
-        from: string;
-    }, {
-        version: string;
-        from: string;
-    }>;
     variant: z.ZodObject<{
         name: z.ZodString;
         displayName: z.ZodString;
@@ -1072,6 +1142,8 @@ declare const DesignPackLockSchema: z.ZodObject<{
         name: string;
         from: string;
     }>;
+    /** Tokens package version — useful when variant version trails the package. */
+    packageVersion: z.ZodString;
     linked: z.ZodOptional<z.ZodObject<{
         'biz-ui': z.ZodOptional<z.ZodString>;
         templates: z.ZodOptional<z.ZodString>;
@@ -1091,10 +1163,7 @@ declare const DesignPackLockSchema: z.ZodObject<{
         name: string;
         from: string;
     };
-    default: {
-        version: string;
-        from: string;
-    };
+    packageVersion: string;
     installedAt: string;
     $schema?: string | undefined;
     linked?: {
@@ -1109,10 +1178,7 @@ declare const DesignPackLockSchema: z.ZodObject<{
         name: string;
         from: string;
     };
-    default: {
-        version: string;
-        from: string;
-    };
+    packageVersion: string;
     installedAt: string;
     $schema?: string | undefined;
     linked?: {
@@ -1120,14 +1186,14 @@ declare const DesignPackLockSchema: z.ZodObject<{
         'biz-ui'?: string | undefined;
     } | undefined;
 }>;
-type DesignPackLock = z.infer<typeof DesignPackLockSchema>;
+type TokensPackLock = z.infer<typeof TokensPackLockSchema>;
 
 /**
  * Schemas for variant-aware UI packages — `@teamix-evo/biz-ui` and
  * `@teamix-evo/templates`.
  *
  * Per [ADR 0014](../../../../docs/adr/0014-ui-biz-ui-templates-tier.md), these
- * two packages mirror `@teamix-evo/design`'s variant model: each ships a
+ * two packages mirror `@teamix-evo/tokens`'s variant model: each ships a
  * top-level catalog (variants list) plus a per-variant manifest (entry list).
  *
  *   packages/biz-ui/
@@ -1468,7 +1534,7 @@ declare const UiAliasesSchema: z.ZodObject<{
  * Package entry within a project config.
  *
  * Some fields only apply to specific packages:
- * - `tailwind` — design only
+ * - `tailwind` — tokens only
  * - `ides` / `scope` — skills only
  * - `aliases` / `iconLibrary` / `tsx` / `rsc` — ui only
  *
@@ -1729,7 +1795,7 @@ declare const InstalledResourceSchema: z.ZodObject<{
  * An installed package entry — tracks a single package installation.
  */
 declare const InstalledPackageSchema: z.ZodObject<{
-    /** Full package name (e.g. "@teamix-evo/design") */
+    /** Full package name (e.g. "@teamix-evo/tokens") */
     package: z.ZodString;
     /** Variant identifier (use "_flat" for non-variant packages such as skills) */
     variant: z.ZodString;
@@ -1801,7 +1867,7 @@ declare const InstalledManifestSchema: z.ZodObject<{
     schemaVersion: z.ZodLiteral<1>;
     /** List of installed packages */
     installed: z.ZodArray<z.ZodObject<{
-        /** Full package name (e.g. "@teamix-evo/design") */
+        /** Full package name (e.g. "@teamix-evo/tokens") */
         package: z.ZodString;
         /** Variant identifier (use "_flat" for non-variant packages such as skills) */
         variant: z.ZodString;
@@ -2096,54 +2162,15 @@ declare function loadSkillsPackageManifest(packageDir: string): Promise<SkillsPa
 declare function loadUiPackageManifest(packageDir: string): Promise<UiPackageManifest>;
 
 /**
- * Read & validate a single pack's `pack.json`.
+ * Read & validate the top-level `packages/tokens/manifest.json` catalog.
  * Errors are wrapped with the file path for easy diagnosis (P8).
  */
-declare function loadDesignPack(packDir: string): Promise<DesignPackManifest>;
-/**
- * Read & validate the top-level `packages/design/manifest.json` catalog.
- */
-declare function loadDesignPackageManifest(packageDir: string): Promise<DesignPackageManifest>;
-/**
- * Walk all files under a pack root and return their paths **relative to
- * `packDir`**, excluding pack metadata files (`pack.json`).
- *
- * Returns a sorted list (deterministic for tests + diff-friendly).
- */
-declare function walkPackTree(packDir: string): Promise<string[]>;
-/**
- * Result of merging default + variant: each entry is a file the CLI should
- * install, paired with which on-disk file to read.
- */
-interface MergedFileEntry {
-    /** Path relative to the pack root (e.g. `philosophy/principles.md`). */
-    relPath: string;
-    /** Absolute filesystem path the CLI should read. */
-    sourcePath: string;
-    /** Which pack provided this file (for diagnostics + UI listing). */
-    origin: 'default' | 'variant';
-}
-interface MergeResult {
-    files: MergedFileEntry[];
-    /** Files where variant overrode default. Useful for diagnostics. */
-    overrides: string[];
-    /** Files only in variant (no default counterpart). */
-    variantAdds: string[];
-    /** Files only in default (variant didn't override). */
-    defaultPassThrough: string[];
-}
+declare function loadTokensPackageManifest(packageDir: string): Promise<TokensPackageManifest>;
 /**
- * File-level merge per ADR 0010 §4.
- *
- * For each file path P:
- *   - If `<variantDir>/P` exists: use the variant's file (override).
- *   - Else: use the default's file (pass-through).
- * Plus: every file in variant tree NOT present in default tree is appended
- * (variant-add).
- *
- * No content parsing happens here — files are read as-is by the caller.
+ * Lookup helper: find one variant entry in a catalog by name.
+ * Returns `undefined` when the variant is not advertised.
  */
-declare function mergeDefaultAndVariant(defaultDir: string, variantDir: string): Promise<MergeResult>;
+declare function getVariantEntry(catalog: TokensPackageManifest, variantName: string): TokensVariantEntry | undefined;
 
 declare function loadVariantUiPackageCatalog(packageDir: string): Promise<VariantUiPackageCatalog>;
 declare function loadVariantUiPackageManifest(variantDir: string): Promise<VariantUiPackageManifest>;
@@ -2252,4 +2279,4 @@ interface UpdateActionOptions {
  */
 declare function getUpdateAction(strategy: UpdateStrategy, options: UpdateActionOptions): UpdateAction;
 
-export { type DesignPackLinked, DesignPackLinkedSchema, type DesignPackLock, DesignPackLockSchema, type DesignPackManifest, DesignPackManifestSchema, type DesignPackageManifest, DesignPackageManifestSchema, type InstalledManifest, InstalledManifestSchema, type InstalledPackage, InstalledPackageSchema, type InstalledResource, InstalledResourceSchema, type ManagedRegion, type MergeResult, type MergedFileEntry, type PackageEntry, PackageEntrySchema, type ProjectConfig, ProjectConfigSchema, type Resource, ResourceSchema, type ResourceType, ResourceTypeSchema, type Result, type SkillEntry, SkillEntrySchema, type SkillIde, SkillIdeSchema, type SkillScope, SkillScopeSchema, type SkillsLock, type SkillsLockEntry, SkillsLockEntrySchema, SkillsLockSchema, type SkillsPackageManifest, SkillsPackageManifestSchema, type TailwindVersion, TailwindVersionSchema, type UiAlias, UiAliasSchema, type UiAliases, UiAliasesSchema, type UiEntry, type UiEntryFile, UiEntryFileSchema, UiEntrySchema, type UiEntryType, UiEntryTypeSchema, type UiPackageManifest, UiPackageManifestSchema, type UpdateAction, type UpdateActionOptions, type UpdateStrategy, UpdateStrategySchema, type VariantManifest, VariantManifestSchema, type VariantUiPackageCatalog, VariantUiPackageCatalogSchema, type VariantUiPackageManifest, VariantUiPackageManifestSchema, type VariantUiPackageName, VariantUiPackageNameSchema, getUpdateAction, hasManagedRegion, loadDesignPack, loadDesignPackageManifest, loadSkillsPackageManifest, loadUiPackageManifest, loadVariantManifest, loadVariantUiPackageCatalog, loadVariantUiPackageManifest, mergeDefaultAndVariant, parseManagedRegions, replaceManagedRegion, resolveUiEntryOrder, shouldUpdate, validateConfig, validateInstalled, validateManifest, validateSkillsLock, validateSkillsPackage, validateUiDependencyGraph, validateUiPackage, walkPackTree };
+export { type InstalledManifest, InstalledManifestSchema, type InstalledPackage, InstalledPackageSchema, type InstalledResource, InstalledResourceSchema, type ManagedRegion, type PackageEntry, PackageEntrySchema, type ProjectConfig, ProjectConfigSchema, type Resource, ResourceSchema, type ResourceType, ResourceTypeSchema, type Result, type SkillEntry, SkillEntrySchema, type SkillIde, SkillIdeSchema, type SkillScope, SkillScopeSchema, type SkillsLock, type SkillsLockEntry, SkillsLockEntrySchema, SkillsLockSchema, type SkillsPackageManifest, SkillsPackageManifestSchema, type TailwindVersion, TailwindVersionSchema, type TokensPackLinked, TokensPackLinkedSchema, type TokensPackLock, TokensPackLockSchema, type TokensPackageManifest, TokensPackageManifestSchema, type TokensVariantEntry, TokensVariantEntrySchema, type UiAlias, UiAliasSchema, type UiAliases, UiAliasesSchema, type UiEntry, type UiEntryFile, UiEntryFileSchema, UiEntrySchema, type UiEntryType, UiEntryTypeSchema, type UiPackageManifest, UiPackageManifestSchema, type UpdateAction, type UpdateActionOptions, type UpdateStrategy, UpdateStrategySchema, type VariantManifest, VariantManifestSchema, type VariantUiPackageCatalog, VariantUiPackageCatalogSchema, type VariantUiPackageManifest, VariantUiPackageManifestSchema, type VariantUiPackageName, VariantUiPackageNameSchema, getUpdateAction, getVariantEntry, hasManagedRegion, loadSkillsPackageManifest, loadTokensPackageManifest, loadUiPackageManifest, loadVariantManifest, loadVariantUiPackageCatalog, loadVariantUiPackageManifest, parseManagedRegions, replaceManagedRegion, resolveUiEntryOrder, shouldUpdate, validateConfig, validateInstalled, validateManifest, validateSkillsLock, validateSkillsPackage, validateUiDependencyGraph, validateUiPackage };