elcrm 1.1.21 → 1.1.23

package/dist/index.js

@@ -3899,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);
@@ -3976,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)
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elcrm",
-  "version": "1.1.21",
+  "version": "1.1.23",
   "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,
@@ -31,13 +31,15 @@ import type { PricingPlan, HealthmapData } from "@elcrm/components";
 - **PageHead** — title + actions. `sup` — текст или Badge сразу после title (надстрочно; `0` скрыт). `sticky` — шапка прилипает к верху скролла (фон `--shell-bg`). `children` — фильтры/поиск под заголовком, отступ `--shell-gap`.
 - **Section** — блок контента / auth.
 - **Layout / Header** — оболочка приложения. `Layout sidebar={<Sidebar />}` — ряд: меню слева + контент. `fixed={["header", "footer", "sidebar"]}` (по умолчанию) — эти слоты не скроллятся, крутится только `children`. `fixed={[]}` — поток страницы. Высота каркаса: `--layout-height` (`100dvh`).
-- **Sidebar** — левое меню. `variant="cards"` (карточки) или `"plain"` (плоский backoffice). `groups` + `value`. Слоты: `brand`, `extra`, `footer`. Меню аккаунта: `footerItems` (как у Dropdown) + `onFooterSelect` — клик по `footer` открывает панель, справа ⋮. Пункты: `--sidebar-item-font-size`, `--sidebar-item-padding`, `--sidebar-icon-size`, `--sidebar-group-font-size`. Не наследуют `body` 18px (`Item` `font: inherit` перебит).
+- **Sidebar** — левое меню. `variant="cards"` (карточки) или `"plain"` (плоский backoffice). `groups` + `value`. Подменю: у пункта `items` + `defaultOpen` (открыто/скрыто при старте). Контроль: `open` / `onOpenChange` (массив `value` родителей). Клик по родителю только раскрывает; `onSelect` — у листьев. Если выбран потомок — ветка открывается. Слоты: `brand`, `extra`, `footer`. Меню аккаунта: `footerItems` + `onFooterSelect`. Отступ вложенных: `--sidebar-indent`.
+- **NavSections** — сайдбар страницы + lazy-панель. Подменю как у Sidebar: `items` + `defaultOpen`, `open` / `onOpenChange`. Панель грузится по `value` листа (`resolveSection`). Клик по родителю только раскрывает.
 - **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` в приложении.
 - **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 +47,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 +67,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/elcrm-docs/MODAL.elCRM.md

@@ -10,7 +10,8 @@
 function EditModal({ id, onClose }: { id: number; onClose?: () => void }) {
   return (
     <Modal.Main title="Редактирование" onClose={onClose} size="m">
-      <Modal.Scroll>…</Modal.Scroll>
+      {/* scroll + padding по умолчанию — без Modal.Scroll */}
+      <p>…</p>
     </Modal.Main>
   );
 }
@@ -25,12 +26,30 @@ Open({ id: 123 });
 
 | API | Зачем |
 | --- | --- |
-| `Modal.Main` | окно + оверлей: `title`, `size`, `button`, `tabs`, `menu`, `shake`, `escape` |
-| `Modal.Panel` | без оверлея |
-| `Modal.Scroll` / `Center` / `Form` / `Column` / `List` | раскладка |
+| `Modal.Main` | окно + оверлей: `title`, `size`, `button`, `tabs`, `menu`, `shake`, `escape`, **`scroll`**, **`padding`** |
+| `Modal.Panel` | без оверлея (те же props) |
+| `Modal.Scroll` | редко: сырой layout или `padding={false}` внутри |
+| `Center` / `Form` / `Column` / `List` | раскладка |
 | `Modal.Close(name?)` | одно или все |
 | `Modal.Shake` | тряска |
 
+### Отступы (по умолчанию уже есть)
+
+Один токен **`--modal-padding`** (default `30px`) — шапка, тело, футер, Form, List.
+
+| Как | Пример |
+| --- | --- |
+| Тема на всё приложение | `--modal-padding: 24px` в `theme-*.css` |
+| Одно окно | `<Modal.Main padding="20px">` |
+| Без отступов тела | `padding={false}` |
+| Выключить авто-Scroll | `scroll={false}` |
+
+`Modal.Main` / `Panel` сами оборачивают children в `Modal.Scroll` с отступами.
+
+- Обычный контент — **не** пишите `Modal.Scroll`.
+- Единственный `Modal.List` или `Modal.Form` — без внешнего Scroll (свои отступы через тот же токен).
+- Если единственный ребёнок уже `Modal.Scroll` — второй раз не оборачиваем.
+
 `size`: `a` auto · `s` 400 · `m` 500 · `l` 800 · `x` 1000 · `f` full · `p` page (весь экран поверх страницы).  
 `escape` закрывает верхнее; клик по оверлею при `shake` (default true) трясёт, не закрывает; крестик закрывает всегда. Для `size="p"` обычно `shake={false}`.
 
@@ -58,3 +77,4 @@ Card.Open({ id: 1 }, { origin: event.currentTarget });
 - `key={Date.now()}` на модалке.
 - Без `Modal.Init`.
 - Нативные input внутри модалки — `@elcrm/form`.
+- Ручные `padding: 0` / пустой layout «в край» без нужды — дефолт уже с отступами.

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);
@@ -142,6 +143,7 @@
   --sidebar-item-padding: 6px 10px;
   --sidebar-icon-size: 16px;
   --sidebar-group-font-size: 11px;
+  --sidebar-indent: 14px;
   --pricing-card-min-width: 16rem;
   --pricing-table-label-width: 10rem;
   --chat-list-width: 340px;

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);
@@ -153,6 +154,7 @@
   --sidebar-item-padding: 6px 10px;
   --sidebar-icon-size: 16px;
   --sidebar-group-font-size: 11px;
+  --sidebar-indent: 14px;
   --pricing-card-min-width: 16rem;
   --pricing-table-label-width: 10rem;
   --chat-list-width: 340px;