@siliconst/metaui 1.4.6 → 1.4.7

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/MessageStripPlugin.d.ts

@@ -14,8 +14,24 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/MessageStripPlugin"
      * @public
      */
     export class MessageStripPlugin extends BasePlugin {
+        /**
+         * Renders a `sap.m.MessageStrip` component.
+         *
+         * @param fieldMetadata The specific JSON schema properties for this field.
+         * @param bindingPath The JSON path bound to this control.
+         * @param modelName The UI5 JSONModel name.
+         * @param engineScopeId The deterministic scope ID.
+         * @param onChange The callback fired on value change.
+         * @returns {Control} The configured MessageStrip control.
+         */
         render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control;
+        /**
+         * Read-only control, returns null.
+         */
         protected getValue(): any;
+        /**
+         * Read-only control, no dynamic state needed.
+         */
         protected applyState(): void;
     }
 }

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/MessageStripPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageStripPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/MessageStripPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,gEAAgE,CAAC;IAChF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAE1C;;;;;;OAMG;IACH,MAAa,kBAAmB,SAAQ,UAAU;QACvC,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,SAAS,GAAE,MAAe,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QAgB7L,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB,SAAS,CAAC,UAAU,IAAI,IAAI;KAG/B;CAEA"}
+{"version":3,"file":"MessageStripPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/MessageStripPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,gEAAgE,CAAC;IAChF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAE1C;;;;;;OAMG;IACH,MAAa,kBAAmB,SAAQ,UAAU;QAC9C;;;;;;;;;WASG;QACI,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,SAAS,GAAE,MAAe,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QAgB7L;;WAEG;QACH,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAG/B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/MessageStripPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"MessageStripPlugin.js","names":["BasePlugin","___BasePlugin","MessageStripPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","control","MessageStrip","id","generateStableId","text","type","showIcon","showCloseButton","getValue","applyState","__exports","__esModule"],"sources":["MessageStripPlugin.ts"],"sourcesContent":["/**\n * @file MessageStripPlugin.ts\n * @description Renders a sap.m.MessageStrip for informational text.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport MessageStrip from \"sap/m/MessageStrip\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Renders read-only informational alerts within the layout.\n * Does not emit values to the payload.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.controls\n * @public\n */\nexport class MessageStripPlugin extends BasePlugin {\n    public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = fieldMetadata;\n        \n        // Use binding to display text if the field has a value, otherwise use the label\n        this.control = new MessageStrip({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: `{${modelName}>${bindingPath}}`,\n            type: \"Information\", // Can be driven by schema arguments in the future\n            showIcon: true,\n            showCloseButton: false\n        });\n\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return null; // Read-only component\n    }\n\n    protected applyState(): void {\n        // Read-only component, no dynamic state needed currently\n    }\n}\n"],"mappings":"+EAAA,MAKSA,EAAUC,EAAA,cAYZ,MAAMC,UAA2BF,EAC7BG,OAAOC,EAAmCC,EAAsBC,EAAoB,OAAQC,EAAwBC,GACvHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAGhBK,KAAKE,QAAU,IAAIC,EAAa,CAC5BC,GAAIJ,KAAKK,iBAAiBP,EAAeF,GACzCU,KAAM,IAAIT,KAAaD,KACvBW,KAAM,cACNC,SAAU,KACVC,gBAAiB,QAGrB,OAAOT,KAAKE,OAChB,CAEUQ,WACN,OAAO,IACX,CAEUC,aACN,EAEP,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAAnB,qBAAA,OAAAmB,CAAA","ignoreList":[]}
+{"version":3,"file":"MessageStripPlugin.js","names":["BasePlugin","___BasePlugin","MessageStripPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","control","MessageStrip","id","generateStableId","text","type","showIcon","showCloseButton","getValue","applyState","__exports","__esModule"],"sources":["MessageStripPlugin.ts"],"sourcesContent":["/**\n * @file MessageStripPlugin.ts\n * @description Renders a sap.m.MessageStrip for informational text.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport MessageStrip from \"sap/m/MessageStrip\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Renders read-only informational alerts within the layout.\n * Does not emit values to the payload.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.controls\n * @public\n */\nexport class MessageStripPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.MessageStrip` component.\n     * \n     * @param fieldMetadata The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured MessageStrip control.\n     */\n    public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = fieldMetadata;\n        \n        // Use binding to display text if the field has a value, otherwise use the label\n        this.control = new MessageStrip({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: `{${modelName}>${bindingPath}}`,\n            type: \"Information\", // Can be driven by schema arguments in the future\n            showIcon: true,\n            showCloseButton: false\n        });\n\n        return this.control as Control;\n    }\n\n    /**\n     * Read-only control, returns null.\n     */\n    protected getValue(): any {\n        return null; // Read-only component\n    }\n\n    /**\n     * Read-only control, no dynamic state needed.\n     */\n    protected applyState(): void {\n        // Read-only component, no dynamic state needed currently\n    }\n}\n"],"mappings":"+EAAA,MAKSA,EAAUC,EAAA,cAYZ,MAAMC,UAA2BF,EAW7BG,OAAOC,EAAmCC,EAAsBC,EAAoB,OAAQC,EAAwBC,GACvHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAGhBK,KAAKE,QAAU,IAAIC,EAAa,CAC5BC,GAAIJ,KAAKK,iBAAiBP,EAAeF,GACzCU,KAAM,IAAIT,KAAaD,KACvBW,KAAM,cACNC,SAAU,KACVC,gBAAiB,QAGrB,OAAOT,KAAKE,OAChB,CAKUQ,WACN,OAAO,IACX,CAKUC,aACN,EAEP,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAAnB,qBAAA,OAAAmB,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/MessageStripPlugin.ts

@@ -16,6 +16,16 @@ import Control from "sap/ui/core/Control";
  * @public
  */
 export class MessageStripPlugin extends BasePlugin {
+    /**
+     * Renders a `sap.m.MessageStrip` component.
+     * 
+     * @param fieldMetadata The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured MessageStrip control.
+     */
     public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = "meta", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {
         this.onChange = onChange;
         this.metadata = fieldMetadata;
@@ -32,10 +42,16 @@ export class MessageStripPlugin extends BasePlugin {
         return this.control as Control;
     }
 
+    /**
+     * Read-only control, returns null.
+     */
     protected getValue(): any {
         return null; // Read-only component
     }
 
+    /**
+     * Read-only control, no dynamic state needed.
+     */
     protected applyState(): void {
         // Read-only component, no dynamic state needed currently
     }

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/MultiSelectPlugin-dbg.js

@@ -14,6 +14,16 @@ sap.ui.define(["./BasePlugin", "sap/m/MultiComboBox", "sap/ui/core/Item"], funct
    * @public
    */
   class MultiSelectPlugin extends BasePlugin {
+    /**
+     * Renders a `sap.m.MultiComboBox` component.
+     * 
+     * @param fieldMetadata The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured MultiComboBox control.
+     */
     render(fieldMetadata, bindingPath, modelName = "meta", engineScopeId, onChange) {
       this.onChange = onChange;
       this.metadata = fieldMetadata;
@@ -55,9 +65,18 @@ sap.ui.define(["./BasePlugin", "sap/m/MultiComboBox", "sap/ui/core/Item"], funct
       this.applyCommonDirectives(this.control, fieldMetadata, modelName);
       return this.control;
     }
+
+    /**
+     * Retrieves the current selection keys.
+     * @returns {any} The selected keys.
+     */
     getValue() {
       return this.control ? this.control.getSelectedKeys() : [];
     }
+
+    /**
+     * Applies dynamic read-only state.
+     */
     applyState() {
       if (this.control && this.metadata) {
         if (!this.isEditable) return;

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/MultiSelectPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"MultiSelectPlugin-dbg.js","names":["BasePlugin","___BasePlugin","MultiSelectPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","path","formatter","val","Array","isArray","join","applyCommonDirectives","mcb","MultiComboBox","selectedKeys","enabled","readOnly","placeholder","label","selectionChange","oEvent","keys","getSelectedKeys","result","validate","isValid","fieldKey","enum","forEach","addItem","Item","key","toString","getValue","applyState","setEnabled","__exports","__esModule"],"sources":["MultiSelectPlugin.ts"],"sourcesContent":["/**\n * @file MultiSelectPlugin.ts\n * @description Renders a sap.m.MultiComboBox for selecting multiple string values.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport MultiComboBox from \"sap/m/MultiComboBox\";\nimport Item from \"sap/ui/core/Item\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering logic for selecting multiple strings from a predefined list.\n * Expects the payload to be an array of strings.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.controls\n * @public\n */\nexport class MultiSelectPlugin extends BasePlugin {\n    public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = fieldMetadata;\n\n        if (!this.isEditable) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: {\n                    path: `${modelName}>${bindingPath}`,\n                    formatter: (val: any[]) => Array.isArray(val) ? val.join(\", \") : \"\"\n                }\n            });\n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n        \n        const mcb = new MultiComboBox({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            selectedKeys: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: fieldMetadata.ui?.label || \"Select items...\",\n            selectionChange: (oEvent: sap.ui.base.Event) => {\n                const keys = (this.control as MultiComboBox).getSelectedKeys();\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        if (fieldMetadata.enum) {\n            fieldMetadata.enum.forEach((val: string | number) => {\n                mcb.addItem(new Item({ key: val.toString(), text: val.toString() }));\n            });\n        }\n\n        this.control = mcb;\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as MultiComboBox).getSelectedKeys() : [];\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            (this.control as MultiComboBox).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"MultiSelectPlugin-dbg.js","names":["BasePlugin","___BasePlugin","MultiSelectPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","path","formatter","val","Array","isArray","join","applyCommonDirectives","mcb","MultiComboBox","selectedKeys","enabled","readOnly","placeholder","label","selectionChange","oEvent","keys","getSelectedKeys","result","validate","isValid","fieldKey","enum","forEach","addItem","Item","key","toString","getValue","applyState","setEnabled","__exports","__esModule"],"sources":["MultiSelectPlugin.ts"],"sourcesContent":["/**\n * @file MultiSelectPlugin.ts\n * @description Renders a sap.m.MultiComboBox for selecting multiple string values.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport MultiComboBox from \"sap/m/MultiComboBox\";\nimport Item from \"sap/ui/core/Item\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering logic for selecting multiple strings from a predefined list.\n * Expects the payload to be an array of strings.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.controls\n * @public\n */\nexport class MultiSelectPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.MultiComboBox` component.\n     * \n     * @param fieldMetadata The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured MultiComboBox control.\n     */\n    public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = fieldMetadata;\n\n        if (!this.isEditable) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: {\n                    path: `${modelName}>${bindingPath}`,\n                    formatter: (val: any[]) => Array.isArray(val) ? val.join(\", \") : \"\"\n                }\n            });\n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n        \n        const mcb = new MultiComboBox({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            selectedKeys: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: fieldMetadata.ui?.label || \"Select items...\",\n            selectionChange: (oEvent: sap.ui.base.Event) => {\n                const keys = (this.control as MultiComboBox).getSelectedKeys();\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        if (fieldMetadata.enum) {\n            fieldMetadata.enum.forEach((val: string | number) => {\n                mcb.addItem(new Item({ key: val.toString(), text: val.toString() }));\n            });\n        }\n\n        this.control = mcb;\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current selection keys.\n     * @returns {any} The selected keys.\n     */\n    protected getValue(): any {\n        return this.control ? (this.control as MultiComboBox).getSelectedKeys() : [];\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            (this.control as MultiComboBox).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/MultiSelectPlugin.d.ts

@@ -14,8 +14,25 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/MultiSelectPlugin" {
      * @public
      */
     export class MultiSelectPlugin extends BasePlugin {
+        /**
+         * Renders a `sap.m.MultiComboBox` component.
+         *
+         * @param fieldMetadata The specific JSON schema properties for this field.
+         * @param bindingPath The JSON path bound to this control.
+         * @param modelName The UI5 JSONModel name.
+         * @param engineScopeId The deterministic scope ID.
+         * @param onChange The callback fired on value change.
+         * @returns {Control} The configured MultiComboBox control.
+         */
         render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control;
+        /**
+         * Retrieves the current selection keys.
+         * @returns {any} The selected keys.
+         */
         protected getValue(): any;
+        /**
+         * Applies dynamic read-only state.
+         */
         protected applyState(): void;
     }
 }

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/MultiSelectPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MultiSelectPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/MultiSelectPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+DAA+D,CAAC;IAC/E;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAGlF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAE1C;;;;;;OAMG;IACH,MAAa,iBAAkB,SAAQ,UAAU;QACtC,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,SAAS,GAAE,MAAe,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QA2C7L,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB,SAAS,CAAC,UAAU,IAAI,IAAI;KAM/B;CAEA"}
+{"version":3,"file":"MultiSelectPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/MultiSelectPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+DAA+D,CAAC;IAC/E;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAGlF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAE1C;;;;;;OAMG;IACH,MAAa,iBAAkB,SAAQ,UAAU;QAC7C;;;;;;;;;WASG;QACI,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,SAAS,GAAE,MAAe,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QA2C7L;;;WAGG;QACH,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAM/B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/MultiSelectPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"MultiSelectPlugin.js","names":["BasePlugin","___BasePlugin","MultiSelectPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","path","formatter","val","Array","isArray","join","applyCommonDirectives","mcb","MultiComboBox","selectedKeys","enabled","readOnly","placeholder","label","selectionChange","oEvent","keys","getSelectedKeys","result","validate","isValid","fieldKey","enum","forEach","addItem","Item","key","toString","getValue","applyState","setEnabled","__exports","__esModule"],"sources":["MultiSelectPlugin.ts"],"sourcesContent":["/**\n * @file MultiSelectPlugin.ts\n * @description Renders a sap.m.MultiComboBox for selecting multiple string values.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport MultiComboBox from \"sap/m/MultiComboBox\";\nimport Item from \"sap/ui/core/Item\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering logic for selecting multiple strings from a predefined list.\n * Expects the payload to be an array of strings.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.controls\n * @public\n */\nexport class MultiSelectPlugin extends BasePlugin {\n    public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = fieldMetadata;\n\n        if (!this.isEditable) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: {\n                    path: `${modelName}>${bindingPath}`,\n                    formatter: (val: any[]) => Array.isArray(val) ? val.join(\", \") : \"\"\n                }\n            });\n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n        \n        const mcb = new MultiComboBox({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            selectedKeys: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: fieldMetadata.ui?.label || \"Select items...\",\n            selectionChange: (oEvent: sap.ui.base.Event) => {\n                const keys = (this.control as MultiComboBox).getSelectedKeys();\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        if (fieldMetadata.enum) {\n            fieldMetadata.enum.forEach((val: string | number) => {\n                mcb.addItem(new Item({ key: val.toString(), text: val.toString() }));\n            });\n        }\n\n        this.control = mcb;\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as MultiComboBox).getSelectedKeys() : [];\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            (this.control as MultiComboBox).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"qGAAA,MAKSA,EAAUC,EAAA,cAaZ,MAAMC,UAA0BF,EAC5BG,OAAOC,EAAmCC,EAAsBC,EAAoB,OAAQC,EAAwBC,GACvHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAEhB,IAAKK,KAAKE,WAAY,CAClBC,IAAIC,GAAGC,YAAY,cACnB,MAAMC,EAAcH,IAAIC,GAAGG,QAAQ,cACnCP,KAAKQ,QAAU,IAAIF,EAAY,CAC3BG,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCe,KAAM,CACFC,KAAM,GAAGf,KAAaD,IACtBiB,UAAYC,GAAeC,MAAMC,QAAQF,GAAOA,EAAIG,KAAK,MAAQ,MAGzEjB,KAAKkB,sBAAsBlB,KAAKQ,QAASb,EAAeE,GACxD,OAAOG,KAAKQ,OAChB,CAEA,MAAMW,EAAM,IAAIC,EAAc,CAC1BX,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCyB,aAAc,IAAIxB,KAAaD,KAC/B0B,SAAU3B,EAAcS,IAAImB,SAC5BC,YAAa7B,EAAcS,IAAIqB,OAAS,kBACxCC,gBAAkBC,IACd,MAAMC,EAAQ5B,KAAKQ,QAA0BqB,kBAC7C,MAAMC,EAAS9B,KAAK+B,WACpB,GAAI/B,KAAKD,SAAU,CACfC,KAAKD,SAAS+B,EAAOE,QAAShC,KAAKiC,SACvC,KAIR,GAAItC,EAAcuC,KAAM,CACpBvC,EAAcuC,KAAKC,QAASrB,IACxBK,EAAIiB,QAAQ,IAAIC,EAAK,CAAEC,IAAKxB,EAAIyB,WAAY5B,KAAMG,EAAIyB,eAE9D,CAEAvC,KAAKQ,QAAUW,EACfnB,KAAKkB,sBAAsBlB,KAAKQ,QAASb,EAAeE,GACxD,OAAOG,KAAKQ,OAChB,CAEUgC,WACN,OAAOxC,KAAKQ,QAAWR,KAAKQ,QAA0BqB,kBAAoB,EAC9E,CAEUY,aACN,GAAIzC,KAAKQ,SAAWR,KAAKC,SAAU,CAC/B,IAAKD,KAAKE,WAAY,OACrBF,KAAKQ,QAA0BkC,YAAY1C,KAAKC,SAASG,IAAImB,SAClE,CACJ,EACH,IAAAoB,EAAA,CAAAC,WAAA,MAAAD,EAAAlD,oBAAA,OAAAkD,CAAA","ignoreList":[]}
+{"version":3,"file":"MultiSelectPlugin.js","names":["BasePlugin","___BasePlugin","MultiSelectPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","path","formatter","val","Array","isArray","join","applyCommonDirectives","mcb","MultiComboBox","selectedKeys","enabled","readOnly","placeholder","label","selectionChange","oEvent","keys","getSelectedKeys","result","validate","isValid","fieldKey","enum","forEach","addItem","Item","key","toString","getValue","applyState","setEnabled","__exports","__esModule"],"sources":["MultiSelectPlugin.ts"],"sourcesContent":["/**\n * @file MultiSelectPlugin.ts\n * @description Renders a sap.m.MultiComboBox for selecting multiple string values.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport MultiComboBox from \"sap/m/MultiComboBox\";\nimport Item from \"sap/ui/core/Item\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering logic for selecting multiple strings from a predefined list.\n * Expects the payload to be an array of strings.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.controls\n * @public\n */\nexport class MultiSelectPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.MultiComboBox` component.\n     * \n     * @param fieldMetadata The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured MultiComboBox control.\n     */\n    public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = fieldMetadata;\n\n        if (!this.isEditable) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: {\n                    path: `${modelName}>${bindingPath}`,\n                    formatter: (val: any[]) => Array.isArray(val) ? val.join(\", \") : \"\"\n                }\n            });\n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n        \n        const mcb = new MultiComboBox({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            selectedKeys: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: fieldMetadata.ui?.label || \"Select items...\",\n            selectionChange: (oEvent: sap.ui.base.Event) => {\n                const keys = (this.control as MultiComboBox).getSelectedKeys();\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        if (fieldMetadata.enum) {\n            fieldMetadata.enum.forEach((val: string | number) => {\n                mcb.addItem(new Item({ key: val.toString(), text: val.toString() }));\n            });\n        }\n\n        this.control = mcb;\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current selection keys.\n     * @returns {any} The selected keys.\n     */\n    protected getValue(): any {\n        return this.control ? (this.control as MultiComboBox).getSelectedKeys() : [];\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            (this.control as MultiComboBox).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"qGAAA,MAKSA,EAAUC,EAAA,cAaZ,MAAMC,UAA0BF,EAW5BG,OAAOC,EAAmCC,EAAsBC,EAAoB,OAAQC,EAAwBC,GACvHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAEhB,IAAKK,KAAKE,WAAY,CAClBC,IAAIC,GAAGC,YAAY,cACnB,MAAMC,EAAcH,IAAIC,GAAGG,QAAQ,cACnCP,KAAKQ,QAAU,IAAIF,EAAY,CAC3BG,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCe,KAAM,CACFC,KAAM,GAAGf,KAAaD,IACtBiB,UAAYC,GAAeC,MAAMC,QAAQF,GAAOA,EAAIG,KAAK,MAAQ,MAGzEjB,KAAKkB,sBAAsBlB,KAAKQ,QAASb,EAAeE,GACxD,OAAOG,KAAKQ,OAChB,CAEA,MAAMW,EAAM,IAAIC,EAAc,CAC1BX,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCyB,aAAc,IAAIxB,KAAaD,KAC/B0B,SAAU3B,EAAcS,IAAImB,SAC5BC,YAAa7B,EAAcS,IAAIqB,OAAS,kBACxCC,gBAAkBC,IACd,MAAMC,EAAQ5B,KAAKQ,QAA0BqB,kBAC7C,MAAMC,EAAS9B,KAAK+B,WACpB,GAAI/B,KAAKD,SAAU,CACfC,KAAKD,SAAS+B,EAAOE,QAAShC,KAAKiC,SACvC,KAIR,GAAItC,EAAcuC,KAAM,CACpBvC,EAAcuC,KAAKC,QAASrB,IACxBK,EAAIiB,QAAQ,IAAIC,EAAK,CAAEC,IAAKxB,EAAIyB,WAAY5B,KAAMG,EAAIyB,eAE9D,CAEAvC,KAAKQ,QAAUW,EACfnB,KAAKkB,sBAAsBlB,KAAKQ,QAASb,EAAeE,GACxD,OAAOG,KAAKQ,OAChB,CAMUgC,WACN,OAAOxC,KAAKQ,QAAWR,KAAKQ,QAA0BqB,kBAAoB,EAC9E,CAKUY,aACN,GAAIzC,KAAKQ,SAAWR,KAAKC,SAAU,CAC/B,IAAKD,KAAKE,WAAY,OACrBF,KAAKQ,QAA0BkC,YAAY1C,KAAKC,SAASG,IAAImB,SAClE,CACJ,EACH,IAAAoB,EAAA,CAAAC,WAAA,MAAAD,EAAAlD,oBAAA,OAAAkD,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/MultiSelectPlugin.ts

@@ -17,6 +17,16 @@ import Control from "sap/ui/core/Control";
  * @public
  */
 export class MultiSelectPlugin extends BasePlugin {
+    /**
+     * Renders a `sap.m.MultiComboBox` component.
+     * 
+     * @param fieldMetadata The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured MultiComboBox control.
+     */
     public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = "meta", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {
         this.onChange = onChange;
         this.metadata = fieldMetadata;
@@ -60,10 +70,17 @@ export class MultiSelectPlugin extends BasePlugin {
         return this.control as Control;
     }
 
+    /**
+     * Retrieves the current selection keys.
+     * @returns {any} The selected keys.
+     */
     protected getValue(): any {
         return this.control ? (this.control as MultiComboBox).getSelectedKeys() : [];
     }
 
+    /**
+     * Applies dynamic read-only state.
+     */
     protected applyState(): void {
         if (this.control && this.metadata) {
             if (!this.isEditable) return;

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin-dbg.js

@@ -10,6 +10,16 @@ sap.ui.define(["./BasePlugin", "sap/m/StepInput"], function (___BasePlugin, Step
    * Handles rendering and logic for numeric inputs.
    */
   class NumberPlugin extends BasePlugin {
+    /**
+     * Renders a `sap.m.StepInput` component for numeric evaluation.
+     * 
+     * @param fieldMetadata The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured StepInput control.
+     */
     render(fieldMetadata, bindingPath, modelName = "meta", engineScopeId, onChange) {
       this.onChange = onChange;
       this.metadata = fieldMetadata;
@@ -40,9 +50,18 @@ sap.ui.define(["./BasePlugin", "sap/m/StepInput"], function (___BasePlugin, Step
       this.applyCommonDirectives(this.control, fieldMetadata, modelName);
       return this.control;
     }
+
+    /**
+     * Retrieves the current numeric state.
+     * @returns {any} The numeric value.
+     */
     getValue() {
       return this.control ? this.control.getValue() : null;
     }
+
+    /**
+     * Applies dynamic read-only state.
+     */
     applyState() {
       if (this.control && this.metadata) {
         if (!this.isEditable) return;

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"NumberPlugin-dbg.js","names":["BasePlugin","___BasePlugin","NumberPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","applyCommonDirectives","StepInput","value","displayValuePrecision","scale","editable","readOnly","required","change","oEvent","val","getParameter","result","validate","isValid","fieldKey","getValue","applyState","input","setEditable","setRequired","__exports","__esModule"],"sources":["NumberPlugin.ts"],"sourcesContent":["/**\n * @file NumberPlugin.ts\n * @description Renders a sap.m.StepInput for numeric data.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport StepInput from \"sap/m/StepInput\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering and logic for numeric inputs.\n */\nexport class NumberPlugin extends BasePlugin {\n    public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = fieldMetadata;\n\n        if (!this.isEditable) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: `{${modelName}>${bindingPath}}`\n            });\n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new StepInput({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            displayValuePrecision: fieldMetadata.scale || 0,\n            editable: !fieldMetadata.ui?.readOnly,\n            required: fieldMetadata.required,\n            change: (oEvent: sap.ui.base.Event) => {\n                const val = oEvent.getParameter(\"value\");\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as StepInput).getValue() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            const input = this.control as StepInput;\n            input.setEditable(!this.metadata.ui?.readOnly);\n            input.setRequired(this.metadata.required);\n        }\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAKSA,UAAU,GAAAC,aAAA;EAKnB;AACA;AACA;EACO,MAAMC,YAAY,SAASF,UAAU,CAAC;IAClCG,MAAMA,CAACC,aAAgC,EAAGC,WAAmB,EAAGC,SAAiB,GAAG,MAAM,EAAEC,aAAsB,EAAEC,QAAwD,EAAW;MAC1L,IAAI,CAACA,QAAQ,GAAGA,QAAQ;MACxB,IAAI,CAACC,QAAQ,GAAGL,aAAa;MAE7B,IAAI,CAAC,IAAI,CAACM,UAAU,EAAE;QAClBC,GAAG,CAACC,EAAE,CAACC,WAAW,CAAC,YAAY,CAAC;QAChC,MAAMC,WAAW,GAAGH,GAAG,CAACC,EAAE,CAACG,OAAO,CAAC,YAAY,CAAC;QAChD,IAAI,CAACC,OAAO,GAAG,IAAIF,WAAW,CAAC;UAC3BG,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACX,aAAa,EAAEF,WAAW,CAAC;UACrDc,IAAI,EAAE,IAAIb,SAAS,IAAID,WAAW;QACtC,CAAC,CAAC;QACF,IAAI,CAACe,qBAAqB,CAAC,IAAI,CAACJ,OAAO,EAAEZ,aAAa,EAAEE,SAAS,CAAC;QAClE,OAAO,IAAI,CAACU,OAAO;MACvB;MAEA,IAAI,CAACA,OAAO,GAAG,IAAIK,SAAS,CAAC;QACzBJ,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACX,aAAa,EAAEF,WAAW,CAAC;QACrDiB,KAAK,EAAE,IAAIhB,SAAS,IAAID,WAAW,GAAG;QACtCkB,qBAAqB,EAAEnB,aAAa,CAACoB,KAAK,IAAI,CAAC;QAC/CC,QAAQ,EAAE,CAACrB,aAAa,CAACQ,EAAE,EAAEc,QAAQ;QACrCC,QAAQ,EAAEvB,aAAa,CAACuB,QAAQ;QAChCC,MAAM,EAAGC,MAAyB,IAAK;UACnC,MAAMC,GAAG,GAAGD,MAAM,CAACE,YAAY,CAAC,OAAO,CAAC;UACxC,MAAMC,MAAM,GAAG,IAAI,CAACC,QAAQ,CAAC,CAAC;UAC9B,IAAI,IAAI,CAACzB,QAAQ,EAAE;YACf,IAAI,CAACA,QAAQ,CAACwB,MAAM,CAACE,OAAO,EAAE,IAAI,CAACC,QAAQ,CAAC;UAChD;QACJ;MACJ,CAAC,CAAC;MAEF,IAAI,CAACf,qBAAqB,CAAC,IAAI,CAACJ,OAAO,EAAEZ,aAAa,EAAEE,SAAS,CAAC;MAElE,OAAO,IAAI,CAACU,OAAO;IACvB;IAEUoB,QAAQA,CAAA,EAAQ;MACtB,OAAO,IAAI,CAACpB,OAAO,GAAI,IAAI,CAACA,OAAO,CAAeoB,QAAQ,CAAC,CAAC,GAAG,IAAI;IACvE;IAEUC,UAAUA,CAAA,EAAS;MACzB,IAAI,IAAI,CAACrB,OAAO,IAAI,IAAI,CAACP,QAAQ,EAAE;QAC/B,IAAI,CAAC,IAAI,CAACC,UAAU,EAAE;QACtB,MAAM4B,KAAK,GAAG,IAAI,CAACtB,OAAoB;QACvCsB,KAAK,CAACC,WAAW,CAAC,CAAC,IAAI,CAAC9B,QAAQ,CAACG,EAAE,EAAEc,QAAQ,CAAC;QAC9CY,KAAK,CAACE,WAAW,CAAC,IAAI,CAAC/B,QAAQ,CAACkB,QAAQ,CAAC;MAC7C;IACJ;EACJ;EAAC,IAAAc,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAvC,YAAA,GAAAA,YAAA;EAAA,OAAAuC,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"NumberPlugin-dbg.js","names":["BasePlugin","___BasePlugin","NumberPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","applyCommonDirectives","StepInput","value","displayValuePrecision","scale","editable","readOnly","required","change","oEvent","val","getParameter","result","validate","isValid","fieldKey","getValue","applyState","input","setEditable","setRequired","__exports","__esModule"],"sources":["NumberPlugin.ts"],"sourcesContent":["/**\n * @file NumberPlugin.ts\n * @description Renders a sap.m.StepInput for numeric data.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport StepInput from \"sap/m/StepInput\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering and logic for numeric inputs.\n */\nexport class NumberPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.StepInput` component for numeric evaluation.\n     * \n     * @param fieldMetadata The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured StepInput control.\n     */\n    public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = fieldMetadata;\n\n        if (!this.isEditable) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: `{${modelName}>${bindingPath}}`\n            });\n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new StepInput({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            displayValuePrecision: fieldMetadata.scale || 0,\n            editable: !fieldMetadata.ui?.readOnly,\n            required: fieldMetadata.required,\n            change: (oEvent: sap.ui.base.Event) => {\n                const val = oEvent.getParameter(\"value\");\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current numeric state.\n     * @returns {any} The numeric value.\n     */\n    protected getValue(): any {\n        return this.control ? (this.control as StepInput).getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            const input = this.control as StepInput;\n            input.setEditable(!this.metadata.ui?.readOnly);\n            input.setRequired(this.metadata.required);\n        }\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAKSA,UAAU,GAAAC,aAAA;EAKnB;AACA;AACA;EACO,MAAMC,YAAY,SAASF,UAAU,CAAC;IACzC;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACWG,MAAMA,CAACC,aAAgC,EAAGC,WAAmB,EAAGC,SAAiB,GAAG,MAAM,EAAEC,aAAsB,EAAEC,QAAwD,EAAW;MAC1L,IAAI,CAACA,QAAQ,GAAGA,QAAQ;MACxB,IAAI,CAACC,QAAQ,GAAGL,aAAa;MAE7B,IAAI,CAAC,IAAI,CAACM,UAAU,EAAE;QAClBC,GAAG,CAACC,EAAE,CAACC,WAAW,CAAC,YAAY,CAAC;QAChC,MAAMC,WAAW,GAAGH,GAAG,CAACC,EAAE,CAACG,OAAO,CAAC,YAAY,CAAC;QAChD,IAAI,CAACC,OAAO,GAAG,IAAIF,WAAW,CAAC;UAC3BG,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACX,aAAa,EAAEF,WAAW,CAAC;UACrDc,IAAI,EAAE,IAAIb,SAAS,IAAID,WAAW;QACtC,CAAC,CAAC;QACF,IAAI,CAACe,qBAAqB,CAAC,IAAI,CAACJ,OAAO,EAAEZ,aAAa,EAAEE,SAAS,CAAC;QAClE,OAAO,IAAI,CAACU,OAAO;MACvB;MAEA,IAAI,CAACA,OAAO,GAAG,IAAIK,SAAS,CAAC;QACzBJ,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACX,aAAa,EAAEF,WAAW,CAAC;QACrDiB,KAAK,EAAE,IAAIhB,SAAS,IAAID,WAAW,GAAG;QACtCkB,qBAAqB,EAAEnB,aAAa,CAACoB,KAAK,IAAI,CAAC;QAC/CC,QAAQ,EAAE,CAACrB,aAAa,CAACQ,EAAE,EAAEc,QAAQ;QACrCC,QAAQ,EAAEvB,aAAa,CAACuB,QAAQ;QAChCC,MAAM,EAAGC,MAAyB,IAAK;UACnC,MAAMC,GAAG,GAAGD,MAAM,CAACE,YAAY,CAAC,OAAO,CAAC;UACxC,MAAMC,MAAM,GAAG,IAAI,CAACC,QAAQ,CAAC,CAAC;UAC9B,IAAI,IAAI,CAACzB,QAAQ,EAAE;YACf,IAAI,CAACA,QAAQ,CAACwB,MAAM,CAACE,OAAO,EAAE,IAAI,CAACC,QAAQ,CAAC;UAChD;QACJ;MACJ,CAAC,CAAC;MAEF,IAAI,CAACf,qBAAqB,CAAC,IAAI,CAACJ,OAAO,EAAEZ,aAAa,EAAEE,SAAS,CAAC;MAElE,OAAO,IAAI,CAACU,OAAO;IACvB;;IAEA;AACJ;AACA;AACA;IACcoB,QAAQA,CAAA,EAAQ;MACtB,OAAO,IAAI,CAACpB,OAAO,GAAI,IAAI,CAACA,OAAO,CAAeoB,QAAQ,CAAC,CAAC,GAAG,IAAI;IACvE;;IAEA;AACJ;AACA;IACcC,UAAUA,CAAA,EAAS;MACzB,IAAI,IAAI,CAACrB,OAAO,IAAI,IAAI,CAACP,QAAQ,EAAE;QAC/B,IAAI,CAAC,IAAI,CAACC,UAAU,EAAE;QACtB,MAAM4B,KAAK,GAAG,IAAI,CAACtB,OAAoB;QACvCsB,KAAK,CAACC,WAAW,CAAC,CAAC,IAAI,CAAC9B,QAAQ,CAACG,EAAE,EAAEc,QAAQ,CAAC;QAC9CY,KAAK,CAACE,WAAW,CAAC,IAAI,CAAC/B,QAAQ,CAACkB,QAAQ,CAAC;MAC7C;IACJ;EACJ;EAAC,IAAAc,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAvC,YAAA,GAAAA,YAAA;EAAA,OAAAuC,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin.d.ts

@@ -10,8 +10,25 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin" {
      * Handles rendering and logic for numeric inputs.
      */
     export class NumberPlugin extends BasePlugin {
+        /**
+         * Renders a `sap.m.StepInput` component for numeric evaluation.
+         *
+         * @param fieldMetadata The specific JSON schema properties for this field.
+         * @param bindingPath The JSON path bound to this control.
+         * @param modelName The UI5 JSONModel name.
+         * @param engineScopeId The deterministic scope ID.
+         * @param onChange The callback fired on value change.
+         * @returns {Control} The configured StepInput control.
+         */
         render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control;
+        /**
+         * Retrieves the current numeric state.
+         * @returns {any} The numeric value.
+         */
         protected getValue(): any;
+        /**
+         * Applies dynamic read-only state.
+         */
         protected applyState(): void;
     }
 }

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NumberPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,0DAA0D,CAAC;IAC1E;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAE1C;;OAEG;IACH,MAAa,YAAa,SAAQ,UAAU;QACjC,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,SAAS,GAAE,MAAe,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QAmC7L,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB,SAAS,CAAC,UAAU,IAAI,IAAI;KAQ/B;CAEA"}
+{"version":3,"file":"NumberPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,0DAA0D,CAAC;IAC1E;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAE1C;;OAEG;IACH,MAAa,YAAa,SAAQ,UAAU;QACxC;;;;;;;;;WASG;QACI,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,SAAS,GAAE,MAAe,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QAmC7L;;;WAGG;QACH,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAQ/B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"NumberPlugin.js","names":["BasePlugin","___BasePlugin","NumberPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","applyCommonDirectives","StepInput","value","displayValuePrecision","scale","editable","readOnly","required","change","oEvent","val","getParameter","result","validate","isValid","fieldKey","getValue","applyState","input","setEditable","setRequired","__exports","__esModule"],"sources":["NumberPlugin.ts"],"sourcesContent":["/**\n * @file NumberPlugin.ts\n * @description Renders a sap.m.StepInput for numeric data.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport StepInput from \"sap/m/StepInput\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering and logic for numeric inputs.\n */\nexport class NumberPlugin extends BasePlugin {\n    public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = fieldMetadata;\n\n        if (!this.isEditable) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: `{${modelName}>${bindingPath}}`\n            });\n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new StepInput({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            displayValuePrecision: fieldMetadata.scale || 0,\n            editable: !fieldMetadata.ui?.readOnly,\n            required: fieldMetadata.required,\n            change: (oEvent: sap.ui.base.Event) => {\n                const val = oEvent.getParameter(\"value\");\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as StepInput).getValue() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            const input = this.control as StepInput;\n            input.setEditable(!this.metadata.ui?.readOnly);\n            input.setRequired(this.metadata.required);\n        }\n    }\n}\n"],"mappings":"4EAAA,MAKSA,EAAUC,EAAA,cAQZ,MAAMC,UAAqBF,EACvBG,OAAOC,EAAmCC,EAAsBC,EAAoB,OAAQC,EAAwBC,GACvHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAEhB,IAAKK,KAAKE,WAAY,CAClBC,IAAIC,GAAGC,YAAY,cACnB,MAAMC,EAAcH,IAAIC,GAAGG,QAAQ,cACnCP,KAAKQ,QAAU,IAAIF,EAAY,CAC3BG,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCe,KAAM,IAAId,KAAaD,OAE3BI,KAAKY,sBAAsBZ,KAAKQ,QAASb,EAAeE,GACxD,OAAOG,KAAKQ,OAChB,CAEAR,KAAKQ,QAAU,IAAIK,EAAU,CACzBJ,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCkB,MAAO,IAAIjB,KAAaD,KACxBmB,sBAAuBpB,EAAcqB,OAAS,EAC9CC,UAAWtB,EAAcS,IAAIc,SAC7BC,SAAUxB,EAAcwB,SACxBC,OAASC,IACL,MAAMC,EAAMD,EAAOE,aAAa,SAChC,MAAMC,EAASxB,KAAKyB,WACpB,GAAIzB,KAAKD,SAAU,CACfC,KAAKD,SAASyB,EAAOE,QAAS1B,KAAK2B,SACvC,KAIR3B,KAAKY,sBAAsBZ,KAAKQ,QAASb,EAAeE,GAExD,OAAOG,KAAKQ,OAChB,CAEUoB,WACN,OAAO5B,KAAKQ,QAAWR,KAAKQ,QAAsBoB,WAAa,IACnE,CAEUC,aACN,GAAI7B,KAAKQ,SAAWR,KAAKC,SAAU,CAC/B,IAAKD,KAAKE,WAAY,OACtB,MAAM4B,EAAQ9B,KAAKQ,QACnBsB,EAAMC,aAAa/B,KAAKC,SAASG,IAAIc,UACrCY,EAAME,YAAYhC,KAAKC,SAASkB,SACpC,CACJ,EACH,IAAAc,EAAA,CAAAC,WAAA,MAAAD,EAAAxC,eAAA,OAAAwC,CAAA","ignoreList":[]}
+{"version":3,"file":"NumberPlugin.js","names":["BasePlugin","___BasePlugin","NumberPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","applyCommonDirectives","StepInput","value","displayValuePrecision","scale","editable","readOnly","required","change","oEvent","val","getParameter","result","validate","isValid","fieldKey","getValue","applyState","input","setEditable","setRequired","__exports","__esModule"],"sources":["NumberPlugin.ts"],"sourcesContent":["/**\n * @file NumberPlugin.ts\n * @description Renders a sap.m.StepInput for numeric data.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport StepInput from \"sap/m/StepInput\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering and logic for numeric inputs.\n */\nexport class NumberPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.StepInput` component for numeric evaluation.\n     * \n     * @param fieldMetadata The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured StepInput control.\n     */\n    public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = fieldMetadata;\n\n        if (!this.isEditable) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: `{${modelName}>${bindingPath}}`\n            });\n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new StepInput({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            displayValuePrecision: fieldMetadata.scale || 0,\n            editable: !fieldMetadata.ui?.readOnly,\n            required: fieldMetadata.required,\n            change: (oEvent: sap.ui.base.Event) => {\n                const val = oEvent.getParameter(\"value\");\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current numeric state.\n     * @returns {any} The numeric value.\n     */\n    protected getValue(): any {\n        return this.control ? (this.control as StepInput).getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            const input = this.control as StepInput;\n            input.setEditable(!this.metadata.ui?.readOnly);\n            input.setRequired(this.metadata.required);\n        }\n    }\n}\n"],"mappings":"4EAAA,MAKSA,EAAUC,EAAA,cAQZ,MAAMC,UAAqBF,EAWvBG,OAAOC,EAAmCC,EAAsBC,EAAoB,OAAQC,EAAwBC,GACvHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAEhB,IAAKK,KAAKE,WAAY,CAClBC,IAAIC,GAAGC,YAAY,cACnB,MAAMC,EAAcH,IAAIC,GAAGG,QAAQ,cACnCP,KAAKQ,QAAU,IAAIF,EAAY,CAC3BG,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCe,KAAM,IAAId,KAAaD,OAE3BI,KAAKY,sBAAsBZ,KAAKQ,QAASb,EAAeE,GACxD,OAAOG,KAAKQ,OAChB,CAEAR,KAAKQ,QAAU,IAAIK,EAAU,CACzBJ,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCkB,MAAO,IAAIjB,KAAaD,KACxBmB,sBAAuBpB,EAAcqB,OAAS,EAC9CC,UAAWtB,EAAcS,IAAIc,SAC7BC,SAAUxB,EAAcwB,SACxBC,OAASC,IACL,MAAMC,EAAMD,EAAOE,aAAa,SAChC,MAAMC,EAASxB,KAAKyB,WACpB,GAAIzB,KAAKD,SAAU,CACfC,KAAKD,SAASyB,EAAOE,QAAS1B,KAAK2B,SACvC,KAIR3B,KAAKY,sBAAsBZ,KAAKQ,QAASb,EAAeE,GAExD,OAAOG,KAAKQ,OAChB,CAMUoB,WACN,OAAO5B,KAAKQ,QAAWR,KAAKQ,QAAsBoB,WAAa,IACnE,CAKUC,aACN,GAAI7B,KAAKQ,SAAWR,KAAKC,SAAU,CAC/B,IAAKD,KAAKE,WAAY,OACtB,MAAM4B,EAAQ9B,KAAKQ,QACnBsB,EAAMC,aAAa/B,KAAKC,SAASG,IAAIc,UACrCY,EAAME,YAAYhC,KAAKC,SAASkB,SACpC,CACJ,EACH,IAAAc,EAAA,CAAAC,WAAA,MAAAD,EAAAxC,eAAA,OAAAwC,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin.ts

@@ -12,6 +12,16 @@ import Control from "sap/ui/core/Control";
  * Handles rendering and logic for numeric inputs.
  */
 export class NumberPlugin extends BasePlugin {
+    /**
+     * Renders a `sap.m.StepInput` component for numeric evaluation.
+     * 
+     * @param fieldMetadata The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured StepInput control.
+     */
     public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = "meta", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {
         this.onChange = onChange;
         this.metadata = fieldMetadata;
@@ -47,10 +57,17 @@ export class NumberPlugin extends BasePlugin {
         return this.control as Control;
     }
 
+    /**
+     * Retrieves the current numeric state.
+     * @returns {any} The numeric value.
+     */
     protected getValue(): any {
         return this.control ? (this.control as StepInput).getValue() : null;
     }
 
+    /**
+     * Applies dynamic read-only state.
+     */
     protected applyState(): void {
         if (this.control && this.metadata) {
             if (!this.isEditable) return;

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin-dbg.js

@@ -7,6 +7,16 @@ sap.ui.define(["./BasePlugin", "sap/m/Button"], function (___BasePlugin, Button)
    */
   const BasePlugin = ___BasePlugin["BasePlugin"];
   class ObjectPlugin extends BasePlugin {
+    /**
+     * Renders a `sap.m.Button` to open a nested Object form dialog.
+     * 
+     * @param field The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured Button control.
+     */
     render(field, bindingPath, modelName = "meta", engineScopeId, onChange) {
       this.onChange = onChange;
       this.metadata = field;
@@ -53,14 +63,27 @@ sap.ui.define(["./BasePlugin", "sap/m/Button"], function (___BasePlugin, Button)
       });
       return this.control;
     }
+
+    /**
+     * Validates the object plugin (always true as validation is deferred to the dialog host).
+     * @returns {IPluginValidationResult} The validation result.
+     */
     validate() {
       return {
         isValid: true
       };
     }
+
+    /**
+     * Read-only component for the engine, returns null.
+     */
     getValue() {
       return null;
     }
+
+    /**
+     * Read-only component, no dynamic state handling needed for the button itself.
+     */
     applyState() {
       // No dynamic state handling needed for the button
     }

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectPlugin-dbg.js","names":["BasePlugin","___BasePlugin","ObjectPlugin","render","field","bindingPath","modelName","engineScopeId","onChange","metadata","propKey","startsWith","substring","subSchema","type","title","ui","label","properties","uiLayout","control","Button","id","generateStableId","text","isEditable","icon","press","oEvent","btn","getSource","parentModel","getModel","bindingContext","getBindingContext","updatePath","ctxPath","getPath","endsWith","nestedData","getProperty","sap","require","GeneratorHost","host","schemaDefinition","data","editable","attachSubmit","e","payload","getParameter","setProperty","buttonText","dialogButtonText","openInDialog","validate","isValid","getValue","applyState","__exports","__esModule"],"sources":["ObjectPlugin.ts"],"sourcesContent":["/**\n * @file ObjectPlugin.ts\n * @description Renders a button that opens a dialog to edit a nested object structure.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPluginValidationResult } from \"../../interfaces/IPlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport Button from \"sap/m/Button\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\n\nexport class ObjectPlugin extends BasePlugin {\n    public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = field;\n        const propKey = bindingPath.startsWith(\"/\") ? bindingPath.substring(1) : bindingPath;\n        \n        const subSchema: any = {\n            type: \"object\",\n            title: field.ui?.label || propKey,\n            properties: field.properties || {}\n        };\n        \n        if (field.uiLayout) {\n            subSchema.uiLayout = field.uiLayout;\n        }\n\n        this.control = new Button({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: !this.isEditable ? \"View Details\" : \"Edit Details\",\n            icon: !this.isEditable ? \"sap-icon://display\" : \"sap-icon://form\",\n            press: (oEvent: sap.ui.base.Event) => {\n                const btn = oEvent.getSource() as Button;\n                const parentModel = btn.getModel(modelName) as JSONModel;\n                if (!parentModel) return;\n                \n                const bindingContext = btn.getBindingContext(modelName);\n                let updatePath = bindingPath;\n                if (bindingContext && !bindingPath.startsWith(\"/\")) {\n                    const ctxPath = bindingContext.getPath();\n                    updatePath = ctxPath.endsWith(\"/\") ? ctxPath + bindingPath : (ctxPath === \"/\" ? \"/\" + bindingPath : ctxPath + \"/\" + bindingPath);\n                }\n                \n                const nestedData = parentModel.getProperty(updatePath) || {};\n\n                sap.ui.require([\"nz/co/siliconst/ui5/metaui/controls/host/GeneratorHost\"], (GeneratorHost: any) => {\n                    const host = new GeneratorHost({\n                        schemaDefinition: subSchema,\n                        data: nestedData,\n                        editable: this.isEditable\n                    });\n\n                    if (!!this.isEditable) {\n                        host.attachSubmit((e: any) => {\n                            const payload = e.getParameter(\"payload\");\n                            parentModel.setProperty(updatePath, payload);\n                        });\n                    }\n\n                    const buttonText = field.ui?.dialogButtonText || (!this.isEditable ? \"Close\" : \"OK\");\n                    host.openInDialog(`Nested Details: ${field.ui?.label || propKey}`, buttonText);\n                });\n            }\n        });\n\n        return this.control as Control;\n    }\n\n    public validate(): IPluginValidationResult {\n        return { isValid: true };\n    }\n\n    protected getValue(): any {\n        return null;\n    }\n\n    protected applyState(): void {\n        // No dynamic state handling needed for the button\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"ObjectPlugin-dbg.js","names":["BasePlugin","___BasePlugin","ObjectPlugin","render","field","bindingPath","modelName","engineScopeId","onChange","metadata","propKey","startsWith","substring","subSchema","type","title","ui","label","properties","uiLayout","control","Button","id","generateStableId","text","isEditable","icon","press","oEvent","btn","getSource","parentModel","getModel","bindingContext","getBindingContext","updatePath","ctxPath","getPath","endsWith","nestedData","getProperty","sap","require","GeneratorHost","host","schemaDefinition","data","editable","attachSubmit","e","payload","getParameter","setProperty","buttonText","dialogButtonText","openInDialog","validate","isValid","getValue","applyState","__exports","__esModule"],"sources":["ObjectPlugin.ts"],"sourcesContent":["/**\n * @file ObjectPlugin.ts\n * @description Renders a button that opens a dialog to edit a nested object structure.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPluginValidationResult } from \"../../interfaces/IPlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport Button from \"sap/m/Button\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\n\nexport class ObjectPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.Button` to open a nested Object form dialog.\n     * \n     * @param field The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured Button control.\n     */\n    public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = field;\n        const propKey = bindingPath.startsWith(\"/\") ? bindingPath.substring(1) : bindingPath;\n        \n        const subSchema: any = {\n            type: \"object\",\n            title: field.ui?.label || propKey,\n            properties: field.properties || {}\n        };\n        \n        if (field.uiLayout) {\n            subSchema.uiLayout = field.uiLayout;\n        }\n\n        this.control = new Button({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: !this.isEditable ? \"View Details\" : \"Edit Details\",\n            icon: !this.isEditable ? \"sap-icon://display\" : \"sap-icon://form\",\n            press: (oEvent: sap.ui.base.Event) => {\n                const btn = oEvent.getSource() as Button;\n                const parentModel = btn.getModel(modelName) as JSONModel;\n                if (!parentModel) return;\n                \n                const bindingContext = btn.getBindingContext(modelName);\n                let updatePath = bindingPath;\n                if (bindingContext && !bindingPath.startsWith(\"/\")) {\n                    const ctxPath = bindingContext.getPath();\n                    updatePath = ctxPath.endsWith(\"/\") ? ctxPath + bindingPath : (ctxPath === \"/\" ? \"/\" + bindingPath : ctxPath + \"/\" + bindingPath);\n                }\n                \n                const nestedData = parentModel.getProperty(updatePath) || {};\n\n                sap.ui.require([\"nz/co/siliconst/ui5/metaui/controls/host/GeneratorHost\"], (GeneratorHost: any) => {\n                    const host = new GeneratorHost({\n                        schemaDefinition: subSchema,\n                        data: nestedData,\n                        editable: this.isEditable\n                    });\n\n                    if (!!this.isEditable) {\n                        host.attachSubmit((e: any) => {\n                            const payload = e.getParameter(\"payload\");\n                            parentModel.setProperty(updatePath, payload);\n                        });\n                    }\n\n                    const buttonText = field.ui?.dialogButtonText || (!this.isEditable ? \"Close\" : \"OK\");\n                    host.openInDialog(`Nested Details: ${field.ui?.label || propKey}`, buttonText);\n                });\n            }\n        });\n\n        return this.control as Control;\n    }\n\n    /**\n     * Validates the object plugin (always true as validation is deferred to the dialog host).\n     * @returns {IPluginValidationResult} The validation result.\n     */\n    public validate(): IPluginValidationResult {\n        return { isValid: true };\n    }\n\n    /**\n     * Read-only component for the engine, returns null.\n     */\n    protected getValue(): any {\n        return null;\n    }\n\n    /**\n     * Read-only component, no dynamic state handling needed for the button itself.\n     */\n    protected applyState(): void {\n        // No dynamic state handling needed for the button\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin.d.ts

@@ -8,9 +8,29 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin" {
     import { IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
     import Control from "sap/ui/core/Control";
     export class ObjectPlugin extends BasePlugin {
+        /**
+         * Renders a `sap.m.Button` to open a nested Object form dialog.
+         *
+         * @param field The specific JSON schema properties for this field.
+         * @param bindingPath The JSON path bound to this control.
+         * @param modelName The UI5 JSONModel name.
+         * @param engineScopeId The deterministic scope ID.
+         * @param onChange The callback fired on value change.
+         * @returns {Control} The configured Button control.
+         */
         render(field: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control;
+        /**
+         * Validates the object plugin (always true as validation is deferred to the dialog host).
+         * @returns {IPluginValidationResult} The validation result.
+         */
         validate(): IPluginValidationResult;
+        /**
+         * Read-only component for the engine, returns null.
+         */
         protected getValue(): any;
+        /**
+         * Read-only component, no dynamic state handling needed for the button itself.
+         */
         protected applyState(): void;
     }
 }

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,0DAA0D,CAAC;IAC1E;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;IACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAI1C,MAAa,YAAa,SAAQ,UAAU;QACjC,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,SAAS,GAAE,MAAe,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QAwD9K,QAAQ,IAAI,uBAAuB;QAI1C,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB,SAAS,CAAC,UAAU,IAAI,IAAI;KAG/B;CAEA"}
+{"version":3,"file":"ObjectPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,0DAA0D,CAAC;IAC1E;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;IACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAI1C,MAAa,YAAa,SAAQ,UAAU;QACxC;;;;;;;;;WASG;QACI,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,SAAS,GAAE,MAAe,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QAwDrL;;;WAGG;QACI,QAAQ,IAAI,uBAAuB;QAI1C;;WAEG;QACH,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAG/B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectPlugin.js","names":["BasePlugin","___BasePlugin","ObjectPlugin","render","field","bindingPath","modelName","engineScopeId","onChange","this","metadata","propKey","startsWith","substring","subSchema","type","title","ui","label","properties","uiLayout","control","Button","id","generateStableId","text","isEditable","icon","press","oEvent","btn","getSource","parentModel","getModel","bindingContext","getBindingContext","updatePath","ctxPath","getPath","endsWith","nestedData","getProperty","sap","require","GeneratorHost","host","schemaDefinition","data","editable","attachSubmit","e","payload","getParameter","setProperty","buttonText","dialogButtonText","openInDialog","validate","isValid","getValue","applyState","__exports","__esModule"],"sources":["ObjectPlugin.ts"],"sourcesContent":["/**\n * @file ObjectPlugin.ts\n * @description Renders a button that opens a dialog to edit a nested object structure.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPluginValidationResult } from \"../../interfaces/IPlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport Button from \"sap/m/Button\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\n\nexport class ObjectPlugin extends BasePlugin {\n    public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = field;\n        const propKey = bindingPath.startsWith(\"/\") ? bindingPath.substring(1) : bindingPath;\n        \n        const subSchema: any = {\n            type: \"object\",\n            title: field.ui?.label || propKey,\n            properties: field.properties || {}\n        };\n        \n        if (field.uiLayout) {\n            subSchema.uiLayout = field.uiLayout;\n        }\n\n        this.control = new Button({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: !this.isEditable ? \"View Details\" : \"Edit Details\",\n            icon: !this.isEditable ? \"sap-icon://display\" : \"sap-icon://form\",\n            press: (oEvent: sap.ui.base.Event) => {\n                const btn = oEvent.getSource() as Button;\n                const parentModel = btn.getModel(modelName) as JSONModel;\n                if (!parentModel) return;\n                \n                const bindingContext = btn.getBindingContext(modelName);\n                let updatePath = bindingPath;\n                if (bindingContext && !bindingPath.startsWith(\"/\")) {\n                    const ctxPath = bindingContext.getPath();\n                    updatePath = ctxPath.endsWith(\"/\") ? ctxPath + bindingPath : (ctxPath === \"/\" ? \"/\" + bindingPath : ctxPath + \"/\" + bindingPath);\n                }\n                \n                const nestedData = parentModel.getProperty(updatePath) || {};\n\n                sap.ui.require([\"nz/co/siliconst/ui5/metaui/controls/host/GeneratorHost\"], (GeneratorHost: any) => {\n                    const host = new GeneratorHost({\n                        schemaDefinition: subSchema,\n                        data: nestedData,\n                        editable: this.isEditable\n                    });\n\n                    if (!!this.isEditable) {\n                        host.attachSubmit((e: any) => {\n                            const payload = e.getParameter(\"payload\");\n                            parentModel.setProperty(updatePath, payload);\n                        });\n                    }\n\n                    const buttonText = field.ui?.dialogButtonText || (!this.isEditable ? \"Close\" : \"OK\");\n                    host.openInDialog(`Nested Details: ${field.ui?.label || propKey}`, buttonText);\n                });\n            }\n        });\n\n        return this.control as Control;\n    }\n\n    public validate(): IPluginValidationResult {\n        return { isValid: true };\n    }\n\n    protected getValue(): any {\n        return null;\n    }\n\n    protected applyState(): void {\n        // No dynamic state handling needed for the button\n    }\n}\n"],"mappings":"yEAAA,MAKSA,EAAUC,EAAA,cAOZ,MAAMC,UAAqBF,EACvBG,OAAOC,EAA2BC,EAAsBC,EAAoB,OAAQC,EAAwBC,GAC/GC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAChB,MAAMO,EAAUN,EAAYO,WAAW,KAAOP,EAAYQ,UAAU,GAAKR,EAEzE,MAAMS,EAAiB,CACnBC,KAAM,SACNC,MAAOZ,EAAMa,IAAIC,OAASP,EAC1BQ,WAAYf,EAAMe,YAAc,CAAC,GAGrC,GAAIf,EAAMgB,SAAU,CAChBN,EAAUM,SAAWhB,EAAMgB,QAC/B,CAEAX,KAAKY,QAAU,IAAIC,EAAO,CACtBC,GAAId,KAAKe,iBAAiBjB,EAAeF,GACzCoB,MAAOhB,KAAKiB,WAAa,eAAiB,eAC1CC,MAAOlB,KAAKiB,WAAa,qBAAuB,kBAChDE,MAAQC,IACJ,MAAMC,EAAMD,EAAOE,YACnB,MAAMC,EAAcF,EAAIG,SAAS3B,GACjC,IAAK0B,EAAa,OAElB,MAAME,EAAiBJ,EAAIK,kBAAkB7B,GAC7C,IAAI8B,EAAa/B,EACjB,GAAI6B,IAAmB7B,EAAYO,WAAW,KAAM,CAChD,MAAMyB,EAAUH,EAAeI,UAC/BF,EAAaC,EAAQE,SAAS,KAAOF,EAAUhC,EAAegC,IAAY,IAAM,IAAMhC,EAAcgC,EAAU,IAAMhC,CACxH,CAEA,MAAMmC,EAAaR,EAAYS,YAAYL,IAAe,CAAC,EAE3DM,IAAIzB,GAAG0B,QAAQ,CAAC,0DAA4DC,IACxE,MAAMC,EAAO,IAAID,EAAc,CAC3BE,iBAAkBhC,EAClBiC,KAAMP,EACNQ,SAAUvC,KAAKiB,aAGnB,KAAMjB,KAAKiB,WAAY,CACnBmB,EAAKI,aAAcC,IACf,MAAMC,EAAUD,EAAEE,aAAa,WAC/BpB,EAAYqB,YAAYjB,EAAYe,IAE5C,CAEA,MAAMG,EAAalD,EAAMa,IAAIsC,oBAAsB9C,KAAKiB,WAAa,QAAU,MAC/EmB,EAAKW,aAAa,mBAAmBpD,EAAMa,IAAIC,OAASP,IAAW2C,QAK/E,OAAO7C,KAAKY,OAChB,CAEOoC,WACH,MAAO,CAAEC,QAAS,KACtB,CAEUC,WACN,OAAO,IACX,CAEUC,aACN,EAEP,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAA3D,eAAA,OAAA2D,CAAA","ignoreList":[]}
+{"version":3,"file":"ObjectPlugin.js","names":["BasePlugin","___BasePlugin","ObjectPlugin","render","field","bindingPath","modelName","engineScopeId","onChange","this","metadata","propKey","startsWith","substring","subSchema","type","title","ui","label","properties","uiLayout","control","Button","id","generateStableId","text","isEditable","icon","press","oEvent","btn","getSource","parentModel","getModel","bindingContext","getBindingContext","updatePath","ctxPath","getPath","endsWith","nestedData","getProperty","sap","require","GeneratorHost","host","schemaDefinition","data","editable","attachSubmit","e","payload","getParameter","setProperty","buttonText","dialogButtonText","openInDialog","validate","isValid","getValue","applyState","__exports","__esModule"],"sources":["ObjectPlugin.ts"],"sourcesContent":["/**\n * @file ObjectPlugin.ts\n * @description Renders a button that opens a dialog to edit a nested object structure.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPluginValidationResult } from \"../../interfaces/IPlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport Button from \"sap/m/Button\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\n\nexport class ObjectPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.Button` to open a nested Object form dialog.\n     * \n     * @param field The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured Button control.\n     */\n    public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = field;\n        const propKey = bindingPath.startsWith(\"/\") ? bindingPath.substring(1) : bindingPath;\n        \n        const subSchema: any = {\n            type: \"object\",\n            title: field.ui?.label || propKey,\n            properties: field.properties || {}\n        };\n        \n        if (field.uiLayout) {\n            subSchema.uiLayout = field.uiLayout;\n        }\n\n        this.control = new Button({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: !this.isEditable ? \"View Details\" : \"Edit Details\",\n            icon: !this.isEditable ? \"sap-icon://display\" : \"sap-icon://form\",\n            press: (oEvent: sap.ui.base.Event) => {\n                const btn = oEvent.getSource() as Button;\n                const parentModel = btn.getModel(modelName) as JSONModel;\n                if (!parentModel) return;\n                \n                const bindingContext = btn.getBindingContext(modelName);\n                let updatePath = bindingPath;\n                if (bindingContext && !bindingPath.startsWith(\"/\")) {\n                    const ctxPath = bindingContext.getPath();\n                    updatePath = ctxPath.endsWith(\"/\") ? ctxPath + bindingPath : (ctxPath === \"/\" ? \"/\" + bindingPath : ctxPath + \"/\" + bindingPath);\n                }\n                \n                const nestedData = parentModel.getProperty(updatePath) || {};\n\n                sap.ui.require([\"nz/co/siliconst/ui5/metaui/controls/host/GeneratorHost\"], (GeneratorHost: any) => {\n                    const host = new GeneratorHost({\n                        schemaDefinition: subSchema,\n                        data: nestedData,\n                        editable: this.isEditable\n                    });\n\n                    if (!!this.isEditable) {\n                        host.attachSubmit((e: any) => {\n                            const payload = e.getParameter(\"payload\");\n                            parentModel.setProperty(updatePath, payload);\n                        });\n                    }\n\n                    const buttonText = field.ui?.dialogButtonText || (!this.isEditable ? \"Close\" : \"OK\");\n                    host.openInDialog(`Nested Details: ${field.ui?.label || propKey}`, buttonText);\n                });\n            }\n        });\n\n        return this.control as Control;\n    }\n\n    /**\n     * Validates the object plugin (always true as validation is deferred to the dialog host).\n     * @returns {IPluginValidationResult} The validation result.\n     */\n    public validate(): IPluginValidationResult {\n        return { isValid: true };\n    }\n\n    /**\n     * Read-only component for the engine, returns null.\n     */\n    protected getValue(): any {\n        return null;\n    }\n\n    /**\n     * Read-only component, no dynamic state handling needed for the button itself.\n     */\n    protected applyState(): void {\n        // No dynamic state handling needed for the button\n    }\n}\n"],"mappings":"yEAAA,MAKSA,EAAUC,EAAA,cAOZ,MAAMC,UAAqBF,EAWvBG,OAAOC,EAA2BC,EAAsBC,EAAoB,OAAQC,EAAwBC,GAC/GC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAChB,MAAMO,EAAUN,EAAYO,WAAW,KAAOP,EAAYQ,UAAU,GAAKR,EAEzE,MAAMS,EAAiB,CACnBC,KAAM,SACNC,MAAOZ,EAAMa,IAAIC,OAASP,EAC1BQ,WAAYf,EAAMe,YAAc,CAAC,GAGrC,GAAIf,EAAMgB,SAAU,CAChBN,EAAUM,SAAWhB,EAAMgB,QAC/B,CAEAX,KAAKY,QAAU,IAAIC,EAAO,CACtBC,GAAId,KAAKe,iBAAiBjB,EAAeF,GACzCoB,MAAOhB,KAAKiB,WAAa,eAAiB,eAC1CC,MAAOlB,KAAKiB,WAAa,qBAAuB,kBAChDE,MAAQC,IACJ,MAAMC,EAAMD,EAAOE,YACnB,MAAMC,EAAcF,EAAIG,SAAS3B,GACjC,IAAK0B,EAAa,OAElB,MAAME,EAAiBJ,EAAIK,kBAAkB7B,GAC7C,IAAI8B,EAAa/B,EACjB,GAAI6B,IAAmB7B,EAAYO,WAAW,KAAM,CAChD,MAAMyB,EAAUH,EAAeI,UAC/BF,EAAaC,EAAQE,SAAS,KAAOF,EAAUhC,EAAegC,IAAY,IAAM,IAAMhC,EAAcgC,EAAU,IAAMhC,CACxH,CAEA,MAAMmC,EAAaR,EAAYS,YAAYL,IAAe,CAAC,EAE3DM,IAAIzB,GAAG0B,QAAQ,CAAC,0DAA4DC,IACxE,MAAMC,EAAO,IAAID,EAAc,CAC3BE,iBAAkBhC,EAClBiC,KAAMP,EACNQ,SAAUvC,KAAKiB,aAGnB,KAAMjB,KAAKiB,WAAY,CACnBmB,EAAKI,aAAcC,IACf,MAAMC,EAAUD,EAAEE,aAAa,WAC/BpB,EAAYqB,YAAYjB,EAAYe,IAE5C,CAEA,MAAMG,EAAalD,EAAMa,IAAIsC,oBAAsB9C,KAAKiB,WAAa,QAAU,MAC/EmB,EAAKW,aAAa,mBAAmBpD,EAAMa,IAAIC,OAASP,IAAW2C,QAK/E,OAAO7C,KAAKY,OAChB,CAMOoC,WACH,MAAO,CAAEC,QAAS,KACtB,CAKUC,WACN,OAAO,IACX,CAKUC,aACN,EAEP,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAA3D,eAAA,OAAA2D,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin.ts

@@ -11,6 +11,16 @@ import Button from "sap/m/Button";
 import JSONModel from "sap/ui/model/json/JSONModel";
 
 export class ObjectPlugin extends BasePlugin {
+    /**
+     * Renders a `sap.m.Button` to open a nested Object form dialog.
+     * 
+     * @param field The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured Button control.
+     */
     public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = "meta", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {
         this.onChange = onChange;
         this.metadata = field;
@@ -67,14 +77,24 @@ export class ObjectPlugin extends BasePlugin {
         return this.control as Control;
     }
 
+    /**
+     * Validates the object plugin (always true as validation is deferred to the dialog host).
+     * @returns {IPluginValidationResult} The validation result.
+     */
     public validate(): IPluginValidationResult {
         return { isValid: true };
     }
 
+    /**
+     * Read-only component for the engine, returns null.
+     */
     protected getValue(): any {
         return null;
     }
 
+    /**
+     * Read-only component, no dynamic state handling needed for the button itself.
+     */
     protected applyState(): void {
         // No dynamic state handling needed for the button
     }