themelia-react-ui 2.0.5 → 3.0.0

package/dist/components/base/navigation/language-switcher.d.ts

@@ -1,15 +1,24 @@
+import { type ComponentPropsWithoutRef, type Ref } from 'react';
 import type { LocaleOption } from '../../../types/locale.types';
-export interface LanguageSwitcherProps {
-    /** Locales to offer, in order. The entry with `active: true` is marked as current. */
-    locales: LocaleOption[];
+type LanguageSwitcherLocale = Omit<LocaleOption, 'active'> & {
+    active?: boolean;
+};
+export interface LanguageSwitcherProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'onSelect'> {
+    /** Locales to offer, in order. Their active flags apply when value is omitted. */
+    locales: LanguageSwitcherLocale[];
+    /** Controlled current locale. Takes precedence over the option flags. */
+    value?: string;
+    /** Requests another locale. Not called for the current locale. */
+    onValueChange?: (value: string) => void;
     /** Custom label for each locale. Defaults to `nativeLabel`. */
-    onRenderLabel?: (options: LocaleOption) => string;
-    /** Layout: `buttons` (default) for a row of buttons, `inline` for compact dot-separated text links. */
+    renderLabel?: (options: LocaleOption) => string;
+    /** Layout: `buttons` (default) for a row of buttons, `inline` for compact dot-separated text buttons. */
     variant?: 'buttons' | 'inline';
-    /** Called with the chosen locale's value. Not called for the current locale. */
-    onSelect?: (value: string) => void;
+    /** The group root. Name it with `aria-label` or `aria-labelledby`. */
+    ref?: Ref<HTMLDivElement>;
 }
-export declare function LanguageSwitcher({ locales, onRenderLabel, variant, onSelect, }: LanguageSwitcherProps): import("react").JSX.Element | null;
+export declare function LanguageSwitcher({ locales, value, onValueChange, renderLabel, variant, className, ref, ...props }: LanguageSwitcherProps): import("react").JSX.Element | null;
 export declare namespace LanguageSwitcher {
     var displayName: string;
 }
+export {};

package/dist/components/base/navigation/navigation-tabs.d.ts

@@ -5,11 +5,13 @@
  * `variant="prominent"` provides the stronger filled treatment without
  * introducing a second component or item vocabulary.
  */
-import { type ReactNode } from 'react';
+import { type MouseEvent, type ReactNode } from 'react';
 import type { LucideIcon } from 'lucide-react';
 import { type StringsProp } from '../../../lib/strings';
 import { type TabsScrollStrings } from './tab-scroll-viewport';
 export interface NavigationTabItem {
+    /** Stable identity for `onSelect` handlers and the `data-tab-id` hook. */
+    id?: string;
     title: string;
     href: string;
     icon?: LucideIcon | string;
@@ -35,6 +37,11 @@ export interface NavigationTabsProps {
     scrollStrings?: StringsProp<TabsScrollStrings>;
     /** Overrides the tab row's own copy. */
     strings?: StringsProp<NavigationTabsStrings>;
+    /**
+     * Called when an enabled tab is activated. Call `event.preventDefault()` and
+     * navigate with the application router; without it the link navigates natively.
+     */
+    onSelect?: (item: NavigationTabItem, event: MouseEvent<HTMLAnchorElement>) => void;
     className?: string;
 }
 export declare const NavigationTabs: import("react").ForwardRefExoticComponent<NavigationTabsProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/base/navigation/page-header/index.d.ts

@@ -1,2 +1,2 @@
-export { PageHeading, type PageHeadingProps, type PageHeadingBadge, } from './page-header';
+export { PageHeading, defaultPageHeadingStrings, type PageHeadingProps, type PageHeadingStrings, } from './page-header';
 export { type PageHeaderAction, type PageHeaderLinkRenderProps, type PageHeaderLinkRenderer, } from './page-header-commands';

package/dist/components/base/navigation/page-header/page-header.d.ts

@@ -1,21 +1,21 @@
 /**
  * PageHeading — reusable visual heading block for sections and resources.
  * Higher-level layout components add routing/back behavior around this base
- * visual primitive instead of reimplementing title, description, badge, and
- * action spacing. `primaryAction` and `secondaryActions` describe commands by
+ * visual primitive instead of reimplementing title, description and action
+ * spacing. `primaryAction` and `secondaryActions` describe commands by
  * role; the heading owns their treatment and placement for every header built
  * on it.
  */
-import type { Key, ReactNode } from 'react';
+import type { ReactNode } from 'react';
 import { type HeadingSize, type HeadingTag } from '../../../typography';
-import { type BadgeTone } from '../../badge';
 import { type TextGap } from '../../structure';
+import { type StringsProp } from '../../../../lib/strings';
 import { type PageHeaderAction, type PageHeaderLinkRenderer } from './page-header-commands';
-export interface PageHeadingBadge {
-    label: ReactNode;
-    tone?: BadgeTone;
-    key?: Key;
+export interface PageHeadingStrings {
+    /** Accessible name of the More actions menu trigger. */
+    moreActions: string;
 }
+export declare const defaultPageHeadingStrings: PageHeadingStrings;
 /**
  * Slot map, top to bottom and outside in:
  *
@@ -23,7 +23,7 @@ export interface PageHeadingBadge {
  * breadcrumbs
  * leading │ eyebrow
  *         │ beforeTitle
- *         │ titlePrefix │ title  badges  titleSuffix │ actions
+ *         │ titlePrefix │ title  titleSuffix │ actions
  *         │             │ description
  *         │             │ afterDescription
  * children
@@ -43,10 +43,6 @@ export interface PageHeadingProps {
     headingTag?: HeadingTag;
     /** Visual title scale, independent of heading level. Defaults to the subject role (`base`). */
     titleSize?: HeadingSize;
-    /** Convenience for a single badge beside the title. Ignored when `badges` is set. */
-    badge?: PageHeadingBadge;
-    /** Badges beside the title, in order. Takes precedence over `badge`. */
-    badges?: PageHeadingBadge[];
     /** Breadcrumb trail rendered above the header block. */
     breadcrumbs?: ReactNode;
     /** Content to the left of the entire header column — an avatar or back button. Top-aligned. */
@@ -59,7 +55,7 @@ export interface PageHeadingProps {
      * edge rather than to this slot, so an icon here never shifts the copy.
      */
     titlePrefix?: ReactNode;
-    /** Content after the title and badges, on the same line. */
+    /** Content after the title, on the same line: status and count badges go here. */
     titleSuffix?: ReactNode;
     /** Content directly beneath the description, sharing its alignment — a metadata line. */
     afterDescription?: ReactNode;
@@ -88,8 +84,8 @@ export interface PageHeadingProps {
      * keeps every routine command inline. @default 2
      */
     maxVisibleSecondaryActions?: number;
-    /** Accessible name of the More actions menu trigger. Default: `'More actions'`. */
-    moreActionsLabel?: string;
+    /** Overrides the heading's own copy: the More actions menu trigger's name. */
+    strings?: StringsProp<PageHeadingStrings>;
     /** Renders `href` commands as framework links. Defaults to a native anchor. */
     renderLink?: PageHeaderLinkRenderer;
     /** Content below the whole header block, above the separator. */
@@ -117,7 +113,7 @@ export interface PageHeadingProps {
      */
     withSeparator?: boolean;
 }
-export declare function PageHeading({ eyebrow, title, description, textGap, headingTag, titleSize, badge, badges, breadcrumbs, leading, beforeTitle, titlePrefix, titleSuffix, afterDescription, actions, primaryAction, secondaryActions, maxVisibleSecondaryActions, moreActionsLabel, renderLink, children, className, contentClassName, eyebrowClassName, titleClassName, titleRowClassName, descriptionClassName, actionsClassName, withSeparator, }: PageHeadingProps): import("react").JSX.Element;
+export declare function PageHeading({ eyebrow, title, description, textGap, headingTag, titleSize, breadcrumbs, leading, beforeTitle, titlePrefix, titleSuffix, afterDescription, actions, primaryAction, secondaryActions, maxVisibleSecondaryActions, strings: stringsProp, renderLink, children, className, contentClassName, eyebrowClassName, titleClassName, titleRowClassName, descriptionClassName, actionsClassName, withSeparator, }: PageHeadingProps): import("react").JSX.Element;
 export declare namespace PageHeading {
     var displayName: string;
 }

package/dist/components/base/navigation/pagination.d.ts

@@ -37,13 +37,13 @@ export interface PaginationLinkProps extends Omit<ButtonProps, 'buttonStyle' | '
     /** Marks the current page. */
     active?: boolean;
 }
-export type PaginationNextProps = PaginationLinkProps & {
+export type PaginationNextProps = Omit<PaginationLinkProps, 'children'> & {
     /** Visible label for the control. */
     text?: string;
     /** Overrides the pagination copy. */
     strings?: StringsProp<PaginationStrings>;
 };
-export type PaginationPreviousProps = PaginationLinkProps & {
+export type PaginationPreviousProps = Omit<PaginationLinkProps, 'children'> & {
     /** Visible label for the control. */
     text?: string;
     /** Overrides the pagination copy. */
@@ -55,10 +55,10 @@ export type PaginationPreviousProps = PaginationLinkProps & {
  * Compose it with the exported content, item, link, previous, next, and
  * ellipsis parts when consumers need explicit page navigation markup.
  */
-export declare function PaginationPrimitive({ className, strings: stringsProp, children, 'aria-label': ariaLabel, ...props }: PaginationProps): import("react").JSX.Element;
+export declare function PaginationRoot({ className, strings: stringsProp, children, 'aria-label': ariaLabel, ...props }: PaginationProps): import("react").JSX.Element;
 export declare function PaginationContent({ className, ...props }: PaginationContentProps): import("react").JSX.Element;
 export declare function PaginationEllipsis({ className, label, size: sizeProp, strings: stringsProp, ...props }: PaginationEllipsisProps): import("react").JSX.Element;
 export declare function PaginationItem(props: PaginationItemProps): import("react").JSX.Element;
 export declare function PaginationLink({ className, children, active, size: sizeProp, ...props }: PaginationLinkProps): import("react").JSX.Element;
-export declare function PaginationPrevious({ className, text, strings: stringsProp, children: _children, ...props }: PaginationPreviousProps): import("react").JSX.Element;
-export declare function PaginationNext({ className, text, strings: stringsProp, children: _children, ...props }: PaginationNextProps): import("react").JSX.Element;
+export declare function PaginationPrevious({ className, text, strings: stringsProp, ...props }: PaginationPreviousProps): import("react").JSX.Element;
+export declare function PaginationNext({ className, text, strings: stringsProp, ...props }: PaginationNextProps): import("react").JSX.Element;

package/dist/components/base/popover/popover.recipes.d.ts

@@ -43,5 +43,4 @@ export declare const collectionRecipes: {
     readonly highlighted: "data-highlighted:bg-accent data-highlighted:text-accent-foreground data-highlighted:[&_svg]:text-accent-foreground";
     readonly disabled: "data-disabled:pointer-events-none data-disabled:opacity-50";
     readonly destructive: "data-[variant=destructive]:text-destructive data-[variant=destructive]:data-highlighted:bg-destructive/10 data-[variant=destructive]:data-highlighted:text-destructive dark:data-[variant=destructive]:data-highlighted:bg-destructive/10 data-[variant=destructive]:[&_svg]:text-destructive data-[variant=destructive]:data-highlighted:[&_svg]:text-destructive";
-    readonly tableRow: "min-h-action-xs py-space-2xs";
 };

package/dist/components/base/qr-code/qr-code.d.ts

@@ -5,6 +5,8 @@ export type QRCodeProps = HTMLAttributes<HTMLDivElement> & {
     foreground?: string;
     background?: string;
     robustness?: 'L' | 'M' | 'Q' | 'H';
+    /** Blank modules around the code. Defaults to `0`; scanners expect four when the code sits on a busy surface. */
+    quietZone?: number;
 };
 export declare const QRCode: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
     /** Encoded payload. Pass `aria-label` to describe it; the code is then exposed as one image. */
@@ -12,4 +14,6 @@ export declare const QRCode: import("react").ForwardRefExoticComponent<HTMLAttri
     foreground?: string;
     background?: string;
     robustness?: "L" | "M" | "Q" | "H";
+    /** Blank modules around the code. Defaults to `0`; scanners expect four when the code sits on a busy surface. */
+    quietZone?: number;
 } & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/base/repeaters/index.d.ts

@@ -15,7 +15,7 @@ export { Repeater, defaultRepeaterPrimitiveStrings, type RepeaterComponentProps,
 export { StringRepeater, defaultStringRepeaterStrings, type StringRepeaterProps, type StringRepeaterStrings, type StringRepeaterFieldRenderContext, } from './string-repeater';
 export { ObjectRepeater, defaultObjectRepeaterStrings, type ObjectRepeaterProps, type ObjectRepeaterStrings, type ObjectRepeaterFieldRenderContext, type ObjectFieldDef, } from './object-repeater';
 export { defaultRepeaterStrings, type RepeaterSharedStrings, } from './repeaters.strings';
-export { KeyValueEditor, type KeyValueEditorProps, type KeyValuePair } from './key-value-editor';
+export { KeyValueEditor, defaultKeyValueEditorStrings, type KeyValueEditorProps, type KeyValueEditorStrings, type KeyValuePair, } from './key-value-editor';
 export { LocalizedStringField, type LocalizedStringFieldProps } from './localized-string-field';
 export { LocalizedObjectField, type LocalizedObjectFieldProps, type LocalizedObjectFieldDef } from './localized-object-field';
 export { LocalizedStringRepeater, defaultLocalizedStringRepeaterStrings, type LocalizedStringRepeaterProps, type LocalizedStringRepeaterStrings, } from './localized-string-repeater';

package/dist/components/base/repeaters/key-value-editor.d.ts

@@ -1,3 +1,4 @@
+import { type FieldControlAttributes } from '../../../lib/field-control-attributes';
 import { type StringsProp } from '../../../lib/strings';
 export type KeyValuePair = {
     key: string;
@@ -13,9 +14,11 @@ export interface KeyValueEditorStrings {
     emptyState: string;
 }
 export declare const defaultKeyValueEditorStrings: KeyValueEditorStrings;
-export interface KeyValueEditorProps {
+export interface KeyValueEditorProps extends FieldControlAttributes {
     /** Current value. Controlled. */
     value?: Record<string, string>;
+    /** Initial rows while uncontrolled. */
+    defaultValue?: Record<string, string>;
     onValueChange?: (val: Record<string, string>) => void;
     /** Applies the invalid styling. */
     invalid?: boolean;
@@ -23,5 +26,7 @@ export interface KeyValueEditorProps {
     sortable?: boolean;
     /** Override default strings (labels, placeholders, button text). */
     strings?: StringsProp<KeyValueEditorStrings>;
+    /** Additional classes merged onto the group root. */
+    className?: string;
 }
 export declare const KeyValueEditor: import("react").ForwardRefExoticComponent<KeyValueEditorProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/base/sheet/sheet.d.ts

@@ -4,9 +4,8 @@ import type { TextGap } from '../structure';
  * mobile sidebar drawer.
  *
  * Applications use `ActionDrawer` from `themelia-react-ui/features/overlays`,
- * which owns the lifecycle, focus, dismissal and action contract; the
- * `themelia-react-ui/base/sheet` entrypoint remains only as a deprecated
- * compatibility surface. The panel shares the modal geometry of the internal
+ * which owns the lifecycle, focus, dismissal and action contract; this
+ * family has no public entrypoint. The panel shares the modal geometry of the internal
  * Dialog wrapper: header, scrolling body and footer each own their inset, one
  * rule separates adjacent visible regions, and one edge rule separates the
  * panel from the page.
@@ -14,12 +13,8 @@ import type { TextGap } from '../structure';
 import * as React from 'react';
 import { Sheet as SheetPrimitive } from '../../ui/sheet';
 export declare const Sheet: typeof SheetPrimitive;
-export declare const SheetTrigger: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").DialogTrigger.Props<unknown> & {
-    asChild?: boolean;
-}, "ref"> & React.RefAttributes<HTMLButtonElement>>;
-export declare const SheetClose: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogCloseProps & {
-    asChild?: boolean;
-}, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const SheetTrigger: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").DialogTrigger.Props<unknown>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const SheetClose: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogCloseProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 export declare const SheetContent: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogPopupProps & {
     side?: "top" | "right" | "bottom" | "left";
     showCloseButton?: boolean;
@@ -34,9 +29,5 @@ export declare const SheetHeader: React.ForwardRefExoticComponent<Omit<React.Cla
 /** Scroll-owning content region between the pinned sheet header and footer. */
 export declare const SheetBody: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
 export declare const SheetFooter: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export declare const SheetTitle: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogTitleProps & {
-    asChild?: boolean;
-}, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
-export declare const SheetDescription: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogDescriptionProps & {
-    asChild?: boolean;
-}, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+export declare const SheetTitle: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogTitleProps, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+export declare const SheetDescription: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogDescriptionProps, "ref"> & React.RefAttributes<HTMLParagraphElement>>;

package/dist/components/base/sidebar/index.d.ts

@@ -1,6 +1 @@
-export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRegion, SidebarRail, SidebarSeparator, SidebarTrigger, defaultSidebarStrings, type SidebarProps, type SidebarInputProps, type SidebarMenuBadgeProps, type SidebarMenuButtonProps, type SidebarMenuDensity, type SidebarMenuProps, type SidebarMenuSkeletonProps, type SidebarMenuSubButtonProps, type SidebarProviderProps, type SidebarRegionProps, type SidebarPanelId, type SidebarPresentation, type SidebarStrings, } from './sidebar';
-/**
- * @deprecated Use `useLayoutSidebar` from `themelia-react-ui/layout/sidebar`.
- * This vendored compatibility re-export remains available through 1.x.
- */
-export { useSidebar } from '../../ui/sidebar';
+export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRegion, SidebarRail, SidebarSeparator, SidebarTrigger, defaultSidebarStrings, type SidebarProps, type SidebarInputProps, type SidebarMenuBadgeProps, type SidebarMenuButtonProps, type SidebarRowTone, type SidebarMenuDensity, type SidebarMenuProps, type SidebarMenuSkeletonProps, type SidebarMenuSubButtonProps, type SidebarProviderProps, type SidebarRegionProps, type SidebarPanelId, type SidebarPresentation, type SidebarStrings, } from './sidebar';

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

@@ -13,6 +13,8 @@ import { type StringsProp } from '../../../lib/strings';
 export interface SidebarStrings {
     mobileTitle: string;
     mobileDescription: string;
+    /** Accessible name of `SidebarTrigger` and `SidebarRail`. Optional so existing complete string objects stay valid. */
+    toggle?: string;
 }
 export declare const defaultSidebarStrings: SidebarStrings;
 export interface SidebarProps extends React.ComponentProps<'div'> {
@@ -40,7 +42,15 @@ type SidebarFooterProps = React.ComponentProps<typeof SidebarFooterPrimitive>;
 type SidebarGroupProps = React.ComponentProps<typeof SidebarGroupPrimitive>;
 type SidebarGroupActionProps = React.ComponentProps<typeof SidebarGroupActionPrimitive>;
 type SidebarGroupContentProps = React.ComponentProps<typeof SidebarGroupContentPrimitive>;
-type SidebarGroupLabelProps = React.ComponentProps<typeof SidebarGroupLabelPrimitive>;
+type SidebarGroupLabelProps = React.ComponentProps<typeof SidebarGroupLabelPrimitive> & {
+    /**
+     * A static heading: content height and no bottom margin, so the surrounding
+     * gap owns the rhythm. Defaults to `false`, the action-height label row.
+     */
+    compact?: boolean;
+};
+/** `secondary` rests on the sidebar's secondary text tier; hover and the current entry return to the full foreground. */
+export type SidebarRowTone = 'default' | 'secondary';
 type SidebarHeaderProps = React.ComponentProps<typeof SidebarHeaderPrimitive>;
 export interface SidebarInputProps extends React.ComponentProps<typeof SidebarInputPrimitive> {
     /** Accessible name when no visible label is associated with the navigation search. */
@@ -74,6 +84,8 @@ export interface SidebarMenuButtonProps extends Omit<React.ComponentProps<typeof
     size?: ComponentScale;
     /** Marks the navigation item as current. */
     active?: boolean;
+    /** Text tier of the resting row. Defaults to `default`. */
+    tone?: SidebarRowTone;
 }
 type SidebarMenuItemProps = React.ComponentProps<typeof SidebarMenuItemPrimitive>;
 export interface SidebarMenuSkeletonProps extends React.ComponentProps<'div'> {
@@ -82,10 +94,15 @@ export interface SidebarMenuSkeletonProps extends React.ComponentProps<'div'> {
     /** Deterministic text-bar width. @default "72%" */
     width?: string;
 }
-type SidebarMenuSubProps = React.ComponentProps<typeof SidebarMenuSubPrimitive>;
+type SidebarMenuSubProps = React.ComponentProps<typeof SidebarMenuSubPrimitive> & {
+    /** Drops the list's end inset, so child rows reach the same end edge as their parent row. Defaults to `false`. */
+    flushEnd?: boolean;
+};
 export interface SidebarMenuSubButtonProps extends Omit<React.ComponentProps<typeof SidebarMenuSubButtonPrimitive>, 'isActive'> {
     /** Marks the nested navigation item as current. */
     active?: boolean;
+    /** Text tier of the resting row. Defaults to `default`. */
+    tone?: SidebarRowTone;
 }
 type SidebarMenuSubItemProps = React.ComponentProps<typeof SidebarMenuSubItemPrimitive>;
 export interface SidebarProviderProps extends React.ComponentProps<'div'>, SidebarStateProps {
@@ -106,9 +123,20 @@ export interface SidebarProviderProps extends React.ComponentProps<'div'>, Sideb
     /** Additional classes merged with the provider root. */
     className?: string;
 }
-type SidebarRailProps = React.ComponentProps<typeof SidebarRailPrimitive>;
+type SidebarToggleStrings = StringsProp<Pick<SidebarStrings, 'toggle'>>;
+type SidebarTriggerScale = 'sm' | 'md' | 'lg';
+type SidebarRailProps = Omit<React.ComponentProps<typeof SidebarRailPrimitive>, 'toggleLabel'> & {
+    /** Overrides the rail's accessible name. */
+    strings?: SidebarToggleStrings;
+};
 type SidebarSeparatorProps = React.ComponentProps<typeof SidebarSeparatorPrimitive>;
-type SidebarTriggerProps = React.ComponentProps<typeof SidebarTriggerPrimitive>;
+type RawSidebarTriggerProps = React.ComponentProps<typeof SidebarTriggerPrimitive>;
+type SidebarTriggerProps = Omit<RawSidebarTriggerProps, 'toggleLabel' | 'size' | 'variant'> & {
+    /** Overrides the trigger's accessible name. */
+    strings?: SidebarToggleStrings;
+    /** Button scale, matching the public `Button`. Defaults to `md`, the height of the header controls beside it. */
+    size?: SidebarTriggerScale;
+};
 declare function SidebarProvider({ className, style, menuDensity, ...props }: SidebarProviderProps): React.JSX.Element;
 export interface SidebarRegionProps extends Omit<React.ComponentProps<'div'>, 'ref'> {
     /** Ref to the semantic aside boundary. */
@@ -141,17 +169,19 @@ declare function SidebarMenuItem({ className, ...props }: SidebarMenuItemProps):
 declare function SidebarMenuAction({ className, ...props }: SidebarMenuActionProps): React.JSX.Element;
 declare function SidebarMenuBadge({ className, inline, size, children, ...props }: SidebarMenuBadgeProps): React.JSX.Element;
 declare function SidebarMenuSkeleton({ className, showIcon, style, width, ...props }: SidebarMenuSkeletonProps): React.JSX.Element;
-declare function SidebarMenuSub({ className, ...props }: SidebarMenuSubProps): React.JSX.Element;
+declare function SidebarMenuSub({ className, flushEnd, ...props }: SidebarMenuSubProps): React.JSX.Element;
 declare function SidebarMenuSubItem({ className, ...props }: SidebarMenuSubItemProps): React.JSX.Element;
 declare function SidebarInset({ className, ...props }: SidebarInsetProps): React.JSX.Element;
-declare function SidebarRail({ className, ...props }: SidebarRailProps): React.JSX.Element;
-declare function SidebarTrigger({ className, ...props }: SidebarTriggerProps): React.JSX.Element;
-declare function SidebarMenuButton({ className, render, size, tooltip, children, active, ...props }: SidebarMenuButtonProps): React.JSX.Element;
-declare function SidebarMenuSubButton({ className, children, active, ...props }: SidebarMenuSubButtonProps): React.JSX.Element;
-declare function SidebarGroupLabel({ className, children, ...props }: SidebarGroupLabelProps): React.JSX.Element;
+declare function SidebarRail({ className, strings: stringsProp, ...props }: SidebarRailProps): React.JSX.Element;
+declare function SidebarTrigger({ className, strings: stringsProp, size, ...props }: SidebarTriggerProps): React.JSX.Element;
+declare function SidebarMenuButton({ className, render, size, tooltip, children, active, tone, ...props }: SidebarMenuButtonProps): React.JSX.Element;
+declare function SidebarMenuSubButton({ className, children, active, tone, ...props }: SidebarMenuSubButtonProps): React.JSX.Element;
+declare function SidebarGroupLabel({ className, children, compact, ...props }: SidebarGroupLabelProps): React.JSX.Element;
 export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRegion, SidebarRail, SidebarSeparator, SidebarTrigger, };
 /** Internal bridge for the layout layer; not part of the base package entrypoint. */
 export declare const useBaseSidebarContext: typeof useSidebarPrimitive;
+/** Lets composed layouts omit a sidebar control when no provider is present. */
+export declare function useHasSidebarProvider(): boolean;
 /** Internal density bridge for composed navigation; not a base entrypoint export. */
 export declare function useBaseSidebarMenuDensity(): SidebarMenuDensity | undefined;
 export type { SidebarPanelId, SidebarPresentation };

package/dist/components/base/skeleton/skeleton.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { Skeleton as PrimitiveSkeleton } from '../../ui/skeleton';
 type DivProps = React.ComponentPropsWithoutRef<'div'>;
-export interface SkeletonProps extends React.ComponentPropsWithoutRef<typeof PrimitiveSkeleton> {
+export interface SkeletonProps extends React.ComponentProps<typeof PrimitiveSkeleton> {
 }
 export declare function Skeleton({ className, ...props }: SkeletonProps): React.JSX.Element;
 export declare namespace Skeleton {

package/dist/components/base/structure/structure.types.d.ts

@@ -6,14 +6,23 @@ export type TextGap = 'normal' | 'dense';
 export type StructureGap = TextGap | 'none' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
 export type StructureAlign = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
 export type StructureJustify = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+/**
+ * Stack arranges its children and never sizes their content: a child that must
+ * truncate or shrink below its content in a horizontal stack takes `min-w-0`
+ * itself. Grid tracks are `minmax(0, 1fr)`, so content cannot widen a column.
+ */
 export interface StackProps extends useRender.ComponentProps<'div'> {
     /** Main axis. Every structure prop also accepts a per-breakpoint object. Defaults to `vertical`. */
     direction?: ResponsiveValue<'vertical' | 'horizontal'>;
     /** Space between children, on the semantic spacing scale. Defaults to `md`. */
     gap?: ResponsiveValue<StructureGap>;
-    /** Cross-axis alignment of children. */
+    /**
+     * Cross-axis alignment of children. A vertical stack defaults to `stretch`,
+     * so children fill its width; a horizontal one defaults to `center`. Use
+     * `start` to keep a child at its own width.
+     */
     align?: ResponsiveValue<StructureAlign>;
-    /** Main-axis distribution of children. */
+    /** Main-axis distribution of children. Defaults to `start`. */
     justify?: ResponsiveValue<StructureJustify>;
     /** Allows children to flow onto more than one line. Horizontal directions wrap by default. */
     wrap?: ResponsiveValue<boolean>;

package/dist/components/base/text-inputs/index.d.ts

@@ -15,7 +15,7 @@
  * behind `Input` and `Textarea`, not a composition seam.
  */
 export { Input, defaultInputStrings, type InputProps, type InputStrings } from './input';
-export { Textarea, type TextareaProps } from './textarea';
+export { Textarea, defaultTextareaStrings, type TextareaProps, type TextareaStrings } from './textarea';
 export { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, type InputGroupProps, type InputGroupAddonProps, type InputGroupButtonProps, type InputGroupInputProps, type InputGroupTextProps, type InputGroupTextareaProps, } from './input-group';
 export { PasswordInput, defaultPasswordInputStrings, type PasswordInputProps, type PasswordInputStrings, } from './password-input';
 export { SlugField, slugifyValue, type SlugFieldProps, type SlugifyValueOptions, } from './slug-field';

package/dist/components/base/tree/index.d.ts

@@ -1,2 +1,3 @@
 export { Tree } from './tree';
+export { defaultTreeStrings } from './tree.types';
 export type { TreeNode, TreeProps, TreeStrings } from './tree.types';

package/dist/components/base/tree/tree.d.ts

@@ -1,3 +1,3 @@
-import type { TreeProps } from './tree.types';
+import { type TreeProps } from './tree.types';
 /** Accessible data-driven hierarchy. Focus moves independently from selection. */
-export declare function Tree<T = unknown>({ items, expandedValues, defaultExpandedValues, onExpandedValuesChange, selectedValues, defaultSelectedValues, onSelectedValuesChange, selectionMode, branchActivation, disabled, density, rowLayout, indent, showGuides, empty, strings, renderLabel, className, onKeyDown, ...props }: TreeProps<T>): import("react").JSX.Element;
+export declare function Tree<T = unknown>({ items, expandedValues, defaultExpandedValues, onExpandedValuesChange, selectedValues, defaultSelectedValues, onSelectedValuesChange, selectionMode, branchActivation, disabled, density, rowLayout, indent, showGuides, empty, strings: stringsProp, renderLabel, className, onKeyDown, ...props }: TreeProps<T>): import("react").JSX.Element;

package/dist/components/base/tree/tree.types.d.ts

@@ -1,3 +1,4 @@
+import type { StringsProp } from '../../../lib/strings';
 import type { ComponentProps, ReactNode } from 'react';
 import type { RowDensity } from '../../../lib/row-recipes';
 /** Stable values must be unique throughout a hierarchy. */
@@ -19,7 +20,10 @@ export interface TreeNode<T = unknown> {
 export interface TreeStrings {
     expand: (label: string) => string;
     collapse: (label: string) => string;
+    /** Shown when there are no items. The `empty` prop overrides it with any node. */
+    empty: string;
 }
+export declare const defaultTreeStrings: TreeStrings;
 export interface TreeProps<T = unknown> extends Omit<ComponentProps<'div'>, 'children' | 'onSelect'> {
     items: readonly TreeNode<T>[];
     expandedValues?: readonly string[];
@@ -40,8 +44,10 @@ export interface TreeProps<T = unknown> extends Omit<ComponentProps<'div'>, 'chi
     indent?: number;
     /** Decorative guides retain the hierarchy at every nesting level. */
     showGuides?: boolean;
+    /** Replaces `strings.empty` with any node. */
     empty?: ReactNode;
-    strings?: Partial<TreeStrings>;
+    /** Overrides the tree's own copy; merged over `defaultTreeStrings`. */
+    strings?: StringsProp<TreeStrings>;
     /** Presentation slot only; interactive content should live outside the tree row. */
     renderLabel?: (node: TreeNode<T>) => ReactNode;
 }

package/dist/components/base/upload/avatar-upload.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { type StringsProp } from '../../../lib/strings';
 import { type ComponentScale } from '../../../lib/ui-provider';
+import { type FieldControlAttributes } from '../../../lib/field-control-attributes';
 export type AvatarUploadSize = ComponentScale;
 export interface AvatarUploadStrings {
     change: string;
@@ -15,7 +16,7 @@ export interface AvatarUploadStrings {
     customValidationFailed: (fileName: string) => string;
 }
 export declare const defaultAvatarUploadStrings: AvatarUploadStrings;
-export interface AvatarUploadProps {
+export interface AvatarUploadProps extends FieldControlAttributes {
     /** Selected file. Controlled. */
     value?: File;
     onValueChange?: (file?: File) => void;

package/dist/components/base/upload/file-upload.validation.d.ts

@@ -1,4 +1,4 @@
-import type { FileUploadRejection, FileUploadValidator } from './file-upload.types';
+import type { FileUploadRejection, FileUploadRejectionCode, FileUploadValidator } from './file-upload.types';
 import type { FileUploadStrings } from './file-upload.strings';
 interface ValidateFileSelectionOptions {
     incoming: File[];
@@ -17,5 +17,41 @@ export interface FileSelectionResult {
     nextFiles: File[];
     rejections: FileUploadRejection[];
 }
+/** The native `accept` rule: extensions (`.pdf`), wildcards (`image/*`) and exact MIME types. An empty rule accepts every file. */
+export declare function matchesFileAccept(file: File, accept?: string): boolean;
+/** File rules shared by every upload surface. All are optional. */
+export interface FileValidationRules {
+    /** Native `accept` value: extensions, wildcards and MIME types, comma-separated. */
+    accept?: string;
+    /** Smallest accepted size in bytes. */
+    minSizeBytes?: number;
+    /** Largest accepted size in bytes. */
+    maxSizeBytes?: number;
+    /** Most files held at once, counting those already chosen. */
+    maxFiles?: number;
+    /** Return `true` to accept, `false` to reject, or a message to reject with that copy. */
+    validateFile?: FileUploadValidator;
+}
+export interface FileValidationRejection {
+    file: File;
+    /** Stable reason; the owner supplies the copy. */
+    code: FileUploadRejectionCode;
+    /** Present only when a custom validator returned its own message. */
+    message?: string;
+}
+export interface FileValidationResult {
+    /** Incoming files that passed every rule, in order. */
+    accepted: File[];
+    /** `current` followed by `accepted`. */
+    nextFiles: File[];
+    rejections: FileValidationRejection[];
+}
+/**
+ * The one file validator: type, size, custom rule, duplicates and count, in
+ * that order. It performs no transfer and holds no copy; rejections carry a
+ * stable code so each surface words them through its own strings.
+ */
+export declare function validateFiles(incoming: readonly File[], rules?: FileValidationRules, current?: readonly File[]): FileValidationResult;
+/** FileUpload's adapter: the shared rules plus its own localized copy. */
 export declare function validateFileSelection({ incoming, current, accept, minSizeBytes, maxSizeBytes, maxFiles, append, validateFile, formatSize, strings, }: ValidateFileSelectionOptions): FileSelectionResult;
 export {};

package/dist/components/base/upload/image-upload.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import { type StringsProp } from '../../../lib/strings';
+import { type FieldControlAttributes } from '../../../lib/field-control-attributes';
 type ImageUploadAspectRatio = 'square' | 'standard' | 'widescreen' | 'portrait';
 type ImageUploadLayout = 'stacked' | 'inline';
 type ImageUploadFit = 'cover' | 'contain';
@@ -28,7 +29,7 @@ export interface ImageUploadStrings {
     moreFiles: (count: number) => string;
 }
 export declare const defaultImageUploadStrings: ImageUploadStrings;
-export interface ImageUploadProps {
+export interface ImageUploadProps extends FieldControlAttributes {
     /** Accepted MIME types or extensions, as the native `accept` attribute. */
     accept?: string;
     /** Allows more than one file to be chosen. */
@@ -52,6 +53,8 @@ export interface ImageUploadProps {
     invalid?: boolean;
     /** Override default strings (button labels, helper text, supports template). */
     strings?: StringsProp<ImageUploadStrings>;
+    /** Additional classes merged onto the control root. */
+    className?: string;
 }
 declare const ImageUpload: React.ForwardRefExoticComponent<ImageUploadProps & React.RefAttributes<HTMLInputElement>>;
 export { ImageUpload };

package/dist/components/base/upload/index.d.ts

@@ -7,20 +7,14 @@
  *
  * `FileUpload` is the form-shaped control for local `File` values. `Dropzone`
  * is the bare drop target it composes, `ImageUpload` / `AvatarUpload` add
- * image previews. Transfer-state surfaces and ordered media editing now have
- * canonical `base/upload-queue` and `base/media-gallery` entrypoints; their
- * 1.x compatibility exports remain below.
+ * image previews. Transfer-state surfaces live in `base/upload-queue` and
+ * ordered media editing in `base/media-gallery`.
  *
  * `useFileDropTarget` and `FilePickerInput` stay internal — they are the
  * shared drag/keyboard plumbing behind the public controls, not an API.
  */
 export { Dropzone, defaultDropzoneStrings, type DropzoneProps, type DropzoneInputProps, type DropzoneStrings, type DropzoneSize, } from './dropzone';
 export { FileUpload, defaultFileUploadStrings, type FileUploadProps, type FileUploadCommonProps, type FileUploadRejection, type FileUploadRejectionCode, type FileUploadSelectionMode, type FileUploadStrings, type FileUploadValidator, type MultipleFileUploadProps, type SingleFileUploadProps, } from './file-upload';
+export { matchesFileAccept, validateFiles, type FileValidationRejection, type FileValidationResult, type FileValidationRules, } from './file-upload.validation';
 export { ImageUpload, defaultImageUploadStrings, type ImageUploadProps, type ImageUploadStrings, } from './image-upload';
 export { AvatarUpload, defaultAvatarUploadStrings, type AvatarUploadProps, type AvatarUploadStrings, type AvatarUploadSize, } from './avatar-upload';
-/** @deprecated Import from `themelia-react-ui/base/media-gallery`. Kept through 1.x. */
-export { MediaGallery, defaultMediaGalleryStrings, type MediaGalleryProps, type MediaGalleryStrings, } from '../media-gallery';
-/** @deprecated Import from `themelia-react-ui/base/upload-queue`. Kept through 1.x. */
-export { UploadProgressList, defaultUploadProgressListStrings, type UploadProgressListProps, type UploadProgressListStrings, type UploadItem, type UploadStatus, } from '../upload-queue';
-/** @deprecated Import from `themelia-react-ui/base/upload-queue`. Kept through 1.x. */
-export { UploadTray, defaultUploadTrayStrings, type UploadTrayProps, type UploadTrayStrings, } from '../upload-queue';

package/dist/components/base/value-inputs/date-time-input.d.ts

@@ -2,6 +2,8 @@ import type { DatePickerBaseProps } from '../date-pickers/datepicker.types';
 export interface DateTimeInputProps extends Pick<DatePickerBaseProps, 'triggerRef' | 'onBlur' | 'aria-describedby' | 'aria-invalid'> {
     /** Controlled value (ISO string) */
     value?: string;
+    /** Initial value (ISO string) while uncontrolled. */
+    defaultValue?: string;
     /** Change handler */
     onValueChange?: (value: string | undefined) => void;
     /** Placeholder text */
@@ -18,5 +20,7 @@ export interface DateTimeInputProps extends Pick<DatePickerBaseProps, 'triggerRe
     disabled?: boolean;
     /** Id of the trigger, so an external `<FormField label>` names it. Defaults to a generated id. */
     id?: string;
+    /** Additional classes merged onto the picker root. */
+    className?: string;
 }
 export declare const DateTimeInput: import("react").ForwardRefExoticComponent<DateTimeInputProps & import("react").RefAttributes<HTMLDivElement>>;