@openfairygui/functions 0.2.0-alpha.11 → 0.2.0-alpha.13

package/dist/node.cjs

@@ -0,0 +1,128 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_publish = require("./publish-CtCXsMdj.cjs");
+//#region src/adapters/node/plugins.ts
+const importNative$1 = 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");
+	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$1("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 = new Function("id", "return import(id)");
+async function createNodePublishFileSystem() {
+	const [fs, path] = await Promise.all([importNative("node:fs/promises"), importNative("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("node:path")).join(projectDir, "assets");
+}
+async function loadSharpBackend() {
+	try {
+		const sharp = await importNative("sharp");
+		return sharp.default ?? sharp;
+	} catch {
+		return;
+	}
+}
+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"));
+}
+/**
+* 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) document.getLogger().warn("publish: Sharp is unavailable; atlas layout will be generated without PNG output.");
+	await document.transform(require_publish.publish({
+		...publishOptions,
+		basePath: assetsPath,
+		encoder,
+		atlas: {
+			...atlas,
+			readFileRaw: fileSystem.readFileRaw
+		},
+		fs: fileSystem,
+		plugins
+	}));
+}
+//#endregion
+exports.publishNode = publishNode;

package/dist/node.d.cts

@@ -0,0 +1,31 @@
+import { r as AtlasRasterBackend } from "./atlas-CHsu2Y8i.cjs";
+import { O as PublishOptions, m as LoadedPlugin } from "./codegen-C7PPZrB3.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
+export { type PublishNodeOptions, publishNode };

package/dist/node.d.ts

@@ -0,0 +1,31 @@
+import { r as AtlasRasterBackend } from "./atlas-CDn6TirX.js";
+import { O as PublishOptions, m as LoadedPlugin } from "./codegen-CEnmtjBP.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
+export { type PublishNodeOptions, publishNode };

package/dist/node.js

@@ -0,0 +1,127 @@
+import { l as resolveProjectBasePath, t as publish, u as formatPluginError } from "./publish-Bl-GK9kt.js";
+//#region src/adapters/node/plugins.ts
+const importNative$1 = 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");
+	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$1("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 = new Function("id", "return import(id)");
+async function createNodePublishFileSystem() {
+	const [fs, path] = await Promise.all([importNative("node:fs/promises"), importNative("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("node:path")).join(projectDir, "assets");
+}
+async function loadSharpBackend() {
+	try {
+		const sharp = await importNative("sharp");
+		return sharp.default ?? sharp;
+	} catch {
+		return;
+	}
+}
+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"));
+}
+/**
+* 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) document.getLogger().warn("publish: Sharp is unavailable; atlas layout will be generated without PNG output.");
+	await document.transform(publish({
+		...publishOptions,
+		basePath: assetsPath,
+		encoder,
+		atlas: {
+			...atlas,
+			readFileRaw: fileSystem.readFileRaw
+		},
+		fs: fileSystem,
+		plugins
+	}));
+}
+//#endregion
+export { publishNode };