@rock555/frontend-core 2.0.2 → 2.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/README.md +95 -95
  2. package/package.json +98 -98
  3. package/src/components/GlobalPendingBar.vue +85 -85
  4. package/src/components/SearchPicker.vue +84 -84
  5. package/src/components/filters/DateRangeField.vue +692 -692
  6. package/src/components/filters/ExportCsvButton.vue +60 -60
  7. package/src/components/filters/FiltersBar.vue +150 -150
  8. package/src/components/filters/MonthField.vue +309 -309
  9. package/src/components/filters/SortControl.vue +162 -162
  10. package/src/components/filters/SortControlPanel.vue +242 -242
  11. package/src/components/filters/sortControl.types.ts +25 -25
  12. package/src/components/modals/ConfirmModal.vue +58 -58
  13. package/src/components/modals/ImageViewerModal.vue +200 -200
  14. package/src/components/tables/MultiSortHeader.vue +126 -126
  15. package/src/components/tables/TableBodyRow.vue +62 -62
  16. package/src/components/tables/TableFooterRow.vue +54 -54
  17. package/src/components/tables/TableHeaderRow.vue +75 -75
  18. package/src/components/tables/TableLoadedCount.vue +61 -61
  19. package/src/components/tables/TableLoadedFooter.vue +44 -44
  20. package/src/components/tables/TableSkeletonRows.vue +40 -40
  21. package/src/components/tables/TableVirtualPad.vue +16 -16
  22. package/src/components/tables/cells/BoolBadgeCell.vue +32 -32
  23. package/src/components/tables/multiSortHeader.types.ts +16 -16
  24. package/src/components/ui/UiActionTiles.vue +92 -92
  25. package/src/components/ui/UiBackLink.vue +39 -39
  26. package/src/components/ui/UiBadge.vue +60 -60
  27. package/src/components/ui/UiButton.vue +126 -126
  28. package/src/components/ui/UiCard.vue +88 -88
  29. package/src/components/ui/UiCount.vue +35 -35
  30. package/src/components/ui/UiKpiGrid.vue +142 -142
  31. package/src/components/ui/UiPopover.vue +62 -62
  32. package/src/components/ui/UiSearchInput.vue +102 -102
  33. package/src/components/ui/UiSegmented.vue +145 -145
  34. package/src/components/ui/UiTableCard.vue +116 -116
  35. package/src/components/ui/uiActionTiles.types.ts +10 -10
  36. package/src/components/ui/uiBadge.types.ts +11 -11
  37. package/src/components/ui/uiKpi.types.ts +17 -17
  38. package/src/composables/useAppForm.ts +67 -67
  39. package/src/composables/useConfirm.ts +21 -21
  40. package/src/composables/useFilterState.ts +70 -70
  41. package/src/composables/useServerList.ts +348 -348
  42. package/src/composables/useServerTable.ts +117 -117
  43. package/src/composables/useSharedAsync.ts +51 -51
  44. package/src/composables/useVirtualTable.ts +77 -77
  45. package/src/config.ts +155 -155
  46. package/src/errors/actionCancelled.ts +9 -9
  47. package/src/errors/apiError.helper.ts +161 -161
  48. package/src/errors/useHandleError.ts +33 -33
  49. package/src/helpers/calendarRange.helper.ts +74 -74
  50. package/src/helpers/month.helper.ts +63 -63
  51. package/src/helpers/periodLabel.helper.ts +70 -70
  52. package/src/helpers/periodPresets.helper.ts +76 -76
  53. package/src/helpers/sort.helper.ts +57 -57
  54. package/src/helpers/tableFields.helper.ts +205 -205
  55. package/src/helpers/urlParams.helper.ts +99 -99
  56. package/src/helpers/urlSchema.helper.ts +296 -296
  57. package/src/plugins/modals.plugin.ts +253 -253
  58. package/src/plugins/table.plugin.ts +173 -173
@@ -1,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
+ }