@openfairygui/cli 0.2.0-alpha.21 → 0.2.0-alpha.23

package/dist/cli.mjs

@@ -1434,6 +1434,7 @@ var ImageResource = class extends ExtensibleProperty {
 			width: 0,
 			height: 0,
 			exported: false,
+			favorite: false,
 			textureSetMode: "",
 			qualityOption: "",
 			smoothing: true,
@@ -1501,6 +1502,12 @@ var ImageResource = class extends ExtensibleProperty {
 	setExported(v) {
 		return this.set("exported", v);
 	}
+	getFavorite() {
+		return this.get("favorite");
+	}
+	setFavorite(v) {
+		return this.set("favorite", v);
+	}
 	getTextureSetMode() {
 		return this.get("textureSetMode");
 	}
@@ -1596,6 +1603,7 @@ var MiscResource = class extends ExtensibleProperty {
 			branchItemIds: [],
 			file: "",
 			exported: false,
+			favorite: false,
 			resourceData: null
 		});
 	}
@@ -1635,6 +1643,12 @@ var MiscResource = class extends ExtensibleProperty {
 	setExported(v) {
 		return this.set("exported", v);
 	}
+	getFavorite() {
+		return this.get("favorite");
+	}
+	setFavorite(v) {
+		return this.set("favorite", v);
+	}
 	getResourceData() {
 		return this.getRef("resourceData");
 	}
@@ -1667,6 +1681,7 @@ var SoundResource = class extends ExtensibleProperty {
 			branchItemIds: [],
 			file: "",
 			exported: false,
+			favorite: false,
 			soundData: null
 		});
 	}
@@ -1706,6 +1721,12 @@ var SoundResource = class extends ExtensibleProperty {
 	setExported(v) {
 		return this.set("exported", v);
 	}
+	getFavorite() {
+		return this.get("favorite");
+	}
+	setFavorite(v) {
+		return this.set("favorite", v);
+	}
 	getSoundData() {
 		return this.getRef("soundData");
 	}
@@ -1739,6 +1760,7 @@ var FontResource = class extends ExtensibleProperty {
 			fileName: "",
 			textureId: "",
 			exported: false,
+			favorite: false,
 			renderMode: "",
 			samplePointSize: 0,
 			ttf: false,
@@ -1794,6 +1816,12 @@ var FontResource = class extends ExtensibleProperty {
 	setExported(v) {
 		return this.set("exported", v);
 	}
+	getFavorite() {
+		return this.get("favorite");
+	}
+	setFavorite(v) {
+		return this.set("favorite", v);
+	}
 	getRenderMode() {
 		return this.get("renderMode");
 	}
@@ -1884,6 +1912,7 @@ var MovieClipResource = class extends ExtensibleProperty {
 			highResolutionItemIds: [],
 			fileName: "",
 			exported: false,
+			favorite: false,
 			textureSetMode: "",
 			width: 0,
 			height: 0,
@@ -1937,6 +1966,12 @@ var MovieClipResource = class extends ExtensibleProperty {
 	setExported(v) {
 		return this.set("exported", v);
 	}
+	getFavorite() {
+		return this.get("favorite");
+	}
+	setFavorite(v) {
+		return this.set("favorite", v);
+	}
 	getTextureSetMode() {
 		return this.get("textureSetMode");
 	}
@@ -2011,6 +2046,7 @@ var SkeletonResourceBase = class extends ExtensibleProperty {
 			branchItemIds: [],
 			file: "",
 			exported: false,
+			favorite: false,
 			width: 0,
 			height: 0,
 			requireIds: [],
@@ -2056,6 +2092,12 @@ var SkeletonResourceBase = class extends ExtensibleProperty {
 	setExported(v) {
 		return this.set("exported", v);
 	}
+	getFavorite() {
+		return this.get("favorite");
+	}
+	setFavorite(v) {
+		return this.set("favorite", v);
+	}
 	getWidth() {
 		return this.get("width");
 	}
@@ -2148,6 +2190,7 @@ var Component = class extends ExtensibleProperty {
 			branch: "",
 			branchItemIds: [],
 			exported: false,
+			favorite: false,
 			width: 0,
 			height: 0,
 			minWidth: 0,
@@ -2247,6 +2290,12 @@ var Component = class extends ExtensibleProperty {
 	setExported(v) {
 		return this.set("exported", v);
 	}
+	getFavorite() {
+		return this.get("favorite");
+	}
+	setFavorite(v) {
+		return this.set("favorite", v);
+	}
 	getWidth() {
 		return this.get("width");
 	}
@@ -9368,6 +9417,137 @@ function ensureArray(v) {
 	return Array.isArray(v) ? v : [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";
+/**
+* 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;
+	if (mark !== FILE_MARK) throw new Error(`Invalid .jta file: expected "${FILE_MARK}", got "${mark}"`);
+	const version = view.getInt32(pos);
+	pos += 4;
+	if (version < 100 || version > 102) throw new Error(`Unsupported .jta version: ${version}`);
+	let fps = view.getInt8(pos);
+	pos += 1;
+	if (fps === 0) fps = 24;
+	pos += 3;
+	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;
+	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;
+		frames.push({
+			delay,
+			rectX,
+			rectY,
+			rectWidth,
+			rectHeight,
+			textureIndex
+		});
+	}
+	const textureCount = view.getInt16(pos);
+	pos += 2;
+	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 });
+	}
+	if (version === 101) {
+		pos += 4;
+		boundsWidth = view.getUint16(pos);
+		pos += 2;
+		boundsHeight = view.getUint16(pos);
+		pos += 2;
+	} else if (version === 100) {
+		let minX = Number.POSITIVE_INFINITY;
+		let minY = Number.POSITIVE_INFINITY;
+		let maxX = Number.NEGATIVE_INFINITY;
+		let maxY = Number.NEGATIVE_INFINITY;
+		for (const frame of frames) {
+			if (frame.rectWidth <= 0 || frame.rectHeight <= 0) continue;
+			minX = Math.min(minX, frame.rectX);
+			minY = Math.min(minY, frame.rectY);
+			maxX = Math.max(maxX, frame.rectX + frame.rectWidth);
+			maxY = Math.max(maxY, frame.rectY + frame.rectHeight);
+		}
+		if (Number.isFinite(minX)) {
+			boundsWidth = maxX - Math.min(minX, 0);
+			boundsHeight = maxY - Math.min(minY, 0);
+		}
+	}
+	return {
+		version,
+		fps,
+		speed,
+		repeatDelay,
+		swing,
+		boundsWidth,
+		boundsHeight,
+		frames,
+		textures
+	};
+}
+function tryReadJtaSize(data) {
+	try {
+		const parsed = parseJta(data);
+		return {
+			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.
@@ -9564,6 +9744,7 @@ const defineNode = (attrs, children, containers) => ({
 });
 const PACKAGE_DESCRIPTION_ATTRS = {
 	id: { canonical: "id" },
+	hasFavorites: { canonical: "hasFavorites" },
 	compressPNG: { canonical: "compressPNG" },
 	jpegQuality: { canonical: "jpegQuality" }
 };
@@ -9584,7 +9765,8 @@ const PACKAGE_RESOURCE_BASE_ATTRS = {
 	id: { canonical: "id" },
 	name: { canonical: "name" },
 	path: { canonical: "path" },
-	exported: { canonical: "exported" }
+	exported: { canonical: "exported" },
+	favorite: { canonical: "favorite" }
 };
 const PACKAGE_IMAGE_RESOURCE_ATTRS = {
 	atlas: { canonical: "atlas" },
@@ -12131,6 +12313,10 @@ var ProjectReader = class {
 				const data = new Uint8Array(await fs.readFileRaw(filePath));
 				const buffer = doc.createBuffer().setURI(sourcePath).setData(data);
 				this._asSourceDataResource(resource).setSourceData(buffer);
+				if (resource.propertyType === "MovieClipResource") {
+					const size = tryReadJtaSize(data);
+					if (size) resource.setWidth(size.width).setHeight(size.height);
+				}
 			} catch {}
 		}
 	}
@@ -12162,6 +12348,7 @@ var ProjectReader = class {
 		const name = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageResource.attrs.name) ?? "";
 		const path = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageResource.attrs.path) ?? "/";
 		const exported = parseBool(readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageResource.attrs.exported));
+		const favorite = parseBool(readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageResource.attrs.favorite));
 		switch (tagName) {
 			case "image": {
 				const res = doc.createImageResource(name.replace(/\.\w+$/, ""));
@@ -12169,6 +12356,7 @@ var ProjectReader = class {
 				res.setPath(path);
 				res.setBranch(branchName);
 				res.setExported(exported);
+				res.setFavorite(favorite);
 				res.setFileName(name);
 				const textureSetMode = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageImageResource.attrs.atlas);
 				if (textureSetMode !== void 0) res.setTextureSetMode(textureSetMode);
@@ -12198,6 +12386,7 @@ var ProjectReader = class {
 				res.setPath(path);
 				res.setBranch(branchName);
 				res.setExported(exported);
+				res.setFavorite(favorite);
 				const filePath = fs.join(packageDir, path.replace(/^\//, ""), name);
 				res.setExtras({
 					...res.getExtras(),
@@ -12214,6 +12403,7 @@ var ProjectReader = class {
 				res.setBranch(branchName);
 				res.setFile(name);
 				res.setExported(exported);
+				res.setFavorite(favorite);
 				pkg.addResource(res);
 				ctx.registerResource(pkg.getId(), id, res);
 				return res;
@@ -12225,6 +12415,7 @@ var ProjectReader = class {
 				res.setBranch(branchName);
 				res.setFile(name);
 				res.setExported(exported);
+				res.setFavorite(favorite);
 				pkg.addResource(res);
 				ctx.registerResource(pkg.getId(), id, res);
 				return res;
@@ -12236,6 +12427,7 @@ var ProjectReader = class {
 				res.setBranch(branchName);
 				res.setFileName(name);
 				res.setExported(exported);
+				res.setFavorite(favorite);
 				const texture = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageFontResource.attrs.texture);
 				if (texture) res.setTextureId(texture);
 				const renderMode = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageFontResource.attrs.renderMode);
@@ -12253,6 +12445,7 @@ var ProjectReader = class {
 				res.setBranch(branchName);
 				res.setFile(name);
 				res.setExported(exported);
+				res.setFavorite(favorite);
 				res.setWidth(parseInt2(readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageSkeletonResource.attrs.width)));
 				res.setHeight(parseInt2(readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageSkeletonResource.attrs.height)));
 				const requireValue = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageSkeletonResource.attrs.require);
@@ -12275,6 +12468,7 @@ var ProjectReader = class {
 				res.setBranch(branchName);
 				res.setFile(name);
 				res.setExported(exported);
+				res.setFavorite(favorite);
 				res.setWidth(parseInt2(readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageSkeletonResource.attrs.width)));
 				res.setHeight(parseInt2(readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageSkeletonResource.attrs.height)));
 				const requireValue = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageSkeletonResource.attrs.require);
@@ -12297,6 +12491,7 @@ var ProjectReader = class {
 				res.setBranch(branchName);
 				res.setFileName(name);
 				res.setExported(exported);
+				res.setFavorite(favorite);
 				const textureSetMode = readXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageMovieClipResource.attrs.atlas);
 				if (textureSetMode !== void 0) res.setTextureSetMode(textureSetMode);
 				pkg.addResource(res);
@@ -13659,6 +13854,7 @@ var ProjectWriter = class {
 		const codePath = pkg.getCodePath();
 		const packageDescriptionAttrs = {};
 		writeXmlAttr(packageDescriptionAttrs, PROJECT_XML_PROTOCOL.packageDescription.attrs.id, pkg.getId());
+		if (pkg.listResources().some((resource) => resource.getFavorite?.())) 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");
 		const jpegQuality = pkg.getJpegQuality();
@@ -13869,6 +14065,7 @@ var ProjectWriter = class {
 			writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageResource.attrs.name, this._resourceFileName(res));
 			writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageResource.attrs.path, typedRes.getPath?.() ?? "/");
 			if (typedRes.getExported?.()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageResource.attrs.exported, "true");
+			if (typedRes.getFavorite?.()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.packageResource.attrs.favorite, "true");
 			if (res.propertyType === "ImageResource") {
 				const imgRes = res;
 				const textureSetMode = imgRes.getTextureSetMode?.() ?? "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfairygui/cli",
-  "version": "0.2.0-alpha.21",
+  "version": "0.2.0-alpha.23",
   "description": "FairyGUI Headless Authoring SDK — command-line interface.",
   "author": "OpenFairyGUI Contributors",
   "license": "MIT",
@@ -33,13 +33,13 @@
     "restore"
   ],
   "devDependencies": {
-    "@openfairygui/core": "0.2.0-alpha.21",
-    "@openfairygui/functions": "0.2.0-alpha.21"
+    "@openfairygui/core": "0.2.0-alpha.23",
+    "@openfairygui/functions": "0.2.0-alpha.23"
   },
   "dependencies": {
     "commander": "^14.0.2",
     "jiti": "^2.7.0",
-    "@openfairygui/backend": "0.2.0-alpha.21"
+    "@openfairygui/backend": "0.2.0-alpha.23"
   },
   "optionalDependencies": {
     "sharp": ">=0.33.0"