@konce-pt/angular 0.11.2 → 0.14.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 (116) hide show
  1. package/CHANGELOG.md +792 -333
  2. package/README.md +111 -55
  3. package/charts/src/lib/llms.txt +23 -15
  4. package/chat/src/lib/llms.txt +68 -33
  5. package/fesm2022/konce-pt-angular-charts.mjs +149 -68
  6. package/fesm2022/konce-pt-angular-charts.mjs.map +1 -1
  7. package/fesm2022/konce-pt-angular-chat.mjs +296 -135
  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 +360 -293
  14. package/fesm2022/konce-pt-angular-map.mjs.map +1 -1
  15. package/fesm2022/konce-pt-angular-roadmap.mjs +120 -34
  16. package/fesm2022/konce-pt-angular-roadmap.mjs.map +1 -1
  17. package/fesm2022/konce-pt-angular.mjs +7117 -3373
  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 -140
  21. package/package.json +14 -12
  22. package/roadmap/src/lib/llms.txt +37 -27
  23. package/src/lib/accordion/llms.txt +18 -6
  24. package/src/lib/alert/llms.txt +5 -4
  25. package/src/lib/app-shell/llms.txt +25 -22
  26. package/src/lib/auth/llms.txt +26 -22
  27. package/src/lib/autocomplete/llms.txt +18 -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 +6 -3
  33. package/src/lib/breadcrumb/llms.txt +9 -1
  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 +40 -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 +17 -2
  40. package/src/lib/chip/llms.txt +6 -6
  41. package/src/lib/chips-input/llms.txt +14 -4
  42. package/src/lib/color-picker/llms.txt +7 -4
  43. package/src/lib/confirm/llms.txt +9 -3
  44. package/src/lib/context-menu/llms.txt +7 -4
  45. package/src/lib/data-table/llms.txt +280 -227
  46. package/src/lib/data-view/llms.txt +25 -4
  47. package/src/lib/date-range/llms.txt +37 -18
  48. package/src/lib/datepicker/llms.txt +46 -29
  49. package/src/lib/dialog/llms.txt +29 -26
  50. package/src/lib/divider/llms.txt +2 -1
  51. package/src/lib/drawer/llms.txt +9 -6
  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 +3 -0
  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 +15 -8
  59. package/src/lib/icon/llms.txt +9 -9
  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 +5 -2
  64. package/src/lib/input-number/llms.txt +18 -15
  65. package/src/lib/input-otp/llms.txt +15 -4
  66. package/src/lib/knob/llms.txt +14 -7
  67. package/src/lib/listbox/llms.txt +8 -5
  68. package/src/lib/loader/llms.txt +72 -0
  69. package/src/lib/megamenu/llms.txt +16 -5
  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 +16 -5
  73. package/src/lib/meter-group/llms.txt +7 -7
  74. package/src/lib/order-list/llms.txt +20 -5
  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 +17 -5
  78. package/src/lib/peek/llms.txt +11 -11
  79. package/src/lib/pick-list/llms.txt +28 -5
  80. package/src/lib/popover/llms.txt +9 -6
  81. package/src/lib/progress/llms.txt +16 -16
  82. package/src/lib/radio-group/llms.txt +13 -3
  83. package/src/lib/rating/llms.txt +13 -6
  84. package/src/lib/rich-text/llms.txt +42 -24
  85. package/src/lib/scroll-top/llms.txt +3 -3
  86. package/src/lib/select/llms.txt +23 -13
  87. package/src/lib/sidenav/llms.txt +8 -8
  88. package/src/lib/slider/llms.txt +23 -7
  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 +26 -7
  95. package/src/lib/switch/llms.txt +13 -3
  96. package/src/lib/switch-group/llms.txt +12 -9
  97. package/src/lib/tabs/llms.txt +7 -4
  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 +36 -5
  101. package/src/lib/toolbar/llms.txt +3 -3
  102. package/src/lib/tooltip/llms.txt +13 -10
  103. package/src/lib/tree/llms.txt +19 -5
  104. package/src/lib/update/llms.txt +52 -0
  105. package/types/konce-pt-angular-charts.d.ts +11 -0
  106. package/types/konce-pt-angular-charts.d.ts.map +1 -1
  107. package/types/konce-pt-angular-chat.d.ts +98 -40
  108. package/types/konce-pt-angular-chat.d.ts.map +1 -1
  109. package/types/konce-pt-angular-grid.d.ts +14 -14
  110. package/types/konce-pt-angular-icons.d.ts +3 -3
  111. package/types/konce-pt-angular-map.d.ts +147 -119
  112. package/types/konce-pt-angular-map.d.ts.map +1 -1
  113. package/types/konce-pt-angular-roadmap.d.ts +34 -9
  114. package/types/konce-pt-angular-roadmap.d.ts.map +1 -1
  115. package/types/konce-pt-angular.d.ts +1774 -651
  116. package/types/konce-pt-angular.d.ts.map +1 -1
@@ -1,21 +1,21 @@
1
1
  # KptChip (kpt-chip)
2
2
 
3
- A chip / tag — a label, optionally removable. Import: `import { KptChip } from '@konce-pt/angular';`
3
+ A chip / tag - a label, optionally removable. Import: `import { KptChip } from '@konce-pt/angular';`
4
4
 
5
5
  ## Inputs / outputs
6
6
  - `variant`: 'neutral'|'primary'|'success'|'danger'|'warning'|'info'
7
- - `textTransform`: 'none'|'capitalize'|'uppercase'|'lowercase' (default 'none') — the label's letter case
8
- - `removable`: boolean (a × button); `disabled`: boolean; `removed`: output<void>
7
+ - `textTransform`: 'none'|'capitalize'|'uppercase'|'lowercase' (default 'none') - the label's letter case
8
+ - `removable`: boolean (a x button); `disabled`: boolean; `removed`: output<void>
9
9
 
10
10
  ## Examples
11
11
  <kpt-chip>Angular</kpt-chip>
12
12
  <kpt-chip variant="success" removable (removed)="onRemove()">UI</kpt-chip>
13
- <kpt-chip textTransform="capitalize">new · starter kit</kpt-chip>
13
+ <kpt-chip textTransform="capitalize">new, starter kit</kpt-chip>
14
14
 
15
15
  ## Letter case
16
16
  `textTransform` sets `text-transform` on the chip, so the label can stay in the application's own
17
17
  wording while the chip decides how it is displayed. `capitalize` raises the first letter of every
18
- word — **including after a hyphen** ("Agent-Ready"), because CSS does not know where a compound
18
+ word - **including after a hyphen** ("Agent-Ready"), because CSS does not know where a compound
19
19
  word ends. For labels with a hyphen, spelling it out in the content is the exact route.
20
20
 
21
21
  ## Tokens
@@ -23,6 +23,6 @@ A color-mix background over the variant, `--kpt-color-muted` (neutral).
23
23
 
24
24
  ## Accessibility
25
25
  The label sits in `.kpt-chip__label`, and the remove button is named by `aria-labelledby` from
26
- itself plus that label — “Remove Angular” — so with several chips a screen reader user hears which
26
+ itself plus that label - "Remove Angular" - so with several chips a screen reader user hears which
27
27
  one goes. `Backspace` and `Delete` on the button work like a click. After removal focus falls back
28
28
  to the page; move it to the next chip yourself.
@@ -1,6 +1,6 @@
1
1
  # KptChipsInput (kpt-chips-input)
2
2
 
3
- A tag field — add with Enter or a comma, remove with Backspace or the × button. Signal Forms.
3
+ A tag field - add with Enter or a comma, remove with Backspace or the x button. Signal Forms.
4
4
  The value is a string[]. Items are rendered through `kpt-chip`.
5
5
  Import: `import { KptChipsInput } from '@konce-pt/angular';`
6
6
 
@@ -11,20 +11,30 @@ Import: `import { KptChipsInput } from '@konce-pt/angular';`
11
11
  - `disabled`/`invalid`/`touched`: boolean; `touch`: output
12
12
 
13
13
  ## Example
14
- <kpt-chips-input [formField]="f.tags" placeholder="Add a tag…" />
14
+ <kpt-chips-input [formField]="f.tags" placeholder="Add a tag..." />
15
15
  <kpt-chips-input [(value)]="tags" />
16
16
 
17
17
  ## Screen reader and keyboard
18
18
  The tags are a list (`role="list"`/`listitem`), so a screen reader hears how many there are. Adding,
19
19
  removing (also with `Backspace`) and a rejected duplicate are announced by a polite live region
20
20
  (`chipsInput.added`/`removed`/`duplicate`); a duplicate stays in the field to be corrected instead
21
- of vanishing. After removing a tag with its `×`, focus returns to the text field.
21
+ of vanishing. After removing a tag with its `x`, focus returns to the text field.
22
22
 
23
23
  ## Label and description
24
- `id` goes to the native field — the host never carries it; without one it is generated. Inside
24
+ `id` goes to the native field - the host never carries it; without one it is generated. Inside
25
25
  `kpt-form-field` the control links itself: the wrapper's `label[for]` points at it and the hint or
26
26
  error is added to `aria-describedby`, so `controlId` is not needed. Without a wrapper, name it with
27
27
  `ariaLabel`. New: `id`, `ariaLabel`, `required` and `aria-invalid` on the text field.
28
28
 
29
+ ## Motion
30
+ An added tag pops in (grows from a smaller size and sharpens out of a blur); a removed one - by its "x"
31
+ or by `Backspace` - fades and shrinks in place while the following tags and the text field slide over on
32
+ a spring. The value changes at once; the motion only illustrates it. Follows `enter` from `provideKptMotion`
33
+ (`spring` / `fade` - only fades, the neighbours slide without the spring / `none`); `enabled: false`
34
+ and the system "reduce motion" setting always win.
35
+
29
36
  ## Tokens
30
37
  The field uses `--kpt-form-field-*`; the tags inherit from `kpt-chip`.
38
+
39
+ ## Read-only and required
40
+ `readonly` shows the tags without the remove buttons and ignores Enter, comma and Backspace. Enter during IME composition (CJK) confirms the character, not a tag. A repeated message (a second rejected duplicate) is announced again.
@@ -4,8 +4,8 @@ Color selection (swatch + hex + presets) on Signal Forms. The value is a hex str
4
4
  Import: `import { KptColorPicker } from '@konce-pt/angular';`
5
5
 
6
6
  ## Inputs / model
7
- - `value`: model<string> (or `formField`) — the hex color
8
- - `presets`: string[] — the quick-pick palette (8 colors by default)
7
+ - `value`: model<string> (or `formField`) - the hex color
8
+ - `presets`: string[] - the quick-pick palette (8 colors by default)
9
9
  - `disabled`/`invalid`/`touched`: boolean; `touch`: output
10
10
 
11
11
  ## Example
@@ -17,12 +17,12 @@ Import: `import { KptColorPicker } from '@konce-pt/angular';`
17
17
  ## Screen reader and keyboard
18
18
  `presets` accepts codes or `{ value, label }` (the `KptColorPreset` type): the label names the
19
19
  swatch, because a hex code says little to a screen reader; the default palette is named from i18n
20
- (`colorPicker.red`…). The active swatch has `aria-pressed`. The hex field changes the value only on
20
+ (`colorPicker.red`...). The active swatch has `aria-pressed`. The hex field changes the value only on
21
21
  a full `#rrggbb` code (a missing `#` is added); an incomplete code stays visible with
22
22
  `aria-invalid`.
23
23
 
24
24
  ## Label and description
25
- `id` goes to the native field — the host never carries it; without one it is generated. Inside
25
+ `id` goes to the native field - the host never carries it; without one it is generated. Inside
26
26
  `kpt-form-field` the control links itself: the wrapper's `label[for]` points at it and the hint or
27
27
  error is added to `aria-describedby`, so `controlId` is not needed. Without a wrapper, name it with
28
28
  `ariaLabel`. `id` and the label go to the hex field; the native colour well is named "Pick a colour"
@@ -30,3 +30,6 @@ error is added to `aria-describedby`, so `controlId` is not needed. Without a wr
30
30
 
31
31
  ## Tokens
32
32
  The border `--kpt-form-field-border`; the active preset `--kpt-color-primary`.
33
+
34
+ ## Read-only and required
35
+ `readonly` blocks the picker, the code field and the presets; `required` sets `aria-required` on the code field. Picking a preset or a colour counts as a touch. The code field takes `fff`, `#fff` and `#ffffff` and is not rewritten while typing, so the caret does not jump.
@@ -5,7 +5,13 @@ Import: `import { KptConfirmService, KptConfirmContainer } from '@konce-pt/angul
5
5
 
6
6
  ## Usage
7
7
  1. Place `<kpt-confirm-container />` once in the application (next to `<kpt-toast-container />`).
8
- 2. Inject `KptConfirmService` and call `confirm(options)` → Promise<boolean>.
8
+ 2. Inject `KptConfirmService` and call `confirm(options)` -> Promise<boolean>.
9
+
10
+ ## The promise always settles
11
+ Escape and x resolve `false`. A second `confirm()` while one is open resolves the previous one with
12
+ `false` and shows the new one - one request at a time, and no `await` is left hanging. Without a
13
+ mounted `<kpt-confirm-container />` the dialog cannot appear, so in dev mode `confirm()` warns in the
14
+ console.
9
15
 
10
16
  ## KptConfirmOptions
11
17
  - `message`: string (required); `header?`: string
@@ -13,7 +19,7 @@ Import: `import { KptConfirmService, KptConfirmContainer } from '@konce-pt/angul
13
19
 
14
20
  ## i18n
15
21
  The default labels (the header, Confirm, Cancel) come from i18n (the `confirm` namespace); the option fields take priority.
16
- English by default; configured through `provideKptI18n` — see `i18n/llms.txt`.
22
+ English by default; configured through `provideKptI18n` - see `i18n/llms.txt`.
17
23
 
18
24
  ## Example
19
25
  const ok = await this.confirm.confirm({
@@ -27,4 +33,4 @@ Inherited from `kpt-dialog`; the icon follows the variant (`--kpt-color-danger`
27
33
  ## Accessibility
28
34
  The window is `role="alertdialog"` named by its header, with the message tied to it through
29
35
  `aria-describedby`, so a screen reader reads the question as soon as it opens. Focus starts on the
30
- reject button — the safe answer, so a stray `Enter` deletes nothing. Escape and × reject.
36
+ reject button - the safe answer, so a stray `Enter` deletes nothing. Escape and x reject.
@@ -4,10 +4,10 @@ A context menu (right mouse button) over the projected area. The panel is positi
4
4
  Import: `import { KptContextMenu } from '@konce-pt/angular';`
5
5
 
6
6
  ## Inputs / outputs
7
- - `items`: KptMenuItem<T>[] — { label, icon?, danger?, disabled?, separator? }
7
+ - `items`: KptMenuItem<T>[] - { label, icon?, danger?, disabled?, separator? }
8
8
  It also honors `header` (a non-clickable row with `avatar`/`label`/`description`), `description`
9
- (a second line) and `badge` + `badgeVariant` (a badge on the right) — described in full in menu/llms.txt.
10
- - `selected`: KptMenuItem<T> — the picked entry
9
+ (a second line) and `badge` + `badgeVariant` (a badge on the right) - described in full in menu/llms.txt.
10
+ - `selected`: KptMenuItem<T> - the picked entry
11
11
  - The area that reacts to the right mouse button comes through `<ng-content>`.
12
12
 
13
13
  ## Example
@@ -19,9 +19,12 @@ Import: `import { KptContextMenu } from '@konce-pt/angular';`
19
19
  The same model as `kpt-menu` (the shared `menu-keys.ts`): opening moves focus to the first item, arrows /
20
20
  `Home` / `End` move between items (disabled ones and separators are skipped), `Escape` and `Tab` close
21
21
  it and focus returns to where it was. `Shift+F10` and the context-menu key on a focused element inside
22
- the area open it too — the browser then sends `contextmenu` without mouse coordinates, so the panel is
22
+ the area open it too - the browser then sends `contextmenu` without mouse coordinates, so the panel is
23
23
  placed at that element. The panel is kept inside the viewport (8px from the edges). Touch screens have
24
24
  no right click, so still offer the same actions through a visible button with `kpt-menu`.
25
25
 
26
26
  ## Tokens
27
27
  The panel `--kpt-color-surface-raised`, `--kpt-elevation-3`.
28
+
29
+ ## Positioning
30
+ The panel opens in the top layer (`popover="manual"`), so an ancestor with `transform`, `filter` or `backdrop-filter` (an animated card, a glass panel) no longer shifts it and `overflow: hidden` no longer clips it. Scrolling or resizing the window closes the menu.