elcrm 1.1.2 → 1.1.3

package/dist/index.js

@@ -688,6 +688,391 @@ var init_form_tokens = __esm(() => {
   DEPRECATED_DECL_RE = new RegExp(`(?:${FORM_TOKEN_DEPRECATED.map((n) => n.replace(/-/g, "\\-")).join("|")})\\s*:`);
 });
 
+// src/lib/migrate/components.ts
+import { readFileSync as readFileSync10 } from "fs";
+function removeDecl2(css, name) {
+  const re = new RegExp(`\\n?[ \\t]*${name.replace(/-/g, "\\-")}\\s*:[^;\\n}]+;?[ \\t]*`, "g");
+  let n = 0;
+  const next = css.replace(re, () => {
+    n++;
+    return "";
+  });
+  return { next: next.replace(/\n{3,}/g, `
+
+`), n };
+}
+function rewriteComponentsCss(source) {
+  let next = source;
+  let hits = 0;
+  for (const [re, to] of VAR_REPLACEMENTS2) {
+    next = next.replace(re, () => {
+      hits++;
+      return to;
+    });
+  }
+  for (const name of COMPONENTS_TOKEN_DEPRECATED) {
+    const stillUsed = new RegExp(`var\\(\\s*${name.replace(/-/g, "\\-")}\\s*`, "i").test(next);
+    if (stillUsed)
+      continue;
+    const rem = removeDecl2(next, name);
+    next = rem.next;
+    hits += rem.n;
+  }
+  return { next, hits };
+}
+function rewriteImports2(source) {
+  let hits = 0;
+  let next = source;
+  const replaceImportList = (list) => {
+    let s = list;
+    const before = s;
+    s = s.replace(/\bBlock\b/g, "Stack");
+    s = s.replace(/\bRow\b/g, "Stack");
+    s = s.replace(/\bColumn\b/g, "Stack");
+    const parts = s.split(",").map((p) => p.trim()).filter(Boolean);
+    const seen = new Set;
+    const uniq = [];
+    for (const p of parts) {
+      const bare = p.replace(/\s+as\s+\w+$/, "").trim();
+      if (seen.has(bare)) {
+        hits++;
+        continue;
+      }
+      seen.add(bare);
+      uniq.push(p);
+    }
+    if (s !== before || uniq.join(", ") !== list.trim())
+      hits++;
+    return uniq.join(", ");
+  };
+  next = next.replace(/import\s*\{([^}]+)\}\s*from\s*["']@elcrm\/components["']/g, (full, list) => {
+    if (!/\b(Block|Row|Column)\b/.test(list))
+      return full;
+    hits++;
+    return `import { ${replaceImportList(list)} } from "@elcrm/components"`;
+  });
+  next = next.replace(/import\s*\{\s*Block\s*\}\s*from\s*["']@elcrm\/components\/Block["']/g, () => {
+    hits++;
+    return `import { Stack } from "@elcrm/components/Stack"`;
+  });
+  next = next.replace(/import\s*\{\s*Row\s*\}\s*from\s*["']@elcrm\/components\/Row["']/g, () => {
+    hits++;
+    return `import { Stack } from "@elcrm/components/Stack"`;
+  });
+  next = next.replace(/import\s*\{\s*Column\s*\}\s*from\s*["']@elcrm\/components\/Column["']/g, () => {
+    hits++;
+    return `import { Stack } from "@elcrm/components/Stack"`;
+  });
+  return { next, hits };
+}
+function rewriteJsx(source) {
+  let hits = 0;
+  let next = source;
+  next = next.replace(/<Block([^>]*?)\srow(\s|\/|>)/g, (_m, attrs, end) => {
+    hits++;
+    return `<Stack${attrs} direction="row"${end}`;
+  });
+  next = next.replace(/<\/Block>/g, () => {
+    hits++;
+    return "</Stack>";
+  });
+  next = next.replace(/<Block(\s|\/|>)/g, (_m, end) => {
+    hits++;
+    return `<Stack${end}`;
+  });
+  next = next.replace(/<Row(\s[^/>]*(?:\/>|>))/g, (_m, rest) => {
+    hits++;
+    return `<Stack direction="row"${rest}`;
+  });
+  next = next.replace(/<\/Row>/g, () => {
+    hits++;
+    return "</Stack>";
+  });
+  next = next.replace(/<\/Column>/g, () => {
+    hits++;
+    return "</Stack>";
+  });
+  next = next.replace(/<Column(\s|\/|>)/g, (_m, end) => {
+    hits++;
+    return `<Stack${end}`;
+  });
+  next = next.replace(/\bactiveKey=/g, () => {
+    hits++;
+    return "value=";
+  });
+  next = next.replace(/\bdefaultActiveKey=/g, () => {
+    hits++;
+    return "defaultValue=";
+  });
+  return { next, hits };
+}
+function rewriteSectionOnChange(source) {
+  if (!/\b(NavSections|TabSections)\b/.test(source)) {
+    return { next: source, hits: 0 };
+  }
+  let hits = 0;
+  const next = source.replace(/\bonChange=/g, () => {
+    hits++;
+    return "onValueChange=";
+  });
+  return { next, hits };
+}
+function rewriteItemKeys(source) {
+  if (!/\b(Menu|NavSections|TabSections|MenuItem|NavSectionsItem|TabSectionsItem)\b/.test(source)) {
+    return { next: source, hits: 0 };
+  }
+  let hits = 0;
+  const next = source.replace(/(\{\s*)key(\s*:\s*["'`])/g, (_m, a, b) => {
+    hits++;
+    return `${a}value${b}`;
+  });
+  const next2 = next.replace(/(\.\s*)key(\s*(?:[,)\]]|;|\s*[=!]==))/g, (full, a, b) => {
+    if (/\bt\.key|\bi\.key|item\.key/.test(full) || /t\.key|i\.key/.test(a + "key")) {
+      hits++;
+      return `${a}value${b}`;
+    }
+    return full;
+  });
+  const next3 = next2.replace(/\b(t|i|item)\.key\b/g, (_m, obj) => {
+    hits++;
+    return `${obj}.value`;
+  });
+  return { next: next3, hits };
+}
+function rewriteComponentsTsx(source) {
+  let hits = 0;
+  let next = source;
+  const imp = rewriteImports2(next);
+  next = imp.next;
+  hits += imp.hits;
+  const jsx = rewriteJsx(next);
+  next = jsx.next;
+  hits += jsx.hits;
+  const oc = rewriteSectionOnChange(next);
+  next = oc.next;
+  hits += oc.hits;
+  const keys = rewriteItemKeys(next);
+  next = keys.next;
+  hits += keys.hits;
+  return { next, hits };
+}
+function fixStackDirectionSpacing(source) {
+  return source.replace(/<Stack direction="row"(\S)/g, `<Stack direction="row" $1`);
+}
+async function migrateComponents(cwd, dry) {
+  const pkg = readPackageJson(cwd);
+  if (pkg?.name === "@elcrm/components")
+    return [];
+  const changes = [];
+  const files = projectCodeRoots(cwd).flatMap((r) => walkCodeFiles(r));
+  for (const file of files) {
+    const raw = readFileSync10(file, "utf8");
+    let next = raw;
+    let hits = 0;
+    if (file.endsWith(".css")) {
+      const r = rewriteComponentsCss(raw);
+      next = r.next;
+      hits = r.hits;
+    } else if (/\.(tsx?|jsx?|mdx?)$/.test(file)) {
+      const r = rewriteComponentsTsx(raw);
+      next = fixStackDirectionSpacing(r.next);
+      hits = r.hits;
+    } else {
+      continue;
+    }
+    if (hits === 0 || next === raw)
+      continue;
+    if (writeIfChanged(file, next, dry) || dry) {
+      changes.push({
+        file: rel(cwd, file),
+        detail: `${hits}\xD7 components (Stack / value / shell-tokens)`
+      });
+    }
+  }
+  return changes;
+}
+function lineHasDeprecatedComponentsToken(line) {
+  const t = line.trim();
+  if (!t || t.startsWith("/*") || t.startsWith("*"))
+    return false;
+  if (DEPRECATED_VAR_RE2.test(t))
+    return true;
+  if (!DEPRECATED_DECL_RE2.test(t))
+    return false;
+  if (/:\s*var\(\s*--shell-/.test(t))
+    return false;
+  return true;
+}
+var VAR_REPLACEMENTS2, COMPONENTS_TOKEN_DEPRECATED, DEPRECATED_VAR_RE2, DEPRECATED_DECL_RE2;
+var init_components = __esm(() => {
+  init_pkg();
+  init_walk();
+  VAR_REPLACEMENTS2 = [
+    [/var\(\s*--layout-background\s*(?:,[^)]+)?\)/gi, "var(--shell-background-muted)"],
+    [/var\(\s*--header-background\s*(?:,[^)]+)?\)/gi, "var(--shell-background)"],
+    [/var\(\s*--header-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color)"],
+    [/var\(\s*--header-border\s*(?:,[^)]+)?\)/gi, "var(--shell-border)"],
+    [/var\(\s*--footer-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color-muted)"],
+    [/var\(\s*--footer-border\s*(?:,[^)]+)?\)/gi, "var(--shell-border)"],
+    [/var\(\s*--item-background-hover\s*(?:,[^)]+)?\)/gi, "var(--shell-background-hover)"],
+    [/var\(\s*--item-background-active\s*(?:,[^)]+)?\)/gi, "var(--shell-background-selected)"],
+    [/var\(\s*--item-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color)"],
+    [/var\(\s*--card-background\s*(?:,[^)]+)?\)/gi, "var(--shell-background)"],
+    [/var\(\s*--card-border\s*(?:,[^)]+)?\)/gi, "var(--shell-border)"],
+    [/var\(\s*--card-shadow\s*(?:,[^)]+)?\)/gi, "var(--shell-shadow)"],
+    [/var\(\s*--menu-item-background-hover\s*(?:,[^)]+)?\)/gi, "var(--shell-background-hover)"],
+    [/var\(\s*--menu-item-background-active\s*(?:,[^)]+)?\)/gi, "var(--shell-background-selected)"],
+    [/var\(\s*--menu-item-color-active\s*(?:,[^)]+)?\)/gi, "var(--shell-color)"],
+    [/var\(\s*--menu-item-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color-muted)"],
+    [/var\(\s*--loading-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color-muted)"],
+    [/var\(\s*--section-title-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color)"],
+    [/var\(\s*--section-description-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color-muted)"],
+    [/var\(\s*--section-auth-card-background\s*(?:,[^)]+)?\)/gi, "var(--shell-background)"],
+    [/var\(\s*--section-auth-card-border\s*(?:,[^)]+)?\)/gi, "var(--shell-border)"],
+    [/var\(\s*--section-auth-card-shadow\s*(?:,[^)]+)?\)/gi, "var(--shell-shadow)"],
+    [/var\(\s*--section-block-border\s*(?:,[^)]+)?\)/gi, "var(--shell-border)"],
+    [/var\(\s*--nav-sections-label-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color-muted)"],
+    [/var\(\s*--nav-sections-item-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color)"],
+    [/var\(\s*--nav-sections-item-background-hover\s*(?:,[^)]+)?\)/gi, "var(--shell-background-hover)"],
+    [/var\(\s*--nav-sections-item-background-active\s*(?:,[^)]+)?\)/gi, "var(--shell-background-selected)"],
+    [/var\(\s*--nav-sections-accent\s*(?:,[^)]+)?\)/gi, "var(--shell-color-accent)"],
+    [/var\(\s*--nav-sections-icon-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color-muted)"],
+    [/var\(\s*--nav-sections-group-border\s*(?:,[^)]+)?\)/gi, "var(--shell-border)"],
+    [/var\(\s*--nav-sections-footer-border\s*(?:,[^)]+)?\)/gi, "var(--shell-border)"],
+    [/var\(\s*--tab-sections-border\s*(?:,[^)]+)?\)/gi, "var(--shell-border)"],
+    [/var\(\s*--tab-sections-color-active\s*(?:,[^)]+)?\)/gi, "var(--shell-color)"],
+    [/var\(\s*--tab-sections-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color-muted)"],
+    [/var\(\s*--tab-sections-accent\s*(?:,[^)]+)?\)/gi, "var(--shell-color)"],
+    [/var\(\s*--tab-sections-badge-background\s*(?:,[^)]+)?\)/gi, "var(--shell-color-danger)"],
+    [/var\(\s*--brand-color-hover\s*(?:,[^)]+)?\)/gi, "var(--shell-color-accent)"],
+    [/var\(\s*--brand-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color)"],
+    [/var\(\s*--badge-neutral-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color)"],
+    [/var\(\s*--badge-accent-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color-accent)"],
+    [/var\(\s*--badge-success-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color-success)"],
+    [/var\(\s*--badge-danger-color\s*(?:,[^)]+)?\)/gi, "var(--shell-color-danger)"],
+    [/var\(\s*--list-gap\s*(?:,[^)]+)?\)/gi, "var(--shell-gap-sm)"],
+    [/var\(\s*--item-padding\s*(?:,[^)]+)?\)/gi, "var(--shell-padding)"],
+    [/var\(\s*--item-radius\s*(?:,[^)]+)?\)/gi, "var(--shell-radius)"],
+    [/var\(\s*--block-gap\s*(?:,[^)]+)?\)/gi, "var(--shell-gap)"],
+    [/var\(\s*--row-gap\s*(?:,[^)]+)?\)/gi, "var(--shell-gap)"],
+    [/var\(\s*--column-gap\s*(?:,[^)]+)?\)/gi, "var(--shell-gap)"]
+  ];
+  COMPONENTS_TOKEN_DEPRECATED = [
+    "--layout-background",
+    "--layout-min-height",
+    "--layout-gap",
+    "--header-background",
+    "--header-color",
+    "--header-border",
+    "--header-padding",
+    "--header-gap",
+    "--footer-background",
+    "--footer-color",
+    "--footer-border",
+    "--footer-padding",
+    "--footer-font-size",
+    "--list-gap",
+    "--list-padding",
+    "--item-background",
+    "--item-background-hover",
+    "--item-background-active",
+    "--item-color",
+    "--item-color-muted",
+    "--item-border",
+    "--item-radius",
+    "--item-padding",
+    "--item-gap",
+    "--card-background",
+    "--card-border",
+    "--card-shadow",
+    "--card-radius",
+    "--card-padding",
+    "--block-gap",
+    "--block-padding",
+    "--row-gap",
+    "--column-gap",
+    "--menu-gap",
+    "--menu-item-radius",
+    "--menu-item-padding",
+    "--menu-item-background",
+    "--menu-item-background-hover",
+    "--menu-item-background-active",
+    "--menu-item-color",
+    "--menu-item-color-active",
+    "--loading-padding",
+    "--loading-color",
+    "--section-gap",
+    "--section-description-size",
+    "--section-icon-gap",
+    "--section-body-gap",
+    "--section-actions-gap",
+    "--section-auth-padding",
+    "--section-auth-card-padding",
+    "--section-auth-card-radius",
+    "--section-block-padding-bottom",
+    "--section-block-margin-bottom",
+    "--section-title-color",
+    "--section-description-color",
+    "--section-auth-card-background",
+    "--section-auth-card-border",
+    "--section-auth-card-shadow",
+    "--section-block-border",
+    "--nav-sections-gap",
+    "--nav-sections-item-radius",
+    "--nav-sections-item-padding",
+    "--nav-sections-label-color",
+    "--nav-sections-item-color",
+    "--nav-sections-item-background-hover",
+    "--nav-sections-item-background-active",
+    "--nav-sections-accent",
+    "--nav-sections-icon-color",
+    "--nav-sections-group-border",
+    "--nav-sections-footer-border",
+    "--tab-sections-gap",
+    "--tab-sections-tab-padding",
+    "--tab-sections-tab-gap",
+    "--tab-sections-badge-size",
+    "--tab-sections-border",
+    "--tab-sections-color",
+    "--tab-sections-color-active",
+    "--tab-sections-accent",
+    "--tab-sections-badge-background",
+    "--tab-sections-badge-color",
+    "--badge-padding",
+    "--badge-radius",
+    "--badge-font-size",
+    "--badge-font-weight",
+    "--badge-border",
+    "--badge-neutral-background",
+    "--badge-neutral-color",
+    "--badge-accent-background",
+    "--badge-accent-color",
+    "--badge-success-background",
+    "--badge-success-color",
+    "--badge-warning-background",
+    "--badge-warning-color",
+    "--badge-danger-background",
+    "--badge-danger-color",
+    "--brand-font-weight",
+    "--brand-letter-spacing",
+    "--brand-color",
+    "--brand-color-hover",
+    "--empty-state-gap",
+    "--empty-state-padding",
+    "--empty-state-icon-gap",
+    "--empty-state-title-size",
+    "--empty-state-description-size",
+    "--empty-state-max-width",
+    "--empty-state-actions-gap",
+    "--empty-state-actions-margin-top",
+    "--radio-group-gap",
+    "--page-pad",
+    "--page-gap"
+  ];
+  DEPRECATED_VAR_RE2 = new RegExp(`var\\(\\s*(?:${COMPONENTS_TOKEN_DEPRECATED.map((n) => n.replace(/-/g, "\\-")).join("|")})\\s*`, "i");
+  DEPRECATED_DECL_RE2 = new RegExp(`(?:${COMPONENTS_TOKEN_DEPRECATED.map((n) => n.replace(/-/g, "\\-")).join("|")})\\s*:`);
+});
+
 // src/lib/migrate/front.ts
 var exports_front = {};
 __export(exports_front, {
@@ -714,18 +1099,21 @@ var init_front = __esm(() => {
   init_legacy_hacks();
   init_form_aliases();
   init_form_tokens();
+  init_components();
   FRONT_MIGRATIONS = {
     "size-sml": migrateSizeSml,
     "field-border": migrateFieldBorder,
     "modal-create": migrateModalCreate,
     "form-aliases": migrateFormAliases,
     "form-tokens": migrateFormTokens,
+    components: migrateComponents,
     "legacy-hacks": migrateLegacyReactHack,
     "socket-server": migrateSocketServer
   };
   FRONT_MIGRATE_ORDER = [
     "form-aliases",
     "form-tokens",
+    "components",
     "size-sml",
     "field-border",
     "modal-create",
@@ -734,7 +1122,7 @@ var init_front = __esm(() => {
 });
 
 // src/index.ts
-import { readFileSync as readFileSync19 } from "fs";
+import { readFileSync as readFileSync20 } from "fs";
 import { dirname as dirname4, join as join18 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
@@ -880,15 +1268,20 @@ init_front();
 
 // src/lib/cssSync.ts
 init_form_tokens();
+init_components();
 import {
   existsSync as existsSync6,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync10,
+  readFileSync as readFileSync11,
   statSync as statSync3,
   writeFileSync as writeFileSync4
 } from "fs";
 import { createRequire } from "module";
 import { dirname, join as join6 } from "path";
+var TOKEN_DEPRECATED = new Set([
+  ...FORM_TOKEN_DEPRECATED,
+  ...COMPONENTS_TOKEN_DEPRECATED
+]);
 var COLOR_VALUE = /#|rgba?\(|hsla?\(|oklch|oklab|color-mix|lab\(|lch\(|hwb\(/i;
 var COLOR_NAME = /(?:^|-)(bg|fg|color|fill|track|thumb|overlay|shadow|border|ring|background|placeholder)(?:-|$)/i;
 var GEOM_VALUE = /(?:^|\s)(\d*\.?\d+)(px|em|rem|%|vh|vw|dvh|ch|ex|s|ms|deg|fr|pt)\b|^[0-9.]+$|ease|linear|none/i;
@@ -1008,7 +1401,7 @@ function resolvePkgRoot(pkgName, cwd) {
 }
 function readPkgJson(dir) {
   try {
-    return JSON.parse(readFileSync10(join6(dir, "package.json"), "utf8"));
+    return JSON.parse(readFileSync11(join6(dir, "package.json"), "utf8"));
   } catch {
     return null;
   }
@@ -1064,7 +1457,7 @@ function collectPkgTokens(pkgName, cwd) {
   const acc = [];
   const seen = new Set;
   for (const file of files) {
-    const css = readFileSync10(file, "utf8");
+    const css = readFileSync11(file, "utf8");
     const kind = fileKind(file);
     if (kind !== "mixed") {
       for (const [name, value] of parseCustomProps(css)) {
@@ -1232,9 +1625,9 @@ function syncElcrmCss(options) {
     const file = fileFor(bucket);
     if (!existsSync6(file))
       continue;
-    let css = readFileSync10(file, "utf8");
+    let css = readFileSync11(file, "utf8");
     const have = existingTokenNames(css);
-    const missing = allDefs.filter((d) => d.bucket === bucket && !have.has(d.name) && !FORM_TOKEN_DEPRECATED.includes(d.name));
+    const missing = allDefs.filter((d) => d.bucket === bucket && !have.has(d.name) && !TOKEN_DEPRECATED.has(d.name));
     const uniq = [];
     const seen = new Set;
     for (const d of missing) {
@@ -1257,7 +1650,7 @@ function syncElcrmCss(options) {
       writeFileSync4(file, next, "utf8");
   }
   if (existsSync6(paths.elcrm)) {
-    let css = readFileSync10(paths.elcrm, "utf8");
+    let css = readFileSync11(paths.elcrm, "utf8");
     for (const exp of cssExports) {
       const specs = [];
       if (exp.light)
@@ -1284,7 +1677,7 @@ function syncElcrmCss(options) {
 import { resolve } from "path";
 
 // src/lib/test/detect.ts
-import { existsSync as existsSync7, readdirSync as readdirSync4, readFileSync as readFileSync11, statSync as statSync4 } from "fs";
+import { existsSync as existsSync7, readdirSync as readdirSync4, readFileSync as readFileSync12, statSync as statSync4 } from "fs";
 import { join as join7 } from "path";
 function hasElcrmServer(pkg) {
   for (const section of [
@@ -1339,17 +1732,42 @@ function readPkgAt(dir) {
   if (!existsSync7(path))
     return null;
   try {
-    return JSON.parse(readFileSync11(path, "utf8"));
+    return JSON.parse(readFileSync12(path, "utf8"));
   } catch {
     return null;
   }
 }
 
 // src/lib/test/front.ts
-import { existsSync as existsSync8, readdirSync as readdirSync5, readFileSync as readFileSync12, statSync as statSync5 } from "fs";
+import { existsSync as existsSync8, readdirSync as readdirSync5, readFileSync as readFileSync13, statSync as statSync5 } from "fs";
 import { join as join8, relative as relative2 } from "path";
 init_form_tokens();
+init_components();
 var SKIP = new Set(["node_modules", "dist", ".git", "coverage", ".bun"]);
+function isThemeTokenFile(rel2) {
+  const n = rel2.replace(/\\/g, "/");
+  return /(?:^|\/)(?:theme(?:-light|-dark)?|elcrm)\.css$/.test(n);
+}
+function isGeneratedIcons(rel2) {
+  return /icons\.generated\.(tsx?|jsx?)$/.test(rel2.replace(/\\/g, "/"));
+}
+var HARD_HEX_RE = /#[0-9a-fA-F]{3,8}\b/;
+var HARD_RGB_RE = /\b(?:rgb|rgba|hsl|hsla)\s*\(/i;
+var HARD_NAMED_RE = /(?:^|[;{]\s*|(?:color|background(?:-color)?|border-color|fill|stroke|outline-color)\s*:\s*)(?:white|black|red|blue|navy|gray|grey|silver|whitesmoke)\b/i;
+var JSX_COLOR_PROP_RE = /\b(?:color|background(?:Color)?|borderColor|fill)\s*=\s*\{?\s*["'](?:#|rgb|hsl|white|black)/i;
+function lineForColorScan(line) {
+  return line.replace(/var\([^)]*\)/g, "").replace(/url\s*\([^)]*\)/gi, "");
+}
+function hardcodedColorReason(line) {
+  const s = lineForColorScan(line);
+  if (HARD_HEX_RE.test(s) || HARD_RGB_RE.test(s) || JSX_COLOR_PROP_RE.test(line)) {
+    return "\u043B\u0438\u0442\u0435\u0440\u0430\u043B \u0446\u0432\u0435\u0442\u0430 \u2014 var(--button-*|--field-*|--item-*|--layout-*) \u0438\u0437 theme";
+  }
+  if (HARD_NAMED_RE.test(s) && !/\btransparent\b|\bcurrentColor\b|\binherit\b/.test(s)) {
+    return "\u0438\u043C\u0435\u043D\u043E\u0432\u0430\u043D\u043D\u044B\u0439 \u0446\u0432\u0435\u0442 \u2014 \u0442\u043E\u043A\u0435\u043D @elcrm/* / theme";
+  }
+  return null;
+}
 var DEPRECATED_SOCKET_IMPORT_RE = /(?:from\s+|require\s*\(\s*)["']@elcrm\/(?:socket\/server|socket-server)["']/;
 var THEMES_CSS_IMPORT_RE = /(?:from\s+|import\s+)["']@elcrm\/[^"']+\/themes\.css["']|import\s+["']@elcrm\/[^"']+\/themes\.css["']/;
 var LEGACY_PASSKEY_IMPORT_RE = /(?:from\s+|require\s*\(\s*)["']@elcrm\/passkey["']/;
@@ -1469,8 +1887,9 @@ function collectFrontIssues(cwd, pkg) {
       files.push(inSrc);
   }
   for (const file of files) {
-    const text = readFileSync12(file, "utf8");
+    const text = readFileSync13(file, "utf8");
     const rel2 = relative2(cwd, file);
+    const skipHardColor = isLib || isThemeTokenFile(rel2) || isGeneratedIcons(rel2);
     if (DEPRECATED_SOCKET_IMPORT_RE.test(text)) {
       issues.push({
         level: "error",
@@ -1576,12 +1995,56 @@ function collectFrontIssues(cwd, pkg) {
           fixable: true
         });
       }
+      if (lineHasDeprecatedComponentsToken(line)) {
+        issues.push({
+          level: "warn",
+          code: "components-token-legacy",
+          message: "legacy \u0442\u043E\u043A\u0435\u043D @elcrm/components \u2192 --shell-* (elcrm migrate components)",
+          file: rel2,
+          line: i + 1,
+          fixable: true
+        });
+      }
+      if (/\b(Block|Row|Column)\b/.test(line) && /@elcrm\/components/.test(text) && /from\s+["']@elcrm\/components/.test(text)) {
+        if (/import\s*\{[^}]*\b(Block|Row|Column)\b/.test(line) || /<\/?(?:Block|Row|Column)\b/.test(line)) {
+          issues.push({
+            level: "warn",
+            code: "components-stack",
+            message: "Block/Row/Column \u0443\u0441\u0442\u0430\u0440\u0435\u043B\u0438 \u2014 Stack (elcrm migrate components)",
+            file: rel2,
+            line: i + 1,
+            fixable: true
+          });
+        }
+      }
+      if (/\b(activeKey|defaultActiveKey)\s*=/.test(line) && /@elcrm\/components/.test(text)) {
+        issues.push({
+          level: "warn",
+          code: "components-value",
+          message: "activeKey/defaultActiveKey \u2192 value/defaultValue (elcrm migrate components)",
+          file: rel2,
+          line: i + 1,
+          fixable: true
+        });
+      }
+      if (!skipHardColor) {
+        const why = hardcodedColorReason(line);
+        if (why) {
+          issues.push({
+            level: "warn",
+            code: "hardcoded-color",
+            message: why,
+            file: rel2,
+            line: i + 1
+          });
+        }
+      }
     });
   }
   return issues;
 }
 async function runPkgScript(cwd, script) {
-  const pkg = JSON.parse(readFileSync12(join8(cwd, "package.json"), "utf8"));
+  const pkg = JSON.parse(readFileSync13(join8(cwd, "package.json"), "utf8"));
   if (!pkg.scripts?.[script])
     return { ran: false, ok: true };
   console.log(`\u2192 bun run ${script}`);
@@ -1624,7 +2087,7 @@ function printIssues(issues, title) {
 }
 
 // src/lib/test/serverScan.ts
-import { existsSync as existsSync9, readdirSync as readdirSync6, readFileSync as readFileSync13, statSync as statSync6 } from "fs";
+import { existsSync as existsSync9, readdirSync as readdirSync6, readFileSync as readFileSync14, statSync as statSync6 } from "fs";
 import { join as join9, relative as relative3 } from "path";
 
 // src/lib/test/serverRules.ts
@@ -2026,7 +2489,7 @@ function scanServerProject(root) {
   walkFiles2(root, root, files);
   const findings = [];
   for (const file of files) {
-    const text = readFileSync13(file, "utf8");
+    const text = readFileSync14(file, "utf8");
     if (file.endsWith("package.json")) {
       findings.push(...scanPackageJson(root, file, text));
     } else {
@@ -2295,7 +2758,7 @@ import {
   existsSync as existsSync11,
   mkdirSync,
   readdirSync as readdirSync7,
-  readFileSync as readFileSync14,
+  readFileSync as readFileSync15,
   statSync as statSync7,
   writeFileSync as writeFileSync5
 } from "fs";
@@ -2339,7 +2802,7 @@ function isEmptyDir(dir) {
 function writePkgName(pkgPath, name) {
   if (!existsSync11(pkgPath))
     return;
-  const pkg = JSON.parse(readFileSync14(pkgPath, "utf8"));
+  const pkg = JSON.parse(readFileSync15(pkgPath, "utf8"));
   pkg.name = name;
   pkg.version = pkg.version ?? "0.0.0";
   writeFileSync5(pkgPath, JSON.stringify(pkg, null, 2) + `
@@ -2506,7 +2969,7 @@ async function cmdMigrate(parsed) {
   console.log(dry ? `
 --dry: ${changes.length} \u043F\u043E\u0442\u0435\u043D\u0446\u0438\u0430\u043B\u044C\u043D\u044B\u0445 \u0438\u0437\u043C\u0435\u043D\u0435\u043D\u0438\u0439.` : `
 \u041F\u0440\u0438\u043C\u0435\u043D\u0435\u043D\u043E: ${changes.length}.`);
-  if (name === "front" || name === "ui" || name === "size-sml" || name === "form-tokens") {
+  if (name === "front" || name === "ui" || name === "size-sml" || name === "form-tokens" || name === "components") {
     console.log("\u0414\u0430\u043B\u044C\u0448\u0435: elcrm css && elcrm audit");
   }
 }
@@ -2701,7 +3164,7 @@ import { resolve as resolve3 } from "path";
 import {
   existsSync as existsSync13,
   readdirSync as readdirSync9,
-  readFileSync as readFileSync16,
+  readFileSync as readFileSync17,
   rmSync,
   statSync as statSync8,
   writeFileSync as writeFileSync7
@@ -2709,12 +3172,24 @@ import {
 import { join as join13 } from "path";
 
 // src/vite/concat-css.ts
-import { readdirSync as readdirSync8, readFileSync as readFileSync15, writeFileSync as writeFileSync6 } from "fs";
+import { readdirSync as readdirSync8, readFileSync as readFileSync16, writeFileSync as writeFileSync6 } from "fs";
 import { join as join12 } from "path";
+var SKIP_CSS = new Set([
+  "index.css",
+  "tokens.css",
+  "light.css",
+  "dark.css",
+  "themes.css"
+]);
 function concatDistCss(options) {
   const outFile = options.outFile ?? "index.css";
-  const files = readdirSync8(options.distDir).filter((f) => f.endsWith(".css") && f !== outFile).sort();
-  const css = files.map((f) => readFileSync15(join12(options.distDir, f), "utf8")).join(`
+  const skip = new Set([
+    ...SKIP_CSS,
+    outFile,
+    ...options.skip ?? []
+  ]);
+  const files = readdirSync8(options.distDir).filter((f) => f.endsWith(".css") && !skip.has(f)).sort();
+  const css = files.map((f) => readFileSync16(join12(options.distDir, f), "utf8")).join(`
 `);
   const outPath = join12(options.distDir, outFile);
   writeFileSync6(outPath, css);
@@ -2745,7 +3220,7 @@ function postbuildLib(options) {
     const flat = join13(dist, `${name}.d.ts`);
     const src = existsSync13(impl) ? impl : existsSync13(nestedIndex) ? nestedIndex : null;
     if (src) {
-      const text = readFileSync16(src, "utf8").replace(/from ['"]\.\.\/([^'"]+)['"]/g, `from './$1'`);
+      const text = readFileSync17(src, "utf8").replace(/from ['"]\.\.\/([^'"]+)['"]/g, `from './$1'`);
       writeFileSync7(flat, text);
       console.log(`[postbuild] types \u2192 ${name}.d.ts`);
     }
@@ -2812,12 +3287,13 @@ async function cmdCss(parsed) {
 }
 
 // src/commands/audit.ts
-import { existsSync as existsSync14, readFileSync as readFileSync17 } from "fs";
+import { existsSync as existsSync14, readFileSync as readFileSync18 } from "fs";
 import { join as join14, relative as relative4 } from "path";
 init_pkg();
 init_walk();
 init_front();
 init_form_tokens();
+init_components();
 function scan(cwd) {
   const out = [];
   const pkg = readPackageJson(cwd);
@@ -2848,7 +3324,7 @@ function scan(cwd) {
   }
   const files = projectCodeRoots(cwd).flatMap((r) => walkCodeFiles(r));
   for (const file of files) {
-    const text = readFileSync17(file, "utf8");
+    const text = readFileSync18(file, "utf8");
     const rel2 = relative4(cwd, file);
     const lines = text.split(/\r?\n/);
     lines.forEach((line, i) => {
@@ -2930,7 +3406,7 @@ function scan(cwd) {
       return false;
     if (/theme(-light|-dark)?\.css$/.test(f))
       return false;
-    const t = readFileSync17(f, "utf8");
+    const t = readFileSync18(f, "utf8");
     return t.includes("--search-border:") && t.includes("--button-secondary-bg:") && t.includes("transparent");
   });
   if (toolbarMarkers.length > 1) {
@@ -2957,7 +3433,7 @@ function scan(cwd) {
       "theme-dark.css",
       "theme.css"
     ].map((f) => join14(styleDir, f));
-    const themeText = themeFiles.filter(existsSync14).map((f) => readFileSync17(f, "utf8")).join(`
+    const themeText = themeFiles.filter(existsSync14).map((f) => readFileSync18(f, "utf8")).join(`
 `);
     if (themeText && !/--popup-shadow\s*:/.test(themeText) && /--date-popup-shadow\s*:|--select-background\s*:/.test(themeText)) {
       out.push({
@@ -2979,7 +3455,7 @@ function scan(cwd) {
   for (const file of files) {
     if (!file.endsWith(".css"))
       continue;
-    const text = readFileSync17(file, "utf8");
+    const text = readFileSync18(file, "utf8");
     const relPath = relative4(cwd, file);
     const lines = text.split(/\r?\n/);
     lines.forEach((line, i) => {
@@ -2995,6 +3471,16 @@ function scan(cwd) {
           fix: "elcrm migrate form-tokens"
         });
       }
+      if (lineHasDeprecatedComponentsToken(line)) {
+        out.push({
+          level: "warn",
+          code: "components-token-legacy",
+          message: "legacy components-\u0442\u043E\u043A\u0435\u043D \u2192 --shell-*",
+          file: relPath,
+          line: i + 1,
+          fix: "elcrm migrate components"
+        });
+      }
     });
   }
   return out;
@@ -3108,7 +3594,7 @@ import {
   existsSync as existsSync15,
   mkdirSync as mkdirSync2,
   readdirSync as readdirSync10,
-  readFileSync as readFileSync18,
+  readFileSync as readFileSync19,
   writeFileSync as writeFileSync8
 } from "fs";
 import { dirname as dirname3, join as join15 } from "path";
@@ -3126,7 +3612,7 @@ function readBundled(relPath) {
   if (!existsSync15(full)) {
     throw new Error(`\u0428\u0430\u0431\u043B\u043E\u043D \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D: ${relPath}`);
   }
-  return readFileSync18(full, "utf8");
+  return readFileSync19(full, "utf8");
 }
 
 // src/commands/docs.ts
@@ -3153,8 +3639,13 @@ async function cmdDocs(parsed) {
 
 // src/commands/cursor.ts
 import { join as join17, resolve as resolve5 } from "path";
-var ALWAYS = ["elcrm.mdc", "elcrm-packages.mdc"];
-var UI = ["elcrm-ui.mdc", "elcrm-module.mdc", "elcrm-theme.mdc"];
+var ALWAYS = ["elcrm.mdc", "elcrm-packages.mdc", "elcrm-jsdoc.mdc"];
+var UI = [
+  "elcrm-ui.mdc",
+  "elcrm-module.mdc",
+  "elcrm-theme.mdc",
+  "elcrm-tokens.mdc"
+];
 var SERVER = ["elcrm-server.mdc", "elcrm-rpc.mdc"];
 var LIB = ["elcrm-lib.mdc"];
 function writeOne(dest, body, dry, force, label) {
@@ -3191,6 +3682,23 @@ async function cmdCursor(parsed) {
   console.log(c.gray("\u0410\u0433\u0435\u043D\u0442: AGENTS.md + rules (\u0443\u0437\u043A\u0438\u0435 glob) + .cursor/docs. \u0421\u0434\u0430\u0447\u0430: elcrm test."));
 }
 
+// src/commands/upd.ts
+import { spawnSync as spawnSync2 } from "child_process";
+async function cmdUpd() {
+  const bun = spawnSync2("bun", ["--version"], { encoding: "utf8" });
+  const cmd = bun.status === 0 ? "bun" : "npm";
+  const args = ["i", "-g", "elcrm@latest"];
+  console.log(`${c.cyan("\u2192")} ${cmd} ${args.join(" ")}`);
+  const r = spawnSync2(cmd, args, {
+    stdio: "inherit",
+    env: process.env
+  });
+  if (r.status !== 0) {
+    process.exit(r.status ?? 1);
+  }
+  console.log(c.green("CLI \u043E\u0431\u043D\u043E\u0432\u043B\u0451\u043D. \u041F\u0440\u043E\u0432\u0435\u0440\u043A\u0430: elcrm -v"));
+}
+
 // src/index.ts
 function cliVersion() {
   const here = dirname4(fileURLToPath2(import.meta.url));
@@ -3199,7 +3707,7 @@ function cliVersion() {
     join18(here, "package.json")
   ]) {
     try {
-      const v = JSON.parse(readFileSync19(p, "utf8")).version;
+      const v = JSON.parse(readFileSync20(p, "utf8")).version;
       if (typeof v === "string" && v)
         return v;
     } catch {}
@@ -3216,6 +3724,9 @@ function showHelp() {
   elcrm <\u043A\u043E\u043C\u0430\u043D\u0434\u0430> [\u0430\u0440\u0433\u0443\u043C\u0435\u043D\u0442\u044B] [\u0444\u043B\u0430\u0433\u0438]
 
 \u041A\u043E\u043C\u0430\u043D\u0434\u044B:
+  upd
+      \u041E\u0431\u043D\u043E\u0432\u0438\u0442\u044C \u0441\u0430\u043C CLI: bun i -g elcrm@latest (\u0431\u0435\u0437 bun \u2014 npm)
+
   update [--dry] [--core] [--no-install] [--fix] [--test]
       \u041E\u0431\u043D\u043E\u0432\u0438\u0442\u044C \u0432\u0441\u0435 @elcrm/* \u0434\u043E latest; --fix = migrate front; --test = elcrm test
       \u0420\u0435\u043A\u043E\u043C\u0435\u043D\u0434\u0443\u0435\u0442\u0441\u044F: elcrm update --fix --test
@@ -3229,7 +3740,7 @@ function showHelp() {
 
   migrate <name> [--dry]
   migrate --list
-      \u041C\u0438\u0433\u0440\u0430\u0446\u0438\u0438: front|ui, form-aliases, form-tokens, size-sml, field-border, modal-create, legacy-hacks, socket-server
+      \u041C\u0438\u0433\u0440\u0430\u0446\u0438\u0438: front|ui, form-aliases, form-tokens, components, size-sml, field-border, modal-create, legacy-hacks, socket-server
 
       audit [--fix] [--dry] [--dir=\u2026]
       \u0423\u0441\u0442\u0430\u0440\u0435\u0432\u0448\u0438\u0439 API + CSS-\u0442\u043E\u043A\u0435\u043D\u044B form (padding-\u0430\u043B\u0438\u0430\u0441\u044B, popup-shadow, border shorthand)
@@ -3273,6 +3784,7 @@ function showHelp() {
 
 \u041F\u0440\u0438\u043C\u0435\u0440\u044B:
   elcrm -v
+  elcrm upd
   elcrm update
   elcrm update --dry
   elcrm update --fix --test
@@ -3311,6 +3823,9 @@ async function main() {
     console.log("parseArgs:", JSON.stringify(parsed, null, 2));
   }
   switch (parsed.command) {
+    case "upd":
+      await cmdUpd();
+      break;
     case "update":
       await cmdUpdate(parsed);
       break;