@konce-pt/angular 0.7.11 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,77 @@
 # @konce-pt/angular
 
+## 0.8.0
+
+### Minor Changes
+
+- 3a3b859: Logika wyjęta z komponentów Angulara do osobnych paczek w czystym TS, wspólnych dla obu
+  portów. Dwie implementacje tego samego rachunku rozjechałyby się po pierwszej poprawce,
+  a to są miejsca, w których błąd jest cichy: wykres kłamiący o danych, filtr chowający
+  wiersz, kalendarz gubiący zmianę czasu.
+
+  - `@konce-pt/datetime` — siatki dni, miesięcy, lat i dekad, przewijanie z `minDate`/`maxDate`,
+    protokół klikania zakresu, znaczniki tarczy zegara.
+  - `@konce-pt/table` — dopasowanie filtrów kolumn, agregacje podsumowania, escapowanie CSV.
+  - `@konce-pt/chart` — skale i „ładne" podziałki, ścieżki linii i obszaru, układ słupków,
+    łuki kołowych i polarnych, siatka radaru.
+  - `@konce-pt/roadmap` — arytmetyka kalendarzowa ISO, model osi czasu, pakowanie pasów,
+    geometria zależności.
+  - `@konce-pt/icons` — dane ikon, sanitizer i `renderKptIconSvg`; pełny Tabler w subpathu
+    `/tabler`.
+
+  Każda ma własne testy na `node --test`. Publiczne API `@konce-pt/angular` bez zmian —
+  komponenty re-eksportują typy rdzeni, a `KptIconRegistry` i `provideKptTablerIcons()`
+  działają jak dotąd.
+
+- 3a3b859: Mapa jako subpath `map/` w obu portach, na wspólnym rdzeniu `@konce-pt/map`: odwzorowanie
+  Web Mercator, arytmetyka prostokątów, klastrowanie znaczników, godziny otwarcia, HTML
+  znaczników i klastrów. Obok rdzenia stoją adaptery silników (Leaflet, Google) — jedyne
+  miejsce w repo, które zna typy biblioteki mapowej.
+
+  `leaflet` jest peerem **opcjonalnym**, ładowanym dynamicznym `import()`, więc kto nie używa
+  mapy, nie płaci za nią rozmiarem ani instalacją. Aplikacja dostarcza `leaflet.css` sama —
+  i dlatego nadpisania `.leaflet-*` w SCSS mapy celowo stoją poza `@layer kpt.components`.
+
+### Patch Changes
+
+- 3a3b859: `KptIconButton` przyjmuje `ariaPressed` — stan przycisku-przełącznika trafia wreszcie na
+  wewnętrzny `<button>`. Postawione na znaczniku `[attr.aria-pressed]` lądowało na hoście
+  `<kpt-icon-button>`, który nie ma roli przycisku, więc czytnik ekranu nie miał czego
+  ogłosić. Domyślne `null` nie wypisuje atrybutu w ogóle.
+
+  Karta miejsca (`KptMapPoiCard`) korzysta z nowego wejścia, a stan „w ulubionych" naprawdę
+  podświetla gwiazdkę: reguła `[data-on]` celowała dotąd w hosta, gdzie `color` przegrywał
+  z kolorem przycisku, a `border-color` się nie dziedziczy — podświetlenie nie działało
+  w żadnym z portów.
+
+- Updated dependencies [3a3b859]
+- Updated dependencies [3a3b859]
+- Updated dependencies [3a3b859]
+  - @konce-pt/i18n@0.8.0
+  - @konce-pt/datetime@0.8.0
+  - @konce-pt/table@0.8.0
+  - @konce-pt/chart@0.8.0
+  - @konce-pt/roadmap@0.8.0
+  - @konce-pt/icons@0.8.0
+  - @konce-pt/map@0.8.0
+
+## 0.7.12
+
+### Patch Changes
+
+- Dokumentacja `llms.txt` jest teraz po angielsku i to ona jest wersją kanoniczną. 81 plików
+  z `packages/angular/**` trafia do tarballa npm, czyli do `node_modules` u konsumentów
+  biblioteki, gdzie czyta je ich asystent — polskie API sheety były ostatnią niekonsekwencją
+  w paczce, której README i opisy w `package.json` są angielskie od początku.
+
+  Dotychczasowa polska treść żyje w repozytorium obok, jako `llms-pl.txt`, i do paczki nie
+  trafia. Wersja angielska przejmuje istniejącą nazwę pliku, więc dla konsumenta nic się nie
+  przesuwa: `node_modules/@konce-pt/angular/**/llms.txt` leży dokładnie tam, gdzie leżał.
+
+  Identyfikatory, tokeny i klucze i18n przechodzą bez zmian — przetłumaczone są proza,
+  komentarze i napisy widoczne dla użytkownika w przykładach. Polszczyzna zostaje tam, gdzie
+  jest tematem: walidatory NIP/REGON/PESEL, `displayFormat: 'pl'` i przykłady słownika PL.
+
 ## 0.7.11
 
 ### Minor Changes

package/charts/src/lib/llms.txt

@@ -1,51 +1,52 @@
 # KptChart (kpt-chart)
 
-Wykres SVG w czystym Angularze (sygnały, zoneless), bez zależności typu Chart.js/D3.
-Rdzeń obliczeń to czysty TypeScript (przenośny do React w Fazie 2).
+An SVG chart in plain Angular (signals, zoneless), with no Chart.js/D3-style dependency.
+The computation core lives in `@konce-pt/chart` — plain TypeScript, tested, shared with the React port.
 Import: `import { KptChart } from '@konce-pt/angular/charts';`
 
-## Typy wykresów (config.type)
-- `line` — liniowy; interpolacja `linear` | `cubic` | `cubic-monotonic`; `area?: boolean`, `points?: boolean`,
-  `crosshair?: boolean` (hover punktu → pionowa prowadnica + podświetlona pigułka etykiety osi X)
-- `bar` — słupkowy; `orientation: 'vertical' | 'horizontal'`, `borderRadius?: px`
-- `pie` — kołowy
-- `doughnut` — pierścieniowy; `innerRadius?: 0..1` (domyślnie 0.6)
-- `polarArea` — równe kąty, promień ∝ wartość
-- `radar` — osie promieniowe + wielokąt serii
+## Chart types (config.type)
+- `line` — a line chart; interpolation `linear` | `cubic` | `cubic-monotonic`; `area?: boolean`, `points?: boolean`,
+  `crosshair?: boolean` (hovering a point → a vertical guide + a highlighted pill on the X axis label)
+- `bar` — a bar chart; `orientation: 'vertical' | 'horizontal'`, `borderRadius?: px`
+- `pie` — a pie chart
+- `doughnut` — a doughnut; `innerRadius?: 0..1` (default 0.6)
+- `polarArea` — equal angles, the radius proportional to the value
+- `radar` — radial axes + a polygon per series
 
-## Wejścia
-- `config: KptChartConfig` (wymagane) — jeden obiekt sterujący całością
-- `width` / `height`: jednostki viewBoxa (600×360); wykres skaluje się do kontenera
+## Inputs
+- `config: KptChartConfig` (required) — a single object driving everything
+- `width` / `height`: viewBox units (600×360); the chart scales to its container
 
-## KptChartConfig (skrót)
+## KptChartConfig (in brief)
 - `labels: string[]`, `series: { name; data: number[]; color? }[]`
 - `legend`: `{ display?, position: top|bottom|left|right, align: start|center|end, pointStyle: circle|rect|rectRot|triangle|line, title? }`
 - `title` / `subtitle`: `{ display?, text, align, color?, font?, padding? }`
 - `tooltip`: `{ enabled?, format?(ctx: {series,label,value}): string }`
 - `animation`: `{ enabled?, duration=400, delay=0, stagger=60 }`
 
-## Interakcje
-- Hover na punkcie/słupku/wycinku → tooltip (seria, etykieta, wartość); dymek clampowany do krawędzi.
-- Klik w legendę → ukrycie/pokazanie serii (pie/doughnut/polar: ukrycie wycinka) z przeliczeniem skali.
-- Hover na legendzie → podświetlenie serii, wygaszenie pozostałych.
+## Interactions
+- Hovering a point/bar/slice → a tooltip (series, label, value); the bubble is clamped to the edges.
+- Clicking the legend → hide/show a series (pie/doughnut/polar: hide a slice) with the scale recomputed.
+- Hovering the legend → highlight that series, dim the rest.
 
-## Animacje
-Linia: `stroke-dasharray/offset`. Słupki: `scaleY/scaleX` (origin od osi). Wycinki/radar: `scale` od środka.
-Stagger `delay = index * stagger`. Wyłączane przez `animation.enabled=false` i `prefers-reduced-motion`.
+## Animations
+Line: `stroke-dasharray/offset`. Bars: `scaleY/scaleX` (origin at the axis). Slices/radar: `scale` from the center.
+Stagger `delay = index * stagger`. Disabled by `animation.enabled=false` and by `prefers-reduced-motion`.
 
-## Przykład
+## Example
     <kpt-chart [config]="{
       type: 'line',
-      labels: ['Sty','Lut','Mar'],
-      series: [{ name: 'Sprzedaż', data: [12, 19, 7] }],
+      labels: ['Jan','Feb','Mar'],
+      series: [{ name: 'Sales', data: [12, 19, 7] }],
       interpolation: 'cubic-monotonic',
       legend: { position: 'top' }
     }" />
 
-## Tokeny / stylowanie
-Paleta z tokenów semantycznych (`--kpt-color-primary|info|success|warning|danger` + skala).
-SCSS w `@layer kpt.components`, klasy `kpt-chart__*`. Kolory serii nadpisywalne przez `series[].color`.
+## Tokens / styling
+The palette comes from the semantic tokens (`--kpt-color-primary|info|success|warning|danger` + the scale).
+SCSS lives in `@layer kpt.components`, classes `kpt-chart__*`. Series colors can be overridden through `series[].color`.
 
-## Rdzeń (pure TS, opcjonalnie)
-Eksport funkcji: `linePath`, `areaPath`, `barLayout`, `pieSlices`, `polarSlices`, `radarGrid`,
-`radarPoints`, `niceScale`, `seriesColor`, `KPT_CHART_PALETTE` — do własnych rozszerzeń/SSR.
+## Core (pure TS, optional)
+Exported functions: `linePath`, `areaPath`, `barLayout`, `pieSlices`, `polarSlices`, `radarGrid`,
+`radarPoints`, `niceScale`, `seriesColor`, `KPT_CHART_PALETTE` — for your own extensions or SSR.
+They are re-exported from `@konce-pt/chart`, so an app never has to install that package itself.