elcrm 1.1.21 → 1.1.22

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.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);