@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
package/src/config.ts CHANGED
@@ -1,155 +1,155 @@
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 { 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,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
+ }