@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
package/src/config.ts CHANGED
@@ -1,155 +1,156 @@
1
- // Ядро не знает языка и форматов проекта: тексты, числа и реакцию на сбой
2
- // проект передаёт один раз при старте — `SharedConfig.configure(...)` до монтирования.
3
-
4
- import type { Component } from 'vue'
5
- import type { ApiProblemEntry } from './api/errors/apiProblem'
6
-
7
- export type SharedLabels = {
8
- close: string
9
- clear: string
10
- expandRow: string
11
- collapseRow: string
12
- /** Подсказка на ячейке раскрытия: как раскрыть все строки разом. */
13
- toggleRowHint: string
14
- dateFrom: string
15
- dateTo: string
16
- fileDrop: string
17
- fileRemove: string
18
- /** Пустое обязательное поле (zod: undefined / null). */
19
- required: string
20
- /** «Сторінка 2 з 9»: номер страницы ядро выделяет само, поэтому две части. */
21
- pagerPage: string
22
- pagerOf: string
23
- /** Общее количество со словом в нужной форме: «1 482 записи». */
24
- pagerRows: (count: number) => string
25
- /** Пункт выбора размера страницы: «25 / стор.». */
26
- perPage: (size: number) => string
27
- /** Подписи для читалки экрана: стрелки и выбор размера страницы — без текста. */
28
- pagerPrev: string
29
- pagerNext: string
30
- pagerPerPage: string
31
- /** Удалённый список фильтра (`FilterSelect` с `fetchPage`): загрузка, сбой, повтор, ещё. */
32
- loading: string
33
- loadFailed: string
34
- retry: string
35
- loadMore: string
36
- /** Кнопка «глазик» у поля пароля (`PasswordReveal`). */
37
- showPassword: string
38
- hidePassword: string
39
- /** Спільні слова. */
40
- yes: string
41
- no: string
42
- cancel: string
43
- back: string
44
- apply: string
45
- /** Поле пошуку й пікер із серверним пошуком. */
46
- clearSearch: string
47
- searching: string
48
- searchTruncated: (shown: number, total: number) => string
49
- /** Таблиці: лічильники отримують уже відформатовані числа. */
50
- tableShown: (loaded: string, total: string) => string
51
- tableShownShort: (loaded: string) => string
52
- tableLoadingMore: string
53
- tableLoadFailed: string
54
- /** Рядок фільтрів. */
55
- resetFilters: string
56
- exportPreparing: string
57
- exportDone: (filename: string) => string
58
- exportTitle: (from: string, to: string, note?: string) => string
59
- /** Поле періоду. */
60
- allDates: string
61
- periodRemove: string
62
- periodWeeksOnly: string
63
- periodPickBoth: string
64
- /** Локаль `Intl` для підписів періоду: «2–8 лют. 2026». */
65
- dateLocale: string
66
- /** Суфікс року, який `formatRange` дописує в кінці («р.»), — компактний підпис без нього. */
67
- rangeYearSuffix: RegExp
68
- weekLabel: (week: number) => string
69
- weeksLabel: (first: number, last: number) => string
70
- periodPresets: {
71
- today: string
72
- yesterday: string
73
- thisWeek: string
74
- prevWeek: string
75
- last2Weeks: string
76
- last4Weeks: string
77
- thisMonth: string
78
- prevMonth: string
79
- thisQuarter: string
80
- prevQuarter: string
81
- thisYear: string
82
- prevYear: string
83
- last30Days: string
84
- last90Days: string
85
- }
86
- /** Місяці: дванадцять назв від січня, називний відмінок. */
87
- monthNames: readonly string[]
88
- monthShortNames: readonly string[]
89
- monthPlaceholder: string
90
- allMonths: string
91
- /** Сортування: підписи напрямків за родом значення й панель. */
92
- sortDirections: {
93
- numeric: Record<'asc' | 'desc', string>
94
- text: Record<'asc' | 'desc', string>
95
- date: Record<'asc' | 'desc', string>
96
- group: Record<'asc' | 'desc', string>
97
- }
98
- sortTitle: string
99
- sortEmpty: string
100
- sortEmptyShort: string
101
- sortReset: string
102
- sortRemove: string
103
- sortAdd: string
104
- }
105
-
106
- /** Тексти помилок API: логіка в `errors/apiError.helper`, слова й коди в проєкту. */
107
- export type SharedErrorTexts = {
108
- /** Код бека → текст або функція від `meta` цього коду. */
109
- codes: Record<string, string | ((meta: any) => string)>
110
- /** Запасний варіант, коли коду в словнику немає: за HTTP-статусом (0 — немає звʼязку). */
111
- byStatus: Record<number, string>
112
- serverError: string
113
- timeout: string
114
- fallback: string
115
- /** Текст запису валідації за його правилом (`meta.rule`). */
116
- rule: (entry: ApiProblemEntry) => string
117
- /** Показувати `detail` людині, коли коду немає: для бека, що ще не на кодах. За замовчуванням ні. */
118
- showDetail?: boolean
119
- /** Своє правило «поле бека → поле форми» понад точний збіг, camelCase і `map`. */
120
- resolveField?: (path: string, fields: readonly string[]) => string | undefined
121
- /** Яких полів стосується запис, якщо не лише `entry.field` (код, що каже про кілька полів у `meta`). */
122
- fieldsOf?: (entry: ApiProblemEntry) => readonly string[]
123
- }
124
-
125
- export type SharedConfigValue = {
126
- labels: SharedLabels
127
- formatNumber: (value: number) => string
128
- formatMoney: (value: number) => string
129
- /** Тексти помилок API. */
130
- errors: SharedErrorTexts
131
- /**
132
- * Показати помилку людині: тост, стор сповіщень. `id` склеює однакові,
133
- * `isSessionExpired` — привід дати дію «Увійти».
134
- */
135
- notifyError: (text: string, context: { id: string; isSessionExpired: boolean }) => void
136
- /** Посилання для `UiButton`: `RouterLink` + `to` чи Inertia `Link` + `href`. */
137
- link: { component: Component; prop: string }
138
- /** «Назад» у `UiBackLink`: по історії, а якщо її немає — на `fallback`. Роутер знає проєкт. */
139
- goBack: (fallback: string | object) => void
140
- /** Сбой, который ядро уже показало на месте (список фильтра): только в трекинг. */
141
- reportError?: (error: unknown) => void
142
- }
143
-
144
- let current: SharedConfigValue | null = null
145
-
146
- export const SharedConfig = {
147
- configure(value: SharedConfigValue): void {
148
- current = value
149
- },
150
- get(): SharedConfigValue {
151
- // Без конфига ядро молча показало бы пустые подписи — лучше упасть сразу.
152
- if (!current) throw new Error('SharedConfig.configure() must be called before using _shared')
153
- return current
154
- },
155
- }
1
+ // Ядро не знает языка и форматов проекта: тексты, числа и реакцию на сбой
2
+ // проект передаёт один раз при старте — `SharedConfig.configure(...)` до монтирования.
3
+
4
+ import type { Component } from 'vue'
5
+ import type { Period } from './helpers/period.helper'
6
+ import type { ApiProblemEntry } from './api/errors/apiProblem'
7
+
8
+ export type SharedLabels = {
9
+ close: string
10
+ clear: string
11
+ expandRow: string
12
+ collapseRow: string
13
+ /** Подсказка на ячейке раскрытия: как раскрыть все строки разом. */
14
+ toggleRowHint: string
15
+ dateFrom: string
16
+ dateTo: string
17
+ fileDrop: string
18
+ fileRemove: string
19
+ /** Пустое обязательное поле (zod: undefined / null). */
20
+ required: string
21
+ /** «Сторінка 2 з 9»: номер страницы ядро выделяет само, поэтому две части. */
22
+ pagerPage: string
23
+ pagerOf: string
24
+ /** Общее количество со словом в нужной форме: «1 482 записи». */
25
+ pagerRows: (count: number) => string
26
+ /** Пункт выбора размера страницы: «25 / стор.». */
27
+ perPage: (size: number) => string
28
+ /** Подписи для читалки экрана: стрелки и выбор размера страницы — без текста. */
29
+ pagerPrev: string
30
+ pagerNext: string
31
+ pagerPerPage: string
32
+ /** Удалённый список фильтра (`FilterSelect` с `fetchPage`): загрузка, сбой, повтор, ещё. */
33
+ loading: string
34
+ loadFailed: string
35
+ retry: string
36
+ loadMore: string
37
+ /** Кнопка «глазик» у поля пароля (`PasswordReveal`). */
38
+ showPassword: string
39
+ hidePassword: string
40
+ /** Спільні слова. */
41
+ yes: string
42
+ no: string
43
+ cancel: string
44
+ back: string
45
+ apply: string
46
+ /** Поле пошуку й пікер із серверним пошуком. */
47
+ clearSearch: string
48
+ searching: string
49
+ searchTruncated: (shown: number, total: number) => string
50
+ /** Таблиці: лічильники отримують уже відформатовані числа. */
51
+ tableShown: (loaded: string, total: string) => string
52
+ tableShownShort: (loaded: string) => string
53
+ tableLoadingMore: string
54
+ tableLoadFailed: string
55
+ /** Рядок фільтрів. */
56
+ resetFilters: string
57
+ exportPreparing: string
58
+ exportDone: (filename: string) => string
59
+ exportTitle: (format: string, period?: Period, note?: string) => string
60
+ /** Поле періоду. */
61
+ allDates: string
62
+ periodRemove: string
63
+ periodWeeksOnly: string
64
+ periodPickBoth: string
65
+ /** Локаль `Intl` для підписів періоду: «2–8 лют. 2026». */
66
+ dateLocale: string
67
+ /** Суфікс року, який `formatRange` дописує в кінці («р.»), — компактний підпис без нього. */
68
+ rangeYearSuffix: RegExp
69
+ weekLabel: (week: number) => string
70
+ weeksLabel: (first: number, last: number) => string
71
+ periodPresets: {
72
+ today: string
73
+ yesterday: string
74
+ thisWeek: string
75
+ prevWeek: string
76
+ last2Weeks: string
77
+ last4Weeks: string
78
+ thisMonth: string
79
+ prevMonth: string
80
+ thisQuarter: string
81
+ prevQuarter: string
82
+ thisYear: string
83
+ prevYear: string
84
+ last30Days: string
85
+ last90Days: string
86
+ }
87
+ /** Місяці: дванадцять назв від січня, називний відмінок. */
88
+ monthNames: readonly string[]
89
+ monthShortNames: readonly string[]
90
+ monthPlaceholder: string
91
+ allMonths: string
92
+ /** Сортування: підписи напрямків за родом значення й панель. */
93
+ sortDirections: {
94
+ numeric: Record<'asc' | 'desc', string>
95
+ text: Record<'asc' | 'desc', string>
96
+ date: Record<'asc' | 'desc', string>
97
+ group: Record<'asc' | 'desc', string>
98
+ }
99
+ sortTitle: string
100
+ sortEmpty: string
101
+ sortEmptyShort: string
102
+ sortReset: string
103
+ sortRemove: string
104
+ sortAdd: string
105
+ }
106
+
107
+ /** Тексти помилок API: логіка в `errors/apiError.helper`, слова й коди в проєкту. */
108
+ export type SharedErrorTexts = {
109
+ /** Код бека → текст або функція від `meta` цього коду. */
110
+ codes: Record<string, string | ((meta: any) => string)>
111
+ /** Запасний варіант, коли коду в словнику немає: за HTTP-статусом (0 — немає звʼязку). */
112
+ byStatus: Record<number, string>
113
+ serverError: string
114
+ timeout: string
115
+ fallback: string
116
+ /** Текст запису валідації за його правилом (`meta.rule`). */
117
+ rule: (entry: ApiProblemEntry) => string
118
+ /** Показувати `detail` людині, коли коду немає: для бека, що ще не на кодах. За замовчуванням ні. */
119
+ showDetail?: boolean
120
+ /** Своє правило «поле бека → поле форми» понад точний збіг, camelCase і `map`. */
121
+ resolveField?: (path: string, fields: readonly string[]) => string | undefined
122
+ /** Яких полів стосується запис, якщо не лише `entry.field` (код, що каже про кілька полів у `meta`). */
123
+ fieldsOf?: (entry: ApiProblemEntry) => readonly string[]
124
+ }
125
+
126
+ export type SharedConfigValue = {
127
+ labels: SharedLabels
128
+ formatNumber: (value: number) => string
129
+ formatMoney: (value: number) => string
130
+ /** Тексти помилок API. */
131
+ errors: SharedErrorTexts
132
+ /**
133
+ * Показати помилку людині: тост, стор сповіщень. `id` склеює однакові,
134
+ * `isSessionExpired` — привід дати дію «Увійти».
135
+ */
136
+ notifyError: (text: string, context: { id: string; isSessionExpired: boolean }) => void
137
+ /** Посилання для `UiButton`: `RouterLink` + `to` чи Inertia `Link` + `href`. */
138
+ link: { component: Component; prop: string }
139
+ /** «Назад» у `UiBackLink`: по історії, а якщо її немає — на `fallback`. Роутер знає проєкт. */
140
+ goBack: (fallback: string | object) => void
141
+ /** Сбой, который ядро уже показало на месте (список фильтра): только в трекинг. */
142
+ reportError?: (error: unknown) => void
143
+ }
144
+
145
+ let current: SharedConfigValue | null = null
146
+
147
+ export const SharedConfig = {
148
+ configure(value: SharedConfigValue): void {
149
+ current = value
150
+ },
151
+ get(): SharedConfigValue {
152
+ // Без конфига ядро молча показало бы пустые подписи — лучше упасть сразу.
153
+ if (!current) throw new Error('SharedConfig.configure() must be called before using _shared')
154
+ return current
155
+ },
156
+ }
@@ -1,9 +1,9 @@
1
- // Дію скасувала людина (закрила діалог, без якого її не виконати). Це не помилка:
2
- // `useHandleError` і `useAppForm` мовчки її пропускають.
3
-
4
- export class ActionCancelledError extends Error {
5
- constructor() {
6
- super('Action cancelled by the user.')
7
- this.name = 'ActionCancelledError'
8
- }
9
- }
1
+ // Дію скасувала людина (закрила діалог, без якого її не виконати). Це не помилка:
2
+ // `useHandleError` і `useAppForm` мовчки її пропускають.
3
+
4
+ export class ActionCancelledError extends Error {
5
+ constructor() {
6
+ super('Action cancelled by the user.')
7
+ this.name = 'ActionCancelledError'
8
+ }
9
+ }