@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.
- package/README.md +95 -95
- package/package.json +98 -98
- package/src/components/GlobalPendingBar.vue +85 -85
- package/src/components/SearchPicker.vue +84 -84
- package/src/components/filters/DateRangeField.vue +692 -692
- package/src/components/filters/ExportCsvButton.vue +60 -60
- package/src/components/filters/FiltersBar.vue +150 -150
- package/src/components/filters/MonthField.vue +309 -309
- package/src/components/filters/SortControl.vue +162 -162
- package/src/components/filters/SortControlPanel.vue +242 -242
- package/src/components/filters/sortControl.types.ts +25 -25
- package/src/components/modals/ConfirmModal.vue +58 -58
- package/src/components/modals/ImageViewerModal.vue +200 -200
- package/src/components/tables/MultiSortHeader.vue +126 -126
- package/src/components/tables/TableBodyRow.vue +62 -62
- package/src/components/tables/TableFooterRow.vue +54 -54
- package/src/components/tables/TableHeaderRow.vue +75 -75
- package/src/components/tables/TableLoadedCount.vue +61 -61
- package/src/components/tables/TableLoadedFooter.vue +44 -44
- package/src/components/tables/TableSkeletonRows.vue +40 -40
- package/src/components/tables/TableVirtualPad.vue +16 -16
- package/src/components/tables/cells/BoolBadgeCell.vue +32 -32
- package/src/components/tables/multiSortHeader.types.ts +16 -16
- package/src/components/ui/UiActionTiles.vue +92 -92
- package/src/components/ui/UiBackLink.vue +39 -39
- package/src/components/ui/UiBadge.vue +60 -60
- package/src/components/ui/UiButton.vue +126 -126
- package/src/components/ui/UiCard.vue +88 -88
- package/src/components/ui/UiCount.vue +35 -35
- package/src/components/ui/UiKpiGrid.vue +142 -142
- package/src/components/ui/UiPopover.vue +62 -62
- package/src/components/ui/UiSearchInput.vue +102 -102
- package/src/components/ui/UiSegmented.vue +145 -145
- package/src/components/ui/UiTableCard.vue +116 -116
- package/src/components/ui/uiActionTiles.types.ts +10 -10
- package/src/components/ui/uiBadge.types.ts +11 -11
- package/src/components/ui/uiKpi.types.ts +17 -17
- package/src/composables/useAppForm.ts +67 -67
- package/src/composables/useConfirm.ts +21 -21
- package/src/composables/useFilterState.ts +70 -70
- package/src/composables/useServerList.ts +348 -348
- package/src/composables/useServerTable.ts +117 -117
- package/src/composables/useSharedAsync.ts +51 -51
- package/src/composables/useVirtualTable.ts +77 -77
- package/src/config.ts +155 -155
- package/src/errors/actionCancelled.ts +9 -9
- package/src/errors/apiError.helper.ts +161 -161
- package/src/errors/useHandleError.ts +33 -33
- package/src/helpers/calendarRange.helper.ts +74 -74
- package/src/helpers/month.helper.ts +63 -63
- package/src/helpers/periodLabel.helper.ts +70 -70
- package/src/helpers/periodPresets.helper.ts +76 -76
- package/src/helpers/sort.helper.ts +57 -57
- package/src/helpers/tableFields.helper.ts +205 -205
- package/src/helpers/urlParams.helper.ts +99 -99
- package/src/helpers/urlSchema.helper.ts +296 -296
- package/src/plugins/modals.plugin.ts +253 -253
- 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
|
+
}
|