@siliconst/metaui 1.4.21 → 1.4.37

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

@@ -1 +1 @@
-{"version":3,"file":"BasePlugin-dbg.js","names":["GlobalPipeline","____core_PipelineManager","Logger","____utils_Logger","BasePlugin","control","metadata","fieldKey","modelName","isEditable","useMessageManager","setEditable","editable","setUseMessageManager","generateStableId","engineScopeId","bindingPath","undefined","safePath","replace","generateBindingInfo","typeInstance","additionalOptions","path","model","type","validate","isValid","getVisible","validatorsToRun","argsMap","maxLength","required","push","minLength","pattern","minimum","maximum","min","max","format","ui","validators","v","name","args","length","errorMessage","val","getValue","result","executeValidation","setVisualValidationState","ctrl","setValueState","coreLibrary","ValueState","None","Error","setValueStateText","error","validateAndApplyVisualState","onStateChange","newMetadata","applyState","applyCommonDirectives","readOnly","visibleOn","ExpressionBuilder","sap","require","expr","build","bindProperty","parts","formatter","enabledOn","setEnabled","destroy","__exports","__esModule"],"sources":["BasePlugin.ts"],"sourcesContent":["/**\n * @file BasePlugin.ts\n * @description Abstract foundation for all MetaUI plugins, enforcing lifecycle hooks for v2 Schema.\n */\n\nimport { IPlugin } from \"../../interfaces/IPlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport { GlobalPipeline } from \"../../core/PipelineManager\";\nimport coreLibrary from \"sap/ui/core/library\";\nimport { Logger } from \"../../utils/Logger\";\n\n/**\n * Abstract class representing a standard MetaUI Plugin.\n * Enforces the required rendering, state extraction, and validation contracts.\n * \n * @abstract\n * @public\n */\nexport abstract class BasePlugin implements IPlugin {\n    /** The instantiated UI5 control for this plugin. */\n    protected control: Control | null = null;\n\n    /** The metadata schema defining the field rules. */\n    protected metadata: IPropertyMetadata | null = null;\n\n    /** The internal JSON path of the field relative to its parent payload. */\n    protected fieldKey: string = \"\";\n\n    /** The UI5 JSONModel name used for absolute binding paths. */\n    protected modelName: string = \"meta\";\n\n    /** Indicates if the engine is enforcing an editable mode. */\n    protected isEditable: boolean = true;\n\n    /** Indicates if the plugin should delegate visual validation to the MessageManager. */\n    protected useMessageManager: boolean = false;\n\n    /** Internal callback provided by GeneratorHost to signal validation/data changes upwards */\n    protected onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /**\n     * Injects the global editable mode context into the plugin before rendering.\n     * @param editable True if the plugin should render in editable mode.\n     */\n    public setEditable(editable: boolean): void {\n        this.isEditable = editable;\n    }\n\n    /**\n     * Injects the global MessageManager context into the plugin.\n     * @param useMessageManager True if the MessageManager is handling validation visual states.\n     */\n    public setUseMessageManager(useMessageManager: boolean): void {\n        this.useMessageManager = useMessageManager;\n    }\n\n    /**\n     * Instantiates the raw UI5 control and binds it to the model.\n     * \n     * @param fieldMetadata The JSON Schema for the field.\n     * @param bindingPath The JSON path to bind to.\n     * @param modelName The UI5 model name.\n     * @param engineScopeId The deterministic scope ID provided by the Engine to prevent cloning collisions.\n     * @param onChange The callback fired natively when a field value blur/change occurs.\n     * @returns {Control} The generated UI5 control.\n     */\n    public abstract render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void, model?: unknown): Control;\n\n    /**\n     * Generates a deterministic, globally unique ID for this control.\n     * Prefixes the sanitized binding path with the Engine's scoped ID.\n     */\n    protected generateStableId(engineScopeId: string | undefined, bindingPath: string): string | undefined {\n        if (!engineScopeId) return undefined;\n        // Strip leading slash and replace internal slashes with hyphens\n        const safePath = bindingPath.replace(/^\\//, '').replace(/\\//g, '-');\n        return `${engineScopeId}--${safePath}`;\n    }\n\n    /**\n     * Extracts the current raw value from the underlying UI5 control.\n     */\n    protected abstract getValue(): unknown;\n\n    /**\n     * Generates a standardized programmatic binding configuration object.\n     * Ensures perfect architectural consistency across all plugins instead of relying on string parsing.\n     * \n     * @param bindingPath The relative or absolute path.\n     * @param modelName The target model name.\n     * @param typeInstance An optional UI5 Type instance (e.g. Integer, Float).\n     * @param additionalOptions Optional extra configurations (e.g. formatOptions, constraints).\n     * @returns A configuration object ready to be assigned to 'value', 'text', 'state', etc.\n     */\n    protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): { path: string, model: string, type?: unknown, [key: string]: unknown } {\n        return {\n            path: bindingPath,\n            model: modelName,\n            ...(typeInstance ? { type: typeInstance } : {}),\n            ...(additionalOptions || {})\n        };\n    }\n\n    /**\n     * Universal pipeline validation.\n     */\n    public validate(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        if (!this.control || !this.metadata) return { isValid: true };\n\n        // Skip validation for hidden fields (e.g. hidden by ConditionEngine visibleOn)\n        if (typeof (this.control as Control).getVisible === \"function\") {\n            if (!(this.control as Control).getVisible()) {\n                return { isValid: true };\n            }\n        }\n\n        const validatorsToRun: string[] = [];\n        const argsMap: Record<string, unknown> = {\n            \"maxLength\": this.metadata.maxLength\n        };\n\n        if (this.metadata.required) {\n            validatorsToRun.push(\"required\");\n        }\n        if (this.metadata.maxLength) validatorsToRun.push(\"maxLength\");\n        if (this.metadata.minLength) {\n            validatorsToRun.push(\"minLength\");\n            argsMap[\"minLength\"] = this.metadata.minLength;\n        }\n        if (this.metadata.pattern) {\n            validatorsToRun.push(\"pattern\");\n            argsMap[\"pattern\"] = this.metadata.pattern;\n        }\n        if (this.metadata.minimum !== undefined || this.metadata.maximum !== undefined) {\n            validatorsToRun.push(\"range\");\n            argsMap[\"range\"] = { min: this.metadata.minimum, max: this.metadata.maximum };\n        }\n        \n        const format = this.metadata.ui?.format;\n        if (format === \"email\" || format === \"url\" || format === \"iban\") {\n            validatorsToRun.push(format);\n        }\n\n        if (this.metadata.ui?.validators) {\n            for (const v of this.metadata.ui.validators) {\n                if (typeof v === \"string\") {\n                    validatorsToRun.push(v);\n                } else if (v && v.name) {\n                    validatorsToRun.push(v.name);\n                    if (v.args !== undefined) {\n                        argsMap[v.name] = v.args;\n                    }\n                }\n            }\n        }\n\n        if (validatorsToRun.length === 0) {\n            return { isValid: true, errorMessage: undefined, fieldKey: this.fieldKey };\n        }\n\n        const val = this.getValue();\n        const result = GlobalPipeline.executeValidation(val, validatorsToRun, argsMap);\n        return { isValid: result.isValid, errorMessage: result.errorMessage, fieldKey: this.fieldKey };\n    }\n\n    /**\n     * Natively manipulates the UI5 control's valueState if the control supports it.\n     * Uses reflection to safely apply styles without crashing on structural controls.\n     */\n    public setVisualValidationState(isValid: boolean, errorMessage?: string): void {\n        if (!this.control) return;\n\n        \n        // Use reflection to check if the control supports ValueState (e.g. sap.m.Input does, sap.m.Text does not)\n        type StateControl = {\n            setValueState?: (state: string) => void;\n            setValueStateText?: (text: string) => void;\n        };\n        const ctrl = this.control as unknown as StateControl;\n        if (typeof ctrl.setValueState === \"function\") {\n            ctrl.setValueState(isValid ? coreLibrary.ValueState.None : coreLibrary.ValueState.Error);\n            \n            if (typeof ctrl.setValueStateText === \"function\") {\n                ctrl.setValueStateText(isValid ? \"\" : (errorMessage || \"\"));\n            }\n        } else {\n            Logger.error(\"[MetaUI]\", `Plugin ${this.fieldKey} has no setValueState function!`, \"BasePlugin\");\n        }\n    }\n\n    /**\n     * Wraps standard validation and immediately applies the visual state.\n     * Ideal for 'change' events to instantly turn fields red on blur.\n     */\n    protected validateAndApplyVisualState(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        const result = this.validate();\n        this.setVisualValidationState(result.isValid, result.errorMessage);\n        return result;\n    }\n\n    /**\n     * Executes when the condition engine pushes new schema metadata to this field (e.g. readOnly changing).\n     * @param newMetadata The mutated schema metadata.\n     */\n    public onStateChange(newMetadata: IPropertyMetadata): void {\n        this.metadata = newMetadata;\n        this.applyState();\n    }\n\n    /**\n     * Abstract hook for the plugin to apply state changes to its specific UI5 control (e.g. placeholders, labels).\n     */\n    protected abstract applyState(): void;\n\n    /**\n     * Helper to apply common UI directives (like readOnly, visibleOn) directly to any control.\n     */\n    protected applyCommonDirectives(control: Control, metadata: IPropertyMetadata, modelName: string = \"meta\"): void {\n        const ctrl = control as unknown as { setEditable?: (b: boolean) => void, setEnabled?: (b: boolean) => void };\n        if (metadata.ui?.readOnly !== undefined && typeof ctrl.setEditable === \"function\") {\n            ctrl.setEditable(!metadata.ui.readOnly);\n        }\n\n        if (metadata.ui?.visibleOn) {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.visibleOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.visibleOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"visible\", { parts: [{ path: \"meta>/\" }], formatter: () => false });\n            control.bindProperty(\"visible\", expr);\n        }\n\n        if (metadata.ui?.enabledOn && typeof ctrl.setEnabled === \"function\") {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.enabledOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.enabledOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"enabled\", expr);\n        }\n    }\n\n\n\n    /**\n     * Natively destroys the instantiated UI5 control to prevent memory leaks.\n     * Can be overridden by subclasses if they manage secondary controls or custom models.\n     */\n    public destroy(): void {\n        if (this.control && typeof this.control.destroy === \"function\") {\n            this.control.destroy();\n            this.control = null;\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"BasePlugin-dbg.js","names":["GlobalPipeline","____core_PipelineManager","Logger","____utils_Logger","BasePlugin","control","BLOCKED_PROPS","metadata","fieldKey","modelName","isEditable","useMessageManager","policyInvalidMessage","setEditable","editable","setUseMessageManager","generateStableId","engineScopeId","bindingPath","undefined","safePath","replace","generateBindingInfo","typeInstance","additionalOptions","path","model","type","validate","isValid","getVisible","errorMessage","validatorsToRun","argsMap","maxLength","isRequired","_isDynamicallyRequired","required","push","minLength","pattern","minimum","maximum","min","max","format","ui","validators","v","name","args","length","val","getValue","result","executeValidation","fieldLabel","label","setVisualValidationState","ctrl","setValueState","coreLibrary","ValueState","None","Error","setValueStateText","applyError","clearError","applyVisibility","isVisible","setVisible","applyRequired","setRequired","applyEditable","setEnabled","onStateChange","newMetadata","applyState","applyCommonDirectives","readOnly","visibleOn","ExpressionBuilder","sap","require","expr","build","bindProperty","parts","formatter","enabledOn","controlProps","console","error","targetControl","mainControl","target","getMetadata","targetMeta","settings","propName","propValue","Object","entries","includes","warn","hasAggregation","hasEvent","startsWith","endsWith","injectedValue","applySettings","err","getName","message","destroy","__exports","__esModule"],"sources":["BasePlugin.ts"],"sourcesContent":["/**\n * @file BasePlugin.ts\n * @description Abstract foundation for all MetaUI plugins, enforcing lifecycle hooks for v2 Schema.\n */\n\nimport { IPlugin } from \"../../interfaces/IPlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport { GlobalPipeline } from \"../../core/PipelineManager\";\nimport * as coreLibrary from \"sap/ui/core/library\";\nimport { Logger } from \"../../utils/Logger\";\n\n/**\n * Abstract class representing a standard MetaUI Plugin.\n * Enforces the required rendering, state extraction, and validation contracts.\n * \n * @abstract\n * @public\n */\nexport abstract class BasePlugin implements IPlugin {\n    /** The instantiated UI5 control for this plugin. */\n    protected control: Control | null = null;\n\n    /** Explicit reference to the core data widget when this plugin is wrapped in a layout. */\n    protected mainControl?: Control;\n\n    /** Properties strictly protected by the Sandbox engine. */\n    protected BLOCKED_PROPS = [\"value\", \"text\", \"selectedKey\", \"selected\", \"dateValue\", \"editable\", \"enabled\", \"visible\", \"valueState\", \"valueStateText\", \"items\", \"content\", \"pages\", \"formElements\", \"change\", \"press\", \"select\", \"submit\"];\n\n    /** The metadata schema defining the field rules. */\n    protected metadata: IPropertyMetadata | null = null;\n\n    /** The internal JSON path of the field relative to its parent payload. */\n    protected fieldKey: string = \"\";\n\n    /** The UI5 JSONModel name used for absolute binding paths. */\n    protected modelName: string = \"meta\";\n\n    /** Indicates if the engine is enforcing an editable mode. */\n    protected isEditable: boolean = true;\n\n    /** Indicates if the plugin should delegate visual validation to the MessageManager. */\n    protected useMessageManager: boolean = false;\n\n    /** Internal callback provided by GeneratorHost to signal validation/data changes upwards */\n    protected onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /** \n     * Tracks explicitly forced invalid states pushed down from the PolicyEngine.\n     * When populated, this error takes absolute precedence over static SchemaValidator rules.\n     */\n    protected policyInvalidMessage: string | null = null;\n\n    /** Transient state tracking for PBRE required evaluations to prevent schema clobbering */\n    protected _isDynamicallyRequired?: boolean;\n\n    /**\n     * Injects the global editable mode context into the plugin before rendering.\n     * @param editable True if the plugin should render in editable mode.\n     */\n    public setEditable(editable: boolean): void {\n        this.isEditable = editable;\n    }\n\n    /**\n     * Injects the global MessageManager context into the plugin.\n     * @param useMessageManager True if the MessageManager is handling validation visual states.\n     */\n    public setUseMessageManager(useMessageManager: boolean): void {\n        this.useMessageManager = useMessageManager;\n    }\n\n    /**\n     * Instantiates the raw UI5 control and binds it to the model.\n     * \n     * @param fieldMetadata The JSON Schema for the field.\n     * @param bindingPath The JSON path to bind to.\n     * @param modelName The UI5 model name.\n     * @param engineScopeId The deterministic scope ID provided by the Engine to prevent cloning collisions.\n     * @param onChange The callback fired natively when a field value blur/change occurs.\n     * @returns {Control} The generated UI5 control.\n     */\n    public abstract render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void, model?: unknown): Control;\n\n    /**\n     * Generates a deterministic, globally unique ID for this control.\n     * Prefixes the sanitized binding path with the Engine's scoped ID.\n     */\n    protected generateStableId(engineScopeId: string | undefined, bindingPath: string): string | undefined {\n        if (!engineScopeId) return undefined;\n        // Strip leading slash and replace internal slashes with hyphens\n        const safePath = bindingPath.replace(/^\\//, '').replace(/\\//g, '-');\n        return `${engineScopeId}--${safePath}`;\n    }\n\n    /**\n     * Extracts the current raw value from the underlying UI5 control.\n     */\n    protected abstract getValue(): unknown;\n\n    /**\n     * Generates a standardized programmatic binding configuration object.\n     * Ensures perfect architectural consistency across all plugins instead of relying on string parsing.\n     * \n     * @param bindingPath The relative or absolute path.\n     * @param modelName The target model name.\n     * @param typeInstance An optional UI5 Type instance (e.g. Integer, Float).\n     * @param additionalOptions Optional extra configurations (e.g. formatOptions, constraints).\n     * @returns A configuration object ready to be assigned to 'value', 'text', 'state', etc.\n     */\n    protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): any {\n        return {\n            path: bindingPath,\n            model: modelName,\n            ...(typeInstance ? { type: typeInstance } : {}),\n            ...(additionalOptions || {})\n        };\n    }\n\n    /**\n     * Universal pipeline validation.\n     */\n    public validate(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        if (!this.control || !this.metadata) return { isValid: true };\n\n        // Skip validation for hidden fields (e.g. hidden by ConditionEngine visibleOn)\n        if (typeof (this.control as Control).getVisible === \"function\") {\n            if (!(this.control as Control).getVisible()) {\n                return { isValid: true };\n            }\n        }\n\n        if (this.policyInvalidMessage) {\n            return { isValid: false, errorMessage: this.policyInvalidMessage, fieldKey: this.fieldKey };\n        }\n\n        const validatorsToRun: string[] = [];\n        const argsMap: Record<string, unknown> = {\n            \"maxLength\": this.metadata.maxLength\n        };\n\n        const isRequired = this._isDynamicallyRequired !== undefined ? this._isDynamicallyRequired : this.metadata.required;\n        if (isRequired) {\n            validatorsToRun.push(\"required\");\n        }\n        if (this.metadata.maxLength) validatorsToRun.push(\"maxLength\");\n        if (this.metadata.minLength) {\n            validatorsToRun.push(\"minLength\");\n            argsMap[\"minLength\"] = this.metadata.minLength;\n        }\n        if (this.metadata.pattern) {\n            validatorsToRun.push(\"pattern\");\n            argsMap[\"pattern\"] = this.metadata.pattern;\n        }\n        if (this.metadata.minimum !== undefined || this.metadata.maximum !== undefined) {\n            validatorsToRun.push(\"range\");\n            argsMap[\"range\"] = { min: this.metadata.minimum, max: this.metadata.maximum };\n        }\n\n        const format = this.metadata.ui?.format;\n        if (format === \"email\" || format === \"url\" || format === \"iban\") {\n            validatorsToRun.push(format);\n        }\n\n        if (this.metadata.ui?.validators) {\n            for (const v of this.metadata.ui.validators) {\n                if (typeof v === \"string\") {\n                    validatorsToRun.push(v);\n                } else if (v && v.name) {\n                    validatorsToRun.push(v.name);\n                    if (v.args !== undefined) {\n                        argsMap[v.name] = v.args;\n                    }\n                }\n            }\n        }\n\n        if (validatorsToRun.length === 0) {\n            return { isValid: true, errorMessage: undefined, fieldKey: this.fieldKey };\n        }\n\n        const val = this.getValue();\n        const result = GlobalPipeline.executeValidation(val, validatorsToRun, argsMap);\n        return { isValid: result.isValid, errorMessage: result.errorMessage, fieldKey: this.fieldKey, fieldLabel: this.metadata?.ui?.label };\n    }\n\n    /**\n     * Natively manipulates the UI5 control's valueState if the control supports it.\n     * Uses reflection to safely apply styles without crashing on structural controls.\n     */\n    public setVisualValidationState(isValid: boolean, errorMessage?: string): void {\n        if (!this.control) return;\n\n\n        // Use reflection to check if the control supports ValueState (e.g. sap.m.Input does, sap.m.Text does not)\n        type StateControl = {\n            setValueState?: (state: string) => void;\n            setValueStateText?: (text: string) => void;\n        };\n        const ctrl = this.control as unknown as StateControl;\n        if (typeof ctrl.setValueState === \"function\") {\n            ctrl.setValueState(isValid ? coreLibrary.ValueState.None : coreLibrary.ValueState.Error);\n\n            if (typeof ctrl.setValueStateText === \"function\") {\n                ctrl.setValueStateText(isValid ? \"\" : (errorMessage || \"\"));\n            }\n        } else {\n            // Quietly ignore. Controls like sap.m.Text natively do not support value states, which is completely valid.\n        }\n    }\n\n\n\n    // --- IPluginStateReceiver Implementation for PBRE ---\n\n    /**\n     * Natively applies a forced error state from the PolicyEngine.\n     * Per MetaUI Architecture Rule 12, this explicitly forces the visual state red \n     * independently of the MessageManager auto-sync.\n     * \n     * @param errorMessage The custom error message to display.\n     */\n    public applyError(errorMessage: string): void {\n        this.policyInvalidMessage = errorMessage;\n        this.setVisualValidationState(false, errorMessage);\n    }\n\n    /**\n     * Clears a previously forced error state.\n     * Restores the visual boundary to standard (non-error) formatting.\n     */\n    public clearError(): void {\n        this.policyInvalidMessage = null;\n        this.setVisualValidationState(true);\n    }\n\n    /**\n     * Dynamically manipulates the visibility state of the control based on PolicyEngine directives.\n     * \n     * @param isVisible True to display the control, false to hide it.\n     */\n    public applyVisibility(isVisible: boolean): void {\n        const ctrl = this.control as unknown as { setVisible?: (b: boolean) => void };\n        if (ctrl && typeof ctrl.setVisible === \"function\") {\n            ctrl.setVisible(isVisible);\n        }\n    }\n\n    /**\n     * Dynamically alters the mandatory status of the field.\n     * Updates internal transient state to ensure the `validate()` pipeline enforces the change,\n     * and natively triggers the UI5 required indicator (asterisk) if supported,\n     * without permanently corrupting the shared global schema definition.\n     * \n     * @param isRequired True to make the field mandatory, false to make it optional.\n     */\n    public applyRequired(isRequired: boolean): void {\n        this._isDynamicallyRequired = isRequired;\n        const ctrl = this.control as unknown as { setRequired?: (b: boolean) => void };\n        if (ctrl && typeof ctrl.setRequired === \"function\") {\n            ctrl.setRequired(isRequired);\n        }\n    }\n\n    /**\n     * Dynamically alters the editability of the field.\n     * Falls back to `setEnabled` if the control is structural rather than purely input-driven.\n     * \n     * @param isEditable True to allow user input, false to lock it.\n     */\n    public applyEditable(isEditable: boolean): void {\n        const ctrl = this.control as unknown as { setEditable?: (b: boolean) => void, setEnabled?: (b: boolean) => void };\n        if (ctrl && typeof ctrl.setEditable === \"function\") {\n            ctrl.setEditable(isEditable);\n        } else if (ctrl && typeof ctrl.setEnabled === \"function\") {\n            ctrl.setEnabled(isEditable);\n        }\n    }\n\n    /**\n     * Executes when the condition engine pushes new schema metadata to this field (e.g. readOnly changing).\n     * @param newMetadata The mutated schema metadata.\n     */\n    public onStateChange(newMetadata: IPropertyMetadata): void {\n        this.metadata = newMetadata;\n        this.applyState();\n    }\n\n    /**\n     * Abstract hook for the plugin to apply state changes to its specific UI5 control (e.g. placeholders, labels).\n     */\n    protected abstract applyState(): void;\n\n    /**\n     * Helper to apply common UI directives (like readOnly, visibleOn) directly to any control.\n     */\n    protected applyCommonDirectives(control: Control, metadata: IPropertyMetadata, modelName: string = \"meta\"): void {\n        const ctrl = control as unknown as { setEditable?: (b: boolean) => void, setEnabled?: (b: boolean) => void };\n        if (metadata.ui?.readOnly !== undefined && typeof ctrl.setEditable === \"function\") {\n            ctrl.setEditable(!metadata.ui.readOnly);\n        }\n\n        if (metadata.ui?.visibleOn) {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.visibleOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.visibleOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"visible\", { parts: [{ path: \"meta>/\" }], formatter: () => false });\n            control.bindProperty(\"visible\", expr);\n        }\n\n        if (metadata.ui?.enabledOn && typeof ctrl.setEnabled === \"function\") {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.enabledOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.enabledOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"enabled\", expr);\n        }\n\n        if (metadata.ui?.controlProps) {\n            console.error(`[DEBUG MetaUI] controlProps found for ${this.fieldKey}`, metadata.ui.controlProps);\n            const targetControl = this.mainControl || control;\n            const target = targetControl as unknown as {\n                getMetadata?: () => { getName(): string },\n                applySettings?: (settings: Record<string, any>) => void,\n                setProperty?: (p: string, v: unknown) => void,\n                bindProperty?: (p: string, v: string) => void\n            };\n\n            if (typeof target.getMetadata === \"function\") {\n                const targetMeta = target.getMetadata();\n                const settings: Record<string, any> = {};\n                for (const [propName, propValue] of Object.entries(metadata.ui.controlProps)) {\n                    if (this.BLOCKED_PROPS.includes(propName)) {\n                        Logger.warn(`[BasePlugin] Cannot apply controlProps '${propName}' for field '${this.fieldKey}' - ILLEGAL OVERRIDE (Property is protected by sandbox)`);\n                        continue;\n                    }\n                    \n                    // Natively block any aggregations or events to prevent sandbox escapes\n                    if (typeof (targetMeta as any).hasAggregation === \"function\" && (targetMeta as any).hasAggregation(propName)) {\n                        Logger.warn(`[BasePlugin] Cannot apply controlProps '${propName}' for field '${this.fieldKey}' - ILLEGAL OVERRIDE (Cannot hijack aggregations)`);\n                        continue;\n                    }\n                    \n                    if (typeof (targetMeta as any).hasEvent === \"function\" && (targetMeta as any).hasEvent(propName)) {\n                        Logger.warn(`[BasePlugin] Cannot apply controlProps '${propName}' for field '${this.fieldKey}' - ILLEGAL OVERRIDE (Cannot hijack events)`);\n                        continue;\n                    }\n\n                    if (typeof propValue === \"string\" && propValue.startsWith(\"{\") && propValue.endsWith(\"}\")) {\n                        // The JSON payloads often hardcode 'metaui>' in raw expression bindings, \n                        // but the Engine dynamically generates model names like 'metaUI_Host1'. \n                        // We must inject the actual modelName dynamically into the expression string.\n                        const injectedValue = propValue.replace(/metaui>/g, `${modelName}>`);\n                        settings[propName] = injectedValue;\n                    } else {\n                        settings[propName] = propValue;\n                    }\n                }\n\n                try {\n                    const target = targetControl as unknown as { applySettings?: (s: Record<string, any>) => void };\n                    if (typeof target.applySettings === \"function\") {\n                        target.applySettings(settings);\n                    }\n                } catch (err: unknown) {\n                    Logger.warn(`[BasePlugin] Failed to apply controlProps for field '${this.fieldKey}' on control ${targetMeta.getName()}: ${(err as Error).message}`);\n                }\n            }\n        }\n    }\n\n\n\n    /**\n     * Natively destroys the instantiated UI5 control to prevent memory leaks.\n     * Can be overridden by subclasses if they manage secondary controls or custom models.\n     */\n    public destroy(): void {\n        if (this.control && typeof this.control.destroy === \"function\") {\n            this.control.destroy();\n            this.control = null;\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -16,6 +16,10 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin" {
     export abstract class BasePlugin implements IPlugin {
         /** The instantiated UI5 control for this plugin. */
         protected control: Control | null;
+        /** Explicit reference to the core data widget when this plugin is wrapped in a layout. */
+        protected mainControl?: Control;
+        /** Properties strictly protected by the Sandbox engine. */
+        protected BLOCKED_PROPS: string[];
         /** The metadata schema defining the field rules. */
         protected metadata: IPropertyMetadata | null;
         /** The internal JSON path of the field relative to its parent payload. */
@@ -28,6 +32,13 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin" {
         protected useMessageManager: boolean;
         /** Internal callback provided by GeneratorHost to signal validation/data changes upwards */
         protected onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;
+        /**
+         * Tracks explicitly forced invalid states pushed down from the PolicyEngine.
+         * When populated, this error takes absolute precedence over static SchemaValidator rules.
+         */
+        protected policyInvalidMessage: string | null;
+        /** Transient state tracking for PBRE required evaluations to prevent schema clobbering */
+        protected _isDynamicallyRequired?: boolean;
         /**
          * Injects the global editable mode context into the plugin before rendering.
          * @param editable True if the plugin should render in editable mode.
@@ -48,7 +59,7 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin" {
          * @param onChange The callback fired natively when a field value blur/change occurs.
          * @returns {Control} The generated UI5 control.
          */
-        abstract render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void, model?: unknown): Control;
+        abstract render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void, model?: unknown): Control;
         /**
          * Generates a deterministic, globally unique ID for this control.
          * Prefixes the sanitized binding path with the Engine's scoped ID.
@@ -68,12 +79,7 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin" {
          * @param additionalOptions Optional extra configurations (e.g. formatOptions, constraints).
          * @returns A configuration object ready to be assigned to 'value', 'text', 'state', etc.
          */
-        protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): {
-            path: string;
-            model: string;
-            type?: unknown;
-            [key: string]: unknown;
-        };
+        protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): any;
         /**
          * Universal pipeline validation.
          */
@@ -84,10 +90,40 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin" {
          */
         setVisualValidationState(isValid: boolean, errorMessage?: string): void;
         /**
-         * Wraps standard validation and immediately applies the visual state.
-         * Ideal for 'change' events to instantly turn fields red on blur.
+         * Natively applies a forced error state from the PolicyEngine.
+         * Per MetaUI Architecture Rule 12, this explicitly forces the visual state red
+         * independently of the MessageManager auto-sync.
+         *
+         * @param errorMessage The custom error message to display.
+         */
+        applyError(errorMessage: string): void;
+        /**
+         * Clears a previously forced error state.
+         * Restores the visual boundary to standard (non-error) formatting.
+         */
+        clearError(): void;
+        /**
+         * Dynamically manipulates the visibility state of the control based on PolicyEngine directives.
+         *
+         * @param isVisible True to display the control, false to hide it.
+         */
+        applyVisibility(isVisible: boolean): void;
+        /**
+         * Dynamically alters the mandatory status of the field.
+         * Updates internal transient state to ensure the `validate()` pipeline enforces the change,
+         * and natively triggers the UI5 required indicator (asterisk) if supported,
+         * without permanently corrupting the shared global schema definition.
+         *
+         * @param isRequired True to make the field mandatory, false to make it optional.
+         */
+        applyRequired(isRequired: boolean): void;
+        /**
+         * Dynamically alters the editability of the field.
+         * Falls back to `setEnabled` if the control is structural rather than purely input-driven.
+         *
+         * @param isEditable True to allow user input, false to lock it.
          */
-        protected validateAndApplyVisualState(): import("nz/co/siliconst/ui5/metaui/interfaces/IPlugin").IPluginValidationResult;
+        applyEditable(isEditable: boolean): void;
         /**
          * Executes when the condition engine pushes new schema metadata to this field (e.g. readOnly changing).
          * @param newMetadata The mutated schema metadata.

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

@@ -1 +1 @@
-{"version":3,"file":"BasePlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wDAAwD,CAAC;IACxE;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;IACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAK1C;;;;;;OAMG;IACH,eAAsB,UAAW,YAAW,OAAO;QAC/C,oDAAoD;QACpD,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAQ;QAEzC,oDAAoD;QACpD,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAQ;QAEpD,0EAA0E;QAC1E,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAM;QAEhC,8DAA8D;QAC9D,SAAS,CAAC,SAAS,EAAE,MAAM,CAAU;QAErC,6DAA6D;QAC7D,SAAS,CAAC,UAAU,EAAE,OAAO,CAAQ;QAErC,uFAAuF;QACvF,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAS;QAE7C,4FAA4F;QAC5F,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAE9G;;;WAGG;QACI,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;QAI3C;;;WAGG;QACI,oBAAoB,CAAC,iBAAiB,EAAE,OAAO,GAAG,IAAI;QAI7D;;;;;;;;;WASG;iBACa,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO;QAE7M;;;WAGG;QACH,SAAS,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;QAOtG;;WAEG;QACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,IAAI,OAAO;QAEtC;;;;;;;;;WASG;QACH,SAAS,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,CAAC;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE;QASnN;;WAEG;QACI,QAAQ,IAAI,OAAO,+CAA+C,EAAE,uBAAuB;QA2DlG;;;WAGG;QACI,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;QAqB9E;;;WAGG;QACH,SAAS,CAAC,2BAA2B,IAAI,OAAO,+CAA+C,EAAE,uBAAuB;QAMxH;;;WAGG;QACI,aAAa,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI;QAK1D;;WAEG;QACH,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI;QAErC;;WAEG;QACH,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,GAAE,MAAe,GAAG,IAAI;QAgChH;;;WAGG;QACI,OAAO,IAAI,IAAI;KAMzB;CAEA"}
+{"version":3,"file":"BasePlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin.ts"],"names":[],"mappings":"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"}

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

@@ -1,2 +1,2 @@
-sap.ui.define(["../../core/PipelineManager","sap/ui/core/library","../../utils/Logger"],function(e,t,i){"use strict";const a=e["GlobalPipeline"];const s=i["Logger"];class n{control=null;metadata=null;fieldKey="";modelName="meta";isEditable=true;useMessageManager=false;setEditable(e){this.isEditable=e}setUseMessageManager(e){this.useMessageManager=e}generateStableId(e,t){if(!e)return undefined;const i=t.replace(/^\//,"").replace(/\//g,"-");return`${e}--${i}`}generateBindingInfo(e,t,i,a){return{path:e,model:t,...i?{type:i}:{},...a||{}}}validate(){if(!this.control||!this.metadata)return{isValid:true};if(typeof this.control.getVisible==="function"){if(!this.control.getVisible()){return{isValid:true}}}const e=[];const t={maxLength:this.metadata.maxLength};if(this.metadata.required){e.push("required")}if(this.metadata.maxLength)e.push("maxLength");if(this.metadata.minLength){e.push("minLength");t["minLength"]=this.metadata.minLength}if(this.metadata.pattern){e.push("pattern");t["pattern"]=this.metadata.pattern}if(this.metadata.minimum!==undefined||this.metadata.maximum!==undefined){e.push("range");t["range"]={min:this.metadata.minimum,max:this.metadata.maximum}}const i=this.metadata.ui?.format;if(i==="email"||i==="url"||i==="iban"){e.push(i)}if(this.metadata.ui?.validators){for(const i of this.metadata.ui.validators){if(typeof i==="string"){e.push(i)}else if(i&&i.name){e.push(i.name);if(i.args!==undefined){t[i.name]=i.args}}}}if(e.length===0){return{isValid:true,errorMessage:undefined,fieldKey:this.fieldKey}}const s=this.getValue();const n=a.executeValidation(s,e,t);return{isValid:n.isValid,errorMessage:n.errorMessage,fieldKey:this.fieldKey}}setVisualValidationState(e,i){if(!this.control)return;const a=this.control;if(typeof a.setValueState==="function"){a.setValueState(e?t.ValueState.None:t.ValueState.Error);if(typeof a.setValueStateText==="function"){a.setValueStateText(e?"":i||"")}}else{s.error("[MetaUI]",`Plugin ${this.fieldKey} has no setValueState function!`,"BasePlugin")}}validateAndApplyVisualState(){const e=this.validate();this.setVisualValidationState(e.isValid,e.errorMessage);return e}onStateChange(e){this.metadata=e;this.applyState()}applyCommonDirectives(e,t,i="meta"){const a=e;if(t.ui?.readOnly!==undefined&&typeof a.setEditable==="function"){a.setEditable(!t.ui.readOnly)}if(t.ui?.visibleOn){const a=sap.ui.require("nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder")?.ExpressionBuilder;let s="";if(a){s=a.build(t.ui.visibleOn,this.fieldKey,i)}else{s=`{= ${t.ui.visibleOn.replace(/\$root\./g,`${i}>/`).replace(/\./g,"/")} }`}e.bindProperty("visible",{parts:[{path:"meta>/"}],formatter:()=>false});e.bindProperty("visible",s)}if(t.ui?.enabledOn&&typeof a.setEnabled==="function"){const a=sap.ui.require("nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder")?.ExpressionBuilder;let s="";if(a){s=a.build(t.ui.enabledOn,this.fieldKey,i)}else{s=`{= ${t.ui.enabledOn.replace(/\$root\./g,`${i}>/`).replace(/\./g,"/")} }`}e.bindProperty("enabled",s)}}destroy(){if(this.control&&typeof this.control.destroy==="function"){this.control.destroy();this.control=null}}}var r={__esModule:true};r.BasePlugin=n;return r});
+sap.ui.define(["../../core/PipelineManager","sap/ui/core/library","../../utils/Logger"],function(e,t,i){"use strict";const a=e["GlobalPipeline"];const s=i["Logger"];class n{control=null;BLOCKED_PROPS=["value","text","selectedKey","selected","dateValue","editable","enabled","visible","valueState","valueStateText","items","content","pages","formElements","change","press","select","submit"];metadata=null;fieldKey="";modelName="meta";isEditable=true;useMessageManager=false;policyInvalidMessage=null;setEditable(e){this.isEditable=e}setUseMessageManager(e){this.useMessageManager=e}generateStableId(e,t){if(!e)return undefined;const i=t.replace(/^\//,"").replace(/\//g,"-");return`${e}--${i}`}generateBindingInfo(e,t,i,a){return{path:e,model:t,...i?{type:i}:{},...a||{}}}validate(){if(!this.control||!this.metadata)return{isValid:true};if(typeof this.control.getVisible==="function"){if(!this.control.getVisible()){return{isValid:true}}}if(this.policyInvalidMessage){return{isValid:false,errorMessage:this.policyInvalidMessage,fieldKey:this.fieldKey}}const e=[];const t={maxLength:this.metadata.maxLength};const i=this._isDynamicallyRequired!==undefined?this._isDynamicallyRequired:this.metadata.required;if(i){e.push("required")}if(this.metadata.maxLength)e.push("maxLength");if(this.metadata.minLength){e.push("minLength");t["minLength"]=this.metadata.minLength}if(this.metadata.pattern){e.push("pattern");t["pattern"]=this.metadata.pattern}if(this.metadata.minimum!==undefined||this.metadata.maximum!==undefined){e.push("range");t["range"]={min:this.metadata.minimum,max:this.metadata.maximum}}const s=this.metadata.ui?.format;if(s==="email"||s==="url"||s==="iban"){e.push(s)}if(this.metadata.ui?.validators){for(const i of this.metadata.ui.validators){if(typeof i==="string"){e.push(i)}else if(i&&i.name){e.push(i.name);if(i.args!==undefined){t[i.name]=i.args}}}}if(e.length===0){return{isValid:true,errorMessage:undefined,fieldKey:this.fieldKey}}const n=this.getValue();const l=a.executeValidation(n,e,t);return{isValid:l.isValid,errorMessage:l.errorMessage,fieldKey:this.fieldKey,fieldLabel:this.metadata?.ui?.label}}setVisualValidationState(e,i){if(!this.control)return;const a=this.control;if(typeof a.setValueState==="function"){a.setValueState(e?t.ValueState.None:t.ValueState.Error);if(typeof a.setValueStateText==="function"){a.setValueStateText(e?"":i||"")}}else{}}applyError(e){this.policyInvalidMessage=e;this.setVisualValidationState(false,e)}clearError(){this.policyInvalidMessage=null;this.setVisualValidationState(true)}applyVisibility(e){const t=this.control;if(t&&typeof t.setVisible==="function"){t.setVisible(e)}}applyRequired(e){this._isDynamicallyRequired=e;const t=this.control;if(t&&typeof t.setRequired==="function"){t.setRequired(e)}}applyEditable(e){const t=this.control;if(t&&typeof t.setEditable==="function"){t.setEditable(e)}else if(t&&typeof t.setEnabled==="function"){t.setEnabled(e)}}onStateChange(e){this.metadata=e;this.applyState()}applyCommonDirectives(e,t,i="meta"){const a=e;if(t.ui?.readOnly!==undefined&&typeof a.setEditable==="function"){a.setEditable(!t.ui.readOnly)}if(t.ui?.visibleOn){const a=sap.ui.require("nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder")?.ExpressionBuilder;let s="";if(a){s=a.build(t.ui.visibleOn,this.fieldKey,i)}else{s=`{= ${t.ui.visibleOn.replace(/\$root\./g,`${i}>/`).replace(/\./g,"/")} }`}e.bindProperty("visible",{parts:[{path:"meta>/"}],formatter:()=>false});e.bindProperty("visible",s)}if(t.ui?.enabledOn&&typeof a.setEnabled==="function"){const a=sap.ui.require("nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder")?.ExpressionBuilder;let s="";if(a){s=a.build(t.ui.enabledOn,this.fieldKey,i)}else{s=`{= ${t.ui.enabledOn.replace(/\$root\./g,`${i}>/`).replace(/\./g,"/")} }`}e.bindProperty("enabled",s)}if(t.ui?.controlProps){console.error(`[DEBUG MetaUI] controlProps found for ${this.fieldKey}`,t.ui.controlProps);const a=this.mainControl||e;const n=a;if(typeof n.getMetadata==="function"){const e=n.getMetadata();const l={};for(const[a,n]of Object.entries(t.ui.controlProps)){if(this.BLOCKED_PROPS.includes(a)){s.warn(`[BasePlugin] Cannot apply controlProps '${a}' for field '${this.fieldKey}' - ILLEGAL OVERRIDE (Property is protected by sandbox)`);continue}if(typeof e.hasAggregation==="function"&&e.hasAggregation(a)){s.warn(`[BasePlugin] Cannot apply controlProps '${a}' for field '${this.fieldKey}' - ILLEGAL OVERRIDE (Cannot hijack aggregations)`);continue}if(typeof e.hasEvent==="function"&&e.hasEvent(a)){s.warn(`[BasePlugin] Cannot apply controlProps '${a}' for field '${this.fieldKey}' - ILLEGAL OVERRIDE (Cannot hijack events)`);continue}if(typeof n==="string"&&n.startsWith("{")&&n.endsWith("}")){const e=n.replace(/metaui>/g,`${i}>`);l[a]=e}else{l[a]=n}}try{const e=a;if(typeof e.applySettings==="function"){e.applySettings(l)}}catch(t){s.warn(`[BasePlugin] Failed to apply controlProps for field '${this.fieldKey}' on control ${e.getName()}: ${t.message}`)}}}}destroy(){if(this.control&&typeof this.control.destroy==="function"){this.control.destroy();this.control=null}}}var l={__esModule:true};l.BasePlugin=n;return l});
 //# sourceMappingURL=BasePlugin.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"BasePlugin.js","names":["GlobalPipeline","____core_PipelineManager","Logger","____utils_Logger","BasePlugin","control","metadata","fieldKey","modelName","isEditable","useMessageManager","setEditable","editable","this","setUseMessageManager","generateStableId","engineScopeId","bindingPath","undefined","safePath","replace","generateBindingInfo","typeInstance","additionalOptions","path","model","type","validate","isValid","getVisible","validatorsToRun","argsMap","maxLength","required","push","minLength","pattern","minimum","maximum","min","max","format","ui","validators","v","name","args","length","errorMessage","val","getValue","result","executeValidation","setVisualValidationState","ctrl","setValueState","coreLibrary","ValueState","None","Error","setValueStateText","error","validateAndApplyVisualState","onStateChange","newMetadata","applyState","applyCommonDirectives","readOnly","visibleOn","ExpressionBuilder","sap","require","expr","build","bindProperty","parts","formatter","enabledOn","setEnabled","destroy","__exports","__esModule"],"sources":["BasePlugin.ts"],"sourcesContent":["/**\n * @file BasePlugin.ts\n * @description Abstract foundation for all MetaUI plugins, enforcing lifecycle hooks for v2 Schema.\n */\n\nimport { IPlugin } from \"../../interfaces/IPlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport { GlobalPipeline } from \"../../core/PipelineManager\";\nimport coreLibrary from \"sap/ui/core/library\";\nimport { Logger } from \"../../utils/Logger\";\n\n/**\n * Abstract class representing a standard MetaUI Plugin.\n * Enforces the required rendering, state extraction, and validation contracts.\n * \n * @abstract\n * @public\n */\nexport abstract class BasePlugin implements IPlugin {\n    /** The instantiated UI5 control for this plugin. */\n    protected control: Control | null = null;\n\n    /** The metadata schema defining the field rules. */\n    protected metadata: IPropertyMetadata | null = null;\n\n    /** The internal JSON path of the field relative to its parent payload. */\n    protected fieldKey: string = \"\";\n\n    /** The UI5 JSONModel name used for absolute binding paths. */\n    protected modelName: string = \"meta\";\n\n    /** Indicates if the engine is enforcing an editable mode. */\n    protected isEditable: boolean = true;\n\n    /** Indicates if the plugin should delegate visual validation to the MessageManager. */\n    protected useMessageManager: boolean = false;\n\n    /** Internal callback provided by GeneratorHost to signal validation/data changes upwards */\n    protected onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /**\n     * Injects the global editable mode context into the plugin before rendering.\n     * @param editable True if the plugin should render in editable mode.\n     */\n    public setEditable(editable: boolean): void {\n        this.isEditable = editable;\n    }\n\n    /**\n     * Injects the global MessageManager context into the plugin.\n     * @param useMessageManager True if the MessageManager is handling validation visual states.\n     */\n    public setUseMessageManager(useMessageManager: boolean): void {\n        this.useMessageManager = useMessageManager;\n    }\n\n    /**\n     * Instantiates the raw UI5 control and binds it to the model.\n     * \n     * @param fieldMetadata The JSON Schema for the field.\n     * @param bindingPath The JSON path to bind to.\n     * @param modelName The UI5 model name.\n     * @param engineScopeId The deterministic scope ID provided by the Engine to prevent cloning collisions.\n     * @param onChange The callback fired natively when a field value blur/change occurs.\n     * @returns {Control} The generated UI5 control.\n     */\n    public abstract render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void, model?: unknown): Control;\n\n    /**\n     * Generates a deterministic, globally unique ID for this control.\n     * Prefixes the sanitized binding path with the Engine's scoped ID.\n     */\n    protected generateStableId(engineScopeId: string | undefined, bindingPath: string): string | undefined {\n        if (!engineScopeId) return undefined;\n        // Strip leading slash and replace internal slashes with hyphens\n        const safePath = bindingPath.replace(/^\\//, '').replace(/\\//g, '-');\n        return `${engineScopeId}--${safePath}`;\n    }\n\n    /**\n     * Extracts the current raw value from the underlying UI5 control.\n     */\n    protected abstract getValue(): unknown;\n\n    /**\n     * Generates a standardized programmatic binding configuration object.\n     * Ensures perfect architectural consistency across all plugins instead of relying on string parsing.\n     * \n     * @param bindingPath The relative or absolute path.\n     * @param modelName The target model name.\n     * @param typeInstance An optional UI5 Type instance (e.g. Integer, Float).\n     * @param additionalOptions Optional extra configurations (e.g. formatOptions, constraints).\n     * @returns A configuration object ready to be assigned to 'value', 'text', 'state', etc.\n     */\n    protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): { path: string, model: string, type?: unknown, [key: string]: unknown } {\n        return {\n            path: bindingPath,\n            model: modelName,\n            ...(typeInstance ? { type: typeInstance } : {}),\n            ...(additionalOptions || {})\n        };\n    }\n\n    /**\n     * Universal pipeline validation.\n     */\n    public validate(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        if (!this.control || !this.metadata) return { isValid: true };\n\n        // Skip validation for hidden fields (e.g. hidden by ConditionEngine visibleOn)\n        if (typeof (this.control as Control).getVisible === \"function\") {\n            if (!(this.control as Control).getVisible()) {\n                return { isValid: true };\n            }\n        }\n\n        const validatorsToRun: string[] = [];\n        const argsMap: Record<string, unknown> = {\n            \"maxLength\": this.metadata.maxLength\n        };\n\n        if (this.metadata.required) {\n            validatorsToRun.push(\"required\");\n        }\n        if (this.metadata.maxLength) validatorsToRun.push(\"maxLength\");\n        if (this.metadata.minLength) {\n            validatorsToRun.push(\"minLength\");\n            argsMap[\"minLength\"] = this.metadata.minLength;\n        }\n        if (this.metadata.pattern) {\n            validatorsToRun.push(\"pattern\");\n            argsMap[\"pattern\"] = this.metadata.pattern;\n        }\n        if (this.metadata.minimum !== undefined || this.metadata.maximum !== undefined) {\n            validatorsToRun.push(\"range\");\n            argsMap[\"range\"] = { min: this.metadata.minimum, max: this.metadata.maximum };\n        }\n        \n        const format = this.metadata.ui?.format;\n        if (format === \"email\" || format === \"url\" || format === \"iban\") {\n            validatorsToRun.push(format);\n        }\n\n        if (this.metadata.ui?.validators) {\n            for (const v of this.metadata.ui.validators) {\n                if (typeof v === \"string\") {\n                    validatorsToRun.push(v);\n                } else if (v && v.name) {\n                    validatorsToRun.push(v.name);\n                    if (v.args !== undefined) {\n                        argsMap[v.name] = v.args;\n                    }\n                }\n            }\n        }\n\n        if (validatorsToRun.length === 0) {\n            return { isValid: true, errorMessage: undefined, fieldKey: this.fieldKey };\n        }\n\n        const val = this.getValue();\n        const result = GlobalPipeline.executeValidation(val, validatorsToRun, argsMap);\n        return { isValid: result.isValid, errorMessage: result.errorMessage, fieldKey: this.fieldKey };\n    }\n\n    /**\n     * Natively manipulates the UI5 control's valueState if the control supports it.\n     * Uses reflection to safely apply styles without crashing on structural controls.\n     */\n    public setVisualValidationState(isValid: boolean, errorMessage?: string): void {\n        if (!this.control) return;\n\n        \n        // Use reflection to check if the control supports ValueState (e.g. sap.m.Input does, sap.m.Text does not)\n        type StateControl = {\n            setValueState?: (state: string) => void;\n            setValueStateText?: (text: string) => void;\n        };\n        const ctrl = this.control as unknown as StateControl;\n        if (typeof ctrl.setValueState === \"function\") {\n            ctrl.setValueState(isValid ? coreLibrary.ValueState.None : coreLibrary.ValueState.Error);\n            \n            if (typeof ctrl.setValueStateText === \"function\") {\n                ctrl.setValueStateText(isValid ? \"\" : (errorMessage || \"\"));\n            }\n        } else {\n            Logger.error(\"[MetaUI]\", `Plugin ${this.fieldKey} has no setValueState function!`, \"BasePlugin\");\n        }\n    }\n\n    /**\n     * Wraps standard validation and immediately applies the visual state.\n     * Ideal for 'change' events to instantly turn fields red on blur.\n     */\n    protected validateAndApplyVisualState(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        const result = this.validate();\n        this.setVisualValidationState(result.isValid, result.errorMessage);\n        return result;\n    }\n\n    /**\n     * Executes when the condition engine pushes new schema metadata to this field (e.g. readOnly changing).\n     * @param newMetadata The mutated schema metadata.\n     */\n    public onStateChange(newMetadata: IPropertyMetadata): void {\n        this.metadata = newMetadata;\n        this.applyState();\n    }\n\n    /**\n     * Abstract hook for the plugin to apply state changes to its specific UI5 control (e.g. placeholders, labels).\n     */\n    protected abstract applyState(): void;\n\n    /**\n     * Helper to apply common UI directives (like readOnly, visibleOn) directly to any control.\n     */\n    protected applyCommonDirectives(control: Control, metadata: IPropertyMetadata, modelName: string = \"meta\"): void {\n        const ctrl = control as unknown as { setEditable?: (b: boolean) => void, setEnabled?: (b: boolean) => void };\n        if (metadata.ui?.readOnly !== undefined && typeof ctrl.setEditable === \"function\") {\n            ctrl.setEditable(!metadata.ui.readOnly);\n        }\n\n        if (metadata.ui?.visibleOn) {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.visibleOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.visibleOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"visible\", { parts: [{ path: \"meta>/\" }], formatter: () => false });\n            control.bindProperty(\"visible\", expr);\n        }\n\n        if (metadata.ui?.enabledOn && typeof ctrl.setEnabled === \"function\") {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.enabledOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.enabledOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"enabled\", expr);\n        }\n    }\n\n\n\n    /**\n     * Natively destroys the instantiated UI5 control to prevent memory leaks.\n     * Can be overridden by subclasses if they manage secondary controls or custom models.\n     */\n    public destroy(): void {\n        if (this.control && typeof this.control.destroy === \"function\") {\n            this.control.destroy();\n            this.control = null;\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"BasePlugin.js","names":["GlobalPipeline","____core_PipelineManager","Logger","____utils_Logger","BasePlugin","control","BLOCKED_PROPS","metadata","fieldKey","modelName","isEditable","useMessageManager","policyInvalidMessage","setEditable","editable","this","setUseMessageManager","generateStableId","engineScopeId","bindingPath","undefined","safePath","replace","generateBindingInfo","typeInstance","additionalOptions","path","model","type","validate","isValid","getVisible","errorMessage","validatorsToRun","argsMap","maxLength","isRequired","_isDynamicallyRequired","required","push","minLength","pattern","minimum","maximum","min","max","format","ui","validators","v","name","args","length","val","getValue","result","executeValidation","fieldLabel","label","setVisualValidationState","ctrl","setValueState","coreLibrary","ValueState","None","Error","setValueStateText","applyError","clearError","applyVisibility","isVisible","setVisible","applyRequired","setRequired","applyEditable","setEnabled","onStateChange","newMetadata","applyState","applyCommonDirectives","readOnly","visibleOn","ExpressionBuilder","sap","require","expr","build","bindProperty","parts","formatter","enabledOn","controlProps","console","error","targetControl","mainControl","target","getMetadata","targetMeta","settings","propName","propValue","Object","entries","includes","warn","hasAggregation","hasEvent","startsWith","endsWith","injectedValue","applySettings","err","getName","message","destroy","__exports","__esModule"],"sources":["BasePlugin.ts"],"sourcesContent":["/**\n * @file BasePlugin.ts\n * @description Abstract foundation for all MetaUI plugins, enforcing lifecycle hooks for v2 Schema.\n */\n\nimport { IPlugin } from \"../../interfaces/IPlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport { GlobalPipeline } from \"../../core/PipelineManager\";\nimport * as coreLibrary from \"sap/ui/core/library\";\nimport { Logger } from \"../../utils/Logger\";\n\n/**\n * Abstract class representing a standard MetaUI Plugin.\n * Enforces the required rendering, state extraction, and validation contracts.\n * \n * @abstract\n * @public\n */\nexport abstract class BasePlugin implements IPlugin {\n    /** The instantiated UI5 control for this plugin. */\n    protected control: Control | null = null;\n\n    /** Explicit reference to the core data widget when this plugin is wrapped in a layout. */\n    protected mainControl?: Control;\n\n    /** Properties strictly protected by the Sandbox engine. */\n    protected BLOCKED_PROPS = [\"value\", \"text\", \"selectedKey\", \"selected\", \"dateValue\", \"editable\", \"enabled\", \"visible\", \"valueState\", \"valueStateText\", \"items\", \"content\", \"pages\", \"formElements\", \"change\", \"press\", \"select\", \"submit\"];\n\n    /** The metadata schema defining the field rules. */\n    protected metadata: IPropertyMetadata | null = null;\n\n    /** The internal JSON path of the field relative to its parent payload. */\n    protected fieldKey: string = \"\";\n\n    /** The UI5 JSONModel name used for absolute binding paths. */\n    protected modelName: string = \"meta\";\n\n    /** Indicates if the engine is enforcing an editable mode. */\n    protected isEditable: boolean = true;\n\n    /** Indicates if the plugin should delegate visual validation to the MessageManager. */\n    protected useMessageManager: boolean = false;\n\n    /** Internal callback provided by GeneratorHost to signal validation/data changes upwards */\n    protected onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /** \n     * Tracks explicitly forced invalid states pushed down from the PolicyEngine.\n     * When populated, this error takes absolute precedence over static SchemaValidator rules.\n     */\n    protected policyInvalidMessage: string | null = null;\n\n    /** Transient state tracking for PBRE required evaluations to prevent schema clobbering */\n    protected _isDynamicallyRequired?: boolean;\n\n    /**\n     * Injects the global editable mode context into the plugin before rendering.\n     * @param editable True if the plugin should render in editable mode.\n     */\n    public setEditable(editable: boolean): void {\n        this.isEditable = editable;\n    }\n\n    /**\n     * Injects the global MessageManager context into the plugin.\n     * @param useMessageManager True if the MessageManager is handling validation visual states.\n     */\n    public setUseMessageManager(useMessageManager: boolean): void {\n        this.useMessageManager = useMessageManager;\n    }\n\n    /**\n     * Instantiates the raw UI5 control and binds it to the model.\n     * \n     * @param fieldMetadata The JSON Schema for the field.\n     * @param bindingPath The JSON path to bind to.\n     * @param modelName The UI5 model name.\n     * @param engineScopeId The deterministic scope ID provided by the Engine to prevent cloning collisions.\n     * @param onChange The callback fired natively when a field value blur/change occurs.\n     * @returns {Control} The generated UI5 control.\n     */\n    public abstract render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void, model?: unknown): Control;\n\n    /**\n     * Generates a deterministic, globally unique ID for this control.\n     * Prefixes the sanitized binding path with the Engine's scoped ID.\n     */\n    protected generateStableId(engineScopeId: string | undefined, bindingPath: string): string | undefined {\n        if (!engineScopeId) return undefined;\n        // Strip leading slash and replace internal slashes with hyphens\n        const safePath = bindingPath.replace(/^\\//, '').replace(/\\//g, '-');\n        return `${engineScopeId}--${safePath}`;\n    }\n\n    /**\n     * Extracts the current raw value from the underlying UI5 control.\n     */\n    protected abstract getValue(): unknown;\n\n    /**\n     * Generates a standardized programmatic binding configuration object.\n     * Ensures perfect architectural consistency across all plugins instead of relying on string parsing.\n     * \n     * @param bindingPath The relative or absolute path.\n     * @param modelName The target model name.\n     * @param typeInstance An optional UI5 Type instance (e.g. Integer, Float).\n     * @param additionalOptions Optional extra configurations (e.g. formatOptions, constraints).\n     * @returns A configuration object ready to be assigned to 'value', 'text', 'state', etc.\n     */\n    protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): any {\n        return {\n            path: bindingPath,\n            model: modelName,\n            ...(typeInstance ? { type: typeInstance } : {}),\n            ...(additionalOptions || {})\n        };\n    }\n\n    /**\n     * Universal pipeline validation.\n     */\n    public validate(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        if (!this.control || !this.metadata) return { isValid: true };\n\n        // Skip validation for hidden fields (e.g. hidden by ConditionEngine visibleOn)\n        if (typeof (this.control as Control).getVisible === \"function\") {\n            if (!(this.control as Control).getVisible()) {\n                return { isValid: true };\n            }\n        }\n\n        if (this.policyInvalidMessage) {\n            return { isValid: false, errorMessage: this.policyInvalidMessage, fieldKey: this.fieldKey };\n        }\n\n        const validatorsToRun: string[] = [];\n        const argsMap: Record<string, unknown> = {\n            \"maxLength\": this.metadata.maxLength\n        };\n\n        const isRequired = this._isDynamicallyRequired !== undefined ? this._isDynamicallyRequired : this.metadata.required;\n        if (isRequired) {\n            validatorsToRun.push(\"required\");\n        }\n        if (this.metadata.maxLength) validatorsToRun.push(\"maxLength\");\n        if (this.metadata.minLength) {\n            validatorsToRun.push(\"minLength\");\n            argsMap[\"minLength\"] = this.metadata.minLength;\n        }\n        if (this.metadata.pattern) {\n            validatorsToRun.push(\"pattern\");\n            argsMap[\"pattern\"] = this.metadata.pattern;\n        }\n        if (this.metadata.minimum !== undefined || this.metadata.maximum !== undefined) {\n            validatorsToRun.push(\"range\");\n            argsMap[\"range\"] = { min: this.metadata.minimum, max: this.metadata.maximum };\n        }\n\n        const format = this.metadata.ui?.format;\n        if (format === \"email\" || format === \"url\" || format === \"iban\") {\n            validatorsToRun.push(format);\n        }\n\n        if (this.metadata.ui?.validators) {\n            for (const v of this.metadata.ui.validators) {\n                if (typeof v === \"string\") {\n                    validatorsToRun.push(v);\n                } else if (v && v.name) {\n                    validatorsToRun.push(v.name);\n                    if (v.args !== undefined) {\n                        argsMap[v.name] = v.args;\n                    }\n                }\n            }\n        }\n\n        if (validatorsToRun.length === 0) {\n            return { isValid: true, errorMessage: undefined, fieldKey: this.fieldKey };\n        }\n\n        const val = this.getValue();\n        const result = GlobalPipeline.executeValidation(val, validatorsToRun, argsMap);\n        return { isValid: result.isValid, errorMessage: result.errorMessage, fieldKey: this.fieldKey, fieldLabel: this.metadata?.ui?.label };\n    }\n\n    /**\n     * Natively manipulates the UI5 control's valueState if the control supports it.\n     * Uses reflection to safely apply styles without crashing on structural controls.\n     */\n    public setVisualValidationState(isValid: boolean, errorMessage?: string): void {\n        if (!this.control) return;\n\n\n        // Use reflection to check if the control supports ValueState (e.g. sap.m.Input does, sap.m.Text does not)\n        type StateControl = {\n            setValueState?: (state: string) => void;\n            setValueStateText?: (text: string) => void;\n        };\n        const ctrl = this.control as unknown as StateControl;\n        if (typeof ctrl.setValueState === \"function\") {\n            ctrl.setValueState(isValid ? coreLibrary.ValueState.None : coreLibrary.ValueState.Error);\n\n            if (typeof ctrl.setValueStateText === \"function\") {\n                ctrl.setValueStateText(isValid ? \"\" : (errorMessage || \"\"));\n            }\n        } else {\n            // Quietly ignore. Controls like sap.m.Text natively do not support value states, which is completely valid.\n        }\n    }\n\n\n\n    // --- IPluginStateReceiver Implementation for PBRE ---\n\n    /**\n     * Natively applies a forced error state from the PolicyEngine.\n     * Per MetaUI Architecture Rule 12, this explicitly forces the visual state red \n     * independently of the MessageManager auto-sync.\n     * \n     * @param errorMessage The custom error message to display.\n     */\n    public applyError(errorMessage: string): void {\n        this.policyInvalidMessage = errorMessage;\n        this.setVisualValidationState(false, errorMessage);\n    }\n\n    /**\n     * Clears a previously forced error state.\n     * Restores the visual boundary to standard (non-error) formatting.\n     */\n    public clearError(): void {\n        this.policyInvalidMessage = null;\n        this.setVisualValidationState(true);\n    }\n\n    /**\n     * Dynamically manipulates the visibility state of the control based on PolicyEngine directives.\n     * \n     * @param isVisible True to display the control, false to hide it.\n     */\n    public applyVisibility(isVisible: boolean): void {\n        const ctrl = this.control as unknown as { setVisible?: (b: boolean) => void };\n        if (ctrl && typeof ctrl.setVisible === \"function\") {\n            ctrl.setVisible(isVisible);\n        }\n    }\n\n    /**\n     * Dynamically alters the mandatory status of the field.\n     * Updates internal transient state to ensure the `validate()` pipeline enforces the change,\n     * and natively triggers the UI5 required indicator (asterisk) if supported,\n     * without permanently corrupting the shared global schema definition.\n     * \n     * @param isRequired True to make the field mandatory, false to make it optional.\n     */\n    public applyRequired(isRequired: boolean): void {\n        this._isDynamicallyRequired = isRequired;\n        const ctrl = this.control as unknown as { setRequired?: (b: boolean) => void };\n        if (ctrl && typeof ctrl.setRequired === \"function\") {\n            ctrl.setRequired(isRequired);\n        }\n    }\n\n    /**\n     * Dynamically alters the editability of the field.\n     * Falls back to `setEnabled` if the control is structural rather than purely input-driven.\n     * \n     * @param isEditable True to allow user input, false to lock it.\n     */\n    public applyEditable(isEditable: boolean): void {\n        const ctrl = this.control as unknown as { setEditable?: (b: boolean) => void, setEnabled?: (b: boolean) => void };\n        if (ctrl && typeof ctrl.setEditable === \"function\") {\n            ctrl.setEditable(isEditable);\n        } else if (ctrl && typeof ctrl.setEnabled === \"function\") {\n            ctrl.setEnabled(isEditable);\n        }\n    }\n\n    /**\n     * Executes when the condition engine pushes new schema metadata to this field (e.g. readOnly changing).\n     * @param newMetadata The mutated schema metadata.\n     */\n    public onStateChange(newMetadata: IPropertyMetadata): void {\n        this.metadata = newMetadata;\n        this.applyState();\n    }\n\n    /**\n     * Abstract hook for the plugin to apply state changes to its specific UI5 control (e.g. placeholders, labels).\n     */\n    protected abstract applyState(): void;\n\n    /**\n     * Helper to apply common UI directives (like readOnly, visibleOn) directly to any control.\n     */\n    protected applyCommonDirectives(control: Control, metadata: IPropertyMetadata, modelName: string = \"meta\"): void {\n        const ctrl = control as unknown as { setEditable?: (b: boolean) => void, setEnabled?: (b: boolean) => void };\n        if (metadata.ui?.readOnly !== undefined && typeof ctrl.setEditable === \"function\") {\n            ctrl.setEditable(!metadata.ui.readOnly);\n        }\n\n        if (metadata.ui?.visibleOn) {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.visibleOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.visibleOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"visible\", { parts: [{ path: \"meta>/\" }], formatter: () => false });\n            control.bindProperty(\"visible\", expr);\n        }\n\n        if (metadata.ui?.enabledOn && typeof ctrl.setEnabled === \"function\") {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.enabledOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.enabledOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"enabled\", expr);\n        }\n\n        if (metadata.ui?.controlProps) {\n            console.error(`[DEBUG MetaUI] controlProps found for ${this.fieldKey}`, metadata.ui.controlProps);\n            const targetControl = this.mainControl || control;\n            const target = targetControl as unknown as {\n                getMetadata?: () => { getName(): string },\n                applySettings?: (settings: Record<string, any>) => void,\n                setProperty?: (p: string, v: unknown) => void,\n                bindProperty?: (p: string, v: string) => void\n            };\n\n            if (typeof target.getMetadata === \"function\") {\n                const targetMeta = target.getMetadata();\n                const settings: Record<string, any> = {};\n                for (const [propName, propValue] of Object.entries(metadata.ui.controlProps)) {\n                    if (this.BLOCKED_PROPS.includes(propName)) {\n                        Logger.warn(`[BasePlugin] Cannot apply controlProps '${propName}' for field '${this.fieldKey}' - ILLEGAL OVERRIDE (Property is protected by sandbox)`);\n                        continue;\n                    }\n                    \n                    // Natively block any aggregations or events to prevent sandbox escapes\n                    if (typeof (targetMeta as any).hasAggregation === \"function\" && (targetMeta as any).hasAggregation(propName)) {\n                        Logger.warn(`[BasePlugin] Cannot apply controlProps '${propName}' for field '${this.fieldKey}' - ILLEGAL OVERRIDE (Cannot hijack aggregations)`);\n                        continue;\n                    }\n                    \n                    if (typeof (targetMeta as any).hasEvent === \"function\" && (targetMeta as any).hasEvent(propName)) {\n                        Logger.warn(`[BasePlugin] Cannot apply controlProps '${propName}' for field '${this.fieldKey}' - ILLEGAL OVERRIDE (Cannot hijack events)`);\n                        continue;\n                    }\n\n                    if (typeof propValue === \"string\" && propValue.startsWith(\"{\") && propValue.endsWith(\"}\")) {\n                        // The JSON payloads often hardcode 'metaui>' in raw expression bindings, \n                        // but the Engine dynamically generates model names like 'metaUI_Host1'. \n                        // We must inject the actual modelName dynamically into the expression string.\n                        const injectedValue = propValue.replace(/metaui>/g, `${modelName}>`);\n                        settings[propName] = injectedValue;\n                    } else {\n                        settings[propName] = propValue;\n                    }\n                }\n\n                try {\n                    const target = targetControl as unknown as { applySettings?: (s: Record<string, any>) => void };\n                    if (typeof target.applySettings === \"function\") {\n                        target.applySettings(settings);\n                    }\n                } catch (err: unknown) {\n                    Logger.warn(`[BasePlugin] Failed to apply controlProps for field '${this.fieldKey}' on control ${targetMeta.getName()}: ${(err as Error).message}`);\n                }\n            }\n        }\n    }\n\n\n\n    /**\n     * Natively destroys the instantiated UI5 control to prevent memory leaks.\n     * Can be overridden by subclasses if they manage secondary controls or custom models.\n     */\n    public destroy(): void {\n        if (this.control && typeof this.control.destroy === \"function\") {\n            this.control.destroy();\n            this.control = null;\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -7,7 +7,7 @@ import { IPlugin } from "../../interfaces/IPlugin";
 import { IPropertyMetadata } from "../../interfaces/ISchema";
 import Control from "sap/ui/core/Control";
 import { GlobalPipeline } from "../../core/PipelineManager";
-import coreLibrary from "sap/ui/core/library";
+import * as coreLibrary from "sap/ui/core/library";
 import { Logger } from "../../utils/Logger";
 
 /**
@@ -21,6 +21,12 @@ export abstract class BasePlugin implements IPlugin {
     /** The instantiated UI5 control for this plugin. */
     protected control: Control | null = null;
 
+    /** Explicit reference to the core data widget when this plugin is wrapped in a layout. */
+    protected mainControl?: Control;
+
+    /** Properties strictly protected by the Sandbox engine. */
+    protected BLOCKED_PROPS = ["value", "text", "selectedKey", "selected", "dateValue", "editable", "enabled", "visible", "valueState", "valueStateText", "items", "content", "pages", "formElements", "change", "press", "select", "submit"];
+
     /** The metadata schema defining the field rules. */
     protected metadata: IPropertyMetadata | null = null;
 
@@ -39,6 +45,15 @@ export abstract class BasePlugin implements IPlugin {
     /** Internal callback provided by GeneratorHost to signal validation/data changes upwards */
     protected onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;
 
+    /** 
+     * Tracks explicitly forced invalid states pushed down from the PolicyEngine.
+     * When populated, this error takes absolute precedence over static SchemaValidator rules.
+     */
+    protected policyInvalidMessage: string | null = null;
+
+    /** Transient state tracking for PBRE required evaluations to prevent schema clobbering */
+    protected _isDynamicallyRequired?: boolean;
+
     /**
      * Injects the global editable mode context into the plugin before rendering.
      * @param editable True if the plugin should render in editable mode.
@@ -65,7 +80,7 @@ export abstract class BasePlugin implements IPlugin {
      * @param onChange The callback fired natively when a field value blur/change occurs.
      * @returns {Control} The generated UI5 control.
      */
-    public abstract render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void, model?: unknown): Control;
+    public abstract render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void, model?: unknown): Control;
 
     /**
      * Generates a deterministic, globally unique ID for this control.
@@ -93,7 +108,7 @@ export abstract class BasePlugin implements IPlugin {
      * @param additionalOptions Optional extra configurations (e.g. formatOptions, constraints).
      * @returns A configuration object ready to be assigned to 'value', 'text', 'state', etc.
      */
-    protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): { path: string, model: string, type?: unknown, [key: string]: unknown } {
+    protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): any {
         return {
             path: bindingPath,
             model: modelName,
@@ -115,12 +130,17 @@ export abstract class BasePlugin implements IPlugin {
             }
         }
 
+        if (this.policyInvalidMessage) {
+            return { isValid: false, errorMessage: this.policyInvalidMessage, fieldKey: this.fieldKey };
+        }
+
         const validatorsToRun: string[] = [];
         const argsMap: Record<string, unknown> = {
             "maxLength": this.metadata.maxLength
         };
 
-        if (this.metadata.required) {
+        const isRequired = this._isDynamicallyRequired !== undefined ? this._isDynamicallyRequired : this.metadata.required;
+        if (isRequired) {
             validatorsToRun.push("required");
         }
         if (this.metadata.maxLength) validatorsToRun.push("maxLength");
@@ -136,7 +156,7 @@ export abstract class BasePlugin implements IPlugin {
             validatorsToRun.push("range");
             argsMap["range"] = { min: this.metadata.minimum, max: this.metadata.maximum };
         }
-        
+
         const format = this.metadata.ui?.format;
         if (format === "email" || format === "url" || format === "iban") {
             validatorsToRun.push(format);
@@ -161,7 +181,7 @@ export abstract class BasePlugin implements IPlugin {
 
         const val = this.getValue();
         const result = GlobalPipeline.executeValidation(val, validatorsToRun, argsMap);
-        return { isValid: result.isValid, errorMessage: result.errorMessage, fieldKey: this.fieldKey };
+        return { isValid: result.isValid, errorMessage: result.errorMessage, fieldKey: this.fieldKey, fieldLabel: this.metadata?.ui?.label };
     }
 
     /**
@@ -171,7 +191,7 @@ export abstract class BasePlugin implements IPlugin {
     public setVisualValidationState(isValid: boolean, errorMessage?: string): void {
         if (!this.control) return;
 
-        
+
         // Use reflection to check if the control supports ValueState (e.g. sap.m.Input does, sap.m.Text does not)
         type StateControl = {
             setValueState?: (state: string) => void;
@@ -180,23 +200,81 @@ export abstract class BasePlugin implements IPlugin {
         const ctrl = this.control as unknown as StateControl;
         if (typeof ctrl.setValueState === "function") {
             ctrl.setValueState(isValid ? coreLibrary.ValueState.None : coreLibrary.ValueState.Error);
-            
+
             if (typeof ctrl.setValueStateText === "function") {
                 ctrl.setValueStateText(isValid ? "" : (errorMessage || ""));
             }
         } else {
-            Logger.error("[MetaUI]", `Plugin ${this.fieldKey} has no setValueState function!`, "BasePlugin");
+            // Quietly ignore. Controls like sap.m.Text natively do not support value states, which is completely valid.
+        }
+    }
+
+
+
+    // --- IPluginStateReceiver Implementation for PBRE ---
+
+    /**
+     * Natively applies a forced error state from the PolicyEngine.
+     * Per MetaUI Architecture Rule 12, this explicitly forces the visual state red 
+     * independently of the MessageManager auto-sync.
+     * 
+     * @param errorMessage The custom error message to display.
+     */
+    public applyError(errorMessage: string): void {
+        this.policyInvalidMessage = errorMessage;
+        this.setVisualValidationState(false, errorMessage);
+    }
+
+    /**
+     * Clears a previously forced error state.
+     * Restores the visual boundary to standard (non-error) formatting.
+     */
+    public clearError(): void {
+        this.policyInvalidMessage = null;
+        this.setVisualValidationState(true);
+    }
+
+    /**
+     * Dynamically manipulates the visibility state of the control based on PolicyEngine directives.
+     * 
+     * @param isVisible True to display the control, false to hide it.
+     */
+    public applyVisibility(isVisible: boolean): void {
+        const ctrl = this.control as unknown as { setVisible?: (b: boolean) => void };
+        if (ctrl && typeof ctrl.setVisible === "function") {
+            ctrl.setVisible(isVisible);
+        }
+    }
+
+    /**
+     * Dynamically alters the mandatory status of the field.
+     * Updates internal transient state to ensure the `validate()` pipeline enforces the change,
+     * and natively triggers the UI5 required indicator (asterisk) if supported,
+     * without permanently corrupting the shared global schema definition.
+     * 
+     * @param isRequired True to make the field mandatory, false to make it optional.
+     */
+    public applyRequired(isRequired: boolean): void {
+        this._isDynamicallyRequired = isRequired;
+        const ctrl = this.control as unknown as { setRequired?: (b: boolean) => void };
+        if (ctrl && typeof ctrl.setRequired === "function") {
+            ctrl.setRequired(isRequired);
         }
     }
 
     /**
-     * Wraps standard validation and immediately applies the visual state.
-     * Ideal for 'change' events to instantly turn fields red on blur.
+     * Dynamically alters the editability of the field.
+     * Falls back to `setEnabled` if the control is structural rather than purely input-driven.
+     * 
+     * @param isEditable True to allow user input, false to lock it.
      */
-    protected validateAndApplyVisualState(): import("../../interfaces/IPlugin").IPluginValidationResult {
-        const result = this.validate();
-        this.setVisualValidationState(result.isValid, result.errorMessage);
-        return result;
+    public applyEditable(isEditable: boolean): void {
+        const ctrl = this.control as unknown as { setEditable?: (b: boolean) => void, setEnabled?: (b: boolean) => void };
+        if (ctrl && typeof ctrl.setEditable === "function") {
+            ctrl.setEditable(isEditable);
+        } else if (ctrl && typeof ctrl.setEnabled === "function") {
+            ctrl.setEnabled(isEditable);
+        }
     }
 
     /**
@@ -244,6 +322,58 @@ export abstract class BasePlugin implements IPlugin {
             }
             control.bindProperty("enabled", expr);
         }
+
+        if (metadata.ui?.controlProps) {
+            console.error(`[DEBUG MetaUI] controlProps found for ${this.fieldKey}`, metadata.ui.controlProps);
+            const targetControl = this.mainControl || control;
+            const target = targetControl as unknown as {
+                getMetadata?: () => { getName(): string },
+                applySettings?: (settings: Record<string, any>) => void,
+                setProperty?: (p: string, v: unknown) => void,
+                bindProperty?: (p: string, v: string) => void
+            };
+
+            if (typeof target.getMetadata === "function") {
+                const targetMeta = target.getMetadata();
+                const settings: Record<string, any> = {};
+                for (const [propName, propValue] of Object.entries(metadata.ui.controlProps)) {
+                    if (this.BLOCKED_PROPS.includes(propName)) {
+                        Logger.warn(`[BasePlugin] Cannot apply controlProps '${propName}' for field '${this.fieldKey}' - ILLEGAL OVERRIDE (Property is protected by sandbox)`);
+                        continue;
+                    }
+                    
+                    // Natively block any aggregations or events to prevent sandbox escapes
+                    if (typeof (targetMeta as any).hasAggregation === "function" && (targetMeta as any).hasAggregation(propName)) {
+                        Logger.warn(`[BasePlugin] Cannot apply controlProps '${propName}' for field '${this.fieldKey}' - ILLEGAL OVERRIDE (Cannot hijack aggregations)`);
+                        continue;
+                    }
+                    
+                    if (typeof (targetMeta as any).hasEvent === "function" && (targetMeta as any).hasEvent(propName)) {
+                        Logger.warn(`[BasePlugin] Cannot apply controlProps '${propName}' for field '${this.fieldKey}' - ILLEGAL OVERRIDE (Cannot hijack events)`);
+                        continue;
+                    }
+
+                    if (typeof propValue === "string" && propValue.startsWith("{") && propValue.endsWith("}")) {
+                        // The JSON payloads often hardcode 'metaui>' in raw expression bindings, 
+                        // but the Engine dynamically generates model names like 'metaUI_Host1'. 
+                        // We must inject the actual modelName dynamically into the expression string.
+                        const injectedValue = propValue.replace(/metaui>/g, `${modelName}>`);
+                        settings[propName] = injectedValue;
+                    } else {
+                        settings[propName] = propValue;
+                    }
+                }
+
+                try {
+                    const target = targetControl as unknown as { applySettings?: (s: Record<string, any>) => void };
+                    if (typeof target.applySettings === "function") {
+                        target.applySettings(settings);
+                    }
+                } catch (err: unknown) {
+                    Logger.warn(`[BasePlugin] Failed to apply controlProps for field '${this.fieldKey}' on control ${targetMeta.getName()}: ${(err as Error).message}`);
+                }
+            }
+        }
     }