@xh/hoist 67.0.0-SNAPSHOT.1724286422850 → 67.0.0-SNAPSHOT.1724362478970

package/CHANGELOG.md

@@ -21,7 +21,8 @@
 * New property `FetchOptions.asJson` to instruct `FetchService` to decode an HTTP response as JSON.
   Note that `FetchService` methods suffixed with `Json` will set this property automatically.
 * `GridModel` will now accept `contextMenu: false` to omit context menus.
-* Swapped locations of `primaryOnly` and `active` sliders in `MonitorEditorDialog`.
+* New bindable `AppContainerModel.intializingLoadMaskMessage` property to allow apps to customize
+  the loading mask message shown during app initialization.
 
 ### 🐞 Bug Fixes
 

package/appcontainer/AppContainerModel.ts

@@ -16,9 +16,10 @@ import {
     XH
 } from '@xh/hoist/core';
 import {Icon} from '@xh/hoist/icon';
-import {action, when as mobxWhen} from '@xh/hoist/mobx';
+import {action, bindable, when as mobxWhen} from '@xh/hoist/mobx';
 import {never, wait} from '@xh/hoist/promise';
 import numbro from 'numbro';
+import {ReactNode} from 'react';
 import {createRoot} from 'react-dom/client';
 import {
     AlertBannerService,
@@ -97,6 +98,12 @@ export class AppContainerModel extends HoistModel {
     @managed themeModel = new ThemeModel();
     @managed userAgentModel = new UserAgentModel();
 
+    /**
+     * Message shown on spinner while the application is in the INITIALIZING state.
+     * Update within `AppModel.initAsync()` to relay app-specific initialization status.
+     */
+    @bindable initializingLoadMaskMessage: ReactNode;
+
     /**
      * Main entry point. Initialize and render application code.
      */

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

@@ -1,4 +1,5 @@
 import { AppSpec, HoistAppModel, HoistModel, RootRefreshContextModel, TaskObserver } from '@xh/hoist/core';
+import { ReactNode } from 'react';
 import { AboutDialogModel } from './AboutDialogModel';
 import { BannerSourceModel } from './BannerSourceModel';
 import { ChangelogDialogModel } from './ChangelogDialogModel';
@@ -40,6 +41,11 @@ export declare class AppContainerModel extends HoistModel {
     viewportSizeModel: ViewportSizeModel;
     themeModel: ThemeModel;
     userAgentModel: UserAgentModel;
+    /**
+     * Message shown on spinner while the application is in the INITIALIZING state.
+     * Update within `AppModel.initAsync()` to relay app-specific initialization status.
+     */
+    initializingLoadMaskMessage: ReactNode;
     /**
      * Main entry point. Initialize and render application code.
      */

package/desktop/appcontainer/AppContainer.ts

@@ -87,7 +87,7 @@ export const AppContainer = hoistCmp({
                     },
                     errorRenderer: () => null
                 },
-                item: viewForState()
+                item: viewForState({model})
             }),
             // Modal component helpers rendered here at top-level to support display of messages
             // and exceptions at any point during the app lifecycle.
@@ -101,11 +101,13 @@ export const AppContainer = hoistCmp({
 //-----------------------------------------
 // Implementation
 //-----------------------------------------
-function viewForState() {
+function viewForState({model}) {
     switch (XH.appState) {
         case 'PRE_AUTH':
         case 'INITIALIZING':
-            return viewport(mask({spinner: true, isDisplayed: true}));
+            return viewport(
+                mask({spinner: true, isDisplayed: true, message: model.initializingLoadMaskMessage})
+            );
         case 'LOGIN_REQUIRED':
             return loginPanel();
         case 'ACCESS_DENIED':

package/mobile/appcontainer/AppContainer.ts

@@ -72,7 +72,7 @@ export const AppContainer = hoistCmp({
                     },
                     errorRenderer: () => null
                 },
-                item: viewForState()
+                item: viewForState({model})
             }),
             // Modal component helpers rendered here at top-level to support display of messages
             // and exceptions at any point during the app lifecycle.
@@ -86,11 +86,13 @@ export const AppContainer = hoistCmp({
 //-------------------
 // Implementation
 //-------------------
-function viewForState() {
+function viewForState({model}) {
     switch (XH.appState) {
         case 'PRE_AUTH':
         case 'INITIALIZING':
-            return viewport(mask({spinner: true, isDisplayed: true}));
+            return viewport(
+                mask({spinner: true, isDisplayed: true, message: model.initializingLoadMaskMessage})
+            );
         case 'LOGIN_REQUIRED':
             return loginPanel();
         case 'ACCESS_DENIED':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xh/hoist",
-  "version": "67.0.0-SNAPSHOT.1724286422850",
+  "version": "67.0.0-SNAPSHOT.1724362478970",
   "description": "Hoist add-on for building and deploying React Applications.",
   "repository": "github:xh/hoist-react",
   "homepage": "https://xh.io",