@primitiv-ui/core 0.1.59 → 0.1.60

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { resolveRovingTarget, type ResolveRovingTargetOptions, } from "./keyboar
 export { tabsClick, tabsKeydown, tabsTabStop, type TabsActivationMode, type TabsKeyOutcome, type TabsOrientation, type TabsReadingDirection, type TabsState, } from "./tabs/policy.js";
 export { accordionKeydown, accordionToggle, type AccordionKeyOutcome, type AccordionOrientation, type AccordionReadingDirection, type AccordionState, } from "./accordion/policy.js";
 export { toggleGroupKeydown, toggleGroupTabStop, toggleGroupToggle, type ToggleGroupKeyOutcome, type ToggleGroupOrientation, type ToggleGroupReadingDirection, type ToggleGroupState, } from "./toggle-group/policy.js";
+export { segmentedControlKeydown, segmentedControlSelect, segmentedControlTabStop, type SegmentedControlKeyOutcome, type SegmentedControlOrientation, type SegmentedControlReadingDirection, type SegmentedControlState, } from "./segmented-control/policy.js";
 export { collapsibleKeydown, collapsibleToggle, type CollapsibleKeyOutcome, type CollapsibleState, } from "./collapsible/policy.js";
 export { FOCUSABLE_SELECTOR } from "./focus/focusable.js";
 export { MENU_ITEM_SELECTOR, MENU_TYPEAHEAD_RESET_MS, menuKeydown, menuTypeahead, type MenuKeyOutcome, type MenuKeyState, type MenuTypeaheadOutcome, type MenuTypeaheadState, } from "./menu/policy.js";

package/dist/index.js

@@ -4,6 +4,7 @@ export { resolveRovingTarget, } from "./keyboard/resolveRovingTarget.js";
 export { tabsClick, tabsKeydown, tabsTabStop, } from "./tabs/policy.js";
 export { accordionKeydown, accordionToggle, } from "./accordion/policy.js";
 export { toggleGroupKeydown, toggleGroupTabStop, toggleGroupToggle, } from "./toggle-group/policy.js";
+export { segmentedControlKeydown, segmentedControlSelect, segmentedControlTabStop, } from "./segmented-control/policy.js";
 export { collapsibleKeydown, collapsibleToggle, } from "./collapsible/policy.js";
 export { FOCUSABLE_SELECTOR } from "./focus/focusable.js";
 export { MENU_ITEM_SELECTOR, MENU_TYPEAHEAD_RESET_MS, menuKeydown, menuTypeahead, } from "./menu/policy.js";

package/dist/segmented-control/policy.d.ts

@@ -0,0 +1,51 @@
+/** Layout axis of the control: which arrow pair moves between segments. */
+export type SegmentedControlOrientation = "horizontal" | "vertical";
+/** Reading direction. Under `"rtl"` the horizontal arrows are mirrored. */
+export type SegmentedControlReadingDirection = "ltr" | "rtl";
+/**
+ * Everything SegmentedControl's selection and keyboard rules depend on, as
+ * plain data. Each surface builds it from wherever it keeps state — React
+ * state, or a custom element's attributes — and applies the outcome back the
+ * same way. A whole-control disable is every value in `disabled`.
+ */
+export type SegmentedControlState = {
+    /** Every segment's value, in DOM order, disabled ones included. */
+    values: readonly string[];
+    /** The values of the disabled segments. */
+    disabled: ReadonlySet<string>;
+    /** The selected segment's value, or `undefined` while none is selected. */
+    selected: string | undefined;
+    orientation: SegmentedControlOrientation;
+    dir: SegmentedControlReadingDirection;
+};
+/** What a key press on a segment asks for: a segment to focus, and the segment
+ * to select — `null` when it is already selected, so no change is reported. */
+export type SegmentedControlKeyOutcome = {
+    focus: string;
+    select: string | null;
+};
+/**
+ * The segment a click on `value` selects: `null` when it is disabled or
+ * already selected. A selected segment never lets go, so — unlike a toggle
+ * group — the selection cannot be cleared to nothing.
+ */
+export declare function segmentedControlSelect(state: Pick<SegmentedControlState, "disabled" | "selected">, value: string): string | null;
+/**
+ * SegmentedControl's keyboard contract — the WAI-ARIA radio group's — for a key
+ * press on the segment `focused`: the arrows follow `orientation`, mirrored
+ * under RTL, wrap at the ends and skip disabled segments, and each one moves
+ * focus **and** selection. While focus sits on a disabled segment they do
+ * nothing. There is no Home / End, and Enter / Space are the native button's
+ * click.
+ *
+ * Returns `null` for a key the control does not handle, which tells the caller
+ * to leave the event alone (no `preventDefault`).
+ */
+export declare function segmentedControlKeydown(state: SegmentedControlState, focused: string, key: string): SegmentedControlKeyOutcome | null;
+/**
+ * The segment that takes part in the page's Tab order (the roving tab stop):
+ * the selected segment, else the first enabled one so the control is still
+ * reachable by keyboard — or none, while nothing is selected and every segment
+ * is disabled.
+ */
+export declare function segmentedControlTabStop(state: Pick<SegmentedControlState, "values" | "disabled" | "selected">): string | undefined;

package/dist/segmented-control/policy.js

@@ -0,0 +1,36 @@
+import { getKeyToActionMap } from "../keyboard/getKeyToActionMap.js";
+import { resolveRovingTarget } from "../keyboard/resolveRovingTarget.js";
+/**
+ * The segment a click on `value` selects: `null` when it is disabled or
+ * already selected. A selected segment never lets go, so — unlike a toggle
+ * group — the selection cannot be cleared to nothing.
+ */
+export function segmentedControlSelect(state, value) {
+    return state.disabled.has(value) || state.selected === value ? null : value;
+}
+/**
+ * SegmentedControl's keyboard contract — the WAI-ARIA radio group's — for a key
+ * press on the segment `focused`: the arrows follow `orientation`, mirrored
+ * under RTL, wrap at the ends and skip disabled segments, and each one moves
+ * focus **and** selection. While focus sits on a disabled segment they do
+ * nothing. There is no Home / End, and Enter / Space are the native button's
+ * click.
+ *
+ * Returns `null` for a key the control does not handle, which tells the caller
+ * to leave the event alone (no `preventDefault`).
+ */
+export function segmentedControlKeydown(state, focused, key) {
+    const action = getKeyToActionMap({ orientation: state.orientation, dir: state.dir })[key];
+    const navigable = state.values.filter((value) => !state.disabled.has(value));
+    const result = resolveRovingTarget({ action, navigable, currentKey: focused });
+    return result && { focus: result.target, select: segmentedControlSelect(state, result.target) };
+}
+/**
+ * The segment that takes part in the page's Tab order (the roving tab stop):
+ * the selected segment, else the first enabled one so the control is still
+ * reachable by keyboard — or none, while nothing is selected and every segment
+ * is disabled.
+ */
+export function segmentedControlTabStop(state) {
+    return state.selected ?? state.values.find((value) => !state.disabled.has(value));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primitiv-ui/core",
-  "version": "0.1.59",
+  "version": "0.1.60",
   "description": "The framework-free behaviour core shared by every Primitiv surface — keyboard maps, roving-focus targets, id derivation and per-component policy, as pure functions with no DOM and no dependencies.",
   "type": "module",
   "main": "./dist/index.js",