@openfairygui/functions 0.3.0-alpha.4 → 0.3.1

package/src/adapters/web/raster.ts

@@ -6,7 +6,8 @@ import type {
 	PublishFileSystem,
 	PublishSourceFileSystem,
 } from '../../publish/contracts.js';
-import { XMLParser, XMLValidator } from 'fast-xml-parser';
+import { validateSafeSvgSource } from '@openfairygui/core';
+import { XMLParser } from 'fast-xml-parser';
 
 type BrowserCanvas = OffscreenCanvas | HTMLCanvasElement;
 
@@ -27,6 +28,7 @@ interface BrowserContext {
 	): void;
 	fillRect(x: number, y: number, width: number, height: number): void;
 	getImageData(sx: number, sy: number, sw: number, sh: number): ImageData;
+	putImageData(imageData: ImageData, dx: number, dy: number): void;
 	rotate(angle: number): void;
 	restore(): void;
 	save(): void;
@@ -40,30 +42,8 @@ interface BrowserRaster {
 	height: number;
 }
 
-const MAX_SVG_SOURCE_BYTES = 8 * 1024 * 1024;
 const MAX_SVG_DIMENSION = 16_384;
 const MAX_SVG_PIXELS = 64 * 1024 * 1024;
-const MAX_SVG_NODES = 50_000;
-const UNSAFE_SVG_ELEMENTS = new Set([
-	'a',
-	'animate',
-	'animatecolor',
-	'animatemotion',
-	'animatetransform',
-	'audio',
-	'canvas',
-	'discard',
-	'embed',
-	'feimage',
-	'foreignobject',
-	'iframe',
-	'image',
-	'object',
-	'script',
-	'set',
-	'style',
-	'video',
-]);
 
 type ParsedSvgEntry = Record<string, unknown> & { ':@'?: Record<string, unknown> };
 
@@ -86,57 +66,16 @@ function parseSvgLength(value: unknown, name: string): number | undefined {
 	return parsed;
 }
 
-function validateSvgAttribute(name: string, value: unknown): void {
-	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: ParsedSvgEntry): void {
-	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 as ParsedSvgEntry);
-				}
-			}
-		}
-	}
-}
-
 function validateSvg(bytes: Uint8Array): void {
-	if (bytes.byteLength === 0 || bytes.byteLength > MAX_SVG_SOURCE_BYTES) unsafeSvg('source size is unsupported');
-	let source: string;
 	try {
-		source = new TextDecoder('utf-8', { fatal: true }).decode(bytes);
-	} catch {
-		unsafeSvg('source is not valid UTF-8');
+		const source = validateSafeSvgSource(bytes);
+		validateSvgDimensions(source);
+	} 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: string): void {
 	const parsed = new XMLParser({
 		preserveOrder: true,
 		ignoreAttributes: false,
@@ -151,7 +90,6 @@ function validateSvg(bytes: Uint8Array): void {
 		.map((name) => ({ entry, 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 width = parseSvgLength(attributes.width, 'width');
 	const height = parseSvgLength(attributes.height, 'height');
@@ -312,6 +250,51 @@ class BrowserImagePipeline implements AtlasRasterPipeline {
 		return this;
 	}
 
+	removeAlpha(): this {
+		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: 'alpha'): this {
+		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: Uint8Array[]): this {
+		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: { width: number; height: number; fit?: 'fill' }): this {
 		this.raster = this.raster.then((source) => {
 			const target = createRaster(options.width, options.height);

package/src/atlas/packing.ts

@@ -1,6 +1,6 @@
 import type { Document, ILogger, Package } from '@openfairygui/core';
 import type { AtlasOptions } from '../atlas.js';
-import { COMPAT_NODE_RECT_FLAGS, type CompatNodeRect } from '../max-rects-compat.js';
+import { COMPAT_NODE_RECT_FLAGS, type CompatNodeRect, type CompatPage } from '../max-rects-compat.js';
 import { MaxRectsPackerCompat } from '../max-rects-packer-compat.js';
 import type { AtlasRasterBackend } from '../publish/contracts.js';
 import {
@@ -289,13 +289,13 @@ function packAtlasPages(
 		multipleOfFour: boolean;
 		square: boolean;
 	},
-): ReturnType<MaxRectsPackerCompat['pack']> {
+): CompatPage[] {
 	const hasDuplicatePadding = inputs.some((input) => {
 		return isImageResource(input.resource) && input.resource.getDuplicatePadding?.() === true;
 	});
 	const packer = new MaxRectsPackerCompat({
 		pot: sizeOverrides?.powerOfTwo ?? options.powerOfTwo,
-		mof: sizeOverrides?.multipleOfFour ?? !options.powerOfTwo,
+		mof: sizeOverrides?.multipleOfFour ?? options.multipleOfFour,
 		padding: options.padding,
 		rotation: options.allowRotation,
 		minWidth: 16,
@@ -433,16 +433,25 @@ async function writeAtlasPageImage(
 	}
 
 	const outputFile = `${options.outputPath}/${atlasFileName}`;
-	await encoder({
+	const atlasPipeline = encoder({
 		create: {
 			width: page.width,
 			height: page.height,
 			channels: 4 as const,
 			background: { r: 0, g: 0, b: 0, alpha: 0 },
 		},
-	})
-		.composite(compositeInputs)
-		.toFile(outputFile);
+	}).composite(compositeInputs);
+	if (options.extractAlpha) {
+		const atlasBuffer = await atlasPipeline.png().toBuffer();
+		await encoder(atlasBuffer).removeAlpha().png().toFile(outputFile);
+		const alphaBuffer = await encoder(atlasBuffer).extractChannel('alpha').png().toBuffer();
+		await encoder(alphaBuffer)
+			.joinChannel([alphaBuffer, alphaBuffer])
+			.png()
+			.toFile(`${options.outputPath}/${insertFileNameSuffix(atlasFileName, '!a')}`);
+	} else {
+		await atlasPipeline.toFile(outputFile);
+	}
 
 	logger.info(`atlas: Generated ${atlasFileName} (${page.width}x${page.height}, ${page.outputRects.length} sprites)`);
 }
@@ -504,6 +513,9 @@ function resolveDirectOutputAtlasSize(
 	if (options.powerOfTwo) {
 		resolvedWidth = nextPow2(resolvedWidth);
 		resolvedHeight = nextPow2(resolvedHeight);
+	} else if (options.multipleOfFour) {
+		resolvedWidth = roundUpToMultiple(resolvedWidth, 4);
+		resolvedHeight = roundUpToMultiple(resolvedHeight, 4);
 	}
 	return { width: resolvedWidth, height: resolvedHeight };
 }
@@ -663,11 +675,8 @@ export function sortResourcesByOrder(
 	return ordered;
 }
 
-function getResourceTextureSetMode(resource: PackInputResource): TextureSetMode {
-	if (isImageResource(resource)) {
-		return parseTextureSetMode(resource.getTextureSetMode?.());
-	}
-	return parseTextureSetMode(resource.getTextureSetMode?.());
+function getResourceTextureSetMode(resource: PackInputResource, maxAtlasIndex: number): TextureSetMode {
+	return parseTextureSetMode(resource.getTextureSetMode?.(), maxAtlasIndex);
 }
 
 function groupStandaloneInputs(
@@ -710,7 +719,7 @@ function groupStandaloneInputs(
 	for (const input of inputs) {
 		const branchName = getInputBranchName(input);
 		const branchOrdinal = branchOrdinalByName.get(branchName) ?? 0;
-		const mode = getResourceTextureSetMode(input.resource);
+		const mode = getResourceTextureSetMode(input.resource, options.maxAtlasIndex ?? 10);
 		if (mode.kind === 'standalone') {
 			const resourceId = getPublishedItemId(input.resource);
 			const key = `${branchName}\u0000${resourceId}`;

package/src/atlas.ts

@@ -62,6 +62,9 @@ export interface AtlasOptions {
 
 	/** Constrain atlas dimensions to powers of two. Default: false. */
 	powerOfTwo?: boolean;
+	/** Highest fixed atlas page index accepted from resource textureSetMode. Default: 10. */
+	maxAtlasIndex?: number;
+	multipleOfFour?: boolean;
 
 	/** Force square atlas (width === height). Default: false. */
 	square?: boolean;
@@ -151,6 +154,8 @@ const ATLAS_DEFAULTS: Required<
 	allowRotation: true,
 	padding: 1,
 	powerOfTwo: false,
+	maxAtlasIndex: 10,
+	multipleOfFour: false,
 	square: false,
 	multiPage: true,
 	trimImage: false,
@@ -163,7 +168,9 @@ const ATLAS_DEFAULTS: Required<
 
 interface AtlasReferenceItem {
 	icon?: string | null;
+	selectedIcon?: string | null;
 	url?: string | null;
+	propertyOverrides?: Array<{ value: string }>;
 }
 
 interface GearWithAtlasRefs {
@@ -183,12 +190,14 @@ interface TransitionWithAtlasRefs {
 }
 
 interface ChildWithReferenceUrls extends HasOptionalSrc, HasOptionalUrl {
+	getClearOnPublish?(): boolean;
 	getDefaultItem?(): string;
 	getIcon?(): string;
 	getSelectedIcon?(): string;
 	getDropdown?(): string;
 	getSound?(): string;
 	getText?(): string;
+	getAutoClearText?(): boolean;
 	getFont?(): string;
 	getInstanceIcon?(): string;
 	getInstanceSelectedIcon?(): string;
@@ -197,7 +206,10 @@ interface ChildWithReferenceUrls extends HasOptionalSrc, HasOptionalUrl {
 	getHeaderRes?(): string;
 	getFooterRes?(): string;
 	getInstanceComboItems?(): Array<{ icon: string | null }>;
+	getInstanceAutoClearItems?(): boolean;
 	getListItems?(): AtlasReferenceItem[];
+	getAutoClearItems?(): boolean;
+	getPropertyOverrides?(): Array<{ value: string }>;
 	listGears?(): GearWithAtlasRefs[];
 }
 
@@ -303,7 +315,7 @@ async function resolveEditorCompatibleResourceOrder(
 			const refChild = child as ChildWithReferenceUrls;
 			await addResource(resourceMap.get(refChild.getSrc?.() ?? ''));
 			for (const ref of [
-				refChild.getUrl?.(),
+				refChild.getClearOnPublish?.() ? undefined : refChild.getUrl?.(),
 				refChild.getDefaultItem?.(),
 				refChild.getIcon?.(),
 				refChild.getSelectedIcon?.(),
@@ -319,12 +331,19 @@ async function resolveEditorCompatibleResourceOrder(
 			]) {
 				await addResourceByLocalUiUrl(ref);
 			}
-			for (const item of refChild.getInstanceComboItems?.() ?? []) {
+			for (const item of refChild.getInstanceAutoClearItems?.() ? [] : (refChild.getInstanceComboItems?.() ?? [])) {
 				await addResourceByLocalUiUrl(item.icon ?? undefined);
 			}
-			for (const item of refChild.getListItems?.() ?? []) {
+			for (const item of refChild.getAutoClearItems?.() ? [] : (refChild.getListItems?.() ?? [])) {
 				await addResourceByLocalUiUrl(item.icon ?? undefined);
+				await addResourceByLocalUiUrl(item.selectedIcon ?? undefined);
 				await addResourceByLocalUiUrl(item.url ?? undefined);
+				for (const property of item.propertyOverrides ?? []) {
+					await addResourceByLocalUiUrl(property.value);
+				}
+			}
+			for (const property of refChild.getPropertyOverrides?.() ?? []) {
+				await addResourceByLocalUiUrl(property.value);
 			}
 			for (const gear of refChild.listGears?.() ?? []) {
 				await addGearIconResources(gear);

package/src/codegen.ts

@@ -12,7 +12,7 @@ import {
 	UNITY_BINDER_TEMPLATE,
 	UNITY_COMPONENT_TEMPLATE,
 } from './codegen-templates.js';
-import { formatPluginError, type LoadedPlugin } from './plugins/types.js';
+import { formatPluginError, type LoadedPlugin, shouldAbortPluginFailure } from './plugins/types.js';
 import { dirname, isAbsolutePathLike, trimTrailingSlashes } from './path-utils.js';
 import type { PublishFileSystem } from './publish/contracts.js';
 import type { CliCodeGenerationSettings, RootProjectSettings } from './shared-types.js';
@@ -33,12 +33,13 @@ export interface ResolvedPackageCodegenPlan {
 	packageFolderName: string;
 	packageNamespace: string;
 	binderClassName: string;
-	settings: CliCodeGenerationSettings;
+	settings: Required<CliCodeGenerationSettings>;
 }
 
 interface FguiTypescriptVariant {
 	binderMethod: 'setExtension';
 	runtimeNamespace: 'fgui';
+	runtimeImport: string;
 }
 
 const FGUI_TYPESCRIPT_RUNTIME_TYPES = new Set([
@@ -65,9 +66,15 @@ const FGUI_TYPESCRIPT_RUNTIME_TYPES = new Set([
 	'Transition',
 ]);
 
-const SHARED_FGUI_TYPESCRIPT_VARIANT: FguiTypescriptVariant = {
+const LAYABOX_TYPESCRIPT_VARIANT: FguiTypescriptVariant = {
 	binderMethod: 'setExtension',
 	runtimeNamespace: 'fgui',
+	runtimeImport: '',
+};
+
+const COCOS_CREATOR_TYPESCRIPT_VARIANT: FguiTypescriptVariant = {
+	...LAYABOX_TYPESCRIPT_VARIANT,
+	runtimeImport: 'import * as fgui from "fairygui-cc";',
 };
 
 export interface CodegenMember {
@@ -101,16 +108,20 @@ export async function publishCodeGeneration(doc: Document, options: PublishCodeG
 	const settings = resolveCodeGenerationSettings(doc);
 	if (!settings.allowGenCode) return;
 
-	const plugins = options.plugins?.filter((plugin) => typeof plugin.plugin.genCode === 'function') ?? [];
+	const plugins = options.plugins ?? [];
 	if (plugins.length > 0) {
 		let handled = false;
 		for (const plugin of plugins) {
+			const genCode = plugin.plugin.genCode;
+			if (!genCode) continue;
 			try {
-				await plugin.plugin.genCode(doc, settings, options);
+				await genCode(doc, settings, options);
 				handled = true;
 				logger.info(`publish: Generated code using plugin "${plugin.name}"`);
 			} catch (error) {
-				logger.warn(`publish: Code generation plugin "${plugin.name}" failed: ${formatPluginError(error)}`);
+				const message = `publish: Code generation plugin "${plugin.name}" failed: ${formatPluginError(error)}`;
+				if (shouldAbortPluginFailure(plugin)) throw new Error(message);
+				logger.warn(message);
 			}
 		}
 		if (handled) {
@@ -172,7 +183,7 @@ export function resolveCodeGenerationSettings(doc: Document): Required<CliCodeGe
 	};
 }
 
-export function resolvePackageCodegenPlan(pkg: Package, settings: CliCodeGenerationSettings, options: PublishCodeGenerationOptions): ResolvedPackageCodegenPlan | null {
+export function resolvePackageCodegenPlan(pkg: Package, settings: Required<CliCodeGenerationSettings>, options: PublishCodeGenerationOptions): ResolvedPackageCodegenPlan | null {
 	const rawCodePath = (pkg.getCodePath() || settings.codePath || '').trim();
 	if (!rawCodePath) return null;
 
@@ -198,11 +209,11 @@ function supportsCodeGenerationLane(doc: Document, codeType: string): boolean {
 	return false;
 }
 
-// Layabox and Cocos Creator currently share the same modern fgui TypeScript output contract.
 function resolveFguiTypescriptVariant(doc: Document): FguiTypescriptVariant | null {
 	const projectType = doc.getRoot().getProjectType();
-	if (projectType !== ProjectType.LayaBox && projectType !== ProjectType.CocosCreator) return null;
-	return SHARED_FGUI_TYPESCRIPT_VARIANT;
+	if (projectType === ProjectType.LayaBox) return LAYABOX_TYPESCRIPT_VARIANT;
+	if (projectType === ProjectType.CocosCreator) return COCOS_CREATOR_TYPESCRIPT_VARIANT;
+	return null;
 }
 
 async function generateUnityCode(
@@ -528,9 +539,10 @@ function renderFguiTypescriptBinder(
 	const bindLines = classes
 		.map((classInfo) => `\t\t${variant.runtimeNamespace}.UIObjectFactory.${variant.binderMethod}(${classInfo.encodedClassName}.URL, ${classInfo.encodedClassName});`)
 		.join('\n');
-	const importLines = classes
+	const classImports = classes
 		.map((classInfo) => `import ${classInfo.encodedClassName} from "./${classInfo.encodedClassName}";`)
 		.join('\n');
+	const importLines = [variant.runtimeImport, classImports].filter(Boolean).join('\n');
 
 	return renderTemplate(FGUI_TYPESCRIPT_BINDER_TEMPLATE, {
 		binderClassName: plan.binderClassName,
@@ -636,6 +648,7 @@ function normalizeTypeName(value: string): string {
 
 function collectFguiTypescriptImports(classInfo: CodegenClass, variant: FguiTypescriptVariant): string {
 	const imports = new Set<string>();
+	if (variant.runtimeImport) imports.add(variant.runtimeImport);
 	for (const member of classInfo.members) {
 		if (member.ignored) continue;
 		const translated = translateFguiTypescriptType(member.type, variant);

package/src/plugins/types.ts

@@ -15,6 +15,8 @@ export interface PluginManifest {
 	};
 	icon?: string;
 	main: string;
+	required?: boolean;
+	failureMode?: 'abort' | 'warn';
 }
 
 export interface ICodeWriterConfig {
@@ -47,6 +49,7 @@ export interface Plugin {
 export interface LoadedPlugin {
 	name: string;
 	plugin: Plugin;
+	failureMode?: 'abort' | 'warn';
 }
 
 export type PluginModule = Plugin & { default?: Plugin };
@@ -54,3 +57,7 @@ export type PluginModule = Plugin & { default?: Plugin };
 export function formatPluginError(error: unknown): string {
 	return error instanceof Error ? error.message : String(error);
 }
+
+export function shouldAbortPluginFailure(plugin: LoadedPlugin): boolean {
+	return plugin.failureMode !== 'warn';
+}

package/src/publish/contracts.ts

@@ -65,6 +65,9 @@ export type AtlasRasterInput =
  */
 export interface AtlasRasterPipeline {
 	ensureAlpha(): AtlasRasterPipeline;
+	removeAlpha(): AtlasRasterPipeline;
+	extractChannel(channel: 'alpha'): AtlasRasterPipeline;
+	joinChannel(images: Uint8Array[]): AtlasRasterPipeline;
 	resize(options: { width: number; height: number; fit?: 'fill' }): AtlasRasterPipeline;
 	raw(): AtlasRasterPipeline;
 	extract(options: { left: number; top: number; width: number; height: number }): AtlasRasterPipeline;

package/src/publish/external-resources.ts

@@ -10,6 +10,7 @@ import {
 	isMiscResource,
 	isSkeletonResource,
 	isSoundResource,
+	isSwfResource,
 	resolveGenericResourcePath,
 	resolveImageFileName,
 	resolveImagePath,
@@ -71,7 +72,7 @@ export async function exportPackageExternalResources(
 	if (!basePath || !readFileRaw) {
 		const hasPublishedExternal = pkg.listResources().some((resource) => {
 			return (
-				((isMiscResource(resource) || isSkeletonResource(resource)) &&
+				((isMiscResource(resource) || isSwfResource(resource) || isSkeletonResource(resource)) &&
 					exportedResourceIds.has(resource.getId())) ||
 				skeletonDependencyImageIds.has(resource.getId())
 			);
@@ -86,20 +87,25 @@ export async function exportPackageExternalResources(
 
 	for (const resource of pkg.listResources()) {
 		const resourceId = resource.getId();
-		const isSkeletonExternal =
-			exportedResourceIds.has(resourceId) && (isMiscResource(resource) || isSkeletonResource(resource));
+		const isExternal =
+			exportedResourceIds.has(resourceId) &&
+			(isMiscResource(resource) || isSwfResource(resource) || isSkeletonResource(resource));
 		const isSkeletonImageDependency = skeletonDependencyImageIds.has(resourceId) && isImageResource(resource);
-		if (!isSkeletonExternal && !isSkeletonImageDependency) continue;
+		if (!isExternal && !isSkeletonImageDependency) continue;
 
 		let sourcePath: string;
 		let targetName: string;
 		if (isSkeletonImageDependency) {
 			sourcePath = resolveImagePath(resource, pkg, basePath);
 			targetName = resolveImageFileName(resource);
-		} else if (isMiscResource(resource) || isSkeletonResource(resource)) {
+		} else if (isMiscResource(resource) || isSwfResource(resource) || isSkeletonResource(resource)) {
 			sourcePath = resolveGenericResourcePath(resource, pkg, basePath);
-			targetName =
+			const publishedFile =
 				((resource.getExtras() as PublishFileExtras | undefined) ?? {})._publishedFile ?? resource.getFile();
+			targetName =
+				isMiscResource(resource) || isSwfResource(resource)
+					? `${pkg.getPublishName() || pkg.getName()}_${publishedFile}`
+					: publishedFile;
 		} else {
 			continue;
 		}

package/src/publish/options.ts

@@ -1,8 +1,8 @@
 import { type Document, ProjectType } from '@openfairygui/core';
 import type { AtlasOptions } from '../atlas.js';
 import type { LoadedPlugin } from '../plugins/types.js';
-import type { AtlasRasterBackend, PublishFileSystem } from './contracts.js';
 import type { CliPublishSettings, RootProjectSettings } from '../shared-types.js';
+import type { AtlasRasterBackend, PublishFileSystem } from './contracts.js';
 
 export interface PublishOptions {
 	/**
@@ -80,6 +80,8 @@ export interface ResolvedPublishAtlasOptions
 		| 'allowRotation'
 		| 'padding'
 		| 'powerOfTwo'
+		| 'maxAtlasIndex'
+		| 'multipleOfFour'
 		| 'square'
 		| 'multiPage'
 		| 'trimImage'
@@ -87,6 +89,8 @@ export interface ResolvedPublishAtlasOptions
 	> {}
 
 export interface ResolvePublishOptionsOverrides {
+	/** Select a target profile between direct overrides and persisted project settings. */
+	targetProjectType?: number;
 	compressed?: boolean;
 	fileExtension?: string;
 	packages?: string[];
@@ -150,21 +154,31 @@ export function resolvePublishOptions(
 	const settings = (root.getSettings?.() ?? {}) as RootProjectSettings;
 	const publishSettings: CliPublishSettings = settings.publish ?? {};
 	const atlasSetting = publishSettings.atlasSetting ?? {};
-	const projectType = root.getProjectType();
+	const projectType = overrides.targetProjectType ?? root.getProjectType();
+	const explicitLayaboxTarget = overrides.targetProjectType === ProjectType.LayaBox;
 
-	const fileExtension = overrides.fileExtension ?? resolveDefaultPublishFileExtension(projectType, publishSettings);
+	const fileExtension =
+		overrides.fileExtension ??
+		(explicitLayaboxTarget ? 'fui' : resolveDefaultPublishFileExtension(projectType, publishSettings));
 
-	let compressed = overrides.compressed ?? publishSettings.compressDesc ?? false;
-	if (projectType === UNITY_PROJECT_TYPE) {
-		compressed = overrides.compressed ?? false;
+	const runtimeRejectsCompression =
+		projectType === UNITY_PROJECT_TYPE || projectType === COCOS_CREATOR_PROJECT_TYPE;
+	if (runtimeRejectsCompression && overrides.compressed === true) {
+		throw new Error('publish: The selected target runtime does not support compressed package data.');
 	}
+	const compressed = runtimeRejectsCompression
+		? false
+		: (overrides.compressed ?? publishSettings.compressDesc ?? false);
 
 	const atlasOptions: ResolvedPublishAtlasOptions = {
 		maxSize: overrides.atlas?.maxSize ?? atlasSetting.maxSize ?? 2048,
 		fast: overrides.atlas?.fast ?? atlasSetting.fast ?? true,
-		allowRotation: overrides.atlas?.allowRotation ?? atlasSetting.allowRotation ?? false,
+		allowRotation:
+			overrides.atlas?.allowRotation ?? (explicitLayaboxTarget ? false : (atlasSetting.allowRotation ?? false)),
 		padding: overrides.atlas?.padding ?? atlasSetting.padding ?? 2,
 		powerOfTwo: overrides.atlas?.powerOfTwo ?? atlasSetting.sizeOption === 'pot',
+		maxAtlasIndex: overrides.atlas?.maxAtlasIndex ?? 10,
+		multipleOfFour: overrides.atlas?.multipleOfFour ?? atlasSetting.sizeOption === 'mof',
 		square: overrides.atlas?.square ?? atlasSetting.forceSquare ?? false,
 		multiPage: overrides.atlas?.multiPage ?? atlasSetting.paging ?? true,
 		trimImage: overrides.atlas?.trimImage ?? atlasSetting.trimImage ?? false,