ObsiViewer/web-components/excalidraw/ExcalidrawElement.tsx

195 lines
7.7 KiB
TypeScript

import React, { useEffect, useMemo, useRef } from 'react';
import { Excalidraw, exportToBlob, exportToSvg } from '@excalidraw/excalidraw';
import type { AppState, ExcalidrawImperativeAPI } from '@excalidraw/excalidraw/types/types';
import type { ExcalidrawWrapperProps, Scene, SceneChangeDetail, ReadyDetail } from './types';
/**
* React wrapper mounted inside the <excalidraw-editor> custom element.
* It relies on r2wc to pass the host element via a non-attribute property `__host`.
*/
export default function ExcalidrawWrapper(props: ExcalidrawWrapperProps & { __host?: HTMLElement; hostRef?: HTMLElement }) {
const apiRef = useRef<ExcalidrawImperativeAPI | null>(null);
const hostRef = useRef<HTMLElement | null>(null);
const pendingReadyRef = useRef<ExcalidrawImperativeAPI | null>(null);
const pendingSceneEventsRef = useRef<SceneChangeDetail[]>([]);
const lastDetailRef = useRef<SceneChangeDetail | null>(null);
const resolveHost = (candidate?: HTMLElement | null) => {
if (candidate && hostRef.current !== candidate) {
hostRef.current = candidate;
console.log('[excalidraw-editor] host resolved', { hasHost: true });
}
};
resolveHost((props as any).hostRef as HTMLElement | undefined);
resolveHost((props as any).__host as HTMLElement | undefined);
// Sync dark/light mode with export utils defaults
const theme = props.theme === 'dark' ? 'dark' : 'light';
const lang = props.lang || 'fr';
const onChange = (elements: any[], appState: Partial<AppState>, files: any) => {
// CRITICAL DEBUG: Log raw parameters
console.log('[excalidraw-editor] 🔍 onChange called', {
elementsLength: elements?.length,
elementsIsArray: Array.isArray(elements),
elementsRaw: elements,
appStateKeys: appState ? Object.keys(appState) : [],
filesKeys: files ? Object.keys(files) : []
});
const detail: SceneChangeDetail = { elements, appState, files, source: 'user' };
lastDetailRef.current = detail;
console.log('[excalidraw-editor] 📝 SCENE-CHANGE will dispatch', {
elCount: Array.isArray(elements) ? elements.length : 'n/a',
elementsType: typeof elements,
isArray: Array.isArray(elements),
viewMode: appState?.viewModeEnabled,
propsReadOnly: props.readOnly,
firstElement: elements?.[0] ? { id: elements[0].id, type: elements[0].type } : null
});
const host = hostRef.current;
if (!host) {
console.warn('[excalidraw-editor] host unavailable during scene-change, queueing event');
pendingSceneEventsRef.current.push(detail);
return;
}
// Always dispatch - Angular will handle filtering via hash comparison
host.dispatchEvent(new CustomEvent('scene-change', { detail, bubbles: true, composed: true }));
console.log('[excalidraw-editor] ✅ SCENE-CHANGE dispatched to host');
};
// When API becomes available
const onApiReady = (api: ExcalidrawImperativeAPI) => {
console.log('[excalidraw-editor] onApiReady', !!api);
apiRef.current = api;
const host = hostRef.current;
if (host) {
(host as any).__excalidrawAPI = api;
host.dispatchEvent(new CustomEvent<ReadyDetail>('ready', { detail: { apiAvailable: true }, bubbles: true, composed: true }));
// Force a couple of refresh cycles to layout the canvas once API is ready
try { api.refresh?.(); } catch {}
queueMicrotask(() => { try { api.refresh?.(); } catch {} });
setTimeout(() => { try { api.refresh?.(); } catch {} }, 0);
} else {
pendingReadyRef.current = api;
}
};
// Expose imperative export helpers via the host methods (define.ts wires prototypes)
useEffect(() => {
resolveHost((props as any).hostRef as HTMLElement | undefined);
resolveHost((props as any).__host as HTMLElement | undefined);
const host = hostRef.current;
if (!host) return;
if (pendingReadyRef.current) {
(host as any).__excalidrawAPI = pendingReadyRef.current;
host.dispatchEvent(new CustomEvent<ReadyDetail>('ready', { detail: { apiAvailable: true }, bubbles: true, composed: true }));
console.log('[excalidraw-editor] flushed pending ready event');
pendingReadyRef.current = null;
}
if (pendingSceneEventsRef.current.length > 0) {
const queued = pendingSceneEventsRef.current.splice(0);
console.log('[excalidraw-editor] flushing queued scene events', { count: queued.length });
queued.forEach((detail) => {
host.dispatchEvent(new CustomEvent('scene-change', { detail, bubbles: true, composed: true }));
});
}
(host as any).__getScene = () => {
const api = apiRef.current;
if (!api) return { elements: [], appState: {}, files: {} } as Scene;
return {
elements: api.getSceneElements?.() ?? [],
appState: api.getAppState?.() ?? {},
files: api.getFiles?.() ?? {},
} as Scene;
};
(host as any).__getLastEventScene = () => {
const ld = lastDetailRef.current;
if (!ld) return undefined;
return { elements: ld.elements ?? [], appState: ld.appState ?? {}, files: ld.files ?? {} } as Scene;
};
(host as any).__emitSceneChange = () => {
const api = apiRef.current;
if (!api) return;
const elements = api.getSceneElements?.() ?? [];
const appState = api.getAppState?.() ?? {} as Partial<AppState>;
const files = api.getFiles?.() ?? {};
const detail = { elements, appState, files, source: 'flush' } as any;
try {
host.dispatchEvent(new CustomEvent('scene-change', { detail, bubbles: true, composed: true }));
} catch {}
};
(host as any).__exportPNG = async (opts: { withBackground?: boolean } = {}) => {
const api = apiRef.current;
if (!api) return undefined;
const elements = api.getSceneElements?.() ?? [];
const appState = { ...(api.getAppState?.() ?? {}), exportBackground: !!opts.withBackground } as any;
const files = api.getFiles?.() ?? {};
return await exportToBlob({ elements, appState, files, mimeType: 'image/png', quality: 1 });
};
(host as any).__exportSVG = async (opts: { withBackground?: boolean } = {}) => {
const api = apiRef.current;
if (!api) return undefined;
const elements = api.getSceneElements?.() ?? [];
const appState = { ...(api.getAppState?.() ?? {}), exportBackground: !!opts.withBackground } as any;
const files = api.getFiles?.() ?? {};
const svgEl = await exportToSvg({ elements, appState, files });
const svgText = new XMLSerializer().serializeToString(svgEl);
return new Blob([svgText], { type: 'image/svg+xml' });
};
});
// Ensure canvas refreshes when the host size becomes available or changes
useEffect(() => {
const host = hostRef.current;
if (!host) return;
// Force an initial refresh shortly after mount to layout the canvas
const t = setTimeout(() => {
try { apiRef.current?.refresh?.(); } catch {}
}, 0);
let ro: ResizeObserver | null = null;
try {
ro = new ResizeObserver(() => {
try { apiRef.current?.refresh?.(); } catch {}
});
ro.observe(host);
} catch {}
return () => {
clearTimeout(t);
try { ro?.disconnect(); } catch {}
};
});
// Map React props to Excalidraw props
// IMPORTANT: Freeze initialData on first mount to avoid resetting the scene
const initialDataRef = useRef<any>(props.initialData as any);
return (
<div style={{ height: '100%', width: '100%' }}>
<Excalidraw
excalidrawAPI={onApiReady}
initialData={initialDataRef.current}
viewModeEnabled={!!props.readOnly}
theme={theme}
langCode={lang}
gridModeEnabled={!!props.gridMode}
zenModeEnabled={!!props.zenMode}
onChange={onChange}
/>
</div>
);
}