themelia-react-ui 0.0.0-stage → 1.0.0

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';

package/dist/components/blocks/commerce/inventory-level/index.d.ts

@@ -0,0 +1,3 @@
+export { InventoryLevel } from './inventory-level';
+export type { InventoryLevelProps } from './types';
+export { defaultInventoryLevelStrings, type InventoryLevelStrings, } from './inventory-level.strings';

package/dist/components/blocks/commerce/inventory-level/inventory-level.d.ts

@@ -0,0 +1,5 @@
+import type { InventoryLevelProps } from './types';
+export declare function InventoryLevel({ productName, variant, stock, reorderLevel, maxStock, lastRestocked, className, strings: stringsProp, }: InventoryLevelProps): import("react").JSX.Element;
+export declare namespace InventoryLevel {
+    var displayName: string;
+}

package/dist/components/blocks/commerce/inventory-level/inventory-level.strings.d.ts

@@ -0,0 +1,10 @@
+export interface InventoryLevelStrings {
+    statusInStock: string;
+    statusLowStock: string;
+    statusCritical: string;
+    variantLabel: string;
+    unitsAvailable: string;
+    reorderAtLabel: string;
+    lastRestockedLabel: string;
+}
+export declare const defaultInventoryLevelStrings: InventoryLevelStrings;

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

@@ -0,0 +1,20 @@
+import type { StringsProp } from '../../../../lib/strings';
+import type { InventoryLevelStrings } from './inventory-level.strings';
+export interface InventoryLevelProps {
+    /** Product the stock belongs to. */
+    productName: string;
+    /** Variant name, when the product has options. */
+    variant?: string;
+    /** Units currently on hand. */
+    stock: number;
+    /** Threshold below which stock reads as low. */
+    reorderLevel: number;
+    /** Capacity used as the gauge's upper bound. */
+    maxStock: number;
+    /** Formatted date of the last restock. */
+    lastRestocked?: string;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<InventoryLevelStrings>;
+}

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

@@ -0,0 +1,2 @@
+export { InventorySectionCard } from './inventory-section';
+export { defaultInventorySectionStrings, type InventoryPolicy, type InventorySectionCardProps, type InventorySectionChange, type InventorySectionField, type InventorySectionMetric, type InventorySectionName, type InventorySectionStrings, type InventorySectionValue, type InventoryStatus, } from './types';

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

@@ -0,0 +1,5 @@
+import { type InventorySectionCardProps } from './types';
+export declare function InventorySectionCard({ value, onValueChange, errors, disabled, readOnly, visibleSections, visibleFields, locationOptions, countryOptions, tagRecommendations, maxTags, onGenerateSku, onRestock, className, strings: stringsProp, }: InventorySectionCardProps): import("react").JSX.Element;
+export declare namespace InventorySectionCard {
+    var displayName: string;
+}

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

@@ -0,0 +1,105 @@
+import type { SelectOption } from '../../../base/choice-inputs';
+import type { WeightUnit } from '../../../base/forms-numeric';
+import type { StringsProp } from '../../../../lib/strings';
+export type InventoryPolicy = 'deny' | 'continue';
+export type InventoryStatus = 'in_stock' | 'low_stock' | 'out_of_stock' | 'untracked';
+export interface InventorySectionValue {
+    sku?: string;
+    barcode?: string;
+    trackQuantity?: boolean;
+    available?: string;
+    committed?: string;
+    incoming?: string;
+    lowStockThreshold?: string;
+    inventoryPolicy?: InventoryPolicy;
+    locationId?: string;
+    binLocation?: string;
+    requiresShipping?: boolean;
+    weight?: string;
+    weightUnit?: WeightUnit;
+    countryOfOrigin?: string;
+    hsCode?: string;
+    tags?: string[];
+}
+export type InventorySectionField = keyof InventorySectionValue;
+export type InventorySectionName = 'summary' | 'identity' | 'tracking' | 'location' | 'shipping' | 'customs' | 'tags';
+export interface InventorySectionChange {
+    field: InventorySectionField;
+    value: InventorySectionValue[InventorySectionField];
+    previousValue: InventorySectionValue[InventorySectionField];
+}
+export interface InventorySectionMetric {
+    /** Stable identity for this entry. */
+    id: string;
+    /** Display label. */
+    label: string;
+    value: string;
+    /** Supporting copy shown under the label. */
+    description?: string;
+    /** Semantic tone driving the entry's colour. */
+    tone?: 'default' | 'success' | 'warning' | 'error' | 'info';
+}
+export interface InventorySectionStrings {
+    /** Surface title. */
+    title: string;
+    /** Supporting copy shown under the label. */
+    description: string;
+    status: Record<InventoryStatus, string>;
+    sections: Record<Exclude<InventorySectionName, 'summary'>, string>;
+    fields: Record<InventorySectionField, string>;
+    placeholders: Partial<Record<InventorySectionField, string>>;
+    hints: Partial<Record<InventorySectionField, string>>;
+    /** Overflow menu for the surface as a whole. */
+    actions: {
+        generateSku: string;
+        restock: string;
+    };
+    policyOptions: Record<InventoryPolicy, {
+        label: string;
+        description: string;
+    }>;
+    summary: {
+        available: string;
+        committed: string;
+        incoming: string;
+        threshold: string;
+        untracked: string;
+    };
+    tagInput: {
+        placeholder: string;
+        emptyRecommendations: string;
+        clearAll: string;
+        summary: (current: number, max: number) => string;
+    };
+}
+export declare const defaultInventorySectionStrings: InventorySectionStrings;
+export interface InventorySectionCardProps {
+    /** Current field values for every inventory section. Controlled. */
+    value: InventorySectionValue;
+    /** Fired with the next value. */
+    onValueChange?: (value: InventorySectionValue, change: InventorySectionChange) => void;
+    /** Validation messages keyed by field, rendered under the matching control. */
+    errors?: Partial<Record<InventorySectionField, string>>;
+    /** Renders the entry as unselectable. */
+    disabled?: boolean;
+    /** Renders every field as read-only text instead of an editable control. */
+    readOnly?: boolean;
+    /** Which sections are shown. Omitted sections default to visible. */
+    visibleSections?: Partial<Record<InventorySectionName, boolean>>;
+    /** Which individual fields are shown. Omitted fields default to visible. */
+    visibleFields?: Partial<Record<InventorySectionField, boolean>>;
+    /** Choices for the stock-location select. */
+    locationOptions?: SelectOption[];
+    /** Choices for the country-of-origin select. */
+    countryOptions?: SelectOption[];
+    /** Suggested tags offered beneath the tag input. */
+    tagRecommendations?: string[];
+    /** Caps how many tags may be added. */
+    maxTags?: number;
+    onGenerateSku?: (value: InventorySectionValue) => string | void;
+    onRestock?: (value: InventorySectionValue) => void;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<InventorySectionStrings>;
+}

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

@@ -0,0 +1,2 @@
+export { InvoiceHeader } from './invoice-header';
+export type { InvoiceHeaderProps, InvoiceParty } from './types';

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

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