@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.
- 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 +60 -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/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 +142 -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/uiActionTiles.types.ts +10 -10
- package/src/components/ui/uiBadge.types.ts +11 -11
- package/src/components/ui/uiKpi.types.ts +17 -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 +155 -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
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
|
+
}
|