@openfairygui/cli 0.2.3 → 0.2.5

package/dist/cli.mjs

@@ -864,7 +864,7 @@ var ExtensibleProperty = class extends Property {
 };
 //#endregion
 //#region ../core/src/constants.ts
-const VERSION = `v0.2.3`;
+const VERSION = `v0.2.5`;
 /** Binary package file magic number: "FGUI" as uint32. */
 const FGUI_MAGIC = 1179080009;
 /** Null string index in the binary string table. */
@@ -6526,6 +6526,10 @@ var Controller = class extends ExtensibleProperty {
 		return Object.assign(super.getDefaults(), {
 			selectedIndex: 0,
 			autoRadioGroupDepth: false,
+			alias: "",
+			exported: false,
+			homePageType: "default",
+			homePage: "",
 			pages: new RefList(),
 			actions: new RefList()
 		});
@@ -6542,6 +6546,30 @@ var Controller = class extends ExtensibleProperty {
 	setAutoRadioGroupDepth(v) {
 		return this.set("autoRadioGroupDepth", v);
 	}
+	getAlias() {
+		return this.get("alias");
+	}
+	setAlias(v) {
+		return this.set("alias", v);
+	}
+	getExported() {
+		return this.get("exported");
+	}
+	setExported(v) {
+		return this.set("exported", v);
+	}
+	getHomePageType() {
+		return this.get("homePageType");
+	}
+	setHomePageType(v) {
+		return this.set("homePageType", v);
+	}
+	getHomePage() {
+		return this.get("homePage");
+	}
+	setHomePage(v) {
+		return this.set("homePage", v);
+	}
 	addPage(page) {
 		return this.addRef("pages", page);
 	}
@@ -16687,7 +16715,12 @@ const GEAR_ATTRS = {
 const CONTROLLER_ATTRS = {
 	name: { canonical: "name" },
 	pages: { canonical: "pages" },
-	selected: { canonical: "selected" }
+	selected: { canonical: "selected" },
+	alias: { canonical: "alias" },
+	autoRadioGroupDepth: { canonical: "autoRadioGroupDepth" },
+	exported: { canonical: "exported" },
+	homePageType: { canonical: "homePageType" },
+	homePage: { canonical: "homePage" }
 };
 const CONTROLLER_ACTION_ATTRS = {
 	type: { canonical: "type" },
@@ -18355,6 +18388,12 @@ const EXTENSION_TYPE_MAP = {
 	Slider: "GSlider",
 	ScrollBar: "GScrollBar"
 };
+const CONTROLLER_HOME_PAGE_TYPES = new Set([
+	"default",
+	"specific",
+	"branch",
+	"variable"
+]);
 const EXTENSION_PROTOCOL_MAP$1 = {
 	Button: PROJECT_XML_PROTOCOL.buttonExtension,
 	Label: PROJECT_XML_PROTOCOL.labelExtension,
@@ -18679,7 +18718,9 @@ function readComponentXml(ctx, comp, xmlContent) {
 		const ctrlName = readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.name) ?? "";
 		const ctrl = doc.createController(ctrlName);
 		const selected = readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.selected);
-		ctrl.setSelectedIndex(parseInt2(selected));
+		const homePageType = readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.homePageType) ?? "default";
+		if (!CONTROLLER_HOME_PAGE_TYPES.has(homePageType)) throw new Error(`Controller "${ctrlName}" has unsupported homePageType "${homePageType}".`);
+		ctrl.setSelectedIndex(parseInt2(selected)).setAlias(readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.alias) ?? "").setAutoRadioGroupDepth(parseBool(readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.autoRadioGroupDepth))).setExported(parseBool(readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.exported))).setHomePageType(homePageType).setHomePage(readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.homePage) ?? "");
 		const pages = parseControllerPages(readXmlAttr(ctrlDef, PROJECT_XML_PROTOCOL.controller.attrs.pages) ?? "");
 		for (const page of pages) {
 			const p = doc.createControllerPage(page.name);
@@ -20661,6 +20702,11 @@ function serializeController(ctrl) {
 	writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.name, ctrl.getName());
 	writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.pages, pagesStr);
 	writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.selected, String(ctrl.getSelectedIndex()));
+	if (ctrl.getAlias()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.alias, ctrl.getAlias());
+	if (ctrl.getAutoRadioGroupDepth()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.autoRadioGroupDepth, "true");
+	if (ctrl.getExported()) writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.exported, "true");
+	if (ctrl.getHomePageType() !== "default") writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.homePageType, ctrl.getHomePageType());
+	if (ctrl.getHomePageType() === "specific" || ctrl.getHomePageType() === "variable") writeXmlAttr(attrs, PROJECT_XML_PROTOCOL.controller.attrs.homePage, ctrl.getHomePage());
 	const actions = ctrl.listActions().map((action) => serializeControllerAction(action));
 	const actionChildName = getProtocolChildName(PROJECT_XML_PROTOCOL.controller, "action");
 	if (actions.length > 0 && actionChildName) attrs[actionChildName] = actions;
@@ -21451,21 +21497,31 @@ function decodeComponentControllers(doc, resource, buf) {
 				controller.addPage(page);
 			}
 			let homePageIndex = 0;
+			let homePageType = controller.getHomePageType();
+			let homePage = "";
 			if (controllerBuf.version >= 2 && remainingBytes(controllerBuf) >= 1) switch (controllerBuf.getUint8()) {
 				case 1:
-					if (remainingBytes(controllerBuf) >= 2) homePageIndex = controllerBuf.getInt16();
+					homePageType = "specific";
+					if (remainingBytes(controllerBuf) >= 2) {
+						homePageIndex = controllerBuf.getInt16();
+						homePage = controller.listPages()[homePageIndex]?.getId() ?? "";
+					}
 					break;
 				case 2:
+					homePageType = "branch";
 					homePageIndex = 0;
 					break;
 				case 3:
-					if (remainingBytes(controllerBuf) >= 2) controllerBuf.readS();
+					homePageType = "variable";
+					if (remainingBytes(controllerBuf) >= 2) homePage = controllerBuf.readS() ?? "";
 					homePageIndex = 0;
 					break;
 				default:
+					homePageType = "default";
 					homePageIndex = 0;
 					break;
 			}
+			controller.setHomePageType(homePageType).setHomePage(homePage);
 			if (controller.listPages().length > 0) {
 				const maxIndex = controller.listPages().length - 1;
 				controller.setSelectedIndex(Math.min(Math.max(homePageIndex, 0), maxIndex));
@@ -23093,7 +23149,27 @@ function _writeControllers(buf, comp) {
 			buf.writeSEx(page.getId?.() ?? "", false, false);
 			buf.writeSEx(page.getName?.() ?? "", false, false);
 		}
-		buf.writeUint8(0);
+		switch (ctrl.getHomePageType()) {
+			case "default":
+				buf.writeUint8(0);
+				break;
+			case "specific": {
+				const homePageIndex = pages.findIndex((page) => page.getId() === ctrl.getHomePage());
+				if (homePageIndex < 0) throw new Error(`Controller "${ctrl.getName()}" references unknown home page id "${ctrl.getHomePage()}".`);
+				buf.writeUint8(1);
+				buf.writeInt16(homePageIndex);
+				break;
+			}
+			case "branch":
+				buf.writeUint8(2);
+				break;
+			case "variable":
+				if (!ctrl.getHomePage()) throw new Error(`Controller "${ctrl.getName()}" requires a custom property key.`);
+				buf.writeUint8(3);
+				buf.writeS(ctrl.getHomePage());
+				break;
+			default: throw new Error(`Controller "${ctrl.getName()}" has unsupported home page type.`);
+		}
 		const cb2 = buf.pos - ctrlIndexPos;
 		const actions = ctrl.listActions?.() ?? [];
 		buf.writeInt16(actions.length);
@@ -29550,7 +29626,7 @@ function registerRestoreCommand(program) {
 //#region src/utils/package-version.ts
 const require$1 = createRequire(import.meta.url);
 function getInjectedPackageVersion() {
-	const version = "0.2.3";
+	const version = "0.2.5";
 	return typeof version === "string" && true ? version : null;
 }
 function readPackageVersion() {

package/package.json

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