@leav/ui 1.14.0 → 1.15.0-1

package/dist/hooks/useIFrameMessengerClient/IFrameMessengerClientProvider.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect } from 'react';
+import { usePanelMessenger } from '../../hooks/usePanelMessenger/usePanelMessenger';
+import { IFrameMessengerClientContext } from './IFrameMessengerClientContext';
+export const IFrameMessengerClientProvider = ({ children, id }) => {
+    const iFrameMessenger = usePanelMessenger({ id });
+    useEffect(() => () => iFrameMessenger.unregister(), []);
+    if (!iFrameMessenger.isRegistered) {
+        return null;
+    }
+    return (_jsx(IFrameMessengerClientContext.Provider, { value: iFrameMessenger, children: children }));
+};
+//# sourceMappingURL=IFrameMessengerClientProvider.js.map

package/dist/hooks/useIFrameMessengerClient/IFrameMessengerClientProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFrameMessengerClientProvider.js","sourceRoot":"","sources":["../../../src/hooks/useIFrameMessengerClient/IFrameMessengerClientProvider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAyC,SAAS,EAAC,MAAM,OAAO,CAAC;AACxE,OAAO,EAAC,iBAAiB,EAAC,MAAM,+CAA+C,CAAC;AAChF,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAO5E,MAAM,CAAC,MAAM,6BAA6B,GAAkD,CAAC,EAAC,QAAQ,EAAE,EAAE,EAAC,EAAE,EAAE;IAC3G,MAAM,eAAe,GAAG,iBAAiB,CAAC,EAAC,EAAE,EAAC,CAAC,CAAC;IAEhD,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAExD,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,CACH,KAAC,4BAA4B,CAAC,QAAQ,IAAC,KAAK,EAAE,eAAe,YACxD,QAAQ,GAC2B,CAC3C,CAAC;AACN,CAAC,CAAC","sourcesContent":["import {type FunctionComponent, type ReactNode, useEffect} from 'react';\nimport {usePanelMessenger} from '_ui/hooks/usePanelMessenger/usePanelMessenger';\nimport {IFrameMessengerClientContext} from './IFrameMessengerClientContext';\n\ninterface IFrameMessengerClientProps {\n    children: ReactNode;\n    id?: string;\n}\n\nexport const IFrameMessengerClientProvider: FunctionComponent<IFrameMessengerClientProps> = ({children, id}) => {\n    const iFrameMessenger = usePanelMessenger({id});\n\n    useEffect(() => () => iFrameMessenger.unregister(), []);\n\n    if (!iFrameMessenger.isRegistered) {\n        return null;\n    }\n\n    return (\n        <IFrameMessengerClientContext.Provider value={iFrameMessenger}>\n            {children}\n        </IFrameMessengerClientContext.Provider>\n    );\n};\n"]}

package/dist/hooks/useIFrameMessengerClient/index.d.ts

@@ -0,0 +1,2 @@
+export { useIFrameMessengerClient } from './useIFrameMessengerClient';
+export { IFrameMessengerClientProvider } from './IFrameMessengerClientProvider';

package/dist/hooks/useIFrameMessengerClient/index.js

@@ -0,0 +1,3 @@
+export { useIFrameMessengerClient } from './useIFrameMessengerClient';
+export { IFrameMessengerClientProvider } from './IFrameMessengerClientProvider';
+//# sourceMappingURL=index.js.map

package/dist/hooks/useIFrameMessengerClient/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/useIFrameMessengerClient/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,wBAAwB,EAAC,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAC,6BAA6B,EAAC,MAAM,iCAAiC,CAAC","sourcesContent":["export {useIFrameMessengerClient} from './useIFrameMessengerClient';\nexport {IFrameMessengerClientProvider} from './IFrameMessengerClientProvider';\n"]}

package/dist/hooks/useIFrameMessengerClient/useIFrameMessengerClient.d.ts

@@ -2,18 +2,19 @@ export declare const useIFrameMessengerClient: () => {
     isRegistered: boolean;
     unregister: () => void;
     changeLangInAllFrames: (newLanguage: string) => void;
-    addPanelMessageHandler: import("../useIFrameMessenger/types").AddMessageToPanelMessageHandler;
-    showModalConfirm: (data: import("../useIFrameMessenger/types").ModalConfirmMessage["data"]) => void;
-    showAlert: (data: import("../useIFrameMessenger/types").AlertMessage["data"]) => void;
-    showNotification: (data: import("../useIFrameMessenger/types").NotificationMessage["data"]) => void;
-    messageToParent: (data: import("../useIFrameMessenger/types").SimpleMessage["data"]) => void;
-    navigateToPanel: (data: import("../useIFrameMessenger/types").NavigateToPanelMessage["data"]) => void;
-    closePanel: (data: import("../useIFrameMessenger/types").ClosePanelMessage["data"]) => void;
-    navigateToIframe: (data: import("../useIFrameMessenger/types").NavigateToIframeMessage["data"]) => void;
-    messageToPanel: (data: import("../useIFrameMessenger/types").MessageToPanelMessage["data"]) => void;
-    openFlapPanel: (data: import("../useIFrameMessenger/types").OpenFlapPanelMessage["data"]) => void;
+    addPanelMessageHandler: import("..").AddMessageToPanelMessageHandler;
+    addInternalEventHandler: import("..").AddInternalEventHandler;
+    showModalConfirm: (data: import("..").ModalConfirmMessage["data"]) => void;
+    showAlert: (data: import("..").AlertMessage["data"]) => void;
+    showNotification: (data: import("..").NotificationMessage["data"]) => void;
+    messageToParent: (data: import("..").SimpleMessage["data"]) => void;
+    navigateToPanel: (data: import("..").NavigateToPanelMessage["data"]) => void;
+    closePanel: (data: import("..").ClosePanelMessage["data"]) => void;
+    navigateToIframe: (data: import("..").NavigateToIframeMessage["data"]) => void;
+    messageToPanel: (data: import("..").MessageToPanelMessage["data"]) => void;
+    openFlapPanel: (data: import("..").OpenFlapPanelMessage["data"]) => void;
     closeFlapPanel: () => void;
-    getPanelConfig: (data: import("../useIFrameMessenger/types").GetPanelConfigMessage["data"]) => void;
-    getUrl: (data: import("../useIFrameMessenger/types").GetUrlMessage["data"]) => void;
-    explorerViewChanged: (data: import("../useIFrameMessenger/types").ExplorerViewChangedMessage["data"]) => void;
+    getPanelConfig: (data: import("..").GetPanelConfigMessage["data"]) => void;
+    getUrl: (data: import("..").GetUrlMessage["data"]) => void;
+    explorerViewChanged: (data: import("..").ExplorerViewChangedMessage["data"]) => void;
 };

package/dist/hooks/useIFrameMessengerClient/useIFrameMessengerClient.js

@@ -1,7 +1,7 @@
 import { useContext } from 'react';
-import { IframeMessengerClientContext } from './iFrameMessengerClientContext';
+import { IFrameMessengerClientContext } from './IFrameMessengerClientContext';
 export const useIFrameMessengerClient = () => {
-    const context = useContext(IframeMessengerClientContext);
+    const context = useContext(IFrameMessengerClientContext);
     if (!context) {
         throw new Error('IframeMessengerClientContext must be used within an IframeMessengerClient');
     }

package/dist/hooks/useIFrameMessengerClient/useIFrameMessengerClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"useIFrameMessengerClient.js","sourceRoot":"","sources":["../../../src/hooks/useIFrameMessengerClient/useIFrameMessengerClient.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAE5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,EAAE;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,4BAA4B,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC","sourcesContent":["import {useContext} from 'react';\nimport {IframeMessengerClientContext} from './iFrameMessengerClientContext';\n\nexport const useIFrameMessengerClient = () => {\n    const context = useContext(IframeMessengerClientContext);\n    if (!context) {\n        throw new Error('IframeMessengerClientContext must be used within an IframeMessengerClient');\n    }\n    return context;\n};\n"]}
+{"version":3,"file":"useIFrameMessengerClient.js","sourceRoot":"","sources":["../../../src/hooks/useIFrameMessengerClient/useIFrameMessengerClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAE5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,EAAE;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,4BAA4B,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC","sourcesContent":["import {useContext} from 'react';\nimport {IFrameMessengerClientContext} from './IFrameMessengerClientContext';\n\nexport const useIFrameMessengerClient = () => {\n    const context = useContext(IFrameMessengerClientContext);\n    if (!context) {\n        throw new Error('IframeMessengerClientContext must be used within an IframeMessengerClient');\n    }\n    return context;\n};\n"]}

package/dist/hooks/useLang/__mocks__/useLang.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLang.js","sourceRoot":"","sources":["../../../../src/hooks/useLang/__mocks__/useLang.tsx"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;IAClB,cAAc,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;IAC5B,WAAW,EAAE,IAAI;CACpB,CAAC,CAAC;AAEH,eAAe,WAAW,CAAC","sourcesContent":["const mockUseLang = () => ({\n    lang: ['fr', 'en'],\n    availableLangs: ['fr', 'en'],\n    defaultLang: 'fr',\n});\n\nexport default mockUseLang;\n"]}
+{"version":3,"file":"useLang.js","sourceRoot":"","sources":["../../../../src/hooks/useLang/__mocks__/useLang.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;IAClB,cAAc,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;IAC5B,WAAW,EAAE,IAAI;CACpB,CAAC,CAAC;AAEH,eAAe,WAAW,CAAC","sourcesContent":["const mockUseLang = () => ({\n    lang: ['fr', 'en'],\n    availableLangs: ['fr', 'en'],\n    defaultLang: 'fr',\n});\n\nexport default mockUseLang;\n"]}

package/dist/hooks/useLang/useLang.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLang.js","sourceRoot":"","sources":["../../../src/hooks/useLang/useLang.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,EAAoB,WAAW,EAAC,MAAM,4BAA4B,CAAC;AAE1E,MAAM,OAAO,GAAG,GAAiB,EAAE;IAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAErC,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,eAAe,OAAO,CAAC","sourcesContent":["import {useContext} from 'react';\nimport {type ILangContext, LangContext} from '../../contexts/LangContext';\n\nconst useLang = (): ILangContext => {\n    const lang = useContext(LangContext);\n\n    if (!lang) {\n        throw new Error('useLang must be used inside a <LangContext.Provider />');\n    }\n\n    return lang;\n};\n\nexport default useLang;\n"]}
+{"version":3,"file":"useLang.js","sourceRoot":"","sources":["../../../src/hooks/useLang/useLang.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,EAAoB,WAAW,EAAC,MAAM,4BAA4B,CAAC;AAE1E,MAAM,OAAO,GAAG,GAAiB,EAAE;IAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAErC,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,eAAe,OAAO,CAAC","sourcesContent":["import {useContext} from 'react';\nimport {type ILangContext, LangContext} from '../../contexts/LangContext';\n\nconst useLang = (): ILangContext => {\n    const lang = useContext(LangContext);\n\n    if (!lang) {\n        throw new Error('useLang must be used inside a <LangContext.Provider />');\n    }\n\n    return lang;\n};\n\nexport default useLang;\n"]}

package/dist/hooks/usePanelMessenger/PanelMessengerProvider.d.ts

@@ -0,0 +1,13 @@
+import { type ReactNode } from 'react';
+/**
+ * Singleton Provider for the PanelMessenger system.
+ * Must be mounted once above all `PanelCustom` instances.
+ *
+ * Owns a single `window.addEventListener('message')` (via `usePanelMessenger`)
+ * and routes incoming messages to the correct panel's handlers using `handlersMap`.
+ *
+ * Each `PanelCustom` registers/deregisters its handlers via `usePanelIFrameHandlers`.
+ */
+export declare const PanelMessengerProvider: ({ children }: {
+    children: ReactNode;
+}) => JSX.Element;

package/dist/hooks/{useIFrameMessenger/useIFrameMessengerContext.js → usePanelMessenger/PanelMessengerProvider.js}

@@ -1,18 +1,18 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useCallback, useMemo, useRef } from 'react';
-import { useIFrameMessenger } from './useIFrameMessenger';
+import { usePanelMessenger } from './usePanelMessenger';
 import { encodeMessage, initClientHandlers } from './messageHandlers';
-import { IFrameMessengerContext } from './iFrameMessengerContext';
+import { PanelMessengerContext } from './panelMessengerContext';
 /**
- * Singleton Provider for the IFrameMessenger system.
+ * Singleton Provider for the PanelMessenger system.
  * Must be mounted once above all `PanelCustom` instances.
  *
- * Owns a single `window.addEventListener('message')` (via `useIFrameMessenger`)
- * and routes incoming messages to the correct iframe's handlers using `handlersMap`.
+ * Owns a single `window.addEventListener('message')` (via `usePanelMessenger`)
+ * and routes incoming messages to the correct panel's handlers using `handlersMap`.
  *
- * Each `PanelCustom` registers/deregisters its handlers via `useIFrameMessengerHandlers`.
+ * Each `PanelCustom` registers/deregisters its handlers via `usePanelIFrameHandlers`.
  */
-export const IFrameMessengerProvider = ({ children }) => {
+export const PanelMessengerProvider = ({ children }) => {
     // Maps each iframe's RefObject to its set of handlers.
     // Using RefObject as key (instead of Window) avoids timing issues: contentWindow
     // may not be available yet when the iframe mounts and registers its handlers.
@@ -20,7 +20,7 @@ export const IFrameMessengerProvider = ({ children }) => {
     // Maps native React panel IDs to their handlers.
     // Same-window postMessage is used as transport: __targetPanelId in the envelope routes to the right entry.
     const nativePanelHandlersMap = useRef(new Map());
-    // Called by useIFrameMessenger for every non-system message.
+    // Called by usePanelMessenger for every non-system message.
     // Finds the handlers registered for the sender and dispatches the message to them.
     const onMessageReceived = useCallback((senderWindow, message, panelId, dispatch, callCb, callbacksStore) => {
         // event.source is null when the sender iframe was unmounted before the message
@@ -60,7 +60,10 @@ export const IFrameMessengerProvider = ({ children }) => {
         const clientHandlers = initClientHandlers(callCb, { handlers: matchedHandlers }, callbacksStore);
         clientHandlers(enrichedMessage, dispatch);
     }, []);
-    const { changeLangInAllFrames } = useIFrameMessenger({ onMessageReceived });
+    const { changeLangInAllFrames, addInternalEventHandler } = usePanelMessenger({ onMessageReceived });
+    const dispatchToSelf = useCallback((message) => {
+        window.postMessage(encodeMessage(message), '*');
+    }, []);
     const registerHandlers = useCallback((iframeRef, handlers) => {
         handlersMap.current.set(iframeRef, handlers);
         return () => handlersMap.current.delete(iframeRef);
@@ -72,7 +75,14 @@ export const IFrameMessengerProvider = ({ children }) => {
     const dispatchToNativePanel = useCallback((panelId, message) => {
         window.postMessage(encodeMessage({ ...message, __targetPanelId: panelId }), '*');
     }, []);
-    const contextValue = useMemo(() => ({ registerHandlers, registerNativePanelHandlers, dispatchToNativePanel, changeLangInAllFrames }), []);
-    return _jsx(IFrameMessengerContext.Provider, { value: contextValue, children: children });
+    const contextValue = useMemo(() => ({
+        registerHandlers,
+        registerNativePanelHandlers,
+        dispatchToNativePanel,
+        changeLangInAllFrames,
+        addInternalEventHandler,
+        dispatchToSelf,
+    }), []);
+    return _jsx(PanelMessengerContext.Provider, { value: contextValue, children: children });
 };
-//# sourceMappingURL=useIFrameMessengerContext.js.map
+//# sourceMappingURL=PanelMessengerProvider.js.map

package/dist/hooks/usePanelMessenger/PanelMessengerProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PanelMessengerProvider.js","sourceRoot":"","sources":["../../../src/hooks/usePanelMessenger/PanelMessengerProvider.tsx"],"names":[],"mappings":"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","sourcesContent":["import {type MutableRefObject, type ReactNode, type RefObject, useCallback, useMemo, useRef} from 'react';\nimport {usePanelMessenger} from './usePanelMessenger';\nimport {encodeMessage, initClientHandlers} from './messageHandlers';\nimport {\n    type Callbacks,\n    type CallCbFunction,\n    type InternalEventMessage,\n    type Message,\n    type MessageDispatcher,\n    type IUsePanelMessengerOptions,\n    type RegisterHandlers,\n    type RegisterNativePanelHandlers,\n} from './types';\nimport {PanelMessengerContext} from './panelMessengerContext';\n\n/**\n * Singleton Provider for the PanelMessenger system.\n * Must be mounted once above all `PanelCustom` instances.\n *\n * Owns a single `window.addEventListener('message')` (via `usePanelMessenger`)\n * and routes incoming messages to the correct panel's handlers using `handlersMap`.\n *\n * Each `PanelCustom` registers/deregisters its handlers via `usePanelIFrameHandlers`.\n */\nexport const PanelMessengerProvider = ({children}: {children: ReactNode}) => {\n    // Maps each iframe's RefObject to its set of handlers.\n    // Using RefObject as key (instead of Window) avoids timing issues: contentWindow\n    // may not be available yet when the iframe mounts and registers its handlers.\n    const handlersMap = useRef(new Map<RefObject<HTMLIFrameElement>, IUsePanelMessengerOptions['handlers']>());\n\n    // Maps native React panel IDs to their handlers.\n    // Same-window postMessage is used as transport: __targetPanelId in the envelope routes to the right entry.\n    const nativePanelHandlersMap = useRef(new Map<string, IUsePanelMessengerOptions['handlers']>());\n\n    // Called by usePanelMessenger for every non-system message.\n    // Finds the handlers registered for the sender and dispatches the message to them.\n    const onMessageReceived = useCallback(\n        (\n            senderWindow: Window | null,\n            message: Message,\n            panelId: string | null,\n            dispatch: MessageDispatcher,\n            callCb: CallCbFunction,\n            callbacksStore: MutableRefObject<Callbacks>,\n        ) => {\n            // event.source is null when the sender iframe was unmounted before the message\n            // was processed — the browser clears the reference on iframe removal.\n            if (!senderWindow) {\n                return;\n            }\n\n            // Same-window message: dispatched via dispatchToNativePanel.\n            // Route to the native panel identified by __targetPanelId.\n            if (senderWindow === window) {\n                const targetPanelId = message.__targetPanelId;\n                if (!targetPanelId) {\n                    return;\n                }\n                const handlers = nativePanelHandlersMap.current.get(targetPanelId);\n                if (!handlers) {\n                    return;\n                }\n                const clientHandlers = initClientHandlers(callCb, {handlers}, callbacksStore);\n                clientHandlers(message, dispatch);\n                return;\n            }\n\n            let matchedHandlers: IUsePanelMessengerOptions['handlers'] | undefined;\n            for (const [ref, handlers] of handlersMap.current) {\n                if (ref.current?.contentWindow === senderWindow) {\n                    matchedHandlers = handlers;\n                    break;\n                }\n            }\n\n            // No registered handlers for this sender: either the iframe called unregisterHandlers\n            // before its last message was processed (race condition on unmount), or the message\n            // originates from an unrelated frame that passed decodeMessage validation.\n            if (!matchedHandlers) {\n                return;\n            }\n\n            const enrichedMessage =\n                message.type === 'get-panel-config' ? {...message, data: {...message.data, panelId}} : message;\n\n            const clientHandlers = initClientHandlers(callCb, {handlers: matchedHandlers}, callbacksStore);\n            clientHandlers(enrichedMessage, dispatch);\n        },\n        [],\n    );\n\n    const {changeLangInAllFrames, addInternalEventHandler} = usePanelMessenger({onMessageReceived});\n\n    const dispatchToSelf = useCallback((message: InternalEventMessage) => {\n        window.postMessage(encodeMessage(message as unknown as Message), '*');\n    }, []);\n\n    const registerHandlers: RegisterHandlers = useCallback((iframeRef, handlers) => {\n        handlersMap.current.set(iframeRef, handlers);\n        return () => handlersMap.current.delete(iframeRef);\n    }, []);\n\n    const registerNativePanelHandlers: RegisterNativePanelHandlers = useCallback((panelId, handlers) => {\n        nativePanelHandlersMap.current.set(panelId, handlers);\n        return () => nativePanelHandlersMap.current.delete(panelId);\n    }, []);\n\n    const dispatchToNativePanel = useCallback((panelId: string, message: Message) => {\n        window.postMessage(encodeMessage({...message, __targetPanelId: panelId}), '*');\n    }, []);\n\n    const contextValue = useMemo(\n        () => ({\n            registerHandlers,\n            registerNativePanelHandlers,\n            dispatchToNativePanel,\n            changeLangInAllFrames,\n            addInternalEventHandler,\n            dispatchToSelf,\n        }),\n        [],\n    );\n\n    return <PanelMessengerContext.Provider value={contextValue}>{children}</PanelMessengerContext.Provider>;\n};\n"]}

package/dist/hooks/usePanelMessenger/index.d.ts

@@ -0,0 +1,6 @@
+export { usePanelMessenger as useIFrameMessenger } from './usePanelMessenger';
+export { creationPanelSchema } from './schema';
+export { usePanelIFrameHandlers } from './usePanelIFrameHandlers';
+export { PanelMessengerProvider } from './PanelMessengerProvider';
+export { usePanelEventHandlers } from './usePanelEventHandlers';
+export type { Message, MessageToParent, MessageFromParent, ModalConfirmMessage, AlertMessage, NotificationMessage, ChangeLanguageMessage, SimpleMessage, RegisterMessage, UnregisterMessage, IsRegisteredMessage, NavigateToPanelMessage, ClosePanelMessage, NavigateToIframeMessage, MessageToPanelMessage, OpenFlapPanelMessage, CloseFlapPanelMessage, GetUrlMessage, GetPanelConfigMessage, ExplorerViewChangedMessage, ViewSettingsUpdateMessage, MessageHandler, MessageDispatcher, MessageToPanelMessageHandler, AddMessageToPanelMessageHandler, InternalEventMessage, InternalEventHandler, AddInternalEventHandler, } from './types';

package/dist/hooks/usePanelMessenger/index.js

@@ -0,0 +1,6 @@
+export { usePanelMessenger as useIFrameMessenger } from './usePanelMessenger';
+export { creationPanelSchema } from './schema';
+export { usePanelIFrameHandlers } from './usePanelIFrameHandlers';
+export { PanelMessengerProvider } from './PanelMessengerProvider';
+export { usePanelEventHandlers } from './usePanelEventHandlers';
+//# sourceMappingURL=index.js.map

package/dist/hooks/usePanelMessenger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/usePanelMessenger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,IAAI,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAC,mBAAmB,EAAC,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC","sourcesContent":["export {usePanelMessenger as useIFrameMessenger} from './usePanelMessenger';\nexport {creationPanelSchema} from './schema';\nexport {usePanelIFrameHandlers} from './usePanelIFrameHandlers';\nexport {PanelMessengerProvider} from './PanelMessengerProvider';\nexport {usePanelEventHandlers} from './usePanelEventHandlers';\nexport type {\n    Message,\n    MessageToParent,\n    MessageFromParent,\n    ModalConfirmMessage,\n    AlertMessage,\n    NotificationMessage,\n    ChangeLanguageMessage,\n    SimpleMessage,\n    RegisterMessage,\n    UnregisterMessage,\n    IsRegisteredMessage,\n    NavigateToPanelMessage,\n    ClosePanelMessage,\n    NavigateToIframeMessage,\n    MessageToPanelMessage,\n    OpenFlapPanelMessage,\n    CloseFlapPanelMessage,\n    GetUrlMessage,\n    GetPanelConfigMessage,\n    ExplorerViewChangedMessage,\n    ViewSettingsUpdateMessage,\n    MessageHandler,\n    MessageDispatcher,\n    MessageToPanelMessageHandler,\n    AddMessageToPanelMessageHandler,\n    InternalEventMessage,\n    InternalEventHandler,\n    AddInternalEventHandler,\n} from './types';\n"]}

package/dist/hooks/{useIFrameMessenger → usePanelMessenger}/messageHandlers.d.ts

@@ -1,8 +1,8 @@
 import { type MutableRefObject } from 'react';
-import { type AlertMessage, type Callbacks, type CallCbFunction, type ClosePanelMessage, type ExplorerViewChangedMessage, type IUseIFrameMessengerOptions, type GetUrlMessage, type Message, type MessageDispatcher, type MessageHandler, type MessageToPanelMessage, type ModalConfirmMessage, type NavigateToIframeMessage, type NavigateToPanelMessage, type NotificationMessage, type SimpleMessage, type OpenFlapPanelMessage, type GetPanelConfigMessage } from './types';
+import { type AlertMessage, type Callbacks, type CallCbFunction, type ClosePanelMessage, type ExplorerViewChangedMessage, type IUsePanelMessengerOptions, type GetUrlMessage, type Message, type MessageDispatcher, type MessageHandler, type MessageToPanelMessage, type ModalConfirmMessage, type NavigateToIframeMessage, type NavigateToPanelMessage, type NotificationMessage, type SimpleMessage, type OpenFlapPanelMessage, type GetPanelConfigMessage } from './types';
 export declare const encodeMessage: (message: Message) => string;
 export declare const decodeMessage: (raw: string) => Message | undefined;
-export declare const initClientHandlers: (callCb: CallCbFunction, options?: IUseIFrameMessengerOptions, callbacksList?: MutableRefObject<Callbacks>) => MessageHandler;
+export declare const initClientHandlers: (callCb: CallCbFunction, options?: IUsePanelMessengerOptions, callbacksList?: MutableRefObject<Callbacks>) => MessageHandler;
 export declare const getExposedMethods: (callbacksStore: MutableRefObject<Callbacks>, dispatch?: MessageDispatcher) => {
     showModalConfirm: (data: ModalConfirmMessage["data"]) => void;
     showAlert: (data: AlertMessage["data"]) => void;

package/dist/hooks/{useIFrameMessenger → usePanelMessenger}/messageHandlers.js

@@ -78,7 +78,7 @@ export const initClientHandlers = (callCb, options, callbacksList) => (message,
         case 'explorer-view-changed':
             options?.handlers?.onExplorerViewChanged?.(message.data);
             break;
-        case 'view-config-update':
+        case 'view-settings-update':
             options?.handlers?.onViewConfigUpdate?.(message.data);
             break;
         default:

package/dist/hooks/usePanelMessenger/messageHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageHandlers.js","sourceRoot":"","sources":["../../../src/hooks/usePanelMessenger/messageHandlers.ts"],"names":[],"mappings":"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","sourcesContent":["import {type MutableRefObject} from 'react';\nimport {\n    type AlertMessage,\n    type CallbackFunction,\n    type Callbacks,\n    type CallCbFunction,\n    type ClosePanelMessage,\n    type ExplorerViewChangedMessage,\n    type IEncodedMessage,\n    type IUsePanelMessengerOptions,\n    type GetUrlMessage,\n    type Message,\n    type MessageDispatcher,\n    type MessageHandler,\n    type MessageToPanelMessage,\n    type ModalConfirmMessage,\n    type NavigateToIframeMessage,\n    type NavigateToPanelMessage,\n    type NotificationMessage,\n    packetId,\n    type SimpleMessage,\n    type OpenFlapPanelMessage,\n    type GetPanelConfigMessage,\n    type ViewSettingsUpdateMessage,\n} from './types';\n\nexport const encodeMessage = (message: Message): string =>\n    JSON.stringify({\n        payload: JSON.stringify(message),\n        [packetId]: true,\n    });\n\nexport const decodeMessage = (raw: string): Message | undefined => {\n    try {\n        const decoded: IEncodedMessage = JSON.parse(raw) as unknown as IEncodedMessage;\n        if (packetId in decoded && decoded[packetId] === true) {\n            return JSON.parse(decoded.payload) as Message;\n        }\n    } catch (e) {\n        return undefined;\n    }\n    return undefined;\n};\n\nconst getCallback = (path: string, callbacksList?: MutableRefObject<Callbacks>): CallbackFunction | null => {\n    if (!callbacksList?.current) {\n        return null;\n    }\n    const pathArray = path.split('.');\n    let callback: CallbackFunction | Callbacks | Record<string, CallbackFunction> = callbacksList.current;\n    pathArray.forEach(part => (callback = (callback as Callbacks | Record<string, CallbackFunction>)?.[part]));\n    return typeof callback === 'function' ? callback : null;\n};\n\nconst setCallbacks = (\n    id: string,\n    frameId: string,\n    data: unknown,\n    callCb: CallCbFunction,\n    overrides?: string[],\n): unknown => {\n    if (!overrides) {\n        return data;\n    }\n\n    const nextData = {...(data as Record<string, unknown>)};\n    overrides.forEach((key: string) => {\n        nextData[key] = (...args: unknown[]) => {\n            callCb(`${id}.${key}`, args, frameId);\n        };\n    });\n    return nextData;\n};\n\nexport const initClientHandlers: (\n    callCb: CallCbFunction,\n    options?: IUsePanelMessengerOptions,\n    callbacksList?: MutableRefObject<Callbacks>,\n) => MessageHandler = (callCb, options, callbacksList) => (message, dispatch) => {\n    switch (message.type) {\n        case 'modal-confirm':\n            options?.handlers?.onModalConfirm?.(\n                setCallbacks(\n                    message.id,\n                    message.__frameId,\n                    message.data,\n                    callCb,\n                    message.overrides,\n                ) as ModalConfirmMessage['data'],\n                message.id,\n                dispatch,\n                callCb,\n            );\n            break;\n        case 'alert':\n            options?.handlers?.onAlert?.(\n                setCallbacks(\n                    message.id,\n                    message.__frameId,\n                    message.data,\n                    callCb,\n                    message.overrides,\n                ) as AlertMessage['data'],\n                message.id,\n                dispatch,\n                callCb,\n            );\n            break;\n        case 'notification':\n            options?.handlers?.onNotification?.(\n                setCallbacks(\n                    message.id,\n                    message.__frameId,\n                    message.data,\n                    callCb,\n                    message.overrides,\n                ) as NotificationMessage['data'],\n                message.id,\n                dispatch,\n                callCb,\n            );\n            break;\n        case 'message':\n            options?.handlers?.onMessage?.(message.data, message.id, dispatch, callCb);\n            break;\n        case 'on-call-callback':\n            // TODO How to know if handler can be removed from callbacksList ?\n            getCallback(message.path, callbacksList)?.(...(message.data as never[]));\n            break;\n        case 'navigate-to-panel':\n            options?.handlers?.onNavigateToPanel?.(message.data);\n            break;\n        case 'close-panel':\n            options?.handlers?.onClosePanel?.(message.data);\n            break;\n        case 'navigate-to-iframe':\n            options?.handlers?.onNavigateToIframe?.(message.data);\n            break;\n        case 'open-flap-panel':\n            options?.handlers?.onOpenFlapPanel?.(message.data);\n            break;\n        case 'close-flap-panel':\n            options?.handlers?.onCloseFlapPanel?.();\n            break;\n        case 'get-panel-config':\n            options?.handlers?.onGetPanelConfig?.(\n                setCallbacks(\n                    message.id,\n                    message.__frameId,\n                    message.data,\n                    callCb,\n                    message.overrides,\n                ) as GetPanelConfigMessage['data'],\n                message.id,\n                dispatch,\n                callCb,\n            );\n            break;\n        case 'get-url':\n            options?.handlers?.onGetUrl?.(\n                setCallbacks(\n                    message.id,\n                    message.__frameId,\n                    message.data,\n                    callCb,\n                    message.overrides,\n                ) as GetUrlMessage['data'],\n            );\n            break;\n        case 'explorer-view-changed':\n            options?.handlers?.onExplorerViewChanged?.(message.data as ExplorerViewChangedMessage['data']);\n            break;\n        case 'view-settings-update':\n            options?.handlers?.onViewConfigUpdate?.(message.data as ViewSettingsUpdateMessage['data']);\n            break;\n        default:\n            break;\n    }\n};\n\nconst storeCallbacks = (\n    data: unknown,\n    id: string,\n    callbacksStore: MutableRefObject<Callbacks>,\n): {data: unknown; overrides: string[]} => {\n    const nextData = {...(data as Record<string, unknown>)};\n    const overrides: string[] = [];\n    Object.entries(nextData).forEach(([key, value]) => {\n        if (typeof value === 'function') {\n            callbacksStore.current[id] = {\n                ...callbacksStore.current[id],\n                [key]: value as CallbackFunction,\n            };\n            overrides.push(key);\n        }\n    });\n    return {data: nextData, overrides};\n};\n\nexport const getExposedMethods = (callbacksStore: MutableRefObject<Callbacks>, dispatch?: MessageDispatcher) => ({\n    showModalConfirm: (data: ModalConfirmMessage['data']) => {\n        const id = Date.now().toString();\n        const {data: nextData, overrides} = storeCallbacks(data, id, callbacksStore);\n        dispatch?.({type: 'modal-confirm', data: nextData as ModalConfirmMessage['data'], id, overrides});\n    },\n    showAlert: (data: AlertMessage['data']) => {\n        const id = Date.now().toString();\n        const {data: nextData, overrides} = storeCallbacks(data, id, callbacksStore);\n        dispatch?.({type: 'alert', data: nextData as AlertMessage['data'], id, overrides});\n    },\n    showNotification: (data: NotificationMessage['data']) => {\n        const id = Date.now().toString();\n        const {data: nextData, overrides} = storeCallbacks(data, id, callbacksStore);\n        dispatch?.({type: 'notification', data: nextData as NotificationMessage['data'], id, overrides});\n    },\n    messageToParent: (data: SimpleMessage['data']) => {\n        const id = Date.now().toString();\n        dispatch?.({type: 'message', data, id});\n    },\n    navigateToPanel: (data: NavigateToPanelMessage['data']) => {\n        dispatch?.({type: 'navigate-to-panel', data});\n    },\n    closePanel: (data: ClosePanelMessage['data']) => {\n        dispatch?.({type: 'close-panel', data});\n    },\n    navigateToIframe: (data: NavigateToIframeMessage['data']) => {\n        dispatch?.({type: 'navigate-to-iframe', data});\n    },\n    messageToPanel: (data: MessageToPanelMessage['data']) => {\n        dispatch?.({type: 'message-to-panel', data});\n    },\n    openFlapPanel: (data: OpenFlapPanelMessage['data']) => {\n        dispatch?.({type: 'open-flap-panel', data});\n    },\n    closeFlapPanel: () => {\n        dispatch?.({type: 'close-flap-panel'});\n    },\n    getPanelConfig: (data: GetPanelConfigMessage['data']) => {\n        const id = Date.now().toString();\n        const {data: nextData, overrides} = storeCallbacks(data, id, callbacksStore);\n        dispatch?.({type: 'get-panel-config', data: nextData as GetPanelConfigMessage['data'], id, overrides});\n    },\n    getUrl: (data: GetUrlMessage['data']) => {\n        const id = Date.now().toString();\n        const {data: nextData, overrides} = storeCallbacks(data, id, callbacksStore);\n        dispatch?.({type: 'get-url', data: nextData as GetUrlMessage['data'], id, overrides});\n    },\n    explorerViewChanged: (data: ExplorerViewChangedMessage['data']) => {\n        dispatch?.({type: 'explorer-view-changed', data});\n    },\n});\n"]}

package/dist/hooks/usePanelMessenger/panelMessengerContext.d.ts

@@ -0,0 +1,10 @@
+import { type AddInternalEventHandler, type DispatchToNativePanel, type InternalEventMessage, type RegisterHandlers, type RegisterNativePanelHandlers } from './types';
+export interface IPanelMessengerContext {
+    registerHandlers: RegisterHandlers;
+    registerNativePanelHandlers: RegisterNativePanelHandlers;
+    dispatchToNativePanel: DispatchToNativePanel;
+    changeLangInAllFrames: (language: string) => void;
+    addInternalEventHandler: AddInternalEventHandler;
+    dispatchToSelf: (message: InternalEventMessage) => void;
+}
+export declare const PanelMessengerContext: import("react").Context<IPanelMessengerContext>;

package/dist/hooks/{useIFrameMessenger/iFrameMessengerContext.js → usePanelMessenger/panelMessengerContext.js}

@@ -1,5 +1,5 @@
 // Kept in a separate file from the Provider component to satisfy the
 // react-refresh/only-export-components ESLint rule (Context is not a component).
 import { createContext } from 'react';
-export const IFrameMessengerContext = createContext(null);
-//# sourceMappingURL=iFrameMessengerContext.js.map
+export const PanelMessengerContext = createContext(null);
+//# sourceMappingURL=panelMessengerContext.js.map

package/dist/hooks/usePanelMessenger/panelMessengerContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panelMessengerContext.js","sourceRoot":"","sources":["../../../src/hooks/usePanelMessenger/panelMessengerContext.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,iFAAiF;AACjF,OAAO,EAAC,aAAa,EAAC,MAAM,OAAO,CAAC;AAkBpC,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAyB,IAAI,CAAC,CAAC","sourcesContent":["// Kept in a separate file from the Provider component to satisfy the\n// react-refresh/only-export-components ESLint rule (Context is not a component).\nimport {createContext} from 'react';\nimport {\n    type AddInternalEventHandler,\n    type DispatchToNativePanel,\n    type InternalEventMessage,\n    type RegisterHandlers,\n    type RegisterNativePanelHandlers,\n} from './types';\n\nexport interface IPanelMessengerContext {\n    registerHandlers: RegisterHandlers;\n    registerNativePanelHandlers: RegisterNativePanelHandlers;\n    dispatchToNativePanel: DispatchToNativePanel;\n    changeLangInAllFrames: (language: string) => void;\n    addInternalEventHandler: AddInternalEventHandler;\n    dispatchToSelf: (message: InternalEventMessage) => void;\n}\n\nexport const PanelMessengerContext = createContext<IPanelMessengerContext>(null);\n"]}

package/dist/hooks/{useIFrameMessenger → usePanelMessenger}/schema.d.ts

@@ -5,6 +5,7 @@ export declare const LanguageSchema: z.ZodString;
 export declare const LibraryIdSchema: z.ZodString;
 export declare const FontAwesomeIconSchema: z.ZodOptional<z.ZodString>;
 export declare const WhereSchema: z.ZodUnion<readonly [z.ZodLiteral<"popup">, z.ZodLiteral<"slider">, z.ZodLiteral<"fullpage">]>;
+export declare const ViewSettingsShortcutsSchema: z.ZodUnion<readonly [z.ZodLiteral<"display">, z.ZodLiteral<"filters">, z.ZodLiteral<"sorts">, z.ZodLiteral<"catalog">]>;
 export declare const FlapPanelIdSchema: z.ZodUnion<readonly [z.ZodLiteral<"info-history">, z.ZodLiteral<"thread">]>;
 export declare const ExplorerPropsSchema: z.ZodObject<{
     showSearch: z.ZodOptional<z.ZodBoolean>;
@@ -63,6 +64,10 @@ export declare const baseExplorerPanelSchema: z.ZodObject<{
         label: z.ZodRecord<z.ZodString, z.ZodString>;
         onRowClick: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
+    targetLibraryId: z.ZodOptional<z.ZodString>;
+    selectedTab: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"display">, z.ZodLiteral<"filters">, z.ZodLiteral<"sorts">, z.ZodLiteral<"catalog">]>>;
+    currentViewId: z.ZodOptional<z.ZodString>;
+    isViewSettingsActive: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const attributeExplorerPanelSchema: z.ZodObject<{
     attributeSource: z.ZodString;
@@ -100,6 +105,10 @@ export declare const PanelSchema: z.ZodIntersection<z.ZodObject<{
         label: z.ZodRecord<z.ZodString, z.ZodString>;
         onRowClick: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
+    targetLibraryId: z.ZodOptional<z.ZodString>;
+    selectedTab: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"display">, z.ZodLiteral<"filters">, z.ZodLiteral<"sorts">, z.ZodLiteral<"catalog">]>>;
+    currentViewId: z.ZodOptional<z.ZodString>;
+    isViewSettingsActive: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
     attributeSource: z.ZodString;
     deactivateOnUnlink: z.ZodOptional<z.ZodBoolean>;

package/dist/hooks/{useIFrameMessenger → usePanelMessenger}/schema.js

@@ -5,6 +5,12 @@ export const LanguageSchema = z.string();
 export const LibraryIdSchema = z.string();
 export const FontAwesomeIconSchema = z.string().regex(FONT_AWESOME_ICON_REGEX).optional();
 export const WhereSchema = z.union([z.literal('popup'), z.literal('slider'), z.literal('fullpage')]);
+export const ViewSettingsShortcutsSchema = z.union([
+    z.literal('display'),
+    z.literal('filters'),
+    z.literal('sorts'),
+    z.literal('catalog'),
+]);
 export const FlapPanelIdSchema = z.union([z.literal('info-history'), z.literal('thread')]);
 export const ExplorerPropsSchema = z.object({
     showSearch: z.boolean().optional(),
@@ -69,6 +75,10 @@ export const baseExplorerPanelSchema = z.object({
     type: z.literal('explorer'),
     viewId: z.string().optional(),
     actions: ItemActionsSchema,
+    targetLibraryId: LibraryIdSchema.optional(),
+    selectedTab: ViewSettingsShortcutsSchema.optional(),
+    currentViewId: z.string().optional(),
+    isViewSettingsActive: z.boolean().default(false),
 });
 export const attributeExplorerPanelSchema = z.object({
     attributeSource: z.string(),

package/dist/hooks/usePanelMessenger/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/hooks/usePanelMessenger/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAE9C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,QAAQ,EAAE,CAAC;AAE1F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAErG,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC;IAC/C,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACpB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACpB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAClB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAE3F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACxC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACzC,qBAAqB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzE,kBAAkB,EAAE,CAAC;SAChB,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;SAC1F,QAAQ,EAAE;IACf,qBAAqB,EAAE,CAAC;SACnB,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;SACtF,QAAQ,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC7B,KAAK,CACF,CAAC,CAAC,MAAM,CAAC;IACL,KAAK,EAAE,WAAW;IAClB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC,QAAQ,EAAE;IACvC,iBAAiB,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IAC/C,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CACL;KACA,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE;IAC7F,OAAO,EAAE,qDAAqD;CACjE,CAAC,CAAC;AAEP,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrD,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC,UAAU,EAAE,CAAC;SACR,MAAM,CAAC;QACJ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAChC,CAAC;SACD,QAAQ,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,iBAAiB;IAE1B,eAAe,EAAE,eAAe,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IACnD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,oBAAoB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACnD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC1C,SAAS,EAAE,eAAe;IAC1B,aAAa,EAAE,mBAAmB,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,aAAa,EAAE,mBAAmB,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,GAAG,CACnD,CAAC,CAAC,KAAK,CAAC,CAAC,4BAA4B,EAAE,0BAA0B,CAAC,CAAC,CACtE,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAC1C,CAAC,CAAC,KAAK,CAAC,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,CAC7F,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC","sourcesContent":["import * as z from 'zod/v4';\n\nexport const FONT_AWESOME_ICON_REGEX = /^fa-/;\n\nexport const PanelIdSchema = z.string();\nexport const LanguageSchema = z.string();\nexport const LibraryIdSchema = z.string();\nexport const FontAwesomeIconSchema = z.string().regex(FONT_AWESOME_ICON_REGEX).optional();\n\nexport const WhereSchema = z.union([z.literal('popup'), z.literal('slider'), z.literal('fullpage')]);\n\nexport const ViewSettingsShortcutsSchema = z.union([\n    z.literal('display'),\n    z.literal('filters'),\n    z.literal('sorts'),\n    z.literal('catalog'),\n]);\n\nexport const FlapPanelIdSchema = z.union([z.literal('info-history'), z.literal('thread')]);\n\nexport const ExplorerPropsSchema = z.object({\n    showSearch: z.boolean().optional(),\n    showFilters: z.boolean().optional(),\n    showSorts: z.boolean().optional(),\n    freezeView: z.boolean().optional(),\n    showAttributeLabels: z.boolean().optional(),\n    creationFormId: z.string().optional(),\n    noPagination: z.literal(true).optional(),\n    showActionsLabels: z.boolean().optional(),\n    defaultPrimaryActions: z.array(z.union([z.literal('create')])).optional(),\n    defaultMassActions: z\n        .array(z.union([z.literal('deactivate'), z.literal('export'), z.literal('editAttribute')]))\n        .optional(),\n    defaultActionsForItem: z\n        .array(z.union([z.literal('replaceLink'), z.literal('remove'), z.literal('activate')]))\n        .optional(),\n});\n\nexport const ItemActionsSchema = z\n    .array(\n        z.object({\n            where: WhereSchema,\n            what: z.literal('record'),\n            targetPanelId: PanelIdSchema.optional(),\n            targetFlapPanelId: FlapPanelIdSchema.optional(),\n            icon: FontAwesomeIconSchema,\n            label: z.record(LanguageSchema, z.string()),\n            onRowClick: z.boolean().optional(),\n        }),\n    )\n    .refine(actions => actions.reduce((acc, action) => (action.onRowClick ? acc + 1 : acc), 0) <= 1, {\n        message: 'At most one action must have onRowClick set to true',\n    });\n\nexport const basePanelSchema = z.object({\n    id: PanelIdSchema,\n    icon: FontAwesomeIconSchema,\n    name: z.record(LanguageSchema, z.string()).optional(),\n    isStandalone: z.boolean().optional(),\n    hideInCompactMode: z.boolean().optional(),\n});\n\nexport const iframePanelSchema = z.object({\n    type: z.literal('custom'),\n    iframeSource: z.string(),\n    viewId: z.string().optional(),\n    isSelfContaining: z.boolean().optional(),\n    popupProps: z\n        .object({\n            width: z.string().optional(),\n            height: z.string().optional(),\n        })\n        .optional(),\n});\n\nconst editionPanelSchema = z.object({\n    type: z.literal('editionForm'),\n    formId: z.string(),\n});\n\nexport const creationPanelSchema = z.object({\n    type: z.literal('creationForm'),\n    formId: z.string(),\n    attributeSource: z.string().optional(),\n    isStandalone: z.literal(true),\n});\n\nexport const baseExplorerPanelSchema = z.object({\n    type: z.literal('explorer'),\n    viewId: z.string().optional(),\n    actions: ItemActionsSchema,\n\n    targetLibraryId: LibraryIdSchema.optional(),\n    selectedTab: ViewSettingsShortcutsSchema.optional(),\n    currentViewId: z.string().optional(),\n    isViewSettingsActive: z.boolean().default(false),\n});\n\nexport const attributeExplorerPanelSchema = z.object({\n    attributeSource: z.string(),\n    deactivateOnUnlink: z.boolean().optional(),\n    libraryId: LibraryIdSchema,\n    explorerProps: ExplorerPropsSchema.optional(),\n});\n\nconst libraryExplorerPanelSchema = z.object({\n    explorerProps: ExplorerPropsSchema.optional(),\n});\n\nconst explorerPanelSchema = baseExplorerPanelSchema.and(\n    z.union([attributeExplorerPanelSchema, libraryExplorerPanelSchema]),\n);\n\nexport const PanelSchema = basePanelSchema.and(\n    z.union([explorerPanelSchema, iframePanelSchema, editionPanelSchema, creationPanelSchema]),\n);\n\nexport const PanelIFrameSchema = basePanelSchema.and(iframePanelSchema);\n"]}

package/dist/hooks/{useIFrameMessenger → usePanelMessenger}/types.d.ts

@@ -3,7 +3,7 @@ import type * as z from 'zod/v4';
 import { type KitNotification } from 'aristid-ds';
 import { type IKitConfirmDialog } from 'aristid-ds/dist/Kit/Feedback/Modal/types';
 import { type ToastedAlertProps } from 'aristid-ds/dist/Kit/Feedback/Alert/types';
-import { type LibraryIdSchema, type WhereSchema, type PanelIdSchema, type PanelSchema, type PanelIFrameSchema, type FlapPanelIdSchema, type attributeExplorerPanelSchema, type baseExplorerPanelSchema } from '../../hooks/useIFrameMessenger/schema';
+import { type LibraryIdSchema, type WhereSchema, type PanelIdSchema, type PanelSchema, type PanelIFrameSchema, type FlapPanelIdSchema, type attributeExplorerPanelSchema, type baseExplorerPanelSchema } from '../../hooks/usePanelMessenger/schema';
 import { type AnyPrimitive } from '@leav/utils';
 import { type IRecordIdentity, type ITreeNodeWithRecord } from '../../types';
 import { type SerializedView } from '../../components/Explorer/_types';
@@ -153,8 +153,8 @@ export type ExplorerViewChangedMessage = IMessageBase & {
         serializedView: SerializedView;
     };
 };
-export type ViewConfigUpdateMessage = IMessageBase & {
-    type: 'view-config-update';
+export type ViewSettingsUpdateMessage = IMessageBase & {
+    type: 'view-settings-update';
     data: {
         targetPanelId: string;
         serializedView: SerializedView;
@@ -165,7 +165,7 @@ export type MessageFromParent = (IMessageBase & {
     type: 'on-call-callback';
     path: string;
     data: unknown;
-}) | IsRegisteredMessage | ChangeLanguageMessage | ViewConfigUpdateMessage;
+}) | IsRegisteredMessage | ChangeLanguageMessage | ViewSettingsUpdateMessage;
 export type Message = MessageToParent | MessageFromParent;
 export type MessageHandler<T = Message> = (message: T, dispatch: MessageDispatcher<T>) => void;
 export type MessageDispatcher<T = Message> = (message: T, frameId?: string) => void;
@@ -173,12 +173,23 @@ export type CallCbFunction = (path: string, data: unknown, frameId: string) => v
 export type CallbackFunction = (...args: never[]) => void;
 export type Callbacks = Record<string, Record<string, CallbackFunction>>;
 export type MessageToPanelMessageHandler = (data: MessageToPanelMessage['data']['payload']) => void;
-export type AddMessageToPanelMessageHandler = (type: string, handler: MessageToPanelMessageHandler) => void;
+export type AddMessageToPanelMessageHandler = (type: string, handler: MessageToPanelMessageHandler) => () => void;
+export type InternalEventHandler<D = unknown> = (data: D) => void;
+export type AddInternalEventHandler = (type: string, handler: InternalEventHandler) => () => void;
+/**
+ * Typed message for internal app events dispatched between app-studio components
+ * or from child iframes. The `type` field is the event name (e.g. 'view-settings-changed').
+ * Add specific subtypes in types.ts as needed and register handlers via useIFramePanelMessageHandler.
+ */
+export type InternalEventMessage<T extends string = string, D = unknown> = {
+    type: T;
+    data: D;
+};
 export type UnregisterHandlers = () => void;
-export type RegisterHandlers = (iframeRef: RefObject<HTMLIFrameElement>, handlers: IUseIFrameMessengerOptions['handlers']) => UnregisterHandlers;
-export type RegisterNativePanelHandlers = (panelId: string, handlers: IUseIFrameMessengerOptions['handlers']) => UnregisterHandlers;
+export type RegisterHandlers = (iframeRef: RefObject<HTMLIFrameElement>, handlers: IUsePanelMessengerOptions['handlers']) => UnregisterHandlers;
+export type RegisterNativePanelHandlers = (panelId: string, handlers: IUsePanelMessengerOptions['handlers']) => UnregisterHandlers;
 export type DispatchToNativePanel = (panelId: string, message: Message) => void;
-export interface IUseIFrameMessengerOptions {
+export interface IUsePanelMessengerOptions {
     ref?: RefObject<HTMLIFrameElement>;
     id?: string;
     onMessageReceived?: (senderWindow: Window | null, message: Message, panelId: string | null, dispatch: MessageDispatcher, callCb: CallCbFunction, callbacksStore: MutableRefObject<Callbacks>) => void;
@@ -195,7 +206,7 @@ export interface IUseIFrameMessengerOptions {
         onGetPanelConfig?: (data: GetPanelConfigMessage['data'], id: string, dispatch: MessageDispatcher, callCb: CallCbFunction) => void;
         onCloseFlapPanel?: () => void;
         onExplorerViewChanged?: (data: ExplorerViewChangedMessage['data']) => void;
-        onViewConfigUpdate?: (data: ViewConfigUpdateMessage['data']) => void;
+        onViewConfigUpdate?: (data: ViewSettingsUpdateMessage['data']) => void;
     };
 }
 export {};

package/dist/hooks/usePanelMessenger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/usePanelMessenger/types.ts"],"names":[],"mappings":"AAmBA,MAAM,CAAC,MAAM,QAAQ,GAAG,uBAAuB,CAAC","sourcesContent":["import {type MutableRefObject, type RefObject, type ComponentProps, type Key, type JSXElementConstructor} from 'react';\nimport type * as z from 'zod/v4';\nimport {type KitNotification} from 'aristid-ds';\nimport {type IKitConfirmDialog} from 'aristid-ds/dist/Kit/Feedback/Modal/types';\nimport {type ToastedAlertProps} from 'aristid-ds/dist/Kit/Feedback/Alert/types';\nimport {\n    type LibraryIdSchema,\n    type WhereSchema,\n    type PanelIdSchema,\n    type PanelSchema,\n    type PanelIFrameSchema,\n    type FlapPanelIdSchema,\n    type attributeExplorerPanelSchema,\n    type baseExplorerPanelSchema,\n} from '_ui/hooks/usePanelMessenger/schema';\nimport {type AnyPrimitive} from '@leav/utils';\nimport {type IRecordIdentity, type ITreeNodeWithRecord} from '_ui/types';\nimport {type SerializedView} from '_ui/components/Explorer/_types';\n\nexport const packetId = '__fromIframeMessenger';\n\nexport interface IEncodedMessage {\n    payload: string;\n    [packetId]: boolean;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type ComponentPropsWithKey<T extends keyof JSX.IntrinsicElements | JSXElementConstructor<any>> =\n    ComponentProps<T> & {\n        key?: Key;\n    };\n\nexport interface IMessageBase {\n    __frameId?: string;\n    __targetPanelId?: string;\n}\n\nexport type ModalConfirmMessage = IMessageBase & {\n    type: 'modal-confirm';\n    id: string;\n    data: IKitConfirmDialog;\n    overrides?: string[];\n};\n\nexport type AlertMessage = IMessageBase & {\n    type: 'alert';\n    id: string;\n    data: ToastedAlertProps;\n    overrides?: string[];\n};\n\nexport type NotificationMessage = IMessageBase & {\n    type: 'notification';\n    id: string;\n    data: ComponentPropsWithKey<typeof KitNotification>;\n    overrides?: string[];\n};\n\nexport type ChangeLanguageMessage = IMessageBase & {\n    type: 'change-language';\n    language: string;\n};\n\nexport type SimpleMessage = IMessageBase & {\n    type: 'message';\n    id: string;\n    data: unknown;\n};\n\nexport type RegisterMessage = IMessageBase & {\n    type: 'register';\n    id: string;\n};\n\nexport type UnregisterMessage = IMessageBase & {\n    type: 'unregister';\n    id: string;\n};\n\nexport type IsRegisteredMessage = IMessageBase & {\n    type: 'is-registered';\n    id: string;\n};\n\nexport type Panel = z.infer<typeof PanelSchema>;\n\nexport type AttributeExplorerPanel = Panel &\n    z.infer<typeof baseExplorerPanelSchema> &\n    z.infer<typeof attributeExplorerPanelSchema>;\n\nexport type LibraryId = z.infer<typeof LibraryIdSchema>;\n\nexport type PanelId = z.infer<typeof PanelIdSchema>;\n\nexport type Where = z.infer<typeof WhereSchema>;\n\nexport type PanelIFrame = z.infer<typeof PanelIFrameSchema>;\n\ntype FlapPanelId = z.infer<typeof FlapPanelIdSchema>;\n\nexport type NavigateToPanelMessage = IMessageBase & {\n    type: 'navigate-to-panel';\n    data: {\n        where: Where;\n        libraryId: LibraryId;\n        panelId?: PanelId;\n        recordId?: string;\n        flapRecordId?: string;\n        flapLibraryId?: LibraryId;\n        flapPanelId?: FlapPanelId;\n        queryParams?: Record<string, string> & {\n            redirectUrl?: string;\n            formInitialValues?: Record<string, Array<AnyPrimitive | IRecordIdentity | ITreeNodeWithRecord>>;\n        };\n    };\n};\n\nexport type ClosePanelMessage = IMessageBase & {\n    type: 'close-panel';\n    data: {\n        recordId: string;\n        where: string;\n        recordPanelId: string;\n    };\n};\n\nexport type NavigateToIframeMessage = IMessageBase & {\n    type: 'navigate-to-iframe';\n    data: {\n        panel: PanelIFrame;\n        destination: {libraryId: LibraryId};\n        where: Where;\n        recordId: string;\n        recordPanelId: string;\n    };\n};\n\nexport type MessageToPanelMessage = IMessageBase & {\n    type: 'message-to-panel';\n    data: {\n        type: string;\n        target?: string;\n        payload: unknown;\n    };\n};\n\nexport type OpenFlapPanelMessage = IMessageBase & {\n    type: 'open-flap-panel';\n    data: {\n        flapRecordId: string;\n        flapLibraryId: LibraryId;\n        flapPanelId: FlapPanelId;\n    };\n};\n\nexport type CloseFlapPanelMessage = IMessageBase & {\n    type: 'close-flap-panel';\n};\n\nexport type GetUrlMessage = IMessageBase & {\n    type: 'get-url';\n    id: string;\n    data: {\n        onGetUrl: (url: string) => void;\n        flapParams?: {\n            flapRecordId: string;\n            flapLibraryId: LibraryId;\n            flapPanelId: FlapPanelId;\n        };\n        panelParams?: {\n            recordId: string;\n            where: Where;\n            recordPanelId: PanelId;\n        };\n    };\n    overrides?: string[];\n};\n\nexport type GetPanelConfigMessage = IMessageBase & {\n    type: 'get-panel-config';\n    id: string;\n    data: {\n        panelId?: string;\n        onGetPanelConfig: (data: PanelIFrame) => void;\n    };\n    overrides?: string[];\n};\n\nexport type ExplorerViewChangedMessage = IMessageBase & {\n    type: 'explorer-view-changed';\n    data: {\n        serializedView: SerializedView;\n    };\n};\n\nexport type ViewSettingsUpdateMessage = IMessageBase & {\n    type: 'view-settings-update';\n    data: {\n        targetPanelId: string;\n        serializedView: SerializedView;\n    };\n};\n\nexport type MessageToParent =\n    | ModalConfirmMessage\n    | AlertMessage\n    | NotificationMessage\n    | SimpleMessage\n    | RegisterMessage\n    | UnregisterMessage\n    | NavigateToPanelMessage\n    | ClosePanelMessage\n    | NavigateToIframeMessage\n    | MessageToPanelMessage\n    | OpenFlapPanelMessage\n    | CloseFlapPanelMessage\n    | GetUrlMessage\n    | GetPanelConfigMessage\n    | ExplorerViewChangedMessage;\n\nexport type MessageFromParent =\n    | (IMessageBase & {\n          type: 'on-call-callback';\n          path: string;\n          data: unknown;\n      })\n    | IsRegisteredMessage\n    | ChangeLanguageMessage\n    | ViewSettingsUpdateMessage;\n\nexport type Message = MessageToParent | MessageFromParent;\n\nexport type MessageHandler<T = Message> = (message: T, dispatch: MessageDispatcher<T>) => void;\nexport type MessageDispatcher<T = Message> = (message: T, frameId?: string) => void;\n\nexport type CallCbFunction = (path: string, data: unknown, frameId: string) => void;\n\nexport type CallbackFunction = (...args: never[]) => void;\nexport type Callbacks = Record<string, Record<string, CallbackFunction>>;\n\nexport type MessageToPanelMessageHandler = (data: MessageToPanelMessage['data']['payload']) => void;\nexport type AddMessageToPanelMessageHandler = (type: string, handler: MessageToPanelMessageHandler) => () => void;\n\nexport type InternalEventHandler<D = unknown> = (data: D) => void;\nexport type AddInternalEventHandler = (type: string, handler: InternalEventHandler) => () => void;\n\n/**\n * Typed message for internal app events dispatched between app-studio components\n * or from child iframes. The `type` field is the event name (e.g. 'view-settings-changed').\n * Add specific subtypes in types.ts as needed and register handlers via useIFramePanelMessageHandler.\n */\nexport type InternalEventMessage<T extends string = string, D = unknown> = {\n    type: T;\n    data: D;\n};\n\nexport type UnregisterHandlers = () => void;\nexport type RegisterHandlers = (\n    iframeRef: RefObject<HTMLIFrameElement>,\n    handlers: IUsePanelMessengerOptions['handlers'],\n) => UnregisterHandlers;\nexport type RegisterNativePanelHandlers = (\n    panelId: string,\n    handlers: IUsePanelMessengerOptions['handlers'],\n) => UnregisterHandlers;\nexport type DispatchToNativePanel = (panelId: string, message: Message) => void;\n\nexport interface IUsePanelMessengerOptions {\n    ref?: RefObject<HTMLIFrameElement>;\n    id?: string;\n    onMessageReceived?: (\n        senderWindow: Window | null,\n        message: Message,\n        panelId: string | null,\n        dispatch: MessageDispatcher,\n        callCb: CallCbFunction,\n        callbacksStore: MutableRefObject<Callbacks>,\n    ) => void;\n    handlers?: {\n        onModalConfirm?: (\n            data: ModalConfirmMessage['data'],\n            id: string,\n            dispatch: MessageDispatcher,\n            callCb: CallCbFunction,\n        ) => void;\n        onAlert?: (data: AlertMessage['data'], id: string, dispatch: MessageDispatcher, callCb: CallCbFunction) => void;\n        onNotification?: (\n            data: NotificationMessage['data'],\n            id: string,\n            dispatch: MessageDispatcher,\n            callCb: CallCbFunction,\n        ) => void;\n        onMessage?: (data: unknown, id: string, dispatch: MessageDispatcher, callCb: CallCbFunction) => void;\n        onNavigateToPanel?: (data: NavigateToPanelMessage['data']) => void;\n        onClosePanel?: (data: ClosePanelMessage['data']) => void;\n        onNavigateToIframe?: (data: NavigateToIframeMessage['data']) => void;\n        onOpenFlapPanel?: (data: OpenFlapPanelMessage['data']) => void;\n        onGetUrl?: (data: GetUrlMessage['data']) => void;\n        onGetPanelConfig?: (\n            data: GetPanelConfigMessage['data'],\n            id: string,\n            dispatch: MessageDispatcher,\n            callCb: CallCbFunction,\n        ) => void;\n        onCloseFlapPanel?: () => void;\n        onExplorerViewChanged?: (data: ExplorerViewChangedMessage['data']) => void;\n        onViewConfigUpdate?: (data: ViewSettingsUpdateMessage['data']) => void;\n    };\n}\n"]}

package/dist/hooks/usePanelMessenger/usePanelEventHandlers.d.ts

@@ -0,0 +1,10 @@
+import { type InternalEventMessage } from './types';
+type InternalEventHandlerMap<TMessage extends InternalEventMessage> = {
+    [K in TMessage['type']]?: (data: Extract<TMessage, {
+        type: K;
+    }>['data']) => void;
+};
+export declare const usePanelEventHandlers: <TMessage extends InternalEventMessage = InternalEventMessage>(handlers?: InternalEventHandlerMap<TMessage>) => {
+    dispatch: (message: TMessage) => void;
+};
+export {};

package/dist/hooks/usePanelMessenger/usePanelEventHandlers.js

@@ -0,0 +1,15 @@
+import { useContext, useEffect } from 'react';
+import { PanelMessengerContext } from './panelMessengerContext';
+export const usePanelEventHandlers = (handlers) => {
+    const { addInternalEventHandler, dispatchToSelf } = useContext(PanelMessengerContext);
+    useEffect(() => {
+        if (handlers) {
+            const unregisters = Object.entries(handlers).map(([type, handler]) => addInternalEventHandler(type, handler));
+            return () => unregisters.forEach(unregister => unregister());
+        }
+    }, []);
+    return {
+        dispatch: (message) => dispatchToSelf(message),
+    };
+};
+//# sourceMappingURL=usePanelEventHandlers.js.map

package/dist/hooks/usePanelMessenger/usePanelEventHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePanelEventHandlers.js","sourceRoot":"","sources":["../../../src/hooks/usePanelMessenger/usePanelEventHandlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,SAAS,EAAC,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC;AAO9D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACjC,QAA4C,EAC9C,EAAE;IACA,MAAM,EAAC,uBAAuB,EAAE,cAAc,EAAC,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAEpF,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,QAAQ,EAAE,CAAC;YACX,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,QAAgD,CAAC,CAAC,GAAG,CACpF,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,EAAE,OAAO,CAAC,CAC9D,CAAC;YACF,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;QACjE,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACH,QAAQ,EAAE,CAAC,OAAiB,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC;KAC3D,CAAC;AACN,CAAC,CAAC","sourcesContent":["import {useContext, useEffect} from 'react';\nimport {PanelMessengerContext} from './panelMessengerContext';\nimport {type InternalEventHandler, type InternalEventMessage} from './types';\n\ntype InternalEventHandlerMap<TMessage extends InternalEventMessage> = {\n    [K in TMessage['type']]?: (data: Extract<TMessage, {type: K}>['data']) => void;\n};\n\nexport const usePanelEventHandlers = <TMessage extends InternalEventMessage = InternalEventMessage>(\n    handlers?: InternalEventHandlerMap<TMessage>,\n) => {\n    const {addInternalEventHandler, dispatchToSelf} = useContext(PanelMessengerContext);\n\n    useEffect(() => {\n        if (handlers) {\n            const unregisters = Object.entries(handlers as Record<string, InternalEventHandler>).map(\n                ([type, handler]) => addInternalEventHandler(type, handler),\n            );\n            return () => unregisters.forEach(unregister => unregister());\n        }\n    }, []);\n\n    return {\n        dispatch: (message: TMessage) => dispatchToSelf(message),\n    };\n};\n"]}

package/dist/hooks/{useIFrameMessenger/useIFrameMessengerHandlers.d.ts → usePanelMessenger/usePanelIFrameHandlers.d.ts}

@@ -1,13 +1,13 @@
 import { type RefObject } from 'react';
-import { type IUseIFrameMessengerOptions } from './types';
+import { type IUsePanelMessengerOptions } from './types';
 /**
  * Per-iframe hook for `PanelCustom`. Registers the iframe's handlers into the singleton
- * `IFrameMessengerProvider` and cleans them up on unmount.
+ * `PanelMessengerProvider` and cleans them up on unmount.
  *
  * Returns `changeLangInFrame` which posts `change-language` directly to this specific iframe's
  * `contentWindow` — intentionally NOT using the shared registry to avoid broadcasting the language
  * change to all other open iframes (which would cause unintended refreshes).
  */
-export declare const useIFrameMessengerHandlers: (iframeRef: RefObject<HTMLIFrameElement>, handlers: IUseIFrameMessengerOptions["handlers"]) => {
+export declare const usePanelIFrameHandlers: (iframeRef: RefObject<HTMLIFrameElement>, handlers: IUsePanelMessengerOptions["handlers"]) => {
     changeLangInFrame: (language: string) => void;
 };

package/dist/hooks/{useIFrameMessenger/useIFrameMessengerHandlers.js → usePanelMessenger/usePanelIFrameHandlers.js}

@@ -1,16 +1,16 @@
 import { useCallback, useContext, useEffect } from 'react';
-import { IFrameMessengerContext } from './iFrameMessengerContext';
 import { encodeMessage } from './messageHandlers';
+import { PanelMessengerContext } from '../../hooks/usePanelMessenger/panelMessengerContext';
 /**
  * Per-iframe hook for `PanelCustom`. Registers the iframe's handlers into the singleton
- * `IFrameMessengerProvider` and cleans them up on unmount.
+ * `PanelMessengerProvider` and cleans them up on unmount.
  *
  * Returns `changeLangInFrame` which posts `change-language` directly to this specific iframe's
  * `contentWindow` — intentionally NOT using the shared registry to avoid broadcasting the language
  * change to all other open iframes (which would cause unintended refreshes).
  */
-export const useIFrameMessengerHandlers = (iframeRef, handlers) => {
-    const { registerHandlers } = useContext(IFrameMessengerContext);
+export const usePanelIFrameHandlers = (iframeRef, handlers) => {
+    const { registerHandlers } = useContext(PanelMessengerContext);
     // Register on mount, deregister on unmount via the returned cleanup function.
     useEffect(() => registerHandlers(iframeRef, handlers), []);
     // Post directly to contentWindow instead of going through the registry,
@@ -23,4 +23,4 @@ export const useIFrameMessengerHandlers = (iframeRef, handlers) => {
     }, [iframeRef]);
     return { changeLangInFrame };
 };
-//# sourceMappingURL=useIFrameMessengerHandlers.js.map
+//# sourceMappingURL=usePanelIFrameHandlers.js.map

package/dist/hooks/usePanelMessenger/usePanelIFrameHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePanelIFrameHandlers.js","sourceRoot":"","sources":["../../../src/hooks/usePanelMessenger/usePanelIFrameHandlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAiB,MAAM,OAAO,CAAC;AACzE,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAC,qBAAqB,EAAC,MAAM,mDAAmD,CAAC;AAExF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAClC,SAAuC,EACvC,QAA+C,EACjD,EAAE;IACA,MAAM,EAAC,gBAAgB,EAAC,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAE7D,8EAA8E;IAC9E,SAAS,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;IAE3D,wEAAwE;IACxE,mDAAmD;IACnD,MAAM,iBAAiB,GAAG,WAAW,CACjC,CAAC,QAAgB,EAAE,EAAE;QACjB,IAAI,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC;YACnC,MAAM,OAAO,GAA0B,EAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAC,CAAC;YAC3E,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7E,CAAC;IACL,CAAC,EACD,CAAC,SAAS,CAAC,CACd,CAAC;IAEF,OAAO,EAAC,iBAAiB,EAAC,CAAC;AAC/B,CAAC,CAAC","sourcesContent":["import {useCallback, useContext, useEffect, type RefObject} from 'react';\nimport {encodeMessage} from './messageHandlers';\nimport {type ChangeLanguageMessage, type IUsePanelMessengerOptions} from './types';\nimport {PanelMessengerContext} from '_ui/hooks/usePanelMessenger/panelMessengerContext';\n\n/**\n * Per-iframe hook for `PanelCustom`. Registers the iframe's handlers into the singleton\n * `PanelMessengerProvider` and cleans them up on unmount.\n *\n * Returns `changeLangInFrame` which posts `change-language` directly to this specific iframe's\n * `contentWindow` — intentionally NOT using the shared registry to avoid broadcasting the language\n * change to all other open iframes (which would cause unintended refreshes).\n */\nexport const usePanelIFrameHandlers = (\n    iframeRef: RefObject<HTMLIFrameElement>,\n    handlers: IUsePanelMessengerOptions['handlers'],\n) => {\n    const {registerHandlers} = useContext(PanelMessengerContext);\n\n    // Register on mount, deregister on unmount via the returned cleanup function.\n    useEffect(() => registerHandlers(iframeRef, handlers), []);\n\n    // Post directly to contentWindow instead of going through the registry,\n    // which would broadcast to all registered iframes.\n    const changeLangInFrame = useCallback(\n        (language: string) => {\n            if (iframeRef.current?.contentWindow) {\n                const message: ChangeLanguageMessage = {type: 'change-language', language};\n                iframeRef.current.contentWindow.postMessage(encodeMessage(message), '*');\n            }\n        },\n        [iframeRef],\n    );\n\n    return {changeLangInFrame};\n};\n"]}