@snabcentr/vue-ui-lib 3.63.0 → 3.65.0

package/dist/src/components/dates/date-range/date-range-dialog.vue.d.ts

@@ -0,0 +1,57 @@
+import { IClearable } from '../../../properties/interfaces/i-clearable';
+import { IDateRangeDisabled } from '../../../properties/interfaces/i-date-range-disabled';
+import { IDatePeriod, ILabeledPeriod } from '@snabcentr/common-lib';
+/**
+ * Диалог «Выберите период» с сеткой месяцев и стандартными периодами.
+ */
+declare const _default: import('vue').DefineComponent<IClearable & IDateRangeDisabled & {
+    /**
+     * Признак отображения диалога.
+     */
+    show: boolean;
+    /**
+     * Текущее значение периода — начальное состояние черновика.
+     */
+    dateRange?: IDatePeriod;
+    /**
+     * Дополнительные периоды для вида «стандартные периоды».
+     */
+    customPeriods?: Record<string, ILabeledPeriod>;
+    /**
+     * Формат даты.
+     */
+    dateFormat?: string;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    select: (value: IDatePeriod) => any;
+    "update:show": (show: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<IClearable & IDateRangeDisabled & {
+    /**
+     * Признак отображения диалога.
+     */
+    show: boolean;
+    /**
+     * Текущее значение периода — начальное состояние черновика.
+     */
+    dateRange?: IDatePeriod;
+    /**
+     * Дополнительные периоды для вида «стандартные периоды».
+     */
+    customPeriods?: Record<string, ILabeledPeriod>;
+    /**
+     * Формат даты.
+     */
+    dateFormat?: string;
+}> & Readonly<{
+    onSelect?: ((value: IDatePeriod) => any) | undefined;
+    "onUpdate:show"?: ((show: boolean) => any) | undefined;
+}>, {
+    disabled: {
+        from?: boolean;
+        to?: boolean;
+    };
+    clearable: boolean;
+    dateFormat: string;
+    customPeriods: Record<string, ILabeledPeriod>;
+    dateRange: IDatePeriod;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/src/components/dates/date-range/date-range-fields.vue.d.ts

@@ -0,0 +1,66 @@
+import { IClearable } from '../../../properties/interfaces/i-clearable';
+import { IDateRangeDisabled } from '../../../properties/interfaces/i-date-range-disabled';
+/**
+ * Пара полей «от»/«до» периода дат.
+ */
+declare const _default: import('vue').DefineComponent<IClearable & IDateRangeDisabled & {
+    /**
+     * Начало периода.
+     */
+    from?: Date | null;
+    /**
+     * Окончание периода.
+     */
+    to?: Date | null;
+    /**
+     * Подсказка в пустом поле От.
+     */
+    placeholderFrom?: string;
+    /**
+     * Подсказка в пустом поле До.
+     */
+    placeholderTo?: string;
+    /**
+     * Формат даты.
+     */
+    dateFormat?: string;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:from": (value: Date | null) => any;
+    "update:to": (value: Date | null) => any;
+}, string, import('vue').PublicProps, Readonly<IClearable & IDateRangeDisabled & {
+    /**
+     * Начало периода.
+     */
+    from?: Date | null;
+    /**
+     * Окончание периода.
+     */
+    to?: Date | null;
+    /**
+     * Подсказка в пустом поле От.
+     */
+    placeholderFrom?: string;
+    /**
+     * Подсказка в пустом поле До.
+     */
+    placeholderTo?: string;
+    /**
+     * Формат даты.
+     */
+    dateFormat?: string;
+}> & Readonly<{
+    "onUpdate:from"?: ((value: Date | null) => any) | undefined;
+    "onUpdate:to"?: ((value: Date | null) => any) | undefined;
+}>, {
+    disabled: {
+        from?: boolean;
+        to?: boolean;
+    };
+    clearable: boolean;
+    to: Date | null;
+    from: Date | null;
+    dateFormat: string;
+    placeholderFrom: string;
+    placeholderTo: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/dates/date-range/date-range-helper.d.ts

@@ -0,0 +1,24 @@
+import { IDatePeriod } from '@snabcentr/common-lib';
+/**
+ * Ключ хранилища для последнего выбранного вида диалога выбора периода.
+ */
+export declare const DATE_RANGE_DIALOG_MODE_STORAGE_KEY = "date-range.dialog.mode";
+/**
+ * Краткие названия месяцев для сеток выбора: заданы явно и не зависят от локали календаря.
+ */
+export declare const MONTH_LABELS: string[];
+/**
+ * Нормализует границы периода: «от» приводится к началу дня, «до» — к концу дня, границы могут быть
+ * не заданы по отдельности (полуоткрытый период). Инвертированные границы переставляются местами;
+ * если одна из сторон заблокирована, вместо перестановки свободная граница подтягивается к заблокированной.
+ *
+ * @param from Начало периода.
+ * @param to Окончание периода.
+ * @param locked Признаки блокировки сторон.
+ * @param locked.from Признак блокировки стороны От.
+ * @param locked.to Признак блокировки стороны До.
+ */
+export declare const normalizePeriod: (from?: Date | null, to?: Date | null, locked?: {
+    from?: boolean;
+    to?: boolean;
+}) => IDatePeriod;

package/dist/src/components/dates/date-range/date-range-input.vue.d.ts

@@ -0,0 +1,38 @@
+import { IClearable } from '../../../properties/interfaces/i-clearable';
+import { IDisabled } from '../../../properties/interfaces/i-disabled';
+import { IPlaceholder } from '../../../properties/interfaces/i-placeholder';
+/**
+ * Поле одиночной даты: слева в панели год и месяцы, справа календарь дней.
+ */
+declare const _default: import('vue').DefineComponent<IClearable & IDisabled & IPlaceholder & {
+    /**
+     * Значение даты.
+     */
+    value?: Date | null;
+    /**
+     * Формат даты.
+     */
+    dateFormat?: string;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:value": (value: Date | null, ...additionalParams: any[]) => any;
+}, string, import('vue').PublicProps, Readonly<IClearable & IDisabled & IPlaceholder & {
+    /**
+     * Значение даты.
+     */
+    value?: Date | null;
+    /**
+     * Формат даты.
+     */
+    dateFormat?: string;
+}> & Readonly<{
+    "onUpdate:value"?: ((value: Date | null, ...additionalParams: any[]) => any) | undefined;
+}>, {
+    value: Date | null;
+    disabled: boolean;
+    placeholder: string;
+    clearable: boolean;
+    dateFormat: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    pickerReference: unknown;
+}, any>;
+export default _default;

package/dist/src/components/dates/date-range/month-range-grid.vue.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Сетка месяцев на три года с выбором диапазона двумя кликами, протяжкой или клавиатурой.
+ */
+declare const _default: import('vue').DefineComponent<{
+    /**
+     * Начало выбранного периода.
+     */
+    from?: Date | null;
+    /**
+     * Окончание выбранного периода.
+     */
+    to?: Date | null;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    select: (value: {
+        from: Date;
+        to: Date;
+    }) => any;
+}, string, import('vue').PublicProps, Readonly<{
+    /**
+     * Начало выбранного периода.
+     */
+    from?: Date | null;
+    /**
+     * Окончание выбранного периода.
+     */
+    to?: Date | null;
+}> & Readonly<{
+    onSelect?: ((value: {
+        from: Date;
+        to: Date;
+    }) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/dates/date-range/month-year-sidebar.vue.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Сайдбар панели выбора даты: степпер года, сетка месяцев и кнопка «Сегодня».
+ */
+declare const _default: import('vue').DefineComponent<{
+    /**
+     * Отображаемый год.
+     */
+    year: number;
+    /**
+     * Индекс подсвечиваемого месяца (0–11) либо null, если месяц не подсвечивается.
+     */
+    month?: number | null;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:year": (year: number) => any;
+    "select-month": (month: number) => any;
+    today: () => any;
+}, string, import('vue').PublicProps, Readonly<{
+    /**
+     * Отображаемый год.
+     */
+    year: number;
+    /**
+     * Индекс подсвечиваемого месяца (0–11) либо null, если месяц не подсвечивается.
+     */
+    month?: number | null;
+}> & Readonly<{
+    "onUpdate:year"?: ((year: number) => any) | undefined;
+    "onSelect-month"?: ((month: number) => any) | undefined;
+    onToday?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/dates/date-range/standard-periods.vue.d.ts

@@ -0,0 +1,31 @@
+import { ILabeledPeriod } from '@snabcentr/common-lib';
+import { SelectOption } from 'naive-ui';
+/**
+ * Вид «стандартные периоды»: список вариантов выбранной группы и кнопки групп.
+ */
+declare const _default: import('vue').DefineComponent<{
+    /**
+     * Ключ активного (последнего применённого) варианта периода.
+     */
+    activeKey?: string | null;
+    /**
+     * Дополнительные периоды, отображаются отдельной группой в конце списка групп.
+     */
+    customPeriods?: Record<string, ILabeledPeriod>;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    apply: (option: SelectOption) => any;
+    preview: (option?: SelectOption | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<{
+    /**
+     * Ключ активного (последнего применённого) варианта периода.
+     */
+    activeKey?: string | null;
+    /**
+     * Дополнительные периоды, отображаются отдельной группой в конце списка групп.
+     */
+    customPeriods?: Record<string, ILabeledPeriod>;
+}> & Readonly<{
+    onApply?: ((option: SelectOption) => any) | undefined;
+    onPreview?: ((option?: SelectOption | undefined) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/dates/date-range.vue.d.ts

@@ -1,102 +1,69 @@
 import { IClearable } from '../../properties/interfaces/i-clearable';
-import { IDatePeriod } from '@snabcentr/common-lib';
+import { IDateRangeDisabled } from '../../properties/interfaces/i-date-range-disabled';
+import { IPredefinedDateRanges } from '../../properties/interfaces/i-predefined-date-ranges';
+import { IDatePeriod, ILabeledPeriod } from '@snabcentr/common-lib';
 /**
- * Компонент выбора не строгого периода дат.
+ * Компонент выбора периода дат: два отдельных поля даты и кнопка «…» с диалогом выбора периода.
  */
-declare const _default: import('vue').DefineComponent<IClearable & {
+declare const _default: import('vue').DefineComponent<IClearable & IDateRangeDisabled & IPredefinedDateRanges & {
     /**
      * Период времени.
      */
     dateRange?: IDatePeriod;
     /**
-     * Формат даты.
+     * Признак необходимости показать в диалоге группу предустановленных диапазонов дат по умолчанию
+     * (год, полугодия, кварталы, периоды нарастающим итогом) в дополнение к стандартным периодам.
      */
-    dateFormat?: string;
+    useDefaultPredefinedDateRanges?: boolean;
     /**
-     * Признак блокировки поля.
+     * Подсказка в пустом поле От.
      */
-    disabled?: {
-        /**
-         * Признак блокировки поля От.
-         */
-        from?: boolean;
-        /**
-         * Признак блокировки поля До.
-         */
-        to?: boolean;
-    };
+    placeholderFrom?: string;
     /**
-     * Список предустановленных диапазонов дат, которые можно выбрать.
+     * Подсказка в пустом поле До.
      */
-    predefinedDateRanges?: Record<string, IDatePeriod & {
-        /**
-         * Текстовое описание.
-         */
-        label: string;
-    }>;
+    placeholderTo?: string;
     /**
-     * Признак необходимости использовать предустановленные диапазоны дат.
+     * Формат даты.
      */
-    useDefaultPredefinedDateRanges?: boolean;
+    dateFormat?: string;
 }, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     "update:date-range": (value?: IDatePeriod | undefined) => any;
-}, string, import('vue').PublicProps, Readonly<IClearable & {
+}, string, import('vue').PublicProps, Readonly<IClearable & IDateRangeDisabled & IPredefinedDateRanges & {
     /**
      * Период времени.
      */
     dateRange?: IDatePeriod;
     /**
-     * Формат даты.
+     * Признак необходимости показать в диалоге группу предустановленных диапазонов дат по умолчанию
+     * (год, полугодия, кварталы, периоды нарастающим итогом) в дополнение к стандартным периодам.
      */
-    dateFormat?: string;
+    useDefaultPredefinedDateRanges?: boolean;
     /**
-     * Признак блокировки поля.
+     * Подсказка в пустом поле От.
      */
-    disabled?: {
-        /**
-         * Признак блокировки поля От.
-         */
-        from?: boolean;
-        /**
-         * Признак блокировки поля До.
-         */
-        to?: boolean;
-    };
+    placeholderFrom?: string;
     /**
-     * Список предустановленных диапазонов дат, которые можно выбрать.
+     * Подсказка в пустом поле До.
      */
-    predefinedDateRanges?: Record<string, IDatePeriod & {
-        /**
-         * Текстовое описание.
-         */
-        label: string;
-    }>;
+    placeholderTo?: string;
     /**
-     * Признак необходимости использовать предустановленные диапазоны дат.
+     * Формат даты.
      */
-    useDefaultPredefinedDateRanges?: boolean;
+    dateFormat?: string;
 }> & Readonly<{
     "onUpdate:date-range"?: ((value?: IDatePeriod | undefined) => any) | undefined;
 }>, {
     disabled: {
-        /**
-         * Признак блокировки поля От.
-         */
         from?: boolean;
-        /**
-         * Признак блокировки поля До.
-         */
         to?: boolean;
     };
     clearable: boolean;
-    dateRange: IDatePeriod;
     dateFormat: string;
-    predefinedDateRanges: Record<string, IDatePeriod & {
-        /**
-         * Текстовое описание.
-         */
-        label: string;
-    }>;
+    placeholderFrom: string;
+    placeholderTo: string;
+    dateRange: IDatePeriod;
+    predefinedDateRanges: Record<string, ILabeledPeriod>;
     useDefaultPredefinedDateRanges: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 export default _default;

package/dist/src/properties/interfaces/i-date-range-disabled.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Признак блокировки сторон периода дат.
+ */
+export interface IDateRangeDisabled {
+    /**
+     * Признак блокировки сторон периода дат.
+     */
+    disabled?: {
+        /**
+         * Признак блокировки поля От.
+         */
+        from?: boolean;
+        /**
+         * Признак блокировки поля До.
+         */
+        to?: boolean;
+    };
+}

package/dist/src/properties/interfaces/i-predefined-date-ranges.d.ts

@@ -0,0 +1,10 @@
+import { ILabeledPeriod } from '@snabcentr/common-lib';
+/**
+ * Предустановленные диапазоны дат, доступные для выбора.
+ */
+export interface IPredefinedDateRanges {
+    /**
+     * Список предустановленных диапазонов дат, которые можно выбрать.
+     */
+    predefinedDateRanges?: Record<string, ILabeledPeriod>;
+}

package/dist/src/properties/interfaces/index.d.ts

@@ -1,5 +1,6 @@
 export * from './i-clearable';
 export * from './i-client-short-info-property';
+export * from './i-date-range-disabled';
 export * from './i-consistent-menu-width';
 export * from './i-client-id';
 export * from './i-debounced';
@@ -11,6 +12,7 @@ export * from './i-order-property';
 export * from './i-order-short-info-property';
 export * from './i-orders-table-fields';
 export * from './i-placeholder';
+export * from './i-predefined-date-ranges';
 export * from './i-product-or-category-search-type';
 export * from './i-value';
 export * from './i-clearable-value';

package/package.json

@@ -4,7 +4,7 @@
     "keywords": [],
     "author": "Sergey S. Smirnov <dev@snabcentr.com>",
     "type": "module",
-    "version": "3.63.0",
+    "version": "3.65.0",
     "license": "ISC",
     "scripts": {
         "dev": "vite",
@@ -12,6 +12,7 @@
         "build-watch": "vite build -w",
         "lint_staged_template": "eslint --ignore-path .gitignore --cache --cache-location .eslintcache",
         "lint": "eslint --ignore-path .gitignore --cache --cache-strategy content --cache-location .eslintcache src",
+        "lint:staged": "npx lint-staged",
         "preview": "vite preview",
         "publish:lib": "npm publish",
         "init_git_hooks": "husky",
@@ -45,7 +46,7 @@
         "@iconify-json/logos": "^1.2.9",
         "@iconify-json/mdi": "^1.2.3",
         "@iconify-json/tabler": "^1.2.23",
-        "@snabcentr/common-lib": "^1.90.1 || ^2.7.0",
+        "@snabcentr/common-lib": "^1.93.0 || ^2.11.0",
         "@tailwindcss/container-queries": "^0.1.1",
         "date-fns": "^3.6.0",
         "libphonenumber-js": "^1.12.23",