@openfairygui/functions 0.3.0-alpha.4 → 0.3.1

package/dist/web.cjs

@@ -1,32 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_publish = require("./publish-C7qHwEiP.cjs");
+const require_publish = require("./publish-DhMv_lEP.cjs");
 let _openfairygui_core = require("@openfairygui/core");
 let fast_xml_parser = require("fast-xml-parser");
 //#region src/adapters/web/raster.ts
-const MAX_SVG_SOURCE_BYTES = 8 * 1024 * 1024;
 const MAX_SVG_DIMENSION = 16384;
 const MAX_SVG_PIXELS = 64 * 1024 * 1024;
-const MAX_SVG_NODES = 5e4;
-const UNSAFE_SVG_ELEMENTS = new Set([
-	"a",
-	"animate",
-	"animatecolor",
-	"animatemotion",
-	"animatetransform",
-	"audio",
-	"canvas",
-	"discard",
-	"embed",
-	"feimage",
-	"foreignobject",
-	"iframe",
-	"image",
-	"object",
-	"script",
-	"set",
-	"style",
-	"video"
-]);
 function unsafeSvg(message) {
 	throw new Error(`publishBrowser: unsafe SVG input (${message}).`);
 }
@@ -41,47 +19,14 @@ function parseSvgLength(value, name) {
 	if (!Number.isFinite(parsed) || parsed <= 0 || parsed > MAX_SVG_DIMENSION) unsafeSvg(`${name} exceeds the supported dimensions`);
 	return parsed;
 }
-function validateSvgAttribute(name, value) {
-	const normalizedName = name.toLowerCase();
-	if (normalizedName === "xmlns" || normalizedName.startsWith("xmlns:")) return;
-	const localName = svgLocalName(name);
-	const text = String(value);
-	if (localName.startsWith("on")) unsafeSvg(`event attribute "${name}" is not allowed`);
-	if (localName === "style" || localName === "src") unsafeSvg(`attribute "${name}" is not allowed`);
-	if (localName === "href" && !/^#[A-Za-z_][\w:.-]*$/u.test(text)) unsafeSvg(`external reference in "${name}" is not allowed`);
-	if (/(?:^|[\s("'=])(?:https?:|file:|javascript:|data:|\/\/)/iu.test(text)) unsafeSvg(`external URL in "${name}" is not allowed`);
-	for (const match of text.matchAll(/url\s*\(([^)]*)\)/giu)) {
-		const reference = (match[1] ?? "").trim().replace(/^(['"])(.*)\1$/u, "$2");
-		if (!/^#[A-Za-z_][\w:.-]*$/u.test(reference)) unsafeSvg(`external url() in "${name}" is not allowed`);
-	}
-}
-function visitSvgEntry(entry) {
-	const pending = [entry];
-	let nodeCount = 0;
-	while (pending.length > 0) {
-		const current = pending.pop();
-		for (const [name, value] of Object.entries(current)) {
-			if (name === ":@" || name.startsWith("#") || name.startsWith("?")) continue;
-			if (++nodeCount > MAX_SVG_NODES) unsafeSvg("node count exceeds the supported limit");
-			const localName = svgLocalName(name);
-			if (UNSAFE_SVG_ELEMENTS.has(localName)) unsafeSvg(`element <${name}> is not allowed`);
-			for (const [attributeName, attributeValue] of Object.entries(current[":@"] ?? {})) validateSvgAttribute(attributeName, attributeValue);
-			if (Array.isArray(value)) {
-				for (const child of value) if (child && typeof child === "object" && !Array.isArray(child)) pending.push(child);
-			}
-		}
-	}
-}
 function validateSvg(bytes) {
-	if (bytes.byteLength === 0 || bytes.byteLength > MAX_SVG_SOURCE_BYTES) unsafeSvg("source size is unsupported");
-	let source;
 	try {
-		source = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
-	} catch {
-		unsafeSvg("source is not valid UTF-8");
+		validateSvgDimensions((0, _openfairygui_core.validateSafeSvgSource)(bytes));
+	} catch (error) {
+		unsafeSvg(error instanceof Error ? error.message : String(error));
 	}
-	if (/<!\s*(?:doctype|entity)\b|<\?xml-stylesheet\b/iu.test(source)) unsafeSvg("DTD, entities, and stylesheets are not allowed");
-	if (fast_xml_parser.XMLValidator.validate(source, { allowBooleanAttributes: false }) !== true) unsafeSvg("source is not well-formed XML");
+}
+function validateSvgDimensions(source) {
 	const roots = new fast_xml_parser.XMLParser({
 		preserveOrder: true,
 		ignoreAttributes: false,
@@ -95,9 +40,7 @@ function validateSvg(bytes) {
 		name
 	})));
 	if (roots.length !== 1 || svgLocalName(roots[0].name) !== "svg") unsafeSvg("a single <svg> root is required");
-	const root = roots[0].entry;
-	visitSvgEntry(root);
-	const attributes = root[":@"] ?? {};
+	const attributes = roots[0].entry[":@"] ?? {};
 	const width = parseSvgLength(attributes.width, "width");
 	const height = parseSvgLength(attributes.height, "height");
 	let viewBoxWidth;
@@ -219,6 +162,46 @@ var BrowserImagePipeline = class {
 	ensureAlpha() {
 		return this;
 	}
+	removeAlpha() {
+		this.raster = this.raster.then((source) => {
+			const context = getBrowserContext(source.canvas);
+			const image = context.getImageData(0, 0, source.width, source.height);
+			for (let index = 3; index < image.data.length; index += 4) image.data[index] = 255;
+			context.putImageData(image, 0, 0);
+			return source;
+		});
+		return this;
+	}
+	extractChannel(channel) {
+		if (channel !== "alpha") throw new Error(`publishBrowser: Unsupported channel "${channel}".`);
+		this.raster = this.raster.then((source) => {
+			const context = getBrowserContext(source.canvas);
+			const image = context.getImageData(0, 0, source.width, source.height);
+			for (let index = 0; index < image.data.length; index += 4) {
+				const alpha = image.data[index + 3] ?? 0;
+				image.data[index] = alpha;
+				image.data[index + 1] = alpha;
+				image.data[index + 2] = alpha;
+				image.data[index + 3] = 255;
+			}
+			context.putImageData(image, 0, 0);
+			return source;
+		});
+		return this;
+	}
+	joinChannel(images) {
+		this.raster = Promise.all([this.raster, ...images.map((image) => this.decode(image))]).then(([source, ...channels]) => {
+			const context = getBrowserContext(source.canvas);
+			const image = context.getImageData(0, 0, source.width, source.height);
+			for (const [channelIndex, channel] of channels.slice(0, 2).entries()) {
+				const channelData = getBrowserContext(channel.canvas).getImageData(0, 0, channel.width, channel.height).data;
+				for (let index = 0; index < image.data.length; index += 4) image.data[index + channelIndex + 1] = channelData[index] ?? 0;
+			}
+			context.putImageData(image, 0, 0);
+			return source;
+		});
+		return this;
+	}
 	resize(options) {
 		this.raster = this.raster.then((source) => {
 			const target = createRaster(options.width, options.height);

package/dist/web.d.cts

@@ -1,9 +1,9 @@
-import { d as PublishSourceFileSystem, t as AtlasOptions, u as PublishOutputFileSystem } from "./atlas-CHsu2Y8i.cjs";
+import { d as PublishSourceFileSystem, t as AtlasOptions, u as PublishOutputFileSystem } from "./atlas-CSqHsG0X.cjs";
 import { Document, ProjectValidationReport, UamProject } from "@openfairygui/core";
 
 //#region src/adapters/web/publish.d.ts
 type BrowserPublishProjectType = 'layabox';
-type BrowserPublishAtlasOptions = Pick<AtlasOptions, 'maxSize' | 'fast' | 'allowRotation' | 'padding' | 'powerOfTwo' | 'square' | 'multiPage' | 'trimImage' | 'extractAlpha'>;
+type BrowserPublishAtlasOptions = Pick<AtlasOptions, 'maxSize' | 'fast' | 'allowRotation' | 'padding' | 'powerOfTwo' | 'maxAtlasIndex' | 'multipleOfFour' | 'square' | 'multiPage' | 'trimImage' | 'extractAlpha'>;
 type BrowserPublishSourceFileSystem = PublishSourceFileSystem;
 type BrowserPublishOutputFileSystem = PublishOutputFileSystem;
 interface BrowserPublishOptions {

package/dist/web.d.ts

@@ -1,9 +1,9 @@
-import { d as PublishSourceFileSystem, t as AtlasOptions, u as PublishOutputFileSystem } from "./atlas-C6tbl7nn.js";
+import { d as PublishSourceFileSystem, t as AtlasOptions, u as PublishOutputFileSystem } from "./atlas-BtWa1DwO.js";
 import { Document, ProjectValidationReport, UamProject } from "@openfairygui/core";
 
 //#region src/adapters/web/publish.d.ts
 type BrowserPublishProjectType = 'layabox';
-type BrowserPublishAtlasOptions = Pick<AtlasOptions, 'maxSize' | 'fast' | 'allowRotation' | 'padding' | 'powerOfTwo' | 'square' | 'multiPage' | 'trimImage' | 'extractAlpha'>;
+type BrowserPublishAtlasOptions = Pick<AtlasOptions, 'maxSize' | 'fast' | 'allowRotation' | 'padding' | 'powerOfTwo' | 'maxAtlasIndex' | 'multipleOfFour' | 'square' | 'multiPage' | 'trimImage' | 'extractAlpha'>;
 type BrowserPublishSourceFileSystem = PublishSourceFileSystem;
 type BrowserPublishOutputFileSystem = PublishOutputFileSystem;
 interface BrowserPublishOptions {

package/dist/web.js

@@ -1,31 +1,9 @@
-import { _ as validateProject, c as resolveCodeGenerationSettings, n as resolvePublishOptions, t as publish } from "./publish-CyBj2o7n.js";
-import { ProjectType, createProjectValidationReport } from "@openfairygui/core";
-import { XMLParser, XMLValidator } from "fast-xml-parser";
+import { _ as validateProject, c as resolveCodeGenerationSettings, n as resolvePublishOptions, t as publish } from "./publish-Cy09yjfn.js";
+import { ProjectType, createProjectValidationReport, validateSafeSvgSource } from "@openfairygui/core";
+import { XMLParser } from "fast-xml-parser";
 //#region src/adapters/web/raster.ts
-const MAX_SVG_SOURCE_BYTES = 8 * 1024 * 1024;
 const MAX_SVG_DIMENSION = 16384;
 const MAX_SVG_PIXELS = 64 * 1024 * 1024;
-const MAX_SVG_NODES = 5e4;
-const UNSAFE_SVG_ELEMENTS = new Set([
-	"a",
-	"animate",
-	"animatecolor",
-	"animatemotion",
-	"animatetransform",
-	"audio",
-	"canvas",
-	"discard",
-	"embed",
-	"feimage",
-	"foreignobject",
-	"iframe",
-	"image",
-	"object",
-	"script",
-	"set",
-	"style",
-	"video"
-]);
 function unsafeSvg(message) {
 	throw new Error(`publishBrowser: unsafe SVG input (${message}).`);
 }
@@ -40,47 +18,14 @@ function parseSvgLength(value, name) {
 	if (!Number.isFinite(parsed) || parsed <= 0 || parsed > MAX_SVG_DIMENSION) unsafeSvg(`${name} exceeds the supported dimensions`);
 	return parsed;
 }
-function validateSvgAttribute(name, value) {
-	const normalizedName = name.toLowerCase();
-	if (normalizedName === "xmlns" || normalizedName.startsWith("xmlns:")) return;
-	const localName = svgLocalName(name);
-	const text = String(value);
-	if (localName.startsWith("on")) unsafeSvg(`event attribute "${name}" is not allowed`);
-	if (localName === "style" || localName === "src") unsafeSvg(`attribute "${name}" is not allowed`);
-	if (localName === "href" && !/^#[A-Za-z_][\w:.-]*$/u.test(text)) unsafeSvg(`external reference in "${name}" is not allowed`);
-	if (/(?:^|[\s("'=])(?:https?:|file:|javascript:|data:|\/\/)/iu.test(text)) unsafeSvg(`external URL in "${name}" is not allowed`);
-	for (const match of text.matchAll(/url\s*\(([^)]*)\)/giu)) {
-		const reference = (match[1] ?? "").trim().replace(/^(['"])(.*)\1$/u, "$2");
-		if (!/^#[A-Za-z_][\w:.-]*$/u.test(reference)) unsafeSvg(`external url() in "${name}" is not allowed`);
-	}
-}
-function visitSvgEntry(entry) {
-	const pending = [entry];
-	let nodeCount = 0;
-	while (pending.length > 0) {
-		const current = pending.pop();
-		for (const [name, value] of Object.entries(current)) {
-			if (name === ":@" || name.startsWith("#") || name.startsWith("?")) continue;
-			if (++nodeCount > MAX_SVG_NODES) unsafeSvg("node count exceeds the supported limit");
-			const localName = svgLocalName(name);
-			if (UNSAFE_SVG_ELEMENTS.has(localName)) unsafeSvg(`element <${name}> is not allowed`);
-			for (const [attributeName, attributeValue] of Object.entries(current[":@"] ?? {})) validateSvgAttribute(attributeName, attributeValue);
-			if (Array.isArray(value)) {
-				for (const child of value) if (child && typeof child === "object" && !Array.isArray(child)) pending.push(child);
-			}
-		}
-	}
-}
 function validateSvg(bytes) {
-	if (bytes.byteLength === 0 || bytes.byteLength > MAX_SVG_SOURCE_BYTES) unsafeSvg("source size is unsupported");
-	let source;
 	try {
-		source = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
-	} catch {
-		unsafeSvg("source is not valid UTF-8");
+		validateSvgDimensions(validateSafeSvgSource(bytes));
+	} catch (error) {
+		unsafeSvg(error instanceof Error ? error.message : String(error));
 	}
-	if (/<!\s*(?:doctype|entity)\b|<\?xml-stylesheet\b/iu.test(source)) unsafeSvg("DTD, entities, and stylesheets are not allowed");
-	if (XMLValidator.validate(source, { allowBooleanAttributes: false }) !== true) unsafeSvg("source is not well-formed XML");
+}
+function validateSvgDimensions(source) {
 	const roots = new XMLParser({
 		preserveOrder: true,
 		ignoreAttributes: false,
@@ -94,9 +39,7 @@ function validateSvg(bytes) {
 		name
 	})));
 	if (roots.length !== 1 || svgLocalName(roots[0].name) !== "svg") unsafeSvg("a single <svg> root is required");
-	const root = roots[0].entry;
-	visitSvgEntry(root);
-	const attributes = root[":@"] ?? {};
+	const attributes = roots[0].entry[":@"] ?? {};
 	const width = parseSvgLength(attributes.width, "width");
 	const height = parseSvgLength(attributes.height, "height");
 	let viewBoxWidth;
@@ -218,6 +161,46 @@ var BrowserImagePipeline = class {
 	ensureAlpha() {
 		return this;
 	}
+	removeAlpha() {
+		this.raster = this.raster.then((source) => {
+			const context = getBrowserContext(source.canvas);
+			const image = context.getImageData(0, 0, source.width, source.height);
+			for (let index = 3; index < image.data.length; index += 4) image.data[index] = 255;
+			context.putImageData(image, 0, 0);
+			return source;
+		});
+		return this;
+	}
+	extractChannel(channel) {
+		if (channel !== "alpha") throw new Error(`publishBrowser: Unsupported channel "${channel}".`);
+		this.raster = this.raster.then((source) => {
+			const context = getBrowserContext(source.canvas);
+			const image = context.getImageData(0, 0, source.width, source.height);
+			for (let index = 0; index < image.data.length; index += 4) {
+				const alpha = image.data[index + 3] ?? 0;
+				image.data[index] = alpha;
+				image.data[index + 1] = alpha;
+				image.data[index + 2] = alpha;
+				image.data[index + 3] = 255;
+			}
+			context.putImageData(image, 0, 0);
+			return source;
+		});
+		return this;
+	}
+	joinChannel(images) {
+		this.raster = Promise.all([this.raster, ...images.map((image) => this.decode(image))]).then(([source, ...channels]) => {
+			const context = getBrowserContext(source.canvas);
+			const image = context.getImageData(0, 0, source.width, source.height);
+			for (const [channelIndex, channel] of channels.slice(0, 2).entries()) {
+				const channelData = getBrowserContext(channel.canvas).getImageData(0, 0, channel.width, channel.height).data;
+				for (let index = 0; index < image.data.length; index += 4) image.data[index + channelIndex + 1] = channelData[index] ?? 0;
+			}
+			context.putImageData(image, 0, 0);
+			return source;
+		});
+		return this;
+	}
 	resize(options) {
 		this.raster = this.raster.then((source) => {
 			const target = createRaster(options.width, options.height);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfairygui/functions",
-  "version": "0.3.0-alpha.4",
+  "version": "0.3.1",
   "description": "FairyGUI Headless Authoring SDK — composable transform functions.",
   "author": "OpenFairyGUI Contributors",
   "license": "MIT",
@@ -13,6 +13,9 @@
   "bugs": {
     "url": "https://github.com/OpenFairyGUI/OpenFairyGUI/issues"
   },
+  "engines": {
+    "node": ">=20"
+  },
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.cjs",
@@ -75,7 +78,7 @@
   "dependencies": {
     "fast-xml-parser": "^5.0.0",
     "jiti": "^2.6.1",
-    "@openfairygui/core": "0.3.0-alpha.4"
+    "@openfairygui/core": "0.3.1"
   },
   "optionalDependencies": {
     "sharp": ">=0.33.0"

package/src/adapters/node/plugins.ts

@@ -7,10 +7,7 @@ import {
 	type PluginModule,
 } from '../../plugins/types.js';
 
-interface PluginPackageJson extends Partial<PluginManifest> {
-	name?: string;
-	main?: string;
-}
+interface PluginPackageJson extends Partial<PluginManifest> {}
 
 // Keep Node builtins out of the neutral bundle resolver while still loading plugins in Node.
 const importNative = new Function('id', 'return import(id)') as <T>(id: string) => Promise<T>;
@@ -31,15 +28,35 @@ export async function loadPlugins(doc: Document, pluginsDir: string): Promise<Lo
 	for (const entry of entries) {
 		if (!entry.isDirectory()) continue;
 		const pluginDir = path.join(pluginsDir, entry.name);
+		let manifest: PluginManifest | null;
 		try {
-			const manifest = await readPluginManifest(fs, path, pluginDir);
-			if (!manifest) continue;
+			manifest = await readPluginManifest(fs, path, pluginDir);
+		} catch (error) {
+			doc.getLogger().warn(`publish: Plugin "${entry.name}" was skipped: ${formatPluginError(error)}`);
+			continue;
+		}
+		if (!manifest) continue;
+		if (!manifest.main) {
+			const error = new Error(`Codegen plugin "${manifest.name}" is missing package.json main.`);
+			if (manifest.required) throw error;
+			doc.getLogger().warn(`publish: Plugin "${manifest.name}" was skipped: ${error.message}`);
+			continue;
+		}
 
+		try {
 			const mainPath = resolvePluginMain(path, pluginDir, manifest);
 			const plugin = await loadPlugin(mainPath);
-			plugins.push({ name: manifest.name, plugin });
+			plugins.push({
+				name: manifest.name,
+				plugin,
+				failureMode: manifest.required ? 'abort' : manifest.failureMode,
+			});
 		} catch (error) {
-			doc.getLogger().warn(`publish: Plugin "${entry.name}" was skipped: ${formatPluginError(error)}`);
+			if (!manifest.required && manifest.failureMode === 'warn') {
+				doc.getLogger().warn(`publish: Plugin "${manifest.name}" was skipped: ${formatPluginError(error)}`);
+				continue;
+			}
+			throw new Error(`publish: Failed to load plugin "${manifest.name}": ${formatPluginError(error)}`);
 		}
 	}
 
@@ -50,17 +67,16 @@ async function readPluginManifest(
 	fs: typeof import('node:fs/promises'),
 	path: typeof import('node:path'),
 	pluginDir: string,
-): Promise<PluginPackageJson | null> {
+): Promise<PluginManifest | null> {
 	const manifestPath = path.join(pluginDir, 'package.json');
 	const content = await fs.readFile(manifestPath, 'utf-8');
 	const manifest = JSON.parse(content) as PluginPackageJson;
 	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;
+	return manifest as PluginManifest;
 }
 
-function resolvePluginMain(path: typeof import('node:path'), pluginDir: string, manifest: PluginPackageJson): string {
-	const mainPath = path.resolve(pluginDir, manifest.main!);
+function resolvePluginMain(path: typeof import('node:path'), pluginDir: string, manifest: PluginManifest): string {
+	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.`);

package/src/adapters/node/publish.ts

@@ -83,6 +83,70 @@ async function loadNodePublishPlugins(document: Document, assetsPath: string | u
 	return loadPlugins(document, path.join(projectDir, 'plugins'));
 }
 
+async function publishToStagedOutput(output: string, run: (staging: string) => Promise<void>): Promise<void> {
+	const [fs, path, { randomUUID }] = await Promise.all([
+		importNative<typeof import('node:fs/promises')>('node:fs/promises'),
+		importNative<typeof import('node:path')>('node:path'),
+		importNative<typeof import('node:crypto')>('node:crypto'),
+	]);
+	const target = path.resolve(output);
+	const parent = path.dirname(target);
+	const name = path.basename(target);
+	const staging = path.join(parent, `.${name}.publish-${randomUUID()}`);
+	const backup = path.join(parent, `.${name}.publish-backup-${randomUUID()}`);
+	await fs.mkdir(parent, { recursive: true });
+	let existed = false;
+	try {
+		const stat = await fs.lstat(target);
+		if (stat.isSymbolicLink() || !stat.isDirectory()) throw new Error(`publishNode: output must be a regular directory: ${target}`);
+		await assertNoSymlinks(fs, path, target);
+		existed = true;
+	} catch (error) {
+		if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;
+	}
+	try {
+		if (existed) await fs.cp(target, staging, { recursive: true, errorOnExist: true, force: false });
+		else await fs.mkdir(staging);
+	} catch (error) {
+		await fs.rm(staging, { recursive: true, force: true });
+		throw error;
+	}
+
+	try {
+		await run(staging);
+	} catch (error) {
+		await fs.rm(staging, { recursive: true, force: true });
+		throw error;
+	}
+	if (!existed) {
+		await fs.rename(staging, target);
+		return;
+	}
+
+	// ponytail: two-step rename preserves rollback; use directory exchange if zero reader gap becomes required.
+	await fs.rename(target, backup);
+	try {
+		await fs.rename(staging, target);
+	} catch (error) {
+		await fs.rename(backup, target);
+		await fs.rm(staging, { recursive: true, force: true });
+		throw error;
+	}
+	await fs.rm(backup, { recursive: true, force: true }).catch(() => undefined);
+}
+
+async function assertNoSymlinks(
+	fs: typeof import('node:fs/promises'),
+	path: typeof import('node:path'),
+	directory: string,
+): Promise<void> {
+	for (const entry of await fs.readdir(directory, { withFileTypes: true })) {
+		const entryPath = path.join(directory, entry.name);
+		if (entry.isSymbolicLink()) throw new Error(`publishNode: symbolic links are not supported in output directories: ${entryPath}`);
+		if (entry.isDirectory()) await assertNoSymlinks(fs, path, entryPath);
+	}
+}
+
 /**
  * Publish a FairyGUI project through the standard Node host adapter.
  *
@@ -114,9 +178,10 @@ export async function publishNode(options: PublishNodeOptions): Promise<void> {
 		throw new Error('publishNode: Sharp is required for a complete publish. Install sharp or provide an encoder.');
 	}
 
-	await document.transform(
-		publish({
+	const run = async (output: string | undefined): Promise<void> => {
+		await document.transform(publish({
 			...publishOptions,
+			output,
 			basePath: assetsPath,
 			encoder,
 			atlas: {
@@ -125,6 +190,11 @@ export async function publishNode(options: PublishNodeOptions): Promise<void> {
 			},
 			fs: fileSystem,
 			plugins,
-		}),
-	);
+		}));
+	};
+	if (publishOptions.output) {
+		await publishToStagedOutput(publishOptions.output, run);
+		return;
+	}
+	await run(undefined);
 }

package/src/adapters/node/validate.ts

@@ -72,6 +72,7 @@ export async function validateProjectNode(projectPath: string): Promise<ProjectV
 	));
 
 	for (const { pkg, packageIndex, resource, resourceIndex } of images) {
+		if (resource.kind !== 'image') continue;
 		try {
 			await sharp(resource.sourceBytes!).raw().toBuffer();
 		} catch (error) {

package/src/adapters/web/publish.ts

@@ -19,6 +19,8 @@ export type BrowserPublishAtlasOptions = Pick<
 	| 'allowRotation'
 	| 'padding'
 	| 'powerOfTwo'
+	| 'maxAtlasIndex'
+	| 'multipleOfFour'
 	| 'square'
 	| 'multiPage'
 	| 'trimImage'