@alfadocs/ui-kit-debug 0.54.0 → 0.56.0

package/dist/_chunks/use-signing-session-CyOZWinp.js

@@ -0,0 +1,147 @@
+import { useRef as E, useEffect as B, useState as h, useMemo as I, useCallback as g } from "react";
+function R(o) {
+  return o != null && o.current ? o.current : typeof document > "u" ? null : document;
+}
+function T(o, s) {
+  const r = typeof CSS < "u" && typeof CSS.escape == "function" ? CSS.escape(o) : (
+    // SSR / jsdom fallback — drop every character that's
+    // significant in a CSS attribute selector. Conservative but
+    // robust enough for the test environment.
+    o.replace(/["'\\[\]]/g, "")
+  ), c = `[data-error-anchor="${r}"], [name="${r}"], [name$="[${r}]"]`, l = Array.from(s.querySelectorAll(c));
+  return l.length === 0 ? null : l.find((f) => f.offsetParent !== null) ?? l[0];
+}
+function q(o, s, r = {}) {
+  const {
+    scope: c,
+    scrollOptions: l = { behavior: "smooth", block: "center" },
+    focus: p = !0,
+    skipInitialMount: f = !0
+  } = r, t = E(!1), a = E(null), i = s.find((m) => !!o[m]) ?? null;
+  B(() => {
+    if (f && !t.current) {
+      t.current = !0, a.current = i;
+      return;
+    }
+    if (!i) {
+      a.current = null;
+      return;
+    }
+    if (i === a.current || typeof window > "u") return;
+    const m = window.requestAnimationFrame(() => {
+      const F = R(c);
+      if (!F) return;
+      const S = T(i, F);
+      S && (S.scrollIntoView(l), p && S.focus({ preventScroll: !0 }), a.current = i);
+    });
+    return () => window.cancelAnimationFrame(m);
+  }, [i]);
+}
+function k(o, s = !1) {
+  const r = {};
+  for (const c of o)
+    r[c.id] = { signed: s ? !1 : !!c.signed };
+  return r;
+}
+function M(o) {
+  const [s, r] = h(
+    () => k(o)
+  ), [c, l] = h(null), [p, f] = h(
+    () => {
+      var n;
+      return ((n = o[0]) == null ? void 0 : n.id) ?? null;
+    }
+  ), t = I(
+    () => o.map((n) => {
+      const e = s[n.id];
+      return {
+        ...n,
+        signed: e ? e.signed : !!n.signed,
+        payload: e == null ? void 0 : e.payload
+      };
+    }),
+    [o, s]
+  ), a = I(
+    () => t.reduce((n, e) => e.signed ? n + 1 : n, 0),
+    [t]
+  ), i = t.length, m = i > 0 && a === i, F = g((n) => {
+    l(n);
+  }, []), S = g(() => {
+    l(null);
+  }, []), v = g((n, e) => {
+    r((u) => ({ ...u, [n]: { signed: !0, payload: e } })), l((u) => u === n ? null : u);
+  }, []), w = g(
+    (n) => {
+      var e;
+      return !!((e = s[n]) != null && e.signed);
+    },
+    [s]
+  ), y = g(() => {
+    var n;
+    r(k(o, !0)), l(null), f(((n = o[0]) == null ? void 0 : n.id) ?? null);
+  }, [o]), C = g(() => {
+    f((n) => {
+      const e = t.length;
+      if (e === 0) return null;
+      const u = n ? t.findIndex((d) => d.id === n) : -1;
+      return t[(u + 1 + e) % e].id;
+    });
+  }, [t]), x = g(() => {
+    f((n) => {
+      const e = t.length;
+      if (e === 0) return null;
+      const u = n ? t.findIndex((d) => d.id === n) : 0;
+      return t[(u - 1 + e) % e].id;
+    });
+  }, [t]), b = g(() => {
+    f((n) => {
+      const e = t.length;
+      if (e === 0) return n;
+      const u = n ? t.findIndex((d) => d.id === n) : -1;
+      for (let d = 1; d <= e; d += 1) {
+        const A = t[(u + d) % e];
+        if (!A.signed) return A.id;
+      }
+      return n;
+    });
+  }, [t]);
+  return I(
+    () => ({
+      fields: t,
+      signedCount: a,
+      total: i,
+      isComplete: m,
+      activeFieldId: c,
+      openField: F,
+      closeField: S,
+      markSigned: v,
+      isFieldSigned: w,
+      reset: y,
+      cursorFieldId: p,
+      goToNextField: C,
+      goToPreviousField: x,
+      goToNextUnsigned: b
+    }),
+    [
+      t,
+      a,
+      i,
+      m,
+      c,
+      F,
+      S,
+      v,
+      w,
+      y,
+      p,
+      C,
+      x,
+      b
+    ]
+  );
+}
+export {
+  M as a,
+  q as u
+};
+//# sourceMappingURL=use-signing-session-CyOZWinp.js.map

package/dist/_chunks/{use-signing-session-C5evzYmo.js.map → use-signing-session-CyOZWinp.js.map}

@@ -1 +1 @@
-{"version":3,"file":"use-signing-session-C5evzYmo.js","sources":["../../src/hooks/use-scroll-to-first-error.ts","../../src/hooks/use-signing-session.ts"],"sourcesContent":["import { useEffect, useRef, type RefObject } from 'react';\n\n/* -------------------------------------------------------------------- */\n/* Types                                                                  */\n/* -------------------------------------------------------------------- */\n\nexport interface UseScrollToFirstErrorOptions {\n  /**\n   * Limits the DOM query to this element. Useful when the page renders\n   * more than one form, or when an unrelated component happens to share\n   * a field name. Defaults to `document`.\n   */\n  scope?: RefObject<HTMLElement | null>;\n  /**\n   * Forwarded to `scrollIntoView`. Defaults to\n   * `{ behavior: 'smooth', block: 'center' }`. Pass\n   * `{ behavior: 'auto' }` (or omit `behavior`) on consumers that\n   * respect `prefers-reduced-motion` upstream — the kit doesn't shadow\n   * the user's motion preference inside the hook, since some consumers\n   * deliberately keep a near-instant snap for power-user form flows.\n   */\n  scrollOptions?: ScrollIntoViewOptions;\n  /**\n   * Move keyboard focus to the errored field after scrolling. Default\n   * `true`. The focus call uses `preventScroll: true` so the smooth\n   * scroll the hook just did isn't replaced by a snap.\n   *\n   * Setting this `false` defeats the keyboard-user side of WCAG 3.3.1\n   * — the viewport will scroll but the active element stays on the\n   * submit button, forcing a Shift+Tab back into the form. Only flip\n   * this off when an upstream concern (e.g. a custom error summary\n   * panel that owns its own focus) is taking responsibility.\n   */\n  focus?: boolean;\n  /**\n   * On the very first render, do nothing even if `errors` already has\n   * entries. Default `true`. Without this the hook would yank the\n   * viewport whenever a form is hydrated with server-rendered errors\n   * from a no-JS fallback path — bad UX, since the user landed on the\n   * page and hasn't asked for any movement yet. Set `false` only when\n   * the consumer explicitly wants the initial-mount scroll (rare).\n   */\n  skipInitialMount?: boolean;\n}\n\n/* -------------------------------------------------------------------- */\n/* Helpers                                                                */\n/* -------------------------------------------------------------------- */\n\nfunction getScopeRoot(\n  scope: RefObject<HTMLElement | null> | undefined,\n): ParentNode | null {\n  if (scope?.current) return scope.current;\n  if (typeof document === 'undefined') return null;\n  return document;\n}\n\n/**\n * Resolve the DOM element to scroll/focus for a given errored field\n * name. The match order is:\n *\n *   1. `[data-error-anchor=\"<name>\"]` — the consumer's explicit hook,\n *      used for Radix-based fields (Checkbox / Select / Switch) where\n *      the named `<input>` is hidden behind a visible `<button>`.\n *      Consumers set this on the trigger.\n *   2. `[name=\"<name>\"]` — the literal field name.\n *   3. `[name$=\"[<name>]\"]` — Symfony form-prefixed names like\n *      `privacy_generator[fiscal_code]`. Suffix match keeps the hook\n *      consumer-agnostic; no need to thread the form prefix through.\n *\n * Returns the first visible element among the matches. \"Visible\" here\n * means `offsetParent !== null` — that's the cheap heuristic Radix's\n * hidden inputs (display:none-equivalent positioning) fail and the\n * visible triggers pass. Falls back to the first match if every match\n * is hidden, so a field can still be scrolled into view even when the\n * trigger uses a non-standard layout.\n */\nfunction findErrorElement(name: string, root: ParentNode): HTMLElement | null {\n  // `CSS.escape` is load-bearing here, not cosmetic. The Symfony\n  // suffix-match arm embeds `name` inside `[name$=\"[${safe}]\"]`, so a\n  // field name containing `]` would otherwise close the attribute\n  // selector early and turn the rest of the string into stray\n  // selector tokens. We don't expect adversarial input in practice\n  // (server-controlled field names), but a server returning a `]`\n  // in a 422 payload shouldn't be able to break the query.\n  const safe =\n    typeof CSS !== 'undefined' && typeof CSS.escape === 'function'\n      ? CSS.escape(name)\n      : // SSR / jsdom fallback — drop every character that's\n        // significant in a CSS attribute selector. Conservative but\n        // robust enough for the test environment.\n        name.replace(/[\"'\\\\[\\]]/g, '');\n  const selector =\n    `[data-error-anchor=\"${safe}\"], ` +\n    `[name=\"${safe}\"], ` +\n    `[name$=\"[${safe}]\"]`;\n\n  const matches = Array.from(root.querySelectorAll<HTMLElement>(selector));\n  if (matches.length === 0) return null;\n\n  const visible = matches.find((el) => el.offsetParent !== null);\n  return visible ?? matches[0];\n}\n\n/* -------------------------------------------------------------------- */\n/* Hook                                                                   */\n/* -------------------------------------------------------------------- */\n\n/**\n * Scrolls the first errored field into view and (by default) focuses\n * it, after `errors` changes. Backs the standard AlfaDocs rebrand\n * validation-error UX: after a 422 with `{ errors: { field: message } }`\n * is rendered inline, the user shouldn't be left staring at red labels\n * they can't see. Implements WCAG 3.3.1 / 3.3.3.\n *\n * The hook is stateless and never mutates the DOM beyond the\n * `scrollIntoView` + `focus` calls.\n *\n * @example\n *   const fieldOrder = ['firstName', 'email', 'fiscalCode'] as const;\n *   const [errors, setErrors] = useState<Record<string, string>>({});\n *   useScrollToFirstError(errors, fieldOrder);\n *\n * @example Radix-based field\n *   <Checkbox data-error-anchor=\"consent\" name=\"consent\" />\n *   // hook scrolls to the visible <button>, not Radix's hidden input.\n *\n * @example Scoped to one form\n *   const formRef = useRef<HTMLFormElement>(null);\n *   useScrollToFirstError(errors, fieldOrder, { scope: formRef });\n */\nexport function useScrollToFirstError(\n  errors: Readonly<Record<string, string | undefined>>,\n  fieldOrder: ReadonlyArray<string>,\n  options: UseScrollToFirstErrorOptions = {},\n): void {\n  const {\n    scope,\n    scrollOptions = { behavior: 'smooth', block: 'center' },\n    focus = true,\n    skipInitialMount = true,\n  } = options;\n\n  // Single ref guards the initial-mount skip across StrictMode's\n  // mount/unmount/remount cycle — flipped inside the effect body, not\n  // in cleanup, so the second run sees `true` and stays gated.\n  const ranOnceRef = useRef(false);\n\n  // Track the previous \"first errored field name\" so a re-render that\n  // leaves the same field errored doesn't re-scroll. We intentionally\n  // depend on the resolved name (not the whole errors object) — that\n  // way callers can mutate `errors` shape freely as long as the head\n  // of the validation list is stable, which is the typical pattern\n  // after a server returns the same 422 twice in a row.\n  const lastScrolledFieldRef = useRef<string | null>(null);\n\n  // Resolve the first errored field by visual order. A field is\n  // \"errored\" iff its key has a truthy string value — the kit's form\n  // contract is `Record<string, string | undefined>` where `undefined`\n  // / missing keys mean \"no error\".\n  const firstErroredField =\n    fieldOrder.find((name) => Boolean(errors[name])) ?? null;\n\n  useEffect(() => {\n    if (skipInitialMount && !ranOnceRef.current) {\n      ranOnceRef.current = true;\n      // Record what we skipped so the next render doesn't try to\n      // scroll to a field that was already errored at mount.\n      lastScrolledFieldRef.current = firstErroredField;\n      return;\n    }\n\n    if (!firstErroredField) {\n      lastScrolledFieldRef.current = null;\n      return;\n    }\n\n    if (firstErroredField === lastScrolledFieldRef.current) return;\n\n    if (typeof window === 'undefined') return;\n\n    // rAF defers the scroll until after the browser has laid out the\n    // freshly-rendered error labels. Calling scrollIntoView synchronously\n    // inside useEffect would fire before the new DOM is painted on\n    // some browsers, leaving the viewport pointing at the old layout.\n    const handle = window.requestAnimationFrame(() => {\n      const root = getScopeRoot(scope);\n      if (!root) return;\n      const el = findErrorElement(firstErroredField, root);\n      if (!el) return;\n\n      el.scrollIntoView(scrollOptions);\n      if (focus) {\n        // preventScroll: true so the browser doesn't override the\n        // smooth scroll above with a snap to put the element at the\n        // top of the viewport.\n        el.focus({ preventScroll: true });\n      }\n      lastScrolledFieldRef.current = firstErroredField;\n    });\n\n    return () => window.cancelAnimationFrame(handle);\n    // `scrollOptions` / `focus` / `scope` / `skipInitialMount` are\n    // option bag values — re-running on their identity change would\n    // be surprising. The hook re-fires only when the field at the\n    // head of the errored list changes.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [firstErroredField]);\n}\n","import { useCallback, useMemo, useState } from 'react';\n\n/* ------------------------------------------------------------------ */\n/* useSigningSession                                                    */\n/*                                                                       */\n/* Orchestration state for a multi-field signing flow: N signature      */\n/* fields across M pages (and optionally multiple PDFs per envelope),    */\n/* a live \"X of Y signed\" counter, and a completion gate. Pure state —   */\n/* no I/O, no globals, no persistence. The consumer owns the documents,  */\n/* the capture UI, and where signatures are sent.                        */\n/*                                                                       */\n/* Generic over the field shape (so geometry / page / docIndex / label   */\n/* ride along untouched and `fields` can map straight onto SignatureField)*/\n/* and over the captured payload type (typically SignatureConfirmPayload).*/\n/*                                                                       */\n/* The SET of field ids and their initial `signed` flags are captured at  */\n/* first render — an envelope's fields are fixed for the session. Field   */\n/* geometry/label changes still flow through `fields` on every render.    */\n/* ------------------------------------------------------------------ */\n\n/** Minimum shape a signing field must satisfy. */\nexport interface SigningFieldBase {\n  /** Stable, unique id for the field within the session. */\n  id: string;\n  /** Initial signed state (default `false`). */\n  signed?: boolean;\n}\n\ninterface SignedEntry<TPayload> {\n  signed: boolean;\n  payload?: TPayload;\n}\n\n/** A consumer field enriched with the session's live signed state + payload. */\nexport type SigningField<TField extends SigningFieldBase, TPayload> = TField & {\n  signed: boolean;\n  payload?: TPayload;\n};\n\nexport interface UseSigningSessionReturn<\n  TField extends SigningFieldBase,\n  TPayload,\n> {\n  /** The input fields, each enriched with live `signed` + `payload`. */\n  fields: SigningField<TField, TPayload>[];\n  /** How many fields are currently signed. */\n  signedCount: number;\n  /** Total number of fields. */\n  total: number;\n  /** True when every field is signed (and there is at least one). */\n  isComplete: boolean;\n  /** The field whose capture UI is currently open, or `null`. */\n  activeFieldId: string | null;\n  /** Open a field's capture UI (sets `activeFieldId`). */\n  openField: (id: string) => void;\n  /** Close any open capture UI (clears `activeFieldId`). */\n  closeField: () => void;\n  /** Flip a field to signed, storing its payload, and close it if active. */\n  markSigned: (id: string, payload?: TPayload) => void;\n  /** Read a single field's signed state. */\n  isFieldSigned: (id: string) => boolean;\n  /** Clear all signatures and close any open field. */\n  reset: () => void;\n}\n\nfunction seedSigned<TField extends SigningFieldBase, TPayload>(\n  fields: TField[],\n  forceUnsigned = false,\n): Record<string, SignedEntry<TPayload>> {\n  const map: Record<string, SignedEntry<TPayload>> = {};\n  for (const field of fields) {\n    map[field.id] = { signed: forceUnsigned ? false : Boolean(field.signed) };\n  }\n  return map;\n}\n\nexport function useSigningSession<\n  TField extends SigningFieldBase,\n  TPayload = unknown,\n>(fields: TField[]): UseSigningSessionReturn<TField, TPayload> {\n  const [signed, setSigned] = useState<Record<string, SignedEntry<TPayload>>>(\n    () => seedSigned<TField, TPayload>(fields),\n  );\n  const [activeFieldId, setActiveFieldId] = useState<string | null>(null);\n\n  const enriched = useMemo<SigningField<TField, TPayload>[]>(\n    () =>\n      fields.map((field) => {\n        const entry = signed[field.id];\n        return {\n          ...field,\n          signed: entry ? entry.signed : Boolean(field.signed),\n          payload: entry?.payload,\n        };\n      }),\n    [fields, signed],\n  );\n\n  const signedCount = useMemo(\n    () =>\n      enriched.reduce((count, field) => (field.signed ? count + 1 : count), 0),\n    [enriched],\n  );\n  const total = enriched.length;\n  const isComplete = total > 0 && signedCount === total;\n\n  const openField = useCallback((id: string) => {\n    setActiveFieldId(id);\n  }, []);\n\n  const closeField = useCallback(() => {\n    setActiveFieldId(null);\n  }, []);\n\n  const markSigned = useCallback((id: string, payload?: TPayload) => {\n    setSigned((prev) => ({ ...prev, [id]: { signed: true, payload } }));\n    setActiveFieldId((current) => (current === id ? null : current));\n  }, []);\n\n  const isFieldSigned = useCallback(\n    (id: string) => Boolean(signed[id]?.signed),\n    [signed],\n  );\n\n  const reset = useCallback(() => {\n    setSigned(seedSigned<TField, TPayload>(fields, true));\n    setActiveFieldId(null);\n  }, [fields]);\n\n  return useMemo(\n    () => ({\n      fields: enriched,\n      signedCount,\n      total,\n      isComplete,\n      activeFieldId,\n      openField,\n      closeField,\n      markSigned,\n      isFieldSigned,\n      reset,\n    }),\n    [\n      enriched,\n      signedCount,\n      total,\n      isComplete,\n      activeFieldId,\n      openField,\n      closeField,\n      markSigned,\n      isFieldSigned,\n      reset,\n    ],\n  );\n}\n"],"names":["getScopeRoot","scope","findErrorElement","name","root","safe","selector","matches","el","useScrollToFirstError","errors","fieldOrder","options","scrollOptions","focus","skipInitialMount","ranOnceRef","useRef","lastScrolledFieldRef","firstErroredField","useEffect","handle","seedSigned","fields","forceUnsigned","map","field","useSigningSession","signed","setSigned","useState","activeFieldId","setActiveFieldId","enriched","useMemo","entry","signedCount","count","total","isComplete","openField","useCallback","id","closeField","markSigned","payload","prev","current","isFieldSigned","_a","reset"],"mappings":";AAiDA,SAASA,EACPC,GACmB;AACnB,SAAIA,KAAA,QAAAA,EAAO,UAAgBA,EAAM,UAC7B,OAAO,WAAa,MAAoB,OACrC;AACT;AAsBA,SAASC,EAAiBC,GAAcC,GAAsC;AAQ5E,QAAMC,IACJ,OAAO,MAAQ,OAAe,OAAO,IAAI,UAAW,aAChD,IAAI,OAAOF,CAAI;AAAA;AAAA;AAAA;AAAA,IAIfA,EAAK,QAAQ,cAAc,EAAE;AAAA,KAC7BG,IACJ,uBAAuBD,CAAI,cACjBA,CAAI,gBACFA,CAAI,OAEZE,IAAU,MAAM,KAAKH,EAAK,iBAA8BE,CAAQ,CAAC;AACvE,SAAIC,EAAQ,WAAW,IAAU,OAEjBA,EAAQ,KAAK,CAACC,MAAOA,EAAG,iBAAiB,IAAI,KAC3CD,EAAQ,CAAC;AAC7B;AA6BO,SAASE,EACdC,GACAC,GACAC,IAAwC,CAAA,GAClC;AACN,QAAM;AAAA,IACJ,OAAAX;AAAA,IACA,eAAAY,IAAgB,EAAE,UAAU,UAAU,OAAO,SAAA;AAAA,IAC7C,OAAAC,IAAQ;AAAA,IACR,kBAAAC,IAAmB;AAAA,EAAA,IACjBH,GAKEI,IAAaC,EAAO,EAAK,GAQzBC,IAAuBD,EAAsB,IAAI,GAMjDE,IACJR,EAAW,KAAK,CAACR,MAAS,EAAQO,EAAOP,CAAI,CAAE,KAAK;AAEtD,EAAAiB,EAAU,MAAM;AACd,QAAIL,KAAoB,CAACC,EAAW,SAAS;AAC3C,MAAAA,EAAW,UAAU,IAGrBE,EAAqB,UAAUC;AAC/B;AAAA,IACF;AAEA,QAAI,CAACA,GAAmB;AACtB,MAAAD,EAAqB,UAAU;AAC/B;AAAA,IACF;AAIA,QAFIC,MAAsBD,EAAqB,WAE3C,OAAO,SAAW,IAAa;AAMnC,UAAMG,IAAS,OAAO,sBAAsB,MAAM;AAChD,YAAMjB,IAAOJ,EAAaC,CAAK;AAC/B,UAAI,CAACG,EAAM;AACX,YAAMI,IAAKN,EAAiBiB,GAAmBf,CAAI;AACnD,MAAKI,MAELA,EAAG,eAAeK,CAAa,GAC3BC,KAIFN,EAAG,MAAM,EAAE,eAAe,GAAA,CAAM,GAElCU,EAAqB,UAAUC;AAAA,IACjC,CAAC;AAED,WAAO,MAAM,OAAO,qBAAqBE,CAAM;AAAA,EAMjD,GAAG,CAACF,CAAiB,CAAC;AACxB;AC/IA,SAASG,EACPC,GACAC,IAAgB,IACuB;AACvC,QAAMC,IAA6C,CAAA;AACnD,aAAWC,KAASH;AAClB,IAAAE,EAAIC,EAAM,EAAE,IAAI,EAAE,QAAQF,IAAgB,KAAQ,EAAQE,EAAM,OAAM;AAExE,SAAOD;AACT;AAEO,SAASE,EAGdJ,GAA6D;AAC7D,QAAM,CAACK,GAAQC,CAAS,IAAIC;AAAA,IAC1B,MAAMR,EAA6BC,CAAM;AAAA,EAAA,GAErC,CAACQ,GAAeC,CAAgB,IAAIF,EAAwB,IAAI,GAEhEG,IAAWC;AAAA,IACf,MACEX,EAAO,IAAI,CAACG,MAAU;AACpB,YAAMS,IAAQP,EAAOF,EAAM,EAAE;AAC7B,aAAO;AAAA,QACL,GAAGA;AAAA,QACH,QAAQS,IAAQA,EAAM,SAAS,EAAQT,EAAM;AAAA,QAC7C,SAASS,KAAA,gBAAAA,EAAO;AAAA,MAAA;AAAA,IAEpB,CAAC;AAAA,IACH,CAACZ,GAAQK,CAAM;AAAA,EAAA,GAGXQ,IAAcF;AAAA,IAClB,MACED,EAAS,OAAO,CAACI,GAAOX,MAAWA,EAAM,SAASW,IAAQ,IAAIA,GAAQ,CAAC;AAAA,IACzE,CAACJ,CAAQ;AAAA,EAAA,GAELK,IAAQL,EAAS,QACjBM,IAAaD,IAAQ,KAAKF,MAAgBE,GAE1CE,IAAYC,EAAY,CAACC,MAAe;AAC5C,IAAAV,EAAiBU,CAAE;AAAA,EACrB,GAAG,CAAA,CAAE,GAECC,IAAaF,EAAY,MAAM;AACnC,IAAAT,EAAiB,IAAI;AAAA,EACvB,GAAG,CAAA,CAAE,GAECY,IAAaH,EAAY,CAACC,GAAYG,MAAuB;AACjE,IAAAhB,EAAU,CAACiB,OAAU,EAAE,GAAGA,GAAM,CAACJ,CAAE,GAAG,EAAE,QAAQ,IAAM,SAAAG,EAAA,IAAY,GAClEb,EAAiB,CAACe,MAAaA,MAAYL,IAAK,OAAOK,CAAQ;AAAA,EACjE,GAAG,CAAA,CAAE,GAECC,IAAgBP;AAAA,IACpB,CAACC,MAAA;;AAAe,iBAAQO,IAAArB,EAAOc,CAAE,MAAT,QAAAO,EAAY;AAAA;AAAA,IACpC,CAACrB,CAAM;AAAA,EAAA,GAGHsB,IAAQT,EAAY,MAAM;AAC9B,IAAAZ,EAAUP,EAA6BC,GAAQ,EAAI,CAAC,GACpDS,EAAiB,IAAI;AAAA,EACvB,GAAG,CAACT,CAAM,CAAC;AAEX,SAAOW;AAAA,IACL,OAAO;AAAA,MACL,QAAQD;AAAA,MACR,aAAAG;AAAA,MACA,OAAAE;AAAA,MACA,YAAAC;AAAA,MACA,eAAAR;AAAA,MACA,WAAAS;AAAA,MACA,YAAAG;AAAA,MACA,YAAAC;AAAA,MACA,eAAAI;AAAA,MACA,OAAAE;AAAA,IAAA;AAAA,IAEF;AAAA,MACEjB;AAAA,MACAG;AAAA,MACAE;AAAA,MACAC;AAAA,MACAR;AAAA,MACAS;AAAA,MACAG;AAAA,MACAC;AAAA,MACAI;AAAA,MACAE;AAAA,IAAA;AAAA,EACF;AAEJ;"}
+{"version":3,"file":"use-signing-session-CyOZWinp.js","sources":["../../src/hooks/use-scroll-to-first-error.ts","../../src/hooks/use-signing-session.ts"],"sourcesContent":["import { useEffect, useRef, type RefObject } from 'react';\n\n/* -------------------------------------------------------------------- */\n/* Types                                                                  */\n/* -------------------------------------------------------------------- */\n\nexport interface UseScrollToFirstErrorOptions {\n  /**\n   * Limits the DOM query to this element. Useful when the page renders\n   * more than one form, or when an unrelated component happens to share\n   * a field name. Defaults to `document`.\n   */\n  scope?: RefObject<HTMLElement | null>;\n  /**\n   * Forwarded to `scrollIntoView`. Defaults to\n   * `{ behavior: 'smooth', block: 'center' }`. Pass\n   * `{ behavior: 'auto' }` (or omit `behavior`) on consumers that\n   * respect `prefers-reduced-motion` upstream — the kit doesn't shadow\n   * the user's motion preference inside the hook, since some consumers\n   * deliberately keep a near-instant snap for power-user form flows.\n   */\n  scrollOptions?: ScrollIntoViewOptions;\n  /**\n   * Move keyboard focus to the errored field after scrolling. Default\n   * `true`. The focus call uses `preventScroll: true` so the smooth\n   * scroll the hook just did isn't replaced by a snap.\n   *\n   * Setting this `false` defeats the keyboard-user side of WCAG 3.3.1\n   * — the viewport will scroll but the active element stays on the\n   * submit button, forcing a Shift+Tab back into the form. Only flip\n   * this off when an upstream concern (e.g. a custom error summary\n   * panel that owns its own focus) is taking responsibility.\n   */\n  focus?: boolean;\n  /**\n   * On the very first render, do nothing even if `errors` already has\n   * entries. Default `true`. Without this the hook would yank the\n   * viewport whenever a form is hydrated with server-rendered errors\n   * from a no-JS fallback path — bad UX, since the user landed on the\n   * page and hasn't asked for any movement yet. Set `false` only when\n   * the consumer explicitly wants the initial-mount scroll (rare).\n   */\n  skipInitialMount?: boolean;\n}\n\n/* -------------------------------------------------------------------- */\n/* Helpers                                                                */\n/* -------------------------------------------------------------------- */\n\nfunction getScopeRoot(\n  scope: RefObject<HTMLElement | null> | undefined,\n): ParentNode | null {\n  if (scope?.current) return scope.current;\n  if (typeof document === 'undefined') return null;\n  return document;\n}\n\n/**\n * Resolve the DOM element to scroll/focus for a given errored field\n * name. The match order is:\n *\n *   1. `[data-error-anchor=\"<name>\"]` — the consumer's explicit hook,\n *      used for Radix-based fields (Checkbox / Select / Switch) where\n *      the named `<input>` is hidden behind a visible `<button>`.\n *      Consumers set this on the trigger.\n *   2. `[name=\"<name>\"]` — the literal field name.\n *   3. `[name$=\"[<name>]\"]` — Symfony form-prefixed names like\n *      `privacy_generator[fiscal_code]`. Suffix match keeps the hook\n *      consumer-agnostic; no need to thread the form prefix through.\n *\n * Returns the first visible element among the matches. \"Visible\" here\n * means `offsetParent !== null` — that's the cheap heuristic Radix's\n * hidden inputs (display:none-equivalent positioning) fail and the\n * visible triggers pass. Falls back to the first match if every match\n * is hidden, so a field can still be scrolled into view even when the\n * trigger uses a non-standard layout.\n */\nfunction findErrorElement(name: string, root: ParentNode): HTMLElement | null {\n  // `CSS.escape` is load-bearing here, not cosmetic. The Symfony\n  // suffix-match arm embeds `name` inside `[name$=\"[${safe}]\"]`, so a\n  // field name containing `]` would otherwise close the attribute\n  // selector early and turn the rest of the string into stray\n  // selector tokens. We don't expect adversarial input in practice\n  // (server-controlled field names), but a server returning a `]`\n  // in a 422 payload shouldn't be able to break the query.\n  const safe =\n    typeof CSS !== 'undefined' && typeof CSS.escape === 'function'\n      ? CSS.escape(name)\n      : // SSR / jsdom fallback — drop every character that's\n        // significant in a CSS attribute selector. Conservative but\n        // robust enough for the test environment.\n        name.replace(/[\"'\\\\[\\]]/g, '');\n  const selector =\n    `[data-error-anchor=\"${safe}\"], ` +\n    `[name=\"${safe}\"], ` +\n    `[name$=\"[${safe}]\"]`;\n\n  const matches = Array.from(root.querySelectorAll<HTMLElement>(selector));\n  if (matches.length === 0) return null;\n\n  const visible = matches.find((el) => el.offsetParent !== null);\n  return visible ?? matches[0];\n}\n\n/* -------------------------------------------------------------------- */\n/* Hook                                                                   */\n/* -------------------------------------------------------------------- */\n\n/**\n * Scrolls the first errored field into view and (by default) focuses\n * it, after `errors` changes. Backs the standard AlfaDocs rebrand\n * validation-error UX: after a 422 with `{ errors: { field: message } }`\n * is rendered inline, the user shouldn't be left staring at red labels\n * they can't see. Implements WCAG 3.3.1 / 3.3.3.\n *\n * The hook is stateless and never mutates the DOM beyond the\n * `scrollIntoView` + `focus` calls.\n *\n * @example\n *   const fieldOrder = ['firstName', 'email', 'fiscalCode'] as const;\n *   const [errors, setErrors] = useState<Record<string, string>>({});\n *   useScrollToFirstError(errors, fieldOrder);\n *\n * @example Radix-based field\n *   <Checkbox data-error-anchor=\"consent\" name=\"consent\" />\n *   // hook scrolls to the visible <button>, not Radix's hidden input.\n *\n * @example Scoped to one form\n *   const formRef = useRef<HTMLFormElement>(null);\n *   useScrollToFirstError(errors, fieldOrder, { scope: formRef });\n */\nexport function useScrollToFirstError(\n  errors: Readonly<Record<string, string | undefined>>,\n  fieldOrder: ReadonlyArray<string>,\n  options: UseScrollToFirstErrorOptions = {},\n): void {\n  const {\n    scope,\n    scrollOptions = { behavior: 'smooth', block: 'center' },\n    focus = true,\n    skipInitialMount = true,\n  } = options;\n\n  // Single ref guards the initial-mount skip across StrictMode's\n  // mount/unmount/remount cycle — flipped inside the effect body, not\n  // in cleanup, so the second run sees `true` and stays gated.\n  const ranOnceRef = useRef(false);\n\n  // Track the previous \"first errored field name\" so a re-render that\n  // leaves the same field errored doesn't re-scroll. We intentionally\n  // depend on the resolved name (not the whole errors object) — that\n  // way callers can mutate `errors` shape freely as long as the head\n  // of the validation list is stable, which is the typical pattern\n  // after a server returns the same 422 twice in a row.\n  const lastScrolledFieldRef = useRef<string | null>(null);\n\n  // Resolve the first errored field by visual order. A field is\n  // \"errored\" iff its key has a truthy string value — the kit's form\n  // contract is `Record<string, string | undefined>` where `undefined`\n  // / missing keys mean \"no error\".\n  const firstErroredField =\n    fieldOrder.find((name) => Boolean(errors[name])) ?? null;\n\n  useEffect(() => {\n    if (skipInitialMount && !ranOnceRef.current) {\n      ranOnceRef.current = true;\n      // Record what we skipped so the next render doesn't try to\n      // scroll to a field that was already errored at mount.\n      lastScrolledFieldRef.current = firstErroredField;\n      return;\n    }\n\n    if (!firstErroredField) {\n      lastScrolledFieldRef.current = null;\n      return;\n    }\n\n    if (firstErroredField === lastScrolledFieldRef.current) return;\n\n    if (typeof window === 'undefined') return;\n\n    // rAF defers the scroll until after the browser has laid out the\n    // freshly-rendered error labels. Calling scrollIntoView synchronously\n    // inside useEffect would fire before the new DOM is painted on\n    // some browsers, leaving the viewport pointing at the old layout.\n    const handle = window.requestAnimationFrame(() => {\n      const root = getScopeRoot(scope);\n      if (!root) return;\n      const el = findErrorElement(firstErroredField, root);\n      if (!el) return;\n\n      el.scrollIntoView(scrollOptions);\n      if (focus) {\n        // preventScroll: true so the browser doesn't override the\n        // smooth scroll above with a snap to put the element at the\n        // top of the viewport.\n        el.focus({ preventScroll: true });\n      }\n      lastScrolledFieldRef.current = firstErroredField;\n    });\n\n    return () => window.cancelAnimationFrame(handle);\n    // `scrollOptions` / `focus` / `scope` / `skipInitialMount` are\n    // option bag values — re-running on their identity change would\n    // be surprising. The hook re-fires only when the field at the\n    // head of the errored list changes.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [firstErroredField]);\n}\n","import { useCallback, useMemo, useState } from 'react';\n\n/* ------------------------------------------------------------------ */\n/* useSigningSession                                                    */\n/*                                                                       */\n/* Orchestration state for a multi-field signing flow: N signature      */\n/* fields across M pages (and optionally multiple PDFs per envelope),    */\n/* a live \"X of Y signed\" counter, and a completion gate. Pure state —   */\n/* no I/O, no globals, no persistence. The consumer owns the documents,  */\n/* the capture UI, and where signatures are sent.                        */\n/*                                                                       */\n/* Generic over the field shape (so geometry / page / docIndex / label   */\n/* ride along untouched and `fields` can map straight onto SignatureField)*/\n/* and over the captured payload type (typically SignatureConfirmPayload).*/\n/*                                                                       */\n/* The SET of field ids and their initial `signed` flags are captured at  */\n/* first render — an envelope's fields are fixed for the session. Field   */\n/* geometry/label changes still flow through `fields` on every render.    */\n/* ------------------------------------------------------------------ */\n\n/** Minimum shape a signing field must satisfy. */\nexport interface SigningFieldBase {\n  /** Stable, unique id for the field within the session. */\n  id: string;\n  /** Initial signed state (default `false`). */\n  signed?: boolean;\n}\n\ninterface SignedEntry<TPayload> {\n  signed: boolean;\n  payload?: TPayload;\n}\n\n/** A consumer field enriched with the session's live signed state + payload. */\nexport type SigningField<TField extends SigningFieldBase, TPayload> = TField & {\n  signed: boolean;\n  payload?: TPayload;\n};\n\nexport interface UseSigningSessionReturn<\n  TField extends SigningFieldBase,\n  TPayload,\n> {\n  /** The input fields, each enriched with live `signed` + `payload`. */\n  fields: SigningField<TField, TPayload>[];\n  /** How many fields are currently signed. */\n  signedCount: number;\n  /** Total number of fields. */\n  total: number;\n  /** True when every field is signed (and there is at least one). */\n  isComplete: boolean;\n  /** The field whose capture UI is currently open, or `null`. */\n  activeFieldId: string | null;\n  /** Open a field's capture UI (sets `activeFieldId`). */\n  openField: (id: string) => void;\n  /** Close any open capture UI (clears `activeFieldId`). */\n  closeField: () => void;\n  /** Flip a field to signed, storing its payload, and close it if active. */\n  markSigned: (id: string, payload?: TPayload) => void;\n  /** Read a single field's signed state. */\n  isFieldSigned: (id: string) => boolean;\n  /** Clear all signatures and close any open field. */\n  reset: () => void;\n  /** The field currently targeted by next/previous navigation, or `null`. */\n  cursorFieldId: string | null;\n  /** Move the navigation cursor to the next field (input order, cycling). */\n  goToNextField: () => void;\n  /** Move the navigation cursor to the previous field (cycling). */\n  goToPreviousField: () => void;\n  /** Move the cursor to the next still-unsigned field (cycling); no-op if all signed. */\n  goToNextUnsigned: () => void;\n}\n\nfunction seedSigned<TField extends SigningFieldBase, TPayload>(\n  fields: TField[],\n  forceUnsigned = false,\n): Record<string, SignedEntry<TPayload>> {\n  const map: Record<string, SignedEntry<TPayload>> = {};\n  for (const field of fields) {\n    map[field.id] = { signed: forceUnsigned ? false : Boolean(field.signed) };\n  }\n  return map;\n}\n\nexport function useSigningSession<\n  TField extends SigningFieldBase,\n  TPayload = unknown,\n>(fields: TField[]): UseSigningSessionReturn<TField, TPayload> {\n  const [signed, setSigned] = useState<Record<string, SignedEntry<TPayload>>>(\n    () => seedSigned<TField, TPayload>(fields),\n  );\n  const [activeFieldId, setActiveFieldId] = useState<string | null>(null);\n  const [cursorFieldId, setCursorFieldId] = useState<string | null>(\n    () => fields[0]?.id ?? null,\n  );\n\n  const enriched = useMemo<SigningField<TField, TPayload>[]>(\n    () =>\n      fields.map((field) => {\n        const entry = signed[field.id];\n        return {\n          ...field,\n          signed: entry ? entry.signed : Boolean(field.signed),\n          payload: entry?.payload,\n        };\n      }),\n    [fields, signed],\n  );\n\n  const signedCount = useMemo(\n    () =>\n      enriched.reduce((count, field) => (field.signed ? count + 1 : count), 0),\n    [enriched],\n  );\n  const total = enriched.length;\n  const isComplete = total > 0 && signedCount === total;\n\n  const openField = useCallback((id: string) => {\n    setActiveFieldId(id);\n  }, []);\n\n  const closeField = useCallback(() => {\n    setActiveFieldId(null);\n  }, []);\n\n  const markSigned = useCallback((id: string, payload?: TPayload) => {\n    setSigned((prev) => ({ ...prev, [id]: { signed: true, payload } }));\n    setActiveFieldId((current) => (current === id ? null : current));\n  }, []);\n\n  const isFieldSigned = useCallback(\n    (id: string) => Boolean(signed[id]?.signed),\n    [signed],\n  );\n\n  const reset = useCallback(() => {\n    setSigned(seedSigned<TField, TPayload>(fields, true));\n    setActiveFieldId(null);\n    setCursorFieldId(fields[0]?.id ?? null);\n  }, [fields]);\n\n  const goToNextField = useCallback(() => {\n    setCursorFieldId((cur) => {\n      const len = enriched.length;\n      if (len === 0) return null;\n      const i = cur ? enriched.findIndex((f) => f.id === cur) : -1;\n      return enriched[(i + 1 + len) % len].id;\n    });\n  }, [enriched]);\n\n  const goToPreviousField = useCallback(() => {\n    setCursorFieldId((cur) => {\n      const len = enriched.length;\n      if (len === 0) return null;\n      const i = cur ? enriched.findIndex((f) => f.id === cur) : 0;\n      return enriched[(i - 1 + len) % len].id;\n    });\n  }, [enriched]);\n\n  const goToNextUnsigned = useCallback(() => {\n    setCursorFieldId((cur) => {\n      const len = enriched.length;\n      if (len === 0) return cur;\n      const start = cur ? enriched.findIndex((f) => f.id === cur) : -1;\n      for (let step = 1; step <= len; step += 1) {\n        const field = enriched[(start + step) % len];\n        if (!field.signed) return field.id;\n      }\n      return cur;\n    });\n  }, [enriched]);\n\n  return useMemo(\n    () => ({\n      fields: enriched,\n      signedCount,\n      total,\n      isComplete,\n      activeFieldId,\n      openField,\n      closeField,\n      markSigned,\n      isFieldSigned,\n      reset,\n      cursorFieldId,\n      goToNextField,\n      goToPreviousField,\n      goToNextUnsigned,\n    }),\n    [\n      enriched,\n      signedCount,\n      total,\n      isComplete,\n      activeFieldId,\n      openField,\n      closeField,\n      markSigned,\n      isFieldSigned,\n      reset,\n      cursorFieldId,\n      goToNextField,\n      goToPreviousField,\n      goToNextUnsigned,\n    ],\n  );\n}\n"],"names":["getScopeRoot","scope","findErrorElement","name","root","safe","selector","matches","el","useScrollToFirstError","errors","fieldOrder","options","scrollOptions","focus","skipInitialMount","ranOnceRef","useRef","lastScrolledFieldRef","firstErroredField","useEffect","handle","seedSigned","fields","forceUnsigned","map","field","useSigningSession","signed","setSigned","useState","activeFieldId","setActiveFieldId","cursorFieldId","setCursorFieldId","_a","enriched","useMemo","entry","signedCount","count","total","isComplete","openField","useCallback","id","closeField","markSigned","payload","prev","current","isFieldSigned","reset","goToNextField","cur","len","i","f","goToPreviousField","goToNextUnsigned","start","step"],"mappings":"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"}

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.54.0",
+  "packageVersion": "0.56.0",
   "components": [
     {
       "kind": "component",

package/dist/components/otp-input/index.js

@@ -1,4 +1,4 @@
-import { O as r } from "../../_chunks/otp-input-Chb9r5vf.js";
+import { O as r } from "../../_chunks/otp-input-xQ4Ps5VY.js";
 export {
   r as OTPInput
 };

package/dist/components/otp-input/otp-input.d.ts

@@ -1,3 +1,4 @@
+export type OTPMode = 'numeric' | 'alphanumeric';
 /** Agent-readiness curated handle for OTPInput. */
 export interface OTPInputHandle {
     getValue: () => string;
@@ -7,7 +8,11 @@ export interface OTPInputHandle {
     isComplete: () => boolean;
 }
 export interface OTPInputProps {
-    length?: 4 | 6 | 8;
+    /**
+     * Number of boxes. Default 6. Any integer in [3, 10] is honoured;
+     * out-of-range values are clamped (with a DEV warning).
+     */
+    length?: number;
     value?: string;
     defaultValue?: string;
     onChange?: (value: string) => void;
@@ -40,6 +45,13 @@ export interface OTPInputProps {
      * `sms_code_form[code]`. Default off — no behaviour change.
      */
     name?: string;
+    /**
+     * Character set. `numeric` (default) accepts digits only (with Arabic-Indic
+     * digit folding) — byte-identical to prior behaviour. `alphanumeric` accepts
+     * `[A-Za-z0-9]`, uppercases the value, and switches the boxes to text input
+     * (for SMS codes that mix letters and digits).
+     */
+    mode?: OTPMode;
 }
 export declare const OTPInput: import("react").ForwardRefExoticComponent<OTPInputProps & import("react").RefAttributes<OTPInputHandle>>;
 //# sourceMappingURL=otp-input.d.ts.map

package/dist/components/otp-input/otp-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otp-input.d.ts","sourceRoot":"","sources":["../../../src/components/otp-input/otp-input.tsx"],"names":[],"mappings":"AAsBA,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,UAAU,EAAE,MAAM,OAAO,CAAC;CAC3B;AA0BD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAqBD,eAAO,MAAM,QAAQ,0GA0PpB,CAAC"}
+{"version":3,"file":"otp-input.d.ts","sourceRoot":"","sources":["../../../src/components/otp-input/otp-input.tsx"],"names":[],"mappings":"AAsBA,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,cAAc,CAAC;AAEjD,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,UAAU,EAAE,MAAM,OAAO,CAAC;CAC3B;AA0BD,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAiDD,eAAO,MAAM,QAAQ,0GAgRpB,CAAC"}

package/dist/components/pdf-viewer/index.js

@@ -1,4 +1,4 @@
-import { P as p, p as a } from "../../_chunks/pdf-viewer-4odMFuFW.js";
+import { P as p, p as a } from "../../_chunks/pdf-viewer-XxWdtKfD.js";
 export {
   p as PDFViewer,
   a as pdfViewerAgent

package/dist/components/pdf-viewer/pdf-viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pdf-viewer.d.ts","sourceRoot":"","sources":["../../../src/components/pdf-viewer/pdf-viewer.tsx"],"names":[],"mappings":"AAyBA,OAAO,EAWL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AA0Cf,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,MAAM,CAAC;AAE9E,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IACvC,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,SAAS,CAAC;IAC5D,0DAA0D;IAC1D,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACtE,wCAAwC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACvC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAMD,QAAA,MAAM,eAAe,oFAYpB,CAAC;AAEF,QAAA,MAAM,eAAe,oFAQpB,CAAC;AAEF,QAAA,MAAM,qBAAqB,oFAiB1B,CAAC;AAmHF,eAAO,MAAM,SAAS,4GAqfrB,CAAC;AA+mBF,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"pdf-viewer.d.ts","sourceRoot":"","sources":["../../../src/components/pdf-viewer/pdf-viewer.tsx"],"names":[],"mappings":"AAyBA,OAAO,EAWL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AA0Cf,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,MAAM,CAAC;AAE9E,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IACvC,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,SAAS,CAAC;IAC5D,0DAA0D;IAC1D,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACtE,wCAAwC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACvC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAMD,QAAA,MAAM,eAAe,oFAiBpB,CAAC;AAEF,QAAA,MAAM,eAAe,oFAQpB,CAAC;AAEF,QAAA,MAAM,qBAAqB,oFAiB1B,CAAC;AAmHF,eAAO,MAAM,SAAS,4GAqfrB,CAAC;AA+mBF,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC"}

package/dist/components/sign-document/index.js

@@ -1,4 +1,4 @@
-import { S as o, s } from "../../_chunks/sign-document-BzHTjMVC.js";
+import { S as o, s } from "../../_chunks/sign-document-BmAT0kKD.js";
 export {
   o as SignDocument,
   s as signDocumentAgent

package/dist/components/signature-capture/index.js

@@ -1,4 +1,4 @@
-import { S as r, s as t } from "../../_chunks/signature-capture-CHbrKoA_.js";
+import { S as r, s as t } from "../../_chunks/signature-capture-COi0Uiqu.js";
 export {
   r as SignatureCapture,
   t as signatureCaptureAgent

package/dist/components/signature-capture/signature-capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signature-capture.d.ts","sourceRoot":"","sources":["../../../src/components/signature-capture/signature-capture.tsx"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAUhD,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACvD,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;CACxD;AAMD,QAAA,MAAM,eAAe,oFAWpB,CAAC;AAsCF,QAAA,MAAM,oBAAoB,oFAqBzB,CAAC;AAEF,QAAA,MAAM,qBAAqB,oFAmB1B,CAAC;AA+JF,eAAO,MAAM,gBAAgB,0HA+e5B,CAAC;AAIF,OAAO,EACL,eAAe,IAAI,wBAAwB,EAC3C,oBAAoB,IAAI,6BAA6B,EACrD,qBAAqB,IAAI,8BAA8B,GACxD,CAAC"}
+{"version":3,"file":"signature-capture.d.ts","sourceRoot":"","sources":["../../../src/components/signature-capture/signature-capture.tsx"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAUhD,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACvD,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;CACxD;AAMD,QAAA,MAAM,eAAe,oFAWpB,CAAC;AAkDF,QAAA,MAAM,oBAAoB,oFAqBzB,CAAC;AAEF,QAAA,MAAM,qBAAqB,oFAmB1B,CAAC;AAkKF,eAAO,MAAM,gBAAgB,0HA+e5B,CAAC;AAIF,OAAO,EACL,eAAe,IAAI,wBAAwB,EAC3C,oBAAoB,IAAI,6BAA6B,EACrD,qBAAqB,IAAI,8BAA8B,GACxD,CAAC"}

package/dist/hooks/index.js

@@ -1,6 +1,6 @@
 import { u as v } from "../_chunks/use-prefers-reduced-motion-BMwIQRjB.js";
 import { u as D } from "../_chunks/use-media-query-CcAx5SMM.js";
-import { u as g, a as _ } from "../_chunks/use-signing-session-C5evzYmo.js";
+import { u as g, a as _ } from "../_chunks/use-signing-session-CyOZWinp.js";
 import { u as O } from "../_chunks/use-count-up-BLLetaZ8.js";
 import { u as k } from "../_chunks/use-locale-BkCIHujH.js";
 import { A as K, T as H, a as M, r as Y, t as q, u as B } from "../_chunks/use-theme-CAuo6EYT.js";

package/dist/hooks/use-signing-session.d.ts

@@ -31,6 +31,14 @@ export interface UseSigningSessionReturn<TField extends SigningFieldBase, TPaylo
     isFieldSigned: (id: string) => boolean;
     /** Clear all signatures and close any open field. */
     reset: () => void;
+    /** The field currently targeted by next/previous navigation, or `null`. */
+    cursorFieldId: string | null;
+    /** Move the navigation cursor to the next field (input order, cycling). */
+    goToNextField: () => void;
+    /** Move the navigation cursor to the previous field (cycling). */
+    goToPreviousField: () => void;
+    /** Move the cursor to the next still-unsigned field (cycling); no-op if all signed. */
+    goToNextUnsigned: () => void;
 }
 export declare function useSigningSession<TField extends SigningFieldBase, TPayload = unknown>(fields: TField[]): UseSigningSessionReturn<TField, TPayload>;
 //# sourceMappingURL=use-signing-session.d.ts.map

package/dist/hooks/use-signing-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-signing-session.d.ts","sourceRoot":"","sources":["../../src/hooks/use-signing-session.ts"],"names":[],"mappings":"AAoBA,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAOD,gFAAgF;AAChF,MAAM,MAAM,YAAY,CAAC,MAAM,SAAS,gBAAgB,EAAE,QAAQ,IAAI,MAAM,GAAG;IAC7E,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,uBAAuB,CACtC,MAAM,SAAS,gBAAgB,EAC/B,QAAQ;IAER,sEAAsE;IACtE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;IACzC,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,0DAA0D;IAC1D,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,2EAA2E;IAC3E,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC;IACrD,0CAA0C;IAC1C,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,qDAAqD;IACrD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAaD,wBAAgB,iBAAiB,CAC/B,MAAM,SAAS,gBAAgB,EAC/B,QAAQ,GAAG,OAAO,EAClB,MAAM,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,CA4E7D"}
+{"version":3,"file":"use-signing-session.d.ts","sourceRoot":"","sources":["../../src/hooks/use-signing-session.ts"],"names":[],"mappings":"AAoBA,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAOD,gFAAgF;AAChF,MAAM,MAAM,YAAY,CAAC,MAAM,SAAS,gBAAgB,EAAE,QAAQ,IAAI,MAAM,GAAG;IAC7E,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,uBAAuB,CACtC,MAAM,SAAS,gBAAgB,EAC/B,QAAQ;IAER,sEAAsE;IACtE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;IACzC,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,0DAA0D;IAC1D,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,2EAA2E;IAC3E,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC;IACrD,0CAA0C;IAC1C,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,qDAAqD;IACrD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,2EAA2E;IAC3E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,2EAA2E;IAC3E,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,uFAAuF;IACvF,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAaD,wBAAgB,iBAAiB,CAC/B,MAAM,SAAS,gBAAgB,EAC/B,QAAQ,GAAG,OAAO,EAClB,MAAM,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAuH7D"}

package/dist/i18n/locales/ar.d.ts

@@ -147,6 +147,7 @@ export declare const arUi: {
         };
         readonly otp: {
             readonly digitLabel: "الرقم {{current}} من {{total}}";
+            readonly charLabel: "الحرف {{current}} من {{total}}";
         };
         readonly slider: {
             readonly minLabel: "الحد الأدنى";

package/dist/i18n/locales/ar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ar.d.ts","sourceRoot":"","sources":["../../../src/i18n/locales/ar.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4lFP,CAAC"}
+{"version":3,"file":"ar.d.ts","sourceRoot":"","sources":["../../../src/i18n/locales/ar.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6lFP,CAAC"}

package/dist/i18n/locales/ar.js

@@ -139,7 +139,8 @@ const e = {
       clear: "مسح الاختيار"
     },
     otp: {
-      digitLabel: "الرقم {{current}} من {{total}}"
+      digitLabel: "الرقم {{current}} من {{total}}",
+      charLabel: "الحرف {{current}} من {{total}}"
     },
     slider: {
       minLabel: "الحد الأدنى",