@xh/hoist 86.1.0 → 86.3.0

package/build/types/admin/jsonsearch/impl/JsonSearchImplModel.d.ts

@@ -1,5 +1,5 @@
 import { GridConfig, GridModel } from '@xh/hoist/cmp/grid';
-import { HoistModel, TaskObserver } from '@xh/hoist/core';
+import { HoistModel, PlainObject, TaskObserver } from '@xh/hoist/core';
 /**
  * @internal
  */
@@ -16,7 +16,7 @@ export declare class JsonSearchImplModel extends HoistModel {
     path: string;
     readerContentType: 'document' | 'matches';
     pathFormat: 'XPath' | 'JSONPath';
-    readerContent: string;
+    readerContent: string | PlainObject[];
     matchingNodeCount: number;
     get subjectName(): string;
     get docSearchUrl(): string;

package/build/types/admin/tabs/activity/tracking/ActivityTrackingModel.d.ts

@@ -3,10 +3,20 @@ import { FilterChooserModel } from '@xh/hoist/cmp/filter';
 import { FormModel } from '@xh/hoist/cmp/form';
 import { ColumnSpec, GridModel } from '@xh/hoist/cmp/grid';
 import { GroupingChooserModel } from '@xh/hoist/cmp/grouping';
-import { HoistModel, LoadSpec, PlainObject } from '@xh/hoist/core';
+import { HoistModel, LoadSpec, LocalDateUnit, PlainObject } from '@xh/hoist/core';
 import { Cube } from '@xh/hoist/data';
 import { LocalDate } from '@xh/hoist/utils/datetime';
 import { ActivityDetailProvider } from './detail/ActivityDetailModel';
+/**
+ * A relative time interval (e.g. 7 days) ending on the current app day. Drives the quick-select
+ * buttons and the persisted time period, which rolls forward to end on today on restore.
+ */
+export interface ActivityInterval {
+    value: number;
+    unit: LocalDateUnit;
+}
+/** Quick-select intervals offered in the toolbar - labels are derived as `${value}${unit[0]}`. */
+export declare const INTERVALS: ActivityInterval[];
 export declare class ActivityTrackingModel extends HoistModel implements ActivityDetailProvider {
     telemetryPrefix: string;
     /** FormModel for server-side querying controls. */
@@ -45,10 +55,11 @@ export declare class ActivityTrackingModel extends HoistModel implements Activit
     setDataFields(dataFields: ActivityTrackingDataFieldSpec[]): void;
     toggleFilterChooser(): void;
     adjustDates(dir: 'add' | 'subtract'): void;
-    adjustStartDate(value: any, unit: any): void;
-    isInterval(value: any, unit: any): boolean;
+    adjustStartDate(interval: ActivityInterval): void;
+    isInterval(interval: ActivityInterval): boolean;
     getDisplayName(fieldName: string): string;
     private createQueryFormModel;
+    private setupPeriodPersistence;
     private loadGridAsync;
     private cubeLabelComparator;
     private getComparableValForDim;

package/build/types/admin/tabs/clients/ClientsModel.d.ts

@@ -4,6 +4,9 @@ import { RecordActionSpec, StoreRecord } from '@xh/hoist/data';
 import { BaseAdminTabModel } from '@xh/hoist/admin/tabs/BaseAdminTabModel';
 export declare class ClientsModel extends BaseAdminTabModel {
     telemetryPrefix: string;
+    persistWith: {
+        localStorageKey: string;
+    };
     lastRefresh: number;
     gridModel: GridModel;
     groupBy: 'user' | 'instance';

package/build/types/appcontainer/RouterModel.d.ts

@@ -1,4 +1,4 @@
-import { HoistModel } from '../core';
+import { HoistModel, HoistRoute } from '../core';
 import { Router, State } from 'router5';
 import 'router5-plugin-browser';
 /**
@@ -19,11 +19,11 @@ export declare class RouterModel extends HoistModel {
     /**
      * Add routes to the router.
      *
-     * @param routes - collection of router5 route spec.
-     *      This method supports an additional keyword 'omit' on each spec, in order to allow declarative
-     *      exclusion.  Otherwise these are Router5 configs to be passed directly to the Router5 API.
+     * @param routes - collection of {@link HoistRoute} specs. In addition to the standard Router5
+     *      route config, each spec supports an `omit` keyword to allow declarative exclusion.
+     *      Otherwise these are Router5 configs to be passed directly to the Router5 API.
      */
-    addRoutes(routes: object[]): void;
+    addRoutes(routes: HoistRoute[]): void;
     /**
      * Add a routeName to the current route, preserving params
      * @param routeName - the routeName to append

package/build/types/cmp/grid/Grid.d.ts

@@ -3,6 +3,8 @@ import { ColumnState } from '@xh/hoist/cmp/grid';
 import { HoistModel, HoistProps, LayoutProps, PlainObject, ReactionSpec, TestSupportProps } from '@xh/hoist/core';
 import { RecordSet } from '@xh/hoist/data/impl/RecordSet';
 import type { ColDef, ColGroupDef, GetContextMenuItemsParams, GridOptions, GridReadyEvent, ProcessCellForExportParams } from '@xh/hoist/kit/ag-grid';
+import { type MouseEvent } from 'react';
+import { PartialDeep } from 'type-fest';
 import './Grid.scss';
 import { GridModel } from './GridModel';
 export interface GridProps<M extends GridModel = GridModel> extends HoistProps<M>, LayoutProps, TestSupportProps {
@@ -15,7 +17,7 @@ export interface GridProps<M extends GridModel = GridModel> extends HoistProps<M
      *
      * Note that changes to these options after the component's initial render will be ignored.
      */
-    agOptions?: GridOptions;
+    agOptions?: PartialDeep<GridOptions>;
     /**
      * Callback when the grid has initialized. The component will call this with the ag-Grid
      * event after running its internal handler to associate the ag-Grid APIs with its model.
@@ -41,6 +43,7 @@ export interface GridProps<M extends GridModel = GridModel> extends HoistProps<M
 export declare const Grid: import("react").FC<GridProps<GridModel>>, grid: import("@xh/hoist/core").ElementFactory<GridProps<GridModel>>;
 export declare class GridLocalModel extends HoistModel {
     xhImpl: boolean;
+    private static EMPTY_SPACE_SELECTOR;
     private model;
     agOptions: GridOptions;
     viewRef: import("react").RefObject<HTMLElement> & import("react").RefCallback<HTMLElement>;
@@ -55,7 +58,7 @@ export declare class GridLocalModel extends HoistModel {
     getColumnDefs(): Array<ColDef | ColGroupDef>;
     getContextMenuItems: (params: GetContextMenuItemsParams) => (string | import("ag-grid-community").MenuItemDef<any, any>)[];
     dataReaction(): {
-        track: () => (boolean | import("../../data").StoreRecord[] | RecordSet | import("@xh/hoist/core").VSide)[];
+        track: () => (boolean | import("@xh/hoist/core").VSide | import("../../data").StoreRecord[] | RecordSet)[];
         run: () => void;
     };
     selectionReaction(): {
@@ -63,7 +66,7 @@ export declare class GridLocalModel extends HoistModel {
         run: () => void;
     };
     sortReaction(): {
-        track: () => (import("@xh/hoist/cmp/grid").GridSorter[] | GridApi<any>)[];
+        track: () => (GridApi<any> | import("@xh/hoist/cmp/grid").GridSorter[])[];
         run: ([agApi, sortBy]: [any, any]) => void;
     };
     groupReaction(): {
@@ -83,7 +86,7 @@ export declare class GridLocalModel extends HoistModel {
     get useScrollOptimization(): boolean;
     applyScrollOptimization(): void;
     columnsReaction(): {
-        track: () => (import("@xh/hoist/cmp/grid").ColumnOrGroup[] | GridApi<any>)[];
+        track: () => (GridApi<any> | import("@xh/hoist/cmp/grid").ColumnOrGroup[])[];
         run: ([api]: [any]) => void;
     };
     columnStateReaction(): ReactionSpec<[GridApi, ColumnState[]]>;
@@ -129,6 +132,7 @@ export declare class GridLocalModel extends HoistModel {
     writeFilterState(filterState: any): void;
     processCellForClipboard: ({ value, node, column }: ProcessCellForExportParams) => any;
     navigateToNextCell: (agParams: any) => import("ag-grid-community").CellPosition;
+    onViewMouseDown: (evt: MouseEvent) => void;
     onCellMouseDown: (evt: any) => void;
     onKeyDown: (evt: any) => void;
     onRowClicked: (evt: any) => void;

package/build/types/cmp/grid/GridModel.d.ts

@@ -1,5 +1,5 @@
 import { AgGridModel } from '@xh/hoist/cmp/ag-grid';
-import { Column, ColumnGroup, ColumnOrGroup, ColumnOrGroupSpec, ColumnSpec, GridAutosizeMode, GridFilterModelConfig, GridGroupSortFn, TreeStyle } from '@xh/hoist/cmp/grid';
+import { Column, ColumnGroup, ColumnOrGroup, ColumnOrGroupSpec, ColumnSpec, GridAutosizeMode, GridFilterModelConfig, GridGroupSortFn, IColChooserModel, TreeStyle } from '@xh/hoist/cmp/grid';
 import { GridFilterModel } from '@xh/hoist/cmp/grid/filter/GridFilterModel';
 import { Awaitable, HoistModel, HSide, LoadSpec, PlainObject, SizingMode, Some, TaskObserver, Thunkable, VSide } from '@xh/hoist/core';
 import { Store, StoreConfig, StoreRecord, StoreRecordId, StoreRecordOrId, StoreSelectionConfig, StoreSelectionModel, StoreTransaction } from '@xh/hoist/data';
@@ -155,6 +155,10 @@ export interface GridConfig {
      * expand/collapse options in the default context menu will be enhanced to allow users to
      * expand/collapse to a specific level. See {@link GroupingChooserModel.valueDisplayNames}
      * for a convenient getter that will satisfy this API when a GroupingChooser is in play.
+     *
+     * Labels are matched to levels top-down and need not cover the full depth of the grid - provide
+     * a partial array to label only the top levels (e.g. when deeper levels should not be
+     * expand-to targets). Deeper, unlabelled levels are omitted from the menu.
      */
     levelLabels?: Thunkable<string[]>;
     /**
@@ -281,7 +285,7 @@ export declare class GridModel extends HoistModel {
     store: Store;
     selModel: StoreSelectionModel;
     treeMode: boolean;
-    colChooserModel: HoistModel;
+    colChooserModel: IColChooserModel;
     rowClassFn: RowClassFn;
     rowClassRules: Record<string, RowClassRuleFn>;
     contextMenu: GridContextMenuSpec;
@@ -501,8 +505,15 @@ export declare class GridModel extends HoistModel {
     expandToLevel(level: number): void;
     /**
      * Get the resolved level labels for the current state of the grid.
+     * An over-long array is truncated to the current `maxDepth`.
      */
     get resolvedLevelLabels(): string[];
+    /**
+     * True if the given `resolvedLevelLabels` index is the grid's current expand level - used to
+     * mark the active item in the "Expand to..." menu. The deepest labelled level counts as current
+     * whenever the grid is expanded to or beyond it.
+     */
+    isCurrentExpandLevel(idx: number): boolean;
     /**
      * Sort this grid.
      * This method is a no-op if provided any sorters without a corresponding column.

package/build/types/cmp/grid/Types.d.ts

@@ -1,4 +1,4 @@
-import type { HSide, PersistOptions, Some } from '@xh/hoist/core';
+import type { HoistModel, HSide, PersistOptions, Some } from '@xh/hoist/core';
 import type { FilterBindTarget, FilterMatchMode, FilterValueSource, Store, StoreRecord } from '@xh/hoist/data';
 import type { CellClassParams, CustomCellEditorProps, HeaderClassParams, HeaderValueGetterParams, ICellRendererParams, IRowNode, ITooltipParams, RowClassParams, ValueSetterParams } from '@xh/hoist/kit/ag-grid';
 import type { ReactElement, ReactNode } from 'react';
@@ -101,6 +101,13 @@ export interface GridFilterBindTarget extends FilterBindTarget, FilterValueSourc
  * @returns the formatted value for display.
  */
 export type GroupRowRenderer = (context: ICellRendererParams) => ReactNode;
+/** Cross-platform interface for desktop and mobile ColChooserModels. */
+export interface IColChooserModel extends HoistModel {
+    readonly gridModel: GridModel;
+    readonly isOpen: boolean;
+    open(): void;
+    close(): void;
+}
 /**
  * Configuration for a {@link ColChooserModel} - the model backing the grid column chooser UI.
  * Passed via the `colChooserModel` config on {@link GridConfig}, or set app-wide via

package/build/types/cmp/grid/filter/GridFilterFieldSpec.d.ts

@@ -1,17 +1,34 @@
-import { ColumnRenderer } from '@xh/hoist/cmp/grid';
 import { HoistInputProps } from '@xh/hoist/cmp/input';
 import { PlainObject } from '@xh/hoist/core';
 import { FieldFilterOperator } from '@xh/hoist/data';
 import { BaseFilterFieldSpec, BaseFilterFieldSpecConfig } from '@xh/hoist/data/filter/BaseFilterFieldSpec';
+import { ReactNode } from 'react';
 import { GridFilterModel } from './GridFilterModel';
+/**
+ * Produces the display content for an entry in the Values tab of a column filter. Must be a pure
+ * transform of the value - the values list carries no source record, and there is no column or
+ * grid context to reach for (unlike a Column's `renderer`, which runs against the source grid).
+ */
+export type GridFilterRenderer = (value: any) => ReactNode;
+/**
+ * Produces the value to sort by for an entry in the Values tab of a column filter. Must be a pure
+ * transform of the value - the values list carries no source record, and there is no column or
+ * grid context to reach for (unlike a Column's `sortValue`, which runs against the source grid).
+ */
+export type GridFilterSortValueFn = (value: any) => any;
 export interface GridFilterFieldSpecConfig extends BaseFilterFieldSpecConfig {
     /** GridFilterModel instance owning this fieldSpec. */
     filterModel?: GridFilterModel;
     /**
-     * Function returning a formatted string for each value in this values filter display.
-     * If not provided, the Column's renderer will be used.
+     * Pure function producing the display content for each entry in the values filter display. If
+     * not provided, the Column's renderer is used where it can be applied to a bare value.
+     */
+    renderer?: GridFilterRenderer;
+    /**
+     * Pure function producing the value to sort each entry of the values filter display by. If not
+     * provided, the Column's sortValue is used where it can be applied to a bare value.
      */
-    renderer?: ColumnRenderer;
+    sortValue?: GridFilterSortValueFn;
     /**
      * Props to pass through to the HoistInput components used on the custom filter tab.
      * Note that the HoistInput component used is decided by fieldType.
@@ -26,12 +43,13 @@ export interface GridFilterFieldSpecConfig extends BaseFilterFieldSpecConfig {
  */
 export declare class GridFilterFieldSpec extends BaseFilterFieldSpec {
     filterModel: GridFilterModel;
-    renderer: ColumnRenderer;
+    renderer: GridFilterRenderer;
+    sortValue: GridFilterSortValueFn;
     inputProps: PlainObject;
     defaultOp: FieldFilterOperator;
     /** Total number of unique values for this field in the source, regardless of other filters. */
     allValuesCount: number;
-    constructor({ filterModel, renderer, inputProps, defaultOp, ...rest }: GridFilterFieldSpecConfig);
+    constructor({ filterModel, renderer, sortValue, inputProps, defaultOp, ...rest }: GridFilterFieldSpecConfig);
     getUniqueValue(value: unknown): unknown;
     loadValuesFromSource(): void;
     private cleanFilter;

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

@@ -21,6 +21,12 @@ export interface SegmentedControlOption {
      * `intent` default. Defaults to the control's `intent`.
      */
     intent?: Intent;
+    /**
+     * Optional stable identifier emitted on this option's rendered button as `data-testid`, for
+     * use by E2E tests. If omitted and the control itself has a `testId`, one is auto-derived as
+     * `${controlTestId}-${value}`. If neither is set, no attribute is emitted.
+     */
+    testId?: string;
 }
 /**
  * Variant of SegmentedControlOption for representing a null/"no value" selection.
@@ -41,4 +47,10 @@ export interface SegmentedControlNullOption {
      * `intent` default. Defaults to the control's `intent`.
      */
     intent?: Intent;
+    /**
+     * Optional stable identifier emitted on this option's rendered button as `data-testid`, for
+     * use by E2E tests. If omitted and the control itself has a `testId`, one is auto-derived as
+     * `${controlTestId}-null`. If neither is set, no attribute is emitted.
+     */
+    testId?: string;
 }

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

@@ -1,5 +1,4 @@
-import { AppOptionSpec, HoistModel, InitContext, Thunkable } from './';
-import { Route } from 'router5';
+import { AppOptionSpec, HoistModel, HoistRoute, InitContext, Thunkable } from './';
 import { ReactNode } from 'react';
 /**
  * Specialized base class for defining the central model for a Hoist app as specified by its
@@ -40,7 +39,7 @@ export declare class HoistAppModel extends HoistModel {
     /**
      * Provide the initial set of Router5 Routes to be used by this application.
      */
-    getRoutes(): Route[];
+    getRoutes(): HoistRoute[];
     /**
      * Provide a list of app-wide options to be displayed in the App's built-in Options
      * dialog, accessible from the default AppBar menu when this method returns non-empty.

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

@@ -3,6 +3,7 @@ import { LocalDate } from '@xh/hoist/utils/datetime';
 import { MomentInput } from 'moment';
 import { Component, FunctionComponent, ReactElement } from 'react';
 import { DebounceSettings } from 'lodash';
+import { Route } from 'router5';
 /** Values available for intents. */
 export type Intent = 'primary' | 'success' | 'warning' | 'danger';
 /** Values available for App Theme. */
@@ -42,6 +43,17 @@ export type DebounceSpec = number | (DebounceSettings & {
  */
 export type Content = ReactElement | FunctionComponent | Component | ElementFactory | (() => ReactElement);
 export type DateLike = Date | LocalDate | MomentInput;
+/**
+ * A Router5 {@link Route} spec, extended with Hoist's `omit` support for declarative exclusion of
+ * routes at registration time (e.g. role-gated sections). Note `omit` is evaluated once when routes
+ * are added to the router during app startup - it is not reactive.
+ *
+ * @see HoistAppModel.getRoutes
+ */
+export interface HoistRoute extends Omit<Route, 'children'> {
+    omit?: Thunkable<boolean>;
+    children?: HoistRoute[];
+}
 /** Valid units for the {@link LocalDate} adjustment methods. */
 export type LocalDateUnit = 'year' | 'years' | 'quarter' | 'quarters' | 'month' | 'months' | 'week' | 'weeks' | 'day' | 'days';
 export type PageState = 

package/build/types/desktop/cmp/button/grid/ExpandToLevelButton.d.ts

@@ -13,6 +13,7 @@ export interface ExpandToLevelButtonProps extends Omit<ButtonProps, 'title'> {
 }
 /**
  * A menu button to expand a multi-level grouped or tree grid out to a desired level.
- * Requires {@link GridConfig.levelLabels} to be configured on the bound GridModel.
+ * Requires {@link GridConfig.levelLabels} to be configured on the bound GridModel - the menu offers
+ * one entry per labelled level, so a partial array will limit the available expand-to targets.
  */
 export declare const ExpandToLevelButton: import("react").FC<ExpandToLevelButtonProps>, expandToLevelButton: import("@xh/hoist/core").ElementFactory<ExpandToLevelButtonProps>;

package/build/types/desktop/cmp/filter/FilterChooser.d.ts

@@ -24,6 +24,11 @@ export interface FilterChooserProps extends HoistProps<FilterChooserModel>, Layo
     placeholder?: string;
     /** Icon clicked to launch favorites menu. (Defaults to Icon.favorite()) */
     favoritesIcon?: ReactElement;
+    /**
+     * True to render collapsed in-place, expanding into a popover when opened - useful in toolbars
+     * and other height-constrained containers. Opens in the direction set by `menuPlacement`.
+     */
+    popover?: boolean;
 }
 /**
  * A Select based control for searching and choosing filters.

package/build/types/desktop/cmp/filter/PopoverFilterChooser.d.ts

@@ -1,9 +1,11 @@
 import '@xh/hoist/desktop/register';
-import './PopoverFilterChooser.scss';
 import { FilterChooserProps } from './FilterChooser';
 /**
  * A wrapper around a FilterChooser that renders in a popover when opened, allowing it to expand
  * vertically beyond the height of a toolbar.
+ *
+ * @deprecated Use `filterChooser({popover: true})` instead - the popover behavior is now a built-in
+ *      mode of `FilterChooser`. This alias will be removed in a future major release.
  * @see FilterChooser
  */
 export declare const PopoverFilterChooser: import("react").FC<FilterChooserProps>, popoverFilterChooser: import("@xh/hoist/core").ElementFactory<FilterChooserProps>;

package/build/types/desktop/cmp/grid/impl/colchooser/ColChooserModel.d.ts

@@ -1,4 +1,4 @@
-import { ColChooserConfig, GridModel } from '@xh/hoist/cmp/grid';
+import { ColChooserConfig, GridModel, IColChooserModel } from '@xh/hoist/cmp/grid';
 import { HoistModel } from '@xh/hoist/core';
 import type { FilterMatchMode } from '@xh/hoist/data';
 import { LeftRightChooserModel } from '@xh/hoist/desktop/cmp/leftrightchooser';
@@ -6,7 +6,7 @@ import { LeftRightChooserModel } from '@xh/hoist/desktop/cmp/leftrightchooser';
  * State management for the ColChooser component.
  * @internal
  */
-export declare class ColChooserModel extends HoistModel {
+export declare class ColChooserModel extends HoistModel implements IColChooserModel {
     xhImpl: boolean;
     gridModel: GridModel;
     lrModel: LeftRightChooserModel;

package/build/types/desktop/cmp/grid/impl/filter/headerfilter/custom/CustomRowModel.d.ts

@@ -1,8 +1,16 @@
+import type { GridFilterFieldSpec } from '@xh/hoist/cmp/grid';
 import { HoistModel } from '@xh/hoist/core';
 import { FieldFilterOperator, FieldFilterSpec } from '@xh/hoist/data';
 import { HeaderFilterModel } from '../HeaderFilterModel';
 import { CustomTabModel } from './CustomTabModel';
 type OperatorOptionValue = 'blank' | 'not blank' | FieldFilterOperator;
+/**
+ * Whether a row for the given op renders the multi-value `select` input - the only custom-tab input
+ * that holds an array of values directly. The single-value inputs (number, date, text) are used
+ * otherwise, so array filter values bound for them must be expanded into one row each (see
+ * `CustomTabModel.doSyncWithFilter`). Mirrors the input choice made in `CustomRow`.
+ */
+export declare function usesMultiValueInput(fieldSpec: GridFilterFieldSpec, op: FieldFilterOperator): boolean;
 /**
  * @internal
  */
@@ -14,7 +22,7 @@ export declare class CustomRowModel extends HoistModel {
     inputVal: any;
     /** FieldFilter config output of this row. */
     get value(): FieldFilterSpec;
-    get fieldSpec(): import("../../../../../../../cmp/grid").GridFilterFieldSpec;
+    get fieldSpec(): GridFilterFieldSpec;
     get options(): {
         label: string;
         value: OperatorOptionValue;

package/build/types/desktop/cmp/grid/impl/filter/headerfilter/custom/CustomTabModel.d.ts

@@ -1,5 +1,5 @@
 import { HoistModel } from '@xh/hoist/core';
-import { CompoundFilterOperator, FilterLike } from '@xh/hoist/data';
+import { CompoundFilterOperator, FieldFilter, FilterLike } from '@xh/hoist/data';
 import { HeaderFilterModel } from '../HeaderFilterModel';
 import { CustomRowModel } from './CustomRowModel';
 export declare class CustomTabModel extends HoistModel {
@@ -11,11 +11,17 @@ export declare class CustomTabModel extends HoistModel {
     get filter(): FilterLike;
     get fieldSpec(): import("../../../../../../../cmp/grid").GridFilterFieldSpec;
     get currentGridFilter(): import("@xh/hoist/data").Filter;
-    get columnFilters(): import("@xh/hoist/data").FieldFilter[];
+    get columnFilters(): FieldFilter[];
+    get columnCompoundFilter(): import("@xh/hoist/data").CompoundFilter;
     constructor(headerFilterModel: HeaderFilterModel);
     syncWithFilter(): void;
     reset(): void;
     addEmptyRow(): void;
     removeRow(model: any): void;
     private doSyncWithFilter;
+    private needsExpansion;
+    private mergeOpFor;
+    private deriveOp;
+    private get isRepresentable();
+    private collapseToArrayFilters;
 }

package/build/types/desktop/cmp/input/CodeInput.d.ts

@@ -4,6 +4,13 @@ import './CodeInput.scss';
 export interface CodeInputProps extends HoistProps, HoistInputProps, LayoutProps {
     /** True to focus the control on render. */
     autoFocus?: boolean;
+    /**
+     * True to automatically format content for display using the configured `formatter`.
+     * Defaults to true for `readonly` inputs - set false to opt out. May also be enabled on
+     * editable inputs, in which case content is formatted on blur (never mid-edit, so user
+     * edits and cursor position are preserved while typing).
+     */
+    autoFormat?: boolean;
     /** False to not commit on every change/keystroke, default true. */
     commitOnChange?: boolean;
     /**

package/build/types/desktop/cmp/input/NumberInput.d.ts

@@ -36,7 +36,7 @@ export interface NumberInputProps extends HoistProps, LayoutProps, StyleProps, H
     onKeyDown?: KeyboardEventHandler<HTMLInputElement>;
     /** Text to display when control is empty. */
     placeholder?: string;
-    /** Max decimal precision of the value, defaults to 4. */
+    /** Max decimal precision of the value, defaults to 4. Set to null for full, unrestricted precision. */
     precision?: NumericPrecision;
     /** Element to display inline on the right side of the input. */
     rightElement?: ReactNode;

package/build/types/desktop/cmp/input/Select.d.ts

@@ -127,6 +127,14 @@ export interface SelectProps extends HoistProps, HoistInputProps, LayoutProps {
     selectOnFocus?: boolean;
     /** Field on provided options for sourcing each option's value (default `value`). */
     valueField?: string;
+    /**
+     * Function to generate a `SelectOption` for a (non-null) selected value not present in the
+     * current options list. Return null to fall back to the default value-as-label behavior.
+     *
+     * Useful with queryFn-based selects, readonly forms, or any case where options may not be
+     * loaded when a value is set, ensuring the value renders with its proper label.
+     */
+    generateOptionFn?: (value: any) => SelectOption;
 }
 /**
  * A managed wrapper around the React-Select combobox/dropdown component.

package/build/types/desktop/cmp/input/impl/CalcWindowedMenuWidth.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react';
+/**
+ * Compute an explicit pixel width for a windowed (virtualized) `Select` menu.
+ *
+ * Windowed menus can't auto-size via CSS - react-window absolutely-positions rows at width:100%,
+ * so option content never widens the menu and it collapses to the control width. This restores
+ * content-based sizing using Canvas + off-screen DOM, the same render-and-measure approach as the
+ * grid's `ColumnWidthCalculator`: render each option's actual menu markup (via the configured
+ * `optionRenderer`, if any), canvas-estimate its width to pick the widest candidates, then measure
+ * only those candidates' displayed width in a hidden probe - so custom `optionRenderer`s (icons,
+ * multi-element content, etc.) size correctly. Unlike the grid (which may autosize many columns
+ * over thousands of records), this renders one menu's options once per options change.
+ *
+ * @param options - normalized (possibly grouped) Select options.
+ * @param renderOption - renders an option to its menu `ReactNode` (e.g. model.formatOptionLabel).
+ * @param portal - shared menu portal div, used to host probes so menu CSS (font, padding) applies.
+ * @returns explicit menu width in px, or null to fall back to the control width.
+ * @internal
+ */
+export declare function calcWindowedMenuWidth(options: any[], renderOption: (opt: any) => ReactNode, portal: HTMLElement): number;

package/build/types/desktop/cmp/rest/impl/RestFormModel.d.ts

@@ -20,7 +20,7 @@ export declare class RestFormModel extends HoistModel {
         del?: import("react").ReactNode | ((recs: import("@xh/hoist/data").StoreRecord[]) => import("react").ReactNode);
         edit?: import("react").ReactNode | ((recs: import("@xh/hoist/data").StoreRecord[]) => import("react").ReactNode);
     };
-    get actions(): (import("@xh/hoist/data").RecordActionSpec | import("@xh/hoist/data").RecordAction)[];
+    get actions(): (import("@xh/hoist/data").RecordAction | import("@xh/hoist/data").RecordActionSpec)[];
     get editors(): RestGridEditor[];
     get gridModel(): import("../../../../cmp/grid").GridModel;
     get store(): import("@xh/hoist/desktop/cmp/rest").RestStore;

package/build/types/format/FormatNumber.d.ts

@@ -33,8 +33,9 @@ export interface NumberFormatOptions extends Omit<FormatOptions<number>, 'toolti
      */
     omitFourDigitComma?: boolean;
     /**
-     * Desired number of decimal places, or 'auto' (default) to adjust the displayed precision
-     * automatically based on the scale of the value.
+     * Desired number of decimal places, 'auto' (default) to adjust the displayed precision
+     * automatically based on the scale of the value, or null for full, unrestricted precision
+     * (capped at the max supported precision, with trailing zeros trimmed).
      */
     precision?: Precision;
     /** Prefix to prepend to value (between the number and its sign). */
@@ -65,13 +66,20 @@ export interface NumberFormatOptions extends Omit<FormatOptions<number>, 'toolti
      *
      * e.g. `{precision:4, zeroPad:2}` will format `1.2` → "1.20" and `1.234` → "1.234"
      *
-     * Default is true if a fixed precision is set, false if precision is 'auto'.
+     * Default is true if a fixed precision is set, false if precision is 'auto' or null (full).
      */
     zeroPad?: ZeroPad;
 }
 export interface QuantityFormatOptions extends NumberFormatOptions {
+    /** True to compact values \>= 1 million into units of millions (m). Default true. */
     useMillions?: boolean;
+    /** True to compact values \>= 1 billion into units of billions (b). Default true. */
     useBillions?: boolean;
+    /**
+     * True to compact to m/b units only when no precision is lost, else render the full value.
+     * Default false.
+     */
+    lossless?: boolean;
 }
 /** Config for pos/neg/neutral color classes. */
 export interface ColorSpec {

package/build/types/icon/Icon.d.ts

@@ -3,6 +3,7 @@ import { FontAwesomeIconProps } from '@fortawesome/react-fontawesome';
 import { HoistProps, Intent, Thunkable } from '@xh/hoist/core';
 import { ReactElement } from 'react';
 import { SetRequired } from 'type-fest';
+import './Icon.scss';
 export interface IconProps extends HoistProps, Partial<Omit<FontAwesomeIconProps, 'ref'>> {
     /** Name of the icon in FontAwesome. */
     iconName?: IconName;
@@ -333,9 +334,9 @@ export declare const Icon: {
         filename: string;
     }): any;
     /**
-     * Returns an empty div with FA sizing classes applied. Can be used to take up room in a layout
-     * where an icon might otherwise go - e.g. to align a series of menu items, where some items do
-     * not have an icon but others do.
+     * Returns an empty div sized to occupy the width of a standard icon. Can be used to take up
+     * room in a layout where an icon might otherwise go - e.g. to align a series of menu items,
+     * where some items do not have an icon but others do.
      */
     placeholder(opts?: IconProps): any;
 };

package/build/types/kit/react-dropzone/index.d.ts

@@ -1,4 +1,5 @@
 import Dropzone from 'react-dropzone';
 export { Dropzone };
+export { ErrorCode } from 'react-dropzone';
 export type { Accept, FileRejection, FileWithPath } from 'react-dropzone';
 export declare const dropzone: import("@xh/hoist/core").ElementFactory<import("react-dropzone").DropzoneProps & import("react").RefAttributes<import("react-dropzone").DropzoneRef>>;

package/build/types/kit/swiper/index.d.ts

@@ -27,6 +27,7 @@ export declare const swiper: import("@xh/hoist/core").ElementFactory<import("rea
     onScrollbarDragStart?: (swiper: import("swiper/types").Swiper, event: MouseEvent | TouchEvent | PointerEvent) => void;
     onScrollbarDragMove?: (swiper: import("swiper/types").Swiper, event: MouseEvent | TouchEvent | PointerEvent) => void;
     onScrollbarDragEnd?: (swiper: import("swiper/types").Swiper, event: MouseEvent | TouchEvent | PointerEvent) => void;
+    onVirtualUpdate?: (swiper: import("swiper/types").Swiper) => void;
     onZoomChange?: (swiper: import("swiper/types").Swiper, scale: number, imageEl: HTMLElement, slideEl: HTMLElement) => void;
     onInit?: (swiper: import("swiper/types").Swiper) => any;
     onBeforeDestroy?: (swiper: import("swiper/types").Swiper) => void;
@@ -53,8 +54,8 @@ export declare const swiper: import("@xh/hoist/core").ElementFactory<import("rea
     onReachEnd?: (swiper: import("swiper/types").Swiper) => void;
     onToEdge?: (swiper: import("swiper/types").Swiper) => void;
     onFromEdge?: (swiper: import("swiper/types").Swiper) => void;
-    onSetTranslate?: (swiper: import("swiper/types").Swiper, translate: number) => void;
-    onSetTransition?: (swiper: import("swiper/types").Swiper, transition: number) => void;
+    onSetTranslate?: (swiper: import("swiper/types").Swiper, translate: number, byController?: boolean | Swiper) => void;
+    onSetTransition?: (swiper: import("swiper/types").Swiper, transition: number, byController?: boolean | Swiper) => void;
     onResize?: (swiper: import("swiper/types").Swiper) => void;
     onObserverUpdate?: (swiper: import("swiper/types").Swiper) => void;
     onBeforeLoopFix?: (swiper: import("swiper/types").Swiper) => void;
@@ -77,7 +78,7 @@ export declare const swiper: import("@xh/hoist/core").ElementFactory<import("rea
     onBeforeInit?: (swiper: import("swiper/types").Swiper) => void;
     onBeforeResize?: (swiper: import("swiper/types").Swiper) => void;
     onBeforeSlideChangeStart?: (swiper: import("swiper/types").Swiper) => void;
-    onBeforeTransitionStart?: (swiper: import("swiper/types").Swiper, speed: number, internal: any) => void;
+    onBeforeTransitionStart?: (swiper: import("swiper/types").Swiper, speed: number, internal: unknown) => void;
     onChangeDirection?: (swiper: import("swiper/types").Swiper) => void;
     onDoubleClick?: (swiper: import("swiper/types").Swiper, event: MouseEvent | TouchEvent | PointerEvent) => void;
     onDestroy?: (swiper: import("swiper/types").Swiper) => void;

package/build/types/mobile/cmp/button/grid/ExpandToLevelButton.d.ts

@@ -10,6 +10,7 @@ export interface ExpandToLevelButtonProps extends MenuButtonProps {
 }
 /**
  * A menu button to expand a multi-level grouped or tree grid out to a desired level.
- * Requires {@link GridConfig.levelLabels} to be configured on the bound GridModel.
+ * Requires {@link GridConfig.levelLabels} to be configured on the bound GridModel - the menu offers
+ * one entry per labelled level, so a partial array will limit the available expand-to targets.
  */
 export declare const ExpandToLevelButton: import("react").FC<ExpandToLevelButtonProps>, expandToLevelButton: import("@xh/hoist/core").ElementFactory<ExpandToLevelButtonProps>;

package/build/types/mobile/cmp/grid/impl/ColChooserModel.d.ts

@@ -1,4 +1,4 @@
-import { GridModel } from '@xh/hoist/cmp/grid';
+import { GridModel, IColChooserModel } from '@xh/hoist/cmp/grid';
 import { HoistModel, HSide } from '@xh/hoist/core';
 import '@xh/hoist/mobile/register';
 /**
@@ -7,7 +7,7 @@ import '@xh/hoist/mobile/register';
  * It is not necessary to manually create instances of this class within an application.
  * @internal
  */
-export declare class ColChooserModel extends HoistModel {
+export declare class ColChooserModel extends HoistModel implements IColChooserModel {
     xhImpl: boolean;
     gridModel: GridModel;
     showRestoreDefaults: boolean;