@rock555/frontend-core 3.1.0 → 3.1.2
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 +3 -3
- package/package.json +1 -1
- package/src/components/ui/UiKpiGrid.vue +24 -12
- package/src/components/ui/inputs/FileInput.vue +5 -2
- package/src/components/ui/uiKpi.types.ts +1 -1
- package/src/composables/useServerList.ts +2 -1
- package/src/helpers/periodLabel.helper.ts +3 -0
- package/src/helpers/urlParams.helper.ts +17 -9
- package/src/plugins/modals.plugin.ts +1 -1
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
Публічний пакет на npmjs.com, токен для встановлення не потрібен. У `package.json`:
|
|
10
10
|
|
|
11
11
|
```json
|
|
12
|
-
"@rock555/frontend-core": "
|
|
12
|
+
"@rock555/frontend-core": "3.1.0"
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
Імпорти `@/_shared/...` міняти не треба. У `vite.config` один плагін, він дає аліас і все інше, без чого dev-сервер падає на старті:
|
|
@@ -82,10 +82,10 @@ plugins: [frontendCore(), /* ... */],
|
|
|
82
82
|
5. Проєкти піднімають версію звичайним PR одразу після виходу:
|
|
83
83
|
|
|
84
84
|
```bash
|
|
85
|
-
npm install @rock555/frontend-core@latest
|
|
85
|
+
npm install --save-exact @rock555/frontend-core@latest
|
|
86
86
|
```
|
|
87
87
|
|
|
88
|
-
Само в проєкт нічого не приїде:
|
|
88
|
+
Само в проєкт нічого не приїде: у `package.json` стоїть точна версія, без `^`, тож ні `npm update`, ні оновлення lock-файлу нової версії не підтягнуть, а невдала публікація нічого не зламає. Відкотитись можна так само, вказавши номер попередньої версії.
|
|
89
89
|
|
|
90
90
|
Публікація йде лише з CI, без токена. На npm для пакета ввімкнено двофакторну перевірку без обхідних токенів. Назву `release.yml` не міняємо: npm довіряє саме цьому файлу.
|
|
91
91
|
|
package/package.json
CHANGED
|
@@ -20,10 +20,15 @@ withDefaults(defineProps<{
|
|
|
20
20
|
<div class="ui-kpi__body">
|
|
21
21
|
<span v-if="card.value === null" class="ui-kpi__skeleton" />
|
|
22
22
|
<div v-else class="ui-kpi__value" :class="card.tone && `ui-kpi__value--${card.tone}`">
|
|
23
|
-
{{ card.value }}
|
|
23
|
+
{{ card.value }}
|
|
24
24
|
</div>
|
|
25
25
|
<div class="ui-kpi__label" :title="card.labelHint">
|
|
26
26
|
{{ card.label }}
|
|
27
|
+
<!-- Приписка — у рядку підпису, не біля числа: там вона з'їдала місце
|
|
28
|
+
суми, і замість частки лишалось «…». -->
|
|
29
|
+
<!-- Крапка з припискою одним шматком: при переносі вона не лишається
|
|
30
|
+
в кінці рядка без значення. -->
|
|
31
|
+
<span v-if="card.note" class="ui-kpi__note-group">· <span class="ui-kpi__note">{{ card.note }}</span></span>
|
|
27
32
|
<!-- Для позначок біля підпису (напр. «комісія попередня»). -->
|
|
28
33
|
<slot name="suffix" :card="card" />
|
|
29
34
|
</div>
|
|
@@ -36,8 +41,9 @@ withDefaults(defineProps<{
|
|
|
36
41
|
.ui-kpi {
|
|
37
42
|
display: grid;
|
|
38
43
|
// auto-fit + minmax = рівно стільки колонок, скільки влазить. Медіазапити
|
|
39
|
-
// під кожну кількість карток не потрібні.
|
|
40
|
-
|
|
44
|
+
// під кожну кількість карток не потрібні. 200px — щоб «100 000 000,00 ₴»
|
|
45
|
+
// вміщалась повним шрифтом.
|
|
46
|
+
grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
|
|
41
47
|
gap: 8px;
|
|
42
48
|
|
|
43
49
|
&__card {
|
|
@@ -73,11 +79,16 @@ withDefaults(defineProps<{
|
|
|
73
79
|
display: flex;
|
|
74
80
|
flex-direction: column;
|
|
75
81
|
gap: 2px;
|
|
82
|
+
flex: 1;
|
|
76
83
|
min-width: 0;
|
|
84
|
+
// Шрифт числа рахується від ширини картки (cqi), а не від самого числа.
|
|
85
|
+
container-type: inline-size;
|
|
77
86
|
}
|
|
78
87
|
|
|
79
88
|
&__value {
|
|
80
|
-
|
|
89
|
+
// Велика сума у вузькій картці не обрізається, а дрібнішає: при 11.5cqi
|
|
90
|
+
// «999 999 999,99 ₴» якраз займає всю ширину. Ширша картка — звичайні 16px.
|
|
91
|
+
font-size: min(16px, 11.5cqi);
|
|
81
92
|
font-weight: 700;
|
|
82
93
|
color: $color-text;
|
|
83
94
|
line-height: 1.15;
|
|
@@ -91,22 +102,23 @@ withDefaults(defineProps<{
|
|
|
91
102
|
&--muted { color: $color-muted; }
|
|
92
103
|
}
|
|
93
104
|
|
|
94
|
-
// Приписка (частка)
|
|
95
|
-
//
|
|
105
|
+
// Приписка (частка) у рядку підпису: кольором тексту, щоб читалась як
|
|
106
|
+
// значення, а не як продовження підпису.
|
|
96
107
|
&__note {
|
|
97
|
-
font-size: 0.8em;
|
|
98
108
|
font-weight: 600;
|
|
109
|
+
color: $color-text;
|
|
99
110
|
}
|
|
100
111
|
|
|
101
|
-
&__note-
|
|
102
|
-
|
|
103
|
-
color: $color-muted;
|
|
112
|
+
&__note-group {
|
|
113
|
+
white-space: nowrap;
|
|
104
114
|
}
|
|
105
115
|
|
|
116
|
+
// Довгий підпис з припискою переноситься цілими шматками, а не обрізається.
|
|
106
117
|
&__label {
|
|
107
118
|
display: inline-flex;
|
|
119
|
+
flex-wrap: wrap;
|
|
108
120
|
align-items: center;
|
|
109
|
-
gap: 4px;
|
|
121
|
+
gap: 0 4px;
|
|
110
122
|
font-size: 11px;
|
|
111
123
|
color: $color-muted;
|
|
112
124
|
}
|
|
@@ -127,7 +139,7 @@ withDefaults(defineProps<{
|
|
|
127
139
|
.ui-kpi__card { gap: 12px; padding: 14px 16px; border-radius: 12px; }
|
|
128
140
|
.ui-kpi__icon { width: 36px; height: 36px; border-radius: 10px; }
|
|
129
141
|
.ui-kpi__body { gap: 4px; }
|
|
130
|
-
.ui-kpi__value { font-size: 22px; line-height: 1.1; }
|
|
142
|
+
.ui-kpi__value { font-size: min(22px, 11.5cqi); line-height: 1.1; }
|
|
131
143
|
.ui-kpi__label { font-size: 12px; }
|
|
132
144
|
.ui-kpi__skeleton { width: 72px; height: 22px; border-radius: 6px; }
|
|
133
145
|
}
|
|
@@ -37,8 +37,11 @@ const onDragOver = (val: boolean) => isDragging.value = val;
|
|
|
37
37
|
:accept="accept"
|
|
38
38
|
class="file-field__input"
|
|
39
39
|
@change="(e) => {
|
|
40
|
-
const
|
|
41
|
-
handleChange(
|
|
40
|
+
const input = e.target as HTMLInputElement;
|
|
41
|
+
handleChange(input.files?.[0]);
|
|
42
|
+
// Файл уже у формі. Без скидання той самий файл після «Прибрати»
|
|
43
|
+
// вибрати знову не вийшло б: значення не змінилось — change немає.
|
|
44
|
+
input.value = '';
|
|
42
45
|
}"
|
|
43
46
|
/>
|
|
44
47
|
|
|
@@ -13,7 +13,7 @@ export interface UiKpiCardItem {
|
|
|
13
13
|
labelHint?: string
|
|
14
14
|
/** null = даних ще нема → замість числа скелетон. */
|
|
15
15
|
value: string | null
|
|
16
|
-
/**
|
|
16
|
+
/** Приписка в рядку підпису через крапку (напр. частка палива: «Паливо · 12,3%»). */
|
|
17
17
|
note?: string
|
|
18
18
|
tone?: UiKpiTone
|
|
19
19
|
}
|
|
@@ -171,9 +171,10 @@ export function useInfiniteRows<TParams, TResponse, TRow = RowOf<TResponse>>(
|
|
|
171
171
|
|
|
172
172
|
// «Без id — rowId обовʼязковий» умовним типом не виразити: TS тоді губить вивід
|
|
173
173
|
// відповіді з лямбди-фабрики. Тож перевірка тут, і гучна: тихо злиті в один
|
|
174
|
-
// рядок порції виглядали б як «дані зникли».
|
|
174
|
+
// рядок порції виглядали б як «дані зникли». Числовий id (автоінкремент) — теж id.
|
|
175
175
|
const idOf = (row: TRow): string => {
|
|
176
176
|
const id = config.rowId ? config.rowId(row) : (row as { id?: unknown }).id
|
|
177
|
+
if (typeof id === 'number' && Number.isFinite(id)) return String(id)
|
|
177
178
|
if (typeof id !== 'string') throw new Error('useInfiniteRows: row has no id, pass rowId')
|
|
178
179
|
return id
|
|
179
180
|
}
|
|
@@ -17,10 +17,13 @@ export class PeriodLabelHelper {
|
|
|
17
17
|
private static rangeFormat: Intl.DateTimeFormat | null = null
|
|
18
18
|
|
|
19
19
|
private static format(): Intl.DateTimeFormat {
|
|
20
|
+
// timeZone UTC: `new Date('2026-02-02')` — північ UTC, і в поясі західніше UTC
|
|
21
|
+
// підпис без нього з'їжджав на день назад.
|
|
20
22
|
PeriodLabelHelper.rangeFormat ??= new Intl.DateTimeFormat(SharedConfig.get().labels.dateLocale, {
|
|
21
23
|
day: 'numeric',
|
|
22
24
|
month: 'short',
|
|
23
25
|
year: 'numeric',
|
|
26
|
+
timeZone: 'UTC',
|
|
24
27
|
})
|
|
25
28
|
|
|
26
29
|
return PeriodLabelHelper.rangeFormat
|
|
@@ -19,18 +19,26 @@ export class UrlParamsHelper {
|
|
|
19
19
|
// Crockford base32 без I/L/O/U — саме такі id роздає бек.
|
|
20
20
|
private static readonly ULID = /^[0-9A-HJKMNP-TV-Z]{26}$/i
|
|
21
21
|
|
|
22
|
-
/**
|
|
22
|
+
/**
|
|
23
|
+
* ?from=&to= — період лише якщо обидві дати справжні й `from` не пізніше `to`:
|
|
24
|
+
* половина діапазону, 31 лютого чи перевернутий період дали б 422 від бека.
|
|
25
|
+
*/
|
|
23
26
|
static period(params: UrlReader, fromKey = 'from', toKey = 'to'): UrlPeriod | null {
|
|
24
|
-
const from = params.get(fromKey)
|
|
25
|
-
const to = params.get(toKey)
|
|
26
|
-
if (!from || !to) return null
|
|
27
|
-
if (!UrlParamsHelper.ISO_DATE.test(from) || !UrlParamsHelper.ISO_DATE.test(to)) return null
|
|
27
|
+
const from = UrlParamsHelper.isoDate(params.get(fromKey))
|
|
28
|
+
const to = UrlParamsHelper.isoDate(params.get(toKey))
|
|
29
|
+
if (!from || !to || from > to) return null
|
|
28
30
|
return { from, to }
|
|
29
31
|
}
|
|
30
32
|
|
|
31
|
-
/** Одиночна дата ?sort_week=2026-07-27. Сміття відкидаємо — бек дав би 422. */
|
|
33
|
+
/** Одиночна дата ?sort_week=2026-07-27. Сміття й неіснуючий день відкидаємо — бек дав би 422. */
|
|
32
34
|
static isoDate(raw: string | null): string | null {
|
|
33
|
-
|
|
35
|
+
if (!raw || !UrlParamsHelper.ISO_DATE.test(raw)) return null
|
|
36
|
+
|
|
37
|
+
// Date сам «переносить» 31 лютого в березень: дата справжня, лише якщо вона повертається собою.
|
|
38
|
+
const [year, month, day] = raw.split('-').map(Number)
|
|
39
|
+
const date = new Date(Date.UTC(year, month - 1, day))
|
|
40
|
+
|
|
41
|
+
return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day ? raw : null
|
|
34
42
|
}
|
|
35
43
|
|
|
36
44
|
/** Значення з білого списку, інакше null. */
|
|
@@ -86,10 +94,10 @@ export class UrlParamsHelper {
|
|
|
86
94
|
return value ? '1' : '0'
|
|
87
95
|
}
|
|
88
96
|
|
|
89
|
-
/** Сміття й перша сторінка дають 1 — її в URL не пишемо (див. writePage). */
|
|
97
|
+
/** Сміття (і дробове `2.5`) й перша сторінка дають 1 — її в URL не пишемо (див. writePage). */
|
|
90
98
|
static page(raw: string | null): number {
|
|
91
99
|
const page = Number(raw)
|
|
92
|
-
return Number.
|
|
100
|
+
return Number.isSafeInteger(page) && page > 1 ? page : 1
|
|
93
101
|
}
|
|
94
102
|
|
|
95
103
|
/** Значення для запису: дефолт (сторінка 1) в URL не потрапляє. */
|