@servicetitan/anvil2 3.13.7 → 3.14.0

package/dist/src/internal/utils/layerManager.d.ts

@@ -1,11 +1,4 @@
-/**
- * Global layer manager for tracking overlay component stacking order.
- * Uses window-level state to support cross-bundle communication (e.g., MFEs).
- *
- * When multiple Dialog/Drawer components are open, only the topmost layer
- * should respond to outside click events. This manager tracks the z-order
- * to enable that behavior.
- */
+/** Window key shared by separately bundled Anvil2 instances. */
 declare const WINDOW_PROPERTY_LAYER_STACK: "__ANVIL_LAYER_MANAGER__";
 declare global {
     interface Window {
@@ -13,31 +6,15 @@ declare global {
     }
 }
 /**
- * Register a new layer in the stack.
- * If the layer is already registered, this is a no-op.
- *
- * @param id - Unique identifier for the layer
+ * Adds an unregistered layer to the top of the global stack.
  */
 export declare const registerLayer: (id: string) => void;
 /**
- * Unregister a layer from the stack.
- * If the layer is not found, this is a no-op.
- *
- * @param id - Unique identifier for the layer
+ * Removes a registered layer without disturbing the remaining order.
  */
 export declare const unregisterLayer: (id: string) => void;
-/**
- * Check if a layer is the topmost layer in the stack.
- *
- * @param id - Unique identifier for the layer
- * @returns True if the layer is on top, false otherwise
- */
+/** Checks whether a layer is currently at the top of the global stack. */
 export declare const isTopLayer: (id: string) => boolean;
-/**
- * Get all registered layers in order (bottom to top).
- * Returns a readonly copy for debugging purposes.
- *
- * @returns Readonly array of layer IDs
- */
+/** Returns a bottom-to-top snapshot of the registered layer IDs. */
 export declare const getLayers: () => readonly string[];
 export {};

package/dist/src/internal/utils/uniquifySvgDomIds.d.ts

@@ -3,8 +3,6 @@
  * `svgRoot` so multiple instances of the same SVG do not collide in the
  * document. Idempotent when called again with the same `idPrefix`.
  *
- * Fast path: returns immediately when the SVG has no `[id]` attributes.
- *
  * Walks elements and reads attributes directly instead of building attribute
  * selectors — namespaced attrs like `xlink:href` are not valid in
  * `querySelectorAll('[xlink:href]')`.

package/dist/src/providers/AnvilProvider/AnvilProvider.d.ts

@@ -1,2 +1,6 @@
 import { AnvilProviderProps } from './AnvilProviderContext';
+/**
+ * Root provider for an Anvil2 application subtree. Establishes the scoped
+ * styles and shared defaults expected by Anvil2 components.
+ */
 export declare const AnvilProvider: (props: AnvilProviderProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/providers/AnvilProvider/AnvilProviderContext.d.ts

@@ -4,11 +4,8 @@ import { LayoutUtilProps } from '../../types';
 import { ITranslations } from '../LocalizationProvider/LocalizationProvider';
 import { BreakpointReturnProps } from '../../hooks/useBreakpoint';
 /**
- * @deprecated No longer has any effect. Automatically loading these
- * stylesheets through a dynamic import broke CSS delivery when
- * `AnvilProvider` is shared between a host application and its
- * micro-frontends. Import the `@servicetitan/anvil2/assets/css-utils/*.css`
- * file(s) you need directly instead. See the CSS Utilities docs.
+ * @deprecated No longer has any effect. Import the required
+ * `@servicetitan/anvil2/assets/css-utils/*.css` files directly.
  */
 export type CssUtilsOptions = boolean | {
     spacing?: boolean;
@@ -18,34 +15,47 @@ export type CssUtilsOptions = boolean | {
 };
 export type AnvilProviderProps = ComponentPropsWithoutRef<"div"> & LayoutUtilProps & {
     children?: ReactNode;
+    /** Configures the nested theme provider; omitted values inherit. */
     themeData?: {
+        /** Custom token values. Inherits the nearest theme when omitted. */
         theme?: ThemeProviderProps["theme"];
+        /** Color mode. Inherits the nearest mode when omitted. */
         mode?: ThemeProviderProps["mode"];
     };
+    /** Establishes locale, direction, and messages for localized descendants. */
     localizationData?: {
+        /** Language tag exposed to localized descendants. Defaults to `"en"`. */
         locale?: ITranslations["locale"];
+        /** Text direction applied to the provider wrapper. Defaults to `"ltr"`. */
         dir?: ITranslations["dir"];
+        /** Messages resolved by localized descendants. Defaults to an empty map. */
         translations?: ITranslations["translations"];
     };
     /**
      * @deprecated No longer has any effect. Import the
      * `@servicetitan/anvil2/assets/css-utils/*.css` file(s) you need
-     * directly instead. See the CSS Utilities docs.
+     * directly instead.
      */
     cssUtils?: CssUtilsOptions;
 } & {
+    /** Controls the scope and opt-out policy for descendant tracking IDs. */
     trackingIdData?: {
+        /** Prefix included in generated tracking IDs. Defaults to `"ST"`. */
         scope?: string;
+        /** Whether descendants should omit tracking IDs. Defaults to `false`. */
         optOut?: boolean;
     };
 };
 export type AnvilProviderContextProps = {
+    /** Current viewport breakpoint, or `undefined` when unavailable. */
     breakpoint?: BreakpointReturnProps;
 };
+/** Breakpoint context populated by {@link AnvilProvider}. */
 export declare const AnvilProviderContext: import('react').Context<AnvilProviderContextProps>;
 export declare const TooltipLegacyGroupContext: import('react').Context<{
     disableDelayGroup: Dispatch<SetStateAction<boolean>>;
 } | null>;
+/** Reads legacy tooltip delay-group controls from {@link AnvilProvider}. */
 export declare const useTooltipLegacyGroup: () => {
     disableDelayGroup: Dispatch<SetStateAction<boolean>>;
 };

package/dist/src/providers/LocalizationProvider/LocalizationContext.d.ts

@@ -1,6 +1,13 @@
 export type TranslationContext = {
+    /** Language tag published to descendants. */
     locale: string;
+    /** Resolves a dotted key; returns the key when missing or not a string. */
     t(value: string): string;
 };
+/** Locale and `t` published by the nearest {@link LocalizationProvider}. */
 export declare const LocalizationContext: import('react').Context<TranslationContext>;
+/**
+ * Returns locale and `t` from the nearest {@link LocalizationContext}.
+ * Outside a provider, `locale` is `"en"` and `t` echoes the key.
+ */
 export declare const useLocalizationContext: () => TranslationContext;

package/dist/src/providers/LocalizationProvider/LocalizationProvider.d.ts

@@ -2,16 +2,22 @@ import { default as React, ReactNode, ComponentPropsWithoutRef } from 'react';
 import { LayoutUtilProps } from '../../types';
 type LocalizationProviderProps = ComponentPropsWithoutRef<"div"> & LayoutUtilProps & {
     children: ReactNode;
+    /** Locale, text direction, and message map for this subtree. */
     translationData: ITranslations;
 };
+/** Intermediate node while walking a dotted key through {@link Translations}. */
 export type TranslationResult = string | Translations | undefined;
 export interface Translations {
     [key: string]: TranslationResult;
 }
 export interface ITranslations {
+    /** Text direction applied to the provider wrapper. */
     dir: "ltr" | "rtl";
+    /** Language tag exposed to descendants. Defaults to `"en"` when omitted. */
     locale?: string;
+    /** Message tree walked by dotted keys (`"x.y.z"`). */
     translations: Translations;
 }
+/** Applies `dir` on a wrapper and publishes locale plus `t()` to descendants. */
 export declare const LocalizationProvider: React.FC<LocalizationProviderProps>;
 export {};

package/dist/src/providers/LocalizationProvider/LocalizationStoryWrapper.d.ts

@@ -2,5 +2,6 @@ import { FC, ReactNode } from 'react';
 interface WrapperProps {
     children: ReactNode;
 }
+/** Story helper: locale picker plus {@link LocalizationProvider}. */
 export declare const Wrapper: FC<WrapperProps>;
 export {};

package/dist/src/providers/LocalizationProvider/useTranslations.d.ts

@@ -1,4 +1,10 @@
 import { ITranslations } from './LocalizationProvider';
+/**
+ * Builds a `t` that walks dotted keys (`"x.y.z"`) through `translations`.
+ * Missing paths and non-string nodes return the key.
+ *
+ * @returns `{ translations }` where `translations` is that lookup function.
+ */
 export declare const useTranslations: (translations: ITranslations["translations"]) => {
     translations: (key: string) => string;
 };

package/dist/src/providers/PortalProvider/PortalProvider.d.ts

@@ -1,2 +1,3 @@
 import { PortalProviderProps } from './PortalProviderContext';
+/** Publishes a portal destination to a React subtree. */
 export declare const PortalProvider: (props: PortalProviderProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/providers/PortalProvider/PortalProviderContext.d.ts

@@ -1,9 +1,12 @@
 import { ReactNode } from 'react';
 export type PortalProviderProps = {
+    /** Element or mutable ref published as the portal destination. */
     root?: HTMLElement | React.MutableRefObject<HTMLElement | null> | null;
     children?: ReactNode;
 };
 export type PortalProviderContextProps = {
+    /** Published portal destination, or `undefined` when none is configured. */
     root?: HTMLElement | React.MutableRefObject<HTMLElement | null> | null;
 };
+/** Destination published by {@link PortalProvider}; empty outside a provider. */
 export declare const PortalProviderContext: import('react').Context<PortalProviderContextProps>;

package/dist/src/providers/ThemeProvider/ThemeProvider.d.ts

@@ -2,14 +2,30 @@ import { ComponentPropsWithoutRef, FC, ReactNode } from 'react';
 import { LayoutUtilProps } from '../../types';
 import { Token } from '@servicetitan/hammer-token';
 export type CustomThemeType = {
+    /** Overrides foundational token values. */
     primitive?: Partial<Token["primitive"]>;
+    /** Overrides semantic token values consumed across components. */
     semantic?: Partial<Token["semantic"]>;
+    /** Overrides tokens scoped to individual components. */
     component?: Partial<Token["component"]>;
 };
 export type ThemeProviderProps = Omit<ComponentPropsWithoutRef<"div">, "prefix"> & LayoutUtilProps & {
+    /**
+     * Partial Hammer token values emitted as CSS custom properties. Inherits
+     * the nearest theme when omitted.
+     */
     theme?: CustomThemeType;
+    /**
+     * Color mode for this subtree. Inherits the nearest mode; otherwise no
+     * mode class is applied.
+     */
     mode?: "light" | "dark";
     children?: ReactNode;
+    /** Prefix for generated CSS custom properties. Defaults to `"a2"`. */
     prefix?: string;
 };
+/**
+ * Scopes Hammer token overrides and color mode to a wrapper element. Nested
+ * providers inherit an omitted theme or mode.
+ */
 export declare const ThemeProvider: FC<ThemeProviderProps>;

package/dist/src/providers/ThemeProvider/index.d.ts

@@ -1,7 +1,7 @@
 export { ThemeProvider, type ThemeProviderProps, type CustomThemeType, } from './ThemeProvider';
 export type { 
 /**
- * @deprecated internal context type
+ * @deprecated Internal context contract; may change without notice.
  */
 ThemeProviderContextProps, } from './internal/ThemeProviderContext';
 export { useTheme } from './useTheme';

package/dist/src/providers/ThemeProvider/internal/ThemeProviderContext.d.ts

@@ -1,6 +1,8 @@
 import { CustomThemeType } from '../ThemeProvider';
 export type ThemeProviderContextProps = {
+    /** Effective custom theme after provider inheritance. */
     theme?: CustomThemeType;
+    /** Effective color mode after provider inheritance. */
     mode?: "light" | "dark";
     /**
      * CSS custom properties derived from `theme`. Top-layer surfaces that

package/dist/src/providers/ThemeProvider/themeToCssVars.d.ts

@@ -5,10 +5,9 @@ type ThemeTokenBags = {
     component?: Record<string, TokenObj>;
 };
 /**
- * Convert a custom theme object into CSS custom properties (`--a2-*`).
- *
- * Used by `ThemeProvider` on its wrapper and by top-layer surfaces that
- * re-apply `.theme-core` (which otherwise resets tokens to core defaults).
+ * Converts custom theme tokens into CSS custom properties, including
+ * `light-dark()` pairs when a dark appearance is available.
+ * Returns `undefined` when no theme is provided.
  */
 export declare function themeToCssVars(theme: ThemeTokenBags | undefined, prefix?: string): {
     [key: string]: string;

package/dist/src/providers/ThemeProvider/useTheme.d.ts

@@ -1 +1,6 @@
+/**
+ * Returns the effective custom theme, color mode, and CSS variables from the
+ * nearest {@link ThemeProvider}. Each field is `undefined` until supplied by a
+ * provider.
+ */
 export declare const useTheme: () => import('.').ThemeProviderContextProps;

package/dist/src/providers/TrackingProvider/TrackingProvider.d.ts

@@ -1,3 +1,4 @@
 import { FC } from 'react';
 import { TrackingProviderProps } from './TrackingProviderContext';
+/** Publishes `scope`, `optOut`, and `getTrackingId` to descendants. */
 export declare const TrackingProvider: FC<TrackingProviderProps>;

package/dist/src/providers/TrackingProvider/TrackingProviderContext.d.ts

@@ -1,13 +1,20 @@
 import { ReactNode } from 'react';
+/** Builds `_scope_component_` plus a truncated cipher of `data`. */
 export declare const getTrackingIdHelper: (data: string, component: string, scope: string) => Promise<string>;
 export interface TrackingProviderContextProps {
+    /** Prefix included in generated tracking IDs. */
     scope: string;
+    /** Deterministic id; same `data` + `component` + `scope` always match. */
     getTrackingId: (data: string, component: string) => Promise<string>;
+    /** When true, {@link useTrackingId} skips the lookup. */
     optOut: boolean;
 }
 export interface TrackingProviderProps {
     children: ReactNode;
+    /** Prefix included in generated tracking IDs. */
     scope: string;
+    /** Skip descendant tracking-id lookups. Defaults to `false`. */
     optOut?: boolean;
 }
+/** Tracking-id config published by the nearest {@link TrackingProvider}. */
 export declare const TrackingContext: import('react').Context<TrackingProviderContextProps>;

package/dist/src/providers/TrackingProvider/useTrackingContext.d.ts

@@ -1 +1,6 @@
+/**
+ * Returns `scope`, `optOut`, and `getTrackingId` from the nearest
+ * {@link TrackingProvider}. Outside a provider, `scope` is `"ST"` and
+ * `optOut` is `false`.
+ */
 export declare const useTrackingContext: () => import('./TrackingProviderContext').TrackingProviderContextProps;

package/dist/src/themes/carto.d.ts

@@ -1,47 +1,7 @@
 /**
- * Anvil2 theme overrides aligned with AI Kit (Carto) font families and radius
- * scale.
- *
- * Radius (Carto → Anvil2):
- * - `radius.sharp` → `BorderRadiusNone` (`0`)
- * - `radius.100` → `BorderRadiusSmall` (`0.25rem`, checkboxes)
- * - `radius.trim` → `BorderRadiusMedium` (`0.75rem`, buttons / inputs)
- * - `radius.moderate` → `BorderRadiusLarge` (`1rem`, cards / menus)
- * - `radius.generous` → `BorderRadiusXlarge` (`1.5rem`, panels)
- * - `radius.full` → `BorderRadiusCircular` (`50%`)
- *
- * Typography (Carto → Anvil2):
- * - `typography.fontFamily.functional` → base / paragraph / label family (Inter)
- * - `typography.fontFamily.expressive` → display / heading family (Sofia Pro)
- * - `typography.weight.neutral` → paragraph weight (`400`)
- * - `typography.weight.structured` → `FontWeightSemibold` (`500`; buttons, chips, labels)
- * - `typography.weight.emphatic` → heading weight (`700`)
- * - Bold UI emphasis → `FontWeightBold` (`600`; calendar selection, stepper, avatar, etc.)
- *
- * Components keep `$font-weight-semibold` / `$font-weight-bold` (and semantic
- * typography tokens for real text roles). Carto retunes those primitives so
- * existing component CSS picks up the new weights without per-component remaps.
- *
- * Surfaces (Carto → Anvil2):
- * - Popover / Menu content and arrow fills → `BackgroundColorDefault`
- *   (`var(--a2-background-color-default)`, which resolves via `light-dark()`).
- *   Applies anywhere that consumes `$popover-content-background-color` /
- *   `$popover-arrow-fill-color` (public Popover, internal Popover,
- *   OptionsPopover) or `$menu-content-background-color` /
- *   `$menu-arrow-background-color` (Menu). Tooltip uses a separate token and
- *   is unaffected.
- *
- * Consumers still need to load Inter (and Sofia Pro when using headings). The
- * kit loads Inter from Google Fonts; AnvilProvider already pulls in Sofia Pro
- * via `@servicetitan/anvil-fonts`.
- *
- * @example
- * ```tsx
- * import { ThemeProvider } from "@servicetitan/anvil2";
- * import { carto } from "@servicetitan/anvil2/themes";
- *
- * <ThemeProvider theme={carto}>{children}</ThemeProvider>
- * ```
+ * Carto-aligned {@link CustomThemeType}: Inter/Sofia Pro, retuned radius and
+ * weights, and default-background Popover/Menu surfaces. Tooltip tokens are
+ * unchanged. Load Inter yourself; {@link AnvilProvider} already loads Sofia Pro.
  */
 export declare const carto: {
     readonly primitive: {

package/dist/src/types/DataTrackingId.d.ts

@@ -1,3 +1,4 @@
+/** Mix-in for the `data-tracking-id` attribute. */
 export type DataTrackingId = {
     ["data-tracking-id"]?: string;
 };

package/dist/src/types/DistributiveOmit.d.ts

@@ -1,15 +1,2 @@
-/**
- * Use to Omit props from types that include unions.
- *
- * Example:
- * type A = {
- *   prop?: string;
- *   otherProp?: false;
- * } | {
- *   prop: string;
- *   otherProp: true;
- * };
- * type B = A & { thirdProp: boolean; };
- * type C = DistributiveOmit<C, "thirdProp">;
- */
+/** `Omit` that distributes over unions so unused-branch keys are not required. */
 export type DistributiveOmit<T, K extends keyof any> = T extends any ? Omit<T, K> : never;

package/dist/src/types/MaxLengthCounterProps.d.ts

@@ -1,4 +1,8 @@
 import { HelperProps } from '../internal/components/Helper';
+/**
+ * When `showCounter` is `true`, `maxLength` is required for the visible
+ * `inputLength/maxLength` counter.
+ */
 export type MaxLengthCounterProps = {
     showCounter: true;
     maxLength: HelperProps["maxLength"];

package/dist/src/types/PassThroughProps.d.ts

@@ -1,4 +1,7 @@
 import { ComponentPropsWithoutRef, ComponentPropsWithRef } from 'react';
+/** String-valued `data-*` attributes. */
 export type DataAttributes = Record<`data-${string}`, string>;
+/** Native element props plus `data-*` attributes. */
 export type PassThroughProps<T extends keyof JSX.IntrinsicElements> = ComponentPropsWithoutRef<T> & DataAttributes;
+/** {@link PassThroughProps} including `ref`. */
 export type PassThroughPropsWithRef<T extends keyof JSX.IntrinsicElements> = ComponentPropsWithRef<T> & DataAttributes;

package/dist/src/types/ai-marks.d.ts

@@ -1,72 +1,41 @@
 import { PopoverContentProps, PopoverDialogRoleProps } from '../internal/components/Popover';
 import { TooltipProps } from '../components';
-/**
- * Minimal props for showing an AI mark as a boolean flag (for example on `Chip`).
- * For the standalone icon component, use `AiMarkProps` on `AiMark` instead.
- */
+/** Sparkle-only mark; no tooltip or popover. */
 export type AiMarkBooleanProps = {
-    /**
-     * When `true`, displays the AI indicator icon with no additional context.
-     */
+    /** When `true`, shows the indicator with no extra context. */
     aiMark?: boolean;
 };
 /**
- * Configuration for an AI mark that opens a tooltip or popover for additional context.
- * Discriminated union: set `type` to `"tooltip"` or `"popover"` to select the corresponding configuration shape.
+ * `type` selects tooltip vs popover.
  */
 export type AiMarkWithTooltipOrPopoverConfig = {
-    /** Discriminant for the popover variant. */
     type: "popover";
-    /**
-     * The content displayed inside the popover. When omitted, defaults to the standard AI disclaimer message and a Learn more link to the privacy policy.
-     */
+    /** Popover body. Defaults to the AI disclaimer plus a privacy-policy link. */
     content?: React.ReactNode;
-    /**
-     * Additional props passed to the underlying `Popover` component.
-     */
+    /** Forwarded to the popover; the mark owns `children`. */
     props?: Omit<PopoverDialogRoleProps, "children">;
-    /**
-     * Accessible label for the trigger button that opens the popover.
-     */
+    /** Accessible name for the trigger. */
     triggerLabel: string;
-    /**
-     * Additional props passed to the popover content container.
-     */
+    /** Forwarded to popover content. */
     contentProps?: Pick<PopoverContentProps, "hideWhileClosed" | "scrollerRef">;
 } | {
-    /** Discriminant for the tooltip variant. */
     type: "tooltip";
-    /**
-     * The text content displayed inside the tooltip. When omitted, defaults to "AI can make mistakes."
-     */
+    /** Tooltip text. Defaults to `"AI can make mistakes."`. */
     content?: string;
-    /**
-     * Additional props passed to the underlying `Tooltip` component.
-     */
+    /** Forwarded to the tooltip; the mark owns `children`. */
     props?: Omit<TooltipProps, "children">;
-    /**
-     * Accessible label for the trigger button that opens the tooltip.
-     */
+    /** Accessible name for the trigger. */
     triggerLabel: string;
 };
-/**
- * Props that include an optional AI mark on a label or field.
- */
 export type AiMarkWithTooltipOrPopoverProps = {
     /**
-     * Accepts either a `boolean` or an `AiMarkWithTooltipOrPopoverConfig` object.
-     * - `true` — Displays the AI indicator icon with no additional context.
-     * - `AiMarkWithTooltipOrPopoverConfig` — Displays the AI indicator icon with a tooltip or popover for additional context.
+     * `true` is sparkle-only; pass {@link AiMarkWithTooltipOrPopoverConfig} for
+     * tooltip or popover context.
      */
     aiMark?: boolean | AiMarkWithTooltipOrPopoverConfig;
 };
 /**
- * Controls which axes have their padding collapsed so the component's layout
- * footprint matches a plain inline icon on those axes. For interactive variants,
- * the ghost button's hit area is unchanged; for non-interactive variants, padding
- * is added to the non-collapsed axes.
- * - `"inline"` — collapse the inline axis (left/right)
- * - `"block"` — collapse the block axis (top/bottom)
- * - `"all"` — collapse both axes
+ * Axes whose padding collapses so the mark lays out like a plain icon.
+ * Interactive variants keep the ghost-button hit area; others pad remaining axes.
  */
 export type AiMarkCollapsePadding = "inline" | "block" | "all";

package/dist/src/types/ianaZones.d.ts

@@ -1,2 +1,4 @@
+/** IANA timezone names accepted by date/calendar timezone props. */
 export declare const IANA_TIMEZONES: readonly ["Pacific/Kiritimati", "Pacific/Apia", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Tongatapu", "Pacific/Chatham", "Antarctica/McMurdo", "Asia/Anadyr", "Asia/Kamchatka", "Pacific/Auckland", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Nauru", "Pacific/Tarawa", "Pacific/Wake", "Pacific/Wallis", "Antarctica/Casey", "Antarctica/Macquarie", "Asia/Magadan", "Asia/Sakhalin", "Asia/Srednekolymsk", "Pacific/Bougainville", "Pacific/Efate", "Pacific/Guadalcanal", "Pacific/Kosrae", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pohnpei", "Australia/Lord_Howe", "Antarctica/DumontDUrville", "Asia/Ust-Nera", "Asia/Vladivostok", "Australia/Brisbane", "Australia/Currie", "Australia/Hobart", "Australia/Lindeman", "Australia/Melbourne", "Australia/Sydney", "Pacific/Chuuk", "Pacific/Guam", "Pacific/Port_Moresby", "Pacific/Saipan", "Australia/Adelaide", "Australia/Broken_Hill", "Australia/Darwin", "Asia/Chita", "Asia/Dili", "Asia/Jayapura", "Asia/Khandyga", "Asia/Seoul", "Asia/Tokyo", "Asia/Yakutsk", "Pacific/Palau", "Australia/Eucla", "Asia/Pyongyang", "Asia/Brunei", "Asia/Choibalsan", "Asia/Hong_Kong", "Asia/Irkutsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Macau", "Asia/Makassar", "Asia/Manila", "Asia/Shanghai", "Asia/Singapore", "Asia/Taipei", "Asia/Ulaanbaatar", "Australia/Perth", "Antarctica/Davis", "Asia/Bangkok", "Asia/Barnaul", "Asia/Ho_Chi_Minh", "Asia/Hovd", "Asia/Jakarta", "Asia/Krasnoyarsk", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Tomsk", "Asia/Vientiane", "Indian/Christmas", "Asia/Yangon", "Indian/Cocos", "Antarctica/Vostok", "Asia/Almaty", "Asia/Bishkek", "Asia/Dhaka", "Asia/Omsk", "Asia/Qyzylorda", "Asia/Thimphu", "Asia/Urumqi", "Indian/Chagos", "Asia/Kathmandu", "Asia/Colombo", "Asia/Kolkata", "Antarctica/Mawson", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Atyrau", "Asia/Dushanbe", "Asia/Karachi", "Asia/Oral", "Asia/Samarkand", "Asia/Tashkent", "Asia/Yekaterinburg", "Indian/Kerguelen", "Indian/Maldives", "Asia/Kabul", "Asia/Tehran", "Asia/Baku", "Asia/Dubai", "Asia/Muscat", "Asia/Tbilisi", "Asia/Yerevan", "Europe/Astrakhan", "Europe/Samara", "Europe/Saratov", "Europe/Ulyanovsk", "Indian/Mahe", "Indian/Mauritius", "Indian/Reunion", "Africa/Addis_Ababa", "Africa/Asmara", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Mogadishu", "Africa/Nairobi", "Antarctica/Syowa", "Asia/Aden", "Asia/Amman", "Asia/Baghdad", "Asia/Bahrain", "Asia/Beirut", "Asia/Damascus", "Asia/Famagusta", "Asia/Gaza", "Asia/Hebron", "Asia/Jerusalem", "Asia/Kuwait", "Asia/Nicosia", "Asia/Qatar", "Asia/Riyadh", "Europe/Athens", "Europe/Bucharest", "Europe/Chisinau", "Europe/Helsinki", "Europe/Istanbul", "Europe/Kiev", "Europe/Kirov", "Europe/Mariehamn", "Europe/Minsk", "Europe/Moscow", "Europe/Riga", "Europe/Simferopol", "Europe/Sofia", "Europe/Tallinn", "Europe/Uzhgorod", "Europe/Vilnius", "Europe/Volgograd", "Europe/Zaporozhye", "Indian/Antananarivo", "Indian/Comoro", "Indian/Mayotte", "Africa/Blantyre", "Africa/Bujumbura", "Africa/Cairo", "Africa/Ceuta", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Kigali", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Tripoli", "Antarctica/Troll", "Arctic/Longyearbyen", "Europe/Amsterdam", "Europe/Andorra", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Budapest", "Europe/Busingen", "Europe/Copenhagen", "Europe/Gibraltar", "Europe/Kaliningrad", "Europe/Ljubljana", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Monaco", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Rome", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Skopje", "Europe/Stockholm", "Europe/Tirane", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zurich", "Africa/Algiers", "Africa/Bangui", "Africa/Brazzaville", "Africa/Casablanca", "Africa/Douala", "Africa/El_Aaiun", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Luanda", "Africa/Malabo", "Africa/Ndjamena", "Africa/Niamey", "Africa/Porto-Novo", "Africa/Tunis", "Africa/Windhoek", "Atlantic/Canary", "Atlantic/Faroe", "Atlantic/Madeira", "Europe/Dublin", "Europe/Guernsey", "Europe/Isle_of_Man", "Europe/Jersey", "Europe/Lisbon", "Europe/London", "Africa/Abidjan", "Africa/Accra", "Africa/Bamako", "Africa/Banjul", "Africa/Bissau", "Africa/Conakry", "Africa/Dakar", "Africa/Freetown", "Africa/Lome", "Africa/Monrovia", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Sao_Tome", "America/Danmarkshavn", "America/Scoresbysund", "Atlantic/Azores", "Atlantic/Reykjavik", "Atlantic/St_Helena", "UTC", "Atlantic/Cape_Verde", "America/Godthab", "America/Miquelon", "America/Noronha", "Atlantic/South_Georgia", "America/St_Johns", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Bahia", "America/Belem", "America/Cayenne", "America/Fortaleza", "America/Glace_Bay", "America/Goose_Bay", "America/Halifax", "America/Maceio", "America/Moncton", "America/Montevideo", "America/Paramaribo", "America/Punta_Arenas", "America/Recife", "America/Santarem", "America/Sao_Paulo", "America/Thule", "Antarctica/Palmer", "Antarctica/Rothera", "Atlantic/Bermuda", "Atlantic/Stanley", "America/Anguilla", "America/Antigua", "America/Aruba", "America/Asuncion", "America/Barbados", "America/Blanc-Sablon", "America/Boa_Vista", "America/Campo_Grande", "America/Caracas", "America/Cuiaba", "America/Curacao", "America/Detroit", "America/Dominica", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guyana", "America/Havana", "America/Indiana/Indianapolis", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Iqaluit", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Kralendijk", "America/La_Paz", "America/Lower_Princes", "America/Manaus", "America/Marigot", "America/Martinique", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Pangnirtung", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Velho", "America/Puerto_Rico", "America/Santiago", "America/Santo_Domingo", "America/St_Barthelemy", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Thunder_Bay", "America/Toronto", "America/Tortola", "America/Atikokan", "America/Bahia_Banderas", "America/Bogota", "America/Cancun", "America/Cayman", "America/Chicago", "America/Eirunepe", "America/Guayaquil", "America/Indiana/Knox", "America/Indiana/Tell_City", "America/Jamaica", "America/Lima", "America/Matamoros", "America/Menominee", "America/Merida", "America/Mexico_City", "America/Monterrey", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Panama", "America/Rainy_River", "America/Rankin_Inlet", "America/Resolute", "America/Rio_Branco", "America/Winnipeg", "America/Belize", "America/Boise", "America/Cambridge_Bay", "America/Chihuahua", "America/Costa_Rica", "America/Denver", "America/Edmonton", "America/El_Salvador", "America/Guatemala", "America/Inuvik", "America/Managua", "America/Mazatlan", "America/Ojinaga", "America/Regina", "America/Swift_Current", "America/Tegucigalpa", "America/Yellowknife", "Pacific/Easter", "Pacific/Galapagos", "America/Creston", "America/Dawson", "America/Dawson_Creek", "America/Fort_Nelson", "America/Hermosillo", "America/Los_Angeles", "America/Phoenix", "America/Tijuana", "America/Vancouver", "America/Whitehorse", "America/Anchorage", "America/Juneau", "America/Metlakatla", "America/Nome", "America/Sitka", "America/Yakutat", "Pacific/Pitcairn", "America/Adak", "Pacific/Gambier", "Pacific/Marquesas", "Pacific/Honolulu", "Pacific/Rarotonga", "Pacific/Tahiti", "Pacific/Midway", "Pacific/Niue", "Pacific/Pago_Pago"];
+/** Member of {@link IANA_TIMEZONES}. */
 export type IanaZone = (typeof IANA_TIMEZONES)[number];

package/dist/src/types/locales.d.ts

@@ -1,3 +1,4 @@
 declare const _locales: readonly ["af-ZA", "sq-AL", "ar-DZ", "ar-BH", "ar-EG", "ar-IQ", "ar-JO", "ar-KW", "ar-LB", "ar-LY", "ar-MA", "ar-OM", "ar-QA", "ar-SA", "ar-SY", "ar-TN", "ar-AE", "ar-YE", "hy-AM", "az-AZ", "eu-ES", "be-BY", "bn-IN", "bs-BA", "bg-BG", "ca-ES", "zh-CN", "zh-HK", "zh-MO", "zh-SG", "zh-TW", "hr-HR", "cs-CZ", "da-DK", "nl-BE", "nl-NL", "en-AU", "en-BZ", "en-CA", "en-IE", "en-JM", "en-NZ", "en-PH", "en-ZA", "en-TT", "en-VI", "en-GB", "en-US", "en-ZW", "et-EE", "fo-FO", "fi-FI", "fr-BE", "fr-CA", "fr-FR", "fr-LU", "fr-MC", "fr-CH", "gl-ES", "ka-GE", "de-AT", "de-DE", "de-LI", "de-LU", "de-CH", "el-GR", "gu-IN", "he-IL", "hi-IN", "hu-HU", "is-IS", "id-ID", "it-IT", "it-CH", "ja-JP", "kn-IN", "kk-KZ", "kok-IN", "ko-KR", "lv-LV", "lt-LT", "mk-MK", "ms-BN", "ms-MY", "ml-IN", "mt-MT", "mr-IN", "mn-MN", "se-NO", "nb-NO", "nn-NO", "fa-IR", "pl-PL", "pt-BR", "pt-PT", "pa-IN", "ro-RO", "ru-RU", "sr-BA", "sr-CS", "sk-SK", "sl-SI", "es-AR", "es-BO", "es-CL", "es-CO", "es-CR", "es-DO", "es-EC", "es-SV", "es-GT", "es-HN", "es-MX", "es-NI", "es-PA", "es-PY", "es-PE", "es-PR", "es-ES", "es-UY", "es-VE", "sw-KE", "sv-FI", "sv-SE", "syr-SY", "ta-IN", "te-IN", "th-TH", "tn-ZA", "tr-TR", "uk-UA", "uz-UZ", "vi-VN", "cy-GB", "xh-ZA", "zu-ZA"];
+/** BCP 47 language tags used by locale-typed props. */
 export type Locale = (typeof _locales)[number];
 export {};

package/dist/src/types/props.d.ts

@@ -1,28 +1,28 @@
 import { CSSProperties, FC, SVGProps } from 'react';
 import { ButtonProps } from '../components';
+/** Element that can receive focus, from `tabbable`. */
 export type { FocusableElement } from 'tabbable';
 export type ButtonAppearance = "primary" | "secondary" | "ghost" | "danger" | "danger-secondary";
 export type OnCloseProps = {
-    /**
-     * Called when the component is closed. If supplied, a close button will be rendered.
-     * @returns void
-     */
+    /** When set, renders a close control and is called on close. */
     onClose?: ButtonProps["onClick"];
 };
 type Copy<T> = Pick<T, keyof T>;
 export type DisableCloseOnEscapeOrClickProps = {
-    /**
-     * Determines whether to disable pressing "escape" to close the component.
-     * @default false
-     */
+    /** Skip Escape-to-close. Defaults to `false`. */
     disableCloseOnEscape?: boolean;
-    /**
-     * Determines whether to disable clicking outside of the component to close it.
-     * @default false
-     */
+    /** Skip outside-click-to-close. Defaults to `false`. */
     disableCloseOnClickOutside?: boolean;
 };
+/**
+ * Spacing scale. Numbers and numeric strings match (`4` / `"4"`). `"half"` is
+ * the half-step.
+ */
 export type GapSize = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | "0" | "half" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14";
+/**
+ * Flex/grid utilities applied as inline styles. Nested `sm`–`xxl` bags apply
+ * the same utilities from that breakpoint up.
+ */
 export type LayoutUtilProps = {
     flex?: CSSProperties["flex"];
     flexDirection?: CSSProperties["flexDirection"];
@@ -55,6 +55,7 @@ export type LayoutUtilProps = {
     xl?: Omit<LayoutUtilProps, "sm" | "md" | "lg" | "xl" | "xxl">;
     xxl?: Omit<LayoutUtilProps, "sm" | "md" | "lg" | "xl" | "xxl">;
 };
+/** Makes keys in `K` required on `T`. Omit `K` to require every key of `T`. */
 export type RequiredByKeys<T, K extends keyof T = keyof T> = Copy<{
     [P in keyof T as P extends K ? P : never]-?: T[P];
 } & {
@@ -64,8 +65,5 @@ export type SemanticColor = "primary" | "secondary" | "critical" | "warning";
 export type Size = "0" | "xsmall" | "small" | "medium" | "large" | "xlarge";
 export type Status = "info" | "success" | "warning" | "danger";
 export type Svg = FC<SVGProps<SVGSVGElement>>;
-/**
- * Represents the state of a checkbox-style selection.
- * Used by SelectField, MultiSelectField, and similar components.
- */
+/** Checkbox-style selection, including indeterminate and loading. */
 export type CheckState = "indeterminate" | "loading" | "checked" | "unchecked";

package/dist/{stripInlineMarkdown-82hVO9EP.js → stripInlineMarkdown-CosQSmBr.js}

@@ -1,4 +1,4 @@
-import { I as INLINE_MARKDOWN_REGEX } from './FieldLabel-CYCk2rz-.js';
+import { I as INLINE_MARKDOWN_REGEX } from './FieldLabel-6aFKQfyD.js';
 
 const stripInlineMarkdown = (str) => {
   const parts = [];
@@ -22,4 +22,4 @@ const stripInlineMarkdown = (str) => {
 };
 
 export { stripInlineMarkdown as s };
-//# sourceMappingURL=stripInlineMarkdown-82hVO9EP.js.map
+//# sourceMappingURL=stripInlineMarkdown-CosQSmBr.js.map

package/dist/stripInlineMarkdown-CosQSmBr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripInlineMarkdown-CosQSmBr.js","sources":["../src/internal/functions/stripInlineMarkdown.ts"],"sourcesContent":["import { INLINE_MARKDOWN_REGEX } from \"../utils/inlineMarkdownRegex\";\n\n/**\n * Drops inline markdown markers and returns the inner text (for `aria-label`).\n * Shared global regex: reset `lastIndex` per call and save it around nested\n * strips. Code spans are not reparsed.\n */\nexport const stripInlineMarkdown = (str: string): string => {\n  const parts: string[] = [];\n  let lastIndex = 0;\n\n  INLINE_MARKDOWN_REGEX.lastIndex = 0;\n  let match: RegExpExecArray | null;\n\n  while ((match = INLINE_MARKDOWN_REGEX.exec(str)) !== null) {\n    if (match.index > lastIndex) {\n      parts.push(str.substring(lastIndex, match.index));\n    }\n\n    const savedIndex = INLINE_MARKDOWN_REGEX.lastIndex;\n    const inner =\n      match[1] ?? match[2] ?? match[3] ?? match[4] ?? match[5] ?? \"\";\n\n    parts.push(match[5] ? inner : stripInlineMarkdown(inner));\n\n    INLINE_MARKDOWN_REGEX.lastIndex = savedIndex;\n    lastIndex = savedIndex;\n  }\n\n  if (lastIndex < str.length) {\n    parts.push(str.substring(lastIndex));\n  }\n\n  return parts.join(\"\");\n};\n"],"names":[],"mappings":";;AAOO,MAAM,mBAAA,GAAsB,CAAC,GAAA,KAAwB;AAC1D,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,IAAI,SAAA,GAAY,CAAA;AAEhB,EAAA,qBAAA,CAAsB,SAAA,GAAY,CAAA;AAClC,EAAA,IAAI,KAAA;AAEJ,EAAA,OAAA,CAAQ,KAAA,GAAQ,qBAAA,CAAsB,IAAA,CAAK,GAAG,OAAO,IAAA,EAAM;AACzD,IAAA,IAAI,KAAA,CAAM,QAAQ,SAAA,EAAW;AAC3B,MAAA,KAAA,CAAM,KAAK,GAAA,CAAI,SAAA,CAAU,SAAA,EAAW,KAAA,CAAM,KAAK,CAAC,CAAA;AAAA,IAClD;AAEA,IAAA,MAAM,aAAa,qBAAA,CAAsB,SAAA;AACzC,IAAA,MAAM,KAAA,GACJ,KAAA,CAAM,CAAC,CAAA,IAAK,MAAM,CAAC,CAAA,IAAK,KAAA,CAAM,CAAC,KAAK,KAAA,CAAM,CAAC,CAAA,IAAK,KAAA,CAAM,CAAC,CAAA,IAAK,EAAA;AAE9D,IAAA,KAAA,CAAM,KAAK,KAAA,CAAM,CAAC,IAAI,KAAA,GAAQ,mBAAA,CAAoB,KAAK,CAAC,CAAA;AAExD,IAAA,qBAAA,CAAsB,SAAA,GAAY,UAAA;AAClC,IAAA,SAAA,GAAY,UAAA;AAAA,EACd;AAEA,EAAA,IAAI,SAAA,GAAY,IAAI,MAAA,EAAQ;AAC1B,IAAA,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,SAAA,CAAU,SAAS,CAAC,CAAA;AAAA,EACrC;AAEA,EAAA,OAAO,KAAA,CAAM,KAAK,EAAE,CAAA;AACtB;;;;"}