@alfadocs/ui-kit-debug 0.71.0 → 0.72.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"sign-document-nK03S73h.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-field-jgwYgUhO.js

@@ -0,0 +1,197 @@
+import { jsx as s, jsxs as f, Fragment as m } from "react/jsx-runtime";
+import { forwardRef as k } from "react";
+import { c as y } from "./index-D2ZczOXr.js";
+import { useTranslation as C } from "react-i18next";
+import { S as _ } from "./spinner-hbwuKwMf.js";
+import { C as T } from "./check-DrFSN__t.js";
+import { c as w } from "./createLucideIcon-DhHxpK9K.js";
+/**
+ * @license lucide-react v1.22.0 - ISC
+ *
+ * This source code is licensed under the ISC license.
+ * See the LICENSE file in the root directory of this source tree.
+ */
+const S = [
+  ["path", { d: "M13 21h8", key: "1jsn5i" }],
+  [
+    "path",
+    {
+      d: "M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z",
+      key: "1a8usu"
+    }
+  ]
+], $ = w("pen-line", S), L = y(
+  [
+    // Overlay fields are always absolutely positioned within the
+    // renderPageOverlay box; the percent geometry rides the inline style.
+    "ds:absolute",
+    "ds:inline-flex ds:items-center ds:justify-center ds:gap-[var(--spacing-xs)]",
+    // The visible box renders at its true percentage geometry. A min-size
+    // floor here overstretched short fields past their authored box, so
+    // neighbours collided (signed box overlapping the next field). The 44/48px
+    // touch target is instead restored via a transparent ::before hit-area
+    // expansion — the same pattern Button's `sm` size uses — applied on touch
+    // viewports only; on desktop the precise box is the target.
+    'ds:before:absolute ds:before:content-[""]',
+    "ds:before:inset-x-[calc((var(--min-target-size)-100%)/-2)]",
+    "ds:before:inset-y-[calc((var(--min-target-size)-100%)/-2)]",
+    "ds:sm:before:hidden",
+    // Inline padding lives on the per-state variants below (not the base) so
+    // the signed state's tighter padding can't collide with a base ps/pe on
+    // the same logical side under Tailwind's JIT ordering.
+    "ds:rounded-[var(--radius-sm)]",
+    "ds:text-[length:var(--font-size-sm)] ds:font-medium",
+    "ds:transition-colors ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none",
+    "ds:focus-visible:outline-[length:var(--focus-ring-width)]",
+    "ds:focus-visible:outline-solid",
+    "ds:focus-visible:outline-[var(--ring)]",
+    "ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]",
+    "ds:forced-colors:focus-visible:outline-[CanvasText]",
+    "ds:aria-disabled:cursor-not-allowed"
+  ].join(" "),
+  {
+    variants: {
+      state: {
+        unsigned: [
+          "ds:cursor-pointer",
+          "ds:ps-[var(--spacing-sm)] ds:pe-[var(--spacing-sm)]",
+          "ds:border ds:border-dashed ds:border-[color:var(--ring)]",
+          "ds:bg-[color-mix(in_srgb,var(--info)_8%,transparent)]",
+          "ds:text-[var(--foreground)]",
+          "ds:hover:bg-[color-mix(in_srgb,var(--info)_16%,transparent)]",
+          "ds:forced-colors:border-[CanvasText]"
+        ].join(" "),
+        signing: [
+          "ds:cursor-progress",
+          "ds:ps-[var(--spacing-sm)] ds:pe-[var(--spacing-sm)]",
+          "ds:border ds:border-dashed ds:border-[color:var(--border)]",
+          "ds:bg-[var(--muted)]",
+          "ds:text-[var(--muted-foreground)]",
+          "ds:forced-colors:border-[CanvasText]"
+        ].join(" "),
+        signed: [
+          // overflow-hidden is NOT on the button root — it would clip the
+          // ::before touch-target expansion. It lives on the inner image
+          // wrapper instead (see render).
+          "ds:cursor-pointer",
+          "ds:p-[var(--spacing-xs)]",
+          "ds:border ds:border-solid ds:border-[color:var(--success)]",
+          "ds:bg-[color-mix(in_srgb,var(--success)_8%,transparent)]",
+          "ds:text-[var(--foreground)]",
+          "ds:forced-colors:border-[CanvasText]"
+        ].join(" ")
+      },
+      // Persistent selection ring for the nav-targeted field. Uses the same
+      // tokens as the focus ring but is NOT gated on :focus-visible, so it
+      // stays visible as the signer steps between fields. When the field is
+      // also focused, the base focus-visible ring composes over it (same
+      // outline property, same value) — no visual clash.
+      active: {
+        true: [
+          "ds:outline-solid",
+          "ds:outline-[length:var(--focus-ring-width)]",
+          "ds:outline-[var(--ring)]",
+          "ds:outline-offset-[length:var(--focus-ring-offset)]",
+          "ds:forced-colors:outline-[Highlight]"
+        ].join(" "),
+        false: ""
+      }
+    },
+    defaultVariants: { state: "unsigned", active: !1 }
+  }
+), M = k(
+  ({
+    state: e = "unsigned",
+    insetInlineStart: o,
+    insetBlockStart: a,
+    inlineSize: t,
+    blockSize: l,
+    onActivate: d,
+    signedImageSrc: c,
+    label: r,
+    disabled: v = !1,
+    active: u = !1,
+    id: p,
+    className: b,
+    ...h
+  }, x) => {
+    const { t: i } = C(), g = v || e === "signing", n = {};
+    o !== void 0 && (n.insetInlineStart = `${o}%`), a !== void 0 && (n.insetBlockStart = `${a}%`), t !== void 0 && (n.inlineSize = `${t}%`), l !== void 0 && (n.blockSize = `${l}%`);
+    const z = r ?? i("signatureField.prompt"), F = e === "signing" ? r ? i("signatureField.signingNamed", { label: r }) : i("signatureField.signing") : e === "signed" ? r ? i("signatureField.signedNamed", { label: r }) : i("signatureField.signed") : r ?? i("signatureField.unsigned");
+    function j(N) {
+      if (g) {
+        N.preventDefault();
+        return;
+      }
+      d == null || d();
+    }
+    return /* @__PURE__ */ s(
+      "button",
+      {
+        ref: x,
+        type: "button",
+        ...h,
+        "data-component": "signature-field",
+        "data-component-id": p,
+        "data-state": e,
+        "data-active": u || void 0,
+        "aria-label": F,
+        "aria-disabled": g || void 0,
+        "aria-busy": e === "signing" || void 0,
+        onClick: j,
+        className: [L({ state: e, active: u }), b].filter(Boolean).join(" "),
+        style: n,
+        children: e === "signing" ? (
+          // Decorative: the button's aria-label + aria-busy are the single
+          // source of the status announcement, so the Spinner's own
+          // role="status" live region is hidden from assistive tech.
+          /* @__PURE__ */ s("span", { "aria-hidden": "true", children: /* @__PURE__ */ s(
+            _,
+            {
+              variant: "pulse",
+              size: "sm",
+              label: i("signatureField.signing")
+            }
+          ) })
+        ) : e === "signed" ? c ? (
+          // overflow-hidden + rounding live on this inner wrapper (not the
+          // button root) so the signature is clipped to the box WITHOUT
+          // clipping the button's ::before touch-target expansion.
+          /* @__PURE__ */ s("span", { className: "ds:inline-size-full ds:block-size-full ds:overflow-hidden ds:rounded-[var(--radius-sm)]", children: /* @__PURE__ */ s(
+            "img",
+            {
+              src: c,
+              alt: "",
+              "aria-hidden": "true",
+              className: "ds:block-size-full ds:inline-size-full ds:object-contain"
+            }
+          ) })
+        ) : /* @__PURE__ */ f(m, { children: [
+          /* @__PURE__ */ s(
+            T,
+            {
+              "aria-hidden": "true",
+              className: "ds:block-size-4 ds:inline-size-4 ds:text-[var(--success)]"
+            }
+          ),
+          /* @__PURE__ */ s("span", { children: i("signatureField.signed") })
+        ] }) : /* @__PURE__ */ f(m, { children: [
+          /* @__PURE__ */ s(
+            $,
+            {
+              "aria-hidden": "true",
+              className: "ds:block-size-4 ds:inline-size-4"
+            }
+          ),
+          /* @__PURE__ */ s("span", { children: z })
+        ] })
+      }
+    );
+  }
+);
+M.displayName = "SignatureField";
+export {
+  M as S,
+  L as s
+};
+//# sourceMappingURL=signature-field-jgwYgUhO.js.map

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

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

package/dist/_chunks/smart-date-CsPlilQA.js

@@ -0,0 +1,114 @@
+import { jsxs as F, jsx as u } from "react/jsx-runtime";
+import { forwardRef as A } from "react";
+import { c as j } from "./index-D2ZczOXr.js";
+import { useTranslation as L } from "react-i18next";
+import { C as O } from "./calendar-days-BGWklvE-.js";
+import { C as R } from "./clock-Drd4Wtis.js";
+import { C as f } from "./calendar-clock-hbObjfGY.js";
+import { c as V } from "./createLucideIcon-DhHxpK9K.js";
+import { T as Y } from "./triangle-alert-CBnO6nq_.js";
+/**
+ * @license lucide-react v1.22.0 - ISC
+ *
+ * This source code is licensed under the ISC license.
+ * See the LICENSE file in the root directory of this source tree.
+ */
+const $ = [
+  ["path", { d: "M8 2v4", key: "1cmpym" }],
+  ["path", { d: "M16 2v4", key: "4m81vk" }],
+  ["rect", { width: "18", height: "18", x: "3", y: "4", rx: "2", key: "1hopcy" }],
+  ["path", { d: "M3 10h18", key: "8toen8" }],
+  ["path", { d: "m9 16 2 2 4-4", key: "19s6y9" }]
+], E = V("calendar-check", $), U = {
+  overdue: Y,
+  past: E,
+  today: f,
+  tomorrow: f,
+  soon: R,
+  upcoming: O
+}, q = 1440 * 60 * 1e3, B = j(
+  [
+    "ds:inline-flex ds:items-center ds:gap-[var(--spacing-xs)]",
+    "ds:whitespace-nowrap ds:align-middle",
+    "ds:font-[var(--font-weight-medium)]"
+  ].join(" "),
+  {
+    variants: {
+      state: {
+        // Deeper `*-foreground` tokens so the small text clears WCAG AA on the
+        // app surface, matching how Badge / TransactionChip pick their text.
+        overdue: "ds:text-[color:var(--destructive)]",
+        today: "ds:text-[color:var(--info-foreground)]",
+        tomorrow: "ds:text-[color:var(--info-foreground)]",
+        soon: "ds:text-[color:var(--foreground)]",
+        past: "ds:text-[color:var(--muted-foreground)]",
+        upcoming: "ds:text-[color:var(--muted-foreground)]"
+      },
+      size: {
+        sm: "ds:text-[length:var(--font-size-sm)] ds:[&_svg]:size-3.5",
+        md: "ds:text-[length:var(--font-size-base)] ds:[&_svg]:size-4"
+      }
+    },
+    defaultVariants: { state: "upcoming", size: "md" }
+  }
+);
+function p(e) {
+  return e instanceof Date ? e.getTime() : typeof e == "number" ? e : new Date(e).getTime();
+}
+function g(e) {
+  const a = new Date(e);
+  return new Date(a.getFullYear(), a.getMonth(), a.getDate()).getTime();
+}
+const G = A(
+  ({
+    date: e,
+    now: a,
+    deadline: h = !1,
+    soonWithinDays: d = 7,
+    size: v = "md",
+    locale: y,
+    className: D,
+    ...w
+  }, x) => {
+    const { t: l, i18n: T } = L(), s = y ?? T.language ?? "en", r = p(e), o = !Number.isNaN(r), C = a != null ? p(a) : Date.now(), n = o ? Math.round((g(r) - g(C)) / q) : 0;
+    let t;
+    o ? n === 0 ? t = "today" : n === 1 ? t = "tomorrow" : n > 1 && n <= d ? t = "soon" : n > d ? t = "upcoming" : t = h ? "overdue" : "past" : t = "upcoming";
+    const k = new Intl.RelativeTimeFormat(s, {
+      numeric: "auto",
+      style: "long"
+    }), M = (m) => m && m.charAt(0).toLocaleUpperCase(s) + m.slice(1), I = o ? new Intl.DateTimeFormat(s, {
+      day: "numeric",
+      month: "short"
+    }).format(r) : "", c = o ? new Intl.DateTimeFormat(s, {
+      year: "numeric",
+      month: "long",
+      day: "numeric"
+    }).format(r) : "", N = o ? new Intl.DateTimeFormat(s, {
+      year: "numeric",
+      month: "short",
+      day: "numeric"
+    }).format(r) : "", i = t === "overdue" ? l("smartDate.overdue") : t === "upcoming" ? "" : M(k.format(n, "day")), S = t === "upcoming" ? N : t === "soon" || t === "overdue" ? `${i} · ${I}` : i, b = o ? i ? l("smartDate.aria", { context: i, date: c }) : c : void 0, z = U[t], _ = o ? new Date(r).toISOString().slice(0, 10) : void 0;
+    return /* @__PURE__ */ F(
+      "time",
+      {
+        ref: x,
+        dateTime: _,
+        title: c || void 0,
+        "aria-label": b,
+        "data-component": "smart-date",
+        "data-state": t,
+        className: B({ state: t, size: v, className: D }),
+        ...w,
+        children: [
+          /* @__PURE__ */ u(z, { "aria-hidden": "true" }),
+          /* @__PURE__ */ u("span", { children: S })
+        ]
+      }
+    );
+  }
+);
+G.displayName = "SmartDate";
+export {
+  G as S
+};
+//# sourceMappingURL=smart-date-CsPlilQA.js.map

package/dist/_chunks/smart-date-CsPlilQA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-date-CsPlilQA.js","sources":["../../node_modules/lucide-react/dist/esm/icons/calendar-check.mjs","../../src/components/smart-date/smart-date.tsx"],"sourcesContent":["/**\n * @license lucide-react v1.22.0 - ISC\n *\n * This source code is licensed under the ISC license.\n * See the LICENSE file in the root directory of this source tree.\n */\n\nimport createLucideIcon from '../createLucideIcon.mjs';\n\nconst __iconNode = [\n  [\"path\", { d: \"M8 2v4\", key: \"1cmpym\" }],\n  [\"path\", { d: \"M16 2v4\", key: \"4m81vk\" }],\n  [\"rect\", { width: \"18\", height: \"18\", x: \"3\", y: \"4\", rx: \"2\", key: \"1hopcy\" }],\n  [\"path\", { d: \"M3 10h18\", key: \"8toen8\" }],\n  [\"path\", { d: \"m9 16 2 2 4-4\", key: \"19s6y9\" }]\n];\nconst CalendarCheck = createLucideIcon(\"calendar-check\", __iconNode);\n\nexport { __iconNode, CalendarCheck as default };\n//# sourceMappingURL=calendar-check.mjs.map\n","import { forwardRef, type HTMLAttributes, type Ref } from 'react';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { useTranslation } from 'react-i18next';\nimport {\n  CalendarDays,\n  CalendarCheck,\n  CalendarClock,\n  Clock,\n  TriangleAlert,\n  type LucideIcon,\n} from 'lucide-react';\n\n/* ------------------------------------------------------------------ */\n/* Temporal vocabulary                                                  */\n/*                                                                      */\n/* A date is bucketed against \"now\" by CALENDAR day (not raw ms), so    */\n/* \"today\" is the whole day. Each bucket carries an icon + colour that  */\n/* encodes urgency: overdue (red) › today/tomorrow (blue) › soon        */\n/* (default) › upcoming / past (muted).                                 */\n/* ------------------------------------------------------------------ */\n\nexport type SmartDateState =\n  | 'overdue'\n  | 'past'\n  | 'today'\n  | 'tomorrow'\n  | 'soon'\n  | 'upcoming';\n\nconst STATE_ICON: Record<SmartDateState, LucideIcon> = {\n  overdue: TriangleAlert,\n  past: CalendarCheck,\n  today: CalendarClock,\n  tomorrow: CalendarClock,\n  soon: Clock,\n  upcoming: CalendarDays,\n};\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\n/* ------------------------------------------------------------------ */\n/* CVA — colour per state + size                                        */\n/* ------------------------------------------------------------------ */\n\nconst smartDateVariants = cva(\n  [\n    'ds:inline-flex ds:items-center ds:gap-[var(--spacing-xs)]',\n    'ds:whitespace-nowrap ds:align-middle',\n    'ds:font-[var(--font-weight-medium)]',\n  ].join(' '),\n  {\n    variants: {\n      state: {\n        // Deeper `*-foreground` tokens so the small text clears WCAG AA on the\n        // app surface, matching how Badge / TransactionChip pick their text.\n        overdue: 'ds:text-[color:var(--destructive)]',\n        today: 'ds:text-[color:var(--info-foreground)]',\n        tomorrow: 'ds:text-[color:var(--info-foreground)]',\n        soon: 'ds:text-[color:var(--foreground)]',\n        past: 'ds:text-[color:var(--muted-foreground)]',\n        upcoming: 'ds:text-[color:var(--muted-foreground)]',\n      },\n      size: {\n        sm: 'ds:text-[length:var(--font-size-sm)] ds:[&_svg]:size-3.5',\n        md: 'ds:text-[length:var(--font-size-base)] ds:[&_svg]:size-4',\n      },\n    },\n    defaultVariants: { state: 'upcoming', size: 'md' },\n  },\n);\n\n/* ------------------------------------------------------------------ */\n/* Helpers                                                              */\n/* ------------------------------------------------------------------ */\n\nfunction toMs(v: string | number | Date): number {\n  if (v instanceof Date) return v.getTime();\n  if (typeof v === 'number') return v;\n  return new Date(v).getTime();\n}\n\n/** Midnight (local) of the day containing `ms`. */\nfunction startOfDay(ms: number): number {\n  const d = new Date(ms);\n  return new Date(d.getFullYear(), d.getMonth(), d.getDate()).getTime();\n}\n\n/* ------------------------------------------------------------------ */\n/* Props                                                               */\n/* ------------------------------------------------------------------ */\n\nexport interface SmartDateProps\n  extends\n    Omit<HTMLAttributes<HTMLTimeElement>, 'children'>,\n    Pick<VariantProps<typeof smartDateVariants>, 'size'> {\n  /** The date to display — ISO-8601 string, ms-since-epoch, or a `Date`. */\n  date: string | number | Date;\n  /**\n   * Reference \"now\" — defaults to the current date. Pin it in stories / tests\n   * (and anywhere deterministic output is required) so the bucketing is stable.\n   */\n  now?: string | number | Date;\n  /**\n   * Treat the date as a deadline: past dates read \"Overdue\" (destructive)\n   * instead of a neutral elapsed phrase (\"Yesterday\" / \"5 days ago\").\n   */\n  deadline?: boolean;\n  /**\n   * Near-future window, in whole days, within which an upcoming date shows a\n   * relative phrase (\"In 3 days\") alongside the date. Beyond it, just the date.\n   * Default `7`.\n   */\n  soonWithinDays?: number;\n  /** Locale override. Falls back to the active i18next language. */\n  locale?: string;\n}\n\n/* ------------------------------------------------------------------ */\n/* SmartDate                                                           */\n/* ------------------------------------------------------------------ */\n\nexport const SmartDate = forwardRef<HTMLTimeElement, SmartDateProps>(\n  (\n    {\n      date,\n      now,\n      deadline = false,\n      soonWithinDays = 7,\n      size = 'md',\n      locale: localeProp,\n      className,\n      ...rest\n    },\n    ref,\n  ) => {\n    const { t, i18n } = useTranslation();\n    const locale = localeProp ?? i18n.language ?? 'en';\n\n    const dateMs = toMs(date);\n    const valid = !Number.isNaN(dateMs);\n    const nowMs = now != null ? toMs(now) : Date.now();\n    const diffDays = valid\n      ? Math.round((startOfDay(dateMs) - startOfDay(nowMs)) / DAY_MS)\n      : 0;\n\n    // Bucket the date.\n    let state: SmartDateState;\n    if (!valid) state = 'upcoming';\n    else if (diffDays === 0) state = 'today';\n    else if (diffDays === 1) state = 'tomorrow';\n    else if (diffDays > 1 && diffDays <= soonWithinDays) state = 'soon';\n    else if (diffDays > soonWithinDays) state = 'upcoming';\n    else state = deadline ? 'overdue' : 'past'; // diffDays < 0\n\n    // Locale-correct relative phrase (\"today\", \"in 3 days\", \"5 days ago\") +\n    // first-letter capitalisation for the badge. Numeric \"auto\" gives the\n    // word forms (today / tomorrow / yesterday) where the locale has them.\n    const rtf = new Intl.RelativeTimeFormat(locale, {\n      numeric: 'auto',\n      style: 'long',\n    });\n    const cap = (s: string) =>\n      s ? s.charAt(0).toLocaleUpperCase(locale) + s.slice(1) : s;\n\n    const shortDate = valid\n      ? new Intl.DateTimeFormat(locale, {\n          day: 'numeric',\n          month: 'short',\n        }).format(dateMs)\n      : '';\n    const longDate = valid\n      ? new Intl.DateTimeFormat(locale, {\n          year: 'numeric',\n          month: 'long',\n          day: 'numeric',\n        }).format(dateMs)\n      : '';\n    const upcomingDate = valid\n      ? new Intl.DateTimeFormat(locale, {\n          year: 'numeric',\n          month: 'short',\n          day: 'numeric',\n        }).format(dateMs)\n      : '';\n\n    // Context word — the relative phrase / special label for the state.\n    const contextWord =\n      state === 'overdue'\n        ? t('smartDate.overdue')\n        : state === 'upcoming'\n          ? ''\n          : cap(rtf.format(diffDays, 'day'));\n\n    // Visible label: the context word, with the short date appended for the\n    // states where the date itself is useful, or the date alone when far off.\n    const label =\n      state === 'upcoming'\n        ? upcomingDate\n        : state === 'soon' || state === 'overdue'\n          ? `${contextWord} · ${shortDate}`\n          : contextWord;\n\n    // Accessible name: the context word + the FULL date so screen-reader users\n    // hear the precise day, not just \"Today\".\n    const ariaLabel = !valid\n      ? undefined\n      : contextWord\n        ? t('smartDate.aria', { context: contextWord, date: longDate })\n        : longDate;\n\n    const Icon = STATE_ICON[state];\n    const iso = valid ? new Date(dateMs).toISOString().slice(0, 10) : undefined;\n\n    return (\n      <time\n        ref={ref as Ref<HTMLTimeElement>}\n        dateTime={iso}\n        title={longDate || undefined}\n        aria-label={ariaLabel}\n        data-component=\"smart-date\"\n        data-state={state}\n        className={smartDateVariants({ state, size, className })}\n        {...rest}\n      >\n        <Icon aria-hidden=\"true\" />\n        <span>{label}</span>\n      </time>\n    );\n  },\n);\n\nSmartDate.displayName = 'SmartDate';\n"],"names":["__iconNode","CalendarCheck","createLucideIcon","STATE_ICON","TriangleAlert","CalendarClock","Clock","CalendarDays","DAY_MS","smartDateVariants","cva","toMs","v","startOfDay","ms","d","SmartDate","forwardRef","date","now","deadline","soonWithinDays","size","localeProp","className","rest","ref","t","i18n","useTranslation","locale","dateMs","valid","nowMs","diffDays","state","rtf","cap","s","shortDate","longDate","upcomingDate","contextWord","label","ariaLabel","Icon","iso","jsxs","jsx"],"mappings":"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","x_google_ignoreList":[0]}