themelia-react-ui 0.0.0-stage → 1.0.0

package/dist/components/blocks/data-display/empty-state/partials/illustrations/inbox-clean.d.ts

@@ -0,0 +1,9 @@
+import type { EmptyStateIllustrationProps } from './types';
+/**
+ * Open inbox tray with a soft check above — for "all caught up",
+ * "no notifications", "inbox zero" surfaces.
+ */
+export declare function InboxCleanIllustration({ className }: EmptyStateIllustrationProps): import("react").JSX.Element;
+export declare namespace InboxCleanIllustration {
+    var displayName: string;
+}

package/dist/components/blocks/data-display/empty-state/partials/illustrations/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Token-driven illustrations for `<EmptyState>`.
+ *
+ * Each illustration is a small composition of `bg-muted` /
+ * `bg-background` / `border-border` divs (no raw palette colors), so it
+ * adapts to the consumer's theme automatically. Use as the `media`
+ * prop of `<EmptyState>` — pick one per resource:
+ *
+ *     <EmptyState
+ *         media={<StackedCardsIllustration />}
+ *         title="No products yet"
+ *         description="Add your first product to start selling."
+ *         actions={<Button>Add product</Button>}
+ *     />
+ *
+ * Add new illustrations by dropping a new file in this folder and
+ * re-exporting it here. Keep them framework-agnostic and
+ * token-driven — never reach for raw color literals.
+ */
+export { DocumentStackIllustration } from './document-stack';
+export { InboxCleanIllustration } from './inbox-clean';
+export { SearchGlassIllustration } from './search-glass';
+export { StackedCardsIllustration } from './stacked-cards';
+export { UsersCircleIllustration } from './users-circle';
+export type { EmptyStateIllustrationProps } from './types';

package/dist/components/blocks/data-display/empty-state/partials/illustrations/search-glass.d.ts

@@ -0,0 +1,9 @@
+import type { EmptyStateIllustrationProps } from './types';
+/**
+ * Magnifying-glass illustration centered on a soft tinted disk — for
+ * "no search results", "nothing matches your filters" surfaces.
+ */
+export declare function SearchGlassIllustration({ className }: EmptyStateIllustrationProps): import("react").JSX.Element;
+export declare namespace SearchGlassIllustration {
+    var displayName: string;
+}

package/dist/components/blocks/data-display/empty-state/partials/illustrations/stacked-cards.d.ts

@@ -0,0 +1,11 @@
+import type { EmptyStateIllustrationProps } from './types';
+/**
+ * Three stacked card silhouettes with a fade-out at the bottom — the
+ * generic "no records" illustration. Token-driven so it adapts to any
+ * theme (uses `bg-muted`, `bg-background`, `border-border`, no raw
+ * palette).
+ */
+export declare function StackedCardsIllustration({ className }: EmptyStateIllustrationProps): import("react").JSX.Element;
+export declare namespace StackedCardsIllustration {
+    var displayName: string;
+}

package/dist/components/blocks/data-display/empty-state/partials/illustrations/types.d.ts

@@ -0,0 +1,4 @@
+export interface EmptyStateIllustrationProps {
+    /** Merged onto the outermost node. */
+    className?: string;
+}

package/dist/components/blocks/data-display/empty-state/partials/illustrations/users-circle.d.ts

@@ -0,0 +1,9 @@
+import type { EmptyStateIllustrationProps } from './types';
+/**
+ * Three overlapping avatar circles — for "no team members", "no
+ * customers", "no contributors" surfaces.
+ */
+export declare function UsersCircleIllustration({ className }: EmptyStateIllustrationProps): import("react").JSX.Element;
+export declare namespace UsersCircleIllustration {
+    var displayName: string;
+}

package/dist/components/blocks/data-display/index.d.ts

@@ -0,0 +1,6 @@
+export type { DenseInfoBadgeTone, DashboardStatusBadge, DashboardKeyValueRow, DenseInfoDashboardProps, ClassificationStat, ClassificationRow, DenseInfoClassificationProps, FinancialHeaderBadge, FinancialLineItem, DenseInfoFinancialProps, ProjectMetaPair, DenseInfoProjectCardProps, ScoreKeyValueRow, DenseInfoScoreCardProps, DenseInfoStrings, } from './dense-info-card';
+export { defaultDenseInfoStrings, DenseInfoDashboard, DenseInfoClassification, DenseInfoFinancial, DenseInfoProjectCard, DenseInfoScoreCard, } from './dense-info-card';
+export * from './empty-state';
+export * from './metadata';
+export { RelationshipCardFrame, type RelationshipCardFrameProps, } from './relationship-card-frame';
+export * from './inline-stat';

package/dist/components/blocks/data-display/inline-stat/index.d.ts

@@ -0,0 +1 @@
+export { InlineStat, type InlineStatProps, type InlineStatLayout } from './inline-stat';

package/dist/components/blocks/data-display/inline-stat/inline-stat.d.ts

@@ -0,0 +1,35 @@
+/**
+ * InlineStat — label + value pair, the workhorse of detail panels and card
+ * footers. Three layouts:
+ *
+ *  - `between` (default): label and value pushed to opposite ends of the row.
+ *  - `inline`: label sits immediately before the value, separator-style.
+ *  - `stacked`: label above (xs secondary), value below (md).
+ *
+ * `mono` toggles `tabular-nums` on the value side for amounts and counters.
+ * Use `valueClassName` for one-off colour/weight overrides; the surrounding
+ * row is intentionally plain so consumers can stack many of these without
+ * visual clutter.
+ */
+import type { ReactNode } from 'react';
+export type InlineStatLayout = 'between' | 'inline' | 'stacked';
+export interface InlineStatProps {
+    /** Display label. Scalar labels use DisplayLabel; rich content owns its typography. */
+    label: ReactNode;
+    /** The figure to show. */
+    value: ReactNode;
+    /** Whether the label sits above the value or beside it. */
+    layout?: InlineStatLayout;
+    /** Renders the value in tabular monospace figures. */
+    mono?: boolean;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Merged onto the label. */
+    labelClassName?: string;
+    /** Merged onto the value. */
+    valueClassName?: string;
+}
+export declare function InlineStat({ label, value, layout, mono, className, labelClassName, valueClassName, }: InlineStatProps): import("react").JSX.Element;
+export declare namespace InlineStat {
+    var displayName: string;
+}

package/dist/components/blocks/data-display/metadata/index.d.ts

@@ -0,0 +1,4 @@
+export { MetadataList } from './metadata-list';
+export type { MetadataDensity, MetadataInlineListItem, MetadataLayout, MetadataListItem, MetadataListProps, } from './metadata-list';
+export { MetadataValue } from './metadata-value';
+export type { MetadataValueDescriptor, MetadataValueKind, MetadataValueProps, } from './metadata-value';

package/dist/components/blocks/data-display/metadata/metadata-list.d.ts

@@ -0,0 +1,78 @@
+/**
+ * MetadataList — flexible label/value list for entity metadata.
+ *
+ * Three layouts:
+ *  - `grid` (default): label-on-top, value-below cells for entity details.
+ *  - `rows`: two-column definition rows with hairline separators.
+ *  - `inline`: label/separator/value pairs that wrap, suitable for
+ *    pill-style summaries (e.g. "Created Jan 4 · By Alice · v3.2").
+ *
+ * Each item supports an optional icon, tooltip, React-node value, custom
+ * `render`, and per-item `emptyLabel`. Falls back to the shared `EMPTY` when
+ * both are missing. Returns `null` when the list is empty so callers can render
+ * unconditionally.
+ */
+import { type LucideIcon } from 'lucide-react';
+import React from 'react';
+import { type ResponsiveValue } from '../../../base/structure';
+import { type StringsProp } from '../../../../lib/strings';
+import { defaultMetadataListStrings, type MetadataListStrings } from './metadata-list.strings';
+import { type MetadataValueDescriptor } from './metadata-value';
+export type { MetadataListStrings };
+export { defaultMetadataListStrings };
+export type MetadataListItem = {
+    /** Stable identity for this entry. */
+    id?: string;
+    /** Display label. */
+    label: React.ReactNode;
+    value?: React.ReactNode | MetadataValueDescriptor | null;
+    /** Supporting copy shown under the label. */
+    description?: React.ReactNode | null;
+    tooltip?: React.ReactNode;
+    /** Leading glyph. */
+    icon?: LucideIcon;
+    emptyLabel?: React.ReactNode;
+    render?: (item: MetadataListItem) => React.ReactNode;
+};
+export type MetadataInlineListItem = Omit<MetadataListItem, 'description'> & {
+    description?: never;
+};
+export type MetadataLayout = 'grid' | 'rows' | 'inline';
+export type MetadataDensity = 'default' | 'compact';
+type MetadataListSharedProps = {
+    /** How many columns the grid layout uses. Accepts a per-breakpoint value. */
+    columns?: ResponsiveValue<1 | 2 | 3 | 4>;
+    /** Row spacing. `compact` tightens the list for dense panels. */
+    density?: MetadataDensity;
+    /** Copy shown for an item whose value is empty. Defaults to an em dash. */
+    emptyLabel?: React.ReactNode;
+    /** Surface title. */
+    title?: React.ReactNode;
+    /** Draws a rule between the title and the first item. */
+    titleSeparator?: boolean;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Character placed between a label and its value. Defaults to a colon. */
+    separator?: string;
+    /** Divider between items — `true` for the default rule, or a character for inline layouts. */
+    itemSeparator?: boolean | string;
+    /** Per-instance string overrides (deep-merged over `defaultMetadataListStrings`). */
+    strings?: StringsProp<MetadataListStrings>;
+};
+type MetadataGridRowsProps = MetadataListSharedProps & {
+    /** Label/value pairs to render. */
+    items: MetadataListItem[];
+    /** `grid` flows items into `columns`; `rows` stacks them one per line. Default: `grid`. */
+    layout?: 'grid' | 'rows';
+};
+type MetadataInlineProps = MetadataListSharedProps & {
+    /** Values to render, without labels. */
+    items: MetadataInlineListItem[];
+    /** Runs the values together on one line, separated by `itemSeparator`. */
+    layout: 'inline';
+};
+export type MetadataListProps = MetadataGridRowsProps | MetadataInlineProps;
+export declare function MetadataList({ items, columns, density, emptyLabel, title, titleSeparator, className, layout, separator, itemSeparator, strings: stringsProp, }: MetadataListProps): React.JSX.Element | null;
+export declare namespace MetadataList {
+    var displayName: string;
+}

package/dist/components/blocks/data-display/metadata/metadata-list.strings.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Default user-facing strings for `<MetadataList>`.
+ *
+ * Consumers wire backend i18n at the call site:
+ *
+ *   <MetadataList strings={{ infoFallback: t('metadata.info') }} … />
+ */
+export interface MetadataListStrings {
+    /**
+     * Suffix appended to the label when generating the tooltip-trigger
+     * `aria-label` ("<label> info"). Receives the label as the first arg
+     * so consumers can localise the full template.
+     */
+    formatInfoAriaLabel: (label: string) => string;
+    /** Fallback `aria-label` used when the field label is not a plain string. */
+    infoFallback: string;
+}
+export declare const defaultMetadataListStrings: MetadataListStrings;

package/dist/components/blocks/data-display/metadata/metadata-value.d.ts

@@ -0,0 +1,142 @@
+/**
+ * MetadataValue — primitive-backed adapter for typed label/value facts.
+ *
+ * Each descriptor kind exposes only the fields its primitive consumes. Custom
+ * `node` values remain untouched so app-owned composition keeps its identity.
+ */
+import type { ReactNode } from 'react';
+import type { Locale } from 'date-fns';
+import { type BadgeProps } from '../../../base/badge';
+import { type DateInput, type DatePreset, type MoneyProps, type TimeProps } from '../../../primitives';
+export type MetadataValueKind = 'text' | 'mono' | 'email' | 'phone' | 'url' | 'link' | 'date' | 'time' | 'datetime' | 'money' | 'badge' | 'node' | 'empty';
+type MetadataDisplayValue = Exclude<ReactNode, null | undefined>;
+type MetadataDateInput = Exclude<DateInput, null | undefined>;
+/** Styling hook shared by every descriptor. */
+type MetadataDescriptorBase = {
+    /** Merged onto the rendered value. */
+    className?: string;
+};
+/** Empty handling shared by every descriptor that can receive a blank value. */
+type MetadataValueFallback = {
+    /** Copy shown when the value is empty. Defaults to an em dash. */
+    emptyLabel?: ReactNode;
+};
+/** Escape hatch for descriptors whose value can be rendered by the caller. */
+type MetadataDisplayOverride = {
+    /** Pre-rendered content used verbatim, bypassing this descriptor's formatting. */
+    display?: ReactNode;
+};
+export type MetadataTextValueDescriptor = MetadataDescriptorBase & MetadataValueFallback & MetadataDisplayOverride & {
+    /** Plain text. The default when `kind` is omitted. */
+    kind?: 'text';
+    /** The value to show. */
+    value: MetadataDisplayValue;
+};
+export type MetadataMonoValueDescriptor = MetadataDescriptorBase & MetadataValueFallback & MetadataDisplayOverride & {
+    /** Monospace, for ids, hashes, and codes. */
+    kind: 'mono';
+    /** The value to show. */
+    value: MetadataDisplayValue;
+};
+export type MetadataContactValueDescriptor = MetadataDescriptorBase & MetadataValueFallback & MetadataDisplayOverride & {
+    /** Contact value, rendered as the matching `mailto:`, `tel:`, or external link. */
+    kind: 'email' | 'phone' | 'url';
+    /** The address, number, or URL. */
+    value: string;
+};
+export type MetadataLinkValueDescriptor = MetadataDescriptorBase & MetadataValueFallback & MetadataDisplayOverride & {
+    /** An arbitrary link, where text and destination differ. */
+    kind: 'link';
+    /** Destination for the entry, when it navigates. */
+    href: string;
+    /** Link text. Falls back to `href` when omitted. */
+    value?: MetadataDisplayValue;
+};
+export type MetadataDateValueDescriptor = MetadataDescriptorBase & MetadataValueFallback & {
+    /** A calendar date. */
+    kind: 'date';
+    /** The date to format. */
+    value: MetadataDateInput;
+    /** date-fns `Locale` for formatting. */
+    dateLocale?: Locale;
+    /** date-fns pattern, overriding `datePreset`. */
+    dateFormat?: string;
+    /** Named date length. */
+    datePreset?: DatePreset;
+};
+export type MetadataTimeValueDescriptor = MetadataDescriptorBase & MetadataValueFallback & {
+    /** A time of day. */
+    kind: 'time';
+    /** The time to format. */
+    value: MetadataDateInput;
+    /** date-fns `Locale` for formatting. */
+    dateLocale?: Locale;
+    /** date-fns pattern, overriding `timePreset`. */
+    timeFormat?: string;
+    /** Named time length. */
+    timePreset?: TimeProps['preset'];
+};
+export type MetadataDateTimeValueDescriptor = MetadataDescriptorBase & MetadataValueFallback & {
+    kind: 'datetime';
+    /** The instant to format. */
+    value: MetadataDateInput;
+    /** date-fns `Locale` for formatting. */
+    dateLocale?: Locale;
+    /** date-fns pattern for the date portion. */
+    dateFormat?: string;
+    /** date-fns pattern for the time portion. */
+    timeFormat?: string;
+    /** Named date length, used when `dateFormat` is omitted. */
+    datePreset?: DatePreset;
+};
+export type MetadataMoneyValueDescriptor = MetadataDescriptorBase & MetadataValueFallback & {
+    /** A monetary amount. */
+    kind: 'money';
+    /** The amount, in major units unless `minorUnitScale` says otherwise. */
+    value: number | string;
+    /** ISO currency code. */
+    currency?: MoneyProps['currency'];
+    /** Unit label shown after the amount. */
+    unit?: MoneyProps['unit'];
+    /** Divisor applied when the value arrives in minor units, e.g. `100` for cents. */
+    minorUnitScale?: MoneyProps['minorUnitScale'];
+    /** Explicit currency symbol, overriding the one derived from `currency`. */
+    symbol?: MoneyProps['symbol'];
+    /** Whether the currency shows as a symbol, code, or name. */
+    currencyDisplay?: MoneyProps['currencyDisplay'];
+    /** Selects the compact or full presentation. */
+    formatMode?: MoneyProps['formatMode'];
+    /** Smallest number of decimals to show. */
+    minimumFractionDigits?: MoneyProps['minimumFractionDigits'];
+    /** Largest number of decimals to show. */
+    maximumFractionDigits?: MoneyProps['maximumFractionDigits'];
+    /** BCP 47 locale for the amount. */
+    locale?: MoneyProps['locale'];
+};
+export type MetadataBadgeValueDescriptor = MetadataDescriptorBase & MetadataValueFallback & MetadataDisplayOverride & {
+    /** A status chip. */
+    kind: 'badge';
+    /** Badge text. */
+    value: MetadataDisplayValue;
+    /** Badge tone. */
+    badgeTone?: BadgeProps['tone'];
+    /** Badge size. */
+    badgeSize?: BadgeProps['size'];
+};
+export type MetadataNodeValueDescriptor = {
+    /** Arbitrary content, bypassing every formatting path. */
+    kind: 'node';
+    /** The content to render. */
+    node: ReactNode;
+};
+export type MetadataEmptyValueDescriptor = MetadataDescriptorBase & MetadataValueFallback & {
+    /** A known-absent value, rendered as the empty label rather than omitted. */
+    kind: 'empty';
+};
+export type MetadataValueDescriptor = MetadataTextValueDescriptor | MetadataMonoValueDescriptor | MetadataContactValueDescriptor | MetadataLinkValueDescriptor | MetadataDateValueDescriptor | MetadataTimeValueDescriptor | MetadataDateTimeValueDescriptor | MetadataMoneyValueDescriptor | MetadataBadgeValueDescriptor | MetadataNodeValueDescriptor | MetadataEmptyValueDescriptor;
+export type MetadataValueProps = MetadataValueDescriptor;
+export declare function MetadataValue(props: MetadataValueProps): import("react").JSX.Element;
+export declare namespace MetadataValue {
+    var displayName: string;
+}
+export {};

package/dist/components/blocks/data-display/relationship-card-frame.d.ts

@@ -0,0 +1,40 @@
+/**
+ * RelationshipCardFrame — card-free scaffold for app-owned resource cards.
+ *
+ * The package owns the visual grammar; the app owns the domain data,
+ * selectors, mutations, and routing. Frame it with Card at the page,
+ * drawer, or preview call site when card chrome is needed.
+ */
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type BadgeProps } from '../../base/badge';
+export interface RelationshipCardFrameProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Leading glyph. */
+    icon?: ReactNode;
+    /** Surface title. */
+    title: ReactNode;
+    /** Chip beside the title. Pass a node, or an object to use the built-in badge. */
+    titleBadge?: ReactNode | {
+        label: ReactNode;
+        tone?: BadgeProps['tone'];
+        size?: BadgeProps['size'];
+    };
+    /** Notice between the header and the body. */
+    alertSlot?: ReactNode;
+    /** Label/value facts under the title. */
+    metadataSlot?: ReactNode;
+    /** Main control in the header. */
+    primaryActionSlot?: ReactNode;
+    /** Overflow menu at the end of the header. */
+    overflowActionSlot?: ReactNode;
+    /** Control that changes which relationship is shown. */
+    selectorSlot?: ReactNode;
+    /** Expanded detail region below the body. */
+    detailsSlot?: ReactNode;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Merged onto the header. */
+    headerClassName?: string;
+    /** Merged onto the body. */
+    bodyClassName?: string;
+}
+export declare const RelationshipCardFrame: import("react").ForwardRefExoticComponent<RelationshipCardFrameProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/blocks/onboarding/checklist/checklist.d.ts

@@ -0,0 +1,2 @@
+import type { OnboardingChecklistProps } from './checklist.types';
+export declare const OnboardingChecklist: import("react").ForwardRefExoticComponent<OnboardingChecklistProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/blocks/onboarding/checklist/checklist.strings.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Strings for `<OnboardingChecklist>`. Indicator labels are screen-reader
+ * announcements for the status icons; consumers wire their i18n into them.
+ *
+ * The `regionAriaLabel` is intentionally optional — the consumer typically
+ * already has a heading above the checklist that names it ("Set up your
+ * workspace"), so adding an aria-label here would be redundant.
+ */
+export interface OnboardingChecklistStrings {
+    regionAriaLabel?: string;
+    statusCompletedAria: string;
+    statusInProgressAria: string;
+    statusPendingAria: string;
+}
+export declare const defaultOnboardingChecklistStrings: OnboardingChecklistStrings;

package/dist/components/blocks/onboarding/checklist/checklist.types.d.ts

@@ -0,0 +1,64 @@
+import type { ReactNode } from 'react';
+import type { DisclosureSurface } from '../../../../lib/component-vocabulary';
+import type { StringsProp } from '../../../../lib/strings';
+import type { OnboardingChecklistStrings } from './checklist.strings';
+/** Status of a single onboarding step. */
+export type OnboardingStepStatus = 'completed' | 'in-progress' | 'pending';
+export interface OnboardingChecklistStep {
+    /** Stable identifier for controlled-mode + accordion value. */
+    id: string;
+    /** Current status — drives the leading indicator and tone. */
+    status: OnboardingStepStatus;
+    /** Step title; renders as a `<Heading tag="h4">`. */
+    title: ReactNode;
+    /**
+     * Trailing badge — typically a status pill ("Ready", "Required",
+     * "Recommended"). Pass any node — usually `<Badge>` from
+     * `base/badge`.
+     */
+    badge?: ReactNode;
+    /**
+     * Body content shown when the step is expanded. This is where
+     * forms / inputs / illustrations live.
+     */
+    content?: ReactNode;
+    /** Prevents the step from expanding/collapsing when true. */
+    disabled?: boolean;
+}
+/**
+ * Visual chrome for the checklist shell. Same axis as `SmartAccordion`'s
+ * variant prop — re-exported here for discoverability.
+ *
+ * `card`     — each step is a separate rounded card.
+ * `bordered` — single rounded shell with row dividers (the canonical
+ *              onboarding look from the user's reference).
+ * `flat`     — no chrome at all.
+ */
+export type OnboardingChecklistVariant = DisclosureSurface;
+export interface OnboardingChecklistProps {
+    steps: OnboardingChecklistStep[];
+    /**
+     * Initial expanded step ids (uncontrolled). Defaults to opening the
+     * first non-completed step so the user lands on the next thing to do.
+     */
+    defaultExpanded?: string[];
+    /** Allow multiple steps expanded simultaneously. Defaults to `false`. */
+    multiple?: boolean;
+    /** Controlled expanded step ids. */
+    expanded?: string[];
+    /** Change callback for controlled mode. */
+    onExpandedChange?: (expanded: string[]) => void;
+    /**
+     * Emit when a step is opened (for analytics — fires on transitions
+     * from "not in expanded set" to "in expanded set").
+     */
+    onStepOpen?: (id: string) => void;
+    /** Visual chrome. Defaults to `'bordered'` (the canonical onboarding shape). */
+    variant?: OnboardingChecklistVariant;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Merged onto the step. */
+    stepClassName?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<OnboardingChecklistStrings>;
+}

package/dist/components/blocks/onboarding/checklist/index.d.ts

@@ -0,0 +1,4 @@
+export { OnboardingChecklist } from './checklist';
+export { defaultOnboardingChecklistStrings, type OnboardingChecklistStrings, } from './checklist.strings';
+export type { OnboardingChecklistProps, OnboardingChecklistStep, OnboardingChecklistVariant, OnboardingStepStatus, } from './checklist.types';
+export { StepStatusIndicator, type StepStatusIndicatorProps, } from './partials/step-status-indicator';

package/dist/components/blocks/onboarding/checklist/partials/step-status-indicator.d.ts

@@ -0,0 +1,12 @@
+import type { OnboardingStepStatus } from '../checklist.types';
+export interface StepStatusIndicatorProps {
+    status: OnboardingStepStatus;
+    /** Accessible name for the region. */
+    ariaLabel: string;
+    /** Merged onto the outermost node. */
+    className?: string;
+}
+export declare function StepStatusIndicator({ status, ariaLabel, className, }: StepStatusIndicatorProps): import("react").JSX.Element;
+export declare namespace StepStatusIndicator {
+    var displayName: string;
+}

package/dist/components/blocks/onboarding/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * blocks/onboarding — surfaces for SaaS onboarding flows. Currently
+ * ships the checklist accordion; adjacent patterns (welcome banners,
+ * empty-state-with-tour-cta, progress meters) belong here too as they
+ * land.
+ */
+export * from './checklist';

package/dist/components/blocks/timelines/changelog/changelog-timeline.d.ts

@@ -0,0 +1,5 @@
+import { type ChangelogTimelineProps } from './types';
+export declare function ChangelogTimeline({ entries, className, strings: stringsProp, }: ChangelogTimelineProps): import("react").JSX.Element;
+export declare namespace ChangelogTimeline {
+    var displayName: string;
+}

package/dist/components/blocks/timelines/changelog/index.d.ts

@@ -0,0 +1,2 @@
+export { ChangelogTimeline } from './changelog-timeline';
+export { defaultChangelogTimelineStrings, type ChangelogTimelineProps, type ChangelogTimelineStrings, type ChangelogEntry, type ChangelogEntryKind, } from './types';

package/dist/components/blocks/timelines/changelog/types.d.ts

@@ -0,0 +1,33 @@
+import type { ReactNode } from 'react';
+import type { StringsProp } from '../../../../lib/strings';
+export type ChangelogEntryKind = 'added' | 'removed' | 'modified' | 'fixed';
+export interface ChangelogEntry {
+    /** Stable identity for this entry. */
+    id: string;
+    kind: ChangelogEntryKind;
+    /** Surface title. */
+    title: ReactNode;
+    /** Supporting copy shown under the label. */
+    description?: ReactNode;
+    version?: string;
+    /** Formatted time for the entry. */
+    timestamp?: string;
+    /** Who produced the entry. */
+    author?: string;
+}
+export interface ChangelogTimelineStrings {
+    /** Surface title. */
+    title: string;
+    added: string;
+    removed: string;
+    modified: string;
+    fixed: string;
+}
+export declare const defaultChangelogTimelineStrings: ChangelogTimelineStrings;
+export interface ChangelogTimelineProps {
+    entries: ChangelogEntry[];
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<ChangelogTimelineStrings>;
+}

package/dist/components/blocks/timelines/index.d.ts

@@ -0,0 +1,5 @@
+export type { StepStatus, StepItem, StepsCardProps, StepsHorizontalProps } from './steps-card';
+export { StepsCard, StepsHorizontal } from './steps-card';
+export { Timeline, type TimelineProps, type TimelineItem, type TimelineStatus, type TimelineDotSize, } from './shared';
+export { ChangelogTimeline, defaultChangelogTimelineStrings, type ChangelogTimelineProps, type ChangelogTimelineStrings, type ChangelogEntry, type ChangelogEntryKind, } from './changelog';
+export { MilestonesTimeline, defaultMilestonesTimelineStrings, type MilestonesTimelineProps, type MilestonesTimelineStrings, type MilestoneItem, type MilestoneStatus, } from './milestones';

package/dist/components/blocks/timelines/milestones/index.d.ts

@@ -0,0 +1,2 @@
+export { MilestonesTimeline } from './milestones-timeline';
+export { defaultMilestonesTimelineStrings, type MilestonesTimelineProps, type MilestonesTimelineStrings, type MilestoneItem, type MilestoneStatus, } from './types';

package/dist/components/blocks/timelines/milestones/milestones-timeline.d.ts

@@ -0,0 +1,5 @@
+import { type MilestonesTimelineProps } from './types';
+export declare function MilestonesTimeline({ milestones, className, strings: stringsProp, }: MilestonesTimelineProps): import("react").JSX.Element;
+export declare namespace MilestonesTimeline {
+    var displayName: string;
+}

package/dist/components/blocks/timelines/milestones/types.d.ts

@@ -0,0 +1,32 @@
+import type { ReactNode } from 'react';
+import type { StringsProp } from '../../../../lib/strings';
+export type MilestoneStatus = 'completed' | 'in_progress' | 'upcoming' | 'blocked';
+export interface MilestoneItem {
+    /** Stable identity for this entry. */
+    id: string;
+    /** Surface title. */
+    title: ReactNode;
+    /** Supporting copy shown under the label. */
+    description?: ReactNode;
+    dueDate?: string;
+    status: MilestoneStatus;
+    /** 0–100; only used when status is `in_progress`. */
+    progress?: number;
+}
+export interface MilestonesTimelineStrings {
+    /** Surface title. */
+    title: string;
+    completed: string;
+    in_progress: string;
+    upcoming: string;
+    blocked: string;
+    dueOn: string;
+}
+export declare const defaultMilestonesTimelineStrings: MilestonesTimelineStrings;
+export interface MilestonesTimelineProps {
+    milestones: MilestoneItem[];
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<MilestonesTimelineStrings>;
+}

package/dist/components/blocks/timelines/shared/index.d.ts

@@ -0,0 +1 @@
+export { Timeline, type TimelineProps, type TimelineItem, type TimelineStatus, type TimelineDotSize, } from './timeline';