themelia-react-ui 2.0.6 → 3.0.0

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;

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

@@ -7,7 +7,7 @@ export interface InventoryLevelProps {
     variant?: string;
     /** Units currently on hand. */
     stock: number;
-    /** Threshold below which stock reads as low. */
+    /** Threshold at or below which stock reads as low. */
     reorderLevel: number;
     /** Capacity used as the gauge's upper bound. */
     maxStock: number;

package/dist/components/blocks/commerce/inventory-section/types.d.ts

@@ -37,11 +37,6 @@ export interface InventorySectionMetric {
     value: string;
     /** Supporting copy shown under the label. */
     description?: string;
-    /**
-     * Semantic tone of the entry. Not rendered by the summary: stats are plain
-     * and the title badge carries the stock state. Kept for type compatibility.
-     */
-    tone?: 'default' | 'success' | 'warning' | 'error' | 'info';
 }
 export interface InventorySectionStrings {
     /** Surface title. */

package/dist/components/blocks/commerce/invoice-line-items/types.d.ts

@@ -61,10 +61,13 @@ export interface InvoiceLineItemsProps<TItem = InvoiceLineItem> {
     /** Optional custom columns. Defaults to Description / Qty / Price / Total. */
     columns?: InvoiceColumn<TItem>[];
     /** Optional custom footer rows. React nodes own their typography, including
-     * total-value weight. When omitted with the default columns, an auto-computed
-     * subtotal / tax / total footer is used. */
+     * total-value weight. When omitted with the default columns, the footer
+     * shows the line total, plus subtotal and tax rows when `taxRate` is set. */
     footerRows?: InvoiceLineItemsFooterRow[];
-    /** Tax ratio for the default footer (`0.2` means 20%). @default 0.2 */
+    /**
+     * Tax ratio for the default footer (`0.2` means 20%). Omit it for no tax
+     * row: the footer then shows only the total of the lines.
+     */
     taxRate?: number;
     /** ISO 4217 code for default monetary cells. Falls back to UIProvider. */
     currency?: string;

package/dist/components/blocks/commerce/loyalty-points/loyalty-points.d.ts

@@ -1,5 +1,5 @@
 import { type LoyaltyPointsProps } from './types';
-export declare function LoyaltyPoints({ balance, tier, tierTone, history, onRedeem, className, strings: stringsProp, }: LoyaltyPointsProps): import("react").JSX.Element;
+export declare function LoyaltyPoints({ balance, tier, tierTone, history, onRedeem, surface, padding, headerDivider, className, strings: stringsProp, }: LoyaltyPointsProps): import("react").JSX.Element;
 export declare namespace LoyaltyPoints {
     var displayName: string;
 }

package/dist/components/blocks/commerce/loyalty-points/types.d.ts

@@ -1,24 +1,30 @@
 import type { BadgeTone } from '../../../base/badge';
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export interface LoyaltyHistoryEntry {
     /** Display label. */
     label: string;
+    /** Formatted movement. A value without a leading sign gains one from `positive`. */
     points: string;
     date: string;
+    /** Whether the movement earned points (`true`) or spent them (`false`). */
     positive: boolean;
 }
 export interface LoyaltyPointsStrings {
     balanceLabel: string;
     pointsAvailable: string;
     redeem: string;
-    /** Tier chip label used when `tier` is not passed. */
-    tier: string;
+    /** Screen-reader text before an earned movement. */
+    pointsEarned?: string;
+    /** Screen-reader text before a spent movement. */
+    pointsSpent?: string;
 }
-export declare const defaultLoyaltyPointsStrings: LoyaltyPointsStrings;
-export interface LoyaltyPointsProps {
+export declare const defaultLoyaltyPointsStrings: Required<LoyaltyPointsStrings>;
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface LoyaltyPointsProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Points currently available. */
     balance: number | string;
-    /** Membership tier name. Defaults to `strings.tier`. */
+    /** Membership tier name. Omit it to render no tier chip. */
     tier?: string;
     /** Badge tone for the tier chip. A tier is a kind, not a status. @default 'neutral' */
     tierTone?: BadgeTone;

package/dist/components/blocks/commerce/order-status/order-status.d.ts

@@ -1,5 +1,5 @@
 import { type OrderStatusCardProps } from './types';
-export declare function OrderStatusCard({ orderNumber, status, statusTone, events, currentEta, className, strings: stringsProp, }: OrderStatusCardProps): import("react").JSX.Element;
+export declare function OrderStatusCard({ orderNumber, status, statusTone, events, currentEta, surface, padding, headerDivider, className, strings: stringsProp, }: OrderStatusCardProps): import("react").JSX.Element;
 export declare namespace OrderStatusCard {
     var displayName: string;
 }

package/dist/components/blocks/commerce/order-status/types.d.ts

@@ -1,4 +1,5 @@
 import type { BadgeTone } from '../../../base/badge';
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export type OrderStatusKind = 'pending' | 'paid' | 'fulfilled' | 'shipped' | 'delivered' | 'cancelled';
 export interface OrderStatusEvent {
@@ -15,17 +16,16 @@ export interface OrderStatusStrings {
     status?: Partial<Record<OrderStatusKind, string>>;
     /** Formats the human-facing reference displayed below the title. */
     formatOrderNumber?: (orderNumber: string) => string;
-    /** Not rendered: the title badge states the status. Kept for existing overrides. */
-    statusLabel: string;
     /** Label of the delivery-estimate fact. */
     eta: string;
-    /** Not rendered: the timeline shows the latest event. Kept for existing overrides. */
-    latestEvent: string;
-    /** Not rendered: the timeline marks the current step. Kept for existing overrides. */
-    currentStep: string;
+    /** Screen-reader text before a completed event; its marker shows a check only. */
+    completedStep?: string;
+    /** Screen-reader text before an event that has not been reached. */
+    upcomingStep?: string;
 }
-export declare const defaultOrderStatusStrings: OrderStatusStrings;
-export interface OrderStatusCardProps {
+export declare const defaultOrderStatusStrings: OrderStatusStrings & Required<Pick<OrderStatusStrings, 'completedStep' | 'upcomingStep'>>;
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface OrderStatusCardProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Human-facing order reference. */
     orderNumber: string;
     /** Current fulfilment stage. */

package/dist/components/blocks/commerce/order-timeline/order-timeline.d.ts

@@ -1,5 +1,5 @@
 import type { OrderTimelineProps } from './types';
-export declare function OrderTimeline({ title, description, events, footerText, className, }: OrderTimelineProps): import("react").JSX.Element;
+export declare function OrderTimeline({ title, description, events, footerText, surface, padding, headerDivider, className, }: OrderTimelineProps): import("react").JSX.Element;
 export declare namespace OrderTimeline {
     var displayName: string;
 }

package/dist/components/blocks/commerce/order-timeline/types.d.ts

@@ -1,4 +1,5 @@
 import { type ReactNode } from 'react';
+import type { CardProps } from '../../../base/cards';
 export interface OrderTimelineEvent {
     /** Stable identity for this entry. */
     id: string;
@@ -10,7 +11,8 @@ export interface OrderTimelineEvent {
     timestamp: string;
     status: 'completed' | 'current' | 'pending';
 }
-export interface OrderTimelineProps {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface OrderTimelineProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */

package/dist/components/blocks/commerce/payment-method/index.d.ts

@@ -1,2 +1,2 @@
-export { PaymentMethod, PaymentMethodCard } from './payment-method';
-export { defaultPaymentMethodStrings, type PaymentMethodCardProps, type PaymentMethodProps, type PaymentMethodStrings, type PaymentMethodVariant, type PaymentBrand, } from './types';
+export { PaymentMethod } from './payment-method';
+export { defaultPaymentMethodStrings, type PaymentMethodProps, type PaymentMethodStrings, type PaymentMethodVariant, type PaymentBrand, } from './types';

package/dist/components/blocks/commerce/payment-method/payment-method.d.ts

@@ -3,11 +3,3 @@ export declare function PaymentMethod({ brand, last4, expiry, holderName, defaul
 export declare namespace PaymentMethod {
     var displayName: string;
 }
-/**
- * The source kit's `PaymentMethodCard`: `PaymentMethod` defaulting to the
- * compact `row` identity form. Pass `variant="card"` for the card face.
- */
-export declare function PaymentMethodCard({ variant, ...props }: PaymentMethodProps): import("react").JSX.Element;
-export declare namespace PaymentMethodCard {
-    var displayName: string;
-}

package/dist/components/blocks/commerce/payment-method/types.d.ts

@@ -42,5 +42,3 @@ export interface PaymentMethodProps extends Omit<ComponentPropsWithoutRef<'div'>
     /** Overrides this surface's own copy. */
     strings?: StringsProp<PaymentMethodStrings>;
 }
-/** Props of `PaymentMethodCard`: `PaymentMethod` with `variant` defaulting to `row`. */
-export type PaymentMethodCardProps = PaymentMethodProps;

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

@@ -1,3 +1,3 @@
 export { Receipt } from './receipt';
 export { ReceiptItems } from './receipt-items';
-export type { ReceiptProps, ReceiptItemsProps, ReceiptLineItem } from './types';
+export type { ReceiptProps, ReceiptItemsProps, ReceiptItemsStrings, ReceiptLineItem } from './types';

package/dist/components/blocks/commerce/receipt/receipt-items.d.ts

@@ -1,2 +1,2 @@
 import type { ReceiptItemsProps } from './types';
-export declare function ReceiptItems({ items, currency, locale, unit, minorUnitScale, formatMode, className, ...props }: ReceiptItemsProps): import("react").JSX.Element | null;
+export declare function ReceiptItems({ items, currency, locale, unit, minorUnitScale, formatMode, strings, className, ...props }: ReceiptItemsProps): import("react").JSX.Element | null;

package/dist/components/blocks/commerce/receipt/types.d.ts

@@ -39,4 +39,14 @@ export interface ReceiptItemsProps extends Omit<ComponentPropsWithoutRef<'div'>,
     minorUnitScale?: MoneyProps['minorUnitScale'];
     /** Defaults to the shared Money policy. */
     formatMode?: MoneyProps['formatMode'];
+    /** Overrides this surface's own copy. */
+    strings?: ReceiptItemsStrings;
+}
+export interface ReceiptItemsStrings {
+    /**
+     * Writes a line's quantity after its name, so a translation owns the
+     * multiplication sign and its position. Receives the formatted quantity.
+     * Defaults to `× <quantity>`.
+     */
+    formatQuantity?: (quantity: ReactNode) => ReactNode;
 }

package/dist/components/blocks/commerce/refund-status/index.d.ts

@@ -1,2 +1,2 @@
-export { RefundStatus, RefundStatusCard } from './refund-status';
-export { defaultRefundStatusStrings, type RefundStatusCardProps, type RefundStatusProps, type RefundStatusStrings, type RefundStage, } from './types';
+export { RefundStatusCard } from './refund-status';
+export { defaultRefundStatusStrings, type RefundStatusCardProps, type RefundStatusStrings, type RefundStage, } from './types';

package/dist/components/blocks/commerce/refund-status/refund-status.d.ts

@@ -3,5 +3,3 @@ export declare function RefundStatusCard({ stage, amount, reason, method, eta, r
 export declare namespace RefundStatusCard {
     var displayName: string;
 }
-/** The source kit's name for `RefundStatusCard`; the same component. */
-export declare const RefundStatus: typeof RefundStatusCard;

package/dist/components/blocks/commerce/refund-status/types.d.ts

@@ -38,5 +38,3 @@ export interface RefundStatusCardProps extends Omit<ComponentPropsWithoutRef<'di
     /** Overrides this surface's own copy. */
     strings?: StringsProp<RefundStatusStrings>;
 }
-/** The source kit's name for `RefundStatusCardProps`. */
-export type RefundStatusProps = RefundStatusCardProps;

package/dist/components/blocks/commerce/seo-listing/types.d.ts

@@ -52,10 +52,17 @@ export interface SeoListingCardStrings {
     siteFallback: string;
     titleFallback: string;
     descriptionFallback: string;
+    /** Host shown in the preview breadcrumb when `baseUrl` is missing. Display only: it is never linked. */
     urlFallback: string;
     characters: string;
     maxLabel: string;
     targetLabel: string;
+    /** Writes the score out of 100. Defaults to `"<score>/100"`. */
+    formatScore?: (score: number) => string;
+    /** Writes a title or description length against its target range. Defaults to a sentence built from `characters` and `targetLabel`. */
+    formatLengthDetail?: (actual: number, min: number, max: number) => string;
+    /** Writes a permalink length against its maximum. Defaults to a sentence built from `characters` and `maxLabel`. */
+    formatMaxDetail?: (actual: number, max: number) => string;
     status: Record<SeoListingCheckStatus, string>;
     checkLabels: Record<SeoListingCheckId, string>;
     checkHints: Record<SeoListingCheckId, string>;

package/dist/components/blocks/commerce/shared/code-entry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Private anatomy shared by the commerce code-entry blocks (`CouponInputCard`,
+ * `VoucherEntry`): the success row an accepted code renders in, and the focus
+ * hand-over between the entry form and that row.
+ *
+ * Swapping states unmounts the control the user was on. Without a hand-over
+ * focus falls to `<body>`, and a keyboard or screen-reader user restarts from
+ * the top of the page.
+ */
+import { type ReactNode, type Ref } from 'react';
+type CodeEntryState = 'entry' | 'applied';
+/**
+ * Moves focus across the entry/applied swap, but only for a swap the user
+ * caused from inside the block (or one that removed the element they were on).
+ * A code applied from elsewhere on the page never pulls focus here.
+ */
+export declare function useCodeEntryFocus(applied: boolean): {
+    rootRef: import("react").RefObject<HTMLDivElement | null>;
+    fieldRef: import("react").RefObject<HTMLInputElement | null>;
+    removeRef: import("react").RefObject<HTMLButtonElement | null>;
+    rowRef: import("react").RefObject<HTMLDivElement | null>;
+    expect: (next: CodeEntryState) => void;
+};
+export interface AppliedCodeRowProps {
+    /** Code and applied label, laid out by the owning block. */
+    children: ReactNode;
+    /** Trailing amount: the discount or the remaining balance. */
+    amount?: ReactNode;
+    onRemove?: () => void;
+    /** Accessible name of the remove control. */
+    removeLabel: string;
+    removeRef?: Ref<HTMLButtonElement>;
+    rowRef?: Ref<HTMLDivElement>;
+    /** Merged onto the content column. */
+    contentClassName?: string;
+}
+/** The success-tinted row an accepted code renders in. */
+export declare function AppliedCodeRow({ children, amount, onRemove, removeLabel, removeRef, rowRef, contentClassName, }: AppliedCodeRowProps): import("react").JSX.Element;
+export {};

package/dist/components/blocks/commerce/shared/order-status.d.ts

@@ -22,7 +22,7 @@ export type TransactionStatus = 'success' | 'pending' | 'failure';
 export declare const transactionStatusTone: Record<TransactionStatus, BadgeTone>;
 /** Kinds that take money out of the merchant. They set the sign; callers pass the magnitude. */
 export declare const outgoingTransactionKinds: ReadonlySet<TransactionKind>;
-/** A postal address as an order carries it. `AddressCard` keeps its own flat props. */
+/** A postal address as an order carries it. `OrderCustomer` and `AddressCard` take the same shape. */
 export interface OrderAddress {
     /** Recipient. */
     name?: string;

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

@@ -1,5 +1,5 @@
 import { type SubscriptionSummaryCardProps } from './types';
-export declare function SubscriptionSummaryCard({ planName, priceLabel, cycleLabel, nextBillingDate, statusLabel, perks, onManage, onUpgrade, className, strings: stringsProp, }: SubscriptionSummaryCardProps): import("react").JSX.Element;
+export declare function SubscriptionSummaryCard({ planName, priceLabel, cycleLabel, nextBillingDate, statusLabel, statusTone, perks, onManage, onUpgrade, surface, padding, headerDivider, className, strings: stringsProp, }: SubscriptionSummaryCardProps): import("react").JSX.Element;
 export declare namespace SubscriptionSummaryCard {
     var displayName: string;
 }

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

@@ -1,4 +1,6 @@
 import type { LucideIcon } from 'lucide-react';
+import type { BadgeTone } from '../../../base/badge';
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export interface SubscriptionPerk {
     /** Leading glyph. */
@@ -17,7 +19,8 @@ export interface SubscriptionSummaryStrings {
     upgrade: string;
 }
 export declare const defaultSubscriptionSummaryStrings: SubscriptionSummaryStrings;
-export interface SubscriptionSummaryCardProps {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface SubscriptionSummaryCardProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Name of the subscribed plan. */
     planName: string;
     /** Formatted recurring price. */
@@ -28,6 +31,12 @@ export interface SubscriptionSummaryCardProps {
     nextBillingDate: string;
     /** Current subscription state. */
     statusLabel?: string;
+    /**
+     * Badge tone for the status chip. The label is the consumer's copy, so the
+     * block cannot infer whether it is good news: pass `success` for an active
+     * plan, `warning` or `destructive` for past due or cancelled. @default 'neutral'
+     */
+    statusTone?: BadgeTone;
     /** Benefits included in the plan. */
     perks?: SubscriptionPerk[];
     onManage?: () => void;

package/dist/components/blocks/commerce/upcoming-booking/index.d.ts

@@ -1,2 +1,3 @@
 export { UpcomingBookingRow } from './upcoming-booking';
-export type { BookingEntry, UpcomingBookingRowProps } from './types';
+export { defaultUpcomingBookingStrings } from './types';
+export type { BookingEntry, UpcomingBookingRowProps, UpcomingBookingStrings } from './types';

package/dist/components/blocks/commerce/upcoming-booking/types.d.ts

@@ -1,5 +1,6 @@
 import type { Locale } from 'date-fns';
 import type { DateBlockTone, DateBlockVariant } from '../../../base/display/date-block';
+import type { StringsProp } from '../../../../lib/strings';
 /** Booking entry with a locale-aware date value rendered by `DateBlock`. */
 export interface BookingEntry {
     /** Stable identity for this entry. */
@@ -13,9 +14,16 @@ export interface BookingEntry {
     /** Pre-formatted amount (e.g. "120 BGN"). */
     amount: string;
 }
+export interface UpcomingBookingStrings {
+    /** Shown when there are no bookings to list. */
+    empty: string;
+}
+export declare const defaultUpcomingBookingStrings: UpcomingBookingStrings;
 export interface UpcomingBookingRowProps {
     /** Bookings to list, soonest first. */
     bookings: BookingEntry[];
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<UpcomingBookingStrings>;
     /** Merged onto the outermost node. */
     className?: string;
     /** Locale for DateBlock formatting (date-fns). */

package/dist/components/blocks/commerce/upcoming-booking/upcoming-booking.d.ts

@@ -1,5 +1,5 @@
-import type { UpcomingBookingRowProps } from './types';
-export declare function UpcomingBookingRow({ bookings, className, locale, dateTone, dateVariant, timePlacement, }: UpcomingBookingRowProps): import("react").JSX.Element;
+import { type UpcomingBookingRowProps } from './types';
+export declare function UpcomingBookingRow({ bookings, className, locale, dateTone, dateVariant, timePlacement, strings: stringsProp, }: UpcomingBookingRowProps): import("react").JSX.Element;
 export declare namespace UpcomingBookingRow {
     var displayName: string;
 }

package/dist/components/blocks/commerce/vendor-profile/types.d.ts

@@ -1,4 +1,4 @@
-import type { SmartCardSurface } from '../../../base/cards';
+import type { CardSurface } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 import type { ReactNode } from 'react';
 import type { SemanticTone } from '../../../../lib/component-vocabulary';
@@ -77,12 +77,11 @@ export interface VendorProfileCardProps {
     /** Shows the engagement action and delegates its behavior to the consumer. */
     onHire?: () => void;
     /**
-     * Card surface override. Defaults through the shared SmartCard configuration.
+     * Card surface override. Defaults through the shared Card configuration.
      * `flat` also drops the dossier's own insets, so the embedding surface owns them.
      */
-    surface?: SmartCardSurface;
-    /** Card density override. Defaults through the shared SmartCard configuration. */
-    /** Additional classes applied to the outer SmartCard element. */
+    surface?: CardSurface;
+    /** Additional classes applied to the outer Card element. */
     className?: string;
     /** Deep-partial localized label overrides. */
     strings?: StringsProp<VendorProfileStrings>;

package/dist/components/blocks/commerce/voucher-entry/types.d.ts

@@ -1,3 +1,4 @@
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export interface VoucherEntryStrings {
     /** Surface title. */
@@ -10,16 +11,18 @@ export interface VoucherEntryStrings {
     /** Formatted remaining value on the voucher. */
     balance: string;
     applied: string;
+    /** Error copy used when `error` is passed as `true`. */
     notFound: string;
 }
 export declare const defaultVoucherEntryStrings: VoucherEntryStrings;
-export interface VoucherEntryProps {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface VoucherEntryProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Voucher currently applied, if any. */
     appliedCode?: string;
     /** Formatted remaining value on the voucher. */
     balance?: string;
-    /** Validation message for a rejected code. */
-    error?: string;
+    /** Validation message for a rejected code. `true` shows `strings.notFound`. */
+    error?: string | boolean;
     /** Whether a code is being checked. */
     loading?: boolean;
     /** Fired with the trimmed, upper-cased code when the form is submitted. */