@xh/hoist 76.0.0-SNAPSHOT.1758217044052 → 76.0.0-SNAPSHOT.1758310971360

package/CHANGELOG.md

@@ -3,10 +3,12 @@
 ## 76.0.0-SNAPSHOT - unreleased
 
 ### 💥 Breaking Changes (upgrade difficulty: 🟢 LOW - upgrade to Hoist Core, change to Tab constructor)
-* The constructor for `TabModel` has changed to take its owning container as a second argument.
+*  The constructor for `TabModel` has changed to take its owning container as a second argument.
    (Most applications do not create `TabModels` directly, but it is possible.)
-* `checkVersion` and related methods' import path has changed. Update imports from
-  `@xh/hoist/utils/js/VersionUtils` to `@xh/hoist/utils/version`;  (Unlikely to affect most apps.)
+*  The `Exception` class and `HoistException` type have been moved from `@xh\hoist\core` to a new
+    lower level package `@xh\hoist\exception`.  This new structure is not expected to effect most
+    applications, and was put in place to reduce the risk of circular dependencies between internal
+    hoist packages.
 
 ### 🎁 New Features
 

package/admin/tabs/userData/roles/graph/RoleGraph.ts

@@ -14,8 +14,7 @@ import {panel} from '@xh/hoist/desktop/cmp/panel';
 import {toolbar} from '@xh/hoist/desktop/cmp/toolbar';
 import {Icon} from '@xh/hoist/icon';
 import {Highcharts} from '@xh/hoist/kit/highcharts';
-import {pluralize} from '@xh/hoist/utils/js';
-import {logError} from '@xh/hoist/utils/log';
+import {logError, pluralize} from '@xh/hoist/utils/js';
 import {isEmpty} from 'lodash';
 import {RoleModel} from '../RoleModel';
 import {RoleGraphModel} from './RoleGraphModel';

package/appcontainer/AppContainerModel.ts

@@ -40,8 +40,7 @@ import {
     TrackService,
     WebSocketService
 } from '@xh/hoist/svc';
-import {checkMinVersion} from '@xh/hoist/utils/version';
-import {createSingleton, throwIf} from '@xh/hoist/utils/js';
+import {checkMinVersion, createSingleton, throwIf} from '@xh/hoist/utils/js';
 import {compact, isEmpty} from 'lodash';
 import {AboutDialogModel} from './AboutDialogModel';
 import {BannerSourceModel} from './BannerSourceModel';

package/appcontainer/ExceptionDialogModel.ts

@@ -4,7 +4,8 @@
  *
  * Copyright © 2025 Extremely Heavy Industries Inc.
  */
-import {ExceptionHandlerOptions, HoistException, HoistModel, XH} from '@xh/hoist/core';
+import type {HoistException} from '@xh/hoist/exception';
+import {ExceptionHandlerOptions, HoistModel, XH} from '@xh/hoist/core';
 import {action, observable, makeObservable, bindable} from '@xh/hoist/mobx';
 
 /**

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

@@ -1,4 +1,5 @@
-import { ExceptionHandlerOptions, HoistException, HoistModel } from '@xh/hoist/core';
+import type { HoistException } from '@xh/hoist/exception';
+import { ExceptionHandlerOptions, HoistModel } from '@xh/hoist/core';
 /**
  * Manages the default display of exceptions.
  *

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

@@ -55,7 +55,7 @@ export declare class GridLocalModel extends HoistModel {
     getColumnDefs(): Array<ColDef | ColGroupDef>;
     getContextMenuItems: (params: GetContextMenuItemsParams) => (string | import("@ag-grid-community/core").MenuItemDef<any, any>)[];
     dataReaction(): {
-        track: () => (boolean | import("@xh/hoist/core").VSide | import("../../data").StoreRecord[] | RecordSet)[];
+        track: () => (boolean | RecordSet | import("../../data").StoreRecord[] | import("@xh/hoist/core").VSide)[];
         run: () => void;
     };
     selectionReaction(): {
@@ -63,7 +63,7 @@ export declare class GridLocalModel extends HoistModel {
         run: () => void;
     };
     sortReaction(): {
-        track: () => (GridApi<any> | import("@xh/hoist/cmp/grid").GridSorter[])[];
+        track: () => (import("@xh/hoist/cmp/grid").GridSorter[] | GridApi<any>)[];
         run: ([agApi, sortBy]: [any, any]) => void;
     };
     groupReaction(): {
@@ -83,7 +83,7 @@ export declare class GridLocalModel extends HoistModel {
     get useScrollOptimization(): boolean;
     applyScrollOptimization(): void;
     columnsReaction(): {
-        track: () => (GridApi<any> | (import("@xh/hoist/cmp/grid").Column | import("@xh/hoist/cmp/grid").ColumnGroup)[])[];
+        track: () => ((import("@xh/hoist/cmp/grid").Column | import("@xh/hoist/cmp/grid").ColumnGroup)[] | GridApi<any>)[];
         run: ([api]: [any]) => void;
     };
     columnStateReaction(): ReactionSpec<[GridApi, ColumnState[]]>;

package/build/types/core/{exception/ExceptionHandler.d.ts → ExceptionHandler.d.ts}

@@ -1,4 +1,5 @@
-import { HoistException, PlainObject } from '../';
+import { HoistException } from '../exception';
+import { PlainObject } from './';
 export interface ExceptionHandlerOptions {
     /** Text (ideally user-friendly) describing the error. */
     message?: string;

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

@@ -2,7 +2,7 @@ import { RouterModel } from '@xh/hoist/appcontainer/RouterModel';
 import { HoistAuthModel } from '@xh/hoist/core/HoistAuthModel';
 import { Store } from '@xh/hoist/data';
 import { AlertBannerService, AutoRefreshService, ChangelogService, ConfigService, EnvironmentService, FetchOptions, FetchService, GridAutosizeService, GridExportService, IdentityService, IdleService, InspectorService, JsonBlobService, LocalStorageService, PrefService, SessionStorageService, TrackService, WebSocketService, ClientHealthService } from '@xh/hoist/svc';
-import type { LogLevel } from './types/Types';
+import { LogLevel } from '@xh/hoist/utils/js';
 import { Router, State } from 'router5';
 import { CancelFn } from 'router5/types/types/base';
 import { SetOptional } from 'type-fest';
@@ -10,7 +10,8 @@ import { AppContainerModel } from '../appcontainer/AppContainerModel';
 import { BannerModel } from '../appcontainer/BannerModel';
 import { ToastModel } from '../appcontainer/ToastModel';
 import '../styles/XH.scss';
-import { AppSpec, AppState, AppSuspendData, BannerSpec, ExceptionHandler, ExceptionHandlerOptions, HoistAppModel, HoistException, HoistService, HoistServiceClass, HoistUser, MessageSpec, PageState, PlainObject, ReloadAppOptions, SizingMode, TaskObserver, Theme, ToastSpec, TrackOptions } from './';
+import { HoistException } from '../exception';
+import { AppSpec, AppState, AppSuspendData, BannerSpec, ExceptionHandler, ExceptionHandlerOptions, HoistAppModel, HoistService, HoistServiceClass, HoistUser, MessageSpec, PageState, PlainObject, ReloadAppOptions, SizingMode, TaskObserver, Theme, ToastSpec, TrackOptions } from './';
 import { HoistModel, ModelSelector, RefreshContextModel } from './model';
 export declare const MIN_HOIST_CORE_VERSION = "31.2";
 /**

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

@@ -18,7 +18,5 @@ export * from './HoistComponent';
 export * from './RefreshContextView';
 export * from './HoistAppModel';
 export * from './HoistAuthModel';
-export * from './exception/ExceptionHandler';
-export * from './exception/Exception';
-export * from './exception/Types';
+export * from './ExceptionHandler';
 export { XH, XHApi } from './XH';

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

@@ -66,13 +66,3 @@ export type PageState =
  * The page is in the process of being unloaded by the browser (this is a terminal state x_x).
  */
  | 'terminated';
-/** Severity Level for log statement */
-export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
-/** Object identifying the source of log statement.  Typically, a javascript class */
-export type LogSource = string | {
-    displayName: string;
-} | {
-    constructor: {
-        name: string;
-    };
-};

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

@@ -72,14 +72,14 @@ export declare const autoRefreshAppOption: ({ formFieldProps, inputProps }?: Aut
         position?: import("csstype").Property.Position;
         display?: string;
         testId?: string;
-        onClick?: import("react").MouseEventHandler<HTMLDivElement>;
+        id?: string | undefined;
+        onError?: import("react").ReactEventHandler<HTMLDivElement>;
+        defaultValue?: string | number | readonly string[] | undefined;
         slot?: string | undefined;
         style?: import("react").CSSProperties | undefined;
         title?: string | undefined;
-        content?: string | undefined;
         hidden?: boolean | undefined;
         defaultChecked?: boolean | undefined;
-        defaultValue?: string | number | readonly string[] | undefined;
         suppressContentEditableWarning?: boolean | undefined;
         suppressHydrationWarning?: boolean | undefined;
         accessKey?: string | undefined;
@@ -89,7 +89,6 @@ export declare const autoRefreshAppOption: ({ formFieldProps, inputProps }?: Aut
         dir?: string | undefined;
         draggable?: (boolean | "true" | "false") | undefined;
         enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined;
-        id?: string | undefined;
         lang?: string | undefined;
         nonce?: string | undefined;
         spellCheck?: (boolean | "true" | "false") | undefined;
@@ -98,6 +97,7 @@ export declare const autoRefreshAppOption: ({ formFieldProps, inputProps }?: Aut
         radioGroup?: string | undefined;
         role?: import("react").AriaRole | undefined;
         about?: string | undefined;
+        content?: string | undefined;
         datatype?: string | undefined;
         inlist?: any;
         prefix?: string | undefined;
@@ -207,7 +207,6 @@ export declare const autoRefreshAppOption: ({ formFieldProps, inputProps }?: Aut
         onInvalidCapture?: import("react").FormEventHandler<HTMLDivElement>;
         onLoad?: import("react").ReactEventHandler<HTMLDivElement>;
         onLoadCapture?: import("react").ReactEventHandler<HTMLDivElement>;
-        onError?: import("react").ReactEventHandler<HTMLDivElement>;
         onErrorCapture?: import("react").ReactEventHandler<HTMLDivElement>;
         onKeyDown?: import("react").KeyboardEventHandler<HTMLDivElement>;
         onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLDivElement>;
@@ -261,6 +260,7 @@ export declare const autoRefreshAppOption: ({ formFieldProps, inputProps }?: Aut
         onWaitingCapture?: import("react").ReactEventHandler<HTMLDivElement>;
         onAuxClick?: import("react").MouseEventHandler<HTMLDivElement>;
         onAuxClickCapture?: import("react").MouseEventHandler<HTMLDivElement>;
+        onClick?: import("react").MouseEventHandler<HTMLDivElement>;
         onClickCapture?: import("react").MouseEventHandler<HTMLDivElement>;
         onContextMenu?: import("react").MouseEventHandler<HTMLDivElement>;
         onContextMenuCapture?: import("react").MouseEventHandler<HTMLDivElement>;

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

@@ -70,14 +70,14 @@ export declare const themeAppOption: ({ formFieldProps, inputProps }?: ThemeAppO
         position?: import("csstype").Property.Position;
         display?: string;
         testId?: string;
-        onClick?: import("react").MouseEventHandler<HTMLDivElement>;
+        id?: string | undefined;
+        onError?: import("react").ReactEventHandler<HTMLDivElement>;
+        defaultValue?: string | number | readonly string[] | undefined;
         slot?: string | undefined;
         style?: import("react").CSSProperties | undefined;
         title?: string | undefined;
-        content?: string | undefined;
         hidden?: boolean | undefined;
         defaultChecked?: boolean | undefined;
-        defaultValue?: string | number | readonly string[] | undefined;
         suppressContentEditableWarning?: boolean | undefined;
         suppressHydrationWarning?: boolean | undefined;
         accessKey?: string | undefined;
@@ -87,7 +87,6 @@ export declare const themeAppOption: ({ formFieldProps, inputProps }?: ThemeAppO
         dir?: string | undefined;
         draggable?: (boolean | "true" | "false") | undefined;
         enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined;
-        id?: string | undefined;
         lang?: string | undefined;
         nonce?: string | undefined;
         spellCheck?: (boolean | "true" | "false") | undefined;
@@ -96,6 +95,7 @@ export declare const themeAppOption: ({ formFieldProps, inputProps }?: ThemeAppO
         radioGroup?: string | undefined;
         role?: import("react").AriaRole | undefined;
         about?: string | undefined;
+        content?: string | undefined;
         datatype?: string | undefined;
         inlist?: any;
         prefix?: string | undefined;
@@ -205,7 +205,6 @@ export declare const themeAppOption: ({ formFieldProps, inputProps }?: ThemeAppO
         onInvalidCapture?: import("react").FormEventHandler<HTMLDivElement>;
         onLoad?: import("react").ReactEventHandler<HTMLDivElement>;
         onLoadCapture?: import("react").ReactEventHandler<HTMLDivElement>;
-        onError?: import("react").ReactEventHandler<HTMLDivElement>;
         onErrorCapture?: import("react").ReactEventHandler<HTMLDivElement>;
         onKeyDown?: import("react").KeyboardEventHandler<HTMLDivElement>;
         onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLDivElement>;
@@ -259,6 +258,7 @@ export declare const themeAppOption: ({ formFieldProps, inputProps }?: ThemeAppO
         onWaitingCapture?: import("react").ReactEventHandler<HTMLDivElement>;
         onAuxClick?: import("react").MouseEventHandler<HTMLDivElement>;
         onAuxClickCapture?: import("react").MouseEventHandler<HTMLDivElement>;
+        onClick?: import("react").MouseEventHandler<HTMLDivElement>;
         onClickCapture?: import("react").MouseEventHandler<HTMLDivElement>;
         onContextMenu?: import("react").MouseEventHandler<HTMLDivElement>;
         onContextMenuCapture?: import("react").MouseEventHandler<HTMLDivElement>;

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

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

package/build/types/exception/Exception.d.ts

@@ -0,0 +1,24 @@
+import type { HoistException, TimeoutException, TimeoutExceptionConfig } from './Types';
+/**
+ * Standardized Exception/Error objects.
+ *
+ * The main entry point for this class is the create() method.
+ * Applications can use this method to create various generic runtime exceptions.
+ * @see ExceptionHandler.handleException
+ */
+export declare class Exception {
+    /**
+     * Create and return a HoistException
+     *
+     * See {@link XH.exception} - an alias for this factory off of `XH`.
+     *
+     * @param src - If a native JS Error, it will be enhanced into a HoistException and returned.
+     *      If a plain object, all properties will be set on a new HoistException.
+     *      Other inputs will be treated as the `message` of a new HoistException.
+     */
+    static create(src: unknown): HoistException;
+    /** Create an Error for when an operation (e.g. a Promise) times out. */
+    static timeout(config: TimeoutExceptionConfig): TimeoutException;
+    private static createInternal;
+}
+export declare function isHoistException(src: unknown): src is HoistException;

package/build/types/{core/exception → exception}/Types.d.ts

@@ -1,5 +1,4 @@
-import { PlainObject } from '@xh/hoist/core';
-import { FetchOptions } from '@xh/hoist/svc';
+import type { PlainObject } from '@xh/hoist/core';
 /**
  * A Hoist optimized Javascript Error object.
  */
@@ -26,22 +25,6 @@ export interface TimeoutException extends HoistException {
     /** Time in Milliseconds that was waited before exception was thrown.  */
     interval: number;
 }
-/**
- * Exception thrown to indicate an HTTP error resulting from a call to FetchService.
- */
-export interface FetchException extends HoistException {
-    /** Http Status code associated with exception. 0 if no response received. */
-    httpStatus: number;
-    /** Rich object or string containing details about the exception as sent by server. */
-    serverDetails: string | PlainObject;
-    /** Options of underlying fetch call. */
-    fetchOptions: FetchOptions;
-    /**
-     * True if exception resulted from the fetch being aborted by fetchService, or the application.
-     * @see FetchService.abort and FetchOptions.autoAbortKey.
-     */
-    isFetchAborted: boolean;
-}
 /**
  * Configuration for generating a timeout exception.
  *

package/build/types/exception/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Types';
+export * from './Exception';

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

@@ -2,7 +2,7 @@ import { Swiper, SwiperSlide } from 'swiper/react';
 import { EffectCreative } from 'swiper/modules';
 import './styles.scss';
 export { Swiper, SwiperSlide, EffectCreative };
-export declare const swiper: import("@xh/hoist/core").ElementFactory<import("react").RefAttributes<import("swiper/react").SwiperRef> & Omit<import("react").HTMLAttributes<HTMLElement>, "onClick" | "onKeyPress" | "onProgress" | "onDoubleClick" | "onTouchEnd" | "onTouchMove" | "onTouchStart" | "onScroll" | "onTransitionEnd" | "onResize"> & import("swiper/types").SwiperOptions & {
+export declare const swiper: import("@xh/hoist/core").ElementFactory<import("react").RefAttributes<import("swiper/react").SwiperRef> & Omit<import("react").HTMLAttributes<HTMLElement>, "onKeyPress" | "onProgress" | "onClick" | "onDoubleClick" | "onTouchEnd" | "onTouchMove" | "onTouchStart" | "onScroll" | "onTransitionEnd" | "onResize"> & import("swiper/types").SwiperOptions & {
     tag?: string;
     wrapperTag?: string;
     onSwiper?: (swiper: import("swiper/react").SwiperClass) => void;

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

@@ -1,4 +1,5 @@
 import { Awaitable, HoistService, LoadSpec, PlainObject, TrackOptions } from '@xh/hoist/core';
+import { HoistException } from '@xh/hoist/exception';
 import { PromiseTimeoutSpec } from '@xh/hoist/promise';
 import { StatusCodes } from 'http-status-codes';
 import { IStringifyOptions } from 'qs';
@@ -124,6 +125,44 @@ export declare class FetchService extends HoistService {
     private parseJsonAsync;
     private safeResponseTextAsync;
     private qsFilterFn;
+    /**
+     * Create an Error to throw when a fetch call returns a !ok response.
+     * @param fetchOptions - original options passed to FetchService.
+     * @param response - return value of native fetch.
+     * @param responseText - optional additional details from the server.
+     */
+    private exceptionFromResponse;
+    /**
+     * Create an Error to throw when a fetchJson call encounters a SyntaxError.
+     * @param fetchOptions - original options passed to FetchService.
+     * @param cause - object thrown by native {@link response.json}.
+     */
+    private jsonParseException;
+    /**
+     * Create an Error to throw when a fetch call is aborted.
+     * @param fetchOptions - original options passed to FetchService.
+     * @param cause - object thrown by native fetch
+     */
+    private abortedException;
+    /**
+     * Create an Error to throw when a fetch call times out.
+     * @param fetchOptions - original options the app passed when calling FetchService.
+     * @param cause - underlying timeout exception
+     * @param message - optional custom message
+     *
+     * @returns an exception that is both a TimeoutException, and a FetchException, with the
+     *      underlying TimeoutException as its cause.
+     */
+    private timeoutException;
+    /**
+     * Create an Error for when the server called by fetch does not respond
+     * @param fetchOptions - original options the app passed to FetchService.fetch
+     * @param cause - object thrown by native fetch
+     */
+    private serverUnavailableException;
+    private createException;
+    private safeParseJson;
+    private extractMessage;
 }
 /** Headers to be applied to all requests.  Specified as object, or dynamic function to create. */
 export type DefaultHeaders = PlainObject | ((opts: FetchOptions) => Awaitable<PlainObject>);
@@ -198,3 +237,19 @@ export interface FetchOptions {
      */
     track?: string | TrackOptions;
 }
+/**
+ * Exception thrown to indicate an HTTP error resulting from a call to FetchService.
+ */
+export interface FetchException extends HoistException {
+    /** Http Status code associated with exception. 0 if no response received. */
+    httpStatus: number;
+    /** Rich object or string containing details about the exception as sent by server. */
+    serverDetails: string | PlainObject;
+    /** Options of underlying fetch call. */
+    fetchOptions: FetchOptions;
+    /**
+     * True if exception resulted from the fetch being aborted by fetchService, or the application.
+     * @see FetchService.abort and FetchOptions.autoAbortKey.
+     */
+    isFetchAborted: boolean;
+}

package/build/types/utils/js/LangUtils.d.ts

@@ -1,4 +1,4 @@
-import type { Thunkable, LogSource } from '@xh/hoist/core';
+import type { Thunkable } from '@xh/hoist/core';
 /**
  * Get a cached value on an object, creating it if it does not yet exist.
  *
@@ -36,14 +36,6 @@ export declare function isJSON(obj: any): boolean;
  * Throw an exception if a condition evaluates as truthy.
  */
 export declare function throwIf(condition: any, message: unknown): void;
-/**
- * Log a warning to the console if a condition evaluates as truthy.
- */
-export declare function warnIf(condition: any, message: any): void;
-/**
- * Log an error to the console if a condition evaluates as truthy.
- */
-export declare function errorIf(condition: any, message: any): void;
 /**
  * Instantiate a singleton object of a class, and place a reference to the created
  * object in a static property on the class.
@@ -54,24 +46,6 @@ export declare function errorIf(condition: any, message: any): void;
  * @param clazz -- Class (i.e. Constructor) of singleton object to be created.
  */
 export declare function createSingleton<T>(clazz: new () => T): T;
-export interface APIWarnOptions {
-    /**
-     * If provided and undefined, this method will be a no-op.
-     * Useful for testing if a parameter has been provided in caller.
-     */
-    test?: any;
-    /** Version when this API will no longer be supported or this warning should be removed. */
-    v?: string;
-    /** An additional message. Can contain suggestions for alternatives. */
-    msg?: string;
-    /** Source of message for labeling log message.  */
-    source?: LogSource;
-}
-/**
- * Document and prevent usage of a removed parameter.
- */
-export declare function apiRemoved(name: string, opts?: APIWarnOptions): void;
-export declare function apiDeprecated(name: string, opts?: APIWarnOptions): void;
 /**
  * Throw an exception if the provided object or collection is empty, as per lodash isEmpty().
  *

package/build/types/utils/{log → js}/LogUtils.d.ts

@@ -1,4 +1,4 @@
-import type { Some, LogLevel, LogSource } from '@xh/hoist/core';
+import type { Some } from '@xh/hoist/core';
 /**
  * Utility functions providing managed, structured logging to Hoist apps.
  *
@@ -12,6 +12,29 @@ import type { Some, LogLevel, LogSource } from '@xh/hoist/core';
  * memory impacts that might result from verbose debug logging.  This can be adjusted by calling
  * XH.logLevel from the console.
  */
+/** Severity Level for log statement */
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+/** Object identifying the source of log statement.  Typically, a javascript class */
+export type LogSource = string | {
+    displayName: string;
+} | {
+    constructor: {
+        name: string;
+    };
+};
+export interface APIWarnOptions {
+    /**
+     * If provided and undefined, this method will be a no-op.
+     * Useful for testing if a parameter has been provided in caller.
+     */
+    test?: any;
+    /** Version when this API will no longer be supported or this warning should be removed. */
+    v?: string;
+    /** An additional message. Can contain suggestions for alternatives. */
+    msg?: string;
+    /** Source of message for labelling log message.  */
+    source?: LogSource;
+}
 /**
  * Current minimum severity for Hoist log utils (default 'info').
  * Messages logged via managed Hoist log utils with lower severity will be ignored.
@@ -70,3 +93,16 @@ export declare function logError(msgs: Some<unknown>, source?: LogSource): unkno
  * @param source - class, function or string to label the source of the message
  */
 export declare function logWarn(msgs: Some<unknown>, source?: LogSource): unknown;
+/**
+ * Log a warning to the console if a condition evaluates as truthy.
+ */
+export declare function warnIf(condition: any, message: any): void;
+/**
+ * Log an error to the console if a condition evaluates as truthy.
+ */
+export declare function errorIf(condition: any, message: any): void;
+/**
+ * Document and prevent usage of a removed parameter.
+ */
+export declare function apiRemoved(name: string, opts?: APIWarnOptions): void;
+export declare function apiDeprecated(name: string, opts?: APIWarnOptions): void;

package/build/types/utils/js/index.d.ts

@@ -1,5 +1,7 @@
 export * from './HtmlUtils';
 export * from './LangUtils';
 export * from './Decorators';
+export * from './LogUtils';
 export * from './DomUtils';
 export * from './TestUtils';
+export * from './VersionUtils';

package/cmp/ag-grid/AgGrid.ts

@@ -18,7 +18,7 @@ import {
     XH
 } from '@xh/hoist/core';
 import {AgGridReact, GridOptions} from '@xh/hoist/kit/ag-grid';
-import {logError} from '@xh/hoist/utils/log';
+import {logError} from '@xh/hoist/utils/js';
 import {splitLayoutProps} from '@xh/hoist/utils/react';
 import classNames from 'classnames';
 import {isNil} from 'lodash';

package/cmp/chart/Chart.ts

@@ -21,8 +21,7 @@ import {
 import {useContextMenu} from '@xh/hoist/dynamics/desktop';
 import {Highcharts} from '@xh/hoist/kit/highcharts';
 import {runInAction} from '@xh/hoist/mobx';
-import {mergeDeep} from '@xh/hoist/utils/js';
-import {logError} from '@xh/hoist/utils/log';
+import {logError, mergeDeep} from '@xh/hoist/utils/js';
 import {
     createObservableRef,
     getLayoutProps,

package/cmp/chart/impl/ChartContextMenuItems.ts

@@ -5,7 +5,7 @@
  * Copyright © 2025 Extremely Heavy Industries Inc.
  */
 import type {ChartMenuContext, ChartMenuToken} from '@xh/hoist/cmp/chart/Types';
-import {logWarn} from '@xh/hoist/utils/log';
+import {logWarn} from '@xh/hoist/utils/js';
 import {cloneDeep, isEmpty, isString} from 'lodash';
 import {ChartModel} from '@xh/hoist/cmp/chart';
 import {isMenuItem, type MenuItem, type MenuItemLike} from '@xh/hoist/core';

package/cmp/grid/columns/Column.ts

@@ -15,8 +15,7 @@ import {
     RecordActionSpec,
     StoreRecord
 } from '@xh/hoist/data';
-import {logDebug, logWarn} from '@xh/hoist/utils/log';
-import {throwIf, warnIf, withDefault} from '@xh/hoist/utils/js';
+import {logDebug, logWarn, throwIf, warnIf, withDefault} from '@xh/hoist/utils/js';
 import classNames from 'classnames';
 import {
     castArray,

package/cmp/grid/helpers/GridCountLabel.ts

@@ -7,8 +7,7 @@
 import {box} from '@xh/hoist/cmp/layout';
 import {BoxProps, hoistCmp, HoistProps, useContextModel} from '@xh/hoist/core';
 import {fmtNumber} from '@xh/hoist/format';
-import {pluralize, singularize, withDefault} from '@xh/hoist/utils/js';
-import {logError} from '@xh/hoist/utils/log';
+import {logError, pluralize, singularize, withDefault} from '@xh/hoist/utils/js';
 import {GridModel} from '../GridModel';
 
 export interface GridCountLabelProps extends HoistProps, BoxProps {

package/cmp/grid/impl/ColumnWidthCalculator.ts

@@ -9,8 +9,7 @@ import {GridAutosizeOptions} from '@xh/hoist/cmp/grid/GridAutosizeOptions';
 import {XH} from '@xh/hoist/core';
 import {CompoundFilter, FieldFilter, Filter, StoreRecord} from '@xh/hoist/data';
 import {forEachAsync} from '@xh/hoist/utils/async';
-import {logWarn} from '@xh/hoist/utils/log';
-import {stripTags} from '@xh/hoist/utils/js';
+import {logWarn, stripTags} from '@xh/hoist/utils/js';
 import {
     forOwn,
     groupBy,

package/cmp/grid/impl/Utils.ts

@@ -6,7 +6,7 @@
  */
 import {Column, ColumnGroup, ColumnRenderer, GroupRowRenderer} from '@xh/hoist/cmp/grid';
 import {HeaderClassParams} from '@xh/hoist/kit/ag-grid';
-import {logWarn} from '@xh/hoist/utils/log';
+import {logWarn} from '@xh/hoist/utils/js';
 import {castArray, isFunction} from 'lodash';
 
 /** @internal */

package/cmp/relativetimestamp/RelativeTimestamp.ts

@@ -21,8 +21,7 @@ import {fmtCompactDate, fmtDateTime} from '@xh/hoist/format';
 import {action, computed, makeObservable, observable} from '@xh/hoist/mobx';
 import {Timer} from '@xh/hoist/utils/async';
 import {DAYS, HOURS, LocalDate, SECONDS} from '@xh/hoist/utils/datetime';
-import {logWarn} from '@xh/hoist/utils/log';
-import {apiDeprecated, withDefault} from '@xh/hoist/utils/js';
+import {apiDeprecated, logWarn, withDefault} from '@xh/hoist/utils/js';
 
 interface RelativeTimestampProps extends HoistProps, BoxProps, RelativeTimestampOptions {
     /**

package/cmp/treemap/TreeMap.ts

@@ -21,8 +21,7 @@ import {errorMessage} from '@xh/hoist/cmp/error';
 import {mask} from '@xh/hoist/cmp/mask';
 import {Highcharts} from '@xh/hoist/kit/highcharts';
 import {wait} from '@xh/hoist/promise';
-import {logWithDebug} from '@xh/hoist/utils/js';
-import {logError} from '@xh/hoist/utils/log';
+import {logError, logWithDebug} from '@xh/hoist/utils/js';
 import {
     createObservableRef,
     getLayoutProps,

package/core/{exception/ExceptionHandler.ts → ExceptionHandler.ts}

@@ -4,13 +4,12 @@
  *
  * Copyright © 2025 Extremely Heavy Industries Inc.
  */
-import {Exception} from './Exception';
+import {Exception, HoistException} from '../exception';
 import {fragment, span} from '@xh/hoist/cmp/layout';
-import {stripTags} from '@xh/hoist/utils/js';
-import {logDebug, logError, logWarn} from '@xh/hoist/utils/log';
+import {logDebug, logError, logWarn, stripTags} from '@xh/hoist/utils/js';
 import {Icon} from '@xh/hoist/icon';
 import {forOwn, has, isArray, isNil, isObject, omitBy, pick, set} from 'lodash';
-import {HoistException, PlainObject, XH} from '../';
+import {PlainObject, XH} from './';
 
 export interface ExceptionHandlerOptions {
     /** Text (ideally user-friendly) describing the error. */

package/core/HoistBase.ts

@@ -13,8 +13,16 @@ import {
     runInAction,
     when as mobxWhen
 } from '@xh/hoist/mobx';
-import {getOrCreate, throwIf} from '@xh/hoist/utils/js';
-import {logDebug, logError, logInfo, logWarn, withDebug, withInfo} from '@xh/hoist/utils/log';
+import {
+    getOrCreate,
+    logDebug,
+    logError,
+    logInfo,
+    logWarn,
+    throwIf,
+    withDebug,
+    withInfo
+} from '@xh/hoist/utils/js';
 import {
     debounce as lodashDebounce,
     isFunction,