@inditextech/weave-sdk 4.1.0 → 4.2.0-SNAPSHOT.307.1

package/dist/sdk.node.js

@@ -3,7 +3,9 @@ import crypto, { randomFillSync, randomUUID } from "crypto";
 import pino from "pino";
 import { WEAVE_ASYNC_STATUS, WEAVE_AWARENESS_LAYER_ID, WEAVE_EXPORT_BACKGROUND_COLOR, WEAVE_EXPORT_FORMATS, WEAVE_EXPORT_RETURN_FORMAT, WEAVE_INSTANCE_STATUS, WEAVE_KONVA_BACKEND, WEAVE_LOG_LEVEL, WEAVE_NODE_CHANGE_TYPE, WEAVE_NODE_CUSTOM_EVENTS, WEAVE_NODE_LAYER_ID, WEAVE_NODE_POSITION, WEAVE_STORE_CONNECTION_STATUS, WEAVE_UTILITY_LAYER_ID } from "@inditextech/weave-types";
 import { getYjsDoc, getYjsValue, observeDeep, syncedStore } from "@syncedstore/core";
+import * as Y$1 from "yjs";
 import * as Y from "yjs";
+import { z } from "zod";
 import simplify from "simplify-js";
 import "konva/lib/types";
 import "konva/lib/Stage";
@@ -15196,7 +15198,7 @@ var import_lodash = __toESM(require_lodash(), 1);
 
 //#endregion
 //#region src/yjs.ts
-var yjs_default = Y;
+var yjs_default = Y$1;
 
 //#endregion
 //#region src/stores/default-initial-state.ts
@@ -15275,6 +15277,7 @@ var WeaveStore = class {
 		return this.document;
 	}
 	restartDocument() {
+		this.document?.destroy();
 		this.latestState = {
 			weave: {},
 			weaveMetadata: {}
@@ -18951,10 +18954,7 @@ var WeaveNodesSelectionPlugin = class extends WeavePlugin {
 		});
 		tr.on("mouseover", () => {
 			const nodesSelected = tr.nodes();
-			if (nodesSelected.length === 1) {
-				const node = nodesSelected[0];
-				stage.container().style.cursor = (typeof node?.defineMousePointer === "function" ? node.defineMousePointer() : null) ?? "grab";
-			} else stage.container().style.cursor = "grab";
+			if (nodesSelected.length > 1) stage.container().style.cursor = "grab";
 		});
 		tr.on("mouseout", (e) => {
 			this.instance.getStage().handleMouseover?.(e);
@@ -20912,16 +20912,16 @@ var WeaveNode = class {
 		if ([MOVE_TOOL_ACTION_NAME].includes(activeAction ?? "")) return false;
 		let showHover = false;
 		let cancelBubble = false;
-		if (isNodeSelectionEnabled && this.isSelecting() && !this.isNodeSelected(realNode) && !this.isPasting() && (isLocked || isMutexLocked)) {
+		if (isNodeSelectionEnabled && this.isSelecting() && !this.isNodeSelected(realNode) && !this.isPasting() && node.hasName("node") && (isLocked || isMutexLocked)) {
 			stage.container().style.cursor = "default";
 			cancelBubble = true;
 		}
-		if (isNodeSelectionEnabled && this.isSelecting() && !this.isNodeSelected(realNode) && !this.isPasting() && isTargetable && !(isLocked || isMutexLocked) && stage.mode() === WEAVE_STAGE_DEFAULT_MODE) {
+		if (isNodeSelectionEnabled && this.isSelecting() && !this.isNodeSelected(realNode) && !this.isPasting() && isTargetable && node.hasName("node") && !(isLocked || isMutexLocked) && stage.mode() === WEAVE_STAGE_DEFAULT_MODE) {
 			showHover = true;
 			stage.container().style.cursor = (typeof node?.defineMousePointer === "function" ? node.defineMousePointer() : null) ?? "pointer";
 			cancelBubble = true;
 		}
-		if (isNodeSelectionEnabled && this.isSelecting() && this.isNodeSelected(realNode) && !this.isPasting() && isTargetable && !(isLocked || isMutexLocked) && stage.mode() === WEAVE_STAGE_DEFAULT_MODE) {
+		if (isNodeSelectionEnabled && this.isSelecting() && this.isNodeSelected(realNode) && !this.isPasting() && node.hasName("node") && isTargetable && !(isLocked || isMutexLocked) && stage.mode() === WEAVE_STAGE_DEFAULT_MODE) {
 			showHover = true;
 			stage.container().style.cursor = (typeof node?.defineMousePointer === "function" ? node.defineMousePointer() : null) ?? "grab";
 			cancelBubble = true;
@@ -21076,6 +21076,48 @@ var WeaveNode = class {
 	getIsAsync() {
 		return false;
 	}
+	static defaultState(nodeId) {
+		return {
+			key: nodeId,
+			type: "unknown",
+			props: {
+				id: nodeId,
+				nodeType: "unknown",
+				x: 0,
+				y: 0,
+				width: 100,
+				height: 100,
+				rotation: 0,
+				scaleX: 1,
+				scaleY: 1,
+				opacity: 1,
+				zIndex: 1,
+				children: []
+			}
+		};
+	}
+	static getSchema() {
+		const baseNodeSchema = z.object({
+			key: z.string().describe("Unique identifier (uuid) for the node, generate one it if not provided"),
+			type: z.string().describe("Type of the node, must be always provided"),
+			props: z.object({
+				id: z.string().describe("Unique identifier (uuid) for the node instance, is the same as key"),
+				nodeType: z.string().describe("Type of the node, must be always provided"),
+				x: z.number().describe("X position of the node, relative to the parent container"),
+				y: z.number().describe("Y position of the node, relative to the parent container"),
+				width: z.number().describe("Width of the node in pixels"),
+				height: z.number().describe("Height of the node in pixels"),
+				scaleX: z.number().describe("Scale factor on the X axis, default is 1"),
+				scaleY: z.number().describe("Scale factor on the Y axis, default is 1"),
+				rotation: z.number().optional().describe("Rotation of the node in degrees, default is 0"),
+				skewX: z.number().optional().describe("Skew on the X axis in degrees, default is 0"),
+				skewY: z.number().optional().describe("Skew on the Y axis in degrees, default is 0"),
+				opacity: z.number().describe("Opacity of the node, between 0 and 1, default is 1"),
+				children: z.array(z.any()).length(0).describe("Children nodes, always be an empty array for leaf nodes")
+			})
+		});
+		return baseNodeSchema;
+	}
 };
 
 //#endregion
@@ -22187,7 +22229,7 @@ var WeaveRegisterManager = class {
 
 //#endregion
 //#region package.json
-var version = "4.1.0";
+var version = "4.2.0-SNAPSHOT.307.1";
 
 //#endregion
 //#region src/managers/setup.ts
@@ -23411,6 +23453,9 @@ var WeaveHooksManager = class {
 	unregisterHook(hookName) {
 		this.registeredHooks.delete(hookName);
 	}
+	reset() {
+		this.registeredHooks.clear();
+	}
 };
 
 //#endregion
@@ -23605,8 +23650,13 @@ var Weave = class {
 			const nodeHandler = nodeHandlers[nodeHandlerKey];
 			nodeHandler?.onDestroyInstance();
 		}
+		const mainLayer = this.stageManager.getMainLayer();
+		if (mainLayer) mainLayer.destroy();
 		const stage = this.getStage();
-		if (stage) stage.destroy();
+		if (stage) {
+			console.log("remove stage");
+			stage.destroy();
+		}
 		if (this.eventsController) this.eventsController.abort();
 		if (!this.isServerSide()) this.eventsController = new AbortController();
 		this.registerManager.reset();
@@ -23619,6 +23669,8 @@ var Weave = class {
 		this.status = WEAVE_INSTANCE_STATUS.STARTING;
 		this.emitEvent("onInstanceStatus", this.status);
 		this.registerManager.reset();
+		this.hooks.removeAllHooks();
+		this.hooksManager.reset();
 		this.status = WEAVE_INSTANCE_STATUS.LOADING_FONTS;
 		this.emitEvent("onInstanceStatus", this.status);
 		await this.fontsManager.loadFonts();
@@ -23636,6 +23688,7 @@ var Weave = class {
 		this.emitEvent("onInstanceStatus", this.status);
 		const store = this.storeManager.getStore();
 		store.disconnect();
+		store.getDocument()?.destroy();
 		const nodeHandlers = this.registerManager.getNodesHandlers();
 		for (const nodeHandlerKey of Object.keys(nodeHandlers)) {
 			const nodeHandler = nodeHandlers[nodeHandlerKey];
@@ -24402,6 +24455,114 @@ const downscaleImageFromURL = (url, options) => {
 	});
 };
 
+//#endregion
+//#region src/state.manipulation.ts
+var WeaveStateManipulation = class WeaveStateManipulation {
+	static mapPropsToYjs(props) {
+		const propsMap = new Y.Map();
+		for (const propKey of Object.keys(props)) {
+			const propValue = props[propKey];
+			if (Array.isArray(propValue)) {
+				const childrenArray = new Y.Array();
+				propValue.forEach((child) => {
+					const childMap = WeaveStateManipulation.mapPropsToYjs(child);
+					childrenArray.push([childMap]);
+				});
+			} else if (typeof propValue === "object" && propValue !== null && !Array.isArray(propValue)) propsMap.set(propKey, WeaveStateManipulation.mapPropsToYjs(propValue));
+			else propsMap.set(propKey, propValue);
+		}
+		return propsMap;
+	}
+	static mapNodeToYjs(node) {
+		const nodeId = node.key;
+		const element = new Y.Map();
+		const elementProps = new Y.Map();
+		element.set("key", nodeId);
+		element.set("type", node.type);
+		element.set("props", elementProps);
+		for (const propKey of Object.keys(node.props)) {
+			const propValue = node.props[propKey];
+			if (Array.isArray(propValue) && propKey === "children") {
+				const childrenArray = new Y.Array();
+				propValue.forEach((child) => {
+					const childMap = WeaveStateManipulation.mapNodeToYjs(child);
+					childrenArray.push([childMap.element]);
+				});
+				elementProps.set(propKey, childrenArray);
+			} else if (Array.isArray(propValue) && propKey !== "children") {
+				const childrenArray = new Y.Array();
+				propValue.forEach((child) => {
+					const childMap = WeaveStateManipulation.mapPropsToYjs(child);
+					childrenArray.push([childMap]);
+				});
+				elementProps.set(propKey, childrenArray);
+			} else if (typeof propValue === "object" && propValue !== null && !Array.isArray(propValue)) {
+				const childrenMap = WeaveStateManipulation.mapPropsToYjs(propValue);
+				elementProps.set(propKey, childrenMap);
+			} else elementProps.set(propKey, propValue);
+		}
+		return {
+			nodeId: node.key,
+			element
+		};
+	}
+	static addElements(layerYjsElement, yjsElements) {
+		layerYjsElement.get("props").get("children").push(yjsElements);
+	}
+	static updateElements(layerYjsElement, yjsElements) {
+		for (let i = 0; i < yjsElements.length; i++) {
+			const yjsElement = yjsElements[i];
+			const nodeId = yjsElement.nodeId;
+			const element = yjsElement.element;
+			const childrenArr = JSON.parse(JSON.stringify(layerYjsElement.get("props").get("children")));
+			const index = childrenArr.findIndex((child) => child["key"] === nodeId);
+			if (index !== -1) {
+				layerYjsElement.get("props").get("children").delete(index);
+				layerYjsElement.get("props").get("children").insert(index, [element]);
+			}
+		}
+	}
+	static deleteElements(layerYjsElement, yjsElementsIds) {
+		for (let i = 0; i < yjsElementsIds.length; i++) {
+			const yjsElementId = yjsElementsIds[i];
+			const childrenArr = JSON.parse(JSON.stringify(layerYjsElement.get("props").get("children")));
+			const index = childrenArr.findIndex((child) => child["key"] === yjsElementId);
+			if (index !== -1) layerYjsElement.get("props").get("children").delete(index);
+		}
+	}
+	static getYjsElement(doc, nodeId) {
+		const stage = doc.getMap("weave");
+		const stageProps = stage.get("props");
+		const stageChildren = stageProps.get("children");
+		for (let i = 0; i < stageChildren.length; i++) {
+			const child = stageChildren.get(i);
+			const childProps = child.get("props");
+			if (childProps.get("id") === nodeId) return child;
+			if (childProps.get("children")) {
+				const childChildren = childProps.get("children");
+				for (let j = 0; j < childChildren.length; j++) {
+					const grandChild = childChildren.get(j);
+					const grandChildProps = grandChild.get("props");
+					if (grandChildProps.get("id") === nodeId) return grandChild;
+				}
+			}
+		}
+		return null;
+	}
+	static getNodesBoundingBox(nodes) {
+		const minX = Math.min(...nodes.map((n) => n.props.x));
+		const minY = Math.min(...nodes.map((n) => n.props.y));
+		const maxX = Math.max(...nodes.map((n) => n.props.x + n.props.width));
+		const maxY = Math.max(...nodes.map((n) => n.props.y + n.props.height));
+		return {
+			x: minX,
+			y: minY,
+			width: maxX - minX,
+			height: maxY - minY
+		};
+	}
+};
+
 //#endregion
 //#region src/internal-utils/upscale.ts
 const setupUpscaleStage = (instance, stage) => {
@@ -24518,10 +24679,11 @@ var WeaveStageNode = class extends WeaveNode {
 			const activeAction = this.instance.getActiveAction();
 			if ([MOVE_TOOL_ACTION_NAME].includes(activeAction ?? "")) return;
 			if (e.target !== stage && !e.target.getAttrs().nodeId) return;
-			const parent = e.target.getParent();
+			let parent = e.target.getParent();
 			if (parent && parent instanceof Konva.Transformer) return;
 			this.hideHoverState();
-			if (!this.instance.isServerSide()) stage.container().style.cursor = "default";
+			if (e.target.getAttrs().nodeId) parent = stage.findOne(`#${e.target.getAttrs().nodeId}`);
+			if (!this.instance.isServerSide() && !parent?.hasName("node")) stage.container().style.cursor = "default";
 		});
 		this.setupEvents();
 		return stage;
@@ -24803,6 +24965,65 @@ var WeaveRectangleNode = class extends WeaveNode {
 		const nodesSelectionPlugin = this.instance.getPlugin("nodesSelection");
 		if (nodesSelectionPlugin) nodesSelectionPlugin.getTransformer().forceUpdate();
 	}
+	static defaultState(nodeId) {
+		return {
+			...super.defaultState(nodeId),
+			type: WEAVE_RECTANGLE_NODE_TYPE,
+			props: {
+				...super.defaultState(nodeId).props,
+				nodeType: WEAVE_RECTANGLE_NODE_TYPE,
+				x: 0,
+				y: 0,
+				width: 100,
+				height: 100,
+				stroke: "#000000",
+				fill: "#FFFFFF",
+				strokeWidth: 1,
+				strokeScaleEnabled: true,
+				rotation: 0,
+				zIndex: 1,
+				children: []
+			}
+		};
+	}
+	static addNodeState(defaultNodeState, props) {
+		return mergeExceptArrays(defaultNodeState, { props: {
+			x: props.x,
+			y: props.y,
+			width: props.width,
+			height: props.height,
+			rotation: props.rotation,
+			fill: props.fill,
+			...props.stroke && { stroke: props.stroke },
+			...props.strokeWidth && { strokeWidth: props.strokeWidth }
+		} });
+	}
+	static updateNodeState(prevNodeState, nextProps) {
+		return mergeExceptArrays(prevNodeState, { props: {
+			x: nextProps.x,
+			y: nextProps.y,
+			width: nextProps.width,
+			height: nextProps.height,
+			rotation: nextProps.rotation,
+			fill: nextProps.fill,
+			...nextProps.stroke && { stroke: nextProps.stroke },
+			...nextProps.strokeWidth && { strokeWidth: nextProps.strokeWidth }
+		} });
+	}
+	static getSchema() {
+		const baseSchema = super.getSchema();
+		const imageNodeSchema = baseSchema.extend({
+			type: z.literal("rectangle").describe("Type of the node, for a rectangle node it will always be \"rectangle\""),
+			props: baseSchema.shape.props.extend({
+				nodeType: z.literal("rectangle").describe("Type of the node, for a rectangle node it will always be \"rectangle\""),
+				fill: z.string().describe("Fill color of the rectangle in hex format with alpha channel (e.g. #RRGGBBAA)"),
+				stroke: z.string().describe("Stroke color of the rectangle in hex format with alpha channel (e.g. #RRGGBBAA)"),
+				strokeWidth: z.number().describe("Stroke width of the rectangle in pixels"),
+				strokeScaleEnabled: z.boolean().describe("Whether the rectangle stroke width should scale when the node is scaled. Defaults to true.")
+			})
+		});
+		return imageNodeSchema;
+	}
 };
 
 //#endregion
@@ -25974,6 +26195,62 @@ var WeaveTextNode = class extends WeaveNode {
 		textNode.width(textAreaWidth);
 		this.instance.updateNode(this.serialize(textNode));
 	}
+	static defaultState(nodeId, params) {
+		const config = (0, import_lodash.merge)({}, WEAVE_TEXT_NODE_DEFAULT_CONFIG, params?.config ?? {});
+		return {
+			...super.defaultState(nodeId),
+			type: WEAVE_TEXT_NODE_TYPE,
+			props: {
+				...super.defaultState(nodeId).props,
+				nodeType: "text",
+				fontFamily: "Arial",
+				fontSize: 32,
+				fontStyle: "normal",
+				fontVariant: "normal",
+				textDecoration: "none",
+				letterSpacing: 0,
+				lineHeight: 1,
+				align: "left",
+				verticalAlign: "top",
+				fill: "#000000ff",
+				text: "This is a text node",
+				...!config.outline.enabled && { strokeEnabled: false },
+				...config.outline.enabled && {
+					strokeEnabled: true,
+					stroke: config.outline.color,
+					strokeWidth: config.outline.width,
+					fillAfterStrokeEnabled: true
+				},
+				layout: TEXT_LAYOUT.SMART
+			}
+		};
+	}
+	static getSchema() {
+		const baseSchema = super.getSchema();
+		const textNodeSchema = baseSchema.extend({
+			type: z.literal("text"),
+			props: z.object({
+				nodeType: z.literal("text"),
+				fontFamily: z.string().default("Arial"),
+				fontSize: z.number().default(16),
+				fontStyle: z.string().default("normal"),
+				fontVariant: z.string().default("normal"),
+				textDecoration: z.string().default("none"),
+				letterSpacing: z.number().default(0),
+				lineHeight: z.number().default(1),
+				align: z.string().default("left"),
+				verticalAlign: z.string().default("top"),
+				fill: z.string().default("#000000ff"),
+				text: z.string().default("text"),
+				stroke: z.string().optional().default("#d6d6d6"),
+				strokeWidth: z.number().optional().default(2),
+				strokeScaleEnabled: z.boolean().optional().default(true),
+				fillAfterStrokeEnabled: z.boolean().optional().default(true),
+				layout: z.enum(TEXT_LAYOUT).default(TEXT_LAYOUT.SMART)
+			})
+		});
+		return textNodeSchema;
+	}
 };
 
 //#endregion
@@ -27609,6 +27886,108 @@ var WeaveImageNode = class extends WeaveNode {
 		this.getNodesSelectionPlugin()?.setSelectedNodes([image]);
 		this.getNodesSelectionPlugin()?.getHoverTransformer().forceUpdate();
 	}
+	static defaultState(nodeId) {
+		return {
+			...super.defaultState(nodeId),
+			props: {
+				...super.defaultState(nodeId).props,
+				nodeType: WEAVE_IMAGE_NODE_TYPE,
+				width: 800,
+				height: 600,
+				imageURL: "https://picsum.photos/id/10/800/600",
+				adding: false,
+				imageWidth: 800,
+				imageHeight: 600,
+				imageInfo: {
+					width: 800,
+					height: 600
+				},
+				uncroppedImage: {
+					width: 800,
+					height: 600
+				},
+				cropping: false,
+				stroke: "#000000",
+				fill: "#FFFFFF",
+				strokeWidth: 0,
+				strokeScaleEnabled: true,
+				children: []
+			}
+		};
+	}
+	static addNodeState(defaultNodeState, props) {
+		return mergeExceptArrays(defaultNodeState, { props: {
+			x: props.x,
+			y: props.y,
+			width: props.width,
+			height: props.height,
+			rotation: props.rotation,
+			imageURL: props.imageURL,
+			...props.imageFallback && { imageFallback: props.imageFallback },
+			...props.imageId && { imageId: props.imageId },
+			adding: props.adding,
+			imageWidth: props.imageWidth,
+			imageHeight: props.imageHeight,
+			imageInfo: {
+				width: props.imageInfo.width,
+				height: props.imageInfo.height
+			},
+			uncroppedImage: {
+				width: props.uncroppedImage.width,
+				height: props.uncroppedImage.height
+			},
+			cropping: props.cropping
+		} });
+	}
+	static updateNodeState(prevNodeState, nextProps) {
+		return mergeExceptArrays(prevNodeState, { props: {
+			x: nextProps.x,
+			y: nextProps.y,
+			width: nextProps.width,
+			height: nextProps.height,
+			rotation: nextProps.rotation,
+			imageURL: nextProps.imageURL,
+			...nextProps.imageFallback && { imageFallback: nextProps.imageFallback },
+			...nextProps.imageId && { imageId: nextProps.imageId },
+			adding: nextProps.adding,
+			imageWidth: nextProps.imageWidth,
+			imageHeight: nextProps.imageHeight,
+			...nextProps.imageInfo && { imageInfo: {
+				width: nextProps.imageInfo.width,
+				height: nextProps.imageInfo.height
+			} },
+			...nextProps.uncroppedImage && { uncroppedImage: {
+				width: nextProps.uncroppedImage?.width,
+				height: nextProps.uncroppedImage?.height
+			} },
+			cropping: nextProps.cropping
+		} });
+	}
+	static getSchema() {
+		const baseSchema = super.getSchema();
+		const imageNodeSchema = baseSchema.extend({
+			type: z.literal("image").describe("Type of the node, for a image node it will always be \"image\""),
+			props: baseSchema.shape.props.extend({
+				nodeType: z.literal("image").describe("Type of the node, for a image node it will always be \"image\""),
+				imageURL: z.string().describe("The URL of the image to be rendered by the node"),
+				imageFallback: z.string().optional().describe("The fallback image to display while the image to loads, it must be a base64 string with the format: data:image/{format};base64,{data}"),
+				adding: z.boolean().default(false),
+				imageId: z.string().optional().describe("The id of the image, used for external management of the node."),
+				imageWidth: z.number().describe("The width of the image in pixels"),
+				imageHeight: z.number().describe("The height of the image in pixels"),
+				imageInfo: z.object({
+					width: z.number().describe("The original width of the image in pixels"),
+					height: z.number().describe("The original height of the image in pixels")
+				}),
+				uncroppedImage: z.object({
+					width: z.number().describe("The width of the image before cropping, used for cropping calculations"),
+					height: z.number().describe("The height of the image before cropping, used for cropping calculations")
+				}),
+				cropping: z.boolean().default(false).describe("Whether the image is currently being cropped")
+			})
+		});
+		return imageNodeSchema;
+	}
 };
 
 //#endregion
@@ -28206,6 +28585,7 @@ var WeaveFrameNode = class extends WeaveNode {
 			strokeWidth: 0,
 			fill: "transparent",
 			nodeId: id,
+			nodeType: void 0,
 			id: `${id}-selection-area`,
 			listening: true,
 			draggable: true,
@@ -28362,6 +28742,79 @@ var WeaveFrameNode = class extends WeaveNode {
 		};
 	}
 	scaleReset() {}
+	static defaultState(nodeId) {
+		return {
+			...super.defaultState(nodeId),
+			type: WEAVE_FRAME_NODE_TYPE,
+			props: {
+				...super.defaultState(nodeId).props,
+				nodeType: WEAVE_FRAME_NODE_TYPE,
+				x: 0,
+				y: 0,
+				width: WEAVE_FRAME_NODE_DEFAULT_PROPS.frameWidth,
+				height: WEAVE_FRAME_NODE_DEFAULT_PROPS.frameHeight,
+				title: WEAVE_FRAME_NODE_DEFAULT_PROPS.title,
+				frameWidth: WEAVE_FRAME_NODE_DEFAULT_PROPS.frameWidth,
+				frameHeight: WEAVE_FRAME_NODE_DEFAULT_PROPS.frameHeight,
+				frameBackground: WEAVE_FRAME_NODE_DEFAULT_PROPS.frameBackground,
+				borderWidth: WEAVE_FRAME_NODE_DEFAULT_CONFIG.borderWidth,
+				borderColor: WEAVE_FRAME_NODE_DEFAULT_CONFIG.borderColor,
+				stroke: "transparent",
+				strokeWidth: 0,
+				strokeScaleEnabled: true,
+				rotation: 0,
+				zIndex: 1,
+				children: []
+			}
+		};
+	}
+	static addNodeState(defaultNodeState, props) {
+		return mergeExceptArrays(defaultNodeState, { props: {
+			x: props.props.x,
+			y: props.props.y,
+			width: props.props.width,
+			height: props.props.height,
+			...props.props.title && { stroke: props.props.title },
+			frameWidth: props.props.frameWidth,
+			frameHeight: props.props.frameHeight,
+			...props.props.frameBackground && { stroke: props.props.frameBackground },
+			rotation: props.props.rotation,
+			...props.props.borderColor && { borderColor: props.props.borderColor },
+			...props.props.borderWidth && { borderWidth: props.props.borderWidth }
+		} });
+	}
+	static updateNodeState(prevNodeState, nextProps) {
+		return mergeExceptArrays(prevNodeState, { props: {
+			x: nextProps.x,
+			y: nextProps.y,
+			width: nextProps.width,
+			height: nextProps.height,
+			rotation: nextProps.rotation,
+			title: nextProps.title,
+			...nextProps.frameBackground && { frameBackground: nextProps.frameBackground },
+			...nextProps.borderColor && { stroke: nextProps.borderColor },
+			...nextProps.borderWidth && { strokeWidth: nextProps.borderWidth }
+		} });
+	}
+	static getSchema() {
+		const baseSchema = super.getSchema();
+		const frameNodeSchema = baseSchema.extend({
+			type: z.literal("frame"),
+			props: baseSchema.shape.props.extend({
+				nodeType: z.literal("frame"),
+				width: z.number().optional(),
+				height: z.number().optional(),
+				borderColor: z.string().default("#000000ff"),
+				borderWidth: z.number().default(1),
+				title: z.string().default("Frame"),
+				frameWidth: z.number(),
+				frameHeight: z.number(),
+				frameBackground: z.string().default(WEAVE_FRAME_DEFAULT_BACKGROUND_COLOR),
+				children: z.array(z.any()).default([])
+			})
+		});
+		return frameNodeSchema;
+	}
 };
 
 //#endregion
@@ -28979,6 +29432,7 @@ var WeaveStrokeSingleNode = class extends WeaveNode {
 		this.shiftPressed = false;
 	}
 	initEvents() {
+		if (this.instance.isServerSide()) return;
 		if (this.eventsInitialized) return;
 		window.addEventListener("keydown", (e) => {
 			if (e.key === "Shift") this.shiftPressed = true;
@@ -42944,4 +43398,4 @@ const setupCanvasBackend = async () => {
 };
 
 //#endregion
-export { ALIGN_NODES_ALIGN_TO, ALIGN_NODES_TOOL_ACTION_NAME, ALIGN_NODES_TOOL_STATE, BRUSH_TOOL_ACTION_NAME, BRUSH_TOOL_DEFAULT_CONFIG, BRUSH_TOOL_STATE, CONNECTOR_TOOL_ACTION_NAME, CONNECTOR_TOOL_DEFAULT_CONFIG, CONNECTOR_TOOL_STATE, COPY_PASTE_NODES_PLUGIN_STATE, DEFAULT_GUIDE_TOOL_ACTION_CONFIG, DEFAULT_SNAPPING_MANAGER_CONFIG, ELLIPSE_TOOL_ACTION_NAME, ELLIPSE_TOOL_STATE, ERASER_TOOL_ACTION_NAME, ERASER_TOOL_STATE, FRAME_TOOL_ACTION_NAME, FRAME_TOOL_STATE, GUIDE_DISTANCE_NAME, GUIDE_DISTANCE_ORIGIN, GUIDE_KIND, GUIDE_NAME, GUIDE_ORIENTATION, GUIDE_STATE, GUIDE_TOOL_ACTION_NAME, GUIDE_TOOL_STATE, LINE_TOOL_ACTION_NAME, LINE_TOOL_DEFAULT_CONFIG, LINE_TOOL_STATE, MEASURE_TOOL_ACTION_NAME, MEASURE_TOOL_STATE, MOVE_ORIENTATION, MOVE_TOOL_ACTION_NAME, MOVE_TOOL_STATE, PEN_TOOL_ACTION_NAME, PEN_TOOL_STATE, RECTANGLE_TOOL_ACTION_NAME, RECTANGLE_TOOL_STATE, REGULAR_POLYGON_TOOL_ACTION_NAME, REGULAR_POLYGON_TOOL_STATE, SELECTION_TOOL_ACTION_NAME, SELECTION_TOOL_STATE, STAGE_MINIMAP_DEFAULT_CONFIG, STAR_TOOL_ACTION_NAME, STAR_TOOL_STATE, TEXT_LAYOUT, TEXT_TOOL_ACTION_NAME, TEXT_TOOL_STATE, VIDEO_TOOL_ACTION_NAME, VIDEO_TOOL_STATE, WEAVE_ARROW_NODE_TYPE, WEAVE_ARROW_TOOL_ACTION_NAME, WEAVE_ARROW_TOOL_STATE, WEAVE_COMMENTS_RENDERER_KEY, WEAVE_COMMENTS_TOOL_LAYER_ID, WEAVE_COMMENT_CREATE_ACTION, WEAVE_COMMENT_NODE_ACTION, WEAVE_COMMENT_NODE_DEFAULTS, WEAVE_COMMENT_NODE_TYPE, WEAVE_COMMENT_STATUS, WEAVE_COMMENT_TOOL_ACTION_NAME, WEAVE_COMMENT_TOOL_DEFAULT_CONFIG, WEAVE_COMMENT_TOOL_STATE, WEAVE_COMMENT_VIEW_ACTION, WEAVE_CONNECTOR_NODE_ANCHOR_ORIGIN, WEAVE_CONNECTOR_NODE_DECORATOR_TYPE, WEAVE_CONNECTOR_NODE_DEFAULT_CONFIG, WEAVE_CONNECTOR_NODE_LINE_ORIGIN, WEAVE_CONNECTOR_NODE_LINE_TYPE, WEAVE_CONNECTOR_NODE_TYPE, WEAVE_COPY_PASTE_CONFIG_DEFAULT, WEAVE_COPY_PASTE_NODES_KEY, WEAVE_COPY_PASTE_PASTE_CATCHER_ID, WEAVE_COPY_PASTE_PASTE_MODES, WEAVE_DEFAULT_USER_INFO_FUNCTION, WEAVE_ELLIPSE_NODE_TYPE, WEAVE_FRAME_DEFAULT_BACKGROUND_COLOR, WEAVE_FRAME_NODE_DEFAULT_CONFIG, WEAVE_FRAME_NODE_DEFAULT_PROPS, WEAVE_FRAME_NODE_TYPE, WEAVE_GRID_DEFAULT_CONFIG, WEAVE_GRID_DOT_TYPES, WEAVE_GRID_LAYER_ID, WEAVE_GRID_TYPES, WEAVE_GROUP_NODE_TYPE, WEAVE_IMAGES_TOOL_ACTION_NAME, WEAVE_IMAGES_TOOL_DEFAULT_CONFIG, WEAVE_IMAGES_TOOL_STATE, WEAVE_IMAGES_TOOL_UPLOAD_TYPE, WEAVE_IMAGE_CROP_ANCHOR_POSITION, WEAVE_IMAGE_CROP_END_TYPE, WEAVE_IMAGE_DEFAULT_CONFIG, WEAVE_IMAGE_NODE_TYPE, WEAVE_IMAGE_TOOL_ACTION_NAME, WEAVE_IMAGE_TOOL_CONFIG_DEFAULT, WEAVE_IMAGE_TOOL_STATE, WEAVE_IMAGE_TOOL_UPLOAD_TYPE, WEAVE_LAYER_NODE_TYPE, WEAVE_LINE_NODE_DEFAULT_CONFIG, WEAVE_LINE_NODE_TYPE, WEAVE_MEASURE_NODE_DEFAULT_CONFIG, WEAVE_MEASURE_NODE_TYPE, WEAVE_MEASURE_TOOL_DEFAULT_CONFIG, WEAVE_NODES_MULTI_SELECTION_FEEDBACK_PLUGIN_DEFAULT_CONFIG, WEAVE_NODES_MULTI_SELECTION_FEEDBACK_PLUGIN_KEY, WEAVE_NODES_MULTI_SELECTION_FEEDBACK_PLUGIN_LAYER_ID, WEAVE_NODES_SELECTION_DEFAULT_CONFIG, WEAVE_NODES_SELECTION_KEY, WEAVE_NODES_SELECTION_LAYER_ID, WEAVE_NODES_SNAPPING_PLUGIN_KEY, WEAVE_RECTANGLE_NODE_TYPE, WEAVE_REGULAR_POLYGON_NODE_TYPE, WEAVE_STAGE_DEFAULT_MODE, WEAVE_STAGE_DROP_AREA_KEY, WEAVE_STAGE_GRID_PLUGIN_KEY, WEAVE_STAGE_IMAGE_CROPPING_MODE, WEAVE_STAGE_KEYBOARD_MOVE_DEFAULT_CONFIG, WEAVE_STAGE_KEYBOARD_MOVE_KEY, WEAVE_STAGE_KEYBOARD_MOVE_ORIENTATION, WEAVE_STAGE_MINIMAP_KEY, WEAVE_STAGE_NODE_TYPE, WEAVE_STAGE_PANNING_DEFAULT_CONFIG, WEAVE_STAGE_PANNING_KEY, WEAVE_STAGE_PANNING_THROTTLE_MS, WEAVE_STAGE_TEXT_EDITION_MODE, WEAVE_STAGE_ZOOM_DEFAULT_CONFIG, WEAVE_STAGE_ZOOM_KEY, WEAVE_STAGE_ZOOM_TYPE, WEAVE_STAR_NODE_TYPE, WEAVE_STROKE_NODE_DEFAULT_CONFIG, WEAVE_STROKE_NODE_TYPE, WEAVE_STROKE_SINGLE_NODE_DEFAULT_CONFIG, WEAVE_STROKE_SINGLE_NODE_TIP_SIDE, WEAVE_STROKE_SINGLE_NODE_TIP_TYPE, WEAVE_STROKE_SINGLE_NODE_TYPE, WEAVE_STROKE_TOOL_ACTION_NAME, WEAVE_STROKE_TOOL_ACTION_NAME_ALIASES, WEAVE_STROKE_TOOL_DEFAULT_CONFIG, WEAVE_STROKE_TOOL_STATE, WEAVE_TEXT_NODE_DEFAULT_CONFIG, WEAVE_TEXT_NODE_TYPE, WEAVE_USERS_POINTERS_CONFIG_DEFAULT_PROPS, WEAVE_USERS_POINTERS_KEY, WEAVE_USERS_PRESENCE_CONFIG_DEFAULT_PROPS, WEAVE_USERS_PRESENCE_PLUGIN_KEY, WEAVE_USERS_SELECTION_KEY, WEAVE_USER_POINTER_KEY, WEAVE_USER_PRESENCE_KEY, WEAVE_USER_SELECTION_KEY, WEAVE_VIDEO_DEFAULT_CONFIG, WEAVE_VIDEO_NODE_TYPE, Weave, WeaveAction, WeaveAlignNodesToolAction, WeaveArrowNode, WeaveArrowToolAction, WeaveBrushToolAction, WeaveCommentNode, WeaveCommentToolAction, WeaveCommentsRendererPlugin, WeaveConnectedUsersPlugin, WeaveConnectorNode, WeaveConnectorToolAction, WeaveContextMenuPlugin, WeaveCopyPasteNodesPlugin, WeaveEllipseNode, WeaveEllipseToolAction, WeaveEraserToolAction, WeaveExportNodesToolAction, WeaveExportStageToolAction, WeaveFitToScreenToolAction, WeaveFitToSelectionToolAction, WeaveFrameNode, WeaveFrameToolAction, WeaveGroupNode, WeaveGuideToolAction, WeaveImageNode, WeaveImageToolAction, WeaveImagesToolAction, WeaveLayerNode, WeaveLineNode, WeaveLineToolAction, WeaveMeasureNode, WeaveMeasureToolAction, WeaveMoveToolAction, WeaveNode, WeaveNodesMultiSelectionFeedbackPlugin, WeaveNodesSelectionPlugin, WeaveNodesSnappingPlugin, WeavePenToolAction, WeavePlugin, WeaveRectangleNode, WeaveRectangleToolAction, WeaveRegularPolygonNode, WeaveRegularPolygonToolAction, WeaveRenderer, WeaveSelectionToolAction, WeaveStageDropAreaPlugin, WeaveStageGridPlugin, WeaveStageKeyboardMovePlugin, WeaveStageMinimapPlugin, WeaveStageNode, WeaveStagePanningPlugin, WeaveStageResizePlugin, WeaveStageZoomPlugin, WeaveStarNode, WeaveStarToolAction, WeaveStore, WeaveStrokeNode, WeaveStrokeSingleNode, WeaveStrokeToolAction, WeaveTextNode, WeaveTextToolAction, WeaveUsersPointersPlugin, WeaveUsersPresencePlugin, WeaveUsersSelectionPlugin, WeaveVideoNode, WeaveVideoToolAction, WeaveZoomInToolAction, WeaveZoomOutToolAction, canComposite, clearContainerTargets, containerOverCursor, containsNodeDeep, defaultInitialState, downscaleImageFile, downscaleImageFromURL, getBoundingBox, getDownscaleRatio, getExportBoundingBox, getImageSizeFromFile, getSelectedNodesMetadata, getStageClickPoint, getTargetAndSkipNodes, getTargetedNode, getTopmostShadowHost, getVisibleNodes, getVisibleNodesInViewport, hasFrames, hasImages, intersectArrays, isIOS, isInShadowDOM, isNodeInSelection, isServer, loadImageSource, memoize, mergeExceptArrays, moveNodeToContainer, moveNodeToContainerNT, resetScale, setupCanvasBackend, setupSkiaBackend };
+export { ALIGN_NODES_ALIGN_TO, ALIGN_NODES_TOOL_ACTION_NAME, ALIGN_NODES_TOOL_STATE, BRUSH_TOOL_ACTION_NAME, BRUSH_TOOL_DEFAULT_CONFIG, BRUSH_TOOL_STATE, CONNECTOR_TOOL_ACTION_NAME, CONNECTOR_TOOL_DEFAULT_CONFIG, CONNECTOR_TOOL_STATE, COPY_PASTE_NODES_PLUGIN_STATE, DEFAULT_GUIDE_TOOL_ACTION_CONFIG, DEFAULT_SNAPPING_MANAGER_CONFIG, ELLIPSE_TOOL_ACTION_NAME, ELLIPSE_TOOL_STATE, ERASER_TOOL_ACTION_NAME, ERASER_TOOL_STATE, FRAME_TOOL_ACTION_NAME, FRAME_TOOL_STATE, GUIDE_DISTANCE_NAME, GUIDE_DISTANCE_ORIGIN, GUIDE_KIND, GUIDE_NAME, GUIDE_ORIENTATION, GUIDE_STATE, GUIDE_TOOL_ACTION_NAME, GUIDE_TOOL_STATE, LINE_TOOL_ACTION_NAME, LINE_TOOL_DEFAULT_CONFIG, LINE_TOOL_STATE, MEASURE_TOOL_ACTION_NAME, MEASURE_TOOL_STATE, MOVE_ORIENTATION, MOVE_TOOL_ACTION_NAME, MOVE_TOOL_STATE, PEN_TOOL_ACTION_NAME, PEN_TOOL_STATE, RECTANGLE_TOOL_ACTION_NAME, RECTANGLE_TOOL_STATE, REGULAR_POLYGON_TOOL_ACTION_NAME, REGULAR_POLYGON_TOOL_STATE, SELECTION_TOOL_ACTION_NAME, SELECTION_TOOL_STATE, STAGE_MINIMAP_DEFAULT_CONFIG, STAR_TOOL_ACTION_NAME, STAR_TOOL_STATE, TEXT_LAYOUT, TEXT_TOOL_ACTION_NAME, TEXT_TOOL_STATE, VIDEO_TOOL_ACTION_NAME, VIDEO_TOOL_STATE, WEAVE_ARROW_NODE_TYPE, WEAVE_ARROW_TOOL_ACTION_NAME, WEAVE_ARROW_TOOL_STATE, WEAVE_COMMENTS_RENDERER_KEY, WEAVE_COMMENTS_TOOL_LAYER_ID, WEAVE_COMMENT_CREATE_ACTION, WEAVE_COMMENT_NODE_ACTION, WEAVE_COMMENT_NODE_DEFAULTS, WEAVE_COMMENT_NODE_TYPE, WEAVE_COMMENT_STATUS, WEAVE_COMMENT_TOOL_ACTION_NAME, WEAVE_COMMENT_TOOL_DEFAULT_CONFIG, WEAVE_COMMENT_TOOL_STATE, WEAVE_COMMENT_VIEW_ACTION, WEAVE_CONNECTOR_NODE_ANCHOR_ORIGIN, WEAVE_CONNECTOR_NODE_DECORATOR_TYPE, WEAVE_CONNECTOR_NODE_DEFAULT_CONFIG, WEAVE_CONNECTOR_NODE_LINE_ORIGIN, WEAVE_CONNECTOR_NODE_LINE_TYPE, WEAVE_CONNECTOR_NODE_TYPE, WEAVE_COPY_PASTE_CONFIG_DEFAULT, WEAVE_COPY_PASTE_NODES_KEY, WEAVE_COPY_PASTE_PASTE_CATCHER_ID, WEAVE_COPY_PASTE_PASTE_MODES, WEAVE_DEFAULT_USER_INFO_FUNCTION, WEAVE_ELLIPSE_NODE_TYPE, WEAVE_FRAME_DEFAULT_BACKGROUND_COLOR, WEAVE_FRAME_NODE_DEFAULT_CONFIG, WEAVE_FRAME_NODE_DEFAULT_PROPS, WEAVE_FRAME_NODE_TYPE, WEAVE_GRID_DEFAULT_CONFIG, WEAVE_GRID_DOT_TYPES, WEAVE_GRID_LAYER_ID, WEAVE_GRID_TYPES, WEAVE_GROUP_NODE_TYPE, WEAVE_IMAGES_TOOL_ACTION_NAME, WEAVE_IMAGES_TOOL_DEFAULT_CONFIG, WEAVE_IMAGES_TOOL_STATE, WEAVE_IMAGES_TOOL_UPLOAD_TYPE, WEAVE_IMAGE_CROP_ANCHOR_POSITION, WEAVE_IMAGE_CROP_END_TYPE, WEAVE_IMAGE_DEFAULT_CONFIG, WEAVE_IMAGE_NODE_TYPE, WEAVE_IMAGE_TOOL_ACTION_NAME, WEAVE_IMAGE_TOOL_CONFIG_DEFAULT, WEAVE_IMAGE_TOOL_STATE, WEAVE_IMAGE_TOOL_UPLOAD_TYPE, WEAVE_LAYER_NODE_TYPE, WEAVE_LINE_NODE_DEFAULT_CONFIG, WEAVE_LINE_NODE_TYPE, WEAVE_MEASURE_NODE_DEFAULT_CONFIG, WEAVE_MEASURE_NODE_TYPE, WEAVE_MEASURE_TOOL_DEFAULT_CONFIG, WEAVE_NODES_MULTI_SELECTION_FEEDBACK_PLUGIN_DEFAULT_CONFIG, WEAVE_NODES_MULTI_SELECTION_FEEDBACK_PLUGIN_KEY, WEAVE_NODES_MULTI_SELECTION_FEEDBACK_PLUGIN_LAYER_ID, WEAVE_NODES_SELECTION_DEFAULT_CONFIG, WEAVE_NODES_SELECTION_KEY, WEAVE_NODES_SELECTION_LAYER_ID, WEAVE_NODES_SNAPPING_PLUGIN_KEY, WEAVE_RECTANGLE_NODE_TYPE, WEAVE_REGULAR_POLYGON_NODE_TYPE, WEAVE_STAGE_DEFAULT_MODE, WEAVE_STAGE_DROP_AREA_KEY, WEAVE_STAGE_GRID_PLUGIN_KEY, WEAVE_STAGE_IMAGE_CROPPING_MODE, WEAVE_STAGE_KEYBOARD_MOVE_DEFAULT_CONFIG, WEAVE_STAGE_KEYBOARD_MOVE_KEY, WEAVE_STAGE_KEYBOARD_MOVE_ORIENTATION, WEAVE_STAGE_MINIMAP_KEY, WEAVE_STAGE_NODE_TYPE, WEAVE_STAGE_PANNING_DEFAULT_CONFIG, WEAVE_STAGE_PANNING_KEY, WEAVE_STAGE_PANNING_THROTTLE_MS, WEAVE_STAGE_TEXT_EDITION_MODE, WEAVE_STAGE_ZOOM_DEFAULT_CONFIG, WEAVE_STAGE_ZOOM_KEY, WEAVE_STAGE_ZOOM_TYPE, WEAVE_STAR_NODE_TYPE, WEAVE_STROKE_NODE_DEFAULT_CONFIG, WEAVE_STROKE_NODE_TYPE, WEAVE_STROKE_SINGLE_NODE_DEFAULT_CONFIG, WEAVE_STROKE_SINGLE_NODE_TIP_SIDE, WEAVE_STROKE_SINGLE_NODE_TIP_TYPE, WEAVE_STROKE_SINGLE_NODE_TYPE, WEAVE_STROKE_TOOL_ACTION_NAME, WEAVE_STROKE_TOOL_ACTION_NAME_ALIASES, WEAVE_STROKE_TOOL_DEFAULT_CONFIG, WEAVE_STROKE_TOOL_STATE, WEAVE_TEXT_NODE_DEFAULT_CONFIG, WEAVE_TEXT_NODE_TYPE, WEAVE_USERS_POINTERS_CONFIG_DEFAULT_PROPS, WEAVE_USERS_POINTERS_KEY, WEAVE_USERS_PRESENCE_CONFIG_DEFAULT_PROPS, WEAVE_USERS_PRESENCE_PLUGIN_KEY, WEAVE_USERS_SELECTION_KEY, WEAVE_USER_POINTER_KEY, WEAVE_USER_PRESENCE_KEY, WEAVE_USER_SELECTION_KEY, WEAVE_VIDEO_DEFAULT_CONFIG, WEAVE_VIDEO_NODE_TYPE, Weave, WeaveAction, WeaveAlignNodesToolAction, WeaveArrowNode, WeaveArrowToolAction, WeaveBrushToolAction, WeaveCommentNode, WeaveCommentToolAction, WeaveCommentsRendererPlugin, WeaveConnectedUsersPlugin, WeaveConnectorNode, WeaveConnectorToolAction, WeaveContextMenuPlugin, WeaveCopyPasteNodesPlugin, WeaveEllipseNode, WeaveEllipseToolAction, WeaveEraserToolAction, WeaveExportNodesToolAction, WeaveExportStageToolAction, WeaveFitToScreenToolAction, WeaveFitToSelectionToolAction, WeaveFrameNode, WeaveFrameToolAction, WeaveGroupNode, WeaveGuideToolAction, WeaveImageNode, WeaveImageToolAction, WeaveImagesToolAction, WeaveLayerNode, WeaveLineNode, WeaveLineToolAction, WeaveMeasureNode, WeaveMeasureToolAction, WeaveMoveToolAction, WeaveNode, WeaveNodesMultiSelectionFeedbackPlugin, WeaveNodesSelectionPlugin, WeaveNodesSnappingPlugin, WeavePenToolAction, WeavePlugin, WeaveRectangleNode, WeaveRectangleToolAction, WeaveRegularPolygonNode, WeaveRegularPolygonToolAction, WeaveRenderer, WeaveSelectionToolAction, WeaveStageDropAreaPlugin, WeaveStageGridPlugin, WeaveStageKeyboardMovePlugin, WeaveStageMinimapPlugin, WeaveStageNode, WeaveStagePanningPlugin, WeaveStageResizePlugin, WeaveStageZoomPlugin, WeaveStarNode, WeaveStarToolAction, WeaveStateManipulation, WeaveStore, WeaveStrokeNode, WeaveStrokeSingleNode, WeaveStrokeToolAction, WeaveTextNode, WeaveTextToolAction, WeaveUsersPointersPlugin, WeaveUsersPresencePlugin, WeaveUsersSelectionPlugin, WeaveVideoNode, WeaveVideoToolAction, WeaveZoomInToolAction, WeaveZoomOutToolAction, canComposite, clearContainerTargets, containerOverCursor, containsNodeDeep, defaultInitialState, downscaleImageFile, downscaleImageFromURL, getBoundingBox, getDownscaleRatio, getExportBoundingBox, getImageSizeFromFile, getSelectedNodesMetadata, getStageClickPoint, getTargetAndSkipNodes, getTargetedNode, getTopmostShadowHost, getVisibleNodes, getVisibleNodesInViewport, hasFrames, hasImages, intersectArrays, isIOS, isInShadowDOM, isNodeInSelection, isServer, loadImageSource, memoize, mergeExceptArrays, moveNodeToContainer, moveNodeToContainerNT, resetScale, setupCanvasBackend, setupSkiaBackend };