elcrm 1.1.13 → 1.1.15

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elcrm",
-  "version": "1.1.13",
-  "description": "CLI @elcrm/*: update --fix --test, css (prune imports), docs, cursor, migrate, audit",
+  "version": "1.1.15",
+  "description": "CLI @elcrm/*: doctor --fix (порядок проекта), update, css, docs, cursor, migrate",
   "type": "module",
   "license": "MIT",
   "author": "MaSkal <dev@elcrm.online>",
@@ -52,7 +52,7 @@
     "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 src/vite",
+    "test": "bun test src/lib/migrate src/lib/tidy.test.ts src/vite",
     "link:local": "bun run build && bun link",
     "prepublishOnly": "bun run test && bun run build",
     "publish:npm": "npm publish"

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

@@ -22,7 +22,7 @@ alwaysApply: false
  * Слоты (что можно передать):
  * - brand — логотип (`Brand`)
  * - nav — пункты (`Menu`)
- * - search — `@elcrm/search`
+ * - search — `SearchField` из `@elcrm/form`
  * - actions — кнопки, `Avatar`, `Tooltip`
  *
  * @see Header из `@elcrm/components` — те же слоты

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

@@ -26,7 +26,7 @@ alwaysApply: true
 | `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/Stack/NavSections; migrate components |
+| `COMPONENTS.elCRM.md`    | `@elcrm/components`    | Layout/Header/Sidebar/Popover/Dropdown; migrate components |
 | `SERVER.elCRM.md`        | `@elcrm/server`        | createServer + createRouter, не REST, не node:fs        |
 
 ## Корень приложения (panel)

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

@@ -12,7 +12,7 @@ alwaysApply: false
 
 `Alert.Init`, `Modal.Init`, `Notice.Init`, `Form.Init`, при необходимости `Notifications.Init`, затем `LoadRoute`.
 
-## Структура (panel / app)
+## Структура (panel / app / orbit)
 
 ```
 src/App.tsx          — *.Init + LoadRoute
@@ -25,6 +25,8 @@ src/modules/Name/
 src/style/theme*.css + elcrm.css
 ```
 
+Orbit: `Layout sidebar={<Sidebar />}` вместо верхней `Header`. Дашборд — `PageShell` + `Stat` / `Card` / `Item`.
+
 - Кнопки: `@elcrm/button` (`onSend`). Иконки: `Icons.Line`. Подсказки: `@elcrm/tooltip`.
 - HTTP: `Api.query("auth/pass", body)`. Роутер: `Router.setRouter` / `mergeRouter`, разные ключи вкладок.
 - `NavSections` / `TabSections`: `createLazyResolver((key) => import(\`./sections/${key}.tsx\`))`.

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

@@ -11,8 +11,8 @@ import { Button } from "@elcrm/button";
 
 <Button
   label="Сохранить"
-  onSend={(done) => {
-    void save().finally(() => done(false));
+  onSend={async () => {
+    await save();
   }}
   pendingContent="Сохранение…"
 />
@@ -23,7 +23,7 @@ import { Button } from "@elcrm/button";
 - `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)`
+- `onSend(setDisabled, event)`: синхронный `false` — без pending; промис/`async` — pending до settle; иначе снять через `setDisabled(false)`
 - Если задан `onClick` — `onSend` **не** вызывается
 - `buttonType`: `button` \| `submit` \| `reset`
 - Точечно: `@elcrm/button/Button`

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

@@ -62,12 +62,15 @@ elcrm cursor --lib           # + чеклист автора @elcrm/* (прав
 
 ```bash
 elcrm migrate --list
-elcrm migrate front          # пакет (то же, что update/audit/doctor --fix):
-                             #   form-aliases → form-tokens → components →
-                             #   css-sanitize → size-sml → field-border →
-                             #   modal-create → socket-server
+elcrm migrate front          # пакет (то же, что doctor --fix без css):
+                             #   form-aliases → form-native → native-html →
+                             #   form-tokens → components → css-sanitize →
+                             #   size-sml → field-border → modal-create →
+                             #   socket-server
+elcrm migrate form-native    # снять prop native у @elcrm/form
+elcrm migrate native-html    # <input|textarea> → StringField/CheckField/…
 elcrm migrate css-sanitize   # осиротевшие in srgb / transparent);
-elcrm migrate components     # Block/Row → Stack, --page-* → --shell-*
+elcrm migrate components     # Block/Row → Stack, --page-* / --item-* → --shell-*
 elcrm migrate form-tokens
 elcrm migrate form-aliases
 elcrm migrate size-sml       # size sm|md → s|m|l
@@ -82,12 +85,15 @@ elcrm migrate socket-server
 ### `audit` / `doctor` / `test` — проверки
 
 ```bash
-elcrm audit                  # старые API, битые @import, orphan color-mix, …
-elcrm audit --fix            # = migrate front (+ css не вызывает — после: elcrm css)
-elcrm doctor                 # стандарты проекта
-elcrm doctor --fix          # type/engines + migrate front
+elcrm audit                  # старые API, native input, prop native, orphan color-mix, …
+elcrm audit --fix            # = migrate front (после: elcrm css или doctor --fix)
+elcrm doctor                 # навести порядок (migrate + css)
+elcrm doctor --docs          # + docs/*.elCRM.md и .cursor
+elcrm doctor --test          # затем elcrm test
+elcrm doctor --dry           # только превью
 elcrm test                   # статический анализ + scripts проекта
-elcrm test --front|--server|--no-scripts
+elcrm test --fix             # migrate front, затем анализ
+elcrm test --front|--server|--no-scripts|--dry
 ```
 
 ### Vite-плагины из пакета `elcrm`
@@ -110,8 +116,15 @@ minifyCssVars({ var: 2 })
 ### Прочее
 
 ```bash
-elcrm create <name> [--template app|lib|panel] [--no-install]
-elcrm init [--template …] [--force] [--no-install]
+elcrm create my-app --template app
+elcrm create my-lib --template lib
+elcrm create my-panel --template panel
+elcrm create my-shop --template orbit
+elcrm create my-app --template app --no-install
+elcrm init --template app
+elcrm init --template lib --force
+elcrm init --template panel
+elcrm init --template orbit --force --no-install
 elcrm build --client [--url=…] [--name=…] [--dir=…] [--folder=…]
 elcrm postbuild [--dir=./dist]   # lib: склейка CSS после vite build
 elcrm uuid
@@ -124,6 +137,7 @@ elcrm -v / --help
 
 | Ситуация | Команды |
 | --- | --- |
+| Проект после смены API/токенов, пакеты уже стоят | `elcrm doctor` (+ `--docs --test`) |
 | Обновили пакеты / «после elcrm update всё красное» | полный цикл из 4 команд сверху |
 | Vite: `ENOENT … @elcrm/…/light.css` | `elcrm css` → при необходимости `elcrm audit` |
 | Битый theme (`in srgb` без свойства) | `elcrm migrate css-sanitize` или `update --fix` |

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, List, Item, PageHead, PageShell,
+  Card, Stat, ActionGroup, TextGroup, ItemColumn, List, Item, PageHead, PageShell, Sidebar, Popover,
   Loading, EmptyState, RadioGroup, PricingGroup, PricingTable,
   createLazyResolver,
 } from "@elcrm/components";
@@ -23,22 +23,30 @@ import type { PricingPlan } from "@elcrm/components";
 
 ## Роли layout
 
-- **PageShell** — каркас модуля (скролл + footer).
-- **PageHead** — title + actions.
+- **PageShell** — каркас модуля (`scroll` в body + footer). `scroll={false}` — без внутреннего скролла.
+- **PageHead** — title + actions. `sup` — текст или Badge сразу после title (надстрочно; `0` скрыт). `sticky` — шапка прилипает к верху скролла (фон `--shell-bg`). `children` — фильтры/поиск под заголовком, отступ `--shell-gap`.
 - **Section** — блок контента / auth.
-- **Layout / Header** — оболочка приложения.
-- **Stack** — ряд/колонка (`direction="row"|"column"`). Не `Block` / `Row` / `Column`.
+- **Layout / Header** — оболочка приложения. `Layout sidebar={<Sidebar />}` — ряд: меню слева + контент.
+- **Sidebar** — левое меню. `variant="cards"` (карточки) или `"plain"` (плоский backoffice). `groups` + `value`. Слоты: `brand`, `extra`, `footer`. Пункты: `--sidebar-item-font-size`, `--sidebar-item-padding`, `--sidebar-icon-size`, `--sidebar-group-font-size`. Не наследуют `body` 18px (`Item` `font: inherit` перебит).
+- **Stack** — ряд/колонка/сетка (`direction="row"|"column"|"grid"`). Не `Block` / `Row` / `Column`. Сетка: `auto-fit` + `--stack-grid-min`, либо `columns={4}` / `columns={["1fr", "100px", "auto"]}`. С `columns` ряды `stretch` (карточки не наезжают); в одну линию — `style={{ alignItems: "center" }}`. Не `height: 100%` у детей сетки.
+- **Card** — курсор: `--card-pointer` (`auto` / `pointer`). Сетка Stack: `--stack-grid-min`.
+- **Stat** — метрика: `label` + `value`, `tone` как у Badge, `labelMuted`. Не собирать из `span` в приложении.
+- **ActionGroup** — тулбар: `label` + `items` (узлы) и/или `children`. Кнопки — `@elcrm/button`, не нативный `<button>`.
+- **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`).
 
 ## Меню
 
-- **Menu** — inline-навигация в шапке.
-- **Dropdown** — выпадающее меню по `items`/`groups`.
-- **`@elcrm/overlay`** — portal / позиционирование / z-stack для своих попапов.
+- **Menu** — inline-навигация в шапке. `items`: `value` + `label` + `badge` (`0` не показываем, иначе `Badge` size s). `variant="line"` — вкладки с чертой снизу (не ломать pill селекторами страницы).
+- **Dropdown** — выпадающее меню по `items`/`groups` (portal).
+- **Popover** — свой попап в portal (якорь + `children`). z-index: `acquireOverlayZIndex` (тот же стек, что у form). Не `@elcrm/overlay` `Menu`.
 
 ## Avatar
 
-- **Avatar** — фото / инициалы (`name` только для инициалов).
-- **AvatarName** — `title` + `description` (+ `name` для инициалов).
+- **Avatar** — фото / инициалы (`name` только для инициалов). Скругление: `radius={10}` или `--avatar-radius` (дефолт `999px` — круг).
+- **Badge** — метка: `tone`, `size` (`s`/`m`/`l`), `dot` (точка слева). Не Button.
+- **AvatarName** — `title` + `description` (+ `name` для инициалов). Тот же `radius`. Цвета: `--avatar-name-title-color`, `--avatar-name-description-color`.
 - **AvatarGroup** — `items` с `value` / `title` / `name` / `src`.
 
 ## Pricing

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

@@ -21,17 +21,25 @@ const form = useForm({ login: "", password: "" });
 Связь: всегда `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`.
+Канонические поля: `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`.
 
 `before` / `after` — слоты (иконки). Размеры: `"s"` | `"m"` | `"l"`, не `sm`/`md`.
 
+`PasswordField`: `generate` — кнопка случайного пароля. `true` → `Az09#` (A–Z, a–z, 0–9, символы). `generate="A"` только заглавные, `"59"` цифры 5–9, `"#"` только символы. Длина — `maxLength` или 12.
+
+`SearchField` — поиск в форме (`form`+`name`, `timeout`, `suggestions` / `loadSuggestions`, `minimal`, `hotkey`, `variant="ghost"|"filled"`).
+
+В хедере / тулбаре — `<Search value onValue>` из `@elcrm/search` (без формы). Стили те же `--field-*` / `--select-*`; узкие: `--field-search-min-width`, `--field-search-expand-min`, `--field-search-list-max-height`.
+
 Токены: `--field-padding-block` / `--field-padding-inline`, `--popup-shadow`. Hover/focus/disabled border — **только цвет**, не shorthand `1px solid …`.
 
 ## Нельзя
 
-- Нативные `<input>`, `<textarea>`, `<select>` в приложении — `elcrm test` это **error**. Исключение: пакет `@elcrm/form`.
+- Нативные `<input>`, `<textarea>`, `<select>` в приложении — `elcrm test` это **error**. Исключение: пакет `@elcrm/form`. Чинит (best-effort): `elcrm migrate native-html` / `elcrm test --fix`. `<select>` и input с `ref`/`onKeyDown` — вручную.
 - Алиасы: `ProgressField` → `RangeField`, `ReadonlyField` → `DisplayField`, `OtpField` → `CodeField`, `SegmentField` → `TabsField`, `DragonDropField` → `DragDropField`. Чинит `elcrm migrate form-aliases`.
-- Проп `native` на полях — `elcrm test` предупреждает. У `StringField` `native` исторически для autofill; у `PasswordField` `native` значит «не рендерить» — не путать.
+- В форме: `Search` из `@elcrm/search` → `SearchField` (`form`+`name`). Хедер — `@elcrm/search`.
+- Токены `--search-*` → `--field-*` (`elcrm migrate form-tokens`).
+- Проп `native` на полях — `elcrm test` предупреждает; снять: `elcrm migrate form-native`. У `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` на фронте.

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

@@ -21,6 +21,8 @@ import { icons } from "@elcrm/icons/vite";
 export default defineConfig({ plugins: [icons(), react()] });
 ```
 
+Плагин ставит alias `@elcrm/icons/generated` → `src/icons.generated.tsx` и исключает пакет из `optimizeDeps` (иначе prebundle отдаёт stub и `Icons.Line` пустой).
+
 ```tsx
 import { Icons } from "@elcrm/icons";
 <Icons.Line name="search" size={20} />

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

@@ -6,7 +6,7 @@ In-app inbox + Web Push. Сервер: `@elcrm/server` (subpath notifications),
 
 ```tsx
 import { Notifications, bindRouterNavigate } from "@elcrm/notifications";
-import workerUrl from "@elcrm/notifications/worker?url";
+const workerUrl = "/push-sw.js"; // не import ?url — Vite делает data:, SW нельзя
 
 bindRouterNavigate((url) => { /* Router / pathname */ });
 

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

@@ -39,8 +39,10 @@ Env: `TOKEN` / `JWT_SECRET`, `CORS_ORIGINS` (origins **без path**, через
 | `@elcrm/db` `@elcrm/jwt` `@elcrm/cron` `@elcrm/tb` | `@elcrm/server/db` `/jwt` `/cron` `/tb` |
 | `createServerFromEnv` | `createServer()` |
 | `createJwtFromEnv` / `createCronFromEnv` / `createTbFromEnv` | `createJWT` / `createCron` / `createTb` |
-| `createWsHub` / `serverConnect` | `createSocket("ws").use(…)` |
+| `createWsHub` / `serverConnect` / `createServer({ websocket: { handlers } })` | `createSocket("ws").use(…)` до `createServer` |
 | `hub.sendListen` | `sendSocket` |
+| свой `fetch` на `api.telegram.org` | `tb.sendMessage` / `tb.use` |
+| `CORS_ORIGINS` для origins из БД | `cors({ resolveOrigin })` |
 | `Cron.useJob` / namespace `Cron` | `cron.use` |
 | REST `path === "/api/…"` / `handle*(ctx): Promise<Response>` | `createRouter().use()` |
 | `nodemailer` / `web-push` | `@elcrm/server/mail` / `notifications` |

package/templates/orbit/README.md

@@ -0,0 +1,12 @@
+# Orbit
+
+Шаблон витрины на `@elcrm/components`: `Layout` + `Sidebar` + дашборд Home.
+
+```bash
+elcrm create my-shop --template orbit
+bun run dev
+```
+
+Web: http://localhost:5173
+
+Демо-вход: любой логин/пароль (локальный store, API не обязателен).

package/templates/orbit/index.html

@@ -0,0 +1,28 @@
+<!doctype html>
+<html lang="en" data-theme="light">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Orbit</title>
+    <script>
+      try {
+        var t = localStorage.getItem("elcrm-orbit-theme");
+        if (t !== "light" && t !== "dark") t = "light";
+        document.documentElement.setAttribute("data-theme", t);
+        document.documentElement.style.colorScheme = t;
+      } catch (e) {}
+    </script>
+  </head>
+  <body data-theme="light">
+    <script>
+      try {
+        document.body.setAttribute(
+          "data-theme",
+          document.documentElement.getAttribute("data-theme") || "light",
+        );
+      } catch (e) {}
+    </script>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/orbit/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "orbit",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite --port 5173",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@elcrm/alert": "0.1.1",
+    "@elcrm/api": "0.1.55",
+    "@elcrm/button": "1.1.0",
+    "@elcrm/components": "0.1.2",
+    "@elcrm/core": "0.1.3",
+    "@elcrm/crypto": "0.0.2",
+    "@elcrm/error-boundary": "0.0.2",
+    "@elcrm/form": "0.1.8",
+    "@elcrm/modal": "0.0.34",
+    "@elcrm/notice": "0.1.3",
+    "@elcrm/notifications": "0.3.1",
+    "@elcrm/passkey": "0.2.3",
+    "@elcrm/router": "0.0.58",
+    "@elcrm/search": "0.1.5",
+    "@elcrm/setting": "0.0.6",
+    "@elcrm/state": "0.0.7",
+    "@elcrm/tooltip": "0.1.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.79",
+    "@types/react-dom": "^18.2.25",
+    "@vitejs/plugin-react": "^4.3.1",
+    "typescript": "^5.8.2",
+    "vite": "^5.4.2"
+  }
+}

package/templates/orbit/src/App.tsx

@@ -0,0 +1,34 @@
+import { Alert } from "@elcrm/alert";
+import { Modal } from "@elcrm/modal";
+import { Notice } from "@elcrm/notice";
+import { Notifications } from "@elcrm/notifications";
+import { Form } from "@elcrm/form";
+import { LoadRoute } from "@elcrm/router";
+import { createLazyResolver } from "./lazyRoute";
+
+const resolvePage = createLazyResolver((segment) =>
+  import(`./pages/${segment}.tsx`),
+);
+
+/**
+ * Корень Orbit: Init пакетов + страница.
+ */
+export default function App() {
+  return (
+    <>
+      <Alert.Init />
+      <Modal.Init />
+      <Notice.Init position="top-right" durationMs={2200} maxVisible={4} />
+      <Notifications.Init appBadge={false} autoSync={false} />
+      <Form.Init onNotice={(msg) => Notice.Remark(String(msg))} />
+      <LoadRoute
+        variant="page"
+        defaultName="Main"
+        resolveLazyPage={resolvePage}
+        loading={<div className="app-loading">Загрузка…</div>}
+      >
+        <span aria-hidden />
+      </LoadRoute>
+    </>
+  );
+}

package/templates/orbit/src/component/Nav.tsx

@@ -0,0 +1,139 @@
+import React from "react";
+import {
+  AvatarName,
+  Brand,
+  Dropdown,
+  Sidebar,
+  Stack,
+} from "@elcrm/components";
+import { Button } from "@elcrm/button";
+import { Search } from "@elcrm/search";
+import { Router } from "@elcrm/router";
+import { Alert } from "@elcrm/alert";
+import { Tooltip } from "@elcrm/tooltip";
+import useStateData from "../state";
+import { Ico, Icon } from "../lib/icon";
+import { getTheme, toggleTheme } from "../lib/theme";
+
+const GROUPS = [
+  {
+    value: "menu",
+    title: "Menu",
+    items: [
+      { value: "Home", label: "Home", icon: <Icon d={Ico.home} /> },
+      { value: "Catalog", label: "Catalog", icon: <Icon d={Ico.catalog} /> },
+      { value: "Finances", label: "Finances", icon: <Icon d={Ico.finances} /> },
+      { value: "Customers", label: "Customers", icon: <Icon d={Ico.customers} /> },
+      { value: "Marketing", label: "Marketing", icon: <Icon d={Ico.marketing} /> },
+      { value: "Analytics", label: "Analytics", icon: <Icon d={Ico.analytics} /> },
+    ],
+  },
+  {
+    value: "integrations",
+    title: "Integrations",
+    items: [
+      {
+        value: "Integrations",
+        label: "Integrations",
+        icon: <Icon d={Ico.grid} />,
+      },
+    ],
+  },
+  {
+    value: "channels",
+    title: "Sales Channels",
+    items: [
+      { value: "Store", label: "Online Store", icon: <Icon d={Ico.store} /> },
+      { value: "Link", label: "Sell Via Link", icon: <Icon d={Ico.link} /> },
+    ],
+  },
+];
+
+/**
+ * Левое меню Orbit: `Sidebar` + магазин + поиск + профиль.
+ */
+export default function Nav() {
+  const { user, shop, setShop } = useStateData(["user", "shop"]);
+  const module = Router.useRouter("module");
+  const [q, setQ] = React.useState("");
+  const [theme, setThemeState] = React.useState(() => getTheme());
+
+  const onLogout = () => {
+    Alert.Send(
+      { title: "Log out", text: "Leave the dashboard?" },
+      () => {
+        Router.mergeRouter({ page: "Auth", module: "Home" });
+      },
+    );
+  };
+
+  return (
+    <Sidebar
+      variant="plain"
+      value={String(module || "Home")}
+      onSelect={(value) => Router.setRouter("module", value)}
+      brand={
+        <Stack direction="column" gap="0.75rem">
+          <Brand>Orbit</Brand>
+          <Dropdown
+            label={shop}
+            align="start"
+            items={[
+              { value: "Mob Shop", label: "Mob Shop" },
+              { value: "Jankenpun", label: "Jankenpun" },
+            ]}
+            onSelect={(value) => setShop(value)}
+          />
+          <Search
+            value={q}
+            onValue={(v: string) => setQ(v)}
+            placeholder="Search"
+            aria-label="Search"
+            timeout={0}
+          />
+        </Stack>
+      }
+      groups={GROUPS}
+      footer={
+        <Stack direction="column" gap="0.5rem">
+          <AvatarName
+            name={user.displayName}
+            title={user.displayName}
+            description={user.email}
+          />
+          <Stack direction="row" gap="0.35rem">
+            <Tooltip content={theme === "dark" ? "Light" : "Dark"}>
+              <Button
+                variant="ghost"
+                width="s"
+                size="s"
+                label={theme === "dark" ? "☀" : "☾"}
+                onClick={() => setThemeState(toggleTheme())}
+              />
+            </Tooltip>
+            <Tooltip content="Settings">
+              <Button
+                variant="ghost"
+                width="s"
+                size="s"
+                before={<Icon d={Ico.settings} size={16} />}
+                label="Settings"
+                onClick={() => Router.setRouter("module", "Settings")}
+              />
+            </Tooltip>
+            <Tooltip content="Log out">
+              <Button
+                variant="ghost"
+                width="s"
+                size="s"
+                before={<Icon d={Ico.logout} size={16} />}
+                label="Log out"
+                onClick={onLogout}
+              />
+            </Tooltip>
+          </Stack>
+        </Stack>
+      }
+    />
+  );
+}

package/templates/orbit/src/lazyRoute.ts

@@ -0,0 +1,4 @@
+export {
+  createLazyResolver,
+  type LazyRouteChunk,
+} from "@elcrm/components";

package/templates/orbit/src/lib/icon.tsx

@@ -0,0 +1,48 @@
+import React from "react";
+
+/** Линейная иконка 20×20, цвет — currentColor. */
+export function Icon({
+  d,
+  size = 18,
+}: {
+  d: string;
+  size?: number;
+}) {
+  return (
+    <svg
+      width={size}
+      height={size}
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth="1.6"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      aria-hidden
+    >
+      <path d={d} />
+    </svg>
+  );
+}
+
+export const Ico = {
+  home: "M3 10.5 12 3l9 7.5V21a1 1 0 0 1-1 1h-5v-7H9v7H4a1 1 0 0 1-1-1z",
+  catalog: "M4 6h16M4 12h16M4 18h10",
+  finances: "M12 3v18M17 8H9.5a3.5 3.5 0 0 0 0 7h5a3.5 3.5 0 0 1 0 7H7",
+  customers: "M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2M9 11a4 4 0 1 0 0-8 4 4 0 0 0 0 8M22 21v-2a4 4 0 0 0-3-3.87M16 3.13a4 4 0 0 1 0 7.75",
+  marketing: "M4 12v8a1 1 0 0 0 1 1h3v-9zM8 9l11-6v18L8 15",
+  analytics: "M4 19V5M4 19h16M8 17v-6M12 17V8M16 17v-4",
+  grid: "M4 4h7v7H4zM13 4h7v7h-7zM4 13h7v7H4zM13 13h7v7h-7z",
+  store: "M3 9 5 3h14l2 6M5 9v11h14V9M9 22V12h6v10",
+  link: "M10 13a5 5 0 0 0 7.07 0l1.41-1.41a5 5 0 0 0-7.07-7.07L10 5.93M14 11a5 5 0 0 0-7.07 0L5.52 12.4a5 5 0 1 0 7.07 7.07L14 18.07",
+  search: "M11 19a8 8 0 1 0 0-16 8 8 0 0 0 0 16zM21 21l-4.3-4.3",
+  globe: "M12 22a10 10 0 1 0 0-20 10 10 0 0 0 0 20zM2 12h20M12 2a15 15 0 0 1 0 20M12 2a15 15 0 0 0 0 20",
+  settings: "M12 15a3 3 0 1 0 0-6 3 3 0 0 0 0 6zM19.4 15a1.7 1.7 0 0 0 .3 1.8l.1.1a2 2 0 1 1-2.8 2.8l-.1-.1a1.7 1.7 0 0 0-1.8-.3 1.7 1.7 0 0 0-1 1.5V21a2 2 0 1 1-4 0v-.1a1.7 1.7 0 0 0-1-1.5 1.7 1.7 0 0 0-1.8.3l-.1.1a2 2 0 1 1-2.8-2.8l.1-.1a1.7 1.7 0 0 0 .3-1.8 1.7 1.7 0 0 0-1.5-1H3a2 2 0 1 1 0-4h.1a1.7 1.7 0 0 0 1.5-1 1.7 1.7 0 0 0-.3-1.8l-.1-.1a2 2 0 1 1 2.8-2.8l.1.1a1.7 1.7 0 0 0 1.8.3H9a1.7 1.7 0 0 0 1-1.5V3a2 2 0 1 1 4 0v.1a1.7 1.7 0 0 0 1 1.5 1.7 1.7 0 0 0 1.8-.3l.1-.1a2 2 0 1 1 2.8 2.8l-.1.1a1.7 1.7 0 0 0-.3 1.8V9c.3.6.9 1 1.5 1H21a2 2 0 1 1 0 4h-.1a1.7 1.7 0 0 0-1.5 1z",
+  logout: "M9 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h4M16 17l5-5-5-5M21 12H9",
+  plus: "M12 5v14M5 12h14",
+  box: "M21 8 12 3 3 8l9 5 9-5zM3 8v8l9 5M21 8v8l-9 5M12 13v8",
+  truck: "M3 7h11v10H3zM14 11h4l3 3v3h-7M5 21a2 2 0 1 0 0-4 2 2 0 0 0 0 4zM17 21a2 2 0 1 0 0-4 2 2 0 0 0 0 4z",
+  bell: "M6 8a6 6 0 1 1 12 0c0 7 3 9 3 9H3s3-2 3-9M10 21a2 2 0 0 0 4 0",
+  chat: "M21 15a4 4 0 0 1-4 4H8l-5 3V7a4 4 0 0 1 4-4h10a4 4 0 0 1 4 4z",
+  crown: "M3 8 7.5 13 12 5l4.5 8L21 8v10H3z",
+};

package/templates/orbit/src/lib/theme.ts

@@ -0,0 +1,39 @@
+/**
+ * Тема Orbit: `data-theme` на html/body + localStorage `elcrm-orbit-theme`.
+ */
+export type ThemeMode = "dark" | "light";
+
+const STORAGE_KEY = "elcrm-orbit-theme";
+
+export function getTheme(): ThemeMode {
+  try {
+    const v = localStorage.getItem(STORAGE_KEY);
+    if (v === "light" || v === "dark") return v;
+  } catch {
+    /* ignore */
+  }
+  return "light";
+}
+
+export function applyTheme(theme: ThemeMode = getTheme()): void {
+  const root = document.documentElement;
+  const body = document.body;
+  root.setAttribute("data-theme", theme);
+  if (body) body.setAttribute("data-theme", theme);
+  root.style.colorScheme = theme;
+}
+
+export function setTheme(theme: ThemeMode): void {
+  try {
+    localStorage.setItem(STORAGE_KEY, theme);
+  } catch {
+    /* ignore */
+  }
+  applyTheme(theme);
+}
+
+export function toggleTheme(): ThemeMode {
+  const next: ThemeMode = getTheme() === "dark" ? "light" : "dark";
+  setTheme(next);
+  return next;
+}