@central-design-system/components 4.0.0-alpha.0 → 4.0.0-alpha.2

package/llms/llms-guides.txt

@@ -1,6 +1,6 @@
 # Central Design System (CDS 4) — гайды
 
-> Версия: 4.0.0-alpha.0
+> Версия: 4.0.0-alpha.2
 > Подключение, конвенции, формы, тематизация, Tailwind CSS, tree-shaking и адаптив.
 > Сгенерировано автоматически (`bun run generate:meta` → `bun run generate:llms`). Не редактировать вручную.
 
@@ -796,7 +796,8 @@ import '@central-design-system/components/styles/common.css';
 
 ## Директивы
 
-Директивы (`ClickOutside`, `Intersect`, `Touch`) регистрируются так же точечно:
+Директивы (`ClickOutside`, `Intersect`, `Touch`) экспортируются именованно и
+регистрируются так же точечно:
 
 ```ts
 import { createCds, ClickOutside } from '@central-design-system/components';
@@ -807,6 +808,18 @@ const cds = createCds({
 });
 ```
 
+Компонентам библиотеки регистрировать директивы не нужно — те, что используют
+`ClickOutside`, `Intersect` и `Touch` внутри (`CdsOverlay` и построенные на нём
+`CdsSelect`, `CdsMenu`, `CdsTooltip`, `CdsSlideView`, поля ввода), тянут их
+собственным импортом и регистрируют локально. Передавайте `directives` в
+`createCds` только ради своей разметки — `v-click-outside`, `v-intersect`,
+`v-touch` в шаблонах приложения.
+
+> **В `4.0.0-alpha.0`:** локальная регистрация внутри
+> компонентов не срабатывала, и меню `CdsSelect` / `CdsMenu` не закрывалось по
+> клику вне, если в `createCds` не передали `directives`. Если обновиться нельзя —
+> добавьте в регистрацию `directives: { ClickOutside, Touch }`.
+
 ## Сколько это даёт
 
 Замеры на Vite 5 (production, minify, стили в отдельном файле, Vue включён в бандл,
@@ -860,6 +873,21 @@ import * as cdsComponents from '@central-design-system/components';
 import { CdsButton } from '@central-design-system/components';
 ```
 
+**Импорт наборов иконок через `iconsets`.** Объект `iconsets` ссылается сразу на все
+наборы, поэтому не тришейкается: в бандл попадёт JS всех паков (включая `cds` — 46 KB)
+и, поскольку UnoCSS сканирует их сам, CSS всех пяти наборов (≈370 KB вместо ≈70 KB).
+Импортируйте набор подпутём:
+
+```ts
+// ❌ тянет все наборы
+import { iconsets } from '@central-design-system/components';
+const aliases = iconsets.remix.aliases;
+
+// ✅ только remix
+import { remix } from '@central-design-system/components/iconsets/remix';
+const aliases = remix.aliases;
+```
+
 **Подключение агрегата стилей.** `@central-design-system/components/styles` содержит CSS
 всех компонентов — используйте `styles/common.css`.
 
@@ -883,7 +911,7 @@ by design. Убедитесь, что сборщик резолвит `import`-
 По умолчанию CDS использует набор `cds` — он включает все иконки, необходимые компонентам дизайн-системы.
 
 ```ts
-import { createCds, iconsets } from '@central-design-system/components';
+import { createCds } from '@central-design-system/components';
 
 const cds = createCds({
   icons: {
@@ -914,13 +942,15 @@ app.use(cds);
 В качестве набора по умолчанию (`defaultSet`) нужно выбрать один из них; при необходимости alias mappings можно переопределить.
 Дополнительные наборы — уже без алиасов — можно подключить параллельно и свободно использовать в своих шаблонах.
 
-| Библиотека иконок                                                | Iconify package        | CDS iconset name          | Aliases name                | Set name   |
-|------------------------------------------------------------------|------------------------|---------------------------|-----------------------------|------------|
-| [Remix Icon](https://remixicon.com/)                             | `@iconify-json/ri`     | `iconsets.remix.icons`    | `iconsets.remix.aliases`    | `ri`       |
-| [Phosphor Icons](https://phosphoricons.com/)                     | `@iconify-json/ph`     | `iconsets.phosphor.icons` | `iconsets.phosphor.aliases` | `phosphor` |
-| [Lucide](https://lucide.dev/)                                    | `@iconify-json/lucide` | `iconsets.lucide.icons`   | `iconsets.lucide.aliases`   | `lucide`   |
-| [Carbon](https://carbondesignsystem.com/elements/icons/library/) | `@iconify-json/carbon` | `iconsets.carbon.icons`   | `iconsets.carbon.aliases`   | `carbon`   |
-| [Material Design Icons](https://pictogrammers.com/library/mdi/)  | `@iconify-json/mdi`    | `iconsets.mdi.icons`      | `iconsets.mdi.aliases`      | `mdi`      |
+| Библиотека иконок                                                | Iconify package        | Импорт iconset'а                                          | Set name   |
+|------------------------------------------------------------------|------------------------|-----------------------------------------------------------|------------|
+| [Remix Icon](https://remixicon.com/)                             | `@iconify-json/ri`     | `@central-design-system/components/iconsets/remix`        | `ri`       |
+| [Phosphor Icons](https://phosphoricons.com/)                     | `@iconify-json/ph`     | `@central-design-system/components/iconsets/phosphor`     | `phosphor` |
+| [Lucide](https://lucide.dev/)                                    | `@iconify-json/lucide` | `@central-design-system/components/iconsets/lucide`       | `lucide`   |
+| [Carbon](https://carbondesignsystem.com/elements/icons/library/) | `@iconify-json/carbon` | `@central-design-system/components/iconsets/carbon`       | `carbon`   |
+| [Material Design Icons](https://pictogrammers.com/library/mdi/)  | `@iconify-json/mdi`    | `@central-design-system/components/iconsets/mdi`          | `mdi`      |
+
+Каждый модуль экспортирует объект с именем набора: `icons` (сам набор для `sets`) и `aliases` (псевдонимы для `aliases`).
 
 Установите нужный набор из таблицы выше:
 
@@ -970,18 +1000,23 @@ export default defineConfig({
 })
 ```
 
+> Больше ничего в `unocss.config.ts` дописывать не нужно: iconset'ы CDS помечены маркером `@unocss-include`,
+> поэтому UnoCSS сканирует их сам — несмотря на то, что они лежат в `node_modules` и это `.js`-файлы,
+> которые по умолчанию не попадают в `content.pipeline.include`.
+
 4. Передайте набор иконок в функцию `createCds()`.
 В примере используется набор **[Remix](https://remixicon.com/)**, но его можно заменить любым другим из таблицы выше:
 
 ```ts
-import { createCds, iconsets } from '@central-design-system/components';
+import { createCds } from '@central-design-system/components';
+import { remix } from '@central-design-system/components/iconsets/remix';
 
 const cds = createCds({
   icons: {
     defaultSet: 'remix',
-    aliases: iconsets.remix.aliases,
+    aliases: remix.aliases,
     sets: {
-      remix: iconsets.remix.icons,
+      remix: remix.icons,
     }
   },
 });
@@ -989,6 +1024,10 @@ const cds = createCds({
 app.use(cds);
 ```
 
+> Импортируйте набор подпутём `@central-design-system/components/iconsets/<набор>`, а не из общего
+> объекта `iconsets`. Общий объект ссылается сразу на все наборы и не тришейкается — в бандл попадут
+> лишний JS и CSS всех пяти наборов (≈370 КБ против ≈70 КБ у одного).
+
 После этого можно выбрать любую иконку из набора — например, [ri:settings-3-line](https://icon-sets.iconify.design/ri/?icon-filter=settings-3-line) — и использовать её в шаблонах:
 
 ```html

package/llms/llms-migration.txt

@@ -1,6 +1,6 @@
 # Central Design System — миграция CDS 3 → CDS 4
 
-> Версия: 4.0.0-alpha.0
+> Версия: 4.0.0-alpha.2
 > Полный гайд перехода: breaking-изменения, переименования, deprecations и шаги миграции.
 > Сгенерировано автоматически (`bun run generate:meta` → `bun run generate:llms`). Не редактировать вручную.
 
@@ -12,7 +12,7 @@
 Этот документ — **живой** migration guide: записи добавляются по мере появления
 breaking-изменений в alpha/beta релизах CDS 4.
 
-> Версии: CDS 3 — `3.10.1` (стабильная), CDS 4 — `4.0.0-alpha.0` (в разработке).
+> Версии: CDS 3 — `3.10.1` (стабильная), CDS 4 — `4.0.0-alpha.2` (в разработке).
 
 ## Как читать этот документ
 

package/llms/llms-tokens.txt

@@ -1,6 +1,6 @@
 # Central Design System (CDS 4) — токены и темы
 
-> Версия: 4.0.0-alpha.0
+> Версия: 4.0.0-alpha.2
 > Три уровня токенов: палитра-примитивы, цветовые токены тем (`--cds-color-*`) и локальные переменные компонентов.
 > Сгенерировано автоматически (`bun run generate:meta` → `bun run generate:llms`). Не редактировать вручную.
 

package/llms/llms.txt

@@ -1,6 +1,6 @@
 # Central Design System (CDS 4)
 
-> Версия: 4.0.0-alpha.0. Модульная библиотека Vue 3 UI-компонентов `@central-design-system/components`.
+> Версия: 4.0.0-alpha.2. Модульная библиотека Vue 3 UI-компонентов `@central-design-system/components`.
 > Этот файл — индекс для AI-агентов, собирающих продуктовый UI на CDS.
 > Сгенерировано автоматически (`bun run generate:meta` → `bun run generate:llms`). Не редактировать вручную.
 

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@central-design-system/components",
-  "version": "4.0.0-alpha.0",
+  "version": "4.0.0-alpha.2",
   "author": "magersoft",
   "description": "Luma Design System - Vue 3 UI Framework",
   "homepage": "https://cds.b2b-center.ru/",
   "repository": {
     "type": "git",
-    "url": "git+https://gitlab.b2b-center.ru/cds/central-design-system.git"
+    "url": "https://gitlab.b2b-center.ru/cds/central-design-system.git"
   },
   "type": "module",
   "main": "dist/cjs/entry.js",
@@ -29,6 +29,13 @@
         "default": "./dist/styles/index.css"
       }
     },
+    "./iconsets/*": {
+      "import": {
+        "types": "./dist/types/assets/icons/*.d.ts",
+        "node": "./dist/esm-node/src/assets/icons/*.mjs",
+        "default": "./dist/es/src/assets/icons/*.js"
+      }
+    },
     "./dist/*": "./dist/*",
     "./styles": {
       "sass": "./src/styles/common.scss",
@@ -59,6 +66,9 @@
     "*": {
       "web-components": [
         "dist/types/main.d.ts"
+      ],
+      "iconsets/*": [
+        "dist/types/assets/icons/*"
       ]
     }
   },