@openfairygui/functions 0.2.4 → 0.2.6

package/dist/{publish-Cl1b5HtO.cjs → publish-BHoaYgPU.cjs}

@@ -7,7 +7,7 @@ function createTransform(name, fn) {
 	Object.defineProperty(fn, "name", { value: name });
 	return fn;
 }
-function parseTextureSetMode(value) {
+function parseTextureSetMode(value, maxAtlasIndex = 10) {
 	const raw = value?.trim() ?? "";
 	if (!raw) return {
 		kind: "auto",
@@ -30,7 +30,7 @@ function parseTextureSetMode(value) {
 	};
 	if (/^\d+$/.test(raw)) {
 		const pageIndex = Number(raw);
-		if (pageIndex >= 0 && pageIndex <= 10) return {
+		if (pageIndex >= 0 && pageIndex <= maxAtlasIndex) return {
 			kind: "page",
 			raw,
 			pageIndex
@@ -88,9 +88,9 @@ function collectComponentReferences(target, ownerPackageId, component) {
 		const sourcePackageId = child.getPackageId?.()?.trim();
 		if (sourcePackageId && sourcePackageId !== ownerPackageId) target.packageIds.add(sourcePackageId);
 		addFontReferences(target, ownerPackageId, child.getFont?.());
-		addTextReferences(target, ownerPackageId, child.getText?.());
+		if (!child.getAutoClearText?.()) addTextReferences(target, ownerPackageId, child.getText?.());
 		for (const reference of [
-			child.getUrl?.(),
+			child.getClearOnPublish?.() ? void 0 : child.getUrl?.(),
 			child.getDefaultItem?.(),
 			child.getIcon?.(),
 			child.getSelectedIcon?.(),
@@ -104,11 +104,14 @@ function collectComponentReferences(target, ownerPackageId, component) {
 			child.getHeaderRes?.(),
 			child.getFooterRes?.()
 		]) addUiReference(target, ownerPackageId, reference);
-		for (const item of child.getInstanceComboItems?.() ?? []) addUiReference(target, ownerPackageId, item.icon);
-		for (const item of child.getListItems?.() ?? []) {
+		for (const item of child.getInstanceAutoClearItems?.() ? [] : child.getInstanceComboItems?.() ?? []) addUiReference(target, ownerPackageId, item.icon);
+		for (const item of child.getAutoClearItems?.() ? [] : child.getListItems?.() ?? []) {
 			addUiReference(target, ownerPackageId, item.icon);
+			addUiReference(target, ownerPackageId, item.selectedIcon);
 			addUiReference(target, ownerPackageId, item.url);
+			addUnknownReferences(target, ownerPackageId, item.propertyOverrides?.map((property) => property.value));
 		}
+		addUnknownReferences(target, ownerPackageId, child.getPropertyOverrides?.().map((property) => property.value));
 		for (const gear of child.listGears?.() ?? []) {
 			addUnknownReferences(target, ownerPackageId, gear.getValues?.());
 			addUnknownReferences(target, ownerPackageId, gear.getDefaultValue?.());
@@ -138,7 +141,8 @@ function collectPackageResourceReferences(pkg) {
 		localResourceIds: /* @__PURE__ */ new Set(),
 		packageIds: /* @__PURE__ */ new Set()
 	};
-	for (const resource of pkg.listResources()) if (resource.propertyType === "Component") collectComponentReferences(references, pkg.getId(), resource);
+	const excludedResourceIds = new Set(pkg.getSourceAtlasSettings().excludedResourceIds);
+	for (const resource of pkg.listResources()) if (resource.propertyType === "Component" && !excludedResourceIds.has(resource.getId())) collectComponentReferences(references, pkg.getId(), resource);
 	return references;
 }
 //#endregion
@@ -165,6 +169,9 @@ function isFontResource(resource) {
 function isSoundResource(resource) {
 	return resource.propertyType === "SoundResource";
 }
+function isSwfResource(resource) {
+	return resource.propertyType === "SwfResource";
+}
 function isSpineResource(resource) {
 	return resource.propertyType === "SpineResource";
 }
@@ -206,10 +213,12 @@ function extname(fileName) {
 	return normalized.slice(lastDot);
 }
 function resolvePublishedMiscFileName(resource, projectType) {
-	const file = resource.getFile();
-	if (projectType !== UNITY_PROJECT_TYPE$1) return file;
-	if (file.toLowerCase().endsWith(".atlas")) return `${file}.txt`;
-	return file;
+	const fileName = `${getPublishedId(resource)}${extname(resource.getFile())}`;
+	if (projectType === UNITY_PROJECT_TYPE$1 && fileName.toLowerCase().endsWith(".atlas")) return `${fileName}.txt`;
+	return fileName;
+}
+function resolvePublishedSwfFileName(resource) {
+	return `${getPublishedId(resource)}${extname(resource.getFile()) || ".swf"}`;
 }
 function resolvePublishedSkeletonFileName(resource, projectType) {
 	if (projectType === UNITY_PROJECT_TYPE$1 && isSpineResource(resource) && resource.getFile().toLowerCase().endsWith(".skel")) return `${resource.getFile()}.bytes`;
@@ -276,16 +285,16 @@ function trimTrailingMissingHighResolutionIds(ids) {
 	while (ids.length > 0 && !ids[ids.length - 1]) ids.pop();
 	return ids;
 }
-function collectHighResolutionItemIds(resources, publishedResourceIds, includeHighResolution) {
+function collectHighResolutionItemIds(resources, publishedResourceIds, includeHighResolution, excludedResourceIds) {
 	const result = /* @__PURE__ */ new Map();
 	if (includeHighResolution <= 0) return result;
 	const highResolutionResourceByKey = /* @__PURE__ */ new Map();
 	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;
 		const ids = [];
@@ -310,6 +319,7 @@ function collectHighResolutionItemIds(resources, publishedResourceIds, includeHi
 }
 function collectPackagePublishContext(pkg, options) {
 	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 = /* @__PURE__ */ new Set();
@@ -321,10 +331,15 @@ function collectPackagePublishContext(pkg, options) {
 		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;
 				}
@@ -332,7 +347,7 @@ function collectPackagePublishContext(pkg, options) {
 		}
 		return exportedResourceIds;
 	};
-	for (const atlas of pkg.listAtlases()) for (const sprite of atlas.listSprites()) spriteItemIds.add(sprite.getItemId());
+	for (const atlas of pkg.listAtlases()) for (const sprite of atlas.listSprites()) if (!excludedResourceIds.has(sprite.getItemId())) spriteItemIds.add(sprite.getItemId());
 	for (const resource of resources) {
 		if (!isComponentResource(resource)) continue;
 		const component = resource;
@@ -341,7 +356,7 @@ function collectPackagePublishContext(pkg, options) {
 		const hitTest = component.getHitTest?.()?.trim();
 		if (hitTest && !hitTest.includes(",")) {
 			const sourceId = childMap.get(hitTest)?.getSrc?.();
-			if (sourceId) {
+			if (sourceId && !excludedResourceIds.has(sourceId)) {
 				const sourceResource = resourceMap.get(sourceId);
 				if (sourceResource && isImageResource(sourceResource)) pixelHitTestImageIds.add(sourceId);
 			}
@@ -350,7 +365,7 @@ function collectPackagePublishContext(pkg, options) {
 	const publishedResourceIds = new Set(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);
 			continue;
@@ -374,7 +389,7 @@ function collectPackagePublishContext(pkg, options) {
 		if (resource.getExported() || referencedIds.has(resourceId)) publishedResourceIds.add(resourceId);
 	}
 	for (const resourceId of collectExportedResourceIds(resources, publishedResourceIds)) publishedResourceIds.add(resourceId);
-	const highResolutionItemIds = collectHighResolutionItemIds(resources, publishedResourceIds, options.includeHighResolution);
+	const highResolutionItemIds = collectHighResolutionItemIds(resources, publishedResourceIds, options.includeHighResolution, excludedResourceIds);
 	if (!options.includeBranches) {
 		const mainByKey = /* @__PURE__ */ new Map();
 		const activeBranchByKey = /* @__PURE__ */ new Map();
@@ -502,6 +517,10 @@ async function annotatePackagePublishArtifacts(pkg, basePath, encoder, options)
 			setPublishedFileExtra(resource, resolvePublishedMiscFileName(resource, options.projectType));
 			continue;
 		}
+		if (isSwfResource(resource)) {
+			setPublishedFileExtra(resource, resolvePublishedSwfFileName(resource));
+			continue;
+		}
 		if (isSkeletonResource(resource)) setPublishedFileExtra(resource, resolvePublishedSkeletonFileName(resource, options.projectType));
 	}
 }
@@ -1760,7 +1779,7 @@ function packAtlasPages(inputs, options, forceSinglePage, sizeOverrides) {
 	});
 	return 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,
@@ -1860,7 +1879,7 @@ async function writeAtlasPageImage(pkg, inputs, page, atlasFileName, encoder, op
 		}
 	}
 	const outputFile = `${options.outputPath}/${atlasFileName}`;
-	await encoder({ create: {
+	const atlasPipeline = encoder({ create: {
 		width: page.width,
 		height: page.height,
 		channels: 4,
@@ -1870,7 +1889,13 @@ async function writeAtlasPageImage(pkg, inputs, page, atlasFileName, encoder, op
 			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)`);
 }
 function inputToCompatRect(input, index) {
@@ -1920,6 +1945,9 @@ function resolveDirectOutputAtlasSize(width, height, options) {
 	if (options.powerOfTwo) {
 		resolvedWidth = nextPow2(resolvedWidth);
 		resolvedHeight = nextPow2(resolvedHeight);
+	} else if (options.multipleOfFour) {
+		resolvedWidth = roundUpToMultiple(resolvedWidth, 4);
+		resolvedHeight = roundUpToMultiple(resolvedHeight, 4);
 	}
 	return {
 		width: resolvedWidth,
@@ -2034,9 +2062,8 @@ function sortResourcesByOrder(resources, orderMap, inputOrderMap) {
 	});
 	return ordered;
 }
-function getResourceTextureSetMode(resource) {
-	if (isImageResource(resource)) return parseTextureSetMode(resource.getTextureSetMode?.());
-	return parseTextureSetMode(resource.getTextureSetMode?.());
+function getResourceTextureSetMode(resource, maxAtlasIndex) {
+	return parseTextureSetMode(resource.getTextureSetMode?.(), maxAtlasIndex);
 }
 function groupStandaloneInputs(doc, inputs, options) {
 	const autoInputs = [];
@@ -2055,7 +2082,7 @@ function groupStandaloneInputs(doc, inputs, options) {
 	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 key = `${branchName}\u0000${getPublishedItemId(input.resource)}`;
 			const existing = standaloneGroups.get(key);
@@ -2099,6 +2126,8 @@ const ATLAS_DEFAULTS = {
 	allowRotation: true,
 	padding: 1,
 	powerOfTwo: false,
+	maxAtlasIndex: 10,
+	multipleOfFour: false,
 	square: false,
 	multiPage: true,
 	trimImage: false,
@@ -2182,7 +2211,7 @@ async function resolveEditorCompatibleResourceOrder(pkg, allResources, options)
 			const refChild = child;
 			await addResource(resourceMap.get(refChild.getSrc?.() ?? ""));
 			for (const ref of [
-				refChild.getUrl?.(),
+				refChild.getClearOnPublish?.() ? void 0 : refChild.getUrl?.(),
 				refChild.getDefaultItem?.(),
 				refChild.getIcon?.(),
 				refChild.getSelectedIcon?.(),
@@ -2196,11 +2225,14 @@ async function resolveEditorCompatibleResourceOrder(pkg, allResources, options)
 				refChild.getInstanceIcon?.(),
 				refChild.getInstanceSelectedIcon?.()
 			]) await addResourceByLocalUiUrl(ref);
-			for (const item of refChild.getInstanceComboItems?.() ?? []) await addResourceByLocalUiUrl(item.icon ?? void 0);
-			for (const item of refChild.getListItems?.() ?? []) {
+			for (const item of refChild.getInstanceAutoClearItems?.() ? [] : refChild.getInstanceComboItems?.() ?? []) await addResourceByLocalUiUrl(item.icon ?? void 0);
+			for (const item of refChild.getAutoClearItems?.() ? [] : refChild.getListItems?.() ?? []) {
 				await addResourceByLocalUiUrl(item.icon ?? void 0);
+				await addResourceByLocalUiUrl(item.selectedIcon ?? void 0);
 				await addResourceByLocalUiUrl(item.url ?? void 0);
+				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);
 		}
 		for (const ref of [
@@ -2451,23 +2483,32 @@ const FGUI_TYPESCRIPT_RUNTIME_TYPES = new Set([
 	"GTree",
 	"Transition"
 ]);
-const SHARED_FGUI_TYPESCRIPT_VARIANT = {
+const LAYABOX_TYPESCRIPT_VARIANT = {
 	binderMethod: "setExtension",
-	runtimeNamespace: "fgui"
+	runtimeNamespace: "fgui",
+	runtimeImport: ""
+};
+const COCOS_CREATOR_TYPESCRIPT_VARIANT = {
+	...LAYABOX_TYPESCRIPT_VARIANT,
+	runtimeImport: "import * as fgui from \"fairygui-cc\";"
 };
 async function publishCodeGeneration(doc, options) {
 	const logger = doc.getLogger();
 	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) try {
-			await plugin.plugin.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)}`);
+		for (const plugin of plugins) {
+			const genCode = plugin.plugin.genCode;
+			if (!genCode) continue;
+			try {
+				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)}`);
+			}
 		}
 		if (handled) return;
 	}
@@ -2531,8 +2572,9 @@ function supportsCodeGenerationLane(doc, codeType) {
 }
 function resolveFguiTypescriptVariant(doc) {
 	const projectType = doc.getRoot().getProjectType();
-	if (projectType !== _openfairygui_core.ProjectType.LayaBox && projectType !== _openfairygui_core.ProjectType.CocosCreator) return null;
-	return SHARED_FGUI_TYPESCRIPT_VARIANT;
+	if (projectType === _openfairygui_core.ProjectType.LayaBox) return LAYABOX_TYPESCRIPT_VARIANT;
+	if (projectType === _openfairygui_core.ProjectType.CocosCreator) return COCOS_CREATOR_TYPESCRIPT_VARIANT;
+	return null;
 }
 async function generateUnityCode(doc, pkg, plan, fs) {
 	const packageDir = fs.join(plan.outputDir, plan.packageFolderName);
@@ -2715,7 +2757,8 @@ function renderFguiTypescriptComponentClass(classInfo, plan, variant) {
 }
 function renderFguiTypescriptBinder(classes, plan, variant) {
 	const bindLines = classes.map((classInfo) => `\t\t${variant.runtimeNamespace}.UIObjectFactory.${variant.binderMethod}(${classInfo.encodedClassName}.URL, ${classInfo.encodedClassName});`).join("\n");
-	const importLines = classes.map((classInfo) => `import ${classInfo.encodedClassName} from "./${classInfo.encodedClassName}";`).join("\n");
+	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,
 		bindLines: bindLines ? `${bindLines}\n` : "",
@@ -2779,6 +2822,7 @@ function normalizeTypeName(value) {
 }
 function collectFguiTypescriptImports(classInfo, variant) {
 	const imports = /* @__PURE__ */ new Set();
+	if (variant.runtimeImport) imports.add(variant.runtimeImport);
 	for (const member of classInfo.members) {
 		if (member.ignored) continue;
 		const translated = translateFguiTypescriptType(member.type, variant);
@@ -2841,23 +2885,24 @@ async function exportPackageExternalResources(pkg, outputDir, basePath, fs, read
 	if (exportedResourceIds.size === 0) return;
 	if (!basePath || !readFileRaw) {
 		if (pkg.listResources().some((resource) => {
-			return (isMiscResource(resource) || isSkeletonResource(resource)) && exportedResourceIds.has(resource.getId()) || skeletonDependencyImageIds.has(resource.getId());
+			return (isMiscResource(resource) || isSwfResource(resource) || isSkeletonResource(resource)) && exportedResourceIds.has(resource.getId()) || skeletonDependencyImageIds.has(resource.getId());
 		})) throw new Error(`publish: External resources in package "${pkg.getName()}" require basePath and readFileRaw for output.`);
 		return;
 	}
 	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;
 		let targetName;
 		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 = (resource.getExtras() ?? {})._publishedFile ?? resource.getFile();
+			const publishedFile = (resource.getExtras() ?? {})._publishedFile ?? resource.getFile();
+			targetName = isMiscResource(resource) || isSwfResource(resource) ? `${pkg.getPublishName() || pkg.getName()}_${publishedFile}` : publishedFile;
 		} else continue;
 		const targetPath = fs.join(outputDir, targetName);
 		try {
@@ -2900,14 +2945,17 @@ function resolvePublishOptions(doc, overrides = {}) {
 	const projectType = overrides.targetProjectType ?? root.getProjectType();
 	const explicitLayaboxTarget = overrides.targetProjectType === _openfairygui_core.ProjectType.LayaBox;
 	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 = {
 		maxSize: overrides.atlas?.maxSize ?? atlasSetting.maxSize ?? 2048,
 		fast: overrides.atlas?.fast ?? atlasSetting.fast ?? true,
 		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,
@@ -3027,6 +3075,19 @@ function publish(options) {
 				}
 			}
 			const publishName = pkg.getPublishName() || pkg.getName();
+			const sourceAtlas = pkg.getSourceAtlasSettings();
+			const usePackageAtlas = !sourceAtlas.useGlobal;
+			const atlas = {
+				...config.atlas,
+				maxSize: options.atlas?.maxSize ?? (usePackageAtlas ? sourceAtlas.maxSize : config.atlas.maxSize),
+				allowRotation: config.projectType === _openfairygui_core.ProjectType.LayaBox ? false : options.atlas?.allowRotation ?? (usePackageAtlas ? sourceAtlas.allowRotation : config.atlas.allowRotation),
+				powerOfTwo: options.atlas?.powerOfTwo ?? (usePackageAtlas ? sourceAtlas.sizeOption === "pot" : config.atlas.powerOfTwo),
+				maxAtlasIndex: options.atlas?.maxAtlasIndex ?? sourceAtlas.maxIndex,
+				multipleOfFour: options.atlas?.multipleOfFour ?? (usePackageAtlas ? sourceAtlas.sizeOption === "mof" : config.atlas.multipleOfFour),
+				square: options.atlas?.square ?? (usePackageAtlas ? sourceAtlas.forceSquare : config.atlas.square),
+				multiPage: options.atlas?.multiPage ?? (usePackageAtlas ? sourceAtlas.paging : config.atlas.multiPage),
+				extractAlpha: config.projectType === _openfairygui_core.ProjectType.Unity && (options.atlas?.extractAlpha ?? (usePackageAtlas || sourceAtlas.extractAlpha ? sourceAtlas.extractAlpha : config.atlas.extractAlpha))
+			};
 			return {
 				pkg,
 				outputDir,
@@ -3038,7 +3099,7 @@ function publish(options) {
 				activeBranch: config.activeBranch,
 				includeHighResolution: config.includeHighResolution,
 				separatedAtlasForBranch: config.separatedAtlasForBranch,
-				atlas: config.atlas
+				atlas
 			};
 		};
 		const createNoopPublishFs = () => ({
@@ -3058,7 +3119,6 @@ function publish(options) {
 			const atlasRuntimeOptions = resolvePublishAtlasRuntimeOptions(plan.fileExtension);
 			await atlas({
 				...plan.atlas,
-				...options.atlas ?? {},
 				separatedAtlasForBranch: plan.separatedAtlasForBranch,
 				encoder: options.encoder,
 				basePath: options.basePath,

package/dist/{restore-C8FYrc7J.d.cts → restore-BOfsCM47.d.ts}

@@ -1,4 +1,4 @@
-import { l as PublishFileSystem, r as AtlasRasterBackend, t as AtlasOptions } from "./atlas-CHsu2Y8i.cjs";
+import { l as PublishFileSystem, r as AtlasRasterBackend, t as AtlasOptions } from "./atlas-BtWa1DwO.js";
 import { Component, Document, FileSystem, Package, ProjectSettings, PublishSettings, Transform } from "@openfairygui/core";
 
 //#region src/publish/options.d.ts
@@ -59,7 +59,7 @@ interface PublishOptions {
    */
   codeGeneration?: boolean;
 }
-interface ResolvedPublishAtlasOptions extends Pick<AtlasOptions, 'maxSize' | 'fast' | 'allowRotation' | 'padding' | 'powerOfTwo' | 'square' | 'multiPage' | 'trimImage' | 'extractAlpha'> {}
+interface ResolvedPublishAtlasOptions extends Pick<AtlasOptions, 'maxSize' | 'fast' | 'allowRotation' | 'padding' | 'powerOfTwo' | 'maxAtlasIndex' | 'multipleOfFour' | 'square' | 'multiPage' | 'trimImage' | 'extractAlpha'> {}
 interface ResolvePublishOptionsOverrides {
   /** Select a target profile between direct overrides and persisted project settings. */
   targetProjectType?: number;
@@ -212,7 +212,7 @@ interface ResolvedPackageCodegenPlan {
   packageFolderName: string;
   packageNamespace: string;
   binderClassName: string;
-  settings: CliCodeGenerationSettings;
+  settings: Required<CliCodeGenerationSettings>;
 }
 interface CodegenMember {
   index: number;
@@ -238,7 +238,7 @@ interface CodegenClass {
   members: CodegenMember[];
 }
 declare function publishCodeGeneration(doc: Document, options: PublishCodeGenerationOptions): Promise<void>;
-declare function resolvePackageCodegenPlan(pkg: Package, settings: CliCodeGenerationSettings, options: PublishCodeGenerationOptions): ResolvedPackageCodegenPlan | null;
+declare function resolvePackageCodegenPlan(pkg: Package, settings: Required<CliCodeGenerationSettings>, options: PublishCodeGenerationOptions): ResolvedPackageCodegenPlan | null;
 declare function buildCodegenClasses(doc: Document, pkg: Package, plan: ResolvedPackageCodegenPlan): CodegenClass[];
 declare function encodeText(value: string): Uint8Array;
 declare function decodeText(value: Uint8Array): string;

package/dist/{restore-BXJjaSMN.cjs → restore-CLlkcYIw.cjs}

@@ -1,4 +1,4 @@
-const require_publish = require("./publish-Cl1b5HtO.cjs");
+const require_publish = require("./publish-BHoaYgPU.cjs");
 let _openfairygui_core = require("@openfairygui/core");
 //#region src/restore-internals/output-transaction.ts
 function isPathWithin(root, candidate) {

package/dist/{restore-D7RtsnWd.d.ts → restore-D6F1ELdM.d.cts}

@@ -1,4 +1,4 @@
-import { l as PublishFileSystem, r as AtlasRasterBackend, t as AtlasOptions } from "./atlas-C6tbl7nn.js";
+import { l as PublishFileSystem, r as AtlasRasterBackend, t as AtlasOptions } from "./atlas-CSqHsG0X.cjs";
 import { Component, Document, FileSystem, Package, ProjectSettings, PublishSettings, Transform } from "@openfairygui/core";
 
 //#region src/publish/options.d.ts
@@ -59,7 +59,7 @@ interface PublishOptions {
    */
   codeGeneration?: boolean;
 }
-interface ResolvedPublishAtlasOptions extends Pick<AtlasOptions, 'maxSize' | 'fast' | 'allowRotation' | 'padding' | 'powerOfTwo' | 'square' | 'multiPage' | 'trimImage' | 'extractAlpha'> {}
+interface ResolvedPublishAtlasOptions extends Pick<AtlasOptions, 'maxSize' | 'fast' | 'allowRotation' | 'padding' | 'powerOfTwo' | 'maxAtlasIndex' | 'multipleOfFour' | 'square' | 'multiPage' | 'trimImage' | 'extractAlpha'> {}
 interface ResolvePublishOptionsOverrides {
   /** Select a target profile between direct overrides and persisted project settings. */
   targetProjectType?: number;
@@ -212,7 +212,7 @@ interface ResolvedPackageCodegenPlan {
   packageFolderName: string;
   packageNamespace: string;
   binderClassName: string;
-  settings: CliCodeGenerationSettings;
+  settings: Required<CliCodeGenerationSettings>;
 }
 interface CodegenMember {
   index: number;
@@ -238,7 +238,7 @@ interface CodegenClass {
   members: CodegenMember[];
 }
 declare function publishCodeGeneration(doc: Document, options: PublishCodeGenerationOptions): Promise<void>;
-declare function resolvePackageCodegenPlan(pkg: Package, settings: CliCodeGenerationSettings, options: PublishCodeGenerationOptions): ResolvedPackageCodegenPlan | null;
+declare function resolvePackageCodegenPlan(pkg: Package, settings: Required<CliCodeGenerationSettings>, options: PublishCodeGenerationOptions): ResolvedPackageCodegenPlan | null;
 declare function buildCodegenClasses(doc: Document, pkg: Package, plan: ResolvedPackageCodegenPlan): CodegenClass[];
 declare function encodeText(value: string): Uint8Array;
 declare function decodeText(value: Uint8Array): string;

package/dist/{restore-teyQ9DXH.js → restore-DovUbh5F.js}

@@ -1,4 +1,4 @@
-import { d as basename, f as normalizeComparablePath, p as trimTrailingSlashes } from "./publish-Ni90AtjG.js";
+import { d as basename, f as normalizeComparablePath, p as trimTrailingSlashes } from "./publish-BCzpqNr9.js";
 import { BinaryReader, ProjectType, ProjectWriter, generateId } from "@openfairygui/core";
 //#region src/restore-internals/output-transaction.ts
 function isPathWithin(root, candidate) {

package/dist/web.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_publish = require("./publish-Cl1b5HtO.cjs");
+const require_publish = require("./publish-BHoaYgPU.cjs");
 let _openfairygui_core = require("@openfairygui/core");
 let fast_xml_parser = require("fast-xml-parser");
 //#region src/adapters/web/raster.ts
@@ -216,6 +216,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 } 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 } 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,4 +1,4 @@
-import { c as resolveCodeGenerationSettings, n as resolvePublishOptions, t as publish } from "./publish-Ni90AtjG.js";
+import { c as resolveCodeGenerationSettings, n as resolvePublishOptions, t as publish } from "./publish-BCzpqNr9.js";
 import { ProjectType } from "@openfairygui/core";
 import { XMLParser, XMLValidator } from "fast-xml-parser";
 //#region src/adapters/web/raster.ts
@@ -215,6 +215,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);