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

package/dist/cli.mjs

@@ -2304,6 +2304,7 @@ var Component = class extends ExtensibleProperty {
 			wholeNumbers: false,
 			changeOnClick: true,
 			fixedGripSize: false,
+			autoClearItems: false,
 			opaque: true,
 			customProperties: [],
 			childrenRenderOrder: ChildrenRenderOrder.Ascent,
@@ -2687,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");
 	}
@@ -4937,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) {
@@ -5236,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");
 	}
@@ -5260,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");
 	}
@@ -5327,6 +5348,7 @@ var GListBase = class extends GObject {
 			clipSoftness: [0, 0],
 			scrollItemToViewOnClick: true,
 			foldInvisibleItems: false,
+			autoClearItems: false,
 			listItems: [],
 			pageController: "",
 			controllerOverrides: "",
@@ -5619,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");
 	}
@@ -16553,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" },
@@ -16581,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" },
@@ -16671,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 = {
@@ -16722,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));
@@ -16786,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) {
@@ -16944,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);
 }
@@ -16978,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,
@@ -16987,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) {
@@ -18054,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) {
@@ -18092,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) {
@@ -18128,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;
@@ -18470,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)));
@@ -19552,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) {
@@ -20034,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 }));
@@ -20101,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;
@@ -20119,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;
@@ -20388,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?.());
@@ -25577,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfairygui/cli",
-  "version": "0.2.0-alpha.35",
+  "version": "0.2.0-alpha.36",
   "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.35",
-    "@openfairygui/functions": "0.2.0-alpha.35"
+    "@openfairygui/functions": "0.2.0-alpha.36",
+    "@openfairygui/core": "0.2.0-alpha.36"
   },
   "dependencies": {
     "commander": "^14.0.2",
     "jiti": "^2.7.0",
-    "@openfairygui/backend": "0.2.0-alpha.35"
+    "@openfairygui/backend": "0.2.0-alpha.36"
   },
   "optionalDependencies": {
     "sharp": ">=0.33.0"