@xh/hoist 79.0.0-SNAPSHOT.1766244066570 → 79.0.0-SNAPSHOT.1766260837143

package/CHANGELOG.md

@@ -24,6 +24,9 @@
   Some apps may need to update their imports.
 * `TabContainerConfig.switcher` has been repurposed to accept a `TabSwitcherConfig`. To pass
   `TabSwitcherProps` via a parent `TabContainer`, use `TabContainerProps.switcher`.
+* Tightened the typing of `LocalDate` adjustment methods with new `LocalDateUnit` type. Some less
+  common or ambiguous units (e.g. `date` or `d`) are no longer supported. Also typed the adjustment
+  `value` args to `number` where applicable.
 
 ### 🐞 Bug Fixes
 
@@ -50,7 +53,7 @@
 
 ### 🐞 Bug Fixes
 
-* Fix to Highchart timezone handling regression from version 77.  Applications should note that
+* Fix to Highchart timezone handling regression from version 77. Applications should note that
   Highcharts has deprecated the `time.useUTC` option and its functioning seem suspect. Apps
   should set `time.timezone` instead. See https://api.highcharts.com/highcharts/time.useUTC.
 
@@ -61,14 +64,15 @@
 ## 78.1.0 - 2025-12-02
 
 ### ⚙️ Technical
+
 * New property `MsalClientConfig.enableSsoSilent` to govern use of MSAL SSO api.
 
 * Existing property `MsalClientConfig.enableTelemetry` now defaults to `true`.
 
-* Improved use of MSAL client API, to maximize effectiveness of SSO.  Improved documentation
- and logging.  Iframe attempts will now time out by default after 3 seconds vs. 10 seconds.
- This can be further modified by apps via the option
- `MsalClientConfig.msalClientOptions.system.iFrameHashTimeout`
+* Improved use of MSAL client API, to maximize effectiveness of SSO. Improved documentation
+  and logging. Iframe attempts will now time out by default after 3 seconds vs. 10 seconds.
+  This can be further modified by apps via the option
+  `MsalClientConfig.msalClientOptions.system.iFrameHashTimeout`
 
 ### 📚 Libraries
 
@@ -110,7 +114,8 @@
 
 ### 💥 Breaking Changes (upgrade difficulty: 🟢 LOW)
 
-* Apps that use and provide the `highcharts` library should be sure to update the version to v12.4.0.
+* Apps that use and provide the `highcharts` library should be sure to update the version to
+  v12.4.0.
   Refer to `Bootstrap.js` in Toolbox for required import changes.
     * Visit https://www.highcharts.com/blog/changelog/ for specific changes.
 

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

@@ -42,6 +42,8 @@ export type DebounceSpec = number | (DebounceSettings & {
  */
 export type Content = ReactElement | FunctionComponent | Component | ElementFactory | (() => ReactElement);
 export type DateLike = Date | LocalDate | MomentInput;
+/** Valid units for the {@link LocalDate} adjustment methods. */
+export type LocalDateUnit = 'year' | 'years' | 'quarter' | 'quarters' | 'month' | 'months' | 'week' | 'weeks' | 'day' | 'days';
 export type PageState = 
 /**
  * Window/tab is visible and focused.

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

@@ -1,4 +1,4 @@
-import { LoadSupport, LoadSpec, Loadable, PlainObject, TaskObserver } from '@xh/hoist/core';
+import { Loadable, LoadSpec, LoadSupport, PlainObject, TaskObserver } from '@xh/hoist/core';
 import { Store, StoreConfig } from './Store';
 export interface UrlStoreConfig extends StoreConfig {
     /** URL from which to load data. */

package/build/types/utils/datetime/LocalDate.d.ts

@@ -1,4 +1,5 @@
-import moment, { Moment, MomentInput } from 'moment';
+import { LocalDateUnit } from '@xh/hoist/core';
+import { Moment, MomentInput } from 'moment';
 /**
  * A Date representation that does not contain time information. Useful for business day or calendar
  * day data where time and time zone should be explicitly ignored.  Client-side equivalent of the
@@ -8,15 +9,13 @@ import moment, { Moment, MomentInput } from 'moment';
  * For efficiency and to enable strict equality checks, instances of this class are memoized:
  * only a single version of the object will be created and returned for each calendar day,
  * as long as the caller uses one of the *public factory methods*, which they always should!
- *
- * Unit accepted by manipulation methods are ['year', 'quarter', 'month', 'week', 'day', 'date'].
  */
 export declare class LocalDate {
+    static readonly VALID_UNITS: Set<LocalDateUnit>;
     private static _instances;
-    static VALID_UNITS: string[];
-    private _isoString;
-    private _moment;
-    private _date;
+    private readonly _isoString;
+    private readonly _moment;
+    private readonly _date;
     /**
      * Get an instance of this class.
      * This is the standard way to get an instance of this object from serialized server-side data.
@@ -64,11 +63,11 @@ export declare class LocalDate {
     toJSON(): string;
     valueOf(): string;
     get isLocalDate(): boolean;
-    add(value: any, unit?: string): LocalDate;
-    subtract(value: any, unit?: string): LocalDate;
-    addWeekdays(value: any): LocalDate;
-    subtractWeekdays(value: any): LocalDate;
-    startOf(unit: any): LocalDate;
+    add(value: number, unit?: LocalDateUnit): LocalDate;
+    subtract(value: number, unit?: LocalDateUnit): LocalDate;
+    addWeekdays(value: number): LocalDate;
+    subtractWeekdays(value: number): LocalDate;
+    startOf(unit: LocalDateUnit): LocalDate;
     startOfMonth(): LocalDate;
     startOfQuarter(): LocalDate;
     startOfYear(): LocalDate;
@@ -84,13 +83,10 @@ export declare class LocalDate {
     currentOrNextWeekday(): LocalDate;
     /** The same date if already a weekday, or the previous weekday. */
     currentOrPreviousWeekday(): LocalDate;
-    diff(other: LocalDate, unit?: moment.unitOfTime.Diff): number;
+    diff(other: LocalDate, unit?: LocalDateUnit): number;
     /** @internal - use one of the static factory methods instead. */
     private constructor();
     private ensureUnitValid;
 }
-/**
- * Is the input value a local Date?
- * Convenience alias for LocalDate.isLocalDate()
- */
+/** @returns true if the input value is a `LocalDate` instance. */
 export declare function isLocalDate(val: any): val is LocalDate;

package/cmp/ag-grid/AgGrid.ts

@@ -26,10 +26,7 @@ import './AgGrid.scss';
 import {AgGridModel} from './AgGridModel';
 
 export interface AgGridProps
-    extends HoistProps<AgGridModel>,
-        GridOptions,
-        LayoutProps,
-        TestSupportProps {}
+    extends HoistProps<AgGridModel>, GridOptions, LayoutProps, TestSupportProps {}
 
 /**
  * Minimal wrapper for AgGridReact, supporting direct use of the ag-Grid component with limited

package/cmp/grid/impl/ColumnGroupHeader.ts

@@ -16,8 +16,7 @@ import {ReactNode} from 'react';
 import type {AgProvidedColumnGroup, IHeaderGroupParams} from '@xh/hoist/kit/ag-grid';
 
 export interface ColumnGroupHeaderProps
-    extends HoistProps<ColumnGroupHeaderModel>,
-        IHeaderGroupParams {
+    extends HoistProps<ColumnGroupHeaderModel>, IHeaderGroupParams {
     gridModel: GridModel;
     xhColumnGroup: ColumnGroup;
 }

package/core/HoistProps.ts

@@ -67,7 +67,8 @@ export interface DefaultHoistProps<M extends HoistModel = HoistModel> extends Ho
  * which also supports this interface.  Eventually, they should be passed to a Box class.
  */
 export interface BoxProps
-    extends LayoutProps,
+    extends
+        LayoutProps,
         TestSupportProps,
         Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'contextMenu'> {}
 

package/core/model/HoistModel.ts

@@ -7,7 +7,14 @@
 import {action, computed, comparer, makeObservable, observable} from '@xh/hoist/mobx';
 import {apiDeprecated, warnIf} from '@xh/hoist/utils/js';
 import {isFunction} from 'lodash';
-import {DefaultHoistProps, HoistBase, LoadSpecConfig, managed, PlainObject, TaskObserver} from '../';
+import {
+    DefaultHoistProps,
+    HoistBase,
+    LoadSpecConfig,
+    managed,
+    PlainObject,
+    TaskObserver
+} from '../';
 import {instanceManager} from '../impl/InstanceManager';
 import {Loadable, LoadSpec, LoadSupport} from '../load';
 import {ModelSelector} from './';

package/core/types/Types.ts

@@ -63,6 +63,19 @@ export type Content =
 
 export type DateLike = Date | LocalDate | MomentInput;
 
+/** Valid units for the {@link LocalDate} adjustment methods. */
+export type LocalDateUnit =
+    | 'year'
+    | 'years'
+    | 'quarter'
+    | 'quarters'
+    | 'month'
+    | 'months'
+    | 'week'
+    | 'weeks'
+    | 'day'
+    | 'days';
+
 export type PageState =
     /**
      * Window/tab is visible and focused.

package/data/UrlStore.ts

@@ -5,7 +5,15 @@
  * Copyright © 2025 Extremely Heavy Industries Inc.
  */
 
-import {XH, managed, LoadSupport, LoadSpec, Loadable, PlainObject, TaskObserver} from '@xh/hoist/core';
+import {
+    Loadable,
+    LoadSpec,
+    LoadSupport,
+    managed,
+    PlainObject,
+    TaskObserver,
+    XH
+} from '@xh/hoist/core';
 import {apiDeprecated} from '@xh/hoist/utils/js';
 
 import {Store, StoreConfig} from './Store';

package/desktop/cmp/button/Button.ts

@@ -23,11 +23,7 @@ import {ReactElement, ReactNode} from 'react';
 import './Button.scss';
 
 export interface ButtonProps<M extends HoistModel = null>
-    extends HoistProps<M>,
-        StyleProps,
-        LayoutProps,
-        TestSupportProps,
-        Omit<BpButtonProps, 'ref'> {
+    extends HoistProps<M>, StyleProps, LayoutProps, TestSupportProps, Omit<BpButtonProps, 'ref'> {
     active?: boolean;
     autoFocus?: boolean;
     disabled?: boolean;

package/desktop/cmp/button/ButtonGroup.ts

@@ -20,7 +20,8 @@ import {splitLayoutProps} from '@xh/hoist/utils/react';
 import {SetOptional} from 'type-fest';
 
 export interface ButtonGroupProps<M extends HoistModel = null>
-    extends HoistProps<M>,
+    extends
+        HoistProps<M>,
         LayoutProps,
         StyleProps,
         TestSupportProps,

package/desktop/cmp/dash/container/DashContainerModel.ts

@@ -49,8 +49,10 @@ import {
 } from './impl/DashContainerUtils';
 import {dashContainerView} from './impl/DashContainerView';
 
-export interface DashContainerConfig
-    extends DashConfig<DashContainerViewSpec, DashContainerViewState> {
+export interface DashContainerConfig extends DashConfig<
+    DashContainerViewSpec,
+    DashContainerViewState
+> {
     /** Strategy for rendering DashContainerViews. Can also be set per-view in `viewSpecs`*/
     renderMode?: RenderMode;
 

package/desktop/cmp/input/ButtonGroupInput.ts

@@ -14,8 +14,7 @@ import {castArray, filter, isEmpty, without} from 'lodash';
 import {Children, cloneElement, isValidElement} from 'react';
 
 export interface ButtonGroupInputProps
-    extends Omit<ButtonGroupProps<HoistModel>, 'onChange'>,
-        HoistInputProps {
+    extends Omit<ButtonGroupProps<HoistModel>, 'onChange'>, HoistInputProps {
     /**
      * True to allow buttons to be unselected (aka inactivated). Defaults to false.
      * Does not apply when enableMulti: true.

package/desktop/cmp/rest/RestGrid.ts

@@ -21,8 +21,7 @@ import {restGridToolbar} from './impl/RestGridToolbar';
 import {RestGridModel} from './RestGridModel';
 
 export interface RestGridProps
-    extends HoistProps<RestGridModel>,
-        Omit<PanelProps, 'model' | 'modelConfig' | 'modelRef'> {
+    extends HoistProps<RestGridModel>, Omit<PanelProps, 'model' | 'modelConfig' | 'modelRef'> {
     /**
      * This constitutes an 'escape hatch' for applications that need to get to the underlying
      * AG Grid API. Use with care - settings made here might be overwritten and/or interfere with