elcrm 1.1.20 → 1.1.22

package/dist/index.js

@@ -2,8 +2,8 @@
 // @bun
 
 // src/index.ts
-import { readFileSync as readFileSync27 } from "fs";
-import { dirname as dirname4, join as join23 } from "path";
+import { readFileSync as readFileSync28 } from "fs";
+import { dirname as dirname4, join as join25 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/parseArgs.ts
@@ -3671,11 +3671,11 @@ async function cmdMigrate(parsed) {
 }
 
 // src/commands/doctor.ts
-import { resolve as resolve9 } from "path";
+import { resolve as resolve10 } from "path";
 
 // src/lib/kit/doctor-kit.ts
-import { existsSync as existsSync14 } from "fs";
-import { join as join16, resolve as resolve6 } from "path";
+import { existsSync as existsSync15 } from "fs";
+import { join as join17, resolve as resolve7 } from "path";
 
 // src/lib/projectKind.ts
 function detectProjectKind(cwd) {
@@ -3706,8 +3706,37 @@ function isElcrmLibPackage(cwd) {
 }
 
 // src/lib/kit/paths.ts
-import { existsSync as existsSync12, readFileSync as readFileSync19 } from "fs";
+import { existsSync as existsSync13, readFileSync as readFileSync20 } from "fs";
+import { join as join13, resolve as resolve4 } from "path";
+
+// src/lib/kit/config.ts
+import { existsSync as existsSync12, mkdirSync as mkdirSync2, readFileSync as readFileSync19, writeFileSync as writeFileSync6 } from "fs";
+import { homedir } from "os";
 import { join as join12, resolve as resolve3 } from "path";
+var FILE = "kit-paths.json";
+function globalConfigPath() {
+  return join12(homedir(), ".elcrm", FILE);
+}
+function localConfigPath(cwd) {
+  return join12(resolve3(cwd), ".elcrm", FILE);
+}
+function readJson(path) {
+  if (!existsSync12(path))
+    return {};
+  try {
+    return JSON.parse(readFileSync19(path, "utf8"));
+  } catch {
+    return {};
+  }
+}
+function loadKitPathsConfig(cwd) {
+  const global = readJson(globalConfigPath());
+  const local = readJson(localConfigPath(cwd));
+  return {
+    apiDir: local.apiDir || global.apiDir,
+    webDir: local.webDir || global.webDir
+  };
+}
 function readName(dir) {
   try {
     const j = JSON.parse(readFileSync19(join12(dir, "package.json"), "utf8"));
@@ -3716,36 +3745,109 @@ function readName(dir) {
     return null;
   }
 }
-function findEluiApiDir(from) {
+function validateApiDir(dir) {
+  const p = resolve3(dir);
+  if (!existsSync12(join12(p, "src/kit/catalog.ts")))
+    return null;
+  return p;
+}
+function validateWebDir(dir) {
+  const p = resolve3(dir);
+  if (readName(p) !== "elui-web")
+    return null;
+  return p;
+}
+function saveKitPathsConfig(cwd, patch, global = false) {
+  const path = global ? globalConfigPath() : localConfigPath(cwd);
+  const prev = readJson(path);
+  const next = { ...prev, ...patch };
+  if (next.apiDir) {
+    const ok = validateApiDir(next.apiDir);
+    if (!ok)
+      throw new Error("apiDir: \u043D\u0443\u0436\u0435\u043D \u043A\u0430\u0442\u0430\u043B\u043E\u0433 elUI.api (src/kit/catalog.ts)");
+    next.apiDir = ok;
+  }
+  if (next.webDir) {
+    const ok = validateWebDir(next.webDir);
+    if (!ok)
+      throw new Error("webDir: \u043D\u0443\u0436\u0435\u043D \u043A\u0430\u0442\u0430\u043B\u043E\u0433 elUI.web (package name elui-web)");
+    next.webDir = ok;
+  }
+  mkdirSync2(join12(path, ".."), { recursive: true });
+  writeFileSync6(path, JSON.stringify(next, null, 2) + `
+`, "utf8");
+  return next;
+}
+function persistKitPathsFromOpts(opts) {
+  if (opts.dry)
+    return;
+  const patch = {};
+  if (opts.apiDir?.trim())
+    patch.apiDir = opts.apiDir.trim();
+  if (opts.webDir?.trim())
+    patch.webDir = opts.webDir.trim();
+  if (!patch.apiDir && !patch.webDir)
+    return;
+  saveKitPathsConfig(opts.cwd, patch, opts.global ?? true);
+}
+
+// src/lib/kit/paths.ts
+function readName2(dir) {
+  try {
+    const j = JSON.parse(readFileSync20(join13(dir, "package.json"), "utf8"));
+    return j.name ?? null;
+  } catch {
+    return null;
+  }
+}
+function findEluiApiDir(from, override) {
+  if (override?.trim()) {
+    const p = resolve4(override.trim());
+    if (existsSync13(join13(p, "src/kit/catalog.ts")))
+      return p;
+    return null;
+  }
   const env = process.env.ELUI_API_DIR?.trim();
-  if (env && existsSync12(join12(env, "src/kit/catalog.ts")))
-    return resolve3(env);
-  let dir = resolve3(from);
+  if (env && existsSync13(join13(env, "src/kit/catalog.ts")))
+    return resolve4(env);
+  const saved = loadKitPathsConfig(from).apiDir;
+  if (saved && existsSync13(join13(saved, "src/kit/catalog.ts")))
+    return resolve4(saved);
+  let dir = resolve4(from);
   for (let i = 0;i < 8; i++) {
     for (const name of ["elUI.api", "ui-kit.api"]) {
-      const candidate = join12(dir, name);
-      if (existsSync12(join12(candidate, "src/kit/catalog.ts")))
+      const candidate = join13(dir, name);
+      if (existsSync13(join13(candidate, "src/kit/catalog.ts")))
         return candidate;
     }
-    const parent = join12(dir, "..");
+    const parent = join13(dir, "..");
     if (parent === dir)
       break;
     dir = parent;
   }
   return null;
 }
-function findEluiWebDir(from) {
+function findEluiWebDir(from, override) {
+  if (override?.trim()) {
+    const p = resolve4(override.trim());
+    if (readName2(p) === "elui-web")
+      return p;
+    return null;
+  }
   const env = process.env.ELUI_WEB_DIR?.trim();
-  if (env && readName(env) === "elui-web")
-    return resolve3(env);
-  let dir = resolve3(from);
+  if (env && readName2(env) === "elui-web")
+    return resolve4(env);
+  const saved = loadKitPathsConfig(from).webDir;
+  if (saved && readName2(saved) === "elui-web")
+    return resolve4(saved);
+  let dir = resolve4(from);
   for (let i = 0;i < 8; i++) {
     for (const name of ["elUI.web", "Uikit.web"]) {
-      const candidate = join12(dir, name);
-      if (readName(candidate) === "elui-web")
+      const candidate = join13(dir, name);
+      if (readName2(candidate) === "elui-web")
         return candidate;
     }
-    dir = join12(dir, "..");
+    dir = join13(dir, "..");
   }
   return null;
 }
@@ -3761,17 +3863,17 @@ function manifestFileName(npmName) {
 }
 
 // src/lib/kit/sync.ts
-import { existsSync as existsSync13, mkdirSync as mkdirSync3, readFileSync as readFileSync22, writeFileSync as writeFileSync7 } from "fs";
-import { join as join15, resolve as resolve5 } from "path";
+import { existsSync as existsSync14, mkdirSync as mkdirSync4, readFileSync as readFileSync23, writeFileSync as writeFileSync8 } from "fs";
+import { join as join16, resolve as resolve6 } from "path";
 import { spawnSync as spawnSync2 } from "child_process";
 
 // src/lib/kit/emit.ts
-import { mkdirSync as mkdirSync2, readFileSync as readFileSync21, writeFileSync as writeFileSync6 } from "fs";
-import { join as join14, resolve as resolve4 } from "path";
+import { mkdirSync as mkdirSync3, readFileSync as readFileSync22, writeFileSync as writeFileSync7 } from "fs";
+import { join as join15, resolve as resolve5 } from "path";
 
 // src/lib/kit/parse-dts.ts
-import { readFileSync as readFileSync20, readdirSync as readdirSync8, statSync as statSync8 } from "fs";
-import { basename, join as join13 } from "path";
+import { readFileSync as readFileSync21, readdirSync as readdirSync8, statSync as statSync8 } from "fs";
+import { basename, join as join14 } from "path";
 var SKIP_SLUGS = new Set([
   "index",
   "types",
@@ -3797,16 +3899,23 @@ function isMainComponentDoc(doc) {
     return false;
   return doc.length > 72;
 }
-function componentDoc(content, slug) {
+function componentDocs(content, slug) {
   const fnAnchor = "export declare function " + slug;
   const propsAnchor = "export type " + slug + "Props";
   const fnDoc = leadingDoc(content, fnAnchor);
   const propsDoc = leadingDoc(content, propsAnchor);
-  if (isMainComponentDoc(fnDoc))
-    return fnDoc;
-  if (isMainComponentDoc(propsDoc))
-    return propsDoc;
-  return fnDoc || propsDoc;
+  const examplesDoc = fnDoc.includes("@example") ? fnDoc : propsDoc.includes("@example") ? propsDoc : fnDoc || propsDoc;
+  let descriptionDoc = fnDoc || propsDoc;
+  if (propsDoc.includes("@example")) {
+    descriptionDoc = propsDoc;
+  } else if (isMainComponentDoc(propsDoc) && propsDoc.length > fnDoc.length) {
+    descriptionDoc = propsDoc;
+  } else if (isMainComponentDoc(fnDoc)) {
+    descriptionDoc = fnDoc;
+  } else if (isMainComponentDoc(propsDoc)) {
+    descriptionDoc = propsDoc;
+  }
+  return { descriptionDoc, examplesDoc };
 }
 function leadingDoc(content, anchor) {
   const idx = content.indexOf(anchor);
@@ -3874,15 +3983,15 @@ function parseComponentDts(content, slug) {
   if (!new RegExp("export declare function " + slug + "\\b").test(content)) {
     return null;
   }
-  const doc = componentDoc(content, slug);
+  const { descriptionDoc, examplesDoc } = componentDocs(content, slug);
   const propsMatch = content.match(new RegExp("export type " + slug + "Props\\s*=\\s*([\\s\\S]*?);\\s*(?:export|$)"));
   const propsBlock = propsMatch?.[1] ?? "";
   return {
     slug,
     title: slug,
-    description: descriptionFromDoc(doc) || slug,
+    description: descriptionFromDoc(descriptionDoc) || slug,
     importFrom: "@elcrm/components",
-    examples: examplesFromDoc(doc),
+    examples: examplesFromDoc(examplesDoc),
     props: propsFromPropsBlock(propsBlock)
   };
 }
@@ -3894,10 +4003,10 @@ function scanDistComponents(distDir, importFrom) {
     const slug = basename(name, ".d.ts");
     if (SKIP_SLUGS.has(slug) || slug.includes("."))
       continue;
-    const path = join13(distDir, name);
+    const path = join14(distDir, name);
     if (!statSync8(path).isFile())
       continue;
-    const content = readFileSync20(path, "utf8");
+    const content = readFileSync21(path, "utf8");
     const parsed = parseComponentDts(content, slug);
     if (!parsed)
       continue;
@@ -3910,7 +4019,7 @@ function scanDistComponents(distDir, importFrom) {
 
 // src/lib/kit/emit.ts
 function readPkg(cwd) {
-  const j = JSON.parse(readFileSync21(join14(cwd, "package.json"), "utf8"));
+  const j = JSON.parse(readFileSync22(join15(cwd, "package.json"), "utf8"));
   if (!j.name?.startsWith("@elcrm/")) {
     throw new Error("elcrm kit emit \u2014 \u0442\u043E\u043B\u044C\u043A\u043E \u0432 npm-\u043F\u0430\u043A\u0435\u0442\u0435 @elcrm/*");
   }
@@ -3922,7 +4031,7 @@ function emitKitManifest(cwd) {
   if (!pkgSlug) {
     throw new Error(`elcrm kit emit \u2014 \u043F\u0430\u043A\u0435\u0442 ${pkg.name} \u043D\u0435 \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442\u0441\u044F (\u043D\u0443\u0436\u0435\u043D components|form)`);
   }
-  const distDir = join14(cwd, "dist");
+  const distDir = join15(cwd, "dist");
   const components = scanDistComponents(distDir, pkg.name).map((c2) => ({
     ...c2,
     importFrom: pkg.name
@@ -3939,8 +4048,8 @@ function emitKitManifest(cwd) {
 function writeKitManifest(cwd, manifest, dry = false) {
   const written = [];
   const targets = [
-    join14(cwd, ".elcrm", "kit-manifest.json"),
-    join14(cwd, "dist", "kit-manifest.json")
+    join15(cwd, ".elcrm", "kit-manifest.json"),
+    join15(cwd, "dist", "kit-manifest.json")
   ];
   const body = `${JSON.stringify(manifest, null, 2)}
 `;
@@ -3949,20 +4058,20 @@ function writeKitManifest(cwd, manifest, dry = false) {
       written.push(path);
       continue;
     }
-    mkdirSync2(join14(path, ".."), { recursive: true });
-    writeFileSync6(path, body, "utf8");
+    mkdirSync3(join15(path, ".."), { recursive: true });
+    writeFileSync7(path, body, "utf8");
     written.push(path);
   }
   return written;
 }
 function readKitManifest(path) {
-  return JSON.parse(readFileSync21(resolve4(path), "utf8"));
+  return JSON.parse(readFileSync22(resolve5(path), "utf8"));
 }
 
 // src/lib/kit/sync.ts
 function patchPkgVersions(apiDir, npmName, version, dry) {
-  const path = join15(apiDir, "src/kit/pkg-versions.ts");
-  let src = readFileSync22(path, "utf8");
+  const path = join16(apiDir, "src/kit/pkg-versions.ts");
+  let src = readFileSync23(path, "utf8");
   const re = new RegExp(`("${npmName.replace("/", "\\/")}"\\s*:\\s*")[^"]+(")`);
   if (!re.test(src)) {
     console.warn(c.yellow(`  ! FALLBACK_DEPS: \u043D\u0435\u0442 ${npmName} \u0432 pkg-versions.ts`));
@@ -3972,17 +4081,17 @@ function patchPkgVersions(apiDir, npmName, version, dry) {
   if (next === src)
     return;
   if (!dry)
-    writeFileSync7(path, next, "utf8");
+    writeFileSync8(path, next, "utf8");
   console.log(`  ${dry ? "~" : c.green("+")} pkg-versions \u2192 ${npmName} ${version}`);
 }
 function patchWebDep(webDir, npmName, version, dry) {
-  const path = join15(webDir, "package.json");
-  const j = JSON.parse(readFileSync22(path, "utf8"));
+  const path = join16(webDir, "package.json");
+  const j = JSON.parse(readFileSync23(path, "utf8"));
   if (!j.dependencies?.[npmName])
     return;
   j.dependencies[npmName] = version;
   if (!dry)
-    writeFileSync7(path, `${JSON.stringify(j, null, 2)}
+    writeFileSync8(path, `${JSON.stringify(j, null, 2)}
 `, "utf8");
   console.log(`  ${dry ? "~" : c.green("+")} elUI.web \u2192 ${npmName}@${version}`);
 }
@@ -4003,31 +4112,37 @@ function runReseed(apiDir, webDir, dry) {
     throw new Error("kit:reseed \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u043B\u0441\u044F \u0441 \u043E\u0448\u0438\u0431\u043A\u043E\u0439");
 }
 async function syncKitManifest(opts) {
-  const cwd = resolve5(opts.cwd);
+  const cwd = resolve6(opts.cwd);
   const dry = opts.dry ?? false;
   const reseed = opts.reseed !== false;
+  persistKitPathsFromOpts({
+    cwd,
+    apiDir: opts.apiDir,
+    webDir: opts.webDir,
+    dry
+  });
   let manifest;
   if (opts.manifestPath) {
     manifest = readKitManifest(opts.manifestPath);
-  } else if (existsSync13(join15(cwd, ".elcrm", "kit-manifest.json"))) {
-    manifest = readKitManifest(join15(cwd, ".elcrm", "kit-manifest.json"));
+  } else if (existsSync14(join16(cwd, ".elcrm", "kit-manifest.json"))) {
+    manifest = readKitManifest(join16(cwd, ".elcrm", "kit-manifest.json"));
   } else {
     manifest = emitKitManifest(cwd);
   }
-  const apiDir = opts.apiDir ? resolve5(opts.apiDir) : findEluiApiDir(cwd);
+  const apiDir = findEluiApiDir(cwd, opts.apiDir);
   if (!apiDir) {
-    throw new Error("\u041D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D elUI.api (\u0437\u0430\u0434\u0430\u0439\u0442\u0435 --api=\u2026 \u0438\u043B\u0438 ELUI_API_DIR). Manifest \u043C\u043E\u0436\u043D\u043E \u0441\u043E\u0445\u0440\u0430\u043D\u0438\u0442\u044C: elcrm kit emit");
+    throw new Error("\u041D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D elUI.api (elcrm kit config --api=\u2026 --global \u0438\u043B\u0438 ELUI_API_DIR). Manifest: elcrm kit emit");
   }
-  const outDir = join15(apiDir, "src/kit/manifests");
-  const outFile = join15(outDir, manifestFileName(manifest.package));
+  const outDir = join16(apiDir, "src/kit/manifests");
+  const outFile = join16(outDir, manifestFileName(manifest.package));
   if (!dry) {
-    mkdirSync3(outDir, { recursive: true });
-    writeFileSync7(outFile, `${JSON.stringify(manifest, null, 2)}
+    mkdirSync4(outDir, { recursive: true });
+    writeFileSync8(outFile, `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
   }
   console.log(`${dry ? "[dry] " : ""}sync \u2192 ${outFile} (${manifest.components.length} \u043A\u043E\u043C\u043F\u043E\u043D\u0435\u043D\u0442\u043E\u0432, ${manifest.version})`);
   patchPkgVersions(apiDir, manifest.package, manifest.version, dry);
-  const webDir = opts.webDir ? resolve5(opts.webDir) : opts.patchWeb !== false ? findEluiWebDir(cwd) : null;
+  const webDir = opts.patchWeb === false ? null : findEluiWebDir(cwd, opts.webDir);
   if (webDir)
     patchWebDep(webDir, manifest.package, manifest.version, dry);
   if (reseed)
@@ -4042,14 +4157,14 @@ async function emitAndSync(opts) {
 
 // src/lib/kit/doctor-kit.ts
 async function doctorKitSync(opts) {
-  const cwd = resolve6(opts.cwd);
+  const cwd = resolve7(opts.cwd);
   const dry = opts.dry ?? false;
   if (!isElcrmLibPackage(cwd))
     return false;
   const pkg = readPkgAt(cwd);
   if (!pkg?.name || !kitPkgSlug(pkg.name))
     return false;
-  if (!existsSync14(join16(cwd, "dist"))) {
+  if (!existsSync15(join17(cwd, "dist"))) {
     console.log(c.dim(`
 kit: \u043F\u0440\u043E\u043F\u0443\u0441\u043A \u2014 \u043D\u0435\u0442 dist/ (\u0441\u043D\u0430\u0447\u0430\u043B\u0430 npm run build)`));
     return false;
@@ -4061,13 +4176,13 @@ ${dry ? "[dry] " : ""}kit: sync \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442
     return true;
   } catch (err) {
     console.warn(c.yellow("kit: " + (err instanceof Error ? err.message : String(err))));
-    console.warn(c.dim("  \u0417\u0430\u0434\u0430\u0439\u0442\u0435 ELUI_API_DIR=\u2026 \u0438\u043B\u0438 elcrm kit pull --api=\u2026/elUI.api"));
+    console.warn(c.dim("  \u0417\u0430\u0434\u0430\u0439\u0442\u0435 elcrm kit config --api=\u2026 --web=\u2026 --global"));
     return false;
   }
 }
 
 // src/commands/docs.ts
-import { join as join18, resolve as resolve7 } from "path";
+import { join as join19, resolve as resolve8 } from "path";
 
 // src/lib/elcrmDocsCatalog.ts
 var ALL_ELCRM_DOCS = [
@@ -4101,33 +4216,33 @@ function docsForProject(kind, lib) {
 
 // src/lib/scaffoldFiles.ts
 import {
-  existsSync as existsSync15,
-  mkdirSync as mkdirSync4,
+  existsSync as existsSync16,
+  mkdirSync as mkdirSync5,
   readdirSync as readdirSync9,
-  readFileSync as readFileSync23,
-  writeFileSync as writeFileSync8
+  readFileSync as readFileSync24,
+  writeFileSync as writeFileSync9
 } from "fs";
-import { dirname as dirname3, join as join17 } from "path";
+import { dirname as dirname3, join as join18 } from "path";
 function writeScaffoldFile(dest, body, opts) {
   if (opts.dry)
     return "dry";
-  if (!opts.force && existsSync15(dest))
+  if (!opts.force && existsSync16(dest))
     return "skip";
-  mkdirSync4(dirname3(dest), { recursive: true });
-  writeFileSync8(dest, body, "utf8");
+  mkdirSync5(dirname3(dest), { recursive: true });
+  writeFileSync9(dest, body, "utf8");
   return "write";
 }
 function readBundled(relPath) {
-  const full = join17(packageRoot(), "templates", relPath);
-  if (!existsSync15(full)) {
+  const full = join18(packageRoot(), "templates", relPath);
+  if (!existsSync16(full)) {
     throw new Error(`\u0428\u0430\u0431\u043B\u043E\u043D \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D: ${relPath}`);
   }
-  return readFileSync23(full, "utf8");
+  return readFileSync24(full, "utf8");
 }
 
 // src/commands/docs.ts
 async function cmdDocs(parsed) {
-  const cwd = resolve7(parsed.options.dir || process.cwd());
+  const cwd = resolve8(parsed.options.dir || process.cwd());
   const dry = hasFlag(parsed, "dry");
   const force = hasFlag(parsed, "force") || !hasFlag(parsed, "keep");
   const lib = hasFlag(parsed, "lib") || isElcrmLibPackage(cwd);
@@ -4135,8 +4250,8 @@ async function cmdDocs(parsed) {
   const names = docsForProject(kind, lib);
   console.log(`${dry ? "[dry] " : ""}elcrm docs \u2192 ${cwd}/docs  (${kind}${lib ? ", lib" : ""})`);
   for (const name of names) {
-    const body = readBundled(join18("elcrm-docs", name));
-    const dest = join18(cwd, "docs", name);
+    const body = readBundled(join19("elcrm-docs", name));
+    const dest = join19(cwd, "docs", name);
     const action = writeScaffoldFile(dest, body, { dry, force });
     const mark = action === "write" ? c.green("+") : action === "skip" ? c.gray("=") : c.cyan("~");
     console.log(`  ${mark} docs/${name}`);
@@ -4148,7 +4263,7 @@ async function cmdDocs(parsed) {
 }
 
 // src/commands/cursor.ts
-import { join as join19, resolve as resolve8 } from "path";
+import { join as join20, resolve as resolve9 } from "path";
 var ALWAYS = ["elcrm.mdc", "elcrm-packages.mdc", "elcrm-jsdoc.mdc"];
 var UI = [
   "elcrm-ui.mdc",
@@ -4164,7 +4279,7 @@ function writeOne(dest, body, dry, force, label) {
   console.log(`  ${mark} ${label}`);
 }
 async function cmdCursor(parsed) {
-  const cwd = resolve8(parsed.options.dir || process.cwd());
+  const cwd = resolve9(parsed.options.dir || process.cwd());
   const dry = hasFlag(parsed, "dry");
   const force = hasFlag(parsed, "force") || !hasFlag(parsed, "keep");
   const lib = hasFlag(parsed, "lib") || isElcrmLibPackage(cwd);
@@ -4177,24 +4292,24 @@ async function cmdCursor(parsed) {
   ];
   console.log(`${dry ? "[dry] " : ""}elcrm cursor \u2192 ${cwd}/.cursor  (${kind}${lib ? ", lib" : ""})`);
   for (const name of ruleNames) {
-    let body = readBundled(join19("elcrm-cursor", "rules", name));
+    let body = readBundled(join20("elcrm-cursor", "rules", name));
     if (kind === "server" && (name === "elcrm-server.mdc" || name === "elcrm-rpc.mdc")) {
       body = body.replace("alwaysApply: false", "alwaysApply: true").replace(/^globs:.*\n/m, "");
     }
-    writeOne(join19(cwd, ".cursor", "rules", name), body, dry, force, `.cursor/rules/${name}`);
+    writeOne(join20(cwd, ".cursor", "rules", name), body, dry, force, `.cursor/rules/${name}`);
   }
   const docs = docsForProject(kind, lib);
   for (const name of docs) {
-    const body = readBundled(join19("elcrm-docs", name));
-    writeOne(join19(cwd, ".cursor", "docs", name), body, dry, force, `.cursor/docs/${name}`);
+    const body = readBundled(join20("elcrm-docs", name));
+    writeOne(join20(cwd, ".cursor", "docs", name), body, dry, force, `.cursor/docs/${name}`);
   }
-  writeOne(join19(cwd, "AGENTS.md"), readBundled(join19("elcrm-cursor", "AGENTS.md")), dry, force, "AGENTS.md");
+  writeOne(join20(cwd, "AGENTS.md"), readBundled(join20("elcrm-cursor", "AGENTS.md")), dry, force, "AGENTS.md");
   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/doctor.ts
 async function cmdDoctor(parsed) {
-  const cwd = resolve9(parsed.options.dir || process.cwd());
+  const cwd = resolve10(parsed.options.dir || process.cwd());
   const dry = hasFlag(parsed, "dry");
   const doDocs = hasFlag(parsed, "docs");
   const doTest = hasFlag(parsed, "test");
@@ -4271,7 +4386,7 @@ doctor: \u0433\u043E\u0442\u043E\u0432\u043E (${n} \u043F\u0440\u0430\u0432\u043
 }
 
 // src/commands/build.ts
-import { existsSync as existsSync16 } from "fs";
+import { existsSync as existsSync17 } from "fs";
 
 // src/lib/nextVersion.ts
 async function nextVersion() {
@@ -4294,9 +4409,9 @@ async function nextVersion() {
 
 // src/commands/build.ts
 function resolveEntrypoint() {
-  if (existsSync16("./src/index.js"))
+  if (existsSync17("./src/index.js"))
     return "./src/index.js";
-  if (existsSync16("./src/index.ts"))
+  if (existsSync17("./src/index.ts"))
     return "./src/index.ts";
   return "./src/index.js";
 }
@@ -4374,22 +4489,22 @@ async function cmdUuid() {
 }
 
 // src/commands/postbuild.ts
-import { resolve as resolve10 } from "path";
+import { resolve as resolve11 } from "path";
 
 // src/vite/postbuild.ts
 import {
-  existsSync as existsSync17,
+  existsSync as existsSync18,
   readdirSync as readdirSync11,
-  readFileSync as readFileSync25,
+  readFileSync as readFileSync26,
   rmSync,
   statSync as statSync9,
-  writeFileSync as writeFileSync10
+  writeFileSync as writeFileSync11
 } from "fs";
-import { join as join21 } from "path";
+import { join as join22 } from "path";
 
 // src/vite/concat-css.ts
-import { readdirSync as readdirSync10, readFileSync as readFileSync24, writeFileSync as writeFileSync9 } from "fs";
-import { join as join20 } from "path";
+import { readdirSync as readdirSync10, readFileSync as readFileSync25, writeFileSync as writeFileSync10 } from "fs";
+import { join as join21 } from "path";
 var SKIP_CSS = new Set([
   "index.css",
   "tokens.css",
@@ -4405,10 +4520,10 @@ function concatDistCss(options) {
     ...options.skip ?? []
   ]);
   const files = readdirSync10(options.distDir).filter((f) => f.endsWith(".css") && !skip.has(f)).sort();
-  const css = files.map((f) => readFileSync24(join20(options.distDir, f), "utf8")).join(`
+  const css = files.map((f) => readFileSync25(join21(options.distDir, f), "utf8")).join(`
 `);
-  const outPath = join20(options.distDir, outFile);
-  writeFileSync9(outPath, css);
+  const outPath = join21(options.distDir, outFile);
+  writeFileSync10(outPath, css);
   console.log(`[concat-css] ${files.length} \u0444\u0430\u0439\u043B\u043E\u0432 \u2192 ${outFile}`);
   return outPath;
 }
@@ -4426,18 +4541,18 @@ function postbuildLib(options) {
     outFile: options.cssOutFile ?? "index.css"
   });
   for (const name of readdirSync11(dist)) {
-    const dir = join21(dist, name);
+    const dir = join22(dist, name);
     if (!statSync9(dir).isDirectory())
       continue;
     if (keep.has(name))
       continue;
-    const impl = join21(dir, `${name}.d.ts`);
-    const nestedIndex = join21(dir, "index.d.ts");
-    const flat = join21(dist, `${name}.d.ts`);
-    const src = existsSync17(impl) ? impl : existsSync17(nestedIndex) ? nestedIndex : null;
+    const impl = join22(dir, `${name}.d.ts`);
+    const nestedIndex = join22(dir, "index.d.ts");
+    const flat = join22(dist, `${name}.d.ts`);
+    const src = existsSync18(impl) ? impl : existsSync18(nestedIndex) ? nestedIndex : null;
     if (src) {
-      const text = readFileSync25(src, "utf8").replace(/from ['"]\.\.\/([^'"]+)['"]/g, `from './$1'`);
-      writeFileSync10(flat, text);
+      const text = readFileSync26(src, "utf8").replace(/from ['"]\.\.\/([^'"]+)['"]/g, `from './$1'`);
+      writeFileSync11(flat, text);
       console.log(`[postbuild] types \u2192 ${name}.d.ts`);
     }
     rmSync(dir, { recursive: true, force: true });
@@ -4448,7 +4563,7 @@ function postbuildLib(options) {
 // src/commands/postbuild.ts
 async function cmdPostbuild(parsed) {
   const dir = parsed.options.dir || "./dist";
-  const distDir = resolve10(process.cwd(), dir);
+  const distDir = resolve11(process.cwd(), dir);
   postbuildLib({ distDir });
   console.log(`[postbuild] \u0433\u043E\u0442\u043E\u0432\u043E: ${distDir}`);
 }
@@ -4516,8 +4631,8 @@ css-sanitize: \u043F\u043E\u0447\u0438\u043D\u0435\u043D\u043E ${cleaned.length}
 }
 
 // src/commands/audit.ts
-import { existsSync as existsSync18, readFileSync as readFileSync26 } from "fs";
-import { join as join22, relative as relative4 } from "path";
+import { existsSync as existsSync19, readFileSync as readFileSync27 } from "fs";
+import { join as join23, relative as relative4 } from "path";
 function scan(cwd) {
   const out = [];
   const pkg = readPackageJson(cwd);
@@ -4548,7 +4663,7 @@ function scan(cwd) {
   }
   const files = projectCodeRoots(cwd).flatMap((r) => walkCodeFiles(r));
   for (const file of files) {
-    const text = readFileSync26(file, "utf8");
+    const text = readFileSync27(file, "utf8");
     const rel2 = relative4(cwd, file);
     const lines = text.split(/\r?\n/);
     lines.forEach((line, i) => {
@@ -4650,7 +4765,7 @@ function scan(cwd) {
       return false;
     if (/theme(-light|-dark)?\.css$/.test(f))
       return false;
-    const t = readFileSync26(f, "utf8");
+    const t = readFileSync27(f, "utf8");
     return t.includes("--field-border:") && t.includes("--button-secondary-bg:") && t.includes("transparent");
   });
   if (toolbarMarkers.length > 1) {
@@ -4661,8 +4776,8 @@ function scan(cwd) {
       fix: "\u043E\u0431\u0449\u0438\u0439 \u043A\u043B\u0430\u0441\u0441 + theme tokens"
     });
   }
-  const styleDir = ["src/style", "src/styles", "style"].map((d) => join22(cwd, d)).find(existsSync18);
-  if (styleDir && !existsSync18(join22(styleDir, "elcrm.css"))) {
+  const styleDir = ["src/style", "src/styles", "style"].map((d) => join23(cwd, d)).find(existsSync19);
+  if (styleDir && !existsSync19(join23(styleDir, "elcrm.css"))) {
     out.push({
       level: "info",
       code: "elcrm-css",
@@ -4670,8 +4785,8 @@ function scan(cwd) {
       fix: "elcrm css"
     });
   }
-  if (styleDir && existsSync18(join22(styleDir, "elcrm.css"))) {
-    const elcrmCss = readFileSync26(join22(styleDir, "elcrm.css"), "utf8");
+  if (styleDir && existsSync19(join23(styleDir, "elcrm.css"))) {
+    const elcrmCss = readFileSync27(join23(styleDir, "elcrm.css"), "utf8");
     for (const m of elcrmCss.matchAll(/@import\s+["'](@elcrm\/[^"']+)["']/g)) {
       const spec = m[1];
       if (!resolveElcrmCssImport(spec, cwd)) {
@@ -4679,7 +4794,7 @@ function scan(cwd) {
           level: "error",
           code: "elcrm-import-missing",
           message: `\u0431\u0438\u0442\u044B\u0439 @import "${spec}" \u2014 \u0444\u0430\u0439\u043B\u0430 \u043D\u0435\u0442 \u0432 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u043E\u043C \u043F\u0430\u043A\u0435\u0442\u0435`,
-          file: relative4(cwd, join22(styleDir, "elcrm.css")),
+          file: relative4(cwd, join23(styleDir, "elcrm.css")),
           fix: "elcrm css"
         });
       }
@@ -4691,8 +4806,8 @@ function scan(cwd) {
       "theme-light.css",
       "theme-dark.css",
       "theme.css"
-    ].map((f) => join22(styleDir, f));
-    const themeText = themeFiles.filter(existsSync18).map((f) => readFileSync26(f, "utf8")).join(`
+    ].map((f) => join23(styleDir, f));
+    const themeText = themeFiles.filter(existsSync19).map((f) => readFileSync27(f, "utf8")).join(`
 `);
     if (themeText && !/--popup-shadow\s*:/.test(themeText) && /--date-popup-shadow\s*:|--select-background\s*:/.test(themeText)) {
       out.push({
@@ -4714,7 +4829,7 @@ function scan(cwd) {
   for (const file of files) {
     if (!file.endsWith(".css"))
       continue;
-    const text = readFileSync26(file, "utf8");
+    const text = readFileSync27(file, "utf8");
     const relPath = relative4(cwd, file);
     const lines = text.split(/\r?\n/);
     let prevNonEmpty = "";
@@ -4804,7 +4919,7 @@ ${c.cyan("\u2192")} elcrm migrate front${hasFlag(parsed, "dry") ? " --dry" : ""}
 }
 
 // src/commands/kit.ts
-import { resolve as resolve11 } from "path";
+import { resolve as resolve12, join as join24 } from "path";
 function showKitHelp() {
   console.log(`elcrm kit \u2014 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430\u0446\u0438\u044F elUI (UIKit)
 
@@ -4819,7 +4934,13 @@ function showKitHelp() {
   pull [--api=\u2026] [--no-reseed] [--dry]
       emit + sync (\u0443\u0434\u043E\u0431\u043D\u043E \u0432 postbuild)
 
-\u041F\u0435\u0440\u0435\u043C\u0435\u043D\u043D\u044B\u0435: ELUI_API_DIR, ELUI_WEB_DIR
+  config [--api=\u2026] [--web=\u2026] [--global] [--local] [--show]
+      \u0441\u043E\u0445\u0440\u0430\u043D\u0438\u0442\u044C \u043F\u0443\u0442\u0438 elUI (\u043F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E ~/.elcrm/kit-paths.json)
+
+\u041F\u0435\u0440\u0435\u043C\u0435\u043D\u043D\u044B\u0435 (\u043E\u043F\u0446\u0438\u043E\u043D\u0430\u043B\u044C\u043D\u043E): ELUI_API_DIR, ELUI_WEB_DIR
+
+\u041E\u0434\u0438\u043D \u0440\u0430\u0437:
+  elcrm kit config --api=/path/to/elUI.api --web=/path/to/elUI.web --global
 
 \u041F\u0440\u0438\u043C\u0435\u0440 (components):
   npm run build && elcrm kit pull
@@ -4830,7 +4951,7 @@ function showKitHelp() {
 }
 async function cmdKit(parsed) {
   const sub = parsed.positionals[0] || "help";
-  const cwd = resolve11(parsed.options.dir || process.cwd());
+  const cwd = resolve12(parsed.options.dir || process.cwd());
   const dry = hasFlag(parsed, "dry");
   const noReseed = hasFlag(parsed, "no-reseed");
   if (sub === "help" || sub === "--help") {
@@ -4860,6 +4981,37 @@ async function cmdKit(parsed) {
     });
     return;
   }
+  if (sub === "config") {
+    const global = hasFlag(parsed, "global") || !hasFlag(parsed, "local");
+    const show = hasFlag(parsed, "show") || !parsed.options.api && !parsed.options.web;
+    if (show && !parsed.options.api && !parsed.options.web) {
+      const saved = loadKitPathsConfig(cwd);
+      const api = findEluiApiDir(cwd, parsed.options.api) ?? "(\u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D)";
+      const web = findEluiWebDir(cwd, parsed.options.web) ?? "(\u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D)";
+      console.log("elcrm kit config:");
+      console.log("  \u0444\u0430\u0439\u043B:", global ? "~/.elcrm/kit-paths.json" : ".elcrm/kit-paths.json");
+      console.log("  apiDir (\u0444\u0430\u0439\u043B):", saved.apiDir ?? "\u2014");
+      console.log("  webDir (\u0444\u0430\u0439\u043B):", saved.webDir ?? "\u2014");
+      console.log("  apiDir (resolve):", api);
+      console.log("  webDir (resolve):", web);
+      if (!saved.apiDir) {
+        console.log(c.dim(`
+  \u0417\u0430\u0434\u0430\u0442\u044C: elcrm kit config --api=\u2026 --web=\u2026 --global`));
+      }
+      return;
+    }
+    const next = saveKitPathsConfig(cwd, {
+      ...parsed.options.api ? { apiDir: parsed.options.api } : {},
+      ...parsed.options.web ? { webDir: parsed.options.web } : {}
+    }, global);
+    const where = global ? "~/.elcrm/kit-paths.json" : join24(cwd, ".elcrm/kit-paths.json");
+    console.log(c.green("kit config \u0441\u043E\u0445\u0440\u0430\u043D\u0451\u043D \u2192 " + where));
+    if (next.apiDir)
+      console.log("  apiDir:", next.apiDir);
+    if (next.webDir)
+      console.log("  webDir:", next.webDir);
+    return;
+  }
   if (sub === "pull") {
     if (!isElcrmLibPackage(cwd)) {
       console.error(c.red("kit pull \u2014 \u0442\u043E\u043B\u044C\u043A\u043E \u0432 npm-\u043F\u0430\u043A\u0435\u0442\u0435 @elcrm/components | @elcrm/form"));
@@ -4867,6 +5019,8 @@ async function cmdKit(parsed) {
     }
     await emitAndSync({
       cwd,
+      apiDir: parsed.options.api,
+      webDir: parsed.options.web,
       dry,
       reseed: !noReseed
     });
@@ -4881,11 +5035,11 @@ async function cmdKit(parsed) {
 function cliVersion() {
   const here = dirname4(fileURLToPath2(import.meta.url));
   for (const p of [
-    join23(here, "..", "package.json"),
-    join23(here, "package.json")
+    join25(here, "..", "package.json"),
+    join25(here, "package.json")
   ]) {
     try {
-      const v = JSON.parse(readFileSync27(p, "utf8")).version;
+      const v = JSON.parse(readFileSync28(p, "utf8")).version;
       if (typeof v === "string" && v)
         return v;
     } catch {}
@@ -4921,7 +5075,8 @@ function showHelp() {
       .cursor/rules + .cursor/docs + AGENTS.md
       --lib: \u0447\u0435\u043A\u043B\u0438\u0441\u0442 \u0430\u0432\u0442\u043E\u0440\u0430 @elcrm/*
 
-  kit <emit|sync|pull> [--api=\u2026] [--web=\u2026] [--no-reseed] [--dry]
+  kit <emit|sync|pull|config> [--api=\u2026] [--web=\u2026] [--no-reseed] [--dry]
+      config \u2014 \u0441\u043E\u0445\u0440\u0430\u043D\u0438\u0442\u044C \u043F\u0443\u0442\u0438 \u0432 ~/.elcrm/kit-paths.json (--global)
       emit \u2014 manifest \u0438\u0437 dist/*.d.ts (@elcrm/components|form)
       sync \u2014 manifest \u2192 elUI.api/src/kit/manifests + reseed
       pull \u2014 emit + sync (postbuild \u043F\u0430\u043A\u0435\u0442\u0430)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elcrm",
-  "version": "1.1.20",
+  "version": "1.1.22",
   "description": "CLI @elcrm/*: doctor --fix (порядок проекта), update, css, docs, cursor, kit, migrate",
   "type": "module",
   "license": "MIT",

package/templates/elcrm-docs/COMPONENTS.elCRM.md

@@ -14,7 +14,7 @@ Shell UI: оболочка, шапка, секции, списки, Dropdown / R
 import {
   Layout, Header, Footer, Brand, Avatar, AvatarName, AvatarGroup, Badge,
   Menu, Dropdown, Section, NavSections, TabSections, Breadcrumb, Stack,
-  Card, Stat, ActionGroup, TextGroup, ItemColumn, List, Item, PageHead, PageShell, ChatList, ChatMessages, ChatSplit, Sidebar, Popover,
+  Card, Stat, ActionGroup, Toolbar, TextGroup, ItemColumn, List, Item, PageHead, PageShell, ChatList, ChatMessages, ChatSplit, Sidebar, Popover,
   Healthmap, PanelInfo,
   Loading, EmptyState, RadioGroup, PricingGroup, PricingTable,
   createLazyResolver,
@@ -37,7 +37,8 @@ import type { PricingPlan, HealthmapData } from "@elcrm/components";
 - **Stat** — метрика: `label` + `value`, `tone` как у Badge, `labelMuted`. Не собирать из `span` в приложении.
 - **Healthmap** — теплокарта дней (`data.days`). Данные грузит приложение; слоты `brandName` / `brandSub` / `unit` / `hint`. Токены `--healthmap-cell`, `--healthmap-gap`, `--healthmap-l0`…`l4`.
 - **PanelInfo** — выезд справа (шапка / body / footer). На узком экране — оверлей. Слоты: `children`, `footer`, `headerExtra`, `close`. Токены `--panel-info-width`, `--panel-info-width-min`, `--panel-info-overlay-max`, `--panel-info-backdrop`.
-- **ActionGroup** — тулбар: `label` + `items` (узлы) и/или `children`. Кнопки — `@elcrm/button`, не нативный `<button>`.
+- **ActionGroup** — ряд иконок в карточке / строке: `label` + `items` и/или `children`. Кнопки — `@elcrm/button`.
+- **Toolbar** — фильтры над списком. `size` (`s`/`m`/`l`, по умолчанию `s`) наследуют вложенные `*Field`, `Search`, `Button`, `Dropdown` (свой `size` важнее). `align`: `start` / `center` / `end` / `between`. `width`: `l` (100%, по умолчанию) или `s` (по контенту, не растягивать). Токены `--toolbar-gap`. Не `ActionGroup`.
 - **TextGroup** — две строки: `title` + `description` (без аватара; с аватаром — AvatarName).
 - **Item** — строка списка. `as` button/a/li, `active`. `variant="card"` — рамка и muted-фон (идеи / тикеты / inbox). Не дублировать `.desk-row` в приложении.
 - **ItemColumn** — внутри Item: `icon` слева, столбик `title` / `description` / `footer` или `meta`, `extra` — бейджи справа сверху, `aside` — колонка справа. `unread` — жирный title. Title: `--item-column-title-size` / `--item-column-title-line` (в console = `--button-size-s` / `--button-line-height`).
@@ -45,7 +46,7 @@ import type { PricingPlan, HealthmapData } from "@elcrm/components";
 ## Меню
 
 - **Menu** — inline-навигация в шапке. `items`: `value` + `label` + `badge` (`0` не показываем, иначе `Badge` size s). `variant="line"` — вкладки с чертой снизу (не ломать pill селекторами страницы).
-- **Dropdown** — выпадающее меню по `items`/`groups` (portal). `placement="auto"|"top"|"bottom"` — куда открывать панель (футер Sidebar — `top`).
+- **Dropdown** — выпадающее меню по `items`/`groups` (portal). `placement="auto"|"top"|"bottom"` — куда открывать панель (футер Sidebar — `top`). `size` — высота триггера; в `Toolbar` берётся сам.
 - **Popover** — свой попап в portal (якорь + `children`). z-index: `acquireOverlayZIndex` (тот же стек, что у form). Не `@elcrm/overlay` `Menu`. `placement` как у Dropdown: позиция по **реальной** высоте панели, не по `maxHeight` 420.
 
 ## Avatar
@@ -65,6 +66,7 @@ import type { PricingPlan, HealthmapData } from "@elcrm/components";
 - `--layout-padding` / `--layout-margin` / `--layout-max-width` — отступы и макс. ширина корня Layout (`0` / `none` = на весь вьюпорт).
 - `--header-border` — рамка Header (shorthand: все стороны и толщина). Только снизу: `none` + линия через `--header-shadow`.
 - `--header-nav-justify` — выравнивание `nav` в шапке (`flex-start` / `center` / `flex-end`).
+- `<Toolbar size="s" width="l" align="start">` — один размер для Search / `*Field` / Button / Dropdown. `width="s"` — ряд по контенту. Свой `size` у ребёнка важнее.
 - Узкие токены (`--chat-*`, `--sidebar-*`, `--item-column-*`) по умолчанию = `--shell-*`. Переопределяй только отличие.
 - Задать `--shell-color` / `--shell-padding` / `--shell-radius` один раз — большинство компонентов подхватят.
 - `--popup-shadow` общий с `@elcrm/form`.

package/templates/elcrm-docs/FORM.elCRM.md

@@ -23,7 +23,8 @@ const form = useForm({ login: "", password: "" });
 
 Канонические поля: `StringField`, `PasswordField`, `TextareaField`, `NumberField`, `PercentField`, `MoneyField`, `MaskField`, `PhoneField`, `EmailField`, `UrlField`, `DateField`, `TimeField`, `SelectField`, `OptionsField`, `ModalField`, `RangeField`, `CheckField`, `RadioField`, `TagsField`, `RatingField`, `CodeField`, `FileField`, `DragDropField`, `RichTextField`, `ColorField`, `HiddenField`, `DisplayField`, `SearchField`, `TabsField`.
 
-`disabled`, `size` (`"s"` | `"m"` | `"l"`) — у всех видимых `*Field` (кроме `HiddenField`).
+`disabled`, `size` (`"s"` | `"m"` | `"l"`) — у всех видимых `*Field` (кроме `HiddenField`).  
+В ряду фильтров — `<Toolbar size="s">` из `@elcrm/components`: вложенные поля/Search/Button берут этот `size`.
 
 `PasswordField`: `generate` — кнопка случайного пароля. `true` → `Az09#` (A–Z, a–z, 0–9, символы). `generate="A"` только заглавные, `"59"` цифры 5–9, `"#"` только символы. Длина — `maxLength` или 12.
 

package/templates/orbit/web/src/style/theme.css

@@ -134,6 +134,7 @@
   --item-column-title-line: 1.3;
   --stat-value-size: 1.75rem;
   --action-group-gap: var(--shell-gap-sm);
+  --toolbar-gap: var(--shell-gap-sm);
   --sidebar-width: 260px;
   --sidebar-pad-x: var(--shell-gap);
   --sidebar-pad-y: var(--shell-gap-lg);

package/templates/panel/web/src/style/theme.css

@@ -145,6 +145,7 @@
   --item-column-title-line: 1.3;
   --stat-value-size: 1.75rem;
   --action-group-gap: var(--shell-gap-sm);
+  --toolbar-gap: var(--shell-gap-sm);
   --sidebar-width: 248px;
   --sidebar-pad-x: var(--shell-gap);
   --sidebar-pad-y: var(--shell-gap-lg);