@actview/floating-ui 0.1.0

package/dist/floating-ui.actview.utils.umd.js

@@ -0,0 +1,634 @@
+(function (global, factory) {
+  typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@actview/core'), require('@floating-ui/utils'), require('tabbable')) :
+  typeof define === 'function' && define.amd ? define(['exports', '@actview/core', '@floating-ui/utils', 'tabbable'], factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.FloatingUIActviewUtils = {}, global.ActviewCore, global.FloatingUIUtils, global.tabbable));
+})(this, (function (exports, core, utils, tabbable) { 'use strict';
+
+  function hasWindow() {
+    return typeof window !== 'undefined';
+  }
+  function getWindow(node) {
+    var _node$ownerDocument;
+    return (node == null || (_node$ownerDocument = node.ownerDocument) == null ? void 0 : _node$ownerDocument.defaultView) || window;
+  }
+  function isHTMLElement(value) {
+    if (!hasWindow()) {
+      return false;
+    }
+    return value instanceof HTMLElement || value instanceof getWindow(value).HTMLElement;
+  }
+  function isShadowRoot(value) {
+    if (!hasWindow() || typeof ShadowRoot === 'undefined') {
+      return false;
+    }
+    return value instanceof ShadowRoot || value instanceof getWindow(value).ShadowRoot;
+  }
+
+  // Avoid Chrome DevTools blue warning.
+  function getPlatform() {
+    const uaData = navigator.userAgentData;
+    if (uaData != null && uaData.platform) {
+      return uaData.platform;
+    }
+    return navigator.platform;
+  }
+  function getUserAgent() {
+    const uaData = navigator.userAgentData;
+    if (uaData && Array.isArray(uaData.brands)) {
+      return uaData.brands.map(_ref => {
+        let {
+          brand,
+          version
+        } = _ref;
+        return brand + "/" + version;
+      }).join(' ');
+    }
+    return navigator.userAgent;
+  }
+  function isSafari() {
+    // Chrome DevTools does not complain about navigator.vendor
+    return /apple/i.test(navigator.vendor);
+  }
+  function isAndroid() {
+    const re = /android/i;
+    return re.test(getPlatform()) || re.test(getUserAgent());
+  }
+  function isMac() {
+    return getPlatform().toLowerCase().startsWith('mac') && !navigator.maxTouchPoints;
+  }
+  function isJSDOM() {
+    return getUserAgent().includes('jsdom/');
+  }
+
+  const FOCUSABLE_ATTRIBUTE = 'data-floating-ui-focusable';
+  const TYPEABLE_SELECTOR = "input:not([type='hidden']):not([disabled])," + "[contenteditable]:not([contenteditable='false']),textarea:not([disabled])";
+  const ARROW_LEFT = 'ArrowLeft';
+  const ARROW_RIGHT = 'ArrowRight';
+  const ARROW_UP = 'ArrowUp';
+  const ARROW_DOWN = 'ArrowDown';
+
+  function activeElement(doc) {
+    let activeElement = doc.activeElement;
+    while (((_activeElement = activeElement) == null || (_activeElement = _activeElement.shadowRoot) == null ? void 0 : _activeElement.activeElement) != null) {
+      var _activeElement;
+      activeElement = activeElement.shadowRoot.activeElement;
+    }
+    return activeElement;
+  }
+  function contains(parent, child) {
+    if (!parent || !child) {
+      return false;
+    }
+    const rootNode = child.getRootNode == null ? void 0 : child.getRootNode();
+
+    // First, attempt with faster native method
+    // `parent.contains(window)` 在真实浏览器抛 TypeError（window 不是 Node），
+    // jsdom 则宽容返回 false；加 Node 防护对齐两环境行为（window mousemove 等
+    // 事件经 getTarget 取到 window 时）。
+    if (child instanceof Node && parent.contains(child)) {
+      return true;
+    }
+
+    // then fallback to custom implementation with Shadow DOM support
+    if (rootNode && isShadowRoot(rootNode)) {
+      let next = child;
+      while (next) {
+        if (parent === next) {
+          return true;
+        }
+        // @ts-ignore
+        next = next.parentNode || next.host;
+      }
+    }
+
+    // Give up, the result is false
+    return false;
+  }
+  function getTarget(event) {
+    if ('composedPath' in event) {
+      return event.composedPath()[0];
+    }
+
+    // TS thinks `event` is of type never as it assumes all browsers support
+    // `composedPath()`, but browsers without shadow DOM don't.
+    return event.target;
+  }
+  function isEventTargetWithin(event, node) {
+    if (node == null) {
+      return false;
+    }
+    if ('composedPath' in event) {
+      return event.composedPath().includes(node);
+    }
+
+    // TS thinks `event` is of type never as it assumes all browsers support composedPath, but browsers without shadow dom don't
+    const e = event;
+    return e.target != null && node.contains(e.target);
+  }
+  function isRootElement(element) {
+    return element.matches('html,body');
+  }
+  function getDocument(node) {
+    return (node == null ? void 0 : node.ownerDocument) || document;
+  }
+  function isTypeableElement(element) {
+    return isHTMLElement(element) && element.matches(TYPEABLE_SELECTOR);
+  }
+  function isTypeableCombobox(element) {
+    if (!element) return false;
+    return element.getAttribute('role') === 'combobox' && isTypeableElement(element);
+  }
+  function matchesFocusVisible(element) {
+    // We don't want to block focus from working with `visibleOnly`
+    // (JSDOM doesn't match `:focus-visible` when the element has `:focus`)
+    if (!element || isJSDOM()) return true;
+    try {
+      return element.matches(':focus-visible');
+    } catch (_e) {
+      return true;
+    }
+  }
+  function getFloatingFocusElement(floatingElement) {
+    if (!floatingElement) {
+      return null;
+    }
+    // Try to find the element that has `{...getFloatingProps()}` spread on it.
+    // This indicates the floating element is acting as a positioning wrapper, and
+    // so focus should be managed on the child element with the event handlers and
+    // aria props.
+    return floatingElement.hasAttribute(FOCUSABLE_ATTRIBUTE) ? floatingElement : floatingElement.querySelector("[" + FOCUSABLE_ATTRIBUTE + "]") || floatingElement;
+  }
+
+  function getNodeChildren(nodes, id, onlyOpenChildren) {
+    if (onlyOpenChildren === void 0) {
+      onlyOpenChildren = true;
+    }
+    const directChildren = nodes.filter(node => {
+      var _node$context;
+      return node.parentId === id && (!onlyOpenChildren || ((_node$context = node.context) == null ? void 0 : _node$context.open.value));
+    });
+    return directChildren.flatMap(child => [child, ...getNodeChildren(nodes, child.id, onlyOpenChildren)]);
+  }
+  function getDeepestNode(nodes, id) {
+    let deepestNodeId;
+    let maxDepth = -1;
+    function findDeepest(nodeId, depth) {
+      if (depth > maxDepth) {
+        deepestNodeId = nodeId;
+        maxDepth = depth;
+      }
+      const children = getNodeChildren(nodes, nodeId);
+      children.forEach(child => {
+        findDeepest(child.id, depth + 1);
+      });
+    }
+    findDeepest(id, 0);
+    return nodes.find(node => node.id === deepestNodeId);
+  }
+  function getNodeAncestors(nodes, id) {
+    var _nodes$find;
+    let allAncestors = [];
+    let currentParentId = (_nodes$find = nodes.find(node => node.id === id)) == null ? void 0 : _nodes$find.parentId;
+    while (currentParentId) {
+      const currentNode = nodes.find(node => node.id === currentParentId);
+      currentParentId = currentNode == null ? void 0 : currentNode.parentId;
+      if (currentNode) {
+        allAncestors = allAncestors.concat(currentNode);
+      }
+    }
+    return allAncestors;
+  }
+
+  // actview: `React.SyntheticEvent` → 结构类型（actview 事件是原生 Event）
+
+  function stopEvent(event) {
+    event.preventDefault();
+    event.stopPropagation();
+  }
+  function isReactEvent(event) {
+    return 'nativeEvent' in event;
+  }
+
+  // License: https://github.com/adobe/react-spectrum/blob/b35d5c02fe900badccd0cf1a8f23bb593419f238/packages/@react-aria/utils/src/isVirtualEvent.ts
+  function isVirtualClick(event) {
+    // FIXME: Firefox is now emitting a deprecation warning for `mozInputSource`.
+    // Try to find a workaround for this. `react-aria` source still has the check.
+    if (event.mozInputSource === 0 && event.isTrusted) {
+      return true;
+    }
+    if (isAndroid() && event.pointerType) {
+      return event.type === 'click' && event.buttons === 1;
+    }
+    return event.detail === 0 && !event.pointerType;
+  }
+  function isVirtualPointerEvent(event) {
+    if (isJSDOM()) return false;
+    return !isAndroid() && event.width === 0 && event.height === 0 || isAndroid() && event.width === 1 && event.height === 1 && event.pressure === 0 && event.detail === 0 && event.pointerType === 'mouse' ||
+    // iOS VoiceOver returns 0.333• for width/height.
+    event.width < 1 && event.height < 1 && event.pressure === 0 && event.detail === 0 && event.pointerType === 'touch';
+  }
+  function isMouseLikePointerType(pointerType, strict) {
+    // On some Linux machines with Chromium, mouse inputs return a `pointerType`
+    // of "pen": https://github.com/floating-ui/floating-ui/issues/2015
+    const values = ['mouse', 'pen'];
+    if (!strict) {
+      values.push('', undefined);
+    }
+    return values.includes(pointerType);
+  }
+
+  /**
+   * actview 版（upstream 为 React hooks：useLatestRef / useEffectEvent）。
+   *
+   * 与 upstream 的差异：
+   * - ref 为 actview 框架类型 `Ref<T>`（.value，非 React 的 .current），创建用 `ref()`
+   * - actview 无渲染循环与 effect 概念（setup 只执行一次、render 闭包每次渲染执行）——
+   *   `useLatestRef` 每次调用返回新的 `ref()`（引用稳定性由调用方负责）
+   * - `useEffectEvent` 无 useInsertionEffect 概念：回调在调用时同步写入 ref，
+   *   返回的稳定闭包始终调用最新回调。
+   * - `useModernLayoutEffect` 不再导出（React 专属，actview 无 layout effect）。
+   */
+  function useLatestRef(value) {
+    const r = core.ref(value);
+    return r;
+  }
+  function useEffectEvent(callback) {
+    const r = core.ref(callback);
+    return function () {
+      for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+        args[_key] = arguments[_key];
+      }
+      return r.value == null ? void 0 : r.value(...args);
+    };
+  }
+
+  // actview: `React.MutableRefObject<T>` → actview 框架类型 `Ref<T>`（.value）、
+  // `React.KeyboardEvent` → `KeyboardEventLike`（结构类型，无 React 依赖）
+
+  function isDifferentGridRow(index, cols, prevRow) {
+    return Math.floor(index / cols) !== prevRow;
+  }
+  function isIndexOutOfListBounds(listRef, index) {
+    return index < 0 || index >= listRef.value.length;
+  }
+  function getMinListIndex(listRef, disabledIndices) {
+    return findNonDisabledListIndex(listRef, {
+      disabledIndices
+    });
+  }
+  function getMaxListIndex(listRef, disabledIndices) {
+    return findNonDisabledListIndex(listRef, {
+      decrement: true,
+      startingIndex: listRef.value.length,
+      disabledIndices
+    });
+  }
+  function findNonDisabledListIndex(listRef, _temp) {
+    let {
+      startingIndex = -1,
+      decrement = false,
+      disabledIndices,
+      amount = 1
+    } = _temp === void 0 ? {} : _temp;
+    let index = startingIndex;
+    do {
+      index += decrement ? -amount : amount;
+    } while (index >= 0 && index <= listRef.value.length - 1 && isListIndexDisabled(listRef, index, disabledIndices));
+    return index;
+  }
+  function getGridNavigatedIndex(listRef, _ref) {
+    let {
+      event,
+      orientation,
+      loop,
+      rtl,
+      cols,
+      disabledIndices,
+      minIndex,
+      maxIndex,
+      prevIndex,
+      stopEvent: stop = false
+    } = _ref;
+    let nextIndex = prevIndex;
+    if (event.key === ARROW_UP) {
+      stop && stopEvent(event);
+      if (prevIndex === -1) {
+        nextIndex = maxIndex;
+      } else {
+        nextIndex = findNonDisabledListIndex(listRef, {
+          startingIndex: nextIndex,
+          amount: cols,
+          decrement: true,
+          disabledIndices
+        });
+        if (loop && (prevIndex - cols < minIndex || nextIndex < 0)) {
+          const col = prevIndex % cols;
+          const maxCol = maxIndex % cols;
+          const offset = maxIndex - (maxCol - col);
+          if (maxCol === col) {
+            nextIndex = maxIndex;
+          } else {
+            nextIndex = maxCol > col ? offset : offset - cols;
+          }
+        }
+      }
+      if (isIndexOutOfListBounds(listRef, nextIndex)) {
+        nextIndex = prevIndex;
+      }
+    }
+    if (event.key === ARROW_DOWN) {
+      stop && stopEvent(event);
+      if (prevIndex === -1) {
+        nextIndex = minIndex;
+      } else {
+        nextIndex = findNonDisabledListIndex(listRef, {
+          startingIndex: prevIndex,
+          amount: cols,
+          disabledIndices
+        });
+        if (loop && prevIndex + cols > maxIndex) {
+          nextIndex = findNonDisabledListIndex(listRef, {
+            startingIndex: prevIndex % cols - cols,
+            amount: cols,
+            disabledIndices
+          });
+        }
+      }
+      if (isIndexOutOfListBounds(listRef, nextIndex)) {
+        nextIndex = prevIndex;
+      }
+    }
+
+    // Remains on the same row/column.
+    if (orientation === 'both') {
+      const prevRow = utils.floor(prevIndex / cols);
+      if (event.key === (rtl ? ARROW_LEFT : ARROW_RIGHT)) {
+        stop && stopEvent(event);
+        if (prevIndex % cols !== cols - 1) {
+          nextIndex = findNonDisabledListIndex(listRef, {
+            startingIndex: prevIndex,
+            disabledIndices
+          });
+          if (loop && isDifferentGridRow(nextIndex, cols, prevRow)) {
+            nextIndex = findNonDisabledListIndex(listRef, {
+              startingIndex: prevIndex - prevIndex % cols - 1,
+              disabledIndices
+            });
+          }
+        } else if (loop) {
+          nextIndex = findNonDisabledListIndex(listRef, {
+            startingIndex: prevIndex - prevIndex % cols - 1,
+            disabledIndices
+          });
+        }
+        if (isDifferentGridRow(nextIndex, cols, prevRow)) {
+          nextIndex = prevIndex;
+        }
+      }
+      if (event.key === (rtl ? ARROW_RIGHT : ARROW_LEFT)) {
+        stop && stopEvent(event);
+        if (prevIndex % cols !== 0) {
+          nextIndex = findNonDisabledListIndex(listRef, {
+            startingIndex: prevIndex,
+            decrement: true,
+            disabledIndices
+          });
+          if (loop && isDifferentGridRow(nextIndex, cols, prevRow)) {
+            nextIndex = findNonDisabledListIndex(listRef, {
+              startingIndex: prevIndex + (cols - prevIndex % cols),
+              decrement: true,
+              disabledIndices
+            });
+          }
+        } else if (loop) {
+          nextIndex = findNonDisabledListIndex(listRef, {
+            startingIndex: prevIndex + (cols - prevIndex % cols),
+            decrement: true,
+            disabledIndices
+          });
+        }
+        if (isDifferentGridRow(nextIndex, cols, prevRow)) {
+          nextIndex = prevIndex;
+        }
+      }
+      const lastRow = utils.floor(maxIndex / cols) === prevRow;
+      if (isIndexOutOfListBounds(listRef, nextIndex)) {
+        if (loop && lastRow) {
+          nextIndex = event.key === (rtl ? ARROW_RIGHT : ARROW_LEFT) ? maxIndex : findNonDisabledListIndex(listRef, {
+            startingIndex: prevIndex - prevIndex % cols - 1,
+            disabledIndices
+          });
+        } else {
+          nextIndex = prevIndex;
+        }
+      }
+    }
+    return nextIndex;
+  }
+
+  /** For each cell index, gets the item index that occupies that cell */
+  function createGridCellMap(sizes, cols, dense) {
+    const cellMap = [];
+    let startIndex = 0;
+    sizes.forEach((_ref2, index) => {
+      let {
+        width,
+        height
+      } = _ref2;
+      if (width > cols) {
+        {
+          throw new Error("[Floating UI]: Invalid grid - item width at index " + index + " is greater than grid columns");
+        }
+      }
+      let itemPlaced = false;
+      if (dense) {
+        startIndex = 0;
+      }
+      while (!itemPlaced) {
+        const targetCells = [];
+        for (let i = 0; i < width; i++) {
+          for (let j = 0; j < height; j++) {
+            targetCells.push(startIndex + i + j * cols);
+          }
+        }
+        if (startIndex % cols + width <= cols && targetCells.every(cell => cellMap[cell] == null)) {
+          targetCells.forEach(cell => {
+            cellMap[cell] = index;
+          });
+          itemPlaced = true;
+        } else {
+          startIndex++;
+        }
+      }
+    });
+
+    // convert into a non-sparse array
+    return [...cellMap];
+  }
+
+  /** Gets cell index of an item's corner or -1 when index is -1. */
+  function getGridCellIndexOfCorner(index, sizes, cellMap, cols, corner) {
+    if (index === -1) return -1;
+    const firstCellIndex = cellMap.indexOf(index);
+    const sizeItem = sizes[index];
+    switch (corner) {
+      case 'tl':
+        return firstCellIndex;
+      case 'tr':
+        if (!sizeItem) {
+          return firstCellIndex;
+        }
+        return firstCellIndex + sizeItem.width - 1;
+      case 'bl':
+        if (!sizeItem) {
+          return firstCellIndex;
+        }
+        return firstCellIndex + (sizeItem.height - 1) * cols;
+      case 'br':
+        return cellMap.lastIndexOf(index);
+    }
+  }
+
+  /** Gets all cell indices that correspond to the specified indices */
+  function getGridCellIndices(indices, cellMap) {
+    return cellMap.flatMap((index, cellIndex) => indices.includes(index) ? [cellIndex] : []);
+  }
+  function isListIndexDisabled(listRef, index, disabledIndices) {
+    var _disabledIndices$incl;
+    const isExplicitlyDisabled = typeof disabledIndices === 'function' ? disabledIndices(index) : (_disabledIndices$incl = disabledIndices == null ? void 0 : disabledIndices.includes(index)) != null ? _disabledIndices$incl : false;
+    if (isExplicitlyDisabled) {
+      return true;
+    }
+    const element = listRef.value[index];
+    if (!element) {
+      return false;
+    }
+    if (!isElementVisible(element)) {
+      return true;
+    }
+
+    // A natively disabled element can never receive focus, so it must always be
+    // skipped, even when `disabledIndices` marks it as enabled. Only
+    // `aria-disabled` items can be focusable-while-disabled.
+    if (element.matches(':disabled')) {
+      return true;
+    }
+
+    // base-ui 语义：只有未显式传入 disabledIndices 时才检查属性
+    // （disabled/aria-disabled）。initial sync 故意不传 disabledIndices
+    // （mui/base-ui#2604），使属性禁用的项在打开时也被跳过；导航时传入
+    // disabledIndices 数组，由数组控制（aria-disabled 项可聚焦）。
+    return !disabledIndices && (element.hasAttribute('disabled') || element.getAttribute('aria-disabled') === 'true');
+  }
+  function isHiddenByStyles(styles) {
+    return styles.visibility === 'hidden' || styles.visibility === 'collapse';
+  }
+  function isElementVisible(element, styles) {
+    if (styles === void 0) {
+      styles = element ? getComputedStyle(element) : null;
+    }
+    if (!element || !element.isConnected || !styles || isHiddenByStyles(styles)) {
+      return false;
+    }
+    if (typeof element.checkVisibility === 'function') {
+      return element.checkVisibility();
+    }
+    return styles.display !== 'none' && styles.display !== 'contents';
+  }
+
+  const getTabbableOptions = () => ({
+    getShadowRoot: true,
+    displayCheck:
+    // JSDOM does not support the `tabbable` library. To solve this we can
+    // check if `ResizeObserver` is a real function (not polyfilled), which
+    // determines if the current environment is JSDOM-like.
+    typeof ResizeObserver === 'function' && ResizeObserver.toString().includes('[native code]') ? 'full' : 'none'
+  });
+  function getTabbableIn(container, dir) {
+    const list = tabbable.tabbable(container, getTabbableOptions());
+    const len = list.length;
+    if (len === 0) return;
+    const active = activeElement(getDocument(container));
+    const index = list.indexOf(active);
+    const nextIndex = index === -1 ? dir === 1 ? 0 : len - 1 : index + dir;
+    return list[nextIndex];
+  }
+  function getNextTabbable(referenceElement) {
+    return getTabbableIn(getDocument(referenceElement).body, 1) || referenceElement;
+  }
+  function getPreviousTabbable(referenceElement) {
+    return getTabbableIn(getDocument(referenceElement).body, -1) || referenceElement;
+  }
+
+  // actview: `React.FocusEvent` → 结构类型（actview 事件是原生 FocusEvent）
+  function isOutsideEvent(event, container) {
+    const containerElement = container || event.currentTarget;
+    const relatedTarget = event.relatedTarget;
+    return !relatedTarget || !contains(containerElement, relatedTarget);
+  }
+  function disableFocusInside(container) {
+    const tabbableElements = tabbable.tabbable(container, getTabbableOptions());
+    tabbableElements.forEach(element => {
+      element.dataset.tabindex = element.getAttribute('tabindex') || '';
+      element.setAttribute('tabindex', '-1');
+    });
+  }
+  function enableFocusInside(container) {
+    const elements = container.querySelectorAll('[data-tabindex]');
+    elements.forEach(element => {
+      const tabindex = element.dataset.tabindex;
+      delete element.dataset.tabindex;
+      if (tabindex) {
+        element.setAttribute('tabindex', tabindex);
+      } else {
+        element.removeAttribute('tabindex');
+      }
+    });
+  }
+
+  exports.activeElement = activeElement;
+  exports.contains = contains;
+  exports.createGridCellMap = createGridCellMap;
+  exports.disableFocusInside = disableFocusInside;
+  exports.enableFocusInside = enableFocusInside;
+  exports.findNonDisabledListIndex = findNonDisabledListIndex;
+  exports.getDeepestNode = getDeepestNode;
+  exports.getDocument = getDocument;
+  exports.getFloatingFocusElement = getFloatingFocusElement;
+  exports.getGridCellIndexOfCorner = getGridCellIndexOfCorner;
+  exports.getGridCellIndices = getGridCellIndices;
+  exports.getGridNavigatedIndex = getGridNavigatedIndex;
+  exports.getMaxListIndex = getMaxListIndex;
+  exports.getMinListIndex = getMinListIndex;
+  exports.getNextTabbable = getNextTabbable;
+  exports.getNodeAncestors = getNodeAncestors;
+  exports.getNodeChildren = getNodeChildren;
+  exports.getPlatform = getPlatform;
+  exports.getPreviousTabbable = getPreviousTabbable;
+  exports.getTabbableOptions = getTabbableOptions;
+  exports.getTarget = getTarget;
+  exports.getUserAgent = getUserAgent;
+  exports.isAndroid = isAndroid;
+  exports.isDifferentGridRow = isDifferentGridRow;
+  exports.isElementVisible = isElementVisible;
+  exports.isEventTargetWithin = isEventTargetWithin;
+  exports.isHiddenByStyles = isHiddenByStyles;
+  exports.isIndexOutOfListBounds = isIndexOutOfListBounds;
+  exports.isJSDOM = isJSDOM;
+  exports.isListIndexDisabled = isListIndexDisabled;
+  exports.isMac = isMac;
+  exports.isMouseLikePointerType = isMouseLikePointerType;
+  exports.isOutsideEvent = isOutsideEvent;
+  exports.isReactEvent = isReactEvent;
+  exports.isRootElement = isRootElement;
+  exports.isSafari = isSafari;
+  exports.isTypeableCombobox = isTypeableCombobox;
+  exports.isTypeableElement = isTypeableElement;
+  exports.isVirtualClick = isVirtualClick;
+  exports.isVirtualPointerEvent = isVirtualPointerEvent;
+  exports.matchesFocusVisible = matchesFocusVisible;
+  exports.stopEvent = stopEvent;
+  exports.useEffectEvent = useEffectEvent;
+  exports.useLatestRef = useLatestRef;
+
+}));

package/dist/floating-ui.actview.utils.umd.min.js

@@ -0,0 +1 @@
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("@actview/core"),require("@floating-ui/utils"),require("tabbable")):"function"==typeof define&&define.amd?define(["exports","@actview/core","@floating-ui/utils","tabbable"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).FloatingUIActviewUtils={},e.ActviewCore,e.FloatingUIUtils,e.tabbable)}(this,(function(e,t,n,i){"use strict";function r(){return"undefined"!=typeof window}function o(e){var t;return(null==e||null==(t=e.ownerDocument)?void 0:t.defaultView)||window}function a(){const e=navigator.userAgentData;return null!=e&&e.platform?e.platform:navigator.platform}function s(){const e=navigator.userAgentData;return e&&Array.isArray(e.brands)?e.brands.map((e=>{let{brand:t,version:n}=e;return t+"/"+n})).join(" "):navigator.userAgent}function d(){const e=/android/i;return e.test(a())||e.test(s())}function u(){return s().includes("jsdom/")}const l="data-floating-ui-focusable",c="ArrowLeft",f="ArrowRight";function b(e){let t=e.activeElement;for(;null!=(null==(n=t)||null==(n=n.shadowRoot)?void 0:n.activeElement);){var n;t=t.shadowRoot.activeElement}return t}function g(e,t){if(!e||!t)return!1;const n=null==t.getRootNode?void 0:t.getRootNode();if(t instanceof Node&&e.contains(t))return!0;if(n&&(i=n,r()&&"undefined"!=typeof ShadowRoot&&(i instanceof ShadowRoot||i instanceof o(i).ShadowRoot))){let n=t;for(;n;){if(e===n)return!0;n=n.parentNode||n.host}}var i;return!1}function v(e){return(null==e?void 0:e.ownerDocument)||document}function h(e){return t=e,!!r()&&(t instanceof HTMLElement||t instanceof o(t).HTMLElement)&&e.matches("input:not([type='hidden']):not([disabled]),[contenteditable]:not([contenteditable='false']),textarea:not([disabled])");var t}function p(e,t,n){void 0===n&&(n=!0);return e.filter((e=>{var i;return e.parentId===t&&(!n||(null==(i=e.context)?void 0:i.open.value))})).flatMap((t=>[t,...p(e,t.id,n)]))}function m(e){e.preventDefault(),e.stopPropagation()}function I(e,t,n){return Math.floor(e/t)!==n}function x(e,t){return t<0||t>=e.value.length}function y(e,t){let{startingIndex:n=-1,decrement:i=!1,disabledIndices:r,amount:o=1}=void 0===t?{}:t,a=n;do{a+=i?-o:o}while(a>=0&&a<=e.value.length-1&&w(e,a,r));return a}function w(e,t,n){var i;if("function"==typeof n?n(t):null!=(i=null==n?void 0:n.includes(t))&&i)return!0;const r=e.value[t];return!!r&&(!E(r)||(!!r.matches(":disabled")||!n&&(r.hasAttribute("disabled")||"true"===r.getAttribute("aria-disabled"))))}function A(e){return"hidden"===e.visibility||"collapse"===e.visibility}function E(e,t){return void 0===t&&(t=e?getComputedStyle(e):null),!(!(e&&e.isConnected&&t)||A(t))&&("function"==typeof e.checkVisibility?e.checkVisibility():"none"!==t.display&&"contents"!==t.display)}const T=()=>({getShadowRoot:!0,displayCheck:"function"==typeof ResizeObserver&&ResizeObserver.toString().includes("[native code]")?"full":"none"});function R(e,t){const n=i.tabbable(e,T()),r=n.length;if(0===r)return;const o=b(v(e)),a=n.indexOf(o);return n[-1===a?1===t?0:r-1:a+t]}e.activeElement=b,e.contains=g,e.createGridCellMap=function(e,t,n){const i=[];let r=0;return e.forEach(((e,o)=>{let{width:a,height:s}=e,d=!1;for(n&&(r=0);!d;){const e=[];for(let n=0;n<a;n++)for(let i=0;i<s;i++)e.push(r+n+i*t);r%t+a<=t&&e.every((e=>null==i[e]))?(e.forEach((e=>{i[e]=o})),d=!0):r++}})),[...i]},e.disableFocusInside=function(e){i.tabbable(e,T()).forEach((e=>{e.dataset.tabindex=e.getAttribute("tabindex")||"",e.setAttribute("tabindex","-1")}))},e.enableFocusInside=function(e){e.querySelectorAll("[data-tabindex]").forEach((e=>{const t=e.dataset.tabindex;delete e.dataset.tabindex,t?e.setAttribute("tabindex",t):e.removeAttribute("tabindex")}))},e.findNonDisabledListIndex=y,e.getDeepestNode=function(e,t){let n,i=-1;return function t(r,o){o>i&&(n=r,i=o),p(e,r).forEach((e=>{t(e.id,o+1)}))}(t,0),e.find((e=>e.id===n))},e.getDocument=v,e.getFloatingFocusElement=function(e){return e?e.hasAttribute(l)?e:e.querySelector("["+l+"]")||e:null},e.getGridCellIndexOfCorner=function(e,t,n,i,r){if(-1===e)return-1;const o=n.indexOf(e),a=t[e];switch(r){case"tl":return o;case"tr":return a?o+a.width-1:o;case"bl":return a?o+(a.height-1)*i:o;case"br":return n.lastIndexOf(e)}},e.getGridCellIndices=function(e,t){return t.flatMap(((t,n)=>e.includes(t)?[n]:[]))},e.getGridNavigatedIndex=function(e,t){let{event:i,orientation:r,loop:o,rtl:a,cols:s,disabledIndices:d,minIndex:u,maxIndex:l,prevIndex:b,stopEvent:g=!1}=t,v=b;if("ArrowUp"===i.key){if(g&&m(i),-1===b)v=l;else if(v=y(e,{startingIndex:v,amount:s,decrement:!0,disabledIndices:d}),o&&(b-s<u||v<0)){const e=b%s,t=l%s,n=l-(t-e);v=t===e?l:t>e?n:n-s}x(e,v)&&(v=b)}if("ArrowDown"===i.key&&(g&&m(i),-1===b?v=u:(v=y(e,{startingIndex:b,amount:s,disabledIndices:d}),o&&b+s>l&&(v=y(e,{startingIndex:b%s-s,amount:s,disabledIndices:d}))),x(e,v)&&(v=b)),"both"===r){const t=n.floor(b/s);i.key===(a?c:f)&&(g&&m(i),b%s!=s-1?(v=y(e,{startingIndex:b,disabledIndices:d}),o&&I(v,s,t)&&(v=y(e,{startingIndex:b-b%s-1,disabledIndices:d}))):o&&(v=y(e,{startingIndex:b-b%s-1,disabledIndices:d})),I(v,s,t)&&(v=b)),i.key===(a?f:c)&&(g&&m(i),b%s!=0?(v=y(e,{startingIndex:b,decrement:!0,disabledIndices:d}),o&&I(v,s,t)&&(v=y(e,{startingIndex:b+(s-b%s),decrement:!0,disabledIndices:d}))):o&&(v=y(e,{startingIndex:b+(s-b%s),decrement:!0,disabledIndices:d})),I(v,s,t)&&(v=b));const r=n.floor(l/s)===t;x(e,v)&&(v=o&&r?i.key===(a?f:c)?l:y(e,{startingIndex:b-b%s-1,disabledIndices:d}):b)}return v},e.getMaxListIndex=function(e,t){return y(e,{decrement:!0,startingIndex:e.value.length,disabledIndices:t})},e.getMinListIndex=function(e,t){return y(e,{disabledIndices:t})},e.getNextTabbable=function(e){return R(v(e).body,1)||e},e.getNodeAncestors=function(e,t){var n;let i=[],r=null==(n=e.find((e=>e.id===t)))?void 0:n.parentId;for(;r;){const t=e.find((e=>e.id===r));r=null==t?void 0:t.parentId,t&&(i=i.concat(t))}return i},e.getNodeChildren=p,e.getPlatform=a,e.getPreviousTabbable=function(e){return R(v(e).body,-1)||e},e.getTabbableOptions=T,e.getTarget=function(e){return"composedPath"in e?e.composedPath()[0]:e.target},e.getUserAgent=s,e.isAndroid=d,e.isDifferentGridRow=I,e.isElementVisible=E,e.isEventTargetWithin=function(e,t){if(null==t)return!1;if("composedPath"in e)return e.composedPath().includes(t);const n=e;return null!=n.target&&t.contains(n.target)},e.isHiddenByStyles=A,e.isIndexOutOfListBounds=x,e.isJSDOM=u,e.isListIndexDisabled=w,e.isMac=function(){return a().toLowerCase().startsWith("mac")&&!navigator.maxTouchPoints},e.isMouseLikePointerType=function(e,t){const n=["mouse","pen"];return t||n.push("",void 0),n.includes(e)},e.isOutsideEvent=function(e,t){const n=t||e.currentTarget,i=e.relatedTarget;return!i||!g(n,i)},e.isReactEvent=function(e){return"nativeEvent"in e},e.isRootElement=function(e){return e.matches("html,body")},e.isSafari=function(){return/apple/i.test(navigator.vendor)},e.isTypeableCombobox=function(e){return!!e&&("combobox"===e.getAttribute("role")&&h(e))},e.isTypeableElement=h,e.isVirtualClick=function(e){return!(0!==e.mozInputSource||!e.isTrusted)||(d()&&e.pointerType?"click"===e.type&&1===e.buttons:0===e.detail&&!e.pointerType)},e.isVirtualPointerEvent=function(e){return!u()&&(!d()&&0===e.width&&0===e.height||d()&&1===e.width&&1===e.height&&0===e.pressure&&0===e.detail&&"mouse"===e.pointerType||e.width<1&&e.height<1&&0===e.pressure&&0===e.detail&&"touch"===e.pointerType)},e.matchesFocusVisible=function(e){if(!e||u())return!0;try{return e.matches(":focus-visible")}catch(e){return!0}},e.stopEvent=m,e.useEffectEvent=function(e){const n=t.ref(e);return function(){for(var e=arguments.length,t=new Array(e),i=0;i<e;i++)t[i]=arguments[i];return null==n.value?void 0:n.value(...t)}},e.useLatestRef=function(e){return t.ref(e)}}));

package/dist/hooks/gridNavigation.d.ts

@@ -0,0 +1,39 @@
+import type { Ref } from '@actview/core';
+import { type DisabledIndices } from '../utils/composite';
+interface KeyboardEventLike {
+    key: string;
+    which: number;
+    altKey: boolean;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    shiftKey: boolean;
+    defaultPrevented: boolean;
+}
+type List = Array<HTMLElement | null>;
+type ListRef = Ref<List>;
+export declare function getGridNavigatedIndex(list: List, { event, orientation, loop, onLoop, rtl, cols, disabledIndices, minIndex, maxIndex, prevIndex, stopEvent: stop, }: {
+    event: KeyboardEventLike;
+    orientation: 'horizontal' | 'vertical' | 'both';
+    loop: boolean;
+    onLoop?: ((event: KeyboardEventLike, prevIndex: number, nextIndex: number) => number) | undefined;
+    rtl: boolean;
+    cols: number;
+    disabledIndices: DisabledIndices | undefined;
+    minIndex: number;
+    maxIndex: number;
+    prevIndex: number;
+    stopEvent?: boolean | undefined;
+}): number;
+/**
+ * Positional arguments are deliberate: property names of an options object
+ * don't minify, and the signature is locked to the caller via `typeof` on the
+ * `grid` option of `useListNavigation`.
+ *
+ * The injected grid navigator only ever operates on a uniform 1x1 grid (sizes are
+ * always `1x1` and packing is never dense), so the cell-map machinery that supports
+ * multi-cell items collapses to an identity transform over the item list. Calling
+ * `getGridNavigatedIndex` directly keeps the cell-map helpers out of
+ * grid-combobox bundles.
+ */
+export declare function gridNavigation(event: KeyboardEventLike, prevIndex: number, listRef: ListRef, orientation: 'horizontal' | 'vertical' | 'both', loop: boolean, rtl: boolean, disabledIndices: DisabledIndices | undefined, minIndex: number, maxIndex: number, cols?: number): number | undefined;
+export {};