themelia-react-ui 0.0.0-stage → 1.0.1

package/dist/components/blocks/analytics/usage-card/usage-card.d.ts

@@ -0,0 +1,6 @@
+import type { UsageCardProps } from './types';
+/** App-owned usage data and period callbacks in the canonical Card composition. */
+export declare function UsageCard({ data, status, periods, period, onPeriodChange, onRetry, loadingSlot, errorSlot, emptySlot, footerAction, strings: stringsProp, ...cardProps }: UsageCardProps): import("react").JSX.Element;
+export declare namespace UsageCard {
+    var displayName: string;
+}

package/dist/components/blocks/analytics/usage-card/usage-card.data.d.ts

@@ -0,0 +1,19 @@
+import type { UsageCardDay } from './types';
+export declare function validUsage(value: number | null | undefined): number | null;
+/** Account only for rounding accumulated by positive finite category additions. */
+export declare function usageExceeds(actual: number, expected: number, terms?: number): boolean;
+/** Retain actual numbers; cap only geometry. Zero quota has no finite percentage. */
+export declare function quotaSummary(usedValue: number | null, limitValue: number | null | undefined): {
+    readonly kind: "unavailable" | "unlimited" | "limited";
+    readonly used: number | null;
+    readonly limit: number | null;
+    readonly percent: number | null;
+    readonly progress: number | null;
+    readonly remaining: number | null;
+    readonly excess: number | null;
+};
+export declare function dailySummary(days: readonly UsageCardDay[]): {
+    values: (number | null)[];
+    average: number | null;
+    maximum: number;
+};

package/dist/components/blocks/analytics/usage-card/usage-card.strings.d.ts

@@ -0,0 +1,22 @@
+export interface UsageCardStrings {
+    title: string;
+    usage: string;
+    used: string;
+    of: string;
+    unlimited: string;
+    unavailable: string;
+    remaining: string;
+    overLimit: string;
+    breakdown: string;
+    inconsistentBreakdown: string;
+    daily: string;
+    average: string;
+    perDay: string;
+    resources: string;
+    periods: string;
+    loading: string;
+    error: string;
+    empty: string;
+    retry: string;
+}
+export declare const defaultUsageCardStrings: UsageCardStrings;

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

@@ -0,0 +1 @@
+export * from './message';

package/dist/components/blocks/collaboration/message/index.d.ts

@@ -0,0 +1,2 @@
+export { Message, MessageBubble, MessageContent, MessageHeader, MessageActions, MessageStatus } from './message';
+export { defaultMessageStrings, type MessageProps, type MessagePartProps, type MessageBubbleProps, type MessageStatusProps, type MessageStrings } from './message.types';

package/dist/components/blocks/collaboration/message/message.d.ts

@@ -0,0 +1,8 @@
+import { type MessageProps, type MessagePartProps, type MessageBubbleProps, type MessageStatusProps } from './message.types';
+export declare const MessageContent: import("react").ForwardRefExoticComponent<MessagePartProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const MessageHeader: import("react").ForwardRefExoticComponent<MessagePartProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const MessageActions: import("react").ForwardRefExoticComponent<MessagePartProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const MessageBubble: import("react").ForwardRefExoticComponent<MessageBubbleProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const MessageStatus: import("react").ForwardRefExoticComponent<MessageStatusProps & import("react").RefAttributes<HTMLSpanElement>>;
+/** Callback-free transcript presentation. Consumers own rich text, requests and delivery state. */
+export declare const Message: import("react").ForwardRefExoticComponent<MessageProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/blocks/collaboration/message/message.types.d.ts

@@ -0,0 +1,30 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import type { StringsProp } from '../../../../lib/strings';
+export interface MessageStrings {
+    typing: string;
+    loading: string;
+}
+export declare const defaultMessageStrings: MessageStrings;
+export interface MessageProps extends ComponentPropsWithoutRef<'div'> {
+    /** Message direction, independent of author or service role. */
+    align?: 'start' | 'end';
+    /** Bubble treatment. @default muted */
+    tone?: 'muted' | 'primary' | 'plain' | 'surface';
+    avatar?: ReactNode;
+    author?: ReactNode;
+    /** Caller-formatted time; datetime supplies machine-readable time when available. */
+    timestamp?: ReactNode;
+    dateTime?: string;
+    actions?: ReactNode;
+    status?: ReactNode;
+    loading?: boolean;
+    typing?: boolean;
+    strings?: StringsProp<MessageStrings>;
+}
+export interface MessagePartProps extends ComponentPropsWithoutRef<'div'> {
+}
+export interface MessageBubbleProps extends MessagePartProps {
+    tone?: 'muted' | 'primary' | 'plain' | 'surface';
+}
+export interface MessageStatusProps extends ComponentPropsWithoutRef<'span'> {
+}

package/dist/components/blocks/commerce/address-card/address-card.d.ts

@@ -0,0 +1,5 @@
+import { type AddressCardProps } from './types';
+export declare function AddressCard({ kind, name, line1, line2, city, region, postalCode, country, phone, default: defaultAddress, onEdit, onRemove, onMakeDefault, className, strings: stringsProp, }: AddressCardProps): import("react").JSX.Element;
+export declare namespace AddressCard {
+    var displayName: string;
+}

package/dist/components/blocks/commerce/address-card/index.d.ts

@@ -0,0 +1,2 @@
+export { AddressCard } from './address-card';
+export { defaultAddressCardStrings, type AddressCardProps, type AddressCardStrings, type AddressKind, } from './types';

package/dist/components/blocks/commerce/address-card/types.d.ts

@@ -0,0 +1,43 @@
+import type { StringsProp } from '../../../../lib/strings';
+export type AddressKind = 'shipping' | 'billing' | 'pickup';
+export interface AddressCardStrings {
+    defaultBadge: string;
+    edit: string;
+    remove: string;
+    makeDefault: string;
+    shipping: string;
+    billing: string;
+    pickup: string;
+}
+export declare const defaultAddressCardStrings: AddressCardStrings;
+export interface AddressCardProps {
+    /** What the address is for — billing, shipping, or both. */
+    kind?: AddressKind;
+    /** Display name. */
+    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;
+    /** Marks this as the account's default address. */
+    default?: boolean;
+    /** Fired when an entry is edited. */
+    onEdit?: () => void;
+    /** Fired when an entry is removed. */
+    onRemove?: () => void;
+    onMakeDefault?: () => void;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<AddressCardStrings>;
+}

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

@@ -0,0 +1,12 @@
+import type { BookingCalendarEventCardProps } from './booking-calendar-event-card.types';
+/**
+ * Compact, card-free booking detail composition.
+ *
+ * All visible copy is supplied by props, so this component intentionally has
+ * no strings file. Frame it with `Card` only when the page needs card
+ * chrome.
+ */
+export declare function BookingCalendarEventCard({ title, description, status, items, actionLabel, onAction, className, contentClassName, }: BookingCalendarEventCardProps): import("react").JSX.Element;
+export declare namespace BookingCalendarEventCard {
+    var displayName: string;
+}

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

@@ -0,0 +1,36 @@
+import type { ReactNode } from 'react';
+/** One labeled fact displayed in a booking-event summary. */
+export interface BookingCalendarEventCardItem {
+    /** Stable key used to preserve the fact row across renders. */
+    id: string;
+    /** Consumer-owned fact label, such as “Date” or “Guest”. */
+    label: ReactNode;
+    /** Display value. Strings and numbers use the canonical `Value` primitive. */
+    value: ReactNode;
+    /** Span both detail columns and receive the emphasized note treatment. */
+    fullWidth?: boolean;
+}
+/**
+ * Stateless booking facts and one consumer-owned action.
+ *
+ * The component owns compact commerce presentation only. The consumer owns
+ * booking data, formatting, status copy, routing, and action behavior.
+ */
+export interface BookingCalendarEventCardProps {
+    /** Primary booking identifier or event title. */
+    title: ReactNode;
+    /** Optional supporting context shown beneath the title. */
+    description?: ReactNode;
+    /** Optional status or metadata rendered at the end of the header. */
+    status?: ReactNode;
+    /** Ordered booking facts rendered as a responsive definition list. */
+    items: BookingCalendarEventCardItem[];
+    /** Label for the primary booking action. */
+    actionLabel: ReactNode;
+    /** Called when the primary booking action is activated. */
+    onAction: () => void;
+    /** Class applied to the outer content block. */
+    className?: string;
+    /** Class applied to the details-and-action content region. */
+    contentClassName?: string;
+}

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

@@ -0,0 +1,2 @@
+export { BookingCalendarEventCard } from './booking-calendar-event-card';
+export type { BookingCalendarEventCardItem, BookingCalendarEventCardProps, } from './booking-calendar-event-card.types';

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

@@ -0,0 +1,5 @@
+import { type CartSummaryCardProps } from './types';
+export declare function CartSummaryCard({ items, subtotal, tax, shipping, discount, total, onCheckout, className, strings: stringsProp, }: CartSummaryCardProps): import("react").JSX.Element;
+export declare namespace CartSummaryCard {
+    var displayName: string;
+}

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

@@ -0,0 +1,2 @@
+export { CartSummaryCard } from './cart-summary';
+export { defaultCartSummaryStrings, type CartSummaryCardProps, type CartSummaryStrings, type CartLineItem, } from './types';

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

@@ -0,0 +1,53 @@
+import type { StringsProp } from '../../../../lib/strings';
+export interface CartLineItem {
+    /** Stable identity for this entry. */
+    id: string;
+    /** Display name. */
+    name?: string;
+    productTitle?: string;
+    /** Surface title. */
+    title?: string;
+    variantTitle?: string;
+    qty: number;
+    price: string;
+    imageUrl?: string;
+    imageSrc?: string;
+    src?: string;
+    url?: string;
+    imageAlt?: string;
+}
+export interface CartSummaryStrings {
+    /** Surface title. */
+    title: string;
+    /** Formatted total before tax, shipping, and discounts. */
+    subtotal: string;
+    /** Formatted tax amount. */
+    tax: string;
+    /** Formatted shipping cost. */
+    shipping: string;
+    /** Formatted discount, shown as a deduction. */
+    discount: string;
+    /** Formatted order total. */
+    total: string;
+    checkout: string;
+}
+export declare const defaultCartSummaryStrings: CartSummaryStrings;
+export interface CartSummaryCardProps {
+    /** Line items in the cart. */
+    items: CartLineItem[];
+    /** Formatted total before tax, shipping, and discounts. */
+    subtotal?: string;
+    /** Formatted tax amount. */
+    tax?: string;
+    /** Formatted shipping cost. */
+    shipping?: string;
+    /** Formatted discount, shown as a deduction. */
+    discount?: string;
+    /** Formatted order total. */
+    total: string;
+    onCheckout?: () => void;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<CartSummaryStrings>;
+}

package/dist/components/blocks/commerce/coupon-input/coupon-input.d.ts

@@ -0,0 +1,5 @@
+import { type CouponInputCardProps } from './types';
+export declare function CouponInputCard({ appliedCode, appliedDiscount, error, onApply, onRemove, loading, className, strings: stringsProp, }: CouponInputCardProps): import("react").JSX.Element;
+export declare namespace CouponInputCard {
+    var displayName: string;
+}

package/dist/components/blocks/commerce/coupon-input/index.d.ts

@@ -0,0 +1,2 @@
+export { CouponInputCard } from './coupon-input';
+export { defaultCouponInputStrings, type CouponInputCardProps, type CouponInputStrings, } from './types';

package/dist/components/blocks/commerce/coupon-input/types.d.ts

@@ -0,0 +1,35 @@
+import type { StringsProp } from '../../../../lib/strings';
+export interface CouponInputStrings {
+    /** Surface title. */
+    title: string;
+    /**
+     * Accessible name for the code field. The card shows no visible label — the
+     * placeholder carries the hint — so this is the field's only accessible
+     * name, and a placeholder alone is not one: it is not reliably announced and
+     * disappears as soon as the user types.
+     */
+    fieldLabel: string;
+    placeholder: string;
+    apply: string;
+    remove: string;
+    applied: string;
+    invalid: string;
+}
+export declare const defaultCouponInputStrings: CouponInputStrings;
+export interface CouponInputCardProps {
+    /** Coupon currently applied, if any. */
+    appliedCode?: string;
+    /** Formatted discount the coupon grants. */
+    appliedDiscount?: string;
+    /** Validation message for a rejected code. */
+    error?: string;
+    onApply?: (code: string) => void;
+    /** Fired when an entry is removed. */
+    onRemove?: () => void;
+    /** Whether a code is being checked. */
+    loading?: boolean;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<CouponInputStrings>;
+}

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

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

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

@@ -0,0 +1,2 @@
+export { DiscountStackPreview } from './discount-stack';
+export { defaultDiscountStackStrings, type Discount, type DiscountStackPreviewProps, type DiscountStackStrings, } from './types';

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

@@ -0,0 +1,27 @@
+import type { BadgeTone } from '../../../base/badge';
+import type { StringsProp } from '../../../../lib/strings';
+export interface Discount {
+    type: string;
+    /** Display label. */
+    label: string;
+    amount: string;
+    /** Chip rendered beside the label. */
+    badge: BadgeTone;
+}
+export interface DiscountStackStrings {
+    /** Surface title. */
+    title: string;
+    /** Formatted sum of every discount. */
+    totalSavings: string;
+}
+export declare const defaultDiscountStackStrings: DiscountStackStrings;
+export interface DiscountStackPreviewProps {
+    /** Discounts applied, in the order they stack. */
+    discounts: Discount[];
+    /** Formatted sum of every discount. */
+    totalSavings: string;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<DiscountStackStrings>;
+}

package/dist/components/blocks/commerce/format-signed-amount.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Negative-amount presentation shared across commerce surfaces.
+ *
+ * Consumers pass amounts as opaque preformatted strings, sometimes already
+ * carrying a leading "-" and sometimes not. Rendering those raw meant the same
+ * concept — money coming off a total — appeared with a HYPHEN-MINUS in one card
+ * and a MINUS SIGN in the next.
+ *
+ * U+2212 is the correct glyph: it is drawn to the width of a digit and sits on
+ * the maths axis, so it aligns in a tabular-figures column where the narrower,
+ * lower hyphen does not.
+ */
+/** U+2212 MINUS SIGN. */
+export declare const MINUS_SIGN = "\u2212";
+/** Drop any leading sign or whitespace a consumer already supplied. */
+export declare function stripLeadingMinus(value: string): string;
+/**
+ * Present an amount as a deduction: exactly one U+2212, whatever the caller
+ * passed in. An empty or whitespace-only value is returned untouched so the
+ * caller's own empty handling still applies.
+ */
+export declare function formatDeduction(value: string): string;

package/dist/components/blocks/commerce/giftcard-card/giftcard-card.d.ts

@@ -0,0 +1,62 @@
+import type { AccentColor, GiftcardCommonProps, GiftcardData, GradientVariant, HeaderColor, PatternVariant } from './types';
+export type GiftcardCardVariant = 'gradient' | 'compact' | 'minimal' | 'dark' | 'illustrated';
+interface GiftcardCardSharedProps extends GiftcardData, GiftcardCommonProps {
+    /** Merged onto the card root. */
+    className?: string;
+}
+/**
+ * Each variant admits only the styling prop it can actually use; the others are
+ * typed `never`, so passing `headerColor` to the gradient card is a type error
+ * rather than a silently ignored prop.
+ */
+export type GiftcardCardProps = GiftcardCardSharedProps & ({
+    /** Premium gradient card. The default presentation. */
+    variant?: 'gradient';
+    /** Background gradient. Default: `purple`. */
+    gradient?: GradientVariant;
+    /** Decorative overlay on the gradient. Default: `none`. */
+    pattern?: PatternVariant;
+    color?: never;
+    headerColor?: never;
+} | {
+    /** Short row for collections and lists. */
+    variant: 'compact';
+    /** Background gradient for the row's leading block. */
+    gradient?: GradientVariant;
+    pattern?: never;
+    color?: never;
+    headerColor?: never;
+} | {
+    /** Restrained card that inherits the surrounding surface. */
+    variant: 'minimal';
+    /** Accent for the rule and highlights. */
+    color?: AccentColor;
+    gradient?: never;
+    pattern?: never;
+    headerColor?: never;
+} | {
+    /** Solid dark card, for light surfaces that need contrast. */
+    variant: 'dark';
+    gradient?: never;
+    pattern?: never;
+    color?: never;
+    headerColor?: never;
+} | {
+    /** Illustrated card with a coloured header band. */
+    variant: 'illustrated';
+    /** Colour of the header band. */
+    headerColor?: HeaderColor;
+    gradient?: never;
+    pattern?: never;
+    color?: never;
+});
+/**
+ * GiftcardCard — one gift-card data contract with five deliberate visual
+ * variants. The premium gradient card is the useful default; compact is for
+ * collection rows, while minimal, dark, and illustrated are explicit styles.
+ */
+export declare function GiftcardCard(props: GiftcardCardProps): import("react").JSX.Element;
+export declare namespace GiftcardCard {
+    var displayName: string;
+}
+export {};

package/dist/components/blocks/commerce/giftcard-card/index.d.ts

@@ -0,0 +1,2 @@
+export { GiftcardCard, type GiftcardCardProps, type GiftcardCardVariant, } from './giftcard-card';
+export type { GiftcardData, GradientVariant, PatternVariant, AccentColor, HeaderColor, } from './types';

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-compact.d.ts

@@ -0,0 +1,10 @@
+import { type GiftcardCommonProps, type GiftcardData, type GradientVariant } from '../types';
+export declare function GiftcardCompact({ code, amount, remainingAmount, status, recipientName, gradient, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
+    /** Background gradient for the leading block. */
+    gradient?: GradientVariant;
+    /** Merged onto the row root. */
+    className?: string;
+}): import("react").JSX.Element;
+export declare namespace GiftcardCompact {
+    var displayName: string;
+}

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-copy-button.d.ts

@@ -0,0 +1,9 @@
+import { type GiftcardStrings } from '../types';
+/** Owns the four giftcard code actions without changing their display strips. */
+export declare function GiftcardCopyButton({ code, strings, inverse, className }: {
+    code: string;
+    strings: Pick<GiftcardStrings, 'copyCode' | 'copiedCode' | 'copyFailed' | 'copyingCode'>;
+    /** Explicit inverse reading surface, independent of the surrounding page theme. */
+    inverse?: boolean;
+    className?: string;
+}): import("react").JSX.Element;

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-dark.d.ts

@@ -0,0 +1,7 @@
+import { type GiftcardCommonProps, type GiftcardData } from '../types';
+export declare function GiftcardCardDark({ code, amount, remainingAmount, status, recipientName, expiresAt, onView, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
+    className?: string;
+}): import("react").JSX.Element;
+export declare namespace GiftcardCardDark {
+    var displayName: string;
+}

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-full.d.ts

@@ -0,0 +1,11 @@
+import { type GiftcardCommonProps, type GiftcardData, type GradientVariant, type PatternVariant } from '../types';
+export declare function GiftcardFull({ code, amount, remainingAmount, status, recipientName, senderName, message, expiresAt, createdAt: _createdAt, template: _template, onView, gradient, pattern, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
+    /** Background gradient. */
+    gradient?: GradientVariant;
+    /** Decorative overlay on the gradient. */
+    pattern?: PatternVariant;
+    className?: string;
+}): import("react").JSX.Element;
+export declare namespace GiftcardFull {
+    var displayName: string;
+}

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-illustrated.d.ts

@@ -0,0 +1,10 @@
+import { type GiftcardCommonProps, type GiftcardData, type HeaderColor } from '../types';
+export declare function GiftcardCardIllustrated({ code, amount, remainingAmount, status, recipientName, expiresAt, onView, headerColor, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
+    /** Colour of the header band. */
+    headerColor?: HeaderColor;
+    /** Merged onto the card root. */
+    className?: string;
+}): import("react").JSX.Element;
+export declare namespace GiftcardCardIllustrated {
+    var displayName: string;
+}

package/dist/components/blocks/commerce/giftcard-card/partials/giftcard-minimal.d.ts

@@ -0,0 +1,10 @@
+import { type AccentColor, type GiftcardCommonProps, type GiftcardData } from '../types';
+export declare function GiftcardCardMinimal({ code, amount, remainingAmount, status, recipientName, expiresAt, onView, color, className, strings: stringsProp, }: GiftcardData & GiftcardCommonProps & {
+    /** Accent for the rule and highlights. */
+    color?: AccentColor;
+    /** Merged onto the card root. */
+    className?: string;
+}): import("react").JSX.Element;
+export declare namespace GiftcardCardMinimal {
+    var displayName: string;
+}

package/dist/components/blocks/commerce/giftcard-card/types.d.ts

@@ -0,0 +1,83 @@
+import type { StringsProp } from '../../../../lib/strings';
+/**
+ * The card's content, shared by all five presentations. Every field is
+ * pre-formatted display copy — this family renders what it is handed and does
+ * no currency or date formatting of its own, so localisation stays with the
+ * consumer.
+ */
+export interface GiftcardData {
+    /** Redemption code, shown in a monospace run. */
+    code: string;
+    /** Formatted face value, e.g. `"$50.00"`. */
+    amount: string;
+    /** Formatted balance left. Omit for a card that shows only its face value. */
+    remainingAmount?: string;
+    /** Currency label shown beside the amount when the formatted values omit it. */
+    currency?: string;
+    /** Lifecycle state, driving the status chip's tone. */
+    status: 'active' | 'redeemed' | 'expired' | 'disabled';
+    /** Who the card is for. */
+    recipientName?: string;
+    /** Who sent it. */
+    senderName?: string;
+    /** Personal note from the sender. */
+    message?: string;
+    /** Formatted expiry date. */
+    expiresAt?: string;
+    /** Formatted issue date. */
+    createdAt?: string;
+    /** Design name shown as the card's template label. */
+    template?: string;
+    /** Fired by the card's view action. Omit to render the card without it. */
+    onView?: () => void;
+}
+/** Background gradient for the illustrated and full presentations. */
+export type GradientVariant = 'purple' | 'green' | 'warm';
+/** Decorative overlay drawn on top of the gradient. */
+export type PatternVariant = 'none' | 'circles' | 'waves';
+/** Accent used for the minimal presentation's rule and highlights. */
+export type AccentColor = 'green' | 'purple' | 'warm';
+/** Header band colour for the compact presentation. */
+export type HeaderColor = 'green' | 'blue' | 'amber';
+export type GiftcardStatus = GiftcardData['status'];
+/**
+ * Localised labels for giftcard cards. Covers status chips, the recurring
+ * field labels rendered by all five partials (full / dark / illustrated /
+ * minimal / compact), and the inline button labels.
+ *
+ * Override per-instance via `strings`.
+ */
+export interface GiftcardStrings {
+    status: Record<GiftcardStatus, string>;
+    giftCard: string;
+    balance: string;
+    personalMessage: string;
+    to: string;
+    from: string;
+    expires: string;
+    recipient: string;
+    viewDetails: string;
+    copyCode: string;
+    /** Successful code-copy feedback. */
+    copiedCode?: string;
+    /** Failed code-copy feedback and retry affordance. */
+    copyFailed?: string;
+    /** Pending code-copy label. */
+    copyingCode?: string;
+}
+export declare const defaultGiftcardStrings: Required<GiftcardStrings>;
+export interface GiftcardCommonProps {
+    /** Override default English giftcard strings. */
+    strings?: StringsProp<GiftcardStrings>;
+}
+export declare const giftcardStatusTone: Record<GiftcardStatus, 'success' | 'secondary' | 'destructive' | 'warning'>;
+export declare const gradientMap: Record<GradientVariant, {
+    card: string;
+    strip: string;
+}>;
+export declare const compactGradientMap: Record<GradientVariant, string>;
+export declare const accentColorMap: Record<AccentColor, {
+    line: string;
+    iconBg: string;
+}>;
+export declare const headerGradientMap: Record<HeaderColor, string>;

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

@@ -0,0 +1,34 @@
+export type { BookingEntry, UpcomingBookingRowProps } from './upcoming-booking';
+export { UpcomingBookingRow } from './upcoming-booking';
+export { Receipt, ReceiptItems, type ReceiptProps, type ReceiptItemsProps, type ReceiptLineItem } from './receipt';
+export { BookingCalendarEventCard, type BookingCalendarEventCardItem, type BookingCalendarEventCardProps, } from './booking-calendar-event-card';
+export type { LoyaltyHistoryEntry, LoyaltyPointsProps, LoyaltyPointsStrings } from './loyalty-points';
+export { LoyaltyPoints, defaultLoyaltyPointsStrings } from './loyalty-points';
+export type { Discount, DiscountStackPreviewProps, DiscountStackStrings } from './discount-stack';
+export { DiscountStackPreview, defaultDiscountStackStrings } from './discount-stack';
+export type { ShipmentDetail, ShipmentStatus, ShipmentTrackingProps, ShipmentTrackingStrings, TrackingStep, } from './shipment-tracking';
+export { ShipmentTracking, defaultShipmentTrackingStrings } from './shipment-tracking';
+export { GiftcardCard, type GiftcardCardProps, type GiftcardCardVariant, type GiftcardData, type GradientVariant, type PatternVariant, type AccentColor, type HeaderColor, } from './giftcard-card';
+export { defaultVendorProfileStrings, VendorProfileCard, type VendorProfileCardProps, type VendorProfileChangeTone, type VendorProfileMetric, type VendorProfileStat, type VendorProfileStrings, type VendorProfileView, } from './vendor-profile';
+export { InventoryLevel, defaultInventoryLevelStrings, type InventoryLevelProps, type InventoryLevelStrings, } from './inventory-level';
+export { TaxBreakdownCard, defaultTaxBreakdownStrings, type TaxBreakdownCardProps, type TaxBreakdownStrings, type TaxLineItem, } from './tax-breakdown';
+export { SubscriptionSummaryCard, defaultSubscriptionSummaryStrings, type SubscriptionSummaryCardProps, type SubscriptionSummaryStrings, type SubscriptionPerk, } from './subscription-summary';
+export { RefundStatusCard, defaultRefundStatusStrings, type RefundStatusCardProps, type RefundStatusStrings, type RefundStage, } from './refund-status';
+export { AddressCard, defaultAddressCardStrings, type AddressCardProps, type AddressCardStrings, type AddressKind, } from './address-card';
+export { VoucherEntry, defaultVoucherEntryStrings, type VoucherEntryProps, type VoucherEntryStrings, } from './voucher-entry';
+export { CartSummaryCard, defaultCartSummaryStrings, type CartSummaryCardProps, type CartSummaryStrings, type CartLineItem, } from './cart-summary';
+export { CouponInputCard, defaultCouponInputStrings, type CouponInputCardProps, type CouponInputStrings, } from './coupon-input';
+export { OrderStatusCard, defaultOrderStatusStrings, type OrderStatusCardProps, type OrderStatusStrings, type OrderStatusEvent, type OrderStatusKind, } from './order-status';
+export { PaymentMethod, defaultPaymentMethodStrings, type PaymentMethodProps, type PaymentMethodStrings, type PaymentBrand, } from './payment-method';
+export { SeoListingCard, DEFAULT_SEO_LISTING_LIMITS, calculateSeoListingScore, defaultSeoListingCardStrings, getSeoPermalinkPath, getSeoPermalinkSlug, type SeoListingCardProps, type SeoListingCardStrings, type SeoListingCheckId, type SeoListingCheckResult, type SeoListingCheckStatus, type SeoListingScoreInput, type SeoListingScoreLimits, type SeoListingScoreResult, } from './seo-listing';
+export type { InvoiceStatus, InvoiceMiniData, InvoiceMiniProps } from './invoice-mini';
+export { InvoiceMini } from './invoice-mini';
+export type { InvoiceHeaderProps, InvoiceParty } from './invoice-header';
+export { InvoiceHeader } from './invoice-header';
+export type { InvoiceLineItem, InvoiceLineItemsProps } from './invoice-line-items';
+export { InvoiceLineItems } from './invoice-line-items';
+export type { OrderTimelineEvent, OrderTimelineProps } from './order-timeline';
+export { OrderTimeline } from './order-timeline';
+export type { PaymentEvent, PaymentTimelineProps } from './payment-timeline';
+export { PaymentTimeline } from './payment-timeline';
+export { InventorySectionCard, defaultInventorySectionStrings, type InventoryPolicy, type InventorySectionCardProps, type InventorySectionChange, type InventorySectionField, type InventorySectionMetric, type InventorySectionName, type InventorySectionStrings, type InventorySectionValue, type InventoryStatus, } from './inventory-section';