@skyservice-developers/vue-dev-kit 2.16.0 → 2.17.0

package/README.md

@@ -34,7 +34,7 @@ import {
   SkyTableRow, SkyTableCell,
   useTableSort, useTableSelection, useColumnVisibility,
   FunctionalCalendar, SkyDateRangePicker,
-  SkyFilterDropdown,
+  SkyFilterDropdown, SkyPagination,
   // widgets
   SkyTileCard,
   // features
@@ -184,7 +184,7 @@ import {
 | `dropdownTitle` | `String` | `'Останні відвідані розділи'` | Заголовок дропдауну |
 | `visitLabel` | `String` | `'Останнє відвідування'` | Підпис часу в дропдауні |
 | `trackPageName` | `String` | `''` | Назва сторінки для трекінгу відвідувань |
-| `trackPagePath` | `String` | `''` | Шлях сторінки для трекінгу |
+| `trackPagePath` | `String` | `''` | Шлях сторінки для трекінгу (за замовчуванням `/apps/{trackPageName}`; актуальний дашборд підставляє свій реальний маршрут) |
 | `appId` | `String` | `''` | Ідентифікатор додатку для iframe bridge |
 
 #### Slots
@@ -1209,6 +1209,7 @@ const range = reactive({ start: '', end: '' }) // { start, end } у формат
 | `doneLabel` | `String` | `'Готово'` | Лейбл кнопки "Готово" |
 | `searchPlaceholder` | `String` | `'Пошук'` | Placeholder пошуку |
 | `selectAll` | `Boolean` | `true` | Показувати «Обрати все» |
+| `searchable` | `Boolean` | `true` | Показувати поле пошуку |
 | `disabled` | `Boolean` | `false` | Вимкнений стан |
 
 ### SkySelectFilter
@@ -1243,6 +1244,42 @@ const range = reactive({ start: '', end: '' }) // { start, end } у формат
 
 ---
 
+## SkyPagination
+
+Посторінкова навігація в стилі таблиць адмінки: селектор кількості на сторінці, далі
+номери зі згортанням у «…». Нічого не завантажує — лише повідомляє, що обрали.
+
+```vue
+<SkyPagination
+  :total="total"
+  :page="page"
+  :page-size="pageSize"
+  :all-label="(n) => `Усі ${n}`"
+  @update:page="page = $event; reload()"
+  @update:page-size="pageSize = $event; page = 1; reload()"
+/>
+```
+
+#### Props
+
+| Prop | Тип | За замовчуванням | Опис |
+|------|-----|------------------|------|
+| `total` | `Number` | — | Скільки всього записів у вибірці, не на сторінці |
+| `page` | `Number` | — | Поточна сторінка, з одиниці |
+| `pageSize` | `Number` | — | Записів на сторінці |
+| `pageSizeOptions` | `Number[]` | `[5,10,25,50,100,200,500,750,1000]` | Варіанти селектора; лишаються менші за `total` |
+| `allLabel` | `(total) => String` | — | Підпис пункту «показати все»; без нього пункту немає |
+| `allLimit` | `Number` | `1000` | До якої кількості пропонувати «показати все» |
+| `siblings` | `Number` | `1` | Скільки сусідніх сторінок показувати обабіч поточної |
+| `disabled` | `Boolean` | `false` | Вимкнений стан |
+
+Events: `update:page`, `update:pageSize`. CSS-змінні — `--sky-pagination-*`.
+
+**Потрібен `total`.** Для курсорних джерел, де загальна кількість невідома, а вперед ведуть
+лише курсори, номери сторінок неможливі — там потрібна навігація «назад / далі».
+
+---
+
 ## SkyFilterDropdown
 
 Оболонка фільтра: тригер-чіп + панель. Бере на себе тільки спільне — стан відкриття,
@@ -1434,6 +1471,7 @@ src/
 │       ├── SkyTable/     # готова віртуал-скрол таблиця (Header/Row/Footer/DynamicScroller/items/*)
 │       ├── SkyTileCard/
 │       ├── SkyFilterDropdown/  # оболонка фільтра (тригер + панель) + FilterSearch
+│       ├── SkyPagination/     # посторінкова навігація зі селектором кількості
 │       ├── functional-calendar/ # форк vue-functional-calendar, перенесений зі SkyMarket 1:1
 │       ├── SkyDateRangePicker/  # DatePickerRange зі SkyMarket, store/langs → props/локальний стан
 │       └── <Component>/

package/dist/features/SkyCheckboxFilter/SkyCheckboxFilter.vue.d.ts

@@ -13,10 +13,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     searchPlaceholder?: string;
     /** Сховати «Обрати все» — коли споживач не може прийняти більше одного значення. */
     selectAll?: boolean;
+    /** Сховати пошук — для коротких фіксованих списків він лише шумить. */
+    searchable?: boolean;
     disabled?: boolean;
 }>, {
     modelValue: () => never[];
     selectAll: boolean;
+    searchable: boolean;
     selectAllLabel: string;
     clearLabel: string;
     doneLabel: string;
@@ -34,10 +37,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     searchPlaceholder?: string;
     /** Сховати «Обрати все» — коли споживач не може прийняти більше одного значення. */
     selectAll?: boolean;
+    /** Сховати пошук — для коротких фіксованих списків він лише шумить. */
+    searchable?: boolean;
     disabled?: boolean;
 }>, {
     modelValue: () => never[];
     selectAll: boolean;
+    searchable: boolean;
     selectAllLabel: string;
     clearLabel: string;
     doneLabel: string;
@@ -53,6 +59,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     doneLabel: string;
     searchPlaceholder: string;
     selectAll: boolean;
+    searchable: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;
 type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;

package/dist/features/SkySelectFilter/SkySelectFilter.vue.d.ts

@@ -49,9 +49,9 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     modelValue: OptionValue | null;
     disabled: boolean;
     searchPlaceholder: string;
+    searchable: boolean;
     allLabel: string;
     emptyLabel: string;
-    searchable: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;
 type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;

package/dist/shared/ui/SkyPagination/SkyPagination.vue.d.ts

@@ -0,0 +1,77 @@
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** Скільки всього записів у вибірці (не на сторінці). */
+    total: number;
+    /** Поточна сторінка, з одиниці. */
+    page: number;
+    pageSize: number;
+    /** Варіанти для селектора; лишаються тільки менші за `total`. */
+    pageSizeOptions?: number[];
+    /**
+     * Підпис пункту «показати все». Отримує кількість: `(n) => `Усі ${n}``.
+     * Порожній — пункту немає. З'являється, лише поки записів менше за `allLimit`.
+     */
+    allLabel?: (total: number) => string;
+    allLimit?: number;
+    /** Скільки сусідніх сторінок показувати обабіч поточної. */
+    siblings?: number;
+    disabled?: boolean;
+}>, {
+    pageSizeOptions: () => number[];
+    allLabel: undefined;
+    allLimit: number;
+    siblings: number;
+    disabled: boolean;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:page": (args_0: number) => void;
+    "update:pageSize": (args_0: number) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** Скільки всього записів у вибірці (не на сторінці). */
+    total: number;
+    /** Поточна сторінка, з одиниці. */
+    page: number;
+    pageSize: number;
+    /** Варіанти для селектора; лишаються тільки менші за `total`. */
+    pageSizeOptions?: number[];
+    /**
+     * Підпис пункту «показати все». Отримує кількість: `(n) => `Усі ${n}``.
+     * Порожній — пункту немає. З'являється, лише поки записів менше за `allLimit`.
+     */
+    allLabel?: (total: number) => string;
+    allLimit?: number;
+    /** Скільки сусідніх сторінок показувати обабіч поточної. */
+    siblings?: number;
+    disabled?: boolean;
+}>, {
+    pageSizeOptions: () => number[];
+    allLabel: undefined;
+    allLimit: number;
+    siblings: number;
+    disabled: boolean;
+}>>> & Readonly<{
+    "onUpdate:page"?: ((args_0: number) => any) | undefined;
+    "onUpdate:pageSize"?: ((args_0: number) => any) | undefined;
+}>, {
+    disabled: boolean;
+    allLabel: (total: number) => string;
+    pageSizeOptions: number[];
+    allLimit: number;
+    siblings: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/shared/ui/SkyPagination/index.d.ts

@@ -0,0 +1 @@
+export { default } from './SkyPagination.vue';

package/dist/shared/ui/index.d.ts

@@ -16,6 +16,7 @@ export { default as SkyDateRangePicker } from './SkyDateRangePicker';
 export { default as SkyFilterDropdown } from './SkyFilterDropdown';
 export { default as SkyInput } from './SkyInput';
 export { default as SkyLoader } from './SkyLoader';
+export { default as SkyPagination } from './SkyPagination';
 export { default as SkySelect } from './SkySelect';
 export { default as SkySelectSearch } from './SkySelectSearch';
 export { default as SkySearchInput } from './SkySearchInput';