@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,60 +1,60 @@
1
- <script setup lang="ts">
2
- // Кнопка вивантаження CSV у рядку фільтрів (слот #toolbar у FiltersBar).
3
- //
4
- // Тримає всю взаємодію разом: спінер, підпис із періодом і тост про хід справи.
5
- // Фіча дає лише «що запустити» — інакше кожна сторінка заводила б свій
6
- // toast.promise з тими самими текстами, і вони розходились би.
7
-
8
- import { Download, Loader2 } from '@lucide/vue'
9
- import { toast } from 'vue-sonner'
10
- import { SharedConfig } from '../../config'
11
- import type { Period } from '../../helpers/period.helper'
12
- import UiButton from '../ui/UiButton.vue'
13
-
14
- const labels = SharedConfig.get().labels
15
-
16
- const props = defineProps<{
17
- // Запускає вивантаження і віддає імʼя файла, під яким його збережено.
18
- run: () => Promise<string>
19
- isExporting: boolean
20
- // Тільки для підпису — щоб було видно, за що саме поїде файл.
21
- period: Period
22
- // Чим файл відрізняється від екрана, якщо відрізняється (напр. розріз).
23
- note?: string
24
- }>()
25
-
26
- // Один тост на весь шлях: вивантаження за великий період довге.
27
- //
28
- // `error` навмисно не заданий — помилку вже показує onError мутації, а без
29
- // цього ключа sonner просто прибирає тост замість того, щоб дублювати її другим.
30
- function exportCsv(): void {
31
- toast.promise(props.run(), {
32
- loading: labels.exportPreparing,
33
- success: (filename: string) => labels.exportDone(filename),
34
- })
35
- }
36
- </script>
37
-
38
- <template>
39
- <UiButton
40
- variant="ghost"
41
- size="sm"
42
- :disabled="isExporting"
43
- :title="labels.exportTitle(period.from, period.to, note)"
44
- @click="exportCsv"
45
- >
46
- <component
47
- :is="isExporting ? Loader2 : Download"
48
- :size="14"
49
- :class="{ 'export-csv__spin': isExporting }"
50
- />
51
- Export CSV
52
- </UiButton>
53
- </template>
54
-
55
- <style scoped lang="scss">
56
- // Слот-контент належить ЦЬОМУ компоненту, тож анімація живе тут, а не в
57
- // фільтрах, які його показують.
58
- .export-csv__spin { animation: export-csv-spin 1s linear infinite; }
59
- @keyframes export-csv-spin { to { transform: rotate(360deg); } }
60
- </style>
1
+ <script setup lang="ts">
2
+ // Кнопка вивантаження CSV у рядку фільтрів (слот #toolbar у FiltersBar).
3
+ //
4
+ // Тримає всю взаємодію разом: спінер, підпис із періодом і тост про хід справи.
5
+ // Фіча дає лише «що запустити» — інакше кожна сторінка заводила б свій
6
+ // toast.promise з тими самими текстами, і вони розходились би.
7
+
8
+ import { Download, Loader2 } from '@lucide/vue'
9
+ import { toast } from 'vue-sonner'
10
+ import { SharedConfig } from '../../config'
11
+ import type { Period } from '../../helpers/period.helper'
12
+ import UiButton from '../ui/UiButton.vue'
13
+
14
+ const labels = SharedConfig.get().labels
15
+
16
+ const props = defineProps<{
17
+ // Запускає вивантаження і віддає імʼя файла, під яким його збережено.
18
+ run: () => Promise<string>
19
+ isExporting: boolean
20
+ // Тільки для підпису — щоб було видно, за що саме поїде файл.
21
+ period: Period
22
+ // Чим файл відрізняється від екрана, якщо відрізняється (напр. розріз).
23
+ note?: string
24
+ }>()
25
+
26
+ // Один тост на весь шлях: вивантаження за великий період довге.
27
+ //
28
+ // `error` навмисно не заданий — помилку вже показує onError мутації, а без
29
+ // цього ключа sonner просто прибирає тост замість того, щоб дублювати її другим.
30
+ function exportCsv(): void {
31
+ toast.promise(props.run(), {
32
+ loading: labels.exportPreparing,
33
+ success: (filename: string) => labels.exportDone(filename),
34
+ })
35
+ }
36
+ </script>
37
+
38
+ <template>
39
+ <UiButton
40
+ variant="ghost"
41
+ size="sm"
42
+ :disabled="isExporting"
43
+ :title="labels.exportTitle(period.from, period.to, note)"
44
+ @click="exportCsv"
45
+ >
46
+ <component
47
+ :is="isExporting ? Loader2 : Download"
48
+ :size="14"
49
+ :class="{ 'export-csv__spin': isExporting }"
50
+ />
51
+ Export CSV
52
+ </UiButton>
53
+ </template>
54
+
55
+ <style scoped lang="scss">
56
+ // Слот-контент належить ЦЬОМУ компоненту, тож анімація живе тут, а не в
57
+ // фільтрах, які його показують.
58
+ .export-csv__spin { animation: export-csv-spin 1s linear infinite; }
59
+ @keyframes export-csv-spin { to { transform: rotate(360deg); } }
60
+ </style>
@@ -1,150 +1,150 @@
1
- <script setup lang="ts" generic="TPeriod extends Period | null = Period">
2
- // Базовый фильтр таблиц. Встроено: период (DateRangeField — поповер с календарём,
3
- // коммит только по «Застосувати») и опциональный поиск. Вариативное (чипы,
4
- // доп. кнопки) — слоты, период/поиск — через v-model.
5
- //
6
- // Кнопки «Оновити» тут нет: данные тянет vue-query, а руками их обновляют
7
- // перезагрузкой страницы — в ряду фильтров она только занимала место.
8
- //
9
- // mode периода: 'day' (по умолч.) — свободный диапазон; 'week' — прилипает к
10
- // целым неделям (для «Звітів»: агрегаторы точны только в рамках недели).
11
- //
12
- // «{{ SharedConfig.get().labels.resetFilters }}», а не «Очистити все»: те читалось як видалення списку.
13
- // Кнопка є, лише коли є що скидати; чистий стан і скидання знає стор списку
14
- // (useServerList) — з тієї ж схеми адреси, що й перше відкриття.
15
-
16
- import { FunnelX } from '@lucide/vue'
17
- import { computed } from 'vue'
18
- import { SharedConfig } from '../../config'
19
- import UiButton from '../ui/UiButton.vue'
20
- import type { Period } from '../../helpers/period.helper'
21
- import UiSearchInput from '../ui/UiSearchInput.vue'
22
- import DateRangeField from './DateRangeField.vue'
23
- import type { PeriodPresetGroups } from '../../helpers/periodPresets.helper'
24
- import type { ResettableFilters } from '../../composables/useServerList'
25
-
26
- const props = withDefaults(defineProps<{
27
- // Опційний: якщо фіча підміняє поле періоду через слот #period (напр. звіти
28
- // зі своєю обгорткою), проп не потрібен.
29
- period?: TPeriod
30
- // Період можна зняти зовсім (списки без дати за замовчуванням).
31
- isPeriodClearable?: boolean
32
- periodMode?: 'day' | 'week'
33
- // Свій набір пресетів періоду (див. DateRangeField). Не задано — дефолт за mode.
34
- periodPresets?: PeriodPresetGroups
35
- search?: string
36
- searchPlaceholder?: string
37
- /** Фільтри стора (`store.filters`) — для «{{ SharedConfig.get().labels.resetFilters }}». */
38
- filters?: ResettableFilters
39
- }>(), {
40
- periodMode: 'day',
41
- })
42
-
43
- const emit = defineEmits<{
44
- 'update:period': [period: TPeriod]
45
- 'update:search': [search: string]
46
- }>()
47
-
48
- const searchModel = computed<string>({
49
- get: () => props.search ?? '',
50
- set: (val) => emit('update:search', val),
51
- })
52
-
53
- const showSearch = computed(() => props.searchPlaceholder !== undefined)
54
-
55
- </script>
56
-
57
- <template>
58
- <section class="filters">
59
- <!-- Усі фільтри — один ряд, що переноситься. Роздільних рядів немає
60
- навмисно: період займає третину ширини, і решта ряду лишалась порожньою,
61
- поки пошук із дропдаунами тиснулись поверхом нижче. -->
62
- <div class="filters__main">
63
- <div v-if="period !== undefined || $slots.period" class="filters__group">
64
- <!-- Без підпису «Період»: іконка календаря в тригері й так очевидна.
65
- Поле фіча може підмінити своєю обгорткою (слот #period); дефолт —
66
- звичайний DateRangeField. -->
67
- <slot name="period">
68
- <DateRangeField
69
- v-if="period !== undefined"
70
- :period="period"
71
- :is-clearable="isPeriodClearable"
72
- :mode="periodMode"
73
- :presets="periodPresets"
74
- @update:period="emit('update:period', $event)"
75
- />
76
- </slot>
77
- </div>
78
-
79
- <UiSearchInput
80
- v-if="showSearch"
81
- v-model="searchModel"
82
- class="filters__search"
83
- :placeholder="searchPlaceholder ?? ''"
84
- />
85
-
86
- <slot name="chips" />
87
-
88
- <UiButton v-if="filters?.isFiltered" variant="ghost" size="sm" @click="filters.reset()">
89
- <FunnelX :size="14" />
90
- {{ SharedConfig.get().labels.resetFilters }}
91
- </UiButton>
92
- </div>
93
-
94
- <!-- Дії тримаємо окремим блоком, а не останнім елементом ряду: у ряду з
95
- переносом `margin-left: auto` притискає вправо лише в межах свого
96
- рядка, і кнопки їздили б за фільтрами. -->
97
- <div v-if="$slots.toolbar" class="filters__tools">
98
- <slot name="toolbar" />
99
- </div>
100
- </section>
101
- </template>
102
-
103
- <style scoped lang="scss">
104
- .filters {
105
- display: flex;
106
- // Не center: коли фільтри переносяться на другий рядок, дії мають лишитись
107
- // угорі, навпроти періоду, а не поїхати в середину картки.
108
- align-items: flex-start;
109
- gap: 12px;
110
- padding: 12px 16px;
111
- background: $color-surface;
112
- border: 1px solid $color-border;
113
- border-radius: 12px;
114
-
115
- &__main {
116
- flex: 1;
117
- min-width: 0;
118
- display: flex;
119
- flex-wrap: wrap;
120
- align-items: center;
121
- gap: 10px 12px;
122
- }
123
-
124
- &__group {
125
- display: flex;
126
- flex-wrap: wrap;
127
- align-items: center;
128
- gap: 12px;
129
- }
130
-
131
- &__tools {
132
- flex-shrink: 0;
133
- display: inline-flex;
134
- align-items: center;
135
- gap: 4px;
136
- // Вирівнювання по висоті поля періоду, а не по верхньому краю картки.
137
- padding-top: 2px;
138
- }
139
-
140
- // Ширина — забота ряда фильтров, не самого поля (см. UiSearchInput).
141
- // max-width обов'язковий: без нього пошук з'їдав увесь вільний простір ряду
142
- // і на широкому екрані розтягувався на понад тисячу пікселів.
143
- &__search {
144
- flex: 1;
145
- min-width: 150px;
146
- max-width: 285px;
147
- }
148
- }
149
-
150
- </style>
1
+ <script setup lang="ts" generic="TPeriod extends Period | null = Period">
2
+ // Базовый фильтр таблиц. Встроено: период (DateRangeField — поповер с календарём,
3
+ // коммит только по «Застосувати») и опциональный поиск. Вариативное (чипы,
4
+ // доп. кнопки) — слоты, период/поиск — через v-model.
5
+ //
6
+ // Кнопки «Оновити» тут нет: данные тянет vue-query, а руками их обновляют
7
+ // перезагрузкой страницы — в ряду фильтров она только занимала место.
8
+ //
9
+ // mode периода: 'day' (по умолч.) — свободный диапазон; 'week' — прилипает к
10
+ // целым неделям (для «Звітів»: агрегаторы точны только в рамках недели).
11
+ //
12
+ // «{{ SharedConfig.get().labels.resetFilters }}», а не «Очистити все»: те читалось як видалення списку.
13
+ // Кнопка є, лише коли є що скидати; чистий стан і скидання знає стор списку
14
+ // (useServerList) — з тієї ж схеми адреси, що й перше відкриття.
15
+
16
+ import { FunnelX } from '@lucide/vue'
17
+ import { computed } from 'vue'
18
+ import { SharedConfig } from '../../config'
19
+ import UiButton from '../ui/UiButton.vue'
20
+ import type { Period } from '../../helpers/period.helper'
21
+ import UiSearchInput from '../ui/UiSearchInput.vue'
22
+ import DateRangeField from './DateRangeField.vue'
23
+ import type { PeriodPresetGroups } from '../../helpers/periodPresets.helper'
24
+ import type { ResettableFilters } from '../../composables/useServerList'
25
+
26
+ const props = withDefaults(defineProps<{
27
+ // Опційний: якщо фіча підміняє поле періоду через слот #period (напр. звіти
28
+ // зі своєю обгорткою), проп не потрібен.
29
+ period?: TPeriod
30
+ // Період можна зняти зовсім (списки без дати за замовчуванням).
31
+ isPeriodClearable?: boolean
32
+ periodMode?: 'day' | 'week'
33
+ // Свій набір пресетів періоду (див. DateRangeField). Не задано — дефолт за mode.
34
+ periodPresets?: PeriodPresetGroups
35
+ search?: string
36
+ searchPlaceholder?: string
37
+ /** Фільтри стора (`store.filters`) — для «{{ SharedConfig.get().labels.resetFilters }}». */
38
+ filters?: ResettableFilters
39
+ }>(), {
40
+ periodMode: 'day',
41
+ })
42
+
43
+ const emit = defineEmits<{
44
+ 'update:period': [period: TPeriod]
45
+ 'update:search': [search: string]
46
+ }>()
47
+
48
+ const searchModel = computed<string>({
49
+ get: () => props.search ?? '',
50
+ set: (val) => emit('update:search', val),
51
+ })
52
+
53
+ const showSearch = computed(() => props.searchPlaceholder !== undefined)
54
+
55
+ </script>
56
+
57
+ <template>
58
+ <section class="filters">
59
+ <!-- Усі фільтри — один ряд, що переноситься. Роздільних рядів немає
60
+ навмисно: період займає третину ширини, і решта ряду лишалась порожньою,
61
+ поки пошук із дропдаунами тиснулись поверхом нижче. -->
62
+ <div class="filters__main">
63
+ <div v-if="period !== undefined || $slots.period" class="filters__group">
64
+ <!-- Без підпису «Період»: іконка календаря в тригері й так очевидна.
65
+ Поле фіча може підмінити своєю обгорткою (слот #period); дефолт —
66
+ звичайний DateRangeField. -->
67
+ <slot name="period">
68
+ <DateRangeField
69
+ v-if="period !== undefined"
70
+ :period="period"
71
+ :is-clearable="isPeriodClearable"
72
+ :mode="periodMode"
73
+ :presets="periodPresets"
74
+ @update:period="emit('update:period', $event)"
75
+ />
76
+ </slot>
77
+ </div>
78
+
79
+ <UiSearchInput
80
+ v-if="showSearch"
81
+ v-model="searchModel"
82
+ class="filters__search"
83
+ :placeholder="searchPlaceholder ?? ''"
84
+ />
85
+
86
+ <slot name="chips" />
87
+
88
+ <UiButton v-if="filters?.isFiltered" variant="ghost" size="sm" @click="filters.reset()">
89
+ <FunnelX :size="14" />
90
+ {{ SharedConfig.get().labels.resetFilters }}
91
+ </UiButton>
92
+ </div>
93
+
94
+ <!-- Дії тримаємо окремим блоком, а не останнім елементом ряду: у ряду з
95
+ переносом `margin-left: auto` притискає вправо лише в межах свого
96
+ рядка, і кнопки їздили б за фільтрами. -->
97
+ <div v-if="$slots.toolbar" class="filters__tools">
98
+ <slot name="toolbar" />
99
+ </div>
100
+ </section>
101
+ </template>
102
+
103
+ <style scoped lang="scss">
104
+ .filters {
105
+ display: flex;
106
+ // Не center: коли фільтри переносяться на другий рядок, дії мають лишитись
107
+ // угорі, навпроти періоду, а не поїхати в середину картки.
108
+ align-items: flex-start;
109
+ gap: 12px;
110
+ padding: 12px 16px;
111
+ background: $color-surface;
112
+ border: 1px solid $color-border;
113
+ border-radius: 12px;
114
+
115
+ &__main {
116
+ flex: 1;
117
+ min-width: 0;
118
+ display: flex;
119
+ flex-wrap: wrap;
120
+ align-items: center;
121
+ gap: 10px 12px;
122
+ }
123
+
124
+ &__group {
125
+ display: flex;
126
+ flex-wrap: wrap;
127
+ align-items: center;
128
+ gap: 12px;
129
+ }
130
+
131
+ &__tools {
132
+ flex-shrink: 0;
133
+ display: inline-flex;
134
+ align-items: center;
135
+ gap: 4px;
136
+ // Вирівнювання по висоті поля періоду, а не по верхньому краю картки.
137
+ padding-top: 2px;
138
+ }
139
+
140
+ // Ширина — забота ряда фильтров, не самого поля (см. UiSearchInput).
141
+ // max-width обов'язковий: без нього пошук з'їдав увесь вільний простір ряду
142
+ // і на широкому екрані розтягувався на понад тисячу пікселів.
143
+ &__search {
144
+ flex: 1;
145
+ min-width: 150px;
146
+ max-width: 285px;
147
+ }
148
+ }
149
+
150
+ </style>