@oh-just-another/editor 0.59.0 → 0.61.0

package/dist/file-actions.d.ts

@@ -0,0 +1,41 @@
+import type { Scene } from "@oh-just-another/scene";
+import { type Action, type ActionRegistry, type Editor } from "@oh-just-another/state";
+import { type PngExportBackground } from "./png-export.js";
+/** Override the notifier used by the file actions (host toast, etc). */
+export declare const setFileActionNotifier: (fn: (message: string) => void) => void;
+/** "Save as JSON" — serialises the scene through `@serialization`. */
+export declare const downloadScene: (scene: Scene) => void;
+/**
+ * "Open…" — file picker that accepts `.diagram.json`, parses it, and
+ * replaces the editor's scene (history reset — the default `loadScene`
+ * behaviour). User cancellation = no-op; a parse failure shows a toast.
+ */
+export declare const openSceneFile: (editor: Editor) => void;
+/**
+ * "Export as PNG" — renders the full scene (not just the viewport) via
+ * {@link exportSceneToPng} and downloads it. `background` picks the
+ * transparent / solid / solid+grid variant.
+ */
+export declare const downloadPng: (editor: Editor, background: PngExportBackground) => Promise<void>;
+/** "Export as SVG" — vector export via `renderSceneToSvg`. */
+export declare const downloadSvg: (scene: Scene) => void;
+/**
+ * "Copy as image" — writes a PNG of the full scene to the system
+ * clipboard via the async Clipboard API. SVG-to-clipboard is a follow-up
+ * (no reliable cross-browser `image/svg+xml` clipboard support today, so
+ * we ship the PNG path that works everywhere the API exists).
+ */
+export declare const copySceneAsImage: (editor: Editor) => Promise<void>;
+/**
+ * File-ops actions. `save` / `export` / `copy-as-image` are flagged
+ * `viewMode` (non-mutating — fine in read-only); `open` replaces the
+ * document, so it stays gated in read-only.
+ */
+export declare const fileActions: readonly Action[];
+/**
+ * Register the file-ops actions on a registry (defaults to the shared
+ * {@link defaultActionRegistry}). Idempotent — safe to call on every
+ * `<Editor>` mount; re-registers in place via `replace`.
+ */
+export declare const registerFileActions: (registry?: ActionRegistry) => void;
+//# sourceMappingURL=file-actions.d.ts.map

package/dist/file-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-actions.d.ts","sourceRoot":"","sources":["../src/file-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,EACL,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,MAAM,EAEZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AA0B7E,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,GAAI,IAAI,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,KAAG,IAErE,CAAC;AAoBF,sEAAsE;AACtE,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,IAG5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,IAmB9C,CAAC;AAaF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,YAAY,mBAAmB,KAC9B,OAAO,CAAC,IAAI,CAWd,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,KAAG,IAG1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAwBnE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAyCxC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAU,cAAsC,KAAG,IAEtF,CAAC"}

package/dist/file-actions.js

@@ -0,0 +1,201 @@
+import { parseScene, stringifyScene } from "@oh-just-another/serialization";
+import { renderSceneToSvg } from "@oh-just-another/renderer-svg";
+import { defaultActionRegistry, } from "@oh-just-another/state";
+import { exportSceneToPng } from "./png-export.js";
+/**
+ * File operations for the editor — Save / Open / Export / Copy-as-image —
+ * wired as {@link Action}s so hosts binding the action registry (hotkeys,
+ * menus, command palette) get them for free. Each action just glues the
+ * existing serialization + exporter pipelines to the browser's file /
+ * clipboard APIs; nothing here re-implements serialization or rendering.
+ *
+ * Lives in `@oh-just-another/editor` (not the lower `state` / `react-ui`
+ * layers) because it needs `@oh-just-another/serialization` +
+ * {@link exportSceneToPng}, which are only available here.
+ */
+/** Device-pixel scale for PNG export / copy. 2 = retina-quality. */
+const PNG_EXPORT_SCALE = 2;
+/**
+ * Host notifier for user-facing errors (bad file, empty canvas,
+ * clipboard unsupported). Defaults to `window.alert`; `<Editor>` swaps
+ * it for its toast via {@link setFileActionNotifier}.
+ */
+let notify = (message) => {
+    if (typeof window !== "undefined")
+        window.alert(message);
+};
+/** Override the notifier used by the file actions (host toast, etc). */
+export const setFileActionNotifier = (fn) => {
+    notify = fn;
+};
+/**
+ * Trigger a browser download of arbitrary bytes. Creates a temporary
+ * `<a>`, clicks it, and revokes the object URL on the next frame so the
+ * browser has time to start the download.
+ */
+const downloadBlob = (blob, filename) => {
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = filename;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    requestAnimationFrame(() => {
+        URL.revokeObjectURL(url);
+    });
+};
+/** "Save as JSON" — serialises the scene through `@serialization`. */
+export const downloadScene = (scene) => {
+    const json = stringifyScene(scene, 2);
+    downloadBlob(new Blob([json], { type: "application/json" }), "scene.diagram.json");
+};
+/**
+ * "Open…" — file picker that accepts `.diagram.json`, parses it, and
+ * replaces the editor's scene (history reset — the default `loadScene`
+ * behaviour). User cancellation = no-op; a parse failure shows a toast.
+ */
+export const openSceneFile = (editor) => {
+    if (typeof document === "undefined")
+        return;
+    const input = document.createElement("input");
+    input.type = "file";
+    input.accept = "application/json,.json";
+    input.onchange = () => {
+        const file = input.files?.[0];
+        if (!file)
+            return;
+        void file.text().then((text) => {
+            try {
+                const scene = parseScene(text);
+                editor.loadScene(scene);
+            }
+            catch (err) {
+                console.error("[diagram] failed to parse scene file:", err);
+                notify("Failed to parse the file — make sure it was saved through this app's Save action.");
+            }
+        });
+    };
+    input.click();
+};
+/**
+ * Read the host's current `--du-canvas-bg` CSS variable (falls back to
+ * white). Matches what the user sees behind the shapes on the live canvas.
+ */
+const readCanvasBackgroundColor = () => {
+    if (typeof document === "undefined")
+        return "#ffffff";
+    const probe = document.querySelector('canvas[data-layer="main"]') ?? document.body;
+    const value = getComputedStyle(probe).getPropertyValue("--du-canvas-bg").trim();
+    return value || "#ffffff";
+};
+/**
+ * "Export as PNG" — renders the full scene (not just the viewport) via
+ * {@link exportSceneToPng} and downloads it. `background` picks the
+ * transparent / solid / solid+grid variant.
+ */
+export const downloadPng = async (editor, background) => {
+    const blob = await exportSceneToPng(editor.scene, {
+        background,
+        scale: PNG_EXPORT_SCALE,
+        backgroundColor: readCanvasBackgroundColor(),
+    });
+    if (!blob) {
+        notify("Nothing to export — the canvas is empty.");
+        return;
+    }
+    downloadBlob(blob, "scene.png");
+};
+/** "Export as SVG" — vector export via `renderSceneToSvg`. */
+export const downloadSvg = (scene) => {
+    const svg = renderSceneToSvg(scene);
+    downloadBlob(new Blob([svg], { type: "image/svg+xml" }), "scene.svg");
+};
+/**
+ * "Copy as image" — writes a PNG of the full scene to the system
+ * clipboard via the async Clipboard API. SVG-to-clipboard is a follow-up
+ * (no reliable cross-browser `image/svg+xml` clipboard support today, so
+ * we ship the PNG path that works everywhere the API exists).
+ */
+export const copySceneAsImage = async (editor) => {
+    // `navigator.clipboard` is typed as always-present but is absent in
+    // insecure contexts / older browsers, so probe it through an optional cast.
+    const clipboard = typeof navigator === "undefined" ? undefined : navigator.clipboard;
+    if (typeof clipboard?.write !== "function" || typeof ClipboardItem === "undefined") {
+        notify("Copy to clipboard isn't supported in this browser.");
+        return;
+    }
+    const blob = await exportSceneToPng(editor.scene, {
+        background: "color",
+        scale: PNG_EXPORT_SCALE,
+        backgroundColor: readCanvasBackgroundColor(),
+    });
+    if (!blob) {
+        notify("Nothing to copy — the canvas is empty.");
+        return;
+    }
+    try {
+        await clipboard.write([new ClipboardItem({ "image/png": blob })]);
+    }
+    catch (err) {
+        console.error("[diagram] copy-as-image failed:", err);
+        notify("Couldn't copy the image to the clipboard.");
+    }
+};
+/**
+ * File-ops actions. `save` / `export` / `copy-as-image` are flagged
+ * `viewMode` (non-mutating — fine in read-only); `open` replaces the
+ * document, so it stays gated in read-only.
+ */
+export const fileActions = [
+    {
+        id: "save-scene",
+        label: "Save as JSON",
+        category: "other",
+        viewMode: true,
+        hotkey: { key: "s", meta: true },
+        perform: ({ editor }) => {
+            downloadScene(editor.scene);
+        },
+    },
+    {
+        id: "open-scene",
+        label: "Open…",
+        category: "other",
+        hotkey: { key: "o", meta: true },
+        perform: ({ editor }) => {
+            openSceneFile(editor);
+        },
+    },
+    {
+        id: "export-png",
+        label: "Export as PNG",
+        category: "other",
+        viewMode: true,
+        hotkey: { key: "e", meta: true, shift: true },
+        perform: ({ editor }) => {
+            void downloadPng(editor, "color");
+        },
+    },
+    {
+        id: "copy-as-image",
+        label: "Copy as image",
+        category: "other",
+        viewMode: true,
+        // ⇧⌥C — distinct from ⌘C (copy selection) and ⌥⌘C (copy style).
+        hotkey: { key: "c", shift: true, alt: true },
+        perform: ({ editor }) => {
+            void copySceneAsImage(editor);
+        },
+    },
+];
+/**
+ * Register the file-ops actions on a registry (defaults to the shared
+ * {@link defaultActionRegistry}). Idempotent — safe to call on every
+ * `<Editor>` mount; re-registers in place via `replace`.
+ */
+export const registerFileActions = (registry = defaultActionRegistry) => {
+    for (const action of fileActions)
+        registry.replace(action);
+};
+//# sourceMappingURL=file-actions.js.map

package/dist/file-actions.js.map

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

package/dist/index.d.ts

@@ -22,13 +22,21 @@ export { detectCapabilities, logCapabilities, type CapabilityProfile, type Capab
 export { isEditableTarget } from "./dom-focus.js";
 export { bindEditorHotkeys, type HotkeyBindingOptions } from "@oh-just-another/state";
 export { exportSceneToPng, type PngExportBackground, type PngExportOptions } from "./png-export.js";
+export { fileActions, registerFileActions, setFileActionNotifier, downloadScene, downloadSvg, downloadPng, openSceneFile, copySceneAsImage, } from "./file-actions.js";
 export { registerBounder, registerLayoutKind } from "@oh-just-another/scene";
 export { registerElementRenderer, registerAnimationAdapter } from "@oh-just-another/renderer-core";
+export { registerInteractiveHitTester, registerRotateAnchor } from "@oh-just-another/state";
 export { registerMigration } from "@oh-just-another/serialization";
+export { defineShape, type ShapeSpec, type ShapeRegistration } from "./define-shape.js";
 export { installGifAnimationAdapter } from "./gif-animation.js";
 export type { ElementId } from "@oh-just-another/types";
-export type { Editor as EditorInstance, Mode, FileDropHandler } from "@oh-just-another/state";
-export type { Scene, LayoutKindEntry } from "@oh-just-another/scene";
+export type { ActiveTool, Editor as EditorInstance, Mode, FileDropHandler, } from "@oh-just-another/state";
+export { clampCrop, computeConvertType, computeSetImageCrop, computeCommitImageCrop, computeSpawnConnectedNode, cropFullImageLocalRect, cropHandleWorldPoints, computeCropHandleDrag, computeCropBodyPan, CROP_HANDLES, FULL_CROP, pickColorAt, } from "@oh-just-another/state";
+export type { ConvertTarget, CropDragResult, CropHandle, SpawnDirection, } from "@oh-just-another/state";
+export type { ImageCrop } from "@oh-just-another/scene";
+export type { Scene, LayoutKindEntry, ElementBase, ElementBounder, AnchorRef, } from "@oh-just-another/scene";
+export type { ElementRenderer, RenderTarget } from "@oh-just-another/renderer-core";
+export type { InteractiveHitTester } from "@oh-just-another/state";
 export type { Template } from "@oh-just-another/templates";
 export type { AnimatedSourceAdapter } from "@oh-just-another/renderer-core";
 export type { RendererBackend } from "@oh-just-another/renderer-canvas";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACL,OAAO,IAAI,MAAM,EACjB,OAAO,EACP,KAAK,UAAU,IAAI,SAAS,EAC5B,KAAK,UAAU,EACf,KAAK,YAAY,IAAI,WAAW,EAChC,KAAK,YAAY,EACjB,KAAK,YAAY,IAAI,WAAW,EAChC,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKpG,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAOhE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,MAAM,IAAI,cAAc,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9F,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrE,YAAY,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,YAAY,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACL,OAAO,IAAI,MAAM,EACjB,OAAO,EACP,KAAK,UAAU,IAAI,SAAS,EAC5B,KAAK,UAAU,EACf,KAAK,YAAY,IAAI,WAAW,EAChC,KAAK,YAAY,EACjB,KAAK,YAAY,IAAI,WAAW,EAChC,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAIpG,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AACnG,OAAO,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGxF,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAOhE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EACV,UAAU,EACV,MAAM,IAAI,cAAc,EACxB,IAAI,EACJ,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,aAAa,EACb,cAAc,EACd,UAAU,EACV,cAAc,GACf,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EACV,KAAK,EACL,eAAe,EACf,WAAW,EACX,cAAc,EACd,SAAS,GACV,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACpF,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,YAAY,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/index.js

@@ -22,13 +22,23 @@ export { detectCapabilities, logCapabilities, } from "./capabilities.js";
 export { isEditableTarget } from "./dom-focus.js";
 export { bindEditorHotkeys } from "@oh-just-another/state";
 export { exportSceneToPng } from "./png-export.js";
+// File operations (Save / Open / Export / Copy-as-image) — registered on
+// the action registry by `<Editor>`; exported so hosts can wire them to
+// their own chrome or a custom registry.
+export { fileActions, registerFileActions, setFileActionNotifier, downloadScene, downloadSvg, downloadPng, openSceneFile, copySceneAsImage, } from "./file-actions.js";
 // Plug-in registries from the underlying packages, surfaced here so the
 // umbrella package is the single import for extending the editor without
 // reaching into the lower-level packages.
 export { registerBounder, registerLayoutKind } from "@oh-just-another/scene";
 export { registerElementRenderer, registerAnimationAdapter } from "@oh-just-another/renderer-core";
+export { registerInteractiveHitTester, registerRotateAnchor } from "@oh-just-another/state";
 export { registerMigration } from "@oh-just-another/serialization";
+// `defineShape` — one-call facade over the registries above for adding a
+// custom shape type (bounds + render + optional interaction hooks).
+export { defineShape } from "./define-shape.js";
 // Built-in GIF decoder — `<Editor>` installs it by default; exported so hosts
 // can install it explicitly or opt into it without the component.
 export { installGifAnimationAdapter } from "./gif-animation.js";
+// Tool operations + types (eyedropper / convert-type / image-crop / spawn).
+export { clampCrop, computeConvertType, computeSetImageCrop, computeCommitImageCrop, computeSpawnConnectedNode, cropFullImageLocalRect, cropHandleWorldPoints, computeCropHandleDrag, computeCropBodyPan, CROP_HANDLES, FULL_CROP, pickColorAt, } from "@oh-just-another/state";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACL,OAAO,IAAI,MAAM,EACjB,OAAO,GAOR,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,eAAe,GAGhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAA6B,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAmD,MAAM,iBAAiB,CAAC;AAEpG,wEAAwE;AACxE,yEAAyE;AACzE,0CAA0C;AAC1C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,8EAA8E;AAC9E,kEAAkE;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACL,OAAO,IAAI,MAAM,EACjB,OAAO,GAOR,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,eAAe,GAGhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAA6B,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAmD,MAAM,iBAAiB,CAAC;AACpG,yEAAyE;AACzE,wEAAwE;AACxE,yCAAyC;AACzC,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,wEAAwE;AACxE,yEAAyE;AACzE,0CAA0C;AAC1C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AACnG,OAAO,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,yEAAyE;AACzE,oEAAoE;AACpE,OAAO,EAAE,WAAW,EAA0C,MAAM,mBAAmB,CAAC;AACxF,8EAA8E;AAC9E,kEAAkE;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAchE,4EAA4E;AAC5E,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,WAAW,GACZ,MAAM,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oh-just-another/editor",
-  "version": "0.59.0",
+  "version": "0.61.0",
   "description": "Drop-in diagram editor as a single React component. Auto-detects renderer / WASM / worker capabilities and exposes a programmatic editor API.",
   "license": "MIT",
   "author": "Rustam Garifulin <rustam@n69.in>",
@@ -42,16 +42,16 @@
     "gifuct-js": "2.1.2",
     "lucide-react": "1.16.0",
     "@oh-just-another/fonts": "0.1.0",
-    "@oh-just-another/raster-wasm": "0.57.2",
-    "@oh-just-another/react-ui": "0.58.0",
-    "@oh-just-another/renderer-canvas": "0.59.0",
-    "@oh-just-another/renderer-core": "0.58.0",
-    "@oh-just-another/renderer-svg": "0.57.2",
-    "@oh-just-another/scene": "0.59.0",
-    "@oh-just-another/serialization": "0.58.0",
-    "@oh-just-another/state": "0.59.0",
-    "@oh-just-another/templates": "0.57.2",
-    "@oh-just-another/text-wasm": "0.57.2",
+    "@oh-just-another/raster-wasm": "0.57.4",
+    "@oh-just-another/react-ui": "0.60.0",
+    "@oh-just-another/renderer-canvas": "0.61.0",
+    "@oh-just-another/renderer-core": "0.60.0",
+    "@oh-just-another/renderer-svg": "0.57.4",
+    "@oh-just-another/scene": "0.61.0",
+    "@oh-just-another/serialization": "0.60.0",
+    "@oh-just-another/state": "0.61.0",
+    "@oh-just-another/templates": "0.57.4",
+    "@oh-just-another/text-wasm": "0.57.4",
     "@oh-just-another/types": "0.57.0"
   },
   "peerDependencies": {