@central-design-system/components 3.10.6 → 3.11.0

package/dist/components/CdsTextInput/CdsTextInput.d.ts

@@ -107,6 +107,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: import('vue').PropType<boolean>;
         default: boolean;
     };
+    hint: {
+        type: import('vue').PropType<string>;
+        default: undefined;
+    };
+    persistentHint: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
     active: {
         type: import('vue').PropType<boolean>;
         default: boolean;
@@ -147,7 +155,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         default: undefined;
     };
     counter: {
-        type: import('vue').PropType<boolean>;
+        type: import('vue').PropType<boolean | number | string>;
         default: boolean;
     };
     limit: {
@@ -279,6 +287,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             type: import('vue').PropType<boolean>;
             default: boolean;
         };
+        hint: {
+            type: import('vue').PropType<string>;
+            default: undefined;
+        };
+        persistentHint: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
     }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         'update:modelValue': (value: any) => true;
         'click:control': (event: MouseEvent) => true;
@@ -381,6 +397,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             type: import('vue').PropType<boolean>;
             default: boolean;
         };
+        hint: {
+            type: import('vue').PropType<string>;
+            default: undefined;
+        };
+        persistentHint: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
     }>> & Readonly<{
         "onUpdate:modelValue"?: ((value: any) => any) | undefined;
         "onClick:control"?: ((event: MouseEvent) => any) | undefined;
@@ -400,6 +424,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         label: string;
         messages: string | string[];
         persistentMessages: boolean;
+        hint: string;
+        persistentHint: boolean;
         errorMessages: string | string[];
         maxErrors: string | number;
         rules: import('../../composable').TValidationRule[];
@@ -506,6 +532,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             type: import('vue').PropType<boolean>;
             default: boolean;
         };
+        hint: {
+            type: import('vue').PropType<string>;
+            default: undefined;
+        };
+        persistentHint: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
     }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         'update:modelValue': (value: any) => true;
         'click:control': (event: MouseEvent) => true;
@@ -608,6 +642,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             type: import('vue').PropType<boolean>;
             default: boolean;
         };
+        hint: {
+            type: import('vue').PropType<string>;
+            default: undefined;
+        };
+        persistentHint: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
     }>> & Readonly<{
         "onUpdate:modelValue"?: ((value: any) => any) | undefined;
         "onClick:control"?: ((event: MouseEvent) => any) | undefined;
@@ -627,6 +669,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         label: string;
         messages: string | string[];
         persistentMessages: boolean;
+        hint: string;
+        persistentHint: boolean;
         errorMessages: string | string[];
         maxErrors: string | number;
         rules: import('../../composable').TValidationRule[];
@@ -650,6 +694,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         readonly focused?: boolean | undefined;
         readonly messages?: string | string[] | undefined;
         readonly persistentMessages?: boolean | undefined;
+        readonly persistentHint?: boolean | undefined;
         readonly errorMessages?: string | string[] | undefined;
         readonly maxErrors?: string | number | undefined;
         readonly rules?: (import('../../composable').TValidationResult | ((value: any) => import('../../composable').TValidationResult) | ((value: any) => PromiseLike<import('../../composable').TValidationResult>) | {
@@ -660,7 +705,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         readonly hideMessages?: boolean | undefined;
         readonly autofocus?: boolean | undefined;
         readonly type?: "number" | "text" | "password" | "email" | "tel" | "url" | undefined;
-        readonly counter?: boolean | undefined;
+        readonly counter?: string | number | boolean | undefined;
         readonly clearable?: boolean | undefined;
         readonly clearLabel?: string | undefined;
         readonly persistentClearable?: boolean | undefined;
@@ -672,6 +717,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         readonly description?: string | undefined;
         readonly id?: string | undefined;
         readonly label?: string | undefined;
+        readonly hint?: string | undefined;
         readonly validationValue?: any;
         readonly prefix?: string | undefined;
         readonly suffix?: string | undefined;
@@ -796,6 +842,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             type: import('vue').PropType<boolean>;
             default: boolean;
         };
+        hint: {
+            type: import('vue').PropType<string>;
+            default: undefined;
+        };
+        persistentHint: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
         active: {
             type: import('vue').PropType<boolean>;
             default: boolean;
@@ -836,7 +890,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             default: undefined;
         };
         counter: {
-            type: import('vue').PropType<boolean>;
+            type: import('vue').PropType<boolean | number | string>;
             default: boolean;
         };
         limit: {
@@ -884,6 +938,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         readonly focused?: boolean | undefined;
         readonly messages?: string | string[] | undefined;
         readonly persistentMessages?: boolean | undefined;
+        readonly persistentHint?: boolean | undefined;
         readonly errorMessages?: string | string[] | undefined;
         readonly maxErrors?: string | number | undefined;
         readonly rules?: (import('../../composable').TValidationResult | ((value: any) => import('../../composable').TValidationResult) | ((value: any) => PromiseLike<import('../../composable').TValidationResult>) | {
@@ -894,7 +949,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         readonly hideMessages?: boolean | undefined;
         readonly autofocus?: boolean | undefined;
         readonly type?: "number" | "text" | "password" | "email" | "tel" | "url" | undefined;
-        readonly counter?: boolean | undefined;
+        readonly counter?: string | number | boolean | undefined;
         readonly clearable?: boolean | undefined;
         readonly clearLabel?: string | undefined;
         readonly persistentClearable?: boolean | undefined;
@@ -906,6 +961,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         readonly description?: string | undefined;
         readonly id?: string | undefined;
         readonly label?: string | undefined;
+        readonly hint?: string | undefined;
         readonly validationValue?: any;
         readonly prefix?: string | undefined;
         readonly suffix?: string | undefined;
@@ -932,6 +988,9 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     hasLoading: import('vue').ComputedRef<boolean>;
     hasClear: import('vue').ComputedRef<boolean>;
     counterValue: import('vue').ComputedRef<any>;
+    maxLength: import('vue').ComputedRef<string | number | undefined>;
+    counterMax: import('vue').ComputedRef<string | number | undefined>;
+    hasCounter: import('vue').ComputedRef<boolean>;
     iconClasses: import('vue').ComputedRef<Record<string, boolean>>;
     themeClasses: Readonly<import('vue').ComputedRef<string | undefined>>;
     sizeClasses: import('vue').ComputedRef<string>;
@@ -1106,6 +1165,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: import('vue').PropType<boolean>;
         default: boolean;
     };
+    hint: {
+        type: import('vue').PropType<string>;
+        default: undefined;
+    };
+    persistentHint: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
     active: {
         type: import('vue').PropType<boolean>;
         default: boolean;
@@ -1146,7 +1213,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         default: undefined;
     };
     counter: {
-        type: import('vue').PropType<boolean>;
+        type: import('vue').PropType<boolean | number | string>;
         default: boolean;
     };
     limit: {
@@ -1202,6 +1269,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     label: string;
     messages: string | string[];
     persistentMessages: boolean;
+    hint: string;
+    persistentHint: boolean;
     errorMessages: string | string[];
     maxErrors: string | number;
     rules: import('../../composable').TValidationRule[];
@@ -1217,7 +1286,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     type: "number" | "text" | "password" | "email" | "tel" | "url";
     role: string;
     placeholder: string;
-    counter: boolean;
+    counter: string | number | boolean;
     limit: number;
     clearable: boolean;
     clearLabel: string;
@@ -1324,6 +1393,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             type: import('vue').PropType<boolean>;
             default: boolean;
         };
+        hint: {
+            type: import('vue').PropType<string>;
+            default: undefined;
+        };
+        persistentHint: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
     }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         'update:modelValue': (value: any) => true;
         'click:control': (event: MouseEvent) => true;
@@ -1426,6 +1503,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             type: import('vue').PropType<boolean>;
             default: boolean;
         };
+        hint: {
+            type: import('vue').PropType<string>;
+            default: undefined;
+        };
+        persistentHint: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
     }>> & Readonly<{
         "onUpdate:modelValue"?: ((value: any) => any) | undefined;
         "onClick:control"?: ((event: MouseEvent) => any) | undefined;
@@ -1445,6 +1530,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         label: string;
         messages: string | string[];
         persistentMessages: boolean;
+        hint: string;
+        persistentHint: boolean;
         errorMessages: string | string[];
         maxErrors: string | number;
         rules: import('../../composable').TValidationRule[];

package/dist/components/CdsToggle/CdsToggle.d.ts

@@ -79,6 +79,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: import('vue').PropType<boolean>;
         default: boolean;
     };
+    hint: {
+        type: import('vue').PropType<string>;
+        default: undefined;
+    };
+    persistentHint: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     /**
      * Событие при фокусе
@@ -170,6 +178,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: import('vue').PropType<boolean>;
         default: boolean;
     };
+    hint: {
+        type: import('vue').PropType<string>;
+        default: undefined;
+    };
+    persistentHint: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
 }>> & Readonly<{
     "onUpdate:modelValue"?: ((value: any) => any) | undefined;
     "onUpdate:focused"?: ((value: boolean) => any) | undefined;
@@ -185,6 +201,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     label: string;
     messages: string | string[];
     persistentMessages: boolean;
+    hint: string;
+    persistentHint: boolean;
     errorMessages: string | string[];
     maxErrors: string | number;
     rules: import('../../composable').TValidationRule[];

package/dist/components/CdsTooltip/CdsTooltip.d.ts

@@ -212,6 +212,16 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: PropType<boolean>;
         default: boolean;
     };
+    /**
+     * Интерактивный контент подсказки: по нему можно вести курсор, кликать
+     * ссылки и выделять текст. Доступно с 3.11.0 и ничего не меняет — такое
+     * поведение включено всегда; проп принимается, чтобы его можно было
+     * проставить заранее.
+     */
+    interactive: {
+        type: PropType<boolean>;
+        default: boolean;
+    };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     /**
      * Событие при изменении значения (v-model)
@@ -429,6 +439,16 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: PropType<boolean>;
         default: boolean;
     };
+    /**
+     * Интерактивный контент подсказки: по нему можно вести курсор, кликать
+     * ссылки и выделять текст. Доступно с 3.11.0 и ничего не меняет — такое
+     * поведение включено всегда; проп принимается, чтобы его можно было
+     * проставить заранее.
+     */
+    interactive: {
+        type: PropType<boolean>;
+        default: boolean;
+    };
 }>> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
@@ -474,5 +494,6 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     })>;
     scrollStrategy: NonNullable<"close" | "none" | "block" | "reposition" | ((data: import('../CdsOverlay/composable').IScrollStrategyData, props: import('../CdsOverlay/composable').IScrollStrategyProps, scope: import('vue').EffectScope) => void)>;
     hideArrow: boolean;
+    interactive: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/components/CdsUploader/CdsUploader.d.ts

@@ -100,6 +100,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: import('vue').PropType<boolean>;
         default: boolean;
     };
+    hint: {
+        type: import('vue').PropType<string>;
+        default: undefined;
+    };
+    persistentHint: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
     capture: {
         type: import('vue').PropType<boolean | "user" | "environment">;
         default: undefined;
@@ -362,6 +370,14 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: import('vue').PropType<boolean>;
         default: boolean;
     };
+    hint: {
+        type: import('vue').PropType<string>;
+        default: undefined;
+    };
+    persistentHint: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
     capture: {
         type: import('vue').PropType<boolean | "user" | "environment">;
         default: undefined;
@@ -504,6 +520,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     label: string;
     messages: string | string[];
     persistentMessages: boolean;
+    hint: string;
+    persistentHint: boolean;
     errorMessages: string | string[];
     maxErrors: string | number;
     rules: import('../../composable').TValidationRule[];

package/dist/components/index.d.ts

@@ -41,10 +41,12 @@ export { default as CdsHeader } from './CdsHeader/CdsHeader';
 export { default as CdsIcon } from './CdsIcon/CdsIcon';
 export { default as CdsImage } from './CdsImage/CdsImage';
 export { default as CdsInput } from './CdsInput/CdsInput';
+export { default as CdsDescription } from './CdsInput/CdsDescription';
 export { default as CdsInputCounter } from './CdsInput/CdsInputCounter';
 export { default as CdsInputDescription } from './CdsInput/CdsInputDescription';
 export { default as CdsInputLabel } from './CdsInput/CdsInputLabel';
 export { default as CdsInputMessages } from './CdsInput/CdsInputMessages';
+export { default as CdsLabel } from './CdsInput/CdsLabel';
 export { default as CdsLayout } from './CdsLayout/CdsLayout';
 export { default as CdsLink } from './CdsLink/CdsLink';
 export { default as CdsList } from './CdsList/CdsList';
@@ -60,8 +62,10 @@ export { default as CdsOverlay } from './CdsOverlay/CdsOverlay';
 export { default as CdsPage } from './CdsPage/CdsPage';
 export { default as CdsPagination } from './CdsPagination/CdsPagination';
 export { default as CdsProgress } from './CdsProgress/CdsProgress';
+export { default as CdsProgressBar } from './CdsProgress/CdsProgressBar';
 export { default as CdsRadio } from './CdsRadioButton/CdsRadio';
 export { default as CdsRadioButton } from './CdsRadioButton/CdsRadioButton';
+export { default as CdsRadioGroup } from './CdsRadioButton/CdsRadioGroup';
 export { default as CdsSelect } from './CdsSelect/CdsSelect';
 export { default as CdsSidebar } from './CdsSidebar/CdsSidebar';
 export { default as CdsSkeletonLoader } from './CdsSkeletonLoader/CdsSkeletonLoader';

package/dist/composable/field.d.ts

@@ -12,7 +12,7 @@ export interface IFieldProps {
     type: TFieldTypes;
     role: string | undefined;
     placeholder: string | undefined;
-    counter: boolean;
+    counter: boolean | number | string;
     disabled: boolean;
     limit: number | undefined;
     clearable: boolean;
@@ -115,14 +115,16 @@ export declare const makeFieldProps: <Defaults extends {
         default: undefined;
     };
     /**
-     * Счетчик введенных символов
+     * Счетчик введенных символов. Число или строка задаёт максимум счётчика —
+     * так это работает в CDS 4 вместо `limit`.
      */
     counter: {
-        type: PropType<boolean>;
+        type: PropType<boolean | number | string>;
         default: boolean;
     };
     /**
      * Ограничение ввода по количеству символов
+     * @deprecated Ограничение ввода — нативный `maxlength`, счётчик — `counter`
      */
     limit: {
         type: PropType<number>;

package/dist/composable/input.d.ts

@@ -18,6 +18,8 @@ export interface IInputProps {
     value: any;
     messages: string[] | string;
     persistentMessages: boolean;
+    hint?: string;
+    persistentHint?: boolean;
 }
 export interface IUseInput {
     id: ComputedRef<string>;
@@ -31,6 +33,8 @@ export declare const makeInputProps: <Defaults extends {
     value?: unknown;
     messages?: unknown;
     persistentMessages?: unknown;
+    hint?: unknown;
+    persistentHint?: unknown;
 } = {}>(defaults?: Defaults | undefined) => import('../utils').AppendDefault<{
     /**
      * Идентификатор
@@ -69,11 +73,27 @@ export declare const makeInputProps: <Defaults extends {
     };
     /**
      * Всегда показывать сообщения и подсказки
+     * @deprecated В CDS 4 `messages` видны всегда — проп можно просто убрать
      */
     persistentMessages: {
         type: PropType<boolean>;
         default: boolean;
     };
+    /**
+     * Подсказка под полем. Доступно с 3.11.0 — синоним `messages`.
+     */
+    hint: {
+        type: PropType<string>;
+        default: undefined;
+    };
+    /**
+     * Всегда показывать подсказку, а не только в фокусе. Доступно с 3.11.0 —
+     * синоним `persistentMessages`.
+     */
+    persistentHint: {
+        type: PropType<boolean>;
+        default: boolean;
+    };
 }, Defaults>;
 export declare function useInput(props: IInputProps, slots: Record<string, unknown>, name?: string): IUseInput;
 export declare function useFilteredInputProps<T extends Record<string, unknown>>(props: T, exclude: string[]): {

package/dist/composable/status.d.ts

@@ -1,6 +1,7 @@
 import { MaybeRef } from '../utils';
 import { ComputedRef, PropType } from 'vue';
-export type TStatus = typeof allowedStatus[number];
+export type TStatusName = typeof allowedStatus[number];
+export type TStatus = TStatusName | keyof typeof statusAliases;
 export interface IStatusProps {
     status: TStatus;
 }
@@ -8,11 +9,22 @@ export interface IUseStatus {
     statusClasses: ComputedRef<string>;
 }
 export declare const allowedStatus: readonly ["info", "success", "warning", "error", "progress"];
+/**
+ * Имена статусов из CDS 4: набор выровнен с токенами `--cds-color-status-*`,
+ * поэтому `error` там называется `danger`. Принимаем оба имени, чтобы на
+ * `danger` можно было перейти до апгрейда.
+ */
+export declare const statusAliases: {
+    readonly danger: "error";
+};
+export declare const availableStatus: readonly ["info", "success", "warning", "error", "progress", ...string[]];
+/** Приводит имя статуса из CDS 4 к внутреннему имени CDS 3. */
+export declare function resolveStatus(status: TStatus): TStatusName;
 export declare const makeStatusProps: <Defaults extends {
     status?: unknown;
 } = {}>(defaults?: Defaults | undefined) => import('../utils').AppendDefault<{
     /**
-     * Статус состояния
+     * Статус состояния. Значение `danger` доступно с 3.11.0 — синоним `error`.
      */
     status: {
         type: PropType<TStatus>;

package/dist/utils/compat.d.ts

@@ -0,0 +1,33 @@
+import { ComponentObjectPropsOptions } from 'vue';
+/**
+ * Копия компонента под именем из CDS 4. Обе регистрации рендерят одно и то же,
+ * но различаются `name` — по нему `deprecateAlias` понимает, под каким именем
+ * компонент отрисован, и молчит на новом.
+ */
+export declare function createAlias<T>(component: T, name: string): T;
+/**
+ * Передан ли проп явно. `props.x !== undefined` для этого не годится: у пропса
+ * может быть дефолт, поэтому смотрим сырые пропсы vnode (camelCase и kebab-case).
+ */
+export declare function hasProvidedProp(name: string): boolean;
+/**
+ * Используется ли проп на самом деле: передан явно и его значение отличается от
+ * дефолта. Именно это условие нужно предупреждениям — проп, переданный со
+ * значением по умолчанию (`:persistent-messages="false"`, `v-bind="args"`
+ * в Storybook, разворот объекта пропсов), ни на что не влияет, и требовать
+ * его замены не за что.
+ */
+export declare function usesProp(name: string): boolean;
+/**
+ * Фильтр пропсов для проброса во вложенный компонент: пропускает только то, что
+ * разработчик задал сам, плюс пропсы, у которых обёртка переопределила дефолт
+ * (например `role: 'combobox'` у `CdsAutocomplete`).
+ *
+ * Прокидывать весь набор нельзя: вложенный компонент увидит дефолты обёртки как
+ * явно переданные пропсы — и `hasProvidedProp` выдаст `[CDS UPGRADE]` на код,
+ * в котором устаревшего пропса нет.
+ *
+ * Вызывать только в `setup`: инстанс запоминается, а `vnode` читается на каждой
+ * проверке, поэтому фильтр остаётся верным и после ре-рендера.
+ */
+export declare function createProvidedPropsFilter(target: ComponentObjectPropsOptions): (name: string) => boolean;

package/dist/utils/dom/warn.d.ts

@@ -1,2 +1,44 @@
+/** Сбрасывает историю выведенных предупреждений (нужен тестам). */
+export declare function resetDeprecationWarnings(): void;
 export declare function warn(component: string, msg: string): void;
+/**
+ * Устаревшая сущность без контекста компонента.
+ * Оставлена ради совместимости — для новых мест берите узкие хелперы ниже.
+ */
 export declare function deprecate(original: string, replacement: string | string[]): void;
+/** Компонент переименован или удалён: `deprecateComponent('CdsSidebar', 'CdsDrawer')`. */
+export declare function deprecateComponent(original: string, replacement: string | string[] | null, hint?: string): void;
+/**
+ * Компонент переименован в v4, но занять новое имя в CDS 3 нельзя — там оно
+ * принадлежит другому компоненту. Значит правка возможна только в момент
+ * апгрейда: «Use 'CdsTab' instead» здесь звучало бы как совет перейти на
+ * старый CDS 3 `CdsTab`, то есть ровно наоборот.
+ */
+export declare function renameOnUpgrade(component: string, next: string, hint?: string): void;
+/**
+ * Компонент доступен и под именем CDS 4 (алиас), поэтому предупреждаем только
+ * тогда, когда он отрисован под старым именем.
+ *
+ * Алиас создаётся копией опций со своим `name` (см. `createAlias`), так что
+ * различить их можно только по имени текущего инстанса.
+ */
+export declare function deprecateAlias(original: string, replacement: string): void;
+/** Пропс переименован или удалён: `deprecateProp('CdsBadge', 'count', 'content')`. */
+export declare function deprecateProp(component: string, prop: string, replacement: string | string[] | null, hint?: string): void;
+/** Переименовано значение пропса: `status="error"` → `status="danger"`. */
+export declare function deprecatePropValue(component: string, prop: string, value: string, replacement: string): void;
+/**
+ * У пропса меняется значение по умолчанию: код продолжит работать, но поведение
+ * станет другим, поэтому просим указать значение явно.
+ */
+export declare function deprecatePropDefault(component: string, prop: string, current: string, next: string): void;
+/**
+ * Проп остаётся, но начинает работать иначе. Это не deprecation: заменять
+ * ничего не нужно, а вот знать о смене поведения — нужно, иначе после апгрейда
+ * поле молча начнёт выглядеть по-другому.
+ */
+export declare function changePropBehaviour(component: string, prop: string, change: string, hint?: string): void;
+/** Событие переименовано: `remove` → `click:close`. */
+export declare function deprecateEvent(component: string, event: string, replacement: string | null, hint?: string): void;
+/** Слот переименован или удалён. */
+export declare function deprecateSlot(component: string, slot: string, replacement: string | string[] | null, hint?: string): void;

package/dist/utils/index.d.ts

@@ -1,6 +1,7 @@
 export * from './helpers';
 export * from './propsFactory';
 export * from './getCurrentInstance';
+export * from './compat';
 export * from './use/reactivePick';
 export * from './use/eagerComputed';
 export * from './use/pickAttrs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@central-design-system/components",
-  "version": "3.10.6",
+  "version": "3.11.0",
   "description": "Central Design System on the Vue 3.0 and TypeScript",
   "author": {
     "name": "magersoft",
@@ -25,6 +25,7 @@
       }
     },
     "./nuxt": "./nuxt.js",
+    "./styles": "./dist/cds.css",
     "./dist/cds.css": "./dist/cds.css",
     "./src/": {
       "import": "./src/",
@@ -36,7 +37,8 @@
     "src/scss/**/*.css",
     "src/scss/**/*.scss",
     "src/themes",
-    "nuxt.js"
+    "nuxt.js",
+    "UPGRADE.md"
   ],
   "engines": {
     "node": ">= 18"