@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.
- package/CHANGELOG.md +792 -333
- package/README.md +111 -55
- package/charts/src/lib/llms.txt +23 -15
- package/chat/src/lib/llms.txt +68 -33
- package/fesm2022/konce-pt-angular-charts.mjs +149 -68
- package/fesm2022/konce-pt-angular-charts.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-chat.mjs +296 -135
- package/fesm2022/konce-pt-angular-chat.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-grid.mjs +16 -16
- package/fesm2022/konce-pt-angular-grid.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-icons.mjs +5 -5
- package/fesm2022/konce-pt-angular-icons.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-map.mjs +360 -293
- package/fesm2022/konce-pt-angular-map.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-roadmap.mjs +120 -34
- package/fesm2022/konce-pt-angular-roadmap.mjs.map +1 -1
- package/fesm2022/konce-pt-angular.mjs +7117 -3373
- package/fesm2022/konce-pt-angular.mjs.map +1 -1
- package/grid/src/lib/llms.txt +18 -18
- package/map/src/lib/llms.txt +142 -140
- package/package.json +14 -12
- package/roadmap/src/lib/llms.txt +37 -27
- package/src/lib/accordion/llms.txt +18 -6
- package/src/lib/alert/llms.txt +5 -4
- package/src/lib/app-shell/llms.txt +25 -22
- package/src/lib/auth/llms.txt +26 -22
- package/src/lib/autocomplete/llms.txt +18 -4
- package/src/lib/avatar/llms.txt +3 -3
- package/src/lib/avatar-group/llms.txt +5 -5
- package/src/lib/backdrop/llms.txt +35 -35
- package/src/lib/badge/llms.txt +7 -7
- package/src/lib/bottom-sheet/llms.txt +6 -3
- package/src/lib/breadcrumb/llms.txt +9 -1
- package/src/lib/breakpoint/llms.txt +8 -8
- package/src/lib/button/llms.txt +26 -18
- package/src/lib/button-group/llms.txt +40 -31
- package/src/lib/card/llms.txt +19 -19
- package/src/lib/carousel/llms.txt +6 -6
- package/src/lib/checkbox/llms.txt +17 -2
- package/src/lib/chip/llms.txt +6 -6
- package/src/lib/chips-input/llms.txt +14 -4
- package/src/lib/color-picker/llms.txt +7 -4
- package/src/lib/confirm/llms.txt +9 -3
- package/src/lib/context-menu/llms.txt +7 -4
- package/src/lib/data-table/llms.txt +280 -227
- package/src/lib/data-view/llms.txt +25 -4
- package/src/lib/date-range/llms.txt +37 -18
- package/src/lib/datepicker/llms.txt +46 -29
- package/src/lib/dialog/llms.txt +29 -26
- package/src/lib/divider/llms.txt +2 -1
- package/src/lib/drawer/llms.txt +9 -6
- package/src/lib/empty/llms.txt +4 -4
- package/src/lib/fab/llms.txt +6 -2
- package/src/lib/fieldset/llms.txt +22 -4
- package/src/lib/file-upload/llms.txt +3 -0
- package/src/lib/form-field/llms.txt +33 -19
- package/src/lib/galleria/llms.txt +3 -3
- package/src/lib/i18n/llms.txt +15 -8
- package/src/lib/icon/llms.txt +9 -9
- package/src/lib/icon-button/llms.txt +8 -3
- package/src/lib/image/llms.txt +4 -4
- package/src/lib/input/llms.txt +21 -7
- package/src/lib/input-mask/llms.txt +5 -2
- package/src/lib/input-number/llms.txt +18 -15
- package/src/lib/input-otp/llms.txt +15 -4
- package/src/lib/knob/llms.txt +14 -7
- package/src/lib/listbox/llms.txt +8 -5
- package/src/lib/loader/llms.txt +72 -0
- package/src/lib/megamenu/llms.txt +16 -5
- package/src/lib/mention/llms.txt +15 -15
- package/src/lib/menu/llms.txt +12 -12
- package/src/lib/menubar/llms.txt +16 -5
- package/src/lib/meter-group/llms.txt +7 -7
- package/src/lib/order-list/llms.txt +20 -5
- package/src/lib/paginator/llms.txt +5 -5
- package/src/lib/panel/llms.txt +20 -8
- package/src/lib/password/llms.txt +17 -5
- package/src/lib/peek/llms.txt +11 -11
- package/src/lib/pick-list/llms.txt +28 -5
- package/src/lib/popover/llms.txt +9 -6
- package/src/lib/progress/llms.txt +16 -16
- package/src/lib/radio-group/llms.txt +13 -3
- package/src/lib/rating/llms.txt +13 -6
- package/src/lib/rich-text/llms.txt +42 -24
- package/src/lib/scroll-top/llms.txt +3 -3
- package/src/lib/select/llms.txt +23 -13
- package/src/lib/sidenav/llms.txt +8 -8
- package/src/lib/slider/llms.txt +23 -7
- package/src/lib/speech/llms.txt +108 -0
- package/src/lib/speed-dial/llms.txt +9 -3
- package/src/lib/spinner/llms.txt +2 -2
- package/src/lib/split-button/llms.txt +14 -8
- package/src/lib/splitter/llms.txt +8 -8
- package/src/lib/stepper/llms.txt +26 -7
- package/src/lib/switch/llms.txt +13 -3
- package/src/lib/switch-group/llms.txt +12 -9
- package/src/lib/tabs/llms.txt +7 -4
- package/src/lib/textarea/llms.txt +16 -5
- package/src/lib/timeline/llms.txt +1 -1
- package/src/lib/toast/llms.txt +36 -5
- package/src/lib/toolbar/llms.txt +3 -3
- package/src/lib/tooltip/llms.txt +13 -10
- package/src/lib/tree/llms.txt +19 -5
- package/src/lib/update/llms.txt +52 -0
- package/types/konce-pt-angular-charts.d.ts +11 -0
- package/types/konce-pt-angular-charts.d.ts.map +1 -1
- package/types/konce-pt-angular-chat.d.ts +98 -40
- package/types/konce-pt-angular-chat.d.ts.map +1 -1
- package/types/konce-pt-angular-grid.d.ts +14 -14
- package/types/konce-pt-angular-icons.d.ts +3 -3
- package/types/konce-pt-angular-map.d.ts +147 -119
- package/types/konce-pt-angular-map.d.ts.map +1 -1
- package/types/konce-pt-angular-roadmap.d.ts +34 -9
- package/types/konce-pt-angular-roadmap.d.ts.map +1 -1
- package/types/konce-pt-angular.d.ts +1774 -651
- package/types/konce-pt-angular.d.ts.map +1 -1
package/src/lib/chip/llms.txt
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
1
|
# KptChip (kpt-chip)
|
|
2
2
|
|
|
3
|
-
A chip / tag
|
|
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')
|
|
8
|
-
- `removable`: boolean (a
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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`)
|
|
8
|
-
- `presets`: string[]
|
|
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
|
|
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
|
|
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.
|
package/src/lib/confirm/llms.txt
CHANGED
|
@@ -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)`
|
|
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`
|
|
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
|
|
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>[]
|
|
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)
|
|
10
|
-
- `selected`: KptMenuItem<T>
|
|
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
|
|
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.
|