@onerjs/shared-ui-components 8.48.4 → 8.48.5

package/modularTool/extensibility/extensionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionManager.js","sourceRoot":"","sources":["../../../../../dev/sharedUiComponents/src/modularTool/extensibility/extensionManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { type IDisposable, type Nullable } from \"core/index\";\r\nimport { type ServiceContainer } from \"../modularity/serviceContainer\";\r\nimport { type IExtensionFeed, type ExtensionMetadata, type ExtensionModule } from \"./extensionFeed\";\r\n\r\nimport { Logger } from \"core/Misc/logger\";\r\n\r\n/**\r\n * Represents a loaded extension.\r\n */\r\nexport interface IExtension {\r\n    /**\r\n     * The metadata for the extension.\r\n     */\r\n    readonly metadata: ExtensionMetadata;\r\n\r\n    /**\r\n     * Whether the extension is currently being installed, uninstalled, enabled, or disabled.\r\n     */\r\n    readonly isStateChanging: boolean;\r\n\r\n    /**\r\n     * Whether the extension is enabled.\r\n     */\r\n    readonly isInstalled: boolean;\r\n\r\n    /**\r\n     * Installs the extension.\r\n     */\r\n    installAsync(): Promise<void>;\r\n\r\n    /**\r\n     * Uninstalls the extension.\r\n     */\r\n    uninstallAsync(): Promise<void>;\r\n\r\n    /**\r\n     * Adds a handler that is called when the state of the extension changes.\r\n     * @param handler The handler to add.\r\n     * @returns A disposable that removes the handler when disposed.\r\n     */\r\n    addStateChangedHandler(handler: () => void): IDisposable;\r\n}\r\n\r\n/**\r\n * Provides information about an extension installation failure.\r\n */\r\nexport type InstallFailedInfo = {\r\n    /**\r\n     * The metadata of the extension that failed to install.\r\n     */\r\n    extension: ExtensionMetadata;\r\n\r\n    /**\r\n     * The error that occurred during the installation.\r\n     */\r\n    error: unknown;\r\n};\r\n\r\ntype InstalledExtension = {\r\n    metadata: ExtensionMetadata;\r\n    feed: IExtensionFeed;\r\n    isStateChanging: boolean;\r\n    extensionModule?: ExtensionModule;\r\n    registrationToken?: IDisposable;\r\n};\r\n\r\nconst InstalledExtensionsKey = \"Extensions/InstalledExtensions\";\r\n\r\nconst ExtensionInstalledKeyPrefix = \"Extensions/IsExtensionInstalled\";\r\nfunction GetExtensionInstalledKey(name: string): string {\r\n    return `${ExtensionInstalledKeyPrefix}/${name}`;\r\n}\r\n\r\n/**\r\n * Represents a query for loaded extensions.\r\n */\r\nexport interface IExtensionQuery {\r\n    /**\r\n     * The total number of extensions that satisfy the query.\r\n     */\r\n    readonly totalCount: number;\r\n\r\n    /**\r\n     * Fetches a range of extensions from the query.\r\n     * @param index The index of the first extension to fetch.\r\n     * @param count The number of extensions to fetch.\r\n     * @returns A promise that resolves to the extensions.\r\n     */\r\n    getExtensionsAsync(index: number, count: number): Promise<IExtension[]>;\r\n}\r\n\r\nfunction GetExtensionIdentity(feed: string, name: string) {\r\n    return `${feed}/${name}`;\r\n}\r\n\r\n/**\r\n * Manages the installation, uninstallation, enabling, and disabling of extensions.\r\n */\r\nexport class ExtensionManager implements IDisposable {\r\n    private readonly _installedExtensions = new Map<string, InstalledExtension>();\r\n\r\n    private readonly _stateChangedHandlers = new Map<string, Set<() => void>>();\r\n\r\n    private constructor(\r\n        private readonly _namespace: string,\r\n        private readonly _serviceContainer: ServiceContainer,\r\n        private readonly _feeds: readonly IExtensionFeed[],\r\n        private readonly _onInstallFailed: (info: InstallFailedInfo) => void\r\n    ) {}\r\n\r\n    /**\r\n     * Creates a new instance of the ExtensionManager.\r\n     * This will automatically rehydrate previously installed and enabled extensions.\r\n     * @param namespace The namespace to use for storing extension state in local storage.\r\n     * @param serviceContainer The service container to use.\r\n     * @param feeds The extension feeds to include.\r\n     * @param onInstallFailed A callback that is called when an extension installation fails.\r\n     * @returns A promise that resolves to the new instance of the ExtensionManager.\r\n     */\r\n    public static async CreateAsync(\r\n        namespace: string,\r\n        serviceContainer: ServiceContainer,\r\n        feeds: readonly IExtensionFeed[],\r\n        onInstallFailed: (info: InstallFailedInfo) => void\r\n    ): Promise<ExtensionManager> {\r\n        namespace = `Babylon/${namespace}`;\r\n\r\n        const extensionManager = new ExtensionManager(namespace, serviceContainer, feeds, onInstallFailed);\r\n\r\n        // Rehydrate installed extensions.\r\n        const installedExtensionNames = JSON.parse(localStorage.getItem(`${namespace}/${InstalledExtensionsKey}`) ?? \"[]\") as string[];\r\n        for (const installedExtensionName of installedExtensionNames) {\r\n            const installedExtensionRaw = localStorage.getItem(`${namespace}/${GetExtensionInstalledKey(installedExtensionName)}`);\r\n            if (installedExtensionRaw) {\r\n                const installedExtensionData = JSON.parse(installedExtensionRaw) as {\r\n                    feed: string;\r\n                    metadata: ExtensionMetadata;\r\n                };\r\n\r\n                const feed = feeds.find((feed) => feed.name === installedExtensionData.feed);\r\n                if (feed) {\r\n                    const installedExtension = extensionManager._createInstalledExtension(installedExtensionData.metadata, feed);\r\n                    extensionManager._installedExtensions.set(installedExtension.metadata.name, installedExtension);\r\n                }\r\n            }\r\n        }\r\n\r\n        // Load installed and enabled extensions.\r\n        const enablePromises: Promise<void>[] = [];\r\n        for (const extension of extensionManager._installedExtensions.values()) {\r\n            enablePromises.push(\r\n                (async () => {\r\n                    try {\r\n                        await extensionManager._enableAsync(extension.metadata, false, false);\r\n                    } catch {\r\n                        // If enabling the extension fails, uninstall it. The extension install fail callback will still be called,\r\n                        // so the owner of the ExtensionManager instance can decide what to do with the error.\r\n                        await extensionManager._uninstallAsync(extension.metadata, false);\r\n                    }\r\n                })()\r\n            );\r\n        }\r\n\r\n        await Promise.all(enablePromises);\r\n\r\n        return extensionManager;\r\n    }\r\n\r\n    /**\r\n     * Gets the names of the feeds that are included in the extension manager.\r\n     * @returns The names of the feeds.\r\n     */\r\n    public get feedNames() {\r\n        return this._feeds.map((feed) => feed.name);\r\n    }\r\n\r\n    /**\r\n     * Queries the extension manager for extensions.\r\n     * @param filter The filter to apply to the query.\r\n     * @param feeds The feeds to include in the query.\r\n     * @param installedOnly Whether to only include installed extensions.\r\n     * @returns A promise that resolves to the extension query.\r\n     */\r\n    public async queryExtensionsAsync(filter = \"\", feeds: string[] = this.feedNames, installedOnly = false): Promise<IExtensionQuery> {\r\n        if (installedOnly) {\r\n            const installedExtensions = Array.from(this._installedExtensions.values()).filter((installedExtension) => feeds.includes(installedExtension.feed.name));\r\n            return {\r\n                totalCount: installedExtensions.length,\r\n                getExtensionsAsync: async (index, count) => {\r\n                    return installedExtensions.slice(index, index + count).map((installedExtension) => this._createExtension(installedExtension.metadata, installedExtension.feed));\r\n                },\r\n            };\r\n        }\r\n\r\n        const queries = await Promise.all(\r\n            this._feeds.filter((feed) => feeds.includes(feed.name)).map(async (feed) => Object.assign(await feed.queryExtensionsAsync(filter), { feed }))\r\n        );\r\n        const totalCount = queries.reduce((sum, query) => sum + query.totalCount, 0);\r\n\r\n        return {\r\n            totalCount,\r\n            getExtensionsAsync: async (index, count) => {\r\n                const extensions = new Array<IExtension>();\r\n                let remaining = count;\r\n\r\n                for (const query of queries) {\r\n                    if (remaining <= 0) {\r\n                        break;\r\n                    }\r\n\r\n                    if (index >= query.totalCount) {\r\n                        index -= query.totalCount;\r\n                        continue;\r\n                    }\r\n\r\n                    // This is intentionally sequential as we are querying for results until the count of results is met.\r\n                    // eslint-disable-next-line no-await-in-loop\r\n                    const metadataSlice = await query.getExtensionMetadataAsync(index, remaining);\r\n                    extensions.push(...metadataSlice.map((metadata) => this._createExtension(metadata, query.feed)));\r\n                    remaining -= metadataSlice.length;\r\n                    index = 0;\r\n                }\r\n\r\n                return extensions;\r\n            },\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Disposes the extension manager.\r\n     */\r\n    public dispose() {\r\n        for (const installedExtension of this._installedExtensions.values()) {\r\n            // eslint-disable-next-line github/no-then\r\n            this._disableAsync(installedExtension.metadata, false).catch((error) => {\r\n                Logger.Warn(`Failed to disable extension ${installedExtension.metadata.name}: ${error}`);\r\n            });\r\n        }\r\n\r\n        this._stateChangedHandlers.clear();\r\n    }\r\n\r\n    private _getInstalledExtensionStorageKey(metadata: ExtensionMetadata, feed: IExtensionFeed): string {\r\n        return `${this._namespace}/${GetExtensionInstalledKey(GetExtensionIdentity(feed.name, metadata.name))}`;\r\n    }\r\n\r\n    private _updateInstalledExtensionsStorage() {\r\n        localStorage.setItem(\r\n            `${this._namespace}/${InstalledExtensionsKey}`,\r\n            JSON.stringify(Array.from(this._installedExtensions.values()).map((extension) => GetExtensionIdentity(extension.feed.name, extension.metadata.name)))\r\n        );\r\n    }\r\n\r\n    private async _installAsync(metadata: ExtensionMetadata, feed: IExtensionFeed, isNestedStateChange: boolean): Promise<InstalledExtension> {\r\n        let installedExtension = this._installedExtensions.get(metadata.name);\r\n\r\n        if (!installedExtension) {\r\n            installedExtension = this._createInstalledExtension(metadata, feed);\r\n            installedExtension.isStateChanging = true;\r\n            this._installedExtensions.set(metadata.name, installedExtension);\r\n\r\n            try {\r\n                // Enable the extension.\r\n                await this._enableAsync(metadata, true, true);\r\n            } catch (error) {\r\n                this._installedExtensions.delete(metadata.name);\r\n                throw error;\r\n            } finally {\r\n                !isNestedStateChange && (installedExtension.isStateChanging = false);\r\n            }\r\n\r\n            // Mark the extension as being installed.\r\n            localStorage.setItem(\r\n                this._getInstalledExtensionStorageKey(metadata, feed),\r\n                JSON.stringify({\r\n                    feed: feed.name,\r\n                    metadata,\r\n                })\r\n            );\r\n            this._updateInstalledExtensionsStorage();\r\n        }\r\n\r\n        return installedExtension;\r\n    }\r\n\r\n    private async _uninstallAsync(metadata: ExtensionMetadata, isNestedStateChange: boolean): Promise<void> {\r\n        const installedExtension = this._installedExtensions.get(metadata.name);\r\n        if (installedExtension && (isNestedStateChange || !installedExtension.isStateChanging)) {\r\n            try {\r\n                !isNestedStateChange && (installedExtension.isStateChanging = true);\r\n\r\n                // Disable the extension.\r\n                await this._disableAsync(metadata, true);\r\n\r\n                // Remove the extension from in memory.\r\n                this._installedExtensions.delete(metadata.name);\r\n\r\n                // Mark the extension as being uninstalled.\r\n                localStorage.removeItem(this._getInstalledExtensionStorageKey(metadata, installedExtension.feed));\r\n                this._updateInstalledExtensionsStorage();\r\n            } finally {\r\n                !isNestedStateChange && (installedExtension.isStateChanging = false);\r\n            }\r\n        }\r\n    }\r\n\r\n    private async _enableAsync(metadata: ExtensionMetadata, isInitialInstall: boolean, isNestedStateChange: boolean): Promise<void> {\r\n        const installedExtension = this._installedExtensions.get(metadata.name);\r\n        if (installedExtension && (isNestedStateChange || !installedExtension.isStateChanging)) {\r\n            try {\r\n                !isNestedStateChange && (installedExtension.isStateChanging = true);\r\n\r\n                // If we haven't done so already, load the extension module.\r\n                if (!installedExtension.extensionModule) {\r\n                    installedExtension.extensionModule = await installedExtension.feed.getExtensionModuleAsync(metadata.name);\r\n                }\r\n\r\n                if (!installedExtension.extensionModule) {\r\n                    throw new Error(`Unable to load extension module for \"${metadata.name}\" from feed \"${installedExtension.feed.name}\".`);\r\n                }\r\n\r\n                // Register the ServiceDefinitions.\r\n                let servicesRegistrationToken: Nullable<IDisposable> = null;\r\n                if (installedExtension.extensionModule.default.serviceDefinitions) {\r\n                    servicesRegistrationToken = await this._serviceContainer.addServicesAsync(...installedExtension.extensionModule.default.serviceDefinitions);\r\n                }\r\n\r\n                // Create a registration token to for dispose.\r\n                installedExtension.registrationToken = {\r\n                    dispose: () => {\r\n                        servicesRegistrationToken?.dispose();\r\n                    },\r\n                };\r\n            } catch (error: unknown) {\r\n                this._onInstallFailed({\r\n                    extension: metadata,\r\n                    error,\r\n                });\r\n                throw error;\r\n            } finally {\r\n                !isNestedStateChange && (installedExtension.isStateChanging = false);\r\n            }\r\n        }\r\n    }\r\n\r\n    private async _disableAsync(metadata: ExtensionMetadata, isNestedStateChange: boolean): Promise<void> {\r\n        const installedExtension = this._installedExtensions.get(metadata.name);\r\n        if (installedExtension && (isNestedStateChange || !installedExtension.isStateChanging)) {\r\n            try {\r\n                !isNestedStateChange && (installedExtension.isStateChanging = true);\r\n\r\n                // Unregister the service registrations.\r\n                installedExtension.registrationToken?.dispose();\r\n            } finally {\r\n                !isNestedStateChange && (installedExtension.isStateChanging = false);\r\n            }\r\n        }\r\n    }\r\n\r\n    private _addStateChangedHandler(metadata: ExtensionMetadata, handler: () => void): IDisposable {\r\n        let stateChangedHandlers = this._stateChangedHandlers.get(metadata.name);\r\n        if (!stateChangedHandlers) {\r\n            this._stateChangedHandlers.set(metadata.name, (stateChangedHandlers = new Set()));\r\n        }\r\n\r\n        stateChangedHandlers.add(handler);\r\n\r\n        return {\r\n            dispose: () => {\r\n                stateChangedHandlers.delete(handler);\r\n                if (stateChangedHandlers.size === 0) {\r\n                    this._stateChangedHandlers.delete(metadata.name);\r\n                }\r\n            },\r\n        };\r\n    }\r\n\r\n    private _createExtension(metadata: ExtensionMetadata, feed: IExtensionFeed): IExtension {\r\n        // eslint-disable-next-line @typescript-eslint/no-this-alias\r\n        const extensionManager = this;\r\n        return {\r\n            metadata,\r\n            get isStateChanging() {\r\n                return extensionManager._installedExtensions.get(metadata.name)?.isStateChanging ?? false;\r\n            },\r\n            get isInstalled() {\r\n                return extensionManager._installedExtensions.has(metadata.name);\r\n            },\r\n            installAsync: async () => {\r\n                await extensionManager._installAsync(metadata, feed, false);\r\n            },\r\n            uninstallAsync: async () => await extensionManager._uninstallAsync(metadata, false),\r\n            addStateChangedHandler: (handler: () => void) => extensionManager._addStateChangedHandler(metadata, handler),\r\n        };\r\n    }\r\n\r\n    private _createInstalledExtension(metadata: ExtensionMetadata, feed: IExtensionFeed): InstalledExtension {\r\n        // eslint-disable-next-line @typescript-eslint/no-this-alias\r\n        const extensionManager = this;\r\n        let isStateChanging = false;\r\n        return {\r\n            metadata,\r\n            feed,\r\n            get isStateChanging() {\r\n                return isStateChanging;\r\n            },\r\n            set isStateChanging(value) {\r\n                if (value !== isStateChanging) {\r\n                    isStateChanging = value;\r\n                    extensionManager._stateChangedHandlers.get(this.metadata.name)?.forEach((handler) => handler());\r\n                }\r\n            },\r\n        };\r\n    }\r\n}\r\n"]}

package/modularTool/hooks/observableHooks.d.ts

@@ -0,0 +1,35 @@
+import { type IReadonlyObservable } from "@onerjs/core/index.js";
+import { type ObservableCollection } from "../misc/observableCollection.js";
+/**
+ * Returns the current value of the accessor and updates it when the specified event is fired on the specified element.
+ * @param accessor A function that returns the current value.
+ * @param element The element to listen for the event on.
+ * @param eventNames The names of the events to listen for.
+ * @returns The current value of the accessor.
+ *  * @remarks If the accessor function is not idempotent (e.g. it returns a different array or object instance each time it is called),
+ * then there is a good chance it should be wrapped in a `useCallback` to prevent unnecessary re-renders or re-render infinite loops.
+ */
+export declare function useEventfulState<T>(accessor: () => T, element: HTMLElement | null | undefined, ...eventNames: string[]): T;
+/**
+ * Returns the current value of the accessor and updates it when any of the specified observables change.
+ * @param accessor A function that returns the current value.
+ * @param observables The observables to listen for changes on.
+ * @returns The current value of the accessor.
+ * @remarks If the accessor function is not idempotent (e.g. it returns a different array or object instance each time it is called),
+ * then there is a good chance it should be wrapped in a `useCallback` to prevent unnecessary re-renders or re-render infinite loops.
+ */
+export declare function useObservableState<T>(accessor: () => T, ...observables: Array<IReadonlyObservable | null | undefined>): T;
+/**
+ * Returns a copy of the items in the collection and updates it when the collection changes.
+ * @param collection The collection to observe.
+ * @returns A copy of the items in the collection.
+ */
+export declare function useObservableCollection<T>(collection: ObservableCollection<T>): T[];
+/**
+ * Returns a copy of the items in the collection sorted by the order property and updates it when the collection changes.
+ * @param collection The collection to observe.
+ * @returns A copy of the items in the collection sorted by the order property.
+ */
+export declare function useOrderedObservableCollection<T extends Readonly<{
+    order?: number;
+}>>(collection: ObservableCollection<T>): T[];

package/modularTool/hooks/observableHooks.js

@@ -0,0 +1,84 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+/**
+ * Returns the current value of the accessor and updates it when the specified event is fired on the specified element.
+ * @param accessor A function that returns the current value.
+ * @param element The element to listen for the event on.
+ * @param eventNames The names of the events to listen for.
+ * @returns The current value of the accessor.
+ *  * @remarks If the accessor function is not idempotent (e.g. it returns a different array or object instance each time it is called),
+ * then there is a good chance it should be wrapped in a `useCallback` to prevent unnecessary re-renders or re-render infinite loops.
+ */
+export function useEventfulState(accessor, element, ...eventNames) {
+    const [current, setCurrent] = useState(accessor);
+    useEffect(() => {
+        setCurrent(accessor);
+        if (element) {
+            const removers = eventNames.map((eventName) => {
+                const handler = () => {
+                    setCurrent(accessor());
+                };
+                element.addEventListener(eventName, handler);
+                return () => {
+                    element.removeEventListener(eventName, handler);
+                };
+            });
+            return () => {
+                removers.forEach((remove) => remove());
+            };
+        }
+        return undefined;
+    }, [accessor, element, ...eventNames]);
+    return current;
+}
+/**
+ * Returns the current value of the accessor and updates it when any of the specified observables change.
+ * @param accessor A function that returns the current value.
+ * @param observables The observables to listen for changes on.
+ * @returns The current value of the accessor.
+ * @remarks If the accessor function is not idempotent (e.g. it returns a different array or object instance each time it is called),
+ * then there is a good chance it should be wrapped in a `useCallback` to prevent unnecessary re-renders or re-render infinite loops.
+ */
+export function useObservableState(accessor, ...observables) {
+    const [current, setCurrent] = useState(accessor);
+    useEffect(() => {
+        setCurrent(accessor);
+        const observers = observables.map((observable) => {
+            if (observable) {
+                const observer = observable.add(() => {
+                    setCurrent(accessor());
+                });
+                return observer;
+            }
+            return null;
+        });
+        return () => {
+            observers.forEach((observer) => observer?.remove());
+        };
+    }, [accessor, ...observables]);
+    return current;
+}
+/**
+ * Returns a copy of the items in the collection and updates it when the collection changes.
+ * @param collection The collection to observe.
+ * @returns A copy of the items in the collection.
+ */
+export function useObservableCollection(collection) {
+    const itemsRef = useRef([...collection.items]);
+    return useObservableState(useCallback(() => {
+        if (itemsRef.current.length !== collection.items.length || !itemsRef.current.every((item, index) => item === collection.items[index])) {
+            itemsRef.current = [...collection.items];
+        }
+        return itemsRef.current;
+    }, [collection]), collection.observable);
+}
+/**
+ * Returns a copy of the items in the collection sorted by the order property and updates it when the collection changes.
+ * @param collection The collection to observe.
+ * @returns A copy of the items in the collection sorted by the order property.
+ */
+export function useOrderedObservableCollection(collection) {
+    const items = useObservableCollection(collection);
+    const sortedItems = useMemo(() => items.sort((a, b) => (a.order ?? 0) - (b.order ?? 0)), [items]);
+    return sortedItems;
+}
+//# sourceMappingURL=observableHooks.js.map

package/modularTool/hooks/observableHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observableHooks.js","sourceRoot":"","sources":["../../../../../dev/sharedUiComponents/src/modularTool/hooks/observableHooks.ts"],"names":[],"mappings":"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","sourcesContent":["import { type IReadonlyObservable } from \"core/index\";\r\n\r\nimport { type ObservableCollection } from \"../misc/observableCollection\";\r\n\r\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\r\n\r\n/**\r\n * Returns the current value of the accessor and updates it when the specified event is fired on the specified element.\r\n * @param accessor A function that returns the current value.\r\n * @param element The element to listen for the event on.\r\n * @param eventNames The names of the events to listen for.\r\n * @returns The current value of the accessor.\r\n *  * @remarks If the accessor function is not idempotent (e.g. it returns a different array or object instance each time it is called),\r\n * then there is a good chance it should be wrapped in a `useCallback` to prevent unnecessary re-renders or re-render infinite loops.\r\n */\r\nexport function useEventfulState<T>(accessor: () => T, element: HTMLElement | null | undefined, ...eventNames: string[]): T {\r\n    const [current, setCurrent] = useState(accessor);\r\n\r\n    useEffect(() => {\r\n        setCurrent(accessor);\r\n        if (element) {\r\n            const removers = eventNames.map((eventName) => {\r\n                const handler = () => {\r\n                    setCurrent(accessor());\r\n                };\r\n\r\n                element.addEventListener(eventName, handler);\r\n\r\n                return () => {\r\n                    element.removeEventListener(eventName, handler);\r\n                };\r\n            });\r\n\r\n            return () => {\r\n                removers.forEach((remove) => remove());\r\n            };\r\n        }\r\n\r\n        return undefined;\r\n    }, [accessor, element, ...eventNames]);\r\n\r\n    return current;\r\n}\r\n\r\n/**\r\n * Returns the current value of the accessor and updates it when any of the specified observables change.\r\n * @param accessor A function that returns the current value.\r\n * @param observables The observables to listen for changes on.\r\n * @returns The current value of the accessor.\r\n * @remarks If the accessor function is not idempotent (e.g. it returns a different array or object instance each time it is called),\r\n * then there is a good chance it should be wrapped in a `useCallback` to prevent unnecessary re-renders or re-render infinite loops.\r\n */\r\nexport function useObservableState<T>(accessor: () => T, ...observables: Array<IReadonlyObservable | null | undefined>): T {\r\n    const [current, setCurrent] = useState(accessor);\r\n\r\n    useEffect(() => {\r\n        setCurrent(accessor);\r\n        const observers = observables.map((observable) => {\r\n            if (observable) {\r\n                const observer = observable.add(() => {\r\n                    setCurrent(accessor());\r\n                });\r\n\r\n                return observer;\r\n            }\r\n            return null;\r\n        });\r\n\r\n        return () => {\r\n            observers.forEach((observer) => observer?.remove());\r\n        };\r\n    }, [accessor, ...observables]);\r\n\r\n    return current;\r\n}\r\n\r\n/**\r\n * Returns a copy of the items in the collection and updates it when the collection changes.\r\n * @param collection The collection to observe.\r\n * @returns A copy of the items in the collection.\r\n */\r\nexport function useObservableCollection<T>(collection: ObservableCollection<T>) {\r\n    const itemsRef = useRef([...collection.items]);\r\n    return useObservableState(\r\n        useCallback(() => {\r\n            if (itemsRef.current.length !== collection.items.length || !itemsRef.current.every((item, index) => item === collection.items[index])) {\r\n                itemsRef.current = [...collection.items];\r\n            }\r\n            return itemsRef.current;\r\n        }, [collection]),\r\n        collection.observable\r\n    );\r\n}\r\n\r\n/**\r\n * Returns a copy of the items in the collection sorted by the order property and updates it when the collection changes.\r\n * @param collection The collection to observe.\r\n * @returns A copy of the items in the collection sorted by the order property.\r\n */\r\nexport function useOrderedObservableCollection<T extends Readonly<{ order?: number }>>(collection: ObservableCollection<T>) {\r\n    const items = useObservableCollection(collection);\r\n    const sortedItems = useMemo(() => items.sort((a, b) => (a.order ?? 0) - (b.order ?? 0)), [items]);\r\n    return sortedItems;\r\n}\r\n"]}

package/modularTool/hooks/resourceHooks.d.ts

@@ -0,0 +1,20 @@
+import { type DependencyList } from "react";
+import { type IDisposable } from "@onerjs/core/index.js";
+/**
+ * Custom hook to manage a resource with automatic disposal. The resource is created once initially, and recreated
+ * if the factory function or any dependency changes. Whenever the resource is recreated, the previous instance is
+ * disposed. The final instance is disposed when the component using this hook unmounts.
+ * @param factory A function that creates the resource.
+ * @param deps An optional dependency list. When any dependency changes, the resource is disposed and recreated.
+ * @returns The created resource.
+ */
+export declare function useResource<T extends IDisposable | null | undefined>(factory: () => T, deps?: DependencyList): T;
+/**
+ * Custom hook to manage an asynchronous resource with automatic disposal. The resource is created once initially, and recreated
+ * if the factory function or any dependency changes. Whenever the resource is recreated, the previous instance is
+ * disposed. The final instance is disposed when the component using this hook unmounts.
+ * @param factory A function that creates the resource.
+ * @param deps An optional dependency list. When any dependency changes, the resource is disposed and recreated.
+ * @returns The created resource.
+ */
+export declare function useAsyncResource<T extends IDisposable | null | undefined>(factory: (abortSignal: AbortSignal) => Promise<T>, deps?: DependencyList): T | undefined;

package/modularTool/hooks/resourceHooks.js

@@ -0,0 +1,101 @@
+import { useRef, useEffect, useState } from "react";
+/**
+ * Custom hook to manage a resource with automatic disposal. The resource is created once initially, and recreated
+ * if the factory function or any dependency changes. Whenever the resource is recreated, the previous instance is
+ * disposed. The final instance is disposed when the component using this hook unmounts.
+ * @param factory A function that creates the resource.
+ * @param deps An optional dependency list. When any dependency changes, the resource is disposed and recreated.
+ * @returns The created resource.
+ */
+export function useResource(factory, deps) {
+    const resourceRef = useRef();
+    const factoryRef = useRef(factory);
+    const depsRef = useRef(deps);
+    const initializedRef = useRef(false);
+    // Initialize resource synchronously on first call, when factory changes, or when deps change
+    if (!initializedRef.current || factoryRef.current !== factory || !DepsEqual(depsRef.current, deps)) {
+        // Dispose old resource if it exists
+        resourceRef.current?.dispose();
+        // Create new resource
+        resourceRef.current = factory();
+        initializedRef.current = true;
+    }
+    // Update refs to capture latest values
+    factoryRef.current = factory;
+    depsRef.current = deps;
+    // Cleanup effect for component unmount
+    useEffect(() => {
+        return () => {
+            resourceRef.current?.dispose();
+            resourceRef.current = undefined;
+        };
+    }, []);
+    return resourceRef.current;
+}
+/**
+ * Custom hook to manage an asynchronous resource with automatic disposal. The resource is created once initially, and recreated
+ * if the factory function or any dependency changes. Whenever the resource is recreated, the previous instance is
+ * disposed. The final instance is disposed when the component using this hook unmounts.
+ * @param factory A function that creates the resource.
+ * @param deps An optional dependency list. When any dependency changes, the resource is disposed and recreated.
+ * @returns The created resource.
+ */
+export function useAsyncResource(factory, deps) {
+    const [resource, setResource] = useState();
+    const factoryRef = useRef(factory);
+    // Update refs to capture latest values
+    factoryRef.current = factory;
+    useEffect(() => {
+        const abortController = new AbortController();
+        // Dispose old resource if it exists
+        resource?.dispose();
+        setResource(undefined);
+        // Create new resource
+        void (async () => {
+            try {
+                const newVal = await factory(abortController.signal);
+                if (!abortController.signal.aborted) {
+                    setResource(newVal); // This will trigger a re-render so the new resource is returned to caller
+                }
+                else {
+                    newVal?.dispose();
+                }
+            }
+            catch (error) {
+                if (error instanceof Error && error.name === "AbortError") {
+                    return;
+                }
+            }
+        })();
+        return () => {
+            abortController.abort();
+            resource?.dispose();
+            setResource(undefined);
+        };
+    }, [factory, ...(deps ?? [])]);
+    return resource;
+}
+/**
+ * Compares two dependency lists for equality.
+ * @param a The first dependency list.
+ * @param b The second dependency list.
+ * @returns True if the dependency lists are equal.
+ */
+function DepsEqual(a, b) {
+    if (a === b) {
+        return true;
+    }
+    if (a === undefined || b === undefined) {
+        return false;
+    }
+    if (a.length !== b.length) {
+        return false;
+    }
+    for (let i = 0; i < a.length; i++) {
+        if (!Object.is(a[i], b[i])) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=resourceHooks.js.map

package/modularTool/hooks/resourceHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceHooks.js","sourceRoot":"","sources":["../../../../../dev/sharedUiComponents/src/modularTool/hooks/resourceHooks.ts"],"names":[],"mappings":"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","sourcesContent":["import { type DependencyList, useRef, useEffect, useState } from \"react\";\r\nimport { type IDisposable } from \"core/index\";\r\n\r\n/**\r\n * Custom hook to manage a resource with automatic disposal. The resource is created once initially, and recreated\r\n * if the factory function or any dependency changes. Whenever the resource is recreated, the previous instance is\r\n * disposed. The final instance is disposed when the component using this hook unmounts.\r\n * @param factory A function that creates the resource.\r\n * @param deps An optional dependency list. When any dependency changes, the resource is disposed and recreated.\r\n * @returns The created resource.\r\n */\r\nexport function useResource<T extends IDisposable | null | undefined>(factory: () => T, deps?: DependencyList): T {\r\n    const resourceRef = useRef<T>();\r\n    const factoryRef = useRef(factory);\r\n    const depsRef = useRef(deps);\r\n    const initializedRef = useRef(false);\r\n\r\n    // Initialize resource synchronously on first call, when factory changes, or when deps change\r\n    if (!initializedRef.current || factoryRef.current !== factory || !DepsEqual(depsRef.current, deps)) {\r\n        // Dispose old resource if it exists\r\n        resourceRef.current?.dispose();\r\n\r\n        // Create new resource\r\n        resourceRef.current = factory();\r\n        initializedRef.current = true;\r\n    }\r\n\r\n    // Update refs to capture latest values\r\n    factoryRef.current = factory;\r\n    depsRef.current = deps;\r\n\r\n    // Cleanup effect for component unmount\r\n    useEffect(() => {\r\n        return () => {\r\n            resourceRef.current?.dispose();\r\n            resourceRef.current = undefined;\r\n        };\r\n    }, []);\r\n\r\n    return resourceRef.current as T;\r\n}\r\n\r\n/**\r\n * Custom hook to manage an asynchronous resource with automatic disposal. The resource is created once initially, and recreated\r\n * if the factory function or any dependency changes. Whenever the resource is recreated, the previous instance is\r\n * disposed. The final instance is disposed when the component using this hook unmounts.\r\n * @param factory A function that creates the resource.\r\n * @param deps An optional dependency list. When any dependency changes, the resource is disposed and recreated.\r\n * @returns The created resource.\r\n */\r\nexport function useAsyncResource<T extends IDisposable | null | undefined>(factory: (abortSignal: AbortSignal) => Promise<T>, deps?: DependencyList): T | undefined {\r\n    const [resource, setResource] = useState<T | undefined>();\r\n    const factoryRef = useRef(factory);\r\n\r\n    // Update refs to capture latest values\r\n    factoryRef.current = factory;\r\n\r\n    useEffect(() => {\r\n        const abortController = new AbortController();\r\n\r\n        // Dispose old resource if it exists\r\n        resource?.dispose();\r\n        setResource(undefined);\r\n\r\n        // Create new resource\r\n        void (async () => {\r\n            try {\r\n                const newVal = await factory(abortController.signal);\r\n                if (!abortController.signal.aborted) {\r\n                    setResource(newVal); // This will trigger a re-render so the new resource is returned to caller\r\n                } else {\r\n                    newVal?.dispose();\r\n                }\r\n            } catch (error) {\r\n                if (error instanceof Error && error.name === \"AbortError\") {\r\n                    return;\r\n                }\r\n            }\r\n        })();\r\n\r\n        return () => {\r\n            abortController.abort();\r\n            resource?.dispose();\r\n            setResource(undefined);\r\n        };\r\n    }, [factory, ...(deps ?? [])]);\r\n\r\n    return resource;\r\n}\r\n\r\n/**\r\n * Compares two dependency lists for equality.\r\n * @param a The first dependency list.\r\n * @param b The second dependency list.\r\n * @returns True if the dependency lists are equal.\r\n */\r\nfunction DepsEqual(a: DependencyList | undefined, b: DependencyList | undefined): boolean {\r\n    if (a === b) {\r\n        return true;\r\n    }\r\n    if (a === undefined || b === undefined) {\r\n        return false;\r\n    }\r\n    if (a.length !== b.length) {\r\n        return false;\r\n    }\r\n    for (let i = 0; i < a.length; i++) {\r\n        if (!Object.is(a[i], b[i])) {\r\n            return false;\r\n        }\r\n    }\r\n    return true;\r\n}\r\n"]}

package/modularTool/hooks/settingsHooks.d.ts

@@ -0,0 +1,8 @@
+import { type Dispatch, type SetStateAction } from "react";
+import { type SettingDescriptor } from "../services/settingsStore.js";
+/**
+ * Hook that reads and writes a setting from the settings store.
+ * @param descriptor The setting descriptor that identifies the setting and its default value.
+ * @returns A tuple of [currentValue, setValue, resetValue] similar to React's useState.
+ */
+export declare function useSetting<T>(descriptor: SettingDescriptor<T>): [T, Dispatch<SetStateAction<T>>, () => void];

package/modularTool/hooks/settingsHooks.js

@@ -0,0 +1,40 @@
+import { useCallback, useEffect, useMemo } from "react";
+import { Observable } from "@onerjs/core/Misc/observable.js";
+import { useSettingsStore } from "../contexts/settingsContext.js";
+import { useObservableState } from "./observableHooks.js";
+/**
+ * Hook that reads and writes a setting from the settings store.
+ * @param descriptor The setting descriptor that identifies the setting and its default value.
+ * @returns A tuple of [currentValue, setValue, resetValue] similar to React's useState.
+ */
+export function useSetting(descriptor) {
+    const settingsStore = useSettingsStore();
+    // Only watch for this specific setting to change. Otherwise, any time any setting changes we would
+    // call readSetting again, which if it is an object, it will be a new instance, which can cause
+    // unnecessary re-renders in consumers of this hook.
+    const settingObservable = useMemo(() => new Observable(), []);
+    useEffect(() => {
+        if (settingsStore) {
+            const observer = settingsStore.onChanged.add((key) => {
+                if (key === descriptor.key) {
+                    settingObservable.notifyObservers();
+                }
+            });
+            return () => {
+                observer.remove();
+            };
+        }
+        return undefined;
+    }, [settingsStore, descriptor.key]);
+    const value = useObservableState(useCallback(() => settingsStore?.readSetting(descriptor) ?? descriptor.defaultValue, [settingsStore, descriptor.key, descriptor.defaultValue]), settingObservable);
+    const setValue = useCallback((newValue) => {
+        const value = typeof newValue === "function" ? newValue(settingsStore?.readSetting(descriptor) ?? descriptor.defaultValue) : newValue;
+        settingsStore?.writeSetting(descriptor, value);
+    }, [settingsStore, descriptor.key, descriptor.defaultValue]);
+    const resetValue = useCallback(() => settingsStore?.writeSetting(descriptor, descriptor.defaultValue), [settingsStore, descriptor.key, descriptor.defaultValue]);
+    if (!settingsStore) {
+        throw new Error("Settings store is not available in context.");
+    }
+    return [value, setValue, resetValue];
+}
+//# sourceMappingURL=settingsHooks.js.map

package/modularTool/hooks/settingsHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settingsHooks.js","sourceRoot":"","sources":["../../../../../dev/sharedUiComponents/src/modularTool/hooks/settingsHooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAI5F,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAI,UAAgC;IAC1D,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IAEzC,mGAAmG;IACnG,+FAA+F;IAC/F,oDAAoD;IACpD,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,UAAU,EAAQ,EAAE,EAAE,CAAC,CAAC;IACpE,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,aAAa,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACjD,IAAI,GAAG,KAAK,UAAU,CAAC,GAAG,EAAE,CAAC;oBACzB,iBAAiB,CAAC,eAAe,EAAE,CAAC;gBACxC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,OAAO,GAAG,EAAE;gBACR,QAAQ,CAAC,MAAM,EAAE,CAAC;YACtB,CAAC,CAAC;QACN,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC,EAAE,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAEpC,MAAM,KAAK,GAAG,kBAAkB,CAC5B,WAAW,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,WAAW,CAAI,UAAU,CAAC,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,EACjJ,iBAAiB,CACpB,CAAC;IAEF,MAAM,QAAQ,GAAG,WAAW,CACxB,CAAC,QAA2B,EAAQ,EAAE;QAClC,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAE,QAA2B,CAAC,aAAa,EAAE,WAAW,CAAI,UAAU,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC7J,aAAa,EAAE,YAAY,CAAI,UAAU,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC,EACD,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,YAAY,CAAC,CAC3D,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAAC,GAAS,EAAE,CAAC,aAAa,EAAE,YAAY,CAAI,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAE1K,IAAI,CAAC,aAAa,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AAClD,CAAC","sourcesContent":["import { type Dispatch, type SetStateAction, useCallback, useEffect, useMemo } from \"react\";\r\n\r\nimport { type SettingDescriptor } from \"../services/settingsStore\";\r\n\r\nimport { Observable } from \"core/Misc/observable\";\r\nimport { useSettingsStore } from \"../contexts/settingsContext\";\r\nimport { useObservableState } from \"./observableHooks\";\r\n\r\n/**\r\n * Hook that reads and writes a setting from the settings store.\r\n * @param descriptor The setting descriptor that identifies the setting and its default value.\r\n * @returns A tuple of [currentValue, setValue, resetValue] similar to React's useState.\r\n */\r\nexport function useSetting<T>(descriptor: SettingDescriptor<T>): [T, Dispatch<SetStateAction<T>>, () => void] {\r\n    const settingsStore = useSettingsStore();\r\n\r\n    // Only watch for this specific setting to change. Otherwise, any time any setting changes we would\r\n    // call readSetting again, which if it is an object, it will be a new instance, which can cause\r\n    // unnecessary re-renders in consumers of this hook.\r\n    const settingObservable = useMemo(() => new Observable<void>(), []);\r\n    useEffect(() => {\r\n        if (settingsStore) {\r\n            const observer = settingsStore.onChanged.add((key) => {\r\n                if (key === descriptor.key) {\r\n                    settingObservable.notifyObservers();\r\n                }\r\n            });\r\n\r\n            return () => {\r\n                observer.remove();\r\n            };\r\n        }\r\n\r\n        return undefined;\r\n    }, [settingsStore, descriptor.key]);\r\n\r\n    const value = useObservableState(\r\n        useCallback(() => settingsStore?.readSetting<T>(descriptor) ?? descriptor.defaultValue, [settingsStore, descriptor.key, descriptor.defaultValue]),\r\n        settingObservable\r\n    );\r\n\r\n    const setValue = useCallback(\r\n        (newValue: SetStateAction<T>): void => {\r\n            const value = typeof newValue === \"function\" ? (newValue as (prev: T) => T)(settingsStore?.readSetting<T>(descriptor) ?? descriptor.defaultValue) : newValue;\r\n            settingsStore?.writeSetting<T>(descriptor, value);\r\n        },\r\n        [settingsStore, descriptor.key, descriptor.defaultValue]\r\n    );\r\n\r\n    const resetValue = useCallback((): void => settingsStore?.writeSetting<T>(descriptor, descriptor.defaultValue), [settingsStore, descriptor.key, descriptor.defaultValue]);\r\n\r\n    if (!settingsStore) {\r\n        throw new Error(\"Settings store is not available in context.\");\r\n    }\r\n\r\n    return [value, setValue, resetValue] as const;\r\n}\r\n"]}

package/modularTool/hooks/teachingMomentHooks.d.ts

@@ -0,0 +1,34 @@
+import { type Nullable } from "@onerjs/core/index.js";
+import { type OnOpenChangeData, type PositioningImperativeRef } from "@fluentui/react-components";
+/**
+ * Creates a hook for managing teaching moment state.
+ * @param name The unique name of the teaching moment.
+ * @returns A hook that returns the teaching moment state.
+ */
+export declare function MakeTeachingMoment(name: string): (suppress?: boolean) => {
+    readonly shouldDisplay: boolean;
+    readonly onDismissed: () => void;
+    readonly reset: () => void;
+};
+/**
+ * Creates a hook for managing teaching moment state for a dialog.
+ * @param name The unique name of the teaching moment.
+ * @returns A hook that returns the teaching moment state for a dialog.
+ */
+export declare function MakeDialogTeachingMoment(name: string): (suppress?: boolean) => {
+    readonly shouldDisplay: boolean;
+    readonly onOpenChange: (e: unknown, data: OnOpenChangeData) => void;
+    readonly reset: () => void;
+};
+/**
+ * Creates a hook for managing teaching moment state for a popover.
+ * @param name The unique name of the teaching moment.
+ * @returns A hook that returns the teaching moment state for a popover.
+ */
+export declare function MakePopoverTeachingMoment(name: string): (suppress?: boolean) => {
+    readonly shouldDisplay: boolean;
+    readonly positioningRef: import("react").Dispatch<import("react").SetStateAction<Nullable<PositioningImperativeRef>>>;
+    readonly targetRef: import("react").Dispatch<import("react").SetStateAction<Nullable<HTMLElement>>>;
+    readonly onOpenChange: (e: unknown, data: OnOpenChangeData) => void;
+    readonly reset: () => void;
+};

package/modularTool/hooks/teachingMomentHooks.js

@@ -0,0 +1,89 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useSetting } from "./settingsHooks.js";
+import { AsyncLock } from "@onerjs/core/Misc/asyncLock.js";
+import { Deferred } from "@onerjs/core/Misc/deferred.js";
+const SequencerLock = new AsyncLock();
+/**
+ * Creates a hook for managing teaching moment state.
+ * @param name The unique name of the teaching moment.
+ * @returns A hook that returns the teaching moment state.
+ */
+export function MakeTeachingMoment(name) {
+    return (suppress) => {
+        const [hasDisplayed, setHasDisplayed, resetDisplayed] = useSetting({ key: `TeachingMoments/${name}`, defaultValue: false });
+        const [shouldDisplay, setShouldDisplay] = useState(false);
+        const deferredRef = useRef();
+        useEffect(() => {
+            if (!hasDisplayed && !suppress && !deferredRef.current) {
+                // eslint-disable-next-line @typescript-eslint/no-floating-promises
+                SequencerLock.lockAsync(async () => {
+                    deferredRef.current = new Deferred();
+                    setShouldDisplay(true);
+                    // Just hold the lock until the hook cleanup, which is effectively component unmount (e.g. the teaching moment is dismissed).
+                    await deferredRef.current.promise;
+                });
+            }
+            return () => {
+                deferredRef.current?.resolve();
+            };
+        }, [hasDisplayed, suppress]);
+        const onDismissed = useCallback(() => {
+            setHasDisplayed(true);
+            deferredRef.current?.resolve();
+            deferredRef.current = undefined;
+            setShouldDisplay(false);
+        }, []);
+        return {
+            shouldDisplay,
+            onDismissed,
+            reset: resetDisplayed,
+        };
+    };
+}
+/**
+ * Creates a hook for managing teaching moment state for a dialog.
+ * @param name The unique name of the teaching moment.
+ * @returns A hook that returns the teaching moment state for a dialog.
+ */
+export function MakeDialogTeachingMoment(name) {
+    const useTeachingMoment = MakeTeachingMoment(name);
+    return (suppress) => {
+        const { shouldDisplay, onDismissed, reset } = useTeachingMoment(suppress);
+        const onOpenChange = useCallback((e, data) => {
+            if (!data.open) {
+                onDismissed();
+            }
+        }, []);
+        return {
+            shouldDisplay,
+            onOpenChange,
+            reset,
+        };
+    };
+}
+/**
+ * Creates a hook for managing teaching moment state for a popover.
+ * @param name The unique name of the teaching moment.
+ * @returns A hook that returns the teaching moment state for a popover.
+ */
+export function MakePopoverTeachingMoment(name) {
+    const useDialogTeachingMoment = MakeDialogTeachingMoment(name);
+    return (suppress) => {
+        const [target, setTarget] = useState(null);
+        const [positioningRef, setPositioningRef] = useState(null);
+        const { shouldDisplay, onOpenChange, reset } = useDialogTeachingMoment(suppress || !target || !positioningRef);
+        useEffect(() => {
+            if (target && positioningRef) {
+                positioningRef.setTarget(target);
+            }
+        }, [target, positioningRef]);
+        return {
+            shouldDisplay,
+            positioningRef: setPositioningRef,
+            targetRef: setTarget,
+            onOpenChange,
+            reset,
+        };
+    };
+}
+//# sourceMappingURL=teachingMomentHooks.js.map

package/modularTool/hooks/teachingMomentHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teachingMomentHooks.js","sourceRoot":"","sources":["../../../../../dev/sharedUiComponents/src/modularTool/hooks/teachingMomentHooks.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Nullable } from \"core/index\";\r\n\r\nimport { type OnOpenChangeData, type PositioningImperativeRef } from \"@fluentui/react-components\";\r\n\r\nimport { useCallback, useEffect, useRef, useState } from \"react\";\r\nimport { useSetting } from \"./settingsHooks\";\r\n\r\nimport { AsyncLock } from \"core/Misc/asyncLock\";\r\nimport { Deferred } from \"core/Misc/deferred\";\r\n\r\nconst SequencerLock = new AsyncLock();\r\n\r\n/**\r\n * Creates a hook for managing teaching moment state.\r\n * @param name The unique name of the teaching moment.\r\n * @returns A hook that returns the teaching moment state.\r\n */\r\nexport function MakeTeachingMoment(name: string) {\r\n    return (suppress?: boolean) => {\r\n        const [hasDisplayed, setHasDisplayed, resetDisplayed] = useSetting({ key: `TeachingMoments/${name}`, defaultValue: false });\r\n        const [shouldDisplay, setShouldDisplay] = useState(false);\r\n\r\n        const deferredRef = useRef<Deferred<void>>();\r\n\r\n        useEffect(() => {\r\n            if (!hasDisplayed && !suppress && !deferredRef.current) {\r\n                // eslint-disable-next-line @typescript-eslint/no-floating-promises\r\n                SequencerLock.lockAsync(async () => {\r\n                    deferredRef.current = new Deferred<void>();\r\n                    setShouldDisplay(true);\r\n                    // Just hold the lock until the hook cleanup, which is effectively component unmount (e.g. the teaching moment is dismissed).\r\n                    await deferredRef.current.promise;\r\n                });\r\n            }\r\n\r\n            return () => {\r\n                deferredRef.current?.resolve();\r\n            };\r\n        }, [hasDisplayed, suppress]);\r\n\r\n        const onDismissed = useCallback(() => {\r\n            setHasDisplayed(true);\r\n            deferredRef.current?.resolve();\r\n            deferredRef.current = undefined;\r\n            setShouldDisplay(false);\r\n        }, []);\r\n\r\n        return {\r\n            shouldDisplay,\r\n            onDismissed,\r\n            reset: resetDisplayed,\r\n        } as const;\r\n    };\r\n}\r\n\r\n/**\r\n * Creates a hook for managing teaching moment state for a dialog.\r\n * @param name The unique name of the teaching moment.\r\n * @returns A hook that returns the teaching moment state for a dialog.\r\n */\r\nexport function MakeDialogTeachingMoment(name: string) {\r\n    const useTeachingMoment = MakeTeachingMoment(name);\r\n\r\n    return (suppress?: boolean) => {\r\n        const { shouldDisplay, onDismissed, reset } = useTeachingMoment(suppress);\r\n\r\n        const onOpenChange = useCallback((e: unknown, data: OnOpenChangeData) => {\r\n            if (!data.open) {\r\n                onDismissed();\r\n            }\r\n        }, []);\r\n\r\n        return {\r\n            shouldDisplay,\r\n            onOpenChange,\r\n            reset,\r\n        } as const;\r\n    };\r\n}\r\n\r\n/**\r\n * Creates a hook for managing teaching moment state for a popover.\r\n * @param name The unique name of the teaching moment.\r\n * @returns A hook that returns the teaching moment state for a popover.\r\n */\r\nexport function MakePopoverTeachingMoment(name: string) {\r\n    const useDialogTeachingMoment = MakeDialogTeachingMoment(name);\r\n\r\n    return (suppress?: boolean) => {\r\n        const [target, setTarget] = useState<Nullable<HTMLElement>>(null);\r\n        const [positioningRef, setPositioningRef] = useState<Nullable<PositioningImperativeRef>>(null);\r\n\r\n        const { shouldDisplay, onOpenChange, reset } = useDialogTeachingMoment(suppress || !target || !positioningRef);\r\n\r\n        useEffect(() => {\r\n            if (target && positioningRef) {\r\n                positioningRef.setTarget(target);\r\n            }\r\n        }, [target, positioningRef]);\r\n\r\n        return {\r\n            shouldDisplay,\r\n            positioningRef: setPositioningRef,\r\n            targetRef: setTarget,\r\n            onOpenChange,\r\n            reset,\r\n        } as const;\r\n    };\r\n}\r\n"]}

package/modularTool/hooks/themeHooks.d.ts

@@ -0,0 +1,17 @@
+import { type ThemeMode } from "../services/themeService.js";
+/**
+ * Hook that provides the current theme mode state and controls for changing it.
+ * @returns An object with the current dark mode state, theme mode, and functions to set or toggle the theme.
+ */
+export declare function useThemeMode(): {
+    readonly isDarkMode: boolean;
+    readonly themeMode: ThemeMode;
+    readonly setThemeMode: (mode: ThemeMode) => void;
+    readonly toggleThemeMode: () => void | undefined;
+};
+/**
+ * Hook that returns the current Fluent UI theme based on the active theme mode.
+ * @param invert If true, inverts the theme (returns light theme in dark mode and vice versa). Defaults to false.
+ * @returns The current Fluent UI theme object.
+ */
+export declare function useTheme(invert?: boolean): import("@fluentui/tokens").Theme;

package/modularTool/hooks/themeHooks.js

@@ -0,0 +1,38 @@
+import { ThemeModeSettingDescriptor, ThemeResolver } from "../services/themeService.js";
+import { useCallback } from "react";
+import { useSettingsStore } from "../contexts/settingsContext.js";
+import { DarkTheme, LightTheme } from "../themes/babylonTheme.js";
+import { useObservableState } from "./observableHooks.js";
+import { useResource } from "./resourceHooks.js";
+/**
+ * Hook that provides the current theme mode state and controls for changing it.
+ * @returns An object with the current dark mode state, theme mode, and functions to set or toggle the theme.
+ */
+export function useThemeMode() {
+    const settingsStore = useSettingsStore();
+    const themeResolver = useResource(useCallback(() => (settingsStore ? new ThemeResolver(settingsStore) : undefined), [settingsStore]));
+    const state = useObservableState(useCallback(() => ({
+        isDarkMode: themeResolver?.isDark ?? false,
+        themeMode: themeResolver?.mode ?? ThemeModeSettingDescriptor.defaultValue,
+        setThemeMode: (mode) => {
+            if (themeResolver) {
+                themeResolver.mode = mode;
+            }
+        },
+        toggleThemeMode: () => themeResolver?.toggle(),
+    }), [themeResolver]), themeResolver?.onChanged);
+    if (!themeResolver) {
+        throw new Error("Settings store is not available in context.");
+    }
+    return state;
+}
+/**
+ * Hook that returns the current Fluent UI theme based on the active theme mode.
+ * @param invert If true, inverts the theme (returns light theme in dark mode and vice versa). Defaults to false.
+ * @returns The current Fluent UI theme object.
+ */
+export function useTheme(invert = false) {
+    const { isDarkMode } = useThemeMode();
+    return isDarkMode !== invert ? DarkTheme : LightTheme;
+}
+//# sourceMappingURL=themeHooks.js.map

package/modularTool/hooks/themeHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeHooks.js","sourceRoot":"","sources":["../../../../../dev/sharedUiComponents/src/modularTool/hooks/themeHooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,0BAA0B,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAErG,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,YAAY;IACxB,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,MAAM,aAAa,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAEtI,MAAM,KAAK,GAAG,kBAAkB,CAC5B,WAAW,CACP,GAAG,EAAE,CACD,CAAC;QACG,UAAU,EAAE,aAAa,EAAE,MAAM,IAAI,KAAK;QAC1C,SAAS,EAAE,aAAa,EAAE,IAAI,IAAI,0BAA0B,CAAC,YAAY;QACzE,YAAY,EAAE,CAAC,IAAe,EAAE,EAAE;YAC9B,IAAI,aAAa,EAAE,CAAC;gBAChB,aAAa,CAAC,IAAI,GAAG,IAAI,CAAC;YAC9B,CAAC;QACL,CAAC;QACD,eAAe,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE;KACjD,CAAU,EACf,CAAC,aAAa,CAAC,CAClB,EACD,aAAa,EAAE,SAAS,CAC3B,CAAC;IAEF,IAAI,CAAC,aAAa,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAM,GAAG,KAAK;IACnC,MAAM,EAAE,UAAU,EAAE,GAAG,YAAY,EAAE,CAAC;IACtC,OAAO,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AAC1D,CAAC","sourcesContent":["import { type ThemeMode, ThemeModeSettingDescriptor, ThemeResolver } from \"../services/themeService\";\r\n\r\nimport { useCallback } from \"react\";\r\n\r\nimport { useSettingsStore } from \"../contexts/settingsContext\";\r\nimport { DarkTheme, LightTheme } from \"../themes/babylonTheme\";\r\nimport { useObservableState } from \"./observableHooks\";\r\nimport { useResource } from \"./resourceHooks\";\r\n\r\n/**\r\n * Hook that provides the current theme mode state and controls for changing it.\r\n * @returns An object with the current dark mode state, theme mode, and functions to set or toggle the theme.\r\n */\r\nexport function useThemeMode() {\r\n    const settingsStore = useSettingsStore();\r\n    const themeResolver = useResource(useCallback(() => (settingsStore ? new ThemeResolver(settingsStore) : undefined), [settingsStore]));\r\n\r\n    const state = useObservableState(\r\n        useCallback(\r\n            () =>\r\n                ({\r\n                    isDarkMode: themeResolver?.isDark ?? false,\r\n                    themeMode: themeResolver?.mode ?? ThemeModeSettingDescriptor.defaultValue,\r\n                    setThemeMode: (mode: ThemeMode) => {\r\n                        if (themeResolver) {\r\n                            themeResolver.mode = mode;\r\n                        }\r\n                    },\r\n                    toggleThemeMode: () => themeResolver?.toggle(),\r\n                }) as const,\r\n            [themeResolver]\r\n        ),\r\n        themeResolver?.onChanged\r\n    );\r\n\r\n    if (!themeResolver) {\r\n        throw new Error(\"Settings store is not available in context.\");\r\n    }\r\n\r\n    return state;\r\n}\r\n\r\n/**\r\n * Hook that returns the current Fluent UI theme based on the active theme mode.\r\n * @param invert If true, inverts the theme (returns light theme in dark mode and vice versa). Defaults to false.\r\n * @returns The current Fluent UI theme object.\r\n */\r\nexport function useTheme(invert = false) {\r\n    const { isDarkMode } = useThemeMode();\r\n    return isDarkMode !== invert ? DarkTheme : LightTheme;\r\n}\r\n"]}