@servicetitan/anvil2 2.7.1 → 2.8.0

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/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[];

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

@@ -1,23 +1,34 @@
 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 RadioGroup component
  * @extends ComponentPropsWithoutRef<"fieldset">
  * @extends LayoutUtilProps
- * @extends Omit<FieldLabelProps, "labelProps">
+ * @extends Omit<InternalFieldLabelProps, "labelProps">
  */
-export type RadioGroupProps = ComponentPropsWithoutRef<"fieldset"> & LayoutUtilProps & Omit<FieldLabelProps, "labelProps"> & {
+export type RadioGroupProps = ComponentPropsWithoutRef<"fieldset"> & LayoutUtilProps & Omit<InternalFieldLabelProps, "labelProps"> & {
     /**
      * Required flag for label
      * @remarks This does not enforce error when nothing is selected
      */
     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">;
+    /**
+     * When `true`, hides the visual label row. The sr-only `<legend>` always remains for AT.
+     * @default false
+     */
+    hideLabel?: boolean;
     /**
      * Error state for the field. Pass `true` to indicate error styling without a message.
      * Pass a string, string[], or ReactElement (deprecated) for error messages.
@@ -70,16 +81,26 @@ export type RadioGroupProps = ComponentPropsWithoutRef<"fieldset"> & LayoutUtilP
  *   <Radio label="No" value="no" />
  * </RadioGroup>
  */
-export declare const RadioGroup: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement>, "ref"> & LayoutUtilProps & Omit<FieldLabelProps, "labelProps"> & {
+export declare const RadioGroup: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement>, "ref"> & LayoutUtilProps & Omit<InternalFieldLabelProps, "labelProps"> & {
     /**
      * Required flag for label
      * @remarks This does not enforce error when nothing is selected
      */
     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">;
+    /**
+     * When `true`, hides the visual label row. The sr-only `<legend>` always remains for AT.
+     * @default false
+     */
+    hideLabel?: boolean;
     /**
      * Error state for the field. Pass `true` to indicate error styling without a message.
      * Pass a string, string[], or ReactElement (deprecated) for error messages.

package/dist/components/SelectCard/SelectCard.d.ts

@@ -15,7 +15,7 @@ export interface SelectCardProps extends Omit<CardProps, "onChange" | "id"> {
      */
     checked?: boolean;
     /**
-     * Uncontrolled state.
+     * Uncontrolled initial state. Ignored when inside a `SelectCard.Group` that sets `defaultValue`.
      */
     defaultChecked?: boolean;
     /**

package/dist/components/SelectCard/SelectCardGroup.d.ts

@@ -5,16 +5,26 @@ import { ISelectCardContext } from './internal/SelectCardContext';
  * Props for the SelectCardGroup component
  * @extends Omit<ISelectCardContext, "radioName" | "selection">
  */
-export interface SelectCardGroupProps extends Omit<ISelectCardContext, "radioName" | "selection"> {
+export interface SelectCardGroupProps extends Omit<ISelectCardContext, "radioName" | "selection">, Pick<CheckboxGroupProps, "moreInfo"> {
     /**
      * Associates the legend with content below.
      */
     ariaLabelledBy?: string;
     children?: ReactNode;
+    /**
+     * Initial selection state for uncontrolled usage.
+     * Array of `SelectCard` ids that are selected on first render.
+     * Takes precedence over individual `SelectCard` `defaultChecked` props.
+     */
+    defaultValue?: Array<string | number>;
     /**
      * Sets the legend on the group.
      */
     legend: CheckboxGroupProps["legend"];
+    /**
+     * Additional props for the legend `FieldLabel` (for example `aiMark`, `className`).
+     */
+    legendProps?: CheckboxGroupProps["legendProps"];
     /**
      * When `true`, sets "required" text in label.
      * @accessibility This does not enforce error when nothing is selected.
@@ -27,6 +37,11 @@ export interface SelectCardGroupProps extends Omit<ISelectCardContext, "radioNam
      * @default false
      */
     showSelectIndicator?: boolean;
+    /**
+     * Controlled selection state. When provided, the group becomes controlled.
+     * Array of `SelectCard` ids that are currently selected.
+     */
+    value?: Array<string | number>;
 }
 /**
  * SelectCardGroup component for managing groups of selectable cards.
@@ -39,12 +54,14 @@ export interface SelectCardGroupProps extends Omit<ISelectCardContext, "radioNam
  * - Automatic radio button grouping for single selection
  * - Context provider for child SelectCard components
  * - Integrates with CheckboxGroup and RadioGroup for proper form semantics
+ * - Supports AI mark indicator
  *
  * @example
  * <SelectCardGroup
  *   legend="Choose your plan"
  *   selectionMode="single"
  *   onChange={(e, state) => console.log('Selection changed:', state)}
+ *   legendProps={{ aiMark: true }}
  * >
  *   <SelectCard id="basic" onChange={() => {}}>
  *     <Text variant="headline" size="small" el="h3">Basic Plan</Text>

package/dist/components/SelectCard/internal/SelectCardContext.d.ts

@@ -46,6 +46,17 @@ export interface ISelectCardContext {
      * Creates a set of ids that are selected.
      */
     selection: Set<string | number>;
+    /**
+     * When `true`, indicates that selection is controlled at the group level via the `value` prop.
+     * @default false
+     */
+    isGroupControlled?: boolean;
+    /**
+     * When `true`, the group was given a `defaultValue` and owns the initial selection state.
+     * Individual `SelectCard` mount syncs should be skipped to avoid overriding it.
+     * @default false
+     */
+    hasGroupDefault?: boolean;
     /**
      * When `true`, displays a checkbox or radio indicator in a separate column on the left side of the card.
      * The indicator type (checkbox or radio) is automatically determined by the selection mode from SelectCard.Group context.

package/dist/components/SelectCard/internal/SelectCardProvider.d.ts

@@ -6,6 +6,16 @@ import { ISelectCardContext } from './SelectCardContext';
  */
 interface ISelectCardProviderProps extends Omit<ISelectCardContext, "radioName" | "selection"> {
     children: ReactNode;
+    /**
+     * Controlled selection state. When provided, the group becomes controlled.
+     * Array of `SelectCard` ids that are currently selected.
+     */
+    value?: Array<string | number>;
+    /**
+     * Initial selection state for uncontrolled usage.
+     * Array of `SelectCard` ids that are selected on first render.
+     */
+    defaultValue?: Array<string | number>;
 }
 /**
  * SelectCardProvider component for managing selection state across SelectCard components.
@@ -27,5 +37,5 @@ interface ISelectCardProviderProps extends Omit<ISelectCardContext, "radioName"
  *   <SelectCard id="2" onChange={() => {}}>Option 2</SelectCard>
  * </SelectCardProvider>
  */
-export declare const SelectCardProvider: ({ children, onChange, selectionMode, showSelectIndicator, }: ISelectCardProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SelectCardProvider: ({ children, defaultValue, onChange, selectionMode, showSelectIndicator, value, }: ISelectCardProviderProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/Skeleton/SkeletonCircle.d.ts

@@ -11,6 +11,10 @@ export type SkeletonCircleProps = Omit<ComponentPropsWithoutRef<"div">, "childre
      * @default 32px
      */
     diameter?: string;
+    /**
+     * Enables the AI visual style with blue gradient colors.
+     */
+    ai?: boolean;
 };
 /**
  * SkeletonCircle component for displaying circular loading placeholders.
@@ -38,4 +42,8 @@ export declare const SkeletonCircle: import('react').ForwardRefExoticComponent<O
      * @default 32px
      */
     diameter?: string;
+    /**
+     * Enables the AI visual style with blue gradient colors.
+     */
+    ai?: boolean;
 } & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/Skeleton/SkeletonPill.d.ts

@@ -10,6 +10,10 @@ export type SkeletonPillProps = Omit<ComponentPropsWithoutRef<"div">, "children"
      * The width of the pill skeleton in CSS units.
      */
     width?: string;
+    /**
+     * Enables the AI visual style with blue gradient colors.
+     */
+    ai?: boolean;
 };
 /**
  * SkeletonPill component for displaying pill-shaped loading placeholders.
@@ -38,4 +42,8 @@ export declare const SkeletonPill: import('react').ForwardRefExoticComponent<Omi
      * The width of the pill skeleton in CSS units.
      */
     width?: string;
+    /**
+     * Enables the AI visual style with blue gradient colors.
+     */
+    ai?: boolean;
 } & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/Skeleton/SkeletonRectangle.d.ts

@@ -11,6 +11,10 @@ export type SkeletonRectangleProps = Omit<ComponentPropsWithoutRef<"div">, "chil
      * @default 56px
      */
     height?: string;
+    /**
+     * Enables the AI visual style with blue gradient colors.
+     */
+    ai?: boolean;
 };
 /**
  * SkeletonRectangle component for displaying rectangular loading placeholders.
@@ -39,4 +43,8 @@ export declare const SkeletonRectangle: import('react').ForwardRefExoticComponen
      * @default 56px
      */
     height?: string;
+    /**
+     * Enables the AI visual style with blue gradient colors.
+     */
+    ai?: boolean;
 } & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/Skeleton/SkeletonText.d.ts

@@ -5,7 +5,12 @@ import { LayoutUtilProps } from '../../types';
  * @extends Omit<ComponentPropsWithoutRef<"div">, "children">
  * @extends Omit<LayoutUtilProps, "flex" | "flexBasis" | "flexGrow" | "flexShrink">
  */
-export type SkeletonTextProps = Omit<ComponentPropsWithoutRef<"div">, "children"> & Omit<LayoutUtilProps, "flex" | "flexBasis" | "flexGrow" | "flexShrink"> & ({
+export type SkeletonTextProps = Omit<ComponentPropsWithoutRef<"div">, "children"> & Omit<LayoutUtilProps, "flex" | "flexBasis" | "flexGrow" | "flexShrink"> & {
+    /**
+     * Enables the AI visual style with blue gradient colors.
+     */
+    ai?: boolean;
+} & ({
     /**
      * Text variant for body text skeleton.
      * @default body

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

@@ -5,12 +5,15 @@ export * from './SkeletonText';
 export declare const Skeleton: {
     Circle: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children"> & Omit<import('..').LayoutUtilProps, "flex" | "flexGrow" | "flexShrink" | "flexBasis"> & {
         diameter?: string;
+        ai?: boolean;
     } & import('react').RefAttributes<HTMLDivElement>>;
     Pill: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children"> & Omit<import('..').LayoutUtilProps, "flex" | "flexGrow" | "flexShrink" | "flexBasis"> & {
         width?: string;
+        ai?: boolean;
     } & import('react').RefAttributes<HTMLDivElement>>;
     Rectangle: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children"> & Omit<import('..').LayoutUtilProps, "flex" | "flexGrow" | "flexShrink" | "flexBasis"> & {
         height?: string;
+        ai?: boolean;
     } & import('react').RefAttributes<HTMLDivElement>>;
     Text: import('react').ForwardRefExoticComponent<import('./SkeletonText').SkeletonTextProps & import('react').RefAttributes<HTMLDivElement>>;
 };

package/dist/components/Switch/Switch.d.ts

@@ -1,5 +1,5 @@
 import { ChangeEvent, ComponentPropsWithoutRef, ReactElement } from 'react';
-import { DataTrackingId, LayoutUtilProps } from '../../types';
+import { AiMarkWithTooltipOrPopoverProps, DataTrackingId, LayoutUtilProps } from '../../types';
 /**
  * State object returned by the Switch onChange callback
  */
@@ -30,6 +30,11 @@ export type SwitchProps = Omit<ComponentPropsWithoutRef<"input">, "onChange"> &
      * @remarks This should either be a string or have text content inside for accessibility
      */
     label?: ReactElement | string;
+    /**
+     * AI mark configuration to display next to the label.
+     * Can be a boolean to show a simple AI mark, or an object with tooltip/popover configuration.
+     */
+    labelAiMark?: AiMarkWithTooltipOrPopoverProps["aiMark"];
     /**
      * Description text to display below the label
      */
@@ -69,6 +74,11 @@ export declare const Switch: import('react').ForwardRefExoticComponent<Omit<Omit
      * @remarks This should either be a string or have text content inside for accessibility
      */
     label?: ReactElement | string;
+    /**
+     * AI mark configuration to display next to the label.
+     * Can be a boolean to show a simple AI mark, or an object with tooltip/popover configuration.
+     */
+    labelAiMark?: AiMarkWithTooltipOrPopoverProps["aiMark"];
     /**
      * Description text to display below the label
      */

package/dist/components/Text/types.d.ts

@@ -1,4 +1,5 @@
 import { ComponentPropsWithoutRef } from 'react';
+import { AiMarkWithTooltipOrPopoverConfig } from '../../types/ai-marks';
 import { LayoutUtilProps, Size } from '../../types';
 /**
  * Props for headline text variants
@@ -19,6 +20,11 @@ export type HeadlineProps<T extends "h1" | "h2" | "h3" | "h4" | "h5" | "h6"> = C
      * Set the wrapping element's tagname
      */
     el: T;
+    /**
+     * When set, renders the AI mark inline after the headline text.
+     * Use `true` for the sparkle only, or pass tooltip/popover configuration.
+     */
+    aiMark?: boolean | AiMarkWithTooltipOrPopoverConfig;
     inline?: never;
     subdued?: never;
 };
@@ -40,6 +46,7 @@ export type EyebrowProps = ComponentPropsWithoutRef<"span"> & LayoutUtilProps &
     el?: never;
     inline?: never;
     subdued?: never;
+    aiMark?: never;
 };
 /**
  * Props for body text variant
@@ -64,6 +71,7 @@ export type BodyTextProps = ComponentPropsWithoutRef<"p"> & LayoutUtilProps & {
     subdued?: boolean;
     inline?: never;
     el?: never;
+    aiMark?: never;
 };
 /**
  * Props for inline body text variant
@@ -90,4 +98,5 @@ export type BodyTextInlineProps = ComponentPropsWithoutRef<"span"> & LayoutUtilP
      */
     subdued?: boolean;
     el?: never;
+    aiMark?: never;
 };

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

@@ -8,6 +8,11 @@ export type TextFieldProps = Omit<ComponentPropsWithoutRef<"input">, "size" | "p
      * 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.
+     * Passing `ReactNode` is deprecated — use a plain string with inline markdown instead.
+     */
     label?: FieldLabelProps["children"];
     prefix?: string | ReactElement;
     suffix?: string | ReactElement;
@@ -27,5 +32,11 @@ export type TextFieldProps = Omit<ComponentPropsWithoutRef<"input">, "size" | "p
     disabled?: boolean;
     labelProps?: FieldLabelProps;
     moreInfo?: ReactNode;
+    /**
+     * 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;
 } & MaxLengthCounterProps & DataTrackingId;
 export declare const TextField: import('react').ForwardRefExoticComponent<TextFieldProps & import('react').RefAttributes<HTMLInputElement>>;

package/dist/components/Textarea/Textarea.d.ts

@@ -21,10 +21,17 @@ export type TextareaProps = Omit<ComponentPropsWithoutRef<"textarea">, "onChange
      */
     description?: ReactElement | string;
     /**
-     * Label for textarea is required
-     * @accessibility This should either be a string or have text content inside for accessibility
+     * Label for the textarea.
+     * 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?: string | ReactElement;
+    /**
+     * When `true`, hides the visible label and moves it to `aria-label` on the textarea.
+     * Requires `label` to be set — the label is always needed for accessibility.
+     * @default false
+     */
+    hideLabel?: boolean;
     /**
      * Sets textarea's element no user-controllable method for resizing
      * @default false

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

@@ -40,6 +40,11 @@ export type ToastProps = {
      * CSS class name for the toast element
      */
     toastClassName?: string;
+    /**
+     * When set, displays the AI mark inline after the toast title.
+     * Use `true` for the sparkle only, or pass tooltip/popover configuration.
+     */
+    aiMark?: AlertProps["aiMark"];
     /**
      * Unique identifier for the toast
      */

package/dist/components/Toast/toast.d.ts

@@ -1,6 +1,6 @@
 import { ToastUpdateProps } from './internal/types';
 import { ToastProps } from './internal/Toast';
-export type toastProps = Pick<ToastProps, "actions" | "containerClassName" | "duration" | "message" | "onClose" | "onDismiss" | "progress" | "title" | "toastClassName">;
+export type toastProps = Pick<ToastProps, "actions" | "aiMark" | "containerClassName" | "duration" | "message" | "onClose" | "onDismiss" | "progress" | "title" | "toastClassName">;
 /**
  * Use to run toast methods for adding, updating, and dismissing toasts.
  *

package/dist/components/Toolbar/Toolbar.d.ts

@@ -158,7 +158,8 @@ export declare const Toolbar: import('react').ForwardRefExoticComponent<Omit<imp
      *   onChange={(id) => setFont(id)}
      * />
      */
-    Select: import('react').ForwardRefExoticComponent<Omit<Omit<Omit<Omit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "children"> & LayoutUtilProps & {
+    Select: import('react').ForwardRefExoticComponent<Omit<Omit<Omit<Omit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "children"> & LayoutUtilProps & import('../..').DataTrackingId & {
+        aiMark?: boolean | import('..').AiIconName;
         appearance?: import('../..').ButtonAppearance;
         size?: Extract<import('../..').Size, "xsmall" | "small" | "medium" | "large">;
         loading?: boolean;
@@ -169,14 +170,15 @@ export declare const Toolbar: import('react').ForwardRefExoticComponent<Omit<imp
         } | {
             before: import('..').IconProps["svg"];
         };
-    } & import('../..').DataTrackingId & import('react').RefAttributes<HTMLButtonElement>, "ref"> | Omit<Omit<Omit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "children"> & LayoutUtilProps & {
+    } & import('react').RefAttributes<HTMLButtonElement>, "ref"> | Omit<Omit<Omit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "children"> & LayoutUtilProps & import('../..').DataTrackingId & {
+        aiMark?: boolean | import('..').AiIconName;
         appearance?: import('../..').ButtonAppearance;
         size?: Extract<import('../..').Size, "xsmall" | "small" | "medium" | "large">;
         loading?: boolean;
     } & {
         children?: never;
         icon?: import('..').IconProps["svg"];
-    } & import('../..').DataTrackingId & import('react').RefAttributes<HTMLButtonElement>, "ref">, "onChange" | "appearance"> & {
+    } & import('react').RefAttributes<HTMLButtonElement>, "ref">, "onChange" | "appearance"> & {
         appearance?: import('./types').ToolbarItemAppearance;
         onChange?: (optionId: string) => void;
         selected?: string;

package/dist/components/Toolbar/ToolbarSelect.d.ts

@@ -63,7 +63,8 @@ export type ToolbarSelectProps<T = Record<string, unknown>> = Omit<React.Compone
  *   accessibleLabel="Text color"
  * />
  */
-export declare const ToolbarSelect: import('react').ForwardRefExoticComponent<Omit<Omit<Omit<Omit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "children"> & import('..').LayoutUtilProps & {
+export declare const ToolbarSelect: import('react').ForwardRefExoticComponent<Omit<Omit<Omit<Omit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "children"> & import('..').LayoutUtilProps & DataTrackingId & {
+    aiMark?: boolean | import('..').AiIconName;
     appearance?: import('../..').ButtonAppearance;
     size?: Extract<import('../..').Size, "xsmall" | "small" | "medium" | "large">;
     loading?: boolean;
@@ -74,14 +75,15 @@ export declare const ToolbarSelect: import('react').ForwardRefExoticComponent<Om
     } | {
         before: import('..').IconProps["svg"];
     };
-} & DataTrackingId & import('react').RefAttributes<HTMLButtonElement>, "ref"> | Omit<Omit<Omit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "children"> & import('..').LayoutUtilProps & {
+} & import('react').RefAttributes<HTMLButtonElement>, "ref"> | Omit<Omit<Omit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "children"> & import('..').LayoutUtilProps & DataTrackingId & {
+    aiMark?: boolean | import('..').AiIconName;
     appearance?: import('../..').ButtonAppearance;
     size?: Extract<import('../..').Size, "xsmall" | "small" | "medium" | "large">;
     loading?: boolean;
 } & {
     children?: never;
     icon?: import('..').IconProps["svg"];
-} & DataTrackingId & import('react').RefAttributes<HTMLButtonElement>, "ref">, "onChange" | "appearance"> & {
+} & import('react').RefAttributes<HTMLButtonElement>, "ref">, "onChange" | "appearance"> & {
     /**
      * Visual appearance of the select button
      * @default ghost