@j2inn/fin5-ui-utils 8.2.0 → 8.3.0

package/dist/index.js

@@ -1,70 +1,70 @@
-"use strict";
-/*
- * Copyright (c) 2022, J2 Innovations. All Rights Reserved
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-//////////////////////////////////////////////////////////////////////////
-// Fin5 APIs related modules
-//////////////////////////////////////////////////////////////////////////
-__exportStar(require("./fin5Top/fin5FileUpload"), exports);
-__exportStar(require("./fin5Top/fin5Top"), exports);
-__exportStar(require("./fin5Top/finEdge2Cloud"), exports);
-__exportStar(require("./fin5Top/getFin5BinUrl"), exports);
-__exportStar(require("./fin5Top/openFin5Alarm"), exports);
-__exportStar(require("./fin5Top/openFin5Historian"), exports);
-__exportStar(require("./fin5Top/useFin5AppURLHashParameter"), exports);
-//////////////////////////////////////////////////////////////////////////
-// Fin5 features related modules
-//////////////////////////////////////////////////////////////////////////
-__exportStar(require("./jobs/jobUtils"), exports);
-//////////////////////////////////////////////////////////////////////////
-// React components
-//////////////////////////////////////////////////////////////////////////
-__exportStar(require("./react/components/ErrorBoundary"), exports);
-__exportStar(require("./react/components/ErrorDisplayer"), exports);
-__exportStar(require("./react/components/Loader"), exports);
-__exportStar(require("./react/components/LoadingSpinner"), exports);
-__exportStar(require("./react/components/graphics/GraphicViewer"), exports);
-__exportStar(require("./react/components/graphics/GraphicsTabViewer"), exports);
-__exportStar(require("./react/components/navigation/BasicLayout"), exports);
-__exportStar(require("./react/components/navigation/MenuPage"), exports);
-__exportStar(require("./react/components/navigation/ReactRouterLayout"), exports);
-__exportStar(require("./react/components/navigation/ReactRouterHeaderSiderLayout"), exports);
-__exportStar(require("./react/components/navigation/customRouting/RouterLayout"), exports);
-__exportStar(require("./react/components/navigation/customRouting/Router"), exports);
-__exportStar(require("./react/components/resolvable/configurationForm/ConfigurationForm"), exports);
-__exportStar(require("./react/components/resolvable/configurationForm/ConfigurationFormEntry"), exports);
-__exportStar(require("./react/components/resolvable/configurationForm/getSectionDefault"), exports);
-__exportStar(require("./react/components/RecordImage"), exports);
-__exportStar(require("./react/components/charts/QRCode"), exports);
-__exportStar(require("./react/components/charts/line-bar/Chart"), exports);
-__exportStar(require("./react/components/charts/line-bar/HGridChart"), exports);
-__exportStar(require("./react/components/charts/pie/PieChart"), exports);
-__exportStar(require("./react/components/charts/pie/SimplePieChart"), exports);
-__exportStar(require("./react/components/makeCustomElement"), exports);
-//////////////////////////////////////////////////////////////////////////
-// React hooks
-//////////////////////////////////////////////////////////////////////////
-__exportStar(require("./react/hooks/useFin5BinUrl"), exports);
-__exportStar(require("./react/hooks/useFin5ColorScheme"), exports);
-__exportStar(require("./react/hooks/useScreenSize"), exports);
-//////////////////////////////////////////////////////////////////////////
-// j2inn/app support for FIN5
-//////////////////////////////////////////////////////////////////////////
-__exportStar(require("./react/app/Fin5AppContainer"), exports);
-__exportStar(require("./react/app/Fin5AppRootStore"), exports);
+"use strict";
+/*
+ * Copyright (c) 2022, J2 Innovations. All Rights Reserved
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+//////////////////////////////////////////////////////////////////////////
+// Fin5 APIs related modules
+//////////////////////////////////////////////////////////////////////////
+__exportStar(require("./fin5Top/fin5FileUpload"), exports);
+__exportStar(require("./fin5Top/fin5Top"), exports);
+__exportStar(require("./fin5Top/finEdge2Cloud"), exports);
+__exportStar(require("./fin5Top/getFin5BinUrl"), exports);
+__exportStar(require("./fin5Top/openFin5Alarm"), exports);
+__exportStar(require("./fin5Top/openFin5Historian"), exports);
+__exportStar(require("./fin5Top/useFin5AppURLHashParameter"), exports);
+//////////////////////////////////////////////////////////////////////////
+// Fin5 features related modules
+//////////////////////////////////////////////////////////////////////////
+__exportStar(require("./jobs/jobUtils"), exports);
+//////////////////////////////////////////////////////////////////////////
+// React components
+//////////////////////////////////////////////////////////////////////////
+__exportStar(require("./react/components/ErrorBoundary"), exports);
+__exportStar(require("./react/components/ErrorDisplayer"), exports);
+__exportStar(require("./react/components/Loader"), exports);
+__exportStar(require("./react/components/LoadingSpinner"), exports);
+__exportStar(require("./react/components/graphics/GraphicViewer"), exports);
+__exportStar(require("./react/components/graphics/GraphicsTabViewer"), exports);
+__exportStar(require("./react/components/navigation/BasicLayout"), exports);
+__exportStar(require("./react/components/navigation/MenuPage"), exports);
+__exportStar(require("./react/components/navigation/ReactRouterLayout"), exports);
+__exportStar(require("./react/components/navigation/ReactRouterHeaderSiderLayout"), exports);
+__exportStar(require("./react/components/navigation/customRouting/RouterLayout"), exports);
+__exportStar(require("./react/components/navigation/customRouting/Router"), exports);
+__exportStar(require("./react/components/resolvable/configurationForm/ConfigurationForm"), exports);
+__exportStar(require("./react/components/resolvable/configurationForm/ConfigurationFormEntry"), exports);
+__exportStar(require("./react/components/resolvable/configurationForm/getSectionDefault"), exports);
+__exportStar(require("./react/components/RecordImage"), exports);
+__exportStar(require("./react/components/charts/QRCode"), exports);
+__exportStar(require("./react/components/charts/line-bar/Chart"), exports);
+__exportStar(require("./react/components/charts/line-bar/HGridChart"), exports);
+__exportStar(require("./react/components/charts/pie/PieChart"), exports);
+__exportStar(require("./react/components/charts/pie/SimplePieChart"), exports);
+__exportStar(require("./react/components/makeCustomElement"), exports);
+//////////////////////////////////////////////////////////////////////////
+// React hooks
+//////////////////////////////////////////////////////////////////////////
+__exportStar(require("./react/hooks/useFin5BinUrl"), exports);
+__exportStar(require("./react/hooks/useFin5ColorScheme"), exports);
+__exportStar(require("./react/hooks/useScreenSize"), exports);
+//////////////////////////////////////////////////////////////////////////
+// j2inn/app support for FIN5
+//////////////////////////////////////////////////////////////////////////
+__exportStar(require("./react/app/Fin5AppContainer"), exports);
+__exportStar(require("./react/app/Fin5AppRootStore"), exports);
 //# sourceMappingURL=index.js.map

package/dist/jobs/jobUtils.d.ts

@@ -1,14 +1,14 @@
-import { HDict, HNum, HStr } from 'haystack-core';
-export declare enum JobStatus {
-    doneOk = "doneOk",
-    doneErr = "doneErr",
-    running = "running"
-}
-export interface JobStatusDict extends HDict {
-    jobStatus: HStr;
-    progress: HNum;
-    progressMsg: HStr;
-}
-export declare const isJobSuccessful: (jobStatus: JobStatusDict) => boolean;
-export declare const isJobError: (jobStatus: JobStatusDict) => boolean;
-export declare const isJobRunning: (jobStatus: JobStatusDict) => boolean;
+import { HDict, HNum, HStr } from 'haystack-core';
+export declare enum JobStatus {
+    doneOk = "doneOk",
+    doneErr = "doneErr",
+    running = "running"
+}
+export interface JobStatusDict extends HDict {
+    jobStatus: HStr;
+    progress: HNum;
+    progressMsg: HStr;
+}
+export declare const isJobSuccessful: (jobStatus: JobStatusDict) => boolean;
+export declare const isJobError: (jobStatus: JobStatusDict) => boolean;
+export declare const isJobRunning: (jobStatus: JobStatusDict) => boolean;

package/dist/jobs/jobUtils.js

@@ -1,16 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isJobRunning = exports.isJobError = exports.isJobSuccessful = exports.JobStatus = void 0;
-var JobStatus;
-(function (JobStatus) {
-    JobStatus["doneOk"] = "doneOk";
-    JobStatus["doneErr"] = "doneErr";
-    JobStatus["running"] = "running";
-})(JobStatus = exports.JobStatus || (exports.JobStatus = {}));
-const isJobSuccessful = (jobStatus) => jobStatus.jobStatus.value === JobStatus.doneOk;
-exports.isJobSuccessful = isJobSuccessful;
-const isJobError = (jobStatus) => jobStatus.jobStatus.value === JobStatus.doneErr;
-exports.isJobError = isJobError;
-const isJobRunning = (jobStatus) => jobStatus.jobStatus.value === JobStatus.running;
-exports.isJobRunning = isJobRunning;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isJobRunning = exports.isJobError = exports.isJobSuccessful = exports.JobStatus = void 0;
+var JobStatus;
+(function (JobStatus) {
+    JobStatus["doneOk"] = "doneOk";
+    JobStatus["doneErr"] = "doneErr";
+    JobStatus["running"] = "running";
+})(JobStatus = exports.JobStatus || (exports.JobStatus = {}));
+const isJobSuccessful = (jobStatus) => jobStatus.jobStatus.value === JobStatus.doneOk;
+exports.isJobSuccessful = isJobSuccessful;
+const isJobError = (jobStatus) => jobStatus.jobStatus.value === JobStatus.doneErr;
+exports.isJobError = isJobError;
+const isJobRunning = (jobStatus) => jobStatus.jobStatus.value === JobStatus.running;
+exports.isJobRunning = isJobRunning;
 //# sourceMappingURL=jobUtils.js.map

package/dist/react/app/Fin5AppContainer.d.ts

@@ -1,36 +1,36 @@
-import React from 'react';
-import { AppStore } from '@j2inn/app';
-import { Client } from 'haystack-nclient';
-import { ThemeDef } from '@j2inn/ui';
-/**
- * Properties for the dev application container component.
- */
-export interface Fin5AppContainerProps {
-    /**
-     * The children to render.
-     */
-    children?: React.ReactNode;
-    /**
-     * The app store.
-     */
-    appStore?: AppStore;
-    /**
-     * The network client object.
-     */
-    client?: Client;
-    /**
-     * Optional project name. Typically this is only specified
-     * in development mode. It's typically picked up from the URL.
-     */
-    project?: string;
-    /**
-     * The optional theme to use.
-     */
-    theme?: ThemeDef;
-}
-/**
- * Creates a basic application container environment to run a view in FIN5.
- */
-export declare const Fin5AppContainer: (({ children, appStore, client, project, theme, }: Fin5AppContainerProps) => JSX.Element) & {
-    displayName: string;
-};
+import React from 'react';
+import { AppStore } from '@j2inn/app';
+import { Client } from 'haystack-nclient';
+import { ThemeDef } from '@j2inn/ui';
+/**
+ * Properties for the dev application container component.
+ */
+export interface Fin5AppContainerProps {
+    /**
+     * The children to render.
+     */
+    children?: React.ReactNode;
+    /**
+     * The app store.
+     */
+    appStore?: AppStore;
+    /**
+     * The network client object.
+     */
+    client?: Client;
+    /**
+     * Optional project name. Typically this is only specified
+     * in development mode. It's typically picked up from the URL.
+     */
+    project?: string;
+    /**
+     * The optional theme to use.
+     */
+    theme?: ThemeDef;
+}
+/**
+ * Creates a basic application container environment to run a view in FIN5.
+ */
+export declare const Fin5AppContainer: (({ children, appStore, client, project, theme, }: Fin5AppContainerProps) => JSX.Element) & {
+    displayName: string;
+};

package/dist/react/app/Fin5AppContainer.js

@@ -1,162 +1,162 @@
-"use strict";
-/*
- * Copyright (c) 2022, J2 Innovations. All Rights Reserved
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Fin5AppContainer = void 0;
-const react_1 = __importStar(require("react"));
-const app_react_1 = require("@j2inn/app-react");
-const mobx_react_lite_1 = require("mobx-react-lite");
-const Fin5AppRootStore_1 = require("./Fin5AppRootStore");
-const haystack_nclient_1 = require("haystack-nclient");
-const haystack_react_1 = require("haystack-react");
-const utils_1 = require("@j2inn/utils");
-const react_jss_1 = require("react-jss");
-const ui_1 = require("@j2inn/ui");
-const fin5Top_1 = require("../../fin5Top/fin5Top");
-const useFin5AppURLHashParameter_1 = require("../../fin5Top/useFin5AppURLHashParameter");
-const haystack_core_1 = require("haystack-core");
-const ErrorBoundary_1 = require("../components/ErrorBoundary");
-const Loader_1 = __importDefault(require("../components/Loader"));
-const PATH_PREFIX = 'finApp';
-/**
- * The Ractive keypath used to observe target reference changes on fin5Top.app.
- * @see https://ractive.js.org/api/#ractiveobserve
- */
-const FIN5_TARGET_KEYPATH = 'currentId';
-const getServiceUrl = ({ origin, path }) => `${origin}/${PATH_PREFIX}/api/${path}`;
-const getOpUrl = ({ origin, project, op }) => `${origin}/api/${project}/${op}`;
-const getHaystackServiceUrl = ({ origin, project, path, }) => `${origin}/${PATH_PREFIX}/api/haystack${project ? `/${project}` : ''}/${path}`;
-const getHostServiceUrl = ({ origin, path, }) => `${origin}/${PATH_PREFIX}/api/host/${path}`;
-/**
- * Runtime type guard that checks whether a store instance
- * exposes a boolean `initialized` flag.
- *
- * @param {AppStore | null | undefined} appStore - The store instance to test
- * @returns {appStore is AppStore & { initialized: boolean }} True if `appStore` has a boolean `initialized` property
- *
- * @remarks
- * To use the FINX onMessage feature, ensure the concrete store declares `initialized` ahead of time,
- * and set to true when children components have fully rendered.
- */
-function hasInitialized(appStore) {
-    return (!!appStore &&
-        'initialized' in appStore &&
-        typeof appStore.initialized === 'boolean');
-}
-/**
- * Creates a basic application container environment to run a view in FIN5.
- */
-exports.Fin5AppContainer = (0, mobx_react_lite_1.observer)(({ children, appStore, client, project, theme = (0, ui_1.GenerateTheme)(ui_1.DEFAULT_THEME).light, }) => {
-    const [loading, setLoading] = (0, react_1.useState)(true);
-    const [loadingi18n, setLoadingi18n] = (0, react_1.useState)(true);
-    const rootStoreRef = (0, react_1.useRef)(null);
-    rootStoreRef.current ??= new Fin5AppRootStore_1.Fin5AppRootStore();
-    const rootStore = rootStoreRef.current;
-    const [hashProjName] = (0, useFin5AppURLHashParameter_1.useFin5AppURLHashParameter)('projectName');
-    const containerProject = project || hashProjName || fin5Top_1.fin5Top?.finstack?.projectName || '';
-    const locale = fin5Top_1.fin5Top?.languageManager?.currentLang ?? navigator?.language;
-    rootStore.locale = locale;
-    if (!rootStore.allLocales.includes(locale)) {
-        rootStore.allLocales.push(locale);
-    }
-    const initialized = hasInitialized(appStore)
-        ? appStore.initialized
-        : false;
-    const getClient = () => client ??
-        new haystack_nclient_1.Client({
-            base: new URL(window.location.href),
-            project: containerProject,
-            options: { headers: { accept: 'text/zinc' } },
-            getServiceUrl,
-            getOpUrl,
-            getHaystackServiceUrl,
-            getHostServiceUrl,
-        });
-    const [containerClient, setContainerClient] = (0, react_1.useState)(getClient);
-    // Primary: set initial value from fin5Top.app and subscribe to changes via Ractive observe
-    (0, react_1.useEffect)(() => {
-        if (!fin5Top_1.fin5Top?.app)
-            return;
-        const initial = fin5Top_1.fin5Top.app.TargetRef?.() ?? '';
-        rootStore.setTarget(initial ? haystack_core_1.HRef.make(initial).value : '');
-        const observer = fin5Top_1.fin5Top.app.observe(FIN5_TARGET_KEYPATH, (newValue) => {
-            const value = String(newValue);
-            const target = value ?? '';
-            rootStore.setTarget(target ? haystack_core_1.HRef.make(target).value : '');
-        });
-        return () => observer.cancel();
-    }, []);
-    (0, react_1.useEffect)(() => {
-        setLoading(true);
-        const newClient = getClient();
-        setContainerClient(newClient);
-        // Load everything network wise before we load
-        // the application.
-        Promise.all([
-            newClient.ext.eval('finGetCurrentUser()'),
-            newClient.ext.loadDefs(),
-        ]).then(([userGrid]) => {
-            rootStore.currentUser = userGrid.first;
-            setLoading(false);
-        });
-    }, [client, containerProject]);
-    (0, react_1.useEffect)(() => {
-        const onMessage = (event) => {
-            if (fin5Top_1.fin5Top?.location.origin === event.origin &&
-                appStore?.onMessage) {
-                appStore.onMessage({
-                    message: event.data.message,
-                    params: event.data,
-                    client: getClient(),
-                    appRootStore: rootStore,
-                });
-            }
-        };
-        window.addEventListener('message', onMessage);
-        return () => window.removeEventListener('message', onMessage);
-    }, []);
-    (0, react_1.useEffect)(() => {
-        // tell the top level app its ready
-        if (initialized) {
-            fin5Top_1.fin5Top?.postMessage({
-                kind: 'iframeApp',
-                loading: false,
-            });
-        }
-    }, [initialized]);
-    return (react_1.default.createElement(app_react_1.AppRootStoreContext.Provider, { value: rootStore },
-        react_1.default.createElement(app_react_1.AppStoreContext.Provider, { value: appStore },
-            react_1.default.createElement(haystack_react_1.ClientContext.Provider, { value: containerClient },
-                react_1.default.createElement(utils_1.I18NProvider, { locale: locale, setLoading: setLoadingi18n },
-                    react_1.default.createElement(react_jss_1.ThemeProvider, { theme: theme },
-                        react_1.default.createElement(Loader_1.default, { loading: loading || loadingi18n },
-                            react_1.default.createElement(ErrorBoundary_1.ErrorBoundary, { mode: "global" /* ErrorBoundaryMode.global */ }, children))))))));
-});
+"use strict";
+/*
+ * Copyright (c) 2022, J2 Innovations. All Rights Reserved
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Fin5AppContainer = void 0;
+const react_1 = __importStar(require("react"));
+const app_react_1 = require("@j2inn/app-react");
+const mobx_react_lite_1 = require("mobx-react-lite");
+const Fin5AppRootStore_1 = require("./Fin5AppRootStore");
+const haystack_nclient_1 = require("haystack-nclient");
+const haystack_react_1 = require("haystack-react");
+const utils_1 = require("@j2inn/utils");
+const react_jss_1 = require("react-jss");
+const ui_1 = require("@j2inn/ui");
+const fin5Top_1 = require("../../fin5Top/fin5Top");
+const useFin5AppURLHashParameter_1 = require("../../fin5Top/useFin5AppURLHashParameter");
+const haystack_core_1 = require("haystack-core");
+const ErrorBoundary_1 = require("../components/ErrorBoundary");
+const Loader_1 = __importDefault(require("../components/Loader"));
+const PATH_PREFIX = 'finApp';
+/**
+ * The Ractive keypath used to observe target reference changes on fin5Top.app.
+ * @see https://ractive.js.org/api/#ractiveobserve
+ */
+const FIN5_TARGET_KEYPATH = 'currentId';
+const getServiceUrl = ({ origin, path }) => `${origin}/${PATH_PREFIX}/api/${path}`;
+const getOpUrl = ({ origin, project, op }) => `${origin}/api/${project}/${op}`;
+const getHaystackServiceUrl = ({ origin, project, path, }) => `${origin}/${PATH_PREFIX}/api/haystack${project ? `/${project}` : ''}/${path}`;
+const getHostServiceUrl = ({ origin, path, }) => `${origin}/${PATH_PREFIX}/api/host/${path}`;
+/**
+ * Runtime type guard that checks whether a store instance
+ * exposes a boolean `initialized` flag.
+ *
+ * @param {AppStore | null | undefined} appStore - The store instance to test
+ * @returns {appStore is AppStore & { initialized: boolean }} True if `appStore` has a boolean `initialized` property
+ *
+ * @remarks
+ * To use the FINX onMessage feature, ensure the concrete store declares `initialized` ahead of time,
+ * and set to true when children components have fully rendered.
+ */
+function hasInitialized(appStore) {
+    return (!!appStore &&
+        'initialized' in appStore &&
+        typeof appStore.initialized === 'boolean');
+}
+/**
+ * Creates a basic application container environment to run a view in FIN5.
+ */
+exports.Fin5AppContainer = (0, mobx_react_lite_1.observer)(({ children, appStore, client, project, theme = (0, ui_1.GenerateTheme)(ui_1.DEFAULT_THEME).light, }) => {
+    const [loading, setLoading] = (0, react_1.useState)(true);
+    const [loadingi18n, setLoadingi18n] = (0, react_1.useState)(true);
+    const rootStoreRef = (0, react_1.useRef)(null);
+    rootStoreRef.current ??= new Fin5AppRootStore_1.Fin5AppRootStore();
+    const rootStore = rootStoreRef.current;
+    const [hashProjName] = (0, useFin5AppURLHashParameter_1.useFin5AppURLHashParameter)('projectName');
+    const containerProject = project || hashProjName || fin5Top_1.fin5Top?.finstack?.projectName || '';
+    const locale = fin5Top_1.fin5Top?.languageManager?.currentLang ?? navigator?.language;
+    rootStore.locale = locale;
+    if (!rootStore.allLocales.includes(locale)) {
+        rootStore.allLocales.push(locale);
+    }
+    const initialized = hasInitialized(appStore)
+        ? appStore.initialized
+        : false;
+    const getClient = () => client ??
+        new haystack_nclient_1.Client({
+            base: new URL(window.location.href),
+            project: containerProject,
+            options: { headers: { accept: 'text/zinc' } },
+            getServiceUrl,
+            getOpUrl,
+            getHaystackServiceUrl,
+            getHostServiceUrl,
+        });
+    const [containerClient, setContainerClient] = (0, react_1.useState)(getClient);
+    // Primary: set initial value from fin5Top.app and subscribe to changes via Ractive observe
+    (0, react_1.useEffect)(() => {
+        if (!fin5Top_1.fin5Top?.app)
+            return;
+        const initial = fin5Top_1.fin5Top.app.TargetRef?.() ?? '';
+        rootStore.setTarget(initial ? haystack_core_1.HRef.make(initial).value : '');
+        const observer = fin5Top_1.fin5Top.app.observe(FIN5_TARGET_KEYPATH, (newValue) => {
+            const value = String(newValue);
+            const target = value ?? '';
+            rootStore.setTarget(target ? haystack_core_1.HRef.make(target).value : '');
+        });
+        return () => observer.cancel();
+    }, []);
+    (0, react_1.useEffect)(() => {
+        setLoading(true);
+        const newClient = getClient();
+        setContainerClient(newClient);
+        // Load everything network wise before we load
+        // the application.
+        Promise.all([
+            newClient.ext.eval('finGetCurrentUser()'),
+            newClient.ext.loadDefs(),
+        ]).then(([userGrid]) => {
+            rootStore.currentUser = userGrid.first;
+            setLoading(false);
+        });
+    }, [client, containerProject]);
+    (0, react_1.useEffect)(() => {
+        const onMessage = (event) => {
+            if (fin5Top_1.fin5Top?.location.origin === event.origin &&
+                appStore?.onMessage) {
+                appStore.onMessage({
+                    message: event.data.message,
+                    params: event.data,
+                    client: getClient(),
+                    appRootStore: rootStore,
+                });
+            }
+        };
+        window.addEventListener('message', onMessage);
+        return () => window.removeEventListener('message', onMessage);
+    }, []);
+    (0, react_1.useEffect)(() => {
+        // tell the top level app its ready
+        if (initialized) {
+            fin5Top_1.fin5Top?.postMessage({
+                kind: 'iframeApp',
+                loading: false,
+            });
+        }
+    }, [initialized]);
+    return (react_1.default.createElement(app_react_1.AppRootStoreContext.Provider, { value: rootStore },
+        react_1.default.createElement(app_react_1.AppStoreContext.Provider, { value: appStore },
+            react_1.default.createElement(haystack_react_1.ClientContext.Provider, { value: containerClient },
+                react_1.default.createElement(utils_1.I18NProvider, { locale: locale, setLoading: setLoadingi18n },
+                    react_1.default.createElement(react_jss_1.ThemeProvider, { theme: theme },
+                        react_1.default.createElement(Loader_1.default, { loading: loading || loadingi18n },
+                            react_1.default.createElement(ErrorBoundary_1.ErrorBoundary, { mode: "global" /* ErrorBoundaryMode.global */ }, children))))))));
+});
 //# sourceMappingURL=Fin5AppContainer.js.map