@siliconst/metaui 1.2.0 → 1.4.5

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

@@ -7,22 +7,100 @@
 import { IPlugin } from "../interfaces/IPlugin";
 import { FieldType } from "../interfaces/ISchema";
 
+import { Registry } from "./Registry";
+import { Logger } from "../utils/Logger";
+
+import { StringPlugin } from "../plugins/controls/StringPlugin";
+import { NumberPlugin } from "../plugins/controls/NumberPlugin";
+import { DatePlugin } from "../plugins/controls/DatePlugin";
+import { TimePlugin } from "../plugins/controls/TimePlugin";
+import { DateTimePlugin } from "../plugins/controls/DateTimePlugin";
+import { BooleanPlugin } from "../plugins/controls/BooleanPlugin";
+import { SwitchPlugin } from "../plugins/controls/SwitchPlugin";
+import { ArrayPlugin } from "../plugins/controls/ArrayPlugin";
+import { ObjectPlugin } from "../plugins/controls/ObjectPlugin";
+import { DropdownPlugin } from "../plugins/controls/DropdownPlugin";
+import { TextAreaPlugin } from "../plugins/controls/TextAreaPlugin";
+import { CodeEditorPlugin } from "../plugins/controls/CodeEditorPlugin";
+
+// New Phase 1 Controls
+import { FileUploaderPlugin } from "../plugins/controls/FileUploaderPlugin";
+import { MultiSelectPlugin } from "../plugins/controls/MultiSelectPlugin";
+import { SliderPlugin } from "../plugins/controls/SliderPlugin";
+import { RatingIndicatorPlugin } from "../plugins/controls/RatingIndicatorPlugin";
+import { MessageStripPlugin } from "../plugins/controls/MessageStripPlugin";
+
+// New Phase 5 Hardware / Base64 Plugins
+import { CameraPlugin } from "../plugins/controls/CameraPlugin";
+import { SignaturePlugin } from "../plugins/controls/SignaturePlugin";
+import { GeolocationPlugin } from "../plugins/controls/GeolocationPlugin";
+import { BarcodeScannerPlugin } from "../plugins/controls/BarcodeScannerPlugin";
+import { VoiceInputPlugin } from "../plugins/controls/VoiceInputPlugin";
+import { RichTextPlugin } from "../plugins/controls/RichTextPlugin";
+
+// New Phase 4 Actions & Datasources
+import { UrlNavigationActionPlugin } from "../plugins/actions/UrlNavigationActionPlugin";
+import { SubmitFormActionPlugin } from "../plugins/actions/SubmitFormActionPlugin";
+import { ODataListBindingPlugin } from "../plugins/datasources/ODataListBindingPlugin";
+import { RemoteDropdownPlugin } from "../plugins/datasources/RemoteDropdownPlugin";
+
 /**
- * Singleton registry that manages the lifecycle and lookup of UI5 plugin constructors.
+ * Singleton orchestrator responsible for maintaining the registry of all available UI control plugins.
+ * Resolves standard JSON schema types to their respective UI5 native controls.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.core
+ * @public
  */
 export class PluginRegistry {
+    /** The single instance of the PluginRegistry. */
     private static instance: PluginRegistry;
     
-    /** Internal map linking string types to their respective constructor functions. */
-    private plugins: Map<string, new () => IPlugin> = new Map();
+    /** Internal strongly typed registry holding plugin constructors. */
+    private readonly registry: Registry<new () => IPlugin> = new Registry<new () => IPlugin>("Controls");
 
     private constructor() {
-        // Enforce singleton
+        // Built-in Default Mappings
+        this.register("string", StringPlugin);
+        this.register("number", NumberPlugin);
+        this.register("integer", NumberPlugin);
+        this.register("date", DatePlugin);
+        this.register("boolean", BooleanPlugin);
+        this.register("array", ArrayPlugin);
+        this.register("object", ObjectPlugin);
+
+        // Widget Overrides
+        this.register("string", TimePlugin, "time");
+        this.register("string", DateTimePlugin, "datetime");
+        this.register("boolean", SwitchPlugin, "switch");
+        this.register("string", DropdownPlugin, "select");
+        this.register("string", TextAreaPlugin, "textArea");
+        this.register("string", CodeEditorPlugin, "codeEditor");
+        
+        // Phase 1 Mappings
+        this.register("string", FileUploaderPlugin, "fileUploader");
+        this.register("array", MultiSelectPlugin, "multiSelect");
+        this.register("number", SliderPlugin, "slider");
+        this.register("number", RatingIndicatorPlugin, "rating");
+        this.register("string", MessageStripPlugin, "messageStrip");
+
+        // Phase 5 Mappings (Hardware)
+        this.register("string", CameraPlugin, "camera");
+        this.register("string", SignaturePlugin, "signature");
+        this.register("object", GeolocationPlugin, "location");
+        this.register("string", BarcodeScannerPlugin, "scanner");
+        this.register("string", VoiceInputPlugin, "voiceInput");
+        this.register("string", RichTextPlugin, "richText");
+
+        // Phase 4 Mappings
+        this.register("string", UrlNavigationActionPlugin, "urlButton");
+        this.register("string", SubmitFormActionPlugin, "submitButton");
+        this.register("string", ODataListBindingPlugin, "odataSelect");
+        this.register("string", RemoteDropdownPlugin, "remoteDropdown");
     }
 
     /**
      * Retrieves the singular instance of the PluginRegistry.
-     * @returns The PluginRegistry singleton.
+     * @returns {PluginRegistry} The active instance.
      */
     public static getInstance(): PluginRegistry {
         if (!PluginRegistry.instance) {
@@ -32,40 +110,51 @@ export class PluginRegistry {
     }
 
     /**
-     * Registers a new UI control plugin against a specific schema primitive type (and optional widget).
-     * @param type The primitive FieldType (e.g., 'string', 'date').
-     * @param pluginConstructor The class constructor for the plugin.
-     * @param widgetName Optional widget specific override (e.g., 'textArea').
+     * Registers a new control plugin to be utilized by the Layout Managers.
+     * 
+     * @param type The JSON Schema primitive type (e.g., 'string', 'number').
+     * @param pluginConstructor The class constructor for the plugin implementation.
+     * @param widgetName Optional UI hint to override the default type handler (e.g., 'textArea' for a 'string').
      */
     public register(type: FieldType, pluginConstructor: new () => IPlugin, widgetName?: string): void {
         const key = widgetName ? `${type}:${widgetName}` : type;
-        this.plugins.set(key, pluginConstructor);
+        this.registry.register(key, pluginConstructor);
     }
 
     /**
-     * Instantiates and returns a new plugin based on the requested primitive type and widget.
-     * @param type The primitive FieldType to look up.
-     * @param widgetName Optional widget specific override.
-     * @throws Error if no plugin has been registered for the provided type.
-     * @returns A newly instantiated plugin ready for rendering.
+     * Resolves and instantiates the correct control plugin based on the field type and widget hint.
+     * Falls back to the primitive type handler if the specific widget is not registered.
+     * 
+     * @param type The JSON Schema primitive type.
+     * @param widgetName The specific UI widget hint (if provided in schema.ui.widget).
+     * @returns {IPlugin} A new instance of the resolved plugin.
+     * @throws {Error} If no handler is registered for the specified type.
      */
     public getPlugin(type: FieldType, widgetName?: string): IPlugin {
         let PluginClass;
         
-        // 1. Attempt specific widget lookup
         if (widgetName) {
-            PluginClass = this.plugins.get(`${type}:${widgetName}`);
+            PluginClass = this.registry.get(`${type}:${widgetName}`);
         }
         
-        // 2. Fallback to primitive type
         if (!PluginClass) {
-            PluginClass = this.plugins.get(type);
+            PluginClass = this.registry.get(type);
         }
 
         if (!PluginClass) {
-            throw new Error(`[MetaUI] No plugin registered for FieldType: ${type}`);
+            const msg = `No control plugin registered for FieldType: ${type}${widgetName ? ` (widget: ${widgetName})` : ''}`;
+            Logger.error("[MetaUI PluginRegistry]", msg);
+            Logger.showErrorPopup(`Plugin Registry Error.\n\nDetails: ${msg}`);
+            throw new Error(`[MetaUI] ${msg}`);
         }
         
-        return new PluginClass();
+        try {
+            return new PluginClass();
+        } catch (error) {
+            const msg = (error as Error).message;
+            Logger.error(`[MetaUI PluginRegistry] Failed to instantiate plugin for ${type}`, msg);
+            Logger.showErrorPopup(`Failed to instantiate plugin for '${type}'.\n\nDetails: ${msg}`);
+            throw new Error(`[MetaUI Plugin Instantiation] ${msg}`);
+        }
     }
 }

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

@@ -0,0 +1,79 @@
+sap.ui.define(["../utils/Logger"], function (___utils_Logger) {
+  "use strict";
+
+  /**
+   * @file Registry.ts
+   * @description Universal generic registry pattern used across the MetaUI library 
+   * for registering and resolving decoupled plugins (Layouts, Controls, Validators, etc).
+   */
+  const Logger = ___utils_Logger["Logger"];
+  /**
+   * Universal generic registry pattern used across the MetaUI library 
+   * for registering and resolving decoupled plugins (Layouts, Controls, Validators, etc).
+   * 
+   * @template T The type of item being stored in the registry.
+   * @namespace nz.co.siliconst.ui5.metaui.core
+   * @public
+   */
+  class Registry {
+    /** The internal map storing the registered items. */
+    items = new Map();
+    constructor(registryName = "Registry") {
+      this.registryName = registryName;
+    }
+
+    /**
+     * Registers a new item (plugin/layout/validator) into the registry.
+     * @param key The unique string identifier.
+     * @param item The implementation class or instance.
+     */
+    register(key, item) {
+      if (this.items.has(key)) {
+        Logger.warn(`[MetaUI] ${this.registryName}: Overwriting existing key '${key}'.`);
+      }
+      this.items.set(key, item);
+    }
+
+    /**
+     * Retrieves an item by its key.
+     * @param key The unique string identifier.
+     * @returns The registered item, or undefined if not found.
+     */
+    get(key) {
+      return this.items.get(key);
+    }
+
+    /**
+     * Retrieves an item by its key, throwing an error if it doesn't exist.
+     * @param key The unique string identifier.
+     * @returns The registered item.
+     */
+    getStrict(key) {
+      const item = this.get(key);
+      if (!item) {
+        throw new Error(`[MetaUI] ${this.registryName}: Key '${key}' not found.`);
+      }
+      return item;
+    }
+
+    /**
+     * Returns an array of all registered keys.
+     */
+    getKeys() {
+      return Array.from(this.items.keys());
+    }
+
+    /**
+     * Clears the entire registry.
+     */
+    clear() {
+      this.items.clear();
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.Registry = Registry;
+  return __exports;
+});
+//# sourceMappingURL=Registry-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Registry-dbg.js","names":["Logger","___utils_Logger","Registry","items","Map","constructor","registryName","register","key","item","has","warn","set","get","getStrict","Error","getKeys","Array","from","keys","clear","__exports","__esModule"],"sources":["Registry.ts"],"sourcesContent":["/**\n * @file Registry.ts\n * @description Universal generic registry pattern used across the MetaUI library \n * for registering and resolving decoupled plugins (Layouts, Controls, Validators, etc).\n */\n\nimport { Logger } from \"../utils/Logger\";\n\n/**\n * Universal generic registry pattern used across the MetaUI library \n * for registering and resolving decoupled plugins (Layouts, Controls, Validators, etc).\n * \n * @template T The type of item being stored in the registry.\n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class Registry<T> {\n    /** The internal map storing the registered items. */\n    public readonly items = new Map<string, T>();\n\n    constructor(public readonly registryName: string = \"Registry\") {}\n\n    /**\n     * Registers a new item (plugin/layout/validator) into the registry.\n     * @param key The unique string identifier.\n     * @param item The implementation class or instance.\n     */\n    public register(key: string, item: T): void {\n        if (this.items.has(key)) {\n            Logger.warn(`[MetaUI] ${this.registryName}: Overwriting existing key '${key}'.`);\n        }\n        this.items.set(key, item);\n    }\n\n    /**\n     * Retrieves an item by its key.\n     * @param key The unique string identifier.\n     * @returns The registered item, or undefined if not found.\n     */\n    public get(key: string): T | undefined {\n        return this.items.get(key);\n    }\n\n    /**\n     * Retrieves an item by its key, throwing an error if it doesn't exist.\n     * @param key The unique string identifier.\n     * @returns The registered item.\n     */\n    public getStrict(key: string): T {\n        const item = this.get(key);\n        if (!item) {\n            throw new Error(`[MetaUI] ${this.registryName}: Key '${key}' not found.`);\n        }\n        return item;\n    }\n\n    /**\n     * Returns an array of all registered keys.\n     */\n    public getKeys(): string[] {\n        return Array.from(this.items.keys());\n    }\n\n    /**\n     * Clears the entire registry.\n     */\n    public clear(): void {\n        this.items.clear();\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;AACA;EAJA,MAMSA,MAAM,GAAAC,eAAA;EAEf;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,QAAQ,CAAI;IACrB;IACgBC,KAAK,GAAG,IAAIC,GAAG,CAAY,CAAC;IAE5CC,WAAWA,CAAiBC,YAAoB,GAAG,UAAU,EAAE;MAAA,KAAnCA,YAAoB,GAApBA,YAAoB;IAAgB;;IAEhE;AACJ;AACA;AACA;AACA;IACWC,QAAQA,CAACC,GAAW,EAAEC,IAAO,EAAQ;MACxC,IAAI,IAAI,CAACN,KAAK,CAACO,GAAG,CAACF,GAAG,CAAC,EAAE;QACrBR,MAAM,CAACW,IAAI,CAAC,YAAY,IAAI,CAACL,YAAY,+BAA+BE,GAAG,IAAI,CAAC;MACpF;MACA,IAAI,CAACL,KAAK,CAACS,GAAG,CAACJ,GAAG,EAAEC,IAAI,CAAC;IAC7B;;IAEA;AACJ;AACA;AACA;AACA;IACWI,GAAGA,CAACL,GAAW,EAAiB;MACnC,OAAO,IAAI,CAACL,KAAK,CAACU,GAAG,CAACL,GAAG,CAAC;IAC9B;;IAEA;AACJ;AACA;AACA;AACA;IACWM,SAASA,CAACN,GAAW,EAAK;MAC7B,MAAMC,IAAI,GAAG,IAAI,CAACI,GAAG,CAACL,GAAG,CAAC;MAC1B,IAAI,CAACC,IAAI,EAAE;QACP,MAAM,IAAIM,KAAK,CAAC,YAAY,IAAI,CAACT,YAAY,UAAUE,GAAG,cAAc,CAAC;MAC7E;MACA,OAAOC,IAAI;IACf;;IAEA;AACJ;AACA;IACWO,OAAOA,CAAA,EAAa;MACvB,OAAOC,KAAK,CAACC,IAAI,CAAC,IAAI,CAACf,KAAK,CAACgB,IAAI,CAAC,CAAC,CAAC;IACxC;;IAEA;AACJ;AACA;IACWC,KAAKA,CAAA,EAAS;MACjB,IAAI,CAACjB,KAAK,CAACiB,KAAK,CAAC,CAAC;IACtB;EACJ;EAAC,IAAAC,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAnB,QAAA,GAAAA,QAAA;EAAA,OAAAmB,SAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,43 @@
+declare module "nz/co/siliconst/ui5/metaui/core/Registry" {
+    /**
+     * Universal generic registry pattern used across the MetaUI library
+     * for registering and resolving decoupled plugins (Layouts, Controls, Validators, etc).
+     *
+     * @template T The type of item being stored in the registry.
+     * @namespace nz.co.siliconst.ui5.metaui.core
+     * @public
+     */
+    export class Registry<T> {
+        readonly registryName: string;
+        /** The internal map storing the registered items. */
+        readonly items: any;
+        constructor(registryName?: string);
+        /**
+         * Registers a new item (plugin/layout/validator) into the registry.
+         * @param key The unique string identifier.
+         * @param item The implementation class or instance.
+         */
+        register(key: string, item: T): void;
+        /**
+         * Retrieves an item by its key.
+         * @param key The unique string identifier.
+         * @returns The registered item, or undefined if not found.
+         */
+        get(key: string): T | undefined;
+        /**
+         * Retrieves an item by its key, throwing an error if it doesn't exist.
+         * @param key The unique string identifier.
+         * @returns The registered item.
+         */
+        getStrict(key: string): T;
+        /**
+         * Returns an array of all registered keys.
+         */
+        getKeys(): string[];
+        /**
+         * Clears the entire registry.
+         */
+        clear(): void;
+    }
+}
+//# sourceMappingURL=Registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Registry.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/Registry.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,0CAA0C,CAAC;IAS1D;;;;;;;OAOG;IACH,MAAa,QAAQ,CAAC,CAAC;iBAIS,YAAY,EAAE,MAAM;QAHhD,qDAAqD;QACrD,SAAgB,KAAK,MAAwB;oBAEjB,YAAY,GAAE,MAAmB;QAE7D;;;;WAIG;QACI,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;QAO3C;;;;WAIG;QACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;QAItC;;;;WAIG;QACI,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC;QAQhC;;WAEG;QACI,OAAO,IAAI,MAAM,EAAE;QAI1B;;WAEG;QACI,KAAK,IAAI,IAAI;KAGvB;CAEA"}

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

@@ -0,0 +1,2 @@
+sap.ui.define(["../utils/Logger"],function(t){"use strict";const e=t["Logger"];class r{items=new Map;constructor(t="Registry"){this.registryName=t}register(t,r){if(this.items.has(t)){e.warn(`[MetaUI] ${this.registryName}: Overwriting existing key '${t}'.`)}this.items.set(t,r)}get(t){return this.items.get(t)}getStrict(t){const e=this.get(t);if(!e){throw new Error(`[MetaUI] ${this.registryName}: Key '${t}' not found.`)}return e}getKeys(){return Array.from(this.items.keys())}clear(){this.items.clear()}}var s={__esModule:true};s.Registry=r;return s});
+//# sourceMappingURL=Registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Registry.js","names":["Logger","___utils_Logger","Registry","items","Map","constructor","registryName","this","register","key","item","has","warn","set","get","getStrict","Error","getKeys","Array","from","keys","clear","__exports","__esModule"],"sources":["Registry.ts"],"sourcesContent":["/**\n * @file Registry.ts\n * @description Universal generic registry pattern used across the MetaUI library \n * for registering and resolving decoupled plugins (Layouts, Controls, Validators, etc).\n */\n\nimport { Logger } from \"../utils/Logger\";\n\n/**\n * Universal generic registry pattern used across the MetaUI library \n * for registering and resolving decoupled plugins (Layouts, Controls, Validators, etc).\n * \n * @template T The type of item being stored in the registry.\n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class Registry<T> {\n    /** The internal map storing the registered items. */\n    public readonly items = new Map<string, T>();\n\n    constructor(public readonly registryName: string = \"Registry\") {}\n\n    /**\n     * Registers a new item (plugin/layout/validator) into the registry.\n     * @param key The unique string identifier.\n     * @param item The implementation class or instance.\n     */\n    public register(key: string, item: T): void {\n        if (this.items.has(key)) {\n            Logger.warn(`[MetaUI] ${this.registryName}: Overwriting existing key '${key}'.`);\n        }\n        this.items.set(key, item);\n    }\n\n    /**\n     * Retrieves an item by its key.\n     * @param key The unique string identifier.\n     * @returns The registered item, or undefined if not found.\n     */\n    public get(key: string): T | undefined {\n        return this.items.get(key);\n    }\n\n    /**\n     * Retrieves an item by its key, throwing an error if it doesn't exist.\n     * @param key The unique string identifier.\n     * @returns The registered item.\n     */\n    public getStrict(key: string): T {\n        const item = this.get(key);\n        if (!item) {\n            throw new Error(`[MetaUI] ${this.registryName}: Key '${key}' not found.`);\n        }\n        return item;\n    }\n\n    /**\n     * Returns an array of all registered keys.\n     */\n    public getKeys(): string[] {\n        return Array.from(this.items.keys());\n    }\n\n    /**\n     * Clears the entire registry.\n     */\n    public clear(): void {\n        this.items.clear();\n    }\n}\n"],"mappings":"2DAAA,MAMSA,EAAMC,EAAA,UAUR,MAAMC,EAEOC,MAAQ,IAAIC,IAE5BC,YAA4BC,EAAuB,YAAYC,KAAnCD,cAAoC,CAOzDE,SAASC,EAAaC,GACzB,GAAIH,KAAKJ,MAAMQ,IAAIF,GAAM,CACrBT,EAAOY,KAAK,YAAYL,KAAKD,2CAA2CG,MAC5E,CACAF,KAAKJ,MAAMU,IAAIJ,EAAKC,EACxB,CAOOI,IAAIL,GACP,OAAOF,KAAKJ,MAAMW,IAAIL,EAC1B,CAOOM,UAAUN,GACb,MAAMC,EAAOH,KAAKO,IAAIL,GACtB,IAAKC,EAAM,CACP,MAAM,IAAIM,MAAM,YAAYT,KAAKD,sBAAsBG,gBAC3D,CACA,OAAOC,CACX,CAKOO,UACH,OAAOC,MAAMC,KAAKZ,KAAKJ,MAAMiB,OACjC,CAKOC,QACHd,KAAKJ,MAAMkB,OACf,EACH,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAApB,WAAA,OAAAoB,CAAA","ignoreList":[]}

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

@@ -0,0 +1,70 @@
+/**
+ * @file Registry.ts
+ * @description Universal generic registry pattern used across the MetaUI library 
+ * for registering and resolving decoupled plugins (Layouts, Controls, Validators, etc).
+ */
+
+import { Logger } from "../utils/Logger";
+
+/**
+ * Universal generic registry pattern used across the MetaUI library 
+ * for registering and resolving decoupled plugins (Layouts, Controls, Validators, etc).
+ * 
+ * @template T The type of item being stored in the registry.
+ * @namespace nz.co.siliconst.ui5.metaui.core
+ * @public
+ */
+export class Registry<T> {
+    /** The internal map storing the registered items. */
+    public readonly items = new Map<string, T>();
+
+    constructor(public readonly registryName: string = "Registry") {}
+
+    /**
+     * Registers a new item (plugin/layout/validator) into the registry.
+     * @param key The unique string identifier.
+     * @param item The implementation class or instance.
+     */
+    public register(key: string, item: T): void {
+        if (this.items.has(key)) {
+            Logger.warn(`[MetaUI] ${this.registryName}: Overwriting existing key '${key}'.`);
+        }
+        this.items.set(key, item);
+    }
+
+    /**
+     * Retrieves an item by its key.
+     * @param key The unique string identifier.
+     * @returns The registered item, or undefined if not found.
+     */
+    public get(key: string): T | undefined {
+        return this.items.get(key);
+    }
+
+    /**
+     * Retrieves an item by its key, throwing an error if it doesn't exist.
+     * @param key The unique string identifier.
+     * @returns The registered item.
+     */
+    public getStrict(key: string): T {
+        const item = this.get(key);
+        if (!item) {
+            throw new Error(`[MetaUI] ${this.registryName}: Key '${key}' not found.`);
+        }
+        return item;
+    }
+
+    /**
+     * Returns an array of all registered keys.
+     */
+    public getKeys(): string[] {
+        return Array.from(this.items.keys());
+    }
+
+    /**
+     * Clears the entire registry.
+     */
+    public clear(): void {
+        this.items.clear();
+    }
+}

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

@@ -1,11 +1,11 @@
-sap.ui.define([], function () {
+sap.ui.define(["../utils/Logger"], function (___utils_Logger) {
   "use strict";
 
   /**
    * @file SchemaNormalizer.ts
    * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.
    */
-
+  const Logger = ___utils_Logger["Logger"];
   class SchemaNormalizer {
     /**
      * Validates that the provided raw payload conforms to the required ISchema structures.
@@ -16,28 +16,68 @@ sap.ui.define([], function () {
         try {
           schemaObj = JSON.parse(schemaObj);
         } catch (e) {
-          console.warn("[MetaUI] Failed to parse schema string, falling back to inference.", e);
+          const msg = e.message;
+          Logger.error("[MetaUI SchemaNormalizer] Failed to parse schema string.", msg);
+          Logger.showErrorPopup(`Failed to parse the provided JSON schema.\n\nDetails: ${msg}`);
           schemaObj = null;
         }
       }
       if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {
         return this.inferSchemaFromData(data);
       }
-
-      // It is an object. Ensure it conforms to v2 structure.
-      const normalized = {
-        title: schemaObj.title || "MetaUI Generated Form",
-        type: schemaObj.type || (schemaObj.items ? "array" : "object")
-      };
-      if (normalized.type === "object") {
-        normalized.properties = this.normalizeProperties(schemaObj.properties || {});
-      } else if (normalized.type === "array") {
-        normalized.items = this.normalizePropertyMetadata(schemaObj.items || {
+      try {
+        // It is an object. Ensure it conforms to v2 structure.
+        const normalized = {
+          title: schemaObj.title,
+          type: schemaObj.type || (schemaObj.items ? "array" : "object"),
+          layoutStrategy: schemaObj.layoutStrategy,
+          uiLayout: schemaObj.uiLayout,
+          additionalProperties: schemaObj.additionalProperties
+        };
+        let targetProperties = schemaObj.properties || {};
+        if (schemaObj.additionalProperties === true && data) {
+          const inferred = this.inferSchemaFromData(data);
+          if (inferred.type === "object" && inferred.properties) {
+            targetProperties = this.deepMergeProperties(inferred.properties, targetProperties);
+          } else if (inferred.type === "array" && inferred.items && inferred.items.properties) {
+            // Array schema merging could be added here if we want full support.
+          }
+        }
+        if (normalized.type === "object") {
+          normalized.properties = this.normalizeProperties(targetProperties);
+        } else if (normalized.type === "array") {
+          // Future expansion: array deep merge
+          normalized.items = this.normalizePropertyMetadata(schemaObj.items || {
+            type: "object",
+            properties: {}
+          }, "items");
+        }
+        return normalized;
+      } catch (error) {
+        const msg = error.message;
+        Logger.error("[MetaUI SchemaNormalizer] Critical error normalizing schema object.", msg);
+        Logger.showErrorPopup(`Schema Normalization failed.\n\nDetails: ${msg}`);
+        // Fallback to empty object to prevent hard crash downstream
+        return {
           type: "object",
           properties: {}
-        }, "items");
+        };
       }
-      return normalized;
+    }
+    static deepMergeProperties(base, override) {
+      const merged = {
+        ...base
+      };
+      for (const key of Object.keys(override)) {
+        const overrideVal = override[key];
+        const baseVal = merged[key];
+        if (baseVal && typeof baseVal === "object" && !Array.isArray(baseVal) && overrideVal && typeof overrideVal === "object" && !Array.isArray(overrideVal)) {
+          merged[key] = this.deepMergeProperties(baseVal, overrideVal);
+        } else {
+          merged[key] = overrideVal;
+        }
+      }
+      return merged;
     }
     static normalizeProperties(properties) {
       const normalizedProps = {};
@@ -53,11 +93,15 @@ sap.ui.define([], function () {
           label: prop.ui?.label || this.generateLabel(keyName),
           isKey: !!prop.ui?.isKey,
           readOnly: !!prop.ui?.readOnly,
-          widget: prop.ui?.widget,
-          group: prop.ui?.group,
+          widget: prop.ui?.widget || (prop.valueHelp || prop.enum ? "select" : undefined),
           visibleOn: prop.ui?.visibleOn,
           enabledOn: prop.ui?.enabledOn,
-          format: prop.ui?.format
+          format: prop.ui?.format,
+          validators: prop.ui?.validators,
+          formatter: prop.ui?.formatter,
+          args: prop.ui?.args,
+          rows: prop.ui?.rows,
+          fullWidth: prop.ui?.fullWidth
         },
         required: !!prop.required,
         maxLength: prop.maxLength,
@@ -66,12 +110,15 @@ sap.ui.define([], function () {
         pattern: prop.pattern,
         precision: prop.precision,
         scale: prop.scale,
-        valueHelp: prop.valueHelp
+        valueHelp: prop.valueHelp,
+        enum: prop.enum
       };
       if (normalized.type === "object" && prop.properties) {
         normalized.properties = this.normalizeProperties(prop.properties);
+        normalized.uiLayout = prop.uiLayout;
       } else if (normalized.type === "array" && prop.items) {
         normalized.items = this.normalizePropertyMetadata(prop.items, "items");
+        normalized.uiLayout = prop.uiLayout;
       }
       return normalized;
     }
@@ -91,15 +138,19 @@ sap.ui.define([], function () {
     static inferSchemaFromData(data) {
       const schema = {
         type: "object",
-        properties: {}
+        properties: {},
+        layoutStrategy: "compact",
+        title: ""
       };
       if (!data || typeof data !== "object") {
         return schema;
       }
       if (Array.isArray(data)) {
         schema.type = "array";
+        schema.layoutStrategy = "table";
         schema.items = {
           type: "object",
+          layoutStrategy: "compact",
           properties: data.length > 0 ? this.inferPropertiesFromObject(data[0]) : {}
         };
       } else {
@@ -114,19 +165,23 @@ sap.ui.define([], function () {
       for (const key of Object.keys(obj)) {
         const val = obj[key];
         if (val === null || val === undefined) continue;
-        if (typeof val === "object" && !Array.isArray(val)) continue;
         let type = "string";
         let items;
+        let nestedProps;
         if (typeof val === "number") type = "number";else if (typeof val === "boolean") type = "boolean";else if (Array.isArray(val)) {
           type = "array";
           items = {
             type: "object",
             properties: val.length > 0 ? this.inferPropertiesFromObject(val[0]) : {}
           };
+        } else if (typeof val === "object") {
+          type = "object";
+          nestedProps = this.inferPropertiesFromObject(val);
         }
         properties[key] = {
           type,
           items,
+          properties: nestedProps,
           ui: {
             label: this.generateLabel(key),
             isKey: false,
@@ -136,6 +191,46 @@ sap.ui.define([], function () {
       }
       return properties;
     }
+
+    /**
+     * Resolves a JSON Schema scope (e.g. '#/properties/header/properties/id')
+     * against the ISchema, returning the PropertyMetadata and the UI5 binding path.
+     */
+    static resolveScope(schema, scope) {
+      if (!scope || !scope.startsWith("#/properties/")) {
+        return {
+          meta: undefined,
+          bindingPath: scope || "",
+          propKey: scope || ""
+        };
+      }
+      const pathSegments = scope.replace("#/properties/", "").split("/properties/");
+      let current = schema.properties;
+      let meta;
+      Logger.debug("[MetaUI SchemaNormalizer]", `Resolving scope '${scope}' with segments: ${JSON.stringify(pathSegments)}`, "SchemaNormalizer");
+      Logger.debug("[MetaUI SchemaNormalizer]", `Root schema keys: ${Object.keys(schema.properties || {})}`, "SchemaNormalizer");
+      for (let i = 0; i < pathSegments.length; i++) {
+        const segment = pathSegments[i];
+        if (!current) {
+          Logger.debug("[MetaUI SchemaNormalizer]", `current is undefined at segment '${segment}'`, "SchemaNormalizer");
+          meta = undefined;
+          break;
+        }
+        meta = current[segment];
+        Logger.debug("[MetaUI SchemaNormalizer]", `Segment '${segment}' resolved to meta: ${!!meta}. Available keys in current: ${Object.keys(current)}`, "SchemaNormalizer");
+        if (i < pathSegments.length - 1) {
+          current = meta?.properties;
+        }
+      }
+      const bindingPath = pathSegments.join("/");
+      const propKey = scope.replace("#/properties/", ""); // The original raw string for logging
+
+      return {
+        meta,
+        bindingPath,
+        propKey
+      };
+    }
   }
   var __exports = {
     __esModule: true