@primitiv-ui/core 0.1.46 → 0.1.47

package/dist/collapsible/policy.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Everything Collapsible's toggle 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.
+ */
+export type CollapsibleState = {
+    /** Whether the panel is open. */
+    open: boolean;
+    /** Whether the collapsible is disabled: it never toggles. */
+    disabled: boolean;
+};
+/**
+ * The open state after a toggle: the opposite of the current one, or `null`
+ * while disabled, when nothing toggles and no change is reported.
+ */
+export declare function collapsibleToggle(state: CollapsibleState): boolean | null;
+/** What a key press on the trigger asks for: the open state to move to. */
+export type CollapsibleKeyOutcome = {
+    open: boolean;
+};
+/**
+ * Collapsible's keyboard contract for a key press on its trigger: Enter and
+ * Space toggle it. A trigger may be a non-button element (an `<a>`, a
+ * `<div role="button">`), so the keys are handled explicitly rather than left
+ * to native activation.
+ *
+ * Returns `null` for any other key, and for every key while disabled, which
+ * tells the caller to leave the event alone (no `preventDefault`).
+ */
+export declare function collapsibleKeydown(state: CollapsibleState, key: string): CollapsibleKeyOutcome | null;

package/dist/collapsible/policy.js

@@ -0,0 +1,22 @@
+/**
+ * The open state after a toggle: the opposite of the current one, or `null`
+ * while disabled, when nothing toggles and no change is reported.
+ */
+export function collapsibleToggle(state) {
+    return state.disabled ? null : !state.open;
+}
+/**
+ * Collapsible's keyboard contract for a key press on its trigger: Enter and
+ * Space toggle it. A trigger may be a non-button element (an `<a>`, a
+ * `<div role="button">`), so the keys are handled explicitly rather than left
+ * to native activation.
+ *
+ * Returns `null` for any other key, and for every key while disabled, which
+ * tells the caller to leave the event alone (no `preventDefault`).
+ */
+export function collapsibleKeydown(state, key) {
+    if (key !== "Enter" && key !== " ")
+        return null;
+    const open = collapsibleToggle(state);
+    return open === null ? null : { open };
+}

package/dist/index.d.ts

@@ -3,3 +3,4 @@ export { getKeyToActionMap, type RovingKeyAction } from "./keyboard/getKeyToActi
 export { resolveRovingTarget, type ResolveRovingTargetOptions, } from "./keyboard/resolveRovingTarget.js";
 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 { collapsibleKeydown, collapsibleToggle, type CollapsibleKeyOutcome, type CollapsibleState, } from "./collapsible/policy.js";

package/dist/index.js

@@ -3,3 +3,4 @@ export { getKeyToActionMap } from "./keyboard/getKeyToActionMap.js";
 export { resolveRovingTarget, } from "./keyboard/resolveRovingTarget.js";
 export { tabsClick, tabsKeydown, tabsTabStop, } from "./tabs/policy.js";
 export { accordionKeydown, accordionToggle, } from "./accordion/policy.js";
+export { collapsibleKeydown, collapsibleToggle, } from "./collapsible/policy.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primitiv-ui/core",
-  "version": "0.1.46",
+  "version": "0.1.47",
   "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",