@teamix-evo/registry 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -10,7 +10,18 @@ declare const UpdateStrategySchema: z.ZodEnum<["frozen", "regenerable", "managed
 /**
  * Resource type discriminator.
  */
-declare const ResourceTypeSchema: z.ZodEnum<["doc", "tokens", "ai-rules", "config"]>;
+declare const ResourceTypeSchema: z.ZodEnum<["doc", "tokens", "ai-rules", "config", "skill"]>;
+/**
+ * Supported AI IDE identifiers for skill resources.
+ * Qoder and Claude Code share the same SKILL.md format; differ only by install path.
+ */
+declare const SkillIdeSchema: z.ZodEnum<["qoder", "claude"]>;
+/**
+ * Skill installation scope.
+ * - project: install under project root (.qoder/skills/, .claude/skills/)
+ * - global:  install under user home (~/.qoder/skills/, ~/.claude/skills/)
+ */
+declare const SkillScopeSchema: z.ZodEnum<["project", "global"]>;
 /**
  * A single resource entry within a variant manifest.
  */
@@ -18,10 +29,13 @@ declare const ResourceSchema: z.ZodObject<{
     /** Unique identifier for the resource within the manifest */
     id: z.ZodString;
     /** Resource type */
-    type: z.ZodEnum<["doc", "tokens", "ai-rules", "config"]>;
+    type: z.ZodEnum<["doc", "tokens", "ai-rules", "config", "skill"]>;
     /** Source path (relative to variant root), typically a template */
     source: z.ZodString;
-    /** Target path (relative to project root) where the resource is installed */
+    /**
+     * Target path (relative to project root) where the resource is installed.
+     * For type="skill" this is ignored: the path is computed from skill name + ide + scope.
+     */
     target: z.ZodString;
     /** How the resource is updated */
     updateStrategy: z.ZodEnum<["frozen", "regenerable", "managed"]>;
@@ -31,24 +45,32 @@ declare const ResourceSchema: z.ZodObject<{
     managedRegions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /** Whether to recursively process directory contents */
     recursive: z.ZodOptional<z.ZodBoolean>;
+    /** Supported IDEs (only meaningful when type="skill"; defaults to all when omitted) */
+    ides: z.ZodOptional<z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">>;
+    /** Default install scope (only meaningful when type="skill"; user can override at install time) */
+    scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    type: "doc" | "tokens" | "ai-rules" | "config";
+    type: "doc" | "tokens" | "ai-rules" | "config" | "skill";
     source: string;
     target: string;
     updateStrategy: "frozen" | "regenerable" | "managed";
     template?: boolean | undefined;
     managedRegions?: string[] | undefined;
     recursive?: boolean | undefined;
+    ides?: ("qoder" | "claude")[] | undefined;
+    scope?: "project" | "global" | undefined;
 }, {
     id: string;
-    type: "doc" | "tokens" | "ai-rules" | "config";
+    type: "doc" | "tokens" | "ai-rules" | "config" | "skill";
     source: string;
     target: string;
     updateStrategy: "frozen" | "regenerable" | "managed";
     template?: boolean | undefined;
     managedRegions?: string[] | undefined;
     recursive?: boolean | undefined;
+    ides?: ("qoder" | "claude")[] | undefined;
+    scope?: "project" | "global" | undefined;
 }>;
 /**
  * Variant manifest schema — describes a variant package and its resources.
@@ -68,11 +90,11 @@ declare const VariantManifestSchema: z.ZodObject<{
     version: z.ZodString;
     /** Engine compatibility */
     engines: z.ZodObject<{
-        "teamix-evo": z.ZodString;
+        'teamix-evo': z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        "teamix-evo": string;
+        'teamix-evo': string;
     }, {
-        "teamix-evo": string;
+        'teamix-evo': string;
     }>;
     /** Supported IDE identifiers */
     ide: z.ZodArray<z.ZodString, "many">;
@@ -81,10 +103,13 @@ declare const VariantManifestSchema: z.ZodObject<{
         /** Unique identifier for the resource within the manifest */
         id: z.ZodString;
         /** Resource type */
-        type: z.ZodEnum<["doc", "tokens", "ai-rules", "config"]>;
+        type: z.ZodEnum<["doc", "tokens", "ai-rules", "config", "skill"]>;
         /** Source path (relative to variant root), typically a template */
         source: z.ZodString;
-        /** Target path (relative to project root) where the resource is installed */
+        /**
+         * Target path (relative to project root) where the resource is installed.
+         * For type="skill" this is ignored: the path is computed from skill name + ide + scope.
+         */
         target: z.ZodString;
         /** How the resource is updated */
         updateStrategy: z.ZodEnum<["frozen", "regenerable", "managed"]>;
@@ -94,24 +119,32 @@ declare const VariantManifestSchema: z.ZodObject<{
         managedRegions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         /** Whether to recursively process directory contents */
         recursive: z.ZodOptional<z.ZodBoolean>;
+        /** Supported IDEs (only meaningful when type="skill"; defaults to all when omitted) */
+        ides: z.ZodOptional<z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">>;
+        /** Default install scope (only meaningful when type="skill"; user can override at install time) */
+        scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
     }, "strip", z.ZodTypeAny, {
         id: string;
-        type: "doc" | "tokens" | "ai-rules" | "config";
+        type: "doc" | "tokens" | "ai-rules" | "config" | "skill";
         source: string;
         target: string;
         updateStrategy: "frozen" | "regenerable" | "managed";
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
         recursive?: boolean | undefined;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
     }, {
         id: string;
-        type: "doc" | "tokens" | "ai-rules" | "config";
+        type: "doc" | "tokens" | "ai-rules" | "config" | "skill";
         source: string;
         target: string;
         updateStrategy: "frozen" | "regenerable" | "managed";
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
         recursive?: boolean | undefined;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     schemaVersion: 1;
@@ -121,18 +154,20 @@ declare const VariantManifestSchema: z.ZodObject<{
     description: string;
     version: string;
     engines: {
-        "teamix-evo": string;
+        'teamix-evo': string;
     };
     ide: string[];
     resources: {
         id: string;
-        type: "doc" | "tokens" | "ai-rules" | "config";
+        type: "doc" | "tokens" | "ai-rules" | "config" | "skill";
         source: string;
         target: string;
         updateStrategy: "frozen" | "regenerable" | "managed";
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
         recursive?: boolean | undefined;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
     }[];
     $schema?: string | undefined;
 }, {
@@ -143,36 +178,579 @@ declare const VariantManifestSchema: z.ZodObject<{
     description: string;
     version: string;
     engines: {
-        "teamix-evo": string;
+        'teamix-evo': string;
     };
     ide: string[];
     resources: {
         id: string;
-        type: "doc" | "tokens" | "ai-rules" | "config";
+        type: "doc" | "tokens" | "ai-rules" | "config" | "skill";
         source: string;
         target: string;
         updateStrategy: "frozen" | "regenerable" | "managed";
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
         recursive?: boolean | undefined;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
+    }[];
+    $schema?: string | undefined;
+}>;
+/**
+ * A single skill entry within a skills package manifest.
+ */
+declare const SkillEntrySchema: z.ZodObject<{
+    /** Skill identifier (matches name/folder) */
+    id: z.ZodString;
+    /** Skill name — must match the directory name and frontmatter `name` */
+    name: z.ZodString;
+    /** One-line description for skill discovery */
+    description: z.ZodString;
+    /** Semver version */
+    version: z.ZodString;
+    /** Source path relative to package root — file or directory */
+    source: z.ZodString;
+    /** Supported IDEs (defaults to both when omitted) */
+    ides: z.ZodDefault<z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">>;
+    /** Update strategy (defaults to managed) */
+    updateStrategy: z.ZodDefault<z.ZodEnum<["frozen", "regenerable", "managed"]>>;
+    /** Managed region IDs to maintain on update */
+    managedRegions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Whether the source is a Handlebars template */
+    template: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    source: string;
+    updateStrategy: "frozen" | "regenerable" | "managed";
+    ides: ("qoder" | "claude")[];
+    description: string;
+    version: string;
+    name: string;
+    template?: boolean | undefined;
+    managedRegions?: string[] | undefined;
+}, {
+    id: string;
+    source: string;
+    description: string;
+    version: string;
+    name: string;
+    updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+    template?: boolean | undefined;
+    managedRegions?: string[] | undefined;
+    ides?: ("qoder" | "claude")[] | undefined;
+}>;
+/**
+ * Skills package manifest schema — top-level manifest of `@teamix-evo/skills`.
+ * Unlike design which is variant-based, skills are flat (no variants).
+ */
+declare const SkillsPackageManifestSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    /** Always "skills" for this package */
+    package: z.ZodLiteral<"skills">;
+    /** Semver version of the skills package */
+    version: z.ZodString;
+    /** Engine compatibility */
+    engines: z.ZodObject<{
+        'teamix-evo': z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        'teamix-evo': string;
+    }, {
+        'teamix-evo': string;
+    }>;
+    /** Flat list of skills shipped by this package */
+    skills: z.ZodArray<z.ZodObject<{
+        /** Skill identifier (matches name/folder) */
+        id: z.ZodString;
+        /** Skill name — must match the directory name and frontmatter `name` */
+        name: z.ZodString;
+        /** One-line description for skill discovery */
+        description: z.ZodString;
+        /** Semver version */
+        version: z.ZodString;
+        /** Source path relative to package root — file or directory */
+        source: z.ZodString;
+        /** Supported IDEs (defaults to both when omitted) */
+        ides: z.ZodDefault<z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">>;
+        /** Update strategy (defaults to managed) */
+        updateStrategy: z.ZodDefault<z.ZodEnum<["frozen", "regenerable", "managed"]>>;
+        /** Managed region IDs to maintain on update */
+        managedRegions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Whether the source is a Handlebars template */
+        template: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        source: string;
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        ides: ("qoder" | "claude")[];
+        description: string;
+        version: string;
+        name: string;
+        template?: boolean | undefined;
+        managedRegions?: string[] | undefined;
+    }, {
+        id: string;
+        source: string;
+        description: string;
+        version: string;
+        name: string;
+        updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+        template?: boolean | undefined;
+        managedRegions?: string[] | undefined;
+        ides?: ("qoder" | "claude")[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    package: "skills";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    skills: {
+        id: string;
+        source: string;
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        ides: ("qoder" | "claude")[];
+        description: string;
+        version: string;
+        name: string;
+        template?: boolean | undefined;
+        managedRegions?: string[] | undefined;
+    }[];
+    $schema?: string | undefined;
+}, {
+    schemaVersion: 1;
+    package: "skills";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    skills: {
+        id: string;
+        source: string;
+        description: string;
+        version: string;
+        name: string;
+        updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+        template?: boolean | undefined;
+        managedRegions?: string[] | undefined;
+        ides?: ("qoder" | "claude")[] | undefined;
+    }[];
+    $schema?: string | undefined;
+}>;
+/**
+ * UI entry types.
+ * - 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.
+ */
+declare const UiEntryTypeSchema: z.ZodEnum<["component", "hook", "util", "block"]>;
+/**
+ * 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`.
+ */
+declare const UiAliasSchema: z.ZodEnum<["components", "hooks", "utils", "lib"]>;
+/**
+ * A single file shipped by a UI entry.
+ * Multiple files form one logical entry (rare, but supported).
+ */
+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"]>;
+    /** Filename written under the alias directory (e.g. "button.tsx") */
+    targetName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    targetAlias: "components" | "hooks" | "utils" | "lib";
+    targetName: string;
+}, {
+    source: string;
+    targetAlias: "components" | "hooks" | "utils" | "lib";
+    targetName: string;
+}>;
+/**
+ * A single UI entry (component / hook / util / block).
+ */
+declare const UiEntrySchema: 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 */
+    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") */
+        targetName: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        targetAlias: "components" | "hooks" | "utils" | "lib";
+        targetName: string;
+    }, {
+        source: string;
+        targetAlias: "components" | "hooks" | "utils" | "lib";
+        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>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type: "component" | "hook" | "util" | "block";
+    updateStrategy: "frozen" | "regenerable" | "managed";
+    status: "stable" | "experimental" | "deprecated";
+    description: string;
+    name: string;
+    files: {
+        source: string;
+        targetAlias: "components" | "hooks" | "utils" | "lib";
+        targetName: string;
+    }[];
+    template?: boolean | undefined;
+    meta?: string | undefined;
+    registryDependencies?: string[] | undefined;
+    dependencies?: Record<string, string> | undefined;
+    deprecatedReason?: string | undefined;
+    replacedBy?: string | undefined;
+}, {
+    id: string;
+    type: "component" | "hook" | "util" | "block";
+    description: string;
+    name: string;
+    files: {
+        source: string;
+        targetAlias: "components" | "hooks" | "utils" | "lib";
+        targetName: string;
+    }[];
+    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;
+}>;
+/**
+ * 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;
+    }>;
+    /** Flat list of entries shipped 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"]>;
+        /** 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"]>;
+            /** Filename written under the alias directory (e.g. "button.tsx") */
+            targetName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib";
+            targetName: string;
+        }, {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib";
+            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>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        type: "component" | "hook" | "util" | "block";
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        status: "stable" | "experimental" | "deprecated";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib";
+            targetName: string;
+        }[];
+        template?: boolean | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }, {
+        id: string;
+        type: "component" | "hook" | "util" | "block";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib";
+            targetName: string;
+        }[];
+        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;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        id: string;
+        type: "component" | "hook" | "util" | "block";
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        status: "stable" | "experimental" | "deprecated";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib";
+            targetName: string;
+        }[];
+        template?: boolean | 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;
+}, {
+    entries: {
+        id: string;
+        type: "component" | "hook" | "util" | "block";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib";
+            targetName: string;
+        }[];
+        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;
+    }[];
+    schemaVersion: 1;
+    package: "ui";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
     $schema?: string | undefined;
 }>;
 
+/**
+ * Tailwind CSS major version that the project consumes.
+ * Used by integration tooling (skills) to choose the correct token entry file.
+ */
+declare const TailwindVersionSchema: z.ZodEnum<["v3", "v4"]>;
+/**
+ * Aliases for ui entry write-back paths in the consumer project.
+ * Keys mirror shadcn `components.json` aliases for familiarity.
+ */
+declare const UiAliasesSchema: z.ZodObject<{
+    components: z.ZodString;
+    hooks: z.ZodString;
+    utils: z.ZodString;
+    lib: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    components: string;
+    hooks: string;
+    utils: string;
+    lib: string;
+}, {
+    components: string;
+    hooks: string;
+    utils: string;
+    lib: string;
+}>;
 /**
  * Package entry within a project config.
+ *
+ * Some fields only apply to specific packages:
+ * - `tailwind` — design only
+ * - `ides` / `scope` — skills only
+ * - `aliases` / `iconLibrary` / `tsx` / `rsc` — ui only
+ *
+ * All package-specific fields are optional at the schema level so a single
+ * `PackageEntrySchema` can describe every package family.
  */
 declare const PackageEntrySchema: z.ZodObject<{
-    /** Variant identifier (e.g. "opentrek") */
+    /** Variant identifier (e.g. "opentrek"; use "_flat" for skills/ui) */
     variant: z.ZodString;
     /** Semver version string */
     version: z.ZodString;
+    /** Tailwind CSS version this project uses (only meaningful for design package). */
+    tailwind: z.ZodOptional<z.ZodEnum<["v3", "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). */
+    scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
+    /** Path aliases for ui entry installation (only meaningful for ui package). */
+    aliases: z.ZodOptional<z.ZodObject<{
+        components: z.ZodString;
+        hooks: z.ZodString;
+        utils: z.ZodString;
+        lib: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        components: string;
+        hooks: string;
+        utils: string;
+        lib: string;
+    }, {
+        components: string;
+        hooks: string;
+        utils: string;
+        lib: string;
+    }>>;
+    /**
+     * Default icon library declared by the project (only meaningful for ui).
+     * Declarative only — does NOT trigger code rewrites; ui entries hardcode imports.
+     */
+    iconLibrary: z.ZodOptional<z.ZodString>;
+    /** Whether the project uses TSX (true) or JSX (false). ui-specific. */
+    tsx: z.ZodOptional<z.ZodBoolean>;
+    /** Whether to emit React Server Components markers (`"use client"`). ui-specific. */
+    rsc: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     variant: string;
     version: string;
+    ides?: ("qoder" | "claude")[] | undefined;
+    scope?: "project" | "global" | undefined;
+    tailwind?: "v3" | "v4" | undefined;
+    aliases?: {
+        components: string;
+        hooks: string;
+        utils: string;
+        lib: string;
+    } | undefined;
+    iconLibrary?: string | undefined;
+    tsx?: boolean | undefined;
+    rsc?: boolean | undefined;
 }, {
     variant: string;
     version: string;
+    ides?: ("qoder" | "claude")[] | undefined;
+    scope?: "project" | "global" | undefined;
+    tailwind?: "v3" | "v4" | undefined;
+    aliases?: {
+        components: string;
+        hooks: string;
+        utils: string;
+        lib: string;
+    } | undefined;
+    iconLibrary?: string | undefined;
+    tsx?: boolean | undefined;
+    rsc?: boolean | undefined;
 }>;
 /**
  * Project configuration schema — teamix-evo config.json at project root.
@@ -184,16 +762,72 @@ declare const ProjectConfigSchema: z.ZodObject<{
     ide: z.ZodString;
     /** Installed packages keyed by package name */
     packages: z.ZodRecord<z.ZodString, z.ZodObject<{
-        /** Variant identifier (e.g. "opentrek") */
+        /** Variant identifier (e.g. "opentrek"; use "_flat" for skills/ui) */
         variant: z.ZodString;
         /** Semver version string */
         version: z.ZodString;
+        /** Tailwind CSS version this project uses (only meaningful for design package). */
+        tailwind: z.ZodOptional<z.ZodEnum<["v3", "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). */
+        scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
+        /** Path aliases for ui entry installation (only meaningful for ui package). */
+        aliases: z.ZodOptional<z.ZodObject<{
+            components: z.ZodString;
+            hooks: z.ZodString;
+            utils: z.ZodString;
+            lib: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            components: string;
+            hooks: string;
+            utils: string;
+            lib: string;
+        }, {
+            components: string;
+            hooks: string;
+            utils: string;
+            lib: string;
+        }>>;
+        /**
+         * Default icon library declared by the project (only meaningful for ui).
+         * Declarative only — does NOT trigger code rewrites; ui entries hardcode imports.
+         */
+        iconLibrary: z.ZodOptional<z.ZodString>;
+        /** Whether the project uses TSX (true) or JSX (false). ui-specific. */
+        tsx: z.ZodOptional<z.ZodBoolean>;
+        /** Whether to emit React Server Components markers (`"use client"`). ui-specific. */
+        rsc: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         variant: string;
         version: string;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
+        tailwind?: "v3" | "v4" | undefined;
+        aliases?: {
+            components: string;
+            hooks: string;
+            utils: string;
+            lib: string;
+        } | undefined;
+        iconLibrary?: string | undefined;
+        tsx?: boolean | undefined;
+        rsc?: boolean | undefined;
     }, {
         variant: string;
         version: string;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
+        tailwind?: "v3" | "v4" | undefined;
+        aliases?: {
+            components: string;
+            hooks: string;
+            utils: string;
+            lib: string;
+        } | undefined;
+        iconLibrary?: string | undefined;
+        tsx?: boolean | undefined;
+        rsc?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     schemaVersion: 1;
@@ -201,6 +835,18 @@ declare const ProjectConfigSchema: z.ZodObject<{
     packages: Record<string, {
         variant: string;
         version: string;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
+        tailwind?: "v3" | "v4" | undefined;
+        aliases?: {
+            components: string;
+            hooks: string;
+            utils: string;
+            lib: string;
+        } | undefined;
+        iconLibrary?: string | undefined;
+        tsx?: boolean | undefined;
+        rsc?: boolean | undefined;
     }>;
     $schema?: string | undefined;
 }, {
@@ -209,32 +855,56 @@ declare const ProjectConfigSchema: z.ZodObject<{
     packages: Record<string, {
         variant: string;
         version: string;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
+        tailwind?: "v3" | "v4" | undefined;
+        aliases?: {
+            components: string;
+            hooks: string;
+            utils: string;
+            lib: string;
+        } | undefined;
+        iconLibrary?: string | undefined;
+        tsx?: boolean | undefined;
+        rsc?: boolean | undefined;
     }>;
     $schema?: string | undefined;
 }>;
 
 /**
  * An installed resource entry — tracks individual resource installation state.
+ *
+ * For type="skill" resources, the same logical skill may produce multiple installed
+ * entries (one per ide × scope combination); the optional `ide`/`scope` fields
+ * disambiguate them.
  */
 declare const InstalledResourceSchema: z.ZodObject<{
     /** Resource identifier matching the variant manifest */
     id: z.ZodString;
-    /** Target path where the resource was installed */
+    /** Target path where the resource was installed (absolute or project-relative) */
     target: z.ZodString;
     /** Content hash for change detection (e.g. "sha256:...") */
     hash: z.ZodString;
     /** Update strategy that was applied */
     strategy: z.ZodEnum<["frozen", "regenerable", "managed"]>;
+    /** IDE this resource was installed for (skill resources only) */
+    ide: z.ZodOptional<z.ZodEnum<["qoder", "claude"]>>;
+    /** Install scope (skill resources only) */
+    scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     target: string;
     hash: string;
     strategy: "frozen" | "regenerable" | "managed";
+    scope?: "project" | "global" | undefined;
+    ide?: "qoder" | "claude" | undefined;
 }, {
     id: string;
     target: string;
     hash: string;
     strategy: "frozen" | "regenerable" | "managed";
+    scope?: "project" | "global" | undefined;
+    ide?: "qoder" | "claude" | undefined;
 }>;
 /**
  * An installed package entry — tracks a single package installation.
@@ -242,7 +912,7 @@ declare const InstalledResourceSchema: z.ZodObject<{
 declare const InstalledPackageSchema: z.ZodObject<{
     /** Full package name (e.g. "@teamix-evo/design") */
     package: z.ZodString;
-    /** Variant identifier */
+    /** Variant identifier (use "_flat" for non-variant packages such as skills) */
     variant: z.ZodString;
     /** Installed version */
     version: z.ZodString;
@@ -252,22 +922,30 @@ declare const InstalledPackageSchema: z.ZodObject<{
     resources: z.ZodArray<z.ZodObject<{
         /** Resource identifier matching the variant manifest */
         id: z.ZodString;
-        /** Target path where the resource was installed */
+        /** Target path where the resource was installed (absolute or project-relative) */
         target: z.ZodString;
         /** Content hash for change detection (e.g. "sha256:...") */
         hash: z.ZodString;
         /** Update strategy that was applied */
         strategy: z.ZodEnum<["frozen", "regenerable", "managed"]>;
+        /** IDE this resource was installed for (skill resources only) */
+        ide: z.ZodOptional<z.ZodEnum<["qoder", "claude"]>>;
+        /** Install scope (skill resources only) */
+        scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
     }, "strip", z.ZodTypeAny, {
         id: string;
         target: string;
         hash: string;
         strategy: "frozen" | "regenerable" | "managed";
+        scope?: "project" | "global" | undefined;
+        ide?: "qoder" | "claude" | undefined;
     }, {
         id: string;
         target: string;
         hash: string;
         strategy: "frozen" | "regenerable" | "managed";
+        scope?: "project" | "global" | undefined;
+        ide?: "qoder" | "claude" | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     package: string;
@@ -278,6 +956,8 @@ declare const InstalledPackageSchema: z.ZodObject<{
         target: string;
         hash: string;
         strategy: "frozen" | "regenerable" | "managed";
+        scope?: "project" | "global" | undefined;
+        ide?: "qoder" | "claude" | undefined;
     }[];
     installedAt: string;
 }, {
@@ -289,6 +969,8 @@ declare const InstalledPackageSchema: z.ZodObject<{
         target: string;
         hash: string;
         strategy: "frozen" | "regenerable" | "managed";
+        scope?: "project" | "global" | undefined;
+        ide?: "qoder" | "claude" | undefined;
     }[];
     installedAt: string;
 }>;
@@ -302,7 +984,7 @@ declare const InstalledManifestSchema: z.ZodObject<{
     installed: z.ZodArray<z.ZodObject<{
         /** Full package name (e.g. "@teamix-evo/design") */
         package: z.ZodString;
-        /** Variant identifier */
+        /** Variant identifier (use "_flat" for non-variant packages such as skills) */
         variant: z.ZodString;
         /** Installed version */
         version: z.ZodString;
@@ -312,22 +994,30 @@ declare const InstalledManifestSchema: z.ZodObject<{
         resources: z.ZodArray<z.ZodObject<{
             /** Resource identifier matching the variant manifest */
             id: z.ZodString;
-            /** Target path where the resource was installed */
+            /** Target path where the resource was installed (absolute or project-relative) */
             target: z.ZodString;
             /** Content hash for change detection (e.g. "sha256:...") */
             hash: z.ZodString;
             /** Update strategy that was applied */
             strategy: z.ZodEnum<["frozen", "regenerable", "managed"]>;
+            /** IDE this resource was installed for (skill resources only) */
+            ide: z.ZodOptional<z.ZodEnum<["qoder", "claude"]>>;
+            /** Install scope (skill resources only) */
+            scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
         }, "strip", z.ZodTypeAny, {
             id: string;
             target: string;
             hash: string;
             strategy: "frozen" | "regenerable" | "managed";
+            scope?: "project" | "global" | undefined;
+            ide?: "qoder" | "claude" | undefined;
         }, {
             id: string;
             target: string;
             hash: string;
             strategy: "frozen" | "regenerable" | "managed";
+            scope?: "project" | "global" | undefined;
+            ide?: "qoder" | "claude" | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         package: string;
@@ -338,6 +1028,8 @@ declare const InstalledManifestSchema: z.ZodObject<{
             target: string;
             hash: string;
             strategy: "frozen" | "regenerable" | "managed";
+            scope?: "project" | "global" | undefined;
+            ide?: "qoder" | "claude" | undefined;
         }[];
         installedAt: string;
     }, {
@@ -349,6 +1041,8 @@ declare const InstalledManifestSchema: z.ZodObject<{
             target: string;
             hash: string;
             strategy: "frozen" | "regenerable" | "managed";
+            scope?: "project" | "global" | undefined;
+            ide?: "qoder" | "claude" | undefined;
         }[];
         installedAt: string;
     }>, "many">;
@@ -363,6 +1057,8 @@ declare const InstalledManifestSchema: z.ZodObject<{
             target: string;
             hash: string;
             strategy: "frozen" | "regenerable" | "managed";
+            scope?: "project" | "global" | undefined;
+            ide?: "qoder" | "claude" | undefined;
         }[];
         installedAt: string;
     }[];
@@ -377,6 +1073,8 @@ declare const InstalledManifestSchema: z.ZodObject<{
             target: string;
             hash: string;
             strategy: "frozen" | "regenerable" | "managed";
+            scope?: "project" | "global" | undefined;
+            ide?: "qoder" | "claude" | undefined;
         }[];
         installedAt: string;
     }[];
@@ -386,12 +1084,34 @@ declare const InstalledManifestSchema: z.ZodObject<{
 type UpdateStrategy = z.infer<typeof UpdateStrategySchema>;
 /** Resource type discriminator */
 type ResourceType = z.infer<typeof ResourceTypeSchema>;
+/** AI IDE identifier supported by skills (qoder | claude) */
+type SkillIde = z.infer<typeof SkillIdeSchema>;
+/** Skill installation scope (project | global) */
+type SkillScope = z.infer<typeof SkillScopeSchema>;
+/** UI entry type discriminator */
+type UiEntryType = z.infer<typeof UiEntryTypeSchema>;
+/** UI write-back alias key (components | hooks | utils | lib) */
+type UiAlias = z.infer<typeof UiAliasSchema>;
 /** A single resource entry within a variant manifest */
 type Resource = z.infer<typeof ResourceSchema>;
 /** Variant manifest describing a package variant and its resources */
 type VariantManifest = z.infer<typeof VariantManifestSchema>;
+/** A single skill entry in a skills package manifest */
+type SkillEntry = z.infer<typeof SkillEntrySchema>;
+/** Skills package manifest (top-level manifest of @teamix-evo/skills) */
+type SkillsPackageManifest = z.infer<typeof SkillsPackageManifestSchema>;
+/** A single file shipped by a UI entry */
+type UiEntryFile = z.infer<typeof UiEntryFileSchema>;
+/** A single UI entry (component / hook / util / block) */
+type UiEntry = z.infer<typeof UiEntrySchema>;
+/** UI package manifest (top-level manifest of @teamix-evo/ui) */
+type UiPackageManifest = z.infer<typeof UiPackageManifestSchema>;
+/** Path aliases for UI entry installation in the consumer project */
+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") */
+type TailwindVersion = z.infer<typeof TailwindVersionSchema>;
 /** Project configuration (config.json) */
 type ProjectConfig = z.infer<typeof ProjectConfigSchema>;
 /** An installed resource tracking entry */
@@ -431,6 +1151,29 @@ type Result<T> = {
  * @throws Error if the file cannot be read or the manifest is invalid
  */
 declare function loadVariantManifest(packageDir: string): Promise<VariantManifest>;
+/**
+ * Load and validate the top-level manifest of a skills package.
+ *
+ * Reads `manifest.json` from the given directory and validates it against
+ * the SkillsPackageManifest schema (flat list of skills, no variants).
+ *
+ * @param packageDir - Absolute or relative path to the skills package directory
+ * @returns The validated SkillsPackageManifest
+ * @throws Error if the file cannot be read or the manifest is invalid
+ */
+declare function loadSkillsPackageManifest(packageDir: string): Promise<SkillsPackageManifest>;
+/**
+ * Load and validate the top-level manifest of a UI package.
+ *
+ * Reads `manifest.json` from the given directory and validates it against
+ * the UiPackageManifest schema (flat list of entries, no variants).
+ * Also performs registryDependencies graph validation (existence + no cycles).
+ *
+ * @param packageDir - Absolute or relative path to the ui package directory
+ * @returns The validated UiPackageManifest
+ * @throws Error if the file cannot be read, the manifest is invalid, or the dep graph is broken
+ */
+declare function loadUiPackageManifest(packageDir: string): Promise<UiPackageManifest>;
 
 /**
  * Validate unknown data against the VariantManifest schema.
@@ -445,6 +1188,35 @@ 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 SkillsPackageManifest schema.
+ */
+declare function validateSkillsPackage(data: unknown): Result<SkillsPackageManifest>;
+/**
+ * Validate unknown data against the UiPackageManifest schema, then verify the
+ * registryDependencies graph: every reference resolves and there are no cycles.
+ */
+declare function validateUiPackage(data: unknown): Result<UiPackageManifest>;
+/**
+ * Validate the registryDependencies graph among ui entries.
+ * Returns a list of issue strings (empty when the graph is sound).
+ *
+ * Issues detected:
+ * - Duplicate entry id
+ * - Reference to an unknown entry id
+ * - Cyclic dependency
+ */
+declare function validateUiDependencyGraph(entries: UiEntry[]): string[];
+/**
+ * Topologically sort a subset of ui entries so that dependencies come before
+ * dependents. Used by `ui add` to determine install order.
+ *
+ * @param entries  full list of entries (the package manifest's `entries`)
+ * @param requested ids the user explicitly asked to install
+ * @returns ordered list of entry ids (includes transitive deps, dedup'd)
+ * @throws Error if a requested id or transitive dep is missing or graph has cycles
+ */
+declare function resolveUiEntryOrder(entries: UiEntry[], requested: string[]): string[];
 
 /**
  * Parse all managed regions from document content.
@@ -502,4 +1274,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 UpdateAction, type UpdateActionOptions, type UpdateStrategy, UpdateStrategySchema, type VariantManifest, VariantManifestSchema, getUpdateAction, hasManagedRegion, loadVariantManifest, parseManagedRegions, replaceManagedRegion, shouldUpdate, validateConfig, validateInstalled, validateManifest };
+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 };