@alfadocs/ui-kit 0.67.1 → 0.69.0

package/dist/_chunks/{sign-document-CdAiHiCh.js → sign-document-B4DeRhTe.js}

@@ -1,11 +1,11 @@
 import { jsxs as c, jsx as n } from "react/jsx-runtime";
-import { forwardRef as ce, useId as le, useMemo as G, useRef as L, useState as x, useEffect as _, useCallback as l, useImperativeHandle as ue } from "react";
+import { forwardRef as ce, useId as le, useMemo as M, useRef as R, useState as x, useEffect as V, useCallback as l, useImperativeHandle as ue } from "react";
 import { c as i } from "./index-D2ZczOXr.js";
 import { useTranslation as me } from "react-i18next";
-import { P as ge } from "./pdf-viewer-GsfNqeeT.js";
-import { S as pe } from "./signature-capture-COi0Uiqu.js";
-import { u as fe } from "./registry-nPAVE19X.js";
-import { C as J } from "./circle-check-9AeSgJD_.js";
+import { P as ge } from "./pdf-viewer-D6BPfW2D.js";
+import { S as pe } from "./signature-capture-Ct_4Md4e.js";
+import { u as fe } from "./registry-DvAUVLHh.js";
+import { C as Z } from "./circle-check-9AeSgJD_.js";
 const ve = {
   id: "sign-document",
   capabilities: ["submit"],
@@ -19,13 +19,39 @@ const ve = {
   },
   actions: {
     submit: {
+      // Persists intent: commits the captured signature and emits it via the
+      // consumer's onSign callback. Reversible via reset() before persistence.
       safety: "write",
+      returns: "SignatureConfirmPayload | null",
+      returnsSchema: {
+        oneOf: [
+          {
+            type: "object",
+            description: "The confirmed signature payload (PNG data URL + metadata).",
+            properties: {
+              dataUrl: {
+                type: "string",
+                description: "PNG data URL of the rendered signature."
+              }
+            },
+            required: ["dataUrl"]
+          },
+          {
+            type: "null",
+            description: "Returned when there is no signature to confirm."
+          }
+        ]
+      },
+      // confirm() emits via onSign — calling twice re-emits the same payload,
+      // so it is not flagged idempotent.
       descriptionKey: "signDocument.agent.actions.confirm",
       description: "Confirm the current signature, emitting it via onSign. No-op if unsigned.",
       invoke: (a) => a.confirm()
     },
     reset: {
+      // Discards the captured signature — destructive (loses drawn input).
       safety: "destructive",
+      idempotent: !0,
       descriptionKey: "signDocument.agent.actions.reset",
       description: "Clear the captured signature and return to unsigned.",
       invoke: (a) => {
@@ -107,7 +133,7 @@ const ve = {
     "ds:text-[var(--foreground)]",
     "ds:border ds:border-[color:color-mix(in_srgb,var(--success)_45%,transparent)]"
   ].join(" ")
-), Q = i(["type-body-sm"].join(" "), {
+), q = i(["type-body-sm"].join(" "), {
   variants: {
     placement: {
       pad: "ds:text-[var(--muted-foreground)]",
@@ -116,7 +142,7 @@ const ve = {
   },
   defaultVariants: { placement: "pad" }
 });
-function U(a, g) {
+function J(a, g) {
   const t = new Date(a);
   if (Number.isNaN(t.getTime())) return a;
   try {
@@ -133,7 +159,7 @@ const je = ce(
     id: a,
     src: g,
     documentTitle: t,
-    requireReadToEnd: z = !0,
+    requireReadToEnd: _ = !0,
     onSign: y,
     onError: D,
     signedAt: S = null,
@@ -141,59 +167,59 @@ const je = ce(
     disabled: C = !1,
     readOnly: w = !1,
     ariaLabel: j,
-    className: W
-  }, X) => {
-    const { t: s, i18n: R } = me(), H = le(), p = G(
+    className: Q
+  }, W) => {
+    const { t: s, i18n: z } = me(), H = le(), p = M(
       () => `sign-doc-${H.replace(/[^a-zA-Z0-9-_]/g, "")}`,
       [H]
-    ), E = `${p}-doc-heading`, T = `${p}-sign-label`, Y = `${p}-live`, N = `${p}-gate-hint`, f = L(null), [$, k] = x(0), [q, K] = x(1), [B, I] = x(!1), [A, u] = x(!1), m = S != null, ee = C || w || m, v = L(y), b = L(D);
-    _(() => {
+    ), T = `${p}-doc-heading`, E = `${p}-sign-label`, X = `${p}-live`, N = `${p}-gate-hint`, f = R(null), [$, P] = x(0), [Y, U] = x(1), [B, k] = x(!1), [K, u] = x(!1), m = S != null, ee = C || w || m, v = R(y), b = R(D);
+    V(() => {
       v.current = y, b.current = D;
-    }, [y, D]), _(() => {
-      I(!1), k(0), K(1), u(!1);
+    }, [y, D]), V(() => {
+      k(!1), P(0), U(1), u(!1);
     }, [g]);
     const se = l(
       (e) => {
-        k(e.numPages), e.numPages <= 1 && I(!0);
+        P(e.numPages), e.numPages <= 1 && k(!0);
       },
       []
     ), ne = l((e) => {
-      K(e), k((r) => (r > 0 && e >= r && I(!0), r));
+      U(e), P((r) => (r > 0 && e >= r && k(!0), r));
     }, []), ae = l((e) => {
       var r;
       (r = b.current) == null || r.call(b, e);
-    }, []), F = !m && !w;
-    _(() => {
-      if (!F) return;
+    }, []), O = !m && !w;
+    V(() => {
+      if (!O) return;
       const e = () => {
-        const Z = f.current;
-        Z && u(!Z.isEmpty());
+        const G = f.current;
+        G && u(!G.isEmpty());
       };
       e();
       const r = window.setInterval(e, 200);
       return () => window.clearInterval(r);
-    }, [F]);
-    const d = !z || B, M = !(!ee && d) || !A, te = l((e) => {
+    }, [O]);
+    const d = !_ || B, A = !(!ee && d) || !K, te = l((e) => {
       var r;
       (r = v.current) == null || r.call(v, e);
-    }, []), P = l(async () => {
+    }, []), I = l(async () => {
       const e = f.current;
       return e ? e.confirm() : null;
-    }, []), O = l(() => {
+    }, []), F = l(() => {
       var e;
       (e = f.current) == null || e.clear(), u(!1);
-    }, []), V = G(
+    }, []), L = M(
       () => ({
-        reset: O,
-        confirm: P,
+        reset: F,
+        confirm: I,
         isReadComplete: () => d
       }),
-      [O, P, d]
+      [F, I, d]
     );
-    ue(X, () => V, [V]), fe(ve, V, a);
+    ue(W, () => L, [L]), fe(ve, L, a);
     const re = j ?? (t ? s("signDocument.regionLabelNamed", { title: t }) : s("signDocument.regionLabel")), ie = t ?? s("signDocument.documentLabel"), oe = m ? s("signDocument.signedOn", {
-      date: U(S, R.language)
-    }) : d ? s("signDocument.readyToSign") : "", de = d ? A ? "" : s("signDocument.signToEnable") : s("signDocument.scrollToEnd"), h = o != null && o.signer && (o != null && o.subject) ? s("signDocument.signedByOnBehalf", {
+      date: J(S, z.language)
+    }) : d ? s("signDocument.readyToSign") : "", de = d ? K ? "" : s("signDocument.signToEnable") : s("signDocument.scrollToEnd"), h = o != null && o.signer && (o != null && o.subject) ? s("signDocument.signedByOnBehalf", {
       signer: o.signer,
       subject: o.subject
     }) : null;
@@ -201,10 +227,10 @@ const je = ce(
       "div",
       {
         role: "group",
-        "aria-labelledby": !j && t ? E : void 0,
+        "aria-labelledby": !j && t ? T : void 0,
         "aria-label": j || !t ? re : void 0,
         "aria-disabled": C || void 0,
-        className: [be(), W].filter(Boolean).join(" "),
+        className: [be(), Q].filter(Boolean).join(" "),
         "data-component": "sign-document",
         "data-component-id": a,
         "data-signed": m || void 0,
@@ -217,12 +243,12 @@ const je = ce(
               "aria-atomic": "true",
               className: "ds:sr-only",
               "data-testid": "sign-document-live",
-              id: Y,
+              id: X,
               children: oe
             }
           ),
           /* @__PURE__ */ n("span", { className: "ds:sr-only", id: N, children: de }),
-          t ? /* @__PURE__ */ n("h2", { id: E, className: he(), children: t }) : null,
+          t ? /* @__PURE__ */ n("h2", { id: T, className: he(), children: t }) : null,
           /* @__PURE__ */ n(
             ge,
             {
@@ -242,7 +268,7 @@ const je = ce(
                 "data-testid": "sign-document-signed",
                 children: [
                   /* @__PURE__ */ n(
-                    J,
+                    Z,
                     {
                       "aria-hidden": "true",
                       className: "ds:size-5 ds:text-[var(--success)] ds:shrink-0"
@@ -252,12 +278,12 @@ const je = ce(
                     /* @__PURE__ */ n("strong", { className: "ds:font-semibold", children: s("signDocument.signed") }),
                     " — ",
                     s("signDocument.signedOn", {
-                      date: U(S, R.language)
+                      date: J(S, z.language)
                     }),
                     h ? /* @__PURE__ */ n(
                       "span",
                       {
-                        className: Q({ placement: "banner" }),
+                        className: q({ placement: "banner" }),
                         "data-testid": "sign-document-attribution",
                         children: h
                       }
@@ -273,18 +299,18 @@ const je = ce(
               {
                 className: xe(),
                 role: "group",
-                "aria-labelledby": T,
+                "aria-labelledby": E,
                 "aria-describedby": N,
                 children: [
                   /* @__PURE__ */ c("div", { className: "ds:flex ds:flex-wrap ds:items-center ds:justify-between ds:gap-[var(--spacing-sm)]", children: [
-                    /* @__PURE__ */ n("span", { id: T, className: ye(), children: s("signDocument.signatureSection") }),
+                    /* @__PURE__ */ n("span", { id: E, className: ye(), children: s("signDocument.signatureSection") }),
                     $ > 0 ? /* @__PURE__ */ n(
                       "span",
                       {
                         className: De(),
                         "data-testid": "sign-document-progress",
                         children: s("signDocument.pageProgress", {
-                          current: q,
+                          current: Y,
                           total: $
                         })
                       }
@@ -293,12 +319,12 @@ const je = ce(
                   h ? /* @__PURE__ */ n(
                     "p",
                     {
-                      className: Q({ placement: "pad" }),
+                      className: q({ placement: "pad" }),
                       "data-testid": "sign-document-attribution",
                       children: h
                     }
                   ) : null,
-                  z && !d ? /* @__PURE__ */ n("p", { className: Se(), "data-testid": "sign-document-hint", children: s("signDocument.scrollToEnd") }) : null,
+                  _ && !d ? /* @__PURE__ */ n("p", { className: Se(), "data-testid": "sign-document-hint", children: s("signDocument.scrollToEnd") }) : null,
                   /* @__PURE__ */ n(
                     pe,
                     {
@@ -315,14 +341,14 @@ const je = ce(
                     {
                       type: "button",
                       onClick: () => {
-                        M || P();
+                        A || I();
                       },
-                      disabled: M,
+                      disabled: A,
                       "aria-describedby": N,
                       className: Ce(),
                       "data-testid": "sign-document-confirm",
                       children: [
-                        /* @__PURE__ */ n(J, { "aria-hidden": "true", className: "ds:size-4" }),
+                        /* @__PURE__ */ n(Z, { "aria-hidden": "true", className: "ds:size-4" }),
                         s("signDocument.confirm")
                       ]
                     }
@@ -341,4 +367,4 @@ export {
   je as S,
   ve as s
 };
-//# sourceMappingURL=sign-document-CdAiHiCh.js.map
+//# sourceMappingURL=sign-document-B4DeRhTe.js.map