@openfairygui/cli 0.3.0-alpha.4 → 0.3.1

package/dist/cli.mjs

@@ -730,6 +730,14 @@ var Property = class extends GraphNode {
 		if (Array.isArray(value)) value = value.slice();
 		return super.set(attribute, value);
 	}
+	/** @hidden */
+	getExtendedLiteral(attribute) {
+		return super.get(attribute);
+	}
+	/** @hidden */
+	setExtendedLiteral(attribute, value) {
+		return super.set(attribute, value.slice());
+	}
 	getName() {
 		return this.get("name");
 	}
@@ -737,10 +745,10 @@ var Property = class extends GraphNode {
 		return this.set("name", name);
 	}
 	getExtras() {
-		return this.get("extras");
+		return structuredClone(this.get("extras"));
 	}
 	setExtras(extras) {
-		return this.set("extras", extras);
+		return this.set("extras", structuredClone(extras));
 	}
 	clone() {
 		const PropertyClass = this.constructor;
@@ -821,7 +829,7 @@ var ExtensibleProperty = class extends Property {
 };
 //#endregion
 //#region ../core/src/constants.ts
-const VERSION = `v0.3.0-alpha.4`;
+const VERSION = `v0.3.1`;
 /** Binary package file magic number: "FGUI" as uint32. */
 const FGUI_MAGIC = 1179080009;
 /** Null string index in the binary string table. */
@@ -837,6 +845,7 @@ let PropertyType = /* @__PURE__ */ function(PropertyType) {
 	PropertyType["SOUND_RESOURCE"] = "SoundResource";
 	PropertyType["FONT_RESOURCE"] = "FontResource";
 	PropertyType["MOVIE_CLIP_RESOURCE"] = "MovieClipResource";
+	PropertyType["SWF_RESOURCE"] = "SwfResource";
 	PropertyType["SPINE_RESOURCE"] = "SpineResource";
 	PropertyType["DRAGON_BONES_RESOURCE"] = "DragonBonesResource";
 	PropertyType["COMPONENT"] = "Component";
@@ -1210,10 +1219,10 @@ var Root = class extends ExtensibleProperty {
 		return this.setBranches([...this.listBranches(), branch]);
 	}
 	getSettings() {
-		return this.get("settings");
+		return structuredClone(this.get("settings"));
 	}
 	setSettings(settings) {
-		return this.set("settings", settings);
+		return this.set("settings", structuredClone(settings));
 	}
 	/****** Extensions ******/
 	listExtensionsUsed() {
@@ -1479,10 +1488,10 @@ var ImageResource = class extends ExtensibleProperty {
 		return this.set("branchItemIds", [...ids]);
 	}
 	getHighResolutionItemIds() {
-		return [...this.get("highResolutionItemIds")];
+		return [...this.getExtendedLiteral("highResolutionItemIds")];
 	}
 	setHighResolutionItemIds(ids) {
-		return this.set("highResolutionItemIds", [...ids]);
+		return this.setExtendedLiteral("highResolutionItemIds", ids);
 	}
 	getWidth() {
 		return this.get("width");
@@ -1955,10 +1964,10 @@ var MovieClipResource = class extends ExtensibleProperty {
 		return this.set("branchItemIds", [...ids]);
 	}
 	getHighResolutionItemIds() {
-		return [...this.get("highResolutionItemIds")];
+		return [...this.getExtendedLiteral("highResolutionItemIds")];
 	}
 	setHighResolutionItemIds(ids) {
-		return this.set("highResolutionItemIds", [...ids]);
+		return this.setExtendedLiteral("highResolutionItemIds", ids);
 	}
 	getFileName() {
 		return this.get("fileName");
@@ -2038,6 +2047,74 @@ var MovieClipResource = class extends ExtensibleProperty {
 	}
 };
 //#endregion
+//#region ../core/src/properties/swf-resource.ts
+/** A SWF resource within a FairyGUI package. */
+var SwfResource = class extends ExtensibleProperty {
+	init() {
+		this.propertyType = PropertyType.SWF_RESOURCE;
+	}
+	getDefaults() {
+		return Object.assign(super.getDefaults(), {
+			id: "",
+			path: "",
+			branch: "",
+			branchItemIds: [],
+			file: "",
+			exported: false,
+			favorite: false,
+			resourceData: null
+		});
+	}
+	getId() {
+		return this.get("id");
+	}
+	setId(id) {
+		return this.set("id", id);
+	}
+	getPath() {
+		return this.get("path");
+	}
+	setPath(path) {
+		return this.set("path", path);
+	}
+	getBranch() {
+		return this.get("branch");
+	}
+	setBranch(branch) {
+		return this.set("branch", branch);
+	}
+	getBranchItemIds() {
+		return [...this.get("branchItemIds")];
+	}
+	setBranchItemIds(ids) {
+		return this.set("branchItemIds", [...ids]);
+	}
+	getFile() {
+		return this.get("file");
+	}
+	setFile(file) {
+		return this.set("file", file);
+	}
+	getExported() {
+		return this.get("exported");
+	}
+	setExported(value) {
+		return this.set("exported", value);
+	}
+	getFavorite() {
+		return this.get("favorite");
+	}
+	setFavorite(value) {
+		return this.set("favorite", value);
+	}
+	getSourceData() {
+		return this.getRef("resourceData");
+	}
+	setSourceData(buffer) {
+		return this.setRef("resourceData", buffer);
+	}
+};
+//#endregion
 //#region ../core/src/properties/skeleton-resource-base.ts
 /**
 * Shared base for skeleton-style package resources.
@@ -2186,9 +2263,24 @@ var DragonBonesResource = class extends SkeletonResourceBase {
 * @category Properties
 */
 var Component = class extends ExtensibleProperty {
+	_binaryDirty = true;
 	init() {
 		this.propertyType = PropertyType.COMPONENT;
 	}
+	/** @internal */
+	_markBinaryClean() {
+		this._binaryDirty = false;
+		return this;
+	}
+	/** @internal */
+	_markBinaryDirty() {
+		this._binaryDirty = true;
+		return this;
+	}
+	/** @internal */
+	_isBinaryDirty() {
+		return this._binaryDirty;
+	}
 	getDefaults() {
 		return Object.assign(super.getDefaults(), {
 			id: "",
@@ -2234,13 +2326,17 @@ var Component = class extends ExtensibleProperty {
 			footerRes: "",
 			bgColor: "",
 			bgColorEnabled: false,
-			designImageAlpha: 0,
+			designImageAlpha: 50,
 			designImageLayer: 0,
 			designImageOffsetX: 0,
 			designImageOffsetY: 0,
+			designImage: "",
+			designImageForTest: false,
+			pageController: "",
 			idNum: 0,
 			initName: "",
 			remark: "",
+			customExtensionId: "",
 			extensionType: "",
 			buttonMode: 0,
 			sound: "",
@@ -2527,6 +2623,24 @@ var Component = class extends ExtensibleProperty {
 	setDesignImageOffsetY(v) {
 		return this.set("designImageOffsetY", v);
 	}
+	getDesignImage() {
+		return this.get("designImage");
+	}
+	setDesignImage(v) {
+		return this.set("designImage", v);
+	}
+	getDesignImageForTest() {
+		return this.get("designImageForTest");
+	}
+	setDesignImageForTest(v) {
+		return this.set("designImageForTest", v);
+	}
+	getPageController() {
+		return this.get("pageController");
+	}
+	setPageController(v) {
+		return this.set("pageController", v);
+	}
 	getIdNum() {
 		return this.get("idNum");
 	}
@@ -2545,6 +2659,12 @@ var Component = class extends ExtensibleProperty {
 	setRemark(v) {
 		return this.set("remark", v);
 	}
+	getCustomExtensionId() {
+		return this.get("customExtensionId");
+	}
+	setCustomExtensionId(v) {
+		return this.set("customExtensionId", v);
+	}
 	getExtensionType() {
 		return this.get("extensionType");
 	}
@@ -3542,6 +3662,7 @@ var GTextField = class extends GObject {
 			demoText: "",
 			templateVarsEnabled: false,
 			faceDilate: 0,
+			outlineSoftness: 0,
 			underlaySoftness: 0,
 			ubbEnabled: false,
 			underline: false,
@@ -3762,6 +3883,12 @@ var GTextField = class extends GObject {
 	setFaceDilate(v) {
 		return this.setTextFieldProp("faceDilate", v);
 	}
+	getOutlineSoftness() {
+		return this.getTextFieldProp("outlineSoftness");
+	}
+	setOutlineSoftness(v) {
+		return this.setTextFieldProp("outlineSoftness", v);
+	}
 	getUnderlaySoftness() {
 		return this.getTextFieldProp("underlaySoftness");
 	}
@@ -4293,6 +4420,7 @@ var GLoader = class extends GObject {
 			shrinkOnly: false,
 			autoSize: false,
 			useResize: false,
+			showErrorSign: false,
 			align: 0,
 			vAlign: 0,
 			frame: 0,
@@ -4430,6 +4558,12 @@ var GLoader = class extends GObject {
 	setUseResize(v) {
 		return this.set("useResize", v);
 	}
+	getShowErrorSign() {
+		return this.get("showErrorSign");
+	}
+	setShowErrorSign(v) {
+		return this.set("showErrorSign", v);
+	}
 	getAlign() {
 		return this.get("align");
 	}
@@ -4894,6 +5028,7 @@ var GComponent = class extends GObject {
 			instanceChecked: false,
 			instanceSound: "",
 			instanceSoundVolumeScale: 1,
+			instancePopupDirection: 0,
 			instancePromptText: "",
 			instanceSelectionController: "",
 			instanceVisibleItemCount: 0,
@@ -5180,6 +5315,12 @@ var GComponent = class extends GObject {
 	setInstanceSoundVolumeScale(v) {
 		return this.setComponentProp("instanceSoundVolumeScale", v);
 	}
+	getInstancePopupDirection() {
+		return this.getComponentProp("instancePopupDirection");
+	}
+	setInstancePopupDirection(v) {
+		return this.setComponentProp("instancePopupDirection", v);
+	}
 	getInstancePromptText() {
 		return firstString$1(this.getComponentProp("instancePromptText"));
 	}
@@ -5243,6 +5384,9 @@ var GComponent = class extends GObject {
 };
 //#endregion
 //#region ../core/src/properties/g-list.ts
+function getDefaultListAutoResizeItem(layout) {
+	return layout === ListLayoutType.SingleColumn || layout === ListLayoutType.SingleRow;
+}
 function firstString(value) {
 	if (Array.isArray(value)) return String(value[0] ?? "");
 	return String(value ?? "");
@@ -5275,12 +5419,13 @@ var GListBase = class extends GObject {
 			columnCount: 0,
 			selectionMode: ListSelectionMode.Single,
 			defaultItem: "",
-			autoResizeItem: true,
+			autoResizeItem: getDefaultListAutoResizeItem(ListLayoutType.SingleColumn),
 			childrenRenderOrder: 0,
 			apexIndex: 0,
 			src: "",
 			overflow: 0,
 			scrollType: 1,
+			scrollBarDisplay: 0,
 			scrollBarFlags: 0,
 			scrollBarMargin: [
 				0,
@@ -5483,6 +5628,12 @@ var GListBase = class extends GObject {
 	setScrollType(v) {
 		return this.setListProp("scrollType", v);
 	}
+	getScrollBarDisplay() {
+		return this.getListProp("scrollBarDisplay");
+	}
+	setScrollBarDisplay(v) {
+		return this.setListProp("scrollBarDisplay", v);
+	}
 	getScrollBarFlags() {
 		return this.getListProp("scrollBarFlags");
 	}
@@ -6441,6 +6592,10 @@ var Controller = class extends ExtensibleProperty {
 		return Object.assign(super.getDefaults(), {
 			selectedIndex: 0,
 			autoRadioGroupDepth: false,
+			alias: "",
+			exported: false,
+			homePageType: "default",
+			homePage: "",
 			pages: new RefList(),
 			actions: new RefList()
 		});
@@ -6457,6 +6612,30 @@ var Controller = class extends ExtensibleProperty {
 	setAutoRadioGroupDepth(v) {
 		return this.set("autoRadioGroupDepth", v);
 	}
+	getAlias() {
+		return this.get("alias");
+	}
+	setAlias(v) {
+		return this.set("alias", v);
+	}
+	getExported() {
+		return this.get("exported");
+	}
+	setExported(v) {
+		return this.set("exported", v);
+	}
+	getHomePageType() {
+		return this.get("homePageType");
+	}
+	setHomePageType(v) {
+		return this.set("homePageType", v);
+	}
+	getHomePage() {
+		return this.get("homePage");
+	}
+	setHomePage(v) {
+		return this.set("homePage", v);
+	}
 	addPage(page) {
 		return this.addRef("pages", page);
 	}
@@ -6490,7 +6669,10 @@ var ControllerPage = class extends Property {
 		this.propertyType = PropertyType.CONTROLLER_PAGE;
 	}
 	getDefaults() {
-		return Object.assign(super.getDefaults(), { id: "" });
+		return Object.assign(super.getDefaults(), {
+			id: "",
+			remark: ""
+		});
 	}
 	getId() {
 		return this.get("id");
@@ -6498,6 +6680,12 @@ var ControllerPage = class extends Property {
 	setId(id) {
 		return this.set("id", id);
 	}
+	getRemark() {
+		return this.get("remark");
+	}
+	setRemark(remark) {
+		return this.set("remark", remark);
+	}
 };
 //#endregion
 //#region ../core/src/properties/controller-action.ts
@@ -15611,7 +15799,6 @@ const { Deflate, deflate, deflateRaw, gzip } = deflate_1$1;
 const { Inflate, inflate, inflateRaw, ungzip } = inflate_1$1;
 var deflateRaw_1 = deflateRaw;
 var Inflate_1 = Inflate;
-var inflateRaw_1 = inflateRaw;
 //#endregion
 //#region ../core/src/utils/image-info.ts
 var import_jpeg_js = require_jpeg_js();
@@ -16007,6 +16194,99 @@ function probeRasterImageDimensions(data) {
 	return readPngInfo(data, false) ?? readJpegInfo(data, false);
 }
 //#endregion
+//#region ../core/src/utils/svg-validation.ts
+const MAX_SVG_SOURCE_BYTES = 8 * 1024 * 1024;
+const MAX_SVG_NODES = 5e4;
+const SVG_NAMESPACE = "http://www.w3.org/2000/svg";
+const XLINK_NAMESPACE = "http://www.w3.org/1999/xlink";
+const UNSAFE_SVG_ELEMENTS = new Set([
+	"a",
+	"animate",
+	"animatecolor",
+	"animatemotion",
+	"animatetransform",
+	"audio",
+	"canvas",
+	"discard",
+	"embed",
+	"feimage",
+	"foreignobject",
+	"iframe",
+	"image",
+	"object",
+	"script",
+	"set",
+	"style",
+	"video"
+]);
+function invalidSvg(message) {
+	throw new Error(`Invalid or unsafe SVG source (${message}).`);
+}
+function validateAttribute(name, value) {
+	const normalizedName = name.toLowerCase();
+	if (normalizedName === "xmlns") {
+		if (value !== SVG_NAMESPACE) invalidSvg("the default namespace must be SVG");
+		return;
+	}
+	if (normalizedName === "xmlns:xlink") {
+		if (value !== XLINK_NAMESPACE) invalidSvg("the xlink namespace is invalid");
+		return;
+	}
+	if (normalizedName.includes(":") && normalizedName !== "xlink:href" && normalizedName !== "xml:space") invalidSvg(`qualified attribute "${name}" is not allowed`);
+	const localName = normalizedName.split(":").at(-1);
+	const text = String(value);
+	if (localName.startsWith("on")) invalidSvg(`event attribute "${name}" is not allowed`);
+	if (localName === "style" || localName === "src") invalidSvg(`attribute "${name}" is not allowed`);
+	if (localName === "href" && !/^#[A-Za-z_][\w:.-]*$/u.test(text)) invalidSvg(`external reference in "${name}" is not allowed`);
+	if (/(?:^|[\s("'=])(?:https?:|file:|javascript:|data:|\/\/)/iu.test(text)) invalidSvg(`external URL in "${name}" is not allowed`);
+	for (const match of text.matchAll(/url\s*\(([^)]*)\)/giu)) {
+		const reference = (match[1] ?? "").trim().replace(/^(['"])(.*)\1$/u, "$2");
+		if (!/^#[A-Za-z_][\w:.-]*$/u.test(reference)) invalidSvg(`external url() in "${name}" is not allowed`);
+	}
+}
+/** Validate SVG bytes before handing them to a host image decoder. */
+function validateSafeSvgSource(bytes) {
+	if (bytes.byteLength === 0 || bytes.byteLength > MAX_SVG_SOURCE_BYTES) invalidSvg("source size is unsupported");
+	let source;
+	try {
+		source = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+	} catch {
+		invalidSvg("source is not valid UTF-8");
+	}
+	if (/<!\s*(?:doctype|entity)\b|<\?xml-stylesheet\b/iu.test(source)) invalidSvg("DTD, entities, and stylesheets are not allowed");
+	if (XMLValidator.validate(source, { allowBooleanAttributes: false }) !== true) invalidSvg("source is not well-formed XML");
+	const roots = new XMLParser({
+		preserveOrder: true,
+		ignoreAttributes: false,
+		attributeNamePrefix: "",
+		parseAttributeValue: false,
+		parseTagValue: false,
+		processEntities: false,
+		trimValues: false
+	}).parse(source).flatMap((entry) => Object.keys(entry).filter((name) => name !== ":@" && !name.startsWith("#") && !name.startsWith("?")).map((name) => ({
+		entry,
+		name
+	})));
+	if (roots.length !== 1 || roots[0].name !== "svg") invalidSvg("a single unqualified <svg> root is required");
+	if (roots[0].entry[":@"]?.xmlns !== SVG_NAMESPACE) invalidSvg("the SVG namespace is required");
+	const pending = [roots[0].entry];
+	let nodeCount = 0;
+	while (pending.length > 0) {
+		const current = pending.pop();
+		for (const [name, value] of Object.entries(current)) {
+			if (name === ":@" || name.startsWith("#") || name.startsWith("?")) continue;
+			if (++nodeCount > MAX_SVG_NODES) invalidSvg("node count exceeds the supported limit");
+			if (name.includes(":")) invalidSvg(`qualified element <${name}> is not allowed`);
+			if (UNSAFE_SVG_ELEMENTS.has(name.toLowerCase())) invalidSvg(`element <${name}> is not allowed`);
+			for (const [attributeName, attributeValue] of Object.entries(current[":@"] ?? {})) validateAttribute(attributeName, attributeValue);
+			if (Array.isArray(value)) {
+				for (const child of value) if (child && typeof child === "object" && !Array.isArray(child)) pending.push(child);
+			}
+		}
+	}
+	return source;
+}
+//#endregion
 //#region ../core/src/document.ts
 /**
 * Wraps a FairyGUI project and its resources for easier modification.
@@ -16033,12 +16313,32 @@ var Document = class Document {
 	_root = new Root(this._graph);
 	_logger = Logger.DEFAULT_INSTANCE;
 	_projectDir = "";
+	_hasBinaryComponents = false;
 	static _GRAPH_DOCUMENTS = /* @__PURE__ */ new WeakMap();
 	static fromGraph(graph) {
 		return Document._GRAPH_DOCUMENTS.get(graph) || null;
 	}
 	constructor() {
 		Document._GRAPH_DOCUMENTS.set(this._graph, this);
+		this._graph.addEventListener("node:change", (event) => {
+			if (!this._hasBinaryComponents) return;
+			const pending = [event.target];
+			const visited = /* @__PURE__ */ new Set();
+			while (pending.length > 0) {
+				const current = pending.pop();
+				if (visited.has(current)) continue;
+				visited.add(current);
+				if (current instanceof Component) {
+					current._markBinaryDirty();
+					continue;
+				}
+				pending.push(...current.listParents());
+			}
+		});
+	}
+	/** @internal */
+	_trackBinaryComponent() {
+		this._hasBinaryComponents = true;
 	}
 	getRoot() {
 		return this._root;
@@ -16090,6 +16390,9 @@ var Document = class Document {
 	createMovieClipResource(name = "") {
 		return new MovieClipResource(this._graph, name);
 	}
+	createSwfResource(name = "") {
+		return new SwfResource(this._graph, name);
+	}
 	createSpineResource(name = "") {
 		return new SpineResource(this._graph, name);
 	}
@@ -16345,6 +16648,7 @@ const TEXT_PROPERTY_KEYS = [
 	"autoSize",
 	"singleLine",
 	"autoClearText",
+	"outlineSoftness",
 	"underlaySoftness",
 	"ubbEnabled",
 	"underline",
@@ -16376,7 +16680,7 @@ function isValidUamTextProperties(value, nodeKind) {
 		properties.italic,
 		properties.bold,
 		properties.strikethrough
-	].every((item) => typeof item === "boolean") && typeof properties.underlaySoftness === "number" && Number.isFinite(properties.underlaySoftness) && typeof properties.strokeSize === "number" && Number.isFinite(properties.strokeSize) && properties.strokeSize >= 0 && (properties.strokeColor === null ? properties.strokeSize === 1 : isTextColor(properties.strokeColor)) && isFiniteUamPoint(properties.shadowOffset) && (properties.shadowColor === null ? properties.shadowOffset.x === 0 && properties.shadowOffset.y === 0 : isTextColor(properties.shadowColor));
+	].every((item) => typeof item === "boolean") && typeof properties.outlineSoftness === "number" && Number.isFinite(properties.outlineSoftness) && typeof properties.underlaySoftness === "number" && Number.isFinite(properties.underlaySoftness) && typeof properties.strokeSize === "number" && Number.isFinite(properties.strokeSize) && properties.strokeSize >= 0 && (properties.strokeColor === null ? properties.strokeSize === 1 : isTextColor(properties.strokeColor)) && isFiniteUamPoint(properties.shadowOffset) && (properties.shadowColor === null ? properties.shadowOffset.x === 0 && properties.shadowOffset.y === 0 : isTextColor(properties.shadowColor));
 	if (!commonValid || nodeKind === "richText") return commonValid;
 	return typeof properties.demoText === "string" && typeof properties.templateVarsEnabled === "boolean" && typeof properties.faceDilate === "number" && Number.isFinite(properties.faceDilate);
 }
@@ -16393,6 +16697,7 @@ function textPropertiesFromNode(node) {
 		autoSize: node.autoSize,
 		singleLine: node.singleLine,
 		autoClearText: node.autoClearText,
+		outlineSoftness: node.outlineSoftness,
 		underlaySoftness: node.underlaySoftness,
 		ubbEnabled: node.ubbEnabled,
 		underline: node.underline,
@@ -16412,6 +16717,29 @@ function textPropertiesFromNode(node) {
 		faceDilate: node.faceDilate
 	};
 }
+const IMAGE_PROPERTY_KEYS = [
+	"color",
+	"flip",
+	"fillMethod",
+	"fillOrigin",
+	"fillClockwise",
+	"fillAmount"
+];
+function isValidUamImageProperties(value) {
+	if (typeof value !== "object" || value === null || !hasExactKeys(value, IMAGE_PROPERTY_KEYS)) return false;
+	const properties = value;
+	return isTextColor(properties.color) && Number.isInteger(properties.flip) && properties.flip >= 0 && properties.flip <= 3 && Number.isInteger(properties.fillMethod) && properties.fillMethod >= 0 && properties.fillMethod <= 5 && Number.isInteger(properties.fillOrigin) && properties.fillOrigin >= 0 && properties.fillOrigin <= 3 && typeof properties.fillClockwise === "boolean" && typeof properties.fillAmount === "number" && Number.isFinite(properties.fillAmount) && (properties.fillMethod === 0 ? properties.fillOrigin === 0 && properties.fillClockwise && properties.fillAmount === 100 : properties.fillAmount >= 0 && properties.fillAmount <= 1);
+}
+const MOVIE_CLIP_PROPERTY_KEYS = [
+	"playing",
+	"frame",
+	"color"
+];
+function isValidUamMovieClipProperties(value) {
+	if (typeof value !== "object" || value === null || !hasExactKeys(value, MOVIE_CLIP_PROPERTY_KEYS)) return false;
+	const properties = value;
+	return typeof properties.playing === "boolean" && Number.isInteger(properties.frame) && properties.frame >= 0 && isTextColor(properties.color);
+}
 const COMPONENT_PROPERTY_KEYS = [
 	"minSize",
 	"maxSize",
@@ -16436,9 +16764,15 @@ const COMPONENT_PROPERTY_KEYS = [
 	"designImageAlpha",
 	"designImageLayer",
 	"designImageOffset",
+	"designImage",
+	"designImageForTest",
+	"pageController",
+	"showSound",
+	"hideSound",
 	"idNum",
 	"initName",
 	"remark",
+	"customExtensionId",
 	"extensionType",
 	"opaque",
 	"buttonMode",
@@ -16470,6 +16804,8 @@ function isValidUamComponentProperties(value) {
 		properties.bgColor,
 		properties.initName,
 		properties.remark,
+		properties.customExtensionId,
+		properties.pageController,
 		properties.extensionType,
 		properties.sound,
 		properties.dropdown,
@@ -16480,6 +16816,7 @@ function isValidUamComponentProperties(value) {
 		properties.pivotAsAnchor,
 		properties.reversedMask,
 		properties.bgColorEnabled,
+		properties.designImageForTest,
 		properties.opaque,
 		properties.reverse,
 		properties.wholeNumbers,
@@ -16492,8 +16829,6 @@ function isValidUamComponentProperties(value) {
 		properties.scrollType,
 		properties.scrollBarDisplay,
 		properties.scrollBarFlags,
-		properties.designImageAlpha,
-		properties.designImageLayer,
 		properties.idNum,
 		properties.buttonMode,
 		properties.soundVolumeScale,
@@ -16501,7 +16836,7 @@ function isValidUamComponentProperties(value) {
 		properties.downEffectValue,
 		properties.titleType
 	];
-	return isFiniteUamSize(properties.minSize) && isFiniteUamSize(properties.maxSize) && isFiniteUamPoint(properties.pivot) && isFiniteUamEdgeInsets(properties.margin) && isFiniteUamPoint(properties.clipSoftness) && isFiniteUamEdgeInsets(properties.scrollBarMargin) && isFiniteUamPoint(properties.designImageOffset) && strings.every((item) => typeof item === "string") && booleans.every((item) => typeof item === "boolean") && numbers.every((item) => typeof item === "number" && Number.isFinite(item)) && Array.isArray(properties.customProperties) && properties.customProperties.every((property) => property && typeof property === "object" && hasExactKeys(property, [
+	return isFiniteUamSize(properties.minSize) && isFiniteUamSize(properties.maxSize) && isFiniteUamPoint(properties.pivot) && isFiniteUamEdgeInsets(properties.margin) && isFiniteUamPoint(properties.clipSoftness) && isFiniteUamEdgeInsets(properties.scrollBarMargin) && isFiniteUamPoint(properties.designImageOffset) && strings.every((item) => typeof item === "string") && booleans.every((item) => typeof item === "boolean") && numbers.every((item) => typeof item === "number" && Number.isFinite(item)) && isUiResourceReference(properties.designImage) && isSoundReference(properties.showSound) && isSoundReference(properties.hideSound) && Number.isInteger(properties.designImageAlpha) && properties.designImageAlpha >= 0 && properties.designImageAlpha <= 100 && Number.isInteger(properties.designImageLayer) && properties.designImageLayer >= 0 && properties.designImageLayer <= 1 && Array.isArray(properties.customProperties) && properties.customProperties.every((property) => property && typeof property === "object" && hasExactKeys(property, [
 		"target",
 		"propertyId",
 		"label"
@@ -16510,6 +16845,13 @@ function isValidUamComponentProperties(value) {
 function isNullableString(value) {
 	return value === null || typeof value === "string";
 }
+function isUiResourceReference(value) {
+	return typeof value === "string" && (value === "" || value.startsWith("ui://") && value.length > 5 && !/\s/.test(value));
+}
+const isSoundReference = isUiResourceReference;
+function isSoundVolume(value) {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= 1;
+}
 function isValidUamComponentInstanceProperties(value) {
 	if (typeof value !== "object" || value === null || !("extensionType" in value)) return false;
 	const properties = value;
@@ -16537,24 +16879,29 @@ function isValidUamComponentInstanceProperties(value) {
 			properties.controller,
 			properties.page,
 			properties.sound
-		].every((item) => typeof item === "string") && finite(properties.titleFontSize) && typeof properties.checked === "boolean" && finite(properties.soundVolumeScale);
+		].every((item) => typeof item === "string") && finite(properties.titleFontSize) && typeof properties.checked === "boolean" && isSoundReference(properties.sound) && isSoundVolume(properties.soundVolumeScale);
 		case "Label": return hasExactKeys(properties, [
 			"extensionType",
 			"title",
 			"icon",
 			"titleColor",
 			"titleFontSize",
-			"promptText"
+			"promptText",
+			"sound",
+			"soundVolumeScale"
 		]) && [
 			properties.title,
 			properties.icon,
-			properties.titleColor,
 			properties.promptText
-		].every((item) => typeof item === "string") && finite(properties.titleFontSize);
+		].every((item) => typeof item === "string") && (properties.titleColor === "" || isTextColor(properties.titleColor)) && finite(properties.titleFontSize) && isSoundReference(properties.sound) && isSoundVolume(properties.soundVolumeScale);
 		case "ComboBox": return hasExactKeys(properties, [
 			"extensionType",
 			"title",
 			"icon",
+			"titleColor",
+			"popupDirection",
+			"sound",
+			"soundVolumeScale",
 			"visibleItemCount",
 			"selectionController",
 			"autoClearItems",
@@ -16563,12 +16910,23 @@ function isValidUamComponentInstanceProperties(value) {
 			properties.title,
 			properties.icon,
 			properties.selectionController
-		].every((item) => typeof item === "string") && finite(properties.visibleItemCount) && typeof properties.autoClearItems === "boolean" && Array.isArray(properties.items) && properties.items.every((item) => item && typeof item === "object" && hasExactKeys(item, [
+		].every((item) => typeof item === "string") && (properties.titleColor === "" || isTextColor(properties.titleColor)) && Number.isInteger(properties.popupDirection) && properties.popupDirection >= 0 && properties.popupDirection <= 2 && isSoundReference(properties.sound) && isSoundVolume(properties.soundVolumeScale) && finite(properties.visibleItemCount) && typeof properties.autoClearItems === "boolean" && Array.isArray(properties.items) && properties.items.every((item) => item && typeof item === "object" && hasExactKeys(item, [
 			"title",
 			"value",
 			"icon"
 		]) && isNullableString(item.title) && isNullableString(item.value) && isNullableString(item.icon));
-		case "ProgressBar":
+		case "ProgressBar": return hasExactKeys(properties, [
+			"extensionType",
+			"value",
+			"max",
+			"min",
+			"sound",
+			"soundVolumeScale"
+		]) && [
+			properties.value,
+			properties.max,
+			properties.min
+		].every(finite) && isSoundReference(properties.sound) && isSoundVolume(properties.soundVolumeScale);
 		case "Slider": return hasExactKeys(properties, [
 			"extensionType",
 			"value",
@@ -16624,7 +16982,7 @@ function isSafeRelativePath(value) {
 	return segments.length > 0 && segments.every(isSafePathSegment);
 }
 function assetFileName$1(resource) {
-	return resource.fileName || (resource.kind === "image" ? "" : resource.file) || resource.name;
+	return resource.fileName || ("file" in resource ? resource.file : "") || resource.name;
 }
 function validatePackageOutputTargets(pkg, pkgPath, issues) {
 	if (!isSafePathSegment(pkg.name)) pushIssue(issues, `${pkgPath}.name`, `Invalid package output name "${pkg.name}".`, "unsafe_path");
@@ -16714,9 +17072,23 @@ function validateDisplayNode(node, controllerMap, knownChildIds, knownGroupIds,
 	}
 	if (node.kind === "component" && node.propertyOverrides !== void 0 && (!Array.isArray(node.propertyOverrides) || !node.propertyOverrides.every(isValidUamComponentPropertyOverride))) pushIssue(issues, `${path}.propertyOverrides`, "Component property overrides must contain a non-empty target, a non-negative integer propertyId, and a string value.");
 	if (node.kind === "list" || node.kind === "tree") {
+		if (!Number.isInteger(node.scrollBarDisplay) || node.scrollBarDisplay < 0 || node.scrollBarDisplay > 3) pushIssue(issues, `${path}.scrollBarDisplay`, "List scrollBarDisplay must be an integer between 0 and 3.");
 		for (const [itemIndex, item] of node.listItems.entries()) if (item.propertyOverrides !== void 0 && (!Array.isArray(item.propertyOverrides) || !item.propertyOverrides.every(isValidUamComponentPropertyOverride))) pushIssue(issues, `${path}.listItems[${itemIndex}].propertyOverrides`, "List item property overrides must contain a non-empty target, a non-negative integer propertyId, and a string value.");
 	}
 	if ((node.kind === "text" || node.kind === "richText" || node.kind === "textInput") && !isValidUamTextProperties(textPropertiesFromNode(node), node.kind)) pushIssue(issues, path, "Text properties must be a complete valid snapshot matching the display node kind.");
+	if (node.kind === "image" && !isValidUamImageProperties({
+		color: node.color,
+		flip: node.flip,
+		fillMethod: node.fillMethod,
+		fillOrigin: node.fillOrigin,
+		fillClockwise: node.fillClockwise,
+		fillAmount: node.fillAmount
+	})) pushIssue(issues, path, "Image properties must be a complete valid property snapshot.");
+	if (node.kind === "movieClip" && !isValidUamMovieClipProperties({
+		playing: node.playing,
+		frame: node.frame,
+		color: node.color
+	})) pushIssue(issues, path, "MovieClip properties must be a complete valid property snapshot.");
 	if (node.kind === "loader" || node.kind === "loader3D") {
 		if ("group" in node) pushIssue(issues, `${path}.group`, `${node.kind} display nodes must not declare a group reference.`);
 	} else if (!("group" in node) || typeof node.group !== "string") pushIssue(issues, `${path}.group`, "Display node group must be a string.");
@@ -16787,8 +17159,22 @@ function validateUamProject(project) {
 					if (pageIds.has(page.id)) pushIssue(issues, `${pagePath}.id`, `Duplicate controller page id "${page.id}".`);
 					pageIds.add(page.id);
 				}
+				if (typeof controller.autoRadioGroupDepth !== "boolean") pushIssue(issues, `${controllerPath}.autoRadioGroupDepth`, "Controller autoRadioGroupDepth must be boolean.");
+				if (typeof controller.alias !== "string") pushIssue(issues, `${controllerPath}.alias`, "Controller alias must be a string.");
+				if (typeof controller.exported !== "boolean") pushIssue(issues, `${controllerPath}.exported`, "Controller exported must be boolean.");
+				if (![
+					"default",
+					"specific",
+					"branch",
+					"variable"
+				].includes(controller.homePageType)) pushIssue(issues, `${controllerPath}.homePageType`, `Unknown controller home page type "${controller.homePageType}".`);
+				else if (typeof controller.homePage !== "string") pushIssue(issues, `${controllerPath}.homePage`, "Controller homePage must be a string.");
+				else if (controller.homePageType === "specific" && !pageIds.has(controller.homePage)) pushIssue(issues, `${controllerPath}.homePage`, `Unknown controller home page id "${controller.homePage}".`);
+				else if (controller.homePageType === "variable" && !controller.homePage) pushIssue(issues, `${controllerPath}.homePage`, "Variable controller home page requires a custom property key.");
+				else if ((controller.homePageType === "default" || controller.homePageType === "branch") && controller.homePage) pushIssue(issues, `${controllerPath}.homePage`, `Controller home page must be empty for "${controller.homePageType}".`);
 				for (const [actionIndex, action] of controller.actions.entries()) validateControllerAction(action, pageIds, childIds, `${controllerPath}.actions[${actionIndex}]`, issues);
 			}
+			if (component.properties.pageController && !controllerMap.has(component.properties.pageController)) pushIssue(issues, `${resourcePath}.component.properties.pageController`, `Unknown page controller "${component.properties.pageController}".`);
 			for (const [childIndex, child] of component.displayList.entries()) {
 				if (child.kind === "component" && child.instanceProperties !== void 0 && !isValidUamComponentInstanceProperties(child.instanceProperties)) pushIssue(issues, `${resourcePath}.component.displayList[${childIndex}].instanceProperties`, "Component instance properties must be a complete valid extension snapshot.");
 				validateDisplayNode(child, controllerMap, childIds, groupIds, `${resourcePath}.component.displayList[${childIndex}]`, issues);
@@ -16855,6 +17241,7 @@ function validateUamReferences(project) {
 		"image",
 		"sound",
 		"misc",
+		"swf",
 		"font",
 		"movieClip",
 		"spine",
@@ -16885,6 +17272,8 @@ function validateUamReferences(project) {
 			["dropdown", resource.component.properties.dropdown]
 		]) pushMissingUi(`${componentPath}.properties.${field}`, value, componentKinds, owner);
 		pushMissingUi(`${componentPath}.properties.sound`, resource.component.properties.sound, ["sound"], owner);
+		pushMissingUi(`${componentPath}.properties.designImage`, resource.component.properties.designImage, ["image"], owner);
+		for (const field of ["showSound", "hideSound"]) pushMissingUi(`${componentPath}.properties.${field}`, resource.component.properties[field], ["sound"], owner);
 		for (const [nodeIndex, node] of resource.component.displayList.entries()) {
 			const nodePath = `${componentPath}.displayList[${nodeIndex}]`;
 			const nodeOwner = {
@@ -16918,10 +17307,8 @@ function validateUamReferences(project) {
 			if (node.kind === "component" && node.instanceProperties) {
 				const instance = node.instanceProperties;
 				if ("icon" in instance) pushMissingUi(`${nodePath}.instanceProperties.icon`, instance.icon, visualKinds, nodeOwner);
-				if (instance.extensionType === "Button") {
-					pushMissingUi(`${nodePath}.instanceProperties.selectedIcon`, instance.selectedIcon, visualKinds, nodeOwner);
-					pushMissingUi(`${nodePath}.instanceProperties.sound`, instance.sound, ["sound"], nodeOwner);
-				}
+				if (instance.extensionType === "Button") pushMissingUi(`${nodePath}.instanceProperties.selectedIcon`, instance.selectedIcon, visualKinds, nodeOwner);
+				if (instance.extensionType === "Button" || instance.extensionType === "Label" || instance.extensionType === "ComboBox" || instance.extensionType === "ProgressBar") pushMissingUi(`${nodePath}.instanceProperties.sound`, instance.sound, ["sound"], nodeOwner);
 				if (instance.extensionType === "ComboBox") for (const [itemIndex, item] of instance.items.entries()) pushMissingUi(`${nodePath}.instanceProperties.items[${itemIndex}].icon`, item.icon ?? "", visualKinds, nodeOwner);
 			}
 			if ("icon" in node) pushMissingUi(`${nodePath}.icon`, node.icon, visualKinds, nodeOwner);
@@ -16937,13 +17324,13 @@ function validateUamReferences(project) {
 //#endregion
 //#region ../core/src/uam/project-source-files.ts
 function defaultAssetSourcePath(resource) {
-	const fileName = resource.fileName ?? (resource.kind === "image" ? "" : resource.file) ?? "";
+	const fileName = resource.fileName ?? ("file" in resource ? resource.file : "") ?? "";
 	return `/${[resource.path.replace(/\\/g, "/").replace(/^\/+|\/+$/g, ""), fileName].filter(Boolean).join("/")}`;
 }
 //#endregion
 //#region ../core/src/uam/source-validation.ts
 function assetFileName(resource) {
-	return resource.fileName ?? (resource.kind === "image" ? "" : resource.file) ?? resource.name;
+	return resource.fileName ?? ("file" in resource ? resource.file : "") ?? resource.name;
 }
 function sourceExtension(resource) {
 	const fileName = assetFileName(resource);
@@ -16952,15 +17339,8 @@ function sourceExtension(resource) {
 }
 function validSvg(bytes) {
 	try {
-		if (bytes.byteLength === 0 || bytes.byteLength > 8 * 1024 * 1024) return false;
-		const source = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
-		if (XMLValidator.validate(source, { allowBooleanAttributes: false }) !== true) return false;
-		if (!/<svg(?:\s|>)/i.test(source)) return false;
-		if (/<!\s*(?:doctype|entity)\b|<\?xml-stylesheet\b/iu.test(source)) return false;
-		if (/<(?:a|animate|animatecolor|animatemotion|animatetransform|audio|canvas|discard|embed|feimage|foreignobject|iframe|image|object|script|set|style|video)(?:\s|>)/iu.test(source)) return false;
-		if (/\s(?:on[\w:-]*|style|src)\s*=/iu.test(source)) return false;
-		if (/\s(?:href|xlink:href)\s*=\s*['"](?!#[A-Za-z_][\w:.-]*['"])/iu.test(source)) return false;
-		return !/(?:https?:|file:|javascript:|data:|\/\/)|url\s*\(\s*(?!['"]?#[A-Za-z_])/iu.test(source);
+		validateSafeSvgSource(bytes);
+		return true;
 	} catch {
 		return false;
 	}
@@ -17273,6 +17653,13 @@ function liftAssetResource(resource) {
 			file: misc.getFile()
 		};
 	}
+	if (resource.propertyType === PropertyType.SWF_RESOURCE) {
+		const swf = resource;
+		return {
+			...baseAssetResource("swf", swf),
+			file: swf.getFile()
+		};
+	}
 	if (resource.propertyType === PropertyType.FONT_RESOURCE) {
 		const font = resource;
 		return {
@@ -17420,7 +17807,16 @@ function liftDisplayNode(child) {
 			kind: "image",
 			...liftDisplayNodeBase(image),
 			group: image.getGroup(),
-			resource: { resourceId: image.getSrc() }
+			resource: {
+				packageId: image.getPackageId(),
+				resourceId: image.getSrc()
+			},
+			color: image.getColor(),
+			flip: image.getFlip(),
+			fillMethod: image.getFillMethod(),
+			fillOrigin: image.getFillOrigin(),
+			fillClockwise: image.getFillClockwise(),
+			fillAmount: image.getFillAmount()
 		};
 	}
 	if (child.propertyType === PropertyType.G_TEXT_FIELD || child.propertyType === PropertyType.G_RICH_TEXT_FIELD || child.propertyType === PropertyType.G_TEXT_INPUT) {
@@ -17437,6 +17833,7 @@ function liftDisplayNode(child) {
 			autoSize: text.getAutoSize(),
 			singleLine: text.getSingleLine(),
 			autoClearText: text.getAutoClearText(),
+			outlineSoftness: text.getOutlineSoftness(),
 			underlaySoftness: text.getUnderlaySoftness(),
 			ubbEnabled: text.getUbbEnabled(),
 			underline: text.getUnderline(),
@@ -17518,6 +17915,7 @@ function liftDisplayNode(child) {
 			src: list.getSrc(),
 			overflow: list.getOverflow(),
 			scrollType: list.getScrollType(),
+			scrollBarDisplay: list.getScrollBarDisplay(),
 			scrollBarFlags: list.getScrollBarFlags(),
 			scrollBarMargin: liftEdgeInsets(list.getScrollBarMargin()),
 			vtScrollBarRes: list.getVtScrollBarRes(),
@@ -17600,6 +17998,7 @@ function liftDisplayNode(child) {
 			shrinkOnly: loader.getShrinkOnly(),
 			autoSize: loader.getAutoSize(),
 			useResize: loader.getUseResize(),
+			showErrorSign: loader.getShowErrorSign(),
 			align: loader.getAlign(),
 			vAlign: loader.getVAlign(),
 			frame: loader.getFrame(),
@@ -17735,20 +18134,33 @@ function liftComponentInstanceProperties(component) {
 			icon: component.getInstanceIcon(),
 			titleColor: component.getInstanceTitleColor(),
 			titleFontSize: component.getInstanceTitleFontSize(),
-			promptText: component.getInstancePromptText()
+			promptText: component.getInstancePromptText(),
+			sound: component.getInstanceSound(),
+			soundVolumeScale: component.getInstanceSoundVolumeScale()
 		};
 		case "ComboBox": return {
 			extensionType: "ComboBox",
 			title: component.getInstanceTitle(),
 			icon: component.getInstanceIcon(),
+			titleColor: component.getInstanceTitleColor(),
+			popupDirection: component.getInstancePopupDirection(),
+			sound: component.getInstanceSound(),
+			soundVolumeScale: component.getInstanceSoundVolumeScale(),
 			visibleItemCount: component.getInstanceVisibleItemCount(),
 			selectionController: component.getInstanceSelectionController(),
 			autoClearItems: component.getInstanceAutoClearItems(),
 			items: component.getInstanceComboItems().map((item) => ({ ...item }))
 		};
-		case "ProgressBar":
+		case "ProgressBar": return {
+			extensionType: "ProgressBar",
+			value: component.getInstanceValue(),
+			max: component.getInstanceMax(),
+			min: component.getInstanceMin(),
+			sound: component.getInstanceSound(),
+			soundVolumeScale: component.getInstanceSoundVolumeScale()
+		};
 		case "Slider": return {
-			extensionType: component.getInstanceExtType(),
+			extensionType: "Slider",
 			value: component.getInstanceValue(),
 			max: component.getInstanceMax(),
 			min: component.getInstanceMin()
@@ -17762,9 +18174,14 @@ function liftControllers(component) {
 		name: controller.getName(),
 		selectedIndex: controller.getSelectedIndex(),
 		autoRadioGroupDepth: controller.getAutoRadioGroupDepth(),
+		alias: controller.getAlias(),
+		exported: controller.getExported(),
+		homePageType: controller.getHomePageType(),
+		homePage: controller.getHomePage(),
 		pages: controller.listPages().map((page) => ({
 			id: page.getId(),
-			name: page.getName()
+			name: page.getName(),
+			remark: page.getRemark()
 		})),
 		actions: controller.listActions().map((action) => ({
 			name: action.getName(),
@@ -17868,9 +18285,15 @@ function liftComponentProperties(resource) {
 			x: resource.getDesignImageOffsetX(),
 			y: resource.getDesignImageOffsetY()
 		},
+		designImage: resource.getDesignImage(),
+		designImageForTest: resource.getDesignImageForTest(),
+		pageController: resource.getPageController(),
+		showSound: resource.getAddedToStageSound(),
+		hideSound: resource.getRemovedFromStageSound(),
 		idNum: resource.getIdNum(),
 		initName: resource.getInitName(),
 		remark: resource.getRemark(),
+		customExtensionId: resource.getCustomExtensionId(),
 		extensionType: resource.getExtensionType(),
 		opaque: resource.getOpaque(),
 		buttonMode: resource.getButtonMode(),
@@ -18076,10 +18499,16 @@ const ROOT_COMPONENT_PANEL_ATTRS = {
 	bgColor: { canonical: "bgColor" },
 	bgColorEnabled: { canonical: "bgColorEnabled" },
 	idnum: { canonical: "idnum" },
-	initName: { canonical: "initName" }
+	initName: { canonical: "initName" },
+	customExtention: { canonical: "customExtention" },
+	pageController: { canonical: "pageController" },
+	showSound: { canonical: "showSound" },
+	hideSound: { canonical: "hideSound" }
 };
 const ROOT_MISC_PANEL_ATTRS = { remark: { canonical: "remark" } };
 const ROOT_DESIGN_PANEL_ATTRS = {
+	designImage: { canonical: "designImage" },
+	designImageForTest: { canonical: "designImageForTest" },
 	designImageAlpha: { canonical: "designImageAlpha" },
 	designImageLayer: { canonical: "designImageLayer" },
 	designImageOffsetX: { canonical: "designImageOffsetX" },
@@ -18124,6 +18553,7 @@ const LOADER_PANEL_ATTRS = {
 	shrinkOnly: { canonical: "shrinkOnly" },
 	autoSize: { canonical: "autoSize" },
 	useResize: { canonical: "useResize" },
+	errorSign: { canonical: "errorSign" },
 	color: { canonical: "color" },
 	playing: { canonical: "playing" },
 	frame: { canonical: "frame" },
@@ -18178,6 +18608,7 @@ const TEXT_PANEL_ATTRS = {
 	autoClearText: { canonical: "autoClearText" },
 	demoText: { canonical: "demoText" },
 	faceDilate: { canonical: "faceDilate" },
+	outlineSoftness: { canonical: "outlineSoftness" },
 	underlaySoftness: { canonical: "underlaySoftness" },
 	vars: { canonical: "vars" }
 };
@@ -18193,6 +18624,7 @@ const TEXT_INPUT_PANEL_ATTRS = {
 };
 const RICH_TEXT_PANEL_ATTRS = {
 	restrictSize: { canonical: "restrictSize" },
+	outlineSoftness: { canonical: "outlineSoftness" },
 	underlaySoftness: { canonical: "underlaySoftness" }
 };
 const GROUP_PANEL_ATTRS = {
@@ -18249,10 +18681,7 @@ const LIST_PANEL_ATTRS = {
 const BUTTON_EXTENSION_ATTRS = {
 	mode: { canonical: "mode" },
 	sound: { canonical: "sound" },
-	soundVolumeScale: {
-		canonical: "soundVolumeScale",
-		aliases: ["volume"]
-	},
+	soundVolumeScale: { canonical: "volume" },
 	downEffect: { canonical: "downEffect" },
 	downEffectValue: { canonical: "downEffectValue" },
 	title: { canonical: "title" },
@@ -18270,12 +18699,18 @@ const LABEL_EXTENSION_ATTRS = {
 	icon: { canonical: "icon" },
 	titleColor: { canonical: "titleColor" },
 	titleFontSize: { canonical: "titleFontSize" },
-	prompt: { canonical: "prompt" }
+	prompt: { canonical: "prompt" },
+	sound: { canonical: "sound" },
+	soundVolumeScale: { canonical: "volume" }
 };
 const COMBOBOX_EXTENSION_ATTRS = {
 	dropdown: { canonical: "dropdown" },
 	title: { canonical: "title" },
 	icon: { canonical: "icon" },
+	titleColor: { canonical: "titleColor" },
+	popupDirection: { canonical: "direction" },
+	sound: { canonical: "sound" },
+	soundVolumeScale: { canonical: "volume" },
 	visibleItemCount: { canonical: "visibleItemCount" },
 	selectionController: { canonical: "selectionController" },
 	autoClearItems: { canonical: "autoClearItems" }
@@ -18285,7 +18720,9 @@ const PROGRESSBAR_EXTENSION_ATTRS = {
 	reverse: { canonical: "reverse" },
 	value: { canonical: "value" },
 	max: { canonical: "max" },
-	min: { canonical: "min" }
+	min: { canonical: "min" },
+	sound: { canonical: "sound" },
+	soundVolumeScale: { canonical: "volume" }
 };
 const SLIDER_EXTENSION_ATTRS = {
 	titleType: { canonical: "titleType" },
@@ -18325,7 +18762,12 @@ const GEAR_ATTRS = {
 const CONTROLLER_ATTRS = {
 	name: { canonical: "name" },
 	pages: { canonical: "pages" },
-	selected: { canonical: "selected" }
+	selected: { canonical: "selected" },
+	alias: { canonical: "alias" },
+	autoRadioGroupDepth: { canonical: "autoRadioGroupDepth" },
+	exported: { canonical: "exported" },
+	homePageType: { canonical: "homePageType" },
+	homePage: { canonical: "homePage" }
 };
 const CONTROLLER_ACTION_ATTRS = {
 	type: { canonical: "type" },
@@ -18339,6 +18781,10 @@ const CONTROLLER_ACTION_ATTRS = {
 	controller: { canonical: "controller" },
 	targetPage: { canonical: "targetPage" }
 };
+const CONTROLLER_REMARK_ATTRS = {
+	page: { canonical: "page" },
+	value: { canonical: "value" }
+};
 const TRANSITION_ATTRS = {
 	name: { canonical: "name" },
 	autoPlay: { canonical: "autoPlay" },
@@ -18348,7 +18794,7 @@ const TRANSITION_ATTRS = {
 	},
 	autoPlayDelay: { canonical: "autoPlayDelay" },
 	options: { canonical: "options" },
-	fps: { canonical: "fps" }
+	fps: { canonical: "frameRate" }
 };
 const TRANSITION_ITEM_ATTRS = {
 	time: { canonical: "time" },
@@ -18404,6 +18850,7 @@ const CUSTOM_PROPERTY_NODE = defineNode(CUSTOM_PROPERTY_ATTRS);
 const PROPERTY_OVERRIDE_NODE = defineNode(PROPERTY_OVERRIDE_ATTRS);
 const GEAR_NODE = defineNode(GEAR_ATTRS);
 const CONTROLLER_ACTION_NODE = defineNode(CONTROLLER_ACTION_ATTRS);
+const CONTROLLER_REMARK_NODE = defineNode(CONTROLLER_REMARK_ATTRS);
 const TRANSITION_ITEM_NODE = defineNode(TRANSITION_ITEM_ATTRS);
 const LIST_ITEM_NODE = defineNode(LIST_ITEM_ATTRS, { property: PROPERTY_OVERRIDE_NODE });
 const COMBOBOX_ITEM_NODE = defineNode(COMBOBOX_ITEM_ATTRS);
@@ -18428,7 +18875,10 @@ const WITH_GROUP_GEAR_CHILDREN = {
 	gearIcon: GEAR_NODE,
 	gearDisplay2: GEAR_NODE
 };
-const WITH_CONTROLLER_ACTION_CHILDREN = { action: CONTROLLER_ACTION_NODE };
+const WITH_CONTROLLER_ACTION_CHILDREN = {
+	action: CONTROLLER_ACTION_NODE,
+	remark: CONTROLLER_REMARK_NODE
+};
 const WITH_TRANSITION_ITEM_CHILDREN = { item: TRANSITION_ITEM_NODE };
 const WITH_LIST_ITEM_CHILDREN = { item: LIST_ITEM_NODE };
 const COMBOBOX_EXTENSION_NODE = defineNode(mergeAttrs(COMBOBOX_EXTENSION_ATTRS), mergeChildren({ item: COMBOBOX_ITEM_NODE }));
@@ -18984,6 +19434,8 @@ function createDisplayObject$1(ctx, doc, tagName, attrs, localControllers) {
 			if (textVars !== void 0) g.setTemplateVarsEnabled?.(parseBool$1(textVars));
 			const textFaceDilate = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.faceDilate);
 			if (textFaceDilate !== void 0) g.setFaceDilate?.(parseFloat2(textFaceDilate));
+			const textOutlineSoftness = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.outlineSoftness);
+			if (textOutlineSoftness !== void 0) g.setOutlineSoftness?.(parseFloat2(textOutlineSoftness));
 			const textUnderlaySoftness = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.underlaySoftness);
 			if (textUnderlaySoftness !== void 0) g.setUnderlaySoftness?.(parseFloat2(textUnderlaySoftness));
 			const textUbb = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.ubb);
@@ -19108,6 +19560,8 @@ function createDisplayObject$1(ctx, doc, tagName, attrs, localControllers) {
 			if (richTextSingleLine !== void 0) g.setSingleLine?.(parseBool$1(richTextSingleLine));
 			const richTextAutoClearText = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.autoClearText);
 			if (richTextAutoClearText !== void 0) g.setAutoClearText?.(parseBool$1(richTextAutoClearText));
+			const richTextOutlineSoftness = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.richText.attrs.outlineSoftness);
+			if (richTextOutlineSoftness !== void 0) g.setOutlineSoftness?.(parseFloat2(richTextOutlineSoftness));
 			const richTextUnderlaySoftness = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.richText.attrs.underlaySoftness);
 			if (richTextUnderlaySoftness !== void 0) g.setUnderlaySoftness?.(parseFloat2(richTextUnderlaySoftness));
 			const richTextUnderline = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.underline);
@@ -19217,6 +19671,8 @@ function createDisplayObject$1(ctx, doc, tagName, attrs, localControllers) {
 			if (inputVars !== void 0) g.setTemplateVarsEnabled?.(parseBool$1(inputVars));
 			const inputFaceDilate = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.faceDilate);
 			if (inputFaceDilate !== void 0) g.setFaceDilate?.(parseFloat2(inputFaceDilate));
+			const inputOutlineSoftness = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.outlineSoftness);
+			if (inputOutlineSoftness !== void 0) g.setOutlineSoftness?.(parseFloat2(inputOutlineSoftness));
 			const inputUnderlaySoftness = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.underlaySoftness);
 			if (inputUnderlaySoftness !== void 0) g.setUnderlaySoftness?.(parseFloat2(inputUnderlaySoftness));
 			const inputUbb = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.ubb);
@@ -19440,6 +19896,8 @@ function createDisplayObject$1(ctx, doc, tagName, attrs, localControllers) {
 			if (loaderAutoSize !== void 0) g.setAutoSize?.(parseBool$1(loaderAutoSize));
 			const useResize = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.loader.attrs.useResize);
 			if (useResize !== void 0) g.setUseResize?.(parseBool$1(useResize));
+			const errorSign = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.loader.attrs.errorSign);
+			if (errorSign !== void 0) g.setShowErrorSign(parseBool$1(errorSign));
 			const clearOnPublish = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.loader.attrs.clearOnPublish);
 			if (clearOnPublish !== void 0) g.setClearOnPublish?.(parseBool$1(clearOnPublish));
 			const loaderColor = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.loader.attrs.color);
@@ -19745,7 +20203,7 @@ function createDisplayObject$1(ctx, doc, tagName, attrs, localControllers) {
 				if (resolvedLayout === 4 && lineItemCount2 !== void 0) g.setLineCount?.(parseInt2(lineItemCount2));
 			}
 			const autoResizeItem = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.autoResizeItem);
-			if (autoResizeItem !== void 0) g.setAutoResizeItem?.(parseBool$1(autoResizeItem));
+			g.setAutoResizeItem?.(autoResizeItem === void 0 ? getDefaultListAutoResizeItem(g.getLayout?.() ?? 0) : parseBool$1(autoResizeItem));
 			const childrenRenderOrder = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.childrenRenderOrder);
 			if (childrenRenderOrder) g.setChildrenRenderOrder?.({
 				ascent: 0,
@@ -19765,9 +20223,10 @@ function createDisplayObject$1(ctx, doc, tagName, attrs, localControllers) {
 			if (selectionController !== void 0) g.setSelectionController?.(selectionController);
 			const overflow = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.overflow);
 			const scroll = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.scroll);
+			const scrollBar = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.scrollBar);
 			const scrollBarFlags = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.scrollBarFlags);
 			const margin = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.margin);
-			if (overflow || scroll || scrollBarFlags !== void 0 || margin) {
+			if (overflow || scroll || scrollBar || scrollBarFlags !== void 0 || margin) {
 				if (overflow) g.setOverflow({
 					visible: 0,
 					hidden: 1,
@@ -19778,6 +20237,12 @@ function createDisplayObject$1(ctx, doc, tagName, attrs, localControllers) {
 					vertical: 1,
 					both: 2
 				}[scroll] ?? 1);
+				if (scrollBar) g.setScrollBarDisplay({
+					default: 0,
+					visible: 1,
+					auto: 2,
+					hidden: 3
+				}[scrollBar] ?? 0);
 				if (scrollBarFlags !== void 0) g.setScrollBarFlags(parseInt2(scrollBarFlags));
 				if (margin) {
 					const parts = margin.split(",").map(Number);
@@ -19881,7 +20346,13 @@ function createDisplayObject$1(ctx, doc, tagName, attrs, localControllers) {
 			const sound = extSpecs.sound ? readXmlAttr(extAttrs, extSpecs.sound) : void 0;
 			if (sound !== void 0) componentObj.setInstanceSound?.(sound);
 			const soundVolumeScale = extSpecs.soundVolumeScale ? readXmlAttr(extAttrs, extSpecs.soundVolumeScale) : void 0;
-			if (soundVolumeScale !== void 0) componentObj.setInstanceSoundVolumeScale?.(parseFloat2(soundVolumeScale, 1));
+			if (soundVolumeScale !== void 0) componentObj.setInstanceSoundVolumeScale?.(parseFloat2(soundVolumeScale, 100) / 100);
+			const popupDirection = extSpecs.popupDirection ? readXmlAttr(extAttrs, extSpecs.popupDirection) : void 0;
+			if (popupDirection !== void 0) componentObj.setInstancePopupDirection?.({
+				auto: 0,
+				up: 1,
+				down: 2
+			}[popupDirection] ?? 0);
 			const prompt = extSpecs.prompt ? readXmlAttr(extAttrs, extSpecs.prompt) : void 0;
 			if (prompt !== void 0) componentObj.setInstancePromptText?.(prompt);
 			const selectionController = extSpecs.selectionController ? readXmlAttr(extAttrs, extSpecs.selectionController) : void 0;
@@ -19979,6 +20450,12 @@ const EXTENSION_TYPE_MAP = {
 	Slider: "GSlider",
 	ScrollBar: "GScrollBar"
 };
+const CONTROLLER_HOME_PAGE_TYPES = new Set([
+	"default",
+	"specific",
+	"branch",
+	"variable"
+]);
 const EXTENSION_PROTOCOL_MAP$1 = {
 	Button: PROJECT_XML_PROTOCOL.buttonExtension,
 	Label: PROJECT_XML_PROTOCOL.labelExtension,
@@ -20084,6 +20561,13 @@ function parseButtonMode(value) {
 	const parsed = Number(normalized);
 	return map[normalized] ?? (Number.isFinite(parsed) ? parsed : 0);
 }
+function parseButtonDownEffect(value) {
+	return {
+		none: 0,
+		dark: 1,
+		scale: 2
+	}[String(value ?? "").trim().toLowerCase()] ?? 0;
+}
 function parseTitleType(value) {
 	if (typeof value === "number") return value;
 	const normalized = String(value ?? "").trim().toLowerCase();
@@ -20161,6 +20645,10 @@ function readComponentXml(ctx, comp, xmlContent) {
 	if (bgColor !== void 0) comp.setBgColor?.(bgColor);
 	const bgColorEnabled = readXmlAttr(compNode, PROJECT_XML_PROTOCOL.componentRoot.attrs.bgColorEnabled);
 	if (bgColorEnabled !== void 0) comp.setBgColorEnabled?.(parseBool$1(bgColorEnabled));
+	const designImage = readXmlAttr(compNode, PROJECT_XML_PROTOCOL.componentRoot.attrs.designImage);
+	if (designImage !== void 0) comp.setDesignImage?.(designImage);
+	const designImageForTest = readXmlAttr(compNode, PROJECT_XML_PROTOCOL.componentRoot.attrs.designImageForTest);
+	if (designImageForTest !== void 0) comp.setDesignImageForTest?.(parseBool$1(designImageForTest));
 	const designImageAlpha = readXmlAttr(compNode, PROJECT_XML_PROTOCOL.componentRoot.attrs.designImageAlpha);
 	if (designImageAlpha !== void 0) comp.setDesignImageAlpha?.(parseInt2(designImageAlpha));
 	const designImageLayer = readXmlAttr(compNode, PROJECT_XML_PROTOCOL.componentRoot.attrs.designImageLayer);
@@ -20175,6 +20663,14 @@ function readComponentXml(ctx, comp, xmlContent) {
 	if (initName !== void 0) comp.setInitName?.(initName);
 	const remark = readXmlAttr(compNode, PROJECT_XML_PROTOCOL.componentRoot.attrs.remark);
 	if (remark !== void 0) comp.setRemark?.(remark);
+	const customExtensionId = readXmlAttr(compNode, PROJECT_XML_PROTOCOL.componentRoot.attrs.customExtention);
+	if (customExtensionId !== void 0) comp.setCustomExtensionId?.(customExtensionId);
+	const pageController = readXmlAttr(compNode, PROJECT_XML_PROTOCOL.componentRoot.attrs.pageController);
+	if (pageController !== void 0) comp.setPageController?.(pageController);
+	const showSound = readXmlAttr(compNode, PROJECT_XML_PROTOCOL.componentRoot.attrs.showSound);
+	if (showSound !== void 0) comp.setAddedToStageSound?.(showSound);
+	const hideSound = readXmlAttr(compNode, PROJECT_XML_PROTOCOL.componentRoot.attrs.hideSound);
+	if (hideSound !== void 0) comp.setRemovedFromStageSound?.(hideSound);
 	const clipSoftness = readXmlAttr(compNode, PROJECT_XML_PROTOCOL.componentRoot.attrs.clipSoftness);
 	if (clipSoftness) {
 		const parts = clipSoftness.split(",").map(Number);
@@ -20244,8 +20740,8 @@ function readComponentXml(ctx, comp, xmlContent) {
 					case "Button":
 						if (readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.mode) !== void 0) comp.setButtonMode?.(parseButtonMode(readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.mode)));
 						if (readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.sound) !== void 0) comp.setSound?.(String(readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.sound)));
-						if (readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.soundVolumeScale) !== void 0) comp.setSoundVolumeScale?.(parseFloat2(readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.soundVolumeScale), 1));
-						if (readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.downEffect) !== void 0) comp.setDownEffect?.(parseInt2(readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.downEffect)));
+						if (readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.soundVolumeScale) !== void 0) comp.setSoundVolumeScale?.(parseFloat2(readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.soundVolumeScale), 100) / 100);
+						if (readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.downEffect) !== void 0) comp.setDownEffect?.(parseButtonDownEffect(readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.downEffect)));
 						if (readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.downEffectValue) !== void 0) comp.setDownEffectValue?.(parseFloat2(readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Button.attrs.downEffectValue), .8));
 						break;
 					case "ComboBox":
@@ -20276,7 +20772,7 @@ function readComponentXml(ctx, comp, xmlContent) {
 	}
 	const customPropertyChildName = getProtocolChildName$1(PROJECT_XML_PROTOCOL.componentRoot, "customProperty");
 	const customProperties = customPropertyChildName ? ensureArray(compNode[customPropertyChildName]) : [];
-	const customPropertyProtocol = PROJECT_XML_PROTOCOL.componentRoot.children?.customProperty;
+	const customPropertyProtocol = PROJECT_XML_PROTOCOL.componentRoot.children.customProperty;
 	comp.setCustomProperties(customProperties.flatMap((value) => {
 		const property = getXmlNode$1(value);
 		const propertyId = property ? parseInt2(readXmlAttr(property, customPropertyProtocol?.attrs.propertyId), -1) : -1;
@@ -20293,13 +20789,24 @@ function readComponentXml(ctx, comp, xmlContent) {
 		const ctrlName = readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.name) ?? "";
 		const ctrl = doc.createController(ctrlName);
 		const selected = readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.selected);
-		ctrl.setSelectedIndex(parseInt2(selected));
+		const homePageType = readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.homePageType) ?? "default";
+		if (!CONTROLLER_HOME_PAGE_TYPES.has(homePageType)) throw new Error(`Controller "${ctrlName}" has unsupported homePageType "${homePageType}".`);
+		ctrl.setSelectedIndex(parseInt2(selected)).setAlias(readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.alias) ?? "").setAutoRadioGroupDepth(parseBool$1(readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.autoRadioGroupDepth))).setExported(parseBool$1(readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.exported))).setHomePageType(homePageType).setHomePage(readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.homePage) ?? "");
 		const pages = parseControllerPages(readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.pages) ?? "");
 		for (const page of pages) {
 			const p = doc.createControllerPage(page.name);
 			p.setId(page.id);
 			ctrl.addPage(p);
 		}
+		const controllerRemarkChildName = getProtocolChildName$1(PROJECT_XML_PROTOCOL.controller, "remark");
+		const controllerRemarkProtocol = PROJECT_XML_PROTOCOL.controller.children.remark;
+		const remarks = controllerRemarkChildName ? ensureArray(ctrlDef[controllerRemarkChildName]) : [];
+		for (const remarkDef of remarks) {
+			const pageIndex = parseInt2(readXmlAttr(remarkDef, controllerRemarkProtocol.attrs.page), -1);
+			const page = ctrl.listPages()[pageIndex];
+			if (!page) continue;
+			page.setRemark(readXmlAttr(remarkDef, controllerRemarkProtocol.attrs.value) ?? "");
+		}
 		const controllerActionChildName = getProtocolChildName$1(PROJECT_XML_PROTOCOL.controller, "action");
 		const actions = controllerActionChildName ? ensureArray(ctrlDef[controllerActionChildName]) : [];
 		for (let actionIndex = 0; actionIndex < actions.length; actionIndex += 1) {
@@ -21265,6 +21772,7 @@ var ProjectReader = class {
 			case "MovieClipResource": return resource.getFileName();
 			case "SoundResource":
 			case "MiscResource":
+			case "SwfResource":
 			case "SpineResource":
 			case "DragonBonesResource": return resource.getFile();
 			default: return "";
@@ -21360,6 +21868,18 @@ var ProjectReader = class {
 				ctx.registerResource(pkg.getId(), id, res);
 				return res;
 			}
+			case "swf": {
+				const res = doc.createSwfResource(name.replace(/\.swf$/i, ""));
+				res.setId(id);
+				res.setPath(path);
+				res.setBranch(branchName);
+				res.setFile(name);
+				res.setExported(exported);
+				res.setFavorite(favorite);
+				pkg.addResource(res);
+				ctx.registerResource(pkg.getId(), id, res);
+				return res;
+			}
 			case "font": {
 				const res = doc.createFontResource(name.replace(/\.\w+$/, ""));
 				res.setId(id);
@@ -21440,6 +21960,7 @@ var ProjectReader = class {
 				ctx.registerResource(pkg.getId(), id, res);
 				return res;
 			}
+			case "atlas": return null;
 			default:
 				ctx.addDiagnostic({
 					severity: "error",
@@ -21832,6 +22353,13 @@ function formatButtonMode(mode) {
 		2: "Radio"
 	}[mode] ?? "Common";
 }
+function formatButtonDownEffect(effect) {
+	return [
+		"none",
+		"dark",
+		"scale"
+	][effect] ?? "none";
+}
 function formatTitleType(titleType) {
 	return {
 		0: "percent",
@@ -22094,6 +22622,7 @@ function serializeChild(obj) {
 		if (typedObj.getShrinkOnly?.()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.loader.attrs.shrinkOnly, "1");
 		if (typedObj.getAutoSize?.()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.loader.attrs.autoSize, "1");
 		if (typedObj.getUseResize?.()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.loader.attrs.useResize, "1");
+		if (typedObj.getShowErrorSign?.()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.loader.attrs.errorSign, "true");
 		const loaderColor = typedObj.getColor?.();
 		if (loaderColor && !isDefaultWhiteColor(loaderColor)) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.loader.attrs.color, loaderColor);
 		if (typedObj.getFilter?.()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.loader.attrs.filter, typedObj.getFilter?.());
@@ -22155,10 +22684,14 @@ function serializeChild(obj) {
 			if (typedObj.getTemplateVarsEnabled?.()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.vars, "true");
 			const faceDilate = typedObj.getFaceDilate?.() ?? 0;
 			if (faceDilate !== 0) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.faceDilate, String(faceDilate));
+			const outlineSoftness = typedObj.getOutlineSoftness?.() ?? 0;
+			if (outlineSoftness !== 0) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.outlineSoftness, String(outlineSoftness));
 			const underlaySoftness = typedObj.getUnderlaySoftness?.() ?? 0;
 			if (underlaySoftness !== 0) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.text.attrs.underlaySoftness, String(underlaySoftness));
 		}
 		if (type === "GRichTextField") {
+			const outlineSoftness = typedObj.getOutlineSoftness?.() ?? 0;
+			if (outlineSoftness !== 0) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.richText.attrs.outlineSoftness, String(outlineSoftness));
 			const underlaySoftness = typedObj.getUnderlaySoftness?.() ?? 0;
 			if (underlaySoftness !== 0) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.richText.attrs.underlaySoftness, String(underlaySoftness));
 		}
@@ -22287,7 +22820,8 @@ function serializeChild(obj) {
 		if ((layout === 2 || layout === 4) && columnCount !== 0) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.lineItemCount, String(columnCount));
 		else if (layout === 3 && lineCount !== 0) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.lineItemCount, String(lineCount));
 		if (layout === 4 && lineCount !== 0) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.lineItemCount2, String(lineCount));
-		if (typedObj.getAutoResizeItem?.() === false) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.autoResizeItem, "false");
+		const autoResizeItem = typedObj.getAutoResizeItem?.() ?? true;
+		if (autoResizeItem !== getDefaultListAutoResizeItem(layout ?? 0)) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.autoResizeItem, String(autoResizeItem));
 		const childrenRenderOrder = typedObj.getChildrenRenderOrder?.() ?? 0;
 		if (childrenRenderOrder !== 0) {
 			writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.childrenRenderOrder, {
@@ -22328,6 +22862,13 @@ function serializeChild(obj) {
 			1: "vertical",
 			2: "both"
 		}[scrollType] ?? "vertical");
+		const scrollBarDisplay = typedObj.getScrollBarDisplay?.() ?? 0;
+		if (overflow === 2 && scrollBarDisplay !== 0) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.scrollBar, {
+			0: "default",
+			1: "visible",
+			2: "auto",
+			3: "hidden"
+		}[scrollBarDisplay] ?? "default");
 		const scrollBarFlags = typedObj.getScrollBarFlags?.() ?? 0;
 		if (scrollBarFlags !== 0) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.scrollBarFlags, String(scrollBarFlags));
 		const scrollBarMargin = typedObj.getScrollBarMargin?.();
@@ -22428,8 +22969,13 @@ function serializeChild(obj) {
 			if (typedObj.getInstanceController?.() && extSpecs.controller) writeXmlAttr(extAttrs, extSpecs.controller, typedObj.getInstanceController?.());
 			if (typedObj.getInstancePage?.() && extSpecs.page) writeXmlAttr(extAttrs, extSpecs.page, typedObj.getInstancePage?.());
 			if (typedObj.getInstanceChecked?.() && extSpecs.checked) writeXmlAttr(extAttrs, extSpecs.checked, "1");
+			const popupDirection = typedObj.getInstancePopupDirection?.() ?? 0;
+			if (popupDirection !== 0 && extSpecs.popupDirection) writeXmlAttr(extAttrs, extSpecs.popupDirection, {
+				1: "up",
+				2: "down"
+			}[popupDirection]);
 			if (typedObj.getInstanceSound?.() && extSpecs.sound) writeXmlAttr(extAttrs, extSpecs.sound, typedObj.getInstanceSound?.());
-			if ((typedObj.getInstanceSoundVolumeScale?.() ?? 1) !== 1 && extSpecs.soundVolumeScale) writeXmlAttr(extAttrs, extSpecs.soundVolumeScale, String(typedObj.getInstanceSoundVolumeScale?.() ?? 1));
+			if ((typedObj.getInstanceSoundVolumeScale?.() ?? 1) !== 1 && extSpecs.soundVolumeScale) writeXmlAttr(extAttrs, extSpecs.soundVolumeScale, formatProjectInt32(Math.round((typedObj.getInstanceSoundVolumeScale?.() ?? 1) * 100), "component instance volume"));
 			if (typedObj.getInstancePromptText?.() && extSpecs.prompt) writeXmlAttr(extAttrs, extSpecs.prompt, typedObj.getInstancePromptText?.());
 			if (typedObj.getInstanceSelectionController?.() && extSpecs.selectionController) writeXmlAttr(extAttrs, extSpecs.selectionController, typedObj.getInstanceSelectionController?.());
 			if ((typedObj.getInstanceVisibleItemCount?.() ?? 0) > 0 && extSpecs.visibleItemCount) writeXmlAttr(extAttrs, extSpecs.visibleItemCount, String(typedObj.getInstanceVisibleItemCount?.() ?? 0));
@@ -22607,8 +23153,11 @@ async function writeComponent(fs, comp, pkgDir, sourceRelativePath) {
 	if (typedComp.getBgColorEnabled?.()) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.bgColorEnabled, "true");
 	const bgColor = typedComp.getBgColor?.();
 	if (bgColor) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.bgColor, bgColor);
-	const designImageAlpha = typedComp.getDesignImageAlpha?.() ?? 0;
-	if (designImageAlpha !== 0) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.designImageAlpha, String(designImageAlpha));
+	const designImage = typedComp.getDesignImage?.();
+	if (designImage) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.designImage, designImage);
+	if (typedComp.getDesignImageForTest?.()) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.designImageForTest, "true");
+	const designImageAlpha = typedComp.getDesignImageAlpha?.() ?? 50;
+	if (designImageAlpha !== 50) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.designImageAlpha, String(designImageAlpha));
 	const designImageLayer = typedComp.getDesignImageLayer?.() ?? 0;
 	if (designImageLayer !== 0) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.designImageLayer, String(designImageLayer));
 	const designImageOffsetX = typedComp.getDesignImageOffsetX?.() ?? 0;
@@ -22621,6 +23170,14 @@ async function writeComponent(fs, comp, pkgDir, sourceRelativePath) {
 	if (initName) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.initName, initName);
 	const remark = typedComp.getRemark?.();
 	if (remark) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.remark, remark);
+	const customExtensionId = typedComp.getCustomExtensionId?.();
+	if (customExtensionId) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.customExtention, customExtensionId);
+	const pageController = typedComp.getPageController?.();
+	if (pageController) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.pageController, pageController);
+	const showSound = typedComp.getAddedToStageSound?.();
+	if (showSound) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.showSound, showSound);
+	const hideSound = typedComp.getRemovedFromStageSound?.();
+	if (hideSound) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.hideSound, hideSound);
 	const clipSoftness = typedComp.getClipSoftness?.();
 	if (clipSoftness && ((clipSoftness.x ?? 0) !== 0 || (clipSoftness.y ?? 0) !== 0)) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.clipSoftness, formatProjectInt32List([clipSoftness.x ?? 0, clipSoftness.y ?? 0], "component clipSoftness"));
 	if (typedComp.getOpaque?.() === false) writeXmlAttr(compAttrs, PROJECT_XML_PROTOCOL.componentRoot.attrs.opaque, "false");
@@ -22677,7 +23234,7 @@ async function writeComponent(fs, comp, pkgDir, sourceRelativePath) {
 	}
 	const customProperties = typedComp.getCustomProperties?.() ?? [];
 	const customPropertyChildName = getProtocolChildName(PROJECT_XML_PROTOCOL.componentRoot, "customProperty");
-	const customPropertyProtocol = PROJECT_XML_PROTOCOL.componentRoot.children?.customProperty;
+	const customPropertyProtocol = PROJECT_XML_PROTOCOL.componentRoot.children.customProperty;
 	if (customProperties.length > 0 && customPropertyChildName) compNode[customPropertyChildName] = customProperties.map((property) => {
 		const attrs = {};
 		writeXmlAttr(attrs, customPropertyProtocol?.attrs.target, property.target);
@@ -22692,10 +23249,10 @@ async function writeComponent(fs, comp, pkgDir, sourceRelativePath) {
 			case "Button": {
 				if ((typedComp.getButtonMode?.() ?? 0) !== 0) writeXmlAttr(extAttrs, extSpecs.mode, formatButtonMode(typedComp.getButtonMode?.() ?? 0));
 				if (typedComp.getSound?.()) writeXmlAttr(extAttrs, extSpecs.sound, typedComp.getSound?.());
-				if ((typedComp.getSoundVolumeScale?.() ?? 1) !== 1) writeXmlAttr(extAttrs, extSpecs.soundVolumeScale, String(typedComp.getSoundVolumeScale?.() ?? 1));
+				if ((typedComp.getSoundVolumeScale?.() ?? 1) !== 1) writeXmlAttr(extAttrs, extSpecs.soundVolumeScale, String(Math.round((typedComp.getSoundVolumeScale?.() ?? 1) * 100)));
 				const downEffect = typedComp.getDownEffect?.() ?? 0;
 				if (downEffect !== 0) {
-					writeXmlAttr(extAttrs, extSpecs.downEffect, String(downEffect));
+					writeXmlAttr(extAttrs, extSpecs.downEffect, formatButtonDownEffect(downEffect));
 					writeXmlAttr(extAttrs, extSpecs.downEffectValue, formatButtonDownEffectValue(typedComp.getDownEffectValue?.() ?? .8));
 				}
 				break;
@@ -22736,11 +23293,27 @@ async function writeComponent(fs, comp, pkgDir, sourceRelativePath) {
 	await fs.writeFile(targetPath, builder.build(xmlObj));
 }
 function serializeController(ctrl) {
-	const pagesStr = ctrl.listPages().map((p) => `${p.getId()},${p.getName()}`).join(",");
+	const pages = ctrl.listPages();
+	const pagesStr = pages.map((p) => `${p.getId()},${p.getName()}`).join(",");
 	const attrs = {};
 	writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.name, ctrl.getName());
 	writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.pages, pagesStr);
 	writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.selected, String(ctrl.getSelectedIndex()));
+	if (ctrl.getAlias()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.alias, ctrl.getAlias());
+	if (ctrl.getAutoRadioGroupDepth()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.autoRadioGroupDepth, "true");
+	if (ctrl.getExported()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.exported, "true");
+	if (ctrl.getHomePageType() !== "default") writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.homePageType, ctrl.getHomePageType());
+	if (ctrl.getHomePageType() === "specific" || ctrl.getHomePageType() === "variable") writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.homePage, ctrl.getHomePage());
+	const remarkProtocol = PROJECT_XML_PROTOCOL.controller.children.remark;
+	const remarks = pages.flatMap((page, pageIndex) => {
+		if (!page.getRemark()) return [];
+		const remarkAttrs = {};
+		writeXmlAttr(remarkAttrs, remarkProtocol.attrs.page, String(pageIndex));
+		writeXmlAttr(remarkAttrs, remarkProtocol.attrs.value, page.getRemark());
+		return [remarkAttrs];
+	});
+	const remarkChildName = getProtocolChildName(PROJECT_XML_PROTOCOL.controller, "remark");
+	if (remarks.length > 0 && remarkChildName) attrs[remarkChildName] = remarks;
 	const actions = ctrl.listActions().map((action) => serializeControllerAction(action));
 	const actionChildName = getProtocolChildName(PROJECT_XML_PROTOCOL.controller, "action");
 	if (actions.length > 0 && actionChildName) attrs[actionChildName] = actions;
@@ -22855,7 +23428,11 @@ var ProjectWriter = class {
 			if (settings[key] === void 0 && await fs.exists(filePath)) staleOptionalSettings.push(filePath);
 		}
 		if (staleOptionalSettings.length > 0 && !fs.unlink) throw new Error("Project settings cleanup requires a FileSystem.unlink() implementation.");
-		const fairyXml = `<?xml version="1.0" encoding="utf-8"?>\n<projectDescription id="${root.getProjectId()}" type="${this._projectTypeName(root.getProjectType())}" version="${root.getVersion() || "3.0"}"/>\n`;
+		const fairyXml = `<?xml version="1.0" encoding="utf-8"?>\n<projectDescription${renderXmlAttrs({
+			id: root.getProjectId(),
+			type: this._projectTypeName(root.getProjectType()),
+			version: root.getVersion() || "3.0"
+		})}/>\n`;
 		await fs.writeFile(projectPath, fairyXml);
 		await fs.mkdir(settingsPath);
 		for (const [fileName, key] of Object.entries({
@@ -23272,6 +23849,7 @@ var ProjectWriter = class {
 			SoundResource: "sound",
 			FontResource: "font",
 			MovieClipResource: "movieclip",
+			SwfResource: "swf",
 			SpineResource: "spine",
 			DragonBonesResource: "dragonbones"
 		}[propertyType] ?? null;
@@ -23284,7 +23862,7 @@ var ProjectWriter = class {
 			const fileName = res.getFileName?.() ?? "";
 			if (fileName) return fileName;
 		}
-		if (type === "SoundResource" || type === "MiscResource" || type === "SpineResource" || type === "DragonBonesResource") {
+		if (type === "SoundResource" || type === "MiscResource" || type === "SwfResource" || type === "SpineResource" || type === "DragonBonesResource") {
 			const fileName = res.getFile?.() ?? "";
 			if (fileName) return fileName;
 		}
@@ -23531,21 +24109,31 @@ function decodeComponentControllers(doc, resource, buf) {
 				controller.addPage(page);
 			}
 			let homePageIndex = 0;
+			let homePageType = controller.getHomePageType();
+			let homePage = "";
 			if (controllerBuf.version >= 2 && remainingBytes(controllerBuf) >= 1) switch (controllerBuf.getUint8()) {
 				case 1:
-					if (remainingBytes(controllerBuf) >= 2) homePageIndex = controllerBuf.getInt16();
+					homePageType = "specific";
+					if (remainingBytes(controllerBuf) >= 2) {
+						homePageIndex = controllerBuf.getInt16();
+						homePage = controller.listPages()[homePageIndex]?.getId() ?? "";
+					}
 					break;
 				case 2:
+					homePageType = "branch";
 					homePageIndex = 0;
 					break;
 				case 3:
-					if (remainingBytes(controllerBuf) >= 2) controllerBuf.readS();
+					homePageType = "variable";
+					if (remainingBytes(controllerBuf) >= 2) homePage = controllerBuf.readS() ?? "";
 					homePageIndex = 0;
 					break;
 				default:
+					homePageType = "default";
 					homePageIndex = 0;
 					break;
 			}
+			controller.setHomePageType(homePageType).setHomePage(homePage);
 			if (controller.listPages().length > 0) {
 				const maxIndex = controller.listPages().length - 1;
 				controller.setSelectedIndex(Math.min(Math.max(homePageIndex, 0), maxIndex));
@@ -23908,6 +24496,10 @@ function decodeChildBlock4ComponentLike(resource, child, childBuf) {
 		const controller = resource.listControllers()[pageControllerIndex];
 		if (controller && "setPageController" in child && typeof child.setPageController === "function") child.setPageController(controller.getName());
 	}
+	if (childBuf.version >= 2 && remainingBytes(childBuf) >= 2) {
+		const propertyOverrides = decodePropertyOverrides(childBuf);
+		if ("setPropertyOverrides" in child && typeof child.setPropertyOverrides === "function") child.setPropertyOverrides(propertyOverrides);
+	}
 }
 function decodeChildBlock4TextInput(child, childBuf) {
 	if (!childBuf.seek(0, 4) || remainingBytes(childBuf) < 10) return;
@@ -23923,16 +24515,12 @@ function decodeTextChildSpecific(child, childBuf) {
 		y: childBuf.getFloat32()
 	});
 	if (childBuf.readBool()) {}
-	if (childBuf.version >= 3 && remainingBytes(childBuf) >= 13) {
-		textChild.setStrikethrough(childBuf.readBool());
-		childBuf.skip(12);
-	}
+	if (childBuf.version >= 3 && remainingBytes(childBuf) >= 13) textChild.setStrikethrough(childBuf.readBool()).setFaceDilate(childBuf.getFloat32()).setOutlineSoftness(childBuf.getFloat32()).setUnderlaySoftness(childBuf.getFloat32());
 }
 function decodeListScrollPane(child, childBuf) {
 	if (!childBuf.seek(0, 7) || remainingBytes(childBuf) < 10) return;
 	const listLike = child;
-	listLike.setScrollType(childBuf.getUint8());
-	childBuf.getUint8();
+	listLike.setScrollType(childBuf.getUint8()).setScrollBarDisplay(childBuf.getUint8());
 	listLike.setScrollBarFlags(childBuf.getInt32());
 	if (childBuf.readBool() && remainingBytes(childBuf) >= 16) listLike.setScrollBarMargin([
 		childBuf.getInt32(),
@@ -23942,20 +24530,26 @@ function decodeListScrollPane(child, childBuf) {
 	]);
 	listLike.setVtScrollBarRes(childBuf.readS() ?? "").setHzScrollBarRes(childBuf.readS() ?? "").setHeaderRes(childBuf.readS() ?? "").setFooterRes(childBuf.readS() ?? "");
 }
+function decodePropertyOverrides(buf) {
+	const count = buf.getInt16();
+	const properties = [];
+	for (let index = 0; index < count && remainingBytes(buf) >= 6; index += 1) properties.push({
+		target: buf.readS() ?? "",
+		propertyId: buf.getInt16(),
+		value: buf.readS() ?? ""
+	});
+	return properties;
+}
 function decodeListItemOverrides(buf, version) {
-	if (remainingBytes(buf) < 2) return null;
+	if (remainingBytes(buf) < 2) return {};
 	const controllerOverrideCount = buf.getInt16();
 	const controllerParts = [];
 	for (let index = 0; index < controllerOverrideCount && remainingBytes(buf) >= 4; index += 1) controllerParts.push(buf.readS() ?? "", buf.readS() ?? "");
-	if (version >= 2 && remainingBytes(buf) >= 2) {
-		const propertyOverrideCount = buf.getInt16();
-		for (let index = 0; index < propertyOverrideCount && remainingBytes(buf) >= 6; index += 1) {
-			buf.readS();
-			buf.getInt16();
-			buf.readS();
-		}
-	}
-	return controllerParts.length > 0 ? controllerParts.join(",") : null;
+	const propertyOverrides = version >= 2 && remainingBytes(buf) >= 2 ? decodePropertyOverrides(buf) : [];
+	return {
+		...controllerParts.length > 0 ? { controllers: controllerParts.join(",") } : {},
+		...propertyOverrides.length > 0 ? { propertyOverrides } : {}
+	};
 }
 function decodeListItems(child, childBuf) {
 	if (!childBuf.seek(0, 8) || remainingBytes(childBuf) < 4) return;
@@ -23984,10 +24578,9 @@ function decodeListItems(child, childBuf) {
 			level,
 			isFolder
 		};
-		const controllers = decodeListItemOverrides(childBuf, childBuf.version);
-		items.push(controllers === null ? item : {
+		items.push({
 			...item,
-			controllers
+			...decodeListItemOverrides(childBuf, childBuf.version)
 		});
 		childBuf.pos = nextPos;
 	}
@@ -24050,7 +24643,7 @@ function decodeChildBlock5(child, childBuf) {
 			if (remainingBytes(childBuf) < 15) return;
 			const loader = child;
 			loader.setUrl(childBuf.readS() ?? "").setAlign(childBuf.getUint8()).setVAlign(childBuf.getUint8()).setFill(childBuf.getUint8()).setShrinkOnly(childBuf.readBool()).setAutoSize(childBuf.readBool());
-			childBuf.readBool();
+			loader.setShowErrorSign(childBuf.readBool());
 			loader.setPlaying(childBuf.readBool()).setFrame(childBuf.getInt32());
 			if (childBuf.readBool()) loader.setColor(readColorValue(childBuf, false));
 			loader.setFillMethod(childBuf.getUint8());
@@ -24139,10 +24732,7 @@ function decodeChildBlock6(resource, child, childBuf) {
 							childBuf.readBool();
 						}
 					}
-					if (childBuf.version >= 5 && remainingBytes(childBuf) >= 6) {
-						childBuf.readS();
-						childBuf.getFloat32();
-					}
+					if (childBuf.version >= 5 && remainingBytes(childBuf) >= 6) component.setInstanceSound(childBuf.readS() ?? "").setInstanceSoundVolumeScale(childBuf.getFloat32());
 					break;
 				case "ComboBox": {
 					if (remainingBytes(childBuf) < 2) return;
@@ -24160,24 +24750,17 @@ function decodeChildBlock6(resource, child, childBuf) {
 					}
 					component.setInstanceComboItems(items).setInstanceTitle(childBuf.readS() ?? "").setInstanceIcon(childBuf.readS() ?? "");
 					if (childBuf.readBool()) component.setInstanceTitleColor(readColorValue(childBuf, true));
-					component.setInstanceVisibleItemCount(childBuf.getInt32());
-					childBuf.getUint8();
+					component.setInstanceVisibleItemCount(childBuf.getInt32()).setInstancePopupDirection(childBuf.getUint8());
 					const selectionControllerIndex = childBuf.getInt16();
 					if (selectionControllerIndex >= 0) component.setInstanceSelectionController(resource.listControllers()[selectionControllerIndex]?.getName() ?? "");
-					if (childBuf.version >= 5 && remainingBytes(childBuf) >= 6) {
-						childBuf.readS();
-						childBuf.getFloat32();
-					}
+					if (childBuf.version >= 5 && remainingBytes(childBuf) >= 6) component.setInstanceSound(childBuf.readS() ?? "").setInstanceSoundVolumeScale(childBuf.getFloat32());
 					break;
 				}
 				case "ProgressBar":
 				case "Slider":
 					if (remainingBytes(childBuf) < 12) return;
 					component.setInstanceValue(childBuf.getInt32()).setInstanceMax(childBuf.getInt32()).setInstanceMin(childBuf.getInt32());
-					if (extTypeName === "ProgressBar" && childBuf.version >= 5 && remainingBytes(childBuf) >= 6) {
-						childBuf.readS();
-						childBuf.getFloat32();
-					}
+					if (extTypeName === "ProgressBar" && childBuf.version >= 5 && remainingBytes(childBuf) >= 6) component.setInstanceSound(childBuf.readS() ?? "").setInstanceSoundVolumeScale(childBuf.getFloat32());
 					break;
 				default: break;
 			}
@@ -24398,6 +24981,41 @@ function decodeComponentDefinition(resource, rawData, extensionTypeCode, doc) {
 }
 //#endregion
 //#region ../core/src/io/binary-reader.ts
+const DEFAULT_BINARY_READ_LIMITS = {
+	maxCompressedBytes: 64 * 1024 * 1024,
+	maxDecompressedBytes: 256 * 1024 * 1024,
+	maxCompressionRatio: 200
+};
+function readLimits(options) {
+	const limits = {
+		...DEFAULT_BINARY_READ_LIMITS,
+		...options.limits
+	};
+	for (const [name, value] of Object.entries(limits)) if (!Number.isFinite(value) || value <= 0) throw new RangeError(`${name} must be a positive finite number.`);
+	return limits;
+}
+function inflateRawWithLimits(input, limits) {
+	if (input.byteLength > limits.maxCompressedBytes) throw new Error(`FairyGUI binary compressed data exceeds ${limits.maxCompressedBytes} bytes.`);
+	const maxOutputBytes = Math.min(limits.maxDecompressedBytes, Math.floor(input.byteLength * limits.maxCompressionRatio));
+	const chunks = [];
+	let outputLength = 0;
+	const inflater = new Inflate_1({ raw: true });
+	inflater.onData = (chunk) => {
+		if (!(chunk instanceof Uint8Array)) throw new Error("FairyGUI binary inflate returned non-binary data.");
+		outputLength += chunk.byteLength;
+		if (outputLength > maxOutputBytes) throw new Error(`FairyGUI binary decompressed data exceeds the configured ${maxOutputBytes} byte budget.`);
+		chunks.push(chunk);
+	};
+	inflater.push(input, true);
+	if (inflater.err !== 0) throw new Error(`Invalid compressed FairyGUI binary data: ${inflater.msg}`);
+	const output = new Uint8Array(outputLength);
+	let offset = 0;
+	for (const chunk of chunks) {
+		output.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	return output;
+}
 /**
 * Binary item type codes as used in the .fui format.
 * @internal
@@ -24498,7 +25116,7 @@ function decodeFontGlyphs(doc, resource, buf) {
 	for (let index = 0; index < glyphCount; index += 1) {
 		const chunkSize = buf.getInt16();
 		const nextPos = buf.pos + chunkSize;
-		const charId = buf.getInt16();
+		const charId = buf.getUint16();
 		const glyph = doc.createFontGlyph(`${resource.getId()}_${charId || index}`);
 		glyph.setCharId(charId).setChar(decodeChar(charId)).setImg(buf.readS() ?? "").setX(buf.getInt32()).setY(buf.getInt32()).setXOffset(buf.getInt32()).setYOffset(buf.getInt32()).setWidth(buf.getInt32()).setHeight(buf.getInt32()).setAdvance(buf.getInt32()).setChannel(buf.getUint8());
 		resource.addGlyph(glyph);
@@ -24517,8 +25135,10 @@ function decodeFontGlyphs(doc, resource, buf) {
 */
 var BinaryReader = class {
 	_fs;
-	constructor(fs) {
+	_limits;
+	constructor(fs, options = {}) {
 		this._fs = fs;
+		this._limits = readLimits(options);
 	}
 	async read(filePath) {
 		const doc = new Document();
@@ -24544,9 +25164,12 @@ var BinaryReader = class {
 		outer.skip(20);
 		let buf;
 		if (compressed) {
-			const decompressed = inflateRaw_1(new Uint8Array(outer.buffer, outer.byteOffset + outer.pos, outer.byteLength - outer.pos));
+			const decompressed = inflateRawWithLimits(new Uint8Array(outer.buffer, outer.byteOffset + outer.pos, outer.byteLength - outer.pos), this._limits);
 			buf = new ByteBuffer(decompressed.buffer, 0, decompressed.byteLength);
-		} else buf = outer;
+		} else {
+			if (outer.byteLength - outer.pos > this._limits.maxDecompressedBytes) throw new Error(`FairyGUI binary data exceeds ${this._limits.maxDecompressedBytes} bytes.`);
+			buf = outer;
+		}
 		buf.version = outer.version;
 		const indexTablePos = buf.pos;
 		const ver2 = buf.version >= 2;
@@ -24610,13 +25233,13 @@ var BinaryReader = class {
 					if (scaleOpt === 1) {
 						const x = buf.getInt32(), y = buf.getInt32();
 						const w = buf.getInt32(), h = buf.getInt32();
-						buf.getInt32();
+						const tileGridIndice = buf.getInt32();
 						res.setScaleOption(1).setScale9Grid([
 							x,
 							y,
 							w,
 							h
-						]);
+						]).setTileGridIndice(tileGridIndice);
 					} else if (scaleOpt === 2) res.setScaleOption(2);
 					res.setSmoothing(buf.readBool());
 					pkg.addResource(res);
@@ -24654,6 +25277,17 @@ var BinaryReader = class {
 					createdResource = res;
 					break;
 				}
+				case BinItemType$1.Swf: {
+					const res = doc.createSwfResource(itemName);
+					res.setId(itemId).setPath(itemPath).setFile(itemFile).setExported(exported);
+					res.setExtras({
+						...res.getExtras(),
+						_publishedFile: itemFile
+					});
+					pkg.addResource(res);
+					createdResource = res;
+					break;
+				}
 				case BinItemType$1.Component: {
 					const res = doc.createComponent(itemName);
 					res.setId(itemId).setPath(itemPath).setExported(exported).setSize(width, height);
@@ -24664,6 +25298,8 @@ var BinaryReader = class {
 						...getComponentExtras(res),
 						_rawBinary: toRawBinarySlice(rawData)
 					});
+					res._markBinaryClean();
+					doc._trackBinaryComponent();
 					pkg.addResource(res);
 					createdResource = res;
 					break;
@@ -24815,7 +25451,7 @@ var BinaryReader = class {
 *
 * @internal
 */
-var WriteBuffer = class {
+var WriteBuffer = class WriteBuffer {
 	_buf;
 	_view;
 	_pos = 0;
@@ -24825,6 +25461,9 @@ var WriteBuffer = class {
 	_strings;
 	/** Raw custom strings written to block 5, keyed by string table index. */
 	_customStrings;
+	static _assertInteger(value, min, max, type) {
+		if (!Number.isSafeInteger(value) || value < min || value > max) throw new RangeError(`${type} value is out of range: ${value}`);
+	}
 	constructor(initialSize = 4096, parent) {
 		this._buf = new ArrayBuffer(initialSize);
 		this._view = new DataView(this._buf);
@@ -24859,34 +25498,41 @@ var WriteBuffer = class {
 		this._view = new DataView(this._buf);
 	}
 	writeUint8(v) {
+		WriteBuffer._assertInteger(v, 0, 255, "uint8");
 		this._ensure(1);
 		this._view.setUint8(this._pos++, v);
 	}
 	writeInt8(v) {
+		WriteBuffer._assertInteger(v, -128, 127, "int8");
 		this._ensure(1);
 		this._view.setInt8(this._pos++, v);
 	}
 	writeUint16(v) {
+		WriteBuffer._assertInteger(v, 0, 65535, "uint16");
 		this._ensure(2);
 		this._view.setUint16(this._pos, v, false);
 		this._pos += 2;
 	}
 	writeInt16(v) {
+		WriteBuffer._assertInteger(v, -32768, 32767, "int16");
 		this._ensure(2);
 		this._view.setInt16(this._pos, v, false);
 		this._pos += 2;
 	}
 	writeUint32(v) {
+		WriteBuffer._assertInteger(v, 0, 4294967295, "uint32");
 		this._ensure(4);
 		this._view.setUint32(this._pos, v, false);
 		this._pos += 4;
 	}
 	writeInt32(v) {
+		WriteBuffer._assertInteger(v, -2147483648, 2147483647, "int32");
 		this._ensure(4);
 		this._view.setInt32(this._pos, v, false);
 		this._pos += 4;
 	}
 	writeFloat32(v) {
+		if (!Number.isFinite(v)) throw new RangeError(`float32 value must be finite: ${v}`);
 		this._ensure(4);
 		this._view.setFloat32(this._pos, v, false);
 		this._pos += 4;
@@ -24897,6 +25543,7 @@ var WriteBuffer = class {
 	/** Write a uint16-prefixed UTF-8 string. */
 	writeUTFString(s) {
 		const encoded = new TextEncoder().encode(s);
+		if (encoded.byteLength > 65535) throw new RangeError(`UTF string exceeds uint16 byte length: ${encoded.byteLength}`);
 		this.writeUint16(encoded.byteLength);
 		this._ensure(encoded.byteLength);
 		new Uint8Array(this._buf, this._pos, encoded.byteLength).set(encoded);
@@ -24923,6 +25570,7 @@ var WriteBuffer = class {
 		const existing = this._stringMap.get(s);
 		if (existing !== void 0) return existing;
 		const index = this._strings.length;
+		if (index >= 65533) throw new RangeError(`String table exceeds protocol index limit: ${index + 1}`);
 		this._strings.push(s);
 		this._stringMap.set(s, index);
 		return index;
@@ -24959,6 +25607,7 @@ var WriteBuffer = class {
 		if (!noCache) this.writeUint16(this.addString(s));
 		else {
 			const index = this._strings.length;
+			if (index >= 65533) throw new RangeError(`String table exceeds protocol index limit: ${index + 1}`);
 			this._strings.push(s);
 			this.writeUint16(index);
 		}
@@ -25187,7 +25836,27 @@ function _writeControllers(buf, comp) {
 			buf.writeSEx(page.getId?.() ?? "", false, false);
 			buf.writeSEx(page.getName?.() ?? "", false, false);
 		}
-		buf.writeUint8(0);
+		switch (ctrl.getHomePageType()) {
+			case "default":
+				buf.writeUint8(0);
+				break;
+			case "specific": {
+				const homePageIndex = pages.findIndex((page) => page.getId() === ctrl.getHomePage());
+				if (homePageIndex < 0) throw new Error(`Controller "${ctrl.getName()}" references unknown home page id "${ctrl.getHomePage()}".`);
+				buf.writeUint8(1);
+				buf.writeInt16(homePageIndex);
+				break;
+			}
+			case "branch":
+				buf.writeUint8(2);
+				break;
+			case "variable":
+				if (!ctrl.getHomePage()) throw new Error(`Controller "${ctrl.getName()}" requires a custom property key.`);
+				buf.writeUint8(3);
+				buf.writeS(ctrl.getHomePage());
+				break;
+			default: throw new Error(`Controller "${ctrl.getName()}" has unsupported home page type.`);
+		}
 		const cb2 = buf.pos - ctrlIndexPos;
 		const actions = ctrl.listActions?.() ?? [];
 		buf.writeInt16(actions.length);
@@ -25888,7 +26557,7 @@ function _writeDisplayList(buf, comp, _doc, pkg, version) {
 		const isTextInput = childType === "GTextInput";
 		if (isCompOrList) {
 			cb4 = buf.pos - childIndexPos;
-			_writeChildBlock4Component(buf, child, comp, pkg);
+			_writeChildBlock4Component(buf, child, comp, pkg, version);
 		} else if (isTextInput) {
 			cb4 = buf.pos - childIndexPos;
 			_writeChildBlock4TextInput(buf, child);
@@ -25982,9 +26651,9 @@ function _writeChildSpecific(buf, child, pkg, version) {
 			buf.writeBool(false);
 			if (version >= 3) {
 				buf.writeBool(child.getStrikethrough?.() ?? false);
-				buf.writeFloat32(0);
-				buf.writeFloat32(0);
-				buf.writeFloat32(0);
+				buf.writeFloat32(child.getFaceDilate?.() ?? 0);
+				buf.writeFloat32(child.getOutlineSoftness?.() ?? 0);
+				buf.writeFloat32(child.getUnderlaySoftness?.() ?? 0);
 			}
 			break;
 		}
@@ -26036,13 +26705,13 @@ function _writeChildSpecific(buf, child, pkg, version) {
 			buf.writeInt16(child.getMainGridIndex?.() ?? -1);
 			break;
 		case "GLoader": {
-			buf.writeS(remapLocalUiUrl(pkg, child.getUrl?.() ?? null));
+			buf.writeS(remapLocalUiUrl(pkg, child.getClearOnPublish?.() ? null : child.getUrl?.() ?? null));
 			buf.writeUint8(child.getAlign?.() ?? 0);
 			buf.writeUint8(child.getVAlign?.() ?? 0);
 			buf.writeUint8(child.getFill?.() ?? 0);
 			buf.writeBool(child.getShrinkOnly?.() ?? false);
 			buf.writeBool(_boolVal(child.getAutoSize?.(), false));
-			buf.writeBool(false);
+			buf.writeBool(child.getShowErrorSign?.() ?? false);
 			buf.writeBool(child.getPlaying?.() ?? true);
 			buf.writeInt32(child.getFrame?.() ?? 0);
 			const loaderColor = child.getColor?.() ?? null;
@@ -26061,7 +26730,7 @@ function _writeChildSpecific(buf, child, pkg, version) {
 			break;
 		}
 		case "GLoader3D": {
-			buf.writeS(remapLocalUiUrl(pkg, child.getUrl?.() ?? null));
+			buf.writeS(remapLocalUiUrl(pkg, child.getClearOnPublish?.() ? null : child.getUrl?.() ?? null));
 			buf.writeUint8(child.getAlign?.() ?? 0);
 			buf.writeUint8(child.getVAlign?.() ?? 0);
 			buf.writeUint8(child.getFill?.() ?? 0);
@@ -26141,7 +26810,7 @@ function _writeChildAfterAdd(buf, child, comp, pkg, version) {
 		case "GTextField":
 		case "GRichTextField":
 		case "GTextInput":
-			buf.writeSEx(remapLocalUiRefsInText(pkg, child.getText?.() ?? null), true);
+			buf.writeSEx(remapLocalUiRefsInText(pkg, child.getAutoClearText?.() ? null : child.getText?.() ?? null), true);
 			break;
 		case "GButton": {
 			buf.writeUint8(12);
@@ -26206,7 +26875,9 @@ function _writeChildAfterAdd(buf, child, comp, pkg, version) {
 			}
 			buf.writeSEx(child.getTitle?.() ?? null, true);
 			buf.writeS(remapLocalUiUrl(pkg, child.getIcon?.() ?? null));
-			buf.writeBool(false);
+			const comboTitleColor = child.getTitleColor?.() ?? null;
+			buf.writeBool(!!comboTitleColor);
+			if (comboTitleColor) buf.writeColor(comboTitleColor, true);
 			buf.writeInt32(child.getVisibleItemCount?.() ?? 10);
 			buf.writeUint8(child.getPopupDirection?.() ?? 0);
 			buf.writeInt16(-1);
@@ -26288,13 +26959,13 @@ function _writeExtensionInstanceData(buf, extType, child, comp, pkg, version) {
 			buf.writeInt32(child.getInstanceTitleFontSize?.() ?? 0);
 			buf.writeBool(false);
 			if (version >= 5) {
-				buf.writeS(null);
-				buf.writeFloat32(1);
+				buf.writeS(remapLocalUiUrl(pkg, child.getInstanceSound?.() ?? null));
+				buf.writeFloat32(child.getInstanceSoundVolumeScale?.() ?? 1);
 			}
 			break;
 		}
 		case "ComboBox": {
-			const comboItems = child.getInstanceComboItems?.() ?? [];
+			const comboItems = child.getInstanceAutoClearItems?.() ? [] : child.getInstanceComboItems?.() ?? [];
 			buf.writeInt16(comboItems.length);
 			for (const item of comboItems) {
 				const itemStart = buf.pos;
@@ -26314,11 +26985,11 @@ function _writeExtensionInstanceData(buf, extType, child, comp, pkg, version) {
 			buf.writeBool(!!comboTitleColor);
 			if (comboTitleColor) buf.writeColor(comboTitleColor, true);
 			buf.writeInt32(child.getInstanceVisibleItemCount?.() ?? 10);
-			buf.writeUint8(0);
+			buf.writeUint8(child.getInstancePopupDirection?.() ?? 0);
 			buf.writeInt16(-1);
 			if (version >= 5) {
-				buf.writeS(null);
-				buf.writeFloat32(1);
+				buf.writeS(remapLocalUiUrl(pkg, child.getInstanceSound?.() ?? null));
+				buf.writeFloat32(child.getInstanceSoundVolumeScale?.() ?? 1);
 			}
 			break;
 		}
@@ -26328,8 +26999,8 @@ function _writeExtensionInstanceData(buf, extType, child, comp, pkg, version) {
 			buf.writeInt32(child.getInstanceMax?.() ?? 100);
 			buf.writeInt32(child.getInstanceMin?.() ?? 0);
 			if (version >= 5 && extType === "ProgressBar") {
-				buf.writeS(null);
-				buf.writeFloat32(1);
+				buf.writeS(remapLocalUiUrl(pkg, child.getInstanceSound?.() ?? null));
+				buf.writeFloat32(child.getInstanceSoundVolumeScale?.() ?? 1);
 			}
 			break;
 		default: break;
@@ -26337,7 +27008,7 @@ function _writeExtensionInstanceData(buf, extType, child, comp, pkg, version) {
 }
 function _writeScrollPane(buf, child, pkg) {
 	buf.writeUint8(child.getScrollType?.() ?? 1);
-	buf.writeUint8(0);
+	buf.writeUint8(child.getScrollBarDisplay?.() ?? 0);
 	buf.writeInt32(child.getScrollBarFlags?.() ?? 0);
 	const sbMargin = child.getScrollBarMargin?.();
 	buf.writeBool(!!sbMargin);
@@ -26355,7 +27026,7 @@ function _writeScrollPane(buf, child, pkg) {
 function _writeListItems(buf, child, pkg, version) {
 	buf.writeS(remapLocalUiUrl(pkg, child.getDefaultItem?.() ?? null));
 	const isTree = child.propertyType === "GTree";
-	const listItems = child.getListItems?.() ?? [];
+	const listItems = child.getAutoClearItems?.() ? [] : child.getListItems?.() ?? [];
 	buf.writeInt16(listItems.length);
 	for (const [index, item] of listItems.entries()) {
 		const itemStart = buf.pos;
@@ -26385,7 +27056,7 @@ function _writeListItems(buf, child, pkg, version) {
 		buf.pos = controllerCountPos;
 		buf.writeInt16(controllerCount);
 		buf.pos = controllerEnd;
-		if (version >= 2) buf.writeInt16(0);
+		if (version >= 2) _writePropertyOverrides(buf, item.propertyOverrides ?? []);
 		const itemEnd = buf.pos;
 		const saved = buf.pos;
 		buf.pos = itemStart;
@@ -26397,7 +27068,7 @@ function _writeTreeSettings(buf, child) {
 	buf.writeInt32(child.getIndent?.() ?? 0);
 	buf.writeUint8(child.getClickToExpand?.() ?? 0);
 }
-function _writeChildBlock4Component(buf, child, comp, _pkg) {
+function _writeChildBlock4Component(buf, child, comp, _pkg, version) {
 	const pageCtrlName = child.getPageController?.() ?? null;
 	if (pageCtrlName) {
 		const ctrlIdx = comp.listControllers().findIndex((c) => c.getName() === pageCtrlName);
@@ -26419,7 +27090,15 @@ function _writeChildBlock4Component(buf, child, comp, _pkg) {
 		buf.writeInt16(count);
 		buf.pos = saved;
 	} else buf.writeInt16(0);
-	buf.writeInt16(0);
+	if (version >= 2) _writePropertyOverrides(buf, child.getPropertyOverrides?.() ?? []);
+}
+function _writePropertyOverrides(buf, overrides) {
+	buf.writeInt16(overrides.length);
+	for (const property of overrides) {
+		buf.writeS(property.target);
+		buf.writeInt16(property.propertyId);
+		buf.writeSEx(property.value, true);
+	}
 }
 function _writeChildBlock4TextInput(buf, child) {
 	buf.writeSEx(child.getPromptText?.() ?? child.getPrompt?.() ?? null);
@@ -26484,6 +27163,7 @@ const BinItemType = {
 	Component: 3,
 	Atlas: 4,
 	Font: 5,
+	Swf: 6,
 	Misc: 7,
 	Unknown: 8,
 	Spine: 9,
@@ -26501,6 +27181,7 @@ const EDITOR_TYPE_STRING = {
 	SoundResource: "sound",
 	Component: "component",
 	FontResource: "font",
+	SwfResource: "swf",
 	SpineResource: "spine",
 	DragonBonesResource: "dragonbones"
 };
@@ -26649,7 +27330,7 @@ var BinaryWriter = class {
 						data.writeInt32(grid[1]);
 						data.writeInt32(grid[2]);
 						data.writeInt32(grid[3]);
-						data.writeInt32(0);
+						data.writeInt32(res.getTileGridIndice());
 					}
 					data.writeBool(res.getSmoothing());
 					break;
@@ -26703,6 +27384,16 @@ var BinaryWriter = class {
 					data.writeInt32(0);
 					data.writeInt32(0);
 					break;
+				case "SwfResource":
+					data.writeUint8(BinItemType.Swf);
+					data.writeS(getPublishedItemId$1(res));
+					data.writeS(res.getName());
+					data.writeS(res.getPath());
+					data.writeS(getPublishedFileName(res));
+					data.writeBool(res.getExported());
+					data.writeInt32(0);
+					data.writeInt32(0);
+					break;
 				case "Component": {
 					data.writeUint8(BinItemType.Component);
 					data.writeS(getPublishedItemId$1(res));
@@ -26723,7 +27414,7 @@ var BinaryWriter = class {
 					const compExtras = res.getExtras();
 					const extType = res.getExtensionType?.() ?? compExtras.extensionType;
 					data.writeUint8(extType ? extTypeMap[extType] ?? 0 : 0);
-					if (compExtras?._rawBinary) data.writeBuffer(toUint8Array(compExtras._rawBinary));
+					if (compExtras?._rawBinary && !res._isBinaryDirty()) data.writeBuffer(toUint8Array(compExtras._rawBinary));
 					else {
 						const encoded = encodeComponent(res, doc, pkg, version, data);
 						data.writeBuffer(encoded);
@@ -26846,13 +27537,15 @@ var BinaryWriter = class {
 				const oh = sp.originalHeight ?? 0;
 				const isPackageItemSprite = packageItemIds.has(sp.itemId);
 				const isZeroSizedDirectOutput = isPackageItemSprite && sp.w === 0 && sp.h === 0;
-				const hasOriginal = isPackageItemSprite && sp.rotated || ox !== 0 || oy !== 0 || isZeroSizedDirectOutput;
+				const originalWidth = ow || (sp.rotated ? sp.h : sp.w);
+				const originalHeight = oh || (sp.rotated ? sp.w : sp.h);
+				const hasOriginal = isPackageItemSprite && sp.rotated || ox !== 0 || oy !== 0 || originalWidth !== (sp.rotated ? sp.h : sp.w) || originalHeight !== (sp.rotated ? sp.w : sp.h) || isZeroSizedDirectOutput;
 				data.writeBool(hasOriginal);
 				if (hasOriginal) {
 					data.writeInt32(ox);
 					data.writeInt32(oy);
-					data.writeInt32(ow || (sp.rotated ? sp.h : sp.w));
-					data.writeInt32(oh || (sp.rotated ? sp.w : sp.h));
+					data.writeInt32(originalWidth);
+					data.writeInt32(originalHeight);
 				}
 			}
 			const spriteNextPos = data.pos;
@@ -27010,7 +27703,7 @@ function _encodeFontGlyphs(fntData, parentBuf) {
 	for (const glyph of fntData.glyphs) {
 		const glyphStart = buf.pos;
 		buf.writeInt16(0);
-		buf.writeInt16(glyph.charId);
+		buf.writeUint16(glyph.charId);
 		buf.writeS(glyph.img);
 		buf.writeInt32(glyph.x);
 		buf.writeInt32(glyph.y);
@@ -27144,8 +27837,8 @@ var PlatformIO = class {
 	async writeProject(doc, projectPath, options) {
 		return new ProjectWriter(this.createFileSystem()).write(doc, projectPath, options);
 	}
-	async readBinary(filePath) {
-		return new BinaryReader(this.createFileSystem()).read(filePath);
+	async readBinary(filePath, options) {
+		return new BinaryReader(this.createFileSystem(), options).read(filePath);
 	}
 	async writeBinary(doc, filePath, options) {
 		return new BinaryWriter(this.createFileSystem()).write(doc, filePath, options);
@@ -27177,7 +27870,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",
@@ -27200,7 +27893,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
@@ -27258,9 +27951,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?.(),
@@ -27274,11 +27967,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?.());
@@ -27308,7 +28004,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
@@ -27335,6 +28032,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";
 }
@@ -27376,10 +28076,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`;
@@ -27446,16 +28148,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 = [];
@@ -27480,6 +28182,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();
@@ -27491,10 +28194,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;
 				}
@@ -27502,7 +28210,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;
@@ -27511,7 +28219,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);
 			}
@@ -27520,7 +28228,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;
@@ -27544,7 +28252,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();
@@ -27672,6 +28380,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));
 	}
 }
@@ -28930,7 +29642,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,
@@ -29030,7 +29742,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,
@@ -29040,7 +29752,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) {
@@ -29090,6 +29808,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,
@@ -29204,9 +29925,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 = [];
@@ -29225,7 +29945,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);
@@ -29269,6 +29989,8 @@ const ATLAS_DEFAULTS = {
 	allowRotation: true,
 	padding: 1,
 	powerOfTwo: false,
+	maxAtlasIndex: 10,
+	multipleOfFour: false,
 	square: false,
 	multiPage: true,
 	trimImage: false,
@@ -29352,7 +30074,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?.(),
@@ -29366,11 +30088,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 [
@@ -29560,6 +30285,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 ../functions/src/path-utils.ts
 function trimTrailingSlashes(value) {
@@ -29621,23 +30349,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;
 	}
@@ -29701,8 +30440,9 @@ function supportsCodeGenerationLane(doc, codeType) {
 }
 function resolveFguiTypescriptVariant(doc) {
 	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(doc, pkg, plan, fs) {
 	const packageDir = fs.join(plan.outputDir, plan.packageFolderName);
@@ -29885,7 +30625,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` : "",
@@ -29949,6 +30690,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);
@@ -30922,23 +31664,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 {
@@ -30978,16 +31721,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 === 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,
@@ -31010,7 +31757,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);
 		}
 	}
 }
@@ -31107,6 +31856,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 === 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 === ProjectType.Unity && (options.atlas?.extractAlpha ?? (usePackageAtlas || sourceAtlas.extractAlpha ? sourceAtlas.extractAlpha : config.atlas.extractAlpha))
+			};
 			return {
 				pkg,
 				outputDir,
@@ -31118,7 +31880,7 @@ function publish(options) {
 				activeBranch: config.activeBranch,
 				includeHighResolution: config.includeHighResolution,
 				separatedAtlasForBranch: config.separatedAtlasForBranch,
-				atlas: config.atlas
+				atlas
 			};
 		};
 		const createNoopPublishFs = () => ({
@@ -31138,7 +31900,6 @@ function publish(options) {
 			const atlasRuntimeOptions = resolvePublishAtlasRuntimeOptions(plan.fileExtension);
 			await atlas({
 				...plan.atlas,
-				...options.atlas ?? {},
 				separatedAtlasForBranch: plan.separatedAtlasForBranch,
 				encoder: options.encoder,
 				basePath: options.basePath,
@@ -31290,15 +32051,9 @@ var NodeIO = class extends PlatformIO {
 			},
 			async readdir(dirPath) {
 				const entries = await fs$1.readdir(dirPath, { withFileTypes: true });
-				return (await Promise.all(entries.map(async (entry) => {
-					if (entry.isDirectory()) return entry.name;
-					if (!entry.isSymbolicLink()) return null;
-					try {
-						return (await fs$1.stat(path$1.join(dirPath, entry.name))).isDirectory() ? entry.name : null;
-					} catch {
-						return null;
-					}
-				}))).filter((entry) => entry !== null);
+				const symlink = entries.find((entry) => entry.isSymbolicLink());
+				if (symlink) throw new Error(`Symbolic links are not supported in project directories: ${path$1.join(dirPath, symlink.name)}`);
+				return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
 			},
 			async exists(filePath) {
 				try {
@@ -31383,16 +32138,33 @@ async function loadPlugins(doc, pluginsDir) {
 	for (const entry of entries) {
 		if (!entry.isDirectory()) continue;
 		const pluginDir = path.join(pluginsDir, entry.name);
+		let manifest;
+		try {
+			manifest = await readPluginManifest(fs, path, pluginDir);
+		} catch (error) {
+			doc.getLogger().warn(`publish: Plugin "${entry.name}" was skipped: ${formatPluginError(error)}`);
+			continue;
+		}
+		if (!manifest) continue;
+		if (!manifest.main) {
+			const error = /* @__PURE__ */ new Error(`Codegen plugin "${manifest.name}" is missing package.json main.`);
+			if (manifest.required) throw error;
+			doc.getLogger().warn(`publish: Plugin "${manifest.name}" was skipped: ${error.message}`);
+			continue;
+		}
 		try {
-			const manifest = await readPluginManifest(fs, path, pluginDir);
-			if (!manifest) continue;
 			const plugin = await loadPlugin(resolvePluginMain(path, pluginDir, manifest));
 			plugins.push({
 				name: manifest.name,
-				plugin
+				plugin,
+				failureMode: manifest.required ? "abort" : manifest.failureMode
 			});
 		} catch (error) {
-			doc.getLogger().warn(`publish: Plugin "${entry.name}" was skipped: ${formatPluginError(error)}`);
+			if (!manifest.required && manifest.failureMode === "warn") {
+				doc.getLogger().warn(`publish: Plugin "${manifest.name}" was skipped: ${formatPluginError(error)}`);
+				continue;
+			}
+			throw new Error(`publish: Failed to load plugin "${manifest.name}": ${formatPluginError(error)}`);
 		}
 	}
 	return plugins;
@@ -31402,7 +32174,6 @@ async function readPluginManifest(fs, path, pluginDir) {
 	const content = await fs.readFile(manifestPath, "utf-8");
 	const manifest = JSON.parse(content);
 	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;
 }
 function resolvePluginMain(path, pluginDir, manifest) {
@@ -31467,6 +32238,77 @@ async function loadNodePublishPlugins(document, assetsPath) {
 	if (!projectDir) return [];
 	return loadPlugins(document, (await importNative$2("node:path")).join(projectDir, "plugins"));
 }
+async function publishToStagedOutput(output, run) {
+	const [fs, path, { randomUUID }] = await Promise.all([
+		importNative$2("node:fs/promises"),
+		importNative$2("node:path"),
+		importNative$2("node:crypto")
+	]);
+	const target = path.resolve(output);
+	const parent = path.dirname(target);
+	const name = path.basename(target);
+	const staging = path.join(parent, `.${name}.publish-${randomUUID()}`);
+	const backup = path.join(parent, `.${name}.publish-backup-${randomUUID()}`);
+	await fs.mkdir(parent, { recursive: true });
+	let existed = false;
+	try {
+		const stat = await fs.lstat(target);
+		if (stat.isSymbolicLink() || !stat.isDirectory()) throw new Error(`publishNode: output must be a regular directory: ${target}`);
+		await assertNoSymlinks(fs, path, target);
+		existed = true;
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+	try {
+		if (existed) await fs.cp(target, staging, {
+			recursive: true,
+			errorOnExist: true,
+			force: false
+		});
+		else await fs.mkdir(staging);
+	} catch (error) {
+		await fs.rm(staging, {
+			recursive: true,
+			force: true
+		});
+		throw error;
+	}
+	try {
+		await run(staging);
+	} catch (error) {
+		await fs.rm(staging, {
+			recursive: true,
+			force: true
+		});
+		throw error;
+	}
+	if (!existed) {
+		await fs.rename(staging, target);
+		return;
+	}
+	await fs.rename(target, backup);
+	try {
+		await fs.rename(staging, target);
+	} catch (error) {
+		await fs.rename(backup, target);
+		await fs.rm(staging, {
+			recursive: true,
+			force: true
+		});
+		throw error;
+	}
+	await fs.rm(backup, {
+		recursive: true,
+		force: true
+	}).catch(() => void 0);
+}
+async function assertNoSymlinks(fs, path, directory) {
+	for (const entry of await fs.readdir(directory, { withFileTypes: true })) {
+		const entryPath = path.join(directory, entry.name);
+		if (entry.isSymbolicLink()) throw new Error(`publishNode: symbolic links are not supported in output directories: ${entryPath}`);
+		if (entry.isDirectory()) await assertNoSymlinks(fs, path, entryPath);
+	}
+}
 /**
 * Publish a FairyGUI project through the standard Node host adapter.
 *
@@ -31479,17 +32321,25 @@ async function publishNode(options) {
 	const [fileSystem, assetsPath] = await Promise.all([createNodePublishFileSystem(), resolveNodeAssetsPath(document, configuredAssetsPath)]);
 	const [encoder, plugins] = await Promise.all([configuredEncoder === void 0 ? loadSharpBackend() : Promise.resolve(configuredEncoder), configuredPlugins === void 0 ? loadNodePublishPlugins(document, assetsPath) : Promise.resolve(configuredPlugins)]);
 	if (!encoder) throw new Error("publishNode: Sharp is required for a complete publish. Install sharp or provide an encoder.");
-	await document.transform(publish({
-		...publishOptions,
-		basePath: assetsPath,
-		encoder,
-		atlas: {
-			...atlas,
-			readFileRaw: fileSystem.readFileRaw
-		},
-		fs: fileSystem,
-		plugins
-	}));
+	const run = async (output) => {
+		await document.transform(publish({
+			...publishOptions,
+			output,
+			basePath: assetsPath,
+			encoder,
+			atlas: {
+				...atlas,
+				readFileRaw: fileSystem.readFileRaw
+			},
+			fs: fileSystem,
+			plugins
+		}));
+	};
+	if (publishOptions.output) {
+		await publishToStagedOutput(publishOptions.output, run);
+		return;
+	}
+	await run(void 0);
 }
 //#endregion
 //#region ../functions/src/adapters/node/restore.ts
@@ -31666,18 +32516,21 @@ async function validateProjectNode(projectPath) {
 	}
 	const decodedPaths = new Set(images.map(({ packageIndex, resourceIndex }) => `packages[${packageIndex}].resources[${resourceIndex}]`));
 	diagnostics = diagnostics.filter((diagnostic) => diagnostic.code !== "decode_capability_unavailable" || !decodedPaths.has(diagnostic.path));
-	for (const { pkg, packageIndex, resource, resourceIndex } of images) try {
-		await sharp(resource.sourceBytes).raw().toBuffer();
-	} catch (error) {
-		diagnostics.push({
-			severity: "error",
-			code: "corrupt_source",
-			path: `packages[${packageIndex}].resources[${resourceIndex}]`,
-			message: `Image source cannot be decoded: ${error instanceof Error ? error.message : String(error)}`,
-			packageId: pkg.id,
-			resourceId: resource.id,
-			sourcePath: sourceName(resource)
-		});
+	for (const { pkg, packageIndex, resource, resourceIndex } of images) {
+		if (resource.kind !== "image") continue;
+		try {
+			await sharp(resource.sourceBytes).raw().toBuffer();
+		} catch (error) {
+			diagnostics.push({
+				severity: "error",
+				code: "corrupt_source",
+				path: `packages[${packageIndex}].resources[${resourceIndex}]`,
+				message: `Image source cannot be decoded: ${error instanceof Error ? error.message : String(error)}`,
+				packageId: pkg.id,
+				resourceId: resource.id,
+				sourcePath: sourceName(resource)
+			});
+		}
 	}
 	return createProjectValidationReport(diagnostics, read.complete && !diagnostics.some((diagnostic) => diagnostic.code === "decode_capability_unavailable"));
 }
@@ -31724,7 +32577,8 @@ function registerPublishCommand(program) {
 		const pkgFilter = options.packages?.split(",").map((value) => value.trim());
 		const resolved = resolvePublishOptions(doc, {
 			compressed: options.compressed,
-			packages: pkgFilter
+			packages: pkgFilter,
+			targetProjectType: projectType
 		});
 		console.log(`Settings: ext=${resolved.fileExtension}, compressed=${resolved.compressed}`);
 		if (options.branch) console.log(`Active branch: ${options.branch}`);
@@ -31784,7 +32638,7 @@ function registerValidateCommand(program) {
 //#region src/utils/package-version.ts
 const require$1 = createRequire(import.meta.url);
 function getInjectedPackageVersion() {
-	const version = "0.3.0-alpha.4";
+	const version = "0.3.1";
 	return typeof version === "string" && true ? version : null;
 }
 function readPackageVersion() {
@@ -31813,7 +32667,7 @@ function createProgram() {
 		"  openfairygui",
 		"",
 		"Input can be a .fairy file or a project root directory (auto-discovers .fairy file).",
-		"File extension and binary format are read from project settings."
+		"Publish settings are read from the project; --project-type applies target-specific output rules."
 	].join("\n"));
 	return program;
 }