@alfadocs/ui-kit-debug 0.60.0 → 0.63.0

package/dist/_chunks/signature-field-DbhbpLha.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature-field-DbhbpLha.js","sources":["../../node_modules/lucide-react/dist/esm/icons/pen-line.js","../../src/components/signature-field/signature-field.tsx"],"sourcesContent":["/**\n * @license lucide-react v1.8.0 - ISC\n *\n * This source code is licensed under the ISC license.\n * See the LICENSE file in the root directory of this source tree.\n */\n\nimport createLucideIcon from '../createLucideIcon.js';\n\nconst __iconNode = [\n  [\"path\", { d: \"M13 21h8\", key: \"1jsn5i\" }],\n  [\n    \"path\",\n    {\n      d: \"M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z\",\n      key: \"1a8usu\"\n    }\n  ]\n];\nconst PenLine = createLucideIcon(\"pen-line\", __iconNode);\n\nexport { __iconNode, PenLine as default };\n//# sourceMappingURL=pen-line.js.map\n","/* ------------------------------------------------------------------ */\n/* SignatureField — a single percent-positioned signature placeholder   */\n/* rendered inside a PDFViewer page overlay (renderPageOverlay).         */\n/*                                                                       */\n/* Promoted from the story-only field demonstrated in                    */\n/* pdf-viewer.stories.tsx `WithSignatureFieldOverlays` (HTP-4889): the   */\n/* sign.alfadocs.com rebuild needs N of these positioned over each PDF   */\n/* page, each a real, keyboard-activatable control whose visual + a11y   */\n/* state tracks unsigned → signing → signed.                             */\n/*                                                                       */\n/* - Geometry: the consumer supplies percent coordinates                 */\n/*   (insetInlineStart / insetBlockStart / inlineSize / blockSize)        */\n/*   relative to the overlay box. These are runtime-computed layout       */\n/*   values driven by consumer data, so they ride an inline `style`       */\n/*   per 23-constraints §Runtime-computed dimensions — the same           */\n/*   sanctioned exception PDFViewer/SignatureCapture use. All static       */\n/*   styling stays in CVA + tokens. Logical properties only, so the       */\n/*   field mirrors correctly over an RTL document.                        */\n/* - It IS an interactive control: a real <button>. The accessible name   */\n/*   reflects state (Sign here / Signing… / Signed); the 44/48px target    */\n/*   floor is enforced via --min-target-size.                             */\n/* ------------------------------------------------------------------ */\n\nimport {\n  forwardRef,\n  type ComponentPropsWithoutRef,\n  type CSSProperties,\n  type MouseEvent as ReactMouseEvent,\n} from 'react';\nimport { cva } from 'class-variance-authority';\nimport { useTranslation } from 'react-i18next';\nimport { Check, PenLine } from 'lucide-react';\nimport { Spinner } from '../spinner';\n\n/* ------------------------------------------------------------------ */\n/* Public types                                                        */\n/* ------------------------------------------------------------------ */\n\nexport type SignatureFieldState = 'unsigned' | 'signing' | 'signed';\n\nexport interface SignatureFieldProps extends Omit<\n  ComponentPropsWithoutRef<'button'>,\n  'onClick' | 'children' | 'aria-label' | 'disabled'\n> {\n  /** Lifecycle state. Drives both the visual treatment and the accessible name. */\n  state?: SignatureFieldState;\n  /**\n   * Percent offset of the field's logical start edge within the overlay box.\n   * Applied as a runtime-computed `inset-inline-start: {n}%`.\n   */\n  insetInlineStart?: number;\n  /** Percent offset of the field's logical top edge. `inset-block-start: {n}%`. */\n  insetBlockStart?: number;\n  /** Percent of the overlay's logical inline size — the field width. */\n  inlineSize?: number;\n  /** Percent of the overlay's logical block size — the field height. */\n  blockSize?: number;\n  /** Called when an unsigned (or signed) field is activated by click / keyboard. */\n  onActivate?: () => void;\n  /** Captured signature image (PNG data URL or URL) shown when `state=\"signed\"`. */\n  signedImageSrc?: string;\n  /**\n   * Caption shown in the unsigned prompt and used as the accessible name\n   * (e.g. \"Sign here\", \"Date\", \"Initial here\"). Falls back to the\n   * translated default prompt.\n   */\n  label?: string;\n  /** Hard-disable the field (non-activatable, dimmed). Distinct from `state=\"signing\"`. */\n  disabled?: boolean;\n  /**\n   * Marks the field as the one currently targeted by field-to-field navigation\n   * (Next / Previous signature). Renders a **persistent** selection ring — not\n   * the transient `:focus-visible` ring — so the signer can see which field\n   * they're on as they step through, even after focus moves or is programmatic.\n   */\n  active?: boolean;\n}\n\n/* ------------------------------------------------------------------ */\n/* CVA                                                                 */\n/* ------------------------------------------------------------------ */\n\nconst signatureFieldVariants = cva(\n  [\n    // Overlay fields are always absolutely positioned within the\n    // renderPageOverlay box; the percent geometry rides the inline style.\n    'ds:absolute',\n    'ds:inline-flex ds:items-center ds:justify-center ds:gap-[var(--spacing-xs)]',\n    // The visible box renders at its true percentage geometry. A min-size\n    // floor here overstretched short fields past their authored box, so\n    // neighbours collided (signed box overlapping the next field). The 44/48px\n    // touch target is instead restored via a transparent ::before hit-area\n    // expansion — the same pattern Button's `sm` size uses — applied on touch\n    // viewports only; on desktop the precise box is the target.\n    'ds:before:absolute ds:before:content-[\"\"]',\n    'ds:before:inset-x-[calc((var(--min-target-size)-100%)/-2)]',\n    'ds:before:inset-y-[calc((var(--min-target-size)-100%)/-2)]',\n    'ds:sm:before:hidden',\n    // Inline padding lives on the per-state variants below (not the base) so\n    // the signed state's tighter padding can't collide with a base ps/pe on\n    // the same logical side under Tailwind's JIT ordering.\n    'ds:rounded-[var(--radius-sm)]',\n    'ds:text-[length:var(--font-size-sm)] ds:font-medium',\n    'ds:transition-colors ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none',\n    'ds:focus-visible:outline-[length:var(--focus-ring-width)]',\n    'ds:focus-visible:outline-solid',\n    'ds:focus-visible:outline-[var(--ring)]',\n    'ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]',\n    'ds:forced-colors:focus-visible:outline-[CanvasText]',\n    'ds:aria-disabled:cursor-not-allowed',\n  ].join(' '),\n  {\n    variants: {\n      state: {\n        unsigned: [\n          'ds:cursor-pointer',\n          'ds:ps-[var(--spacing-sm)] ds:pe-[var(--spacing-sm)]',\n          'ds:border ds:border-dashed ds:border-[color:var(--ring)]',\n          'ds:bg-[color-mix(in_srgb,var(--info)_8%,transparent)]',\n          'ds:text-[var(--foreground)]',\n          'ds:hover:bg-[color-mix(in_srgb,var(--info)_16%,transparent)]',\n          'ds:forced-colors:border-[CanvasText]',\n        ].join(' '),\n        signing: [\n          'ds:cursor-progress',\n          'ds:ps-[var(--spacing-sm)] ds:pe-[var(--spacing-sm)]',\n          'ds:border ds:border-dashed ds:border-[color:var(--border)]',\n          'ds:bg-[var(--muted)]',\n          'ds:text-[var(--muted-foreground)]',\n          'ds:forced-colors:border-[CanvasText]',\n        ].join(' '),\n        signed: [\n          // overflow-hidden is NOT on the button root — it would clip the\n          // ::before touch-target expansion. It lives on the inner image\n          // wrapper instead (see render).\n          'ds:cursor-pointer',\n          'ds:p-[var(--spacing-xs)]',\n          'ds:border ds:border-solid ds:border-[color:var(--success)]',\n          'ds:bg-[color-mix(in_srgb,var(--success)_8%,transparent)]',\n          'ds:text-[var(--foreground)]',\n          'ds:forced-colors:border-[CanvasText]',\n        ].join(' '),\n      },\n      // Persistent selection ring for the nav-targeted field. Uses the same\n      // tokens as the focus ring but is NOT gated on :focus-visible, so it\n      // stays visible as the signer steps between fields. When the field is\n      // also focused, the base focus-visible ring composes over it (same\n      // outline property, same value) — no visual clash.\n      active: {\n        true: [\n          'ds:outline-solid',\n          'ds:outline-[length:var(--focus-ring-width)]',\n          'ds:outline-[var(--ring)]',\n          'ds:outline-offset-[length:var(--focus-ring-offset)]',\n          'ds:forced-colors:outline-[Highlight]',\n        ].join(' '),\n        false: '',\n      },\n    },\n    defaultVariants: { state: 'unsigned', active: false },\n  },\n);\n\n/* ------------------------------------------------------------------ */\n/* SignatureField                                                       */\n/* ------------------------------------------------------------------ */\n\nexport const SignatureField = forwardRef<\n  HTMLButtonElement,\n  SignatureFieldProps\n>(\n  (\n    {\n      state = 'unsigned',\n      insetInlineStart,\n      insetBlockStart,\n      inlineSize,\n      blockSize,\n      onActivate,\n      signedImageSrc,\n      label,\n      disabled = false,\n      active = false,\n      id,\n      className,\n      ...rest\n    },\n    ref,\n  ) => {\n    const { t } = useTranslation();\n\n    const inactive = disabled || state === 'signing';\n\n    // Runtime-computed overlay geometry — consumer percent coordinates over\n    // the PDF page. Inline style is the sanctioned exception here\n    // (23-constraints §Runtime-computed dimensions); logical properties keep\n    // the field mirrored over RTL documents.\n    const geometry: CSSProperties = {};\n    if (insetInlineStart !== undefined) {\n      geometry.insetInlineStart = `${insetInlineStart}%`;\n    }\n    if (insetBlockStart !== undefined) {\n      geometry.insetBlockStart = `${insetBlockStart}%`;\n    }\n    if (inlineSize !== undefined) {\n      geometry.inlineSize = `${inlineSize}%`;\n    }\n    if (blockSize !== undefined) {\n      geometry.blockSize = `${blockSize}%`;\n    }\n\n    // `prompt` is the visible caption fallback; `unsigned` is the\n    // accessible-name fallback — intentionally distinct strings.\n    const promptText = label ?? t('signatureField.prompt');\n    // The signed/signing names compose the field's `label` with the status so\n    // several signed fields on one page stay individually identifiable (signed\n    // fields remain activatable for re-signing); falls back to the bare status\n    // when no label is supplied.\n    const accessibleName =\n      state === 'signing'\n        ? label\n          ? t('signatureField.signingNamed', { label })\n          : t('signatureField.signing')\n        : state === 'signed'\n          ? label\n            ? t('signatureField.signedNamed', { label })\n            : t('signatureField.signed')\n          : (label ?? t('signatureField.unsigned'));\n\n    function handleClick(event: ReactMouseEvent<HTMLButtonElement>): void {\n      if (inactive) {\n        event.preventDefault();\n        return;\n      }\n      onActivate?.();\n    }\n\n    return (\n      <button\n        ref={ref}\n        type=\"button\"\n        {...rest}\n        data-component=\"signature-field\"\n        data-component-id={id}\n        data-state={state}\n        data-active={active || undefined}\n        aria-label={accessibleName}\n        aria-disabled={inactive || undefined}\n        aria-busy={state === 'signing' || undefined}\n        onClick={handleClick}\n        className={[signatureFieldVariants({ state, active }), className]\n          .filter(Boolean)\n          .join(' ')}\n        // eslint-disable-next-line react/forbid-dom-props -- runtime-computed overlay geometry: consumer percent coordinates over the PDF page (23-constraints §Runtime-computed dimensions)\n        style={geometry}\n      >\n        {state === 'signing' ? (\n          // Decorative: the button's aria-label + aria-busy are the single\n          // source of the status announcement, so the Spinner's own\n          // role=\"status\" live region is hidden from assistive tech.\n          <span aria-hidden=\"true\">\n            <Spinner size=\"sm\" label={t('signatureField.signing')} />\n          </span>\n        ) : state === 'signed' ? (\n          signedImageSrc ? (\n            // overflow-hidden + rounding live on this inner wrapper (not the\n            // button root) so the signature is clipped to the box WITHOUT\n            // clipping the button's ::before touch-target expansion.\n            <span className=\"ds:inline-size-full ds:block-size-full ds:overflow-hidden ds:rounded-[var(--radius-sm)]\">\n              <img\n                src={signedImageSrc}\n                alt=\"\"\n                aria-hidden=\"true\"\n                className=\"ds:block-size-full ds:inline-size-full ds:object-contain\"\n              />\n            </span>\n          ) : (\n            <>\n              <Check\n                aria-hidden=\"true\"\n                className=\"ds:block-size-4 ds:inline-size-4 ds:text-[var(--success)]\"\n              />\n              <span>{t('signatureField.signed')}</span>\n            </>\n          )\n        ) : (\n          <>\n            <PenLine\n              aria-hidden=\"true\"\n              className=\"ds:block-size-4 ds:inline-size-4\"\n            />\n            <span>{promptText}</span>\n          </>\n        )}\n      </button>\n    );\n  },\n);\n\nSignatureField.displayName = 'SignatureField';\n\nexport { signatureFieldVariants };\n"],"names":["__iconNode","PenLine","createLucideIcon","signatureFieldVariants","cva","SignatureField","forwardRef","state","insetInlineStart","insetBlockStart","inlineSize","blockSize","onActivate","signedImageSrc","label","disabled","active","id","className","rest","ref","t","useTranslation","inactive","geometry","promptText","accessibleName","handleClick","event","jsx","Spinner","jsxs","Fragment","Check"],"mappings":"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","x_google_ignoreList":[0]}

package/dist/_chunks/use-countdown-Yd6ts0_a.js

@@ -0,0 +1,26 @@
+import { useState as c, useRef as R, useEffect as o, useCallback as f } from "react";
+function x(t, l = {}) {
+  const { autoStart: m = !0, onElapsed: u } = l, [a, s] = c(t), [e, i] = c(m), n = R(u);
+  o(() => {
+    n.current = u;
+  }, [u]);
+  const g = f(() => {
+    s(t), i(!0);
+  }, [t]), v = f(() => {
+    s(t), i(!1);
+  }, [t]);
+  return o(() => {
+    if (!e) return;
+    const r = setInterval(() => {
+      s((I) => Math.max(0, I - 1));
+    }, 1e3);
+    return () => clearInterval(r);
+  }, [e]), o(() => {
+    var r;
+    e && a <= 0 && (i(!1), (r = n.current) == null || r.call(n));
+  }, [e, a]), { remaining: a, isRunning: e, start: g, reset: v };
+}
+export {
+  x as u
+};
+//# sourceMappingURL=use-countdown-Yd6ts0_a.js.map

package/dist/_chunks/use-countdown-Yd6ts0_a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-countdown-Yd6ts0_a.js","sources":["../../src/hooks/use-countdown.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nexport interface UseCountdownOptions {\n  /** Begin counting down on mount. Default `true`. */\n  autoStart?: boolean;\n  /** Called exactly once when the countdown reaches zero. */\n  onElapsed?: () => void;\n}\n\nexport interface UseCountdownReturn {\n  /** Whole seconds remaining; counts down to 0. */\n  remaining: number;\n  /** Whether the countdown is actively ticking. */\n  isRunning: boolean;\n  /** (Re)start from the full duration. */\n  start: () => void;\n  /** Stop and reset to the full duration without firing `onElapsed`. */\n  reset: () => void;\n}\n\n/**\n * A pure, render-friendly seconds countdown. It owns no side effects — when\n * it reaches zero it calls `onElapsed` and the CONSUMER decides what to do\n * (close the tab, redirect, …). Same \"no I/O\" contract as `useSigningSession`.\n *\n * `onElapsed` is read through a ref, so changing the callback doesn't restart\n * the timer. SSR-safe: the timer only ticks inside an effect (client-only).\n *\n * @example\n *   const { remaining } = useCountdown(10, {\n *     onElapsed: () => {\n *       window.close(); // best-effort — blocked for user-opened tabs\n *       window.location.assign('https://www.alfadocs.com'); // fallback\n *     },\n *   });\n */\nexport function useCountdown(\n  seconds: number,\n  options: UseCountdownOptions = {},\n): UseCountdownReturn {\n  const { autoStart = true, onElapsed } = options;\n  const [remaining, setRemaining] = useState(seconds);\n  const [isRunning, setIsRunning] = useState(autoStart);\n\n  const onElapsedRef = useRef(onElapsed);\n  useEffect(() => {\n    onElapsedRef.current = onElapsed;\n  }, [onElapsed]);\n\n  const start = useCallback(() => {\n    setRemaining(seconds);\n    setIsRunning(true);\n  }, [seconds]);\n\n  const reset = useCallback(() => {\n    setRemaining(seconds);\n    setIsRunning(false);\n  }, [seconds]);\n\n  // A single interval keyed on `isRunning` (NOT `remaining`) so each second\n  // ticks regardless of re-renders — a setTimeout re-scheduled per render\n  // misbehaves under fake timers and drops ticks.\n  useEffect(() => {\n    if (!isRunning) return undefined;\n    const id = setInterval(() => {\n      setRemaining((r) => Math.max(0, r - 1));\n    }, 1000);\n    return () => clearInterval(id);\n  }, [isRunning]);\n\n  // Fire `onElapsed` once when the counter reaches zero, then stop (which\n  // tears down the interval above). Gated on `isRunning` so it can't re-fire.\n  useEffect(() => {\n    if (isRunning && remaining <= 0) {\n      setIsRunning(false);\n      onElapsedRef.current?.();\n    }\n  }, [isRunning, remaining]);\n\n  return { remaining, isRunning, start, reset };\n}\n"],"names":["useCountdown","seconds","options","autoStart","onElapsed","remaining","setRemaining","useState","isRunning","setIsRunning","onElapsedRef","useRef","useEffect","start","useCallback","reset","id","r","_a"],"mappings":";AAoCO,SAASA,EACdC,GACAC,IAA+B,IACX;AACpB,QAAM,EAAE,WAAAC,IAAY,IAAM,WAAAC,EAAA,IAAcF,GAClC,CAACG,GAAWC,CAAY,IAAIC,EAASN,CAAO,GAC5C,CAACO,GAAWC,CAAY,IAAIF,EAASJ,CAAS,GAE9CO,IAAeC,EAAOP,CAAS;AACrC,EAAAQ,EAAU,MAAM;AACd,IAAAF,EAAa,UAAUN;AAAA,EACzB,GAAG,CAACA,CAAS,CAAC;AAEd,QAAMS,IAAQC,EAAY,MAAM;AAC9B,IAAAR,EAAaL,CAAO,GACpBQ,EAAa,EAAI;AAAA,EACnB,GAAG,CAACR,CAAO,CAAC,GAENc,IAAQD,EAAY,MAAM;AAC9B,IAAAR,EAAaL,CAAO,GACpBQ,EAAa,EAAK;AAAA,EACpB,GAAG,CAACR,CAAO,CAAC;AAKZ,SAAAW,EAAU,MAAM;AACd,QAAI,CAACJ,EAAW;AAChB,UAAMQ,IAAK,YAAY,MAAM;AAC3B,MAAAV,EAAa,CAACW,MAAM,KAAK,IAAI,GAAGA,IAAI,CAAC,CAAC;AAAA,IACxC,GAAG,GAAI;AACP,WAAO,MAAM,cAAcD,CAAE;AAAA,EAC/B,GAAG,CAACR,CAAS,CAAC,GAIdI,EAAU,MAAM;;AACd,IAAIJ,KAAaH,KAAa,MAC5BI,EAAa,EAAK,IAClBS,IAAAR,EAAa,YAAb,QAAAQ,EAAA,KAAAR;AAAA,EAEJ,GAAG,CAACF,GAAWH,CAAS,CAAC,GAElB,EAAE,WAAAA,GAAW,WAAAG,GAAW,OAAAK,GAAO,OAAAE,EAAA;AACxC;"}

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.60.0",
+  "packageVersion": "0.63.0",
   "components": [
     {
       "kind": "component",
@@ -1901,6 +1901,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "finished-terminal",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "finished-terminal",
+          "description": "Marks the element as a kit FinishedTerminal."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "fiscal-code-input",

package/dist/components/finished-terminal/finished-terminal.d.ts

@@ -0,0 +1,55 @@
+import { type HTMLAttributes } from 'react';
+/**
+ * Gate for the URLs the terminal will navigate to. Allows only same-origin
+ * relative paths (`/…`) and explicit `http(s)` absolute URLs; rejects
+ * `javascript:` / `data:` / `vbscript:` and any other scheme.
+ *
+ * This terminal lives on public signing pages where `redirectUrl` may flow
+ * from a URL parameter, so a hostile `javascript:…` value must never reach
+ * `window.location.assign` (it would execute in the page). Exported for unit
+ * testing — it is NOT part of the public component API (`index.ts` does not
+ * re-export it).
+ */
+export declare function isNavigableUrl(url: string): boolean;
+export interface FinishedTerminalProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Completion headline — consumer-provided, already translated. */
+    title: string;
+    /** Completion sub-message — consumer-provided, already translated. */
+    body: string;
+    /**
+     * Auto-close countdown, in seconds. Default `10`. Set `0` to disable the
+     * countdown entirely (a static success screen with no next-step).
+     */
+    autoCloseSeconds?: number;
+    /**
+     * Where to send the signer when the countdown elapses / "Close now" is
+     * pressed. When omitted, the terminal does a best-effort `window.close()`
+     * and falls back to `brandUrl`.
+     *
+     * @security Navigated to via `window.location.assign`. Only same-origin
+     * relative paths and `http(s)` absolute URLs are honoured — `javascript:` /
+     * `data:` values are dropped. Pass a value from trusted backend config.
+     */
+    redirectUrl?: string;
+    /**
+     * Brand-site fallback used when there is no `redirectUrl` and the
+     * best-effort `window.close()` is blocked. Default `https://www.alfadocs.com`.
+     *
+     * @security Same navigation gate as `redirectUrl`.
+     */
+    brandUrl?: string;
+    /**
+     * Override the default close/redirect behaviour (e.g. SPA routing, analytics,
+     * or a no-op in stories). When provided, the terminal does NO browser
+     * navigation of its own — it just calls this.
+     */
+    onClose?: () => void;
+    /** Override the countdown line (default `ui.finishedTerminal.autoClose`). */
+    countdownLabel?: (seconds: number) => string;
+    /** Override the "Close now" label (default `ui.finishedTerminal.closeNow`). */
+    closeNowLabel?: string;
+    /** Override the post-close line (default `ui.finishedTerminal.redirecting`). */
+    redirectingLabel?: string;
+}
+export declare const FinishedTerminal: import("react").ForwardRefExoticComponent<FinishedTerminalProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=finished-terminal.d.ts.map

package/dist/components/finished-terminal/finished-terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finished-terminal.d.ts","sourceRoot":"","sources":["../../../src/components/finished-terminal/finished-terminal.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AAWf;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAcnD;AAED,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CACjD,cAAc,CAAC,cAAc,CAAC,EAC9B,OAAO,CACR;IACC,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,gBAAgB,kHAoI5B,CAAC"}

package/dist/components/finished-terminal/index.d.ts

@@ -0,0 +1,3 @@
+export { FinishedTerminal } from './finished-terminal';
+export type { FinishedTerminalProps } from './finished-terminal';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/finished-terminal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/finished-terminal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/components/finished-terminal/index.js

@@ -0,0 +1,5 @@
+import { F as r } from "../../_chunks/finished-terminal-VjZ_-eDD.js";
+export {
+  r as FinishedTerminal
+};
+//# sourceMappingURL=index.js.map

package/dist/components/finished-terminal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/index.d.ts

@@ -96,6 +96,7 @@ export * from './alert';
 export * from './appointment-card';
 export * from './dialog';
 export * from './dropdown-menu';
+export * from './finished-terminal';
 export * from './live-region';
 export * from './matrix-rain';
 export * from './message-card';

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"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"}

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

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

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

@@ -81,6 +81,13 @@ export interface PDFViewerProps {
     onError?: (error: Error) => void;
     /** Show the toolbar. Default `true`. */
     toolbar?: boolean;
+    /**
+     * Toolbar control set. `'full'` (default) is the editor toolbar (page nav,
+     * page input, zoom, fit-width, search, print). `'minimal'` is a lean,
+     * read-only control set — zoom out / in / preset only — for surfaces like
+     * signing where a signer just reads, scrolls, and occasionally zooms.
+     */
+    toolbarVariant?: 'full' | 'minimal';
     /** Accessible label for the viewer region. */
     ariaLabel?: string;
     /** Extra class names on the wrapper. */

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,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"}
+{"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;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,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,4GAyfrB,CAAC;AAyoBF,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-BmAT0kKD.js";
+import { S as o, s } from "../../_chunks/sign-document--nr5cxsB.js";
 export {
   o as SignDocument,
   s as signDocumentAgent

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

@@ -1,4 +1,4 @@
-import { S as i, s as r } from "../../_chunks/signature-field-DhscKdgk.js";
+import { S as i, s as r } from "../../_chunks/signature-field-DbhbpLha.js";
 export {
   i as SignatureField,
   r as signatureFieldVariants

package/dist/components/signature-field/signature-field.d.ts

@@ -26,9 +26,17 @@ export interface SignatureFieldProps extends Omit<ComponentPropsWithoutRef<'butt
     label?: string;
     /** Hard-disable the field (non-activatable, dimmed). Distinct from `state="signing"`. */
     disabled?: boolean;
+    /**
+     * Marks the field as the one currently targeted by field-to-field navigation
+     * (Next / Previous signature). Renders a **persistent** selection ring — not
+     * the transient `:focus-visible` ring — so the signer can see which field
+     * they're on as they step through, even after focus moves or is programmatic.
+     */
+    active?: boolean;
 }
 declare const signatureFieldVariants: (props?: ({
     state?: "signed" | "unsigned" | "signing" | null | undefined;
+    active?: boolean | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export declare const SignatureField: import("react").ForwardRefExoticComponent<SignatureFieldProps & import("react").RefAttributes<HTMLButtonElement>>;
 export { signatureFieldVariants };

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

@@ -1 +1 @@
-{"version":3,"file":"signature-field.d.ts","sourceRoot":"","sources":["../../../src/components/signature-field/signature-field.tsx"],"names":[],"mappings":"AAuBA,OAAO,EAEL,KAAK,wBAAwB,EAG9B,MAAM,OAAO,CAAC;AAUf,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,wBAAwB,CAAC,QAAQ,CAAC,EAClC,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CACnD;IACC,iFAAiF;IACjF,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD,QAAA,MAAM,sBAAsB;;8EAgD3B,CAAC;AAMF,eAAO,MAAM,cAAc,mHA2H1B,CAAC;AAIF,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"signature-field.d.ts","sourceRoot":"","sources":["../../../src/components/signature-field/signature-field.tsx"],"names":[],"mappings":"AAuBA,OAAO,EAEL,KAAK,wBAAwB,EAG9B,MAAM,OAAO,CAAC;AAUf,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,wBAAwB,CAAC,QAAQ,CAAC,EAClC,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CACnD;IACC,iFAAiF;IACjF,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD,QAAA,MAAM,sBAAsB;;;8EA+E3B,CAAC;AAMF,eAAO,MAAM,cAAc,mHAkI1B,CAAC;AAIF,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/hooks/index.js

@@ -1,32 +1,33 @@
-import { u as L } from "../_chunks/use-prefers-reduced-motion-BMwIQRjB.js";
-import { u as F } from "../_chunks/use-media-query-CcAx5SMM.js";
-import { u as R, a as _ } from "../_chunks/use-signing-session-CyOZWinp.js";
-import { u as w } from "../_chunks/use-count-up-BLLetaZ8.js";
-import { u as K } from "../_chunks/use-locale-BkCIHujH.js";
-import { A as H, T as Y, a as q, r as B, t as G, u as P } from "../_chunks/use-theme-CAuo6EYT.js";
-import { u as V } from "../_chunks/use-controllable-state-BiY4xTzM.js";
-import { u as z } from "../_chunks/use-copy-to-clipboard-Cyfc_dlv.js";
-import { u as W } from "../_chunks/use-debounced-callback-BisrB-Fq.js";
-import { useState as b, useRef as E, useEffect as m, useCallback as x } from "react";
-import { u as N, a as X } from "../_chunks/use-direction-Dp8h70PP.js";
-import { u as $ } from "../_chunks/use-persistent-state-i23OWy6G.js";
-import { u as te } from "../_chunks/use-isomorphic-layout-effect-BGfaCOP1.js";
-import { u as ne } from "../_chunks/use-web-otp-D_utzp6S.js";
-import { u as ue } from "../_chunks/use-edge-resize-ZnGG7gyO.js";
-function C(e, u) {
-  const [r, i] = b(e), n = E(null);
-  return m(() => {
-    if (u <= 0) {
-      n.current !== null && (clearTimeout(n.current), n.current = null), i(e);
+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-CyOZWinp.js";
+import { u as I } from "../_chunks/use-count-up-BLLetaZ8.js";
+import { u as R } 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";
+import { u as P } from "../_chunks/use-controllable-state-BiY4xTzM.js";
+import { u as V } from "../_chunks/use-copy-to-clipboard-Cyfc_dlv.js";
+import { u as z } from "../_chunks/use-debounced-callback-BisrB-Fq.js";
+import { useState as x, useRef as b, useEffect as E } from "react";
+import { u as W, a as J } from "../_chunks/use-direction-Dp8h70PP.js";
+import { u as X } from "../_chunks/use-persistent-state-i23OWy6G.js";
+import { u as $ } from "../_chunks/use-isomorphic-layout-effect-BGfaCOP1.js";
+import { u as te } from "../_chunks/use-web-otp-D_utzp6S.js";
+import { u as oe } from "../_chunks/use-edge-resize-ZnGG7gyO.js";
+import { u as ne } from "../_chunks/use-countdown-Yd6ts0_a.js";
+function h(e, o) {
+  const [t, i] = x(e), u = b(null);
+  return E(() => {
+    if (o <= 0) {
+      u.current !== null && (clearTimeout(u.current), u.current = null), i(e);
       return;
     }
     const s = setTimeout(() => {
-      i(e), n.current = null;
-    }, u);
-    return n.current = s, () => clearTimeout(s);
-  }, [e, u]), r;
+      i(e), u.current = null;
+    }, o);
+    return u.current = s, () => clearTimeout(s);
+  }, [e, o]), t;
 }
-const S = [
+const T = [
   "a[href]",
   "button:not([disabled])",
   'input:not([disabled]):not([type="hidden"])',
@@ -37,96 +38,75 @@ const S = [
   "audio[controls]",
   "video[controls]"
 ].join(",");
-function T(e) {
+function p(e) {
   return Array.from(
-    e.querySelectorAll(S)
-  ).filter((u) => {
-    if (u.hidden) return !1;
-    let r = u;
-    for (; r; ) {
-      if (r.hasAttribute("inert") || r.getAttribute("aria-hidden") === "true") return !1;
-      r = r.parentElement;
+    e.querySelectorAll(T)
+  ).filter((o) => {
+    if (o.hidden) return !1;
+    let t = o;
+    for (; t; ) {
+      if (t.hasAttribute("inert") || t.getAttribute("aria-hidden") === "true") return !1;
+      t = t.parentElement;
     }
     return !0;
   });
 }
-function v(e, u = {}) {
-  const { enabled: r = !0, autoFocus: i = !0, restoreFocus: n = !0 } = u, s = E(null);
-  m(() => {
-    if (!r) return;
-    const o = e.current;
-    if (!o) return;
+function C(e, o = {}) {
+  const { enabled: t = !0, autoFocus: i = !0, restoreFocus: u = !0 } = o, s = b(null);
+  E(() => {
+    if (!t) return;
+    const a = e.current;
+    if (!a) return;
     if (s.current = typeof document < "u" && document.activeElement instanceof HTMLElement ? document.activeElement : null, i) {
-      const a = T(o)[0] ?? (o.tabIndex >= -1 ? o : null);
-      a == null || a.focus();
+      const n = p(a)[0] ?? (a.tabIndex >= -1 ? a : null);
+      n == null || n.focus();
     }
-    function l(t) {
-      if (t.key !== "Tab") return;
-      const a = e.current;
-      if (!a) return;
-      const f = T(a);
-      if (f.length === 0) {
-        t.preventDefault();
+    function l(r) {
+      if (r.key !== "Tab") return;
+      const n = e.current;
+      if (!n) return;
+      const c = p(n);
+      if (c.length === 0) {
+        r.preventDefault();
         return;
       }
-      const c = f[0], d = f[f.length - 1], p = document.activeElement;
-      t.shiftKey ? (p === c || !a.contains(p)) && (t.preventDefault(), d.focus()) : (p === d || !a.contains(p)) && (t.preventDefault(), c.focus());
+      const d = c[0], m = c[c.length - 1], f = document.activeElement;
+      r.shiftKey ? (f === d || !n.contains(f)) && (r.preventDefault(), m.focus()) : (f === m || !n.contains(f)) && (r.preventDefault(), d.focus());
     }
-    return o.addEventListener("keydown", l), () => {
-      if (o.removeEventListener("keydown", l), n && s.current) {
-        const t = s.current;
+    return a.addEventListener("keydown", l), () => {
+      if (a.removeEventListener("keydown", l), u && s.current) {
+        const r = s.current;
         requestAnimationFrame(() => {
-          t.isConnected && t.focus();
+          r.isConnected && r.focus();
         });
       }
     };
-  }, [r, i, n, e]);
-}
-function g(e, u = {}) {
-  const { autoStart: r = !0, onElapsed: i } = u, [n, s] = b(e), [o, l] = b(r), t = E(i);
-  m(() => {
-    t.current = i;
-  }, [i]);
-  const a = x(() => {
-    s(e), l(!0);
-  }, [e]), f = x(() => {
-    s(e), l(!1);
-  }, [e]);
-  return m(() => {
-    if (!o) return;
-    const c = setInterval(() => {
-      s((d) => Math.max(0, d - 1));
-    }, 1e3);
-    return () => clearInterval(c);
-  }, [o]), m(() => {
-    var c;
-    o && n <= 0 && (l(!1), (c = t.current) == null || c.call(t));
-  }, [o, n]), { remaining: n, isRunning: o, start: a, reset: f };
+  }, [t, i, u, e]);
 }
 export {
-  H as ACCESSIBILITY_STORAGE_KEY,
-  Y as THEME_CLASS,
-  q as THEME_STORAGE_KEY,
-  B as resolveTheme,
-  G as themeClassList,
-  V as useControllableState,
-  z as useCopyToClipboard,
-  w as useCountUp,
-  g as useCountdown,
-  W as useDebouncedCallback,
-  C as useDebouncedValue,
-  N as useDirection,
-  X as useDocumentDirection,
-  ue as useEdgeResize,
-  v as useFocusTrap,
-  te as useIsomorphicLayoutEffect,
-  K as useLocale,
-  F as useMediaQuery,
-  $ as usePersistentState,
-  L as usePrefersReducedMotion,
-  R as useScrollToFirstError,
+  K as ACCESSIBILITY_STORAGE_KEY,
+  H as THEME_CLASS,
+  M as THEME_STORAGE_KEY,
+  Y as resolveTheme,
+  q as themeClassList,
+  P as useControllableState,
+  V as useCopyToClipboard,
+  I as useCountUp,
+  ne as useCountdown,
+  z as useDebouncedCallback,
+  h as useDebouncedValue,
+  W as useDirection,
+  J as useDocumentDirection,
+  oe as useEdgeResize,
+  C as useFocusTrap,
+  $ as useIsomorphicLayoutEffect,
+  R as useLocale,
+  D as useMediaQuery,
+  X as usePersistentState,
+  v as usePrefersReducedMotion,
+  g as useScrollToFirstError,
   _ as useSigningSession,
-  P as useTheme,
-  ne as useWebOtp
+  B as useTheme,
+  te as useWebOtp
 };
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/hooks/use-debounced-value.ts","../../src/hooks/use-focus-trap.ts","../../src/hooks/use-countdown.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/**\n * Returns a value that lags `input` by `delayMs`. Each new `input`\n * resets the timer; the returned value updates once `input` has been\n * stable for `delayMs` ms.\n *\n * Companion to `useDebouncedCallback` — use this when you want the\n * debounced *value* (to drive a derived effect, query, or render),\n * and use the callback hook when you want the debounced *action*.\n *\n * @example\n *   const [query, setQuery] = useState('');\n *   const debouncedQuery = useDebouncedValue(query, 250);\n *   useEffect(() => { void search(debouncedQuery); }, [debouncedQuery]);\n */\nexport function useDebouncedValue<T>(input: T, delayMs: number): T {\n  const [value, setValue] = useState<T>(input);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  useEffect(() => {\n    if (delayMs <= 0) {\n      // Flush any pending timer so a stale queued value can't land\n      // after the synchronous update below.\n      if (timerRef.current !== null) {\n        clearTimeout(timerRef.current);\n        timerRef.current = null;\n      }\n      setValue(input);\n      return;\n    }\n    const timer = setTimeout(() => {\n      setValue(input);\n      timerRef.current = null;\n    }, delayMs);\n    timerRef.current = timer;\n    return () => clearTimeout(timer);\n  }, [input, delayMs]);\n\n  return value;\n}\n","import { useEffect, useRef, type RefObject } from 'react';\n\n/* -------------------------------------------------------------------- */\n/* Focus trap                                                           */\n/*                                                                      */\n/* Lightweight focus-trap hook for components that compose a Radix      */\n/* primitive without the overlay primitive (Dialog, AlertDialog, Sheet) */\n/* — those handle focus trapping for free via `@radix-ui/react-dialog`. */\n/*                                                                      */\n/* This hook is intentionally NOT a Radix `<FocusScope>` re-export — it */\n/* is a hook so it composes inside `forwardRef` components without      */\n/* nesting another wrapper element. If you need the full Radix         */\n/* contract (return-focus management, loop, asChild), use               */\n/* `@radix-ui/react-focus-scope` directly.                              */\n/* -------------------------------------------------------------------- */\n\nexport interface UseFocusTrapOptions {\n  /** When `false` the trap is inert. Defaults to `true`. */\n  enabled?: boolean;\n  /**\n   * When `true`, focus initial autofocus into the first focusable\n   * descendant on mount / enable. @default true\n   */\n  autoFocus?: boolean;\n  /**\n   * When `true`, restores focus to the previously-focused element on\n   * unmount / disable. @default true\n   */\n  restoreFocus?: boolean;\n}\n\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'button:not([disabled])',\n  'input:not([disabled]):not([type=\"hidden\"])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  '[contenteditable=\"true\"]',\n  'audio[controls]',\n  'video[controls]',\n].join(',');\n\nfunction getFocusable(container: HTMLElement): HTMLElement[] {\n  return Array.from(\n    container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR),\n  ).filter((el) => {\n    if (el.hidden) return false;\n    // `inert` and `aria-hidden=\"true\"` block focus on the element AND\n    // all its descendants — walk the chain to catch either ancestor.\n    let node: HTMLElement | null = el;\n    while (node) {\n      if (node.hasAttribute('inert')) return false;\n      if (node.getAttribute('aria-hidden') === 'true') return false;\n      node = node.parentElement;\n    }\n    return true;\n  });\n}\n\n/**\n * Constrain Tab navigation to descendants of `containerRef`. Wraps Tab\n * forward from the last focusable to the first, and Shift+Tab back from\n * the first to the last. Optionally autofocuses on enable and restores\n * focus on disable.\n *\n * Use this for inline modal patterns or focus zones that don't ship\n * with their own Radix overlay. Don't stack it inside Dialog / Sheet —\n * Radix already traps focus in those.\n *\n * @example\n *   const ref = useRef<HTMLDivElement>(null);\n *   useFocusTrap(ref, { enabled: open });\n *   return <div ref={ref}>…</div>;\n */\nexport function useFocusTrap<T extends HTMLElement>(\n  containerRef: RefObject<T | null>,\n  options: UseFocusTrapOptions = {},\n): void {\n  const { enabled = true, autoFocus = true, restoreFocus = true } = options;\n  const previouslyFocused = useRef<HTMLElement | null>(null);\n\n  useEffect(() => {\n    if (!enabled) return;\n    const container = containerRef.current;\n    if (!container) return;\n\n    previouslyFocused.current =\n      typeof document !== 'undefined' &&\n      document.activeElement instanceof HTMLElement\n        ? document.activeElement\n        : null;\n\n    if (autoFocus) {\n      const focusable = getFocusable(container);\n      // Container itself is the fallback focus target — needs `tabIndex`\n      // to receive focus, but `-1` is fine.\n      const target =\n        focusable[0] ?? (container.tabIndex >= -1 ? container : null);\n      target?.focus();\n    }\n\n    function onKeyDown(event: KeyboardEvent) {\n      if (event.key !== 'Tab') return;\n      const root = containerRef.current;\n      if (!root) return;\n      const focusable = getFocusable(root);\n      if (focusable.length === 0) {\n        event.preventDefault();\n        return;\n      }\n      const first = focusable[0];\n      const last = focusable[focusable.length - 1];\n      const active = document.activeElement;\n\n      if (event.shiftKey) {\n        if (active === first || !root.contains(active)) {\n          event.preventDefault();\n          last.focus();\n        }\n      } else {\n        if (active === last || !root.contains(active)) {\n          event.preventDefault();\n          first.focus();\n        }\n      }\n    }\n\n    container.addEventListener('keydown', onKeyDown);\n\n    return () => {\n      container.removeEventListener('keydown', onKeyDown);\n      if (restoreFocus && previouslyFocused.current) {\n        // rAF lets parent unmounts settle before refocus — a microtask\n        // fires too early and can throw on a detached node.\n        const target = previouslyFocused.current;\n        requestAnimationFrame(() => {\n          if (target.isConnected) target.focus();\n        });\n      }\n    };\n  }, [enabled, autoFocus, restoreFocus, containerRef]);\n}\n","import { useCallback, useEffect, useRef, useState } from 'react';\n\nexport interface UseCountdownOptions {\n  /** Begin counting down on mount. Default `true`. */\n  autoStart?: boolean;\n  /** Called exactly once when the countdown reaches zero. */\n  onElapsed?: () => void;\n}\n\nexport interface UseCountdownReturn {\n  /** Whole seconds remaining; counts down to 0. */\n  remaining: number;\n  /** Whether the countdown is actively ticking. */\n  isRunning: boolean;\n  /** (Re)start from the full duration. */\n  start: () => void;\n  /** Stop and reset to the full duration without firing `onElapsed`. */\n  reset: () => void;\n}\n\n/**\n * A pure, render-friendly seconds countdown. It owns no side effects — when\n * it reaches zero it calls `onElapsed` and the CONSUMER decides what to do\n * (close the tab, redirect, …). Same \"no I/O\" contract as `useSigningSession`.\n *\n * `onElapsed` is read through a ref, so changing the callback doesn't restart\n * the timer. SSR-safe: the timer only ticks inside an effect (client-only).\n *\n * @example\n *   const { remaining } = useCountdown(10, {\n *     onElapsed: () => {\n *       window.close(); // best-effort — blocked for user-opened tabs\n *       window.location.assign('https://www.alfadocs.com'); // fallback\n *     },\n *   });\n */\nexport function useCountdown(\n  seconds: number,\n  options: UseCountdownOptions = {},\n): UseCountdownReturn {\n  const { autoStart = true, onElapsed } = options;\n  const [remaining, setRemaining] = useState(seconds);\n  const [isRunning, setIsRunning] = useState(autoStart);\n\n  const onElapsedRef = useRef(onElapsed);\n  useEffect(() => {\n    onElapsedRef.current = onElapsed;\n  }, [onElapsed]);\n\n  const start = useCallback(() => {\n    setRemaining(seconds);\n    setIsRunning(true);\n  }, [seconds]);\n\n  const reset = useCallback(() => {\n    setRemaining(seconds);\n    setIsRunning(false);\n  }, [seconds]);\n\n  // A single interval keyed on `isRunning` (NOT `remaining`) so each second\n  // ticks regardless of re-renders — a setTimeout re-scheduled per render\n  // misbehaves under fake timers and drops ticks.\n  useEffect(() => {\n    if (!isRunning) return undefined;\n    const id = setInterval(() => {\n      setRemaining((r) => Math.max(0, r - 1));\n    }, 1000);\n    return () => clearInterval(id);\n  }, [isRunning]);\n\n  // Fire `onElapsed` once when the counter reaches zero, then stop (which\n  // tears down the interval above). Gated on `isRunning` so it can't re-fire.\n  useEffect(() => {\n    if (isRunning && remaining <= 0) {\n      setIsRunning(false);\n      onElapsedRef.current?.();\n    }\n  }, [isRunning, remaining]);\n\n  return { remaining, isRunning, start, reset };\n}\n"],"names":["useDebouncedValue","input","delayMs","value","setValue","useState","timerRef","useRef","useEffect","timer","FOCUSABLE_SELECTOR","getFocusable","container","el","node","useFocusTrap","containerRef","options","enabled","autoFocus","restoreFocus","previouslyFocused","target","onKeyDown","event","root","focusable","first","last","active","useCountdown","seconds","autoStart","onElapsed","remaining","setRemaining","isRunning","setIsRunning","onElapsedRef","start","useCallback","reset","id","r","_a"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/hooks/use-debounced-value.ts","../../src/hooks/use-focus-trap.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/**\n * Returns a value that lags `input` by `delayMs`. Each new `input`\n * resets the timer; the returned value updates once `input` has been\n * stable for `delayMs` ms.\n *\n * Companion to `useDebouncedCallback` — use this when you want the\n * debounced *value* (to drive a derived effect, query, or render),\n * and use the callback hook when you want the debounced *action*.\n *\n * @example\n *   const [query, setQuery] = useState('');\n *   const debouncedQuery = useDebouncedValue(query, 250);\n *   useEffect(() => { void search(debouncedQuery); }, [debouncedQuery]);\n */\nexport function useDebouncedValue<T>(input: T, delayMs: number): T {\n  const [value, setValue] = useState<T>(input);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  useEffect(() => {\n    if (delayMs <= 0) {\n      // Flush any pending timer so a stale queued value can't land\n      // after the synchronous update below.\n      if (timerRef.current !== null) {\n        clearTimeout(timerRef.current);\n        timerRef.current = null;\n      }\n      setValue(input);\n      return;\n    }\n    const timer = setTimeout(() => {\n      setValue(input);\n      timerRef.current = null;\n    }, delayMs);\n    timerRef.current = timer;\n    return () => clearTimeout(timer);\n  }, [input, delayMs]);\n\n  return value;\n}\n","import { useEffect, useRef, type RefObject } from 'react';\n\n/* -------------------------------------------------------------------- */\n/* Focus trap                                                           */\n/*                                                                      */\n/* Lightweight focus-trap hook for components that compose a Radix      */\n/* primitive without the overlay primitive (Dialog, AlertDialog, Sheet) */\n/* — those handle focus trapping for free via `@radix-ui/react-dialog`. */\n/*                                                                      */\n/* This hook is intentionally NOT a Radix `<FocusScope>` re-export — it */\n/* is a hook so it composes inside `forwardRef` components without      */\n/* nesting another wrapper element. If you need the full Radix         */\n/* contract (return-focus management, loop, asChild), use               */\n/* `@radix-ui/react-focus-scope` directly.                              */\n/* -------------------------------------------------------------------- */\n\nexport interface UseFocusTrapOptions {\n  /** When `false` the trap is inert. Defaults to `true`. */\n  enabled?: boolean;\n  /**\n   * When `true`, focus initial autofocus into the first focusable\n   * descendant on mount / enable. @default true\n   */\n  autoFocus?: boolean;\n  /**\n   * When `true`, restores focus to the previously-focused element on\n   * unmount / disable. @default true\n   */\n  restoreFocus?: boolean;\n}\n\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'button:not([disabled])',\n  'input:not([disabled]):not([type=\"hidden\"])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  '[contenteditable=\"true\"]',\n  'audio[controls]',\n  'video[controls]',\n].join(',');\n\nfunction getFocusable(container: HTMLElement): HTMLElement[] {\n  return Array.from(\n    container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR),\n  ).filter((el) => {\n    if (el.hidden) return false;\n    // `inert` and `aria-hidden=\"true\"` block focus on the element AND\n    // all its descendants — walk the chain to catch either ancestor.\n    let node: HTMLElement | null = el;\n    while (node) {\n      if (node.hasAttribute('inert')) return false;\n      if (node.getAttribute('aria-hidden') === 'true') return false;\n      node = node.parentElement;\n    }\n    return true;\n  });\n}\n\n/**\n * Constrain Tab navigation to descendants of `containerRef`. Wraps Tab\n * forward from the last focusable to the first, and Shift+Tab back from\n * the first to the last. Optionally autofocuses on enable and restores\n * focus on disable.\n *\n * Use this for inline modal patterns or focus zones that don't ship\n * with their own Radix overlay. Don't stack it inside Dialog / Sheet —\n * Radix already traps focus in those.\n *\n * @example\n *   const ref = useRef<HTMLDivElement>(null);\n *   useFocusTrap(ref, { enabled: open });\n *   return <div ref={ref}>…</div>;\n */\nexport function useFocusTrap<T extends HTMLElement>(\n  containerRef: RefObject<T | null>,\n  options: UseFocusTrapOptions = {},\n): void {\n  const { enabled = true, autoFocus = true, restoreFocus = true } = options;\n  const previouslyFocused = useRef<HTMLElement | null>(null);\n\n  useEffect(() => {\n    if (!enabled) return;\n    const container = containerRef.current;\n    if (!container) return;\n\n    previouslyFocused.current =\n      typeof document !== 'undefined' &&\n      document.activeElement instanceof HTMLElement\n        ? document.activeElement\n        : null;\n\n    if (autoFocus) {\n      const focusable = getFocusable(container);\n      // Container itself is the fallback focus target — needs `tabIndex`\n      // to receive focus, but `-1` is fine.\n      const target =\n        focusable[0] ?? (container.tabIndex >= -1 ? container : null);\n      target?.focus();\n    }\n\n    function onKeyDown(event: KeyboardEvent) {\n      if (event.key !== 'Tab') return;\n      const root = containerRef.current;\n      if (!root) return;\n      const focusable = getFocusable(root);\n      if (focusable.length === 0) {\n        event.preventDefault();\n        return;\n      }\n      const first = focusable[0];\n      const last = focusable[focusable.length - 1];\n      const active = document.activeElement;\n\n      if (event.shiftKey) {\n        if (active === first || !root.contains(active)) {\n          event.preventDefault();\n          last.focus();\n        }\n      } else {\n        if (active === last || !root.contains(active)) {\n          event.preventDefault();\n          first.focus();\n        }\n      }\n    }\n\n    container.addEventListener('keydown', onKeyDown);\n\n    return () => {\n      container.removeEventListener('keydown', onKeyDown);\n      if (restoreFocus && previouslyFocused.current) {\n        // rAF lets parent unmounts settle before refocus — a microtask\n        // fires too early and can throw on a detached node.\n        const target = previouslyFocused.current;\n        requestAnimationFrame(() => {\n          if (target.isConnected) target.focus();\n        });\n      }\n    };\n  }, [enabled, autoFocus, restoreFocus, containerRef]);\n}\n"],"names":["useDebouncedValue","input","delayMs","value","setValue","useState","timerRef","useRef","useEffect","timer","FOCUSABLE_SELECTOR","getFocusable","container","el","node","useFocusTrap","containerRef","options","enabled","autoFocus","restoreFocus","previouslyFocused","target","onKeyDown","event","root","focusable","first","last","active"],"mappings":";;;;;;;;;;;;;;;;AAgBO,SAASA,EAAqBC,GAAUC,GAAoB;AACjE,QAAM,CAACC,GAAOC,CAAQ,IAAIC,EAAYJ,CAAK,GACrCK,IAAWC,EAA6C,IAAI;AAElE,SAAAC,EAAU,MAAM;AACd,QAAIN,KAAW,GAAG;AAGhB,MAAII,EAAS,YAAY,SACvB,aAAaA,EAAS,OAAO,GAC7BA,EAAS,UAAU,OAErBF,EAASH,CAAK;AACd;AAAA,IACF;AACA,UAAMQ,IAAQ,WAAW,MAAM;AAC7B,MAAAL,EAASH,CAAK,GACdK,EAAS,UAAU;AAAA,IACrB,GAAGJ,CAAO;AACV,WAAAI,EAAS,UAAUG,GACZ,MAAM,aAAaA,CAAK;AAAA,EACjC,GAAG,CAACR,GAAOC,CAAO,CAAC,GAEZC;AACT;ACTA,MAAMO,IAAqB;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,GAAG;AAEV,SAASC,EAAaC,GAAuC;AAC3D,SAAO,MAAM;AAAA,IACXA,EAAU,iBAA8BF,CAAkB;AAAA,EAAA,EAC1D,OAAO,CAACG,MAAO;AACf,QAAIA,EAAG,OAAQ,QAAO;AAGtB,QAAIC,IAA2BD;AAC/B,WAAOC,KAAM;AAEX,UADIA,EAAK,aAAa,OAAO,KACzBA,EAAK,aAAa,aAAa,MAAM,OAAQ,QAAO;AACxD,MAAAA,IAAOA,EAAK;AAAA,IACd;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAiBO,SAASC,EACdC,GACAC,IAA+B,IACzB;AACN,QAAM,EAAE,SAAAC,IAAU,IAAM,WAAAC,IAAY,IAAM,cAAAC,IAAe,OAASH,GAC5DI,IAAoBd,EAA2B,IAAI;AAEzD,EAAAC,EAAU,MAAM;AACd,QAAI,CAACU,EAAS;AACd,UAAMN,IAAYI,EAAa;AAC/B,QAAI,CAACJ,EAAW;AAQhB,QANAS,EAAkB,UAChB,OAAO,WAAa,OACpB,SAAS,yBAAyB,cAC9B,SAAS,gBACT,MAEFF,GAAW;AAIb,YAAMG,IAHYX,EAAaC,CAAS,EAI5B,CAAC,MAAMA,EAAU,YAAY,KAAKA,IAAY;AAC1D,MAAAU,KAAA,QAAAA,EAAQ;AAAA,IACV;AAEA,aAASC,EAAUC,GAAsB;AACvC,UAAIA,EAAM,QAAQ,MAAO;AACzB,YAAMC,IAAOT,EAAa;AAC1B,UAAI,CAACS,EAAM;AACX,YAAMC,IAAYf,EAAac,CAAI;AACnC,UAAIC,EAAU,WAAW,GAAG;AAC1B,QAAAF,EAAM,eAAA;AACN;AAAA,MACF;AACA,YAAMG,IAAQD,EAAU,CAAC,GACnBE,IAAOF,EAAUA,EAAU,SAAS,CAAC,GACrCG,IAAS,SAAS;AAExB,MAAIL,EAAM,YACJK,MAAWF,KAAS,CAACF,EAAK,SAASI,CAAM,OAC3CL,EAAM,eAAA,GACNI,EAAK,MAAA,MAGHC,MAAWD,KAAQ,CAACH,EAAK,SAASI,CAAM,OAC1CL,EAAM,eAAA,GACNG,EAAM,MAAA;AAAA,IAGZ;AAEA,WAAAf,EAAU,iBAAiB,WAAWW,CAAS,GAExC,MAAM;AAEX,UADAX,EAAU,oBAAoB,WAAWW,CAAS,GAC9CH,KAAgBC,EAAkB,SAAS;AAG7C,cAAMC,IAASD,EAAkB;AACjC,8BAAsB,MAAM;AAC1B,UAAIC,EAAO,eAAaA,EAAO,MAAA;AAAA,QACjC,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,GAAG,CAACJ,GAASC,GAAWC,GAAcJ,CAAY,CAAC;AACrD;"}

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

@@ -1714,6 +1714,11 @@ export declare const arUi: {
             readonly invalidReturnUrl: "يجب أن يتطابق رابط العودة مع أصل هذا الموقع. لم يتم إرسال الدفع.";
         };
     };
+    readonly finishedTerminal: {
+        readonly autoClose: "ستُغلق هذه النافذة خلال {{seconds}} ثانية.";
+        readonly closeNow: "إغلاق الآن";
+        readonly redirecting: "جارٍ التحويل…";
+    };
     readonly signatureField: {
         readonly prompt: "انقر للتوقيع";
         readonly unsigned: "وقّع هنا";

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8lFP,CAAC"}
+{"version":3,"file":"ar.d.ts","sourceRoot":"","sources":["../../../src/i18n/locales/ar.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmmFP,CAAC"}

package/dist/i18n/locales/ar.js

@@ -1697,6 +1697,11 @@ const e = {
       invalidReturnUrl: "يجب أن يتطابق رابط العودة مع أصل هذا الموقع. لم يتم إرسال الدفع."
     }
   },
+  finishedTerminal: {
+    autoClose: "ستُغلق هذه النافذة خلال {{seconds}} ثانية.",
+    closeNow: "إغلاق الآن",
+    redirecting: "جارٍ التحويل…"
+  },
   signatureField: {
     prompt: "انقر للتوقيع",
     unsigned: "وقّع هنا",