themelia-react-ui 2.0.0 → 2.0.2

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-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, surface, padding, headerDivider, 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;
+}

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

@@ -1,6 +1,9 @@
+import type { ComponentPropsWithoutRef } from 'react';
 import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export type PaymentBrand = 'visa' | 'mastercard' | 'amex' | 'paypal' | 'applepay' | 'googlepay' | 'unknown';
+/** `card` draws the card face; `row` the compact identity row. */
+export type PaymentMethodVariant = 'card' | 'row';
 export interface PaymentMethodStrings {
     /** Surface title. */
     title: string;
@@ -8,10 +11,14 @@ export interface PaymentMethodStrings {
     cardHolder: string;
     expires: string;
     change: string;
+    /** Each brand's name as it is read aloud and shown in the `row` form. */
+    brands: Record<PaymentBrand, string>;
+    /** Names the method without reading the number aloud: "Visa ending 4242". */
+    formatCard: (brand: string, last4: string) => string;
 }
 export declare const defaultPaymentMethodStrings: PaymentMethodStrings;
 /** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
-export interface PaymentMethodProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
+export interface PaymentMethodProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title' | 'onChange'>, Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Card network or wallet. */
     brand: PaymentBrand;
     /** Last four digits, the only card number this component accepts. */
@@ -28,8 +35,12 @@ export interface PaymentMethodProps extends Pick<CardProps, 'surface' | 'padding
      * request to open your own method picker.
      */
     onChange?: () => void;
+    /** `card` (default) draws the card face; `row` the compact identity row. */
+    variant?: PaymentMethodVariant;
     /** Merged onto the outermost node. */
     className?: string;
     /** 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/refund-status/index.d.ts

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

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

@@ -1,5 +1,7 @@
 import { type RefundStatusCardProps } from './types';
-export declare function RefundStatusCard({ stage, amount, reason, method, eta, requestedAt, className, strings: stringsProp, }: RefundStatusCardProps): import("react").JSX.Element;
+export declare function RefundStatusCard({ stage, amount, reason, method, eta, requestedAt, className, strings: stringsProp, ...props }: RefundStatusCardProps): import("react").JSX.Element;
 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

@@ -1,3 +1,4 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
 import type { StringsProp } from '../../../../lib/strings';
 export type RefundStage = 'requested' | 'approved' | 'processing' | 'completed';
 export interface RefundStatusStrings {
@@ -17,15 +18,15 @@ export interface RefundStatusStrings {
     method: string;
 }
 export declare const defaultRefundStatusStrings: RefundStatusStrings;
-export interface RefundStatusCardProps {
+export interface RefundStatusCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
     /** How far the refund has progressed. */
     stage: RefundStage;
     /** Formatted refund amount. */
     amount: string;
     /** Why the refund was requested. */
-    reason?: string;
+    reason?: ReactNode;
     /** Where the money is being returned to. */
-    method?: string;
+    method?: ReactNode;
     /** Formatted estimate for the funds landing. */
     eta?: string;
     /** Formatted date the refund was raised. */
@@ -35,3 +36,5 @@ export interface RefundStatusCardProps {
     /** 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/shared/address-lines.d.ts

@@ -0,0 +1,21 @@
+/**
+ * AddressLines — the postal block shared by `AddressCard` and `OrderCustomer`.
+ *
+ * A real `<address>` (with the browser's italic reset), so assistive technology
+ * hears contact information rather than loose lines. The recipient leads, the
+ * street lines and the city line follow in the main role, and the country
+ * recedes; the city line joins only the parts that exist. A phone number, when
+ * the address carries one, closes the block as a `Phone` link.
+ *
+ * Internal to the commerce family: it is the address anatomy, not a public
+ * component.
+ */
+import type { ComponentPropsWithoutRef } from 'react';
+import type { OrderAddress } from './order-status';
+export interface AddressLinesProps extends Omit<ComponentPropsWithoutRef<'address'>, 'children'> {
+    /** The address to render. */
+    address: OrderAddress;
+    /** Sets the recipient in semibold, for a surface that leads on the name. */
+    prominent?: boolean;
+}
+export declare function AddressLines({ address, prominent, className, ...props }: AddressLinesProps): import("react").JSX.Element;

package/dist/components/blocks/commerce/shared/line-thumbnail.d.ts

@@ -0,0 +1,9 @@
+export interface LineThumbnailProps {
+    /** Image source. Optional: without one the initials show. */
+    src?: string;
+    /** Alternative text. Defaults to `title`. */
+    alt?: string;
+    /** The line's name, used for the initials and as the default alt text. */
+    title: string;
+}
+export declare function LineThumbnail({ src, alt, title }: LineThumbnailProps): import("react").JSX.Element;

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

@@ -0,0 +1,51 @@
+/**
+ * The order vocabularies the order surfaces share. Goods and money move
+ * independently ("refunded, still unfulfilled"), so an order carries two status
+ * axes. Each union has exactly one tone map, and no order surface takes a tone
+ * prop that could disagree with its status.
+ *
+ * Primary stays off every status chip: it is the one main command. A state the
+ * order is moving through reads `info`; a starting state that needs attention
+ * reads `warning`, not `destructive`.
+ */
+import type { BadgeTone } from '../../../base/badge';
+/** Where the goods are. */
+export type FulfillmentStatus = 'unfulfilled' | 'partiallyFulfilled' | 'fulfilled' | 'scheduled' | 'onHold' | 'cancelled';
+export declare const fulfillmentStatusTone: Record<FulfillmentStatus, BadgeTone>;
+/** Where the money is. */
+export type PaymentStatus = 'pending' | 'authorized' | 'paid' | 'partiallyRefunded' | 'refunded' | 'voided';
+export declare const paymentStatusTone: Record<PaymentStatus, BadgeTone>;
+/** What was attempted against the payment method. */
+export type TransactionKind = 'authorization' | 'capture' | 'sale' | 'refund' | 'void' | 'chargeback';
+/** Whether the attempt worked. */
+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. */
+export interface OrderAddress {
+    /** Recipient. */
+    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 words for both status axes. Tones stay derived from the status. */
+export interface OrderStatusVocabulary {
+    /** Label for each `FulfillmentStatus`. */
+    fulfillment: Record<FulfillmentStatus, string>;
+    /** Label for each `PaymentStatus`. */
+    payment: Record<PaymentStatus, string>;
+}
+export declare const defaultOrderStatusVocabulary: OrderStatusVocabulary;

package/dist/components/blocks/commerce/shipment-tracking/shipment-tracking.d.ts

@@ -1,5 +1,5 @@
 import { type ShipmentTrackingProps } from './types';
-export declare function ShipmentTracking({ trackingNumber, carrier, status, steps, details, className, strings: stringsProp, }: ShipmentTrackingProps): import("react").JSX.Element;
+export declare function ShipmentTracking({ trackingNumber, carrier, status, steps, details, onCopyTracking, className, strings: stringsProp, ...props }: ShipmentTrackingProps): import("react").JSX.Element;
 export declare namespace ShipmentTracking {
     var displayName: string;
 }

package/dist/components/blocks/commerce/shipment-tracking/types.d.ts

@@ -1,24 +1,43 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import type { BadgeTone } from '../../../base/badge';
 import type { StringsProp } from '../../../../lib/strings';
 /**
  * Transit stage. Drives the status label (through `strings`) and the tone of
- * the status dot, so a delayed shipment can never be painted as a healthy one.
+ * the status chip, so a delayed shipment can never be painted as a healthy one.
  */
 export type ShipmentStatus = 'pending' | 'in_transit' | 'delivered' | 'delayed';
-/** Dot tone per stage. Semantic state tokens only — never a raw palette colour. */
-export declare const shipmentStatusDotTone: Record<ShipmentStatus, string>;
+/**
+ * Chip tone per stage. `delayed` is a warning, not an error: the parcel is
+ * still coming. Primary stays off status chips.
+ */
+export declare const shipmentStatusTone: Record<ShipmentStatus, BadgeTone>;
 export interface TrackingStep {
+    /** Stable identity. Falls back to the label and position, so repeated labels never collide. */
+    id?: string;
     /** Display label. */
     label: string;
+    /**
+     * Whether the parcel has reached this checkpoint. The latest reached
+     * checkpoint stays current until the shipment is delivered.
+     */
     done: boolean;
+    /** Already formatted. When the checkpoint was reached: a parcel's rail is a log, not a plan. */
+    timestamp?: string;
 }
 export interface ShipmentDetail {
     /** Display label. */
     label: string;
-    value: string;
+    value: ReactNode;
 }
 export interface ShipmentTrackingStrings {
-    /** Accessible name for the surface. */
+    /** Surface title. */
     title: string;
+    /** Label of the tracking-number row. */
+    trackingNumber: string;
+    /** Label of the carrier row. */
+    carrier: string;
+    /** Accessible name of the copy button beside the tracking number. */
+    copyTrackingNumber: string;
     /** Status label for each `ShipmentStatus`. */
     pending: string;
     in_transit: string;
@@ -26,7 +45,7 @@ export interface ShipmentTrackingStrings {
     delayed: string;
 }
 export declare const defaultShipmentTrackingStrings: ShipmentTrackingStrings;
-export interface ShipmentTrackingProps {
+export interface ShipmentTrackingProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
     /** Carrier tracking reference. */
     trackingNumber: string;
     /** Carrier handling the shipment. */
@@ -37,6 +56,8 @@ export interface ShipmentTrackingProps {
     steps: TrackingStep[];
     /** Label/value facts about the shipment. */
     details?: ShipmentDetail[];
+    /** Fired after the tracking number is copied to the clipboard. */
+    onCopyTracking?: (trackingNumber: string) => void;
     /** Merged onto the outermost node. */
     className?: string;
     /** Overrides this surface's own copy. */

package/dist/components/blocks/commerce/summary-panel/amount-row.d.ts

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

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

@@ -0,0 +1,3 @@
+export { AmountRow } from './amount-row';
+export { SummaryPanel } from './summary-panel';
+export type { AmountRowProps, SummaryPanelProps } from './types';

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

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

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

@@ -0,0 +1,26 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+export interface AmountRowProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
+    /** What the amount is: "Subtotal", "Shipping". */
+    label: ReactNode;
+    /** Already formatted, including its currency. This row totals nothing itself. */
+    amount: string;
+    /** A rate or qualifier ("20%", "3 items") that sits quietly beside the amount. */
+    note?: ReactNode;
+    /** Marks the row the eye should land on: a total, an amount due. */
+    total?: boolean;
+    /**
+     * Money coming off the total. Rewrites whatever sign the caller passed to
+     * one U+2212 and sets the figure in success ink: a deduction reads as a gain
+     * to whoever is paying.
+     */
+    deduction?: boolean;
+    /**
+     * Rules this row off from the rows above it, for a grand total under the
+     * breakdown it rolls up. It is the only rule a ledger draws.
+     */
+    rollup?: boolean;
+}
+export interface SummaryPanelProps extends ComponentPropsWithoutRef<'div'> {
+    /** `AmountRow`s, top to bottom. */
+    children?: ReactNode;
+}

package/dist/components/blocks/commerce/tax-breakdown/tax-breakdown.d.ts

@@ -1,5 +1,5 @@
 import { type TaxBreakdownCardProps } from './types';
-export declare function TaxBreakdownCard({ subtotal, taxes, totalTax, total, className, strings: stringsProp, }: TaxBreakdownCardProps): import("react").JSX.Element;
+export declare function TaxBreakdownCard({ subtotal, taxes, totalTax, total, className, strings: stringsProp, ...props }: TaxBreakdownCardProps): import("react").JSX.Element;
 export declare namespace TaxBreakdownCard {
     var displayName: string;
 }

package/dist/components/blocks/commerce/tax-breakdown/types.d.ts

@@ -1,3 +1,4 @@
+import type { ComponentPropsWithoutRef } from 'react';
 import type { StringsProp } from '../../../../lib/strings';
 export interface TaxLineItem {
     /** Stable identity for this entry. */
@@ -18,7 +19,7 @@ export interface TaxBreakdownStrings {
     total: string;
 }
 export declare const defaultTaxBreakdownStrings: TaxBreakdownStrings;
-export interface TaxBreakdownCardProps {
+export interface TaxBreakdownCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
     /** Formatted amount before tax. */
     subtotal: string;
     /** Individual tax lines making up the total. */

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

@@ -6,15 +6,18 @@
  *  - `inline`: label sits immediately before the value, separator-style.
  *  - `stacked`: label above (xs secondary), value below (md).
  *
- * `mono` switches the value to the monospace identifier role (references,
- * codes, keys). Amounts, counts, percentages and dates stay in the sans UI
- * font: pass `valueClassName="tabular-nums"` (or a value primitive such as
- * `Money` / `Percent`, which are already tabular) when figures should align.
- * Use `valueClassName` for one-off colour/weight overrides; the surrounding
- * row is intentionally plain so consumers can stack many of these without
- * visual clutter.
+ * The value takes the shared `Value` text role at the provider text size.
+ * `valueWeight` emphasises a fact or a total through that role. `mono`
+ * switches the value to the monospace identifier role (references, codes,
+ * keys). Amounts, counts, percentages and dates stay in the sans UI font: pass
+ * `valueClassName="tabular-nums"` (or a value primitive such as `Money` /
+ * `Percent`, which are already tabular) when figures should align. Keep
+ * `valueClassName` for layout (alignment, truncation, figures); the
+ * surrounding row is intentionally plain so consumers can stack many of these
+ * without visual clutter.
  */
 import type { ReactNode } from 'react';
+import { type ValueProps } from '../../../primitives';
 export type InlineStatLayout = 'between' | 'inline' | 'stacked';
 export interface InlineStatProps {
     /** Display label. Scalar labels use DisplayLabel; rich content owns its typography. */
@@ -25,6 +28,11 @@ export interface InlineStatProps {
     layout?: InlineStatLayout;
     /** Renders the value in tabular monospace figures. */
     mono?: boolean;
+    /**
+     * Weight of the value's text role. Defaults to the role weight: regular, or
+     * medium with `mono`. Use `medium` for emphasised facts and `semibold` for totals.
+     */
+    valueWeight?: ValueProps['weight'];
     /** Merged onto the outermost node. */
     className?: string;
     /** Merged onto the label. */
@@ -32,7 +40,7 @@ export interface InlineStatProps {
     /** Merged onto the value. */
     valueClassName?: string;
 }
-export declare function InlineStat({ label, value, layout, mono, className, labelClassName, valueClassName, }: InlineStatProps): import("react").JSX.Element;
+export declare function InlineStat({ label, value, layout, mono, valueWeight, className, labelClassName, valueClassName, }: InlineStatProps): import("react").JSX.Element;
 export declare namespace InlineStat {
     var displayName: string;
 }

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

@@ -1,4 +1,30 @@
-export { MetadataList } from './metadata-list';
-export type { MetadataDensity, MetadataInlineListItem, MetadataLayout, MetadataListItem, MetadataListProps, } from './metadata-list';
-export { MetadataValue } from './metadata-value';
-export type { MetadataValueDescriptor, MetadataValueKind, MetadataValueProps, } from './metadata-value';
+/**
+ * Deprecated compatibility path.
+ *
+ * MetadataList is a base structure, not a block: it composes typography,
+ * primitives and base display parts. It moved to
+ * `themelia-react-ui/base/metadata-list`; these re-exports keep existing
+ * `themelia-react-ui/blocks/data-display` imports working through 2.x.
+ */
+export { 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataList, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataValue, } from '../../../base/metadata-list';
+export type { 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataDensity, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataInlineListItem, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataLayout, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataListItem, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataListProps, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataValueDescriptor, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataValueKind, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataValueProps, } from '../../../base/metadata-list';