themelia-react-ui 2.0.5 → 3.0.0

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

@@ -21,6 +21,10 @@ export interface ChoiceOptionBase<TValue extends string = string> {
     disabled?: boolean;
 }
 export interface ChoiceGroupBaseProps {
+    /** Accessible name when no visible label is associated with the group. */
+    'aria-label'?: string;
+    /** Id of a visible label that names the group. */
+    'aria-labelledby'?: string;
     /** Supporting/error descriptions associated with the group. */
     'aria-describedby'?: string;
     /** Form field name (also used for hidden inputs and aria grouping). */

package/dist/components/base/choice-inputs/pill-radio-group.d.ts

@@ -16,14 +16,15 @@ import * as React from 'react';
 import { type ChoiceGroupBaseProps, type ChoiceOptionBase } from './choice-types';
 export interface PillRadioGroupOption extends ChoiceOptionBase {
 }
-export interface PillRadioGroupProps extends Omit<ChoiceGroupBaseProps, 'name'> {
-    /** Form field name, forwarded for native submits. */
-    name: string;
-    /** Current value. Controlled. */
-    value: string | null | undefined;
+export interface PillRadioGroupProps extends ChoiceGroupBaseProps {
+    /** Controlled selection. An explicit null or undefined clears the selection. */
+    value?: string | null | undefined;
+    /** Initial selection when value is omitted. */
+    defaultValue?: string;
     /** Choices offered. */
     options: PillRadioGroupOption[];
-    onValueChange: (value: string | null) => void;
+    /** Reports a selection or null when cleared. */
+    onValueChange?: (value: string | null) => void;
     /** Allow deselecting (click active pill to clear). Default false. */
     allowClear?: boolean;
     /** Stretch pills to fill the container. */

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/combobox/combobox-field.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import { type FormControlSize } from '../../../lib/ui-provider';
-interface ComboboxInputFieldProps {
+interface ComboboxInputFieldProps extends Pick<React.ComponentPropsWithRef<'input'>, 'id' | 'ref' | 'aria-label' | 'aria-labelledby' | 'aria-describedby' | 'aria-invalid' | 'aria-required'> {
     placeholder: string;
     clearLabel: string;
     toggleLabel: string;
@@ -12,5 +12,5 @@ interface ComboboxInputFieldProps {
     className?: string;
     onBlur?: () => void;
 }
-export declare function ComboboxInputField({ placeholder, clearLabel, toggleLabel, size, error, required, disabled, clearable, className, onBlur, }: ComboboxInputFieldProps): React.ReactElement;
+export declare function ComboboxInputField({ placeholder, clearLabel, toggleLabel, size, error, required, disabled, clearable, className, onBlur, 'aria-invalid': ariaInvalid, 'aria-required': ariaRequired, ...association }: ComboboxInputFieldProps): React.ReactElement;
 export {};

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/date-picker-internals.d.ts

@@ -1,5 +1,7 @@
 import { type ButtonTone, type ButtonStyle } from '../buttons';
-import type { DatePickerProps, SingleDatePickerProps, MultipleDatePickerProps, RangeDatePickerProps, DatePickerStrings, PresetDateRange } from './datepicker.types';
+import type { DatePickerProps, DatePickerBaseProps, SingleDatePickerProps, MultipleDatePickerProps, RangeDatePickerProps, DatePickerStrings, PresetDateRange } from './datepicker.types';
+/** Per-mount visibility; a provider never owns an individual picker's open state. */
+export declare function usePickerOpenState({ open, defaultOpen, onOpenChange, disabled }: Pick<DatePickerBaseProps, 'open' | 'defaultOpen' | 'onOpenChange' | 'disabled'>): readonly [boolean, (next: boolean) => void];
 export declare function resolvePickerButtonProps(tone?: ButtonTone, buttonStyle?: ButtonStyle): {
     tone: ButtonTone;
     buttonStyle: ButtonStyle;

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

@@ -1,6 +1,6 @@
 import type { AriaAttributes, FocusEventHandler, Ref } from 'react';
 import type { LucideIcon } from 'lucide-react';
-import type { DateRange, PropsSingle, PropsRange, PropsMulti, Locale } from 'react-day-picker';
+import type { DateRange, PropsBase, PropsSingle, PropsRange, PropsMulti, Locale } from 'react-day-picker';
 import type { FormControlSize } from '../../../lib/ui-provider';
 import type { StringsProp } from '../../../lib/strings';
 import type { ActionPresentation } from '../../../lib/action-presentation';
@@ -66,6 +66,12 @@ export interface DatePickerStrings {
     year: string;
 }
 export interface DatePickerBaseProps {
+    /** Controlled popup visibility. Explicit values take precedence over defaultOpen. */
+    open?: boolean;
+    /** Initial popup visibility when uncontrolled. Defaults to false. */
+    defaultOpen?: boolean;
+    /** Reports trigger, dismissal and selection requests without changing a controlled value. */
+    onOpenChange?: (open: boolean) => void;
     /** Trigger ref for focus and form adapters; the forwarded ref remains the field root. */
     triggerRef?: Ref<HTMLButtonElement>;
     /** Native trigger blur callback. */
@@ -114,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;
@@ -201,7 +205,7 @@ export interface SingleDatePickerProps extends DatePickerBaseProps {
     /** Dates to disable, as a list or a predicate. */
     disabledDates?: Date[] | ((date: Date) => boolean);
     /** Escape hatch forwarded to the underlying react-day-picker calendar. */
-    calendarProps?: Omit<PropsSingle, 'mode' | 'selected' | 'onSelect'> & {
+    calendarProps?: Omit<PropsBase & PropsSingle, 'mode' | 'selected' | 'onSelect'> & {
         className?: string;
     };
 }
@@ -231,7 +235,7 @@ export interface MultipleDatePickerProps extends DatePickerBaseProps {
     /** Dates to disable, as a list or a predicate. */
     disabledDates?: Date[] | ((date: Date) => boolean);
     /** Escape hatch forwarded to the underlying react-day-picker calendar. */
-    calendarProps?: Omit<PropsMulti, 'mode' | 'selected' | 'onSelect'> & {
+    calendarProps?: Omit<PropsBase & PropsMulti, 'mode' | 'selected' | 'onSelect'> & {
         className?: string;
     };
 }
@@ -265,7 +269,7 @@ export interface RangeDatePickerProps extends DatePickerBaseProps {
     /** Dates to disable, as a list or a predicate. */
     disabledDates?: Date[] | ((date: Date) => boolean);
     /** Escape hatch forwarded to the underlying react-day-picker calendar. */
-    calendarProps?: Omit<PropsRange, 'mode' | 'selected' | 'onSelect'> & {
+    calendarProps?: Omit<PropsBase & PropsRange, 'mode' | 'selected' | 'onSelect'> & {
         className?: string;
     };
 }

package/dist/components/base/date-pickers/time-picker.d.ts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import { type FieldControlAttributes } from '../../../lib/field-control-attributes';
 import { type StringsProp } from '../../../lib/strings';
 import { type FormControlSize } from '../../../lib/ui-provider';
 export interface TimePickerStrings {
@@ -16,13 +17,14 @@ export interface TimePickerStrings {
     pm: string;
 }
 export declare const defaultTimePickerStrings: TimePickerStrings;
-export interface TimePickerProps {
+export interface TimePickerProps extends FieldControlAttributes, Pick<React.AriaAttributes, 'aria-required'> {
     /**
      * Selected time as `'HH:mm'` or `'HH:mm:ss'`, always on a 24-hour clock
-     * regardless of `format`. Controlled. `null` or omitted leaves every
-     * segment blank.
+     * regardless of `format`. A controlled `null` leaves every segment blank.
      */
     value?: string | null;
+    /** Initial time when uncontrolled, in the same format as value. */
+    defaultValue?: string | null;
     /**
      * Fired with the next time in the same shape as `value` — `'HH:mm'` when
      * `precision` is `'minutes'`, `'HH:mm:ss'` when it is `'seconds'`. Fires
@@ -31,11 +33,23 @@ export interface TimePickerProps {
      * showing exactly what was typed until blur snaps them to that value.
      */
     onValueChange?: (value: string | null) => void;
+    /** Native form name. The submitted value uses a 24-hour clock. */
+    name?: string;
+    /** Requires a selected time when the browser validates the form. */
+    required?: boolean;
+    /** Runs when focus leaves the segments, trigger and popup. */
+    onBlur?: React.FocusEventHandler<HTMLElement>;
     /**
      * `'inline'` renders the segments directly; `'popover'` puts them behind a
      * field-shaped trigger showing the formatted time. Default: `'inline'`.
      */
     mode?: 'inline' | 'popover';
+    /** Controlled visibility in popover mode. */
+    open?: boolean;
+    /** Initial visibility in uncontrolled popover mode. */
+    defaultOpen?: boolean;
+    /** Reports requests to open or close the popup. */
+    onOpenChange?: (open: boolean) => void;
     /** Clock convention. `'12'` adds the AM/PM segment. Default: `'24'`. */
     format?: '12' | '24';
     /** Finest segment offered. Default: `'minutes'`. */

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/feedback/state-display.d.ts

@@ -1,4 +1,7 @@
 import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
+import { type StringsProp } from '../../../lib/strings';
+import { type ErrorStateStrings } from './state-display.strings';
+export { defaultErrorStateStrings, type ErrorStateStrings } from './state-display.strings';
 type DivProps = ComponentPropsWithoutRef<'div'>;
 type StateDisplayVariant = 'inline' | 'panel';
 export type LoadingStateVariant = StateDisplayVariant;
@@ -21,6 +24,8 @@ export interface LoadingStateProps extends DivProps {
 export declare const LoadingState: import("react").ForwardRefExoticComponent<LoadingStateProps & import("react").RefAttributes<HTMLDivElement>>;
 export type ErrorStateVariant = StateDisplayVariant;
 export interface ErrorStateProps extends Omit<DivProps, 'title'> {
+    /** Default error copy. Explicit title, description and retryLabel props win. */
+    strings?: StringsProp<ErrorStateStrings>;
     /** Heading above the description. */
     title?: ReactNode;
     /** Supporting copy under the label. */
@@ -37,4 +42,3 @@ export interface ErrorStateProps extends Omit<DivProps, 'title'> {
     icon?: ReactNode;
 }
 export declare const ErrorState: import("react").ForwardRefExoticComponent<ErrorStateProps & import("react").RefAttributes<HTMLDivElement>>;
-export {};

package/dist/components/base/feedback/state-display.strings.d.ts

@@ -0,0 +1,9 @@
+export interface ErrorStateStrings {
+    /** Default heading when no error-specific title was supplied. */
+    title: string;
+    /** Default guidance when no error-specific description was supplied. */
+    description: string;
+    /** Label of the recovery action when `onRetry` is supplied. */
+    retry: string;
+}
+export declare const defaultErrorStateStrings: ErrorStateStrings;

package/dist/components/base/forms/form-field.d.ts

@@ -8,7 +8,7 @@
 import * as React from 'react';
 import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
 export interface FieldChromeProps {
-    /** Caption rendered above the control, associated through `htmlFor`. */
+    /** Caption rendered above the control. Supplies a default accessible name to direct controls while preserving explicit names and native `htmlFor` association. */
     label?: ReactNode;
     /** Marks the field required and renders the required indicator by the label. */
     required?: boolean;
@@ -33,7 +33,12 @@ export interface FieldChromeProps {
 }
 export interface FormFieldProps extends FieldChromeProps, Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
     children: ReactNode;
-    /** Native ID of the labelled control. With compound children, assign it to the nested control; passive wrappers are left untouched. Direct controls receive an automatic ID when omitted. */
+    /**
+     * Native ID of the labelled control. Direct controls receive it when omitted.
+     * A matching ID in declared descendants leaves the outer child untouched.
+     * For a custom compound that creates unseen controls internally, use a passive
+     * host and assign this ID to its nested control; component bodies are not inspected.
+     */
     htmlFor?: string;
     /** ID for the resolved hint, helper, or error; controls can reference it explicitly. */
     supportingTextId?: 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/coordinates-input.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { type StringsProp } from '../../../lib/strings';
 import type { FormControlSize } from '../../../lib/ui-provider';
+import type { NumericCompositeFieldProps } from './numeric-composite-field';
 export interface CoordinatesObjectValue {
     lat?: string;
     lng?: string;
@@ -23,7 +24,9 @@ export interface CoordinatesInputStrings {
     lngAccessibleLabel: string;
 }
 export declare const defaultCoordinatesInputStrings: CoordinatesInputStrings;
-export interface CoordinatesInputProps {
+export interface CoordinatesInputProps extends NumericCompositeFieldProps<CoordinatesValue> {
+    /** Native form name. Submits latitude and longitude separated by a comma, or an empty string. */
+    name?: string;
     /** Controlled value */
     value?: CoordinatesValue;
     /** Default value for uncontrolled mode */

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

@@ -32,9 +32,9 @@ export declare const defaultDecimalInputStrings: DecimalInputStrings;
 export interface DecimalInputProps extends Omit<InputProps, 'type' | 'inputMode' | 'strings'> {
     /** Maximum fractional digits accepted and used during normalization. */
     decimalPlaces?: number;
-    /** Minimum accepted numeric value. */
+    /** Minimum used when normalising on blur or stepping. */
     min?: number;
-    /** Maximum accepted numeric value. */
+    /** Maximum used when normalising on blur or stepping. Also limits unsigned text while typing. */
     max?: number;
     /** Whether a leading negative sign is accepted. */
     allowNegative?: boolean;

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

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { type StringsProp } from '../../../lib/strings';
 import { type FormControlSize } from '../../../lib/ui-provider';
+import type { NumericCompositeFieldProps } from './numeric-composite-field';
 export interface DimensionObject {
     width?: string;
     height?: string;
@@ -9,16 +10,26 @@ 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;
 }
 export declare const defaultDimensionsInputStrings: DimensionsInputStrings;
-export interface DimensionsInputProps {
+export interface DimensionsInputProps extends NumericCompositeFieldProps<DimensionValue> {
+    /** Native form name. Submits width, height and depth joined by x, or an empty string. */
+    name?: string;
     /** Current value (string "WxHxD" or object { width, height, depth }) */
     value?: DimensionValue;
     /** Default value for uncontrolled mode */
@@ -29,22 +40,6 @@ export interface DimensionsInputProps {
     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 */
@@ -73,7 +68,7 @@ export interface DimensionsInputProps {
     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/forms-numeric/numeric-composite-field.d.ts

@@ -0,0 +1,12 @@
+import type { AriaAttributes, FocusEventHandler } from 'react';
+import type { FieldControlAttributes } from '../../../lib/field-control-attributes';
+export interface NumericCompositeFieldProps<T> extends FieldControlAttributes, Pick<AriaAttributes, 'aria-required'> {
+    /** Reports the same value as the event-shaped change callback. */
+    onValueChange?: (value: T) => void;
+    /** Runs when focus leaves the field and its unit picker. */
+    onBlur?: FocusEventHandler<HTMLDivElement>;
+    /** Requires each numeric part when the browser validates the form. */
+    required?: boolean;
+    /** Shows the value and units without allowing edits. */
+    readOnly?: boolean;
+}

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

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { type StringsProp } from '../../../lib/strings';
 import { type FormControlSize } from '../../../lib/ui-provider';
+import type { NumericCompositeFieldProps } from './numeric-composite-field';
 export type WeightUnit = 'g' | 'kg' | 'lb' | 'oz';
 export interface WeightInputStrings {
     /** Above-field label for the unit selector. Empty string hides it. */
@@ -11,7 +12,11 @@ export interface WeightInputStrings {
     unitPlaceholder: string;
 }
 export declare const defaultWeightInputStrings: WeightInputStrings;
-export interface WeightInputProps {
+export interface WeightInputProps extends NumericCompositeFieldProps<string> {
+    /** ID of the numeric value field. */
+    id?: string;
+    /** Native form name for the numeric value. Units remain separate. */
+    name?: string;
     /** Controlled value */
     value?: string;
     /** Default value for uncontrolled mode */

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';