@servicetitan/anvil2 3.13.7 → 3.14.1

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

@@ -99,7 +99,7 @@ export declare const Page: import('react').ForwardRefExoticComponent<Omit<import
      * - Status chips display
      * - Primary and secondary action buttons
      * - Preference action button/link
-     * - Responsive layout with fluid grid
+     * - Responsive layout grid
      * - Accessibility support with proper ARIA labels
      * - Flexible layout configuration
      * - Description content support

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

@@ -92,7 +92,9 @@ export type PageHeaderProps = Omit<ComponentPropsWithoutRef<"header">, "title">
      */
     preferenceAction?: PreferenceButtonProps | PreferenceLinkProps;
     /**
-     * Layout configuration for the header
+     * Header {@link LayoutProps}. When unset, the header uses the default fixed
+     * 1280px layout. Match the `fluid` and `variant` of the `Layout` inside
+     * `Page.Content`.
      */
     layout?: LayoutProps;
 };
@@ -105,7 +107,7 @@ export type PageHeaderProps = Omit<ComponentPropsWithoutRef<"header">, "title">
  * - Status chips display
  * - Primary and secondary action buttons
  * - Preference action button/link
- * - Responsive layout with fluid grid
+ * - Responsive layout grid
  * - Accessibility support with proper ARIA labels
  * - Flexible layout configuration
  * - Description content support
@@ -150,7 +152,9 @@ export declare const PageHeader: import('react').ForwardRefExoticComponent<Omit<
      */
     preferenceAction?: PreferenceButtonProps | PreferenceLinkProps;
     /**
-     * Layout configuration for the header
+     * Header {@link LayoutProps}. When unset, the header uses the default fixed
+     * 1280px layout. Match the `fluid` and `variant` of the `Layout` inside
+     * `Page.Content`.
      */
     layout?: LayoutProps;
 } & import('react').RefAttributes<HTMLHeadElement>>;

package/dist/src/hooks/useAccessibleColor/useAccessibleColor.d.ts

@@ -1,8 +1,5 @@
 /**
- * Type definition for the useAccessibleColor hook
- * @param hex - The hex color to generate accessible colors for
- * @param mode - The color mode (light or dark)
- * @returns Object containing accessible foreground, background, and border colors
+ * Palette channels are `undefined` when no seed color is provided.
  */
 export type UseAccessibleColorType = (hex?: string, mode?: "light" | "dark") => {
     foreground?: string;
@@ -10,29 +7,7 @@ export type UseAccessibleColorType = (hex?: string, mode?: "light" | "dark") =>
     border?: string;
 };
 /**
- * Custom hook for generating accessible color combinations that meet WCAG contrast requirements.
- *
- * Features:
- * - Generates accessible foreground, background, and border colors
- * - Supports both light and dark color modes
- * - Ensures WCAG contrast ratio compliance (4.5:1 for text, 3:1 for borders)
- * - Automatically adjusts colors to meet accessibility standards
- * - Handles invalid color inputs gracefully
- * - Uses tinycolor2 for color manipulation and contrast calculations
- * - Optimized with useMemo for performance
- * - Implements intelligent color selection algorithms
- * - Provides fallback strategies for edge cases
- * - Supports dynamic theme switching
- *
- * Algorithm Details:
- * - Light Mode: Selects white or dark text based on background contrast
- * - Dark Mode: Adjusts both foreground and background for optimal contrast
- * - Border Generation: Ensures 3:1 contrast ratio with page background
- * - Iterative Adjustment: Uses up to 16 iterations for color optimization
- * - Luminance Thresholds: Maintains appropriate darkness levels for dark themes
- *
- * @param hex - The hex color to generate accessible colors for (e.g., "#FF0000")
- * @param mode - The color mode ("light" or "dark") for context-aware color generation
- * @returns Object containing accessible foreground, background, and border colors in hex format
+ * Creates an accessible foreground, background, and border palette from a seed color.
+ * Invalid colors throw; omitting `mode` uses light-mode contrast.
  */
 export declare const useAccessibleColor: UseAccessibleColorType;

package/dist/src/hooks/useBreakpoint/useBreakpoint.d.ts

@@ -1,80 +1,35 @@
 /**
- * Return type for the useBreakpoint hook
+ * Viewport measurements and mobile-first flags for the active Hammer breakpoint.
  */
 export type BreakpointReturnProps = {
-    /**
-     * The breakpoint name
-     */
+    /** Active breakpoint range. */
     name: "xs" | "sm" | "md" | "lg" | "xl" | "xxl";
-    /**
-     * Minimum width for this breakpoint
-     */
+    /** Inclusive lower bound, or `undefined` for `xs`. */
     min: number | undefined;
-    /**
-     * Maximum width for this breakpoint
-     */
+    /** Exclusive upper bound, or `undefined` for `xxl`. */
     max: number | undefined;
-    /**
-     * Current device orientation
-     */
+    /** `"portrait"` when height exceeds width; otherwise `"landscape"`. */
     orientation: "portrait" | "landscape";
-    /**
-     * Current viewport width in CSS pixels (from window.innerWidth)
-     */
+    /** Current viewport width in CSS pixels. */
     innerWidth: number;
-    /**
-     * Current viewport height in CSS pixels (from window.innerHeight)
-     */
+    /** Current viewport height in CSS pixels. */
     innerHeight: number;
-    /**
-     * True for all breakpoints (mobile-first: xs and above)
-     */
+    /** Always true when breakpoint data is available. */
     xs: boolean;
-    /**
-     * True when viewport width >= 640px (mobile-first: sm and above)
-     */
+    /** Whether the active range is `sm` or wider. */
     sm: boolean;
-    /**
-     * True when viewport width >= 768px (mobile-first: md and above)
-     */
+    /** Whether the active range is `md` or wider. */
     md: boolean;
-    /**
-     * True when viewport width >= 1024px (mobile-first: lg and above)
-     */
+    /** Whether the active range is `lg` or wider. */
     lg: boolean;
-    /**
-     * True when viewport width >= 1280px (mobile-first: xl and above)
-     */
+    /** Whether the active range is `xl` or wider. */
     xl: boolean;
-    /**
-     * True when viewport width >= 1536px (mobile-first: xxl and above)
-     */
+    /** Whether the active range is `xxl`. */
     xxl: boolean;
 };
 /**
- * Custom hook for detecting current breakpoint and viewport information.
- *
- * Features:
- * - Detects current breakpoint based on viewport width
- * - Supports all standard breakpoints (xs, sm, md, lg, xl, xxl)
- * - Provides mobile-first boolean props (e.g., `lg` is true for lg, xl, and xxl)
- * - Provides device orientation information
- * - Returns current viewport dimensions
- * - Uses hammer-token breakpoint values for consistency
- * - Listens for window resize events
- * - Supports optional disable functionality
- * - Uses window.innerWidth/innerHeight for viewport measurements
- *
- * @example
- * ```tsx
- * const breakpoint = useBreakpoint();
- * // Mobile-first approach:
- * <div className={cn({ 'p-block-4': breakpoint?.lg })} />
- * ```
- *
- * @param props - Optional configuration object
- * @param props.disable - Whether to disable the hook
- * @returns Current breakpoint information or undefined if disabled
+ * Tracks {@link BreakpointReturnProps} on resize.
+ * Returns `undefined` when disabled or Hammer breakpoint tokens are unavailable.
  */
 export declare const useBreakpoint: (props?: {
     disable?: boolean;

package/dist/src/hooks/useMergeRefs/useMergeRefs.d.ts

@@ -1,28 +1,11 @@
 import { Ref, RefCallback } from 'react';
 /**
- * Custom hook for merging multiple React refs into a single callback ref.
- * @see https://floating-ui.com/docs/react-utils#usemergerefs
- *
- * Features:
- * - Merges an array of refs into a single callback ref
- * - Handles both function refs and object refs
- * - Optimized with useMemo for performance
- * - Returns null when all refs are null/undefined
- * - Supports generic types for type safety
- * - Automatically handles ref assignment and cleanup
+ * Combines React refs into one stable callback ref, or `null` when all are empty.
  *
- * @param refs - Array of React refs to merge
- * @returns Single callback ref that handles all provided refs, or null if all refs are null
+ * @see https://floating-ui.com/docs/react-utils#usemergerefs
  */
 export declare function useMergeRefs<Instance>(refs: Array<Ref<Instance> | undefined>): RefCallback<Instance> | null;
 /**
- * Merges an array of refs into a single callback ref.
- *
- * Features:
- * - Merges an array of refs into a single callback ref
- * - Handles both function refs and object refs
- *
- * @param refs - Array of React refs to merge
- * @returns
+ * Combines React refs into one callback ref, or `null` when all are empty.
  */
 export declare function mergeRefs<Instance>(refs: Array<Ref<Instance> | undefined>): RefCallback<Instance> | null;

package/dist/src/hooks/usePrefersColorScheme/usePrefersColorScheme.d.ts

@@ -1,15 +1,6 @@
 /**
- * Custom hook for detecting system color scheme preference.
- *
- * Features:
- * - Detects system dark/light mode preference
- * - Listens for changes in system color scheme
- * - Supports both modern and legacy event listeners
- * - Handles SSR environments gracefully
- * - Automatically cleans up event listeners
- * - Returns consistent light/dark mode values
- *
- * @returns Object containing current color scheme mode
+ * Tracks whether the user's system color scheme is light or dark.
+ * Reports `"light"` until the media query is read after mount.
  */
 export declare const usePrefersColorScheme: () => {
     mode: "light" | "dark";

package/dist/src/hooks/usePrefersReducedMotion/usePrefersReducedMotion.d.ts

@@ -1,14 +1,6 @@
 /**
- * Custom hook for detecting user's reduced motion preference.
- *
- * Features:
- * - Detects system reduced motion preference
- * - Listens for changes in system motion preference
- * - Uses `MediaQueryList#addEventListener("change")` when available, with `addListener` / `removeListener` fallback for older browsers
- * - Handles SSR environments gracefully
- * - Automatically cleans up event listeners
- *
- * @returns Object containing whether reduced motion is preferred
+ * Tracks whether the user has requested reduced motion at the system level.
+ * Reports `false` until the media query is read after mount.
  */
 export declare const usePrefersReducedMotion: () => {
     prefersReducedMotion: boolean;

package/dist/src/hooks/useSize/index.d.ts

@@ -1,18 +1,7 @@
 import { RefObject } from 'react';
 /**
- * Custom hook for measuring element dimensions and tracking size changes.
- *
- * Features:
- * - Measures element dimensions using getBoundingClientRect
- * - Tracks size changes using ResizeObserver
- * - Provides real-time size updates
- * - Handles initial size measurement on mount
- * - Returns DOMRectReadOnly for comprehensive size information
- * - Automatically cleans up observer on unmount
- * - Uses useLayoutEffect for immediate initial measurement
- *
- * @param target - Reference to the element to measure
- * @returns Current element size as DOMRectReadOnly or undefined
+ * Tracks `target`'s size. `undefined` until the first layout measurement.
+ * First read is the border box (`getBoundingClientRect`); later updates are `contentRect`.
  */
 export declare const useSize: (target: RefObject<HTMLElement>) => DOMRectReadOnly | undefined;
 export default useSize;

package/dist/src/hooks/useSwipe/useSwipe.d.ts

@@ -1,28 +1,11 @@
 import { TouchEvent } from 'react';
-/**
- * Type definition for swipe direction
- * @property {string | null} direction - The direction of the swipe (left, right, or null)
- */
 export type UseSwipeFn = {
-    /**
-     * The direction of the swipe (left, right, or null)
-     */
+    /** `"left"` or `"right"` after a horizontal swipe of more than 50px; otherwise `null`. */
     direction: string | null;
 };
 /**
- * Custom hook for detecting swipe gestures on touch devices.
- *
- * Features:
- * - Detects left and right swipe gestures
- * - Configurable minimum swipe distance threshold
- * - Provides touch event handlers for easy integration
- * - Supports optional callback function for swipe events
- * - Tracks current swipe direction state
- * - Handles touch start, move, and end events
- * - Prevents false positives from regular touch events
- *
- * @param func - Optional callback function called when a swipe is detected
- * @returns Object containing touch event handlers and current swipe direction
+ * Horizontal swipe detection. Spread the returned `onTouch*` handlers onto the target.
+ * Optional `func` runs when a swipe resolves (including `null` when the gesture is too short).
  */
 export declare const useSwipe: (func?: (direction: UseSwipeFn["direction"]) => void) => {
     onTouchMove: (e: TouchEvent<HTMLElement>) => void;

package/dist/src/hooks/useTrackingId/index.d.ts

@@ -1,26 +1,15 @@
 /**
- * Custom hook for generating and managing tracking IDs for analytics.
- *
- * Features:
- * - Generates unique tracking IDs for analytics events
- * - Integrates with TrackingProvider for centralized tracking management
- * - Supports opt-out functionality for privacy compliance
- * - Handles tracking overrides for testing or special cases
- * - Uses JSON stringification for consistent data serialization
- * - Automatically updates tracking ID when data or name changes
- * - Respects user privacy preferences through opt-out mechanism
- * - Provides async tracking ID generation
- *
- * @param props - Configuration object containing tracking parameters
- * @param props.name - The name identifier for the tracking event
- * @param props.data - The data object to track
- * @param props.hasOverride - Whether to override tracking behavior
- * @returns Generated tracking ID string or undefined if tracking is disabled
+ * Resolves an analytics tracking ID from {@link TrackingProvider}.
+ * Returns `undefined` until the async lookup finishes. `hasOverride` and provider
+ * `optOut` skip the lookup; they do not clear an already resolved ID.
  */
 export declare const useTrackingId: ({ name, data, hasOverride, }: {
+    /** Component segment passed as `getTrackingId`'s second argument. */
     name: string;
+    /** Payload serialized with `JSON.stringify` for the lookup key. */
     data: {
         [key: string]: unknown;
     };
+    /** Skip the lookup. Same skip path as provider `optOut`. */
     hasOverride?: boolean;
 }) => string | undefined;

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

@@ -1,39 +1,13 @@
 import { AddNewItemProps } from '../types/addNewItemTypes';
-/**
- * Props for the AddNewItemButton component.
- *
- * @property {string} searchText - The current search text, forwarded to the consumer's handler and label callback.
- * @property {() => void} [onCloseMenu] - Internal hook for the host menu to close itself when the button is clicked. Fires before the consumer's handler.
- * @extends AddNewItemProps
- */
 export type AddNewItemButtonProps = AddNewItemProps & {
-    /** The current search text, forwarded to the consumer's handler and label callback. */
+    /** Passed to the label callback and add-item handler. */
     searchText: string;
-    /** Internal hook for the host menu to close itself when the button is clicked. */
+    /** Closes the host menu before the add-item handler runs. */
     onCloseMenu?: () => void;
 };
 /**
- * AddNewItemButton renders the consumer's "Add new item" affordance for the
- * Select* / MultiSelect* components. Positioning, padding, background tint,
- * and the visual separator from the option list are owned by the surrounding
- * popover/dialog footer slot — this component is only responsible for the
- * button itself.
- *
- * Features:
- * - Renders nothing when no `onAddNewItem` handler is provided
- * - Renders nothing when `addItemLabel` is a function that returns `null`/`undefined`
- * - Static or dynamic label resolved against the current search text
- * - Closes the host menu via `onCloseMenu` when clicked, before invoking the consumer's handler
- *
- * @example
- * <AddNewItemButton
- *   searchText={searchText}
- *   addItemLabel={(s) => `Add "${s}"`}
- *   onAddNewItem={(text) => openAddDialog(text)}
- *   onCloseMenu={closeMenu}
- * />
- *
- * @returns The button, or null when the feature is not enabled / label is hidden.
+ * Add-new affordance for select menus. It remains unmounted without a handler
+ * or when the label callback returns `null`/`undefined`.
  */
 export declare const AddNewItemButton: {
     ({ searchText, addItemLabel, onAddNewItem, onCloseMenu, }: AddNewItemButtonProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -1,27 +1,31 @@
 import { AriaAttributes, ReactElement } from 'react';
 export type HelperProps = {
+    /** `aria-describedby` target on the helper container. */
     id?: string;
+    /** Always-visible hint; forwarded to {@link FieldMessage}. */
     hint?: ReactElement | string;
+    /** Secondary copy under the hint; forwarded to {@link FieldMessage}. */
     description?: ReactElement | string;
-    /**
-     * Error message(s) to display. Supports a single string or an array of strings.
-     */
+    /** Error copy; forwarded to {@link FieldMessage}. */
     error?: string | string[];
-    /**
-     * Warning message(s) to display. Supports a single string or an array of strings.
-     */
+    /** Warning copy; forwarded to {@link FieldMessage}. */
     warning?: string | string[];
     /**
-     * @deprecated Use the `error` prop instead.
+     * @deprecated Use `error`.
      */
     errorMessage?: ReactElement | string;
     /**
-     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
+     * @deprecated Unused. Errors are always `aria-live="assertive"`.
      */
     errorAriaLive?: AriaAttributes["aria-live"];
+    /** Counter denominator and remaining-character live-region limit. */
     maxLength?: number;
+    /** Current character count. Defaults to `0`. */
     inputLength?: number;
+    /** With a truthy `maxLength`, announces remaining characters (or max reached). */
     isTyping?: boolean;
+    /** Visual `inputLength/maxLength` counter (`aria-hidden`). */
     showCounter?: boolean;
 };
+/** {@link FieldMessage} slot plus optional max-length counter and typing live region. */
 export declare const Helper: import('react').ForwardRefExoticComponent<HelperProps & import('react').RefAttributes<HTMLDivElement>>;

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

@@ -1,34 +1,14 @@
 import { ReactNode } from 'react';
-/**
- * Props for the InView component
- * @property {ReactNode} children - The content to render inside the visibility-tracked container
- * @property {(isVisible: boolean) => void} [onVisibilityChange] - Callback fired when visibility changes
- */
 type InViewProps = {
-    /**
-     * The content to render inside the visibility-tracked container
-     */
     children?: ReactNode;
-    /**
-     * Callback fired when the element's visibility in the viewport changes
-     */
+    /** Receives each observed viewport-visibility change. */
     onVisibilityChange?: (isVisible: boolean) => void;
-    /**
-     * The root margin for the intersection observer
-     */
+    /** Expands or contracts the viewport bounds using CSS margin syntax. */
     rootMargin?: string;
 };
 /**
- * Internal component that detects when its content is visible in the viewport.
- *
- * Features:
- * - Uses Intersection Observer API for efficient visibility detection
- * - Fires callback when visibility state changes
- * - Handles browser compatibility gracefully
- * - Automatically cleans up observer on unmount
- *
- * @param props - Component props
- * @returns Wrapped children with visibility detection
+ * Wraps content in an Intersection Observer target and reports viewport
+ * visibility.
  */
 export declare const InView: ({ children, onVisibilityChange, rootMargin, }: InViewProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,23 +1,6 @@
-/**
- * Props for the InlineMarkdown component
- * @property {string} [value] - The markdown string to parse and render
- */
 export interface InlineMarkdownProps {
+    /** Markdown source. Defaults to `""`. */
     value?: string;
 }
-/**
- * Renders a string with limited inline markdown constructs as formatted React content.
- *
- * Features:
- * - Bold: `**text**`
- * - Italic: `*text*`
- * - Bold and italic: `***text***`
- * - Highlight: `==text==`
- * - Inline code: `` `text` ``
- * - Memoized rendering for performance
- * - Passes through plain strings with no overhead
- *
- * @example
- * <InlineMarkdown value="Save **now** or `discard`" />
- */
+/** Turns limited inline markdown into React nodes. */
 export declare const InlineMarkdown: ({ value }: InlineMarkdownProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,77 +1,38 @@
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
 import { TooltipProps } from '../../../components/Tooltip';
-/**
- * Props for the Label component.
- */
 export type LabelProps = Omit<ComponentPropsWithoutRef<"label">, "id"> & {
-    /** Unique identifier for the label element */
     id?: string;
     /**
-     * Whether the field is required. Shows a red asterisk (*) when true.
-     * @default false
+     * Shows a visual asterisk and a screen-reader `Required`. Defaults to
+     * omitted / not required.
      */
     required?: boolean;
-    /** Additional information to display in a tooltip */
+    /** Tooltip copy on the info icon; also repeated in a visually hidden span. */
     moreInfo?: ReactNode;
     /**
-     * Controls the open state of the more info tooltip.
-     * @default false
+     * Forces the info tooltip open when true. When it becomes falsy, the tooltip
+     * closes, then returns to uncontrolled on the next tick.
      */
     moreInfoOpen?: TooltipProps["open"];
 };
-/**
- * Internal component for rendering the info icon with tooltip.
- *
- * @param props - Component props
- * @param props.moreInfo - The content to display in the tooltip
- * @param props.moreInfoOpen - Controls the tooltip open state
- */
+/** Info-icon tooltip; `moreInfoOpen` is snap-then-uncontrolled. */
 export declare const LabelMoreInfoIcon: ({ moreInfo, moreInfoOpen, }: {
     moreInfo: LabelProps["moreInfo"];
     moreInfoOpen: LabelProps["moreInfoOpen"];
 }) => import("react/jsx-runtime").JSX.Element;
-/**
- * Label component for form field labels with optional required indicator and help tooltip.
- *
- * Features:
- * - Accessible form label with proper semantic HTML
- * - Optional required field indicator with red asterisk
- * - Help tooltip with info icon for additional context
- * - Screen reader support for required field announcement
- * - Controlled and uncontrolled tooltip state management
- * - Flexible content support for label text and help information
- * - Proper ARIA attributes and semantic structure
- * - Responsive design with consistent typography
- *
- * @example
- * <Label htmlFor="email" required>
- *   Email Address
- * </Label>
- * <input id="email" type="email" />
- *
- * @example
- * <Label
- *   htmlFor="password"
- *   required
- *   moreInfo="Password must be at least 8 characters long"
- * >
- *   Password
- * </Label>
- * <input id="password" type="password" />
- */
+/** Form `<label>` with optional required marker and more-info tooltip. */
 export declare const Label: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').LabelHTMLAttributes<HTMLLabelElement>, HTMLLabelElement>, "ref">, "id"> & {
-    /** Unique identifier for the label element */
     id?: string;
     /**
-     * Whether the field is required. Shows a red asterisk (*) when true.
-     * @default false
+     * Shows a visual asterisk and a screen-reader `Required`. Defaults to
+     * omitted / not required.
      */
     required?: boolean;
-    /** Additional information to display in a tooltip */
+    /** Tooltip copy on the info icon; also repeated in a visually hidden span. */
     moreInfo?: ReactNode;
     /**
-     * Controls the open state of the more info tooltip.
-     * @default false
+     * Forces the info tooltip open when true. When it becomes falsy, the tooltip
+     * closes, then returns to uncontrolled on the next tick.
      */
     moreInfoOpen?: TooltipProps["open"];
 } & import('react').RefAttributes<HTMLLabelElement>>;

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

@@ -1,7 +1,10 @@
 import { ReactNode } from 'react';
 export type ManualTestParams = {
+    /** Heading shown above the component under test. */
     title: string;
+    /** Screen-reader or a11y tool this procedure is written for. */
     tool: string;
+    /** Ordered instructions. Lines starting with `Expected` are visually emphasized. */
     steps: string[];
 };
 type ManualTestLayoutProps = ManualTestParams & {
@@ -9,8 +12,6 @@ type ManualTestLayoutProps = ManualTestParams & {
 };
 /**
  * Layout helper for manual accessibility test stories.
- * Renders the test title, tool, and step-by-step instructions
- * visibly above the component under test.
  */
 export declare function ManualTestLayout({ title, tool, steps, children, }: ManualTestLayoutProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,14 +1,22 @@
 import { ReactNode } from 'react';
 export type MenuFooterClearConfig = {
+    /** Clears the host's current selection. */
     onClick: () => void;
+    /** Button text. Defaults to `"Clear"`. */
     label?: string;
+    /** Prevents clearing while preserving the control in the layout. */
     disabled?: boolean;
 };
 export type MenuFooterConfirmationConfig = {
+    /** Commits the host's pending selection. */
     onApply: () => void;
+    /** Discards the host's pending selection. */
     onCancel: () => void;
+    /** Commit button text. Defaults to `"Apply"`. */
     applyLabel?: string;
+    /** Cancel button text. Defaults to `"Cancel"`. */
     cancelLabel?: string;
+    /** Prevents committing while leaving cancellation available. */
     applyDisabled?: boolean;
 };
 export type MenuFooterProps = {
@@ -16,26 +24,12 @@ export type MenuFooterProps = {
     clear?: MenuFooterClearConfig;
     /** Apply/Cancel pair config. Omit when not in confirmation mode. */
     confirmation?: MenuFooterConfirmationConfig;
-    /**
-     * Pre-rendered add-new affordance (AddNewItemButton or similar). Layout owns
-     * its row vs. inline placement; the caller just provides the node.
-     */
+    /** Pre-rendered affordance; placement depends on the other footer controls. */
     addNew?: ReactNode;
 };
 /**
- * MenuFooter composes the footer of a menu popover/dialog from up to three
- * optional pieces: a clear-selection button, an Apply/Cancel pair, and an
- * add-new affordance.
- *
- * Layout rules:
- * - clear + confirmation + addNew → [addNew full-width row] / [clear | apply cancel]
- * - clear + confirmation         → [clear | apply cancel]
- * - clear + addNew               → [addNew] / [clear]   (stacked, both full-width)
- * - clear                        → [clear]               (full-width)
- * - confirmation + addNew        → [addNew | apply cancel]   (addNew on the leading side)
- * - confirmation                 → [apply | cancel]
- * - addNew                       → [addNew]
- * - (none)                       → null
+ * Composes clear, confirmation, and add-new controls into a menu footer.
+ * Returns `null` when all three are omitted.
  */
 export declare const MenuFooter: {
     ({ clear, confirmation, addNew, }: MenuFooterProps): import("react/jsx-runtime").JSX.Element | null;