@gunkin/uiify 0.0.1-alpha

package/dist/core/dismissable-layer-registry.js

@@ -0,0 +1,50 @@
+import { getEventPath, isEventInsideLayer } from "./platform.js";
+const registries = /* @__PURE__ */ new WeakMap();
+function dispatch(document, reason, event) {
+  const record = registries.get(document)?.layers.at(-1);
+  if (!record) return;
+  if (reason !== "escape-key" && isEventInsideLayer(getEventPath(event), record.element, record.branches)) {
+    return;
+  }
+  record.onDismiss(reason, event);
+}
+function createRegistry(document) {
+  const AbortControllerConstructor = document.defaultView?.AbortController ?? AbortController;
+  const controller = new AbortControllerConstructor();
+  const options = { capture: true, signal: controller.signal };
+  document.addEventListener(
+    "keydown",
+    (event) => {
+      if (event.key === "Escape") dispatch(document, "escape-key", event);
+    },
+    options
+  );
+  document.addEventListener(
+    "pointerdown",
+    (event) => dispatch(document, "outside-press", event),
+    options
+  );
+  document.addEventListener(
+    "focusin",
+    (event) => dispatch(document, "focus-outside", event),
+    options
+  );
+  return { controller, layers: [] };
+}
+function registerDismissableLayer(document, record) {
+  const registry = registries.get(document) ?? createRegistry(document);
+  registries.set(document, registry);
+  registry.layers.push(record);
+  return () => {
+    const index = registry.layers.indexOf(record);
+    if (index >= 0) registry.layers.splice(index, 1);
+    if (registry.layers.length === 0) {
+      registry.controller.abort();
+      registries.delete(document);
+    }
+  };
+}
+export {
+  registerDismissableLayer
+};
+//# sourceMappingURL=dismissable-layer-registry.js.map

package/dist/core/dismissable-layer-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/dismissable-layer-registry.ts"],"sourcesContent":["import type { OpenChangeReason } from \"./open-change-details.js\";\nimport { getEventPath, isEventInsideLayer } from \"./platform.js\";\n\nexport interface DismissableLayerRecord {\n  readonly branches: Set<Element>;\n  readonly element: Element;\n  readonly onDismiss: (reason: OpenChangeReason, event: Event) => void;\n}\n\ninterface Registry {\n  readonly controller: AbortController;\n  readonly layers: DismissableLayerRecord[];\n}\n\nconst registries = new WeakMap<Document, Registry>();\n\nfunction dispatch(document: Document, reason: OpenChangeReason, event: Event): void {\n  const record = registries.get(document)?.layers.at(-1);\n  if (!record) return;\n  if (\n    reason !== \"escape-key\" &&\n    isEventInsideLayer(getEventPath(event), record.element, record.branches)\n  ) {\n    return;\n  }\n  record.onDismiss(reason, event);\n}\n\nfunction createRegistry(document: Document): Registry {\n  const AbortControllerConstructor = document.defaultView?.AbortController ?? AbortController;\n  const controller = new AbortControllerConstructor();\n  const options = { capture: true, signal: controller.signal };\n  document.addEventListener(\n    \"keydown\",\n    (event) => {\n      if (event.key === \"Escape\") dispatch(document, \"escape-key\", event);\n    },\n    options,\n  );\n  document.addEventListener(\n    \"pointerdown\",\n    (event) => dispatch(document, \"outside-press\", event),\n    options,\n  );\n  document.addEventListener(\n    \"focusin\",\n    (event) => dispatch(document, \"focus-outside\", event),\n    options,\n  );\n  return { controller, layers: [] };\n}\n\nexport function registerDismissableLayer(\n  document: Document,\n  record: DismissableLayerRecord,\n): () => void {\n  const registry = registries.get(document) ?? createRegistry(document);\n  registries.set(document, registry);\n  registry.layers.push(record);\n\n  return () => {\n    const index = registry.layers.indexOf(record);\n    if (index >= 0) registry.layers.splice(index, 1);\n    if (registry.layers.length === 0) {\n      registry.controller.abort();\n      registries.delete(document);\n    }\n  };\n}\n"],"mappings":"AACA,SAAS,cAAc,0BAA0B;AAajD,MAAM,aAAa,oBAAI,QAA4B;AAEnD,SAAS,SAAS,UAAoB,QAA0B,OAAoB;AAClF,QAAM,SAAS,WAAW,IAAI,QAAQ,GAAG,OAAO,GAAG,EAAE;AACrD,MAAI,CAAC,OAAQ;AACb,MACE,WAAW,gBACX,mBAAmB,aAAa,KAAK,GAAG,OAAO,SAAS,OAAO,QAAQ,GACvE;AACA;AAAA,EACF;AACA,SAAO,UAAU,QAAQ,KAAK;AAChC;AAEA,SAAS,eAAe,UAA8B;AACpD,QAAM,6BAA6B,SAAS,aAAa,mBAAmB;AAC5E,QAAM,aAAa,IAAI,2BAA2B;AAClD,QAAM,UAAU,EAAE,SAAS,MAAM,QAAQ,WAAW,OAAO;AAC3D,WAAS;AAAA,IACP;AAAA,IACA,CAAC,UAAU;AACT,UAAI,MAAM,QAAQ,SAAU,UAAS,UAAU,cAAc,KAAK;AAAA,IACpE;AAAA,IACA;AAAA,EACF;AACA,WAAS;AAAA,IACP;AAAA,IACA,CAAC,UAAU,SAAS,UAAU,iBAAiB,KAAK;AAAA,IACpD;AAAA,EACF;AACA,WAAS;AAAA,IACP;AAAA,IACA,CAAC,UAAU,SAAS,UAAU,iBAAiB,KAAK;AAAA,IACpD;AAAA,EACF;AACA,SAAO,EAAE,YAAY,QAAQ,CAAC,EAAE;AAClC;AAEO,SAAS,yBACd,UACA,QACY;AACZ,QAAM,WAAW,WAAW,IAAI,QAAQ,KAAK,eAAe,QAAQ;AACpE,aAAW,IAAI,UAAU,QAAQ;AACjC,WAAS,OAAO,KAAK,MAAM;AAE3B,SAAO,MAAM;AACX,UAAM,QAAQ,SAAS,OAAO,QAAQ,MAAM;AAC5C,QAAI,SAAS,EAAG,UAAS,OAAO,OAAO,OAAO,CAAC;AAC/C,QAAI,SAAS,OAAO,WAAW,GAAG;AAChC,eAAS,WAAW,MAAM;AAC1B,iBAAW,OAAO,QAAQ;AAAA,IAC5B;AAAA,EACF;AACF;","names":[]}

package/dist/core/dismissable-layer.d.ts

@@ -0,0 +1,12 @@
+import type { ElementType, ReactElement } from "react";
+import { type OpenChangeDetails } from "./open-change-details.js";
+import type { RenderableProps } from "./polymorphic.js";
+export interface DismissableLayerOwnProps {
+    readonly branches?: ReadonlySet<Element>;
+    readonly onDismiss?: (details: OpenChangeDetails) => void;
+}
+export type DismissableLayerProps<TAs extends ElementType = "div"> = RenderableProps<TAs, DismissableLayerOwnProps, {
+    active: boolean;
+}, HTMLElement>;
+export declare function DismissableLayer<TAs extends ElementType = "div">(props: DismissableLayerProps<TAs>): ReactElement | null;
+//# sourceMappingURL=dismissable-layer.d.ts.map

package/dist/core/dismissable-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismissable-layer.d.ts","sourceRoot":"","sources":["../../src/core/dismissable-layer.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAO,MAAM,OAAO,CAAC;AAG5D,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIxD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,MAAM,qBAAqB,CAAC,GAAG,SAAS,WAAW,GAAG,KAAK,IAAI,eAAe,CAClF,GAAG,EACH,wBAAwB,EACxB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,EACnB,WAAW,CACZ,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,GAAG,SAAS,WAAW,GAAG,KAAK,EAC9D,KAAK,EAAE,qBAAqB,CAAC,GAAG,CAAC,GAChC,YAAY,GAAG,IAAI,CAoCrB"}

package/dist/core/dismissable-layer.js

@@ -0,0 +1,48 @@
+"use client";
+import { useRef } from "react";
+import { useEventCallback, useIsomorphicLayoutEffect, useMergedRefs } from "@gunkin/uiify/hooks";
+import { registerDismissableLayer } from "./dismissable-layer-registry.js";
+import {
+  createOpenChangeDetails
+} from "./open-change-details.js";
+import { getOwnerDocument } from "./platform.js";
+import { useRenderElement } from "./use-render-element.js";
+function DismissableLayer(props) {
+  const {
+    as,
+    branches,
+    onDismiss,
+    ref: consumerRef,
+    render,
+    ...consumerProps
+  } = props;
+  const elementRef = useRef(null);
+  const mergedRef = useMergedRefs(elementRef, consumerRef);
+  const emitDismiss = useEventCallback((reason, event) => {
+    onDismiss?.(createOpenChangeDetails(reason, event));
+  });
+  useIsomorphicLayoutEffect(() => {
+    const element = elementRef.current;
+    const document = getOwnerDocument(element);
+    if (!element || !document) return;
+    return registerDismissableLayer(document, {
+      branches: new Set(branches),
+      element,
+      onDismiss: emitDismiss
+    });
+  }, [branches, emitDismiss]);
+  return useRenderElement({
+    as,
+    defaultTag: "div",
+    props: {
+      ...consumerProps,
+      ref: mergedRef
+    },
+    render,
+    state: { active: true }
+  });
+}
+export {
+  DismissableLayer
+};
+//# sourceMappingURL=dismissable-layer.js.map

package/dist/core/dismissable-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/dismissable-layer.tsx"],"sourcesContent":["\"use client\";\n\nimport { useRef } from \"react\";\nimport type { ElementType, ReactElement, Ref } from \"react\";\nimport { useEventCallback, useIsomorphicLayoutEffect, useMergedRefs } from \"@gunkin/uiify/hooks\";\nimport { registerDismissableLayer } from \"./dismissable-layer-registry.js\";\nimport {\n  createOpenChangeDetails,\n  type OpenChangeDetails,\n  type OpenChangeReason,\n} from \"./open-change-details.js\";\nimport type { RenderableProps } from \"./polymorphic.js\";\nimport { getOwnerDocument } from \"./platform.js\";\nimport { useRenderElement } from \"./use-render-element.js\";\n\nexport interface DismissableLayerOwnProps {\n  readonly branches?: ReadonlySet<Element>;\n  readonly onDismiss?: (details: OpenChangeDetails) => void;\n}\n\nexport type DismissableLayerProps<TAs extends ElementType = \"div\"> = RenderableProps<\n  TAs,\n  DismissableLayerOwnProps,\n  { active: boolean },\n  HTMLElement\n>;\n\nexport function DismissableLayer<TAs extends ElementType = \"div\">(\n  props: DismissableLayerProps<TAs>,\n): ReactElement | null {\n  const {\n    as,\n    branches,\n    onDismiss,\n    ref: consumerRef,\n    render,\n    ...consumerProps\n  } = props as DismissableLayerProps<ElementType> & { ref?: Ref<HTMLElement> };\n  const elementRef = useRef<HTMLElement | null>(null);\n  const mergedRef = useMergedRefs(elementRef, consumerRef);\n  const emitDismiss = useEventCallback((reason: OpenChangeReason, event: Event) => {\n    onDismiss?.(createOpenChangeDetails(reason, event));\n  });\n\n  useIsomorphicLayoutEffect(() => {\n    const element = elementRef.current;\n    const document = getOwnerDocument(element);\n    if (!element || !document) return;\n    return registerDismissableLayer(document, {\n      branches: new Set(branches),\n      element,\n      onDismiss: emitDismiss,\n    });\n  }, [branches, emitDismiss]);\n\n  return useRenderElement({\n    as,\n    defaultTag: \"div\",\n    props: {\n      ...consumerProps,\n      ref: mergedRef,\n    },\n    render,\n    state: { active: true },\n  });\n}\n"],"mappings":";AAEA,SAAS,cAAc;AAEvB,SAAS,kBAAkB,2BAA2B,qBAAqB;AAC3E,SAAS,gCAAgC;AACzC;AAAA,EACE;AAAA,OAGK;AAEP,SAAS,wBAAwB;AACjC,SAAS,wBAAwB;AAc1B,SAAS,iBACd,OACqB;AACrB,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA,KAAK;AAAA,IACL;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,QAAM,aAAa,OAA2B,IAAI;AAClD,QAAM,YAAY,cAAc,YAAY,WAAW;AACvD,QAAM,cAAc,iBAAiB,CAAC,QAA0B,UAAiB;AAC/E,gBAAY,wBAAwB,QAAQ,KAAK,CAAC;AAAA,EACpD,CAAC;AAED,4BAA0B,MAAM;AAC9B,UAAM,UAAU,WAAW;AAC3B,UAAM,WAAW,iBAAiB,OAAO;AACzC,QAAI,CAAC,WAAW,CAAC,SAAU;AAC3B,WAAO,yBAAyB,UAAU;AAAA,MACxC,UAAU,IAAI,IAAI,QAAQ;AAAA,MAC1B;AAAA,MACA,WAAW;AAAA,IACb,CAAC;AAAA,EACH,GAAG,CAAC,UAAU,WAAW,CAAC;AAE1B,SAAO,iBAAiB;AAAA,IACtB;AAAA,IACA,YAAY;AAAA,IACZ,OAAO;AAAA,MACL,GAAG;AAAA,MACH,KAAK;AAAA,IACP;AAAA,IACA;AAAA,IACA,OAAO,EAAE,QAAQ,KAAK;AAAA,EACxB,CAAC;AACH;","names":[]}

package/dist/core/dom-order.d.ts

@@ -0,0 +1,3 @@
+/** Sort items by their associated element's document order. */
+export declare function sortByDocumentOrder<T>(items: Iterable<T>, getElement: (item: T) => Element | null): T[];
+//# sourceMappingURL=dom-order.d.ts.map

package/dist/core/dom-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-order.d.ts","sourceRoot":"","sources":["../../src/core/dom-order.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAClB,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,GACtC,CAAC,EAAE,CAQL"}

package/dist/core/dom-order.js

@@ -0,0 +1,13 @@
+function sortByDocumentOrder(items, getElement) {
+  return [...items].sort((left, right) => {
+    const leftElement = getElement(left);
+    const rightElement = getElement(right);
+    if (!leftElement || !rightElement || leftElement === rightElement) return 0;
+    const position = leftElement.compareDocumentPosition(rightElement);
+    return position & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1;
+  });
+}
+export {
+  sortByDocumentOrder
+};
+//# sourceMappingURL=dom-order.js.map

package/dist/core/dom-order.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/dom-order.ts"],"sourcesContent":["/** Sort items by their associated element's document order. */\nexport function sortByDocumentOrder<T>(\n  items: Iterable<T>,\n  getElement: (item: T) => Element | null,\n): T[] {\n  return [...items].sort((left, right) => {\n    const leftElement = getElement(left);\n    const rightElement = getElement(right);\n    if (!leftElement || !rightElement || leftElement === rightElement) return 0;\n    const position = leftElement.compareDocumentPosition(rightElement);\n    return position & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1;\n  });\n}\n"],"mappings":"AACO,SAAS,oBACd,OACA,YACK;AACL,SAAO,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,UAAU;AACtC,UAAM,cAAc,WAAW,IAAI;AACnC,UAAM,eAAe,WAAW,KAAK;AACrC,QAAI,CAAC,eAAe,CAAC,gBAAgB,gBAAgB,aAAc,QAAO;AAC1E,UAAM,WAAW,YAAY,wBAAwB,YAAY;AACjE,WAAO,WAAW,KAAK,8BAA8B,KAAK;AAAA,EAC5D,CAAC;AACH;","names":[]}

package/dist/core/focus-scope.d.ts

@@ -0,0 +1,14 @@
+import type { ElementType, ReactElement } from "react";
+import type { RenderableProps } from "./polymorphic.js";
+export interface FocusScopeOwnProps {
+    readonly branches?: ReadonlySet<Element>;
+    readonly contain?: boolean;
+    readonly loop?: boolean;
+    readonly onMountAutoFocus?: (event: Event) => void;
+    readonly onUnmountAutoFocus?: (event: Event) => void;
+}
+export type FocusScopeProps<TAs extends ElementType = "div"> = RenderableProps<TAs, FocusScopeOwnProps, {
+    active: boolean;
+}, HTMLElement>;
+export declare function FocusScope<TAs extends ElementType = "div">(props: FocusScopeProps<TAs>): ReactElement | null;
+//# sourceMappingURL=focus-scope.d.ts.map

package/dist/core/focus-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-scope.d.ts","sourceRoot":"","sources":["../../src/core/focus-scope.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAuC,YAAY,EAAO,MAAM,OAAO,CAAC;AAGjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAoBxD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,MAAM,eAAe,CAAC,GAAG,SAAS,WAAW,GAAG,KAAK,IAAI,eAAe,CAC5E,GAAG,EACH,kBAAkB,EAClB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,EACnB,WAAW,CACZ,CAAC;AAEF,wBAAgB,UAAU,CAAC,GAAG,SAAS,WAAW,GAAG,KAAK,EACxD,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,GAC1B,YAAY,GAAG,IAAI,CA6FrB"}

package/dist/core/focus-scope.js

@@ -0,0 +1,104 @@
+"use client";
+import { useRef } from "react";
+import { useEventCallback, useIsomorphicLayoutEffect, useMergedRefs } from "@gunkin/uiify/hooks";
+import { composeEventHandlers } from "./compose-event-handlers.js";
+import { getEventPath, getOwnerDocument, isEventInsideLayer } from "./platform.js";
+import { getTabbableCandidates } from "./tabbable.js";
+import { useRenderElement } from "./use-render-element.js";
+const stacks = /* @__PURE__ */ new WeakMap();
+function getStack(document) {
+  const existing = stacks.get(document);
+  if (existing) return existing;
+  const created = [];
+  stacks.set(document, created);
+  return created;
+}
+function FocusScope(props) {
+  const {
+    as,
+    branches,
+    contain = true,
+    loop = true,
+    onKeyDown: consumerOnKeyDown,
+    onMountAutoFocus,
+    onUnmountAutoFocus,
+    ref: consumerRef,
+    render,
+    ...consumerProps
+  } = props;
+  const elementRef = useRef(null);
+  const emitMountAutoFocus = useEventCallback((event) => {
+    onMountAutoFocus?.(event);
+  });
+  const emitUnmountAutoFocus = useEventCallback((event) => {
+    onUnmountAutoFocus?.(event);
+  });
+  const mergedRef = useMergedRefs(elementRef, consumerRef);
+  useIsomorphicLayoutEffect(() => {
+    const element = elementRef.current;
+    const document = getOwnerDocument(element);
+    if (!element || !document) return;
+    const previouslyFocused = document.activeElement;
+    const record = { branches: new Set(branches), element };
+    const stack = getStack(document);
+    stack.push(record);
+    const mountEvent = new Event("ui.mountAutoFocus", { cancelable: true });
+    emitMountAutoFocus(mountEvent);
+    if (!mountEvent.defaultPrevented && !element.contains(document.activeElement)) {
+      (getTabbableCandidates(element)[0] ?? element).focus({ preventScroll: true });
+    }
+    const onFocusIn = (event) => {
+      if (!contain || stack.at(-1) !== record) return;
+      if (isEventInsideLayer(getEventPath(event), element, record.branches)) {
+        return;
+      }
+      (getTabbableCandidates(element)[0] ?? element).focus({ preventScroll: true });
+    };
+    document.addEventListener("focusin", onFocusIn);
+    return () => {
+      document.removeEventListener("focusin", onFocusIn);
+      const index = stack.indexOf(record);
+      if (index >= 0) stack.splice(index, 1);
+      const unmountEvent = new Event("ui.unmountAutoFocus", { cancelable: true });
+      emitUnmountAutoFocus(unmountEvent);
+      if (!unmountEvent.defaultPrevented && previouslyFocused?.isConnected) {
+        queueMicrotask(() => {
+          if (previouslyFocused.isConnected) {
+            previouslyFocused.focus({ preventScroll: true });
+          }
+        });
+      }
+    };
+  }, [branches, contain, emitMountAutoFocus, emitUnmountAutoFocus]);
+  function handleKeyDown(event) {
+    if (!loop || event.key !== "Tab") return;
+    const element = elementRef.current;
+    if (!element) return;
+    const candidates = getTabbableCandidates(element);
+    const first = candidates[0];
+    const last = candidates.at(-1);
+    if (event.shiftKey && event.target === first) {
+      event.preventDefault();
+      last?.focus();
+    } else if (!event.shiftKey && event.target === last) {
+      event.preventDefault();
+      first?.focus();
+    }
+  }
+  return useRenderElement({
+    as,
+    defaultTag: "div",
+    props: {
+      ...consumerProps,
+      onKeyDown: composeEventHandlers(consumerOnKeyDown, handleKeyDown),
+      ref: mergedRef,
+      tabIndex: -1
+    },
+    render,
+    state: { active: true }
+  });
+}
+export {
+  FocusScope
+};
+//# sourceMappingURL=focus-scope.js.map

package/dist/core/focus-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/focus-scope.tsx"],"sourcesContent":["\"use client\";\n\nimport { useRef } from \"react\";\nimport type { ElementType, KeyboardEvent as ReactKeyboardEvent, ReactElement, Ref } from \"react\";\nimport { useEventCallback, useIsomorphicLayoutEffect, useMergedRefs } from \"@gunkin/uiify/hooks\";\nimport { composeEventHandlers } from \"./compose-event-handlers.js\";\nimport type { RenderableProps } from \"./polymorphic.js\";\nimport { getEventPath, getOwnerDocument, isEventInsideLayer } from \"./platform.js\";\nimport { getTabbableCandidates } from \"./tabbable.js\";\nimport { useRenderElement } from \"./use-render-element.js\";\n\ninterface ScopeRecord {\n  readonly branches: Set<Element>;\n  readonly element: HTMLElement;\n}\n\nconst stacks = new WeakMap<Document, ScopeRecord[]>();\n\nfunction getStack(document: Document): ScopeRecord[] {\n  const existing = stacks.get(document);\n  if (existing) return existing;\n  const created: ScopeRecord[] = [];\n  stacks.set(document, created);\n  return created;\n}\n\nexport interface FocusScopeOwnProps {\n  readonly branches?: ReadonlySet<Element>;\n  readonly contain?: boolean;\n  readonly loop?: boolean;\n  readonly onMountAutoFocus?: (event: Event) => void;\n  readonly onUnmountAutoFocus?: (event: Event) => void;\n}\n\nexport type FocusScopeProps<TAs extends ElementType = \"div\"> = RenderableProps<\n  TAs,\n  FocusScopeOwnProps,\n  { active: boolean },\n  HTMLElement\n>;\n\nexport function FocusScope<TAs extends ElementType = \"div\">(\n  props: FocusScopeProps<TAs>,\n): ReactElement | null {\n  const {\n    as,\n    branches,\n    contain = true,\n    loop = true,\n    onKeyDown: consumerOnKeyDown,\n    onMountAutoFocus,\n    onUnmountAutoFocus,\n    ref: consumerRef,\n    render,\n    ...consumerProps\n  } = props as FocusScopeProps<ElementType> & {\n    onKeyDown?: (event: ReactKeyboardEvent<HTMLElement>) => void;\n    ref?: Ref<HTMLElement>;\n  };\n  const elementRef = useRef<HTMLElement | null>(null);\n  const emitMountAutoFocus = useEventCallback((event: Event) => {\n    onMountAutoFocus?.(event);\n  });\n  const emitUnmountAutoFocus = useEventCallback((event: Event) => {\n    onUnmountAutoFocus?.(event);\n  });\n  const mergedRef = useMergedRefs(elementRef, consumerRef);\n\n  useIsomorphicLayoutEffect(() => {\n    const element = elementRef.current;\n    const document = getOwnerDocument(element);\n    if (!element || !document) return;\n    const previouslyFocused = document.activeElement as HTMLElement | null;\n    const record: ScopeRecord = { branches: new Set(branches), element };\n    const stack = getStack(document);\n    stack.push(record);\n\n    const mountEvent = new Event(\"ui.mountAutoFocus\", { cancelable: true });\n    emitMountAutoFocus(mountEvent);\n    if (!mountEvent.defaultPrevented && !element.contains(document.activeElement)) {\n      (getTabbableCandidates(element)[0] ?? element).focus({ preventScroll: true });\n    }\n\n    const onFocusIn = (event: FocusEvent) => {\n      if (!contain || stack.at(-1) !== record) return;\n      if (isEventInsideLayer(getEventPath(event), element, record.branches)) {\n        return;\n      }\n      (getTabbableCandidates(element)[0] ?? element).focus({ preventScroll: true });\n    };\n    document.addEventListener(\"focusin\", onFocusIn);\n\n    return () => {\n      document.removeEventListener(\"focusin\", onFocusIn);\n      const index = stack.indexOf(record);\n      if (index >= 0) stack.splice(index, 1);\n      const unmountEvent = new Event(\"ui.unmountAutoFocus\", { cancelable: true });\n      emitUnmountAutoFocus(unmountEvent);\n      if (!unmountEvent.defaultPrevented && previouslyFocused?.isConnected) {\n        queueMicrotask(() => {\n          if (previouslyFocused.isConnected) {\n            previouslyFocused.focus({ preventScroll: true });\n          }\n        });\n      }\n    };\n  }, [branches, contain, emitMountAutoFocus, emitUnmountAutoFocus]);\n\n  function handleKeyDown(event: ReactKeyboardEvent<HTMLElement>) {\n    if (!loop || event.key !== \"Tab\") return;\n    const element = elementRef.current;\n    if (!element) return;\n    const candidates = getTabbableCandidates(element);\n    const first = candidates[0];\n    const last = candidates.at(-1);\n    if (event.shiftKey && event.target === first) {\n      event.preventDefault();\n      last?.focus();\n    } else if (!event.shiftKey && event.target === last) {\n      event.preventDefault();\n      first?.focus();\n    }\n  }\n\n  return useRenderElement({\n    as,\n    defaultTag: \"div\",\n    props: {\n      ...consumerProps,\n      onKeyDown: composeEventHandlers(consumerOnKeyDown, handleKeyDown),\n      ref: mergedRef,\n      tabIndex: -1,\n    },\n    render,\n    state: { active: true },\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/core/hover-intent-store.d.ts

@@ -0,0 +1,22 @@
+export interface HoverIntentOptions {
+    readonly closeDelay: number;
+    readonly openDelay: number;
+}
+export interface HoverIntentStore {
+    readonly clearAll: () => void;
+    readonly clearCloseTimer: () => void;
+    readonly clearOpenTimer: () => void;
+    readonly scheduleClose: (callback: () => void, delayMs?: number) => void;
+    readonly scheduleOpen: (callback: () => void, delayMs?: number) => void;
+    readonly updateOptions: (next: HoverIntentOptions) => void;
+}
+/**
+ * Open/close intent timers for hover-driven surfaces (Tooltip, HoverCard,
+ * DropdownMenu). Framework-agnostic on purpose: the React parts own the
+ * lifecycle, this owns only the two timers.
+ *
+ * A non-positive delay runs the callback synchronously — pointer handlers rely
+ * on the surface being open by the time they return.
+ */
+export declare function createHoverIntentStore(initial: HoverIntentOptions): HoverIntentStore;
+//# sourceMappingURL=hover-intent-store.d.ts.map

package/dist/core/hover-intent-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover-intent-store.d.ts","sourceRoot":"","sources":["../../src/core/hover-intent-store.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxE,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC5D;AAID;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,gBAAgB,CAoDpF"}

package/dist/core/hover-intent-store.js

@@ -0,0 +1,54 @@
+function createHoverIntentStore(initial) {
+  let options = initial;
+  let openTimer = null;
+  let closeTimer = null;
+  function clearOpenTimer() {
+    if (openTimer !== null) {
+      clearTimeout(openTimer);
+      openTimer = null;
+    }
+  }
+  function clearCloseTimer() {
+    if (closeTimer !== null) {
+      clearTimeout(closeTimer);
+      closeTimer = null;
+    }
+  }
+  return {
+    clearAll() {
+      clearOpenTimer();
+      clearCloseTimer();
+    },
+    clearCloseTimer,
+    clearOpenTimer,
+    scheduleClose(callback, delayMs = options.closeDelay) {
+      clearCloseTimer();
+      if (delayMs <= 0) {
+        callback();
+        return;
+      }
+      closeTimer = setTimeout(() => {
+        closeTimer = null;
+        callback();
+      }, delayMs);
+    },
+    scheduleOpen(callback, delayMs = options.openDelay) {
+      clearOpenTimer();
+      if (delayMs <= 0) {
+        callback();
+        return;
+      }
+      openTimer = setTimeout(() => {
+        openTimer = null;
+        callback();
+      }, delayMs);
+    },
+    updateOptions(next) {
+      options = next;
+    }
+  };
+}
+export {
+  createHoverIntentStore
+};
+//# sourceMappingURL=hover-intent-store.js.map

package/dist/core/hover-intent-store.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/hover-intent-store.ts"],"sourcesContent":["export interface HoverIntentOptions {\n  readonly closeDelay: number;\n  readonly openDelay: number;\n}\n\nexport interface HoverIntentStore {\n  readonly clearAll: () => void;\n  readonly clearCloseTimer: () => void;\n  readonly clearOpenTimer: () => void;\n  readonly scheduleClose: (callback: () => void, delayMs?: number) => void;\n  readonly scheduleOpen: (callback: () => void, delayMs?: number) => void;\n  readonly updateOptions: (next: HoverIntentOptions) => void;\n}\n\ntype Timer = ReturnType<typeof setTimeout> | null;\n\n/**\n * Open/close intent timers for hover-driven surfaces (Tooltip, HoverCard,\n * DropdownMenu). Framework-agnostic on purpose: the React parts own the\n * lifecycle, this owns only the two timers.\n *\n * A non-positive delay runs the callback synchronously — pointer handlers rely\n * on the surface being open by the time they return.\n */\nexport function createHoverIntentStore(initial: HoverIntentOptions): HoverIntentStore {\n  let options = initial;\n  let openTimer: Timer = null;\n  let closeTimer: Timer = null;\n\n  function clearOpenTimer(): void {\n    if (openTimer !== null) {\n      clearTimeout(openTimer);\n      openTimer = null;\n    }\n  }\n\n  function clearCloseTimer(): void {\n    if (closeTimer !== null) {\n      clearTimeout(closeTimer);\n      closeTimer = null;\n    }\n  }\n\n  return {\n    clearAll() {\n      clearOpenTimer();\n      clearCloseTimer();\n    },\n    clearCloseTimer,\n    clearOpenTimer,\n    scheduleClose(callback, delayMs = options.closeDelay) {\n      clearCloseTimer();\n      if (delayMs <= 0) {\n        callback();\n        return;\n      }\n      closeTimer = setTimeout(() => {\n        closeTimer = null;\n        callback();\n      }, delayMs);\n    },\n    scheduleOpen(callback, delayMs = options.openDelay) {\n      clearOpenTimer();\n      if (delayMs <= 0) {\n        callback();\n        return;\n      }\n      openTimer = setTimeout(() => {\n        openTimer = null;\n        callback();\n      }, delayMs);\n    },\n    updateOptions(next) {\n      options = next;\n    },\n  };\n}\n"],"mappings":"AAwBO,SAAS,uBAAuB,SAA+C;AACpF,MAAI,UAAU;AACd,MAAI,YAAmB;AACvB,MAAI,aAAoB;AAExB,WAAS,iBAAuB;AAC9B,QAAI,cAAc,MAAM;AACtB,mBAAa,SAAS;AACtB,kBAAY;AAAA,IACd;AAAA,EACF;AAEA,WAAS,kBAAwB;AAC/B,QAAI,eAAe,MAAM;AACvB,mBAAa,UAAU;AACvB,mBAAa;AAAA,IACf;AAAA,EACF;AAEA,SAAO;AAAA,IACL,WAAW;AACT,qBAAe;AACf,sBAAgB;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc,UAAU,UAAU,QAAQ,YAAY;AACpD,sBAAgB;AAChB,UAAI,WAAW,GAAG;AAChB,iBAAS;AACT;AAAA,MACF;AACA,mBAAa,WAAW,MAAM;AAC5B,qBAAa;AACb,iBAAS;AAAA,MACX,GAAG,OAAO;AAAA,IACZ;AAAA,IACA,aAAa,UAAU,UAAU,QAAQ,WAAW;AAClD,qBAAe;AACf,UAAI,WAAW,GAAG;AAChB,iBAAS;AACT;AAAA,MACF;AACA,kBAAY,WAAW,MAAM;AAC3B,oBAAY;AACZ,iBAAS;AAAA,MACX,GAAG,OAAO;AAAA,IACZ;AAAA,IACA,cAAc,MAAM;AAClB,gBAAU;AAAA,IACZ;AAAA,EACF;AACF;","names":[]}

package/dist/core/hover-overlay.d.ts

@@ -0,0 +1,35 @@
+import { type HoverIntentStore } from "./hover-intent-store.js";
+import type { PopoverChangeHandler } from "./popover.js";
+export interface UseHoverOverlayOptions {
+    readonly closeDelay: number;
+    readonly defaultOpen?: boolean;
+    readonly id?: string;
+    readonly idPrefix: string;
+    readonly onOpenChange?: PopoverChangeHandler;
+    /** Called after the overlay actually opened — Tooltip's provider records it for skip-delay. */
+    readonly onOpened?: () => void;
+    readonly open?: boolean;
+    readonly openDelay: number;
+    /** When it returns true the open delay is skipped — Tooltip's group behavior. */
+    readonly shouldSkipDelay?: () => boolean;
+}
+export interface UseHoverOverlayReturn {
+    readonly anchorId: string;
+    readonly closeOverlay: () => void;
+    readonly contentId: string;
+    readonly intent: HoverIntentStore;
+    readonly open: boolean;
+    readonly openOverlay: (immediate?: boolean) => void;
+    readonly setContentId: (id: string) => void;
+}
+/**
+ * Shared body of TooltipRoot and HoverCardRoot: controllable open state, a
+ * hover-intent timer pair, and a content id that a Content part can override.
+ *
+ * Tooltip's group skip-delay (several tooltips sharing one Provider) has no
+ * equivalent in HoverCard, so it is not part of this contract — the two hooks
+ * (`shouldSkipDelay`, `onOpened`) are how Tooltip's Provider plugs in without
+ * adding a Tooltip-specific concept to the primitive itself.
+ */
+export declare function useHoverOverlay(options: UseHoverOverlayOptions): UseHoverOverlayReturn;
+//# sourceMappingURL=hover-overlay.d.ts.map

package/dist/core/hover-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover-overlay.d.ts","sourceRoot":"","sources":["../../src/core/hover-overlay.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAExF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAC7C,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,QAAQ,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CA+DtF"}

package/dist/core/hover-overlay.js

@@ -0,0 +1,66 @@
+"use client";
+import { useCallback, useRef, useState } from "react";
+import { useControllableState, useId, useIsomorphicLayoutEffect } from "@gunkin/uiify/hooks";
+import { createHoverIntentStore } from "./hover-intent-store.js";
+import { emitProgrammaticOpenChange } from "./open-change-details.js";
+function useHoverOverlay(options) {
+  const {
+    closeDelay,
+    defaultOpen = false,
+    id,
+    idPrefix,
+    onOpenChange,
+    onOpened,
+    open,
+    openDelay,
+    shouldSkipDelay
+  } = options;
+  const generatedId = useId(id, idPrefix);
+  const [resolvedOpen, setResolvedOpen] = useControllableState({
+    defaultValue: defaultOpen,
+    ...onOpenChange ? { onChange: (next) => emitProgrammaticOpenChange(onOpenChange, next) } : {},
+    ...open !== void 0 ? { value: open } : {}
+  });
+  const [contentId, setContentId] = useState(`${generatedId}-content`);
+  const intentRef = useRef(null);
+  intentRef.current ??= createHoverIntentStore({ closeDelay, openDelay });
+  useIsomorphicLayoutEffect(() => {
+    intentRef.current?.updateOptions({ closeDelay, openDelay });
+  }, [closeDelay, openDelay]);
+  const openOverlay = useCallback(
+    (immediate = false) => {
+      const intent = intentRef.current;
+      if (!intent) return;
+      intent.clearCloseTimer();
+      const delay = immediate || (shouldSkipDelay?.() ?? false) ? 0 : openDelay;
+      intent.scheduleOpen(() => {
+        setResolvedOpen(true);
+        onOpened?.();
+      }, delay);
+    },
+    [onOpened, openDelay, setResolvedOpen, shouldSkipDelay]
+  );
+  const closeOverlay = useCallback(() => {
+    intentRef.current?.clearAll();
+    setResolvedOpen(false);
+  }, [setResolvedOpen]);
+  useIsomorphicLayoutEffect(
+    () => () => {
+      intentRef.current?.clearAll();
+    },
+    []
+  );
+  return {
+    anchorId: generatedId,
+    closeOverlay,
+    contentId,
+    intent: intentRef.current,
+    open: resolvedOpen,
+    openOverlay,
+    setContentId
+  };
+}
+export {
+  useHoverOverlay
+};
+//# sourceMappingURL=hover-overlay.js.map

package/dist/core/hover-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/hover-overlay.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useRef, useState } from \"react\";\nimport { useControllableState, useId, useIsomorphicLayoutEffect } from \"@gunkin/uiify/hooks\";\nimport { createHoverIntentStore, type HoverIntentStore } from \"./hover-intent-store.js\";\nimport { emitProgrammaticOpenChange } from \"./open-change-details.js\";\nimport type { PopoverChangeHandler } from \"./popover.js\";\n\nexport interface UseHoverOverlayOptions {\n  readonly closeDelay: number;\n  readonly defaultOpen?: boolean;\n  readonly id?: string;\n  readonly idPrefix: string;\n  readonly onOpenChange?: PopoverChangeHandler;\n  /** Called after the overlay actually opened — Tooltip's provider records it for skip-delay. */\n  readonly onOpened?: () => void;\n  readonly open?: boolean;\n  readonly openDelay: number;\n  /** When it returns true the open delay is skipped — Tooltip's group behavior. */\n  readonly shouldSkipDelay?: () => boolean;\n}\n\nexport interface UseHoverOverlayReturn {\n  readonly anchorId: string;\n  readonly closeOverlay: () => void;\n  readonly contentId: string;\n  readonly intent: HoverIntentStore;\n  readonly open: boolean;\n  readonly openOverlay: (immediate?: boolean) => void;\n  readonly setContentId: (id: string) => void;\n}\n\n/**\n * Shared body of TooltipRoot and HoverCardRoot: controllable open state, a\n * hover-intent timer pair, and a content id that a Content part can override.\n *\n * Tooltip's group skip-delay (several tooltips sharing one Provider) has no\n * equivalent in HoverCard, so it is not part of this contract — the two hooks\n * (`shouldSkipDelay`, `onOpened`) are how Tooltip's Provider plugs in without\n * adding a Tooltip-specific concept to the primitive itself.\n */\nexport function useHoverOverlay(options: UseHoverOverlayOptions): UseHoverOverlayReturn {\n  const {\n    closeDelay,\n    defaultOpen = false,\n    id,\n    idPrefix,\n    onOpenChange,\n    onOpened,\n    open,\n    openDelay,\n    shouldSkipDelay,\n  } = options;\n  const generatedId = useId(id, idPrefix);\n  const [resolvedOpen, setResolvedOpen] = useControllableState<boolean>({\n    defaultValue: defaultOpen,\n    ...(onOpenChange\n      ? { onChange: (next: boolean) => emitProgrammaticOpenChange(onOpenChange, next) }\n      : {}),\n    ...(open !== undefined ? { value: open } : {}),\n  });\n  const [contentId, setContentId] = useState(`${generatedId}-content`);\n  const intentRef = useRef<HoverIntentStore | null>(null);\n  intentRef.current ??= createHoverIntentStore({ closeDelay, openDelay });\n\n  useIsomorphicLayoutEffect(() => {\n    intentRef.current?.updateOptions({ closeDelay, openDelay });\n  }, [closeDelay, openDelay]);\n\n  const openOverlay = useCallback(\n    (immediate = false) => {\n      const intent = intentRef.current;\n      if (!intent) return;\n      intent.clearCloseTimer();\n      const delay = immediate || (shouldSkipDelay?.() ?? false) ? 0 : openDelay;\n      intent.scheduleOpen(() => {\n        setResolvedOpen(true);\n        onOpened?.();\n      }, delay);\n    },\n    [onOpened, openDelay, setResolvedOpen, shouldSkipDelay],\n  );\n\n  const closeOverlay = useCallback(() => {\n    intentRef.current?.clearAll();\n    setResolvedOpen(false);\n  }, [setResolvedOpen]);\n\n  useIsomorphicLayoutEffect(\n    () => () => {\n      intentRef.current?.clearAll();\n    },\n    [],\n  );\n\n  return {\n    anchorId: generatedId,\n    closeOverlay,\n    contentId,\n    intent: intentRef.current!,\n    open: resolvedOpen,\n    openOverlay,\n    setContentId,\n  };\n}\n"],"mappings":";AAEA,SAAS,aAAa,QAAQ,gBAAgB;AAC9C,SAAS,sBAAsB,OAAO,iCAAiC;AACvE,SAAS,8BAAqD;AAC9D,SAAS,kCAAkC;AAoCpC,SAAS,gBAAgB,SAAwD;AACtF,QAAM;AAAA,IACJ;AAAA,IACA,cAAc;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AACJ,QAAM,cAAc,MAAM,IAAI,QAAQ;AACtC,QAAM,CAAC,cAAc,eAAe,IAAI,qBAA8B;AAAA,IACpE,cAAc;AAAA,IACd,GAAI,eACA,EAAE,UAAU,CAAC,SAAkB,2BAA2B,cAAc,IAAI,EAAE,IAC9E,CAAC;AAAA,IACL,GAAI,SAAS,SAAY,EAAE,OAAO,KAAK,IAAI,CAAC;AAAA,EAC9C,CAAC;AACD,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,GAAG,WAAW,UAAU;AACnE,QAAM,YAAY,OAAgC,IAAI;AACtD,YAAU,YAAY,uBAAuB,EAAE,YAAY,UAAU,CAAC;AAEtE,4BAA0B,MAAM;AAC9B,cAAU,SAAS,cAAc,EAAE,YAAY,UAAU,CAAC;AAAA,EAC5D,GAAG,CAAC,YAAY,SAAS,CAAC;AAE1B,QAAM,cAAc;AAAA,IAClB,CAAC,YAAY,UAAU;AACrB,YAAM,SAAS,UAAU;AACzB,UAAI,CAAC,OAAQ;AACb,aAAO,gBAAgB;AACvB,YAAM,QAAQ,cAAc,kBAAkB,KAAK,SAAS,IAAI;AAChE,aAAO,aAAa,MAAM;AACxB,wBAAgB,IAAI;AACpB,mBAAW;AAAA,MACb,GAAG,KAAK;AAAA,IACV;AAAA,IACA,CAAC,UAAU,WAAW,iBAAiB,eAAe;AAAA,EACxD;AAEA,QAAM,eAAe,YAAY,MAAM;AACrC,cAAU,SAAS,SAAS;AAC5B,oBAAgB,KAAK;AAAA,EACvB,GAAG,CAAC,eAAe,CAAC;AAEpB;AAAA,IACE,MAAM,MAAM;AACV,gBAAU,SAAS,SAAS;AAAA,IAC9B;AAAA,IACA,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA,QAAQ,UAAU;AAAA,IAClB,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/core/index.d.ts

@@ -0,0 +1,21 @@
+export * from "./anchor-position.js";
+export * from "./collection.js";
+export * from "./compose-event-handlers.js";
+export * from "./create-part-context.js";
+export * from "./dialog.js";
+export * from "./direction.js";
+export * from "./dismissable-layer.js";
+export * from "./focus-scope.js";
+export * from "./hover-intent-store.js";
+export * from "./hover-overlay.js";
+export * from "./open-change-details.js";
+export * from "./platform.js";
+export * from "./popover.js";
+export * from "./portal.js";
+export * from "./presence.js";
+export * from "./render.js";
+export * from "./roving-focus.js";
+export * from "./split-ref.js";
+export * from "./tabbable.js";
+export * from "./visually-hidden.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,21 @@
+export * from "./anchor-position.js";
+export * from "./collection.js";
+export * from "./compose-event-handlers.js";
+export * from "./create-part-context.js";
+export * from "./dialog.js";
+export * from "./direction.js";
+export * from "./dismissable-layer.js";
+export * from "./focus-scope.js";
+export * from "./hover-intent-store.js";
+export * from "./hover-overlay.js";
+export * from "./open-change-details.js";
+export * from "./platform.js";
+export * from "./popover.js";
+export * from "./portal.js";
+export * from "./presence.js";
+export * from "./render.js";
+export * from "./roving-focus.js";
+export * from "./split-ref.js";
+export * from "./tabbable.js";
+export * from "./visually-hidden.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/index.ts"],"sourcesContent":["export * from \"./anchor-position.js\";\nexport * from \"./collection.js\";\nexport * from \"./compose-event-handlers.js\";\nexport * from \"./create-part-context.js\";\nexport * from \"./dialog.js\";\nexport * from \"./direction.js\";\nexport * from \"./dismissable-layer.js\";\nexport * from \"./focus-scope.js\";\nexport * from \"./hover-intent-store.js\";\nexport * from \"./hover-overlay.js\";\nexport * from \"./open-change-details.js\";\nexport * from \"./platform.js\";\nexport * from \"./popover.js\";\nexport * from \"./portal.js\";\nexport * from \"./presence.js\";\nexport * from \"./render.js\";\nexport * from \"./roving-focus.js\";\nexport * from \"./split-ref.js\";\nexport * from \"./tabbable.js\";\nexport * from \"./visually-hidden.js\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/core/open-change-details.d.ts

@@ -0,0 +1,15 @@
+export type OpenChangeReason = "trigger-press" | "escape-key" | "outside-press" | "focus-outside" | "native-toggle" | "programmatic";
+export interface OpenChangeDetails {
+    readonly event: Event | null;
+    readonly isCanceled: boolean;
+    readonly reason: OpenChangeReason;
+    cancel(): void;
+}
+export declare function createOpenChangeDetails(reason: OpenChangeReason, event?: Event | null): OpenChangeDetails;
+/**
+ * Fire a consumer `onOpenChange` for a change the library made itself: no DOM
+ * event, nothing to cancel. Lifted verbatim from the byte-identical copies in
+ * Tooltip and HoverCard.
+ */
+export declare function emitProgrammaticOpenChange(onOpenChange: ((next: boolean, details: OpenChangeDetails) => void) | undefined, next: boolean): void;
+//# sourceMappingURL=open-change-details.d.ts.map

package/dist/core/open-change-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-change-details.d.ts","sourceRoot":"","sources":["../../src/core/open-change-details.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,YAAY,GACZ,eAAe,GACf,eAAe,GACf,eAAe,GACf,cAAc,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,KAAK,GAAE,KAAK,GAAG,IAAW,GACzB,iBAAiB,CAYnB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC,GAAG,SAAS,EAC/E,IAAI,EAAE,OAAO,GACZ,IAAI,CAEN"}

package/dist/core/open-change-details.js

@@ -0,0 +1,21 @@
+function createOpenChangeDetails(reason, event = null) {
+  let canceled = false;
+  return {
+    event,
+    get isCanceled() {
+      return canceled;
+    },
+    reason,
+    cancel() {
+      canceled = true;
+    }
+  };
+}
+function emitProgrammaticOpenChange(onOpenChange, next) {
+  onOpenChange?.(next, createOpenChangeDetails("programmatic"));
+}
+export {
+  createOpenChangeDetails,
+  emitProgrammaticOpenChange
+};
+//# sourceMappingURL=open-change-details.js.map

package/dist/core/open-change-details.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/open-change-details.ts"],"sourcesContent":["export type OpenChangeReason =\n  | \"trigger-press\"\n  | \"escape-key\"\n  | \"outside-press\"\n  | \"focus-outside\"\n  | \"native-toggle\"\n  | \"programmatic\";\n\nexport interface OpenChangeDetails {\n  readonly event: Event | null;\n  readonly isCanceled: boolean;\n  readonly reason: OpenChangeReason;\n  cancel(): void;\n}\n\nexport function createOpenChangeDetails(\n  reason: OpenChangeReason,\n  event: Event | null = null,\n): OpenChangeDetails {\n  let canceled = false;\n  return {\n    event,\n    get isCanceled() {\n      return canceled;\n    },\n    reason,\n    cancel() {\n      canceled = true;\n    },\n  };\n}\n\n/**\n * Fire a consumer `onOpenChange` for a change the library made itself: no DOM\n * event, nothing to cancel. Lifted verbatim from the byte-identical copies in\n * Tooltip and HoverCard.\n */\nexport function emitProgrammaticOpenChange(\n  onOpenChange: ((next: boolean, details: OpenChangeDetails) => void) | undefined,\n  next: boolean,\n): void {\n  onOpenChange?.(next, createOpenChangeDetails(\"programmatic\"));\n}\n"],"mappings":"AAeO,SAAS,wBACd,QACA,QAAsB,MACH;AACnB,MAAI,WAAW;AACf,SAAO;AAAA,IACL;AAAA,IACA,IAAI,aAAa;AACf,aAAO;AAAA,IACT;AAAA,IACA;AAAA,IACA,SAAS;AACP,iBAAW;AAAA,IACb;AAAA,EACF;AACF;AAOO,SAAS,2BACd,cACA,MACM;AACN,iBAAe,MAAM,wBAAwB,cAAc,CAAC;AAC9D;","names":[]}