themelia-react-ui 2.0.5 → 3.0.0

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

@@ -7,7 +7,7 @@ export interface InventoryLevelProps {
     variant?: string;
     /** Units currently on hand. */
     stock: number;
-    /** Threshold below which stock reads as low. */
+    /** Threshold at or below which stock reads as low. */
     reorderLevel: number;
     /** Capacity used as the gauge's upper bound. */
     maxStock: number;

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

@@ -37,11 +37,6 @@ export interface InventorySectionMetric {
     value: string;
     /** Supporting copy shown under the label. */
     description?: string;
-    /**
-     * Semantic tone of the entry. Not rendered by the summary: stats are plain
-     * and the title badge carries the stock state. Kept for type compatibility.
-     */
-    tone?: 'default' | 'success' | 'warning' | 'error' | 'info';
 }
 export interface InventorySectionStrings {
     /** Surface title. */

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

@@ -61,10 +61,13 @@ export interface InvoiceLineItemsProps<TItem = InvoiceLineItem> {
     /** Optional custom columns. Defaults to Description / Qty / Price / Total. */
     columns?: InvoiceColumn<TItem>[];
     /** Optional custom footer rows. React nodes own their typography, including
-     * total-value weight. When omitted with the default columns, an auto-computed
-     * subtotal / tax / total footer is used. */
+     * total-value weight. When omitted with the default columns, the footer
+     * shows the line total, plus subtotal and tax rows when `taxRate` is set. */
     footerRows?: InvoiceLineItemsFooterRow[];
-    /** Tax ratio for the default footer (`0.2` means 20%). @default 0.2 */
+    /**
+     * Tax ratio for the default footer (`0.2` means 20%). Omit it for no tax
+     * row: the footer then shows only the total of the lines.
+     */
     taxRate?: number;
     /** ISO 4217 code for default monetary cells. Falls back to UIProvider. */
     currency?: string;

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

@@ -1,5 +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 function LoyaltyPoints({ balance, tier, tierTone, history, onRedeem, surface, padding, headerDivider, 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

@@ -1,24 +1,30 @@
 import type { BadgeTone } from '../../../base/badge';
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export interface LoyaltyHistoryEntry {
     /** Display label. */
     label: string;
+    /** Formatted movement. A value without a leading sign gains one from `positive`. */
     points: string;
     date: string;
+    /** Whether the movement earned points (`true`) or spent them (`false`). */
     positive: boolean;
 }
 export interface LoyaltyPointsStrings {
     balanceLabel: string;
     pointsAvailable: string;
     redeem: string;
-    /** Tier chip label used when `tier` is not passed. */
-    tier: string;
+    /** Screen-reader text before an earned movement. */
+    pointsEarned?: string;
+    /** Screen-reader text before a spent movement. */
+    pointsSpent?: string;
 }
-export declare const defaultLoyaltyPointsStrings: LoyaltyPointsStrings;
-export interface LoyaltyPointsProps {
+export declare const defaultLoyaltyPointsStrings: Required<LoyaltyPointsStrings>;
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface LoyaltyPointsProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Points currently available. */
     balance: number | string;
-    /** Membership tier name. Defaults to `strings.tier`. */
+    /** Membership tier name. Omit it to render no tier chip. */
     tier?: string;
     /** Badge tone for the tier chip. A tier is a kind, not a status. @default 'neutral' */
     tierTone?: BadgeTone;

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

@@ -1,5 +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 function OrderStatusCard({ orderNumber, status, statusTone, events, currentEta, surface, padding, headerDivider, 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

@@ -1,4 +1,5 @@
 import type { BadgeTone } from '../../../base/badge';
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export type OrderStatusKind = 'pending' | 'paid' | 'fulfilled' | 'shipped' | 'delivered' | 'cancelled';
 export interface OrderStatusEvent {
@@ -11,17 +12,20 @@ export interface OrderStatusEvent {
 export interface OrderStatusStrings {
     /** Surface title. */
     title: string;
-    /** Not rendered: the title badge states the status. Kept for existing overrides. */
-    statusLabel: string;
+    /** Labels for each supported fulfilment stage. */
+    status?: Partial<Record<OrderStatusKind, string>>;
+    /** Formats the human-facing reference displayed below the title. */
+    formatOrderNumber?: (orderNumber: string) => string;
     /** Label of the delivery-estimate fact. */
     eta: string;
-    /** Not rendered: the timeline shows the latest event. Kept for existing overrides. */
-    latestEvent: string;
-    /** Not rendered: the timeline marks the current step. Kept for existing overrides. */
-    currentStep: string;
+    /** Screen-reader text before a completed event; its marker shows a check only. */
+    completedStep?: string;
+    /** Screen-reader text before an event that has not been reached. */
+    upcomingStep?: string;
 }
-export declare const defaultOrderStatusStrings: OrderStatusStrings;
-export interface OrderStatusCardProps {
+export declare const defaultOrderStatusStrings: OrderStatusStrings & Required<Pick<OrderStatusStrings, 'completedStep' | 'upcomingStep'>>;
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface OrderStatusCardProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Human-facing order reference. */
     orderNumber: string;
     /** Current fulfilment stage. */

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

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

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

@@ -1,4 +1,5 @@
 import { type ReactNode } from 'react';
+import type { CardProps } from '../../../base/cards';
 export interface OrderTimelineEvent {
     /** Stable identity for this entry. */
     id: string;
@@ -10,7 +11,8 @@ export interface OrderTimelineEvent {
     timestamp: string;
     status: 'completed' | 'current' | 'pending';
 }
-export interface OrderTimelineProps {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface OrderTimelineProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */

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

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

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

@@ -3,11 +3,3 @@ export declare function PaymentMethod({ brand, last4, expiry, holderName, defaul
 export declare namespace PaymentMethod {
     var displayName: string;
 }
-/**
- * The source kit's `PaymentMethodCard`: `PaymentMethod` defaulting to the
- * compact `row` identity form. Pass `variant="card"` for the card face.
- */
-export declare function PaymentMethodCard({ variant, ...props }: PaymentMethodProps): import("react").JSX.Element;
-export declare namespace PaymentMethodCard {
-    var displayName: string;
-}

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

@@ -42,5 +42,3 @@ export interface PaymentMethodProps extends Omit<ComponentPropsWithoutRef<'div'>
     /** Overrides this surface's own copy. */
     strings?: StringsProp<PaymentMethodStrings>;
 }
-/** Props of `PaymentMethodCard`: `PaymentMethod` with `variant` defaulting to `row`. */
-export type PaymentMethodCardProps = PaymentMethodProps;

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

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

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

@@ -1,2 +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;
+export declare function ReceiptItems({ items, currency, locale, unit, minorUnitScale, formatMode, strings, className, ...props }: ReceiptItemsProps): import("react").JSX.Element | null;

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

@@ -39,4 +39,14 @@ export interface ReceiptItemsProps extends Omit<ComponentPropsWithoutRef<'div'>,
     minorUnitScale?: MoneyProps['minorUnitScale'];
     /** Defaults to the shared Money policy. */
     formatMode?: MoneyProps['formatMode'];
+    /** Overrides this surface's own copy. */
+    strings?: ReceiptItemsStrings;
+}
+export interface ReceiptItemsStrings {
+    /**
+     * Writes a line's quantity after its name, so a translation owns the
+     * multiplication sign and its position. Receives the formatted quantity.
+     * Defaults to `× <quantity>`.
+     */
+    formatQuantity?: (quantity: ReactNode) => ReactNode;
 }

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

@@ -1,2 +1,2 @@
-export { RefundStatus, RefundStatusCard } from './refund-status';
-export { defaultRefundStatusStrings, type RefundStatusCardProps, type RefundStatusProps, type RefundStatusStrings, type RefundStage, } from './types';
+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

@@ -3,5 +3,3 @@ export declare function RefundStatusCard({ stage, amount, reason, method, eta, r
 export declare namespace RefundStatusCard {
     var displayName: string;
 }
-/** The source kit's name for `RefundStatusCard`; the same component. */
-export declare const RefundStatus: typeof RefundStatusCard;

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

@@ -38,5 +38,3 @@ export interface RefundStatusCardProps extends Omit<ComponentPropsWithoutRef<'di
     /** Overrides this surface's own copy. */
     strings?: StringsProp<RefundStatusStrings>;
 }
-/** The source kit's name for `RefundStatusCardProps`. */
-export type RefundStatusProps = RefundStatusCardProps;

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

@@ -52,10 +52,17 @@ export interface SeoListingCardStrings {
     siteFallback: string;
     titleFallback: string;
     descriptionFallback: string;
+    /** Host shown in the preview breadcrumb when `baseUrl` is missing. Display only: it is never linked. */
     urlFallback: string;
     characters: string;
     maxLabel: string;
     targetLabel: string;
+    /** Writes the score out of 100. Defaults to `"<score>/100"`. */
+    formatScore?: (score: number) => string;
+    /** Writes a title or description length against its target range. Defaults to a sentence built from `characters` and `targetLabel`. */
+    formatLengthDetail?: (actual: number, min: number, max: number) => string;
+    /** Writes a permalink length against its maximum. Defaults to a sentence built from `characters` and `maxLabel`. */
+    formatMaxDetail?: (actual: number, max: number) => string;
     status: Record<SeoListingCheckStatus, string>;
     checkLabels: Record<SeoListingCheckId, string>;
     checkHints: Record<SeoListingCheckId, string>;

package/dist/components/blocks/commerce/shared/code-entry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Private anatomy shared by the commerce code-entry blocks (`CouponInputCard`,
+ * `VoucherEntry`): the success row an accepted code renders in, and the focus
+ * hand-over between the entry form and that row.
+ *
+ * Swapping states unmounts the control the user was on. Without a hand-over
+ * focus falls to `<body>`, and a keyboard or screen-reader user restarts from
+ * the top of the page.
+ */
+import { type ReactNode, type Ref } from 'react';
+type CodeEntryState = 'entry' | 'applied';
+/**
+ * Moves focus across the entry/applied swap, but only for a swap the user
+ * caused from inside the block (or one that removed the element they were on).
+ * A code applied from elsewhere on the page never pulls focus here.
+ */
+export declare function useCodeEntryFocus(applied: boolean): {
+    rootRef: import("react").RefObject<HTMLDivElement | null>;
+    fieldRef: import("react").RefObject<HTMLInputElement | null>;
+    removeRef: import("react").RefObject<HTMLButtonElement | null>;
+    rowRef: import("react").RefObject<HTMLDivElement | null>;
+    expect: (next: CodeEntryState) => void;
+};
+export interface AppliedCodeRowProps {
+    /** Code and applied label, laid out by the owning block. */
+    children: ReactNode;
+    /** Trailing amount: the discount or the remaining balance. */
+    amount?: ReactNode;
+    onRemove?: () => void;
+    /** Accessible name of the remove control. */
+    removeLabel: string;
+    removeRef?: Ref<HTMLButtonElement>;
+    rowRef?: Ref<HTMLDivElement>;
+    /** Merged onto the content column. */
+    contentClassName?: string;
+}
+/** The success-tinted row an accepted code renders in. */
+export declare function AppliedCodeRow({ children, amount, onRemove, removeLabel, removeRef, rowRef, contentClassName, }: AppliedCodeRowProps): import("react").JSX.Element;
+export {};

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

@@ -22,7 +22,7 @@ export type TransactionStatus = 'success' | 'pending' | 'failure';
 export declare const transactionStatusTone: Record<TransactionStatus, BadgeTone>;
 /** Kinds that take money out of the merchant. They set the sign; callers pass the magnitude. */
 export declare const outgoingTransactionKinds: ReadonlySet<TransactionKind>;
-/** A postal address as an order carries it. `AddressCard` keeps its own flat props. */
+/** A postal address as an order carries it. `OrderCustomer` and `AddressCard` take the same shape. */
 export interface OrderAddress {
     /** Recipient. */
     name?: string;

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

@@ -1,5 +1,5 @@
 import { type SubscriptionSummaryCardProps } from './types';
-export declare function SubscriptionSummaryCard({ planName, priceLabel, cycleLabel, nextBillingDate, statusLabel, perks, onManage, onUpgrade, className, strings: stringsProp, }: SubscriptionSummaryCardProps): import("react").JSX.Element;
+export declare function SubscriptionSummaryCard({ planName, priceLabel, cycleLabel, nextBillingDate, statusLabel, statusTone, perks, onManage, onUpgrade, surface, padding, headerDivider, className, strings: stringsProp, }: SubscriptionSummaryCardProps): import("react").JSX.Element;
 export declare namespace SubscriptionSummaryCard {
     var displayName: string;
 }

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

@@ -1,4 +1,6 @@
 import type { LucideIcon } from 'lucide-react';
+import type { BadgeTone } from '../../../base/badge';
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export interface SubscriptionPerk {
     /** Leading glyph. */
@@ -17,7 +19,8 @@ export interface SubscriptionSummaryStrings {
     upgrade: string;
 }
 export declare const defaultSubscriptionSummaryStrings: SubscriptionSummaryStrings;
-export interface SubscriptionSummaryCardProps {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface SubscriptionSummaryCardProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Name of the subscribed plan. */
     planName: string;
     /** Formatted recurring price. */
@@ -28,6 +31,12 @@ export interface SubscriptionSummaryCardProps {
     nextBillingDate: string;
     /** Current subscription state. */
     statusLabel?: string;
+    /**
+     * Badge tone for the status chip. The label is the consumer's copy, so the
+     * block cannot infer whether it is good news: pass `success` for an active
+     * plan, `warning` or `destructive` for past due or cancelled. @default 'neutral'
+     */
+    statusTone?: BadgeTone;
     /** Benefits included in the plan. */
     perks?: SubscriptionPerk[];
     onManage?: () => void;

package/dist/components/blocks/commerce/upcoming-booking/index.d.ts

@@ -1,2 +1,3 @@
 export { UpcomingBookingRow } from './upcoming-booking';
-export type { BookingEntry, UpcomingBookingRowProps } from './types';
+export { defaultUpcomingBookingStrings } from './types';
+export type { BookingEntry, UpcomingBookingRowProps, UpcomingBookingStrings } from './types';

package/dist/components/blocks/commerce/upcoming-booking/types.d.ts

@@ -1,5 +1,6 @@
 import type { Locale } from 'date-fns';
 import type { DateBlockTone, DateBlockVariant } from '../../../base/display/date-block';
+import type { StringsProp } from '../../../../lib/strings';
 /** Booking entry with a locale-aware date value rendered by `DateBlock`. */
 export interface BookingEntry {
     /** Stable identity for this entry. */
@@ -13,9 +14,16 @@ export interface BookingEntry {
     /** Pre-formatted amount (e.g. "120 BGN"). */
     amount: string;
 }
+export interface UpcomingBookingStrings {
+    /** Shown when there are no bookings to list. */
+    empty: string;
+}
+export declare const defaultUpcomingBookingStrings: UpcomingBookingStrings;
 export interface UpcomingBookingRowProps {
     /** Bookings to list, soonest first. */
     bookings: BookingEntry[];
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<UpcomingBookingStrings>;
     /** Merged onto the outermost node. */
     className?: string;
     /** Locale for DateBlock formatting (date-fns). */

package/dist/components/blocks/commerce/upcoming-booking/upcoming-booking.d.ts

@@ -1,5 +1,5 @@
-import type { UpcomingBookingRowProps } from './types';
-export declare function UpcomingBookingRow({ bookings, className, locale, dateTone, dateVariant, timePlacement, }: UpcomingBookingRowProps): import("react").JSX.Element;
+import { type UpcomingBookingRowProps } from './types';
+export declare function UpcomingBookingRow({ bookings, className, locale, dateTone, dateVariant, timePlacement, strings: stringsProp, }: UpcomingBookingRowProps): import("react").JSX.Element;
 export declare namespace UpcomingBookingRow {
     var displayName: string;
 }

package/dist/components/blocks/commerce/vendor-profile/types.d.ts

@@ -1,4 +1,4 @@
-import type { SmartCardSurface } from '../../../base/cards';
+import type { CardSurface } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 import type { ReactNode } from 'react';
 import type { SemanticTone } from '../../../../lib/component-vocabulary';
@@ -77,12 +77,11 @@ export interface VendorProfileCardProps {
     /** Shows the engagement action and delegates its behavior to the consumer. */
     onHire?: () => void;
     /**
-     * Card surface override. Defaults through the shared SmartCard configuration.
+     * Card surface override. Defaults through the shared Card configuration.
      * `flat` also drops the dossier's own insets, so the embedding surface owns them.
      */
-    surface?: SmartCardSurface;
-    /** Card density override. Defaults through the shared SmartCard configuration. */
-    /** Additional classes applied to the outer SmartCard element. */
+    surface?: CardSurface;
+    /** Additional classes applied to the outer Card element. */
     className?: string;
     /** Deep-partial localized label overrides. */
     strings?: StringsProp<VendorProfileStrings>;

package/dist/components/blocks/commerce/voucher-entry/types.d.ts

@@ -1,3 +1,4 @@
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export interface VoucherEntryStrings {
     /** Surface title. */
@@ -10,16 +11,18 @@ export interface VoucherEntryStrings {
     /** Formatted remaining value on the voucher. */
     balance: string;
     applied: string;
+    /** Error copy used when `error` is passed as `true`. */
     notFound: string;
 }
 export declare const defaultVoucherEntryStrings: VoucherEntryStrings;
-export interface VoucherEntryProps {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface VoucherEntryProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Voucher currently applied, if any. */
     appliedCode?: string;
     /** Formatted remaining value on the voucher. */
     balance?: string;
-    /** Validation message for a rejected code. */
-    error?: string;
+    /** Validation message for a rejected code. `true` shows `strings.notFound`. */
+    error?: string | boolean;
     /** Whether a code is being checked. */
     loading?: boolean;
     /** Fired with the trimmed, upper-cased code when the form is submitted. */

package/dist/components/blocks/commerce/voucher-entry/voucher-entry.d.ts

@@ -1,5 +1,5 @@
 import { type VoucherEntryProps } from './types';
-export declare function VoucherEntry({ appliedCode, balance, error, loading, onCheck, onRemove, className, strings: stringsProp, }: VoucherEntryProps): import("react").JSX.Element;
+export declare function VoucherEntry({ appliedCode, balance, error, loading, onCheck, onRemove, surface, padding, headerDivider, className, strings: stringsProp, }: VoucherEntryProps): import("react").JSX.Element;
 export declare namespace VoucherEntry {
     var displayName: string;
 }

package/dist/components/blocks/content-block-hooks.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Blocks that used to render through the deprecated `ContentBlock` adapter now
+ * compose `Card` directly. They keep the DOM hooks that adapter painted on the
+ * root and its regions, so consumer selectors written against them still
+ * match. Spread the result last on the `Card`: like the adapter, it owns
+ * `data-component` and `data-slot`.
+ */
+export declare function contentBlockHooks(className?: string, regions?: {
+    header?: string;
+    content?: string;
+    footer?: string;
+}, 
+/** The explicitly requested inset, mirrored on `data-padding` as the adapter did. */
+padding?: string): {
+    readonly 'data-component': "content-block";
+    readonly 'data-slot': "content-block";
+    readonly 'data-padding': string | undefined;
+    readonly className: string;
+    readonly headerClassName: string;
+    readonly contentClassName: string;
+    readonly footerClassName: string;
+};

package/dist/components/blocks/data-display/dense-info-card/dense-info.strings.d.ts

@@ -5,5 +5,9 @@ export interface DenseInfoStrings {
     tasks: string;
     /** Word after the priority value ("High priority"). Additive, so optional for existing dictionaries. */
     priority?: string;
+    /** Writes the task progress. Defaults to `"<completed>/<total> <tasks>"`. */
+    formatTasks?: (completed: number, total: number) => string;
+    /** Writes the priority line. Defaults to the value followed by `priority`. */
+    formatPriority?: (priority: string) => string;
 }
-export declare const defaultDenseInfoStrings: Required<DenseInfoStrings>;
+export declare const defaultDenseInfoStrings: DenseInfoStrings & Required<Pick<DenseInfoStrings, 'priority'>>;

package/dist/components/blocks/data-display/dense-info-card/helpers.d.ts

@@ -1,11 +1,13 @@
 import { type DenseInfoBadgeTone } from './types';
-export declare function ScaleBar({ value, max, label, }: {
+export declare function ScaleBar({ value, max, label, name, }: {
     /** Current amount, used to fill the bar. */
     value: number;
     /** Value representing a full bar. Default: `5`. */
     max?: number;
     /** Caption shown beside the bar. */
     label?: string;
+    /** Accessible name of the meter: what the bar measures. */
+    name?: string;
 }): import("react").JSX.Element;
 export declare function KVRow({ label, value, badge, badgeTone, }: {
     /** Row label. */

package/dist/components/blocks/data-display/dense-info-card/index.d.ts

@@ -4,4 +4,4 @@ export { DenseInfoFinancial } from './partials/dense-info-financial';
 export { DenseInfoProjectCard } from './partials/dense-info-project';
 export { DenseInfoScoreCard } from './partials/dense-info-score';
 export { defaultDenseInfoStrings, type DenseInfoStrings, } from './dense-info.strings';
-export type { DenseInfoBadgeTone, DashboardStatusBadge, DashboardKeyValueRow, DenseInfoDashboardProps, ClassificationStat, ClassificationRow, DenseInfoClassificationProps, FinancialHeaderBadge, FinancialLineItem, DenseInfoFinancialProps, ProjectMetaPair, DenseInfoProjectCardProps, ScoreKeyValueRow, DenseInfoScoreCardProps, } from './types';
+export type { DenseInfoBadgeTone, DenseInfoSurfaceProps, DashboardStatusBadge, DashboardKeyValueRow, DenseInfoDashboardProps, ClassificationStat, ClassificationRow, DenseInfoClassificationProps, FinancialHeaderBadge, FinancialLineItem, DenseInfoFinancialProps, ProjectMetaPair, DenseInfoProjectCardProps, ScoreKeyValueRow, DenseInfoScoreCardProps, } from './types';

package/dist/components/blocks/data-display/dense-info-card/partials/dense-info-classification.d.ts

@@ -1,5 +1,5 @@
 import { type DenseInfoClassificationProps } from '../types';
-export declare function DenseInfoClassification({ title, description, stats, items, totalLabel, totalValue, footerBadges, footerText, actions, className, strings: stringsProp, }: DenseInfoClassificationProps): import("react").JSX.Element;
+export declare function DenseInfoClassification({ title, description, stats, items, totalLabel, totalValue, footerBadges, footerText, actions, surface, padding, headerDivider, className, strings: stringsProp, }: DenseInfoClassificationProps): import("react").JSX.Element;
 export declare namespace DenseInfoClassification {
     var displayName: string;
 }

package/dist/components/blocks/data-display/dense-info-card/partials/dense-info-dashboard.d.ts

@@ -1,5 +1,5 @@
 import { type DenseInfoDashboardProps } from '../types';
-export declare function DenseInfoDashboard({ title, description, statusBadges, rows, secondaryRows, scale, footerBadges, footerText, actions, className, }: DenseInfoDashboardProps): import("react").JSX.Element;
+export declare function DenseInfoDashboard({ title, description, statusBadges, rows, secondaryRows, scale, footerBadges, footerText, actions, surface, padding, headerDivider, className, }: DenseInfoDashboardProps): import("react").JSX.Element;
 export declare namespace DenseInfoDashboard {
     var displayName: string;
 }

package/dist/components/blocks/data-display/dense-info-card/partials/dense-info-financial.d.ts

@@ -1,5 +1,5 @@
 import { type DenseInfoFinancialProps } from '../types';
-export declare function DenseInfoFinancial({ title, description, headerBadges, lineItems, totalLabel, totalAmount, footerBadges, footerText, actions, className, strings: stringsProp, }: DenseInfoFinancialProps): import("react").JSX.Element;
+export declare function DenseInfoFinancial({ title, description, headerBadges, lineItems, totalLabel, totalAmount, footerBadges, footerText, actions, surface, padding, headerDivider, className, strings: stringsProp, }: DenseInfoFinancialProps): import("react").JSX.Element;
 export declare namespace DenseInfoFinancial {
     var displayName: string;
 }

package/dist/components/blocks/data-display/dense-info-card/partials/dense-info-project.d.ts

@@ -1,5 +1,5 @@
 import { type DenseInfoProjectCardProps } from '../types';
-export declare function DenseInfoProjectCard({ title, description, statusLabel, statusTone, metaPairs, date, priority, completedTasks, totalTasks, actions, className, strings: stringsProp, }: DenseInfoProjectCardProps): import("react").JSX.Element;
+export declare function DenseInfoProjectCard({ title, description, statusLabel, statusTone, metaPairs, date, priority, completedTasks, totalTasks, actions, surface, padding: paddingProp, headerDivider, className, strings: stringsProp, }: DenseInfoProjectCardProps): import("react").JSX.Element;
 export declare namespace DenseInfoProjectCard {
     var displayName: string;
 }

package/dist/components/blocks/data-display/dense-info-card/partials/dense-info-score.d.ts

@@ -1,5 +1,5 @@
 import { type DenseInfoScoreCardProps } from '../types';
-export declare function DenseInfoScoreCard({ title, description, statusBadges, score, scoreLevel, scoreFilled, scoreTotal, rows, footerBadges, actions, className, }: DenseInfoScoreCardProps): import("react").JSX.Element;
+export declare function DenseInfoScoreCard({ title, description, statusBadges, score, scoreLevel, scoreFilled, scoreTotal, rows, footerBadges, actions, surface, padding, headerDivider, className, }: DenseInfoScoreCardProps): import("react").JSX.Element;
 export declare namespace DenseInfoScoreCard {
     var displayName: string;
 }

package/dist/components/blocks/data-display/dense-info-card/types.d.ts

@@ -1,8 +1,15 @@
 import { type ReactNode } from 'react';
 import type { ActionMenuAction } from '../../../base/action-menu';
+import type { CardProps } from '../../../base/cards';
 import type { SemanticTone } from '../../../../lib/component-vocabulary';
 import type { StringsProp } from '../../../../lib/strings';
 import type { DenseInfoStrings } from './dense-info.strings';
+/**
+ * Surface seam shared by the DenseInfo blocks. Unframed and inset-free by
+ * default, so the composing Card owns the frame; set `surface="card"` (or a
+ * `padding`) to let the block own it.
+ */
+export type DenseInfoSurfaceProps = Pick<CardProps, 'surface' | 'padding' | 'headerDivider'>;
 export type DenseInfoBadgeTone = SemanticTone;
 export interface DashboardStatusBadge {
     /** Display label. */
@@ -17,7 +24,7 @@ export interface DashboardKeyValueRow {
     badge?: string;
     badgeTone?: DenseInfoBadgeTone;
 }
-export interface DenseInfoDashboardProps {
+export interface DenseInfoDashboardProps extends DenseInfoSurfaceProps {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */
@@ -59,7 +66,7 @@ export interface ClassificationRow {
     badge?: string;
     badgeTone?: DenseInfoBadgeTone;
 }
-export interface DenseInfoClassificationProps {
+export interface DenseInfoClassificationProps extends DenseInfoSurfaceProps {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */
@@ -96,7 +103,7 @@ export interface FinancialLineItem {
     badge?: string;
     badgeTone?: DenseInfoBadgeTone;
 }
-export interface DenseInfoFinancialProps {
+export interface DenseInfoFinancialProps extends DenseInfoSurfaceProps {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */
@@ -126,7 +133,7 @@ export interface ProjectMetaPair {
     /** Display label. */
     label: string;
 }
-export interface DenseInfoProjectCardProps {
+export interface DenseInfoProjectCardProps extends DenseInfoSurfaceProps {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */
@@ -157,7 +164,7 @@ export interface ScoreKeyValueRow {
     label: string;
     value: string;
 }
-export interface DenseInfoScoreCardProps {
+export interface DenseInfoScoreCardProps extends DenseInfoSurfaceProps {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */