@teamix-evo/registry 0.2.0 → 0.5.0

package/dist/index.d.ts

@@ -217,6 +217,19 @@ declare const SkillEntrySchema: z.ZodObject<{
     managedRegions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /** Whether the source is a Handlebars template */
     template: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Variant identifier when this skill is bound to a specific design variant
+     * (e.g. `"opentrek"`, `"uni-manager"`). Optional — neutral skills (manage,
+     * coding-conventions, baseline design-rules) leave it unset.
+     *
+     * When present, the CLI installs this skill ONLY if the consumer's
+     * `.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>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     source: string;
@@ -227,6 +240,7 @@ declare const SkillEntrySchema: z.ZodObject<{
     name: string;
     template?: boolean | undefined;
     managedRegions?: string[] | undefined;
+    variant?: string | undefined;
 }, {
     id: string;
     source: string;
@@ -237,10 +251,12 @@ declare const SkillEntrySchema: z.ZodObject<{
     template?: boolean | undefined;
     managedRegions?: string[] | undefined;
     ides?: ("qoder" | "claude")[] | undefined;
+    variant?: string | undefined;
 }>;
 /**
  * Skills package manifest schema — top-level manifest of `@teamix-evo/skills`.
- * Unlike design which is variant-based, skills are flat (no variants).
+ * Skills are stored flat in the manifest. Variant binding is expressed via
+ * the optional `variant` field on each entry (see SkillEntrySchema).
  */
 declare const SkillsPackageManifestSchema: z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
@@ -277,6 +293,19 @@ declare const SkillsPackageManifestSchema: z.ZodObject<{
         managedRegions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         /** Whether the source is a Handlebars template */
         template: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * Variant identifier when this skill is bound to a specific design variant
+         * (e.g. `"opentrek"`, `"uni-manager"`). Optional — neutral skills (manage,
+         * coding-conventions, baseline design-rules) leave it unset.
+         *
+         * When present, the CLI installs this skill ONLY if the consumer's
+         * `.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>;
     }, "strip", z.ZodTypeAny, {
         id: string;
         source: string;
@@ -287,6 +316,7 @@ declare const SkillsPackageManifestSchema: z.ZodObject<{
         name: string;
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
+        variant?: string | undefined;
     }, {
         id: string;
         source: string;
@@ -297,6 +327,7 @@ declare const SkillsPackageManifestSchema: z.ZodObject<{
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
         ides?: ("qoder" | "claude")[] | undefined;
+        variant?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     schemaVersion: 1;
@@ -315,6 +346,7 @@ declare const SkillsPackageManifestSchema: z.ZodObject<{
         name: string;
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
+        variant?: string | undefined;
     }[];
     $schema?: string | undefined;
 }, {
@@ -334,6 +366,7 @@ declare const SkillsPackageManifestSchema: z.ZodObject<{
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
         ides?: ("qoder" | "claude")[] | undefined;
+        variant?: string | undefined;
     }[];
     $schema?: string | undefined;
 }>;
@@ -342,14 +375,23 @@ declare const SkillsPackageManifestSchema: z.ZodObject<{
  * - component: a React component (e.g. button.tsx)
  * - hook: a React hook (e.g. use-controllable.ts)
  * - util: a utility function (e.g. cn.ts)
- * - block: a higher-level composition (login-form, dashboard-shell). v0.x.
+ * - block: a higher-level composition shipped by ui or biz-ui (FilterBar,
+ *   EmptyState, OrgPicker, ApprovalCard). Per [ADR 0014](../../../../docs/adr/0014-ui-biz-ui-templates-tier.md),
+ *   ui ships generic blocks, biz-ui ships variant-bound business blocks.
+ * - template: a page-level composition shipped by `@teamix-evo/templates`
+ *   (DashboardLayout, ListDetailPage, ...). Per ADR 0014, templates are
+ *   variant-aware (mirror biz-ui).
  */
-declare const UiEntryTypeSchema: z.ZodEnum<["component", "hook", "util", "block"]>;
+declare const UiEntryTypeSchema: z.ZodEnum<["component", "hook", "util", "block", "template"]>;
 /**
  * Alias keys used to resolve where an entry file lands in the user's project.
  * Each key maps to a path configured in `config.json` `packages.ui.aliases`.
+ *
+ * - `components`: src/components/ui/ (ui & biz-ui blocks default here)
+ * - `business`: src/components/business/ (biz-ui only — see ADR 0014)
+ * - `templates`: src/templates/ or src/pages/ (templates package — ADR 0014)
  */
-declare const UiAliasSchema: z.ZodEnum<["components", "hooks", "utils", "lib"]>;
+declare const UiAliasSchema: z.ZodEnum<["components", "hooks", "utils", "lib", "business", "templates"]>;
 /**
  * A single file shipped by a UI entry.
  * Multiple files form one logical entry (rare, but supported).
@@ -358,16 +400,16 @@ declare const UiEntryFileSchema: 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"]>;
+    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";
+    targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
     targetName: string;
 }, {
     source: string;
-    targetAlias: "components" | "hooks" | "utils" | "lib";
+    targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
     targetName: string;
 }>;
 /**
@@ -379,7 +421,7 @@ declare const UiEntrySchema: z.ZodObject<{
     /** Display name (e.g. "Button") */
     name: z.ZodString;
     /** Entry type */
-    type: z.ZodEnum<["component", "hook", "util", "block"]>;
+    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) */
@@ -387,22 +429,22 @@ declare const UiEntrySchema: 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"]>;
+        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";
+        targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
         targetName: string;
     }, {
         source: string;
-        targetAlias: "components" | "hooks" | "utils" | "lib";
+        targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
         targetName: string;
     }>, "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") */
@@ -435,56 +477,727 @@ declare const UiEntrySchema: z.ZodObject<{
      * 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: "component" | "hook" | "util" | "block";
+    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";
+        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;
+}>;
+/**
+ * UI package manifest schema — top-level manifest of `@teamix-evo/ui`.
+ * Like skills, UI is flat (no variants); brand differences are absorbed by
+ * design tokens at the `var(--primary)` layer.
+ */
+declare const UiPackageManifestSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    /** Always "ui" for this package */
+    package: z.ZodLiteral<"ui">;
+    /** Semver version of the ui package */
+    version: z.ZodString;
+    /** Engine compatibility */
+    engines: z.ZodObject<{
+        'teamix-evo': z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        'teamix-evo': string;
+    }, {
+        'teamix-evo': string;
+    }>;
+    /** 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;
+        /** 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">;
+    /**
+     * 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;
+        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;
+    }[];
+    schemaVersion: 1;
+    package: "ui";
+    version: string;
+    engines: {
+        '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;
+        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;
+    }[];
+    schemaVersion: 1;
+    package: "ui";
+    version: string;
+    engines: {
+        '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;
+}>;
+
+/**
+ * `@teamix-evo/tokens` package manifest schema.
+ *
+ * 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:
+ *
+ *   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
+ *
+ * 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 variant.
+ *
+ * Format: `<package-spec>#<variant-name>`, e.g. `@teamix-evo/biz-ui#opentrek`.
+ * The link is **soft** — the linked package may not exist yet.
+ *
+ * Templates link added per [ADR 0014 amendment](../../../../docs/adr/0014-ui-biz-ui-templates-tier.md).
+ */
+declare const TokensPackLinkedSchema: 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;
+}>;
+/**
+ * One variant entry in the top-level catalog.
+ */
+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;
+    /** 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>;
+    /**
+     * 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.
+     */
+    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>;
+    }, "strip", z.ZodTypeAny, {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    }, {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    displayName: string;
+    version: string;
+    name: string;
+    files: string[];
+    description?: string | undefined;
+    linked?: {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    } | undefined;
+}, {
+    displayName: string;
+    version: string;
+    name: string;
+    files: string[];
+    description?: string | undefined;
+    linked?: {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    } | undefined;
+}>;
+type TokensVariantEntry = z.infer<typeof TokensVariantEntrySchema>;
+type TokensPackLinked = z.infer<typeof TokensPackLinkedSchema>;
+/**
+ * Top-level catalog of all variants in `@teamix-evo/tokens`.
+ *
+ * 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 TokensPackageManifestSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    /** 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<{
+        'teamix-evo': z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        'teamix-evo': string;
+    }, {
+        'teamix-evo': string;
+    }>;
+    /** Optional package-level description. */
+    description: z.ZodOptional<z.ZodString>;
+    /** All shipped variants (excluding scaffold dirs that begin with `_`). */
+    variants: z.ZodArray<z.ZodObject<{
+        /** Variant id — lowercase kebab-case. */
+        name: z.ZodString;
+        /** Human-readable display name (e.g. "OpenTrek" for variant id "opentrek"). */
+        displayName: z.ZodString;
+        /** 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>;
+        /**
+         * 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.
+         */
+        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>;
+        }, "strip", z.ZodTypeAny, {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        }, {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        displayName: string;
+        version: string;
+        name: string;
+        files: string[];
+        description?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
+    }, {
+        displayName: string;
+        version: string;
+        name: string;
+        files: string[];
+        description?: 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: "tokens";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    variants: {
+        displayName: string;
+        version: string;
+        name: string;
+        files: string[];
+        description?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
+    }[];
+    $schema?: string | undefined;
+    description?: string | undefined;
+    shared?: string[] | undefined;
 }, {
-    id: string;
-    type: "component" | "hook" | "util" | "block";
-    description: string;
-    name: string;
-    files: {
-        source: string;
-        targetAlias: "components" | "hooks" | "utils" | "lib";
-        targetName: string;
+    schemaVersion: 1;
+    package: "tokens";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    variants: {
+        displayName: string;
+        version: string;
+        name: string;
+        files: string[];
+        description?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
     }[];
-    updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
-    template?: boolean | undefined;
-    status?: "stable" | "experimental" | "deprecated" | undefined;
-    meta?: string | undefined;
-    registryDependencies?: string[] | undefined;
-    dependencies?: Record<string, string> | undefined;
-    deprecatedReason?: string | undefined;
-    replacedBy?: string | undefined;
+    $schema?: string | undefined;
+    description?: string | undefined;
+    shared?: string[] | undefined;
 }>;
+type TokensPackageManifest = z.infer<typeof TokensPackageManifestSchema>;
 /**
- * UI package manifest schema — top-level manifest of `@teamix-evo/ui`.
- * Like skills, UI is flat (no variants); brand differences are absorbed by
- * design tokens at the `var(--primary)` layer.
+ * Consumer-side lock file written to
+ * `.teamix-evo/tokens-lock.json` after `tokens init`.
+ *
+ * Records which tokens variant + version was installed. There is no longer a
+ * `default` field — every variant is self-contained per ADR 0020.
  */
-declare const UiPackageManifestSchema: z.ZodObject<{
+declare const TokensPackLockSchema: z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
     schemaVersion: z.ZodLiteral<1>;
-    /** Always "ui" for this package */
-    package: z.ZodLiteral<"ui">;
-    /** Semver version of the ui package */
+    variant: z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        version: z.ZodString;
+        from: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        displayName: string;
+        version: string;
+        name: string;
+        from: string;
+    }, {
+        displayName: string;
+        version: string;
+        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>;
+    }, "strip", z.ZodTypeAny, {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    }, {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    }>>;
+    installedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    variant: {
+        displayName: string;
+        version: string;
+        name: string;
+        from: string;
+    };
+    packageVersion: string;
+    installedAt: string;
+    $schema?: string | undefined;
+    linked?: {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    } | undefined;
+}, {
+    schemaVersion: 1;
+    variant: {
+        displayName: string;
+        version: string;
+        name: string;
+        from: string;
+    };
+    packageVersion: string;
+    installedAt: string;
+    $schema?: string | undefined;
+    linked?: {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    } | undefined;
+}>;
+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/tokens`'s variant model: each ships a
+ * top-level catalog (variants list) plus a per-variant manifest (entry list).
+ *
+ *   packages/biz-ui/
+ *   ├── manifest.json                        <- VariantUiPackageCatalogSchema
+ *   └── variants/<name>/
+ *       └── manifest.json                    <- VariantUiPackageManifestSchema
+ *
+ * The per-variant manifest is **structurally similar to `UiPackageManifest`**
+ * (flat entries list) but adds a `variant` field — the variant name that all
+ * entries in this manifest belong to. Each entry's `variant` field MUST match
+ * (cross-checked at validation).
+ */
+
+/**
+ * Discriminator for which variant-aware package this manifest belongs to.
+ */
+declare const VariantUiPackageNameSchema: z.ZodEnum<["biz-ui", "templates"]>;
+/**
+ * Per-variant manifest — lives at `packages/<pkg>/variants/<name>/manifest.json`.
+ *
+ * Lists the entries this variant ships. Entries reuse `UiEntrySchema` (they
+ * are technically the same shape as ui entries — only difference is they
+ * declare a `variant` field tying them to a brand).
+ */
+declare const VariantUiPackageManifestSchema: z.ZodEffects<z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    /** Discriminator. */
+    package: z.ZodEnum<["biz-ui", "templates"]>;
+    /**
+     * Variant identifier — lowercase kebab-case, MUST match the parent
+     * directory name (e.g. `opentrek` for `variants/opentrek/manifest.json`).
+     * `_template` is also accepted for the variant scaffold.
+     */
+    variant: z.ZodUnion<[z.ZodString, z.ZodLiteral<"_template">]>;
+    /** Semver of this variant. */
     version: z.ZodString;
-    /** Engine compatibility */
+    /** Engine compatibility. */
     engines: z.ZodObject<{
         'teamix-evo': z.ZodString;
     }, "strip", z.ZodTypeAny, {
@@ -492,82 +1205,48 @@ declare const UiPackageManifestSchema: z.ZodObject<{
     }, {
         'teamix-evo': string;
     }>;
-    /** Flat list of entries shipped by this package */
+    /** Flat list of entries shipped by this variant. */
     entries: 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"]>;
-        /** One-line description for entry discovery and AI guidance */
+        type: z.ZodEnum<["component", "hook", "util", "block", "template"]>;
         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"]>;
-            /** Filename written under the alias directory (e.g. "button.tsx") */
+            targetAlias: z.ZodEnum<["components", "hooks", "utils", "lib", "business", "templates"]>;
             targetName: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             source: string;
-            targetAlias: "components" | "hooks" | "utils" | "lib";
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
             targetName: string;
         }, {
             source: string;
-            targetAlias: "components" | "hooks" | "utils" | "lib";
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
             targetName: string;
         }>, "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.
-         */
         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: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         id: string;
-        type: "component" | "hook" | "util" | "block";
+        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";
+            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;
@@ -575,17 +1254,18 @@ declare const UiPackageManifestSchema: z.ZodObject<{
         replacedBy?: string | undefined;
     }, {
         id: string;
-        type: "component" | "hook" | "util" | "block";
+        type: "template" | "component" | "hook" | "util" | "block";
         description: string;
         name: string;
         files: {
             source: string;
-            targetAlias: "components" | "hooks" | "utils" | "lib";
+            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;
@@ -595,17 +1275,18 @@ declare const UiPackageManifestSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     entries: {
         id: string;
-        type: "component" | "hook" | "util" | "block";
+        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";
+            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;
@@ -613,7 +1294,8 @@ declare const UiPackageManifestSchema: z.ZodObject<{
         replacedBy?: string | undefined;
     }[];
     schemaVersion: 1;
-    package: "ui";
+    package: "templates" | "biz-ui";
+    variant: string;
     version: string;
     engines: {
         'teamix-evo': string;
@@ -622,17 +1304,18 @@ declare const UiPackageManifestSchema: z.ZodObject<{
 }, {
     entries: {
         id: string;
-        type: "component" | "hook" | "util" | "block";
+        type: "template" | "component" | "hook" | "util" | "block";
         description: string;
         name: string;
         files: {
             source: string;
-            targetAlias: "components" | "hooks" | "utils" | "lib";
+            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;
@@ -640,44 +1323,184 @@ declare const UiPackageManifestSchema: z.ZodObject<{
         replacedBy?: string | undefined;
     }[];
     schemaVersion: 1;
-    package: "ui";
+    package: "templates" | "biz-ui";
+    variant: string;
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    $schema?: string | undefined;
+}>, {
+    entries: {
+        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;
+    }[];
+    schemaVersion: 1;
+    package: "templates" | "biz-ui";
+    variant: string;
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    $schema?: string | undefined;
+}, {
+    entries: {
+        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;
+    }[];
+    schemaVersion: 1;
+    package: "templates" | "biz-ui";
+    variant: string;
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    $schema?: string | undefined;
+}>;
+type VariantUiPackageManifest = z.infer<typeof VariantUiPackageManifestSchema>;
+type VariantUiPackageName = z.infer<typeof VariantUiPackageNameSchema>;
+/**
+ * Top-level catalog summarizing the package's variants. Lives at
+ * `packages/<pkg>/manifest.json`. Used by `<pkg> list-variants` and
+ * cross-package variant-name sync checks.
+ */
+declare const VariantUiPackageCatalogSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    package: z.ZodEnum<["biz-ui", "templates"]>;
+    /** Semver of the entire package. */
+    version: z.ZodString;
+    engines: z.ZodObject<{
+        'teamix-evo': z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        'teamix-evo': string;
+    }, {
+        'teamix-evo': string;
+    }>;
+    /** Variants this package ships (excluding `_template`). */
+    variants: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        version: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        displayName: string;
+        version: string;
+        name: string;
+        description?: string | undefined;
+    }, {
+        displayName: string;
+        version: string;
+        name: string;
+        description?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    package: "templates" | "biz-ui";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    variants: {
+        displayName: string;
+        version: string;
+        name: string;
+        description?: string | undefined;
+    }[];
+    $schema?: string | undefined;
+}, {
+    schemaVersion: 1;
+    package: "templates" | "biz-ui";
     version: string;
     engines: {
         'teamix-evo': string;
     };
+    variants: {
+        displayName: string;
+        version: string;
+        name: string;
+        description?: string | undefined;
+    }[];
     $schema?: string | undefined;
 }>;
+type VariantUiPackageCatalog = z.infer<typeof VariantUiPackageCatalogSchema>;
 
 /**
  * Tailwind CSS major version that the project consumes.
- * Used by integration tooling (skills) to choose the correct token entry file.
+ *
+ * Only `'v4'` is accepted. v3 was retired in v0.7 — the dual-track output
+ * (`tokens.generated.css`) added maintenance cost without active demand.
+ * The schema keeps the field optional so existing config.json files
+ * (which may carry `tailwind: 'v4'`) continue to validate; any non-v4 value
+ * — including legacy `'v3'` — is rejected so users get a clear error.
  */
-declare const TailwindVersionSchema: z.ZodEnum<["v3", "v4"]>;
+declare const TailwindVersionSchema: z.ZodLiteral<"v4">;
 /**
  * Aliases for ui entry write-back paths in the consumer project.
- * Keys mirror shadcn `components.json` aliases for familiarity.
+ * Keys mirror shadcn `components.json` aliases for familiarity, extended for
+ * biz-ui (business) and templates per [ADR 0014](../../../../docs/adr/0014-ui-biz-ui-templates-tier.md).
  */
 declare const UiAliasesSchema: z.ZodObject<{
     components: z.ZodString;
     hooks: z.ZodString;
     utils: z.ZodString;
     lib: z.ZodString;
+    /** Biz-ui components (variant-bound). Defaults to `src/components/business/`. */
+    business: z.ZodDefault<z.ZodString>;
+    /** Page templates (variant-bound). Defaults to `src/templates/`. */
+    templates: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     components: string;
     hooks: string;
     utils: string;
     lib: string;
+    business: string;
+    templates: string;
 }, {
     components: string;
     hooks: string;
     utils: string;
     lib: string;
+    business?: string | undefined;
+    templates?: string | undefined;
 }>;
 /**
  * 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
  *
@@ -690,7 +1513,7 @@ declare const PackageEntrySchema: z.ZodObject<{
     /** Semver version string */
     version: z.ZodString;
     /** Tailwind CSS version this project uses (only meaningful for design package). */
-    tailwind: z.ZodOptional<z.ZodEnum<["v3", "v4"]>>;
+    tailwind: z.ZodOptional<z.ZodLiteral<"v4">>;
     /** IDEs this package was installed for (only meaningful for skills package). */
     ides: z.ZodOptional<z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">>;
     /** Install scope (only meaningful for skills package). */
@@ -701,16 +1524,24 @@ declare const PackageEntrySchema: z.ZodObject<{
         hooks: z.ZodString;
         utils: z.ZodString;
         lib: z.ZodString;
+        /** Biz-ui components (variant-bound). Defaults to `src/components/business/`. */
+        business: z.ZodDefault<z.ZodString>;
+        /** Page templates (variant-bound). Defaults to `src/templates/`. */
+        templates: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         components: string;
         hooks: string;
         utils: string;
         lib: string;
+        business: string;
+        templates: string;
     }, {
         components: string;
         hooks: string;
         utils: string;
         lib: string;
+        business?: string | undefined;
+        templates?: string | undefined;
     }>>;
     /**
      * Default icon library declared by the project (only meaningful for ui).
@@ -726,12 +1557,14 @@ declare const PackageEntrySchema: z.ZodObject<{
     version: string;
     ides?: ("qoder" | "claude")[] | undefined;
     scope?: "project" | "global" | undefined;
-    tailwind?: "v3" | "v4" | undefined;
+    tailwind?: "v4" | undefined;
     aliases?: {
         components: string;
         hooks: string;
         utils: string;
         lib: string;
+        business: string;
+        templates: string;
     } | undefined;
     iconLibrary?: string | undefined;
     tsx?: boolean | undefined;
@@ -741,12 +1574,14 @@ declare const PackageEntrySchema: z.ZodObject<{
     version: string;
     ides?: ("qoder" | "claude")[] | undefined;
     scope?: "project" | "global" | undefined;
-    tailwind?: "v3" | "v4" | undefined;
+    tailwind?: "v4" | undefined;
     aliases?: {
         components: string;
         hooks: string;
         utils: string;
         lib: string;
+        business?: string | undefined;
+        templates?: string | undefined;
     } | undefined;
     iconLibrary?: string | undefined;
     tsx?: boolean | undefined;
@@ -767,7 +1602,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
         /** Semver version string */
         version: z.ZodString;
         /** Tailwind CSS version this project uses (only meaningful for design package). */
-        tailwind: z.ZodOptional<z.ZodEnum<["v3", "v4"]>>;
+        tailwind: z.ZodOptional<z.ZodLiteral<"v4">>;
         /** IDEs this package was installed for (only meaningful for skills package). */
         ides: z.ZodOptional<z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">>;
         /** Install scope (only meaningful for skills package). */
@@ -778,16 +1613,24 @@ declare const ProjectConfigSchema: z.ZodObject<{
             hooks: z.ZodString;
             utils: z.ZodString;
             lib: z.ZodString;
+            /** Biz-ui components (variant-bound). Defaults to `src/components/business/`. */
+            business: z.ZodDefault<z.ZodString>;
+            /** Page templates (variant-bound). Defaults to `src/templates/`. */
+            templates: z.ZodDefault<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             components: string;
             hooks: string;
             utils: string;
             lib: string;
+            business: string;
+            templates: string;
         }, {
             components: string;
             hooks: string;
             utils: string;
             lib: string;
+            business?: string | undefined;
+            templates?: string | undefined;
         }>>;
         /**
          * Default icon library declared by the project (only meaningful for ui).
@@ -803,12 +1646,14 @@ declare const ProjectConfigSchema: z.ZodObject<{
         version: string;
         ides?: ("qoder" | "claude")[] | undefined;
         scope?: "project" | "global" | undefined;
-        tailwind?: "v3" | "v4" | undefined;
+        tailwind?: "v4" | undefined;
         aliases?: {
             components: string;
             hooks: string;
             utils: string;
             lib: string;
+            business: string;
+            templates: string;
         } | undefined;
         iconLibrary?: string | undefined;
         tsx?: boolean | undefined;
@@ -818,12 +1663,14 @@ declare const ProjectConfigSchema: z.ZodObject<{
         version: string;
         ides?: ("qoder" | "claude")[] | undefined;
         scope?: "project" | "global" | undefined;
-        tailwind?: "v3" | "v4" | undefined;
+        tailwind?: "v4" | undefined;
         aliases?: {
             components: string;
             hooks: string;
             utils: string;
             lib: string;
+            business?: string | undefined;
+            templates?: string | undefined;
         } | undefined;
         iconLibrary?: string | undefined;
         tsx?: boolean | undefined;
@@ -837,12 +1684,14 @@ declare const ProjectConfigSchema: z.ZodObject<{
         version: string;
         ides?: ("qoder" | "claude")[] | undefined;
         scope?: "project" | "global" | undefined;
-        tailwind?: "v3" | "v4" | undefined;
+        tailwind?: "v4" | undefined;
         aliases?: {
             components: string;
             hooks: string;
             utils: string;
             lib: string;
+            business: string;
+            templates: string;
         } | undefined;
         iconLibrary?: string | undefined;
         tsx?: boolean | undefined;
@@ -857,12 +1706,14 @@ declare const ProjectConfigSchema: z.ZodObject<{
         version: string;
         ides?: ("qoder" | "claude")[] | undefined;
         scope?: "project" | "global" | undefined;
-        tailwind?: "v3" | "v4" | undefined;
+        tailwind?: "v4" | undefined;
         aliases?: {
             components: string;
             hooks: string;
             utils: string;
             lib: string;
+            business?: string | undefined;
+            templates?: string | undefined;
         } | undefined;
         iconLibrary?: string | undefined;
         tsx?: boolean | undefined;
@@ -910,7 +1761,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;
@@ -982,7 +1833,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;
@@ -1080,6 +1931,107 @@ declare const InstalledManifestSchema: z.ZodObject<{
     }[];
 }>;
 
+/**
+ * Skills source-mirror lock file schema.
+ *
+ * Per [ADR 0013](../../../../docs/adr/0013-skills-source-mirror.md), the source
+ * lives at `.teamix-evo/skills/<id>/`, and IDE paths (`.qoder/skills/<id>/`,
+ * `.claude/skills/<id>/`) are regenerable mirrors. This lock file at
+ * `.teamix-evo/skills/manifest.lock.json` is the authoritative ledger of:
+ *
+ *   1. which skills are installed,
+ *   2. which version each was installed from,
+ *   3. which IDE mirror paths were produced (so `remove` / `sync` know where to act).
+ *
+ * v0.6 supports `qoder` + `claude` mirrors. `.cursor/rules/<id>.mdc` is v0.7
+ * (per ADR 0013 §Implementation note); the schema does NOT pre-allocate
+ * cursor-specific fields — they will be added with the v0.7 ADR.
+ */
+declare const SkillsLockEntrySchema: z.ZodObject<{
+    /** Semver version installed from upstream */
+    version: z.ZodString;
+    /** Upstream package name (typically `@teamix-evo/skills`) */
+    from: z.ZodString;
+    /** ISO 8601 install / last-sync timestamp */
+    installedAt: z.ZodString;
+    /** Install scope at time of mirror */
+    scope: z.ZodEnum<["project", "global"]>;
+    /**
+     * IDEs this skill was mirrored to. Each ide ↔ a mirror path under
+     * `<projectRoot>/.<ide>/skills/<id>/` (project) or `~/.<ide>/skills/<id>/`
+     * (global). The path itself is reconstructed from `scope` + adapter; we
+     * record the ide identifier rather than the full path to keep the lock
+     * portable across machines.
+     */
+    mirroredTo: z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    scope: "project" | "global";
+    version: string;
+    from: string;
+    installedAt: string;
+    mirroredTo: ("qoder" | "claude")[];
+}, {
+    scope: "project" | "global";
+    version: string;
+    from: string;
+    installedAt: string;
+    mirroredTo: ("qoder" | "claude")[];
+}>;
+declare const SkillsLockSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    /** Map of skill id → lock entry */
+    skills: z.ZodRecord<z.ZodString, z.ZodObject<{
+        /** Semver version installed from upstream */
+        version: z.ZodString;
+        /** Upstream package name (typically `@teamix-evo/skills`) */
+        from: z.ZodString;
+        /** ISO 8601 install / last-sync timestamp */
+        installedAt: z.ZodString;
+        /** Install scope at time of mirror */
+        scope: z.ZodEnum<["project", "global"]>;
+        /**
+         * IDEs this skill was mirrored to. Each ide ↔ a mirror path under
+         * `<projectRoot>/.<ide>/skills/<id>/` (project) or `~/.<ide>/skills/<id>/`
+         * (global). The path itself is reconstructed from `scope` + adapter; we
+         * record the ide identifier rather than the full path to keep the lock
+         * portable across machines.
+         */
+        mirroredTo: z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        scope: "project" | "global";
+        version: string;
+        from: string;
+        installedAt: string;
+        mirroredTo: ("qoder" | "claude")[];
+    }, {
+        scope: "project" | "global";
+        version: string;
+        from: string;
+        installedAt: string;
+        mirroredTo: ("qoder" | "claude")[];
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    skills: Record<string, {
+        scope: "project" | "global";
+        version: string;
+        from: string;
+        installedAt: string;
+        mirroredTo: ("qoder" | "claude")[];
+    }>;
+}, {
+    schemaVersion: 1;
+    skills: Record<string, {
+        scope: "project" | "global";
+        version: string;
+        from: string;
+        installedAt: string;
+        mirroredTo: ("qoder" | "claude")[];
+    }>;
+}>;
+type SkillsLockEntry = z.infer<typeof SkillsLockEntrySchema>;
+type SkillsLock = z.infer<typeof SkillsLockSchema>;
+
 /** Resource update strategy */
 type UpdateStrategy = z.infer<typeof UpdateStrategySchema>;
 /** Resource type discriminator */
@@ -1110,7 +2062,7 @@ type UiPackageManifest = z.infer<typeof UiPackageManifestSchema>;
 type UiAliases = z.infer<typeof UiAliasesSchema>;
 /** A package entry in the project config */
 type PackageEntry = z.infer<typeof PackageEntrySchema>;
-/** Tailwind CSS major version ("v3" | "v4") */
+/** Tailwind CSS major version (always `"v4"` since v0.7). */
 type TailwindVersion = z.infer<typeof TailwindVersionSchema>;
 /** Project configuration (config.json) */
 type ProjectConfig = z.infer<typeof ProjectConfigSchema>;
@@ -1175,6 +2127,20 @@ declare function loadSkillsPackageManifest(packageDir: string): Promise<SkillsPa
  */
 declare function loadUiPackageManifest(packageDir: string): Promise<UiPackageManifest>;
 
+/**
+ * Read & validate the top-level `packages/tokens/manifest.json` catalog.
+ * Errors are wrapped with the file path for easy diagnosis (P8).
+ */
+declare function loadTokensPackageManifest(packageDir: string): Promise<TokensPackageManifest>;
+/**
+ * Lookup helper: find one variant entry in a catalog by name.
+ * Returns `undefined` when the variant is not advertised.
+ */
+declare function getVariantEntry(catalog: TokensPackageManifest, variantName: string): TokensVariantEntry | undefined;
+
+declare function loadVariantUiPackageCatalog(packageDir: string): Promise<VariantUiPackageCatalog>;
+declare function loadVariantUiPackageManifest(variantDir: string): Promise<VariantUiPackageManifest>;
+
 /**
  * Validate unknown data against the VariantManifest schema.
  * Returns a discriminated Result with either the parsed data or a friendly error message.
@@ -1188,6 +2154,11 @@ declare function validateConfig(data: unknown): Result<ProjectConfig>;
  * Validate unknown data against the InstalledManifest schema.
  */
 declare function validateInstalled(data: unknown): Result<InstalledManifest>;
+/**
+ * Validate unknown data against the SkillsLock schema (skills source-mirror lock).
+ * Stored at `.teamix-evo/skills/manifest.lock.json` per ADR 0013.
+ */
+declare function validateSkillsLock(data: unknown): Result<SkillsLock>;
 /**
  * Validate unknown data against the SkillsPackageManifest schema.
  */
@@ -1274,4 +2245,4 @@ interface UpdateActionOptions {
  */
 declare function getUpdateAction(strategy: UpdateStrategy, options: UpdateActionOptions): UpdateAction;
 
-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 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, getUpdateAction, hasManagedRegion, loadSkillsPackageManifest, loadUiPackageManifest, loadVariantManifest, parseManagedRegions, replaceManagedRegion, resolveUiEntryOrder, shouldUpdate, validateConfig, validateInstalled, validateManifest, validateSkillsPackage, validateUiDependencyGraph, validateUiPackage };
+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 };