@j2inn/fin5-ui-utils 0.0.2 → 0.0.5-beta.1

package/dist_es/fin5Top/fin5Top.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fin5Top.js","sourceRoot":"","sources":["../../src/fin5Top/fin5Top.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,gBAAgB;IACb,MAAM,CAAC,QAAQ,CAAgB;IAEvC,MAAM,KAAK,OAAO;QACjB,OAAO,IAAI,CAAC,UAAU,EAAE,CAAA;IACzB,CAAC;IACD,MAAM,CAAC,UAAU,GAAG,CAAC,aAA0B,EAAkB,EAAE;QAClE,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE;YAChC,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,aAAa,CAAC;gBAC7C,CAAC,CAAE,MAAM,CAAC,GAA0B,CAAC,uEAAuE;gBAC5G,CAAC,CAAC,IAAI,CAAA;SACP;QACD,OAAO,IAAI,CAAC,QAAQ,CAAA;IACrB,CAAC,CAAA;;AAGF,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAA;AAErD,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAA;AAE/C,MAAM,UAAU,eAAe,CAAC,aAA0B;IACzD,IAAI;QACH,MAAM,EAAE,GAAG,EAAE,MAAM,CAAA;QACnB,IAAK,MAAM,CAAC,GAA0B,CAAC,QAAQ,EAAE;YAChD,OAAO,IAAI,CAAA;SACX;aAAM;YACN,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;SAC1C;KACD;IAAC,OAAO,GAAG,EAAE;QACb,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjB,aAAa,EAAE,EAAE,CAAA;QACjB,OAAO,KAAK,CAAA;KACZ;AACF,CAAC;AA8GD,MAAM,CAAN,IAAY,YAiBX;AAjBD,WAAY,YAAY;IACvB,+BAAe,CAAA;IACf,qCAAqB,CAAA;IACrB,iCAAiB,CAAA;IACjB,iCAAiB,CAAA;IACjB,+BAAe,CAAA;IACf,mCAAmB,CAAA;IACnB,8CAA8B,CAAA;IAC9B,+BAAe,CAAA;IACf,uCAAuB,CAAA;IACvB,8CAA8B,CAAA;IAC9B,oCAAoB,CAAA;IACpB,wCAAwB,CAAA;IACxB,iCAAiB,CAAA;IACjB,iCAAiB,CAAA;IACjB,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;AACpB,CAAC,EAjBW,YAAY,KAAZ,YAAY,QAiBvB"}

package/dist_es/fin5Top/getFin5BinUrl.d.ts

@@ -0,0 +1,2 @@
+import { HRef } from 'haystack-core';
+export declare const getFin5BinUrl: (id: HRef) => string;

package/dist_es/fin5Top/getFin5BinUrl.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright (c) 2022, J2 Innovations. All Rights Reserved
+ */
+import { fin5Top } from './fin5Top';
+export const getFin5BinUrl = (id) => `/finGetFile/${fin5Top?.finstack?.projectName}?fileRef=${id?.toString()}`;
+//# sourceMappingURL=getFin5BinUrl.js.map

package/dist_es/fin5Top/getFin5BinUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFin5BinUrl.js","sourceRoot":"","sources":["../../src/fin5Top/getFin5BinUrl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAQ,EAAU,EAAE,CACjD,eAAe,OAAO,EAAE,QAAQ,EAAE,WAAW,YAAY,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAA"}

package/dist_es/fin5Top/openFin5Alarm.d.ts

@@ -0,0 +1,22 @@
+import { TargetRef } from './fin5Top';
+export interface AlarmFilterTypes {
+    alarms: boolean;
+    events: boolean;
+    acks: boolean;
+}
+export interface AlarmFilter {
+    range?: string;
+    priorityThreshold?: string;
+    acked?: boolean;
+    unacked?: boolean;
+    inAlarm?: boolean;
+    notInAlarm?: boolean;
+    search?: string;
+    types?: AlarmFilterTypes;
+}
+export declare type AlarmOptions = {
+    targetRef?: TargetRef;
+    filter: AlarmFilter;
+    historical?: boolean;
+};
+export declare const openFin5AlarmsApp: ({ targetRef, filter, historical, }: AlarmOptions) => Promise<void>;

package/dist_es/fin5Top/openFin5Alarm.js

@@ -0,0 +1,20 @@
+/*
+ * Copyright (c) 2022, J2 Innovations. All Rights Reserved
+ */
+//////////////////////////////////////////////////////////////////////////
+// Alarms
+//////////////////////////////////////////////////////////////////////////
+import { fin5Top } from './fin5Top';
+export const openFin5AlarmsApp = async ({ targetRef, filter, historical = false, }) => {
+    await fin5Top?.app.NavigateToApp(fin5Top?.app?.APP_NAMES?.ALARMS, targetRef);
+    fin5Top?.app.ToggleCollapse(false);
+    let alarmFilters = fin5Top?.app?.GetAlarmFilters() ?? {};
+    if (filter) {
+        alarmFilters = {
+            ...alarmFilters,
+            ...filter,
+        };
+    }
+    fin5Top?.app?.SetAlarmFilters(alarmFilters, historical);
+};
+//# sourceMappingURL=openFin5Alarm.js.map

package/dist_es/fin5Top/openFin5Alarm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openFin5Alarm.js","sourceRoot":"","sources":["../../src/fin5Top/openFin5Alarm.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0EAA0E;AAC1E,SAAS;AACT,0EAA0E;AAE1E,OAAO,EAAE,OAAO,EAAa,MAAM,WAAW,CAAA;AAyB9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,EACvC,SAAS,EACT,MAAM,EACN,UAAU,GAAG,KAAK,GACJ,EAAiB,EAAE;IACjC,MAAM,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;IAC5E,OAAO,EAAE,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;IAElC,IAAI,YAAY,GAAG,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,CAAA;IACxD,IAAI,MAAM,EAAE;QACX,YAAY,GAAG;YACd,GAAG,YAAY;YACf,GAAG,MAAM;SACT,CAAA;KACD;IAED,OAAO,EAAE,GAAG,EAAE,eAAe,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;AACxD,CAAC,CAAA"}

package/dist_es/fin5Top/openFin5Historian.d.ts

@@ -0,0 +1,3 @@
+export declare type HistorianType = 'point' | 'query' | 'string';
+export declare type HistorianArgs = string | (string | undefined)[];
+export declare const openFin5HistorianApp: (queryType?: HistorianType, args?: HistorianArgs) => Promise<void>;

package/dist_es/fin5Top/openFin5Historian.js

@@ -0,0 +1,16 @@
+/*
+ * Copyright (c) 2022, J2 Innovations. All Rights Reserved
+ */
+//////////////////////////////////////////////////////////////////////////
+// Historian
+//////////////////////////////////////////////////////////////////////////
+import { fin5Top } from './fin5Top';
+export const openFin5HistorianApp = async (queryType, args) => {
+    if (fin5Top) {
+        queryType && args
+            ? fin5Top.app.OpenHistorianWithOptions(queryType, args)
+            : fin5Top.app.NavigateToApp(fin5Top.app.APP_NAMES.TREND_LIST);
+        fin5Top?.app.ToggleCollapse(false);
+    }
+};
+//# sourceMappingURL=openFin5Historian.js.map

package/dist_es/fin5Top/openFin5Historian.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openFin5Historian.js","sourceRoot":"","sources":["../../src/fin5Top/openFin5Historian.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0EAA0E;AAC1E,YAAY;AACZ,0EAA0E;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACxC,SAAyB,EACzB,IAAoB,EACJ,EAAE;IAClB,IAAI,OAAO,EAAE;QACZ,SAAS,IAAI,IAAI;YAChB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,SAAS,EAAE,IAAI,CAAC;YACvD,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QAC9D,OAAO,EAAE,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;KAClC;AACF,CAAC,CAAA"}

package/dist_es/fin5Top/useFin5AppURLHashParameter.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Use a parameter in the hash of a custom app running in FIN 5 as state.
+ * @param name parameter name.
+ * @param initialState initial state used if the parameter is not defined.
+ * @returns the parameter value and a function to update it.
+ */
+export declare const useFin5AppURLHashParameter: (name: string, initialState?: string) => [string | undefined, (newValue: string) => void];

package/dist_es/fin5Top/useFin5AppURLHashParameter.js

@@ -0,0 +1,68 @@
+/*
+ * Copyright (c) 2022, J2 Innovations. All Rights Reserved
+ */
+import { useEffect, useState } from 'react';
+const IN_IFRAME = window !== top;
+const getTop = () => window.top ?? window;
+const getApp = () => getTop()?.app;
+const getTopLocation = () => getTop().location;
+const getFin5HashFrameParameters = () => new URLSearchParams(getTopLocation().hash.slice(1).split('?')[1]);
+const getFin5FrameURL = () => getFin5HashFrameParameters().get('url');
+const getPartialURLHashFragment = (url) => `#${url?.split('#')[1] ?? ''}`;
+const getHash = () => {
+    return IN_IFRAME
+        ? getPartialURLHashFragment(getFin5FrameURL())
+        : window.location.hash;
+};
+const fin5SkipHashUpdate = () => getApp()?.set('skipHashUpdate', true);
+const setHash = (hash) => {
+    if (IN_IFRAME) {
+        fin5SkipHashUpdate()?.then(() => {
+            const frameParameters = getFin5HashFrameParameters();
+            frameParameters.set('url', frameParameters.get('url')?.split('#')[0] + '#' + hash);
+            getTopLocation().hash = `#${getTopLocation().hash.slice(1).split('?')[0]}?${frameParameters.toString()}`;
+        });
+    }
+    else {
+        window.location.hash = hash;
+    }
+};
+const getHashParameters = () => new URLSearchParams(getHash().slice(1));
+/**
+ * Use a parameter in the hash of a custom app running in FIN 5 as state.
+ * @param name parameter name.
+ * @param initialState initial state used if the parameter is not defined.
+ * @returns the parameter value and a function to update it.
+ */
+export const useFin5AppURLHashParameter = (name, initialState) => {
+    const [paramValue, setParamValue] = useState(getHashParameters()?.get(name) ?? undefined);
+    const setHashParameter = (value) => {
+        const params = getHashParameters();
+        if (params.get(name) !== value) {
+            if (value === '' || value == null) {
+                params.delete(name);
+            }
+            else {
+                params?.set(name, value);
+            }
+            setHash(params?.toString());
+            setParamValue(value);
+        }
+    };
+    useEffect(() => {
+        if (!getHashParameters()?.has(name) && initialState) {
+            setHashParameter(initialState);
+        }
+    }, []);
+    useEffect(() => {
+        const onHashChange = () => {
+            setParamValue(getHashParameters()?.get(name) ?? undefined);
+        };
+        getTop().addEventListener('hashchange', onHashChange);
+        return () => {
+            getTop().removeEventListener('hashchange', onHashChange);
+        };
+    }, []);
+    return [paramValue, setHashParameter];
+};
+//# sourceMappingURL=useFin5AppURLHashParameter.js.map

package/dist_es/fin5Top/useFin5AppURLHashParameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFin5AppURLHashParameter.js","sourceRoot":"","sources":["../../src/fin5Top/useFin5AppURLHashParameter.ts"],"names":[],"mappings":"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"}

package/dist_es/index.d.ts

@@ -0,0 +1,18 @@
+export * from './fantomProps/fantomPropsToObject';
+export * from './fantomProps/generateJsonFromFantomPropsFile';
+export * from './fantomProps/readFantomPropsFile';
+export * from './fantomProps/createFin5Props';
+export * from './fin5Top/fin5Top';
+export * from './fin5Top/getFin5BinUrl';
+export * from './fin5Top/openFin5Alarm';
+export * from './fin5Top/openFin5Historian';
+export * from './fin5Top/useFin5AppURLHashParameter';
+export * from './react/components/ErrorDisplayer';
+export * from './react/components/ErrorBoundary';
+export * from './react/components/Loader';
+export * from './react/components/LoadingSpinner';
+export * from './react/components/navigation/BasicLayout';
+export * from './react/components/navigation/MenuPage';
+export * from './react/components/navigation/Router';
+export * from './react/app/Fin5AppContainer';
+export * from './react/app/Fin5AppRootStore';

package/dist_es/index.js

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2022, J2 Innovations. All Rights Reserved
+ */
+//////////////////////////////////////////////////////////////////////////
+// Fantom Props
+//////////////////////////////////////////////////////////////////////////
+export * from './fantomProps/fantomPropsToObject';
+export * from './fantomProps/generateJsonFromFantomPropsFile';
+export * from './fantomProps/readFantomPropsFile';
+export * from './fantomProps/createFin5Props';
+//////////////////////////////////////////////////////////////////////////
+// Fin5 APIs related modules
+//////////////////////////////////////////////////////////////////////////
+export * from './fin5Top/fin5Top';
+export * from './fin5Top/getFin5BinUrl';
+export * from './fin5Top/openFin5Alarm';
+export * from './fin5Top/openFin5Historian';
+export * from './fin5Top/useFin5AppURLHashParameter';
+//////////////////////////////////////////////////////////////////////////
+// React components
+//////////////////////////////////////////////////////////////////////////
+export * from './react/components/ErrorDisplayer';
+export * from './react/components/ErrorBoundary';
+export * from './react/components/Loader';
+export * from './react/components/LoadingSpinner';
+export * from './react/components/navigation/BasicLayout';
+export * from './react/components/navigation/MenuPage';
+export * from './react/components/navigation/Router';
+//////////////////////////////////////////////////////////////////////////
+// j2inn/app support for FIN5
+//////////////////////////////////////////////////////////////////////////
+export * from './react/app/Fin5AppContainer';
+export * from './react/app/Fin5AppRootStore';
+//# sourceMappingURL=index.js.map

package/dist_es/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0EAA0E;AAC1E,eAAe;AACf,0EAA0E;AAE1E,cAAc,mCAAmC,CAAA;AACjD,cAAc,+CAA+C,CAAA;AAC7D,cAAc,mCAAmC,CAAA;AACjD,cAAc,+BAA+B,CAAA;AAE7C,0EAA0E;AAC1E,4BAA4B;AAC5B,0EAA0E;AAE1E,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,sCAAsC,CAAA;AAEpD,0EAA0E;AAC1E,mBAAmB;AACnB,0EAA0E;AAE1E,cAAc,mCAAmC,CAAA;AACjD,cAAc,kCAAkC,CAAA;AAChD,cAAc,2BAA2B,CAAA;AACzC,cAAc,mCAAmC,CAAA;AACjD,cAAc,2CAA2C,CAAA;AACzD,cAAc,wCAAwC,CAAA;AACtD,cAAc,sCAAsC,CAAA;AAEpD,0EAA0E;AAC1E,6BAA6B;AAC7B,0EAA0E;AAE1E,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA"}

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

@@ -0,0 +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;
+};

package/dist_es/react/app/Fin5AppContainer.jsx

@@ -0,0 +1,73 @@
+/*
+ * Copyright (c) 2022, J2 Innovations. All Rights Reserved
+ */
+import React, { useEffect, useRef, useState } from 'react';
+import { AppRootStoreContext, AppStoreContext } from '@j2inn/app';
+import { observer } from 'mobx-react-lite';
+import { Fin5AppRootStore } from './Fin5AppRootStore';
+import { Client } from 'haystack-nclient';
+import { ClientContext } from 'haystack-react';
+import { I18NProvider } from '@j2inn/utils';
+import { ThemeProvider } from 'react-jss';
+import { DEFAULT_THEME, GenerateTheme } from '@j2inn/ui';
+import { fin5Top } from '../../fin5Top/fin5Top';
+import { useFin5AppURLHashParameter } from '../../fin5Top/useFin5AppURLHashParameter';
+import { HRef } from 'haystack-core';
+import { ErrorBoundary } from '../components/ErrorBoundary';
+import Loader from '../components/Loader';
+/**
+ * Creates a basic application container environment to run a view in FIN5.
+ */
+export const Fin5AppContainer = observer(({ children, appStore, client, project, theme = GenerateTheme(DEFAULT_THEME).light, }) => {
+    const [loading, setLoading] = useState(true);
+    const [loadingi18n, setLoadingi18n] = useState(true);
+    const rootStoreRef = useRef(null);
+    const rootStore = rootStoreRef.current ??
+        (rootStoreRef.current = new Fin5AppRootStore());
+    const [hashProjName] = useFin5AppURLHashParameter('projectName');
+    const containerProject = project || hashProjName || fin5Top?.finstack?.projectName || '';
+    const locale = fin5Top?.languageManager?.currentLang ?? navigator?.language;
+    rootStore.locale = locale;
+    if (!rootStore.allLocales.includes(locale)) {
+        rootStore.allLocales.push(locale);
+    }
+    const target = fin5Top?.app?.TargetRef?.() || '';
+    rootStore.target = target ? HRef.make(target).value : '';
+    const getClient = () => client ??
+        new Client({
+            base: new URL(window.location.href),
+            project: containerProject,
+            options: { headers: { accept: 'text/zinc' } },
+        });
+    const [containerClient, setContainerClient] = useState(getClient);
+    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]);
+    return (<AppRootStoreContext.Provider value={rootStore}>
+				<AppStoreContext.Provider value={appStore}>
+					<ClientContext.Provider value={containerClient}>
+						<I18NProvider locale={locale} setLoading={setLoadingi18n}>
+							<ThemeProvider theme={theme}>
+								<Loader loading={loading || loadingi18n}>
+									<ErrorBoundary mode={"global" /* ErrorBoundaryMode.global */}>
+										{children}
+									</ErrorBoundary>
+								</Loader>
+							</ThemeProvider>
+						</I18NProvider>
+					</ClientContext.Provider>
+				</AppStoreContext.Provider>
+			</AppRootStoreContext.Provider>);
+});
+//# sourceMappingURL=Fin5AppContainer.jsx.map

package/dist_es/react/app/Fin5AppContainer.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fin5AppContainer.jsx","sourceRoot":"","sources":["../../../src/react/app/Fin5AppContainer.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAY,eAAe,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAY,MAAM,WAAW,CAAA;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAA;AACrF,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,aAAa,EAAqB,MAAM,6BAA6B,CAAA;AAC9E,OAAO,MAAM,MAAM,sBAAsB,CAAA;AAiCzC;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CACvC,CAAC,EACA,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC,KAAK,GACnB,EAAe,EAAE;IACxC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAEpD,MAAM,YAAY,GAAG,MAAM,CAA0B,IAAI,CAAC,CAAA;IAC1D,MAAM,SAAS,GACd,YAAY,CAAC,OAAO;QACpB,CAAC,YAAY,CAAC,OAAO,GAAG,IAAI,gBAAgB,EAAE,CAAC,CAAA;IAEhD,MAAM,CAAC,YAAY,CAAC,GAAG,0BAA0B,CAAC,aAAa,CAAC,CAAA;IAEhE,MAAM,gBAAgB,GACrB,OAAO,IAAI,YAAY,IAAI,OAAO,EAAE,QAAQ,EAAE,WAAW,IAAI,EAAE,CAAA;IAEhE,MAAM,MAAM,GACX,OAAO,EAAE,eAAe,EAAE,WAAW,IAAI,SAAS,EAAE,QAAQ,CAAA;IAE7D,SAAS,CAAC,MAAM,GAAG,MAAM,CAAA;IACzB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAC3C,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;KACjC;IAED,MAAM,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAA;IAChD,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IAExD,MAAM,SAAS,GAAG,GAAG,EAAE,CACtB,MAAM;QACN,IAAI,MAAM,CAAC;YACV,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YACnC,OAAO,EAAE,gBAAgB;YACzB,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;SAC7C,CAAC,CAAA;IAEH,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAC1C,QAAQ,CAAS,SAAS,CAAC,CAAA;IAE5B,SAAS,CAAC,GAAG,EAAE;QACd,UAAU,CAAC,IAAI,CAAC,CAAA;QAEhB,MAAM,SAAS,GAAG,SAAS,EAAE,CAAA;QAC7B,kBAAkB,CAAC,SAAS,CAAC,CAAA;QAE7B,8CAA8C;QAC9C,mBAAmB;QACnB,OAAO,CAAC,GAAG,CAAC;YACX,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC;YACzC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE;SACxB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE;YACtB,SAAS,CAAC,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAA;YACtC,UAAU,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;IAE9B,OAAO,CACN,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAC9C;IAAA,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CACzC;KAAA,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,CAC9C;MAAA,CAAC,YAAY,CACZ,MAAM,CAAC,CAAC,MAAM,CAAC,CACf,UAAU,CAAC,CAAC,cAAc,CAAC,CAC3B;OAAA,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAC3B;QAAA,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,IAAI,WAAW,CAAC,CACvC;SAAA,CAAC,aAAa,CACb,IAAI,CAAC,yCAA0B,CAC/B;UAAA,CAAC,QAAQ,CACV;SAAA,EAAE,aAAa,CAChB;QAAA,EAAE,MAAM,CACT;OAAA,EAAE,aAAa,CAChB;MAAA,EAAE,YAAY,CACf;KAAA,EAAE,aAAa,CAAC,QAAQ,CACzB;IAAA,EAAE,eAAe,CAAC,QAAQ,CAC3B;GAAA,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAC/B,CAAA;AACF,CAAC,CACD,CAAA"}

package/dist_es/react/app/Fin5AppRootStore.d.ts

@@ -0,0 +1,38 @@
+import { AppRootStore, App, AppView, CustomHistory, AppAccessLevel } from '@j2inn/app';
+import { HDict } from 'haystack-core';
+/**
+ * An application root store for use with FIN5.
+ */
+export declare class Fin5AppRootStore implements AppRootStore {
+    constructor();
+    get app(): {
+        id: string;
+        name: string;
+        app: App;
+        view: AppView;
+    } | undefined;
+    get sidebar(): {
+        id: string;
+        name: string;
+        app: App;
+        view: AppView;
+    } | undefined;
+    readonly apps: App[];
+    project: string;
+    sidebarOpen: boolean;
+    open(): void;
+    openSidebar(): void;
+    locale: string;
+    allLocales: string[];
+    target: string;
+    targetSidebar: string;
+    readonly history: CustomHistory;
+    readonly historySidebar: CustomHistory;
+    currentUser: HDict | undefined;
+    postAppMessage(): void;
+    registerQuicklinks(): void;
+    unregisterQuicklinks(): void;
+    registerSidebars(): void;
+    unregisterSidebars(): void;
+    hasAppAccess: (_: string, access: AppAccessLevel) => boolean;
+}

package/dist_es/react/app/Fin5AppRootStore.js

@@ -0,0 +1,62 @@
+/*
+ * Copyright (c) 2022, J2 Innovations. All Rights Reserved
+ */
+import { makeAutoObservable, observable } from 'mobx';
+/**
+ * An application root store for use with FIN5.
+ */
+export class Fin5AppRootStore {
+    constructor() {
+        makeAutoObservable(this, {
+            currentUser: observable.ref,
+            apps: observable.ref,
+        });
+    }
+    get app() {
+        return undefined;
+    }
+    get sidebar() {
+        return undefined;
+    }
+    apps = [];
+    project = '';
+    sidebarOpen = false;
+    open() { }
+    openSidebar() { }
+    locale = '';
+    allLocales = [];
+    target = '';
+    targetSidebar = '';
+    history = {
+        state: {},
+        pushState: (state) => {
+            this.history.state = state;
+        },
+        replaceState: (state) => {
+            this.history.state = state;
+        },
+    };
+    historySidebar = {
+        state: {},
+        pushState: (state) => {
+            this.historySidebar.state = state;
+        },
+        replaceState: (state) => {
+            this.historySidebar.state = state;
+        },
+    };
+    currentUser;
+    postAppMessage() { }
+    registerQuicklinks() { }
+    unregisterQuicklinks() { }
+    registerSidebars() { }
+    unregisterSidebars() { }
+    hasAppAccess = (_, access) => {
+        // For FIN5, an operator only has readonly app level access.
+        const user = this.currentUser;
+        return user?.get('userRole')?.value === 'op'
+            ? access === 'read'
+            : !!user;
+    };
+}
+//# sourceMappingURL=Fin5AppRootStore.js.map

package/dist_es/react/app/Fin5AppRootStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fin5AppRootStore.js","sourceRoot":"","sources":["../../../src/react/app/Fin5AppRootStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAErD;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC5B;QACC,kBAAkB,CAAC,IAAI,EAAE;YACxB,WAAW,EAAE,UAAU,CAAC,GAAG;YAC3B,IAAI,EAAE,UAAU,CAAC,GAAG;SACpB,CAAC,CAAA;IACH,CAAC;IAED,IAAI,GAAG;QAGN,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,IAAI,OAAO;QAGV,OAAO,SAAS,CAAA;IACjB,CAAC;IAEQ,IAAI,GAAU,EAAE,CAAA;IAEzB,OAAO,GAAG,EAAE,CAAA;IAEZ,WAAW,GAAG,KAAK,CAAA;IAEnB,IAAI,KAAU,CAAC;IAEf,WAAW,KAAU,CAAC;IAEtB,MAAM,GAAG,EAAE,CAAA;IAEX,UAAU,GAAa,EAAE,CAAA;IAEzB,MAAM,GAAG,EAAE,CAAA;IAEX,aAAa,GAAG,EAAE,CAAA;IAET,OAAO,GAAkB;QACjC,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,CAAC,KAA8B,EAAQ,EAAE;YACnD,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAA;QAC3B,CAAC;QACD,YAAY,EAAE,CAAC,KAA8B,EAAQ,EAAE;YACtD,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAA;QAC3B,CAAC;KACD,CAAA;IAEQ,cAAc,GAAkB;QACxC,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,CAAC,KAA8B,EAAQ,EAAE;YACnD,IAAI,CAAC,cAAc,CAAC,KAAK,GAAG,KAAK,CAAA;QAClC,CAAC;QACD,YAAY,EAAE,CAAC,KAA8B,EAAQ,EAAE;YACtD,IAAI,CAAC,cAAc,CAAC,KAAK,GAAG,KAAK,CAAA;QAClC,CAAC;KACD,CAAA;IAED,WAAW,CAAmB;IAE9B,cAAc,KAAU,CAAC;IAEzB,kBAAkB,KAAU,CAAC;IAE7B,oBAAoB,KAAU,CAAC;IAE/B,gBAAgB,KAAU,CAAC;IAE3B,kBAAkB,KAAU,CAAC;IAE7B,YAAY,GAAG,CAAC,CAAS,EAAE,MAAsB,EAAW,EAAE;QAC7D,4DAA4D;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAA;QAE7B,OAAO,IAAI,EAAE,GAAG,CAAO,UAAU,CAAC,EAAE,KAAK,KAAK,IAAI;YACjD,CAAC,CAAC,MAAM,KAAK,MAAM;YACnB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACV,CAAC,CAAA;CACD"}

package/dist_es/react/components/ErrorBoundary.d.ts

@@ -0,0 +1,57 @@
+import React, { ErrorInfo, ReactNode } from 'react';
+/**
+ * An error boundary can work at the global level (where something really screws up)
+ * or an an app level (where the error is captured just for the running application).
+ */
+export declare const enum ErrorBoundaryMode {
+    global = "global",
+    app = "app"
+}
+/**
+ * The properties for an error boundary.
+ */
+interface ErrorBoundaryProps {
+    /**
+     * The associated application id.
+     */
+    appId?: string;
+    /**
+     * The error mode.
+     */
+    mode: ErrorBoundaryMode;
+    /**
+     * Optional callback to display a report dialog.
+     */
+    showReportDialog?: () => void;
+    /**
+     * Optional callback used to capture the error.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Child components.
+     */
+    children?: React.ReactNode;
+}
+/**
+ * The state for an error boundary.
+ */
+interface ErrorBoundryState {
+    /**
+     * The last captured error.
+     */
+    error?: Error;
+}
+/**
+ * A common error boundary used to capture errors.
+ */
+export declare class ErrorBoundary extends React.Component<ErrorBoundaryProps, ErrorBoundryState> {
+    state: {
+        error?: Error;
+    };
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    static getDerivedStateFromError(error: Error): {
+        error: Error;
+    };
+    render(): ReactNode | JSX.Element;
+}
+export {};