themelia-react-ui 1.0.1 → 1.0.2

package/dist/components/blocks/data-display/empty-state/partials/illustrations/document-stack.d.ts

@@ -1,8 +1,5 @@
 import type { EmptyStateIllustrationProps } from './types';
-/**
- * Two staggered document silhouettes — for "no documents", "no
- * invoices", "no reports" surfaces.
- */
+/** Two staggered document silhouettes; all coordinates belong to the drawing. */
 export declare function DocumentStackIllustration({ className }: EmptyStateIllustrationProps): import("react").JSX.Element;
 export declare namespace DocumentStackIllustration {
     var displayName: string;

package/dist/components/blocks/data-display/empty-state/partials/illustrations/inbox-clean.d.ts

@@ -1,8 +1,5 @@
 import type { EmptyStateIllustrationProps } from './types';
-/**
- * Open inbox tray with a soft check above — for "all caught up",
- * "no notifications", "inbox zero" surfaces.
- */
+/** Open inbox tray with a check; the scene has one intrinsic coordinate system. */
 export declare function InboxCleanIllustration({ className }: EmptyStateIllustrationProps): import("react").JSX.Element;
 export declare namespace InboxCleanIllustration {
     var displayName: string;

package/dist/components/blocks/data-display/empty-state/partials/illustrations/index.d.ts

@@ -1,9 +1,9 @@
 /**
  * Token-driven illustrations for `<EmptyState>`.
  *
- * Each illustration is a small composition of `bg-muted` /
- * `bg-background` / `border-border` divs (no raw palette colors), so it
- * adapts to the consumer's theme automatically. Use as the `media`
+ * Each illustration uses semantic theme colors for its HTML or SVG drawing,
+ * so it adapts to the consumer's theme automatically. Intrinsic drawing
+ * coordinates remain independent of UI spacing and density. Use as the `media`
  * prop of `<EmptyState>` — pick one per resource:
  *
  *     <EmptyState

package/dist/components/blocks/data-display/empty-state/partials/illustrations/stacked-cards.d.ts

@@ -1,10 +1,5 @@
 import type { EmptyStateIllustrationProps } from './types';
-/**
- * Three stacked card silhouettes with a fade-out at the bottom — the
- * generic "no records" illustration. Token-driven so it adapts to any
- * theme (uses `bg-muted`, `bg-background`, `border-border`, no raw
- * palette).
- */
+/** Three card silhouettes with a theme-backed fade; coordinates are drawing geometry. */
 export declare function StackedCardsIllustration({ className }: EmptyStateIllustrationProps): import("react").JSX.Element;
 export declare namespace StackedCardsIllustration {
     var displayName: string;

package/dist/components/features/combobox/components/error-message.d.ts

@@ -9,7 +9,7 @@ export interface ErrorMessageProps {
     size: ComboboxSize;
     className?: string;
 }
-export declare function ErrorMessage({ error, size, className, }: ErrorMessageProps): React.ReactElement | null;
+export declare function ErrorMessage({ error, size: _size, className, }: ErrorMessageProps): React.ReactElement | null;
 export declare namespace ErrorMessage {
     var displayName: string;
 }

package/dist/components/features/comments/hooks/use-attachment-upload.d.ts

@@ -1,3 +1,5 @@
+import { type StringsProp } from '../../../../lib/strings';
+import { type CommentsStrings } from '../comments.strings';
 import type { CommentAttachment, CommentsAttachmentsConfig } from '../comments.types';
 export interface UseAttachmentUploadOptions extends CommentsAttachmentsConfig {
     /** Initial attachments — useful when editing an existing comment. */
@@ -6,6 +8,9 @@ export interface UseAttachmentUploadOptions extends CommentsAttachmentsConfig {
     onValueChange?: (attachments: ReadonlyArray<CommentAttachment>) => void;
     /** Fires when a validation or upload error happens. */
     onError?: (error: string) => void;
+    /** Validation and non-Error upload fallback copy; omitted keys use Comments defaults.
+     * Error objects retain their caller-supplied message. */
+    strings?: StringsProp<Pick<CommentsStrings, 'attachmentTooLargeError' | 'attachmentTooManyError' | 'attachmentFailedLabel'>>;
 }
 export interface UseAttachmentUploadReturn {
     /** All attachments — uploading + uploaded + failed. */

package/dist/components/features/filters/facets/search-facet.d.ts

@@ -10,18 +10,6 @@ export interface SearchFacetProps {
     /** Merged onto the outermost node. */
     className?: string;
 }
-/**
- * Search Filter Facet
- *
- * This component implements a text search filter that allows users to:
- * - Enter search terms
- * - Configure search behavior (contains, equals, etc.)
- * - Set debounce delay for performance
- * - Customize placeholder text and appearance
- *
- * The component integrates with the filter context to manage the search value
- * and provides a responsive search input interface.
- */
 declare function SearchFacetComponent({ filter, value, onValueChange, className, }: SearchFacetProps): React.JSX.Element;
 export declare const SearchFacet: React.MemoExoticComponent<typeof SearchFacetComponent>;
 export {};

package/dist/components/features/filters/facets/tags-facet.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { type FilterConfig } from '../filters.types';
+import type { FilterConfig } from '../filters.types';
 export interface TagsFacetProps {
     /** Definition of the filter this control edits. */
     filter: FilterConfig;

package/dist/components/features/media-library/media-library.d.ts

@@ -1,3 +1,3 @@
 import type { MediaLibraryDialogProps, MediaLibraryProps } from './media-library.types';
-export declare function MediaLibrary<TItem = import('./media-library.types').MediaLibraryItem>({ title, description, confirmLabel, cancelLabel, selectionMode, density, showMeta, allowUpload, typeFilters, confirmOnSelect, onConfirm, onCancel, onClose, strings: stringsProp, slots, heightClassName, className, items, fetcher, accessors, collections, value, defaultValue, onValueChange, onItemUpdate, onItemDelete, onUpload, onError, tab, defaultTab, onTabChange, view, defaultView, onViewChange, query, defaultQuery, onQueryChange, type, defaultType, onTypeChange, collection, defaultCollection, onCollectionChange, sort, defaultSort, onSortChange, uploadOptions, defaultUploadOptions, onUploadOptionsChange, ...props }: MediaLibraryProps<TItem>): import("react").JSX.Element;
+export declare function MediaLibrary<TItem = import('./media-library.types').MediaLibraryItem>({ title, titleSuffix, description, confirmLabel, cancelLabel, selectionMode, density, showMeta, allowUpload, typeFilters, confirmOnSelect, onConfirm, onCancel, onClose, strings: stringsProp, slots, heightClassName, className, items, fetcher, accessors, collections, value, defaultValue, onValueChange, onItemUpdate, onItemDelete, onItemReplace, onUpload, onError, tab, defaultTab, onTabChange, view, defaultView, onViewChange, query, defaultQuery, onQueryChange, type, defaultType, onTypeChange, collection, defaultCollection, onCollectionChange, sort, defaultSort, onSortChange, uploadOptions, defaultUploadOptions, onUploadOptionsChange, ...props }: MediaLibraryProps<TItem>): import("react").JSX.Element;
 export declare function MediaLibraryDialog<TItem = import('./media-library.types').MediaLibraryItem>({ open, onOpenChange, trigger, dialogTitle, dialogDescription, onClose, className, dialogClassName, contentClassName, closeOnEscape, closeOnBackdropClick, ...props }: MediaLibraryDialogProps<TItem>): import("react").JSX.Element;

package/dist/components/features/media-library/media-library.types.d.ts

@@ -114,7 +114,7 @@ export interface MediaLibraryAccessors<TItem = MediaLibraryItem> {
 export type ResolvedMediaLibraryAccessors<TItem = MediaLibraryItem> = Required<MediaLibraryAccessors<TItem>>;
 export interface MediaLibrarySlots<TItem = MediaLibraryItem> {
     headerStart?: ReactNode;
-    /** Content at the end of the header, before the overflow menu. */
+    /** Header controls beside the library/upload tabs. Put title status in `titleSuffix`. */
     headerEnd?: ReactNode;
     /** Content at the end of the toolbar row. */
     toolbarEnd?: ReactNode;
@@ -151,6 +151,8 @@ export interface MediaLibraryDetailRenderContext<TItem = MediaLibraryItem> {
     accessors: ResolvedMediaLibraryAccessors<TItem>;
     update: (patch: MediaLibraryItemPatch) => Promise<boolean>;
     remove: () => Promise<boolean>;
+    /** Requests the consumer's replacement workflow for this inspected item, when supported. */
+    replace?: () => void;
     close: () => void;
 }
 export interface MediaLibraryState<TItem = MediaLibraryItem> {
@@ -300,6 +302,10 @@ export interface UseMediaLibraryOptions<TItem = MediaLibraryItem> {
 export interface MediaLibraryProps<TItem = MediaLibraryItem> extends Omit<ComponentPropsWithoutRef<'section'>, 'children' | 'defaultValue' | 'onError' | 'onSelect' | 'title'>, UseMediaLibraryOptions<TItem> {
     /** Heading above the browser. */
     title?: ReactNode;
+    /** Status, count, or version content directly after the title; header actions belong in `slots.headerEnd`. */
+    titleSuffix?: ReactNode;
+    /** Requests replacement of the inspected asset. The consumer owns file selection, persistence, identity, and refreshed `items`; omitted callbacks hide Replace file. */
+    onItemReplace?: (item: TItem) => void;
     /** Supporting line under the title. */
     description?: ReactNode;
     /** Copy for the confirm action. */
@@ -455,6 +461,8 @@ export interface MediaLibraryDetailPanelProps<TItem = MediaLibraryItem> {
     onUpdate: (patch: MediaLibraryItemPatch) => Promise<boolean>;
     /** Fired when an entry is removed. */
     onRemove: () => Promise<boolean>;
+    /** Opens the consumer-owned replacement workflow for the inspected item. */
+    onReplace?: () => void;
     /** Replaces the default detail rendering. */
     renderDetail?: MediaLibrarySlots<TItem>['renderDetail'];
 }

package/dist/components/features/media-library/partials/media-library-partials.d.ts

@@ -3,7 +3,7 @@ export declare function MediaLibraryEmptyState({ icon, title, description, actio
 export declare function MediaLibraryToolbar({ query, type, typeFilters, collection, sort, view, collections, strings, onQueryChange, onTypeChange, onCollectionChange, onSortChange, onViewChange, onClearFilters, toolbarEnd, }: MediaLibraryToolbarProps): import("react").JSX.Element;
 export declare function MediaLibraryCard<TItem>({ item, selected, density, showMeta, accessors, strings, onToggle, onDetails, className, }: MediaLibraryCardProps<TItem>): import("react").JSX.Element;
 export declare function MediaLibraryList<TItem>({ items, selectedSet, accessors, strings, onToggle, onDetails, }: MediaLibraryListProps<TItem>): import("react").JSX.Element;
-export declare function MediaLibraryDetailPanel<TItem>({ item, collections, accessors, strings, onClose, onUpdate, onRemove, renderDetail, }: MediaLibraryDetailPanelProps<TItem>): import("react").JSX.Element | null;
+export declare function MediaLibraryDetailPanel<TItem>({ item, collections, accessors, strings, onClose, onUpdate, onRemove, onReplace, renderDetail, }: MediaLibraryDetailPanelProps<TItem>): import("react").JSX.Element | null;
 export declare function MediaLibraryUploadPanel({ stagedFiles, uploadOptions, collections, uploading, strings, onFiles, onRemoveFile, onOptionsChange, empty, }: MediaLibraryUploadPanelProps): import("react").JSX.Element;
 export declare function MediaLibraryFooterSummary({ tab, selectedIds, selectionMode, stagedFiles, strings, onClearSelection, className, }: MediaLibraryFooterSummaryProps): import("react").JSX.Element;
 export declare function MediaLibraryFooterActions<TItem>({ tab, selectedItems, selectedIds, stagedFiles, uploading, strings, confirmLabel, cancelLabel, onCancel, onConfirm, onUpload, onCancelUpload, className, }: MediaLibraryFooterActionsProps<TItem>): import("react").JSX.Element;

package/dist/components/features/overlays/hooks/use-pending-overlay-focus.d.ts

@@ -0,0 +1,2 @@
+/** Keep modal focus anchored when its focused action becomes disabled. */
+export declare function usePendingOverlayFocus(pending: boolean, modal?: boolean | 'trap-focus'): import("react").RefObject<HTMLDivElement | null>;

package/dist/components/features/overlays/overlays.types.d.ts

@@ -76,8 +76,9 @@ export interface OverlayActionProps {
     onConfirm?: () => void;
     /**
      * Awaited confirm. The confirm button shows a spinner and both buttons
-     * disable until it settles. A rejection leaves the overlay open and is
-     * reported through `onError`. Ignored when `onConfirm` is also set.
+     * disable until it settles. Close, Escape and backdrop dismissal also wait
+     * for completion. A rejection leaves the overlay open, restores the actions
+     * and is reported through `onError`. Ignored when `onConfirm` is also set.
      */
     onAsyncConfirm?: () => Promise<void>;
     /** Receives rejected async confirmations so consumers can report or toast them. */
@@ -91,7 +92,7 @@ export interface OverlayActionProps {
     confirmTone?: OverlayButtonTone;
     /** Confirm button fill treatment. */
     confirmStyle?: OverlayButtonStyle;
-    /** Forces the pending presentation for confirm work owned outside the overlay. */
+    /** Applies the same pending action/dismissal lock for work owned outside the overlay. */
     loading?: boolean;
     /**
      * `id` of a form elsewhere in the tree. The confirm button calls
@@ -99,7 +100,7 @@ export interface OverlayActionProps {
      * `onSubmit` owns the outcome — `onConfirm` and `onAsyncConfirm` do not fire.
      */
     formId?: string;
-    /** Replaces the generated footer entirely. The props above no longer apply. */
+    /** Replaces the generated footer; the consumer owns its action states. Pending dismissal protection still applies. */
     footer?: ReactNode;
 }
 /** Semantic weight — the header icon and the confirm button's tone. */

package/dist/components/features/rich-text-editor/rich-text-editor.recipes.d.ts

@@ -1,6 +1,7 @@
 /** Shared field anatomy for rich editors, including specialized document schemas. */
 export declare const richTextEditorRecipes: {
-    readonly frame: "min-w-0 overflow-hidden border-input bg-background rounded-radius border";
+    readonly source: string;
+    readonly frame: "min-w-0 overflow-hidden border-input bg-background rounded-inner border";
     readonly disabled: "opacity-70";
     readonly content: "h-full [&_.ProseMirror]:h-full [&_.ProseMirror]:min-h-full [&_.ProseMirror]:outline-none";
 };

package/dist/components/features/table/data-table.d.ts

@@ -1,6 +1,6 @@
 export declare function useDataTableSize(): 'xs' | 'sm';
 import { type DataTableProps } from './table.types';
-export declare function DataTable<TData extends object, TValue = unknown>({ size, surface, headerTransparent, columns, data, columnGroups, rowActions, rowActionsMenuLabel, rowActionsDisplayMode, rowActionsBreakpoint, enableSorting, enableFiltering, filterColumn, filterPlaceholder, manualSorting, enableColumnVisibility, fullscreen: controlledFullscreen, defaultFullscreen, onFullscreenChange, showFullscreenToggle, enableRowSelection, enableMultiRowSelection, enableSubRowSelection, pagination, pageQueryKey, onPageChange, onSortingChange, onColumnFiltersChange, onRowClick, onRowSelectionChange, stickyHeader, stickyToolbar, stickyFirstColumn, maxBodyHeight, fillAvailableHeight, emptyStateMessage, emptyStateAction, className, rowClassName, cellClassName, headerClassName, wrapperClassName, innerClassName, tableContainerClassName, getRowId, rowSelection: controlledRowSelection, sorting: controlledSorting, defaultSorting, columnVisibility: controlledColumnVisibility, defaultColumnVisibility, initialState, onColumnVisibilityChange, strings: stringsOverride, topbarContent, topbarEnd, topbarClassName, toolbarLabelVisibility, footerContent, selectionToolbar, bulkActions, selectionToolbarClassName, storageKey, }: DataTableProps<TData, TValue>): import("react").JSX.Element;
+export declare function DataTable<TData extends object, TValue = unknown>({ size, surface, headerTransparent, columns, data, columnGroups, rowActions, rowActionsMenuLabel, rowActionsDisplayMode, rowActionsBreakpoint, enableSorting, enableResizing, enableFiltering, filterColumn, filterPlaceholder, manualSorting, enableColumnVisibility, fullscreen: controlledFullscreen, defaultFullscreen, onFullscreenChange, showFullscreenToggle, enableRowSelection, enableMultiRowSelection, enableSubRowSelection, pagination, pageQueryKey, onPageChange, onSortingChange, onColumnFiltersChange, onRowClick, onRowSelectionChange, stickyHeader, stickyToolbar, stickyFirstColumn, maxBodyHeight, fillAvailableHeight, emptyStateMessage, emptyStateAction, className, rowClassName, cellClassName, headerClassName, wrapperClassName, innerClassName, tableContainerClassName, getRowId, rowSelection: controlledRowSelection, sorting: controlledSorting, defaultSorting, columnVisibility: controlledColumnVisibility, defaultColumnVisibility, initialState, onColumnVisibilityChange, strings: stringsOverride, topbarContent, topbarEnd, topbarClassName, toolbarLabelVisibility, footerContent, selectionToolbar, bulkActions, selectionToolbarClassName, storageKey, }: DataTableProps<TData, TValue>): import("react").JSX.Element;
 export declare namespace DataTable {
     var displayName: string;
 }

package/dist/components/features/table/table.types.d.ts

@@ -171,7 +171,7 @@ export type DataTableSize = ComponentScale;
  *
  * - `card` (default): rounded card with `border-border bg-card` and a
  *   soft shadow — the canonical admin treatment.
- * - `glass`: a hairline `border-border/60 rounded-radius-md` outline with no
+ * - `glass`: a hairline `border-border/60 rounded-radius` outline with no
  *   shadow and no card background — pairs with consumer-supplied
  *   surrounding chrome (e.g. dropping into an existing SmartCard).
  *   Background remains transparent so a glassy parent shows

package/dist/components/features/theme-tweaker/theme-provider-settings.d.ts

@@ -39,7 +39,9 @@ export interface ThemeProviderSettingsStrings {
             description: string;
         };
     };
-    labels: Record<'locale' | 'defaultCurrency' | 'displayCurrency' | 'moneyFormat' | 'firstDay' | 'dateFormat' | 'textSize' | 'commentComposer' | 'dualPricing' | 'dualPricingMode' | 'dualPricingLayout' | 'componentScale' | 'itemVariant' | 'buttonTone' | 'buttonStyle' | 'badgeTone' | 'cardSurface' | 'spinner' | 'cardDivider' | 'toastPosition' | 'toastTheme' | 'toastDuration' | 'visibleToasts' | 'closeButton' | 'richColors', string>;
+    labels: Record<'locale' | 'defaultCurrency' | 'displayCurrency' | 'moneyFormat' | 'firstDay' | 'dateFormat' | 'textSize' | 'commentComposer' | 'dualPricing' | 'dualPricingMode' | 'dualPricingLayout' | 'componentScale' | 'itemVariant' | 'buttonTone' | 'buttonStyle' | 'badgeTone' | 'cardSurface' | 'spinner' | 'cardDivider' | 'toastPosition' | 'toastTheme' | 'toastDuration' | 'visibleToasts' | 'closeButton' | 'richColors', string> & {
+        cardFooterDivider?: string;
+    };
     dualPricingDescription: string;
     displayCurrencyPlaceholder: string;
     options: Record<string, string>;

package/dist/components/layout/auth/auth.types.d.ts

@@ -205,6 +205,7 @@ export interface AuthShellProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ti
     /** Content for the panel beside the form in the split layout. */
     splitPanel?: ReactNode | AuthSplitPanelProps;
     splitSide?: AuthSplitSide;
+    /** Panel behavior below the shell's own 64rem inline width; independent of viewport width. */
     splitMobile?: AuthSplitMobile;
     /** Merged onto the main region. */
     mainClassName?: string;

package/dist/components/layout/page/page.d.ts

@@ -1,3 +1,2 @@
 import type { PageProps } from './page.types';
-/** Page — non-scrolling Container, PageHeader, and body-rhythm composition. */
 export declare const Page: import("react").ForwardRefExoticComponent<Omit<PageProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/layout/page/page.types.d.ts

@@ -7,7 +7,7 @@ import type { LayoutLinkRenderer, LayoutNavigationAdapter, LayoutSlotAttributes
 import type { TextGap } from '../../base/structure';
 import type { ButtonSize } from '../../base/buttons';
 import type { HeadingTag } from '../../typography';
-import type { ContainerMaxWidth, ContainerProps } from '../containers/containers.types';
+import type { ContainerGutter, ContainerMaxWidth, ContainerProps } from '../containers/containers.types';
 import type { StringsProp } from '../../../lib/strings';
 import type { BadgeTone } from '../../base/badge';
 import type { ActionPresentation } from '../../../lib/action-presentation';
@@ -33,7 +33,7 @@ export interface PageHeaderProps extends LayoutNavigationAdapter {
     title: ReactNode;
     /** Supporting copy under the title. */
     description?: ReactNode;
-    /** Shared title/description rhythm. Defaults to normal. */
+    /** Shared title/description rhythm. Defaults to dense for page copy. */
     textGap?: TextGap;
     /** Semantic heading level for the title. Defaults to `h3` for nested app pages. */
     headingTag?: HeadingTag;
@@ -130,8 +130,14 @@ export interface PageSlotProps {
 export interface PageProps extends LayoutNavigationAdapter, Omit<ContainerProps, 'children'> {
     /** Header region of the shell. */
     header?: PageHeaderProps;
-    /** Maximum content width. Defaults to `lg` for readable page composition. */
+    /** Maximum content width. Explicit values override narrow. Defaults to `lg`. */
     maxWidth?: ContainerMaxWidth;
+    /** Center one resource or form at the existing `md` content measure. */
+    narrow?: boolean;
+    /** Inline page gutters. Defaults to `lg`; none requires an existing padded parent. */
+    gutter?: ContainerGutter;
+    /** Block padding around the whole page. Defaults to `lg`, independent of gutter. */
+    padding?: ContainerGutter;
     children?: ReactNode;
     /** Native attributes for stable page regions. */
     slotProps?: PageSlotProps;

package/dist/components/layout/sidebar/sidebar.context.d.ts

@@ -8,7 +8,7 @@ export type LayoutSidebarProviderProps = React.ComponentProps<'div'> & {
     adaptTo?: 'viewport' | 'container';
     /** Whether the surface starts open, for uncontrolled use. */
     defaultOpen?: boolean;
-    /** Default row and child-list rhythm. @default 'default' */
+    /** Default row and child-list rhythm. @default 'compact' */
     menuDensity?: SidebarMenuDensity;
     /** Whether the surface is showing. Controlled. */
     open?: boolean;

package/dist/components/layout/sidebar/sidebar.types.d.ts

@@ -41,6 +41,10 @@ export interface SidebarRenderItemContext {
 export interface SidebarSlots {
     /** Header region of the shell. */
     header?: ReactNode;
+    /** Pinned content before the standard logo/workspace region, inside its padded header. */
+    headerStart?: ReactNode;
+    /** Pinned content after the standard logo/workspace region. Full header replacement wins. */
+    headerEnd?: ReactNode;
     beforeNavigation?: ReactNode;
     afterNavigation?: ReactNode;
     /** Content below the body. */

package/dist/components/layout/workspace/workspace.types.d.ts

@@ -1,6 +1,7 @@
 import type { CSSProperties, HTMLAttributes, MouseEvent, ReactNode } from 'react';
 import type { LayoutIconComponent, LayoutNavigationAdapter } from '../layout.types';
 import type { StringsProp } from '../../../lib/strings';
+import type { TextGap } from '../../base/structure';
 import type { WorkspaceLocaleStripStrings, WorkspaceNavStrings, WorkspaceRecordHeaderStrings } from './workspace.strings';
 export type WorkspaceContentWidth = 'default' | 'wide' | 'full';
 export interface WorkspaceLayoutStyle extends CSSProperties {
@@ -42,6 +43,8 @@ export interface WorkspaceRecordHeaderMetadataItem {
     value: ReactNode;
 }
 export interface WorkspaceRecordHeaderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Title/supporting-copy rhythm. Defaults to dense. */
+    textGap?: TextGap;
     /** Surface title. */
     title: ReactNode;
     /** Supporting copy under the title. */

package/dist/components/typography/heading.d.ts

@@ -1,10 +1,13 @@
 import type { HTMLAttributes, ReactNode, Ref } from 'react';
 import type { TextSize } from '../../lib/ui-provider';
-import { textAlignments } from './text.styles';
+import { headingSizes, textAlignments } from './text.styles';
 export type HeadingTag = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+export type HeadingSize = keyof typeof headingSizes;
 export interface HeadingProps extends HTMLAttributes<HTMLHeadingElement> {
     ref?: Ref<HTMLHeadingElement>;
     tag?: HeadingTag;
+    /** Visual emphasis; semantic tag and the default admin size remain independent. */
+    size?: HeadingSize;
     subHeading?: ReactNode;
     subHeadingClassName?: string;
     subHeadingSize?: TextSize;
@@ -13,4 +16,4 @@ export interface HeadingProps extends HTMLAttributes<HTMLHeadingElement> {
     divider?: boolean;
 }
 /** Semantic heading levels share Themelia's restrained admin heading scale. */
-export declare function Heading({ tag: Tag, subHeading, subHeadingClassName, subHeadingSize, containerClassName, align, divider, className, children, ref, ...props }: HeadingProps): import("react").JSX.Element;
+export declare function Heading({ tag: Tag, size, subHeading, subHeadingClassName, subHeadingSize, containerClassName, align, divider, className, children, ref, ...props }: HeadingProps): import("react").JSX.Element;

package/dist/components/typography/index.d.ts

@@ -1,7 +1,7 @@
 export { Text } from './text';
 export type { TextProps } from './text';
 export { Heading } from './heading';
-export type { HeadingProps, HeadingTag } from './heading';
+export type { HeadingProps, HeadingTag, HeadingSize } from './heading';
 export { DisplayLabel } from './display-label';
 export type { DisplayLabelProps } from './display-label';
 export { Label } from './label';

package/dist/components/typography/text.styles.d.ts

@@ -17,6 +17,16 @@ export declare const textSizes: {
     readonly lg: "text-lg";
     readonly xl: "text-xl";
 };
+/** Semantic heading level is independent of visual emphasis. No additional theme roots. */
+export declare const headingSizes: {
+    readonly sm: "text-sm";
+    readonly base: "text-base";
+    readonly lg: "text-lg";
+    readonly xl: "text-xl";
+    readonly '2xl': "text-2xl";
+    readonly '3xl': "text-3xl";
+    readonly '4xl': "text-4xl";
+};
 export declare const textWeights: {
     readonly normal: "font-normal";
     readonly regular: "font-normal";

package/dist/components/ui/popover.d.ts

@@ -9,7 +9,7 @@ declare function PopoverTrigger({ asChild, nativeButton, render, children, ...pr
 declare function PopoverAnchor({ asChild, ...props }: React.ComponentPropsWithoutRef<"span"> & {
     asChild?: boolean;
 }): React.JSX.Element;
-declare function PopoverContent({ className, container, align, alignOffset, side, sideOffset, disablePortal, positionMethod, onOpenAutoFocus, onInteractOutside, ...props }: PopoverPrimitive.Popup.Props & Pick<PopoverPrimitive.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset" | "positionMethod"> & {
+declare function PopoverContent({ className, container, anchor, align, alignOffset, side, sideOffset, disablePortal, positionMethod, onOpenAutoFocus, onInteractOutside, ...props }: PopoverPrimitive.Popup.Props & Pick<PopoverPrimitive.Positioner.Props, "anchor" | "align" | "alignOffset" | "side" | "sideOffset" | "positionMethod"> & {
     disablePortal?: boolean;
     onOpenAutoFocus?: (event: Event) => void;
     onInteractOutside?: (event: Event) => void;

package/dist/components/ui/sidebar.d.ts

@@ -44,7 +44,7 @@ declare const sidebarMenuButtonVariants: (props?: ({
     variant?: "default" | "outline" | null | undefined;
     size?: "sm" | "lg" | "default" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
-declare function SidebarMenuButton({ render, isActive, variant, size, tooltip, className, ...props }: useRender.ComponentProps<"button"> & React.ComponentProps<"button"> & {
+declare function SidebarMenuButton({ render, disabled, isActive, variant, size, tooltip, className, ...props }: useRender.ComponentProps<"button"> & React.ComponentProps<"button"> & {
     isActive?: boolean;
     tooltip?: string | React.ComponentProps<typeof TooltipContent>;
 } & VariantProps<typeof sidebarMenuButtonVariants>): React.JSX.Element;

package/dist/components/ui/table.d.ts

@@ -1,8 +1,9 @@
 import * as React from "react";
 type TableProps = React.ComponentProps<"table"> & {
     containerClassName?: string;
+    containerProps?: React.ComponentProps<"div">;
 };
-declare function Table({ className, containerClassName, ...props }: TableProps): React.JSX.Element;
+declare function Table({ className, containerClassName, containerProps, ...props }: TableProps): React.JSX.Element;
 declare function TableHeader({ className, ...props }: React.ComponentProps<"thead">): React.JSX.Element;
 declare function TableBody({ className, ...props }: React.ComponentProps<"tbody">): React.JSX.Element;
 declare function TableFooter({ className, ...props }: React.ComponentProps<"tfoot">): React.JSX.Element;

package/dist/container.recipes-D9t8MHR3.js

@@ -0,0 +1,27 @@
+//#region src/components/layout/containers/container.recipes.ts
+var e = {
+	sm: "max-w-content-sm",
+	md: "max-w-content-md",
+	lg: "max-w-content-lg",
+	xl: "max-w-content-xl",
+	"2xl": "max-w-content-2xl",
+	full: "max-w-none"
+}, t = {
+	none: "px-0",
+	sm: "px-surface-xs",
+	md: "px-surface",
+	lg: "px-surface-lg"
+};
+function n({ maxWidth: n = "xl", gutter: r = "md" }) {
+	return [
+		"box-border",
+		"mx-auto",
+		"w-full",
+		e[n],
+		t[r]
+	];
+}
+//#endregion
+export { n as t };
+
+//# sourceMappingURL=container.recipes-D9t8MHR3.js.map

package/dist/container.recipes-D9t8MHR3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.recipes-D9t8MHR3.js","names":["maxWidthClasses","gutterClasses","containerRecipe","maxWidth","gutter"],"sources":["../src/components/layout/containers/container.recipes.ts"],"sourcesContent":["import type { ContainerGutter, ContainerMaxWidth } from './containers.types';\n\nconst maxWidthClasses: Record<ContainerMaxWidth, string> = {\n\tsm: 'max-w-content-sm',\n\tmd: 'max-w-content-md',\n\tlg: 'max-w-content-lg',\n\txl: 'max-w-content-xl',\n\t'2xl': 'max-w-content-2xl',\n\tfull: 'max-w-none',\n};\n\nconst gutterClasses: Record<ContainerGutter, string> = {\n\tnone: 'px-0',\n\tsm: 'px-surface-xs',\n\tmd: 'px-surface',\n\tlg: 'px-surface-lg',\n};\n\nexport function containerRecipe({\n\tmaxWidth = 'xl',\n\tgutter = 'md',\n}: {\n\tmaxWidth?: ContainerMaxWidth;\n\tgutter?: ContainerGutter;\n}): string[] {\n\treturn ['box-border', 'mx-auto', 'w-full', maxWidthClasses[maxWidth], gutterClasses[gutter]];\n}\n"],"mappings":";AAEA,IAAMA,IAAqD;CAC1D,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,OAAO;CACP,MAAM;AACP,GAEMC,IAAiD;CACtD,MAAM;CACN,IAAI;CACJ,IAAI;CACJ,IAAI;AACL;AAEA,SAAgBC,EAAgB,EAC/B,cAAW,MACX,YAAS,QAIG;CACZ,OAAO;EAAC;EAAc;EAAW;EAAUF,EAAgBG;EAAWF,EAAcG;CAAO;AAC5F"}

package/dist/{containers-6s-ucRQQ.js → containers-DqB-bSYE.js}

@@ -1,72 +1,49 @@
 "use client";
-import { t as e } from "./utils-C2EKeIw3.js";
+import { t as e } from "./utils-BvH9PSmq.js";
 import { o as t } from "./structure.recipes-Bqhf9oIh.js";
-import { forwardRef as n } from "react";
-import { Fragment as r, jsx as i, jsxs as a } from "react/jsx-runtime";
-import { useRender as o } from "@base-ui/react/use-render";
-//#region src/components/layout/containers/container.recipes.ts
-var s = {
-	sm: "max-w-content-sm",
-	md: "max-w-content-md",
-	lg: "max-w-content-lg",
-	xl: "max-w-content-xl",
-	"2xl": "max-w-content-2xl",
-	full: "max-w-none"
-}, c = {
-	none: "px-0",
-	sm: "px-surface-xs",
-	md: "px-surface",
-	lg: "px-surface-lg"
-};
-function l({ maxWidth: e = "xl", gutter: t = "md" }) {
-	return [
-		"box-border",
-		"mx-auto",
-		"w-full",
-		s[e],
-		c[t]
-	];
-}
-//#endregion
+import { t as n } from "./container.recipes-D9t8MHR3.js";
+import { forwardRef as r } from "react";
+import { Fragment as i, jsx as a, jsxs as o } from "react/jsx-runtime";
+import { useRender as s } from "@base-ui/react/use-render";
 //#region src/components/layout/containers/content-container.tsx
-var u = n(function({ className: t, maxWidth: n, gutter: r, render: i, ...a }, s) {
-	return o({
+var c = r(function({ className: t, maxWidth: r, gutter: i, render: a, ...o }, c) {
+	return s({
 		defaultTagName: "div",
-		ref: s,
-		render: i,
+		ref: c,
+		render: a,
 		props: {
-			...a,
-			className: e("container--component @container/content", l({
-				maxWidth: n,
-				gutter: r
+			...o,
+			className: e("container--component @container/content", n({
+				maxWidth: r,
+				gutter: i
 			}), t)
 		},
 		state: {}
 	});
 });
-u.displayName = "Container";
+c.displayName = "Container";
 //#endregion
 //#region src/components/layout/containers/page-viewport.tsx
-var d = n(function({ className: t, render: n, tabIndex: r = 0, ...i }, a) {
-	return o({
+var l = r(function({ className: t, render: n, tabIndex: r = 0, ...i }, a) {
+	return s({
 		defaultTagName: "div",
 		ref: a,
 		render: n,
 		props: {
 			...i,
 			tabIndex: r,
-			className: e("page-viewport--component min-h-0 min-w-0 flex-1 overflow-auto overscroll-contain [scrollbar-gutter:stable] @container/page focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/70 focus-visible:ring-inset", t)
+			className: e("page-viewport--component min-h-0 min-w-0 flex-1 overflow-auto overscroll-contain [scrollbar-gutter:stable] @container/page focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-inset", t)
 		},
 		state: {}
 	});
 });
-d.displayName = "PageViewport";
+l.displayName = "PageViewport";
 //#endregion
 //#region src/components/layout/containers/section.tsx
-var f = n(function({ className: n, gap: r, render: i, ...a }, s) {
-	return o({
+var u = r(function({ className: n, gap: r, render: i, ...a }, o) {
+	return s({
 		defaultTagName: "section",
-		ref: s,
+		ref: o,
 		render: i,
 		props: {
 			...a,
@@ -75,12 +52,12 @@ var f = n(function({ className: n, gap: r, render: i, ...a }, s) {
 		state: {}
 	});
 });
-f.displayName = "Section";
+u.displayName = "Section";
 //#endregion
 //#region src/components/layout/containers/two-column-layout.tsx
-var p = n(function({ header: t, main: n, aside: s, footer: c, stickyAside: l = !1, adaptTo: u = "viewport", slotProps: d, className: f, render: p, ...m }, h) {
+var d = r(function({ header: t, main: n, aside: r, footer: c, stickyAside: l = !1, adaptTo: u = "viewport", slotProps: d, className: f, render: p, ...m }, h) {
 	let { className: g, ..._ } = d?.header ?? {}, { className: v, ...y } = d?.main ?? {}, { className: b, ...x } = d?.aside ?? {}, { className: S, ...C } = d?.footer ?? {};
-	return o({
+	return s({
 		defaultTagName: "div",
 		ref: h,
 		render: p,
@@ -88,26 +65,26 @@ var p = n(function({ header: t, main: n, aside: s, footer: c, stickyAside: l = !
 			...m,
 			"data-slot": "two-column-layout",
 			className: e("two-column-layout--component grid min-w-0 grid-cols-1 gap-space-2xl", u === "container" ? "@3xl:grid-cols-[minmax(0,2fr)_minmax(18rem,1fr)]" : "lg:grid-cols-[minmax(0,2fr)_minmax(18rem,1fr)]", f),
-			children: /* @__PURE__ */ a(r, { children: [
-				t == null ? null : /* @__PURE__ */ i("div", {
+			children: /* @__PURE__ */ o(i, { children: [
+				t == null ? null : /* @__PURE__ */ a("div", {
 					..._,
 					"data-slot": "two-column-layout-header",
 					className: e("two-column-layout--header col-span-full min-w-0", g),
 					children: t
 				}),
-				/* @__PURE__ */ i("div", {
+				/* @__PURE__ */ a("div", {
 					...y,
 					"data-slot": "two-column-layout-main",
 					className: e("two-column-layout--main min-h-0 min-w-0", v),
 					children: n
 				}),
-				/* @__PURE__ */ i("aside", {
+				/* @__PURE__ */ a("aside", {
 					...x,
 					"data-slot": "two-column-layout-aside",
 					className: e("two-column-layout--aside min-h-0 min-w-0", l && (u === "container" ? "@3xl:sticky @3xl:top-space-2xl @3xl:self-start" : "lg:sticky lg:top-space-2xl lg:self-start"), b),
-					children: s
+					children: r
 				}),
-				c == null ? null : /* @__PURE__ */ i("div", {
+				c == null ? null : /* @__PURE__ */ a("div", {
 					...C,
 					"data-slot": "two-column-layout-footer",
 					className: e("two-column-layout--footer col-span-full min-w-0", S),
@@ -118,8 +95,8 @@ var p = n(function({ header: t, main: n, aside: s, footer: c, stickyAside: l = !
 		state: {}
 	});
 });
-p.displayName = "TwoColumnLayout";
+d.displayName = "TwoColumnLayout";
 //#endregion
-export { u as i, f as n, d as r, p as t };
+export { c as i, u as n, l as r, d as t };
 
-//# sourceMappingURL=containers-6s-ucRQQ.js.map
+//# sourceMappingURL=containers-DqB-bSYE.js.map