@konce-pt/angular 0.12.0 → 0.15.0

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 (114) hide show
  1. package/CHANGELOG.md +617 -369
  2. package/README.md +111 -55
  3. package/charts/src/lib/llms.txt +17 -17
  4. package/chat/src/lib/llms.txt +61 -35
  5. package/fesm2022/konce-pt-angular-charts.mjs +11 -11
  6. package/fesm2022/konce-pt-angular-charts.mjs.map +1 -1
  7. package/fesm2022/konce-pt-angular-chat.mjs +236 -127
  8. package/fesm2022/konce-pt-angular-chat.mjs.map +1 -1
  9. package/fesm2022/konce-pt-angular-grid.mjs +16 -16
  10. package/fesm2022/konce-pt-angular-grid.mjs.map +1 -1
  11. package/fesm2022/konce-pt-angular-icons.mjs +5 -5
  12. package/fesm2022/konce-pt-angular-icons.mjs.map +1 -1
  13. package/fesm2022/konce-pt-angular-map.mjs +308 -280
  14. package/fesm2022/konce-pt-angular-map.mjs.map +1 -1
  15. package/fesm2022/konce-pt-angular-roadmap.mjs +23 -23
  16. package/fesm2022/konce-pt-angular-roadmap.mjs.map +1 -1
  17. package/fesm2022/konce-pt-angular.mjs +4416 -2132
  18. package/fesm2022/konce-pt-angular.mjs.map +1 -1
  19. package/grid/src/lib/llms.txt +18 -18
  20. package/map/src/lib/llms.txt +142 -141
  21. package/package.json +14 -12
  22. package/roadmap/src/lib/llms.txt +27 -27
  23. package/src/lib/accordion/llms.txt +18 -6
  24. package/src/lib/alert/llms.txt +5 -5
  25. package/src/lib/app-shell/llms.txt +23 -21
  26. package/src/lib/auth/llms.txt +22 -22
  27. package/src/lib/autocomplete/llms.txt +15 -4
  28. package/src/lib/avatar/llms.txt +3 -3
  29. package/src/lib/avatar-group/llms.txt +5 -5
  30. package/src/lib/backdrop/llms.txt +35 -35
  31. package/src/lib/badge/llms.txt +7 -7
  32. package/src/lib/bottom-sheet/llms.txt +4 -4
  33. package/src/lib/breadcrumb/llms.txt +2 -2
  34. package/src/lib/breakpoint/llms.txt +8 -8
  35. package/src/lib/button/llms.txt +26 -18
  36. package/src/lib/button-group/llms.txt +37 -31
  37. package/src/lib/card/llms.txt +19 -19
  38. package/src/lib/carousel/llms.txt +6 -6
  39. package/src/lib/checkbox/llms.txt +15 -3
  40. package/src/lib/chip/llms.txt +6 -6
  41. package/src/lib/chips-input/llms.txt +11 -4
  42. package/src/lib/color-picker/llms.txt +4 -4
  43. package/src/lib/confirm/llms.txt +5 -5
  44. package/src/lib/context-menu/llms.txt +4 -4
  45. package/src/lib/data-table/llms.txt +280 -239
  46. package/src/lib/data-view/llms.txt +25 -4
  47. package/src/lib/date-range/llms.txt +27 -27
  48. package/src/lib/datepicker/llms.txt +34 -34
  49. package/src/lib/dialog/llms.txt +22 -28
  50. package/src/lib/divider/llms.txt +2 -2
  51. package/src/lib/drawer/llms.txt +7 -7
  52. package/src/lib/empty/llms.txt +4 -4
  53. package/src/lib/fab/llms.txt +6 -2
  54. package/src/lib/fieldset/llms.txt +22 -4
  55. package/src/lib/file-upload/llms.txt +1 -1
  56. package/src/lib/form-field/llms.txt +33 -19
  57. package/src/lib/galleria/llms.txt +3 -3
  58. package/src/lib/i18n/llms.txt +9 -9
  59. package/src/lib/icon/llms.txt +8 -8
  60. package/src/lib/icon-button/llms.txt +8 -3
  61. package/src/lib/image/llms.txt +4 -4
  62. package/src/lib/input/llms.txt +21 -7
  63. package/src/lib/input-mask/llms.txt +2 -2
  64. package/src/lib/input-number/llms.txt +14 -14
  65. package/src/lib/input-otp/llms.txt +6 -6
  66. package/src/lib/knob/llms.txt +11 -6
  67. package/src/lib/listbox/llms.txt +6 -6
  68. package/src/lib/loader/llms.txt +72 -0
  69. package/src/lib/megamenu/llms.txt +7 -7
  70. package/src/lib/mention/llms.txt +15 -15
  71. package/src/lib/menu/llms.txt +12 -12
  72. package/src/lib/menubar/llms.txt +7 -7
  73. package/src/lib/meter-group/llms.txt +7 -7
  74. package/src/lib/order-list/llms.txt +18 -6
  75. package/src/lib/paginator/llms.txt +5 -5
  76. package/src/lib/panel/llms.txt +20 -8
  77. package/src/lib/password/llms.txt +14 -6
  78. package/src/lib/peek/llms.txt +10 -10
  79. package/src/lib/pick-list/llms.txt +26 -6
  80. package/src/lib/popover/llms.txt +7 -7
  81. package/src/lib/progress/llms.txt +16 -16
  82. package/src/lib/radio-group/llms.txt +10 -3
  83. package/src/lib/rating/llms.txt +13 -6
  84. package/src/lib/rich-text/llms.txt +34 -29
  85. package/src/lib/scroll-top/llms.txt +3 -3
  86. package/src/lib/select/llms.txt +20 -13
  87. package/src/lib/sidenav/llms.txt +8 -8
  88. package/src/lib/slider/llms.txt +21 -8
  89. package/src/lib/speech/llms.txt +108 -0
  90. package/src/lib/speed-dial/llms.txt +9 -3
  91. package/src/lib/spinner/llms.txt +2 -2
  92. package/src/lib/split-button/llms.txt +14 -8
  93. package/src/lib/splitter/llms.txt +8 -8
  94. package/src/lib/stepper/llms.txt +24 -8
  95. package/src/lib/switch/llms.txt +10 -3
  96. package/src/lib/switch-group/llms.txt +10 -10
  97. package/src/lib/tabs/llms.txt +5 -5
  98. package/src/lib/textarea/llms.txt +16 -5
  99. package/src/lib/timeline/llms.txt +1 -1
  100. package/src/lib/toast/llms.txt +33 -5
  101. package/src/lib/toolbar/llms.txt +3 -3
  102. package/src/lib/tooltip/llms.txt +10 -10
  103. package/src/lib/tree/llms.txt +19 -6
  104. package/src/lib/update/llms.txt +52 -0
  105. package/types/konce-pt-angular-charts.d.ts +2 -2
  106. package/types/konce-pt-angular-chat.d.ts +87 -44
  107. package/types/konce-pt-angular-chat.d.ts.map +1 -1
  108. package/types/konce-pt-angular-grid.d.ts +14 -14
  109. package/types/konce-pt-angular-icons.d.ts +3 -3
  110. package/types/konce-pt-angular-map.d.ts +137 -121
  111. package/types/konce-pt-angular-map.d.ts.map +1 -1
  112. package/types/konce-pt-angular-roadmap.d.ts +13 -13
  113. package/types/konce-pt-angular.d.ts +1391 -628
  114. package/types/konce-pt-angular.d.ts.map +1 -1
@@ -7,12 +7,13 @@ Import: `import { KptDataView } from '@konce-pt/angular';`
7
7
  ## Inputs / model
8
8
  - `items`: T[]
9
9
  - `layout`: model<'list' | 'grid'> (the toggle in the bar)
10
- - `pageSize`: model<number> (0 = no pagination) — two-way, because the paginator's select writes to it
10
+ - `pageSize`: model<number> (0 = no pagination) - two-way, because the paginator's select writes to it
11
11
  - `pageSizeOptions`: number[] (empty = the select offers the current size only)
12
- - `gridColumns`: model<number> (0 = as many as fit) — two-way, the density bar writes to it
12
+ - `gridColumns`: model<number> (0 = as many as fit) - two-way, the density bar writes to it
13
13
  - `gridColumnsOptions`: number[] (fewer than two = no density bar)
14
- - `gridMinWidth`: string (default `10rem`) — the narrowest card worth rendering
14
+ - `gridMinWidth`: string (default `10rem`) - the narrowest card worth rendering
15
15
  - `paginated`: boolean
16
+ - `layoutMotion`: `'spring' | 'arc' | 'morph' | 'none'` (default from `provideKptMotion`, else `spring`) - see below
16
17
 
17
18
  ## Example
18
19
  <kpt-data-view [items]="products" [(pageSize)]="size" [pageSizeOptions]="[3, 6, 9]">
@@ -22,7 +23,7 @@ Import: `import { KptDataView } from '@konce-pt/angular';`
22
23
  ## The column count is a ceiling
23
24
  `gridColumns` caps the grid, it does not pin it: the track minimum grows to the width of one of
24
25
  N columns, so a narrow container drops to two or one column instead of squeezing cards below
25
- `gridMinWidth`. Set `gridColumns` to one of `gridColumnsOptions` — with a value outside the list
26
+ `gridMinWidth`. Set `gridColumns` to one of `gridColumnsOptions` - with a value outside the list
26
27
  no density button reads as active.
27
28
 
28
29
  ## The pager stays while there is a choice
@@ -30,5 +31,25 @@ It shows up when the items outgrow one page, and also when `pageSizeOptions` hol
30
31
  size. Otherwise picking the largest size would hide the very select that was just used, with no
31
32
  way back to a smaller one.
32
33
 
34
+ ## Layout motion
35
+ `layoutMotion` animates a layout or density change made from the built-in bar:
36
+ - `spring` - each card glides from its old place to the new one on a spring and resizes; the
37
+ content is counter-scaled, so it never stretches. A light cascade from the first item.
38
+ - `arc` - cards lift (shadow, slight zoom), fly along an arc tilted toward the move and land
39
+ softly; the wave starts at the clicked button.
40
+ - `morph` - the browser's own morph (View Transitions): frames morph, old and new content
41
+ cross-fade, clipped rather than stretched. Without browser support the change is instant. A view
42
+ transition covers the whole document and blocks clicks for ~0.6 s.
43
+ - `none` - no motion.
44
+
45
+ With no value it takes `layout` from `provideKptMotion` (default `spring`); `enabled: false` there and
46
+ the system "reduce motion" setting always win. A click in the middle of a flight starts the next
47
+ one from where the cards are on screen. A layout set from outside (`[layout]`, `[gridColumns]`) switches instantly - the
48
+ old state has to be measured before the DOM changes.
49
+
50
+ <kpt-data-view [items]="products" layoutMotion="arc" [gridColumnsOptions]="[2, 3, 4]">
51
+ <ng-template let-p><div>{{ p.name }}</div></ng-template>
52
+ </kpt-data-view>
53
+
33
54
  ## Tokens
34
55
  Item cards `--kpt-color-surface-raised`; the toggle `--kpt-color-primary`.
@@ -9,38 +9,38 @@ Requires `import '@angular/cdk/overlay-prebuilt.css';`
9
9
  ## Inputs / model
10
10
  - `value`: model<KptDateRangeValue> (or `formField`)
11
11
  - `mode`: 'date' | 'datetime' | 'time' (default 'date')
12
- - `visibleMonths`: number (default 1, clamped to 1–3) — how many months sit side by side.
13
- The ‹ › arrows stand on the outermost panels and move the whole set by one month.
14
- Ignored in 'time' mode. With more than one, days from adjacent months are hidden (empty slots) —
12
+ - `visibleMonths`: number (default 1, clamped to 1-3) - how many months sit side by side.
13
+ The < > arrows stand on the outermost panels and move the whole set by one month.
14
+ Ignored in 'time' mode. With more than one, days from adjacent months are hidden (empty slots) -
15
15
  otherwise the same date would be clickable in two panels at once.
16
- - `hourFormat`: 12 | 24 (default 24) — an AM/PM or a 24h dial; the value is always 24h
17
- - `minuteStep`: number (default 1) — minute snapping on the dial
18
- - `placeholder`: string — with no value it uses i18n (`dateRange.placeholder`); the input takes priority
19
- - `displayFormat`: 'pl' | 'iso' | 'locale' (default 'pl') — the display format for start/end
20
- - `open`: model<boolean> — two-way `[(open)]`, as in `kpt-datepicker`
21
- - `readonly`/`required`, `firstDayOfWeek` — see "Week start, display format and field state"
22
- - `minDate`/`maxDate`: string|null — 'YYYY-MM-DD' bounds (inclusive); days outside are disabled
23
- - `ariaLabel`: string|null — the accessible name when no `<label for>` describes the field
24
- - `disabled`/`invalid`/`touched`: boolean; `touch`: output — fires when the panel closes and when
16
+ - `hourFormat`: 12 | 24 (default 24) - an AM/PM or a 24h dial; the value is always 24h
17
+ - `minuteStep`: number (default 1) - minute snapping on the dial
18
+ - `placeholder`: string - with no value it uses i18n (`dateRange.placeholder`); the input takes priority
19
+ - `displayFormat`: 'pl' | 'iso' | 'locale' (default 'pl') - the display format for start/end
20
+ - `open`: model<boolean> - two-way `[(open)]`, as in `kpt-datepicker`
21
+ - `readonly`/`required`, `firstDayOfWeek` - see "Week start, display format and field state"
22
+ - `minDate`/`maxDate`: string|null - 'YYYY-MM-DD' bounds (inclusive); days outside are disabled
23
+ - `ariaLabel`: string|null - the accessible name when no `<label for>` describes the field
24
+ - `disabled`/`invalid`/`touched`: boolean; `touch`: output - fires when the panel closes and when
25
25
  focus leaves the closed trigger
26
26
 
27
27
  ## Behavior
28
- The first click sets `start`, the second `end` (the order is normalized). The "×" clears it.
28
+ The first click sets `start`, the second `end` (the order is normalized). The "x" clears it.
29
29
  The range highlights one continuous band running across every panel: the end days carry the selection
30
30
  blob, and the band leaves their center, rounding off at the ends of a grid row.
31
31
  The datetime/time modes: a "From / To" toggle + the clock dial, confirmed with the "Done" button.
32
32
 
33
33
  ## Keyboard
34
34
  As in the date picker: the trigger has `aria-haspopup="dialog"` and `aria-expanded`; `Enter`, `Space`
35
- and `↓` open the panel (a `role="dialog"` named "Choose a date range") with focus on the range start,
36
- or today. The arrows, `Home`/`End` and `PageUp`/`PageDown` (with `Shift` — a year) walk the days across
35
+ and `ArrowDown` open the panel (a `role="dialog"` named "Choose a date range") with focus on the range start,
36
+ or today. The arrows, `Home`/`End` and `PageUp`/`PageDown` (with `Shift` - a year) walk the days across
37
37
  every panel, shifting the set of months when focus leaves it. `Tab` cycles inside the panel, `Escape`
38
38
  closes it, and picking the end (or "Done") returns focus to the trigger. `Delete`/`Backspace` on the
39
39
  trigger clears the range.
40
40
 
41
- Each day is named with the full date and its role in the range ("…, start of range", "…, end of range",
42
- "…, in range") — the band colour is not the only carrier. The ends have `aria-pressed`, today has
43
- `aria-current="date"`. After the first pick a polite live region says "Start: … Choose the end date.".
41
+ Each day is named with the full date and its role in the range ("..., start of range", "..., end of range",
42
+ "..., in range") - the band colour is not the only carrier. The ends have `aria-pressed`, today has
43
+ `aria-current="date"`. After the first pick a polite live region says "Start: ... Choose the end date.".
44
44
 
45
45
  ## Example
46
46
  <kpt-date-range [formField]="f.period" />
@@ -52,27 +52,27 @@ Each day is named with the full date and its role in the range ("…, start of r
52
52
  ## i18n
53
53
  Day and month names come from `Intl` per locale; the labels ("From/To", navigation, "Done", the placeholder) come from i18n
54
54
  (the `dateRange` namespace + `datepicker`/`common`), and so do the dialog name, the range roles of
55
- the days and the live announcements. English by default — see `i18n/llms.txt`.
55
+ the days and the live announcements. English by default - see `i18n/llms.txt`.
56
56
 
57
57
  ## Week start, display format and field state
58
58
  - The week starts by the `KptI18n` language (`Intl.Locale#getWeekInfo`, with a fallback list of regions):
59
- en / en-US on Sunday, pl, de, en-GB on Monday. `firstDayOfWeek` (1 = Monday … 7 = Sunday) overrides it;
59
+ en / en-US on Sunday, pl, de, en-GB on Monday. `firstDayOfWeek` (1 = Monday ... 7 = Sunday) overrides it;
60
60
  the headers, the grid and `Home`/`End` follow it.
61
- - `displayFormat`: `'pl'` (DD.MM.YYYY, default), `'iso'` (YYYY-MM-DD) or `'locale'` — order and separators
61
+ - `displayFormat`: `'pl'` (DD.MM.YYYY, default), `'iso'` (YYYY-MM-DD) or `'locale'` - order and separators
62
62
  from `Intl` (en-US: MM/DD/YYYY). The placeholder follows the format and its letters follow the language
63
63
  (EN `YYYY`, PL `RRRR`, the `datepicker.yearToken`/`monthToken`/`dayToken` keys). AM/PM come from `Intl`.
64
64
  - The field is `role="combobox"` with `aria-haspopup="dialog"` (the APG select-only combobox), so it carries
65
- `aria-required` (`required`), `aria-readonly` (`readonly` — the value shows, the panel does not open,
65
+ `aria-required` (`required`), `aria-readonly` (`readonly` - the value shows, the panel does not open,
66
66
  there is no clear button) and `aria-invalid`.
67
- - Turning the page with ‹ › is announced (`aria-live="polite"`); the title buttons are named
68
- "October, Choose month" — the visible text first (WCAG 2.5.3). Clearing the value counts as a touch.
67
+ - Turning the page with < > is announced (`aria-live="polite"`); the title buttons are named
68
+ "October, Choose month" - the visible text first (WCAG 2.5.3). Clearing the value counts as a touch.
69
69
  - "Today" is computed on every open, so a panel opened after midnight marks the right day.
70
- - The clock (`kpt-clock`): the hour and minute segments are `role="spinbutton"` — `↑`/`↓` by one (minutes by
71
- `minuteStep`), `PageUp`/`PageDown` by five, `Home`/`End` to the bounds — so every minute is reachable from
70
+ - The clock (`kpt-clock`): the hour and minute segments are `role="spinbutton"` - `ArrowUp`/`ArrowDown` by one (minutes by
71
+ `minuteStep`), `PageUp`/`PageDown` by five, `Home`/`End` to the bounds - so every minute is reachable from
72
72
  the keyboard, not only the five-minute marks.
73
73
 
74
74
  ## Label and description
75
- `id` goes to the focusable element — the host never carries it; without one it is generated. A `div`
75
+ `id` goes to the focusable element - the host never carries it; without one it is generated. A `div`
76
76
  with a role is not named by `label[for]`, so inside `kpt-form-field` it gets `aria-labelledby`
77
77
  pointing at the wrapper's label (unless `ariaLabel` is set), and the hint or error is added to
78
78
  `aria-describedby`. No `controlId` needed. New: `id`; the trigger is the element that carries it.
@@ -2,10 +2,10 @@
2
2
 
3
3
  Picking a date/time with a custom calendar (CDK Overlay), Signal Forms. The granularity comes from
4
4
  `selectionMode`: date (the default), month+year, year, month, date+time, time only.
5
- The panel is a stack of views — **decade → years → months → days**: clicking a cell goes one level down,
6
- clicking the title goes one level up. The starting level is set by `startView` — for a date of birth use
7
- `startView="decade"` (decade → year → month → day, four clicks instead of hundreds of arrow presses).
8
- The time is picked on a clock dial (two stages: hours → minutes, click or drag), in 12/24h format.
5
+ The panel is a stack of views - **decade -> years -> months -> days**: clicking a cell goes one level down,
6
+ clicking the title goes one level up. The starting level is set by `startView` - for a date of birth use
7
+ `startView="decade"` (decade -> year -> month -> day, four clicks instead of hundreds of arrow presses).
8
+ The time is picked on a clock dial (two stages: hours -> minutes, click or drag), in 12/24h format.
9
9
  Display follows `displayFormat` ('pl'/'iso'/'locale'). The week starts by the language (see below), today is marked, min/max range supported.
10
10
  Requires the CDK overlay styles: `import '@angular/cdk/overlay-prebuilt.css';`
11
11
  Import: `import { KptDatepicker } from '@konce-pt/angular';`
@@ -22,30 +22,30 @@ Import: `import { KptDatepicker } from '@konce-pt/angular';`
22
22
  - `value`: model<string>; `minDate`/`maxDate`: string|null; `placeholder`: string
23
23
  - `selectionMode`: 'date' | 'monthYear' | 'year' | 'month' | 'datetime' | 'time' (default 'date').
24
24
  The value format depends on the mode: 'YYYY-MM-DD' / 'YYYY-MM' / 'YYYY' / 'MM' / 'YYYY-MM-DDTHH:mm' (datetime) / 'HH:mm' (time).
25
- - `startView`: 'day' | 'month' | 'year' | 'decade' | null (default null) — the level the panel
25
+ - `startView`: 'day' | 'month' | 'year' | 'decade' | null (default null) - the level the panel
26
26
  opens at. `null` = the level at which the mode commits a value: 'day' for 'date'/'datetime',
27
- 'month' for 'monthYear'/'month', 'year' for 'year'. It will not go below that level —
27
+ 'month' for 'monthYear'/'month', 'year' for 'year'. It will not go below that level -
28
28
  `startView="day"` in 'year' mode is raised to 'year'. The 'month' mode stays on 'month'
29
29
  (the value is just 'MM', there is nothing to navigate), and the 'time' mode ignores the input.
30
- - `hourFormat`: 12 | 24 (default 24) — an AM/PM dial (12) or one with a 13–00 ring (24); the value is always 24h.
31
- - `minuteStep`: number (default 1) — minute snapping on the dial.
32
- - `monthDisplay`: 'long' | 'number' (default 'long') — in 'month' mode and in month labels: as a word (January) or a number (01)
33
- - `displayFormat`: 'pl' | 'iso' | 'locale' (default 'pl') — the display format and the default placeholder
30
+ - `hourFormat`: 12 | 24 (default 24) - an AM/PM dial (12) or one with a 13-00 ring (24); the value is always 24h.
31
+ - `minuteStep`: number (default 1) - minute snapping on the dial.
32
+ - `monthDisplay`: 'long' | 'number' (default 'long') - in 'month' mode and in month labels: as a word (January) or a number (01)
33
+ - `displayFormat`: 'pl' | 'iso' | 'locale' (default 'pl') - the display format and the default placeholder
34
34
  - `disabled`/`invalid`/`touched`: boolean; the `touch` output.
35
- - `open`: model (two-way `[(open)]`, the `(openChange)` output) — the calendar state. It lets you open
36
- it from outside and know when the user is done choosing — that is what inline editing
35
+ - `open`: model (two-way `[(open)]`, the `(openChange)` output) - the calendar state. It lets you open
36
+ it from outside and know when the user is done choosing - that is what inline editing
37
37
  in `kpt-data-table` does, see `data-table/llms.txt`. `touch` fires when the panel closes and when
38
38
  focus leaves the closed trigger; focus moving into the calendar does not count as leaving.
39
- - `ariaLabel`: string|null — the accessible name when no `<label for>` describes the field
39
+ - `ariaLabel`: string|null - the accessible name when no `<label for>` describes the field
40
40
  (two times in one editor row, for instance). Without it a screen reader announces the value alone.
41
41
  - The icon in the field: a calendar, and a clock in 'time' mode.
42
- - The panel: a clear button (×), the clock dial with "Done".
42
+ - The panel: a clear button (x), the clock dial with "Done".
43
43
 
44
44
  ## Keyboard
45
45
  The date picker dialog pattern. The trigger has `aria-haspopup="dialog"` and `aria-expanded`;
46
- `Enter`, `Space` and `↓` open the panel — a `role="dialog"` named "Choose a date" — and move focus to
46
+ `Enter`, `Space` and `ArrowDown` open the panel - a `role="dialog"` named "Choose a date" - and move focus to
47
47
  the selected day, or today, clamped to `minDate`/`maxDate`.
48
- - Day grid: `←`/`→` one day, `↑`/`↓` one week, `Home`/`End` Monday and Sunday of the week,
48
+ - Day grid: `ArrowLeft`/`ArrowRight` one day, `ArrowUp`/`ArrowDown` one week, `Home`/`End` Monday and Sunday of the week,
49
49
  `PageUp`/`PageDown` one month, with `Shift` one year (the day is clamped to the month length).
50
50
  Crossing a month edge turns the page. Each day is named with the full date from `Intl`
51
51
  ("Thursday, October 8, 2026"), today has `aria-current="date"`, and only the focused day is
@@ -53,53 +53,53 @@ the selected day, or today, clamped to `minDate`/`maxDate`.
53
53
  - Month, year and decade grids: the arrows move between cells (three columns), `Home`/`End` to the ends.
54
54
  Clicking a title moves focus to the new grid.
55
55
  - `Tab` cycles inside the panel; `Escape` closes it. Picking a value (or "Done") closes the panel
56
- and returns focus to the trigger. `Delete`/`Backspace` on the trigger clears the value; the "×" button
56
+ and returns focus to the trigger. `Delete`/`Backspace` on the trigger clears the value; the "x" button
57
57
  sits outside the Tab order.
58
58
 
59
59
  ## Behavior (the view stack)
60
- The panel header always has the shape `‹ title ›`; the arrows move the current level's page,
60
+ The panel header always has the shape `< title >`; the arrows move the current level's page,
61
61
  and the title is a button that goes one level up:
62
62
 
63
- day ‹ [June] [1979] › arrows ±1 month; the chips → months / years
64
- month ‹ [1979] › arrows ±1 year; the chip → years
65
- year ‹ [1970 – 1979] › arrows ±10 years; the chip → decades
66
- decade ‹ 1920 – 2039 › arrows ±120 years; the top of the stack, the title is not clickable
63
+ day < [June] [1979] > arrows +/-1 month; the chips -> months / years
64
+ month < [1979] > arrows +/-1 year; the chip -> years
65
+ year < [1970 - 1979] > arrows +/-10 years; the chip -> decades
66
+ decade < 1920 - 2039 > arrows +/-120 years; the top of the stack, the title is not clickable
67
67
 
68
- A year page is a **full decade** (10 cells, 1970–1979), a decade page holds 12 decades (1920–2039).
68
+ A year page is a **full decade** (10 cells, 1970-1979), a decade page holds 12 decades (1920-2039).
69
69
  Clicking a cell above the committing level goes down; on the committing level it sets
70
70
  the value and closes the panel. The cell containing today gets an outline (like "today" in the day grid).
71
71
  An arrow dims (`disabled`) when the whole neighboring page falls outside `minDate`/`maxDate`.
72
72
 
73
73
  ## i18n
74
74
  Weekday and month names are derived from `Intl` per the active i18n locale (not from the dictionary).
75
- The navigation/aria labels ("previous decades", "choose a year", the dialog name…) and "Done" come from i18n
75
+ The navigation/aria labels ("previous decades", "choose a year", the dialog name...) and "Done" come from i18n
76
76
  (the `datepicker` + `common` namespaces). English by default;
77
- configured through `provideKptI18n` — see `i18n/llms.txt`. Note: `displayFormat` 'pl'/'iso'
77
+ configured through `provideKptI18n` - see `i18n/llms.txt`. Note: `displayFormat` 'pl'/'iso'
78
78
  controls the date format only and is independent of the label language; 'locale' follows it.
79
79
 
80
80
  ## Core
81
- The grids, bounds, paging and formats come from `@konce-pt/datetime` — the same framework-free
81
+ The grids, bounds, paging and formats come from `@konce-pt/datetime` - the same framework-free
82
82
  package the React port uses, with its own tests. The component holds signals and markup only.
83
83
 
84
84
  ## Week start, display format and field state
85
85
  - The week starts by the `KptI18n` language (`Intl.Locale#getWeekInfo`, with a fallback list of regions):
86
- en / en-US on Sunday, pl, de, en-GB on Monday. `firstDayOfWeek` (1 = Monday … 7 = Sunday) overrides it;
86
+ en / en-US on Sunday, pl, de, en-GB on Monday. `firstDayOfWeek` (1 = Monday ... 7 = Sunday) overrides it;
87
87
  the headers, the grid and `Home`/`End` follow it.
88
- - `displayFormat`: `'pl'` (DD.MM.YYYY, default), `'iso'` (YYYY-MM-DD) or `'locale'` — order and separators
88
+ - `displayFormat`: `'pl'` (DD.MM.YYYY, default), `'iso'` (YYYY-MM-DD) or `'locale'` - order and separators
89
89
  from `Intl` (en-US: MM/DD/YYYY). The placeholder follows the format and its letters follow the language
90
90
  (EN `YYYY`, PL `RRRR`, the `datepicker.yearToken`/`monthToken`/`dayToken` keys). AM/PM come from `Intl`.
91
91
  - The field is `role="combobox"` with `aria-haspopup="dialog"` (the APG select-only combobox), so it carries
92
- `aria-required` (`required`), `aria-readonly` (`readonly` — the value shows, the panel does not open,
92
+ `aria-required` (`required`), `aria-readonly` (`readonly` - the value shows, the panel does not open,
93
93
  there is no clear button) and `aria-invalid`.
94
- - Turning the page with ‹ › is announced (`aria-live="polite"`); the title buttons are named
95
- "October, Choose month" — the visible text first (WCAG 2.5.3). Clearing the value counts as a touch.
94
+ - Turning the page with < > is announced (`aria-live="polite"`); the title buttons are named
95
+ "October, Choose month" - the visible text first (WCAG 2.5.3). Clearing the value counts as a touch.
96
96
  - "Today" is computed on every open, so a panel opened after midnight marks the right day.
97
- - The clock (`kpt-clock`): the hour and minute segments are `role="spinbutton"` — `↑`/`↓` by one (minutes by
98
- `minuteStep`), `PageUp`/`PageDown` by five, `Home`/`End` to the bounds — so every minute is reachable from
97
+ - The clock (`kpt-clock`): the hour and minute segments are `role="spinbutton"` - `ArrowUp`/`ArrowDown` by one (minutes by
98
+ `minuteStep`), `PageUp`/`PageDown` by five, `Home`/`End` to the bounds - so every minute is reachable from
99
99
  the keyboard, not only the five-minute marks.
100
100
 
101
101
  ## Label and description
102
- `id` goes to the focusable element — the host never carries it; without one it is generated. A `div`
102
+ `id` goes to the focusable element - the host never carries it; without one it is generated. A `div`
103
103
  with a role is not named by `label[for]`, so inside `kpt-form-field` it gets `aria-labelledby`
104
104
  pointing at the wrapper's label (unless `ariaLabel` is set), and the hint or error is added to
105
105
  `aria-describedby`. No `controlId` needed. New: `id`; the trigger is the element that carries it.
@@ -7,26 +7,20 @@ Import: `import { KptDialog } from '@konce-pt/angular';`
7
7
  `kpt-dialog`
8
8
 
9
9
  ## Inputs
10
- - `open`: model<boolean> — two-way `[(open)]`
11
- - `header`: string; `dismissible`: boolean (Esc/× closes it; default true)
12
- - `size`: 'sm' | 'md' | 'lg' (default 'md') — 24rem / 32rem / 48rem, always capped at the viewport
10
+ - `open`: model<boolean> - two-way `[(open)]`
11
+ - `header`: string; `dismissible`: boolean (Esc/x closes it; default true)
12
+ - `size`: 'sm' | 'md' | 'lg' | 'full' (default 'md') - 24rem / 32rem / 48rem, always capped at the viewport
13
13
  (`min(var(--_width), calc(100vw - 2rem))`). Reach for `lg` when the content cannot sensibly be
14
- narrowed: code, a table, two columns side by side.
15
- - `ariaLabel`: string — the name of a dialog with no `header` (with one, the header names it)
16
- - `ariaDescribedby`: string | null — the `id` of the element that describes the dialog
17
- - `alert`: boolean — `role="alertdialog"`, for a window that interrupts and demands an answer
18
- - `ariaLabel`: string — the name of a dialog with no `header` (with one, the header names it)
19
- - `ariaDescribedby`: string | null — the `id` of the element that describes the dialog
20
- - `alert`: boolean — `role="alertdialog"`, for a window that interrupts and demands an answer
21
- - `ariaLabel`: string — the name of a dialog with no `header` (with one, the header names it)
22
- - `ariaDescribedby`: string | null — the `id` of the element that describes the dialog
23
- - `alert`: boolean — `role="alertdialog"`, for a window that interrupts and demands an answer
24
- - `ariaLabel`: string — the name of a dialog with no `header` (with one, the header names it)
25
- - `ariaDescribedby`: string | null — the `id` of the element that describes the dialog
26
- - `alert`: boolean — `role="alertdialog"`, for a window that interrupts and demands an answer
14
+ narrowed: code, a table, two columns side by side. `full` covers the whole screen (`100vw` x `100dvh`,
15
+ no border, radius or margin, safe-area padding) and the body grows to the full height - for a camera
16
+ preview, an editor, or a window that should be its own screen on a phone:
17
+ `[size]="phone() ? 'full' : 'md'"`.
18
+ - `ariaLabel`: string - the name of a dialog with no `header` (with one, the header names it)
19
+ - `ariaDescribedby`: string | null - the `id` of the element that describes the dialog
20
+ - `alert`: boolean - `role="alertdialog"`, for a window that interrupts and demands an answer
27
21
 
28
22
  ## Slots
29
- - the default content → the body; an element with the `kptDialogFooter` attribute → the footer
23
+ - the default content -> the body; an element with the `kptDialogFooter` attribute -> the footer
30
24
 
31
25
  ## Example
32
26
  <kpt-dialog [(open)]="confirmOpen" header="Delete this?">
@@ -39,19 +33,19 @@ Import: `import { KptDialog } from '@konce-pt/angular';`
39
33
 
40
34
  ## Tokens
41
35
  `--kpt-color-surface-raised`, `--kpt-color-overlay-scrim` (::backdrop), `--kpt-elevation-4`.
42
- Note: the global reset zeroes the margin — the component restores `margin:auto` (centering).
36
+ Note: the global reset zeroes the margin - the component restores `margin:auto` (centering).
43
37
 
44
38
  ## CDK Overlay controls inside the dialog
45
39
 
46
40
  `kpt-dialog` stands on the native `<dialog>` and opens through `showModal()`, which lifts it
47
- into the browser's **top layer** — and that sits above the entire document tree, where no
41
+ into the browser's **top layer** - and that sits above the entire document tree, where no
48
42
  `z-index` can reach it. The CDK Overlay container hangs off `<body>` by default, so the panels of
49
43
  `kpt-select`, `kpt-datepicker`, `kpt-autocomplete` and `kpt-menu` would open inside the
50
44
  dialog INVISIBLE, hidden behind its background.
51
45
 
52
46
  That is why, while it is open, `kpt-dialog` moves the overlay container inside the `<dialog>`
53
47
  and puts it back on close (including when the component is destroyed
54
- with the dialog open). Nothing needs configuring — overlay controls behave inside the dialog
48
+ with the dialog open). Nothing needs configuring - overlay controls behave inside the dialog
55
49
  exactly as they do outside it.
56
50
 
57
51
  ## Layout and scrolling
@@ -62,15 +56,15 @@ The scrollbar therefore runs alongside the content, not alongside the whole dial
62
56
 
63
57
  The content gets `flex: 0 1 auto` (the default) + `min-height: 0`, deliberately **not** `flex: 1`
64
58
  as in `kpt-drawer`. A drawer fills the height of the screen, a dialog is meant to shrink to its content:
65
- a short one (`kpt-confirm` — two sentences and two buttons) stays short, a long one stops
59
+ a short one (`kpt-confirm` - two sentences and two buttons) stays short, a long one stops
66
60
  at `max-height: calc(100vh - 4rem)` and scrolls the content alone.
67
61
 
68
62
  The `display: flex` declaration is scoped with `&[open]` and has to stay that way. The
69
63
  `dialog:not([open]) { display: none }` rule comes from the browser stylesheet, and any author
70
- declaration beats it — including one inside `@layer`. An unscoped `display: flex` would leave every
64
+ declaration beats it - including one inside `@layer`. An unscoped `display: flex` would leave every
71
65
  closed dialog visible on the page.
72
66
 
73
- `.kpt-dialog` does not get `overflow: hidden` — while it is open the CDK Overlay container is
67
+ `.kpt-dialog` does not get `overflow: hidden` - while it is open the CDK Overlay container is
74
68
  moved inside the `<dialog>` (see the section above), so clipping the dialog would cut off the
75
69
  panels of `kpt-select` or `kpt-datepicker`. It is not needed for scrolling either:
76
70
  once it is a flex column, nothing sticks out of the dialog.
@@ -78,22 +72,22 @@ once it is a flex column, nothing sticks out of the dialog.
78
72
  ## The footer wraps
79
73
 
80
74
  `[kptDialogFooter]` is a flex row with `flex-wrap: wrap`, and the wrapping is not cosmetic.
81
- A dialog that does not fit its buttons does not let them stick out — they get **clipped**, because
75
+ A dialog that does not fit its buttons does not let them stick out - they get **clipped**, because
82
76
  the browser gives `<dialog>` its own scrolling box. Four buttons in an `sm` dialog are enough for
83
77
  the first one to become unreadable with no way to reach it. Wrapping turns that into a second row.
84
78
 
85
79
  A pinned action bar inside the content (say "Cancel / Save" in `kpt-map-create-dialog`)
86
- is done with `position: sticky` — the scrolling container is `.kpt-dialog__body`.
80
+ is done with `position: sticky` - the scrolling container is `.kpt-dialog__body`.
87
81
  The negative side margins have to match its padding (`--kpt-space-6`),
88
82
  and the `bottom` offset has to mirror the negative bottom margin
89
- (`bottom: calc(var(--kpt-space-6) * -1)`) — stickiness is computed for the margin
83
+ (`bottom: calc(var(--kpt-space-6) * -1)`) - stickiness is computed for the margin
90
84
  box, so with `bottom: 0` a sliver of content would slide underneath the bar.
91
85
 
92
86
  ## Accessibility
93
87
  `showModal()` gives the focus trap, Escape and the inert page; focus returns to the opener on
94
88
  close. With `header` the dialog is named by its `<h2>` (`aria-labelledby`); without it pass
95
89
  `ariaLabel`. `alert` + `ariaDescribedby` make it an alert dialog whose message is read out on
96
- open — `kpt-confirm-container` uses exactly that.
90
+ open - `kpt-confirm-container` uses exactly that.
97
91
 
98
92
  ## Scrolling and non-dismissible windows
99
- An open window locks page scrolling underneath (a shared counter with drawers and bottom sheets, so nested windows do not release each other). With `dismissible` off the window gets `closedby="none"`, and if a browser still closes it on a gesture (Chromium lets the second Escape in a row through `cancel`), it is reopened — only code can close it.
93
+ An open window locks page scrolling underneath (a shared counter with drawers and bottom sheets, so nested windows do not release each other). With `dismissible` off the window gets `closedby="none"`, and if a browser still closes it on a gesture (Chromium lets the second Escape in a row through `cancel`), it is reopened - only code can close it.
@@ -8,8 +8,8 @@ Import: `import { KptDivider } from '@konce-pt/angular';`
8
8
 
9
9
  ## Inputs
10
10
  - `orientation`: 'horizontal' | 'vertical' (default 'horizontal')
11
- - `inset`: boolean — inset from the container edges
12
- - `decorative`: boolean — a purely ornamental line (e.g. between cards that are regions anyway): no `role="separator"`, hidden from screen readers
11
+ - `inset`: boolean - inset from the container edges
12
+ - `decorative`: boolean - a purely ornamental line (e.g. between cards that are regions anyway): no `role="separator"`, hidden from screen readers
13
13
 
14
14
  ## Example
15
15
  <kpt-divider />
@@ -6,30 +6,30 @@ A sliding panel (drawer / off-canvas) driven by the `open` signal. Independent o
6
6
  ## Inputs / model
7
7
  - `open`: model<boolean> (two-way)
8
8
  - `position`: 'left' | 'right' | 'top' | 'bottom' (KptDrawerPosition)
9
- - `header`: string; `dismissible`: boolean (× and Esc); `closeOnBackdrop`: boolean
9
+ - `header`: string; `dismissible`: boolean (x and Esc); `closeOnBackdrop`: boolean
10
10
  - Content through the `<ng-content>` projection.
11
11
 
12
12
  ## Example
13
13
  <kpt-button (click)="menuOpen.set(true)">Menu</kpt-button>
14
- <kpt-drawer [(open)]="menuOpen" position="right" header="Filters">…</kpt-drawer>
14
+ <kpt-drawer [(open)]="menuOpen" position="right" header="Filters">...</kpt-drawer>
15
15
 
16
16
  ## The closed state / a11y
17
- The panel is always in the DOM (no `@if`), hidden with `transform` **and** `visibility: hidden` — never
17
+ The panel is always in the DOM (no `@if`), hidden with `transform` **and** `visibility: hidden` - never
18
18
  `display: none`, so that the slide-in and slide-out animations survive. `visibility` takes the closed panel
19
19
  out of the tab order and out of the accessibility tree without `inert`, and it does so on the very first frame,
20
20
  without waiting for JavaScript. Both closed-state declarations live in the **base** rule, not in
21
- `[data-position]` — Angular only sets the position attribute during the update pass, so a panel gated on that
21
+ `[data-position]` - Angular only sets the position attribute during the update pass, so a panel gated on that
22
22
  attribute would flash on screen and then animate away. `prefers-reduced-motion: reduce`
23
23
  drops the transitions.
24
24
 
25
25
  ## Focus and keyboard
26
26
  Opening moves focus into the panel (`cdkFocusInitial`, else its first focusable element, else the
27
- panel itself) and traps it there — `Tab` / `Shift+Tab` wrap inside, as `aria-modal="true"` promises.
28
- Closing returns focus to the element that had it before. `Escape` closes the panel — only when `dismissible`, like the `×` button. The panel
27
+ panel itself) and traps it there - `Tab` / `Shift+Tab` wrap inside, as `aria-modal="true"` promises.
28
+ Closing returns focus to the element that had it before. `Escape` closes the panel - only when `dismissible`, like the `x` button. The panel
29
29
  is named by its `header` through `aria-labelledby`. The shared helper is `shared/modal-focus.ts` (on the CDK focus trap; the React port has a twin hook).
30
30
 
31
31
  ## Tokens
32
32
  The panel `--kpt-color-surface-raised`, `--kpt-elevation-4`; the backdrop `--kpt-color-overlay-scrim`.
33
33
 
34
34
  ## Name and scrolling
35
- Without `header` give the panel `ariaLabel` — a `role="dialog"` without a name is announced as a bare "dialog". An open drawer locks page scrolling underneath.
35
+ Without `header` give the panel `ariaLabel` - a `role="dialog"` without a name is announced as a bare "dialog". An open drawer locks page scrolling underneath.
@@ -1,12 +1,12 @@
1
1
  # KptEmpty (kpt-empty)
2
2
 
3
- An empty state — an icon, a title, a description and optional actions (content projection).
3
+ An empty state - an icon, a title, a description and optional actions (content projection).
4
4
  Import: `import { KptEmpty } from '@konce-pt/angular';`
5
5
 
6
6
  ## Inputs
7
7
  - `icon`: string | null (default 'info-circle')
8
8
  - `title`: string; `description`: string
9
- - `headingLevel`: 1–6 | null (default null) — makes the title a heading (`role="heading"` + `aria-level`)
9
+ - `headingLevel`: 1-6 | null (default null) - makes the title a heading (`role="heading"` + `aria-level`)
10
10
  - Actions: `<ng-content>` (buttons, for instance).
11
11
 
12
12
  ## Example
@@ -18,6 +18,6 @@ Import: `import { KptEmpty } from '@konce-pt/angular';`
18
18
  The icon sits in a `--kpt-color-muted` circle; text `--kpt-color-on-surface(-muted)`.
19
19
 
20
20
  ## Accessibility
21
- The icon is decorative. The title is a styled paragraph unless `headingLevel` makes it a heading —
21
+ The icon is decorative. The title is a styled paragraph unless `headingLevel` makes it a heading -
22
22
  use that when the empty state stands in for a whole section. Replacing results with an empty state
23
- is not announced; report “0 results” in a live region of your own.
23
+ is not announced; report "0 results" in a live region of your own.
@@ -1,6 +1,6 @@
1
1
  # KptFab (kpt-fab)
2
2
 
3
- A floating action button — a raised action button (a rounded square; `extended` is a pill). Import: `import { KptFab } from '@konce-pt/angular';`
3
+ A floating action button - a raised action button (a rounded square; `extended` is a pill). Import: `import { KptFab } from '@konce-pt/angular';`
4
4
 
5
5
  ## Inputs
6
6
  - `variant`: 'filled' | 'tonal' (default 'filled')
@@ -8,7 +8,7 @@ A floating action button — a raised action button (a rounded square; `extended
8
8
  - `extended`: boolean (a pill with text)
9
9
  - `disabled`: boolean; `type`: 'button' | 'submit' | 'reset'
10
10
  - `ariaLabel`: string (required for the round, textless variant)
11
- - `ariaExpanded`: `boolean | null` = `null`, `ariaControls`: `string | null` = `null` — for a FAB that opens
11
+ - `ariaExpanded`: `boolean | null` = `null`, `ariaControls`: `string | null` = `null` - for a FAB that opens
12
12
  a panel (`kpt-speed-dial` uses them); they land on the inner `<button>`, the host has no button role
13
13
 
14
14
  ## Example
@@ -16,6 +16,10 @@ A floating action button — a raised action button (a rounded square; `extended
16
16
  <kpt-fab extended><kpt-icon name="plus" /> New</kpt-fab>
17
17
  <kpt-fab variant="tonal" size="mini" ariaLabel="Edit"><kpt-icon name="copy" /></kpt-fab>
18
18
 
19
+ ## Motion
20
+ Pressed, it squeezes slightly and springs back on release (shared mixin `styles/_press.scss`). Pure CSS; durations follow `--kpt-motion-scale`, so `enabled: false` turns it off, and it drops out
21
+ under "reduce motion".
22
+
19
23
  ## Tokens
20
24
  Background `--kpt-color-primary` / `--kpt-color-muted` (tonal); shadow `--kpt-elevation-3`, `--kpt-elevation-4` on hover;
21
25
  shape `--kpt-radius-lg` (md), `--kpt-radius-md` (mini), `--kpt-radius-full` (extended).
@@ -5,13 +5,31 @@ Import: `import { KptFieldset } from '@konce-pt/angular';`
5
5
 
6
6
  ## Inputs / model
7
7
  - `legend`: string
8
+ - `variant`: 'outlined' | 'filled' (default 'outlined') - `outlined` is just the frame on the parent's
9
+ background; `filled` puts the group on the surface colour (sections inside a grey panel, say).
10
+ The legend takes the group's background with rounded ends, so where it crosses the frame it reads
11
+ as one element, never as a strip in two colours
8
12
  - `toggleable`: boolean; `collapsed`: model<boolean>
9
- - `animated`: boolean (default true) — the collapse animation (CSS grid, pure CSS)
10
- - `animationDuration`: number (default 500) — animation time in ms
13
+ - `animated`: boolean (default true) - the collapse animation (CSS grid, pure CSS)
14
+ - `animationDuration`: number (default 500) - animation time in ms
15
+ - `collapseMotion`: `'spring' | 'fade' | 'none'` (default from `provideKptMotion`, else `spring`) - see "Collapse motion"
11
16
  - Content: `<ng-content>`.
12
17
 
13
18
  ## Example
14
- <kpt-fieldset legend="Personal details" toggleable>…</kpt-fieldset>
19
+ <kpt-fieldset legend="Personal details" toggleable>...</kpt-fieldset>
20
+ <kpt-fieldset legend="Scrolling" variant="filled">...</kpt-fieldset>
21
+
22
+ ## Collapse motion
23
+ - `spring` - the height opens on a soft spring, the content slides in from above and sharpens out
24
+ of a blur; when collapsing, the content fades first and only then the section closes. The chevron
25
+ turns on a spring.
26
+ - `fade` - the height on the standard curve, the content cross-fades.
27
+ - `none` - the state changes without motion.
28
+
29
+ With no value it takes `collapse` from `provideKptMotion` (default `spring`). `animated: false`, `enabled: false`
30
+ in the config and the system "reduce motion" setting always turn it off. `animationDuration` sets
31
+ the time of every kind. Pure CSS: the kind sits in `data-motion` on the component root.
15
32
 
16
33
  ## Tokens
17
- Border `--kpt-color-border`; radius `--kpt-radius-md`.
34
+ Border `--kpt-color-border`; radius `--kpt-radius-md`; `filled` background `--kpt-color-surface`;
35
+ legend corners `--kpt-radius-full`.
@@ -34,4 +34,4 @@ The zone `--kpt-color-border-strong` (dashed), hover / dragover `--kpt-color-pri
34
34
  focus ring `--kpt-color-focus-ring`.
35
35
 
36
36
  ## Read-only and required
37
- `readonly` shows the list without the remove buttons and does not open the picker nor accept a drop. The zone takes `id` and `ariaLabel` and is linked to `kpt-form-field` (label and description); `button` accepts neither `aria-invalid` nor `aria-required`, so the error is the linked message. The hint is plain text: `fileUpload.hint` with `{action}` and `fileUpload.hintAction` (bold) — dictionaries no longer carry HTML. The remove button names the file.
37
+ `readonly` shows the list without the remove buttons and does not open the picker nor accept a drop. The zone takes `id` and `ariaLabel` and is linked to `kpt-form-field` (label and description); `button` accepts neither `aria-invalid` nor `aria-required`, so the error is the linked message. The hint is plain text: `fileUpload.hint` with `{action}` and `fileUpload.hintAction` (bold) - dictionaries no longer carry HTML. The remove button names the file.