@motech-development/breeze-ui 2.4.0 → 3.0.1

package/dist/primitives/NumberField/NumberField.d.ts

@@ -0,0 +1,118 @@
+import type { ButtonHTMLAttributes, HTMLAttributes, InputHTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import type { ControlSize } from '../../internal/styling/visual';
+import { type TextFieldDescriptionProps, type TextFieldErrorProps, type TextFieldLabelProps } from '../TextField/TextField';
+type NumberFieldRootNativeProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'defaultValue' | 'onChange' | 'style'>;
+interface NumberFieldRootSharedProps extends NumberFieldRootNativeProps {
+    /** Compound label, group, input, stepper, description, and error parts. */
+    children: ReactNode;
+    /** Prevents editing, stepping, and focus. Defaults to `false`. */
+    disabled?: boolean;
+    /** Locale-aware number formatting options. */
+    formatOptions?: Intl.NumberFormatOptions;
+    /** Exposes invalid state to assistive technology and error styling. Defaults to `false`. */
+    invalid?: boolean;
+    /** Largest permitted value. */
+    max?: number;
+    /** Smallest permitted value. */
+    min?: number;
+    /** Marks the field as required for native validation and assistive technology. Defaults to `false`. */
+    required?: boolean;
+    /** Ref to the rendered field container. */
+    ref?: Ref<HTMLDivElement>;
+    /** Amount applied by stepper buttons and arrow keys. Defaults to `1`. */
+    step?: number;
+}
+interface ControlledNumberFieldRootProps {
+    /** Current number, or `null` for an empty input. */
+    value: number | null;
+    /** Called with the next number, or `null` when the input becomes empty. */
+    onChange: (value: number | null) => void;
+    defaultValue?: never;
+    readOnly?: false;
+}
+interface ReadOnlyNumberFieldRootProps {
+    /** Current immutable number, or `null` for an empty input. */
+    value: number | null;
+    /** Marks a controlled value as intentionally immutable. */
+    readOnly: true;
+    defaultValue?: never;
+    onChange?: never;
+}
+interface UncontrolledNumberFieldRootProps {
+    /** Initial number, or `null` for an empty input. */
+    defaultValue?: number | null;
+    /** Called with the next number, or `null` when the input becomes empty. */
+    onChange?: (value: number | null) => void;
+    readOnly?: false;
+    value?: never;
+}
+/** Props for controlled, read-only, or uncontrolled numeric field state. */
+export type NumberFieldRootProps = NumberFieldRootSharedProps & (ControlledNumberFieldRootProps | ReadOnlyNumberFieldRootProps | UncontrolledNumberFieldRootProps);
+/** Props for the visible numeric field label. */
+export type NumberFieldLabelProps = TextFieldLabelProps;
+/** Props for the numeric input and stepper layout group. */
+export interface NumberFieldGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'> {
+    /** Numeric input and stepper buttons. */
+    children: ReactNode;
+    /** Ref to the rendered group. */
+    ref?: Ref<HTMLDivElement>;
+}
+/** Props for the native locale-aware numeric input part. */
+export interface NumberFieldInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'children' | 'className' | 'defaultValue' | 'disabled' | 'max' | 'min' | 'onChange' | 'readOnly' | 'required' | 'size' | 'step' | 'style' | 'type' | 'value'> {
+    /** Placement and composition classes. */
+    className?: string;
+    /** Ref to the rendered input. */
+    ref?: Ref<HTMLInputElement>;
+    /** Canonical control size. Defaults to `md`. */
+    size?: ControlSize;
+}
+/** Props shared by numeric increment and decrement actions. */
+export interface NumberFieldStepButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onClick' | 'onClickCapture' | 'style' | 'type'> {
+    /** Accessible action name describing the step direction. */
+    'aria-label': string;
+    /** Visible stepper content. */
+    children: ReactNode;
+    /** Ref to the rendered stepper button. */
+    ref?: Ref<HTMLButtonElement>;
+    /** Canonical square control size. Defaults to `md`. */
+    size?: ControlSize;
+}
+/** Props for supporting text associated with the numeric input. */
+export type NumberFieldDescriptionProps = TextFieldDescriptionProps;
+/** Props for an accessible numeric validation message. */
+export type NumberFieldErrorProps = TextFieldErrorProps;
+/** Coordinates locale-aware numeric state, constraints, and compound anatomy. */
+export declare function Root({ children, className, defaultValue, disabled, formatOptions, invalid, max, min, onChange, readOnly, ref, required, step, value, ...props }: Readonly<NumberFieldRootProps>): ReactElement;
+/** Groups the NumberField input and stepper buttons as one interactive control. */
+export declare function Group({ className, ref, ...props }: Readonly<NumberFieldGroupProps>): ReactElement;
+/** Renders the editable locale-aware spinbutton for a NumberField. */
+export declare function Input({ className, ref, size, ...props }: Readonly<NumberFieldInputProps>): ReactElement;
+/** Decreases the NumberField value by its configured step. */
+export declare function DecrementButton({ 'aria-label': ariaLabel, children, ref, size, ...props }: Readonly<NumberFieldStepButtonProps>): ReactElement;
+/** Increases the NumberField value by its configured step. */
+export declare function IncrementButton({ 'aria-label': ariaLabel, children, ref, size, ...props }: Readonly<NumberFieldStepButtonProps>): ReactElement;
+/**
+ * Accessible compound locale-aware numeric-entry primitive.
+ *
+ * @summary locale-aware numeric entry with optional stepper controls
+ */
+export declare const NumberField: {
+    /** Decrement action. */
+    DecrementButton: typeof DecrementButton;
+    /** Supporting guidance associated with the numeric input. */
+    Description: typeof import("../TextField/TextField").Description;
+    /** Validation message associated with an invalid numeric input. */
+    Error: typeof import("../TextField/TextField").Error;
+    /** Numeric input and stepper layout group. */
+    Group: typeof Group;
+    /** Increment action. */
+    IncrementButton: typeof IncrementButton;
+    /** Locale-aware native spinbutton. */
+    Input: typeof Input;
+    /** Persistent accessible label. */
+    Label: typeof import("../TextField/TextField").Label;
+    /** State, constraints, and accessibility root. */
+    Root: typeof Root;
+};
+export {};
+//# sourceMappingURL=NumberField.d.ts.map

package/dist/primitives/NumberField/NumberField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberField.d.ts","sourceRoot":"","sources":["../../../src/primitives/NumberField/NumberField.tsx"],"names":[],"mappings":"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"}

package/dist/primitives/Popover/Popover.d.ts

@@ -0,0 +1,61 @@
+import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import { SharedOverlayClose, type SharedOverlayCloseProps, SharedOverlayDescription, type SharedOverlayDescriptionProps, SharedOverlayTitle, type SharedOverlayTitleProps, SharedOverlayTrigger, type SharedOverlayTriggerProps } from '../../internal/react-aria/OverlayParts';
+interface PopoverRootSharedProps {
+    /** Trigger and content. */ children: ReactNode;
+}
+interface ControlledPopoverRootProps {
+    /** Current open state. */ open: boolean;
+    /** Called with next open state. */ onOpenChange: (open: boolean) => void;
+    defaultOpen?: never;
+    readOnly?: false;
+}
+interface ReadOnlyPopoverRootProps {
+    /** Current immutable open state. */ open: boolean;
+    /** Marks controlled state immutable. */ readOnly: true;
+    defaultOpen?: never;
+    onOpenChange?: never;
+}
+interface UncontrolledPopoverRootProps {
+    /** Initial open state. */ defaultOpen?: boolean;
+    /** Called with next open state. */ onOpenChange?: (open: boolean) => void;
+    open?: never;
+    readOnly?: false;
+}
+/** Props for controlled, read-only, or uncontrolled popover state. */ export type PopoverRootProps = PopoverRootSharedProps & (ControlledPopoverRootProps | ReadOnlyPopoverRootProps | UncontrolledPopoverRootProps);
+/** Props for the popover trigger. */ export type PopoverTriggerProps = SharedOverlayTriggerProps;
+/** Props for positioned popover content. */ export interface PopoverContentProps extends Omit<HTMLAttributes<HTMLElement>, 'style'> {
+    /** Popover anatomy. */ children: ReactNode;
+    /** Allows outside pointer dismissal. Defaults to `true`. */ dismissible?: boolean;
+    /** Prevents Escape dismissal. */ keyboardDismissDisabled?: boolean;
+    /** Traps outside interaction when true. Defaults to `false`. */ modal?: boolean;
+    /** Gap from trigger. Defaults to `8`. */ offset?: number;
+    /** Logical placement. Defaults to `bottom start`. */ placement?: 'top' | 'bottom' | 'left' | 'right' | 'top start' | 'top end' | 'bottom start' | 'bottom end';
+    /** Ref to rendered dialog surface. */ ref?: Ref<HTMLElement>;
+}
+/** Props for required popover title. */ export type PopoverTitleProps = SharedOverlayTitleProps;
+/** Props for required popover description. */ export type PopoverDescriptionProps = SharedOverlayDescriptionProps;
+/** Props for semantic popover close action. */ export type PopoverCloseProps = SharedOverlayCloseProps;
+/** Coordinates non-modal contextual content anchored to a trigger. */
+export declare function Root({ defaultOpen, onOpenChange, open, readOnly: _readOnly, ...props }: Readonly<PopoverRootProps>): ReactElement;
+export declare function Content({ children, className, dismissible, keyboardDismissDisabled, modal, offset, placement, ref, ...props }: Readonly<PopoverContentProps>): ReactElement;
+/**
+ * Accessible compound positioned popover primitive.
+ *
+ * @summary contextual modal or nonmodal dialog anchored to a trigger
+ */
+export declare const Popover: {
+    /** Semantic action that closes the popover. */
+    Close: typeof SharedOverlayClose;
+    /** Positioned modal or nonmodal dialog surface. */
+    Content: typeof Content;
+    /** Required accessible popover description. */
+    Description: typeof SharedOverlayDescription;
+    /** Controlled, read-only, or uncontrolled open-state coordinator. */
+    Root: typeof Root;
+    /** Required accessible popover title. */
+    Title: typeof SharedOverlayTitle;
+    /** Semantic action that opens the popover. */
+    Trigger: typeof SharedOverlayTrigger;
+};
+export {};
+//# sourceMappingURL=Popover.d.ts.map

package/dist/primitives/Popover/Popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../src/primitives/Popover/Popover.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,GAAG,EACJ,MAAM,OAAO,CAAC;AASf,OAAO,EAEL,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,wBAAwB,EACxB,KAAK,6BAA6B,EAClC,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,oBAAoB,EACpB,KAAK,yBAAyB,EAC/B,MAAM,wCAAwC,CAAC;AAMhD,UAAU,sBAAsB;IAC9B,2BAA2B,CAAC,QAAQ,EAAE,SAAS,CAAC;CACjD;AACD,UAAU,0BAA0B;IAClC,0BAA0B,CAAC,IAAI,EAAE,OAAO,CAAC;IACzC,mCAAmC,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1E,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AACD,UAAU,wBAAwB;IAChC,oCAAoC,CAAC,IAAI,EAAE,OAAO,CAAC;IACnD,wCAAwC,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxD,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,YAAY,CAAC,EAAE,KAAK,CAAC;CACtB;AACD,UAAU,4BAA4B;IACpC,0BAA0B,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IACjD,mCAAmC,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3E,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AACD,sEAAsE,CAAC,MAAM,MAAM,gBAAgB,GACjG,sBAAsB,GACpB,CACI,0BAA0B,GAC1B,wBAAwB,GACxB,4BAA4B,CAC/B,CAAC;AACN,qCAAqC,CAAC,MAAM,MAAM,mBAAmB,GACnE,yBAAyB,CAAC;AAC5B,4CAA4C,CAAC,MAAM,WAAW,mBAC5D,SAAQ,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAClD,uBAAuB,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC5C,4DAA4D,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IACnF,iCAAiC,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IACpE,gEAAgE,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACjF,yCAAyC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC1D,qDAAqD,CAAC,SAAS,CAAC,EAC5D,KAAK,GACL,QAAQ,GACR,MAAM,GACN,OAAO,GACP,WAAW,GACX,SAAS,GACT,cAAc,GACd,YAAY,CAAC;IACjB,sCAAsC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;CAC/D;AACD,wCAAwC,CAAC,MAAM,MAAM,iBAAiB,GACpE,uBAAuB,CAAC;AAC1B,8CAA8C,CAAC,MAAM,MAAM,uBAAuB,GAChF,6BAA6B,CAAC;AAChC,+CAA+C,CAAC,MAAM,MAAM,iBAAiB,GAC3E,uBAAuB,CAAC;AAE1B,sEAAsE;AACtE,wBAAgB,IAAI,CAAC,EACnB,WAAW,EACX,YAAY,EACZ,IAAI,EACJ,QAAQ,EAAE,SAAS,EACnB,GAAG,KAAK,EACT,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,YAAY,CAQ3C;AACD,wBAAgB,OAAO,CAAC,EACtB,QAAQ,EACR,SAAS,EACT,WAAkB,EAClB,uBAA+B,EAC/B,KAAa,EACb,MAAU,EACV,SAA0B,EAC1B,GAAG,EACH,GAAG,KAAK,EACT,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,YAAY,CA4B9C;AACD;;;;GAIG;AACH,eAAO,MAAM,OAAO;IAClB,+CAA+C;;IAE/C,mDAAmD;;IAEnD,+CAA+C;;IAE/C,qEAAqE;;IAErE,yCAAyC;;IAEzC,8CAA8C;;CAE/C,CAAC"}

package/dist/primitives/ProgressBar/ProgressBar.d.ts

@@ -0,0 +1,41 @@
+import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import type { VisualVariant } from '../../internal/styling/visual';
+type ProgressBarNativeProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'role' | 'style'>;
+interface ProgressBarSharedProps extends ProgressBarNativeProps {
+    /** Visible application-owned translated progress label. */
+    label: ReactNode;
+    /** Maximum range value. Defaults to `100`. */
+    maximum?: number;
+    /** Minimum range value. Defaults to `0`. */
+    minimum?: number;
+    /** Ref to the rendered progress element. */
+    ref?: Ref<HTMLDivElement>;
+    /** Bootstrap-aligned semantic colour. Defaults to `primary`. */
+    variant?: VisualVariant;
+}
+interface DeterminateProgressBarProps {
+    /** Excluded or false when progress has a measurable value. */
+    indeterminate?: false;
+    /** Current progress value within the configured range. */
+    value: number;
+    /** Optional translated value announced instead of the numeric value. */
+    valueText?: string;
+}
+interface IndeterminateProgressBarProps {
+    /** Marks progress as ongoing without a measurable value. */
+    indeterminate: true;
+    /** Excluded because indeterminate progress has no current value. */
+    value?: never;
+    /** Excluded because indeterminate progress has no current value text. */
+    valueText?: never;
+}
+/** Props for determinate or indeterminate operation progress. */
+export type ProgressBarProps = ProgressBarSharedProps & (DeterminateProgressBarProps | IndeterminateProgressBarProps);
+/**
+ * Shows measurable or indeterminate operation progress with range semantics.
+ *
+ * @summary labelled determinate or indeterminate operation progress
+ */
+export declare function ProgressBar({ className, indeterminate, label, maximum, minimum, ref, value, valueText, variant, ...props }: Readonly<ProgressBarProps>): ReactElement;
+export {};
+//# sourceMappingURL=ProgressBar.d.ts.map

package/dist/primitives/ProgressBar/ProgressBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressBar.d.ts","sourceRoot":"","sources":["../../../src/primitives/ProgressBar/ProgressBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,GAAG,EACJ,MAAM,OAAO,CAAC;AAMf,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AA6BnE,KAAK,sBAAsB,GAAG,IAAI,CAChC,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,GAAG,MAAM,GAAG,OAAO,CAC9B,CAAC;AAEF,UAAU,sBAAuB,SAAQ,sBAAsB;IAC7D,2DAA2D;IAC3D,KAAK,EAAE,SAAS,CAAC;IACjB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IAC1B,gEAAgE;IAChE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,UAAU,2BAA2B;IACnC,8DAA8D;IAC9D,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,6BAA6B;IACrC,4DAA4D;IAC5D,aAAa,EAAE,IAAI,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,yEAAyE;IACzE,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GACnD,CAAC,2BAA2B,GAAG,6BAA6B,CAAC,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,aAAqB,EACrB,KAAK,EACL,OAAa,EACb,OAAW,EACX,GAAG,EACH,KAAK,EACL,SAAS,EACT,OAAmB,EACnB,GAAG,KAAK,EACT,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,YAAY,CA2D3C"}

package/dist/primitives/RadioGroup/RadioGroup.d.ts

@@ -0,0 +1,131 @@
+import type { HTMLAttributes, LabelHTMLAttributes, ReactElement, ReactNode, Ref, RefObject } from 'react';
+import type { ControlSize } from '../../internal/styling/visual';
+import { type TextFieldDescriptionProps, type TextFieldErrorProps, type TextFieldLabelProps } from '../TextField/TextField';
+type RadioGroupRootNativeProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'defaultValue' | 'onChange' | 'style'>;
+interface RadioGroupRootSharedProps extends RadioGroupRootNativeProps {
+    /** Compound label, radio items, description, and error parts. */
+    children: ReactNode;
+    /** Prevents focus and selection changes for every option. Defaults to `false`. */
+    disabled?: boolean;
+    /** Exposes invalid group state to assistive technology and error styling. Defaults to `false`. */
+    invalid?: boolean;
+    /** Native form field name shared by every radio option. */
+    name?: string;
+    /** Option layout and arrow-key navigation axis. Defaults to `vertical`. */
+    orientation?: 'horizontal' | 'vertical';
+    /** Marks the radio group as requiring a selection. Defaults to `false`. */
+    required?: boolean;
+    /** Ref to the rendered radio group. */
+    ref?: Ref<HTMLDivElement>;
+}
+interface ControlledRadioGroupRootProps {
+    /** Current selected option, or `null` when no option is selected. */
+    selection: string | null;
+    /** Called with the next selected option value. */
+    onSelectionChange: (selection: string) => void;
+    defaultSelection?: never;
+    readOnly?: false;
+}
+interface ReadOnlyRadioGroupRootProps {
+    /** Current immutable option, or `null` when no option is selected. */
+    selection: string | null;
+    /** Marks a controlled selection as intentionally immutable. */
+    readOnly: true;
+    defaultSelection?: never;
+    onSelectionChange?: never;
+}
+interface UncontrolledRadioGroupRootProps {
+    /** Initial selected option. Defaults to no selection. */
+    defaultSelection?: string;
+    /** Called with the next selected option value. */
+    onSelectionChange?: (selection: string) => void;
+    readOnly?: false;
+    selection?: never;
+}
+/** Props for controlled, read-only, or uncontrolled radio-group selection. */
+export type RadioGroupRootProps = RadioGroupRootSharedProps & (ControlledRadioGroupRootProps | ReadOnlyRadioGroupRootProps | UncontrolledRadioGroupRootProps);
+/** Props for the visible radio-group label. */
+export type RadioGroupLabelProps = TextFieldLabelProps;
+/** Props for supporting text associated with the radio group. */
+export type RadioGroupDescriptionProps = TextFieldDescriptionProps;
+/** Props for an accessible radio-group validation message. */
+export type RadioGroupErrorProps = TextFieldErrorProps;
+/** Props for one radio option and its optional description. */
+export interface RadioGroupItemProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'style'> {
+    /** Compound control and optional item description. */
+    children: ReactNode;
+    /** Prevents selection of this option. Defaults to `false`. */
+    disabled?: boolean;
+    /** Ref to the hidden native radio input. */
+    inputRef?: RefObject<HTMLInputElement | null>;
+    /** Ref to the rendered option field. */
+    ref?: Ref<HTMLDivElement>;
+    /** Stable native form value for this option. */
+    value: string;
+}
+/** Props for the clickable radio option and native label. */
+export interface RadioGroupControlProps extends Omit<LabelHTMLAttributes<HTMLLabelElement>, 'onClick' | 'onClickCapture' | 'style'> {
+    /** Indicator and persistent option label. */
+    children: ReactNode;
+    /** Ref to the rendered native label. */
+    ref?: Ref<HTMLLabelElement>;
+}
+/** Props for the visual radio selection indicator. */
+export interface RadioGroupIndicatorProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'children' | 'style'> {
+    /** Ref to the rendered indicator. */
+    ref?: Ref<HTMLSpanElement>;
+    /** Canonical indicator size. Defaults to `md`. */
+    size?: ControlSize;
+}
+/** Props for persistent visible radio-option label text. */
+export interface RadioGroupItemLabelProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'style'> {
+    /** Text naming the radio option. */
+    children: ReactNode;
+    /** Ref to the rendered option label text. */
+    ref?: Ref<HTMLSpanElement>;
+}
+/** Props for supporting text associated with one radio option. */
+export type RadioGroupItemDescriptionProps = TextFieldDescriptionProps;
+/** Coordinates exclusive selection, validation, orientation, and native form naming. */
+export declare function Root({ children, className, defaultSelection, disabled, invalid, name, onSelectionChange, orientation, readOnly, ref, required, selection, ...props }: Readonly<RadioGroupRootProps>): ReactElement;
+/** Renders one radio option field with native form value and optional guidance. */
+export declare function Item({ children, className, disabled, inputRef, ref, value, ...props }: Readonly<RadioGroupItemProps>): ReactElement;
+/** Renders the persistent accessible label owned by the radio group. */
+export declare function Label({ className, ref, ...props }: Readonly<RadioGroupLabelProps>): ReactElement;
+/** Renders supporting guidance on its own radio-group row. */
+export declare function Description(props: Readonly<RadioGroupDescriptionProps>): ReactElement;
+/** Renders associated validation feedback on its own radio-group row. */
+declare function ErrorMessage(props: Readonly<RadioGroupErrorProps>): ReactElement;
+export { ErrorMessage as Error };
+/** Renders the pointer, touch, and keyboard target for one radio option. */
+export declare function Control({ className, ref, ...props }: Readonly<RadioGroupControlProps>): ReactElement;
+/** Renders the visual selected state for one radio option. */
+export declare function Indicator({ className, ref, size, ...props }: Readonly<RadioGroupIndicatorProps>): ReactElement;
+/** Renders persistent visible label text within RadioGroup.Control. */
+export declare function ItemLabel({ ref, ...props }: Readonly<RadioGroupItemLabelProps>): ReactElement;
+/**
+ * Accessible compound exclusive-selection primitive.
+ *
+ * @summary labelled exclusive selection with native radio semantics
+ */
+export declare const RadioGroup: {
+    /** Pointer, touch, and keyboard selection target for one option. */
+    Control: typeof Control;
+    /** Supporting guidance associated with the group. */
+    Description: typeof Description;
+    /** Validation message associated with an invalid group. */
+    Error: typeof ErrorMessage;
+    /** Visual selected-state indicator. */
+    Indicator: typeof Indicator;
+    /** One radio option field. */
+    Item: typeof Item;
+    /** Supporting guidance associated with one option. */
+    ItemDescription: typeof import("../TextField/TextField").Description;
+    /** Persistent visible option label text. */
+    ItemLabel: typeof ItemLabel;
+    /** Persistent accessible group label. */
+    Label: typeof Label;
+    /** Selection, validation, orientation, and native form root. */
+    Root: typeof Root;
+};
+//# sourceMappingURL=RadioGroup.d.ts.map

package/dist/primitives/RadioGroup/RadioGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../src/primitives/RadioGroup/RadioGroup.tsx"],"names":[],"mappings":"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"}

package/dist/primitives/RangeCalendar/RangeCalendar.d.ts

@@ -0,0 +1,57 @@
+import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import type { DateRangeValue } from '../../internal/types/date';
+import { type CalendarButtonPartProps, CalendarGridPart, type CalendarGridPartProps, CalendarHeaderPart, type CalendarHeaderPartProps, CalendarHeadingPart, type CalendarHeadingPartProps, CalendarNextButtonPart, CalendarPreviousButtonPart } from '../date/CalendarParts';
+interface SharedProps extends Omit<HTMLAttributes<HTMLDivElement>, 'defaultValue' | 'onChange' | 'style'> {
+    /** Calendar navigation, heading, range grid, and guidance. */ children: ReactNode;
+    /** Allows ranges containing unavailable dates. */ allowsNonContiguousRanges?: boolean;
+    /** Prevents focus and selection. */ disabled?: boolean;
+    /** Exposes invalid selection state. */ invalid?: boolean;
+    /** Returns whether a stable date is unavailable. */ isDateUnavailable?: (date: string, anchorDate: string | null) => boolean;
+    /** Latest selectable date. */ maxValue?: string;
+    /** Earliest selectable date. */ minValue?: string;
+    /** Ref to the rendered range-calendar root. */ ref?: Ref<HTMLDivElement>;
+    /** Number of visible months. Defaults to `1`. */ visibleMonths?: number;
+}
+type State = {
+    /** Current controlled range, or `null` when empty. */ value: DateRangeValue | null;
+    /** Called with the next stable range or `null`. */ onChange: (value: DateRangeValue | null) => void;
+    /** Excluded when controlled. */ defaultValue?: never;
+    /** Mutable controlled calendars cannot be read-only. */ readOnly?: false;
+} | {
+    /** Current immutable range, or `null` when empty. */ value: DateRangeValue | null;
+    /** Prevents range changes. */ readOnly: true;
+    /** Excluded when controlled. */ defaultValue?: never;
+    /** Excluded because read-only calendars cannot change. */ onChange?: never;
+} | {
+    /** Initial uncontrolled range, or `null` when empty. */ defaultValue?: DateRangeValue | null;
+    /** Called with the next stable range or `null`. */ onChange?: (value: DateRangeValue | null) => void;
+    /** Uncontrolled calendars cannot be read-only. */ readOnly?: false;
+    /** Excluded when uncontrolled. */ value?: never;
+};
+/** Props for stable date-range calendar selection. */
+export type RangeCalendarRootProps = SharedProps & State;
+/** Props for the navigation header. */
+export type RangeCalendarHeaderProps = CalendarHeaderPartProps;
+/** Props for previous and next buttons. */
+export type RangeCalendarButtonProps = CalendarButtonPartProps;
+/** Props for the locale-formatted heading. */
+export type RangeCalendarHeadingProps = CalendarHeadingPartProps;
+/** Props for the range calendar grid. */
+export type RangeCalendarGridProps = CalendarGridPartProps;
+/** Coordinates locale-aware selection of a start and end date. */
+export declare function Root({ allowsNonContiguousRanges, children, className, defaultValue, disabled, invalid, isDateUnavailable, maxValue, minValue, onChange, readOnly, ref, value, visibleMonths, ...props }: Readonly<RangeCalendarRootProps>): ReactElement;
+/**
+ * Accessible locale-aware date-range calendar.
+ *
+ * @summary inclusive ISO date-range selection from calendar grids
+ */
+export declare const RangeCalendar: {
+    /** Locale-aware weekday and range grid. */ Grid: typeof CalendarGridPart;
+    /** Navigation header container. */ Header: typeof CalendarHeaderPart;
+    /** Visible month heading. */ Heading: typeof CalendarHeadingPart;
+    /** Next-page navigation. */ NextButton: typeof CalendarNextButtonPart;
+    /** Previous-page navigation. */ PreviousButton: typeof CalendarPreviousButtonPart;
+    /** Stable range state and constraints. */ Root: typeof Root;
+};
+export {};
+//# sourceMappingURL=RangeCalendar.d.ts.map

package/dist/primitives/RangeCalendar/RangeCalendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RangeCalendar.d.ts","sourceRoot":"","sources":["../../../src/primitives/RangeCalendar/RangeCalendar.tsx"],"names":[],"mappings":"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"}

package/dist/primitives/SearchField/SearchField.d.ts

@@ -0,0 +1,70 @@
+import type { ButtonHTMLAttributes, HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import type { ControlSize } from '../../internal/styling/visual';
+import { type TextFieldDescriptionProps, type TextFieldErrorProps, type TextFieldInputProps, type TextFieldLabelProps, type TextFieldRootProps } from '../TextField/TextField';
+interface SearchFieldRootCallbacks {
+    /** Called after the query is cleared with the clear button or Escape key. */
+    onClear?: () => void;
+    /** Called with the current query when the user submits the search. */
+    onSubmit?: (value: string) => void;
+}
+/** Props for controlled, read-only, or uncontrolled search field state. */
+export type SearchFieldRootProps = TextFieldRootProps & SearchFieldRootCallbacks;
+/** Props for the visible search field label. */
+export type SearchFieldLabelProps = TextFieldLabelProps;
+/** Props for the single-surface search input and clear-action group. */
+export interface SearchFieldGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'> {
+    /** Search input and optional clear action. */
+    children: ReactNode;
+    /** Ref to the rendered group. */
+    ref?: Ref<HTMLDivElement>;
+    /** Canonical size applied to every grouped control part. Defaults to `md`. */
+    size?: ControlSize;
+}
+/** Props for the native search input part. */
+export type SearchFieldInputProps = Omit<TextFieldInputProps, 'type'>;
+/** Props for supporting text associated with the search input. */
+export type SearchFieldDescriptionProps = TextFieldDescriptionProps;
+/** Props for an accessible search validation message. */
+export type SearchFieldErrorProps = TextFieldErrorProps;
+/** Props for the search clear action. */
+export interface SearchFieldClearButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'onClick' | 'onClickCapture' | 'style' | 'type'> {
+    /** Accessible action name. Defaults to the provider's `clear` message. */
+    'aria-label'?: string;
+    /** Optional clear-action content. Defaults to the Breeze close icon. */
+    children?: ReactNode;
+    /** Ref to the rendered clear button. */
+    ref?: Ref<HTMLButtonElement>;
+    /** Standalone action size. A containing Group takes precedence. Defaults to `md`. */
+    size?: ControlSize;
+}
+/** Coordinates accessible query state, submission, clearing, and compound anatomy. */
+export declare function Root({ children, className, defaultValue, disabled, invalid, onChange, onClear, onSubmit, readOnly, ref, required, value, ...props }: Readonly<SearchFieldRootProps>): ReactElement;
+/** Groups the SearchField input and clear action as one visual control. */
+export declare function Group({ className, ref, role, size, ...props }: Readonly<SearchFieldGroupProps>): ReactElement;
+/** Renders the native search input for a SearchField. */
+export declare function Input({ className, size, ...props }: Readonly<SearchFieldInputProps>): ReactElement;
+/** Clears the current SearchField value with pointer or keyboard activation. */
+export declare function ClearButton({ 'aria-label': ariaLabel, children, className, ref, size, ...props }: Readonly<SearchFieldClearButtonProps>): ReactElement | null;
+/**
+ * Accessible compound search-query primitive.
+ *
+ * @summary labelled search entry with submission and clearing
+ */
+export declare const SearchField: {
+    /** Query clear action. */
+    ClearButton: typeof ClearButton;
+    /** Supporting guidance associated with the search input. */
+    Description: typeof import("../TextField/TextField").Description;
+    /** Validation message associated with an invalid search input. */
+    Error: typeof import("../TextField/TextField").Error;
+    /** Single-surface input and clear-action composition. */
+    Group: typeof Group;
+    /** Native search input. */
+    Input: typeof Input;
+    /** Persistent accessible label. */
+    Label: typeof import("../TextField/TextField").Label;
+    /** State, submission, and accessibility root. */
+    Root: typeof Root;
+};
+export {};
+//# sourceMappingURL=SearchField.d.ts.map

package/dist/primitives/SearchField/SearchField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchField.d.ts","sourceRoot":"","sources":["../../../src/primitives/SearchField/SearchField.tsx"],"names":[],"mappings":"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"}