@jini-ai/ui 0.1.0

package/dist/features/sketch-editor/react/hooks/useSketchSaveWorkflow.js

@@ -0,0 +1,127 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { EXPORTED_IMAGE_MIME_TYPE, SAVED_VISIBLE_MS } from '../../constants.js';
+import { defaultSketchEditorDependencies } from '../../dependencies.js';
+import { exportedImageFileName, exportedImageResultFileName, isNonDeletedExcalidrawElement, sanitizeExcalidrawAppState } from '../../rules.js';
+function useLatestRef(value) {
+    const ref = useRef(value);
+    ref.current = value;
+    return ref;
+}
+/**
+ * Owns save/export orchestration and the transient "Saved" state: the
+ * dirty/saving/savedAt props drive a debounced "Saved" indicator, and
+ * `handleSave`/`handleExportImage` surface their own success/failure via a
+ * single toast slot.
+ */
+export function useSketchSaveWorkflow(params) {
+    const { dirty, saving, savedAt, fileName, currentScene, onSave, onExportImage, onOpenExportedImage, engine, t, sourceFileExtension } = params;
+    const [showSaved, setShowSaved] = useState(false);
+    const [exporting, setExporting] = useState(false);
+    const [toast, setToast] = useState(null);
+    const savedTimerRef = useRef(undefined);
+    const onSaveRef = useLatestRef(onSave);
+    const onExportImageRef = useLatestRef(onExportImage);
+    const onOpenExportedImageRef = useLatestRef(onOpenExportedImage);
+    const fileNameRef = useLatestRef(fileName);
+    const tRef = useLatestRef(t);
+    const toastRef = useLatestRef(toast);
+    useEffect(() => () => clearTimeout(savedTimerRef.current), []);
+    useEffect(() => {
+        if (dirty) {
+            clearTimeout(savedTimerRef.current);
+            setShowSaved(false);
+        }
+    }, [dirty]);
+    useEffect(() => {
+        if (!savedAt || dirty || saving)
+            return;
+        setShowSaved(true);
+        clearTimeout(savedTimerRef.current);
+        savedTimerRef.current = setTimeout(() => setShowSaved(false), SAVED_VISIBLE_MS);
+    }, [dirty, savedAt, saving]);
+    const handleSave = useCallback(async () => {
+        const ok = await onSaveRef.current(currentScene());
+        if (ok === false) {
+            clearTimeout(savedTimerRef.current);
+            setShowSaved(false);
+            return;
+        }
+        setShowSaved(true);
+        setToast({ message: tRef.current('Saved'), tone: 'success' });
+        clearTimeout(savedTimerRef.current);
+        savedTimerRef.current = setTimeout(() => setShowSaved(false), SAVED_VISIBLE_MS);
+    }, [currentScene, onSaveRef, tRef]);
+    const handleExportImage = useCallback(async () => {
+        const exportHandler = onExportImageRef.current;
+        if (!exportHandler || exporting)
+            return;
+        const exportedScene = currentScene();
+        const exportedElements = exportedScene.elements.filter(isNonDeletedExcalidrawElement);
+        const exportedAppState = {
+            ...sanitizeExcalidrawAppState(exportedScene.appState),
+            exportBackground: true,
+            viewBackgroundColor: typeof exportedScene.appState?.viewBackgroundColor === 'string' ? exportedScene.appState.viewBackgroundColor : '#ffffff',
+        };
+        setExporting(true);
+        try {
+            const blob = await engine.exportToBlob({
+                elements: exportedElements,
+                appState: exportedAppState,
+                files: exportedScene.files,
+                mimeType: EXPORTED_IMAGE_MIME_TYPE,
+                exportPadding: 16,
+            });
+            const base64 = await blobToBase64(blob);
+            const requestedFileName = exportedImageFileName(fileNameRef.current, sourceFileExtension);
+            const result = await exportHandler(base64, requestedFileName, exportedScene);
+            if (result === false)
+                return;
+            const savedFileName = exportedImageResultFileName(result, requestedFileName);
+            setToast({
+                message: tRef.current('Image exported'),
+                details: savedFileName,
+                tone: 'success',
+                actionFileName: savedFileName,
+            });
+        }
+        catch (err) {
+            console.warn('[SketchEditor] export image failed', err);
+            setToast({ message: tRef.current('Could not export image'), tone: 'error' });
+        }
+        finally {
+            setExporting(false);
+        }
+    }, [currentScene, engine, exporting, fileNameRef, onExportImageRef, sourceFileExtension, tRef]);
+    const dismissToast = useCallback(() => setToast(null), []);
+    const handleToastAction = useCallback(() => {
+        const fileNameToOpen = toastRef.current?.actionFileName;
+        if (!fileNameToOpen)
+            return;
+        onOpenExportedImageRef.current?.(fileNameToOpen);
+        setToast(null);
+    }, [onOpenExportedImageRef, toastRef]);
+    return { showSaved, exporting, toast, handleSave, handleExportImage, dismissToast, handleToastAction };
+}
+/**
+ * Wires `useSketchSaveWorkflow` to the real (`@excalidraw/excalidraw`-backed)
+ * engine from `dependencies.ts`. Production callers that don't need to swap
+ * the engine (i.e. everyone except `SketchEditor`, which accepts its own
+ * `dependencies` prop so hosts/tests can inject a fake) should call this
+ * instead of threading `engine` themselves.
+ */
+export function useWiredSketchSaveWorkflow(params) {
+    return useSketchSaveWorkflow({ ...params, engine: defaultSketchEditorDependencies.engine });
+}
+function blobToBase64(blob) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onerror = () => reject(reader.error ?? new Error('Could not read exported image'));
+        reader.onload = () => {
+            const result = typeof reader.result === 'string' ? reader.result : '';
+            const comma = result.indexOf(',');
+            resolve(comma >= 0 ? result.slice(comma + 1) : result);
+        };
+        reader.readAsDataURL(blob);
+    });
+}
+//# sourceMappingURL=useSketchSaveWorkflow.js.map

package/dist/features/sketch-editor/react/hooks/useSketchSaveWorkflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSketchSaveWorkflow.js","sourceRoot":"","sources":["../../../../../src/features/sketch-editor/react/hooks/useSketchSaveWorkflow.ts"],"names":[],"mappings":"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"}

package/dist/features/sketch-editor/react/hooks/useSketchScene.d.ts

@@ -0,0 +1,28 @@
+import type { MutableRefObject } from 'react';
+import type { AppState, BinaryFiles, ExcalidrawImperativeAPI, OrderedExcalidrawElement } from '../../ports.js';
+import { buildInitialData } from '../../rules.js';
+import type { SketchScene, SketchSceneChangeOptions } from '../../types.js';
+export interface UseSketchSceneParams {
+    scene: SketchScene;
+    fileName: string;
+    onSceneChange: (scene: SketchScene, options?: SketchSceneChangeOptions) => void;
+    onClear?: (() => void) | undefined;
+}
+export interface SketchSceneController {
+    apiRef: MutableRefObject<ExcalidrawImperativeAPI | null>;
+    editorInstanceKey: string;
+    initialData: ReturnType<typeof buildInitialData>;
+    handleChange: (elements: readonly OrderedExcalidrawElement[], appState: AppState, files: BinaryFiles) => void;
+    currentScene: () => SketchScene;
+    handleClear: () => void;
+    handleExcalidrawAPI: (api: ExcalidrawImperativeAPI) => void;
+    closeActiveDialog: () => void;
+}
+/**
+ * Owns the Excalidraw imperative API handle, the reset-on-clear instance
+ * key, initial-data memoization (only recomputed when `fileName`/reset
+ * changes — Excalidraw treats a changed `key` as a full remount), and the
+ * content-signature-deduped change/save/clear plumbing.
+ */
+export declare function useSketchScene({ scene, fileName, onSceneChange, onClear }: UseSketchSceneParams): SketchSceneController;
+//# sourceMappingURL=useSketchScene.d.ts.map

package/dist/features/sketch-editor/react/hooks/useSketchScene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSketchScene.d.ts","sourceRoot":"","sources":["../../../../../src/features/sketch-editor/react/hooks/useSketchScene.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/G,OAAO,EAAE,gBAAgB,EAAgE,MAAM,gBAAgB,CAAC;AAChH,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAY5E,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAChF,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,gBAAgB,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;IACzD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACjD,YAAY,EAAE,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9G,YAAY,EAAE,MAAM,WAAW,CAAC;IAChC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,mBAAmB,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAC5D,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,oBAAoB,GAAG,qBAAqB,CAiFvH"}

package/dist/features/sketch-editor/react/hooks/useSketchScene.js

@@ -0,0 +1,87 @@
+import { useCallback, useRef, useState } from 'react';
+import { readDefaultSketchToolColor } from '../../dom.js';
+import { buildInitialData, emptySketchScene, sceneContentSignature, sceneFromExcalidraw } from '../../rules.js';
+function asRecord(value) {
+    return value;
+}
+function useLatestRef(value) {
+    const ref = useRef(value);
+    ref.current = value;
+    return ref;
+}
+/**
+ * Owns the Excalidraw imperative API handle, the reset-on-clear instance
+ * key, initial-data memoization (only recomputed when `fileName`/reset
+ * changes — Excalidraw treats a changed `key` as a full remount), and the
+ * content-signature-deduped change/save/clear plumbing.
+ */
+export function useSketchScene({ scene, fileName, onSceneChange, onClear }) {
+    const apiRef = useRef(null);
+    const [resetNonce, setResetNonce] = useState(0);
+    const onSceneChangeRef = useLatestRef(onSceneChange);
+    const onClearRef = useLatestRef(onClear);
+    const sceneRef = useLatestRef(scene);
+    const fileNameRef = useLatestRef(fileName);
+    const skipHydrationChangeRef = useRef(true);
+    const lastContentSignatureRef = useRef(null);
+    const editorInstanceKey = `${fileName}:${resetNonce}`;
+    const previousEditorInstanceKeyRef = useRef(null);
+    const initialDataRef = useRef(null);
+    if (previousEditorInstanceKeyRef.current !== editorInstanceKey) {
+        previousEditorInstanceKeyRef.current = editorInstanceKey;
+        skipHydrationChangeRef.current = true;
+        lastContentSignatureRef.current = null;
+    }
+    let initialDataEntry = initialDataRef.current;
+    if (!initialDataEntry || initialDataEntry.key !== editorInstanceKey) {
+        initialDataEntry = {
+            key: editorInstanceKey,
+            value: buildInitialData(scene, fileName, readDefaultSketchToolColor()),
+        };
+        initialDataRef.current = initialDataEntry;
+    }
+    const handleChange = useCallback((elements, appState, files) => {
+        const contentSignature = sceneContentSignature(elements, asRecord(appState), asRecord(files));
+        if (skipHydrationChangeRef.current) {
+            skipHydrationChangeRef.current = false;
+            lastContentSignatureRef.current = contentSignature;
+            return;
+        }
+        if (lastContentSignatureRef.current === contentSignature)
+            return;
+        lastContentSignatureRef.current = contentSignature;
+        onSceneChangeRef.current(sceneFromExcalidraw(elements, asRecord(appState), asRecord(files)), { markDirty: true });
+    }, [onSceneChangeRef]);
+    const currentScene = useCallback(() => {
+        const api = apiRef.current;
+        if (!api)
+            return sceneRef.current;
+        return sceneFromExcalidraw(api.getSceneElementsIncludingDeleted(), asRecord(api.getAppState()), asRecord(api.getFiles()));
+    }, [sceneRef]);
+    const handleClear = useCallback(() => {
+        if (onClearRef.current) {
+            onClearRef.current();
+        }
+        else {
+            onSceneChangeRef.current(emptySketchScene(fileNameRef.current), { markDirty: true });
+        }
+        setResetNonce((value) => value + 1);
+    }, [fileNameRef, onClearRef, onSceneChangeRef]);
+    const handleExcalidrawAPI = useCallback((api) => {
+        apiRef.current = api;
+    }, []);
+    const closeActiveDialog = useCallback(() => {
+        apiRef.current?.updateScene({ appState: { openDialog: null } });
+    }, []);
+    return {
+        apiRef,
+        editorInstanceKey,
+        initialData: initialDataEntry.value,
+        handleChange,
+        currentScene,
+        handleClear,
+        handleExcalidrawAPI,
+        closeActiveDialog,
+    };
+}
+//# sourceMappingURL=useSketchScene.js.map

package/dist/features/sketch-editor/react/hooks/useSketchScene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSketchScene.js","sourceRoot":"","sources":["../../../../../src/features/sketch-editor/react/hooks/useSketchScene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGhH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,YAAY,CAAI,KAAQ;IAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,GAAG,CAAC;AACb,CAAC;AAoBD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAwB;IAC9F,MAAM,MAAM,GAAG,MAAM,CAAiC,IAAI,CAAC,CAAC;IAC5D,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,gBAAgB,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,sBAAsB,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,uBAAuB,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAC5D,MAAM,iBAAiB,GAAG,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC;IACtD,MAAM,4BAA4B,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IACjE,MAAM,cAAc,GAAG,MAAM,CAAqE,IAAI,CAAC,CAAC;IAExG,IAAI,4BAA4B,CAAC,OAAO,KAAK,iBAAiB,EAAE,CAAC;QAC/D,4BAA4B,CAAC,OAAO,GAAG,iBAAiB,CAAC;QACzD,sBAAsB,CAAC,OAAO,GAAG,IAAI,CAAC;QACtC,uBAAuB,CAAC,OAAO,GAAG,IAAI,CAAC;IACzC,CAAC;IAED,IAAI,gBAAgB,GAAG,cAAc,CAAC,OAAO,CAAC;IAC9C,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,GAAG,KAAK,iBAAiB,EAAE,CAAC;QACpE,gBAAgB,GAAG;YACjB,GAAG,EAAE,iBAAiB;YACtB,KAAK,EAAE,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,0BAA0B,EAAE,CAAC;SACvE,CAAC;QACF,cAAc,CAAC,OAAO,GAAG,gBAAgB,CAAC;IAC5C,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,QAA6C,EAAE,QAAkB,EAAE,KAAkB,EAAE,EAAE;QACxF,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9F,IAAI,sBAAsB,CAAC,OAAO,EAAE,CAAC;YACnC,sBAAsB,CAAC,OAAO,GAAG,KAAK,CAAC;YACvC,uBAAuB,CAAC,OAAO,GAAG,gBAAgB,CAAC;YACnD,OAAO;QACT,CAAC;QACD,IAAI,uBAAuB,CAAC,OAAO,KAAK,gBAAgB;YAAE,OAAO;QACjE,uBAAuB,CAAC,OAAO,GAAG,gBAAgB,CAAC;QAEnD,gBAAgB,CAAC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpH,CAAC,EACD,CAAC,gBAAgB,CAAC,CACnB,CAAC;IAEF,MAAM,YAAY,GAAG,WAAW,CAAC,GAAgB,EAAE;QACjD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC,GAAG;YAAE,OAAO,QAAQ,CAAC,OAAO,CAAC;QAClC,OAAO,mBAAmB,CACxB,GAAG,CAAC,gCAAgC,EAAE,EACtC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAC3B,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CACzB,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,gBAAgB,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,aAAa,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAEhD,MAAM,mBAAmB,GAAG,WAAW,CAAC,CAAC,GAA4B,EAAE,EAAE;QACvE,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;IACvB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAG,EAAE;QACzC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,MAAM;QACN,iBAAiB;QACjB,WAAW,EAAE,gBAAgB,CAAC,KAAK;QACnC,YAAY;QACZ,YAAY;QACZ,WAAW;QACX,mBAAmB;QACnB,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

package/dist/features/sketch-editor/react/hooks/useSketchTheme.d.ts

@@ -0,0 +1,5 @@
+/** Tracks `data-theme` on `<html>` (this package's own theme convention, see
+ *  `utils/appearance.ts`) plus the OS `prefers-color-scheme`, so the
+ *  embedded Excalidraw instance re-themes itself without a page reload. */
+export declare function useSketchTheme(): 'light' | 'dark';
+//# sourceMappingURL=useSketchTheme.d.ts.map

package/dist/features/sketch-editor/react/hooks/useSketchTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSketchTheme.d.ts","sourceRoot":"","sources":["../../../../../src/features/sketch-editor/react/hooks/useSketchTheme.ts"],"names":[],"mappings":"AAGA;;2EAE2E;AAC3E,wBAAgB,cAAc,IAAI,OAAO,GAAG,MAAM,CAiBjD"}

package/dist/features/sketch-editor/react/hooks/useSketchTheme.js

@@ -0,0 +1,22 @@
+import { useEffect, useState } from 'react';
+import { readExcalidrawTheme } from '../../dom.js';
+/** Tracks `data-theme` on `<html>` (this package's own theme convention, see
+ *  `utils/appearance.ts`) plus the OS `prefers-color-scheme`, so the
+ *  embedded Excalidraw instance re-themes itself without a page reload. */
+export function useSketchTheme() {
+    const [theme, setTheme] = useState(readExcalidrawTheme);
+    useEffect(() => {
+        const root = document.documentElement;
+        const observer = new MutationObserver(() => setTheme(readExcalidrawTheme()));
+        observer.observe(root, { attributes: true, attributeFilter: ['data-theme'] });
+        const media = window.matchMedia?.('(prefers-color-scheme: dark)');
+        const handleSystemThemeChange = () => setTheme(readExcalidrawTheme());
+        media?.addEventListener('change', handleSystemThemeChange);
+        return () => {
+            observer.disconnect();
+            media?.removeEventListener('change', handleSystemThemeChange);
+        };
+    }, []);
+    return theme;
+}
+//# sourceMappingURL=useSketchTheme.js.map

package/dist/features/sketch-editor/react/hooks/useSketchTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSketchTheme.js","sourceRoot":"","sources":["../../../../../src/features/sketch-editor/react/hooks/useSketchTheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD;;2EAE2E;AAC3E,MAAM,UAAU,cAAc;IAC5B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAmB,mBAAmB,CAAC,CAAC;IAE1E,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;QAC7E,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC9E,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,8BAA8B,CAAC,CAAC;QAClE,MAAM,uBAAuB,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,CAAC;QACtE,KAAK,EAAE,gBAAgB,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;QAC3D,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtB,KAAK,EAAE,mBAAmB,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;QAChE,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/features/sketch-editor/rules.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Pure logic for the sketch-editor shim: scene (de)serialization, dirty
+ * detection via content signatures, export-filename derivation, and the
+ * generic parts of the DOM-enhancement toolkit's string handling. No React,
+ * no DOM globals — everything here takes plain values and returns plain
+ * values.
+ */
+import type { SketchDomTextOverrides, SketchExportImageResult, SketchScene, SketchTooltipLabels, SketchTranslate } from './types.js';
+export declare function cloneJson<T>(value: unknown, fallback: T): T;
+/**
+ * Strips fields Excalidraw's own `AppState` marks as transient/session-only
+ * (open menus/dialogs, in-flight drag/resize/edit state, collaborator
+ * cursors) so a persisted scene never rehydrates mid-interaction UI.
+ */
+export declare function sanitizeExcalidrawAppState(value: Record<string, unknown> | null): Record<string, unknown>;
+export declare function emptySketchScene(name?: string): SketchScene;
+export declare function sketchSceneHasContent(scene: SketchScene | null | undefined): boolean;
+export declare function buildInitialData(scene: SketchScene, fileName: string, defaultStrokeColor: string): {
+    elements: readonly unknown[];
+    appState: Record<string, unknown>;
+    files: Record<string, unknown>;
+    scrollToContent: boolean;
+};
+export declare function sceneFromExcalidraw(elements: readonly unknown[], appState: Record<string, unknown>, files: Record<string, unknown>): SketchScene;
+export declare function isNonDeletedExcalidrawElement(element: unknown): boolean;
+/**
+ * A content-only fingerprint of a scene, used to dedupe Excalidraw's
+ * `onChange` firing against no-op re-renders (it fires on selection/hover
+ * changes too, not just content edits).
+ */
+export declare function sceneContentSignature(elements: readonly unknown[], appState: Record<string, unknown>, files: Record<string, unknown>): string;
+/**
+ * Strips a known source extension (default: the last `.ext`) and appends
+ * `.png`. `sourceExtension` is checked with `typeof ... === 'string'`, not
+ * truthiness: a caller explicitly passing `''` means "strip nothing," which
+ * must be distinguishable from "not provided" (which strips the last
+ * extension present) — a truthy check would silently treat both the same.
+ */
+export declare function exportedImageFileName(fileName: string, sourceExtension?: string): string;
+export declare function exportedImageResultFileName(result: SketchExportImageResult, fallback: string): string;
+/** The default stroke color a new tool should start with, given the active theme. */
+export declare function resolveDefaultSketchToolColor(theme: string | null, prefersDark: boolean): string;
+export declare function defaultExcalidrawLangCode(locale: string, overrides?: Record<string, string>): string;
+export declare function normalizeTooltipLabel(value: string | null | undefined): string | null;
+/** Builds the toolbar-tooltip label table by routing each English string through `t()`. */
+export declare function buildSketchTooltipLabels(t: SketchTranslate): SketchTooltipLabels;
+/**
+ * Rewrites a raw DOM text/attribute value using a flat `{ english: translated }`
+ * table, matching either the whole (trimmed) value or an `"English — rest"` /
+ * `"English - rest"` / `"English: rest"` prefix. Returns `null` when nothing
+ * in `overrides` matches (caller should leave the node untouched).
+ */
+export declare function translateDomTextValue(value: string, overrides: SketchDomTextOverrides): string | null;
+/** Filters `actionNames` down to `allowList`, reordered to match `allowList`'s order. */
+export declare function orderContextMenuActions(actionNames: readonly string[], allowList: readonly string[]): string[];
+export declare function validateSketchEmbeddableUrl(link: string): boolean;
+/**
+ * Detects Excalidraw's built-in "embedding this URL isn't allowed" toast by
+ * its English phrasing (a GitHub-issue-whitelist message), plus any
+ * additional locale-specific phrasings a host has already translated via
+ * its own `domTextOverrides` table (so the detection stays in sync with
+ * whatever the host chose to translate, rather than hardcoding one
+ * product's translations here).
+ */
+export declare function isExcalidrawUnableToEmbedToast(message: string, additionalPhrases?: readonly string[]): boolean;
+//# sourceMappingURL=rules.d.ts.map

package/dist/features/sketch-editor/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/features/sketch-editor/rules.ts"],"names":[],"mappings":"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"}

package/dist/features/sketch-editor/rules.js

@@ -0,0 +1,257 @@
+import { DEFAULT_EXCALIDRAW_LANG_CODES, DEFAULT_SKETCH_DARK_TOOL_COLOR, DEFAULT_SKETCH_LIGHT_TOOL_COLOR, } from './constants.js';
+export function cloneJson(value, fallback) {
+    try {
+        return JSON.parse(JSON.stringify(value));
+    }
+    catch {
+        return fallback;
+    }
+}
+/**
+ * Strips fields Excalidraw's own `AppState` marks as transient/session-only
+ * (open menus/dialogs, in-flight drag/resize/edit state, collaborator
+ * cursors) so a persisted scene never rehydrates mid-interaction UI.
+ */
+export function sanitizeExcalidrawAppState(value) {
+    const appState = value ? cloneJson(value, {}) : {};
+    delete appState.collaborators;
+    delete appState.contextMenu;
+    delete appState.draggingElement;
+    delete appState.editingElement;
+    delete appState.editingTextElement;
+    delete appState.frameToHighlight;
+    delete appState.newElement;
+    delete appState.openDialog;
+    delete appState.openMenu;
+    delete appState.openPopup;
+    delete appState.openSidebar;
+    delete appState.defaultSidebarDockedPreference;
+    delete appState.pendingImageElementId;
+    delete appState.resizingElement;
+    delete appState.selectionElement;
+    delete appState.suggestedBindings;
+    return appState;
+}
+export function emptySketchScene(name) {
+    return {
+        elements: [],
+        appState: {
+            name: name ?? null,
+            viewBackgroundColor: '#ffffff',
+            gridSize: null,
+        },
+        files: {},
+    };
+}
+export function sketchSceneHasContent(scene) {
+    return Boolean(scene?.elements.some((element) => {
+        if (!element || typeof element !== 'object')
+            return false;
+        return element.isDeleted !== true;
+    }));
+}
+export function buildInitialData(scene, fileName, defaultStrokeColor) {
+    return {
+        elements: scene.elements,
+        appState: {
+            ...sanitizeExcalidrawAppState(scene.appState),
+            name: fileName,
+            currentItemStrokeColor: defaultStrokeColor,
+            viewBackgroundColor: typeof scene.appState?.viewBackgroundColor === 'string'
+                ? scene.appState.viewBackgroundColor
+                : '#ffffff',
+        },
+        files: scene.files,
+        scrollToContent: scene.elements.length > 0,
+    };
+}
+export function sceneFromExcalidraw(elements, appState, files) {
+    return {
+        elements: cloneJson(elements, []),
+        appState: sanitizeExcalidrawAppState(cloneJson(appState, null)),
+        files: cloneJson(files, {}),
+    };
+}
+export function isNonDeletedExcalidrawElement(element) {
+    return Boolean(element && typeof element === 'object' && element.isDeleted !== true);
+}
+function stableJsonStringify(value) {
+    try {
+        return JSON.stringify(sortJsonValue(value));
+    }
+    catch {
+        return '';
+    }
+}
+function sortJsonValue(value) {
+    if (Array.isArray(value))
+        return value.map(sortJsonValue);
+    if (!value || typeof value !== 'object')
+        return value;
+    const record = value;
+    return Object.keys(record)
+        .sort()
+        .reduce((acc, key) => {
+        acc[key] = sortJsonValue(record[key]);
+        return acc;
+    }, {});
+}
+/**
+ * A content-only fingerprint of a scene, used to dedupe Excalidraw's
+ * `onChange` firing against no-op re-renders (it fires on selection/hover
+ * changes too, not just content edits).
+ */
+export function sceneContentSignature(elements, appState, files) {
+    const elementSignature = elements
+        .map((element) => {
+        const record = element;
+        if (typeof record?.version === 'number') {
+            return [record.id, record.version, record.versionNonce, record.isDeleted ? 1 : 0].join(':');
+        }
+        return stableJsonStringify(element);
+    })
+        .join('|');
+    const fileSignature = Object.keys(files)
+        .sort()
+        .map((id) => {
+        const file = files[id];
+        if (!file || typeof file !== 'object')
+            return id;
+        const record = file;
+        const dataURL = record.dataURL;
+        return [id, record.mimeType ?? '', record.created ?? '', typeof dataURL === 'string' ? dataURL.length : 0].join(':');
+    })
+        .join('|');
+    const viewBackgroundColor = typeof appState.viewBackgroundColor === 'string' ? appState.viewBackgroundColor : '';
+    return `${elementSignature}\n${fileSignature}\n${viewBackgroundColor}`;
+}
+/**
+ * Strips a known source extension (default: the last `.ext`) and appends
+ * `.png`. `sourceExtension` is checked with `typeof ... === 'string'`, not
+ * truthiness: a caller explicitly passing `''` means "strip nothing," which
+ * must be distinguishable from "not provided" (which strips the last
+ * extension present) — a truthy check would silently treat both the same.
+ */
+export function exportedImageFileName(fileName, sourceExtension) {
+    const slash = fileName.lastIndexOf('/');
+    const baseName = slash >= 0 ? fileName.slice(slash + 1) : fileName;
+    const stem = typeof sourceExtension === 'string'
+        ? baseName.toLowerCase().endsWith(sourceExtension.toLowerCase())
+            ? baseName.slice(0, baseName.length - sourceExtension.length)
+            : baseName
+        : baseName.replace(/\.[^./]+$/, '');
+    return `${stem || 'sketch'}.png`;
+}
+export function exportedImageResultFileName(result, fallback) {
+    if (result && typeof result === 'object' && typeof result.fileName === 'string') {
+        return result.fileName;
+    }
+    return fallback;
+}
+/** The default stroke color a new tool should start with, given the active theme. */
+export function resolveDefaultSketchToolColor(theme, prefersDark) {
+    if (theme === 'dark')
+        return DEFAULT_SKETCH_DARK_TOOL_COLOR;
+    if (theme === 'light')
+        return DEFAULT_SKETCH_LIGHT_TOOL_COLOR;
+    return prefersDark ? DEFAULT_SKETCH_DARK_TOOL_COLOR : DEFAULT_SKETCH_LIGHT_TOOL_COLOR;
+}
+export function defaultExcalidrawLangCode(locale, overrides = DEFAULT_EXCALIDRAW_LANG_CODES) {
+    return overrides[locale] ?? 'en';
+}
+export function normalizeTooltipLabel(value) {
+    const normalized = value?.replace(/\s+/g, ' ').trim();
+    return normalized ? normalized : null;
+}
+const TOOLTIP_LABEL_KEYS = {
+    mainMenu: 'Main menu',
+    lock: 'Lock',
+    hand: 'Hand tool',
+    selection: 'Selection',
+    rectangle: 'Rectangle',
+    diamond: 'Diamond',
+    ellipse: 'Ellipse',
+    arrow: 'Arrow',
+    line: 'Line',
+    freedraw: 'Freehand draw',
+    text: 'Text',
+    image: 'Insert image',
+    eraser: 'Eraser',
+    frame: 'Frame',
+    embeddable: 'Embed',
+    laser: 'Laser pointer',
+    moreTools: 'More tools',
+};
+/** Builds the toolbar-tooltip label table by routing each English string through `t()`. */
+export function buildSketchTooltipLabels(t) {
+    const labels = {};
+    for (const key of Object.keys(TOOLTIP_LABEL_KEYS)) {
+        labels[key] = t(TOOLTIP_LABEL_KEYS[key]);
+    }
+    return labels;
+}
+/**
+ * Rewrites a raw DOM text/attribute value using a flat `{ english: translated }`
+ * table, matching either the whole (trimmed) value or an `"English — rest"` /
+ * `"English - rest"` / `"English: rest"` prefix. Returns `null` when nothing
+ * in `overrides` matches (caller should leave the node untouched).
+ */
+export function translateDomTextValue(value, overrides) {
+    // Every group in this pattern is quantified with `*` (zero-or-more), so it
+    // matches every string input, including `''` — `.match()` can never return
+    // null here, and each capture group is always defined (possibly empty).
+    // The nullable return/`| undefined` group types are just `RegExp.match`'s
+    // and `RegExpMatchArray`'s general signatures, not a real runtime path.
+    const match = value.match(/^(\s*)([\s\S]*?)(\s*)$/);
+    const leading = match[1];
+    const core = match[2];
+    const trailing = match[3];
+    const normalized = core.replace(/\s+/g, ' ').trim();
+    if (!normalized)
+        return null;
+    const exact = overrides[normalized];
+    if (exact)
+        return `${leading}${exact}${trailing}`;
+    for (const [source, replacement] of Object.entries(overrides)) {
+        for (const separator of [' — ', ' - ', ': ']) {
+            if (normalized.startsWith(`${source}${separator}`)) {
+                return `${leading}${replacement}${normalized.slice(source.length)}${trailing}`;
+            }
+        }
+    }
+    return null;
+}
+/** Filters `actionNames` down to `allowList`, reordered to match `allowList`'s order. */
+export function orderContextMenuActions(actionNames, allowList) {
+    const present = new Set(actionNames);
+    return allowList.filter((action) => present.has(action));
+}
+export function validateSketchEmbeddableUrl(link) {
+    const trimmed = link.trim();
+    if (!trimmed)
+        return false;
+    try {
+        const url = new URL(trimmed);
+        return url.protocol === 'https:' || url.protocol === 'http:';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detects Excalidraw's built-in "embedding this URL isn't allowed" toast by
+ * its English phrasing (a GitHub-issue-whitelist message), plus any
+ * additional locale-specific phrasings a host has already translated via
+ * its own `domTextOverrides` table (so the detection stays in sync with
+ * whatever the host chose to translate, rather than hardcoding one
+ * product's translations here).
+ */
+export function isExcalidrawUnableToEmbedToast(message, additionalPhrases = []) {
+    const lower = message.toLowerCase();
+    if (lower.includes('embedding this url is currently not allowed'))
+        return true;
+    if (additionalPhrases.some((phrase) => message.includes(phrase)))
+        return true;
+    return lower.includes('github') && (lower.includes('issue') || lower.includes('whitelist'));
+}
+//# sourceMappingURL=rules.js.map