@fairmint/ui 0.2.25 → 0.2.27

package/dist/components/generic/ConfidentialityBanner/ConfidentialityBanner.d.ts

@@ -0,0 +1,26 @@
+import { ReactNode } from 'react';
+export interface ConfidentialityBannerProps {
+    /**
+     * Banner message. Typically a one-line legal / policy notice that
+     * the viewer must see before interacting with the page.
+     */
+    children: ReactNode;
+    /**
+     * Icon rendered to the left of the message. Defaults to a lock glyph.
+     * Pass `null` to omit the icon entirely.
+     */
+    icon?: ReactNode;
+}
+/**
+ * Thin gradient ribbon used at the very top of confidential / gated
+ * pages (e.g., offering pages, board-pack distributions). Sits above
+ * the page's regular sticky header so the disclaimer is the first
+ * thing the viewer sees.
+ *
+ * Visual treatment is the Fairmint indigo→purple gradient at 8%
+ * opacity, with a 1px bottom border and a center-aligned message. The
+ * lock glyph signals "private, do not share" without leaning on
+ * heavy "WARNING" framing.
+ */
+export declare function ConfidentialityBanner({ children, icon }: ConfidentialityBannerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ConfidentialityBanner.d.ts.map

package/dist/components/generic/ConfidentialityBanner/ConfidentialityBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfidentialityBanner.d.ts","sourceRoot":"","sources":["../../../../src/components/generic/ConfidentialityBanner/ConfidentialityBanner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAsBvC,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,0BAA0B,2CAuBnF"}

package/dist/components/generic/DataRow/DataRow.d.ts

@@ -0,0 +1,51 @@
+import { ReactNode } from 'react';
+export interface DataRowProps {
+    /** Left-aligned label. */
+    label: string;
+    /**
+     * Right-aligned value.
+     *
+     *   - `string`     — rendered as styled `Text` (accent-aware).
+     *   - `ReactNode`  — rendered as-is. Pass `<StackedValue values={...}/>`
+     *     for a vertical list, or any other JSX (badges, icons, links).
+     *   - `null`       — renders a `<RedactedValue>` placeholder. No real
+     *     value lives in the DOM, so a pre-auth dev-tools inspection
+     *     reveals nothing.
+     */
+    value: ReactNode | null;
+    /**
+     * When true, a string `value` renders in success-green bold weight.
+     * Use for highlighted rows like fees, carry, or "yes" answers.
+     */
+    accent?: boolean;
+}
+/**
+ * One label / value row used by terms panels, profile sections, and
+ * any "definition list" UX.
+ *
+ * The `null` → redacted placeholder convention is a security primitive:
+ * when content is behind a gate, pass `null` and the placeholder shows
+ * a dotted strip without leaking the real value into the DOM.
+ */
+export declare function DataRow({ label, value, accent }: DataRowProps): import("react/jsx-runtime").JSX.Element;
+export interface StackedValueProps {
+    /** List of strings to render as a vertical, right-aligned stack. */
+    values: ReadonlyArray<string>;
+}
+/**
+ * Right-aligned vertical stack of values. Compose with `DataRow`
+ * when a single label has multiple values (e.g., "Funding: USDC / USDT
+ * / Wire" rendered as three lines stacked under the "Funding" label).
+ */
+export declare function StackedValue({ values }: StackedValueProps): import("react/jsx-runtime").JSX.Element;
+export interface RedactedValueProps {
+    /** Width of the placeholder strip in pixels. @default 80 */
+    width?: number;
+}
+/**
+ * Source-safe placeholder — a fixed-width dotted strip rendered when
+ * a value is gated. No real value lives in the DOM, so a pre-auth
+ * dev-tools inspection reveals nothing.
+ */
+export declare function RedactedValue({ width }?: RedactedValueProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DataRow.d.ts.map

package/dist/components/generic/DataRow/DataRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataRow.d.ts","sourceRoot":"","sources":["../../../../src/components/generic/DataRow/DataRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;;OASG;IACH,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE,YAAY,2CAuBrE;AAED,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,iBAAiB,2CAUzD;AAED,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,KAAU,EAAE,GAAE,kBAAuB,2CAapE"}

package/dist/components/generic/Eyebrow/Eyebrow.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode } from 'react';
+import { TextProps } from '../../primitives/layout';
+export interface EyebrowProps extends Omit<TextProps, "children" | "size" | "fw" | "tt" | "c"> {
+    /** Eyebrow text content. */
+    children: ReactNode;
+    /** Eyebrow size. Defaults to `xs`. */
+    size?: "xs" | "sm";
+    /**
+     * Text color. Defaults to `neutralColors[500]`. Override when the
+     * eyebrow sits on a dark background or needs to match an accent.
+     */
+    c?: string;
+}
+/**
+ * Small uppercase letter-spaced label used above titles, in card
+ * headers, and as section eyebrows throughout the Fairmint apps.
+ *
+ * Standardizes the `Text size="xs" tt="uppercase" fw={700}
+ * c={neutralColors[500]} style={{ letterSpacing: "0.08em" }}`
+ * incantation that was scattered across screens.
+ */
+export declare function Eyebrow({ children, size, c, ...rest }: EyebrowProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Eyebrow.d.ts.map

package/dist/components/generic/Eyebrow/Eyebrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Eyebrow.d.ts","sourceRoot":"","sources":["../../../../src/components/generic/Eyebrow/Eyebrow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,CAAC;IAC5F,4BAA4B;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,sCAAsC;IACtC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB;;;OAGG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAW,EAAE,CAAsB,EAAE,GAAG,IAAI,EAAE,EAAE,YAAY,2CAM/F"}

package/dist/components/generic/RadioCard/RadioCard.d.ts

@@ -0,0 +1,26 @@
+import { ReactNode } from 'react';
+export interface RadioCardProps {
+    /** Whether this card is currently selected. */
+    selected: boolean;
+    /** Primary label (top-left). */
+    title: ReactNode;
+    /** Supporting description below the title. */
+    description?: ReactNode;
+    /** Optional pill / chip rendered next to the title (top-right). */
+    badge?: ReactNode;
+    /** Optional leading slot (icon / small avatar / number badge). */
+    leading?: ReactNode;
+    /** Triggered when the card is clicked. */
+    onSelect: () => void;
+}
+/**
+ * Selectable card with a title + description and a radio dot affordance.
+ *
+ * Used for any "pick one from a few" UX: funding methods, accreditation
+ * categories, tax classifications, plan tiers, etc. The visual treatment
+ * (indigo border + tinted background when active, radio dot on the
+ * right) is the standard Fairmint pattern so users learn it once and
+ * apply it everywhere.
+ */
+export declare function RadioCard({ selected, title, description, badge, leading, onSelect, }: RadioCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=RadioCard.d.ts.map

package/dist/components/generic/RadioCard/RadioCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RadioCard.d.ts","sourceRoot":"","sources":["../../../../src/components/generic/RadioCard/RadioCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,mEAAmE;IACnE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kEAAkE;IAClE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,KAAK,EACL,WAAW,EACX,KAAK,EACL,OAAO,EACP,QAAQ,GACT,EAAE,cAAc,2CAiEhB"}

package/dist/components/generic/StepCard/StepCard.d.ts

@@ -0,0 +1,32 @@
+import { ReactNode } from 'react';
+export interface StepCardProps {
+    /** 1-indexed step number shown in the indicator when not done. */
+    index: number;
+    /** Step title. */
+    title: string;
+    /** Optional supporting text below the title. */
+    description?: string;
+    /** When true, the indicator flips from the number to a check glyph. */
+    done?: boolean;
+    /**
+     * Override the icon shown when `done === true`. Defaults to a check
+     * mark inside a circle. Accept-as-ReactNode so consumers don't need
+     * to import an icon library.
+     */
+    doneIcon?: ReactNode;
+    /** Step content rendered below the header. */
+    children: ReactNode;
+}
+/**
+ * Numbered step card used in multi-section wizards and form flows.
+ *
+ * The numbered indicator on the left flips to a check when the step is
+ * marked done — a quiet progress signal that doesn't compete with the
+ * right-column summary or page-level progress UI. Each step sits in
+ * its own `Paper` for clear visual separation.
+ *
+ * The header indicator is the focal point; consumers control the body
+ * via `children`.
+ */
+export declare function StepCard({ index, title, description, done, doneIcon, children, }: StepCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=StepCard.d.ts.map

package/dist/components/generic/StepCard/StepCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepCard.d.ts","sourceRoot":"","sources":["../../../../src/components/generic/StepCard/StepCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAsBvC,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,WAAW,EACX,IAAY,EACZ,QAAQ,EACR,QAAQ,GACT,EAAE,aAAa,2CA8Cf"}

package/dist/components/primitives/Drawer/Drawer.d.ts

@@ -1,5 +1,5 @@
 import { DrawerProps as MantineDrawerProps } from '@mantine/core';
 export interface DrawerProps extends MantineDrawerProps {
 }
-export declare function Drawer(props: DrawerProps): import("react/jsx-runtime").JSX.Element;
+export declare function Drawer({ zIndex, ...props }: DrawerProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Drawer.d.ts.map

package/dist/components/primitives/Drawer/Drawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Drawer.d.ts","sourceRoot":"","sources":["../../../../src/components/primitives/Drawer/Drawer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,WAAW,IAAI,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEhG,MAAM,WAAW,WAAY,SAAQ,kBAAkB;CAAG;AAE1D,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,2CAExC"}
+{"version":3,"file":"Drawer.d.ts","sourceRoot":"","sources":["../../../../src/components/primitives/Drawer/Drawer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,WAAW,IAAI,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIhG,MAAM,WAAW,WAAY,SAAQ,kBAAkB;CAAG;AAE1D,wBAAgB,MAAM,CAAC,EAAE,MAAsC,EAAE,GAAG,KAAK,EAAE,EAAE,WAAW,2CAEvF"}

package/dist/components/primitives/Modal/Modal.d.ts

@@ -1,5 +1,5 @@
 import { ModalProps as MantineModalProps } from '@mantine/core';
 export interface ModalProps extends MantineModalProps {
 }
-export declare function Modal(props: ModalProps): import("react/jsx-runtime").JSX.Element;
+export declare function Modal({ zIndex, ...props }: ModalProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Modal.d.ts.map

package/dist/components/primitives/Modal/Modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../../src/components/primitives/Modal/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,UAAU,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5F,MAAM,WAAW,UAAW,SAAQ,iBAAiB;CAAG;AAExD,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,2CAEtC"}
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../../src/components/primitives/Modal/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,UAAU,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAI5F,MAAM,WAAW,UAAW,SAAQ,iBAAiB;CAAG;AAExD,wBAAgB,KAAK,CAAC,EAAE,MAAsC,EAAE,GAAG,KAAK,EAAE,EAAE,UAAU,2CAErF"}

package/dist/components/specific/DocumentRow/DocumentRow.d.ts

@@ -1,17 +1,59 @@
 import { ReactNode } from 'react';
 export interface DocumentRowProps {
-    /** Document name. */
+    /** Primary title — usually the file or agreement name. */
     name: string;
-    /** Document type label (e.g., "Agreement", "Tax Form"). */
+    /**
+     * Description below the title. Accepts a `ReactNode` so consumers can mix
+     * Badges, Text, dates, and inline metadata (companyName, seriesName, etc.)
+     * without working around a single-string subtitle slot.
+     */
+    caption?: ReactNode;
+    /**
+     * @deprecated Use `caption` directly. When `caption` is omitted and
+     * `type` and/or `date` is supplied, they are joined with " · " to
+     * produce a string caption. Preserved for backwards compatibility
+     * with the previous, ListRow-backed API.
+     */
     type?: string;
-    /** Date the document was created or signed (ISO string). */
+    /**
+     * @deprecated Use `caption` directly. The date is now consumer-
+     * formatted; pass a formatted string via `caption` instead. Preserved
+     * for backwards compatibility.
+     */
     date?: string;
-    /** Right section actions (e.g., download button). */
+    /**
+     * Leading visual — defaults to a tinted file-icon `ThemeIcon`. Pass a
+     * custom node (an icon, a badge, a small Avatar, etc.) when you want
+     * a different leading affordance.
+     */
+    icon?: ReactNode;
+    /** Right-side content — download button, lock badge, preview link, etc. */
     rightSection?: ReactNode;
-    /** Click handler — opens document viewer. */
+    /**
+     * Drill-in chevron. Defaults to `false` — the right-side glyph (a
+     * download icon, a preview link, a status badge) usually conveys the
+     * affordance and the chevron is visual noise. Set to `true` for "row
+     * that opens a detail view" patterns.
+     */
+    showChevron?: boolean;
+    /** Click handler. */
     onClick?: () => void;
-    /** Entrance animation delay in seconds. */
+    /** Entrance animation delay in seconds. Omit to skip animation. */
     animationDelay?: number;
+    /** aria-label for the clickable wrapper. Defaults to `name`. */
+    ariaLabel?: string;
 }
-export declare function DocumentRow({ name, type, date, rightSection, onClick, animationDelay, }: DocumentRowProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Document list item — title, free-form caption, optional leading icon,
+ * optional right-side affordance, optional drill-in chevron.
+ *
+ * Designed against three real consumers (investorv2's `OpportunityDocuments`,
+ * `SignSection` legal-doc list, and the mobile card view on `/documents`)
+ * so the shape covers the actual patterns rather than an imagined one.
+ *
+ * Backwards-compat note: the previous `type` + `date` API still works.
+ * When `caption` is omitted, the legacy props are joined with " · " into
+ * a string caption.
+ */
+export declare function DocumentRow({ name, caption, type, date, icon, rightSection, onClick, showChevron, animationDelay, ariaLabel, }: DocumentRowProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=DocumentRow.d.ts.map

package/dist/components/specific/DocumentRow/DocumentRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentRow.d.ts","sourceRoot":"","sources":["../../../../src/components/specific/DocumentRow/DocumentRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,YAAY,EACZ,OAAO,EACP,cAAc,GACf,EAAE,gBAAgB,2CAelB"}
+{"version":3,"file":"DocumentRow.d.ts","sourceRoot":"","sources":["../../../../src/components/specific/DocumentRow/DocumentRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAgDvC,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,YAAY,EACZ,OAAO,EACP,WAAmB,EACnB,cAAc,EACd,SAAS,GACV,EAAE,gBAAgB,2CAyElB"}