elcrm 1.1.5 → 1.1.7

package/dist/vite/minify-css-vars.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Vite plugin: короткие CSS-переменные и классы после сборки.
+ * @see minifyCssVars
+ */
+export type MinifyCssVarsOptions = {
+  /** Длина короткого `--xx` (`2` → `--ab`). По умолчанию 3 */
+  var?: number;
+  /** Длина суффикса класса после prefix (`3` + prefix `x` → `xabc`) */
+  name?: number;
+  /** Общий стартовый индекс кодировки */
+  start?: number;
+  varStart?: number;
+  nameStart?: number;
+  vars?: boolean;
+  classes?: boolean;
+  minVar?: number;
+  minClass?: number;
+  classPrefix?: string;
+  report?: boolean;
+  js?: boolean;
+  css?: boolean;
+};
+
+export declare function toIndex(value: unknown, fallback?: number): number;
+
+export declare function encodeName(index: number, length: number): string;
+
+export declare function namespaceSize(length: number): number;
+
+/**
+ * Короткие имена без коллизий: пропускает `reserved`, не выдаёт одно `to` дважды.
+ */
+export declare function allocateUnique(
+  originals: string[],
+  reserved: Set<string>,
+  make: (index: number) => string,
+  start: number,
+  capacity: number,
+  kind: string,
+): Map<string, string>;
+
+export declare function minifyCssVars(
+  options?: MinifyCssVarsOptions,
+): import("vite").Plugin;

package/dist/vite/minify-css-vars.js

@@ -0,0 +1,280 @@
+// src/vite/minify-css-vars.ts
+var VAR_RE = /--[a-zA-Z_][\w-]*/g;
+var VAR_IN_JS_RE = /var\(\s*(--[a-zA-Z_][\w-]*)|["'](--[a-zA-Z_][\w-]*)["']/g;
+var CLASS_SEL_RE = /\.(-?[_a-zA-Z]+[_a-zA-Z0-9-]*)/g;
+var LETTERS = "abcdefghijklmnopqrstuvwxyz";
+function collect(texts, re) {
+  const set = new Set;
+  for (const text of texts) {
+    if (!text)
+      continue;
+    re.lastIndex = 0;
+    let m;
+    while (m = re.exec(text))
+      set.add(m[1] ?? m[0]);
+  }
+  return set;
+}
+function collectJsVars(texts) {
+  const set = new Set;
+  for (const text of texts) {
+    if (!text)
+      continue;
+    VAR_IN_JS_RE.lastIndex = 0;
+    let m;
+    while (m = VAR_IN_JS_RE.exec(text)) {
+      const name = m[1] ?? m[2];
+      if (name)
+        set.add(name);
+    }
+  }
+  return set;
+}
+function toIndex(value, fallback = 0) {
+  const n = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(n) || n < 0)
+    return fallback;
+  return Math.floor(n);
+}
+function encodeName(index, length) {
+  const n = LETTERS.length;
+  const len = Math.max(1, Math.min(8, Math.floor(length)));
+  let i = toIndex(index, 0);
+  let s = "";
+  for (let k = 0;k < len; k++) {
+    s = LETTERS[i % n] + s;
+    i = Math.floor(i / n);
+  }
+  return s;
+}
+function byLongest(names) {
+  return [...names].sort((a, b) => b.length - a.length);
+}
+function alreadyShortVar(name, len) {
+  return new RegExp(`^--[a-z]{${len}}$`).test(name);
+}
+function shouldMinifyClass(name, minLen, prefix) {
+  if (name.length < minLen)
+    return false;
+  const esc = prefix.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  if (new RegExp(`^${esc}[a-z0-9]+$`).test(name))
+    return false;
+  return /[-_]/.test(name);
+}
+function namespaceSize(length) {
+  const len = Math.max(1, Math.min(8, Math.floor(length)));
+  let n = 1;
+  for (let i = 0;i < len; i++)
+    n *= LETTERS.length;
+  return n;
+}
+function allocateUnique(originals, reserved, make, start, capacity, kind) {
+  const taken = new Set(reserved);
+  const out = new Map;
+  let cursor = start;
+  for (const from of originals) {
+    if (out.has(from))
+      continue;
+    let found;
+    for (let n = 0;n < capacity; n++) {
+      const candidate = make(cursor);
+      cursor++;
+      if (taken.has(candidate) || candidate === from)
+        continue;
+      found = candidate;
+      break;
+    }
+    if (!found) {
+      throw new Error(`[minify-css-vars] нет свободных имён для ${kind}: нужно ${originals.length}, ёмкость ${capacity}, занято ${taken.size}. Увеличьте var/name или сдвиньте start.`);
+    }
+    out.set(from, found);
+    taken.add(found);
+  }
+  const used = new Set;
+  for (const [from, to] of out) {
+    if (used.has(to)) {
+      throw new Error(`[minify-css-vars] коллизия ${kind}: «${from}» и ещё одно имя → «${to}»`);
+    }
+    used.add(to);
+    if (reserved.has(to)) {
+      throw new Error(`[minify-css-vars] «${from}» → «${to}» затирает существующее имя ${kind}`);
+    }
+  }
+  return out;
+}
+function replaceVarsInCss(text, map) {
+  let out = text;
+  for (const [from, to] of map)
+    out = out.split(from).join(to);
+  return out;
+}
+function replaceVarsInJs(text, map) {
+  let out = text;
+  for (const [from, to] of map) {
+    const esc = from.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    out = out.replace(new RegExp(`var\\(\\s*${esc}\\b`, "g"), (m) => m.replace(from, to));
+    out = out.replace(new RegExp(`(["'])${esc}\\1`, "g"), `$1${to}$1`);
+  }
+  return out;
+}
+function replaceClasses(text, map, inCss) {
+  let out = text;
+  for (const [from, to] of map) {
+    if (inCss) {
+      out = out.split(`.${from}`).join(`.${to}`);
+      continue;
+    }
+    const re = new RegExp(`(^|[^\\w-])(${from.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")})(?=[^\\w-]|$)`, "g");
+    out = out.replace(re, `$1${to}`);
+  }
+  return out;
+}
+function bytes(s) {
+  return Buffer.byteLength(s, "utf8");
+}
+function fmtKb(n) {
+  if (n < 1024)
+    return `${n} B`;
+  return `${(n / 1024).toFixed(2)} kB`;
+}
+function pct(before, after) {
+  if (!before)
+    return "0%";
+  const p = (before - after) / before * 100;
+  const sign = p > 0 ? "−" : p < 0 ? "+" : "";
+  return `${sign}${Math.abs(p).toFixed(1)}%`;
+}
+function normalizeOpts(raw) {
+  const o = raw ?? {};
+  const varLen = o.var ?? 3;
+  const nameLen = o.name ?? 2;
+  const start = toIndex(o.start, 0);
+  return {
+    varLen,
+    nameLen,
+    varStart: toIndex(o.varStart, start),
+    nameStart: toIndex(o.nameStart, start),
+    vars: o.vars !== false,
+    classes: o.classes !== false,
+    minVar: o.minVar ?? Math.max(4, varLen + 2),
+    minClass: o.minClass ?? 5,
+    classPrefix: o.classPrefix ?? "x",
+    report: o.report !== false,
+    js: o.js !== false,
+    css: o.css !== false
+  };
+}
+function minifyCssVars(options) {
+  const opt = normalizeOpts(options);
+  return {
+    name: "elcrm-minify-css-vars",
+    apply: "build",
+    enforce: "post",
+    generateBundle(_opts, bundle) {
+      const files = [];
+      for (const [fileName, item] of Object.entries(bundle)) {
+        if (item.type !== "asset" && item.type !== "chunk")
+          continue;
+        const isCss = opt.css && fileName.endsWith(".css");
+        const isJs = opt.js && fileName.endsWith(".js");
+        if (!isCss && !isJs)
+          continue;
+        const raw = item.type === "chunk" ? item.code : typeof item.source === "string" ? item.source : item.source ? Buffer.from(item.source).toString("utf8") : "";
+        files.push({ item, fileName, raw, isCss, isJs });
+      }
+      const cssTexts = files.filter((f) => f.isCss).map((f) => f.raw);
+      const jsTexts = files.filter((f) => f.isJs).map((f) => f.raw);
+      const varMap = new Map;
+      if (opt.vars) {
+        const names = new Set([
+          ...collect(cssTexts, VAR_RE),
+          ...collectJsVars(jsTexts)
+        ]);
+        const remap = [];
+        const reserved = new Set;
+        for (const name of names) {
+          if (alreadyShortVar(name, opt.varLen) || /^--[a-zA-Z_]$/.test(name) || name.length < opt.minVar) {
+            reserved.add(name);
+            continue;
+          }
+          remap.push(name);
+        }
+        const cap = namespaceSize(opt.varLen);
+        const allocated = allocateUnique(byLongest(remap), reserved, (i) => `--${encodeName(i, opt.varLen)}`, opt.varStart, cap, "vars");
+        for (const [k, v] of allocated)
+          varMap.set(k, v);
+      }
+      const classMap = new Map;
+      if (opt.classes) {
+        const allClasses = new Set;
+        for (const file of files) {
+          if (!file.isCss)
+            continue;
+          CLASS_SEL_RE.lastIndex = 0;
+          let m;
+          while (m = CLASS_SEL_RE.exec(file.raw))
+            allClasses.add(m[1]);
+        }
+        const remap = [];
+        const reserved = new Set;
+        for (const name of allClasses) {
+          if (shouldMinifyClass(name, opt.minClass, opt.classPrefix)) {
+            remap.push(name);
+          } else {
+            reserved.add(name);
+          }
+        }
+        const cap = namespaceSize(opt.nameLen);
+        const allocated = allocateUnique(byLongest(remap), reserved, (i) => `${opt.classPrefix}${encodeName(i, opt.nameLen)}`, opt.nameStart, cap, "classes");
+        for (const [k, v] of allocated)
+          classMap.set(k, v);
+      }
+      if (!varMap.size && !classMap.size) {
+        if (opt.report) {
+          console.log("[minify-css-vars] нечего сокращать");
+        }
+        return;
+      }
+      const varEntries = [...varMap.entries()];
+      let beforeAll = 0;
+      let afterAll = 0;
+      const rows = [];
+      for (const file of files) {
+        const before = bytes(file.raw);
+        let next = file.raw;
+        if (varMap.size) {
+          next = file.isCss ? replaceVarsInCss(next, varEntries) : replaceVarsInJs(next, varEntries);
+        }
+        if (classMap.size) {
+          next = replaceClasses(next, classMap, file.isCss);
+        }
+        const after = bytes(next);
+        beforeAll += before;
+        afterAll += after;
+        if (next !== file.raw) {
+          if (file.item.type === "chunk") {
+            file.item.code = next;
+          } else {
+            file.item.source = next;
+          }
+        }
+        if (opt.report && (next !== file.raw || before !== after)) {
+          rows.push(`  ${file.fileName}  ${fmtKb(before)} → ${fmtKb(after)}  (${pct(before, after)})`);
+        }
+      }
+      if (opt.report) {
+        console.log(`[minify-css-vars] vars: ${varMap.size} (пример --${encodeName(opt.varStart, opt.varLen)}, start=${opt.varStart})  classes: ${classMap.size} (пример ${opt.classPrefix}${encodeName(opt.nameStart, opt.nameLen)}, start=${opt.nameStart})`);
+        for (const row of rows)
+          console.log(row);
+        console.log(`[minify-css-vars] итого  ${fmtKb(beforeAll)} → ${fmtKb(afterAll)}  (${pct(beforeAll, afterAll)})`);
+      }
+    }
+  };
+}
+export {
+  toIndex,
+  namespaceSize,
+  minifyCssVars,
+  encodeName,
+  allocateUnique
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elcrm",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "CLI @elcrm/*: update --fix --test, css (prune imports), docs, cursor, migrate, audit",
   "type": "module",
   "license": "MIT",
@@ -33,6 +33,11 @@
       "types": "./dist/vite/postbuild.d.ts",
       "import": "./dist/vite/postbuild.js",
       "default": "./dist/vite/postbuild.js"
+    },
+    "./vite/minify-css-vars": {
+      "types": "./dist/vite/minify-css-vars.d.ts",
+      "import": "./dist/vite/minify-css-vars.js",
+      "default": "./dist/vite/minify-css-vars.js"
     }
   },
   "files": [
@@ -44,10 +49,10 @@
     "node": ">=18"
   },
   "scripts": {
-    "build": "bun build ./src/index.ts --outdir ./dist --target bun --format esm && bun build ./src/vite/plugin-css-scoped.ts --outfile ./dist/vite/plugin-css-scoped.js --target node --format esm --packages external && bun build ./src/vite/discover-lib.ts --outfile ./dist/vite/discover-lib.js --target node --format esm --packages external && bun build ./src/vite/concat-css.ts --outfile ./dist/vite/concat-css.js --target node --format esm --packages external && bun build ./src/vite/check-tokens.ts --outfile ./dist/vite/check-tokens.js --target node --format esm --packages external && bun build ./src/vite/postbuild.ts --outfile ./dist/vite/postbuild.js --target node --format esm --packages external && node ./scripts/chmod-bin.mjs && node ./scripts/copy-vite-dts.mjs",
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun --format esm && bun build ./src/vite/plugin-css-scoped.ts --outfile ./dist/vite/plugin-css-scoped.js --target node --format esm --packages external && bun build ./src/vite/discover-lib.ts --outfile ./dist/vite/discover-lib.js --target node --format esm --packages external && bun build ./src/vite/concat-css.ts --outfile ./dist/vite/concat-css.js --target node --format esm --packages external && bun build ./src/vite/check-tokens.ts --outfile ./dist/vite/check-tokens.js --target node --format esm --packages external && bun build ./src/vite/postbuild.ts --outfile ./dist/vite/postbuild.js --target node --format esm --packages external && bun build ./src/vite/minify-css-vars.ts --outfile ./dist/vite/minify-css-vars.js --target node --format esm --packages external && node ./scripts/chmod-bin.mjs && node ./scripts/copy-vite-dts.mjs",
     "dev": "bun run ./src/index.ts",
     "elcrm": "bun run ./src/index.ts",
-    "test": "bun test src/lib/migrate",
+    "test": "bun test src/lib/migrate src/vite",
     "link:local": "bun run build && bun link",
     "prepublishOnly": "bun run test && bun run build",
     "publish:npm": "npm publish"

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

@@ -90,6 +90,23 @@ elcrm test                   # статический анализ + scripts п
 elcrm test --front|--server|--no-scripts
 ```
 
+### Vite-плагины из пакета `elcrm`
+
+Нужен **elcrm ≥ 1.1.6** в `devDependencies` приложения (не только глобальный `bun i -g`). Иначе Vite: `Missing "./vite/minify-css-vars" specifier`.
+
+```js
+import { minifyCssVars } from "elcrm/vite/minify-css-vars";
+
+// только command === "build"
+minifyCssVars({ var: 2, name: 3, classPrefix: "x" })
+```
+
+`nameStart` / `varStart` — **числа** (индекс алфавита), не `"x"`. Префикс класса — `classPrefix`. В JS плагин не трогает декремент `--n` (иначе `aqt is not defined`).
+
+Короткие имена **уникальны**: занятые `--aa` / `xaa` пропускаются, одно `to` не выдаётся дважды; если слотов нет — сборка падает, а не молча затирает токены.
+
+Также: `elcrm/vite/plugin-css-scoped`, `discover-lib`, `concat-css`, `check-tokens`, `postbuild`.
+
 ### Прочее
 
 ```bash