@konce-pt/react 0.9.1 → 0.10.0

package/dist/password/password.js

@@ -4,7 +4,7 @@ import { cn } from "../internal/cn.js";
 import { useControllableState } from "../internal/use-controllable-state.js";
 import { useKptId } from "../internal/use-id.js";
 import { useKptMessages } from "../i18n/i18n-context.js";
-import { useKptFormFieldContext } from "../form-field/form-field-context.js";
+import { joinIds, useKptFieldA11y } from "../form-field/form-field-context.js";
 import { KptIcon } from "../icon/icon.js";
 /** Cztery niezależne kryteria; każde spełnione podnosi wynik o jeden. */
 function scoreOf(password) {
@@ -25,13 +25,14 @@ function scoreOf(password) {
  * @example
  * <KptPassword value={password} onValueChange={setPassword} feedback autoComplete="new-password" />
  */
-export function KptPassword({ value, defaultValue = '', onValueChange, placeholder = '', id, autoComplete = 'current-password', feedback = false, disabled = false, invalid = false, touched, onTouch, locale, dictionary, className, ...rest }) {
+export function KptPassword({ value, defaultValue = '', onValueChange, placeholder = '', id, autoComplete = 'current-password', feedback = false, ariaLabel = null, required = false, readOnly = false, disabled = false, invalid = false, touched, onTouch, locale, dictionary, className, ...rest }) {
     const { t, messages } = useKptMessages({ locale, dictionary });
-    const field = useKptFormFieldContext();
-    const inputId = useKptId(id ?? field?.controlId, 'kpt-password');
+    const field = useKptFieldA11y(id, 'kpt-password');
+    const inputId = field.id;
+    const meterId = useKptId(undefined, 'kpt-password-strength');
     const [current, setCurrent] = useControllableState({ value, defaultValue, onChange: onValueChange });
     const [visible, setVisible] = useState(false);
     const showInvalid = invalid && (touched ?? true);
     const score = scoreOf(current);
-    return (_jsxs("div", { className: cn('kpt-password-host', className), ...rest, children: [_jsxs("div", { className: cn('kpt-password', disabled && 'kpt-password--disabled', showInvalid && 'kpt-password--invalid'), children: [_jsx("input", { className: "kpt-password__input", id: inputId, type: visible ? 'text' : 'password', value: current, disabled: disabled, placeholder: placeholder, autoComplete: autoComplete ?? undefined, onChange: (event) => setCurrent(event.target.value), onBlur: () => onTouch?.() }), _jsx("button", { type: "button", className: "kpt-password__toggle", disabled: disabled, onClick: () => setVisible(!visible), "aria-label": visible ? t('password.hide') : t('password.show'), children: _jsx(KptIcon, { name: visible ? 'eye-off' : 'eye' }) })] }), feedback && current ? (_jsxs("div", { className: "kpt-password__meter", "data-score": score, children: [_jsx("div", { className: "kpt-password__bars", children: [0, 1, 2, 3].map((index) => (_jsx("span", { className: cn('kpt-password__bar', index < score && 'is-on') }, index))) }), _jsx("span", { className: "kpt-password__hint", children: messages.password.strength[score] })] })) : null] }));
+    return (_jsxs("div", { className: cn('kpt-password-host', className), ...rest, children: [_jsxs("div", { className: cn('kpt-password', disabled && 'kpt-password--disabled', showInvalid && 'kpt-password--invalid'), children: [_jsx("input", { className: "kpt-password__input", id: inputId, type: visible ? 'text' : 'password', value: current, disabled: disabled, readOnly: readOnly, "aria-invalid": showInvalid || undefined, "aria-required": required || undefined, "aria-label": ariaLabel ?? undefined, "aria-describedby": joinIds(field.describedBy, feedback && current && meterId), placeholder: placeholder, autoComplete: autoComplete ?? undefined, onChange: (event) => setCurrent(event.target.value), onBlur: () => onTouch?.() }), _jsx("button", { type: "button", className: "kpt-password__toggle", disabled: disabled, onClick: () => setVisible(!visible), "aria-label": visible ? t('password.hide') : t('password.show'), children: _jsx(KptIcon, { name: visible ? 'eye-off' : 'eye' }) })] }), feedback && current ? (_jsxs("div", { className: "kpt-password__meter", id: meterId, "data-score": score, children: [_jsx("div", { className: "kpt-password__bars", "aria-hidden": "true", children: [0, 1, 2, 3].map((index) => (_jsx("span", { className: cn('kpt-password__bar', index < score && 'is-on') }, index))) }), _jsx("span", { className: "kpt-password__hint", children: messages.password.strength[score] })] })) : null] }));
 }

package/dist/pick-list/llms.txt

@@ -60,7 +60,16 @@ double-click carry no visible label, so they add no dictionary keys.
 ## Tokens
 The selection `--kpt-color-primary`, the headers `--kpt-color-surface-variant`.
 
+## Keyboard
+Each list is a `listbox` with `aria-multiselectable` and a single Tab stop (roving tabindex):
+- `↓` / `↑` move between items (wrapping), `Home` / `End` jump to the ends;
+- `Space` toggles the focused item's selection (`aria-selected`), the same as a click;
+- `Enter` moves the focused item to the other list, the same as a double-click — focus stays at
+  that position in the list, on the next item.
+The move buttons act on the same selection, so the whole control works without a mouse.
+
 ## Accessibility
-Every move button is labelled from the dictionary, so "move all right" is distinguishable from
-"move right" without seeing the double chevron. Native HTML5 drag and drop has no keyboard
-equivalent, so those buttons stay the full keyboard path — `dragdrop` never replaces them.
+Each list is named after its header (`aria-label`). The four move buttons are labelled from the
+dictionary, so "move all right" is distinguishable from "move right" without seeing the double
+chevron. Native HTML5 drag and drop has no keyboard equivalent — `Enter` and the buttons cover
+everything it does, and `dragdrop` adds to them, it never replaces them.

package/dist/pick-list/pick-list.d.ts

@@ -22,6 +22,10 @@ export interface KptPickListProps<T> extends Omit<ComponentPropsWithRef<'div'>,
  * Z `dragdrop` dochodzi przeciąganie — porządkowanie wewnątrz panelu i przenoszenie na
  * konkretną pozycję drugiego panelu.
  *
+ * Każda lista to `listbox` z wielokrotnym wyborem i jednym przystankiem Tab (roving tabindex):
+ * strzałki / `Home` / `End` przechodzą po pozycjach, spacja zaznacza, `Enter` przenosi pozycję
+ * na drugą stronę (jak dwuklik).
+ *
  * @example
  * <KptPickList
  *   source={available} onSourceChange={setAvailable}
@@ -30,4 +34,4 @@ export interface KptPickListProps<T> extends Omit<ComponentPropsWithRef<'div'>,
  *   renderItem={(item) => item.name}
  * />
  */
-export declare function KptPickList<T>({ source, defaultSource, onSourceChange, target, defaultTarget, onTargetChange, sourceHeader, targetHeader, dragdrop, renderItem, locale, dictionary, className, ...rest }: Readonly<KptPickListProps<T>>): import("react").JSX.Element;
+export declare function KptPickList<T>({ source, defaultSource, onSourceChange, target, defaultTarget, onTargetChange, sourceHeader, targetHeader, dragdrop, renderItem, locale, dictionary, className, ref, ...rest }: Readonly<KptPickListProps<T>>): import("react").JSX.Element;

package/dist/pick-list/pick-list.js

@@ -1,9 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from 'react';
+import { useEffect, useRef, useState } from 'react';
 import { cn } from "../internal/cn.js";
+import { composeRefs } from "../internal/compose-refs.js";
 import { useControllableState } from "../internal/use-controllable-state.js";
 import { useKptMessages } from "../i18n/i18n-context.js";
 import { KptIcon } from "../icon/icon.js";
+import { nextMenuIndex } from "../menu/menu-keys.js";
 const EMPTY = [];
 /**
  * PickList — transfer elementów między dwiema listami. Klik zaznacza, przyciski pośrodku
@@ -11,6 +13,10 @@ const EMPTY = [];
  * Z `dragdrop` dochodzi przeciąganie — porządkowanie wewnątrz panelu i przenoszenie na
  * konkretną pozycję drugiego panelu.
  *
+ * Każda lista to `listbox` z wielokrotnym wyborem i jednym przystankiem Tab (roving tabindex):
+ * strzałki / `Home` / `End` przechodzą po pozycjach, spacja zaznacza, `Enter` przenosi pozycję
+ * na drugą stronę (jak dwuklik).
+ *
  * @example
  * <KptPickList
  *   source={available} onSourceChange={setAvailable}
@@ -19,7 +25,7 @@ const EMPTY = [];
  *   renderItem={(item) => item.name}
  * />
  */
-export function KptPickList({ source, defaultSource = EMPTY, onSourceChange, target, defaultTarget = EMPTY, onTargetChange, sourceHeader, targetHeader, dragdrop = false, renderItem, locale, dictionary, className, ...rest }) {
+export function KptPickList({ source, defaultSource = EMPTY, onSourceChange, target, defaultTarget = EMPTY, onTargetChange, sourceHeader, targetHeader, dragdrop = false, renderItem, locale, dictionary, className, ref, ...rest }) {
     const { t } = useKptMessages({ locale, dictionary });
     const [left, setLeft] = useControllableState({
         value: source,
@@ -41,11 +47,33 @@ export function KptPickList({ source, defaultSource = EMPTY, onSourceChange, tar
     const [over, setOver] = useState(null);
     /** Panel, nad którego pustym obszarem jest kursor — upuszczenie tam dopina na koniec. */
     const [listOver, setListOver] = useState(null);
+    /** Pozycja, która ostatnio miała fokus w każdej liście — ona jest przystankiem Tab. */
+    const [focusLeft, setFocusLeft] = useState(0);
+    const [focusRight, setFocusRight] = useState(0);
+    /** Pozycja, na którą po renderze trzeba przenieść fokus DOM (klawiatura). */
+    const [focusRequest, setFocusRequest] = useState(null);
+    const rootRef = useRef(null);
     const listOf = (side) => (side === 'source' ? left : right);
     const setListOf = (side) => (side === 'source' ? setLeft : setRight);
     const selectionOf = (side) => (side === 'source' ? selLeft : selRight);
     const setSelectionOf = (side) => side === 'source' ? setSelLeft : setSelRight;
     const other = (side) => (side === 'source' ? 'target' : 'source');
+    const focusOf = (side) => (side === 'source' ? focusLeft : focusRight);
+    const setFocusOf = (side) => (side === 'source' ? setFocusLeft : setFocusRight);
+    /** Przystanek Tab listy — ostatnio skupiona pozycja, przycięta do długości listy. */
+    const tabIndexOf = (side) => Math.min(focusOf(side), listOf(side).length - 1);
+    useEffect(() => {
+        if (!focusRequest)
+            return;
+        const list = rootRef.current?.querySelectorAll('.kpt-pick-list__items')[focusRequest.side === 'source' ? 0 : 1];
+        const options = list?.querySelectorAll('[role="option"]') ?? [];
+        options[Math.min(focusRequest.index, options.length - 1)]?.focus();
+        setFocusRequest(null);
+    }, [focusRequest]);
+    const focusItem = (side, index) => {
+        setFocusOf(side)(index);
+        setFocusRequest({ side, index });
+    };
     const toggle = (side, item) => {
         const next = new Set(selectionOf(side));
         if (next.has(item))
@@ -91,6 +119,25 @@ export function KptPickList({ source, defaultSource = EMPTY, onSourceChange, tar
         const to = other(from);
         transfer(from, index, to, listOf(to).length);
     };
+    const onItemKeyDown = (side, index, item, event) => {
+        if (event.key === ' ') {
+            event.preventDefault();
+            toggle(side, item);
+            return;
+        }
+        if (event.key === 'Enter') {
+            event.preventDefault();
+            moveOne(side, item);
+            // Pozycja zniknęła z listy — fokus zostaje w tym samym miejscu listy, na następnej.
+            focusItem(side, index);
+            return;
+        }
+        const next = nextMenuIndex(listOf(side).length, index, event.key);
+        if (next === null)
+            return;
+        event.preventDefault();
+        focusItem(side, next);
+    };
     const clearDrag = () => {
         setDrag(null);
         setOver(null);
@@ -162,10 +209,10 @@ export function KptPickList({ source, defaultSource = EMPTY, onSourceChange, tar
         const items = listOf(side);
         const selection = selectionOf(side);
         const header = side === 'source' ? (sourceHeader ?? t('pickList.available')) : (targetHeader ?? t('pickList.selected'));
-        return (_jsxs("div", { className: "kpt-pick-list__col", children: [_jsx("div", { className: "kpt-pick-list__header", children: header }), _jsx("ul", { className: cn('kpt-pick-list__items', listOver === side && 'is-dragover'), onDragOver: (event) => onListDragOver(side, event), onDragLeave: () => setListOver(null), onDrop: (event) => onListDrop(side, event), children: items.map((item, index) => {
+        return (_jsxs("div", { className: "kpt-pick-list__col", children: [_jsx("div", { className: "kpt-pick-list__header", children: header }), _jsx("ul", { className: cn('kpt-pick-list__items', listOver === side && 'is-dragover'), role: "listbox", "aria-multiselectable": "true", "aria-label": header, onDragOver: (event) => onListDragOver(side, event), onDragLeave: () => setListOver(null), onDrop: (event) => onListDrop(side, event), children: items.map((item, index) => {
                         const dragging = drag?.side === side && drag.index === index;
-                        return (_jsx("li", { className: cn('kpt-pick-list__item', selection.has(item) && 'is-selected', dragging && 'is-dragging', dragdrop && 'kpt-pick-list__item--draggable', over?.side === side && over.index === index && !dragging && 'kpt-pick-list__item--dragover'), draggable: dragdrop || undefined, onClick: () => toggle(side, item), onDoubleClick: () => moveOne(side, item), onDragStart: (event) => onDragStart(side, index, event), onDragOver: (event) => onDragOver(side, index, event), onDragLeave: () => setOver(null), onDrop: (event) => onDrop(side, index, event), onDragEnd: clearDrag, children: renderItem(item, index) }, index));
+                        return (_jsx("li", { className: cn('kpt-pick-list__item', selection.has(item) && 'is-selected', dragging && 'is-dragging', dragdrop && 'kpt-pick-list__item--draggable', over?.side === side && over.index === index && !dragging && 'kpt-pick-list__item--dragover'), role: "option", "aria-selected": selection.has(item), tabIndex: index === tabIndexOf(side) ? 0 : -1, onFocus: () => setFocusOf(side)(index), onKeyDown: (event) => onItemKeyDown(side, index, item, event), draggable: dragdrop || undefined, onClick: () => toggle(side, item), onDoubleClick: () => moveOne(side, item), onDragStart: (event) => onDragStart(side, index, event), onDragOver: (event) => onDragOver(side, index, event), onDragLeave: () => setOver(null), onDrop: (event) => onDrop(side, index, event), onDragEnd: clearDrag, children: renderItem(item, index) }, index));
                     }) })] }));
     };
-    return (_jsx("div", { className: cn('kpt-pick-list-host', className), ...rest, children: _jsxs("div", { className: "kpt-pick-list", children: [column('source'), _jsxs("div", { className: "kpt-pick-list__controls", children: [_jsxs("button", { type: "button", "aria-label": t('pickList.moveAllRight'), onClick: () => move('source', true), children: [_jsx(KptIcon, { name: "chevron-right" }), _jsx(KptIcon, { name: "chevron-right" })] }), _jsx("button", { type: "button", "aria-label": t('pickList.moveRight'), onClick: () => move('source', false), children: _jsx(KptIcon, { name: "chevron-right" }) }), _jsx("button", { type: "button", "aria-label": t('pickList.moveLeft'), onClick: () => move('target', false), children: _jsx(KptIcon, { name: "chevron-left" }) }), _jsxs("button", { type: "button", "aria-label": t('pickList.moveAllLeft'), onClick: () => move('target', true), children: [_jsx(KptIcon, { name: "chevron-left" }), _jsx(KptIcon, { name: "chevron-left" })] })] }), column('target')] }) }));
+    return (_jsx("div", { ref: composeRefs(rootRef, ref), className: cn('kpt-pick-list-host', className), ...rest, children: _jsxs("div", { className: "kpt-pick-list", children: [column('source'), _jsxs("div", { className: "kpt-pick-list__controls", children: [_jsxs("button", { type: "button", "aria-label": t('pickList.moveAllRight'), onClick: () => move('source', true), children: [_jsx(KptIcon, { name: "chevron-right" }), _jsx(KptIcon, { name: "chevron-right" })] }), _jsx("button", { type: "button", "aria-label": t('pickList.moveRight'), onClick: () => move('source', false), children: _jsx(KptIcon, { name: "chevron-right" }) }), _jsx("button", { type: "button", "aria-label": t('pickList.moveLeft'), onClick: () => move('target', false), children: _jsx(KptIcon, { name: "chevron-left" }) }), _jsxs("button", { type: "button", "aria-label": t('pickList.moveAllLeft'), onClick: () => move('target', true), children: [_jsx(KptIcon, { name: "chevron-left" }), _jsx(KptIcon, { name: "chevron-left" })] })] }), column('target')] }) }));
 }

package/dist/popover/llms.txt

@@ -14,6 +14,7 @@ Import: `import { KptPopover } from '@konce-pt/react';`
 - `trigger`: ReactNode — the element that opens the bubble, rendered in place
 - `children`: ReactNode — the panel content
 - `open` / `defaultOpen` / `onOpenChange` — controlled or uncontrolled
+- `placement`: 'bottom' (default) | 'top' — the preferred side; it flips when there is no room
 - `className`, `ref` and every other `<span>` prop go to the host
 
 ## The panel is a portal
@@ -38,5 +39,11 @@ backdrop takes that click, exactly as the CDK backdrop does.
 `--kpt-z-overlay`.
 
 ## Accessibility
-The panel is `role="dialog"` and Escape closes it. Focus is not trapped — the popover is meant for
-supporting content, so for a real modal reach for a dialog instead.
+The panel is `role="dialog"` with an `id` the trigger points to.
+
+## Focus and keyboard
+The control inside the trigger slot gets `aria-haspopup="dialog"`, a live `aria-expanded` and, while
+open, `aria-controls` — on the real `<button>`, not on the wrapper. Opening moves focus to the first
+interactive element of the bubble; `Escape` or a click outside closes it, and focus returns to the
+trigger when it was inside the bubble. Focus is not trapped — the popover is supporting content, not
+a modal.

package/dist/popover/popover.d.ts

@@ -7,17 +7,23 @@ export interface KptPopoverProps extends Omit<ComponentPropsWithRef<'span'>, 'co
     open?: boolean;
     defaultOpen?: boolean;
     onOpenChange?: (open: boolean) => void;
+    /** Preferowana strona dymka; gdy brakuje miejsca, przechodzi na drugą. */
+    placement?: 'bottom' | 'top';
 }
 /**
  * Popover — dowolna treść w dymku przypiętym do wyzwalacza (bogatszy niż tooltip).
  *
  * Port Angulara stoi na CDK Overlay; tutaj panel renderuje się w portalu do `document.body`,
- * z tym samym zachowaniem: pozycja pod wyzwalaczem z odbiciem w górę przy braku miejsca,
- * zamykanie kliknięciem poza panelem i klawiszem Escape.
+ * z tym samym zachowaniem: pozycja pod wyzwalaczem (albo nad nim przy `placement="top"`)
+ * z odbiciem przy braku miejsca, zamykanie kliknięciem poza panelem i klawiszem Escape.
+ *
+ * Dostępność (jak w Angularze): kontrolka w wyzwalaczu dostaje `aria-haspopup="dialog"`,
+ * `aria-expanded` i `aria-controls`; po otwarciu fokus przechodzi do pierwszego interaktywnego
+ * elementu dymka, a po zamknięciu wraca na wyzwalacz, jeśli był w dymku.
  *
  * @example
  * <KptPopover trigger={<KptButton variant="outline">Szczegóły</KptButton>}>
  *   <div>Bogata treść popovera…</div>
  * </KptPopover>
  */
-export declare function KptPopover({ trigger, children, open, defaultOpen, onOpenChange, className, ...rest }: Readonly<KptPopoverProps>): import("react").JSX.Element;
+export declare function KptPopover({ trigger, children, open, defaultOpen, onOpenChange, placement, className, ...rest }: Readonly<KptPopoverProps>): import("react").JSX.Element;

package/dist/popover/popover.js

@@ -1,27 +1,62 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useCallback, useRef } from 'react';
+import { useCallback, useEffect, useRef } from 'react';
 import { cn } from "../internal/cn.js";
 import { KptOverlay } from "../internal/overlay.js";
 import { useControllableState } from "../internal/use-controllable-state.js";
+import { useKptId } from "../internal/use-id.js";
+/** Elementy, które same przyjmują fokus — pierwszy z nich dostaje fokus po otwarciu dymka. */
+const FOCUSABLE = 'a[href], button:not(:disabled), input:not(:disabled), select, textarea, [tabindex]:not([tabindex="-1"])';
 /**
  * Popover — dowolna treść w dymku przypiętym do wyzwalacza (bogatszy niż tooltip).
  *
  * Port Angulara stoi na CDK Overlay; tutaj panel renderuje się w portalu do `document.body`,
- * z tym samym zachowaniem: pozycja pod wyzwalaczem z odbiciem w górę przy braku miejsca,
- * zamykanie kliknięciem poza panelem i klawiszem Escape.
+ * z tym samym zachowaniem: pozycja pod wyzwalaczem (albo nad nim przy `placement="top"`)
+ * z odbiciem przy braku miejsca, zamykanie kliknięciem poza panelem i klawiszem Escape.
+ *
+ * Dostępność (jak w Angularze): kontrolka w wyzwalaczu dostaje `aria-haspopup="dialog"`,
+ * `aria-expanded` i `aria-controls`; po otwarciu fokus przechodzi do pierwszego interaktywnego
+ * elementu dymka, a po zamknięciu wraca na wyzwalacz, jeśli był w dymku.
  *
  * @example
  * <KptPopover trigger={<KptButton variant="outline">Szczegóły</KptButton>}>
  *   <div>Bogata treść popovera…</div>
  * </KptPopover>
  */
-export function KptPopover({ trigger, children, open, defaultOpen = false, onOpenChange, className, ...rest }) {
+export function KptPopover({ trigger, children, open, defaultOpen = false, onOpenChange, placement = 'bottom', className, ...rest }) {
     const triggerRef = useRef(null);
+    const panelRef = useRef(null);
+    const panelId = useKptId(undefined, 'kpt-popover');
     const [isOpen, setOpen] = useControllableState({
         value: open,
         defaultValue: defaultOpen,
         onChange: onOpenChange,
     });
-    const close = useCallback(() => setOpen(false), [setOpen]);
-    return (_jsxs("span", { className: cn('kpt-popover-host', className), ...rest, children: [_jsx("span", { className: "kpt-popover__trigger", ref: triggerRef, onClick: () => setOpen(!isOpen), children: trigger }), _jsx(KptOverlay, { open: isOpen, anchor: triggerRef.current, onClose: close, offset: 6, children: _jsx("div", { className: "kpt-popover__panel", role: "dialog", children: children }) })] }));
+    const findControl = () => triggerRef.current?.querySelector('button, a, [role="button"]') ?? null;
+    // ARIA na prawdziwej kontrolce w slocie, nie na opakowaniu `<span>` (patrz `KptMenu`).
+    useEffect(() => {
+        const control = findControl();
+        if (!control)
+            return;
+        control.setAttribute('aria-haspopup', 'dialog');
+        control.setAttribute('aria-expanded', String(isOpen));
+        if (isOpen)
+            control.setAttribute('aria-controls', panelId);
+        else
+            control.removeAttribute('aria-controls');
+    }, [isOpen, trigger, panelId]);
+    // Fokus do dymka klatkę później — `KptOverlay` trzyma panel niewidoczny, dopóki go nie zmierzy.
+    useEffect(() => {
+        if (!isOpen)
+            return;
+        const frame = requestAnimationFrame(() => panelRef.current?.querySelector(FOCUSABLE)?.focus());
+        return () => cancelAnimationFrame(frame);
+    }, [isOpen]);
+    const close = useCallback(() => {
+        const active = document.activeElement;
+        // Fokus wraca na wyzwalacz tylko wtedy, gdy był w dymku (albo przepadł na `<body>`).
+        if (!active || active === document.body || panelRef.current?.contains(active))
+            findControl()?.focus();
+        setOpen(false);
+    }, [setOpen]);
+    return (_jsxs("span", { className: cn('kpt-popover-host', className), ...rest, children: [_jsx("span", { className: "kpt-popover__trigger", ref: triggerRef, onClick: () => setOpen(!isOpen), children: trigger }), _jsx(KptOverlay, { open: isOpen, anchor: triggerRef.current, onClose: close, offset: 6, preferAbove: placement === 'top', children: _jsx("div", { ref: panelRef, id: panelId, className: "kpt-popover__panel", role: "dialog", children: children }) })] }));
 }

package/dist/public-api.d.ts

@@ -90,7 +90,7 @@ export type { KptConfirmOptions, KptConfirmRequest } from './confirm/confirm-sto
 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, KptToastOptions } from './toast/toast-store.ts';
+export type { KptToast, KptToastAction, KptToastOptions } from './toast/toast-store.ts';
 export { KptMenu } from './menu/menu.tsx';
 export { KptMenubar } from './menubar/menubar.tsx';
 export type { KptMenubarProps } from './menubar/menubar.tsx';
@@ -123,8 +123,8 @@ export type { KptSelectProps } from './select/select.tsx';
 export type { KptAlertVariant, KptOption } from './shared/types.ts';
 export { KptFormField } from './form-field/form-field.tsx';
 export type { KptFormFieldLabelType, KptFormFieldProps } from './form-field/form-field.tsx';
-export { useKptFormFieldContext, useKptFormFieldFilled } from './form-field/form-field-context.ts';
-export type { KptFormFieldContextValue } from './form-field/form-field-context.ts';
+export { useKptFieldA11y, useKptFormFieldContext, useKptFormFieldFilled } from './form-field/form-field-context.ts';
+export type { KptFieldA11y, KptFormFieldContextValue } from './form-field/form-field-context.ts';
 export { KptCheckbox } from './checkbox/checkbox.tsx';
 export type { KptCheckboxProps } from './checkbox/checkbox.tsx';
 export { KptAutocomplete } from './autocomplete/autocomplete.tsx';
@@ -156,7 +156,7 @@ export type { KptDateRangeMode, KptDateRangeProps, KptDateRangeValue } from './d
 export { KptClock } from './clock/clock.tsx';
 export type { KptClockProps } from './clock/clock.tsx';
 export { KptColorPicker } from './color-picker/color-picker.tsx';
-export type { KptColorPickerProps } from './color-picker/color-picker.tsx';
+export type { KptColorPickerProps, KptColorPreset } from './color-picker/color-picker.tsx';
 export { KptFileUpload } from './file-upload/file-upload.tsx';
 export type { KptFileUploadProps } from './file-upload/file-upload.tsx';
 export { KptSwitchGroup } from './switch-group/switch-group.tsx';
@@ -175,10 +175,10 @@ export type { KptIconButtonProps } from './icon-button/icon-button.tsx';
 export { KptFab } from './fab/fab.tsx';
 export type { KptFabProps } from './fab/fab.tsx';
 export { KptSplitButton } from './split-button/split-button.tsx';
-export type { KptSplitButtonProps } from './split-button/split-button.tsx';
+export type { KptSplitButtonProps, KptSplitButtonVariant } from './split-button/split-button.tsx';
 export type { KptButtonProps, KptButtonSize, KptButtonVariant } from './button/button.tsx';
 export { KptCard, KptCardActions, KptCardFooter, KptCardHeader, KptCardLead, KptCardMedia, KptCardMeta, KptCardSection, KptCardSubtitle, KptCardTags, KptCardTitle, } from './card/card.tsx';
-export type { KptCardProps, KptCardVariant } from './card/card.tsx';
+export type { KptCardHeadingLevel, KptCardProps, KptCardVariant } from './card/card.tsx';
 export { KptI18nProvider, useKptI18n, useKptMessages } from './i18n/i18n-context.tsx';
 export type { KptI18nContextValue, KptI18nOverrides, KptI18nProviderProps } from './i18n/i18n-context.tsx';
 export { KPT_MESSAGES_EN, KPT_MESSAGES_PL } from '@konce-pt/i18n';

package/dist/public-api.js

@@ -71,7 +71,7 @@ export { KptOverlay } from "./internal/overlay.js";
 export { KptButtonGroup } from "./button-group/button-group.js";
 export { KptSelect } from "./select/select.js";
 export { KptFormField } from "./form-field/form-field.js";
-export { useKptFormFieldContext, useKptFormFieldFilled } from "./form-field/form-field-context.js";
+export { useKptFieldA11y, useKptFormFieldContext, useKptFormFieldFilled } from "./form-field/form-field-context.js";
 export { KptCheckbox } from "./checkbox/checkbox.js";
 export { KptAutocomplete } from "./autocomplete/autocomplete.js";
 export { KptListbox } from "./listbox/listbox.js";

package/dist/radio-group/llms.txt

@@ -31,6 +31,17 @@ interfere.
     <KptRadioGroup options={plans} value={plan} onValueChange={setPlan} />
     <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
+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
+`radiogroup`.
+
 ## Tokens
 `--kpt-color-primary` (the checked dot), `--kpt-form-field-border`,
 `--kpt-form-field-border-error`.

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

@@ -7,6 +7,14 @@ export interface KptRadioGroupProps<T> extends Omit<ComponentPropsWithRef<'div'>
     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?: string;
+    /** Nazwa dostępna, gdy kontrolki nie opisuje etykieta (`<label for>` albo `KptFormField`). */
+    ariaLabel?: string | null;
+    /** Oznacza grupę jako wymaganą atrybutem `aria-required`. */
+    required?: boolean;
+    /** Układ opcji: pod sobą (domyślnie) albo w rzędzie, z zawijaniem. */
+    orientation?: 'vertical' | 'horizontal';
     disabled?: boolean;
     invalid?: boolean;
     touched?: boolean;
@@ -21,4 +29,4 @@ export interface KptRadioGroupProps<T> extends Omit<ComponentPropsWithRef<'div'>
  * @example
  * <KptRadioGroup options={plans} value={plan} onValueChange={setPlan} />
  */
-export declare function KptRadioGroup<T>({ options, value, defaultValue, onValueChange, name, 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, invalid, touched, onTouch, className, ...rest }: Readonly<KptRadioGroupProps<T>>): import("react").JSX.Element;

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

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "../internal/cn.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";
 /**
  * Grupa przycisków opcji (radio). Opcje przez `options`.
  *
@@ -11,7 +12,9 @@ import { useKptId } from "../internal/use-id.js";
  * @example
  * <KptRadioGroup options={plans} value={plan} onValueChange={setPlan} />
  */
-export function KptRadioGroup({ options = [], value, defaultValue, onValueChange, name, disabled = false, invalid = false, touched, onTouch, className, ...rest }) {
+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. */
+    const field = useKptFieldA11y(id, 'kpt-radio-group');
     const groupName = useKptId(name, 'kpt-radio');
     const [current, setCurrent] = useControllableState({
         value,
@@ -19,5 +22,5 @@ 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: "kpt-radio-group", role: "radiogroup", "aria-invalid": showInvalid || 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'), 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)))) }) }));
 }

package/dist/rating/llms.txt

@@ -5,8 +5,8 @@ Import: `import { KptRating } from '@konce-pt/react';`
 
 ## DOM
     <div class="kpt-rating-host">
-      <div class="kpt-rating" role="slider" aria-valuenow="3" aria-valuemax="5">
-        <button class="kpt-rating__star is-filled" aria-label="1 of 5">…</button>
+      <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>
@@ -14,9 +14,11 @@ Import: `import { KptRating } from '@konce-pt/react';`
 ## Props
 - `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
 - `disabled`: boolean
-- `onTouch()` — fired together with a pick
+- `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
@@ -35,9 +37,20 @@ per instance with the `locale` / `dictionary` props.
     <KptRating value={score} onValueChange={setScore} count={5} />
     <KptRating value={4} readOnly />
 
+## Half stars
+`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
+and a half stars) while the name carries the exact score ("4.3 of 5"), so an average can be shown
+as it is.
+
 ## Tokens
 Lit stars `--kpt-color-warning`, empty ones `--kpt-color-border-strong`.
 
 ## Accessibility
-`role="slider"` with `aria-valuenow` / `aria-valuemax`; every star is a real `<button>`, so the
-row is reachable with Tab and each value can be picked from the keyboard.
+`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),
+`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.d.ts

@@ -6,17 +6,35 @@ export interface KptRatingProps extends Omit<ComponentPropsWithRef<'div'>, 'onCh
     onValueChange?: (value: number) => void;
     /** Liczba gwiazdek. */
     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. */
     readOnly?: boolean;
+    /** 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;
+    /** Oznacza ocenę jako wymaganą atrybutem `aria-required`. */
+    required?: boolean;
     disabled?: boolean;
+    invalid?: boolean;
+    touched?: boolean;
     onTouch?: () => void;
 }
 /**
  * Ocena gwiazdkami. Kliknięcie zapalonej gwiazdki zeruje ocenę, więc wystawioną można cofnąć
  * 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ść
+ * zaokrągloną do połówki.
+ *
  * @example
- * <KptRating value={score} onValueChange={setScore} count={5} />
- * <KptRating value={4} readOnly />
+ * <KptRating value={score} onValueChange={setScore} count={5} ariaLabel="Ocena" />
+ * <KptRating value={score} onValueChange={setScore} allowHalf ariaLabel="Ocena" />
+ * <KptRating value={4.3} readOnly />
  */
-export declare function KptRating({ value, defaultValue, onValueChange, count, readOnly, disabled, onTouch, locale, dictionary, className, ...rest }: Readonly<KptRatingProps>): import("react").JSX.Element;
+export declare function KptRating({ value, defaultValue, onValueChange, count, allowHalf, readOnly, id, ariaLabel, required, disabled, invalid, touched, onTouch, locale, dictionary, className, ...rest }: Readonly<KptRatingProps>): import("react").JSX.Element;