fabricjs-document-engine 1.0.2 → 1.1.0

package/dist/import/svg-import.cjs

@@ -0,0 +1,256 @@
+const require_errors = require("../engine/errors.cjs");
+const require_content_limits = require("../security/content-limits.cjs");
+let fabric = require("fabric");
+//#region src/import/svg-import.ts
+const XLINK = "http://www.w3.org/1999/xlink";
+const REMOVED_ELEMENTS = [
+	"script",
+	"foreignObject",
+	"iframe",
+	"object",
+	"embed",
+	"audio",
+	"video",
+	"animate",
+	"set",
+	"animateTransform",
+	"animateMotion"
+];
+function refuse(message, cause) {
+	throw new require_errors.DocumentEngineError("SVG_IMPORT_FAILED", message, cause === void 0 ? {} : { cause });
+}
+function unsafe(message) {
+	throw new require_errors.DocumentEngineError("UNSAFE_DOCUMENT", `The SVG was refused: ${message}`, { issues: [{
+		code: "UNSAFE_DOCUMENT",
+		path: "",
+		message
+	}] });
+}
+function parse(svg) {
+	if (typeof DOMParser === "undefined") refuse("Importing SVG needs a browser DOM");
+	const document = new DOMParser().parseFromString(svg.trim(), "image/svg+xml");
+	const error = document.querySelector("parsererror");
+	if (error) refuse(`The SVG is not valid XML: ${(error.textContent ?? "").trim().slice(0, 200)}`);
+	if (document.documentElement.localName !== "svg") refuse("The file is not an SVG: its root element is not <svg>");
+	return document;
+}
+function depthOf(element) {
+	let deepest = 0;
+	const pending = [[element, 1]];
+	while (pending.length > 0) {
+		const [current, depth] = pending.pop();
+		deepest = Math.max(deepest, depth);
+		for (const child of Array.from(current.children)) pending.push([child, depth + 1]);
+	}
+	return deepest;
+}
+/**
+* Removes what an SVG can use to run code or reach other servers. Fabric
+* never runs scripts, but the same file may be shown elsewhere later.
+*/
+function sanitize(document, limits, warnings) {
+	const root = document.documentElement;
+	const elements = root.getElementsByTagName("*").length;
+	const maxObjects = limits.maxObjects ?? 5e4;
+	if (elements > maxObjects) unsafe(`it has ${elements} elements, the limit is ${maxObjects}`);
+	const maxDepth = limits.maxDepth ?? 100;
+	const depth = depthOf(root);
+	if (depth > maxDepth) unsafe(`it is nested ${depth} levels deep, the limit is ${maxDepth}`);
+	let removed = 0;
+	for (const name of REMOVED_ELEMENTS) for (const element of Array.from(root.getElementsByTagName(name))) {
+		element.remove();
+		removed += 1;
+	}
+	const isAllowed = limits.isAllowedUrl ?? require_content_limits.isSafeImageUrl;
+	for (const element of [root, ...Array.from(root.getElementsByTagName("*"))]) {
+		for (const attribute of Array.from(element.attributes)) if (/^on/i.test(attribute.name)) {
+			element.removeAttribute(attribute.name);
+			removed += 1;
+		}
+		const link = element.getAttribute("href") ?? element.getAttributeNS(XLINK, "href");
+		if (link === null) continue;
+		const target = link.trim();
+		if (element.localName === "image") {
+			if (!isAllowed(target) || /^javascript:/i.test(target)) {
+				warnings.push({
+					code: "SVG_IMAGE_BLOCKED",
+					message: `An image with the address ${target.slice(0, 80)} was left out because the address is not allowed`
+				});
+				element.remove();
+			}
+		} else if (!target.startsWith("#")) {
+			element.removeAttribute("href");
+			element.removeAttributeNS(XLINK, "href");
+			removed += 1;
+		}
+	}
+	for (const style of Array.from(root.getElementsByTagName("style"))) {
+		const css = style.textContent ?? "";
+		const cleaned = css.replace(/@import[^;]*;?/gi, "").replace(/url\(\s*['"]?(?!#)[^)]*\)/gi, "none");
+		if (cleaned !== css) {
+			style.textContent = cleaned;
+			removed += 1;
+		}
+	}
+	if (removed > 0) warnings.push({
+		code: "SVG_CONTENT_REMOVED",
+		message: `${removed} scripts, event handlers, embedded pages or links to other files were removed from the SVG`
+	});
+}
+function intersectsViewport(object, width, height) {
+	object.setCoords();
+	const box = object.getBoundingRect();
+	return box.left < width && box.top < height && box.left + box.width > 0 && box.top + box.height > 0;
+}
+function contentBounds(objects) {
+	let left = Infinity;
+	let top = Infinity;
+	let right = -Infinity;
+	let bottom = -Infinity;
+	for (const object of objects) {
+		object.setCoords();
+		const box = object.getBoundingRect();
+		left = Math.min(left, box.left);
+		top = Math.min(top, box.top);
+		right = Math.max(right, box.left + box.width);
+		bottom = Math.max(bottom, box.top + box.height);
+	}
+	return Number.isFinite(left) ? {
+		left,
+		top,
+		width: right - left,
+		height: bottom - top
+	} : {
+		left: 0,
+		top: 0,
+		width: 0,
+		height: 0
+	};
+}
+/** Parses and places an SVG. Adding the result to a canvas is up to the caller. */
+async function readSvg(svg, options = {}, limits = {}) {
+	if (typeof svg !== "string" || svg.trim().length === 0) refuse("The SVG is empty");
+	const warnings = [];
+	const document = parse(svg);
+	sanitize(document, limits, warnings);
+	let parsed;
+	try {
+		parsed = await (0, fabric.parseSVGDocument)(document, void 0, {
+			crossOrigin: options.crossOrigin === void 0 ? "anonymous" : options.crossOrigin,
+			signal: options.signal
+		});
+	} catch (error) {
+		if (require_errors.isDocumentEngineError(error)) throw error;
+		refuse(`Fabric could not read the SVG: ${error instanceof Error ? error.message : String(error)}`, error);
+	}
+	if (options.signal?.aborted) throw new require_errors.DocumentEngineError("LOAD_ABORTED", "The SVG import was cancelled");
+	let objects = parsed.objects.filter((object) => object !== null && object !== void 0);
+	const declared = {
+		width: parsed.options.width ?? 0,
+		height: parsed.options.height ?? 0
+	};
+	const useContent = options.viewport === "content" || declared.width <= 0 || declared.height <= 0;
+	const bounds = useContent ? contentBounds(objects) : {
+		left: 0,
+		top: 0,
+		...declared
+	};
+	const offscreen = options.offscreen ?? "keep";
+	if (offscreen === "drop" && !useContent) {
+		const kept = objects.filter((object) => intersectsViewport(object, bounds.width, bounds.height));
+		if (kept.length < objects.length) warnings.push({
+			code: "SVG_OFFSCREEN_DROPPED",
+			message: `${objects.length - kept.length} elements outside the SVG's viewport were left out`
+		});
+		objects = kept;
+	}
+	const viewport = {
+		width: bounds.width,
+		height: bounds.height
+	};
+	if (objects.length === 0) return {
+		objects: [],
+		viewport,
+		warnings
+	};
+	const group = new fabric.Group([], {
+		layoutManager: new fabric.LayoutManager(new fabric.FixedLayout()),
+		width: bounds.width,
+		height: bounds.height,
+		left: bounds.left + bounds.width / 2,
+		top: bounds.top + bounds.height / 2,
+		originX: "center",
+		originY: "center"
+	});
+	group.add(...objects);
+	if (offscreen === "clip") group.clipPath = new fabric.Rect({
+		width: bounds.width,
+		height: bounds.height,
+		originX: "center",
+		originY: "center",
+		left: 0,
+		top: 0
+	});
+	let scaleX = 1;
+	let scaleY = 1;
+	let shiftX = 0;
+	let shiftY = 0;
+	const fit = options.fit;
+	if (fit && bounds.width > 0 && bounds.height > 0) {
+		const sx = fit.width / bounds.width;
+		const sy = fit.height / bounds.height;
+		const mode = fit.mode ?? "contain";
+		if (mode === "fill") {
+			scaleX = sx;
+			scaleY = sy;
+		} else {
+			scaleX = scaleY = mode === "cover" ? Math.max(sx, sy) : Math.min(sx, sy);
+			shiftX = (fit.width - bounds.width * scaleX) / 2;
+			shiftY = (fit.height - bounds.height * scaleY) / 2;
+		}
+	}
+	group.set({
+		scaleX,
+		scaleY,
+		originX: "left",
+		originY: "top",
+		left: (options.left ?? 0) + shiftX,
+		top: (options.top ?? 0) + shiftY
+	});
+	group.setCoords();
+	if ((options.as ?? "group") === "group") return {
+		objects: [group],
+		viewport,
+		warnings
+	};
+	const clip = group.clipPath;
+	group.clipPath = void 0;
+	const loose = group.removeAll();
+	if (clip) {
+		const frame = group.calcTransformMatrix();
+		for (const object of loose) {
+			const absoluteClip = new fabric.Rect({
+				width: bounds.width,
+				height: bounds.height,
+				originX: "center",
+				originY: "center",
+				absolutePositioned: true
+			});
+			absoluteClip.set({
+				left: frame[4],
+				top: frame[5],
+				scaleX,
+				scaleY
+			});
+			object.clipPath = absoluteClip;
+		}
+	}
+	loose.forEach((object) => object.setCoords());
+	return {
+		objects: loose,
+		viewport,
+		warnings
+	};
+}
+//#endregion
+exports.readSvg = readSvg;

package/dist/import/svg-import.d.cts

@@ -0,0 +1,50 @@
+import { FabricObject } from "fabric";
+//#region src/import/svg-import.d.ts
+/**
+ * Opens SVG files as Fabric objects without moving them (fabric.js #10916).
+ *
+ * Fabric's parser already puts every element where the SVG's viewBox says.
+ * The usual next step, `util.groupSVGElements`, then sizes the group to the
+ * content, so an element outside the viewBox, or a hidden one, moves and
+ * resizes everything. This keeps the SVG's own viewport as the frame instead.
+ */
+export interface SvgImportOptions {
+  /**
+   * `preserve` (the default) keeps the SVG's viewport, so the artwork lands
+   * where it sits in the file. `content` uses the bounds of what is drawn,
+   * like `util.groupSVGElements`.
+   */
+  viewport?: "preserve" | "content";
+  /** What to do with elements entirely outside the viewport: keep them, drop them, or clip them. Default `keep`. */
+  offscreen?: "keep" | "drop" | "clip";
+  /** One group (the default), or separate objects. */
+  as?: "group" | "objects";
+  /** Where the viewport's top-left corner lands on the canvas. Default 0, 0. */
+  left?: number;
+  top?: number;
+  /** Scales the viewport into this box. `contain` keeps the whole SVG visible, `cover` fills the box, `fill` stretches. */
+  fit?: {
+    width: number;
+    height: number;
+    mode?: "contain" | "cover" | "fill";
+  };
+  /** Passed to images in the SVG. Default `anonymous`, so the canvas can still be exported. */
+  crossOrigin?: "anonymous" | "use-credentials" | null;
+  signal?: AbortSignal;
+}
+export type SvgImportWarningCode = "SVG_CONTENT_REMOVED" | "SVG_IMAGE_BLOCKED" | "SVG_OFFSCREEN_DROPPED";
+export interface SvgImportWarning {
+  code: SvgImportWarningCode;
+  message: string;
+}
+export interface SvgImportResult {
+  /** The objects added to the canvas: one group, or each object. */
+  objects: FabricObject[];
+  /** The size of the SVG's viewport in canvas units, before `fit`. */
+  viewport: {
+    width: number;
+    height: number;
+  };
+  warnings: SvgImportWarning[];
+}
+//#endregion

package/dist/import/svg-import.d.ts

@@ -0,0 +1,50 @@
+import { FabricObject } from "fabric";
+//#region src/import/svg-import.d.ts
+/**
+ * Opens SVG files as Fabric objects without moving them (fabric.js #10916).
+ *
+ * Fabric's parser already puts every element where the SVG's viewBox says.
+ * The usual next step, `util.groupSVGElements`, then sizes the group to the
+ * content, so an element outside the viewBox, or a hidden one, moves and
+ * resizes everything. This keeps the SVG's own viewport as the frame instead.
+ */
+export interface SvgImportOptions {
+  /**
+   * `preserve` (the default) keeps the SVG's viewport, so the artwork lands
+   * where it sits in the file. `content` uses the bounds of what is drawn,
+   * like `util.groupSVGElements`.
+   */
+  viewport?: "preserve" | "content";
+  /** What to do with elements entirely outside the viewport: keep them, drop them, or clip them. Default `keep`. */
+  offscreen?: "keep" | "drop" | "clip";
+  /** One group (the default), or separate objects. */
+  as?: "group" | "objects";
+  /** Where the viewport's top-left corner lands on the canvas. Default 0, 0. */
+  left?: number;
+  top?: number;
+  /** Scales the viewport into this box. `contain` keeps the whole SVG visible, `cover` fills the box, `fill` stretches. */
+  fit?: {
+    width: number;
+    height: number;
+    mode?: "contain" | "cover" | "fill";
+  };
+  /** Passed to images in the SVG. Default `anonymous`, so the canvas can still be exported. */
+  crossOrigin?: "anonymous" | "use-credentials" | null;
+  signal?: AbortSignal;
+}
+export type SvgImportWarningCode = "SVG_CONTENT_REMOVED" | "SVG_IMAGE_BLOCKED" | "SVG_OFFSCREEN_DROPPED";
+export interface SvgImportWarning {
+  code: SvgImportWarningCode;
+  message: string;
+}
+export interface SvgImportResult {
+  /** The objects added to the canvas: one group, or each object. */
+  objects: FabricObject[];
+  /** The size of the SVG's viewport in canvas units, before `fit`. */
+  viewport: {
+    width: number;
+    height: number;
+  };
+  warnings: SvgImportWarning[];
+}
+//#endregion

package/dist/import/svg-import.js

@@ -0,0 +1,256 @@
+import { DocumentEngineError, isDocumentEngineError } from "../engine/errors.js";
+import { isSafeImageUrl } from "../security/content-limits.js";
+import { FixedLayout, Group, LayoutManager, Rect, parseSVGDocument } from "fabric";
+//#region src/import/svg-import.ts
+const XLINK = "http://www.w3.org/1999/xlink";
+const REMOVED_ELEMENTS = [
+	"script",
+	"foreignObject",
+	"iframe",
+	"object",
+	"embed",
+	"audio",
+	"video",
+	"animate",
+	"set",
+	"animateTransform",
+	"animateMotion"
+];
+function refuse(message, cause) {
+	throw new DocumentEngineError("SVG_IMPORT_FAILED", message, cause === void 0 ? {} : { cause });
+}
+function unsafe(message) {
+	throw new DocumentEngineError("UNSAFE_DOCUMENT", `The SVG was refused: ${message}`, { issues: [{
+		code: "UNSAFE_DOCUMENT",
+		path: "",
+		message
+	}] });
+}
+function parse(svg) {
+	if (typeof DOMParser === "undefined") refuse("Importing SVG needs a browser DOM");
+	const document = new DOMParser().parseFromString(svg.trim(), "image/svg+xml");
+	const error = document.querySelector("parsererror");
+	if (error) refuse(`The SVG is not valid XML: ${(error.textContent ?? "").trim().slice(0, 200)}`);
+	if (document.documentElement.localName !== "svg") refuse("The file is not an SVG: its root element is not <svg>");
+	return document;
+}
+function depthOf(element) {
+	let deepest = 0;
+	const pending = [[element, 1]];
+	while (pending.length > 0) {
+		const [current, depth] = pending.pop();
+		deepest = Math.max(deepest, depth);
+		for (const child of Array.from(current.children)) pending.push([child, depth + 1]);
+	}
+	return deepest;
+}
+/**
+* Removes what an SVG can use to run code or reach other servers. Fabric
+* never runs scripts, but the same file may be shown elsewhere later.
+*/
+function sanitize(document, limits, warnings) {
+	const root = document.documentElement;
+	const elements = root.getElementsByTagName("*").length;
+	const maxObjects = limits.maxObjects ?? 5e4;
+	if (elements > maxObjects) unsafe(`it has ${elements} elements, the limit is ${maxObjects}`);
+	const maxDepth = limits.maxDepth ?? 100;
+	const depth = depthOf(root);
+	if (depth > maxDepth) unsafe(`it is nested ${depth} levels deep, the limit is ${maxDepth}`);
+	let removed = 0;
+	for (const name of REMOVED_ELEMENTS) for (const element of Array.from(root.getElementsByTagName(name))) {
+		element.remove();
+		removed += 1;
+	}
+	const isAllowed = limits.isAllowedUrl ?? isSafeImageUrl;
+	for (const element of [root, ...Array.from(root.getElementsByTagName("*"))]) {
+		for (const attribute of Array.from(element.attributes)) if (/^on/i.test(attribute.name)) {
+			element.removeAttribute(attribute.name);
+			removed += 1;
+		}
+		const link = element.getAttribute("href") ?? element.getAttributeNS(XLINK, "href");
+		if (link === null) continue;
+		const target = link.trim();
+		if (element.localName === "image") {
+			if (!isAllowed(target) || /^javascript:/i.test(target)) {
+				warnings.push({
+					code: "SVG_IMAGE_BLOCKED",
+					message: `An image with the address ${target.slice(0, 80)} was left out because the address is not allowed`
+				});
+				element.remove();
+			}
+		} else if (!target.startsWith("#")) {
+			element.removeAttribute("href");
+			element.removeAttributeNS(XLINK, "href");
+			removed += 1;
+		}
+	}
+	for (const style of Array.from(root.getElementsByTagName("style"))) {
+		const css = style.textContent ?? "";
+		const cleaned = css.replace(/@import[^;]*;?/gi, "").replace(/url\(\s*['"]?(?!#)[^)]*\)/gi, "none");
+		if (cleaned !== css) {
+			style.textContent = cleaned;
+			removed += 1;
+		}
+	}
+	if (removed > 0) warnings.push({
+		code: "SVG_CONTENT_REMOVED",
+		message: `${removed} scripts, event handlers, embedded pages or links to other files were removed from the SVG`
+	});
+}
+function intersectsViewport(object, width, height) {
+	object.setCoords();
+	const box = object.getBoundingRect();
+	return box.left < width && box.top < height && box.left + box.width > 0 && box.top + box.height > 0;
+}
+function contentBounds(objects) {
+	let left = Infinity;
+	let top = Infinity;
+	let right = -Infinity;
+	let bottom = -Infinity;
+	for (const object of objects) {
+		object.setCoords();
+		const box = object.getBoundingRect();
+		left = Math.min(left, box.left);
+		top = Math.min(top, box.top);
+		right = Math.max(right, box.left + box.width);
+		bottom = Math.max(bottom, box.top + box.height);
+	}
+	return Number.isFinite(left) ? {
+		left,
+		top,
+		width: right - left,
+		height: bottom - top
+	} : {
+		left: 0,
+		top: 0,
+		width: 0,
+		height: 0
+	};
+}
+/** Parses and places an SVG. Adding the result to a canvas is up to the caller. */
+async function readSvg(svg, options = {}, limits = {}) {
+	if (typeof svg !== "string" || svg.trim().length === 0) refuse("The SVG is empty");
+	const warnings = [];
+	const document = parse(svg);
+	sanitize(document, limits, warnings);
+	let parsed;
+	try {
+		parsed = await parseSVGDocument(document, void 0, {
+			crossOrigin: options.crossOrigin === void 0 ? "anonymous" : options.crossOrigin,
+			signal: options.signal
+		});
+	} catch (error) {
+		if (isDocumentEngineError(error)) throw error;
+		refuse(`Fabric could not read the SVG: ${error instanceof Error ? error.message : String(error)}`, error);
+	}
+	if (options.signal?.aborted) throw new DocumentEngineError("LOAD_ABORTED", "The SVG import was cancelled");
+	let objects = parsed.objects.filter((object) => object !== null && object !== void 0);
+	const declared = {
+		width: parsed.options.width ?? 0,
+		height: parsed.options.height ?? 0
+	};
+	const useContent = options.viewport === "content" || declared.width <= 0 || declared.height <= 0;
+	const bounds = useContent ? contentBounds(objects) : {
+		left: 0,
+		top: 0,
+		...declared
+	};
+	const offscreen = options.offscreen ?? "keep";
+	if (offscreen === "drop" && !useContent) {
+		const kept = objects.filter((object) => intersectsViewport(object, bounds.width, bounds.height));
+		if (kept.length < objects.length) warnings.push({
+			code: "SVG_OFFSCREEN_DROPPED",
+			message: `${objects.length - kept.length} elements outside the SVG's viewport were left out`
+		});
+		objects = kept;
+	}
+	const viewport = {
+		width: bounds.width,
+		height: bounds.height
+	};
+	if (objects.length === 0) return {
+		objects: [],
+		viewport,
+		warnings
+	};
+	const group = new Group([], {
+		layoutManager: new LayoutManager(new FixedLayout()),
+		width: bounds.width,
+		height: bounds.height,
+		left: bounds.left + bounds.width / 2,
+		top: bounds.top + bounds.height / 2,
+		originX: "center",
+		originY: "center"
+	});
+	group.add(...objects);
+	if (offscreen === "clip") group.clipPath = new Rect({
+		width: bounds.width,
+		height: bounds.height,
+		originX: "center",
+		originY: "center",
+		left: 0,
+		top: 0
+	});
+	let scaleX = 1;
+	let scaleY = 1;
+	let shiftX = 0;
+	let shiftY = 0;
+	const fit = options.fit;
+	if (fit && bounds.width > 0 && bounds.height > 0) {
+		const sx = fit.width / bounds.width;
+		const sy = fit.height / bounds.height;
+		const mode = fit.mode ?? "contain";
+		if (mode === "fill") {
+			scaleX = sx;
+			scaleY = sy;
+		} else {
+			scaleX = scaleY = mode === "cover" ? Math.max(sx, sy) : Math.min(sx, sy);
+			shiftX = (fit.width - bounds.width * scaleX) / 2;
+			shiftY = (fit.height - bounds.height * scaleY) / 2;
+		}
+	}
+	group.set({
+		scaleX,
+		scaleY,
+		originX: "left",
+		originY: "top",
+		left: (options.left ?? 0) + shiftX,
+		top: (options.top ?? 0) + shiftY
+	});
+	group.setCoords();
+	if ((options.as ?? "group") === "group") return {
+		objects: [group],
+		viewport,
+		warnings
+	};
+	const clip = group.clipPath;
+	group.clipPath = void 0;
+	const loose = group.removeAll();
+	if (clip) {
+		const frame = group.calcTransformMatrix();
+		for (const object of loose) {
+			const absoluteClip = new Rect({
+				width: bounds.width,
+				height: bounds.height,
+				originX: "center",
+				originY: "center",
+				absolutePositioned: true
+			});
+			absoluteClip.set({
+				left: frame[4],
+				top: frame[5],
+				scaleX,
+				scaleY
+			});
+			object.clipPath = absoluteClip;
+		}
+	}
+	loose.forEach((object) => object.setCoords());
+	return {
+		objects: loose,
+		viewport,
+		warnings
+	};
+}
+//#endregion
+export { readSvg };

package/dist/index.cjs

@@ -8,19 +8,31 @@ const require_create_document_engine = require("./engine/create-document-engine.
 const require_keyboard_shortcuts = require("./history/keyboard-shortcuts.cjs");
 const require_unsaved_changes_warning = require("./save/unsaved-changes-warning.cjs");
 const require_download_export = require("./export/download-export.cjs");
+const require_batch_render = require("./export/batch-render.cjs");
 const require_document_state_store = require("./state/document-state-store.cjs");
+const require_clipboard = require("./commands/clipboard.cjs");
+const require_layers = require("./commands/layers.cjs");
+exports.CLIPBOARD_FORMAT = require_clipboard.CLIPBOARD_FORMAT;
 exports.CURRENT_SCHEMA_VERSION = require_document_format.CURRENT_SCHEMA_VERSION;
 exports.DocumentEngineError = require_errors.DocumentEngineError;
 exports.bindKeyboardShortcuts = require_keyboard_shortcuts.bindKeyboardShortcuts;
 exports.bindUnsavedChangesWarning = require_unsaved_changes_warning.bindUnsavedChangesWarning;
+exports.bringForward = require_layers.bringForward;
+exports.bringToFront = require_layers.bringToFront;
+exports.createClipboard = require_clipboard.createClipboard;
 exports.createConflictError = require_errors.createConflictError;
 exports.createDocumentEngine = require_create_document_engine.createDocumentEngine;
 exports.createDocumentStateStore = require_document_state_store.createDocumentStateStore;
 exports.detectSchemaVersion = require_migrate_document.detectSchemaVersion;
 exports.downloadExport = require_download_export.downloadExport;
+exports.getLayers = require_layers.getLayers;
 exports.isDocumentEngineError = require_errors.isDocumentEngineError;
 exports.isSafeImageUrl = require_content_limits.isSafeImageUrl;
 exports.migrateDocument = require_migrate_document.migrateDocument;
+exports.moveToIndex = require_layers.moveToIndex;
 exports.refuseUnsafeImageUrls = require_content_limits.refuseUnsafeImageUrls;
+exports.renderDocuments = require_batch_render.renderDocuments;
 exports.secureDocument = require_content_limits.secureDocument;
+exports.sendBackward = require_layers.sendBackward;
+exports.sendToBack = require_layers.sendToBack;
 exports.validateDocument = require_validate_document.validateDocument;

package/dist/index.d.cts

@@ -1,13 +1,15 @@
 import { CURRENT_SCHEMA_VERSION, DocumentCanvas, DocumentInfo, FabricDocument, SerializedFabricObject } from "./document/document-format.cjs";
+import { ImageFailureReason, ImageLoadFailure } from "./assets/image-check.cjs";
 import { AssetManifest, FontAsset, ImageAsset } from "./assets/asset-manifest.cjs";
 import { FontLoader } from "./assets/font-check.cjs";
 import { AssetOptions, AssetReport, AssetWarning, AssetWarningCode, UploadRequest } from "./assets/asset-pipeline.cjs";
-import { ExportArea, ExportBackground, ExportFormat, ExportOptions, ExportRect } from "./export/export-options.cjs";
+import { ExportArea, ExportBackground, ExportFormat, ExportOptions, ExportRect, FontSource, SvgExportOptions } from "./export/export-options.cjs";
 import { ExportPreflight, ExportProblem, ExportProblemCode } from "./export/preflight-export.cjs";
+import { ContentLimits, isSafeImageUrl, refuseUnsafeImageUrls, secureDocument } from "./security/content-limits.cjs";
+import { SvgImportOptions, SvgImportResult, SvgImportWarning, SvgImportWarningCode } from "./import/svg-import.cjs";
 import { NewDocumentOptions } from "./document/create-document.cjs";
 import { CustomObjectDefinition } from "./fabric/object-registry.cjs";
 import { HistoryOptions, HistoryState } from "./history/create-history.cjs";
-import { ContentLimits, isSafeImageUrl, refuseUnsafeImageUrls, secureDocument } from "./security/content-limits.cjs";
 import { DocumentVersion, VersionKind, VersionOptions, VersionStorage, VersionSummary } from "./versions/document-version.cjs";
 import { RecoveryStore } from "./recovery/recovery-store.cjs";
 import { InterruptedLoad, RecoveryOptions, RecoveryRecord } from "./recovery/recovery-controller.cjs";
@@ -17,11 +19,14 @@ import { DocumentEngineError, DocumentEngineErrorDetails, DocumentErrorCode, Doc
 import { DocumentStorage, SaveContext, SaveResult } from "./storage/storage-contract.cjs";
 import { SaveOptions, SaveRetryEvent, SaveState, SaveStatus } from "./save/save-controller.cjs";
 import { Unsubscribe } from "./engine/event-emitter.cjs";
-import { DocumentEngine, DocumentEngineEvents, DocumentEngineOptions, ExportResult, ImportOptions, LoadOptions, NewDocumentRequest, createDocumentEngine } from "./engine/create-document-engine.cjs";
+import { DocumentEngine, DocumentEngineEvents, DocumentEngineOptions, ExportResult, ImportOptions, LoadOptions, LoadProgress, LoadStage, NewDocumentRequest, createDocumentEngine } from "./engine/create-document-engine.cjs";
 import { validateDocument } from "./document/validate-document.cjs";
 import { KeyboardShortcutOptions, UndoRedoTarget, bindKeyboardShortcuts } from "./history/keyboard-shortcuts.cjs";
 import { UnsavedChangesSource, bindUnsavedChangesWarning } from "./save/unsaved-changes-warning.cjs";
 import { DownloadableExport, downloadExport } from "./export/download-export.cjs";
+import { RenderDocumentsOptions, RenderedDocument, renderDocuments } from "./export/batch-render.cjs";
 import { Migration, MigrationContext, MigrationResult, detectSchemaVersion, migrateDocument } from "./migrations/migrate-document.cjs";
 import { DocumentState, DocumentStateStore, createDocumentStateStore } from "./state/document-state-store.cjs";
-export { type AssetManifest, type AssetOptions, type AssetReport, type AssetWarning, type AssetWarningCode, type AutosaveOptions, CURRENT_SCHEMA_VERSION, type ContentLimits, type CustomObjectDefinition, type DocumentCanvas, type DocumentEngine, DocumentEngineError, type DocumentEngineErrorDetails, type DocumentEngineEvents, type DocumentEngineOptions, type DocumentErrorCode, type DocumentInfo, type DocumentIssue, type DocumentState, type DocumentStateStore, type DocumentStorage, type DocumentVersion, type DownloadableExport, type ExportArea, type ExportBackground, type ExportFormat, type ExportOptions, type ExportPreflight, type ExportProblem, type ExportProblemCode, type ExportRect, type ExportResult, type FabricDocument, type FontAsset, type FontLoader, type HistoryOptions, type HistoryState, type ImageAsset, type ImportOptions, type InterruptedLoad, type KeyboardShortcutOptions, type LoadOptions, type Migration, type MigrationContext, type MigrationResult, type NewDocumentOptions, type NewDocumentRequest, type RecoveryOptions, type RecoveryRecord, type RecoveryStore, type RetryOptions, type SaveContext, type SaveOptions, type SaveResult, type SaveRetryEvent, type SaveState, type SaveStatus, type SerializedFabricObject, type UndoRedoTarget, type UnsavedChangesSource, type Unsubscribe, type UploadRequest, type VersionKind, type VersionOptions, type VersionStorage, type VersionSummary, bindKeyboardShortcuts, bindUnsavedChangesWarning, createConflictError, createDocumentEngine, createDocumentStateStore, detectSchemaVersion, downloadExport, isDocumentEngineError, isSafeImageUrl, migrateDocument, refuseUnsafeImageUrls, secureDocument, validateDocument };
+import { CLIPBOARD_FORMAT, Clipboard, ClipboardContent, ClipboardOptions, PasteOptions, createClipboard } from "./commands/clipboard.cjs";
+import { LayerInfo, LayerOptions, LayerPin, bringForward, bringToFront, getLayers, moveToIndex, sendBackward, sendToBack } from "./commands/layers.cjs";
+export { type AssetManifest, type AssetOptions, type AssetReport, type AssetWarning, type AssetWarningCode, type AutosaveOptions, CLIPBOARD_FORMAT, CURRENT_SCHEMA_VERSION, type Clipboard, type ClipboardContent, type ClipboardOptions, type ContentLimits, type CustomObjectDefinition, type DocumentCanvas, type DocumentEngine, DocumentEngineError, type DocumentEngineErrorDetails, type DocumentEngineEvents, type DocumentEngineOptions, type DocumentErrorCode, type DocumentInfo, type DocumentIssue, type DocumentState, type DocumentStateStore, type DocumentStorage, type DocumentVersion, type DownloadableExport, type ExportArea, type ExportBackground, type ExportFormat, type ExportOptions, type ExportPreflight, type ExportProblem, type ExportProblemCode, type ExportRect, type ExportResult, type FabricDocument, type FontAsset, type FontLoader, type FontSource, type HistoryOptions, type HistoryState, type ImageAsset, type ImageFailureReason, type ImageLoadFailure, type ImportOptions, type InterruptedLoad, type KeyboardShortcutOptions, type LayerInfo, type LayerOptions, type LayerPin, type LoadOptions, type LoadProgress, type LoadStage, type Migration, type MigrationContext, type MigrationResult, type NewDocumentOptions, type NewDocumentRequest, type PasteOptions, type RecoveryOptions, type RecoveryRecord, type RecoveryStore, type RenderDocumentsOptions, type RenderedDocument, type RetryOptions, type SaveContext, type SaveOptions, type SaveResult, type SaveRetryEvent, type SaveState, type SaveStatus, type SerializedFabricObject, type SvgExportOptions, type SvgImportOptions, type SvgImportResult, type SvgImportWarning, type SvgImportWarningCode, type UndoRedoTarget, type UnsavedChangesSource, type Unsubscribe, type UploadRequest, type VersionKind, type VersionOptions, type VersionStorage, type VersionSummary, bindKeyboardShortcuts, bindUnsavedChangesWarning, bringForward, bringToFront, createClipboard, createConflictError, createDocumentEngine, createDocumentStateStore, detectSchemaVersion, downloadExport, getLayers, isDocumentEngineError, isSafeImageUrl, migrateDocument, moveToIndex, refuseUnsafeImageUrls, renderDocuments, secureDocument, sendBackward, sendToBack, validateDocument };