@servicetitan/anvil2 3.13.6 → 3.14.0

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;

package/dist/src/internal/flubber/parse.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 ParsedSegment = [string, ...number[]];
 export default function parse(path: string): ParsedSegment[];
 export {};

package/dist/src/internal/flubber/path-properties.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 PathPoint = {
     x: number;
     y: number;

package/dist/src/internal/functions/areOptionsValueEqual.d.ts

@@ -1,8 +1,5 @@
 /**
- * Deep value equality for select option lists (and nested tree nodes).
- *
- * Compares arrays and plain objects by contents so a new array/object identity
- * with the same data is treated as unchanged. Functions and React elements are
- * compared by reference.
+ * Compares option data deeply while keeping functions and React elements
+ * identity-sensitive.
  */
 export declare function areOptionsValueEqual(a: unknown, b: unknown): boolean;

package/dist/src/internal/functions/buildSelectItems.d.ts

@@ -10,10 +10,8 @@ type BuildSelectItemsParams<TID extends string | number> = {
     ungroupedItems: SelectItem<TID>[];
 };
 /**
- * Assembles the flat items array and sectionsMeta.
- * Order: prefixItems → pinned sections → group sections → ungrouped items.
- * Multi-select hooks pass bulk action items (select-all / select-filtered) as prefixItems;
- * single-select hooks omit it.
+ * Flattens normalized select sections into render items and indexed section
+ * metadata.
  */
 export declare function buildSelectItems<TID extends string | number>({ prefixItems, pinnedSections, groupSections, ungroupedItems, }: BuildSelectItemsParams<TID>): {
     items: SelectItem<TID>[];

package/dist/src/internal/functions/childrenToString.d.ts

@@ -1,25 +1,7 @@
 import { ReactNode } from 'react';
 /**
- * Recursively extracts text content from React children nodes.
- *
- * Features:
- * - Converts React children to plain text string
- * - Handles all React node types (strings, numbers, booleans, arrays, elements)
- * - Recursively processes nested React elements
- * - Extracts text from element children props
- * - Handles empty and null children gracefully
- * - Joins array children into single string
- * - Filters out non-text content automatically
- * - Returns empty string for unsupported node types
- *
- * Supported Node Types:
- * - String, number, boolean (converted to string)
- * - React elements (extracts children recursively)
- * - Arrays (processes each item and joins)
- * - Null, undefined (returns empty string)
- * - Objects (returns empty string)
- *
- * @param node - React node to convert to string
- * @returns Extracted text content as string, or empty string if no text content
+ * Flattens React children to concatenated text. Numbers and booleans stringify;
+ * elements contribute `props.children`; null, undefined, and plain objects
+ * become `""`.
  */
 export declare function childrenToString(node: ReactNode | object): string;

package/dist/src/internal/functions/getActiveElement.d.ts

@@ -1 +1,5 @@
+/**
+ * Deepest focused element, walking into open shadow roots and same-origin
+ * iframe documents.
+ */
 export declare const getActiveElement: (activeDocument: Document | ShadowRoot) => HTMLElement | null;