@multiplatform.one/forms 6.0.0

package/dist/cjs/hooks/useFocusManagement.native.js

@@ -0,0 +1,270 @@
+"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);
+var useFocusManagement_exports = {};
+__export(useFocusManagement_exports, {
+  useFocusManagement: () => useFocusManagement,
+  useOTPFocusManagement: () => useOTPFocusManagement,
+  useSearchableDropdownFocus: () => useSearchableDropdownFocus
+});
+module.exports = __toCommonJS(useFocusManagement_exports);
+var import_react = require("react");
+var import_tamagui = require("tamagui");
+function _instanceof(left, right) {
+  "@swc/helpers - instanceof";
+
+  if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+    return !!right[Symbol.hasInstance](left);
+  } else {
+    return left instanceof right;
+  }
+}
+function useFocusManagement() {
+  var options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
+  var {
+    trapFocus = false,
+    restoreFocus = true,
+    initialFocus = "none",
+    autoFocusDelay = 0,
+    onFocusChange
+  } = options;
+  var containerRef = (0, import_react.useRef)(null);
+  var [focusedElement, setFocusedElement] = (0, import_react.useState)(null);
+  var [isFocusTrapped, setIsFocusTrapped] = (0, import_react.useState)(trapFocus);
+  var previouslyFocusedElement = (0, import_react.useRef)(null);
+  var hasAppliedInitialFocus = (0, import_react.useRef)(false);
+  var focusableSelectors = (0, import_react.useRef)(["a[href]", "button:not([disabled])", "textarea:not([disabled])", "input:not([disabled])", "select:not([disabled])", "[tabindex]:not([tabindex='-1'])", "[contenteditable='true']"]);
+  var getFocusableElements = (0, import_react.useCallback)(function () {
+    if (!containerRef.current) return [];
+    var elements = containerRef.current.querySelectorAll(focusableSelectors.current.join(", "));
+    return Array.from(elements).filter(function (el) {
+      if (el.tabIndex === -1) return false;
+      if (typeof el.closest === "function" && el.closest("[data-focus-skip]")) return false;
+      return true;
+    });
+  }, []);
+  var focusElement = (0, import_react.useCallback)(function (element) {
+    if (element && typeof element.focus === "function") {
+      element.focus();
+      setFocusedElement(element);
+      onFocusChange === null || onFocusChange === void 0 ? void 0 : onFocusChange(element);
+    }
+  }, [onFocusChange]);
+  var focusNext = (0, import_react.useCallback)(function () {
+    var focusableElements = getFocusableElements();
+    if (focusableElements.length === 0) return;
+    var currentIndex = focusedElement ? focusableElements.indexOf(focusedElement) : -1;
+    var nextIndex = currentIndex < focusableElements.length - 1 ? currentIndex + 1 : 0;
+    focusElement(focusableElements[nextIndex]);
+  }, [focusedElement, getFocusableElements, focusElement]);
+  var focusPrevious = (0, import_react.useCallback)(function () {
+    var focusableElements = getFocusableElements();
+    if (focusableElements.length === 0) return;
+    var currentIndex = focusedElement ? focusableElements.indexOf(focusedElement) : 0;
+    var prevIndex = currentIndex > 0 ? currentIndex - 1 : focusableElements.length - 1;
+    focusElement(focusableElements[prevIndex]);
+  }, [focusedElement, getFocusableElements, focusElement]);
+  var handleKeyDown = (0, import_react.useCallback)(function (event) {
+    if (!isFocusTrapped) return;
+    switch (event.key) {
+      case "Tab":
+        event.preventDefault();
+        if (event.shiftKey) {
+          focusPrevious();
+        } else {
+          focusNext();
+        }
+        break;
+      case "ArrowDown":
+        event.preventDefault();
+        focusNext();
+        break;
+      case "ArrowUp":
+        event.preventDefault();
+        focusPrevious();
+        break;
+      case "Home":
+        {
+          event.preventDefault();
+          var firstElement = getFocusableElements()[0];
+          if (firstElement) focusElement(firstElement);
+          break;
+        }
+      case "End":
+        {
+          event.preventDefault();
+          var focusableElements = getFocusableElements();
+          var lastElement = focusableElements[focusableElements.length - 1];
+          if (lastElement) focusElement(lastElement);
+          break;
+        }
+    }
+  }, [isFocusTrapped, focusNext, focusPrevious, getFocusableElements, focusElement]);
+  var handleFocusIn = (0, import_react.useCallback)(function (event) {
+    var _containerRef_current;
+    var target = event.target;
+    if ((_containerRef_current = containerRef.current) === null || _containerRef_current === void 0 ? void 0 : _containerRef_current.contains(target)) {
+      setFocusedElement(target);
+      onFocusChange === null || onFocusChange === void 0 ? void 0 : onFocusChange(target);
+    }
+  }, [onFocusChange]);
+  var handleFocusOut = (0, import_react.useCallback)(function (event) {
+    var _containerRef_current;
+    var relatedTarget = event.relatedTarget;
+    if (!((_containerRef_current = containerRef.current) === null || _containerRef_current === void 0 ? void 0 : _containerRef_current.contains(relatedTarget))) {
+      setFocusedElement(null);
+      onFocusChange === null || onFocusChange === void 0 ? void 0 : onFocusChange(null);
+    }
+  }, [onFocusChange]);
+  var setFocusTrap = (0, import_react.useCallback)(function (enabled) {
+    setIsFocusTrapped(enabled);
+  }, []);
+  (0, import_react.useEffect)(function () {
+    if (!import_tamagui.isWeb) return;
+    var container = containerRef.current;
+    if (!container) return;
+    if (restoreFocus && typeof document !== "undefined") {
+      previouslyFocusedElement.current = document.activeElement;
+    }
+    container.addEventListener("keydown", handleKeyDown);
+    container.addEventListener("focusin", handleFocusIn);
+    container.addEventListener("focusout", handleFocusOut);
+    var focusTimer;
+    if (initialFocus !== "none" && !hasAppliedInitialFocus.current) {
+      hasAppliedInitialFocus.current = true;
+      focusTimer = setTimeout(function () {
+        if (initialFocus === "first") {
+          var firstElement = getFocusableElements()[0];
+          if (firstElement) focusElement(firstElement);
+        } else if (_instanceof(initialFocus, HTMLElement)) {
+          focusElement(initialFocus);
+        }
+      }, autoFocusDelay);
+    }
+    return function () {
+      if (focusTimer !== void 0) clearTimeout(focusTimer);
+      container.removeEventListener("keydown", handleKeyDown);
+      container.removeEventListener("focusin", handleFocusIn);
+      container.removeEventListener("focusout", handleFocusOut);
+    };
+  }, [handleKeyDown, handleFocusIn, handleFocusOut, initialFocus, autoFocusDelay, getFocusableElements, focusElement, restoreFocus]);
+  (0, import_react.useEffect)(function () {
+    if (!import_tamagui.isWeb) return;
+    return function () {
+      if (restoreFocus && previouslyFocusedElement.current) {
+        previouslyFocusedElement.current.focus();
+      }
+    };
+  }, [restoreFocus]);
+  return {
+    containerRef,
+    focusedElement,
+    focusNext,
+    focusPrevious,
+    focusElement,
+    getFocusableElements,
+    setFocusTrap
+  };
+}
+function useOTPFocusManagement(length, _onComplete) {
+  var [focusedIndex, setFocusedIndex] = (0, import_react.useState)(-1);
+  var inputRefs = (0, import_react.useRef)(Array(length).fill(null));
+  var focusInput = (0, import_react.useCallback)(function (index) {
+    if (index >= 0 && index < length && inputRefs.current[index]) {
+      var _inputRefs_current_index;
+      (_inputRefs_current_index = inputRefs.current[index]) === null || _inputRefs_current_index === void 0 ? void 0 : _inputRefs_current_index.focus();
+      setFocusedIndex(index);
+    }
+  }, [length]);
+  var handleKeyPress = (0, import_react.useCallback)(function (index, key, value) {
+    switch (key) {
+      case "Backspace":
+        if (!value && index > 0) {
+          focusInput(index - 1);
+        }
+        break;
+      case "ArrowLeft":
+        if (index > 0) focusInput(index - 1);
+        break;
+      case "ArrowRight":
+        if (index < length - 1) focusInput(index + 1);
+        break;
+      default:
+        if (/^\d$/.test(key) && value && index < length - 1) {
+          focusInput(index + 1);
+        }
+        break;
+    }
+  }, [length, focusInput]);
+  var setInputRef = (0, import_react.useCallback)(function (index, ref) {
+    inputRefs.current[index] = ref;
+  }, []);
+  return {
+    focusedIndex,
+    focusInput,
+    handleKeyPress,
+    setInputRef
+  };
+}
+function useSearchableDropdownFocus(isOpen, items, onSelect) {
+  var [highlightedIndex, setHighlightedIndex] = (0, import_react.useState)(-1);
+  (0, import_react.useEffect)(function () {
+    if (!isOpen) {
+      setHighlightedIndex(-1);
+    }
+  }, [isOpen]);
+  var handleKeyDown = (0, import_react.useCallback)(function (event) {
+    if (!isOpen || items.length === 0) return;
+    switch (event.key) {
+      case "ArrowDown":
+        event.preventDefault();
+        setHighlightedIndex(function (prev) {
+          return prev < items.length - 1 ? prev + 1 : 0;
+        });
+        break;
+      case "ArrowUp":
+        event.preventDefault();
+        setHighlightedIndex(function (prev) {
+          return prev > 0 ? prev - 1 : items.length - 1;
+        });
+        break;
+      case "Enter":
+        event.preventDefault();
+        if (highlightedIndex >= 0 && highlightedIndex < items.length) {
+          onSelect === null || onSelect === void 0 ? void 0 : onSelect(items[highlightedIndex]);
+        }
+        break;
+      case "Escape":
+        event.preventDefault();
+        setHighlightedIndex(-1);
+        break;
+    }
+  }, [isOpen, items, highlightedIndex, onSelect]);
+  return {
+    highlightedIndex,
+    setHighlightedIndex,
+    handleKeyDown
+  };
+}
+//# sourceMappingURL=useFocusManagement.native.js.map

package/dist/cjs/hooks/useFocusManagement.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","useFocusManagement_exports","__export","useFocusManagement","useOTPFocusManagement","useSearchableDropdownFocus","module","exports","import_react","require","import_tamagui","_instanceof","left","right","Symbol","hasInstance","options","arguments","length","trapFocus","restoreFocus","initialFocus","autoFocusDelay","onFocusChange","containerRef","useRef","focusedElement","setFocusedElement","useState","isFocusTrapped","setIsFocusTrapped","previouslyFocusedElement","hasAppliedInitialFocus","focusableSelectors","getFocusableElements","useCallback","current","elements","querySelectorAll","join","Array","from","filter","el","tabIndex","closest","focusElement","element","focus","focusNext","focusableElements","currentIndex","indexOf","nextIndex","focusPrevious","prevIndex","handleKeyDown","event","key","preventDefault","shiftKey","firstElement","lastElement","handleFocusIn","_containerRef_current","target","contains","handleFocusOut","relatedTarget","setFocusTrap","enabled","useEffect","isWeb","container","document","activeElement","addEventListener","focusTimer","setTimeout","HTMLElement","clearTimeout","removeEventListener","_onComplete","focusedIndex","setFocusedIndex","inputRefs","fill","focusInput","index","_inputRefs_current_index","handleKeyPress","test","setInputRef","ref","isOpen","items","onSelect","highlightedIndex","setHighlightedIndex","prev"],"sources":["../../../src/hooks/useFocusManagement.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/cjs/hooks/useFocusManagement.spec.cjs

@@ -0,0 +1,241 @@
+var import_react = require("@testing-library/react");
+var import_vitest = require("vitest");
+var import_test_utils = require("@multiplatform.one/test-utils");
+var import_useFocusManagement = require("./useFocusManagement.cjs");
+var import_jsx_runtime = require("react/jsx-runtime");
+const mockFocus = import_vitest.vi.fn();
+const mockContains = import_vitest.vi.fn();
+(0, import_vitest.beforeAll)(() => {
+  Object.defineProperty(HTMLElement.prototype, "focus", {
+    writable: true,
+    value: mockFocus
+  });
+  Object.defineProperty(HTMLElement.prototype, "contains", {
+    writable: true,
+    value: mockContains
+  });
+  Object.defineProperty(document, "activeElement", {
+    writable: true,
+    value: null
+  });
+  const mockQuerySelectorAll = import_vitest.vi.fn();
+  Object.defineProperty(HTMLElement.prototype, "querySelectorAll", {
+    writable: true,
+    value: mockQuerySelectorAll
+  });
+});
+(0, import_vitest.describe)("useFocusManagement", () => {
+  (0, import_vitest.describe)("basic functionality", () => {
+    (0, import_vitest.it)("should return the correct interface", () => {
+      const TestComponent = () => {
+        const focusManagement = (0, import_useFocusManagement.useFocusManagement)();
+        (0, import_vitest.expect)(focusManagement).toHaveProperty("containerRef");
+        (0, import_vitest.expect)(focusManagement).toHaveProperty("focusedElement");
+        (0, import_vitest.expect)(focusManagement).toHaveProperty("focusNext");
+        (0, import_vitest.expect)(focusManagement).toHaveProperty("focusPrevious");
+        (0, import_vitest.expect)(focusManagement).toHaveProperty("focusElement");
+        (0, import_vitest.expect)(focusManagement).toHaveProperty("getFocusableElements");
+        (0, import_vitest.expect)(focusManagement).toHaveProperty("setFocusTrap");
+        (0, import_vitest.expect)(typeof focusManagement.containerRef).toBe("object");
+        (0, import_vitest.expect)(typeof focusManagement.focusNext).toBe("function");
+        (0, import_vitest.expect)(typeof focusManagement.focusPrevious).toBe("function");
+        (0, import_vitest.expect)(typeof focusManagement.focusElement).toBe("function");
+        (0, import_vitest.expect)(typeof focusManagement.getFocusableElements).toBe("function");
+        (0, import_vitest.expect)(typeof focusManagement.setFocusTrap).toBe("function");
+        return null;
+      };
+      (0, import_test_utils.renderWithProviders)(/* @__PURE__ */(0, import_jsx_runtime.jsx)(TestComponent, {}));
+    });
+    (0, import_vitest.it)("should initialize with default options", () => {
+      const TestComponent = () => {
+        const focusManagement = (0, import_useFocusManagement.useFocusManagement)();
+        (0, import_vitest.expect)(focusManagement.containerRef.current).toBeNull();
+        (0, import_vitest.expect)(focusManagement.focusedElement).toBeNull();
+        return null;
+      };
+      (0, import_test_utils.renderWithProviders)(/* @__PURE__ */(0, import_jsx_runtime.jsx)(TestComponent, {}));
+    });
+  });
+  (0, import_vitest.describe)("container ref", () => {
+    (0, import_vitest.it)("should provide a container ref", () => {
+      let refValue = null;
+      const TestComponent = () => {
+        const focusManagement = (0, import_useFocusManagement.useFocusManagement)();
+        refValue = focusManagement.containerRef;
+        return /* @__PURE__ */(0, import_jsx_runtime.jsx)("div", {
+          ref: focusManagement.containerRef,
+          "data-testid": "container",
+          children: /* @__PURE__ */(0, import_jsx_runtime.jsx)("button", {
+            type: "button",
+            children: "Test Button"
+          })
+        });
+      };
+      (0, import_test_utils.renderWithProviders)(/* @__PURE__ */(0, import_jsx_runtime.jsx)(TestComponent, {}));
+      (0, import_vitest.expect)(refValue).toHaveProperty("current");
+    });
+  });
+  (0, import_vitest.describe)("focusable elements detection", () => {
+    (0, import_vitest.it)("should return empty array when no container", () => {
+      const TestComponent = () => {
+        const focusManagement = (0, import_useFocusManagement.useFocusManagement)();
+        const elements = focusManagement.getFocusableElements();
+        (0, import_vitest.expect)(elements).toHaveLength(0);
+        return null;
+      };
+      (0, import_test_utils.renderWithProviders)(/* @__PURE__ */(0, import_jsx_runtime.jsx)(TestComponent, {}));
+    });
+  });
+  (0, import_vitest.describe)("initial focus", () => {
+    (0, import_vitest.it)("should not set initial focus when set to none", () => {
+      const TestComponent = () => {
+        const focusManagement = (0, import_useFocusManagement.useFocusManagement)({
+          initialFocus: "none"
+        });
+        return /* @__PURE__ */(0, import_jsx_runtime.jsx)("div", {
+          ref: focusManagement.containerRef,
+          children: "Test"
+        });
+      };
+      (0, import_test_utils.renderWithProviders)(/* @__PURE__ */(0, import_jsx_runtime.jsx)(TestComponent, {}));
+      (0, import_vitest.expect)(mockFocus).not.toHaveBeenCalled();
+    });
+  });
+  (0, import_vitest.describe)("auto focus delay", () => {
+    (0, import_vitest.it)("should delay initial focus", () => {
+      import_vitest.vi.useFakeTimers();
+      const mockElement = {
+        focus: import_vitest.vi.fn()
+      };
+      HTMLElement.prototype.querySelectorAll = import_vitest.vi.fn(() => ({
+        [Symbol.iterator]: function* () {
+          yield mockElement;
+        }
+      }));
+      const TestComponent = () => {
+        const focusManagement = (0, import_useFocusManagement.useFocusManagement)({
+          initialFocus: "first",
+          autoFocusDelay: 1e3
+        });
+        return /* @__PURE__ */(0, import_jsx_runtime.jsx)("div", {
+          ref: focusManagement.containerRef,
+          children: "Test"
+        });
+      };
+      (0, import_test_utils.renderWithProviders)(/* @__PURE__ */(0, import_jsx_runtime.jsx)(TestComponent, {}));
+      (0, import_vitest.expect)(mockElement.focus).not.toHaveBeenCalled();
+      (0, import_react.act)(() => {
+        import_vitest.vi.advanceTimersByTime(1e3);
+      });
+      (0, import_vitest.expect)(mockElement.focus).toHaveBeenCalled();
+      import_vitest.vi.useRealTimers();
+    });
+  });
+  (0, import_vitest.describe)("focus change callback", () => {
+    (0, import_vitest.it)("should call onFocusChange when focus changes", () => {
+      const onFocusChange = import_vitest.vi.fn();
+      let testFocusManagement;
+      const TestComponent = () => {
+        testFocusManagement = (0, import_useFocusManagement.useFocusManagement)({
+          onFocusChange
+        });
+        return /* @__PURE__ */(0, import_jsx_runtime.jsx)("div", {
+          ref: testFocusManagement.containerRef,
+          children: "Test"
+        });
+      };
+      (0, import_test_utils.renderWithProviders)(/* @__PURE__ */(0, import_jsx_runtime.jsx)(TestComponent, {}));
+      const mockElement = {
+        focus: import_vitest.vi.fn()
+      };
+      (0, import_react.act)(() => {
+        testFocusManagement.focusElement(mockElement);
+      });
+      (0, import_vitest.expect)(onFocusChange).toHaveBeenCalledWith(mockElement);
+    });
+  });
+  (0, import_vitest.describe)("restore focus", () => {
+    (0, import_vitest.it)("should restore focus when enabled", () => {
+      const mockPreviouslyFocused = {
+        focus: import_vitest.vi.fn()
+      };
+      Object.defineProperty(document, "activeElement", {
+        value: mockPreviouslyFocused
+      });
+      const TestComponent = () => {
+        const focusManagement = (0, import_useFocusManagement.useFocusManagement)({
+          restoreFocus: true
+        });
+        return /* @__PURE__ */(0, import_jsx_runtime.jsx)("div", {
+          ref: focusManagement.containerRef,
+          children: "Test"
+        });
+      };
+      const {
+        unmount
+      } = (0, import_test_utils.renderWithProviders)(/* @__PURE__ */(0, import_jsx_runtime.jsx)(TestComponent, {}));
+      unmount();
+      (0, import_vitest.expect)(mockPreviouslyFocused.focus).toHaveBeenCalled();
+    });
+    (0, import_vitest.it)("should not restore focus when disabled", () => {
+      const mockPreviouslyFocused = {
+        focus: import_vitest.vi.fn()
+      };
+      Object.defineProperty(document, "activeElement", {
+        value: mockPreviouslyFocused
+      });
+      const TestComponent = () => {
+        const focusManagement = (0, import_useFocusManagement.useFocusManagement)({
+          restoreFocus: false
+        });
+        return /* @__PURE__ */(0, import_jsx_runtime.jsx)("div", {
+          ref: focusManagement.containerRef,
+          children: "Test"
+        });
+      };
+      const {
+        unmount
+      } = (0, import_test_utils.renderWithProviders)(/* @__PURE__ */(0, import_jsx_runtime.jsx)(TestComponent, {}));
+      unmount();
+      (0, import_vitest.expect)(mockPreviouslyFocused.focus).not.toHaveBeenCalled();
+    });
+  });
+});
+(0, import_vitest.describe)("useOTPFocusManagement", () => {
+  (0, import_vitest.it)("should return the correct interface", () => {
+    const TestComponent = () => {
+      const otpFocus = (0, import_useFocusManagement.useOTPFocusManagement)(6);
+      (0, import_vitest.expect)(otpFocus).toHaveProperty("focusedIndex");
+      (0, import_vitest.expect)(otpFocus).toHaveProperty("focusInput");
+      (0, import_vitest.expect)(otpFocus).toHaveProperty("handleKeyPress");
+      (0, import_vitest.expect)(otpFocus).toHaveProperty("setInputRef");
+      (0, import_vitest.expect)(typeof otpFocus.focusInput).toBe("function");
+      (0, import_vitest.expect)(typeof otpFocus.handleKeyPress).toBe("function");
+      (0, import_vitest.expect)(typeof otpFocus.setInputRef).toBe("function");
+      return null;
+    };
+    (0, import_test_utils.renderWithProviders)(/* @__PURE__ */(0, import_jsx_runtime.jsx)(TestComponent, {}));
+  });
+});
+(0, import_vitest.describe)("useSearchableDropdownFocus", () => {
+  (0, import_vitest.it)("should return the correct interface", () => {
+    const TestComponent = () => {
+      const dropdownFocus = (0, import_useFocusManagement.useSearchableDropdownFocus)(true, []);
+      (0, import_vitest.expect)(dropdownFocus).toHaveProperty("highlightedIndex");
+      (0, import_vitest.expect)(dropdownFocus).toHaveProperty("setHighlightedIndex");
+      (0, import_vitest.expect)(dropdownFocus).toHaveProperty("handleKeyDown");
+      (0, import_vitest.expect)(typeof dropdownFocus.setHighlightedIndex).toBe("function");
+      (0, import_vitest.expect)(typeof dropdownFocus.handleKeyDown).toBe("function");
+      return null;
+    };
+    (0, import_test_utils.renderWithProviders)(/* @__PURE__ */(0, import_jsx_runtime.jsx)(TestComponent, {}));
+  });
+  (0, import_vitest.it)("should reset highlighted index when closed", () => {
+    const TestComponent = () => {
+      const dropdownFocus = (0, import_useFocusManagement.useSearchableDropdownFocus)(false, ["Item 1"]);
+      (0, import_vitest.expect)(dropdownFocus.highlightedIndex).toBe(-1);
+      return null;
+    };
+    (0, import_test_utils.renderWithProviders)(/* @__PURE__ */(0, import_jsx_runtime.jsx)(TestComponent, {}));
+  });
+});