@central-design-system/components 3.10.7 → 3.12.0

package/dist/components/index.d.ts

@@ -41,15 +41,18 @@ 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';
 export { default as CdsListGroup } from './CdsList/CdsListGroup';
 export { default as CdsListItem } from './CdsList/CdsListItem';
+export { default as CdsListSubheader } from './CdsList/CdsListSubheader';
 export { default as CdsLoader } from './CdsLoader/CdsLoader';
 export { default as CdsMain } from './CdsMain/CdsMain';
 export { default as CdsMenu } from './CdsMenu/CdsMenu';
@@ -60,8 +63,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/filter.d.ts

@@ -1,4 +1,4 @@
-import { IInternalItem } from './items';
+import { IInternalItem, TItemType } from './items';
 import { MaybeRef } from '../utils';
 import { PropType, Ref } from 'vue';
 export type TFilterMath = boolean | number | [number, number] | [number, number][];
@@ -74,6 +74,7 @@ export declare function filterItems(items: readonly (readonly [item: IInternalIt
 type TFilteredItems = {
     index: number;
     matches: Record<string, TFilterMath>;
+    type?: TItemType;
 };
 type TFilterFunction = (value: string, query: string, item?: any) => TFilterMath;
 type TFilterKeyFunctions = Record<string, TFilterFunction>;

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/items.d.ts

@@ -1,6 +1,8 @@
 import { PropType, ComputedRef } from 'vue';
 export type TItemKey = boolean | string | (string | number)[] | ((item: Record<string, any>, fallback?: any) => any);
+export type TItemType = 'item' | 'divider' | 'subheader';
 export interface IInternalItem<T = any> {
+    type?: TItemType;
     title: string;
     value: any;
     props: {
@@ -17,6 +19,7 @@ export interface IItemsProps {
     itemValue: TItemKey;
     itemChildren: TItemKey;
     itemProps: TItemKey;
+    itemType?: TItemKey;
     returnObject: boolean;
 }
 export interface IUseItems {
@@ -37,6 +40,7 @@ export declare const makeItemsProps: <Defaults extends {
     itemValue?: unknown;
     itemChildren?: unknown;
     itemProps?: unknown;
+    itemType?: unknown;
     returnObject?: unknown;
 } = {}>(defaults?: Defaults | undefined) => import('../utils').AppendDefault<{
     /**
@@ -74,6 +78,14 @@ export declare const makeItemsProps: <Defaults extends {
         type: PropType<TItemKey>;
         default: string;
     };
+    /**
+     * Ключ, определяющий тип элемента: item, divider или subheader.
+     * Элементы с типом divider и subheader оформляют список и не участвуют в выборе
+     */
+    itemType: {
+        type: PropType<TItemKey>;
+        default: string;
+    };
     /**
      * Возвращать объект вместо массива
      */
@@ -84,4 +96,6 @@ export declare const makeItemsProps: <Defaults extends {
 }, Defaults>;
 export declare function useItems(props: IItemsProps): IUseItems;
 export declare function transformItem(props: Omit<IItemsProps, 'items'>, item: any): IInternalItem;
+export declare function isPseudoItem(item: Pick<IInternalItem, 'type'>): boolean;
+export declare function isSelectableItem(item: Pick<IInternalItem, 'type'>): boolean;
 export declare function transformItems(props: Omit<IItemsProps, 'items'>, items: IItemsProps['items']): IInternalItem[];

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/overlayFocus.d.ts

@@ -8,3 +8,11 @@
  * фокус терять не нужно, оверлей должен остаться открытым.
  */
 export declare function wasLastPointerDownInsideOverlay(): boolean;
+/**
+ * Был ли blur вызван настоящим кликом мышью.
+ *
+ * Браузер снимает фокус как действие по умолчанию у mousedown, то есть в той же
+ * задаче цикла событий. Скроллбар в WebKit уводит фокус без mousedown — значит,
+ * если mousedown в текущей задаче не было, blur «ложный» и фокус можно вернуть.
+ */
+export declare function wasBlurCausedByPointerDown(): 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.7",
+  "version": "3.12.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"