@openfairygui/functions 0.2.0-alpha.19 → 0.2.0-alpha.20

package/dist/node.cjs

@@ -1,11 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_publish = require("./publish-D7268_u4.cjs");
+const require_publish = require("./publish-xFWT9Slz.cjs");
+const require_restore = require("./restore-BW2xacB3.cjs");
 //#region src/adapters/node/plugins.ts
-const importNative$1 = new Function("id", "return import(id)");
+const importNative$2 = new Function("id", "return import(id)");
 async function loadPlugins(doc, pluginsDir) {
 	if (!pluginsDir) return [];
-	const fs = await importNative$1("node:fs/promises");
-	const path = await importNative$1("node:path");
+	const fs = await importNative$2("node:fs/promises");
+	const path = await importNative$2("node:path");
 	let entries;
 	try {
 		entries = await fs.readdir(pluginsDir, { withFileTypes: true });
@@ -45,7 +46,7 @@ function resolvePluginMain(path, pluginDir, manifest) {
 	return mainPath;
 }
 async function loadPlugin(mainPath) {
-	const { createJiti } = await importNative$1("jiti");
+	const { createJiti } = await importNative$2("jiti");
 	const mod = await createJiti(require("url").pathToFileURL(__filename).href).import(mainPath);
 	const defaultExport = mod.default;
 	return isObject(defaultExport) ? defaultExport : mod;
@@ -55,9 +56,9 @@ function isObject(value) {
 }
 //#endregion
 //#region src/adapters/node/publish.ts
-const importNative = new Function("id", "return import(id)");
+const importNative$1 = new Function("id", "return import(id)");
 async function createNodePublishFileSystem() {
-	const [fs, path] = await Promise.all([importNative("node:fs/promises"), importNative("node:path")]);
+	const [fs, path] = await Promise.all([importNative$1("node:fs/promises"), importNative$1("node:path")]);
 	return {
 		async readFileRaw(filePath) {
 			const data = await fs.readFile(filePath);
@@ -85,11 +86,11 @@ async function resolveNodeAssetsPath(document, assetsPath) {
 	if (assetsPath) return assetsPath;
 	const projectDir = document.getProjectDir?.() ?? "";
 	if (!projectDir) return void 0;
-	return (await importNative("node:path")).join(projectDir, "assets");
+	return (await importNative$1("node:path")).join(projectDir, "assets");
 }
 async function loadSharpBackend() {
 	try {
-		const loaded = await importNative("sharp");
+		const loaded = await importNative$1("sharp");
 		return loaded.default ?? loaded;
 	} catch {
 		return;
@@ -98,7 +99,7 @@ async function loadSharpBackend() {
 async function loadNodePublishPlugins(document, assetsPath) {
 	const projectDir = document.getProjectDir?.() || (assetsPath ? require_publish.resolveProjectBasePath(assetsPath) : "");
 	if (!projectDir) return [];
-	return loadPlugins(document, (await importNative("node:path")).join(projectDir, "plugins"));
+	return loadPlugins(document, (await importNative$1("node:path")).join(projectDir, "plugins"));
 }
 /**
 * Publish a FairyGUI project through the standard Node host adapter.
@@ -125,4 +126,131 @@ async function publishNode(options) {
 	}));
 }
 //#endregion
+//#region src/adapters/node/restore.ts
+const importNative = new Function("id", "return import(id)");
+async function createNodeRestoreFileSystem() {
+	const [fs, path] = await Promise.all([importNative("node:fs/promises"), importNative("node:path")]);
+	return {
+		async readFile(filePath) {
+			return fs.readFile(filePath, "utf-8");
+		},
+		async readFileRaw(filePath) {
+			const buffer = await fs.readFile(filePath);
+			return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+		},
+		async writeFile(filePath, content) {
+			await fs.mkdir(path.dirname(filePath), { recursive: true });
+			await fs.writeFile(filePath, content, "utf-8");
+		},
+		async writeFileRaw(filePath, data) {
+			await fs.mkdir(path.dirname(filePath), { recursive: true });
+			await fs.writeFile(filePath, data);
+		},
+		async mkdir(dirPath) {
+			await fs.mkdir(dirPath, { recursive: true });
+		},
+		async readdir(dirPath) {
+			return fs.readdir(dirPath);
+		},
+		async exists(filePath) {
+			try {
+				await fs.access(filePath);
+				return true;
+			} catch {
+				return false;
+			}
+		},
+		async isFile(filePath) {
+			try {
+				return (await fs.stat(filePath)).isFile();
+			} catch {
+				return false;
+			}
+		},
+		async resolvePath(filePath) {
+			try {
+				return await fs.realpath(filePath);
+			} catch {
+				return path.resolve(filePath);
+			}
+		},
+		async rm(targetPath, options) {
+			await fs.rm(targetPath, {
+				recursive: options?.recursive ?? false,
+				force: options?.force ?? false
+			});
+		},
+		async rename(from, to) {
+			await fs.rename(from, to);
+		},
+		join(...paths) {
+			return path.join(...paths);
+		},
+		dirname(filePath) {
+			return path.dirname(filePath);
+		}
+	};
+}
+async function createRestoreImageProcessors() {
+	let sharp;
+	try {
+		const loaded = await importNative("sharp");
+		sharp = loaded.default ?? loaded;
+	} catch {
+		throw new Error("restoreNode: Sharp is required to crop atlas images. Install sharp before restoring.");
+	}
+	async function extractImage(input) {
+		const targetPath = input.outputPath ?? input.sourcePath;
+		let image = sharp(input.sourcePath).extract({
+			left: input.left,
+			top: input.top,
+			width: input.width,
+			height: input.height
+		});
+		if (input.rotated) image = image.rotate(90);
+		const { data, info } = await image.png().toBuffer({ resolveWithObject: true });
+		if (input.expectedWidth > 0 && input.expectedHeight > 0 && (input.offsetX !== 0 || input.offsetY !== 0 || info.width !== input.expectedWidth || info.height !== input.expectedHeight)) {
+			if (input.offsetX < 0 || input.offsetY < 0 || input.offsetX + info.width > input.expectedWidth || input.offsetY + info.height > input.expectedHeight) throw new Error(`restore: Cropped image does not fit original canvas for ${targetPath}: crop ${info.width}x${info.height} at ${input.offsetX},${input.offsetY}, canvas ${input.expectedWidth}x${input.expectedHeight}`);
+			const composed = await sharp({ create: {
+				width: input.expectedWidth,
+				height: input.expectedHeight,
+				channels: 4,
+				background: {
+					r: 0,
+					g: 0,
+					b: 0,
+					alpha: 0
+				}
+			} }).composite([{
+				input: data,
+				left: input.offsetX,
+				top: input.offsetY
+			}]).png().toBuffer({ resolveWithObject: true });
+			if (composed.info.width !== input.expectedWidth || composed.info.height !== input.expectedHeight) throw new Error(`restore: Cropped image size mismatch for ${targetPath}: expected ${input.expectedWidth}x${input.expectedHeight}, got ${composed.info.width}x${composed.info.height}`);
+			return composed.data;
+		}
+		if (input.expectedWidth > 0 && input.expectedHeight > 0 && (info.width !== input.expectedWidth || info.height !== input.expectedHeight)) throw new Error(`restore: Cropped image size mismatch for ${targetPath}: expected ${input.expectedWidth}x${input.expectedHeight}, got ${info.width}x${info.height}`);
+		return data;
+	}
+	const fs = await importNative("node:fs/promises");
+	const path = await importNative("node:path");
+	return {
+		extractImage,
+		cropImage: async (input) => {
+			await fs.mkdir(path.dirname(input.outputPath), { recursive: true });
+			await fs.writeFile(input.outputPath, await extractImage(input));
+		}
+	};
+}
+/** Restore trusted local published artifacts through the standard Node host adapter. */
+async function restoreNode(options) {
+	const [fs, imageProcessors] = await Promise.all([createNodeRestoreFileSystem(), createRestoreImageProcessors()]);
+	return require_restore.restore({
+		...options,
+		fs,
+		...imageProcessors
+	});
+}
+//#endregion
 exports.publishNode = publishNode;
+exports.restoreNode = restoreNode;

package/dist/node.d.cts

@@ -1,5 +1,5 @@
 import { r as AtlasRasterBackend } from "./atlas-CHsu2Y8i.cjs";
-import { O as PublishOptions, m as LoadedPlugin } from "./codegen-B8ZM1F4j.cjs";
+import { L as PublishOptions, S as LoadedPlugin, o as RestoreOptions, s as RestoreResult } from "./restore-BeWaJNjR.cjs";
 import { Document } from "@openfairygui/core";
 
 //#region src/adapters/node/publish.d.ts
@@ -28,4 +28,9 @@ interface PublishNodeOptions extends Omit<PublishOptions, 'atlas' | 'basePath' |
  */
 declare function publishNode(options: PublishNodeOptions): Promise<void>;
 //#endregion
-export { type PublishNodeOptions, publishNode };
+//#region src/adapters/node/restore.d.ts
+interface RestoreNodeOptions extends Omit<RestoreOptions, 'fs' | 'cropImage' | 'extractImage'> {}
+/** Restore trusted local published artifacts through the standard Node host adapter. */
+declare function restoreNode(options: RestoreNodeOptions): Promise<RestoreResult>;
+//#endregion
+export { type PublishNodeOptions, type RestoreNodeOptions, publishNode, restoreNode };

package/dist/node.d.ts

@@ -1,5 +1,5 @@
-import { r as AtlasRasterBackend } from "./atlas-CDn6TirX.js";
-import { O as PublishOptions, m as LoadedPlugin } from "./codegen-CfbDHuFt.js";
+import { r as AtlasRasterBackend } from "./atlas-C6tbl7nn.js";
+import { L as PublishOptions, S as LoadedPlugin, o as RestoreOptions, s as RestoreResult } from "./restore-Dh0-Nvms.js";
 import { Document } from "@openfairygui/core";
 
 //#region src/adapters/node/publish.d.ts
@@ -28,4 +28,9 @@ interface PublishNodeOptions extends Omit<PublishOptions, 'atlas' | 'basePath' |
  */
 declare function publishNode(options: PublishNodeOptions): Promise<void>;
 //#endregion
-export { type PublishNodeOptions, publishNode };
+//#region src/adapters/node/restore.d.ts
+interface RestoreNodeOptions extends Omit<RestoreOptions, 'fs' | 'cropImage' | 'extractImage'> {}
+/** Restore trusted local published artifacts through the standard Node host adapter. */
+declare function restoreNode(options: RestoreNodeOptions): Promise<RestoreResult>;
+//#endregion
+export { type PublishNodeOptions, type RestoreNodeOptions, publishNode, restoreNode };

package/dist/node.js

@@ -1,10 +1,11 @@
-import { l as resolveProjectBasePath, t as publish, u as formatPluginError } from "./publish-DsPK0SJ1.js";
+import { l as resolveProjectBasePath, t as publish, u as formatPluginError } from "./publish-BJ_eelME.js";
+import { t as restore } from "./restore-Clk62n0O.js";
 //#region src/adapters/node/plugins.ts
-const importNative$1 = new Function("id", "return import(id)");
+const importNative$2 = new Function("id", "return import(id)");
 async function loadPlugins(doc, pluginsDir) {
 	if (!pluginsDir) return [];
-	const fs = await importNative$1("node:fs/promises");
-	const path = await importNative$1("node:path");
+	const fs = await importNative$2("node:fs/promises");
+	const path = await importNative$2("node:path");
 	let entries;
 	try {
 		entries = await fs.readdir(pluginsDir, { withFileTypes: true });
@@ -44,7 +45,7 @@ function resolvePluginMain(path, pluginDir, manifest) {
 	return mainPath;
 }
 async function loadPlugin(mainPath) {
-	const { createJiti } = await importNative$1("jiti");
+	const { createJiti } = await importNative$2("jiti");
 	const mod = await createJiti(import.meta.url).import(mainPath);
 	const defaultExport = mod.default;
 	return isObject(defaultExport) ? defaultExport : mod;
@@ -54,9 +55,9 @@ function isObject(value) {
 }
 //#endregion
 //#region src/adapters/node/publish.ts
-const importNative = new Function("id", "return import(id)");
+const importNative$1 = new Function("id", "return import(id)");
 async function createNodePublishFileSystem() {
-	const [fs, path] = await Promise.all([importNative("node:fs/promises"), importNative("node:path")]);
+	const [fs, path] = await Promise.all([importNative$1("node:fs/promises"), importNative$1("node:path")]);
 	return {
 		async readFileRaw(filePath) {
 			const data = await fs.readFile(filePath);
@@ -84,11 +85,11 @@ async function resolveNodeAssetsPath(document, assetsPath) {
 	if (assetsPath) return assetsPath;
 	const projectDir = document.getProjectDir?.() ?? "";
 	if (!projectDir) return void 0;
-	return (await importNative("node:path")).join(projectDir, "assets");
+	return (await importNative$1("node:path")).join(projectDir, "assets");
 }
 async function loadSharpBackend() {
 	try {
-		const loaded = await importNative("sharp");
+		const loaded = await importNative$1("sharp");
 		return loaded.default ?? loaded;
 	} catch {
 		return;
@@ -97,7 +98,7 @@ async function loadSharpBackend() {
 async function loadNodePublishPlugins(document, assetsPath) {
 	const projectDir = document.getProjectDir?.() || (assetsPath ? resolveProjectBasePath(assetsPath) : "");
 	if (!projectDir) return [];
-	return loadPlugins(document, (await importNative("node:path")).join(projectDir, "plugins"));
+	return loadPlugins(document, (await importNative$1("node:path")).join(projectDir, "plugins"));
 }
 /**
 * Publish a FairyGUI project through the standard Node host adapter.
@@ -124,4 +125,130 @@ async function publishNode(options) {
 	}));
 }
 //#endregion
-export { publishNode };
+//#region src/adapters/node/restore.ts
+const importNative = new Function("id", "return import(id)");
+async function createNodeRestoreFileSystem() {
+	const [fs, path] = await Promise.all([importNative("node:fs/promises"), importNative("node:path")]);
+	return {
+		async readFile(filePath) {
+			return fs.readFile(filePath, "utf-8");
+		},
+		async readFileRaw(filePath) {
+			const buffer = await fs.readFile(filePath);
+			return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+		},
+		async writeFile(filePath, content) {
+			await fs.mkdir(path.dirname(filePath), { recursive: true });
+			await fs.writeFile(filePath, content, "utf-8");
+		},
+		async writeFileRaw(filePath, data) {
+			await fs.mkdir(path.dirname(filePath), { recursive: true });
+			await fs.writeFile(filePath, data);
+		},
+		async mkdir(dirPath) {
+			await fs.mkdir(dirPath, { recursive: true });
+		},
+		async readdir(dirPath) {
+			return fs.readdir(dirPath);
+		},
+		async exists(filePath) {
+			try {
+				await fs.access(filePath);
+				return true;
+			} catch {
+				return false;
+			}
+		},
+		async isFile(filePath) {
+			try {
+				return (await fs.stat(filePath)).isFile();
+			} catch {
+				return false;
+			}
+		},
+		async resolvePath(filePath) {
+			try {
+				return await fs.realpath(filePath);
+			} catch {
+				return path.resolve(filePath);
+			}
+		},
+		async rm(targetPath, options) {
+			await fs.rm(targetPath, {
+				recursive: options?.recursive ?? false,
+				force: options?.force ?? false
+			});
+		},
+		async rename(from, to) {
+			await fs.rename(from, to);
+		},
+		join(...paths) {
+			return path.join(...paths);
+		},
+		dirname(filePath) {
+			return path.dirname(filePath);
+		}
+	};
+}
+async function createRestoreImageProcessors() {
+	let sharp;
+	try {
+		const loaded = await importNative("sharp");
+		sharp = loaded.default ?? loaded;
+	} catch {
+		throw new Error("restoreNode: Sharp is required to crop atlas images. Install sharp before restoring.");
+	}
+	async function extractImage(input) {
+		const targetPath = input.outputPath ?? input.sourcePath;
+		let image = sharp(input.sourcePath).extract({
+			left: input.left,
+			top: input.top,
+			width: input.width,
+			height: input.height
+		});
+		if (input.rotated) image = image.rotate(90);
+		const { data, info } = await image.png().toBuffer({ resolveWithObject: true });
+		if (input.expectedWidth > 0 && input.expectedHeight > 0 && (input.offsetX !== 0 || input.offsetY !== 0 || info.width !== input.expectedWidth || info.height !== input.expectedHeight)) {
+			if (input.offsetX < 0 || input.offsetY < 0 || input.offsetX + info.width > input.expectedWidth || input.offsetY + info.height > input.expectedHeight) throw new Error(`restore: Cropped image does not fit original canvas for ${targetPath}: crop ${info.width}x${info.height} at ${input.offsetX},${input.offsetY}, canvas ${input.expectedWidth}x${input.expectedHeight}`);
+			const composed = await sharp({ create: {
+				width: input.expectedWidth,
+				height: input.expectedHeight,
+				channels: 4,
+				background: {
+					r: 0,
+					g: 0,
+					b: 0,
+					alpha: 0
+				}
+			} }).composite([{
+				input: data,
+				left: input.offsetX,
+				top: input.offsetY
+			}]).png().toBuffer({ resolveWithObject: true });
+			if (composed.info.width !== input.expectedWidth || composed.info.height !== input.expectedHeight) throw new Error(`restore: Cropped image size mismatch for ${targetPath}: expected ${input.expectedWidth}x${input.expectedHeight}, got ${composed.info.width}x${composed.info.height}`);
+			return composed.data;
+		}
+		if (input.expectedWidth > 0 && input.expectedHeight > 0 && (info.width !== input.expectedWidth || info.height !== input.expectedHeight)) throw new Error(`restore: Cropped image size mismatch for ${targetPath}: expected ${input.expectedWidth}x${input.expectedHeight}, got ${info.width}x${info.height}`);
+		return data;
+	}
+	const fs = await importNative("node:fs/promises");
+	const path = await importNative("node:path");
+	return {
+		extractImage,
+		cropImage: async (input) => {
+			await fs.mkdir(path.dirname(input.outputPath), { recursive: true });
+			await fs.writeFile(input.outputPath, await extractImage(input));
+		}
+	};
+}
+/** Restore trusted local published artifacts through the standard Node host adapter. */
+async function restoreNode(options) {
+	const [fs, imageProcessors] = await Promise.all([createNodeRestoreFileSystem(), createRestoreImageProcessors()]);
+	return restore({
+		...options,
+		fs,
+		...imageProcessors
+	});
+}
+//#endregion
+export { publishNode, restoreNode };