@j2inn/fin5-ui-utils 8.2.0 → 8.3.0

package/dist_es/fin5Top/finEdge2Cloud.js

@@ -1,12 +1,12 @@
-import { finCsrfFetch } from 'haystack-nclient';
-/**
- * Get the URI to register the FIN instance to Edge2Cloud.
- * The URI can be used to provide a link, or to create the registration QR code.
- * @returns the URI as a string
- */
-export const getEdge2CloudRegistrationUri = async () => {
-    const response = await finCsrfFetch('/finEdge2Cloud/devreg');
-    const json = await response.json();
-    return json.uri;
-};
+import { finCsrfFetch } from 'haystack-nclient';
+/**
+ * Get the URI to register the FIN instance to Edge2Cloud.
+ * The URI can be used to provide a link, or to create the registration QR code.
+ * @returns the URI as a string
+ */
+export const getEdge2CloudRegistrationUri = async () => {
+    const response = await finCsrfFetch('/finEdge2Cloud/devreg');
+    const json = await response.json();
+    return json.uri;
+};
 //# sourceMappingURL=finEdge2Cloud.js.map

package/dist_es/fin5Top/getFin5BinUrl.d.ts

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

package/dist_es/fin5Top/getFin5BinUrl.js

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

package/dist_es/fin5Top/openFin5Alarm.d.ts

@@ -1,22 +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>;
+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

@@ -1,20 +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);
-};
+/*
+ * 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/openFin5Historian.d.ts

@@ -1,3 +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>;
+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

@@ -1,16 +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);
-    }
-};
+/*
+ * 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/useFin5AppURLHashParameter.d.ts

@@ -1,18 +1,18 @@
-export declare const IN_IFRAME: boolean;
-export declare const getTopLocation: () => Location;
-export declare const getFin5HashFrameParameters: () => URLSearchParams;
-export declare const fin5SkipHashUpdate: () => Promise<undefined> | undefined;
-export declare const getHashParameters: () => URLSearchParams;
-/**
- * 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) => Promise<void>];
-/**
- * Use all the parameters in the hash of a custom app running in FIN 5 as state.
- * @param parameters the initial (optional) values for the parameters
- * @returns the URL parameters and a function to patch the parameters.
- */
-export declare const useFin5AppURLHashParameters: (parameters?: URLSearchParams) => [URLSearchParams, (newValues: URLSearchParams) => Promise<void>];
+export declare const IN_IFRAME: boolean;
+export declare const getTopLocation: () => Location;
+export declare const getFin5HashFrameParameters: () => URLSearchParams;
+export declare const fin5SkipHashUpdate: () => Promise<undefined> | undefined;
+export declare const getHashParameters: () => URLSearchParams;
+/**
+ * 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) => Promise<void>];
+/**
+ * Use all the parameters in the hash of a custom app running in FIN 5 as state.
+ * @param parameters the initial (optional) values for the parameters
+ * @returns the URL parameters and a function to patch the parameters.
+ */
+export declare const useFin5AppURLHashParameters: (parameters?: URLSearchParams) => [URLSearchParams, (newValues: URLSearchParams) => Promise<void>];

package/dist_es/fin5Top/useFin5AppURLHashParameter.js

@@ -1,125 +1,125 @@
-/*
- * Copyright (c) 2022, J2 Innovations. All Rights Reserved
- */
-import { useEffect, useState } from 'react';
-import { isWindowTopFin5 } from './fin5Top';
-export const IN_IFRAME = window !== top && isWindowTopFin5();
-const getTop = () => window.top ?? window;
-const getApp = () => getTop()?.app;
-export const getTopLocation = () => getTop().location;
-export 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;
-};
-export const fin5SkipHashUpdate = () => getApp()?.set('skipHashUpdate', true);
-const setHash = (hash) => {
-    if (IN_IFRAME) {
-        return 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;
-        return Promise.resolve();
-    }
-};
-export 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 = async (value) => {
-        const params = getHashParameters();
-        if (params.get(name) !== value) {
-            if (value === '' || value == null) {
-                params.delete(name);
-            }
-            else {
-                params?.set(name, value);
-            }
-            await setHash(params?.toString());
-            setParamValue(value);
-        }
-    };
-    useEffect(() => {
-        if (!getHashParameters()?.has(name) && initialState) {
-            setHashParameter(initialState);
-        }
-    }, []);
-    useEffect(() => {
-        const onHashChange = () => {
-            setParamValue(getHashParameters()?.get(name) ?? undefined);
-        };
-        if (IN_IFRAME) {
-            getTop().addEventListener('hashchange', onHashChange);
-            return () => {
-                getTop().removeEventListener('hashchange', onHashChange);
-            };
-        }
-        return () => {
-            return;
-        };
-    }, []);
-    return [paramValue, setHashParameter];
-};
-/**
- * Use all the parameters in the hash of a custom app running in FIN 5 as state.
- * @param parameters the initial (optional) values for the parameters
- * @returns the URL parameters and a function to patch the parameters.
- */
-export const useFin5AppURLHashParameters = (parameters) => {
-    const [paramValues, setParamValues] = useState(getHashParameters());
-    // Patch the parameters: this updates just the URL parameters passed.
-    // If there is a parameter in the hash and not in the function arg, that is left untouched.
-    // To remove a parameter in the hash, set it to null or empty string.
-    const setHashParameters = async (paramsToUpdate) => {
-        const params = getHashParameters();
-        Array.from(paramsToUpdate.entries()).forEach(([paramKey, newParamValue]) => {
-            if (newParamValue !== params.get(paramKey)) {
-                if (newParamValue == null || newParamValue === '') {
-                    params.delete(paramKey);
-                }
-                else {
-                    params.set(paramKey, newParamValue);
-                }
-            }
-        });
-        await setHash(params.toString());
-        setParamValues(params);
-    };
-    // Initial setup.
-    useEffect(() => {
-        const hashParameters = getHashParameters();
-        if (parameters) {
-            Array.from(parameters.entries()).forEach(([paramKey, paramValue]) => {
-                if (!hashParameters.has(paramKey) &&
-                    paramValue != null &&
-                    paramValue !== '') {
-                    hashParameters.set(paramKey, paramValue);
-                }
-            });
-            setHashParameters(hashParameters);
-        }
-    }, []);
-    useEffect(() => {
-        const onHashChange = () => {
-            setParamValues(getHashParameters());
-        };
-        getTop().addEventListener('hashchange', onHashChange);
-        return () => {
-            getTop().removeEventListener('hashchange', onHashChange);
-        };
-    }, []);
-    return [paramValues, setHashParameters];
-};
+/*
+ * Copyright (c) 2022, J2 Innovations. All Rights Reserved
+ */
+import { useEffect, useState } from 'react';
+import { isWindowTopFin5 } from './fin5Top';
+export const IN_IFRAME = window !== top && isWindowTopFin5();
+const getTop = () => window.top ?? window;
+const getApp = () => getTop()?.app;
+export const getTopLocation = () => getTop().location;
+export 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;
+};
+export const fin5SkipHashUpdate = () => getApp()?.set('skipHashUpdate', true);
+const setHash = (hash) => {
+    if (IN_IFRAME) {
+        return 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;
+        return Promise.resolve();
+    }
+};
+export 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 = async (value) => {
+        const params = getHashParameters();
+        if (params.get(name) !== value) {
+            if (value === '' || value == null) {
+                params.delete(name);
+            }
+            else {
+                params?.set(name, value);
+            }
+            await setHash(params?.toString());
+            setParamValue(value);
+        }
+    };
+    useEffect(() => {
+        if (!getHashParameters()?.has(name) && initialState) {
+            setHashParameter(initialState);
+        }
+    }, []);
+    useEffect(() => {
+        const onHashChange = () => {
+            setParamValue(getHashParameters()?.get(name) ?? undefined);
+        };
+        if (IN_IFRAME) {
+            getTop().addEventListener('hashchange', onHashChange);
+            return () => {
+                getTop().removeEventListener('hashchange', onHashChange);
+            };
+        }
+        return () => {
+            return;
+        };
+    }, []);
+    return [paramValue, setHashParameter];
+};
+/**
+ * Use all the parameters in the hash of a custom app running in FIN 5 as state.
+ * @param parameters the initial (optional) values for the parameters
+ * @returns the URL parameters and a function to patch the parameters.
+ */
+export const useFin5AppURLHashParameters = (parameters) => {
+    const [paramValues, setParamValues] = useState(getHashParameters());
+    // Patch the parameters: this updates just the URL parameters passed.
+    // If there is a parameter in the hash and not in the function arg, that is left untouched.
+    // To remove a parameter in the hash, set it to null or empty string.
+    const setHashParameters = async (paramsToUpdate) => {
+        const params = getHashParameters();
+        Array.from(paramsToUpdate.entries()).forEach(([paramKey, newParamValue]) => {
+            if (newParamValue !== params.get(paramKey)) {
+                if (newParamValue == null || newParamValue === '') {
+                    params.delete(paramKey);
+                }
+                else {
+                    params.set(paramKey, newParamValue);
+                }
+            }
+        });
+        await setHash(params.toString());
+        setParamValues(params);
+    };
+    // Initial setup.
+    useEffect(() => {
+        const hashParameters = getHashParameters();
+        if (parameters) {
+            Array.from(parameters.entries()).forEach(([paramKey, paramValue]) => {
+                if (!hashParameters.has(paramKey) &&
+                    paramValue != null &&
+                    paramValue !== '') {
+                    hashParameters.set(paramKey, paramValue);
+                }
+            });
+            setHashParameters(hashParameters);
+        }
+    }, []);
+    useEffect(() => {
+        const onHashChange = () => {
+            setParamValues(getHashParameters());
+        };
+        getTop().addEventListener('hashchange', onHashChange);
+        return () => {
+            getTop().removeEventListener('hashchange', onHashChange);
+        };
+    }, []);
+    return [paramValues, setHashParameters];
+};
 //# sourceMappingURL=useFin5AppURLHashParameter.js.map

package/dist_es/index.d.ts

@@ -1,35 +1,35 @@
-export * from './fin5Top/fin5FileUpload';
-export * from './fin5Top/fin5Top';
-export * from './fin5Top/finEdge2Cloud';
-export * from './fin5Top/getFin5BinUrl';
-export * from './fin5Top/openFin5Alarm';
-export * from './fin5Top/openFin5Historian';
-export * from './fin5Top/useFin5AppURLHashParameter';
-export * from './jobs/jobUtils';
-export * from './react/components/ErrorBoundary';
-export * from './react/components/ErrorDisplayer';
-export * from './react/components/Loader';
-export * from './react/components/LoadingSpinner';
-export * from './react/components/graphics/GraphicViewer';
-export * from './react/components/graphics/GraphicsTabViewer';
-export * from './react/components/navigation/BasicLayout';
-export * from './react/components/navigation/MenuPage';
-export * from './react/components/navigation/ReactRouterLayout';
-export * from './react/components/navigation/ReactRouterHeaderSiderLayout';
-export * from './react/components/navigation/customRouting/RouterLayout';
-export * from './react/components/navigation/customRouting/Router';
-export * from './react/components/resolvable/configurationForm/ConfigurationForm';
-export * from './react/components/resolvable/configurationForm/ConfigurationFormEntry';
-export * from './react/components/resolvable/configurationForm/getSectionDefault';
-export * from './react/components/RecordImage';
-export * from './react/components/charts/QRCode';
-export * from './react/components/charts/line-bar/Chart';
-export * from './react/components/charts/line-bar/HGridChart';
-export * from './react/components/charts/pie/PieChart';
-export * from './react/components/charts/pie/SimplePieChart';
-export * from './react/components/makeCustomElement';
-export * from './react/hooks/useFin5BinUrl';
-export * from './react/hooks/useFin5ColorScheme';
-export * from './react/hooks/useScreenSize';
-export * from './react/app/Fin5AppContainer';
-export * from './react/app/Fin5AppRootStore';
+export * from './fin5Top/fin5FileUpload';
+export * from './fin5Top/fin5Top';
+export * from './fin5Top/finEdge2Cloud';
+export * from './fin5Top/getFin5BinUrl';
+export * from './fin5Top/openFin5Alarm';
+export * from './fin5Top/openFin5Historian';
+export * from './fin5Top/useFin5AppURLHashParameter';
+export * from './jobs/jobUtils';
+export * from './react/components/ErrorBoundary';
+export * from './react/components/ErrorDisplayer';
+export * from './react/components/Loader';
+export * from './react/components/LoadingSpinner';
+export * from './react/components/graphics/GraphicViewer';
+export * from './react/components/graphics/GraphicsTabViewer';
+export * from './react/components/navigation/BasicLayout';
+export * from './react/components/navigation/MenuPage';
+export * from './react/components/navigation/ReactRouterLayout';
+export * from './react/components/navigation/ReactRouterHeaderSiderLayout';
+export * from './react/components/navigation/customRouting/RouterLayout';
+export * from './react/components/navigation/customRouting/Router';
+export * from './react/components/resolvable/configurationForm/ConfigurationForm';
+export * from './react/components/resolvable/configurationForm/ConfigurationFormEntry';
+export * from './react/components/resolvable/configurationForm/getSectionDefault';
+export * from './react/components/RecordImage';
+export * from './react/components/charts/QRCode';
+export * from './react/components/charts/line-bar/Chart';
+export * from './react/components/charts/line-bar/HGridChart';
+export * from './react/components/charts/pie/PieChart';
+export * from './react/components/charts/pie/SimplePieChart';
+export * from './react/components/makeCustomElement';
+export * from './react/hooks/useFin5BinUrl';
+export * from './react/hooks/useFin5ColorScheme';
+export * from './react/hooks/useScreenSize';
+export * from './react/app/Fin5AppContainer';
+export * from './react/app/Fin5AppRootStore';