@xh/hoist 59.3.2 → 59.5.0

package/mobile/cmp/button/ColAutosizeButton.ts

@@ -10,7 +10,7 @@ import {hoistCmp, useContextModel} from '@xh/hoist/core';
 import {Icon} from '@xh/hoist/icon';
 import {button, ButtonProps} from '@xh/hoist/mobile/cmp/button';
 import '@xh/hoist/mobile/register';
-import {withDefault} from '@xh/hoist/utils/js';
+import {logError, withDefault} from '@xh/hoist/utils/js';
 
 export interface ColAutosizeButtonProps extends ButtonProps {
     /** GridModel of the grid for which this button should autosize columns. */
@@ -31,8 +31,9 @@ export const [ColAutosizeButton, colAutosizeButton] = hoistCmp.withFactory<ColAu
         gridModel = withDefault(gridModel, useContextModel(GridModel));
 
         if (!gridModel?.autosizeEnabled) {
-            console.error(
-                "No GridModel available with autosize enabled. Provide via a 'gridModel' prop, or context."
+            logError(
+                "No GridModel available with autosize enabled. Provide via a 'gridModel' prop, or context.",
+                ColAutosizeButton
             );
             return button({icon, disabled: true, ...props});
         }

package/mobile/cmp/button/ColChooserButton.ts

@@ -9,7 +9,7 @@ import {hoistCmp, useContextModel} from '@xh/hoist/core';
 import {Icon} from '@xh/hoist/icon';
 import {button, ButtonProps} from '@xh/hoist/mobile/cmp/button';
 import '@xh/hoist/mobile/register';
-import {withDefault} from '@xh/hoist/utils/js';
+import {logError, withDefault} from '@xh/hoist/utils/js';
 
 export interface ColChooserButtonProps extends ButtonProps {
     /** GridModel of the grid for which this button should show a chooser. */
@@ -30,8 +30,9 @@ export const [ColChooserButton, colChooserButton] = hoistCmp.withFactory<ColChoo
         gridModel = withDefault(gridModel, useContextModel(GridModel));
 
         if (!gridModel) {
-            console.error(
-                "No GridModel available to ColChooserButton. Provide via a 'gridModel' prop, or context."
+            logError(
+                "No GridModel available. Provide via a 'gridModel' prop, or context.",
+                ColChooserButton
             );
             return button({icon, disabled: true, ...props});
         }

package/mobile/cmp/button/ExpandCollapseButton.ts

@@ -9,7 +9,7 @@ import {hoistCmp, useContextModel} from '@xh/hoist/core';
 import {Icon} from '@xh/hoist/icon';
 import {button, ButtonProps} from '@xh/hoist/mobile/cmp/button';
 import '@xh/hoist/mobile/register';
-import {withDefault} from '@xh/hoist/utils/js';
+import {logError, withDefault} from '@xh/hoist/utils/js';
 import {isEmpty} from 'lodash';
 
 export interface ExpandCollapseButtonProps extends ButtonProps {
@@ -28,8 +28,9 @@ export const [ExpandCollapseButton, expandCollapseButton] =
             gridModel = withDefault(gridModel, useContextModel(GridModel));
 
             if (!gridModel) {
-                console.error(
-                    "No GridModel available. Provide via a 'gridModel' prop, or context."
+                logError(
+                    "No GridModel available. Provide via a 'gridModel' prop, or context.",
+                    ExpandCollapseButton
                 );
                 return button({icon: Icon.expand(), disabled: true, ...props});
             }

package/mobile/cmp/button/ZoneMapperButton.ts

@@ -8,7 +8,7 @@ import {hoistCmp, useContextModel} from '@xh/hoist/core';
 import {ZoneGridModel} from '../../../cmp/zoneGrid';
 import {button, ButtonProps} from '@xh/hoist/mobile/cmp/button';
 import {Icon} from '@xh/hoist/icon';
-import {withDefault} from '@xh/hoist/utils/js';
+import {logError, withDefault} from '@xh/hoist/utils/js';
 import '@xh/hoist/mobile/register';
 
 export interface ZoneMapperButtonProps extends ButtonProps {
@@ -28,8 +28,9 @@ export const [ZoneMapperButton, zoneMapperButton] = hoistCmp.withFactory<ZoneMap
         zoneGridModel = withDefault(zoneGridModel, useContextModel(ZoneGridModel));
 
         if (!zoneGridModel) {
-            console.error(
-                "No ZoneGridModel available to ZoneMapperButton. Provide via a 'zoneGridModel' prop, or context."
+            logError(
+                "No ZoneGridModel available. Provide via a 'zoneGridModel' prop, or context.",
+                ZoneMapperButton
             );
             return button({icon, disabled: true, ...props});
         }

package/mobile/cmp/input/DateInput.ts

@@ -161,7 +161,7 @@ class DateInputModel extends HoistInputModel {
         if (date && this.isOutsideRange(date)) {
             // Dates outside of min/max constraints are reset to null.
             date = null;
-            console.debug('DateInput value exceeded max/minDate bounds on change - reset to null.');
+            this.logDebug('Value exceeded max/minDate bounds on change - reset to null.');
         }
         this.noteValueChange(date ? date.toDate() : null);
     };

package/mobile/cmp/input/Select.ts

@@ -272,8 +272,8 @@ class SelectInputModel extends HoistInputModel {
                 ? reactAsyncCreatableSelect
                 : reactAsyncSelect
             : creatableMode
-            ? reactCreatableSelect
-            : reactSelect;
+              ? reactCreatableSelect
+              : reactSelect;
     }
 
     @action
@@ -468,7 +468,7 @@ class SelectInputModel extends HoistInputModel {
                 return matchOpts;
             })
             .catch(e => {
-                console.error(e);
+                this.logError(e);
                 throw e;
             });
     };

package/mobile/cmp/panel/Panel.ts

@@ -24,6 +24,7 @@ import {omitBy} from 'lodash';
 import {isValidElement, ReactNode, ReactElement} from 'react';
 import {panelHeader} from './impl/PanelHeader';
 import './Panel.scss';
+import {logWarn} from '@xh/hoist/utils/js';
 
 export interface PanelProps extends HoistProps, Omit<BoxProps, 'title'> {
     /** A toolbar to be docked at the bottom of the panel. */
@@ -141,8 +142,9 @@ function parseLoadDecorator(prop, name, contextModel) {
     if (prop === 'onLoad') {
         const loadModel = contextModel?.loadModel;
         if (!loadModel) {
-            console.warn(
-                `Cannot use 'onLoad' for '${name}'.  Context model does not implement loading.`
+            logWarn(
+                `Cannot use 'onLoad' for '${name}'.  Context model does not implement loading.`,
+                Panel
             );
             return null;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xh/hoist",
-  "version": "59.3.2",
+  "version": "59.5.0",
   "description": "Hoist add-on for building and deploying React Applications.",
   "repository": "github:xh/hoist-react",
   "homepage": "https://xh.io",
@@ -65,7 +65,7 @@
     "react-beautiful-dnd": "~13.1.0",
     "react-dates": "~21.8.0",
     "react-dropzone": "~10.2.2",
-    "react-grid-layout": "^1.3.4",
+    "react-grid-layout": "1.4.3",
     "react-markdown": "^8.0.7",
     "react-onsenui": "~1.13.2",
     "react-popper": "~2.3.0",

package/svc/AutoRefreshService.ts

@@ -7,7 +7,7 @@
 import {HoistService, managed, XH} from '@xh/hoist/core';
 import {Timer} from '@xh/hoist/utils/async';
 import {olderThan, ONE_SECOND, SECONDS} from '@xh/hoist/utils/datetime';
-import {logDebug, withDefault} from '@xh/hoist/utils/js';
+import {withDefault} from '@xh/hoist/utils/js';
 
 /**
  * Service to triggers an app-wide auto-refresh (if enabled, on a configurable interval) via the
@@ -58,7 +58,7 @@ export class AutoRefreshService extends HoistService {
     // Implementation
     //------------------------
     private async onTimerAsync() {
-        if (!this.enabled || document.hidden) return;
+        if (!this.enabled || !XH.pageIsVisible) return;
 
         // Wait interval after lastCompleted -- this prevents extra refreshes if user refreshes
         // manually, or loading slow.  Note auto-loads skipped if any load in progress.
@@ -69,7 +69,7 @@ export class AutoRefreshService extends HoistService {
             pendingLoad = lastRequested && lastRequested > lastCompleted;
 
         if (!pendingLoad && olderThan(last, this.interval * SECONDS)) {
-            logDebug('Triggering application auto-refresh.', this);
+            this.logDebug('Triggering application auto-refresh');
             await ctx.autoRefreshAsync();
         }
     }

package/svc/ChangelogService.ts

@@ -96,12 +96,12 @@ export class ChangelogService extends HoistService {
         const {latestAvailableVersion, LAST_READ_PREF_KEY} = this;
 
         if (includes(latestAvailableVersion, 'SNAPSHOT')) {
-            console.warn('Unable to mark changelog as read when latest version is SNAPSHOT.');
+            this.logWarn('Unable to mark changelog as read when latest version is SNAPSHOT.');
             return;
         }
 
         if (!latestAvailableVersion || !XH.prefService.hasKey(LAST_READ_PREF_KEY)) {
-            console.warn(
+            this.logWarn(
                 'Unable to mark changelog as read - latest version or required pref not found.'
             );
             return;
@@ -147,7 +147,7 @@ export class ChangelogService extends HoistService {
 
             return versions;
         } catch (e) {
-            console.error(
+            this.logError(
                 'Error parsing changelog JSON into versions - changelog will not be available',
                 e
             );

package/svc/EnvironmentService.ts

@@ -136,7 +136,7 @@ export class EnvironmentService extends HoistService {
         // prompted to refresh.
         const clientVersion = this.get('clientVersion');
         if (appVersion !== clientVersion) {
-            console.warn(
+            this.logWarn(
                 `Version mismatch detected between client and server - ${clientVersion} vs ${appVersion}`
             );
         }

package/svc/FetchService.ts

@@ -4,7 +4,7 @@
  *
  * Copyright © 2023 Extremely Heavy Industries Inc.
  */
-import {HoistService, XH, Exception, PlainObject, Thunkable, FetchResponse} from '@xh/hoist/core';
+import {HoistService, XH, Exception, PlainObject, FetchResponse, LoadSpec} from '@xh/hoist/core';
 import {isLocalDate, SECONDS, ONE_MINUTE, olderThan} from '@xh/hoist/utils/datetime';
 import {throwIf} from '@xh/hoist/utils/js';
 import {StatusCodes} from 'http-status-codes';
@@ -66,7 +66,7 @@ export class FetchService extends HoistService {
      * Set default headers to be sent with all subsequent requests.
      * @param headers - to be sent with all fetch requests, or a function to generate.
      */
-    setDefaultHeaders(headers: Thunkable<PlainObject>) {
+    setDefaultHeaders(headers: PlainObject | ((arg: FetchOptions) => PlainObject)) {
         this.defaultHeaders = headers;
     }
 
@@ -328,9 +328,9 @@ export interface FetchOptions {
 
     /**
      * Data to send in the request body (for POSTs/PUTs of JSON).
-     * When using `fetch`, provide a string. Otherwise, provide a PlainObject.
+     * When using `fetch`, provide a string. Otherwise, provide a JSON Serializable object
      */
-    body?: PlainObject | string;
+    body?: any;
 
     /**
      * Parameters to encode and append as a query string, or send with the request body
@@ -360,7 +360,7 @@ export interface FetchOptions {
      * Optional metadata about the underlying request. Passed through for downstream processing by
      * utils such as {@link ExceptionHandler}.
      */
-    loadSpec?: PlainObject;
+    loadSpec?: LoadSpec;
 
     /**
      * Options to pass to the underlying fetch request.

package/svc/GridAutosizeService.ts

@@ -60,24 +60,21 @@ export class GridAutosizeService extends HoistService {
             );
 
         if (!requiredWidths) {
-            console.debug('Autosize aborted, grid data is obsolete.');
+            this.logDebug('Autosize aborted, grid data is obsolete.');
             return;
         }
 
         runInAction(() => {
             // 4) Set columns to their required widths.
             gridModel.applyColumnStateChanges(requiredWidths);
-            console.debug(
-                `Column widths autosized via GridAutosizeService (${records.length} records)`,
-                requiredWidths
-            );
+            this.logDebug(`Auto-sized columns`, `${records.length} records`, requiredWidths);
 
             // 5) Grow columns to fill any remaining space, if enabled.
             const {fillMode} = options;
             if (fillMode && fillMode !== 'none') {
                 const fillWidths = this.calcFillWidths(gridModel, colIds, fillMode);
                 gridModel.applyColumnStateChanges(fillWidths);
-                console.debug('Column widths filled via GridAutosizeService', fillWidths);
+                this.logDebug('Auto-sized columns using fillMode', fillWidths);
             }
         });
     }
@@ -170,7 +167,7 @@ export class GridAutosizeService extends HoistService {
             available = agApi?.gridPanel?.eBodyViewport?.clientWidth;
 
         if (!agApi || !isFinite(available)) {
-            console.warn('Grid not rendered - unable to fill columns.');
+            this.logWarn('Grid not rendered - unable to fill columns.');
             return [];
         }
 

package/svc/GridExportService.ts

@@ -327,13 +327,8 @@ export class GridExportService extends HoistService {
                 : it.exportName;
 
             if (!isString(ret)) {
-                console.warn(
-                    'Tried to export column ' +
-                        it.colId +
-                        ' with an invalid "exportName", ' +
-                        'probably caused by setting "headerName" to a React element. Please specify an ' +
-                        'appropriate "exportName". Defaulting to ' +
-                        it.colId
+                this.logWarn(
+                    `Tried to export column '${it.colId}' with an invalid "exportName", probably caused by setting "headerName" to a React element. Please specify an appropriate "exportName". Defaulting to '${it.colId}'`
                 );
                 ret = it.colId;
             }
@@ -345,7 +340,7 @@ export class GridExportService extends HoistService {
         const headerCounts = countBy(headers.map(it => it.toLowerCase())),
             dupeHeaders = keys(pickBy(headerCounts, it => it > 1));
         if (type === 'excelTable' && !isEmpty(dupeHeaders)) {
-            console.warn(
+            this.logWarn(
                 'Excel tables require unique headers on each column. Consider using the "exportName" property to ensure unique headers. Duplicate headers: ',
                 dupeHeaders
             );

package/svc/IdentityService.ts

@@ -62,7 +62,7 @@ export class IdentityService extends HoistService {
         try {
             await XH.appModel?.logoutAsync();
         } catch (e) {
-            console.error('Error calling XH.appModel.logoutAsync()', e);
+            this.logError('Error calling XH.appModel.logoutAsync()', e);
         }
         return XH.fetchJson({url: 'xh/logout'})
             .then(() => XH.reloadApp())

package/svc/TrackService.ts

@@ -45,19 +45,13 @@ export class TrackService extends HoistService {
 
         // Short-circuit if disabled...
         if (!this.enabled) {
-            console.debug(
-                '[TrackService] | Activity tracking disabled - activity will not be tracked.',
-                options
-            );
+            this.logDebug('Activity tracking disabled - activity will not be tracked.', options);
             return;
         }
 
         // ...or invalid request (with warning for developer)...
         if (!options.message) {
-            console.warn(
-                '[TrackService] | Required message not provided - activity will not be tracked.',
-                options
-            );
+            this.logWarn('Required message not provided - activity will not be tracked.', options);
             return;
         }
 
@@ -97,23 +91,23 @@ export class TrackService extends HoistService {
 
             const {maxDataLength} = this.conf;
             if (params.data?.length > maxDataLength) {
-                console.warn(
-                    `[TrackService] | Track log includes ${params.data.length} chars of JSON data | exceeds limit of ${maxDataLength} | data will not be persisted`,
+                this.logWarn(
+                    `Track log includes ${params.data.length} chars of JSON data`,
+                    `exceeds limit of ${maxDataLength}`,
+                    'data will not be persisted',
                     options.data
                 );
                 params.data = null;
             }
 
             const elapsedStr = params.elapsed != null ? `${params.elapsed}ms` : null,
-                consoleMsg = ['[Track]', params.category, params.msg, elapsedStr]
-                    .filter(it => it != null)
-                    .join(' | ');
+                consoleMsgs = [params.category, params.msg, elapsedStr].filter(it => it != null);
 
-            console.log(consoleMsg);
+            this.logInfo(...consoleMsgs);
 
             await XH.fetchJson({url: 'xh/track', params});
         } catch (e) {
-            console.error(`[TrackService] | Failed to persist track log`, options, e);
+            this.logError('Failed to persist track log', options, e);
         }
     }
 }

package/svc/WebSocketService.ts

@@ -6,7 +6,7 @@
  */
 import {HoistService, XH} from '@xh/hoist/core';
 import {Icon} from '@xh/hoist/icon';
-import {action, observable, makeObservable} from '@xh/hoist/mobx';
+import {action, makeObservable, observable} from '@xh/hoist/mobx';
 import {Timer} from '@xh/hoist/utils/async';
 import {SECONDS} from '@xh/hoist/utils/datetime';
 import {throwIf} from '@xh/hoist/utils/js';
@@ -55,11 +55,11 @@ export class WebSocketService extends HoistService {
         return !!this.channelKey;
     }
 
-    /** set to true to log all sent/received messages - very chatty. */
+    /** Set to true to log all sent/received messages - very chatty. */
     logMessages: boolean = false;
 
-    private _timer;
-    private _socket;
+    private _timer: Timer;
+    private _socket: WebSocket;
     private _subsByTopic = {};
 
     enabled: boolean = XH.appSpec.webSocketsEnabled;
@@ -72,9 +72,8 @@ export class WebSocketService extends HoistService {
     override async initAsync() {
         if (!this.enabled) return;
         if (XH.environmentService.get('webSocketsEnabled') === false) {
-            console.error(
-                'WebSockets have been enabled on this client app, but are disabled on the server. ' +
-                    'Please adjust your server-side configuration to use WebSockets.'
+            this.logError(
+                `WebSockets enabled on this client app but disabled on server. Adjust your server-side config.`
             );
             this.enabled = false;
             return;
@@ -151,7 +150,7 @@ export class WebSocketService extends HoistService {
             };
             this._socket = s;
         } catch (e) {
-            console.error('Failure creating WebSocket in WebSocketService', e);
+            this.logError('Failure creating WebSocket', e);
         }
 
         this.updateConnectedStatus();
@@ -170,7 +169,7 @@ export class WebSocketService extends HoistService {
         if (this.connected) {
             this.sendMessage({topic: this.HEARTBEAT_TOPIC, data: 'ping'});
         } else {
-            console.warn('Heartbeat found websocket not connected - attempting to reconnect.');
+            this.logWarn('Heartbeat found websocket not connected - attempting to reconnect...');
             this.disconnect();
             this.connect();
         }
@@ -185,17 +184,17 @@ export class WebSocketService extends HoistService {
     // Socket events impl
     //------------------------
     onOpen(ev) {
-        console.debug('WebSocket connection opened', ev);
+        this.logDebug('WebSocket connection opened', ev);
         this.updateConnectedStatus();
     }
 
     onClose(ev) {
-        console.debug('WebSocket connection closed', ev);
+        this.logDebug('WebSocket connection closed', ev);
         this.updateConnectedStatus();
     }
 
     onError(ev) {
-        console.error('WebSocket connection error', ev);
+        this.logError('WebSocket connection error', ev);
         this.updateConnectedStatus();
     }
 
@@ -221,7 +220,7 @@ export class WebSocketService extends HoistService {
 
             this.notifySubscribers(msg);
         } catch (e) {
-            console.error('Error decoding websocket message', rawMsg, e);
+            this.logError('Error decoding websocket message', rawMsg, e);
         }
         this.updateConnectedStatus();
     }
@@ -236,7 +235,7 @@ export class WebSocketService extends HoistService {
             try {
                 sub.fn(message);
             } catch (e) {
-                console.error(`Failure in subscription handler for topic ${message.topic}`, e);
+                this.logError(`Handler for topic ${message.topic} threw`, e);
             }
         });
     }
@@ -287,7 +286,7 @@ export class WebSocketService extends HoistService {
     }
 
     maybeLogMessage(...args) {
-        if (this.logMessages) console.log(...args);
+        if (this.logMessages) this.logDebug(args);
     }
 }
 

package/utils/async/AsyncUtils.ts

@@ -4,6 +4,7 @@
  *
  * Copyright © 2023 Extremely Heavy Industries Inc.
  */
+import {XH} from '@xh/hoist/core';
 import {wait} from '@xh/hoist/promise';
 
 /**
@@ -15,7 +16,7 @@ import {wait} from '@xh/hoist/promise';
  * allowing ongoing rendering of UI updates (e.g. load masks) and generally keeping the browser
  * event loop running.
  *
- * Note that if the browser tab is hidden (i.e. document.hidden is true) this loop will be executed
+ * Note that if the content tab is hidden (i.e. `!XH.pageIsVisible`) this loop will be executed
  * without pauses.  In this case the pauses would be unduly large due to throttling of the event
  * loop by the browser, and there is no user benefit to avoiding blocking the main thread.
  *
@@ -55,7 +56,7 @@ export async function whileAsync(
     const {waitAfter = 50, waitFor = 0} = opts ?? {};
 
     // Fallback to basic loop when doc hidden: no user benefit, and throttling causes outsize waits
-    if (document.hidden) {
+    if (!XH.pageIsVisible) {
         while (conditionFn()) fn();
         return;
     }

package/utils/async/Timer.ts

@@ -7,7 +7,7 @@
 import {XH} from '@xh/hoist/core';
 import {wait} from '@xh/hoist/promise';
 import {MILLISECONDS, MINUTES, olderThan} from '@xh/hoist/utils/datetime';
-import {throwIf} from '@xh/hoist/utils/js';
+import {logError, logWarn, throwIf} from '@xh/hoist/utils/js';
 import {isBoolean, isFinite, isFunction, isNil, isString, pull} from 'lodash';
 
 /**
@@ -122,7 +122,7 @@ export class Timer {
         try {
             await (this.internalRunFn() as any).timeout(this.timeoutMs);
         } catch (e) {
-            console.error('Error executing timer:', e);
+            logError(['Error executing timer', e], this);
         }
         this.isRunning = false;
         this.lastRun = new Date();
@@ -152,8 +152,9 @@ export class Timer {
         if (ret > 0 && ret < min) {
             if (!warnedIntervals.has(ret)) {
                 warnedIntervals.add(ret);
-                console.warn(
-                    `Timer interval of ${ret}ms requested - forcing to min interval of ${min}ms.`
+                logWarn(
+                    `Interval of ${ret}ms requested - forcing to min interval of ${min}ms.`,
+                    this
                 );
             }
             ret = min;

package/utils/datetime/LocalDate.ts

@@ -5,8 +5,8 @@
  * Copyright © 2023 Extremely Heavy Industries Inc.
  */
 import {XH} from '@xh/hoist/core';
-import {throwIf, computeOnce} from '@xh/hoist/utils/js';
-import {isString, isNil} from 'lodash';
+import {computeOnce, throwIf} from '@xh/hoist/utils/js';
+import {isNil, isString} from 'lodash';
 import moment, {Moment, MomentInput} from 'moment';
 
 /**
@@ -25,9 +25,9 @@ export class LocalDate {
     private static _instances = new Map();
     static VALID_UNITS = ['year', 'quarter', 'month', 'week', 'day', 'date'];
 
-    private _isoString;
-    private _moment;
-    private _date;
+    private _isoString: string;
+    private _moment: Moment;
+    private _date: Date;
 
     //------------------------
     // Factories
@@ -99,8 +99,8 @@ export class LocalDate {
     }
 
     /** Is the input value a local Date? */
-    static isLocalDate(v: any): boolean {
-        return v?.isLocalDate;
+    static isLocalDate(val: any): boolean {
+        return !!val?.isLocalDate;
     }
 
     //--------------------
@@ -168,15 +168,15 @@ export class LocalDate {
     //----------------
     // Core overrides.
     //----------------
-    toString() {
+    toString(): string {
         return this._isoString;
     }
 
-    toJSON() {
+    toJSON(): string {
         return this._isoString;
     }
 
-    valueOf() {
+    valueOf(): string {
         return this._isoString;
     }
 
@@ -281,7 +281,7 @@ export class LocalDate {
         return this.isWeekday ? this : this.previousWeekday();
     }
 
-    diff(other, unit = 'days'): number {
+    diff(other: LocalDate, unit: moment.unitOfTime.Diff = 'days'): number {
         this.ensureUnitValid(unit);
         return this._moment.diff(other._moment, unit);
     }
@@ -290,7 +290,7 @@ export class LocalDate {
     // Implementation
     //-------------------
     /** @internal - use one of the static factory methods instead. */
-    private constructor(s) {
+    private constructor(s: string) {
         const m = moment(s, 'YYYY-MM-DD', true);
         throwIf(
             !m.isValid(),
@@ -315,6 +315,6 @@ export class LocalDate {
  * Is the input value a local Date?
  * Convenience alias for LocalDate.isLocalDate()
  */
-export function isLocalDate(val): val is LocalDate {
+export function isLocalDate(val: any): val is LocalDate {
     return !!val?.isLocalDate;
 }