themelia-react-ui 0.0.0-stage → 1.0.0

package/dist/components/blocks/analytics/analytics.strings.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared default strings for `blocks/analytics` components.
+ *
+ * Each component accepts a `strings` prop deep-merged over these defaults
+ * so consumers override per-component without touching the rest. Day/month
+ * labels live here too because they're localisable in the same way.
+ */
+export interface AnalyticsStrings {
+    /** Fallback shown by `<Metric />` when `error` is true. */
+    metricErrorLabel: string;
+    /** Default title for `<MetricComparison />` when no `title` prop is passed. */
+    comparisonTitle: string;
+    /** Labels for the activity heatmap weekday rows (Mon–Sun, length 7). */
+    heatmapDayLabels: readonly [string, string, string, string, string, string, string];
+    /** Short month names for the activity heatmap header (Jan–Dec, length 12). */
+    heatmapMonthNames: readonly [
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string
+    ];
+    /** Heatmap legend "less" label (left edge of intensity legend). */
+    heatmapLegendLess: string;
+    /** Heatmap legend "more" label (right edge of intensity legend). */
+    heatmapLegendMore: string;
+}
+export declare const defaultAnalyticsStrings: AnalyticsStrings;

package/dist/components/blocks/analytics/atoms/metric-skeleton.d.ts

@@ -0,0 +1,13 @@
+import type { MetricSize, MetricVariant } from '../types';
+export interface MetricSkeletonProps {
+    /** Shell treatment. */
+    variant?: MetricVariant;
+    /** Size preset. */
+    size?: MetricSize;
+    /** Merged onto the outermost node. */
+    className?: string;
+}
+export declare function MetricSkeleton({ variant, size, className, }: MetricSkeletonProps): import("react").JSX.Element;
+export declare namespace MetricSkeleton {
+    var displayName: string;
+}

package/dist/components/blocks/analytics/atoms/metric-sparkline.d.ts

@@ -0,0 +1,15 @@
+import type { MetricTrend } from '../types';
+export interface MetricSparklineProps {
+    /** Data points to plot, in chronological order. */
+    data: readonly number[];
+    trend?: MetricTrend;
+    color?: string;
+    /** Merged onto the outermost node. */
+    className?: string;
+    animated?: boolean;
+    'aria-label'?: string;
+}
+export declare function MetricSparkline({ data, trend, color, className, animated, 'aria-label': ariaLabel, }: MetricSparklineProps): import("react").JSX.Element;
+export declare namespace MetricSparkline {
+    var displayName: string;
+}

package/dist/components/blocks/analytics/atoms/metric-trend-chip.d.ts

@@ -0,0 +1,15 @@
+import type { MetricChange, MetricSize, MetricTrend, MetricTrendVariant } from '../types';
+export interface MetricTrendChipProps {
+    change: MetricChange;
+    trend?: MetricTrend;
+    /** Size preset. */
+    size?: MetricSize;
+    /** Shell treatment. */
+    variant?: MetricTrendVariant;
+    /** Merged onto the outermost node. */
+    className?: string;
+}
+export declare function MetricTrendChip({ change, trend, size, variant, className, }: MetricTrendChipProps): import("react").JSX.Element;
+export declare namespace MetricTrendChip {
+    var displayName: string;
+}

package/dist/components/blocks/analytics/chart-card/chart-card.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ChartCard — standard admin chart surface for custom Recharts compositions.
+ *
+ * Use when a consumer wants this library's admin hierarchy around a bespoke
+ * chart. Data, axes, series, and Recharts children stay caller-owned; the
+ * component provides ChartContainer config, slots, and BEM hooks. It remains
+ * card-free until the call site opts into `surface` and `padding`.
+ */
+import type { ComponentProps, ReactNode } from 'react';
+import { ChartContainer, type ChartConfig, type ChartInitialDimension } from '../../../base/chart';
+import type { CardSurface, ComponentScale } from '../../../../lib/component-vocabulary';
+export type ChartCardPadding = ComponentScale;
+export type ChartCardSurface = CardSurface;
+export interface ChartCardProps {
+    /** Surface title. */
+    title?: ReactNode;
+    /** Supporting copy shown under the label. */
+    description?: ReactNode;
+    /** Content at the end of the header, before the overflow menu. */
+    headerEnd?: ReactNode;
+    /** Status or count shown immediately after the title. */
+    titleSuffix?: ReactNode;
+    /** Content below the body. */
+    footer?: ReactNode;
+    config: ChartConfig;
+    children: ComponentProps<typeof ChartContainer>['children'];
+    initialDimension?: ChartInitialDimension;
+    /** Outer chrome. */
+    surface?: ChartCardSurface;
+    /** Surface inset. */
+    padding?: ChartCardPadding;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Merged onto the content. */
+    contentClassName?: string;
+    /** Merged onto the chart. */
+    chartClassName?: string;
+}
+export declare function ChartCard({ title, description, headerEnd, titleSuffix, footer, config, children, initialDimension, surface, padding, className, contentClassName, chartClassName, }: ChartCardProps): import("react").JSX.Element;
+export declare namespace ChartCard {
+    var displayName: string;
+}

package/dist/components/blocks/analytics/chart-card/index.d.ts

@@ -0,0 +1 @@
+export { ChartCard, type ChartCardProps } from './chart-card';

package/dist/components/blocks/analytics/format-metric-value.d.ts

@@ -0,0 +1,8 @@
+import type { MetricData } from './types';
+export declare function formatMetricValue(data: MetricData): string;
+/**
+ * Resolve the effective `MetricTrend` for a metric — explicit `trend` wins,
+ * otherwise we infer from `change.direction` (`up` → positive, `down` →
+ * negative, `neutral`/missing → neutral).
+ */
+export declare function resolveTrend(data: MetricData): 'positive' | 'negative' | 'neutral';

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

@@ -0,0 +1,34 @@
+/**
+ * Analytics — unified module for every metric/stat/KPI surface in the
+ * library. One data shape (`MetricData`), one trend chip, one sparkline,
+ * eight composable surfaces:
+ *
+ *   - Metric              — single metric (7 visual variants)
+ *   - MetricBar           — horizontal strip (default + gradient frame)
+ *   - MetricGrid          — responsive grid of Metric cells
+ *   - MetricComparison    — period-over-period delta box
+ *   - MetricMicroGrid     — 6-cell dense overview with mini visualizations
+ *   - MetricGradient      — vivid hero card with embedded area chart
+ *   - ActivityHeatmap     — daily-activity calendar grid
+ *   - ChartCard           — card-free chart composition for custom Recharts children
+ *
+ * Atoms used internally:
+ *   - MetricTrendChip     — ↑/↓/→ delta indicator (4 variants)
+ *   - MetricSparkline     — recharts area mini chart
+ *   - MetricSkeleton      — loading placeholder per variant
+ */
+export type { MetricChange, MetricColorScheme, MetricData, MetricDataPoint, MetricDirection, MetricPeriod, MetricSize, MetricTrend, MetricTrendVariant, MetricValueType, MetricVariant, } from './types';
+export { defaultAnalyticsStrings, type AnalyticsStrings, } from './analytics.strings';
+export { formatMetricValue, resolveTrend } from './format-metric-value';
+export { MetricTrendChip, type MetricTrendChipProps } from './atoms/metric-trend-chip';
+export { MetricSparkline, type MetricSparklineProps } from './atoms/metric-sparkline';
+export { MetricSkeleton, type MetricSkeletonProps } from './atoms/metric-skeleton';
+export { Metric, type MetricProps } from './metric';
+export { MetricBar, type MetricBarProps, type MetricBarVariant } from './metric-bar';
+export { MetricGrid, type MetricGridProps } from './metric-grid';
+export { MetricComparison, defaultMetricComparisonStrings, type MetricComparisonProps, type MetricComparisonStrings, } from './metric-comparison';
+export { MetricMicroGrid, type MetricMicroGridProps, type MicroChartKind, type MicroMetricCell, } from './metric-micro-grid';
+export { MetricGradient, type MetricGradientProps, type MetricGradientTheme, } from './metric-gradient';
+export { ActivityHeatmap, type ActivityHeatmapDay, type ActivityHeatmapProps, type ActivityHeatmapStrings, type ActivityLevel, } from './activity-heatmap';
+export { ChartCard, type ChartCardProps } from './chart-card';
+export { TimeDistributionRuler, defaultTimeDistributionRulerStrings, type TimeDistributionRulerProps, type TimeDistributionRulerStrings, } from './time-ruler';

package/dist/components/blocks/analytics/metric/index.d.ts

@@ -0,0 +1 @@
+export { Metric, type MetricProps } from './metric';

package/dist/components/blocks/analytics/metric/metric.d.ts

@@ -0,0 +1,28 @@
+import type { MetricColorScheme, MetricData, MetricSize, MetricVariant } from '../types';
+export interface MetricProps {
+    /** Records to render. */
+    data: MetricData;
+    /** Shell treatment. */
+    variant?: MetricVariant;
+    /** Size preset. */
+    size?: MetricSize;
+    colorScheme?: MetricColorScheme;
+    /** Renders the sparkline. */
+    showSparkline?: boolean;
+    /** Renders the change. */
+    showChange?: boolean;
+    /** Renders the icon. */
+    showIcon?: boolean;
+    loading?: boolean;
+    error?: boolean;
+    errorLabel?: string;
+    /** `colored` variant only — 0-100 fill percentage. */
+    progress?: number;
+    /** Merged onto the outermost node. */
+    className?: string;
+    'aria-label'?: string;
+}
+export declare function Metric(props: MetricProps): import("react").JSX.Element;
+export declare namespace Metric {
+    var displayName: string;
+}

package/dist/components/blocks/analytics/metric-bar/index.d.ts

@@ -0,0 +1 @@
+export { MetricBar, type MetricBarProps, type MetricBarVariant } from './metric-bar';

package/dist/components/blocks/analytics/metric-bar/metric-bar.d.ts

@@ -0,0 +1,22 @@
+import type { MetricData, MetricPeriod, MetricSize } from '../types';
+export type MetricBarVariant = 'default' | 'gradient';
+export interface MetricBarProps {
+    metrics: MetricData[];
+    period?: MetricPeriod;
+    onPeriodChange?: (value: string) => void;
+    /** Shell treatment. */
+    variant?: MetricBarVariant;
+    /** Size preset. */
+    size?: MetricSize;
+    /** Renders the sparklines. */
+    showSparklines?: boolean;
+    /** Renders the changes. */
+    showChanges?: boolean;
+    footerText?: string;
+    /** Merged onto the outermost node. */
+    className?: string;
+}
+export declare function MetricBar({ metrics, period, onPeriodChange, variant, size, showSparklines, showChanges, footerText, className, }: MetricBarProps): import("react").JSX.Element;
+export declare namespace MetricBar {
+    var displayName: string;
+}

package/dist/components/blocks/analytics/metric-comparison/index.d.ts

@@ -0,0 +1 @@
+export { MetricComparison, defaultMetricComparisonStrings, type MetricComparisonProps, type MetricComparisonStrings, } from './metric-comparison';

package/dist/components/blocks/analytics/metric-comparison/metric-comparison.d.ts

@@ -0,0 +1,26 @@
+import { type StringsProp } from '../../../../lib/strings';
+import type { MetricData } from '../types';
+export interface MetricComparisonStrings {
+    /** Surface title. */
+    title: string;
+    currentLabel: string;
+    previousLabel: string;
+    suffix: string;
+}
+export declare const defaultMetricComparisonStrings: MetricComparisonStrings;
+export interface MetricComparisonProps {
+    current: MetricData;
+    previous: MetricData;
+    /** Surface title. */
+    title?: string;
+    currentPeriod?: string;
+    previousPeriod?: string;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<MetricComparisonStrings>;
+}
+export declare function MetricComparison({ current, previous, title, currentPeriod, previousPeriod, className, strings: stringsProp, }: MetricComparisonProps): import("react").JSX.Element;
+export declare namespace MetricComparison {
+    var displayName: string;
+}

package/dist/components/blocks/analytics/metric-gradient/index.d.ts

@@ -0,0 +1 @@
+export { MetricGradient, type MetricGradientProps, type MetricGradientTheme, } from './metric-gradient';

package/dist/components/blocks/analytics/metric-gradient/metric-gradient.d.ts

@@ -0,0 +1,19 @@
+import type { MetricChange, MetricDataPoint } from '../types';
+export type MetricGradientTheme = 'green' | 'purple' | 'warm' | 'ocean';
+export interface MetricGradientProps {
+    /** Surface title. */
+    title: string;
+    /** Current value. Controlled. */
+    value?: string;
+    change?: MetricChange;
+    /** Records to render. */
+    data: readonly MetricDataPoint[];
+    theme?: MetricGradientTheme;
+    subtitle?: string;
+    /** Merged onto the outermost node. */
+    className?: string;
+}
+export declare function MetricGradient({ title, value, change, data, theme, subtitle, className, }: MetricGradientProps): import("react").JSX.Element;
+export declare namespace MetricGradient {
+    var displayName: string;
+}

package/dist/components/blocks/analytics/metric-grid/index.d.ts

@@ -0,0 +1 @@
+export { MetricGrid, type MetricGridProps } from './metric-grid';

package/dist/components/blocks/analytics/metric-grid/metric-grid.d.ts

@@ -0,0 +1,33 @@
+import type { MetricColorScheme, MetricData, MetricSize, MetricVariant } from '../types';
+export interface MetricGridProps {
+    /** Metrics rendered as one responsive peer collection. */
+    metrics: MetricData[];
+    /** Cell variant. `card` composes the canonical Card surface. */
+    variant?: Extract<MetricVariant, 'card' | 'compact' | 'bordered' | 'accent' | 'colored'>;
+    /** Shared visual size forwarded to every metric. */
+    size?: MetricSize;
+    /** Shared semantic color recipe forwarded to every metric. */
+    colorScheme?: MetricColorScheme;
+    /** Maximum column count; narrower parents use fewer tracks. `auto` chooses from the cell count. */
+    columns?: 'auto' | 1 | 2 | 3 | 4 | 6;
+    /** Peer spacing. Defaults to `xl`; use denser gaps explicitly for compact lists. */
+    gap?: 'sm' | 'md' | 'lg' | 'xl';
+    /** Show each metric's sparkline when data is available. */
+    showSparklines?: boolean;
+    /** Show each metric's change indicator when data is available. */
+    showChanges?: boolean;
+    /** Show each metric's icon when data is available. */
+    showIcons?: boolean;
+    /** Render loading skeletons without changing the grid or card geometry. */
+    loading?: boolean;
+    /**
+     * Additional classes for the component root. The root owns the query
+     * container; the responsive `grid-cols-*` live on the grid inside it, so pin
+     * a layout with `columns` rather than a class here.
+     */
+    className?: string;
+}
+export declare function MetricGrid({ metrics, variant, size, colorScheme, columns, gap, showSparklines, showChanges, showIcons, loading, className, }: MetricGridProps): import("react").JSX.Element;
+export declare namespace MetricGrid {
+    var displayName: string;
+}

package/dist/components/blocks/analytics/metric-micro-grid/index.d.ts

@@ -0,0 +1 @@
+export { MetricMicroGrid, type MetricMicroGridProps, type MicroMetricCell, type MicroChartKind, } from './metric-micro-grid';

package/dist/components/blocks/analytics/metric-micro-grid/metric-micro-grid.d.ts

@@ -0,0 +1,23 @@
+export type MicroChartKind = 'bars' | 'line' | 'dots' | 'progress' | 'area' | 'pie';
+export interface MicroMetricCell {
+    /** Stable identity for this entry. */
+    id?: string;
+    /** Display label. */
+    label: string;
+    /** Current value. Controlled. */
+    value: string;
+    /** Records to render. */
+    data: readonly number[];
+    chart?: MicroChartKind;
+}
+export interface MetricMicroGridProps {
+    /** Surface title. */
+    title?: string;
+    cells: readonly MicroMetricCell[];
+    /** Merged onto the outermost node. */
+    className?: string;
+}
+export declare function MetricMicroGrid({ title, cells, className }: MetricMicroGridProps): import("react").JSX.Element;
+export declare namespace MetricMicroGrid {
+    var displayName: string;
+}

package/dist/components/blocks/analytics/time-ruler/index.d.ts

@@ -0,0 +1,2 @@
+export { TimeDistributionRuler } from './time-ruler';
+export { defaultTimeDistributionRulerStrings, type TimeDistributionRulerProps, type TimeDistributionRulerStrings, } from './types';

package/dist/components/blocks/analytics/time-ruler/time-ruler.d.ts

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

package/dist/components/blocks/analytics/time-ruler/types.d.ts

@@ -0,0 +1,32 @@
+import type { StringsProp } from '../../../../lib/strings';
+export interface TimeDistributionRulerStrings {
+    /** Density-band legend labels. */
+    legendNone: string;
+    legendLow: string;
+    legendMedium: string;
+    legendHigh: string;
+    /** "Now" marker label. */
+    legendNow: string;
+    /**
+     * Renders an hour of the day (0–23) as the axis tick and as the leading
+     * part of the per-hour tooltip. Zero-padded two-digit numerals are only
+     * the English/Latin default — override this to reach any other numbering
+     * system or clock convention.
+     */
+    formatHourLabel: (hour: number) => string;
+    /**
+     * Format function for the per-hour `title` tooltip. Receives the already
+     * formatted `hourLabel` and the bucket's count. The default names no
+     * domain; add the noun your data actually counts.
+     */
+    formatHourTitle: (hourLabel: string, count: number) => string;
+}
+export declare const defaultTimeDistributionRulerStrings: TimeDistributionRulerStrings;
+export interface TimeDistributionRulerProps {
+    hours: number[];
+    currentHour?: number;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<TimeDistributionRulerStrings>;
+}

package/dist/components/blocks/analytics/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Unified analytics types — the single source of truth for every
+ * metric / stat / KPI surface in the library. All analytics components
+ * consume the same `MetricData` shape so a single dataset can drive a hero
+ * card, a metric bar, a grid, or a comparison view without re-mapping.
+ */
+import type { LucideIcon } from 'lucide-react';
+import type { ComponentScale } from '../../../lib/component-vocabulary';
+/** Format hint for a metric value. The Metric component formats accordingly. */
+export type MetricValueType = 'number' | 'currency' | 'percentage' | 'duration' | 'text';
+/** Direction of a change vs the comparison baseline. */
+export type MetricDirection = 'up' | 'down' | 'neutral';
+/**
+ * Tone for direction colouring. Decouples direction from semantic colour —
+ * for some metrics "down" is good (e.g. churn), so consumers can override.
+ */
+export type MetricTrend = 'positive' | 'negative' | 'neutral';
+/** Colour scheme used by Metric variants that support tinting. */
+export type MetricColorScheme = 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info';
+/** Visual layout variant for the canonical `Metric` component. */
+export type MetricVariant = 
+/** Default tile — label, value, optional sparkline / trend chip / footer. */
+'default'
+/** Standalone metric using the canonical SmartCard surface. */
+ | 'card'
+/** Single-row icon + label + value + change chip. Compact list/sidebar use. */
+ | 'compact'
+/** Inline `Label: value ↑12%` chip. Pure inline copy. */
+ | 'minimal'
+/** Border + soft tint based on `colorScheme`. */
+ | 'bordered'
+/** Dark surface card with bottom-aligned area sparkline. Hero-row variant. */
+ | 'accent'
+/** Tinted card with stepped progress bar (`progress` prop drives fill). */
+ | 'colored';
+/** Canonical sizing scale used across atoms and molecules. */
+export type MetricSize = ComponentScale;
+/** Trend chip rendering style. */
+export type MetricTrendVariant = 'default' | 'badge' | 'compact' | 'inline';
+/** Period strip controller (`MetricBar` selector + `onPeriodChange`). */
+export interface MetricPeriod {
+    /** Display label. */
+    label: string;
+    value: string;
+}
+/** Delta vs comparison period. `value` is plain text — formatting is consumer-side. */
+export interface MetricChange {
+    value: number | string;
+    direction: MetricDirection;
+    /** Display label. */
+    label?: string;
+}
+/**
+ * Shared metric data shape. `id` is required for stable list keys; `value` accepts
+ * `null` to render the empty placeholder; `valueType` tells the component how to
+ * format numeric values (currency, percentage, duration, …).
+ */
+export interface MetricData {
+    /** Stable identity for this entry. */
+    id: string;
+    /** Display label. */
+    label: string;
+    value: number | string | null;
+    valueType?: MetricValueType;
+    currency?: string;
+    change?: MetricChange;
+    sparkline?: readonly number[];
+    /** Leading glyph. */
+    icon?: LucideIcon;
+    tooltip?: string;
+    subtitle?: string;
+    footer?: string;
+    trend?: MetricTrend;
+    /** Destination for the entry, when it navigates. */
+    href?: string;
+    onClick?: () => void;
+}
+/** Time-series datapoint used by the gradient/area chart variants. */
+export interface MetricDataPoint {
+    /** Display label. */
+    label: string;
+    value: number;
+}

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

@@ -0,0 +1 @@
+export * from './message';

package/dist/components/blocks/collaboration/message/index.d.ts

@@ -0,0 +1,2 @@
+export { Message, MessageBubble, MessageContent, MessageHeader, MessageActions, MessageStatus } from './message';
+export { defaultMessageStrings, type MessageProps, type MessagePartProps, type MessageBubbleProps, type MessageStatusProps, type MessageStrings } from './message.types';

package/dist/components/blocks/collaboration/message/message.d.ts

@@ -0,0 +1,8 @@
+import { type MessageProps, type MessagePartProps, type MessageBubbleProps, type MessageStatusProps } from './message.types';
+export declare const MessageContent: import("react").ForwardRefExoticComponent<MessagePartProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const MessageHeader: import("react").ForwardRefExoticComponent<MessagePartProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const MessageActions: import("react").ForwardRefExoticComponent<MessagePartProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const MessageBubble: import("react").ForwardRefExoticComponent<MessageBubbleProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const MessageStatus: import("react").ForwardRefExoticComponent<MessageStatusProps & import("react").RefAttributes<HTMLSpanElement>>;
+/** Callback-free transcript presentation. Consumers own rich text, requests and delivery state. */
+export declare const Message: import("react").ForwardRefExoticComponent<MessageProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/blocks/collaboration/message/message.types.d.ts

@@ -0,0 +1,30 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import type { StringsProp } from '../../../../lib/strings';
+export interface MessageStrings {
+    typing: string;
+    loading: string;
+}
+export declare const defaultMessageStrings: MessageStrings;
+export interface MessageProps extends ComponentPropsWithoutRef<'div'> {
+    /** Message direction, independent of author or service role. */
+    align?: 'start' | 'end';
+    /** Bubble treatment. @default muted */
+    tone?: 'muted' | 'primary' | 'plain' | 'surface';
+    avatar?: ReactNode;
+    author?: ReactNode;
+    /** Caller-formatted time; datetime supplies machine-readable time when available. */
+    timestamp?: ReactNode;
+    dateTime?: string;
+    actions?: ReactNode;
+    status?: ReactNode;
+    loading?: boolean;
+    typing?: boolean;
+    strings?: StringsProp<MessageStrings>;
+}
+export interface MessagePartProps extends ComponentPropsWithoutRef<'div'> {
+}
+export interface MessageBubbleProps extends MessagePartProps {
+    tone?: 'muted' | 'primary' | 'plain' | 'surface';
+}
+export interface MessageStatusProps extends ComponentPropsWithoutRef<'span'> {
+}

package/dist/components/blocks/commerce/address-card/address-card.d.ts

@@ -0,0 +1,5 @@
+import { type AddressCardProps } from './types';
+export declare function AddressCard({ kind, name, line1, line2, city, region, postalCode, country, phone, default: defaultAddress, onEdit, onRemove, onMakeDefault, className, strings: stringsProp, }: AddressCardProps): import("react").JSX.Element;
+export declare namespace AddressCard {
+    var displayName: string;
+}

package/dist/components/blocks/commerce/address-card/index.d.ts

@@ -0,0 +1,2 @@
+export { AddressCard } from './address-card';
+export { defaultAddressCardStrings, type AddressCardProps, type AddressCardStrings, type AddressKind, } from './types';

package/dist/components/blocks/commerce/address-card/types.d.ts

@@ -0,0 +1,43 @@
+import type { StringsProp } from '../../../../lib/strings';
+export type AddressKind = 'shipping' | 'billing' | 'pickup';
+export interface AddressCardStrings {
+    defaultBadge: string;
+    edit: string;
+    remove: string;
+    makeDefault: string;
+    shipping: string;
+    billing: string;
+    pickup: string;
+}
+export declare const defaultAddressCardStrings: AddressCardStrings;
+export interface AddressCardProps {
+    /** What the address is for — billing, shipping, or both. */
+    kind?: AddressKind;
+    /** Display name. */
+    name: string;
+    /** Street address. */
+    line1: string;
+    /** Apartment, suite, or unit. */
+    line2?: string;
+    /** City or town. */
+    city: string;
+    /** State, province, or region. */
+    region?: string;
+    /** Postal or ZIP code. */
+    postalCode?: string;
+    /** Country name or code. */
+    country: string;
+    /** Contact number for the delivery. */
+    phone?: string;
+    /** Marks this as the account's default address. */
+    default?: boolean;
+    /** Fired when an entry is edited. */
+    onEdit?: () => void;
+    /** Fired when an entry is removed. */
+    onRemove?: () => void;
+    onMakeDefault?: () => void;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<AddressCardStrings>;
+}

package/dist/components/blocks/commerce/booking-calendar-event-card/booking-calendar-event-card.d.ts

@@ -0,0 +1,12 @@
+import type { BookingCalendarEventCardProps } from './booking-calendar-event-card.types';
+/**
+ * Compact, card-free booking detail composition.
+ *
+ * All visible copy is supplied by props, so this component intentionally has
+ * no strings file. Frame it with `Card` only when the page needs card
+ * chrome.
+ */
+export declare function BookingCalendarEventCard({ title, description, status, items, actionLabel, onAction, className, contentClassName, }: BookingCalendarEventCardProps): import("react").JSX.Element;
+export declare namespace BookingCalendarEventCard {
+    var displayName: string;
+}

package/dist/components/blocks/commerce/booking-calendar-event-card/booking-calendar-event-card.types.d.ts

@@ -0,0 +1,36 @@
+import type { ReactNode } from 'react';
+/** One labeled fact displayed in a booking-event summary. */
+export interface BookingCalendarEventCardItem {
+    /** Stable key used to preserve the fact row across renders. */
+    id: string;
+    /** Consumer-owned fact label, such as “Date” or “Guest”. */
+    label: ReactNode;
+    /** Display value. Strings and numbers use the canonical `Value` primitive. */
+    value: ReactNode;
+    /** Span both detail columns and receive the emphasized note treatment. */
+    fullWidth?: boolean;
+}
+/**
+ * Stateless booking facts and one consumer-owned action.
+ *
+ * The component owns compact commerce presentation only. The consumer owns
+ * booking data, formatting, status copy, routing, and action behavior.
+ */
+export interface BookingCalendarEventCardProps {
+    /** Primary booking identifier or event title. */
+    title: ReactNode;
+    /** Optional supporting context shown beneath the title. */
+    description?: ReactNode;
+    /** Optional status or metadata rendered at the end of the header. */
+    status?: ReactNode;
+    /** Ordered booking facts rendered as a responsive definition list. */
+    items: BookingCalendarEventCardItem[];
+    /** Label for the primary booking action. */
+    actionLabel: ReactNode;
+    /** Called when the primary booking action is activated. */
+    onAction: () => void;
+    /** Class applied to the outer content block. */
+    className?: string;
+    /** Class applied to the details-and-action content region. */
+    contentClassName?: string;
+}

package/dist/components/blocks/commerce/booking-calendar-event-card/index.d.ts

@@ -0,0 +1,2 @@
+export { BookingCalendarEventCard } from './booking-calendar-event-card';
+export type { BookingCalendarEventCardItem, BookingCalendarEventCardProps, } from './booking-calendar-event-card.types';