@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,296 +1,296 @@
|
|
|
1
|
-
// Мета-опис фільтрів фічі в адресному рядку: один ключ — один запис, читання й
|
|
2
|
-
// запис поруч.
|
|
3
|
-
//
|
|
4
|
-
// Було: `read<Feature>Url` і `write<Feature>Url` перелічували ті самі ключі
|
|
5
|
-
// двічі, за двадцять рядків один від одного. Додав фільтр, забув другий
|
|
6
|
-
// список — фільтр працює, але не переживає перезавантаження, і жоден тип цього
|
|
7
|
-
// не ловить. Тут пара фізично не може розійтися: її неможливо оголосити
|
|
8
|
-
// нарізно.
|
|
9
|
-
//
|
|
10
|
-
// Тип стану виводиться зі схеми (`UrlStateOf<typeof SCHEMA>`) — свого
|
|
11
|
-
// інтерфейсу поруч тримати не треба, а Ctrl+Click по полю веде в саму схему,
|
|
12
|
-
// де видно і ключ в адресі, і правило розбору.
|
|
13
|
-
//
|
|
14
|
-
// Живе в `shared`, а не в `_shared`: спирається на UrlParamsHelper, який теж тут.
|
|
15
|
-
|
|
16
|
-
import { UrlStateHelper, type UrlReader, type UrlValue } from './urlState.helper'
|
|
17
|
-
import type { ServerSortEntry, SortDirection } from '../composables/useServerTable'
|
|
18
|
-
import { MonthHelper } from './month.helper'
|
|
19
|
-
import { UrlParamsHelper, type UrlPeriod } from './urlParams.helper'
|
|
20
|
-
|
|
21
|
-
/**
|
|
22
|
-
* Як одне поле стану лягає в адресу. `write` віддає мапу ключів, а не один
|
|
23
|
-
* рядок: період — це два ключі, і він має лишатись одним полем стану.
|
|
24
|
-
*/
|
|
25
|
-
export interface UrlCodec<T> {
|
|
26
|
-
read(params: UrlReader): T
|
|
27
|
-
write(value: T): Record<string, UrlValue>
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
// `any` тут — той самий випадок, що ColumnDef<T, any> у TanStack: без нього
|
|
31
|
-
// UrlCodec<string> не присвоюється до UrlCodec<unknown> через контраваріантний
|
|
32
|
-
// `write`, і жодна схема не проходить перевірку.
|
|
33
|
-
type UrlShape = Record<string, UrlCodec<any>>
|
|
34
|
-
|
|
35
|
-
type UrlState<S extends UrlShape> = {
|
|
36
|
-
[K in keyof S]: S[K] extends UrlCodec<infer T> ? T : never
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
export interface UrlSchema<S extends UrlShape> {
|
|
40
|
-
read: () => UrlState<S>
|
|
41
|
-
write: (state: UrlState<S>) => void
|
|
42
|
-
/** Стан чистої адреси: до нього веде «Скинути фільтри». */
|
|
43
|
-
blank: () => UrlState<S>
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
/**
|
|
47
|
-
* Стан фічі, виведений зі схеми: `UrlStateOf<typeof SCHEMA>`. Руками інтерфейс
|
|
48
|
-
* більше не пишемо — інакше він і був би третім місцем, де перелічені ключі.
|
|
49
|
-
*/
|
|
50
|
-
export type UrlStateOf<T extends { read: () => unknown }> = ReturnType<T['read']>
|
|
51
|
-
|
|
52
|
-
export class UrlSchemaHelper {
|
|
53
|
-
/**
|
|
54
|
-
* Схема з мапи «поле стану → кодек». Стрілки, а не методи: щоб фіча могла
|
|
55
|
-
* віддати їх як є (`export const readFooUrl = SCHEMA.read`), не загортаючи
|
|
56
|
-
* у власну функцію.
|
|
57
|
-
*/
|
|
58
|
-
static create<S extends UrlShape>(shape: S): UrlSchema<S> {
|
|
59
|
-
const entries = Object.entries(shape) as Array<[keyof S & string, UrlCodec<unknown>]>
|
|
60
|
-
|
|
61
|
-
const readFrom = (params: UrlReader): UrlState<S> => {
|
|
62
|
-
const state = {} as UrlState<S>
|
|
63
|
-
|
|
64
|
-
for (const [field, codec] of entries) {
|
|
65
|
-
state[field] = codec.read(params) as UrlState<S>[typeof field]
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
return state
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
return {
|
|
72
|
-
read: () => readFrom(UrlStateHelper.readUrl()),
|
|
73
|
-
blank: () => readFrom(UrlStateHelper.EMPTY_READER),
|
|
74
|
-
|
|
75
|
-
write: (state) => {
|
|
76
|
-
const updates: Record<string, UrlValue> = {}
|
|
77
|
-
|
|
78
|
-
for (const [field, codec] of entries) {
|
|
79
|
-
Object.assign(updates, codec.write(state[field]))
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
UrlStateHelper.writeUrl(updates)
|
|
83
|
-
},
|
|
84
|
-
}
|
|
85
|
-
}
|
|
86
|
-
|
|
87
|
-
/** ?from=&to= — одне поле стану на два ключі (див. UrlParamsHelper.period). */
|
|
88
|
-
static period(fromKey = 'from', toKey = 'to'): UrlCodec<UrlPeriod | null> {
|
|
89
|
-
return {
|
|
90
|
-
read: params => UrlParamsHelper.period(params, fromKey, toKey),
|
|
91
|
-
write: value => ({ [fromKey]: value?.from ?? null, [toKey]: value?.to ?? null }),
|
|
92
|
-
}
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
/** Вільний текст (пошук). Порожній рядок в адресу не потрапляє. */
|
|
96
|
-
static text(key: string): UrlCodec<string> {
|
|
97
|
-
return {
|
|
98
|
-
read: params => params.get(key) ?? '',
|
|
99
|
-
write: value => ({ [key]: value || null }),
|
|
100
|
-
}
|
|
101
|
-
}
|
|
102
|
-
|
|
103
|
-
/** Рядок без перевірки — для доменних id, форму яких ми не знаємо (fleet_id). */
|
|
104
|
-
static raw(key: string): UrlCodec<string | null> {
|
|
105
|
-
return {
|
|
106
|
-
read: params => params.get(key) || null,
|
|
107
|
-
write: value => ({ [key]: value }),
|
|
108
|
-
}
|
|
109
|
-
}
|
|
110
|
-
|
|
111
|
-
static isoDate(key: string): UrlCodec<string | null> {
|
|
112
|
-
return {
|
|
113
|
-
read: params => UrlParamsHelper.isoDate(params.get(key)),
|
|
114
|
-
write: value => ({ [key]: value }),
|
|
115
|
-
}
|
|
116
|
-
}
|
|
117
|
-
|
|
118
|
-
/**
|
|
119
|
-
* Пара «менеджери / без менеджера» одним ключем адреси (`mgr=id,id` або
|
|
120
|
-
* `mgr=none`): обидва разом адреса не виразить, тож і стан однозначний. У
|
|
121
|
-
* стані — звична пара полів, як на інших вкладках (`...managersInOneKey()` у
|
|
122
|
-
* схемі). Порядок важливий: `isWithoutManager` пишеться ПІСЛЯ й перекриває
|
|
123
|
-
* ключ.
|
|
124
|
-
*/
|
|
125
|
-
static managersInOneKey(key: string) {
|
|
126
|
-
const none = 'none'
|
|
127
|
-
|
|
128
|
-
return {
|
|
129
|
-
managerIds: UrlSchemaHelper.custom<string[]>({
|
|
130
|
-
// Синтетичне значення прибираємо зі списку id, інакше воно поїхало б на
|
|
131
|
-
// бек як ulid. Форму решти перевіряємо: сміття теж дало б 422.
|
|
132
|
-
read: (params) => {
|
|
133
|
-
const raw = params.getList(key)
|
|
134
|
-
return raw.includes(none) ? [] : UrlParamsHelper.ulids(raw)
|
|
135
|
-
},
|
|
136
|
-
write: ids => ({ [key]: ids.length > 0 ? ids.join(',') : null }),
|
|
137
|
-
}),
|
|
138
|
-
isWithoutManager: UrlSchemaHelper.custom<boolean>({
|
|
139
|
-
read: params => params.getList(key).includes(none),
|
|
140
|
-
write: (isWithout): Record<string, UrlValue> => (isWithout ? { [key]: none } : {}),
|
|
141
|
-
}),
|
|
142
|
-
}
|
|
143
|
-
}
|
|
144
|
-
|
|
145
|
-
/**
|
|
146
|
-
* Календарний місяць `YYYY-MM` одним ключем — не пара from/to. Сміття —
|
|
147
|
-
* так само, як відсутній: бек на нього відповів би 422.
|
|
148
|
-
*/
|
|
149
|
-
static month(key: string): UrlCodec<string | null> {
|
|
150
|
-
return {
|
|
151
|
-
read: (params) => {
|
|
152
|
-
const raw = params.get(key)
|
|
153
|
-
return raw && MonthHelper.isMonth(raw) ? raw : null
|
|
154
|
-
},
|
|
155
|
-
write: value => ({ [key]: value }),
|
|
156
|
-
}
|
|
157
|
-
}
|
|
158
|
-
|
|
159
|
-
/** Значення з білого списку; чуже — так само, як відсутнє. */
|
|
160
|
-
static oneOf<T extends string>(key: string, allowed: readonly T[]): UrlCodec<T | null> {
|
|
161
|
-
return {
|
|
162
|
-
read: params => UrlParamsHelper.oneOf(params.get(key), allowed),
|
|
163
|
-
write: value => ({ [key]: value }),
|
|
164
|
-
}
|
|
165
|
-
}
|
|
166
|
-
|
|
167
|
-
/** Те саме, але з дефолтом: він і читається замість сміття, і не пишеться. */
|
|
168
|
-
static oneOfOr<T extends string>(key: string, allowed: readonly T[], fallback: T): UrlCodec<T> {
|
|
169
|
-
return {
|
|
170
|
-
read: params => UrlParamsHelper.oneOf(params.get(key), allowed) ?? fallback,
|
|
171
|
-
write: value => ({ [key]: value === fallback ? null : value }),
|
|
172
|
-
}
|
|
173
|
-
}
|
|
174
|
-
|
|
175
|
-
static manyOf<T extends string>(key: string, allowed: readonly T[]): UrlCodec<T[]> {
|
|
176
|
-
return {
|
|
177
|
-
read: params => UrlParamsHelper.manyOf(params.getList(key), allowed),
|
|
178
|
-
write: value => ({ [key]: value.length > 0 ? value.join(',') : null }),
|
|
179
|
-
}
|
|
180
|
-
}
|
|
181
|
-
|
|
182
|
-
/**
|
|
183
|
-
* Те саме з дефолтом: немає ключа — дефолт, і дефолт не пишеться. Порожній
|
|
184
|
-
* вибір пишеться явним `any`, інакше після перезавантаження він став би
|
|
185
|
-
* дефолтом, а не «будь-який».
|
|
186
|
-
*/
|
|
187
|
-
static manyOfOr<T extends string>(key: string, allowed: readonly T[], fallback: readonly T[]): UrlCodec<T[]> {
|
|
188
|
-
const isFallback = (value: readonly T[]) =>
|
|
189
|
-
value.length === fallback.length && value.every(item => fallback.includes(item))
|
|
190
|
-
|
|
191
|
-
return {
|
|
192
|
-
read: (params) => {
|
|
193
|
-
const raw = params.get(key)
|
|
194
|
-
if (raw === null) return [...fallback]
|
|
195
|
-
if (raw === 'any') return []
|
|
196
|
-
|
|
197
|
-
return UrlParamsHelper.manyOf(params.getList(key), allowed)
|
|
198
|
-
},
|
|
199
|
-
write: value => ({ [key]: isFallback(value) ? null : value.length > 0 ? value.join(',') : 'any' }),
|
|
200
|
-
}
|
|
201
|
-
}
|
|
202
|
-
|
|
203
|
-
/** Список доменних id: перевіряємо форму, бо білого списку в нас немає. */
|
|
204
|
-
static ulids(key: string): UrlCodec<string[]> {
|
|
205
|
-
return {
|
|
206
|
-
read: params => UrlParamsHelper.ulids(params.getList(key)),
|
|
207
|
-
write: value => ({ [key]: value.length > 0 ? value.join(',') : null }),
|
|
208
|
-
}
|
|
209
|
-
}
|
|
210
|
-
|
|
211
|
-
/** Список як є — коли значення перевіряє вже сам бек. */
|
|
212
|
-
static list(key: string): UrlCodec<string[]> {
|
|
213
|
-
return {
|
|
214
|
-
read: params => params.getList(key),
|
|
215
|
-
write: value => ({ [key]: value.length > 0 ? value.join(',') : null }),
|
|
216
|
-
}
|
|
217
|
-
}
|
|
218
|
-
|
|
219
|
-
static flag(key: string): UrlCodec<boolean> {
|
|
220
|
-
return {
|
|
221
|
-
read: params => UrlParamsHelper.flag(params.get(key)),
|
|
222
|
-
write: value => ({ [key]: UrlParamsHelper.writeFlag(value) }),
|
|
223
|
-
}
|
|
224
|
-
}
|
|
225
|
-
|
|
226
|
-
static triState(key: string): UrlCodec<boolean | null> {
|
|
227
|
-
return {
|
|
228
|
-
read: params => UrlParamsHelper.triState(params.get(key)),
|
|
229
|
-
write: value => ({ [key]: UrlParamsHelper.writeTriState(value) }),
|
|
230
|
-
}
|
|
231
|
-
}
|
|
232
|
-
|
|
233
|
-
static sortDirection(key: string): UrlCodec<SortDirection | null> {
|
|
234
|
-
return {
|
|
235
|
-
read: params => UrlParamsHelper.sortDirection(params.get(key)),
|
|
236
|
-
write: value => ({ [key]: value }),
|
|
237
|
-
}
|
|
238
|
-
}
|
|
239
|
-
|
|
240
|
-
static page(key = 'page'): UrlCodec<number> {
|
|
241
|
-
return {
|
|
242
|
-
read: params => UrlParamsHelper.page(params.get(key)),
|
|
243
|
-
write: value => ({ [key]: UrlParamsHelper.writePage(value) }),
|
|
244
|
-
}
|
|
245
|
-
}
|
|
246
|
-
|
|
247
|
-
/**
|
|
248
|
-
* Стек мультисортування одним ключем: `sort=payable:desc,full_name:asc`.
|
|
249
|
-
*
|
|
250
|
-
* Список, а не мапа: порядок ключів = пріоритет, і в адресі він має бути
|
|
251
|
-
* видно. Пара `sort_by`/`sort_dir` двох сортувань не виражає взагалі.
|
|
252
|
-
*
|
|
253
|
-
* Відсіюємо все, що бек поверне 422: невідомий ключ (перейменували колонку),
|
|
254
|
-
* кривий напрямок, дубль того самого ключа (TanStack його не втримає).
|
|
255
|
-
*/
|
|
256
|
-
static sortList<T extends string>(
|
|
257
|
-
key: string,
|
|
258
|
-
allowed: readonly T[],
|
|
259
|
-
): UrlCodec<Array<ServerSortEntry<T>>> {
|
|
260
|
-
return {
|
|
261
|
-
read: (params) => {
|
|
262
|
-
const raw = params.get(key)
|
|
263
|
-
if (!raw) return []
|
|
264
|
-
|
|
265
|
-
const seen = new Set<T>()
|
|
266
|
-
|
|
267
|
-
return raw.split(',').reduce<Array<ServerSortEntry<T>>>((acc, chunk) => {
|
|
268
|
-
const [by, direction] = chunk.split(':') as [T, SortDirection]
|
|
269
|
-
|
|
270
|
-
if (!allowed.includes(by)) return acc
|
|
271
|
-
if (direction !== 'asc' && direction !== 'desc') return acc
|
|
272
|
-
if (seen.has(by)) return acc
|
|
273
|
-
|
|
274
|
-
seen.add(by)
|
|
275
|
-
acc.push({ by, direction })
|
|
276
|
-
|
|
277
|
-
return acc
|
|
278
|
-
}, [])
|
|
279
|
-
},
|
|
280
|
-
write: value => ({
|
|
281
|
-
[key]: value.length > 0 ? value.map(e => `${e.by}:${e.direction}`).join(',') : null,
|
|
282
|
-
}),
|
|
283
|
-
}
|
|
284
|
-
}
|
|
285
|
-
|
|
286
|
-
/**
|
|
287
|
-
* Кодек зі своїм розбором — для ключів, які не лягають на готові: список
|
|
288
|
-
* `key:dir` у «Звітах», пара «менеджери або нічиї» під одним ключем.
|
|
289
|
-
*
|
|
290
|
-
* Функція-тотожність, і в цьому суть: вона змушує написати читання й запис
|
|
291
|
-
* поруч, замість двох шматків у різних кінцях файлу.
|
|
292
|
-
*/
|
|
293
|
-
static custom<T>(codec: UrlCodec<T>): UrlCodec<T> {
|
|
294
|
-
return codec
|
|
295
|
-
}
|
|
296
|
-
}
|
|
1
|
+
// Мета-опис фільтрів фічі в адресному рядку: один ключ — один запис, читання й
|
|
2
|
+
// запис поруч.
|
|
3
|
+
//
|
|
4
|
+
// Було: `read<Feature>Url` і `write<Feature>Url` перелічували ті самі ключі
|
|
5
|
+
// двічі, за двадцять рядків один від одного. Додав фільтр, забув другий
|
|
6
|
+
// список — фільтр працює, але не переживає перезавантаження, і жоден тип цього
|
|
7
|
+
// не ловить. Тут пара фізично не може розійтися: її неможливо оголосити
|
|
8
|
+
// нарізно.
|
|
9
|
+
//
|
|
10
|
+
// Тип стану виводиться зі схеми (`UrlStateOf<typeof SCHEMA>`) — свого
|
|
11
|
+
// інтерфейсу поруч тримати не треба, а Ctrl+Click по полю веде в саму схему,
|
|
12
|
+
// де видно і ключ в адресі, і правило розбору.
|
|
13
|
+
//
|
|
14
|
+
// Живе в `shared`, а не в `_shared`: спирається на UrlParamsHelper, який теж тут.
|
|
15
|
+
|
|
16
|
+
import { UrlStateHelper, type UrlReader, type UrlValue } from './urlState.helper'
|
|
17
|
+
import type { ServerSortEntry, SortDirection } from '../composables/useServerTable'
|
|
18
|
+
import { MonthHelper } from './month.helper'
|
|
19
|
+
import { UrlParamsHelper, type UrlPeriod } from './urlParams.helper'
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* Як одне поле стану лягає в адресу. `write` віддає мапу ключів, а не один
|
|
23
|
+
* рядок: період — це два ключі, і він має лишатись одним полем стану.
|
|
24
|
+
*/
|
|
25
|
+
export interface UrlCodec<T> {
|
|
26
|
+
read(params: UrlReader): T
|
|
27
|
+
write(value: T): Record<string, UrlValue>
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
// `any` тут — той самий випадок, що ColumnDef<T, any> у TanStack: без нього
|
|
31
|
+
// UrlCodec<string> не присвоюється до UrlCodec<unknown> через контраваріантний
|
|
32
|
+
// `write`, і жодна схема не проходить перевірку.
|
|
33
|
+
type UrlShape = Record<string, UrlCodec<any>>
|
|
34
|
+
|
|
35
|
+
type UrlState<S extends UrlShape> = {
|
|
36
|
+
[K in keyof S]: S[K] extends UrlCodec<infer T> ? T : never
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export interface UrlSchema<S extends UrlShape> {
|
|
40
|
+
read: () => UrlState<S>
|
|
41
|
+
write: (state: UrlState<S>) => void
|
|
42
|
+
/** Стан чистої адреси: до нього веде «Скинути фільтри». */
|
|
43
|
+
blank: () => UrlState<S>
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* Стан фічі, виведений зі схеми: `UrlStateOf<typeof SCHEMA>`. Руками інтерфейс
|
|
48
|
+
* більше не пишемо — інакше він і був би третім місцем, де перелічені ключі.
|
|
49
|
+
*/
|
|
50
|
+
export type UrlStateOf<T extends { read: () => unknown }> = ReturnType<T['read']>
|
|
51
|
+
|
|
52
|
+
export class UrlSchemaHelper {
|
|
53
|
+
/**
|
|
54
|
+
* Схема з мапи «поле стану → кодек». Стрілки, а не методи: щоб фіча могла
|
|
55
|
+
* віддати їх як є (`export const readFooUrl = SCHEMA.read`), не загортаючи
|
|
56
|
+
* у власну функцію.
|
|
57
|
+
*/
|
|
58
|
+
static create<S extends UrlShape>(shape: S): UrlSchema<S> {
|
|
59
|
+
const entries = Object.entries(shape) as Array<[keyof S & string, UrlCodec<unknown>]>
|
|
60
|
+
|
|
61
|
+
const readFrom = (params: UrlReader): UrlState<S> => {
|
|
62
|
+
const state = {} as UrlState<S>
|
|
63
|
+
|
|
64
|
+
for (const [field, codec] of entries) {
|
|
65
|
+
state[field] = codec.read(params) as UrlState<S>[typeof field]
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
return state
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
return {
|
|
72
|
+
read: () => readFrom(UrlStateHelper.readUrl()),
|
|
73
|
+
blank: () => readFrom(UrlStateHelper.EMPTY_READER),
|
|
74
|
+
|
|
75
|
+
write: (state) => {
|
|
76
|
+
const updates: Record<string, UrlValue> = {}
|
|
77
|
+
|
|
78
|
+
for (const [field, codec] of entries) {
|
|
79
|
+
Object.assign(updates, codec.write(state[field]))
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
UrlStateHelper.writeUrl(updates)
|
|
83
|
+
},
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/** ?from=&to= — одне поле стану на два ключі (див. UrlParamsHelper.period). */
|
|
88
|
+
static period(fromKey = 'from', toKey = 'to'): UrlCodec<UrlPeriod | null> {
|
|
89
|
+
return {
|
|
90
|
+
read: params => UrlParamsHelper.period(params, fromKey, toKey),
|
|
91
|
+
write: value => ({ [fromKey]: value?.from ?? null, [toKey]: value?.to ?? null }),
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** Вільний текст (пошук). Порожній рядок в адресу не потрапляє. */
|
|
96
|
+
static text(key: string): UrlCodec<string> {
|
|
97
|
+
return {
|
|
98
|
+
read: params => params.get(key) ?? '',
|
|
99
|
+
write: value => ({ [key]: value || null }),
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/** Рядок без перевірки — для доменних id, форму яких ми не знаємо (fleet_id). */
|
|
104
|
+
static raw(key: string): UrlCodec<string | null> {
|
|
105
|
+
return {
|
|
106
|
+
read: params => params.get(key) || null,
|
|
107
|
+
write: value => ({ [key]: value }),
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
static isoDate(key: string): UrlCodec<string | null> {
|
|
112
|
+
return {
|
|
113
|
+
read: params => UrlParamsHelper.isoDate(params.get(key)),
|
|
114
|
+
write: value => ({ [key]: value }),
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* Пара «менеджери / без менеджера» одним ключем адреси (`mgr=id,id` або
|
|
120
|
+
* `mgr=none`): обидва разом адреса не виразить, тож і стан однозначний. У
|
|
121
|
+
* стані — звична пара полів, як на інших вкладках (`...managersInOneKey()` у
|
|
122
|
+
* схемі). Порядок важливий: `isWithoutManager` пишеться ПІСЛЯ й перекриває
|
|
123
|
+
* ключ.
|
|
124
|
+
*/
|
|
125
|
+
static managersInOneKey(key: string) {
|
|
126
|
+
const none = 'none'
|
|
127
|
+
|
|
128
|
+
return {
|
|
129
|
+
managerIds: UrlSchemaHelper.custom<string[]>({
|
|
130
|
+
// Синтетичне значення прибираємо зі списку id, інакше воно поїхало б на
|
|
131
|
+
// бек як ulid. Форму решти перевіряємо: сміття теж дало б 422.
|
|
132
|
+
read: (params) => {
|
|
133
|
+
const raw = params.getList(key)
|
|
134
|
+
return raw.includes(none) ? [] : UrlParamsHelper.ulids(raw)
|
|
135
|
+
},
|
|
136
|
+
write: ids => ({ [key]: ids.length > 0 ? ids.join(',') : null }),
|
|
137
|
+
}),
|
|
138
|
+
isWithoutManager: UrlSchemaHelper.custom<boolean>({
|
|
139
|
+
read: params => params.getList(key).includes(none),
|
|
140
|
+
write: (isWithout): Record<string, UrlValue> => (isWithout ? { [key]: none } : {}),
|
|
141
|
+
}),
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
/**
|
|
146
|
+
* Календарний місяць `YYYY-MM` одним ключем — не пара from/to. Сміття —
|
|
147
|
+
* так само, як відсутній: бек на нього відповів би 422.
|
|
148
|
+
*/
|
|
149
|
+
static month(key: string): UrlCodec<string | null> {
|
|
150
|
+
return {
|
|
151
|
+
read: (params) => {
|
|
152
|
+
const raw = params.get(key)
|
|
153
|
+
return raw && MonthHelper.isMonth(raw) ? raw : null
|
|
154
|
+
},
|
|
155
|
+
write: value => ({ [key]: value }),
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/** Значення з білого списку; чуже — так само, як відсутнє. */
|
|
160
|
+
static oneOf<T extends string>(key: string, allowed: readonly T[]): UrlCodec<T | null> {
|
|
161
|
+
return {
|
|
162
|
+
read: params => UrlParamsHelper.oneOf(params.get(key), allowed),
|
|
163
|
+
write: value => ({ [key]: value }),
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/** Те саме, але з дефолтом: він і читається замість сміття, і не пишеться. */
|
|
168
|
+
static oneOfOr<T extends string>(key: string, allowed: readonly T[], fallback: T): UrlCodec<T> {
|
|
169
|
+
return {
|
|
170
|
+
read: params => UrlParamsHelper.oneOf(params.get(key), allowed) ?? fallback,
|
|
171
|
+
write: value => ({ [key]: value === fallback ? null : value }),
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
static manyOf<T extends string>(key: string, allowed: readonly T[]): UrlCodec<T[]> {
|
|
176
|
+
return {
|
|
177
|
+
read: params => UrlParamsHelper.manyOf(params.getList(key), allowed),
|
|
178
|
+
write: value => ({ [key]: value.length > 0 ? value.join(',') : null }),
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* Те саме з дефолтом: немає ключа — дефолт, і дефолт не пишеться. Порожній
|
|
184
|
+
* вибір пишеться явним `any`, інакше після перезавантаження він став би
|
|
185
|
+
* дефолтом, а не «будь-який».
|
|
186
|
+
*/
|
|
187
|
+
static manyOfOr<T extends string>(key: string, allowed: readonly T[], fallback: readonly T[]): UrlCodec<T[]> {
|
|
188
|
+
const isFallback = (value: readonly T[]) =>
|
|
189
|
+
value.length === fallback.length && value.every(item => fallback.includes(item))
|
|
190
|
+
|
|
191
|
+
return {
|
|
192
|
+
read: (params) => {
|
|
193
|
+
const raw = params.get(key)
|
|
194
|
+
if (raw === null) return [...fallback]
|
|
195
|
+
if (raw === 'any') return []
|
|
196
|
+
|
|
197
|
+
return UrlParamsHelper.manyOf(params.getList(key), allowed)
|
|
198
|
+
},
|
|
199
|
+
write: value => ({ [key]: isFallback(value) ? null : value.length > 0 ? value.join(',') : 'any' }),
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
/** Список доменних id: перевіряємо форму, бо білого списку в нас немає. */
|
|
204
|
+
static ulids(key: string): UrlCodec<string[]> {
|
|
205
|
+
return {
|
|
206
|
+
read: params => UrlParamsHelper.ulids(params.getList(key)),
|
|
207
|
+
write: value => ({ [key]: value.length > 0 ? value.join(',') : null }),
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
/** Список як є — коли значення перевіряє вже сам бек. */
|
|
212
|
+
static list(key: string): UrlCodec<string[]> {
|
|
213
|
+
return {
|
|
214
|
+
read: params => params.getList(key),
|
|
215
|
+
write: value => ({ [key]: value.length > 0 ? value.join(',') : null }),
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
static flag(key: string): UrlCodec<boolean> {
|
|
220
|
+
return {
|
|
221
|
+
read: params => UrlParamsHelper.flag(params.get(key)),
|
|
222
|
+
write: value => ({ [key]: UrlParamsHelper.writeFlag(value) }),
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
static triState(key: string): UrlCodec<boolean | null> {
|
|
227
|
+
return {
|
|
228
|
+
read: params => UrlParamsHelper.triState(params.get(key)),
|
|
229
|
+
write: value => ({ [key]: UrlParamsHelper.writeTriState(value) }),
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
static sortDirection(key: string): UrlCodec<SortDirection | null> {
|
|
234
|
+
return {
|
|
235
|
+
read: params => UrlParamsHelper.sortDirection(params.get(key)),
|
|
236
|
+
write: value => ({ [key]: value }),
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
static page(key = 'page'): UrlCodec<number> {
|
|
241
|
+
return {
|
|
242
|
+
read: params => UrlParamsHelper.page(params.get(key)),
|
|
243
|
+
write: value => ({ [key]: UrlParamsHelper.writePage(value) }),
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
/**
|
|
248
|
+
* Стек мультисортування одним ключем: `sort=payable:desc,full_name:asc`.
|
|
249
|
+
*
|
|
250
|
+
* Список, а не мапа: порядок ключів = пріоритет, і в адресі він має бути
|
|
251
|
+
* видно. Пара `sort_by`/`sort_dir` двох сортувань не виражає взагалі.
|
|
252
|
+
*
|
|
253
|
+
* Відсіюємо все, що бек поверне 422: невідомий ключ (перейменували колонку),
|
|
254
|
+
* кривий напрямок, дубль того самого ключа (TanStack його не втримає).
|
|
255
|
+
*/
|
|
256
|
+
static sortList<T extends string>(
|
|
257
|
+
key: string,
|
|
258
|
+
allowed: readonly T[],
|
|
259
|
+
): UrlCodec<Array<ServerSortEntry<T>>> {
|
|
260
|
+
return {
|
|
261
|
+
read: (params) => {
|
|
262
|
+
const raw = params.get(key)
|
|
263
|
+
if (!raw) return []
|
|
264
|
+
|
|
265
|
+
const seen = new Set<T>()
|
|
266
|
+
|
|
267
|
+
return raw.split(',').reduce<Array<ServerSortEntry<T>>>((acc, chunk) => {
|
|
268
|
+
const [by, direction] = chunk.split(':') as [T, SortDirection]
|
|
269
|
+
|
|
270
|
+
if (!allowed.includes(by)) return acc
|
|
271
|
+
if (direction !== 'asc' && direction !== 'desc') return acc
|
|
272
|
+
if (seen.has(by)) return acc
|
|
273
|
+
|
|
274
|
+
seen.add(by)
|
|
275
|
+
acc.push({ by, direction })
|
|
276
|
+
|
|
277
|
+
return acc
|
|
278
|
+
}, [])
|
|
279
|
+
},
|
|
280
|
+
write: value => ({
|
|
281
|
+
[key]: value.length > 0 ? value.map(e => `${e.by}:${e.direction}`).join(',') : null,
|
|
282
|
+
}),
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
|
|
286
|
+
/**
|
|
287
|
+
* Кодек зі своїм розбором — для ключів, які не лягають на готові: список
|
|
288
|
+
* `key:dir` у «Звітах», пара «менеджери або нічиї» під одним ключем.
|
|
289
|
+
*
|
|
290
|
+
* Функція-тотожність, і в цьому суть: вона змушує написати читання й запис
|
|
291
|
+
* поруч, замість двох шматків у різних кінцях файлу.
|
|
292
|
+
*/
|
|
293
|
+
static custom<T>(codec: UrlCodec<T>): UrlCodec<T> {
|
|
294
|
+
return codec
|
|
295
|
+
}
|
|
296
|
+
}
|