@konce-pt/angular 0.16.0 → 0.17.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 +100 -0
- package/README.md +28 -23
- package/fesm2022/konce-pt-angular.mjs +660 -246
- package/fesm2022/konce-pt-angular.mjs.map +1 -1
- package/package.json +14 -14
- package/src/lib/carousel/llms.txt +7 -1
- package/src/lib/galleria/llms.txt +23 -0
- package/src/lib/i18n/llms.txt +2 -1
- package/src/lib/image/llms.txt +15 -0
- package/src/lib/input/llms.txt +16 -0
- package/src/lib/popover/llms.txt +2 -0
- package/src/lib/tabs/llms.txt +36 -2
- package/types/konce-pt-angular-charts.d.ts +1 -1
- package/types/konce-pt-angular.d.ts +124 -15
- package/types/konce-pt-angular.d.ts.map +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,105 @@
|
|
|
1
1
|
# @konce-pt/angular
|
|
2
2
|
|
|
3
|
+
## 0.17.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- f2f54b4: Media, zakładki i pole tekstowe.
|
|
8
|
+
|
|
9
|
+
- `kpt-tabs`: ikony przed i za etykietą (`icon`, `iconEnd`) z własnym kolorem (`iconColor`,
|
|
10
|
+
`iconEndColor` - nazwa semantyczna albo dowolny kolor CSS) oraz zakładki-odnośniki (`href`,
|
|
11
|
+
`target`, `rel`) ze zdarzeniem `navigate` dla routera. Odnośniki stoją za zakładkami, poza
|
|
12
|
+
`tablist`, a `activeIndex` liczy tylko zakładki z panelem.
|
|
13
|
+
- `kpt-input`: własny przycisk czyszczenia zamiast systemowego "x" pola `search` (`clearable`,
|
|
14
|
+
domyślnie włączony dla `type="search"`), `Escape` czyści pełne pole. W React `KptInput`
|
|
15
|
+
przyjmuje teraz `locale` i `dictionary` jak pozostałe komponenty z etykietami.
|
|
16
|
+
- `kpt-image`: podgląd ograniczony do 80% wysokości okna (`--kpt-image-preview-max-height`,
|
|
17
|
+
`--kpt-image-preview-max-width`) i lot zdjęcia z miniatury przy otwarciu i zamknięciu.
|
|
18
|
+
- `kpt-galleria`: przesuw zdjęć z paralaksą; pasek miniatur bez paska przewijania - przeciąganie,
|
|
19
|
+
kółko i strzałki paska, aktywna miniatura zawsze wraca do widoku.
|
|
20
|
+
- `@konce-pt/motion`: moduły `zoom` i `gallery` (lot podglądu, przesuw, przeciąganie paska
|
|
21
|
+
z bezwładnością) wspólne dla obu portów.
|
|
22
|
+
- `@konce-pt/react` eksportuje `KptMotionProvider` i `useKptMotion` (wcześniej opisane, ale
|
|
23
|
+
niedostępne z paczki).
|
|
24
|
+
- `kpt-carousel` i `kpt-galleria` nie rozpychają już kontenera w gridzie ani flexie.
|
|
25
|
+
- Nowe etykiety i18n: `input.clear`, `galleria.scrollBack`, `galleria.scrollForward` - aplikacje
|
|
26
|
+
z własnym pełnym słownikiem muszą je dopisać.
|
|
27
|
+
|
|
28
|
+
Zmiany zachowania domyślnego:
|
|
29
|
+
|
|
30
|
+
- `kpt-carousel` zawija strzałki (z ostatniego slajdu na pierwszy i z powrotem) - nowe wejście
|
|
31
|
+
`loop`, domyślnie `true`; `loop="false"` przywraca zatrzymywanie na końcach.
|
|
32
|
+
- `kpt-galleria` ma scenę o stałych proporcjach 16:9 ze zdjęciem przyciętym do niej (`cover`)
|
|
33
|
+
zamiast zdjęcia ograniczonego do `max-height: 20rem` - zmieniają to `--kpt-galleria-aspect-ratio`
|
|
34
|
+
i `--kpt-galleria-fit`.
|
|
35
|
+
- Pole `type="search"` w `kpt-input` nie pokazuje już systemowego "x" przeglądarki.
|
|
36
|
+
|
|
37
|
+
### Patch Changes
|
|
38
|
+
|
|
39
|
+
- ffb0ca9: Liczniki czatu odmieniają się przez liczbę: przycisk nowych wiadomości ("1 nowa wiadomość",
|
|
40
|
+
"3 nowe wiadomości", "5 nowych wiadomości"), plakietka nieprzeczytanych na docku, wskaźnik pisania
|
|
41
|
+
("2 osoby piszą...", "5 osób pisze...") i licznik kolejki offline ("3 czekają na wysłanie").
|
|
42
|
+
Po angielsku "1 new message" i "1 unread message" zamiast formy mnogiej, a w wyszukiwarce adresów
|
|
43
|
+
mapy "1 suggestion" i "Type at least 1 character".
|
|
44
|
+
- README wszystkich paczek sprawdzone z kodem i poprawione: aktualne liczby (80+ komponentów,
|
|
45
|
+
98 ikon wbudowanych), React 19 opisany jako pełny port, sekcje API uzupełnione o istniejące
|
|
46
|
+
eksporty, przykłady z wartościami sprawdzonymi uruchomieniem i typami przechodzącymi tryb strict.
|
|
47
|
+
Motyw ciemny opisany zgodnie z działaniem - przez `data-theme`, bez automatycznego
|
|
48
|
+
`prefers-color-scheme`. Walidator IBAN toleruje spacje, nie myślniki.
|
|
49
|
+
- 3716dde: Playground Angulara przeniósł się pod `https://ui.konce.pt/angular/`, symetrycznie do
|
|
50
|
+
`https://ui.konce.pt/react/` - pole `homepage` paczki `@konce-pt/angular` wskazuje teraz tam.
|
|
51
|
+
Arkusze `llms.txt` i `llms/<paczka>/llms.txt` zostają pod dotychczasowymi adresami w korzeniu
|
|
52
|
+
domeny, więc linki z README opublikowanych wersji dalej działają.
|
|
53
|
+
|
|
54
|
+
`konce init` nie zapisuje już do `konce.json` pola `$schema` - wskazywało na plik, którego registry
|
|
55
|
+
nigdy nie publikowało, i edytor zgłaszał przy nim błąd pobierania schematu. Istniejące pliki
|
|
56
|
+
z tym polem działają bez zmian.
|
|
57
|
+
|
|
58
|
+
- Updated dependencies [ffb0ca9]
|
|
59
|
+
- Updated dependencies [f2f54b4]
|
|
60
|
+
- Updated dependencies
|
|
61
|
+
- @konce-pt/i18n@0.17.0
|
|
62
|
+
- @konce-pt/motion@0.17.0
|
|
63
|
+
- @konce-pt/icons@0.17.0
|
|
64
|
+
- @konce-pt/datetime@0.17.0
|
|
65
|
+
- @konce-pt/table@0.17.0
|
|
66
|
+
- @konce-pt/chart@0.17.0
|
|
67
|
+
- @konce-pt/roadmap@0.17.0
|
|
68
|
+
- @konce-pt/map@0.17.0
|
|
69
|
+
- @konce-pt/mention@0.17.0
|
|
70
|
+
- @konce-pt/chat@0.17.0
|
|
71
|
+
- @konce-pt/speech@0.17.0
|
|
72
|
+
- @konce-pt/backdrop@0.17.0
|
|
73
|
+
|
|
74
|
+
## 0.16.1
|
|
75
|
+
|
|
76
|
+
### Patch Changes
|
|
77
|
+
|
|
78
|
+
- e66a67d: Licznik `kpt-data-view` / `KptDataView` odmienia się teraz poprawnie: "1 element", "2 elementy",
|
|
79
|
+
"5 elementów", "22 elementy" (wcześniej zawsze "N elementów"), a po angielsku "1 item" zamiast
|
|
80
|
+
"1 items". Słowniki obsługują blok liczby mnogiej ICU - `{count, plural, one {# item} other {# items}}` -
|
|
81
|
+
z formą wybieraną przez `Intl.PluralRules` dla bieżącego języka. `translate` przyjmuje opcjonalny
|
|
82
|
+
czwarty argument `locale` (domyślnie `'en'`), a `KptI18n.t` i `useKptI18n().t` przekazują go same,
|
|
83
|
+
więc własny słownik dostaje odmianę bez zmian w kodzie.
|
|
84
|
+
- c6e5719: `kpt-popover` / `KptPopover` dostał `maxWidth` - maksymalną szerokość panelu w dowolnej długości CSS
|
|
85
|
+
(domyślnie nadal `20rem`). Wcześniej szerokość była zaszyta w stylu i nie dało się jej zmienić nawet
|
|
86
|
+
zmienną CSS, bo panel żyje w nakładce poza drzewem komponentu - szersza treść (lista powiadomień)
|
|
87
|
+
wylewała się za prawą krawędź dymka. Panel nigdy nie jest też szerszy niż okno minus margines
|
|
88
|
+
nakładek 8 px.
|
|
89
|
+
- Updated dependencies [e66a67d]
|
|
90
|
+
- @konce-pt/i18n@0.16.1
|
|
91
|
+
- @konce-pt/backdrop@0.16.1
|
|
92
|
+
- @konce-pt/chart@0.16.1
|
|
93
|
+
- @konce-pt/chat@0.16.1
|
|
94
|
+
- @konce-pt/datetime@0.16.1
|
|
95
|
+
- @konce-pt/icons@0.16.1
|
|
96
|
+
- @konce-pt/map@0.16.1
|
|
97
|
+
- @konce-pt/mention@0.16.1
|
|
98
|
+
- @konce-pt/motion@0.16.1
|
|
99
|
+
- @konce-pt/roadmap@0.16.1
|
|
100
|
+
- @konce-pt/speech@0.16.1
|
|
101
|
+
- @konce-pt/table@0.16.1
|
|
102
|
+
|
|
3
103
|
## 0.16.0
|
|
4
104
|
|
|
5
105
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
# Koncept UI - Angular
|
|
6
6
|
|
|
7
7
|
**Open-source Angular 22 component library built on Signals & Signal Forms.**
|
|
8
|
-
|
|
8
|
+
80+ components, a feature-rich data table and app-shell layout - zoneless, standalone, fully tokenized.
|
|
9
9
|
|
|
10
10
|
[](https://www.npmjs.com/package/@konce-pt/angular)
|
|
11
11
|
[](https://www.npmjs.com/package/@konce-pt/angular)
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|

|
|
17
17
|

|
|
18
18
|

|
|
19
|
-

|
|
20
20
|
|
|
21
21
|
</div>
|
|
22
22
|
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
**Koncept UI** is a free, MIT-licensed component library for **Angular 22**, built from the ground up on a modern signal-based foundation:
|
|
28
28
|
|
|
29
29
|
- **Signals everywhere** - `input()`, `output()`, `model()`, `computed`. `OnPush` + **zoneless** by default.
|
|
30
|
-
- **Forms on Signal Forms only** - components implement `FormValueControl<T>` and bind through the `
|
|
30
|
+
- **Forms on Signal Forms only** - components implement `FormValueControl<T>` and bind through the `FormField` directive (`[formField]`). No `ControlValueAccessor`.
|
|
31
31
|
- **Flagship data table** - sorting, global filter, pagination, virtual scroll (5000+ rows), row selection, column reorder & freeze, CSV export, cell templates.
|
|
32
32
|
- **100% tokenized** - every style is a `var(--kpt-*)` CSS custom property. Light/dark theme, neutral OKLCH palette. Swap the brand by swapping one token layer.
|
|
33
33
|
- **Standalone components** - no NgModules. Import only what you use; tree-shakeable.
|
|
@@ -41,7 +41,9 @@ npm i @konce-pt/angular @konce-pt/tokens @konce-pt/styles @angular/cdk
|
|
|
41
41
|
# or: pnpm add / yarn add
|
|
42
42
|
```
|
|
43
43
|
|
|
44
|
-
`@angular/core`, `@angular/common` and `@angular/forms` (all `^22`) are already in an Angular app; **`@angular/cdk` (`^22`) is a required peer** - overlay components (select, autocomplete, datepicker, date-range,
|
|
44
|
+
`@angular/core`, `@angular/common` and `@angular/forms` (all `^22`) are already in an Angular app; **`@angular/cdk` (`^22`) is a required peer** - overlay components (select, autocomplete, datepicker, date-range, menu, menubar, megamenu, split-button, popover, peek...) build on the CDK Overlay - so install it explicitly (above). Optional: `@konce-pt/validators` for the Polish-market validators (NIP, REGON, PESEL, IBAN, postal code, NRB). Optional: [`@konce-pt/grid`](https://www.npmjs.com/package/@konce-pt/grid) for the mobile-first layout system - its Angular directives live in `@konce-pt/angular/grid`. Optional: `leaflet` (`^1.9`) - an optional peer needed only by `@konce-pt/angular/map` (loaded through a dynamic `import()`); then also add `node_modules/leaflet/dist/leaflet.css` to `styles[]`.
|
|
45
|
+
|
|
46
|
+
**Entry points:** the core `@konce-pt/angular` plus subpaths that keep heavy pieces out of the core bundle - `@konce-pt/angular/charts`, `/chat`, `/roadmap`, `/map`, `/grid` and `/icons` (full Tabler set).
|
|
45
47
|
|
|
46
48
|
## Setup
|
|
47
49
|
|
|
@@ -76,7 +78,7 @@ providers: [
|
|
|
76
78
|
|
|
77
79
|
The UI language defaults to **English** and works with **zero config** - `provideKptI18n(...)` is optional and only needed for Polish (or a custom language). See [Internationalization](#internationalization-i18n) below.
|
|
78
80
|
|
|
79
|
-
Dark theme: set `<html data-theme="dark"
|
|
81
|
+
Dark theme: set `<html data-theme="dark">`. It is not switched automatically - toggle the attribute yourself, e.g. from `matchMedia('(prefers-color-scheme: dark)')`.
|
|
80
82
|
|
|
81
83
|
> **Why not `import '...css'` in `main.ts`?** Angular CLI (`@angular/build`) turns side-effect CSS imports into a separate stylesheet that isn't linked from `index.html`, so the app builds **without styles**. Use `angular.json -> styles[]` instead.
|
|
82
84
|
|
|
@@ -104,7 +106,7 @@ import { KptButton, KptFormField, KptInput } from '@konce-pt/angular';
|
|
|
104
106
|
selector: 'app-login',
|
|
105
107
|
imports: [FormRoot, FormField, KptFormField, KptInput, KptButton],
|
|
106
108
|
template: `
|
|
107
|
-
<!-- formRoot sets novalidate
|
|
109
|
+
<!-- formRoot sets novalidate and prevents the native submit; onSubmit() runs submit() -->
|
|
108
110
|
<form [formRoot]="loginForm" (submit)="onSubmit()">
|
|
109
111
|
<kpt-form-field label="E-mail" [error]="emailError()" required controlId="f-email">
|
|
110
112
|
<kpt-input [formField]="loginForm.email" type="email" id="f-email" />
|
|
@@ -157,16 +159,17 @@ Data table with sorting, filtering, pagination and a custom cell template:
|
|
|
157
159
|
</kpt-data-table>
|
|
158
160
|
```
|
|
159
161
|
|
|
160
|
-
## Components (
|
|
162
|
+
## Components (80+)
|
|
161
163
|
|
|
162
164
|
| Category | Components |
|
|
163
165
|
| --- | --- |
|
|
164
|
-
| **Forms** (Signal Forms) | input, textarea, select, autocomplete, checkbox, switch, radio-group, slider, rating, datepicker, date-range, color-picker, file-upload, input-number, password, input-otp, chips-input, input-mask, listbox, knob, rich-text |
|
|
166
|
+
| **Forms** (Signal Forms) | form-field, input, textarea, select, autocomplete, checkbox, switch, switch-group, radio-group, slider, rating, datepicker, date-range, clock, color-picker, file-upload, input-number, password, input-otp, chips-input, input-mask, listbox, knob, rich-text, speech-button + speech-wave (dictation) |
|
|
165
167
|
| **Buttons & actions** | button, icon-button, button-group, fab, split-button, speed-dial |
|
|
166
|
-
| **Layout** | app-shell, toolbar, sidenav, card, divider, panel, fieldset, splitter, scroll-top |
|
|
168
|
+
| **Layout** | app-shell, toolbar, sidenav, card, divider, panel, fieldset, splitter, scroll-top, auth, backdrop, `KptBreakpointObserver` |
|
|
167
169
|
| **Navigation** | tabs, accordion, breadcrumb, stepper, menu, menubar, megamenu, context-menu |
|
|
168
170
|
| **Data** | data-table, paginator, tree, timeline, carousel, data-view, pick-list, order-list, galleria, meter-group |
|
|
169
|
-
| **Feedback & overlay** | alert, dialog, toast, tooltip, popover, drawer, bottom-sheet, confirm, badge, chip, avatar, avatar-group, spinner, progress, skeleton, empty, image |
|
|
171
|
+
| **Feedback & overlay** | alert, dialog, toast, tooltip, popover, peek, drawer, bottom-sheet, confirm, badge, chip, avatar, avatar-group, icon, spinner, loader, update, progress, skeleton, empty, image, mention, mentions |
|
|
172
|
+
| **Subpaths** | `@konce-pt/angular/charts` (chart), `/chat` (chat, chat-message, chat-typing, chat-composer, chat-dock), `/roadmap` (roadmap), `/map` (map + legend, POI card, search, create dialog, hours and image fields), `/grid` (`[kptGrid]`, `[kptCol]`, `[kptFlex]`), `/icons` (full Tabler set) |
|
|
170
173
|
|
|
171
174
|
Every component ships an `llms.txt` API sheet next to its source for quick reference.
|
|
172
175
|
|
|
@@ -188,7 +191,7 @@ All visuals are driven by `var(--kpt-*)` tokens (three tiers: primitives -> sema
|
|
|
188
191
|
|
|
189
192
|
## Icons
|
|
190
193
|
|
|
191
|
-
**
|
|
194
|
+
**98 icons are built in and need no configuration** - what the components themselves draw plus the
|
|
192
195
|
staples of an application shell (`sun`, `moon`, `bell`, `settings`, `users`, `logout`,
|
|
193
196
|
`layout-dashboard`, `home`, `activity`, `chart-bar`, `brand-github` ...). A typical admin panel needs
|
|
194
197
|
nothing else.
|
|
@@ -244,7 +247,7 @@ provideKptI18n({ locale: 'de', messages: { de } });
|
|
|
244
247
|
provideKptI18n({ messages: { en: { paginator: { rowsPerPage: 'Rows per page:' } } } });
|
|
245
248
|
```
|
|
246
249
|
|
|
247
|
-
Calendar weekday/month names come from the browser's `Intl` API for the active locale. Per-component label inputs (e.g. `emptyMessage
|
|
250
|
+
Calendar weekday/month names come from the browser's `Intl` API for the active locale. Per-component label inputs (e.g. `emptyMessage`) and `KptConfirmService` options (e.g. `acceptLabel`) still take precedence over the dictionary.
|
|
248
251
|
|
|
249
252
|
## Motion
|
|
250
253
|
|
|
@@ -269,7 +272,7 @@ bootstrapApplication(App, {
|
|
|
269
272
|
| `enabled` | `true` \| `false` | All. `false` also zeroes CSS durations (`data-kpt-motion="off"`, `--kpt-motion-scale: 0` on `<html>`); loading indicators slow down instead of stopping |
|
|
270
273
|
| `layout` | `spring` \| `arc` \| `morph` \| `none` | DataView, PickList, OrderList (`layoutMotion`) |
|
|
271
274
|
| `collapse` | `spring` \| `fade` \| `none` | Accordion, Fieldset, Panel, Tree (`collapseMotion`) |
|
|
272
|
-
| `enter` | `spring` \| `fade` \| `none` | Chat, ChatMessage, ChatDock, FormField (`enterMotion`); Password meter, ChipsInput and Select chips |
|
|
275
|
+
| `enter` | `spring` \| `fade` \| `none` | Chat, ChatMessage, ChatDock, FormField (`enterMotion`); Password meter, ChipsInput and Select chips, Stepper panels, the Image preview, the Galleria slide |
|
|
273
276
|
| `toggle` | `spring` \| `fade` \| `none` | Checkbox, RadioGroup, Switch (`toggleMotion`); Rating stars, ButtonGroup selection |
|
|
274
277
|
|
|
275
278
|
Precedence: `enabled: false` always wins, then the component's own input, then the provider value,
|
|
@@ -279,8 +282,8 @@ are available for your own views in [`@konce-pt/motion`](https://www.npmjs.com/p
|
|
|
279
282
|
|
|
280
283
|
## Documentation
|
|
281
284
|
|
|
282
|
-
- **Storybook** - interactive docs for every component.
|
|
283
|
-
- **Playground** - live demos with copyable HTML/TS/SCSS.
|
|
285
|
+
- **Storybook** - interactive docs for every component, in the repository (`pnpm storybook`).
|
|
286
|
+
- **Playground** - live demos with copyable HTML/TS/SCSS: [ui.konce.pt/angular](https://ui.konce.pt/angular/) (React port: [ui.konce.pt/react](https://ui.konce.pt/react/)).
|
|
284
287
|
- **`llms.txt`** - LLM-friendly API sheets per component, shipped inside the package; the project-wide sheet lives at [ui.konce.pt/llms.txt](https://ui.konce.pt/llms.txt).
|
|
285
288
|
- **Security scanners** - Socket.dev and similar tools flag i18n keys as domain names (`.email`, `.today` and friends are real TLDs) and the map's default endpoints; the [project sheet](https://ui.konce.pt/llms.txt) explains each alert under "Security scanners".
|
|
286
289
|
- Repository: [gitlab.com/konce-pt/koncept-ui](https://gitlab.com/konce-pt/koncept-ui)
|
|
@@ -300,7 +303,7 @@ MIT © konce.pt
|
|
|
300
303
|
**Koncept UI** to darmowa biblioteka komponentów na licencji **MIT** dla **Angulara 22**, zbudowana od podstaw na nowoczesnym fundamencie sygnałów.
|
|
301
304
|
|
|
302
305
|
- **Sygnały wszędzie** - `input()`, `output()`, `model()`, `computed`. `OnPush` + **zoneless** domyślnie.
|
|
303
|
-
- **Formularze wyłącznie na Signal Forms** - komponenty implementują `FormValueControl<T
|
|
306
|
+
- **Formularze wyłącznie na Signal Forms** - komponenty implementują `FormValueControl<T>` i wiążą się dyrektywą `FormField` (`[formField]`), bez `ControlValueAccessor`.
|
|
304
307
|
- **Flagowa tabela danych** - sortowanie, filtr, paginacja, virtual scroll, zaznaczanie, przestawianie/zamrażanie kolumn, eksport CSV, szablony komórek.
|
|
305
308
|
- **100% na tokenach** - każdy styl to `var(--kpt-*)`. Motyw jasny/ciemny, neutralna paleta OKLCH.
|
|
306
309
|
- **Standalone** - bez NgModules, tree-shaking.
|
|
@@ -312,7 +315,9 @@ MIT © konce.pt
|
|
|
312
315
|
npm i @konce-pt/angular @konce-pt/tokens @konce-pt/styles @angular/cdk
|
|
313
316
|
```
|
|
314
317
|
|
|
315
|
-
`@angular/core`, `@angular/common` i `@angular/forms` (`^22`) są już w aplikacji Angulara; **`@angular/cdk` (`^22`) to wymagany peer** - komponenty overlay (select, autocomplete, datepicker, date-range,
|
|
318
|
+
`@angular/core`, `@angular/common` i `@angular/forms` (`^22`) są już w aplikacji Angulara; **`@angular/cdk` (`^22`) to wymagany peer** - komponenty overlay (select, autocomplete, datepicker, date-range, menu, menubar, megamenu, split-button, popover, peek...) bazują na CDK Overlay - więc instaluj go jawnie (powyżej). Opcjonalnie: `@konce-pt/validators` (walidatory PL: NIP, REGON, PESEL, IBAN, kod pocztowy, NRB). Opcjonalnie: `leaflet` (`^1.9`) - opcjonalny peer potrzebny wyłącznie dla `@konce-pt/angular/map` (ładowany dynamicznym `import()`); wtedy dodaj też `node_modules/leaflet/dist/leaflet.css` do `styles[]`.
|
|
319
|
+
|
|
320
|
+
**Punkty wejścia:** rdzeń `@konce-pt/angular` oraz subpathy, które trzymają ciężkie rzeczy poza rdzeniem - `@konce-pt/angular/charts`, `/chat`, `/roadmap`, `/map`, `/grid` i `/icons` (pełny Tabler).
|
|
316
321
|
|
|
317
322
|
### Konfiguracja
|
|
318
323
|
|
|
@@ -346,7 +351,7 @@ providers: [
|
|
|
346
351
|
|
|
347
352
|
Język UI to domyślnie **angielski** i działa **bez żadnej konfiguracji** - `provideKptI18n(...)` jest opcjonalny, potrzebny tylko dla polskiego (lub własnego języka); szczegóły w sekcji i18n niżej.
|
|
348
353
|
|
|
349
|
-
Motyw ciemny: `<html data-theme="dark"
|
|
354
|
+
Motyw ciemny: `<html data-theme="dark">` - nie włącza się sam, atrybut przełączasz samodzielnie (np. z `matchMedia('(prefers-color-scheme: dark)')`); nadpisania `--kpt-color-*` w `styles.scss`. Pełny zestaw ikon Tabler: `provideKptTablerIcons()` z `@konce-pt/angular/icons`.
|
|
350
355
|
|
|
351
356
|
Układ strony: `@konce-pt/grid` (osobna paczka CSS) plus dyrektywy `[kptGrid]`, `[kptCol]`, `[kptFlex]` z `@konce-pt/angular/grid` - siatka mobile-first, utilities flexbox i opcjonalne container queries.
|
|
352
357
|
|
|
@@ -369,7 +374,7 @@ provideKptI18n({ locale: 'de', messages: { de } });
|
|
|
369
374
|
```
|
|
370
375
|
|
|
371
376
|
Nadpisanie pojedynczych etykiet: `provideKptI18n({ messages: { pl: { paginator: { rowsPerPage: 'Na stronie:' } } } })`.
|
|
372
|
-
Nazwy dni/miesięcy w kalendarzach pochodzą z `Intl` wg locale. Inputy etykiet per-komponent (np. `emptyMessage`) mają priorytet nad słownikiem.
|
|
377
|
+
Nazwy dni/miesięcy w kalendarzach pochodzą z `Intl` wg locale. Inputy etykiet per-komponent (np. `emptyMessage`) i opcje `KptConfirmService` (np. `acceptLabel`) mają priorytet nad słownikiem.
|
|
373
378
|
|
|
374
379
|
### Animacje
|
|
375
380
|
|
|
@@ -388,7 +393,7 @@ import { provideKptMotion } from '@konce-pt/angular';
|
|
|
388
393
|
| `enabled` | `true` \| `false` | Wszystkie. `false` zeruje też czasy w CSS (`data-kpt-motion="off"`, `--kpt-motion-scale: 0` na `<html>`); wskaźniki ładowania zwalniają zamiast stanąć |
|
|
389
394
|
| `layout` | `spring` \| `arc` \| `morph` \| `none` | DataView, PickList, OrderList (`layoutMotion`) |
|
|
390
395
|
| `collapse` | `spring` \| `fade` \| `none` | Accordion, Fieldset, Panel, Tree (`collapseMotion`) |
|
|
391
|
-
| `enter` | `spring` \| `fade` \| `none` | Chat, ChatMessage, ChatDock, FormField (`enterMotion`); miernik hasła, chipy ChipsInput i Select |
|
|
396
|
+
| `enter` | `spring` \| `fade` \| `none` | Chat, ChatMessage, ChatDock, FormField (`enterMotion`); miernik hasła, chipy ChipsInput i Select, panele Steppera, podgląd Image, slajd Galleria |
|
|
392
397
|
| `toggle` | `spring` \| `fade` \| `none` | Checkbox, RadioGroup, Switch (`toggleMotion`); gwiazdki Rating, wybór ButtonGroup |
|
|
393
398
|
|
|
394
399
|
Pierwszeństwo: `enabled: false` wygrywa zawsze, potem input samego komponentu, potem wartość z providera,
|
|
@@ -396,13 +401,13 @@ a na końcu `spring`. Drobne reakcje (wciśnięcie przycisku, fokus i błąd pol
|
|
|
396
401
|
i idą tylko za `enabled`. Systemowe "ogranicz ruch" jest respektowane zawsze. Te same sprężyny i pomocniki
|
|
397
402
|
FLIP dla własnych widoków są w [`@konce-pt/motion`](https://www.npmjs.com/package/@konce-pt/motion).
|
|
398
403
|
|
|
399
|
-
### Komponenty (
|
|
404
|
+
### Komponenty (80+)
|
|
400
405
|
|
|
401
|
-
Formularze (Signal Forms), przyciski i akcje, layout, nawigacja, dane (z flagową `kpt-data-table`), feedback i overlay - pełna lista w tabeli powyżej. Każdy komponent ma plik `llms.txt` z opisem API obok źródła.
|
|
406
|
+
Formularze (Signal Forms), przyciski i akcje, layout, nawigacja, dane (z flagową `kpt-data-table`), feedback i overlay - pełna lista w tabeli powyżej. Ciężkie rzeczy (wykresy, czat, roadmapa, mapy, pełny Tabler) siedzą w subpathach `@konce-pt/angular/{charts,chat,roadmap,map,grid,icons}`, żeby nie obciążać rdzenia. Każdy komponent ma plik `llms.txt` z opisem API obok źródła.
|
|
402
407
|
|
|
403
408
|
### Dokumentacja
|
|
404
409
|
|
|
405
|
-
Storybook (interaktywne docs), playground (dema z kopiowaniem kodu), `llms.txt` (opisy API - obok każdego komponentu w paczce, całość projektu pod [ui.konce.pt/llms.txt](https://ui.konce.pt/llms.txt)). Repozytorium: [gitlab.com/konce-pt/koncept-ui](https://gitlab.com/konce-pt/koncept-ui).
|
|
410
|
+
Storybook (interaktywne docs, w repozytorium: `pnpm storybook`), playground (dema z kopiowaniem kodu: [ui.konce.pt/angular](https://ui.konce.pt/angular/), port React: [ui.konce.pt/react](https://ui.konce.pt/react/)), `llms.txt` (opisy API - obok każdego komponentu w paczce, całość projektu pod [ui.konce.pt/llms.txt](https://ui.konce.pt/llms.txt)). Repozytorium: [gitlab.com/konce-pt/koncept-ui](https://gitlab.com/konce-pt/koncept-ui).
|
|
406
411
|
|
|
407
412
|
Alerty skanerów łańcucha dostaw (Socket.dev i podobne) - klucze i18n czytane jak domeny
|
|
408
413
|
oraz domyślne endpointy mapy - omawia sekcja "Skanery bezpieczeństwa" w
|