@zag-js/popover 0.2.5 → 0.2.6

package/dist/chunk-3IPU3K2L.mjs

@@ -0,0 +1,191 @@
+// ../../utilities/core/src/functions.ts
+var runIfFn = (v, ...a) => {
+  const res = typeof v === "function" ? v(...a) : v;
+  return res != null ? res : void 0;
+};
+
+// ../../utilities/dom/src/query.ts
+function isDocument(el) {
+  return el.nodeType === Node.DOCUMENT_NODE;
+}
+function isWindow(value) {
+  return (value == null ? void 0 : value.toString()) === "[object Window]";
+}
+function isFrame(element) {
+  return element.localName === "iframe";
+}
+function getDocument(el) {
+  var _a;
+  if (isWindow(el))
+    return el.document;
+  if (isDocument(el))
+    return el;
+  return (_a = el == null ? void 0 : el.ownerDocument) != null ? _a : document;
+}
+function defineDomHelpers(helpers) {
+  const dom2 = {
+    getRootNode: (ctx) => {
+      var _a, _b;
+      return (_b = (_a = ctx.getRootNode) == null ? void 0 : _a.call(ctx)) != null ? _b : document;
+    },
+    getDoc: (ctx) => getDocument(dom2.getRootNode(ctx)),
+    getWin: (ctx) => {
+      var _a;
+      return (_a = dom2.getDoc(ctx).defaultView) != null ? _a : window;
+    },
+    getActiveElement: (ctx) => dom2.getDoc(ctx).activeElement,
+    getById: (ctx, id) => dom2.getRootNode(ctx).getElementById(id),
+    createEmitter: (ctx, target) => {
+      const win = dom2.getWin(ctx);
+      return function emit(evt, detail, options) {
+        const { bubbles = true, cancelable, composed = true } = options != null ? options : {};
+        const eventName = `zag:${evt}`;
+        const init = { bubbles, cancelable, composed, detail };
+        const event = new win.CustomEvent(eventName, init);
+        target.dispatchEvent(event);
+      };
+    },
+    createListener: (target) => {
+      return function listen(evt, handler) {
+        const eventName = `zag:${evt}`;
+        const listener = (e) => handler(e);
+        target.addEventListener(eventName, listener);
+        return () => target.removeEventListener(eventName, listener);
+      };
+    }
+  };
+  return {
+    ...dom2,
+    ...helpers
+  };
+}
+function contains(parent, child) {
+  if (!parent)
+    return false;
+  return parent === child || isHTMLElement(parent) && isHTMLElement(child) && parent.contains(child);
+}
+function isHTMLElement(v) {
+  return typeof v === "object" && (v == null ? void 0 : v.nodeType) === Node.ELEMENT_NODE && typeof (v == null ? void 0 : v.nodeName) === "string";
+}
+function isVisible(el) {
+  if (!isHTMLElement(el))
+    return false;
+  return el.offsetWidth > 0 || el.offsetHeight > 0 || el.getClientRects().length > 0;
+}
+
+// ../../utilities/dom/src/focusable.ts
+function hasNegativeTabIndex(element) {
+  const tabIndex = parseInt(element.getAttribute("tabindex") || "0", 10);
+  return tabIndex < 0;
+}
+var focusableSelector = "input:not([type='hidden']):not([disabled]), select:not([disabled]), textarea:not([disabled]), a[href], button:not([disabled]), [tabindex], iframe, object, embed, area[href], audio[controls], video[controls], [contenteditable]:not([contenteditable='false']), details > summary:first-of-type";
+var getFocusables = (container, includeContainer = false) => {
+  if (!container)
+    return [];
+  const elements = Array.from(container.querySelectorAll(focusableSelector));
+  const include = includeContainer == true || includeContainer == "if-empty" && elements.length === 0;
+  if (include && isHTMLElement(container) && isFocusable(container)) {
+    elements.unshift(container);
+  }
+  const focusableElements = elements.filter(isFocusable);
+  focusableElements.forEach((element, i) => {
+    if (isFrame(element) && element.contentDocument) {
+      const frameBody = element.contentDocument.body;
+      focusableElements.splice(i, 1, ...getFocusables(frameBody));
+    }
+  });
+  return focusableElements;
+};
+function isFocusable(element) {
+  if (!element)
+    return false;
+  return element.matches(focusableSelector) && isVisible(element);
+}
+function getTabbables(container, includeContainer) {
+  if (!container)
+    return [];
+  const elements = Array.from(container.querySelectorAll(focusableSelector));
+  const tabbableElements = elements.filter(isTabbable);
+  if (includeContainer && isTabbable(container)) {
+    tabbableElements.unshift(container);
+  }
+  tabbableElements.forEach((element, i) => {
+    if (isFrame(element) && element.contentDocument) {
+      const frameBody = element.contentDocument.body;
+      const allFrameTabbable = getTabbables(frameBody);
+      tabbableElements.splice(i, 1, ...allFrameTabbable);
+    }
+  });
+  if (!tabbableElements.length && includeContainer) {
+    return elements;
+  }
+  return tabbableElements;
+}
+function isTabbable(el) {
+  return isFocusable(el) && !hasNegativeTabIndex(el);
+}
+function getFirstTabbable(container, includeContainer) {
+  const [first] = getTabbables(container, includeContainer);
+  return first || null;
+}
+function getLastTabbable(container, includeContainer) {
+  const elements = getTabbables(container, includeContainer);
+  return elements[elements.length - 1] || null;
+}
+
+// src/popover.dom.ts
+var dom = defineDomHelpers({
+  getActiveEl: (ctx) => dom.getDoc(ctx).activeElement,
+  getAnchorId: (ctx) => {
+    var _a, _b;
+    return (_b = (_a = ctx.ids) == null ? void 0 : _a.anchor) != null ? _b : `popover:${ctx.id}:anchor`;
+  },
+  getTriggerId: (ctx) => {
+    var _a, _b;
+    return (_b = (_a = ctx.ids) == null ? void 0 : _a.trigger) != null ? _b : `popover:${ctx.id}:trigger`;
+  },
+  getContentId: (ctx) => {
+    var _a, _b;
+    return (_b = (_a = ctx.ids) == null ? void 0 : _a.content) != null ? _b : `popover:${ctx.id}:content`;
+  },
+  getPositionerId: (ctx) => `popover:${ctx.id}:popper`,
+  getArrowId: (ctx) => `popover:${ctx.id}:arrow`,
+  getTitleId: (ctx) => {
+    var _a, _b;
+    return (_b = (_a = ctx.ids) == null ? void 0 : _a.title) != null ? _b : `popover:${ctx.id}:title`;
+  },
+  getDescriptionId: (ctx) => {
+    var _a, _b;
+    return (_b = (_a = ctx.ids) == null ? void 0 : _a.description) != null ? _b : `popover:${ctx.id}:desc`;
+  },
+  getCloseTriggerId: (ctx) => {
+    var _a, _b;
+    return (_b = (_a = ctx.ids) == null ? void 0 : _a.closeTrigger) != null ? _b : `popover:${ctx.id}:close`;
+  },
+  getAnchorEl: (ctx) => dom.getById(ctx, dom.getAnchorId(ctx)),
+  getTriggerEl: (ctx) => dom.getById(ctx, dom.getTriggerId(ctx)),
+  getContentEl: (ctx) => dom.getById(ctx, dom.getContentId(ctx)),
+  getPositionerEl: (ctx) => dom.getById(ctx, dom.getPositionerId(ctx)),
+  getTitleEl: (ctx) => dom.getById(ctx, dom.getTitleId(ctx)),
+  getDescriptionEl: (ctx) => dom.getById(ctx, dom.getDescriptionId(ctx)),
+  getFocusableEls: (ctx) => getFocusables(dom.getContentEl(ctx)),
+  getFirstFocusableEl: (ctx) => dom.getFocusableEls(ctx)[0],
+  getDocTabbableEls: (ctx) => getTabbables(dom.getDoc(ctx).body),
+  getTabbableEls: (ctx) => getTabbables(dom.getContentEl(ctx), "if-empty"),
+  getFirstTabbableEl: (ctx) => getFirstTabbable(dom.getContentEl(ctx), "if-empty"),
+  getLastTabbableEl: (ctx) => getLastTabbable(dom.getContentEl(ctx), "if-empty"),
+  getInitialFocusEl: (ctx) => {
+    let el = runIfFn(ctx.initialFocusEl);
+    if (!el && ctx.autoFocus)
+      el = dom.getFirstFocusableEl(ctx);
+    if (!el)
+      el = dom.getContentEl(ctx);
+    return el;
+  }
+});
+
+export {
+  runIfFn,
+  contains,
+  dom
+};

package/dist/chunk-B4ONYBLM.mjs

@@ -0,0 +1,100 @@
+import {
+  parts
+} from "./chunk-KTOPDXGV.mjs";
+import {
+  dom
+} from "./chunk-3IPU3K2L.mjs";
+
+// ../../utilities/dom/src/attrs.ts
+var dataAttr = (guard) => {
+  return guard ? "" : void 0;
+};
+
+// src/popover.connect.ts
+import { getPlacementStyles } from "@zag-js/popper";
+function connect(state, send, normalize) {
+  const isOpen = state.matches("open");
+  const currentPlacement = state.context.currentPlacement;
+  const portalled = state.context.currentPortalled;
+  const rendered = state.context.renderedElements;
+  const popperStyles = getPlacementStyles({
+    measured: !!state.context.isPlacementComplete,
+    placement: currentPlacement
+  });
+  return {
+    portalled,
+    isOpen,
+    open() {
+      send("OPEN");
+    },
+    close() {
+      send("CLOSE");
+    },
+    arrowProps: normalize.element({
+      id: dom.getArrowId(state.context),
+      ...parts.arrow.attrs,
+      style: popperStyles.arrow
+    }),
+    arrowTipProps: normalize.element({
+      ...parts.arrowTip.attrs,
+      style: popperStyles.arrowTip
+    }),
+    anchorProps: normalize.element({
+      ...parts.anchor.attrs,
+      id: dom.getAnchorId(state.context)
+    }),
+    triggerProps: normalize.button({
+      ...parts.trigger.attrs,
+      type: "button",
+      "data-placement": currentPlacement,
+      id: dom.getTriggerId(state.context),
+      "aria-haspopup": "dialog",
+      "aria-expanded": isOpen,
+      "data-expanded": dataAttr(isOpen),
+      "aria-controls": dom.getContentId(state.context),
+      onClick() {
+        send("TOGGLE");
+      },
+      onBlur(event) {
+        send({ type: "TRIGGER_BLUR", target: event.relatedTarget });
+      }
+    }),
+    positionerProps: normalize.element({
+      id: dom.getPositionerId(state.context),
+      ...parts.positioner.attrs,
+      style: popperStyles.floating
+    }),
+    contentProps: normalize.element({
+      ...parts.content.attrs,
+      id: dom.getContentId(state.context),
+      tabIndex: -1,
+      role: "dialog",
+      hidden: !isOpen,
+      "data-expanded": dataAttr(isOpen),
+      "aria-labelledby": rendered.title ? dom.getTitleId(state.context) : void 0,
+      "aria-describedby": rendered.description ? dom.getDescriptionId(state.context) : void 0,
+      "data-placement": currentPlacement
+    }),
+    titleProps: normalize.element({
+      ...parts.title.attrs,
+      id: dom.getTitleId(state.context)
+    }),
+    descriptionProps: normalize.element({
+      ...parts.description.attrs,
+      id: dom.getDescriptionId(state.context)
+    }),
+    closeTriggerProps: normalize.button({
+      ...parts.closeTrigger.attrs,
+      id: dom.getCloseTriggerId(state.context),
+      type: "button",
+      "aria-label": "close",
+      onClick() {
+        send("REQUEST_CLOSE");
+      }
+    })
+  };
+}
+
+export {
+  connect
+};

package/dist/chunk-CHAXY3HY.mjs

@@ -0,0 +1,353 @@
+import {
+  contains,
+  dom,
+  runIfFn
+} from "./chunk-3IPU3K2L.mjs";
+
+// src/popover.machine.ts
+import { ariaHidden } from "@zag-js/aria-hidden";
+import { createMachine, guards } from "@zag-js/core";
+import { trackDismissableElement } from "@zag-js/dismissable";
+
+// ../../utilities/core/src/array.ts
+function nextIndex(v, idx, opts = {}) {
+  const { step = 1, loop = true } = opts;
+  const next2 = idx + step;
+  const len = v.length;
+  const last = len - 1;
+  if (idx === -1)
+    return step > 0 ? 0 : last;
+  if (next2 < 0)
+    return loop ? last : 0;
+  if (next2 >= len)
+    return loop ? 0 : idx > len ? len : idx;
+  return next2;
+}
+function next(v, idx, opts = {}) {
+  return v[nextIndex(v, idx, opts)];
+}
+
+// ../../utilities/core/src/guard.ts
+var isArray = (v) => Array.isArray(v);
+var isObject = (v) => !(v == null || typeof v !== "object" || isArray(v));
+var hasProp = (obj, prop) => Object.prototype.hasOwnProperty.call(obj, prop);
+
+// ../../utilities/core/src/object.ts
+function compact(obj) {
+  if (obj === void 0)
+    return obj;
+  return Object.fromEntries(
+    Object.entries(obj).filter(([, value]) => value !== void 0).map(([key, value]) => [key, isObject(value) ? compact(value) : value])
+  );
+}
+
+// ../../utilities/dom/src/event.ts
+var isModifiedEvent = (v) => v.ctrlKey || v.altKey || v.metaKey;
+
+// ../../utilities/dom/src/listener.ts
+var isRef = (v) => hasProp(v, "current");
+function addDomEvent(target, eventName, handler, options) {
+  const node = isRef(target) ? target.current : runIfFn(target);
+  node == null ? void 0 : node.addEventListener(eventName, handler, options);
+  return () => {
+    node == null ? void 0 : node.removeEventListener(eventName, handler, options);
+  };
+}
+
+// ../../utilities/dom/src/next-tick.ts
+function nextTick(fn) {
+  const set = /* @__PURE__ */ new Set();
+  function raf2(fn2) {
+    const id = globalThis.requestAnimationFrame(fn2);
+    set.add(() => globalThis.cancelAnimationFrame(id));
+  }
+  raf2(() => raf2(fn));
+  return function cleanup() {
+    set.forEach(function(fn2) {
+      fn2();
+    });
+  };
+}
+function raf(fn) {
+  const id = globalThis.requestAnimationFrame(fn);
+  return function cleanup() {
+    globalThis.cancelAnimationFrame(id);
+  };
+}
+
+// src/popover.machine.ts
+import { getPlacement } from "@zag-js/popper";
+import { preventBodyScroll } from "@zag-js/remove-scroll";
+import { createFocusTrap } from "focus-trap";
+var { and, or, not } = guards;
+function machine(userContext) {
+  const ctx = compact(userContext);
+  return createMachine(
+    {
+      id: "popover",
+      initial: "unknown",
+      context: {
+        closeOnInteractOutside: true,
+        closeOnEsc: true,
+        autoFocus: true,
+        modal: false,
+        positioning: {
+          placement: "bottom",
+          ...ctx.positioning
+        },
+        currentPlacement: void 0,
+        ...ctx,
+        focusTriggerOnClose: true,
+        renderedElements: {
+          title: true,
+          description: true,
+          anchor: false
+        }
+      },
+      computed: {
+        currentPortalled: (ctx2) => !!ctx2.modal || !!ctx2.portalled
+      },
+      states: {
+        unknown: {
+          on: {
+            SETUP: {
+              target: ctx.defaultOpen ? "open" : "closed",
+              actions: "checkRenderedElements"
+            }
+          }
+        },
+        closed: {
+          entry: "invokeOnClose",
+          on: {
+            TOGGLE: "open",
+            OPEN: "open"
+          }
+        },
+        open: {
+          activities: [
+            "trapFocus",
+            "preventScroll",
+            "hideContentBelow",
+            "computePlacement",
+            "trackInteractionOutside",
+            "trackTabKeyDown"
+          ],
+          entry: ["setInitialFocus", "invokeOnOpen"],
+          on: {
+            CLOSE: "closed",
+            REQUEST_CLOSE: {
+              target: "closed",
+              actions: "focusTriggerIfNeeded"
+            },
+            TOGGLE: "closed",
+            TRIGGER_BLUR: {
+              guard: not("isRelatedTargetWithinContent"),
+              target: "closed"
+            },
+            TAB: [
+              {
+                guard: and("isTriggerFocused", "portalled"),
+                actions: "focusFirstTabbableElement"
+              },
+              {
+                guard: and("isLastTabbableElement", "closeOnInteractOutside", "portalled"),
+                target: "closed",
+                actions: "focusNextTabbableElementAfterTrigger"
+              }
+            ],
+            SHIFT_TAB: {
+              guard: and(or("isFirstTabbableElement", "isContentFocused"), "portalled"),
+              actions: "focusTriggerIfNeeded"
+            }
+          }
+        }
+      }
+    },
+    {
+      activities: {
+        computePlacement(ctx2) {
+          ctx2.currentPlacement = ctx2.positioning.placement;
+          const anchorEl = ctx2.renderedElements.anchor ? dom.getAnchorEl(ctx2) : dom.getTriggerEl(ctx2);
+          return getPlacement(anchorEl, dom.getPositionerEl(ctx2), {
+            ...ctx2.positioning,
+            onComplete(data) {
+              ctx2.currentPlacement = data.placement;
+              ctx2.isPlacementComplete = true;
+            },
+            onCleanup() {
+              ctx2.currentPlacement = void 0;
+              ctx2.isPlacementComplete = false;
+            }
+          });
+        },
+        trackInteractionOutside(ctx2, _evt, { send }) {
+          return trackDismissableElement(dom.getContentEl(ctx2), {
+            pointerBlocking: ctx2.modal,
+            exclude: dom.getTriggerEl(ctx2),
+            onEscapeKeyDown(event) {
+              var _a;
+              (_a = ctx2.onEscapeKeyDown) == null ? void 0 : _a.call(ctx2, event);
+              if (ctx2.closeOnEsc)
+                return;
+              ctx2.focusTriggerOnClose = true;
+              event.preventDefault();
+            },
+            onInteractOutside(event) {
+              var _a;
+              (_a = ctx2.onInteractOutside) == null ? void 0 : _a.call(ctx2, event);
+              if (event.defaultPrevented)
+                return;
+              ctx2.focusTriggerOnClose = !(event.detail.focusable || event.detail.contextmenu);
+              if (!ctx2.closeOnInteractOutside) {
+                event.preventDefault();
+              }
+            },
+            onPointerDownOutside(event) {
+              var _a;
+              (_a = ctx2.onPointerDownOutside) == null ? void 0 : _a.call(ctx2, event);
+            },
+            onFocusOutside(event) {
+              var _a;
+              (_a = ctx2.onFocusOutside) == null ? void 0 : _a.call(ctx2, event);
+              if (ctx2.currentPortalled) {
+                event.preventDefault();
+              }
+            },
+            onDismiss() {
+              send({ type: "REQUEST_CLOSE", src: "#interact-outside" });
+            }
+          });
+        },
+        trackTabKeyDown(ctx2, _evt, { send }) {
+          if (ctx2.modal)
+            return;
+          return addDomEvent(
+            dom.getWin(ctx2),
+            "keydown",
+            (event) => {
+              const isTabKey = event.key === "Tab" && !isModifiedEvent(event);
+              if (!isTabKey)
+                return;
+              send({
+                type: event.shiftKey ? "SHIFT_TAB" : "TAB",
+                preventDefault: () => event.preventDefault()
+              });
+            },
+            true
+          );
+        },
+        hideContentBelow(ctx2) {
+          if (!ctx2.modal)
+            return;
+          let cleanup;
+          nextTick(() => {
+            cleanup = ariaHidden([dom.getContentEl(ctx2), dom.getTriggerEl(ctx2)]);
+          });
+          return () => cleanup == null ? void 0 : cleanup();
+        },
+        preventScroll(ctx2) {
+          if (!ctx2.modal)
+            return;
+          return preventBodyScroll(dom.getDoc(ctx2));
+        },
+        trapFocus(ctx2) {
+          if (!ctx2.modal)
+            return;
+          let trap;
+          nextTick(() => {
+            const el = dom.getContentEl(ctx2);
+            if (!el)
+              return;
+            trap = createFocusTrap(el, {
+              escapeDeactivates: false,
+              allowOutsideClick: true,
+              returnFocusOnDeactivate: true,
+              document: dom.getDoc(ctx2),
+              fallbackFocus: el,
+              initialFocus: runIfFn(ctx2.initialFocusEl)
+            });
+            try {
+              trap.activate();
+            } catch {
+            }
+          });
+          return () => trap == null ? void 0 : trap.deactivate();
+        }
+      },
+      guards: {
+        portalled: (ctx2) => ctx2.currentPortalled,
+        isRelatedTargetWithinContent: (ctx2, evt) => contains(dom.getContentEl(ctx2), evt.target),
+        closeOnInteractOutside: (ctx2) => !!ctx2.closeOnInteractOutside,
+        isContentFocused: (ctx2) => dom.getContentEl(ctx2) === dom.getActiveEl(ctx2),
+        isTriggerFocused: (ctx2) => dom.getTriggerEl(ctx2) === dom.getActiveEl(ctx2),
+        isFirstTabbableElement: (ctx2) => dom.getFirstTabbableEl(ctx2) === dom.getActiveEl(ctx2),
+        isLastTabbableElement: (ctx2) => dom.getLastTabbableEl(ctx2) === dom.getActiveEl(ctx2)
+      },
+      actions: {
+        checkRenderedElements(ctx2) {
+          raf(() => {
+            Object.assign(ctx2.renderedElements, {
+              title: !!dom.getTitleEl(ctx2),
+              description: !!dom.getDescriptionEl(ctx2),
+              anchor: !!dom.getAnchorEl(ctx2)
+            });
+          });
+        },
+        setInitialFocus(ctx2) {
+          raf(() => {
+            var _a;
+            (_a = dom.getInitialFocusEl(ctx2)) == null ? void 0 : _a.focus();
+          });
+        },
+        focusTriggerIfNeeded(ctx2) {
+          if (!ctx2.focusTriggerOnClose)
+            return;
+          raf(() => {
+            var _a;
+            return (_a = dom.getTriggerEl(ctx2)) == null ? void 0 : _a.focus();
+          });
+        },
+        focusFirstTabbableElement(ctx2, evt) {
+          var _a;
+          evt.preventDefault();
+          (_a = dom.getFirstTabbableEl(ctx2)) == null ? void 0 : _a.focus();
+        },
+        invokeOnOpen(ctx2, evt) {
+          var _a;
+          if (evt.type !== "SETUP") {
+            (_a = ctx2.onOpenChange) == null ? void 0 : _a.call(ctx2, true);
+          }
+        },
+        invokeOnClose(ctx2, evt) {
+          var _a;
+          if (evt.type !== "SETUP") {
+            (_a = ctx2.onOpenChange) == null ? void 0 : _a.call(ctx2, false);
+          }
+        },
+        focusNextTabbableElementAfterTrigger(ctx2, evt) {
+          const content = dom.getContentEl(ctx2);
+          const button = dom.getTriggerEl(ctx2);
+          if (!content || !button)
+            return;
+          const lastTabbable = dom.getLastTabbableEl(ctx2);
+          if (lastTabbable !== dom.getActiveEl(ctx2))
+            return;
+          let tabbables = dom.getDocTabbableEls(ctx2);
+          let elementAfterTrigger = next(tabbables, tabbables.indexOf(button), { loop: false });
+          if (elementAfterTrigger === content) {
+            tabbables = tabbables.filter((el) => !contains(content, el));
+            elementAfterTrigger = next(tabbables, tabbables.indexOf(button), { loop: false });
+          }
+          if (!elementAfterTrigger || elementAfterTrigger === button)
+            return;
+          evt.preventDefault();
+          raf(() => elementAfterTrigger == null ? void 0 : elementAfterTrigger.focus());
+        }
+      }
+    }
+  );
+}
+
+export {
+  machine
+};

package/dist/chunk-KTOPDXGV.mjs

@@ -0,0 +1,19 @@
+// src/popover.anatomy.ts
+import { createAnatomy } from "@zag-js/anatomy";
+var anatomy = createAnatomy("popover").parts(
+  "arrow",
+  "arrowTip",
+  "anchor",
+  "trigger",
+  "positioner",
+  "content",
+  "title",
+  "description",
+  "closeTrigger"
+);
+var parts = anatomy.build();
+
+export {
+  anatomy,
+  parts
+};