themelia-react-ui 2.0.6 → 3.0.0

package/dist/components/base/choice-inputs/switch.d.ts

@@ -22,7 +22,7 @@ export interface SwitchProps extends Omit<BaseSwitchProps, 'onCheckedChange' | '
     required?: boolean;
     /** Hidden input name used during native form submission. */
     name?: string;
-    /** Hidden input value submitted while checked. */
+    /** Hidden input value submitted while checked: the form value, not the boolean state. */
     value?: string;
     /** Optional value submitted while unchecked. */
     uncheckedValue?: string;

package/dist/components/base/code-block/use-code-copy.d.ts

@@ -1,6 +1,2 @@
-/** Clipboard lifecycle for code display; callbacks and text stay per mount. */
-export declare function useCodeCopy(source: string, onCopyError?: (error: unknown) => void): {
-    copied: boolean;
-    failed: boolean;
-    copy: (text: string) => Promise<boolean>;
-};
+/** Clipboard lifecycle for code display; the shared hook owns it. */
+export declare function useCodeCopy(source: string, onCopyError?: (error: unknown) => void): import("../../../lib/use-copy-feedback").CopyFeedback;

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

@@ -31,7 +31,7 @@ declare namespace Command {
 }
 type CommandListProps = React.ComponentProps<typeof CommandListPrimitive>;
 type CommandInputProps = React.ComponentProps<typeof CommandInputPrimitive>;
-declare function CommandInput({ className, asChild, children, ...props }: CommandInputProps): React.JSX.Element;
+declare function CommandInput({ className, render, ...props }: CommandInputProps): React.JSX.Element;
 declare namespace CommandInput {
     var displayName: string;
 }

package/dist/components/base/date-pickers/datepicker.types.d.ts

@@ -120,9 +120,7 @@ export interface DatePickerBaseProps {
     footer?: DatePickerFooterConfig;
     /** Set when rendering inside a modal or drawer, to avoid competing focus traps. */
     modal?: boolean;
-    /** Shorthand that turns on the year dropdown (sets `captionLayout="dropdown"`). */
-    enableYearDropdown?: boolean;
-    /** Fine-grained year-navigation config. Takes precedence over `enableYearDropdown`. */
+    /** Year navigation. `{ enabled: true }` swaps the caption for month and year dropdowns; `fromYear`/`toYear` bound them. */
     yearSelection?: YearSelectionConfig;
     /** Visible calendar months. Defaults to one below 768px and two on wider surfaces. */
     numberOfMonths?: number;

package/dist/components/base/display/dialog.d.ts

@@ -12,9 +12,7 @@ import type { TextGap } from '../structure';
 import * as React from 'react';
 import { Dialog as DialogPrimitive, DialogOverlay, DialogPortal } from '../../ui/dialog';
 export declare const Dialog: typeof DialogPrimitive;
-export declare const DialogTrigger: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").DialogTrigger.Props<unknown> & {
-    asChild?: boolean;
-}, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const DialogTrigger: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").DialogTrigger.Props<unknown>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 export declare const DialogClose: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogCloseProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 export declare const DialogContent: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogPopupProps & {
     showCloseButton?: boolean;
@@ -29,10 +27,6 @@ export declare const DialogBody: React.ForwardRefExoticComponent<React.HTMLAttri
 export declare const DialogFooter: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement> & {
     showCloseButton?: boolean;
 }, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export declare const DialogTitle: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogTitleProps & {
-    asChild?: boolean;
-}, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
-export declare const DialogDescription: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogDescriptionProps & {
-    asChild?: boolean;
-}, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+export declare const DialogTitle: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogTitleProps, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+export declare const DialogDescription: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogDescriptionProps, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
 export { DialogOverlay, DialogPortal };

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

@@ -3,7 +3,7 @@
  * other content without being content themselves.
  *
  * Separators and scroll areas bound a region; collapsibles reveal one;
- * headed content uses Card from base/cards; ContentBlock is a migration adapter;
+ * headed content uses Card from base/cards;
  * tooltips, icon badges, boolean indicators and date blocks annotate a value in
  * place; `VisuallyHidden` and `PlaceholderPattern` handle the two edges —
  * present to assistive technology only, and present but deliberately blank.
@@ -23,8 +23,7 @@ export { PlaceholderPattern, type PlaceholderPatternProps } from './placeholder-
 export { VisuallyHidden, type VisuallyHiddenProps } from './visually-hidden';
 export { DateBlock, defaultDateBlockStrings, type DateBlockProps, type DateBlockStrings, type DateBlockLayout, type DateBlockSize, type DateBlockTimePlacement, type DateBlockTone, type DateBlockVariant, } from './date-block';
 export * from './collapsible';
-export * from './content-block';
-export { BooleanIndicator, type BooleanIndicatorProps } from './boolean-indicator';
+export { BooleanIndicator, defaultBooleanIndicatorStrings, type BooleanIndicatorProps, type BooleanIndicatorStrings, } from './boolean-indicator';
 export * from './scroll-area';
 export * from './separator';
 export * from './tooltip';

package/dist/components/base/display/separator.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import { Separator as PrimitiveSeparator } from '../../ui/separator';
-export interface SeparatorProps extends React.ComponentPropsWithoutRef<typeof PrimitiveSeparator> {
+export interface SeparatorProps extends React.ComponentProps<typeof PrimitiveSeparator> {
     /** Render the rule as a dashed line instead of a solid border fill. */
     dashed?: boolean;
 }

package/dist/components/base/feedback/alert.d.ts

@@ -6,6 +6,7 @@
  */
 import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
+import type { StrictVariantProps } from '../../../lib/variant-props';
 import type { SemanticTone } from '../../../lib/component-vocabulary';
 declare const alertVariants: (props?: ({
     tone?: "neutral" | "primary" | "secondary" | "info" | "success" | "warning" | "destructive" | null | undefined;
@@ -13,7 +14,7 @@ declare const alertVariants: (props?: ({
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type AlertVariant = NonNullable<VariantProps<typeof alertVariants>['variant']>;
 export type AlertTone = SemanticTone;
-export interface AlertProps extends ComponentPropsWithoutRef<'div'>, VariantProps<typeof alertVariants> {
+export interface AlertProps extends ComponentPropsWithoutRef<'div'>, StrictVariantProps<typeof alertVariants> {
 }
 declare const Alert: import("react").ForwardRefExoticComponent<AlertProps & import("react").RefAttributes<HTMLDivElement>>;
 declare const AlertTitle: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/base/feedback/empty.d.ts

@@ -7,7 +7,15 @@
  */
 import type { ComponentProps } from 'react';
 import { Empty as EmptyPrimitive, EmptyContent as EmptyContentPrimitive, EmptyDescription as EmptyDescriptionPrimitive, EmptyHeader as EmptyHeaderPrimitive, EmptyMedia as EmptyMediaPrimitive, EmptyTitle as EmptyTitlePrimitive } from '../../ui/empty';
-export type EmptyProps = ComponentProps<typeof EmptyPrimitive>;
+import { emptySurfaceRecipes } from '../../../lib/surface-recipes';
+export type EmptySurface = keyof typeof emptySurfaceRecipes;
+export type EmptyPadding = 'none' | 'sm' | 'md' | 'lg';
+export interface EmptyProps extends ComponentProps<typeof EmptyPrimitive> {
+    /** `wash` draws the shared quiet well (neutral wash, dashed edge) for a region with no data yet. Defaults to `plain`. */
+    surface?: EmptySurface;
+    /** Surface inset. `none` sits flush inside a boundary that already owns the padding. Defaults to `md`. */
+    padding?: EmptyPadding;
+}
 export type EmptyContentProps = ComponentProps<typeof EmptyContentPrimitive>;
 export type EmptyDescriptionProps = ComponentProps<typeof EmptyDescriptionPrimitive>;
 export type EmptyHeaderProps = ComponentProps<typeof EmptyHeaderPrimitive>;
@@ -17,7 +25,7 @@ export interface EmptyTitleProps extends ComponentProps<typeof EmptyTitlePrimiti
     headingLevel?: 2 | 3 | 4 | 5 | 6;
 }
 /** Root layout for a consumer-blocks empty state. */
-export declare function Empty({ className, ...props }: EmptyProps): import("react").JSX.Element;
+export declare function Empty({ className, surface, padding, ...props }: EmptyProps): import("react").JSX.Element;
 export declare namespace Empty {
     var displayName: string;
 }

package/dist/components/base/forms/workflow.d.ts

@@ -2,7 +2,7 @@
 import type { ReactNode } from 'react';
 import type { ButtonProps } from '../buttons';
 import { type CardProps } from '../cards';
-import type { SmartCardSurface } from '../cards';
+import type { CardSurface } from '../cards';
 import type { AlertTone } from '../feedback';
 export interface FormSectionProps {
     /** Section title. */
@@ -15,7 +15,7 @@ export interface FormSectionProps {
     /** Content below the section body. */
     footer?: ReactNode;
     /** Outer chrome. Use `flat` with `padding="none"` inside a padded Card. */
-    surface?: SmartCardSurface;
+    surface?: CardSurface;
     /** Card region insets. Defaults to Card's ordinary inset; use `none` when the parent already owns padding. */
     padding?: CardProps['padding'];
     /**

package/dist/components/base/forms-numeric/dimensions-input.d.ts

@@ -10,10 +10,18 @@ export interface DimensionObject {
 export type DimensionValue = string | DimensionObject;
 export type DimensionUnit = 'mm' | 'cm' | 'm' | 'in' | 'ft' | 'px';
 export interface DimensionsInputStrings {
+    /** Width sub-label and accessible name. */
     width: string;
+    /** Height sub-label and accessible name. */
     height: string;
+    /** Depth sub-label and accessible name. */
     depth: string;
+    /** Accessible name of the unit selector, and its placeholder unless `unitPlaceholder` is set. */
     unit: string;
+    /** Visible unit sub-label in the vertical layout. Empty hides it. */
+    unitLabel: string;
+    /** Placeholder of the unit selector. Empty falls back to `unit`. */
+    unitPlaceholder: string;
     widthPlaceholder: string;
     heightPlaceholder: string;
     depthPlaceholder: string;
@@ -32,22 +40,6 @@ export interface DimensionsInputProps extends NumericCompositeFieldProps<Dimensi
     unit?: DimensionUnit;
     /** Default length unit for uncontrolled mode. */
     defaultUnit?: DimensionUnit;
-    /** Label for width input (sub-label) */
-    widthLabel?: string;
-    /** Label for height input (sub-label) */
-    heightLabel?: string;
-    /** Label for depth/length input (sub-label) */
-    depthLabel?: string;
-    /** Label for unit selector (sub-label) */
-    unitLabel?: string;
-    /** Placeholder for the unit select */
-    unitPlaceholder?: string;
-    /** Placeholder for width */
-    widthPlaceholder?: string;
-    /** Placeholder for height */
-    heightPlaceholder?: string;
-    /** Placeholder for depth */
-    depthPlaceholder?: string;
     /** Form control size — flows through `useDensityConfig().defaultScale`. */
     size?: FormControlSize;
     /** Callback when value changes */
@@ -76,7 +68,7 @@ export interface DimensionsInputProps extends NumericCompositeFieldProps<Dimensi
     disabled?: boolean;
     /** Additional CSS classes */
     className?: string;
-    /** String overrides merged over defaults. Direct props (e.g. `widthLabel`) win over `strings` keys. */
+    /** Sub-labels, accessible names and placeholders, merged over the defaults. */
     strings?: StringsProp<DimensionsInputStrings>;
 }
 export declare const DimensionsInput: React.ForwardRefExoticComponent<DimensionsInputProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/base/forms-numeric/index.d.ts

@@ -11,11 +11,11 @@
  * lower-level split-state control it is built on; reach for it only when the
  * call site deliberately stores amount and currency in separate channels.
  */
-export { DecimalInput, type DecimalInputProps } from './decimal-input';
+export { DecimalInput, defaultDecimalInputStrings, type DecimalInputProps, type DecimalInputStrings, type DecimalRoundingMode, } from './decimal-input';
 export { PercentageInput, type PercentageInputProps } from './percentage-input';
 export { CurrencyInput, defaultCurrencyInputStrings, type CurrencyInputProps, type CurrencyInputStrings, type CurrencyOption, } from './currency-input';
 export { MoneyInput, defaultMoneyInputStrings, type MoneyInputProps, type MoneyInputData, type MoneyInputContext, type MoneyInputStrings, } from './money-input';
 export { RoundingModeSelect, type RoundingModeSelectProps } from './rounding-mode-select';
-export { DimensionsInput, type DimensionsInputProps, type DimensionValue, type DimensionObject, type DimensionUnit, } from './dimensions-input';
+export { DimensionsInput, defaultDimensionsInputStrings, type DimensionsInputProps, type DimensionsInputStrings, type DimensionValue, type DimensionObject, type DimensionUnit, } from './dimensions-input';
 export { WeightInput, defaultWeightInputStrings, type WeightInputProps, type WeightInputStrings, type WeightUnit, } from './weight-input';
-export { CoordinatesInput, type CoordinatesInputProps, type CoordinatesValue, type CoordinatesObjectValue, } from './coordinates-input';
+export { CoordinatesInput, defaultCoordinatesInputStrings, type CoordinatesInputProps, type CoordinatesInputStrings, type CoordinatesValue, type CoordinatesObjectValue, } from './coordinates-input';

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

@@ -12,7 +12,7 @@ import type { ComponentProps, ReactElement, ReactNode } from 'react';
 import type { ItemSize, ItemVariant } from '../../../lib/ui-provider';
 export type { ItemSize, ItemVariant };
 export type ItemMediaVariant = 'default' | 'icon' | 'image' | 'avatar';
-export type ItemPadding = 'none' | 'default';
+export type ItemPadding = 'none' | 'default' | 'bleed';
 export type ItemDensity = RowDensity;
 export interface ItemBaseProps extends Omit<ComponentProps<'div'>, 'children'> {
     children?: ReactNode;
@@ -24,7 +24,11 @@ export interface ItemSharedProps extends Omit<ItemBaseProps, 'children' | 'title
     size?: ItemSize;
     /** Vertical row rhythm only; preserves size, primary text and inline padding. Defaults to default. */
     density?: ItemDensity;
-    /** Horizontal row padding. Defaults to `none`. */
+    /**
+     * Horizontal row padding. Defaults to `none`. `bleed` is for a clickable row
+     * inside a padded surface: the row keeps its inset and pulls it back out, so
+     * its content stays on the surface edge while the shared row hover fill has room.
+     */
     padding?: ItemPadding;
     /** Title/supporting-copy rhythm in convenience mode. Defaults to dense. Compound mode uses ItemContent. */
     textGap?: TextGap;

package/dist/components/base/metadata-list/index.d.ts

@@ -2,9 +2,7 @@
  * metadata-list — label/value facts about one entity.
  *
  * A base structure: it composes typography, primitives and base display parts,
- * and any surface (Card, panel, drawer or block) places it. Previously
- * published from `themelia-react-ui/blocks/data-display`, which re-exports it
- * as a deprecated compatibility path.
+ * and any surface (Card, panel, drawer or block) places it.
  */
 export { MetadataList, defaultMetadataListStrings } from './metadata-list';
 export type { MetadataDensity, MetadataInlineListItem, MetadataLayout, MetadataListItem, MetadataListProps, MetadataListStrings, } from './metadata-list';

package/dist/components/base/metadata-list/metadata-list.d.ts

@@ -24,12 +24,15 @@ export type MetadataListItem = {
     emptyLabel?: React.ReactNode;
     /** Takes over the value. The output sits in the value box, so it inherits the value's type role. */
     render?: (item: MetadataListItem) => React.ReactNode;
+    /** Grid layout only: `full` gives the item every column, for a note or address under paired facts. */
+    span?: 'full';
 };
 export type MetadataInlineListItem = Omit<MetadataListItem, 'description'> & {
     description?: never;
 };
 export type MetadataLayout = 'grid' | 'rows' | 'inline';
-export type MetadataDensity = 'default' | 'compact';
+/** The shared density vocabulary. `comfortable` is accepted for parity and keeps the default rhythm, which is already the roomy one. */
+export type MetadataDensity = 'default' | 'compact' | 'comfortable';
 type MetadataListSharedProps = {
     /** How many columns the grid layout uses. Accepts a per-breakpoint value. */
     columns?: ResponsiveValue<1 | 2 | 3 | 4>;

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

@@ -16,6 +16,6 @@ export { LanguageSwitcher, type LanguageSwitcherProps } from './language-switche
 export { NavigationTabs, defaultNavigationTabsStrings, type NavigationTabItem, type NavigationTabsProps, type NavigationTabsStrings, type NavigationTabsVariant, } from './navigation-tabs';
 export { Tabs, TabsContent, TabsList, TabsTrigger, type TabsListProps } from './tabs';
 export { defaultTabsScrollStrings, type TabsScrollStrings } from './tab-scroll-viewport';
-export { PageHeading, type PageHeadingProps, type PageHeadingBadge, type PageHeaderAction, type PageHeaderLinkRenderProps, type PageHeaderLinkRenderer, } from './page-header';
+export { PageHeading, defaultPageHeadingStrings, type PageHeadingProps, type PageHeadingStrings, type PageHeaderAction, type PageHeaderLinkRenderProps, type PageHeaderLinkRenderer, } from './page-header';
 export { OverflowTabBar, defaultOverflowTabBarStrings, type OverflowTabBarProps, type OverflowTabBarStrings, type OverflowTabItem, } from './overflow-tab-bar';
-export { PaginationPrimitive, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, defaultPaginationStrings, type PaginationContentProps, type PaginationEllipsisProps, type PaginationItemProps, type PaginationLinkProps, type PaginationNextProps, type PaginationPreviousProps, type PaginationProps, type PaginationStrings, } from './pagination';
+export { PaginationRoot, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, defaultPaginationStrings, type PaginationContentProps, type PaginationEllipsisProps, type PaginationItemProps, type PaginationLinkProps, type PaginationNextProps, type PaginationPreviousProps, type PaginationProps, type PaginationStrings, } from './pagination';

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

@@ -1,22 +1,23 @@
+import { type ComponentPropsWithoutRef, type Ref } from 'react';
 import type { LocaleOption } from '../../../types/locale.types';
 type LanguageSwitcherLocale = Omit<LocaleOption, 'active'> & {
     active?: boolean;
 };
-export interface LanguageSwitcherProps {
+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. Takes precedence over onSelect. */
+    /** 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;
+    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, value, onValueChange, 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;
 }

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

@@ -17,6 +17,8 @@ export declare const defaultKeyValueEditorStrings: KeyValueEditorStrings;
 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;
@@ -24,5 +26,7 @@ export interface KeyValueEditorProps extends FieldControlAttributes {
     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';