@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,63 +1,63 @@
1
- // Назви місяців українською.
2
- //
3
- // Intl тут не годиться: `uk-UA` з `month: 'long'` разом із роком віддає родовий
4
- // відмінок і суфікс «р.» («липня 2026 р.»), а підпис звіту й вісь смуги періодів
5
- // потребують називного («Липень 2026»). Плюс локаль довелось би тягнути в бандл.
6
- //
7
- // Самі назви дає проєкт (`labels.monthNames`), ядро мови не знає.
8
-
9
- import { SharedConfig } from '../config'
10
-
11
- const names = () => SharedConfig.get().labels.monthNames
12
- const shortNames = () => SharedConfig.get().labels.monthShortNames
13
-
14
- /** `YYYY-MM` — формат місяця, яким оперує розділ виплат. */
15
- const MONTH_KEY = /^(\d{4})-(0[1-9]|1[0-2])$/
16
-
17
- export class MonthHelper {
18
- /** Повна назва в називному: «Липень». */
19
- static name(date: Date): string {
20
- return names()[date.getMonth()] ?? ''
21
- }
22
-
23
- /** Скорочення для осей і щільних місць: «лип». */
24
- static shortName(date: Date): string {
25
- return shortNames()[date.getMonth()] ?? ''
26
- }
27
-
28
- /**
29
- * `2026-07` → «Липень 2026». Некоректний ключ віддаємо як є: краще показати
30
- * сире значення, ніж мовчки підставити чужий місяць.
31
- */
32
- static label(month: string): string {
33
- const parsed = MONTH_KEY.exec(month)
34
- if (!parsed) return month
35
-
36
- const [, year, monthNumber] = parsed
37
-
38
- return `${names()[Number(monthNumber) - 1]} ${year}`
39
- }
40
-
41
- /** Дванадцять назв підряд, від січня, — для сітки вибору місяця. */
42
- static names(): readonly string[] {
43
- return names()
44
- }
45
-
46
- /** `2026-07` → рік і номер місяця. `null` — рядок не той. */
47
- static parse(month: string): { year: number; month: number } | null {
48
- const parsed = MONTH_KEY.exec(month)
49
- if (!parsed) return null
50
-
51
- return { year: Number(parsed[1]), month: Number(parsed[2]) }
52
- }
53
-
54
- /** Рік + номер місяця (1–12) → `2026-07`. */
55
- static key(year: number, month: number): string {
56
- return `${year}-${String(month).padStart(2, '0')}`
57
- }
58
-
59
- /** Чи схожий рядок на `YYYY-MM` — перевіряють і фільтр, і розбір адреси. */
60
- static isMonth(value: string): boolean {
61
- return MONTH_KEY.test(value)
62
- }
63
- }
1
+ // Назви місяців українською.
2
+ //
3
+ // Intl тут не годиться: `uk-UA` з `month: 'long'` разом із роком віддає родовий
4
+ // відмінок і суфікс «р.» («липня 2026 р.»), а підпис звіту й вісь смуги періодів
5
+ // потребують називного («Липень 2026»). Плюс локаль довелось би тягнути в бандл.
6
+ //
7
+ // Самі назви дає проєкт (`labels.monthNames`), ядро мови не знає.
8
+
9
+ import { SharedConfig } from '../config'
10
+
11
+ const names = () => SharedConfig.get().labels.monthNames
12
+ const shortNames = () => SharedConfig.get().labels.monthShortNames
13
+
14
+ /** `YYYY-MM` — формат місяця, яким оперує розділ виплат. */
15
+ const MONTH_KEY = /^(\d{4})-(0[1-9]|1[0-2])$/
16
+
17
+ export class MonthHelper {
18
+ /** Повна назва в називному: «Липень». */
19
+ static name(date: Date): string {
20
+ return names()[date.getMonth()] ?? ''
21
+ }
22
+
23
+ /** Скорочення для осей і щільних місць: «лип». */
24
+ static shortName(date: Date): string {
25
+ return shortNames()[date.getMonth()] ?? ''
26
+ }
27
+
28
+ /**
29
+ * `2026-07` → «Липень 2026». Некоректний ключ віддаємо як є: краще показати
30
+ * сире значення, ніж мовчки підставити чужий місяць.
31
+ */
32
+ static label(month: string): string {
33
+ const parsed = MONTH_KEY.exec(month)
34
+ if (!parsed) return month
35
+
36
+ const [, year, monthNumber] = parsed
37
+
38
+ return `${names()[Number(monthNumber) - 1]} ${year}`
39
+ }
40
+
41
+ /** Дванадцять назв підряд, від січня, — для сітки вибору місяця. */
42
+ static names(): readonly string[] {
43
+ return names()
44
+ }
45
+
46
+ /** `2026-07` → рік і номер місяця. `null` — рядок не той. */
47
+ static parse(month: string): { year: number; month: number } | null {
48
+ const parsed = MONTH_KEY.exec(month)
49
+ if (!parsed) return null
50
+
51
+ return { year: Number(parsed[1]), month: Number(parsed[2]) }
52
+ }
53
+
54
+ /** Рік + номер місяця (1–12) → `2026-07`. */
55
+ static key(year: number, month: number): string {
56
+ return `${year}-${String(month).padStart(2, '0')}`
57
+ }
58
+
59
+ /** Чи схожий рядок на `YYYY-MM` — перевіряють і фільтр, і розбір адреси. */
60
+ static isMonth(value: string): boolean {
61
+ return MONTH_KEY.test(value)
62
+ }
63
+ }
@@ -1,70 +1,70 @@
1
- // Розумні підписи періоду. Ключове — форматування діапазону дат саме нативним
2
- // Intl.DateTimeFormat.formatRange: він СХЛОПУЄ спільні частини так, як просили
3
- // менеджери, без власного велосипеда і сторонніх бібліотек:
4
- // в межах місяця → "2–8 лют. 2026"
5
- // через 2 місяці → "8 січ. – 8 лют. 2026"
6
- // через 2 роки → "5 січ. 2026 – 5 січ. 2027"
7
- // Плюс ISO-номер тижня (Пн–Нд) для лейбли "тиждень N".
8
-
9
- import dayjs from 'dayjs'
10
- import { SharedConfig } from '../config'
11
- import isoWeek from 'dayjs/plugin/isoWeek'
12
-
13
- dayjs.extend(isoWeek)
14
-
15
- export class PeriodLabelHelper {
16
- // Лінивий: мову задає проєкт, а модуль імпортується раніше за `SharedConfig.configure`.
17
- private static rangeFormat: Intl.DateTimeFormat | null = null
18
-
19
- private static format(): Intl.DateTimeFormat {
20
- PeriodLabelHelper.rangeFormat ??= new Intl.DateTimeFormat(SharedConfig.get().labels.dateLocale, {
21
- day: 'numeric',
22
- month: 'short',
23
- year: 'numeric',
24
- })
25
-
26
- return PeriodLabelHelper.rangeFormat
27
- }
28
-
29
- /**
30
- * Розумний підпис діапазону: схлопує спільні місяць/рік.
31
- * Один день → одна дата ("2 лют. 2026").
32
- */
33
- static range(from: string, to: string): string {
34
- const a = new Date(from)
35
- const b = new Date(to)
36
- // formatRange додає суфікс " р."/" рр." (рік/роки) наприкінці — це шум для
37
- // компактної лейбли, прибираємо.
38
- return PeriodLabelHelper.format().formatRange(a, b).replace(SharedConfig.get().labels.rangeYearSuffix, '')
39
- }
40
-
41
- /** Діапазон — рівна кількість цілих тижнів (початок Пн, кінець Нд). */
42
- static isWholeWeeks(from: string, to: string): boolean {
43
- return dayjs(from).isoWeekday() === 1 && dayjs(to).isoWeekday() === 7
44
- }
45
-
46
- /** Рівно один тиждень (Пн–Нд, 7 днів). */
47
- static isSingleWeek(from: string, to: string): boolean {
48
- return PeriodLabelHelper.isWholeWeeks(from, to)
49
- && dayjs(to).diff(dayjs(from), 'day') === 6
50
- }
51
-
52
- /** ISO-номер тижня дати. */
53
- static isoWeek(date: string): number {
54
- return dayjs(date).isoWeek()
55
- }
56
-
57
- /**
58
- * Лейбл тижнів для діапазону, кратного тижням: "тиждень 6" або "тижні 6–9".
59
- * null — діапазон не кратний цілим тижням.
60
- */
61
- static weeksLabel(from: string, to: string): string | null {
62
- if (!PeriodLabelHelper.isWholeWeeks(from, to)) return null
63
-
64
- const first = PeriodLabelHelper.isoWeek(from)
65
- const last = PeriodLabelHelper.isoWeek(to)
66
- const { weekLabel, weeksLabel } = SharedConfig.get().labels
67
-
68
- return first === last ? weekLabel(first) : weeksLabel(first, last)
69
- }
70
- }
1
+ // Розумні підписи періоду. Ключове — форматування діапазону дат саме нативним
2
+ // Intl.DateTimeFormat.formatRange: він СХЛОПУЄ спільні частини так, як просили
3
+ // менеджери, без власного велосипеда і сторонніх бібліотек:
4
+ // в межах місяця → "2–8 лют. 2026"
5
+ // через 2 місяці → "8 січ. – 8 лют. 2026"
6
+ // через 2 роки → "5 січ. 2026 – 5 січ. 2027"
7
+ // Плюс ISO-номер тижня (Пн–Нд) для лейбли "тиждень N".
8
+
9
+ import dayjs from 'dayjs'
10
+ import { SharedConfig } from '../config'
11
+ import isoWeek from 'dayjs/plugin/isoWeek'
12
+
13
+ dayjs.extend(isoWeek)
14
+
15
+ export class PeriodLabelHelper {
16
+ // Лінивий: мову задає проєкт, а модуль імпортується раніше за `SharedConfig.configure`.
17
+ private static rangeFormat: Intl.DateTimeFormat | null = null
18
+
19
+ private static format(): Intl.DateTimeFormat {
20
+ PeriodLabelHelper.rangeFormat ??= new Intl.DateTimeFormat(SharedConfig.get().labels.dateLocale, {
21
+ day: 'numeric',
22
+ month: 'short',
23
+ year: 'numeric',
24
+ })
25
+
26
+ return PeriodLabelHelper.rangeFormat
27
+ }
28
+
29
+ /**
30
+ * Розумний підпис діапазону: схлопує спільні місяць/рік.
31
+ * Один день → одна дата ("2 лют. 2026").
32
+ */
33
+ static range(from: string, to: string): string {
34
+ const a = new Date(from)
35
+ const b = new Date(to)
36
+ // formatRange додає суфікс " р."/" рр." (рік/роки) наприкінці — це шум для
37
+ // компактної лейбли, прибираємо.
38
+ return PeriodLabelHelper.format().formatRange(a, b).replace(SharedConfig.get().labels.rangeYearSuffix, '')
39
+ }
40
+
41
+ /** Діапазон — рівна кількість цілих тижнів (початок Пн, кінець Нд). */
42
+ static isWholeWeeks(from: string, to: string): boolean {
43
+ return dayjs(from).isoWeekday() === 1 && dayjs(to).isoWeekday() === 7
44
+ }
45
+
46
+ /** Рівно один тиждень (Пн–Нд, 7 днів). */
47
+ static isSingleWeek(from: string, to: string): boolean {
48
+ return PeriodLabelHelper.isWholeWeeks(from, to)
49
+ && dayjs(to).diff(dayjs(from), 'day') === 6
50
+ }
51
+
52
+ /** ISO-номер тижня дати. */
53
+ static isoWeek(date: string): number {
54
+ return dayjs(date).isoWeek()
55
+ }
56
+
57
+ /**
58
+ * Лейбл тижнів для діапазону, кратного тижням: "тиждень 6" або "тижні 6–9".
59
+ * null — діапазон не кратний цілим тижням.
60
+ */
61
+ static weeksLabel(from: string, to: string): string | null {
62
+ if (!PeriodLabelHelper.isWholeWeeks(from, to)) return null
63
+
64
+ const first = PeriodLabelHelper.isoWeek(from)
65
+ const last = PeriodLabelHelper.isoWeek(to)
66
+ const { weekLabel, weeksLabel } = SharedConfig.get().labels
67
+
68
+ return first === last ? weekLabel(first) : weeksLabel(first, last)
69
+ }
70
+ }
@@ -1,76 +1,76 @@
1
- // Набори пресетів («швидкий вибір») для DateRangeField. Окремо від режиму снапу:
2
- // фіча дає свій набір (звіти: вільний діапазон, пресети тиждень/місяць/квартал/рік).
3
-
4
- import { SharedConfig } from '../config'
5
- import { PeriodHelper, type Period } from './period.helper'
6
-
7
- export interface PeriodPreset {
8
- label: string
9
- make: () => Period
10
- }
11
-
12
- export type PeriodPresetGroups = PeriodPreset[][]
13
-
14
- const texts = () => SharedConfig.get().labels.periodPresets
15
-
16
- export class PeriodPresetsHelper {
17
- // Повний набір для вільного діапазону (статистика/платежі).
18
- static day(): PeriodPresetGroups {
19
- return [
20
- [
21
- { label: texts().today, make: () => PeriodHelper.today() },
22
- { label: texts().yesterday, make: () => PeriodHelper.yesterday() },
23
- ],
24
- [
25
- { label: texts().thisWeek, make: () => PeriodHelper.currentWeek() },
26
- { label: texts().prevWeek, make: () => PeriodHelper.prevWeek() },
27
- ],
28
- [
29
- { label: texts().thisMonth, make: () => PeriodHelper.currentMonth() },
30
- { label: texts().prevMonth, make: () => PeriodHelper.prevMonth() },
31
- ],
32
- [
33
- { label: texts().last30Days, make: () => PeriodHelper.lastNDays(30) },
34
- { label: texts().last90Days, make: () => PeriodHelper.lastNDays(90) },
35
- ],
36
- ]
37
- }
38
-
39
- // Тижневий снап (лишається для сумісності mode='week').
40
- static week(): PeriodPresetGroups {
41
- return [
42
- [
43
- { label: texts().thisWeek, make: () => PeriodHelper.currentWeek() },
44
- { label: texts().prevWeek, make: () => PeriodHelper.prevWeek() },
45
- { label: texts().last2Weeks, make: () => PeriodHelper.lastNWeeks(2) },
46
- { label: texts().last4Weeks, make: () => PeriodHelper.lastNWeeks(4) },
47
- ],
48
- [
49
- { label: texts().thisMonth, make: () => PeriodHelper.currentMonth() },
50
- { label: texts().prevMonth, make: () => PeriodHelper.prevMonth() },
51
- ],
52
- ]
53
- }
54
-
55
- // Звіти: тиждень / місяць / квартал / рік (менеджерські «швидкі вибори»).
56
- static reports(): PeriodPresetGroups {
57
- return [
58
- [
59
- { label: texts().thisWeek, make: () => PeriodHelper.currentWeek() },
60
- { label: texts().prevWeek, make: () => PeriodHelper.prevWeek() },
61
- ],
62
- [
63
- { label: texts().thisMonth, make: () => PeriodHelper.currentMonth() },
64
- { label: texts().prevMonth, make: () => PeriodHelper.prevMonth() },
65
- ],
66
- [
67
- { label: texts().thisQuarter, make: () => PeriodHelper.currentQuarter() },
68
- { label: texts().prevQuarter, make: () => PeriodHelper.prevQuarter() },
69
- ],
70
- [
71
- { label: texts().thisYear, make: () => PeriodHelper.currentYear() },
72
- { label: texts().prevYear, make: () => PeriodHelper.prevYear() },
73
- ],
74
- ]
75
- }
76
- }
1
+ // Набори пресетів («швидкий вибір») для DateRangeField. Окремо від режиму снапу:
2
+ // фіча дає свій набір (звіти: вільний діапазон, пресети тиждень/місяць/квартал/рік).
3
+
4
+ import { SharedConfig } from '../config'
5
+ import { PeriodHelper, type Period } from './period.helper'
6
+
7
+ export interface PeriodPreset {
8
+ label: string
9
+ make: () => Period
10
+ }
11
+
12
+ export type PeriodPresetGroups = PeriodPreset[][]
13
+
14
+ const texts = () => SharedConfig.get().labels.periodPresets
15
+
16
+ export class PeriodPresetsHelper {
17
+ // Повний набір для вільного діапазону (статистика/платежі).
18
+ static day(): PeriodPresetGroups {
19
+ return [
20
+ [
21
+ { label: texts().today, make: () => PeriodHelper.today() },
22
+ { label: texts().yesterday, make: () => PeriodHelper.yesterday() },
23
+ ],
24
+ [
25
+ { label: texts().thisWeek, make: () => PeriodHelper.currentWeek() },
26
+ { label: texts().prevWeek, make: () => PeriodHelper.prevWeek() },
27
+ ],
28
+ [
29
+ { label: texts().thisMonth, make: () => PeriodHelper.currentMonth() },
30
+ { label: texts().prevMonth, make: () => PeriodHelper.prevMonth() },
31
+ ],
32
+ [
33
+ { label: texts().last30Days, make: () => PeriodHelper.lastNDays(30) },
34
+ { label: texts().last90Days, make: () => PeriodHelper.lastNDays(90) },
35
+ ],
36
+ ]
37
+ }
38
+
39
+ // Тижневий снап (лишається для сумісності mode='week').
40
+ static week(): PeriodPresetGroups {
41
+ return [
42
+ [
43
+ { label: texts().thisWeek, make: () => PeriodHelper.currentWeek() },
44
+ { label: texts().prevWeek, make: () => PeriodHelper.prevWeek() },
45
+ { label: texts().last2Weeks, make: () => PeriodHelper.lastNWeeks(2) },
46
+ { label: texts().last4Weeks, make: () => PeriodHelper.lastNWeeks(4) },
47
+ ],
48
+ [
49
+ { label: texts().thisMonth, make: () => PeriodHelper.currentMonth() },
50
+ { label: texts().prevMonth, make: () => PeriodHelper.prevMonth() },
51
+ ],
52
+ ]
53
+ }
54
+
55
+ // Звіти: тиждень / місяць / квартал / рік (менеджерські «швидкі вибори»).
56
+ static reports(): PeriodPresetGroups {
57
+ return [
58
+ [
59
+ { label: texts().thisWeek, make: () => PeriodHelper.currentWeek() },
60
+ { label: texts().prevWeek, make: () => PeriodHelper.prevWeek() },
61
+ ],
62
+ [
63
+ { label: texts().thisMonth, make: () => PeriodHelper.currentMonth() },
64
+ { label: texts().prevMonth, make: () => PeriodHelper.prevMonth() },
65
+ ],
66
+ [
67
+ { label: texts().thisQuarter, make: () => PeriodHelper.currentQuarter() },
68
+ { label: texts().prevQuarter, make: () => PeriodHelper.prevQuarter() },
69
+ ],
70
+ [
71
+ { label: texts().thisYear, make: () => PeriodHelper.currentYear() },
72
+ { label: texts().prevYear, make: () => PeriodHelper.prevYear() },
73
+ ],
74
+ ]
75
+ }
76
+ }
@@ -1,57 +1,57 @@
1
- // Стек мультисортування → параметр запиту.
2
- //
3
- // Бек читає `sort` як асоціативний масив, і ПОРЯДОК ключів у ньому = пріоритет.
4
- // Тому збірка живе в одному місці: зібраний деінде spread'ом об'єкт міг би
5
- // поїхати з переплутаним порядком, і таблиця мовчки відсортувалась би не так.
6
- //
7
- // Домену тут немає — ключі, підписи й напрямок першого кліку тримає реєстр полів
8
- // таблиці (`TableFieldsHelper`), а це збірка параметра й спільні підписи.
9
-
10
- import { SharedConfig } from '../config'
11
- import type { ServerSortEntry, SortDirection } from '../composables/useServerTable'
12
-
13
- export class SortHelper {
14
- /**
15
- * Підписи напрямків за родом значення: одне «Спадання» на всі сторінки.
16
- * Ознаки з власним змістом («Спочатку авто парку») словник фічі підписує сам.
17
- */
18
- static get DIRECTIONS() {
19
- return SharedConfig.get().labels.sortDirections
20
- }
21
-
22
- /**
23
- * Клік по шапці поза TanStack (своя таблиця): ключа немає — додати в кінець з
24
- * напрямком першого кліку, є з ним — розвернути, розвернутий — прибрати. Той
25
- * самий цикл, що TanStack веде для звичайних таблиць.
26
- */
27
- static toggle<T extends string>(
28
- sort: ReadonlyArray<ServerSortEntry<T>>,
29
- by: T,
30
- first: SortDirection,
31
- ): Array<ServerSortEntry<T>> {
32
- const current = sort.find(entry => entry.by === by)
33
-
34
- if (!current) return [...sort, { by, direction: first }]
35
-
36
- if (current.direction === first) {
37
- const flipped: SortDirection = first === 'asc' ? 'desc' : 'asc'
38
-
39
- return sort.map(entry => entry.by === by ? { by, direction: flipped } : entry)
40
- }
41
-
42
- return sort.filter(entry => entry.by !== by)
43
- }
44
-
45
- /** Порожній список → `undefined`: бек вимагає непорожній `sort`. */
46
- static toParam<T extends string>(
47
- sort: ReadonlyArray<ServerSortEntry<T>>,
48
- ): Record<string, SortDirection> | undefined {
49
- if (sort.length === 0) return undefined
50
-
51
- return sort.reduce<Record<string, SortDirection>>((acc, entry) => {
52
- acc[entry.by] = entry.direction
53
-
54
- return acc
55
- }, {})
56
- }
57
- }
1
+ // Стек мультисортування → параметр запиту.
2
+ //
3
+ // Бек читає `sort` як асоціативний масив, і ПОРЯДОК ключів у ньому = пріоритет.
4
+ // Тому збірка живе в одному місці: зібраний деінде spread'ом об'єкт міг би
5
+ // поїхати з переплутаним порядком, і таблиця мовчки відсортувалась би не так.
6
+ //
7
+ // Домену тут немає — ключі, підписи й напрямок першого кліку тримає реєстр полів
8
+ // таблиці (`TableFieldsHelper`), а це збірка параметра й спільні підписи.
9
+
10
+ import { SharedConfig } from '../config'
11
+ import type { ServerSortEntry, SortDirection } from '../composables/useServerTable'
12
+
13
+ export class SortHelper {
14
+ /**
15
+ * Підписи напрямків за родом значення: одне «Спадання» на всі сторінки.
16
+ * Ознаки з власним змістом («Спочатку авто парку») словник фічі підписує сам.
17
+ */
18
+ static get DIRECTIONS() {
19
+ return SharedConfig.get().labels.sortDirections
20
+ }
21
+
22
+ /**
23
+ * Клік по шапці поза TanStack (своя таблиця): ключа немає — додати в кінець з
24
+ * напрямком першого кліку, є з ним — розвернути, розвернутий — прибрати. Той
25
+ * самий цикл, що TanStack веде для звичайних таблиць.
26
+ */
27
+ static toggle<T extends string>(
28
+ sort: ReadonlyArray<ServerSortEntry<T>>,
29
+ by: T,
30
+ first: SortDirection,
31
+ ): Array<ServerSortEntry<T>> {
32
+ const current = sort.find(entry => entry.by === by)
33
+
34
+ if (!current) return [...sort, { by, direction: first }]
35
+
36
+ if (current.direction === first) {
37
+ const flipped: SortDirection = first === 'asc' ? 'desc' : 'asc'
38
+
39
+ return sort.map(entry => entry.by === by ? { by, direction: flipped } : entry)
40
+ }
41
+
42
+ return sort.filter(entry => entry.by !== by)
43
+ }
44
+
45
+ /** Порожній список → `undefined`: бек вимагає непорожній `sort`. */
46
+ static toParam<T extends string>(
47
+ sort: ReadonlyArray<ServerSortEntry<T>>,
48
+ ): Record<string, SortDirection> | undefined {
49
+ if (sort.length === 0) return undefined
50
+
51
+ return sort.reduce<Record<string, SortDirection>>((acc, entry) => {
52
+ acc[entry.by] = entry.direction
53
+
54
+ return acc
55
+ }, {})
56
+ }
57
+ }