@snabcentr/common-lib 4.5.0-dev → 4.7.0-dev

package/dist/src/pagination/index.d.ts

@@ -1,2 +1,3 @@
 export * from './filters';
+export * from './helpers';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/pagination/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pagination/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pagination/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/src/table-data/classes/table-data-pagination-request-params.d.ts

@@ -1,3 +1,4 @@
+import { IPaginationPreset } from '../interfaces/i-pagination-preset';
 import { IPaginationRequestParams } from '@snabcentr/common-core';
 /**
  * Данные о пагинации записей таблицы.
@@ -12,10 +13,12 @@ export declare class TableDataPaginationRequestParams implements IPaginationRequ
      */
     pageSize: number;
     /**
-     * Инициализирует экземпляр класса {@link TableDataPaginationRequestParams}.
+     * Инициализирует экземпляр класса {@link TableDataPaginationRequestParams}. Незаданное количество записей на
+     * странице берётся из настроек пагинации, заданное ограничивается их пределом `maxPageSize`.
      *
      * @param data Данные для первоначальной инициализации.
+     * @param preset Набор настроек пагинации списка.
      */
-    constructor(data?: IPaginationRequestParams);
+    constructor(data?: Partial<IPaginationRequestParams>, preset?: IPaginationPreset);
 }
 //# sourceMappingURL=table-data-pagination-request-params.d.ts.map

package/dist/src/table-data/classes/table-data-pagination-request-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-data-pagination-request-params.d.ts","sourceRoot":"","sources":["../../../../src/table-data/classes/table-data-pagination-request-params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;GAEG;AACH,qBAAa,gCAAiC,YAAW,wBAAwB;IAC7E;;OAEG;IACI,IAAI,SAAK;IAEhB;;OAEG;IACI,QAAQ,SAAM;IAErB;;;;OAIG;gBACgB,IAAI,CAAC,EAAE,wBAAwB;CAIrD"}
+{"version":3,"file":"table-data-pagination-request-params.d.ts","sourceRoot":"","sources":["../../../../src/table-data/classes/table-data-pagination-request-params.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;GAEG;AACH,qBAAa,gCAAiC,YAAW,wBAAwB;IAC7E;;OAEG;IACI,IAAI,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACI,QAAQ,EAAE,MAAM,CAAC;IAExB;;;;;;OAMG;gBACgB,IAAI,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC,EAAE,iBAAiB;CAM1F"}

package/dist/src/table-data/classes/table-data-pagination.d.ts

@@ -1,5 +1,6 @@
 import { TableDataPaginationRequestParams } from './table-data-pagination-request-params';
 import { IPagination } from '../interfaces/i-pagination';
+import { IPaginationPreset } from '../interfaces/i-pagination-preset';
 /**
  * Данные о пагинации записей таблицы.
  */
@@ -25,10 +26,12 @@ export declare class TableDataPagination extends TableDataPaginationRequestParam
      */
     showSizePicker: boolean;
     /**
-     * Инициализирует экземпляр класса {@link TableDataPagination}.
+     * Инициализирует экземпляр класса {@link TableDataPagination}. Незаданные значения берутся из настроек пагинации,
+     * варианты количества записей на странице ограничиваются их пределом `maxPageSize`.
      *
-     * @param data Данные для первоначальной инициализации.
+     * @param data Данные для первоначальной инициализации, например сохранённые страница и размер страницы.
+     * @param preset Набор настроек пагинации списка.
      */
-    constructor(data?: IPagination);
+    constructor(data?: Partial<IPagination>, preset?: IPaginationPreset);
 }
 //# sourceMappingURL=table-data-pagination.d.ts.map

package/dist/src/table-data/classes/table-data-pagination.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-data-pagination.d.ts","sourceRoot":"","sources":["../../../../src/table-data/classes/table-data-pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,iEAAiE,CAAC;AACnH,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAEzE;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,gCAAiC,YAAW,WAAW;IAC5F;;OAEG;IACI,SAAS,SAAK;IAErB;;OAEG;IACI,SAAS,SAAK;IAErB;;OAEG;IACI,QAAQ,SAAK;IAEpB;;OAEG;IACI,SAAS,WAAiB;IAEjC;;OAEG;IACI,cAAc,UAAQ;IAE7B;;;;OAIG;gBACgB,IAAI,CAAC,EAAE,WAAW;CASxC"}
+{"version":3,"file":"table-data-pagination.d.ts","sourceRoot":"","sources":["../../../../src/table-data/classes/table-data-pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,iEAAiE,CAAC;AAEnH,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAEtF;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,gCAAiC,YAAW,WAAW;IAC5F;;OAEG;IACI,SAAS,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACI,SAAS,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACI,QAAQ,EAAE,MAAM,CAAC;IAExB;;OAEG;IACI,SAAS,EAAE,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACI,cAAc,EAAE,OAAO,CAAC;IAE/B;;;;;;OAMG;gBACgB,IAAI,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,EAAE,iBAAiB;CAW7E"}

package/dist/src/table-data/helpers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './pagination-settings-helper';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/table-data/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/table-data/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/dist/src/table-data/helpers/pagination-settings-helper.d.ts

@@ -0,0 +1,39 @@
+import { IPaginationPreset } from '../interfaces/i-pagination-preset';
+import { IPaginationSettings } from '../interfaces/i-pagination-settings';
+/**
+ * Класс-помощник для сборки настроек пагинации списков.
+ */
+export declare class PaginationSettingsHelper {
+    /**
+     * Собирает настройки пагинации списка. По возрастанию приоритета: встроенные настройки, `pagination.defaults`
+     * конфигурации, поля набора, `pagination.presets[имя набора]`. Незаданные и пустые (`null`) поля пропускаются, списки заменяются
+     * целиком, затем размер и варианты ограничиваются пределом `maxPageSize`. Без активного хранилища pinia
+     * конфигурация не читается. Результат всегда новый объект с новым списком вариантов.
+     *
+     * @param preset Набор настроек списка.
+     */
+    static resolve(preset?: IPaginationPreset): IPaginationSettings & {
+        readonly pageSizes: number[];
+    };
+    /**
+     * Ограничивает количество записей на странице пределом.
+     *
+     * @param pageSize Количество записей на странице.
+     * @param maxPageSize Наибольшее количество записей на странице.
+     */
+    static limitPageSize(pageSize: number, maxPageSize: number): number;
+    /**
+     * Оставляет варианты количества записей на странице не больше предела. Если варианты больше предела были отброшены
+     * или вариантов нет, в конец списка добавляется сам предел: размер страницы, ограниченный пределом, всегда есть
+     * среди вариантов. Результат всегда новый список.
+     *
+     * @param pageSizes Варианты количества записей на странице.
+     * @param maxPageSize Наибольшее количество записей на странице.
+     */
+    static limitPageSizes(pageSizes: readonly number[], maxPageSize: number): number[];
+    /**
+     * Возвращает секцию пагинации конфигурации, без активного хранилища pinia `undefined`.
+     */
+    private static getConfig;
+}
+//# sourceMappingURL=pagination-settings-helper.d.ts.map

package/dist/src/table-data/helpers/pagination-settings-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-settings-helper.d.ts","sourceRoot":"","sources":["../../../../src/table-data/helpers/pagination-settings-helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAM1F;;GAEG;AACH,qBAAa,wBAAwB;IACjC;;;;;;;OAOG;WACW,OAAO,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,GAAG;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE;IAkBzG;;;;;OAKG;WACW,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAI1E;;;;;;;OAOG;WACW,cAAc,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAOzF;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;CAO3B"}

package/dist/src/table-data/index.d.ts

@@ -1,3 +1,5 @@
 export * from './interfaces';
 export * from './classes';
+export * from './helpers';
+export * from './values';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/table-data/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/table-data/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/table-data/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/src/table-data/interfaces/i-pagination-preset.d.ts

@@ -0,0 +1,11 @@
+import { IPaginationSettings } from './i-pagination-settings';
+/**
+ * Набор настроек пагинации, объявленный списком. Незаданные поля берутся из настроек ниже по приоритету.
+ */
+export interface IPaginationPreset extends Partial<IPaginationSettings> {
+    /**
+     * Имя набора: ключ переопределения в `pagination.presets` конфигурации. Без имени набор не переопределяется.
+     */
+    readonly name?: string;
+}
+//# sourceMappingURL=i-pagination-preset.d.ts.map

package/dist/src/table-data/interfaces/i-pagination-preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-pagination-preset.d.ts","sourceRoot":"","sources":["../../../../src/table-data/interfaces/i-pagination-preset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,OAAO,CAAC,mBAAmB,CAAC;IACnE;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/src/table-data/interfaces/i-pagination-settings.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Настройки пагинации списка.
+ */
+export interface IPaginationSettings {
+    /**
+     * Количество записей на странице.
+     */
+    readonly pageSize: number;
+    /**
+     * Значения для выпадающего списка "Количество записей на странице". Список более высокого приоритета заменяет нижний целиком.
+     */
+    readonly pageSizes: readonly number[];
+    /**
+     * Число отображаемых номеров страниц.
+     */
+    readonly pageSlot: number;
+    /**
+     * Признак необходимости отображать список выбора числа отображаемых записей.
+     */
+    readonly showSizePicker: boolean;
+    /**
+     * Наибольшее количество записей на странице, которое принимает источник данных списка. Размер страницы при загрузке списка целиком.
+     */
+    readonly maxPageSize: number;
+    /**
+     * Наибольшее количество страниц при загрузке списка целиком.
+     */
+    readonly maxPages: number;
+}
+//# sourceMappingURL=i-pagination-settings.d.ts.map

package/dist/src/table-data/interfaces/i-pagination-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-pagination-settings.d.ts","sourceRoot":"","sources":["../../../../src/table-data/interfaces/i-pagination-settings.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B"}

package/dist/src/table-data/interfaces/index.d.ts

@@ -1,2 +1,4 @@
 export * from './i-pagination';
+export * from './i-pagination-preset';
+export * from './i-pagination-settings';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/table-data/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/table-data/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/table-data/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/src/table-data/values/index.d.ts

@@ -0,0 +1,2 @@
+export * from './pagination-default-settings';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/table-data/values/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/table-data/values/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC"}

package/dist/src/table-data/values/pagination-default-settings.d.ts

@@ -0,0 +1,6 @@
+import { IPaginationSettings } from '../interfaces/i-pagination-settings';
+/**
+ * Встроенные настройки пагинации списков.
+ */
+export declare const PAGINATION_DEFAULT_SETTINGS: Readonly<IPaginationSettings>;
+//# sourceMappingURL=pagination-default-settings.d.ts.map

package/dist/src/table-data/values/pagination-default-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-default-settings.d.ts","sourceRoot":"","sources":["../../../../src/table-data/values/pagination-default-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAE1F;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,mBAAmB,CAOpE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@snabcentr/common-lib",
-    "version": "4.5.0-dev",
+    "version": "4.7.0-dev",
     "description": "Библиотека общих классов, используемых во всех проектах Снабцентр.",
     "keywords": [],
     "author": "Sergey S. Smirnov <dev@snabcentr.com>",
@@ -38,7 +38,7 @@
         }
     },
     "peerDependencies": {
-        "@snabcentr/common-core": "^1.2.0-0",
+        "@snabcentr/common-core": "^1.3.0-0",
         "axios": "^1.20.0",
         "date-fns": "^4.4.0",
         "jwt-decode": "^4.0.0",