themelia-ui 1.0.0

package/dist/components/admin/patterns/commerce/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Commerce blocks — carts, invoices, orders, and the customer's own record.
+ *
+ * Two rules run through the whole domain. **Amounts arrive already formatted**, because
+ * the surface that knows the currency, the locale and the rounding is the one that fetched
+ * the money — the exception is `InvoiceLineItems`, which takes numbers because it is the
+ * one surface that does arithmetic. And **a status chip derives its tone from its status**,
+ * with no override: the source kit let a caller pass one, defaulted it to `success`, and
+ * shipped a test recording that an overdue invoice therefore rendered green.
+ */
+export { CartSummary, TaxBreakdown, DiscountStack, type CartSummaryProps, type CartLine, type TaxBreakdownProps, type TaxLine, type DiscountStackProps, type Discount, CodeEntry, type CodeEntryProps, type CodeEntryKind, } from './cart.js';
+export { OrderStatusCard, OrderTimeline, PaymentTimeline, ShipmentTracking, RefundStatus, type OrderStatusCardProps, type OrderEvent, type OrderTimelineProps, type OrderTimelineEvent, type PaymentTimelineProps, type PaymentEvent, type ShipmentTrackingProps, type TrackingStep, type ShipmentDetail, type RefundStatusProps, } from './order.js';
+export { InvoiceHeader, InvoiceLineItems, InvoiceMini, type InvoiceHeaderProps, type InvoiceParty, type InvoiceLineItemsProps, type InvoiceLine, type InvoiceMiniProps, } from './invoice.js';
+export { AddressCard, PaymentMethodCard, SubscriptionSummary, InventoryLevel, type AddressCardProps, type PaymentMethodCardProps, type SubscriptionSummaryProps, type SubscriptionPerk, type InventoryLevelProps, } from './account.js';
+export { AmountRow, SummaryPanel, type AmountRowProps, type SummaryPanelProps } from './summary-panel.js';
+export { formatDeduction, stripLeadingMinus, MINUS_SIGN } from './format-amount.js';
+export { INVOICE_STATUS_TONE, ORDER_STATUS_TONE, SHIPMENT_STATUS_TONE, REFUND_STAGES, FULFILLMENT_STATUS_TONE, PAYMENT_STATUS_TONE, TRANSACTION_STATUS_TONE, OUTGOING_TRANSACTION_KINDS, type InvoiceStatus, type OrderStatus, type ShipmentStatus, type RefundStage, type PaymentBrand, type AddressKind, type FulfillmentStatus, type PaymentStatus, type TransactionKind, type TransactionStatus, type OrderAddress, } from './commerce.types.js';
+export { defaultCartStrings, defaultTaxBreakdownStrings, defaultDiscountCodeStrings, defaultGiftCodeStrings, defaultDiscountStackStrings, defaultInvoiceStrings, defaultOrderStatusStrings, defaultShipmentStrings, defaultRefundStrings, defaultAddressStrings, defaultPaymentMethodStrings, defaultSubscriptionStrings, defaultInventoryStrings, defaultLoyaltyStrings, defaultVendorStrings, defaultSeoStrings, defaultInventorySectionStrings, defaultOrderHeaderStrings, defaultOrderStatusVocabulary, defaultFulfillmentGroupStrings, defaultOrderSummaryStrings, defaultTransactionStrings, defaultOrderCustomerStrings, type CartStrings, type TaxBreakdownStrings, type CodeEntryStrings, type DiscountStackStrings, type InvoiceStrings, type OrderStatusStrings, type ShipmentStrings, type RefundStrings, type AddressStrings, type PaymentMethodStrings, type SubscriptionStrings, type InventoryStrings, type LoyaltyStrings, type VendorStrings, type SeoStrings, type InventorySectionStrings, type OrderHeaderStrings, type OrderStatusVocabulary, type FulfillmentGroupStrings, type OrderSummaryStrings, type TransactionStrings, type OrderCustomerStrings, } from './commerce.strings.js';
+export { UpcomingBookings, BookingCard, type UpcomingBookingsProps, type Booking, type BookingCardProps, type BookingDetail, } from './booking.js';
+export { LoyaltyPoints, type LoyaltyPointsProps, type LoyaltyMovement } from './loyalty.js';
+export { VendorProfile, type VendorProfileProps, type VendorStat, type VendorMetric, type VendorView, } from './vendor-profile.js';
+export { SeoListing, type SeoListingProps } from './seo-listing.js';
+export { calculateSeoScore, seoPermalinkPath, seoPermalinkSlug, DEFAULT_SEO_LIMITS, type SeoScore, type SeoScoreInput, type SeoCheck, type SeoCheckId, type SeoCheckStatus, type SeoLimits, } from './seo-score.js';
+export { InventorySection, type InventorySectionProps, type InventorySectionValue, type InventorySectionField, type InventorySectionName, type InventoryPolicy, } from './inventory-section.js';
+export { OrderLineItem, type OrderLineItemProps, type OrderLine, type OrderLineProperty, } from './order-line-item.js';
+export { OrderHeader, FulfillmentGroup, OrderSummary, type OrderHeaderProps, type FulfillmentGroupProps, type OrderSummaryProps, type SummaryLine, } from './order-detail.js';
+export { OrderTransactions, type OrderTransactionsProps, type Transaction, } from './order-transactions.js';
+export { OrderCustomer, type OrderCustomerProps } from './order-customer.js';

package/dist/components/admin/patterns/commerce/inventory-section.d.cts

@@ -0,0 +1,37 @@
+import { ComponentProps } from 'react';
+import { ContentBlock } from '../../../base/display/index.cjs';
+import { InventorySectionStrings } from './commerce.strings.cjs';
+/** What happens when stock runs out. */
+export type InventoryPolicy = "deny" | "continue";
+export interface InventorySectionValue {
+    sku?: string;
+    barcode?: string;
+    /** Off means the other quantity fields have no meaning and are not drawn. */
+    trackQuantity?: boolean;
+    available?: string;
+    committed?: string;
+    incoming?: string;
+    lowStockThreshold?: string;
+    inventoryPolicy?: InventoryPolicy;
+    binLocation?: string;
+    requiresShipping?: boolean;
+    weight?: string;
+    countryOfOrigin?: string;
+    hsCode?: string;
+    tags?: string[];
+}
+export type InventorySectionField = keyof InventorySectionValue;
+/** Which groups to draw. Omit for all of them. */
+export type InventorySectionName = "summary" | "identity" | "tracking" | "location" | "shipping" | "customs" | "tags";
+export interface InventorySectionProps extends Omit<ComponentProps<typeof ContentBlock>, "children" | "onChange"> {
+    value: InventorySectionValue;
+    /** Reports the field, its new value, and what it replaced. */
+    onFieldChange?: (change: {
+        field: InventorySectionField;
+        value: InventorySectionValue[InventorySectionField];
+        previousValue: InventorySectionValue[InventorySectionField];
+    }) => void;
+    sections?: InventorySectionName[];
+    strings?: Partial<InventorySectionStrings>;
+}
+export declare function InventorySection({ value, onFieldChange, sections, strings, className, ...props }: InventorySectionProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/inventory-section.d.ts

@@ -0,0 +1,37 @@
+import { ComponentProps } from 'react';
+import { ContentBlock } from '../../../base/display/index.js';
+import { InventorySectionStrings } from './commerce.strings.js';
+/** What happens when stock runs out. */
+export type InventoryPolicy = "deny" | "continue";
+export interface InventorySectionValue {
+    sku?: string;
+    barcode?: string;
+    /** Off means the other quantity fields have no meaning and are not drawn. */
+    trackQuantity?: boolean;
+    available?: string;
+    committed?: string;
+    incoming?: string;
+    lowStockThreshold?: string;
+    inventoryPolicy?: InventoryPolicy;
+    binLocation?: string;
+    requiresShipping?: boolean;
+    weight?: string;
+    countryOfOrigin?: string;
+    hsCode?: string;
+    tags?: string[];
+}
+export type InventorySectionField = keyof InventorySectionValue;
+/** Which groups to draw. Omit for all of them. */
+export type InventorySectionName = "summary" | "identity" | "tracking" | "location" | "shipping" | "customs" | "tags";
+export interface InventorySectionProps extends Omit<ComponentProps<typeof ContentBlock>, "children" | "onChange"> {
+    value: InventorySectionValue;
+    /** Reports the field, its new value, and what it replaced. */
+    onFieldChange?: (change: {
+        field: InventorySectionField;
+        value: InventorySectionValue[InventorySectionField];
+        previousValue: InventorySectionValue[InventorySectionField];
+    }) => void;
+    sections?: InventorySectionName[];
+    strings?: Partial<InventorySectionStrings>;
+}
+export declare function InventorySection({ value, onFieldChange, sections, strings, className, ...props }: InventorySectionProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/invoice.d.cts

@@ -0,0 +1,50 @@
+import { ComponentProps, ReactNode } from 'react';
+import { ContentBlock } from '../../../base/display/index.cjs';
+import { InvoiceStrings } from './commerce.strings.cjs';
+import { InvoiceStatus } from './commerce.types.cjs';
+export interface InvoiceParty {
+    name: string;
+    /** A city, a country — whatever identifies the party beyond its name. */
+    location?: ReactNode;
+}
+export interface InvoiceHeaderProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    invoiceNumber: string;
+    status: InvoiceStatus;
+    from: InvoiceParty;
+    to: InvoiceParty;
+    /** Already formatted. */
+    issuedAt?: string;
+    dueAt?: string;
+    /** Already formatted, including its currency. */
+    amountDue: string;
+    strings?: Partial<InvoiceStrings>;
+}
+export declare function InvoiceHeader({ invoiceNumber, status, from, to, issuedAt, dueAt, amountDue, strings, className, ...props }: InvoiceHeaderProps): import("react").JSX.Element;
+export interface InvoiceLine {
+    id?: string;
+    description: string;
+    quantity: number;
+    /** A number, not a string — the table totals these. */
+    unitPrice: number;
+}
+export interface InvoiceLineItemsProps extends Omit<ComponentProps<"div">, "children"> {
+    lines: InvoiceLine[];
+    /** ISO 4217. Handed to the Money primitive, which knows each currency's exponent. */
+    currency?: string;
+    /** A ratio — `0.2` is 20%. Omit to show no tax row. */
+    taxRate?: number;
+    strings?: Partial<InvoiceStrings>;
+}
+export declare function InvoiceLineItems({ lines, currency, taxRate, strings, className, ...props }: InvoiceLineItemsProps): import("react").JSX.Element;
+export interface InvoiceMiniProps extends Omit<ComponentProps<"div">, "children"> {
+    invoiceNumber: string;
+    status: InvoiceStatus;
+    customerName: string;
+    lineCount: number;
+    /** Already formatted. */
+    dueAt: string;
+    /** Already formatted, including its currency. */
+    total: string;
+    strings?: Partial<InvoiceStrings>;
+}
+export declare function InvoiceMini({ invoiceNumber, status, customerName, lineCount, dueAt, total, strings, className, ...props }: InvoiceMiniProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/invoice.d.ts

@@ -0,0 +1,50 @@
+import { ComponentProps, ReactNode } from 'react';
+import { ContentBlock } from '../../../base/display/index.js';
+import { InvoiceStrings } from './commerce.strings.js';
+import { InvoiceStatus } from './commerce.types.js';
+export interface InvoiceParty {
+    name: string;
+    /** A city, a country — whatever identifies the party beyond its name. */
+    location?: ReactNode;
+}
+export interface InvoiceHeaderProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    invoiceNumber: string;
+    status: InvoiceStatus;
+    from: InvoiceParty;
+    to: InvoiceParty;
+    /** Already formatted. */
+    issuedAt?: string;
+    dueAt?: string;
+    /** Already formatted, including its currency. */
+    amountDue: string;
+    strings?: Partial<InvoiceStrings>;
+}
+export declare function InvoiceHeader({ invoiceNumber, status, from, to, issuedAt, dueAt, amountDue, strings, className, ...props }: InvoiceHeaderProps): import("react").JSX.Element;
+export interface InvoiceLine {
+    id?: string;
+    description: string;
+    quantity: number;
+    /** A number, not a string — the table totals these. */
+    unitPrice: number;
+}
+export interface InvoiceLineItemsProps extends Omit<ComponentProps<"div">, "children"> {
+    lines: InvoiceLine[];
+    /** ISO 4217. Handed to the Money primitive, which knows each currency's exponent. */
+    currency?: string;
+    /** A ratio — `0.2` is 20%. Omit to show no tax row. */
+    taxRate?: number;
+    strings?: Partial<InvoiceStrings>;
+}
+export declare function InvoiceLineItems({ lines, currency, taxRate, strings, className, ...props }: InvoiceLineItemsProps): import("react").JSX.Element;
+export interface InvoiceMiniProps extends Omit<ComponentProps<"div">, "children"> {
+    invoiceNumber: string;
+    status: InvoiceStatus;
+    customerName: string;
+    lineCount: number;
+    /** Already formatted. */
+    dueAt: string;
+    /** Already formatted, including its currency. */
+    total: string;
+    strings?: Partial<InvoiceStrings>;
+}
+export declare function InvoiceMini({ invoiceNumber, status, customerName, lineCount, dueAt, total, strings, className, ...props }: InvoiceMiniProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/loyalty.d.cts

@@ -0,0 +1,25 @@
+import { ComponentProps, ReactNode } from 'react';
+import { BadgeTone } from '../../../base/badge/index.cjs';
+import { ContentBlock } from '../../../base/display/index.cjs';
+import { LoyaltyStrings } from './commerce.strings.cjs';
+export interface LoyaltyMovement {
+    id: string;
+    /** What earned or spent the points. */
+    label: string;
+    /** Already formatted. */
+    date: string;
+    /** The magnitude. The sign is drawn from `earned`, not parsed out of this. */
+    points: string;
+    earned: boolean;
+}
+export interface LoyaltyPointsProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    /** A number gets locale grouping; a string is taken as already formatted. */
+    balance: number | string;
+    /** The tier's name. A caller's word, so there is no English default to leak. */
+    tier?: ReactNode;
+    tierTone?: BadgeTone;
+    movements?: LoyaltyMovement[];
+    onRedeem?: () => void;
+    strings?: Partial<LoyaltyStrings>;
+}
+export declare function LoyaltyPoints({ balance, tier, tierTone, movements, onRedeem, strings, className, ...props }: LoyaltyPointsProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/loyalty.d.ts

@@ -0,0 +1,25 @@
+import { ComponentProps, ReactNode } from 'react';
+import { BadgeTone } from '../../../base/badge/index.js';
+import { ContentBlock } from '../../../base/display/index.js';
+import { LoyaltyStrings } from './commerce.strings.js';
+export interface LoyaltyMovement {
+    id: string;
+    /** What earned or spent the points. */
+    label: string;
+    /** Already formatted. */
+    date: string;
+    /** The magnitude. The sign is drawn from `earned`, not parsed out of this. */
+    points: string;
+    earned: boolean;
+}
+export interface LoyaltyPointsProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    /** A number gets locale grouping; a string is taken as already formatted. */
+    balance: number | string;
+    /** The tier's name. A caller's word, so there is no English default to leak. */
+    tier?: ReactNode;
+    tierTone?: BadgeTone;
+    movements?: LoyaltyMovement[];
+    onRedeem?: () => void;
+    strings?: Partial<LoyaltyStrings>;
+}
+export declare function LoyaltyPoints({ balance, tier, tierTone, movements, onRedeem, strings, className, ...props }: LoyaltyPointsProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/order-customer.d.cts

@@ -0,0 +1,20 @@
+import { ComponentProps } from 'react';
+import { ContentBlock } from '../../../base/display/index.cjs';
+import { OrderCustomerStrings } from './commerce.strings.cjs';
+import { OrderAddress } from './commerce.types.cjs';
+export interface OrderCustomerProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    name: string;
+    email?: string;
+    phone?: string;
+    /** How many orders this customer has placed, this one included. */
+    orderCount?: number;
+    shippingAddress?: OrderAddress;
+    billingAddress?: OrderAddress;
+    /** Renders one line in place of a repeated address. */
+    billingSameAsShipping?: boolean;
+    onOpenCustomer?: () => void;
+    onEditShipping?: () => void;
+    onEditBilling?: () => void;
+    strings?: Partial<OrderCustomerStrings>;
+}
+export declare function OrderCustomer({ name, email, phone, orderCount, shippingAddress, billingAddress, billingSameAsShipping, onOpenCustomer, onEditShipping, onEditBilling, strings, className, ...props }: OrderCustomerProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/order-customer.d.ts

@@ -0,0 +1,20 @@
+import { ComponentProps } from 'react';
+import { ContentBlock } from '../../../base/display/index.js';
+import { OrderCustomerStrings } from './commerce.strings.js';
+import { OrderAddress } from './commerce.types.js';
+export interface OrderCustomerProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    name: string;
+    email?: string;
+    phone?: string;
+    /** How many orders this customer has placed, this one included. */
+    orderCount?: number;
+    shippingAddress?: OrderAddress;
+    billingAddress?: OrderAddress;
+    /** Renders one line in place of a repeated address. */
+    billingSameAsShipping?: boolean;
+    onOpenCustomer?: () => void;
+    onEditShipping?: () => void;
+    onEditBilling?: () => void;
+    strings?: Partial<OrderCustomerStrings>;
+}
+export declare function OrderCustomer({ name, email, phone, orderCount, shippingAddress, billingAddress, billingSameAsShipping, onOpenCustomer, onEditShipping, onEditBilling, strings, className, ...props }: OrderCustomerProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/order-detail.d.cts

@@ -0,0 +1,72 @@
+import { LucideIcon } from 'lucide-react';
+import { ComponentProps, ReactNode } from 'react';
+import { ActionDefinition } from '../../../base/action-menu/index.cjs';
+import { ContentBlock } from '../../../base/display/index.cjs';
+import { FulfillmentGroupStrings, OrderHeaderStrings, OrderStatusVocabulary, OrderSummaryStrings } from './commerce.strings.cjs';
+import { FulfillmentStatus, PaymentStatus } from './commerce.types.cjs';
+import { OrderLine } from './order-line-item.cjs';
+export interface OrderHeaderProps extends Omit<ComponentProps<"div">, "children"> {
+    orderNumber: string;
+    /** Where the goods are. */
+    fulfillmentStatus?: FulfillmentStatus;
+    /** Where the money is. */
+    paymentStatus?: PaymentStatus;
+    /** Already formatted. */
+    placedAt?: string;
+    /** Where the order came from — a channel, an app, an import. */
+    source?: string;
+    actions?: ActionDefinition[];
+    strings?: Partial<OrderHeaderStrings>;
+    vocabulary?: Partial<OrderStatusVocabulary>;
+}
+export declare function OrderHeader({ orderNumber, fulfillmentStatus, paymentStatus, placedAt, source, actions, strings, vocabulary, className, ...props }: OrderHeaderProps): import("react").JSX.Element;
+export interface FulfillmentGroupProps extends Omit<ComponentProps<"div">, "children"> {
+    status: FulfillmentStatus;
+    /** Where it ships from. */
+    location?: ReactNode;
+    /** A standing fact about the group — "Shipping not required". */
+    notice?: ReactNode;
+    /**
+     * The glyph beside the notice.
+     *
+     * A prop rather than a node, because an icon passed as a child arrives with no size:
+     * lucide's own default is 24px, which put a crossed circle in the header at the height
+     * of three lines of the text it was annotating.
+     */
+    noticeIcon?: LucideIcon;
+    items?: OrderLine[];
+    /** Overrides `items` entirely, for a caller who needs the rows themselves. */
+    children?: ReactNode;
+    /**
+     * The first renders as a button and the rest collapse into an overflow, built from one
+     * array — which is what stops the menu offering what the button already does.
+     */
+    actions?: ActionDefinition[];
+    strings?: Partial<FulfillmentGroupStrings>;
+    vocabulary?: Partial<OrderStatusVocabulary>;
+}
+export declare function FulfillmentGroup({ status, location, notice, noticeIcon: NoticeIcon, items, children, actions, strings, vocabulary, className, ...props }: FulfillmentGroupProps): import("react").JSX.Element;
+export interface SummaryLine {
+    id?: string;
+    label: ReactNode;
+    /** A middle column — "3 items", "20%". */
+    note?: ReactNode;
+    /** Already formatted, including its currency. */
+    amount: string;
+    /** Money off the customer's total. */
+    deduction?: boolean;
+}
+export interface OrderSummaryProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    /** What was ordered — subtotal, discount, shipping, tax. */
+    goods: SummaryLine[];
+    /** The line the eye should land on. */
+    total: SummaryLine;
+    /** What has actually moved — paid, refunded, balance. */
+    payments?: SummaryLine[];
+    paymentStatus?: PaymentStatus;
+    /** A standing caveat about the balance, not an error. */
+    alert?: ReactNode;
+    strings?: Partial<OrderSummaryStrings>;
+    vocabulary?: Partial<OrderStatusVocabulary>;
+}
+export declare function OrderSummary({ goods, total, payments, paymentStatus, alert, strings, vocabulary, className, ...props }: OrderSummaryProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/order-detail.d.ts

@@ -0,0 +1,72 @@
+import { LucideIcon } from 'lucide-react';
+import { ComponentProps, ReactNode } from 'react';
+import { ActionDefinition } from '../../../base/action-menu/index.js';
+import { ContentBlock } from '../../../base/display/index.js';
+import { FulfillmentGroupStrings, OrderHeaderStrings, OrderStatusVocabulary, OrderSummaryStrings } from './commerce.strings.js';
+import { FulfillmentStatus, PaymentStatus } from './commerce.types.js';
+import { OrderLine } from './order-line-item.js';
+export interface OrderHeaderProps extends Omit<ComponentProps<"div">, "children"> {
+    orderNumber: string;
+    /** Where the goods are. */
+    fulfillmentStatus?: FulfillmentStatus;
+    /** Where the money is. */
+    paymentStatus?: PaymentStatus;
+    /** Already formatted. */
+    placedAt?: string;
+    /** Where the order came from — a channel, an app, an import. */
+    source?: string;
+    actions?: ActionDefinition[];
+    strings?: Partial<OrderHeaderStrings>;
+    vocabulary?: Partial<OrderStatusVocabulary>;
+}
+export declare function OrderHeader({ orderNumber, fulfillmentStatus, paymentStatus, placedAt, source, actions, strings, vocabulary, className, ...props }: OrderHeaderProps): import("react").JSX.Element;
+export interface FulfillmentGroupProps extends Omit<ComponentProps<"div">, "children"> {
+    status: FulfillmentStatus;
+    /** Where it ships from. */
+    location?: ReactNode;
+    /** A standing fact about the group — "Shipping not required". */
+    notice?: ReactNode;
+    /**
+     * The glyph beside the notice.
+     *
+     * A prop rather than a node, because an icon passed as a child arrives with no size:
+     * lucide's own default is 24px, which put a crossed circle in the header at the height
+     * of three lines of the text it was annotating.
+     */
+    noticeIcon?: LucideIcon;
+    items?: OrderLine[];
+    /** Overrides `items` entirely, for a caller who needs the rows themselves. */
+    children?: ReactNode;
+    /**
+     * The first renders as a button and the rest collapse into an overflow, built from one
+     * array — which is what stops the menu offering what the button already does.
+     */
+    actions?: ActionDefinition[];
+    strings?: Partial<FulfillmentGroupStrings>;
+    vocabulary?: Partial<OrderStatusVocabulary>;
+}
+export declare function FulfillmentGroup({ status, location, notice, noticeIcon: NoticeIcon, items, children, actions, strings, vocabulary, className, ...props }: FulfillmentGroupProps): import("react").JSX.Element;
+export interface SummaryLine {
+    id?: string;
+    label: ReactNode;
+    /** A middle column — "3 items", "20%". */
+    note?: ReactNode;
+    /** Already formatted, including its currency. */
+    amount: string;
+    /** Money off the customer's total. */
+    deduction?: boolean;
+}
+export interface OrderSummaryProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    /** What was ordered — subtotal, discount, shipping, tax. */
+    goods: SummaryLine[];
+    /** The line the eye should land on. */
+    total: SummaryLine;
+    /** What has actually moved — paid, refunded, balance. */
+    payments?: SummaryLine[];
+    paymentStatus?: PaymentStatus;
+    /** A standing caveat about the balance, not an error. */
+    alert?: ReactNode;
+    strings?: Partial<OrderSummaryStrings>;
+    vocabulary?: Partial<OrderStatusVocabulary>;
+}
+export declare function OrderSummary({ goods, total, payments, paymentStatus, alert, strings, vocabulary, className, ...props }: OrderSummaryProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/order-line-item.d.cts

@@ -0,0 +1,29 @@
+import { ComponentProps, ReactNode } from 'react';
+import { FulfillmentGroupStrings } from './commerce.strings.cjs';
+/** A per-line fact the kit did not anticipate — a gift message, engraving, an interval. */
+export interface OrderLineProperty {
+    label: ReactNode;
+    value: ReactNode;
+}
+export interface OrderLine {
+    id: string;
+    title: string;
+    /** The chosen option — "OS / blue". */
+    variantTitle?: string;
+    sku?: string;
+    imageSrc?: string;
+    imageAlt?: string;
+    /** Already formatted, including its currency. */
+    unitPrice: string;
+    quantity: number;
+    /** Already formatted. Passed, never multiplied — see the note above. */
+    total: string;
+    /** Rendered as label/value rows under the title, so every consumer's extras match. */
+    properties?: OrderLineProperty[];
+    /** Whatever `properties` cannot express. */
+    children?: ReactNode;
+}
+export interface OrderLineItemProps extends Omit<ComponentProps<"div">, "children" | "id" | "title">, OrderLine {
+    strings?: Partial<FulfillmentGroupStrings>;
+}
+export declare function OrderLineItem({ id: _id, title, variantTitle, sku, imageSrc, imageAlt, unitPrice, quantity, total, properties, children, strings, className, ...props }: OrderLineItemProps): import("react").JSX.Element;

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

@@ -0,0 +1,29 @@
+import { ComponentProps, ReactNode } from 'react';
+import { FulfillmentGroupStrings } from './commerce.strings.js';
+/** A per-line fact the kit did not anticipate — a gift message, engraving, an interval. */
+export interface OrderLineProperty {
+    label: ReactNode;
+    value: ReactNode;
+}
+export interface OrderLine {
+    id: string;
+    title: string;
+    /** The chosen option — "OS / blue". */
+    variantTitle?: string;
+    sku?: string;
+    imageSrc?: string;
+    imageAlt?: string;
+    /** Already formatted, including its currency. */
+    unitPrice: string;
+    quantity: number;
+    /** Already formatted. Passed, never multiplied — see the note above. */
+    total: string;
+    /** Rendered as label/value rows under the title, so every consumer's extras match. */
+    properties?: OrderLineProperty[];
+    /** Whatever `properties` cannot express. */
+    children?: ReactNode;
+}
+export interface OrderLineItemProps extends Omit<ComponentProps<"div">, "children" | "id" | "title">, OrderLine {
+    strings?: Partial<FulfillmentGroupStrings>;
+}
+export declare function OrderLineItem({ id: _id, title, variantTitle, sku, imageSrc, imageAlt, unitPrice, quantity, total, properties, children, strings, className, ...props }: OrderLineItemProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/order-transactions.d.cts

@@ -0,0 +1,23 @@
+import { ComponentProps } from 'react';
+import { ContentBlock } from '../../../base/display/index.cjs';
+import { TransactionStrings } from './commerce.strings.cjs';
+import { TransactionKind, TransactionStatus } from './commerce.types.cjs';
+export interface Transaction {
+    id: string;
+    kind: TransactionKind;
+    status: TransactionStatus;
+    /** The magnitude, already formatted. The sign comes from the kind. */
+    amount: string;
+    /** Already formatted. */
+    processedAt: string;
+    /** How it was taken — "Visa ending 4417", "PayPal". */
+    method?: string;
+    /** The gateway's own id. Mono: it is compared and copied, not read. */
+    reference?: string;
+    gateway?: string;
+}
+export interface OrderTransactionsProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    transactions: Transaction[];
+    strings?: Partial<TransactionStrings>;
+}
+export declare function OrderTransactions({ transactions, strings, className, ...props }: OrderTransactionsProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/order-transactions.d.ts

@@ -0,0 +1,23 @@
+import { ComponentProps } from 'react';
+import { ContentBlock } from '../../../base/display/index.js';
+import { TransactionStrings } from './commerce.strings.js';
+import { TransactionKind, TransactionStatus } from './commerce.types.js';
+export interface Transaction {
+    id: string;
+    kind: TransactionKind;
+    status: TransactionStatus;
+    /** The magnitude, already formatted. The sign comes from the kind. */
+    amount: string;
+    /** Already formatted. */
+    processedAt: string;
+    /** How it was taken — "Visa ending 4417", "PayPal". */
+    method?: string;
+    /** The gateway's own id. Mono: it is compared and copied, not read. */
+    reference?: string;
+    gateway?: string;
+}
+export interface OrderTransactionsProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    transactions: Transaction[];
+    strings?: Partial<TransactionStrings>;
+}
+export declare function OrderTransactions({ transactions, strings, className, ...props }: OrderTransactionsProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/order.d.cts

@@ -0,0 +1,90 @@
+import { ComponentProps, ReactNode } from 'react';
+import { LucideIcon } from 'lucide-react';
+import { ContentBlock } from '../../../base/display/index.cjs';
+import { OrderStatusStrings, RefundStrings, ShipmentStrings } from './commerce.strings.cjs';
+import { OrderStatus, RefundStage, ShipmentStatus } from './commerce.types.cjs';
+export interface OrderEvent {
+    id: string;
+    label: string;
+    /** Already formatted. */
+    timestamp?: string;
+    complete: boolean;
+}
+export interface OrderStatusCardProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    orderNumber: string;
+    status: OrderStatus;
+    /** Oldest first, so "latest complete" and "next" are found by position. */
+    events: OrderEvent[];
+    /** Already formatted. */
+    eta?: string;
+    /**
+     * Opens the full event list on first render.
+     *
+     * Closed by default, because the panel above it already answers what just happened,
+     * what is next and when it lands — which is what a reader opening an order wants. The
+     * list underneath is the audit trail: five rows repeating two facts they have just read
+     * and adding three they did not ask for.
+     */
+    defaultHistoryOpen?: boolean;
+    strings?: Partial<OrderStatusStrings>;
+}
+export declare function OrderStatusCard({ orderNumber, status, events, eta, defaultHistoryOpen, strings, className, ...props }: OrderStatusCardProps): import("react").JSX.Element;
+export interface OrderTimelineEvent {
+    id: string;
+    title: string;
+    description?: string;
+    /** Already formatted. */
+    timestamp: string;
+    status: "completed" | "current" | "pending";
+}
+export interface OrderTimelineProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    events: OrderTimelineEvent[];
+}
+export declare function OrderTimeline({ events, className, ...props }: OrderTimelineProps): import("react").JSX.Element;
+export interface PaymentEvent {
+    id: string;
+    label: string;
+    /** Already formatted. */
+    date: string;
+    /** Already formatted, including its currency. */
+    amount?: string;
+    icon?: LucideIcon;
+    settled: boolean;
+}
+export interface PaymentTimelineProps extends Omit<ComponentProps<"div">, "children"> {
+    events: PaymentEvent[];
+}
+export declare function PaymentTimeline({ events, className, ...props }: PaymentTimelineProps): import("react").JSX.Element;
+export interface TrackingStep {
+    id?: string;
+    label: string;
+    done: boolean;
+    /** Already formatted. When the stage happened — a parcel's rail is a log, not a plan. */
+    timestamp?: string;
+}
+export interface ShipmentDetail {
+    label: string;
+    value: ReactNode;
+}
+export interface ShipmentTrackingProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    trackingNumber: string;
+    carrier?: string;
+    status: ShipmentStatus;
+    steps: TrackingStep[];
+    /** Anything else worth stating — weight, service, signature. */
+    details?: ShipmentDetail[];
+    strings?: Partial<ShipmentStrings>;
+}
+export declare function ShipmentTracking({ trackingNumber, carrier, status, steps, details, strings, className, ...props }: ShipmentTrackingProps): import("react").JSX.Element;
+export interface RefundStatusProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    stage: RefundStage;
+    /** Already formatted, including its currency. */
+    amount: string;
+    reason?: ReactNode;
+    /** Where the money is going back to. */
+    method?: ReactNode;
+    /** Already formatted. */
+    eta?: string;
+    strings?: Partial<RefundStrings>;
+}
+export declare function RefundStatus({ stage, amount, reason, method, eta, strings, className, ...props }: RefundStatusProps): import("react").JSX.Element;