@servicetitan/anvil2 2.0.3 → 2.1.0

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

@@ -20,14 +20,18 @@ export type CheckboxGroupProps = ComponentPropsWithoutRef<"fieldset"> & LayoutUt
      */
     legend: string | ReactElement;
     /**
-     * Error state for the field. Can be a boolean, string message, or ReactElement.
-     * When truthy, displays error styling and message.
+     * 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?: HelperProps["errorMessage"] | boolean;
+    error?: boolean | string | ReactElement | string[];
     /**
-     * ARIA live region setting for error announcements
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
      */
     errorAriaLive?: HelperProps["errorAriaLive"];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
     /**
      * Description text to display below the field.
      */
@@ -69,14 +73,18 @@ export declare const CheckboxGroup: import('react').ForwardRefExoticComponent<Om
      */
     legend: string | ReactElement;
     /**
-     * Error state for the field. Can be a boolean, string message, or ReactElement.
-     * When truthy, displays error styling and message.
+     * 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?: HelperProps["errorMessage"] | boolean;
+    error?: boolean | string | ReactElement | string[];
     /**
-     * ARIA live region setting for error announcements
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
      */
     errorAriaLive?: HelperProps["errorAriaLive"];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
     /**
      * Description text to display below the field.
      */

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

@@ -80,7 +80,7 @@ export type CheckboxProps = LayoutUtilProps & Omit<ComponentPropsWithoutRef<"inp
  *   required
  * />
  */
-export declare const Checkbox: import('react').ForwardRefExoticComponent<LayoutUtilProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "onChange" | "indeterminate" | "onClick"> & {
+export declare const Checkbox: import('react').ForwardRefExoticComponent<LayoutUtilProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "onChange" | "onClick" | "indeterminate"> & {
     /**
      * Controlled state
      * @default false

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

@@ -1,4 +1,15 @@
 import { DateTime } from 'luxon';
+/**
+ * Converts a JS Date (created with local timezone midnight) to a UTC Luxon DateTime
+ * preserving the local date components (year, month, day).
+ *
+ * This is necessary because maskitoParseDate creates Date objects using
+ * `new Date(year, month, day)` which produces midnight in the local timezone.
+ * Directly using DateTime.fromJSDate with zone: "utc" can shift the *calendar day*
+ * for timezones where local midnight falls on a different UTC date (typically
+ * positive-offset zones), which would change the intended date.
+ */
+export declare function jsDateToUtcDateTime(jsDate: Date): DateTime;
 export declare function convertStringToDate(v: string | null | undefined): DateTime | null | undefined;
 export declare function validateDate({ date, constraints, }: {
     date: DateTime | null;

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

@@ -46,9 +46,10 @@ export type DateFieldYearlessProps = Omit<ComponentPropsWithoutRef<"input">, "on
      */
     disablePicker?: boolean;
     /**
-     * Error state or error message
+     * 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?: ReactElement | string | boolean;
+    error?: boolean | string | ReactElement | string[];
     /**
      * Label for the field
      */
@@ -62,9 +63,13 @@ export type DateFieldYearlessProps = Omit<ComponentPropsWithoutRef<"input">, "on
      */
     description?: HelperProps["description"];
     /**
-     * Error aria-live setting
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
      */
     errorAriaLive?: HelperProps["errorAriaLive"];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
     /**
      * Size of the input
      */

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

@@ -41,12 +41,23 @@ export type DateFieldYearlessRangeProps = {
      * Whether to disable the hint
      */
     disableHint?: boolean;
-    error?: ReactElement | string | 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.
+     */
+    error?: boolean | string | ReactElement | string[];
     label: string;
     hideLabel?: boolean;
     size?: Extract<Size, "small" | "medium" | "large">;
     description?: HelperProps["description"];
+    /**
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
+     */
     errorAriaLive?: HelperProps["errorAriaLive"];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
     disabled?: boolean;
     onFocus?: (event: React.FocusEvent) => void;
     onBlur?: (event: React.FocusEvent) => void;

package/dist/components/DaysOfTheWeek/DaysOfTheWeek.d.ts

@@ -36,12 +36,19 @@ export type DaysOfTheWeekProps = {
      */
     description?: ReactElement | string;
     /**
-     * Error message to display when there is an error
+     * Error message(s) to display. Supports a single string or an array of strings.
+     */
+    error?: string | string[];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
+    /**
+     * @deprecated Use the `error` prop instead.
      */
     errorMessage?: ReactElement | string;
     /**
-     * aria-live for the error message
-     * @default assertive
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
      */
     errorAriaLive?: AriaAttributes["aria-live"];
     /**
@@ -115,12 +122,19 @@ export declare const DaysOfTheWeek: import('react').ForwardRefExoticComponent<{
      */
     description?: ReactElement | string;
     /**
-     * Error message to display when there is an error
+     * Error message(s) to display. Supports a single string or an array of strings.
+     */
+    error?: string | string[];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
+    /**
+     * @deprecated Use the `error` prop instead.
      */
     errorMessage?: ReactElement | string;
     /**
-     * aria-live for the error message
-     * @default assertive
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
      */
     errorAriaLive?: AriaAttributes["aria-live"];
     /**

package/dist/components/Dialog/internal/useInitialFocus.d.ts

@@ -12,4 +12,8 @@ export type InitialFocusOptions = {
  * @param options - Options for the hook
  * @param options.computeFocus - Function to pick the initial focus target, given an array of focusable elements
  */
-export declare const useInitialFocus: (dialogRef: RefObject<HTMLDialogElement>, { computeFocus }: InitialFocusOptions) => void;
+export declare const useInitialFocus: (
+/**
+ * Ref to the dialog element
+ */
+dialogRef: RefObject<HTMLDialogElement>, { computeFocus }: InitialFocusOptions) => void;

package/dist/components/FieldMessage/FieldMessage.d.ts

@@ -9,44 +9,53 @@ export type FieldMessageProps = ComponentPropsWithoutRef<"div"> & {
      */
     id?: string;
     /**
-     * Hint text or element to display when there's no error.
+     * Hint text or element to display. Always visible regardless of error or warning state.
      */
     hint?: ReactElement | string;
     /**
-     * Description text or element to display below the main message.
+     * Description text or element to display below the hint.
      */
     description?: ReactElement | string;
+    /**
+     * Error message(s) to display. Supports a single string, an array of strings,
+     * or a ReactElement (deprecated).
+     * All error messages use `aria-live="assertive"`.
+     */
+    error?: string | string[] | ReactElement;
+    /**
+     * Warning message(s) to display. Supports a single string, an array of strings,
+     * or a ReactElement (deprecated).
+     * All warning messages use `aria-live="polite"`.
+     */
+    warning?: string | string[] | ReactElement;
     /**
      * Error message or element to display when there's an error.
+     * @deprecated Use the `error` prop instead.
      */
     errorMessage?: ReactElement | string;
     /**
-     * aria-live attribute value for the error message.
-     * @default assertive
-     * @remarks Controls how screen readers announce error messages. "assertive" interrupts current speech, "polite" waits for current speech to finish.
-     * @link https://www.w3.org/WAI/tutorials/forms/notifications/
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
      */
     errorAriaLive?: AriaAttributes["aria-live"];
 };
 /**
- * FieldMessage component for displaying hints, descriptions, and error messages for form fields.
+ * FieldMessage component for displaying hints, descriptions, error messages, and warning messages for form fields.
  *
  * Features:
- * - Displays hint text when no error is present
- * - Shows error messages with warning icon when errors occur
+ * - Displays hint text that remains visible regardless of error or warning state
+ * - Shows one or more error messages with error icon (aria-live="assertive")
+ * - Shows one or more warning messages with warning icon (aria-live="polite")
  * - Supports both string and React element content
- * - Configurable aria-live behavior for screen readers
  * - Optional description text for additional context
  * - Accessible with proper ARIA attributes
- * - Visual error indicators with warning icons
- * - Conditional rendering based on error state
- * - Supports layout utilities for positioning and spacing
+ * - Visual error and warning indicators with status icons
  *
  * @example
  * <FieldMessage
  *   hint="Enter your email address"
  *   description="We'll use this to send you updates"
- *   errorMessage="Please enter a valid email address"
+ *   error="Please enter a valid email address"
+ *   warning="This email is associated with another account"
  * />
  */
 export declare const FieldMessage: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
@@ -55,22 +64,32 @@ export declare const FieldMessage: import('react').ForwardRefExoticComponent<Omi
      */
     id?: string;
     /**
-     * Hint text or element to display when there's no error.
+     * Hint text or element to display. Always visible regardless of error or warning state.
      */
     hint?: ReactElement | string;
     /**
-     * Description text or element to display below the main message.
+     * Description text or element to display below the hint.
      */
     description?: ReactElement | string;
+    /**
+     * Error message(s) to display. Supports a single string, an array of strings,
+     * or a ReactElement (deprecated).
+     * All error messages use `aria-live="assertive"`.
+     */
+    error?: string | string[] | ReactElement;
+    /**
+     * Warning message(s) to display. Supports a single string, an array of strings,
+     * or a ReactElement (deprecated).
+     * All warning messages use `aria-live="polite"`.
+     */
+    warning?: string | string[] | ReactElement;
     /**
      * Error message or element to display when there's an error.
+     * @deprecated Use the `error` prop instead.
      */
     errorMessage?: ReactElement | string;
     /**
-     * aria-live attribute value for the error message.
-     * @default assertive
-     * @remarks Controls how screen readers announce error messages. "assertive" interrupts current speech, "polite" waits for current speech to finish.
-     * @link https://www.w3.org/WAI/tutorials/forms/notifications/
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
      */
     errorAriaLive?: AriaAttributes["aria-live"];
 } & import('react').RefAttributes<HTMLDivElement>>;

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

@@ -1,2 +1,3 @@
 export * from './FieldMessage';
 export { FieldMessage as default } from './FieldMessage';
+export { warnDeprecatedErrorUsage } from './utils';

package/dist/components/FieldMessage/utils.d.ts

@@ -0,0 +1,7 @@
+import { ReactElement } from 'react';
+/**
+ * Logs a dev-only deprecation warning when `error` is passed as a `ReactElement`.
+ * String values are the preferred type and are NOT deprecated.
+ * Should be called in consumer components that accept the union `error` prop.
+ */
+export declare function warnDeprecatedErrorUsage(componentName: string, error: ReactElement | string | boolean | string[] | undefined): void;

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

@@ -3,14 +3,25 @@ import { HelperProps } from '../../internal/components';
 import { LayoutUtilProps, Size, DataTrackingId } from '../../types';
 import { FieldLabelProps } from '../../internal/types';
 export type NumberFieldProps = Omit<ComponentPropsWithoutRef<"input">, "size" | "prefix" | "type" | "inputMode" | "value" | "defaultValue" | "onFocus" | "onBlur" | "onChange"> & LayoutUtilProps & FieldLabelProps & {
-    error?: ReactElement | string | 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.
+     */
+    error?: boolean | string | ReactElement | string[];
     label?: string;
     prefix?: string;
     suffix?: string;
     size?: Extract<Size, "small" | "medium" | "large">;
     description?: HelperProps["description"];
+    /**
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
+     */
     errorAriaLive?: HelperProps["errorAriaLive"];
     hint?: HelperProps["hint"];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
     loading?: boolean;
     disabled?: boolean;
     minValue?: number;
@@ -28,14 +39,25 @@ export type NumberFieldProps = Omit<ComponentPropsWithoutRef<"input">, "size" |
 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">;
 } & {
-    error?: ReactElement | string | 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.
+     */
+    error?: boolean | string | ReactElement | string[];
     label?: string;
     prefix?: string;
     suffix?: string;
     size?: Extract<Size, "small" | "medium" | "large">;
     description?: HelperProps["description"];
+    /**
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
+     */
     errorAriaLive?: HelperProps["errorAriaLive"];
     hint?: HelperProps["hint"];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
     loading?: boolean;
     disabled?: boolean;
     minValue?: number;

package/dist/components/Page/Page.d.ts

@@ -138,9 +138,9 @@ export declare const Page: import('react').ForwardRefExoticComponent<Omit<import
                 label: string;
             })[];
         };
-        preferenceAction?: (Omit<import('..').ButtonProps, "size" | "className" | "aria-label" | "icon" | "appearance"> & {
+        preferenceAction?: (Omit<import('..').ButtonProps, "size" | "className" | "aria-label" | "appearance" | "icon"> & {
             "aria-label": string;
-        }) | (Omit<import('..').ButtonLinkProps, "size" | "className" | "aria-label" | "icon" | "appearance"> & {
+        }) | (Omit<import('..').ButtonLinkProps, "size" | "className" | "aria-label" | "appearance" | "icon"> & {
             "aria-label": string;
         });
         layout?: import('..').LayoutProps;

package/dist/components/ProgressBar/ProgressBar.d.ts

@@ -9,14 +9,19 @@ import { LayoutUtilProps } from '../../types';
  */
 export type ProgressBarProps = Omit<ComponentPropsWithoutRef<"progress">, "value"> & LayoutUtilProps & {
     /**
-     * Error state or error message to display
+     * Error state for the field. Pass `true` to indicate error styling without a message.
+     * Pass a string, string[], or ReactElement (deprecated) for error messages.
      * @default false
      */
-    error?: ReactElement | string | boolean;
+    error?: boolean | string | ReactElement | string[];
     /**
-     * ARIA live region setting for error announcements
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
      */
     errorAriaLive?: HelperProps["errorAriaLive"];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
     /**
      * Description text to display below the progress bar
      */

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

@@ -90,8 +90,9 @@ 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;
-        error?: import('../../internal').HelperProps["errorMessage"] | boolean;
+        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"];
     } & import('react').RefAttributes<HTMLFieldSetElement>>;

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

@@ -19,14 +19,18 @@ export type RadioGroupProps = ComponentPropsWithoutRef<"fieldset"> & LayoutUtilP
      */
     legend: string | ReactElement;
     /**
-     * Error state for the field. Can be a boolean, string message, or ReactElement.
-     * When truthy, displays error styling and message.
+     * 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?: HelperProps["errorMessage"] | boolean;
+    error?: boolean | string | ReactElement | string[];
     /**
-     * ARIA live region setting for error announcements
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
      */
     errorAriaLive?: HelperProps["errorAriaLive"];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
     /**
      * Description text to display below the field.
      */
@@ -77,14 +81,18 @@ export declare const RadioGroup: import('react').ForwardRefExoticComponent<Omit<
      */
     legend: string | ReactElement;
     /**
-     * Error state for the field. Can be a boolean, string message, or ReactElement.
-     * When truthy, displays error styling and message.
+     * 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?: HelperProps["errorMessage"] | boolean;
+    error?: boolean | string | ReactElement | string[];
     /**
-     * ARIA live region setting for error announcements
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
      */
     errorAriaLive?: HelperProps["errorAriaLive"];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
     /**
      * Description text to display below the field.
      */

package/dist/components/SelectTrigger/internal/SelectTriggerBase.d.ts

@@ -36,5 +36,5 @@ export type SelectTriggerBaseProps<Item = unknown> = DistributiveOmit<TextFieldP
 } & {
     prefix?: string | ReactNode;
 };
-export declare const SelectTriggerBase: <Item>({ className, label, size, error, hint, description, prefix, suffix, maxRows, selectedItemProps, disabled, readOnly, disableClearSelection, itemToString: itemToStringProp, selectedItem, selectedItems, removeSelectedItem, inputValue, referenceRef, variant, onClearButtonClick, labelProps, inputWrapperProps, toggleButtonProps, inputProps, chipProps, placeholder, ...rest }: SelectTriggerBaseProps<Item>) => import("react/jsx-runtime").JSX.Element;
+export declare const SelectTriggerBase: <Item>({ className, label, size, error, hint, description, prefix, suffix, maxRows, selectedItemProps, disabled, readOnly, disableClearSelection, itemToString: itemToStringProp, selectedItem, selectedItems, removeSelectedItem, inputValue, referenceRef, variant, onClearButtonClick, labelProps, inputWrapperProps, toggleButtonProps, inputProps, chipProps, warning, placeholder, ...rest }: SelectTriggerBaseProps<Item>) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/Stepper/Stepper.d.ts

@@ -7,7 +7,9 @@ import { LayoutUtilProps } from '../../types';
  */
 export type StepperProps = Omit<ComponentPropsWithoutRef<"div">, "onAnimationStart" | "onDragStart" | "onDragEnd" | "onDrag" | "onChange"> & LayoutUtilProps & {
     /**
-     * Default step to start on.
+     * Default step to start on (0-based index).
+     * To start in the completed state (showing FinalPanel with all steps marked complete),
+     * set this to the total number of steps (e.g. `items.length`).
      * @default undefined
      */
     defaultIndex?: number;
@@ -80,7 +82,9 @@ export type StepperProps = Omit<ComponentPropsWithoutRef<"div">, "onAnimationSta
  */
 export declare const Stepper: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "onChange" | "onDrag" | "onDragEnd" | "onDragStart" | "onAnimationStart"> & LayoutUtilProps & {
     /**
-     * Default step to start on.
+     * Default step to start on (0-based index).
+     * To start in the completed state (showing FinalPanel with all steps marked complete),
+     * set this to the total number of steps (e.g. `items.length`).
      * @default undefined
      */
     defaultIndex?: number;

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

@@ -3,15 +3,26 @@ import { DataTrackingId, LayoutUtilProps, Size, MaxLengthCounterProps } from '..
 import { HelperProps } from '../../../internal/components';
 import { FieldLabelProps } from '../../FieldLabel';
 export type TextFieldProps = Omit<ComponentPropsWithoutRef<"input">, "size" | "prefix"> & LayoutUtilProps & {
-    error?: ReactElement | string | 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.
+     */
+    error?: boolean | string | ReactElement | string[];
     label?: FieldLabelProps["children"];
     prefix?: string | ReactElement;
     suffix?: string | ReactElement;
     size?: Extract<Size, "small" | "medium" | "large">;
     type?: "text" | "email" | "tel" | "url" | "password" | "number";
     description?: HelperProps["description"];
+    /**
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
+     */
     errorAriaLive?: HelperProps["errorAriaLive"];
     hint?: HelperProps["hint"];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
     loading?: boolean;
     disabled?: boolean;
     labelProps?: FieldLabelProps;

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

@@ -8,11 +8,10 @@ import { TextareaAutosizeConditionalProps, TextareaState } from './types';
  */
 export type TextareaProps = Omit<ComponentPropsWithoutRef<"textarea">, "onChange"> & LayoutUtilProps & DataTrackingId & MaxLengthCounterProps & TextareaAutosizeConditionalProps & Pick<FieldLabelProps, "moreInfo" | "moreInfoOpen"> & {
     /**
-     * Sets error style on textarea.
-     * If string or ReactElement provided, places it under the label and sets error style.
-     * Note: error string replaces helpText over, if both present.
+     * 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?: HelperProps["errorMessage"] | boolean;
+    error?: boolean | string | ReactElement | string[];
     /**
      * Hint text displayed below the textarea
      */
@@ -43,9 +42,13 @@ export type TextareaProps = Omit<ComponentPropsWithoutRef<"textarea">, "onChange
     labelProps?: FieldLabelProps;
 } & {
     /**
-     * ARIA live region setting for error announcements
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
      */
     errorAriaLive?: HelperProps["errorAriaLive"];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
 };
 /**
  * Textarea component for multi-line text input with advanced features.