@siliconst/metaui 1.4.9 → 1.4.13

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

@@ -1 +1 @@
-{"version":3,"file":"DynamicHost.js","names":["GeneratorHost","_interopRequireDefault","__GeneratorHost","Logger","___utils_Logger","ODataDelegate","___host_delegates_ODataDelegate","DynamicHost","Control","extend","constructor","prototype","apply","this","arguments","_innerHost","odataDelegate","_initializedInner","renderer","apiVersion","render","rm","control","openStart","style","openEnd","content","getAggregation","renderControl","close","metadata","properties","schemaDefinition","type","defaultValue","data","bindable","dataJson","liveUpdate","isValid","useMessageManager","modelName","debugMode","editable","aggregations","_content","multiple","visibility","events","beforeSubmit","parameters","payload","addError","preventDefault","submit","payloadJson","cancel","fieldChange","fieldPath","value","validationStateChanged","validationError","message","validationSuccess","initODataDelegate","_initODataDelegate","oContext","getBindingContext","debug","getPath","requestObject","syncToEngine","Object","keys","setBindingContext","_setBindingContext","sModelName","Control.prototype.setBindingContext.call","bindElement","_bindElement","vPath","mParameters","Control.prototype.bindElement.call","model","undefined","oBinding","getElementBinding","attachChange","onBeforeRendering","_onBeforeRendering","schema","getProperty","hasSchema","hasData","props","getMetadata","getProperties","propName","val","Control.prototype.getProperty.call","setProperty","setAggregation","getEvents","eventName","attachEvent","oEvent","params","getParameters","Control.prototype.setProperty.call","str","JSON","stringify","handleFieldChange","fireEvent","_setProperty","propertyName","suppressInvalidate","openInDialog","_openInDialog","title","submitButtonText","cancelButtonText","triggerSubmit","_triggerSubmit","_getProperty"],"sources":["DynamicHost.ts"],"sourcesContent":["import Control from \"sap/ui/core/Control\";\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport GeneratorHost from \"./host/GeneratorHost\";\nimport { Logger } from \"../utils/Logger\";\nimport { ODataDelegate } from \"./host/delegates/ODataDelegate\";\nimport ODataV4Context from \"sap/ui/model/odata/v4/Context\";\n\n/**\n * A transparent wrapper control (Facade) that automatically chooses between Explicit Schema Mode \n * and Inference Mode based on the presence of a 'schemaDefinition'.\n * \n * This maintains total architectural separation of the modes without forcing developers to \n * use different XML tags.\n * \n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nexport default class DynamicHost extends Control {\n    private _innerHost: GeneratorHost | null = null;\n    private odataDelegate: ODataDelegate | null = null;\n    private _initializedInner: boolean = false;\n\n    static readonly metadata = {\n        properties: {\n            schemaDefinition: { type: \"any\", defaultValue: null },\n            data: { type: \"object\", defaultValue: null, bindable: \"bindable\" },\n            dataJson: { type: \"string\", defaultValue: null, bindable: \"bindable\" },\n            liveUpdate: { type: \"boolean\", defaultValue: false },\n            isValid: { type: \"boolean\", defaultValue: true },\n            useMessageManager: { type: \"boolean\", defaultValue: false },\n            modelName: { type: \"string\", defaultValue: \"meta\" },\n            debugMode: { type: \"boolean\", defaultValue: false },\n            editable: { type: \"boolean\", defaultValue: true }\n        },\n        aggregations: {\n            _content: { type: \"sap.ui.core.Control\", multiple: false, visibility: \"hidden\" }\n        },\n        events: {\n            beforeSubmit: {\n                parameters: {\n                    payload: { type: \"object\" },\n                    addError: { type: \"function\" },\n                    preventDefault: { type: \"function\" }\n                }\n            },\n            submit: {\n                parameters: {\n                    payload: { type: \"object\" },\n                    payloadJson: { type: \"string\" }\n                }\n            },\n            cancel: {},\n            fieldChange: {\n                parameters: {\n                    fieldPath: { type: \"string\" },\n                    value: { type: \"any\" },\n                    payload: { type: \"object\" },\n                    isValid: { type: \"boolean\" }\n                }\n            },\n            validationStateChanged: { parameters: { isValid: { type: \"boolean\" } } },\n            validationError: { parameters: { fieldPath: { type: \"string\" }, message: { type: \"string\" } } },\n            validationSuccess: { parameters: { fieldPath: { type: \"string\" } } }\n        }\n    };\n\n    static renderer = {\n        apiVersion: 2,\n        render(rm: RenderManager, control: DynamicHost) {\n            rm.openStart(\"div\", control);\n            rm.style(\"width\", \"100%\");\n            rm.style(\"height\", \"100%\");\n            rm.openEnd();\n\n            const content = control.getAggregation(\"_content\") as Control;\n            if (content) {\n                rm.renderControl(content);\n            }\n\n            rm.close(\"div\");\n        }\n    };\n\n    /**\n     * Internal reference to the generated inner host instance.\n     * @private\n     */\n    private _innerHost: GeneratorHost | null = null;\n    \n    /**\n     * Flag indicating if the inner host has been initialized.\n     * @private\n     */\n    private _initializedInner: boolean = false;\n\n    /**\n     * Initializes the OData Delegate if an OData context is detected.\n     * This allows DynamicHost to seamlessly synchronize metadata and properties from an OData model.\n     * @private\n     */\n    private initODataDelegate(): void {\n        if (!this.odataDelegate) {\n            const oContext = this.getBindingContext(\"odata\") || this.getBindingContext();\n            if (oContext) {\n                Logger.debug(\"[MetaUI DynamicHost]\", `Context found for delegate initialization: ${oContext.getPath()}`, \"DynamicHost\");\n                if (oContext && (oContext as ODataV4Context).requestObject && typeof (oContext as ODataV4Context).requestObject === \"function\") {\n                    Logger.debug(\"[MetaUI DynamicHost]\", `Context supports requestObject/getObject. Instantiating ODataDelegate.`, \"DynamicHost\");\n                    this.odataDelegate = new ODataDelegate(this, oContext as ODataV4Context);\n                    this.odataDelegate.syncToEngine();\n                } else {\n                    Logger.debug(\"[MetaUI DynamicHost]\", `Context does NOT support requestObject/getObject! Keys: ${Object.keys(oContext)}`, \"DynamicHost\");\n                }\n            }\n        }\n    }\n\n    /**\n     * Standard UI5 method override.\n     * Sets the binding context for the control and attempts to initialize the OData delegate\n     * if the context points to an OData model.\n     * \n     * @param {sap.ui.model.Context | null | undefined} oContext The binding context object\n     * @param {string} [sModelName] Optional model name\n     * @returns {this} The control instance for chaining\n     */\n    public setBindingContext(oContext: sap.ui.model.Context | null | undefined, sModelName?: string): this {\n        super.setBindingContext(oContext, sModelName);\n        this.initODataDelegate();\n        return this;\n    }\n\n    /**\n     * Standard UI5 method override.\n     * Binds the element to the given path and attaches a change listener to re-evaluate\n     * the OData delegate when the element binding resolves.\n     * \n     * @param {string | Record<string, unknown>} vPath The binding path or configuration object\n     * @param {object} [mParameters] Optional mapping parameters\n     * @returns {this} Reference to this instance for chaining\n     */\n    public bindElement(vPath: string | Record<string, unknown>, mParameters?: object): this {\n        super.bindElement(vPath, mParameters);\n        const sModelName = typeof vPath === \"object\" ? vPath.model : undefined;\n        const oBinding = this.getElementBinding(sModelName);\n        if (oBinding) {\n            oBinding.attachChange(() => {\n                this.initODataDelegate();\n            });\n        }\n        return this;\n    }\n\n    /**\n     * Standard UI5 Lifecycle Hook.\n     * Evaluates the initial properties and spawns the GeneratorHost.\n     * It handles the complex lifecycle task of copying all bindings, raw properties, and event listeners \n     * down to the inner host perfectly transparently.\n     */\n    public onBeforeRendering(): void {\n        Logger.debug(\"[MetaUI DynamicHost]\", `onBeforeRendering called. _initializedInner: ${this._initializedInner}`, \"DynamicHost\");\n\n        this.initODataDelegate();\n\n        if (!this._initializedInner) {\n            const schema = this.getProperty(\"schemaDefinition\");\n            const dataJson = this.getProperty(\"dataJson\");\n            const data = this.getProperty(\"data\");\n\n            const hasSchema = !!schema;\n            const hasData = !!dataJson || !!data;\n\n            Logger.debug(\"[MetaUI DynamicHost]\", `Evaluating boot. hasSchema: ${hasSchema}, hasData: ${hasData}`, \"DynamicHost\");\n\n            // Only boot if we have either a schema or some data to infer from\n            if (hasSchema || hasData) {\n                if (this.getProperty(\"debugMode\")) {\n                    Logger.debug(\"[MetaUI DynamicHost]\", `Booting inner host. hasSchema: ${hasSchema}, hasData: ${hasData}`, \"DynamicHost\");\n                }\n                // The architectural Facade router logic:\n                // We've simplified this! We no longer use HostFactory or separate subclasses.\n                // GeneratorHost is fully capable of inferring the schema if none is provided.\n                this._innerHost = new GeneratorHost();\n\n                // 1. Forward all static values to the spawned host BEFORE mounting.\n                // Since we no longer use bindProperty, it's perfectly safe to set raw properties before mounting.\n                const props = this.getMetadata().getProperties();\n                for (const propName in props) {\n                    const val = super.getProperty(propName);\n                    if (val !== null && val !== undefined) {\n                        this._innerHost.setProperty(propName, val);\n                    }\n                }\n\n                // 2. Mount so it inherits models and triggers lifecycle.\n                this.setAggregation(\"_content\", this._innerHost);\n\n                // 3. Forward all event subscriptions.\n                // By proxying the events upwards, the developer can subscribe to `<meta:DynamicHost submit=\"...\">` \n                // and perfectly receive the inner host's submission event.\n                const events = this.getMetadata().getEvents();\n                for (const eventName in events) {\n                    this._innerHost.attachEvent(eventName, (oEvent: sap.ui.base.Event) => {\n                        // Natively push updated payload out to any bound Fiori Element properties.\n                        // Using super.setProperty prevents an infinite loop back down to _innerHost.\n                        if (eventName === \"submit\" || eventName === \"fieldChange\") {\n                            const params = oEvent.getParameters();\n                            if (params.payload) {\n                                super.setProperty(\"data\", params.payload, true);\n\n                                const str = params.payloadJson || JSON.stringify(params.payload, null, 2);\n                                super.setProperty(\"dataJson\", str, true);\n                            }\n                            if (eventName === \"fieldChange\" && this.odataDelegate) {\n                                this.odataDelegate.handleFieldChange(params.fieldPath, params.value);\n                            }\n                        }\n                        this.fireEvent(eventName, oEvent.getParameters());\n                    });\n                }\n\n                this._initializedInner = true;\n            }\n        }\n    }\n\n    /**\n     * Overrides standard UI5 setProperty to act as a transparent proxy.\n     * When a property is updated on the wrapper (either programmatically or via a binding update),\n     * it instantly mirrors that value down to the inner instantiated host.\n     */\n    public setProperty(propertyName: string, value: unknown, suppressInvalidate?: boolean): this {\n        if (propertyName === \"data\" || propertyName === \"dataJson\" || propertyName === \"schemaDefinition\") {\n            if (this.getProperty(\"debugMode\")) {\n                Logger.debug(\"[MetaUI DynamicHost]\", `Wrapper received setProperty: ${propertyName}`, \"DynamicHost\");\n            }\n        }\n        super.setProperty(propertyName, value, suppressInvalidate);\n        if (this._innerHost) {\n            this._innerHost.setProperty(propertyName, value, suppressInvalidate);\n        } else if (propertyName === \"data\" || propertyName === \"dataJson\" || propertyName === \"schemaDefinition\") {\n            if (this.getProperty(\"debugMode\")) {\n                Logger.debug(\"[MetaUI DynamicHost]\", `_innerHost not yet initialized when ${propertyName} was set. Booting will happen on next render.`, \"DynamicHost\");\n            }\n        }\n        return this;\n    }\n\n\n\n\n\n    /**\n     * Programmatic API support. Routes dialog commands down to the spawned inner host.\n     * If the inner host has not booted yet, it forces initialization immediately.\n     * \n     * @param {string} [title=\"Form\"] The title of the dialog\n     * @param {string} [submitButtonText=\"OK\"] The text for the primary action button\n     * @param {string} [cancelButtonText=\"Cancel\"] The text for the cancel button\n     */\n    public openInDialog(title?: string, submitButtonText?: string, cancelButtonText?: string): void {\n        if (!this._innerHost) {\n            this.onBeforeRendering(); // Force init if they bypassed UI5 rendering\n        }\n        this._innerHost?.openInDialog(title, submitButtonText, cancelButtonText);\n    }\n\n    /**\n     * Proxies submission triggering down to the instantiated generator host.\n     * Evaluates the internal Engine validation suite and returns true if structurally sound.\n     * \n     * @returns {boolean} True if the internal payload passes schema validation, false otherwise.\n     */\n    public triggerSubmit(): boolean {\n        if (!this._innerHost) {\n            return false;\n        }\n        return this._innerHost.triggerSubmit();\n    }\n\n    /**\n     * Overrides standard UI5 getProperty to transparently pull extracted data from the inner host.\n     * Ensures that querying the DynamicHost facade for `data` always yields the freshest payload.\n     * \n     * @param {string} propertyName The name of the property to retrieve\n     * @returns {unknown} The property value\n     */\n    public getProperty(propertyName: string): unknown {\n        if (propertyName === \"outputData\") {\n            propertyName = \"data\"; // Forward deprecated outputData to data\n        }\n        if (this._innerHost && (propertyName === \"data\" || propertyName === \"dataJson\")) {\n            return this._innerHost.getProperty(propertyName);\n        }\n        return super.getProperty(propertyName);\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"DynamicHost.js","names":["GeneratorHost","_interopRequireDefault","__GeneratorHost","Logger","___utils_Logger","ODataDelegate","___host_delegates_ODataDelegate","DynamicHost","Control","extend","constructor","prototype","apply","this","arguments","odataDelegate","_innerHost","_initializedInner","renderer","apiVersion","render","rm","control","openStart","style","openEnd","content","getAggregation","renderControl","close","metadata","properties","schemaDefinition","type","defaultValue","data","bindable","dataJson","liveUpdate","isValid","useMessageManager","modelName","debugMode","editable","aggregations","_content","multiple","visibility","events","beforeSubmit","parameters","payload","addError","preventDefault","submit","payloadJson","cancel","fieldChange","fieldPath","value","validationStateChanged","validationError","message","validationSuccess","error","exception","initODataDelegate","_initODataDelegate","getBindingInfo","dataBinding","path","oContext","getBindingContext","debug","getPath","requestObject","syncToEngine","Object","keys","setBindingContext","_setBindingContext","sModelName","Control.prototype.setBindingContext.call","bindElement","_bindElement","vPath","mParameters","Control.prototype.bindElement.call","model","undefined","oBinding","getElementBinding","attachChange","onBeforeRendering","_onBeforeRendering","schema","getProperty","hasSchema","length","hasData","props","getMetadata","getProperties","propName","val","Control.prototype.getProperty.call","setProperty","setAggregation","getEvents","eventName","attachEvent","oEvent","params","getParameters","isLive","Control.prototype.setProperty.call","str","JSON","stringify","handleFieldChange","fireEvent","_setProperty","propertyName","suppressInvalidate","openInDialog","_openInDialog","title","submitButtonText","cancelButtonText","dialogWidth","parentView","triggerSubmit","_triggerSubmit","addCustomError","_addCustomError","clearCustomError","_clearCustomError","_getProperty"],"sources":["DynamicHost.ts"],"sourcesContent":["import Control from \"sap/ui/core/Control\";\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport GeneratorHost from \"./host/GeneratorHost\";\nimport { Logger } from \"../utils/Logger\";\nimport { ODataDelegate } from \"./host/delegates/ODataDelegate\";\nimport ODataV4Context from \"sap/ui/model/odata/v4/Context\";\n\n/**\n * A transparent wrapper control (Facade) that automatically chooses between Explicit Schema Mode \n * and Inference Mode based on the presence of a 'schemaDefinition'.\n * \n * This maintains total architectural separation of the modes without forcing developers to \n * use different XML tags.\n * \n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nexport default class DynamicHost extends Control {\n    private odataDelegate: ODataDelegate | null = null;\n\n    static readonly metadata = {\n        properties: {\n            schemaDefinition: { type: \"any\", defaultValue: null },\n            data: { type: \"object\", defaultValue: null, bindable: \"bindable\" },\n            dataJson: { type: \"string\", defaultValue: null, bindable: \"bindable\" },\n            liveUpdate: { type: \"boolean\", defaultValue: false },\n            isValid: { type: \"boolean\", defaultValue: true },\n            useMessageManager: { type: \"boolean\", defaultValue: false },\n            modelName: { type: \"string\", defaultValue: \"meta\" },\n            debugMode: { type: \"boolean\", defaultValue: false },\n            editable: { type: \"boolean\", defaultValue: true }\n        },\n        aggregations: {\n            _content: { type: \"sap.ui.core.Control\", multiple: false, visibility: \"hidden\" }\n        },\n        events: {\n            beforeSubmit: {\n                parameters: {\n                    payload: { type: \"object\" },\n                    addError: { type: \"function\" },\n                    preventDefault: { type: \"function\" }\n                }\n            },\n            submit: {\n                parameters: {\n                    payload: { type: \"object\" },\n                    payloadJson: { type: \"string\" }\n                }\n            },\n            cancel: {},\n            fieldChange: {\n                parameters: {\n                    fieldPath: { type: \"string\" },\n                    value: { type: \"any\" },\n                    payload: { type: \"object\" },\n                    isValid: { type: \"boolean\" }\n                }\n            },\n            validationStateChanged: { parameters: { isValid: { type: \"boolean\" } } },\n            validationError: { parameters: { fieldPath: { type: \"string\" }, message: { type: \"string\" } } },\n            validationSuccess: { parameters: { fieldPath: { type: \"string\" } } },\n            error: { parameters: { message: { type: \"string\" }, exception: { type: \"object\" } } }\n        }\n    };\n\n    static renderer = {\n        apiVersion: 2,\n        render(rm: RenderManager, control: DynamicHost) {\n            rm.openStart(\"div\", control);\n            rm.style(\"width\", \"100%\");\n            rm.style(\"height\", \"100%\");\n            rm.openEnd();\n\n            const content = control.getAggregation(\"_content\") as Control;\n            if (content) {\n                rm.renderControl(content);\n            }\n\n            rm.close(\"div\");\n        }\n    };\n\n    /**\n     * Internal reference to the generated inner host instance.\n     * @private\n     */\n    private _innerHost: GeneratorHost | null = null;\n    \n    /**\n     * Flag indicating if the inner host has been initialized.\n     * @private\n     */\n    private _initializedInner: boolean = false;\n\n    /**\n     * Initializes the OData Delegate if an OData context is detected.\n     * This allows DynamicHost to seamlessly synchronize metadata and properties from an OData model.\n     * @private\n     */\n    private initODataDelegate(): void {\n        if (!this.odataDelegate) {\n            // Guard: If the user explicitly bound dataJson, do not steal the context.\n            if (this.getBindingInfo(\"dataJson\")) {\n                return;\n            }\n\n            // Guard: If the user explicitly bound 'data' to a specific property path, do not steal the context.\n            const dataBinding = this.getBindingInfo(\"data\") as any;\n            if (dataBinding && dataBinding.path && dataBinding.path !== \"\") {\n                return;\n            }\n\n            const oContext = this.getBindingContext(\"odata\") || this.getBindingContext();\n            if (oContext) {\n                Logger.debug(\"[MetaUI DynamicHost]\", `Context found for delegate initialization: ${oContext.getPath()}`, \"DynamicHost\");\n                if (oContext && (oContext as ODataV4Context).requestObject && typeof (oContext as ODataV4Context).requestObject === \"function\") {\n                    Logger.debug(\"[MetaUI DynamicHost]\", `Context supports requestObject/getObject. Instantiating ODataDelegate.`, \"DynamicHost\");\n                    this.odataDelegate = new ODataDelegate(this, oContext as ODataV4Context);\n                    this.odataDelegate.syncToEngine();\n                } else {\n                    Logger.debug(\"[MetaUI DynamicHost]\", `Context does NOT support requestObject/getObject! Keys: ${Object.keys(oContext)}`, \"DynamicHost\");\n                }\n            }\n        }\n    }\n\n    /**\n     * Standard UI5 method override.\n     * Sets the binding context for the control and attempts to initialize the OData delegate\n     * if the context points to an OData model.\n     * \n     * @param {sap.ui.model.Context | null | undefined} oContext The binding context object\n     * @param {string} [sModelName] Optional model name\n     * @returns {this} The control instance for chaining\n     */\n    public setBindingContext(oContext: sap.ui.model.Context | null | undefined, sModelName?: string): this {\n        super.setBindingContext(oContext, sModelName);\n        this.initODataDelegate();\n        return this;\n    }\n\n    /**\n     * Standard UI5 method override.\n     * Binds the element to the given path and attaches a change listener to re-evaluate\n     * the OData delegate when the element binding resolves.\n     * \n     * @param {string | Record<string, unknown>} vPath The binding path or configuration object\n     * @param {object} [mParameters] Optional mapping parameters\n     * @returns {this} Reference to this instance for chaining\n     */\n    public bindElement(vPath: string | Record<string, unknown>, mParameters?: object): this {\n        super.bindElement(vPath, mParameters);\n        const sModelName = typeof vPath === \"object\" ? vPath.model : undefined;\n        const oBinding = this.getElementBinding(sModelName);\n        if (oBinding) {\n            oBinding.attachChange(() => {\n                this.initODataDelegate();\n            });\n        }\n        return this;\n    }\n\n    /**\n     * Standard UI5 Lifecycle Hook.\n     * Evaluates the initial properties and spawns the GeneratorHost.\n     * It handles the complex lifecycle task of copying all bindings, raw properties, and event listeners \n     * down to the inner host perfectly transparently.\n     */\n    public onBeforeRendering(): void {\n        Logger.debug(\"[MetaUI DynamicHost]\", `onBeforeRendering called. _initializedInner: ${this._initializedInner}`, \"DynamicHost\");\n\n        this.initODataDelegate();\n\n        if (!this._initializedInner) {\n            const schema = this.getProperty(\"schemaDefinition\");\n            const dataJson = this.getProperty(\"dataJson\");\n            const data = this.getProperty(\"data\");\n\n            let hasSchema = !!schema;\n            if (hasSchema && typeof schema === \"object\" && Object.keys(schema).length === 0) {\n                hasSchema = false; // Treat empty object as no schema\n            }\n            \n            const hasData = !!dataJson || !!data;\n\n            Logger.debug(\"[MetaUI DynamicHost]\", `Evaluating boot. hasSchema: ${hasSchema}, hasData: ${hasData}`, \"DynamicHost\");\n\n            // Only boot if we have either a schema or some data to infer from\n            if (hasSchema || hasData) {\n                if (this.getProperty(\"debugMode\")) {\n                    Logger.debug(\"[MetaUI DynamicHost]\", `Booting inner host. hasSchema: ${hasSchema}, hasData: ${hasData}`, \"DynamicHost\");\n                }\n                // The architectural Facade router logic:\n                // We've simplified this! We no longer use HostFactory or separate subclasses.\n                // GeneratorHost is fully capable of inferring the schema if none is provided.\n                this._innerHost = new GeneratorHost();\n\n                // 1. Forward all static values to the spawned host BEFORE mounting.\n                // Since we no longer use bindProperty, it's perfectly safe to set raw properties before mounting.\n                const props = this.getMetadata().getProperties();\n                for (const propName in props) {\n                    const val = super.getProperty(propName);\n                    if (val !== null && val !== undefined) {\n                        this._innerHost.setProperty(propName, val);\n                    }\n                }\n\n                // 2. Mount so it inherits models and triggers lifecycle.\n                this.setAggregation(\"_content\", this._innerHost);\n\n                // 3. Forward all event subscriptions.\n                // By proxying the events upwards, the developer can subscribe to `<meta:DynamicHost submit=\"...\">` \n                // and perfectly receive the inner host's submission event.\n                const events = this.getMetadata().getEvents();\n                for (const eventName in events) {\n                    this._innerHost.attachEvent(eventName, (oEvent: sap.ui.base.Event) => {\n                        // Natively push updated payload out to any bound Fiori Element properties.\n                        // Using super.setProperty prevents an infinite loop back down to _innerHost.\n                        if (eventName === \"submit\" || eventName === \"fieldChange\") {\n                            const params = oEvent.getParameters();\n                            if (params.payload) {\n                                const isLive = this.getProperty(\"liveUpdate\") === true;\n                                if (eventName === \"submit\" || isLive) {\n                                    super.setProperty(\"data\", params.payload, true);\n\n                                    const str = params.payloadJson || JSON.stringify(params.payload, null, 2);\n                                    super.setProperty(\"dataJson\", str, true);\n                                }\n                            }\n                            if (eventName === \"fieldChange\" && this.odataDelegate) {\n                                this.odataDelegate.handleFieldChange(params.fieldPath, params.value);\n                            }\n                        }\n                        this.fireEvent(eventName, oEvent.getParameters());\n                    });\n                }\n\n                this._initializedInner = true;\n            }\n        }\n    }\n\n    /**\n     * Overrides standard UI5 setProperty to act as a transparent proxy.\n     * When a property is updated on the wrapper (either programmatically or via a binding update),\n     * it instantly mirrors that value down to the inner instantiated host.\n     */\n    public setProperty(propertyName: string, value: unknown, suppressInvalidate?: boolean): this {\n        if (propertyName === \"data\" || propertyName === \"dataJson\" || propertyName === \"schemaDefinition\") {\n            if (this.getProperty(\"debugMode\")) {\n                Logger.debug(\"[MetaUI DynamicHost]\", `Wrapper received setProperty: ${propertyName}`, \"DynamicHost\");\n            }\n        }\n        super.setProperty(propertyName, value, suppressInvalidate);\n        if (this._innerHost) {\n            this._innerHost.setProperty(propertyName, value, suppressInvalidate);\n        } else if (propertyName === \"data\" || propertyName === \"dataJson\" || propertyName === \"schemaDefinition\") {\n            if (this.getProperty(\"debugMode\")) {\n                Logger.debug(\"[MetaUI DynamicHost]\", `_innerHost not yet initialized when ${propertyName} was set. Booting will happen on next render.`, \"DynamicHost\");\n            }\n        }\n        return this;\n    }\n\n\n\n\n\n    /**\n     * Programmatic API support. Routes dialog commands down to the spawned inner host.\n     * If the inner host has not booted yet, it forces initialization immediately.\n     * \n     * @param {string} [title=\"Form\"] The title of the dialog\n     * @param {string} [submitButtonText=\"OK\"] The text for the primary action button\n     * @param {string} [cancelButtonText=\"Cancel\"] The text for the cancel button\n     * @param {string} [dialogWidth=\"800px\"] The width of the dialog\n     * @param {sap.ui.core.Control} [parentView] The parent view to attach the dialog to for model inheritance.\n     */\n    public openInDialog(title?: string, submitButtonText?: string, cancelButtonText?: string, dialogWidth?: string, parentView?: Control): void {\n        if (!this._innerHost) {\n            this.onBeforeRendering(); // Force init if they bypassed UI5 rendering\n        }\n        this._innerHost?.openInDialog(title, submitButtonText, cancelButtonText, dialogWidth, parentView);\n    }\n\n    /**\n     * Proxies submission triggering down to the instantiated generator host.\n     * Evaluates the internal Engine validation suite and returns true if structurally sound.\n     * \n     * @returns {boolean} True if the internal payload passes schema validation, false otherwise.\n     */\n    public triggerSubmit(): boolean {\n        if (!this._innerHost) {\n            return false;\n        }\n        return this._innerHost.triggerSubmit();\n    }\n\n    /**\n     * Injects a custom error message onto a specific field.\n     * Useful for injecting custom backend validation errors.\n     * \n     * @param {string} fieldPath The schema key path to target.\n     * @param {string} message The custom error message to display.\n     */\n    public addCustomError(fieldPath: string, message: string): void {\n        if (this._innerHost && typeof (this._innerHost as any).addCustomError === \"function\") {\n            (this._innerHost as any).addCustomError(fieldPath, message);\n        }\n    }\n\n    /**\n     * Clears a custom error message from a specific field.\n     * \n     * @param {string} fieldPath The schema key path to target.\n     */\n    public clearCustomError(fieldPath: string): void {\n        if (this._innerHost && typeof (this._innerHost as any).clearCustomError === \"function\") {\n            (this._innerHost as any).clearCustomError(fieldPath);\n        }\n    }\n\n    /**\n     * Overrides standard UI5 getProperty to transparently pull extracted data from the inner host.\n     * Ensures that querying the DynamicHost facade for `data` always yields the freshest payload.\n     * \n     * @param {string} propertyName The name of the property to retrieve\n     * @returns {unknown} The property value\n     */\n    public getProperty(propertyName: string): unknown {\n        if (propertyName === \"outputData\") {\n            propertyName = \"data\"; // Forward deprecated outputData to data\n        }\n        if (this._innerHost && (propertyName === \"data\" || propertyName === \"dataJson\")) {\n            return this._innerHost.getProperty(propertyName);\n        }\n        return super.getProperty(propertyName);\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/DynamicHost.ts

@@ -15,9 +15,7 @@ import ODataV4Context from "sap/ui/model/odata/v4/Context";
  * @namespace nz.co.siliconst.ui5.metaui.controls
  */
 export default class DynamicHost extends Control {
-    private _innerHost: GeneratorHost | null = null;
     private odataDelegate: ODataDelegate | null = null;
-    private _initializedInner: boolean = false;
 
     static readonly metadata = {
         properties: {
@@ -59,7 +57,8 @@ export default class DynamicHost extends Control {
             },
             validationStateChanged: { parameters: { isValid: { type: "boolean" } } },
             validationError: { parameters: { fieldPath: { type: "string" }, message: { type: "string" } } },
-            validationSuccess: { parameters: { fieldPath: { type: "string" } } }
+            validationSuccess: { parameters: { fieldPath: { type: "string" } } },
+            error: { parameters: { message: { type: "string" }, exception: { type: "object" } } }
         }
     };
 
@@ -99,6 +98,17 @@ export default class DynamicHost extends Control {
      */
     private initODataDelegate(): void {
         if (!this.odataDelegate) {
+            // Guard: If the user explicitly bound dataJson, do not steal the context.
+            if (this.getBindingInfo("dataJson")) {
+                return;
+            }
+
+            // Guard: If the user explicitly bound 'data' to a specific property path, do not steal the context.
+            const dataBinding = this.getBindingInfo("data") as any;
+            if (dataBinding && dataBinding.path && dataBinding.path !== "") {
+                return;
+            }
+
             const oContext = this.getBindingContext("odata") || this.getBindingContext();
             if (oContext) {
                 Logger.debug("[MetaUI DynamicHost]", `Context found for delegate initialization: ${oContext.getPath()}`, "DynamicHost");
@@ -165,7 +175,11 @@ export default class DynamicHost extends Control {
             const dataJson = this.getProperty("dataJson");
             const data = this.getProperty("data");
 
-            const hasSchema = !!schema;
+            let hasSchema = !!schema;
+            if (hasSchema && typeof schema === "object" && Object.keys(schema).length === 0) {
+                hasSchema = false; // Treat empty object as no schema
+            }
+            
             const hasData = !!dataJson || !!data;
 
             Logger.debug("[MetaUI DynamicHost]", `Evaluating boot. hasSchema: ${hasSchema}, hasData: ${hasData}`, "DynamicHost");
@@ -204,10 +218,13 @@ export default class DynamicHost extends Control {
                         if (eventName === "submit" || eventName === "fieldChange") {
                             const params = oEvent.getParameters();
                             if (params.payload) {
-                                super.setProperty("data", params.payload, true);
+                                const isLive = this.getProperty("liveUpdate") === true;
+                                if (eventName === "submit" || isLive) {
+                                    super.setProperty("data", params.payload, true);
 
-                                const str = params.payloadJson || JSON.stringify(params.payload, null, 2);
-                                super.setProperty("dataJson", str, true);
+                                    const str = params.payloadJson || JSON.stringify(params.payload, null, 2);
+                                    super.setProperty("dataJson", str, true);
+                                }
                             }
                             if (eventName === "fieldChange" && this.odataDelegate) {
                                 this.odataDelegate.handleFieldChange(params.fieldPath, params.value);
@@ -255,12 +272,14 @@ export default class DynamicHost extends Control {
      * @param {string} [title="Form"] The title of the dialog
      * @param {string} [submitButtonText="OK"] The text for the primary action button
      * @param {string} [cancelButtonText="Cancel"] The text for the cancel button
+     * @param {string} [dialogWidth="800px"] The width of the dialog
+     * @param {sap.ui.core.Control} [parentView] The parent view to attach the dialog to for model inheritance.
      */
-    public openInDialog(title?: string, submitButtonText?: string, cancelButtonText?: string): void {
+    public openInDialog(title?: string, submitButtonText?: string, cancelButtonText?: string, dialogWidth?: string, parentView?: Control): void {
         if (!this._innerHost) {
             this.onBeforeRendering(); // Force init if they bypassed UI5 rendering
         }
-        this._innerHost?.openInDialog(title, submitButtonText, cancelButtonText);
+        this._innerHost?.openInDialog(title, submitButtonText, cancelButtonText, dialogWidth, parentView);
     }
 
     /**
@@ -276,6 +295,30 @@ export default class DynamicHost extends Control {
         return this._innerHost.triggerSubmit();
     }
 
+    /**
+     * Injects a custom error message onto a specific field.
+     * Useful for injecting custom backend validation errors.
+     * 
+     * @param {string} fieldPath The schema key path to target.
+     * @param {string} message The custom error message to display.
+     */
+    public addCustomError(fieldPath: string, message: string): void {
+        if (this._innerHost && typeof (this._innerHost as any).addCustomError === "function") {
+            (this._innerHost as any).addCustomError(fieldPath, message);
+        }
+    }
+
+    /**
+     * Clears a custom error message from a specific field.
+     * 
+     * @param {string} fieldPath The schema key path to target.
+     */
+    public clearCustomError(fieldPath: string): void {
+        if (this._innerHost && typeof (this._innerHost as any).clearCustomError === "function") {
+            (this._innerHost as any).clearCustomError(fieldPath);
+        }
+    }
+
     /**
      * Overrides standard UI5 getProperty to transparently pull extracted data from the inner host.
      * Ensures that querying the DynamicHost facade for `data` always yields the freshest payload.

package/src/nz/co/siliconst/ui5/metaui/controls/host/GeneratorHost-dbg.js

@@ -1,4 +1,4 @@
-sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNormalizer", "../../core/SchemaValidator", "../../core/Engine", "../../core/StateManager", "./delegates/DataSyncDelegate", "./delegates/ValidationDelegate", "./delegates/DialogDelegate", "sap/m/MessageBox", "../../core/PluginRegistry"], function (Control, ____utils_Logger, ____core_SchemaNormalizer, ____core_SchemaValidator, ____core_Engine, ____core_StateManager, ___delegates_DataSyncDelegate, ___delegates_ValidationDelegate, ___delegates_DialogDelegate, MessageBox, ____core_PluginRegistry) {
+sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNormalizer", "../../core/SchemaValidator", "../../core/Engine", "../../core/StateManager", "./delegates/DataSyncDelegate", "./delegates/ValidationDelegate", "./delegates/DialogDelegate", "sap/m/MessageBox", "sap/m/MessageStrip", "sap/m/VBox", "../../core/PluginRegistry"], function (Control, ____utils_Logger, ____core_SchemaNormalizer, ____core_SchemaValidator, ____core_Engine, ____core_StateManager, ___delegates_DataSyncDelegate, ___delegates_ValidationDelegate, ___delegates_DialogDelegate, MessageBox, MessageStrip, VBox, ____core_PluginRegistry) {
   "use strict";
 
   const Logger = ____utils_Logger["Logger"];
@@ -146,6 +146,16 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
               type: "string"
             }
           }
+        },
+        error: {
+          parameters: {
+            message: {
+              type: "string"
+            },
+            exception: {
+              type: "object"
+            }
+          }
         }
       }
     },
@@ -161,10 +171,10 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
       /** Cached schema for intelligent diffing during inference mode hot-swaps */
       this.parsedSchema = null;
       /**
-       * Internal reference to the active debounce timeout.
-       * Prevents sequential redundant layouts from being generated when properties are set rapidly.
+       * Internal reference to the active generate promise.
+       * Prevents concurrent redundant layouts from being generated when properties are set rapidly or DialogDelegate triggers it.
        */
-      this._generateTimeoutId = null;
+      this._generatePromise = null;
     },
     /**
      * Initializes the control and instantiates the composition delegates.
@@ -188,6 +198,16 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
       Logger.setDebugMode(enabled);
       return this;
     },
+    /**
+     * Intercepts property updates to dynamically forward them to active delegates/managers.
+     */
+    setProperty: function _setProperty(propertyName, value, suppressInvalidate) {
+      Control.prototype.setProperty.call(this, propertyName, value, suppressInvalidate);
+      if (propertyName === "useMessageManager" && this.stateManager) {
+        this.stateManager.setUseMessageManager(value === true);
+      }
+      return this;
+    },
     /**
      * Returns the active state manager instance managing the JSON payload.
      */
@@ -270,8 +290,13 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
         const hasData = !!this.getProperty("dataJson") || !!this.getProperty("data");
         if (hasSchema || hasData) {
           this.generate();
-        } else if (this.getProperty("debugMode")) {
-          Logger.debug("[MetaUI]", "GeneratorHost skipped rendering. Neither 'schemaDefinition' nor data was provided.", "GeneratorHost");
+        } else {
+          const msg = "GeneratorHost skipped rendering. Neither 'schemaDefinition' nor 'data' was provided.";
+          Logger.error("[MetaUI]", msg, "GeneratorHost");
+          this.fireEvent("error", {
+            message: msg
+          });
+          throw new Error(msg); // Eradicate silent errors
         }
       }
     },
@@ -284,7 +309,10 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
       if (this.stateManager && this.engine) {
         let isPrevented = false;
         this.validationDelegate.removeAllMessages();
-        const errors = this.engine.validateAll();
+
+        // Only apply local fallback visual states if the global MessageManager is explicitly disabled
+        const applyVisualFallback = this.getProperty("useMessageManager") !== true;
+        const errors = this.engine.validateAll(applyVisualFallback);
         if (errors.length > 0) {
           this.validationDelegate.pushMessage("", "One or more fields failed schema validation. Please review the highlighted fields.");
           for (const err of errors) {
@@ -304,6 +332,12 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
           addError: (propertyPath, errorMessage) => {
             isPrevented = true;
             this.validationDelegate.pushMessage(propertyPath, errorMessage);
+            if (applyVisualFallback && this.engine) {
+              const plugin = this.engine.getPluginByPath(propertyPath);
+              if (plugin && typeof plugin.setVisualValidationState === "function") {
+                plugin.setVisualValidationState(false, errorMessage);
+              }
+            }
           }
         });
         if (isPrevented) {
@@ -323,12 +357,25 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
      */
     addCustomError: function _addCustomError(fieldPath, message) {
       this.validationDelegate.addCustomError(fieldPath, message);
+      if (this.getProperty("useMessageManager") !== true && this.engine) {
+        const plugin = this.engine.getPluginByPath(fieldPath);
+        if (plugin && typeof plugin.setVisualValidationState === "function") {
+          plugin.setVisualValidationState(false, message);
+        }
+      }
     },
     /**
      * Clears a custom error message from a specific field.
      */
     clearCustomError: function _clearCustomError(fieldPath) {
       this.validationDelegate.clearCustomError(fieldPath);
+      if (this.getProperty("useMessageManager") !== true && this.engine) {
+        const plugin = this.engine.getPluginByPath(fieldPath);
+        if (plugin && typeof plugin.setVisualValidationState === "function") {
+          const schemaValid = plugin.validate();
+          plugin.setVisualValidationState(schemaValid.isValid, schemaValid.errorMessage);
+        }
+      }
     },
     /**
      * Toggles busy state on the host control.
@@ -341,7 +388,7 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
      * Intercepts property changes. Hot-swaps data gracefully if it's an inputData change,
      * or forces a full UI teardown if it's a structural property change (like schemaDefinition).
      */
-    setProperty: function _setProperty(propertyName, value, suppressInvalidate) {
+    setProperty: function _setProperty2(propertyName, value, suppressInvalidate) {
       if (propertyName === "dataJson" || propertyName === "data") {
         this.dataSyncDelegate.handleInputDataHotSwap(propertyName, value, suppressInvalidate);
         return this;
@@ -368,13 +415,20 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
      * @returns Promise that resolves when the layout is successfully built and mounted.
      */
     generate: async function _generate() {
-      return Promise.resolve().then(async () => {
+      if (this._generatePromise) {
+        return this._generatePromise;
+      }
+      this._generatePromise = Promise.resolve().then(async () => {
         try {
           await this._doGenerate();
         } catch (e) {
           Logger.error("[MetaUI]", "Error in deferred generate: " + e, "GeneratorHost");
+          throw e; // Ensure it bubbles up to awaiters
+        } finally {
+          this._generatePromise = null;
         }
       });
+      return this._generatePromise;
     },
     /**
      * The underlying synchronous generator orchestration method.
@@ -400,25 +454,49 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
           this.stateManager = null;
         }
         const rawSchema = this.getProperty("schemaDefinition");
+        const isSchemaEmpty = !rawSchema || typeof rawSchema === "object" && Object.keys(rawSchema).length === 0;
         let inputData = this.getProperty("data");
         const inputDataJson = this.getProperty("dataJson");
         if (inputDataJson) {
           try {
             inputData = JSON.parse(inputDataJson);
           } catch (e) {
-            Logger.error("[MetaUI]", "Failed to parse inputDataJson string: " + e.message, "GeneratorHost");
+            const msg = "Failed to parse inputDataJson string: " + e.message;
+            Logger.error("[MetaUI]", msg, "GeneratorHost");
+            this.fireEvent("error", {
+              message: msg,
+              exception: e
+            });
+            throw new Error(msg); // Critical error instead of silent fallback
           }
         } else if (typeof inputData === "string") {
           try {
             inputData = JSON.parse(inputData);
           } catch (e) {
-            Logger.error("[MetaUI]", "Failed to parse inputData string: " + e.message, "GeneratorHost");
+            const msg = "Failed to parse inputData string: " + e.message;
+            Logger.error("[MetaUI]", msg, "GeneratorHost");
+            this.fireEvent("error", {
+              message: msg,
+              exception: e
+            });
+            throw new Error(msg); // Critical error instead of silent fallback
           }
         }
 
         // The internal payload represents the user's latest un-extracted edits. It must take priority.
-        const finalData = internalPayload || inputData || {};
-        const normalizedSchema = SchemaNormalizer.normalize(rawSchema, finalData);
+        const finalData = internalPayload || inputData;
+        if (!finalData || Object.keys(finalData).length === 0) {
+          if (isSchemaEmpty) {
+            const msg = "No payload provided and no explicit schema defined. Cannot infer UI.";
+            Logger.error("[MetaUI]", msg, "GeneratorHost");
+            this.fireEvent("error", {
+              message: msg
+            });
+            throw new Error(msg);
+          }
+        }
+        const schemaToNormalize = isSchemaEmpty ? null : rawSchema;
+        const normalizedSchema = SchemaNormalizer.normalize(schemaToNormalize, finalData);
 
         // Cache the parsed/inferred schema so DataSyncDelegate can diff against it later
         this.parsedSchema = normalizedSchema;
@@ -445,25 +523,61 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
         }
         this.activeModelName = "metaUI_" + this.getId();
         this.stateManager = new StateManager(finalData, normalizedSchema, this.activeModelName);
+        this.stateManager.setUseMessageManager(this.getProperty("useMessageManager") === true);
         this.setModel(this.stateManager.getModel(), this.activeModelName);
-        this.engine = new Engine(this.getProperty("editable"));
+        if (!this.engine) {
+          const isEditable = this.getProperty("editable") !== false;
+          const useMessageManager = this.getProperty("useMessageManager") === true;
+          this.engine = new Engine(isEditable, useMessageManager);
+        }
         this.generatedContent = this.engine.build(normalizedSchema, this.stateManager.getModel(), this.activeModelName, this.triggerSubmit.bind(this), this.getId(), this.onInternalFieldChange.bind(this));
-        this.setAggregation("_content", this.generatedContent);
+        let contentContainer = this.generatedContent;
+        const hasProperties = normalizedSchema && Object.keys(normalizedSchema).length > 0;
+        if (!hasProperties) {
+          const strip = new MessageStrip({
+            text: "Warning: The generated UI is blank. Reason: The schema (or inferred schema) contains no valid properties to render.",
+            type: "Warning",
+            showIcon: true,
+            showCloseButton: false
+          });
+          strip.addStyleClass("sapUiSmallMarginBottom");
+          contentContainer = new VBox({
+            items: [strip, this.generatedContent]
+          });
+        } else if (this.engine.hasPartialRenderingErrors) {
+          const strip = new MessageStrip({
+            text: "Layout partially rendered. Some fields failed to generate due to configuration errors.",
+            type: "Warning",
+            showIcon: true,
+            showCloseButton: true
+          });
+          strip.addStyleClass("sapUiSmallMarginBottom");
+          contentContainer = new VBox({
+            items: [strip, this.generatedContent]
+          });
+        }
+        this.setAggregation("_content", contentContainer);
         this.validationDelegate.registerObject(this.generatedContent);
         const payload = this.stateManager.extractPayload();
         this.dataSyncDelegate.pushToBindings(payload);
       } catch (error) {
         this.setBusy(false);
-        Logger.error("[MetaUI]", "Fatal crash during layout generation: " + error.message, "GeneratorHost");
+        const msg = "Fatal crash during layout generation: " + error.message;
+        Logger.error("[MetaUI]", msg, "GeneratorHost");
+        this.fireEvent("error", {
+          message: msg,
+          exception: error
+        });
         this.validationDelegate.mountCrashBoundary(error);
+        throw error; // Completely eliminate silent error swallowing
       }
     },
     /**
      * Programmatic API. Re-parents the generated content into a dialog and opens it.
      */
-    openInDialog: function _openInDialog(title = "Form", submitButtonText = "OK") {
+    openInDialog: function _openInDialog(title = "Form", submitButtonText = "OK", cancelButtonText = "Cancel", dialogWidth = "800px", parentView) {
       const isGenerated = !!this.generatedContent;
-      this.dialogDelegate.openInDialog(title, submitButtonText, isGenerated);
+      this.dialogDelegate.openInDialog(title, submitButtonText, isGenerated, cancelButtonText, dialogWidth, parentView);
     }
   });
   return GeneratorHost;