@siliconst/metaui 1.4.13 → 1.4.17

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

@@ -1 +1 @@
-{"version":3,"file":"PluginRegistry.js","names":["Logger","___utils_Logger","PluginRegistry","fieldIndex","actionIndex","layoutIndex","activePromises","constructor","this","registerPluginPath","undefined","registerLayoutPath","getInstance","instance","type","widgetName","path","key","registerActionPath","actionName","strategy","getFieldPath","Error","getLayoutPath","getPathsToLoad","schema","pathsToLoad","Set","layoutStrategy","add","scanProperties","props","prop","ui","widget","e","msg","message","error","properties","items","preloadDependencies","promises","Array","from","map","Promise","resolve","reject","sap","require","Module","err","all","extractConstructor","default","keys","Object","getPlugin","PluginClass","getLayout","LayoutClass","__exports","__esModule"],"sources":["PluginRegistry.ts"],"sourcesContent":["/**\n * @file PluginRegistry.ts\n * @description Centralized hub for mapping UI5 controls to SAP schema data types.\n * Enforces the Registry Pattern to decouple the core engine from specific UI5 control implementations.\n * NOW WITH UNIVERSAL LAZY LOADING.\n */\n\nimport { IPlugin } from \"../interfaces/IPlugin\";\nimport { FieldType, ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { Logger } from \"../utils/Logger\";\nimport { DefaultLayoutGenerator } from \"./DefaultLayoutGenerator\";\n\nexport class PluginRegistry {\n    private static instance: PluginRegistry;\n    \n    private fieldIndex: Record<string, string> = {};\n    private actionIndex: Record<string, string> = {};\n    private layoutIndex: Record<string, string> = {};\n    \n    private activePromises: Record<string, Promise<unknown>> = {};\n\n    private constructor() {\n        // Core Mappings\n        this.registerPluginPath(\"string\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/StringPlugin\");\n        this.registerPluginPath(\"number\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin\");\n        this.registerPluginPath(\"integer\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin\");\n        this.registerPluginPath(\"date\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/DatePlugin\");\n        this.registerPluginPath(\"boolean\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/BooleanPlugin\");\n        this.registerPluginPath(\"array\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin\");\n        this.registerPluginPath(\"object\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin\");\n\n        // Widget Overrides\n        this.registerPluginPath(\"string\", \"time\", \"nz/co/siliconst/ui5/metaui/plugins/controls/TimePlugin\");\n        this.registerPluginPath(\"string\", \"datetime\", \"nz/co/siliconst/ui5/metaui/plugins/controls/DateTimePlugin\");\n        this.registerPluginPath(\"boolean\", \"switch\", \"nz/co/siliconst/ui5/metaui/plugins/controls/SwitchPlugin\");\n        this.registerPluginPath(\"string\", \"select\", \"nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin\");\n        this.registerPluginPath(\"string\", \"textArea\", \"nz/co/siliconst/ui5/metaui/plugins/controls/TextAreaPlugin\");\n        this.registerPluginPath(\"string\", \"codeEditor\", \"nz/co/siliconst/ui5/metaui/plugins/controls/CodeEditorPlugin\");\n        \n        // Phase 1 Mappings\n        this.registerPluginPath(\"string\", \"fileUploader\", \"nz/co/siliconst/ui5/metaui/plugins/controls/FileUploaderPlugin\");\n        this.registerPluginPath(\"array\", \"multiSelect\", \"nz/co/siliconst/ui5/metaui/plugins/controls/MultiSelectPlugin\");\n        this.registerPluginPath(\"array\", \"multiInput\", \"nz/co/siliconst/ui5/metaui/plugins/controls/MultiInputPlugin\");\n        this.registerPluginPath(\"number\", \"slider\", \"nz/co/siliconst/ui5/metaui/plugins/controls/SliderPlugin\");\n        this.registerPluginPath(\"number\", \"rating\", \"nz/co/siliconst/ui5/metaui/plugins/controls/RatingIndicatorPlugin\");\n        this.registerPluginPath(\"string\", \"messageStrip\", \"nz/co/siliconst/ui5/metaui/plugins/controls/MessageStripPlugin\");\n\n        // Phase 5 Mappings (Hardware)\n        this.registerPluginPath(\"string\", \"camera\", \"nz/co/siliconst/ui5/metaui/plugins/controls/CameraPlugin\");\n        this.registerPluginPath(\"string\", \"signature\", \"nz/co/siliconst/ui5/metaui/plugins/controls/SignaturePlugin\");\n        this.registerPluginPath(\"object\", \"location\", \"nz/co/siliconst/ui5/metaui/plugins/controls/GeolocationPlugin\");\n        this.registerPluginPath(\"string\", \"scanner\", \"nz/co/siliconst/ui5/metaui/plugins/controls/BarcodeScannerPlugin\");\n        this.registerPluginPath(\"string\", \"voiceInput\", \"nz/co/siliconst/ui5/metaui/plugins/controls/VoiceInputPlugin\");\n        this.registerPluginPath(\"string\", \"richText\", \"nz/co/siliconst/ui5/metaui/plugins/controls/RichTextPlugin\");\n\n        // Actions & Datasources\n        this.registerPluginPath(\"string\", \"urlButton\", \"nz/co/siliconst/ui5/metaui/plugins/actions/UrlNavigationActionPlugin\");\n        this.registerPluginPath(\"string\", \"submitButton\", \"nz/co/siliconst/ui5/metaui/plugins/actions/SubmitFormActionPlugin\");\n        this.registerPluginPath(\"string\", \"odataSelect\", \"nz/co/siliconst/ui5/metaui/plugins/datasources/ODataListBindingPlugin\");\n        this.registerPluginPath(\"string\", \"remoteDropdown\", \"nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteDropdownPlugin\");\n        this.registerPluginPath(\"string\", \"liveSearch\", \"nz/co/siliconst/ui5/metaui/plugins/datasources/LiveSearchPlugin\");\n        this.registerPluginPath(\"string\", \"remoteValueHelp\", \"nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteValueHelpPlugin\");\n\n        // Layouts\n        this.registerLayoutPath(\"form\", \"nz/co/siliconst/ui5/metaui/layouts/FormLayout\");\n        this.registerLayoutPath(\"table\", \"nz/co/siliconst/ui5/metaui/layouts/TableLayout\");\n        this.registerLayoutPath(\"wizard\", \"nz/co/siliconst/ui5/metaui/layouts/WizardLayout\");\n        this.registerLayoutPath(\"compact\", \"nz/co/siliconst/ui5/metaui/layouts/CompactLayout\");\n    }\n\n    public static getInstance(): PluginRegistry {\n        if (!PluginRegistry.instance) {\n            PluginRegistry.instance = new PluginRegistry();\n        }\n        return PluginRegistry.instance;\n    }\n\n    public registerPluginPath(type: FieldType, widgetName: string | undefined, path: string): void {\n        const key = widgetName ? `${type}:${widgetName}` : type;\n        this.fieldIndex[key] = path;\n    }\n\n    public registerActionPath(actionName: string, path: string): void {\n        this.actionIndex[actionName] = path;\n    }\n\n    public registerLayoutPath(strategy: string, path: string): void {\n        this.layoutIndex[strategy] = path;\n    }\n\n    private getFieldPath(type: FieldType, widgetName?: string): string {\n        let path;\n        if (widgetName) {\n            path = this.fieldIndex[`${type}:${widgetName}`];\n        }\n        if (!path) {\n            path = this.fieldIndex[type];\n        }\n        if (!path) {\n            throw new Error(`No plugin path mapped for FieldType: ${type} (widget: ${widgetName})`);\n        }\n        return path;\n    }\n\n    private getLayoutPath(strategy: string): string {\n        const path = this.layoutIndex[strategy];\n        if (!path) {\n            throw new Error(`No layout path mapped for strategy: ${strategy}`);\n        }\n        return path;\n    }\n\n    /**\n     * Statically traverses the schema structure to identify all required plugins\n     * and layouts without actually instantiating them.\n     * \n     * @param {ISchema} schema The root JSON schema payload to traverse\n     * @returns {Set<string>} A distinct set of UI5 module paths required to render the schema\n     */\n    public getPathsToLoad(schema: ISchema): Set<string> {\n        const pathsToLoad = new Set<string>();\n        \n        // 1. Gather layout strategy\n        const strategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n        pathsToLoad.add(this.getLayoutPath(strategy));\n\n        // 2. Recursively gather field plugins\n        const scanProperties = (props: Record<string, IPropertyMetadata>) => {\n            for (const key in props) {\n                const prop = props[key];\n                try {\n                    pathsToLoad.add(this.getFieldPath(prop.type || \"string\", prop.ui?.widget));\n                } catch (e) {\n                    const msg = `[MetaUI LazyLoad] Could not find mapped plugin for field ${key}: ${(e as Error).message}`;\n                    Logger.error(msg);\n                    throw new Error(msg);\n                }\n                if (prop.properties) scanProperties(prop.properties);\n                if (prop.items && prop.items.properties) scanProperties(prop.items.properties);\n                if (prop.items && prop.items.type) {\n                    try {\n                        pathsToLoad.add(this.getFieldPath(prop.items.type, prop.items.ui?.widget));\n                    } catch (e) {\n                        const msg = `[MetaUI LazyLoad] Could not find mapped plugin for array item type ${prop.items.type}: ${(e as Error).message}`;\n                        Logger.error(msg);\n                        throw new Error(msg);\n                    }\n                }\n            }\n        };\n\n        if (schema.properties) {\n            scanProperties(schema.properties);\n        } else if (schema.items && schema.items.properties) {\n            scanProperties(schema.items.properties);\n        }\n\n        return pathsToLoad;\n    }\n\n    /**\n     * Defers the generation of the UI until all required UI5 modules have been\n     * downloaded asynchronously. Maintains a cache of active promises to prevent\n     * redundant network requests for the same module.\n     * \n     * @param {ISchema} schema The root JSON schema payload to parse\n     * @returns {Promise<void>} Resolves when all dependencies are securely in the UI5 require cache\n     */\n    public async preloadDependencies(schema: ISchema): Promise<void> {\n        const pathsToLoad = this.getPathsToLoad(schema);\n\n        // 3. Batch execute sap.ui.require via Promises\n        const promises = Array.from(pathsToLoad).map(path => {\n            if (!this.activePromises[path]) {\n                this.activePromises[path] = new Promise((resolve, reject) => {\n                    sap.ui.require([path], \n                        (Module: unknown) => resolve(Module), \n                        (err: unknown) => {\n                            Logger.error(`Failed to lazy load module: ${path}`);\n                            // CRITICAL: Delete from cache so future attempts can retry the network request\n                            delete this.activePromises[path];\n                            reject(err);\n                        }\n                    );\n                });\n            }\n            return this.activePromises[path];\n        });\n\n        await Promise.all(promises);\n    }\n\n    /**\n     * Extracts a valid constructor from a dynamically required module.\n     */\n    private extractConstructor(Module: unknown): new () => IPlugin | ILayoutManager | null {\n        if (!Module) return null;\n        if (typeof Module === \"function\") return Module as any;\n        if ((Module as any).default && typeof (Module as any).default === \"function\") return (Module as any).default;\n        \n        // Handle namespace exports (e.g. { FormLayout: class... })\n        const keys = Object.keys(Module as object);\n        for (const key of keys) {\n            if (typeof (Module as any)[key] === \"function\") {\n                return (Module as any)[key];\n            }\n        }\n        return null;\n    }\n\n    /**\n     * Instantiates the requested plugin for the given field type.\n     */\n    public getPlugin(type: FieldType, widgetName?: string): IPlugin {\n        const path = this.getFieldPath(type, widgetName);\n        const Module = sap.ui.require(path);\n        const PluginClass = this.extractConstructor(Module);\n        \n        if (!PluginClass) {\n            throw new Error(`[MetaUI Plugin Instantiation] Plugin ${path} was not preloaded or has no constructor!`);\n        }\n        \n        return new PluginClass();\n    }\n\n    /**\n     * Instantiates the requested layout manager for the given strategy.\n     */\n    public getLayout(strategy: string): ILayoutManager {\n        const path = this.getLayoutPath(strategy);\n        const Module = sap.ui.require(path);\n        const LayoutClass = this.extractConstructor(Module);\n        \n        if (!LayoutClass) {\n            throw new Error(`[MetaUI Layout Instantiation] Layout ${path} was not preloaded or has no constructor!`);\n        }\n        \n        return new LayoutClass();\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"PluginRegistry.js","names":["Logger","___utils_Logger","PluginRegistry","fieldIndex","actionIndex","layoutIndex","activePromises","constructor","this","registerPluginPath","undefined","registerLayoutPath","getInstance","instance","type","widgetName","path","key","registerActionPath","actionName","strategy","getFieldPath","Error","getLayoutPath","getPathsToLoad","schema","pathsToLoad","Set","layoutStrategy","add","scanProperties","props","prop","ui","widget","e","msg","message","error","properties","items","preloadDependencies","promises","Array","from","map","Promise","resolve","reject","sap","require","Module","err","all","extractConstructor","default","keys","Object","getPlugin","PluginClass","getLayout","LayoutClass","__exports","__esModule"],"sources":["PluginRegistry.ts"],"sourcesContent":["/**\n * @file PluginRegistry.ts\n * @description Centralized hub for mapping UI5 controls to SAP schema data types.\n * Enforces the Registry Pattern to decouple the core engine from specific UI5 control implementations.\n * NOW WITH UNIVERSAL LAZY LOADING.\n */\n\nimport { IPlugin } from \"../interfaces/IPlugin\";\nimport { FieldType, ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { Logger } from \"../utils/Logger\";\nimport { DefaultLayoutGenerator } from \"./DefaultLayoutGenerator\";\n\nexport class PluginRegistry {\n    private static instance: PluginRegistry;\n    \n    private fieldIndex: Record<string, string> = {};\n    private actionIndex: Record<string, string> = {};\n    private layoutIndex: Record<string, string> = {};\n    \n    private activePromises: Record<string, Promise<unknown>> = {};\n\n    private constructor() {\n        // Core Mappings\n        this.registerPluginPath(\"string\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/StringPlugin\");\n        this.registerPluginPath(\"number\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin\");\n        this.registerPluginPath(\"integer\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin\");\n        this.registerPluginPath(\"date\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/DatePlugin\");\n        this.registerPluginPath(\"boolean\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/BooleanPlugin\");\n        this.registerPluginPath(\"array\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin\");\n        this.registerPluginPath(\"object\", undefined, \"nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin\");\n\n        // Widget Overrides\n        this.registerPluginPath(\"string\", \"time\", \"nz/co/siliconst/ui5/metaui/plugins/controls/TimePlugin\");\n        this.registerPluginPath(\"string\", \"datetime\", \"nz/co/siliconst/ui5/metaui/plugins/controls/DateTimePlugin\");\n        this.registerPluginPath(\"boolean\", \"switch\", \"nz/co/siliconst/ui5/metaui/plugins/controls/SwitchPlugin\");\n        this.registerPluginPath(\"number\", \"step\", \"nz/co/siliconst/ui5/metaui/plugins/controls/StepInputPlugin\");\n        this.registerPluginPath(\"string\", \"select\", \"nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin\");\n        this.registerPluginPath(\"string\", \"textArea\", \"nz/co/siliconst/ui5/metaui/plugins/controls/TextAreaPlugin\");\n        this.registerPluginPath(\"string\", \"codeEditor\", \"nz/co/siliconst/ui5/metaui/plugins/controls/CodeEditorPlugin\");\n        \n        // Phase 1 Mappings\n        this.registerPluginPath(\"string\", \"fileUploader\", \"nz/co/siliconst/ui5/metaui/plugins/controls/FileUploaderPlugin\");\n        this.registerPluginPath(\"array\", \"multiSelect\", \"nz/co/siliconst/ui5/metaui/plugins/controls/MultiSelectPlugin\");\n        this.registerPluginPath(\"array\", \"multiInput\", \"nz/co/siliconst/ui5/metaui/plugins/controls/MultiInputPlugin\");\n        this.registerPluginPath(\"number\", \"slider\", \"nz/co/siliconst/ui5/metaui/plugins/controls/SliderPlugin\");\n        this.registerPluginPath(\"number\", \"rating\", \"nz/co/siliconst/ui5/metaui/plugins/controls/RatingIndicatorPlugin\");\n        this.registerPluginPath(\"string\", \"messageStrip\", \"nz/co/siliconst/ui5/metaui/plugins/controls/MessageStripPlugin\");\n\n        // Phase 5 Mappings (Hardware)\n        this.registerPluginPath(\"string\", \"camera\", \"nz/co/siliconst/ui5/metaui/plugins/controls/CameraPlugin\");\n        this.registerPluginPath(\"string\", \"signature\", \"nz/co/siliconst/ui5/metaui/plugins/controls/SignaturePlugin\");\n        this.registerPluginPath(\"object\", \"location\", \"nz/co/siliconst/ui5/metaui/plugins/controls/GeolocationPlugin\");\n        this.registerPluginPath(\"string\", \"scanner\", \"nz/co/siliconst/ui5/metaui/plugins/controls/BarcodeScannerPlugin\");\n        this.registerPluginPath(\"string\", \"voiceInput\", \"nz/co/siliconst/ui5/metaui/plugins/controls/VoiceInputPlugin\");\n        this.registerPluginPath(\"string\", \"richText\", \"nz/co/siliconst/ui5/metaui/plugins/controls/RichTextPlugin\");\n\n        // Actions & Datasources\n        this.registerPluginPath(\"string\", \"urlButton\", \"nz/co/siliconst/ui5/metaui/plugins/actions/UrlNavigationActionPlugin\");\n        this.registerPluginPath(\"string\", \"submitButton\", \"nz/co/siliconst/ui5/metaui/plugins/actions/SubmitFormActionPlugin\");\n        this.registerPluginPath(\"string\", \"odataSelect\", \"nz/co/siliconst/ui5/metaui/plugins/datasources/ODataListBindingPlugin\");\n        this.registerPluginPath(\"string\", \"remoteDropdown\", \"nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteDropdownPlugin\");\n        this.registerPluginPath(\"string\", \"liveSearch\", \"nz/co/siliconst/ui5/metaui/plugins/datasources/LiveSearchPlugin\");\n        this.registerPluginPath(\"string\", \"remoteValueHelp\", \"nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteValueHelpPlugin\");\n\n        // Layouts\n        this.registerLayoutPath(\"form\", \"nz/co/siliconst/ui5/metaui/layouts/FormLayout\");\n        this.registerLayoutPath(\"table\", \"nz/co/siliconst/ui5/metaui/layouts/TableLayout\");\n        this.registerLayoutPath(\"wizard\", \"nz/co/siliconst/ui5/metaui/layouts/WizardLayout\");\n        this.registerLayoutPath(\"compact\", \"nz/co/siliconst/ui5/metaui/layouts/CompactLayout\");\n    }\n\n    public static getInstance(): PluginRegistry {\n        if (!PluginRegistry.instance) {\n            PluginRegistry.instance = new PluginRegistry();\n        }\n        return PluginRegistry.instance;\n    }\n\n    public registerPluginPath(type: FieldType, widgetName: string | undefined, path: string): void {\n        const key = widgetName ? `${type}:${widgetName}` : type;\n        this.fieldIndex[key] = path;\n    }\n\n    public registerActionPath(actionName: string, path: string): void {\n        this.actionIndex[actionName] = path;\n    }\n\n    public registerLayoutPath(strategy: string, path: string): void {\n        this.layoutIndex[strategy] = path;\n    }\n\n    private getFieldPath(type: FieldType, widgetName?: string): string {\n        let path;\n        if (widgetName) {\n            path = this.fieldIndex[`${type}:${widgetName}`];\n        }\n        if (!path) {\n            path = this.fieldIndex[type];\n        }\n        if (!path) {\n            throw new Error(`No plugin path mapped for FieldType: ${type} (widget: ${widgetName})`);\n        }\n        return path;\n    }\n\n    private getLayoutPath(strategy: string): string {\n        const path = this.layoutIndex[strategy];\n        if (!path) {\n            throw new Error(`No layout path mapped for strategy: ${strategy}`);\n        }\n        return path;\n    }\n\n    /**\n     * Statically traverses the schema structure to identify all required plugins\n     * and layouts without actually instantiating them.\n     * \n     * @param {ISchema} schema The root JSON schema payload to traverse\n     * @returns {Set<string>} A distinct set of UI5 module paths required to render the schema\n     */\n    public getPathsToLoad(schema: ISchema): Set<string> {\n        const pathsToLoad = new Set<string>();\n        \n        // 1. Gather layout strategy\n        const strategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n        pathsToLoad.add(this.getLayoutPath(strategy));\n\n        // 2. Recursively gather field plugins\n        const scanProperties = (props: Record<string, IPropertyMetadata>) => {\n            for (const key in props) {\n                const prop = props[key];\n                try {\n                    pathsToLoad.add(this.getFieldPath(prop.type || \"string\", prop.ui?.widget));\n                } catch (e) {\n                    const msg = `[MetaUI LazyLoad] Could not find mapped plugin for field ${key}: ${(e as Error).message}`;\n                    Logger.error(msg);\n                    throw new Error(msg);\n                }\n                if (prop.properties) scanProperties(prop.properties);\n                if (prop.items && prop.items.properties) scanProperties(prop.items.properties);\n                if (prop.items && prop.items.type) {\n                    try {\n                        pathsToLoad.add(this.getFieldPath(prop.items.type, prop.items.ui?.widget));\n                    } catch (e) {\n                        const msg = `[MetaUI LazyLoad] Could not find mapped plugin for array item type ${prop.items.type}: ${(e as Error).message}`;\n                        Logger.error(msg);\n                        throw new Error(msg);\n                    }\n                }\n            }\n        };\n\n        if (schema.properties) {\n            scanProperties(schema.properties);\n        } else if (schema.items && schema.items.properties) {\n            scanProperties(schema.items.properties);\n        }\n\n        return pathsToLoad;\n    }\n\n    /**\n     * Defers the generation of the UI until all required UI5 modules have been\n     * downloaded asynchronously. Maintains a cache of active promises to prevent\n     * redundant network requests for the same module.\n     * \n     * @param {ISchema} schema The root JSON schema payload to parse\n     * @returns {Promise<void>} Resolves when all dependencies are securely in the UI5 require cache\n     */\n    public async preloadDependencies(schema: ISchema): Promise<void> {\n        const pathsToLoad = this.getPathsToLoad(schema);\n\n        // 3. Batch execute sap.ui.require via Promises\n        const promises = Array.from(pathsToLoad).map(path => {\n            if (!this.activePromises[path]) {\n                this.activePromises[path] = new Promise((resolve, reject) => {\n                    sap.ui.require([path], \n                        (Module: unknown) => resolve(Module), \n                        (err: unknown) => {\n                            Logger.error(`Failed to lazy load module: ${path}`);\n                            // CRITICAL: Delete from cache so future attempts can retry the network request\n                            delete this.activePromises[path];\n                            reject(err);\n                        }\n                    );\n                });\n            }\n            return this.activePromises[path];\n        });\n\n        await Promise.all(promises);\n    }\n\n    /**\n     * Extracts a valid constructor from a dynamically required module.\n     */\n    private extractConstructor(Module: unknown): new () => IPlugin | ILayoutManager | null {\n        if (!Module) return null;\n        if (typeof Module === \"function\") return Module as any;\n        if ((Module as any).default && typeof (Module as any).default === \"function\") return (Module as any).default;\n        \n        // Handle namespace exports (e.g. { FormLayout: class... })\n        const keys = Object.keys(Module as object);\n        for (const key of keys) {\n            if (typeof (Module as any)[key] === \"function\") {\n                return (Module as any)[key];\n            }\n        }\n        return null;\n    }\n\n    /**\n     * Instantiates the requested plugin for the given field type.\n     */\n    public getPlugin(type: FieldType, widgetName?: string): IPlugin {\n        const path = this.getFieldPath(type, widgetName);\n        const Module = sap.ui.require(path);\n        const PluginClass = this.extractConstructor(Module);\n        \n        if (!PluginClass) {\n            throw new Error(`[MetaUI Plugin Instantiation] Plugin ${path} was not preloaded or has no constructor!`);\n        }\n        \n        return new PluginClass();\n    }\n\n    /**\n     * Instantiates the requested layout manager for the given strategy.\n     */\n    public getLayout(strategy: string): ILayoutManager {\n        const path = this.getLayoutPath(strategy);\n        const Module = sap.ui.require(path);\n        const LayoutClass = this.extractConstructor(Module);\n        \n        if (!LayoutClass) {\n            throw new Error(`[MetaUI Layout Instantiation] Layout ${path} was not preloaded or has no constructor!`);\n        }\n        \n        return new LayoutClass();\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -34,6 +34,7 @@ export class PluginRegistry {
         this.registerPluginPath("string", "time", "nz/co/siliconst/ui5/metaui/plugins/controls/TimePlugin");
         this.registerPluginPath("string", "datetime", "nz/co/siliconst/ui5/metaui/plugins/controls/DateTimePlugin");
         this.registerPluginPath("boolean", "switch", "nz/co/siliconst/ui5/metaui/plugins/controls/SwitchPlugin");
+        this.registerPluginPath("number", "step", "nz/co/siliconst/ui5/metaui/plugins/controls/StepInputPlugin");
         this.registerPluginPath("string", "select", "nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin");
         this.registerPluginPath("string", "textArea", "nz/co/siliconst/ui5/metaui/plugins/controls/TextAreaPlugin");
         this.registerPluginPath("string", "codeEditor", "nz/co/siliconst/ui5/metaui/plugins/controls/CodeEditorPlugin");

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

@@ -0,0 +1,47 @@
+sap.ui.define(["./SchemaNormalizer", "../swagger/SwaggerBuilder", "../utils/Logger"], function (___SchemaNormalizer, ___swagger_SwaggerBuilder, ___utils_Logger) {
+  "use strict";
+
+  /**
+   * @file SchemaBuilderRegistry.ts
+   * @description Singleton registry for Schema Builder plugins.
+   * Routes unknown JSON payloads to the appropriate parser plugin.
+   */
+  const SchemaNormalizer = ___SchemaNormalizer["SchemaNormalizer"];
+  const SwaggerBuilder = ___swagger_SwaggerBuilder["SwaggerBuilder"];
+  const Logger = ___utils_Logger["Logger"];
+  class SchemaBuilderRegistry {
+    static _plugins = [new SwaggerBuilder(), new SchemaNormalizer()];
+
+    /**
+     * Registers a new schema builder plugin into the engine.
+     * @param plugin An instance of ISchemaBuilderPlugin
+     */
+    static register(plugin) {
+      this._plugins.push(plugin);
+    }
+
+    /**
+     * Finds the first registered plugin that claims it can handle the payload.
+     * @param rawSchema The raw JSON schema object to inspect.
+     * @returns The matching plugin instance, or null if none match.
+     */
+    static getBuilderFor(rawSchema) {
+      if (!rawSchema || typeof rawSchema !== "object") {
+        return null;
+      }
+      for (const plugin of this._plugins) {
+        if (plugin.canHandle(rawSchema)) {
+          return plugin;
+        }
+      }
+      Logger.warn("[SchemaBuilderRegistry]", "No suitable Schema Builder plugin found for the provided payload.");
+      return null;
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.SchemaBuilderRegistry = SchemaBuilderRegistry;
+  return __exports;
+});
+//# sourceMappingURL=SchemaBuilderRegistry-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBuilderRegistry-dbg.js","names":["SchemaNormalizer","___SchemaNormalizer","SwaggerBuilder","___swagger_SwaggerBuilder","Logger","___utils_Logger","SchemaBuilderRegistry","_plugins","register","plugin","push","getBuilderFor","rawSchema","canHandle","warn","__exports","__esModule"],"sources":["SchemaBuilderRegistry.ts"],"sourcesContent":["/**\n * @file SchemaBuilderRegistry.ts\n * @description Singleton registry for Schema Builder plugins.\n * Routes unknown JSON payloads to the appropriate parser plugin.\n */\n\nimport { ISchemaBuilderPlugin } from \"../interfaces/ISchemaBuilderPlugin\";\nimport { SchemaNormalizer } from \"./SchemaNormalizer\";\nimport { SwaggerBuilder } from \"../swagger/SwaggerBuilder\";\nimport { Logger } from \"../utils/Logger\";\n\nexport class SchemaBuilderRegistry {\n    private static _plugins: ISchemaBuilderPlugin[] = [\n        new SwaggerBuilder(),\n        new SchemaNormalizer()\n    ];\n\n    /**\n     * Registers a new schema builder plugin into the engine.\n     * @param plugin An instance of ISchemaBuilderPlugin\n     */\n    public static register(plugin: ISchemaBuilderPlugin): void {\n        this._plugins.push(plugin);\n    }\n\n    /**\n     * Finds the first registered plugin that claims it can handle the payload.\n     * @param rawSchema The raw JSON schema object to inspect.\n     * @returns The matching plugin instance, or null if none match.\n     */\n    public static getBuilderFor(rawSchema: any): ISchemaBuilderPlugin | null {\n        if (!rawSchema || typeof rawSchema !== \"object\") {\n            return null;\n        }\n\n        for (const plugin of this._plugins) {\n            if (plugin.canHandle(rawSchema)) {\n                return plugin;\n            }\n        }\n        \n        Logger.warn(\"[SchemaBuilderRegistry]\", \"No suitable Schema Builder plugin found for the provided payload.\");\n        return null;\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;AACA;EAJA,MAOSA,gBAAgB,GAAAC,mBAAA;EAAA,MAChBC,cAAc,GAAAC,yBAAA;EAAA,MACdC,MAAM,GAAAC,eAAA;EAER,MAAMC,qBAAqB,CAAC;IAC/B,OAAeC,QAAQ,GAA2B,CAC9C,IAAIL,cAAc,CAAC,CAAC,EACpB,IAAIF,gBAAgB,CAAC,CAAC,CACzB;;IAED;AACJ;AACA;AACA;IACI,OAAcQ,QAAQA,CAACC,MAA4B,EAAQ;MACvD,IAAI,CAACF,QAAQ,CAACG,IAAI,CAACD,MAAM,CAAC;IAC9B;;IAEA;AACJ;AACA;AACA;AACA;IACI,OAAcE,aAAaA,CAACC,SAAc,EAA+B;MACrE,IAAI,CAACA,SAAS,IAAI,OAAOA,SAAS,KAAK,QAAQ,EAAE;QAC7C,OAAO,IAAI;MACf;MAEA,KAAK,MAAMH,MAAM,IAAI,IAAI,CAACF,QAAQ,EAAE;QAChC,IAAIE,MAAM,CAACI,SAAS,CAACD,SAAS,CAAC,EAAE;UAC7B,OAAOH,MAAM;QACjB;MACJ;MAEAL,MAAM,CAACU,IAAI,CAAC,yBAAyB,EAAE,mEAAmE,CAAC;MAC3G,OAAO,IAAI;IACf;EACJ;EAAC,IAAAC,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAT,qBAAA,GAAAA,qBAAA;EAAA,OAAAS,SAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,23 @@
+declare module "nz/co/siliconst/ui5/metaui/core/SchemaBuilderRegistry" {
+    /**
+     * @file SchemaBuilderRegistry.ts
+     * @description Singleton registry for Schema Builder plugins.
+     * Routes unknown JSON payloads to the appropriate parser plugin.
+     */
+    import { ISchemaBuilderPlugin } from "nz/co/siliconst/ui5/metaui/interfaces/ISchemaBuilderPlugin";
+    export class SchemaBuilderRegistry {
+        private static _plugins;
+        /**
+         * Registers a new schema builder plugin into the engine.
+         * @param plugin An instance of ISchemaBuilderPlugin
+         */
+        static register(plugin: ISchemaBuilderPlugin): void;
+        /**
+         * Finds the first registered plugin that claims it can handle the payload.
+         * @param rawSchema The raw JSON schema object to inspect.
+         * @returns The matching plugin instance, or null if none match.
+         */
+        static getBuilderFor(rawSchema: any): ISchemaBuilderPlugin | null;
+    }
+}
+//# sourceMappingURL=SchemaBuilderRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBuilderRegistry.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/SchemaBuilderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,uDAAuD,CAAC;IACvE;;;;OAIG;IAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,4DAA4D,CAAC;IAKlG,MAAa,qBAAqB;QAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAGrB;QAEF;;;WAGG;eACW,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;QAI1D;;;;WAIG;eACW,aAAa,CAAC,SAAS,EAAE,GAAG,GAAG,oBAAoB,GAAG,IAAI;KAc3E;CAEA"}

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

@@ -0,0 +1,2 @@
+sap.ui.define(["./SchemaNormalizer","../swagger/SwaggerBuilder","../utils/Logger"],function(e,r,i){"use strict";const t=e["SchemaNormalizer"];const s=r["SwaggerBuilder"];const u=i["Logger"];class n{static _plugins=[new s,new t];static register(e){this._plugins.push(e)}static getBuilderFor(e){if(!e||typeof e!=="object"){return null}for(const r of this._plugins){if(r.canHandle(e)){return r}}u.warn("[SchemaBuilderRegistry]","No suitable Schema Builder plugin found for the provided payload.");return null}}var a={__esModule:true};a.SchemaBuilderRegistry=n;return a});
+//# sourceMappingURL=SchemaBuilderRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBuilderRegistry.js","names":["SchemaNormalizer","___SchemaNormalizer","SwaggerBuilder","___swagger_SwaggerBuilder","Logger","___utils_Logger","SchemaBuilderRegistry","static","register","plugin","this","_plugins","push","getBuilderFor","rawSchema","canHandle","warn","__exports","__esModule"],"sources":["SchemaBuilderRegistry.ts"],"sourcesContent":["/**\n * @file SchemaBuilderRegistry.ts\n * @description Singleton registry for Schema Builder plugins.\n * Routes unknown JSON payloads to the appropriate parser plugin.\n */\n\nimport { ISchemaBuilderPlugin } from \"../interfaces/ISchemaBuilderPlugin\";\nimport { SchemaNormalizer } from \"./SchemaNormalizer\";\nimport { SwaggerBuilder } from \"../swagger/SwaggerBuilder\";\nimport { Logger } from \"../utils/Logger\";\n\nexport class SchemaBuilderRegistry {\n    private static _plugins: ISchemaBuilderPlugin[] = [\n        new SwaggerBuilder(),\n        new SchemaNormalizer()\n    ];\n\n    /**\n     * Registers a new schema builder plugin into the engine.\n     * @param plugin An instance of ISchemaBuilderPlugin\n     */\n    public static register(plugin: ISchemaBuilderPlugin): void {\n        this._plugins.push(plugin);\n    }\n\n    /**\n     * Finds the first registered plugin that claims it can handle the payload.\n     * @param rawSchema The raw JSON schema object to inspect.\n     * @returns The matching plugin instance, or null if none match.\n     */\n    public static getBuilderFor(rawSchema: any): ISchemaBuilderPlugin | null {\n        if (!rawSchema || typeof rawSchema !== \"object\") {\n            return null;\n        }\n\n        for (const plugin of this._plugins) {\n            if (plugin.canHandle(rawSchema)) {\n                return plugin;\n            }\n        }\n        \n        Logger.warn(\"[SchemaBuilderRegistry]\", \"No suitable Schema Builder plugin found for the provided payload.\");\n        return null;\n    }\n}\n"],"mappings":"gHAAA,MAOSA,EAAgBC,EAAA,0BAChBC,EAAcC,EAAA,wBACdC,EAAMC,EAAA,UAER,MAAMC,EACTC,gBAAkD,CAC9C,IAAIL,EACJ,IAAIF,GAOR,eAAcQ,CAASC,GACnBC,KAAKC,SAASC,KAAKH,EACvB,CAOA,oBAAcI,CAAcC,GACxB,IAAKA,UAAoBA,IAAc,SAAU,CAC7C,OAAO,IACX,CAEA,IAAK,MAAML,KAAUC,KAAKC,SAAU,CAChC,GAAIF,EAAOM,UAAUD,GAAY,CAC7B,OAAOL,CACX,CACJ,CAEAL,EAAOY,KAAK,0BAA2B,qEACvC,OAAO,IACX,EACH,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAAX,wBAAA,OAAAW,CAAA","ignoreList":[]}

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

@@ -0,0 +1,45 @@
+/**
+ * @file SchemaBuilderRegistry.ts
+ * @description Singleton registry for Schema Builder plugins.
+ * Routes unknown JSON payloads to the appropriate parser plugin.
+ */
+
+import { ISchemaBuilderPlugin } from "../interfaces/ISchemaBuilderPlugin";
+import { SchemaNormalizer } from "./SchemaNormalizer";
+import { SwaggerBuilder } from "../swagger/SwaggerBuilder";
+import { Logger } from "../utils/Logger";
+
+export class SchemaBuilderRegistry {
+    private static _plugins: ISchemaBuilderPlugin[] = [
+        new SwaggerBuilder(),
+        new SchemaNormalizer()
+    ];
+
+    /**
+     * Registers a new schema builder plugin into the engine.
+     * @param plugin An instance of ISchemaBuilderPlugin
+     */
+    public static register(plugin: ISchemaBuilderPlugin): void {
+        this._plugins.push(plugin);
+    }
+
+    /**
+     * Finds the first registered plugin that claims it can handle the payload.
+     * @param rawSchema The raw JSON schema object to inspect.
+     * @returns The matching plugin instance, or null if none match.
+     */
+    public static getBuilderFor(rawSchema: any): ISchemaBuilderPlugin | null {
+        if (!rawSchema || typeof rawSchema !== "object") {
+            return null;
+        }
+
+        for (const plugin of this._plugins) {
+            if (plugin.canHandle(rawSchema)) {
+                return plugin;
+            }
+        }
+        
+        Logger.warn("[SchemaBuilderRegistry]", "No suitable Schema Builder plugin found for the provided payload.");
+        return null;
+    }
+}

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

@@ -7,6 +7,23 @@ sap.ui.define(["../utils/Logger"], function (___utils_Logger) {
    */
   const Logger = ___utils_Logger["Logger"];
   class SchemaNormalizer {
+    /**
+     * ISchemaBuilderPlugin Contract
+     */
+    canHandle(rawSchema) {
+      // MetaUI native schemas almost always have properties, items, or a layoutStrategy
+      // This acts as a fallback for native schemas.
+      if (rawSchema.openapi || rawSchema.swagger) return false;
+      return true;
+    }
+
+    /**
+     * ISchemaBuilderPlugin Contract
+     */
+    build(rawSchema) {
+      return SchemaNormalizer.normalize(rawSchema);
+    }
+
     /**
      * Validates that the provided raw payload conforms to the required ISchema structures.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"SchemaNormalizer-dbg.js","names":["Logger","___utils_Logger","SchemaNormalizer","normalize","rawSchema","data","schemaObj","trim","JSON","parse","e","msg","message","error","Error","Array","isArray","inferSchemaFromData","normalized","title","type","items","layoutStrategy","uiLayout","additionalProperties","targetProperties","properties","inferred","deepMergeProperties","requiredKeys","required","normalizeProperties","normalizePropertyMetadata","base","override","merged","key","Object","keys","overrideVal","baseVal","normalizedProps","isRequired","includes","prop","keyName","ui","label","generateLabel","isKey","readOnly","widget","valueHelp","enum","undefined","visibleOn","enabledOn","format","validators","formatter","args","rows","fullWidth","dialogButtonText","maxLength","minLength","minimum","maximum","pattern","precision","scale","multipleOf","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","schema","inferPropertiesFromObject","obj","val","nestedProps","resolveScope","scope","startsWith","meta","bindingPath","propKey","pathSegments","current","debug","stringify","i","segment","__exports","__esModule"],"sources":["SchemaNormalizer.ts"],"sourcesContent":["/**\n * @file SchemaNormalizer.ts\n * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.\n */\n\nimport { ISchema, IPropertyMetadata, FieldType } from \"../interfaces/ISchema\";\nimport { Logger } from \"../utils/Logger\";\n\nexport class SchemaNormalizer {\n\n    /**\n     * Validates that the provided raw payload conforms to the required ISchema structures.\n     */\n    public static normalize(rawSchema?: unknown, data?: unknown): ISchema {\n        let schemaObj = rawSchema;\n\n        if (typeof schemaObj === \"string\") {\n            if (!schemaObj.trim()) {\n                schemaObj = null;\n            } else {\n                try {\n                    schemaObj = JSON.parse(schemaObj);\n                } catch (e) {\n                    const msg = \"Failed to parse schema string: \" + (e as Error).message;\n                    Logger.error(\"[MetaUI SchemaNormalizer]\", msg);\n                    throw new Error(msg);\n                }\n            }\n        }\n\n        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {\n            return this.inferSchemaFromData(data);\n        }\n\n        try {\n            // It is an object. Ensure it conforms to v2 structure.\n            const normalized: ISchema = {\n                title: schemaObj.title,\n                type: schemaObj.type || (schemaObj.items ? \"array\" : \"object\"),\n                layoutStrategy: schemaObj.layoutStrategy,\n                uiLayout: schemaObj.uiLayout,\n                additionalProperties: schemaObj.additionalProperties\n            };\n\n            let targetProperties = schemaObj.properties || {};\n\n            if (schemaObj.additionalProperties === true && data) {\n                const inferred = this.inferSchemaFromData(data);\n                if (inferred.type === \"object\" && inferred.properties) {\n                    targetProperties = this.deepMergeProperties(inferred.properties, targetProperties);\n                } else if (inferred.type === \"array\" && inferred.items && inferred.items.properties) {\n                    // Array schema merging could be added here if we want full support.\n                }\n            }\n\n            if (normalized.type === \"object\") {\n                const requiredKeys = Array.isArray(schemaObj.required) ? schemaObj.required : [];\n                normalized.properties = this.normalizeProperties(targetProperties, requiredKeys);\n            } else if (normalized.type === \"array\") {\n                // Future expansion: array deep merge\n                normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: \"object\", properties: {} }, \"items\", false);\n            }\n\n            return normalized;\n        } catch (error) {\n            const msg = \"Critical error normalizing schema object: \" + (error as Error).message;\n            Logger.error(\"[MetaUI SchemaNormalizer]\", msg);\n            throw new Error(msg);\n        }\n    }\n\n    /**\n     * Recursively deep merges an inferred schema over a base schema.\n     * @param base The base property dictionary.\n     * @param override The overriding inferred dictionary.\n     * @returns A new deeply merged property dictionary.\n     */\n    private static deepMergeProperties(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown> {\n        const merged = { ...base };\n        for (const key of Object.keys(override)) {\n            const overrideVal = override[key];\n            const baseVal = merged[key];\n\n            if (baseVal && typeof baseVal === \"object\" && !Array.isArray(baseVal) &&\n                overrideVal && typeof overrideVal === \"object\" && !Array.isArray(overrideVal)) {\n                merged[key] = this.deepMergeProperties(baseVal, overrideVal);\n            } else {\n                merged[key] = overrideVal;\n            }\n        }\n        return merged;\n    }\n\n    /**\n     * Normalizes a collection of properties.\n     * @param properties The raw properties map.\n     * @param requiredKeys An optional array of keys that are required by the parent object.\n     * @returns A map of strict IPropertyMetadata objects.\n     */\n    private static normalizeProperties(properties: Record<string, unknown>, requiredKeys: string[] = []): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        for (const key of Object.keys(properties)) {\n            const isRequired = requiredKeys.includes(key);\n            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key, isRequired);\n        }\n        return normalizedProps;\n    }\n\n    /**\n     * Normalizes a single property against the ISchema specification.\n     * @param prop The raw property definition.\n     * @param keyName The string key name for generating default labels.\n     * @param isRequired Indicates if the parent object mandated this property as required.\n     * @returns A strict IPropertyMetadata instance.\n     */\n    private static normalizePropertyMetadata(prop: Record<string, unknown>, keyName: string, isRequired: boolean = false): IPropertyMetadata {\n        const normalized: IPropertyMetadata = {\n            type: prop.type || \"string\",\n            ui: {\n                label: prop.ui?.label || this.generateLabel(keyName),\n                isKey: !!prop.ui?.isKey,\n                readOnly: !!prop.ui?.readOnly,\n                widget: prop.ui?.widget || (prop.valueHelp || prop.enum ? \"select\" : undefined),\n                visibleOn: prop.ui?.visibleOn,\n                enabledOn: prop.ui?.enabledOn,\n                format: prop.ui?.format,\n                validators: prop.ui?.validators,\n                formatter: prop.ui?.formatter,\n                args: prop.ui?.args,\n                rows: prop.ui?.rows,\n                fullWidth: prop.ui?.fullWidth,\n                dialogButtonText: prop.ui?.dialogButtonText\n            },\n            required: isRequired || !!prop.required,\n            maxLength: prop.maxLength as number,\n            minLength: prop.minLength as number,\n            minimum: prop.minimum,\n            maximum: prop.maximum,\n            pattern: prop.pattern,\n            precision: prop.precision,\n            scale: prop.scale,\n            multipleOf: prop.multipleOf as number,\n            valueHelp: prop.valueHelp,\n            enum: prop.enum\n        };\n\n        if (normalized.type === \"object\" && prop.properties) {\n            const requiredKeys = Array.isArray(prop.required) ? prop.required : [];\n            normalized.properties = this.normalizeProperties(prop.properties as Record<string, unknown>, requiredKeys);\n            normalized.uiLayout = prop.uiLayout;\n        } else if (normalized.type === \"array\" && prop.items) {\n            normalized.items = this.normalizePropertyMetadata(prop.items as Record<string, unknown>, \"items\", false);\n            normalized.uiLayout = prop.uiLayout;\n        }\n\n        return normalized;\n    }\n\n    /**\n     * Generates a Title Case label from camelCase or snake_case technical names.\n     */\n    private static generateLabel(name: string): string {\n        if (!name) return \"\";\n        let spaced = name.replace(/([A-Z])/g, \" $1\").replace(/_/g, \" \");\n        return spaced.split(' ')\n            .filter(w => w.length > 0)\n            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n            .join(' ')\n            .trim();\n    }\n\n    /**\n     * Infers a v2 ISchema structure dynamically from a plain data payload.\n     */\n    public static inferSchemaFromData(data: unknown): ISchema {\n        const schema: ISchema = { type: \"object\", properties: {}, layoutStrategy: \"compact\", title: \"\" };\n\n        if (!data || typeof data !== \"object\") {\n            return schema;\n        }\n\n        if (Array.isArray(data)) {\n            schema.type = \"array\";\n            if (data.length > 0 && typeof data[0] !== \"object\") {\n                schema.layoutStrategy = \"compact\";\n                schema.items = { type: typeof data[0] as FieldType };\n            } else {\n                schema.layoutStrategy = \"table\";\n                schema.items = {\n                    type: \"object\",\n                    layoutStrategy: \"compact\",\n                    properties: data.length > 0 ? this.inferPropertiesFromObject(data[0] as Record<string, unknown>) : {}\n                };\n            }\n        } else {\n            schema.type = \"object\";\n            schema.properties = this.inferPropertiesFromObject(data);\n        }\n\n        return schema;\n    }\n\n    /**\n     * Infers field metadata recursively from a raw data object.\n     * @param obj The raw JavaScript object.\n     * @returns A dictionary of inferred IPropertyMetadata.\n     */\n    private static inferPropertiesFromObject(obj: Record<string, unknown>): Record<string, IPropertyMetadata> {\n        const properties: Record<string, IPropertyMetadata> = {};\n        if (!obj || typeof obj !== \"object\") return properties;\n\n        for (const key of Object.keys(obj)) {\n            const val = obj[key];\n            if (val === null || val === undefined) continue;\n\n            let type: FieldType = \"string\";\n            let items: IPropertyMetadata | undefined;\n            let nestedProps: Record<string, IPropertyMetadata> | undefined;\n\n            if (typeof val === \"number\") type = \"number\";\n            else if (typeof val === \"boolean\") type = \"boolean\";\n            else if (Array.isArray(val)) {\n                type = \"array\";\n                if (val.length > 0 && typeof val[0] !== \"object\") {\n                    items = {\n                        type: typeof val[0] as FieldType\n                    };\n                } else {\n                    items = {\n                        type: \"object\",\n                        properties: val.length > 0 ? this.inferPropertiesFromObject(val[0] as Record<string, unknown>) : {}\n                    };\n                }\n            } else if (typeof val === \"object\") {\n                type = \"object\";\n                nestedProps = this.inferPropertiesFromObject(val);\n            }\n\n            properties[key] = {\n                type,\n                items,\n                properties: nestedProps,\n                ui: {\n                    label: this.generateLabel(key),\n                    isKey: false,\n                    readOnly: false,\n                    widget: type === \"array\" && items?.type !== \"object\" ? \"multiInput\" : undefined\n                }\n            };\n        }\n\n        return properties;\n    }\n\n    /**\n     * Resolves a JSON Schema scope (e.g. '#/properties/header/properties/id')\n     * against the ISchema, returning the PropertyMetadata and the UI5 binding path.\n     */\n    public static resolveScope(schema: ISchema, scope: string): { meta: IPropertyMetadata | undefined, bindingPath: string, propKey: string } {\n        if (!scope || !scope.startsWith(\"#/properties/\")) {\n            return { meta: undefined, bindingPath: scope || \"\", propKey: scope || \"\" };\n        }\n        \n        const pathSegments = scope.replace(\"#/properties/\", \"\").split(\"/properties/\");\n        let current: Record<string, IPropertyMetadata> | undefined = schema.properties;\n        let meta: IPropertyMetadata | undefined;\n        \n        Logger.debug(\"[MetaUI SchemaNormalizer]\", `Resolving scope '${scope}' with segments: ${JSON.stringify(pathSegments)}`, \"SchemaNormalizer\");\n        Logger.debug(\"[MetaUI SchemaNormalizer]\", `Root schema keys: ${Object.keys(schema.properties || {})}`, \"SchemaNormalizer\");\n\n        for (let i = 0; i < pathSegments.length; i++) {\n            const segment = pathSegments[i];\n            if (!current) {\n                Logger.debug(\"[MetaUI SchemaNormalizer]\", `current is undefined at segment '${segment}'`, \"SchemaNormalizer\");\n                meta = undefined;\n                break;\n            }\n            meta = current[segment];\n            Logger.debug(\"[MetaUI SchemaNormalizer]\", `Segment '${segment}' resolved to meta: ${!!meta}. Available keys in current: ${Object.keys(current)}`, \"SchemaNormalizer\");\n            if (i < pathSegments.length - 1) {\n                current = meta?.properties;\n            }\n        }\n        \n        const bindingPath = pathSegments.join(\"/\");\n        const propKey = scope.replace(\"#/properties/\", \"\"); // The original raw string for logging\n        \n        return {\n            meta,\n            bindingPath,\n            propKey\n        };\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"SchemaNormalizer-dbg.js","names":["Logger","___utils_Logger","SchemaNormalizer","canHandle","rawSchema","openapi","swagger","build","normalize","data","schemaObj","trim","JSON","parse","e","msg","message","error","Error","Array","isArray","inferSchemaFromData","normalized","title","type","items","layoutStrategy","uiLayout","additionalProperties","targetProperties","properties","inferred","deepMergeProperties","requiredKeys","required","normalizeProperties","normalizePropertyMetadata","base","override","merged","key","Object","keys","overrideVal","baseVal","normalizedProps","isRequired","includes","prop","keyName","ui","label","generateLabel","isKey","readOnly","widget","valueHelp","enum","undefined","visibleOn","enabledOn","format","validators","formatter","args","rows","fullWidth","dialogButtonText","maxLength","minLength","minimum","maximum","pattern","precision","scale","multipleOf","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","schema","inferPropertiesFromObject","obj","val","nestedProps","resolveScope","scope","startsWith","meta","bindingPath","propKey","pathSegments","current","debug","stringify","i","segment","__exports","__esModule"],"sources":["SchemaNormalizer.ts"],"sourcesContent":["/**\n * @file SchemaNormalizer.ts\n * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.\n */\n\nimport { ISchema, IPropertyMetadata, FieldType } from \"../interfaces/ISchema\";\nimport { ISchemaBuilderPlugin } from \"../interfaces/ISchemaBuilderPlugin\";\nimport { Logger } from \"../utils/Logger\";\n\nexport class SchemaNormalizer implements ISchemaBuilderPlugin {\n\n    /**\n     * ISchemaBuilderPlugin Contract\n     */\n    public canHandle(rawSchema: any): boolean {\n        // MetaUI native schemas almost always have properties, items, or a layoutStrategy\n        // This acts as a fallback for native schemas.\n        if (rawSchema.openapi || rawSchema.swagger) return false; \n        return true;\n    }\n\n    /**\n     * ISchemaBuilderPlugin Contract\n     */\n    public build(rawSchema: any): ISchema {\n        return SchemaNormalizer.normalize(rawSchema);\n    }\n\n    /**\n     * Validates that the provided raw payload conforms to the required ISchema structures.\n     */\n    public static normalize(rawSchema?: unknown, data?: unknown): ISchema {\n        let schemaObj = rawSchema;\n\n        if (typeof schemaObj === \"string\") {\n            if (!schemaObj.trim()) {\n                schemaObj = null;\n            } else {\n                try {\n                    schemaObj = JSON.parse(schemaObj);\n                } catch (e) {\n                    const msg = \"Failed to parse schema string: \" + (e as Error).message;\n                    Logger.error(\"[MetaUI SchemaNormalizer]\", msg);\n                    throw new Error(msg);\n                }\n            }\n        }\n\n        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {\n            return this.inferSchemaFromData(data);\n        }\n\n        try {\n            // It is an object. Ensure it conforms to v2 structure.\n            const normalized: ISchema = {\n                title: schemaObj.title,\n                type: schemaObj.type || (schemaObj.items ? \"array\" : \"object\"),\n                layoutStrategy: schemaObj.layoutStrategy,\n                uiLayout: schemaObj.uiLayout,\n                additionalProperties: schemaObj.additionalProperties\n            };\n\n            let targetProperties = schemaObj.properties || {};\n\n            if (schemaObj.additionalProperties === true && data) {\n                const inferred = this.inferSchemaFromData(data);\n                if (inferred.type === \"object\" && inferred.properties) {\n                    targetProperties = this.deepMergeProperties(inferred.properties, targetProperties);\n                } else if (inferred.type === \"array\" && inferred.items && inferred.items.properties) {\n                    // Array schema merging could be added here if we want full support.\n                }\n            }\n\n            if (normalized.type === \"object\") {\n                const requiredKeys = Array.isArray(schemaObj.required) ? schemaObj.required : [];\n                normalized.properties = this.normalizeProperties(targetProperties, requiredKeys);\n            } else if (normalized.type === \"array\") {\n                // Future expansion: array deep merge\n                normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: \"object\", properties: {} }, \"items\", false);\n            }\n\n            return normalized;\n        } catch (error) {\n            const msg = \"Critical error normalizing schema object: \" + (error as Error).message;\n            Logger.error(\"[MetaUI SchemaNormalizer]\", msg);\n            throw new Error(msg);\n        }\n    }\n\n    /**\n     * Recursively deep merges an inferred schema over a base schema.\n     * @param base The base property dictionary.\n     * @param override The overriding inferred dictionary.\n     * @returns A new deeply merged property dictionary.\n     */\n    private static deepMergeProperties(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown> {\n        const merged = { ...base };\n        for (const key of Object.keys(override)) {\n            const overrideVal = override[key];\n            const baseVal = merged[key];\n\n            if (baseVal && typeof baseVal === \"object\" && !Array.isArray(baseVal) &&\n                overrideVal && typeof overrideVal === \"object\" && !Array.isArray(overrideVal)) {\n                merged[key] = this.deepMergeProperties(baseVal, overrideVal);\n            } else {\n                merged[key] = overrideVal;\n            }\n        }\n        return merged;\n    }\n\n    /**\n     * Normalizes a collection of properties.\n     * @param properties The raw properties map.\n     * @param requiredKeys An optional array of keys that are required by the parent object.\n     * @returns A map of strict IPropertyMetadata objects.\n     */\n    private static normalizeProperties(properties: Record<string, unknown>, requiredKeys: string[] = []): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        for (const key of Object.keys(properties)) {\n            const isRequired = requiredKeys.includes(key);\n            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key, isRequired);\n        }\n        return normalizedProps;\n    }\n\n    /**\n     * Normalizes a single property against the ISchema specification.\n     * @param prop The raw property definition.\n     * @param keyName The string key name for generating default labels.\n     * @param isRequired Indicates if the parent object mandated this property as required.\n     * @returns A strict IPropertyMetadata instance.\n     */\n    private static normalizePropertyMetadata(prop: Record<string, unknown>, keyName: string, isRequired: boolean = false): IPropertyMetadata {\n        const normalized: IPropertyMetadata = {\n            type: prop.type || \"string\",\n            ui: {\n                label: prop.ui?.label || this.generateLabel(keyName),\n                isKey: !!prop.ui?.isKey,\n                readOnly: !!prop.ui?.readOnly,\n                widget: prop.ui?.widget || (prop.valueHelp || prop.enum ? \"select\" : undefined),\n                visibleOn: prop.ui?.visibleOn,\n                enabledOn: prop.ui?.enabledOn,\n                format: prop.ui?.format,\n                validators: prop.ui?.validators,\n                formatter: prop.ui?.formatter,\n                args: prop.ui?.args,\n                rows: prop.ui?.rows,\n                fullWidth: prop.ui?.fullWidth,\n                dialogButtonText: prop.ui?.dialogButtonText\n            },\n            required: isRequired || !!prop.required,\n            maxLength: prop.maxLength as number,\n            minLength: prop.minLength as number,\n            minimum: prop.minimum,\n            maximum: prop.maximum,\n            pattern: prop.pattern,\n            precision: prop.precision,\n            scale: prop.scale,\n            multipleOf: prop.multipleOf as number,\n            valueHelp: prop.valueHelp,\n            enum: prop.enum\n        };\n\n        if (normalized.type === \"object\" && prop.properties) {\n            const requiredKeys = Array.isArray(prop.required) ? prop.required : [];\n            normalized.properties = this.normalizeProperties(prop.properties as Record<string, unknown>, requiredKeys);\n            normalized.uiLayout = prop.uiLayout;\n        } else if (normalized.type === \"array\" && prop.items) {\n            normalized.items = this.normalizePropertyMetadata(prop.items as Record<string, unknown>, \"items\", false);\n            normalized.uiLayout = prop.uiLayout;\n        }\n\n        return normalized;\n    }\n\n    /**\n     * Generates a Title Case label from camelCase or snake_case technical names.\n     */\n    private static generateLabel(name: string): string {\n        if (!name) return \"\";\n        let spaced = name.replace(/([A-Z])/g, \" $1\").replace(/_/g, \" \");\n        return spaced.split(' ')\n            .filter(w => w.length > 0)\n            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n            .join(' ')\n            .trim();\n    }\n\n    /**\n     * Infers a v2 ISchema structure dynamically from a plain data payload.\n     */\n    public static inferSchemaFromData(data: unknown): ISchema {\n        const schema: ISchema = { type: \"object\", properties: {}, layoutStrategy: \"compact\", title: \"\" };\n\n        if (!data || typeof data !== \"object\") {\n            return schema;\n        }\n\n        if (Array.isArray(data)) {\n            schema.type = \"array\";\n            if (data.length > 0 && typeof data[0] !== \"object\") {\n                schema.layoutStrategy = \"compact\";\n                schema.items = { type: typeof data[0] as FieldType };\n            } else {\n                schema.layoutStrategy = \"table\";\n                schema.items = {\n                    type: \"object\",\n                    layoutStrategy: \"compact\",\n                    properties: data.length > 0 ? this.inferPropertiesFromObject(data[0] as Record<string, unknown>) : {}\n                };\n            }\n        } else {\n            schema.type = \"object\";\n            schema.properties = this.inferPropertiesFromObject(data);\n        }\n\n        return schema;\n    }\n\n    /**\n     * Infers field metadata recursively from a raw data object.\n     * @param obj The raw JavaScript object.\n     * @returns A dictionary of inferred IPropertyMetadata.\n     */\n    private static inferPropertiesFromObject(obj: Record<string, unknown>): Record<string, IPropertyMetadata> {\n        const properties: Record<string, IPropertyMetadata> = {};\n        if (!obj || typeof obj !== \"object\") return properties;\n\n        for (const key of Object.keys(obj)) {\n            const val = obj[key];\n            if (val === null || val === undefined) continue;\n\n            let type: FieldType = \"string\";\n            let items: IPropertyMetadata | undefined;\n            let nestedProps: Record<string, IPropertyMetadata> | undefined;\n\n            if (typeof val === \"number\") type = \"number\";\n            else if (typeof val === \"boolean\") type = \"boolean\";\n            else if (Array.isArray(val)) {\n                type = \"array\";\n                if (val.length > 0 && typeof val[0] !== \"object\") {\n                    items = {\n                        type: typeof val[0] as FieldType\n                    };\n                } else {\n                    items = {\n                        type: \"object\",\n                        properties: val.length > 0 ? this.inferPropertiesFromObject(val[0] as Record<string, unknown>) : {}\n                    };\n                }\n            } else if (typeof val === \"object\") {\n                type = \"object\";\n                nestedProps = this.inferPropertiesFromObject(val);\n            }\n\n            properties[key] = {\n                type,\n                items,\n                properties: nestedProps,\n                ui: {\n                    label: this.generateLabel(key),\n                    isKey: false,\n                    readOnly: false,\n                    widget: type === \"array\" && items?.type !== \"object\" ? \"multiInput\" : undefined\n                }\n            };\n        }\n\n        return properties;\n    }\n\n    /**\n     * Resolves a JSON Schema scope (e.g. '#/properties/header/properties/id')\n     * against the ISchema, returning the PropertyMetadata and the UI5 binding path.\n     */\n    public static resolveScope(schema: ISchema, scope: string): { meta: IPropertyMetadata | undefined, bindingPath: string, propKey: string } {\n        if (!scope || !scope.startsWith(\"#/properties/\")) {\n            return { meta: undefined, bindingPath: scope || \"\", propKey: scope || \"\" };\n        }\n        \n        const pathSegments = scope.replace(\"#/properties/\", \"\").split(\"/properties/\");\n        let current: Record<string, IPropertyMetadata> | undefined = schema.properties;\n        let meta: IPropertyMetadata | undefined;\n        \n        Logger.debug(\"[MetaUI SchemaNormalizer]\", `Resolving scope '${scope}' with segments: ${JSON.stringify(pathSegments)}`, \"SchemaNormalizer\");\n        Logger.debug(\"[MetaUI SchemaNormalizer]\", `Root schema keys: ${Object.keys(schema.properties || {})}`, \"SchemaNormalizer\");\n\n        for (let i = 0; i < pathSegments.length; i++) {\n            const segment = pathSegments[i];\n            if (!current) {\n                Logger.debug(\"[MetaUI SchemaNormalizer]\", `current is undefined at segment '${segment}'`, \"SchemaNormalizer\");\n                meta = undefined;\n                break;\n            }\n            meta = current[segment];\n            Logger.debug(\"[MetaUI SchemaNormalizer]\", `Segment '${segment}' resolved to meta: ${!!meta}. Available keys in current: ${Object.keys(current)}`, \"SchemaNormalizer\");\n            if (i < pathSegments.length - 1) {\n                current = meta?.properties;\n            }\n        }\n        \n        const bindingPath = pathSegments.join(\"/\");\n        const propKey = scope.replace(\"#/properties/\", \"\"); // The original raw string for logging\n        \n        return {\n            meta,\n            bindingPath,\n            propKey\n        };\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -4,7 +4,16 @@ declare module "nz/co/siliconst/ui5/metaui/core/SchemaNormalizer" {
      * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.
      */
     import { ISchema, IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
-    export class SchemaNormalizer {
+    import { ISchemaBuilderPlugin } from "nz/co/siliconst/ui5/metaui/interfaces/ISchemaBuilderPlugin";
+    export class SchemaNormalizer implements ISchemaBuilderPlugin {
+        /**
+         * ISchemaBuilderPlugin Contract
+         */
+        canHandle(rawSchema: any): boolean;
+        /**
+         * ISchemaBuilderPlugin Contract
+         */
+        build(rawSchema: any): ISchema;
         /**
          * Validates that the provided raw payload conforms to the required ISchema structures.
          */

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

@@ -1 +1 @@
-{"version":3,"file":"SchemaNormalizer.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/SchemaNormalizer.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,kDAAkD,CAAC;IAClE;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAa,MAAM,+CAA+C,CAAC;IAGtG,MAAa,gBAAgB;QAEzB;;WAEG;eACW,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO;QA0DrE;;;;;WAKG;QACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;QAgBlC;;;;;WAKG;QACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;QASlC;;;;;;WAMG;QACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;QA2CxC;;WAEG;QACH,OAAO,CAAC,MAAM,CAAC,aAAa;QAU5B;;WAEG;eACW,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;QA4BzD;;;;WAIG;QACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;QA+CxC;;;WAGG;eACW,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG;YAAE,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE;KAmC5I;CAEA"}
+{"version":3,"file":"SchemaNormalizer.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/SchemaNormalizer.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,kDAAkD,CAAC;IAClE;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAa,MAAM,+CAA+C,CAAC;IACtG,OAAO,EAAE,oBAAoB,EAAE,MAAM,4DAA4D,CAAC;IAGlG,MAAa,gBAAiB,YAAW,oBAAoB;QAEzD;;WAEG;QACI,SAAS,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO;QAOzC;;WAEG;QACI,KAAK,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO;QAIrC;;WAEG;eACW,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO;QA0DrE;;;;;WAKG;QACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;QAgBlC;;;;;WAKG;QACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;QASlC;;;;;;WAMG;QACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;QA2CxC;;WAEG;QACH,OAAO,CAAC,MAAM,CAAC,aAAa;QAU5B;;WAEG;eACW,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;QA4BzD;;;;WAIG;QACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;QA+CxC;;;WAGG;eACW,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG;YAAE,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE;KAmC5I;CAEA"}

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

@@ -1,2 +1,2 @@
-sap.ui.define(["../utils/Logger"],function(e){"use strict";const t=e["Logger"];class r{static normalize(e,r){let i=e;if(typeof i==="string"){if(!i.trim()){i=null}else{try{i=JSON.parse(i)}catch(e){const r="Failed to parse schema string: "+e.message;t.error("[MetaUI SchemaNormalizer]",r);throw new Error(r)}}}if(!i||typeof i!=="object"||Array.isArray(i)){return this.inferSchemaFromData(r)}try{const e={title:i.title,type:i.type||(i.items?"array":"object"),layoutStrategy:i.layoutStrategy,uiLayout:i.uiLayout,additionalProperties:i.additionalProperties};let t=i.properties||{};if(i.additionalProperties===true&&r){const e=this.inferSchemaFromData(r);if(e.type==="object"&&e.properties){t=this.deepMergeProperties(e.properties,t)}else if(e.type==="array"&&e.items&&e.items.properties){}}if(e.type==="object"){const r=Array.isArray(i.required)?i.required:[];e.properties=this.normalizeProperties(t,r)}else if(e.type==="array"){e.items=this.normalizePropertyMetadata(i.items||{type:"object",properties:{}},"items",false)}return e}catch(e){const r="Critical error normalizing schema object: "+e.message;t.error("[MetaUI SchemaNormalizer]",r);throw new Error(r)}}static deepMergeProperties(e,t){const r={...e};for(const e of Object.keys(t)){const i=t[e];const a=r[e];if(a&&typeof a==="object"&&!Array.isArray(a)&&i&&typeof i==="object"&&!Array.isArray(i)){r[e]=this.deepMergeProperties(a,i)}else{r[e]=i}}return r}static normalizeProperties(e,t=[]){const r={};for(const i of Object.keys(e)){const a=t.includes(i);r[i]=this.normalizePropertyMetadata(e[i],i,a)}return r}static normalizePropertyMetadata(e,t,r=false){const i={type:e.type||"string",ui:{label:e.ui?.label||this.generateLabel(t),isKey:!!e.ui?.isKey,readOnly:!!e.ui?.readOnly,widget:e.ui?.widget||(e.valueHelp||e.enum?"select":undefined),visibleOn:e.ui?.visibleOn,enabledOn:e.ui?.enabledOn,format:e.ui?.format,validators:e.ui?.validators,formatter:e.ui?.formatter,args:e.ui?.args,rows:e.ui?.rows,fullWidth:e.ui?.fullWidth,dialogButtonText:e.ui?.dialogButtonText},required:r||!!e.required,maxLength:e.maxLength,minLength:e.minLength,minimum:e.minimum,maximum:e.maximum,pattern:e.pattern,precision:e.precision,scale:e.scale,multipleOf:e.multipleOf,valueHelp:e.valueHelp,enum:e.enum};if(i.type==="object"&&e.properties){const t=Array.isArray(e.required)?e.required:[];i.properties=this.normalizeProperties(e.properties,t);i.uiLayout=e.uiLayout}else if(i.type==="array"&&e.items){i.items=this.normalizePropertyMetadata(e.items,"items",false);i.uiLayout=e.uiLayout}return i}static generateLabel(e){if(!e)return"";let t=e.replace(/([A-Z])/g," $1").replace(/_/g," ");return t.split(" ").filter(e=>e.length>0).map(e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(" ").trim()}static inferSchemaFromData(e){const t={type:"object",properties:{},layoutStrategy:"compact",title:""};if(!e||typeof e!=="object"){return t}if(Array.isArray(e)){t.type="array";if(e.length>0&&typeof e[0]!=="object"){t.layoutStrategy="compact";t.items={type:typeof e[0]}}else{t.layoutStrategy="table";t.items={type:"object",layoutStrategy:"compact",properties:e.length>0?this.inferPropertiesFromObject(e[0]):{}}}}else{t.type="object";t.properties=this.inferPropertiesFromObject(e)}return t}static inferPropertiesFromObject(e){const t={};if(!e||typeof e!=="object")return t;for(const r of Object.keys(e)){const i=e[r];if(i===null||i===undefined)continue;let a="string";let o;let s;if(typeof i==="number")a="number";else if(typeof i==="boolean")a="boolean";else if(Array.isArray(i)){a="array";if(i.length>0&&typeof i[0]!=="object"){o={type:typeof i[0]}}else{o={type:"object",properties:i.length>0?this.inferPropertiesFromObject(i[0]):{}}}}else if(typeof i==="object"){a="object";s=this.inferPropertiesFromObject(i)}t[r]={type:a,items:o,properties:s,ui:{label:this.generateLabel(r),isKey:false,readOnly:false,widget:a==="array"&&o?.type!=="object"?"multiInput":undefined}}}return t}static resolveScope(e,r){if(!r||!r.startsWith("#/properties/")){return{meta:undefined,bindingPath:r||"",propKey:r||""}}const i=r.replace("#/properties/","").split("/properties/");let a=e.properties;let o;t.debug("[MetaUI SchemaNormalizer]",`Resolving scope '${r}' with segments: ${JSON.stringify(i)}`,"SchemaNormalizer");t.debug("[MetaUI SchemaNormalizer]",`Root schema keys: ${Object.keys(e.properties||{})}`,"SchemaNormalizer");for(let e=0;e<i.length;e++){const r=i[e];if(!a){t.debug("[MetaUI SchemaNormalizer]",`current is undefined at segment '${r}'`,"SchemaNormalizer");o=undefined;break}o=a[r];t.debug("[MetaUI SchemaNormalizer]",`Segment '${r}' resolved to meta: ${!!o}. Available keys in current: ${Object.keys(a)}`,"SchemaNormalizer");if(e<i.length-1){a=o?.properties}}const s=i.join("/");const n=r.replace("#/properties/","");return{meta:o,bindingPath:s,propKey:n}}}var i={__esModule:true};i.SchemaNormalizer=r;return i});
+sap.ui.define(["../utils/Logger"],function(e){"use strict";const t=e["Logger"];class r{canHandle(e){if(e.openapi||e.swagger)return false;return true}build(e){return r.normalize(e)}static normalize(e,r){let i=e;if(typeof i==="string"){if(!i.trim()){i=null}else{try{i=JSON.parse(i)}catch(e){const r="Failed to parse schema string: "+e.message;t.error("[MetaUI SchemaNormalizer]",r);throw new Error(r)}}}if(!i||typeof i!=="object"||Array.isArray(i)){return this.inferSchemaFromData(r)}try{const e={title:i.title,type:i.type||(i.items?"array":"object"),layoutStrategy:i.layoutStrategy,uiLayout:i.uiLayout,additionalProperties:i.additionalProperties};let t=i.properties||{};if(i.additionalProperties===true&&r){const e=this.inferSchemaFromData(r);if(e.type==="object"&&e.properties){t=this.deepMergeProperties(e.properties,t)}else if(e.type==="array"&&e.items&&e.items.properties){}}if(e.type==="object"){const r=Array.isArray(i.required)?i.required:[];e.properties=this.normalizeProperties(t,r)}else if(e.type==="array"){e.items=this.normalizePropertyMetadata(i.items||{type:"object",properties:{}},"items",false)}return e}catch(e){const r="Critical error normalizing schema object: "+e.message;t.error("[MetaUI SchemaNormalizer]",r);throw new Error(r)}}static deepMergeProperties(e,t){const r={...e};for(const e of Object.keys(t)){const i=t[e];const a=r[e];if(a&&typeof a==="object"&&!Array.isArray(a)&&i&&typeof i==="object"&&!Array.isArray(i)){r[e]=this.deepMergeProperties(a,i)}else{r[e]=i}}return r}static normalizeProperties(e,t=[]){const r={};for(const i of Object.keys(e)){const a=t.includes(i);r[i]=this.normalizePropertyMetadata(e[i],i,a)}return r}static normalizePropertyMetadata(e,t,r=false){const i={type:e.type||"string",ui:{label:e.ui?.label||this.generateLabel(t),isKey:!!e.ui?.isKey,readOnly:!!e.ui?.readOnly,widget:e.ui?.widget||(e.valueHelp||e.enum?"select":undefined),visibleOn:e.ui?.visibleOn,enabledOn:e.ui?.enabledOn,format:e.ui?.format,validators:e.ui?.validators,formatter:e.ui?.formatter,args:e.ui?.args,rows:e.ui?.rows,fullWidth:e.ui?.fullWidth,dialogButtonText:e.ui?.dialogButtonText},required:r||!!e.required,maxLength:e.maxLength,minLength:e.minLength,minimum:e.minimum,maximum:e.maximum,pattern:e.pattern,precision:e.precision,scale:e.scale,multipleOf:e.multipleOf,valueHelp:e.valueHelp,enum:e.enum};if(i.type==="object"&&e.properties){const t=Array.isArray(e.required)?e.required:[];i.properties=this.normalizeProperties(e.properties,t);i.uiLayout=e.uiLayout}else if(i.type==="array"&&e.items){i.items=this.normalizePropertyMetadata(e.items,"items",false);i.uiLayout=e.uiLayout}return i}static generateLabel(e){if(!e)return"";let t=e.replace(/([A-Z])/g," $1").replace(/_/g," ");return t.split(" ").filter(e=>e.length>0).map(e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(" ").trim()}static inferSchemaFromData(e){const t={type:"object",properties:{},layoutStrategy:"compact",title:""};if(!e||typeof e!=="object"){return t}if(Array.isArray(e)){t.type="array";if(e.length>0&&typeof e[0]!=="object"){t.layoutStrategy="compact";t.items={type:typeof e[0]}}else{t.layoutStrategy="table";t.items={type:"object",layoutStrategy:"compact",properties:e.length>0?this.inferPropertiesFromObject(e[0]):{}}}}else{t.type="object";t.properties=this.inferPropertiesFromObject(e)}return t}static inferPropertiesFromObject(e){const t={};if(!e||typeof e!=="object")return t;for(const r of Object.keys(e)){const i=e[r];if(i===null||i===undefined)continue;let a="string";let o;let s;if(typeof i==="number")a="number";else if(typeof i==="boolean")a="boolean";else if(Array.isArray(i)){a="array";if(i.length>0&&typeof i[0]!=="object"){o={type:typeof i[0]}}else{o={type:"object",properties:i.length>0?this.inferPropertiesFromObject(i[0]):{}}}}else if(typeof i==="object"){a="object";s=this.inferPropertiesFromObject(i)}t[r]={type:a,items:o,properties:s,ui:{label:this.generateLabel(r),isKey:false,readOnly:false,widget:a==="array"&&o?.type!=="object"?"multiInput":undefined}}}return t}static resolveScope(e,r){if(!r||!r.startsWith("#/properties/")){return{meta:undefined,bindingPath:r||"",propKey:r||""}}const i=r.replace("#/properties/","").split("/properties/");let a=e.properties;let o;t.debug("[MetaUI SchemaNormalizer]",`Resolving scope '${r}' with segments: ${JSON.stringify(i)}`,"SchemaNormalizer");t.debug("[MetaUI SchemaNormalizer]",`Root schema keys: ${Object.keys(e.properties||{})}`,"SchemaNormalizer");for(let e=0;e<i.length;e++){const r=i[e];if(!a){t.debug("[MetaUI SchemaNormalizer]",`current is undefined at segment '${r}'`,"SchemaNormalizer");o=undefined;break}o=a[r];t.debug("[MetaUI SchemaNormalizer]",`Segment '${r}' resolved to meta: ${!!o}. Available keys in current: ${Object.keys(a)}`,"SchemaNormalizer");if(e<i.length-1){a=o?.properties}}const s=i.join("/");const n=r.replace("#/properties/","");return{meta:o,bindingPath:s,propKey:n}}}var i={__esModule:true};i.SchemaNormalizer=r;return i});
 //# sourceMappingURL=SchemaNormalizer.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"SchemaNormalizer.js","names":["Logger","___utils_Logger","SchemaNormalizer","normalize","rawSchema","data","schemaObj","trim","JSON","parse","e","msg","message","error","Error","Array","isArray","this","inferSchemaFromData","normalized","title","type","items","layoutStrategy","uiLayout","additionalProperties","targetProperties","properties","inferred","deepMergeProperties","requiredKeys","required","normalizeProperties","normalizePropertyMetadata","base","override","merged","key","Object","keys","overrideVal","baseVal","normalizedProps","isRequired","includes","prop","keyName","ui","label","generateLabel","isKey","readOnly","widget","valueHelp","enum","undefined","visibleOn","enabledOn","format","validators","formatter","args","rows","fullWidth","dialogButtonText","maxLength","minLength","minimum","maximum","pattern","precision","scale","multipleOf","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","schema","inferPropertiesFromObject","obj","val","nestedProps","resolveScope","scope","startsWith","meta","bindingPath","propKey","pathSegments","current","debug","stringify","i","segment","__exports","__esModule"],"sources":["SchemaNormalizer.ts"],"sourcesContent":["/**\n * @file SchemaNormalizer.ts\n * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.\n */\n\nimport { ISchema, IPropertyMetadata, FieldType } from \"../interfaces/ISchema\";\nimport { Logger } from \"../utils/Logger\";\n\nexport class SchemaNormalizer {\n\n    /**\n     * Validates that the provided raw payload conforms to the required ISchema structures.\n     */\n    public static normalize(rawSchema?: unknown, data?: unknown): ISchema {\n        let schemaObj = rawSchema;\n\n        if (typeof schemaObj === \"string\") {\n            if (!schemaObj.trim()) {\n                schemaObj = null;\n            } else {\n                try {\n                    schemaObj = JSON.parse(schemaObj);\n                } catch (e) {\n                    const msg = \"Failed to parse schema string: \" + (e as Error).message;\n                    Logger.error(\"[MetaUI SchemaNormalizer]\", msg);\n                    throw new Error(msg);\n                }\n            }\n        }\n\n        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {\n            return this.inferSchemaFromData(data);\n        }\n\n        try {\n            // It is an object. Ensure it conforms to v2 structure.\n            const normalized: ISchema = {\n                title: schemaObj.title,\n                type: schemaObj.type || (schemaObj.items ? \"array\" : \"object\"),\n                layoutStrategy: schemaObj.layoutStrategy,\n                uiLayout: schemaObj.uiLayout,\n                additionalProperties: schemaObj.additionalProperties\n            };\n\n            let targetProperties = schemaObj.properties || {};\n\n            if (schemaObj.additionalProperties === true && data) {\n                const inferred = this.inferSchemaFromData(data);\n                if (inferred.type === \"object\" && inferred.properties) {\n                    targetProperties = this.deepMergeProperties(inferred.properties, targetProperties);\n                } else if (inferred.type === \"array\" && inferred.items && inferred.items.properties) {\n                    // Array schema merging could be added here if we want full support.\n                }\n            }\n\n            if (normalized.type === \"object\") {\n                const requiredKeys = Array.isArray(schemaObj.required) ? schemaObj.required : [];\n                normalized.properties = this.normalizeProperties(targetProperties, requiredKeys);\n            } else if (normalized.type === \"array\") {\n                // Future expansion: array deep merge\n                normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: \"object\", properties: {} }, \"items\", false);\n            }\n\n            return normalized;\n        } catch (error) {\n            const msg = \"Critical error normalizing schema object: \" + (error as Error).message;\n            Logger.error(\"[MetaUI SchemaNormalizer]\", msg);\n            throw new Error(msg);\n        }\n    }\n\n    /**\n     * Recursively deep merges an inferred schema over a base schema.\n     * @param base The base property dictionary.\n     * @param override The overriding inferred dictionary.\n     * @returns A new deeply merged property dictionary.\n     */\n    private static deepMergeProperties(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown> {\n        const merged = { ...base };\n        for (const key of Object.keys(override)) {\n            const overrideVal = override[key];\n            const baseVal = merged[key];\n\n            if (baseVal && typeof baseVal === \"object\" && !Array.isArray(baseVal) &&\n                overrideVal && typeof overrideVal === \"object\" && !Array.isArray(overrideVal)) {\n                merged[key] = this.deepMergeProperties(baseVal, overrideVal);\n            } else {\n                merged[key] = overrideVal;\n            }\n        }\n        return merged;\n    }\n\n    /**\n     * Normalizes a collection of properties.\n     * @param properties The raw properties map.\n     * @param requiredKeys An optional array of keys that are required by the parent object.\n     * @returns A map of strict IPropertyMetadata objects.\n     */\n    private static normalizeProperties(properties: Record<string, unknown>, requiredKeys: string[] = []): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        for (const key of Object.keys(properties)) {\n            const isRequired = requiredKeys.includes(key);\n            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key, isRequired);\n        }\n        return normalizedProps;\n    }\n\n    /**\n     * Normalizes a single property against the ISchema specification.\n     * @param prop The raw property definition.\n     * @param keyName The string key name for generating default labels.\n     * @param isRequired Indicates if the parent object mandated this property as required.\n     * @returns A strict IPropertyMetadata instance.\n     */\n    private static normalizePropertyMetadata(prop: Record<string, unknown>, keyName: string, isRequired: boolean = false): IPropertyMetadata {\n        const normalized: IPropertyMetadata = {\n            type: prop.type || \"string\",\n            ui: {\n                label: prop.ui?.label || this.generateLabel(keyName),\n                isKey: !!prop.ui?.isKey,\n                readOnly: !!prop.ui?.readOnly,\n                widget: prop.ui?.widget || (prop.valueHelp || prop.enum ? \"select\" : undefined),\n                visibleOn: prop.ui?.visibleOn,\n                enabledOn: prop.ui?.enabledOn,\n                format: prop.ui?.format,\n                validators: prop.ui?.validators,\n                formatter: prop.ui?.formatter,\n                args: prop.ui?.args,\n                rows: prop.ui?.rows,\n                fullWidth: prop.ui?.fullWidth,\n                dialogButtonText: prop.ui?.dialogButtonText\n            },\n            required: isRequired || !!prop.required,\n            maxLength: prop.maxLength as number,\n            minLength: prop.minLength as number,\n            minimum: prop.minimum,\n            maximum: prop.maximum,\n            pattern: prop.pattern,\n            precision: prop.precision,\n            scale: prop.scale,\n            multipleOf: prop.multipleOf as number,\n            valueHelp: prop.valueHelp,\n            enum: prop.enum\n        };\n\n        if (normalized.type === \"object\" && prop.properties) {\n            const requiredKeys = Array.isArray(prop.required) ? prop.required : [];\n            normalized.properties = this.normalizeProperties(prop.properties as Record<string, unknown>, requiredKeys);\n            normalized.uiLayout = prop.uiLayout;\n        } else if (normalized.type === \"array\" && prop.items) {\n            normalized.items = this.normalizePropertyMetadata(prop.items as Record<string, unknown>, \"items\", false);\n            normalized.uiLayout = prop.uiLayout;\n        }\n\n        return normalized;\n    }\n\n    /**\n     * Generates a Title Case label from camelCase or snake_case technical names.\n     */\n    private static generateLabel(name: string): string {\n        if (!name) return \"\";\n        let spaced = name.replace(/([A-Z])/g, \" $1\").replace(/_/g, \" \");\n        return spaced.split(' ')\n            .filter(w => w.length > 0)\n            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n            .join(' ')\n            .trim();\n    }\n\n    /**\n     * Infers a v2 ISchema structure dynamically from a plain data payload.\n     */\n    public static inferSchemaFromData(data: unknown): ISchema {\n        const schema: ISchema = { type: \"object\", properties: {}, layoutStrategy: \"compact\", title: \"\" };\n\n        if (!data || typeof data !== \"object\") {\n            return schema;\n        }\n\n        if (Array.isArray(data)) {\n            schema.type = \"array\";\n            if (data.length > 0 && typeof data[0] !== \"object\") {\n                schema.layoutStrategy = \"compact\";\n                schema.items = { type: typeof data[0] as FieldType };\n            } else {\n                schema.layoutStrategy = \"table\";\n                schema.items = {\n                    type: \"object\",\n                    layoutStrategy: \"compact\",\n                    properties: data.length > 0 ? this.inferPropertiesFromObject(data[0] as Record<string, unknown>) : {}\n                };\n            }\n        } else {\n            schema.type = \"object\";\n            schema.properties = this.inferPropertiesFromObject(data);\n        }\n\n        return schema;\n    }\n\n    /**\n     * Infers field metadata recursively from a raw data object.\n     * @param obj The raw JavaScript object.\n     * @returns A dictionary of inferred IPropertyMetadata.\n     */\n    private static inferPropertiesFromObject(obj: Record<string, unknown>): Record<string, IPropertyMetadata> {\n        const properties: Record<string, IPropertyMetadata> = {};\n        if (!obj || typeof obj !== \"object\") return properties;\n\n        for (const key of Object.keys(obj)) {\n            const val = obj[key];\n            if (val === null || val === undefined) continue;\n\n            let type: FieldType = \"string\";\n            let items: IPropertyMetadata | undefined;\n            let nestedProps: Record<string, IPropertyMetadata> | undefined;\n\n            if (typeof val === \"number\") type = \"number\";\n            else if (typeof val === \"boolean\") type = \"boolean\";\n            else if (Array.isArray(val)) {\n                type = \"array\";\n                if (val.length > 0 && typeof val[0] !== \"object\") {\n                    items = {\n                        type: typeof val[0] as FieldType\n                    };\n                } else {\n                    items = {\n                        type: \"object\",\n                        properties: val.length > 0 ? this.inferPropertiesFromObject(val[0] as Record<string, unknown>) : {}\n                    };\n                }\n            } else if (typeof val === \"object\") {\n                type = \"object\";\n                nestedProps = this.inferPropertiesFromObject(val);\n            }\n\n            properties[key] = {\n                type,\n                items,\n                properties: nestedProps,\n                ui: {\n                    label: this.generateLabel(key),\n                    isKey: false,\n                    readOnly: false,\n                    widget: type === \"array\" && items?.type !== \"object\" ? \"multiInput\" : undefined\n                }\n            };\n        }\n\n        return properties;\n    }\n\n    /**\n     * Resolves a JSON Schema scope (e.g. '#/properties/header/properties/id')\n     * against the ISchema, returning the PropertyMetadata and the UI5 binding path.\n     */\n    public static resolveScope(schema: ISchema, scope: string): { meta: IPropertyMetadata | undefined, bindingPath: string, propKey: string } {\n        if (!scope || !scope.startsWith(\"#/properties/\")) {\n            return { meta: undefined, bindingPath: scope || \"\", propKey: scope || \"\" };\n        }\n        \n        const pathSegments = scope.replace(\"#/properties/\", \"\").split(\"/properties/\");\n        let current: Record<string, IPropertyMetadata> | undefined = schema.properties;\n        let meta: IPropertyMetadata | undefined;\n        \n        Logger.debug(\"[MetaUI SchemaNormalizer]\", `Resolving scope '${scope}' with segments: ${JSON.stringify(pathSegments)}`, \"SchemaNormalizer\");\n        Logger.debug(\"[MetaUI SchemaNormalizer]\", `Root schema keys: ${Object.keys(schema.properties || {})}`, \"SchemaNormalizer\");\n\n        for (let i = 0; i < pathSegments.length; i++) {\n            const segment = pathSegments[i];\n            if (!current) {\n                Logger.debug(\"[MetaUI SchemaNormalizer]\", `current is undefined at segment '${segment}'`, \"SchemaNormalizer\");\n                meta = undefined;\n                break;\n            }\n            meta = current[segment];\n            Logger.debug(\"[MetaUI SchemaNormalizer]\", `Segment '${segment}' resolved to meta: ${!!meta}. Available keys in current: ${Object.keys(current)}`, \"SchemaNormalizer\");\n            if (i < pathSegments.length - 1) {\n                current = meta?.properties;\n            }\n        }\n        \n        const bindingPath = pathSegments.join(\"/\");\n        const propKey = scope.replace(\"#/properties/\", \"\"); // The original raw string for logging\n        \n        return {\n            meta,\n            bindingPath,\n            propKey\n        };\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"SchemaNormalizer.js","names":["Logger","___utils_Logger","SchemaNormalizer","canHandle","rawSchema","openapi","swagger","build","normalize","data","schemaObj","trim","JSON","parse","e","msg","message","error","Error","Array","isArray","this","inferSchemaFromData","normalized","title","type","items","layoutStrategy","uiLayout","additionalProperties","targetProperties","properties","inferred","deepMergeProperties","requiredKeys","required","normalizeProperties","normalizePropertyMetadata","base","override","merged","key","Object","keys","overrideVal","baseVal","normalizedProps","isRequired","includes","prop","keyName","ui","label","generateLabel","isKey","readOnly","widget","valueHelp","enum","undefined","visibleOn","enabledOn","format","validators","formatter","args","rows","fullWidth","dialogButtonText","maxLength","minLength","minimum","maximum","pattern","precision","scale","multipleOf","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","schema","inferPropertiesFromObject","obj","val","nestedProps","resolveScope","scope","startsWith","meta","bindingPath","propKey","pathSegments","current","debug","stringify","i","segment","__exports","__esModule"],"sources":["SchemaNormalizer.ts"],"sourcesContent":["/**\n * @file SchemaNormalizer.ts\n * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.\n */\n\nimport { ISchema, IPropertyMetadata, FieldType } from \"../interfaces/ISchema\";\nimport { ISchemaBuilderPlugin } from \"../interfaces/ISchemaBuilderPlugin\";\nimport { Logger } from \"../utils/Logger\";\n\nexport class SchemaNormalizer implements ISchemaBuilderPlugin {\n\n    /**\n     * ISchemaBuilderPlugin Contract\n     */\n    public canHandle(rawSchema: any): boolean {\n        // MetaUI native schemas almost always have properties, items, or a layoutStrategy\n        // This acts as a fallback for native schemas.\n        if (rawSchema.openapi || rawSchema.swagger) return false; \n        return true;\n    }\n\n    /**\n     * ISchemaBuilderPlugin Contract\n     */\n    public build(rawSchema: any): ISchema {\n        return SchemaNormalizer.normalize(rawSchema);\n    }\n\n    /**\n     * Validates that the provided raw payload conforms to the required ISchema structures.\n     */\n    public static normalize(rawSchema?: unknown, data?: unknown): ISchema {\n        let schemaObj = rawSchema;\n\n        if (typeof schemaObj === \"string\") {\n            if (!schemaObj.trim()) {\n                schemaObj = null;\n            } else {\n                try {\n                    schemaObj = JSON.parse(schemaObj);\n                } catch (e) {\n                    const msg = \"Failed to parse schema string: \" + (e as Error).message;\n                    Logger.error(\"[MetaUI SchemaNormalizer]\", msg);\n                    throw new Error(msg);\n                }\n            }\n        }\n\n        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {\n            return this.inferSchemaFromData(data);\n        }\n\n        try {\n            // It is an object. Ensure it conforms to v2 structure.\n            const normalized: ISchema = {\n                title: schemaObj.title,\n                type: schemaObj.type || (schemaObj.items ? \"array\" : \"object\"),\n                layoutStrategy: schemaObj.layoutStrategy,\n                uiLayout: schemaObj.uiLayout,\n                additionalProperties: schemaObj.additionalProperties\n            };\n\n            let targetProperties = schemaObj.properties || {};\n\n            if (schemaObj.additionalProperties === true && data) {\n                const inferred = this.inferSchemaFromData(data);\n                if (inferred.type === \"object\" && inferred.properties) {\n                    targetProperties = this.deepMergeProperties(inferred.properties, targetProperties);\n                } else if (inferred.type === \"array\" && inferred.items && inferred.items.properties) {\n                    // Array schema merging could be added here if we want full support.\n                }\n            }\n\n            if (normalized.type === \"object\") {\n                const requiredKeys = Array.isArray(schemaObj.required) ? schemaObj.required : [];\n                normalized.properties = this.normalizeProperties(targetProperties, requiredKeys);\n            } else if (normalized.type === \"array\") {\n                // Future expansion: array deep merge\n                normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: \"object\", properties: {} }, \"items\", false);\n            }\n\n            return normalized;\n        } catch (error) {\n            const msg = \"Critical error normalizing schema object: \" + (error as Error).message;\n            Logger.error(\"[MetaUI SchemaNormalizer]\", msg);\n            throw new Error(msg);\n        }\n    }\n\n    /**\n     * Recursively deep merges an inferred schema over a base schema.\n     * @param base The base property dictionary.\n     * @param override The overriding inferred dictionary.\n     * @returns A new deeply merged property dictionary.\n     */\n    private static deepMergeProperties(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown> {\n        const merged = { ...base };\n        for (const key of Object.keys(override)) {\n            const overrideVal = override[key];\n            const baseVal = merged[key];\n\n            if (baseVal && typeof baseVal === \"object\" && !Array.isArray(baseVal) &&\n                overrideVal && typeof overrideVal === \"object\" && !Array.isArray(overrideVal)) {\n                merged[key] = this.deepMergeProperties(baseVal, overrideVal);\n            } else {\n                merged[key] = overrideVal;\n            }\n        }\n        return merged;\n    }\n\n    /**\n     * Normalizes a collection of properties.\n     * @param properties The raw properties map.\n     * @param requiredKeys An optional array of keys that are required by the parent object.\n     * @returns A map of strict IPropertyMetadata objects.\n     */\n    private static normalizeProperties(properties: Record<string, unknown>, requiredKeys: string[] = []): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        for (const key of Object.keys(properties)) {\n            const isRequired = requiredKeys.includes(key);\n            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key, isRequired);\n        }\n        return normalizedProps;\n    }\n\n    /**\n     * Normalizes a single property against the ISchema specification.\n     * @param prop The raw property definition.\n     * @param keyName The string key name for generating default labels.\n     * @param isRequired Indicates if the parent object mandated this property as required.\n     * @returns A strict IPropertyMetadata instance.\n     */\n    private static normalizePropertyMetadata(prop: Record<string, unknown>, keyName: string, isRequired: boolean = false): IPropertyMetadata {\n        const normalized: IPropertyMetadata = {\n            type: prop.type || \"string\",\n            ui: {\n                label: prop.ui?.label || this.generateLabel(keyName),\n                isKey: !!prop.ui?.isKey,\n                readOnly: !!prop.ui?.readOnly,\n                widget: prop.ui?.widget || (prop.valueHelp || prop.enum ? \"select\" : undefined),\n                visibleOn: prop.ui?.visibleOn,\n                enabledOn: prop.ui?.enabledOn,\n                format: prop.ui?.format,\n                validators: prop.ui?.validators,\n                formatter: prop.ui?.formatter,\n                args: prop.ui?.args,\n                rows: prop.ui?.rows,\n                fullWidth: prop.ui?.fullWidth,\n                dialogButtonText: prop.ui?.dialogButtonText\n            },\n            required: isRequired || !!prop.required,\n            maxLength: prop.maxLength as number,\n            minLength: prop.minLength as number,\n            minimum: prop.minimum,\n            maximum: prop.maximum,\n            pattern: prop.pattern,\n            precision: prop.precision,\n            scale: prop.scale,\n            multipleOf: prop.multipleOf as number,\n            valueHelp: prop.valueHelp,\n            enum: prop.enum\n        };\n\n        if (normalized.type === \"object\" && prop.properties) {\n            const requiredKeys = Array.isArray(prop.required) ? prop.required : [];\n            normalized.properties = this.normalizeProperties(prop.properties as Record<string, unknown>, requiredKeys);\n            normalized.uiLayout = prop.uiLayout;\n        } else if (normalized.type === \"array\" && prop.items) {\n            normalized.items = this.normalizePropertyMetadata(prop.items as Record<string, unknown>, \"items\", false);\n            normalized.uiLayout = prop.uiLayout;\n        }\n\n        return normalized;\n    }\n\n    /**\n     * Generates a Title Case label from camelCase or snake_case technical names.\n     */\n    private static generateLabel(name: string): string {\n        if (!name) return \"\";\n        let spaced = name.replace(/([A-Z])/g, \" $1\").replace(/_/g, \" \");\n        return spaced.split(' ')\n            .filter(w => w.length > 0)\n            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n            .join(' ')\n            .trim();\n    }\n\n    /**\n     * Infers a v2 ISchema structure dynamically from a plain data payload.\n     */\n    public static inferSchemaFromData(data: unknown): ISchema {\n        const schema: ISchema = { type: \"object\", properties: {}, layoutStrategy: \"compact\", title: \"\" };\n\n        if (!data || typeof data !== \"object\") {\n            return schema;\n        }\n\n        if (Array.isArray(data)) {\n            schema.type = \"array\";\n            if (data.length > 0 && typeof data[0] !== \"object\") {\n                schema.layoutStrategy = \"compact\";\n                schema.items = { type: typeof data[0] as FieldType };\n            } else {\n                schema.layoutStrategy = \"table\";\n                schema.items = {\n                    type: \"object\",\n                    layoutStrategy: \"compact\",\n                    properties: data.length > 0 ? this.inferPropertiesFromObject(data[0] as Record<string, unknown>) : {}\n                };\n            }\n        } else {\n            schema.type = \"object\";\n            schema.properties = this.inferPropertiesFromObject(data);\n        }\n\n        return schema;\n    }\n\n    /**\n     * Infers field metadata recursively from a raw data object.\n     * @param obj The raw JavaScript object.\n     * @returns A dictionary of inferred IPropertyMetadata.\n     */\n    private static inferPropertiesFromObject(obj: Record<string, unknown>): Record<string, IPropertyMetadata> {\n        const properties: Record<string, IPropertyMetadata> = {};\n        if (!obj || typeof obj !== \"object\") return properties;\n\n        for (const key of Object.keys(obj)) {\n            const val = obj[key];\n            if (val === null || val === undefined) continue;\n\n            let type: FieldType = \"string\";\n            let items: IPropertyMetadata | undefined;\n            let nestedProps: Record<string, IPropertyMetadata> | undefined;\n\n            if (typeof val === \"number\") type = \"number\";\n            else if (typeof val === \"boolean\") type = \"boolean\";\n            else if (Array.isArray(val)) {\n                type = \"array\";\n                if (val.length > 0 && typeof val[0] !== \"object\") {\n                    items = {\n                        type: typeof val[0] as FieldType\n                    };\n                } else {\n                    items = {\n                        type: \"object\",\n                        properties: val.length > 0 ? this.inferPropertiesFromObject(val[0] as Record<string, unknown>) : {}\n                    };\n                }\n            } else if (typeof val === \"object\") {\n                type = \"object\";\n                nestedProps = this.inferPropertiesFromObject(val);\n            }\n\n            properties[key] = {\n                type,\n                items,\n                properties: nestedProps,\n                ui: {\n                    label: this.generateLabel(key),\n                    isKey: false,\n                    readOnly: false,\n                    widget: type === \"array\" && items?.type !== \"object\" ? \"multiInput\" : undefined\n                }\n            };\n        }\n\n        return properties;\n    }\n\n    /**\n     * Resolves a JSON Schema scope (e.g. '#/properties/header/properties/id')\n     * against the ISchema, returning the PropertyMetadata and the UI5 binding path.\n     */\n    public static resolveScope(schema: ISchema, scope: string): { meta: IPropertyMetadata | undefined, bindingPath: string, propKey: string } {\n        if (!scope || !scope.startsWith(\"#/properties/\")) {\n            return { meta: undefined, bindingPath: scope || \"\", propKey: scope || \"\" };\n        }\n        \n        const pathSegments = scope.replace(\"#/properties/\", \"\").split(\"/properties/\");\n        let current: Record<string, IPropertyMetadata> | undefined = schema.properties;\n        let meta: IPropertyMetadata | undefined;\n        \n        Logger.debug(\"[MetaUI SchemaNormalizer]\", `Resolving scope '${scope}' with segments: ${JSON.stringify(pathSegments)}`, \"SchemaNormalizer\");\n        Logger.debug(\"[MetaUI SchemaNormalizer]\", `Root schema keys: ${Object.keys(schema.properties || {})}`, \"SchemaNormalizer\");\n\n        for (let i = 0; i < pathSegments.length; i++) {\n            const segment = pathSegments[i];\n            if (!current) {\n                Logger.debug(\"[MetaUI SchemaNormalizer]\", `current is undefined at segment '${segment}'`, \"SchemaNormalizer\");\n                meta = undefined;\n                break;\n            }\n            meta = current[segment];\n            Logger.debug(\"[MetaUI SchemaNormalizer]\", `Segment '${segment}' resolved to meta: ${!!meta}. Available keys in current: ${Object.keys(current)}`, \"SchemaNormalizer\");\n            if (i < pathSegments.length - 1) {\n                current = meta?.properties;\n            }\n        }\n        \n        const bindingPath = pathSegments.join(\"/\");\n        const propKey = scope.replace(\"#/properties/\", \"\"); // The original raw string for logging\n        \n        return {\n            meta,\n            bindingPath,\n            propKey\n        };\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -4,9 +4,27 @@
  */
 
 import { ISchema, IPropertyMetadata, FieldType } from "../interfaces/ISchema";
+import { ISchemaBuilderPlugin } from "../interfaces/ISchemaBuilderPlugin";
 import { Logger } from "../utils/Logger";
 
-export class SchemaNormalizer {
+export class SchemaNormalizer implements ISchemaBuilderPlugin {
+
+    /**
+     * ISchemaBuilderPlugin Contract
+     */
+    public canHandle(rawSchema: any): boolean {
+        // MetaUI native schemas almost always have properties, items, or a layoutStrategy
+        // This acts as a fallback for native schemas.
+        if (rawSchema.openapi || rawSchema.swagger) return false; 
+        return true;
+    }
+
+    /**
+     * ISchemaBuilderPlugin Contract
+     */
+    public build(rawSchema: any): ISchema {
+        return SchemaNormalizer.normalize(rawSchema);
+    }
 
     /**
      * Validates that the provided raw payload conforms to the required ISchema structures.