@rock555/frontend-core 2.0.2 → 3.0.0

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