@openfairygui/cli 0.2.0-alpha.34 → 0.2.0-alpha.36

package/dist/cli.mjs

@@ -1250,13 +1250,11 @@ var Root = class extends ExtensibleProperty {
 		return [...this.get("branches")];
 	}
 	setBranches(branches) {
-		return this.set("branches", [...branches]);
+		return this.set("branches", [...new Set(branches)].sort((left, right) => left.localeCompare(right)));
 	}
 	addBranch(branch) {
 		if (!branch) return this;
-		const branches = this.listBranches();
-		if (!branches.includes(branch)) branches.push(branch);
-		return this.set("branches", branches);
+		return this.setBranches([...this.listBranches(), branch]);
 	}
 	getSettings() {
 		return this.get("settings");
@@ -1317,6 +1315,19 @@ var Package = class extends ExtensibleProperty {
 			publishPackageCount: 0,
 			genCode: false,
 			codePath: "",
+			sourceAtlasSettings: {
+				useGlobal: true,
+				maxSize: 2048,
+				sizeOption: "pot",
+				forceSquare: false,
+				allowRotation: false,
+				paging: true,
+				extractAlpha: false,
+				maxIndex: 10,
+				atlases: [],
+				excludedResourceIds: []
+			},
+			branchNames: [],
 			resourceFolders: [],
 			resources: new RefSet(),
 			atlases: new RefSet(),
@@ -1377,6 +1388,31 @@ var Package = class extends ExtensibleProperty {
 	setCodePath(path) {
 		return this.set("codePath", path);
 	}
+	getSourceAtlasSettings() {
+		const settings = this.get("sourceAtlasSettings");
+		return {
+			...settings,
+			atlases: settings.atlases.map((atlas) => ({ ...atlas })),
+			excludedResourceIds: [...settings.excludedResourceIds]
+		};
+	}
+	setSourceAtlasSettings(settings) {
+		return this.set("sourceAtlasSettings", {
+			...settings,
+			atlases: settings.atlases.map((atlas) => ({ ...atlas })),
+			excludedResourceIds: [...settings.excludedResourceIds]
+		});
+	}
+	listBranchNames() {
+		return [...this.get("branchNames")];
+	}
+	setBranchNames(names) {
+		return this.set("branchNames", [...names]);
+	}
+	addBranchName(name) {
+		if (!this.get("branchNames").includes(name)) this.set("branchNames", [...this.get("branchNames"), name]);
+		return this;
+	}
 	listResourceFolders() {
 		return this.get("resourceFolders").map((folder) => ({ ...folder }));
 	}
@@ -2268,6 +2304,7 @@ var Component = class extends ExtensibleProperty {
 			wholeNumbers: false,
 			changeOnClick: true,
 			fixedGripSize: false,
+			autoClearItems: false,
 			opaque: true,
 			customProperties: [],
 			childrenRenderOrder: ChildrenRenderOrder.Ascent,
@@ -2651,6 +2688,12 @@ var Component = class extends ExtensibleProperty {
 	setFixedGripSize(v) {
 		return this.set("fixedGripSize", v);
 	}
+	getAutoClearItems() {
+		return this.get("autoClearItems");
+	}
+	setAutoClearItems(v) {
+		return this.set("autoClearItems", v);
+	}
 	getOpaque() {
 		return this.get("opaque");
 	}
@@ -4901,10 +4944,12 @@ var GComponent = class extends GObject {
 			instancePromptText: "",
 			instanceSelectionController: "",
 			instanceVisibleItemCount: 0,
+			instanceAutoClearItems: false,
 			instanceValue: 0,
 			instanceMax: 0,
 			instanceMin: 0,
-			instanceComboItems: []
+			instanceComboItems: [],
+			propertyOverrides: []
 		});
 	}
 	getComponentProp(key) {
@@ -5200,6 +5245,12 @@ var GComponent = class extends GObject {
 	setInstanceVisibleItemCount(v) {
 		return this.setComponentProp("instanceVisibleItemCount", v);
 	}
+	getInstanceAutoClearItems() {
+		return this.getComponentProp("instanceAutoClearItems");
+	}
+	setInstanceAutoClearItems(v) {
+		return this.setComponentProp("instanceAutoClearItems", v);
+	}
 	getInstanceValue() {
 		return this.getComponentProp("instanceValue");
 	}
@@ -5224,6 +5275,12 @@ var GComponent = class extends GObject {
 	setInstanceComboItems(v) {
 		return this.set("instanceComboItems", v);
 	}
+	getPropertyOverrides() {
+		return this.getComponentProp("propertyOverrides").map((property) => ({ ...property }));
+	}
+	setPropertyOverrides(v) {
+		return this.setComponentProp("propertyOverrides", v.map((property) => ({ ...property })));
+	}
 	getMargin() {
 		return this.getComponentProp("margin");
 	}
@@ -5291,6 +5348,7 @@ var GListBase = class extends GObject {
 			clipSoftness: [0, 0],
 			scrollItemToViewOnClick: true,
 			foldInvisibleItems: false,
+			autoClearItems: false,
 			listItems: [],
 			pageController: "",
 			controllerOverrides: "",
@@ -5583,6 +5641,12 @@ var GListBase = class extends GObject {
 	setFoldInvisibleItems(v) {
 		return this.setListProp("foldInvisibleItems", v);
 	}
+	getAutoClearItems() {
+		return this.getListProp("autoClearItems");
+	}
+	setAutoClearItems(v) {
+		return this.setListProp("autoClearItems", v);
+	}
 	getListItems() {
 		return this.get("listItems");
 	}
@@ -9548,65 +9612,89 @@ function ensureArray(v) {
 }
 //#endregion
 //#region ../core/src/utils/jta-parser.ts
-/**
-* Parser for FairyGUI `.jta` animation files.
-*
-* Extracts individual frame textures (PNG/JPG byte arrays) from the binary format.
-* Used by the atlas packer to include MovieClip frames in texture atlases.
-*
-* @internal
-*/
 const FILE_MARK = "yytou";
+var JtaCursor = class {
+	offset = 0;
+	view;
+	constructor(data) {
+		this.data = data;
+		this.view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+	}
+	readUint8(label) {
+		this.ensure(1, label);
+		return this.view.getUint8(this.offset++);
+	}
+	readInt8(label) {
+		this.ensure(1, label);
+		return this.view.getInt8(this.offset++);
+	}
+	readUint16(label) {
+		this.ensure(2, label);
+		const value = this.view.getUint16(this.offset, false);
+		this.offset += 2;
+		return value;
+	}
+	readInt16(label) {
+		this.ensure(2, label);
+		const value = this.view.getInt16(this.offset, false);
+		this.offset += 2;
+		return value;
+	}
+	readInt32(label) {
+		this.ensure(4, label);
+		const value = this.view.getInt32(this.offset, false);
+		this.offset += 4;
+		return value;
+	}
+	readBytes(length, label) {
+		if (!Number.isInteger(length) || length < 0) throw new Error(`Invalid .jta file: negative ${label} length`);
+		this.ensure(length, label);
+		const value = this.data.subarray(this.offset, this.offset + length);
+		this.offset += length;
+		return value;
+	}
+	skip(length, label) {
+		this.ensure(length, label);
+		this.offset += length;
+	}
+	ensure(length, label) {
+		if (this.offset + length > this.data.byteLength) throw new Error(`Invalid .jta file: truncated ${label}`);
+	}
+};
 /**
 * Parse a `.jta` binary buffer into frame and texture data.
 */
 function parseJta(data) {
-	const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
-	let pos = 0;
-	const markLen = view.getUint16(pos);
-	pos += 2;
-	if (pos + markLen > data.length) throw new Error("Invalid .jta file: truncated file mark");
-	const mark = new TextDecoder("utf-8").decode(data.subarray(pos, pos + markLen));
-	pos += markLen;
+	const cursor = new JtaCursor(data);
+	const markLen = cursor.readUint16("file mark length");
+	const mark = new TextDecoder("utf-8").decode(cursor.readBytes(markLen, "file mark"));
 	if (mark !== FILE_MARK) throw new Error(`Invalid .jta file: expected "${FILE_MARK}", got "${mark}"`);
-	const version = view.getInt32(pos);
-	pos += 4;
+	const version = cursor.readInt32("version");
 	if (version < 100 || version > 102) throw new Error(`Unsupported .jta version: ${version}`);
-	let fps = view.getInt8(pos);
-	pos += 1;
+	let fps = cursor.readInt8("fps");
+	if (fps < 0) throw new Error(`Invalid .jta file: negative fps ${fps}`);
 	if (fps === 0) fps = 24;
-	pos += 3;
+	cursor.skip(3, "reserved header");
 	let boundsWidth = 0, boundsHeight = 0;
 	if (version >= 102) {
-		pos += 4;
-		boundsWidth = view.getUint16(pos);
-		pos += 2;
-		boundsHeight = view.getUint16(pos);
-		pos += 2;
-	}
-	const speed = view.getUint8(pos);
-	pos += 1;
-	const repeatDelay = view.getUint8(pos);
-	pos += 1;
-	const swing = view.getInt8(pos) === 1;
-	pos += 1;
-	const frameCount = view.getInt16(pos);
-	pos += 2;
+		cursor.skip(4, "bounds origin");
+		boundsWidth = cursor.readUint16("bounds width");
+		boundsHeight = cursor.readUint16("bounds height");
+	}
+	const speed = cursor.readUint8("speed");
+	const repeatDelay = cursor.readUint8("repeat delay");
+	const swing = cursor.readInt8("swing") === 1;
+	const frameCount = cursor.readInt16("frame count");
 	if (frameCount < 0) throw new Error("Invalid .jta file: negative frame count");
 	const frames = [];
 	for (let i = 0; i < frameCount; i++) {
-		const delay = view.getInt16(pos);
-		pos += 2;
-		const rectX = view.getInt16(pos);
-		pos += 2;
-		const rectY = view.getInt16(pos);
-		pos += 2;
-		const rectWidth = view.getInt16(pos);
-		pos += 2;
-		const rectHeight = view.getInt16(pos);
-		pos += 2;
-		const textureIndex = view.getInt16(pos);
-		pos += 2;
+		const delay = cursor.readInt16(`frame ${i} delay`);
+		const rectX = cursor.readInt16(`frame ${i} rect x`);
+		const rectY = cursor.readInt16(`frame ${i} rect y`);
+		const rectWidth = cursor.readInt16(`frame ${i} rect width`);
+		const rectHeight = cursor.readInt16(`frame ${i} rect height`);
+		const textureIndex = cursor.readInt16(`frame ${i} texture index`);
+		if (delay < 0 || rectWidth < 0 || rectHeight < 0) throw new Error(`Invalid .jta file: frame ${i} has negative delay or dimensions`);
 		frames.push({
 			delay,
 			rectX,
@@ -9616,27 +9704,17 @@ function parseJta(data) {
 			textureIndex
 		});
 	}
-	const textureCount = view.getInt16(pos);
-	pos += 2;
+	const textureCount = cursor.readInt16("texture count");
 	if (textureCount < 0) throw new Error("Invalid .jta file: negative texture count");
 	const textures = [];
 	for (let i = 0; i < textureCount; i++) {
-		const rawLen = view.getInt32(pos);
-		pos += 4;
-		if (rawLen < 0 || pos + rawLen > data.length) throw new Error("Invalid .jta file: truncated texture data");
-		let raw;
-		if (rawLen > 0) {
-			raw = data.subarray(pos, pos + rawLen);
-			pos += rawLen;
-		} else raw = new Uint8Array(0);
-		textures.push({ raw });
+		const rawLen = cursor.readInt32(`texture ${i} length`);
+		textures.push({ raw: cursor.readBytes(rawLen, `texture ${i} data`) });
 	}
 	if (version === 101) {
-		pos += 4;
-		boundsWidth = view.getUint16(pos);
-		pos += 2;
-		boundsHeight = view.getUint16(pos);
-		pos += 2;
+		cursor.skip(4, "bounds origin");
+		boundsWidth = cursor.readUint16("bounds width");
+		boundsHeight = cursor.readUint16("bounds height");
 	} else if (version === 100) {
 		let minX = Number.POSITIVE_INFINITY;
 		let minY = Number.POSITIVE_INFINITY;
@@ -9654,6 +9732,10 @@ function parseJta(data) {
 			boundsHeight = maxY - Math.min(minY, 0);
 		}
 	}
+	for (let index = 0; index < frames.length; index += 1) {
+		const textureIndex = frames[index].textureIndex;
+		if (textureIndex < -1 || textureIndex >= textures.length) throw new Error(`Invalid .jta file: frame ${index} texture index ${textureIndex} is outside -1..${textures.length - 1}`);
+	}
 	return {
 		version,
 		fps,
@@ -9666,211 +9748,37 @@ function parseJta(data) {
 		textures
 	};
 }
-function tryReadJtaSize(data) {
-	try {
-		const parsed = parseJta(data);
-		return {
+/** Converts parsed JTA frame units to the millisecond-based Document/UAM model. */
+function deriveMovieClipModel(parsed) {
+	const millisecondsPerFrame = 1e3 / parsed.fps;
+	return {
+		dimensions: {
 			width: parsed.boundsWidth,
 			height: parsed.boundsHeight
-		};
-	} catch {
-		return null;
-	}
-}
-//#endregion
-//#region ../core/src/document.ts
-/**
-* Wraps a FairyGUI project and its resources for easier modification.
-*
-* Documents manage FairyGUI assets and the relationships among dependencies using an
-* internal property graph. A new resource is created by calling 'create' methods on the
-* document. Resources are destroyed by calling {@link Property.dispose}().
-*
-* Usage:
-*
-* ```ts
-* const document = new Document();
-* const pkg = document.createPackage('MyPackage');
-* const component = document.createComponent('Button');
-* const image = document.createGImage('bg');
-* component.addChild(image);
-* pkg.addResource(component);
-* ```
-*
-* @category Documents
-*/
-var Document = class Document {
-	_graph = new Graph();
-	_root = new Root(this._graph);
-	_logger = Logger.DEFAULT_INSTANCE;
-	_projectDir = "";
-	static _GRAPH_DOCUMENTS = /* @__PURE__ */ new WeakMap();
-	static fromGraph(graph) {
-		return Document._GRAPH_DOCUMENTS.get(graph) || null;
-	}
-	constructor() {
-		Document._GRAPH_DOCUMENTS.set(this._graph, this);
-	}
-	getRoot() {
-		return this._root;
-	}
-	/** @hidden */
-	getGraph() {
-		return this._graph;
-	}
-	getLogger() {
-		return this._logger;
-	}
-	setLogger(logger) {
-		this._logger = logger;
-		return this;
-	}
-	getProjectDir() {
-		return this._projectDir;
-	}
-	setProjectDir(projectDir) {
-		this._projectDir = projectDir;
-		return this;
-	}
-	async transform(...transforms) {
-		const stack = transforms.map((fn) => fn.name);
-		for (const transform of transforms) await transform(this, { stack });
-		return this;
-	}
-	/****** Extension factory methods ******/
-	createExtension(ctor) {
-		const extensionName = ctor.EXTENSION_NAME;
-		return this.getRoot().listExtensionsUsed().find((ext) => ext.extensionName === extensionName) || new ctor(this);
-	}
-	/****** Property factory methods ******/
-	createPackage(name = "") {
-		return new Package(this._graph, name);
-	}
-	createImageResource(name = "") {
-		return new ImageResource(this._graph, name);
-	}
-	createSoundResource(name = "") {
-		return new SoundResource(this._graph, name);
-	}
-	createMiscResource(name = "") {
-		return new MiscResource(this._graph, name);
-	}
-	createFontResource(name = "") {
-		return new FontResource(this._graph, name);
-	}
-	createMovieClipResource(name = "") {
-		return new MovieClipResource(this._graph, name);
-	}
-	createSpineResource(name = "") {
-		return new SpineResource(this._graph, name);
-	}
-	createDragonBonesResource(name = "") {
-		return new DragonBonesResource(this._graph, name);
-	}
-	createComponent(name = "") {
-		return new Component(this._graph, name);
-	}
-	createAtlas(name = "") {
-		return new Atlas(this._graph, name);
-	}
-	createSprite(name = "") {
-		return new Sprite(this._graph, name);
-	}
-	createBuffer(name = "") {
-		return new FairyBuffer(this._graph, name);
-	}
-	createGImage(name = "") {
-		return new GImage(this._graph, name);
-	}
-	createGTextField(name = "") {
-		return new GTextField(this._graph, name);
-	}
-	createGRichTextField(name = "") {
-		return new GRichTextField(this._graph, name);
-	}
-	createGTextInput(name = "") {
-		return new GTextInput(this._graph, name);
-	}
-	createGGraph(name = "") {
-		return new GGraph(this._graph, name);
-	}
-	createGGroup(name = "") {
-		return new GGroup(this._graph, name);
-	}
-	createGLoader(name = "") {
-		return new GLoader(this._graph, name);
-	}
-	createGLoader3D(name = "") {
-		return new GLoader3D(this._graph, name);
-	}
-	createGMovieClip(name = "") {
-		return new GMovieClip(this._graph, name);
-	}
-	createGComponent(name = "") {
-		return new GComponent(this._graph, name);
-	}
-	createGList(name = "") {
-		return new GList(this._graph, name);
-	}
-	createGTree(name = "") {
-		return new GTree(this._graph, name);
-	}
-	createGButton(name = "") {
-		return new GButton(this._graph, name);
-	}
-	createGLabel(name = "") {
-		return new GLabel(this._graph, name);
-	}
-	createGComboBox(name = "") {
-		return new GComboBox(this._graph, name);
-	}
-	createGProgressBar(name = "") {
-		return new GProgressBar(this._graph, name);
-	}
-	createGSlider(name = "") {
-		return new GSlider(this._graph, name);
-	}
-	createGScrollBar(name = "") {
-		return new GScrollBar(this._graph, name);
-	}
-	createController(name = "") {
-		return new Controller(this._graph, name);
-	}
-	createControllerPage(name = "") {
-		return new ControllerPage(this._graph, name);
-	}
-	createControllerAction(name = "") {
-		return new ControllerAction(this._graph, name);
-	}
-	createTransition(name = "") {
-		return new Transition(this._graph, name);
-	}
-	createTransitionItem(name = "") {
-		return new TransitionItem(this._graph, name);
-	}
-	createGear(name = "") {
-		return new Gear(this._graph, name);
-	}
-	createFontGlyph(name = "") {
-		return new FontGlyph(this._graph, name);
-	}
-	createMovieFrame(name = "") {
-		return new MovieFrame(this._graph, name);
-	}
-};
-//#endregion
-//#region ../core/src/utils/resource-folder.ts
-function normalizeResourceFolderPath(value) {
-	const segments = value.replace(/\\/g, "/").split("/").filter(Boolean);
-	return segments.length > 0 ? `/${segments.join("/")}/` : "/";
+		},
+		interval: Math.trunc(millisecondsPerFrame * (parsed.speed || 1)),
+		repeatDelay: Math.trunc(millisecondsPerFrame * parsed.repeatDelay),
+		swing: parsed.swing,
+		frames: parsed.frames.map((frame) => ({
+			rectX: frame.rectX,
+			rectY: frame.rectY,
+			rectWidth: frame.rectWidth,
+			rectHeight: frame.rectHeight,
+			addDelay: Math.trunc(millisecondsPerFrame * frame.delay),
+			textureIndex: frame.textureIndex
+		}))
+	};
 }
-function resourceFolderParentPath(value) {
-	const segments = normalizeResourceFolderPath(value).split("/").filter(Boolean);
-	segments.pop();
-	return segments.length > 0 ? `/${segments.join("/")}/` : "/";
+/** Parses JTA bytes and derives the Document/UAM MovieClip model. */
+function deriveMovieClipModelFromJta(data) {
+	return deriveMovieClipModel(parseJta(data));
 }
-function resourceFolderName(value) {
-	return normalizeResourceFolderPath(value).split("/").filter(Boolean).pop() ?? "";
+/** Applies a fully parsed JTA model without changing XML-owned MovieClip settings such as smoothing. */
+function applyDerivedMovieClipModel(doc, resource, model) {
+	const frames = model.frames.map((frame, index) => doc.createMovieFrame(`${resource.getId()}_${index}`).setRectX(frame.rectX).setRectY(frame.rectY).setRectWidth(frame.rectWidth).setRectHeight(frame.rectHeight).setAddDelay(frame.addDelay).setSpriteId(""));
+	for (const frame of resource.listFrames()) resource.removeFrame(frame);
+	resource.setWidth(model.dimensions.width).setHeight(model.dimensions.height).setInterval(model.interval).setRepeatDelay(model.repeatDelay).setSwing(model.swing);
+	for (const frame of frames) resource.addFrame(frame);
 }
 //#endregion
 //#region ../../node_modules/.pnpm/jpeg-js@0.4.4/node_modules/jpeg-js/lib/encoder.js
@@ -15743,7 +15651,7 @@ var inflateRaw_1 = inflateRaw;
 //#endregion
 //#region ../core/src/utils/image-info.ts
 var import_jpeg_js = require_jpeg_js();
-const PNG_SIGNATURE$1 = [
+const PNG_SIGNATURE = [
 	137,
 	80,
 	78,
@@ -15889,9 +15797,9 @@ function validatePngImageData(parts, width, height, bitDepth, colorType, interla
 	}
 }
 function readPngInfo(data, validateImageData) {
-	if (data.length < (validateImageData ? 45 : 33) || PNG_SIGNATURE$1.some((byte, index) => data[index] !== byte)) return null;
+	if (data.length < (validateImageData ? 45 : 33) || PNG_SIGNATURE.some((byte, index) => data[index] !== byte)) return null;
 	const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
-	let offset = PNG_SIGNATURE$1.length;
+	let offset = PNG_SIGNATURE.length;
 	let width = 0;
 	let height = 0;
 	let bitDepth = 0;
@@ -16118,30 +16026,237 @@ function readJpegInfo(data, decodePixels) {
 	}
 	return null;
 }
+/**
+* Strictly validate a complete PNG or JPEG source and return its decoded dimensions.
+*
+* Unlike `probeRasterImageDimensions`, this validates PNG image data and fully
+* decodes JPEG pixels. Unsupported formats and malformed inputs return `null`.
+*/
+function probeRasterImage(data) {
+	if (asyncProbeResults.has(data)) return asyncProbeResults.get(data) ?? null;
+	if (data.byteLength > MAX_SYNC_RASTER_BYTES) return null;
+	return readPngInfo(data, true) ?? readJpegInfo(data, true);
+}
 function probeRasterImageDimensions(data) {
 	if (asyncProbeResults.has(data)) return asyncProbeResults.get(data) ?? null;
 	if (data.byteLength > MAX_SYNC_RASTER_BYTES) return null;
 	return readPngInfo(data, false) ?? readJpegInfo(data, false);
 }
 //#endregion
-//#region ../core/src/io/project-xml-protocol.ts
-const mergeAttrs = (...parts) => Object.assign({}, ...parts);
-const mergeChildren = (...parts) => Object.assign({}, ...parts);
-const mergeContainers = (...parts) => Object.assign({}, ...parts);
-const defineContainer = (items) => ({
-	kind: "orderedVariants",
-	items
-});
-const defineNode = (attrs, children, containers) => ({
-	attrs,
-	...children ? { children } : {},
-	...containers ? { containers } : {}
+//#region ../core/src/document.ts
+/**
+* Wraps a FairyGUI project and its resources for easier modification.
+*
+* Documents manage FairyGUI assets and the relationships among dependencies using an
+* internal property graph. A new resource is created by calling 'create' methods on the
+* document. Resources are destroyed by calling {@link Property.dispose}().
+*
+* Usage:
+*
+* ```ts
+* const document = new Document();
+* const pkg = document.createPackage('MyPackage');
+* const component = document.createComponent('Button');
+* const image = document.createGImage('bg');
+* component.addChild(image);
+* pkg.addResource(component);
+* ```
+*
+* @category Documents
+*/
+var Document = class Document {
+	_graph = new Graph();
+	_root = new Root(this._graph);
+	_logger = Logger.DEFAULT_INSTANCE;
+	_projectDir = "";
+	static _GRAPH_DOCUMENTS = /* @__PURE__ */ new WeakMap();
+	static fromGraph(graph) {
+		return Document._GRAPH_DOCUMENTS.get(graph) || null;
+	}
+	constructor() {
+		Document._GRAPH_DOCUMENTS.set(this._graph, this);
+	}
+	getRoot() {
+		return this._root;
+	}
+	/** @hidden */
+	getGraph() {
+		return this._graph;
+	}
+	getLogger() {
+		return this._logger;
+	}
+	setLogger(logger) {
+		this._logger = logger;
+		return this;
+	}
+	getProjectDir() {
+		return this._projectDir;
+	}
+	setProjectDir(projectDir) {
+		this._projectDir = projectDir;
+		return this;
+	}
+	async transform(...transforms) {
+		const stack = transforms.map((fn) => fn.name);
+		for (const transform of transforms) await transform(this, { stack });
+		return this;
+	}
+	/****** Extension factory methods ******/
+	createExtension(ctor) {
+		const extensionName = ctor.EXTENSION_NAME;
+		return this.getRoot().listExtensionsUsed().find((ext) => ext.extensionName === extensionName) || new ctor(this);
+	}
+	/****** Property factory methods ******/
+	createPackage(name = "") {
+		return new Package(this._graph, name);
+	}
+	createImageResource(name = "") {
+		return new ImageResource(this._graph, name);
+	}
+	createSoundResource(name = "") {
+		return new SoundResource(this._graph, name);
+	}
+	createMiscResource(name = "") {
+		return new MiscResource(this._graph, name);
+	}
+	createFontResource(name = "") {
+		return new FontResource(this._graph, name);
+	}
+	createMovieClipResource(name = "") {
+		return new MovieClipResource(this._graph, name);
+	}
+	createSpineResource(name = "") {
+		return new SpineResource(this._graph, name);
+	}
+	createDragonBonesResource(name = "") {
+		return new DragonBonesResource(this._graph, name);
+	}
+	createComponent(name = "") {
+		return new Component(this._graph, name);
+	}
+	createAtlas(name = "") {
+		return new Atlas(this._graph, name);
+	}
+	createSprite(name = "") {
+		return new Sprite(this._graph, name);
+	}
+	createBuffer(name = "") {
+		return new FairyBuffer(this._graph, name);
+	}
+	createGImage(name = "") {
+		return new GImage(this._graph, name);
+	}
+	createGTextField(name = "") {
+		return new GTextField(this._graph, name);
+	}
+	createGRichTextField(name = "") {
+		return new GRichTextField(this._graph, name);
+	}
+	createGTextInput(name = "") {
+		return new GTextInput(this._graph, name);
+	}
+	createGGraph(name = "") {
+		return new GGraph(this._graph, name);
+	}
+	createGGroup(name = "") {
+		return new GGroup(this._graph, name);
+	}
+	createGLoader(name = "") {
+		return new GLoader(this._graph, name);
+	}
+	createGLoader3D(name = "") {
+		return new GLoader3D(this._graph, name);
+	}
+	createGMovieClip(name = "") {
+		return new GMovieClip(this._graph, name);
+	}
+	createGComponent(name = "") {
+		return new GComponent(this._graph, name);
+	}
+	createGList(name = "") {
+		return new GList(this._graph, name);
+	}
+	createGTree(name = "") {
+		return new GTree(this._graph, name);
+	}
+	createGButton(name = "") {
+		return new GButton(this._graph, name);
+	}
+	createGLabel(name = "") {
+		return new GLabel(this._graph, name);
+	}
+	createGComboBox(name = "") {
+		return new GComboBox(this._graph, name);
+	}
+	createGProgressBar(name = "") {
+		return new GProgressBar(this._graph, name);
+	}
+	createGSlider(name = "") {
+		return new GSlider(this._graph, name);
+	}
+	createGScrollBar(name = "") {
+		return new GScrollBar(this._graph, name);
+	}
+	createController(name = "") {
+		return new Controller(this._graph, name);
+	}
+	createControllerPage(name = "") {
+		return new ControllerPage(this._graph, name);
+	}
+	createControllerAction(name = "") {
+		return new ControllerAction(this._graph, name);
+	}
+	createTransition(name = "") {
+		return new Transition(this._graph, name);
+	}
+	createTransitionItem(name = "") {
+		return new TransitionItem(this._graph, name);
+	}
+	createGear(name = "") {
+		return new Gear(this._graph, name);
+	}
+	createFontGlyph(name = "") {
+		return new FontGlyph(this._graph, name);
+	}
+	createMovieFrame(name = "") {
+		return new MovieFrame(this._graph, name);
+	}
+};
+//#endregion
+//#region ../core/src/utils/resource-folder.ts
+function normalizeResourceFolderPath(value) {
+	const segments = value.replace(/\\/g, "/").split("/").filter(Boolean);
+	return segments.length > 0 ? `/${segments.join("/")}/` : "/";
+}
+function resourceFolderParentPath(value) {
+	const segments = normalizeResourceFolderPath(value).split("/").filter(Boolean);
+	segments.pop();
+	return segments.length > 0 ? `/${segments.join("/")}/` : "/";
+}
+function resourceFolderName(value) {
+	return normalizeResourceFolderPath(value).split("/").filter(Boolean).pop() ?? "";
+}
+//#endregion
+//#region ../core/src/io/project-xml-protocol.ts
+const mergeAttrs = (...parts) => Object.assign({}, ...parts);
+const mergeChildren = (...parts) => Object.assign({}, ...parts);
+const mergeContainers = (...parts) => Object.assign({}, ...parts);
+const defineContainer = (items) => ({
+	kind: "orderedVariants",
+	items
+});
+const defineNode = (attrs, children, containers) => ({
+	attrs,
+	...children ? { children } : {},
+	...containers ? { containers } : {}
 });
 const PACKAGE_DESCRIPTION_ATTRS = {
 	id: { canonical: "id" },
 	hasFavorites: { canonical: "hasFavorites" },
 	compressPNG: { canonical: "compressPNG" },
-	jpegQuality: { canonical: "jpegQuality" }
+	jpegQuality: { canonical: "jpegQuality" },
+	branchNames: { canonical: "branchNames" }
 };
 const BRANCH_DESCRIPTION_ATTRS = {};
 const PACKAGE_PUBLISH_ATTRS = {
@@ -16150,11 +16265,21 @@ const PACKAGE_PUBLISH_ATTRS = {
 	branchPath: { canonical: "branchPath" },
 	packageCount: { canonical: "packageCount" },
 	genCode: { canonical: "genCode" },
-	codePath: { canonical: "codePath" }
+	codePath: { canonical: "codePath" },
+	maxAtlasSize: { canonical: "maxAtlasSize" },
+	sizeOption: { canonical: "sizeOption" },
+	npot: { canonical: "npot" },
+	square: { canonical: "square" },
+	rotation: { canonical: "rotation" },
+	multiPage: { canonical: "multiPage" },
+	extractAlpha: { canonical: "extractAlpha" },
+	maxAtlasIndex: { canonical: "maxAtlasIndex" },
+	excluded: { canonical: "excluded" }
 };
 const PACKAGE_PUBLISH_ATLAS_ATTRS = {
 	name: { canonical: "name" },
-	index: { canonical: "index" }
+	index: { canonical: "index" },
+	compression: { canonical: "compression" }
 };
 const PACKAGE_RESOURCE_BASE_ATTRS = {
 	id: { canonical: "id" },
@@ -16187,7 +16312,10 @@ const PACKAGE_FONT_RESOURCE_ATTRS = {
 	renderMode: { canonical: "renderMode" },
 	samplePointSize: { canonical: "samplePointSize" }
 };
-const PACKAGE_MOVIE_CLIP_RESOURCE_ATTRS = { atlas: { canonical: "atlas" } };
+const PACKAGE_MOVIE_CLIP_RESOURCE_ATTRS = {
+	atlas: { canonical: "atlas" },
+	smoothing: { canonical: "smoothing" }
+};
 const PACKAGE_SKELETON_RESOURCE_ATTRS = {
 	width: { canonical: "width" },
 	height: { canonical: "height" },
@@ -16453,7 +16581,8 @@ const COMBOBOX_EXTENSION_ATTRS = {
 	title: { canonical: "title" },
 	icon: { canonical: "icon" },
 	visibleItemCount: { canonical: "visibleItemCount" },
-	selectionController: { canonical: "selectionController" }
+	selectionController: { canonical: "selectionController" },
+	autoClearItems: { canonical: "autoClearItems" }
 };
 const PROGRESSBAR_EXTENSION_ATTRS = {
 	titleType: { canonical: "titleType" },
@@ -16481,6 +16610,11 @@ const CUSTOM_PROPERTY_ATTRS = {
 	propertyId: { canonical: "propertyId" },
 	label: { canonical: "label" }
 };
+const PROPERTY_OVERRIDE_ATTRS = {
+	target: { canonical: "target" },
+	propertyId: { canonical: "propertyId" },
+	value: { canonical: "value" }
+};
 const GEAR_ATTRS = {
 	controller: { canonical: "controller" },
 	pages: { canonical: "pages" },
@@ -16571,10 +16705,11 @@ const SLIDER_EXTENSION_NODE = defineNode(SLIDER_EXTENSION_ATTRS);
 const SCROLLBAR_EXTENSION_NODE = defineNode(SCROLLBAR_EXTENSION_ATTRS);
 const RELATION_NODE = defineNode(RELATION_ATTRS);
 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 TRANSITION_ITEM_NODE = defineNode(TRANSITION_ITEM_ATTRS);
-const LIST_ITEM_NODE = defineNode(LIST_ITEM_ATTRS);
+const LIST_ITEM_NODE = defineNode(LIST_ITEM_ATTRS, { property: PROPERTY_OVERRIDE_NODE });
 const COMBOBOX_ITEM_NODE = defineNode(COMBOBOX_ITEM_ATTRS);
 const WITH_RELATION_CHILDREN = { relation: RELATION_NODE };
 const WITH_GEAR_CHILDREN = {
@@ -16622,7 +16757,7 @@ const TRANSITION_NODE = defineNode(mergeAttrs(TRANSITION_ATTRS), mergeChildren(W
 const IMAGE_NODE = defineNode(mergeAttrs(COMMON_DISPLAY_OBJECT_ATTRS, IMAGE_PANEL_ATTRS, XY_SIZE_ATTRS, LOCKED_ATTRS, ASPECT_ATTRS, PIVOT_ATTRS, ANCHOR_ATTRS, SCALE_ATTRS, SKEW_ATTRS, GROUP_REF_ATTRS, COMMON_DISPLAY_STATE_ATTRS, RESOURCE_LINK_ATTRS, FILTER_ATTRS), mergeChildren(WITH_RELATION_CHILDREN, WITH_GEAR_CHILDREN));
 const GRAPH_NODE = defineNode(mergeAttrs(COMMON_DISPLAY_OBJECT_ATTRS, XY_SIZE_ATTRS, LOCKED_ATTRS, RESTRICT_SIZE_ATTRS, PIVOT_ATTRS, ANCHOR_ATTRS, SKEW_ATTRS, GROUP_REF_ATTRS, COMMON_DISPLAY_STATE_ATTRS, GRAPH_PANEL_ATTRS), mergeChildren(WITH_RELATION_CHILDREN, WITH_GEAR_CHILDREN));
 const MOVIE_CLIP_NODE = defineNode(mergeAttrs(COMMON_DISPLAY_OBJECT_ATTRS, MOVIE_CLIP_PANEL_ATTRS, XY_SIZE_ATTRS, PIVOT_ATTRS, ANCHOR_ATTRS, GROUP_REF_ATTRS, COMMON_DISPLAY_STATE_ATTRS, RESOURCE_LINK_ATTRS, FILTER_ATTRS), mergeChildren(WITH_RELATION_CHILDREN, WITH_GEAR_CHILDREN));
-const COMPONENT_INSTANCE_NODE = defineNode(mergeAttrs(COMMON_DISPLAY_OBJECT_ATTRS, COMPONENT_INSTANCE_PANEL_ATTRS, XY_SIZE_ATTRS, LOCKED_ATTRS, RESTRICT_SIZE_ATTRS, ASPECT_ATTRS, PIVOT_ATTRS, ANCHOR_ATTRS, SCALE_ATTRS, GROUP_REF_ATTRS, COMMON_DISPLAY_STATE_ATTRS, INSTANCE_MISC_PANEL_ATTRS, RESOURCE_LINK_ATTRS, FILTER_ATTRS), mergeChildren(WITH_RELATION_CHILDREN, WITH_GEAR_CHILDREN, WITH_INSTANCE_EXTENSION_CHILDREN));
+const COMPONENT_INSTANCE_NODE = defineNode(mergeAttrs(COMMON_DISPLAY_OBJECT_ATTRS, COMPONENT_INSTANCE_PANEL_ATTRS, XY_SIZE_ATTRS, LOCKED_ATTRS, RESTRICT_SIZE_ATTRS, ASPECT_ATTRS, PIVOT_ATTRS, ANCHOR_ATTRS, SCALE_ATTRS, GROUP_REF_ATTRS, COMMON_DISPLAY_STATE_ATTRS, INSTANCE_MISC_PANEL_ATTRS, RESOURCE_LINK_ATTRS, FILTER_ATTRS), mergeChildren(WITH_RELATION_CHILDREN, WITH_GEAR_CHILDREN, WITH_INSTANCE_EXTENSION_CHILDREN, { property: PROPERTY_OVERRIDE_NODE }));
 const LOADER_NODE = defineNode(mergeAttrs(COMMON_DISPLAY_OBJECT_ATTRS, XY_SIZE_ATTRS, PIVOT_ATTRS, ANCHOR_ATTRS, SCALE_ATTRS, COMMON_DISPLAY_STATE_ATTRS, LOADER_PANEL_ATTRS, FILTER_ATTRS), mergeChildren(WITH_RELATION_CHILDREN, WITH_GEAR_CHILDREN));
 const LOADER3D_NODE = defineNode(mergeAttrs(COMMON_DISPLAY_OBJECT_ATTRS, LOADER3D_PANEL_ATTRS), mergeChildren(WITH_RELATION_CHILDREN, WITH_GEAR_CHILDREN));
 const TEXT_NODE = defineNode(mergeAttrs(COMMON_DISPLAY_OBJECT_ATTRS, XY_SIZE_ATTRS, RESTRICT_SIZE_ATTRS, PIVOT_ATTRS, ANCHOR_ATTRS, { customData: { canonical: "customData" } }, GROUP_REF_ATTRS, COMMON_DISPLAY_STATE_ATTRS, TEXT_PANEL_ATTRS, TEXT_INPUT_PANEL_ATTRS), mergeChildren(WITH_RELATION_CHILDREN, WITH_GEAR_CHILDREN));
@@ -16686,6 +16821,7 @@ const PROJECT_XML_PROTOCOL = {
 	group: GROUP_NODE,
 	list: LIST_NODE,
 	listItem: LIST_ITEM_NODE,
+	propertyOverride: PROPERTY_OVERRIDE_NODE,
 	comboBoxItem: COMBOBOX_ITEM_NODE
 };
 function readXmlAttr(source, spec) {
@@ -16844,6 +16980,24 @@ function getXmlNode$2(value) {
 function getProtocolChildName$2(protocol, childName) {
 	return protocol.children?.[childName] ? childName : null;
 }
+function parsePropertyOverrides(source, protocol) {
+	const childName = getProtocolChildName$2(protocol, "property");
+	if (!childName) return [];
+	return ensureArray(source[childName]).map((raw, index) => {
+		const property = getXmlNode$2(raw);
+		const specs = PROJECT_XML_PROTOCOL.propertyOverride.attrs;
+		const target = property ? readXmlAttr(property, specs.target) : void 0;
+		const rawPropertyId = property ? readXmlAttr(property, specs.propertyId) : void 0;
+		const propertyId = typeof rawPropertyId === "number" ? rawPropertyId : typeof rawPropertyId === "string" && /^\d+$/.test(rawPropertyId) ? Number(rawPropertyId) : NaN;
+		const value = property ? readXmlAttr(property, specs.value) : void 0;
+		if (!target || !Number.isSafeInteger(propertyId) || propertyId < 0 || value === void 0) throw new Error(`Invalid property override at ${childName}[${index}].`);
+		return {
+			target,
+			propertyId,
+			value: String(value)
+		};
+	});
+}
 function getProtocolGearChildNames(protocol) {
 	return Object.keys(protocol.children ?? {}).filter((name) => name in GEAR_TAG_MAP);
 }
@@ -16878,6 +17032,7 @@ function parseListItemXmlNode(item) {
 	const specs = PROJECT_XML_PROTOCOL.listItem.attrs;
 	const isFolder = readXmlAttr(item, specs.isFolder);
 	const controllers = readXmlAttr(item, specs.controllers);
+	const propertyOverrides = parsePropertyOverrides(item, PROJECT_XML_PROTOCOL.listItem);
 	return {
 		title: readXmlAttr(item, specs.title) ?? null,
 		icon: readXmlAttr(item, specs.icon) ?? null,
@@ -16887,7 +17042,8 @@ function parseListItemXmlNode(item) {
 		selectedIcon: readXmlAttr(item, specs.selectedIcon) ?? null,
 		level: parseInt2(readXmlAttr(item, specs.level)),
 		isFolder: isFolder !== void 0 ? parseBool(isFolder) : null,
-		...controllers !== void 0 ? { controllers } : {}
+		...controllers !== void 0 ? { controllers } : {},
+		...propertyOverrides.length > 0 ? { propertyOverrides } : {}
 	};
 }
 function parseComboBoxItemXmlNode(item) {
@@ -17954,6 +18110,8 @@ function createDisplayObject$1(ctx, doc, tagName, attrs, localControllers) {
 			if (scrollItemToViewOnClick !== void 0) g.setScrollItemToViewOnClick?.(parseBool(scrollItemToViewOnClick));
 			const foldInvisibleItems = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.foldInvisibleItems);
 			if (foldInvisibleItems !== void 0) g.setFoldInvisibleItems?.(parseBool(foldInvisibleItems));
+			const autoClearItems = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.autoClearItems);
+			if (autoClearItems !== void 0) g.setAutoClearItems?.(parseBool(autoClearItems));
 			const listItemChildName = getProtocolChildName$2(PROJECT_XML_PROTOCOL.list, "item");
 			const items = listItemChildName ? ensureArray(attrs[listItemChildName]) : [];
 			if (items.length > 0) {
@@ -17992,6 +18150,7 @@ function createDisplayObject$1(ctx, doc, tagName, attrs, localControllers) {
 			obj.addRelation(rel);
 		}
 	}
+	if (obj.propertyType === "GComponent") obj.setPropertyOverrides(parsePropertyOverrides(attrs, PROJECT_XML_PROTOCOL.componentInstance));
 	for (const extTypeName of getProtocolExtensionChildNames(PROJECT_XML_PROTOCOL.componentInstance)) {
 		const extElement = attrs[extTypeName];
 		if (extElement) {
@@ -18028,6 +18187,8 @@ function createDisplayObject$1(ctx, doc, tagName, attrs, localControllers) {
 			if (selectionController !== void 0) componentObj.setInstanceSelectionController?.(selectionController);
 			const visibleItemCount = extSpecs.visibleItemCount ? readXmlAttr(extAttrs, extSpecs.visibleItemCount) : void 0;
 			if (visibleItemCount !== void 0) componentObj.setInstanceVisibleItemCount?.(parseInt2(visibleItemCount));
+			const autoClearItems = extSpecs.autoClearItems ? readXmlAttr(extAttrs, extSpecs.autoClearItems) : void 0;
+			if (autoClearItems !== void 0) componentObj.setInstanceAutoClearItems?.(parseBool(autoClearItems));
 			const value = extSpecs.value ? readXmlAttr(extAttrs, extSpecs.value) : void 0;
 			if (value !== void 0) componentObj.setInstanceValue?.(parseInt2(value));
 			const max = extSpecs.max ? readXmlAttr(extAttrs, extSpecs.max) : void 0;
@@ -18370,6 +18531,7 @@ function readComponentXml(ctx, comp, xmlContent) {
 					case "ComboBox":
 						if (readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.ComboBox.attrs.dropdown) !== void 0) comp.setDropdown?.(String(readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.ComboBox.attrs.dropdown)));
 						if (readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.ComboBox.attrs.selectionController) !== void 0) comp.setSelectionController?.(String(readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.ComboBox.attrs.selectionController)));
+						if (readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.ComboBox.attrs.autoClearItems) !== void 0) comp.setAutoClearItems?.(parseBool(readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.ComboBox.attrs.autoClearItems)));
 						break;
 					case "Label":
 						if (readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Label.attrs.prompt) !== void 0) comp.setPromptText?.(String(readXmlAttr(extAttrs, EXTENSION_PROTOCOL_MAP$1.Label.attrs.prompt)));
@@ -18572,8 +18734,11 @@ function assignSetting(settings, key, value) {
 		case "adaptation":
 			settings.adaptation = value;
 			break;
-		default:
-			settings[key] = value;
+		case "customProperties":
+			settings.customProperties = value;
+			break;
+		case "i18n":
+			settings.i18n = value;
 			break;
 	}
 }
@@ -18617,6 +18782,7 @@ var ProjectReader = class {
 		}
 		const branchNames = await this._readPackageBranches(ctx, options);
 		if (branchNames.length > 0) doc.getRoot().setBranches(branchNames);
+		this._linkPackageBranchItems(doc);
 		for (const [_key, resource] of ctx.resourceMap) {
 			if (resource.propertyType !== "Component") continue;
 			const comp = resource;
@@ -18630,6 +18796,22 @@ var ProjectReader = class {
 		}
 		return doc;
 	}
+	_linkPackageBranchItems(doc) {
+		for (const pkg of doc.getRoot().listPackages()) {
+			const branchNames = pkg.listBranchNames();
+			if (branchNames.length === 0) continue;
+			const variants = /* @__PURE__ */ new Map();
+			for (const resource of pkg.listResources()) {
+				const branchName = resource.getBranch();
+				if (!branchName) continue;
+				variants.set(`${branchName}\0${resource.propertyType}\0${resource.getPath()}\0${resource.getName()}`, resource.getId());
+			}
+			for (const resource of pkg.listResources()) {
+				if (resource.getBranch()) continue;
+				resource.setBranchItemIds(branchNames.map((branchName) => variants.get(`${branchName}\0${resource.propertyType}\0${resource.getPath()}\0${resource.getName()}`) ?? ""));
+			}
+		}
+	}
 	async _readPackageBranches(ctx, options) {
 		const fs = this._fs;
 		let dirNames = [];
@@ -18696,6 +18878,7 @@ var ProjectReader = class {
 		if (!desc) return;
 		let pkg = ctx.document.getRoot().getPackage(dirName);
 		if (!pkg) pkg = ctx.document.createPackage(dirName);
+		if (branchName) pkg.addBranchName(branchName);
 		pkg.setExtras({
 			...pkg.getExtras(),
 			_preservePackageResourceOrder: true
@@ -18703,6 +18886,17 @@ var ProjectReader = class {
 		if (!branchName) {
 			const packageId = readXmlAttr(desc, PROJECT_XML_PROTOCOL.packageDescription.attrs.id) || "";
 			pkg.setId(packageId);
+			const serializedBranchNames = readXmlAttr(desc, PROJECT_XML_PROTOCOL.packageDescription.attrs.branchNames);
+			if (serializedBranchNames !== void 0) {
+				let parsedBranchNames;
+				try {
+					parsedBranchNames = JSON.parse(serializedBranchNames);
+				} catch {
+					throw new Error(`Invalid package branchNames for "${dirName}".`);
+				}
+				if (!Array.isArray(parsedBranchNames) || !parsedBranchNames.every((name) => typeof name === "string" && name.length > 0) || new Set(parsedBranchNames).size !== parsedBranchNames.length) throw new Error(`Invalid package branchNames for "${dirName}".`);
+				pkg.setBranchNames(parsedBranchNames);
+			}
 			const compressPNG = readXmlAttr(desc, PROJECT_XML_PROTOCOL.packageDescription.attrs.compressPNG);
 			if (compressPNG !== void 0) pkg.setCompressPNG(parseBool(compressPNG));
 			const jpegQuality = readXmlAttr(desc, PROJECT_XML_PROTOCOL.packageDescription.attrs.jpegQuality);
@@ -18717,6 +18911,32 @@ var ProjectReader = class {
 			pkg.setPublishPackageCount(parseInt2(readXmlAttr(publish, PROJECT_XML_PROTOCOL.packagePublish.attrs.packageCount), 0));
 			pkg.setGenCode(parseBool(readXmlAttr(publish, PROJECT_XML_PROTOCOL.packagePublish.attrs.genCode)));
 			pkg.setCodePath(readXmlAttr(publish, PROJECT_XML_PROTOCOL.packagePublish.attrs.codePath) || "");
+			const globalAtlas = ctx.settings.publish?.atlasSetting;
+			const maxAtlasSize = readXmlAttr(publish, PROJECT_XML_PROTOCOL.packagePublish.attrs.maxAtlasSize);
+			const sizeOption = parseBool(readXmlAttr(publish, PROJECT_XML_PROTOCOL.packagePublish.attrs.npot)) ? "npot" : readXmlAttr(publish, PROJECT_XML_PROTOCOL.packagePublish.attrs.sizeOption) || globalAtlas?.sizeOption || "pot";
+			const square = readXmlAttr(publish, PROJECT_XML_PROTOCOL.packagePublish.attrs.square);
+			const rotation = readXmlAttr(publish, PROJECT_XML_PROTOCOL.packagePublish.attrs.rotation);
+			const multiPage = readXmlAttr(publish, PROJECT_XML_PROTOCOL.packagePublish.attrs.multiPage);
+			pkg.setSourceAtlasSettings({
+				useGlobal: maxAtlasSize === void 0,
+				maxSize: parseInt2(maxAtlasSize, globalAtlas?.maxSize ?? 2048),
+				sizeOption: sizeOption === "npot" || sizeOption === "mof" ? sizeOption : "pot",
+				forceSquare: square === void 0 ? globalAtlas?.forceSquare ?? false : parseBool(square),
+				allowRotation: rotation === void 0 ? globalAtlas?.allowRotation ?? false : parseBool(rotation),
+				paging: multiPage === void 0 ? globalAtlas?.paging ?? true : parseBool(multiPage),
+				extractAlpha: parseBool(readXmlAttr(publish, PROJECT_XML_PROTOCOL.packagePublish.attrs.extractAlpha)),
+				maxIndex: parseInt2(readXmlAttr(publish, PROJECT_XML_PROTOCOL.packagePublish.attrs.maxAtlasIndex), 10),
+				atlases: ensureArray(publish.atlas).flatMap((value) => {
+					const atlas = getXmlNode(value);
+					if (!atlas) return [];
+					return [{
+						index: parseInt2(readXmlAttr(atlas, PROJECT_XML_PROTOCOL.packagePublishAtlas.attrs.index)),
+						name: readXmlAttr(atlas, PROJECT_XML_PROTOCOL.packagePublishAtlas.attrs.name) || "",
+						compression: parseBool(readXmlAttr(atlas, PROJECT_XML_PROTOCOL.packagePublishAtlas.attrs.compression))
+					}];
+				}),
+				excludedResourceIds: (readXmlAttr(publish, PROJECT_XML_PROTOCOL.packagePublish.attrs.excluded) || "").split(",").filter(Boolean)
+			});
 		}
 		if (pkg.getId()) ctx.packageMap.set(pkg.getId(), pkg);
 		const packageDir = branchName ? fs.join(ctx.basePath, `assets_${branchName}`, dirName) : fs.join(ctx.basePath, "assets", dirName);
@@ -18831,10 +19051,9 @@ var ProjectReader = class {
 				if (resource.propertyType === "ImageResource") {
 					const size = probeRasterImageDimensions(data);
 					if (size) resource.setWidth(size.width).setHeight(size.height);
-				} else if (resource.propertyType === "MovieClipResource") {
-					const size = tryReadJtaSize(data);
-					if (size) resource.setWidth(size.width).setHeight(size.height);
-				}
+				} else if (resource.propertyType === "MovieClipResource") try {
+					applyDerivedMovieClipModel(doc, resource, deriveMovieClipModelFromJta(data));
+				} catch {}
 			} catch {}
 		}
 	}
@@ -19014,6 +19233,8 @@ var ProjectReader = class {
 				res.setFavorite(favorite);
 				const textureSetMode = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageMovieClipResource.attrs.atlas);
 				if (textureSetMode !== void 0) res.setTextureSetMode(textureSetMode);
+				const smoothing = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageMovieClipResource.attrs.smoothing);
+				res.setSmoothing(smoothing !== "false");
 				pkg.addResource(res);
 				ctx.registerResource(pkg.getId(), id, res);
 				return res;
@@ -19393,6 +19614,16 @@ function serializeListItemXmlNode(item, options) {
 	if (item.level !== void 0 && item.level !== null && ((options?.forceLevel ?? false) || item.level !== 0 || item.isFolder === true)) writeXmlAttr(attrs, specs.level, String(item.level));
 	if (item.isFolder !== void 0 && item.isFolder !== null) writeXmlAttr(attrs, specs.isFolder, item.isFolder ? "true" : "false");
 	if (item.controllers !== void 0 && item.controllers !== null) writeXmlAttr(attrs, specs.controllers, item.controllers);
+	const propertyChildName = getProtocolChildName(PROJECT_XML_PROTOCOL.listItem, "property");
+	if (propertyChildName && item.propertyOverrides?.length) attrs[propertyChildName] = item.propertyOverrides.map(serializePropertyOverrideXmlNode);
+	return attrs;
+}
+function serializePropertyOverrideXmlNode(property) {
+	const attrs = {};
+	const specs = PROJECT_XML_PROTOCOL.propertyOverride.attrs;
+	writeXmlAttr(attrs, specs.target, property.target);
+	writeXmlAttr(attrs, specs.propertyId, String(property.propertyId));
+	writeXmlAttr(attrs, specs.value, property.value);
 	return attrs;
 }
 function serializeComboBoxItemXmlNode(item) {
@@ -19875,6 +20106,7 @@ function serializeChild(obj) {
 		if (clipSoftness && ((clipSoftness.x ?? 0) !== 0 || (clipSoftness.y ?? 0) !== 0)) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.clipSoftness, `${clipSoftness.x ?? 0},${clipSoftness.y ?? 0}`);
 		if (typedObj.getScrollItemToViewOnClick?.() === false) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.scrollItemToViewOnClick, "false");
 		if (typedObj.getFoldInvisibleItems?.() === true) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.foldInvisibleItems, "true");
+		if (typedObj.getAutoClearItems?.() === true) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.list.attrs.autoClearItems, "true");
 		const listItems = typedObj.getListItems?.() ?? [];
 		const listItemChildName = getProtocolChildName(PROJECT_XML_PROTOCOL.list, "item");
 		if (listItems.length > 0 && listItemChildName) attrs[listItemChildName] = listItems.map((item) => serializeListItemXmlNode(item, { forceLevel: isTree }));
@@ -19942,6 +20174,9 @@ function serializeChild(obj) {
 		}
 	}
 	if (type === "GComponent") {
+		const propertyOverrides = typedObj.getPropertyOverrides?.() ?? [];
+		const propertyChildName = getProtocolChildName(PROJECT_XML_PROTOCOL.componentInstance, "property");
+		if (propertyChildName && propertyOverrides.length > 0) attrs[propertyChildName] = propertyOverrides.map(serializePropertyOverrideXmlNode);
 		const instanceExtType = typedObj.getInstanceExtType?.() ?? "";
 		if (instanceExtType) {
 			const extSpecs = EXTENSION_PROTOCOL_MAP[instanceExtType].attrs;
@@ -19960,6 +20195,7 @@ function serializeChild(obj) {
 			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));
+			if (typedObj.getInstanceAutoClearItems?.() && extSpecs.autoClearItems) writeXmlAttr(extAttrs, extSpecs.autoClearItems, "true");
 			const instanceValue = typedObj.getInstanceValue?.() ?? 0;
 			const instanceMax = typedObj.getInstanceMax?.() ?? 0;
 			const instanceMin = typedObj.getInstanceMin?.() ?? 0;
@@ -20229,6 +20465,7 @@ async function writeComponent(fs, comp, pkgDir, sourceRelativePath) {
 			case "ComboBox":
 				if (typedComp.getDropdown?.()) writeXmlAttr(extAttrs, extSpecs.dropdown, typedComp.getDropdown?.());
 				if (typedComp.getSelectionController?.()) writeXmlAttr(extAttrs, extSpecs.selectionController, typedComp.getSelectionController?.());
+				if (typedComp.getAutoClearItems?.()) writeXmlAttr(extAttrs, extSpecs.autoClearItems, "true");
 				break;
 			case "Label":
 				if (typedComp.getPromptText?.()) writeXmlAttr(extAttrs, extSpecs.prompt, typedComp.getPromptText?.());
@@ -20367,25 +20604,44 @@ var ProjectWriter = class {
 		const basePath = fs.dirname(projectPath);
 		const currentSourceFilePaths = /* @__PURE__ */ new Set();
 		const currentResourceFolderPaths = /* @__PURE__ */ new Set();
+		const currentBranchDirectoryPaths = /* @__PURE__ */ new Set();
 		const staleSourceFilePaths = new Set((options.staleSourceFiles ?? []).map((source) => this._projectSourceFilePath(basePath, source)));
+		const staleBranchDirectoryPaths = new Set((options.staleBranchDirectories ?? []).map((directory) => this._projectBranchDirectoryPath(basePath, directory)));
+		if (staleBranchDirectoryPaths.size > 0 && !fs.rmdir) throw new Error("Project branch cleanup requires a FileSystem.rmdir() implementation.");
 		for (const pkg of root.listPackages()) this._assertPackageOutputTargets(pkg);
-		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`;
-		await fs.writeFile(projectPath, fairyXml);
 		const settings = root.getSettings?.() ?? {};
 		const settingsPath = fs.join(basePath, "settings");
+		const staleOptionalSettings = [];
+		for (const [fileName, key] of [["CustomProperties.json", "customProperties"], ["i18n.json", "i18n"]]) {
+			const filePath = fs.join(settingsPath, fileName);
+			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`;
+		await fs.writeFile(projectPath, fairyXml);
 		await fs.mkdir(settingsPath);
 		for (const [fileName, key] of Object.entries({
 			"Publish.json": "publish",
 			"Common.json": "common",
-			"Adaptation.json": "adaptation"
+			"Adaptation.json": "adaptation",
+			"CustomProperties.json": "customProperties",
+			"i18n.json": "i18n"
 		})) if (settings[key]) await fs.writeFile(fs.join(settingsPath, fileName), JSON.stringify(settings[key], null, "	"));
+		for (const filePath of staleOptionalSettings) await fs.unlink(filePath);
 		const assetsPath = fs.join(basePath, "assets");
 		await fs.mkdir(assetsPath);
-		for (const pkg of root.listPackages()) await this._writePackage(doc, pkg, assetsPath, currentSourceFilePaths, currentResourceFolderPaths);
+		for (const branchName of root.listBranches()) {
+			this._assertSafePathSegment(branchName, "branch name");
+			const branchPath = fs.join(basePath, `assets_${branchName}`);
+			await fs.mkdir(branchPath);
+			currentBranchDirectoryPaths.add(branchPath);
+		}
+		for (const pkg of root.listPackages()) await this._writePackage(doc, pkg, assetsPath, currentSourceFilePaths, currentResourceFolderPaths, currentBranchDirectoryPaths);
 		await this._removeStaleSourceFiles(currentSourceFilePaths, staleSourceFilePaths);
 		await this._removeStaleResourceFolders(currentResourceFolderPaths, new Set((options.staleResourceFolders ?? []).map((folder) => this._projectResourceFolderPath(basePath, folder))));
+		await this._removeStaleBranchDirectories(currentBranchDirectoryPaths, staleBranchDirectoryPaths);
 	}
-	async _writePackage(_doc, pkg, assetsPath, currentSourceFilePaths, currentResourceFolderPaths) {
+	async _writePackage(_doc, pkg, assetsPath, currentSourceFilePaths, currentResourceFolderPaths, currentBranchDirectoryPaths) {
 		const fs = this._fs;
 		this._assertSafePathSegment(pkg.getName(), "package name");
 		const pkgDir = fs.join(assetsPath, pkg.getName());
@@ -20414,6 +20670,8 @@ var ProjectWriter = class {
 		const codePath = pkg.getCodePath();
 		const packageDescriptionAttrs = {};
 		writeXmlAttr(packageDescriptionAttrs, PROJECT_XML_PROTOCOL.packageDescription.attrs.id, pkg.getId());
+		const packageBranchNames = pkg.listBranchNames();
+		writeXmlAttr(packageDescriptionAttrs, PROJECT_XML_PROTOCOL.packageDescription.attrs.branchNames, packageBranchNames.length > 0 ? JSON.stringify(packageBranchNames) : void 0);
 		if (pkg.listResources().some((resource) => resource.getFavorite?.()) || pkg.listResourceFolders().some((folder) => folder.favorite)) writeXmlAttr(packageDescriptionAttrs, PROJECT_XML_PROTOCOL.packageDescription.attrs.hasFavorites, "true");
 		const compressPNG = pkg.getCompressPNG();
 		if (compressPNG !== null) writeXmlAttr(packageDescriptionAttrs, PROJECT_XML_PROTOCOL.packageDescription.attrs.compressPNG, compressPNG ? "true" : "false");
@@ -20426,11 +20684,22 @@ var ProjectWriter = class {
 		writeXmlAttr(publishAttrs, PROJECT_XML_PROTOCOL.packagePublish.attrs.packageCount, publishPackageCount > 0 ? publishPackageCount : void 0);
 		writeXmlAttr(publishAttrs, PROJECT_XML_PROTOCOL.packagePublish.attrs.genCode, genCode ? "true" : void 0);
 		writeXmlAttr(publishAttrs, PROJECT_XML_PROTOCOL.packagePublish.attrs.codePath, codePath || void 0);
-		const publishAtlases = pkg.listAtlases().map((atlas) => {
+		const sourceAtlasSettings = pkg.getSourceAtlasSettings();
+		if (!sourceAtlasSettings.useGlobal) {
+			writeXmlAttr(publishAttrs, PROJECT_XML_PROTOCOL.packagePublish.attrs.maxAtlasSize, String(sourceAtlasSettings.maxSize));
+			writeXmlAttr(publishAttrs, PROJECT_XML_PROTOCOL.packagePublish.attrs.sizeOption, sourceAtlasSettings.sizeOption);
+			writeXmlAttr(publishAttrs, PROJECT_XML_PROTOCOL.packagePublish.attrs.square, sourceAtlasSettings.forceSquare ? "true" : "false");
+			writeXmlAttr(publishAttrs, PROJECT_XML_PROTOCOL.packagePublish.attrs.rotation, sourceAtlasSettings.allowRotation ? "true" : "false");
+			writeXmlAttr(publishAttrs, PROJECT_XML_PROTOCOL.packagePublish.attrs.multiPage, sourceAtlasSettings.paging ? "true" : "false");
+		}
+		writeXmlAttr(publishAttrs, PROJECT_XML_PROTOCOL.packagePublish.attrs.extractAlpha, sourceAtlasSettings.extractAlpha ? "true" : void 0);
+		writeXmlAttr(publishAttrs, PROJECT_XML_PROTOCOL.packagePublish.attrs.maxAtlasIndex, sourceAtlasSettings.maxIndex === 10 ? void 0 : String(sourceAtlasSettings.maxIndex));
+		writeXmlAttr(publishAttrs, PROJECT_XML_PROTOCOL.packagePublish.attrs.excluded, sourceAtlasSettings.excludedResourceIds.length > 0 ? sourceAtlasSettings.excludedResourceIds.join(",") : void 0);
+		const publishAtlases = [...sourceAtlasSettings.atlases].sort((left, right) => left.index - right.index).map((atlas) => {
 			const attrs = {};
-			const index = atlas.getIndex?.() ?? 0;
-			writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.packagePublishAtlas.attrs.name, index === 0 ? "Default" : atlas.getName());
-			writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.packagePublishAtlas.attrs.index, String(index));
+			writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.packagePublishAtlas.attrs.name, atlas.name || void 0);
+			writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.packagePublishAtlas.attrs.index, String(atlas.index));
+			writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.packagePublishAtlas.attrs.compression, atlas.compression ? "true" : void 0);
 			return attrs;
 		});
 		if (publishAtlases.length > 0) publishAttrs.atlas = publishAtlases;
@@ -20444,7 +20713,11 @@ var ProjectWriter = class {
 			await writeComponent(this._fs, comp, pkgDir, this._componentSourceRelativePath(comp));
 		}
 		await this._writeResourceSourceFiles(mainResources, pkgDir, currentSourceFilePaths);
-		const branchNames = new Set([...resourcesByBranch.keys(), ...foldersByBranch.keys()]);
+		const branchNames = new Set([
+			...pkg.listBranchNames(),
+			...resourcesByBranch.keys(),
+			...foldersByBranch.keys()
+		]);
 		for (const branchName of branchNames) {
 			if (!branchName) continue;
 			const branchResources = resourcesByBranch.get(branchName) ?? [];
@@ -20452,6 +20725,7 @@ var ProjectWriter = class {
 			this._assertSafePathSegment(branchName, "branch name");
 			const branchPkgDir = fs.join(basePath, `assets_${branchName}`, pkg.getName());
 			await fs.mkdir(branchPkgDir);
+			currentBranchDirectoryPaths.add(branchPkgDir);
 			const branchDescriptorPath = fs.join(branchPkgDir, "package_branch.xml");
 			await fs.writeFile(branchDescriptorPath, this._renderBranchDescriptionXml(branchFolders, branchResources, preserveResourceOrder));
 			currentSourceFilePaths.add(branchDescriptorPath);
@@ -20507,6 +20781,13 @@ var ProjectWriter = class {
 			await this._fs.rmdir(folderPath);
 		}
 	}
+	async _removeStaleBranchDirectories(currentBranchDirectoryPaths, staleBranchDirectoryPaths) {
+		const candidates = [...staleBranchDirectoryPaths].filter((directoryPath) => !currentBranchDirectoryPaths.has(directoryPath)).sort((left, right) => right.length - left.length);
+		for (const directoryPath of candidates) {
+			if (!await this._fs.exists(directoryPath)) continue;
+			await this._fs.rmdir(directoryPath);
+		}
+	}
 	_assertPackageOutputTargets(pkg) {
 		this._assertSafePathSegment(pkg.getName(), "package name");
 		const resourcesByBranch = /* @__PURE__ */ new Map();
@@ -20522,7 +20803,11 @@ var ProjectWriter = class {
 			bucket.push(folder);
 			foldersByBranch.set(folder.branch, bucket);
 		}
-		for (const branchName of new Set([...resourcesByBranch.keys(), ...foldersByBranch.keys()])) {
+		for (const branchName of new Set([
+			...pkg.listBranchNames(),
+			...resourcesByBranch.keys(),
+			...foldersByBranch.keys()
+		])) {
 			const resources = resourcesByBranch.get(branchName) ?? [];
 			if (branchName) this._assertSafePathSegment(branchName, "branch name");
 			const targets = new Map([[branchName ? "package_branch.xml" : "package.xml", "package descriptor"]]);
@@ -20557,6 +20842,13 @@ var ProjectWriter = class {
 		const assetRoot = folder.branch ? `assets_${folder.branch}` : "assets";
 		return this._fs.join(basePath, assetRoot, folder.packageName, relativePath);
 	}
+	_projectBranchDirectoryPath(basePath, directory) {
+		this._assertSafePathSegment(directory.branch, "stale branch name");
+		const branchRoot = this._fs.join(basePath, `assets_${directory.branch}`);
+		if (!directory.packageName) return branchRoot;
+		this._assertSafePathSegment(directory.packageName, "stale branch package name");
+		return this._fs.join(branchRoot, directory.packageName);
+	}
 	_resourceSourceRelativePath(resource, fileName) {
 		if (!fileName) return "";
 		this._assertSafePathSegment(fileName, "resource file name");
@@ -20571,7 +20863,7 @@ var ProjectWriter = class {
 		return this._normalizeSourceRelativePath([componentPath, `${name}.xml`].filter(Boolean).join("/"));
 	}
 	_assertSafePathSegment(value, label) {
-		if (!value || value === "." || value === ".." || /[\\/:]/.test(value)) throw new Error(`Invalid ${label} "${value}".`);
+		if (!value || value.trim() !== value || value === "." || value === ".." || /[\\/:]/.test(value) || /[. ]$/.test(value) || /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i.test(value)) throw new Error(`Invalid ${label} "${value}".`);
 	}
 	_normalizeSourceRelativePath(value) {
 		const segments = value.replace(/\\/g, "/").split("/").filter(Boolean);
@@ -20716,8 +21008,10 @@ var ProjectWriter = class {
 				if (samplePointSize !== 0) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageFontResource.attrs.samplePointSize, String(samplePointSize));
 			}
 			if (res.propertyType === "MovieClipResource") {
-				const textureSetMode = res.getTextureSetMode?.() ?? "";
+				const movieClipRes = res;
+				const textureSetMode = movieClipRes.getTextureSetMode?.() ?? "";
 				if (textureSetMode) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageMovieClipResource.attrs.atlas, textureSetMode);
+				if (movieClipRes.getSmoothing?.() === false) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageMovieClipResource.attrs.smoothing, "false");
 			}
 			if (res.propertyType === "SpineResource" || res.propertyType === "DragonBonesResource") {
 				const skeletonRes = res;
@@ -22050,6 +22344,7 @@ var BinaryReader = class {
 		if (packageBranches.length > 0) for (const branchName of packageBranches) doc.getRoot().addBranch(branchName);
 		const pkg = getOrCreatePackage(doc, packageId, packageName);
 		if (pkg.listResources().length > 0 || pkg.listAtlases().length > 0) throw new Error(`Package "${packageName}" (${packageId}) has already been read.`);
+		pkg.setBranchNames(packageBranches);
 		const atlasMap = /* @__PURE__ */ new Map();
 		for (const dep of dependencies) {
 			if (!dep.id || dep.id === packageId) continue;
@@ -24033,7 +24328,8 @@ var BinaryWriter = class {
 			id: dep.getId(),
 			name: dep.getName()
 		})).filter((dep) => !!dep.id);
-		const branchNames = includeBranches ? getPackageBranchNames(doc, resources) : [];
+		const declaredBranchNames = pkg.listBranchNames();
+		const branchNames = includeBranches ? declaredBranchNames.length > 0 ? declaredBranchNames : getPackageBranchNames(doc, resources) : [];
 		const branchItemIdsMap = buildBranchItemIdsMap(pkg, branchNames);
 		const publishedItemIdMap = new Map(resources.map((resource) => [resource.getId(), getPublishedItemId$1(resource)]));
 		const sprites = [];
@@ -24509,9 +24805,11 @@ function getItemBranchName(item) {
 	return item.getBranch?.() ?? "";
 }
 function getPackageBranchNames(doc, resources) {
-	const packageBranchSet = new Set(resources.map((resource) => getItemBranchName(resource)).filter((branchName) => !!branchName));
-	if (packageBranchSet.size === 0) return [];
-	return doc.getRoot().listBranches().filter((branchName) => packageBranchSet.has(branchName));
+	const packageBranchNames = new Set(resources.map((resource) => getItemBranchName(resource)).filter((branchName) => !!branchName));
+	const rootBranchNames = doc.getRoot().listBranches();
+	const unknownBranchName = [...packageBranchNames].find((branchName) => !rootBranchNames.includes(branchName));
+	if (unknownBranchName) throw new Error(`Package resource references unknown branch "${unknownBranchName}".`);
+	return rootBranchNames.filter((branchName) => packageBranchNames.has(branchName));
 }
 function buildBranchResourceKey$1(resource) {
 	const path = resource.getPath?.() ?? "";
@@ -25170,153 +25468,76 @@ function parseFnt(text) {
 }
 //#endregion
 //#region ../functions/src/atlas/jta.ts
-const PNG_SIGNATURE = new Uint8Array([
-	137,
-	80,
-	78,
-	71,
-	13,
-	10,
-	26,
-	10
-]);
 function extractJtaFrames(data) {
-	const frames = [];
-	let offset = 0;
-	let firstPngOffset = -1;
-	while (offset < data.length) {
-		const signatureIndex = findPngSignature(data, offset);
-		if (signatureIndex === -1) break;
-		if (firstPngOffset === -1) firstPngOffset = signatureIndex;
-		const end = findPngEnd(data, signatureIndex);
-		if (end === -1) break;
-		frames.push(data.subarray(signatureIndex, end));
-		offset = end;
-	}
-	if (firstPngOffset === -1 || frames.length === 0) return { frames: [] };
+	const parsed = parseJta(data);
+	const derived = deriveMovieClipModel(parsed);
 	return {
-		frames,
-		meta: parseJtaHeader(data, firstPngOffset, frames.length)
-	};
-}
-function findPngSignature(data, fromIndex) {
-	for (let index = fromIndex; index <= data.length - PNG_SIGNATURE.length; index += 1) {
-		let matched = true;
-		for (let signatureIndex = 0; signatureIndex < PNG_SIGNATURE.length; signatureIndex += 1) if (data[index + signatureIndex] !== PNG_SIGNATURE[signatureIndex]) {
-			matched = false;
-			break;
+		frames: parsed.textures.map((texture) => texture.raw),
+		meta: {
+			interval: derived.interval,
+			repeatDelay: derived.repeatDelay,
+			swing: derived.swing,
+			width: derived.dimensions.width,
+			height: derived.dimensions.height,
+			frames: derived.frames.map((frame) => ({
+				addDelay: frame.addDelay,
+				offsetX: frame.rectX,
+				offsetY: frame.rectY,
+				width: frame.rectWidth,
+				height: frame.rectHeight,
+				textureIndex: frame.textureIndex
+			}))
 		}
-		if (matched) return index;
-	}
-	return -1;
+	};
 }
-function findPngEnd(data, start) {
-	let position = start + PNG_SIGNATURE.length;
-	while (position + 8 <= data.length) {
-		const length = readUint32BE(data, position);
-		position += 8;
-		if (position + length + 4 > data.length) return -1;
-		const isEnd = data[position - 4] === 73 && data[position - 3] === 69 && data[position - 2] === 78 && data[position - 1] === 68;
-		position += length + 4;
-		if (isEnd) return position;
-	}
-	return -1;
+function detectSupportedRasterFormat(data) {
+	if (data.length >= 8 && data[0] === 137 && data[1] === 80 && data[2] === 78 && data[3] === 71 && data[4] === 13 && data[5] === 10 && data[6] === 26 && data[7] === 10) return "png";
+	if (data.length >= 2 && data[0] === 255 && data[1] === 216) return "jpeg";
+	return null;
 }
-function parseJtaHeader(data, firstPngOffset, frameCount) {
-	if (data.length < 10) return void 0;
-	const state = { offset: 0 };
-	const end = Math.min(firstPngOffset, data.length);
-	if (!readUtfBE(data, state, end)) return void 0;
-	const version = readInt32BEAt(data, state, end);
-	if (version == null) return void 0;
-	const fpsRaw = readInt8At(data, state, end);
-	if (fpsRaw == null) return void 0;
-	const fps = fpsRaw > 0 ? fpsRaw : 24;
-	if (state.offset + 3 > end) return void 0;
-	state.offset += 3;
-	if (version < 102) return void 0;
-	readUint16BEAt(data, state, end);
-	readUint16BEAt(data, state, end);
-	const width = readUint16BEAt(data, state, end);
-	const height = readUint16BEAt(data, state, end);
-	if (width == null || height == null) return void 0;
-	const speedRaw = readUint8At(data, state, end);
-	const repeatDelayRaw = readUint8At(data, state, end);
-	const swingRaw = readInt8At(data, state, end);
-	const frameTableCount = readInt16BEAt(data, state, end);
-	if (speedRaw == null || repeatDelayRaw == null || swingRaw == null || frameTableCount == null) return void 0;
-	const frames = [];
-	for (let index = 0; index < frameTableCount; index += 1) {
-		const delayRaw = readInt16BEAt(data, state, end);
-		const offsetX = readInt16BEAt(data, state, end);
-		const offsetY = readInt16BEAt(data, state, end);
-		const frameWidth = readInt16BEAt(data, state, end);
-		const frameHeight = readInt16BEAt(data, state, end);
-		const textureIndex = readInt16BEAt(data, state, end);
-		if (delayRaw == null || offsetX == null || offsetY == null || frameWidth == null || frameHeight == null || textureIndex == null) break;
-		frames.push({
-			addDelay: Math.trunc(1e3 / fps * delayRaw),
-			offsetX,
-			offsetY,
-			width: frameWidth,
-			height: frameHeight,
-			textureIndex
+function couldNotDecode(filePath, frameIndex, textureIndex) {
+	return /* @__PURE__ */ new Error(`atlas: Could not decode MovieClip "${filePath}" frame ${frameIndex} (texture ${textureIndex}).`);
+}
+async function prepareJtaForPublish(data, encoder, filePath) {
+	const extracted = extractJtaFrames(data);
+	const firstFrameIndexByTextureIndex = /* @__PURE__ */ new Map();
+	for (let frameIndex = 0; frameIndex < extracted.meta.frames.length; frameIndex += 1) {
+		const textureIndex = extracted.meta.frames[frameIndex].textureIndex;
+		if (textureIndex >= 0 && !firstFrameIndexByTextureIndex.has(textureIndex)) firstFrameIndexByTextureIndex.set(textureIndex, frameIndex);
+	}
+	const referencedTextures = [];
+	for (let textureIndex = 0; textureIndex < extracted.frames.length; textureIndex += 1) {
+		const firstFrameIndex = firstFrameIndexByTextureIndex.get(textureIndex);
+		if (firstFrameIndex === void 0) continue;
+		const raw = extracted.frames[textureIndex];
+		if (raw.byteLength === 0) throw new Error(`atlas: MovieClip "${filePath}" frame ${firstFrameIndex} references empty texture ${textureIndex}.`);
+		const detectedFormat = detectSupportedRasterFormat(raw);
+		if (!detectedFormat) throw new Error(`atlas: MovieClip "${filePath}" frame ${firstFrameIndex} (texture ${textureIndex}) uses an unsupported raster format; only PNG and JPEG are supported.`);
+		const imageInfo = probeRasterImage(raw);
+		if (!imageInfo || imageInfo.format !== detectedFormat) throw couldNotDecode(filePath, firstFrameIndex, textureIndex);
+		let buffer = raw;
+		if (encoder) {
+			try {
+				buffer = await encoder(raw).png().toBuffer();
+			} catch {
+				throw couldNotDecode(filePath, firstFrameIndex, textureIndex);
+			}
+			const normalizedInfo = probeRasterImage(buffer);
+			if (!normalizedInfo || normalizedInfo.format !== "png" || normalizedInfo.width !== imageInfo.width || normalizedInfo.height !== imageInfo.height) throw couldNotDecode(filePath, firstFrameIndex, textureIndex);
+		}
+		referencedTextures.push({
+			textureIndex,
+			firstFrameIndex,
+			buffer,
+			width: imageInfo.width,
+			height: imageInfo.height
 		});
 	}
 	return {
-		interval: Math.trunc(1e3 / fps * (speedRaw || 1)),
-		repeatDelay: Math.trunc(1e3 / fps * repeatDelayRaw),
-		swing: swingRaw === 1,
-		width,
-		height,
-		frames: frames.length === 0 && frameCount > 0 ? [] : frames
+		...extracted,
+		referencedTextures
 	};
 }
-function readUtfBE(data, state, end) {
-	const length = readUint16BEAt(data, state, end);
-	if (length == null || state.offset + length > end) return null;
-	const value = new TextDecoder().decode(data.subarray(state.offset, state.offset + length));
-	state.offset += length;
-	return value;
-}
-function readUint8At(data, state, end) {
-	if (state.offset + 1 > end) return null;
-	const value = data[state.offset];
-	state.offset += 1;
-	return value ?? 0;
-}
-function readInt8At(data, state, end) {
-	if (state.offset + 1 > end) return null;
-	const value = new DataView(data.buffer, data.byteOffset, data.byteLength).getInt8(state.offset);
-	state.offset += 1;
-	return value;
-}
-function readUint16BEAt(data, state, end) {
-	if (state.offset + 2 > end) return null;
-	const value = readUint16BE(data, state.offset);
-	state.offset += 2;
-	return value;
-}
-function readInt16BEAt(data, state, end) {
-	if (state.offset + 2 > end) return null;
-	const value = new DataView(data.buffer, data.byteOffset, data.byteLength).getInt16(state.offset, false);
-	state.offset += 2;
-	return value;
-}
-function readInt32BEAt(data, state, end) {
-	if (state.offset + 4 > end) return null;
-	const value = new DataView(data.buffer, data.byteOffset, data.byteLength).getInt32(state.offset, false);
-	state.offset += 4;
-	return value;
-}
-function readUint16BE(data, offset) {
-	if (offset + 1 >= data.length) return 0;
-	return data[offset] << 8 | data[offset + 1];
-}
-function readUint32BE(data, offset) {
-	if (offset + 3 >= data.length) return 0;
-	return data[offset] * 16777216 + ((data[offset + 1] ?? 0) << 16) + ((data[offset + 2] ?? 0) << 8) + (data[offset + 3] ?? 0);
-}
 //#endregion
 //#region ../functions/src/atlas/inputs.ts
 function getPublishedItemId(resource) {
@@ -25386,6 +25607,27 @@ async function _trimImage(encoder, input, originalWidth, originalHeight) {
 		};
 	}
 }
+function resolveMovieClipSourcePath(resource, pkg, basePath) {
+	const fileName = `${resource.getName()}.jta`;
+	const resourcePath = resource.getPath() ?? "/";
+	return `${basePath}/${pkg.getName()}${resourcePath}${fileName}`;
+}
+async function prepareMovieClipResource(resource, pkg, encoder, basePath, readFileRaw) {
+	const filePath = resolveMovieClipSourcePath(resource, pkg, basePath);
+	let raw;
+	try {
+		raw = await readFileRaw(filePath);
+	} catch {
+		throw new Error(`atlas: Could not read MovieClip "${filePath}".`);
+	}
+	try {
+		return await prepareJtaForPublish(raw, encoder, filePath);
+	} catch (error) {
+		if (error instanceof Error && error.message.startsWith("atlas:")) throw error;
+		const detail = error instanceof Error ? ` ${error.message}` : "";
+		throw new Error(`atlas: Could not parse MovieClip "${filePath}".${detail}`);
+	}
+}
 /** Collect a single ImageResource into the inputs array. */
 async function collectImage(resource, pkg, inputs, encoder, options, doTrim, logger) {
 	let origW = resource.getWidth() ?? 0;
@@ -25413,8 +25655,11 @@ async function collectImage(resource, pkg, inputs, encoder, options, doTrim, log
 				}).png().toBuffer();
 				sourceHasAlpha = true;
 			}
-		} catch {
-			if (options.strictOutput) throw new Error(`atlas: Could not read image "${filePath}".`);
+		} catch (error) {
+			if (options.strictOutput) {
+				const detail = error instanceof Error && error.message.startsWith("publishBrowser:") ? ` ${error.message}` : "";
+				throw new Error(`atlas: Could not read image "${filePath}".${detail}`);
+			}
 			if (origW === 0 || origH === 0) {
 				logger.warn(`atlas: Could not read image "${filePath}", skipping.`);
 				return;
@@ -25459,82 +25704,45 @@ async function collectMovieClipFrames(doc, resource, pkg, inputs, encoder, optio
 	}
 	if (!encoder && options.strictOutput) throw new Error(`atlas: MovieClip "${resource.getId()}" requires an encoder for complete raster output.`);
 	const mcId = resource.getId();
-	const mcName = resource.getName() + ".jta";
-	const mcPath = resource.getPath() ?? "/";
-	const filePath = `${options.basePath}/${pkg.getName()}${mcPath}${mcName}`;
+	const filePath = resolveMovieClipSourcePath(resource, pkg, options.basePath);
 	try {
-		const jta = extractJtaFrames(await options.readFileRaw(filePath));
-		if (jta.frames.length === 0) return;
-		const frameMetas = jta.meta?.frames ?? [];
+		const jta = options.preparedMovieClips?.get(resource) ?? await prepareMovieClipResource(resource, pkg, encoder, options.basePath, options.readFileRaw);
 		for (const frame of resource.listFrames()) resource.removeFrame(frame);
-		resource.setInterval(jta.meta?.interval ?? 100).setSwing(jta.meta?.swing ?? false).setRepeatDelay(jta.meta?.repeatDelay ?? 0);
-		if (frameMetas.length > 0) {
-			const firstFrameIndexByTextureIndex = /* @__PURE__ */ new Map();
-			for (let frameIndex = 0; frameIndex < frameMetas.length; frameIndex += 1) {
-				const meta = frameMetas[frameIndex];
-				const textureIndex = Number.isFinite(meta.textureIndex) ? meta.textureIndex : frameIndex;
-				if (!firstFrameIndexByTextureIndex.has(textureIndex)) firstFrameIndexByTextureIndex.set(textureIndex, frameIndex);
-			}
-			const spriteIdByTextureIndex = /* @__PURE__ */ new Map();
-			for (let textureIndex = 0; textureIndex < jta.frames.length; textureIndex += 1) {
-				const exportFrameIndex = firstFrameIndexByTextureIndex.get(textureIndex);
-				if (exportFrameIndex === void 0) continue;
-				const itemId = `${mcId}_${exportFrameIndex}`;
-				const input = await createMovieClipFrameInput(jta.frames[textureIndex], itemId, resource, encoder, options.strictOutput);
-				if (!input) continue;
-				inputs.push(input);
-				spriteIdByTextureIndex.set(textureIndex, itemId);
-			}
-			for (let frameIndex = 0; frameIndex < frameMetas.length; frameIndex += 1) {
-				const meta = frameMetas[frameIndex];
-				const textureIndex = Number.isFinite(meta.textureIndex) ? meta.textureIndex : frameIndex;
-				const frame = doc.createMovieFrame(`${mcId}_${frameIndex}`);
-				frame.setRectX(meta.offsetX).setRectY(meta.offsetY).setRectWidth(meta.width).setRectHeight(meta.height).setAddDelay(meta.addDelay).setSpriteId(spriteIdByTextureIndex.get(textureIndex) ?? "");
-				resource.addFrame(frame);
-			}
-		} else for (let frameIndex = 0; frameIndex < jta.frames.length; frameIndex += 1) {
-			const itemId = `${mcId}_${frameIndex}`;
-			const input = await createMovieClipFrameInput(jta.frames[frameIndex], itemId, resource, encoder, options.strictOutput);
-			if (!input) continue;
-			inputs.push(input);
-			const frame = doc.createMovieFrame(itemId);
-			frame.setRectX(0).setRectY(0).setRectWidth(input.originalWidth).setRectHeight(input.originalHeight).setAddDelay(0).setSpriteId(itemId);
+		resource.setInterval(jta.meta.interval).setSwing(jta.meta.swing).setRepeatDelay(jta.meta.repeatDelay);
+		const spriteIdByTextureIndex = /* @__PURE__ */ new Map();
+		for (const texture of jta.referencedTextures) {
+			if (texture.width <= 0 || texture.height <= 0) continue;
+			const itemId = `${mcId}_${texture.firstFrameIndex}`;
+			inputs.push({
+				id: itemId,
+				width: texture.width,
+				height: texture.height,
+				originalWidth: texture.width,
+				originalHeight: texture.height,
+				offsetX: 0,
+				offsetY: 0,
+				resource,
+				trimBuffer: texture.buffer,
+				sourceKind: "movieclip-frame"
+			});
+			spriteIdByTextureIndex.set(texture.textureIndex, itemId);
+		}
+		for (let frameIndex = 0; frameIndex < jta.meta.frames.length; frameIndex += 1) {
+			const meta = jta.meta.frames[frameIndex];
+			const frame = doc.createMovieFrame(`${mcId}_${frameIndex}`);
+			frame.setRectX(meta.offsetX).setRectY(meta.offsetY).setRectWidth(meta.width).setRectHeight(meta.height).setAddDelay(meta.addDelay).setSpriteId(meta.textureIndex === -1 ? "" : spriteIdByTextureIndex.get(meta.textureIndex) ?? "");
 			resource.addFrame(frame);
 		}
-		if ((jta.meta?.width ?? 0) > 0 && (jta.meta?.height ?? 0) > 0) {
-			resource.setWidth(jta.meta?.width ?? 0);
-			resource.setHeight(jta.meta?.height ?? 0);
+		if (jta.meta.width > 0 && jta.meta.height > 0) {
+			resource.setWidth(jta.meta.width);
+			resource.setHeight(jta.meta.height);
 		}
-	} catch {
-		const message = `atlas: Could not parse MovieClip "${filePath}".`;
-		if (options.strictOutput) throw new Error(message);
+	} catch (error) {
+		const message = error instanceof Error ? error.message : `atlas: Could not parse MovieClip "${filePath}".`;
+		if (options.strictOutput) throw error;
 		logger.warn(`${message} Skipping frames.`);
 	}
 }
-async function createMovieClipFrameInput(buffer, itemId, resource, encoder, strictOutput) {
-	if (!encoder || buffer.length === 0) return null;
-	try {
-		const meta = await encoder(buffer).metadata();
-		const width = meta.width ?? 0;
-		const height = meta.height ?? 0;
-		if (width <= 0 || height <= 0) return null;
-		return {
-			id: itemId,
-			width,
-			height,
-			originalWidth: width,
-			originalHeight: height,
-			offsetX: 0,
-			offsetY: 0,
-			resource,
-			trimBuffer: buffer,
-			sourceKind: "movieclip-frame"
-		};
-	} catch {
-		if (strictOutput) throw new Error(`atlas: Could not decode MovieClip frame "${itemId}".`);
-		return null;
-	}
-}
 /** Collect a Bitmap Font's texture image, packed under the font's ID. */
 async function collectFontTexture(doc, fontRes, pkg, options) {
 	const textureId = fontRes.getTextureId?.() ?? "";
@@ -27958,6 +28166,14 @@ var RestoreWorkflow = class {
 			common: {},
 			adaptation: {}
 		});
+		for (const pkg of doc.getRoot().listPackages()) pkg.setSourceAtlasSettings({
+			...pkg.getSourceAtlasSettings(),
+			atlases: pkg.listAtlases().map((atlas) => ({
+				index: atlas.getIndex(),
+				name: atlas.getIndex() === 0 ? "Default" : atlas.getName(),
+				compression: false
+			}))
+		});
 	}
 	_initializeImageFileNames(doc) {
 		for (const pkg of doc.getRoot().listPackages()) for (const resource of pkg.listResources()) {
@@ -28611,7 +28827,7 @@ function publish(options) {
 				return paths.join("/");
 			}
 		});
-		const publishPackage = async (plan, writerFs, packageIndex) => {
+		const publishPackage = async (plan, writerFs, packageIndex, preparedMovieClips) => {
 			if (options.fs && !plan.outputDir) throw new Error("publish: no output directory resolved. Provide --output, or configure global publish.path / package publishPath.");
 			if (options.fs) {
 				await options.fs.mkdir(plan.outputDir);
@@ -28629,6 +28845,7 @@ function publish(options) {
 				mkdir: options.fs ? options.fs.mkdir : void 0,
 				readFileRaw: options.atlas?.readFileRaw ?? options.fs?.readFileRaw,
 				strictOutput: options.fs !== void 0,
+				preparedMovieClips,
 				packages: [plan.pkg.getName()],
 				...atlasRuntimeOptions
 			})(doc);
@@ -28681,8 +28898,25 @@ function publish(options) {
 		}
 		const unresolvedPlan = plans.find((plan) => !plan.outputDir);
 		if (unresolvedPlan) throw new Error(`publish: no output directory resolved for package "${unresolvedPlan.pkg.getName()}". Provide --output, or configure global publish.path / package publishPath.`);
+		const publishedMovieClips = allPackages.flatMap((pkg) => {
+			const publishedResourceIds = getAnnotatedPublishedResourceIds(pkg);
+			return pkg.listResources().filter((resource) => {
+				return publishedResourceIds.has(resource.getId()) && isMovieClipResource(resource);
+			}).map((resource) => ({
+				pkg,
+				resource
+			}));
+		});
+		const preparedMovieClips = /* @__PURE__ */ new Map();
+		if (publishedMovieClips.length > 0) {
+			if (!options.encoder) throw new Error("publish: MovieClip output requires an encoder.");
+			if (!options.basePath) throw new Error("publish: MovieClip output requires basePath.");
+			const readFileRaw = options.atlas?.readFileRaw ?? options.fs.readFileRaw;
+			if (!readFileRaw) throw new Error("publish: MovieClip output requires readFileRaw.");
+			for (const { pkg, resource } of publishedMovieClips) preparedMovieClips.set(resource, await prepareMovieClipResource(resource, pkg, options.encoder, options.basePath, readFileRaw));
+		}
 		const writerFs = toBinaryWriterFileSystem(options.fs);
-		for (const plan of plans) await publishPackage(plan, writerFs, allDocPackages.indexOf(plan.pkg));
+		for (const plan of plans) await publishPackage(plan, writerFs, allDocPackages.indexOf(plan.pkg), preparedMovieClips);
 		if (options.codeGeneration !== false) await publishCodeGeneration(doc, {
 			basePath: options.basePath,
 			fs: options.fs,