@motech-development/breeze-ui 2.3.1 → 3.0.0

package/dist/primitives/TimeField/TimeField.d.ts

@@ -0,0 +1,58 @@
+import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import { DateInputPart, type DateInputPartProps } from '../date/DateInput';
+import { type TextFieldDescriptionProps, type TextFieldErrorProps, type TextFieldLabelProps } from '../TextField/TextField';
+type NativeRootProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'defaultValue' | 'onChange' | 'style'>;
+interface SharedProps extends NativeRootProps {
+    /** Compound label, segmented input, description, and error parts. */ children: ReactNode;
+    /** Prevents focus and time editing. Defaults to `false`. */ disabled?: boolean;
+    /** Associates the hidden native time input with an external form. */ form?: string;
+    /** Hidden native time input ref used for form integration. */ inputRef?: Ref<HTMLInputElement>;
+    /** Exposes invalid state. Defaults to `false`. */ invalid?: boolean;
+    /** Latest selectable `HH:mm` or `HH:mm:ss` time. */ maxValue?: string;
+    /** Earliest selectable `HH:mm` or `HH:mm:ss` time. */ minValue?: string;
+    /** Native form field name for the stable time string. */ name?: string;
+    /** Marks the time as required. Defaults to `false`. */ required?: boolean;
+    /** Ref to the rendered time-field root. */ ref?: Ref<HTMLDivElement>;
+}
+type State = {
+    /** Current controlled time, or `null` when empty. */ value: string | null;
+    /** Called with the next stable time string or `null`. */ onChange: (value: string | null) => void;
+    /** Excluded when controlled. */ defaultValue?: never;
+    /** Mutable state cannot be read-only. */ readOnly?: false;
+} | {
+    /** Current immutable time, or `null` when empty. */ value: string | null;
+    /** Prevents changes to the controlled time. */ readOnly: true;
+    /** Excluded when controlled. */ defaultValue?: never;
+    /** Excluded because read-only times cannot change. */ onChange?: never;
+} | {
+    /** Initial uncontrolled time, or `null` when empty. */ defaultValue?: string | null;
+    /** Called with the next stable time string or `null`. */ onChange?: (value: string | null) => void;
+    /** Uncontrolled state cannot be read-only. */ readOnly?: false;
+    /** Excluded when uncontrolled. */ value?: never;
+};
+/** Props for controlled, uncontrolled, or read-only stable time state. */
+export type TimeFieldRootProps = SharedProps & State;
+/** Props for the visible time-field label. */
+export type TimeFieldLabelProps = TextFieldLabelProps;
+/** Props for the segmented time input. */
+export type TimeFieldInputProps = DateInputPartProps;
+/** Props for supporting time-field guidance. */
+export type TimeFieldDescriptionProps = TextFieldDescriptionProps;
+/** Props for a time-field validation message. */
+export type TimeFieldErrorProps = TextFieldErrorProps;
+/** Coordinates stable time strings with locale-aware editable segments. */
+export declare function Root({ children, className, defaultValue, disabled, form, inputRef, invalid, maxValue, minValue, name, onChange, readOnly, ref, required, value, ...props }: Readonly<TimeFieldRootProps>): ReactElement;
+/**
+ * Accessible compound time field with stable string values.
+ *
+ * @summary locale-aware segmented entry for one stable time value
+ */
+export declare const TimeField: {
+    /** Supporting guidance associated with the time field. */ Description: typeof import("../TextField/TextField").Description;
+    /** Validation feedback associated with the time field. */ Error: typeof import("../TextField/TextField").Error;
+    /** Locale-aware editable time segments. */ Input: typeof DateInputPart;
+    /** Visible label associated with the segmented input. */ Label: typeof import("../TextField/TextField").Label;
+    /** Stable time state, constraints, validation, and form root. */ Root: typeof Root;
+};
+export {};
+//# sourceMappingURL=TimeField.d.ts.map

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

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

package/dist/primitives/Toast/Toast.d.ts

@@ -0,0 +1,88 @@
+import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import type { VisualVariant } from '../../internal/styling/visual';
+/** Application action shown within a toast. */
+export interface ToastAction {
+    /** Application-owned translated action label. */
+    label: ReactNode;
+    /** Called once when the action is activated. */
+    onAction: () => void;
+}
+/** Content and lifecycle options for a queued toast. */
+export interface ToastOptions {
+    /** Optional action that dismisses the toast after activation. */
+    action?: ToastAction;
+    /** Optional application-owned translated supporting content. */
+    description?: ReactNode;
+    /** Auto-dismiss delay in finite non-negative milliseconds; `0` dismisses immediately and `null` persists. Defaults to `5000`. */
+    lifetime?: number | null;
+    /** Called once when the toast is dismissed, except during provider teardown. */
+    onDismiss?: () => void;
+    /** Application-owned translated primary content. */
+    title: ReactNode;
+    /** Bootstrap-aligned semantic colour. Defaults to `info`. */
+    variant?: VisualVariant;
+}
+/** Provider-scoped commands for showing and dismissing toasts. */
+export interface ToastController {
+    /** Dismisses the toast with the returned queue identifier. */
+    dismiss: (id: string) => void;
+    /** Adds a toast and returns its provider-scoped queue identifier. */
+    show: (options: ToastOptions) => string;
+}
+type ToastNativeProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'role' | 'style' | 'title'>;
+/** Props for rendering an individually controlled toast. Prefer `useToast` for queued application notifications. */
+export interface ToastProps extends ToastNativeProps {
+    /** Optional application action. */
+    action?: ToastAction;
+    /** Accessible label for the dismiss button. Defaults to the provider close message. */
+    closeLabel?: string;
+    /** Optional application-owned translated supporting content. */
+    description?: ReactNode;
+    /** Called when the dismiss button or action closes the toast. */
+    onDismiss: () => void;
+    /** Ref to the rendered toast element. */
+    ref?: Ref<HTMLDivElement>;
+    /** Application-owned translated primary content. */
+    title: ReactNode;
+    /** Bootstrap-aligned semantic colour. Defaults to `info`. */
+    variant?: VisualVariant;
+}
+/**
+ * Displays one explicitly controlled notification. Queued application
+ * notifications should use `useToast`.
+ *
+ * @summary for explicitly controlled notifications outside the provider queue
+ */
+export declare function Toast({ action, className, closeLabel, description, onDismiss, ref, title, variant, ...props }: Readonly<ToastProps>): ReactElement;
+/** Props for the provider-scoped toast stack. BreezeProvider renders this automatically. */
+export interface ToastRegionProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'role' | 'style'> {
+    /** Accessible translated label for the notification stack. Defaults to the provider message. */
+    label?: string;
+    /** Ref to the rendered region element. */
+    ref?: Ref<HTMLDivElement>;
+}
+/**
+ * Renders the current provider's toast queue into its scoped portal host.
+ * BreezeProvider already renders the primary region; add another only when an
+ * advanced layout requires a separately labelled queue presentation.
+ *
+ * @summary for rendering an additional provider-scoped toast queue region
+ */
+export declare function ToastRegion({ className, label, ref, ...props }: Readonly<ToastRegionProps>): ReactElement | null;
+interface ToastProviderBoundaryProps {
+    children: ReactNode;
+    closeLabel: string;
+    limit: number;
+    regionLabel: string;
+}
+/** @internal Establishes the queue owned by one BreezeProvider instance. */
+export declare function ToastProviderBoundary({ children, closeLabel, limit, regionLabel, }: Readonly<ToastProviderBoundaryProps>): ReactElement;
+/**
+ * Returns commands for showing and dismissing notifications in the nearest
+ * BreezeProvider queue. Call this hook only below BreezeProvider.
+ *
+ * @summary for controlling the nearest BreezeProvider toast queue
+ */
+export declare function useToast(): ToastController;
+export {};
+//# sourceMappingURL=Toast.d.ts.map

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

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

package/dist/primitives/ToggleButton/ToggleButton.d.ts

@@ -0,0 +1,55 @@
+import type { ReactElement, ReactNode, Ref } from 'react';
+import type { ControlSize, VisualAppearance, VisualVariant } from '../../internal/styling/visual';
+import type { NativeButtonProps } from '../../internal/types/native';
+interface ToggleButtonSharedProps extends Omit<NativeButtonProps, 'value'> {
+    /** Visual emphasis treatment. Defaults to `outline`. */
+    appearance?: VisualAppearance;
+    /** Toggle content. */
+    children: ReactNode;
+    /** Placement and composition classes. */
+    className?: string;
+    /** Prevents interaction. Defaults to `false`. */
+    disabled?: boolean;
+    /** Ref to the rendered button. */
+    ref?: Ref<HTMLButtonElement>;
+    /** Canonical control size. Defaults to `md`. */
+    size?: ControlSize;
+    /** Stable value when the toggle is composed inside a ToggleGroup. */
+    value?: string;
+    /** Semantic colour. Defaults to `primary`. */
+    variant?: VisualVariant;
+}
+interface ControlledToggleButtonProps {
+    /** Current selected state. */
+    selected: boolean;
+    /** Called with the next selected state. */
+    onChange: (selected: boolean) => void;
+    defaultSelected?: never;
+    readOnly?: false;
+}
+interface ReadOnlyToggleButtonProps {
+    /** Current selected state. */
+    selected: boolean;
+    /** Marks controlled state as intentionally immutable while preserving focus. */
+    readOnly: true;
+    defaultSelected?: never;
+    onChange?: never;
+}
+interface UncontrolledToggleButtonProps {
+    /** Initial selected state. Defaults to `false`. */
+    defaultSelected?: boolean;
+    /** Called with the next selected state. */
+    onChange?: (selected: boolean) => void;
+    readOnly?: false;
+    selected?: never;
+}
+/** Props for a controlled or uncontrolled two-state action. */
+export type ToggleButtonProps = ToggleButtonSharedProps & (ControlledToggleButtonProps | ReadOnlyToggleButtonProps | UncontrolledToggleButtonProps);
+/**
+ * Selects or deselects a two-state action through pointer or keyboard input.
+ *
+ * @summary two-state action with controlled or uncontrolled selection
+ */
+export declare function ToggleButton({ appearance, children, className, defaultSelected, disabled, id, onChange, readOnly, ref, selected, size, value, variant, ...props }: Readonly<ToggleButtonProps>): ReactElement;
+export {};
+//# sourceMappingURL=ToggleButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleButton.d.ts","sourceRoot":"","sources":["../../../src/primitives/ToggleButton/ToggleButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAK1E,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,UAAU,uBAAwB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACxE,wDAAwD;IACxD,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,sBAAsB;IACtB,QAAQ,EAAE,SAAS,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7B,gDAAgD;IAChD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,UAAU,2BAA2B;IACnC,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED,UAAU,yBAAyB;IACjC,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,QAAQ,EAAE,IAAI,CAAC;IACf,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED,UAAU,6BAA6B;IACrC,mDAAmD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GACrD,CACI,2BAA2B,GAC3B,yBAAyB,GACzB,6BAA6B,CAChC,CAAC;AAEJ;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAC3B,UAAsB,EACtB,QAAQ,EACR,SAAS,EACT,eAAe,EACf,QAAgB,EAChB,EAAE,EACF,QAAQ,EACR,QAAgB,EAChB,GAAG,EACH,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,OAAO,EACP,GAAG,KAAK,EACT,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,YAAY,CAyB5C"}

package/dist/primitives/ToggleGroup/ToggleGroup.d.ts

@@ -0,0 +1,48 @@
+import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+type ToggleGroupNativeProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'defaultValue' | 'onChange' | 'style'>;
+interface ToggleGroupSharedProps extends ToggleGroupNativeProps {
+    /** ToggleButton children with stable `value` props. */
+    children: ReactNode;
+    /** Prevents all contained toggles from changing. Defaults to `false`. */
+    disabled?: boolean;
+    /** Allows more than one selected value. Defaults to `false`. */
+    multiple?: boolean;
+    /** Layout and keyboard navigation axis. Defaults to `horizontal`. */
+    orientation?: 'horizontal' | 'vertical';
+    /** Ref to the rendered group. */
+    ref?: Ref<HTMLDivElement>;
+}
+interface ControlledToggleGroupProps {
+    /** Current selected values. */
+    selection: string[];
+    /** Called with the next selected values. */
+    onSelectionChange: (selection: string[]) => void;
+    defaultSelection?: never;
+    readOnly?: false;
+}
+interface ReadOnlyToggleGroupProps {
+    /** Current selected values. */
+    selection: string[];
+    /** Marks a controlled selection as intentionally immutable. */
+    readOnly: true;
+    defaultSelection?: never;
+    onSelectionChange?: never;
+}
+interface UncontrolledToggleGroupProps {
+    /** Initial selected values. Defaults to an empty selection. */
+    defaultSelection?: string[];
+    /** Called with the next selected values. */
+    onSelectionChange?: (selection: string[]) => void;
+    readOnly?: false;
+    selection?: never;
+}
+/** Props for a controlled, read-only, or uncontrolled toggle collection. */
+export type ToggleGroupProps = ToggleGroupSharedProps & (ControlledToggleGroupProps | ReadOnlyToggleGroupProps | UncontrolledToggleGroupProps);
+/**
+ * Coordinates single or multiple toggle selection and arrow-key navigation.
+ *
+ * @summary related toggle actions with single or multiple selection
+ */
+export declare function ToggleGroup({ children, className, defaultSelection, disabled, multiple, onSelectionChange, orientation, readOnly: _readOnly, ref, selection, ...props }: Readonly<ToggleGroupProps>): ReactElement;
+export {};
+//# sourceMappingURL=ToggleGroup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleGroup.d.ts","sourceRoot":"","sources":["../../../src/primitives/ToggleGroup/ToggleGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAoB1E,KAAK,sBAAsB,GAAG,IAAI,CAChC,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,GAAG,cAAc,GAAG,UAAU,GAAG,OAAO,CACnD,CAAC;AAEF,UAAU,sBAAuB,SAAQ,sBAAsB;IAC7D,uDAAuD;IACvD,QAAQ,EAAE,SAAS,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC,iCAAiC;IACjC,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;CAC3B;AAED,UAAU,0BAA0B;IAClC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,4CAA4C;IAC5C,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACjD,gBAAgB,CAAC,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED,UAAU,wBAAwB;IAChC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,+DAA+D;IAC/D,QAAQ,EAAE,IAAI,CAAC;IACf,gBAAgB,CAAC,EAAE,KAAK,CAAC;IACzB,iBAAiB,CAAC,EAAE,KAAK,CAAC;CAC3B;AAED,UAAU,4BAA4B;IACpC,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GACnD,CACI,0BAA0B,GAC1B,wBAAwB,GACxB,4BAA4B,CAC/B,CAAC;AAEJ;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,QAAgB,EAChB,QAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,QAAQ,EAAE,SAAS,EACnB,GAAG,EACH,SAAS,EACT,GAAG,KAAK,EACT,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,YAAY,CAuB3C"}

package/dist/primitives/Toolbar/Toolbar.d.ts

@@ -0,0 +1,17 @@
+import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+/** Props for a keyboard-navigable collection of related controls. */
+export interface ToolbarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'style'> {
+    /** Related interactive controls. */
+    children: ReactNode;
+    /** Arrow-key navigation axis. Defaults to `horizontal`. */
+    orientation?: 'horizontal' | 'vertical';
+    /** Ref to the rendered toolbar. */
+    ref?: Ref<HTMLDivElement>;
+}
+/**
+ * Groups related controls under toolbar semantics and arrow-key navigation.
+ *
+ * @summary related controls with orientation-aware arrow navigation
+ */
+export declare function Toolbar({ children, className, orientation, ref, ...props }: Readonly<ToolbarProps>): ReactElement;
+//# sourceMappingURL=Toolbar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../../../src/primitives/Toolbar/Toolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAoB1E,qEAAqE;AACrE,MAAM,WAAW,YACf,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IAClE,oCAAoC;IACpC,QAAQ,EAAE,SAAS,CAAC;IACpB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC,mCAAmC;IACnC,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EACtB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,GAAG,EACH,GAAG,KAAK,EACT,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,YAAY,CAkBvC"}

package/dist/primitives/Tooltip/Tooltip.d.ts

@@ -0,0 +1,66 @@
+import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import { Button, type ButtonProps } from '../Button/Button';
+interface TooltipRootSharedProps {
+    /** Trigger and tooltip content. */ children: ReactNode;
+    /** Delay before opening in milliseconds. Defaults to `700`. */ delay?: number;
+    /** Delay before closing in milliseconds. Defaults to `0`. */ closeDelay?: number;
+}
+interface ControlledTooltipRootProps {
+    /** Current open state. */ open: boolean;
+    /** Called with next open state. */ onOpenChange: (open: boolean) => void;
+    defaultOpen?: never;
+    readOnly?: false;
+}
+interface ReadOnlyTooltipRootProps {
+    /** Current immutable open state. */ open: boolean;
+    /** Marks controlled state immutable. */ readOnly: true;
+    defaultOpen?: never;
+    onOpenChange?: never;
+}
+interface UncontrolledTooltipRootProps {
+    /** 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 tooltip state. */ export type TooltipRootProps = TooltipRootSharedProps & (ControlledTooltipRootProps | ReadOnlyTooltipRootProps | UncontrolledTooltipRootProps);
+/** Props for the tooltip trigger action. */ export type TooltipTriggerProps = ButtonProps;
+/** Props for a compact non-action tooltip trigger with a required accessible name. */ export interface TooltipIconTriggerProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'children' | 'style'> {
+    /** Accessible name for the informational icon. */
+    'aria-label': string;
+    /** Decorative icon. */
+    children: ReactNode;
+    /** Ref to the rendered focusable informational icon. */
+    ref?: Ref<HTMLSpanElement>;
+    /** Semantic icon colour. Defaults to `secondary`. */
+    variant?: 'danger' | 'primary' | 'secondary';
+}
+/** Props for descriptive tooltip content. */ export interface TooltipContentProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'> {
+    /** Concise descriptive text. */ children: ReactNode;
+    /** Gap from trigger. Defaults to `6`. */ offset?: number;
+    /** Placement. Defaults to `top`. */ placement?: 'top' | 'bottom' | 'left' | 'right' | 'top start' | 'top end' | 'bottom start' | 'bottom end';
+    /** Ref to rendered tooltip. */ ref?: Ref<HTMLDivElement>;
+    /** Semantic tooltip colour. Defaults to `secondary`. */
+    variant?: 'danger' | 'primary' | 'secondary';
+}
+/** Coordinates concise supplementary information for a trigger. */
+export declare function Root({ closeDelay, defaultOpen, delay, onOpenChange, open, readOnly: _readOnly, ...props }: Readonly<TooltipRootProps>): ReactElement;
+export declare function IconTrigger({ children, className, ref, variant, ...props }: Readonly<TooltipIconTriggerProps>): ReactElement;
+export declare function Content({ className, offset, placement, ref, variant, ...props }: Readonly<TooltipContentProps>): ReactElement;
+/**
+ * Accessible compound descriptive tooltip primitive.
+ *
+ * @summary concise non-interactive help revealed from a trigger
+ */
+export declare const Tooltip: {
+    /** Concise descriptive popup positioned against its trigger. */
+    Content: typeof Content;
+    /** Focusable informational icon described by the tooltip. */
+    IconTrigger: typeof IconTrigger;
+    /** Controlled, read-only, or uncontrolled hover and focus coordinator. */
+    Root: typeof Root;
+    /** Semantic action described by the tooltip. */
+    Trigger: typeof Button;
+};
+export {};
+//# sourceMappingURL=Tooltip.d.ts.map

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

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