@openfairygui/functions 0.2.0-alpha.2 → 0.2.0-alpha.21

package/dist/node.cjs

@@ -0,0 +1,256 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_publish = require("./publish-xFWT9Slz.cjs");
+const require_restore = require("./restore-BW2xacB3.cjs");
+//#region src/adapters/node/plugins.ts
+const importNative$2 = new Function("id", "return import(id)");
+async function loadPlugins(doc, pluginsDir) {
+	if (!pluginsDir) return [];
+	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 });
+	} catch {
+		return [];
+	}
+	const plugins = [];
+	for (const entry of entries) {
+		if (!entry.isDirectory()) continue;
+		const pluginDir = path.join(pluginsDir, entry.name);
+		try {
+			const manifest = await readPluginManifest(fs, path, pluginDir);
+			if (!manifest) continue;
+			const plugin = await loadPlugin(resolvePluginMain(path, pluginDir, manifest));
+			plugins.push({
+				name: manifest.name,
+				plugin
+			});
+		} catch (error) {
+			doc.getLogger().warn(`publish: Plugin "${entry.name}" was skipped: ${require_publish.formatPluginError(error)}`);
+		}
+	}
+	return plugins;
+}
+async function readPluginManifest(fs, path, pluginDir) {
+	const manifestPath = path.join(pluginDir, "package.json");
+	const content = await fs.readFile(manifestPath, "utf-8");
+	const manifest = JSON.parse(content);
+	if (!manifest.name) throw new Error(`Codegen plugin at ${pluginDir} is missing package.json name.`);
+	if (!manifest.main) throw new Error(`Codegen plugin "${manifest.name}" is missing package.json main.`);
+	return manifest;
+}
+function resolvePluginMain(path, pluginDir, manifest) {
+	const mainPath = path.resolve(pluginDir, manifest.main);
+	const relative = path.relative(pluginDir, mainPath);
+	if (relative.startsWith("..") || path.isAbsolute(relative)) throw new Error(`Codegen plugin "${manifest.name}" main must resolve inside its plugin directory.`);
+	return mainPath;
+}
+async function loadPlugin(mainPath) {
+	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;
+}
+function isObject(value) {
+	return value !== null && typeof value === "object";
+}
+//#endregion
+//#region src/adapters/node/publish.ts
+const importNative$1 = new Function("id", "return import(id)");
+async function createNodePublishFileSystem() {
+	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);
+			return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+		},
+		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 deleteFile(filePath) {
+			await fs.rm(filePath, { force: true });
+		},
+		join(...paths) {
+			return path.join(...paths);
+		}
+	};
+}
+async function resolveNodeAssetsPath(document, assetsPath) {
+	if (assetsPath) return assetsPath;
+	const projectDir = document.getProjectDir?.() ?? "";
+	if (!projectDir) return void 0;
+	return (await importNative$1("node:path")).join(projectDir, "assets");
+}
+async function loadSharpBackend() {
+	try {
+		const loaded = await importNative$1("sharp");
+		return loaded.default ?? loaded;
+	} catch {
+		return;
+	}
+}
+async function loadNodePublishPlugins(document, assetsPath) {
+	const projectDir = document.getProjectDir?.() || (assetsPath ? require_publish.resolveProjectBasePath(assetsPath) : "");
+	if (!projectDir) return [];
+	return loadPlugins(document, (await importNative$1("node:path")).join(projectDir, "plugins"));
+}
+/**
+* Publish a FairyGUI project through the standard Node host adapter.
+*
+* The adapter owns Node filesystem, Sharp, and project plugin discovery.
+* For custom environments, use the lower-level `publish()` core with explicit
+* capabilities instead.
+*/
+async function publishNode(options) {
+	const { document, assetsPath: configuredAssetsPath, atlas, encoder: configuredEncoder, plugins: configuredPlugins, ...publishOptions } = options;
+	const [fileSystem, assetsPath] = await Promise.all([createNodePublishFileSystem(), resolveNodeAssetsPath(document, configuredAssetsPath)]);
+	const [encoder, plugins] = await Promise.all([configuredEncoder === void 0 ? loadSharpBackend() : Promise.resolve(configuredEncoder), configuredPlugins === void 0 ? loadNodePublishPlugins(document, assetsPath) : Promise.resolve(configuredPlugins)]);
+	if (!encoder) throw new Error("publishNode: Sharp is required for a complete publish. Install sharp or provide an encoder.");
+	await document.transform(require_publish.publish({
+		...publishOptions,
+		basePath: assetsPath,
+		encoder,
+		atlas: {
+			...atlas,
+			readFileRaw: fileSystem.readFileRaw
+		},
+		fs: fileSystem,
+		plugins
+	}));
+}
+//#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

@@ -0,0 +1,36 @@
+import { r as AtlasRasterBackend } from "./atlas-CHsu2Y8i.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
+interface PublishNodeOptions extends Omit<PublishOptions, 'atlas' | 'basePath' | 'encoder' | 'fs' | 'plugins'> {
+  document: Document;
+  /**
+   * Assets directory. Defaults to `<document project dir>/assets` when available.
+   */
+  assetsPath?: string;
+  /**
+   * Override the standard Sharp raster backend.
+   */
+  encoder?: AtlasRasterBackend;
+  /**
+   * Supply already-loaded hooks. Pass an empty array to skip project plugin discovery.
+   */
+  plugins?: LoadedPlugin[];
+  atlas?: Omit<NonNullable<PublishOptions['atlas']>, 'readFileRaw'>;
+}
+/**
+ * Publish a FairyGUI project through the standard Node host adapter.
+ *
+ * The adapter owns Node filesystem, Sharp, and project plugin discovery.
+ * For custom environments, use the lower-level `publish()` core with explicit
+ * capabilities instead.
+ */
+declare function publishNode(options: PublishNodeOptions): Promise<void>;
+//#endregion
+//#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

@@ -0,0 +1,36 @@
+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
+interface PublishNodeOptions extends Omit<PublishOptions, 'atlas' | 'basePath' | 'encoder' | 'fs' | 'plugins'> {
+  document: Document;
+  /**
+   * Assets directory. Defaults to `<document project dir>/assets` when available.
+   */
+  assetsPath?: string;
+  /**
+   * Override the standard Sharp raster backend.
+   */
+  encoder?: AtlasRasterBackend;
+  /**
+   * Supply already-loaded hooks. Pass an empty array to skip project plugin discovery.
+   */
+  plugins?: LoadedPlugin[];
+  atlas?: Omit<NonNullable<PublishOptions['atlas']>, 'readFileRaw'>;
+}
+/**
+ * Publish a FairyGUI project through the standard Node host adapter.
+ *
+ * The adapter owns Node filesystem, Sharp, and project plugin discovery.
+ * For custom environments, use the lower-level `publish()` core with explicit
+ * capabilities instead.
+ */
+declare function publishNode(options: PublishNodeOptions): Promise<void>;
+//#endregion
+//#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

@@ -0,0 +1,254 @@
+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$2 = new Function("id", "return import(id)");
+async function loadPlugins(doc, pluginsDir) {
+	if (!pluginsDir) return [];
+	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 });
+	} catch {
+		return [];
+	}
+	const plugins = [];
+	for (const entry of entries) {
+		if (!entry.isDirectory()) continue;
+		const pluginDir = path.join(pluginsDir, entry.name);
+		try {
+			const manifest = await readPluginManifest(fs, path, pluginDir);
+			if (!manifest) continue;
+			const plugin = await loadPlugin(resolvePluginMain(path, pluginDir, manifest));
+			plugins.push({
+				name: manifest.name,
+				plugin
+			});
+		} catch (error) {
+			doc.getLogger().warn(`publish: Plugin "${entry.name}" was skipped: ${formatPluginError(error)}`);
+		}
+	}
+	return plugins;
+}
+async function readPluginManifest(fs, path, pluginDir) {
+	const manifestPath = path.join(pluginDir, "package.json");
+	const content = await fs.readFile(manifestPath, "utf-8");
+	const manifest = JSON.parse(content);
+	if (!manifest.name) throw new Error(`Codegen plugin at ${pluginDir} is missing package.json name.`);
+	if (!manifest.main) throw new Error(`Codegen plugin "${manifest.name}" is missing package.json main.`);
+	return manifest;
+}
+function resolvePluginMain(path, pluginDir, manifest) {
+	const mainPath = path.resolve(pluginDir, manifest.main);
+	const relative = path.relative(pluginDir, mainPath);
+	if (relative.startsWith("..") || path.isAbsolute(relative)) throw new Error(`Codegen plugin "${manifest.name}" main must resolve inside its plugin directory.`);
+	return mainPath;
+}
+async function loadPlugin(mainPath) {
+	const { createJiti } = await importNative$2("jiti");
+	const mod = await createJiti(import.meta.url).import(mainPath);
+	const defaultExport = mod.default;
+	return isObject(defaultExport) ? defaultExport : mod;
+}
+function isObject(value) {
+	return value !== null && typeof value === "object";
+}
+//#endregion
+//#region src/adapters/node/publish.ts
+const importNative$1 = new Function("id", "return import(id)");
+async function createNodePublishFileSystem() {
+	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);
+			return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+		},
+		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 deleteFile(filePath) {
+			await fs.rm(filePath, { force: true });
+		},
+		join(...paths) {
+			return path.join(...paths);
+		}
+	};
+}
+async function resolveNodeAssetsPath(document, assetsPath) {
+	if (assetsPath) return assetsPath;
+	const projectDir = document.getProjectDir?.() ?? "";
+	if (!projectDir) return void 0;
+	return (await importNative$1("node:path")).join(projectDir, "assets");
+}
+async function loadSharpBackend() {
+	try {
+		const loaded = await importNative$1("sharp");
+		return loaded.default ?? loaded;
+	} catch {
+		return;
+	}
+}
+async function loadNodePublishPlugins(document, assetsPath) {
+	const projectDir = document.getProjectDir?.() || (assetsPath ? resolveProjectBasePath(assetsPath) : "");
+	if (!projectDir) return [];
+	return loadPlugins(document, (await importNative$1("node:path")).join(projectDir, "plugins"));
+}
+/**
+* Publish a FairyGUI project through the standard Node host adapter.
+*
+* The adapter owns Node filesystem, Sharp, and project plugin discovery.
+* For custom environments, use the lower-level `publish()` core with explicit
+* capabilities instead.
+*/
+async function publishNode(options) {
+	const { document, assetsPath: configuredAssetsPath, atlas, encoder: configuredEncoder, plugins: configuredPlugins, ...publishOptions } = options;
+	const [fileSystem, assetsPath] = await Promise.all([createNodePublishFileSystem(), resolveNodeAssetsPath(document, configuredAssetsPath)]);
+	const [encoder, plugins] = await Promise.all([configuredEncoder === void 0 ? loadSharpBackend() : Promise.resolve(configuredEncoder), configuredPlugins === void 0 ? loadNodePublishPlugins(document, assetsPath) : Promise.resolve(configuredPlugins)]);
+	if (!encoder) throw new Error("publishNode: Sharp is required for a complete publish. Install sharp or provide an encoder.");
+	await document.transform(publish({
+		...publishOptions,
+		basePath: assetsPath,
+		encoder,
+		atlas: {
+			...atlas,
+			readFileRaw: fileSystem.readFileRaw
+		},
+		fs: fileSystem,
+		plugins
+	}));
+}
+//#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 restore({
+		...options,
+		fs,
+		...imageProcessors
+	});
+}
+//#endregion
+export { publishNode, restoreNode };