@konce-pt/react 0.12.0 → 0.15.0

package/dist/internal/option-nav.d.ts

@@ -1,16 +1,16 @@
 /** Klawisze, które przesuwają aktywną opcję. */
 export declare const OPTION_NAV_KEYS: Set<string>;
 /**
- * Indeks opcji po klawiszu `key`, z pominięciem wyłączonych (`disabled[i]`). Bez zawijania — na
- * końcu listy strzałka zostaje na miejscu, jak w natywnym `<select>`. `current` = -1 znaczy „nic
- * aktywnego”: `↓` idzie wtedy na pierwszą, `↑` na ostatnią. `null` dla innych klawiszy albo listy
+ * Indeks opcji po klawiszu `key`, z pominięciem wyłączonych (`disabled[i]`). Bez zawijania - na
+ * końcu listy strzałka zostaje na miejscu, jak w natywnym `<select>`. `current` = -1 znaczy "nic
+ * aktywnego": `ArrowDown` idzie wtedy na pierwszą, `ArrowUp` na ostatnią. `null` dla innych klawiszy albo listy
  * bez aktywnych opcji.
  */
 export declare function nextOptionIndex(disabled: readonly boolean[], current: number, key: string): number | null;
 /**
  * Wyszukiwanie po pierwszych literach (type-ahead): pierwsza aktywna opcja zaczynająca się od
  * `query`, licząc od pozycji za `current` i zawijając. Porównanie bez wielkości liter i polskich
- * znaków — „lo” znajduje „Łódź”.
+ * znaków - "lo" znajduje "Łódź".
  */
 export declare function typeaheadIndex(labels: readonly string[], disabled: readonly boolean[], current: number, query: string): number | null;
 /** Bufor wpisywanych liter dla type-ahead: zeruje się po chwili bez pisania. */

package/dist/internal/option-nav.js

@@ -1,5 +1,5 @@
 /*
- * Nawigacja klawiaturą po liście opcji z aktywną pozycją (`aria-activedescendant`) — wspólna dla
+ * Nawigacja klawiaturą po liście opcji z aktywną pozycją (`aria-activedescendant`) - wspólna dla
  * `KptSelect`, `KptListbox` i `KptAutocomplete`. Port Angulara ma bliźniaczy plik
  * `shared/option-nav.ts`. Fokus zostaje na kontrolce; zmienia się tylko indeks aktywnej opcji.
  */
@@ -9,9 +9,9 @@ const PAGE = 10;
 /** Klawisze, które przesuwają aktywną opcję. */
 export const OPTION_NAV_KEYS = new Set(['ArrowDown', 'ArrowUp', 'Home', 'End', 'PageDown', 'PageUp']);
 /**
- * Indeks opcji po klawiszu `key`, z pominięciem wyłączonych (`disabled[i]`). Bez zawijania — na
- * końcu listy strzałka zostaje na miejscu, jak w natywnym `<select>`. `current` = -1 znaczy „nic
- * aktywnego”: `↓` idzie wtedy na pierwszą, `↑` na ostatnią. `null` dla innych klawiszy albo listy
+ * Indeks opcji po klawiszu `key`, z pominięciem wyłączonych (`disabled[i]`). Bez zawijania - na
+ * końcu listy strzałka zostaje na miejscu, jak w natywnym `<select>`. `current` = -1 znaczy "nic
+ * aktywnego": `ArrowDown` idzie wtedy na pierwszą, `ArrowUp` na ostatnią. `null` dla innych klawiszy albo listy
  * bez aktywnych opcji.
  */
 export function nextOptionIndex(disabled, current, key) {
@@ -47,7 +47,7 @@ export function nextOptionIndex(disabled, current, key) {
 /**
  * Wyszukiwanie po pierwszych literach (type-ahead): pierwsza aktywna opcja zaczynająca się od
  * `query`, licząc od pozycji za `current` i zawijając. Porównanie bez wielkości liter i polskich
- * znaków — „lo” znajduje „Łódź”.
+ * znaków - "lo" znajduje "Łódź".
  */
 export function typeaheadIndex(labels, disabled, current, query) {
     const q = foldMentionText(query);

package/dist/internal/overlay-container.js

@@ -3,7 +3,7 @@ import { createContext, useContext } from 'react';
  * Miejsce, do którego portalują się panele nakładek.
  *
  * `showModal()` wynosi `<dialog>` do warstwy szczytowej przeglądarki, a ta stoi ponad całym
- * drzewem dokumentu — żaden `z-index` tego nie przebije. Panel selecta czy menu otwarty
+ * drzewem dokumentu - żaden `z-index` tego nie przebije. Panel selecta czy menu otwarty
  * z wnętrza modala portalowałby się na `document.body` i byłby NIEWIDOCZNY, schowany za tłem
  * okna. `KptDialog` podstawia więc siebie jako kontener na czas, gdy jest otwarty.
  *

package/dist/internal/overlay.d.ts

@@ -5,7 +5,7 @@ export interface KptOverlayProps {
     anchor: HTMLElement | null;
     /** Kliknięcie w backdrop albo Escape. */
     onClose: () => void;
-    /** Panel dostaje szerokość wyzwalacza — dokładnie tę (podpowiedzi autocomplete pod polem). */
+    /** Panel dostaje szerokość wyzwalacza - dokładnie tę (podpowiedzi autocomplete pod polem). */
     matchAnchorWidth?: boolean;
     /**
      * Panel jest co najmniej tak szeroki jak wyzwalacz, ale rośnie do treści (lista selecta:
@@ -16,13 +16,13 @@ export interface KptOverlayProps {
     offset?: number;
     /**
      * Krawędź, do której wyrównujemy panel: `start` (lewa, domyślnie) albo `end` (prawa).
-     * `end` przydaje się, gdy wyzwalacz siedzi przy prawej krawędzi kontrolki — panel otwiera się
+     * `end` przydaje się, gdy wyzwalacz siedzi przy prawej krawędzi kontrolki - panel otwiera się
      * wtedy w lewo i nie wychodzi poza nią.
      */
     align?: 'start' | 'end';
     /**
      * Przezroczysty backdrop przechwytujący kliknięcie poza panelem. Wyłącz go tam, gdzie panel
-     * ma zostawić wyzwalacz klikalnym — autocomplete zamyka się na `blur` pola, a backdrop
+     * ma zostawić wyzwalacz klikalnym - autocomplete zamyka się na `blur` pola, a backdrop
      * zasłoniłby to pole i zabrałby mu każde kliknięcie.
      */
     withBackdrop?: boolean;

package/dist/internal/overlay.js

@@ -9,12 +9,12 @@ import { useKptOverlayContainer } from "./overlay-container.js";
  * Port Angulara stoi tu na CDK Overlay, którego w Reakcie nie ma. Odtwarzamy jego zachowanie:
  * pozycjonowanie względem wyzwalacza z odbiciem w górę, gdy pod spodem brakuje miejsca,
  * przezroczysty backdrop zamykający kliknięciem oraz Escape. Style samego panelu pochodzą
- * ze wspólnego arkusza (`.kpt-select__panel`, `.kpt-popover__panel`) — tutaj są wyłącznie
+ * ze wspólnego arkusza (`.kpt-select__panel`, `.kpt-popover__panel`) - tutaj są wyłącznie
  * współrzędne, więc nic nie duplikuje wyglądu.
  */
-/** Otwarte nakładki od najstarszej — Escape obsługuje tylko ostatnia. */
+/** Otwarte nakładki od najstarszej - Escape obsługuje tylko ostatnia. */
 const overlayStack = [];
-/** Ta sama warstwa co `--kpt-z-overlay` w tokenach — panel ma być nad treścią aplikacji. */
+/** Ta sama warstwa co `--kpt-z-overlay` w tokenach - panel ma być nad treścią aplikacji. */
 const Z_INDEX = 'var(--kpt-z-overlay, 1100)';
 export function KptOverlay({ open, anchor, onClose, matchAnchorWidth = false, minAnchorWidth = false, offset = 4, align = 'start', withBackdrop = true, preferAbove = false, children, }) {
     const container = useKptOverlayContainer();
@@ -28,7 +28,7 @@ export function KptOverlay({ open, anchor, onClose, matchAnchorWidth = false, mi
         const panelWidth = panelRef.current?.offsetWidth ?? 0;
         const below = window.innerHeight - rect.bottom;
         // Odbicie w górę tylko wtedy, gdy pod spodem naprawdę brakuje miejsca, a nad wyzwalaczem
-        // jest go więcej — inaczej panel skakałby przy każdym przewinięciu o kilka pikseli.
+        // jest go więcej - inaczej panel skakałby przy każdym przewinięciu o kilka pikseli.
         // Przy `preferAbove` jest odwrotnie: panel stoi nad wyzwalaczem, dopóki się tam mieści.
         const fitsAbove = panelHeight === 0 || rect.top > panelHeight + offset;
         const flip = preferAbove ? fitsAbove : panelHeight > 0 && below < panelHeight + offset && rect.top > below;
@@ -39,8 +39,8 @@ export function KptOverlay({ open, anchor, onClose, matchAnchorWidth = false, mi
             ...(minAnchorWidth ? { minWidth: rect.width } : {}),
         });
     }, [anchor, matchAnchorWidth, minAnchorWidth, offset, align, preferAbove]);
-    // Zamknięcie zeruje pozycję w tym samym renderze (wzorzec „poprzednia wartość w stanie”), więc
-    // ponowne otwarcie nie pokaże panelu na klatkę w starym miejscu — bez setState w efekcie.
+    // Zamknięcie zeruje pozycję w tym samym renderze (wzorzec "poprzednia wartość w stanie"), więc
+    // ponowne otwarcie nie pokaże panelu na klatkę w starym miejscu - bez setState w efekcie.
     const [wasOpen, setWasOpen] = useState(open);
     if (wasOpen !== open) {
         setWasOpen(open);
@@ -61,7 +61,7 @@ export function KptOverlay({ open, anchor, onClose, matchAnchorWidth = false, mi
         /*
          * Escape zamyka tylko najwyższą nakładkę (stos jak `OverlayKeyboardDispatcher` w CDK) i tylko
          * wtedy, gdy komponent nie obsłużył klawisza sam. `preventDefault` jest konieczne: natywny
-         * `<dialog>` traktuje ten sam Escape jako żądanie zamknięcia — popover w `KptDialog` zamykał
+         * `<dialog>` traktuje ten sam Escape jako żądanie zamknięcia - popover w `KptDialog` zamykał
          * razem ze sobą całe okno.
          */
         const token = {};
@@ -91,7 +91,7 @@ export function KptOverlay({ open, anchor, onClose, matchAnchorWidth = false, mi
                     width: position?.width,
                     minWidth: position?.minWidth,
                     zIndex: Z_INDEX,
-                    // Panel bez pozycji jeszcze nie został zmierzony — chowamy go na pierwszej klatce,
+                    // Panel bez pozycji jeszcze nie został zmierzony - chowamy go na pierwszej klatce,
                     // żeby nie mrugnął w lewym górnym rogu.
                     visibility: position ? 'visible' : 'hidden',
                 }, children: children })] }), container);

package/dist/internal/password-strength.d.ts

@@ -1,6 +1,6 @@
-/** 0 = bardzo słabe … 4 = silne. */
+/** 0 = bardzo słabe ... 4 = silne. */
 export type KptPasswordScore = 0 | 1 | 2 | 3 | 4;
 /** Przybliżona entropia w bitach. */
 export declare function kptPasswordBits(value: string): number;
-/** Wynik 0–4 z entropii: <28 bardzo słabe, <36 słabe, <50 średnie, <64 dobre, reszta silne. */
+/** Wynik 0-4 z entropii: <28 bardzo słabe, <36 słabe, <50 średnie, <64 dobre, reszta silne. */
 export declare function kptPasswordScore(value: string): KptPasswordScore;

package/dist/internal/password-strength.js

@@ -1,11 +1,11 @@
 /*
- * Ocena siły hasła dla miernika `kpt-password`. Bliźniak w porcie Angulara (`shared/password-strength.ts`) — zmiana w obu.
+ * Ocena siły hasła dla miernika `kpt-password`. Bliźniak w porcie Angulara (`shared/password-strength.ts`) - zmiana w obu.
  *
  * Wynik idzie przede wszystkim za długością, a nie za regułami składu, które odradza NIST SP 800-63B:
- * `Password1!` spełnia wszystkie „wielka, cyfra, znak specjalny”, a jest jednym z najczęściej
+ * `Password1!` spełnia wszystkie "wielka, cyfra, znak specjalny", a jest jednym z najczęściej
  * zgadywanych haseł, podczas gdy trzydzieści małych liter jest bardzo mocne. Liczymy przybliżoną
- * entropię znak po znaku — z puli klas, które naprawdę wystąpiły — i obcinamy ją za powtórzenia,
- * ciągi (`abcd`, `1234`, `qwerty`) i schemat „Słowo + cyfry + znak”. Litery spoza ASCII
+ * entropię znak po znaku - z puli klas, które naprawdę wystąpiły - i obcinamy ją za powtórzenia,
+ * ciągi (`abcd`, `1234`, `qwerty`) i schemat "Słowo + cyfry + znak". Litery spoza ASCII
  * (`ą`, `ż`) są literami, nie znakami specjalnymi. Bez słownika: to podpowiedź, nie zabezpieczenie.
  */
 const KEYBOARD_ROWS = ['qwertyuiop', 'asdfghjkl', 'zxcvbnm', '1234567890'];
@@ -37,7 +37,7 @@ function isSequential(a, b) {
 export function kptPasswordBits(value) {
     if (!value)
         return 0;
-    // „Słowo + cyfry + znak” (`Password1!`, `Kwiatek2024`) to pierwsze, co zgaduje atakujący —
+    // "Słowo + cyfry + znak" (`Password1!`, `Kwiatek2024`) to pierwsze, co zgaduje atakujący -
     // liczymy je jak samo słowo pisane małymi literami.
     const pattern = /^(\p{Lu}?\p{Ll}+)(\p{N}{0,4})([^\p{L}\p{N}]{0,2})$/u.exec(value);
     const chars = [...(pattern ? pattern[1] : value)];
@@ -59,7 +59,7 @@ export function kptPasswordBits(value) {
         bits += pattern[2].length * 2 + pattern[3].length * 3;
     return bits;
 }
-/** Wynik 0–4 z entropii: <28 bardzo słabe, <36 słabe, <50 średnie, <64 dobre, reszta silne. */
+/** Wynik 0-4 z entropii: <28 bardzo słabe, <36 słabe, <50 średnie, <64 dobre, reszta silne. */
 export function kptPasswordScore(value) {
     const bits = kptPasswordBits(value);
     if (bits < 28)

package/dist/internal/roving.d.ts

@@ -1,9 +1,9 @@
 /**
  * Indeks elementu, na który ma przejść fokus po klawiszu `key`. `disabled[i]` mówi, czy element
- * `i` jest wyłączony — takie są pomijane. Strzałki zawijają się na końcach, `Home`/`End` idą do
+ * `i` jest wyłączony - takie są pomijane. Strzałki zawijają się na końcach, `Home`/`End` idą do
  * pierwszego/ostatniego aktywnego. Zwraca `null` dla klawisza, który nie nawiguje, albo gdy nie ma
  * dokąd przejść.
  */
 export declare function nextRovingIndex(disabled: readonly boolean[], current: number, key: string): number | null;
-/** Pierwszy aktywny indeks od `preferred` — przystanek Tab, gdy wskazany element jest wyłączony. */
+/** Pierwszy aktywny indeks od `preferred` - przystanek Tab, gdy wskazany element jest wyłączony. */
 export declare function rovingStop(disabled: readonly boolean[], preferred: number): number;

package/dist/internal/roving.js

@@ -1,11 +1,11 @@
 /*
- * Nawigacja strzałkami po poziomym rzędzie z jednym przystankiem Tab („roving tabindex”) —
+ * Nawigacja strzałkami po poziomym rzędzie z jednym przystankiem Tab ("roving tabindex") -
  * wspólna dla `KptTabs`, `KptMenubar` i `KptMegamenu`. Port Angulara ma bliźniaczy plik
  * `shared/roving.ts`.
  */
 /**
  * Indeks elementu, na który ma przejść fokus po klawiszu `key`. `disabled[i]` mówi, czy element
- * `i` jest wyłączony — takie są pomijane. Strzałki zawijają się na końcach, `Home`/`End` idą do
+ * `i` jest wyłączony - takie są pomijane. Strzałki zawijają się na końcach, `Home`/`End` idą do
  * pierwszego/ostatniego aktywnego. Zwraca `null` dla klawisza, który nie nawiguje, albo gdy nie ma
  * dokąd przejść.
  */
@@ -34,7 +34,7 @@ export function nextRovingIndex(disabled, current, key) {
             return null;
     }
 }
-/** Pierwszy aktywny indeks od `preferred` — przystanek Tab, gdy wskazany element jest wyłączony. */
+/** Pierwszy aktywny indeks od `preferred` - przystanek Tab, gdy wskazany element jest wyłączony. */
 export function rovingStop(disabled, preferred) {
     if (preferred >= 0 && preferred < disabled.length && !disabled[preferred])
         return preferred;

package/dist/internal/scroll-lock.d.ts

@@ -1,6 +1,6 @@
 /**
  * Blokuje przewijanie dokumentu i zwraca funkcję zdejmującą tę jedną blokadę. Licznik pozwala
- * zagnieżdżać okna (szuflada → dialog): przewijanie wraca dopiero po zdjęciu ostatniej.
+ * zagnieżdżać okna (szuflada -> dialog): przewijanie wraca dopiero po zdjęciu ostatniej.
  * `scrollbar-gutter: stable` trzyma miejsce po pasku przewijania, więc treść nie przeskakuje w bok.
  */
 export declare function kptLockScroll(): () => void;

package/dist/internal/scroll-lock.js

@@ -1,13 +1,13 @@
 /*
  * Blokada przewijania strony pod oknem modalnym. `showModal()` blokuje interakcję z tłem, ale nie
- * jego przewijanie — kółko myszy dalej przesuwa stronę. Bliźniak w porcie Angulara (`shared/scroll-lock.ts`) — zmiana w obu.
+ * jego przewijanie - kółko myszy dalej przesuwa stronę. Bliźniak w porcie Angulara (`shared/scroll-lock.ts`) - zmiana w obu.
  */
 let locks = 0;
 let savedOverflow = '';
 let savedGutter = '';
 /**
  * Blokuje przewijanie dokumentu i zwraca funkcję zdejmującą tę jedną blokadę. Licznik pozwala
- * zagnieżdżać okna (szuflada → dialog): przewijanie wraca dopiero po zdjęciu ostatniej.
+ * zagnieżdżać okna (szuflada -> dialog): przewijanie wraca dopiero po zdjęciu ostatniej.
  * `scrollbar-gutter: stable` trzyma miejsce po pasku przewijania, więc treść nie przeskakuje w bok.
  */
 export function kptLockScroll() {

package/dist/internal/slot-children.d.ts

@@ -1,13 +1,13 @@
 import { type ReactNode } from 'react';
 /**
  * Dzieci komponentu ze slotami, z rozwiniętymi fragmentami. `Children.forEach` traktuje
- * `<>…</>` jak jedno dziecko, więc slot owinięty we fragment (np. z warunku
- * `{admin && <><KptTab …/><KptTab …/></>}`) był dla komponentu niewidoczny. Rozwijamy fragmenty
+ * `<>...</>` jak jedno dziecko, więc slot owinięty we fragment (np. z warunku
+ * `{admin && <><KptTab .../><KptTab .../></>}`) był dla komponentu niewidoczny. Rozwijamy fragmenty
  * rekurencyjnie; `null`, `false` i puste napisy odpadają tak jak w `Children.forEach`.
  */
 export declare function slotChildren(children: ReactNode): ReactNode[];
 /**
  * Ostrzeżenie deweloperskie o dziecku, które komponent przyjmujący wyłącznie sloty pominie.
- * Białe znaki między tagami (`"\n  "`) nie są pomyłką — te przemilczamy.
+ * Białe znaki między tagami (`"\n  "`) nie są pomyłką - te przemilczamy.
  */
 export declare function warnUnslottedChild(component: string, child: ReactNode, expected: string): void;

package/dist/internal/slot-children.js

@@ -2,8 +2,8 @@ import { Children, Fragment, isValidElement } from 'react';
 import { isDevBuild } from "./dev.js";
 /**
  * Dzieci komponentu ze slotami, z rozwiniętymi fragmentami. `Children.forEach` traktuje
- * `<>…</>` jak jedno dziecko, więc slot owinięty we fragment (np. z warunku
- * `{admin && <><KptTab …/><KptTab …/></>}`) był dla komponentu niewidoczny. Rozwijamy fragmenty
+ * `<>...</>` jak jedno dziecko, więc slot owinięty we fragment (np. z warunku
+ * `{admin && <><KptTab .../><KptTab .../></>}`) był dla komponentu niewidoczny. Rozwijamy fragmenty
  * rekurencyjnie; `null`, `false` i puste napisy odpadają tak jak w `Children.forEach`.
  */
 export function slotChildren(children) {
@@ -20,12 +20,12 @@ export function slotChildren(children) {
 }
 /**
  * Ostrzeżenie deweloperskie o dziecku, które komponent przyjmujący wyłącznie sloty pominie.
- * Białe znaki między tagami (`"\n  "`) nie są pomyłką — te przemilczamy.
+ * Białe znaki między tagami (`"\n  "`) nie są pomyłką - te przemilczamy.
  */
 export function warnUnslottedChild(component, child, expected) {
     if (!isDevBuild())
         return;
     if (typeof child === 'string' && child.trim() === '')
         return;
-    console.warn(`[${component}] Pominięto dziecko, które nie jest slotem — użyj ${expected}.`, child);
+    console.warn(`[${component}] Pominięto dziecko, które nie jest slotem - użyj ${expected}.`, child);
 }

package/dist/internal/slot.d.ts

@@ -3,18 +3,18 @@ type AnyProps = Record<string, unknown>;
 /**
  * Scala propsy slotu z propsami dziecka. Zasady, w kolejności ważności:
  * handlery są komponowane (najpierw dziecka, potem slotu), `className` sklejane,
- * `style` nakładane (dziecko wygrywa), `ref` łączony, reszta — dziecko nadpisuje slot.
+ * `style` nakładane (dziecko wygrywa), `ref` łączony, reszta - dziecko nadpisuje slot.
  */
 export declare function mergeSlotProps(slotProps: AnyProps, childProps: AnyProps): AnyProps;
 /**
  * Renderuje `child` z propsami slotu i podmienioną treścią. Używane przez komponenty,
- * które w trybie `asChild` muszą zachować własne opakowanie treści — na przykład
+ * które w trybie `asChild` muszą zachować własne opakowanie treści - na przykład
  * przycisk owija zawartość w `.kpt-button__content` niezależnie od tego, jakim
  * elementem ostatecznie jest.
  */
 export declare function renderAsChild(child: ReactElement, slotProps: AnyProps, content: ReactNode): ReactElement;
 export interface SlotProps {
-    /** Dokładnie jeden element — to on przejmie propsy slotu. */
+    /** Dokładnie jeden element - to on przejmie propsy slotu. */
     children?: ReactNode;
     [prop: string]: unknown;
 }

package/dist/internal/slot.js

@@ -4,7 +4,7 @@ import { composeRefs } from "./compose-refs.js";
 /**
  * Scala propsy slotu z propsami dziecka. Zasady, w kolejności ważności:
  * handlery są komponowane (najpierw dziecka, potem slotu), `className` sklejane,
- * `style` nakładane (dziecko wygrywa), `ref` łączony, reszta — dziecko nadpisuje slot.
+ * `style` nakładane (dziecko wygrywa), `ref` łączony, reszta - dziecko nadpisuje slot.
  */
 export function mergeSlotProps(slotProps, childProps) {
     const merged = { ...slotProps };
@@ -33,7 +33,7 @@ export function mergeSlotProps(slotProps, childProps) {
 }
 /**
  * Renderuje `child` z propsami slotu i podmienioną treścią. Używane przez komponenty,
- * które w trybie `asChild` muszą zachować własne opakowanie treści — na przykład
+ * które w trybie `asChild` muszą zachować własne opakowanie treści - na przykład
  * przycisk owija zawartość w `.kpt-button__content` niezależnie od tego, jakim
  * elementem ostatecznie jest.
  */

package/dist/internal/step.d.ts

@@ -1,4 +1,4 @@
-/** Miejsca po przecinku w zapisie liczby, także wykładniczym (`0.25` → 2, `1e-7` → 7). */
+/** Miejsca po przecinku w zapisie liczby, także wykładniczym (`0.25` -> 2, `1e-7` -> 7). */
 export declare function kptDecimals(n: number): number;
 /**
  * Zaokrągla do precyzji, która nie gubi ani kroku, ani wartości bazowej: `0.1 + 0.2` nie może
@@ -6,7 +6,7 @@ export declare function kptDecimals(n: number): number;
  */
 export declare function kptRoundTo(n: number, ...sources: number[]): number;
 /**
- * Przyciąga wartość do siatki `min + k·step` i przycina do zakresu. Siatka zaczyna się od `min`,
- * nie od zera — przy `min=1, step=2` dozwolone są 1, 3, 5…, tak samo myszą jak klawiaturą.
+ * Przyciąga wartość do siatki `min + k,step` i przycina do zakresu. Siatka zaczyna się od `min`,
+ * nie od zera - przy `min=1, step=2` dozwolone są 1, 3, 5..., tak samo myszą jak klawiaturą.
  */
 export declare function kptSnapToStep(raw: number, min: number, max: number, step: number): number;

package/dist/internal/step.js

@@ -1,8 +1,8 @@
 /*
  * Arytmetyka kroku kontrolek liczbowych (`kpt-input-number`, `kpt-knob`).
- * Bliźniak w porcie Angulara (`shared/step.ts`) — zmiana w obu.
+ * Bliźniak w porcie Angulara (`shared/step.ts`) - zmiana w obu.
  */
-/** Miejsca po przecinku w zapisie liczby, także wykładniczym (`0.25` → 2, `1e-7` → 7). */
+/** Miejsca po przecinku w zapisie liczby, także wykładniczym (`0.25` -> 2, `1e-7` -> 7). */
 export function kptDecimals(n) {
     if (!Number.isFinite(n))
         return 0;
@@ -18,8 +18,8 @@ export function kptRoundTo(n, ...sources) {
     return Number(n.toFixed(decimals));
 }
 /**
- * Przyciąga wartość do siatki `min + k·step` i przycina do zakresu. Siatka zaczyna się od `min`,
- * nie od zera — przy `min=1, step=2` dozwolone są 1, 3, 5…, tak samo myszą jak klawiaturą.
+ * Przyciąga wartość do siatki `min + k,step` i przycina do zakresu. Siatka zaczyna się od `min`,
+ * nie od zera - przy `min=1, step=2` dozwolone są 1, 3, 5..., tak samo myszą jak klawiaturą.
  */
 export function kptSnapToStep(raw, min, max, step) {
     if (!(step > 0))

package/dist/internal/tween.d.ts

@@ -1,17 +1,17 @@
 /**
- * Płynne dojście liczby do celu — dla kontrolek, które pokazują wartość rysunkiem (łuk pokrętła)
+ * Płynne dojście liczby do celu - dla kontrolek, które pokazują wartość rysunkiem (łuk pokrętła)
  * i licznikiem. Pure TS bez frameworka; bliźniak portu Angulara: `shared/tween.ts`.
  *
  * Bez animacji, gdy użytkownik prosi o ograniczenie ruchu (`prefers-reduced-motion`) albo gdy nie
- * ma `requestAnimationFrame` (render po stronie serwera) — wtedy cel ustawia się od razu.
+ * ma `requestAnimationFrame` (render po stronie serwera) - wtedy cel ustawia się od razu.
  */
-/** Czy animować — reguła wspólna dla wszystkich kontrolek, żeby „mniej ruchu" działało wszędzie. */
+/** Czy animować - reguła wspólna dla wszystkich kontrolek, żeby "mniej ruchu" działało wszędzie. */
 export declare function kptMotionAllowed(): boolean;
 /**
  * Animuje od `from` do `to` przez `duration` ms, wołając `onFrame` z wartością pośrednią.
- * Zwraca funkcję przerwania — kolejny skok przerywa poprzedni i rusza z miejsca, w którym ten był,
+ * Zwraca funkcję przerwania - kolejny skok przerywa poprzedni i rusza z miejsca, w którym ten był,
  * więc szybkie stuknięcia strzałką nie cofają łuku do startu.
  */
 export declare function kptTween(from: number, to: number, duration: number, onFrame: (value: number) => void): () => void;
-/** Liczba miejsc po przecinku kroku (`0.25` → 2) — licznik w trakcie animacji nie pokazuje szumu. */
+/** Liczba miejsc po przecinku kroku (`0.25` -> 2) - licznik w trakcie animacji nie pokazuje szumu. */
 export declare function kptStepDecimals(step: number): number;

package/dist/internal/tween.js

@@ -1,14 +1,14 @@
 /**
- * Płynne dojście liczby do celu — dla kontrolek, które pokazują wartość rysunkiem (łuk pokrętła)
+ * Płynne dojście liczby do celu - dla kontrolek, które pokazują wartość rysunkiem (łuk pokrętła)
  * i licznikiem. Pure TS bez frameworka; bliźniak portu Angulara: `shared/tween.ts`.
  *
  * Bez animacji, gdy użytkownik prosi o ograniczenie ruchu (`prefers-reduced-motion`) albo gdy nie
- * ma `requestAnimationFrame` (render po stronie serwera) — wtedy cel ustawia się od razu.
+ * ma `requestAnimationFrame` (render po stronie serwera) - wtedy cel ustawia się od razu.
  */
 import { kptDecimals } from "./step.js";
 /** Zwolnienie pod koniec (ease-out cubic): ruch rusza od razu i dojeżdża miękko. */
 const easeOut = (t) => 1 - (1 - t) ** 3;
-/** Czy animować — reguła wspólna dla wszystkich kontrolek, żeby „mniej ruchu" działało wszędzie. */
+/** Czy animować - reguła wspólna dla wszystkich kontrolek, żeby "mniej ruchu" działało wszędzie. */
 export function kptMotionAllowed() {
     if (typeof requestAnimationFrame === 'undefined')
         return false;
@@ -16,7 +16,7 @@ export function kptMotionAllowed() {
 }
 /**
  * Animuje od `from` do `to` przez `duration` ms, wołając `onFrame` z wartością pośrednią.
- * Zwraca funkcję przerwania — kolejny skok przerywa poprzedni i rusza z miejsca, w którym ten był,
+ * Zwraca funkcję przerwania - kolejny skok przerywa poprzedni i rusza z miejsca, w którym ten był,
  * więc szybkie stuknięcia strzałką nie cofają łuku do startu.
  */
 export function kptTween(from, to, duration, onFrame) {
@@ -33,7 +33,7 @@ export function kptTween(from, to, duration, onFrame) {
     });
     return () => cancelAnimationFrame(frame);
 }
-/** Liczba miejsc po przecinku kroku (`0.25` → 2) — licznik w trakcie animacji nie pokazuje szumu. */
+/** Liczba miejsc po przecinku kroku (`0.25` -> 2) - licznik w trakcie animacji nie pokazuje szumu. */
 export function kptStepDecimals(step) {
     return kptDecimals(step);
 }

package/dist/internal/types.d.ts

@@ -3,12 +3,12 @@ import type { ComponentPropsWithoutRef, ElementType, ReactNode } from 'react';
  * Propsy wrappera hosta. Port odtwarza dwupoziomowy DOM Angulara
  * (`<kpt-button class="kpt-button-host">` wokół `<button class="kpt-button">`),
  * bo host niesie własne style. `className` i `ref` komponentu trafiają na element
- * wewnętrzny — wrapper konfiguruje się właśnie tym propem.
+ * wewnętrzny - wrapper konfiguruje się właśnie tym propem.
  */
 export type KptHostProps<E extends ElementType = 'span'> = Omit<ComponentPropsWithoutRef<E>, 'children'> & {
     /**
      * Atrybuty `data-*` hosta. JSX przepuszcza je na elementach wbudowanych sam z siebie,
-     * ale ten typ opisuje zwykły obiekt — bez tego wpisu stan wariantu, który w Angularze
+     * ale ten typ opisuje zwykły obiekt - bez tego wpisu stan wariantu, który w Angularze
      * siedzi na hoście (`[attr.data-on]`), nie miałby jak tam trafić.
      */
     [key: `data-${string}`]: string | number | boolean | undefined;

package/dist/internal/use-breakpoint.d.ts

@@ -1,7 +1,7 @@
 /** Nazwa breakpointa z tokenów `--kpt-breakpoint-*` (mobile-first). */
 export type KptBreakpoint = 'sm' | 'md' | 'lg' | 'xl' | '2xl';
 /**
- * Progi breakpointów w pikselach — czytane wprost z `@konce-pt/tokens`, więc nie da się
+ * Progi breakpointów w pikselach - czytane wprost z `@konce-pt/tokens`, więc nie da się
  * ich rozjechać z `@media` biblioteki ani z portem Angulara (tam ta sama tabela powstaje
  * w kroku generowania).
  */
@@ -11,7 +11,7 @@ export declare function useKptMediaQuery(query: string): boolean;
 /**
  * Czy viewport ma szerokość co najmniej danego breakpointa (mobile-first).
  *
- * O UKŁADZIE komponentów decyduje wyłącznie CSS — ten hook odpowiada tylko za zachowania,
+ * O UKŁADZIE komponentów decyduje wyłącznie CSS - ten hook odpowiada tylko za zachowania,
  * których CSS nie wyrazi (np. w którą stronę ma zadziałać przycisk). Dzięki temu nic nie
  * migocze przed hydracją.
  */

package/dist/internal/use-breakpoint.js

@@ -2,7 +2,7 @@ import { useSyncExternalStore } from 'react';
 import { KPT_BREAKPOINT_2XL, KPT_BREAKPOINT_LG, KPT_BREAKPOINT_MD, KPT_BREAKPOINT_SM, KPT_BREAKPOINT_XL, } from '@konce-pt/tokens';
 const toPx = (value) => Number.parseFloat(value);
 /**
- * Progi breakpointów w pikselach — czytane wprost z `@konce-pt/tokens`, więc nie da się
+ * Progi breakpointów w pikselach - czytane wprost z `@konce-pt/tokens`, więc nie da się
  * ich rozjechać z `@media` biblioteki ani z portem Angulara (tam ta sama tabela powstaje
  * w kroku generowania).
  */
@@ -15,7 +15,7 @@ export const KPT_BREAKPOINTS = {
 };
 /**
  * Jeden `MediaQueryList` i jeden nasłuch na zapytanie, współdzielone przez wszystkie
- * komponenty — tak samo jak memoizacja w `KptBreakpointObserver` po stronie Angulara.
+ * komponenty - tak samo jak memoizacja w `KptBreakpointObserver` po stronie Angulara.
  */
 const stores = new Map();
 /**
@@ -27,7 +27,7 @@ function storeFor(query) {
     const cached = stores.get(query);
     if (cached)
         return cached;
-    // Sam brak `window` nie wystarcza: jsdom go dostarcza, ale bez `matchMedia` — bez sprawdzenia
+    // Sam brak `window` nie wystarcza: jsdom go dostarcza, ale bez `matchMedia` - bez sprawdzenia
     // metody każdy test dotykający `KptAppShell` wywala się na TypeError. Wyniku nie zapisujemy
     // w cache'u, żeby stub podstawiony później (typowy `setup` testów) został podchwycony.
     if (typeof window === 'undefined' || typeof window.matchMedia !== 'function')
@@ -51,7 +51,7 @@ export function useKptMediaQuery(query) {
 /**
  * Czy viewport ma szerokość co najmniej danego breakpointa (mobile-first).
  *
- * O UKŁADZIE komponentów decyduje wyłącznie CSS — ten hook odpowiada tylko za zachowania,
+ * O UKŁADZIE komponentów decyduje wyłącznie CSS - ten hook odpowiada tylko za zachowania,
  * których CSS nie wyrazi (np. w którą stronę ma zadziałać przycisk). Dzięki temu nic nie
  * migocze przed hydracją.
  */

package/dist/internal/use-controllable-state.d.ts

@@ -6,7 +6,7 @@
  *
  * `setValue` ma stałą tożsamość: rodzic przekazujący `onChange` jako funkcję inline nie restartuje
  * efektów, które mają `setValue` w zależnościach. Przejście między trybami (`value` raz podane,
- * raz `undefined`) działa jak w Reakcie — po cichu przełącza źródło — ale w buildzie deweloperskim
+ * raz `undefined`) działa jak w Reakcie - po cichu przełącza źródło - ale w buildzie deweloperskim
  * ostrzega, tak jak React robi to dla `<input>`.
  */
 export declare function useControllableState<T>(options: {

package/dist/internal/use-controllable-state.js

@@ -8,14 +8,14 @@ import { isDevBuild } from "./dev.js";
  *
  * `setValue` ma stałą tożsamość: rodzic przekazujący `onChange` jako funkcję inline nie restartuje
  * efektów, które mają `setValue` w zależnościach. Przejście między trybami (`value` raz podane,
- * raz `undefined`) działa jak w Reakcie — po cichu przełącza źródło — ale w buildzie deweloperskim
+ * raz `undefined`) działa jak w Reakcie - po cichu przełącza źródło - ale w buildzie deweloperskim
  * ostrzega, tak jak React robi to dla `<input>`.
  */
 export function useControllableState(options) {
     const { value, defaultValue, onChange } = options;
     const isControlled = value !== undefined;
     const [uncontrolled, setUncontrolled] = useState(defaultValue);
-    // Najświeższy tryb i callback dla stabilnego `setValue` — odświeżane po zatwierdzeniu renderu.
+    // Najświeższy tryb i callback dla stabilnego `setValue` - odświeżane po zatwierdzeniu renderu.
     const latest = useRef({ isControlled, onChange });
     useLayoutEffect(() => {
         latest.current = { isControlled, onChange };
@@ -33,7 +33,7 @@ export function useControllableState(options) {
         warned.current = true;
         console.warn(isControlled
             ? '[koncept-ui] Komponent przeszedł z trybu niekontrolowanego w kontrolowany (`value` było undefined). Wybierz jeden tryb na całe życie komponentu.'
-            : '[koncept-ui] Komponent przeszedł z trybu kontrolowanego w niekontrolowany (`value` stało się undefined). Do „braku wartości” użyj null, nie undefined.');
+            : '[koncept-ui] Komponent przeszedł z trybu kontrolowanego w niekontrolowany (`value` stało się undefined). Do "braku wartości" użyj null, nie undefined.');
     }, [isControlled, initiallyControlled]);
     return [isControlled ? value : uncontrolled, setValue];
 }

package/dist/internal/use-id.d.ts

@@ -1,9 +1,9 @@
 /**
- * Stabilny identyfikator elementu w konwencji Angulara (`kpt-input-…`), z tą samą
+ * Stabilny identyfikator elementu w konwencji Angulara (`kpt-input-...`), z tą samą
  * zasadą pierwszeństwa: własne `id` przekazane przez propsy wygrywa.
  *
  * `useId()` z Reacta zwraca wartość ze znakami spoza [A-Za-z0-9] (React 19 używa
- * `«r0»`), która jest poprawna w atrybucie `id`, ale nie w selektorze CSS —
+ * `"r0"`), która jest poprawna w atrybucie `id`, ale nie w selektorze CSS -
  * dlatego zostawiamy z niej tylko część alfanumeryczną.
  */
 export declare function useKptId(provided: string | undefined, prefix: string): string;

package/dist/internal/use-id.js

@@ -1,10 +1,10 @@
 import { useId } from 'react';
 /**
- * Stabilny identyfikator elementu w konwencji Angulara (`kpt-input-…`), z tą samą
+ * Stabilny identyfikator elementu w konwencji Angulara (`kpt-input-...`), z tą samą
  * zasadą pierwszeństwa: własne `id` przekazane przez propsy wygrywa.
  *
  * `useId()` z Reacta zwraca wartość ze znakami spoza [A-Za-z0-9] (React 19 używa
- * `«r0»`), która jest poprawna w atrybucie `id`, ale nie w selektorze CSS —
+ * `"r0"`), która jest poprawna w atrybucie `id`, ale nie w selektorze CSS -
  * dlatego zostawiamy z niej tylko część alfanumeryczną.
  */
 export function useKptId(provided, prefix) {

package/dist/internal/use-modal-focus.d.ts

@@ -6,6 +6,6 @@ import { type RefObject } from 'react';
  * Bez tego `aria-modal="true"` obiecywał czytnikowi okno, z którego Tab po cichu wychodził.
  * Otwarty panel blokuje też przewijanie strony pod spodem (wspólny licznik z `KptDialog`).
  *
- * Port Angulara robi to samo na pułapce CDK (`shared/modal-focus.ts`) — zmiana zachowania w obu.
+ * Port Angulara robi to samo na pułapce CDK (`shared/modal-focus.ts`) - zmiana zachowania w obu.
  */
 export declare function useModalFocus(open: boolean, panelRef: RefObject<HTMLElement | null>): void;

package/dist/internal/use-modal-focus.js

@@ -2,10 +2,10 @@ import { useEffect } from 'react';
 import { kptLockScroll } from "./scroll-lock.js";
 /**
  * Stos otwartych paneli modalnych. Pułapki słuchają `keydown` na dokumencie, więc przy dwóch
- * otwartych naraz (szuflada → dialog) walczyłyby o ten sam Tab — klawisz obsługuje tylko najwyższa.
+ * otwartych naraz (szuflada -> dialog) walczyłyby o ten sam Tab - klawisz obsługuje tylko najwyższa.
  */
 const stack = [];
-/** Elementy z kolejki Tab — na nich zawija się pułapka. */
+/** Elementy z kolejki Tab - na nich zawija się pułapka. */
 const TABBABLE = 'a[href], button:not(:disabled), input:not(:disabled), select:not(:disabled), textarea:not(:disabled), [tabindex]:not([tabindex="-1"])';
 function tabbables(panel) {
     return [...panel.querySelectorAll(TABBABLE)].filter((el) => !el.closest('[hidden], [inert]'));
@@ -17,7 +17,7 @@ function tabbables(panel) {
  * Bez tego `aria-modal="true"` obiecywał czytnikowi okno, z którego Tab po cichu wychodził.
  * Otwarty panel blokuje też przewijanie strony pod spodem (wspólny licznik z `KptDialog`).
  *
- * Port Angulara robi to samo na pułapce CDK (`shared/modal-focus.ts`) — zmiana zachowania w obu.
+ * Port Angulara robi to samo na pułapce CDK (`shared/modal-focus.ts`) - zmiana zachowania w obu.
  */
 export function useModalFocus(open, panelRef) {
     useEffect(() => {