@primitiv-ui/core 0.1.54 → 0.1.55

package/dist/index.d.ts

@@ -6,3 +6,4 @@ export { accordionKeydown, accordionToggle, type AccordionKeyOutcome, type Accor
 export { collapsibleKeydown, collapsibleToggle, type CollapsibleKeyOutcome, type CollapsibleState, } from "./collapsible/policy.js";
 export { FOCUSABLE_SELECTOR } from "./focus/focusable.js";
 export { modalPointerOutside, modalTabKeydown, type ModalBox, type ModalTabOutcome, type ModalTabState, } from "./modal/policy.js";
+export { popoverKeydown, popoverPressDismisses, type PopoverKeyOutcome, type PopoverPress, } from "./popover/policy.js";

package/dist/index.js

@@ -6,3 +6,4 @@ export { accordionKeydown, accordionToggle, } from "./accordion/policy.js";
 export { collapsibleKeydown, collapsibleToggle, } from "./collapsible/policy.js";
 export { FOCUSABLE_SELECTOR } from "./focus/focusable.js";
 export { modalPointerOutside, modalTabKeydown, } from "./modal/policy.js";
+export { popoverKeydown, popoverPressDismisses, } from "./popover/policy.js";

package/dist/popover/policy.d.ts

@@ -0,0 +1,31 @@
+/** What a key press inside an open popover asks for: the open state to move to. */
+export type PopoverKeyOutcome = {
+    open: false;
+};
+/**
+ * The popover's keyboard contract for a key press inside its panel: Escape
+ * closes it (and the caller hands focus back to the trigger, since focus moved
+ * into the panel on open). Returns `null` for any other key, which tells the
+ * caller to leave the event alone.
+ */
+export declare function popoverKeydown(key: string): PopoverKeyOutcome | null;
+/** Where a press landed, relative to an open popover, and whether the browser handles it. */
+export type PopoverPress = {
+    /** Whether the popover is open. */
+    open: boolean;
+    /** Whether the browser light-dismisses `popover="auto"` itself (the Popover API exists). */
+    nativeLightDismiss: boolean;
+    /** Whether the press landed on (or in) the trigger. */
+    inTrigger: boolean;
+    /** Whether the press landed inside a popover — this one, or one nested in it. */
+    inPopover: boolean;
+};
+/**
+ * Whether a press dismisses the popover. A browser with the Popover API
+ * light-dismisses an `auto` popover on an outside press and reports it with a
+ * `toggle` event, so this only answers where it does not; answering there too
+ * would catch the very click that opened the popover from an outside control
+ * and close it again. A press on the trigger toggles it instead, and one inside
+ * any popover is inside.
+ */
+export declare function popoverPressDismisses({ open, nativeLightDismiss, inTrigger, inPopover }: PopoverPress): boolean;

package/dist/popover/policy.js

@@ -0,0 +1,20 @@
+/**
+ * The popover's keyboard contract for a key press inside its panel: Escape
+ * closes it (and the caller hands focus back to the trigger, since focus moved
+ * into the panel on open). Returns `null` for any other key, which tells the
+ * caller to leave the event alone.
+ */
+export function popoverKeydown(key) {
+    return key === "Escape" ? { open: false } : null;
+}
+/**
+ * Whether a press dismisses the popover. A browser with the Popover API
+ * light-dismisses an `auto` popover on an outside press and reports it with a
+ * `toggle` event, so this only answers where it does not; answering there too
+ * would catch the very click that opened the popover from an outside control
+ * and close it again. A press on the trigger toggles it instead, and one inside
+ * any popover is inside.
+ */
+export function popoverPressDismisses({ open, nativeLightDismiss, inTrigger, inPopover }) {
+    return open && !nativeLightDismiss && !inTrigger && !inPopover;
+}

package/package.json

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