@konce-pt/react 0.12.0 → 0.15.0

package/dist/grid/grid.js

@@ -1,13 +1,13 @@
 import { cn } from "../internal/cn.js";
 import { layoutStyle, renderLayout } from "./layout.js";
 /**
- * Siatka Koncept UI — CSS Grid sterowany custom properties z `@konce-pt/grid`.
+ * Siatka Koncept UI - CSS Grid sterowany custom properties z `@konce-pt/grid`.
  *
  * Odpowiednik dyrektywy `kptGrid` z portu Angulara. Dyrektyw w Reakcie nie ma, więc siatka jest
- * komponentem — ale takim, który w trybie `asChild` niczego nie dokłada do DOM: przejmuje element,
+ * komponentem - ale takim, który w trybie `asChild` niczego nie dokłada do DOM: przejmuje element,
  * który i tak renderujesz (`<section>`, `<ul>`, `<main>`).
  *
- * Zmiana `columns` nie manipuluje klasami — ustawia zmienną inline, a układ przelicza
+ * Zmiana `columns` nie manipuluje klasami - ustawia zmienną inline, a układ przelicza
  * natywny silnik CSS.
  *
  * Wymaga arkusza `@konce-pt/grid` (`import '@konce-pt/grid';`).

package/dist/grid/layout.d.ts

@@ -10,9 +10,9 @@ export type KptLayoutValue = number | string | undefined;
  */
 export declare function layoutStyle(vars: Readonly<Record<string, KptLayoutValue>>, style: CSSProperties | undefined): CSSProperties;
 /**
- * Renderuje element układu albo — w trybie `asChild` — oddaje propsy jedynemu dziecku.
+ * Renderuje element układu albo - w trybie `asChild` - oddaje propsy jedynemu dziecku.
  *
- * To reactowy odpowiednik dyrektywy: `<KptCol asChild><li>…</li></KptCol>` nie dokłada żadnego
+ * To reactowy odpowiednik dyrektywy: `<KptCol asChild><li>...</li></KptCol>` nie dokłada żadnego
  * elementu do DOM, dokładnie jak `<li kptCol="6">` w Angularze.
  */
 export declare function renderLayout(asChild: boolean, children: ReactNode, props: Record<string, unknown>, element: 'div' | 'span'): ReactElement;

package/dist/grid/layout.js

@@ -17,9 +17,9 @@ export function layoutStyle(vars, style) {
     return { ...result, ...style };
 }
 /**
- * Renderuje element układu albo — w trybie `asChild` — oddaje propsy jedynemu dziecku.
+ * Renderuje element układu albo - w trybie `asChild` - oddaje propsy jedynemu dziecku.
  *
- * To reactowy odpowiednik dyrektywy: `<KptCol asChild><li>…</li></KptCol>` nie dokłada żadnego
+ * To reactowy odpowiednik dyrektywy: `<KptCol asChild><li>...</li></KptCol>` nie dokłada żadnego
  * elementu do DOM, dokładnie jak `<li kptCol="6">` w Angularze.
  */
 export function renderLayout(asChild, children, props, element) {

package/dist/grid/llms.txt

@@ -1,7 +1,7 @@
 # KptGrid / KptCol / KptFlex (@konce-pt/react/grid)
 
 React ergonomics over the `@konce-pt/grid` stylesheet. The components set nothing but inline custom
-properties — they neither add nor remove classes, and the layout is computed by the native CSS
+properties - they neither add nor remove classes, and the layout is computed by the native CSS
 engine.
 
 Import: `import { KptGrid, KptCol, KptFlex } from '@konce-pt/react/grid';`
@@ -11,7 +11,7 @@ Requires the stylesheet: `import '@konce-pt/grid';`
 The Angular port ships `kptGrid` / `kptCol` / `kptFlex` as attribute directives, which add nothing
 to the DOM. Here they are components, and `asChild` gives back the missing half: the props land on
 the element you were rendering anyway, so a column can be an `<li>`, an `<article>` or another
-component — no wrapper `<div>` in the middle of a grid.
+component - no wrapper `<div>` in the middle of a grid.
 
 ## Breakpoints (mobile-first)
 `sm` >= 640px, `md` >= 768px, `lg` >= 1024px, `xl` >= 1280px, `2xl` >= 1536px.
@@ -20,22 +20,22 @@ gives 12 on mobile, `sm` and `md`, and 5 only from `lg` up.
 
 ## KptGrid
 Class `kpt-grid`. Renders a `<div>`, or the child with `asChild`.
-- `columns`: number — the column count (12 by default, from CSS). Variants: `columnsSm`,
+- `columns`: number - the column count (12 by default, from CSS). Variants: `columnsSm`,
   `columnsMd`, `columnsLg`, `columnsXl`, `columns2xl`
-- `gap`: string — the gap on both axes, e.g. `'1.5rem'`, `'var(--kpt-space-6)'`
-- `gapX`, `gapY`: string — the gap on one axis, overriding `gap`
-- `container`: boolean — container query mode (see below)
+- `gap`: string - the gap on both axes, e.g. `'1.5rem'`, `'var(--kpt-space-6)'`
+- `gapX`, `gapY`: string - the gap on one axis, overriding `gap`
+- `container`: boolean - container query mode (see below)
 - `className`, `style`, `ref` and every other `<div>` prop pass through; your `style` wins over the
   generated variables
 
 ## KptCol
-No class of its own — only the variables.
-- `span`: number | string — the span, the mobile-first base; `'full'` means the whole width
-- `spanSm`, `spanMd`, `spanLg`, `spanXl`, `span2xl` — per-breakpoint overrides
-- `start`: number — the grid line the column starts at (1-based); this is how offsets are done
-- `order`: number — the visual order. It does not change the DOM: screen readers and keyboard
+No class of its own - only the variables.
+- `span`: number | string - the span, the mobile-first base; `'full'` means the whole width
+- `spanSm`, `spanMd`, `spanLg`, `spanXl`, `span2xl` - per-breakpoint overrides
+- `start`: number - the grid line the column starts at (1-based); this is how offsets are done
+- `order`: number - the visual order. It does not change the DOM: screen readers and keyboard
   navigation follow the DOM, so do not use it to move interactive content around
-- `self`: string — `align-self` (`start`, `end`, `center`, `stretch`, `baseline`)
+- `self`: string - `align-self` (`start`, `end`, `center`, `stretch`, `baseline`)
 
 ## KptFlex
 Class `kpt-flex`. The same variables and breakpoints as the grid, in one dimension.
@@ -51,11 +51,11 @@ Values with no matching prop are supplied with utility classes from `@konce-pt/g
 
 ## An undefined prop sets nothing
 A variable is written only when its prop has a value. Writing `--kpt-col: undefined` would override
-what a utility class or the stylesheet already provides, so the components skip it entirely — the
+what a utility class or the stylesheet already provides, so the components skip it entirely - the
 same rule as the `?? null` in the Angular directives.
 
 ## Container mode (`container`)
-The children's spans react to the width of THIS grid instead of the window — a card in a narrow
+The children's spans react to the width of THIS grid instead of the window - a card in a narrow
 sidebar lays itself out in a single column even though the viewport is wide.
 
 A CSS limitation, not a package one: `@container` queries the nearest ancestor container, so an
@@ -107,4 +107,4 @@ The grid: `--kpt-grid-columns`, `--kpt-gap`, `--kpt-gap-x`, `--kpt-gap-y`, `--kp
 `--kpt-align`, `--kpt-content`, `--kpt-flex-direction`, `--kpt-flex-wrap`.
 The child: `--kpt-col`, `--kpt-col-start`, `--kpt-order`, `--kpt-self`, `--kpt-flex`, `--kpt-grow`,
 `--kpt-shrink`.
-Each one has per-breakpoint variants: `--kpt-col` → `--kpt-col-md`.
+Each one has per-breakpoint variants: `--kpt-col` -> `--kpt-col-md`.

package/dist/grid-entry/public-api.js

@@ -1,5 +1,5 @@
 /*
- * @konce-pt/react/grid — ergonomia Reacta nad arkuszem `@konce-pt/grid`.
+ * @konce-pt/react/grid - ergonomia Reacta nad arkuszem `@konce-pt/grid`.
  * Komponenty ustawiają wyłącznie custom properties inline; układ liczy natywny CSS.
  * Osobny subpath, bo arkusz układu jest opcjonalny i nie każda aplikacja go ładuje.
  */

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

@@ -3,7 +3,7 @@ import { type DeepPartial, type KptLocale, type KptMessageKey, type KptMessages
 export interface KptI18nContextValue {
     /** Bieżący język. */
     locale: KptLocale;
-    /** Zmiana języka w runtime — działa tylko w obrębie `KptI18nProvider`. */
+    /** Zmiana języka w runtime - działa tylko w obrębie `KptI18nProvider`. */
     setLocale: (locale: KptLocale) => void;
     /** Aktywny słownik. */
     messages: KptMessages;
@@ -25,7 +25,7 @@ export interface KptI18nProviderProps {
     children?: ReactNode;
 }
 /**
- * Dostarcza tłumaczenia poddrzewu. Bez providera komponenty działają na EN —
+ * Dostarcza tłumaczenia poddrzewu. Bez providera komponenty działają na EN -
  * brak konfiguracji nigdy nie jest błędem.
  */
 export declare function KptI18nProvider({ locale, messages, children }: Readonly<KptI18nProviderProps>): import("react").JSX.Element;
@@ -40,6 +40,6 @@ export interface KptI18nOverrides {
 }
 /**
  * Tłumaczenia dla pojedynczego komponentu. `locale` i `dictionary` z propsów mają
- * priorytet nad kontekstem — tak samo jak inputy etykiet biją słownik w Angularze.
+ * priorytet nad kontekstem - tak samo jak inputy etykiet biją słownik w Angularze.
  */
 export declare function useKptMessages(overrides?: KptI18nOverrides): KptI18nContextValue;

package/dist/i18n/i18n-context.js

@@ -5,21 +5,21 @@ import { KPT_MESSAGES_EN, KPT_MESSAGES_PL, deepMerge, translate, } from '@konce-
 import { isDevBuild } from "../internal/dev.js";
 /*
  * Wiązanie i18n dla Reacta. Odpowiednik `provideKptI18n` + `KptI18n` z Angulara,
- * na tym samym rdzeniu z `@konce-pt/i18n` — te same klucze, ten sam fallback
- * (słownik → EN → sam klucz) i ta sama interpolacja `{name}`.
+ * na tym samym rdzeniu z `@konce-pt/i18n` - te same klucze, ten sam fallback
+ * (słownik -> EN -> sam klucz) i ta sama interpolacja `{name}`.
  */
 /** Kontrakt zwracany przez `useKptI18n()`. */
-/** Klucze, o których brak już ostrzegaliśmy — jedno ostrzeżenie na klucz. */
+/** Klucze, o których brak już ostrzegaliśmy - jedno ostrzeżenie na klucz. */
 const warnedKeys = new Set();
 /**
- * `translate` z ostrzeżeniem w buildzie deweloperskim, gdy klucza nie ma w żadnym słowniku —
+ * `translate` z ostrzeżeniem w buildzie deweloperskim, gdy klucza nie ma w żadnym słowniku -
  * inaczej literówka daje po cichu sam klucz zamiast tekstu.
  */
 function translateChecked(dict, key, params) {
     const text = translate(dict, key, params);
     if (text === key && isDevBuild() && !warnedKeys.has(key)) {
         warnedKeys.add(key);
-        console.warn(`KptI18n: brak tłumaczenia dla klucza „${key}”.`);
+        console.warn(`KptI18n: brak tłumaczenia dla klucza "${key}".`);
     }
     return text;
 }
@@ -32,7 +32,7 @@ const FALLBACK = {
 };
 const KptI18nContext = createContext(null);
 /**
- * Dostarcza tłumaczenia poddrzewu. Bez providera komponenty działają na EN —
+ * Dostarcza tłumaczenia poddrzewu. Bez providera komponenty działają na EN -
  * brak konfiguracji nigdy nie jest błędem.
  */
 export function KptI18nProvider({ locale = 'en', messages, children }) {
@@ -66,7 +66,7 @@ export function useKptI18n() {
 }
 /**
  * Tłumaczenia dla pojedynczego komponentu. `locale` i `dictionary` z propsów mają
- * priorytet nad kontekstem — tak samo jak inputy etykiet biją słownik w Angularze.
+ * priorytet nad kontekstem - tak samo jak inputy etykiet biją słownik w Angularze.
  */
 export function useKptMessages(overrides) {
     const context = useKptI18n();

package/dist/icon/icon-registry.d.ts

@@ -2,9 +2,9 @@ import { type KptIconInput } from '@konce-pt/icons';
 /**
  * Rejestruje (lub nadpisuje) ikony. Przyjmuje listę definicji z subpathu Tablera
  * (`[Rocket, LayoutDashboard]`), obiekt definicji (np. `import * as tabler`) albo
- * mapę `{ nazwa: 'inner svg' }` — patrz [[KptIconInput]].
+ * mapę `{ nazwa: 'inner svg' }` - patrz [[KptIconInput]].
  *
- * Treść jest sanityzowana do allowlisty geometrii SVG — mimo to `registerKptIcons()` wolno
+ * Treść jest sanityzowana do allowlisty geometrii SVG - mimo to `registerKptIcons()` wolno
  * wołać wyłącznie z treścią kontrolowaną przez developera (build-time), nigdy bezpośrednio
  * z danych runtime/CMS/uploadu bez własnej walidacji domenowej wyżej w stosie.
  */
@@ -13,7 +13,7 @@ export declare function registerKptIcons(next: KptIconInput): void;
 export declare function getKptIcon(name: string): string | undefined;
 /** Czy ikona o tej nazwie jest w rejestrze. */
 export declare function hasKptIcon(name: string): boolean;
-/** Subskrypcja zmian rejestru — używana przez `KptIcon` przez `useSyncExternalStore`. */
+/** Subskrypcja zmian rejestru - używana przez `KptIcon` przez `useSyncExternalStore`. */
 export declare function subscribeKptIcons(listener: () => void): () => void;
 /** Licznik rejestracji; rośnie po każdym `registerKptIcons`. */
 export declare function getKptIconsVersion(): number;

package/dist/icon/icon-registry.js

@@ -10,9 +10,9 @@ let version = 0;
 /**
  * Rejestruje (lub nadpisuje) ikony. Przyjmuje listę definicji z subpathu Tablera
  * (`[Rocket, LayoutDashboard]`), obiekt definicji (np. `import * as tabler`) albo
- * mapę `{ nazwa: 'inner svg' }` — patrz [[KptIconInput]].
+ * mapę `{ nazwa: 'inner svg' }` - patrz [[KptIconInput]].
  *
- * Treść jest sanityzowana do allowlisty geometrii SVG — mimo to `registerKptIcons()` wolno
+ * Treść jest sanityzowana do allowlisty geometrii SVG - mimo to `registerKptIcons()` wolno
  * wołać wyłącznie z treścią kontrolowaną przez developera (build-time), nigdy bezpośrednio
  * z danych runtime/CMS/uploadu bez własnej walidacji domenowej wyżej w stosie.
  */
@@ -32,7 +32,7 @@ export function getKptIcon(name) {
 export function hasKptIcon(name) {
     return icons.has(name);
 }
-/** Subskrypcja zmian rejestru — używana przez `KptIcon` przez `useSyncExternalStore`. */
+/** Subskrypcja zmian rejestru - używana przez `KptIcon` przez `useSyncExternalStore`. */
 export function subscribeKptIcons(listener) {
     listeners.add(listener);
     return () => {

package/dist/icon/icon.d.ts

@@ -4,16 +4,16 @@ export interface KptIconProps extends ComponentPropsWithRef<'span'> {
     name: string;
     /** Rozmiar jako długość CSS (np. '1.25rem'); domyślnie dziedziczy z `font-size`. */
     size?: string;
-    /** Nazwa dla czytnika ekranu — tylko gdy ikona niesie znaczenie bez tekstu obok. */
+    /** Nazwa dla czytnika ekranu - tylko gdy ikona niesie znaczenie bez tekstu obok. */
     label?: string;
 }
 /**
- * Ikona Koncept UI (inline SVG, zestaw Tabler Icons — MIT). Rozmiar dziedziczy z `font-size`
- * (1em) lub ustaw `size`; kolor z `currentColor`. Ikona musi być w rejestrze — wbudowany
+ * Ikona Koncept UI (inline SVG, zestaw Tabler Icons - MIT). Rozmiar dziedziczy z `font-size`
+ * (1em) lub ustaw `size`; kolor z `currentColor`. Ikona musi być w rejestrze - wbudowany
  * zestaw działa od razu, pełny dodaje `registerKptTablerIcons()` z `@konce-pt/react/icons`.
  *
  * Domyślnie ikona jest dekoracją (`aria-hidden`). Ikona niosąca znaczenie sama, bez tekstu obok,
- * dostaje `label` — wtedy jest `role="img"` z tą nazwą. W buildzie deweloperskim nieznana nazwa
+ * dostaje `label` - wtedy jest `role="img"` z tą nazwą. W buildzie deweloperskim nieznana nazwa
  * daje jedno ostrzeżenie w konsoli zamiast cichej pustki.
  *
  * @example

package/dist/icon/icon.js

@@ -5,15 +5,15 @@ import { useEffect, useSyncExternalStore } from 'react';
 import { cn } from "../internal/cn.js";
 import { isDevBuild } from "../internal/dev.js";
 import { getKptIcon, getKptIconsVersion, subscribeKptIcons } from "./icon-registry.js";
-/** Nazwy, o których już ostrzegliśmy — jedno ostrzeżenie na nazwę, nie na każdą instancję. */
+/** Nazwy, o których już ostrzegliśmy - jedno ostrzeżenie na nazwę, nie na każdą instancję. */
 const warned = new Set();
 /**
- * Ikona Koncept UI (inline SVG, zestaw Tabler Icons — MIT). Rozmiar dziedziczy z `font-size`
- * (1em) lub ustaw `size`; kolor z `currentColor`. Ikona musi być w rejestrze — wbudowany
+ * Ikona Koncept UI (inline SVG, zestaw Tabler Icons - MIT). Rozmiar dziedziczy z `font-size`
+ * (1em) lub ustaw `size`; kolor z `currentColor`. Ikona musi być w rejestrze - wbudowany
  * zestaw działa od razu, pełny dodaje `registerKptTablerIcons()` z `@konce-pt/react/icons`.
  *
  * Domyślnie ikona jest dekoracją (`aria-hidden`). Ikona niosąca znaczenie sama, bez tekstu obok,
- * dostaje `label` — wtedy jest `role="img"` z tą nazwą. W buildzie deweloperskim nieznana nazwa
+ * dostaje `label` - wtedy jest `role="img"` z tą nazwą. W buildzie deweloperskim nieznana nazwa
  * daje jedno ostrzeżenie w konsoli zamiast cichej pustki.
  *
  * @example
@@ -24,7 +24,7 @@ export function KptIcon({ name, size = '', label = '', className, style, ...rest
     // Rejestr bywa uzupełniany po pierwszym renderze (leniwy import zestawu Tabler),
     // więc komponent słucha jego wersji zamiast czytać go raz.
     useSyncExternalStore(subscribeKptIcons, getKptIconsVersion, getKptIconsVersion);
-    // Treść pochodzi z zaufanego rejestru i przeszła sanitizację przy rejestracji —
+    // Treść pochodzi z zaufanego rejestru i przeszła sanitizację przy rejestracji -
     // to ten sam kontrakt, co `innerHTML` w porcie Angulara.
     const svg = getKptIcon(name);
     const html = renderKptIconSvg(svg);
@@ -32,7 +32,7 @@ export function KptIcon({ name, size = '', label = '', className, style, ...rest
         if (svg || !isDevBuild() || warned.has(name))
             return;
         warned.add(name);
-        console.warn(`KptIcon: ikony „${name}” nie ma (jeszcze) w rejestrze — sprawdź nazwę albo zarejestruj ją (registerKptIcons / registerKptTablerIcons).`);
+        console.warn(`KptIcon: ikony "${name}" nie ma (jeszcze) w rejestrze - sprawdź nazwę albo zarejestruj ją (registerKptIcons / registerKptTablerIcons).`);
     }, [svg, name]);
     return (_jsx("span", { className: cn('kpt-icon-host', className), "aria-hidden": label ? undefined : true, role: label ? 'img' : undefined, "aria-label": label || undefined, style: size ? { fontSize: size, ...style } : style, 
         // eslint-disable-next-line react/no-danger -- treść z rejestru, zsanityzowana przy `register()` (sanitizeSvgFragment)

package/dist/icon/llms.txt

@@ -1,44 +1,44 @@
 # KptIcon (@konce-pt/react)
 
-An inline SVG icon (Tabler Icons — MIT). The size follows `font-size` (1em) or the `size` prop;
+An inline SVG icon (Tabler Icons - MIT). The size follows `font-size` (1em) or the `size` prop;
 the colour comes from `currentColor`.
 Import: `import { KptIcon } from '@konce-pt/react';`
 
 ## DOM
     <span class="kpt-icon-host" aria-hidden="true">
-      <svg class="kpt-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor">…</svg>
+      <svg class="kpt-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor">...</svg>
     </span>
 
 ## Props
-- `name`: string — the icon name from the registry (required)
-- `size`: string — a CSS length (e.g. '1.25rem'); by default inherited from `font-size`
-- `label`: string — a name for screen readers; with it the icon is `role="img"`, without it `aria-hidden`
+- `name`: string - the icon name from the registry (required)
+- `size`: string - a CSS length (e.g. '1.25rem'); by default inherited from `font-size`
+- `label`: string - a name for screen readers; with it the icon is `role="img"`, without it `aria-hidden`
 - `className`, `ref` and every other `<span>` prop go to the host
 
 ## The registry
 The built-in set (84 icons) works with no setup. It covers both what the library's own components
-draw and the staples of an application shell — sun, moon, bell, settings, users, user-circle,
-logout, layout-dashboard, home, activity, chart-bar, arrow-up-right, brand-github and the like —
+draw and the staples of an application shell - sun, moon, bell, settings, users, user-circle,
+logout, layout-dashboard, home, activity, chart-bar, arrow-up-right, brand-github and the like -
 so a typical admin panel never needs the full set.
 
 The full Tabler set (5130 icons) is opt-in, and there are two paths. `@konce-pt/react/icons`
 exposes every icon as its own export, so importing by name lets the bundler keep only what you
 used:
 
-    // main.tsx — production: two icons reach the bundle.
+    // main.tsx - production: two icons reach the bundle.
     import { LayoutDashboard, Rocket } from '@konce-pt/react/icons';
     import { registerKptIcons } from '@konce-pt/react';
 
     registerKptIcons([LayoutDashboard, Rocket]);
 
-    // main.tsx — prototype: every icon, about 1.2 MB.
+    // main.tsx - prototype: every icon, about 1.2 MB.
     import { registerKptTablerIcons } from '@konce-pt/react/icons';
 
     registerKptTablerIcons();
 
 `registerKptIcons` is the one that shrinks: it takes the data as an argument and imports nothing
 from the Tabler subpath, so the bundle follows your imports. Passing the namespace object
-(`import * as tabler`) registers everything — a namespace handed to a function blocks static
+(`import * as tabler`) registers everything - a namespace handed to a function blocks static
 analysis, so it is the explicit form of the prototype path, not a smaller one.
 
 Export names are PascalCase because `kebab-case` is not a legal identifier and camelCase would
@@ -47,9 +47,9 @@ so `BrandHtml5` registers as `brand-html5`.
 
 The registry is a module singleton, not a context: icons are global to the application, so there is
 nothing to provide. `KptIcon` subscribes to it, so icons registered after the first render appear
-without a manual refresh. Register your own with `registerKptIcons({ name: '<path … />' })`.
+without a manual refresh. Register your own with `registerKptIcons({ name: '<path ... />' })`.
 
-An unknown name renders an empty host rather than throwing — a missing icon never takes the page
+An unknown name renders an empty host rather than throwing - a missing icon never takes the page
 down with it.
 
 ## Security
@@ -63,7 +63,7 @@ CMS, an API or an upload.
     <KptButton><KptIcon name="phone" /> Call</KptButton>
 
 ## Accessibility
-By default an icon is `aria-hidden` — decorative, which is right next to a text label or inside
+By default an icon is `aria-hidden` - decorative, which is right next to a text label or inside
 an icon button with its own name. An icon that carries meaning on its own gets `label`: it becomes
 `role="img"` with that `aria-label`. In development builds an unknown name logs one console
 warning per name instead of rendering silently empty.

package/dist/icon-button/icon-button.d.ts

@@ -7,13 +7,13 @@ export interface KptIconButtonProps extends ComponentPropsWithRef<'button'> {
     shape?: 'round' | 'square';
     /** Spinner zamiast ikony + zablokowana interakcja; ustawia `aria-busy`. */
     loading?: boolean;
-    /** Etykieta dostępności — wymagana, bo przycisk nie ma tekstu. */
+    /** Etykieta dostępności - wymagana, bo przycisk nie ma tekstu. */
     'aria-label': string;
     /** Propsy wrappera hosta (`.kpt-icon-button-host`). */
     hostProps?: KptHostProps<'span'>;
 }
 /**
- * Przycisk ikonowy (tylko ikona). `aria-label` jest wymagany typem — bez tekstu przycisk nie ma
+ * Przycisk ikonowy (tylko ikona). `aria-label` jest wymagany typem - bez tekstu przycisk nie ma
  * dostępnej nazwy, a to najczęstszy błąd dostępności w tej rodzinie komponentów.
  *
  * @example

package/dist/icon-button/icon-button.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { cn } from "../internal/cn.js";
 /**
- * Przycisk ikonowy (tylko ikona). `aria-label` jest wymagany typem — bez tekstu przycisk nie ma
+ * Przycisk ikonowy (tylko ikona). `aria-label` jest wymagany typem - bez tekstu przycisk nie ma
  * dostępnej nazwy, a to najczęstszy błąd dostępności w tej rodzinie komponentów.
  *
  * @example

package/dist/icon-button/llms.txt

@@ -5,18 +5,18 @@ An icon-only button. Import: `import { KptIconButton } from '@konce-pt/react';`
 ## DOM
     <span class="kpt-icon-button-host">
       <button class="kpt-icon-button" type="button" data-variant="text" data-size="md" data-shape="round" aria-label="Settings">
-        …icon…
+        ...icon...
       </button>
     </span>
 
 ## Props
-- `variant`: the same union as `KptButton` — 'filled' | 'tonal' | 'outline' | 'text' | 'danger'
+- `variant`: the same union as `KptButton` - 'filled' | 'tonal' | 'outline' | 'text' | 'danger'
   (default 'text')
 - `size`: 'sm' | 'md' | 'lg' (default 'md')
 - `shape`: 'round' | 'square' (default 'round')
-- `loading`: boolean — a spinner instead of the icon, sets `aria-busy` and disables the button
-- `aria-label`: string — REQUIRED by the type
-- `hostProps` — props for the `.kpt-icon-button-host` wrapper
+- `loading`: boolean - a spinner instead of the icon, sets `aria-busy` and disables the button
+- `aria-label`: string - REQUIRED by the type
+- `hostProps` - props for the `.kpt-icon-button-host` wrapper
 - `className`, `ref` and every other `<button>` prop go to the inner `<button>`
 
 ## The label is required by the type
@@ -29,6 +29,10 @@ without it, so the mistake cannot reach the browser.
     <KptIconButton variant="filled" shape="square" aria-label="Delete"><KptIcon name="x" /></KptIconButton>
     <KptIconButton loading aria-label="Saving" />
 
+## Motion
+Pressed, it squeezes slightly and springs back on release (shared mixin `styles/_press.scss`). The `loading` spinner pops in. Pure CSS; durations follow `--kpt-motion-scale`, so `enabled: false` turns it off, and it drops out
+under "reduce motion".
+
 ## Tokens
 The same button tokens as `KptButton` (`--kpt-button-*` for each variant), plus the size and shape
 geometry from the shared stylesheet.

package/dist/icons-entry/public-api.d.ts

@@ -1,11 +1,11 @@
 export * from '@konce-pt/icons/tabler';
 /**
  * Rejestruje pełny zestaw Tabler Icons (5130), dzięki czemu `KptIcon` może użyć dowolnej
- * ikony po nazwie. Wywołaj raz, w wejściu aplikacji — rejestr jest globalny, więc nie ma
+ * ikony po nazwie. Wywołaj raz, w wejściu aplikacji - rejestr jest globalny, więc nie ma
  * potrzeby owijać drzewa żadnym providerem.
  *
  * Wciąga komplet (~1,2 MB), więc to ścieżka prototypowa. W produkcji zaimportuj ikony
- * po nazwie i podaj je do `registerKptIcons([...])` z rdzenia `@konce-pt/react` — ta funkcja
+ * po nazwie i podaj je do `registerKptIcons([...])` z rdzenia `@konce-pt/react` - ta funkcja
  * nie importuje pełnego zestawu, więc bundler zostawia wyłącznie użyte ikony.
  *
  * @example

package/dist/icons-entry/public-api.js

@@ -1,5 +1,5 @@
 /*
- * @konce-pt/react/icons — pełny zestaw Tabler Icons (MIT) dla `KptIcon`.
+ * @konce-pt/react/icons - pełny zestaw Tabler Icons (MIT) dla `KptIcon`.
  * Opcjonalny (pobierany tylko przy imporcie), by nie powiększać rdzenia biblioteki.
  */
 import { KPT_TABLER_ICONS } from '@konce-pt/icons/tabler';
@@ -9,11 +9,11 @@ import { registerKptIcons } from "../icon/icon-registry.js";
 export * from '@konce-pt/icons/tabler';
 /**
  * Rejestruje pełny zestaw Tabler Icons (5130), dzięki czemu `KptIcon` może użyć dowolnej
- * ikony po nazwie. Wywołaj raz, w wejściu aplikacji — rejestr jest globalny, więc nie ma
+ * ikony po nazwie. Wywołaj raz, w wejściu aplikacji - rejestr jest globalny, więc nie ma
  * potrzeby owijać drzewa żadnym providerem.
  *
  * Wciąga komplet (~1,2 MB), więc to ścieżka prototypowa. W produkcji zaimportuj ikony
- * po nazwie i podaj je do `registerKptIcons([...])` z rdzenia `@konce-pt/react` — ta funkcja
+ * po nazwie i podaj je do `registerKptIcons([...])` z rdzenia `@konce-pt/react` - ta funkcja
  * nie importuje pełnego zestawu, więc bundler zostawia wyłącznie użyte ikony.
  *
  * @example

package/dist/image/image.js

@@ -38,7 +38,7 @@ export function KptImage({ src, alt = '', width = null, preview = false, locale,
     if (!preview) {
         return (_jsx("div", { className: cn('kpt-image-host', className), ...rest, children: _jsx("div", { className: "kpt-image", style: style, children: _jsx("img", { className: "kpt-image__img", src: src, alt: alt }) }) }));
     }
-    // `close` przychodzi z każdej drogi: `×`, `Escape`, tło.
+    // `close` przychodzi z każdej drogi: `x`, `Escape`, tło.
     const onClosed = () => {
         setOpen(false);
         triggerRef.current?.focus();

package/dist/image/llms.txt

@@ -8,26 +8,26 @@ Import: `import { KptImage } from '@konce-pt/react';`
       <!-- with preview: -->
       <button class="kpt-image kpt-image--preview" type="button" aria-haspopup="dialog"
               aria-label="Show full size: Photo" style="width:240px">
-        <img class="kpt-image__img" src="…" alt="">
-        <span class="kpt-image__mask" aria-hidden="true">…zoom-in…</span>
+        <img class="kpt-image__img" src="..." alt="">
+        <span class="kpt-image__mask" aria-hidden="true">...zoom-in...</span>
       </button>
       <dialog class="kpt-image__overlay" aria-label="Photo">
-        <button class="kpt-image__close" type="button" aria-label="Close">…</button>
-        <img class="kpt-image__full" src="…" alt="Photo" loading="lazy">
+        <button class="kpt-image__close" type="button" aria-label="Close">...</button>
+        <img class="kpt-image__full" src="..." alt="Photo" loading="lazy">
       </dialog>
-      <!-- without preview: <div class="kpt-image"><img class="kpt-image__img" …></div> -->
+      <!-- without preview: <div class="kpt-image"><img class="kpt-image__img" ...></div> -->
     </div>
 
 ## Props
 - `src`: string (required); `alt`: string
-- `width`: string | null — a CSS length, e.g. `'240px'`
-- `preview`: boolean — the thumbnail becomes a button opening a modal preview
+- `width`: string | null - a CSS length, e.g. `'240px'`
+- `preview`: boolean - the thumbnail becomes a button opening a modal preview
 - `className`, `ref` and every other `<div>` prop go to the host
 
 ## The overlay closes around the photo, not on it
-The dialog fills the viewport, so a click on the dialog element itself — not on the photo or the
-× — is a click on the backdrop and closes the preview. Clicking the photo (to look closer, to drag
-it) does not dismiss it; Escape and × are the explicit ways out.
+The dialog fills the viewport, so a click on the dialog element itself - not on the photo or the
+x - is a click on the backdrop and closes the preview. Clicking the photo (to look closer, to drag
+it) does not dismiss it; Escape and x are the explicit ways out.
 
 ## The mask is decorative
 The zoom-in overlay is `aria-hidden`: it repeats what the cursor (`zoom-in`) already says and would
@@ -41,13 +41,13 @@ only add noise for a screen reader.
 The thumbnail is named from `image.previewOf` (`{alt}`) or `image.preview`; the close button from `common.close`.
 
 ## Tokens
-The radius `--kpt-radius-md`; the backdrop and the hover mask `--kpt-color-overlay-scrim`; the × button and the magnifier disc `--kpt-color-surface` / `--kpt-color-on-surface` with `--kpt-elevation-2`.
+The radius `--kpt-radius-md`; the backdrop and the hover mask `--kpt-color-overlay-scrim`; the x button and the magnifier disc `--kpt-color-surface` / `--kpt-color-on-surface` with `--kpt-elevation-2`.
 
 ## Accessibility
-With `preview`, the thumbnail is a `<button aria-haspopup="dialog">` named “Show full size: <alt>”
+With `preview`, the thumbnail is a `<button aria-haspopup="dialog">` named "Show full size: <alt>"
 (`image.previewOf`, or `image.preview` without `alt`), so it is reached with Tab and opened with
 Enter or Space; the magnifier shows on hover and on `:focus-visible`. The preview is a native modal
-`<dialog>` opened with `showModal()` and named by `alt`: focus moves to its × button and stays inside,
+`<dialog>` opened with `showModal()` and named by `alt`: focus moves to its x button and stays inside,
 Escape closes it, the page behind is inert, document scrolling is locked while it is open, and focus
 returns to the thumbnail. It sits in the top layer, so no ancestor with `transform` or
 `overflow: hidden` can clip it.

package/dist/input/input.d.ts

@@ -1,4 +1,6 @@
 import { type ComponentPropsWithRef } from 'react';
+import type { KptSpeechMode } from '@konce-pt/speech';
+import { type KptSpeechColor } from '../speech/speech-button.tsx';
 import type { KptHostProps } from '../internal/types.ts';
 export type KptInputType = 'text' | 'email' | 'password' | 'number' | 'search' | 'tel' | 'url' | 'time';
 export interface KptInputProps extends Omit<ComponentPropsWithRef<'input'>, 'type' | 'required'> {
@@ -14,20 +16,31 @@ export interface KptInputProps extends Omit<ComponentPropsWithRef<'input'>, 'typ
     /**
      * Czy pole było dotknięte. Pominięty = stan błędu pokazuje się od razu po `invalid`,
      * bo w Reakcie to zwykle biblioteka formularza decyduje, kiedy błąd jest gotowy.
-     * Podaj go, gdy chcesz bramkę „dopiero po dotknięciu" znaną z portu Angulara.
+     * Podaj go, gdy chcesz bramkę "dopiero po dotknięciu" znaną z portu Angulara.
      */
     touched?: boolean;
-    /** Wygodniejszy odpowiednik `onChange` — dostaje samą wartość. */
+    /** Wygodniejszy odpowiednik `onChange` - dostaje samą wartość. */
     onValueChange?: (value: string) => void;
-    /** Wywoływane na `blur` — moment, w którym pole staje się dotknięte. */
+    /** Wywoływane na `blur` - moment, w którym pole staje się dotknięte. */
     onTouch?: () => void;
     /** Propsy wrappera hosta (`.kpt-input-host`). `className` i `ref` idą na `<input>`. */
     hostProps?: KptHostProps<'span'>;
+    /** Mikrofon na końcu pola (Web Speech API). Bez wsparcia przeglądarki się nie pokazuje. */
+    speech?: boolean;
+    /** Język dyktowania (BCP 47); bez niego z `KptI18nProvider`. */
+    speechLang?: string;
+    /** Kolor "stop" i fali w trakcie nasłuchu; domyślnie kolor motywu. */
+    speechColor?: KptSpeechColor;
+    /**
+     * `insert` (domyślnie, w kursor), `append` albo `replace` - pole czyści się w chwili kliknięcia
+     * mikrofonu, a dyktowanie kończy się po jednej wypowiedzi (wzorzec wyszukiwarki).
+     */
+    speechMode?: KptSpeechMode;
 }
 /**
  * Pole tekstowe Koncept UI. Renderuje natywny `<input>` w hoście `.kpt-input-host`.
  *
- * Działa kontrolowane (`value` + `onValueChange`) i niekontrolowane (`defaultValue`) —
+ * Działa kontrolowane (`value` + `onValueChange`) i niekontrolowane (`defaultValue`) -
  * w drugim trybie wartość należy do DOM, więc natywny `<form>`, `<form action>`, reset
  * formularza i React Hook Form (`register`) działają bez adaptera.
  *
@@ -38,4 +51,4 @@ export interface KptInputProps extends Omit<ComponentPropsWithRef<'input'>, 'typ
  * <KptInput name="email" type="email" defaultValue="" />
  * <KptInput value={email} onValueChange={setEmail} invalid={!ok} touched={blurred} />
  */
-export declare function KptInput({ type, required, invalid, touched, onValueChange, onTouch, hostProps, className, id, onChange, onBlur, 'aria-invalid': ariaInvalid, 'aria-describedby': ariaDescribedBy, ...rest }: Readonly<KptInputProps>): import("react").JSX.Element;
+export declare function KptInput({ type, required, invalid, touched, onValueChange, onTouch, hostProps, className, id, onChange, onBlur, ref, speech, speechLang, speechColor, speechMode, 'aria-invalid': ariaInvalid, 'aria-describedby': ariaDescribedBy, ...rest }: Readonly<KptInputProps>): import("react").JSX.Element;