@assure-one/design-system 1.39.0 → 1.40.0

package/dist/suite/index.d.ts

@@ -1,4 +1,989 @@
-export { A as AgreementFirm, a as AgreementPaneHeading, b as AgreementPaneHeadingProps, c as AgreementStatus, d as AgreementStep, e as AgreementViewer, f as AgreementViewerProps, g as AssureAuditBrandIcon, h as AssureBooksBrandIcon, i as AssureProBrandIcon, j as AssureTaxBrandIcon, B as BRAND_PRODUCTS, k as BrandIconProps, l as BrandProduct, C as ClientSelect, p as ClientSelectOption, q as ComingSoon, r as ComingSoonProps, D as DocumentDetailActions, s as DocumentDetailActionsProps, t as DocumentDetailBody, u as DocumentDetailBodyProps, v as DocumentDetailHeader, w as DocumentDetailHeaderProps, x as DocumentDetailMetaRow, y as DocumentDetailMetaRowProps, z as DocumentDetailPanel, E as DocumentDetailPanelProps, F as DocumentDetailRequester, G as DocumentDetailRequesterProps, H as DocumentDetailTitle, I as DocumentDetailTitleProps, J as DocumentList, K as DocumentListProps, L as DocumentListSection, M as DocumentListSectionProps, N as DocumentRow, O as DocumentRowProps, P as Grid, Q as GridColumn, R as GridInputType, S as GridProps, T as GridRow, U as GridValue, V as Logo, W as ProposalAddOn, X as ProposalAddOnProps, Y as ProposalBillingMode, Z as ProposalBillingRow, _ as ProposalBillingTerms, $ as ProposalBillingTermsProps, a0 as ProposalConsentGate, a1 as ProposalConsentGateProps, a2 as ProposalCustomPage, a3 as ProposalCustomPageKind, a4 as ProposalCustomPageProps, a5 as ProposalNote, a6 as ProposalNoteProps, a7 as ProposalPackageCard, a8 as ProposalPackageCardProps, a9 as ProposalPackageMode, aa as ProposalPaymentCapture, ab as ProposalPaymentCaptureProps, ac as ProposalPricingSummary, ad as ProposalPricingSummaryProps, ae as ProposalServiceRow, af as ProposalServiceRowProps, ag as ProposalSignatureBlock, ah as ProposalSignatureBlockProps, ai as ProposalSigner, aj as ProposalSignerList, ak as ProposalSignerListProps, al as ProposalSignerStatus, ao as QuestionAddressValue, ap as QuestionFileValue, aq as QuestionHelp, ar as QuestionLabeledColumn, as as QuestionLabeledRow, at as QuestionLabeledValue, au as QuestionNameValue, av as QuestionOption, aw as QuestionTableColumn, ax as QuestionTableRow, ay as QuestionType, az as Questions, aA as QuestionsProps, aB as SidebarBrandSwitcher, aC as SidebarBrandSwitcherExtra, aD as SidebarBrandSwitcherItem, aE as SidebarBrandSwitcherProps, aF as SidebarBrandSwitcherTile, aG as brandLabel } from '../index-DxBjmBBp.js';
-import 'react';
-import 'react/jsx-runtime';
-import '../types-k_kjwipx.js';
+import * as React$1 from 'react';
+import { ReactNode } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+export { B as BRAND_PRODUCTS, a as BrandProduct, b as brandLabel } from '../brand-scope-BOHId6BY.js';
+import { C as ComingSoonMessages } from '../types-Coqw8iaS.js';
+
+interface BrandIconProps extends React.SVGAttributes<SVGElement> {
+    size?: number;
+}
+declare function AssureProBrandIcon({ size, ...props }: BrandIconProps): react_jsx_runtime.JSX.Element;
+declare function AssureAuditBrandIcon({ size, ...props }: BrandIconProps): react_jsx_runtime.JSX.Element;
+declare function AssureBooksBrandIcon({ size, ...props }: BrandIconProps): react_jsx_runtime.JSX.Element;
+declare function AssureTaxBrandIcon({ size, ...props }: BrandIconProps): react_jsx_runtime.JSX.Element;
+
+type ClientSelectOption = {
+    id: string;
+    label: string;
+    email?: string;
+};
+interface ClientSelectProps {
+    clients: ClientSelectOption[];
+    value: string | null;
+    onChange: (clientId: string | null) => void;
+    name?: string;
+    error?: string;
+    className?: string;
+    placeholder?: string;
+}
+declare function ClientSelect({ clients, value, onChange, name, error, className, placeholder, }: ClientSelectProps): react_jsx_runtime.JSX.Element;
+declare namespace ClientSelect {
+    var displayName: string;
+}
+
+/**
+ * ComingSoon — placeholder pattern for unreleased modules. Pro-tinted icon
+ * halo, dashed Assure border, "In Development" pill.
+ *
+ * Public API preserved: `icon`, `title`, `description`, `features`. The two
+ * strings the component owned itself — the "Coming soon" eyebrow and the
+ * "In Development" pill — are injectable through `messages` (prop >
+ * `DesignSystemProvider messages.comingSoon` > English, W5-20/W8-08); the
+ * defaults are today's text, so nothing changes without an override.
+ */
+interface ComingSoonProps extends React.HTMLAttributes<HTMLDivElement> {
+    icon: React.ReactNode;
+    title: string;
+    description: string;
+    features: string[];
+    /** The eyebrow and pill copy. Defaults to English ("Coming soon" / "In Development"). */
+    messages?: Partial<ComingSoonMessages>;
+}
+declare const ComingSoon: React$1.ForwardRefExoticComponent<ComingSoonProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Logo — Assure suite wordmark. Renders the official product artwork when
+ * available, and falls back to a brand glyph + text lockup otherwise.
+ *
+ * The artwork ships in the package (`public/brand/*.svg`, W8-07) but is served
+ * by the host: copy it into the app's public folder, or point
+ * `setAssetBasePath` at wherever it is served from. Nothing breaks if you do
+ * neither — an image that fails to load falls back to the glyph + text lockup.
+ *
+ * The product suffix is configurable so the same component serves every
+ * Assure product. The default preserves the original "Assure Pro" output —
+ * existing consumers do not need to change anything.
+ *
+ * Public API:
+ *   - `size`, `href`, `showText`, `inverted` (visual)
+ *   - `productName` (the suffix text; `null` renders just "Assure")
+ *   - `className`, `iconClassName`, `textClassName` (style overrides)
+ *
+ * The link and the wordmark image are the provider's `linkComponent` /
+ * `imageComponent` when a `DesignSystemProvider` supplies them (W5-21,
+ * ADR-010), else a plain `<a>` / `<img>`. Since 2.0 the root never imports
+ * `next/*` (C-NEXT-PEER): a Next.js app renders `NextDesignSystemProvider`
+ * (`@assure-one/design-system/next`) to get `next/link` / `next/image`.
+ *
+ * By default the lockup is a link (`href="/"`). Pass `href={null}` to render a
+ * non-interactive `<span>` wrapper instead — required when embedding the lockup
+ * inside another interactive element (a menu trigger `<button>`, a
+ * `DropdownMenuItem`) where a nested `<a>` would be invalid HTML or would race
+ * the parent's click handler.
+ */
+declare const sizeStyles: {
+    readonly sm: {
+        readonly icon: 20;
+        readonly text: "ds:text-sm";
+        readonly gap: "ds:gap-2";
+        readonly assetHeight: 24;
+    };
+    readonly md: {
+        readonly icon: 24;
+        readonly text: "ds:text-[17px]";
+        readonly gap: "ds:gap-2.5";
+        readonly assetHeight: 30;
+    };
+    readonly lg: {
+        readonly icon: 32;
+        readonly text: "ds:text-xl";
+        readonly gap: "ds:gap-3";
+        readonly assetHeight: 40;
+    };
+    readonly xl: {
+        readonly icon: 40;
+        readonly text: "ds:text-2xl";
+        readonly gap: "ds:gap-3.5";
+        readonly assetHeight: 48;
+    };
+};
+interface LogoProps {
+    size?: keyof typeof sizeStyles;
+    /** Link target for the lockup. Pass `null` to render a non-interactive `<span>` wrapper (for embedding inside another interactive element). Defaults to `"/"`. */
+    href?: string | null;
+    showText?: boolean;
+    className?: string;
+    iconClassName?: string;
+    textClassName?: string;
+    /**
+     * Product suffix rendered after "Assure" (e.g. "Pro", "Audit"). Pass `null`
+     * to render just "Assure". A few products are standalone brands whose
+     * wordmark is the complete identity (e.g. "Teams" → myCPE Teams) — those
+     * render their own name with no "Assure" prefix. Defaults to "Pro" for
+     * backwards compatibility.
+     */
+    productName?: string | null;
+    /** When true, render on dark/brand surfaces (white "Assure" + lighter suffix). */
+    inverted?: boolean;
+}
+declare function Logo({ size, href, showText, className, iconClassName, textClassName, productName, inverted, }: LogoProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * AgreementViewer — the chrome + navigation shell for a multi-step, branded
+ * agreement / proposal (the "Signed Agreement Viewer"). It owns the header,
+ * the firm-branded cover rail, the section stepper, the signed / awaiting
+ * banner, the prev·dots·next footer, and the step state. Each step's body is
+ * consumer-owned `content` — the shell is deliberately content-agnostic so the
+ * same frame drives a tax proposal, an engagement letter, or an NDA.
+ *
+ * Step 0 is the cover: it shows the gradient firm rail. Steps 1+ show the
+ * light section rail with the stepper. One root attribute drives both:
+ * `data-view="cover" | "inner"`, derived from the current step.
+ *
+ * Branding: the whole composite themes from a single accent. Omit `accent` to
+ * inherit the suite accent; pass any CSS color (`accent="#1f8a5b"`) and the
+ * rail gradient, tints, stepper, dots, and CTAs all retrack — every shade is
+ * derived in `tokens.css` via color-mix off `--av-accent`. The accent carries
+ * white text (CTAs, monogram) and reads as text on white (logo mark), so a hex
+ * accent under 4.5:1 against white is darkened just enough to reach it.
+ *
+ *   <AgreementViewer
+ *     title="Comprehensive Individual Tax Services"
+ *     firm={{ name: "Patel & Associates CPA", initials: "P&A" }}
+ *     steps={[
+ *       { id: "welcome", label: "Welcome", content: <Welcome /> },
+ *       { id: "package", label: "Select a package", content: <Packages /> },
+ *       …
+ *     ]}
+ *     onDownload={downloadPdf}
+ *   />
+ *
+ * @since 1.12.0
+ */
+type AgreementStatus = "signed" | "awaiting";
+interface AgreementStep {
+    /** Stable key + stepper/dot identity. */
+    id: string;
+    /** Section label shown in the stepper rail. */
+    label: string;
+    /** Node glyph in the stepper; defaults to the step number (or a home glyph
+     * for the cover step). */
+    icon?: ReactNode;
+    /** The step body — consumer-owned. */
+    content: ReactNode;
+    /** Render this step's body full-bleed: the content pane drops its padding so
+     * a cover or hero can reach the card edges. Default false.
+     * @since 1.38.0 */
+    bleed?: boolean;
+}
+interface AgreementFirm {
+    /** Firm name shown on both rails. */
+    name: string;
+    /** Logo monogram (e.g. "P&A"). Falls back to the first letter of `name`. */
+    initials?: string;
+    /** Short line under the firm name on the cover rail. */
+    tagline?: string;
+    /** Subtitle under the firm name on the inner rail. Default "Your proposal". */
+    subtitle?: string;
+    /** Contact rows pinned to the bottom of the cover rail. */
+    contact?: {
+        phone?: ReactNode;
+        email?: ReactNode;
+        website?: ReactNode;
+    };
+}
+interface AgreementViewerProps {
+    /** Header title (the agreement name). */
+    title: ReactNode;
+    /** Small overline above the title. Default "Signed agreement". */
+    overline?: ReactNode;
+    /** Steps rendered as panes; index 0 is the cover. */
+    steps: AgreementStep[];
+    /** Firm branding for the rails. */
+    firm: AgreementFirm;
+    /** "signed" (read-only, all sections complete) or "awaiting" (in progress).
+     * Drives the banner tone + which stepper nodes read as done. Default "signed". */
+    status?: AgreementStatus;
+    /** Banner body override. Omit for the status-derived default; pass `null` to
+     * hide the banner entirely. */
+    banner?: ReactNode;
+    /** Brand accent override — any CSS color. Defaults to the suite accent. A hex
+     * color under 4.5:1 against white is darkened just enough to reach it. */
+    accent?: string;
+    /** Show the gradient firm rail on the cover step. Set false for a full-bleed
+     * cover (e.g. a centered title page). Default true. */
+    coverRail?: boolean | undefined;
+    /** Controlled current step index. */
+    step?: number;
+    /** Initial step when uncontrolled. Default 0. */
+    defaultStep?: number;
+    /** Notified on every step change (controlled or not). */
+    onStepChange?: (step: number) => void;
+    /** "Download PDF" handler — hides the button when omitted. */
+    onDownload?: () => void;
+    /** Close handler — hides the close button when omitted. */
+    onClose?: () => void;
+    /** Extra header actions, placed left of Download / Close. */
+    headerActions?: ReactNode;
+    /** Disable the footer "Next" control — e.g. this step has unmet requirements.
+     * Default false.
+     * @since 1.38.0 */
+    nextDisabled?: boolean;
+    /** Why "Next" is disabled. Kept in a polite live region under the footer and
+     * wired to the Next control with `aria-describedby`; the text only appears
+     * while `nextDisabled` is true.
+     * @since 1.38.0 */
+    nextDisabledReason?: ReactNode;
+    /** Slot under the footer nav row — a validation summary, a secondary CTA, or
+     * a legal note that should sit with the navigation rather than in the step.
+     * @since 1.38.0 */
+    footer?: ReactNode;
+    className?: string;
+}
+declare const AgreementViewer: React$1.ForwardRefExoticComponent<AgreementViewerProps & React$1.RefAttributes<HTMLDivElement>>;
+interface AgreementPaneHeadingProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    /** Accent overline, e.g. "Step 3 of 6". */
+    overline?: ReactNode;
+    /** The pane title. */
+    title: ReactNode;
+    /** Supporting line under the title. */
+    subtitle?: ReactNode;
+}
+declare const AgreementPaneHeading: React$1.ForwardRefExoticComponent<AgreementPaneHeadingProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Proposal pricing building-blocks — the client-preview pieces a signing
+ * package's "Services & Pricing" config renders into. They compose inside an
+ * `AgreementViewer` step (where they inherit the firm `--av-accent`), or
+ * standalone inside a `[data-av-scope]` wrapper. Accent classes carry a suite
+ * fallback so a bare block still renders un-branded rather than transparent.
+ *
+ * - `ProposalServiceRow`    — one line item (name · price · cadence, optional
+ *                             struck-through original for a discount).
+ * - `ProposalPackageCard`   — a package the client chooses; `mode` switches the
+ *                             builder's three choice models (pick-one / add-on /
+ *                             always-included).
+ * - `ProposalPricingSummary`— the "review total" block: what's included, the
+ *                             billing schedule, discount savings, tax, total.
+ *
+ * @since 1.12.0
+ */
+interface ProposalServiceRowProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Service name — the primary line. */
+    name: ReactNode;
+    /** Optional secondary description shown to the client. */
+    description?: ReactNode;
+    /** Formatted price, e.g. "$1,300" or "$50/mo". */
+    price?: ReactNode;
+    /** Pre-discount price, struck through before `price`. */
+    originalPrice?: ReactNode;
+    /** Leading marker. "check" (accent tick) or "none". Default "check". */
+    marker?: "check" | "none";
+}
+declare const ProposalServiceRow: React$1.ForwardRefExoticComponent<ProposalServiceRowProps & React$1.RefAttributes<HTMLDivElement>>;
+type ProposalPackageMode = "choice" | "addon" | "included";
+interface ProposalPackageCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSelect"> {
+    /** Package name. */
+    name: ReactNode;
+    /** Short count line, e.g. "Includes 4 services". */
+    summary?: ReactNode;
+    /** Formatted package price. */
+    price?: ReactNode;
+    /** Caption under the price, e.g. "Package total". */
+    priceCaption?: ReactNode;
+    /** Pre-discount price, struck through. */
+    originalPrice?: ReactNode;
+    /** Savings line, e.g. "You save $200". */
+    savings?: ReactNode;
+    /** How the client chooses this package. Default "choice". */
+    mode?: ProposalPackageMode;
+    /** Selected / added state (drives accent border + control label). */
+    selected?: boolean;
+    /** Corner badge, e.g. "Most popular". A "Selected"/"Added" badge is implied. */
+    badge?: ReactNode;
+    /** Label above the service rows. Default "Included services". */
+    servicesLabel?: ReactNode;
+    /** Service rows (`ProposalServiceRow`) or any content. */
+    children?: ReactNode;
+    /**
+     * Cap the service list's height (any CSS length, e.g. `"14rem"`). Past it the
+     * list scrolls rather than growing, so a package with many services keeps its
+     * select control in view instead of pushing it below the fold — and cards
+     * sitting in a row stay the same height.
+     *
+     * Omit for the previous behaviour: the list grows to fit.
+     */
+    servicesMaxHeight?: string;
+    /** Select / toggle handler — makes the card interactive. */
+    onSelect?: () => void;
+    disabled?: boolean;
+}
+declare const ProposalPackageCard: React$1.ForwardRefExoticComponent<ProposalPackageCardProps & React$1.RefAttributes<HTMLDivElement>>;
+type ProposalBillingMode = "now" | "auto" | "review" | "manual" | "onetime";
+interface ProposalBillingRow {
+    /** e.g. "Due today", "First payment", "Then, monthly", "Each invoice". */
+    label: ReactNode;
+    /** Formatted amount, e.g. "$2,526". */
+    amount?: ReactNode;
+    /** Cadence beside the amount, e.g. "/mo". */
+    cadence?: ReactNode;
+    /** Plain-language explanation of how/when this is charged. */
+    detail: ReactNode;
+    /** Drives the row icon. Default "now". */
+    mode?: ProposalBillingMode;
+}
+interface ProposalBillingTermsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    /** Heading. Default "How billing works". */
+    title?: ReactNode;
+    /** The billing steps the firm configured. */
+    rows: ProposalBillingRow[];
+    /** Show the "set by your firm — review only" footer. Default true. */
+    locked?: boolean;
+}
+/**
+ * ProposalBillingTerms — a read-only explanation of the payment arrangement the
+ * firm configured (auto-pay, charge-after-review, manual invoicing, one-time,
+ * or a mix). The client can see exactly what will be charged and when, but
+ * can't change it — the `locked` footer makes that explicit.
+ */
+declare const ProposalBillingTerms: React$1.ForwardRefExoticComponent<ProposalBillingTermsProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ProposalAddOnProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onToggle" | "name"> {
+    /** Add-on name. */
+    name: ReactNode;
+    /** Short description / cadence note under the name. */
+    description?: ReactNode;
+    /** Formatted price, e.g. "$150" or "$200". */
+    price?: ReactNode;
+    /** Cadence / billing note beside the price, e.g. "/mo" or "One-time". */
+    cadence?: ReactNode;
+    /** Added state. */
+    selected?: boolean;
+    /** Toggle handler. */
+    onToggle?: () => void;
+}
+/**
+ * ProposalAddOn — a compact, checkbox-style toggle for an optional add-on.
+ * Lighter than `ProposalPackageCard`: add-ons are secondary extras, so the
+ * whole row is one toggle (no separate badge + button), price right-aligned.
+ */
+declare const ProposalAddOn: React$1.ForwardRefExoticComponent<ProposalAddOnProps & React$1.RefAttributes<HTMLButtonElement>>;
+interface ProposalPricingSummaryProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** "What's included" rows (`ProposalServiceRow`) — rendered in a 2-col grid. */
+    children?: ReactNode;
+    /** Billing schedule callout. */
+    billing?: {
+        title?: ReactNode;
+        caption?: ReactNode;
+        rows?: {
+            label: ReactNode;
+            value: ReactNode;
+        }[];
+    };
+    /** Discount savings line, e.g. "You save $200 (annual)". */
+    savings?: ReactNode;
+    /** Tax line value, e.g. "$192.00". `taxLabel` defaults to "Tax". */
+    tax?: ReactNode;
+    taxLabel?: ReactNode;
+    /** Pre-discount total, struck through next to `total`. */
+    originalTotal?: ReactNode;
+    /** Total due — used for a single-cadence engagement. Omit when `schedule` is set. */
+    total?: ReactNode;
+    /** Cadence suffix after the total, e.g. "/ year". */
+    cadence?: ReactNode;
+    /** Total row label. Default "Total due". */
+    totalLabel?: ReactNode;
+    /** First-payment + recurring breakdown. Use instead of `total` when billing
+     * mixes cadences (e.g. a yearly package + a monthly add-on): the amount due
+     * at signing reads prominently, with the ongoing charges listed below. */
+    schedule?: {
+        /** Amount charged at signing — the prominent figure. */
+        dueToday: ReactNode;
+        /** Label for the due-now figure. Default "Due today". */
+        dueTodayLabel?: ReactNode;
+        /** Caption under the due-now figure, e.g. "First payment, on acceptance". */
+        dueTodayCaption?: ReactNode;
+        /** Ongoing recurring charges, e.g. [{ label: "Then", amount: "$2,400", cadence: "/ year" }]. */
+        then?: {
+            label?: ReactNode;
+            amount: ReactNode;
+            cadence?: ReactNode;
+        }[];
+    };
+}
+declare const ProposalPricingSummary: React$1.ForwardRefExoticComponent<ProposalPricingSummaryProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Proposal content building-blocks — the optional pieces a signing package's
+ * "custom pages" and recipient config render into on the client preview.
+ *
+ * - `ProposalCustomPage` — a titled custom page; `kind` switches the builder's
+ *                          Video / PDF / Text page types. The body (a video
+ *                          poster, a `PdfPreview`, or rich text) is slotted.
+ * - `ProposalNote`       — a short callout shown alongside the agreement.
+ * - `ProposalSignerList` — the recipients/signers with role + status.
+ *
+ * Accent classes carry a suite fallback, so a bare block renders un-branded
+ * outside an `AgreementViewer` / `[data-av-scope]`.
+ *
+ * @since 1.12.0
+ */
+type ProposalCustomPageKind = "video" | "pdf" | "text";
+interface ProposalCustomPageProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    /** Builder custom-page type. */
+    kind: ProposalCustomPageKind;
+    /** Page title. */
+    title: ReactNode;
+    /** Supporting line under the title. */
+    caption?: ReactNode;
+    /** Overline label; defaults by kind ("Video" / "Document" / "Read"). */
+    label?: ReactNode;
+    /** Poster image for `kind="video"` — shown with a play overlay when no
+     * `children` are supplied. */
+    poster?: string;
+    /** Play handler — makes the video poster an actual button. */
+    onPlay?: () => void;
+    /** Body: a `PdfPreview`, rich text, or a custom embed. Replaces the built-in
+     * video poster when provided. */
+    children?: ReactNode;
+}
+declare const ProposalCustomPage: React$1.ForwardRefExoticComponent<ProposalCustomPageProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ProposalNoteProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    /** Optional bold lead line. */
+    title?: ReactNode;
+    /** Note body. */
+    children: ReactNode;
+    /** Visual tone. Default "accent". */
+    tone?: "accent" | "info";
+    /** Leading icon; defaults to an info glyph. */
+    icon?: ReactNode;
+}
+declare const ProposalNote: React$1.ForwardRefExoticComponent<ProposalNoteProps & React$1.RefAttributes<HTMLDivElement>>;
+type ProposalSignerStatus = "signed" | "pending" | "viewed";
+interface ProposalSigner {
+    name: string;
+    email?: string;
+    /** Role, e.g. "Signer", "Approver", "CC". */
+    role?: string;
+    status?: ProposalSignerStatus;
+    /** Status timestamp for the firm tracking view, e.g. "Signed Jun 6, 2:14 PM". */
+    at?: ReactNode;
+}
+interface ProposalSignerListProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    signers: ProposalSigner[];
+    /** Section label. Default "Recipients". */
+    title?: ReactNode;
+}
+declare const ProposalSignerList: React$1.ForwardRefExoticComponent<ProposalSignerListProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Proposal signing building-blocks — the client-preview pieces for the
+ * agreement's final step.
+ *
+ * - `ProposalSignatureBlock` — the type/draw signature area; `signed` flips it
+ *                              to a read-only signed preview.
+ * - `ProposalConsentGate`    — the "require explicit approval before signing"
+ *                              checkbox that gates the Sign CTA.
+ * - `ProposalPaymentCapture` — the "payment at signing" card/bank capture block.
+ *
+ * Presentational: persistence, signature canvas, and payment tokenization stay
+ * with the consumer. Accent classes carry a suite fallback.
+ *
+ * @since 1.12.0
+ */
+interface ProposalSignatureBlockProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Read-only signed preview — the recorded signer name + initials. */
+    signed?: boolean;
+    /** Recorded signer name (used in the `signed` read-only preview). */
+    name?: string | undefined;
+    /** Recorded initials; defaults to the name's initials. */
+    initials?: string;
+    /** Initial typed name when interactive (defaults to blank — the signer types). */
+    defaultName?: string;
+    /** Reports the typed name + initials as the signer types (interactive). */
+    onChange?: (value: {
+        name: string;
+        initials: string;
+    }) => void;
+    /** Placeholder shown in the signature face + name field when empty. */
+    placeholder?: string;
+    /** CSS font-family for the rendered signature face. Default a serif. */
+    signatureFont?: string;
+    /** Footer slot — typically the Sign CTA or a signed-on note. */
+    footer?: ReactNode;
+    /** Drop the Type / Draw tab strip — for hosts that own the mode switch
+     * themselves, or that only offer one mode. Default false.
+     * @since 1.38.0 */
+    hideModeTabs?: boolean;
+}
+declare const ProposalSignatureBlock: React$1.ForwardRefExoticComponent<ProposalSignatureBlockProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ProposalConsentGateProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Consent label (the explicit-approval statement). */
+    children: ReactNode;
+    /** Checkbox state. */
+    checked?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+    /** Already-signed read-only state — shows the signed note instead of the CTA. */
+    signed?: boolean;
+    /** Note shown when `signed`, e.g. "Signed on June 6, 2026". */
+    signedNote?: ReactNode;
+    /** Sign CTA handler — renders the button (disabled until `checked`). */
+    onSign?: (() => void) | undefined;
+    /** Sign CTA label. Default "Sign & approve". */
+    signLabel?: ReactNode;
+    /** Extra disable condition for the Sign CTA, e.g. a name not yet typed. */
+    disabled?: boolean;
+}
+declare const ProposalConsentGate: React$1.ForwardRefExoticComponent<ProposalConsentGateProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ProposalPaymentCaptureProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    /** Heading. Default "Payment at signing". */
+    title?: ReactNode;
+    /** Amount captured at signing, e.g. "$2,400". */
+    amount?: ReactNode;
+    /** Caption under the title, e.g. "Billed today on acceptance". */
+    caption?: ReactNode;
+    /** Method icon hint. Default "card". */
+    method?: "card" | "bank";
+    /** Saved method last-4 — renders a read-only "•••• 4242" line. */
+    capturedLast4?: string;
+    /** Custom form fields (replaces the placeholder when provided). */
+    children?: ReactNode;
+}
+declare const ProposalPaymentCapture: React$1.ForwardRefExoticComponent<ProposalPaymentCaptureProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * The version of the `QuestionType` contract this build ships (W8-04).
+ *
+ * `QuestionType` is a cross-service contract: TAX's backend persists these
+ * strings and its renderer switches on them, so the union is not free to
+ * change with a component refactor. Adding or removing a member means bumping
+ * this constant, adding a changelog entry below, and publishing the matching
+ * `docs/contracts/question-types.v<version>.json` fixture — the contract test
+ * (`__tests__/question-type-contract.test.ts`) fails otherwise.
+ *
+ * ### Changelog
+ * - **1** (1.38.0) — first versioned snapshot of the union that shipped in
+ *   1.12.0: the 24 members listed in `QUESTION_TYPES`. No change to the types
+ *   themselves; this version records them.
+ *
+ * @experimental The versioning scheme is experimental until D18 (contract
+ * ownership) is decided; the members themselves are stable.
+ */
+declare const QUESTION_TYPE_CONTRACT_VERSION = 1;
+/**
+ * Every `QuestionType`, in contract order — the runtime mirror of the union,
+ * for iterating, validating a payload, or generating a picker.
+ *
+ * @experimental
+ */
+declare const QUESTION_TYPES: readonly ["short-text", "long-text", "email", "phone", "ssn-sin", "date", "number", "currency", "percentage", "single-choice", "multi-choice", "yes-no", "dropdown", "multi-select", "address", "file-upload", "table", "repeater", "signature", "section-header", "consent-checkbox", "name", "labeled-table", "number-stepper"];
+type QuestionType = "short-text" | "long-text" | "email" | "phone" | "ssn-sin" | "date" | "number" | "currency" | "percentage" | "single-choice" | "multi-choice" | "yes-no" | "dropdown" | "multi-select" | "address" | "file-upload" | "table" | "repeater" | "signature" | "section-header" | "consent-checkbox" | "name" | "labeled-table" | "number-stepper";
+interface QuestionOption {
+    value: string;
+    label: string;
+    formLabel?: string;
+    helpText?: string;
+    disabled?: boolean;
+}
+interface QuestionAddressValue {
+    line1?: string;
+    line2?: string;
+    city?: string;
+    region?: string;
+    postalCode?: string;
+    country?: string;
+}
+/** Personal-name payload for the `name` variant. */
+interface QuestionNameValue {
+    first?: string;
+    middle?: string;
+    last?: string;
+    suffix?: string;
+}
+/** Question-level help/tip rendered as a tooltip beside the title. */
+interface QuestionHelp {
+    title?: string;
+    body: string;
+}
+interface QuestionTableColumn {
+    key: string;
+    label: string;
+    placeholder?: string;
+    inputType?: "text" | "number" | "date" | "currency";
+}
+type QuestionTableRow = Record<string, string>;
+/** Column of the fixed `labeled-table` matrix. `width` is a relative grid weight. */
+interface QuestionLabeledColumn {
+    key: string;
+    title: string;
+    width?: number;
+    inputType?: "text" | "number" | "date" | "currency";
+}
+/** Fixed row header (down the left edge) of the `labeled-table` matrix. */
+interface QuestionLabeledRow {
+    key: string;
+    title: string;
+}
+/** Cell text for the `labeled-table` matrix, keyed rowKey → colKey → value. */
+type QuestionLabeledValue = Record<string, Record<string, string>>;
+interface QuestionFileValue {
+    name: string;
+    size?: number;
+    kind?: "doc" | "sheet" | "image" | "generic";
+}
+interface QuestionsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    index?: number;
+    title: string;
+    description?: string | undefined;
+    type?: QuestionType;
+    required?: boolean;
+    chrome?: "card" | "plain";
+    sectionLabel?: string | undefined;
+    hideHeader?: boolean;
+    options?: QuestionOption[];
+    value?: string;
+    values?: string[];
+    placeholder?: string;
+    help?: QuestionHelp;
+    addressValue?: QuestionAddressValue;
+    nameValue?: QuestionNameValue;
+    showSuffix?: boolean;
+    tableColumns?: QuestionTableColumn[];
+    tableRows?: QuestionTableRow[];
+    labeledColumns?: QuestionLabeledColumn[];
+    labeledRows?: QuestionLabeledRow[];
+    labeledValue?: QuestionLabeledValue;
+    files?: QuestionFileValue[];
+    accept?: string;
+    maxSize?: number;
+    multiple?: boolean;
+    currencySymbol?: string;
+    /** Lower bound for `number-stepper`, and for a count-driven `repeater`. */
+    min?: number;
+    /** Upper bound for `number-stepper`, and max item count for a count-driven `repeater`. */
+    max?: number;
+    step?: number;
+    /** When set on a `repeater`, renders a bounded stepper that drives the number of item grids. */
+    countLabel?: string;
+    /**
+     * Noun for each `repeater` entry card header, e.g. `"U.S. presence period"` →
+     * "U.S. presence period 1". Defaults to the generic "Item" when unset.
+     */
+    itemNoun?: string;
+    onValueChange?: (value: string) => void;
+    onValuesChange?: (values: string[]) => void;
+    onAddressChange?: (value: QuestionAddressValue) => void;
+    onNameChange?: (value: QuestionNameValue) => void;
+    onLabeledChange?: (value: QuestionLabeledValue) => void;
+    onTableRowsChange?: (rows: QuestionTableRow[]) => void;
+    onFilesSelected?: (files: File[]) => void;
+    /** When set, each uploaded file chip in the `file-upload` type shows a remove
+     * button that calls this with the file and its index. */
+    onFileRemove?: (file: QuestionFileValue, index: number) => void;
+}
+declare const Questions: React$1.ForwardRefExoticComponent<QuestionsProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Grid — a labeled-rows × typed-columns matrix of editable cells.
+ *
+ * A fixed grid where every row has a header down the left edge and every
+ * column declares the input type its cells accept (text / number / currency
+ * / date). Each cell is an editable input; the whole matrix is a single
+ * controlled value keyed `rowKey → columnKey → string`.
+ *
+ *     ┌───────────────┬──────────┬──────────┬──────────┐
+ *     │               │ Taxpayer │ Spouse   │ Notes    │  ← typed columns
+ *     ├───────────────┼──────────┼──────────┼──────────┤
+ *     │ Wages (W-2)   │ [ $ ___ ]│ [ $ ___ ]│ [ ___ ]  │  ← labeled row
+ *     │ Interest      │ [ $ ___ ]│ [ $ ___ ]│ [ ___ ]  │
+ *     └───────────────┴──────────┴──────────┴──────────┘
+ *
+ * This is the standalone form of the `Questions` `labeled-table` type — that
+ * branch renders a `Grid` internally, so the two share one implementation and
+ * one value contract.
+ *
+ * Fully controlled: pass `columns`, `rows`, `value`, and `onChange`. The
+ * component never holds cell state itself.
+ */
+/** Input type a column's cells accept. Drives keyboard, input mode, and affix. */
+type GridInputType = "text" | "number" | "currency" | "date";
+interface GridColumn {
+    /** Stable key; the second-level key in the value object. */
+    key: string;
+    /** Header text shown above the column. */
+    label: string;
+    /** Cell input type. Defaults to `"text"`. */
+    inputType?: GridInputType | undefined;
+    /** Relative grid weight for this column (a `fr` unit). Defaults to `1`. */
+    width?: number | undefined;
+    /** Placeholder for this column's empty cells. */
+    placeholder?: string;
+}
+interface GridRow {
+    /** Stable key; the first-level key in the value object. */
+    key: string;
+    /** Row header text shown down the left edge. */
+    label: string;
+}
+/** Cell values, keyed `rowKey → columnKey → value`. */
+type GridValue = Record<string, Record<string, string>>;
+interface GridProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Typed columns, left-to-right. */
+    columns: GridColumn[];
+    /** Labeled rows, top-to-bottom. */
+    rows: GridRow[];
+    /** Controlled cell values (`rowKey → columnKey → value`). */
+    value: GridValue;
+    /** Called with the full next value object whenever any cell changes. */
+    onChange: (value: GridValue) => void;
+    /** Accessible name for the matrix (also prefixes each cell's aria-label). */
+    ariaLabel?: string;
+    /** Header text for the top-left corner cell (above the row headers). */
+    rowHeaderLabel?: string;
+    /** Prefix shown inside `currency` cells. Defaults to `"$"`. */
+    currencySymbol?: string;
+    /** Minimum matrix width in px before it scrolls horizontally. Defaults to `560`. */
+    minWidth?: number;
+    /** Disable every cell. */
+    disabled?: boolean;
+}
+declare const Grid: React$1.ForwardRefExoticComponent<GridProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface SidebarBrandSwitcherItem {
+    /** Stable id used as React key and for `data-item` on each row. */
+    id: string;
+    /** Primary display name, e.g. "Assure Audit". */
+    name: string;
+    /** Sub-line under the name, e.g. "Audit fieldwork". */
+    tagline?: string;
+    /**
+     * Short label rendered inside the default tile glyph (first character
+     * is used, à la "A" for "Audit"). Ignored when `glyph` is supplied.
+     */
+    short?: string;
+    /**
+     * Accent for the default tile background. A Tailwind class string
+     * (e.g. `"bg-[#5b3bc4]"`) — the consumer owns brand color values, the
+     * DS just composes them. Ignored when `glyph` is supplied.
+     */
+    tone?: string;
+    /**
+     * Pre-rendered tile glyph. When provided, replaces the default
+     * "first letter on `tone` swatch" tile entirely. Use for items that
+     * have a real mark instead of a letter.
+     */
+    glyph?: React$1.ReactNode;
+    /**
+     * Full-width identity node rendered in place of the tile + `name`
+     * — e.g. a product wordmark lockup (`<Logo href={null} …>`). When present
+     * the row omits the tile and the `name` text; `tagline` still renders
+     * beneath it. When absent the row falls back to tile + `name`.
+     *
+     * Framework-neutral like the rest of this composite: pass whatever element
+     * your stack renders (a DS `Logo`, a plain `<img>`, an inline SVG). The DS
+     * does not bind to it.
+     */
+    identity?: React$1.ReactNode;
+    /**
+     * False marks the item as not-yet-available; rendered disabled with
+     * a "Soon" badge by default (override via `unavailableBadge`).
+     */
+    available?: boolean;
+    /** Pass-through onto the row's `data-item` for analytics / e2e hooks. */
+    dataAttr?: string;
+}
+/**
+ * An external launcher row appended after the "Switch to" list — a non-suite
+ * entry with no availability / "Soon" semantics (e.g. a partner product reached
+ * by its own autologin URL rather than the suite's switch model). Vendor color
+ * lives in the consumer-owned `glyph`, keeping brand hex out of the DS.
+ */
+interface SidebarBrandSwitcherExtra {
+    /** Stable id — React key and default `data-item`. */
+    id: string;
+    /** Left glyph (a consumer-owned mark/tile). Vendor color belongs here. */
+    glyph?: React$1.ReactNode;
+    /**
+     * Full-width identity node rendered in place of the `glyph` + `name` — e.g. a
+     * product wordmark lockup (`<Logo href={null} …>`) — mirroring
+     * `SidebarBrandSwitcherItem.identity`. Use it so an external launcher row
+     * reads at the same size and on the same line as the suite product rows.
+     * When present, `tagline` still renders beneath it and `glyph`/`name` are
+     * omitted. Consumer-owned and framework-neutral like the rest of this slot.
+     */
+    identity?: React$1.ReactNode;
+    /** Primary display name, e.g. "myCPE One". */
+    name: React$1.ReactNode;
+    /** Sub-line under the name. */
+    tagline?: React$1.ReactNode;
+    /** Invoked when the row is selected. The DS holds no opinion on what it does. */
+    onSelect: () => void;
+    /** Pass-through onto the row's `data-item` for analytics / e2e hooks. */
+    dataAttr?: string;
+}
+interface SidebarBrandSwitcherProps {
+    /**
+     * Brand glyph rendered at the left edge of the trigger (e.g. an
+     * `<img>` of the product mark). Consumer-supplied so the DS does
+     * not bind to a framework-specific image element.
+     */
+    brand?: React$1.ReactNode;
+    /** Wordmark / label rendered next to the brand glyph in the trigger. */
+    label: React$1.ReactNode;
+    /**
+     * The currently-active item. Pinned at the top of the menu and
+     * excluded from the "Switch to" list automatically.
+     */
+    current: SidebarBrandSwitcherItem;
+    /**
+     * Full item list including `current`. Order is preserved in the
+     * "Switch to" section; the current entry is filtered out.
+     */
+    items: SidebarBrandSwitcherItem[];
+    /**
+     * Called when a non-current, available item is selected. Receives the
+     * full item so consumers can route, open a new window, or trigger an
+     * SSO handoff — the DS holds no opinion on what "switch" means.
+     */
+    onLaunch?: (item: SidebarBrandSwitcherItem) => void | Promise<void>;
+    /**
+     * External launcher rows appended after the "Switch to" list — non-suite
+     * entries with no availability / "Soon" semantics. Each renders a consumer
+     * `glyph` + name + tagline and calls its own `onSelect`.
+     */
+    extras?: SidebarBrandSwitcherExtra[];
+    /**
+     * Optional predicate reporting whether an item is mid-launch from an
+     * external source (e.g. a suite-focus provider that drives the launch itself).
+     * ORed with the row's internal launching state to show the "Opening…" badge
+     * and to guard against a double launch. Absent → only internal state applies.
+     */
+    isLaunching?: (item: SidebarBrandSwitcherItem) => boolean;
+    /** Label above the current row. Defaults to "Currently using". */
+    currentSectionLabel?: React$1.ReactNode;
+    /** Label above the others list. Defaults to "Switch to". */
+    switchSectionLabel?: React$1.ReactNode;
+    /** Label at the very top of the menu. Defaults to "Suite". */
+    menuLabel?: React$1.ReactNode;
+    /** Badge text next to the current item. Defaults to "Current". */
+    currentBadge?: React$1.ReactNode;
+    /** Badge text on unavailable items. Defaults to "Soon". */
+    unavailableBadge?: React$1.ReactNode;
+    /** Accessible label on the trigger button. Defaults to "Switch product". */
+    triggerLabel?: string;
+    /** Extra classes applied to the outer brand-row wrapper. */
+    className?: string;
+    /** Extra classes applied to the trigger button. */
+    triggerClassName?: string;
+    /** Extra classes applied to the dropdown content panel. */
+    contentClassName?: string;
+    /**
+     * Extra classes applied to the current row, each "Switch to" product row, and
+     * each `extras` launcher row. Lets a consumer reproduce bespoke row
+     * padding/height via tailwind-merge without the DS owning that geometry, and
+     * keeps launcher rows aligned with the product rows.
+     */
+    rowClassName?: string;
+    /**
+     * Slot rendered to the right of the trigger inside the brand row.
+     * Typical use: drop a `<SidebarPinButton/>` here.
+     */
+    trailing?: React$1.ReactNode;
+}
+declare const SidebarBrandSwitcher: React$1.ForwardRefExoticComponent<SidebarBrandSwitcherProps & React$1.RefAttributes<HTMLDivElement>>;
+interface SidebarBrandSwitcherTileProps {
+    item: SidebarBrandSwitcherItem;
+}
+declare function SidebarBrandSwitcherTile({ item }: SidebarBrandSwitcherTileProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * DocumentDetailPanel — the right-hand inspector for a document request
+ * (the "FY2025 PBC — Receivables & Fixed Assets" panel). Presentational
+ * compound: the app owns data, tab state, and every action handler;
+ * compose only the rows a surface needs.
+ *
+ *   <DocumentDetailPanel>
+ *     <DocumentDetailHeader
+ *       status={<Badge variant="success">Provided</Badge>}
+ *       tags={<>…</>}
+ *       onClose={close}
+ *     >
+ *       <DocumentDetailTitle>FY2025 PBC — Receivables & Fixed Assets</DocumentDetailTitle>
+ *       <DocumentDetailRequester
+ *         org="Acme Manufacturing LLC" avatar="AM"
+ *         requestedBy="Maya Auditor" time="5d ago"
+ *       />
+ *       <DocumentDetailMetaRow>…due chip…2 assigned…</DocumentDetailMetaRow>
+ *       <DocumentDetailActions>…Edit / Lock / Status / Delete…</DocumentDetailActions>
+ *     </DocumentDetailHeader>
+ *     <DocumentDetailBody>
+ *       <Tabs>…</Tabs>
+ *       <DocumentList>
+ *         <DocumentListSection label="Client uploads" count={2}>
+ *           <DocumentRow fileName="…" meta="…" actions={<…/>} />
+ *         </DocumentListSection>
+ *       </DocumentList>
+ *     </DocumentDetailBody>
+ *   </DocumentDetailPanel>
+ *
+ * Tabs (Documents / Comments / Activity) use the `Tabs` primitive — this
+ * composite doesn't reinvent them. Status / priority chips are `Badge`s.
+ */
+type DocumentDetailPanelProps = React.HTMLAttributes<HTMLElement>;
+declare const DocumentDetailPanel: React$1.ForwardRefExoticComponent<DocumentDetailPanelProps & React$1.RefAttributes<HTMLElement>>;
+interface DocumentDetailHeaderProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    /** Leading chips — folder, priority, classification (left of the bar). */
+    tags?: React.ReactNode;
+    /** Status pill, right-aligned (e.g. a "Provided" success Badge). */
+    status?: React.ReactNode;
+    onClose?: (() => void) | undefined;
+}
+declare const DocumentDetailHeader: React$1.ForwardRefExoticComponent<DocumentDetailHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+type DocumentDetailTitleProps = React.HTMLAttributes<HTMLHeadingElement>;
+declare const DocumentDetailTitle: React$1.ForwardRefExoticComponent<DocumentDetailTitleProps & React$1.RefAttributes<HTMLHeadingElement>>;
+interface DocumentDetailRequesterProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Image src, or initials/name passed through to <Avatar>. */
+    avatar: string;
+    /** Client / organisation name — the primary line. */
+    org: string;
+    /** Who requested the document. */
+    requestedBy: string;
+    /** Relative time, e.g. "5d ago". */
+    time: string;
+}
+declare const DocumentDetailRequester: React$1.ForwardRefExoticComponent<DocumentDetailRequesterProps & React$1.RefAttributes<HTMLDivElement>>;
+type DocumentDetailMetaRowProps = React.HTMLAttributes<HTMLDivElement>;
+declare const DocumentDetailMetaRow: React$1.ForwardRefExoticComponent<DocumentDetailMetaRowProps & React$1.RefAttributes<HTMLDivElement>>;
+type DocumentDetailActionsProps = React.HTMLAttributes<HTMLDivElement>;
+declare const DocumentDetailActions: React$1.ForwardRefExoticComponent<DocumentDetailActionsProps & React$1.RefAttributes<HTMLDivElement>>;
+type DocumentDetailBodyProps = React.HTMLAttributes<HTMLDivElement>;
+declare const DocumentDetailBody: React$1.ForwardRefExoticComponent<DocumentDetailBodyProps & React$1.RefAttributes<HTMLDivElement>>;
+type DocumentListProps = React.HTMLAttributes<HTMLDivElement>;
+declare const DocumentList: React$1.ForwardRefExoticComponent<DocumentListProps & React$1.RefAttributes<HTMLDivElement>>;
+interface DocumentListSectionProps extends React.HTMLAttributes<HTMLElement> {
+    /** Section label, e.g. "Client uploads". */
+    label: React.ReactNode;
+    /** Count shown next to the label. */
+    count?: number;
+    /** Trailing slot, right-aligned (e.g. an "Upload" button). */
+    action?: React.ReactNode;
+}
+declare const DocumentListSection: React$1.ForwardRefExoticComponent<DocumentListSectionProps & React$1.RefAttributes<HTMLElement>>;
+interface DocumentRowProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    /** File name — the row's primary line. */
+    fileName: string;
+    /** Secondary line, e.g. "320 KB · Jun 11, 2026 · Acme Manufacturing". */
+    meta?: React.ReactNode | undefined;
+    /** Leading file-type icon; defaults to a neutral document glyph. */
+    icon?: React.ReactNode | undefined;
+    /** Render the row in its approved state — a green file-icon chip plus an
+     *  "Approved" tag after the file name. */
+    approved?: boolean | undefined;
+    /** Render the row in its rejected state — a red file-icon chip plus a
+     *  "Rejected" tag after the file name. Ignored when `approved` is set. */
+    rejected?: boolean | undefined;
+    /** Trailing action controls (Extract / preview / download / delete). */
+    actions?: React.ReactNode | undefined;
+}
+declare const DocumentRow: React$1.ForwardRefExoticComponent<DocumentRowProps & React$1.RefAttributes<HTMLDivElement>>;
+
+export { type AgreementFirm, AgreementPaneHeading, type AgreementPaneHeadingProps, type AgreementStatus, type AgreementStep, AgreementViewer, type AgreementViewerProps, AssureAuditBrandIcon, AssureBooksBrandIcon, AssureProBrandIcon, AssureTaxBrandIcon, type BrandIconProps, ClientSelect, type ClientSelectOption, ComingSoon, type ComingSoonProps, DocumentDetailActions, type DocumentDetailActionsProps, DocumentDetailBody, type DocumentDetailBodyProps, DocumentDetailHeader, type DocumentDetailHeaderProps, DocumentDetailMetaRow, type DocumentDetailMetaRowProps, DocumentDetailPanel, type DocumentDetailPanelProps, DocumentDetailRequester, type DocumentDetailRequesterProps, DocumentDetailTitle, type DocumentDetailTitleProps, DocumentList, type DocumentListProps, DocumentListSection, type DocumentListSectionProps, DocumentRow, type DocumentRowProps, Grid, type GridColumn, type GridInputType, type GridProps, type GridRow, type GridValue, Logo, ProposalAddOn, type ProposalAddOnProps, type ProposalBillingMode, type ProposalBillingRow, ProposalBillingTerms, type ProposalBillingTermsProps, ProposalConsentGate, type ProposalConsentGateProps, ProposalCustomPage, type ProposalCustomPageKind, type ProposalCustomPageProps, ProposalNote, type ProposalNoteProps, ProposalPackageCard, type ProposalPackageCardProps, type ProposalPackageMode, ProposalPaymentCapture, type ProposalPaymentCaptureProps, ProposalPricingSummary, type ProposalPricingSummaryProps, ProposalServiceRow, type ProposalServiceRowProps, ProposalSignatureBlock, type ProposalSignatureBlockProps, type ProposalSigner, ProposalSignerList, type ProposalSignerListProps, type ProposalSignerStatus, QUESTION_TYPES, QUESTION_TYPE_CONTRACT_VERSION, type QuestionAddressValue, type QuestionFileValue, type QuestionHelp, type QuestionLabeledColumn, type QuestionLabeledRow, type QuestionLabeledValue, type QuestionNameValue, type QuestionOption, type QuestionTableColumn, type QuestionTableRow, type QuestionType, Questions, type QuestionsProps, SidebarBrandSwitcher, type SidebarBrandSwitcherExtra, type SidebarBrandSwitcherItem, type SidebarBrandSwitcherProps, SidebarBrandSwitcherTile };