@alfadocs/ui-kit-debug 0.68.0 → 0.70.0

package/dist/_chunks/sign-document-By6hMOra.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign-document-By6hMOra.js","sources":["../../src/components/sign-document/sign-document.agent.ts","../../src/components/sign-document/sign-document.tsx"],"sourcesContent":["/* -------------------------------------------------------------------- */\n/* Agent adapter — SignDocument.                                          */\n/*                                                                        */\n/* State exposes only structural lifecycle info — never the signature      */\n/* bytes (the signed consent is sensitive; persistence is the consumer's   */\n/* concern). The single write action confirms the captured signature.      */\n/*                                                                        */\n/* See `src/docs/26-agent-readiness.mdx` for the contract.                */\n/* -------------------------------------------------------------------- */\n\nimport type { AgentAdapter } from '../../agent/types';\nimport type { SignDocumentHandle } from './sign-document';\n\nexport const signDocumentAgent: AgentAdapter<SignDocumentHandle> = {\n  id: 'sign-document',\n  capabilities: ['submit'],\n  state: {\n    isReadComplete: {\n      type: 'boolean',\n      descriptionKey: 'signDocument.agent.state.isReadComplete',\n      description:\n        'True when the reader has reached the last page (or read-gating is off).',\n      read: (handle) => handle.isReadComplete(),\n    },\n  },\n  actions: {\n    submit: {\n      // Persists intent: commits the captured signature and emits it via the\n      // consumer's onSign callback. Reversible via reset() before persistence.\n      safety: 'write',\n      returns: 'SignatureConfirmPayload | null',\n      returnsSchema: {\n        oneOf: [\n          {\n            type: 'object',\n            description:\n              'The confirmed signature payload (PNG data URL + metadata).',\n            properties: {\n              dataUrl: {\n                type: 'string',\n                description: 'PNG data URL of the rendered signature.',\n              },\n            },\n            required: ['dataUrl'],\n          },\n          {\n            type: 'null',\n            description: 'Returned when there is no signature to confirm.',\n          },\n        ],\n      },\n      // confirm() emits via onSign — calling twice re-emits the same payload,\n      // so it is not flagged idempotent.\n      descriptionKey: 'signDocument.agent.actions.confirm',\n      description:\n        'Confirm the current signature, emitting it via onSign. No-op if unsigned.',\n      invoke: (handle) => handle.confirm(),\n    },\n    reset: {\n      // Discards the captured signature — destructive (loses drawn input).\n      safety: 'destructive',\n      idempotent: true,\n      descriptionKey: 'signDocument.agent.actions.reset',\n      description: 'Clear the captured signature and return to unsigned.',\n      invoke: (handle) => {\n        handle.reset();\n      },\n    },\n  },\n  domHooks: {\n    root: {\n      attr: 'data-component',\n      value: 'sign-document',\n      description: 'Marks the SignDocument wrapper.',\n    },\n    instanceId: {\n      attr: 'data-component-id',\n      sourceProp: 'id',\n      description: 'Sourced from the id prop.',\n    },\n  },\n};\n","/* ------------------------------------------------------------------ */\n/* SignDocument — review a PDF document, then sign it.                   */\n/*                                                                     */\n/* Fills the kit gap where consumers hand-composed PDFViewer +          */\n/* SignatureCapture for consents (e.g. sign.alfadocs.com, HTP-4889).    */\n/* This component owns the composition and the read-gate so the consent */\n/* flow is a single primitive:                                          */\n/*                                                                     */\n/* - PDFViewer (the document) renders above; the signing surface        */\n/*   renders below.                                                     */\n/* - When `requireReadToEnd` (default), the SignatureCapture pad and    */\n/*   the \"Confirm & sign\" button are gated until the reader reaches the */\n/*   LAST page. We track this via PDFViewer's onLoadComplete (numPages) */\n/*   + onPageChange (currentPage === numPages). NOTE: last-page-reached */\n/*   is an APPROXIMATE read signal — a fit-page zoom can show the last  */\n/*   page without scrolling. That is acceptable for this gate; a        */\n/*   legal-grade \"read every page\" guarantee is the consumer's call.    */\n/* - When `signedAt` is set the component renders an already-signed     */\n/*   read-only state (no pad) so re-sign-on-change consumers can show   */\n/*   signed status.                                                     */\n/* - Security: no fetch / XHR / storage / globals here. SignatureCapture */\n/*   owns the export payload (PNG/SVG + sha256); the consumer owns       */\n/*   persistence via onSign.                                            */\n/* - i18n: every authored string via `t('signDocument.*')` (bare keys   */\n/*   under the `ui` namespace). PDFViewer's `pdf.*` and                  */\n/*   SignatureCapture's `signature.*` strings already exist.            */\n/* ------------------------------------------------------------------ */\n\nimport {\n  forwardRef,\n  useCallback,\n  useEffect,\n  useId,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { cva } from 'class-variance-authority';\nimport { useTranslation } from 'react-i18next';\nimport { CheckCircle2 } from 'lucide-react';\nimport { PDFViewer } from '../pdf-viewer';\nimport {\n  SignatureCapture,\n  type SignatureCaptureHandle,\n  type SignatureConfirmPayload,\n} from '../signature-capture';\nimport { useAgentRegistration } from '../../agent';\nimport { signDocumentAgent } from './sign-document.agent';\n\n/* ------------------------------------------------------------------ */\n/* Public types                                                        */\n/* ------------------------------------------------------------------ */\n\nexport interface SignDocumentProps {\n  /** Opaque instance id — emitted as `data-component-id` for the agent registry. */\n  id?: string;\n  /** Document PDF — URL string, ArrayBuffer, or Uint8Array. Passed to PDFViewer. */\n  src: string | ArrayBuffer | Uint8Array;\n  /** Accessible name for the document region (also used as a heading). */\n  documentTitle?: string;\n  /**\n   * Gate the signature + Confirm until the reader reaches the last page.\n   * Default `true`. Last-page-reached is an approximate read signal (a\n   * fit-page zoom can show the last page without scrolling) — adequate for\n   * this gate; legal-grade read tracking is the consumer's concern.\n   */\n  requireReadToEnd?: boolean;\n  /** Fired when the user captures a signature AND confirms. */\n  onSign?: (payload: SignatureConfirmPayload) => void;\n  /** Forwarded from PDFViewer on any load / render error. */\n  onError?: (error: Error) => void;\n  /**\n   * When set, render the already-signed read-only state: shows \"Signed\" +\n   * the signed date and hides the pad. Use for re-sign-on-change consumers\n   * that surface signed status. `null` / `undefined` → unsigned.\n   */\n  signedAt?: string | null;\n  /**\n   * Optional on-behalf attribution. When both `signer` and `subject` are\n   * given, a \"Signed by {signer} on behalf of {subject}\" note renders both\n   * near the signature pad (so the signer sees who they're signing for) AND\n   * inside the already-signed read-only banner. Omit (the default) and\n   * nothing extra renders — the existing subject-agnostic API is unchanged.\n   * Provide both to opt in; a lone `signer` or `subject` renders nothing.\n   */\n  signedByNote?: { signer: string; subject: string };\n  /** Disable all controls (document still readable). */\n  disabled?: boolean;\n  /** Render read-only: the document is shown but the pad is suppressed. */\n  readOnly?: boolean;\n  /** Accessible label for the component's group region. */\n  ariaLabel?: string;\n  /** Extra class names merged onto the outermost wrapper. */\n  className?: string;\n}\n\n/** Curated imperative handle for agent / external automation. */\nexport interface SignDocumentHandle {\n  /** Clear the captured signature, returning to the unsigned state. */\n  reset: () => void;\n  /** Confirm the current signature; resolves the payload, or null if unsigned. */\n  confirm: () => Promise<SignatureConfirmPayload | null>;\n  /** True when the reader has reached the last page (or the gate is off). */\n  isReadComplete: () => boolean;\n}\n\n/* ------------------------------------------------------------------ */\n/* CVA                                                                 */\n/* ------------------------------------------------------------------ */\n\nconst rootVariants = cva(\n  [\n    'ds:flex ds:flex-col ds:gap-[var(--spacing-md)]',\n    'ds:rounded-[var(--radius-md)] ds:border ds:border-[color:var(--card-border)]',\n    'ds:shadow-[var(--shadow-card)] ds:[.theme-accessible_&]:border-2',\n    'ds:bg-[var(--background)] ds:text-[var(--foreground)]',\n    'ds:p-[var(--spacing-md)]',\n    'ds:aria-disabled:opacity-[var(--opacity-50)] ds:aria-disabled:cursor-not-allowed',\n  ].join(' '),\n);\n\nconst headingVariants = cva(\n  ['type-heading-sm ds:text-[var(--foreground)]'].join(' '),\n);\n\nconst signSectionVariants = cva(\n  ['ds:flex ds:flex-col ds:gap-[var(--spacing-sm)]'].join(' '),\n);\n\nconst sectionLabelVariants = cva(\n  ['type-body-sm ds:font-medium ds:text-[var(--foreground)]'].join(' '),\n);\n\nconst progressVariants = cva(\n  [\n    'ds:inline-flex ds:items-center ds:gap-[var(--spacing-xs)]',\n    'type-body-sm ds:text-[var(--muted-foreground)]',\n  ].join(' '),\n);\n\n// The \"scroll to the end to sign\" hint uses --info as a low-emphasis\n// informational tint — tokenised, logical-property insets, no accent over\n// arbitrary content.\nconst hintVariants = cva(\n  [\n    'ds:flex ds:items-center ds:gap-[var(--spacing-xs)]',\n    'type-body-sm',\n    'ds:rounded-[var(--radius-sm)]',\n    'ds:ps-[var(--spacing-sm)] ds:pe-[var(--spacing-sm)]',\n    'ds:pt-[var(--spacing-xs)] ds:pb-[var(--spacing-xs)]',\n    'ds:bg-[color-mix(in_srgb,var(--info)_10%,transparent)]',\n    'ds:text-[var(--foreground)]',\n    'ds:border ds:border-[color:color-mix(in_srgb,var(--info)_40%,transparent)]',\n  ].join(' '),\n);\n\nconst confirmButtonVariants = cva(\n  [\n    'ds:inline-flex ds:inline-size-full ds:items-center ds:justify-center',\n    'ds:[min-block-size:var(--min-target-size)]',\n    'ds:[min-inline-size:var(--min-target-size)]',\n    'ds:gap-[var(--spacing-xs)]',\n    'ds:ps-[var(--spacing-md)] ds:pe-[var(--spacing-md)]',\n    'ds:pt-[var(--spacing-md)] ds:pb-[var(--spacing-md)]',\n    'ds:rounded-[var(--radius-sm)]',\n    'ds:bg-[var(--primary)] ds:text-[var(--primary-foreground)]',\n    'ds:text-[length:var(--font-size-base)] ds:font-medium',\n    'ds:transition-colors ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none',\n    'ds:hover:bg-[var(--primary-hover)]',\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:disabled:opacity-[var(--opacity-50)] ds:disabled:cursor-not-allowed',\n    'ds:disabled:hover:bg-[var(--primary)]',\n  ].join(' '),\n);\n\n// The signed banner uses the semantic --success alias for the confirmed\n// state — never the raw ramp step (constraint §11).\nconst signedBannerVariants = cva(\n  [\n    'ds:flex ds:items-center ds:gap-[var(--spacing-sm)]',\n    'ds:rounded-[var(--radius-sm)]',\n    'ds:ps-[var(--spacing-md)] ds:pe-[var(--spacing-md)]',\n    'ds:pt-[var(--spacing-sm)] ds:pb-[var(--spacing-sm)]',\n    'ds:bg-[color-mix(in_srgb,var(--success)_12%,transparent)]',\n    'ds:text-[var(--foreground)]',\n    'ds:border ds:border-[color:color-mix(in_srgb,var(--success)_45%,transparent)]',\n  ].join(' '),\n);\n\n// The on-behalf attribution note. Low-emphasis muted text — it qualifies the\n// signature, it isn't an action. `placement` swaps the inset/spacing so the\n// same string reads correctly above the pad (a hint) and inside the signed\n// banner (a continuation of the signed copy).\nconst attributionVariants = cva(['type-body-sm'].join(' '), {\n  variants: {\n    placement: {\n      pad: 'ds:text-[var(--muted-foreground)]',\n      banner: 'ds:block ds:text-[var(--foreground)]',\n    },\n  },\n  defaultVariants: { placement: 'pad' },\n});\n\n/* ------------------------------------------------------------------ */\n/* Helpers                                                              */\n/* ------------------------------------------------------------------ */\n\n/**\n * Format an ISO timestamp using the active i18n locale. Falls back to the\n * raw string if it can't be parsed so a malformed `signedAt` never throws.\n */\nfunction formatSignedAt(iso: string, locale: string): string {\n  const date = new Date(iso);\n  if (Number.isNaN(date.getTime())) return iso;\n  try {\n    return new Intl.DateTimeFormat(locale, {\n      dateStyle: 'long',\n      timeStyle: 'short',\n    }).format(date);\n  } catch {\n    return date.toISOString();\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* SignDocument                                                        */\n/* ------------------------------------------------------------------ */\n\nexport const SignDocument = forwardRef<SignDocumentHandle, SignDocumentProps>(\n  (\n    {\n      id,\n      src,\n      documentTitle,\n      requireReadToEnd = true,\n      onSign,\n      onError,\n      signedAt = null,\n      signedByNote,\n      disabled = false,\n      readOnly = false,\n      ariaLabel,\n      className,\n    },\n    ref,\n  ) => {\n    const { t, i18n } = useTranslation();\n    const rawId = useId();\n    const idSafe = useMemo(\n      () => `sign-doc-${rawId.replace(/[^a-zA-Z0-9-_]/g, '')}`,\n      [rawId],\n    );\n    const docHeadingId = `${idSafe}-doc-heading`;\n    const signLabelId = `${idSafe}-sign-label`;\n    const liveRegionId = `${idSafe}-live`;\n    // Stable, static describedby target for the sign section + Confirm —\n    // kept separate from the polite live region so describedby points at\n    // unchanging text, not the transition announcer (which only carries\n    // gate-met / signed announcements).\n    const gateHintId = `${idSafe}-gate-hint`;\n\n    const signatureRef = useRef<SignatureCaptureHandle>(null);\n\n    const [numPages, setNumPages] = useState(0);\n    const [currentPage, setCurrentPage] = useState(1);\n    // True once the reader has reached the last page at least once. Sticky:\n    // scrolling back up does not re-lock the signature.\n    const [reachedEnd, setReachedEnd] = useState(false);\n    // Mirrors the pad's ink state so the Confirm button re-renders when a\n    // signature lands. SignatureCapture's isEmpty() is a sync ref read (no\n    // re-render) and its onStart only fires on a DRAWN stroke — not on the\n    // typed fallback. We poll the handle so both paths gate Confirm\n    // identically; onStart/onClear below are immediate-feedback hints.\n    const [hasSignature, setHasSignature] = useState(false);\n\n    const isSigned = signedAt != null;\n    const inert = disabled || readOnly || isSigned;\n\n    // Latest callbacks via refs so the async confirm path never closes over\n    // a stale prop.\n    const onSignRef = useRef(onSign);\n    const onErrorRef = useRef(onError);\n    useEffect(() => {\n      onSignRef.current = onSign;\n      onErrorRef.current = onError;\n    }, [onSign, onError]);\n\n    /* ---- Per-document reset -------------------------------------- */\n    // When the consumer swaps `src` to a NEW document, the previous \"read\n    // complete\" state must NOT carry over — otherwise the new document\n    // could be signed without being read. Reset the per-document state;\n    // PDFViewer's onLoadComplete re-sets reachedEnd for single-page docs.\n    useEffect(() => {\n      setReachedEnd(false);\n      setNumPages(0);\n      setCurrentPage(1);\n      setHasSignature(false);\n    }, [src]);\n\n    /* ---- Read-gate tracking -------------------------------------- */\n    const handleLoadComplete = useCallback(\n      (info: { numPages: number; title?: string }) => {\n        setNumPages(info.numPages);\n        // A single-page document is \"read to the end\" the moment it loads.\n        if (info.numPages <= 1) setReachedEnd(true);\n      },\n      [],\n    );\n\n    const handlePageChange = useCallback((page: number) => {\n      setCurrentPage(page);\n      setNumPages((total) => {\n        if (total > 0 && page >= total) setReachedEnd(true);\n        return total;\n      });\n    }, []);\n\n    const handleError = useCallback((error: Error) => {\n      onErrorRef.current?.(error);\n    }, []);\n\n    /* ---- Signature-presence polling ------------------------------ */\n    // Poll the pad's isEmpty() while the signing surface is live so the\n    // Confirm button reflects both drawn AND typed signatures. Cheap\n    // (a single boolean ref read on an interval); torn down when signed,\n    // read-only, or unmounted.\n    const signLive = !isSigned && !readOnly;\n    useEffect(() => {\n      if (!signLive) return undefined;\n      const tick = (): void => {\n        const pad = signatureRef.current;\n        if (!pad) return;\n        setHasSignature(!pad.isEmpty());\n      };\n      tick();\n      const interval = window.setInterval(tick, 200);\n      return () => window.clearInterval(interval);\n    }, [signLive]);\n\n    // The gate is satisfied when reading isn't required, or the reader has\n    // reached the last page at least once.\n    const readComplete = !requireReadToEnd || reachedEnd;\n    const canSign = !inert && readComplete;\n    const confirmDisabled = !canSign || !hasSignature;\n\n    /* ---- Confirm path -------------------------------------------- */\n    // `onSign` fires from SignatureCapture's `onConfirm` (wired below) — the\n    // single source of truth, so it fires once whether the user clicks the\n    // pad's own Confirm or this component's \"Confirm & sign\". This handle\n    // just proxies the pad's confirm() and returns its payload.\n    const handleSigned = useCallback((payload: SignatureConfirmPayload) => {\n      onSignRef.current?.(payload);\n    }, []);\n\n    const confirm =\n      useCallback(async (): Promise<SignatureConfirmPayload | null> => {\n        const pad = signatureRef.current;\n        if (!pad) return null;\n        return pad.confirm();\n      }, []);\n\n    const reset = useCallback(() => {\n      signatureRef.current?.clear();\n      setHasSignature(false);\n    }, []);\n\n    /* ---- Imperative handle + agent registration ------------------ */\n    const agentHandle = useMemo<SignDocumentHandle>(\n      () => ({\n        reset,\n        confirm,\n        isReadComplete: () => readComplete,\n      }),\n      [reset, confirm, readComplete],\n    );\n    useImperativeHandle(ref, () => agentHandle, [agentHandle]);\n    useAgentRegistration(signDocumentAgent, agentHandle, id);\n\n    /* ---- Derived strings ----------------------------------------- */\n    const regionLabel =\n      ariaLabel ??\n      (documentTitle\n        ? t('signDocument.regionLabelNamed', { title: documentTitle })\n        : t('signDocument.regionLabel'));\n    const documentRegionLabel =\n      documentTitle ?? t('signDocument.documentLabel');\n\n    // Live region — ONLY transition announcements (gate met / signed).\n    const liveText = isSigned\n      ? t('signDocument.signedOn', {\n          date: formatSignedAt(signedAt as string, i18n.language),\n        })\n      : readComplete\n        ? t('signDocument.readyToSign')\n        : '';\n\n    // Static describedby target — always names WHY Confirm is unavailable\n    // (or stays empty when it's actionable). Stable text, never live.\n    const gateHintText = !readComplete\n      ? t('signDocument.scrollToEnd')\n      : !hasSignature\n        ? t('signDocument.signToEnable')\n        : '';\n\n    // On-behalf attribution — only when BOTH signer and subject are present\n    // (a lone half is meaningless). Rendered above the pad and in the signed\n    // banner. Optional: undefined → no attribution, API unchanged.\n    const attributionText =\n      signedByNote?.signer && signedByNote?.subject\n        ? t('signDocument.signedByOnBehalf', {\n            signer: signedByNote.signer,\n            subject: signedByNote.subject,\n          })\n        : null;\n\n    return (\n      <div\n        role=\"group\"\n        // Prefer labelling by the visible heading so the visible + accessible\n        // names match; fall back to aria-label only when there's no heading.\n        aria-labelledby={!ariaLabel && documentTitle ? docHeadingId : undefined}\n        aria-label={ariaLabel || !documentTitle ? regionLabel : undefined}\n        aria-disabled={disabled || undefined}\n        className={[rootVariants(), className].filter(Boolean).join(' ')}\n        data-component=\"sign-document\"\n        data-component-id={id}\n        data-signed={isSigned || undefined}\n      >\n        {/* Polite live region — ONLY transition announcements (gate met /\n            signed). Static describedby text lives in the gate-hint span. */}\n        <span\n          role=\"status\"\n          aria-live=\"polite\"\n          aria-atomic=\"true\"\n          className=\"ds:sr-only\"\n          data-testid=\"sign-document-live\"\n          id={liveRegionId}\n        >\n          {liveText}\n        </span>\n\n        {/* Static, non-live describedby target for the sign group + Confirm:\n            names why Confirm is unavailable (or empty when actionable). */}\n        <span className=\"ds:sr-only\" id={gateHintId}>\n          {gateHintText}\n        </span>\n\n        {documentTitle ? (\n          <h2 id={docHeadingId} className={headingVariants()}>\n            {documentTitle}\n          </h2>\n        ) : null}\n\n        {/* The document. PDFViewer owns its own toolbar, a11y, and zoom. */}\n        <PDFViewer\n          src={src}\n          ariaLabel={documentRegionLabel}\n          onLoadComplete={handleLoadComplete}\n          onPageChange={handlePageChange}\n          onError={handleError}\n        />\n\n        {isSigned ? (\n          /* ---- Already-signed, read-only ---- */\n          <div\n            className={signedBannerVariants()}\n            data-testid=\"sign-document-signed\"\n          >\n            <CheckCircle2\n              aria-hidden=\"true\"\n              className=\"ds:size-5 ds:text-[var(--success)] ds:shrink-0\"\n            />\n            <span className=\"type-body-sm\">\n              <strong className=\"ds:font-semibold\">\n                {t('signDocument.signed')}\n              </strong>\n              {' — '}\n              {t('signDocument.signedOn', {\n                date: formatSignedAt(signedAt as string, i18n.language),\n              })}\n              {attributionText ? (\n                <span\n                  className={attributionVariants({ placement: 'banner' })}\n                  data-testid=\"sign-document-attribution\"\n                >\n                  {attributionText}\n                </span>\n              ) : null}\n            </span>\n          </div>\n        ) : readOnly ? null : (\n          /* ---- Sign surface ---- */\n          <div\n            className={signSectionVariants()}\n            role=\"group\"\n            aria-labelledby={signLabelId}\n            aria-describedby={gateHintId}\n          >\n            <div className=\"ds:flex ds:flex-wrap ds:items-center ds:justify-between ds:gap-[var(--spacing-sm)]\">\n              <span id={signLabelId} className={sectionLabelVariants()}>\n                {t('signDocument.signatureSection')}\n              </span>\n              {numPages > 0 ? (\n                <span\n                  className={progressVariants()}\n                  data-testid=\"sign-document-progress\"\n                >\n                  {t('signDocument.pageProgress', {\n                    current: currentPage,\n                    total: numPages,\n                  })}\n                </span>\n              ) : null}\n            </div>\n\n            {attributionText ? (\n              <p\n                className={attributionVariants({ placement: 'pad' })}\n                data-testid=\"sign-document-attribution\"\n              >\n                {attributionText}\n              </p>\n            ) : null}\n\n            {requireReadToEnd && !readComplete ? (\n              <p className={hintVariants()} data-testid=\"sign-document-hint\">\n                {t('signDocument.scrollToEnd')}\n              </p>\n            ) : null}\n\n            {/* The pad is always mounted so a keyboard user can prepare a\n                typed signature; the Confirm button is the gate. When the\n                read-gate is unmet the pad is disabled so it can't accept\n                ink prematurely. */}\n            <SignatureCapture\n              ref={signatureRef}\n              ariaLabel={t('signDocument.signatureSection')}\n              disabled={disabled || !readComplete}\n              onStart={() => setHasSignature(true)}\n              onClear={() => setHasSignature(false)}\n              onConfirm={handleSigned}\n            />\n\n            {/* Native `disabled` (not aria-disabled) so a gated Confirm\n                leaves the tab order entirely — mirrors how Button gates a\n                primary action. describedby names WHY it's unavailable. */}\n            <button\n              type=\"button\"\n              onClick={() => {\n                if (confirmDisabled) return;\n                void confirm();\n              }}\n              disabled={confirmDisabled}\n              aria-describedby={gateHintId}\n              className={confirmButtonVariants()}\n              data-testid=\"sign-document-confirm\"\n            >\n              <CheckCircle2 aria-hidden=\"true\" className=\"ds:size-4\" />\n              {t('signDocument.confirm')}\n            </button>\n          </div>\n        )}\n      </div>\n    );\n  },\n);\n\nSignDocument.displayName = 'SignDocument';\n\nexport { rootVariants as signDocumentRootVariants };\n"],"names":["signDocumentAgent","handle","rootVariants","cva","headingVariants","signSectionVariants","sectionLabelVariants","progressVariants","hintVariants","confirmButtonVariants","signedBannerVariants","attributionVariants","formatSignedAt","iso","locale","date","SignDocument","forwardRef","id","src","documentTitle","requireReadToEnd","onSign","onError","signedAt","signedByNote","disabled","readOnly","ariaLabel","className","ref","t","i18n","useTranslation","rawId","useId","idSafe","useMemo","docHeadingId","signLabelId","liveRegionId","gateHintId","signatureRef","useRef","numPages","setNumPages","useState","currentPage","setCurrentPage","reachedEnd","setReachedEnd","hasSignature","setHasSignature","isSigned","inert","onSignRef","onErrorRef","useEffect","handleLoadComplete","useCallback","info","handlePageChange","page","total","handleError","error","_a","signLive","tick","pad","interval","readComplete","confirmDisabled","handleSigned","payload","confirm","reset","agentHandle","useImperativeHandle","useAgentRegistration","regionLabel","documentRegionLabel","liveText","gateHintText","attributionText","jsxs","jsx","PDFViewer","CheckCircle2","SignatureCapture"],"mappings":"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"}

package/dist/_chunks/{signature-capture-COi0Uiqu.js → signature-capture-Ct_4Md4e.js}

@@ -1,36 +1,70 @@
 import { jsxs as q, jsx as b } from "react/jsx-runtime";
-import { forwardRef as Ve, useId as Ae, useMemo as ie, useRef as z, useState as A, useEffect as N, useCallback as P, useImperativeHandle as Me } from "react";
-import Ne from "signature_pad";
+import { forwardRef as Ae, useId as Pe, useMemo as ie, useRef as C, useState as P, useEffect as V, useCallback as M, useImperativeHandle as Te } from "react";
+import Ve from "signature_pad";
 import { c as R } from "./index-D2ZczOXr.js";
-import { useTranslation as Pe } from "react-i18next";
-import { u as Te } from "./registry-nPAVE19X.js";
+import { useTranslation as Me } from "react-i18next";
+import { u as Ne } from "./registry-DvAUVLHh.js";
 const je = {
   id: "signature-capture",
-  capabilities: ["edit_inline", "submit"],
+  // Multi-step media lifecycle: draw / type strokes (capture) then commit the
+  // serialised signature (submit).
+  capabilities: ["capture", "submit"],
   state: {
     isEmpty: {
       type: "boolean",
+      descriptionKey: "ui.agent.signatureCapture.state.isEmpty",
       description: "True when no signature has been drawn or typed.",
       read: (t) => t.isEmpty()
     }
   },
   actions: {
     clear: {
+      // Erases all captured strokes — destructive (loses drawn/typed input).
       safety: "destructive",
+      idempotent: !0,
+      descriptionKey: "ui.agent.signatureCapture.actions.clear",
       description: "Erase the current signature. Loses unsaved input.",
       invoke: (t) => {
         t.clear();
       }
     },
     undo: {
+      // Removes the last stroke — reversible by redrawing.
       safety: "write",
+      descriptionKey: "ui.agent.signatureCapture.actions.undo",
       description: "Undo the last stroke.",
       invoke: (t) => {
         t.undo();
       }
     },
     confirm: {
+      // Commits the captured media and returns its serialised payload.
       safety: "write",
+      returns: "SignatureConfirmPayload | null",
+      returnsSchema: {
+        oneOf: [
+          {
+            type: "object",
+            description: "The committed signature payload.",
+            properties: {
+              dataUrl: {
+                type: "string",
+                description: "PNG data URL of the captured signature."
+              },
+              capturedAt: {
+                type: "string",
+                description: "ISO-8601 UTC timestamp of the commit."
+              }
+            },
+            required: ["dataUrl"]
+          },
+          {
+            type: "null",
+            description: "Returned when the pad is empty."
+          }
+        ]
+      },
+      descriptionKey: "ui.agent.signatureCapture.actions.confirm",
       description: "Commit the signature and return its serialised payload.",
       invoke: (t) => t.confirm()
     }
@@ -43,7 +77,7 @@ const je = {
       description: "Sourced from the id prop."
     }
   }
-}, Be = R(
+}, Ee = R(
   [
     "ds:signature-capture-alfadocs ds:flex ds:flex-col",
     "ds:gap-[var(--spacing-sm)]",
@@ -54,7 +88,7 @@ const je = {
     "ds:p-[var(--spacing-sm)]",
     "ds:aria-disabled:opacity-[var(--opacity-50)] ds:aria-disabled:cursor-not-allowed"
   ].join(" ")
-), Ee = R(
+), Be = R(
   [
     "ds:relative ds:block",
     // Mobile-first: fill the available width but never exceed the configured
@@ -73,7 +107,7 @@ const je = {
     "ds:focus-visible:outline-[var(--ring)]",
     "ds:forced-colors:focus-visible:outline-[CanvasText]"
   ].join(" ")
-), $e = R(
+), Le = R(
   [
     "ds:block",
     // Arbitrary-property form, NOT `inline-size-full` / `block-size-full`:
@@ -89,7 +123,7 @@ const je = {
     "ds:touch-none",
     "ds:select-none"
   ].join(" ")
-), De = R(
+), Ue = R(
   ["ds:flex ds:items-stretch ds:flex-wrap ds:gap-[var(--spacing-sm)]"].join(
     " "
   )
@@ -114,7 +148,7 @@ const je = {
     "ds:forced-colors:focus-visible:outline-[CanvasText]",
     "ds:aria-disabled:opacity-[var(--opacity-50)] ds:aria-disabled:cursor-not-allowed"
   ].join(" ")
-), Fe = R(
+), $e = R(
   [
     "ds:inline-flex ds:flex-1 ds:items-center ds:justify-center",
     "ds:[min-block-size:var(--min-target-size)]",
@@ -133,7 +167,7 @@ const je = {
     "ds:forced-colors:focus-visible:outline-[CanvasText]",
     "ds:aria-disabled:opacity-[var(--opacity-50)] ds:aria-disabled:cursor-not-allowed"
   ].join(" ")
-), Le = R(
+), De = R(
   [
     "ds:block ds:inline-size-full",
     "ds:[min-block-size:var(--min-target-size)]",
@@ -150,7 +184,7 @@ const je = {
     "ds:focus-visible:outline-[var(--ring)]",
     "ds:forced-colors:focus-visible:outline-[CanvasText]"
   ].join(" ")
-), Ie = R(
+), Fe = R(
   [
     "ds:flex ds:items-center ds:justify-center",
     // Match the pad frame: responsive width capped at the configured size.
@@ -180,7 +214,7 @@ function le(t) {
   const n = parseFloat(t);
   return Number.isFinite(n) ? n : null;
 }
-function He(t) {
+function Ie(t) {
   let n = "";
   for (let s = 0; s < t.length; s += 1) {
     const i = t[s];
@@ -188,7 +222,7 @@ function He(t) {
   }
   return n;
 }
-function Ue(t) {
+function He(t) {
   if (typeof atob == "function") {
     const s = atob(t), i = new Uint8Array(s.length);
     for (let a = 0; a < s.length; a += 1) i[a] = s.charCodeAt(a);
@@ -204,53 +238,53 @@ async function Oe(t) {
     const i = new Uint8Array(t.byteLength);
     i.set(t);
     const a = await n.crypto.subtle.digest("SHA-256", i.buffer);
-    return He(new Uint8Array(a));
+    return Ie(new Uint8Array(a));
   }
   return "";
 }
 function _e(t, n, s, i, a) {
-  const v = Math.max(
+  const m = Math.max(
     1,
     typeof window < "u" ? window.devicePixelRatio : 1
-  ), C = document.createElement("canvas");
-  C.width = Math.floor(n * v), C.height = Math.floor(s * v);
-  const d = C.getContext("2d");
-  return d && (d.setTransform(v, 0, 0, v, 0, 0), d.fillStyle = a, d.fillRect(0, 0, n, s), d.fillStyle = i, d.font = "32px italic sans-serif", d.textAlign = "center", d.textBaseline = "middle", d.fillText(t, n / 2, s / 2, n - 16)), C;
+  ), z = document.createElement("canvas");
+  z.width = Math.floor(n * m), z.height = Math.floor(s * m);
+  const d = z.getContext("2d");
+  return d && (d.setTransform(m, 0, 0, m, 0, 0), d.fillStyle = a, d.fillRect(0, 0, n, s), d.fillStyle = i, d.font = "32px italic sans-serif", d.textAlign = "center", d.textBaseline = "middle", d.fillText(t, n / 2, s / 2, n - 16)), z;
 }
-const We = Ve(
+const Ke = Ae(
   ({
     id: t,
     onConfirm: n,
     onClear: s,
     onStart: i,
     width: a = 400,
-    height: v = 200,
-    penColor: C,
+    height: m = 200,
+    penColor: z,
     backgroundColor: d,
     allowTypedFallback: ue = !0,
-    name: T,
+    name: N,
     disabled: h = !1,
     ariaLabel: fe,
-    className: ge
-  }, pe) => {
-    const { t: c } = Pe(), G = Ae(), Z = `${ie(
+    className: pe
+  }, ge) => {
+    const { t: c } = Me(), G = Pe(), X = `${ie(
       () => `sig-${G.replace(/[^a-zA-Z0-9-_]/g, "")}`,
       [G]
-    )}-live`, L = z(null), J = z(null), j = z(null), K = z(null), y = z(null), [l, ve] = A("draw"), [S, I] = A(""), [me, Q] = A(""), [be, H] = A(!1), he = z("empty"), [ye, we] = A(""), [m, xe] = A(""), [w, ke] = A(""), B = z(i), E = z(s), $ = z(n);
-    N(() => {
-      B.current = i, E.current = s, $.current = n;
+    )}-live`, D = C(null), Z = C(null), j = C(null), J = C(null), y = C(null), [l, me] = P("draw"), [S, F] = P(""), [ve, Q] = P(""), [be, I] = P(!1), he = C("empty"), [ye, we] = P(""), [v, xe] = P(""), [w, ke] = P(""), E = C(i), B = C(s), L = C(n);
+    V(() => {
+      E.current = i, B.current = s, L.current = n;
     }, [i, s, n]);
-    const f = P(
+    const f = M(
       (e) => {
         he.current = e, we(c(`signature.state.${e}`));
       },
       [c]
     );
-    N(() => {
+    V(() => {
       if (typeof document > "u") return;
       function e() {
-        const o = C ?? de("--foreground"), g = d ?? de("--background");
-        xe(o || "currentColor"), ke(g || "transparent");
+        const o = z ?? de("--foreground"), p = d ?? de("--background");
+        xe(o || "currentColor"), ke(p || "transparent");
       }
       e();
       const r = new MutationObserver(() => {
@@ -260,15 +294,15 @@ const We = Ve(
         attributes: !0,
         attributeFilter: ["class"]
       }), () => r.disconnect();
-    }, [C, d]), N(() => {
+    }, [z, d]), V(() => {
       const e = y.current;
-      e && (m && (e.penColor = m), w && (e.backgroundColor = w));
-    }, [m, w]), N(() => {
+      e && (v && (e.penColor = v), w && (e.backgroundColor = w));
+    }, [v, w]), V(() => {
       if (l !== "draw") return;
       const e = j.current;
       if (!e) return;
-      const r = new Ne(e, {
-        penColor: m || "currentColor",
+      const r = new Ve(e, {
+        penColor: v || "currentColor",
         backgroundColor: w || "transparent",
         minWidth: 0.5,
         maxWidth: 2.5,
@@ -277,146 +311,146 @@ const We = Ve(
       y.current = r;
       const o = () => {
         var x;
-        H(!0), f("drawing"), (x = B.current) == null || x.call(B);
-      }, g = () => {
+        I(!0), f("drawing"), (x = E.current) == null || x.call(E);
+      }, p = () => {
       };
-      return r.addEventListener("beginStroke", o), r.addEventListener("endStroke", g), D(e), f("empty"), () => {
-        r.removeEventListener("beginStroke", o), r.removeEventListener("endStroke", g), r.clear(), r.off(), y.current = null;
+      return r.addEventListener("beginStroke", o), r.addEventListener("endStroke", p), U(e), f("empty"), () => {
+        r.removeEventListener("beginStroke", o), r.removeEventListener("endStroke", p), r.clear(), r.off(), y.current = null;
       };
-    }, [l]), N(() => {
+    }, [l]), V(() => {
       const e = y.current;
       e && (h ? e.off() : e.on());
     }, [h, l]);
-    const Y = 4096, D = P(
+    const Y = 4096, U = M(
       (e) => {
         const r = e.getBoundingClientRect(), o = Math.max(
           1,
           typeof window < "u" ? window.devicePixelRatio : 1
-        ), g = Math.max(1, Math.floor(r.width * o)), x = Math.max(1, Math.floor(r.height * o)), V = Math.min(g, Y), k = Math.min(x, Y);
-        if (e.width === V && e.height === k)
+        ), p = Math.max(1, Math.floor(r.width * o)), x = Math.max(1, Math.floor(r.height * o)), A = Math.min(p, Y), k = Math.min(x, Y);
+        if (e.width === A && e.height === k)
           return;
-        const p = y.current, M = p ? p.toData() : null;
-        e.width = V, e.height = k;
-        const F = e.getContext("2d");
-        F && F.scale(o, o), p && (w && (p.backgroundColor = w), m && (p.penColor = m), p.clear(), M && M.length > 0 && p.fromData(M));
+        const g = y.current, T = g ? g.toData() : null;
+        e.width = A, e.height = k;
+        const $ = e.getContext("2d");
+        $ && $.scale(o, o), g && (w && (g.backgroundColor = w), v && (g.penColor = v), g.clear(), T && T.length > 0 && g.fromData(T));
       },
-      [w, m]
+      [w, v]
     );
-    N(() => {
+    V(() => {
       const e = j.current;
       if (!e) return;
       if (typeof ResizeObserver > "u") {
-        D(e);
+        U(e);
         return;
       }
       const r = new ResizeObserver(() => {
-        D(e);
+        U(e);
       });
       return r.observe(e), () => r.disconnect();
-    }, [D]);
-    const U = P(() => {
+    }, [U]);
+    const H = M(() => {
       var r;
       const e = y.current;
-      e && e.clear(), I(""), Q(""), H(!1), f("cleared"), (r = E.current) == null || r.call(E);
-    }, [f]), ee = P(() => {
+      e && e.clear(), F(""), Q(""), I(!1), f("cleared"), (r = B.current) == null || r.call(B);
+    }, [f]), ee = M(() => {
       const e = y.current;
       if (!e) return;
       const r = e.toData();
-      !r || r.length === 0 || (r.pop(), e.fromData(r), r.length === 0 && (H(!1), f("empty")));
-    }, [f]), te = P(() => {
+      !r || r.length === 0 || (r.pop(), e.fromData(r), r.length === 0 && (I(!1), f("empty")));
+    }, [f]), te = M(() => {
       if (l === "typed") return S.trim().length === 0;
       const e = y.current;
       return e ? e.isEmpty() : !0;
-    }, [l, S]), O = P(async () => {
+    }, [l, S]), O = M(async () => {
       var se;
       const e = le(
         typeof a == "number" ? `${a}` : String(a)
       ), r = le(
-        typeof v == "number" ? `${v}` : String(v)
-      ), o = l === "draw" ? j.current ?? J.current ?? L.current : K.current ?? L.current, g = o == null ? void 0 : o.getBoundingClientRect(), x = e ?? (g ? g.width : 400), V = r ?? (g ? g.height : 200);
-      let k = "", p = "", M;
+        typeof m == "number" ? `${m}` : String(m)
+      ), o = l === "draw" ? j.current ?? Z.current ?? D.current : J.current ?? D.current, p = o == null ? void 0 : o.getBoundingClientRect(), x = e ?? (p ? p.width : 400), A = r ?? (p ? p.height : 200);
+      let k = "", g = "", T;
       if (l === "draw") {
         const u = y.current;
         if (!u || u.isEmpty()) return null;
-        k = u.toDataURL("image/png"), p = u.toSVG(), M = u.toData();
+        k = u.toDataURL("image/png"), g = u.toSVG(), T = u.toData();
       } else {
         const u = S.trim();
         if (u.length === 0) return null;
         k = _e(
           u,
           x,
-          V,
-          m || "currentColor",
+          A,
+          v || "currentColor",
           w || "transparent"
         ).toDataURL("image/png");
-        const X = u.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
-        p = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${x} ${V}" width="${x}" height="${V}"><text x="50%" y="50%" dominant-baseline="middle" text-anchor="middle" font-family="sans-serif" font-style="italic" font-size="32" fill="${m || "currentColor"}" letter-spacing="3">${X}</text></svg>`;
+        const W = u.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+        g = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${x} ${A}" width="${x}" height="${A}"><text x="50%" y="50%" dominant-baseline="middle" text-anchor="middle" font-family="sans-serif" font-style="italic" font-size="32" fill="${v || "currentColor"}" letter-spacing="3">${W}</text></svg>`;
       }
-      const F = x * 25.4 / 96, Se = V * 25.4 / 96, Re = (/* @__PURE__ */ new Date()).toISOString();
+      const $ = x * 25.4 / 96, Se = A * 25.4 / 96, Re = (/* @__PURE__ */ new Date()).toISOString();
       let ne = "";
       if (k) {
-        const u = k.indexOf(","), ae = u >= 0 ? k.slice(u + 1) : "", X = Ue(ae);
-        ne = await Oe(X);
+        const u = k.indexOf(","), ae = u >= 0 ? k.slice(u + 1) : "", W = He(ae);
+        ne = await Oe(W);
       }
-      const W = {
+      const K = {
         png: k,
-        svg: p,
-        widthMm: F,
+        svg: g,
+        widthMm: $,
         heightMm: Se,
         capturedAt: Re,
         sha256: ne,
-        strokes: M
+        strokes: T
       };
-      return f("captured"), T && Q(W.png), (se = $.current) == null || se.call($, W), W;
+      return f("captured"), N && Q(K.png), (se = L.current) == null || se.call(L, K), K;
     }, [
       l,
       S,
       a,
-      v,
       m,
+      v,
       w,
       f,
-      T
+      N
     ]), _ = ie(
       () => ({
-        clear: U,
+        clear: H,
         undo: ee,
         isEmpty: te,
         confirm: O
       }),
-      [U, ee, te, O]
+      [H, ee, te, O]
     );
-    Me(pe, () => _, [_]), Te(je, _, t);
-    const ze = l === "typed" ? S.trim().length > 0 : be, re = h || !ze, Ce = {
+    Te(ge, () => _, [_]), Ne(je, _, t);
+    const Ce = l === "typed" ? S.trim().length > 0 : be, re = h || !Ce, ze = {
       "--signature-width": ce(
         a,
         "var(--signature-default-width)"
       ),
       "--signature-height": ce(
-        v,
+        m,
         "var(--signature-default-height)"
       )
     };
     return /* @__PURE__ */ q(
       "div",
       {
-        ref: L,
+        ref: D,
         role: "group",
         "aria-label": fe ?? c("signature.padLabel"),
         "aria-disabled": h || void 0,
-        className: [Be(), ge].filter(Boolean).join(" "),
-        style: Ce,
+        className: [Ee(), pe].filter(Boolean).join(" "),
+        style: ze,
         "data-component": "signature-capture",
         "data-component-id": t,
         children: [
-          T ? /* @__PURE__ */ b("input", { type: "hidden", name: T, value: me, readOnly: !0 }) : null,
-          l === "draw" ? /* @__PURE__ */ b("div", { ref: J, className: Ee(), children: /* @__PURE__ */ b(
+          N ? /* @__PURE__ */ b("input", { type: "hidden", name: N, value: ve, readOnly: !0 }) : null,
+          l === "draw" ? /* @__PURE__ */ b("div", { ref: Z, className: Be(), children: /* @__PURE__ */ b(
             "canvas",
             {
               ref: j,
               role: "img",
               "aria-label": c("signature.padLabel"),
-              className: $e(),
+              className: Le(),
               "data-testid": "signature-canvas"
             }
           ) }) : /* @__PURE__ */ q("label", { className: "ds:flex ds:flex-col ds:gap-[var(--spacing-xs)]", children: [
@@ -427,20 +461,20 @@ const We = Ve(
                 type: "text",
                 value: S,
                 onChange: (e) => {
-                  I(e.target.value), e.target.value.length > 0 ? f("drawing") : f("empty");
+                  F(e.target.value), e.target.value.length > 0 ? f("drawing") : f("empty");
                 },
                 placeholder: c("signature.typedFallback.placeholder"),
                 "aria-label": c("signature.typedFallback.label"),
                 disabled: h,
-                className: Le(),
+                className: De(),
                 "data-testid": "signature-typed-input"
               }
             ),
             S ? /* @__PURE__ */ b(
               "div",
               {
-                ref: K,
-                className: Ie(),
+                ref: J,
+                className: Fe(),
                 "aria-hidden": "true",
                 children: S
               }
@@ -449,7 +483,7 @@ const We = Ve(
           /* @__PURE__ */ b(
             "div",
             {
-              id: Z,
+              id: X,
               "aria-live": "polite",
               "aria-atomic": "true",
               className: "ds:sr-only",
@@ -460,7 +494,7 @@ const We = Ve(
           /* @__PURE__ */ q(
             "div",
             {
-              className: De(),
+              className: Ue(),
               role: "group",
               "aria-label": c("signature.padLabel"),
               children: [
@@ -469,7 +503,7 @@ const We = Ve(
                   {
                     type: "button",
                     onClick: () => {
-                      h || U();
+                      h || H();
                     },
                     "aria-disabled": h || void 0,
                     className: oe(),
@@ -481,7 +515,7 @@ const We = Ve(
                   {
                     type: "button",
                     onClick: () => {
-                      h || (I(""), ve((e) => e === "draw" ? "typed" : "draw"), f("cleared"));
+                      h || (F(""), me((e) => e === "draw" ? "typed" : "draw"), f("cleared"));
                     },
                     "aria-disabled": h || void 0,
                     className: oe(),
@@ -497,8 +531,8 @@ const We = Ve(
                       re || O();
                     },
                     "aria-disabled": re || void 0,
-                    "aria-describedby": Z,
-                    className: Fe(),
+                    "aria-describedby": X,
+                    className: $e(),
                     "data-testid": "signature-confirm",
                     children: c("signature.confirm")
                   }
@@ -511,9 +545,9 @@ const We = Ve(
     );
   }
 );
-We.displayName = "SignatureCapture";
+Ke.displayName = "SignatureCapture";
 export {
-  We as S,
+  Ke as S,
   je as s
 };
-//# sourceMappingURL=signature-capture-COi0Uiqu.js.map
+//# sourceMappingURL=signature-capture-Ct_4Md4e.js.map