themelia-react-ui 1.0.2 → 2.0.1

package/dist/lib/format.d.ts

@@ -13,6 +13,15 @@
  * dual-currency UIs.
  */
 export declare const EMPTY = "\u2014";
+/** U+2212 MINUS SIGN. Intl emits U+002D HYPHEN-MINUS for negatives in most locales. */
+export declare const MINUS_SIGN = "\u2212";
+/**
+ * Formats with Intl and draws a negative sign as U+2212, the typographic minus
+ * commerce surfaces already use: it has the width of a digit, so signed values
+ * align in tabular columns. Only the hyphen-minus inside the `minusSign` part
+ * changes, so locale minus forms and bidi marks (fa, he, ar) survive.
+ */
+export declare function formatWithMinusSign(formatter: Intl.NumberFormat, value: number): string;
 export interface FormatNumberOptions {
     locale?: string;
     minimumFractionDigits?: number;

package/dist/lib/interaction-recipes.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Interaction fills, one recipe per element shape. The theme documents --accent as
+ * the hover and selected-row fill and --muted as a passive region, so every
+ * clickable row, toggle, table and segmented track agrees on what hover, selection
+ * and the current location look like. Design lint rejects other interaction fills.
+ */
+export declare const interactionRecipes: {
+    /** Clickable rows (navigation, lists, trees, results, disclosure triggers) and ghost actions. */
+    readonly rowHover: "hover:bg-accent hover:text-accent-foreground";
+    /** A selected or keyboard-highlighted row: the hover fill held. */
+    readonly rowSelected: "bg-accent text-accent-foreground";
+    /** The current location: the selected fill plus medium weight, so a hover never reads as current. */
+    readonly rowCurrent: "bg-accent text-accent-foreground font-medium";
+    /** Toggles show their pressed state by fill alone, so hover is the lighter muted fill. */
+    readonly toggleHover: "hover:bg-muted hover:text-foreground";
+    readonly togglePressed: "bg-accent text-accent-foreground";
+    /** The toggle hover on a Button, whose complete hover selector would otherwise show the pressed fill. */
+    readonly toggleHoverButton: "[&:hover:not(:active):not(:disabled):not([data-disabled]):not([aria-disabled=true])]:bg-muted [&:hover:not(:active):not(:disabled):not([data-disabled]):not([aria-disabled=true])]:text-foreground";
+    /** Wide tabular rows stay quieter: stripe, hover and selection step up one tint at a time. */
+    readonly tableHead: "bg-muted/50";
+    readonly tableStripe: "bg-muted/30";
+    readonly tableRowHover: "hover:bg-muted/50";
+    readonly tableRowSelected: "data-[state=selected]:bg-muted";
+    /** Media and choice tiles: hover strengthens the resting edge to the control boundary; selection draws primary. */
+    readonly tileHover: "hover:border-input";
+    /** Segments on a muted track: the active one is lifted, the others change colour only. */
+    readonly segmentActive: "bg-card text-foreground shadow-sm";
+    readonly segmentInactive: "text-muted-foreground hover:text-foreground";
+    /** The same inactive segment rendered by a ghost Button: its complete hover and press selectors are cleared too. */
+    readonly segmentInactiveButton: "text-muted-foreground hover:text-foreground [&:hover:not(:active):not(:disabled):not([data-disabled]):not([aria-disabled=true])]:bg-transparent [&:active:not(:disabled):not([data-disabled]):not([aria-disabled=true])]:bg-transparent";
+    /** The active segment rendered by a ghost Button stays lifted under hover and press instead of taking the Button's fill. */
+    readonly segmentActiveButton: "bg-card text-foreground shadow-sm hover:text-foreground [&:hover:not(:active):not(:disabled):not([data-disabled]):not([aria-disabled=true])]:bg-card [&:active:not(:disabled):not([data-disabled]):not([aria-disabled=true])]:bg-card";
+    /** A solid Button marking the current location holds its fill: no hover or press filter. */
+    readonly currentButtonHold: "[&:hover:not(:active):not(:disabled):not([data-disabled]):not([aria-disabled=true])]:brightness-100 [&:active:not(:disabled):not([data-disabled]):not([aria-disabled=true])]:brightness-100";
+};

package/dist/lib/layer-recipes.d.ts

@@ -0,0 +1,19 @@
+/**
+ * One stacking scale. Local overlap inside a component is raised; sticky regions
+ * stack under the app chrome; popups and modal layers sit above the page. Local
+ * ordering may also use z-0, z-[1] and z-[-1]. Design lint rejects other layers.
+ */
+export declare const layerRecipes: {
+    /** Overlap inside one component: a badge on a tile, an action over media. */
+    readonly raised: "z-10";
+    /** Sticky headers and toolbars inside a scroll region. */
+    readonly sticky: "z-20";
+    /** Sticky parts that must stay above other sticky ones: a sticky corner cell or footer. */
+    readonly stickyOver: "z-30";
+    /** Application chrome: the shell header and floating panels. */
+    readonly chrome: "z-40";
+    /** Popups, menus, tooltips and modal layers. */
+    readonly overlay: "z-50";
+    /** A popup portaled into a consumer container clears the modal layer it opened from. */
+    readonly nestedOverlay: "z-[100]";
+};

package/dist/lib/money-format.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared money formatting for the Money primitive and metric surfaces.
+ *
+ * One formatter keeps currency labels, fraction digits and format modes
+ * identical wherever an amount is shown. Components resolve locale, currency
+ * and format mode from UIProvider before calling it.
+ */
+import type { MoneyFormatMode } from './ui-provider/types';
+/** A numeric amount or an unformatted decimal string. */
+export type MoneyAmountInput = number | string | null | undefined;
+export interface FormatMoneyAmountOptions {
+    /** Major-unit amount. Strings accept either decimal separator. */
+    amount: MoneyAmountInput;
+    /** ISO 4217 currency code; an empty value formats as a plain decimal. */
+    currency?: string | null;
+    /** BCP-47 locale for Intl formatting. */
+    locale?: string;
+    /** Intl currency label style when the format mode uses currency formatting. */
+    currencyDisplay?: Intl.NumberFormatOptions['currencyDisplay'];
+    /** Minimum decimal digits. Defaults to the currency's Intl convention. */
+    minimumFractionDigits?: number;
+    /** Maximum decimal digits. Defaults to the currency's Intl convention. */
+    maximumFractionDigits?: number;
+    /** Provider format policy: decimal, with_code, with_symbol or locale_aware. */
+    formatMode?: MoneyFormatMode;
+    /** Consumer-resolved symbol; Intl placement is preserved. */
+    symbol?: string | null;
+}
+export declare function parseMoneyAmount(amount: MoneyAmountInput): number | null;
+export declare function formatMoneyAmount({ amount, currency, locale, currencyDisplay, minimumFractionDigits, maximumFractionDigits, formatMode, symbol, }: FormatMoneyAmountOptions): string | null;

package/dist/lib/motion-recipes.d.ts

@@ -5,4 +5,5 @@ export declare const motionRecipes: {
     readonly popup: `transition-[opacity,scale,translate] duration-150 ease-out data-ending-style:duration-100 data-starting-style:opacity-0 data-ending-style:opacity-0 data-starting-style:scale-95 data-ending-style:scale-95 ${string} motion-reduce:transition-none motion-reduce:duration-0 motion-reduce:data-ending-style:duration-0`;
     readonly disclosure: "overflow-hidden transition-[height,padding-block] duration-200 ease-out data-starting-style:h-0 data-ending-style:h-0 data-starting-style:py-0! data-ending-style:py-0! motion-reduce:transition-none motion-reduce:duration-0 motion-reduce:data-ending-style:duration-0";
     readonly chevron: "transition-transform duration-200 ease-out motion-reduce:transition-none motion-reduce:duration-0 motion-reduce:data-ending-style:duration-0";
+    readonly dock: "transition-[opacity,translate] duration-150 ease-out starting:opacity-0 starting:translate-y-space-lg motion-reduce:transition-none motion-reduce:duration-0 motion-reduce:data-ending-style:duration-0";
 };

package/dist/lib/overlay-anatomy-recipes.d.ts

@@ -3,6 +3,7 @@
  * These are derived recipes, not additional theme settings.
  */
 export declare const overlayAnatomyRecipes: {
-    readonly close: "absolute top-[calc(var(--surface-y)*var(--space-scale))] end-[calc(var(--surface-x)*var(--space-scale))]";
+    readonly close: "absolute top-[calc(var(--surface-y)*var(--space-scale)+(var(--text-base)*var(--leading-snug)-var(--height-action)*8/9*var(--density-scale))/2)] end-[calc(var(--surface-x)*var(--space-scale))]";
     readonly header: "[[data-slot$=-content]:has(>[data-overlay-close])>&]:pe-[calc(var(--surface-x)*var(--space-scale)+var(--height-action)*8/9*var(--density-scale)+0.5rem*var(--space-scale))]";
+    readonly headerCentered: "[[data-slot$=-content]:has(>[data-overlay-close])>&]:ps-[calc(var(--surface-x)*var(--space-scale)+var(--height-action)*8/9*var(--density-scale)+0.5rem*var(--space-scale))]";
 };

package/dist/lib/safe-image-src.d.ts

@@ -0,0 +1,10 @@
+/** Schemes an image `src` may use: web URLs and same-document `blob:` previews. */
+export declare const SAFE_IMAGE_SCHEMES: readonly ["http", "https", "blob"];
+/**
+ * The one image-source policy shared by the editor and read-only rich text.
+ * Returns the source when it is a web URL, a `blob:` preview or a relative
+ * path, and `undefined` otherwise: script, `data:` and other schemes and
+ * protocol-relative (`//host`) URLs are refused. Control characters and
+ * whitespace inside a scheme are ignored, so `java\tscript:` is still refused.
+ */
+export declare function safeImageSrc(value: unknown): string | undefined;

package/dist/lib/sanitize-html.d.ts

@@ -1,8 +1,20 @@
+import type { Root } from 'hast';
+export interface SanitizeHtmlOptions {
+    /**
+     * Keeps `<img>` with `src`, `alt`, `title`, `width` and `height` when its
+     * source passes `safeImageSrc`; an image without a safe source is removed.
+     * Default: `false`, which removes every image.
+     */
+    images?: boolean;
+}
 /**
  * Sanitize package-rendered rich text with an intentionally small HTML
  * vocabulary. Styling, event handlers, embedded media, and protocol-relative
- * URLs are excluded. Mention identity attributes remain available so the
- * Mentions feature can replace serialized references with React components.
+ * URLs are excluded; images only with `options.images` and a safe source.
+ * Mention identity attributes remain available so the Mentions feature can
+ * replace serialized references with React components.
  */
-export declare function sanitizeHtml(input: string): string;
+export declare function sanitizeHtml(input: string, options?: SanitizeHtmlOptions): string;
+/** The sanitized tree behind `sanitizeHtml`, for renderers that substitute elements. */
+export declare function sanitizeHtmlTree(input: string, options?: SanitizeHtmlOptions): Root;
 export default sanitizeHtml;

package/dist/lib/surface-recipes.d.ts

@@ -6,6 +6,7 @@ export declare const surfaceDividerRecipes: {
         readonly shell: "border border-border";
         readonly header: "border-b border-border";
         readonly footer: "border-t border-border";
+        readonly ring: "ring-4 ring-border/30";
     };
     readonly anchored: {
         readonly shell: "border border-border";
@@ -15,16 +16,57 @@ export declare const surfaceDividerRecipes: {
     };
     readonly modal: {
         readonly shell: "border border-border/70";
-        readonly header: "border-b border-border/70";
-        readonly footer: "border-t border-border/70";
+        readonly edge: "border-border/70 data-[side=left]:border-r data-[side=right]:border-l data-[side=top]:border-b data-[side=bottom]:border-t";
+        readonly region: "border-border/60 [[data-modal-region]:not(.sr-only)~&]:border-t";
     };
     readonly sidebar: {
         readonly footer: "border-t border-sidebar-border";
     };
 };
-/** Regions own their inset once; scrolling and alignment remain with the family. */
+/** Each region owns its full inset once and the shell adds none, so the rules
+ * between regions span the surface edge to edge (header, body and footer read as
+ * three bands). The body scrolls between the pinned header and footer; scrolling
+ * and alignment remain with the family. */
 export declare const modalRegionRecipes: {
-    readonly header: "shrink-0 border-b border-border/70 p-surface text-start";
-    readonly body: "min-h-0 flex-1 overflow-y-auto p-surface";
-    readonly footer: "shrink-0 flex-wrap gap-space-sm border-t border-border/70 bg-muted/20 p-surface";
+    readonly header: "shrink-0 p-surface text-start border-border/60 [[data-modal-region]:not(.sr-only)~&]:border-t";
+    readonly body: "min-h-0 flex-1 overflow-y-auto p-surface border-border/60 [[data-modal-region]:not(.sr-only)~&]:border-t";
+    readonly footer: "shrink-0 flex-wrap gap-space-sm p-surface border-border/60 [[data-modal-region]:not(.sr-only)~&]:border-t";
+};
+/**
+ * Neutral fills, one strength per role, so quiet regions, strips, tracks, chips and
+ * neutral markers read alike in every family. Design lint rejects other strengths.
+ * - `wash`: a quiet region inside a surface: wells, empty states, stripes, media placeholders.
+ * - `band`: a header, toolbar or footer strip, and a soft icon tile.
+ * - `track`: the solid track behind segments, meters and progress.
+ * - `chip`: a neutral chip or icon tile that reads on any surface, tinted or not.
+ * - `chipOnInverse`: the same chip on an inverse surface.
+ * - `marker`: a neutral dot or filled meter segment; `markerIdle`: an inactive indicator.
+ * Floating chips and lifted panels use an opaque surface instead of a translucent one.
+ */
+export declare const neutralFillRecipes: {
+    readonly wash: "bg-muted/30";
+    readonly band: "bg-muted/50";
+    readonly track: "bg-muted";
+    readonly chip: "bg-foreground/8";
+    readonly chipOnInverse: "bg-background/10";
+    readonly marker: "bg-muted-foreground";
+    readonly markerIdle: "bg-muted-foreground/40";
+};
+/** A key cap for shortcut hints: a solid track-coloured chip with the compact secondary text role. */
+export declare const kbdRecipe = "pointer-events-none inline-flex h-5 w-fit min-w-5 shrink-0 select-none items-center justify-center gap-space-2xs rounded-radius-xs bg-muted px-space-xs font-sans text-xs font-medium leading-none text-muted-foreground";
+/**
+ * Elevation, one theme shadow per role; the theme owns the shadow ladder itself.
+ * - `resting`: tiles, rows and table frames that sit on a surface.
+ * - `card`: cards, lifted segments, thumbs and small controls floating over media.
+ * - `raised`: raised cards, hover lifts, anchored popups and controls over media.
+ * - `lifted`: dragged items, toasts and drawers.
+ * - `modal`: dialogs and command palettes.
+ * `shadow-none` clears elevation. Box-shadow divider lines draw var(--border) instead.
+ */
+export declare const elevationRecipes: {
+    readonly resting: "shadow-xs";
+    readonly card: "shadow-sm";
+    readonly raised: "shadow-md";
+    readonly lifted: "shadow-lg";
+    readonly modal: "shadow-xl";
 };

package/dist/lib/token-merge.generated.d.ts

@@ -32,12 +32,15 @@ export declare const tokenClassGroups: {
     size: {
         size: string[];
     }[];
-    mb: {
-        mb: string[];
+    m: {
+        m: string[];
     }[];
     ml: {
         ml: string[];
     }[];
+    ms: {
+        ms: string[];
+    }[];
     mt: {
         mt: string[];
     }[];
@@ -56,6 +59,12 @@ export declare const tokenClassGroups: {
     py: {
         py: string[];
     }[];
+    inset: {
+        inset: string[];
+    }[];
+    my: {
+        my: string[];
+    }[];
     bottom: {
         bottom: string[];
     }[];
@@ -92,12 +101,6 @@ export declare const tokenClassGroups: {
     me: {
         me: string[];
     }[];
-    ms: {
-        ms: string[];
-    }[];
-    inset: {
-        inset: string[];
-    }[];
     "inset-x": {
         "inset-x": string[];
     }[];
@@ -110,21 +113,18 @@ export declare const tokenClassGroups: {
     "space-y": {
         "space-y": string[];
     }[];
-    m: {
-        m: string[];
-    }[];
     "max-w": {
         "max-w": string[];
     }[];
+    mb: {
+        mb: string[];
+    }[];
     "min-w": {
         "min-w": string[];
     }[];
     mr: {
         mr: string[];
     }[];
-    my: {
-        my: string[];
-    }[];
     pl: {
         pl: string[];
     }[];
@@ -140,5 +140,8 @@ export declare const tokenClassGroups: {
     start: {
         start: string[];
     }[];
+    "translate-y": {
+        "translate-y": string[];
+    }[];
 };
 export declare const tokenCandidates: string[][];

package/dist/lib/tone-recipes.d.ts

@@ -0,0 +1,79 @@
+/**
+ * One tint scale for every status tone. The contrast contract tests each tone's ink
+ * on its own tint (20%, destructive 10%), so strengths live here, not in each
+ * component:
+ * - `wash` tints a large surface (alerts, callouts, highlighted rows) and stays
+ *   subtle; the saturated hues (info, destructive, primary) wash at 5%.
+ * - `tint` fills chips, badges and icon tiles that carry the tone's ink.
+ * - `edge`, `halo` and `line` draw a toned border, ring and connector.
+ * - `solid` fills dots, bars and markers.
+ * Design lint rejects status tints spelled anywhere else.
+ */
+export declare const toneRecipes: {
+    readonly info: {
+        readonly wash: "bg-info/5";
+        readonly tint: "bg-info/20";
+        readonly edge: "border-info/30";
+        readonly halo: "ring-info/30";
+        readonly line: "bg-info/30";
+        readonly ink: "text-info";
+        readonly solid: "bg-info";
+    };
+    readonly success: {
+        readonly wash: "bg-success/10";
+        readonly tint: "bg-success/20";
+        readonly edge: "border-success/30";
+        readonly halo: "ring-success/30";
+        readonly line: "bg-success/30";
+        readonly ink: "text-success";
+        readonly solid: "bg-success";
+    };
+    readonly warning: {
+        readonly wash: "bg-warning/10";
+        readonly tint: "bg-warning/20";
+        readonly edge: "border-warning/40";
+        readonly halo: "ring-warning/40";
+        readonly line: "bg-warning/40";
+        readonly ink: "text-warning-accent";
+        readonly solid: "bg-warning";
+    };
+    readonly destructive: {
+        readonly wash: "bg-destructive/5";
+        readonly tint: "bg-destructive/10";
+        readonly edge: "border-destructive/30";
+        readonly halo: "ring-destructive/30";
+        readonly line: "bg-destructive/30";
+        readonly ink: "text-destructive";
+        readonly solid: "bg-destructive";
+    };
+    readonly primary: {
+        readonly wash: "bg-primary/5";
+        readonly tint: "bg-primary/20";
+        readonly edge: "border-primary/30";
+        readonly halo: "ring-primary/30";
+        readonly line: "bg-primary/30";
+        readonly ink: "text-primary-accent";
+        readonly solid: "bg-primary";
+    };
+};
+export type ToneRecipeName = keyof typeof toneRecipes;
+/**
+ * Inline marks inside running text: a search match, and an edit's removed and
+ * added values. Each is a tone tint behind the run, never a box around it. A
+ * match often sits inside a word, so it adds no inline padding that would split it.
+ */
+export declare const markRecipes: {
+    readonly match: "rounded-radius-xs text-foreground bg-warning/20";
+    readonly removed: "rounded-radius-sm px-space-2xs line-through bg-destructive/10 text-destructive";
+    readonly added: "rounded-radius-sm px-space-2xs bg-success/20 text-success";
+};
+/**
+ * Sequential data ramps: an empty step, then rising strengths of one hue. They
+ * encode quantity, not status, so they live apart from the tint scale above.
+ */
+export declare const rampRecipes: {
+    /** Activity heatmap cells (SVG fills): empty and four levels. */
+    readonly activity: readonly ["fill-muted", "fill-success/20", "fill-success/40", "fill-success/65", "fill-success"];
+    /** Distribution ruler segments: empty, low, medium and high. */
+    readonly density: readonly ["bg-muted", "bg-primary/25", "bg-primary/55", "bg-primary"];
+};

package/dist/lib/track-recipes.d.ts

@@ -1,4 +1,4 @@
 import type { ComponentScale } from './component-vocabulary';
 /** Shared progress/slider track thickness, derived from spacing; no public knobs. */
 export declare const trackHeightClasses: Record<ComponentScale, string>;
-export declare const sliderTrackThickness = "data-[orientation=horizontal]:h-[calc(var(--spacing-space-sm)+2px)] data-[orientation=vertical]:w-[calc(var(--spacing-space-sm)+2px)]";
+export declare const sliderTrackThickness = "data-[orientation=horizontal]:h-[calc(0.375rem*var(--space-scale)+2px)] data-[orientation=vertical]:w-[calc(0.375rem*var(--space-scale)+2px)]";

package/dist/lib/ui-provider/hooks.d.ts

@@ -1,4 +1,4 @@
-import type { ButtonConfigSlice, BadgeConfigSlice, CardConfigSlice, CommentsDefaultsConfig, DatesConfig, DensityConfigSlice, FormattingConfigSlice, ItemConfigSlice, MoneyConfig, SpinnerConfigSlice, ToastConfig, TypographyConfigSlice } from './types';
+import type { ButtonConfigSlice, BadgeConfigSlice, CardConfigSlice, CommentsDefaultsConfig, DatesConfig, DensityConfigSlice, FormattingConfigSlice, ItemConfigSlice, MoneyConfig, OverlayConfigSlice, SpinnerConfigSlice, ToastConfig, TypographyConfigSlice } from './types';
 export declare const useDensityConfig: () => DensityConfigSlice;
 export declare const useFormattingConfig: () => FormattingConfigSlice;
 export declare const useMoneyConfig: () => MoneyConfig;
@@ -9,5 +9,6 @@ export declare const useItemConfig: () => ItemConfigSlice;
 export declare const useButtonConfig: () => ButtonConfigSlice;
 export declare const useBadgeConfig: () => BadgeConfigSlice;
 export declare const useCardConfig: () => CardConfigSlice;
+export declare const useOverlayConfig: () => OverlayConfigSlice;
 export declare const useToastConfig: () => ToastConfig;
 export declare const useSpinnerConfig: () => SpinnerConfigSlice;

package/dist/lib/ui-provider/index.d.ts

@@ -19,10 +19,10 @@
  * arrays, registries used by one specific surface) stay as direct props.
  */
 export { UIProvider, type UIProviderProps } from './provider';
-export { useDensityConfig, useFormattingConfig, useMoneyConfig, useDatesConfig, useCommentsConfig, useTypographyConfig, useItemConfig, useButtonConfig, useBadgeConfig, useCardConfig, useToastConfig, useSpinnerConfig, } from './hooks';
+export { useDensityConfig, useFormattingConfig, useMoneyConfig, useDatesConfig, useCommentsConfig, useTypographyConfig, useItemConfig, useButtonConfig, useBadgeConfig, useCardConfig, useOverlayConfig, useToastConfig, useSpinnerConfig, } from './hooks';
 export { DEFAULT_UI_CONFIG } from './defaults';
 export { isComponentScale, resolveComponentScale } from './scale';
-export type { UIConfig, ResolvedUIConfig, DensityConfigSlice, FormattingConfigSlice, MoneyConfig, DatesConfig, CommentsDefaultsConfig, TypographyConfigSlice, ItemConfigSlice, ButtonConfigSlice, BadgeConfigSlice, CardConfigSlice, ToastConfig, SpinnerConfigSlice, WeekDay, ComponentScale, TableSize, TextSize, CardSurface, BadgeSize, BadgeTone, ItemSize, ItemVariant, FormControlSize, FormLabelSize, ButtonStyle, ButtonTone, ButtonSize, CardTitleSize, ToastPosition, ToastTheme, MoneyFormatMode, MoneyDisplayMode, MoneyDualLayout, CurrencyCode, } from './types';
+export type { UIConfig, ResolvedUIConfig, DensityConfigSlice, FormattingConfigSlice, MoneyConfig, DatesConfig, CommentsDefaultsConfig, TypographyConfigSlice, ItemConfigSlice, ButtonConfigSlice, BadgeConfigSlice, CardConfigSlice, OverlayConfigSlice, OverlayAlign, ToastConfig, SpinnerConfigSlice, WeekDay, ComponentScale, TableSize, TextSize, CardSurface, BadgeSize, BadgeTone, ItemSize, ItemVariant, FormControlSize, FormLabelSize, ButtonStyle, ButtonTone, ButtonSize, CardTitleSize, ToastPosition, ToastTheme, MoneyFormatMode, MoneyDisplayMode, MoneyDualLayout, CurrencyCode, } from './types';
 export { ThemeScope, type ThemeScopeProps } from '../theme-scope';
 /** Base UI keyboard/positioning direction; pair with the DOM's dir attribute. */
 export { DirectionProvider, type DirectionProviderProps } from '@base-ui/react/direction-provider';

package/dist/lib/ui-provider/provider.d.ts

@@ -3,12 +3,17 @@
  *
  * The store is created synchronously on the first render, so server output,
  * hydration, and the first browser render all observe the same configuration.
- * Independent roots and SSR requests never share mutable provider state.
+ * Independent roots and SSR requests never share mutable provider state. A
+ * nested provider starts from its parent's resolved defaults and overrides
+ * only the keys it sets.
  */
 import { type ReactNode } from 'react';
 import type { UIConfig } from './types';
 export interface UIProviderProps {
-    /** Partial display-default tree merged over `DEFAULT_UI_CONFIG`. */
+    /**
+     * Partial display-default tree merged over the nearest parent provider's
+     * defaults, or over `DEFAULT_UI_CONFIG` at the root.
+     */
     config?: UIConfig;
     children: ReactNode;
 }

package/dist/lib/ui-provider/store.d.ts

@@ -1,8 +1,12 @@
 import { type StoreApi } from 'zustand/vanilla';
 import type { ResolvedUIConfig, UIConfig } from './types';
 export type UIStore = StoreApi<ResolvedUIConfig>;
-export declare function resolveUIConfig(config?: UIConfig): ResolvedUIConfig;
-export declare function createUIStore(config?: UIConfig): UIStore;
+/**
+ * Merge a partial config over a resolved base: the package defaults for a
+ * root provider, or the parent provider's resolved defaults when nested.
+ */
+export declare function resolveUIConfig(config?: UIConfig, base?: ResolvedUIConfig): ResolvedUIConfig;
+export declare function createUIStore(config?: UIConfig, base?: ResolvedUIConfig): UIStore;
 export declare const UIStoreContext: import("react").Context<UIStore | null>;
 export declare function useUIStore<T>(selector: (state: ResolvedUIConfig) => T): T;
 /** Test-only helper for components rendered without a provider. */

package/dist/lib/ui-provider/types.d.ts

@@ -41,6 +41,8 @@ export type ButtonSize = ComponentScale;
 export type CardTitleSize = ComponentScale;
 export type ToastPosition = 'top-right' | 'top-left' | 'top-center' | 'bottom-right' | 'bottom-left' | 'bottom-center';
 export type ToastTheme = 'light' | 'dark' | 'system';
+/** Alignment of an overlay's heading (icon, title, description) and its actions. */
+export type OverlayAlign = 'start' | 'center';
 /** ------------------------------------------------------------------ */
 /** ------------------------------------------------------------------ */
 /** ISO 4217 currency code. The library never enumerates currency codes —
@@ -99,9 +101,12 @@ export interface ItemConfigSlice {
     defaultVariant?: ItemVariant;
 }
 export interface ButtonConfigSlice {
-    /** Default `<Button>` semantic tone. */
+    /** Tone of a `<Button>` without `tone`. Defaults to `secondary`: the neutral button. */
     defaultTone?: ButtonTone;
-    /** Default `<Button>` styling. */
+    /**
+     * Style of a `<Button>` that sets neither `tone` nor `buttonStyle`. Defaults to
+     * `outline`. A button with a `tone` but no `buttonStyle` is `solid`.
+     */
     defaultButtonStyle?: ButtonStyle;
 }
 export interface BadgeConfigSlice {
@@ -116,6 +121,12 @@ export interface CardConfigSlice {
     /** Whether Card footers render a top divider by default. Explicit false still wins. */
     defaultFooterDivider?: boolean;
 }
+export interface OverlayConfigSlice {
+    /** Default `ConfirmDialog` alignment. Per-dialog `align` still wins. Default: `'center'`. */
+    defaultConfirmAlign?: OverlayAlign;
+    /** Default `ActionDialog` alignment. Per-dialog `align` still wins. Default: `'start'`. */
+    defaultDialogAlign?: OverlayAlign;
+}
 export interface ToastConfig {
     /** Default toast lifetime in ms. */
     duration?: number;
@@ -146,6 +157,7 @@ export interface UIConfig {
     button?: ButtonConfigSlice;
     badge?: BadgeConfigSlice;
     card?: CardConfigSlice;
+    overlay?: OverlayConfigSlice;
     toast?: ToastConfig;
     spinner?: SpinnerConfigSlice;
 }

package/dist/lib/utils.js

@@ -1,2 +1,2 @@
-import { t as e } from "../utils-BvH9PSmq.js";
+import { t as e } from "../utils-l5LpDw2z.js";
 export { e as cn };