@servicetitan/anvil2 3.14.0 → 3.15.0

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

@@ -4,383 +4,142 @@ import { Placement } from '@floating-ui/react';
 import { DisableCloseOnEscapeOrClickProps } from '../../types';
 import { OpenCloseTransitionStateEffects } from '../../internal/hooks';
 /**
- * Props for the Popover component
- * @property {ReactNode} [children] - The content to be rendered inside the popover
- * @property {string} [id] - Unique identifier for the popover
- * @property {boolean} [modal] - Whether the popover should be modal (traps focus)
- * @property {boolean} [openOnHover] - Changes interaction to use hover instead of click
- * @property {boolean} [fillAvailableHeight] - Changes height and positioning for select/combobox
- * @property {number | string} [maxHeight] - Maximum height of the popover content
- * @property {boolean} [fitScreen] - Whether the popover should fit within the screen bounds
- * @property {number | string} [minHeight] - Minimum height of the popover content
- * @property {boolean} [matchReferenceWidth] - Whether the popover width should match the trigger element
- * @property {boolean} [fixedWidth] - Whether the popover should have a fixed width
- * @property {string} [placement] - Placement of the popover relative to the trigger
- * @property {boolean} [open] - Controlled open state
- * @property {boolean} [defaultOpen] - Default open state for uncontrolled mode
- * @property {Function} [onOpenChange] - Callback when open state changes
- * @property {Function} [onClickOutside] - Callback when clicking outside the popover
- * @property {Function} [onClose] - Fires when the floating element is requested to be closed
- * @property {boolean} [disableCaret] - Whether to disable the caret/arrow indicator
- * @property {boolean} [noPadding] - Whether to remove default padding from content
- * @property {boolean} [disableAutoUpdate] - Whether to disable automatic position updates
- * @property {boolean} [disableTriggerFocus] - Whether to disable focus on the trigger element
- * @property {number} [delay] - Delay before opening the popover (for hover mode)
- * @property {boolean} [disableCloseOnClickOutside] - Whether to disable closing on outside click
- * @property {boolean} [disableCloseOnEscape] - Whether to disable closing on escape key
- */
-/**
- * Props for the Popover component
- * @extends ComponentPropsWithoutRef<"div">
  * @extends DisableCloseOnEscapeOrClickProps
+ * @extends OpenCloseTransitionStateEffects
  */
 export type PopoverProps = {
-    /**
-     * The content to be rendered inside the popover
-     */
+    /** Compound trigger and content under shared popover state. */
     children?: ComponentPropsWithoutRef<"div">["children"];
-    /**
-     * Unique identifier for the popover
-     */
+    /** Becomes the popover content element id; generated when omitted. */
     id?: ComponentPropsWithoutRef<"div">["id"];
-    /**
-     * Whether the popover should be modal (traps focus)
-     * @default false
-     */
+    /** Traps focus when the content blurs; Tab-out returns to the trigger. Defaults to `false`. */
     modal?: boolean;
     /**
-     * Disables the shift of floating element
+     * Disables Floating UI shift along the main axis.
      * @internal
      */
     disableShift?: boolean;
     /**
-     * Disables the flip of floating element
+     * Disables Floating UI flip along the main axis.
      * @internal
      */
     disableFlip?: boolean;
     /**
-     * Disables the flip cross-axis fallback of floating element
+     * Disables the cross-axis flip fallback (left/right when vertical space is tight).
      * @internal
      */
     disableFlipFallback?: boolean;
-    /**
-     * Changes interaction to use hover instead of click
-     * @default false
-     */
+    /** Opens on hover and focus instead of click. Defaults to `false`. */
     openOnHover?: boolean;
-    /**
-     * Changes height and positioning for select/combobox
-     * @default false
-     */
+    /** Fills the remaining viewport height on the resolved side. Defaults to `false`. */
     fillAvailableHeight?: boolean;
-    /**
-     * Maximum height of the popover content
-     */
+    /** With `fitScreen`, becomes the content height while available space becomes its cap. */
     maxHeight?: number | string;
-    /**
-     * Whether the popover should fit within the screen bounds
-     * @default false
-     */
+    /** Constrains content to the available viewport height. Defaults to `false`. */
     fitScreen?: boolean;
-    /**
-     * Minimum height of the popover content
-     * @default "2.875rem"
-     */
+    /** Minimum used when a constrained-height mode is active. Defaults to the component minimum. */
     minHeight?: number | string;
-    /**
-     * Whether the popover width should match the trigger element
-     * @default false
-     */
+    /** Sets the content width to the measured trigger width. Defaults to `false`. */
     matchReferenceWidth?: boolean;
-    /**
-     * Whether the popover should have a fixed width
-     * @default false
-     */
+    /** Uses a viewport-relative width unless `matchReferenceWidth` is set. Defaults to `false`. */
     fixedWidth?: boolean;
-    /**
-     * Placement of the popover relative to the trigger
-     * @default "bottom"
-     */
+    /** Preferred trigger-relative placement, with opposite-side fallback. Defaults to `bottom`. */
     placement?: Placement;
-    /**
-     * Controlled open state
-     */
+    /** Controls visibility when supplied. */
     open?: boolean;
-    /**
-     * Default open state for uncontrolled mode
-     * @default false
-     */
+    /** Initial visibility in uncontrolled mode. Defaults to `false`. */
     defaultOpen?: boolean;
-    /**
-     * Callback when clicking outside the popover
-     */
+    /** Called on an outside press while open, unless `disableCloseOnClickOutside`. */
     onClickOutside?: (e: globalThis.MouseEvent) => void;
     /**
-     * Fires when the floating element is requested to be closed
-     * Note: this does not fire when openOnHover is true and mouse leaves to close
-     * eg. on click outside, [esc] to close, or by <Popover.Close>
+     * Called when a non-hover close is requested (outside click, Escape, or
+     * `Popover.Close`). Not called on hover-leave or when `open` changes externally.
      */
     onClose?: () => void;
-    /**
-     * Whether to disable the caret/arrow indicator
-     * @default false
-     */
+    /** Hides the caret. Defaults to `false`. */
     disableCaret?: boolean;
-    /**
-     * Whether to remove default padding from content
-     * @default false
-     */
+    /** Removes the content area's default padding. Defaults to `false`. */
     noPadding?: boolean;
-    /**
-     * Whether to disable automatic position updates
-     * @default false
-     */
+    /** Ignored; position still tracks while open. Defaults to `false`. */
     disableAutoUpdate?: boolean;
-    /**
-     * Whether to disable focus on the trigger element
-     * @default false
-     */
+    /** Exposed on popover context. Defaults to `false`. */
     disableTriggerFocus?: boolean;
-    /**
-     * Delay before opening the popover (for hover mode)
-     * @default 100
-     */
+    /** Milliseconds before hover opens the popover. Defaults to `100`. */
     delay?: number;
 } & DisableCloseOnEscapeOrClickProps & OpenCloseTransitionStateEffects;
 /**
- * Popover component for displaying floating content relative to a trigger element.
- *
- * Features:
- * - Supports both controlled and uncontrolled modes
- * - Automatic positioning with fallback strategies
- * - Hover and click interaction modes
- * - Modal and non-modal variants
- * - Custom trigger elements
- * - Automatic height and width management
- * - Screen boundary detection and fitting
- * - Keyboard navigation and accessibility
- * - Outside click detection and handling
- * - Focus management and trapping
- * - Arrow/caret indicators
- * - Delay support for hover interactions
- * - Automatic tracking ID generation for analytics
- *
- * @example
- * <Popover>
- *   <Popover.Button>Click to open</Popover.Button>
- *   <Popover.Content>
- *     <p>This is the popover content</p>
- *     <Popover.Close>Close</Popover.Close>
- *   </Popover.Content>
- * </Popover>
- *
- * @example
- * <Popover openOnHover delay={1000}>
- *   <Popover.Button>Hover to open</Popover.Button>
- *   <Popover.Content>Tooltip content</Popover.Content>
- * </Popover>
- *
- * @example
- * <Popover modal>
- *   <Popover.Trigger>
- *     {(props) => <button {...props}>Custom trigger</button>}
- *   </Popover.Trigger>
- *   <Popover.Content>
- *     <TextField label="Form field" />
- *     <Popover.Close>Done</Popover.Close>
- *   </Popover.Content>
- * </Popover>
+ * Positions top-layer content relative to a trigger. Compound Button, Trigger,
+ * Content, and Close share open state; hover and modal change how it closes.
  */
 export declare const Popover: import('react').ForwardRefExoticComponent<{
-    /**
-     * The content to be rendered inside the popover
-     */
+    /** Compound trigger and content under shared popover state. */
     children?: ComponentPropsWithoutRef<"div">["children"];
-    /**
-     * Unique identifier for the popover
-     */
+    /** Becomes the popover content element id; generated when omitted. */
     id?: ComponentPropsWithoutRef<"div">["id"];
-    /**
-     * Whether the popover should be modal (traps focus)
-     * @default false
-     */
+    /** Traps focus when the content blurs; Tab-out returns to the trigger. Defaults to `false`. */
     modal?: boolean;
     /**
-     * Disables the shift of floating element
+     * Disables Floating UI shift along the main axis.
      * @internal
      */
     disableShift?: boolean;
     /**
-     * Disables the flip of floating element
+     * Disables Floating UI flip along the main axis.
      * @internal
      */
     disableFlip?: boolean;
     /**
-     * Disables the flip cross-axis fallback of floating element
+     * Disables the cross-axis flip fallback (left/right when vertical space is tight).
      * @internal
      */
     disableFlipFallback?: boolean;
-    /**
-     * Changes interaction to use hover instead of click
-     * @default false
-     */
+    /** Opens on hover and focus instead of click. Defaults to `false`. */
     openOnHover?: boolean;
-    /**
-     * Changes height and positioning for select/combobox
-     * @default false
-     */
+    /** Fills the remaining viewport height on the resolved side. Defaults to `false`. */
     fillAvailableHeight?: boolean;
-    /**
-     * Maximum height of the popover content
-     */
+    /** With `fitScreen`, becomes the content height while available space becomes its cap. */
     maxHeight?: number | string;
-    /**
-     * Whether the popover should fit within the screen bounds
-     * @default false
-     */
+    /** Constrains content to the available viewport height. Defaults to `false`. */
     fitScreen?: boolean;
-    /**
-     * Minimum height of the popover content
-     * @default "2.875rem"
-     */
+    /** Minimum used when a constrained-height mode is active. Defaults to the component minimum. */
     minHeight?: number | string;
-    /**
-     * Whether the popover width should match the trigger element
-     * @default false
-     */
+    /** Sets the content width to the measured trigger width. Defaults to `false`. */
     matchReferenceWidth?: boolean;
-    /**
-     * Whether the popover should have a fixed width
-     * @default false
-     */
+    /** Uses a viewport-relative width unless `matchReferenceWidth` is set. Defaults to `false`. */
     fixedWidth?: boolean;
-    /**
-     * Placement of the popover relative to the trigger
-     * @default "bottom"
-     */
+    /** Preferred trigger-relative placement, with opposite-side fallback. Defaults to `bottom`. */
     placement?: Placement;
-    /**
-     * Controlled open state
-     */
+    /** Controls visibility when supplied. */
     open?: boolean;
-    /**
-     * Default open state for uncontrolled mode
-     * @default false
-     */
+    /** Initial visibility in uncontrolled mode. Defaults to `false`. */
     defaultOpen?: boolean;
-    /**
-     * Callback when clicking outside the popover
-     */
+    /** Called on an outside press while open, unless `disableCloseOnClickOutside`. */
     onClickOutside?: (e: globalThis.MouseEvent) => void;
     /**
-     * Fires when the floating element is requested to be closed
-     * Note: this does not fire when openOnHover is true and mouse leaves to close
-     * eg. on click outside, [esc] to close, or by <Popover.Close>
+     * Called when a non-hover close is requested (outside click, Escape, or
+     * `Popover.Close`). Not called on hover-leave or when `open` changes externally.
      */
     onClose?: () => void;
-    /**
-     * Whether to disable the caret/arrow indicator
-     * @default false
-     */
+    /** Hides the caret. Defaults to `false`. */
     disableCaret?: boolean;
-    /**
-     * Whether to remove default padding from content
-     * @default false
-     */
+    /** Removes the content area's default padding. Defaults to `false`. */
     noPadding?: boolean;
-    /**
-     * Whether to disable automatic position updates
-     * @default false
-     */
+    /** Ignored; position still tracks while open. Defaults to `false`. */
     disableAutoUpdate?: boolean;
-    /**
-     * Whether to disable focus on the trigger element
-     * @default false
-     */
+    /** Exposed on popover context. Defaults to `false`. */
     disableTriggerFocus?: boolean;
-    /**
-     * Delay before opening the popover (for hover mode)
-     * @default 100
-     */
+    /** Milliseconds before hover opens the popover. Defaults to `100`. */
     delay?: number;
 } & DisableCloseOnEscapeOrClickProps & OpenCloseTransitionStateEffects & import('react').RefAttributes<unknown>> & {
-    /**
-     * PopoverTrigger component for creating custom trigger elements.
-     *
-     * Features:
-     * - Supports custom trigger elements via render prop pattern
-     * - Automatic focus management and keyboard interaction
-     * - Hover and click event handling
-     * - Accessibility attributes (aria-haspopup, aria-expanded, aria-details)
-     * - Context integration with parent popover
-     * - Automatic tracking ID generation for analytics
-     *
-     * @example
-     * <Popover.Trigger>
-     *   {(props) => (
-     *     <button {...props}>
-     *       Click to open popover
-     *     </button>
-     *   )}
-     * </Popover.Trigger>
-     */
+    /** Render-prop trigger for a custom invoker. */
     Trigger: typeof PopoverTrigger;
-    /**
-     * PopoverContent component for the main popover content area.
-     *
-     * Features:
-     * - Automatic positioning and sizing based on trigger
-     * - Screen boundary detection and fitting
-     * - Scroll handling with custom scroller reference
-     * - Focus management and keyboard navigation
-     * - Hover interaction support for tooltip mode
-     * - Escape key handling for closing
-     * - Tab key trapping for modal popovers
-     * - Arrow/caret indicator with automatic positioning
-     * - Context integration with parent popover
-     * - Accessibility support with proper ARIA roles
-     *
-     * @example
-     * <Popover.Content>
-     *   <p>This is the popover content</p>
-     *   <Popover.Close>Close</Popover.Close>
-     * </Popover.Content>
-     */
+    /** Floating region positioned against the trigger. */
     Content: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "popover"> & {
         scrollerRef?: import('react').RefObject<HTMLDivElement>;
         hideWhileClosed?: boolean;
     } & import('react').RefAttributes<HTMLDivElement>>;
-    /**
-     * PopoverClose component for closing the popover.
-     *
-     * Features:
-     * - Automatic popover closing on click
-     * - Supports all Button component props and styling
-     * - Controlled and uncontrolled mode support
-     * - Context integration with parent popover
-     * - Accessibility support with proper button semantics
-     * - Delayed closing for controlled mode
-     * - Automatic tracking ID generation for analytics
-     *
-     * @example
-     * <Popover.Close>Close</Popover.Close>
-     */
+    /** Closes the popover, then runs its own click handler. */
     Close: import('react').ForwardRefExoticComponent<import('./PopoverClose').PopoverCloseProps & import('react').RefAttributes<HTMLButtonElement>>;
-    /**
-     * PopoverButton component for creating button-style triggers.
-     *
-     * Features:
-     * - Button styling and behavior with all Button props
-     * - Automatic popover opening on click
-     * - Hover interaction support for tooltip mode
-     * - Focus management and keyboard navigation
-     * - Accessibility attributes (aria-haspopup, aria-expanded, aria-details)
-     * - Context integration with parent popover
-     * - Event handling for mouse, keyboard, and focus events
-     * - Automatic tracking ID generation for analytics
-     *
-     * @example
-     * <Popover.Button>Click to open</Popover.Button>
-     */
+    /** Button-styled trigger that toggles the popover. */
     Button: import('react').ForwardRefExoticComponent<import('./PopoverButton').PopoverButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
 };

package/dist/src/components/Popover/PopoverButton.d.ts

@@ -1,33 +1,6 @@
 import { ButtonProps } from '../Button';
 import { DataTrackingId } from '../../types';
-/**
- * Props for the PopoverButton component
- * @extends ButtonProps
- */
+/** @extends ButtonProps */
 export type PopoverButtonProps = ButtonProps & DataTrackingId;
-/**
- * PopoverButton component for creating button-style triggers.
- *
- * Features:
- * - Button styling and behavior with all Button props
- * - Automatic popover opening on click
- * - Hover interaction support for tooltip mode
- * - Focus management and keyboard navigation
- * - Accessibility attributes (aria-haspopup, aria-expanded, aria-details)
- * - Context integration with parent popover
- * - Event handling for mouse, keyboard, and focus events
- *
- * @example
- * <Popover.Button>Click to open</Popover.Button>
- *
- * @example
- * <Popover.Button appearance="primary" size="large" icon={InfoIcon}>
- *   Information
- * </Popover.Button>
- *
- * @example
- * <Popover.Button onClick={() => console.log('Custom click handler')}>
- *   Custom handler
- * </Popover.Button>
- */
+/** Button trigger that toggles the enclosing popover. */
 export declare const PopoverButton: import('react').ForwardRefExoticComponent<PopoverButtonProps & import('react').RefAttributes<HTMLButtonElement>>;

package/dist/src/components/Popover/PopoverClose.d.ts

@@ -1,32 +1,6 @@
 import { ButtonProps } from '../Button';
 import { DataTrackingId } from '../../types';
-/**
- * Props for the PopoverClose component
- * @extends ButtonProps
- */
+/** @extends ButtonProps */
 export type PopoverCloseProps = ButtonProps & DataTrackingId;
-/**
- * PopoverClose component for closing the popover.
- *
- * Features:
- * - Automatic popover closing on click
- * - Supports all Button component props and styling
- * - Controlled and uncontrolled mode support
- * - Context integration with parent popover
- * - Accessibility support with proper button semantics
- * - Delayed closing for controlled mode
- *
- * @example
- * <Popover.Close>Close</Popover.Close>
- *
- * @example
- * <Popover.Close appearance="secondary" size="small">
- *   Cancel
- * </Popover.Close>
- *
- * @example
- * <Popover.Close onClick={() => console.log('Custom close handler')}>
- *   Close with custom handler
- * </Popover.Close>
- */
+/** Button that closes the enclosing popover, then runs its own click handler. */
 export declare const PopoverClose: import('react').ForwardRefExoticComponent<PopoverCloseProps & import('react').RefAttributes<HTMLButtonElement>>;

package/dist/src/components/Popover/PopoverContent.d.ts

@@ -1,53 +1,23 @@
 import { ComponentPropsWithoutRef, RefObject } from 'react';
 /**
- * Props for the PopoverContent component
- * @extends ComponentPropsWithoutRef<"div">
+ * @extends Omit<ComponentPropsWithoutRef<"div">, "popover">
  */
 export type PopoverContentProps = Omit<ComponentPropsWithoutRef<"div">, "popover"> & {
-    /**
-     * Reference to the scrollable content area
-     */
+    /** Ref to the inner scroller, not the floating root. */
     scrollerRef?: RefObject<HTMLDivElement>;
     /**
-     * Whether to remove the content from the DOM while the popover is closed
+     * Unmounts children while closed. Defaults to `false`, so content stays in
+     * the DOM (native `popover`) and visibility is the open check.
      */
     hideWhileClosed?: boolean;
 };
-/**
- * PopoverContent component for the main popover content area.
- *
- * Features:
- * - Automatic positioning and sizing based on trigger
- * - Screen boundary detection and fitting
- * - Scroll handling with custom scroller reference
- * - Focus management and keyboard navigation
- * - Hover interaction support for tooltip mode
- * - Escape key handling for closing
- * - Tab key trapping for modal popovers
- * - Arrow/caret indicator with automatic positioning
- * - Context integration with parent popover
- * - Accessibility support with proper ARIA roles
- *
- * @example
- * <Popover.Content>
- *   <p>This is the popover content</p>
- *   <Popover.Close>Close</Popover.Close>
- * </Popover.Content>
- *
- * @example
- * <Popover.Content scrollerRef={scrollRef}>
- *   <div style={{ height: '200px', overflow: 'auto' }}>
- *     {longContent}
- *   </div>
- * </Popover.Content>
- */
+/** Floating content region of a `Popover`. */
 export declare const PopoverContent: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "popover"> & {
-    /**
-     * Reference to the scrollable content area
-     */
+    /** Ref to the inner scroller, not the floating root. */
     scrollerRef?: RefObject<HTMLDivElement>;
     /**
-     * Whether to remove the content from the DOM while the popover is closed
+     * Unmounts children while closed. Defaults to `false`, so content stays in
+     * the DOM (native `popover`) and visibility is the open check.
      */
     hideWhileClosed?: boolean;
 } & import('react').RefAttributes<HTMLDivElement>>;

package/dist/src/components/Popover/PopoverTrigger.d.ts

@@ -11,43 +11,17 @@ type PopoverTriggerChildrenReturnType = {
     "aria-expanded": boolean;
     "aria-details": HTMLElement["id"];
 };
-/**
- * Props for the PopoverTrigger component
- */
 export type PopoverTriggerProps = {
     /**
-     * Render function that receives trigger props and returns a React element
+     * Render prop that must spread the given invoker handlers onto a focusable
+     * element.
+     *
+     * @example
+     * {(props) => <button {...props}>Open</button>}
      */
     children: (data: PopoverTriggerChildrenReturnType) => ReactElement;
 };
-/**
- * PopoverTrigger component for creating custom trigger elements.
- *
- * Features:
- * - Supports custom trigger elements via render prop pattern
- * - Automatic focus management and keyboard interaction
- * - Hover and click event handling
- * - Accessibility attributes (aria-haspopup, aria-expanded, aria-details)
- * - Context integration with parent popover
- *
- * @example
- * <Popover.Trigger>
- *   {(props) => (
- *     <button {...props}>
- *       Click to open popover
- *     </button>
- *   )}
- * </Popover.Trigger>
- *
- * @example
- * <Popover.Trigger>
- *   {(props) => (
- *     <div {...props} role="button" tabIndex={0}>
- *       Custom trigger element
- *     </div>
- *   )}
- * </Popover.Trigger>
- */
+/** Custom trigger via a render prop; full props live on {@link PopoverTriggerProps}. */
 export declare function PopoverTrigger(props: PopoverTriggerProps): ReactElement<any, string | import('react').JSXElementConstructor<any>> | undefined;
 export declare namespace PopoverTrigger {
     var displayName: string;

package/dist/src/components/Popover/internal/compareElements.d.ts

@@ -1 +1,2 @@
+/** True when two elements match tag, text, children, and attributes except `excludeAttributes`. */
 export declare function compareElements(el1: HTMLElement, el2: HTMLElement, excludeAttributes?: string[]): boolean;

package/dist/src/components/Popover/internal/usePopoverContext.d.ts

@@ -1,5 +1,6 @@
 import { KeyboardEvent } from 'react';
 export type dataStateType = "open" | "closed";
+/** Invoker and floating-element APIs for the enclosing popover. */
 export declare function usePopoverContext(): {
     invoker: {
         ref: import('react').RefObject<HTMLButtonElement>;