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

package/dist/types/components/CdsVirtualScroll/index.d.ts

@@ -1,6 +1,6 @@
 export declare const CdsVirtualScroll: {
     new (...args: any[]): import("vue").CreateComponentPublicInstanceWithMixins<Readonly<import("vue").ExtractPropTypes<{
-        class: import("vue").PropType<import("@cds/core").ClassValue>;
+        class: import("vue").PropType<import("../../core").ClassValue>;
         style: {
             type: import("vue").PropType<import("vue").StyleValue>;
             default: null;
@@ -65,7 +65,7 @@ export declare const CdsVirtualScroll: {
         M: {};
         Defaults: {};
     }, Readonly<import("vue").ExtractPropTypes<{
-        class: import("vue").PropType<import("@cds/core").ClassValue>;
+        class: import("vue").PropType<import("../../core").ClassValue>;
         style: {
             type: import("vue").PropType<import("vue").StyleValue>;
             default: null;
@@ -127,7 +127,7 @@ export declare const CdsVirtualScroll: {
     __isTeleport?: never;
     __isSuspense?: never;
 } & import("vue").ComponentOptionsBase<Readonly<import("vue").ExtractPropTypes<{
-    class: import("vue").PropType<import("@cds/core").ClassValue>;
+    class: import("vue").PropType<import("../../core").ClassValue>;
     style: {
         type: import("vue").PropType<import("vue").StyleValue>;
         default: null;
@@ -187,11 +187,11 @@ export declare const CdsVirtualScroll: {
 }, {}, string, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & (new () => {
     $slots: import("./index.ts").CdsVirtualScrollSlots<any, any>;
 }) & {
-    constants: import("@cds/core").ComponentConstants<"CdsVirtualScroll">;
+    constants: import("../../core").ComponentConstants<"CdsVirtualScroll">;
 };
 export declare const CdsVirtualScrollItem: {
     new (...args: any[]): import("vue").CreateComponentPublicInstanceWithMixins<Readonly<import("vue").ExtractPropTypes<{
-        class: import("vue").PropType<import("@cds/core").ClassValue>;
+        class: import("vue").PropType<import("../../core").ClassValue>;
         style: {
             type: import("vue").PropType<import("vue").StyleValue>;
             default: null;
@@ -212,7 +212,7 @@ export declare const CdsVirtualScrollItem: {
         M: {};
         Defaults: {};
     }, Readonly<import("vue").ExtractPropTypes<{
-        class: import("vue").PropType<import("@cds/core").ClassValue>;
+        class: import("vue").PropType<import("../../core").ClassValue>;
         style: {
             type: import("vue").PropType<import("vue").StyleValue>;
             default: null;
@@ -228,7 +228,7 @@ export declare const CdsVirtualScrollItem: {
     __isTeleport?: never;
     __isSuspense?: never;
 } & import("vue").ComponentOptionsBase<Readonly<import("vue").ExtractPropTypes<{
-    class: import("vue").PropType<import("@cds/core").ClassValue>;
+    class: import("vue").PropType<import("../../core").ClassValue>;
     style: {
         type: import("vue").PropType<import("vue").StyleValue>;
         default: null;
@@ -244,6 +244,6 @@ export declare const CdsVirtualScrollItem: {
 }, {}, string, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & (new () => {
     $slots: import("./index.ts").CdsVirtualScrollItemSlots;
 }) & {
-    constants: import("@cds/core").ComponentConstants<"CdsVirtualScrollItem">;
+    constants: import("../../core").ComponentConstants<"CdsVirtualScrollItem">;
 };
 export * from './api/CdsVirtualScroll.types';

package/dist/types/composables/useDatetime/useDatetime.d.ts

@@ -1,4 +1,4 @@
-import type { IRawDate, TDateLocale } from '@cds/utils';
+import type { IRawDate, TDateLocale } from '../../utils';
 import type { ComputedRef, PropType } from 'vue';
 export type TDatetimeValueRange = {
     from: string | IRawDate;

package/dist/types/composables/useFocus/useFocusGroup.d.ts

@@ -1,4 +1,4 @@
-import { CdsList } from '@cds/components';
+import { CdsList } from '../../components';
 import { type MaybeRefOrGetter, type Ref } from 'vue';
 type FocusGroup = {
     type: 'list';

package/dist/types/composables/useForm/internal/useForm.types.d.ts

@@ -1,4 +1,4 @@
-import type { ValidationProps } from '@cds/composables/useValidation';
+import type { ValidationProps } from '../../useValidation';
 import type { ComponentInternalInstance, Raw, Ref } from 'vue';
 export interface FormProvide {
     register: (item: {

package/dist/types/composables/useForm/useForm.d.ts

@@ -1,4 +1,4 @@
-import type { ValidationProps } from '@cds/composables/useValidation';
+import type { ValidationProps } from '../useValidation';
 import { type ExtractPublicPropTypes, type PropType } from 'vue';
 import type { FieldValidationResult, FormField } from './internal/useForm.types';
 export declare const defineFormProps: <Defaults extends {
@@ -49,8 +49,8 @@ export declare const defineFormProps: <Defaults extends {
         type: PropType<ValidationProps["validateOn"]>;
         default: string;
     }, "type" | "default"> & {
-        type: PropType<unknown extends Defaults["validateOn"] ? import("@cds/composables/useValidation").ValidateOn | undefined : import("@cds/composables/useValidation").ValidateOn | Defaults["validateOn"] | undefined>;
-        default: unknown extends Defaults["validateOn"] ? import("@cds/composables/useValidation").ValidateOn | undefined : Defaults["validateOn"] | NonNullable<import("@cds/composables/useValidation").ValidateOn | undefined>;
+        type: PropType<unknown extends Defaults["validateOn"] ? import("../useValidation").ValidateOn | undefined : import("../useValidation").ValidateOn | Defaults["validateOn"] | undefined>;
+        default: unknown extends Defaults["validateOn"] ? import("../useValidation").ValidateOn | undefined : Defaults["validateOn"] | NonNullable<import("../useValidation").ValidateOn | undefined>;
     };
 };
 export interface FormProps extends ExtractPublicPropTypes<ReturnType<typeof defineFormProps>> {
@@ -114,5 +114,5 @@ export declare function useForm(props?: {
     items?: import("vue").Ref<FormField[], FormField[]> | undefined;
     isValidating?: import("vue").Ref<boolean, boolean> | undefined;
     isValid?: import("vue").Ref<boolean | null | undefined, boolean | null | undefined> | undefined;
-    validateOn?: import("vue").Ref<import("@cds/composables/useValidation").ValidateOn | undefined, import("@cds/composables/useValidation").ValidateOn | undefined> | undefined;
+    validateOn?: import("vue").Ref<import("../useValidation").ValidateOn | undefined, import("../useValidation").ValidateOn | undefined> | undefined;
 };

package/dist/types/composables/useGoTo/internal/useGoTo.types.d.ts

@@ -1,4 +1,4 @@
-import type { EasingFunction } from '@cds/composables/useTransition';
+import type { EasingFunction } from '../../useTransition';
 import type { ComponentPublicInstance, Ref } from 'vue';
 export interface GoToInstance {
     rtl: Ref<boolean>;

package/dist/types/composables/useGoTo/useGoTo.d.ts

@@ -1,4 +1,4 @@
-import { type LocaleInstance, type RtlInstance } from '@cds/composables/useLocale';
+import { type LocaleInstance, type RtlInstance } from '../useLocale';
 import { type ComponentPublicInstance } from 'vue';
 import type { GoToInstance, GoToOptions } from './internal/useGoTo.types';
 /**

package/dist/types/composables/useGroup/useGroup.d.ts

@@ -1,4 +1,4 @@
-import { type EventProp } from '@cds/utils';
+import { type EventProp } from '../../utils';
 import { type ComponentInternalInstance, type ExtractPublicPropTypes, type InjectionKey, type PropType, type Ref } from 'vue';
 import type { GroupItem } from './useGroupItem';
 export interface GroupProvide {

package/dist/types/composables/useGroup/useGroupItem.d.ts

@@ -1,4 +1,4 @@
-import type { EventProp } from '@cds/utils';
+import type { EventProp } from '../../utils';
 import { type ExtractPublicPropTypes, type InjectionKey, type Ref } from 'vue';
 import type { GroupProvide } from './useGroup';
 export interface GroupItem {

package/dist/types/composables/useIcons/internal/useIcons.constants.d.ts

@@ -1,4 +1,4 @@
-import type { JSXComponent } from '@cds/core';
+import type { JSXComponent } from '../../../core';
 import type { InjectionKey, PropType } from 'vue';
 import type { InternalIconOptions } from './useIcons.types';
 export type IconValue = string | (string | [path: string, opacity: number])[] | JSXComponent;

package/dist/types/composables/useIcons/internal/useIcons.types.d.ts

@@ -1,4 +1,4 @@
-import type { JSXComponent } from '@cds/core';
+import type { JSXComponent } from '../../../core';
 import { IconValue } from './useIcons.constants';
 export interface IconProps {
     tag: string | JSXComponent;
@@ -154,9 +154,9 @@ export type InternalIconOptions = {
      */
     legacyIcons?: Record<string, any>;
 };
-export type IconOptions = (Partial<Omit<InternalIconOptions, 'sets'>> & {
+export type IconOptions = Partial<Omit<InternalIconOptions, 'sets'>> & {
     sets?: Record<string, IconSet | Record<string, any>>;
-}) | Record<string, any>;
+};
 export type IconInstance = {
     component: IconComponent;
     icon?: IconValue;

package/dist/types/composables/useIcons/useIcons.component.d.ts

@@ -1,4 +1,4 @@
-import { type JSXComponent } from '@cds/core';
+import { type JSXComponent } from '../../core';
 import { type PropType } from 'vue';
 import { IconValue } from './internal/useIcons.constants';
 /**

package/dist/types/composables/useItems/internal/useItems.types.d.ts

@@ -1,4 +1,4 @@
-import type { InternalItem } from '@cds/composables/useFilter';
+import type { InternalItem } from '../../useFilter';
 export interface ListItem<T = any> extends InternalItem<T> {
     title: string;
     props: {

package/dist/types/composables/useItems/useItems.d.ts

@@ -1,4 +1,4 @@
-import { type SelectItemKey, type ValueComparator } from '@cds/utils';
+import { type SelectItemKey, type ValueComparator } from '../../utils';
 import { type ExtractPublicPropTypes, type PropType } from 'vue';
 import type { ListItem } from './internal/useItems.types';
 export declare const defineItemsProps: <Defaults extends {

package/dist/types/composables/useLoader/LoaderSlot.d.ts

@@ -1,5 +1,5 @@
-import type { Size } from '@cds/composables/useSize';
-import type { SlotsToProps } from '@cds/core';
+import type { Size } from '../useSize';
+import type { SlotsToProps } from '../../core';
 import type { ExtractPropTypes, SetupContext } from 'vue';
 import type { LoaderSlotProps } from './useLoader';
 export declare function LoaderSlot(props: {

package/dist/types/composables/useLocation/useLocation.d.ts

@@ -1,4 +1,4 @@
-import { type Anchor } from '@cds/utils';
+import { type Anchor } from '../../utils';
 import { type CSSProperties, type ExtractPublicPropTypes, type PropType } from 'vue';
 export declare const defineLocationProps: <Defaults extends {
     location?: unknown;

package/dist/types/composables/useNested/useNested.d.ts

@@ -1,4 +1,4 @@
-import type { ListItem } from '@cds/composables/useItems';
+import type { ListItem } from '../useItems';
 import { type ExtractPublicPropTypes, type MaybeRefOrGetter, type PropType, type Ref } from 'vue';
 import type { ActiveStrategyProp, ItemsRegistrationType, OpenStrategyProp, SelectStrategyProp } from './internal/useNested.types';
 export declare const defineNestedProps: <Defaults extends {

package/dist/types/composables/useResizeObserver/useResizeObserver.d.ts

@@ -1,4 +1,4 @@
-import { type TemplateRef } from '@cds/utils';
+import { type TemplateRef } from '../../utils';
 import { type DeepReadonly, type Ref } from 'vue';
 interface ResizeState {
     resizeRef: TemplateRef;

package/dist/types/composables/useRouter/useRouter.d.ts

@@ -1,4 +1,4 @@
-import { type EventProp } from '@cds/utils';
+import { type EventProp } from '../../utils';
 import { type ExtractPublicPropTypes, type PropType, type Ref, type SetupContext } from 'vue';
 import type { NavigationGuardReturn, RouteLocation, RouteLocationNormalizedLoaded, RouteLocationRaw, Router, useLink as _useLink } from 'vue-router';
 export interface LinkProps extends ExtractPublicPropTypes<ReturnType<typeof defineRouterProps>> {

package/dist/types/composables/useRules/useRules.d.ts

@@ -1,4 +1,4 @@
-import type { ValidationProps, ValidationRule } from '@cds/composables/useValidation';
+import type { ValidationProps, ValidationRule } from '../useValidation';
 import { type InjectionKey, type Ref } from 'vue';
 export type CustomValidationRuleBuilder = (...args: any[]) => ValidationRule;
 export interface RuleAliases {

package/dist/types/composables/useStatus/internal/useStatus.constants.d.ts

@@ -1,4 +1,4 @@
-import type { IconValue } from '@cds/composables/useIcons';
+import type { IconValue } from '../../useIcons';
 export declare const allowedStatuses: readonly ["info", "success", "warning", "danger", "progress"];
 export type CdsStatusValue = (typeof allowedStatuses)[number];
 export declare const statusIcons: Record<CdsStatusValue, IconValue>;

package/dist/types/composables/useStatus/useStatus.d.ts

@@ -1,4 +1,4 @@
-import type { IconValue } from '@cds/composables/useIcons';
+import type { IconValue } from '../useIcons';
 import { type ComputedRef, type PropType } from 'vue';
 import { type CdsStatusValue } from './internal/useStatus.constants';
 export declare const defineStatusProps: <Defaults extends {

package/dist/types/composables/useTheme/internal/useTheme.constants.d.ts

@@ -1,4 +1,4 @@
-import { type ThemeName } from '@cds/themes';
+import { type ThemeName } from '../../../themes';
 import type { InjectionKey } from 'vue';
 import type { ThemeInstance, ThemeOptions } from './useTheme.types';
 export declare const ThemeSymbol: InjectionKey<ThemeInstance>;

package/dist/types/composables/useTheme/internal/useTheme.types.d.ts

@@ -1,5 +1,5 @@
-import type { ThemeName } from '@cds/themes';
-import type { Color } from '@cds/utils';
+import type { ThemeName } from '../../../themes';
+import type { Color } from '../../../utils';
 import type { ComputedRef, DeepReadonly, Ref } from 'vue';
 import { availableTheme } from './useTheme.constants';
 type DeepPartial<T> = T extends object ? {

package/dist/types/composables/useTransition/useTransition.d.ts

@@ -1,4 +1,4 @@
-import { type TagProps } from '@cds/core';
+import { type TagProps } from '../../core';
 import { type Component, type FunctionalComponent, type HTMLAttributes, type MaybeRefOrGetter, type Prop, type TransitionProps } from 'vue';
 export declare const standardEasing = "cubic-bezier(0.4, 0, 0.2, 1)";
 export declare const deceleratedEasing = "cubic-bezier(0.0, 0, 0.2, 1)";

package/dist/types/composables/useValidation/useValidation.d.ts

@@ -1,4 +1,4 @@
-import { type EventProp } from '@cds/utils';
+import { type EventProp } from '../../utils';
 import { type ExtractPublicPropTypes, type MaybeRef, type PropType } from 'vue';
 import type { ValidateOn, ValidationRule } from './internal/useValidation.types';
 export declare const defineValidationProps: <Defaults extends {

package/dist/types/composables/useVirtual/useVirtual.d.ts

@@ -1,4 +1,4 @@
-import { type SelectItemKey } from '@cds/utils';
+import { type SelectItemKey } from '../../utils';
 import { type ExtractPublicPropTypes, type PropType, type Ref } from 'vue';
 export declare const defineVirtualProps: <Defaults extends {
     itemHeight?: unknown;

package/dist/types/core/getCurrentInstance.d.ts

@@ -10,6 +10,6 @@ export declare function getCurrentInstance(name: string, message?: string): impo
  * Retrieves the current instance's name in kebab-case format.
  *
  * @param {string} [name='composables'] - An optional string used to specify the instance context.
- * @return {string} The kebab-case formatted name of the current instance.
+ * @return {string} The kebab-case formatted name of the current instance, or an empty string.
  */
 export declare function getCurrentInstanceName(name?: string): string;

package/dist/types/entry.d.ts

@@ -141,8 +141,10 @@ declare module '@vue/runtime-core' {
     }
 }
 export { components, directives, themes, utils };
+export type { Blueprint, CdsInstance, CdsOptions } from './cds';
 export * from './assets';
 export * from './components';
 export * from './composables';
+export * from './directives';
 export * from './hooks';
 export * from './transitions';

package/dist/types/hooks/createObserver/index.d.ts

@@ -11,7 +11,7 @@
  * - `null` — permanently stopped (`stop()` was called; `setup()` is a no-op)
  * - instance — active observer
  */
-import { type MaybeElementRef } from '@cds/hooks';
+import { type MaybeElementRef } from '..';
 import { type Ref } from 'vue';
 export interface ObserverReturn {
     /**

package/dist/types/hooks/createPlugin/index.d.ts

@@ -13,7 +13,7 @@
  * Also exports `createPluginContext` — a higher-level factory that generates the standard
  * context/plugin/consumer triple for plugin composables, eliminating boilerplate.
  */
-import { type ContextTrinity } from '@cds/hooks';
+import { type ContextTrinity } from '..';
 import { type App } from 'vue';
 export interface PluginOptions {
     namespace: string;

package/dist/types/hooks/useBreakpoints/index.d.ts

@@ -65,4 +65,4 @@ export interface BreakpointsContextOptions extends BreakpointsOptions {
  * @param _options
  */
 export declare function createBreakpoints(_options?: BreakpointsOptions): BreakpointsContext;
-export declare const createBreakpointsContext: <_E extends BreakpointsContext = BreakpointsContext>(_options?: BreakpointsContextOptions | undefined) => import("@cds/hooks").ContextTrinity<_E>, createBreakpointsPlugin: (_options?: BreakpointsContextOptions | undefined) => import("@cds/hooks").Plugin, useBreakpoints: <_E extends BreakpointsContext = BreakpointsContext>(namespace?: string) => _E;
+export declare const createBreakpointsContext: <_E extends BreakpointsContext = BreakpointsContext>(_options?: BreakpointsContextOptions | undefined) => import("..").ContextTrinity<_E>, createBreakpointsPlugin: (_options?: BreakpointsContextOptions | undefined) => import("..").Plugin, useBreakpoints: <_E extends BreakpointsContext = BreakpointsContext>(namespace?: string) => _E;

package/dist/types/hooks/useEventListener/index.d.ts

@@ -13,7 +13,7 @@
  *
  * Perfect for safely managing event listeners in Vue components.
  */
-import type { MaybeArray } from '@cds/types';
+import type { MaybeArray } from '../../types';
 import { type MaybeRef, type MaybeRefOrGetter } from 'vue';
 export type CleanupFunction = () => void;
 export type EventHandler<E = Event> = (event: E) => void;

package/dist/types/hooks/useHydration/index.d.ts

@@ -53,4 +53,4 @@ export declare function createFallbackHydration<E extends HydrationContext = Hyd
  * })
  * ```
  */
-export declare const createHydrationContext: <_E extends HydrationContext = HydrationContext>(_options?: HydrationContextOptions | undefined) => import("@cds/hooks").ContextTrinity<_E>, createHydrationPlugin: (_options?: HydrationContextOptions | undefined) => import("@cds/hooks").Plugin, useHydration: <_E extends HydrationContext = HydrationContext>(namespace?: string) => _E;
+export declare const createHydrationContext: <_E extends HydrationContext = HydrationContext>(_options?: HydrationContextOptions | undefined) => import("..").ContextTrinity<_E>, createHydrationPlugin: (_options?: HydrationContextOptions | undefined) => import("..").Plugin, useHydration: <_E extends HydrationContext = HydrationContext>(namespace?: string) => _E;

package/dist/types/hooks/useIntersectionObserver/index.d.ts

@@ -14,7 +14,7 @@
  *
  * Perfect for lazy loading, infinite scroll, and visibility detection.
  */
-import { type MaybeElementRef, type ObserverReturn } from '@cds/hooks';
+import { type MaybeElementRef, type ObserverReturn } from '..';
 import { type Ref } from 'vue';
 export interface IntersectionObserverEntry {
     boundingClientRect: DOMRectReadOnly;

package/dist/types/hooks/useResizeObserver/index.d.ts

@@ -14,7 +14,7 @@
  *
  * Perfect for responsive components and size-based rendering.
  */
-import { type MaybeElementRef, type ObserverReturn } from '@cds/hooks';
+import { type MaybeElementRef, type ObserverReturn } from '..';
 import { type Ref } from 'vue';
 export interface ResizeObserverEntry {
     contentRect: {

package/dist/types/icons.d.ts

@@ -1,2 +1,2 @@
-import { type IconOptions, type InternalIconOptions } from '@cds/composables/useIcons';
+import { type IconOptions, type InternalIconOptions } from './composables/useIcons';
 export declare function createIcons(options?: IconOptions): InternalIconOptions;

package/dist/types/locales/adapters/cdsLocaleAdapter.d.ts

@@ -1,2 +1,2 @@
-import type { LocaleInstance, LocaleOptions } from '@cds/composables/useLocale';
+import type { LocaleInstance, LocaleOptions } from '../../composables/useLocale';
 export declare function createCdsLocaleAdapter(options?: LocaleOptions): LocaleInstance;

package/dist/types/locales/date/index.d.ts

@@ -1,4 +1,4 @@
-import type { TDateLocale } from '@cds/utils';
+import type { TDateLocale } from '../../utils';
 import enDate from './en';
 import ruDate from './ru';
 export declare const DEFAULT_DATE_LOCALE = "ru";

package/dist/types/themes/index.d.ts

@@ -1,4 +1,4 @@
-import type { ThemeDefinition } from '@cds/composables/useTheme';
+import type { ThemeDefinition } from '../composables/useTheme';
 export { default as b2bDark } from './b2bDark';
 export { default as b2bLight } from './b2bLight';
 export { default as cdsDark } from './cdsDark';

package/dist/types/types/index.d.ts

@@ -1,4 +1,4 @@
-export type { JSXComponent } from '@cds/core';
+export type { JSXComponent } from '../core';
 /**
  * Union type that accepts either a single value or an array
  *

package/llms/llms-components.txt

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

package/llms/llms-full.txt

@@ -1,6 +1,6 @@
 # Central Design System (CDS 4) — полная документация
 
-> Версия: 4.0.0-alpha.0
+> Версия: 4.0.0-alpha.2
 > Всё сразу: гайды, токены и темы, компоненты с примерами и контрактом API, миграция с CDS 3.
 > Сгенерировано автоматически (`bun run generate:meta` → `bun run generate:llms`). Не редактировать вручную.
 
@@ -827,7 +827,8 @@ import '@central-design-system/components/styles/common.css';
 
 ## Директивы
 
-Директивы (`ClickOutside`, `Intersect`, `Touch`) регистрируются так же точечно:
+Директивы (`ClickOutside`, `Intersect`, `Touch`) экспортируются именованно и
+регистрируются так же точечно:
 
 ```ts
 import { createCds, ClickOutside } from '@central-design-system/components';
@@ -838,6 +839,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 включён в бандл,
@@ -891,6 +904,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`.
 
@@ -914,7 +942,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: {
@@ -945,13 +973,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`).
 
 Установите нужный набор из таблицы выше:
 
@@ -1001,18 +1031,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,
     }
   },
 });
@@ -1020,6 +1055,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
@@ -41053,7 +41092,7 @@ function toggle(id: number) {
 Этот документ — **живой** 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` (в разработке).
 
 ## Как читать этот документ