@konce-pt/react 0.12.0 → 0.14.0

package/dist/chips-input/llms.txt

@@ -1,22 +1,22 @@
 # KptChipsInput (@konce-pt/react)
 
-A tag field — add with Enter or a comma, remove with Backspace or ×.
+A tag field - add with Enter or a comma, remove with Backspace or x.
 Import: `import { KptChipsInput } from '@konce-pt/react';`
 
 ## DOM
     <div class="kpt-chips-input-host">
       <div class="kpt-chips-input">
-        …KptChip per tag…
+        ...KptChip per tag...
         <input class="kpt-chips-input__field" type="text">
       </div>
     </div>
 
 ## Props
-- `value` / `defaultValue` / `onValueChange` — `string[]`
-- `placeholder`: string — omitted falls back to `chipsInput.placeholder`
+- `value` / `defaultValue` / `onValueChange` - `string[]`
+- `placeholder`: string - omitted falls back to `chipsInput.placeholder`
 - `allowDuplicates`: boolean (default false)
 - `disabled`, `invalid`, `touched`, `onTouch()`
-- `locale`, `dictionary` — i18n overrides for this component only
+- `locale`, `dictionary` - i18n overrides for this component only
 
 ## The buffer is not state
 The text being typed lives in the DOM, not in React state: the component's value is the list of
@@ -24,19 +24,19 @@ committed tags, and the typing buffer is the field's own business. Every keystro
 not re-render the chips.
 
 ## Keyboard
-Enter and a comma commit the tag. Backspace in an empty field eats the last chip — the behaviour
+Enter and a comma commit the tag. Backspace in an empty field eats the last chip - the behaviour
 every mail client teaches. Blur commits whatever is left in the field, so a half-typed tag is not
 lost by clicking away.
 
 ## Examples
-    <KptChipsInput value={tags} onValueChange={setTags} placeholder="Add a tag…" />
+    <KptChipsInput value={tags} onValueChange={setTags} placeholder="Add a tag..." />
     <KptChipsInput value={tags} onValueChange={setTags} allowDuplicates />
 
 ## Screen reader and keyboard
 The tags are a list (`role="list"`/`listitem`), so a screen reader hears how many there are. Adding,
 removing (also with `Backspace`) and a rejected duplicate are announced by a polite live region
 (`chipsInput.added`/`removed`/`duplicate`); a duplicate stays in the field to be corrected instead
-of vanishing. After removing a tag with its `×`, focus returns to the text field.
+of vanishing. After removing a tag with its `x`, focus returns to the text field.
 
 ## Label and description
 `id` goes to the native field, not the host; without one it comes from `KptFormField` or is
@@ -44,6 +44,13 @@ generated. Inside `KptFormField` the wrapper's `label[for]` points at it and the
 added to `aria-describedby` (merged with your own). Without a wrapper, name it with `ariaLabel`.
 New: `id`, `ariaLabel`, `required` and `aria-invalid` on the text field.
 
+## Motion
+An added tag pops in (grows from a smaller size and sharpens out of a blur); a removed one - by its "x"
+or by `Backspace` - fades and shrinks in place while the following tags and the text field slide over on
+a spring. The value changes at once; the motion only illustrates it. Follows `enter` from `KptMotionProvider`
+(`spring` / `fade` - only fades, the neighbours slide without the spring / `none`); `enabled: false`
+and the system "reduce motion" setting always win.
+
 ## Tokens
 `--kpt-form-field-{bg,border,border-focus,border-error,radius}` plus the chip tokens.
 

package/dist/clock/clock.d.ts

@@ -1,18 +1,18 @@
 import { type ComponentPropsWithRef } from 'react';
 import { type KptI18nOverrides } from '../i18n/i18n-context.tsx';
 export interface KptClockProps extends Omit<ComponentPropsWithRef<'div'>, 'onChange'>, KptI18nOverrides {
-    /** Godzina jako 'HH:mm' — zawsze 24h, niezależnie od `hourFormat`. */
+    /** Godzina jako 'HH:mm' - zawsze 24h, niezależnie od `hourFormat`. */
     value?: string;
     onValueChange?: (value: string) => void;
     hourFormat?: 12 | 24;
     minuteStep?: number;
 }
 /**
- * Tarcza zegara — dwa etapy: godziny → minuty, klikiem albo przeciąganiem. W trybie 24h dochodzi
- * wewnętrzny pierścień 13–00; w 12h przełącznik AM/PM z etykietami pory dnia z `Intl`. Używana
+ * Tarcza zegara - dwa etapy: godziny -> minuty, klikiem albo przeciąganiem. W trybie 24h dochodzi
+ * wewnętrzny pierścień 13-00; w 12h przełącznik AM/PM z etykietami pory dnia z `Intl`. Używana
  * przez `KptDatepicker` i `KptDateRange`.
  *
- * Klawiatura: segmenty godzin i minut to `role="spinbutton"` — `↑`/`↓` o jeden krok (minuty
+ * Klawiatura: segmenty godzin i minut to `role="spinbutton"` - `ArrowUp`/`ArrowDown` o jeden krok (minuty
  * o `minuteStep`), `PageUp`/`PageDown` o pięć, `Home`/`End` do granic. Tak da się ustawić każdą
  * minutę, także spoza znaczników tarczy co pięć.
  *

package/dist/clock/clock.js

@@ -4,14 +4,14 @@ import { useRef, useState } from 'react';
 import { dayPeriodLabels, from12h, handAngle, handIsInner, hourFromAngle, hourMarks, minuteFromAngle, minuteMarks, pad, parseTime, stepClockTime, } from '@konce-pt/datetime';
 import { cn } from "../internal/cn.js";
 import { useKptMessages } from "../i18n/i18n-context.js";
-/** Klawisze segmentu czasu → liczba kroków. */
+/** Klawisze segmentu czasu -> liczba kroków. */
 const SEGMENT_STEPS = { ArrowUp: 1, ArrowDown: -1, PageUp: 5, PageDown: -5 };
 /**
- * Tarcza zegara — dwa etapy: godziny → minuty, klikiem albo przeciąganiem. W trybie 24h dochodzi
- * wewnętrzny pierścień 13–00; w 12h przełącznik AM/PM z etykietami pory dnia z `Intl`. Używana
+ * Tarcza zegara - dwa etapy: godziny -> minuty, klikiem albo przeciąganiem. W trybie 24h dochodzi
+ * wewnętrzny pierścień 13-00; w 12h przełącznik AM/PM z etykietami pory dnia z `Intl`. Używana
  * przez `KptDatepicker` i `KptDateRange`.
  *
- * Klawiatura: segmenty godzin i minut to `role="spinbutton"` — `↑`/`↓` o jeden krok (minuty
+ * Klawiatura: segmenty godzin i minut to `role="spinbutton"` - `ArrowUp`/`ArrowDown` o jeden krok (minuty
  * o `minuteStep`), `PageUp`/`PageDown` o pięć, `Home`/`End` do granic. Tak da się ustawić każdą
  * minutę, także spoza znaczników tarczy co pięć.
  *
@@ -22,7 +22,7 @@ export function KptClock({ value = '', onValueChange, hourFormat = 24, minuteSte
     const { t, locale: activeLocale } = useKptMessages({ locale, dictionary });
     const faceRef = useRef(null);
     const [phase, setPhase] = useState('hours');
-    // Wartość jest jedynym źródłem prawdy — stan tarczy wyliczamy z niej przy każdym renderze,
+    // Wartość jest jedynym źródłem prawdy - stan tarczy wyliczamy z niej przy każdym renderze,
     // więc podmiana `value` z zewnątrz nie wymaga synchronizacji.
     const parsed = parseTime(value);
     const hour = parsed?.h ?? 0;
@@ -31,7 +31,7 @@ export function KptClock({ value = '', onValueChange, hourFormat = 24, minuteSte
     const hour12 = hour % 12 === 0 ? 12 : hour % 12;
     const periods = dayPeriodLabels(activeLocale);
     const hourLabel = hourFormat === 12 ? String(hour12) : pad(hour);
-    // W 12h czytnik słyszy godzinę z porą dnia („9 PM”), nie samą liczbę 21.
+    // W 12h czytnik słyszy godzinę z porą dnia ("9 PM"), nie samą liczbę 21.
     const hourText = hourFormat === 12 ? `${hour12} ${ampm === 'AM' ? periods.am : periods.pm}` : hourLabel;
     const emit = (h, m) => onValueChange?.(`${pad(h)}:${pad(m)}`);
     const onSegmentKey = (part, event) => {
@@ -58,7 +58,7 @@ export function KptClock({ value = '', onValueChange, hourFormat = 24, minuteSte
         if (event.type === 'pointerdown')
             face.setPointerCapture(event.pointerId);
         // Przy ruchu bez wciśniętego przycisku tarcza ma tylko śledzić kursor wzrokiem, nie zmieniać
-        // wartości — inaczej samo przesunięcie myszy nad zegarem przestawiałoby godzinę.
+        // wartości - inaczej samo przesunięcie myszy nad zegarem przestawiałoby godzinę.
         else if (!(event.buttons & 1))
             return;
         const rect = face.getBoundingClientRect();

package/dist/clock/llms.txt

@@ -1,6 +1,6 @@
 # KptClock (@konce-pt/react)
 
-A clock dial — two stages: hours → minutes, by click or by drag. Used by `KptDatepicker` and
+A clock dial - two stages: hours -> minutes, by click or by drag. Used by `KptDatepicker` and
 `KptDateRange`, and available on its own.
 Import: `import { KptClock } from '@konce-pt/react';`
 
@@ -9,19 +9,19 @@ Import: `import { KptClock } from '@konce-pt/react';`
       <div class="kpt-clock">
         <div class="kpt-clock__time">
           <button class="kpt-clock__seg is-active">15</button>:<button class="kpt-clock__seg">30</button>
-          <div class="kpt-clock__ampm">…12h only…</div>
+          <div class="kpt-clock__ampm">...12h only...</div>
         </div>
         <div class="kpt-clock__face">
           <span class="kpt-clock__hand"></span>
-          <button class="kpt-clock__num kpt-clock__num--inner">15</button>…
+          <button class="kpt-clock__num kpt-clock__num--inner">15</button>...
         </div>
       </div>
     </div>
 
 ## Props
-- `value` / `onValueChange` — 'HH:mm', always 24h regardless of `hourFormat`
+- `value` / `onValueChange` - 'HH:mm', always 24h regardless of `hourFormat`
 - `hourFormat`: 12 | 24 (default 24)
-- `minuteStep`: number (default 1) — minute snapping while dragging
+- `minuteStep`: number (default 1) - minute snapping while dragging
 - `className`, `ref` and every other `<div>` prop go to the host
 
 ## The value is the only state
@@ -29,7 +29,7 @@ Hours and minutes are derived from `value` on every render, so replacing it from
 synchronisation. The component keeps one piece of state of its own: which stage the dial is on.
 
 ## Two rings in 24h
-12 and 1–11 sit on the outer ring, 00 and 13–23 on the inner one, because 24 numbers on one circle
+12 and 1-11 sit on the outer ring, 00 and 13-23 on the inner one, because 24 numbers on one circle
 are unreadable. While dragging, the click radius decides the ring; in 12h the AM/PM toggle decides
 the half-day instead.
 
@@ -47,8 +47,8 @@ the numbers `--kpt-color-on-surface`.
 
 ## Accessibility
 Every mark is a real `<button>` with `aria-pressed`, inside a group named "Hours"/"Minutes". The hour and
-minute segments are `role="spinbutton"`: Tab to them, `↑`/`↓` step by one (minutes by `minuteStep`),
-`PageUp`/`PageDown` by five, `Home`/`End` to the bounds — so every minute is reachable, not only the
+minute segments are `role="spinbutton"`: Tab to them, `ArrowUp`/`ArrowDown` step by one (minutes by `minuteStep`),
+`PageUp`/`PageDown` by five, `Home`/`End` to the bounds - so every minute is reachable, not only the
 five-minute marks. Focusing a segment switches the stage. AM/PM labels come from `Intl` for the active
 language and the hour's `aria-valuetext` includes the period ("9 PM"). `locale`/`dictionary` override the
 language for this component.

package/dist/color-picker/color-picker.d.ts

@@ -1,6 +1,6 @@
 import { type ComponentPropsWithRef } from 'react';
 import { type KptI18nOverrides } from '../i18n/i18n-context.tsx';
-/** Gotowy kolor z nazwą — nazwa trafia do `aria-label` próbki. */
+/** Gotowy kolor z nazwą - nazwa trafia do `aria-label` próbki. */
 export interface KptColorPreset {
     value: string;
     label: string;
@@ -12,17 +12,17 @@ export interface KptColorPickerProps extends Omit<ComponentPropsWithRef<'div'>,
     onValueChange?: (value: string) => void;
     /**
      * Paleta szybkiego wyboru: kody albo `{ value, label }`. Kod sam w sobie niewiele mówi
-     * czytnikowi („#3b82f6”), więc własną paletę warto nazwać; domyślne kolory mają nazwy z i18n.
+     * czytnikowi ("#3b82f6"), więc własną paletę warto nazwać; domyślne kolory mają nazwy z i18n.
      */
     presets?: readonly (string | KptColorPreset)[];
-    /** Id elementu fokusowalnego (nie hosta); bez niego generowane, w `KptFormField` — z wrappera. */
+    /** Id elementu fokusowalnego (nie hosta); bez niego generowane, w `KptFormField` - z wrappera. */
     id?: string;
     /** Nazwa dostępna, gdy kontrolki nie opisuje etykieta (`<label for>` albo `KptFormField`). */
     ariaLabel?: string | null;
     disabled?: boolean;
-    /** Tylko do odczytu — kolor widać, nie da się go zmienić. */
+    /** Tylko do odczytu - kolor widać, nie da się go zmienić. */
     readOnly?: boolean;
-    /** Pole wymagane — `aria-required` na polu kodu. */
+    /** Pole wymagane - `aria-required` na polu kodu. */
     required?: boolean;
     invalid?: boolean;
     touched?: boolean;
@@ -31,7 +31,7 @@ export interface KptColorPickerProps extends Omit<ComponentPropsWithRef<'div'>,
 /**
  * Wybór koloru: próbka, pole hex i presety. Wartością jest hex.
  *
- * Próbka to natywny `<input type="color">` schowany pod kolorowym kwadratem — paletę systemową
+ * Próbka to natywny `<input type="color">` schowany pod kolorowym kwadratem - paletę systemową
  * otwiera przeglądarka, więc działa też na telefonie i nie duplikujemy jej własnym kodem.
  *
  * @example

package/dist/color-picker/color-picker.js

@@ -19,7 +19,7 @@ const DEFAULT_NAMES = {
 };
 /**
  * Kod z pola tekstowego jako `#rrggbb` albo `null`. Przyjmuje zapis bez `#` i skrót `#rgb`
- * (`#fff` → `#ffffff`). Bliźniak w porcie Angulara (`color-picker.component.ts`) — zmiana w obu.
+ * (`#fff` -> `#ffffff`). Bliźniak w porcie Angulara (`color-picker.component.ts`) - zmiana w obu.
  */
 function parseHex(text) {
     const raw = text.trim().replace(/^#/, '').toLowerCase();
@@ -30,7 +30,7 @@ function parseHex(text) {
 /**
  * Wybór koloru: próbka, pole hex i presety. Wartością jest hex.
  *
- * Próbka to natywny `<input type="color">` schowany pod kolorowym kwadratem — paletę systemową
+ * Próbka to natywny `<input type="color">` schowany pod kolorowym kwadratem - paletę systemową
  * otwiera przeglądarka, więc działa też na telefonie i nie duplikujemy jej własnym kodem.
  *
  * @example
@@ -75,7 +75,7 @@ export function KptColorPicker({ value, defaultValue = '#3b82f6', onValueChange,
                     } }), _jsx("div", { className: "kpt-color-picker__presets", children: presetList.map((preset) => (_jsx("button", { type: "button", className: cn('kpt-color-picker__preset', isActive(preset.value) && 'is-active'), style: { backgroundColor: preset.value }, disabled: disabled || readOnly, "aria-pressed": isActive(preset.value), onClick: () => {
                             setHexDraft(null);
                             setCurrent(preset.value);
-                            // Wybór presetem to też dotknięcie pola — inaczej błąd walidacji nigdy by się nie pokazał.
+                            // Wybór presetem to też dotknięcie pola - inaczej błąd walidacji nigdy by się nie pokazał.
                             onTouch?.();
                         }, "aria-label": preset.label }, preset.value))) })] }) }));
 }

package/dist/color-picker/llms.txt

@@ -11,20 +11,20 @@ Import: `import { KptColorPicker } from '@konce-pt/react';`
         </label>
         <input type="text" class="kpt-color-picker__hex" maxlength="7" value="#3b82f6">
         <div class="kpt-color-picker__presets">
-          <button class="kpt-color-picker__preset is-active" aria-label="#3b82f6"></button>…
+          <button class="kpt-color-picker__preset is-active" aria-label="#3b82f6"></button>...
         </div>
       </div>
     </div>
 
 ## Props
-- `value` / `defaultValue` / `onValueChange` — the hex colour (default `'#3b82f6'`)
-- `presets`: string[] — the quick-pick palette (8 colours by default; `[]` hides the row)
+- `value` / `defaultValue` / `onValueChange` - the hex colour (default `'#3b82f6'`)
+- `presets`: string[] - the quick-pick palette (8 colours by default; `[]` hides the row)
 - `disabled`, `invalid`, `touched`, `onTouch()`
 - `className`, `ref` and every other `<div>` prop go to the host
 
 ## The swatch is a native colour input
 `<input type="color">` sits transparent under the coloured square, so the system palette is the
-browser's — it works on a phone and there is no picker of ours to maintain. The hex field edits the
+browser's - it works on a phone and there is no picker of ours to maintain. The hex field edits the
 same value as text, and the presets write it directly.
 
 ## Examples
@@ -34,7 +34,7 @@ same value as text, and the presets write it directly.
 ## Screen reader and keyboard
 `presets` accepts codes or `{ value, label }` (the `KptColorPreset` type): the label names the
 swatch, because a hex code says little to a screen reader; the default palette is named from i18n
-(`colorPicker.red`…). The active swatch has `aria-pressed`. The hex field changes the value only on
+(`colorPicker.red`...). The active swatch has `aria-pressed`. The hex field changes the value only on
 a full `#rrggbb` code (a missing `#` is added); an incomplete code stays visible with
 `aria-invalid`.
 

package/dist/confirm/confirm-container.d.ts

@@ -3,15 +3,15 @@ import { type KptI18nOverrides } from '../i18n/i18n-context.tsx';
 export interface KptConfirmContainerProps extends ComponentPropsWithRef<'div'>, KptI18nOverrides {
 }
 /**
- * Kontener potwierdzeń — renderuje żądanie z `kptConfirm()` na `KptDialog`. Umieść raz
+ * Kontener potwierdzeń - renderuje żądanie z `kptConfirm()` na `KptDialog`. Umieść raz
  * w aplikacji, obok `<KptToastContainer />`.
  *
  * Okno to `role="alertdialog"` z treścią pytania w `aria-describedby`, więc czytnik odczytuje
- * je od razu po otwarciu. Fokus startuje na przycisku odmowy — bezpieczniejszej odpowiedzi,
+ * je od razu po otwarciu. Fokus startuje na przycisku odmowy - bezpieczniejszej odpowiedzi,
  * której przypadkowy `Enter` niczego nie usunie.
  *
  * @example
  * <KptConfirmContainer />
- * // gdziekolwiek: if (await kptConfirm({ message: 'Usunąć?' })) { … }
+ * // gdziekolwiek: if (await kptConfirm({ message: 'Usunąć?' })) { ... }
  */
 export declare function KptConfirmContainer({ locale, dictionary, className, ...rest }: Readonly<KptConfirmContainerProps>): import("react").JSX.Element;

package/dist/confirm/confirm-container.js

@@ -9,30 +9,30 @@ import { KptDialog } from "../dialog/dialog.js";
 import { KptIcon } from "../icon/icon.js";
 import { acceptKptConfirm, rejectKptConfirm, useKptConfirmRequest } from "./confirm-store.js";
 /**
- * Kontener potwierdzeń — renderuje żądanie z `kptConfirm()` na `KptDialog`. Umieść raz
+ * Kontener potwierdzeń - renderuje żądanie z `kptConfirm()` na `KptDialog`. Umieść raz
  * w aplikacji, obok `<KptToastContainer />`.
  *
  * Okno to `role="alertdialog"` z treścią pytania w `aria-describedby`, więc czytnik odczytuje
- * je od razu po otwarciu. Fokus startuje na przycisku odmowy — bezpieczniejszej odpowiedzi,
+ * je od razu po otwarciu. Fokus startuje na przycisku odmowy - bezpieczniejszej odpowiedzi,
  * której przypadkowy `Enter` niczego nie usunie.
  *
  * @example
  * <KptConfirmContainer />
- * // gdziekolwiek: if (await kptConfirm({ message: 'Usunąć?' })) { … }
+ * // gdziekolwiek: if (await kptConfirm({ message: 'Usunąć?' })) { ... }
  */
 export function KptConfirmContainer({ locale, dictionary, className, ...rest }) {
     const { t } = useKptMessages({ locale, dictionary });
     const request = useKptConfirmRequest();
     const messageId = useKptId(undefined, 'kpt-confirm-message');
     const rejectRef = useRef(null);
-    // `showModal()` skupia pierwszy element okna, czyli „×” w nagłówku. Efekt dziecka (`KptDialog`)
+    // `showModal()` skupia pierwszy element okna, czyli "x" w nagłówku. Efekt dziecka (`KptDialog`)
     // biegnie przed efektem rodzica, więc tu okno jest już otwarte i fokus można przenieść.
     useEffect(() => {
         if (request)
             rejectRef.current?.focus();
     }, [request]);
     return (_jsx("div", { className: cn('kpt-confirm-container-host', className), ...rest, children: _jsxs(KptDialog, { open: request !== null, 
-            // Escape i × zamykają okno bez odpowiedzi — traktujemy to jak odmowę, żeby czekający
+            // Escape i x zamykają okno bez odpowiedzi - traktujemy to jak odmowę, żeby czekający
             // `await` zawsze coś dostał.
             onOpenChange: (open) => {
                 if (!open)

package/dist/confirm/confirm-store.d.ts

@@ -15,15 +15,15 @@ export interface KptConfirmRequest extends KptConfirmOptions {
  * Pyta użytkownika o potwierdzenie. Wymaga `<KptConfirmContainer />` w aplikacji.
  *
  * Jedno żądanie naraz: kolejne wywołanie przy otwartym oknie odrzuca poprzednie, żeby jego
- * Promise nigdy nie został nierozstrzygnięty — czekający `await` zostałby inaczej na zawsze.
+ * Promise nigdy nie został nierozstrzygnięty - czekający `await` zostałby inaczej na zawsze.
  *
  * @example
- * if (await kptConfirm({ message: 'Usunąć rekord?', variant: 'danger' })) { … }
+ * if (await kptConfirm({ message: 'Usunąć rekord?', variant: 'danger' })) { ... }
  */
 export declare function kptConfirm(options: KptConfirmOptions): Promise<boolean>;
-/** Zamyka bieżące potwierdzenie odpowiedzią „tak". Używane przez kontener. */
+/** Zamyka bieżące potwierdzenie odpowiedzią "tak". Używane przez kontener. */
 export declare function acceptKptConfirm(): void;
-/** Zamyka bieżące potwierdzenie odpowiedzią „nie" — także przy Escape i kliknięciu w tło. */
+/** Zamyka bieżące potwierdzenie odpowiedzią "nie" - także przy Escape i kliknięciu w tło. */
 export declare function rejectKptConfirm(): void;
 /** Bieżące żądanie potwierdzenia albo `null`. */
 export declare function useKptConfirmRequest(): KptConfirmRequest | null;

package/dist/confirm/confirm-store.js

@@ -1,7 +1,7 @@
 import { useSyncExternalStore } from 'react';
 import { isDevBuild } from "../internal/dev.js";
 /*
- * Magazyn potwierdzeń jako moduł-singleton — odpowiednik serwisu `providedIn: 'root'` z Angulara,
+ * Magazyn potwierdzeń jako moduł-singleton - odpowiednik serwisu `providedIn: 'root'` z Angulara,
  * ten sam wzorzec co `kptToast`. Dzięki temu `await kptConfirm(...)` woła się także spoza drzewa
  * Reacta (warstwa danych, guard nawigacji), bez owijania aplikacji providerem.
  */
@@ -16,15 +16,15 @@ function emit() {
  * Pyta użytkownika o potwierdzenie. Wymaga `<KptConfirmContainer />` w aplikacji.
  *
  * Jedno żądanie naraz: kolejne wywołanie przy otwartym oknie odrzuca poprzednie, żeby jego
- * Promise nigdy nie został nierozstrzygnięty — czekający `await` zostałby inaczej na zawsze.
+ * Promise nigdy nie został nierozstrzygnięty - czekający `await` zostałby inaczej na zawsze.
  *
  * @example
- * if (await kptConfirm({ message: 'Usunąć rekord?', variant: 'danger' })) { … }
+ * if (await kptConfirm({ message: 'Usunąć rekord?', variant: 'danger' })) { ... }
  */
 export function kptConfirm(options) {
-    // Kontener subskrybuje magazyn — bez subskrybentów nikt nie pokaże okna ani nie rozstrzygnie obietnicy.
+    // Kontener subskrybuje magazyn - bez subskrybentów nikt nie pokaże okna ani nie rozstrzygnie obietnicy.
     if (isDevBuild() && listeners.size === 0) {
-        console.warn('kptConfirm: brak <KptConfirmContainer /> w aplikacji — okno się nie pokaże, ' +
+        console.warn('kptConfirm: brak <KptConfirmContainer /> w aplikacji - okno się nie pokaże, ' +
             'a obietnica nie rozstrzygnie się, dopóki kontener nie zostanie dodany.');
     }
     return new Promise((resolve) => {
@@ -38,11 +38,11 @@ function settle(accepted) {
     current = null;
     emit();
 }
-/** Zamyka bieżące potwierdzenie odpowiedzią „tak". Używane przez kontener. */
+/** Zamyka bieżące potwierdzenie odpowiedzią "tak". Używane przez kontener. */
 export function acceptKptConfirm() {
     settle(true);
 }
-/** Zamyka bieżące potwierdzenie odpowiedzią „nie" — także przy Escape i kliknięciu w tło. */
+/** Zamyka bieżące potwierdzenie odpowiedzią "nie" - także przy Escape i kliknięciu w tło. */
 export function rejectKptConfirm() {
     settle(false);
 }

package/dist/confirm/llms.txt

@@ -6,21 +6,21 @@ Import: `import { kptConfirm, KptConfirmContainer } from '@konce-pt/react';`
 
 ## Usage
 1. Render `<KptConfirmContainer />` once in the app, next to `<KptToastContainer />`.
-2. `await kptConfirm(options)` from anywhere — it resolves to `true` or `false`.
+2. `await kptConfirm(options)` from anywhere - it resolves to `true` or `false`.
 
 ## KptConfirmOptions
 - `message`: string (required); `header?`: string
 - `acceptLabel?`, `rejectLabel?`: string
-- `variant?`: `'filled'` | `'danger'` — the accept button and the icon colour
+- `variant?`: `'filled'` | `'danger'` - the accept button and the icon colour
 - `icon?`: an icon name from the registry
 
 ## A store, not a hook
-The state is a module singleton, so `kptConfirm()` works outside the React tree too — a data layer,
-a navigation guard — without wrapping the app in a provider. `useKptConfirmRequest()` exposes the
+The state is a module singleton, so `kptConfirm()` works outside the React tree too - a data layer,
+a navigation guard - without wrapping the app in a provider. `useKptConfirmRequest()` exposes the
 current request through `useSyncExternalStore` for anyone rendering their own container.
 
 ## The promise always settles
-Escape and the × close the dialog through `onOpenChange`, which resolves `false` — an awaiting
+Escape and the x close the dialog through `onOpenChange`, which resolves `false` - an awaiting
 caller is never left hanging. A second `kptConfirm()` while one is open rejects the previous
 request for the same reason: one request at a time, and nothing is dropped silently. Without a
 mounted `<KptConfirmContainer />` nobody can show the dialog, so a dev build warns in the console.
@@ -44,4 +44,4 @@ Inherited from `KptDialog`; the icon follows the variant (`--kpt-color-danger` /
 Built on `KptDialog`, so the focus trap, Escape and the backdrop are the native `<dialog>`'s.
 The window is `role="alertdialog"` named by its header, with the message tied to it through
 `aria-describedby`, so a screen reader reads the question as soon as it opens. Focus starts on the
-reject button — the safe answer, so a stray `Enter` deletes nothing. Escape and × reject.
+reject button - the safe answer, so a stray `Enter` deletes nothing. Escape and x reject.

package/dist/context-menu/context-menu.d.ts

@@ -14,7 +14,7 @@ export interface KptContextMenuProps<T> extends Omit<ComponentPropsWithRef<'div'
  * gdzie był. `Shift+F10` i klawisz Menu na skupionym elemencie obszaru też otwierają menu
  * (panel staje wtedy przy tym elemencie). Panel jest dociskany do krawędzi okna.
  *
- * W odróżnieniu od `KptMenu` panel nie idzie przez `KptOverlay` — nie ma tu wyzwalacza,
+ * W odróżnieniu od `KptMenu` panel nie idzie przez `KptOverlay` - nie ma tu wyzwalacza,
  * względem którego dałoby się go przypiąć; pozycję wyznaczają współrzędne kliknięcia,
  * a wygląd i warstwę niesie wspólny SCSS (`.kpt-context-menu__panel`).
  *

package/dist/context-menu/context-menu.js

@@ -14,7 +14,7 @@ const EDGE = 8;
  * gdzie był. `Shift+F10` i klawisz Menu na skupionym elemencie obszaru też otwierają menu
  * (panel staje wtedy przy tym elemencie). Panel jest dociskany do krawędzi okna.
  *
- * W odróżnieniu od `KptMenu` panel nie idzie przez `KptOverlay` — nie ma tu wyzwalacza,
+ * W odróżnieniu od `KptMenu` panel nie idzie przez `KptOverlay` - nie ma tu wyzwalacza,
  * względem którego dałoby się go przypiąć; pozycję wyznaczają współrzędne kliknięcia,
  * a wygląd i warstwę niesie wspólny SCSS (`.kpt-context-menu__panel`).
  *
@@ -28,9 +28,9 @@ export function KptContextMenu({ items = [], children, onSelect, className, ...r
     const [point, setPoint] = useState({ x: 0, y: 0 });
     const panelRef = useRef(null);
     const layerRef = useRef(null);
-    /** Licznik otwarć — każde PPM (także przy otwartym menu) dociska panel i ustawia fokus od nowa. */
+    /** Licznik otwarć - każde PPM (także przy otwartym menu) dociska panel i ustawia fokus od nowa. */
     const [openSeq, setOpenSeq] = useState(0);
-    /** Element, który miał fokus przed otwarciem — tam fokus wraca po zamknięciu. */
+    /** Element, który miał fokus przed otwarciem - tam fokus wraca po zamknięciu. */
     const returnTo = useRef(null);
     const onContextMenu = (event) => {
         event.preventDefault();
@@ -49,7 +49,7 @@ export function KptContextMenu({ items = [], children, onSelect, className, ...r
     };
     // Po każdym otwarciu: warstwa w top layer, dociśnięcie do okna i fokus na pierwszej pozycji.
     // Przed malowaniem (`useLayoutEffect`), żeby panel nie mignął w niedociśniętym miejscu. Docisk
-    // idzie wprost w styl elementu — stan `point` zostaje, więc React go nie nadpisze.
+    // idzie wprost w styl elementu - stan `point` zostaje, więc React go nie nadpisze.
     useLayoutEffect(() => {
         const panel = panelRef.current;
         if (openSeq === 0 || !panel)
@@ -73,7 +73,7 @@ export function KptContextMenu({ items = [], children, onSelect, className, ...r
         if (target?.isConnected)
             target.focus();
     };
-    // Przewinięcie albo zmiana rozmiaru okna odrywa panel od miejsca kliknięcia — zamykamy go.
+    // Przewinięcie albo zmiana rozmiaru okna odrywa panel od miejsca kliknięcia - zamykamy go.
     const closeOnMove = useEffectEvent(() => close());
     useEffect(() => {
         if (!open)

package/dist/context-menu/llms.txt

@@ -5,15 +5,15 @@ Import: `import { KptContextMenu } from '@konce-pt/react';`
 
 ## DOM
     <div class="kpt-context-menu-host">
-      <div class="kpt-context-menu__area">…children…</div>
+      <div class="kpt-context-menu__area">...children...</div>
       <div class="kpt-context-menu__backdrop"></div>
-      <div class="kpt-context-menu__panel" role="menu" style="left: 320px; top: 210px">…</div>
+      <div class="kpt-context-menu__panel" role="menu" style="left: 320px; top: 210px">...</div>
     </div>
 
 ## Props
-- `items`: `KptMenuItem<T>[]` — the same shape as `KptMenu`
-- `children`: ReactNode — the area that reacts to the right mouse button
-- `onSelect(item)` — the picked item
+- `items`: `KptMenuItem<T>[]` - the same shape as `KptMenu`
+- `children`: ReactNode - the area that reacts to the right mouse button
+- `onSelect(item)` - the picked item
 - `className`, `ref` and every other `<div>` prop go to the host
 
 ## Not an overlay
@@ -29,7 +29,7 @@ open the browser's own menu. Picking an item closes it and reports the choice; `
 The same model as `KptMenu` (the shared `menu-keys.ts`): opening moves focus to the first item, arrows /
 `Home` / `End` move between items (disabled ones and separators are skipped), `Escape` and `Tab` close
 it and focus returns to where it was. `Shift+F10` and the context-menu key on a focused element inside
-the area open it too — the browser then sends `contextmenu` without mouse coordinates, so the panel is
+the area open it too - the browser then sends `contextmenu` without mouse coordinates, so the panel is
 placed at that element. The panel is kept inside the viewport (8px from the edges). Touch screens have
 no right click, so still offer the same actions through a visible button with `KptMenu`.
 
@@ -42,7 +42,7 @@ no right click, so still offer the same actions through a visible button with `K
 `--kpt-color-surface-raised`, `--kpt-color-border`, `--kpt-elevation-3`, `--kpt-color-danger`.
 
 ## Accessibility
-The panel is `role="menu"` with `role="menuitem"` buttons at `tabindex="-1"` (one Tab stop). Keyboard — see
+The panel is `role="menu"` with `role="menuitem"` buttons at `tabindex="-1"` (one Tab stop). Keyboard - see
 "Keyboard" above.
 
 ## Positioning

package/dist/data-table/data-table-types.d.ts

@@ -22,7 +22,7 @@ export interface KptColumn {
     align?: 'start' | 'center' | 'end';
     /** Szerokość kolumny (np. '10rem', '20%'). Wymagana dla kolumn zamrożonych. */
     width?: string;
-    /** Zamrożenie (sticky) — obsługiwane dla wiodących, sąsiadujących kolumn. */
+    /** Zamrożenie (sticky) - obsługiwane dla wiodących, sąsiadujących kolumn. */
     frozen?: boolean;
     /** Filtr kolumny w wierszu nagłówka. */
     filter?: KptColumnFilter;
@@ -38,7 +38,7 @@ export interface KptCellEditEvent<T> {
     field: string;
     /** Nowa wartość. */
     value: unknown;
-    /** Wiersz po scaleniu ze zmienioną wartością — gotowe body PUT/PATCH. */
+    /** Wiersz po scaleniu ze zmienioną wartością - gotowe body PUT/PATCH. */
     updatedRow: T;
 }
 export type KptSortDir = 'asc' | 'desc' | null;
@@ -49,7 +49,7 @@ export interface KptTableLazyState {
     sortField: string | null;
     sortDir: KptSortDir;
     filter: string;
-    /** Wartości filtrów per kolumna (pole → wartość kontrolki). */
+    /** Wartości filtrów per kolumna (pole -> wartość kontrolki). */
     columnFilters: Record<string, unknown>;
 }
 /** Kontekst własnego edytora komórki (odpowiednik `kptCellEdit` z Angulara). */
@@ -61,7 +61,7 @@ export interface KptCellEditContext<T> {
     /** Porzuca zmianę. */
     cancel: () => void;
 }
-/** Szablony komórek: pole → funkcja renderująca (odpowiednik `kptCell`). */
+/** Szablony komórek: pole -> funkcja renderująca (odpowiednik `kptCell`). */
 export type KptCellRenderers<T> = Record<string, (row: T, value: unknown) => ReactNode>;
-/** Własne edytory komórek: pole → funkcja renderująca (odpowiednik `kptCellEdit`). */
+/** Własne edytory komórek: pole -> funkcja renderująca (odpowiednik `kptCellEdit`). */
 export type KptCellEditRenderers<T> = Record<string, (context: KptCellEditContext<T>) => ReactNode>;