themelia-react-ui 0.0.0-stage → 1.0.0

package/dist/layout/app-shell.js

@@ -0,0 +1,3 @@
+"use client";
+import { i as e, n as t, r as n, t as r } from "../app-shell-BH_bGcE2.js";
+export { r as AppLayout, n as SidebarInsetLayout, t as StackedLayout, e as TopbarSidebarLayout };

package/dist/layout/auth.js

@@ -0,0 +1,3 @@
+"use client";
+import { _ as e, a as t, c as n, d as r, f as i, g as a, h as o, i as s, l as c, m as l, n as u, o as d, p as f, r as p, s as m, t as h, u as g } from "../auth-BDB1V_2q.js";
+export { e as AuthCard, c as AuthFooterLinks, p as AuthForm, s as AuthFormRow, h as AuthMethodSwitch, t as AuthShell, m as AuthSocialProviderButton, n as AuthSocialProviders, d as AuthSplitPanel, g as defaultAuthFooterLinksStrings, r as defaultAuthMethodSwitchStrings, i as defaultAuthShellStrings, f as defaultAuthSocialProvidersStrings, l as isAuthBrandConfig, o as useAuthLinks, u as useAuthMethodSwitch, a as useAuthShell };

package/dist/layout/containers.js

@@ -0,0 +1,3 @@
+"use client";
+import { i as e, n as t, r as n, t as r } from "../containers-CPNyNo1_.js";
+export { e as Container, n as PageViewport, t as Section, r as TwoColumnLayout };

package/dist/layout/header.js

@@ -0,0 +1,3 @@
+"use client";
+import { a as e, c as t, d as n, i as r, l as i, n as a, o, r as s, s as c, t as l, u } from "../header-B8ex54cY.js";
+export { u as Header, n as HeaderBreadcrumbs, e as HeaderGlobalSearchTrigger, l as HeaderNotifications, o as HeaderSearch, r as HeaderToolButton, s as HeaderToolPopover, a as HeaderUserMenu, c as defaultHeaderNotificationsStrings, t as defaultHeaderSearchStrings, i as defaultHeaderUserMenuStrings };

package/dist/layout/hooks.js

@@ -0,0 +1,3 @@
+"use client";
+import { d as e, n as t, t as n } from "../hooks-D6UBVzf2.js";
+export { t as useActivePath, n as useCommandShortcut, e as useLayoutLinkRenderer };

package/dist/layout/navigation.js

@@ -0,0 +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-DqEITuD2.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

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

package/dist/layout/settings.js

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

package/dist/layout/sidebar.js

@@ -0,0 +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-D6UBVzf2.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-C3UKkbC5.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

@@ -0,0 +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-Cbqz4FzN.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

@@ -0,0 +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-D6UBVzf2.js";
+import { i as f, n as p, r as m, t as h } from "./containers-CPNyNo1_.js";
+import { i as g, n as _, r as v, t as y } from "./app-shell-BH_bGcE2.js";
+import { i as b, n as x, r as S, t as C } from "./page-BMBGjJY8.js";
+import { n as w, r as T, t as E } from "./settings-D9f_wdIC.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-B8ex54cY.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-DqEITuD2.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-C3UKkbC5.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-BDB1V_2q.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-Cbqz4FzN.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/layout.types-Cn7aUzJp.js

@@ -0,0 +1,20 @@
+"use client";
+import { jsx as e } from "react/jsx-runtime";
+//#region src/components/layout/layout.types.tsx
+var t = ({ href: t, children: n, active: r, disabled: i, external: a, rel: o, target: s, ...c }) => !t || i ? /* @__PURE__ */ e("span", {
+	...c,
+	children: n
+}) : /* @__PURE__ */ e("a", {
+	href: t,
+	target: s ?? (a ? "_blank" : void 0),
+	rel: o ?? (a ? "noopener noreferrer" : void 0),
+	...c,
+	children: n
+});
+function n({ renderLink: e } = {}) {
+	return e || t;
+}
+//#endregion
+export { n, t };
+
+//# sourceMappingURL=layout.types-Cn7aUzJp.js.map

package/dist/layout.types-Cn7aUzJp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.types-Cn7aUzJp.js","names":["defaultRenderLink","props","href","disabled","target","external","rel","resolveLayoutLinkRenderer","renderLink"],"sources":["../src/components/layout/layout.types.tsx"],"sourcesContent":[" \n/**\n * Shared layout types used across page, header, and sidebar.\n *\n * The layout layer is framework-agnostic by contract. It never imports a\n * router package. Navigation is delegated to the consumer through\n * `renderLink`.\n */\nimport type { ComponentType, HTMLAttributes, MouseEvent, ReactNode } from 'react';\n\n/** Native region props, including strongly typed consumer `data-*` hooks. */\nexport type LayoutSlotAttributes<ElementType extends HTMLElement> =\n\tHTMLAttributes<ElementType>\n\t& { [Key in `data-${string}`]?: string | number | boolean | undefined };\n\nexport interface LayoutLinkRenderProps {\n\t/** Destination URL. When omitted, render non-interactive content. */\n\thref?: string;\n\tchildren: ReactNode;\n\tclassName?: string;\n\ttarget?: string;\n\trel?: string;\n\tonClick?: (event: MouseEvent<HTMLAnchorElement>) => void;\n\t'aria-label'?: string;\n\t/** Consumer hint for active styling; renderers may ignore it. */\n\tactive?: boolean;\n\t/** Consumer hint to render as muted/non-interactive. */\n\tdisabled?: boolean;\n\t/** Consumer hint for external-link behavior. */\n\texternal?: boolean;\n}\n\n/**\n * Primary navigation seam. Consumers can wire Inertia, Next, React Router,\n * TanStack Router, or a plain anchor without this package importing them.\n *\n * Example:\n *   renderLink={({ href, children, className }) => (\n *     <Link href={href ?? '#'} className={className}>{children}</Link>\n *   )}\n */\nexport type LayoutLinkRenderer = (props: LayoutLinkRenderProps) => ReactNode;\n\nexport interface LayoutNavigationAdapter {\n\t/** Renderer for framework-native links. */\n\trenderLink?: LayoutLinkRenderer;\n}\n\n/** Default link renderer — native anchor with disabled fallback. */\nexport const defaultRenderLink: LayoutLinkRenderer = ({\n\thref,\n\tchildren,\n\tactive,\n\tdisabled,\n\texternal,\n\trel,\n\ttarget,\n\t...props\n}) => {\n\tvoid active;\n\n\tif (!href || disabled) {\n\t\treturn <span {...props}>{children}</span>;\n\t}\n\n\tconst resolvedTarget = target ?? (external ? '_blank' : undefined);\n\tconst resolvedRel = rel ?? (external ? 'noopener noreferrer' : undefined);\n\n\treturn (\n\t\t<a href={href} target={resolvedTarget} rel={resolvedRel} {...props}>\n\t\t\t{children}\n\t\t</a>\n\t);\n};\n\n/** Resolve the consumer renderer or the native-anchor default. */\nexport function resolveLayoutLinkRenderer({\n\trenderLink,\n}: LayoutNavigationAdapter = {}): LayoutLinkRenderer {\n\tif (renderLink) return renderLink;\n\treturn defaultRenderLink;\n}\n\n/** Plain navigation item used by sidebar / breadcrumbs / page header. */\nexport interface NavLink {\n\t/** Display label. */\n\tlabel: ReactNode;\n\t/** Destination for the entry, when it navigates. */\n\thref?: string;\n\thandle?: string;\n\t/** Chip rendered beside the label. */\n\tbadge?: string | number;\n\t/** Disables the control. */\n\tdisabled?: boolean;\n\texternal?: boolean;\n}\n\n/** Hierarchical navigation item — extends `NavLink` with optional children. */\nexport interface NavItem extends NavLink {\n\t/** Leading glyph. */\n\ticon?: LayoutIconSource;\n\tchildren?: NavItem[];\n\tgroup?: string;\n}\n\n/** Breadcrumb entry. The last item with no `href` renders as the current page. */\nexport interface BreadcrumbItem {\n\t/** Display label. */\n\tlabel: ReactNode;\n\t/** Destination for the entry, when it navigates. */\n\thref?: string;\n\thandle?: string;\n}\n\nexport type LayoutIconComponent = ComponentType<React.SVGProps<SVGSVGElement>>;\nexport type LayoutIconSource = LayoutIconComponent | string;\n\nexport interface LayoutUser {\n\tname: string;\n\temail?: string;\n\tavatar?: string;\n\trole?: string;\n}\n\nexport interface ExternalLinkItem {\n\t/** Display label. */\n\tlabel: ReactNode;\n\turl: string;\n\t/** Leading glyph. */\n\ticon?: ComponentType<{ className?: string }>;\n}\n"],"mappings":";;;AAiDA,IAAaA,KAAyC,EACrD,SACA,aACA,WACA,aACA,aACA,QACA,WACA,GAAGC,QAIC,CAACC,KAAQC,IACL,kBAAC,QAAD;CAAM,GAAIF;CAAQ;AAAe,CAAA,IAOxC,kBAAC,KAAD;CAAS;CAAM,QAJOG,MAAWC,IAAW,WAAW,KAAA;CAIhB,KAHpBC,MAAQD,IAAW,wBAAwB,KAAA;CAGL,GAAIJ;CAC3D;AACC,CAAA;AAKL,SAAgBM,EAA0B,EACzC,kBAC4B,CAAC,GAAuB;CAEpD,OADIC,KACGR;AACR"}

package/dist/lib/action-presentation.d.ts

@@ -0,0 +1,15 @@
+import type { SemanticTone } from './component-vocabulary';
+/** Supported visual treatments for definition-driven actions. */
+export declare const ACTION_BUTTON_STYLES: readonly ["solid", "outline", "ghost", "link"];
+export type ActionButtonStyle = (typeof ACTION_BUTTON_STYLES)[number];
+/** Shared presentation and availability fields for package action definitions. */
+export interface ActionPresentation {
+    /** Semantic color intent. */
+    tone?: SemanticTone;
+    /** Button treatment, independent from semantic color. */
+    buttonStyle?: ActionButtonStyle;
+    /** Set false to omit the action. */
+    visible?: boolean;
+    /** Prevents activation while keeping the action visible. */
+    disabled?: boolean;
+}

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

@@ -0,0 +1,18 @@
+export declare const affordanceGeometry: {
+    readonly navigationGuideStart: "ms-[calc(var(--control-x)*0.8333333*var(--space-scale)+var(--icon)*0.75*var(--space-scale)/2)]";
+    readonly clearEnd: {
+        readonly sm: "end-[calc(var(--control-x)*0.8333333*var(--space-scale))]";
+        readonly md: "end-[calc(var(--control-x)*var(--space-scale))]";
+        readonly lg: "end-[calc(var(--control-x)*var(--space-scale))]";
+    };
+    readonly clearPadding: {
+        readonly sm: "pe-[calc(var(--control-x)*0.8333333*var(--space-scale)+1.375rem*var(--density-scale)+0.375rem*var(--space-scale))]";
+        readonly md: "pe-[calc(var(--control-x)*var(--space-scale)+1.375rem*var(--density-scale)+0.375rem*var(--space-scale))]";
+        readonly lg: "pe-[calc(var(--control-x)*var(--space-scale)+1.375rem*var(--density-scale)+0.375rem*var(--space-scale))]";
+    };
+    readonly togglePadding: "pe-[calc(1.375rem*var(--density-scale)+0.625rem*var(--space-scale))]";
+    readonly largeIconStart: "ps-[calc((var(--control-x)+var(--icon)*1.25+0.5rem)*var(--space-scale))]";
+    readonly largeIconEnd: "pe-[calc((var(--control-x)+var(--icon)*1.25+0.5rem)*var(--space-scale))]";
+    readonly overlayClose: "absolute top-[calc(var(--surface-y)*var(--space-scale))] 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)*0.8888889*var(--density-scale)+0.5rem*var(--space-scale))]";
+};

package/dist/lib/anchored-positioning.d.ts

@@ -0,0 +1,5 @@
+/** Portaled anchors use viewport coordinates so scoped hosts inside scroll
+ * regions don't clip or displace them. Native positionMethod overrides remain
+ * available; deliberately inline popovers keep absolute positioning by default.
+ */
+export declare const anchoredPositionMethod: "fixed";

package/dist/lib/command-filter.d.ts

@@ -0,0 +1 @@
+export declare function commandFilter(value: string, search: string, keywords?: string[]): 0 | 1 | 0.5;

package/dist/lib/component-vocabulary.d.ts

@@ -0,0 +1,12 @@
+/** Canonical three-step scale for package-owned component recipes. */
+export declare const COMPONENT_SCALES: readonly ["sm", "md", "lg"];
+export type ComponentScale = (typeof COMPONENT_SCALES)[number];
+/** Canonical semantic colour intent for package-owned presentation. */
+export declare const SEMANTIC_TONES: readonly ["neutral", "primary", "secondary", "info", "success", "warning", "destructive"];
+export type SemanticTone = (typeof SEMANTIC_TONES)[number];
+/** Shared chrome for card-like surfaces. */
+export declare const CARD_SURFACES: readonly ["card", "flat", "framed"];
+export type CardSurface = (typeof CARD_SURFACES)[number];
+/** Shared shell treatments for disclosure collections. */
+export declare const DISCLOSURE_SURFACES: readonly ["card", "bordered", "flat"];
+export type DisclosureSurface = (typeof DISCLOSURE_SURFACES)[number];

package/dist/lib/editable-text-recipe.d.ts

@@ -0,0 +1,6 @@
+/** Editable text follows control scale; coarse-pointer devices retain the touch input size at every width. */
+export declare const editableTextSizeClasses: {
+    readonly sm: "text-pxs pointer-coarse:text-base";
+    readonly md: "text-sm pointer-coarse:text-base";
+    readonly lg: "text-sm pointer-coarse:text-base";
+};

package/dist/lib/email-composer.d.ts

@@ -0,0 +1,6 @@
+/** Pure preparation/delivery helpers for server code; no editor or React runtime imports. */
+export { renderEmail, validate, resolveValues, recipientLabel, parseRecipient } from '../components/features/email-composer/engine';
+export { bodyHtml } from '../components/features/email-composer/document';
+export { createHttpSender } from '../components/features/email-composer/http';
+export { defaultEmailComposerStrings, type EmailComposerStrings } from '../components/features/email-composer/strings';
+export type { Recipient, EmailBody, PlaceholderValue, PlaceholderDefinition, PlaceholderSet, EmailTemplate, ComposerDraft, PreparedEmail, ComposerIssue } from '../components/features/email-composer/types';

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

@@ -0,0 +1,20 @@
+/** Field affordances have one target/clearance owner. Primitives own behavior. */
+export declare const fieldAffordanceRecipes: {
+    readonly target: "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/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";
+    readonly centered: "absolute top-1/2 -translate-y-1/2";
+    readonly clearEnd: {
+        readonly sm: "end-[calc(var(--control-x)*0.8333333*var(--space-scale))]";
+        readonly md: "end-[calc(var(--control-x)*var(--space-scale))]";
+        readonly lg: "end-[calc(var(--control-x)*var(--space-scale))]";
+    };
+    readonly clearPadding: {
+        readonly sm: "pe-[calc(var(--control-x)*0.8333333*var(--space-scale)+1.375rem*var(--density-scale)+0.375rem*var(--space-scale))]";
+        readonly md: "pe-[calc(var(--control-x)*var(--space-scale)+1.375rem*var(--density-scale)+0.375rem*var(--space-scale))]";
+        readonly lg: "pe-[calc(var(--control-x)*var(--space-scale)+1.375rem*var(--density-scale)+0.375rem*var(--space-scale))]";
+    };
+    readonly togglePadding: "pe-[calc(1.375rem*var(--density-scale)+0.625rem*var(--space-scale))]";
+};

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

@@ -0,0 +1,10 @@
+/** 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.
+ */
+export declare const fieldStateRecipes: {
+    readonly focus: "focus-visible:border-input focus-visible:ring-ring/50 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";
+    readonly groupFocus: "has-[[data-slot=input-group-control]:focus-visible]:border-input has-[[data-slot=input-group-control]:focus-visible]:ring-ring/50 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";
+};

package/dist/lib/format.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Shared formatting constants and helpers for display components.
+ *
+ * `EMPTY` — em-dash used as the canonical placeholder for missing/null values
+ * across Money and the package's display primitives. Keeping it
+ * centralised lets the library swap to "—" / "N/A" / locale-specific glyphs in
+ * one place if needed.
+ *
+ * `formatCurrency` / `formatNumber` / `formatPercentage` / `formatDuration`
+ * are thin wrappers around `Intl.NumberFormat` plus a duration helper. They
+ * default to the user's resolved locale (`undefined` → system default) but
+ * accept a `locale` override so callers can pin output for tests or
+ * dual-currency UIs.
+ */
+export declare const EMPTY = "\u2014";
+export interface FormatNumberOptions {
+    locale?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    notation?: Intl.NumberFormatOptions['notation'];
+}
+export declare function formatNumber(value: number, options?: FormatNumberOptions): string;
+export interface FormatCurrencyOptions extends FormatNumberOptions {
+    currency?: string;
+    currencyDisplay?: 'symbol' | 'narrowSymbol' | 'code' | 'name';
+}
+export declare function formatCurrency(value: number, options?: FormatCurrencyOptions): string;
+export interface FormatPercentageOptions extends FormatNumberOptions {
+    /** When true, treat `value` as already a percentage (e.g. 12.5 → "12.5%"). Default: false (0.125 → "12.5%"). */
+    scaled?: boolean;
+}
+export declare function formatPercentage(value: number, options?: FormatPercentageOptions): string;
+/** Input and display options for localized duration formatting. Seconds and
+ * narrow units are the calibrated defaults. */
+export type DurationUnit = 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days';
+export type DurationUnitDisplay = 'narrow' | 'short' | 'long';
+export interface FormatDurationOptions {
+    /** Unit used by the incoming value. Defaults to seconds. */
+    from?: DurationUnit;
+    /** BCP-47 locale passed to Intl.NumberFormat. */
+    locale?: string;
+    /** Number of non-zero units to show. Defaults to all five units. */
+    maxParts?: number;
+    /** Intl unit-label style. `narrow` provides the compact `1h 5m` default. */
+    unitDisplay?: DurationUnitDisplay;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+}
+/**
+ * Format a duration into localized unit parts. Values use seconds and compact
+ * unit labels by default; pass `from` to select another input unit.
+ */
+export declare function formatDuration(value: number, options?: FormatDurationOptions): string;

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

@@ -0,0 +1,8 @@
+export declare const motionRecipes: {
+    readonly backdrop: "transition-opacity duration-200 ease-out data-ending-style:duration-100 data-starting-style:opacity-0 data-ending-style:opacity-0 motion-reduce:transition-none motion-reduce:duration-0 motion-reduce:data-ending-style:duration-0";
+    readonly dialog: "transition-[opacity,scale] duration-200 ease-out data-ending-style:duration-150 data-starting-style:opacity-0 data-ending-style:opacity-0 data-starting-style:scale-95 data-ending-style:scale-95 motion-reduce:transition-none motion-reduce:duration-0 motion-reduce:data-ending-style:duration-0";
+    readonly drawer: string;
+    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";
+};

package/dist/lib/navigation-row-recipes.d.ts

@@ -0,0 +1,26 @@
+/** Shared inline navigation geometry; the owning family supplies state and semantics. */
+export declare const navigationRowInlineClasses = "min-w-0 gap-space-md rounded-radius px-control-sm";
+export declare const navigationChildInsetClasses: string;
+export declare const navigationRowDensityRecipes: {
+    readonly compact: {
+        readonly size: "sm";
+        readonly gap: "gap-0";
+        readonly childGap: "gap-0 py-0";
+        readonly height: "h-action-sm";
+        readonly childHeight: "h-action-xs";
+    };
+    readonly default: {
+        readonly size: "sm";
+        readonly gap: "gap-space-2xs";
+        readonly childGap: "gap-0 py-0";
+        readonly height: "h-action-sm";
+        readonly childHeight: "h-action-xs";
+    };
+    readonly comfortable: {
+        readonly size: "md";
+        readonly gap: "gap-space-2xs";
+        readonly childGap: "gap-space-2xs py-space-2xs";
+        readonly height: "h-action";
+        readonly childHeight: "h-action-sm";
+    };
+};

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

@@ -0,0 +1,8 @@
+/** Dismiss controls follow the surface's logical inset; headers reserve the
+ * actual small-action width plus an action gap only when a close control exists.
+ * 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 header: "[[data-slot$=-content]:has(>[data-overlay-close])>&]:pe-[calc(var(--surface-x)*var(--space-scale)+var(--height-action)*0.8888889*var(--density-scale)+0.5rem*var(--space-scale))]";
+};

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

@@ -0,0 +1,3 @@
+/** Vertical collection rhythm never chooses inline room or primary typography. */
+export type RowDensity = 'default' | 'compact' | 'comfortable';
+export declare const rowBlockPaddingClasses: Record<RowDensity, string>;

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

@@ -0,0 +1,8 @@
+/**
+ * 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.
+ */
+export declare function sanitizeHtml(input: string): string;
+export default sanitizeHtml;

package/dist/lib/strings.d.ts

@@ -0,0 +1,16 @@
+export type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends ReadonlyArray<unknown> ? T[K] : T[K] extends (...args: never[]) => unknown ? T[K] : T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+export declare function mergeStrings<T extends object>(defaults: T, override?: DeepPartial<T>): T;
+export declare function useStrings<T extends object>(defaults: T, override?: DeepPartial<T>): T;
+export interface InterpolateStringOptions {
+    /** How unresolved `{{token}}` placeholders are rendered. Defaults to preserving them. */
+    missing?: 'preserve' | 'empty';
+}
+/** Replace plain-text `{{token}}` placeholders without evaluating HTML. */
+export declare function interpolateString(template: string, values: Record<string, string | number | null | undefined>, options?: InterpolateStringOptions): string;
+/**
+ * Helper to derive a `strings` prop type from a defaults shape.
+ *   type FooProps = { strings?: StringsProp<typeof defaultFooStrings> };
+ */
+export type StringsProp<T extends object> = DeepPartial<T>;

package/dist/lib/strings.js

@@ -0,0 +1,32 @@
+import { useMemo as e } from "react";
+//#region src/lib/strings.ts
+function t(e) {
+	if (typeof e != "object" || !e || Array.isArray(e)) return !1;
+	let t = Object.getPrototypeOf(e);
+	return t === Object.prototype || t === null;
+}
+function n(e, r) {
+	if (!r) return e;
+	let i = { ...e };
+	for (let a of Object.keys(r)) {
+		let o = r[a];
+		if (o === void 0) continue;
+		let s = e[a];
+		i[a] = t(s) && t(o) ? n(s, o) : o;
+	}
+	return i;
+}
+function r(t, r) {
+	return e(() => n(t, r), [t, r]);
+}
+function i(e, t, n = {}) {
+	let { missing: r = "preserve" } = n;
+	return e.replace(/\{\{\s*(\w+)\s*\}\}/g, (e, n) => {
+		let i = t[n];
+		return i == null ? r === "empty" ? "" : e : String(i);
+	});
+}
+//#endregion
+export { i as interpolateString, n as mergeStrings, r as useStrings };
+
+//# sourceMappingURL=strings.js.map

package/dist/lib/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","names":["isPlainObject","value","proto","mergeStrings","override","defaults","out","key","incoming","base","useStrings","useMemo","interpolateString","options","template","values","missing","match"],"sources":["../../src/lib/strings.ts"],"sourcesContent":["/**\n * strings — typed defaults + override helper for component-level i18n.\n *\n * Pattern (component-side):\n *   export interface FooStrings { title: string; cta: string; }\n *   export const defaultFooStrings: FooStrings = { title: 'Foo', cta: 'Go' };\n *\n *   export function Foo({ strings: stringsProp }: { strings?: Partial<FooStrings> }) {\n *     const strings = useStrings(defaultFooStrings, stringsProp);\n *     return <button>{strings.cta}</button>;\n *   }\n *\n * The override merges shallowly with defaults — any key the consumer omits\n * falls back to the default. Nested objects merge one level deep so namespaced\n * strings (`{ status: { active: 'Active' } }`) can be overridden one key at a\n * time. Arrays, functions and primitives are replaced wholesale — a formatter\n * such as `formatCount: (n: number) => string` is a single value, not a shape\n * to merge into.\n *\n * `useStrings` is memoised on the override identity; it is safe to pass an\n * inline literal — the cost of re-running merge is trivial — but a stable\n * reference avoids unnecessary downstream re-renders when the resolved object\n * is passed through context.\n */\nimport { useMemo } from 'react';\n\nexport type DeepPartial<T> = {\n\t[K in keyof T]?: T[K] extends ReadonlyArray<unknown>\n\t\t? T[K]\n\t\t: // A function is an `object`, so it must be matched BEFORE that branch.\n\t\t\t// Recursing into one maps over its properties, and a function has no own\n\t\t\t// enumerable properties, so the call signature is dropped and the member\n\t\t\t// degrades to `{}`. That still accepts any function, which is why the\n\t\t\t// mistake is silent: overrides keep compiling while their parameter and\n\t\t\t// return types stop being checked at all.\n\t\t\t//\n\t\t\t// `(...args: never[]) => unknown` matches every function shape —\n\t\t\t// parameters are contravariant, so `never[]` accepts any parameter list,\n\t\t\t// and any return type extends `unknown`.\n\t\t\tT[K] extends (...args: never[]) => unknown\n\t\t\t? T[K]\n\t\t\t: T[K] extends object\n\t\t\t\t? DeepPartial<T[K]>\n\t\t\t\t: T[K];\n};\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n\tif (value === null || typeof value !== 'object') return false;\n\tif (Array.isArray(value)) return false;\n\tconst proto = Object.getPrototypeOf(value) as object | null;\n\treturn proto === Object.prototype || proto === null;\n}\n\nexport function mergeStrings<T extends object>(\n\tdefaults: T,\n\toverride?: DeepPartial<T>,\n): T {\n\tif (!override) return defaults;\n\tconst out: Record<string, unknown> = { ...(defaults as Record<string, unknown>) };\n\tfor (const key of Object.keys(override) as Array<keyof T>) {\n\t\tconst incoming = (override as Record<string, unknown>)[key as string];\n\t\tif (incoming === undefined) continue;\n\t\tconst base = (defaults as Record<string, unknown>)[key as string];\n\t\tif (isPlainObject(base) && isPlainObject(incoming)) {\n\t\t\tout[key as string] = mergeStrings(\n\t\t\t\tbase as Record<string, unknown>,\n\t\t\t\tincoming as DeepPartial<Record<string, unknown>>,\n\t\t\t);\n\t\t} else {\n\t\t\tout[key as string] = incoming;\n\t\t}\n\t}\n\treturn out as T;\n}\n\nexport function useStrings<T extends object>(\n\tdefaults: T,\n\toverride?: DeepPartial<T>,\n): T {\n\treturn useMemo(() => mergeStrings(defaults, override), [defaults, override]);\n}\n\nexport interface InterpolateStringOptions {\n\t/** How unresolved `{{token}}` placeholders are rendered. Defaults to preserving them. */\n\tmissing?: 'preserve' | 'empty';\n}\n\n/** Replace plain-text `{{token}}` placeholders without evaluating HTML. */\nexport function interpolateString(\n\ttemplate: string,\n\tvalues: Record<string, string | number | null | undefined>,\n\toptions: InterpolateStringOptions = {},\n): string {\n\tconst { missing = 'preserve' } = options;\n\n\treturn template.replace(/\\{\\{\\s*(\\w+)\\s*\\}\\}/g, (match, key: string) => {\n\t\tconst value = values[key];\n\t\tif (value === undefined || value === null) {\n\t\t\treturn missing === 'empty' ? '' : match;\n\t\t}\n\t\treturn String(value);\n\t});\n}\n\n/**\n * Helper to derive a `strings` prop type from a defaults shape.\n *   type FooProps = { strings?: StringsProp<typeof defaultFooStrings> };\n */\nexport type StringsProp<T extends object> = DeepPartial<T>;\n"],"mappings":";;AA8CA,SAASA,EAAc,GAAkD;CAExE,IADsB,OAAOC,KAAU,aAAnCA,KACA,MAAM,QAAQA,CAAK,GAAG,OAAO;CACjC,IAAMC,IAAQ,OAAO,eAAeD,CAAK;CACzC,OAAOC,MAAU,OAAO,aAAaA,MAAU;AAChD;AAEA,SAAgBC,EACf,GACA,GACI;CACJ,IAAI,CAACC,GAAU,OAAOC;CACtB,IAAMC,IAA+B,EAAE,GAAID,EAAqC;CAChF,KAAK,IAAME,KAAO,OAAO,KAAKH,CAAQ,GAAqB;EAC1D,IAAMI,IAAYJ,EAAqCG;EACvD,IAAIC,MAAa,KAAA,GAAW;EAC5B,IAAMC,IAAQJ,EAAqCE;EACnD,AAMCD,EAAIC,KANDP,EAAcS,CAAI,KAAKT,EAAcQ,CAAQ,IAC3BL,EACpBM,GACAD,CACD,IAEqBA;CAEvB;CACA,OAAOF;AACR;AAEA,SAAgBI,EACf,GACA,GACI;CACJ,OAAOC,QAAcR,EAAaE,GAAUD,CAAQ,GAAG,CAACC,GAAUD,CAAQ,CAAC;AAC5E;AAQA,SAAgBQ,EACf,GACA,GACA,IAAoC,CAAC,GAC5B;CACT,IAAM,EAAE,aAAU,eAAeC;CAEjC,OAAOC,EAAS,QAAQ,yBAAyB,GAAO,MAAgB;EACvE,IAAMb,IAAQc,EAAOR;EAIrB,OAHIN,KAAiC,OAC7Be,MAAY,UAAU,KAAKC,IAE5B,OAAOhB,CAAK;CACpB,CAAC;AACF"}

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

@@ -0,0 +1,27 @@
+/** Private semantic roles, not additional theme roots or consumer variants.
+ * Frame, anchored and modal boundaries intentionally retain their established strength.
+ */
+export declare const surfaceDividerRecipes: {
+    readonly frame: {
+        readonly shell: "border border-border";
+        readonly header: "border-b border-border";
+        readonly footer: "border-t border-border";
+    };
+    readonly anchored: {
+        readonly shell: "border border-border/60";
+        readonly header: "border-b border-border/60";
+        readonly footer: "border-t border-border/60";
+        readonly separator: "bg-border/60";
+    };
+    readonly modal: {
+        readonly shell: "border border-border/70";
+        readonly header: "border-b border-border/70";
+        readonly footer: "border-t border-border/70";
+    };
+};
+/** Regions own their inset once; 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";
+};

package/dist/lib/theme-scope.d.ts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+/** Native Base UI portal container contract, shared by internal portal owners. */
+export type ThemePortalContainer = HTMLElement | ShadowRoot | React.RefObject<HTMLElement | ShadowRoot | null> | null;
+type ThemeScopeContextValue = {
+    host: React.RefObject<HTMLElement | null>;
+    mounted: boolean;
+};
+export type ThemeScopeProps = Omit<React.ComponentPropsWithoutRef<'div'>, 'style'> & {
+    style?: React.CSSProperties & {
+        [property: `--${string}`]: string | number | undefined;
+    };
+};
+/** Internal host mechanics shared by native themed regions and the public div scope. */
+export declare const ThemeScopeHostProvider: React.Provider<ThemeScopeContextValue | null>;
+export declare function useThemeScopeHost<T extends HTMLElement>(): {
+    host: React.RefObject<T | null>;
+    attachHost: (node: T | null) => void;
+    context: {
+        host: React.RefObject<T | null>;
+        mounted: boolean;
+    };
+};
+/** CSS inheritance boundary for local themes, including descendant overlays. */
+export declare const ThemeScope: React.ForwardRefExoticComponent<Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "style"> & {
+    style?: React.CSSProperties & {
+        [property: `--${string}`]: string | number | undefined;
+    };
+} & React.RefAttributes<HTMLDivElement>>;
+/** Explicit container wins; scoped portals wait until their CSS host is attached. */
+export declare function useThemePortalContainer(container?: ThemePortalContainer): ThemePortalContainer | undefined;
+export {};

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

@@ -0,0 +1,2 @@
+export declare const spacingTokens: string[];
+export declare const radiusTokens: string[];

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

@@ -0,0 +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)]";

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

@@ -0,0 +1,12 @@
+/**
+ * Hardcoded library-wide defaults.
+ *
+ * These are the values the store ships with — every component reading via
+ * `useFooConfig()` gets these even when no `<UIProvider>` is mounted.
+ *
+ * Each `<UIProvider>` creates an isolated mount-once store synchronously, so
+ * these defaults work for browser rendering, SSR, and multiple React roots.
+ * Components outside a provider read the no-provider fallback store.
+ */
+import type { ResolvedUIConfig } from './types';
+export declare const DEFAULT_UI_CONFIG: ResolvedUIConfig;

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * UIProvider — single source of library-wide display defaults.
+ *
+ * Public surface (read-only):
+ * - `<UIProvider config={{...}}>` — isolated mount-once boundary, safe for
+ *   SSR and multiple React roots.
+ * - `useMoneyConfig` / `useDatesConfig` / … — slice-scoped reads inside
+ *   components.
+ *
+ * The provider is the configuration boundary. Internal fallback-store
+ * writers remain private package test utilities and are not published.
+ *
+ * Resolution rule everywhere:
+ *     props.X  ??  useFooConfig().X  ??  hardcoded fallback
+ *
+ * What goes in here is **purely display defaults** (currency, week-start,
+ * default component scale/variants, app-wide formatters). Per-mount runtime
+ * callbacks (`onSubmit`, `onChange`, …) and per-mount data (lists, item
+ * 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 { 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 { 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

@@ -0,0 +1,15 @@
+/**
+ * `<UIProvider>` — an isolated, mount-once display-default boundary.
+ *
+ * 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.
+ */
+import { type ReactNode } from 'react';
+import type { UIConfig } from './types';
+export interface UIProviderProps {
+    /** Partial display-default tree merged over `DEFAULT_UI_CONFIG`. */
+    config?: UIConfig;
+    children: ReactNode;
+}
+export declare function UIProvider({ config, children }: UIProviderProps): import("react").JSX.Element;

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

@@ -0,0 +1,5 @@
+import { type ComponentScale } from '../component-vocabulary';
+/** Runtime guard for serialized or otherwise untyped component scale values. */
+export declare function isComponentScale(value: unknown): value is ComponentScale;
+/** Resolve direct, provider, and local scale defaults in precedence order. */
+export declare function resolveComponentScale(propScale: ComponentScale | undefined, providerScale: ComponentScale | undefined, fallback?: ComponentScale): ComponentScale;

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

@@ -0,0 +1,11 @@
+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;
+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. */
+export declare function applyUIConfig(config: UIConfig): void;
+/** Test-only reset for the no-provider fallback store. */
+export declare function resetUIConfig(): void;