@leav/ui 1.13.0 → 1.14.0-0b747e99

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/usePanelMessenger/PanelMessengerProvider.js

@@ -0,0 +1,88 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useMemo, useRef } from 'react';
+import { usePanelMessenger } from './usePanelMessenger';
+import { encodeMessage, initClientHandlers } from './messageHandlers';
+import { PanelMessengerContext } from './panelMessengerContext';
+/**
+ * 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 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.
+    const handlersMap = useRef(new Map());
+    // 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 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
+        // was processed — the browser clears the reference on iframe removal.
+        if (!senderWindow) {
+            return;
+        }
+        // Same-window message: dispatched via dispatchToNativePanel.
+        // Route to the native panel identified by __targetPanelId.
+        if (senderWindow === window) {
+            const targetPanelId = message.__targetPanelId;
+            if (!targetPanelId) {
+                return;
+            }
+            const handlers = nativePanelHandlersMap.current.get(targetPanelId);
+            if (!handlers) {
+                return;
+            }
+            const clientHandlers = initClientHandlers(callCb, { handlers }, callbacksStore);
+            clientHandlers(message, dispatch);
+            return;
+        }
+        let matchedHandlers;
+        for (const [ref, handlers] of handlersMap.current) {
+            if (ref.current?.contentWindow === senderWindow) {
+                matchedHandlers = handlers;
+                break;
+            }
+        }
+        // No registered handlers for this sender: either the iframe called unregisterHandlers
+        // before its last message was processed (race condition on unmount), or the message
+        // originates from an unrelated frame that passed decodeMessage validation.
+        if (!matchedHandlers) {
+            return;
+        }
+        const enrichedMessage = message.type === 'get-panel-config' ? { ...message, data: { ...message.data, panelId } } : message;
+        const clientHandlers = initClientHandlers(callCb, { handlers: matchedHandlers }, callbacksStore);
+        clientHandlers(enrichedMessage, dispatch);
+    }, []);
+    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);
+    }, []);
+    const registerNativePanelHandlers = useCallback((panelId, handlers) => {
+        nativePanelHandlersMap.current.set(panelId, handlers);
+        return () => nativePanelHandlersMap.current.delete(panelId);
+    }, []);
+    const dispatchToNativePanel = useCallback((panelId, message) => {
+        window.postMessage(encodeMessage({ ...message, __targetPanelId: panelId }), '*');
+    }, []);
+    const contextValue = useMemo(() => ({
+        registerHandlers,
+        registerNativePanelHandlers,
+        dispatchToNativePanel,
+        changeLangInAllFrames,
+        addInternalEventHandler,
+        dispatchToSelf,
+    }), []);
+    return _jsx(PanelMessengerContext.Provider, { value: contextValue, children: children });
+};
+//# 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 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;
@@ -16,4 +16,5 @@ export declare const getExposedMethods: (callbacksStore: MutableRefObject<Callba
     closeFlapPanel: () => void;
     getPanelConfig: (data: GetPanelConfigMessage["data"]) => void;
     getUrl: (data: GetUrlMessage["data"]) => void;
+    explorerViewChanged: (data: ExplorerViewChangedMessage["data"]) => void;
 };

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

@@ -75,6 +75,12 @@ export const initClientHandlers = (callCb, options, callbacksList) => (message,
         case 'get-url':
             options?.handlers?.onGetUrl?.(setCallbacks(message.id, message.__frameId, message.data, callCb, message.overrides));
             break;
+        case 'explorer-view-changed':
+            options?.handlers?.onExplorerViewChanged?.(message.data);
+            break;
+        case 'view-settings-update':
+            options?.handlers?.onViewConfigUpdate?.(message.data);
+            break;
         default:
             break;
     }
@@ -141,5 +147,8 @@ export const getExposedMethods = (callbacksStore, dispatch) => ({
         const { data: nextData, overrides } = storeCallbacks(data, id, callbacksStore);
         dispatch?.({ type: 'get-url', data: nextData, id, overrides });
     },
+    explorerViewChanged: (data) => {
+        dispatch?.({ type: 'explorer-view-changed', data });
+    },
 });
 //# sourceMappingURL=messageHandlers.js.map

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/usePanelMessenger/panelMessengerContext.js

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

@@ -1,6 +1,3 @@
-// Copyright LEAV Solutions 2017 until 2023/11/05, Copyright Aristid from 2023/11/06
-// This file is released under LGPL V3
-// License text available at https://www.gnu.org/licenses/lgpl-3.0.txt
 import * as z from 'zod/v4';
 export const FONT_AWESOME_ICON_REGEX = /^fa-/;
 export const PanelIdSchema = z.string();
@@ -8,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(),
@@ -72,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":"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","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,9 +3,10 @@ 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';
 export declare const packetId = "__fromIframeMessenger";
 export interface IEncodedMessage {
     payload: string;
@@ -16,6 +17,7 @@ export type ComponentPropsWithKey<T extends keyof JSX.IntrinsicElements | JSXEle
 };
 export interface IMessageBase {
     __frameId?: string;
+    __targetPanelId?: string;
 }
 export type ModalConfirmMessage = IMessageBase & {
     type: 'modal-confirm';
@@ -145,12 +147,25 @@ export type GetPanelConfigMessage = IMessageBase & {
     };
     overrides?: string[];
 };
-export type MessageToParent = ModalConfirmMessage | AlertMessage | NotificationMessage | SimpleMessage | RegisterMessage | UnregisterMessage | NavigateToPanelMessage | ClosePanelMessage | NavigateToIframeMessage | MessageToPanelMessage | OpenFlapPanelMessage | CloseFlapPanelMessage | GetUrlMessage | GetPanelConfigMessage;
+export type ExplorerViewChangedMessage = IMessageBase & {
+    type: 'explorer-view-changed';
+    data: {
+        serializedView: SerializedView;
+    };
+};
+export type ViewSettingsUpdateMessage = IMessageBase & {
+    type: 'view-settings-update';
+    data: {
+        targetPanelId: string;
+        serializedView: SerializedView;
+    };
+};
+export type MessageToParent = ModalConfirmMessage | AlertMessage | NotificationMessage | SimpleMessage | RegisterMessage | UnregisterMessage | NavigateToPanelMessage | ClosePanelMessage | NavigateToIframeMessage | MessageToPanelMessage | OpenFlapPanelMessage | CloseFlapPanelMessage | GetUrlMessage | GetPanelConfigMessage | ExplorerViewChangedMessage;
 export type MessageFromParent = (IMessageBase & {
     type: 'on-call-callback';
     path: string;
     data: unknown;
-}) | IsRegisteredMessage | ChangeLanguageMessage;
+}) | 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;
@@ -158,10 +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 interface IUseIFrameMessengerOptions {
+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 IUsePanelMessengerOptions {
     ref?: RefObject<HTMLIFrameElement>;
     id?: string;
     onMessageReceived?: (senderWindow: Window | null, message: Message, panelId: string | null, dispatch: MessageDispatcher, callCb: CallCbFunction, callbacksStore: MutableRefObject<Callbacks>) => void;
@@ -177,6 +205,8 @@ export interface IUseIFrameMessengerOptions {
         onGetUrl?: (data: GetUrlMessage['data']) => void;
         onGetPanelConfig?: (data: GetPanelConfigMessage['data'], id: string, dispatch: MessageDispatcher, callCb: CallCbFunction) => void;
         onCloseFlapPanel?: () => void;
+        onExplorerViewChanged?: (data: ExplorerViewChangedMessage['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,19 +1,16 @@
-// Copyright LEAV Solutions 2017 until 2023/11/05, Copyright Aristid from 2023/11/06
-// This file is released under LGPL V3
-// License text available at https://www.gnu.org/licenses/lgpl-3.0.txt
 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,
@@ -26,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"]}

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

@@ -1,5 +1,4 @@
-import { type AddMessageToPanelMessageHandler, type IUseIFrameMessengerOptions } from './types';
-export { IUseIFrameMessengerOptions };
+import { type AddInternalEventHandler, type AddMessageToPanelMessageHandler, type IUsePanelMessengerOptions } from './types';
 /**
  * Core hook of the IFrameMessenger system. Registers a single `window.addEventListener('message')`
  * and manages a registry of connected child frames.
@@ -12,11 +11,12 @@ export { IUseIFrameMessengerOptions };
  * instead of being handled locally. Used by `IFrameMessengerProvider` to route messages to the correct
  * per-iframe handlers without registering multiple listeners.
  */
-export declare const useIFrameMessenger: (options?: IUseIFrameMessengerOptions) => {
+export declare const usePanelMessenger: (options?: IUsePanelMessengerOptions) => {
     isRegistered: boolean;
     unregister: () => void;
     changeLangInAllFrames: (newLanguage: string) => void;
     addPanelMessageHandler: AddMessageToPanelMessageHandler;
+    addInternalEventHandler: AddInternalEventHandler;
     showModalConfirm: (data: import("./types").ModalConfirmMessage["data"]) => void;
     showAlert: (data: import("./types").AlertMessage["data"]) => void;
     showNotification: (data: import("./types").NotificationMessage["data"]) => void;
@@ -29,4 +29,5 @@ export declare const useIFrameMessenger: (options?: IUseIFrameMessengerOptions)
     closeFlapPanel: () => void;
     getPanelConfig: (data: import("./types").GetPanelConfigMessage["data"]) => void;
     getUrl: (data: import("./types").GetUrlMessage["data"]) => void;
+    explorerViewChanged: (data: import("./types").ExplorerViewChangedMessage["data"]) => void;
 };