@xh/hoist 87.1.1 → 87.2.0

package/build/types/cmp/input/HoistInputProps.d.ts

@@ -1,5 +1,5 @@
-import { TestSupportProps } from '@xh/hoist/core';
-export interface HoistInputProps extends TestSupportProps {
+import { DomAttrsProps, TestSupportProps } from '@xh/hoist/core';
+export interface HoistInputProps extends TestSupportProps, DomAttrsProps {
     /**
      * Field or model property name from which this component should read and write its value
      * in controlled mode. Can be set by parent FormField.
@@ -18,3 +18,50 @@ export interface HoistInputProps extends TestSupportProps {
     /** Value of the control, if provided directly. */
     value?: any;
 }
+/**
+ * Props for text-like inputs that browser password managers may treat as credential fields.
+ *
+ * Extended by the inputs that render a free-text `<input>` or `<textarea>` - the elements password
+ * manager extensions scan. Controls that cannot present as a credential field (checkboxes, sliders,
+ * segmented controls, and similar) do not accept this prop.
+ */
+export interface PasswordManagerSupportProps {
+    /**
+     * True to allow browser password managers to offer autofill on this input. Defaults to false,
+     * suppressing them.
+     *
+     * Password managers flag any field that *looks* like a username, email, or password and offer
+     * a saved-login prompt, whether or not the field has anything to do with signing in. That is
+     * unwanted on the ordinary data-entry forms most Hoist applications are built from, so Hoist
+     * opts out by default - the same posture as {@link TextInputProps.autoComplete}, which defaults
+     * to 'off'. Note `autocomplete="off"` alone does not stop password managers, which have ignored
+     * it on login-like fields for years.
+     *
+     * Set true on genuine credential fields so users get real password manager support.
+     */
+    enablePasswordManagers?: boolean;
+}
+/**
+ * Vendor-specific attributes that tell a password manager to skip a field. Each manager checks its
+ * own attribute - there is no cross-vendor standard. Covers 1Password, LastPass, and Bitwarden.
+ *
+ * Frozen and module-level so it adds no per-render allocation.
+ */
+export declare const PW_MANAGER_IGNORE_ATTRS: Readonly<{
+    'data-1p-ignore': "true";
+    'data-lpignore': "true";
+    'data-bwignore': "true";
+}>;
+/**
+ * Resolve the password manager attributes for an input, given its `enablePasswordManagers` prop.
+ * Spread onto the element rendering the native `<input>` / `<textarea>`, ahead of any `domAttrs`
+ * so an explicit caller attribute wins.
+ *
+ * Note these must be present in the DOM before a field is first focused - 1Password caches its
+ * assessment of a field on first interaction - so apply them during render, never in an effect.
+ */
+export declare function getPasswordManagerAttrs(enablePasswordManagers: boolean): Readonly<{
+    'data-1p-ignore': "true";
+    'data-lpignore': "true";
+    'data-bwignore': "true";
+}>;

package/build/types/cmp/tab/TabContainerModel.d.ts

@@ -57,6 +57,8 @@ export interface TabContainerConfig {
     emptyText?: ReactNode;
     /** @internal */
     xhImpl?: boolean;
+    /** See {@link HoistBase.xhName}. */
+    xhName?: string;
 }
 /**
  * Model for a TabContainer, representing its layout/contents and the currently displayed Tab.
@@ -90,7 +92,7 @@ export declare class TabContainerModel extends HoistModel {
      * @param config - TabContainer configuration.
      * @param depth - Depth in hierarchy of nested TabContainerModels. Not for application use.
      */
-    constructor({ tabs, defaultTabId, route, track, renderMode, refreshMode, persistWith, emptyText, xhImpl, switcher }: TabContainerConfig, depth?: number);
+    constructor({ tabs, defaultTabId, route, track, renderMode, refreshMode, persistWith, emptyText, xhName, xhImpl, switcher }: TabContainerConfig, depth?: number);
     /** Set/replace all tabs within the container. */
     setTabs(tabs: Array<TabModel | TabConfig>): void;
     /** Add a single tab to the container. */

package/build/types/cmp/tab/TabModel.d.ts

@@ -44,6 +44,8 @@ export interface TabConfig {
     omit?: Thunkable<boolean>;
     /** @internal */
     xhImpl?: boolean;
+    /** See {@link HoistBase.xhName}. */
+    xhName?: string;
 }
 /**
  * Model for a Tab within a TabContainer. Specifies the actual content (child component) to be
@@ -68,7 +70,7 @@ export declare class TabModel extends HoistModel {
     private _renderMode;
     private _refreshMode;
     get isTabModel(): boolean;
-    constructor({ id, title, icon, tooltip, disabled, excludeFromSwitcher, showRemoveAction, content, refreshMode, renderMode, xhImpl }: TabConfig, containerModel: TabContainerModel);
+    constructor({ id, title, icon, tooltip, disabled, excludeFromSwitcher, showRemoveAction, content, refreshMode, renderMode, xhName, xhImpl }: TabConfig, containerModel: TabContainerModel);
     activate(): void;
     get renderMode(): RenderMode;
     get refreshMode(): RefreshMode;

package/build/types/cmp/treemap/TreeMapModel.d.ts

@@ -60,6 +60,8 @@ export interface TreeMapConfig {
     emptyText?: ReactNode;
     /** Data filter to apply to records. */
     filter?: FilterLike;
+    /** See {@link HoistBase.xhName}. */
+    xhName?: string;
 }
 export interface TreeMapModelDefaults {
     algorithm?: TreeMapAlgorithm;

package/build/types/cmp/viewmanager/ViewManagerModel.d.ts

@@ -103,6 +103,8 @@ export interface ViewManagerConfig {
      * ViewManager menu.
      */
     viewMenuItemFn?: (view: ViewInfo, model: ViewManagerModel) => ReactNode;
+    /** See {@link HoistBase.xhName}. */
+    xhName?: string;
 }
 /**
  *  ViewManagerModel coordinates the loading, saving, and management of user-defined bundles of

package/build/types/cmp/zoneGrid/ZoneGridModel.d.ts

@@ -198,6 +198,8 @@ export interface ZoneGridConfig {
     appData?: PlainObject;
     /** @internal */
     xhImpl?: boolean;
+    /** See {@link HoistBase.xhName}. */
+    xhName?: string;
 }
 /**
  * Model for a ZoneGrid - a card-style grid that renders each row as a full-width block

package/build/types/core/HoistBase.d.ts

@@ -31,6 +31,11 @@ export declare abstract class HoistBase {
      * @internal
      */
     xhImpl: boolean;
+    /**
+     * Optional developer-facing name for this instance, shown in place of its class name in log
+     * output, telemetry, and the Inspector. Uniqueness is not enforced.
+     */
+    xhName: string;
     private managedInstances;
     private disposers;
     private _destroyed;
@@ -123,6 +128,8 @@ export declare abstract class HoistBase {
     setBindable(property: string, value: any): void;
     /** @returns a unique id for this object within the lifetime of this document. */
     get xhId(): string;
+    /** Name for a child of this object - `{xhName}.{key}`, or null if this object is unnamed. */
+    childXhName(key: string): string;
     /**
      * Mark an object as managed by this object.
      *

package/build/types/core/HoistProps.d.ts

@@ -57,7 +57,7 @@ export interface DefaultHoistProps<M extends HoistModel = HoistModel> extends Ho
  * @see Frame
  * @see LayoutProps
  */
-export interface BoxProps extends LayoutProps, TestSupportProps, Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'contextMenu'> {
+export interface BoxProps extends LayoutProps, TestSupportProps, DomAttrsProps, Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'contextMenu'> {
 }
 /**
  * Props for Components that accept standard HTML `style` attributes.
@@ -78,6 +78,31 @@ export interface TestSupportProps {
      */
     testId?: string;
 }
+/**
+ * Props to support applying arbitrary HTML attributes to the primary DOM element rendered by a
+ * component.
+ *
+ * Intended as an escape hatch for `data-*` and `aria-*` attributes that Hoist does not model with
+ * a dedicated prop - e.g. attributes read by analytics libraries, browser extensions, or
+ * third-party test tooling. Hoist components pick the props they pass to the elements they render,
+ * so attributes specified any other way are typically dropped and never reach the DOM.
+ */
+export interface DomAttrsProps {
+    /**
+     * Additional HTML attributes to apply to the primary DOM element rendered by this component -
+     * the same element that receives `data-testid` when {@link TestSupportProps.testId} is set.
+     *
+     * Keys are constrained to `data-*` and `aria-*` attributes, plus `role`, so this cannot be
+     * used to override attributes the component manages itself (`className`, `style`, `value`).
+     * Note the constraint applies to object literals only - a pre-built `Record<string, string>`
+     * will still assign, for the rare case that calls for an attribute outside this set. Take care
+     * there: precedence against component-managed attributes is not guaranteed and varies by
+     * component.
+     */
+    domAttrs?: Record<`data-${string}` | `aria-${string}`, string | number | boolean> & {
+        role?: string;
+    };
+}
 export interface LayoutProps {
     margin?: string | number | boolean;
     marginTop?: string | number | boolean;

package/build/types/core/model/RootRefreshContextModel.d.ts

@@ -10,5 +10,6 @@ import { RefreshContextModel } from './';
  * The `XH.refreshAppAsync()` convenience method is the recommended entry-point for apps to call.
  */
 export declare class RootRefreshContextModel extends RefreshContextModel {
+    xhName: string;
     doLoadAsync(loadSpec: LoadSpec): Promise<void>;
 }

package/build/types/core/types/Telemetry.d.ts

@@ -66,7 +66,7 @@ export interface FullSpanConfig extends SpanConfig {
      * the span was constructed - e.g. timing an event whose timestamp is known.
      */
     startTime?: number;
-    /** Source for the `code.namespace` tag - usually the calling object/function. */
+    /** Usually the calling object/function - source of the `code.namespace` and `xh.name` tags. */
     caller?: NameSource;
 }
 /** Key/value tags attached to a metric recorded via {@link MetricsService}. */

package/build/types/data/Store.d.ts

@@ -161,6 +161,8 @@ export interface StoreConfig {
      *     it may also be changed on an existing Store at any time.
      */
     experimental?: PlainObject;
+    /** See {@link HoistBase.xhName}. */
+    xhName?: string;
 }
 /**
  * App-wide defaults for {@link Store}, applied to every Store constructed without an explicit
@@ -300,7 +302,7 @@ export declare class Store extends HoistBase implements FilterBindTarget, Filter
     experimental: any;
     /** @internal */
     readonly diagnostics: StoreDiagnostics;
-    constructor({ fields, fieldDefaults, idSpec, processRawData, filter, filterIncludesChildren, loadTreeData, loadTreeDataFrom, loadRootAsSummary, freezeData, idEncodesTreePath, digestSpec, retainRaw, projectionOnly, validationIsComplex, experimental, data }: StoreConfig);
+    constructor({ fields, fieldDefaults, idSpec, processRawData, filter, filterIncludesChildren, loadTreeData, loadTreeDataFrom, loadRootAsSummary, freezeData, idEncodesTreePath, digestSpec, retainRaw, projectionOnly, validationIsComplex, experimental, xhName, data }: StoreConfig);
     /** See {@link StoreConfig.digestSpec} - settable, taking effect on the next load. */
     get digestSpec(): StoreRecordDigestSpec;
     set digestSpec(spec: StoreRecordDigestSpec);

package/build/types/data/StoreSelectionModel.d.ts

@@ -12,6 +12,8 @@ export interface StoreSelectionConfig {
     mode?: 'single' | 'multiple' | 'disabled';
     /** @internal */
     xhImpl?: boolean;
+    /** See {@link HoistBase.xhName}. */
+    xhName?: string;
 }
 /**
  * Model for managing record selection within a {@link Store}. Supports `single`, `multiple`,
@@ -33,7 +35,7 @@ export declare class StoreSelectionModel extends HoistModel {
     mode: 'single' | 'multiple' | 'disabled';
     private _ids;
     get isEnabled(): boolean;
-    constructor({ store, mode, xhImpl }: StoreSelectionConfig);
+    constructor({ store, mode, xhName, xhImpl }: StoreSelectionConfig);
     get selectedRecords(): StoreRecord[];
     get selectedIds(): StoreRecordId[];
     /**

package/build/types/data/cube/Cube.d.ts

@@ -54,6 +54,8 @@ export interface CubeConfig {
      * Return true to omit the row.
      */
     omitFn?: OmitFn;
+    /** See {@link HoistBase.xhName}. */
+    xhName?: string;
 }
 /**
  * Configs available for a {@link Cube}'s internal {@link Store}, via {@link CubeConfig.store}.
@@ -127,7 +129,7 @@ export declare class Cube extends HoistBase {
     omitFn: OmitFn;
     info: any;
     _connectedViews: Set<View>;
-    constructor({ fields, fieldDefaults, data, idSpec, processRawData, store, info, lockFn, bucketSpecFn, omitFn }: CubeConfig);
+    constructor({ fields, fieldDefaults, data, idSpec, processRawData, store, info, lockFn, bucketSpecFn, omitFn, xhName }: CubeConfig);
     /** Fields configured for this Cube. */
     get fields(): CubeField[];
     /** Dimension Fields configured for this Cube. */
@@ -167,10 +169,11 @@ export declare class Cube extends HoistBase {
      * @param stores - Stores to be automatically loaded/reloaded with View results.
      * @param connect - true to update View automatically when data in the underlying Cube changes.
      */
-    createView({ query, stores, connect }: {
+    createView({ query, stores, connect, xhName }: {
         query: QueryConfig;
         stores?: Store[] | Store;
         connect?: boolean;
+        xhName?: string;
     }): View;
     /** True if the provided view is connected to this Cube for live updates. */
     viewIsConnected(view: View): boolean;

package/build/types/data/cube/View.d.ts

@@ -34,6 +34,8 @@ export interface ViewConfig {
      * capture a snapshot without further (automatic) updates.
      */
     connect?: boolean;
+    /** See {@link HoistBase.xhName}. */
+    xhName?: string;
 }
 export interface ViewResult {
     rows: ViewRowData[];

package/build/types/desktop/cmp/appOption/AutoRefreshAppOption.d.ts

@@ -73,6 +73,9 @@ export declare const autoRefreshAppOption: ({ formFieldProps, inputProps }?: Aut
         position?: import("csstype").Property.Position;
         display?: string;
         testId?: string;
+        domAttrs?: Record<`data-${string}` | `aria-${string}`, string | number | boolean> & {
+            role?: string;
+        };
         slot?: string | undefined;
         style?: import("react").CSSProperties | undefined;
         title?: string | undefined;

package/build/types/desktop/cmp/appOption/ThemeAppOption.d.ts

@@ -71,6 +71,9 @@ export declare const themeAppOption: ({ formFieldProps, inputProps }?: ThemeAppO
         position?: import("csstype").Property.Position;
         display?: string;
         testId?: string;
+        domAttrs?: Record<`data-${string}` | `aria-${string}`, string | number | boolean> & {
+            role?: string;
+        };
         slot?: string | undefined;
         style?: import("react").CSSProperties | undefined;
         title?: string | undefined;

package/build/types/desktop/cmp/button/Button.d.ts

@@ -1,9 +1,9 @@
 import { ButtonProps as BpButtonProps } from '@blueprintjs/core';
-import { HoistModel, HoistProps, Intent, LayoutProps, StyleProps, TestSupportProps } from '@xh/hoist/core';
+import { DomAttrsProps, HoistModel, HoistProps, Intent, LayoutProps, StyleProps, TestSupportProps } from '@xh/hoist/core';
 import '@xh/hoist/desktop/register';
 import { ReactElement, ReactNode } from 'react';
 import './Button.scss';
-export interface ButtonProps<M extends HoistModel = null> extends HoistProps<M>, StyleProps, LayoutProps, TestSupportProps, Omit<BpButtonProps, 'ref'> {
+export interface ButtonProps<M extends HoistModel = null> extends HoistProps<M>, StyleProps, LayoutProps, TestSupportProps, DomAttrsProps, Omit<BpButtonProps, 'ref'> {
     active?: boolean;
     autoFocus?: boolean;
     disabled?: boolean;

package/build/types/desktop/cmp/button/ButtonGroup.d.ts

@@ -1,8 +1,8 @@
 import { ButtonGroupProps as BpButtonGroupProps } from '@blueprintjs/core';
-import { HoistModel, HoistProps, LayoutProps, StyleProps, TestSupportProps } from '@xh/hoist/core';
+import { DomAttrsProps, HoistModel, HoistProps, LayoutProps, StyleProps, TestSupportProps } from '@xh/hoist/core';
 import '@xh/hoist/desktop/register';
 import { SetOptional } from 'type-fest';
-export interface ButtonGroupProps<M extends HoistModel = null> extends HoistProps<M>, LayoutProps, StyleProps, TestSupportProps, SetOptional<Omit<BpButtonGroupProps, 'ref'>, 'children'> {
+export interface ButtonGroupProps<M extends HoistModel = null> extends HoistProps<M>, LayoutProps, StyleProps, TestSupportProps, DomAttrsProps, SetOptional<Omit<BpButtonGroupProps, 'ref'>, 'children'> {
     /** True to have all buttons fill available width equally. */
     fill?: boolean;
     /** True to render each button with minimal surrounding chrome (default false). */

package/build/types/desktop/cmp/dash/DashConfig.d.ts

@@ -33,4 +33,6 @@ export interface DashConfig<VSPEC extends DashViewSpec, VSTATE extends DashViewS
      * including when the dash container is empty.
      */
     extraMenuItems?: MenuItemLike[];
+    /** See {@link HoistBase.xhName}. */
+    xhName?: string;
 }

package/build/types/desktop/cmp/dash/DashViewModel.d.ts

@@ -48,7 +48,7 @@ export declare abstract class DashViewModel<T extends DashViewSpec = DashViewSpe
     private providers;
     get renderMode(): RenderMode;
     get refreshMode(): RefreshMode;
-    constructor({ id, viewSpec, icon, title, viewState, containerModel }: DashViewConfig<T>);
+    constructor({ id, viewSpec, icon, title, viewState, containerModel, xhName }: DashViewConfig<T>);
     /**
      * Modify the viewState of this model. This will push the new state to all registered
      * {@link DashViewProvider} instances.
@@ -78,4 +78,6 @@ export interface DashViewConfig<T extends DashViewSpec = DashViewSpec> {
     title?: string;
     viewState?: DashViewState;
     containerModel?: any;
+    /** See {@link HoistBase.xhName}. */
+    xhName?: string;
 }

package/build/types/desktop/cmp/dash/canvas/DashCanvasModel.d.ts

@@ -108,7 +108,7 @@ export declare class DashCanvasModel extends DashModel<DashCanvasViewSpec, DashC
     isResizing: boolean;
     private _onDropDragOverFn;
     get rglLayout(): any[];
-    constructor({ viewSpecs, viewSpecDefaults, initialState, layoutLocked, contentLocked, renameLocked, persistWith, emptyText, addViewButtonText, columns, rowHeight, compact, margin, maxRows, containerPadding, extraMenuItems, showGridBackground, showAddViewButtonWhenEmpty, allowsDrop, onDropDone, onDropDragOver }: DashCanvasConfig);
+    constructor({ viewSpecs, viewSpecDefaults, initialState, layoutLocked, contentLocked, renameLocked, persistWith, emptyText, addViewButtonText, columns, rowHeight, compact, margin, maxRows, containerPadding, extraMenuItems, showGridBackground, showAddViewButtonWhenEmpty, allowsDrop, onDropDone, onDropDragOver, xhName }: DashCanvasConfig);
     /** Remove all views from the canvas. */
     clear(): void;
     /**

package/build/types/desktop/cmp/dash/container/DashContainerModel.d.ts

@@ -113,7 +113,7 @@ export declare class DashContainerModel extends DashModel<DashContainerViewSpec,
     containerRef: import("react").RefObject<HTMLElement> & import("react").RefCallback<HTMLElement>;
     loadingStateTask: TaskObserver;
     private isDestroyingGoldenLayout;
-    constructor({ viewSpecs, viewSpecDefaults, initialState, renderMode, refreshMode, layoutLocked, contentLocked, renameLocked, showMenuButton, margin, goldenLayoutSettings, persistWith, emptyText, addViewButtonText, extraMenuItems }: DashContainerConfig);
+    constructor({ viewSpecs, viewSpecDefaults, initialState, renderMode, refreshMode, layoutLocked, contentLocked, renameLocked, showMenuButton, margin, goldenLayoutSettings, persistWith, emptyText, addViewButtonText, extraMenuItems, xhName }: DashContainerConfig);
     /**
      * Remove all views from the container.
      *

package/build/types/desktop/cmp/daterange/DateRangePicker.d.ts

@@ -0,0 +1,66 @@
+import { DateRangePickerModel } from '@xh/hoist/cmp/daterange';
+import { type HoistProps, type Intent, type LayoutProps, type TestSupportProps } from '@xh/hoist/core';
+import { type ButtonProps } from '@xh/hoist/desktop/cmp/button';
+import '@xh/hoist/desktop/register';
+import type { PopoverPosition } from '@blueprintjs/core';
+import type { ReactNode } from 'react';
+import './DateRangePicker.scss';
+export interface DateRangePickerProps extends HoistProps<DateRangePickerModel>, LayoutProps, TestSupportProps {
+    /**
+     * Props forwarded to the trigger button - use to customize its `icon`, `intent`, `minimal`,
+     * `outlined`, `tooltip`, or any other {@link ButtonProps}.
+     */
+    buttonProps?: Partial<ButtonProps>;
+    /**
+     * Text rendered in the popover footer, or null to suppress. Default is a note on the date that
+     * periods are relative to. Not shown by a single-tab picker, whose footer carries the resolved
+     * dates instead.
+     */
+    footerNote?: ReactNode;
+    /**
+     * Intent for the popover's selection accent - the highlight on selected presets, months,
+     * and calendar days, and the Apply button. Also applied to the trigger button unless
+     * overridden via `buttonProps`. Default: the primary intent for the accent, none for the
+     * trigger.
+     */
+    intent?: Intent;
+    /**
+     * Placement of the popover relative to the trigger. Default 'bottom-left', which flips to
+     * 'top-left' when there is no room below - e.g. from a bottom toolbar - and holds the popover's
+     * left edge to the trigger as the trigger's label changes width.
+     */
+    popoverPosition?: PopoverPosition;
+    /**
+     * True (default) to show the resolved dates beside the period label on the trigger. The dates
+     * are also dropped automatically when a stretched trigger (e.g. `flex: 1` within a narrow
+     * dashboard widget) measures too narrow to fit them - either way, they remain available via
+     * the trigger's tooltip.
+     */
+    showRange?: boolean;
+    /**
+     * True to flank the trigger with previous/next buttons that move the applied range by its own
+     * length - see {@link DateRangePickerModel.stepRange}. Default false.
+     */
+    showStepButtons?: boolean;
+    /**
+     * True (default) to style trigger button background and borders to match inputs. Set to
+     * false to render an outlined button instead.
+     */
+    styleButtonAsInput?: boolean;
+}
+/**
+ * A dropdown control for selecting a period of time - one compact trigger that can express
+ * presets (e.g. MTD, Prev 30 Days), relative lookbacks, calendar months, quarters and years, and
+ * custom ranges of dates.
+ *
+ * The trigger shows the applied period's label with its resolved dates, and opens a popover with a
+ * tab for each of those selection shapes. The backing {@link DateRangePickerModel}'s `tabs` config
+ * selects which tabs show. Preset and period picks commit on click. Relative and custom picks are
+ * drafts until Apply, held in a local model that never touches the applied value.
+ *
+ * App code constructs and persists the {@link DateRangePickerModel}, which owns the applied value
+ * and the ranges and filters it resolves to - see that class for the full API.
+ *
+ * @see DateRangePickerModel
+ */
+export declare const DateRangePicker: import("react").FC<DateRangePickerProps>, dateRangePicker: import("@xh/hoist/core").ElementFactory<DateRangePickerProps>;

package/build/types/desktop/cmp/daterange/impl/CustomTab.d.ts

@@ -0,0 +1,3 @@
+import type { DateRangePickerLocalModel } from './DateRangePickerLocalModel';
+/** Custom tab - start and end inputs over a two-month calendar, drafted until applied. */
+export declare const customTab: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<DateRangePickerLocalModel>>;

package/build/types/desktop/cmp/daterange/impl/DateRangePickerLocalModel.d.ts

@@ -0,0 +1,121 @@
+import { TabContainerModel } from '@xh/hoist/cmp/tab';
+import { HoistModel, type Intent } from '@xh/hoist/core';
+import type { LocalDate } from '@xh/hoist/utils/datetime';
+import { type ReactElement } from 'react';
+import { DateRangePickerModel, type DateRangePickerTab, type DateRangeSelection, type DateRangeUnit, type LocalDateRange } from '@xh/hoist/cmp/daterange';
+/**
+ * A tab within the picker popover - its rail entry and its content component. Declared by the
+ * platform component alongside its tab components and passed in, keeping this model free of any
+ * dependency on them.
+ *
+ * @internal
+ */
+export interface DateRangePickerTabSpec {
+    id: DateRangePickerTab;
+    title: string;
+    icon: ReactElement;
+    content: (props: {
+        model: DateRangePickerLocalModel;
+        testId: string;
+    }) => ReactElement;
+}
+/**
+ * Local model for DateRangePicker components. Holds popover-local view state - open state, the
+ * active tab, and per-tab drafts - that must be per-component-instance, even when multiple
+ * pickers share one DateRangePickerModel. Drafts never touch the parent model's applied value
+ * until committed, so Cancel / click-outside / Escape discard them for free.
+ *
+ * @internal
+ */
+export declare class DateRangePickerLocalModel extends HoistModel {
+    xhImpl: boolean;
+    parentModel: DateRangePickerModel;
+    isOpen: boolean;
+    /** Drives the popover's tab rail + content. Tab ids are {@link DateRangePickerTab} values. */
+    tabModel: TabContainerModel;
+    /** testId of the host picker - tabs derive their own testIds from it. */
+    testId: string;
+    /** Measured width of the whole control - drives the compact variant in a narrow host. */
+    measuredWidth: number;
+    /** Intent of the host picker as of its last render - accents selected months and years. */
+    intent: Intent;
+    /** Root element of this instance - scopes popover outside-click handling to this picker. */
+    viewRef: import("react").RefObject<HTMLDivElement>;
+    relativeCount: number;
+    relativeUnit: DateRangeUnit;
+    relativeSnap: boolean;
+    gridYear: number;
+    customStart: LocalDate;
+    customEnd: LocalDate;
+    nextEdge: 'start' | 'end';
+    /** Start-of-month for the left-hand calendar. Right-hand shows the following month. */
+    leftMonth: LocalDate;
+    private tabSpecs;
+    private openTabId;
+    private seededRelativeDraft;
+    private seededCustomDraft;
+    get anchorDate(): LocalDate;
+    get minDate(): LocalDate | null;
+    get maxDate(): LocalDate;
+    get singleTab(): boolean;
+    get activeTabId(): DateRangePickerTab;
+    get clampedCount(): number;
+    get relativeDraft(): DateRangeSelection;
+    get relativeRange(): LocalDateRange;
+    get relativeDayCount(): number;
+    /**
+     * False for days, where a day is already a calendar boundary - snapping has nothing to round
+     * out, so days resolve identically either way.
+     */
+    get snapApplies(): boolean;
+    /** Explains the Relative tab's snap choice, or the day window when snap does not apply. */
+    get relativeModeHelpText(): string;
+    /** Secondary line for the Relative tab's preview - the window's length. */
+    get relativePreviewCountText(): string;
+    get canYearBack(): boolean;
+    get canYearForward(): boolean;
+    isMonthDisabled(month: number): boolean;
+    isQuarterDisabled(quarter: number): boolean;
+    get yearSelectable(): boolean;
+    /** The Custom tab's draft, or null before the first open seeds it. */
+    get customDraft(): DateRangeSelection;
+    get rightMonth(): LocalDate;
+    get canCalBack(): boolean;
+    get canCalForward(): boolean;
+    isDayDisabled(day: LocalDate): boolean;
+    /** True when the active tab holds a draft to apply - preset and period picks commit on click. */
+    get applyEnabled(): boolean;
+    /** True to offer Apply and Cancel - drafts wait for Apply rather than committing on change. */
+    get showApplyControls(): boolean;
+    /**
+     * Default footer note, as a prose prefix plus the date for the component to set apart. A live
+     * anchor names its clock, so a user whose day differs from the app's sees why. A pinned or
+     * computed anchor is just its date.
+     */
+    get anchorNote(): {
+        prefix: string;
+        date: string;
+    };
+    private get anchorNoun();
+    constructor(testId: string, tabSpecs: DateRangePickerTabSpec[]);
+    onLinked(): void;
+    toggleOpen(): void;
+    open(): void;
+    close(): void;
+    commit(value: DateRangeSelection): void;
+    /** Commit the active tab's draft - a no-op on tabs whose picks commit on click. */
+    apply(): void;
+    stepCount(delta: number): void;
+    stepYear(delta: number): void;
+    stepCalendar(delta: number): void;
+    pickDay(day: LocalDate): void;
+    commitStartInput(val: LocalDate): void;
+    commitEndInput(val: LocalDate): void;
+    /** Tab configs in the order the app configured them - the model's `tabs` sets the order. */
+    private buildTabs;
+    private commitDraftIfLive;
+    /** Position the calendars so `date`'s month shows on the left, right within maxDate. */
+    private showMonthOnLeft;
+    /** Position the calendars so `date`'s month shows on the right, clamped to maxDate. */
+    private showMonthOnRight;
+}

package/build/types/desktop/cmp/daterange/impl/PeriodTab.d.ts

@@ -0,0 +1,2 @@
+import type { DateRangePickerLocalModel } from './DateRangePickerLocalModel';
+export declare const periodTab: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<DateRangePickerLocalModel>>;

package/build/types/desktop/cmp/daterange/impl/PresetsTab.d.ts

@@ -0,0 +1,3 @@
+import type { DateRangePickerLocalModel } from './DateRangePickerLocalModel';
+/** Presets tab - one row per configured preset, committing on click. */
+export declare const presetsTab: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<DateRangePickerLocalModel>>;

package/build/types/desktop/cmp/daterange/impl/RelativeTab.d.ts

@@ -0,0 +1,3 @@
+import type { DateRangePickerLocalModel } from './DateRangePickerLocalModel';
+/** Relative tab - a lookback of N units ending on the anchor date, drafted until applied. */
+export declare const relativeTab: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<DateRangePickerLocalModel>>;

package/build/types/desktop/cmp/daterange/impl/TabUtils.d.ts

@@ -0,0 +1,21 @@
+import type { KeyboardEvent } from 'react';
+export declare const sectionHeader: (text: string) => import("react").ReactElement<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, any>;
+/** Props making a styled div act as a keyboard-accessible button. Pass null to disable. */
+export declare const clickable: (onClick: () => void) => {
+    role: string;
+    tabIndex: number;
+    onClick: () => void;
+    onKeyDown: (e: KeyboardEvent) => void;
+    'aria-disabled'?: undefined;
+} | {
+    role: string;
+    'aria-disabled': boolean;
+    tabIndex?: undefined;
+    onClick?: undefined;
+    onKeyDown?: undefined;
+};
+/**
+ * Spread arbitrary `data-*` attributes onto a plain element spec. Needed only for attributes
+ * `ElementSpec` does not declare - `data-testid` is declared, so pass that as `[TEST_ID]` directly.
+ */
+export declare const dataAttrs: (attrs: Record<string, string>) => object;

package/build/types/desktop/cmp/daterange/index.d.ts

@@ -0,0 +1,2 @@
+export * from './DateRangePicker';
+export * from '@xh/hoist/cmp/daterange';

package/build/types/desktop/cmp/dock/DockContainerModel.d.ts

@@ -10,6 +10,8 @@ interface DockContainerConfig {
     renderMode?: RenderMode;
     /** Strategy for refreshing DockViews. Can also be set per-view via `DockViewModelConfig.refreshMode` */
     refreshMode?: RefreshMode;
+    /** See {@link HoistBase.xhName}. */
+    xhName?: string;
 }
 /**
  * Model for a DockContainer, representing its contents.
@@ -22,7 +24,7 @@ export declare class DockContainerModel extends HoistModel {
     direction: DockViewDirection;
     renderMode: RenderMode;
     refreshMode: RefreshMode;
-    constructor({ views, direction, renderMode, refreshMode }?: DockContainerConfig);
+    constructor({ views, direction, renderMode, refreshMode, xhName }?: DockContainerConfig);
     getView(id: string): DockViewModel;
     addView(cfg: DockViewConfig): void;
     removeView(id: string): void;