@zag-js/pin-input 0.1.11 → 0.1.14

package/dist/index.d.ts

@@ -8,6 +8,7 @@ declare type IntlMessages = {
 declare type ElementIds = Partial<{
     root: string;
     hiddenInput: string;
+    label: string;
     input(id: string): string;
 }>;
 declare type PublicContext = DirectionProperty & CommonProperties & {
@@ -123,8 +124,9 @@ declare function connect<T extends PropTypes>(state: State, send: Send, normaliz
     setValue(value: string[]): void;
     clearValue(): void;
     setValueAtIndex(index: number, value: string): void;
-    focus(): void;
+    focus: () => void;
     rootProps: T["element"];
+    labelProps: T["label"];
     hiddenInputProps: T["input"];
     getInputProps({ index }: {
         index: number;

package/dist/index.js

@@ -45,9 +45,6 @@ function getDocument(el) {
     return el;
   return (el == null ? void 0 : el.ownerDocument) ?? document;
 }
-function getWindow(el) {
-  return (el == null ? void 0 : el.ownerDocument.defaultView) ?? window;
-}
 function defineDomHelpers(helpers) {
   const dom2 = {
     getRootNode: (ctx) => {
@@ -68,28 +65,9 @@ function getNativeEvent(e) {
   return e.nativeEvent ?? e;
 }
 var isModifiedEvent = (v) => v.ctrlKey || v.altKey || v.metaKey;
-function getDescriptor(el, options) {
-  const { type, property } = options;
-  const proto = getWindow(el)[type].prototype;
-  return Object.getOwnPropertyDescriptor(proto, property) ?? {};
-}
-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);
-}
 var rtlKeyMap = {
   ArrowLeft: "ArrowRight",
-  ArrowRight: "ArrowLeft",
-  Home: "End",
-  End: "Home"
+  ArrowRight: "ArrowLeft"
 };
 var sameKeyMap = {
   Up: "ArrowUp",
@@ -155,6 +133,10 @@ var dom = defineDomHelpers({
     var _a;
     return ((_a = ctx.ids) == null ? void 0 : _a.hiddenInput) ?? `pin-input:${ctx.id}:hidden`;
   },
+  getLabelId: (ctx) => {
+    var _a;
+    return ((_a = ctx.ids) == null ? void 0 : _a.label) ?? `pin-input:${ctx.id}:label`;
+  },
   getRootEl: (ctx) => dom.getById(ctx, dom.getRootId(ctx)),
   getElements: (ctx) => {
     const ownerId = CSS.escape(dom.getRootId(ctx));
@@ -172,6 +154,10 @@ function connect(state, send, normalize) {
   const isInvalid = state.context.invalid;
   const focusedIndex = state.context.focusedIndex;
   const messages = state.context.messages;
+  function focus() {
+    var _a;
+    (_a = dom.getFirstInputEl(state.context)) == null ? void 0 : _a.focus();
+  }
   return {
     value: state.context.value,
     valueAsString: state.context.valueAsString,
@@ -188,10 +174,7 @@ function connect(state, send, normalize) {
     setValueAtIndex(index, value) {
       send({ type: "SET_VALUE", value, index });
     },
-    focus() {
-      var _a;
-      (_a = dom.getFirstInputEl(state.context)) == null ? void 0 : _a.focus();
-    },
+    focus,
     rootProps: normalize.element({
       dir: state.context.dir,
       "data-part": "root",
@@ -200,6 +183,18 @@ function connect(state, send, normalize) {
       "data-disabled": dataAttr(state.context.disabled),
       "data-complete": dataAttr(isValueComplete)
     }),
+    labelProps: normalize.label({
+      "data-part": "label",
+      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({
       "aria-hidden": true,
       type: "text",
@@ -269,6 +264,8 @@ function connect(state, send, normalize) {
             exec(event);
             event.preventDefault();
           } else {
+            if (key === "Tab")
+              return;
             send({ type: "KEY_DOWN", value: key, preventDefault: () => event.preventDefault() });
           }
         },
@@ -285,237 +282,264 @@ function connect(state, send, normalize) {
 
 // src/pin-input.machine.ts
 var import_core = require("@zag-js/core");
+
+// ../../utilities/form-utils/dist/index.mjs
+function getWindow(el) {
+  return (el == null ? void 0 : el.ownerDocument.defaultView) ?? window;
+}
+function getDescriptor(el, options) {
+  const { type, property } = options;
+  const proto = getWindow(el)[type].prototype;
+  return Object.getOwnPropertyDescriptor(proto, property) ?? {};
+}
+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 } = import_core.guards;
 function machine(ctx) {
-  return (0, import_core.createMachine)({
-    id: "pin-input",
-    initial: "unknown",
-    context: {
-      value: [],
-      focusedIndex: -1,
-      placeholder: "\u25CB",
-      otp: false,
-      type: "numeric",
-      ...ctx,
-      messages: {
-        inputLabel: (index, length) => `pin code ${index + 1} of ${length}`,
-        ...ctx.messages
-      }
-    },
-    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("")
-    },
-    watch: {
-      focusedIndex: "focusInput",
-      value: "invokeOnChange",
-      isValueComplete: ["invokeOnComplete", "blurFocusedInputIfNeeded"]
-    },
-    on: {
-      SET_VALUE: [
-        {
-          guard: "hasIndex",
-          actions: "setValueAtIndex"
-        },
-        { actions: "setValue" }
-      ],
-      CLEAR_VALUE: [
-        {
-          guard: "isDisabled",
-          actions: "clearValue"
-        },
-        {
-          actions: ["clearValue", "setFocusIndexToFirst"]
-        }
-      ]
-    },
-    states: {
-      unknown: {
-        on: {
-          SETUP: [
-            {
-              guard: "autoFocus",
-              target: "focused",
-              actions: ["setupValue", "setFocusIndexToFirst"]
-            },
-            {
-              target: "idle",
-              actions: "setupValue"
-            }
-          ]
+  return (0, import_core.createMachine)(
+    {
+      id: "pin-input",
+      initial: "unknown",
+      context: {
+        value: [],
+        focusedIndex: -1,
+        placeholder: "\u25CB",
+        otp: false,
+        type: "numeric",
+        ...ctx,
+        messages: {
+          inputLabel: (index, length) => `pin code ${index + 1} of ${length}`,
+          ...ctx.messages
         }
       },
-      idle: {
-        on: {
-          FOCUS: {
-            target: "focused",
-            actions: "setFocusedIndex"
-          }
-        }
+      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("")
       },
-      focused: {
-        on: {
-          INPUT: [
-            {
-              guard: and("isFinalValue", "isValidValue"),
-              actions: "setFocusedValue"
-            },
-            {
-              guard: "isValidValue",
-              actions: ["setFocusedValue", "setNextFocusedIndex"]
-            }
-          ],
-          PASTE: {
-            guard: "isValidValue",
-            actions: ["setPastedValue", "setLastValueFocusIndex"]
-          },
-          BLUR: {
-            target: "idle",
-            actions: "clearFocusedIndex"
-          },
-          DELETE: {
-            guard: "hasValue",
-            actions: "clearFocusedValue"
-          },
-          ARROW_LEFT: {
-            actions: "setPrevFocusedIndex"
+      watch: {
+        focusedIndex: "focusInput",
+        value: "invokeOnChange",
+        isValueComplete: ["invokeOnComplete", "blurFocusedInputIfNeeded"]
+      },
+      on: {
+        SET_VALUE: [
+          {
+            guard: "hasIndex",
+            actions: "setValueAtIndex"
           },
-          ARROW_RIGHT: {
-            actions: "setNextFocusedIndex"
+          { actions: "setValue" }
+        ],
+        CLEAR_VALUE: [
+          {
+            guard: "isDisabled",
+            actions: "clearValue"
           },
-          BACKSPACE: [
-            {
+          {
+            actions: ["clearValue", "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"
+              },
+              {
+                guard: "isValidValue",
+                actions: ["setFocusedValue", "setNextFocusedIndex"]
+              }
+            ],
+            PASTE: {
+              guard: "isValidValue",
+              actions: ["setPastedValue", "setLastValueFocusIndex"]
+            },
+            BLUR: {
+              target: "idle",
+              actions: "clearFocusedIndex"
+            },
+            DELETE: {
               guard: "hasValue",
               actions: "clearFocusedValue"
             },
-            {
-              actions: ["setPrevFocusedIndex", "clearFocusedValue"]
+            ARROW_LEFT: {
+              actions: "setPrevFocusedIndex"
+            },
+            ARROW_RIGHT: {
+              actions: "setNextFocusedIndex"
+            },
+            BACKSPACE: [
+              {
+                guard: "hasValue",
+                actions: "clearFocusedValue"
+              },
+              {
+                actions: ["setPrevFocusedIndex", "clearFocusedValue"]
+              }
+            ],
+            ENTER: {
+              guard: "isValueComplete",
+              actions: "requestFormSubmit"
+            },
+            KEY_DOWN: {
+              guard: not("isValidValue"),
+              actions: ["preventDefault", "invokeOnInvalid"]
             }
-          ],
-          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);
+    {
+      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
       },
-      focusInput: (ctx2) => {
-        raf(() => {
+      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();
+          });
+        },
+        invokeOnComplete: (ctx2) => {
           var _a;
-          if (ctx2.focusedIndex === -1)
+          if (!ctx2.isValueComplete)
             return;
-          (_a = dom.getFocusedEl(ctx2)) == null ? void 0 : _a.focus();
-        });
-      },
-      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) });
-        dispatchInputValueEvent(dom.getHiddenInputEl(ctx2), ctx2.valueAsString);
-      },
-      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);
-      },
-      setPastedValue(ctx2, evt) {
-        raf(() => {
-          const value = evt.value.substring(0, ctx2.valueLength);
-          assign(ctx2, value.split("").filter(Boolean));
-        });
-      },
-      setValueAtIndex: (ctx2, evt) => {
-        ctx2.value[evt.index] = lastChar(evt.value);
-      },
-      clearValue: (ctx2) => {
-        assign(ctx2, "");
-      },
-      clearFocusedValue: (ctx2) => {
-        ctx2.value[ctx2.focusedIndex] = "";
-      },
-      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(() => {
+          (_a = ctx2.onComplete) == null ? void 0 : _a.call(ctx2, { value: Array.from(ctx2.value), valueAsString: ctx2.valueAsString });
+        },
+        invokeOnChange: (ctx2, evt) => {
           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();
+          if (evt.type === "SETUP")
+            return;
+          (_a = ctx2.onChange) == null ? void 0 : _a.call(ctx2, { value: Array.from(ctx2.value) });
+          dispatchInputValueEvent(dom.getHiddenInputEl(ctx2), ctx2.valueAsString);
+        },
+        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);
+        },
+        setPastedValue(ctx2, evt) {
+          raf(() => {
+            const value = evt.value.substring(0, ctx2.valueLength);
+            assign(ctx2, value.split("").filter(Boolean));
+          });
+        },
+        setValueAtIndex: (ctx2, evt) => {
+          ctx2.value[evt.index] = lastChar(evt.value);
+        },
+        clearValue: (ctx2) => {
+          assign(ctx2, "");
+        },
+        clearFocusedValue: (ctx2) => {
+          ctx2.value[ctx2.focusedIndex] = "";
+        },
+        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]+$/,

package/dist/index.mjs

@@ -18,9 +18,6 @@ function getDocument(el) {
     return el;
   return (el == null ? void 0 : el.ownerDocument) ?? document;
 }
-function getWindow(el) {
-  return (el == null ? void 0 : el.ownerDocument.defaultView) ?? window;
-}
 function defineDomHelpers(helpers) {
   const dom2 = {
     getRootNode: (ctx) => {
@@ -41,28 +38,9 @@ function getNativeEvent(e) {
   return e.nativeEvent ?? e;
 }
 var isModifiedEvent = (v) => v.ctrlKey || v.altKey || v.metaKey;
-function getDescriptor(el, options) {
-  const { type, property } = options;
-  const proto = getWindow(el)[type].prototype;
-  return Object.getOwnPropertyDescriptor(proto, property) ?? {};
-}
-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);
-}
 var rtlKeyMap = {
   ArrowLeft: "ArrowRight",
-  ArrowRight: "ArrowLeft",
-  Home: "End",
-  End: "Home"
+  ArrowRight: "ArrowLeft"
 };
 var sameKeyMap = {
   Up: "ArrowUp",
@@ -128,6 +106,10 @@ var dom = defineDomHelpers({
     var _a;
     return ((_a = ctx.ids) == null ? void 0 : _a.hiddenInput) ?? `pin-input:${ctx.id}:hidden`;
   },
+  getLabelId: (ctx) => {
+    var _a;
+    return ((_a = ctx.ids) == null ? void 0 : _a.label) ?? `pin-input:${ctx.id}:label`;
+  },
   getRootEl: (ctx) => dom.getById(ctx, dom.getRootId(ctx)),
   getElements: (ctx) => {
     const ownerId = CSS.escape(dom.getRootId(ctx));
@@ -145,6 +127,10 @@ function connect(state, send, normalize) {
   const isInvalid = state.context.invalid;
   const focusedIndex = state.context.focusedIndex;
   const messages = state.context.messages;
+  function focus() {
+    var _a;
+    (_a = dom.getFirstInputEl(state.context)) == null ? void 0 : _a.focus();
+  }
   return {
     value: state.context.value,
     valueAsString: state.context.valueAsString,
@@ -161,10 +147,7 @@ function connect(state, send, normalize) {
     setValueAtIndex(index, value) {
       send({ type: "SET_VALUE", value, index });
     },
-    focus() {
-      var _a;
-      (_a = dom.getFirstInputEl(state.context)) == null ? void 0 : _a.focus();
-    },
+    focus,
     rootProps: normalize.element({
       dir: state.context.dir,
       "data-part": "root",
@@ -173,6 +156,18 @@ function connect(state, send, normalize) {
       "data-disabled": dataAttr(state.context.disabled),
       "data-complete": dataAttr(isValueComplete)
     }),
+    labelProps: normalize.label({
+      "data-part": "label",
+      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({
       "aria-hidden": true,
       type: "text",
@@ -242,6 +237,8 @@ function connect(state, send, normalize) {
             exec(event);
             event.preventDefault();
           } else {
+            if (key === "Tab")
+              return;
             send({ type: "KEY_DOWN", value: key, preventDefault: () => event.preventDefault() });
           }
         },
@@ -258,237 +255,264 @@ function connect(state, send, normalize) {
 
 // src/pin-input.machine.ts
 import { createMachine, guards } from "@zag-js/core";
+
+// ../../utilities/form-utils/dist/index.mjs
+function getWindow(el) {
+  return (el == null ? void 0 : el.ownerDocument.defaultView) ?? window;
+}
+function getDescriptor(el, options) {
+  const { type, property } = options;
+  const proto = getWindow(el)[type].prototype;
+  return Object.getOwnPropertyDescriptor(proto, property) ?? {};
+}
+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(ctx) {
-  return createMachine({
-    id: "pin-input",
-    initial: "unknown",
-    context: {
-      value: [],
-      focusedIndex: -1,
-      placeholder: "\u25CB",
-      otp: false,
-      type: "numeric",
-      ...ctx,
-      messages: {
-        inputLabel: (index, length) => `pin code ${index + 1} of ${length}`,
-        ...ctx.messages
-      }
-    },
-    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("")
-    },
-    watch: {
-      focusedIndex: "focusInput",
-      value: "invokeOnChange",
-      isValueComplete: ["invokeOnComplete", "blurFocusedInputIfNeeded"]
-    },
-    on: {
-      SET_VALUE: [
-        {
-          guard: "hasIndex",
-          actions: "setValueAtIndex"
-        },
-        { actions: "setValue" }
-      ],
-      CLEAR_VALUE: [
-        {
-          guard: "isDisabled",
-          actions: "clearValue"
-        },
-        {
-          actions: ["clearValue", "setFocusIndexToFirst"]
-        }
-      ]
-    },
-    states: {
-      unknown: {
-        on: {
-          SETUP: [
-            {
-              guard: "autoFocus",
-              target: "focused",
-              actions: ["setupValue", "setFocusIndexToFirst"]
-            },
-            {
-              target: "idle",
-              actions: "setupValue"
-            }
-          ]
+  return createMachine(
+    {
+      id: "pin-input",
+      initial: "unknown",
+      context: {
+        value: [],
+        focusedIndex: -1,
+        placeholder: "\u25CB",
+        otp: false,
+        type: "numeric",
+        ...ctx,
+        messages: {
+          inputLabel: (index, length) => `pin code ${index + 1} of ${length}`,
+          ...ctx.messages
         }
       },
-      idle: {
-        on: {
-          FOCUS: {
-            target: "focused",
-            actions: "setFocusedIndex"
-          }
-        }
+      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("")
       },
-      focused: {
-        on: {
-          INPUT: [
-            {
-              guard: and("isFinalValue", "isValidValue"),
-              actions: "setFocusedValue"
-            },
-            {
-              guard: "isValidValue",
-              actions: ["setFocusedValue", "setNextFocusedIndex"]
-            }
-          ],
-          PASTE: {
-            guard: "isValidValue",
-            actions: ["setPastedValue", "setLastValueFocusIndex"]
-          },
-          BLUR: {
-            target: "idle",
-            actions: "clearFocusedIndex"
-          },
-          DELETE: {
-            guard: "hasValue",
-            actions: "clearFocusedValue"
-          },
-          ARROW_LEFT: {
-            actions: "setPrevFocusedIndex"
+      watch: {
+        focusedIndex: "focusInput",
+        value: "invokeOnChange",
+        isValueComplete: ["invokeOnComplete", "blurFocusedInputIfNeeded"]
+      },
+      on: {
+        SET_VALUE: [
+          {
+            guard: "hasIndex",
+            actions: "setValueAtIndex"
           },
-          ARROW_RIGHT: {
-            actions: "setNextFocusedIndex"
+          { actions: "setValue" }
+        ],
+        CLEAR_VALUE: [
+          {
+            guard: "isDisabled",
+            actions: "clearValue"
           },
-          BACKSPACE: [
-            {
+          {
+            actions: ["clearValue", "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"
+              },
+              {
+                guard: "isValidValue",
+                actions: ["setFocusedValue", "setNextFocusedIndex"]
+              }
+            ],
+            PASTE: {
+              guard: "isValidValue",
+              actions: ["setPastedValue", "setLastValueFocusIndex"]
+            },
+            BLUR: {
+              target: "idle",
+              actions: "clearFocusedIndex"
+            },
+            DELETE: {
               guard: "hasValue",
               actions: "clearFocusedValue"
             },
-            {
-              actions: ["setPrevFocusedIndex", "clearFocusedValue"]
+            ARROW_LEFT: {
+              actions: "setPrevFocusedIndex"
+            },
+            ARROW_RIGHT: {
+              actions: "setNextFocusedIndex"
+            },
+            BACKSPACE: [
+              {
+                guard: "hasValue",
+                actions: "clearFocusedValue"
+              },
+              {
+                actions: ["setPrevFocusedIndex", "clearFocusedValue"]
+              }
+            ],
+            ENTER: {
+              guard: "isValueComplete",
+              actions: "requestFormSubmit"
+            },
+            KEY_DOWN: {
+              guard: not("isValidValue"),
+              actions: ["preventDefault", "invokeOnInvalid"]
             }
-          ],
-          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);
+    {
+      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
       },
-      focusInput: (ctx2) => {
-        raf(() => {
+      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();
+          });
+        },
+        invokeOnComplete: (ctx2) => {
           var _a;
-          if (ctx2.focusedIndex === -1)
+          if (!ctx2.isValueComplete)
             return;
-          (_a = dom.getFocusedEl(ctx2)) == null ? void 0 : _a.focus();
-        });
-      },
-      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) });
-        dispatchInputValueEvent(dom.getHiddenInputEl(ctx2), ctx2.valueAsString);
-      },
-      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);
-      },
-      setPastedValue(ctx2, evt) {
-        raf(() => {
-          const value = evt.value.substring(0, ctx2.valueLength);
-          assign(ctx2, value.split("").filter(Boolean));
-        });
-      },
-      setValueAtIndex: (ctx2, evt) => {
-        ctx2.value[evt.index] = lastChar(evt.value);
-      },
-      clearValue: (ctx2) => {
-        assign(ctx2, "");
-      },
-      clearFocusedValue: (ctx2) => {
-        ctx2.value[ctx2.focusedIndex] = "";
-      },
-      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(() => {
+          (_a = ctx2.onComplete) == null ? void 0 : _a.call(ctx2, { value: Array.from(ctx2.value), valueAsString: ctx2.valueAsString });
+        },
+        invokeOnChange: (ctx2, evt) => {
           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();
+          if (evt.type === "SETUP")
+            return;
+          (_a = ctx2.onChange) == null ? void 0 : _a.call(ctx2, { value: Array.from(ctx2.value) });
+          dispatchInputValueEvent(dom.getHiddenInputEl(ctx2), ctx2.valueAsString);
+        },
+        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);
+        },
+        setPastedValue(ctx2, evt) {
+          raf(() => {
+            const value = evt.value.substring(0, ctx2.valueLength);
+            assign(ctx2, value.split("").filter(Boolean));
+          });
+        },
+        setValueAtIndex: (ctx2, evt) => {
+          ctx2.value[evt.index] = lastChar(evt.value);
+        },
+        clearValue: (ctx2) => {
+          assign(ctx2, "");
+        },
+        clearFocusedValue: (ctx2) => {
+          ctx2.value[ctx2.focusedIndex] = "";
+        },
+        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]+$/,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zag-js/pin-input",
-  "version": "0.1.11",
+  "version": "0.1.14",
   "description": "Core logic for the pin-input widget implemented as a state machine",
   "keywords": [
     "js",
@@ -29,12 +29,13 @@
     "url": "https://github.com/chakra-ui/zag/issues"
   },
   "dependencies": {
-    "@zag-js/core": "0.1.9",
-    "@zag-js/types": "0.2.3"
+    "@zag-js/core": "0.1.10",
+    "@zag-js/types": "0.2.5"
   },
   "devDependencies": {
-    "@zag-js/dom-utils": "0.1.8",
-    "@zag-js/utils": "0.1.3"
+    "@zag-js/dom-utils": "0.1.11",
+    "@zag-js/form-utils": "0.1.1",
+    "@zag-js/utils": "0.1.4"
   },
   "scripts": {
     "build-fast": "tsup src/index.ts --format=esm,cjs",