@xh/hoist 86.0.1 → 86.2.0

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

@@ -0,0 +1,44 @@
+import { Intent } from '@xh/hoist/core';
+import { LocalDate } from '@xh/hoist/utils/datetime';
+import { ReactElement } from 'react';
+/** Primitive value types supported as a SegmentedControl option value/label. */
+export type OptionPrimitive = string | number | boolean | LocalDate;
+/**
+ * Option for a SegmentedControl, shared by the desktop and mobile implementations.
+ */
+export interface SegmentedControlOption {
+    /** Value for this option. */
+    value: OptionPrimitive;
+    /** Display label. Defaults to `value.toString()` if omitted. */
+    label?: string;
+    /** Icon element, displayed before the label. */
+    icon?: ReactElement;
+    /** True to disable this individual option. */
+    disabled?: boolean;
+    /**
+     * Visual intent for this option - rendered as a solid fill when selected and as a subtle
+     * text-color hint when not (e.g. to flag a destructive choice). Overrides any control-level
+     * `intent` default. Defaults to the control's `intent`.
+     */
+    intent?: Intent;
+}
+/**
+ * Variant of SegmentedControlOption for representing a null/"no value" selection.
+ * Label is required to force use case to override default js 'null' toString rendering.
+ */
+export interface SegmentedControlNullOption {
+    /** Null value for this option. */
+    value: null;
+    /** Display label - required for null options. */
+    label: string;
+    /** Icon element, displayed before the label. */
+    icon?: ReactElement;
+    /** True to disable this individual option. */
+    disabled?: boolean;
+    /**
+     * Visual intent for this option - rendered as a solid fill when selected and as a subtle
+     * text-color hint when not (e.g. to flag a destructive choice). Overrides any control-level
+     * `intent` default. Defaults to the control's `intent`.
+     */
+    intent?: Intent;
+}

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

@@ -1,2 +1,3 @@
 export * from './HoistInputModel';
 export * from './HoistInputProps';
+export * from './SegmentedControlOption';

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

@@ -1,5 +1,5 @@
 import { ElementFactory, HoistAppModel, HoistAuthModel, HoistProps } from '@xh/hoist/core';
-import { Component, ComponentClass, FunctionComponent } from 'react';
+import { Component, ComponentClass, FunctionComponent, ReactElement } from 'react';
 /**
  * Spec for a client-side Hoist application. A config matching this class's shape is provided
  * to {@link XHApi.renderApp} to kick-off app rendering and is available thereafter as `XH.appSpec`.
@@ -98,6 +98,11 @@ export declare class AppSpec<T extends HoistAppModel = HoistAppModel> {
     lockoutPanel?: ElementFactory | FunctionComponent | Component;
     /** Optional message to show users when denied access to app. */
     lockoutMessage?: string;
+    /**
+     * Icon to display on the form-based login page, if active via `enableLoginForm: true`.
+     * Defaults to `Icon.shieldHalved()`.
+     */
+    loginPanelIcon?: ReactElement;
     /** Optional message to show on login form, if `showLoginForm: true`. */
     loginMessage?: string;
     /**
@@ -116,7 +121,7 @@ export declare class AppSpec<T extends HoistAppModel = HoistAppModel> {
      *  initialized, including a breakdown of elapsed time throughout the init process.
      */
     trackAppLoad?: boolean;
-    constructor({ authModelClass, checkAccess, clientAppCode, clientAppName, componentClass, containerClass, disableWebSockets, enableXssProtection, enableLoginForm, enableLogout, idlePanel, isMobileApp, lockoutMessage, lockoutPanel, loginMessage, modelClass, showBrowserContextMenu, trackAppLoad }: {
+    constructor({ authModelClass, checkAccess, clientAppCode, clientAppName, componentClass, containerClass, disableWebSockets, enableXssProtection, enableLoginForm, enableLogout, idlePanel, isMobileApp, lockoutMessage, lockoutPanel, loginMessage, loginPanelIcon, modelClass, showBrowserContextMenu, trackAppLoad }: {
         authModelClass?: typeof HoistAuthModel;
         checkAccess: any;
         clientAppCode?: string;
@@ -132,6 +137,7 @@ export declare class AppSpec<T extends HoistAppModel = HoistAppModel> {
         lockoutMessage?: any;
         lockoutPanel?: any;
         loginMessage?: any;
+        loginPanelIcon?: any;
         modelClass: any;
         showBrowserContextMenu?: boolean;
         trackAppLoad?: boolean;

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

@@ -43,21 +43,24 @@ export declare class HoistAuthModel extends HoistModel {
      * Process a manual login, submitted by user via form.
      * @returns identity of the user authenticated with the server; null if not yet authenticated.
      */
-    loginWithCredentialsAsync(username: string, password: string): Promise<IdentityInfo>;
+    loginWithCredentialsAsync(username: string, password: string, ctx?: CallContextLike): Promise<IdentityInfo>;
     /**
      * Logout this user with the backend server.
      *
      * The default implementation will call the 'logout' endpoint on the Grails server, clearing
      * any server-side session state there. Override to manage any client-side or third-party state.
      */
-    logoutAsync(): Promise<void>;
+    logoutAsync(ctx?: CallContextLike): Promise<void>;
     /**
      * Load auth-related config from the server via an /xh/ endpoint that is specifically
      * whitelisted by Hoist to allow access prior to user authentication. For use in bootstrapping
      * client-side auth solutions that require configs such as OAuth endpoint URLs and client IDs.
      * See `BaseAuthenticationService.getClientConfig()` in hoist-core.
+     *
+     * @param ctx - tracing/load context. When called from within a `completeAuthAsync` override,
+     *      forward the supplied context so this fetch nests under the bootstrap trace.
      */
-    loadConfigAsync(): Promise<PlainObject>;
+    loadConfigAsync(ctx?: CallContextLike): Promise<PlainObject>;
     /**
      * Create a client-side HoistUser.
      *

package/build/types/data/filter/BaseFilterFieldSpec.d.ts

@@ -13,7 +13,12 @@ import { FieldFilterOperator } from './Types';
 export interface BaseFilterFieldSpecConfig {
     /** Identifying field name to filter on. */
     field: string;
-    /** Type of field, will default from related field on source if provided, or 'auto'. */
+    /**
+     * Type of field, will default from related field on source if provided, or 'auto'. A `date`
+     * (timestamp) source defaults to 'localDate' so filtering compares by calendar day (range and
+     * equality operators use full-day bounds). Set explicitly to 'date' to filter by exact
+     * timestamp instead.
+     */
     fieldType?: FieldType;
     /** DisplayName, will default from related field on source if provided */
     displayName?: string;
@@ -78,5 +83,6 @@ export declare abstract class BaseFilterFieldSpec extends HoistBase {
     abstract loadValuesFromSource(): any;
     private parseOperators;
     private getDefaultOperators;
+    private get isLocalDateFilteringTimestamp();
     private get isEnumerableByDefault();
 }

package/build/types/data/filter/FieldFilter.d.ts

@@ -26,6 +26,8 @@ export declare class FieldFilter extends Filter {
      */
     constructor({ field, op, value, valueType }: FieldFilterSpec);
     getTestFn(store?: Store): FilterTestFn;
+    private getOpFn;
+    private getDayBoundedOpFn;
     equals(other: Filter): boolean;
     toJSON(): FieldFilterSpec;
     removeFieldFilters(field?: string): Filter;

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/filechooser/FileChooserModel.d.ts

@@ -65,7 +65,7 @@ export declare class FileChooserModel extends HoistModel {
     private readonly onFileRejected;
     private readonly rejectToastMessage;
     private readonly rejectToastSpec;
-    constructor(config: FileChooserConfig);
+    constructor(config?: FileChooserConfig);
     /** Open the file browser programmatically. Typically used in a button's onClick callback.*/
     openFileBrowser(): void;
     /**

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/SegmentedControl.d.ts

@@ -1,10 +1,7 @@
-import { HoistInputProps } from '@xh/hoist/cmp/input';
+import { HoistInputProps, OptionPrimitive, SegmentedControlNullOption, SegmentedControlOption } from '@xh/hoist/cmp/input';
 import { HoistProps, Intent } from '@xh/hoist/core';
 import '@xh/hoist/desktop/register';
-import { LocalDate } from '@xh/hoist/utils/datetime';
-import { ReactElement } from 'react';
 import './SegmentedControl.scss';
-type OptionPrimitive = string | number | boolean | LocalDate;
 export interface SegmentedControlProps extends HoistProps, HoistInputProps {
     /** True to render in a compact mode with reduced sizing for space-constrained contexts. */
     compact?: boolean;
@@ -31,42 +28,6 @@ export interface SegmentedControlProps extends HoistProps, HoistInputProps {
      */
     outlined?: boolean;
 }
-export interface SegmentedControlOption {
-    /** Value for this option. */
-    value: OptionPrimitive;
-    /** Display label. Defaults to `value.toString()` if omitted. */
-    label?: string;
-    /** Icon element, displayed before the label. */
-    icon?: ReactElement;
-    /** True to disable this individual option. */
-    disabled?: boolean;
-    /**
-     * Visual intent for this option - rendered as a solid fill when selected and as a subtle
-     * text-color hint when not (e.g. to flag a destructive choice). Overrides any control-level
-     * `intent` default. Defaults to the control's `intent`.
-     */
-    intent?: Intent;
-}
-/**
- * Variant of SegmentedControlOption for representing a null/"no value" selection.
- * Label is required to force use case to override default js 'null' toString rendering.
- */
-export interface SegmentedControlNullOption {
-    /** Null value for this option. */
-    value: null;
-    /** Display label - required for null options. */
-    label: string;
-    /** Icon element, displayed before the label. */
-    icon?: ReactElement;
-    /** True to disable this individual option. */
-    disabled?: boolean;
-    /**
-     * Visual intent for this option - rendered as a solid fill when selected and as a subtle
-     * text-color hint when not (e.g. to flag a destructive choice). Overrides any control-level
-     * `intent` default. Defaults to the control's `intent`.
-     */
-    intent?: Intent;
-}
 /**
  * An input for selecting a single value from a small set of mutually exclusive options,
  * rendered as a group of toggle buttons with clear visual indication of the active
@@ -79,4 +40,3 @@ export interface SegmentedControlNullOption {
  * Built on Blueprint's SegmentedControl component.
  */
 export declare const SegmentedControl: import("react").FC<SegmentedControlProps>, segmentedControl: import("@xh/hoist/core").ElementFactory<SegmentedControlProps>;
-export {};

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;
@@ -232,6 +233,7 @@ export declare const Icon: {
     settings(p?: IconProps): any;
     shield(p?: IconProps): any;
     shieldCheck(p?: IconProps): any;
+    shieldHalved(p?: IconProps): any;
     sigma(p?: IconProps): any;
     skull(p?: IconProps): any;
     slashedCircle(p?: IconProps): any;
@@ -332,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/appOption/SizingModeAppOption.d.ts

@@ -1,5 +1,5 @@
 import { AppOptionSpec, SizingMode } from '@xh/hoist/core';
-import { ButtonGroupInputProps } from '@xh/hoist/mobile/cmp/input';
+import { SegmentedControlProps } from '@xh/hoist/mobile/cmp/input';
 import { FormFieldProps } from '../form/FormField';
 import '@xh/hoist/mobile/register';
 interface SizingModeAppOptionSpec {
@@ -7,8 +7,8 @@ interface SizingModeAppOptionSpec {
     modes?: SizingMode[];
     /** Props for nested FormField. */
     formFieldProps?: Partial<FormFieldProps>;
-    /** Props for nested ButtonGroupInput. */
-    inputProps?: Partial<ButtonGroupInputProps>;
+    /** Props for nested SegmentedControl. */
+    inputProps?: Partial<SegmentedControlProps>;
 }
 /**
  * Convenience configuration for the `sizingMode` AppOption.

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

@@ -1,12 +1,12 @@
 import { AppOptionSpec } from '@xh/hoist/core';
 import { FormFieldProps } from '@xh/hoist/mobile/cmp/form';
-import { ButtonGroupInputProps } from '@xh/hoist/mobile/cmp/input';
+import { SegmentedControlProps } from '@xh/hoist/mobile/cmp/input';
 import '@xh/hoist/mobile/register';
 interface ThemeAppOptionSpec {
     /** Props for nested FormField */
     formFieldProps?: Partial<FormFieldProps>;
-    /** Props for nested ButtonGroupInput */
-    inputProps?: Partial<ButtonGroupInputProps>;
+    /** Props for nested SegmentedControl */
+    inputProps?: Partial<SegmentedControlProps>;
 }
 /**
  * Convenience configuration for the `theme` AppOption.

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/build/types/mobile/cmp/input/SegmentedControl.d.ts

@@ -0,0 +1,47 @@
+import { HoistInputProps, OptionPrimitive, SegmentedControlNullOption, SegmentedControlOption } from '@xh/hoist/cmp/input';
+import { HoistProps, Intent } from '@xh/hoist/core';
+import '@xh/hoist/mobile/register';
+import './SegmentedControl.scss';
+export interface SegmentedControlProps extends HoistProps, HoistInputProps {
+    /**
+     * True (default) to render all segments at an equal width when {@link fill} is enabled,
+     * dividing the available width into equal parts regardless of label length - the conventional
+     * segmented-control appearance. Set false to instead size each segment to its content and
+     * share only the leftover space, so a longer label yields a wider segment. No effect when
+     * `fill` is false. Either way, a label too wide for its segment truncates with an ellipsis.
+     */
+    equalSegmentWidths?: boolean;
+    /**
+     * True (default) to stretch the control to fill available width,
+     * distributing space equally among options.
+     */
+    fill?: boolean;
+    /**
+     * Default visual intent applied to the selected option, and as a subtle text-color hint
+     * to options when not selected. Serves as the default for any option that does not specify
+     * its own `intent`. Defaults to `'none'`.
+     */
+    intent?: 'none' | Intent;
+    /**
+     * Array of available options. Each entry may be a SegmentedControlOption object
+     * with value/label/icon/disabled properties, or a primitive value used as both
+     * the value and the display label.
+     */
+    options: Array<SegmentedControlOption | SegmentedControlNullOption | OptionPrimitive>;
+    /**
+     * True to render with an outlined style - a border around the control tray
+     * with no inner background fill. Border color follows the current intent.
+     */
+    outlined?: boolean;
+}
+/**
+ * An input for selecting a single value from a small set of mutually exclusive options,
+ * rendered as a group of toggle buttons with clear visual indication of the active
+ * selection.
+ *
+ * Similar to ButtonGroupInput but driven by an `options` prop (like Select) rather than Button
+ * children, and with stronger visual differentiation between selected and unselected states.
+ * The mobile counterpart to the desktop SegmentedControl, built on Hoist's mobile Button
+ * (no Blueprint dependency).
+ */
+export declare const SegmentedControl: import("react").FC<SegmentedControlProps>, segmentedControl: import("@xh/hoist/core").ElementFactory<SegmentedControlProps>;

package/build/types/mobile/cmp/input/SwitchInput.d.ts

@@ -3,7 +3,7 @@ import { HoistProps, StyleProps } from '@xh/hoist/core';
 import '@xh/hoist/mobile/register';
 import './SwitchInput.scss';
 export interface SwitchInputProps extends HoistProps, HoistInputProps, StyleProps {
-    value?: string;
+    value?: boolean;
     /** Onsen modifier string */
     modifier?: string;
 }

package/build/types/mobile/cmp/input/TextInput.d.ts

@@ -2,6 +2,7 @@ import { HoistInputProps } from '@xh/hoist/cmp/input';
 import { HoistProps, LayoutProps, StyleProps } from '@xh/hoist/core';
 import '@xh/hoist/mobile/register';
 import type { Property } from 'csstype';
+import { ReactElement } from 'react';
 import './TextInput.scss';
 export interface TextInputProps extends HoistProps, HoistInputProps, StyleProps, LayoutProps {
     value?: string;
@@ -27,6 +28,8 @@ export interface TextInputProps extends HoistProps, HoistInputProps, StyleProps,
     commitOnChange?: boolean;
     /** True to show a "clear" button aligned to the right of the control. Defaults to false. */
     enableClear?: boolean;
+    /** Icon to display inline on the left side of the input. */
+    leftIcon?: ReactElement;
     /** Onsen modifier string */
     modifier?: string;
     /** Text to display when control is empty */

package/build/types/mobile/cmp/input/index.d.ts

@@ -5,6 +5,7 @@ export * from './CheckboxButton';
 export * from './DateInput';
 export * from './NumberInput';
 export * from './SearchInput';
+export * from './SegmentedControl';
 export * from './Select';
 export * from './SwitchInput';
 export * from './TextInput';

package/build/types/svc/JsonBlobService.d.ts

@@ -41,21 +41,21 @@ export declare class JsonBlobService extends HoistService {
     telemetryPrefix: string;
     static instance: JsonBlobService;
     /** Retrieve a single JSONBlob by its unique token. */
-    getAsync(token: string): Promise<JsonBlob>;
+    getAsync(token: string, ctx?: CallContextLike): Promise<JsonBlob>;
     /** Retrieve all blobs of a particular type that are visible to the current user. */
     listAsync(spec: {
         type: string;
         includeValue?: boolean;
-        ctx: CallContextLike;
+        ctx?: CallContextLike;
     }): Promise<JsonBlob[]>;
     /** Persist a new JSONBlob back to the server. */
-    createAsync({ acl, description, type, meta, name, value }: Partial<JsonBlob>): Promise<JsonBlob>;
+    createAsync({ acl, description, type, meta, name, value }: Partial<JsonBlob>, ctx?: CallContextLike): Promise<JsonBlob>;
     /** Modify mutable properties of an existing JSONBlob, as identified by its unique token. */
-    updateAsync(token: string, update: Partial<JsonBlob>): Promise<JsonBlob>;
+    updateAsync(token: string, update: Partial<JsonBlob>, ctx?: CallContextLike): Promise<JsonBlob>;
     /** Create or update a blob for a user with the existing type and name. */
-    createOrUpdateAsync(type: string, name: string, data: Partial<JsonBlob>): Promise<JsonBlob>;
+    createOrUpdateAsync(type: string, name: string, data: Partial<JsonBlob>, ctx?: CallContextLike): Promise<JsonBlob>;
     /** Find a blob owned by this user with a specific type and name.  If none exists, return null.  */
-    findAsync(type: string, name: string): Promise<JsonBlob>;
+    findAsync(type: string, name: string, ctx?: CallContextLike): Promise<JsonBlob>;
     /** Archive (soft-delete) an existing JSONBlob, as identified by its unique token. */
-    archiveAsync(token: string): Promise<JsonBlob>;
+    archiveAsync(token: string, ctx?: CallContextLike): Promise<JsonBlob>;
 }

package/cmp/error/ErrorMessage.scss

@@ -36,5 +36,7 @@
 }
 
 .xh-mobile .xh-error-message__inner {
+  flex: 1;
+  max-width: none;
   margin: 0 var(--xh-pad-px);
 }

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) {

package/cmp/grid/GridModel.ts

@@ -305,6 +305,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[]>;
 
@@ -1174,15 +1178,23 @@ export class GridModel extends HoistModel {
 
     /**
      * 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[] {
         const {maxDepth, levelLabels} = this,
             ret = executeIfFunction(levelLabels);
-        if (ret && ret.length < maxDepth + 1) {
-            this.logDebug('Value produced by `GridModel.levelLabels` has insufficient length.');
-            return null;
-        }
-        return ret ? take(ret, maxDepth + 1) : null;
+        return !isEmpty(ret) ? take(ret, maxDepth + 1) : null;
+    }
+
+    /**
+     * 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 {
+        const {expandLevel, resolvedLevelLabels} = this,
+            lastIdx = resolvedLevelLabels?.length - 1;
+        return expandLevel === idx || (idx === lastIdx && expandLevel > lastIdx);
     }
 
     /**