themelia-react-ui 2.0.0 → 2.0.1

package/dist/layout/navigation.js

@@ -1,3 +1,3 @@
 "use client";
-import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "../navigation-Cbp5V8gG.js";
+import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "../navigation-HJf5zxlH.js";
 export { r as BreadcrumbProgress, e as CategoryNav, i as SectionNav, o as SideNav, a as defaultBreadcrumbProgressStrings, t as defaultSectionNavStrings, n as defaultSideNavStrings };

package/dist/layout/page.js

@@ -1,3 +1,3 @@
 "use client";
-import { i as e, n as t, r as n, t as r } from "../page-C6R_8jFt.js";
+import { i as e, n as t, r as n, t as r } from "../page-B5dTH9gE.js";
 export { n as Page, r as PageActions, e as PageHeader, t as defaultPageActionsStrings };

package/dist/layout/settings.js

@@ -1,3 +1,3 @@
 "use client";
-import { n as e, r as t, t as n } from "../settings-DHk0L2MF.js";
+import { n as e, r as t, t as n } from "../settings-CQW3b-Cu.js";
 export { n as AsideNavShell, e as SettingsShell, t as defaultAsideNavShellStrings };

package/dist/layout/sidebar.js

@@ -1,4 +1,4 @@
 "use client";
-import { a as e, i as t, l as n, o as r, r as i, s as a, u as o } from "../hooks-DQ5SPwZw.js";
-import { a as s, c, d as l, f as u, i as d, l as f, n as p, o as m, p as h, r as g, s as _, t as v, u as y } from "../sidebar-Cb8WzOvE.js";
+import { a as e, i as t, l as n, o as r, r as i, s as a, u as o } from "../hooks-9k_TtmKh.js";
+import { a as s, c, d as l, f as u, i as d, l as f, n as p, o as m, p as h, r as g, s as _, t as v, u as y } from "../sidebar-d7Dg80ln.js";
 export { d as AppSidebar, h as LayoutSidebar, l as LayoutSidebarProvider, t as NavBadge, c as SidebarGroupedNavigation, i as SidebarIcon, _ as SidebarLogo, g as SidebarNavigation, m as SidebarNavigationFooter, v as SidebarNavigationUser, s as SidebarWorkspaceDropdown, f as defaultSidebarNavigationStrings, p as defaultSidebarNavigationUserStrings, y as defaultSidebarWorkspaceDropdownStrings, e as getNavKey, r as getNavLabel, a as isPathMatch, n as resolveNavBadge, o as toPath, u as useLayoutSidebar };

package/dist/layout/workspace.js

@@ -1,3 +1,3 @@
 "use client";
-import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "../workspace-YoFjXi6i.js";
+import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "../workspace-DH0v0KcB.js";
 export { o as WorkspaceLayout, n as WorkspaceLocaleStrip, i as WorkspaceNav, t as WorkspaceRecordHeader, e as defaultWorkspaceLocaleStripStrings, r as defaultWorkspaceNavStrings, a as defaultWorkspaceRecordHeaderStrings };

package/dist/layout.js

@@ -1,13 +1,13 @@
 "use client";
 import { n as e, t } from "./layout.types-Cn7aUzJp.js";
-import { a as n, d as r, i, l as a, n as o, o as s, r as c, s as l, t as u, u as d } from "./hooks-DQ5SPwZw.js";
-import { i as f, n as p, r as m, t as h } from "./containers-D_L4mTVb.js";
-import { i as g, n as _, r as v, t as y } from "./app-shell-BE_j8-AT.js";
-import { i as b, n as x, r as S, t as C } from "./page-C6R_8jFt.js";
-import { n as w, r as T, t as E } from "./settings-DHk0L2MF.js";
-import { a as D, c as O, d as k, i as A, l as j, n as M, o as N, r as P, s as F, t as I, u as L } from "./header-2ycNqGOR.js";
-import { a as R, i as z, n as B, o as V, r as H, s as U, t as W } from "./navigation-Cbp5V8gG.js";
-import { a as G, c as K, d as q, f as J, i as Y, l as X, n as Z, o as Q, p as $, r as ee, s as te, t as ne, u as re } from "./sidebar-Cb8WzOvE.js";
-import { _ as ie, a as ae, c as oe, d as se, f as ce, g as le, h as ue, i as de, l as fe, m as pe, n as me, o as he, p as ge, r as _e, s as ve, t as ye, u as be } from "./auth-M3vGMgDR.js";
-import { a as xe, i as Se, n as Ce, o as we, r as Te, s as Ee, t as De } from "./workspace-YoFjXi6i.js";
+import { a as n, d as r, i, l as a, n as o, o as s, r as c, s as l, t as u, u as d } from "./hooks-9k_TtmKh.js";
+import { i as f, n as p, r as m, t as h } from "./containers-DmWiJa2I.js";
+import { i as g, n as _, r as v, t as y } from "./app-shell-ZK5RWdo6.js";
+import { i as b, n as x, r as S, t as C } from "./page-B5dTH9gE.js";
+import { n as w, r as T, t as E } from "./settings-CQW3b-Cu.js";
+import { a as D, c as O, d as k, i as A, l as j, n as M, o as N, r as P, s as F, t as I, u as L } from "./header-BOefOKd1.js";
+import { a as R, i as z, n as B, o as V, r as H, s as U, t as W } from "./navigation-HJf5zxlH.js";
+import { a as G, c as K, d as q, f as J, i as Y, l as X, n as Z, o as Q, p as $, r as ee, s as te, t as ne, u as re } from "./sidebar-d7Dg80ln.js";
+import { _ as ie, a as ae, c as oe, d as se, f as ce, g as le, h as ue, i as de, l as fe, m as pe, n as me, o as he, p as ge, r as _e, s as ve, t as ye, u as be } from "./auth-CYxKfo69.js";
+import { a as xe, i as Se, n as Ce, o as we, r as Te, s as Ee, t as De } from "./workspace-DH0v0KcB.js";
 export { y as AppLayout, Y as AppSidebar, E as AsideNavShell, ie as AuthCard, fe as AuthFooterLinks, _e as AuthForm, de as AuthFormRow, ye as AuthMethodSwitch, ae as AuthShell, ve as AuthSocialProviderButton, oe as AuthSocialProviders, he as AuthSplitPanel, V as BreadcrumbProgress, R as CategoryNav, f as Container, L as Header, k as HeaderBreadcrumbs, D as HeaderGlobalSearchTrigger, I as HeaderNotifications, N as HeaderSearch, A as HeaderToolButton, P as HeaderToolPopover, M as HeaderUserMenu, $ as LayoutSidebar, q as LayoutSidebarProvider, i as NavBadge, S as Page, C as PageActions, b as PageHeader, m as PageViewport, p as Section, H as SectionNav, w as SettingsShell, W as SideNav, K as SidebarGroupedNavigation, c as SidebarIcon, v as SidebarInsetLayout, te as SidebarLogo, ee as SidebarNavigation, Q as SidebarNavigationFooter, ne as SidebarNavigationUser, G as SidebarWorkspaceDropdown, _ as StackedLayout, g as TopbarSidebarLayout, h as TwoColumnLayout, De as WorkspaceLayout, Ce as WorkspaceLocaleStrip, Te as WorkspaceNav, Se as WorkspaceRecordHeader, T as defaultAsideNavShellStrings, be as defaultAuthFooterLinksStrings, se as defaultAuthMethodSwitchStrings, ce as defaultAuthShellStrings, ge as defaultAuthSocialProvidersStrings, U as defaultBreadcrumbProgressStrings, F as defaultHeaderNotificationsStrings, O as defaultHeaderSearchStrings, j as defaultHeaderUserMenuStrings, x as defaultPageActionsStrings, t as defaultRenderLink, z as defaultSectionNavStrings, B as defaultSideNavStrings, X as defaultSidebarNavigationStrings, Z as defaultSidebarNavigationUserStrings, re as defaultSidebarWorkspaceDropdownStrings, xe as defaultWorkspaceLocaleStripStrings, we as defaultWorkspaceNavStrings, Ee as defaultWorkspaceRecordHeaderStrings, n as getNavKey, s as getNavLabel, pe as isAuthBrandConfig, l as isPathMatch, e as resolveLayoutLinkRenderer, a as resolveNavBadge, d as toPath, o as useActivePath, ue as useAuthLinks, me as useAuthMethodSwitch, le as useAuthShell, u as useCommandShortcut, r as useLayoutLinkRenderer, J as useLayoutSidebar };

package/dist/lib/affordance-geometry.generated.d.ts

@@ -60,4 +60,5 @@ export declare const affordanceGeometry: {
     };
     readonly overlayClose: "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 overlayHeader: "[[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 overlayHeaderCentered: "[[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/field-affordance-recipes.d.ts

@@ -1,9 +1,14 @@
+/**
+ * The one clear glyph: a plain X drawn at `fieldAffordanceRecipes.icon`, never a
+ * circled X, so Input, Textarea, Cascader and Combobox clear actions match.
+ */
+export declare const FieldClearGlyph: import("lucide-react").LucideIcon;
 /** Field affordances have one target/clearance owner. Primitives own behavior. */
 export declare const fieldAffordanceRecipes: {
     /** Content-sized targets for a chip/reaction that already owns its chrome. */
     readonly inline: "box-border m-0 inline-flex shrink-0 items-center justify-center rounded-inner border-0 bg-transparent p-0 font-sans outline-none transition-[color,box-shadow]";
     readonly target: "box-border border-0 bg-transparent font-sans inline-flex size-control-clear shrink-0 items-center justify-center rounded-inner p-0 outline-none transition-[color,box-shadow]";
-    readonly focus: "focus-visible:z-10 focus-visible:border-input focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50";
+    readonly focus: "focus-visible:z-10 focus-visible:inset-ring focus-visible:inset-ring-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50";
     readonly clear: "text-muted-foreground hover:text-foreground";
     readonly toggle: "text-muted-foreground hover:bg-accent hover:text-accent-foreground";
     readonly icon: "size-control-clear-icon shrink-0 max-h-full max-w-full";

package/dist/lib/field-state-recipes.d.ts

@@ -1,12 +1,13 @@
 /** Native fields and field-shaped triggers share one frame-state contract.
- * Validation marks the frame; editable values retain the semantic foreground.
- * Compound fields apply the same state to their outer frame, never each child.
- * A focused invalid field keeps the destructive meaning at full strength, so focus
- * stays visible where the soft invalid halo would otherwise mask the focus ring.
+ * Focus is the shared frame recipe: the 1px frame takes --ring inside a soft
+ * halo. Validation marks the frame with the destructive border; a focused
+ * invalid field keeps that border and shows the halo in the destructive color.
+ * Editable values retain the semantic foreground. Compound fields apply the same
+ * state to their outer frame, never each child.
  */
 export declare const fieldStateRecipes: {
-    readonly focus: "focus-visible:border-input focus-visible:ring-ring focus-visible:ring-2";
-    readonly invalid: "aria-invalid:ring-2 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive aria-invalid:focus-visible:ring-destructive";
-    readonly groupFocus: "has-[[data-slot=input-group-control]:focus-visible]:border-input has-[[data-slot=input-group-control]:focus-visible]:ring-ring has-[[data-slot=input-group-control]:focus-visible]:ring-2";
-    readonly groupInvalid: "has-[[data-slot][aria-invalid=true]]:ring-2 has-[[data-slot][aria-invalid=true]]:ring-destructive/20 dark:has-[[data-slot][aria-invalid=true]]:ring-destructive/40 has-[[data-slot][aria-invalid=true]]:border-destructive has-[[data-slot][aria-invalid=true]]:has-[[data-slot=input-group-control]:focus-visible]:ring-destructive";
+    readonly focus: "focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50";
+    readonly invalid: "aria-invalid:border-destructive aria-invalid:focus-visible:border-destructive aria-invalid:focus-visible:ring-destructive/30 dark:aria-invalid:focus-visible:ring-destructive/50";
+    readonly groupFocus: "has-[[data-slot=input-group-control]:focus-visible]:border-ring has-[[data-slot=input-group-control]:focus-visible]:ring-3 has-[[data-slot=input-group-control]:focus-visible]:ring-ring/50";
+    readonly groupInvalid: "has-[[data-slot][aria-invalid=true]]:border-destructive has-[[data-slot][aria-invalid=true]]:has-[[data-slot=input-group-control]:focus-visible]:border-destructive has-[[data-slot][aria-invalid=true]]:has-[[data-slot=input-group-control]:focus-visible]:ring-destructive/30 dark:has-[[data-slot][aria-invalid=true]]:has-[[data-slot=input-group-control]:focus-visible]:ring-destructive/50";
 };

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

@@ -0,0 +1,24 @@
+/**
+ * The one focus indicator for every interactive element: a crisp 1px edge in
+ * --ring inside a soft 3px halo of --ring at 50%. The edge carries the tested
+ * 3:1 contrast; the halo makes focus stand out without reading as a heavier
+ * border. Each recipe draws the same indicator for a different element shape.
+ *
+ * Other spellings of the same state (a `has-[…:focus-visible]` frame, a
+ * `group-focus-visible` child, a `data-[focused=true]` day) use this vocabulary:
+ * `ring-3`, `ring-ring/50` and a full-strength `border-ring`, `inset-ring-ring` or
+ * `outline-ring` edge. Design lint rejects any other focus ring width, offset or
+ * halo strength.
+ */
+export declare const focusRecipes: {
+    /** Bordered controls (buttons, fields, triggers, checkboxes, switches, tabs): the 1px border becomes the edge. */
+    readonly frame: "focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50";
+    /** Borderless rows, links, tiles and regions: an inset 1px edge stands in for the border. */
+    readonly edge: "focus-visible:inset-ring focus-visible:inset-ring-ring focus-visible:ring-3 focus-visible:ring-ring/50";
+    /** Inline text (links, text buttons) has no padding: the edge is an outline just outside the glyphs. */
+    readonly text: "focus-visible:outline-solid focus-visible:outline-1 focus-visible:outline-offset-0 focus-visible:outline-ring focus-visible:ring-3 focus-visible:ring-ring/50";
+    /** Inside a clipped group or scroll viewport: the edge and the halo are both drawn inside. */
+    readonly inset: "focus-visible:inset-ring focus-visible:inset-ring-ring focus-visible:ring-3 focus-visible:ring-inset focus-visible:ring-ring/50";
+    /** Sidebar rows draw the edge with the sidebar's own focus role. */
+    readonly sidebar: "focus-visible:inset-ring focus-visible:inset-ring-sidebar-ring focus-visible:ring-3 focus-visible:ring-sidebar-ring/50";
+};

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/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

@@ -5,4 +5,5 @@
 export declare const overlayAnatomyRecipes: {
     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";
@@ -16,17 +17,56 @@ export declare const surfaceDividerRecipes: {
     readonly modal: {
         readonly shell: "border 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 scrollEdges: "transition-[box-shadow] duration-150 motion-reduce:transition-none data-scroll-start:shadow-[0_-1px_0_0_color-mix(in_oklab,var(--border)_70%,transparent)] data-scroll-end:shadow-[0_1px_0_0_color-mix(in_oklab,var(--border)_70%,transparent)] data-scroll-start:data-scroll-end:shadow-[0_-1px_0_0_color-mix(in_oklab,var(--border)_70%,transparent),0_1px_0_0_color-mix(in_oklab,var(--border)_70%,transparent)]";
+        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 inline inset once; the modal shell owns the block inset and the
- * gap between regions, as Card does. The body keeps a focus-ring margin inside its
- * scroll edge; 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 px-surface text-start";
-    readonly body: "min-h-0 flex-1 overflow-y-auto px-surface -my-space-xs py-space-xs transition-[box-shadow] duration-150 motion-reduce:transition-none data-scroll-start:shadow-[0_-1px_0_0_color-mix(in_oklab,var(--border)_70%,transparent)] data-scroll-end:shadow-[0_1px_0_0_color-mix(in_oklab,var(--border)_70%,transparent)] data-scroll-start:data-scroll-end:shadow-[0_-1px_0_0_color-mix(in_oklab,var(--border)_70%,transparent),0_1px_0_0_color-mix(in_oklab,var(--border)_70%,transparent)]";
-    readonly footer: "shrink-0 flex-wrap gap-space-sm px-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

@@ -44,9 +44,6 @@ export declare const tokenClassGroups: {
     mt: {
         mt: string[];
     }[];
-    my: {
-        my: string[];
-    }[];
     "space-x": {
         "space-x": string[];
     }[];
@@ -62,6 +59,12 @@ export declare const tokenClassGroups: {
     py: {
         py: string[];
     }[];
+    inset: {
+        inset: string[];
+    }[];
+    my: {
+        my: string[];
+    }[];
     bottom: {
         bottom: string[];
     }[];
@@ -98,9 +101,6 @@ export declare const tokenClassGroups: {
     me: {
         me: string[];
     }[];
-    inset: {
-        inset: string[];
-    }[];
     "inset-x": {
         "inset-x": 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/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/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 —
@@ -119,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;
@@ -149,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-Cospvlj1.js";
+import { t as e } from "../utils-l5LpDw2z.js";
 export { e as cn };