elcrm 1.1.1 → 1.1.2

package/dist/vite/discover-lib.js

@@ -11,8 +11,8 @@ function assignLetters(names, overrides) {
   const used = new Set;
   const letters = {};
   for (const [name, letter] of Object.entries(overrides)) {
-    if (!/^[a-z]$/.test(letter)) {
-      throw new Error(`[discover-lib] override "${name}" → "${letter}" (нужна a-z)`);
+    if (!/^[a-z0-9]$/.test(letter)) {
+      throw new Error(`[discover-lib] override "${name}" → "${letter}" (нужна a-z0-9)`);
     }
     if (used.has(letter)) {
       throw new Error(`[discover-lib] дубль буквы "${letter}" в overrides`);
@@ -25,9 +25,9 @@ function assignLetters(names, overrides) {
     if (letters[name])
       continue;
     const base = name.replace(/[^a-zA-Z]/g, "").toLowerCase();
-    let letter = [...base].find((c) => /[a-z]/.test(c) && !used.has(c)) ?? [..."abcdefghijklmnopqrstuvwxyz"].find((c) => !used.has(c));
+    let letter = [...base].find((c) => /[a-z]/.test(c) && !used.has(c)) ?? [..."abcdefghijklmnopqrstuvwxyz0123456789"].find((c) => !used.has(c));
     if (!letter) {
-      throw new Error(`[discover-lib] нет свободной буквы для "${name}"`);
+      throw new Error(`[discover-lib] нет свободной буквы/цифры для "${name}"`);
     }
     used.add(letter);
     letters[name] = letter;

package/dist/vite/plugin-css-scoped.js

@@ -46,8 +46,8 @@ function createCssScoped(options) {
     if (!letter) {
       throw new Error(`[css-scoped] нет буквы для компонента "${component}". Добавьте в components.`);
     }
-    if (!/^[a-z]$/.test(letter)) {
-      throw new Error(`[css-scoped] буква компонента "${component}" должна быть a-z: "${letter}"`);
+    if (!/^[a-z0-9]$/.test(letter)) {
+      throw new Error(`[css-scoped] ключ компонента "${component}" должен быть a-z0-9: "${letter}"`);
     }
     const scoped = `${prefix}${letter}${name}`;
     const owner = `${component}.${name}`;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elcrm",
-  "version": "1.1.1",
-  "description": "CLI для экосистемы @elcrm/*: update, create, init, migrate, doctor, test, build, postbuild",
+  "version": "1.1.2",
+  "description": "CLI @elcrm/*: update, create, migrate front, audit, doctor, test, build, css",
   "type": "module",
   "license": "MIT",
   "author": "MaSkal <dev@elcrm.online>",

package/templates/elcrm-cursor/AGENTS.md

@@ -0,0 +1,13 @@
+# elCRM
+
+Стек: React + Vite + Bun, `@elcrm/*`. API: `@elcrm/server` path-RPC, клиент `@elcrm/api`.
+
+Шпаргалки: `docs/*.elCRM.md` и `.cursor/docs/*.elCRM.md`. Не выдумывать API пакетов.
+
+Корень UI: `Alert.Init` / `Modal.Init` / `Notice.Init` / `Form.Init` + `LoadRoute`. Кнопки `@elcrm/button`, поля `@elcrm/form`, модалки `Modal.Create`.
+
+Нельзя: native input/button, react-router, axios, MUI/antd/tailwind, `themes.css`, `size="sm"|"md"`.
+
+Перед сдачей: `elcrm test` (в panel — из корня). После смены пакетов: `elcrm update --fix --test`.
+
+Обновить эти файлы: `elcrm docs && elcrm cursor`.

package/templates/elcrm-cursor/rules/elcrm-lib.mdc

@@ -0,0 +1,101 @@
+---
+description: Автор @elcrm/* — после src сразу обновить шпаргалки в elCRM.cli
+alwaysApply: true
+---
+
+# Репозиторий библиотеки (`elcrm cursor --lib`)
+
+Ты в пакете `@elcrm/*`. После изменений в `src/` **сам** доведи этот репо **и** документацию CLI. Не ждать просьбы «обнови docs».
+
+Комментарии в коде — на русском. Минимум зависимостей.
+
+## Источник `elcrm docs` / `elcrm cursor` (обязательно)
+
+Команды берут тексты **не из этого пакета**, а из репозитория CLI. Если его не обновить — приложения получат устаревшие правила.
+
+Каталог CLI (этот компьютер):
+
+```
+/Users/maskal/Documents/elCRM/@elcrm/elCRM.cli
+```
+
+Рядом с текущим пакетом то же самое: `../elCRM.cli`  
+(например `elCRM.button` → `elCRM.cli`).
+
+Править **сразу в том репо**, в тех же файлах, которые копируются в проекты:
+
+| Что изменилось в пакете           | Файл в CLI                                                    |
+| --------------------------------- | ------------------------------------------------------------- |
+| Как пользоваться / можно / нельзя | `templates/elcrm-docs/<ПАКЕТ>.elCRM.md`                       |
+| Новый пакет в каталоге            | `src/lib/elcrmDocsCatalog.ts` + строка в `elcrm-packages.mdc` |
+| Общие запреты UI                  | `templates/elcrm-cursor/rules/elcrm-ui.mdc`, `elcrm.mdc`      |
+| Сервер / легаси                   | `elcrm-server.mdc`, `src/lib/test/serverRules.ts`             |
+| Breaking rename                   | `src/lib/migrate/*` + audit / `elcrm test`                    |
+| Новые токены CSS                  | шпаргалка + чтобы `elcrm css` их подхватывал                  |
+
+Карта пакета → файл:
+
+| `@elcrm/…`    | `templates/elcrm-docs/`  |
+| ------------- | ------------------------ |
+| api           | `API.elCRM.md`           |
+| alert         | `ALERT.elCRM.md`         |
+| button        | `BUTTON.elCRM.md`        |
+| modal         | `MODAL.elCRM.md`         |
+| notice        | `NOTICE.elCRM.md`        |
+| notifications | `NOTIFICATIONS.elCRM.md` |
+| passkey       | `PASSKEY.elCRM.md`       |
+| router        | `ROUTER.elCRM.md`        |
+| socket        | `SOCKET.elCRM.md`        |
+| tooltip       | `TOOLTIP.elCRM.md`       |
+| icons         | `ICONS.elCRM.md`         |
+| form          | `FORM.elCRM.md`          |
+| components    | `COMPONENTS.elCRM.md`    |
+| server        | `SERVER.elCRM.md`        |
+| CLI (`elcrm`) | `CLI.elCRM.md`           |
+
+После правок CLI достаточно, чтобы в приложениях снова вызвали `elcrm docs` и `elcrm cursor` — они перезапишут `docs/` и `.cursor/`.
+
+## Чеклист по типу правки в `src/`
+
+### 1. Публичный API (компонент, хук, функция, тип, props)
+
+- [ ] Экспорт в `index` и `package.json` `exports`
+- [ ] `README.md` этого пакета
+- [ ] **Шпаргалка в elCRM.cli** (таблица выше) — те же можно/нельзя, что в README
+- [ ] Тест на контракт
+- [ ] Breaking → migrate + test в CLI
+
+### 2. CSS / токены `--*`
+
+- [ ] Rename токена = migrate в CLI
+- [ ] Нет `themes.css`
+- [ ] `check:css` / `check:tokens` если есть
+- [ ] README + шпаргалка в CLI, если токен для приложений
+
+### 3. Баг без смены API
+
+- [ ] Тест, patch-версия; CLI не трогать, если шпаргалка ещё верна
+
+### 4. Init / синглтоны
+
+- [ ] «Один раз в App» в README и в шпаргалке CLI
+
+### 5. `@elcrm/server`
+
+- [ ] README/MPC + `serverRules.ts` + `SERVER.elCRM.md`
+
+## Команды в этом репо (до коммита)
+
+```bash
+bun run test
+bun run check:css      # если есть
+bun run check:tokens
+bun run build
+```
+
+Версия: patch / minor / major. Публикация — push `main` (elGIT Actions).
+
+## Нельзя забыть
+
+- Не писать шпаргалки только в `docs/` **приложения** — они сотрутся следующим `elcrm docs`
+- `sideEffects` CSS, `files`: dist, peer react ≥ 18, size `s`/`m`/`l`

package/templates/elcrm-cursor/rules/elcrm-module.mdc

@@ -0,0 +1,25 @@
+---
+description: Новый модуль panel — копировать Settings/List, свой ключ роутера
+globs: "**/modules/**/*.{tsx,ts}"
+alwaysApply: false
+---
+
+# Новый модуль
+
+Не изобретать страницу с нуля. Скопировать соседний модуль (`Settings` или `List`).
+
+```
+src/modules/<Name>/
+  index.tsx              export default
+  router.sections.ts     ключи + default
+  sections/<Key>.tsx     export default
+  modal/<Name>.tsx       опционально, Modal.Create
+```
+
+- Вкладки/сайдбар: `createLazyResolver((key) => import(\`./sections/${key}.tsx\`))`.
+- Свой ключ в `Router`: `section` / `listTab` / `accountTab` — **не один `tab` на все модули**.
+- Активный ключ: `pickRouteKey(Router.useRouter("…"), KEYS, DEFAULT)`.
+- Оболочка: `Section` / `NavSections` / `TabSections`. Поля — `@elcrm/form`, кнопки — `@elcrm/button`.
+- Подключить модуль в меню/`LoadRoute` и в `RouterDataMap`, если он есть.
+
+Модалка: `modules/<Name>/modal/<File>.tsx`, не `Modal.Add` в кнопке.

package/templates/elcrm-cursor/rules/elcrm-packages.mdc

@@ -0,0 +1,43 @@
+---
+description: Каталог пакетов @elcrm/* — всегда смотри docs/*.elCRM.md перед кодом
+alwaysApply: true
+---
+
+# Пакеты elCRM — возможности
+
+**Сначала открой шпаргалку**, не выдумывай API:
+
+- в проекте: `docs/*.elCRM.md`
+- копия для агента: `.cursor/docs/*.elCRM.md`
+- обновить оба: `elcrm docs && elcrm cursor`
+
+| Файл                     | Пакет                  | Делать так                                              |
+| ------------------------ | ---------------------- | ------------------------------------------------------- |
+| `CLI.elCRM.md`           | `elcrm`                | `update --fix --test`, migrate, test, css, docs, cursor |
+| `API.elCRM.md`           | `@elcrm/api`           | `Api.create` + `Api.query("router/method", body)`       |
+| `ALERT.elCRM.md`         | `@elcrm/alert`         | `<Alert.Init />`, `Alert.Send` / `Confirm`              |
+| `BUTTON.elCRM.md`        | `@elcrm/button`        | `<Button onSend>`, size s/m/l, не `<button>`            |
+| `MODAL.elCRM.md`         | `@elcrm/modal`         | `<Modal.Init />`, **`Modal.Create` + Open**, не Add     |
+| `NOTICE.elCRM.md`        | `@elcrm/notice`        | `<Notice.Init />`, Success/Error/Remark/Undo            |
+| `NOTIFICATIONS.elCRM.md` | `@elcrm/notifications` | Init + Bell + worker?url; сервер `/notifications`       |
+| `PASSKEY.elCRM.md`       | `@elcrm/passkey`       | **только** `createPasskeyClient` + `/react` хуки        |
+| `ROUTER.elCRM.md`        | `@elcrm/router`        | `Router.data` + LoadRoute, не react-router              |
+| `SOCKET.elCRM.md`        | `@elcrm/socket`        | клиент SharedWorker; сервер `createSocket`              |
+| `TOOLTIP.elCRM.md`       | `@elcrm/tooltip`       | `<Tooltip content>`, не `title`                         |
+| `ICONS.elCRM.md`         | `@elcrm/icons`         | `Icons.Line`, vite `icons()`, `icons update`            |
+| `FORM.elCRM.md`          | `@elcrm/form`          | поля + useForm, не native input                         |
+| `COMPONENTS.elCRM.md`    | `@elcrm/components`    | Layout/Header/Section/NavSections                       |
+| `SERVER.elCRM.md`        | `@elcrm/server`        | createServer + createRouter, не REST, не node:fs        |
+
+## Корень приложения (panel)
+
+```tsx
+<Alert.Init />
+<Modal.Init />
+<Notice.Init position="top-right" />
+<Notifications.Init … />   // если push
+<Form.Init onNotice={(m) => Notice.Remark(String(m))} />
+<LoadRoute variant="page" … />
+```
+
+HTTP: `@elcrm/api`. WS: `@elcrm/socket` после логина (тот же ssid). Кнопки: `@elcrm/button`. Подсказки: `@elcrm/tooltip`.

package/templates/elcrm-cursor/rules/elcrm-rpc.mdc

@@ -0,0 +1,23 @@
+---
+description: Новый path-RPC — createRouter + Api.query, без REST и jwt.init
+globs: "**/api/**/*.{ts,js}"
+alwaysApply: false
+---
+
+# Новый метод API
+
+```ts
+createRouter("orders").use("list", async ({ user, body }) => {
+  if (!user?.id) return rpcLogout();
+  return rpcOk({ items: [] });
+});
+```
+
+Клиент (web): `Api.query("orders/list", { … })` — тот же prefix, что `createServer({ prefix })`.
+
+- Регистрация в `routes/index.ts` (или рядом с остальными `createRouter`).
+- `user` уже из JWT сервера — не вызывать `jwt.init` в handler.
+- SQLite: `@elcrm/server/db`, без `node:fs` / `node:path`.
+- Ошибка клиенту: `rpcErr` / throw → непрозрачный internal; детали в `console.error`.
+
+Нельзя: `fetch`, `path === "/api/"`, `handle*(ctx): Promise<Response>`, `nodemailer`, `web-push`.

package/templates/elcrm-cursor/rules/elcrm-server.mdc

@@ -0,0 +1,30 @@
+---
+description: Сервер elCRM — createServer, роутеры, запреты
+globs: "**/api/**/*.{ts,js}"
+alwaysApply: false
+---
+
+# `@elcrm/server`
+
+Подробности: `docs/SERVER.elCRM.md`.
+
+## Как писать
+
+- Точка входа: `createServer({ port, prefix, jwt, cron, cors })`.
+- Методы: `createRouter("name").use("method", handler)` + `rpcOk` / `rpcErr` / `rpcLogout`.
+- `user` уже из JWT createServer — не вызывать `jwt.init` в каждом handler.
+- БД: `import { db, initDB } from "@elcrm/server/db"` — каталог SQLite создаётся сам.
+- Cron: `import { cron } from "@elcrm/server/cron"; cron.use(fn, interval?, name?)`.
+- WS: `createSocket("ws").use("path", handler)` **до** `createServer`; слать `sendSocket`.
+
+## Запрещено
+
+- `from "@elcrm/db"` / `jwt` / `cron` / `tb` — только `@elcrm/server/…`
+- `from "node:fs"` / `from "node:path"` для типовых задач (mkdir под sqlite, join путей)
+- `createServerFromEnv`, `createWsHub`, `serverConnect`, `Cron.useJob`
+- REST `if (path === "/api/…")`, `export async function handle*(ctx): Promise<Response>`
+- `nodemailer`, `web-push`
+- `CORS_ORIGIN` (singular) — только `CORS_ORIGINS` без path в значении
+- Отдавать клиенту stack / `err.message`
+
+Автопроверка: `elcrm test --server`. Правки легаси: `bunx elcrm-server update`.

package/templates/elcrm-cursor/rules/elcrm-theme.mdc

@@ -0,0 +1,13 @@
+---
+description: CSS-токены — геометрия в theme.css, цвет в light и dark
+globs: "**/theme*.css,**/elcrm.css"
+alwaysApply: false
+---
+
+# Тема
+
+- Размеры/отступы/радиусы → `theme.css` (`:root`).
+- Цвет → **оба** файла: `theme-light.css` и `theme-dark.css`.
+- Не класть `--*` в `modules/**/style.css`, если это цвет/размер оболочки.
+- Не `import "@elcrm/*/themes.css"`. Не shorthand `1px solid` в `--field-border-hover`.
+- Недостающие дефолты: `elcrm css` (уже заданные не затирает).

package/templates/elcrm-cursor/rules/elcrm-ui.mdc

@@ -0,0 +1,41 @@
+---
+description: UI elCRM — компоненты, форма, структура модулей
+globs: "**/*.{tsx,jsx,css}"
+alwaysApply: false
+---
+
+# UI `@elcrm/*`
+
+Шпаргалки: `docs/*.elCRM.md`, `.cursor/docs/*.elCRM.md`.
+
+## Корень App
+
+`Alert.Init`, `Modal.Init`, `Notice.Init`, `Form.Init`, при необходимости `Notifications.Init`, затем `LoadRoute`.
+
+## Структура (panel / app)
+
+```
+src/App.tsx          — *.Init + LoadRoute
+src/pages/           — экраны (Auth, Main)
+src/modules/Name/
+  index.tsx
+  router.sections.ts
+  sections/Key.tsx   — export default
+  modal/Name.tsx     — Modal.Create
+src/style/theme*.css + elcrm.css
+```
+
+- Кнопки: `@elcrm/button` (`onSend`). Иконки: `Icons.Line`. Подсказки: `@elcrm/tooltip`.
+- HTTP: `Api.query("auth/pass", body)`. Роутер: `Router.setRouter` / `mergeRouter`, разные ключи вкладок.
+- `NavSections` / `TabSections`: `createLazyResolver((key) => import(\`./sections/${key}.tsx\`))`.
+
+## Формы и модалки
+
+- `useForm` + `name`/`form`. Канон полей — `docs/FORM.elCRM.md`.
+- `Modal.Create` + Open, не `Modal.Add`.
+- Passkey: `createPasskeyClient` + `usePasskeySupport`.
+
+## CSS / запреты
+
+- Токены в theme, не `themes.css`, не `size="sm"|"md"`, не native input/select/textarea.
+- Border hover/focus полей — только цвет.

package/templates/elcrm-cursor/rules/elcrm.mdc

@@ -0,0 +1,43 @@
+---
+description: Базовые правила elCRM для агента Cursor
+alwaysApply: true
+---
+
+# elCRM — как работать в этом репозитории
+
+**Всегда** сверяйся со шпаргалками: `docs/*.elCRM.md` и `.cursor/docs/*.elCRM.md` (каталог пакетов — правило `elcrm-packages`). Не выдумывай методы. Обновить: `elcrm docs && elcrm cursor`.
+
+Комментарии и документация — **на русском**. Минимум зависимостей. Компоненты разделяй по обязанностям.
+
+## Стек
+
+- Фронт: React + Vite + Bun, пакеты `@elcrm/*`.
+- API: Bun + `@elcrm/server` (path-RPC, не REST `/api/...`).
+- Клиент HTTP `@elcrm/api`, WS `@elcrm/socket` (ssid общий).
+- Стили: `theme.css` + `theme-light` / `theme-dark`. Не импортировать `@elcrm/*/themes.css`.
+- Размеры UI: `"s"` | `"m"` | `"l"`.
+
+## После смены `@elcrm/*` в приложении
+
+```bash
+elcrm update --fix --test
+elcrm css
+elcrm docs
+elcrm cursor
+```
+
+Автор `@elcrm/*`: после правок API **сразу** обновить шпаргалки в репо CLI
+(`/Users/maskal/Documents/elCRM/@elcrm/elCRM.cli` или соседний `../elCRM.cli`),
+иначе `elcrm docs` / `elcrm cursor` устареют. Чеклист: `elcrm cursor --lib`.
+
+## Нельзя
+
+- Нативные `<input>`, `<textarea>`, `<select>` — `@elcrm/form`.
+- Нативный `<button>` в UI — `@elcrm/button`.
+- `Modal.Add` — `Modal.Create`.
+- `createPasskey` — `createPasskeyClient`.
+- Серверные `@elcrm/db|jwt|cron|tb` на фронте.
+- Секреты / `.env` в чат.
+- Не ставить MUI, antd, tailwind, react-router, axios — только `@elcrm/*` из `package.json`.
+
+**Сдача:** `elcrm test` (panel — из корня). Нет — задача не закончена.

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

@@ -0,0 +1,26 @@
+<!-- Сгенерировано `elcrm docs`. Пакет: @elcrm/alert. -->
+
+# `@elcrm/alert`
+
+iOS-алерты, Promise API. Обязательно `<Alert.Init />` в корне (`App.tsx`).
+
+```tsx
+import { Alert } from "@elcrm/alert";
+
+await Alert.Send({ title: "Заголовок", text: "Текст", icon: "success" });
+const ok = await Alert.Confirm({ title: "Удалить?", icon: "warning" });
+```
+
+## Можно
+
+- `Alert.Send(content)` → `Promise<{ confirmed, action? }>`. С callback — void (легаси).
+- `icon`: `success` \| `error` \| `warning` \| `info`.
+- `button` или `buttons[]`: `{ label, color?: "blue"|"red"|"default", action, onClick }`.
+- `closeOnOverlay` / `closeOnEscape` (по умолчанию true).
+- Токены `--alert-*` в теме приложения (`elcrm css`).
+
+## Нельзя
+
+- `window.alert` / `window.confirm`.
+- Несколько `Alert.Init`.
+- Нативные `<button>` в UI приложения, если это действие формы — `@elcrm/button`.

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

@@ -0,0 +1,38 @@
+<!-- Сгенерировано `elcrm docs`. Пакет: @elcrm/api. -->
+
+# `@elcrm/api`
+
+HTTP-клиент path-RPC к `@elcrm/server`. JSON `{ status, data }` → `query` возвращает `data` или throw.
+
+```ts
+import { Api } from "@elcrm/api";
+
+Api.create({
+  url: "https://api.example.com/v1/",
+  method: "POST",
+  timeout: 15000,
+  storageKey: "elcrm-token", // ssid
+});
+
+const users = await Api.query<User[]>("users/list", { page: 1 });
+```
+
+## Можно
+
+- `Api.create` — клиент по умолчанию; `Api.client({ url })` — второй origin (тот же `storageKey` = общий ssid).
+- `resolveUrl` / `urlKey` + `urlPath` — tenant URL из storage.
+- Тело: `json` (default) · `formdata` · `crypto` (`encryptQuery`) · `binary`.
+- `responseAs`: `json` \| `text` \| `blob` \| `arraybuffer`.
+- React: `const [status, data, update] = Api.useQuery(link, body)` — мемоизируйте `body`.
+- `Api.getSSID()`, `Api.url()`, `Api.image("/x")`, `Api.Logout()`.
+
+Контракт `status`: `success` → data; `error` → throw; `logout` → `Api.Logout()`; `refresh` → новый ssid и **один** повтор.
+
+Side-fields рядом с `status`/`data`: `ssid` → storageKey, `url` → urlKey, `port` → portKey (снимаются до unwrap).
+
+## Нельзя
+
+- REST `fetch("/api/users")` вместо `Api.query("router/method", body)`.
+- Путать URL: base уже с prefix (`/v1/` или `/api/`), путь RPC без лишнего `/api`.
+- Игнорировать logout/refresh — сессия сломается.
+- `createPasskey` из `@elcrm/passkey` — это другой пакет; HTTP passkey тоже через клиент/сервер passkey.

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

@@ -0,0 +1,36 @@
+<!-- Сгенерировано `elcrm docs`. Пакет: @elcrm/button. -->
+
+# `@elcrm/button`
+
+Кнопка с вариантами, размерами и `onSend` (pending). Токены задаёт приложение, fallback в пакете нет.
+
+```tsx
+import { Button } from "@elcrm/button";
+
+<Button variant="primary" size="m" width="m" label="Отправить" onClick={() => {}} />
+
+<Button
+  label="Сохранить"
+  onSend={(done) => {
+    void save().finally(() => done(false));
+  }}
+  pendingContent="Сохранение…"
+/>
+```
+
+## Можно
+
+- `variant`: `primary` · `secondary` · `positive` · `negative` · `ghost`
+- `size`: `s` · `m` · `l`  |  `width`: `s` (контент) · `m` (min-width) · `l` (на всю ширину)
+- `label` / `before` / `after`; `children` перекрывает слоты
+- `onSend(setDisabled, event)`: вернуть `false` — не входить в pending; иначе снять через `setDisabled(false)`
+- Если задан `onClick` — `onSend` **не** вызывается
+- `buttonType`: `button` \| `submit` \| `reset`
+- Точечно: `@elcrm/button/Button`
+
+## Нельзя
+
+- Нативный `<button>` в UI приложения (кроме редких слотов, где пакет сам просит children).
+- `size="sm"|"md"`.
+- `import "@elcrm/button/themes.css"` — нет такого файла; токены в theme приложения.
+- Хардкод цветов вместо `--button-*`.

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

@@ -0,0 +1,27 @@
+<!-- Сгенерировано `elcrm docs`. Пакет: elcrm (CLI). -->
+
+# `elcrm` CLI
+
+Глобально: `bun i -g elcrm`. В приложении — после смены `@elcrm/*`:
+
+```bash
+elcrm update --fix --test
+elcrm css
+elcrm docs
+elcrm cursor
+```
+
+| Команда | Зачем |
+| --- | --- |
+| `update [--dry] [--core] [--fix] [--test]` | latest `@elcrm/*`; `--fix` = migrate front + css; `--test` = elcrm test |
+| `create` / `init` | шаблоны `app` \| `lib` \| `panel` |
+| `migrate <name> [--dry]` | `front` (пакет), `form-aliases`, `form-tokens`, `size-sml`, `field-border`, `modal-create`, `legacy-hacks`, `socket-server` |
+| `audit [--fix]` | старые API; `--fix` = migrate front |
+| `doctor [--fix]` | стандарты; сервер --fix → `bunx elcrm-server update` |
+| `test [--front\|--server] [--no-scripts]` | статический анализ + scripts |
+| `css [--dry]` | недостающие токены → theme*.css |
+| `docs` / `cursor` | шпаргалки и правила агента |
+| `cursor --lib` / `-lib` | правила автора `@elcrm/*` lib (чеклист после правок src) |
+| `build` / `postbuild` / `uuid` | деплой клиента/api; склейка CSS lib |
+
+Не выдумывать флаги — `elcrm --help` и `COMMANDS.md`.

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

@@ -0,0 +1,68 @@
+<!-- Сгенерировано `elcrm docs`. Источник: @elcrm/components + шаблон panel. Обновление: снова elcrm docs. -->
+
+# `@elcrm/components`
+
+Shell UI: оболочка страницы, шапка, секции, списки. **Цвета и размеры задаёт приложение** (`theme.css` + `theme-light` / `theme-dark`). Fallback в пакете нет. `elcrm css` дописывает недостающие токены.
+
+```ts
+import {
+  Layout, Header, Footer, Brand, Avatar, Badge,
+  Menu, Section, NavSections, TabSections,
+  Card, List, Item, Block, Row, Column,
+  Loading, EmptyState, createLazyResolver,
+} from "@elcrm/components";
+```
+
+Точечно: `import { Header } from "@elcrm/components/Header"`.
+
+## Компоненты
+
+| | Назначение | Ключевые props |
+| --- | --- | --- |
+| Layout | страница | `header`, `footer`, `children` |
+| Header | слоты шапки | `brand`, `nav`, `search`, `actions` |
+| Footer | подвал | `children` |
+| Brand | логотип | `as`, `onClick` |
+| Avatar | фото / инициалы | `src`, `name`, `size` (`s`/`m`/`l`) |
+| Badge | статус | `tone` |
+| Menu | нав (не overlay) | `items`, `activeKey`, `onSelect` |
+| Section | блок / auth | `title`, `description`, `icon`, `actions`, `variant` |
+| NavSections | сайдбар + lazy | `groups`, `resolveSection` |
+| TabSections | вкладки + lazy | `items`, `resolveSection` |
+| Card / List / Item | карточка, список | Item: `as`, `active` |
+| Block / Row / Column | стеки | `gap` |
+| Loading / EmptyState | плейсхолдеры | |
+| createLazyResolver | кэш `import()` | `(key) => import(…)` |
+
+Слоты Header заполняет приложение: поиск `@elcrm/search`, кнопки `@elcrm/button`, иконки `@elcrm/icons`.
+
+## Структура приложения (panel)
+
+```
+src/
+  App.tsx                 # Init: Alert, Modal, Notice, Form, LoadRoute
+  pages/Auth.tsx Main.tsx
+  modules/<Name>/
+    index.tsx
+    router.sections.ts
+    sections/<Key>.tsx    # export default
+    modal/                # опционально
+  component/              # локальные обёртки (Header приложения)
+  style/theme.css theme-light.css theme-dark.css elcrm.css
+```
+
+- Секции: `createLazyResolver((key) => import(\`./sections/${key}.tsx\`))`.
+- Ключи роутера не смешивать (`section` vs `listTab` vs `accountTab`) — иначе lazy откроет не ту секцию.
+- Auth-экран: `<Section variant="auth">`, поля из `@elcrm/form`, submit через `@elcrm/button` `onSend`.
+
+## Можно
+
+Токены только в theme-файлах приложения. Импорт `@elcrm/components/style.css` — опционально (единый файл).
+
+## Нельзя
+
+- `import "@elcrm/…/themes.css"` — пакеты больше не отдают темы.
+- Свои `<button>` / нативные инпуты вместо `@elcrm/button` / `@elcrm/form` в UI приложения.
+- `size="sm"|"md"` → `"s"|"m"` (`elcrm migrate size-sml`).
+- Дублировать toolbar-токены в модульных CSS — общий класс + theme.
+- Хардкодить цвета в компонентах модулей, если есть токен.

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

@@ -0,0 +1,39 @@
+<!-- Сгенерировано `elcrm docs`. Источник: @elcrm/form. Обновление: снова elcrm docs. -->
+
+# `@elcrm/form`
+
+Поля ввода + `useForm`. Стили вшиты в JS — отдельный css-loader не нужен. Темы: `@elcrm/form/light.css` / `dark.css` (или токены приложения + `elcrm css`).
+
+## Можно
+
+```tsx
+import { useForm, StringField, PasswordField, Form } from "@elcrm/form";
+
+const form = useForm({ login: "", password: "" });
+
+<Form.Init onNotice={(msg) => { /* тост */ }} />
+<StringField name="login" form={form} label="Логин" autoComplete="username" />
+<PasswordField name="password" form={form} label="Пароль" />
+```
+
+`Form.Init` — если нужны notice / модалки для `ModalField` / `OptionsField`.
+
+Связь: всегда `name` + `form`. Значения: `getValue` / `getValues` / `setValue` / `setValues` / `reset`.  
+Для Date/массивов/объектов — **новая ссылка**, иначе `Object.is` не уведомит. Принудительный ререндер: `setValue`.
+
+Канонические поля: `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`.
+
+`before` / `after` — слоты (иконки). Размеры: `"s"` | `"m"` | `"l"`, не `sm`/`md`.
+
+Токены: `--field-padding-block` / `--field-padding-inline`, `--popup-shadow`. Hover/focus/disabled border — **только цвет**, не shorthand `1px solid …`.
+
+## Нельзя
+
+- Нативные `<input>`, `<textarea>`, `<select>` в приложении — `elcrm test` это **error**. Исключение: пакет `@elcrm/form`.
+- Алиасы: `ProgressField` → `RangeField`, `ReadonlyField` → `DisplayField`, `OtpField` → `CodeField`, `SegmentField` → `TabsField`, `DragonDropField` → `DragDropField`. Чинит `elcrm migrate form-aliases`.
+- Проп `native` на полях — `elcrm test` предупреждает. У `StringField` `native` исторически для autofill; у `PasswordField` `native` значит «не рендерить» — не путать.
+- Legacy-токены: `--field-note-padding*`, `--control-inner-padding`, `--control-side-padding`, `--field-side-padding`, `--date-popup-shadow` → `elcrm migrate form-tokens`.
+- Пересоздавать `options` селекта на каждый рендер — константа модуля.
+- Серверные пакеты `@elcrm/db|jwt|cron|tb` на фронте.
+
+Подпути (tree-shake): `@elcrm/form/fields/Date`, `@elcrm/form/hooks/use`.