@teamix-evo/registry 0.2.0 → 0.3.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/design/pack.lock.json` records the same variant. MUST equal
+     * the variant directory name in `@teamix-evo/design/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/design/pack.lock.json` records the same variant. MUST equal
+         * the variant directory name in `@teamix-evo/design/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,16 +429,16 @@ 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">;
     /**
@@ -435,19 +477,27 @@ 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;
@@ -455,17 +505,18 @@ declare const UiEntrySchema: 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;
@@ -499,7 +550,7 @@ declare const UiPackageManifestSchema: 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) */
@@ -507,16 +558,16 @@ declare const UiPackageManifestSchema: 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">;
         /**
@@ -555,19 +606,27 @@ declare const UiPackageManifestSchema: 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;
@@ -575,17 +634,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 +655,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;
@@ -622,17 +683,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;
@@ -648,30 +710,759 @@ declare const UiPackageManifestSchema: z.ZodObject<{
     $schema?: string | 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**:
+ *
+ *   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)
+ *
+ * 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.
+ *
+ * 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.
+ */
+
+/**
+ * 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.
+ *
+ * Format: `<package-spec>#<variant-name>`, e.g. `@teamix-evo/biz-ui#opentrek`.
+ *
+ * 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).
+ */
+declare const DesignPackLinkedSchema: 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;
+}>;
+/**
+ * Design pack manifest schema.
+ *
+ * Describes ONE pack (either the default baseline or one variant). Files are
+ * not declared — the loader walks the pack root.
+ */
+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">]>;
+    /** 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;
+}>;
+type DesignPackManifest = z.infer<typeof DesignPackManifestSchema>;
+type DesignPackLinked = z.infer<typeof DesignPackLinkedSchema>;
+/**
+ * Top-level catalog of all packs in `@teamix-evo/design`.
+ *
+ * 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.
+ */
+declare const DesignPackageManifestSchema: 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. */
+    version: z.ZodString;
+    /** Engine compatibility. */
+    engines: z.ZodObject<{
+        'teamix-evo': z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        'teamix-evo': string;
+    }, {
+        '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/`). */
+    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">]>;
+        /** 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;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    package: "design";
+    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;
+        description?: string | undefined;
+        extends?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
+    }[];
+    $schema?: string | undefined;
+}, {
+    schemaVersion: 1;
+    package: "design";
+    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;
+        description?: string | undefined;
+        extends?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
+    }[];
+    $schema?: string | undefined;
+}>;
+type DesignPackageManifest = z.infer<typeof DesignPackageManifestSchema>;
+/**
+ * Consumer-side lock file written to
+ * `.teamix-evo/design/pack.lock.json` after `design 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.
+ */
+declare const DesignPackLockSchema: 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;
+        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;
+    }>;
+    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;
+    };
+    default: {
+        version: string;
+        from: 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;
+    };
+    default: {
+        version: string;
+        from: string;
+    };
+    installedAt: string;
+    $schema?: string | undefined;
+    linked?: {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    } | undefined;
+}>;
+type DesignPackLock = z.infer<typeof DesignPackLockSchema>;
+
+/**
+ * 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
+ * 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. */
+    engines: z.ZodObject<{
+        'teamix-evo': z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        'teamix-evo': string;
+    }, {
+        'teamix-evo': string;
+    }>;
+    /** Flat list of entries shipped by this variant. */
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodEnum<["component", "hook", "util", "block", "template"]>;
+        description: z.ZodString;
+        files: z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            targetAlias: z.ZodEnum<["components", "hooks", "utils", "lib", "business", "templates"]>;
+            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">;
+        meta: z.ZodOptional<z.ZodString>;
+        registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        updateStrategy: z.ZodDefault<z.ZodEnum<["frozen", "regenerable", "managed"]>>;
+        template: z.ZodOptional<z.ZodBoolean>;
+        status: z.ZodDefault<z.ZodEnum<["stable", "experimental", "deprecated"]>>;
+        deprecatedReason: z.ZodOptional<z.ZodString>;
+        replacedBy: z.ZodOptional<z.ZodString>;
+        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: "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;
+}>, {
+    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.
@@ -690,7 +1481,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 +1492,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 +1525,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 +1542,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 +1570,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 +1581,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 +1614,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 +1631,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 +1652,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 +1674,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;
@@ -1080,6 +1899,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 +2030,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 +2095,59 @@ declare function loadSkillsPackageManifest(packageDir: string): Promise<SkillsPa
  */
 declare function loadUiPackageManifest(packageDir: string): Promise<UiPackageManifest>;
 
+/**
+ * Read & validate a single pack's `pack.json`.
+ * 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[];
+}
+/**
+ * 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.
+ */
+declare function mergeDefaultAndVariant(defaultDir: string, variantDir: string): Promise<MergeResult>;
+
+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 +2161,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 +2252,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 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 };