@rock555/frontend-core 2.0.2 → 3.0.0

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 (66) 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 → ExportButton.vue} +62 -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/FilterCheckbox.vue +1 -1
  25. package/src/components/ui/FilterSelect.vue +2 -0
  26. package/src/components/ui/UiActionTiles.vue +92 -92
  27. package/src/components/ui/UiBackLink.vue +39 -39
  28. package/src/components/ui/UiBadge.vue +60 -60
  29. package/src/components/ui/UiButton.vue +126 -126
  30. package/src/components/ui/UiCard.vue +88 -88
  31. package/src/components/ui/UiCount.vue +35 -35
  32. package/src/components/ui/UiKpiGrid.vue +144 -142
  33. package/src/components/ui/UiPopover.vue +62 -62
  34. package/src/components/ui/UiSearchInput.vue +102 -102
  35. package/src/components/ui/UiSegmented.vue +145 -145
  36. package/src/components/ui/UiTableCard.vue +116 -116
  37. package/src/components/ui/inputs/DateFormInput.vue +2 -2
  38. package/src/components/ui/inputs/FileInput.vue +5 -0
  39. package/src/components/ui/inputs/RadioSegmentFormInput.vue +0 -1
  40. package/src/components/ui/inputs/SelectFormInput.vue +1 -2
  41. package/src/components/ui/inputs/SmartField.vue +15 -13
  42. package/src/components/ui/inputs/TextareaFormInput.vue +2 -2
  43. package/src/components/ui/uiActionTiles.types.ts +10 -10
  44. package/src/components/ui/uiBadge.types.ts +11 -11
  45. package/src/components/ui/uiKpi.types.ts +19 -17
  46. package/src/composables/useAppForm.ts +67 -67
  47. package/src/composables/useConfirm.ts +21 -21
  48. package/src/composables/useFilterState.ts +70 -70
  49. package/src/composables/useServerList.ts +348 -348
  50. package/src/composables/useServerTable.ts +117 -117
  51. package/src/composables/useSharedAsync.ts +51 -51
  52. package/src/composables/useVirtualTable.ts +77 -77
  53. package/src/config.ts +156 -155
  54. package/src/errors/actionCancelled.ts +9 -9
  55. package/src/errors/apiError.helper.ts +161 -161
  56. package/src/errors/useHandleError.ts +33 -33
  57. package/src/helpers/calendarRange.helper.ts +74 -74
  58. package/src/helpers/month.helper.ts +63 -63
  59. package/src/helpers/periodLabel.helper.ts +70 -70
  60. package/src/helpers/periodPresets.helper.ts +76 -76
  61. package/src/helpers/sort.helper.ts +57 -57
  62. package/src/helpers/tableFields.helper.ts +205 -205
  63. package/src/helpers/urlParams.helper.ts +99 -99
  64. package/src/helpers/urlSchema.helper.ts +296 -296
  65. package/src/plugins/modals.plugin.ts +253 -253
  66. package/src/plugins/table.plugin.ts +173 -173
@@ -1,205 +1,205 @@
1
- // Реєстр полів серверної таблиці — ОДИН запис на колонку: підпис, підказка,
2
- // ключ сортування з напрямком першого кліку. З нього виводяться карта «колонка ↔
3
- // sort_by», білий список ключів в адресі, панель сортування, приховані стовпці
4
- // й шапка — щоб ці переліки не розходились.
5
- //
6
- // Як дістати значення з рядка, тут НЕ описано — це функція в `*Row.vue`
7
- // (`r => r.metrics.gross_earnings`). Рядковий шлях не покрив би `?.`,
8
- // обчислень і масивів, а по функції працюють ctrl+click і перейменування.
9
-
10
- import type { VisibilityState } from '@tanstack/vue-table'
11
- import type { ColumnFieldMeta, ColumnFieldsSource } from '../plugins/table.plugin'
12
- import type { SortKeyOption } from '../components/filters/sortControl.types'
13
- import type { MultiSortPart } from '../components/tables/multiSortHeader.types'
14
- import type { SortDirection } from '../composables/useServerTable'
15
- import { SortHelper } from './sort.helper'
16
-
17
- /** Ключ сортування колонки: що слати беку, з чого починати, як підписати напрямки. */
18
- export interface FieldSort<TBy extends string = string> {
19
- by: TBy
20
- first: SortDirection
21
- directions: Record<SortDirection, string>
22
- }
23
-
24
- interface FieldBase<TSortBy extends string> {
25
- header: string
26
- /** Пояснення до назви: шапка малює значок «i», кнопка частини — title. */
27
- hint?: string
28
- sort?: FieldSort<TSortBy>
29
- }
30
-
31
- export interface Field<TSortBy extends string> extends FieldBase<TSortBy> {
32
- /**
33
- * Складена колонка: кілька чисел — кілька сортувань, кнопками в шапці
34
- * (MultiSortHeader). Сама вона не сортується, а кожна частина — окремий
35
- * прихований стовпець: без нього TanStack не втримає ключ у стані й не
36
- * порахує номер пріоритету.
37
- */
38
- parts?: Record<string, FieldBase<TSortBy> & { sort: FieldSort<TSortBy> }>
39
- /**
40
- * Носій ключа без видимої колонки: значення показує інша ячейка («Підтвердив»
41
- * — у статусі звіту) або це вісь групування з панелі («Належність авто»).
42
- */
43
- isHidden?: boolean
44
- }
45
-
46
- /** Будівники сортувань. Параметр типу — щоб редактор підказував ключі бека. */
47
- export interface SortBuilders<TSortBy extends string> {
48
- /** Гроші й лічильники: перший клік — максимум. */
49
- num<K extends TSortBy>(by: K): FieldSort<K>
50
- /** Текст — з початку абетки. */
51
- text<K extends TSortBy>(by: K): FieldSort<K>
52
- /** Дати — новіші згори. */
53
- date<K extends TSortBy>(by: K): FieldSort<K>
54
- /** Статуси й типи: бек сортує за кодом, тож «А → Я» тут збрехало б. */
55
- group<K extends TSortBy>(by: K): FieldSort<K>
56
- /** Ознака з власними словами («Спочатку авто парку»). */
57
- custom<K extends TSortBy>(by: K, first: SortDirection, directions: Record<SortDirection, string>): FieldSort<K>
58
- }
59
-
60
- const BUILDERS: SortBuilders<string> = {
61
- // Геттери: поля таблиць оголошені на рівні модуля, а тексти приходять пізніше, у `SharedConfig.configure`.
62
- num: by => ({ by, first: 'desc', get directions() { return SortHelper.DIRECTIONS.numeric } }),
63
- text: by => ({ by, first: 'asc', get directions() { return SortHelper.DIRECTIONS.text } }),
64
- date: by => ({ by, first: 'desc', get directions() { return SortHelper.DIRECTIONS.date } }),
65
- group: by => ({ by, first: 'asc', get directions() { return SortHelper.DIRECTIONS.group } }),
66
- custom: (by, first, directions) => ({ by, first, directions }),
67
- }
68
-
69
- /** column.id ↔ server sort_by — те, що потрібно мосту сортування (useServerTable). */
70
- export interface ColumnsMap<TId extends string, TSortBy extends string> {
71
- /** column.id → server sort_by (null = колонка не сортується). */
72
- readonly byId: Readonly<Record<TId, TSortBy | null>>
73
- /** Зворотно: server sort_by → column.id. Partial — бек уміє більше, ніж ми виводимо. */
74
- readonly toId: Readonly<Partial<Record<TSortBy, TId>>>
75
- /** TanStack віддає column.id рядком — звужуємо до відомого union'а. */
76
- isId(value: string): value is TId
77
- }
78
-
79
- /**
80
- * Карта колонок типізована ключами, які таблиця РЕАЛЬНО використовує: стор і
81
- * адреса тримають лише те, що може породити клік, а не весь перелік бека.
82
- */
83
- export interface TableFields<TId extends string, TSortBy extends string, TUsed extends TSortBy = TSortBy>
84
- extends ColumnsMap<TId, TUsed>, ColumnFieldsSource<TId> {
85
- /** Ключі, за якими таблиця вміє сортувати, — білий список для адреси. */
86
- readonly sortKeys: readonly TUsed[]
87
- /**
88
- * Повна назва поля поза шапкою — картка підсумків, панель сортування. Частина
89
- * складеної колонки — разом із батьком: «сума» окремо не каже, чого.
90
- */
91
- label(id: TId): string
92
- /** Пункти панелі сортування (SortControl) у порядку колонок. */
93
- readonly sortOptions: ReadonlyArray<SortKeyOption<TUsed>>
94
- /** `columnVisibility`: приховані стовпці вимкнені. */
95
- readonly visibility: VisibilityState
96
- /** Назва й кнопки складеної колонки — пропи MultiSortHeader. */
97
- multiSortHeader(id: TId): { label: string; parts: ReadonlyArray<MultiSortPart<TId>> }
98
- }
99
-
100
- type PartIdsOf<TMap> = {
101
- [K in keyof TMap]: TMap[K] extends { parts: infer P } ? keyof P : never
102
- }[keyof TMap]
103
-
104
- type SortByOf<T> = T extends { sort: FieldSort<infer B> } ? B : never
105
-
106
- type UsedSortKeysOf<TMap> = {
107
- [K in keyof TMap]: SortByOf<TMap[K]>
108
- | (TMap[K] extends { parts: infer P } ? { [Q in keyof P]: SortByOf<P[Q]> }[keyof P] : never)
109
- }[keyof TMap]
110
-
111
- export type FieldIdOf<T> = T extends TableFields<infer TId, string, string> ? TId : never
112
-
113
- /** Ключі сортування, які таблиця використовує, — тип сортування в сторі. */
114
- export type SortKeyOf<T> = T extends TableFields<string, string, infer U> ? U : never
115
-
116
- /** Ключі бека, яким у таблиці не завели колонку. */
117
- export type MissingSortKeys<TSortBy extends string, T> = Exclude<TSortBy, SortKeyOf<T>>
118
-
119
- /** Порожній union — або помилка компіляції. */
120
- export type AssertNever<T extends never> = T
121
-
122
- interface FlatField<TSortBy extends string> {
123
- field: FieldBase<TSortBy>
124
- parent: string | null
125
- isHidden: boolean
126
- }
127
-
128
- export class TableFieldsHelper {
129
- // Каррі, як у FormHelper.createSchema: ключі бека задаємо явно, id колонок і
130
- // використані ключі TS бере з літерала.
131
- static create<TSortBy extends string>() {
132
- return <TMap extends Record<string, Field<TSortBy>>>(
133
- build: (s: SortBuilders<TSortBy>) => TMap,
134
- ): TableFields<Extract<keyof TMap | PartIdsOf<TMap>, string>, TSortBy, UsedSortKeysOf<TMap> & TSortBy> => {
135
- type TId = Extract<keyof TMap | PartIdsOf<TMap>, string>
136
- type TUsed = UsedSortKeysOf<TMap> & TSortBy
137
-
138
- const flat = new Map<string, FlatField<TSortBy>>()
139
- const add = (id: string, entry: FlatField<TSortBy>): void => {
140
- // Частина з тим самим id, що й колонка, мовчки перезаписала б її.
141
- if (flat.has(id)) throw new Error(`TableFieldsHelper: id "${id}" is declared twice`)
142
- flat.set(id, entry)
143
- }
144
-
145
- for (const [id, field] of Object.entries(build(BUILDERS as SortBuilders<TSortBy>))) {
146
- add(id, { field, parent: null, isHidden: field.isHidden === true })
147
- for (const [partId, part] of Object.entries(field.parts ?? {})) {
148
- add(partId, { field: part, parent: id, isHidden: true })
149
- }
150
- }
151
-
152
- const entryOf = (id: string): FlatField<TSortBy> => {
153
- const entry = flat.get(id)
154
- if (!entry) throw new Error(`TableFieldsHelper: unknown column id "${id}"`)
155
-
156
- return entry
157
- }
158
-
159
- const entries = [...flat.entries()]
160
- const sorted = entries.flatMap(([id, { field }]) => field.sort ? [{ id, sort: field.sort }] : [])
161
- const hiddenIds = entries.filter(([, entry]) => entry.isHidden).map(([id]) => id as TId)
162
-
163
- const label = (id: string): string => {
164
- const { field, parent } = entryOf(id)
165
-
166
- return parent === null ? field.header : `${entryOf(parent).field.header}, ${field.header}`
167
- }
168
-
169
- return {
170
- byId: Object.fromEntries(entries.map(([id, { field }]) => [id, field.sort?.by ?? null])) as Record<TId, TUsed | null>,
171
- toId: Object.fromEntries(sorted.map(({ id, sort }) => [sort.by, id])) as Partial<Record<TUsed, TId>>,
172
- isId: (value: string): value is TId => flat.has(value),
173
-
174
- column: (id: TId): ColumnFieldMeta => {
175
- const { field } = entryOf(id)
176
-
177
- return {
178
- header: field.header,
179
- hint: field.hint,
180
- isSortable: field.sort !== undefined,
181
- isDescFirst: field.sort?.first === 'desc',
182
- }
183
- },
184
- hiddenIds,
185
-
186
- label,
187
- sortKeys: sorted.map(({ sort }) => sort.by as TUsed),
188
- sortOptions: sorted.map(({ id, sort }) => ({
189
- value: sort.by as TUsed,
190
- label: label(id),
191
- get directions() { return sort.directions },
192
- defaultDirection: sort.first,
193
- })),
194
- visibility: Object.fromEntries(hiddenIds.map(id => [id, false])),
195
-
196
- multiSortHeader: (id: TId) => ({
197
- label: entryOf(id).field.header,
198
- parts: entries
199
- .filter(([, entry]) => entry.parent === id)
200
- .map(([partId, { field }]) => ({ id: partId as TId, label: field.header, hint: field.hint })),
201
- }),
202
- }
203
- }
204
- }
205
- }
1
+ // Реєстр полів серверної таблиці — ОДИН запис на колонку: підпис, підказка,
2
+ // ключ сортування з напрямком першого кліку. З нього виводяться карта «колонка ↔
3
+ // sort_by», білий список ключів в адресі, панель сортування, приховані стовпці
4
+ // й шапка — щоб ці переліки не розходились.
5
+ //
6
+ // Як дістати значення з рядка, тут НЕ описано — це функція в `*Row.vue`
7
+ // (`r => r.metrics.gross_earnings`). Рядковий шлях не покрив би `?.`,
8
+ // обчислень і масивів, а по функції працюють ctrl+click і перейменування.
9
+
10
+ import type { VisibilityState } from '@tanstack/vue-table'
11
+ import type { ColumnFieldMeta, ColumnFieldsSource } from '../plugins/table.plugin'
12
+ import type { SortKeyOption } from '../components/filters/sortControl.types'
13
+ import type { MultiSortPart } from '../components/tables/multiSortHeader.types'
14
+ import type { SortDirection } from '../composables/useServerTable'
15
+ import { SortHelper } from './sort.helper'
16
+
17
+ /** Ключ сортування колонки: що слати беку, з чого починати, як підписати напрямки. */
18
+ export interface FieldSort<TBy extends string = string> {
19
+ by: TBy
20
+ first: SortDirection
21
+ directions: Record<SortDirection, string>
22
+ }
23
+
24
+ interface FieldBase<TSortBy extends string> {
25
+ header: string
26
+ /** Пояснення до назви: шапка малює значок «i», кнопка частини — title. */
27
+ hint?: string
28
+ sort?: FieldSort<TSortBy>
29
+ }
30
+
31
+ export interface Field<TSortBy extends string> extends FieldBase<TSortBy> {
32
+ /**
33
+ * Складена колонка: кілька чисел — кілька сортувань, кнопками в шапці
34
+ * (MultiSortHeader). Сама вона не сортується, а кожна частина — окремий
35
+ * прихований стовпець: без нього TanStack не втримає ключ у стані й не
36
+ * порахує номер пріоритету.
37
+ */
38
+ parts?: Record<string, FieldBase<TSortBy> & { sort: FieldSort<TSortBy> }>
39
+ /**
40
+ * Носій ключа без видимої колонки: значення показує інша ячейка («Підтвердив»
41
+ * — у статусі звіту) або це вісь групування з панелі («Належність авто»).
42
+ */
43
+ isHidden?: boolean
44
+ }
45
+
46
+ /** Будівники сортувань. Параметр типу — щоб редактор підказував ключі бека. */
47
+ export interface SortBuilders<TSortBy extends string> {
48
+ /** Гроші й лічильники: перший клік — максимум. */
49
+ num<K extends TSortBy>(by: K): FieldSort<K>
50
+ /** Текст — з початку абетки. */
51
+ text<K extends TSortBy>(by: K): FieldSort<K>
52
+ /** Дати — новіші згори. */
53
+ date<K extends TSortBy>(by: K): FieldSort<K>
54
+ /** Статуси й типи: бек сортує за кодом, тож «А → Я» тут збрехало б. */
55
+ group<K extends TSortBy>(by: K): FieldSort<K>
56
+ /** Ознака з власними словами («Спочатку авто парку»). */
57
+ custom<K extends TSortBy>(by: K, first: SortDirection, directions: Record<SortDirection, string>): FieldSort<K>
58
+ }
59
+
60
+ const BUILDERS: SortBuilders<string> = {
61
+ // Геттери: поля таблиць оголошені на рівні модуля, а тексти приходять пізніше, у `SharedConfig.configure`.
62
+ num: by => ({ by, first: 'desc', get directions() { return SortHelper.DIRECTIONS.numeric } }),
63
+ text: by => ({ by, first: 'asc', get directions() { return SortHelper.DIRECTIONS.text } }),
64
+ date: by => ({ by, first: 'desc', get directions() { return SortHelper.DIRECTIONS.date } }),
65
+ group: by => ({ by, first: 'asc', get directions() { return SortHelper.DIRECTIONS.group } }),
66
+ custom: (by, first, directions) => ({ by, first, directions }),
67
+ }
68
+
69
+ /** column.id ↔ server sort_by — те, що потрібно мосту сортування (useServerTable). */
70
+ export interface ColumnsMap<TId extends string, TSortBy extends string> {
71
+ /** column.id → server sort_by (null = колонка не сортується). */
72
+ readonly byId: Readonly<Record<TId, TSortBy | null>>
73
+ /** Зворотно: server sort_by → column.id. Partial — бек уміє більше, ніж ми виводимо. */
74
+ readonly toId: Readonly<Partial<Record<TSortBy, TId>>>
75
+ /** TanStack віддає column.id рядком — звужуємо до відомого union'а. */
76
+ isId(value: string): value is TId
77
+ }
78
+
79
+ /**
80
+ * Карта колонок типізована ключами, які таблиця РЕАЛЬНО використовує: стор і
81
+ * адреса тримають лише те, що може породити клік, а не весь перелік бека.
82
+ */
83
+ export interface TableFields<TId extends string, TSortBy extends string, TUsed extends TSortBy = TSortBy>
84
+ extends ColumnsMap<TId, TUsed>, ColumnFieldsSource<TId> {
85
+ /** Ключі, за якими таблиця вміє сортувати, — білий список для адреси. */
86
+ readonly sortKeys: readonly TUsed[]
87
+ /**
88
+ * Повна назва поля поза шапкою — картка підсумків, панель сортування. Частина
89
+ * складеної колонки — разом із батьком: «сума» окремо не каже, чого.
90
+ */
91
+ label(id: TId): string
92
+ /** Пункти панелі сортування (SortControl) у порядку колонок. */
93
+ readonly sortOptions: ReadonlyArray<SortKeyOption<TUsed>>
94
+ /** `columnVisibility`: приховані стовпці вимкнені. */
95
+ readonly visibility: VisibilityState
96
+ /** Назва й кнопки складеної колонки — пропи MultiSortHeader. */
97
+ multiSortHeader(id: TId): { label: string; parts: ReadonlyArray<MultiSortPart<TId>> }
98
+ }
99
+
100
+ type PartIdsOf<TMap> = {
101
+ [K in keyof TMap]: TMap[K] extends { parts: infer P } ? keyof P : never
102
+ }[keyof TMap]
103
+
104
+ type SortByOf<T> = T extends { sort: FieldSort<infer B> } ? B : never
105
+
106
+ type UsedSortKeysOf<TMap> = {
107
+ [K in keyof TMap]: SortByOf<TMap[K]>
108
+ | (TMap[K] extends { parts: infer P } ? { [Q in keyof P]: SortByOf<P[Q]> }[keyof P] : never)
109
+ }[keyof TMap]
110
+
111
+ export type FieldIdOf<T> = T extends TableFields<infer TId, string, string> ? TId : never
112
+
113
+ /** Ключі сортування, які таблиця використовує, — тип сортування в сторі. */
114
+ export type SortKeyOf<T> = T extends TableFields<string, string, infer U> ? U : never
115
+
116
+ /** Ключі бека, яким у таблиці не завели колонку. */
117
+ export type MissingSortKeys<TSortBy extends string, T> = Exclude<TSortBy, SortKeyOf<T>>
118
+
119
+ /** Порожній union — або помилка компіляції. */
120
+ export type AssertNever<T extends never> = T
121
+
122
+ interface FlatField<TSortBy extends string> {
123
+ field: FieldBase<TSortBy>
124
+ parent: string | null
125
+ isHidden: boolean
126
+ }
127
+
128
+ export class TableFieldsHelper {
129
+ // Каррі, як у FormHelper.createSchema: ключі бека задаємо явно, id колонок і
130
+ // використані ключі TS бере з літерала.
131
+ static create<TSortBy extends string>() {
132
+ return <TMap extends Record<string, Field<TSortBy>>>(
133
+ build: (s: SortBuilders<TSortBy>) => TMap,
134
+ ): TableFields<Extract<keyof TMap | PartIdsOf<TMap>, string>, TSortBy, UsedSortKeysOf<TMap> & TSortBy> => {
135
+ type TId = Extract<keyof TMap | PartIdsOf<TMap>, string>
136
+ type TUsed = UsedSortKeysOf<TMap> & TSortBy
137
+
138
+ const flat = new Map<string, FlatField<TSortBy>>()
139
+ const add = (id: string, entry: FlatField<TSortBy>): void => {
140
+ // Частина з тим самим id, що й колонка, мовчки перезаписала б її.
141
+ if (flat.has(id)) throw new Error(`TableFieldsHelper: id "${id}" is declared twice`)
142
+ flat.set(id, entry)
143
+ }
144
+
145
+ for (const [id, field] of Object.entries(build(BUILDERS as SortBuilders<TSortBy>))) {
146
+ add(id, { field, parent: null, isHidden: field.isHidden === true })
147
+ for (const [partId, part] of Object.entries(field.parts ?? {})) {
148
+ add(partId, { field: part, parent: id, isHidden: true })
149
+ }
150
+ }
151
+
152
+ const entryOf = (id: string): FlatField<TSortBy> => {
153
+ const entry = flat.get(id)
154
+ if (!entry) throw new Error(`TableFieldsHelper: unknown column id "${id}"`)
155
+
156
+ return entry
157
+ }
158
+
159
+ const entries = [...flat.entries()]
160
+ const sorted = entries.flatMap(([id, { field }]) => field.sort ? [{ id, sort: field.sort }] : [])
161
+ const hiddenIds = entries.filter(([, entry]) => entry.isHidden).map(([id]) => id as TId)
162
+
163
+ const label = (id: string): string => {
164
+ const { field, parent } = entryOf(id)
165
+
166
+ return parent === null ? field.header : `${entryOf(parent).field.header}, ${field.header}`
167
+ }
168
+
169
+ return {
170
+ byId: Object.fromEntries(entries.map(([id, { field }]) => [id, field.sort?.by ?? null])) as Record<TId, TUsed | null>,
171
+ toId: Object.fromEntries(sorted.map(({ id, sort }) => [sort.by, id])) as Partial<Record<TUsed, TId>>,
172
+ isId: (value: string): value is TId => flat.has(value),
173
+
174
+ column: (id: TId): ColumnFieldMeta => {
175
+ const { field } = entryOf(id)
176
+
177
+ return {
178
+ header: field.header,
179
+ hint: field.hint,
180
+ isSortable: field.sort !== undefined,
181
+ isDescFirst: field.sort?.first === 'desc',
182
+ }
183
+ },
184
+ hiddenIds,
185
+
186
+ label,
187
+ sortKeys: sorted.map(({ sort }) => sort.by as TUsed),
188
+ sortOptions: sorted.map(({ id, sort }) => ({
189
+ value: sort.by as TUsed,
190
+ label: label(id),
191
+ get directions() { return sort.directions },
192
+ defaultDirection: sort.first,
193
+ })),
194
+ visibility: Object.fromEntries(hiddenIds.map(id => [id, false])),
195
+
196
+ multiSortHeader: (id: TId) => ({
197
+ label: entryOf(id).field.header,
198
+ parts: entries
199
+ .filter(([, entry]) => entry.parent === id)
200
+ .map(([partId, { field }]) => ({ id: partId as TId, label: field.header, hint: field.hint })),
201
+ }),
202
+ }
203
+ }
204
+ }
205
+ }
@@ -1,99 +1,99 @@
1
- // Розбір типових query-параметрів фільтрів: період, сторінка, значення зі
2
- // словника. URL править хто завгодно, тому все, що не пройшло перевірку,
3
- // стає дефолтом, а не летить на бек як є.
4
- //
5
- // Живе в `shared`, а не поруч з UrlStateHelper у `_shared`: той шар спільний
6
- // з іншими проєктами і його склад визначаємо не ми.
7
-
8
- import type { UrlReader } from './urlState.helper'
9
- import type { SortDirection } from '../composables/useServerTable'
10
-
11
- export interface UrlPeriod {
12
- from: string
13
- to: string
14
- }
15
-
16
- export class UrlParamsHelper {
17
- private static readonly ISO_DATE = /^\d{4}-\d{2}-\d{2}$/
18
- private static readonly SORT_DIRECTIONS: readonly SortDirection[] = ['asc', 'desc']
19
- // Crockford base32 без I/L/O/U — саме такі id роздає бек.
20
- private static readonly ULID = /^[0-9A-HJKMNP-TV-Z]{26}$/i
21
-
22
- /** ?from=&to= — період лише якщо обидві дати валідні: половина діапазону сенсу не має. */
23
- static period(params: UrlReader, fromKey = 'from', toKey = 'to'): UrlPeriod | null {
24
- const from = params.get(fromKey)
25
- const to = params.get(toKey)
26
- if (!from || !to) return null
27
- if (!UrlParamsHelper.ISO_DATE.test(from) || !UrlParamsHelper.ISO_DATE.test(to)) return null
28
- return { from, to }
29
- }
30
-
31
- /** Одиночна дата ?sort_week=2026-07-27. Сміття відкидаємо — бек дав би 422. */
32
- static isoDate(raw: string | null): string | null {
33
- return raw && UrlParamsHelper.ISO_DATE.test(raw) ? raw : null
34
- }
35
-
36
- /** Значення з білого списку, інакше null. */
37
- static oneOf<T extends string>(raw: string | null, allowed: readonly T[]): T | null {
38
- return raw && allowed.includes(raw as T) ? (raw as T) : null
39
- }
40
-
41
- /** Те саме для списку (?aggregators=bolt,uber) — чужі значення просто відсіюються. */
42
- static manyOf<T extends string>(raw: readonly string[], allowed: readonly T[]): T[] {
43
- return raw.filter((value): value is T => allowed.includes(value as T))
44
- }
45
-
46
- static sortDirection(raw: string | null): SortDirection | null {
47
- return UrlParamsHelper.oneOf(raw, UrlParamsHelper.SORT_DIRECTIONS)
48
- }
49
-
50
- /**
51
- * Список id (?manager_id=01J…,01J…). Білого списку тут немає — id доменні,
52
- * тому перевіряємо форму: бек на кривий id відповів би 422, а це вилізло б
53
- * тостом помилки просто через сміття в адресі.
54
- */
55
- static ulids(raw: readonly string[]): string[] {
56
- return raw.filter(value => UrlParamsHelper.ULID.test(value))
57
- }
58
-
59
- /** Прапорець-перемикач: у URL живе лише як `1`, усе інше — вимкнено. */
60
- static flag(raw: string | null): boolean {
61
- return raw === '1'
62
- }
63
-
64
- /** Значення для запису: вимкнений прапорець в URL не потрапляє. */
65
- static writeFlag(value: boolean): '1' | null {
66
- return value ? '1' : null
67
- }
68
-
69
- /**
70
- * Фільтр «так / ні / байдуже»: `1` і `0` — сторони, усе інше (зокрема
71
- * відсутній ключ) — фільтр не заданий. Саме тристан, а не пара прапорців:
72
- * два ключі під взаємовиключну ознаку дають стан, який не прочитати
73
- * однозначно (обидва увімкнені — це що?).
74
- */
75
- static triState(raw: string | null): boolean | null {
76
- if (raw === '1') return true
77
- if (raw === '0') return false
78
-
79
- return null
80
- }
81
-
82
- /** Значення для запису: «байдуже» в URL не потрапляє. */
83
- static writeTriState(value: boolean | null): '1' | '0' | null {
84
- if (value === null) return null
85
-
86
- return value ? '1' : '0'
87
- }
88
-
89
- /** Сміття й перша сторінка дають 1 — її в URL не пишемо (див. writePage). */
90
- static page(raw: string | null): number {
91
- const page = Number(raw)
92
- return Number.isFinite(page) && page > 1 ? page : 1
93
- }
94
-
95
- /** Значення для запису: дефолт (сторінка 1) в URL не потрапляє. */
96
- static writePage(page: number): number | null {
97
- return page > 1 ? page : null
98
- }
99
- }
1
+ // Розбір типових query-параметрів фільтрів: період, сторінка, значення зі
2
+ // словника. URL править хто завгодно, тому все, що не пройшло перевірку,
3
+ // стає дефолтом, а не летить на бек як є.
4
+ //
5
+ // Живе в `shared`, а не поруч з UrlStateHelper у `_shared`: той шар спільний
6
+ // з іншими проєктами і його склад визначаємо не ми.
7
+
8
+ import type { UrlReader } from './urlState.helper'
9
+ import type { SortDirection } from '../composables/useServerTable'
10
+
11
+ export interface UrlPeriod {
12
+ from: string
13
+ to: string
14
+ }
15
+
16
+ export class UrlParamsHelper {
17
+ private static readonly ISO_DATE = /^\d{4}-\d{2}-\d{2}$/
18
+ private static readonly SORT_DIRECTIONS: readonly SortDirection[] = ['asc', 'desc']
19
+ // Crockford base32 без I/L/O/U — саме такі id роздає бек.
20
+ private static readonly ULID = /^[0-9A-HJKMNP-TV-Z]{26}$/i
21
+
22
+ /** ?from=&to= — період лише якщо обидві дати валідні: половина діапазону сенсу не має. */
23
+ static period(params: UrlReader, fromKey = 'from', toKey = 'to'): UrlPeriod | null {
24
+ const from = params.get(fromKey)
25
+ const to = params.get(toKey)
26
+ if (!from || !to) return null
27
+ if (!UrlParamsHelper.ISO_DATE.test(from) || !UrlParamsHelper.ISO_DATE.test(to)) return null
28
+ return { from, to }
29
+ }
30
+
31
+ /** Одиночна дата ?sort_week=2026-07-27. Сміття відкидаємо — бек дав би 422. */
32
+ static isoDate(raw: string | null): string | null {
33
+ return raw && UrlParamsHelper.ISO_DATE.test(raw) ? raw : null
34
+ }
35
+
36
+ /** Значення з білого списку, інакше null. */
37
+ static oneOf<T extends string>(raw: string | null, allowed: readonly T[]): T | null {
38
+ return raw && allowed.includes(raw as T) ? (raw as T) : null
39
+ }
40
+
41
+ /** Те саме для списку (?aggregators=bolt,uber) — чужі значення просто відсіюються. */
42
+ static manyOf<T extends string>(raw: readonly string[], allowed: readonly T[]): T[] {
43
+ return raw.filter((value): value is T => allowed.includes(value as T))
44
+ }
45
+
46
+ static sortDirection(raw: string | null): SortDirection | null {
47
+ return UrlParamsHelper.oneOf(raw, UrlParamsHelper.SORT_DIRECTIONS)
48
+ }
49
+
50
+ /**
51
+ * Список id (?manager_id=01J…,01J…). Білого списку тут немає — id доменні,
52
+ * тому перевіряємо форму: бек на кривий id відповів би 422, а це вилізло б
53
+ * тостом помилки просто через сміття в адресі.
54
+ */
55
+ static ulids(raw: readonly string[]): string[] {
56
+ return raw.filter(value => UrlParamsHelper.ULID.test(value))
57
+ }
58
+
59
+ /** Прапорець-перемикач: у URL живе лише як `1`, усе інше — вимкнено. */
60
+ static flag(raw: string | null): boolean {
61
+ return raw === '1'
62
+ }
63
+
64
+ /** Значення для запису: вимкнений прапорець в URL не потрапляє. */
65
+ static writeFlag(value: boolean): '1' | null {
66
+ return value ? '1' : null
67
+ }
68
+
69
+ /**
70
+ * Фільтр «так / ні / байдуже»: `1` і `0` — сторони, усе інше (зокрема
71
+ * відсутній ключ) — фільтр не заданий. Саме тристан, а не пара прапорців:
72
+ * два ключі під взаємовиключну ознаку дають стан, який не прочитати
73
+ * однозначно (обидва увімкнені — це що?).
74
+ */
75
+ static triState(raw: string | null): boolean | null {
76
+ if (raw === '1') return true
77
+ if (raw === '0') return false
78
+
79
+ return null
80
+ }
81
+
82
+ /** Значення для запису: «байдуже» в URL не потрапляє. */
83
+ static writeTriState(value: boolean | null): '1' | '0' | null {
84
+ if (value === null) return null
85
+
86
+ return value ? '1' : '0'
87
+ }
88
+
89
+ /** Сміття й перша сторінка дають 1 — її в URL не пишемо (див. writePage). */
90
+ static page(raw: string | null): number {
91
+ const page = Number(raw)
92
+ return Number.isFinite(page) && page > 1 ? page : 1
93
+ }
94
+
95
+ /** Значення для запису: дефолт (сторінка 1) в URL не потрапляє. */
96
+ static writePage(page: number): number | null {
97
+ return page > 1 ? page : null
98
+ }
99
+ }