@teamix-evo/registry 0.3.0 → 0.6.0

package/dist/index.cjs

@@ -30,10 +30,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  DesignPackLinkedSchema: () => DesignPackLinkedSchema,
-  DesignPackLockSchema: () => DesignPackLockSchema,
-  DesignPackManifestSchema: () => DesignPackManifestSchema,
-  DesignPackageManifestSchema: () => DesignPackageManifestSchema,
   InstalledManifestSchema: () => InstalledManifestSchema,
   InstalledPackageSchema: () => InstalledPackageSchema,
   InstalledResourceSchema: () => InstalledResourceSchema,
@@ -48,6 +44,10 @@ __export(index_exports, {
   SkillsLockSchema: () => SkillsLockSchema,
   SkillsPackageManifestSchema: () => SkillsPackageManifestSchema,
   TailwindVersionSchema: () => TailwindVersionSchema,
+  TokensPackLinkedSchema: () => TokensPackLinkedSchema,
+  TokensPackLockSchema: () => TokensPackLockSchema,
+  TokensPackageManifestSchema: () => TokensPackageManifestSchema,
+  TokensVariantEntrySchema: () => TokensVariantEntrySchema,
   UiAliasSchema: () => UiAliasSchema,
   UiAliasesSchema: () => UiAliasesSchema,
   UiEntryFileSchema: () => UiEntryFileSchema,
@@ -60,15 +60,14 @@ __export(index_exports, {
   VariantUiPackageManifestSchema: () => VariantUiPackageManifestSchema,
   VariantUiPackageNameSchema: () => VariantUiPackageNameSchema,
   getUpdateAction: () => getUpdateAction,
+  getVariantEntry: () => getVariantEntry,
   hasManagedRegion: () => hasManagedRegion,
-  loadDesignPack: () => loadDesignPack,
-  loadDesignPackageManifest: () => loadDesignPackageManifest,
   loadSkillsPackageManifest: () => loadSkillsPackageManifest,
+  loadTokensPackageManifest: () => loadTokensPackageManifest,
   loadUiPackageManifest: () => loadUiPackageManifest,
   loadVariantManifest: () => loadVariantManifest,
   loadVariantUiPackageCatalog: () => loadVariantUiPackageCatalog,
   loadVariantUiPackageManifest: () => loadVariantUiPackageManifest,
-  mergeDefaultAndVariant: () => mergeDefaultAndVariant,
   parseManagedRegions: () => parseManagedRegions,
   replaceManagedRegion: () => replaceManagedRegion,
   resolveUiEntryOrder: () => resolveUiEntryOrder,
@@ -79,8 +78,7 @@ __export(index_exports, {
   validateSkillsLock: () => validateSkillsLock,
   validateSkillsPackage: () => validateSkillsPackage,
   validateUiDependencyGraph: () => validateUiDependencyGraph,
-  validateUiPackage: () => validateUiPackage,
-  walkPackTree: () => walkPackTree
+  validateUiPackage: () => validateUiPackage
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -175,13 +173,27 @@ var SkillEntrySchema = import_zod.z.object({
    * coding-conventions, baseline design-rules) leave it unset.
    *
    * When present, the CLI installs this skill ONLY if the consumer's
-   * `.teamix-evo/design/pack.lock.json` records the same variant. MUST equal
-   * the variant directory name in `@teamix-evo/design/variants/<name>/`.
+   * `.teamix-evo/tokens-lock.json` records the same variant. MUST equal
+   * the variant directory name in `@teamix-evo/tokens/variants/<name>/`.
    *
    * Mirrors `UiEntrySchema.variant` semantics in @teamix-evo/biz-ui &
    * @teamix-evo/templates per ADR 0014.
    */
-  variant: import_zod.z.string().optional()
+  variant: import_zod.z.string().optional(),
+  /**
+   * Default install scope for this skill. Per ADR 0033.
+   *
+   * - `"global"`  — entry skill (lifecycle / orchestrator). `skills add` in
+   *                 project scope SKIPS these unless explicitly named on the
+   *                 command line (then installs with a warning). Recommended
+   *                 to install once via `skills add <id> --scope global`.
+   * - `"project"` — variant content skill (default when omitted). Installed
+   *                 with the project that uses it.
+   *
+   * `undefined` is treated as `"project"` — old manifests without this field
+   * still validate.
+   */
+  scope: SkillScopeSchema.optional()
 });
 var SkillsPackageManifestSchema = import_zod.z.object({
   $schema: import_zod.z.string().optional(),
@@ -241,8 +253,8 @@ var UiEntrySchema = import_zod.z.object({
   files: import_zod.z.array(UiEntryFileSchema).min(1),
   /**
    * Optional path to an AI-readable meta document (frontmatter + Markdown).
-   * When set, CLI install drops it at `.teamix-evo/design/components/<id>.meta.md`
-   * for design's ai-rules to consume.
+   * Read directly from `@teamix-evo/ui` by MCP at runtime — no consumer-side
+   * copy is written (per ADR 0020 §3).
    */
   meta: import_zod.z.string().optional(),
   /** Other UI entries this one depends on (e.g. "button" depends on "cn") */
@@ -294,73 +306,81 @@ var UiPackageManifestSchema = import_zod.z.object({
   engines: import_zod.z.object({
     "teamix-evo": import_zod.z.string().min(1)
   }),
-  /** Flat list of entries shipped by this package */
-  entries: import_zod.z.array(UiEntrySchema)
+  /** Active list of entries shipped (and exposed) by this package. */
+  entries: import_zod.z.array(UiEntrySchema),
+  /**
+   * Archived entries that are kept in source for Storybook documentation only
+   * and are NOT exposed through the active distribution chain. Per ADR 0028:
+   *   - `teamix-evo ui add <id>` rejects ids found here unless `--include-deprecated` is passed
+   *   - MCP `list_components` / `find_components` exclude these by default
+   *   - Storybook keeps the story under `废弃 · Deprecated/` with a banner
+   * Optional for backwards compatibility — older manifests without this field
+   * still validate.
+   */
+  deprecatedEntries: import_zod.z.array(UiEntrySchema).optional()
 });
 
-// src/schema/design-pack.ts
+// src/schema/tokens-pack.ts
 var import_zod2 = require("zod");
 var VARIANT_NAME_RE = /^[a-z][a-z0-9-]*$/;
 var SEMVER_RE = /^\d+\.\d+\.\d+/;
-var DesignPackLinkedSchema = import_zod2.z.object({
+var TokensPackLinkedSchema = import_zod2.z.object({
   "biz-ui": import_zod2.z.string().optional(),
   templates: import_zod2.z.string().optional()
 });
-var DesignPackManifestSchema = import_zod2.z.object({
-  $schema: import_zod2.z.string().optional(),
-  schemaVersion: import_zod2.z.literal(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`)
-   */
+var TokensVariantEntrySchema = import_zod2.z.object({
+  /** Variant id — lowercase kebab-case. */
   name: import_zod2.z.string().min(1).regex(
     VARIANT_NAME_RE,
-    'Pack name must be lowercase letters/digits/hyphens (no leading hyphen). Special: "_template" allowed for the variant scaffold.'
-  ).or(import_zod2.z.literal("_template")).or(import_zod2.z.literal("default")),
+    "Variant name must be lowercase letters/digits/hyphens (no leading hyphen)."
+  ),
   /** Human-readable display name (e.g. "OpenTrek" for variant id "opentrek"). */
   displayName: import_zod2.z.string().min(1),
-  /** Semver. */
+  /** Variant version — semver. May trail the package version when only a subset of variants change. */
   version: import_zod2.z.string().regex(SEMVER_RE, "Invalid semver version"),
+  /** Optional one-liner description; surfaced in `tokens list-variants` output. */
+  description: import_zod2.z.string().optional(),
   /**
-   * Parent pack name. Required for variants, must be omitted for `default`.
-   * Currently only `"default"` is a valid parent.
+   * Files this variant advertises, paths relative to the tokens package root
+   * (e.g. `variants/opentrek/theme.css`). The validator walks these to
+   * confirm presence; the CLI consumes them at install time.
    */
-  extends: import_zod2.z.string().optional(),
-  /** Optional one-liner; useful for `design list-variants` output. */
-  description: import_zod2.z.string().optional(),
-  /** Soft cross-package links (biz-ui / templates with same variant name). */
-  linked: DesignPackLinkedSchema.optional()
+  files: import_zod2.z.array(import_zod2.z.string().min(1)).min(1),
+  /** Soft cross-package links (biz-ui / templates with the same variant name). */
+  linked: TokensPackLinkedSchema.optional()
 });
-var DesignPackageManifestSchema = import_zod2.z.object({
+var TokensPackageManifestSchema = import_zod2.z.object({
   $schema: import_zod2.z.string().optional(),
   schemaVersion: import_zod2.z.literal(1),
-  /** Always `"design"` for this package. */
-  package: import_zod2.z.literal("design"),
-  /** Semver of the entire design package. */
+  /** Always `"tokens"` — disambiguates from other teamix-evo package manifests. */
+  package: import_zod2.z.literal("tokens"),
+  /** Semver of the entire tokens package. */
   version: import_zod2.z.string().regex(SEMVER_RE, "Invalid semver version"),
   /** Engine compatibility. */
   engines: import_zod2.z.object({ "teamix-evo": import_zod2.z.string().min(1) }),
-  /** The default baseline pack — always present. */
-  default: DesignPackManifestSchema,
-  /** All shipped variants (excluding `_template/`). */
-  variants: import_zod2.z.array(DesignPackManifestSchema)
+  /** Optional package-level description. */
+  description: import_zod2.z.string().optional(),
+  /** All shipped variants (excluding scaffold dirs that begin with `_`). */
+  variants: import_zod2.z.array(TokensVariantEntrySchema),
+  /**
+   * Reserved for future shared assets that span variants (e.g. browser
+   * quirks resets co-shipped at the package root). Empty array today.
+   */
+  shared: import_zod2.z.array(import_zod2.z.string()).optional()
 });
-var DesignPackLockSchema = import_zod2.z.object({
+var TokensPackLockSchema = import_zod2.z.object({
   $schema: import_zod2.z.string().optional(),
   schemaVersion: import_zod2.z.literal(1),
-  default: import_zod2.z.object({
-    version: import_zod2.z.string().regex(SEMVER_RE),
-    from: import_zod2.z.string().min(1)
-    // e.g. "@teamix-evo/design"
-  }),
   variant: import_zod2.z.object({
     name: import_zod2.z.string().min(1),
     displayName: import_zod2.z.string().min(1),
     version: import_zod2.z.string().regex(SEMVER_RE),
     from: import_zod2.z.string().min(1)
+    // e.g. "@teamix-evo/tokens"
   }),
-  linked: DesignPackLinkedSchema.optional(),
+  /** Tokens package version — useful when variant version trails the package. */
+  packageVersion: import_zod2.z.string().regex(SEMVER_RE),
+  linked: TokensPackLinkedSchema.optional(),
   installedAt: import_zod2.z.string().datetime()
 });
 
@@ -480,7 +500,7 @@ var InstalledResourceSchema = import_zod5.z.object({
   scope: SkillScopeSchema.optional()
 });
 var InstalledPackageSchema = import_zod5.z.object({
-  /** Full package name (e.g. "@teamix-evo/design") */
+  /** Full package name (e.g. "@teamix-evo/tokens") */
   package: import_zod5.z.string().min(1),
   /** Variant identifier (use "_flat" for non-variant packages such as skills) */
   variant: import_zod5.z.string().min(1),
@@ -771,143 +791,43 @@ async function loadUiPackageManifest(packageDir) {
   return result.data;
 }
 
-// src/design-pack-loader.ts
+// src/tokens-pack-loader.ts
 var fs2 = __toESM(require("fs/promises"), 1);
 var path2 = __toESM(require("path"), 1);
-var PACK_METADATA_FILES = /* @__PURE__ */ new Set(["pack.json"]);
-async function loadDesignPack(packDir) {
-  const manifestPath = path2.join(packDir, "pack.json");
+async function loadTokensPackageManifest(packageDir) {
+  const manifestPath = path2.join(packageDir, "manifest.json");
   let raw;
   try {
     raw = await fs2.readFile(manifestPath, "utf-8");
   } catch (err) {
     const code = err.code;
     if (code === "ENOENT") {
-      throw new Error(`Design pack manifest not found: ${manifestPath}`);
+      throw new Error(`Tokens package manifest not found: ${manifestPath}`);
     }
     throw new Error(
-      `Failed to read design pack manifest at ${manifestPath}: ${err.message}`
+      `Failed to read tokens package manifest at ${manifestPath}: ${err.message}`
     );
   }
   let parsed;
   try {
     parsed = JSON.parse(raw);
   } catch {
-    throw new Error(`Invalid JSON in design pack manifest at ${manifestPath}`);
-  }
-  const result = DesignPackManifestSchema.safeParse(parsed);
-  if (!result.success) {
-    throw new Error(
-      `Invalid design pack manifest:
-${result.error.message}
-  File: ${manifestPath}`
-    );
-  }
-  if (result.data.name === "default" && result.data.extends !== void 0) {
-    throw new Error(
-      `Pack "default" must not have "extends" field: ${manifestPath}`
-    );
-  }
-  if (result.data.name !== "default" && result.data.extends !== "default") {
-    throw new Error(
-      `Variant pack "${result.data.name}" must declare extends: "default" (got ${JSON.stringify(
-        result.data.extends
-      )}): ${manifestPath}`
-    );
-  }
-  return result.data;
-}
-async function loadDesignPackageManifest(packageDir) {
-  const manifestPath = path2.join(packageDir, "manifest.json");
-  let raw;
-  try {
-    raw = await fs2.readFile(manifestPath, "utf-8");
-  } catch (err) {
-    const code = err.code;
-    if (code === "ENOENT") {
-      throw new Error(`Design package manifest not found: ${manifestPath}`);
-    }
     throw new Error(
-      `Failed to read design package manifest at ${manifestPath}: ${err.message}`
+      `Invalid JSON in tokens package manifest at ${manifestPath}`
     );
   }
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    throw new Error(`Invalid JSON in design package manifest at ${manifestPath}`);
-  }
-  const result = DesignPackageManifestSchema.safeParse(parsed);
+  const result = TokensPackageManifestSchema.safeParse(parsed);
   if (!result.success) {
     throw new Error(
-      `Invalid design package manifest:
+      `Invalid tokens package manifest:
 ${result.error.message}
   File: ${manifestPath}`
     );
   }
   return result.data;
 }
-async function walkPackTree(packDir) {
-  const out = [];
-  async function recurse(absDir, relDir) {
-    const entries = await fs2.readdir(absDir, { withFileTypes: true });
-    for (const entry of entries) {
-      const abs = path2.join(absDir, entry.name);
-      const rel = relDir ? path2.posix.join(relDir, entry.name) : entry.name;
-      if (entry.isDirectory()) {
-        await recurse(abs, rel);
-      } else if (entry.isFile()) {
-        if (relDir === "" && PACK_METADATA_FILES.has(entry.name)) continue;
-        out.push(rel);
-      }
-    }
-  }
-  try {
-    await recurse(packDir, "");
-  } catch (err) {
-    const code = err.code;
-    if (code === "ENOENT") {
-      throw new Error(`Pack directory not found: ${packDir}`);
-    }
-    throw err;
-  }
-  return out.sort();
-}
-async function mergeDefaultAndVariant(defaultDir, variantDir) {
-  const defaultFiles = new Set(await walkPackTree(defaultDir));
-  const variantFiles = new Set(await walkPackTree(variantDir));
-  const overrides = [];
-  const variantAdds = [];
-  const defaultPassThrough = [];
-  const files = [];
-  const allPaths = Array.from(/* @__PURE__ */ new Set([...defaultFiles, ...variantFiles])).sort();
-  for (const rel of allPaths) {
-    const inDefault = defaultFiles.has(rel);
-    const inVariant = variantFiles.has(rel);
-    if (inVariant && inDefault) {
-      overrides.push(rel);
-      files.push({
-        relPath: rel,
-        sourcePath: path2.join(variantDir, rel),
-        origin: "variant"
-      });
-    } else if (inVariant) {
-      variantAdds.push(rel);
-      files.push({
-        relPath: rel,
-        sourcePath: path2.join(variantDir, rel),
-        origin: "variant"
-      });
-    } else {
-      defaultPassThrough.push(rel);
-      files.push({
-        relPath: rel,
-        sourcePath: path2.join(defaultDir, rel),
-        origin: "default"
-      });
-    }
-  }
-  return { files, overrides, variantAdds, defaultPassThrough };
+function getVariantEntry(catalog, variantName) {
+  return catalog.variants.find((v) => v.name === variantName);
 }
 
 // src/variant-ui-pack-loader.ts
@@ -1087,10 +1007,6 @@ function getUpdateAction(strategy, options) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  DesignPackLinkedSchema,
-  DesignPackLockSchema,
-  DesignPackManifestSchema,
-  DesignPackageManifestSchema,
   InstalledManifestSchema,
   InstalledPackageSchema,
   InstalledResourceSchema,
@@ -1105,6 +1021,10 @@ function getUpdateAction(strategy, options) {
   SkillsLockSchema,
   SkillsPackageManifestSchema,
   TailwindVersionSchema,
+  TokensPackLinkedSchema,
+  TokensPackLockSchema,
+  TokensPackageManifestSchema,
+  TokensVariantEntrySchema,
   UiAliasSchema,
   UiAliasesSchema,
   UiEntryFileSchema,
@@ -1117,15 +1037,14 @@ function getUpdateAction(strategy, options) {
   VariantUiPackageManifestSchema,
   VariantUiPackageNameSchema,
   getUpdateAction,
+  getVariantEntry,
   hasManagedRegion,
-  loadDesignPack,
-  loadDesignPackageManifest,
   loadSkillsPackageManifest,
+  loadTokensPackageManifest,
   loadUiPackageManifest,
   loadVariantManifest,
   loadVariantUiPackageCatalog,
   loadVariantUiPackageManifest,
-  mergeDefaultAndVariant,
   parseManagedRegions,
   replaceManagedRegion,
   resolveUiEntryOrder,
@@ -1136,7 +1055,6 @@ function getUpdateAction(strategy, options) {
   validateSkillsLock,
   validateSkillsPackage,
   validateUiDependencyGraph,
-  validateUiPackage,
-  walkPackTree
+  validateUiPackage
 });
 //# sourceMappingURL=index.cjs.map