@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 CHANGED
@@ -9,7 +9,7 @@
9
9
  Публічний пакет на npmjs.com, токен для встановлення не потрібен. У `package.json`:
10
10
 
11
11
  ```json
12
- "@rock555/frontend-core": "^3.1.0"
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
- Само в проєкт нічого не приїде: версія зафіксована в `package-lock.json`, тож невдала публікація нічого не зламає. Відкотитись можна так само, вказавши номер попередньої версії.
88
+ Само в проєкт нічого не приїде: у `package.json` стоїть точна версія, без `^`, тож ні `npm update`, ні оновлення lock-файлу нової версії не підтягнуть, а невдала публікація нічого не зламає. Відкотитись можна так само, вказавши номер попередньої версії.
89
89
 
90
90
  Публікація йде лише з CI, без токена. На npm для пакета ввімкнено двофакторну перевірку без обхідних токенів. Назву `release.yml` не міняємо: npm довіряє саме цьому файлу.
91
91
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rock555/frontend-core",
3
- "version": "3.1.0",
3
+ "version": "3.1.2",
4
4
  "description": "Спільне фронтове ядро: API-клієнт, таблиці, форми, модалки, хелпери",
5
5
  "license": "UNLICENSED",
6
6
  "repository": {
@@ -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 }}<span v-if="card.note" class="ui-kpi__note"><span class="ui-kpi__note-dot">·</span>{{ card.note }}</span>
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">·&nbsp;<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
- grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
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
- font-size: 16px;
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-dot {
102
- margin: 0 6px 0 7px;
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 file = (e.target as HTMLInputElement).files?.[0];
41
- handleChange(file);
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
- /** Дрібна приписка праворуч від значення через крапку (напр. частка палива «12,3%»). */
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
- /** ?from=&to= — період лише якщо обидві дати валідні: половина діапазону сенсу не має. */
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
- return raw && UrlParamsHelper.ISO_DATE.test(raw) ? raw : null
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.isFinite(page) && page > 1 ? page : 1
100
+ return Number.isSafeInteger(page) && page > 1 ? page : 1
93
101
  }
94
102
 
95
103
  /** Значення для запису: дефолт (сторінка 1) в URL не потрапляє. */
@@ -82,7 +82,7 @@ export class ModalsHelper {
82
82
  }
83
83
 
84
84
  get id() {
85
- return `${String(this.name)}-${this.uid}}`;
85
+ return `${String(this.name)}-${this.uid}`;
86
86
  }
87
87
 
88
88
  public onResolve: ((val: any) => void) | null = null;