@teamix-evo/registry 0.3.0 → 0.6.0

package/dist/index.js

@@ -89,13 +89,27 @@ var SkillEntrySchema = 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: z.string().optional()
+  variant: 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 = z.object({
   $schema: z.string().optional(),
@@ -155,8 +169,8 @@ var UiEntrySchema = z.object({
   files: 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: z.string().optional(),
   /** Other UI entries this one depends on (e.g. "button" depends on "cn") */
@@ -208,73 +222,81 @@ var UiPackageManifestSchema = z.object({
   engines: z.object({
     "teamix-evo": z.string().min(1)
   }),
-  /** Flat list of entries shipped by this package */
-  entries: z.array(UiEntrySchema)
+  /** Active list of entries shipped (and exposed) by this package. */
+  entries: 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: z.array(UiEntrySchema).optional()
 });
 
-// src/schema/design-pack.ts
+// src/schema/tokens-pack.ts
 import { z as z2 } from "zod";
 var VARIANT_NAME_RE = /^[a-z][a-z0-9-]*$/;
 var SEMVER_RE = /^\d+\.\d+\.\d+/;
-var DesignPackLinkedSchema = z2.object({
+var TokensPackLinkedSchema = z2.object({
   "biz-ui": z2.string().optional(),
   templates: z2.string().optional()
 });
-var DesignPackManifestSchema = z2.object({
-  $schema: z2.string().optional(),
-  schemaVersion: z2.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 = z2.object({
+  /** Variant id — lowercase kebab-case. */
   name: z2.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(z2.literal("_template")).or(z2.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: z2.string().min(1),
-  /** Semver. */
+  /** Variant version — semver. May trail the package version when only a subset of variants change. */
   version: z2.string().regex(SEMVER_RE, "Invalid semver version"),
+  /** Optional one-liner description; surfaced in `tokens list-variants` output. */
+  description: z2.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: z2.string().optional(),
-  /** Optional one-liner; useful for `design list-variants` output. */
-  description: z2.string().optional(),
-  /** Soft cross-package links (biz-ui / templates with same variant name). */
-  linked: DesignPackLinkedSchema.optional()
+  files: z2.array(z2.string().min(1)).min(1),
+  /** Soft cross-package links (biz-ui / templates with the same variant name). */
+  linked: TokensPackLinkedSchema.optional()
 });
-var DesignPackageManifestSchema = z2.object({
+var TokensPackageManifestSchema = z2.object({
   $schema: z2.string().optional(),
   schemaVersion: z2.literal(1),
-  /** Always `"design"` for this package. */
-  package: z2.literal("design"),
-  /** Semver of the entire design package. */
+  /** Always `"tokens"` — disambiguates from other teamix-evo package manifests. */
+  package: z2.literal("tokens"),
+  /** Semver of the entire tokens package. */
   version: z2.string().regex(SEMVER_RE, "Invalid semver version"),
   /** Engine compatibility. */
   engines: z2.object({ "teamix-evo": z2.string().min(1) }),
-  /** The default baseline pack — always present. */
-  default: DesignPackManifestSchema,
-  /** All shipped variants (excluding `_template/`). */
-  variants: z2.array(DesignPackManifestSchema)
+  /** Optional package-level description. */
+  description: z2.string().optional(),
+  /** All shipped variants (excluding scaffold dirs that begin with `_`). */
+  variants: z2.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: z2.array(z2.string()).optional()
 });
-var DesignPackLockSchema = z2.object({
+var TokensPackLockSchema = z2.object({
   $schema: z2.string().optional(),
   schemaVersion: z2.literal(1),
-  default: z2.object({
-    version: z2.string().regex(SEMVER_RE),
-    from: z2.string().min(1)
-    // e.g. "@teamix-evo/design"
-  }),
   variant: z2.object({
     name: z2.string().min(1),
     displayName: z2.string().min(1),
     version: z2.string().regex(SEMVER_RE),
     from: z2.string().min(1)
+    // e.g. "@teamix-evo/tokens"
   }),
-  linked: DesignPackLinkedSchema.optional(),
+  /** Tokens package version — useful when variant version trails the package. */
+  packageVersion: z2.string().regex(SEMVER_RE),
+  linked: TokensPackLinkedSchema.optional(),
   installedAt: z2.string().datetime()
 });
 
@@ -394,7 +416,7 @@ var InstalledResourceSchema = z5.object({
   scope: SkillScopeSchema.optional()
 });
 var InstalledPackageSchema = z5.object({
-  /** Full package name (e.g. "@teamix-evo/design") */
+  /** Full package name (e.g. "@teamix-evo/tokens") */
   package: z5.string().min(1),
   /** Variant identifier (use "_flat" for non-variant packages such as skills) */
   variant: z5.string().min(1),
@@ -685,143 +707,43 @@ async function loadUiPackageManifest(packageDir) {
   return result.data;
 }
 
-// src/design-pack-loader.ts
+// src/tokens-pack-loader.ts
 import * as fs2 from "fs/promises";
 import * as path2 from "path";
-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
@@ -1000,10 +922,6 @@ function getUpdateAction(strategy, options) {
   }
 }
 export {
-  DesignPackLinkedSchema,
-  DesignPackLockSchema,
-  DesignPackManifestSchema,
-  DesignPackageManifestSchema,
   InstalledManifestSchema,
   InstalledPackageSchema,
   InstalledResourceSchema,
@@ -1018,6 +936,10 @@ export {
   SkillsLockSchema,
   SkillsPackageManifestSchema,
   TailwindVersionSchema,
+  TokensPackLinkedSchema,
+  TokensPackLockSchema,
+  TokensPackageManifestSchema,
+  TokensVariantEntrySchema,
   UiAliasSchema,
   UiAliasesSchema,
   UiEntryFileSchema,
@@ -1030,15 +952,14 @@ export {
   VariantUiPackageManifestSchema,
   VariantUiPackageNameSchema,
   getUpdateAction,
+  getVariantEntry,
   hasManagedRegion,
-  loadDesignPack,
-  loadDesignPackageManifest,
   loadSkillsPackageManifest,
+  loadTokensPackageManifest,
   loadUiPackageManifest,
   loadVariantManifest,
   loadVariantUiPackageCatalog,
   loadVariantUiPackageManifest,
-  mergeDefaultAndVariant,
   parseManagedRegions,
   replaceManagedRegion,
   resolveUiEntryOrder,
@@ -1049,7 +970,6 @@ export {
   validateSkillsLock,
   validateSkillsPackage,
   validateUiDependencyGraph,
-  validateUiPackage,
-  walkPackTree
+  validateUiPackage
 };
 //# sourceMappingURL=index.js.map