@servicetitan/anvil2 3.13.7 → 3.14.1

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

@@ -2,50 +2,29 @@ import { CSSProperties, RefObject, HTMLProps } from 'react';
 import { FloatingContext, MiddlewareData, Placement } from '@floating-ui/react';
 import { PopoverRole } from '../Popover';
 export type PopoverContextProps = {
-    /** Context object from useFloating; required by FloatingFocusManager and interaction hooks. */
     floatingContext: FloatingContext;
-    /** Callback refs from useFloating; setReference for the trigger, setFloating for the content. */
     refs: {
         setReference: (node: Element | null) => void;
         setFloating: (node: HTMLElement | null) => void;
     };
-    /** Inline positioning styles from useFloating; applied to the content element. */
     floatingStyles: CSSProperties;
-    /** Middleware output from useFloating; used for arrow positioning via middlewareData.arrow. */
     middlewareData: MiddlewareData;
-    /** Merged prop getter for the trigger; spreads ARIA attributes and event handlers. */
     getReferenceProps: (userProps?: HTMLProps<Element>) => Record<string, unknown>;
-    /** Merged prop getter for the content; spreads ARIA attributes and event handlers. */
     getFloatingProps: (userProps?: HTMLProps<HTMLElement>) => Record<string, unknown>;
-    /** Auto-generated id for the trigger element; used as the default aria-labelledby on content. */
     triggerId: string;
-    /** Current open/closed state. */
     openState: boolean;
-    /** Opens the popover. */
     openPopover: () => void;
-    /** Closes the popover. Fires onClose unless opened via hover. */
     closePopover: () => void;
-    /** Whether the open state is externally controlled. */
     controlled: boolean;
-    /** Resolved placement after flip/shift middleware; may differ from the placement prop. */
     actualPlacement: Placement;
-    /** Ref attached to the arrow span element inside PopoverContent. */
     arrowRef: RefObject<HTMLSpanElement>;
-    /** Whether the most recent close was keyboard-driven (e.g. Escape); drives the focus ring on the returned-to trigger. */
     closedViaKeyboardRef: RefObject<boolean>;
-    /** Whether the most recent close was FloatingFocusManager's non-modal Tab-out guard (reported via a FocusEvent); tells the focus-return effect to reclaim focus even though the browser's native Tab has already moved it past the trigger. */
     closedViaTabOutRef: RefObject<boolean>;
-    /** Clears closedViaKeyboardRef/closedViaTabOutRef. Call once the focus-return effect has reacted to a close event, so a later unrelated re-run of that effect (while still closed) doesn't reuse a stale close-reason signal. */
     clearCloseReasonRefs: () => void;
-    /** Whether the popover traps focus (modal) or closes on Tab-out (non-modal). Only applies when role is "dialog". */
     modal?: boolean;
-    /** Whether the popover opens on hover/focus instead of click. Only applies when role is "dialog". */
     openOnHover: boolean;
-    /** Whether to remove default padding from the content area. */
     noPadding?: boolean;
-    /** Whether to show the arrow/caret indicator. */
     enableCaret?: boolean;
-    /** The ARIA role of the popup. Drives FloatingFocusManager and ARIA attribute behavior. */
     role: PopoverRole;
 };
 export declare const PopoverContext: import('react').Context<PopoverContextProps | null>;

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

@@ -1,6 +1,4 @@
 /**
- * Returns the PopoverContext for use within Popover compound components.
- * @returns The current PopoverContextProps value.
- * @throws Error if called outside a Popover component.
+ * Reads the enclosing popover state and rejects use outside the compound root.
  */
 export declare function usePopoverContext(): import('./PopoverContext').PopoverContextProps;

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

@@ -2,12 +2,20 @@ import { SelectItem, GetItemPropsFn } from '../types/selectFieldInternalTypes';
 import { CheckState } from '../../types';
 export type SelectOptionProps = {
     item: SelectItem;
+    /** Position passed to the host's item-prop getter. */
     index: number;
+    /** Whether the host currently highlights this row. */
     highlighted: boolean;
+    /** Applies disabled row styling. */
     disabled: boolean;
+    /** Supplies the host listbox's interaction and accessibility props. */
     getItemProps: GetItemPropsFn;
+    /** Chooses a leading checkbox or trailing selected checkmark. */
     selectionType: "single" | "multiple";
+    /** Selection state shown by the row indicator. */
     checked: CheckState;
+    /** Adds separation styling to sticky bulk-action rows after scrolling. */
     isListScrolled?: boolean;
 };
+/** Renders a select item with its content and selection indicator. */
 export declare const SelectOption: ({ item, index, highlighted, disabled, getItemProps, selectionType, checked, isListScrolled, }: SelectOptionProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -3,21 +3,36 @@ import { CSSProperties } from 'react';
 import { OptionsPanelHandle } from './OptionsPanel';
 import { GetItemPropsFn, GetMenuPropsFn, SectionMeta, SelectItem } from '../types/selectFieldInternalTypes';
 export type SelectOptionsProps = {
+    /** When false, option rows stay unmounted inside the menu scroller. */
     isOpen: boolean;
+    /** Flattened option, pinned/group, and bulk-action rows. */
     items: SelectItem[];
+    /** Downshift getter for the menu scroller. */
     getMenuProps: GetMenuPropsFn;
+    /** Downshift getter for each option row. */
     getItemProps: GetItemPropsFn;
+    /** Host highlight index into `items`. */
     highlightedIndex: number;
+    /** Current single selection; pinned/grouped copies match on `original.id`. */
     selectedOption: SelectFieldOption | null;
+    /** When true, shows the load-more control. */
     hasMore: boolean;
+    /** Fetches the next page of options. */
     onLoadMore: () => void;
+    /** Replaces the list with a spinner while the current page loads. */
     loading: boolean;
+    /** Spinner in the load-more slot. */
     loadingMore: boolean;
+    /** Skips automatic next-page fetch; the Load more button remains. */
     disableAutoLoadMore?: boolean;
+    /** Disables every row, in addition to per-item `disabled`. */
     disabled?: boolean;
     className?: string;
     style?: CSSProperties;
+    /** Pinned and group ranges over `items`. */
     sectionsMeta?: SectionMeta[];
+    /** Uses the virtualized panel when true. Defaults to the non-virtual list. */
     virtualize?: boolean;
 };
+/** Single-select option list. Forwards to {@link OptionsPanel} or the virtualized panel. */
 export declare const SelectOptions: import('react').ForwardRefExoticComponent<SelectOptionsProps & import('react').RefAttributes<OptionsPanelHandle>>;

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

@@ -1,4 +1,5 @@
 import { ComponentPropsWithoutRef } from 'react';
 export type ShadowProps = ComponentPropsWithoutRef<"div">;
+/** Open shadow-root test host. Clones document styles into the tree. */
 export declare const Shadow: ({ children, ...rest }: ShadowProps) => import("react/jsx-runtime").JSX.Element;
 export default Shadow;

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

@@ -1,44 +1,15 @@
 import { PassThroughPropsWithRef, Size } from '../../../types';
-/**
- * The visual variant of the StatusIcon.
- */
 export type StatusIconVariant = "info" | "success" | "warning" | "error";
-/**
- * Props for the StatusIcon component
- * @property {StatusIconVariant} variant - The visual variant of the status icon
- */
 export type StatusIconProps = {
-    /**
-     * The visual variant of the status icon.
-     */
+    /** Includes `info`. `error` uses the danger glyph. */
     variant: StatusIconVariant;
-    /**
-     * Props spread onto the root `<span>` element.
-     */
+    /** Extra attributes on the root `<span>`. Merged `className` is concatenated. */
     rootProps?: PassThroughPropsWithRef<"span">;
-    /**
-     * Additional class names to apply to the root `<span>` element.
-     */
     className?: string;
-    /**
-     * The size of the status icon.
-     */
+    /** Glyph size. Defaults to `medium`. */
     size?: Extract<Size, "small" | "medium" | "large" | "xlarge">;
 };
-/**
- * StatusIcon component for displaying a status indicator icon.
- *
- * Features:
- * - Supports success, warning, and error variants
- * - Uses semantic status colors from design tokens
- * - Lightweight and composable
- *
- * @example
- * <StatusIcon variant="info" />
- * <StatusIcon variant="success" />
- * <StatusIcon variant="warning" />
- * <StatusIcon variant="error" />
- */
+/** Status glyph. */
 export declare const StatusIcon: {
     (props: StatusIconProps): import("react/jsx-runtime").JSX.Element;
     displayName: string;

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

@@ -1,25 +1,14 @@
 import { ComponentPropsWithoutRef, ReactElement, ReactNode, RefObject } from 'react';
-/**
- * Props for the Surface component.
- * @property {ReactNode} [children] - Content rendered inside the Surface provider.
- * @property {boolean} open - Controls whether the associated surface content is visible.
- * @property {string} [id] - Stable id used to connect the trigger and content for accessibility.
- */
 export type SurfaceProps = {
+    /** Compound `Trigger` and `Content`. */
     children?: ReactNode;
+    /** Whether `Content` is shown. */
     open: boolean;
+    /** Shared id for trigger and content. Defaults to a generated `surface-*` id. */
     id?: string;
 };
-/**
- * Props passed to the Surface trigger render function.
- * @property {(node: Element | null) => void} ref - Assigns the trigger element as the positioning reference.
- * @property {string} id - Id used by the content element to identify its trigger.
- * @property {string} aria-controls - Id of the controlled surface content element.
- * @property {"dialog"} aria-haspopup - Identifies the controlled content as dialog-like UI.
- * @property {boolean} aria-expanded - Indicates whether the surface content is currently open.
- * @property {"open" | "closed"} data-state - Mirrors the open state for styling hooks.
- */
 export type SurfaceTriggerChildrenProps = {
+    /** Assigns the trigger as the floating-ui reference. */
     ref: (node: Element | null) => void;
     id: string;
     "aria-controls": string;
@@ -27,83 +16,63 @@ export type SurfaceTriggerChildrenProps = {
     "aria-expanded": boolean;
     "data-state": "open" | "closed";
 };
-/**
- * Props for the SurfaceTrigger component.
- * @property {(props: SurfaceTriggerChildrenProps) => ReactElement} children - Render prop receiving accessibility and positioning props for the trigger element.
- */
 export type SurfaceTriggerProps = {
+    /** Render prop: spread the bag onto the real trigger element. */
     children: (props: SurfaceTriggerChildrenProps) => ReactElement;
 };
-/**
- * SurfaceTrigger component for wiring a trigger element to Surface content.
- *
- * Features:
- * - Provides ARIA attributes and open state for the trigger.
- * - Registers the trigger as the positioning reference.
- *
- * @param props SurfaceTrigger props including a trigger render function.
- * @returns The trigger element returned by the render function.
- */
+/** Wires a trigger element to Surface content via a render prop. */
 export declare function SurfaceTrigger({ children }: SurfaceTriggerProps): ReactElement<any, string | import('react').JSXElementConstructor<any>>;
 /**
- * Props for the SurfaceContent component.
- * @property {ReactNode} children - Main body rendered inside the positioned surface.
- * @property {() => void} onClose - Called when the user requests the surface to close and commit behavior is desired.
- * @property {() => void} [onCancel] - Called for cancellation flows such as Escape; falls back to onClose when omitted.
- * @property {ReactNode} [title] - Header title used as the default accessible label.
- * @property {ReactNode} [headerContent] - Additional header actions rendered before the close button.
- * @property {RefObject<HTMLElement | null>} [initialFocusRef] - Element focused after the surface opens.
- * @property {RefObject<HTMLElement | null>} [intersectionBoundaryRef] - Optional element that positioned content should intersect after placement or drag.
- * @property {number | string} [width] - Surface width as pixels or a CSS dimension.
- * @property {number | string} [maxHeight] - Maximum surface height as pixels or a CSS dimension.
- * @property {string} [closeButtonLabel] - Accessible label for the header close button.
  * @extends ComponentPropsWithoutRef<"div">
  */
 export type SurfaceContentProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "id" | "title"> & {
+    /** Body below the header. */
     children: ReactNode;
+    /** Close / commit (click-outside, header close). */
     onClose: () => void;
+    /** Escape. Defaults to `onClose`. */
     onCancel?: () => void;
+    /** Header title; also the default accessible name via `aria-labelledby`. */
     title?: ReactNode;
+    /** Extra header actions, rendered before the close button. */
     headerContent?: ReactNode;
+    /** Focused on open (next animation frame). */
     initialFocusRef?: RefObject<HTMLElement | null>;
+    /** After place/drag/resize, keep overlapping this element's box. */
     intersectionBoundaryRef?: RefObject<HTMLElement | null>;
+    /** CSS width. Numbers become `px`. Defaults to `325px`. */
     width?: number | string;
+    /** CSS max-height. Numbers become `px`. Defaults to `450px`. */
     maxHeight?: number | string;
+    /** Close-button accessible name. Defaults to `"Close surface"`. */
     closeButtonLabel?: string;
 };
-/**
- * SurfaceContent component for rendering positioned, non-modal content as a manual popover.
- *
- * Features:
- * - Positions content relative to the Surface trigger.
- * - Supports accessible labels, close behavior, and viewport-aware sizing.
- *
- * @param props SurfaceContent props including close handlers, labels, dimensions, and content.
- * @param ref Ref forwarded to the surface content element.
- * @returns Positioned surface content when rendered within a Surface provider.
- */
+/** Positioned non-modal content (`popover="manual"`); below `md` it becomes a drawer. */
 export declare const SurfaceContent: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "title" | "id" | "children"> & {
+    /** Body below the header. */
     children: ReactNode;
+    /** Close / commit (click-outside, header close). */
     onClose: () => void;
+    /** Escape. Defaults to `onClose`. */
     onCancel?: () => void;
+    /** Header title; also the default accessible name via `aria-labelledby`. */
     title?: ReactNode;
+    /** Extra header actions, rendered before the close button. */
     headerContent?: ReactNode;
+    /** Focused on open (next animation frame). */
     initialFocusRef?: RefObject<HTMLElement | null>;
+    /** After place/drag/resize, keep overlapping this element's box. */
     intersectionBoundaryRef?: RefObject<HTMLElement | null>;
+    /** CSS width. Numbers become `px`. Defaults to `325px`. */
     width?: number | string;
+    /** CSS max-height. Numbers become `px`. Defaults to `450px`. */
     maxHeight?: number | string;
+    /** Close-button accessible name. Defaults to `"Close surface"`. */
     closeButtonLabel?: string;
 } & import('react').RefAttributes<HTMLDivElement>>;
 /**
- * Surface component for coordinating trigger and content state in compound overlay UI.
- *
- * Features:
- * - Connects trigger and content with shared accessibility ids.
- * - Tracks the trigger element for floating positioning.
- * - Exposes Surface.Trigger and Surface.Content compound components.
+ * Compound overlay: `Trigger` (render prop) plus positioned `Content`.
  *
- * @param props Surface props including open state, optional id, and compound children.
- * @returns A Surface context provider that coordinates compound components.
  * @example
  * <Surface open={open}>
  *   <Surface.Trigger>
@@ -115,31 +84,29 @@ export declare const SurfaceContent: import('react').ForwardRefExoticComponent<O
  * </Surface>
  */
 export declare const Surface: (({ children, open, id }: SurfaceProps) => import("react/jsx-runtime").JSX.Element) & {
-    /**
-     * SurfaceTrigger component for wiring a trigger element to Surface content.
-     *
-     * Features:
-     * - Provides ARIA attributes and open state for the trigger.
-     * - Registers the trigger as the positioning reference.
-     */
+    /** Render-prop trigger that registers the positioning reference. */
     Trigger: typeof SurfaceTrigger;
-    /**
-     * SurfaceContent component for rendering positioned, non-modal content as a manual popover.
-     *
-     * Features:
-     * - Positions content relative to the Surface trigger.
-     * - Supports accessible labels, close behavior, and viewport-aware sizing.
-     */
+    /** Positioned non-modal content; drawer below `md`. */
     Content: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "title" | "id" | "children"> & {
+        /** Body below the header. */
         children: ReactNode;
+        /** Close / commit (click-outside, header close). */
         onClose: () => void;
+        /** Escape. Defaults to `onClose`. */
         onCancel?: () => void;
+        /** Header title; also the default accessible name via `aria-labelledby`. */
         title?: ReactNode;
+        /** Extra header actions, rendered before the close button. */
         headerContent?: ReactNode;
+        /** Focused on open (next animation frame). */
         initialFocusRef?: RefObject<HTMLElement | null>;
+        /** After place/drag/resize, keep overlapping this element's box. */
         intersectionBoundaryRef?: RefObject<HTMLElement | null>;
+        /** CSS width. Numbers become `px`. Defaults to `325px`. */
         width?: number | string;
+        /** CSS max-height. Numbers become `px`. Defaults to `450px`. */
         maxHeight?: number | string;
+        /** Close-button accessible name. Defaults to `"Close surface"`. */
         closeButtonLabel?: string;
     } & import('react').RefAttributes<HTMLDivElement>>;
 };

package/dist/src/internal/components/Surface/surfaceGeometry.d.ts

@@ -1,3 +1,4 @@
+/** Inset from the viewport edge used when clamping position and size. */
 export declare const SURFACE_VIEWPORT_PADDING = 8;
 export declare const SURFACE_MIN_WIDTH = 240;
 export declare const SURFACE_MIN_HEIGHT = 120;
@@ -5,8 +6,11 @@ export type SurfaceGeometry = {
     x: number;
     y: number;
     width: number;
+    /** Explicit height after resize; `null` means auto height. */
     height: number | null;
+    /** When true, auto-placement must not overwrite user x/y/width. */
     isUserModified: boolean;
+    /** When true, an explicit height is applied instead of max-height. */
     hasUserResized: boolean;
 };
 export type SurfaceViewport = {
@@ -20,12 +24,20 @@ export type SurfaceRect = {
     height: number;
 };
 export type ClampSurfaceGeometryOptions = {
+    /** Used when `height` is `null`. */
     measuredHeight?: number;
+    /** After clamp, keep at least 1px overlap with this rect when possible. */
     intersectionBoundary?: SurfaceRect | null;
 };
+/** Remaining viewport width to the right of `x`, floored at {@link SURFACE_MIN_WIDTH}. */
 export declare function getMaxSurfaceWidth(viewport: SurfaceViewport, x: number): number;
+/** Remaining viewport height below `y`, floored at {@link SURFACE_MIN_HEIGHT}. */
 export declare function getMaxSurfaceHeight(viewport: SurfaceViewport, y: number): number;
+/** True when the rects overlap by more than a shared edge. */
 export declare function hasStrictRectIntersection(rect: SurfaceRect, boundary: SurfaceRect): boolean;
+/** Clamps to the padded viewport, then restores optional boundary overlap. */
 export declare function clampSurfaceGeometry(geometry: SurfaceGeometry, viewport: SurfaceViewport, options?: ClampSurfaceGeometryOptions): SurfaceGeometry;
+/** Size-only clamp so a live resize does not slide `x`/`y` out from under the pointer. */
 export declare function clampActiveResizeSurfaceGeometry(geometry: SurfaceGeometry, viewport: SurfaceViewport): SurfaceGeometry;
+/** After resize ends, slides position so the surface intersects the boundary again. */
 export declare function restoreSurfaceGeometryIntersection(geometry: SurfaceGeometry, viewport: SurfaceViewport, options?: ClampSurfaceGeometryOptions): SurfaceGeometry;

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

@@ -1,2 +1,3 @@
 import { OptionsPanelProps, OptionsPanelHandle } from './OptionsPanel';
+/** Virtualized {@link OptionsPanel} scroller. */
 export declare const VirtualizedOptionsPanel: import('react').ForwardRefExoticComponent<OptionsPanelProps & import('react').RefAttributes<OptionsPanelHandle>>;

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

@@ -1,67 +1,33 @@
 import { PassThroughProps } from '../../../types';
 export interface YearSelectorProps {
-    /**
-     * The minimum selectable year
-     * Defaults to 1900.
-     */
+    /** Inclusive lower bound. Defaults to `1900`. */
     min?: number;
-    /**
-     * The maximum selectable year.
-     * Defaults to 2200.
-     */
+    /** Inclusive upper bound. Defaults to `2200`. */
     max?: number;
-    /**
-     * The currently selected year
-     */
+    /** Controlled selected year. `null` means none. */
     value?: number | null;
-    /**
-     * The default value of the selected year
-     */
+    /** Uncontrolled initial selection. Defaults to none. */
     defaultValue?: number;
-    /**
-     * The function to call when the selected year changes
-     *
-     * @param year - The year that is selected.
-     */
+    /** Fires when the selected year changes, including keyboard moves. */
     onChange?: (year: number | null) => void;
-    /**
-     * The function to call when the selected year is affirmatively changed.
-     * This is called when the user confirms the selection by pressing Enter, pressing Space, or clicking.
-     *
-     * @param year - The year that is selected.
-     */
+    /** Fires on click, Enter, or Space — not on arrow-key moves. */
     onConfirm?: (year: number | null) => void;
     /**
-     * If a `value` or `defaultValue` is not provided, this will be used as the starting scroll position (and initial focus for accessibility).
+     * Scroll and roving-focus target when nothing is selected.
+     * Defaults to the current calendar year.
      */
     startingYear?: number;
-    /**
-     * The number of columns to display.
-     * @default 2
-     */
+    /** Grid column count. Values below `1` become `1`. Defaults to `2`. */
     columns?: number;
-    /**
-     * The class name to apply to the component.
-     */
     className?: string;
-    /**
-     * Controls whether a year can be deselected, i.e. set to null.
-     * @default false
-     */
+    /** When true, the selection cannot be cleared to `null`. Defaults to `false`. */
     required?: boolean;
-    /**
-     * Controls whether the component allows the user to select a year.
-     * @default false
-     */
+    /** Blocks selection changes; the list still scrolls and receives keys. Defaults to `false`. */
     disabled?: boolean;
-    /**
-     * The aria-label for the component.
-     * @default "Year selection"
-     */
+    /** Accessible name on the spinbutton. Defaults to `"Year selection"`. */
     ariaLabel?: string;
-    /**
-     * Props forwarded onto the root element of the component.
-     */
+    /** Merged last onto the spinbutton, so it can override the built-in ARIA. */
     rootProps?: PassThroughProps<"div">;
 }
+/** Virtualized year grid with spinbutton keyboard behavior. */
 export declare const YearSelector: import('react').ForwardRefExoticComponent<YearSelectorProps & import('react').RefAttributes<HTMLDivElement>>;

package/dist/src/internal/components/YearSelector/internal/YearItem.d.ts

@@ -6,5 +6,6 @@ type YearItemProps = Omit<ComponentPropsWithoutRef<"div">, "onChange"> & {
     pseudoFocused: boolean;
     disabled: boolean;
 };
+/** One year cell in the virtualized grid. */
 export declare const YearItem: ({ year, onChange, selected, pseudoFocused, disabled, onFocus, ...rest }: YearItemProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/src/internal/components/YearSelector/internal/useYearSelectorKeys.d.ts

@@ -16,4 +16,8 @@ export type UseYearSelectorKeysParams = {
 export type UseYearSelectorKeysReturn = {
     listRef: React.RefObject<HTMLDivElement>;
 };
+/**
+ * Binds arrow / page / home keys to move-and-select, Enter and Space to
+ * confirm, and Backspace / Delete to clear when not required.
+ */
 export declare const useYearSelectorKeys: ({ columns, scrollToYear, initialFocus, onSelect, onConfirm, pseudoFocused, setPseudoFocused, min, max, disabled, required, }: UseYearSelectorKeysParams) => UseYearSelectorKeysReturn;

package/dist/src/internal/constants/anvParts.d.ts

@@ -1,38 +1,4 @@
-/**
- * `data-anv-part` — the internally-managed test attribute for targeting the
- * interactive sub-elements of complex Anvil2 components in end-to-end tests.
- *
- * Scoping model (two independent axes — use either or both):
- * - **Component type**: the component's existing `data-anv` root value
- *   (e.g. `data-anv="data-table-base"`). Stable, already present on most roots.
- * - **Instance**: a consumer-supplied `data-*` (e.g. `data-cy`) forwarded to the
- *   root. The consumer owns this.
- *
- * A test then queries `[data-anv="<component>"] [data-anv-part="row"]` or
- * `[data-cy="x"] [data-anv-part="row"]`. Because the part is always read in the
- * context of a component, **part names only need to be unique within a single
- * component** — `header`, `row`, and `item` may repeat across components.
- *
- * Kept separate from `data-anv` (which holds structural/decorative values like
- * "popover-content" or "button"); the two attributes coexist on an element.
- *
- * ## Where part names live
- *
- * Each component owns its part names in a co-located `parts.ts` next to its
- * source (e.g. `beta/components/Table/parts.ts`):
- *
- *     import { ANV_PART_ATTR } from "../../../internal/constants/anvParts";
- *     export const PARTS = {
- *       row: "row",
- *       cell: "cell",
- *       sortToggle: "sort-toggle",
- *     } as const;
- *
- * This file centralizes only (1) the attribute name and (2) the small set of
- * roles that recur across many components, so their *string values* stay
- * identical everywhere. Prefer a `COMMON_PART` value when one fits; otherwise
- * define a component-specific name in that component's `parts.ts`.
- */
+/** Internally-managed test hook attribute. Distinct from `data-anv` (structural). */
 export declare const ANV_PART_ATTR: "data-anv-part";
 /**
  * Cross-cutting part roles whose string values must match across components so
@@ -40,42 +6,24 @@ export declare const ANV_PART_ATTR: "data-anv-part";
  * co-located `parts.ts` rather than re-typing the literals.
  */
 export declare const COMMON_PART: {
-    /** Element that opens a menu/popover/dialog/drawer. */
     readonly trigger: "trigger";
-    /** Free-text entry. */
     readonly input: "input";
-    /** Button that clears the current value/selection. */
     readonly clearButton: "clear-button";
-    /** Button that opens/closes an adjacent surface. */
+    /** Opens or closes an adjacent surface — not the overlay `trigger`. */
     readonly toggleButton: "toggle-button";
-    /** Button that commits a pending selection. */
     readonly applyButton: "apply-button";
-    /** Button that dismisses a surface without committing. */
     readonly cancelButton: "cancel-button";
-    /** Listbox/menu container. */
     readonly menu: "menu";
-    /** A single option/row within a menu. */
     readonly option: "option";
-    /** A selected-value chip. */
     readonly chip: "chip";
-    /** Dialog container (top layer). */
     readonly dialog: "dialog";
-    /** Popover container (top layer). */
     readonly popover: "popover";
-    /** Drawer container (top layer). */
     readonly drawer: "drawer";
-    /** Masked text input of a date / date-range field. */
     readonly dateInput: "date-input";
-    /** Calendar surface of a date / date-range field. */
     readonly dateCalendar: "date-calendar";
-    /** Affordance that adds a new item from a select/combobox menu. */
     readonly addNewItemButton: "add-new-item-button";
-    /** Lazy-load control inside a virtualized/paged options list. */
     readonly loadMoreButton: "load-more-button";
-    /**
-     * "+N" overflow indicator when selected-value chips exceed the visible
-     * budget. Distinct from `chip` (real selected values).
-     */
+    /** "+N" overflow indicator. Distinct from `chip` (a real selected value). */
     readonly overflowChip: "overflow-chip";
 };
 export type CommonPart = (typeof COMMON_PART)[keyof typeof COMMON_PART];

package/dist/src/internal/flubber/a2c.d.ts

@@ -1,7 +1,3 @@
-/**
- * Derived from svg-path-properties@0.2.2 and svgpath/a2c vendored by flubber@0.4.2 (MIT).
- * Adapted for dependency-free internal ESM use in anvil2.
- */
 type ArcCurve = [
     number,
     number,

package/dist/src/internal/flubber/arc.d.ts

@@ -1,7 +1,3 @@
-/**
- * Derived from svg-path-properties@0.2.2 vendored by flubber@0.4.2 (MIT).
- * Adapted for dependency-free internal ESM use in anvil2.
- */
 type Point = {
     x: number;
     y: number;

package/dist/src/internal/flubber/bezier.d.ts

@@ -1,7 +1,3 @@
-/**
- * Derived from svg-path-properties@0.2.2 vendored by flubber@0.4.2 (MIT).
- * Adapted for dependency-free internal ESM use in anvil2.
- */
 type Point = {
     x: number;
     y: number;

package/dist/src/internal/flubber/errors.d.ts

@@ -1,5 +1 @@
-/**
- * Derived from flubber@0.4.2 (MIT).
- * Adapted for dependency-free internal ESM use in anvil2.
- */
 export declare const INVALID_INPUT = "All shapes must be supplied as arrays of [x, y] points or an SVG path string (https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/d).\nExample valid ways of supplying a shape would be:\n[[0, 0], [10, 0], [10, 10]]\n\"M0,0 L10,0 L10,10Z\"\n";

package/dist/src/internal/flubber/index.d.ts

@@ -1,6 +1,2 @@
-/**
- * Derived from flubber@0.4.2 (MIT).
- * Adapted for dependency-free internal ESM use in anvil2.
- */
 export { interpolate } from './interpolate';
 export type { InterpolateOptions } from './interpolate';

package/dist/src/internal/flubber/interpolate.d.ts

@@ -1,7 +1,10 @@
 import { normalizeRing } from './normalize';
 export type InterpolateOptions = {
+    /** Maximum straight-segment length used to approximate curves. Defaults to `10`. */
     maxSegmentLength?: number;
+    /** Returns SVG path data when true and point rings when false. Defaults to `true`. */
     string?: boolean;
 };
+/** Creates a point-wise morph between two SVG paths. */
 export declare function interpolate(fromShape: string, toShape: string, { maxSegmentLength, string }?: InterpolateOptions): (t: number) => string | import('./math').RingPoint[];
 export declare function interpolateRing(fromRing: ReturnType<typeof normalizeRing>, toRing: ReturnType<typeof normalizeRing>, string: boolean): (t: number) => string | import('./math').RingPoint[];

package/dist/src/internal/flubber/linear.d.ts

@@ -1,7 +1,3 @@
-/**
- * Derived from svg-path-properties@0.2.2 vendored by flubber@0.4.2 (MIT).
- * Adapted for dependency-free internal ESM use in anvil2.
- */
 type Point = {
     x: number;
     y: number;