teamix-evo 0.6.0 → 0.7.0

package/dist/core/index.d.ts

@@ -335,6 +335,61 @@ interface RunUiListResult {
  */
 declare function runUiList(options: RunUiListOptions): Promise<RunUiListResult>;
 
+interface RunVariantUiAddOptions {
+    /** Absolute project root directory. */
+    projectRoot: string;
+    /** Variant id (e.g. `"opentrek"`). */
+    variant: string;
+    /** Entry ids to install. */
+    ids: string[];
+    /** When true, overwrite frozen entries that already exist on disk. */
+    overwrite?: boolean;
+    /** Override the package name. */
+    packageName?: string;
+    /**
+     * Override resolution of the package root. When set, skips
+     * `require.resolve("<packageName>/package.json")`.
+     */
+    packageRoot?: string;
+}
+interface RunVariantUiAddResult {
+    packageName: string;
+    variant: string;
+    orderedIds: string[];
+    written: number;
+    skipped: number;
+    npmDependencies: Record<string, string>;
+    resources: InstalledResource[];
+}
+/** `teamix-evo biz-ui add <ids...> --variant <name>`. */
+declare function runBizUiAdd(options: RunVariantUiAddOptions): Promise<RunVariantUiAddResult>;
+/** `teamix-evo templates add <ids...> --variant <name>`. */
+declare function runTemplatesAdd(options: RunVariantUiAddOptions): Promise<RunVariantUiAddResult>;
+interface ListVariantUiResult {
+    packageName: string;
+    variants: Array<{
+        name: string;
+        displayName: string;
+        version: string;
+        description?: string;
+    }>;
+}
+declare function listBizUiVariants(packageRoot?: string): Promise<ListVariantUiResult>;
+declare function listTemplatesVariants(packageRoot?: string): Promise<ListVariantUiResult>;
+interface ListVariantUiEntriesResult {
+    packageName: string;
+    variant: string;
+    entries: Array<{
+        id: string;
+        name: string;
+        type: string;
+        description?: string;
+        registryDependencies: string[];
+    }>;
+}
+declare function listBizUiEntries(variant: string, packageRoot?: string): Promise<ListVariantUiEntriesResult>;
+declare function listTemplatesEntries(variant: string, packageRoot?: string): Promise<ListVariantUiEntriesResult>;
+
 interface RunLintInitOptions {
     /** Absolute project root directory. */
     projectRoot: string;
@@ -607,4 +662,4 @@ declare function readInstalledManifest(projectRoot: string): Promise<InstalledMa
  */
 declare function writeInstalledManifest(projectRoot: string, manifest: InstalledManifest): Promise<void>;
 
-export { DEFAULT_UI_ALIASES, DEFAULT_UI_ICON_LIBRARY, type InstallOptions, type InstallResult, type ListVariantsResult, type RunLintInitOptions, type RunLintInitResult, type RunSkillsAddOptions, type RunSkillsAddResult, type RunSkillsInitOptions, type RunSkillsInitResult, type RunSkillsUpdateOptions, type RunSkillsUpdateResult, type RunTokensInitOptions, type RunTokensInitResult, type RunUiAddOptions, type RunUiAddResult, type RunUiInitOptions, type RunUiInitResult, type RunUiListOptions, type RunUiListResult, type SkillInstallOptions, type SkillInstallResult, type SkillSyncOptions, type SkillSyncResult, type SkillUpdateOptions, type SkillUpdateResult, type UiEntryListItem, type UiInstallOptions, type UiInstallResult, type UpdatePlanItem, ensureTeamixDir, getTeamixDir, installResources, installSkills, installUiEntries, listTokenVariants, loadSkillsData, loadUiData, loadVariantData, readInstalledManifest, readProjectConfig, removeSkillFiles, removeUiFiles, runLintInit, runSkillsAdd, runSkillsInit, runSkillsUpdate, runTokensInit, runUiAdd, runUiInit, runUiList, syncSkillsToIdes, updateSkills, writeInstalledManifest, writeProjectConfig };
+export { DEFAULT_UI_ALIASES, DEFAULT_UI_ICON_LIBRARY, type InstallOptions, type InstallResult, type ListVariantUiEntriesResult, type ListVariantUiResult, type ListVariantsResult, type RunLintInitOptions, type RunLintInitResult, type RunSkillsAddOptions, type RunSkillsAddResult, type RunSkillsInitOptions, type RunSkillsInitResult, type RunSkillsUpdateOptions, type RunSkillsUpdateResult, type RunTokensInitOptions, type RunTokensInitResult, type RunUiAddOptions, type RunUiAddResult, type RunUiInitOptions, type RunUiInitResult, type RunUiListOptions, type RunUiListResult, type RunVariantUiAddOptions, type RunVariantUiAddResult, type SkillInstallOptions, type SkillInstallResult, type SkillSyncOptions, type SkillSyncResult, type SkillUpdateOptions, type SkillUpdateResult, type UiEntryListItem, type UiInstallOptions, type UiInstallResult, type UpdatePlanItem, ensureTeamixDir, getTeamixDir, installResources, installSkills, installUiEntries, listBizUiEntries, listBizUiVariants, listTemplatesEntries, listTemplatesVariants, listTokenVariants, loadSkillsData, loadUiData, loadVariantData, readInstalledManifest, readProjectConfig, removeSkillFiles, removeUiFiles, runBizUiAdd, runLintInit, runSkillsAdd, runSkillsInit, runSkillsUpdate, runTemplatesAdd, runTokensInit, runUiAdd, runUiInit, runUiList, syncSkillsToIdes, updateSkills, writeInstalledManifest, writeProjectConfig };

package/dist/core/index.js

@@ -455,7 +455,7 @@ async function writeMirrorContent(targetFile, sourceContent, managedRegions, sou
   if (matchedRegions.length === 0) {
     if (existing !== sourceContent) {
       logger.warn(
-        `Mirror drift detected at ${targetFile} \u2014 overwriting from source. Edit ${sourceFile} (not the mirror) and re-run \`teamix-evo skills sync\`.`
+        `Mirror drift detected at ${targetFile} \u2014 overwriting from source. Edit ${sourceFile} (not the mirror) and re-run \`npx teamix-evo@latest skills sync\`.`
       );
       await writeFileSafe(targetFile, sourceContent);
       return sourceContent;
@@ -557,34 +557,56 @@ async function rewriteSkillSource(skill, options, summary) {
       if (skill.template && targetFile2.endsWith(".hbs")) {
         targetFile2 = targetFile2.slice(0, -4);
       }
-      const content = skill.template && entry.endsWith(".hbs") ? renderTemplate(await loadTemplateFile(entry), { ...data, skill }) : await fs5.readFile(entry, "utf-8");
+      const newContent2 = skill.template && entry.endsWith(".hbs") ? renderTemplate(await loadTemplateFile(entry), { ...data, skill }) : await fs5.readFile(entry, "utf-8");
       const exists2 = await fileExists(targetFile2);
-      if (exists2) {
-        await backupFile(targetFile2, projectRoot);
-        summary.overwritten++;
-      } else {
-        summary.created++;
-      }
-      await writeFileSafe(targetFile2, content);
+      const written2 = await rewriteSingleFile({
+        targetFile: targetFile2,
+        newContent: newContent2,
+        exists: exists2,
+        updateStrategy: skill.updateStrategy,
+        managedRegions: skill.managedRegions,
+        projectRoot,
+        summary
+      });
       const relWritten = path7.relative(targetDir, targetFile2);
-      records.push(makeSourceRecord(skill, targetFile2, content, relWritten));
+      records.push(makeSourceRecord(skill, targetFile2, written2, relWritten));
     }
     return records;
   }
   const targetFile = path7.join(targetDir, "SKILL.md");
   const newContent = await renderSkillContent(sourceAbs, skill, data);
   const exists = await fileExists(targetFile);
-  if (skill.updateStrategy === "frozen") {
+  const written = await rewriteSingleFile({
+    targetFile,
+    newContent,
+    exists,
+    updateStrategy: skill.updateStrategy,
+    managedRegions: skill.managedRegions,
+    projectRoot,
+    summary
+  });
+  return [makeSourceRecord(skill, targetFile, written)];
+}
+async function rewriteSingleFile(args) {
+  const {
+    targetFile,
+    newContent,
+    exists,
+    updateStrategy,
+    managedRegions,
+    projectRoot,
+    summary
+  } = args;
+  if (updateStrategy === "frozen") {
     if (exists) {
       summary.skipped++;
-      const current2 = await readFileOrNull(targetFile) ?? newContent;
-      return [makeSourceRecord(skill, targetFile, current2)];
+      return await readFileOrNull(targetFile) ?? newContent;
     }
     await writeFileSafe(targetFile, newContent);
     summary.created++;
-    return [makeSourceRecord(skill, targetFile, newContent)];
+    return newContent;
   }
-  if (skill.updateStrategy === "regenerable" || !exists) {
+  if (updateStrategy === "regenerable" || !exists) {
     if (exists) {
       await backupFile(targetFile, projectRoot);
       summary.overwritten++;
@@ -592,11 +614,11 @@ async function rewriteSkillSource(skill, options, summary) {
       summary.created++;
     }
     await writeFileSafe(targetFile, newContent);
-    return [makeSourceRecord(skill, targetFile, newContent)];
+    return newContent;
   }
   const current = await readFileOrNull(targetFile);
   let merged = current ?? newContent;
-  for (const regionId of skill.managedRegions ?? []) {
+  for (const regionId of managedRegions ?? []) {
     const re = new RegExp(
       `<!-- teamix-evo:managed:start id="${escapeRegExp(
         regionId
@@ -616,10 +638,12 @@ async function rewriteSkillSource(skill, options, summary) {
       }
     }
   }
-  await backupFile(targetFile, projectRoot);
-  await writeFileSafe(targetFile, merged);
+  if (merged !== current) {
+    await backupFile(targetFile, projectRoot);
+    await writeFileSafe(targetFile, merged);
+  }
   summary.managed++;
-  return [makeSourceRecord(skill, targetFile, merged)];
+  return merged;
 }
 function escapeRegExp(str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -984,7 +1008,7 @@ async function runTokensInit(options) {
     const known = catalog.variants.map((v) => v.name).join(", ");
     throw new Error(
       `Unknown variant "${variant}". Available variants: ${known || "(none)"}.
-Run \`teamix-evo tokens list-variants\` to see all options.`
+Run \`npx teamix-evo@latest tokens list-variants\` to see all options.`
     );
   }
   const existingConfig = await readProjectConfig(projectRoot);
@@ -1717,8 +1741,176 @@ async function runUiList(options) {
   };
 }
 
-// src/core/lint-init.ts
+// src/core/variant-ui-add.ts
 import * as path12 from "path";
+import { createRequire as createRequire4 } from "module";
+import {
+  loadUiPackageManifest as loadUiPackageManifest2,
+  loadVariantUiPackageCatalog,
+  loadVariantUiPackageManifest
+} from "@teamix-evo/registry";
+var require5 = createRequire4(import.meta.url);
+function resolvePackageRoot3(packageName) {
+  const pkgJsonPath = require5.resolve(`${packageName}/package.json`);
+  return path12.dirname(pkgJsonPath);
+}
+async function runVariantUiAdd(packageName, options) {
+  const { projectRoot, variant, ids, overwrite } = options;
+  const fullPackageName = options.packageName ?? `@teamix-evo/${packageName}`;
+  if (ids.length === 0) {
+    throw new Error("At least one entry id must be provided.");
+  }
+  const config = await readProjectConfig(projectRoot);
+  const uiCfg = config?.packages?.ui;
+  if (!config || !uiCfg?.aliases) {
+    throw new Error(
+      `UI not initialized. Run \`teamix-evo ui init\` first \u2014 \`${packageName} add\` writes into the same alias map (business / templates).`
+    );
+  }
+  const packageRoot = options.packageRoot ?? resolvePackageRoot3(fullPackageName);
+  const catalog = await loadVariantUiPackageCatalog(packageRoot);
+  if (!catalog.variants.some((v) => v.name === variant)) {
+    const known = catalog.variants.map((v) => v.name).join(", ");
+    throw new Error(
+      `Variant "${variant}" not found in ${fullPackageName}. Known variants: ${known}. Hint: \`teamix-evo ${packageName} list-variants\` shows all.`
+    );
+  }
+  const variantDir = path12.join(packageRoot, "variants", variant);
+  const variantManifest = await loadVariantUiPackageManifest(variantDir);
+  const knownIds = new Set(variantManifest.entries.map((e) => e.id));
+  const unknown = ids.filter((id) => !knownIds.has(id));
+  if (unknown.length > 0) {
+    throw new Error(
+      `Unknown entry id(s) in ${packageName}#${variant}: ${unknown.map((s) => `"${s}"`).join(", ")}. Run \`teamix-evo ${packageName} list-variants\` to see this package's variants, or \`teamix-evo ${packageName} list --variant ${variant}\` for its entries.`
+    );
+  }
+  const uiPackageRoot = resolvePackageRoot3("@teamix-evo/ui");
+  const uiManifest = await loadUiPackageManifest2(uiPackageRoot);
+  const entryPackageRoot = /* @__PURE__ */ new Map();
+  const mergedEntries = [];
+  for (const e of variantManifest.entries) {
+    entryPackageRoot.set(e.id, variantDir);
+    mergedEntries.push(e);
+  }
+  for (const e of uiManifest.entries) {
+    if (entryPackageRoot.has(e.id)) continue;
+    entryPackageRoot.set(e.id, uiPackageRoot);
+    mergedEntries.push(e);
+  }
+  const adaptedManifest = {
+    schemaVersion: 1,
+    package: "ui",
+    version: variantManifest.version,
+    engines: variantManifest.engines,
+    entries: mergedEntries
+  };
+  const result = await installUiEntries({
+    projectRoot,
+    manifest: adaptedManifest,
+    packageRoot: variantDir,
+    // default for variant entries
+    entryPackageRoot,
+    // ui entries resolve from uiPackageRoot
+    aliases: uiCfg.aliases,
+    requested: ids,
+    skipExisting: !overwrite
+  });
+  const installed = await readInstalledManifest(
+    projectRoot
+  ) ?? { schemaVersion: 1, installed: [] };
+  const idx = installed.installed.findIndex(
+    (p) => p.package === fullPackageName && p.variant === variant
+  );
+  const prior = idx >= 0 ? installed.installed[idx] : null;
+  const mergedResources = mergeResources2(
+    prior?.resources ?? [],
+    result.resources
+  );
+  const entry = {
+    package: fullPackageName,
+    variant,
+    version: variantManifest.version,
+    installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    resources: mergedResources
+  };
+  if (idx >= 0) installed.installed[idx] = entry;
+  else installed.installed.push(entry);
+  await writeInstalledManifest(projectRoot, installed);
+  return {
+    packageName: fullPackageName,
+    variant,
+    orderedIds: result.orderedIds,
+    written: result.written,
+    skipped: result.skipped,
+    npmDependencies: result.npmDependencies,
+    resources: result.resources
+  };
+}
+function mergeResources2(prior, next) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const r of prior) merged.set(r.id, r);
+  for (const r of next) merged.set(r.id, r);
+  return Array.from(merged.values());
+}
+async function runBizUiAdd(options) {
+  return runVariantUiAdd("biz-ui", options);
+}
+async function runTemplatesAdd(options) {
+  return runVariantUiAdd("templates", options);
+}
+async function listVariantUi(packageName, packageRoot) {
+  const fullPackageName = `@teamix-evo/${packageName}`;
+  const root = packageRoot ?? resolvePackageRoot3(fullPackageName);
+  const catalog = await loadVariantUiPackageCatalog(root);
+  return {
+    packageName: fullPackageName,
+    variants: catalog.variants.map((v) => ({
+      name: v.name,
+      displayName: v.displayName,
+      version: v.version,
+      description: v.description
+    }))
+  };
+}
+async function listBizUiVariants(packageRoot) {
+  return listVariantUi("biz-ui", packageRoot);
+}
+async function listTemplatesVariants(packageRoot) {
+  return listVariantUi("templates", packageRoot);
+}
+async function listVariantUiEntries(packageName, variant, packageRoot) {
+  const fullPackageName = `@teamix-evo/${packageName}`;
+  const root = packageRoot ?? resolvePackageRoot3(fullPackageName);
+  const catalog = await loadVariantUiPackageCatalog(root);
+  if (!catalog.variants.some((v) => v.name === variant)) {
+    const known = catalog.variants.map((v) => v.name).join(", ");
+    throw new Error(
+      `Variant "${variant}" not found in ${fullPackageName}. Known: ${known}.`
+    );
+  }
+  const variantDir = path12.join(root, "variants", variant);
+  const variantManifest = await loadVariantUiPackageManifest(variantDir);
+  return {
+    packageName: fullPackageName,
+    variant,
+    entries: variantManifest.entries.map((e) => ({
+      id: e.id,
+      name: e.name,
+      type: e.type,
+      description: e.description,
+      registryDependencies: e.registryDependencies ?? []
+    }))
+  };
+}
+async function listBizUiEntries(variant, packageRoot) {
+  return listVariantUiEntries("biz-ui", variant, packageRoot);
+}
+async function listTemplatesEntries(variant, packageRoot) {
+  return listVariantUiEntries("templates", variant, packageRoot);
+}
+
+// src/core/lint-init.ts
+import * as path13 from "path";
 import * as fs9 from "fs";
 import { execa } from "execa";
 var ESLINT_CONFIG_CONTENT = `/**
@@ -1747,8 +1939,8 @@ var ESLINT_DEPS = [
 var STYLELINT_DEPS = ["@teamix-evo/stylelint-config", "stylelint"];
 async function runLintInit(options) {
   const { projectRoot, skipInstall } = options;
-  const eslintConfigPath = path12.join(projectRoot, "eslint.config.js");
-  const stylelintConfigPath = path12.join(projectRoot, "stylelint.config.cjs");
+  const eslintConfigPath = path13.join(projectRoot, "eslint.config.js");
+  const stylelintConfigPath = path13.join(projectRoot, "stylelint.config.cjs");
   const eslintExists = await fileExists(eslintConfigPath);
   const stylelintExists = await fileExists(stylelintConfigPath);
   if (eslintExists && stylelintExists) {
@@ -1786,12 +1978,12 @@ async function runLintInit(options) {
   };
 }
 function detectPm(projectRoot) {
-  if (fs9.existsSync(path12.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs9.existsSync(path12.join(projectRoot, "yarn.lock"))) return "yarn";
+  if (fs9.existsSync(path13.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs9.existsSync(path13.join(projectRoot, "yarn.lock"))) return "yarn";
   return "npm";
 }
 async function patchPackageJsonScripts(projectRoot) {
-  const pkgPath = path12.join(projectRoot, "package.json");
+  const pkgPath = path13.join(projectRoot, "package.json");
   const raw = await readFileOrNull(pkgPath);
   if (!raw) return;
   let pkg;
@@ -1818,7 +2010,7 @@ async function patchPackageJsonScripts(projectRoot) {
 }
 
 // src/core/installer.ts
-import * as path13 from "path";
+import * as path14 from "path";
 import * as fs10 from "fs/promises";
 async function installResources(options) {
   const { projectRoot, manifest, data, variantDir, packageRoot } = options;
@@ -1856,7 +2048,7 @@ async function installSingleResource(resource, projectRoot, data, variantDir, pa
     variantDir,
     packageRoot
   );
-  const targetPath = path13.join(projectRoot, resource.target);
+  const targetPath = path14.join(projectRoot, resource.target);
   let content;
   if (resource.template) {
     const templateContent = await loadTemplateFile(sourcePath);
@@ -1880,13 +2072,13 @@ async function installRecursiveResource(resource, projectRoot, data, variantDir,
     variantDir,
     packageRoot
   );
-  const targetDir = path13.join(projectRoot, resource.target);
+  const targetDir = path14.join(projectRoot, resource.target);
   const results = [];
   await ensureDir(targetDir);
   const entries = await walkDir(sourcePath);
   for (const entry of entries) {
-    const relPath = path13.relative(sourcePath, entry);
-    let targetFile = path13.join(targetDir, relPath);
+    const relPath = path14.relative(sourcePath, entry);
+    let targetFile = path14.join(targetDir, relPath);
     if (resource.template && targetFile.endsWith(".hbs")) {
       targetFile = targetFile.slice(0, -4);
     }
@@ -1899,7 +2091,7 @@ async function installRecursiveResource(resource, projectRoot, data, variantDir,
     }
     await writeFileSafe(targetFile, content);
     const hash = computeHash(content);
-    const targetRel = path13.relative(projectRoot, targetFile);
+    const targetRel = path14.relative(projectRoot, targetFile);
     results.push({
       id: `${resource.id}:${relPath}`,
       target: targetRel,
@@ -1912,23 +2104,23 @@ async function installRecursiveResource(resource, projectRoot, data, variantDir,
 }
 
 // src/core/registry-client.ts
-import * as path14 from "path";
+import * as path15 from "path";
 import * as fs11 from "fs/promises";
-import { createRequire as createRequire4 } from "module";
+import { createRequire as createRequire5 } from "module";
 import { loadVariantManifest } from "@teamix-evo/registry";
-var require5 = createRequire4(import.meta.url);
-function resolvePackageRoot3(packageName) {
-  const pkgJsonPath = require5.resolve(`${packageName}/package.json`);
-  return path14.dirname(pkgJsonPath);
+var require6 = createRequire5(import.meta.url);
+function resolvePackageRoot4(packageName) {
+  const pkgJsonPath = require6.resolve(`${packageName}/package.json`);
+  return path15.dirname(pkgJsonPath);
 }
 async function loadVariantData(packageName, variant) {
-  const packageRoot = resolvePackageRoot3(packageName);
-  const variantDir = path14.join(packageRoot, "library", variant);
+  const packageRoot = resolvePackageRoot4(packageName);
+  const variantDir = path15.join(packageRoot, "library", variant);
   logger.debug(`Resolved variant dir: ${variantDir}`);
   logger.debug(`Package root: ${packageRoot}`);
   const manifest = await loadVariantManifest(variantDir);
   let data = {};
-  const dataPath = path14.join(variantDir, "_data.json");
+  const dataPath = path15.join(variantDir, "_data.json");
   try {
     const raw = await fs11.readFile(dataPath, "utf-8");
     data = JSON.parse(raw);
@@ -1948,6 +2140,10 @@ export {
   installResources,
   installSkills,
   installUiEntries,
+  listBizUiEntries,
+  listBizUiVariants,
+  listTemplatesEntries,
+  listTemplatesVariants,
   listTokenVariants,
   loadSkillsData,
   loadUiData,
@@ -1956,10 +2152,12 @@ export {
   readProjectConfig,
   removeSkillFiles,
   removeUiFiles,
+  runBizUiAdd,
   runLintInit,
   runSkillsAdd,
   runSkillsInit,
   runSkillsUpdate,
+  runTemplatesAdd,
   runTokensInit,
   runUiAdd,
   runUiInit,