themelia-react-ui 1.0.2 → 2.0.1

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

@@ -7,7 +7,7 @@ export interface BookingCalendarEventCardItem {
     label: ReactNode;
     /** Display value. Strings and numbers use the canonical `Value` primitive. */
     value: ReactNode;
-    /** Span both detail columns and receive the emphasized note treatment. */
+    /** Span both detail columns, for a note that should not sit in a column. */
     fullWidth?: boolean;
 }
 /**
@@ -21,7 +21,7 @@ export interface BookingCalendarEventCardProps {
     title: ReactNode;
     /** Optional supporting context shown beneath the title. */
     description?: ReactNode;
-    /** Optional status or metadata rendered at the end of the header. */
+    /** Optional status, rendered beside the title. */
     status?: ReactNode;
     /** Ordered booking facts rendered as a responsive definition list. */
     items: BookingCalendarEventCardItem[];

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

@@ -1,5 +1,7 @@
 import { type CartSummaryCardProps } from './types';
-export declare function CartSummaryCard({ items, subtotal, tax, shipping, discount, total, onCheckout, className, strings: stringsProp, }: CartSummaryCardProps): import("react").JSX.Element;
+export declare function CartSummaryCard({ items, subtotal, tax, shipping, discount, total, onCheckout, className, strings: stringsProp, ...props }: CartSummaryCardProps): import("react").JSX.Element;
 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 { CartSummaryCard } from './cart-summary';
-export { defaultCartSummaryStrings, type CartSummaryCardProps, type CartSummaryStrings, type CartLineItem, } from './types';
+export { CartSummary, CartSummaryCard } from './cart-summary';
+export { defaultCartSummaryStrings, type CartSummaryCardProps, type CartSummaryProps, type CartSummaryStrings, type CartLineItem, } from './types';

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

@@ -1,3 +1,4 @@
+import type { ComponentPropsWithoutRef } from 'react';
 import type { StringsProp } from '../../../../lib/strings';
 export interface CartLineItem {
     /** Stable identity for this entry. */
@@ -30,9 +31,11 @@ export interface CartSummaryStrings {
     /** Formatted order total. */
     total: string;
     checkout: string;
+    /** Writes a line's quantity, so a translation owns the multiplication sign. */
+    formatQuantity: (quantity: number) => string;
 }
 export declare const defaultCartSummaryStrings: CartSummaryStrings;
-export interface CartSummaryCardProps {
+export interface CartSummaryCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
     /** Line items in the cart. */
     items: CartLineItem[];
     /** Formatted total before tax, shipping, and discounts. */
@@ -51,3 +54,5 @@ export interface CartSummaryCardProps {
     /** 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/discount-stack/discount-stack.d.ts

@@ -1,5 +1,7 @@
 import { type DiscountStackPreviewProps } from './types';
-export declare function DiscountStackPreview({ discounts, totalSavings, className, strings: stringsProp, }: DiscountStackPreviewProps): import("react").JSX.Element;
+export declare function DiscountStackPreview({ discounts, totalSavings, className, strings: stringsProp, ...props }: DiscountStackPreviewProps): import("react").JSX.Element;
 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 { DiscountStackPreview } from './discount-stack';
-export { defaultDiscountStackStrings, type Discount, type DiscountStackPreviewProps, type DiscountStackStrings, } from './types';
+export { DiscountStack, DiscountStackPreview } from './discount-stack';
+export { defaultDiscountStackStrings, type Discount, type DiscountStackPreviewProps, type DiscountStackProps, type DiscountStackStrings, } from './types';

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

@@ -1,12 +1,22 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
 import type { BadgeTone } from '../../../base/badge';
 import type { StringsProp } from '../../../../lib/strings';
 export interface Discount {
-    type: string;
+    /** Stable identity for this entry. Falls back to the kind, label and position. */
+    id?: string;
     /** Display label. */
     label: string;
+    /** Already formatted. Rendered as a deduction whatever sign it carries. */
     amount: string;
-    /** Chip rendered beside the label. */
-    badge: BadgeTone;
+    /** 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.
+     */
+    badge?: BadgeTone;
 }
 export interface DiscountStackStrings {
     /** Surface title. */
@@ -15,7 +25,7 @@ export interface DiscountStackStrings {
     totalSavings: string;
 }
 export declare const defaultDiscountStackStrings: DiscountStackStrings;
-export interface DiscountStackPreviewProps {
+export interface DiscountStackPreviewProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
     /** Discounts applied, in the order they stack. */
     discounts: Discount[];
     /** Formatted sum of every discount. */
@@ -25,3 +35,5 @@ export interface DiscountStackPreviewProps {
     /** 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

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

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

@@ -0,0 +1,2 @@
+export { FulfillmentGroup } from './fulfillment-group';
+export { defaultFulfillmentGroupStrings, type FulfillmentGroupProps, type FulfillmentGroupStrings, } from './types';

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

@@ -0,0 +1,43 @@
+import type { ComponentPropsWithoutRef, ComponentType, ReactNode } from 'react';
+import type { ActionMenuAction, ActionMenuProps } from '../../../base/action-menu';
+import type { StringsProp } from '../../../../lib/strings';
+import type { OrderLine, OrderLineItemStrings } from '../order-line-item/types';
+import { type FulfillmentStatus } from '../shared/order-status';
+export interface FulfillmentGroupStrings extends OrderLineItemStrings {
+    /** Label for each `FulfillmentStatus`. The tone stays derived from the status. */
+    fulfillment: Record<FulfillmentStatus, string>;
+    /** Names the group by state and size: "Unfulfilled (3)". */
+    formatHeading: (status: string, count: number) => string;
+    /** Accessible name of the overflow menu holding every action after the first. */
+    moreActions: string;
+}
+export declare const defaultFulfillmentGroupStrings: FulfillmentGroupStrings;
+export interface FulfillmentGroupProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
+    /** Where these goods are. Drives the heading chip's label and tone. */
+    status: FulfillmentStatus;
+    /** Where the group ships from. */
+    location?: ReactNode;
+    /** A standing fact about the group: "Shipping not required". */
+    notice?: ReactNode;
+    /**
+     * 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.
+     */
+    noticeIcon?: ComponentType<{
+        className?: string;
+    }>;
+    /** The rows, as data. The heading counts them. */
+    items?: OrderLine[];
+    /** Replaces `items` wholesale, for a caller who needs control of a row. The heading then carries no count. */
+    children?: ReactNode;
+    /**
+     * The group's commands. The first renders as a button and the rest collapse
+     * into an overflow menu: one array, so the menu never repeats the button.
+     * Mark the main command `tone: 'primary'`.
+     */
+    actions?: readonly ActionMenuAction[];
+    /** Renders `href` actions through the consumer's router. */
+    renderLink?: ActionMenuProps['renderLink'];
+    /** Overrides this surface's own copy, including the status words. */
+    strings?: StringsProp<FulfillmentGroupStrings>;
+}

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

@@ -4,8 +4,8 @@ export { Receipt, ReceiptItems, type ReceiptProps, type ReceiptItemsProps, type
 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, DiscountStackStrings } from './discount-stack';
-export { DiscountStackPreview, defaultDiscountStackStrings } from './discount-stack';
+export type { Discount, DiscountStackPreviewProps, DiscountStackProps, DiscountStackStrings } from './discount-stack';
+export { DiscountStack, 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 { RefundStatusCard, defaultRefundStatusStrings, type RefundStatusCardProps, type RefundStatusStrings, type RefundStage, } from './refund-status';
+export { RefundStatus, RefundStatusCard, defaultRefundStatusStrings, type RefundStatusProps, 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 { CartSummaryCard, defaultCartSummaryStrings, type CartSummaryCardProps, type CartSummaryStrings, type CartLineItem, } from './cart-summary';
+export { CartSummary, CartSummaryCard, defaultCartSummaryStrings, type CartSummaryProps, 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, defaultPaymentMethodStrings, type PaymentMethodProps, type PaymentMethodStrings, type PaymentBrand, } from './payment-method';
+export { PaymentMethod, PaymentMethodCard, defaultPaymentMethodStrings, type PaymentMethodCardProps, 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 } from './invoice-mini';
 export { InvoiceMini } from './invoice-mini';
@@ -32,3 +32,11 @@ export { OrderTimeline } from './order-timeline';
 export type { PaymentEvent, PaymentTimelineProps } from './payment-timeline';
 export { PaymentTimeline } from './payment-timeline';
 export { InventorySectionCard, defaultInventorySectionStrings, type InventoryPolicy, type InventorySectionCardProps, type InventorySectionChange, type InventorySectionField, type InventorySectionMetric, type InventorySectionName, type InventorySectionStrings, type InventorySectionValue, type InventoryStatus, } from './inventory-section';
+export { AmountRow, SummaryPanel, type AmountRowProps, type SummaryPanelProps } from './summary-panel';
+export type { FulfillmentStatus, OrderAddress, PaymentStatus, TransactionKind, TransactionStatus, } from './shared/order-status';
+export { OrderHeader, defaultOrderHeaderStrings, type OrderHeaderProps, type OrderHeaderStrings, } from './order-header';
+export { FulfillmentGroup, defaultFulfillmentGroupStrings, type FulfillmentGroupProps, type FulfillmentGroupStrings, } from './fulfillment-group';
+export { OrderLineItem, defaultOrderLineItemStrings, type OrderLine, type OrderLineItemProps, type OrderLineItemStrings, type OrderLineProperty, } from './order-line-item';
+export { OrderSummary, defaultOrderSummaryStrings, type OrderSummaryProps, type OrderSummaryStrings, type SummaryLine, } from './order-summary';
+export { OrderTransactions, defaultOrderTransactionsStrings, type OrderTransactionsProps, type OrderTransactionsStrings, type Transaction, } from './order-transactions';
+export { OrderCustomer, defaultOrderCustomerStrings, type OrderCustomerProps, type OrderCustomerStrings, } from './order-customer';

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

@@ -36,7 +36,10 @@ export interface InventorySectionMetric {
     value: string;
     /** Supporting copy shown under the label. */
     description?: string;
-    /** Semantic tone driving the entry's colour. */
+    /**
+     * 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 {

package/dist/components/blocks/commerce/invoice-header/invoice-header.d.ts

@@ -1,5 +1,5 @@
 import { type InvoiceHeaderProps } from './types';
-export declare function InvoiceHeader({ invoiceNumber, status, statusTone, from, to, issuedDate, dueDate, amount, className, strings: stringsProp, }: InvoiceHeaderProps): import("react").JSX.Element;
+export declare function InvoiceHeader({ invoiceNumber, status, statusTone, from, to, issuedDate, dueDate, amount, className, strings: stringsProp, ...props }: InvoiceHeaderProps): import("react").JSX.Element;
 export declare namespace InvoiceHeader {
     var displayName: string;
 }

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

@@ -1,10 +1,12 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
 import type { BadgeTone } from '../../../base/badge';
 import type { StringsProp } from '../../../../lib/strings';
 import type { InvoiceStatus } from '../invoice-mini/types';
 export interface InvoiceParty {
     /** Display name. */
     name: string;
-    location?: string;
+    /** Where the party is: a city line, or a node such as a full address. */
+    location?: ReactNode;
 }
 export interface InvoiceHeaderStrings {
     /** Surface title. */
@@ -20,7 +22,7 @@ export interface InvoiceHeaderStrings {
     overdue: string;
 }
 export declare const defaultInvoiceHeaderStrings: InvoiceHeaderStrings;
-export interface InvoiceHeaderProps {
+export interface InvoiceHeaderProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
     /** Human-facing invoice reference. */
     invoiceNumber: string;
     /**

package/dist/components/blocks/commerce/invoice-mini/invoice-mini.d.ts

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

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

@@ -1,3 +1,4 @@
+import type { ComponentPropsWithoutRef } from 'react';
 import type { BadgeTone } from '../../../base/badge';
 import type { StringsProp } from '../../../../lib/strings';
 export type InvoiceStatus = 'paid' | 'pending' | 'overdue';
@@ -17,7 +18,7 @@ export interface InvoiceMiniStrings {
     due: string;
 }
 export declare const defaultInvoiceMiniStrings: InvoiceMiniStrings;
-export interface InvoiceMiniProps {
+export interface InvoiceMiniProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
     /** The invoice to summarise. */
     invoice: InvoiceMiniData;
     /** Merged onto the outermost node. */

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

@@ -20,7 +20,7 @@ export interface LoyaltyPointsProps {
     balance: number | string;
     /** Membership tier name. Defaults to `strings.tier`. */
     tier?: string;
-    /** Badge tone for the tier chip. @default 'warning' */
+    /** Badge tone for the tier chip. A tier is a kind, not a status. @default 'neutral' */
     tierTone?: BadgeTone;
     /** Recent point movements. */
     history?: LoyaltyHistoryEntry[];

package/dist/components/blocks/commerce/order-customer/index.d.ts

@@ -0,0 +1,2 @@
+export { OrderCustomer } from './order-customer';
+export { defaultOrderCustomerStrings, type OrderCustomerProps, type OrderCustomerStrings, } from './types';

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

@@ -0,0 +1,5 @@
+import { type OrderCustomerProps } from './types';
+export declare function OrderCustomer({ name, email, phone, orderCount, shippingAddress, billingAddress, billingSameAsShipping, onOpenCustomer, onEditShipping, onEditBilling, surface, padding, headerDivider, className, strings: stringsProp, ...props }: OrderCustomerProps): import("react").JSX.Element;
+export declare namespace OrderCustomer {
+    var displayName: string;
+}

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

@@ -0,0 +1,48 @@
+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 interface OrderCustomerStrings {
+    /** Surface title. */
+    title: string;
+    shippingAddress: string;
+    billingAddress: string;
+    /**
+     * One name per edit button: each is the accessible name of a glyph with no
+     * text beside it, and a single "Edit" would announce two controls alike.
+     */
+    editShipping: string;
+    editBilling: string;
+    /** Shown in place of a repeated billing address. */
+    sameAsShipping: string;
+    /** Shown when an address is missing. */
+    noAddress: string;
+    /** How many orders the customer has placed, this one included. */
+    formatOrderCount: (count: number) => string;
+}
+export declare const defaultOrderCustomerStrings: OrderCustomerStrings;
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface OrderCustomerProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'>, Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
+    /** The customer's display name. */
+    name: string;
+    /** Contact email, rendered as a mail link. */
+    email?: string;
+    /** Contact number, rendered as a call link. */
+    phone?: string;
+    /** How many orders this customer has placed, this one included. */
+    orderCount?: number;
+    /** Where the order ships. */
+    shippingAddress?: OrderAddress;
+    /** Where the order is billed. */
+    billingAddress?: OrderAddress;
+    /** Renders one line in place of a repeated billing address. */
+    billingSameAsShipping?: boolean;
+    /** Turns the identity row into a button. The app decides whether it navigates or opens a panel. */
+    onOpenCustomer?: () => void;
+    /** Shows an edit button on the shipping address. */
+    onEditShipping?: () => void;
+    /** Shows an edit button on the billing address. */
+    onEditBilling?: () => void;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<OrderCustomerStrings>;
+}

package/dist/components/blocks/commerce/order-header/index.d.ts

@@ -0,0 +1,2 @@
+export { OrderHeader } from './order-header';
+export { defaultOrderHeaderStrings, type OrderHeaderProps, type OrderHeaderStrings, } from './types';

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

@@ -0,0 +1,5 @@
+import { type OrderHeaderProps } from './types';
+export declare function OrderHeader({ orderNumber, fulfillmentStatus, paymentStatus, placedAt, source, actions, renderLink, headingTag, className, strings: stringsProp, ...props }: OrderHeaderProps): import("react").JSX.Element;
+export declare namespace OrderHeader {
+    var displayName: string;
+}

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

@@ -0,0 +1,37 @@
+import type { ComponentPropsWithoutRef } from 'react';
+import type { ActionMenuAction, ActionMenuProps } from '../../../base/action-menu';
+import type { HeadingTag } from '../../../typography';
+import type { StringsProp } from '../../../../lib/strings';
+import { type FulfillmentStatus, type OrderStatusVocabulary, type PaymentStatus } from '../shared/order-status';
+export interface OrderHeaderStrings extends OrderStatusVocabulary {
+    /** Writes the order's own reference: "#1036". */
+    formatOrderNumber: (orderNumber: string) => string;
+    /** Joins when the order was placed to where it came from. */
+    formatOrigin: (placedAt: string, source: string) => string;
+    /** Accessible name of the actions menu trigger. */
+    moreActions: string;
+}
+export declare const defaultOrderHeaderStrings: OrderHeaderStrings;
+export interface OrderHeaderProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
+    /** The order's reference, without the leading sign `formatOrderNumber` adds. */
+    orderNumber: string;
+    /** Where the goods are. Independent of payment. */
+    fulfillmentStatus?: FulfillmentStatus;
+    /**
+     * Where the money is. Both statuses, one, or neither read correctly: an
+     * order with nothing to ship has no fulfillment state to state.
+     */
+    paymentStatus?: PaymentStatus;
+    /** Already formatted. */
+    placedAt?: string;
+    /** Where the order came from: a channel, an app, an import. */
+    source?: string;
+    /** Order commands, offered from one actions menu at the end of the title row. */
+    actions?: readonly ActionMenuAction[];
+    /** Renders `href` actions through the consumer's router. */
+    renderLink?: ActionMenuProps['renderLink'];
+    /** Heading level of the order number. Defaults to `h1`: the order is the page's subject. */
+    headingTag?: HeadingTag;
+    /** Overrides this header's own copy, including the status words. */
+    strings?: StringsProp<OrderHeaderStrings>;
+}

package/dist/components/blocks/commerce/order-line-item/index.d.ts

@@ -0,0 +1,2 @@
+export { OrderLineItem } from './order-line-item';
+export { defaultOrderLineItemStrings, type OrderLine, type OrderLineItemProps, type OrderLineItemStrings, type OrderLineProperty, } from './types';

package/dist/components/blocks/commerce/order-line-item/order-line-item.d.ts

@@ -0,0 +1,5 @@
+import { type OrderLineItemProps } from './types';
+export declare function OrderLineItem({ id, title, variantTitle, sku, imageSrc, imageAlt, unitPrice, quantity, total, properties, children, className, strings: stringsProp, ...props }: OrderLineItemProps): import("react").JSX.Element;
+export declare namespace OrderLineItem {
+    var displayName: string;
+}

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

@@ -0,0 +1,46 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import type { StringsProp } from '../../../../lib/strings';
+/** A per-line fact the kit did not anticipate: a gift message, an engraving, an interval. */
+export interface OrderLineProperty {
+    /** What the fact is. */
+    label: ReactNode;
+    /** The fact itself. */
+    value: ReactNode;
+}
+/** One line of ordered goods, as data. */
+export interface OrderLine {
+    /** Stable identity for this line. */
+    id: string;
+    /** Product name. */
+    title: string;
+    /** The chosen option: "OS / blue". */
+    variantTitle?: string;
+    /** Stock-keeping unit, shown as an identifier. */
+    sku?: string;
+    /** Product image. Without one, or when it fails to load, the line's initials show. */
+    imageSrc?: string;
+    /** Alternative text for the image. Defaults to the title. */
+    imageAlt?: string;
+    /** Already formatted, including its currency. */
+    unitPrice: string;
+    /** Units ordered. */
+    quantity: number;
+    /**
+     * Already formatted. Passed, never multiplied: discounts, tax and proration
+     * break `unitPrice × quantity`.
+     */
+    total: string;
+    /** Per-line custom data, rendered as label/value pairs under the title. */
+    properties?: OrderLineProperty[];
+    /** Whatever `properties` cannot express, under them. */
+    children?: ReactNode;
+}
+export interface OrderLineItemStrings {
+    /** Reads the price column aloud: "€50.00 × 1". */
+    formatUnitPrice: (unitPrice: string, quantity: number) => string;
+}
+export declare const defaultOrderLineItemStrings: OrderLineItemStrings;
+export interface OrderLineItemProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'id' | 'title'>, OrderLine {
+    /** Overrides this row's own copy. */
+    strings?: StringsProp<OrderLineItemStrings>;
+}

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

@@ -11,9 +11,13 @@ export interface OrderStatusEvent {
 export interface OrderStatusStrings {
     /** Surface title. */
     title: 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;
 }
 export declare const defaultOrderStatusStrings: OrderStatusStrings;

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

@@ -0,0 +1,2 @@
+export { OrderSummary } from './order-summary';
+export { defaultOrderSummaryStrings, type OrderSummaryProps, type OrderSummaryStrings, type SummaryLine, } from './types';

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

@@ -0,0 +1,5 @@
+import { type OrderSummaryProps } from './types';
+export declare function OrderSummary({ goods, total, payments, paymentStatus, alert, surface, padding, headerDivider, className, strings: stringsProp, ...props }: OrderSummaryProps): import("react").JSX.Element;
+export declare namespace OrderSummary {
+    var displayName: string;
+}

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

@@ -0,0 +1,42 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import type { CardProps } from '../../../base/cards';
+import type { StringsProp } from '../../../../lib/strings';
+import { type PaymentStatus } from '../shared/order-status';
+/** One row of an order's money ledger. */
+export interface SummaryLine {
+    /** Stable identity. Falls back to the row's position. */
+    id?: string;
+    /** What the amount is: "Subtotal", "Paid". */
+    label: ReactNode;
+    /** A count or rate beside the amount: "3 items", "20%". */
+    note?: ReactNode;
+    /** Already formatted, including its currency. */
+    amount: string;
+    /** Money off the customer's total, shown with one U+2212 in success ink. */
+    deduction?: boolean;
+}
+export interface OrderSummaryStrings {
+    /** Surface title. */
+    title: string;
+    /** Label for each `PaymentStatus`. The tone stays derived from the status. */
+    payment: Record<PaymentStatus, string>;
+}
+export declare const defaultOrderSummaryStrings: OrderSummaryStrings;
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface OrderSummaryProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'>, Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
+    /** What was ordered: subtotal, discount, shipping, tax. */
+    goods: SummaryLine[];
+    /** The line the eye should land on, closing the goods ledger. */
+    total: SummaryLine;
+    /** What has actually moved: paid, refunded, balance. A separate ledger from the goods. */
+    payments?: SummaryLine[];
+    /** Where the money is, as a chip beside the title. */
+    paymentStatus?: PaymentStatus;
+    /**
+     * Standing information about the balance, below the ledgers as a warning
+     * note (`role="note"`): a caveat, not an error.
+     */
+    alert?: ReactNode;
+    /** Overrides this surface's own copy, including the status words. */
+    strings?: StringsProp<OrderSummaryStrings>;
+}

package/dist/components/blocks/commerce/order-transactions/index.d.ts

@@ -0,0 +1,2 @@
+export { OrderTransactions } from './order-transactions';
+export { defaultOrderTransactionsStrings, type OrderTransactionsProps, type OrderTransactionsStrings, type Transaction, } from './types';

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

@@ -0,0 +1,5 @@
+import { type OrderTransactionsProps } from './types';
+export declare function OrderTransactions({ transactions, surface, padding, headerDivider, className, strings: stringsProp, ...props }: OrderTransactionsProps): import("react").JSX.Element;
+export declare namespace OrderTransactions {
+    var displayName: string;
+}

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

@@ -0,0 +1,46 @@
+import type { ComponentPropsWithoutRef } from 'react';
+import type { CardProps } from '../../../base/cards';
+import type { StringsProp } from '../../../../lib/strings';
+import type { TransactionKind, TransactionStatus } from '../shared/order-status';
+/** One attempt against a payment method. */
+export interface Transaction {
+    /** Stable identity for this entry. */
+    id: string;
+    /** What was attempted. Sets the sign: refunds, voids and chargebacks take money out. */
+    kind: TransactionKind;
+    /** Whether it worked. */
+    status: TransactionStatus;
+    /** The magnitude, already formatted. The sign comes from `kind`. */
+    amount: string;
+    /** Already formatted. */
+    processedAt: string;
+    /** How it was taken: "Visa ending 4417", "PayPal". */
+    method?: string;
+    /** The gateway's own identifier. Monospace: it is compared and copied, not read. */
+    reference?: string;
+    /** Which gateway processed it. */
+    gateway?: string;
+}
+export interface OrderTransactionsStrings {
+    /** Surface title. */
+    title: string;
+    /** Label for each `TransactionKind`. */
+    kind: Record<TransactionKind, string>;
+    /** Chip label for each `TransactionStatus`. A successful attempt shows none. */
+    status: Record<TransactionStatus, string>;
+    /** Spoken before a gateway reference. */
+    reference: string;
+    /** Shown, and announced, when there is nothing in the ledger. */
+    empty: string;
+}
+export declare const defaultOrderTransactionsStrings: OrderTransactionsStrings;
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface OrderTransactionsProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'>, Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
+    /**
+     * Every attempt, oldest first. A failed attempt stays listed: an order that
+     * shows only what worked cannot answer why it was never captured.
+     */
+    transactions: Transaction[];
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<OrderTransactionsStrings>;
+}

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

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

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

@@ -1,5 +1,13 @@
 import { type PaymentMethodProps } from './types';
-export declare function PaymentMethod({ brand, last4, expiry, holderName, default: defaultMethod, onChange, className, strings: stringsProp, }: PaymentMethodProps): import("react").JSX.Element;
+export declare function PaymentMethod({ brand, last4, expiry, holderName, default: defaultMethod, onChange, variant, surface, padding, headerDivider, className, strings: stringsProp, ...props }: PaymentMethodProps): import("react").JSX.Element;
 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;
+}