@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.
- 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 → ExportButton.vue} +62 -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/FilterCheckbox.vue +1 -1
- package/src/components/ui/FilterSelect.vue +2 -0
- 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 +144 -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/inputs/DateFormInput.vue +2 -2
- package/src/components/ui/inputs/FileInput.vue +5 -0
- package/src/components/ui/inputs/RadioSegmentFormInput.vue +0 -1
- package/src/components/ui/inputs/SelectFormInput.vue +1 -2
- package/src/components/ui/inputs/SmartField.vue +15 -13
- package/src/components/ui/inputs/TextareaFormInput.vue +2 -2
- 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 +19 -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 +156 -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,11 +1,11 @@
|
|
|
1
|
-
// Тони бейджа = пари «мʼяка підкладка + чорнило» з палітри.
|
|
2
|
-
//
|
|
3
|
-
// Окремим .ts, а не експортом з UiBadge.vue: гейт типів — plain `tsc`, для
|
|
4
|
-
// нього `*.vue` це заглушка без іменованих експортів (§9a CLAUDE.md).
|
|
5
|
-
export type UiBadgeTone =
|
|
6
|
-
| 'neutral' // норма / вимкнено / немає даних
|
|
7
|
-
| 'success' // схвалено, активно, наше
|
|
8
|
-
| 'danger' // відхилено, заблоковано, штраф
|
|
9
|
-
| 'warning' // чернетка, потребує уваги
|
|
10
|
-
| 'info' // очікує, у роботі
|
|
11
|
-
| 'done' // виплачено, звірено — гроші пішли далі
|
|
1
|
+
// Тони бейджа = пари «мʼяка підкладка + чорнило» з палітри.
|
|
2
|
+
//
|
|
3
|
+
// Окремим .ts, а не експортом з UiBadge.vue: гейт типів — plain `tsc`, для
|
|
4
|
+
// нього `*.vue` це заглушка без іменованих експортів (§9a CLAUDE.md).
|
|
5
|
+
export type UiBadgeTone =
|
|
6
|
+
| 'neutral' // норма / вимкнено / немає даних
|
|
7
|
+
| 'success' // схвалено, активно, наше
|
|
8
|
+
| 'danger' // відхилено, заблоковано, штраф
|
|
9
|
+
| 'warning' // чернетка, потребує уваги
|
|
10
|
+
| 'info' // очікує, у роботі
|
|
11
|
+
| 'done' // виплачено, звірено — гроші пішли далі
|
|
@@ -1,17 +1,19 @@
|
|
|
1
|
-
// Модель картки KPI. Окремим .ts, а не експортом з .vue: гейт типів — plain
|
|
2
|
-
// `tsc`, для нього `*.vue` це заглушка без іменованих експортів (§9a).
|
|
3
|
-
|
|
4
|
-
import type { Component } from 'vue'
|
|
5
|
-
|
|
6
|
-
export type UiKpiTone = 'positive' | 'negative' | 'muted'
|
|
7
|
-
|
|
8
|
-
export interface UiKpiCardItem {
|
|
9
|
-
key: string
|
|
10
|
-
icon: Component
|
|
11
|
-
label: string
|
|
12
|
-
/**
|
|
13
|
-
|
|
14
|
-
/**
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
1
|
+
// Модель картки KPI. Окремим .ts, а не експортом з .vue: гейт типів — plain
|
|
2
|
+
// `tsc`, для нього `*.vue` це заглушка без іменованих експортів (§9a).
|
|
3
|
+
|
|
4
|
+
import type { Component } from 'vue'
|
|
5
|
+
|
|
6
|
+
export type UiKpiTone = 'positive' | 'negative' | 'muted'
|
|
7
|
+
|
|
8
|
+
export interface UiKpiCardItem {
|
|
9
|
+
key: string
|
|
10
|
+
icon: Component
|
|
11
|
+
label: string
|
|
12
|
+
/** Підказка при наведенні на підпис: пояснює те, що в ньому скорочено. */
|
|
13
|
+
labelHint?: string
|
|
14
|
+
/** null = даних ще нема → замість числа скелетон. */
|
|
15
|
+
value: string | null
|
|
16
|
+
/** Дрібна приписка праворуч від значення через крапку (напр. частка палива «12,3%»). */
|
|
17
|
+
note?: string
|
|
18
|
+
tone?: UiKpiTone
|
|
19
|
+
}
|
|
@@ -1,67 +1,67 @@
|
|
|
1
|
-
// Форма проєкту: `useMyForm` + одна політика помилок сабміту.
|
|
2
|
-
//
|
|
3
|
-
// Колбек `handleSubmit` описує лише успішний шлях. Відмову бека віддаємо формі
|
|
4
|
-
// (422 → поля), текст уже показав onError мутації, а вікно лишається відкритим
|
|
5
|
-
// з набраним. Політика тут, а не try/catch у кожній модалці: там закрити вікно
|
|
6
|
-
// на помилці було одним рядком — і так губили введене.
|
|
7
|
-
|
|
8
|
-
import { useFieldArray } from 'vee-validate'
|
|
9
|
-
import type { z } from 'zod'
|
|
10
|
-
import { AppError } from '../api/errors'
|
|
11
|
-
import { useMyForm, type UseMyFormConfig } from './useMyForm'
|
|
12
|
-
import type { PathInto } from '../helpers/form.helper'
|
|
13
|
-
import { ActionCancelledError } from '../errors/actionCancelled'
|
|
14
|
-
import { ApiErrorHelper } from '../errors/apiError.helper'
|
|
15
|
-
|
|
16
|
-
interface ErrorPaths {
|
|
17
|
-
/** Поле бека → поле форми, лише для змістовних перейменувань (`payment_date` → «Дата»). */
|
|
18
|
-
map?: Record<string, string>
|
|
19
|
-
/** Поля форми, коли їх більше, ніж ключів схеми (рядки шкали `tiers[0].rate`). */
|
|
20
|
-
fieldPaths?: readonly string[]
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
type AppFormConfig<T extends z.ZodTypeAny> = UseMyFormConfig<T> & {
|
|
24
|
-
/** Рахується в момент помилки: шляхи можуть залежати від набраного. */
|
|
25
|
-
errorPaths?: (fNames: PathInto<T>, values: z.infer<T>) => ErrorPaths
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
export function useAppForm<T extends z.ZodTypeAny>(schema: T, config: AppFormConfig<T>) {
|
|
29
|
-
const { errorPaths, ...formConfig } = config
|
|
30
|
-
const { handleSubmit: vvHandleSubmit, ...form } = useMyForm(schema, formConfig)
|
|
31
|
-
|
|
32
|
-
/** Віддати помилку формі — для сабміту, що ловить її сам (повтор, плитки чеків). */
|
|
33
|
-
function showError(error: unknown): void {
|
|
34
|
-
// Скасування (закрили діалог, без якого дію не виконати) — тихо стоїмо.
|
|
35
|
-
if (error instanceof ActionCancelledError) return
|
|
36
|
-
// Не відповідь бека — баг у нашому коді: не ковтаємо, хай дійде до консолі.
|
|
37
|
-
if (!(error instanceof AppError)) throw error
|
|
38
|
-
|
|
39
|
-
const paths = errorPaths?.(form.fNames, form.values) ?? {}
|
|
40
|
-
|
|
41
|
-
ApiErrorHelper.applyToForm(
|
|
42
|
-
error,
|
|
43
|
-
{ setErrors: form.setErrors, fieldPaths: paths.fieldPaths ?? form.fieldPaths },
|
|
44
|
-
paths.map,
|
|
45
|
-
)
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
function handleSubmit(fn: (values: z.infer<T>) => Promise<unknown>) {
|
|
49
|
-
const run = vvHandleSubmit(async (values) => {
|
|
50
|
-
try {
|
|
51
|
-
await fn(values)
|
|
52
|
-
} catch (error) {
|
|
53
|
-
showError(error)
|
|
54
|
-
}
|
|
55
|
-
})
|
|
56
|
-
|
|
57
|
-
// Повторний Enter, поки йде перший запит, не шле другий.
|
|
58
|
-
return (event?: Event) => (form.isSubmitting.value ? Promise.resolve() : run(event))
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
return { ...form, handleSubmit, showError }
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
/** Повторюваний блок полів форми (інтервали дня, рядки чека). */
|
|
65
|
-
export function useAppFieldArray<TValue>(path: string) {
|
|
66
|
-
return useFieldArray<TValue>(path)
|
|
67
|
-
}
|
|
1
|
+
// Форма проєкту: `useMyForm` + одна політика помилок сабміту.
|
|
2
|
+
//
|
|
3
|
+
// Колбек `handleSubmit` описує лише успішний шлях. Відмову бека віддаємо формі
|
|
4
|
+
// (422 → поля), текст уже показав onError мутації, а вікно лишається відкритим
|
|
5
|
+
// з набраним. Політика тут, а не try/catch у кожній модалці: там закрити вікно
|
|
6
|
+
// на помилці було одним рядком — і так губили введене.
|
|
7
|
+
|
|
8
|
+
import { useFieldArray } from 'vee-validate'
|
|
9
|
+
import type { z } from 'zod'
|
|
10
|
+
import { AppError } from '../api/errors'
|
|
11
|
+
import { useMyForm, type UseMyFormConfig } from './useMyForm'
|
|
12
|
+
import type { PathInto } from '../helpers/form.helper'
|
|
13
|
+
import { ActionCancelledError } from '../errors/actionCancelled'
|
|
14
|
+
import { ApiErrorHelper } from '../errors/apiError.helper'
|
|
15
|
+
|
|
16
|
+
interface ErrorPaths {
|
|
17
|
+
/** Поле бека → поле форми, лише для змістовних перейменувань (`payment_date` → «Дата»). */
|
|
18
|
+
map?: Record<string, string>
|
|
19
|
+
/** Поля форми, коли їх більше, ніж ключів схеми (рядки шкали `tiers[0].rate`). */
|
|
20
|
+
fieldPaths?: readonly string[]
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
type AppFormConfig<T extends z.ZodTypeAny> = UseMyFormConfig<T> & {
|
|
24
|
+
/** Рахується в момент помилки: шляхи можуть залежати від набраного. */
|
|
25
|
+
errorPaths?: (fNames: PathInto<T>, values: z.infer<T>) => ErrorPaths
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export function useAppForm<T extends z.ZodTypeAny>(schema: T, config: AppFormConfig<T>) {
|
|
29
|
+
const { errorPaths, ...formConfig } = config
|
|
30
|
+
const { handleSubmit: vvHandleSubmit, ...form } = useMyForm(schema, formConfig)
|
|
31
|
+
|
|
32
|
+
/** Віддати помилку формі — для сабміту, що ловить її сам (повтор, плитки чеків). */
|
|
33
|
+
function showError(error: unknown): void {
|
|
34
|
+
// Скасування (закрили діалог, без якого дію не виконати) — тихо стоїмо.
|
|
35
|
+
if (error instanceof ActionCancelledError) return
|
|
36
|
+
// Не відповідь бека — баг у нашому коді: не ковтаємо, хай дійде до консолі.
|
|
37
|
+
if (!(error instanceof AppError)) throw error
|
|
38
|
+
|
|
39
|
+
const paths = errorPaths?.(form.fNames, form.values) ?? {}
|
|
40
|
+
|
|
41
|
+
ApiErrorHelper.applyToForm(
|
|
42
|
+
error,
|
|
43
|
+
{ setErrors: form.setErrors, fieldPaths: paths.fieldPaths ?? form.fieldPaths },
|
|
44
|
+
paths.map,
|
|
45
|
+
)
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
function handleSubmit(fn: (values: z.infer<T>) => Promise<unknown>) {
|
|
49
|
+
const run = vvHandleSubmit(async (values) => {
|
|
50
|
+
try {
|
|
51
|
+
await fn(values)
|
|
52
|
+
} catch (error) {
|
|
53
|
+
showError(error)
|
|
54
|
+
}
|
|
55
|
+
})
|
|
56
|
+
|
|
57
|
+
// Повторний Enter, поки йде перший запит, не шле другий.
|
|
58
|
+
return (event?: Event) => (form.isSubmitting.value ? Promise.resolve() : run(event))
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
return { ...form, handleSubmit, showError }
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/** Повторюваний блок полів форми (інтервали дня, рядки чека). */
|
|
65
|
+
export function useAppFieldArray<TValue>(path: string) {
|
|
66
|
+
return useFieldArray<TValue>(path)
|
|
67
|
+
}
|
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
// Підтвердження дії модалкою: `if (!(await confirm({ … }))) return`.
|
|
2
|
-
// Закрили хрестиком чи Esc — це «ні», а не undefined.
|
|
3
|
-
|
|
4
|
-
import type { ModalService } from '../plugins/modals.plugin'
|
|
5
|
-
|
|
6
|
-
export interface ConfirmOptions {
|
|
7
|
-
/** Питання: «Видалити платіж?» */
|
|
8
|
-
title: string
|
|
9
|
-
/** Наслідки, якщо вони неочевидні. Абзаци — через порожній рядок. */
|
|
10
|
-
text?: string
|
|
11
|
-
/** Слово дії на кнопці: «Видалити», «Зняти». За замовчуванням «Так». */
|
|
12
|
-
confirmText?: string
|
|
13
|
-
/** Незворотна дія — червона кнопка. */
|
|
14
|
-
isDanger?: boolean
|
|
15
|
-
}
|
|
16
|
-
|
|
17
|
-
/** Сервіс модалок дає проєкт: у кого він через inject, у кого модулем. Ключ `confirm` у реєстрі — ConfirmModal. */
|
|
18
|
-
export function useConfirm(modals: ModalService<any>) {
|
|
19
|
-
return async (options: ConfirmOptions): Promise<boolean> =>
|
|
20
|
-
(await modals.show('confirm', { props: options }).wait) === true
|
|
21
|
-
}
|
|
1
|
+
// Підтвердження дії модалкою: `if (!(await confirm({ … }))) return`.
|
|
2
|
+
// Закрили хрестиком чи Esc — це «ні», а не undefined.
|
|
3
|
+
|
|
4
|
+
import type { ModalService } from '../plugins/modals.plugin'
|
|
5
|
+
|
|
6
|
+
export interface ConfirmOptions {
|
|
7
|
+
/** Питання: «Видалити платіж?» */
|
|
8
|
+
title: string
|
|
9
|
+
/** Наслідки, якщо вони неочевидні. Абзаци — через порожній рядок. */
|
|
10
|
+
text?: string
|
|
11
|
+
/** Слово дії на кнопці: «Видалити», «Зняти». За замовчуванням «Так». */
|
|
12
|
+
confirmText?: string
|
|
13
|
+
/** Незворотна дія — червона кнопка. */
|
|
14
|
+
isDanger?: boolean
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
/** Сервіс модалок дає проєкт: у кого він через inject, у кого модулем. Ключ `confirm` у реєстрі — ConfirmModal. */
|
|
18
|
+
export function useConfirm(modals: ModalService<any>) {
|
|
19
|
+
return async (options: ConfirmOptions): Promise<boolean> =>
|
|
20
|
+
(await modals.show('confirm', { props: options }).wait) === true
|
|
21
|
+
}
|
|
@@ -1,70 +1,70 @@
|
|
|
1
|
-
// Примітиви фільтрів стора: дебаунснутий текст і пара сортування.
|
|
2
|
-
// Живуть тут, бо їх чекає useServerTable — форма має збігатися.
|
|
3
|
-
|
|
4
|
-
import { watchDebounced } from '@vueuse/core'
|
|
5
|
-
import { ref, type Ref } from 'vue'
|
|
6
|
-
import { SEARCH_DEBOUNCE_MS } from '../lib/timings'
|
|
7
|
-
import type { SortDirection } from './useServerTable'
|
|
8
|
-
|
|
9
|
-
/**
|
|
10
|
-
* Текстовий фільтр «draft → committed»: `draft` пише UI миттєво, `committed`
|
|
11
|
-
* відстає на дебаунс і йде в queryKey. Draft тримаємо в сторі, а не в
|
|
12
|
-
* компоненті фільтрів, — інакше він губиться при перемонтуванні.
|
|
13
|
-
*
|
|
14
|
-
* `normalize` застосовується до committed, не до draft: користувач бачить те,
|
|
15
|
-
* що набрав, а на бек їде причесане (номер авто без пробілів тощо).
|
|
16
|
-
*/
|
|
17
|
-
export function useDebouncedFilter(
|
|
18
|
-
initial: string,
|
|
19
|
-
normalize?: (raw: string) => string,
|
|
20
|
-
): { committed: Ref<string>; draft: Ref<string> } {
|
|
21
|
-
const apply = (raw: string) => (normalize ? normalize(raw) : raw)
|
|
22
|
-
|
|
23
|
-
const draft = ref(initial)
|
|
24
|
-
const committed = ref(apply(initial))
|
|
25
|
-
watchDebounced(draft, raw => { committed.value = apply(raw) }, { debounce: SEARCH_DEBOUNCE_MS })
|
|
26
|
-
|
|
27
|
-
return { committed, draft }
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
/** Пара sortBy/sortDirection + setSort — рівно те, що споживає useServerTable. */
|
|
31
|
-
export function useSortState<TSortBy extends string>(
|
|
32
|
-
initialBy: TSortBy | null,
|
|
33
|
-
initialDirection: SortDirection | null,
|
|
34
|
-
) {
|
|
35
|
-
const sortBy = ref(initialBy) as Ref<TSortBy | null>
|
|
36
|
-
const sortDirection = ref(initialDirection) as Ref<SortDirection | null>
|
|
37
|
-
|
|
38
|
-
// by=null (скидання кліком у TanStack) знімає й напрямок, інакше в URL
|
|
39
|
-
// лишається sort_dir без sort_by.
|
|
40
|
-
function setSort(by: TSortBy | null, dir: SortDirection | null = 'asc'): void {
|
|
41
|
-
sortBy.value = by
|
|
42
|
-
sortDirection.value = by ? dir : null
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
return { sortBy, sortDirection, setSort }
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
/**
|
|
49
|
-
* Пара «менеджери / без менеджера». Взаємовиключна: бек складає фільтри через
|
|
50
|
-
* AND, тож «водії Влада» + «нічиї» дали б завжди порожню таблицю. Правило було
|
|
51
|
-
* скопійоване в чотири стори — сюди його, щоб не тримати чотири шанси забути.
|
|
52
|
-
*/
|
|
53
|
-
export function useManagerFilter(initialIds: string[] = [], initialWithout = false) {
|
|
54
|
-
// Адреса з обома (`manager_id=…&without_manager=1`) дала б 422 від бека:
|
|
55
|
-
// «без менеджера» перекриває, як і в сеттері.
|
|
56
|
-
const managerIds = ref<string[]>(initialWithout ? [] : initialIds)
|
|
57
|
-
const isWithoutManager = ref(initialWithout)
|
|
58
|
-
|
|
59
|
-
function setManagerIds(next: string[]): void {
|
|
60
|
-
managerIds.value = next
|
|
61
|
-
if (next.length > 0) isWithoutManager.value = false
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
function setWithoutManager(next: boolean): void {
|
|
65
|
-
isWithoutManager.value = next
|
|
66
|
-
if (next) managerIds.value = []
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
return { managerIds, isWithoutManager, setManagerIds, setWithoutManager }
|
|
70
|
-
}
|
|
1
|
+
// Примітиви фільтрів стора: дебаунснутий текст і пара сортування.
|
|
2
|
+
// Живуть тут, бо їх чекає useServerTable — форма має збігатися.
|
|
3
|
+
|
|
4
|
+
import { watchDebounced } from '@vueuse/core'
|
|
5
|
+
import { ref, type Ref } from 'vue'
|
|
6
|
+
import { SEARCH_DEBOUNCE_MS } from '../lib/timings'
|
|
7
|
+
import type { SortDirection } from './useServerTable'
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Текстовий фільтр «draft → committed»: `draft` пише UI миттєво, `committed`
|
|
11
|
+
* відстає на дебаунс і йде в queryKey. Draft тримаємо в сторі, а не в
|
|
12
|
+
* компоненті фільтрів, — інакше він губиться при перемонтуванні.
|
|
13
|
+
*
|
|
14
|
+
* `normalize` застосовується до committed, не до draft: користувач бачить те,
|
|
15
|
+
* що набрав, а на бек їде причесане (номер авто без пробілів тощо).
|
|
16
|
+
*/
|
|
17
|
+
export function useDebouncedFilter(
|
|
18
|
+
initial: string,
|
|
19
|
+
normalize?: (raw: string) => string,
|
|
20
|
+
): { committed: Ref<string>; draft: Ref<string> } {
|
|
21
|
+
const apply = (raw: string) => (normalize ? normalize(raw) : raw)
|
|
22
|
+
|
|
23
|
+
const draft = ref(initial)
|
|
24
|
+
const committed = ref(apply(initial))
|
|
25
|
+
watchDebounced(draft, raw => { committed.value = apply(raw) }, { debounce: SEARCH_DEBOUNCE_MS })
|
|
26
|
+
|
|
27
|
+
return { committed, draft }
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Пара sortBy/sortDirection + setSort — рівно те, що споживає useServerTable. */
|
|
31
|
+
export function useSortState<TSortBy extends string>(
|
|
32
|
+
initialBy: TSortBy | null,
|
|
33
|
+
initialDirection: SortDirection | null,
|
|
34
|
+
) {
|
|
35
|
+
const sortBy = ref(initialBy) as Ref<TSortBy | null>
|
|
36
|
+
const sortDirection = ref(initialDirection) as Ref<SortDirection | null>
|
|
37
|
+
|
|
38
|
+
// by=null (скидання кліком у TanStack) знімає й напрямок, інакше в URL
|
|
39
|
+
// лишається sort_dir без sort_by.
|
|
40
|
+
function setSort(by: TSortBy | null, dir: SortDirection | null = 'asc'): void {
|
|
41
|
+
sortBy.value = by
|
|
42
|
+
sortDirection.value = by ? dir : null
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
return { sortBy, sortDirection, setSort }
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* Пара «менеджери / без менеджера». Взаємовиключна: бек складає фільтри через
|
|
50
|
+
* AND, тож «водії Влада» + «нічиї» дали б завжди порожню таблицю. Правило було
|
|
51
|
+
* скопійоване в чотири стори — сюди його, щоб не тримати чотири шанси забути.
|
|
52
|
+
*/
|
|
53
|
+
export function useManagerFilter(initialIds: string[] = [], initialWithout = false) {
|
|
54
|
+
// Адреса з обома (`manager_id=…&without_manager=1`) дала б 422 від бека:
|
|
55
|
+
// «без менеджера» перекриває, як і в сеттері.
|
|
56
|
+
const managerIds = ref<string[]>(initialWithout ? [] : initialIds)
|
|
57
|
+
const isWithoutManager = ref(initialWithout)
|
|
58
|
+
|
|
59
|
+
function setManagerIds(next: string[]): void {
|
|
60
|
+
managerIds.value = next
|
|
61
|
+
if (next.length > 0) isWithoutManager.value = false
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function setWithoutManager(next: boolean): void {
|
|
65
|
+
isWithoutManager.value = next
|
|
66
|
+
if (next) managerIds.value = []
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
return { managerIds, isWithoutManager, setManagerIds, setWithoutManager }
|
|
70
|
+
}
|