@zag-js/tooltip 0.2.4 → 0.2.6

package/dist/tooltip.machine.js

@@ -0,0 +1,528 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/tooltip.machine.ts
+var tooltip_machine_exports = {};
+__export(tooltip_machine_exports, {
+  machine: () => machine
+});
+module.exports = __toCommonJS(tooltip_machine_exports);
+var import_core2 = require("@zag-js/core");
+
+// ../../utilities/dom/src/get-computed-style.ts
+function getCache() {
+  const g = globalThis;
+  g.__styleCache = g.__styleCache || /* @__PURE__ */ new WeakMap();
+  return g.__styleCache;
+}
+function getComputedStyle(el) {
+  var _a;
+  if (!el)
+    return {};
+  const cache = getCache();
+  let style = cache.get(el);
+  if (!style) {
+    const win = (_a = el == null ? void 0 : el.ownerDocument.defaultView) != null ? _a : window;
+    style = win.getComputedStyle(el);
+    cache.set(el, style);
+  }
+  return style;
+}
+
+// ../../utilities/core/src/functions.ts
+var runIfFn = (v, ...a) => {
+  const res = typeof v === "function" ? v(...a) : v;
+  return res != null ? res : void 0;
+};
+
+// ../../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/platform.ts
+var isDom = () => typeof window !== "undefined";
+function getPlatform() {
+  var _a;
+  const agent = navigator.userAgentData;
+  return (_a = agent == null ? void 0 : agent.platform) != null ? _a : navigator.platform;
+}
+var pt = (v) => isDom() && v.test(getPlatform());
+var vn = (v) => isDom() && v.test(navigator.vendor);
+var isSafari = () => isApple() && vn(/apple/i);
+var isApple = () => pt(/mac|iphone|ipad|ipod/i);
+
+// ../../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 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 getWindow(el) {
+  var _a;
+  return (_a = el == null ? void 0 : el.ownerDocument.defaultView) != null ? _a : window;
+}
+function getNodeName(node) {
+  var _a;
+  return isWindow(node) ? "" : (_a = node == null ? void 0 : node.localName) != null ? _a : "";
+}
+function getParent(el) {
+  const doc = getDocument(el);
+  if (getNodeName(el) === "html")
+    return el;
+  return el.assignedSlot || el.parentElement || doc.documentElement;
+}
+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 isHTMLElement(v) {
+  return typeof v === "object" && (v == null ? void 0 : v.nodeType) === Node.ELEMENT_NODE && typeof (v == null ? void 0 : v.nodeName) === "string";
+}
+
+// ../../utilities/dom/src/event.ts
+var supportsPointerEvent = () => isDom() && window.onpointerdown === null;
+var supportsTouchEvent = () => isDom() && window.ontouchstart === null;
+var supportsMouseEvent = () => isDom() && window.onmousedown === null;
+var isTouchEvent = (v) => isObject(v) && hasProp(v, "touches");
+
+// ../../utilities/dom/src/listener.ts
+var isRef = (v) => hasProp(v, "current");
+var fallback = { pageX: 0, pageY: 0, clientX: 0, clientY: 0 };
+function extractInfo(event, type = "page") {
+  const point = isTouchEvent(event) ? event.touches[0] || event.changedTouches[0] || fallback : event;
+  return {
+    point: {
+      x: point[`${type}X`],
+      y: point[`${type}Y`]
+    }
+  };
+}
+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);
+  };
+}
+function addPointerEvent(target, event, listener, options) {
+  var _a;
+  const type = (_a = getEventName(event)) != null ? _a : event;
+  return addDomEvent(target, type, wrapHandler(listener, event === "pointerdown"), options);
+}
+function wrapHandler(fn, filter = false) {
+  const listener = (event) => {
+    fn(event, extractInfo(event));
+  };
+  return filter ? filterPrimaryPointer(listener) : listener;
+}
+function filterPrimaryPointer(fn) {
+  return (event) => {
+    var _a;
+    const win = (_a = event.view) != null ? _a : window;
+    const isMouseEvent = event instanceof win.MouseEvent;
+    const isPrimary = !isMouseEvent || isMouseEvent && event.button === 0;
+    if (isPrimary)
+      fn(event);
+  };
+}
+var mouseEventNames = {
+  pointerdown: "mousedown",
+  pointermove: "mousemove",
+  pointerup: "mouseup",
+  pointercancel: "mousecancel",
+  pointerover: "mouseover",
+  pointerout: "mouseout",
+  pointerenter: "mouseenter",
+  pointerleave: "mouseleave"
+};
+var touchEventNames = {
+  pointerdown: "touchstart",
+  pointermove: "touchmove",
+  pointerup: "touchend",
+  pointercancel: "touchcancel"
+};
+function getEventName(evt) {
+  if (supportsPointerEvent())
+    return evt;
+  if (supportsTouchEvent())
+    return touchEventNames[evt];
+  if (supportsMouseEvent())
+    return mouseEventNames[evt];
+  return evt;
+}
+
+// ../../utilities/dom/src/next-tick.ts
+function raf(fn) {
+  const id = globalThis.requestAnimationFrame(fn);
+  return function cleanup() {
+    globalThis.cancelAnimationFrame(id);
+  };
+}
+
+// ../../utilities/dom/src/pointerlock.ts
+function addPointerlockChangeListener(doc, fn) {
+  return addDomEvent(doc, "pointerlockchange", fn, false);
+}
+
+// ../../utilities/dom/src/scrollable.ts
+function isScrollParent(el) {
+  const { overflow, overflowX, overflowY } = getComputedStyle(el);
+  return /auto|scroll|overlay|hidden/.test(overflow + overflowY + overflowX);
+}
+function getScrollParent(el) {
+  if (["html", "body", "#document"].includes(getNodeName(el))) {
+    return getDocument(el).body;
+  }
+  if (isHTMLElement(el) && isScrollParent(el)) {
+    return el;
+  }
+  return getScrollParent(getParent(el));
+}
+function getScrollParents(el, list = []) {
+  const scrollParent = getScrollParent(el);
+  const isBody = scrollParent === getDocument(el).body;
+  const win = getWindow(scrollParent);
+  const target = isBody ? [win].concat(win.visualViewport || [], isScrollParent(scrollParent) ? scrollParent : []) : scrollParent;
+  const parents = list.concat(target);
+  if (isBody)
+    return parents;
+  return parents.concat(getScrollParents(getParent(target)));
+}
+
+// src/tooltip.machine.ts
+var import_popper = require("@zag-js/popper");
+
+// src/tooltip.dom.ts
+var dom = defineDomHelpers({
+  getTriggerId: (ctx) => {
+    var _a, _b;
+    return (_b = (_a = ctx.ids) == null ? void 0 : _a.trigger) != null ? _b : `tooltip:${ctx.id}:trigger`;
+  },
+  getContentId: (ctx) => {
+    var _a, _b;
+    return (_b = (_a = ctx.ids) == null ? void 0 : _a.content) != null ? _b : `tooltip:${ctx.id}:content`;
+  },
+  getArrowId: (ctx) => `tooltip:${ctx.id}:arrow`,
+  getPositionerId: (ctx) => `tooltip:${ctx.id}:popper`,
+  portalId: "tooltip-portal",
+  getTriggerEl: (ctx) => dom.getById(ctx, dom.getTriggerId(ctx)),
+  getContentEl: (ctx) => dom.getById(ctx, dom.getContentId(ctx)),
+  getPositionerEl: (ctx) => dom.getById(ctx, dom.getPositionerId(ctx)),
+  getArrowEl: (ctx) => dom.getById(ctx, dom.getArrowId(ctx)),
+  getScrollParent: (ctx) => getScrollParent(dom.getTriggerEl(ctx)),
+  getPortalEl: (ctx) => dom.getDoc(ctx).getElementById(dom.portalId),
+  createPortalEl: (ctx) => {
+    const portal = dom.getDoc(ctx).createElement(dom.portalId);
+    portal.id = dom.portalId;
+    return portal;
+  }
+});
+
+// src/tooltip.store.ts
+var import_core = require("@zag-js/core");
+var store = (0, import_core.proxy)({
+  id: null,
+  prevId: null,
+  setId(val) {
+    this.prevId = this.id;
+    this.id = val;
+  }
+});
+
+// src/tooltip.machine.ts
+function machine(userContext) {
+  const ctx = compact(userContext);
+  return (0, import_core2.createMachine)(
+    {
+      id: "tooltip",
+      initial: "unknown",
+      context: {
+        openDelay: 1e3,
+        closeDelay: 500,
+        closeOnPointerDown: true,
+        closeOnEsc: true,
+        interactive: true,
+        currentPlacement: void 0,
+        ...ctx,
+        positioning: {
+          placement: "bottom",
+          ...ctx.positioning
+        }
+      },
+      computed: {
+        hasAriaLabel: (ctx2) => !!ctx2["aria-label"]
+      },
+      watch: {
+        disabled: ["closeIfDisabled"]
+      },
+      on: {
+        OPEN: "open",
+        CLOSE: "closed"
+      },
+      states: {
+        unknown: {
+          on: {
+            SETUP: "closed"
+          }
+        },
+        closed: {
+          tags: ["closed"],
+          entry: ["clearGlobalId", "invokeOnClose"],
+          on: {
+            FOCUS: "open",
+            POINTER_ENTER: [
+              {
+                guard: "noVisibleTooltip",
+                target: "opening"
+              },
+              { target: "open" }
+            ]
+          }
+        },
+        opening: {
+          tags: ["closed"],
+          activities: ["trackScroll", "trackPointerlockChange"],
+          after: {
+            OPEN_DELAY: "open"
+          },
+          on: {
+            POINTER_LEAVE: "closed",
+            BLUR: "closed",
+            SCROLL: "closed",
+            POINTER_LOCK_CHANGE: "closed",
+            POINTER_DOWN: {
+              guard: "closeOnPointerDown",
+              target: "closed"
+            }
+          }
+        },
+        open: {
+          tags: ["open"],
+          activities: [
+            "trackEscapeKey",
+            "trackDisabledTriggerOnSafari",
+            "trackScroll",
+            "trackPointerlockChange",
+            "computePlacement"
+          ],
+          entry: ["setGlobalId", "invokeOnOpen"],
+          on: {
+            POINTER_LEAVE: [
+              {
+                guard: "isVisible",
+                target: "closing"
+              },
+              { target: "closed" }
+            ],
+            BLUR: "closed",
+            ESCAPE: "closed",
+            SCROLL: "closed",
+            POINTER_LOCK_CHANGE: "closed",
+            TOOLTIP_POINTER_LEAVE: {
+              guard: "isInteractive",
+              target: "closing"
+            },
+            POINTER_DOWN: {
+              guard: "closeOnPointerDown",
+              target: "closed"
+            },
+            CLICK: "closed"
+          }
+        },
+        closing: {
+          tags: ["open"],
+          activities: ["trackStore", "computePlacement"],
+          after: {
+            CLOSE_DELAY: "closed"
+          },
+          on: {
+            FORCE_CLOSE: "closed",
+            POINTER_ENTER: "open",
+            TOOLTIP_POINTER_ENTER: {
+              guard: "isInteractive",
+              target: "open"
+            }
+          }
+        }
+      }
+    },
+    {
+      activities: {
+        computePlacement(ctx2) {
+          ctx2.currentPlacement = ctx2.positioning.placement;
+          let cleanup;
+          raf(() => {
+            cleanup = (0, import_popper.getPlacement)(dom.getTriggerEl(ctx2), dom.getPositionerEl(ctx2), {
+              ...ctx2.positioning,
+              onComplete(data) {
+                ctx2.currentPlacement = data.placement;
+                ctx2.isPlacementComplete = true;
+              },
+              onCleanup() {
+                ctx2.currentPlacement = void 0;
+                ctx2.isPlacementComplete = false;
+              }
+            });
+          });
+          return cleanup;
+        },
+        trackPointerlockChange(ctx2, _evt, { send }) {
+          return addPointerlockChangeListener(dom.getDoc(ctx2), () => {
+            send("POINTER_LOCK_CHANGE");
+          });
+        },
+        trackScroll(ctx2, _evt, { send }) {
+          const trigger = dom.getTriggerEl(ctx2);
+          if (!trigger)
+            return;
+          const cleanups = getScrollParents(trigger).map((el) => {
+            const opts = { passive: true, capture: true };
+            return addDomEvent(el, "scroll", () => send("SCROLL"), opts);
+          });
+          return () => {
+            cleanups.forEach((fn) => fn == null ? void 0 : fn());
+          };
+        },
+        trackStore(ctx2, _evt, { send }) {
+          return (0, import_core2.subscribe)(store, () => {
+            if (store.id !== ctx2.id) {
+              send("FORCE_CLOSE");
+            }
+          });
+        },
+        trackDisabledTriggerOnSafari(ctx2, _evt, { send }) {
+          if (!isSafari())
+            return;
+          const doc = dom.getDoc(ctx2);
+          return addPointerEvent(doc, "pointermove", (event) => {
+            const selector = "[data-part=trigger][data-expanded]";
+            if (isHTMLElement(event.target) && event.target.closest(selector))
+              return;
+            send("POINTER_LEAVE");
+          });
+        },
+        trackEscapeKey(ctx2, _evt, { send }) {
+          if (!ctx2.closeOnEsc)
+            return;
+          const doc = dom.getDoc(ctx2);
+          return addDomEvent(doc, "keydown", (event) => {
+            if (event.key === "Escape") {
+              send("ESCAPE");
+            }
+          });
+        }
+      },
+      actions: {
+        setGlobalId(ctx2) {
+          store.setId(ctx2.id);
+        },
+        clearGlobalId(ctx2) {
+          if (ctx2.id === store.id) {
+            store.setId(null);
+          }
+        },
+        invokeOnOpen(ctx2, evt) {
+          var _a;
+          const omit = ["TOOLTIP_POINTER_ENTER", "POINTER_ENTER"];
+          if (!omit.includes(evt.type)) {
+            (_a = ctx2.onOpen) == null ? void 0 : _a.call(ctx2);
+          }
+        },
+        invokeOnClose(ctx2, evt) {
+          var _a;
+          const omit = ["SETUP"];
+          if (!omit.includes(evt.type)) {
+            (_a = ctx2.onClose) == null ? void 0 : _a.call(ctx2);
+          }
+        },
+        closeIfDisabled(ctx2, _evt, { send }) {
+          if (ctx2.disabled) {
+            send("CLOSE");
+          }
+        }
+      },
+      guards: {
+        closeOnPointerDown: (ctx2) => ctx2.closeOnPointerDown,
+        noVisibleTooltip: () => store.id === null,
+        isVisible: (ctx2) => ctx2.id === store.id,
+        isInteractive: (ctx2) => ctx2.interactive
+      },
+      delays: {
+        OPEN_DELAY: (ctx2) => ctx2.openDelay,
+        CLOSE_DELAY: (ctx2) => ctx2.closeDelay
+      }
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  machine
+});

package/dist/tooltip.machine.mjs

@@ -0,0 +1,8 @@
+import {
+  machine
+} from "./chunk-JWVFZJC7.mjs";
+import "./chunk-PFKIRGNP.mjs";
+import "./chunk-GQYNO326.mjs";
+export {
+  machine
+};

package/dist/tooltip.store.d.ts

@@ -0,0 +1,9 @@
+type Id = string | null;
+type Store = {
+    id: Id;
+    prevId: Id;
+    setId: (val: Id) => void;
+};
+declare const store: Store;
+
+export { store };

package/dist/tooltip.store.js

@@ -0,0 +1,38 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/tooltip.store.ts
+var tooltip_store_exports = {};
+__export(tooltip_store_exports, {
+  store: () => store
+});
+module.exports = __toCommonJS(tooltip_store_exports);
+var import_core = require("@zag-js/core");
+var store = (0, import_core.proxy)({
+  id: null,
+  prevId: null,
+  setId(val) {
+    this.prevId = this.id;
+    this.id = val;
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  store
+});

package/dist/tooltip.store.mjs

@@ -0,0 +1,6 @@
+import {
+  store
+} from "./chunk-GQYNO326.mjs";
+export {
+  store
+};

package/dist/tooltip.types.d.ts

@@ -0,0 +1,77 @@
+import { StateMachine } from '@zag-js/core';
+import { PositioningOptions } from '@zag-js/popper';
+import { RequiredBy, CommonProperties, RootProperties } from '@zag-js/types';
+
+type ElementIds = Partial<{
+    trigger: string;
+    content: string;
+}>;
+type PublicContext = CommonProperties & {
+    /**
+     * The ids of the elements in the tooltip. Useful for composition.
+     */
+    ids?: ElementIds;
+    /**
+     * The `id` of the tooltip.
+     */
+    id: string;
+    /**
+     * The open delay of the tooltip.
+     */
+    openDelay: number;
+    /**
+     * The close delay of the tooltip.
+     */
+    closeDelay: number;
+    /**
+     * Whether to close the tooltip on pointerdown.
+     */
+    closeOnPointerDown: boolean;
+    /**
+     * Whether to close the tooltip when the Escape key is pressed.
+     */
+    closeOnEsc?: boolean;
+    /**
+     * Whether the tooltip's content is interactive.
+     * In this mode, the tooltip will remain open when user hovers over the content.
+     * @see https://www.w3.org/TR/WCAG21/#content-on-hover-or-focus
+     */
+    interactive: boolean;
+    /**
+     * Function called when the tooltip is opened.
+     */
+    onOpen?: VoidFunction;
+    /**
+     * Function called when the tooltip is closed.
+     */
+    onClose?: VoidFunction;
+    /**
+     * Custom label for the tooltip.
+     */
+    "aria-label"?: string;
+    /**
+     * The user provided options used to position the popover content
+     */
+    positioning: PositioningOptions;
+    /**
+     * Whether the tooltip is disabled
+     */
+    disabled?: boolean;
+};
+type UserDefinedContext = RequiredBy<PublicContext, "id">;
+type ComputedContext = Readonly<{
+    /**
+     * @computed Whether an `aria-label` is set.
+     */
+    readonly hasAriaLabel: boolean;
+}>;
+type PrivateContext = RootProperties & {};
+type MachineContext = PublicContext & ComputedContext & PrivateContext;
+type MachineState = {
+    value: "unknown" | "opening" | "open" | "closing" | "closed";
+    tags: "open" | "closed";
+};
+type State = StateMachine.State<MachineContext, MachineState>;
+type Send = StateMachine.Send<StateMachine.AnyEventObject>;
+
+export { MachineContext, MachineState, Send, State, UserDefinedContext };

package/dist/tooltip.types.js

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/tooltip.types.ts
+var tooltip_types_exports = {};
+module.exports = __toCommonJS(tooltip_types_exports);