@openfairygui/functions 0.2.4 → 0.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfairygui/functions",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "FairyGUI Headless Authoring SDK — composable transform functions.",
   "author": "OpenFairyGUI Contributors",
   "license": "MIT",
@@ -75,7 +75,7 @@
   "dependencies": {
     "fast-xml-parser": "^5.0.0",
     "jiti": "^2.6.1",
-    "@openfairygui/core": "0.2.4"
+    "@openfairygui/core": "0.2.6"
   },
   "optionalDependencies": {
     "sharp": ">=0.33.0"

package/src/adapters/node/plugins.ts

@@ -50,17 +50,17 @@ 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/web/publish.ts

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

package/src/adapters/web/raster.ts

@@ -27,6 +27,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;
@@ -308,6 +309,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

@@ -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,12 +108,14 @@ 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) {
@@ -172,7 +181,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 +207,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 +537,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 +646,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/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

@@ -80,6 +80,8 @@ export interface ResolvedPublishAtlasOptions
 		| 'allowRotation'
 		| 'padding'
 		| 'powerOfTwo'
+		| 'maxAtlasIndex'
+		| 'multipleOfFour'
 		| 'square'
 		| 'multiPage'
 		| 'trimImage'
@@ -159,10 +161,14 @@ export function resolvePublishOptions(
 		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,
@@ -171,6 +177,8 @@ export function resolvePublishOptions(
 			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,

package/src/publish/package-context.ts

@@ -9,6 +9,7 @@ import {
 	ProjectType,
 	type SoundResource,
 	type SpineResource,
+	type SwfResource,
 } from '@openfairygui/core';
 import type { AtlasRasterBackend } from './contracts.js';
 import { collectPackageResourceReferences } from './resource-references.js';
@@ -69,6 +70,12 @@ export function isSoundResource(resource: ReturnType<Package['listResources']>[n
 	return resource.propertyType === 'SoundResource';
 }
 
+export function isSwfResource(
+	resource: ReturnType<Package['listResources']>[number],
+): resource is SwfResource {
+	return resource.propertyType === 'SwfResource';
+}
+
 function isSpineResource(resource: ReturnType<Package['listResources']>[number]): resource is SpineResource {
 	return resource.propertyType === 'SpineResource';
 }
@@ -132,10 +139,15 @@ export function extname(fileName: string): string {
 }
 
 function resolvePublishedMiscFileName(resource: MiscResource, projectType: number): string {
-	const file = resource.getFile();
-	if (projectType !== UNITY_PROJECT_TYPE) return file;
-	if (file.toLowerCase().endsWith('.atlas')) return `${file}.txt`;
-	return file;
+	const fileName = `${getPublishedId(resource)}${extname(resource.getFile())}`;
+	if (projectType === UNITY_PROJECT_TYPE && fileName.toLowerCase().endsWith('.atlas')) {
+		return `${fileName}.txt`;
+	}
+	return fileName;
+}
+
+function resolvePublishedSwfFileName(resource: SwfResource): string {
+	return `${getPublishedId(resource)}${extname(resource.getFile()) || '.swf'}`;
 }
 
 function resolvePublishedSkeletonFileName(resource: SpineResource | DragonBonesResource, projectType: number): string {
@@ -235,18 +247,19 @@ function collectHighResolutionItemIds(
 	resources: ReturnType<Package['listResources']>,
 	publishedResourceIds: Set<string>,
 	includeHighResolution: number,
+	excludedResourceIds: Set<string>,
 ): Map<string, Array<string | null>> {
 	const result = new Map<string, Array<string | null>>();
 	if (includeHighResolution <= 0) return result;
 
 	const highResolutionResourceByKey = new Map<string, ImageResource | MovieClipResource>();
 	for (const resource of resources) {
-		if (!isHighResolutionResource(resource)) continue;
+		if (!isHighResolutionResource(resource) || excludedResourceIds.has(resource.getId())) continue;
 		highResolutionResourceByKey.set(buildHighResolutionResourceKey(resource), resource);
 	}
 
 	for (const resource of resources) {
-		if (!isHighResolutionResource(resource)) continue;
+		if (!isHighResolutionResource(resource) || excludedResourceIds.has(resource.getId())) continue;
 		if (!publishedResourceIds.has(resource.getId())) continue;
 		if (isHighResolutionVariantName(resource.getName())) continue;
 
@@ -290,6 +303,7 @@ function collectPackagePublishContext(
 	},
 ): PackagePublishContext {
 	const resources = pkg.listResources();
+	const excludedResourceIds = new Set(pkg.getSourceAtlasSettings().excludedResourceIds);
 	const resourceMap = new Map(resources.map((resource) => [resource.getId(), resource]));
 	const referencedIds = collectPackageResourceReferences(pkg).localResourceIds;
 	const pixelHitTestImageIds = new Set<string>();
@@ -304,10 +318,15 @@ function collectPackagePublishContext(
 		while (changed) {
 			changed = false;
 			for (const resourceId of [...exportedResourceIds]) {
+				if (excludedResourceIds.has(resourceId)) {
+					exportedResourceIds.delete(resourceId);
+					changed = true;
+					continue;
+				}
 				const resource = resourcesById.get(resourceId);
 				if (!resource || !isSkeletonResource(resource)) continue;
 				for (const requiredId of resource.getRequireIds()) {
-					if (!requiredId || exportedResourceIds.has(requiredId)) continue;
+					if (!requiredId || excludedResourceIds.has(requiredId) || exportedResourceIds.has(requiredId)) continue;
 					exportedResourceIds.add(requiredId);
 					changed = true;
 				}
@@ -318,7 +337,7 @@ function collectPackagePublishContext(
 
 	for (const atlas of pkg.listAtlases()) {
 		for (const sprite of atlas.listSprites()) {
-			spriteItemIds.add(sprite.getItemId());
+			if (!excludedResourceIds.has(sprite.getItemId())) spriteItemIds.add(sprite.getItemId());
 		}
 	}
 
@@ -331,8 +350,8 @@ function collectPackagePublishContext(
 		const hitTest = component.getHitTest?.()?.trim();
 		if (hitTest && !hitTest.includes(',')) {
 			const targetChild = childMap.get(hitTest);
-			const sourceId = targetChild?.getSrc?.();
-			if (sourceId) {
+		const sourceId = (targetChild as { getSrc?(): string } | undefined)?.getSrc?.();
+			if (sourceId && !excludedResourceIds.has(sourceId)) {
 				const sourceResource = resourceMap.get(sourceId);
 				if (sourceResource && isImageResource(sourceResource)) {
 					pixelHitTestImageIds.add(sourceId);
@@ -344,7 +363,7 @@ function collectPackagePublishContext(
 	const publishedResourceIds = new Set<string>(spriteItemIds);
 	for (const resource of resources) {
 		const resourceId = resource.getId();
-		if (!resourceId) continue;
+		if (!resourceId || excludedResourceIds.has(resourceId)) continue;
 		if (isComponentResource(resource)) {
 			if (resource.getExported() || referencedIds.has(resourceId)) {
 				publishedResourceIds.add(resourceId);
@@ -390,6 +409,7 @@ function collectPackagePublishContext(
 		resources,
 		publishedResourceIds,
 		options.includeHighResolution,
+		excludedResourceIds,
 	);
 
 	if (!options.includeBranches) {
@@ -576,6 +596,10 @@ export async function annotatePackagePublishArtifacts(
 			setPublishedFileExtra(resource, resolvePublishedMiscFileName(resource, options.projectType));
 			continue;
 		}
+		if (isSwfResource(resource)) {
+			setPublishedFileExtra(resource, resolvePublishedSwfFileName(resource));
+			continue;
+		}
 		if (isSkeletonResource(resource)) {
 			setPublishedFileExtra(resource, resolvePublishedSkeletonFileName(resource, options.projectType));
 		}