import { useEffect, useRef, useState } from 'react'; import { PluginViewLifecycleController, type HostedPluginViewState } from './pluginViewLifecycle'; import { resolvePluginViewWindowScope } from './pluginViewScopes'; import { isPluginViewOccluded } from './pluginViewOcclusion'; import type { UsePluginContributionsResult } from './usePluginContributions'; type ViewAdapter = Pick; /** Host-owned mounting only. No plugin router, DOM, session or vault data API. */ export function useEmbeddedPluginView({ viewId, version, slot, active, context, adapter, subscribeHidden, unavailable, focused, focusOnReveal = false }: { viewId: string; version: string; slot: string; active: boolean; context: Record; adapter: ViewAdapter; subscribeHidden(listener: () => void): () => void; unavailable(): void; focused?(): void; focusOnReveal?: boolean; }) { const mountRef = useRef(null); const [loading, setLoading] = useState(true); const adapterRef = useRef(adapter); const unavailableRef = useRef(unavailable); const focusedRef = useRef(focused); const revealFocusRef = useRef(focusOnReveal); const requestFocusRef = useRef<() => void>(() => {}); revealFocusRef.current = focusOnReveal; focusedRef.current = focused; adapterRef.current = adapter; unavailableRef.current = unavailable; useEffect(() => { const mount = mountRef.current; if (!active || !mount) return; let cancelled = false; const lifecycle = new PluginViewLifecycleController(); const instanceId = crypto.randomUUID(); const scopeId = resolvePluginViewWindowScope({ pathname: window.location.pathname, search: window.location.search, hash: `${window.location.hash}|plugin-slot:${slot}` }); const { openView, closeView, focusView, setViewBounds, setViewVisibility, onViewClosed, onViewFocused } = adapterRef.current; const close = () => { if (cancelled) return; cancelled = true; lifecycle.markViewClosed(viewId); void closeView(instanceId).catch(() => {}); }; const failCurrent = () => { if (cancelled) return; close(); unavailableRef.current(); }; const unsubscribe = onViewClosed((event) => { lifecycle.handleHostClose(event.instanceId); if (event.instanceId === instanceId && !cancelled) { close(); unavailableRef.current(); } }); const stopOnHide = subscribeHidden(close); const stopOnFocus = onViewFocused((event) => { if (!cancelled && event.instanceId === instanceId) focusedRef.current?.(); }); const bounds = () => { const rect = mount.getBoundingClientRect(); return { x: Math.round(rect.x), y: Math.round(rect.y), width: Math.max(1, Math.round(rect.width)), height: Math.max(1, Math.round(rect.height)) }; }; let opened = false; let lastBounds = ''; let visible = false; const focus = () => { if (!cancelled && opened && visible && revealFocusRef.current && !isPluginViewOccluded(mount)) void focusView(instanceId).catch(() => {}); }; requestFocusRef.current = focus; const updateVisibility = () => { if (!opened || cancelled) return; const rect = mount.getBoundingClientRect(); const next = rect.width > 0 && rect.height > 0 && !isPluginViewOccluded(mount); if (visible === next) return; visible = next; void setViewVisibility(instanceId, next).then(() => { if (next) focus(); }).catch(failCurrent); }; const resize = () => { if (opened && !cancelled) { const next = bounds(); const key = JSON.stringify(next); if (key !== lastBounds) { lastBounds = key; void setViewBounds(instanceId, next).catch(failCurrent); } } updateVisibility(); }; const observer = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(resize); observer?.observe(mount); const mutations = new MutationObserver(resize); mutations.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['class', 'style', 'hidden', 'inert', 'role', 'aria-modal', 'aria-hidden', 'data-state', 'data-app-lock-overlay', 'data-radix-popper-content-wrapper', 'data-native-view-occluder'] }); window.addEventListener('resize', resize); document.addEventListener('scroll', resize, true); setLoading(true); const opening = lifecycle.beginOpen({ viewKey: viewId }); void openView({ viewId, instanceId, scopeId, bounds: bounds(), context }).then(async (result) => { if (cancelled || lifecycle.shouldCloseOpen(opening) || lifecycle.consumeHostClose(result.instanceId)) { await closeView(result.instanceId); return; } opened = true; lifecycle.setCurrent({ id: result.instanceId, viewId, scopeId, retainContextWhenHidden: false }); resize(); setLoading(false); }).catch(() => { if (!cancelled) { close(); unavailableRef.current(); } }).finally(() => lifecycle.finishOpen({ token: opening, viewKey: viewId })); return () => { close(); unsubscribe(); stopOnHide(); stopOnFocus(); observer?.disconnect(); mutations.disconnect(); window.removeEventListener('resize', resize); document.removeEventListener('scroll', resize, true); }; }, [active, context, slot, subscribeHidden, version, viewId]); useEffect(() => { if (focusOnReveal) requestFocusRef.current(); }, [focusOnReveal]); return { mountRef, loading }; }