@xh/hoist 86.1.0 → 86.2.0

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## 86.2.0 - 2026-06-25
+
+### 🎁 New Features
+
+* `CodeInput` / `JsonInput` now auto-format content for display via their configured `formatter`,
+  controlled by a new `autoFormat` prop. On editable inputs, content is tidied automatically on blur
+  (never mid-edit) - users get clean, consistently-formatted JSON without reaching for the format
+  button. For `readonly` inputs it defaults to true, so applications can bind directly to raw source
+  values and drop their pre-formatting logic, simplifying call sites substantially.
+* Grid column filter specs now support a `sortValue` config, letting the Values tab of the filter
+  dialog sort its entries the same way the underlying grid column sorts them. When not provided,
+  the column's own `sortValue` is used.
+* `GridModel.levelLabels` now accepts a partial array covering only the top levels of a tree or
+  grouped grid. The "Expand to..." menu and `ExpandToLevelButton` offer one entry per labelled
+  level, so deeper, unlabelled levels (e.g. system-managed) are no longer required and are omitted
+  as expand-to targets - previously a too-short array disabled the feature entirely.
+* Added a `lossless` option to `fmtQuantity` to compact values to millions / billions units only
+  when doing so loses no precision, rendering the full value otherwise (e.g. `7,100,100` stays
+  `7,100,100` rather than collapsing to `7.10m`).
+
+### 🐞 Bug Fixes
+
+* Fixed grid `NumberEditor` to allow starting an edit by typing `-`, `+`, or `.` (e.g. to enter a
+  negative or decimal value), while reliably rejecting other non-numeric keypresses.
+* `fmtNumber` now treats a `precision` of `null` as full, unrestricted precision rather than
+  `'auto'`, aligning a `NumberInput` with `precision: null` so its blurred display matches its
+  focused and committed (full-precision) value.
+* Fixed inline grid editing not ending when clicking empty grid space to the right of the last
+  column or below the last row - such clicks now commit the active edit.
+* Fixed `Icon.placeholder()` to render with the correct width.
+* `CheckboxButton` no longer leaks `HoistInputProps` into underlying HTML `<button>` element.
+* Fixed `Select` (and `SelectEditor`) dropdown menu sizing: windowed menus now auto-size to their
+  option labels instead of the control/cell width, and an explicit `menuWidth` is respected rather
+  than overridden by content auto-sizing.
+
+### ⚙️ Typescript API Adjustments
+
+* `GridFilterFieldSpec.renderer` is now typed as a pure value transform (`GridFilterRenderer`),
+  rather than a `ColumnRenderer`. This more accurately represents the existing run-time limitation
+  that a complex column renderer would throw.
+
+### ✨ Styles
+
+* Vertical (left/right) `TabContainer` switchers now render a modern rounded-pill treatment by
+  default, customizable via new `--xh-tab-switcher-vertical-*` CSS variables.
+
 ## 86.1.0 - 2026-06-22
 
 ### 🎁 New Features

package/admin/AdminJsonDisplay.ts

@@ -0,0 +1,31 @@
+/*
+ * This file belongs to Hoist, an application development toolkit
+ * developed by Extremely Heavy Industries (www.xh.io | info@xh.io)
+ *
+ * Copyright © 2026 Extremely Heavy Industries Inc.
+ */
+import {hoistCmp} from '@xh/hoist/core';
+import {jsonInput, JsonInputProps} from '@xh/hoist/desktop/cmp/input';
+import {fmtJson, timestampReplacer} from '@xh/hoist/format';
+
+/**
+ * Readonly `jsonInput` preconfigured for Admin Console stat / config displays - sized to fill its
+ * container, without line numbers or a fullscreen button, and rendering timestamp-suffixed fields
+ * as readable dates. Pass the data via `value` (any object) or `bind`, plus any additional
+ * `jsonInput` props (e.g. `enableSearch`) to extend or override the defaults.
+ */
+export const adminJsonDisplay = hoistCmp.factory<JsonInputProps>({
+    displayName: 'AdminJsonDisplay',
+    render(props) {
+        return jsonInput({
+            readonly: true,
+            flex: 1,
+            width: '100%',
+            height: '100%',
+            showFullscreenButton: false,
+            lineNumbers: false,
+            formatter: v => fmtJson(v, {replacer: timestampReplacer()}),
+            ...props
+        });
+    }
+});

package/admin/App.scss

@@ -6,19 +6,11 @@
  */
 
 .xh-admin-app {
+  // The admin console uses left side-tab rails throughout - give them a consistent minimum width.
+  // All other vertical-switcher styling is inherited from the framework default.
   .xh-tab-switcher--left,
   .xh-tab-switcher--right {
-    min-width: 160px;
-    background-color: var(--xh-grid-bg-odd);
-    border-right: var(--xh-border-solid);
-
-    .bp6-tab {
-      border-radius: 0 !important;
-    }
-
-    .xh-tab-switcher__tab {
-      line-height: 40px;
-    }
+    --xh-tab-switcher-vertical-min-width: 160px;
   }
 
   &__editor-dialog {

package/admin/jsonsearch/impl/JsonSearchImplModel.ts

@@ -6,7 +6,7 @@
  */
 
 import {GridConfig, GridModel} from '@xh/hoist/cmp/grid';
-import {HoistModel, managed, TaskObserver, XH} from '@xh/hoist/core';
+import {HoistModel, managed, PlainObject, TaskObserver, XH} from '@xh/hoist/core';
 import {action, bindable, makeObservable, observable} from '@xh/hoist/mobx';
 import {pluralize} from '@xh/hoist/utils/js';
 import {isEmpty, zipWith} from 'lodash';
@@ -32,7 +32,7 @@ export class JsonSearchImplModel extends HoistModel {
     @bindable path: string = '';
     @bindable readerContentType: 'document' | 'matches' = 'matches';
     @bindable pathFormat: 'XPath' | 'JSONPath' = 'XPath';
-    @bindable readerContent: string = '';
+    @bindable readerContent: string | PlainObject[] = '';
     @bindable matchingNodeCount: number = 0;
 
     get subjectName(): string {
@@ -137,7 +137,7 @@ export class JsonSearchImplModel extends HoistModel {
         const {json} = this.selectedRecord.data;
 
         if (this.readerContentType === 'document') {
-            this.readerContent = JSON.stringify(JSON.parse(json), null, 2);
+            this.readerContent = json;
             return;
         }
 
@@ -162,7 +162,7 @@ export class JsonSearchImplModel extends HoistModel {
                         value
                     };
                 });
-                this.readerContent = JSON.stringify(nodes, null, 2);
+                this.readerContent = nodes;
             });
     }
 

package/admin/tabs/cluster/instances/connpool/ConnPoolMonitorPanel.ts

@@ -4,6 +4,7 @@
  *
  * Copyright © 2026 Extremely Heavy Industries Inc.
  */
+import {adminJsonDisplay} from '@xh/hoist/admin/AdminJsonDisplay';
 import {AppModel} from '@xh/hoist/admin/AppModel';
 import {ConnPoolMonitorModel} from '@xh/hoist/admin/tabs/cluster/instances/connpool/ConnPoolMonitorModel';
 import {chart} from '@xh/hoist/cmp/chart';
@@ -12,7 +13,6 @@ import {filler, hframe, vframe} from '@xh/hoist/cmp/layout';
 import {creates, hoistCmp} from '@xh/hoist/core';
 import {button, exportButton} from '@xh/hoist/desktop/cmp/button';
 import {errorMessage} from '@xh/hoist/cmp/error';
-import {jsonInput} from '@xh/hoist/desktop/cmp/input';
 import {panel} from '@xh/hoist/desktop/cmp/panel';
 import {toolbar} from '@xh/hoist/desktop/cmp/toolbar';
 import {Icon} from '@xh/hoist/icon';
@@ -74,7 +74,7 @@ const bbar = hoistCmp.factory<ConnPoolMonitorModel>({
 });
 
 const poolConfigPanel = hoistCmp.factory<ConnPoolMonitorModel>({
-    render({model}) {
+    render() {
         return panel({
             title: 'Pool Configuration',
             icon: Icon.info(),
@@ -84,15 +84,7 @@ const poolConfigPanel = hoistCmp.factory<ConnPoolMonitorModel>({
                 defaultSize: 450,
                 defaultCollapsed: true
             },
-            item: jsonInput({
-                readonly: true,
-                height: '100%',
-                width: '100%',
-                enableSearch: true,
-                showFullscreenButton: false,
-                lineNumbers: false,
-                value: JSON.stringify(model.poolConfiguration, null, 2)
-            })
+            item: adminJsonDisplay({enableSearch: true, bind: 'poolConfiguration'})
         });
     }
 });

package/admin/tabs/cluster/instances/services/DetailsPanel.ts

@@ -4,15 +4,14 @@
  *
  * Copyright © 2026 Extremely Heavy Industries Inc.
  */
+import {adminJsonDisplay} from '@xh/hoist/admin/AdminJsonDisplay';
 import {DetailsModel} from '@xh/hoist/admin/tabs/cluster/instances/services/DetailsModel';
 import {placeholder} from '@xh/hoist/cmp/layout';
 import {creates, hoistCmp, XH} from '@xh/hoist/core';
 import {errorMessage} from '@xh/hoist/cmp/error';
 import {panel} from '@xh/hoist/desktop/cmp/panel';
-import {jsonInput} from '@xh/hoist/desktop/cmp/input';
 import {Icon} from '@xh/hoist/icon';
 import {isEmpty} from 'lodash';
-import {fmtJson, timestampReplacer} from '@xh/hoist/format';
 
 export const detailsPanel = hoistCmp.factory({
     model: creates(DetailsModel),
@@ -50,16 +49,6 @@ const stats = hoistCmp.factory<DetailsModel>({
                       ? []
                       : [Icon.questionCircle(), 'This service does not report any admin stats.'])
               )
-            : panel(
-                  jsonInput({
-                      readonly: true,
-                      width: '100%',
-                      height: '100%',
-                      enableSearch: true,
-                      showFullscreenButton: false,
-                      lineNumbers: false,
-                      value: fmtJson(stats, {replacer: timestampReplacer()})
-                  })
-              );
+            : panel(adminJsonDisplay({enableSearch: true, bind: 'stats'}));
     }
 });

package/admin/tabs/cluster/objects/DetailPanel.ts

@@ -4,21 +4,20 @@
  *
  * Copyright © 2026 Extremely Heavy Industries Inc.
  */
+import {adminJsonDisplay} from '@xh/hoist/admin/AdminJsonDisplay';
 import {grid} from '@xh/hoist/cmp/grid';
 import {placeholder} from '@xh/hoist/cmp/layout';
 import {creates, hoistCmp} from '@xh/hoist/core';
-import {jsonInput} from '@xh/hoist/desktop/cmp/input';
 import {panel} from '@xh/hoist/desktop/cmp/panel';
 import {Icon} from '@xh/hoist/icon';
 import {DetailModel} from './DetailModel';
 import './ClusterObjects.scss';
-import {fmtJson, timestampReplacer} from '@xh/hoist/format';
 
 export const detailPanel = hoistCmp.factory({
     model: creates(DetailModel),
 
     render({model}) {
-        const {instanceName, selectedAdminStats, objectName, objectType} = model;
+        const {instanceName, objectName, objectType} = model;
         if (!objectName) return placeholder(Icon.grip(), 'Select an object to view details...');
 
         return panel({
@@ -36,15 +35,7 @@ export const detailPanel = hoistCmp.factory({
                         defaultSize: '80%',
                         collapsible: false
                     },
-                    item: jsonInput({
-                        readonly: true,
-                        flex: 1,
-                        width: '100%',
-                        height: '100%',
-                        showFullscreenButton: false,
-                        lineNumbers: false,
-                        value: fmtJson(selectedAdminStats, {replacer: timestampReplacer()})
-                    })
+                    item: adminJsonDisplay({bind: 'selectedAdminStats'})
                 })
             ]
         });

package/build/types/admin/AdminJsonDisplay.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Readonly `jsonInput` preconfigured for Admin Console stat / config displays - sized to fill its
+ * container, without line numbers or a fullscreen button, and rendering timestamp-suffixed fields
+ * as readable dates. Pass the data via `value` (any object) or `bind`, plus any additional
+ * `jsonInput` props (e.g. `enableSearch`) to extend or override the defaults.
+ */
+export declare const adminJsonDisplay: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/desktop/cmp/input").CodeInputProps>;

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/cmp/grid/Grid.d.ts

@@ -3,6 +3,7 @@ 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 './Grid.scss';
 import { GridModel } from './GridModel';
 export interface GridProps<M extends GridModel = GridModel> extends HoistProps<M>, LayoutProps, TestSupportProps {
@@ -41,6 +42,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 +57,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 +65,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 +85,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 +131,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

@@ -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[]>;
     /**
@@ -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/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/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/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/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/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/input/NumberInput.d.ts

@@ -26,7 +26,7 @@ export interface NumberInputProps extends HoistProps, HoistInputProps, StyleProp
     modifier?: string;
     /** 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;
     /**
      * Scale factor to apply when converting between the internal and external value. Useful for

package/cmp/grid/Grid.ts

@@ -48,6 +48,7 @@ import {consumeEvent, isDisplayed, logWithDebug} from '@xh/hoist/utils/js';
 import {composeRefs, createObservableRef, getLayoutProps} from '@xh/hoist/utils/react';
 import classNames from 'classnames';
 import {compact, debounce, isBoolean, isEmpty, isEqual, isNil, max, maxBy, merge} from 'lodash';
+import {type MouseEvent} from 'react';
 import './Grid.scss';
 import {GridModel} from './GridModel';
 import {columnGroupHeader} from './impl/ColumnGroupHeader';
@@ -135,6 +136,7 @@ export const [Grid, grid] = hoistCmp.withFactory<GridProps>({
                 ],
                 testId,
                 onKeyDown: impl.onKeyDown,
+                onMouseDown: impl.onViewMouseDown,
                 ref: composeRefs(impl.viewRef, model.viewRef, ref)
             }),
             colChooserModel ? platformColChooser({model: colChooserModel}) : null,
@@ -151,6 +153,10 @@ export const [Grid, grid] = hoistCmp.withFactory<GridProps>({
 export class GridLocalModel extends HoistModel {
     override xhImpl = true;
 
+    // Structural "empty" grid space.
+    private static EMPTY_SPACE_SELECTOR =
+        '.ag-body-viewport, .ag-center-cols-viewport, .ag-center-cols-container, .ag-row';
+
     @lookup(GridModel)
     private model: GridModel;
     agOptions: GridOptions;
@@ -844,6 +850,17 @@ export class GridLocalModel extends HoistModel {
         return this.rowKeyNavSupport?.navigateToNextCell(agParams);
     };
 
+    // `stopEditingWhenCellsLoseFocus` doesn't fire on clicks in empty grid space (focus stays in
+    // the grid), so commit the active edit on those clicks ourselves. Require exact match on empty
+    // space to avoid interfering with cell editors.
+    onViewMouseDown = (evt: MouseEvent) => {
+        const {model} = this,
+            target = evt.target as HTMLElement;
+        if (model.isEditing && target.matches(GridLocalModel.EMPTY_SPACE_SELECTOR)) {
+            model.agApi?.stopEditing();
+        }
+    };
+
     onCellMouseDown = evt => {
         const {model} = this;
         if (model.highlightRowOnClick) {