@openfairygui/functions 0.3.0-alpha.4 → 0.3.1

package/dist/{publish-C7qHwEiP.cjs → publish-DhMv_lEP.cjs}

@@ -24,7 +24,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",
@@ -47,7 +47,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
@@ -105,9 +105,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?.(),
@@ -121,11 +121,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?.());
@@ -155,7 +158,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
@@ -182,6 +186,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";
 }
@@ -223,10 +230,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`;
@@ -293,16 +302,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 = [];
@@ -327,6 +336,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();
@@ -338,10 +348,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;
 				}
@@ -349,7 +364,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;
@@ -358,7 +373,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);
 			}
@@ -367,7 +382,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;
@@ -391,7 +406,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();
@@ -519,6 +534,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));
 	}
 }
@@ -1777,7 +1796,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,
@@ -1877,7 +1896,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,
@@ -1887,7 +1906,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) {
@@ -1937,6 +1962,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,
@@ -2051,9 +2079,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 = [];
@@ -2072,7 +2099,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);
@@ -2116,6 +2143,8 @@ const ATLAS_DEFAULTS = {
 	allowRotation: true,
 	padding: 1,
 	powerOfTwo: false,
+	maxAtlasIndex: 10,
+	multipleOfFour: false,
 	square: false,
 	multiPage: true,
 	trimImage: false,
@@ -2199,7 +2228,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?.(),
@@ -2213,11 +2242,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 [
@@ -2407,6 +2439,9 @@ const FGUI_TYPESCRIPT_BINDER_TEMPLATE = `{{generatedMark}}
 function formatPluginError(error) {
 	return error instanceof Error ? error.message : String(error);
 }
+function shouldAbortPluginFailure(plugin) {
+	return plugin.failureMode !== "warn";
+}
 //#endregion
 //#region src/path-utils.ts
 function trimTrailingSlashes(value) {
@@ -2468,23 +2503,34 @@ 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) {
+				const message = `publish: Code generation plugin "${plugin.name}" failed: ${formatPluginError(error)}`;
+				if (shouldAbortPluginFailure(plugin)) throw new Error(message);
+				logger.warn(message);
+			}
 		}
 		if (handled) return;
 	}
@@ -2548,8 +2594,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);
@@ -2732,7 +2779,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` : "",
@@ -2796,6 +2844,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);
@@ -2858,23 +2907,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 {
@@ -2914,16 +2964,20 @@ function resolvePublishOptions(doc, overrides = {}) {
 	const root = doc.getRoot();
 	const publishSettings = (root.getSettings?.() ?? {}).publish ?? {};
 	const atlasSetting = publishSettings.atlasSetting ?? {};
-	const projectType = root.getProjectType();
-	const fileExtension = overrides.fileExtension ?? resolveDefaultPublishFileExtension(projectType, publishSettings);
-	let compressed = overrides.compressed ?? publishSettings.compressDesc ?? false;
-	if (projectType === UNITY_PROJECT_TYPE) compressed = overrides.compressed ?? false;
+	const projectType = overrides.targetProjectType ?? root.getProjectType();
+	const explicitLayaboxTarget = overrides.targetProjectType === _openfairygui_core.ProjectType.LayaBox;
+	const fileExtension = overrides.fileExtension ?? (explicitLayaboxTarget ? "fui" : resolveDefaultPublishFileExtension(projectType, publishSettings));
+	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 ?? 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,
@@ -2946,7 +3000,9 @@ async function runPublishPluginHook(plugins, hook, doc, options) {
 		try {
 			await fn(doc, options);
 		} catch (error) {
-			logger.warn(`publish: Plugin "${plugin.name}" ${hook} failed: ${formatPluginError(error)}`);
+			const message = `publish: Plugin "${plugin.name}" ${hook} failed: ${formatPluginError(error)}`;
+			if (shouldAbortPluginFailure(plugin)) throw new Error(message);
+			logger.warn(message);
 		}
 	}
 }
@@ -3043,6 +3099,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,
@@ -3054,7 +3123,7 @@ function publish(options) {
 				activeBranch: config.activeBranch,
 				includeHighResolution: config.includeHighResolution,
 				separatedAtlasForBranch: config.separatedAtlasForBranch,
-				atlas: config.atlas
+				atlas
 			};
 		};
 		const createNoopPublishFs = () => ({
@@ -3074,7 +3143,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-BeWaJNjR.d.cts → restore-CbscKkNw.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,8 +59,10 @@ 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;
   compressed?: boolean;
   fileExtension?: string;
   packages?: string[];
@@ -164,6 +166,8 @@ interface PluginManifest {
   };
   icon?: string;
   main: string;
+  required?: boolean;
+  failureMode?: 'abort' | 'warn';
 }
 interface ICodeWriterConfig {
   blockStart?: string;
@@ -192,6 +196,7 @@ interface Plugin {
 interface LoadedPlugin {
   name: string;
   plugin: Plugin;
+  failureMode?: 'abort' | 'warn';
 }
 type PluginModule = Plugin & {
   default?: Plugin;
@@ -210,7 +215,7 @@ interface ResolvedPackageCodegenPlan {
   packageFolderName: string;
   packageNamespace: string;
   binderClassName: string;
-  settings: CliCodeGenerationSettings;
+  settings: Required<CliCodeGenerationSettings>;
 }
 interface CodegenMember {
   index: number;
@@ -236,7 +241,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-DVo1hXpN.js → restore-DB_L_xq4.js}

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

package/dist/{restore-Dh0-Nvms.d.ts → restore-k3oX26Fs.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,8 +59,10 @@ 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;
   compressed?: boolean;
   fileExtension?: string;
   packages?: string[];
@@ -164,6 +166,8 @@ interface PluginManifest {
   };
   icon?: string;
   main: string;
+  required?: boolean;
+  failureMode?: 'abort' | 'warn';
 }
 interface ICodeWriterConfig {
   blockStart?: string;
@@ -192,6 +196,7 @@ interface Plugin {
 interface LoadedPlugin {
   name: string;
   plugin: Plugin;
+  failureMode?: 'abort' | 'warn';
 }
 type PluginModule = Plugin & {
   default?: Plugin;
@@ -210,7 +215,7 @@ interface ResolvedPackageCodegenPlan {
   packageFolderName: string;
   packageNamespace: string;
   binderClassName: string;
-  settings: CliCodeGenerationSettings;
+  settings: Required<CliCodeGenerationSettings>;
 }
 interface CodegenMember {
   index: number;
@@ -236,7 +241,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-LXbDQqmT.cjs → restore-n61oZ4nw.cjs}

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