@servicetitan/anvil2 2.7.1 → 2.9.0

package/dist/components/AiMark/AiMark.d.ts

@@ -0,0 +1,87 @@
+import { IconProps } from '../Icon';
+import { AiMarkCollapsePadding, AiMarkWithTooltipOrPopoverConfig } from '../../types/ai-marks';
+/**
+ * Props for the AiMark component
+ * @property {"default" | "gradient"} [type] - The visual style of the AI mark
+ * @property {AiMarkWithTooltipOrPopoverConfig} [popoverOrTooltipConfig] - Configuration for popover or tooltip display with content and props
+ * @property {boolean} [forceAnimate] - Forces the pulsing animation to play, intended for use within interactive parent components (e.g. on hover or focus of the parent)
+ * @property {AiMarkCollapsePadding} [collapsePadding] - Collapses the component's layout footprint to match a plain icon on the chosen axes.
+ * @extends Omit<IconProps, "svg">
+ */
+export type AiMarkProps = Omit<IconProps, "svg"> & {
+    /**
+     * The visual style of the AI mark.
+     * @default default
+     */
+    type?: "default" | "gradient";
+    /**
+     * Configuration for popover or tooltip display.
+     * Includes content, trigger label, and optional props for customization.
+     * Popover config takes precedence over tooltip config.
+     */
+    popoverOrTooltipConfig?: AiMarkWithTooltipOrPopoverConfig;
+    /**
+     * When true, forces the pulsing morph animation to play regardless of
+     * hover/focus state. Useful when AiMark is embedded inside an interactive
+     * parent component (e.g. a Chip or Button) and the parent controls when
+     * the animation should be active via its own hover or focus state.
+     * @default false
+     */
+    forceAnimate?: boolean;
+    /**
+     * Collapses padding on the chosen axes so the component's layout footprint
+     * matches a plain inline icon on those axes.
+     *
+     * For interactive variants (tooltip/popover), the ghost button's hit area is
+     * unchanged — only the container's layout box shrinks.
+     *
+     * For non-interactive variants, padding equal to the ghost button's padding is
+     * added to the non-collapsed axes, and omitted on the collapsed axes.
+     *
+     * - `"inline"` — collapse the inline axis (left/right)
+     * - `"block"` — collapse the block axis (top/bottom)
+     * - `"all"` — collapse both axes
+     */
+    collapsePadding?: AiMarkCollapsePadding;
+};
+/**
+ * Component for displaying the ServiceTitan AI mark with optional tooltip or popover.
+ *
+ * Features:
+ * - Two visual styles: default and gradient variants
+ * - Optional tooltip on hover for contextual information
+ * - Optional popover on click for more detailed content
+ * - Forced animation mode for use within interactive parent components
+ * - Uses ghost button appearance for subtle interaction
+ * - Inherits all icon properties for size and styling customization
+ * - Accessible with proper ARIA attributes from Button component
+ * - Prevents event propagation when used with popover
+ * - Configurable via popoverOrTooltipConfig for advanced customization
+ * - Optional `collapsePadding` to reduce layout footprint to match a plain icon
+ * - Animates on hover and focus when used with tooltip or popover
+ * - Automatically respects the user's reduced motion preference
+ *
+ * @example
+ * <AiMark
+ *   type="default"
+ *   popoverOrTooltipConfig={{
+ *     type: "tooltip",
+ *     content: "Powered by AI",
+ *     triggerLabel: "AI feature information"
+ *   }}
+ * />
+ *
+ * @example
+ * <AiMark
+ *   type="gradient"
+ *   popoverOrTooltipConfig={{
+ *     type: "popover",
+ *     content: <Text>AI feature details</Text>,
+ *     triggerLabel: "Learn about AI features"
+ *   }}
+ * />
+ *
+ * @example
+ * <AiMark type="default" forceAnimate={isHovered} />
+ */
+export declare const AiMark: (props: AiMarkProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/AiMark/index.d.ts

@@ -0,0 +1 @@
+export * from './AiMark';

package/dist/components/AiMark/internal/AiMarkIconAnimated.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Props for the AiMarkIconAnimated component
+ * @property {boolean} [animate] - Whether to trigger animations (on hover or focus)
+ * @property {number} [size] - Size of the icon in pixels
+ * @property {boolean} [inheritColor] - Whether to inherit color from parent instead of using gradient
+ * @property {boolean} [spin] - Whether to enable the rotation animation in addition to the morph pulse
+ */
+interface AiMarkIconAnimatedProps {
+    animate?: boolean;
+    size?: number;
+    inheritColor?: boolean;
+    spin?: boolean;
+}
+/**
+ * AiMarkIconAnimated renders two animated Atlas AI star icons with rotation and morph effects.
+ *
+ * Features:
+ * - Displays two stars in different sizes positioned in a composition
+ * - Animates morphing on hover
+ * - Supports rotation animation via spin prop
+ * - Supports gradient or inherited color
+ * - Automatically respects reduced motion preferences
+ * - Configurable size
+ * - Unique gradient IDs prevent conflicts when multiple icons render
+ *
+ * @example
+ * <AiMarkIconAnimated animate={isActive} size={24} />
+ */
+export declare const AiMarkIconAnimated: ({ animate, size, inheritColor, spin, }: AiMarkIconAnimatedProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/AiMark/internal/AiMarkInteractive.d.ts

@@ -0,0 +1,10 @@
+import { IconProps } from '../../Icon';
+import { AiMarkWithTooltipOrPopoverConfig } from '../../../types/ai-marks';
+export type AiMarkInteractiveProps = {
+    config: AiMarkWithTooltipOrPopoverConfig;
+    size: NonNullable<IconProps["size"]>;
+    inheritColor: boolean;
+    containerClassName: string;
+    forceAnimate?: boolean;
+};
+export declare const AiMarkInteractive: ({ config, size, inheritColor, containerClassName, forceAnimate, }: AiMarkInteractiveProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/AiMark/stories/aiMarkStoryArgTypes.d.ts

@@ -0,0 +1,16 @@
+import { AiMarkWithTooltipOrPopoverConfig } from '../../../types/ai-marks';
+export declare const AI_MARK_STORY_OPTIONS: readonly ["false", "true", "tooltip (default)", "tooltip (custom)", "popover (default)", "popover (custom)"];
+export type AiMarkStoryOption = (typeof AI_MARK_STORY_OPTIONS)[number];
+/**
+ * Maps Storybook `aiMark` dropdown values to `AiMark` / `aiMark` prop values.
+ */
+export declare function resolveAiMarkStoryOption(option: AiMarkStoryOption | undefined): boolean | AiMarkWithTooltipOrPopoverConfig | undefined;
+export declare const argTypesAiMarkStory: {
+    aiMarkStory: {
+        name: string;
+        options: ("true" | "false" | "tooltip (default)" | "tooltip (custom)" | "popover (default)" | "popover (custom)")[];
+        control: {
+            type: "select";
+        };
+    };
+};

package/dist/components/Alert/Alert.d.ts

@@ -1,5 +1,6 @@
 import { ComponentPropsWithoutRef } from 'react';
 import { DataTrackingId, LayoutUtilProps, OnCloseProps, Status } from '../../types';
+import { AiMarkWithTooltipOrPopoverConfig } from '../../types/ai-marks';
 /**
  * Props for the Alert component
  * @extends ComponentPropsWithoutRef<"div">
@@ -16,6 +17,11 @@ export type AlertProps = ComponentPropsWithoutRef<"div"> & LayoutUtilProps & OnC
      * The title text displayed in the alert.
      */
     title: string;
+    /**
+     * When set, displays the AI mark inline after the title.
+     * Use `true` for the sparkle only, or pass tooltip/popover configuration.
+     */
+    aiMark?: boolean | AiMarkWithTooltipOrPopoverConfig;
 } & 
 /**
  * Data tracking id
@@ -27,6 +33,7 @@ DataTrackingId;
  * Features:
  * - Supports different visual styles (info, success, warning, danger)
  * - Optional close button for dismissible alerts
+ * - Optional AI mark inline after the title
  * - Customizable title and content
  * - Accessible with proper ARIA roles
  * - Includes status-specific icons
@@ -59,4 +66,9 @@ export declare const Alert: import('react').ForwardRefExoticComponent<Omit<impor
      * The title text displayed in the alert.
      */
     title: string;
+    /**
+     * When set, displays the AI mark inline after the title.
+     * Use `true` for the sparkle only, or pass tooltip/popover configuration.
+     */
+    aiMark?: boolean | AiMarkWithTooltipOrPopoverConfig;
 } & DataTrackingId & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/Button/Button.d.ts

@@ -1,12 +1,23 @@
 import { ButtonAppearance, Size, DataTrackingId, LayoutUtilProps } from '../../types';
 import { ComponentPropsWithoutRef } from 'react';
 import { IconProps } from '../Icon';
+import { AiIconName } from './internal';
+export type { AiIconName };
 /**
  * Props for the Button component
  * @extends Omit<ComponentPropsWithoutRef<"button">, "children">
  * @extends LayoutUtilProps
+ * @extends DataTrackingId
  */
-export type ButtonProps = Omit<ComponentPropsWithoutRef<"button">, "children"> & LayoutUtilProps & {
+export type ButtonProps = Omit<ComponentPropsWithoutRef<"button">, "children"> & LayoutUtilProps & DataTrackingId & {
+    /**
+     * When `true` or an icon name, shows an AI indicator. With button text, any leading
+     * `icon` (plain Svg or `icon.before`) is not shown—the AI icon is used instead.
+     * On an icon-only button, `icon` is not shown—the AI icon is used instead.
+     * Icon-only usage must include an accessible name (for example `aria-label`).
+     * In development, a console warning is logged when `icon` is overridden.
+     */
+    aiMark?: boolean | AiIconName;
     /**
      * The visual variant of the button.
      * @default secondary
@@ -39,11 +50,7 @@ export type ButtonProps = Omit<ComponentPropsWithoutRef<"button">, "children"> &
      * The icon of the icon only button.
      */
     icon?: IconProps["svg"];
-}) & 
-/**
- * Data tracking id
- */
-DataTrackingId;
+});
 /**
  * Button component for triggering actions and user interactions.
  *
@@ -52,6 +59,7 @@ DataTrackingId;
  * - Four size options (xsmall, small, medium, large)
  * - Loading state with spinner animation
  * - Icon support (before, after, or icon-only)
+ * - Optional AI mark / named AI icons via `aiMark`
  * - Full accessibility support with ARIA attributes
  * - Supports layout utilities for positioning and spacing
  * - Automatic disabled state when loading

package/dist/components/Button/internal/buttonAiMarkUtils.d.ts

@@ -0,0 +1,18 @@
+import { IconProps } from '../../Icon';
+/**
+ * AI icon names for `Button` `aiMark`. `"mark"` (or boolean `true`) uses the animated AI mark;
+ * other values use static AI icons.
+ */
+export type AiIconName = "chat" | "edit" | "form" | "mark" | "mic" | "search";
+export declare const AI_ICON_MAP: Record<Exclude<AiIconName, "mark">, IconProps["svg"]>;
+export type ButtonAiMarkSize = "xsmall" | "small" | "medium" | "large";
+/**
+ * Icon-only AI icon container size (px). Medium/large match custom icon-only parity.
+ */
+export declare const ICON_ONLY_AI_SIZE_PX: Record<ButtonAiMarkSize, number>;
+export declare function iconHasLeadingSlot(icon: IconProps["svg"] | {
+    before: IconProps["svg"];
+} | {
+    after: IconProps["svg"];
+} | undefined): boolean;
+export declare function aiMarkShowsAnimatedMark(aiMark?: boolean | AiIconName): boolean;

package/dist/components/Button/internal/index.d.ts

@@ -0,0 +1 @@
+export { type AiIconName, type ButtonAiMarkSize, AI_ICON_MAP, ICON_ONLY_AI_SIZE_PX, aiMarkShowsAnimatedMark, iconHasLeadingSlot, } from './buttonAiMarkUtils';

package/dist/components/Card/Card.d.ts

@@ -20,9 +20,14 @@ export type CardProps = ComponentPropsWithoutRef<"div"> & LayoutUtilProps & {
 /**
  * Card component for displaying content in a contained, elevated container.
  *
+ * Features:
+ * - Optional background variants (strong, stronger)
+ * - Configurable padding sizes
+ * - Supports layout utilities for positioning and spacing
+ *
  * @example
  * <Card padding="large" background="strong">
- *   <h2>Card Title</h2>
+ *   <Text variant="headline" el="h2">Card Title</Text>
  *   <p>Card content goes here</p>
  * </Card>
  */

package/dist/components/Checkbox/Checkbox.d.ts

@@ -61,10 +61,12 @@ export declare const Checkbox: import('react').ForwardRefExoticComponent<Omit<Co
     Group: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement>, "ref"> & import('..').LayoutUtilProps & Omit<import('../../internal').FieldLabelProps, "labelProps"> & {
         required?: boolean;
         legend: string | import('react').ReactElement;
+        legendProps?: Omit<import('..').FieldLabelProps, "el">;
         error?: boolean | string | import('react').ReactElement | string[];
         errorAriaLive?: import('../../internal').HelperProps["errorAriaLive"];
         warning?: string | string[];
         description?: import('../../internal').HelperProps["description"];
         hint?: import('../../internal').HelperProps["hint"];
+        hideLabel?: boolean;
     } & import('react').RefAttributes<HTMLFieldSetElement>>;
 };

package/dist/components/Checkbox/CheckboxGroup.d.ts

@@ -1,14 +1,15 @@
 import { ComponentPropsWithoutRef, ReactElement } from 'react';
 import { LayoutUtilProps } from '../../types';
-import { FieldLabelProps } from '../../internal/types';
+import { FieldLabelProps as FieldLabelElementProps } from '../FieldLabel';
+import { FieldLabelProps as InternalFieldLabelProps } from '../../internal/types';
 import { HelperProps } from '../../internal/components';
 /**
  * Props for the CheckboxGroup component
  * @extends ComponentPropsWithoutRef<"fieldset">
  * @extends LayoutUtilProps
- * @extends Omit<FieldLabelProps, "labelProps">
+ * @extends Omit<InternalFieldLabelProps, "labelProps">
  */
-export type CheckboxGroupProps = ComponentPropsWithoutRef<"fieldset"> & LayoutUtilProps & Omit<FieldLabelProps, "labelProps"> & {
+export type CheckboxGroupProps = ComponentPropsWithoutRef<"fieldset"> & LayoutUtilProps & Omit<InternalFieldLabelProps, "labelProps"> & {
     /**
      * required flag for label
      * @accessibility This does not enforce error when nothing is selected.
@@ -16,9 +17,14 @@ export type CheckboxGroupProps = ComponentPropsWithoutRef<"fieldset"> & LayoutUt
      */
     required?: boolean;
     /**
-     * legend for the fieldset
+     * Legend for the fieldset.
+     * Passing `ReactNode` is deprecated — use a plain string with inline markdown instead.
      */
     legend: string | ReactElement;
+    /**
+     * Additional props for the legend `FieldLabel` (for example `aiMark`, `className`).
+     */
+    legendProps?: Omit<FieldLabelElementProps, "el">;
     /**
      * Error state for the field. Pass `true` to indicate error styling without a message.
      * Pass a string, string[], or ReactElement (deprecated) for error messages.
@@ -40,6 +46,11 @@ export type CheckboxGroupProps = ComponentPropsWithoutRef<"fieldset"> & LayoutUt
      * Hint text to display below the field.
      */
     hint?: HelperProps["hint"];
+    /**
+     * When `true`, hides the visual label row. The sr-only `<legend>` always remains for screen readers.
+     * @default false
+     */
+    hideLabel?: boolean;
 };
 /**
  * CheckboxGroup component for grouping related checkboxes together.
@@ -61,7 +72,7 @@ export type CheckboxGroupProps = ComponentPropsWithoutRef<"fieldset"> & LayoutUt
  *   <Checkbox label="Music" />
  * </CheckboxGroup>
  */
-export declare const CheckboxGroup: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement>, "ref"> & LayoutUtilProps & Omit<FieldLabelProps, "labelProps"> & {
+export declare const CheckboxGroup: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement>, "ref"> & LayoutUtilProps & Omit<InternalFieldLabelProps, "labelProps"> & {
     /**
      * required flag for label
      * @accessibility This does not enforce error when nothing is selected.
@@ -69,9 +80,14 @@ export declare const CheckboxGroup: import('react').ForwardRefExoticComponent<Om
      */
     required?: boolean;
     /**
-     * legend for the fieldset
+     * Legend for the fieldset.
+     * Passing `ReactNode` is deprecated — use a plain string with inline markdown instead.
      */
     legend: string | ReactElement;
+    /**
+     * Additional props for the legend `FieldLabel` (for example `aiMark`, `className`).
+     */
+    legendProps?: Omit<FieldLabelElementProps, "el">;
     /**
      * Error state for the field. Pass `true` to indicate error styling without a message.
      * Pass a string, string[], or ReactElement (deprecated) for error messages.
@@ -93,4 +109,9 @@ export declare const CheckboxGroup: import('react').ForwardRefExoticComponent<Om
      * Hint text to display below the field.
      */
     hint?: HelperProps["hint"];
+    /**
+     * When `true`, hides the visual label row. The sr-only `<legend>` always remains for screen readers.
+     * @default false
+     */
+    hideLabel?: boolean;
 } & import('react').RefAttributes<HTMLFieldSetElement>>;

package/dist/components/Chip/Chip.d.ts

@@ -2,11 +2,13 @@ import { ChipProps as CoreChipProps } from './internal/Chip';
 import { IconProps as CoreIconProps } from '../Icon';
 import { AvatarProps as CoreAvatarProps } from '../Avatar/internal/Avatar';
 import { DataTrackingId, DistributiveOmit } from '../../types';
+import { AiMarkBooleanProps } from '../../types/ai-marks';
 /**
  * Props for the Chip component
  * @property {string} label - The text that displays in the chip
  * @property {"small" | "medium"} [size] - The size of the chip
  * @property {string} [color] - Color of the Chip
+ * @property {boolean} [aiMark] - Whether to display an AI mark icon in the chip
  * @property {(e?: MouseEvent<HTMLSpanElement> | KeyboardEvent<HTMLSpanElement>) => void} [onClick] - Callback for when the Chip is clicked
  * @property {(e: MouseEvent<HTMLSpanElement> | KeyboardEvent<HTMLSpanElement>) => void} [onClose] - Called when the component is closed
  * @property {boolean} [textWrap] - Wraps text when it overflows
@@ -14,8 +16,9 @@ import { DataTrackingId, DistributiveOmit } from '../../types';
  * @property {string} [avatar] - Image URL to display in an avatar before the chip text.
  * @extends CoreChipProps
  * @extends DataTrackingId
+ * @extends AiMarkBooleanProps
  */
-export type ChipProps = DistributiveOmit<CoreChipProps, "prefix" | "avatar"> & DataTrackingId & ({
+export type ChipProps = DistributiveOmit<CoreChipProps, "prefix" | "avatar" | "suffix"> & DataTrackingId & AiMarkBooleanProps & ({
     icon?: CoreIconProps["svg"];
     avatar?: never;
 } | {
@@ -30,6 +33,9 @@ export type ChipProps = DistributiveOmit<CoreChipProps, "prefix" | "avatar"> & D
  * - Custom color support with automatic contrast calculation
  * - Optional click handler for interactive chips
  * - Optional close button for removable chips
+ * - Optional AI mark icon to indicate AI-generated content
+ * - Automatic AI mark type selection: gradient on default chips, inherited color on colored chips
+ * - AI mark on clickable chips (hover/focus morph temporarily disabled; see @TODO in source)
  * - Text wrapping support for long labels
  * - Full accessibility support with ARIA attributes
  * - Keyboard navigation (Enter/Space to click, Delete/Backspace to close)
@@ -45,5 +51,8 @@ export type ChipProps = DistributiveOmit<CoreChipProps, "prefix" | "avatar"> & D
  *   onClose={(e) => console.log('Chip removed')}
  *   onClick={(e) => console.log('Chip clicked')}
  * />
+ *
+ * @example
+ * <Chip label="AI Generated" aiMark />
  */
 export declare const Chip: import('react').ForwardRefExoticComponent<ChipProps & import('react').RefAttributes<HTMLSpanElement>>;

package/dist/components/Chip/internal/Chip.d.ts

@@ -27,6 +27,10 @@ export type ChipBaseProps = Omit<ComponentPropsWithoutRef<"span">, "prefix"> & O
      * Image URL to display in an avatar before the chip text.
      */
     avatar?: AvatarProps["image"];
+    /**
+     * Content displayed in the chip, after the text.
+     */
+    suffix?: ReactNode;
 };
 type ChipClickHandler = (e?: MouseEvent<HTMLSpanElement> | KeyboardEvent<HTMLSpanElement>) => void;
 type ChipCloseHandler = (e: MouseEvent<HTMLSpanElement> | KeyboardEvent<HTMLSpanElement>) => void;

package/dist/components/DateFieldRange/internal/MaskedDateRangeInput.d.ts

@@ -32,7 +32,7 @@ export type MaskedDateRangeInputRef = HTMLInputElement & {
  * @param props.endDate - The end date.
  * @param props.disableHint - Whether to disable the hint.
  */
-export declare const MaskedDateRangeInput: import('react').ForwardRefExoticComponent<Omit<TextFieldProps, "ref" | "value" | "onChange" | "prefix" | "hint" | "showCounter"> & {
+export declare const MaskedDateRangeInput: import('react').ForwardRefExoticComponent<Omit<TextFieldProps, "onChange" | "ref" | "value" | "prefix" | "hint" | "showCounter"> & {
     onChange: MaskedDateRangeInputChangeHandler;
     mode?: DateMode;
     startDate: DateTime | null;

package/dist/components/DateFieldRange/internal/useDateFieldRangeConversion.d.ts

@@ -20,7 +20,7 @@ export declare const useDateFieldRangeConversion: (props: DateFieldRangeProps) =
     maxDate: DateTime<boolean> | null | undefined;
     unavailable: {
         dates: DateTime<boolean>[] | undefined;
-        daysOfWeek: (3 | 1 | 6 | 2 | 4 | 5 | 7)[] | undefined;
+        daysOfWeek: (1 | 2 | 3 | 6 | 4 | 5 | 7)[] | undefined;
     };
     onChange: (change: Omit<DateFieldRangeChange, "startDate" | "endDate"> & {
         startDate: DateTime | null;

package/dist/components/DateFieldSingle/internal/MaskedDateInput.d.ts

@@ -27,7 +27,7 @@ export type MaskedDateInputRef = HTMLInputElement & {
  * @param props.onChange - The function to call when the date changes.
  * @param props.mode - The mode of the date input.
  */
-export declare const MaskedDateInput: import('react').ForwardRefExoticComponent<Omit<TextFieldProps, "ref" | "value" | "onChange" | "prefix" | "hint" | "showCounter"> & {
+export declare const MaskedDateInput: import('react').ForwardRefExoticComponent<Omit<TextFieldProps, "onChange" | "ref" | "value" | "prefix" | "hint" | "showCounter"> & {
     onChange: MaskedDateInputChangeHandler;
     mode?: DateMode;
     lastValidDate: DateTime | null;

package/dist/components/DateFieldYearless/DateFieldYearless.d.ts

@@ -51,7 +51,9 @@ export type DateFieldYearlessProps = Omit<ComponentPropsWithoutRef<"input">, "on
      */
     error?: boolean | string | ReactElement | string[];
     /**
-     * Label for the field
+     * Label for the field.
+     * Omitting `label` is deprecated — it will be required in v4.0.0. Use `hideLabel` to visually hide it.
+     * Passing `ReactNode` is deprecated — use a plain string with inline markdown instead.
      */
     label?: FieldLabelProps["children"];
     /**
@@ -90,6 +92,11 @@ export type DateFieldYearlessProps = Omit<ComponentPropsWithoutRef<"input">, "on
      * Whether to disable the format hint
      */
     disableHint?: boolean;
+    /**
+     * When `true`, hides the visible label and moves it to `aria-label` on the input.
+     * @default false
+     */
+    hideLabel?: boolean;
     /**
      * Function to call when the field is focused
      */

package/dist/components/DateFieldYearless/internal/YearlessDateInput.d.ts

@@ -38,7 +38,7 @@ export type YearlessDateInputRef = HTMLInputElement & {
  * @param props.onChange - The function to call when the date changes.
  * @param props.mode - The mode of the date input.
  */
-export declare const YearlessDateInput: import('react').ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "ref" | "value" | "onChange"> & {
+export declare const YearlessDateInput: import('react').ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "onChange" | "ref" | "size" | "value"> & {
     onChange: YearlessDateInputChangeHandler;
     mode?: YearlessDateMode;
     value?: YearlessDate | null;

package/dist/components/DateFieldYearless/internal/YearlessDateInputWithPicker.d.ts

@@ -69,7 +69,7 @@ export type YearlessDateInputWithPickerRef = {
     focus: () => void;
     setValue: (value: YearlessDate | null) => void;
 };
-export declare const YearlessDateInputWithPicker: import('react').ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "ref" | "value" | "onBlur" | "onFocus" | "onChange" | "defaultValue"> & {
+export declare const YearlessDateInputWithPicker: import('react').ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "onBlur" | "onFocus" | "onChange" | "ref" | "size" | "value" | "defaultValue"> & {
     /**
      * The controlled value of the date field
      */

package/dist/components/DateFieldYearlessRange/DateFieldYearlessRange.d.ts

@@ -46,7 +46,14 @@ export type DateFieldYearlessRangeProps = {
      * Pass a string, string[], or ReactElement (deprecated) for error messages.
      */
     error?: boolean | string | ReactElement | string[];
+    /**
+     * Label for the field group. Always required for accessibility.
+     */
     label: string;
+    /**
+     * When `true`, hides the visible legend while keeping it accessible to screen readers.
+     * @default false
+     */
     hideLabel?: boolean;
     size?: Extract<Size, "small" | "medium" | "large">;
     description?: HelperProps["description"];

package/dist/components/DrillDown/internal/DrillDownContext.d.ts

@@ -8,5 +8,9 @@ export type DrillDownContextProps = {
     setRegisteredIndices?: Dispatch<SetStateAction<number[] | undefined>>;
     onClose?: (() => void)[];
     setOnClose?: (fn: () => void, index: number) => void;
+    hostIsInteractive?: boolean;
+    setHostTrigger?: (element: HTMLElement | null) => void;
+    onHostClose?: () => void;
+    onHostClosed?: () => void;
 };
 export declare const DrillDownContext: import('react').Context<DrillDownContextProps | null>;

package/dist/components/DrillDown/internal/useDrillDownContextState.d.ts

@@ -10,5 +10,9 @@ export declare function useDrillDownContextState({ defaultDrillDownIndex, }: use
     setRegisteredIndices: import('react').Dispatch<import('react').SetStateAction<number[] | undefined>>;
     onClose: (() => void)[];
     setOnClose: (fn: () => void, index: number) => void;
+    hostIsInteractive: boolean;
+    setHostTrigger: (element: HTMLElement | null) => void;
+    onHostClose: () => void;
+    onHostClosed: () => void;
 };
 export {};

package/dist/components/FieldLabel/FieldLabel.d.ts

@@ -1,7 +1,8 @@
 import { ComponentPropsWithoutRef, ReactNode, ElementType, JSX, JSXElementConstructor } from 'react';
 import { TooltipProps } from '../Tooltip';
+import { AiMarkWithTooltipOrPopoverProps } from '../../types';
 type IntrinsicAttributes<E extends keyof JSX.IntrinsicElements | JSXElementConstructor<unknown>> = JSX.LibraryManagedAttributes<E, ComponentPropsWithoutRef<E>>;
-type FieldLabelOwnProps<E extends ElementType = ElementType> = {
+type FieldLabelOwnProps<E extends ElementType = ElementType> = AiMarkWithTooltipOrPopoverProps & {
     /** The HTML element to render */
     el?: E;
     /** Unique identifier for the label element */

package/dist/components/FieldLabel/internal/FieldLabelButton.d.ts

@@ -8,9 +8,10 @@ export type FieldLabelButtonProps = ComponentPropsWithoutRef<"button">;
  * Internal icon-button for use within FieldLabel.
  *
  * Features:
- * - Fixed 28×28px hit area with no visible border or background at rest
+ * - Default 28×28px hit area with no visible border or background at rest
+ * - Optional `field-label-button-scaled` + CSS vars for larger icons (e.g. AiMark xlarge)
  * - Hover and focus states show the secondary button hover background color on
- *   an inner 24×24px area, keeping 2px transparent on each side
+ *   an inner 24×24px area (or scaled inner), keeping 2px transparent on each side
  * - Focus ring matches the secondary button focus ring style
  * - Fully accessible as a native `<button>` element
  *

package/dist/components/NumberField/NumberField.d.ts

@@ -2,13 +2,30 @@ import { ReactElement, ComponentPropsWithoutRef } from 'react';
 import { HelperProps } from '../../internal/components';
 import { LayoutUtilProps, Size, DataTrackingId } from '../../types';
 import { FieldLabelProps } from '../../internal/types';
+/**
+ * Props for the NumberField component.
+ * @extends Omit<ComponentPropsWithoutRef<"input">, "size" | "prefix" | "type" | "inputMode" | "value" | "defaultValue" | "onFocus" | "onBlur" | "onChange">
+ * @extends LayoutUtilProps
+ * @extends FieldLabelProps
+ * @extends DataTrackingId
+ */
 export type NumberFieldProps = Omit<ComponentPropsWithoutRef<"input">, "size" | "prefix" | "type" | "inputMode" | "value" | "defaultValue" | "onFocus" | "onBlur" | "onChange"> & LayoutUtilProps & FieldLabelProps & {
     /**
      * Error state for the field. Pass `true` to indicate error styling without a message.
      * Pass a string, string[], or ReactElement (deprecated) for error messages.
      */
     error?: boolean | string | ReactElement | string[];
+    /**
+     * Label for the field.
+     * Omitting `label` is deprecated — it will be required in v4.0.0. Use `hideLabel` to visually hide it.
+     */
     label?: string;
+    /**
+     * When `true`, hides the visible label and moves it to `aria-label` on the input.
+     * Requires `label` to be set — the label is always needed for accessibility.
+     * @default false
+     */
+    hideLabel?: boolean;
     prefix?: string;
     suffix?: string;
     size?: Extract<Size, "small" | "medium" | "large">;
@@ -36,15 +53,25 @@ export type NumberFieldProps = Omit<ComponentPropsWithoutRef<"input">, "size" |
     onBlur?: (event: React.FocusEvent) => void;
     hideControls?: boolean;
 } & DataTrackingId;
-export declare const NumberField: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "size" | "value" | "onBlur" | "onFocus" | "onChange" | "defaultValue" | "prefix" | "inputMode" | "type"> & LayoutUtilProps & Pick<import('../../internal').LabelProps, "required" | "moreInfo"> & {
-    labelProps?: Omit<import('../../internal').LabelProps, "children" | "moreInfo" | "required" | "id" | "htmlFor">;
+export declare const NumberField: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "onBlur" | "onFocus" | "onChange" | "size" | "value" | "defaultValue" | "prefix" | "inputMode" | "type"> & LayoutUtilProps & Pick<import('../../internal').LabelProps, "required" | "moreInfo"> & {
+    labelProps?: Omit<import('../../internal').LabelProps, "children" | "moreInfo" | "required" | "id" | "htmlFor"> & import('../..').AiMarkWithTooltipOrPopoverProps;
 } & {
     /**
      * Error state for the field. Pass `true` to indicate error styling without a message.
      * Pass a string, string[], or ReactElement (deprecated) for error messages.
      */
     error?: boolean | string | ReactElement | string[];
+    /**
+     * Label for the field.
+     * Omitting `label` is deprecated — it will be required in v4.0.0. Use `hideLabel` to visually hide it.
+     */
     label?: string;
+    /**
+     * When `true`, hides the visible label and moves it to `aria-label` on the input.
+     * Requires `label` to be set — the label is always needed for accessibility.
+     * @default false
+     */
+    hideLabel?: boolean;
     prefix?: string;
     suffix?: string;
     size?: Extract<Size, "small" | "medium" | "large">;

package/dist/components/Radio/Radio.d.ts

@@ -90,6 +90,8 @@ export declare const Radio: import('react').ForwardRefExoticComponent<Omit<CoreR
     Group: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement>, "ref"> & import('..').LayoutUtilProps & Omit<import('../../internal').FieldLabelProps, "labelProps"> & {
         required?: boolean;
         legend: string | import('react').ReactElement;
+        legendProps?: Omit<import('..').FieldLabelProps, "el">;
+        hideLabel?: boolean;
         error?: boolean | string | import('react').ReactElement | string[];
         errorAriaLive?: import('../../internal').HelperProps["errorAriaLive"];
         warning?: string | string[];