@siliconst/metaui 1.0.2 → 1.4.4

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

@@ -1,56 +1,160 @@
-/**
- * @file PluginRegistry.ts
- * @description Centralized hub for mapping UI5 controls to SAP schema data types.
- * Enforces the Registry Pattern to decouple the core engine from specific UI5 control implementations.
- */
-
-import { IPlugin } from "../interfaces/IPlugin";
-import { FieldType } from "../interfaces/ISchema";
-
-/**
- * Singleton registry that manages the lifecycle and lookup of UI5 plugin constructors.
- */
-export class PluginRegistry {
-    private static instance: PluginRegistry;
-    
-    /** Internal map linking string types to their respective constructor functions. */
-    private plugins: Map<FieldType, new () => IPlugin> = new Map();
-
-    private constructor() {
-        // Enforce singleton
-    }
-
-    /**
-     * Retrieves the singular instance of the PluginRegistry.
-     * @returns The PluginRegistry singleton.
-     */
-    public static getInstance(): PluginRegistry {
-        if (!PluginRegistry.instance) {
-            PluginRegistry.instance = new PluginRegistry();
-        }
-        return PluginRegistry.instance;
-    }
-
-    /**
-     * Registers a new UI control plugin against a specific schema primitive type.
-     * @param type The primitive FieldType (e.g., 'string', 'date').
-     * @param pluginConstructor The class constructor for the plugin.
-     */
-    public register(type: FieldType, pluginConstructor: new () => IPlugin): void {
-        this.plugins.set(type, pluginConstructor);
-    }
-
-    /**
-     * Instantiates and returns a new plugin based on the requested primitive type.
-     * @param type The primitive FieldType to look up.
-     * @throws Error if no plugin has been registered for the provided type.
-     * @returns A newly instantiated plugin ready for rendering.
-     */
-    public getPlugin(type: FieldType): IPlugin {
-        const PluginClass = this.plugins.get(type);
-        if (!PluginClass) {
-            throw new Error(`[MetaUI] No plugin registered for FieldType: ${type}`);
-        }
-        return new PluginClass();
-    }
-}
+/**
+ * @file PluginRegistry.ts
+ * @description Centralized hub for mapping UI5 controls to SAP schema data types.
+ * Enforces the Registry Pattern to decouple the core engine from specific UI5 control implementations.
+ */
+
+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 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 strongly typed registry holding plugin constructors. */
+    private readonly registry: Registry<new () => IPlugin> = new Registry<new () => IPlugin>("Controls");
+
+    private constructor() {
+        // 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 {PluginRegistry} The active instance.
+     */
+    public static getInstance(): PluginRegistry {
+        if (!PluginRegistry.instance) {
+            PluginRegistry.instance = new PluginRegistry();
+        }
+        return PluginRegistry.instance;
+    }
+
+    /**
+     * 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.registry.register(key, pluginConstructor);
+    }
+
+    /**
+     * 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;
+        
+        if (widgetName) {
+            PluginClass = this.registry.get(`${type}:${widgetName}`);
+        }
+        
+        if (!PluginClass) {
+            PluginClass = this.registry.get(type);
+        }
+
+        if (!PluginClass) {
+            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}`);
+        }
+        
+        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();
+    }
+}