@konce-pt/react 0.11.2 → 0.14.0

package/dist/progress/progress.js

@@ -1,18 +1,19 @@
+'use client';
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { cn } from "../internal/cn.js";
 import { useKptMessages } from "../i18n/i18n-context.js";
-/** Promień okręgu w viewBox 0 0 40 40 — obwód liczymy z niego, nie ze średnicy w pikselach. */
+/** Promień okręgu w viewBox 0 0 40 40 - obwód liczymy z niego, nie ze średnicy w pikselach. */
 const RADIUS = 16;
 const CIRCUMFERENCE = 2 * Math.PI * RADIUS;
 /**
- * Wskaźnik postępu — liniowy lub kołowy, określony (`min`–`max`) albo nieokreślony (`value` = null).
+ * Wskaźnik postępu - liniowy lub kołowy, określony (`min`-`max`) albo nieokreślony (`value` = null).
  *
  * Etykietę wartości włącza `showValue`; `children` zastępuje sformatowaną wartość,
  * więc w środku koła można pokazać cokolwiek.
  *
  * @example
  * <KptProgress value={60} />
- * <KptProgress value={80} label="Ładowanie…" showValue />
+ * <KptProgress value={80} label="Ładowanie..." showValue />
  * <KptProgress value={152} max={160} showValue valueFormat="fraction" labelPosition="bottom" />
  * <KptProgress value={38} bufferValue={62} />
  * <KptProgress type="circular" value={75} variant="success" showValue />
@@ -21,7 +22,7 @@ const CIRCUMFERENCE = 2 * Math.PI * RADIUS;
 export function KptProgress({ value = null, min = 0, max = 100, variant = 'primary', type = 'linear', size = 'md', diameter = 40, bufferValue = null, showValue = false, valueFormat = 'percent', label, labelPosition = 'top', locale, dictionary, className, children, ...rest }) {
     const { t } = useKptMessages({ locale, dictionary });
     const indeterminate = value == null;
-    /** Ułamek 0–1. Odporny na `max` ≤ `min` i na wartości spoza zakresu. */
+    /** Ułamek 0-1. Odporny na `max` <= `min` i na wartości spoza zakresu. */
     const toRatio = (v) => {
         if (v == null)
             return 0;
@@ -32,7 +33,7 @@ export function KptProgress({ value = null, min = 0, max = 100, variant = 'prima
     };
     const ratio = toRatio(value);
     const percent = Math.round(ratio * 100);
-    // Bufor nigdy nie cofa się za pasek główny — inaczej wyglądałby jak błąd renderowania.
+    // Bufor nigdy nie cofa się za pasek główny - inaczej wyglądałby jak błąd renderowania.
     const bufferRatio = Math.max(ratio, toRatio(bufferValue));
     const offset = CIRCUMFERENCE * (1 - ratio);
     const fractionText = () => t('progress.fraction', { value: value ?? 0, max });
@@ -41,7 +42,7 @@ export function KptProgress({ value = null, min = 0, max = 100, variant = 'prima
         valueText = valueFormat === 'fraction' ? fractionText() : t('progress.percent', { value: percent });
     }
     /**
-     * Czytnik ekranu domyślnie odczytuje `aria-valuenow` jako procent, więc przy formacie „ile z ilu"
+     * Czytnik ekranu domyślnie odczytuje `aria-valuenow` jako procent, więc przy formacie "ile z ilu"
      * podajemy mu ten sam napis, który widzi użytkownik.
      */
     const ariaValueText = indeterminate || valueFormat !== 'fraction' ? undefined : fractionText();

package/dist/public-api.d.ts

@@ -13,7 +13,7 @@ export type { KptPanelProps } from './panel/panel.tsx';
 export { KptStepper, KptStep, useKptStepper } from './stepper/stepper.tsx';
 export type { KptStepProps, KptStepperContextValue, KptStepperProps } from './stepper/stepper.tsx';
 export { KptFieldset } from './fieldset/fieldset.tsx';
-export type { KptFieldsetProps } from './fieldset/fieldset.tsx';
+export type { KptFieldsetProps, KptFieldsetVariant } from './fieldset/fieldset.tsx';
 export { KptTimeline } from './timeline/timeline.tsx';
 export type { KptTimelineItem, KptTimelineProps } from './timeline/timeline.tsx';
 export { KptAlert } from './alert/alert.tsx';
@@ -26,6 +26,10 @@ export { KptProgress } from './progress/progress.tsx';
 export type { KptProgressProps, KptProgressVariant, KptProgressType, KptProgressSize, KptProgressValueFormat, KptProgressLabelPosition, } from './progress/progress.tsx';
 export { KptSpinner } from './spinner/spinner.tsx';
 export type { KptSpinnerProps } from './spinner/spinner.tsx';
+export { KptLoader } from './loader/loader.tsx';
+export type { KptLoaderProps, KptLoaderColor, KptLoaderResult, KptLoaderStatus, KptLoaderVariant } from './loader/loader.tsx';
+export { KptUpdate } from './update/update.tsx';
+export type { KptUpdateProps, KptUpdateAction, KptUpdateStatus } from './update/update.tsx';
 export { KptSkeleton } from './skeleton/skeleton.tsx';
 export type { KptSkeletonProps, KptSkeletonVariant } from './skeleton/skeleton.tsx';
 export { KptIcon } from './icon/icon.tsx';
@@ -89,8 +93,8 @@ export { kptConfirm, useKptConfirmRequest } from './confirm/confirm-store.ts';
 export type { KptConfirmOptions, KptConfirmRequest } from './confirm/confirm-store.ts';
 export { KptToastContainer } from './toast/toast-container.tsx';
 export type { KptToastContainerProps } from './toast/toast-container.tsx';
-export { kptToast, useKptToasts } from './toast/toast-store.ts';
-export type { KptToast, KptToastAction, KptToastOptions } from './toast/toast-store.ts';
+export { kptToast, useKptToasts, useKptToastsPaused, resolveKptToast, KPT_TOAST_FALLBACK_DURATION } from './toast/toast-store.ts';
+export type { KptToast, KptToastAction, KptToastAppearance, KptToastConfig, KptToastOptions, KptToastPosition, } from './toast/toast-store.ts';
 export { KptMenu } from './menu/menu.tsx';
 export { KptMenubar } from './menubar/menubar.tsx';
 export type { KptMenubarProps } from './menubar/menubar.tsx';
@@ -120,7 +124,7 @@ export { KptButtonGroup } from './button-group/button-group.tsx';
 export type { KptButtonGroupProps } from './button-group/button-group.tsx';
 export { KptSelect } from './select/select.tsx';
 export type { KptSelectProps } from './select/select.tsx';
-export type { KptAlertVariant, KptOption } from './shared/types.ts';
+export type { KptAlertVariant, KptNavigateEvent, KptOption } from './shared/types.ts';
 export { KptFormField } from './form-field/form-field.tsx';
 export type { KptFormFieldLabelType, KptFormFieldProps } from './form-field/form-field.tsx';
 export { useKptFieldA11y, useKptFormFieldContext, useKptFormFieldFilled } from './form-field/form-field-context.ts';
@@ -172,6 +176,14 @@ export type { KptPaginatorProps } from './paginator/paginator.tsx';
 export { KptButton } from './button/button.tsx';
 export { KptIconButton } from './icon-button/icon-button.tsx';
 export type { KptIconButtonProps } from './icon-button/icon-button.tsx';
+export { KptSpeechButton } from './speech/speech-button.tsx';
+export type { KptSpeechButtonProps, KptSpeechColor, KptSpeechUnsupported } from './speech/speech-button.tsx';
+export { KptSpeechWave } from './speech/speech-wave.tsx';
+export type { KptSpeechWaveProps } from './speech/speech-wave.tsx';
+export { useKptSpeechRecognition } from './speech/use-speech-recognition.ts';
+export type { KptSpeechRecognition, KptSpeechRecognitionOptions, KptSpeechTargetRef, } from './speech/use-speech-recognition.ts';
+export type { KptSpeechEndReason, KptSpeechErrorCode, KptSpeechInterimDisplay, KptSpeechMode, KptSpeechSnapshot, KptSpeechStatus, KptSpeechSupport, KptSpeechTarget, KptSpeechTargetInput, KptSpeechWaveMode, } from '@konce-pt/speech';
+export { defaultSpeechLang, resolveSpeechTarget, speechSupport } from '@konce-pt/speech';
 export { KptFab } from './fab/fab.tsx';
 export type { KptFabProps } from './fab/fab.tsx';
 export { KptSplitButton } from './split-button/split-button.tsx';

package/dist/public-api.js

@@ -1,27 +1,29 @@
 /*
- * @konce-pt/react — publiczne API.
+ * @konce-pt/react - publiczne API.
  *
  * Komponenty renderują te same klasy `kpt-*` i te same tokeny `--kpt-*`, co port
  * Angulara; warstwa CSS (`@konce-pt/styles`, `@konce-pt/grid`, `@konce-pt/tokens`)
  * jest wspólna i nie ma tu własnych stylów.
  */
-// Komponenty — układ
+// Komponenty - układ
 export { KptAppShell, KptNavLabel, KptNavSection, useKptAppShell, useKptShellNavToggle } from "./app-shell/app-shell.js";
 export { KptToolbar, KptToolbarSpacer } from "./toolbar/toolbar.js";
 export { KptSidenav, KptSidenavFooter } from "./sidenav/sidenav.js";
-// Komponenty — panele
+// Komponenty - panele
 export { KptTabs, KptTab } from "./tabs/tabs.js";
 export { KptAccordion, KptAccordionPanel } from "./accordion/accordion.js";
 export { KptPanel, KptPanelActions } from "./panel/panel.js";
 export { KptStepper, KptStep, useKptStepper } from "./stepper/stepper.js";
 export { KptFieldset } from "./fieldset/fieldset.js";
 export { KptTimeline } from "./timeline/timeline.js";
-// Komponenty — prezentacja
+// Komponenty - prezentacja
 export { KptAlert } from "./alert/alert.js";
 export { KptDivider } from "./divider/divider.js";
 export { KptEmpty } from "./empty/empty.js";
 export { KptProgress } from "./progress/progress.js";
 export { KptSpinner } from "./spinner/spinner.js";
+export { KptLoader } from "./loader/loader.js";
+export { KptUpdate } from "./update/update.js";
 export { KptSkeleton } from "./skeleton/skeleton.js";
 export { KptIcon } from "./icon/icon.js";
 export { getKptIcon, hasKptIcon, registerKptIcons } from "./icon/icon-registry.js";
@@ -30,7 +32,7 @@ export { KptBadge } from "./badge/badge.js";
 export { KptBackdrop } from "./backdrop/backdrop.js";
 export { KPT_SIGNAL_GRID_CELL, KPT_SIGNAL_GRID_DENSITY, KPT_SIGNAL_GRID_FALLOFF, KPT_SIGNAL_GRID_GAP, KPT_WAVE_AMPLITUDE, KPT_WAVE_BAND, KPT_WAVE_RESOLUTION, KPT_WAVE_ROTATION, buildSignalGrid, createBackdropRenderer, mixOklch, readCssColor, resolveWave, shiftHue, signalGridAlpha, signalGridDensity, waveIntensity, waveRamp, } from '@konce-pt/backdrop';
 export { KptChip } from "./chip/chip.js";
-// Komponenty — nakładki
+// Komponenty - nakładki
 export { KptDialog, KptDialogFooter } from "./dialog/dialog.js";
 export { KptDrawer } from "./drawer/drawer.js";
 export { KptBottomSheet } from "./bottom-sheet/bottom-sheet.js";
@@ -54,7 +56,7 @@ export { KPT_AUTH_MIN_PASSWORD } from "./auth/auth-types.js";
 export { KptConfirmContainer } from "./confirm/confirm-container.js";
 export { kptConfirm, useKptConfirmRequest } from "./confirm/confirm-store.js";
 export { KptToastContainer } from "./toast/toast-container.js";
-export { kptToast, useKptToasts } from "./toast/toast-store.js";
+export { kptToast, useKptToasts, useKptToastsPaused, resolveKptToast, KPT_TOAST_FALLBACK_DURATION } from "./toast/toast-store.js";
 export { KptMenu } from "./menu/menu.js";
 export { KptMenubar } from "./menubar/menubar.js";
 export { KptMegamenu } from "./megamenu/megamenu.js";
@@ -67,7 +69,7 @@ export { KptMention } from "./mention/mention.js";
 export { KptMentions } from "./mention/mentions.js";
 export { KPT_MENTION_LIMIT, applyMention, collectMentions, filterMentions, foldMentionText, mentionQuery, mentionToken, parseMentionText, } from '@konce-pt/mention';
 export { KptOverlay } from "./internal/overlay.js";
-// Komponenty — formularze
+// Komponenty - formularze
 export { KptButtonGroup } from "./button-group/button-group.js";
 export { KptSelect } from "./select/select.js";
 export { KptFormField } from "./form-field/form-field.js";
@@ -97,6 +99,10 @@ export { KptPaginator } from "./paginator/paginator.js";
 // Komponenty
 export { KptButton } from "./button/button.js";
 export { KptIconButton } from "./icon-button/icon-button.js";
+export { KptSpeechButton } from "./speech/speech-button.js";
+export { KptSpeechWave } from "./speech/speech-wave.js";
+export { useKptSpeechRecognition } from "./speech/use-speech-recognition.js";
+export { defaultSpeechLang, resolveSpeechTarget, speechSupport } from '@konce-pt/speech';
 export { KptFab } from "./fab/fab.js";
 export { KptSplitButton } from "./split-button/split-button.js";
 export { KptCard, KptCardActions, KptCardFooter, KptCardHeader, KptCardLead, KptCardMedia, KptCardMeta, KptCardSection, KptCardSubtitle, KptCardTags, KptCardTitle, } from "./card/card.js";

package/dist/radio-group/llms.txt

@@ -15,14 +15,15 @@ Import: `import { KptRadioGroup } from '@konce-pt/react';`
     </div>
 
 ## Props
-- `options`: `KptOption<T>[]` — `{ label, value, disabled? }`
-- `value` / `defaultValue` / `onValueChange` — controlled or uncontrolled
-- `name`: string — the form group name; omitted means one is generated
+- `options`: `KptOption<T>[]` - `{ label, value, disabled? }`
+- `value` / `defaultValue` / `onValueChange` - controlled or uncontrolled
+- `name`: string - the form group name; omitted means one is generated
 - `disabled`, `invalid`, `touched`, `onTouch()`
+- `toggleMotion`: 'spring' | 'fade' | 'none' (default from `KptMotionProvider`, else `spring`) - see "Toggle motion"
 - `className`, `ref` and every other `<div>` prop go to the host
 
 ## The shared name does the work
-All inputs share one `name`, and that — not any code in the component — is what makes the browser
+All inputs share one `name`, and that - not any code in the component - is what makes the browser
 treat them as one group: arrow keys move between them, only one can be checked, and a native form
 submits a single value. The generated name is unique per instance, so two groups on one page never
 interfere.
@@ -32,16 +33,22 @@ interfere.
     <KptRadioGroup name="plan" options={plans} defaultValue="pro" />
 
 ## Screen reader and keyboard
-`orientation`: 'vertical' (default) | 'horizontal' — options in a column or in a wrapping row; also
+`orientation`: 'vertical' (default) | 'horizontal' - options in a column or in a wrapping row; also
 sets `aria-orientation`.
 
 ## Label and description
 `id` goes to the focusable element, not the host; without one it comes from `KptFormField` or is
 generated. A `div` with a role is not named by `label[for]`, so inside `KptFormField` it gets
 `aria-labelledby` pointing at the wrapper's label (unless `ariaLabel` is set), and the hint or error
-is added to `aria-describedby`. New: `id`, `ariaLabel` and `required` (→ `aria-required`) on the
+is added to `aria-describedby`. New: `id`, `ariaLabel` and `required` (-> `aria-required`) on the
 `radiogroup`.
 
+## Toggle motion
+`toggleMotion`: `spring` - the dot pops in on a spring and the circle bounces; `fade` - a calm colour and mark transition; `none` - no
+motion. The bounce is started by the change handler, so a control that is checked on load does not
+move. With no value it takes `toggle` from `KptMotionProvider` (default `spring`); `enabled: false` and the
+system "reduce motion" setting always win.
+
 ## Tokens
 `--kpt-color-primary` (the checked dot), `--kpt-form-field-border`,
 `--kpt-form-field-border-error`.
@@ -49,3 +56,6 @@ is added to `aria-describedby`. New: `id`, `ariaLabel` and `required` (→ `aria
 ## Accessibility
 The container is `role="radiogroup"` with `aria-invalid` when the error shows; every option is a
 native radio inside a `<label>`, so the label text is clickable and is the accessible name.
+
+## Read-only and required
+`readOnly` blocks the click and the arrow keys (natively they move the selection); the group gets `aria-readonly`.

package/dist/radio-group/radio-group.d.ts

@@ -1,13 +1,20 @@
 import type { ComponentPropsWithRef } from 'react';
 import type { KptOption } from '../shared/types.ts';
+import { type KptToggleMotion } from '@konce-pt/motion';
 export interface KptRadioGroupProps<T> extends Omit<ComponentPropsWithRef<'div'>, 'onChange' | 'defaultValue'> {
+    /**
+     * Ruch przełączania: `spring` - kropka wskakuje na sprężynie, a pole odbija; `fade` - spokojne przejście koloru i znaku; `none` - bez ruchu.
+     * Bez wartości bierze `toggle` z `KptMotionProvider` (domyślnie `spring`); `enabled={false}` i systemowe
+     * "ogranicz ruch" wyłączają go zawsze.
+     */
+    toggleMotion?: KptToggleMotion;
     options?: readonly KptOption<T>[];
     value?: T;
     defaultValue?: T;
     onValueChange?: (value: T) => void;
     /** Nazwa grupy w formularzu; pominięta = generowana. */
     name?: string;
-    /** 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;
@@ -16,6 +23,8 @@ export interface KptRadioGroupProps<T> extends Omit<ComponentPropsWithRef<'div'>
     /** Układ opcji: pod sobą (domyślnie) albo w rzędzie, z zawijaniem. */
     orientation?: 'vertical' | 'horizontal';
     disabled?: boolean;
+    /** Tylko do odczytu - wybór widać, nie da się go zmienić (`aria-readonly`). */
+    readOnly?: boolean;
     invalid?: boolean;
     touched?: boolean;
     onTouch?: () => void;
@@ -23,10 +32,10 @@ export interface KptRadioGroupProps<T> extends Omit<ComponentPropsWithRef<'div'>
 /**
  * Grupa przycisków opcji (radio). Opcje przez `options`.
  *
- * Wszystkie pola dzielą jedną nazwę `name` — to ona, a nie kod komponentu, sprawia, że
+ * Wszystkie pola dzielą jedną nazwę `name` - to ona, a nie kod komponentu, sprawia, że
  * przeglądarka traktuje je jako jedną grupę i pozwala chodzić po niej strzałkami.
  *
  * @example
  * <KptRadioGroup options={plans} value={plan} onValueChange={setPlan} />
  */
-export declare function KptRadioGroup<T>({ options, value, defaultValue, onValueChange, name, id, ariaLabel, required, orientation, disabled, invalid, touched, onTouch, className, ...rest }: Readonly<KptRadioGroupProps<T>>): import("react").JSX.Element;
+export declare function KptRadioGroup<T>({ options, value, defaultValue, onValueChange, name, id, ariaLabel, required, orientation, disabled, readOnly, invalid, touched, onTouch, toggleMotion, className, ...rest }: Readonly<KptRadioGroupProps<T>>): import("react").JSX.Element;

package/dist/radio-group/radio-group.js

@@ -1,19 +1,24 @@
+'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "../internal/cn.js";
+import { optionKey } from "../internal/option-key.js";
 import { useControllableState } from "../internal/use-controllable-state.js";
 import { useKptId } from "../internal/use-id.js";
 import { useKptFieldA11y } from "../form-field/form-field-context.js";
+import { playPopMotion, resolveToggleMotion } from '@konce-pt/motion';
+import { useKptMotion } from "../motion/motion-context.js";
 /**
  * Grupa przycisków opcji (radio). Opcje przez `options`.
  *
- * Wszystkie pola dzielą jedną nazwę `name` — to ona, a nie kod komponentu, sprawia, że
+ * Wszystkie pola dzielą jedną nazwę `name` - to ona, a nie kod komponentu, sprawia, że
  * przeglądarka traktuje je jako jedną grupę i pozwala chodzić po niej strzałkami.
  *
  * @example
  * <KptRadioGroup options={plans} value={plan} onValueChange={setPlan} />
  */
-export function KptRadioGroup({ options = [], value, defaultValue, onValueChange, name, id, ariaLabel = null, required = false, orientation = 'vertical', disabled = false, invalid = false, touched, onTouch, className, ...rest }) {
-    /** Grupa nie dostaje nazwy z `label[for]` — stąd `aria-labelledby` na etykietę wrappera. */
+export function KptRadioGroup({ options = [], value, defaultValue, onValueChange, name, id, ariaLabel = null, required = false, orientation = 'vertical', disabled = false, readOnly = false, invalid = false, touched, onTouch, toggleMotion, className, ...rest }) {
+    const motion = resolveToggleMotion(toggleMotion, useKptMotion());
+    /** Grupa nie dostaje nazwy z `label[for]` - stąd `aria-labelledby` na etykietę wrappera. */
     const field = useKptFieldA11y(id, 'kpt-radio-group');
     const groupName = useKptId(name, 'kpt-radio');
     const [current, setCurrent] = useControllableState({
@@ -22,5 +27,19 @@ export function KptRadioGroup({ options = [], value, defaultValue, onValueChange
         onChange: onValueChange,
     });
     const showInvalid = invalid && (touched ?? true);
-    return (_jsx("div", { className: cn('kpt-radio-group-host', className), ...rest, children: _jsx("div", { className: cn('kpt-radio-group', orientation === 'horizontal' && 'kpt-radio-group--horizontal'), role: "radiogroup", "aria-orientation": orientation, "aria-invalid": showInvalid || undefined, id: field.id, "aria-label": ariaLabel ?? undefined, "aria-labelledby": ariaLabel ? undefined : field.labelledBy, "aria-describedby": field.describedBy, "aria-required": required || undefined, children: options.map((option) => (_jsxs("label", { className: cn('kpt-radio', (disabled || option.disabled) && 'kpt-radio--disabled'), children: [_jsx("input", { type: "radio", className: "kpt-radio__input", name: groupName, checked: option.value === current, disabled: disabled || option.disabled, onChange: () => setCurrent(option.value), onBlur: () => onTouch?.() }), _jsx("span", { className: "kpt-radio__dot", "aria-hidden": "true" }), _jsx("span", { className: "kpt-radio__label", children: option.label })] }, String(option.value)))) }) }));
+    return (_jsx("div", { className: cn('kpt-radio-group-host', className), ...rest, children: _jsx("div", { className: cn('kpt-radio-group', orientation === 'horizontal' && 'kpt-radio-group--horizontal'), "data-motion": motion, role: "radiogroup", "aria-orientation": orientation, "aria-invalid": showInvalid || undefined, id: field.id, "aria-label": ariaLabel ?? undefined, "aria-labelledby": ariaLabel ? undefined : field.labelledBy, "aria-describedby": field.describedBy, "aria-required": required || undefined, "aria-readonly": readOnly || undefined, 
+            // Tylko do odczytu: strzałki natywnie przestawiałyby zaznaczenie.
+            onKeyDown: (event) => {
+                if (readOnly && ['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', ' '].includes(event.key))
+                    event.preventDefault();
+            }, children: options.map((option, index) => (_jsxs("label", { className: cn('kpt-radio', (disabled || option.disabled) && 'kpt-radio--disabled'), children: [_jsx("input", { type: "radio", className: "kpt-radio__input", name: groupName, checked: option.value === current, disabled: disabled || option.disabled, onChange: (event) => {
+                            // Pole kontrolowane: bez zmiany stanu React przywraca poprzednie zaznaczenie.
+                            if (readOnly)
+                                return;
+                            setCurrent(option.value);
+                            // Wskoczenie po zmianie z ręki - z handlera, nie z CSS, bo reguła na `:checked` grałaby przy starcie.
+                            const dot = event.currentTarget.nextElementSibling;
+                            if (motion === 'spring' && dot instanceof HTMLElement)
+                                playPopMotion(dot);
+                        }, onBlur: () => onTouch?.() }), _jsx("span", { className: "kpt-radio__dot", "aria-hidden": "true" }), _jsx("span", { className: "kpt-radio__label", children: option.label })] }, optionKey(option.value, index)))) }) }));
 }

package/dist/rating/llms.txt

@@ -5,32 +5,32 @@ Import: `import { KptRating } from '@konce-pt/react';`
 
 ## DOM
     <div class="kpt-rating-host">
-      <div class="kpt-rating" role="radiogroup" aria-label="…">
-        <button class="kpt-rating__star is-filled" role="radio" aria-checked="false" tabindex="-1" aria-label="1 of 5">…</button>
-        …count buttons…
+      <div class="kpt-rating" role="radiogroup" aria-label="...">
+        <button class="kpt-rating__star is-filled" role="radio" aria-checked="false" tabindex="-1" aria-label="1 of 5">...</button>
+        ...count buttons...
       </div>
     </div>
 
 ## Props
-- `value` / `defaultValue` / `onValueChange` — the score as a number, `0` means unrated
+- `value` / `defaultValue` / `onValueChange` - the score as a number, `0` means unrated
 - `count`: number (default 5)
-- `allowHalf`: boolean — half stars, the value goes in steps of 0.5
-- `readOnly`: boolean — display only, no clicking and no hover preview
+- `allowHalf`: boolean - half stars, the value goes in steps of 0.5
+- `readOnly`: boolean - display only, no clicking and no hover preview
 - `disabled`: boolean
-- `onTouch()` — when focus leaves the group
+- `onTouch()` - when focus leaves the group
 - `id`, `ariaLabel`, `required`, `invalid`, `touched`
 - `className`, `ref` and every other `<div>` prop go to the host
 
 ## Clicking a lit star clears the score
 Picking the star that already holds the value writes `0`, so a rating can be taken back without a
-separate "clear" button — the same contract as the Angular port.
+separate "clear" button - the same contract as the Angular port.
 
 ## Hover beats the value, but only while the pointer is there
 The lit count comes from `hover || value`, so the row previews the score under the cursor and
 falls back to the real value on `mouseleave`. `readOnly` and `disabled` freeze both.
 
 ## i18n
-Each star is labelled from `rating.star` (`{value}`, `{max}`) — EN `1 of 5`, PL `1 z 5`. Override
+Each star is labelled from `rating.star` (`{value}`, `{max}`) - EN `1 of 5`, PL `1 z 5`. Override
 per instance with the `locale` / `dictionary` props.
 
 ## Examples
@@ -38,19 +38,26 @@ per instance with the `locale` / `dictionary` props.
     <KptRating value={4} readOnly />
 
 ## Half stars
-`allowHalf` splits every star into two halves, each its own `role="radio"` ("3.5 of 5" — the number
+`allowHalf` splits every star into two halves, each its own `role="radio"` ("3.5 of 5" - the number
 follows the page language, PL "3,5 z 5"), so the group keeps the radio pattern: clicking the left half
-gives x.5, and the arrows step by 0.5. Read-only stars show the value rounded to a half (4.3 → four
+gives x.5, and the arrows step by 0.5. Read-only stars show the value rounded to a half (4.3 -> four
 and a half stars) while the name carries the exact score ("4.3 of 5"), so an average can be shown
 as it is.
 
+## Pointer
+Dragging across the stars (mouse or touch) picks a score: the preview follows the pointer and releasing
+commits it - with `allowHalf` to the nearest half, in RTL mirrored; dragging past the first star clears
+the score. A short press without movement stays a click (including a second click that clears the
+score). Stars that light up pop in one after another - the motion follows `toggle` from `KptMotionProvider`
+(`spring` only); `enabled: false` and the system "reduce motion" setting always win.
+
 ## Tokens
 Lit stars `--kpt-color-warning`, empty ones `--kpt-color-border-strong`.
 
 ## Accessibility
 `role="radiogroup"` named by `ariaLabel` or the `KptFormField` label; each star is
-`role="radio"` with `aria-checked`, labelled from `rating.star` (`{value}`, `{max}`) — EN `1 of 5`,
-PL `1 z 5`. One Tab stop: `→`/`↑` raise the score by one, `←`/`↓` lower it (mirrored in RTL),
+`role="radio"` with `aria-checked`, labelled from `rating.star` (`{value}`, `{max}`) - EN `1 of 5`,
+PL `1 z 5`. One Tab stop: `ArrowRight`/`ArrowUp` raise the score by one, `ArrowLeft`/`ArrowDown` lower it (mirrored in RTL),
 `Home`/`End` set the extremes, `Delete`/`Backspace` clear it; clicking the chosen star also clears it.
 `readOnly` renders `role="img"` named "4 of 5" with no buttons, so a screen reader does not announce
 a row of disabled controls. `touch` fires when focus leaves the group.

package/dist/rating/rating-pointer.d.ts

@@ -0,0 +1,16 @@
+interface StarRect {
+    left: number;
+    right: number;
+    width: number;
+}
+/**
+ * Ocena pod wskaźnikiem - z prostokątów gwiazdek w kolejności DOM. Lewa połowa gwiazdki to połówka
+ * oceny (z `allowHalf`), w RTL prawa. Przed pierwszą gwiazdką - 0 (przeciągnięcie wstecz kasuje
+ * ocenę), za ostatnią - maksimum. Przerwa między gwiazdkami należy do gwiazdki przed nią.
+ * Ta sama funkcja jest w porcie Angulara (`rating/rating-pointer.ts`).
+ */
+export declare function ratingValueAt(x: number, stars: readonly StarRect[], options: {
+    allowHalf: boolean;
+    rtl: boolean;
+}): number;
+export {};

package/dist/rating/rating-pointer.js

@@ -0,0 +1,26 @@
+/**
+ * Ocena pod wskaźnikiem - z prostokątów gwiazdek w kolejności DOM. Lewa połowa gwiazdki to połówka
+ * oceny (z `allowHalf`), w RTL prawa. Przed pierwszą gwiazdką - 0 (przeciągnięcie wstecz kasuje
+ * ocenę), za ostatnią - maksimum. Przerwa między gwiazdkami należy do gwiazdki przed nią.
+ * Ta sama funkcja jest w porcie Angulara (`rating/rating-pointer.ts`).
+ */
+export function ratingValueAt(x, stars, options) {
+    if (!stars.length)
+        return 0;
+    // W RTL lustrzane odbicie osi - wtedy liczy się tak samo jak w LTR.
+    const flip = (r) => (options.rtl ? { left: -r.right, right: -r.left, width: r.width } : r);
+    const px = options.rtl ? -x : x;
+    const rects = stars.map(flip);
+    if (px < rects[0].left)
+        return 0;
+    for (let i = 0; i < rects.length; i++) {
+        const r = rects[i];
+        const end = i + 1 < rects.length ? rects[i + 1].left : r.right;
+        if (px >= end)
+            continue;
+        if (!options.allowHalf)
+            return i + 1;
+        return (px - r.left) / r.width < 0.5 ? i + 0.5 : i + 1;
+    }
+    return rects.length;
+}

package/dist/rating/rating.d.ts

@@ -8,9 +8,9 @@ export interface KptRatingProps extends Omit<ComponentPropsWithRef<'div'>, 'onCh
     count?: number;
     /** Połówki gwiazdek: wartość co 0,5, każda połówka to osobne `radio`. */
     allowHalf?: boolean;
-    /** Ocena tylko do odczytu — bez klikania i bez podglądu pod kursorem. */
+    /** Ocena tylko do odczytu - bez klikania i bez podglądu pod kursorem. */
     readOnly?: boolean;
-    /** Id grupy (nie hosta); bez niego generowane, w `KptFormField` — z wrappera. */
+    /** Id grupy (nie hosta); bez niego generowane, w `KptFormField` - z wrappera. */
     id?: string;
     /** Nazwa dostępna grupy, gdy nie opisuje jej etykieta (`KptFormField`). */
     ariaLabel?: string | null;
@@ -23,13 +23,13 @@ export interface KptRatingProps extends Omit<ComponentPropsWithRef<'div'>, 'onCh
 }
 /**
  * Ocena gwiazdkami. Kliknięcie zapalonej gwiazdki zeruje ocenę, więc wystawioną można cofnąć
- * bez osobnego przycisku „wyczyść".
+ * bez osobnego przycisku "wyczyść".
  *
  * Do edycji to grupa radiowa (`role="radiogroup"`, gwiazdki jako `role="radio"`): jeden przystanek
  * Tab, strzałki zmieniają ocenę o krok (w RTL odwrócone w poziomie), `Home`/`End` ustawiają
- * skrajne, `Delete`/`Backspace` zeruje. Z `allowHalf` każda gwiazdka ma dwie połówki — dwa osobne
- * `radio` („3,5 z 5”), a krok strzałek to 0,5. Tylko do odczytu (`readOnly`) to obrazek z nazwą
- * „4,3 z 5” — bez przycisków, które czytnik ogłaszałby jako wyłączone; gwiazdki pokazują wartość
+ * skrajne, `Delete`/`Backspace` zeruje. Z `allowHalf` każda gwiazdka ma dwie połówki - dwa osobne
+ * `radio` ("3,5 z 5"), a krok strzałek to 0,5. Tylko do odczytu (`readOnly`) to obrazek z nazwą
+ * "4,3 z 5" - bez przycisków, które czytnik ogłaszałby jako wyłączone; gwiazdki pokazują wartość
  * zaokrągloną do połówki.
  *
  * @example