@siliconst/metaui 1.4.21 → 1.4.34

package/src/nz/co/siliconst/ui5/metaui/core/Engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"Engine.js","names":["ConditionEngine","___ConditionEngine","PluginRegistry","___PluginRegistry","Logger","___utils_Logger","DefaultLayoutGenerator","___DefaultLayoutGenerator","Engine","conditionEngine","activePlugins","isEditable","hasPartialRenderingErrors","useMessageManager","constructor","editable","pluginRegistry","this","getInstance","build","schema","model","modelName","onSubmit","engineScopeId","onChange","activeModel","isValid","fieldKey","errorMessage","controlId","handleEvent","ensureLayout","warn","layoutStrategy","type","layoutManager","getLayout","render","error","msg","message","showErrorPopup","Text","text","generateField","fieldMeta","bindingPath","isTemplate","plugin","getPlugin","ui","widget","setEditable","setUseMessageManager","push","path","scopeId","undefined","control","registerPlugin","generateLayout","validateAll","applyVisualState","errors","item","result","validate","setVisualValidationState","replace","name","getPluginByPath","cleanPath","startsWith","match","find","p","destroy","messageManager","Messaging","existingMessages","getMessageModel","getData","messagesToRemove","targetPath","matched","filter","getTarget","getMessageProcessor","getId","length","removeMessages","__exports","__esModule"],"sources":["Engine.ts"],"sourcesContent":["/**\n * @file Engine.ts\n * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { IPlugin, IPluginValidationResult } from \"../interfaces/IPlugin\";\nimport { ConditionEngine } from \"./ConditionEngine\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport Control from \"sap/ui/core/Control\";\nimport VBox from \"sap/m/VBox\";\nimport Text from \"sap/m/Text\";\nimport { Logger } from \"../utils/Logger\";\nimport { DefaultLayoutGenerator } from \"./DefaultLayoutGenerator\";\nimport Core from \"sap/ui/core/Core\";\nimport Messaging from \"sap/ui/core/Messaging\";\n\n/**\n * The Engine is responsible for translating a normalized schema into a physical UI5 layout.\n * It delegates layout generation to the configured `LayoutManager` and field generation to the `PluginRegistry`.\n * It strictly routes execution flow and tracks active plugins for validation.\n * It embodies the \"Plugin-First Philosophy\" by routing all complex field and layout rendering\n * through discrete, decoupled plugins rather than handling native overrides.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class Engine {\n    /** Handles dynamic conditional logic across the active form. */\n    private conditionEngine: ConditionEngine | null = null;\n\n    /** Array of all instantiated plugins generated during the current build. */\n    private activePlugins: { plugin: IPlugin, path: string }[] = [];\n\n    /** Deterministic scope ID injected by the host control to prevent clone collisions. */\n    public engineScopeId?: string;\n\n    private activeModel?: sap.ui.model.Model;\n\n    /** Reference to the GeneratorHost that instantiated this engine, for retrieving global definitions. */\n    public host?: unknown;\n\n    /** Callback to notify the host that an internal field changed. */\n    public onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /** Tracks whether the entire engine is running in Editable mode. */\n    public readonly isEditable: boolean = true;\n\n    /** Tracks if any fields or sub-layouts failed to render, requiring a warning strip. */\n    public hasPartialRenderingErrors: boolean = false;\n\n    /** Tracks whether the engine should delegate visual state to the global MessageManager. */\n    public readonly useMessageManager: boolean = false;\n\n    /** The injected PluginRegistry instance */\n    public readonly pluginRegistry: PluginRegistry;\n\n    /**\n     * Initializes a new Engine instance.\n     * @param editable Whether the engine should render form fields as editable or read-only.\n     * @param useMessageManager Whether to delegate visual state to UI5 MessageManager.\n     * @param pluginRegistry Optional injected plugin registry. Defaults to singleton.\n     */\n    constructor(editable: boolean = true, useMessageManager: boolean = false, pluginRegistry?: PluginRegistry) {\n        this.isEditable = editable;\n        this.useMessageManager = useMessageManager;\n        this.pluginRegistry = pluginRegistry || PluginRegistry.getInstance();\n    }\n\n    /**\n     * Bootstraps the layout generation process by resolving the correct layout strategy.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param model The active StateManager JSONModel instance.\n     * @param modelName The UI5 model alias used for isolation.\n     * @param onSubmit Callback fired when form is submitted.\n     * @param engineScopeId Deterministic scope ID for this engine instance.\n     * @param onChange Callback fired when field values change.\n     * @returns The generated root UI5 Control container.\n     */\n    public build(schema: ISchema, model: sap.ui.model.Model, modelName: string = \"meta\", onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control {\n        this.conditionEngine = new ConditionEngine(schema);\n        this.activePlugins = [];\n        this.activeModel = model;\n        this.engineScopeId = engineScopeId;\n        this.onChange = (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => {\n            if (this.conditionEngine && fieldKey) {\n                this.conditionEngine.handleEvent(fieldKey, isValid);\n            }\n            if (onChange) {\n                onChange(isValid, fieldKey, errorMessage, controlId);\n            }\n        };\n\n        try {\n            // Intercept and synthesize a default layout if the developer/backend failed to provide one\n            if (DefaultLayoutGenerator.ensureLayout(schema)) {\n                Logger.warn(\"[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.\");\n            }\n\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = this.pluginRegistry.getLayout(layoutStrategy);\n\n            return layoutManager.render(schema, modelName, this, onSubmit);\n        } catch (error) {\n            this.hasPartialRenderingErrors = true;\n            const msg = (error as Error).message;\n            Logger.error(\"[MetaUI Engine] Critical error during layout generation\", msg);\n            Logger.showErrorPopup(`Engine failed to generate the layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Layout Error\" });\n        }\n    }\n\n    /**\n     * Instantiates the correct plugin for a specific field based on type and widget hints,\n     * and tracks the plugin for global validation.\n     * \n     * @param fieldMeta The metadata schema specific to the field.\n     * @param bindingPath The JSON path representing the field within the payload.\n     * @param modelName The UI5 JSONModel name used for data binding.\n     * @returns The generated UI5 Control for the field.\n     */\n    public generateField(fieldMeta: IPropertyMetadata, bindingPath: string, modelName: string, isTemplate: boolean = false): Control {\n        try {\n            const plugin = this.pluginRegistry.getPlugin(fieldMeta.type || \"string\", fieldMeta.ui?.widget);\n            if (typeof plugin.setEditable === \"function\") {\n                plugin.setEditable(this.isEditable);\n            }\n\n            if (typeof plugin.setUseMessageManager === \"function\") {\n                plugin.setUseMessageManager(this.useMessageManager);\n            }\n\n            if (!isTemplate) {\n                this.activePlugins.push({ plugin, path: bindingPath });\n            }\n            const scopeId = isTemplate ? undefined : this.engineScopeId;\n            const control = plugin.render(fieldMeta, bindingPath, modelName, scopeId, this.onChange, this.activeModel);\n\n            if (this.conditionEngine) {\n                this.conditionEngine.registerPlugin(bindingPath, plugin);\n            }\n\n            return control;\n        } catch (error) {\n            this.hasPartialRenderingErrors = true;\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\\n\\nDetails: ${msg}`);\n            return new Text({ text: `[Error generating field ${bindingPath}]` });\n        }\n    }\n\n    /**\n     * Generates a sub-layout (like an embedded table or nested form) without \n     * destroying the current Engine state or Condition tracking.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param modelName The UI5 JSONModel name used for data binding (defaults to \"meta\").\n     * @param bindingPath Optional path to bind the sub-layout to a specific array/object property.\n     * @returns The generated root UI5 Control container.\n     */\n    public generateLayout(schema: ISchema, modelName: string, bindingPath?: string): Control {\n        try {\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = this.pluginRegistry.getLayout(layoutStrategy);\n            return layoutManager.render(schema, modelName, this, undefined, bindingPath);\n        } catch (error) {\n            this.hasPartialRenderingErrors = true;\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Engine failed to generate a sub-layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Sub-Layout Error\" });\n        }\n    }\n\n    /**\n     * Iterates through all active plugins and triggers their internal validation pipelines.\n     * \n     * @param applyVisualState If true, explicitly instructs the plugin to natively paint its own ValueState.\n     * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.\n     */\n    public validateAll(applyVisualState: boolean = false): IPluginValidationResult[] {\n        const errors: IPluginValidationResult[] = [];\n        for (const item of this.activePlugins) {\n            try {\n                const result = item.plugin.validate();\n                if (applyVisualState && typeof item.plugin.setVisualValidationState === \"function\") {\n                    item.plugin.setVisualValidationState(result.isValid, result.errorMessage);\n                }\n\n                if (!result.isValid) {\n                    // Ensure the path is bound to the error so GeneratorHost knows where to target it\n                    result.fieldKey = result.fieldKey || item.path.replace(/^\\//, \"\");\n                    errors.push(result);\n                    // Add console log to find which plugin fails silently\n                    Logger.error(\"[MetaUI Validation] Plugin failed validation silently:\", item.path || item.plugin.constructor.name);\n                }\n            } catch (error) {\n                Logger.error(`[MetaUI Engine] Error validating plugin at ${item.path}`, (error as Error).message);\n            }\n        }\n        return errors;\n    }\n\n    /**\n     * Retrieves an active plugin instance by its absolute binding path.\n     * Useful for programmatic field manipulation (e.g., custom error injection).\n     * \n     * @param path The binding path (e.g. \"/General/CustomerName\").\n     * @returns {IPlugin | undefined} The plugin instance, or undefined if not found.\n     */\n    public getPluginByPath(path: string): import(\"../interfaces/IPlugin\").IPlugin | undefined {\n        const cleanPath = path.startsWith(\"/\") ? path : `/${path}`;\n        const match = this.activePlugins.find(p => p.path === cleanPath || p.path === `/${cleanPath}`);\n        return match ? match.plugin : undefined;\n    }\n\n    /**\n     * Cleans up internal state and destroys the condition engine to prevent memory leaks.\n     */\n    public destroy(): void {\n        if (this.conditionEngine) {\n            this.conditionEngine.destroy();\n            this.conditionEngine = null;\n        }\n\n        // ------------------------------------------------------------------------\n        // Ghost Error Prevention\n        // Flush MessageManager for active plugins before destroying their controls\n        // ------------------------------------------------------------------------\n        const messageManager = Messaging;\n        const existingMessages = messageManager.getMessageModel().getData();\n        const messagesToRemove: unknown[] = [];\n\n        for (const item of this.activePlugins) {\n            if (this.activeModel) {\n                const targetPath = `/${item.path.replace(/^\\//, \"\")}`;\n                const matched = (existingMessages as { getTarget: () => string, getMessageProcessor: () => { getId: () => string } }[]).filter(msg =>\n                    msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.activeModel!.getId()\n                );\n                messagesToRemove.push(...matched);\n            }\n            if (typeof item.plugin.destroy === \"function\") {\n                item.plugin.destroy();\n            }\n        }\n\n        if (messagesToRemove.length > 0) {\n            messageManager.removeMessages(messagesToRemove);\n        }\n\n        this.activePlugins = [];\n    }\n}\n"],"mappings":"4KAAA,MAQSA,EAAeC,EAAA,yBACfC,EAAcC,EAAA,wBAIdC,EAAMC,EAAA,gBACNC,EAAsBC,EAAA,0BAcxB,MAAMC,EAEDC,gBAA0C,KAG1CC,cAAqD,GAc7CC,WAAsB,KAG/BC,0BAAqC,MAG5BC,kBAA6B,MAW7CC,YAAYC,EAAoB,KAAMF,EAA6B,MAAOG,GACtEC,KAAKN,WAAaI,EAClBE,KAAKJ,kBAAoBA,EACzBI,KAAKD,eAAiBA,GAAkBd,EAAegB,aAC3D,CAaOC,MAAMC,EAAiBC,EAA2BC,EAAoB,OAAQC,EAAuBC,EAAwBC,GAChIR,KAAKR,gBAAkB,IAAIT,EAAgBoB,GAC3CH,KAAKP,cAAgB,GACrBO,KAAKS,YAAcL,EACnBJ,KAAKO,cAAgBA,EACrBP,KAAKQ,SAAW,CAACE,EAAkBC,EAAmBC,EAAuBC,KACzE,GAAIb,KAAKR,iBAAmBmB,EAAU,CAClCX,KAAKR,gBAAgBsB,YAAYH,EAAUD,EAC/C,CACA,GAAIF,EAAU,CACVA,EAASE,EAASC,EAAUC,EAAcC,EAC9C,GAGJ,IAEI,GAAIxB,EAAuB0B,aAAaZ,GAAS,CAC7ChB,EAAO6B,KAAK,sHAChB,CAEA,MAAMC,EAAiBd,EAAOc,iBAAmBd,EAAOe,OAAS,QAAU,QAAU,QACrF,MAAMC,EAAgBnB,KAAKD,eAAeqB,UAAUH,GAEpD,OAAOE,EAAcE,OAAOlB,EAAQE,EAAWL,KAAMM,EACzD,CAAE,MAAOgB,GACLtB,KAAKL,0BAA4B,KACjC,MAAM4B,EAAOD,EAAgBE,QAC7BrC,EAAOmC,MAAM,0DAA2DC,GACxEpC,EAAOsC,eAAe,qDAAqDF,KAC3E,OAAO,IAAIG,EAAK,CAAEC,KAAM,yBAC5B,CACJ,CAWOC,cAAcC,EAA8BC,EAAqBzB,EAAmB0B,EAAsB,OAC7G,IACI,MAAMC,EAAShC,KAAKD,eAAekC,UAAUJ,EAAUX,MAAQ,SAAUW,EAAUK,IAAIC,QACvF,UAAWH,EAAOI,cAAgB,WAAY,CAC1CJ,EAAOI,YAAYpC,KAAKN,WAC5B,CAEA,UAAWsC,EAAOK,uBAAyB,WAAY,CACnDL,EAAOK,qBAAqBrC,KAAKJ,kBACrC,CAEA,IAAKmC,EAAY,CACb/B,KAAKP,cAAc6C,KAAK,CAAEN,SAAQO,KAAMT,GAC5C,CACA,MAAMU,EAAUT,EAAaU,UAAYzC,KAAKO,cAC9C,MAAMmC,EAAUV,EAAOX,OAAOQ,EAAWC,EAAazB,EAAWmC,EAASxC,KAAKQ,SAAUR,KAAKS,aAE9F,GAAIT,KAAKR,gBAAiB,CACtBQ,KAAKR,gBAAgBmD,eAAeb,EAAaE,EACrD,CAEA,OAAOU,CACX,CAAE,MAAOpB,GACLtB,KAAKL,0BAA4B,KACjC,MAAM4B,EAAOD,EAAgBE,QAC7BrC,EAAOmC,MAAM,+CAA+CQ,IAAeP,GAC3EpC,EAAOsC,eAAe,6BAA6BK,mBAA6BP,KAChF,OAAO,IAAIG,EAAK,CAAEC,KAAM,2BAA2BG,MACvD,CACJ,CAWOc,eAAezC,EAAiBE,EAAmByB,GACtD,IACI,MAAMb,EAAiBd,EAAOc,iBAAmBd,EAAOe,OAAS,QAAU,QAAU,QACrF,MAAMC,EAAgBnB,KAAKD,eAAeqB,UAAUH,GACpD,OAAOE,EAAcE,OAAOlB,EAAQE,EAAWL,KAAMyC,UAAWX,EACpE,CAAE,MAAOR,GACLtB,KAAKL,0BAA4B,KACjC,MAAM4B,EAAOD,EAAgBE,QAC7BrC,EAAOmC,MAAM,4DAA4DQ,IAAeP,GACxFpC,EAAOsC,eAAe,uDAAuDF,KAC7E,OAAO,IAAIG,EAAK,CAAEC,KAAM,6BAC5B,CACJ,CAQOkB,YAAYC,EAA4B,OAC3C,MAAMC,EAAoC,GAC1C,IAAK,MAAMC,KAAQhD,KAAKP,cAAe,CACnC,IACI,MAAMwD,EAASD,EAAKhB,OAAOkB,WAC3B,GAAIJ,UAA2BE,EAAKhB,OAAOmB,2BAA6B,WAAY,CAChFH,EAAKhB,OAAOmB,yBAAyBF,EAAOvC,QAASuC,EAAOrC,aAChE,CAEA,IAAKqC,EAAOvC,QAAS,CAEjBuC,EAAOtC,SAAWsC,EAAOtC,UAAYqC,EAAKT,KAAKa,QAAQ,MAAO,IAC9DL,EAAOT,KAAKW,GAEZ9D,EAAOmC,MAAM,yDAA0D0B,EAAKT,MAAQS,EAAKhB,OAAOnC,YAAYwD,KAChH,CACJ,CAAE,MAAO/B,GACLnC,EAAOmC,MAAM,8CAA8C0B,EAAKT,OAASjB,EAAgBE,QAC7F,CACJ,CACA,OAAOuB,CACX,CASOO,gBAAgBf,GACnB,MAAMgB,EAAYhB,EAAKiB,WAAW,KAAOjB,EAAO,IAAIA,IACpD,MAAMkB,EAAQzD,KAAKP,cAAciE,KAAKC,GAAKA,EAAEpB,OAASgB,GAAaI,EAAEpB,OAAS,IAAIgB,KAClF,OAAOE,EAAQA,EAAMzB,OAASS,SAClC,CAKOmB,UACH,GAAI5D,KAAKR,gBAAiB,CACtBQ,KAAKR,gBAAgBoE,UACrB5D,KAAKR,gBAAkB,IAC3B,CAMA,MAAMqE,EAAiBC,EACvB,MAAMC,EAAmBF,EAAeG,kBAAkBC,UAC1D,MAAMC,EAA8B,GAEpC,IAAK,MAAMlB,KAAQhD,KAAKP,cAAe,CACnC,GAAIO,KAAKS,YAAa,CAClB,MAAM0D,EAAa,IAAInB,EAAKT,KAAKa,QAAQ,MAAO,MAChD,MAAMgB,EAAWL,EAAuGM,OAAO9C,GAC3HA,EAAI+C,cAAgBH,GAAc5C,EAAIgD,uBAAyBhD,EAAIgD,sBAAsBC,UAAYxE,KAAKS,YAAa+D,SAE3HN,EAAiB5B,QAAQ8B,EAC7B,CACA,UAAWpB,EAAKhB,OAAO4B,UAAY,WAAY,CAC3CZ,EAAKhB,OAAO4B,SAChB,CACJ,CAEA,GAAIM,EAAiBO,OAAS,EAAG,CAC7BZ,EAAea,eAAeR,EAClC,CAEAlE,KAAKP,cAAgB,EACzB,EACH,IAAAkF,EAAA,CAAAC,WAAA,MAAAD,EAAApF,SAAA,OAAAoF,CAAA","ignoreList":[]}
+{"version":3,"file":"Engine.js","names":["ConditionEngine","___ConditionEngine","PluginRegistry","___PluginRegistry","Logger","___utils_Logger","DefaultLayoutGenerator","___DefaultLayoutGenerator","Engine","conditionEngine","activePlugins","isEditable","hasPartialRenderingErrors","useMessageManager","constructor","editable","pluginRegistry","this","getInstance","build","schema","model","modelName","onSubmit","engineScopeId","onChange","activeModel","isValid","fieldKey","errorMessage","controlId","handleEvent","layoutStrategy","type","layoutManager","getLayout","render","error","msg","message","showErrorPopup","Text","text","generateField","fieldMeta","bindingPath","isTemplate","plugin","getPlugin","ui","widget","setEditable","setUseMessageManager","push","path","scopeId","undefined","control","registerPlugin","generateLayout","ensureLayout","warn","validateAll","applyVisualState","errors","item","result","validate","setVisualValidationState","replace","name","getPluginByPath","cleanPath","startsWith","match","find","p","destroy","messageManager","Messaging","existingMessages","getMessageModel","getData","messagesToRemove","targetPath","matched","filter","getTarget","getMessageProcessor","getId","length","removeMessages","__exports","__esModule"],"sources":["Engine.ts"],"sourcesContent":["/**\n * @file Engine.ts\n * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { IPlugin, IPluginValidationResult } from \"../interfaces/IPlugin\";\nimport { ConditionEngine } from \"./ConditionEngine\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport Control from \"sap/ui/core/Control\";\nimport VBox from \"sap/m/VBox\";\nimport Text from \"sap/m/Text\";\nimport { Logger } from \"../utils/Logger\";\nimport { DefaultLayoutGenerator } from \"./DefaultLayoutGenerator\";\nimport Core from \"sap/ui/core/Core\";\nimport Messaging from \"sap/ui/core/Messaging\";\n\n/**\n * The Engine is responsible for translating a normalized schema into a physical UI5 layout.\n * It delegates layout generation to the configured `LayoutManager` and field generation to the `PluginRegistry`.\n * It strictly routes execution flow and tracks active plugins for validation.\n * It embodies the \"Plugin-First Philosophy\" by routing all complex field and layout rendering\n * through discrete, decoupled plugins rather than handling native overrides.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class Engine {\n    /** Handles dynamic conditional logic across the active form. */\n    private conditionEngine: ConditionEngine | null = null;\n\n    /** Array of all instantiated plugins generated during the current build. */\n    private activePlugins: { plugin: IPlugin, path: string }[] = [];\n\n    /** Deterministic scope ID injected by the host control to prevent clone collisions. */\n    public engineScopeId?: string;\n\n    private activeModel?: any;\n\n    /** Reference to the GeneratorHost that instantiated this engine, for retrieving global definitions. */\n    public host?: unknown;\n\n    /** Callback to notify the host that an internal field changed. */\n    public onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /** Tracks whether the entire engine is running in Editable mode. */\n    public readonly isEditable: boolean = true;\n\n    /** Tracks if any fields or sub-layouts failed to render, requiring a warning strip. */\n    public hasPartialRenderingErrors: boolean = false;\n\n    /** Tracks whether the engine should delegate visual state to the global MessageManager. */\n    public readonly useMessageManager: boolean = false;\n\n    /** The injected PluginRegistry instance */\n    public readonly pluginRegistry: PluginRegistry;\n\n    /**\n     * Initializes a new Engine instance.\n     * @param editable Whether the engine should render form fields as editable or read-only.\n     * @param useMessageManager Whether to delegate visual state to UI5 MessageManager.\n     * @param pluginRegistry Optional injected plugin registry. Defaults to singleton.\n     */\n    constructor(editable: boolean = true, useMessageManager: boolean = false, pluginRegistry?: PluginRegistry) {\n        this.isEditable = editable;\n        this.useMessageManager = useMessageManager;\n        this.pluginRegistry = pluginRegistry || PluginRegistry.getInstance();\n    }\n\n    /**\n     * Bootstraps the layout generation process by resolving the correct layout strategy.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param model The active StateManager JSONModel instance.\n     * @param modelName The UI5 model alias used for isolation.\n     * @param onSubmit Callback fired when form is submitted.\n     * @param engineScopeId Deterministic scope ID for this engine instance.\n     * @param onChange Callback fired when field values change.\n     * @returns The generated root UI5 Control container.\n     */\n    public build(schema: ISchema, model: any, modelName: string = \"meta\", onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control {\n        this.conditionEngine = new ConditionEngine(schema);\n        this.activePlugins = [];\n        this.activeModel = model;\n        this.engineScopeId = engineScopeId;\n        this.onChange = (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => {\n            if (this.conditionEngine && fieldKey) {\n                this.conditionEngine.handleEvent(fieldKey, isValid);\n            }\n            if (onChange) {\n                onChange(isValid, fieldKey, errorMessage, controlId);\n            }\n        };\n\n        try {\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = this.pluginRegistry.getLayout(layoutStrategy);\n\n            return layoutManager.render(schema, modelName, this, onSubmit);\n        } catch (error) {\n            this.hasPartialRenderingErrors = true;\n            const msg = (error as Error).message;\n            Logger.error(\"[MetaUI Engine] Critical error during layout generation\", msg);\n            Logger.showErrorPopup(`Engine failed to generate the layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Layout Error\" });\n        }\n    }\n\n    /**\n     * Instantiates the correct plugin for a specific field based on type and widget hints,\n     * and tracks the plugin for global validation.\n     * \n     * @param fieldMeta The metadata schema specific to the field.\n     * @param bindingPath The JSON path representing the field within the payload.\n     * @param modelName The UI5 JSONModel name used for data binding.\n     * @returns The generated UI5 Control for the field.\n     */\n    public generateField(fieldMeta: IPropertyMetadata, bindingPath: string, modelName: string, isTemplate: boolean = false): Control {\n        try {\n            const plugin = this.pluginRegistry.getPlugin(fieldMeta.type || \"string\", fieldMeta.ui?.widget);\n            if (typeof plugin.setEditable === \"function\") {\n                plugin.setEditable(this.isEditable);\n            }\n\n            if (typeof plugin.setUseMessageManager === \"function\") {\n                plugin.setUseMessageManager(this.useMessageManager);\n            }\n\n            if (!isTemplate) {\n                this.activePlugins.push({ plugin, path: bindingPath });\n            }\n            const scopeId = isTemplate ? undefined : this.engineScopeId;\n            const control = plugin.render(fieldMeta, bindingPath, modelName, scopeId, this.onChange, this.activeModel);\n\n            if (this.conditionEngine) {\n                this.conditionEngine.registerPlugin(bindingPath, plugin);\n            }\n\n            return control;\n        } catch (error) {\n            this.hasPartialRenderingErrors = true;\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\\n\\nDetails: ${msg}`);\n            return new Text({ text: `[Error generating field ${bindingPath}]` });\n        }\n    }\n\n    /**\n     * Generates a sub-layout (like an embedded table or nested form) without \n     * destroying the current Engine state or Condition tracking.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param modelName The UI5 JSONModel name used for data binding (defaults to \"meta\").\n     * @param bindingPath Optional path to bind the sub-layout to a specific array/object property.\n     * @returns The generated root UI5 Control container.\n     */\n    public generateLayout(schema: ISchema, modelName: string, bindingPath?: string): Control {\n        try {\n            if (DefaultLayoutGenerator.ensureLayout(schema)) {\n                Logger.warn(`[MetaUI Engine] Missing 'uiLayout' array in sub-schema for ${bindingPath}. Synthesized a default layout mapping.`);\n            }\n\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = this.pluginRegistry.getLayout(layoutStrategy);\n            return layoutManager.render(schema, modelName, this, undefined, bindingPath);\n        } catch (error) {\n            this.hasPartialRenderingErrors = true;\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Engine failed to generate a sub-layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Sub-Layout Error\" });\n        }\n    }\n\n    /**\n     * Iterates through all active plugins and triggers their internal validation pipelines.\n     * \n     * @param applyVisualState If true, explicitly instructs the plugin to natively paint its own ValueState.\n     * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.\n     */\n    public validateAll(applyVisualState: boolean = false): IPluginValidationResult[] {\n        const errors: IPluginValidationResult[] = [];\n        for (const item of this.activePlugins) {\n            try {\n                const result = item.plugin.validate();\n                if (applyVisualState && typeof item.plugin.setVisualValidationState === \"function\") {\n                    item.plugin.setVisualValidationState(result.isValid, result.errorMessage);\n                }\n\n                if (!result.isValid) {\n                    // Ensure the path is bound to the error so GeneratorHost knows where to target it\n                    result.fieldKey = result.fieldKey || item.path.replace(/^\\//, \"\");\n                    errors.push(result);\n                    // Add console log to find which plugin fails silently\n                    Logger.error(\"[MetaUI Validation] Plugin failed validation silently:\", item.path || item.plugin.constructor.name);\n                }\n            } catch (error) {\n                Logger.error(`[MetaUI Engine] Error validating plugin at ${item.path}`, (error as Error).message);\n            }\n        }\n        return errors;\n    }\n\n    /**\n     * Retrieves an active plugin instance by its absolute binding path.\n     * Useful for programmatic field manipulation (e.g., custom error injection).\n     * \n     * @param path The binding path (e.g. \"/General/CustomerName\").\n     * @returns {IPlugin | undefined} The plugin instance, or undefined if not found.\n     */\n    public getPluginByPath(path: string): import(\"../interfaces/IPlugin\").IPlugin | undefined {\n        const cleanPath = path.startsWith(\"/\") ? path : `/${path}`;\n        const match = this.activePlugins.find(p => p.path === cleanPath || p.path === `/${cleanPath}`);\n        return match ? match.plugin : undefined;\n    }\n\n    /**\n     * Cleans up internal state and destroys the condition engine to prevent memory leaks.\n     */\n    public destroy(): void {\n        if (this.conditionEngine) {\n            this.conditionEngine.destroy();\n            this.conditionEngine = null;\n        }\n\n        // ------------------------------------------------------------------------\n        // Ghost Error Prevention\n        // Flush MessageManager for active plugins before destroying their controls\n        // ------------------------------------------------------------------------\n        const messageManager = Messaging;\n        const existingMessages = messageManager.getMessageModel().getData();\n        const messagesToRemove: unknown[] = [];\n\n        for (const item of this.activePlugins) {\n            if (this.activeModel) {\n                const targetPath = `/${item.path.replace(/^\\//, \"\")}`;\n                const matched = (existingMessages as { getTarget: () => string, getMessageProcessor: () => { getId: () => string } }[]).filter(msg =>\n                    msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.activeModel!.getId()\n                );\n                messagesToRemove.push(...matched);\n            }\n            if (typeof item.plugin.destroy === \"function\") {\n                item.plugin.destroy();\n            }\n        }\n\n        if (messagesToRemove.length > 0) {\n            messageManager.removeMessages(messagesToRemove);\n        }\n\n        this.activePlugins = [];\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/Engine.ts

@@ -36,7 +36,7 @@ export class Engine {
     /** Deterministic scope ID injected by the host control to prevent clone collisions. */
     public engineScopeId?: string;
 
-    private activeModel?: sap.ui.model.Model;
+    private activeModel?: any;
 
     /** Reference to the GeneratorHost that instantiated this engine, for retrieving global definitions. */
     public host?: unknown;
@@ -79,7 +79,7 @@ export class Engine {
      * @param onChange Callback fired when field values change.
      * @returns The generated root UI5 Control container.
      */
-    public build(schema: ISchema, model: sap.ui.model.Model, modelName: string = "meta", onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control {
+    public build(schema: ISchema, model: any, modelName: string = "meta", onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control {
         this.conditionEngine = new ConditionEngine(schema);
         this.activePlugins = [];
         this.activeModel = model;
@@ -94,11 +94,6 @@ export class Engine {
         };
 
         try {
-            // Intercept and synthesize a default layout if the developer/backend failed to provide one
-            if (DefaultLayoutGenerator.ensureLayout(schema)) {
-                Logger.warn("[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.");
-            }
-
             const layoutStrategy = schema.layoutStrategy || (schema.type === "array" ? "table" : "form");
             const layoutManager = this.pluginRegistry.getLayout(layoutStrategy);
 
@@ -163,6 +158,10 @@ export class Engine {
      */
     public generateLayout(schema: ISchema, modelName: string, bindingPath?: string): Control {
         try {
+            if (DefaultLayoutGenerator.ensureLayout(schema)) {
+                Logger.warn(`[MetaUI Engine] Missing 'uiLayout' array in sub-schema for ${bindingPath}. Synthesized a default layout mapping.`);
+            }
+
             const layoutStrategy = schema.layoutStrategy || (schema.type === "array" ? "table" : "form");
             const layoutManager = this.pluginRegistry.getLayout(layoutStrategy);
             return layoutManager.render(schema, modelName, this, undefined, bindingPath);

package/src/nz/co/siliconst/ui5/metaui/core/LayoutMutator-dbg.js

@@ -0,0 +1,84 @@
+sap.ui.define(["./SchemaNormalizer", "../constants/MetaUIConstants"], function (___SchemaNormalizer, ___constants_MetaUIConstants) {
+  "use strict";
+
+  /**
+   * @file LayoutMutator.ts
+   * @description Intercepts the generated schema before rendering to dynamically mutate the UI layout based on inline rendering rules.
+   */
+  const SchemaNormalizer = ___SchemaNormalizer["SchemaNormalizer"];
+  const RENDER_MODE = ___constants_MetaUIConstants["RENDER_MODE"];
+  const SCHEMA_TYPE = ___constants_MetaUIConstants["SCHEMA_TYPE"];
+  class LayoutMutator {
+    /**
+     * Mutates the `uiLayout` array to expand nested inline objects into native Groups.
+     * @param schema The normalized root schema.
+     */
+    static apply(schema) {
+      if (!schema || !schema.uiLayout || !Array.isArray(schema.uiLayout)) {
+        return; // No layout to mutate
+      }
+      schema.uiLayout = this.expandElements(schema.uiLayout, schema);
+    }
+    static expandElements(elements, rootSchema) {
+      const expanded = [];
+      for (const element of elements) {
+        if (element.type === "Group") {
+          // Recursively expand group elements
+          if (element.elements) {
+            element.elements = this.expandElements(element.elements, rootSchema);
+          }
+          expanded.push(element);
+        } else if (element.type === "Control") {
+          if (!element.scope) {
+            expanded.push(element);
+            continue;
+          }
+          // Resolve the schema to see if this control points to an inline object
+          try {
+            const {
+              meta,
+              bindingPath
+            } = SchemaNormalizer.resolveScope(rootSchema, element.scope);
+            const hasExplicitWidget = !!meta?.ui?.widget;
+            const isInlineObject = meta?.type === SCHEMA_TYPE.OBJECT && meta.ui?.renderMode === RENDER_MODE.INLINE && !hasExplicitWidget;
+            if (isInlineObject && meta.properties) {
+              // Transform this Control into a Group containing its properties
+              const newGroup = {
+                type: "Group",
+                label: meta.ui?.label || bindingPath.split("/").pop(),
+                elements: []
+              };
+
+              // Add all child properties as controls
+              for (const childKey of Object.keys(meta.properties)) {
+                newGroup.elements.push({
+                  type: "Control",
+                  scope: `${element.scope}/properties/${childKey}`
+                });
+              }
+
+              // Recursively expand this new group in case it contains further inline objects
+              newGroup.elements = this.expandElements(newGroup.elements, rootSchema);
+              expanded.push(newGroup);
+            } else {
+              // Scalar control, keep as is
+              expanded.push(element);
+            }
+          } catch (e) {
+            // Scope not found, keep element to let normal error handling report it
+            expanded.push(element);
+          }
+        } else {
+          expanded.push(element);
+        }
+      }
+      return expanded;
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.LayoutMutator = LayoutMutator;
+  return __exports;
+});
+//# sourceMappingURL=LayoutMutator-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/core/LayoutMutator-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutMutator-dbg.js","names":["SchemaNormalizer","___SchemaNormalizer","RENDER_MODE","___constants_MetaUIConstants","SCHEMA_TYPE","LayoutMutator","apply","schema","uiLayout","Array","isArray","expandElements","elements","rootSchema","expanded","element","type","push","scope","meta","bindingPath","resolveScope","hasExplicitWidget","ui","widget","isInlineObject","OBJECT","renderMode","INLINE","properties","newGroup","label","split","pop","childKey","Object","keys","e","__exports","__esModule"],"sources":["LayoutMutator.ts"],"sourcesContent":["/**\n * @file LayoutMutator.ts\n * @description Intercepts the generated schema before rendering to dynamically mutate the UI layout based on inline rendering rules.\n */\n\nimport { ISchema, ILayoutElement } from \"../interfaces/ISchema\";\nimport { SchemaNormalizer } from \"./SchemaNormalizer\";\nimport { RENDER_MODE, SCHEMA_TYPE } from \"../constants/MetaUIConstants\";\n\nexport class LayoutMutator {\n    /**\n     * Mutates the `uiLayout` array to expand nested inline objects into native Groups.\n     * @param schema The normalized root schema.\n     */\n    public static apply(schema: ISchema): void {\n        if (!schema || !schema.uiLayout || !Array.isArray(schema.uiLayout)) {\n            return; // No layout to mutate\n        }\n\n        schema.uiLayout = this.expandElements(schema.uiLayout, schema);\n    }\n\n    private static expandElements(elements: ILayoutElement[], rootSchema: ISchema): ILayoutElement[] {\n        const expanded: ILayoutElement[] = [];\n\n        for (const element of elements) {\n            if (element.type === \"Group\") {\n                // Recursively expand group elements\n                if (element.elements) {\n                    element.elements = this.expandElements(element.elements, rootSchema);\n                }\n                expanded.push(element);\n            } else if (element.type === \"Control\") {\n                if (!element.scope) {\n                    expanded.push(element);\n                    continue;\n                }\n                // Resolve the schema to see if this control points to an inline object\n                try {\n                    const { meta, bindingPath } = SchemaNormalizer.resolveScope(rootSchema, element.scope);\n                    \n                    const hasExplicitWidget = !!meta?.ui?.widget;\n                    const isInlineObject = meta?.type === SCHEMA_TYPE.OBJECT && meta.ui?.renderMode === RENDER_MODE.INLINE && !hasExplicitWidget;\n\n                    if (isInlineObject && meta.properties) {\n                        // Transform this Control into a Group containing its properties\n                        const newGroup: ILayoutElement = {\n                            type: \"Group\",\n                            label: meta.ui?.label || bindingPath.split(\"/\").pop(),\n                            elements: []\n                        };\n\n                        // Add all child properties as controls\n                        for (const childKey of Object.keys(meta.properties)) {\n                            newGroup.elements!.push({\n                                type: \"Control\",\n                                scope: `${element.scope}/properties/${childKey}`\n                            });\n                        }\n\n                        // Recursively expand this new group in case it contains further inline objects\n                        newGroup.elements = this.expandElements(newGroup.elements!, rootSchema);\n                        \n                        expanded.push(newGroup);\n                    } else {\n                        // Scalar control, keep as is\n                        expanded.push(element);\n                    }\n                } catch (e) {\n                    // Scope not found, keep element to let normal error handling report it\n                    expanded.push(element);\n                }\n            } else {\n                expanded.push(element);\n            }\n        }\n\n        return expanded;\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/LayoutMutator.d.ts

@@ -0,0 +1,16 @@
+declare module "nz/co/siliconst/ui5/metaui/core/LayoutMutator" {
+    /**
+     * @file LayoutMutator.ts
+     * @description Intercepts the generated schema before rendering to dynamically mutate the UI layout based on inline rendering rules.
+     */
+    import { ISchema } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    export class LayoutMutator {
+        /**
+         * Mutates the `uiLayout` array to expand nested inline objects into native Groups.
+         * @param schema The normalized root schema.
+         */
+        static apply(schema: ISchema): void;
+        private static expandElements;
+    }
+}
+//# sourceMappingURL=LayoutMutator.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/core/LayoutMutator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutMutator.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/LayoutMutator.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+CAA+C,CAAC;IAC/D;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAkB,MAAM,+CAA+C,CAAC;IAIxF,MAAa,aAAa;QACtB;;;WAGG;eACW,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;QAQ1C,OAAO,CAAC,MAAM,CAAC,cAAc;KAyDhC;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/core/LayoutMutator.js

@@ -0,0 +1,2 @@
+sap.ui.define(["./SchemaNormalizer","../constants/MetaUIConstants"],function(e,t){"use strict";const s=e["SchemaNormalizer"];const o=t["RENDER_MODE"];const n=t["SCHEMA_TYPE"];class p{static apply(e){if(!e||!e.uiLayout||!Array.isArray(e.uiLayout)){return}e.uiLayout=this.expandElements(e.uiLayout,e)}static expandElements(e,t){const p=[];for(const r of e){if(r.type==="Group"){if(r.elements){r.elements=this.expandElements(r.elements,t)}p.push(r)}else if(r.type==="Control"){if(!r.scope){p.push(r);continue}try{const{meta:e,bindingPath:i}=s.resolveScope(t,r.scope);const u=!!e?.ui?.widget;const a=e?.type===n.OBJECT&&e.ui?.renderMode===o.INLINE&&!u;if(a&&e.properties){const s={type:"Group",label:e.ui?.label||i.split("/").pop(),elements:[]};for(const t of Object.keys(e.properties)){s.elements.push({type:"Control",scope:`${r.scope}/properties/${t}`})}s.elements=this.expandElements(s.elements,t);p.push(s)}else{p.push(r)}}catch(e){p.push(r)}}else{p.push(r)}}return p}}var r={__esModule:true};r.LayoutMutator=p;return r});
+//# sourceMappingURL=LayoutMutator.js.map

package/src/nz/co/siliconst/ui5/metaui/core/LayoutMutator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutMutator.js","names":["SchemaNormalizer","___SchemaNormalizer","RENDER_MODE","___constants_MetaUIConstants","SCHEMA_TYPE","LayoutMutator","apply","schema","uiLayout","Array","isArray","this","expandElements","elements","rootSchema","expanded","element","type","push","scope","meta","bindingPath","resolveScope","hasExplicitWidget","ui","widget","isInlineObject","OBJECT","renderMode","INLINE","properties","newGroup","label","split","pop","childKey","Object","keys","e","__exports","__esModule"],"sources":["LayoutMutator.ts"],"sourcesContent":["/**\n * @file LayoutMutator.ts\n * @description Intercepts the generated schema before rendering to dynamically mutate the UI layout based on inline rendering rules.\n */\n\nimport { ISchema, ILayoutElement } from \"../interfaces/ISchema\";\nimport { SchemaNormalizer } from \"./SchemaNormalizer\";\nimport { RENDER_MODE, SCHEMA_TYPE } from \"../constants/MetaUIConstants\";\n\nexport class LayoutMutator {\n    /**\n     * Mutates the `uiLayout` array to expand nested inline objects into native Groups.\n     * @param schema The normalized root schema.\n     */\n    public static apply(schema: ISchema): void {\n        if (!schema || !schema.uiLayout || !Array.isArray(schema.uiLayout)) {\n            return; // No layout to mutate\n        }\n\n        schema.uiLayout = this.expandElements(schema.uiLayout, schema);\n    }\n\n    private static expandElements(elements: ILayoutElement[], rootSchema: ISchema): ILayoutElement[] {\n        const expanded: ILayoutElement[] = [];\n\n        for (const element of elements) {\n            if (element.type === \"Group\") {\n                // Recursively expand group elements\n                if (element.elements) {\n                    element.elements = this.expandElements(element.elements, rootSchema);\n                }\n                expanded.push(element);\n            } else if (element.type === \"Control\") {\n                if (!element.scope) {\n                    expanded.push(element);\n                    continue;\n                }\n                // Resolve the schema to see if this control points to an inline object\n                try {\n                    const { meta, bindingPath } = SchemaNormalizer.resolveScope(rootSchema, element.scope);\n                    \n                    const hasExplicitWidget = !!meta?.ui?.widget;\n                    const isInlineObject = meta?.type === SCHEMA_TYPE.OBJECT && meta.ui?.renderMode === RENDER_MODE.INLINE && !hasExplicitWidget;\n\n                    if (isInlineObject && meta.properties) {\n                        // Transform this Control into a Group containing its properties\n                        const newGroup: ILayoutElement = {\n                            type: \"Group\",\n                            label: meta.ui?.label || bindingPath.split(\"/\").pop(),\n                            elements: []\n                        };\n\n                        // Add all child properties as controls\n                        for (const childKey of Object.keys(meta.properties)) {\n                            newGroup.elements!.push({\n                                type: \"Control\",\n                                scope: `${element.scope}/properties/${childKey}`\n                            });\n                        }\n\n                        // Recursively expand this new group in case it contains further inline objects\n                        newGroup.elements = this.expandElements(newGroup.elements!, rootSchema);\n                        \n                        expanded.push(newGroup);\n                    } else {\n                        // Scalar control, keep as is\n                        expanded.push(element);\n                    }\n                } catch (e) {\n                    // Scope not found, keep element to let normal error handling report it\n                    expanded.push(element);\n                }\n            } else {\n                expanded.push(element);\n            }\n        }\n\n        return expanded;\n    }\n}\n"],"mappings":"+FAAA,MAMSA,EAAgBC,EAAA,0BAChBC,EAAWC,EAAA,qBAAEC,EAAWD,EAAA,eAE1B,MAAME,EAKT,YAAcC,CAAMC,GAChB,IAAKA,IAAWA,EAAOC,WAAaC,MAAMC,QAAQH,EAAOC,UAAW,CAChE,MACJ,CAEAD,EAAOC,SAAWG,KAAKC,eAAeL,EAAOC,SAAUD,EAC3D,CAEA,qBAAeK,CAAeC,EAA4BC,GACtD,MAAMC,EAA6B,GAEnC,IAAK,MAAMC,KAAWH,EAAU,CAC5B,GAAIG,EAAQC,OAAS,QAAS,CAE1B,GAAID,EAAQH,SAAU,CAClBG,EAAQH,SAAWF,KAAKC,eAAeI,EAAQH,SAAUC,EAC7D,CACAC,EAASG,KAAKF,EAClB,MAAO,GAAIA,EAAQC,OAAS,UAAW,CACnC,IAAKD,EAAQG,MAAO,CAChBJ,EAASG,KAAKF,GACd,QACJ,CAEA,IACI,MAAMI,KAAEA,EAAIC,YAAEA,GAAgBrB,EAAiBsB,aAAaR,EAAYE,EAAQG,OAEhF,MAAMI,IAAsBH,GAAMI,IAAIC,OACtC,MAAMC,EAAiBN,GAAMH,OAASb,EAAYuB,QAAUP,EAAKI,IAAII,aAAe1B,EAAY2B,SAAWN,EAE3G,GAAIG,GAAkBN,EAAKU,WAAY,CAEnC,MAAMC,EAA2B,CAC7Bd,KAAM,QACNe,MAAOZ,EAAKI,IAAIQ,OAASX,EAAYY,MAAM,KAAKC,MAChDrB,SAAU,IAId,IAAK,MAAMsB,KAAYC,OAAOC,KAAKjB,EAAKU,YAAa,CACjDC,EAASlB,SAAUK,KAAK,CACpBD,KAAM,UACNE,MAAO,GAAGH,EAAQG,oBAAoBgB,KAE9C,CAGAJ,EAASlB,SAAWF,KAAKC,eAAemB,EAASlB,SAAWC,GAE5DC,EAASG,KAAKa,EAClB,KAAO,CAEHhB,EAASG,KAAKF,EAClB,CACJ,CAAE,MAAOsB,GAELvB,EAASG,KAAKF,EAClB,CACJ,KAAO,CACHD,EAASG,KAAKF,EAClB,CACJ,CAEA,OAAOD,CACX,EACH,IAAAwB,EAAA,CAAAC,WAAA,MAAAD,EAAAlC,gBAAA,OAAAkC,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/LayoutMutator.ts

@@ -0,0 +1,80 @@
+/**
+ * @file LayoutMutator.ts
+ * @description Intercepts the generated schema before rendering to dynamically mutate the UI layout based on inline rendering rules.
+ */
+
+import { ISchema, ILayoutElement } from "../interfaces/ISchema";
+import { SchemaNormalizer } from "./SchemaNormalizer";
+import { RENDER_MODE, SCHEMA_TYPE } from "../constants/MetaUIConstants";
+
+export class LayoutMutator {
+    /**
+     * Mutates the `uiLayout` array to expand nested inline objects into native Groups.
+     * @param schema The normalized root schema.
+     */
+    public static apply(schema: ISchema): void {
+        if (!schema || !schema.uiLayout || !Array.isArray(schema.uiLayout)) {
+            return; // No layout to mutate
+        }
+
+        schema.uiLayout = this.expandElements(schema.uiLayout, schema);
+    }
+
+    private static expandElements(elements: ILayoutElement[], rootSchema: ISchema): ILayoutElement[] {
+        const expanded: ILayoutElement[] = [];
+
+        for (const element of elements) {
+            if (element.type === "Group") {
+                // Recursively expand group elements
+                if (element.elements) {
+                    element.elements = this.expandElements(element.elements, rootSchema);
+                }
+                expanded.push(element);
+            } else if (element.type === "Control") {
+                if (!element.scope) {
+                    expanded.push(element);
+                    continue;
+                }
+                // Resolve the schema to see if this control points to an inline object
+                try {
+                    const { meta, bindingPath } = SchemaNormalizer.resolveScope(rootSchema, element.scope);
+                    
+                    const hasExplicitWidget = !!meta?.ui?.widget;
+                    const isInlineObject = meta?.type === SCHEMA_TYPE.OBJECT && meta.ui?.renderMode === RENDER_MODE.INLINE && !hasExplicitWidget;
+
+                    if (isInlineObject && meta.properties) {
+                        // Transform this Control into a Group containing its properties
+                        const newGroup: ILayoutElement = {
+                            type: "Group",
+                            label: meta.ui?.label || bindingPath.split("/").pop(),
+                            elements: []
+                        };
+
+                        // Add all child properties as controls
+                        for (const childKey of Object.keys(meta.properties)) {
+                            newGroup.elements!.push({
+                                type: "Control",
+                                scope: `${element.scope}/properties/${childKey}`
+                            });
+                        }
+
+                        // Recursively expand this new group in case it contains further inline objects
+                        newGroup.elements = this.expandElements(newGroup.elements!, rootSchema);
+                        
+                        expanded.push(newGroup);
+                    } else {
+                        // Scalar control, keep as is
+                        expanded.push(element);
+                    }
+                } catch (e) {
+                    // Scope not found, keep element to let normal error handling report it
+                    expanded.push(element);
+                }
+            } else {
+                expanded.push(element);
+            }
+        }
+
+        return expanded;
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer-dbg.js

@@ -0,0 +1,137 @@
+sap.ui.define(["./PluginRegistry", "../utils/Logger", "../constants/MetaUIConstants"], function (___PluginRegistry, ___utils_Logger, ___constants_MetaUIConstants) {
+  "use strict";
+
+  /**
+   * @file LayoutScorer.ts
+   * @description Core utility that calculates the nested footprint score of schemas 
+   * to determine if they should be rendered inline or overflowed into a dialog button.
+   */
+  const PluginRegistry = ___PluginRegistry["PluginRegistry"];
+  const Logger = ___utils_Logger["Logger"];
+  const RENDER_MODE = ___constants_MetaUIConstants["RENDER_MODE"];
+  const SCHEMA_TYPE = ___constants_MetaUIConstants["SCHEMA_TYPE"];
+  const OPENAPI_PREFIX = ___constants_MetaUIConstants["OPENAPI_PREFIX"];
+  const WIDGET_TYPE = ___constants_MetaUIConstants["WIDGET_TYPE"];
+  class LayoutScorer {
+    /**
+     * Recursively computes scores and annotates the schema with `renderMode`.
+     * 
+     * @param schema The normalized schema root.
+     * @param budget The remaining layout budget (e.g., 50).
+     */
+    static apply(schema, budget, schemaDefinitions) {
+      if (!schema || budget <= 0) return; // 0 budget means default fallback (no inline budget logic).
+
+      const visited = new WeakSet();
+      const activeRefs = new Set();
+
+      // We only score the root properties (not the root object itself).
+      if (schema.properties) {
+        for (const key in schema.properties) {
+          const prop = schema.properties[key];
+          if (prop.type === SCHEMA_TYPE.OBJECT || prop.type === SCHEMA_TYPE.ARRAY || prop.$ref) {
+            this._scoreNode(prop, budget, visited, activeRefs, key, schemaDefinitions);
+          }
+        }
+      }
+    }
+
+    /**
+     * Traverses a node, computing its total footprint.
+     * If the score > budget, forces `renderMode = "dialog"`.
+     * If the score <= budget, forces `renderMode = "inline"`.
+     */
+    static _scoreNode(node, budget, visited, activeRefs, path, schemaDefinitions) {
+      if (!node || typeof node !== SCHEMA_TYPE.OBJECT) return 0;
+      if (visited.has(node)) {
+        Logger.warn(`[MetaUI LayoutScorer] Circular reference detected at '${path}'. Forcing dialog mode to prevent crash.`, "", "LayoutScorer");
+        node.ui = node.ui || {};
+        node.ui.renderMode = RENDER_MODE.DIALOG;
+        node.ui.layoutBudget = budget;
+        return 1; // A dialog button is just 1 unit
+      }
+      visited.add(node);
+      if (node.$ref && schemaDefinitions) {
+        let key = node.$ref;
+        if (key.startsWith(OPENAPI_PREFIX.DEFINITIONS)) key = key.substring(OPENAPI_PREFIX.DEFINITIONS.length);else if (key.startsWith(OPENAPI_PREFIX.COMPONENTS_SCHEMAS)) key = key.substring(OPENAPI_PREFIX.COMPONENTS_SCHEMAS.length);
+        if (activeRefs.has(key)) {
+          Logger.warn(`[MetaUI LayoutScorer] Circular OpenAPI $ref detected at '${path}' for '${key}'. Forcing dialog mode to prevent crash.`, "", "LayoutScorer");
+          node.ui = node.ui || {};
+          node.ui.renderMode = RENDER_MODE.DIALOG;
+          return 1;
+        }
+        const resolvedOriginal = schemaDefinitions[key];
+        if (resolvedOriginal) {
+          activeRefs.add(key);
+
+          // Deep clone it BEFORE scoring so we don't mutate the global dictionary
+          const resolved = JSON.parse(JSON.stringify(resolvedOriginal));
+          const resolvedScore = this._scoreNode(resolved, budget, visited, activeRefs, path, schemaDefinitions);
+          activeRefs.delete(key);
+          node.ui = node.ui || {};
+          node.ui.layoutBudget = budget;
+          if (resolvedScore <= budget) {
+            // Merge it permanently in the layout!
+            Object.assign(node, resolved);
+            delete node.$ref;
+            if (node.ui?.widget === WIDGET_TYPE.REFERENCE) delete node.ui.widget;
+            node.ui.renderMode = RENDER_MODE.INLINE;
+            return resolvedScore;
+          } else {
+            node.ui.renderMode = RENDER_MODE.DIALOG;
+            return 1;
+          }
+        }
+      }
+      if (node.type === SCHEMA_TYPE.ARRAY) {
+        let arrayScore = PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.ARRAY, node.ui?.widget);
+
+        // Traverse array items!
+        if (node.items) {
+          const itemsSchema = node.items;
+          if (itemsSchema.type === SCHEMA_TYPE.OBJECT || itemsSchema.type === SCHEMA_TYPE.ARRAY || itemsSchema.$ref) {
+            arrayScore += this._scoreNode(itemsSchema, budget, visited, activeRefs, `${path}/items`, schemaDefinitions);
+          }
+        }
+        node.ui = node.ui || {};
+        node.ui.layoutBudget = budget;
+        if (arrayScore <= budget) {
+          node.ui.renderMode = RENDER_MODE.INLINE;
+          return arrayScore;
+        } else {
+          node.ui.renderMode = RENDER_MODE.DIALOG;
+          return 1;
+        }
+      }
+      let totalScore = 0;
+      if (node.properties) {
+        for (const key in node.properties) {
+          const child = node.properties[key];
+          if (child.type === SCHEMA_TYPE.OBJECT || child.type === SCHEMA_TYPE.ARRAY || child.$ref) {
+            totalScore += this._scoreNode(child, budget, visited, activeRefs, `${path}/${key}`, schemaDefinitions);
+          } else {
+            totalScore += PluginRegistry.getInstance().getPluginScore(child.type || SCHEMA_TYPE.STRING, child.ui?.widget);
+          }
+        }
+      } else {
+        // An open dictionary (additionalProperties) is scored as a single table
+        totalScore += PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.OBJECT, node.ui?.widget); // e.g. dictionaryMap
+      }
+      node.ui = node.ui || {};
+      node.ui.layoutBudget = budget;
+      if (totalScore <= budget) {
+        node.ui.renderMode = RENDER_MODE.INLINE;
+        return totalScore;
+      } else {
+        node.ui.renderMode = RENDER_MODE.DIALOG;
+        return 1; // It collapsed into an "Edit Details" button
+      }
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.LayoutScorer = LayoutScorer;
+  return __exports;
+});
+//# sourceMappingURL=LayoutScorer-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutScorer-dbg.js","names":["PluginRegistry","___PluginRegistry","Logger","___utils_Logger","RENDER_MODE","___constants_MetaUIConstants","SCHEMA_TYPE","OPENAPI_PREFIX","WIDGET_TYPE","LayoutScorer","apply","schema","budget","schemaDefinitions","visited","WeakSet","activeRefs","Set","properties","key","prop","type","OBJECT","ARRAY","$ref","_scoreNode","node","path","has","warn","ui","renderMode","DIALOG","layoutBudget","add","startsWith","DEFINITIONS","substring","length","COMPONENTS_SCHEMAS","resolvedOriginal","resolved","JSON","parse","stringify","resolvedScore","delete","Object","assign","widget","REFERENCE","INLINE","arrayScore","getInstance","getPluginScore","items","itemsSchema","totalScore","child","STRING","__exports","__esModule"],"sources":["LayoutScorer.ts"],"sourcesContent":["/**\n * @file LayoutScorer.ts\n * @description Core utility that calculates the nested footprint score of schemas \n * to determine if they should be rendered inline or overflowed into a dialog button.\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport { Logger } from \"../utils/Logger\";\nimport { RENDER_MODE, SCHEMA_TYPE, OPENAPI_PREFIX, WIDGET_TYPE } from \"../constants/MetaUIConstants\";\n\nexport class LayoutScorer {\n    /**\n     * Recursively computes scores and annotates the schema with `renderMode`.\n     * \n     * @param schema The normalized schema root.\n     * @param budget The remaining layout budget (e.g., 50).\n     */\n    public static apply(schema: ISchema | null, budget: number, schemaDefinitions?: Record<string, ISchema>): void {\n        if (!schema || budget <= 0) return; // 0 budget means default fallback (no inline budget logic).\n\n        const visited = new WeakSet<object>();\n        const activeRefs = new Set<string>();\n\n        // We only score the root properties (not the root object itself).\n        if (schema.properties) {\n            for (const key in schema.properties) {\n                const prop = schema.properties[key];\n                if (prop.type === SCHEMA_TYPE.OBJECT || prop.type === SCHEMA_TYPE.ARRAY || prop.$ref) {\n                    this._scoreNode(prop, budget, visited, activeRefs, key, schemaDefinitions);\n                }\n            }\n        }\n    }\n\n    /**\n     * Traverses a node, computing its total footprint.\n     * If the score > budget, forces `renderMode = \"dialog\"`.\n     * If the score <= budget, forces `renderMode = \"inline\"`.\n     */\n    private static _scoreNode(node: IPropertyMetadata, budget: number, visited: WeakSet<object>, activeRefs: Set<string>, path: string, schemaDefinitions?: Record<string, ISchema>): number {\n        if (!node || typeof node !== SCHEMA_TYPE.OBJECT) return 0;\n\n        if (visited.has(node)) {\n            Logger.warn(`[MetaUI LayoutScorer] Circular reference detected at '${path}'. Forcing dialog mode to prevent crash.`, \"\", \"LayoutScorer\");\n            node.ui = node.ui || {};\n            node.ui.renderMode = RENDER_MODE.DIALOG;\n            node.ui.layoutBudget = budget;\n            return 1; // A dialog button is just 1 unit\n        }\n        visited.add(node);\n\n        if (node.$ref && schemaDefinitions) {\n            let key = node.$ref;\n            if (key.startsWith(OPENAPI_PREFIX.DEFINITIONS)) key = key.substring(OPENAPI_PREFIX.DEFINITIONS.length);\n            else if (key.startsWith(OPENAPI_PREFIX.COMPONENTS_SCHEMAS)) key = key.substring(OPENAPI_PREFIX.COMPONENTS_SCHEMAS.length);\n\n            if (activeRefs.has(key)) {\n                Logger.warn(`[MetaUI LayoutScorer] Circular OpenAPI $ref detected at '${path}' for '${key}'. Forcing dialog mode to prevent crash.`, \"\", \"LayoutScorer\");\n                node.ui = node.ui || {};\n                node.ui.renderMode = RENDER_MODE.DIALOG;\n                return 1;\n            }\n\n            const resolvedOriginal = schemaDefinitions[key];\n            if (resolvedOriginal) {\n                activeRefs.add(key);\n                \n                // Deep clone it BEFORE scoring so we don't mutate the global dictionary\n                const resolved = JSON.parse(JSON.stringify(resolvedOriginal));\n                \n                const resolvedScore = this._scoreNode(resolved, budget, visited, activeRefs, path, schemaDefinitions);\n                activeRefs.delete(key);\n                \n                node.ui = node.ui || {};\n                node.ui.layoutBudget = budget;\n                if (resolvedScore <= budget) {\n                    // Merge it permanently in the layout!\n                    Object.assign(node, resolved);\n                    delete node.$ref;\n                    if (node.ui?.widget === WIDGET_TYPE.REFERENCE) delete node.ui.widget;\n                    \n                    node.ui.renderMode = RENDER_MODE.INLINE;\n                    return resolvedScore;\n                } else {\n                    node.ui.renderMode = RENDER_MODE.DIALOG;\n                    return 1;\n                }\n            }\n        }\n\n        if (node.type === SCHEMA_TYPE.ARRAY) {\n            let arrayScore = PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.ARRAY, node.ui?.widget);\n            \n            // Traverse array items!\n            if (node.items) {\n                const itemsSchema = node.items as ISchema;\n                if (itemsSchema.type === SCHEMA_TYPE.OBJECT || itemsSchema.type === SCHEMA_TYPE.ARRAY || itemsSchema.$ref) {\n                    arrayScore += this._scoreNode(itemsSchema, budget, visited, activeRefs, `${path}/items`, schemaDefinitions);\n                }\n            }\n\n            node.ui = node.ui || {};\n            node.ui.layoutBudget = budget;\n            if (arrayScore <= budget) {\n                node.ui.renderMode = RENDER_MODE.INLINE;\n                return arrayScore;\n            } else {\n                node.ui.renderMode = RENDER_MODE.DIALOG;\n                return 1;\n            }\n        }\n\n        let totalScore = 0;\n\n        if (node.properties) {\n            for (const key in node.properties) {\n                const child = node.properties[key] as IPropertyMetadata;\n                if (child.type === SCHEMA_TYPE.OBJECT || child.type === SCHEMA_TYPE.ARRAY || child.$ref) {\n                    totalScore += this._scoreNode(child, budget, visited, activeRefs, `${path}/${key}`, schemaDefinitions);\n                } else {\n                    totalScore += PluginRegistry.getInstance().getPluginScore(child.type || SCHEMA_TYPE.STRING, child.ui?.widget);\n                }\n            }\n        } else {\n            // An open dictionary (additionalProperties) is scored as a single table\n            totalScore += PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.OBJECT, node.ui?.widget); // e.g. dictionaryMap\n        }\n\n        node.ui = node.ui || {};\n        node.ui.layoutBudget = budget;\n        \n        if (totalScore <= budget) {\n            node.ui.renderMode = RENDER_MODE.INLINE;\n            return totalScore;\n        } else {\n            node.ui.renderMode = RENDER_MODE.DIALOG;\n            return 1; // It collapsed into an \"Edit Details\" button\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer.d.ts

@@ -0,0 +1,24 @@
+declare module "nz/co/siliconst/ui5/metaui/core/LayoutScorer" {
+    /**
+     * @file LayoutScorer.ts
+     * @description Core utility that calculates the nested footprint score of schemas
+     * to determine if they should be rendered inline or overflowed into a dialog button.
+     */
+    import { ISchema } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    export class LayoutScorer {
+        /**
+         * Recursively computes scores and annotates the schema with `renderMode`.
+         *
+         * @param schema The normalized schema root.
+         * @param budget The remaining layout budget (e.g., 50).
+         */
+        static apply(schema: ISchema | null, budget: number, schemaDefinitions?: Record<string, ISchema>): void;
+        /**
+         * Traverses a node, computing its total footprint.
+         * If the score > budget, forces `renderMode = "dialog"`.
+         * If the score <= budget, forces `renderMode = "inline"`.
+         */
+        private static _scoreNode;
+    }
+}
+//# sourceMappingURL=LayoutScorer.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutScorer.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/LayoutScorer.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,8CAA8C,CAAC;IAC9D;;;;OAIG;IAEH,OAAO,EAAE,OAAO,EAAqB,MAAM,+CAA+C,CAAC;IAK3F,MAAa,YAAY;QACrB;;;;;WAKG;eACW,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;QAiB9G;;;;WAIG;QACH,OAAO,CAAC,MAAM,CAAC,UAAU;KAoG5B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer.js

@@ -0,0 +1,2 @@
+sap.ui.define(["./PluginRegistry","../utils/Logger","../constants/MetaUIConstants"],function(e,t,r){"use strict";const i=e["PluginRegistry"];const o=t["Logger"];const s=r["RENDER_MODE"];const n=r["SCHEMA_TYPE"];const u=r["OPENAPI_PREFIX"];const c=r["WIDGET_TYPE"];class d{static apply(e,t,r){if(!e||t<=0)return;const i=new WeakSet;const o=new Set;if(e.properties){for(const s in e.properties){const u=e.properties[s];if(u.type===n.OBJECT||u.type===n.ARRAY||u.$ref){this._scoreNode(u,t,i,o,s,r)}}}}static _scoreNode(e,t,r,d,a,g){if(!e||typeof e!==n.OBJECT)return 0;if(r.has(e)){o.warn(`[MetaUI LayoutScorer] Circular reference detected at '${a}'. Forcing dialog mode to prevent crash.`,"","LayoutScorer");e.ui=e.ui||{};e.ui.renderMode=s.DIALOG;e.ui.layoutBudget=t;return 1}r.add(e);if(e.$ref&&g){let i=e.$ref;if(i.startsWith(u.DEFINITIONS))i=i.substring(u.DEFINITIONS.length);else if(i.startsWith(u.COMPONENTS_SCHEMAS))i=i.substring(u.COMPONENTS_SCHEMAS.length);if(d.has(i)){o.warn(`[MetaUI LayoutScorer] Circular OpenAPI $ref detected at '${a}' for '${i}'. Forcing dialog mode to prevent crash.`,"","LayoutScorer");e.ui=e.ui||{};e.ui.renderMode=s.DIALOG;return 1}const n=g[i];if(n){d.add(i);const o=JSON.parse(JSON.stringify(n));const u=this._scoreNode(o,t,r,d,a,g);d.delete(i);e.ui=e.ui||{};e.ui.layoutBudget=t;if(u<=t){Object.assign(e,o);delete e.$ref;if(e.ui?.widget===c.REFERENCE)delete e.ui.widget;e.ui.renderMode=s.INLINE;return u}else{e.ui.renderMode=s.DIALOG;return 1}}}if(e.type===n.ARRAY){let o=i.getInstance().getPluginScore(n.ARRAY,e.ui?.widget);if(e.items){const i=e.items;if(i.type===n.OBJECT||i.type===n.ARRAY||i.$ref){o+=this._scoreNode(i,t,r,d,`${a}/items`,g)}}e.ui=e.ui||{};e.ui.layoutBudget=t;if(o<=t){e.ui.renderMode=s.INLINE;return o}else{e.ui.renderMode=s.DIALOG;return 1}}let f=0;if(e.properties){for(const o in e.properties){const s=e.properties[o];if(s.type===n.OBJECT||s.type===n.ARRAY||s.$ref){f+=this._scoreNode(s,t,r,d,`${a}/${o}`,g)}else{f+=i.getInstance().getPluginScore(s.type||n.STRING,s.ui?.widget)}}}else{f+=i.getInstance().getPluginScore(n.OBJECT,e.ui?.widget)}e.ui=e.ui||{};e.ui.layoutBudget=t;if(f<=t){e.ui.renderMode=s.INLINE;return f}else{e.ui.renderMode=s.DIALOG;return 1}}}var a={__esModule:true};a.LayoutScorer=d;return a});
+//# sourceMappingURL=LayoutScorer.js.map

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutScorer.js","names":["PluginRegistry","___PluginRegistry","Logger","___utils_Logger","RENDER_MODE","___constants_MetaUIConstants","SCHEMA_TYPE","OPENAPI_PREFIX","WIDGET_TYPE","LayoutScorer","apply","schema","budget","schemaDefinitions","visited","WeakSet","activeRefs","Set","properties","key","prop","type","OBJECT","ARRAY","$ref","this","_scoreNode","node","path","has","warn","ui","renderMode","DIALOG","layoutBudget","add","startsWith","DEFINITIONS","substring","length","COMPONENTS_SCHEMAS","resolvedOriginal","resolved","JSON","parse","stringify","resolvedScore","delete","Object","assign","widget","REFERENCE","INLINE","arrayScore","getInstance","getPluginScore","items","itemsSchema","totalScore","child","STRING","__exports","__esModule"],"sources":["LayoutScorer.ts"],"sourcesContent":["/**\n * @file LayoutScorer.ts\n * @description Core utility that calculates the nested footprint score of schemas \n * to determine if they should be rendered inline or overflowed into a dialog button.\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport { Logger } from \"../utils/Logger\";\nimport { RENDER_MODE, SCHEMA_TYPE, OPENAPI_PREFIX, WIDGET_TYPE } from \"../constants/MetaUIConstants\";\n\nexport class LayoutScorer {\n    /**\n     * Recursively computes scores and annotates the schema with `renderMode`.\n     * \n     * @param schema The normalized schema root.\n     * @param budget The remaining layout budget (e.g., 50).\n     */\n    public static apply(schema: ISchema | null, budget: number, schemaDefinitions?: Record<string, ISchema>): void {\n        if (!schema || budget <= 0) return; // 0 budget means default fallback (no inline budget logic).\n\n        const visited = new WeakSet<object>();\n        const activeRefs = new Set<string>();\n\n        // We only score the root properties (not the root object itself).\n        if (schema.properties) {\n            for (const key in schema.properties) {\n                const prop = schema.properties[key];\n                if (prop.type === SCHEMA_TYPE.OBJECT || prop.type === SCHEMA_TYPE.ARRAY || prop.$ref) {\n                    this._scoreNode(prop, budget, visited, activeRefs, key, schemaDefinitions);\n                }\n            }\n        }\n    }\n\n    /**\n     * Traverses a node, computing its total footprint.\n     * If the score > budget, forces `renderMode = \"dialog\"`.\n     * If the score <= budget, forces `renderMode = \"inline\"`.\n     */\n    private static _scoreNode(node: IPropertyMetadata, budget: number, visited: WeakSet<object>, activeRefs: Set<string>, path: string, schemaDefinitions?: Record<string, ISchema>): number {\n        if (!node || typeof node !== SCHEMA_TYPE.OBJECT) return 0;\n\n        if (visited.has(node)) {\n            Logger.warn(`[MetaUI LayoutScorer] Circular reference detected at '${path}'. Forcing dialog mode to prevent crash.`, \"\", \"LayoutScorer\");\n            node.ui = node.ui || {};\n            node.ui.renderMode = RENDER_MODE.DIALOG;\n            node.ui.layoutBudget = budget;\n            return 1; // A dialog button is just 1 unit\n        }\n        visited.add(node);\n\n        if (node.$ref && schemaDefinitions) {\n            let key = node.$ref;\n            if (key.startsWith(OPENAPI_PREFIX.DEFINITIONS)) key = key.substring(OPENAPI_PREFIX.DEFINITIONS.length);\n            else if (key.startsWith(OPENAPI_PREFIX.COMPONENTS_SCHEMAS)) key = key.substring(OPENAPI_PREFIX.COMPONENTS_SCHEMAS.length);\n\n            if (activeRefs.has(key)) {\n                Logger.warn(`[MetaUI LayoutScorer] Circular OpenAPI $ref detected at '${path}' for '${key}'. Forcing dialog mode to prevent crash.`, \"\", \"LayoutScorer\");\n                node.ui = node.ui || {};\n                node.ui.renderMode = RENDER_MODE.DIALOG;\n                return 1;\n            }\n\n            const resolvedOriginal = schemaDefinitions[key];\n            if (resolvedOriginal) {\n                activeRefs.add(key);\n                \n                // Deep clone it BEFORE scoring so we don't mutate the global dictionary\n                const resolved = JSON.parse(JSON.stringify(resolvedOriginal));\n                \n                const resolvedScore = this._scoreNode(resolved, budget, visited, activeRefs, path, schemaDefinitions);\n                activeRefs.delete(key);\n                \n                node.ui = node.ui || {};\n                node.ui.layoutBudget = budget;\n                if (resolvedScore <= budget) {\n                    // Merge it permanently in the layout!\n                    Object.assign(node, resolved);\n                    delete node.$ref;\n                    if (node.ui?.widget === WIDGET_TYPE.REFERENCE) delete node.ui.widget;\n                    \n                    node.ui.renderMode = RENDER_MODE.INLINE;\n                    return resolvedScore;\n                } else {\n                    node.ui.renderMode = RENDER_MODE.DIALOG;\n                    return 1;\n                }\n            }\n        }\n\n        if (node.type === SCHEMA_TYPE.ARRAY) {\n            let arrayScore = PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.ARRAY, node.ui?.widget);\n            \n            // Traverse array items!\n            if (node.items) {\n                const itemsSchema = node.items as ISchema;\n                if (itemsSchema.type === SCHEMA_TYPE.OBJECT || itemsSchema.type === SCHEMA_TYPE.ARRAY || itemsSchema.$ref) {\n                    arrayScore += this._scoreNode(itemsSchema, budget, visited, activeRefs, `${path}/items`, schemaDefinitions);\n                }\n            }\n\n            node.ui = node.ui || {};\n            node.ui.layoutBudget = budget;\n            if (arrayScore <= budget) {\n                node.ui.renderMode = RENDER_MODE.INLINE;\n                return arrayScore;\n            } else {\n                node.ui.renderMode = RENDER_MODE.DIALOG;\n                return 1;\n            }\n        }\n\n        let totalScore = 0;\n\n        if (node.properties) {\n            for (const key in node.properties) {\n                const child = node.properties[key] as IPropertyMetadata;\n                if (child.type === SCHEMA_TYPE.OBJECT || child.type === SCHEMA_TYPE.ARRAY || child.$ref) {\n                    totalScore += this._scoreNode(child, budget, visited, activeRefs, `${path}/${key}`, schemaDefinitions);\n                } else {\n                    totalScore += PluginRegistry.getInstance().getPluginScore(child.type || SCHEMA_TYPE.STRING, child.ui?.widget);\n                }\n            }\n        } else {\n            // An open dictionary (additionalProperties) is scored as a single table\n            totalScore += PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.OBJECT, node.ui?.widget); // e.g. dictionaryMap\n        }\n\n        node.ui = node.ui || {};\n        node.ui.layoutBudget = budget;\n        \n        if (totalScore <= budget) {\n            node.ui.renderMode = RENDER_MODE.INLINE;\n            return totalScore;\n        } else {\n            node.ui.renderMode = RENDER_MODE.DIALOG;\n            return 1; // It collapsed into an \"Edit Details\" button\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}