themelia-react-ui 0.0.0-stage → 1.0.0

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

@@ -0,0 +1,51 @@
+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;
+}
+export interface InvoiceHeaderStrings {
+    /** Surface title. */
+    title: string;
+    billFrom: string;
+    billTo: string;
+    issued: string;
+    due: string;
+    amountDue: string;
+    /** Chip label for each `InvoiceStatus`. */
+    paid: string;
+    pending: string;
+    overdue: string;
+}
+export declare const defaultInvoiceHeaderStrings: InvoiceHeaderStrings;
+export interface InvoiceHeaderProps {
+    /** Human-facing invoice reference. */
+    invoiceNumber: string;
+    /**
+     * Payment state. Drives both the chip label (through `strings`) and its
+     * tone, so the two can never disagree. Shares the `InvoiceStatus` union
+     * with `InvoiceMini`.
+     */
+    status: InvoiceStatus;
+    /**
+     * Overrides the badge tone derived from `status`. Reach for it only when
+     * the surrounding surface needs a tone the status does not imply.
+     */
+    statusTone?: BadgeTone;
+    /** Issuing party. */
+    from: InvoiceParty;
+    /** Billed party. */
+    to: InvoiceParty;
+    /** Formatted issue date. */
+    issuedDate?: string;
+    /** Formatted due date. */
+    dueDate?: string;
+    /** Formatted invoice total. */
+    amount: string;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<InvoiceHeaderStrings>;
+}

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

@@ -0,0 +1,2 @@
+export { InvoiceLineItems } from './invoice-line-items';
+export { defaultInvoiceLineItemsStrings, type InvoiceLineItem, type InvoiceColumn, type InvoiceLineItemsFooterRow, type InvoiceLineItemsStrings, type InvoiceLineItemsProps, } from './types';

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

@@ -0,0 +1,5 @@
+import { type InvoiceLineItem, type InvoiceLineItemsProps } from './types';
+export declare function InvoiceLineItems<TItem = InvoiceLineItem>({ items, columns, footerRows, taxRate, currency, className, strings: stringsProp, }: InvoiceLineItemsProps<TItem>): import("react").JSX.Element;
+export declare namespace InvoiceLineItems {
+    var displayName: string;
+}

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

@@ -0,0 +1,64 @@
+import type { ReactNode } from 'react';
+import type { StringsProp } from '../../../../lib/strings';
+/** Default line-item shape used by the concise InvoiceLineItems mode. */
+export interface InvoiceLineItem {
+    /** Supporting copy shown under the label. */
+    description: string;
+    qty: number;
+    price: number;
+    /** Total number of records across all pages. */
+    total: number;
+}
+/**
+ * Per-column definition. Each column declares how to render its header label
+ * and a row's cell. Generic over the row type so consumers can pass arbitrary
+ * data without losing type safety.
+ */
+export interface InvoiceColumn<TItem = InvoiceLineItem> {
+    /** Stable identity for this entry. */
+    id: string;
+    header: ReactNode;
+    /** Tailwind class for the column's grid track (e.g. `'1fr'`, `'80px'`). */
+    width?: string;
+    align?: 'left' | 'right' | 'center';
+    cell: (item: TItem, index: number) => ReactNode;
+    /** Class names appended to header cell. */
+    headerClassName?: string;
+    /** Class names appended to each row cell of this column. */
+    cellClassName?: string;
+}
+/** A footer row (totals, taxes, etc.). Ordered as written. */
+export interface InvoiceLineItemsFooterRow {
+    /** Display label. */
+    label: ReactNode;
+    value: ReactNode;
+    /** Emphasis for the row. `total` renders bold + thicker top spacing. */
+    emphasis?: 'normal' | 'total';
+}
+export interface InvoiceLineItemsStrings {
+    item: string;
+    quantity: string;
+    price: string;
+    subtotal: string;
+    tax: string;
+    /** Total number of records across all pages. */
+    total: string;
+}
+export declare const defaultInvoiceLineItemsStrings: InvoiceLineItemsStrings;
+export interface InvoiceLineItemsProps<TItem = InvoiceLineItem> {
+    /** Line items on the invoice. */
+    items: TItem[];
+    /** Optional custom columns. Defaults to Description / Qty / Price / Total. */
+    columns?: InvoiceColumn<TItem>[];
+    /** Optional custom footer rows. When omitted with the default columns, an
+     * auto-computed subtotal / tax / total footer is used. */
+    footerRows?: InvoiceLineItemsFooterRow[];
+    /** Tax ratio for the default footer (`0.2` means 20%). @default 0.2 */
+    taxRate?: number;
+    /** ISO 4217 code for default monetary cells. Falls back to UIProvider. */
+    currency?: string;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<InvoiceLineItemsStrings>;
+}

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

@@ -0,0 +1,2 @@
+export { InvoiceMini } from './invoice-mini';
+export type { InvoiceStatus, InvoiceMiniData, InvoiceMiniProps } from './types';

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

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

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

@@ -0,0 +1,28 @@
+import type { BadgeTone } from '../../../base/badge';
+import type { StringsProp } from '../../../../lib/strings';
+export type InvoiceStatus = 'paid' | 'pending' | 'overdue';
+export interface InvoiceMiniData {
+    invoiceNumber: string;
+    customerName: string;
+    lineItemsCount: number;
+    totalAmount: string;
+    status: InvoiceStatus;
+    dueDate: string;
+}
+export interface InvoiceMiniStrings {
+    paid: string;
+    pending: string;
+    overdue: string;
+    items: (count: number) => string;
+    due: string;
+}
+export declare const defaultInvoiceMiniStrings: InvoiceMiniStrings;
+export interface InvoiceMiniProps {
+    /** The invoice to summarise. */
+    invoice: InvoiceMiniData;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<InvoiceMiniStrings>;
+}
+export declare const invoiceStatusTone: Record<InvoiceStatus, BadgeTone>;

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

@@ -0,0 +1,2 @@
+export { LoyaltyPoints } from './loyalty-points';
+export { defaultLoyaltyPointsStrings, type LoyaltyHistoryEntry, type LoyaltyPointsProps, type LoyaltyPointsStrings, } from './types';

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

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

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

@@ -0,0 +1,32 @@
+import type { BadgeTone } from '../../../base/badge';
+import type { StringsProp } from '../../../../lib/strings';
+export interface LoyaltyHistoryEntry {
+    /** Display label. */
+    label: string;
+    points: string;
+    date: string;
+    positive: boolean;
+}
+export interface LoyaltyPointsStrings {
+    balanceLabel: string;
+    pointsAvailable: string;
+    redeem: string;
+    /** Tier chip label used when `tier` is not passed. */
+    tier: string;
+}
+export declare const defaultLoyaltyPointsStrings: LoyaltyPointsStrings;
+export interface LoyaltyPointsProps {
+    /** Points currently available. */
+    balance: number | string;
+    /** Membership tier name. Defaults to `strings.tier`. */
+    tier?: string;
+    /** Badge tone for the tier chip. @default 'warning' */
+    tierTone?: BadgeTone;
+    /** Recent point movements. */
+    history?: LoyaltyHistoryEntry[];
+    onRedeem?: () => void;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<LoyaltyPointsStrings>;
+}

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

@@ -0,0 +1,2 @@
+export { OrderStatusCard } from './order-status';
+export { defaultOrderStatusStrings, type OrderStatusCardProps, type OrderStatusStrings, type OrderStatusEvent, type OrderStatusKind, } from './types';

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

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

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

@@ -0,0 +1,35 @@
+import type { BadgeTone } from '../../../base/badge';
+import type { StringsProp } from '../../../../lib/strings';
+export type OrderStatusKind = 'pending' | 'paid' | 'fulfilled' | 'shipped' | 'delivered' | 'cancelled';
+export interface OrderStatusEvent {
+    /** Display label. */
+    label: string;
+    /** Formatted time for the entry. */
+    timestamp?: string;
+    complete: boolean;
+}
+export interface OrderStatusStrings {
+    /** Surface title. */
+    title: string;
+    statusLabel: string;
+    eta: string;
+    latestEvent: string;
+    currentStep: string;
+}
+export declare const defaultOrderStatusStrings: OrderStatusStrings;
+export interface OrderStatusCardProps {
+    /** Human-facing order reference. */
+    orderNumber: string;
+    /** Current fulfilment stage. */
+    status: OrderStatusKind;
+    /** Badge tone for the status chip. */
+    statusTone?: BadgeTone;
+    /** Timeline entries, oldest first. */
+    events: OrderStatusEvent[];
+    /** Formatted delivery estimate. */
+    currentEta?: string;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<OrderStatusStrings>;
+}

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

@@ -0,0 +1,2 @@
+export type { OrderTimelineEvent, OrderTimelineProps } from './types';
+export { OrderTimeline } from './order-timeline';

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

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

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

@@ -0,0 +1,22 @@
+import { type ReactNode } from 'react';
+export interface OrderTimelineEvent {
+    /** Stable identity for this entry. */
+    id: string;
+    /** Surface title. */
+    title: string;
+    /** Supporting copy shown under the label. */
+    description?: string;
+    /** Formatted time for the entry. */
+    timestamp: string;
+    status: 'completed' | 'current' | 'pending';
+}
+export interface OrderTimelineProps {
+    /** Surface title. */
+    title: string;
+    /** Supporting copy shown under the label. */
+    description?: string;
+    events: OrderTimelineEvent[];
+    footerText?: ReactNode;
+    /** Merged onto the outermost node. */
+    className?: string;
+}

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

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

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

@@ -0,0 +1,5 @@
+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 namespace PaymentMethod {
+    var displayName: string;
+}

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

@@ -0,0 +1,33 @@
+import type { StringsProp } from '../../../../lib/strings';
+export type PaymentBrand = 'visa' | 'mastercard' | 'amex' | 'paypal' | 'applepay' | 'googlepay' | 'unknown';
+export interface PaymentMethodStrings {
+    /** Surface title. */
+    title: string;
+    default: string;
+    cardHolder: string;
+    expires: string;
+    change: string;
+}
+export declare const defaultPaymentMethodStrings: PaymentMethodStrings;
+export interface PaymentMethodProps {
+    /** Card network or wallet. */
+    brand: PaymentBrand;
+    /** Last four digits, the only card number this component accepts. */
+    last4: string;
+    /** Expiry in MM/YY form. */
+    expiry?: string;
+    /** Name printed on the card. */
+    holderName?: string;
+    /** Marks this as the account's default method. */
+    default?: boolean;
+    /**
+     * Fired when the "Change" action is pressed. It carries no value — the
+     * component never holds a payment method to hand back — so treat it as a
+     * request to open your own method picker.
+     */
+    onChange?: () => void;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<PaymentMethodStrings>;
+}

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

@@ -0,0 +1,2 @@
+export { PaymentTimeline } from './payment-timeline';
+export type { PaymentEvent, PaymentTimelineProps } from './types';

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

@@ -0,0 +1,5 @@
+import type { PaymentTimelineProps } from './types';
+export declare function PaymentTimeline({ events, className }: PaymentTimelineProps): import("react").JSX.Element;
+export declare namespace PaymentTimeline {
+    var displayName: string;
+}

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

@@ -0,0 +1,15 @@
+import type { LucideIcon } from 'lucide-react';
+export interface PaymentEvent {
+    /** Display label. */
+    label: string;
+    date: string;
+    amount?: string;
+    done: boolean;
+    /** Leading glyph. */
+    icon: LucideIcon;
+}
+export interface PaymentTimelineProps {
+    events: PaymentEvent[];
+    /** Merged onto the outermost node. */
+    className?: string;
+}

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

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

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

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

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

@@ -0,0 +1,3 @@
+import type { ReceiptProps } from './types';
+/** Explicit paper surface: Card owns all content insets; clipping is decorative geometry. */
+export declare const Receipt: import("react").ForwardRefExoticComponent<ReceiptProps & import("react").RefAttributes<HTMLDivElement>>;

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

@@ -0,0 +1,42 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import type { CardProps } from '../../../base/cards';
+import type { MoneyProps } from '../../../primitives/money';
+export interface ReceiptProps extends ComponentPropsWithoutRef<'div'> {
+    /** Receipt body. Compose metadata, line items, dividers and totals with public components. */
+    children: ReactNode;
+    /** Merchant or document heading; shares the Card body inset. */
+    header?: ReactNode;
+    /** Closing copy or application-owned actions; shares the Card body inset. */
+    footer?: ReactNode;
+    /** Optional QRCode composition. The application imports and sizes the QR owner. */
+    qrCode?: ReactNode;
+    /** Card's canonical inset size. Default: md. */
+    padding?: CardProps['padding'];
+    /** Decorative tooth depth in CSS pixels. Default: 5; zero disables clipping. */
+    toothDepth?: number;
+    /** Approximate decorative tooth width in CSS pixels. Default: 8. */
+    toothWidth?: number;
+    /** Shared token shadow beneath the paper. Default: true. */
+    shadow?: boolean;
+}
+export interface ReceiptLineItem {
+    id: string;
+    name: string;
+    quantity: number;
+    unitPrice: number;
+    /** Authoritative line total, when the application has already calculated discounts/tax. */
+    total?: number | string;
+    description?: ReactNode;
+}
+export interface ReceiptItemsProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
+    items: readonly ReceiptLineItem[];
+    /** Defaults to UIProvider.money.defaultCurrency. */
+    currency?: string;
+    /** Defaults to UIProvider.formatting.locale. */
+    locale?: string;
+    /** Unit shared by unit prices and authoritative totals. Default: major. */
+    unit?: MoneyProps['unit'];
+    minorUnitScale?: MoneyProps['minorUnitScale'];
+    /** Defaults to the shared Money policy. */
+    formatMode?: MoneyProps['formatMode'];
+}

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

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

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

@@ -0,0 +1,5 @@
+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 namespace RefundStatusCard {
+    var displayName: string;
+}

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

@@ -0,0 +1,37 @@
+import type { StringsProp } from '../../../../lib/strings';
+export type RefundStage = 'requested' | 'approved' | 'processing' | 'completed';
+export interface RefundStatusStrings {
+    /** Surface title. */
+    title: string;
+    requested: string;
+    approved: string;
+    processing: string;
+    completed: string;
+    /** Formatted refund amount. */
+    amount: string;
+    /** Why the refund was requested. */
+    reason: string;
+    /** Formatted estimate for the funds landing. */
+    eta: string;
+    /** Where the money is being returned to. */
+    method: string;
+}
+export declare const defaultRefundStatusStrings: RefundStatusStrings;
+export interface RefundStatusCardProps {
+    /** How far the refund has progressed. */
+    stage: RefundStage;
+    /** Formatted refund amount. */
+    amount: string;
+    /** Why the refund was requested. */
+    reason?: string;
+    /** Where the money is being returned to. */
+    method?: string;
+    /** Formatted estimate for the funds landing. */
+    eta?: string;
+    /** Formatted date the refund was raised. */
+    requestedAt?: string;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<RefundStatusStrings>;
+}

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

@@ -0,0 +1,3 @@
+export { DEFAULT_SEO_LISTING_LIMITS, calculateSeoListingScore, getSeoPermalinkPath, getSeoPermalinkSlug, } from './seo-listing-score';
+export { SeoListingCard } from './seo-listing-card';
+export { defaultSeoListingCardStrings, type SeoListingCardProps, type SeoListingCardStrings, type SeoListingCheckId, type SeoListingCheckResult, type SeoListingCheckStatus, type SeoListingScoreInput, type SeoListingScoreLimits, type SeoListingScoreResult, } from './types';

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

@@ -0,0 +1,5 @@
+import { type SeoListingCardProps } from './types';
+export declare function SeoListingCard({ siteName, baseUrl, pathSegments, permalink, title, description, price, keyword, score, limits, showChecks, onEdit, className, strings: stringsProp, }: SeoListingCardProps): import("react").JSX.Element;
+export declare namespace SeoListingCard {
+    var displayName: string;
+}

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

@@ -0,0 +1,5 @@
+import type { SeoListingScoreInput, SeoListingScoreLimits, SeoListingScoreResult } from './types';
+export declare const DEFAULT_SEO_LISTING_LIMITS: Required<SeoListingScoreLimits>;
+export declare function getSeoPermalinkPath(permalink?: string): string;
+export declare function getSeoPermalinkSlug(permalink?: string): string;
+export declare function calculateSeoListingScore(input: SeoListingScoreInput): SeoListingScoreResult;

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

@@ -0,0 +1,92 @@
+import type { ReactNode } from 'react';
+import type { StringsProp } from '../../../../lib/strings';
+export type SeoListingCheckId = 'title' | 'description' | 'permalink' | 'slug' | 'url' | 'keyword';
+export type SeoListingCheckStatus = 'good' | 'review' | 'missing';
+export interface SeoListingScoreLimits {
+    titleMin?: number;
+    titleMax?: number;
+    descriptionMin?: number;
+    descriptionMax?: number;
+    permalinkMax?: number;
+}
+export interface SeoListingScoreInput {
+    /** Surface title. */
+    title?: string;
+    /** Supporting copy shown under the label. */
+    description?: string;
+    /** Full URL shown under the title. */
+    permalink?: string;
+    /** Origin the permalink is built on. */
+    baseUrl?: string;
+    /** Target keyword the copy is scored against. */
+    keyword?: string;
+    /** Character caps for the title and description. */
+    limits?: SeoListingScoreLimits;
+}
+export interface SeoListingCheckResult {
+    /** Stable identity for this entry. */
+    id: SeoListingCheckId;
+    status: SeoListingCheckStatus;
+    /** Overall SEO score, 0-100. */
+    score: number;
+    maxScore: number;
+    actual: number;
+    min?: number;
+    max?: number;
+}
+export interface SeoListingScoreResult {
+    /** Overall SEO score, 0-100. */
+    score: number;
+    status: SeoListingCheckStatus;
+    checks: SeoListingCheckResult[];
+    /** Character caps for the title and description. */
+    limits: Required<SeoListingScoreLimits>;
+}
+export interface SeoListingCardStrings {
+    /** Surface title. */
+    title: string;
+    editLabel: string;
+    scoreLabel: string;
+    checksLabel: string;
+    siteFallback: string;
+    titleFallback: string;
+    descriptionFallback: string;
+    urlFallback: string;
+    characters: string;
+    maxLabel: string;
+    targetLabel: string;
+    status: Record<SeoListingCheckStatus, string>;
+    checkLabels: Record<SeoListingCheckId, string>;
+    checkHints: Record<SeoListingCheckId, string>;
+}
+export declare const defaultSeoListingCardStrings: SeoListingCardStrings;
+export interface SeoListingCardProps {
+    /** Site name shown in the search preview. */
+    siteName?: string;
+    /** Origin the permalink is built on. */
+    baseUrl?: string;
+    /** Path parts appended to the base URL. */
+    pathSegments?: string[];
+    /** Full URL shown under the title. */
+    permalink?: string;
+    /** Surface title. */
+    title?: string;
+    /** Supporting copy shown under the label. */
+    description?: string;
+    /** Formatted price shown in the rich result. */
+    price?: ReactNode;
+    /** Target keyword the copy is scored against. */
+    keyword?: string;
+    /** Overall SEO score, 0-100. */
+    score?: SeoListingScoreResult;
+    /** Character caps for the title and description. */
+    limits?: SeoListingScoreLimits;
+    /** Renders the checks. */
+    showChecks?: boolean;
+    /** Fired when an entry is edited. */
+    onEdit?: () => void;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<SeoListingCardStrings>;
+}

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

@@ -0,0 +1,2 @@
+export { ShipmentTracking } from './shipment-tracking';
+export { defaultShipmentTrackingStrings, type ShipmentDetail, type ShipmentStatus, type ShipmentTrackingProps, type ShipmentTrackingStrings, type TrackingStep, } from './types';

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

@@ -0,0 +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 namespace ShipmentTracking {
+    var displayName: string;
+}

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

@@ -0,0 +1,44 @@
+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.
+ */
+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>;
+export interface TrackingStep {
+    /** Display label. */
+    label: string;
+    done: boolean;
+}
+export interface ShipmentDetail {
+    /** Display label. */
+    label: string;
+    value: string;
+}
+export interface ShipmentTrackingStrings {
+    /** Accessible name for the surface. */
+    title: string;
+    /** Status label for each `ShipmentStatus`. */
+    pending: string;
+    in_transit: string;
+    delivered: string;
+    delayed: string;
+}
+export declare const defaultShipmentTrackingStrings: ShipmentTrackingStrings;
+export interface ShipmentTrackingProps {
+    /** Carrier tracking reference. */
+    trackingNumber: string;
+    /** Carrier handling the shipment. */
+    carrier?: string;
+    /** Current transit stage. */
+    status: ShipmentStatus;
+    /** Tracking checkpoints, oldest first. */
+    steps: TrackingStep[];
+    /** Label/value facts about the shipment. */
+    details?: ShipmentDetail[];
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<ShipmentTrackingStrings>;
+}

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

@@ -0,0 +1,2 @@
+export { SubscriptionSummaryCard } from './subscription-summary';
+export { defaultSubscriptionSummaryStrings, type SubscriptionSummaryCardProps, type SubscriptionSummaryStrings, type SubscriptionPerk, } from './types';