themelia-react-ui 2.0.5 → 3.0.0

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

@@ -1,35 +1,28 @@
 /**
- * Analytics — unified module for every metric/stat/KPI surface in the
- * library. One data shape (`MetricData`), one trend chip, one sparkline,
- * eight composable surfaces:
+ * Analytics — the chart-free metric and statistic surfaces. Nothing exported
+ * here reaches `recharts`, so this entry is safe to import without that
+ * optional peer:
  *
- *   - 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
+ *   - MetricComparison       — period-over-period delta box
+ *   - ActivityHeatmap        — daily-activity calendar grid
+ *   - TimeDistributionRuler  — activity by hour of day
+ *   - UsageCard              — quota and usage summary
+ *   - MetricTrendChip        — ↑/↓/→ delta indicator (4 variants)
+ *   - MetricSkeleton         — loading placeholder per Metric variant
  *
- * Atoms used internally:
- *   - MetricTrendChip     — ↑/↓/→ delta indicator (4 variants)
- *   - MetricSparkline     — recharts area mini chart
- *   - MetricSkeleton      — loading placeholder per variant
+ * plus the shared metric types, strings and formatters.
+ *
+ * The blocks that draw with Recharts — Metric, MetricBar, MetricGrid,
+ * MetricMicroGrid, MetricGradient, MetricSparkline and ChartCard — live in
+ * `themelia-react-ui/blocks/analytics/charts`. `analytics-entry.test.ts`
+ * keeps this entry free of that import.
  */
-export type { MetricChange, MetricColorScheme, MetricData, MetricDataPoint, MetricDirection, MetricPeriod, MetricSize, MetricTrend, MetricTrendVariant, MetricValueType, MetricVariant, } from './types';
+export type { MetricChange, MetricData, MetricDataPoint, MetricDirection, MetricPeriod, MetricSize, MetricTrend, MetricTrendVariant, MetricValueType, MetricVariant, } from './types';
 export { defaultAnalyticsStrings, type AnalyticsStrings, } from './analytics.strings';
 export { formatMetricValue, resolveTrend, type FormatMetricValueOptions } from './format-metric-value';
-export { MetricTrendChip, type MetricTrendChipProps } from './atoms/metric-trend-chip';
-export { MetricSparkline, type MetricSparklineProps } from './atoms/metric-sparkline';
+export { MetricTrendChip, defaultMetricTrendChipStrings, type MetricTrendChipProps, type MetricTrendChipStrings, } from './atoms/metric-trend-chip';
 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';
 export * from './usage-card';

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

@@ -1,4 +1,5 @@
-import type { MetricColorScheme, MetricData, MetricSize, MetricVariant } from '../types';
+import type { SemanticTone } from '../../../../lib/component-vocabulary';
+import type { MetricData, MetricSize, MetricVariant } from '../types';
 export interface MetricProps {
     /** Records to render. */
     data: MetricData;
@@ -6,7 +7,8 @@ export interface MetricProps {
     variant?: MetricVariant;
     /** Size preset. */
     size?: MetricSize;
-    colorScheme?: MetricColorScheme;
+    /** Tone for bordered surfaces and colored progress. Defaults to neutral; the `colored` variant defaults to primary. */
+    tone?: SemanticTone;
     /** Renders the sparkline. */
     showSparkline?: boolean;
     /** Renders the change. */
@@ -16,8 +18,10 @@ export interface MetricProps {
     loading?: boolean;
     error?: boolean;
     errorLabel?: string;
-    /** `colored` variant only — 0-100 fill percentage. */
+    /** `colored` variant only — 0-100 fill percentage. Values outside the range are clamped. */
     progress?: number;
+    /** `colored` variant only — accessible name of the progress bar. Defaults to "<label> progress". */
+    progressLabel?: string;
     /** Merged onto the outermost node. */
     className?: string;
     'aria-label'?: string;

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

@@ -6,6 +6,8 @@ export interface MetricComparisonStrings {
     currentLabel: string;
     previousLabel: string;
     suffix: string;
+    /** Copy shown when the relative change cannot be calculated. */
+    noBaseline?: string;
     /** Unit for the absolute change between two percentages. Additive; defaults to `pp`. */
     pointsUnit?: string;
 }

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

@@ -1,13 +1,12 @@
-import type { MetricColorScheme, MetricData, MetricSize, MetricVariant } from '../types';
-export interface MetricGridProps {
+import { type MetricProps } from '../metric/metric';
+import type { MetricData, MetricSize, MetricVariant } from '../types';
+export interface MetricGridProps extends Pick<MetricProps, 'tone'> {
     /** 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. */
@@ -27,7 +26,7 @@ export interface MetricGridProps {
      */
     className?: string;
 }
-export declare function MetricGrid({ metrics, variant, size, colorScheme, columns, gap, showSparklines, showChanges, showIcons, loading, className, }: MetricGridProps): import("react").JSX.Element;
+export declare function MetricGrid({ metrics, variant, size, tone, columns, gap, showSparklines, showChanges, showIcons, loading, className, }: MetricGridProps): import("react").JSX.Element;
 export declare namespace MetricGrid {
     var displayName: string;
 }

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

@@ -5,6 +5,7 @@
  * card, a metric bar, a grid, or a comparison view without re-mapping.
  */
 import type { LucideIcon } from 'lucide-react';
+import type { MouseEvent } from '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';
@@ -15,8 +16,6 @@ export type MetricDirection = 'up' | 'down' | 'neutral';
  * 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. */
@@ -27,7 +26,7 @@ export type MetricVariant =
  | 'compact'
 /** Inline `Label: value ↑12%` chip. Pure inline copy. */
  | 'minimal'
-/** Border + soft tint based on `colorScheme`. */
+/** Border and soft tint based on `tone`. */
  | 'bordered'
 /** Dark surface card with bottom-aligned area sparkline. Hero-row variant. */
  | 'accent'
@@ -49,6 +48,11 @@ export interface MetricChange {
     direction: MetricDirection;
     /** Display label. */
     label?: string;
+    /**
+     * The direction in words for assistive technology ("Up", "Down"). Defaults
+     * to the trend chip's own strings; set it to localise per datum.
+     */
+    directionLabel?: string;
 }
 /**
  * Shared metric data shape. `id` is required for stable list keys; `value` accepts
@@ -73,7 +77,12 @@ export interface MetricData {
     trend?: MetricTrend;
     /** Destination for the entry, when it navigates. */
     href?: string;
-    onClick?: () => void;
+    /**
+     * Fired when the metric is activated. With `href` the metric stays a real
+     * link and the handler receives the click: call `event.preventDefault()` to
+     * route in-app.
+     */
+    onClick?: (event: MouseEvent<HTMLElement>) => void;
 }
 /** Time-series datapoint used by the gradient/area chart variants. */
 export interface MetricDataPoint {

package/dist/components/blocks/analytics/usage-card/usage-card.strings.d.ts

@@ -14,6 +14,8 @@ export interface UsageCardStrings {
     perDay: string;
     /** Shown in place of the daily average when a day's record is missing. Additive. */
     averageUnavailable?: string;
+    /** Writes a quota's progress for assistive technology from formatted figures. Defaults to "<used> of <limit> <unit> used". */
+    formatQuotaValueText?: (used: string, limit: string, unit?: string) => string;
     resources: string;
     periods: string;
     loading: string;

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

@@ -1,5 +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, surface, padding, headerDivider, className, strings: stringsProp, ...props }: AddressCardProps): import("react").JSX.Element;
+export declare function AddressCard({ kind, address, default: defaultAddress, onEdit, onRemove, onMakeDefault, surface, padding, headerDivider, className, strings: stringsProp, ...props }: AddressCardProps): import("react").JSX.Element;
 export declare namespace AddressCard {
     var displayName: string;
 }

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

@@ -1,6 +1,7 @@
 import type { ComponentPropsWithoutRef } from 'react';
 import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
+import type { OrderAddress } from '../shared/order-status';
 export type AddressKind = 'shipping' | 'billing' | 'pickup';
 export interface AddressCardStrings {
     defaultBadge: string;
@@ -10,28 +11,16 @@ export interface AddressCardStrings {
     shipping: string;
     billing: string;
     pickup: string;
+    /** Names the overflow menu after its card's title, since several cards share a page. */
+    formatActionsLabel?: (title: string) => string;
 }
 export declare const defaultAddressCardStrings: AddressCardStrings;
 /** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
 export interface AddressCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'>, Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** 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;
+    /** The address to show, in the shape `OrderCustomer` takes. Its `phone` closes the card as a click-to-call link. */
+    address: OrderAddress;
     /** Marks this as the account's default address. */
     default?: boolean;
     /** Fired when an entry is edited. */

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

@@ -7,10 +7,10 @@ import type { BookingCalendarEventCardProps } from './booking-calendar-event-car
  * no inset note panel and no rule above the action.
  *
  * 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
+ * no strings file. Pass `surface="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 function BookingCalendarEventCard({ title, description, status, items, actionLabel, onAction, surface, padding, headerDivider, 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

@@ -1,11 +1,12 @@
 import type { ReactNode } from 'react';
+import type { CardProps } from '../../../base/cards';
 /** 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. */
+    /** Display value, rendered by the shared `MetadataList` value role. */
     value: ReactNode;
     /** Span both detail columns, for a note that should not sit in a column. */
     fullWidth?: boolean;
@@ -15,21 +16,22 @@ export interface BookingCalendarEventCardItem {
  *
  * The component owns compact commerce presentation only. The consumer owns
  * booking data, formatting, status copy, routing, and action behavior.
+ * Unframed by default; set surface="card" to let this owner frame itself.
  */
-export interface BookingCalendarEventCardProps {
+export interface BookingCalendarEventCardProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Primary booking identifier or event title. */
     title: ReactNode;
     /** Optional supporting context shown beneath the title. */
     description?: ReactNode;
     /** Optional status, rendered beside the title. */
     status?: ReactNode;
-    /** Ordered booking facts rendered as a responsive definition list. */
+    /** Ordered booking facts, rendered through the shared `MetadataList` in one or two columns. */
     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. */
+    /** Class applied to the outermost node. */
     className?: string;
     /** Class applied to the details-and-action content region. */
     contentClassName?: string;

package/dist/components/blocks/commerce/cart-summary/cart-summary.d.ts

@@ -3,5 +3,3 @@ export declare function CartSummaryCard({ items, subtotal, tax, shipping, discou
 export declare namespace CartSummaryCard {
     var displayName: string;
 }
-/** The source kit's name for `CartSummaryCard`; the same component. */
-export declare const CartSummary: typeof CartSummaryCard;

package/dist/components/blocks/commerce/cart-summary/index.d.ts

@@ -1,2 +1,2 @@
-export { CartSummary, CartSummaryCard } from './cart-summary';
-export { defaultCartSummaryStrings, type CartSummaryCardProps, type CartSummaryProps, type CartSummaryStrings, type CartLineItem, } from './types';
+export { CartSummaryCard } from './cart-summary';
+export { defaultCartSummaryStrings, type CartSummaryCardProps, type CartSummaryStrings, type CartLineItem, } from './types';

package/dist/components/blocks/commerce/cart-summary/types.d.ts

@@ -4,18 +4,16 @@ import type { StringsProp } from '../../../../lib/strings';
 export interface CartLineItem {
     /** Stable identity for this entry. */
     id: string;
-    /** Display name. */
-    name?: string;
-    productTitle?: string;
-    /** Surface title. */
-    title?: string;
+    /** Product name shown on the line. */
+    title: string;
+    /** Variant or option summary under the title. */
     variantTitle?: string;
     qty: number;
+    /** Formatted line price. */
     price: string;
-    imageUrl?: string;
+    /** Product image. Without one, or when it fails to load, the line's initials show. */
     imageSrc?: string;
-    src?: string;
-    url?: string;
+    /** Alternative text for the image. Defaults to the title. */
     imageAlt?: string;
 }
 export interface CartSummaryStrings {
@@ -34,8 +32,10 @@ export interface CartSummaryStrings {
     checkout: string;
     /** Writes a line's quantity, so a translation owns the multiplication sign. */
     formatQuantity: (quantity: number) => string;
+    /** Shown in place of the lines when the cart has none. */
+    empty?: string;
 }
-export declare const defaultCartSummaryStrings: CartSummaryStrings;
+export declare const defaultCartSummaryStrings: Required<CartSummaryStrings>;
 /** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
 export interface CartSummaryCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'>, Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Line items in the cart. */
@@ -56,5 +56,3 @@ export interface CartSummaryCardProps extends Omit<ComponentPropsWithoutRef<'div
     /** Overrides this surface's own copy. */
     strings?: StringsProp<CartSummaryStrings>;
 }
-/** The source kit's name for `CartSummaryCardProps`. */
-export type CartSummaryProps = CartSummaryCardProps;

package/dist/components/blocks/commerce/coupon-input/coupon-input.d.ts

@@ -1,5 +1,5 @@
 import { type CouponInputCardProps } from './types';
-export declare function CouponInputCard({ appliedCode, appliedDiscount, error, onApply, onRemove, loading, className, strings: stringsProp, }: CouponInputCardProps): import("react").JSX.Element;
+export declare function CouponInputCard({ appliedCode, appliedDiscount, error, onApply, onRemove, loading, surface, padding, headerDivider, className, strings: stringsProp, }: CouponInputCardProps): import("react").JSX.Element;
 export declare namespace CouponInputCard {
     var displayName: string;
 }

package/dist/components/blocks/commerce/coupon-input/types.d.ts

@@ -1,3 +1,4 @@
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export interface CouponInputStrings {
     /** Surface title. */
@@ -13,16 +14,19 @@ export interface CouponInputStrings {
     apply: string;
     remove: string;
     applied: string;
+    /** Error copy used when `error` is passed as `true`. */
     invalid: string;
 }
 export declare const defaultCouponInputStrings: CouponInputStrings;
-export interface CouponInputCardProps {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface CouponInputCardProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Coupon currently applied, if any. */
     appliedCode?: string;
     /** Formatted discount the coupon grants. */
     appliedDiscount?: string;
-    /** Validation message for a rejected code. */
-    error?: string;
+    /** Validation message for a rejected code. `true` shows `strings.invalid`. */
+    error?: string | boolean;
+    /** Fired with the trimmed, upper-cased code when the form is submitted, by the button or by Enter. */
     onApply?: (code: string) => void;
     /** Fired when an entry is removed. */
     onRemove?: () => void;

package/dist/components/blocks/commerce/discount-stack/discount-stack.d.ts

@@ -3,5 +3,3 @@ export declare function DiscountStackPreview({ discounts, totalSavings, classNam
 export declare namespace DiscountStackPreview {
     var displayName: string;
 }
-/** The source kit's name for `DiscountStackPreview`; the same component. */
-export declare const DiscountStack: typeof DiscountStackPreview;

package/dist/components/blocks/commerce/discount-stack/index.d.ts

@@ -1,2 +1,2 @@
-export { DiscountStack, DiscountStackPreview } from './discount-stack';
-export { defaultDiscountStackStrings, type Discount, type DiscountStackPreviewProps, type DiscountStackProps, type DiscountStackStrings, } from './types';
+export { DiscountStackPreview } from './discount-stack';
+export { defaultDiscountStackStrings, type Discount, type DiscountStackPreviewProps, type DiscountStackStrings, } from './types';

package/dist/components/blocks/commerce/discount-stack/types.d.ts

@@ -3,7 +3,7 @@ import type { BadgeTone } from '../../../base/badge';
 import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export interface Discount {
-    /** Stable identity for this entry. Falls back to the kind, label and position. */
+    /** Stable identity for this entry. Falls back to the label and position. */
     id?: string;
     /** Display label. */
     label: string;
@@ -11,8 +11,6 @@ export interface Discount {
     amount: string;
     /** What kind of discount it is ("Code", "Automatic"), shown quietly beside the amount. */
     kind?: ReactNode;
-    /** The kind as plain text. Kept for existing callers; `kind` wins when both are set. */
-    type?: string;
     /**
      * Draws the kind as a chip in this tone. Discount kinds are categories, so
      * pass `neutral` unless the chip states a status. Omit it for the quiet note.
@@ -24,8 +22,10 @@ export interface DiscountStackStrings {
     title: string;
     /** Formatted sum of every discount. */
     totalSavings: string;
+    /** Shown in place of the ledger when no discount applies. */
+    empty?: string;
 }
-export declare const defaultDiscountStackStrings: DiscountStackStrings;
+export declare const defaultDiscountStackStrings: Required<DiscountStackStrings>;
 /** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
 export interface DiscountStackPreviewProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'>, Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Discounts applied, in the order they stack. */
@@ -37,5 +37,3 @@ export interface DiscountStackPreviewProps extends Omit<ComponentPropsWithoutRef
     /** Overrides this surface's own copy. */
     strings?: StringsProp<DiscountStackStrings>;
 }
-/** The source kit's name for `DiscountStackPreviewProps`. */
-export type DiscountStackProps = DiscountStackPreviewProps;

package/dist/components/blocks/commerce/fulfillment-group/fulfillment-group.d.ts

@@ -1,5 +1,5 @@
 import { type FulfillmentGroupProps } from './types';
-export declare function FulfillmentGroup({ status, location, notice, noticeIcon: NoticeIcon, items, count, children, actions, renderLink, surface, padding, className, strings: stringsProp, ...props }: FulfillmentGroupProps): import("react").JSX.Element;
+export declare function FulfillmentGroup({ status, location, notice, headingLevel, noticeIcon: NoticeIcon, items, count, children, actions, renderLink, surface, padding, className, strings: stringsProp, ...props }: FulfillmentGroupProps): import("react").JSX.Element;
 export declare namespace FulfillmentGroup {
     var displayName: string;
 }

package/dist/components/blocks/commerce/fulfillment-group/types.d.ts

@@ -25,6 +25,8 @@ export interface FulfillmentGroupProps extends Omit<ComponentPropsWithoutRef<'di
     location?: ReactNode;
     /** A standing fact about the group: "Shipping not required". */
     notice?: ReactNode;
+    /** Heading level of the status heading, chosen by the page outline around the group. @default 2 */
+    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
     /**
      * Glyph beside the notice, sized by the group. A component rather than a
      * node, so it arrives at the icon size of the text it annotates.

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-balance.d.ts

@@ -0,0 +1,18 @@
+import type { StructureGap } from '../../../../base/structure';
+import type { GiftcardData } from '../types';
+export interface GiftcardBalanceProps extends Pick<GiftcardData, 'amount' | 'remainingAmount' | 'currency'> {
+    /** Draws on the inverse card face. */
+    inverse?: boolean;
+    gap?: StructureGap;
+    /** Merged onto the amount. */
+    amountClassName?: string;
+}
+/** Resolves which amount leads and whether the face value is struck through. */
+export declare function resolveGiftcardBalance({ amount, remainingAmount }: Pick<GiftcardData, 'amount' | 'remainingAmount'>): {
+    isPartiallyUsed: boolean;
+    displayAmount: string;
+};
+export declare function GiftcardBalance({ amount, remainingAmount, currency, inverse, gap, amountClassName }: GiftcardBalanceProps): import("react").JSX.Element;
+export declare namespace GiftcardBalance {
+    var displayName: string;
+}

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-compact.d.ts

@@ -1,5 +1,5 @@
 import { type GiftcardCommonProps, type GiftcardData, type GradientVariant } from '../types';
-export declare function GiftcardCompact({ code, amount, remainingAmount, status, recipientName, gradient, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
+export declare function GiftcardCompact({ code, amount, remainingAmount, currency, status, recipientName, onView, gradient, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
     /** Background gradient for the leading block. */
     gradient?: GradientVariant;
     /** Merged onto the row root. */

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-copy-button.d.ts

@@ -1,5 +1,4 @@
 import { type GiftcardStrings } from '../types';
-/** Owns the four giftcard code actions without changing their display strips. */
 export declare function GiftcardCopyButton({ code, strings, inverse, className }: {
     code: string;
     strings: Pick<GiftcardStrings, 'copyCode' | 'copiedCode' | 'copyFailed' | 'copyingCode'>;

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-dark.d.ts

@@ -1,5 +1,5 @@
 import { type GiftcardCommonProps, type GiftcardData } from '../types';
-export declare function GiftcardCardDark({ code, amount, remainingAmount, status, recipientName, expiresAt, onView, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
+export declare function GiftcardCardDark({ code, amount, remainingAmount, currency, status, recipientName, expiresAt, createdAt, template, onView, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
     className?: string;
 }): import("react").JSX.Element;
 export declare namespace GiftcardCardDark {

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-full.d.ts

@@ -1,5 +1,5 @@
 import { type GiftcardCommonProps, type GiftcardData, type GradientVariant, type PatternVariant } from '../types';
-export declare function GiftcardFull({ code, amount, remainingAmount, status, recipientName, senderName, message, expiresAt, createdAt: _createdAt, template: _template, onView, gradient, pattern, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
+export declare function GiftcardFull({ code, amount, remainingAmount, currency, status, recipientName, senderName, message, expiresAt, createdAt, template, onView, gradient, pattern, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
     /** Background gradient. */
     gradient?: GradientVariant;
     /** Decorative overlay on the gradient. */

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-illustrated.d.ts

@@ -1,5 +1,5 @@
 import { type GiftcardCommonProps, type GiftcardData, type HeaderColor } from '../types';
-export declare function GiftcardCardIllustrated({ code, amount, remainingAmount, status, recipientName, expiresAt, onView, headerColor, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
+export declare function GiftcardCardIllustrated({ code, amount, remainingAmount, currency, status, recipientName, expiresAt, createdAt, template, onView, headerColor, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
     /** Colour of the header band. */
     headerColor?: HeaderColor;
     /** Merged onto the card root. */

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-minimal.d.ts

@@ -1,5 +1,5 @@
 import { type AccentColor, type GiftcardCommonProps, type GiftcardData } from '../types';
-export declare function GiftcardCardMinimal({ code, amount, remainingAmount, status, recipientName, expiresAt, onView, color, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
+export declare function GiftcardCardMinimal({ code, amount, remainingAmount, currency, status, recipientName, expiresAt, createdAt, template, onView, color, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
     /** Accent for the rule and highlights. */
     color?: AccentColor;
     /** Merged onto the card root. */

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

@@ -24,20 +24,20 @@ export interface GiftcardData {
     message?: string;
     /** Formatted expiry date. */
     expiresAt?: string;
-    /** Formatted issue date. */
+    /** Formatted issue date, listed among the card's facts. The compact row omits it. */
     createdAt?: string;
-    /** Design name shown as the card's template label. */
+    /** Design name, listed among the card's facts. The compact row omits it. */
     template?: string;
     /** Fired by the card's view action. Omit to render the card without it. */
     onView?: () => void;
 }
-/** Background gradient for the illustrated and full presentations. */
+/** Accent gradient for the gradient presentation's strip and the compact presentation's swatch. */
 export type GradientVariant = 'purple' | 'green' | 'warm';
-/** Decorative overlay drawn on top of the gradient. */
+/** Decorative overlay drawn on the gradient presentation's face. */
 export type PatternVariant = 'none' | 'circles' | 'waves';
 /** Accent used for the minimal presentation's rule and highlights. */
 export type AccentColor = 'green' | 'purple' | 'warm';
-/** Header band colour for the compact presentation. */
+/** Accent strip colour for the illustrated presentation's header band. */
 export type HeaderColor = 'green' | 'blue' | 'amber';
 export type GiftcardStatus = GiftcardData['status'];
 /**
@@ -64,12 +64,23 @@ export interface GiftcardStrings {
     copyFailed?: string;
     /** Pending code-copy label. */
     copyingCode?: string;
+    /** Label of the issue-date fact (`createdAt`). */
+    issued?: string;
+    /** Label of the design fact (`template`). */
+    design?: string;
+    /** Writes the sender's note, so a translation owns the quotation marks. Defaults to curly double quotes. */
+    formatMessage?: (message: string) => string;
 }
 export declare const defaultGiftcardStrings: Required<GiftcardStrings>;
 export interface GiftcardCommonProps {
     /** Override default English giftcard strings. */
     strings?: StringsProp<GiftcardStrings>;
 }
+/** The issue-date and design facts, shared by every full-size presentation. */
+export declare function giftcardIssueFacts({ createdAt, template }: Pick<GiftcardData, 'createdAt' | 'template'>, strings: Pick<GiftcardStrings, 'issued' | 'design'>): Array<{
+    label: string;
+    value: string;
+}>;
 export declare const giftcardStatusTone: Record<GiftcardStatus, 'success' | 'secondary' | 'destructive' | 'warning'>;
 export declare const gradientMap: Record<GradientVariant, {
     card: string;

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

@@ -1,11 +1,11 @@
-export type { BookingEntry, UpcomingBookingRowProps } from './upcoming-booking';
-export { UpcomingBookingRow } from './upcoming-booking';
-export { Receipt, ReceiptItems, type ReceiptProps, type ReceiptItemsProps, type ReceiptLineItem } from './receipt';
+export type { BookingEntry, UpcomingBookingRowProps, UpcomingBookingStrings } from './upcoming-booking';
+export { UpcomingBookingRow, defaultUpcomingBookingStrings } from './upcoming-booking';
+export { Receipt, ReceiptItems, type ReceiptProps, type ReceiptItemsProps, type ReceiptItemsStrings, type ReceiptLineItem } from './receipt';
 export { BookingCalendarEventCard, type BookingCalendarEventCardItem, type BookingCalendarEventCardProps, } from './booking-calendar-event-card';
 export type { LoyaltyHistoryEntry, LoyaltyPointsProps, LoyaltyPointsStrings } from './loyalty-points';
 export { LoyaltyPoints, defaultLoyaltyPointsStrings } from './loyalty-points';
-export type { Discount, DiscountStackPreviewProps, DiscountStackProps, DiscountStackStrings } from './discount-stack';
-export { DiscountStack, DiscountStackPreview, defaultDiscountStackStrings } from './discount-stack';
+export type { Discount, DiscountStackPreviewProps, DiscountStackStrings } from './discount-stack';
+export { DiscountStackPreview, defaultDiscountStackStrings } from './discount-stack';
 export type { ShipmentDetail, ShipmentStatus, ShipmentTrackingProps, ShipmentTrackingStrings, TrackingStep, } from './shipment-tracking';
 export { ShipmentTracking, defaultShipmentTrackingStrings } from './shipment-tracking';
 export { GiftcardCard, type GiftcardCardProps, type GiftcardCardVariant, type GiftcardData, type GradientVariant, type PatternVariant, type AccentColor, type HeaderColor, } from './giftcard-card';
@@ -13,13 +13,13 @@ export { defaultVendorProfileStrings, VendorProfileCard, type VendorProfileCardP
 export { InventoryLevel, defaultInventoryLevelStrings, type InventoryLevelProps, type InventoryLevelStrings, } from './inventory-level';
 export { TaxBreakdownCard, defaultTaxBreakdownStrings, type TaxBreakdownCardProps, type TaxBreakdownStrings, type TaxLineItem, } from './tax-breakdown';
 export { SubscriptionSummaryCard, defaultSubscriptionSummaryStrings, type SubscriptionSummaryCardProps, type SubscriptionSummaryStrings, type SubscriptionPerk, } from './subscription-summary';
-export { RefundStatus, RefundStatusCard, defaultRefundStatusStrings, type RefundStatusProps, type RefundStatusCardProps, type RefundStatusStrings, type RefundStage, } from './refund-status';
+export { RefundStatusCard, defaultRefundStatusStrings, type RefundStatusCardProps, type RefundStatusStrings, type RefundStage, } from './refund-status';
 export { AddressCard, defaultAddressCardStrings, type AddressCardProps, type AddressCardStrings, type AddressKind, } from './address-card';
 export { VoucherEntry, defaultVoucherEntryStrings, type VoucherEntryProps, type VoucherEntryStrings, } from './voucher-entry';
-export { CartSummary, CartSummaryCard, defaultCartSummaryStrings, type CartSummaryProps, type CartSummaryCardProps, type CartSummaryStrings, type CartLineItem, } from './cart-summary';
+export { CartSummaryCard, defaultCartSummaryStrings, type CartSummaryCardProps, type CartSummaryStrings, type CartLineItem, } from './cart-summary';
 export { CouponInputCard, defaultCouponInputStrings, type CouponInputCardProps, type CouponInputStrings, } from './coupon-input';
 export { OrderStatusCard, defaultOrderStatusStrings, type OrderStatusCardProps, type OrderStatusStrings, type OrderStatusEvent, type OrderStatusKind, } from './order-status';
-export { PaymentMethod, PaymentMethodCard, defaultPaymentMethodStrings, type PaymentMethodCardProps, type PaymentMethodProps, type PaymentMethodStrings, type PaymentMethodVariant, type PaymentBrand, } from './payment-method';
+export { PaymentMethod, defaultPaymentMethodStrings, type PaymentMethodProps, type PaymentMethodStrings, type PaymentMethodVariant, type PaymentBrand, } from './payment-method';
 export { SeoListingCard, DEFAULT_SEO_LISTING_LIMITS, calculateSeoListingScore, defaultSeoListingCardStrings, getSeoPermalinkPath, getSeoPermalinkSlug, type SeoListingCardProps, type SeoListingCardStrings, type SeoListingCheckId, type SeoListingCheckResult, type SeoListingCheckStatus, type SeoListingScoreInput, type SeoListingScoreLimits, type SeoListingScoreResult, } from './seo-listing';
 export type { InvoiceStatus, InvoiceMiniData, InvoiceMiniProps, InvoiceMiniStrings } from './invoice-mini';
 export { InvoiceMini, defaultInvoiceMiniStrings, invoiceStatusTone } from './invoice-mini';

package/dist/components/blocks/commerce/inventory-level/inventory-level.strings.d.ts

@@ -6,5 +6,7 @@ export interface InventoryLevelStrings {
     unitsAvailable: string;
     reorderAtLabel: string;
     lastRestockedLabel: string;
+    /** Writes the variant line. Defaults to `variantLabel`, a colon and the variant. */
+    formatVariant?: (variant: string) => string;
 }
 export declare const defaultInventoryLevelStrings: InventoryLevelStrings;