@zag-js/tabs 0.2.11 → 0.2.12

package/dist/{chunk-IVTIBLCN.mjs → chunk-5JW3YJ3I.mjs}

@@ -3,60 +3,36 @@ import {
 } from "./chunk-S2KW2DT4.mjs";
 import {
   dom
-} from "./chunk-4CROPD6E.mjs";
-
-// ../../utilities/dom/src/attrs.ts
-var dataAttr = (guard) => {
-  return guard ? "" : void 0;
-};
-
-// ../../utilities/dom/src/platform.ts
-var isDom = () => typeof window !== "undefined";
-function getPlatform() {
-  const agent = navigator.userAgentData;
-  return agent?.platform ?? 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/keyboard-event.ts
-var rtlKeyMap = {
-  ArrowLeft: "ArrowRight",
-  ArrowRight: "ArrowLeft"
-};
-var sameKeyMap = {
-  Up: "ArrowUp",
-  Down: "ArrowDown",
-  Esc: "Escape",
-  " ": "Space",
-  ",": "Comma",
-  Left: "ArrowLeft",
-  Right: "ArrowRight"
-};
-function getEventKey(event, options = {}) {
-  const { dir = "ltr", orientation = "horizontal" } = options;
-  let { key } = event;
-  key = sameKeyMap[key] ?? key;
-  const isRtl = dir === "rtl" && orientation === "horizontal";
-  if (isRtl && key in rtlKeyMap) {
-    key = rtlKeyMap[key];
-  }
-  return key;
-}
+} from "./chunk-5ZMNIWHF.mjs";
 
 // src/tabs.connect.ts
+import { getEventKey } from "@zag-js/dom-event";
+import { dataAttr, isSafari } from "@zag-js/dom-query";
 function connect(state, send, normalize) {
   const translations = state.context.translations;
   const isFocused = state.matches("focused");
   return {
+    /**
+     * The current value of the tabs.
+     */
     value: state.context.value,
+    /**
+     * The value of the tab that is currently focused.
+     */
     focusedValue: state.context.focusedValue,
+    /**
+     * The previous values of the tabs in sequence of selection.
+     */
     previousValues: Array.from(state.context.previousValues),
+    /**
+     * Sets the value of the tabs.
+     */
     setValue(value) {
       send({ type: "SET_VALUE", value });
     },
+    /**
+     * Clears the value of the tabs.
+     */
     clearValue() {
       send({ type: "CLEAR_VALUE" });
     },

package/dist/chunk-5ZMNIWHF.mjs

@@ -0,0 +1,53 @@
+// src/tabs.dom.ts
+import { createScope, itemById, nextById, prevById, queryAll } from "@zag-js/dom-query";
+import { first, last } from "@zag-js/utils";
+var dom = createScope({
+  getRootId: (ctx) => ctx.ids?.root ?? `tabs:${ctx.id}`,
+  getTablistId: (ctx) => ctx.ids?.tablist ?? `tabs:${ctx.id}:list`,
+  getContentId: (ctx, id) => ctx.ids?.content ?? `tabs:${ctx.id}:content-${id}`,
+  getContentGroupId: (ctx) => ctx.ids?.contentGroup ?? `tabs:${ctx.id}:content-group`,
+  getTriggerId: (ctx, id) => ctx.ids?.trigger ?? `tabs:${ctx.id}:trigger-${id}`,
+  getIndicatorId: (ctx) => `tabs:${ctx.id}:indicator`,
+  getTablistEl: (ctx) => dom.getById(ctx, dom.getTablistId(ctx)),
+  getContentEl: (ctx, id) => dom.getById(ctx, dom.getContentId(ctx, id)),
+  getTriggerEl: (ctx, id) => dom.getById(ctx, dom.getTriggerId(ctx, id)),
+  getIndicatorEl: (ctx) => dom.getById(ctx, dom.getIndicatorId(ctx)),
+  getElements: (ctx) => {
+    const ownerId = CSS.escape(dom.getTablistId(ctx));
+    const selector = `[role=tab][data-ownedby='${ownerId}']:not([disabled])`;
+    return queryAll(dom.getTablistEl(ctx), selector);
+  },
+  getFirstEl: (ctx) => first(dom.getElements(ctx)),
+  getLastEl: (ctx) => last(dom.getElements(ctx)),
+  getNextEl: (ctx, id) => nextById(dom.getElements(ctx), dom.getTriggerId(ctx, id), ctx.loop),
+  getPrevEl: (ctx, id) => prevById(dom.getElements(ctx), dom.getTriggerId(ctx, id), ctx.loop),
+  getActiveContentEl: (ctx) => {
+    if (!ctx.value)
+      return;
+    const id = dom.getContentId(ctx, ctx.value);
+    return dom.getById(ctx, id);
+  },
+  getRectById: (ctx, id) => {
+    const empty = {
+      offsetLeft: 0,
+      offsetTop: 0,
+      offsetWidth: 0,
+      offsetHeight: 0
+    };
+    const tab = itemById(dom.getElements(ctx), dom.getTriggerId(ctx, id)) ?? empty;
+    if (ctx.isVertical) {
+      return {
+        top: `${tab.offsetTop}px`,
+        height: `${tab.offsetHeight}px`
+      };
+    }
+    return {
+      left: `${tab.offsetLeft}px`,
+      width: `${tab.offsetWidth}px`
+    };
+  }
+});
+
+export {
+  dom
+};

package/dist/{chunk-3DBUWLYX.mjs → chunk-JG2VX4ST.mjs}

@@ -1,73 +1,12 @@
 import {
-  dom,
-  isFrame,
-  isHTMLElement,
-  isVisible
-} from "./chunk-4CROPD6E.mjs";
+  dom
+} from "./chunk-5ZMNIWHF.mjs";
 
 // src/tabs.machine.ts
 import { createMachine, guards } from "@zag-js/core";
-
-// ../../utilities/core/src/guard.ts
-var isArray = (v) => Array.isArray(v);
-var isObject = (v) => !(v == null || typeof v !== "object" || isArray(v));
-
-// ../../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/focusable.ts
-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);
-}
-
-// ../../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/tabs.machine.ts
+import { nextTick, raf } from "@zag-js/dom-query";
+import { getFocusables } from "@zag-js/tabbable";
+import { compact } from "@zag-js/utils";
 var { not } = guards;
 function machine(userContext) {
   const ctx = compact(userContext);
@@ -237,6 +176,7 @@ function machine(userContext) {
             ctx2.previousValues = pushUnique(Array.from(ctx2.previousValues), ctx2.value);
           }
         },
+        // if tab panel contains focusable elements, remove the tabindex attribute
         setContentTabIndex(ctx2) {
           raf(() => {
             const panel = dom.getActiveContentEl(ctx2);

package/dist/index.js

@@ -31,175 +31,14 @@ var import_anatomy = require("@zag-js/anatomy");
 var anatomy = (0, import_anatomy.createAnatomy)("tabs").parts("root", "tablist", "trigger", "contentGroup", "content", "indicator");
 var parts = anatomy.build();
 
-// ../../utilities/dom/src/attrs.ts
-var dataAttr = (guard) => {
-  return guard ? "" : void 0;
-};
-
-// ../../utilities/core/src/array.ts
-var first = (v) => v[0];
-var last = (v) => v[v.length - 1];
-
-// ../../utilities/core/src/guard.ts
-var isArray = (v) => Array.isArray(v);
-var isObject = (v) => !(v == null || typeof v !== "object" || isArray(v));
-
-// ../../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() {
-  const agent = navigator.userAgentData;
-  return agent?.platform ?? 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?.toString() === "[object Window]";
-}
-function isFrame(element) {
-  return element.localName === "iframe";
-}
-function getDocument(el) {
-  if (isWindow(el))
-    return el.document;
-  if (isDocument(el))
-    return el;
-  return el?.ownerDocument ?? document;
-}
-function defineDomHelpers(helpers) {
-  const dom2 = {
-    getRootNode: (ctx) => ctx.getRootNode?.() ?? document,
-    getDoc: (ctx) => getDocument(dom2.getRootNode(ctx)),
-    getWin: (ctx) => dom2.getDoc(ctx).defaultView ?? window,
-    getActiveElement: (ctx) => dom2.getDoc(ctx).activeElement,
-    getById: (ctx, id) => dom2.getRootNode(ctx).getElementById(id)
-  };
-  return {
-    ...dom2,
-    ...helpers
-  };
-}
-function isHTMLElement(v) {
-  return typeof v === "object" && v?.nodeType === Node.ELEMENT_NODE && typeof 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
-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);
-}
-
-// ../../utilities/dom/src/keyboard-event.ts
-var rtlKeyMap = {
-  ArrowLeft: "ArrowRight",
-  ArrowRight: "ArrowLeft"
-};
-var sameKeyMap = {
-  Up: "ArrowUp",
-  Down: "ArrowDown",
-  Esc: "Escape",
-  " ": "Space",
-  ",": "Comma",
-  Left: "ArrowLeft",
-  Right: "ArrowRight"
-};
-function getEventKey(event, options = {}) {
-  const { dir = "ltr", orientation = "horizontal" } = options;
-  let { key } = event;
-  key = sameKeyMap[key] ?? key;
-  const isRtl = dir === "rtl" && orientation === "horizontal";
-  if (isRtl && key in rtlKeyMap) {
-    key = rtlKeyMap[key];
-  }
-  return key;
-}
-
-// ../../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);
-  };
-}
-
-// ../../utilities/dom/src/nodelist.ts
-function queryAll(root, selector) {
-  return Array.from(root?.querySelectorAll(selector) ?? []);
-}
-function itemById(v, id) {
-  return v.find((node) => node.id === id);
-}
-function indexOfId(v, id) {
-  const item = itemById(v, id);
-  return item ? v.indexOf(item) : -1;
-}
-function nextById(v, id, loop = true) {
-  let idx = indexOfId(v, id);
-  idx = loop ? (idx + 1) % v.length : Math.min(idx + 1, v.length - 1);
-  return v[idx];
-}
-function prevById(v, id, loop = true) {
-  let idx = indexOfId(v, id);
-  if (idx === -1)
-    return loop ? v[v.length - 1] : null;
-  idx = loop ? (idx - 1 + v.length) % v.length : Math.max(0, idx - 1);
-  return v[idx];
-}
+// src/tabs.connect.ts
+var import_dom_event = require("@zag-js/dom-event");
+var import_dom_query2 = require("@zag-js/dom-query");
 
 // src/tabs.dom.ts
-var dom = defineDomHelpers({
+var import_dom_query = require("@zag-js/dom-query");
+var import_utils = require("@zag-js/utils");
+var dom = (0, import_dom_query.createScope)({
   getRootId: (ctx) => ctx.ids?.root ?? `tabs:${ctx.id}`,
   getTablistId: (ctx) => ctx.ids?.tablist ?? `tabs:${ctx.id}:list`,
   getContentId: (ctx, id) => ctx.ids?.content ?? `tabs:${ctx.id}:content-${id}`,
@@ -213,12 +52,12 @@ var dom = defineDomHelpers({
   getElements: (ctx) => {
     const ownerId = CSS.escape(dom.getTablistId(ctx));
     const selector = `[role=tab][data-ownedby='${ownerId}']:not([disabled])`;
-    return queryAll(dom.getTablistEl(ctx), selector);
+    return (0, import_dom_query.queryAll)(dom.getTablistEl(ctx), selector);
   },
-  getFirstEl: (ctx) => first(dom.getElements(ctx)),
-  getLastEl: (ctx) => last(dom.getElements(ctx)),
-  getNextEl: (ctx, id) => nextById(dom.getElements(ctx), dom.getTriggerId(ctx, id), ctx.loop),
-  getPrevEl: (ctx, id) => prevById(dom.getElements(ctx), dom.getTriggerId(ctx, id), ctx.loop),
+  getFirstEl: (ctx) => (0, import_utils.first)(dom.getElements(ctx)),
+  getLastEl: (ctx) => (0, import_utils.last)(dom.getElements(ctx)),
+  getNextEl: (ctx, id) => (0, import_dom_query.nextById)(dom.getElements(ctx), dom.getTriggerId(ctx, id), ctx.loop),
+  getPrevEl: (ctx, id) => (0, import_dom_query.prevById)(dom.getElements(ctx), dom.getTriggerId(ctx, id), ctx.loop),
   getActiveContentEl: (ctx) => {
     if (!ctx.value)
       return;
@@ -232,7 +71,7 @@ var dom = defineDomHelpers({
       offsetWidth: 0,
       offsetHeight: 0
     };
-    const tab = itemById(dom.getElements(ctx), dom.getTriggerId(ctx, id)) ?? empty;
+    const tab = (0, import_dom_query.itemById)(dom.getElements(ctx), dom.getTriggerId(ctx, id)) ?? empty;
     if (ctx.isVertical) {
       return {
         top: `${tab.offsetTop}px`,
@@ -251,12 +90,27 @@ function connect(state, send, normalize) {
   const translations = state.context.translations;
   const isFocused = state.matches("focused");
   return {
+    /**
+     * The current value of the tabs.
+     */
     value: state.context.value,
+    /**
+     * The value of the tab that is currently focused.
+     */
     focusedValue: state.context.focusedValue,
+    /**
+     * The previous values of the tabs in sequence of selection.
+     */
     previousValues: Array.from(state.context.previousValues),
+    /**
+     * Sets the value of the tabs.
+     */
     setValue(value) {
       send({ type: "SET_VALUE", value });
     },
+    /**
+     * Clears the value of the tabs.
+     */
     clearValue() {
       send({ type: "CLEAR_VALUE" });
     },
@@ -264,14 +118,14 @@ function connect(state, send, normalize) {
       ...parts.root.attrs,
       id: dom.getRootId(state.context),
       "data-orientation": state.context.orientation,
-      "data-focus": dataAttr(isFocused),
+      "data-focus": (0, import_dom_query2.dataAttr)(isFocused),
       dir: state.context.dir
     }),
     tablistProps: normalize.element({
       ...parts.tablist.attrs,
       id: dom.getTablistId(state.context),
       role: "tablist",
-      "data-focus": dataAttr(isFocused),
+      "data-focus": (0, import_dom_query2.dataAttr)(isFocused),
       "aria-orientation": state.context.orientation,
       "data-orientation": state.context.orientation,
       "aria-label": translations.tablistLabel,
@@ -299,7 +153,7 @@ function connect(state, send, normalize) {
             send({ type: "ENTER", value: state.context.focusedValue });
           }
         };
-        let key = getEventKey(event, state.context);
+        let key = (0, import_dom_event.getEventKey)(event, state.context);
         const exec = keyMap[key];
         if (exec) {
           event.preventDefault();
@@ -316,11 +170,11 @@ function connect(state, send, normalize) {
         type: "button",
         disabled,
         "data-orientation": state.context.orientation,
-        "data-disabled": dataAttr(disabled),
+        "data-disabled": (0, import_dom_query2.dataAttr)(disabled),
         "aria-disabled": disabled,
         "data-value": value,
         "aria-selected": selected,
-        "data-selected": dataAttr(selected),
+        "data-selected": (0, import_dom_query2.dataAttr)(selected),
         "aria-controls": dom.getContentId(state.context, value),
         "data-ownedby": dom.getTablistId(state.context),
         id: dom.getTriggerId(state.context, value),
@@ -337,7 +191,7 @@ function connect(state, send, normalize) {
         onClick(event) {
           if (disabled)
             return;
-          if (isSafari()) {
+          if ((0, import_dom_query2.isSafari)()) {
             event.currentTarget.focus();
           }
           send({ type: "TAB_CLICK", value });
@@ -381,9 +235,12 @@ function connect(state, send, normalize) {
 
 // src/tabs.machine.ts
 var import_core = require("@zag-js/core");
+var import_dom_query3 = require("@zag-js/dom-query");
+var import_tabbable = require("@zag-js/tabbable");
+var import_utils2 = require("@zag-js/utils");
 var { not } = import_core.guards;
 function machine(userContext) {
-  const ctx = compact(userContext);
+  const ctx = (0, import_utils2.compact)(userContext);
   return (0, import_core.createMachine)(
     {
       initial: "idle",
@@ -504,31 +361,31 @@ function machine(userContext) {
           ctx2.onDelete?.({ value: evt.value });
         },
         focusFirstTab(ctx2) {
-          raf(() => dom.getFirstEl(ctx2)?.focus());
+          (0, import_dom_query3.raf)(() => dom.getFirstEl(ctx2)?.focus());
         },
         focusLastTab(ctx2) {
-          raf(() => dom.getLastEl(ctx2)?.focus());
+          (0, import_dom_query3.raf)(() => dom.getLastEl(ctx2)?.focus());
         },
         focusNextTab(ctx2) {
           if (!ctx2.focusedValue)
             return;
           const next = dom.getNextEl(ctx2, ctx2.focusedValue);
-          raf(() => next?.focus());
+          (0, import_dom_query3.raf)(() => next?.focus());
         },
         focusPrevTab(ctx2) {
           if (!ctx2.focusedValue)
             return;
           const prev = dom.getPrevEl(ctx2, ctx2.focusedValue);
-          raf(() => prev?.focus());
+          (0, import_dom_query3.raf)(() => prev?.focus());
         },
         setIndicatorRect(ctx2) {
-          nextTick(() => {
+          (0, import_dom_query3.nextTick)(() => {
             if (!ctx2.isIndicatorRendered || !ctx2.value)
               return;
             ctx2.indicatorRect = dom.getRectById(ctx2, ctx2.value);
             if (ctx2.hasMeasuredRect)
               return;
-            nextTick(() => {
+            (0, import_dom_query3.nextTick)(() => {
               ctx2.hasMeasuredRect = true;
             });
           });
@@ -550,12 +407,13 @@ function machine(userContext) {
             ctx2.previousValues = pushUnique(Array.from(ctx2.previousValues), ctx2.value);
           }
         },
+        // if tab panel contains focusable elements, remove the tabindex attribute
         setContentTabIndex(ctx2) {
-          raf(() => {
+          (0, import_dom_query3.raf)(() => {
             const panel = dom.getActiveContentEl(ctx2);
             if (!panel)
               return;
-            const focusables = getFocusables(panel);
+            const focusables = (0, import_tabbable.getFocusables)(panel);
             if (focusables.length > 0) {
               panel.removeAttribute("tabindex");
             } else {

package/dist/index.mjs

@@ -1,13 +1,13 @@
 import {
   connect
-} from "./chunk-IVTIBLCN.mjs";
+} from "./chunk-5JW3YJ3I.mjs";
 import {
   anatomy
 } from "./chunk-S2KW2DT4.mjs";
 import {
   machine
-} from "./chunk-3DBUWLYX.mjs";
-import "./chunk-4CROPD6E.mjs";
+} from "./chunk-JG2VX4ST.mjs";
+import "./chunk-5ZMNIWHF.mjs";
 export {
   anatomy,
   connect,

package/dist/tabs.connect.d.ts

@@ -3,10 +3,25 @@ import { State, Send, TabProps } from './tabs.types.js';
 import '@zag-js/core';
 
 declare function connect<T extends PropTypes>(state: State, send: Send, normalize: NormalizeProps<T>): {
+    /**
+     * The current value of the tabs.
+     */
     value: string | null;
+    /**
+     * The value of the tab that is currently focused.
+     */
     focusedValue: string | null;
+    /**
+     * The previous values of the tabs in sequence of selection.
+     */
     previousValues: string[];
+    /**
+     * Sets the value of the tabs.
+     */
     setValue(value: string): void;
+    /**
+     * Clears the value of the tabs.
+     */
     clearValue(): void;
     rootProps: T["element"];
     tablistProps: T["element"];