@rock555/frontend-core 2.0.2 → 2.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/README.md +95 -95
  2. package/package.json +98 -98
  3. package/src/components/GlobalPendingBar.vue +85 -85
  4. package/src/components/SearchPicker.vue +84 -84
  5. package/src/components/filters/DateRangeField.vue +692 -692
  6. package/src/components/filters/ExportCsvButton.vue +60 -60
  7. package/src/components/filters/FiltersBar.vue +150 -150
  8. package/src/components/filters/MonthField.vue +309 -309
  9. package/src/components/filters/SortControl.vue +162 -162
  10. package/src/components/filters/SortControlPanel.vue +242 -242
  11. package/src/components/filters/sortControl.types.ts +25 -25
  12. package/src/components/modals/ConfirmModal.vue +58 -58
  13. package/src/components/modals/ImageViewerModal.vue +200 -200
  14. package/src/components/tables/MultiSortHeader.vue +126 -126
  15. package/src/components/tables/TableBodyRow.vue +62 -62
  16. package/src/components/tables/TableFooterRow.vue +54 -54
  17. package/src/components/tables/TableHeaderRow.vue +75 -75
  18. package/src/components/tables/TableLoadedCount.vue +61 -61
  19. package/src/components/tables/TableLoadedFooter.vue +44 -44
  20. package/src/components/tables/TableSkeletonRows.vue +40 -40
  21. package/src/components/tables/TableVirtualPad.vue +16 -16
  22. package/src/components/tables/cells/BoolBadgeCell.vue +32 -32
  23. package/src/components/tables/multiSortHeader.types.ts +16 -16
  24. package/src/components/ui/UiActionTiles.vue +92 -92
  25. package/src/components/ui/UiBackLink.vue +39 -39
  26. package/src/components/ui/UiBadge.vue +60 -60
  27. package/src/components/ui/UiButton.vue +126 -126
  28. package/src/components/ui/UiCard.vue +88 -88
  29. package/src/components/ui/UiCount.vue +35 -35
  30. package/src/components/ui/UiKpiGrid.vue +142 -142
  31. package/src/components/ui/UiPopover.vue +62 -62
  32. package/src/components/ui/UiSearchInput.vue +102 -102
  33. package/src/components/ui/UiSegmented.vue +145 -145
  34. package/src/components/ui/UiTableCard.vue +116 -116
  35. package/src/components/ui/uiActionTiles.types.ts +10 -10
  36. package/src/components/ui/uiBadge.types.ts +11 -11
  37. package/src/components/ui/uiKpi.types.ts +17 -17
  38. package/src/composables/useAppForm.ts +67 -67
  39. package/src/composables/useConfirm.ts +21 -21
  40. package/src/composables/useFilterState.ts +70 -70
  41. package/src/composables/useServerList.ts +348 -348
  42. package/src/composables/useServerTable.ts +117 -117
  43. package/src/composables/useSharedAsync.ts +51 -51
  44. package/src/composables/useVirtualTable.ts +77 -77
  45. package/src/config.ts +155 -155
  46. package/src/errors/actionCancelled.ts +9 -9
  47. package/src/errors/apiError.helper.ts +161 -161
  48. package/src/errors/useHandleError.ts +33 -33
  49. package/src/helpers/calendarRange.helper.ts +74 -74
  50. package/src/helpers/month.helper.ts +63 -63
  51. package/src/helpers/periodLabel.helper.ts +70 -70
  52. package/src/helpers/periodPresets.helper.ts +76 -76
  53. package/src/helpers/sort.helper.ts +57 -57
  54. package/src/helpers/tableFields.helper.ts +205 -205
  55. package/src/helpers/urlParams.helper.ts +99 -99
  56. package/src/helpers/urlSchema.helper.ts +296 -296
  57. package/src/plugins/modals.plugin.ts +253 -253
  58. package/src/plugins/table.plugin.ts +173 -173
@@ -1,117 +1,117 @@
1
- // Міст «наш стор ↔ TanStack» для серверних таблиць: сортування + стани порожньо/
2
- // завантаження. Рядки приходять порціями при прокрутці (useVirtualTable).
3
-
4
- import type { SortingState } from '@tanstack/vue-table'
5
- import { computed } from 'vue'
6
- import type { SortDirection } from '../api/types'
7
- import type { ColumnsMap } from '../helpers/tableFields.helper'
8
-
9
- // Тип — у контракті API (`_shared/api/types`); тут лише для звичних імпортів фіч.
10
- export type { SortDirection }
11
-
12
- /** Зріз стора, потрібний серверній таблиці. Сторі фіч його вже мають. */
13
- export interface ServerTableStore<TSortBy extends string> {
14
- filters: {
15
- sortBy: TSortBy | null
16
- sortDirection: SortDirection | null
17
- setSort(by: TSortBy | null, dir?: SortDirection): void
18
- }
19
- data: { rows: readonly unknown[]; isLoading: boolean; isError: boolean }
20
- }
21
-
22
- // Скелетонів більше екрана не треба — далі вони лише миготять.
23
- const MAX_SKELETON_ROWS = 8
24
-
25
- export function useServerTable<TId extends string, TSortBy extends string>(
26
- store: ServerTableStore<TSortBy>,
27
- columns: ColumnsMap<TId, TSortBy>,
28
- ) {
29
- const sorting = computed<SortingState>({
30
- get: () => {
31
- const { sortBy, sortDirection } = store.filters
32
- if (!sortBy || !sortDirection) return []
33
- const id = columns.toId[sortBy]
34
- if (!id) return []
35
- return [{ id, desc: sortDirection === 'desc' }]
36
- },
37
- set: (next) => {
38
- const first = next[0]
39
- if (!first) { store.filters.setSort(null); return }
40
- if (!columns.isId(first.id)) return
41
- const sortBy = columns.byId[first.id]
42
- if (!sortBy) return // несортована колонка (значення в карті null)
43
- store.filters.setSort(sortBy, first.desc ? 'desc' : 'asc')
44
- },
45
- })
46
-
47
- return { sorting, ...useTableStates(store) }
48
- }
49
-
50
- /** Одне сортування в стеку мультисортування. */
51
- export interface ServerSortEntry<TSortBy extends string> {
52
- by: TSortBy
53
- direction: SortDirection
54
- }
55
-
56
- /** Зріз стора для таблиці з мультисортуванням. */
57
- export interface ServerMultiSortStore<TSortBy extends string> {
58
- filters: {
59
- sort: ReadonlyArray<ServerSortEntry<TSortBy>>
60
- setSort(next: Array<ServerSortEntry<TSortBy>>): void
61
- }
62
- data: { rows: readonly unknown[]; isLoading: boolean; isError: boolean }
63
- }
64
-
65
- /**
66
- * Те саме, але сортувань кілька і порядок = пріоритет.
67
- *
68
- * Міст двосторонній, як і в одиночного: цикл кліку, стек і номери пріоритету
69
- * веде TanStack. Умова цього — СВІЙ стовпець під кожен ключ; ті, що не мають
70
- * чого показувати в таблиці (`owner`, «Паливо, частка»), заведені як приховані
71
- * (`columnVisibility`). Поки таких стовпців не було, стан доводилось віддавати
72
- * лише на читання й фільтрувати, а номер пріоритету рахувався по обрізаному
73
- * масиву — і на екрані розходився зі справжнім порядком.
74
- */
75
- export function useServerMultiSortTable<TId extends string, TSortBy extends string>(
76
- store: ServerMultiSortStore<TSortBy>,
77
- columns: ColumnsMap<TId, TSortBy>,
78
- ) {
79
- const sorting = computed<SortingState>({
80
- get: () => store.filters.sort.flatMap((entry) => {
81
- const id = columns.toId[entry.by]
82
-
83
- return id === undefined ? [] : [{ id, desc: entry.direction === 'desc' }]
84
- }),
85
- set: (next) => {
86
- store.filters.setSort(next.flatMap((item) => {
87
- if (!columns.isId(item.id)) return []
88
-
89
- const by = columns.byId[item.id]
90
- if (!by) return [] // несортована колонка (значення в карті null)
91
-
92
- return [{ by, direction: item.desc ? 'desc' : 'asc' } as ServerSortEntry<TSortBy>]
93
- }))
94
- },
95
- })
96
-
97
- return { sorting, ...useTableStates(store) }
98
- }
99
-
100
- /** Стани порожньо/помилка/скелетони — і для таблиць без серверного сортування. */
101
- export function useTableStates(store: {
102
- data: { rows: readonly unknown[]; isLoading: boolean; isError: boolean }
103
- }) {
104
- // Перший показ — скелетони; refetch поверх наявних рядків їх не показує.
105
- const isInitialLoading = computed(() => store.data.isLoading && store.data.rows.length === 0)
106
-
107
- // Впав запит — це НЕ «нічого не знайдено»: порожньо — подивились і не знайшли,
108
- // помилка — не подивились. Один рядок на обидва брехав би про фільтри.
109
- const isError = computed(() => store.data.isError && store.data.rows.length === 0)
110
- const isEmpty = computed(() =>
111
- !store.data.isLoading && !isError.value && store.data.rows.length === 0,
112
- )
113
-
114
- const skeletonRowsCount = MAX_SKELETON_ROWS
115
-
116
- return { isInitialLoading, isEmpty, isError, skeletonRowsCount }
117
- }
1
+ // Міст «наш стор ↔ TanStack» для серверних таблиць: сортування + стани порожньо/
2
+ // завантаження. Рядки приходять порціями при прокрутці (useVirtualTable).
3
+
4
+ import type { SortingState } from '@tanstack/vue-table'
5
+ import { computed } from 'vue'
6
+ import type { SortDirection } from '../api/types'
7
+ import type { ColumnsMap } from '../helpers/tableFields.helper'
8
+
9
+ // Тип — у контракті API (`_shared/api/types`); тут лише для звичних імпортів фіч.
10
+ export type { SortDirection }
11
+
12
+ /** Зріз стора, потрібний серверній таблиці. Сторі фіч його вже мають. */
13
+ export interface ServerTableStore<TSortBy extends string> {
14
+ filters: {
15
+ sortBy: TSortBy | null
16
+ sortDirection: SortDirection | null
17
+ setSort(by: TSortBy | null, dir?: SortDirection): void
18
+ }
19
+ data: { rows: readonly unknown[]; isLoading: boolean; isError: boolean }
20
+ }
21
+
22
+ // Скелетонів більше екрана не треба — далі вони лише миготять.
23
+ const MAX_SKELETON_ROWS = 8
24
+
25
+ export function useServerTable<TId extends string, TSortBy extends string>(
26
+ store: ServerTableStore<TSortBy>,
27
+ columns: ColumnsMap<TId, TSortBy>,
28
+ ) {
29
+ const sorting = computed<SortingState>({
30
+ get: () => {
31
+ const { sortBy, sortDirection } = store.filters
32
+ if (!sortBy || !sortDirection) return []
33
+ const id = columns.toId[sortBy]
34
+ if (!id) return []
35
+ return [{ id, desc: sortDirection === 'desc' }]
36
+ },
37
+ set: (next) => {
38
+ const first = next[0]
39
+ if (!first) { store.filters.setSort(null); return }
40
+ if (!columns.isId(first.id)) return
41
+ const sortBy = columns.byId[first.id]
42
+ if (!sortBy) return // несортована колонка (значення в карті null)
43
+ store.filters.setSort(sortBy, first.desc ? 'desc' : 'asc')
44
+ },
45
+ })
46
+
47
+ return { sorting, ...useTableStates(store) }
48
+ }
49
+
50
+ /** Одне сортування в стеку мультисортування. */
51
+ export interface ServerSortEntry<TSortBy extends string> {
52
+ by: TSortBy
53
+ direction: SortDirection
54
+ }
55
+
56
+ /** Зріз стора для таблиці з мультисортуванням. */
57
+ export interface ServerMultiSortStore<TSortBy extends string> {
58
+ filters: {
59
+ sort: ReadonlyArray<ServerSortEntry<TSortBy>>
60
+ setSort(next: Array<ServerSortEntry<TSortBy>>): void
61
+ }
62
+ data: { rows: readonly unknown[]; isLoading: boolean; isError: boolean }
63
+ }
64
+
65
+ /**
66
+ * Те саме, але сортувань кілька і порядок = пріоритет.
67
+ *
68
+ * Міст двосторонній, як і в одиночного: цикл кліку, стек і номери пріоритету
69
+ * веде TanStack. Умова цього — СВІЙ стовпець під кожен ключ; ті, що не мають
70
+ * чого показувати в таблиці (`owner`, «Паливо, частка»), заведені як приховані
71
+ * (`columnVisibility`). Поки таких стовпців не було, стан доводилось віддавати
72
+ * лише на читання й фільтрувати, а номер пріоритету рахувався по обрізаному
73
+ * масиву — і на екрані розходився зі справжнім порядком.
74
+ */
75
+ export function useServerMultiSortTable<TId extends string, TSortBy extends string>(
76
+ store: ServerMultiSortStore<TSortBy>,
77
+ columns: ColumnsMap<TId, TSortBy>,
78
+ ) {
79
+ const sorting = computed<SortingState>({
80
+ get: () => store.filters.sort.flatMap((entry) => {
81
+ const id = columns.toId[entry.by]
82
+
83
+ return id === undefined ? [] : [{ id, desc: entry.direction === 'desc' }]
84
+ }),
85
+ set: (next) => {
86
+ store.filters.setSort(next.flatMap((item) => {
87
+ if (!columns.isId(item.id)) return []
88
+
89
+ const by = columns.byId[item.id]
90
+ if (!by) return [] // несортована колонка (значення в карті null)
91
+
92
+ return [{ by, direction: item.desc ? 'desc' : 'asc' } as ServerSortEntry<TSortBy>]
93
+ }))
94
+ },
95
+ })
96
+
97
+ return { sorting, ...useTableStates(store) }
98
+ }
99
+
100
+ /** Стани порожньо/помилка/скелетони — і для таблиць без серверного сортування. */
101
+ export function useTableStates(store: {
102
+ data: { rows: readonly unknown[]; isLoading: boolean; isError: boolean }
103
+ }) {
104
+ // Перший показ — скелетони; refetch поверх наявних рядків їх не показує.
105
+ const isInitialLoading = computed(() => store.data.isLoading && store.data.rows.length === 0)
106
+
107
+ // Впав запит — це НЕ «нічого не знайдено»: порожньо — подивились і не знайшли,
108
+ // помилка — не подивились. Один рядок на обидва брехав би про фільтри.
109
+ const isError = computed(() => store.data.isError && store.data.rows.length === 0)
110
+ const isEmpty = computed(() =>
111
+ !store.data.isLoading && !isError.value && store.data.rows.length === 0,
112
+ )
113
+
114
+ const skeletonRowsCount = MAX_SKELETON_ROWS
115
+
116
+ return { isInitialLoading, isEmpty, isError, skeletonRowsCount }
117
+ }
@@ -1,51 +1,51 @@
1
- import { ref, type Ref } from 'vue';
2
- import { handleApiError } from '../errors/useHandleError'
3
- import {MyFunction} from "../types/common";
4
-
5
- // Глобальное хранилище состояний для каждой функции
6
- interface AsyncState {
7
- isLoading: Ref<boolean>;
8
- activePromise: Promise<any> | null;
9
- }
10
-
11
- const registry = new WeakMap<MyFunction, AsyncState>();
12
-
13
- export function useSharedAsync<T, Args extends any[]>(
14
- asyncFn: (...args: Args) => Promise<T>
15
- ) {
16
- // Есть ли уже состояние для этой функции
17
- if (!registry.has(asyncFn)) {
18
- registry.set(asyncFn, {
19
- isLoading: ref(false),
20
- activePromise: null
21
- });
22
- }
23
-
24
- // Не null, сверху добавили
25
- const state = registry.get(asyncFn)!;
26
-
27
- const handle = async (...args: Args): Promise<T | undefined> => {
28
- // Если запрос уже выполняется - возвращаем существующий Promise
29
- if (state.activePromise) return state.activePromise
30
-
31
- state.isLoading.value = true;
32
-
33
- // Создаем запрос и сохраняем его в стейт
34
- state.activePromise = asyncFn(...args)
35
- .catch((error) => {
36
- handleApiError(error);
37
- return undefined;
38
- })
39
- .finally(() => {
40
- state.isLoading.value = false;
41
- state.activePromise = null; // Очищаем после завершения
42
- });
43
-
44
- return state.activePromise;
45
- };
46
-
47
- return {
48
- isLoading: state.isLoading,
49
- handle
50
- };
51
- }
1
+ import { ref, type Ref } from 'vue';
2
+ import { handleApiError } from '../errors/useHandleError'
3
+ import {MyFunction} from "../types/common";
4
+
5
+ // Глобальное хранилище состояний для каждой функции
6
+ interface AsyncState {
7
+ isLoading: Ref<boolean>;
8
+ activePromise: Promise<any> | null;
9
+ }
10
+
11
+ const registry = new WeakMap<MyFunction, AsyncState>();
12
+
13
+ export function useSharedAsync<T, Args extends any[]>(
14
+ asyncFn: (...args: Args) => Promise<T>
15
+ ) {
16
+ // Есть ли уже состояние для этой функции
17
+ if (!registry.has(asyncFn)) {
18
+ registry.set(asyncFn, {
19
+ isLoading: ref(false),
20
+ activePromise: null
21
+ });
22
+ }
23
+
24
+ // Не null, сверху добавили
25
+ const state = registry.get(asyncFn)!;
26
+
27
+ const handle = async (...args: Args): Promise<T | undefined> => {
28
+ // Если запрос уже выполняется - возвращаем существующий Promise
29
+ if (state.activePromise) return state.activePromise
30
+
31
+ state.isLoading.value = true;
32
+
33
+ // Создаем запрос и сохраняем его в стейт
34
+ state.activePromise = asyncFn(...args)
35
+ .catch((error) => {
36
+ handleApiError(error);
37
+ return undefined;
38
+ })
39
+ .finally(() => {
40
+ state.isLoading.value = false;
41
+ state.activePromise = null; // Очищаем после завершения
42
+ });
43
+
44
+ return state.activePromise;
45
+ };
46
+
47
+ return {
48
+ isLoading: state.isLoading,
49
+ handle
50
+ };
51
+ }
@@ -1,77 +1,77 @@
1
- // Віртуалізація серверної таблиці з підвантаженням порцій (`useServerInfiniteList`):
2
- // у DOM лише видимі рядки, наступна порція — коли дійшли до кінця завантаженого.
3
- //
4
- // Таблиця рендерить сама: `items` — які рядки малювати, `padTop` / `padBottom` —
5
- // висота розпірок над і під ними (TableVirtualPad), `measure` — на корінь рядка,
6
- // щоб висоту брати справжню, а не оцінку.
7
-
8
- import { useVirtualizer } from '@tanstack/vue-virtual'
9
- import { computed, onMounted, onUnmounted, watch, type Ref } from 'vue'
10
-
11
- /** Те, що потрібно від стора нескінченного списку. */
12
- export interface InfiniteListStore {
13
- data: { isLoading: boolean; loadMore(): void; setShown(isShown: boolean): void }
14
- /** Параметри вибірки: інші — прокрутка на початок. */
15
- params: unknown
16
- }
17
-
18
- /** Висота рядка до виміру — середня; точну дає measure. */
19
- const DEFAULT_ESTIMATE = 64
20
- /** За скільки рядків до кінця просимо наступну порцію: щоб не впиратися в порожнечу. */
21
- const PREFETCH_ROWS = 30
22
-
23
- export function useVirtualTable(options: {
24
- /** Таблиця; скролиться її батько — область прокрутки UiTableCard. */
25
- table: Readonly<Ref<HTMLTableElement | null>>
26
- /** Рядки в порядку показу; ключ — `id`. */
27
- rows: () => ReadonlyArray<{ id: string }>
28
- list: InfiniteListStore
29
- estimateSize?: number
30
- }) {
31
- const { list } = options
32
-
33
- // Запит увімкнений, лише поки таблиця на екрані (див. useServerInfiniteList).
34
- onMounted(() => list.data.setShown(true))
35
- onUnmounted(() => list.data.setShown(false))
36
-
37
- // Елемент прокрутки читаємо в самому computed: картка перемальовує таблицю
38
- // (порожньо → дані), і без перерахунку опцій віртуалізатор слухав би прокрутку
39
- // вже неіснуючого елемента.
40
- const scrollEl = computed(() => options.table.value?.parentElement ?? null)
41
- const virtualizer = useVirtualizer(computed(() => {
42
- const element = scrollEl.value
43
- const rows = options.rows()
44
-
45
- return {
46
- count: rows.length,
47
- getScrollElement: () => element,
48
- estimateSize: () => options.estimateSize ?? DEFAULT_ESTIMATE,
49
- overscan: 8,
50
- getItemKey: (index: number) => rows[index]?.id ?? index,
51
- }
52
- }))
53
-
54
- const items = computed(() => virtualizer.value.getVirtualItems())
55
- const padTop = computed(() => items.value[0]?.start ?? 0)
56
- const padBottom = computed(() => {
57
- const last = items.value.at(-1)
58
- return last ? virtualizer.value.getTotalSize() - last.end : 0
59
- })
60
-
61
- /** На корінь рядка (`:ref`): компонент чи елемент — висоту беремо справжню. */
62
- function measure(target: unknown): void {
63
- const node = target instanceof Element ? target : (target as { $el?: unknown } | null)?.$el
64
- if (node instanceof Element) virtualizer.value.measureElement(node)
65
- }
66
-
67
- // Дійшли до кінця завантаженого — наступна порція. І коли закінчився запит:
68
- // просьба посеред іншого ігнорується, а індекс уже не зміниться — список застряг би.
69
- watch([() => items.value.at(-1)?.index, () => list.data.isLoading], ([lastIndex, isLoading]) => {
70
- if (!isLoading && lastIndex !== undefined && lastIndex >= options.rows().length - PREFETCH_ROWS) list.data.loadMore()
71
- })
72
-
73
- // Інша вибірка (фільтр, пошук, сортування) — з першого рядка, а не з місця в старій.
74
- watch(() => list.params, () => virtualizer.value.scrollToOffset(0), { deep: true })
75
-
76
- return { items, padTop, padBottom, measure }
77
- }
1
+ // Віртуалізація серверної таблиці з підвантаженням порцій (`useServerInfiniteList`):
2
+ // у DOM лише видимі рядки, наступна порція — коли дійшли до кінця завантаженого.
3
+ //
4
+ // Таблиця рендерить сама: `items` — які рядки малювати, `padTop` / `padBottom` —
5
+ // висота розпірок над і під ними (TableVirtualPad), `measure` — на корінь рядка,
6
+ // щоб висоту брати справжню, а не оцінку.
7
+
8
+ import { useVirtualizer } from '@tanstack/vue-virtual'
9
+ import { computed, onMounted, onUnmounted, watch, type Ref } from 'vue'
10
+
11
+ /** Те, що потрібно від стора нескінченного списку. */
12
+ export interface InfiniteListStore {
13
+ data: { isLoading: boolean; loadMore(): void; setShown(isShown: boolean): void }
14
+ /** Параметри вибірки: інші — прокрутка на початок. */
15
+ params: unknown
16
+ }
17
+
18
+ /** Висота рядка до виміру — середня; точну дає measure. */
19
+ const DEFAULT_ESTIMATE = 64
20
+ /** За скільки рядків до кінця просимо наступну порцію: щоб не впиратися в порожнечу. */
21
+ const PREFETCH_ROWS = 30
22
+
23
+ export function useVirtualTable(options: {
24
+ /** Таблиця; скролиться її батько — область прокрутки UiTableCard. */
25
+ table: Readonly<Ref<HTMLTableElement | null>>
26
+ /** Рядки в порядку показу; ключ — `id`. */
27
+ rows: () => ReadonlyArray<{ id: string }>
28
+ list: InfiniteListStore
29
+ estimateSize?: number
30
+ }) {
31
+ const { list } = options
32
+
33
+ // Запит увімкнений, лише поки таблиця на екрані (див. useServerInfiniteList).
34
+ onMounted(() => list.data.setShown(true))
35
+ onUnmounted(() => list.data.setShown(false))
36
+
37
+ // Елемент прокрутки читаємо в самому computed: картка перемальовує таблицю
38
+ // (порожньо → дані), і без перерахунку опцій віртуалізатор слухав би прокрутку
39
+ // вже неіснуючого елемента.
40
+ const scrollEl = computed(() => options.table.value?.parentElement ?? null)
41
+ const virtualizer = useVirtualizer(computed(() => {
42
+ const element = scrollEl.value
43
+ const rows = options.rows()
44
+
45
+ return {
46
+ count: rows.length,
47
+ getScrollElement: () => element,
48
+ estimateSize: () => options.estimateSize ?? DEFAULT_ESTIMATE,
49
+ overscan: 8,
50
+ getItemKey: (index: number) => rows[index]?.id ?? index,
51
+ }
52
+ }))
53
+
54
+ const items = computed(() => virtualizer.value.getVirtualItems())
55
+ const padTop = computed(() => items.value[0]?.start ?? 0)
56
+ const padBottom = computed(() => {
57
+ const last = items.value.at(-1)
58
+ return last ? virtualizer.value.getTotalSize() - last.end : 0
59
+ })
60
+
61
+ /** На корінь рядка (`:ref`): компонент чи елемент — висоту беремо справжню. */
62
+ function measure(target: unknown): void {
63
+ const node = target instanceof Element ? target : (target as { $el?: unknown } | null)?.$el
64
+ if (node instanceof Element) virtualizer.value.measureElement(node)
65
+ }
66
+
67
+ // Дійшли до кінця завантаженого — наступна порція. І коли закінчився запит:
68
+ // просьба посеред іншого ігнорується, а індекс уже не зміниться — список застряг би.
69
+ watch([() => items.value.at(-1)?.index, () => list.data.isLoading], ([lastIndex, isLoading]) => {
70
+ if (!isLoading && lastIndex !== undefined && lastIndex >= options.rows().length - PREFETCH_ROWS) list.data.loadMore()
71
+ })
72
+
73
+ // Інша вибірка (фільтр, пошук, сортування) — з першого рядка, а не з місця в старій.
74
+ watch(() => list.params, () => virtualizer.value.scrollToOffset(0), { deep: true })
75
+
76
+ return { items, padTop, padBottom, measure }
77
+ }