@alfadocs/ui-kit-debug 0.62.0 → 0.63.0

package/dist/_chunks/finished-terminal-VjZ_-eDD.js

@@ -0,0 +1,122 @@
+import { jsx as e, jsxs as p } from "react/jsx-runtime";
+import { forwardRef as k, useState as A, useRef as g, useEffect as F, useCallback as j } from "react";
+import { useTranslation as z } from "react-i18next";
+import { C as w } from "./card-DPmk26CL.js";
+import { B as E } from "./button-DD_0Xdmr.js";
+import { u as D } from "./use-countdown-Yd6ts0_a.js";
+import { C as L } from "./circle-check-9AeSgJD_.js";
+function W(s) {
+  const t = globalThis.window !== void 0 && globalThis;
+  return !!(t && (/Chromatic/.test(t.navigator.userAgent) || /chromatic=true/.test(t.location.href)));
+}
+const _ = "https://www.alfadocs.com";
+function x(s) {
+  if (typeof s != "string" || s.length === 0 || s.startsWith("//")) return !1;
+  if (s.startsWith("/")) return !0;
+  try {
+    const { protocol: t } = new URL(s, window.location.origin);
+    return t === "https:" || t === "http:";
+  } catch {
+    return !1;
+  }
+}
+const I = k(
+  ({
+    title: s,
+    body: t,
+    autoCloseSeconds: i = 10,
+    redirectUrl: n,
+    brandUrl: o = _,
+    onClose: a,
+    countdownLabel: d,
+    closeNowLabel: v,
+    redirectingLabel: y,
+    className: N,
+    ...C
+  }, T) => {
+    const { t: r } = z(), [R, b] = A(!1), c = g(!1), l = g(null);
+    F(() => {
+      var h;
+      (h = l.current) == null || h.focus();
+    }, []);
+    const m = j(() => {
+      if (!c.current) {
+        if (c.current = !0, b(!0), a) {
+          a();
+          return;
+        }
+        n ? x(n) && window.location.assign(n) : (window.close(), x(o) && window.location.assign(o));
+      }
+    }, [a, n, o]), { remaining: f } = D(i, {
+      autoStart: i > 0 && !W(),
+      onElapsed: m
+    }), u = i > 0, B = d ? d(f) : r("finishedTerminal.autoClose", { seconds: f });
+    return /* @__PURE__ */ e(
+      "div",
+      {
+        ref: T,
+        "data-component": "finished-terminal",
+        className: [
+          "ds:flex ds:flex-1 ds:flex-col ds:items-center ds:overflow-y-auto ds:p-[var(--spacing-lg)]",
+          N
+        ].filter(Boolean).join(" "),
+        ...C,
+        children: /* @__PURE__ */ e(
+          w,
+          {
+            variant: "elevated",
+            className: "ds:my-auto ds:min-w-0 ds:[inline-size:100%] ds:max-w-[28rem] ds:text-center",
+            children: /* @__PURE__ */ e(w.Body, { children: /* @__PURE__ */ p("div", { className: "ds:flex ds:flex-col ds:items-center ds:gap-[var(--spacing-md)]", children: [
+              /* @__PURE__ */ e(
+                L,
+                {
+                  "aria-hidden": "true",
+                  className: "ds:size-12 ds:text-[var(--success)]"
+                }
+              ),
+              /* @__PURE__ */ e(
+                "h1",
+                {
+                  ref: l,
+                  tabIndex: -1,
+                  className: "type-title-card ds:m-0 ds:outline-none",
+                  children: s
+                }
+              ),
+              /* @__PURE__ */ e("p", { className: "type-body ds:m-0 ds:text-[var(--muted-foreground)]", children: t }),
+              u && R ? (
+                // Mounts once when closing begins → role="status" announces the
+                // hand-off exactly once (no churn).
+                /* @__PURE__ */ e(
+                  "p",
+                  {
+                    role: "status",
+                    className: "type-body-sm ds:m-0 ds:text-[var(--muted-foreground)]",
+                    children: y ?? r("finishedTerminal.redirecting")
+                  }
+                )
+              ) : u ? /* @__PURE__ */ p("div", { className: "ds:flex ds:flex-col ds:items-center ds:gap-[var(--spacing-sm)]", children: [
+                /* @__PURE__ */ e("p", { className: "type-body-sm ds:m-0 ds:text-[var(--muted-foreground)]", children: B }),
+                /* @__PURE__ */ e(
+                  E,
+                  {
+                    intent: "secondary",
+                    size: "lg",
+                    type: "button",
+                    onClick: m,
+                    children: v ?? r("finishedTerminal.closeNow")
+                  }
+                )
+              ] }) : null
+            ] }) })
+          }
+        )
+      }
+    );
+  }
+);
+I.displayName = "FinishedTerminal";
+export {
+  I as F
+};
+//# sourceMappingURL=finished-terminal-VjZ_-eDD.js.map

package/dist/_chunks/finished-terminal-VjZ_-eDD.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finished-terminal-VjZ_-eDD.js","sources":["../../node_modules/chromatic/isChromatic.mjs","../../src/components/finished-terminal/finished-terminal.tsx"],"sourcesContent":["export default function isChromatic(windowArgument) {\n  const windowToCheck = windowArgument || (globalThis.window !== undefined && globalThis);\n  return !!(\n    windowToCheck &&\n    (/Chromatic/.test(windowToCheck.navigator.userAgent) ||\n      /chromatic=true/.test(windowToCheck.location.href))\n  );\n}\n","/* ------------------------------------------------------------------ */\n/* FinishedTerminal — the post-completion success screen.               */\n/*                                                                       */\n/* The \"you're done\" terminal a public flow (e.g. sign.alfadocs.com)     */\n/* lands on after the signer finishes. A success tick + a consumer-      */\n/* supplied title/body, plus an i18n'd auto-close countdown next-step:   */\n/*                                                                       */\n/*  - `redirectUrl` set  → on elapse / \"Close now\", navigate there.      */\n/*  - no `redirectUrl`   → best-effort `window.close()` (blocked for     */\n/*    tabs the signer opened themselves), falling back to a redirect to   */\n/*    `brandUrl` (the public site).                                      */\n/*                                                                       */\n/* The browser navigation is the component's DEFAULT; pass `onClose` to   */\n/* take it over (analytics, SPA routing, a no-op in stories). The        */\n/* countdown freezes under Chromatic for deterministic snapshots.        */\n/* ------------------------------------------------------------------ */\n\nimport isChromatic from 'chromatic/isChromatic';\nimport {\n  forwardRef,\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n  type HTMLAttributes,\n} from 'react';\nimport { useTranslation } from 'react-i18next';\nimport { CheckCircle2 } from 'lucide-react';\nimport { Card } from '../card';\nimport { Button } from '../button';\nimport { useCountdown } from '../../hooks/use-countdown';\n\n/** The public brand site the terminal falls back to when there's no\n *  `redirectUrl` and `window.close()` is blocked. */\nconst DEFAULT_BRAND_URL = 'https://www.alfadocs.com';\n\n/**\n * Gate for the URLs the terminal will navigate to. Allows only same-origin\n * relative paths (`/…`) and explicit `http(s)` absolute URLs; rejects\n * `javascript:` / `data:` / `vbscript:` and any other scheme.\n *\n * This terminal lives on public signing pages where `redirectUrl` may flow\n * from a URL parameter, so a hostile `javascript:…` value must never reach\n * `window.location.assign` (it would execute in the page). Exported for unit\n * testing — it is NOT part of the public component API (`index.ts` does not\n * re-export it).\n */\nexport function isNavigableUrl(url: string): boolean {\n  if (typeof url !== 'string' || url.length === 0) return false;\n  // Protocol-relative `//host` is a classic open-redirect bypass (it resolves\n  // to a cross-origin http(s) URL) — reject it; a caller wanting a cross-origin\n  // target must pass an explicit `https://` URL.\n  if (url.startsWith('//')) return false;\n  // Same-origin relative path.\n  if (url.startsWith('/')) return true;\n  try {\n    const { protocol } = new URL(url, window.location.origin);\n    return protocol === 'https:' || protocol === 'http:';\n  } catch {\n    return false;\n  }\n}\n\nexport interface FinishedTerminalProps extends Omit<\n  HTMLAttributes<HTMLDivElement>,\n  'title'\n> {\n  /** Completion headline — consumer-provided, already translated. */\n  title: string;\n  /** Completion sub-message — consumer-provided, already translated. */\n  body: string;\n  /**\n   * Auto-close countdown, in seconds. Default `10`. Set `0` to disable the\n   * countdown entirely (a static success screen with no next-step).\n   */\n  autoCloseSeconds?: number;\n  /**\n   * Where to send the signer when the countdown elapses / \"Close now\" is\n   * pressed. When omitted, the terminal does a best-effort `window.close()`\n   * and falls back to `brandUrl`.\n   *\n   * @security Navigated to via `window.location.assign`. Only same-origin\n   * relative paths and `http(s)` absolute URLs are honoured — `javascript:` /\n   * `data:` values are dropped. Pass a value from trusted backend config.\n   */\n  redirectUrl?: string;\n  /**\n   * Brand-site fallback used when there is no `redirectUrl` and the\n   * best-effort `window.close()` is blocked. Default `https://www.alfadocs.com`.\n   *\n   * @security Same navigation gate as `redirectUrl`.\n   */\n  brandUrl?: string;\n  /**\n   * Override the default close/redirect behaviour (e.g. SPA routing, analytics,\n   * or a no-op in stories). When provided, the terminal does NO browser\n   * navigation of its own — it just calls this.\n   */\n  onClose?: () => void;\n  /** Override the countdown line (default `ui.finishedTerminal.autoClose`). */\n  countdownLabel?: (seconds: number) => string;\n  /** Override the \"Close now\" label (default `ui.finishedTerminal.closeNow`). */\n  closeNowLabel?: string;\n  /** Override the post-close line (default `ui.finishedTerminal.redirecting`). */\n  redirectingLabel?: string;\n}\n\nexport const FinishedTerminal = forwardRef<\n  HTMLDivElement,\n  FinishedTerminalProps\n>(\n  (\n    {\n      title,\n      body,\n      autoCloseSeconds = 10,\n      redirectUrl,\n      brandUrl = DEFAULT_BRAND_URL,\n      onClose,\n      countdownLabel,\n      closeNowLabel,\n      redirectingLabel,\n      className,\n      ...rest\n    },\n    ref,\n  ) => {\n    const { t } = useTranslation();\n    const [closing, setClosing] = useState(false);\n    const closedRef = useRef(false);\n    const headingRef = useRef<HTMLHeadingElement>(null);\n\n    // Move focus to the completion heading on mount so assistive tech announces\n    // the terminal on arrival. This surface is reached by a flow/page\n    // transition, which otherwise leaves focus on <body> with no spoken\n    // context. The heading is a non-interactive focus receiver (tabIndex={-1},\n    // no visible ring) — the SPA \"route changed\" announcement pattern.\n    useEffect(() => {\n      headingRef.current?.focus();\n    }, []);\n\n    const handleClose = useCallback(() => {\n      if (closedRef.current) return;\n      closedRef.current = true;\n      setClosing(true);\n      if (onClose) {\n        onClose();\n        return;\n      }\n      // Default: navigate to the configured return URL, or best-effort close\n      // the tab and fall back to the brand site (window.close() is blocked for\n      // tabs the user opened themselves, so the redirect is the real fallback).\n      // Both URLs are gated against javascript:/data: schemes before navigating.\n      if (redirectUrl) {\n        if (isNavigableUrl(redirectUrl)) window.location.assign(redirectUrl);\n      } else {\n        window.close();\n        if (isNavigableUrl(brandUrl)) window.location.assign(brandUrl);\n      }\n    }, [onClose, redirectUrl, brandUrl]);\n\n    // Freeze the countdown under Chromatic so the snapshot is deterministic.\n    const { remaining } = useCountdown(autoCloseSeconds, {\n      autoStart: autoCloseSeconds > 0 && !isChromatic(),\n      onElapsed: handleClose,\n    });\n    const showCountdown = autoCloseSeconds > 0;\n\n    const countdownText = countdownLabel\n      ? countdownLabel(remaining)\n      : t('finishedTerminal.autoClose', { seconds: remaining });\n\n    return (\n      <div\n        ref={ref}\n        data-component=\"finished-terminal\"\n        className={[\n          'ds:flex ds:flex-1 ds:flex-col ds:items-center ds:overflow-y-auto ds:p-[var(--spacing-lg)]',\n          className,\n        ]\n          .filter(Boolean)\n          .join(' ')}\n        {...rest}\n      >\n        <Card\n          variant=\"elevated\"\n          className=\"ds:my-auto ds:min-w-0 ds:[inline-size:100%] ds:max-w-[28rem] ds:text-center\"\n        >\n          <Card.Body>\n            <div className=\"ds:flex ds:flex-col ds:items-center ds:gap-[var(--spacing-md)]\">\n              <CheckCircle2\n                aria-hidden=\"true\"\n                className=\"ds:size-12 ds:text-[var(--success)]\"\n              />\n              <h1\n                ref={headingRef}\n                tabIndex={-1}\n                className=\"type-title-card ds:m-0 ds:outline-none\"\n              >\n                {title}\n              </h1>\n              <p className=\"type-body ds:m-0 ds:text-[var(--muted-foreground)]\">\n                {body}\n              </p>\n              {showCountdown && closing ? (\n                // Mounts once when closing begins → role=\"status\" announces the\n                // hand-off exactly once (no churn).\n                <p\n                  role=\"status\"\n                  className=\"type-body-sm ds:m-0 ds:text-[var(--muted-foreground)]\"\n                >\n                  {redirectingLabel ?? t('finishedTerminal.redirecting')}\n                </p>\n              ) : showCountdown ? (\n                <div className=\"ds:flex ds:flex-col ds:items-center ds:gap-[var(--spacing-sm)]\">\n                  {/* The ticking count is visible-only — NO live region. A\n                      polite region re-rewritten every second would announce\n                      \"…10 sec…9 sec…8 sec…\", which is hostile to SR users. The\n                      completion itself is announced via the focused heading; the\n                      auto-close is a sighted convenience. */}\n                  <p className=\"type-body-sm ds:m-0 ds:text-[var(--muted-foreground)]\">\n                    {countdownText}\n                  </p>\n                  <Button\n                    intent=\"secondary\"\n                    size=\"lg\"\n                    type=\"button\"\n                    onClick={handleClose}\n                  >\n                    {closeNowLabel ?? t('finishedTerminal.closeNow')}\n                  </Button>\n                </div>\n              ) : null}\n            </div>\n          </Card.Body>\n        </Card>\n      </div>\n    );\n  },\n);\n\nFinishedTerminal.displayName = 'FinishedTerminal';\n"],"names":["isChromatic","windowArgument","windowToCheck","DEFAULT_BRAND_URL","isNavigableUrl","url","protocol","FinishedTerminal","forwardRef","title","body","autoCloseSeconds","redirectUrl","brandUrl","onClose","countdownLabel","closeNowLabel","redirectingLabel","className","rest","ref","t","useTranslation","closing","setClosing","useState","closedRef","useRef","headingRef","useEffect","_a","handleClose","useCallback","remaining","useCountdown","showCountdown","countdownText","jsx","Card","jsxs","CheckCircle2","Button"],"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.62.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/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: "وقّع هنا";