@servicetitan/anvil2 3.14.0 → 3.15.0

package/dist/src/components/Calendar/internal/CalendarDay.d.ts

@@ -1,21 +1,11 @@
 import { ComponentPropsWithoutRef } from 'react';
 import { DateTime } from 'luxon';
 export type CalendarDayProps = ComponentPropsWithoutRef<"td"> & {
-    /**
-     * The date to display.
-     */
+    /** Luxon date used for labels, availability, and selection state. */
     date: DateTime;
 };
-/**
- * A component that displays a day in the calendar.
- *
- * @param props.date - The date to display.
- * @param props - The rest of the props for the td element.
- * @returns A component that displays a day in the calendar.
- */
+/** Calendar grid cell that manages pointer and keyboard date selection. */
 export declare const CalendarDay: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').TdHTMLAttributes<HTMLTableDataCellElement>, HTMLTableDataCellElement>, "ref"> & {
-    /**
-     * The date to display.
-     */
+    /** Luxon date used for labels, availability, and selection state. */
     date: DateTime;
 } & import('react').RefAttributes<HTMLTableCellElement>>;

package/dist/src/components/Calendar/internal/CalendarMonthSelection.d.ts

@@ -1,25 +1,11 @@
 import { DateTime } from 'luxon';
 import { ComponentPropsWithoutRef } from 'react';
 export type CalendarMonthSelectionProps = ComponentPropsWithoutRef<"div"> & {
-    /**
-     * The function to call when a month is selected.
-     *
-     * @param month - The month that is selected.
-     */
+    /** Called with a Luxon month number after selection. */
     onMonthSelection: (month: DateTime["month"]) => void;
 };
-/**
- * A component that displays a grid of month cards and allows the user to select a month.
- *
- * @param props.onMonthSelection - The function to call when a month is selected.
- * @param props - The rest of the props for the div wrapper.
- * @returns A component that displays a grid of month cards and allows the user to select a month.
- */
+/** Keyboard-navigable month picker for Calendar's active year. */
 export declare const CalendarMonthSelection: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
-    /**
-     * The function to call when a month is selected.
-     *
-     * @param month - The month that is selected.
-     */
+    /** Called with a Luxon month number after selection. */
     onMonthSelection: (month: DateTime["month"]) => void;
 } & import('react').RefAttributes<HTMLDivElement>>;

package/dist/src/components/Calendar/internal/CalendarWeek.d.ts

@@ -1,28 +1,15 @@
 import { ComponentPropsWithoutRef } from 'react';
 import { DateTime } from 'luxon';
 export type CalendarWeekProps = ComponentPropsWithoutRef<"tr"> & {
-    /**
-     * @deprecated This is overridden internally
-     */
+    /** @deprecated Ignored by the calendar row. */
     className?: ComponentPropsWithoutRef<"tr">["className"];
-    /**
-     * The dates for the week.
-     */
+    /** Seven dates rendered as Calendar day cells. */
     week: DateTime[];
 };
-/**
- * A component that displays a week in the calendar.
- *
- * @param props - The props for the tr element.
- * @returns A component that displays a week in the calendar.
- */
+/** Renders one week row in Calendar's month grid. */
 export declare const CalendarWeek: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLTableRowElement>, HTMLTableRowElement>, "ref"> & {
-    /**
-     * @deprecated This is overridden internally
-     */
+    /** @deprecated Ignored by the calendar row. */
     className?: ComponentPropsWithoutRef<"tr">["className"];
-    /**
-     * The dates for the week.
-     */
+    /** Seven dates rendered as Calendar day cells. */
     week: DateTime[];
 } & import('react').RefAttributes<HTMLTableRowElement>>;

package/dist/src/components/Calendar/internal/utils.d.ts

@@ -9,5 +9,6 @@ export declare const isBeyondMaxDate: (n: DateTime, maxDate: CalendarContextProp
 export declare const isValidDate: (n: DateTime | undefined, minDate: string | undefined, maxDate: string | undefined, unavailable: CalendarContextProps["unavailable"], timeZone: string) => boolean;
 export declare const normalizeDate: (date: string, defaultTimeZone: string) => DateTime<true> | DateTime<false>;
 export declare const toDateString: (date: DateTime<boolean>) => string | null;
+/** Starts, restarts, or completes a range with the selected date. */
 export declare function rangeUpdater(value: CalendarRangeContextProps["value"], newDate: DateTime, setValue: CalendarRangeContextProps["setValue"], onSelection: CalendarRangeContextProps["onSelection"]): void;
 export declare const getDateMetadata: (date: DateTime, dateMetadata: Map<string, string> | undefined) => string | undefined;

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

@@ -1,45 +1,21 @@
 import { ComponentPropsWithoutRef } from 'react';
 import { LayoutUtilProps, Size } from '../../types';
-/**
- * Props for the Card component
- * @extends ComponentPropsWithoutRef<"div">
- * @extends LayoutUtilProps
- */
 export type CardProps = ComponentPropsWithoutRef<"div"> & LayoutUtilProps & {
-    /**
-     * The background variant of the card.
-     * @default undefined
-     */
+    /** Stronger fill than the default surface. Omit for the default. */
     background?: "strong" | "stronger";
-    /**
-     * The padding size of the card.
-     * @default "medium"
-     */
+    /** Inset around children. Defaults to `medium`. */
     padding?: Extract<Size, "0" | "xsmall" | "small" | "medium" | "large">;
 };
 /**
- * Card component for displaying content in a self-contained, bordered and elevated container — a rounded surface, panel, or tile that groups related information such as a summary.
- *
- * Features:
- * - Optional background variants (strong, stronger)
- * - Configurable padding sizes
- * - Supports layout utilities for positioning and spacing
- *
- * @example
- * <Card padding="large" background="strong">
- *   <Text variant="headline" el="h2">Card Title</Text>
- *   <p>Card content goes here</p>
- * </Card>
+ * Bordered surface that sets one self-contained group apart from the page: a
+ * peer tile such as a KPI, a chart, or a group with no section heading above
+ * it. Not a page-section wrapper — structure pages with `Layout`, headings,
+ * and spacing, and never nest Cards. Renders `inline-flex`; set
+ * `flexDirection="column"` to stack children.
  */
 export declare const Card: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & LayoutUtilProps & {
-    /**
-     * The background variant of the card.
-     * @default undefined
-     */
+    /** Stronger fill than the default surface. Omit for the default. */
     background?: "strong" | "stronger";
-    /**
-     * The padding size of the card.
-     * @default "medium"
-     */
+    /** Inset around children. Defaults to `medium`. */
     padding?: Extract<Size, "0" | "xsmall" | "small" | "medium" | "large">;
 } & import('react').RefAttributes<HTMLDivElement>>;

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

@@ -1,63 +1,16 @@
 import { CheckboxProps as CoreCheckboxProps } from './internal/Checkbox';
 import { DataTrackingId } from '../../types';
 /**
- * Props for the Checkbox component
- * @property {boolean} [checked] - Controlled state
- * @property {boolean} [defaultChecked] - Uncontrolled state
- * @property {boolean} [indeterminate] - Indeterminate state of the checkbox
- * @property {boolean} [error] - Error state for the checkbox
- * @property {string | ReactElement} [label] - Label for checkbox
- * @property {string} [description] - Helper text description
- * @property {Object} [icons] - Icon overrides for different states
- * @property {(e?: ChangeEvent<HTMLInputElement>, state?: CheckboxState) => void} [onChange] - Change callback
- * @property {(e?: MouseEvent<HTMLInputElement>, state?: CheckboxState) => void} [onClick] - Click callback
  * @extends Omit<CoreCheckboxProps, "hideCheckbox">
  * @extends DataTrackingId
  */
 export type CheckboxProps = Omit<CoreCheckboxProps, "hideCheckbox"> & DataTrackingId;
 /**
- * Checkbox component: a checkbox input the user ticks on or off to select an option or agree to something; supports checked, unchecked, and indeterminate states.
- *
- * Features:
- * - Controlled and uncontrolled state management
- * - Indeterminate state for partial selections
- * - Customizable icons for different states
- * - Error state with accessibility support
- * - Optional helper text and descriptions
- * - Full accessibility support with ARIA attributes
- * - Keyboard navigation support
- * - Layout utility props for positioning and spacing
- * - Automatic tracking ID generation for analytics
- *
- * @example
- * <Checkbox
- *   label="Accept terms and conditions"
- *   onChange={(e, state) => console.log('Checked:', state.checked)}
- *   required
- * />
+ * Checkbox input with controlled or uncontrolled checked state and optional
+ * mixed-state presentation.
  */
 export declare const Checkbox: import('react').ForwardRefExoticComponent<Omit<CoreCheckboxProps, "hideCheckbox"> & DataTrackingId & import('react').RefAttributes<HTMLInputElement>> & {
-    /**
-     * CheckboxGroup component for grouping related checkboxes together.
-     *
-     * Features:
-     * - Groups multiple checkboxes with a common legend
-     * - Supports required field indication
-     * - Optional helper text and descriptions
-     * - Full accessibility support with fieldset/legend
-     * - Focus management for keyboard navigation
-     * - Layout utility props for positioning and spacing
-     * - Flexible layout direction (row/column)
-     * - Screen reader support with hidden labels
-     * - Automatic tracking ID generation for analytics
-     *
-     * @example
-     * <CheckboxGroup legend="Select your interests" required>
-     *   <Checkbox label="Technology" />
-     *   <Checkbox label="Sports" />
-     *   <Checkbox label="Music" />
-     * </CheckboxGroup>
-     */
+    /** Groups related checkboxes under a shared legend and error state. */
     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;

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

@@ -4,114 +4,70 @@ 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<InternalFieldLabelProps, "labelProps">
  */
 export type CheckboxGroupProps = ComponentPropsWithoutRef<"fieldset"> & LayoutUtilProps & Omit<InternalFieldLabelProps, "labelProps"> & {
-    /**
-     * required flag for label
-     * @accessibility This does not enforce error when nothing is selected.
-     * @default false
-     */
+    /** Shows the required indicator but does not validate selection. */
     required?: boolean;
     /**
      * Legend for the fieldset.
-     * Passing `ReactNode` is deprecated — use a plain string with inline markdown instead.
+     * Passing a React element is deprecated; use a string with inline markdown.
      */
     legend: string | ReactElement;
-    /**
-     * Additional props for the legend `FieldLabel` (for example `aiMark`, `className`).
-     */
+    /** Props for the visible {@link FieldLabel}, except its root element. */
     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.
+     * Error styling for every child. A message value also renders below the
+     * group; React elements are deprecated.
      */
     error?: boolean | string | ReactElement | string[];
     /**
      * @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 copy rendered below the group. */
     warning?: string | string[];
-    /**
-     * Description text to display below the field.
-     */
+    /** Secondary copy rendered below the group. */
     description?: HelperProps["description"];
-    /**
-     * Hint text to display below the field.
-     */
+    /** Always-visible hint rendered below the group. */
     hint?: HelperProps["hint"];
     /**
-     * When `true`, hides the visual label row. The sr-only `<legend>` always remains for screen readers.
-     * @default false
+     * Hides the visual label row while preserving the fieldset legend for
+     * assistive technology. Defaults to `false`.
      */
     hideLabel?: boolean;
 };
-/**
- * CheckboxGroup component for grouping related checkboxes together.
- *
- * Features:
- * - Groups multiple checkboxes with a common legend
- * - Supports required field indication
- * - Optional helper text and descriptions
- * - Full accessibility support with fieldset/legend
- * - Focus management for keyboard navigation
- * - Layout utility props for positioning and spacing
- * - Flexible layout direction (row/column)
- * - Screen reader support with hidden labels
- *
- * @example
- * <CheckboxGroup legend="Select your interests" required>
- *   <Checkbox label="Technology" />
- *   <Checkbox label="Sports" />
- *   <Checkbox label="Music" />
- * </CheckboxGroup>
- */
+/** Fieldset that labels related checkboxes and shares its error state. */
 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.
-     * @default false
-     */
+    /** Shows the required indicator but does not validate selection. */
     required?: boolean;
     /**
      * Legend for the fieldset.
-     * Passing `ReactNode` is deprecated — use a plain string with inline markdown instead.
+     * Passing a React element is deprecated; use a string with inline markdown.
      */
     legend: string | ReactElement;
-    /**
-     * Additional props for the legend `FieldLabel` (for example `aiMark`, `className`).
-     */
+    /** Props for the visible {@link FieldLabel}, except its root element. */
     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.
+     * Error styling for every child. A message value also renders below the
+     * group; React elements are deprecated.
      */
     error?: boolean | string | ReactElement | string[];
     /**
      * @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 copy rendered below the group. */
     warning?: string | string[];
-    /**
-     * Description text to display below the field.
-     */
+    /** Secondary copy rendered below the group. */
     description?: HelperProps["description"];
-    /**
-     * Hint text to display below the field.
-     */
+    /** Always-visible hint rendered below the group. */
     hint?: HelperProps["hint"];
     /**
-     * When `true`, hides the visual label row. The sr-only `<legend>` always remains for screen readers.
-     * @default false
+     * Hides the visual label row while preserving the fieldset legend for
+     * assistive technology. Defaults to `false`.
      */
     hideLabel?: boolean;
 } & import('react').RefAttributes<HTMLFieldSetElement>>;

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

@@ -4,138 +4,80 @@ import { HelperProps } from '../../../internal/components';
 import { CheckboxState } from '../types';
 export type { CheckboxState };
 /**
- * Props for the Checkbox component
  * @extends LayoutUtilProps
  * @extends Omit<ComponentPropsWithoutRef<"input">, "onChange" | "onClick" | "indeterminate">
  */
 export type CheckboxProps = LayoutUtilProps & Omit<ComponentPropsWithoutRef<"input">, "onChange" | "onClick" | "indeterminate"> & {
-    /**
-     * Controlled state
-     * @default false
-     */
+    /** Controlled checked state. Omit to use `defaultChecked`. */
     checked?: boolean;
-    /**
-     * Uncontrolled state
-     * @default false
-     */
+    /** Initial checked state when uncontrolled. Defaults to `false`. */
     defaultChecked?: boolean;
     /**
-     * Indeterminate state of the checkbox
-     * @accessibility Applies aria-checked="mixed"
-     * @default false
+     * Shows the mixed-state icon and sets `aria-checked="mixed"`. Defaults to
+     * `false`.
      */
     indeterminate?: boolean;
-    /**
-     * Callback when checkbox is changed
-     */
+    /** Called with the input event and resulting checked state. */
     onChange?: (e: ChangeEvent<HTMLInputElement>, state?: CheckboxState) => void;
-    /**
-     * Callback when checkbox is clicked
-     */
+    /** Called on click with the input's checked state at that point. */
     onClick?: (e?: MouseEvent<HTMLInputElement>, state?: CheckboxState) => void;
-    /**
-     * label for checkbox
-     * @accessibility This should either be a string or have text content inside for accessibility
-     */
+    /** Visible label content. Use `aria-label` when omitting it. */
     label?: string | ReactElement;
     /**
-     * Error state for the checkbox
-     * @accessibility Applies aria-invalid="true"
-     * @default false
+     * Applies error styling and `aria-invalid`; inherited group errors also
+     * apply. Defaults to `false`.
      */
     error?: boolean;
-    /**
-     * Icon overrides
-     */
+    /** Replaces the icons for individual checkbox states. */
     icons?: {
+        /** Replaces the selected-state icon. */
         checked?: Svg;
+        /** Replaces the mixed-state icon. */
         indeterminate?: Svg;
+        /** Replaces the unselected-state icon. */
         unchecked?: Svg;
     };
+    /** Secondary copy rendered below the label. */
     description?: HelperProps["description"];
-    /**
-     * When `true`, hides the checkbox for visual users.
-     * @default false
-     */
+    /** Visually hides the checkbox while retaining its focusable input. */
     hideCheckbox?: boolean;
-    /**
-     * Additional className applied to the label wrapper span
-     */
+    /** Class names for the span wrapping the visible label, not the root. */
     labelWrapperClassName?: string;
 };
-/**
- * Checkbox component for selecting one or more options from a list.
- *
- * Features:
- * - Controlled and uncontrolled state management
- * - Indeterminate state for partial selections
- * - Customizable icons for different states
- * - Error state with accessibility support
- * - Optional helper text and descriptions
- * - Hide checkbox option for visual-only interactions
- * - Full accessibility support with ARIA attributes
- * - Keyboard navigation support
- * - Layout utility props for positioning and spacing
- *
- * @example
- * <Checkbox
- *   label="Accept terms and conditions"
- *   onChange={(e, state) => console.log('Checked:', state.checked)}
- *   required
- * />
- */
 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
-     */
+    /** Controlled checked state. Omit to use `defaultChecked`. */
     checked?: boolean;
-    /**
-     * Uncontrolled state
-     * @default false
-     */
+    /** Initial checked state when uncontrolled. Defaults to `false`. */
     defaultChecked?: boolean;
     /**
-     * Indeterminate state of the checkbox
-     * @accessibility Applies aria-checked="mixed"
-     * @default false
+     * Shows the mixed-state icon and sets `aria-checked="mixed"`. Defaults to
+     * `false`.
      */
     indeterminate?: boolean;
-    /**
-     * Callback when checkbox is changed
-     */
+    /** Called with the input event and resulting checked state. */
     onChange?: (e: ChangeEvent<HTMLInputElement>, state?: CheckboxState) => void;
-    /**
-     * Callback when checkbox is clicked
-     */
+    /** Called on click with the input's checked state at that point. */
     onClick?: (e?: MouseEvent<HTMLInputElement>, state?: CheckboxState) => void;
-    /**
-     * label for checkbox
-     * @accessibility This should either be a string or have text content inside for accessibility
-     */
+    /** Visible label content. Use `aria-label` when omitting it. */
     label?: string | ReactElement;
     /**
-     * Error state for the checkbox
-     * @accessibility Applies aria-invalid="true"
-     * @default false
+     * Applies error styling and `aria-invalid`; inherited group errors also
+     * apply. Defaults to `false`.
      */
     error?: boolean;
-    /**
-     * Icon overrides
-     */
+    /** Replaces the icons for individual checkbox states. */
     icons?: {
+        /** Replaces the selected-state icon. */
         checked?: Svg;
+        /** Replaces the mixed-state icon. */
         indeterminate?: Svg;
+        /** Replaces the unselected-state icon. */
         unchecked?: Svg;
     };
+    /** Secondary copy rendered below the label. */
     description?: HelperProps["description"];
-    /**
-     * When `true`, hides the checkbox for visual users.
-     * @default false
-     */
+    /** Visually hides the checkbox while retaining its focusable input. */
     hideCheckbox?: boolean;
-    /**
-     * Additional className applied to the label wrapper span
-     */
+    /** Class names for the span wrapping the visible label, not the root. */
     labelWrapperClassName?: string;
 } & import('react').RefAttributes<HTMLInputElement>>;

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

@@ -1,19 +1,7 @@
-/**
- * Context value for CheckboxGroup
- * @property {boolean} hasError - Whether the group has an error state
- */
 export type CheckboxGroupContextValue = {
-    /**
-     * Whether the checkbox group has an error state
-     */
+    /** Whether the parent group has an error. */
     hasError: boolean;
 };
-/**
- * Context for sharing state between CheckboxGroup and child Checkbox components
- */
 export declare const CheckboxGroupContext: import('react').Context<CheckboxGroupContextValue | undefined>;
-/**
- * Hook to access CheckboxGroup context from child Checkbox components
- * @returns CheckboxGroupContextValue if inside a CheckboxGroup, undefined otherwise
- */
+/** Returns the nearest checkbox group state, if present. */
 export declare const useCheckboxGroupContext: () => CheckboxGroupContextValue | undefined;

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

@@ -1,4 +1,6 @@
 export type CheckboxState = {
+    /** Checked state after the event. */
     checked: boolean;
+    /** Value from the checkbox input. */
     value?: string | number | readonly string[];
 };

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

@@ -4,55 +4,19 @@ 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
- * @property {Svg} [icon] - Icon displayed in the chip, before the text.
- * @property {string} [avatar] - Image URL to display in an avatar before the chip text.
- * @extends CoreChipProps
- * @extends DataTrackingId
- * @extends AiMarkBooleanProps
+ * Small chips accept `onClick` or `onClose`, not both.
  */
 export type ChipProps = DistributiveOmit<CoreChipProps, "prefix" | "avatar" | "suffix"> & DataTrackingId & AiMarkBooleanProps & ({
+    /** SVGR asset rendered before the label. Cannot be combined with `avatar`. */
     icon?: CoreIconProps["svg"];
     avatar?: never;
 } | {
     icon?: never;
+    /** Image URL for an avatar before the label. Cannot be combined with `icon`. */
     avatar?: CoreAvatarProps["image"];
 });
 /**
- * Chip component for displaying compact information or tags.
- *
- * Features:
- * - Configurable sizes (small, medium)
- * - 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)
- * - Screen reader instructions for removal actions
- * - Theme-aware color adaptation
- * - Layout utility props for positioning and spacing
- * - Automatic tracking ID generation for analytics
- *
- * @example
- * <Chip
- *   label="JavaScript"
- *   color="#f7df1e"
- *   onClose={(e) => console.log('Chip removed')}
- *   onClick={(e) => console.log('Chip clicked')}
- * />
- *
- * @example
- * <Chip label="AI Generated" aiMark />
+ * Compact labeled tag. `onClose` adds a remove control; `onClick` makes the
+ * chip a button.
  */
 export declare const Chip: import('react').ForwardRefExoticComponent<ChipProps & import('react').RefAttributes<HTMLSpanElement>>;