@zag-js/pin-input 0.2.5 → 0.2.7

package/dist/chunk-6HKN4SOY.mjs

@@ -0,0 +1,344 @@
+import {
+  isObject
+} from "./chunk-NT4W6JYX.mjs";
+import {
+  dom,
+  getWindow
+} from "./chunk-OI3DK2PT.mjs";
+
+// src/pin-input.machine.ts
+import { createMachine, guards } from "@zag-js/core";
+
+// ../../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/next-tick.ts
+function raf(fn) {
+  const id = globalThis.requestAnimationFrame(fn);
+  return function cleanup() {
+    globalThis.cancelAnimationFrame(id);
+  };
+}
+
+// ../../utilities/form-utils/src/input-event.ts
+function getDescriptor(el, options) {
+  var _a;
+  const { type, property = "value" } = options;
+  const proto = getWindow(el)[type].prototype;
+  return (_a = Object.getOwnPropertyDescriptor(proto, property)) != null ? _a : {};
+}
+function dispatchInputValueEvent(el, value) {
+  var _a;
+  if (!el)
+    return;
+  const win = getWindow(el);
+  if (!(el instanceof win.HTMLInputElement))
+    return;
+  const desc = getDescriptor(el, { type: "HTMLInputElement", property: "value" });
+  (_a = desc.set) == null ? void 0 : _a.call(el, value);
+  const event = new win.Event("input", { bubbles: true });
+  el.dispatchEvent(event);
+}
+
+// src/pin-input.machine.ts
+var { and, not } = guards;
+function machine(userContext) {
+  const ctx = compact(userContext);
+  return createMachine(
+    {
+      id: "pin-input",
+      initial: "unknown",
+      context: {
+        value: [],
+        focusedIndex: -1,
+        placeholder: "\u25CB",
+        otp: false,
+        type: "numeric",
+        ...ctx,
+        translations: {
+          inputLabel: (index, length) => `pin code ${index + 1} of ${length}`,
+          ...ctx.translations
+        }
+      },
+      computed: {
+        valueLength: (ctx2) => ctx2.value.length,
+        filledValueLength: (ctx2) => ctx2.value.filter((v) => (v == null ? void 0 : v.trim()) !== "").length,
+        isValueComplete: (ctx2) => ctx2.valueLength === ctx2.filledValueLength,
+        valueAsString: (ctx2) => ctx2.value.join(""),
+        focusedValue: (ctx2) => ctx2.value[ctx2.focusedIndex]
+      },
+      watch: {
+        focusedIndex: ["focusInput", "setInputSelection"],
+        value: ["dispatchInputEvent"],
+        isValueComplete: ["invokeOnComplete", "blurFocusedInputIfNeeded"]
+      },
+      on: {
+        SET_VALUE: [
+          {
+            guard: "hasIndex",
+            actions: ["setValueAtIndex", "invokeOnChange"]
+          },
+          { actions: ["setValue", "invokeOnChange"] }
+        ],
+        CLEAR_VALUE: [
+          {
+            guard: "isDisabled",
+            actions: ["clearValue", "invokeOnChange"]
+          },
+          {
+            actions: ["clearValue", "invokeOnChange", "setFocusIndexToFirst"]
+          }
+        ]
+      },
+      states: {
+        unknown: {
+          on: {
+            SETUP: [
+              {
+                guard: "autoFocus",
+                target: "focused",
+                actions: ["setupValue", "setFocusIndexToFirst"]
+              },
+              {
+                target: "idle",
+                actions: "setupValue"
+              }
+            ]
+          }
+        },
+        idle: {
+          on: {
+            FOCUS: {
+              target: "focused",
+              actions: "setFocusedIndex"
+            }
+          }
+        },
+        focused: {
+          on: {
+            INPUT: [
+              {
+                guard: and("isFinalValue", "isValidValue"),
+                actions: ["setFocusedValue", "invokeOnChange", "dispatchInputEventIfNeeded"]
+              },
+              {
+                guard: "isValidValue",
+                actions: ["setFocusedValue", "invokeOnChange", "setNextFocusedIndex", "dispatchInputEventIfNeeded"]
+              }
+            ],
+            PASTE: [
+              {
+                guard: "isValidValue",
+                actions: ["setPastedValue", "invokeOnChange", "setLastValueFocusIndex"]
+              },
+              { actions: ["resetFocusedValue", "invokeOnChange"] }
+            ],
+            BLUR: {
+              target: "idle",
+              actions: "clearFocusedIndex"
+            },
+            DELETE: {
+              guard: "hasValue",
+              actions: ["clearFocusedValue", "invokeOnChange"]
+            },
+            ARROW_LEFT: {
+              actions: "setPrevFocusedIndex"
+            },
+            ARROW_RIGHT: {
+              actions: "setNextFocusedIndex"
+            },
+            BACKSPACE: [
+              {
+                guard: "hasValue",
+                actions: ["clearFocusedValue", "invokeOnChange"]
+              },
+              {
+                actions: ["setPrevFocusedIndex", "clearFocusedValue", "invokeOnChange"]
+              }
+            ],
+            ENTER: {
+              guard: "isValueComplete",
+              actions: "requestFormSubmit"
+            },
+            KEY_DOWN: {
+              guard: not("isValidValue"),
+              actions: ["preventDefault", "invokeOnInvalid"]
+            }
+          }
+        }
+      }
+    },
+    {
+      guards: {
+        autoFocus: (ctx2) => !!ctx2.autoFocus,
+        isValueEmpty: (_ctx, evt) => evt.value === "",
+        hasValue: (ctx2) => ctx2.value[ctx2.focusedIndex] !== "",
+        isValueComplete: (ctx2) => ctx2.isValueComplete,
+        isValidValue: (ctx2, evt) => {
+          if (!ctx2.pattern)
+            return isValidType(evt.value, ctx2.type);
+          const regex = new RegExp(ctx2.pattern, "g");
+          return regex.test(evt.value);
+        },
+        isFinalValue: (ctx2) => {
+          return ctx2.filledValueLength + 1 === ctx2.valueLength && ctx2.value.findIndex((v) => v.trim() === "") === ctx2.focusedIndex;
+        },
+        isLastInputFocused: (ctx2) => ctx2.focusedIndex === ctx2.valueLength - 1,
+        hasIndex: (_ctx, evt) => evt.index !== void 0,
+        isDisabled: (ctx2) => !!ctx2.disabled
+      },
+      actions: {
+        setupValue: (ctx2) => {
+          const inputs = dom.getElements(ctx2);
+          const empty = Array.from({ length: inputs.length }).map(() => "");
+          ctx2.value = Object.assign(empty, ctx2.value);
+        },
+        focusInput: (ctx2) => {
+          raf(() => {
+            var _a;
+            if (ctx2.focusedIndex === -1)
+              return;
+            (_a = dom.getFocusedEl(ctx2)) == null ? void 0 : _a.focus();
+          });
+        },
+        setInputSelection: (ctx2) => {
+          raf(() => {
+            if (ctx2.focusedIndex === -1)
+              return;
+            const input = dom.getFocusedEl(ctx2);
+            const length = input.value.length;
+            input.selectionStart = ctx2.selectOnFocus ? 0 : length;
+            input.selectionEnd = length;
+          });
+        },
+        invokeOnComplete: (ctx2) => {
+          var _a;
+          if (!ctx2.isValueComplete)
+            return;
+          (_a = ctx2.onComplete) == null ? void 0 : _a.call(ctx2, { value: Array.from(ctx2.value), valueAsString: ctx2.valueAsString });
+        },
+        invokeOnChange: (ctx2, evt) => {
+          var _a;
+          if (evt.type === "SETUP")
+            return;
+          (_a = ctx2.onChange) == null ? void 0 : _a.call(ctx2, { value: Array.from(ctx2.value) });
+        },
+        dispatchInputEvent: (ctx2, evt) => {
+          if (evt.type === "SETUP")
+            return;
+          dispatchInputValueEvent(dom.getHiddenInputEl(ctx2), ctx2.valueAsString);
+          const inputs = dom.getElements(ctx2);
+          ctx2.value.forEach((val, index) => {
+            const input = inputs[index];
+            input.value = val || "";
+          });
+        },
+        invokeOnInvalid: (ctx2, evt) => {
+          var _a;
+          (_a = ctx2.onInvalid) == null ? void 0 : _a.call(ctx2, { value: evt.value, index: ctx2.focusedIndex });
+        },
+        clearFocusedIndex: (ctx2) => {
+          ctx2.focusedIndex = -1;
+        },
+        setValue: (ctx2, evt) => {
+          assign(ctx2, evt.value);
+        },
+        setFocusedIndex: (ctx2, evt) => {
+          ctx2.focusedIndex = evt.index;
+        },
+        setFocusedValue: (ctx2, evt) => {
+          ctx2.value[ctx2.focusedIndex] = lastChar(evt.value);
+        },
+        dispatchInputEventIfNeeded: (ctx2, evt) => {
+          const valueIsChanged = lastChar(evt.value) !== ctx2.focusedValue;
+          if (evt.value.length <= 1 || valueIsChanged)
+            return;
+          const inputs = dom.getElements(ctx2);
+          const input = inputs[ctx2.focusedIndex];
+          input.value = lastChar(evt.value);
+        },
+        setPastedValue(ctx2, evt) {
+          raf(() => {
+            const startIndex = ctx2.focusedValue ? 1 : 0;
+            const value = evt.value.substring(startIndex, ctx2.valueLength);
+            assign(ctx2, value);
+          });
+        },
+        setValueAtIndex: (ctx2, evt) => {
+          ctx2.value[evt.index] = lastChar(evt.value);
+        },
+        clearValue: (ctx2) => {
+          ctx2.value = ctx2.value.map(() => "");
+        },
+        clearFocusedValue: (ctx2) => {
+          ctx2.value[ctx2.focusedIndex] = "";
+        },
+        resetFocusedValue: (ctx2) => {
+          const input = dom.getFocusedEl(ctx2);
+          input.value = ctx2.focusedValue;
+        },
+        setFocusIndexToFirst: (ctx2) => {
+          ctx2.focusedIndex = 0;
+        },
+        setNextFocusedIndex: (ctx2) => {
+          ctx2.focusedIndex = Math.min(ctx2.focusedIndex + 1, ctx2.valueLength - 1);
+        },
+        setPrevFocusedIndex: (ctx2) => {
+          ctx2.focusedIndex = Math.max(ctx2.focusedIndex - 1, 0);
+        },
+        setLastValueFocusIndex: (ctx2) => {
+          raf(() => {
+            ctx2.focusedIndex = Math.min(ctx2.filledValueLength, ctx2.valueLength - 1);
+          });
+        },
+        preventDefault(_, evt) {
+          evt.preventDefault();
+        },
+        blurFocusedInputIfNeeded(ctx2) {
+          if (!ctx2.blurOnComplete)
+            return;
+          raf(() => {
+            var _a;
+            (_a = dom.getFocusedEl(ctx2)) == null ? void 0 : _a.blur();
+          });
+        },
+        requestFormSubmit(ctx2) {
+          var _a;
+          if (!ctx2.name)
+            return;
+          const input = dom.getHiddenInputEl(ctx2);
+          (_a = input == null ? void 0 : input.form) == null ? void 0 : _a.requestSubmit();
+        }
+      }
+    }
+  );
+}
+var REGEX = {
+  numeric: /^[0-9]+$/,
+  alphabetic: /^[A-Za-z]+$/,
+  alphanumeric: /^[a-zA-Z0-9]+$/i
+};
+function isValidType(value, type) {
+  var _a;
+  if (!type)
+    return true;
+  return !!((_a = REGEX[type]) == null ? void 0 : _a.test(value));
+}
+function assign(ctx, value) {
+  const valueArr = Array.isArray(value) ? value : value.split("").filter(Boolean);
+  const valueObj = Object.assign({}, ctx.value, valueArr);
+  ctx.value = Object.values(valueObj);
+}
+function lastChar(value) {
+  return value.charAt(value.length - 1);
+}
+
+export {
+  machine
+};

package/dist/chunk-BJXKBZJG.mjs

@@ -0,0 +1,9 @@
+// src/pin-input.anatomy.ts
+import { createAnatomy } from "@zag-js/anatomy";
+var anatomy = createAnatomy("pinInput").parts("root", "label", "hiddenInput", "input", "control");
+var parts = anatomy.build();
+
+export {
+  anatomy,
+  parts
+};

package/dist/chunk-NT4W6JYX.mjs

@@ -0,0 +1,7 @@
+// ../../utilities/core/src/guard.ts
+var isArray = (v) => Array.isArray(v);
+var isObject = (v) => !(v == null || typeof v !== "object" || isArray(v));
+
+export {
+  isObject
+};

package/dist/chunk-OI3DK2PT.mjs

@@ -0,0 +1,100 @@
+// ../../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 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
+  };
+}
+
+// ../../utilities/dom/src/nodelist.ts
+function queryAll(root, selector) {
+  var _a;
+  return Array.from((_a = root == null ? void 0 : root.querySelectorAll(selector)) != null ? _a : []);
+}
+
+// src/pin-input.dom.ts
+var dom = defineDomHelpers({
+  getRootId: (ctx) => {
+    var _a, _b;
+    return (_b = (_a = ctx.ids) == null ? void 0 : _a.root) != null ? _b : `pin-input:${ctx.id}`;
+  },
+  getInputId: (ctx, id) => {
+    var _a, _b, _c;
+    return (_c = (_b = (_a = ctx.ids) == null ? void 0 : _a.input) == null ? void 0 : _b.call(_a, id)) != null ? _c : `pin-input:${ctx.id}:${id}`;
+  },
+  getHiddenInputId: (ctx) => {
+    var _a, _b;
+    return (_b = (_a = ctx.ids) == null ? void 0 : _a.hiddenInput) != null ? _b : `pin-input:${ctx.id}:hidden`;
+  },
+  getLabelId: (ctx) => {
+    var _a, _b;
+    return (_b = (_a = ctx.ids) == null ? void 0 : _a.label) != null ? _b : `pin-input:${ctx.id}:label`;
+  },
+  getControlId: (ctx) => {
+    var _a, _b;
+    return (_b = (_a = ctx.ids) == null ? void 0 : _a.control) != null ? _b : `pin-input:${ctx.id}:control`;
+  },
+  getRootEl: (ctx) => dom.getById(ctx, dom.getRootId(ctx)),
+  getElements: (ctx) => {
+    const ownerId = CSS.escape(dom.getRootId(ctx));
+    const selector = `input[data-ownedby=${ownerId}]`;
+    return queryAll(dom.getRootEl(ctx), selector);
+  },
+  getFocusedEl: (ctx) => dom.getElements(ctx)[ctx.focusedIndex],
+  getFirstInputEl: (ctx) => dom.getElements(ctx)[0],
+  getHiddenInputEl: (ctx) => dom.getById(ctx, dom.getHiddenInputId(ctx))
+});
+
+export {
+  getWindow,
+  dom
+};

package/dist/chunk-QX3A66VS.mjs

@@ -0,0 +1,212 @@
+import {
+  parts
+} from "./chunk-BJXKBZJG.mjs";
+import {
+  dom
+} from "./chunk-OI3DK2PT.mjs";
+
+// ../../utilities/dom/src/attrs.ts
+var dataAttr = (guard) => {
+  return guard ? "" : void 0;
+};
+var ariaAttr = (guard) => {
+  return guard ? "true" : void 0;
+};
+
+// ../../utilities/core/src/warning.ts
+function invariant(...a) {
+  const m = a.length === 1 ? a[0] : a[1];
+  const c = a.length === 2 ? a[0] : true;
+  if (c && process.env.NODE_ENV !== "production") {
+    throw new Error(m);
+  }
+}
+
+// ../../utilities/dom/src/event.ts
+function getNativeEvent(e) {
+  var _a;
+  return (_a = e.nativeEvent) != null ? _a : e;
+}
+var isModifiedEvent = (v) => v.ctrlKey || v.altKey || v.metaKey;
+
+// ../../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 = {}) {
+  var _a;
+  const { dir = "ltr", orientation = "horizontal" } = options;
+  let { key } = event;
+  key = (_a = sameKeyMap[key]) != null ? _a : key;
+  const isRtl = dir === "rtl" && orientation === "horizontal";
+  if (isRtl && key in rtlKeyMap) {
+    key = rtlKeyMap[key];
+  }
+  return key;
+}
+
+// ../../utilities/dom/src/visually-hidden.ts
+var visuallyHiddenStyle = {
+  border: "0",
+  clip: "rect(0 0 0 0)",
+  height: "1px",
+  margin: "-1px",
+  overflow: "hidden",
+  padding: "0",
+  position: "absolute",
+  width: "1px",
+  whiteSpace: "nowrap",
+  wordWrap: "normal"
+};
+
+// src/pin-input.connect.ts
+function connect(state, send, normalize) {
+  const isValueComplete = state.context.isValueComplete;
+  const isInvalid = state.context.invalid;
+  const focusedIndex = state.context.focusedIndex;
+  const translations = state.context.translations;
+  function focus() {
+    var _a;
+    (_a = dom.getFirstInputEl(state.context)) == null ? void 0 : _a.focus();
+  }
+  return {
+    value: state.context.value,
+    valueAsString: state.context.valueAsString,
+    isValueComplete,
+    setValue(value) {
+      if (!Array.isArray(value)) {
+        invariant("[pin-input/setValue] value must be an array");
+      }
+      send({ type: "SET_VALUE", value });
+    },
+    clearValue() {
+      send({ type: "CLEAR_VALUE" });
+    },
+    setValueAtIndex(index, value) {
+      send({ type: "SET_VALUE", value, index });
+    },
+    focus,
+    rootProps: normalize.element({
+      dir: state.context.dir,
+      ...parts.root.attrs,
+      id: dom.getRootId(state.context),
+      "data-invalid": dataAttr(isInvalid),
+      "data-disabled": dataAttr(state.context.disabled),
+      "data-complete": dataAttr(isValueComplete)
+    }),
+    labelProps: normalize.label({
+      ...parts.label.attrs,
+      htmlFor: dom.getHiddenInputId(state.context),
+      id: dom.getLabelId(state.context),
+      "data-invalid": dataAttr(isInvalid),
+      "data-disabled": dataAttr(state.context.disabled),
+      "data-complete": dataAttr(isValueComplete),
+      onClick: (event) => {
+        event.preventDefault();
+        focus();
+      }
+    }),
+    hiddenInputProps: normalize.input({
+      ...parts.hiddenInput.attrs,
+      "aria-hidden": true,
+      type: "text",
+      tabIndex: -1,
+      id: dom.getHiddenInputId(state.context),
+      name: state.context.name,
+      form: state.context.form,
+      style: visuallyHiddenStyle,
+      maxLength: state.context.valueLength,
+      defaultValue: state.context.valueAsString
+    }),
+    controlProps: normalize.element({
+      ...parts.control.attrs,
+      id: dom.getControlId(state.context)
+    }),
+    getInputProps({ index }) {
+      const inputType = state.context.type === "numeric" ? "tel" : "text";
+      return normalize.input({
+        ...parts.input.attrs,
+        disabled: state.context.disabled,
+        "data-disabled": dataAttr(state.context.disabled),
+        "data-complete": dataAttr(isValueComplete),
+        id: dom.getInputId(state.context, index.toString()),
+        "data-ownedby": dom.getRootId(state.context),
+        "aria-label": translations.inputLabel(index, state.context.valueLength),
+        inputMode: state.context.otp || state.context.type === "numeric" ? "numeric" : "text",
+        "aria-invalid": ariaAttr(isInvalid),
+        "data-invalid": dataAttr(isInvalid),
+        type: state.context.mask ? "password" : inputType,
+        defaultValue: state.context.value[index] || "",
+        autoCapitalize: "none",
+        autoComplete: state.context.otp ? "one-time-code" : "off",
+        placeholder: focusedIndex === index ? "" : state.context.placeholder,
+        onChange(event) {
+          const evt = getNativeEvent(event);
+          const { value } = event.currentTarget;
+          if (evt.inputType === "insertFromPaste" || value.length > 2) {
+            send({ type: "PASTE", value });
+            event.preventDefault();
+            return;
+          }
+          if (evt.inputType === "deleteContentBackward") {
+            send("BACKSPACE");
+            return;
+          }
+          send({ type: "INPUT", value });
+        },
+        onKeyDown(event) {
+          const evt = getNativeEvent(event);
+          if (evt.isComposing || isModifiedEvent(evt))
+            return;
+          const keyMap = {
+            Backspace() {
+              send("BACKSPACE");
+            },
+            Delete() {
+              send("DELETE");
+            },
+            ArrowLeft() {
+              send("ARROW_LEFT");
+            },
+            ArrowRight() {
+              send("ARROW_RIGHT");
+            },
+            Enter() {
+              send("ENTER");
+            }
+          };
+          const key = getEventKey(event, { dir: state.context.dir });
+          const exec = keyMap[key];
+          if (exec) {
+            exec(event);
+            event.preventDefault();
+          } else {
+            if (key === "Tab")
+              return;
+            send({ type: "KEY_DOWN", value: key, preventDefault: () => event.preventDefault() });
+          }
+        },
+        onFocus() {
+          send({ type: "FOCUS", index });
+        },
+        onBlur() {
+          send({ type: "BLUR", index });
+        }
+      });
+    }
+  };
+}
+
+export {
+  connect
+};