@siliconst/metaui 1.0.2 → 1.4.4

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

@@ -0,0 +1,106 @@
+/**
+ * @file PipelineManager.ts
+ * @description Central manager for the data manipulation pipeline. 
+ * Orchestrates Formatting, Parsing, and Validating data using the generic Registry.
+ */
+
+import { Registry } from "./Registry";
+import { IFormatter, IParser, IValidator, IValidationResult } from "../interfaces/IPipeline";
+import { PatternValidatorPlugin } from "../plugins/validators/PatternValidatorPlugin";
+import { MinLengthValidatorPlugin } from "../plugins/validators/MinLengthValidatorPlugin";
+import { RangeValidatorPlugin } from "../plugins/validators/RangeValidatorPlugin";
+import { UrlValidatorPlugin } from "../plugins/validators/UrlValidatorPlugin";
+import { IbanValidatorPlugin } from "../plugins/validators/IbanValidatorPlugin";
+import { EmailValidatorPlugin } from "../plugins/validators/EmailValidatorPlugin";
+import { DateFormatterPlugin } from "../plugins/formatters/DateFormatterPlugin";
+import { PhoneFormatterPlugin } from "../plugins/formatters/PhoneFormatterPlugin";
+import { TextCaseFormatterPlugin } from "../plugins/formatters/TextCaseFormatterPlugin";
+import { Logger } from "../utils/Logger";
+
+// --- Built-in Default Validators ---
+class RequiredValidator implements IValidator {
+    validate(parsedValue: unknown, args?: unknown): IValidationResult {
+        if (parsedValue === null || parsedValue === undefined || parsedValue === "") {
+            return { isValid: false, errorMessage: "This field is required." };
+        }
+        return { isValid: true };
+    }
+}
+
+class MaxLengthValidator implements IValidator {
+    validate(parsedValue: unknown, args?: unknown): IValidationResult {
+        if (typeof parsedValue === "string" && args && typeof args === "number") {
+            if (parsedValue.length > args) {
+                return { isValid: false, errorMessage: `Maximum length is ${args} characters.` };
+            }
+        }
+        return { isValid: true };
+    }
+}
+
+
+/**
+ * The core engine responsible for marshalling data through the validation, formatting, and parsing phases.
+ * Pluggable design allows new validators to be registered dynamically.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.core
+ * @public
+ */
+export class PipelineManager {
+    /** Registry of data formatters applied before pushing to the UI. */
+    public readonly formatters: Registry<IFormatter> = new Registry<IFormatter>("Formatters");
+    /** Registry of data parsers applied when pulling data from the UI. */
+    public readonly parsers: Registry<IParser> = new Registry<IParser>("Parsers");
+    /** Registry of business logic validators. */
+    public readonly validators: Registry<IValidator> = new Registry<IValidator>("Validators");
+
+    /**
+     * Bootstraps the PipelineManager with default validators (required, maxLength, email).
+     */
+    constructor() {
+        // Register default validators
+        this.validators.register("required", new RequiredValidator());
+        this.validators.register("maxLength", new MaxLengthValidator());
+        this.validators.register("pattern", new PatternValidatorPlugin());
+        this.validators.register("minLength", new MinLengthValidatorPlugin());
+        this.validators.register("range", new RangeValidatorPlugin());
+        this.validators.register("url", new UrlValidatorPlugin());
+        this.validators.register("iban", new IbanValidatorPlugin());
+        this.validators.register("email", new EmailValidatorPlugin());
+
+        // Register default formatters
+        this.formatters.register("date", new DateFormatterPlugin());
+        this.formatters.register("phone", new PhoneFormatterPlugin());
+        this.formatters.register("textCase", new TextCaseFormatterPlugin());
+    }
+
+    /**
+     * Executes the validation pipeline sequentially. Fails fast on the first encountered error.
+     * 
+     * @param parsedValue The raw extracted value from the UI control.
+     * @param requestedValidators Array of validation rule keys (e.g. ['required', 'email']).
+     * @param argsMap Optional map of parameters required by specific rules (e.g. { maxLength: 50 }).
+     * @returns {IValidationResult} The final result state and any associated error message.
+     */
+    public executeValidation(parsedValue: unknown, requestedValidators: string[], argsMap?: Record<string, any>): IValidationResult {
+        for (const rule of requestedValidators) {
+            const validator = this.validators.get(rule);
+            if (validator) {
+                const args = argsMap ? argsMap[rule] : undefined;
+                const result = validator.validate(parsedValue, args);
+                if (!result.isValid) {
+                    return result; // Fast fail on first error
+                }
+            } else {
+                Logger.warn(`[MetaUI] PipelineManager: Requested validator '${rule}' not found in registry.`);
+            }
+        }
+        return { isValid: true };
+    }
+}
+
+/** 
+ * Singleton instance for global access to the active validation pipeline. 
+ * @public 
+ */
+export const GlobalPipeline = new PipelineManager();

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

@@ -1,60 +1,152 @@
-sap.ui.define([], function () {
-  "use strict";
-
-  /**
-   * @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.
-   */
-
-  /**
-   * Singleton registry that manages the lifecycle and lookup of UI5 plugin constructors.
-   */
-  class PluginRegistry {
-    /** Internal map linking string types to their respective constructor functions. */
-    plugins = new Map();
-    constructor() {
-      // Enforce singleton
-    }
-
-    /**
-     * Retrieves the singular instance of the PluginRegistry.
-     * @returns The PluginRegistry singleton.
-     */
-    static getInstance() {
-      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.
-     */
-    register(type, pluginConstructor) {
-      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.
-     */
-    getPlugin(type) {
-      const PluginClass = this.plugins.get(type);
-      if (!PluginClass) {
-        throw new Error(`[MetaUI] No plugin registered for FieldType: ${type}`);
-      }
-      return new PluginClass();
-    }
-  }
-  var __exports = {
-    __esModule: true
-  };
-  __exports.PluginRegistry = PluginRegistry;
-  return __exports;
-});
+sap.ui.define(["./Registry", "../utils/Logger", "../plugins/controls/StringPlugin", "../plugins/controls/NumberPlugin", "../plugins/controls/DatePlugin", "../plugins/controls/TimePlugin", "../plugins/controls/DateTimePlugin", "../plugins/controls/BooleanPlugin", "../plugins/controls/SwitchPlugin", "../plugins/controls/ArrayPlugin", "../plugins/controls/ObjectPlugin", "../plugins/controls/DropdownPlugin", "../plugins/controls/TextAreaPlugin", "../plugins/controls/CodeEditorPlugin", "../plugins/controls/FileUploaderPlugin", "../plugins/controls/MultiSelectPlugin", "../plugins/controls/SliderPlugin", "../plugins/controls/RatingIndicatorPlugin", "../plugins/controls/MessageStripPlugin", "../plugins/controls/CameraPlugin", "../plugins/controls/SignaturePlugin", "../plugins/controls/GeolocationPlugin", "../plugins/controls/BarcodeScannerPlugin", "../plugins/controls/VoiceInputPlugin", "../plugins/controls/RichTextPlugin", "../plugins/actions/UrlNavigationActionPlugin", "../plugins/actions/SubmitFormActionPlugin", "../plugins/datasources/ODataListBindingPlugin", "../plugins/datasources/RemoteDropdownPlugin"], function (___Registry, ___utils_Logger, ___plugins_controls_StringPlugin, ___plugins_controls_NumberPlugin, ___plugins_controls_DatePlugin, ___plugins_controls_TimePlugin, ___plugins_controls_DateTimePlugin, ___plugins_controls_BooleanPlugin, ___plugins_controls_SwitchPlugin, ___plugins_controls_ArrayPlugin, ___plugins_controls_ObjectPlugin, ___plugins_controls_DropdownPlugin, ___plugins_controls_TextAreaPlugin, ___plugins_controls_CodeEditorPlugin, ___plugins_controls_FileUploaderPlugin, ___plugins_controls_MultiSelectPlugin, ___plugins_controls_SliderPlugin, ___plugins_controls_RatingIndicatorPlugin, ___plugins_controls_MessageStripPlugin, ___plugins_controls_CameraPlugin, ___plugins_controls_SignaturePlugin, ___plugins_controls_GeolocationPlugin, ___plugins_controls_BarcodeScannerPlugin, ___plugins_controls_VoiceInputPlugin, ___plugins_controls_RichTextPlugin, ___plugins_actions_UrlNavigationActionPlugin, ___plugins_actions_SubmitFormActionPlugin, ___plugins_datasources_ODataListBindingPlugin, ___plugins_datasources_RemoteDropdownPlugin) {
+  "use strict";
+
+  /**
+   * @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.
+   */
+  const Registry = ___Registry["Registry"];
+  const Logger = ___utils_Logger["Logger"];
+  const StringPlugin = ___plugins_controls_StringPlugin["StringPlugin"];
+  const NumberPlugin = ___plugins_controls_NumberPlugin["NumberPlugin"];
+  const DatePlugin = ___plugins_controls_DatePlugin["DatePlugin"];
+  const TimePlugin = ___plugins_controls_TimePlugin["TimePlugin"];
+  const DateTimePlugin = ___plugins_controls_DateTimePlugin["DateTimePlugin"];
+  const BooleanPlugin = ___plugins_controls_BooleanPlugin["BooleanPlugin"];
+  const SwitchPlugin = ___plugins_controls_SwitchPlugin["SwitchPlugin"];
+  const ArrayPlugin = ___plugins_controls_ArrayPlugin["ArrayPlugin"];
+  const ObjectPlugin = ___plugins_controls_ObjectPlugin["ObjectPlugin"];
+  const DropdownPlugin = ___plugins_controls_DropdownPlugin["DropdownPlugin"];
+  const TextAreaPlugin = ___plugins_controls_TextAreaPlugin["TextAreaPlugin"];
+  const CodeEditorPlugin = ___plugins_controls_CodeEditorPlugin["CodeEditorPlugin"]; // New Phase 1 Controls
+  const FileUploaderPlugin = ___plugins_controls_FileUploaderPlugin["FileUploaderPlugin"];
+  const MultiSelectPlugin = ___plugins_controls_MultiSelectPlugin["MultiSelectPlugin"];
+  const SliderPlugin = ___plugins_controls_SliderPlugin["SliderPlugin"];
+  const RatingIndicatorPlugin = ___plugins_controls_RatingIndicatorPlugin["RatingIndicatorPlugin"];
+  const MessageStripPlugin = ___plugins_controls_MessageStripPlugin["MessageStripPlugin"]; // New Phase 5 Hardware / Base64 Plugins
+  const CameraPlugin = ___plugins_controls_CameraPlugin["CameraPlugin"];
+  const SignaturePlugin = ___plugins_controls_SignaturePlugin["SignaturePlugin"];
+  const GeolocationPlugin = ___plugins_controls_GeolocationPlugin["GeolocationPlugin"];
+  const BarcodeScannerPlugin = ___plugins_controls_BarcodeScannerPlugin["BarcodeScannerPlugin"];
+  const VoiceInputPlugin = ___plugins_controls_VoiceInputPlugin["VoiceInputPlugin"];
+  const RichTextPlugin = ___plugins_controls_RichTextPlugin["RichTextPlugin"]; // New Phase 4 Actions & Datasources
+  const UrlNavigationActionPlugin = ___plugins_actions_UrlNavigationActionPlugin["UrlNavigationActionPlugin"];
+  const SubmitFormActionPlugin = ___plugins_actions_SubmitFormActionPlugin["SubmitFormActionPlugin"];
+  const ODataListBindingPlugin = ___plugins_datasources_ODataListBindingPlugin["ODataListBindingPlugin"];
+  const RemoteDropdownPlugin = ___plugins_datasources_RemoteDropdownPlugin["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
+   */
+  class PluginRegistry {
+    /** The single instance of the PluginRegistry. */
+
+    /** Internal strongly typed registry holding plugin constructors. */
+    registry = new Registry("Controls");
+    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.
+     */
+    static getInstance() {
+      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').
+     */
+    register(type, pluginConstructor, widgetName) {
+      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.
+     */
+    getPlugin(type, widgetName) {
+      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.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}`);
+      }
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.PluginRegistry = PluginRegistry;
+  return __exports;
+});
 //# sourceMappingURL=PluginRegistry-dbg.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"PluginRegistry-dbg.js","names":["PluginRegistry","plugins","Map","constructor","getInstance","instance","register","type","pluginConstructor","set","getPlugin","PluginClass","get","Error","__exports","__esModule"],"sources":["PluginRegistry.ts"],"sourcesContent":["/**\r\n * @file PluginRegistry.ts\r\n * @description Centralized hub for mapping UI5 controls to SAP schema data types.\r\n * Enforces the Registry Pattern to decouple the core engine from specific UI5 control implementations.\r\n */\r\n\r\nimport { IPlugin } from \"../interfaces/IPlugin\";\r\nimport { FieldType } from \"../interfaces/ISchema\";\r\n\r\n/**\r\n * Singleton registry that manages the lifecycle and lookup of UI5 plugin constructors.\r\n */\r\nexport class PluginRegistry {\r\n    private static instance: PluginRegistry;\r\n    \r\n    /** Internal map linking string types to their respective constructor functions. */\r\n    private plugins: Map<FieldType, new () => IPlugin> = new Map();\r\n\r\n    private constructor() {\r\n        // Enforce singleton\r\n    }\r\n\r\n    /**\r\n     * Retrieves the singular instance of the PluginRegistry.\r\n     * @returns The PluginRegistry singleton.\r\n     */\r\n    public static getInstance(): PluginRegistry {\r\n        if (!PluginRegistry.instance) {\r\n            PluginRegistry.instance = new PluginRegistry();\r\n        }\r\n        return PluginRegistry.instance;\r\n    }\r\n\r\n    /**\r\n     * Registers a new UI control plugin against a specific schema primitive type.\r\n     * @param type The primitive FieldType (e.g., 'string', 'date').\r\n     * @param pluginConstructor The class constructor for the plugin.\r\n     */\r\n    public register(type: FieldType, pluginConstructor: new () => IPlugin): void {\r\n        this.plugins.set(type, pluginConstructor);\r\n    }\r\n\r\n    /**\r\n     * Instantiates and returns a new plugin based on the requested primitive type.\r\n     * @param type The primitive FieldType to look up.\r\n     * @throws Error if no plugin has been registered for the provided type.\r\n     * @returns A newly instantiated plugin ready for rendering.\r\n     */\r\n    public getPlugin(type: FieldType): IPlugin {\r\n        const PluginClass = this.plugins.get(type);\r\n        if (!PluginClass) {\r\n            throw new Error(`[MetaUI] No plugin registered for FieldType: ${type}`);\r\n        }\r\n        return new PluginClass();\r\n    }\r\n}\r\n"],"mappings":";;;EAAA;AACA;AACA;AACA;AACA;;EAKA;AACA;AACA;EACO,MAAMA,cAAc,CAAC;IAGxB;IACQC,OAAO,GAAsC,IAAIC,GAAG,CAAC,CAAC;IAEtDC,WAAWA,CAAA,EAAG;MAClB;IAAA;;IAGJ;AACJ;AACA;AACA;IACI,OAAcC,WAAWA,CAAA,EAAmB;MACxC,IAAI,CAACJ,cAAc,CAACK,QAAQ,EAAE;QAC1BL,cAAc,CAACK,QAAQ,GAAG,IAAIL,cAAc,CAAC,CAAC;MAClD;MACA,OAAOA,cAAc,CAACK,QAAQ;IAClC;;IAEA;AACJ;AACA;AACA;AACA;IACWC,QAAQA,CAACC,IAAe,EAAEC,iBAAoC,EAAQ;MACzE,IAAI,CAACP,OAAO,CAACQ,GAAG,CAACF,IAAI,EAAEC,iBAAiB,CAAC;IAC7C;;IAEA;AACJ;AACA;AACA;AACA;AACA;IACWE,SAASA,CAACH,IAAe,EAAW;MACvC,MAAMI,WAAW,GAAG,IAAI,CAACV,OAAO,CAACW,GAAG,CAACL,IAAI,CAAC;MAC1C,IAAI,CAACI,WAAW,EAAE;QACd,MAAM,IAAIE,KAAK,CAAC,gDAAgDN,IAAI,EAAE,CAAC;MAC3E;MACA,OAAO,IAAII,WAAW,CAAC,CAAC;IAC5B;EACJ;EAAC,IAAAG,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAd,cAAA,GAAAA,cAAA;EAAA,OAAAc,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"PluginRegistry-dbg.js","names":["Registry","___Registry","Logger","___utils_Logger","StringPlugin","___plugins_controls_StringPlugin","NumberPlugin","___plugins_controls_NumberPlugin","DatePlugin","___plugins_controls_DatePlugin","TimePlugin","___plugins_controls_TimePlugin","DateTimePlugin","___plugins_controls_DateTimePlugin","BooleanPlugin","___plugins_controls_BooleanPlugin","SwitchPlugin","___plugins_controls_SwitchPlugin","ArrayPlugin","___plugins_controls_ArrayPlugin","ObjectPlugin","___plugins_controls_ObjectPlugin","DropdownPlugin","___plugins_controls_DropdownPlugin","TextAreaPlugin","___plugins_controls_TextAreaPlugin","CodeEditorPlugin","___plugins_controls_CodeEditorPlugin","FileUploaderPlugin","___plugins_controls_FileUploaderPlugin","MultiSelectPlugin","___plugins_controls_MultiSelectPlugin","SliderPlugin","___plugins_controls_SliderPlugin","RatingIndicatorPlugin","___plugins_controls_RatingIndicatorPlugin","MessageStripPlugin","___plugins_controls_MessageStripPlugin","CameraPlugin","___plugins_controls_CameraPlugin","SignaturePlugin","___plugins_controls_SignaturePlugin","GeolocationPlugin","___plugins_controls_GeolocationPlugin","BarcodeScannerPlugin","___plugins_controls_BarcodeScannerPlugin","VoiceInputPlugin","___plugins_controls_VoiceInputPlugin","RichTextPlugin","___plugins_controls_RichTextPlugin","UrlNavigationActionPlugin","___plugins_actions_UrlNavigationActionPlugin","SubmitFormActionPlugin","___plugins_actions_SubmitFormActionPlugin","ODataListBindingPlugin","___plugins_datasources_ODataListBindingPlugin","RemoteDropdownPlugin","___plugins_datasources_RemoteDropdownPlugin","PluginRegistry","registry","constructor","register","getInstance","instance","type","pluginConstructor","widgetName","key","getPlugin","PluginClass","get","msg","error","showErrorPopup","Error","message","__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 */\n\nimport { IPlugin } from \"../interfaces/IPlugin\";\nimport { FieldType } from \"../interfaces/ISchema\";\n\nimport { Registry } from \"./Registry\";\nimport { Logger } from \"../utils/Logger\";\n\nimport { StringPlugin } from \"../plugins/controls/StringPlugin\";\nimport { NumberPlugin } from \"../plugins/controls/NumberPlugin\";\nimport { DatePlugin } from \"../plugins/controls/DatePlugin\";\nimport { TimePlugin } from \"../plugins/controls/TimePlugin\";\nimport { DateTimePlugin } from \"../plugins/controls/DateTimePlugin\";\nimport { BooleanPlugin } from \"../plugins/controls/BooleanPlugin\";\nimport { SwitchPlugin } from \"../plugins/controls/SwitchPlugin\";\nimport { ArrayPlugin } from \"../plugins/controls/ArrayPlugin\";\nimport { ObjectPlugin } from \"../plugins/controls/ObjectPlugin\";\nimport { DropdownPlugin } from \"../plugins/controls/DropdownPlugin\";\nimport { TextAreaPlugin } from \"../plugins/controls/TextAreaPlugin\";\nimport { CodeEditorPlugin } from \"../plugins/controls/CodeEditorPlugin\";\n\n// New Phase 1 Controls\nimport { FileUploaderPlugin } from \"../plugins/controls/FileUploaderPlugin\";\nimport { MultiSelectPlugin } from \"../plugins/controls/MultiSelectPlugin\";\nimport { SliderPlugin } from \"../plugins/controls/SliderPlugin\";\nimport { RatingIndicatorPlugin } from \"../plugins/controls/RatingIndicatorPlugin\";\nimport { MessageStripPlugin } from \"../plugins/controls/MessageStripPlugin\";\n\n// New Phase 5 Hardware / Base64 Plugins\nimport { CameraPlugin } from \"../plugins/controls/CameraPlugin\";\nimport { SignaturePlugin } from \"../plugins/controls/SignaturePlugin\";\nimport { GeolocationPlugin } from \"../plugins/controls/GeolocationPlugin\";\nimport { BarcodeScannerPlugin } from \"../plugins/controls/BarcodeScannerPlugin\";\nimport { VoiceInputPlugin } from \"../plugins/controls/VoiceInputPlugin\";\nimport { RichTextPlugin } from \"../plugins/controls/RichTextPlugin\";\n\n// New Phase 4 Actions & Datasources\nimport { UrlNavigationActionPlugin } from \"../plugins/actions/UrlNavigationActionPlugin\";\nimport { SubmitFormActionPlugin } from \"../plugins/actions/SubmitFormActionPlugin\";\nimport { ODataListBindingPlugin } from \"../plugins/datasources/ODataListBindingPlugin\";\nimport { RemoteDropdownPlugin } from \"../plugins/datasources/RemoteDropdownPlugin\";\n\n/**\n * Singleton orchestrator responsible for maintaining the registry of all available UI control plugins.\n * Resolves standard JSON schema types to their respective UI5 native controls.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class PluginRegistry {\n    /** The single instance of the PluginRegistry. */\n    private static instance: PluginRegistry;\n    \n    /** Internal strongly typed registry holding plugin constructors. */\n    private readonly registry: Registry<new () => IPlugin> = new Registry<new () => IPlugin>(\"Controls\");\n\n    private constructor() {\n        // Built-in Default Mappings\n        this.register(\"string\", StringPlugin);\n        this.register(\"number\", NumberPlugin);\n        this.register(\"integer\", NumberPlugin);\n        this.register(\"date\", DatePlugin);\n        this.register(\"boolean\", BooleanPlugin);\n        this.register(\"array\", ArrayPlugin);\n        this.register(\"object\", ObjectPlugin);\n\n        // Widget Overrides\n        this.register(\"string\", TimePlugin, \"time\");\n        this.register(\"string\", DateTimePlugin, \"datetime\");\n        this.register(\"boolean\", SwitchPlugin, \"switch\");\n        this.register(\"string\", DropdownPlugin, \"select\");\n        this.register(\"string\", TextAreaPlugin, \"textArea\");\n        this.register(\"string\", CodeEditorPlugin, \"codeEditor\");\n        \n        // Phase 1 Mappings\n        this.register(\"string\", FileUploaderPlugin, \"fileUploader\");\n        this.register(\"array\", MultiSelectPlugin, \"multiSelect\");\n        this.register(\"number\", SliderPlugin, \"slider\");\n        this.register(\"number\", RatingIndicatorPlugin, \"rating\");\n        this.register(\"string\", MessageStripPlugin, \"messageStrip\");\n\n        // Phase 5 Mappings (Hardware)\n        this.register(\"string\", CameraPlugin, \"camera\");\n        this.register(\"string\", SignaturePlugin, \"signature\");\n        this.register(\"object\", GeolocationPlugin, \"location\");\n        this.register(\"string\", BarcodeScannerPlugin, \"scanner\");\n        this.register(\"string\", VoiceInputPlugin, \"voiceInput\");\n        this.register(\"string\", RichTextPlugin, \"richText\");\n\n        // Phase 4 Mappings\n        this.register(\"string\", UrlNavigationActionPlugin, \"urlButton\");\n        this.register(\"string\", SubmitFormActionPlugin, \"submitButton\");\n        this.register(\"string\", ODataListBindingPlugin, \"odataSelect\");\n        this.register(\"string\", RemoteDropdownPlugin, \"remoteDropdown\");\n    }\n\n    /**\n     * Retrieves the singular instance of the PluginRegistry.\n     * @returns {PluginRegistry} The active instance.\n     */\n    public static getInstance(): PluginRegistry {\n        if (!PluginRegistry.instance) {\n            PluginRegistry.instance = new PluginRegistry();\n        }\n        return PluginRegistry.instance;\n    }\n\n    /**\n     * Registers a new control plugin to be utilized by the Layout Managers.\n     * \n     * @param type The JSON Schema primitive type (e.g., 'string', 'number').\n     * @param pluginConstructor The class constructor for the plugin implementation.\n     * @param widgetName Optional UI hint to override the default type handler (e.g., 'textArea' for a 'string').\n     */\n    public register(type: FieldType, pluginConstructor: new () => IPlugin, widgetName?: string): void {\n        const key = widgetName ? `${type}:${widgetName}` : type;\n        this.registry.register(key, pluginConstructor);\n    }\n\n    /**\n     * Resolves and instantiates the correct control plugin based on the field type and widget hint.\n     * Falls back to the primitive type handler if the specific widget is not registered.\n     * \n     * @param type The JSON Schema primitive type.\n     * @param widgetName The specific UI widget hint (if provided in schema.ui.widget).\n     * @returns {IPlugin} A new instance of the resolved plugin.\n     * @throws {Error} If no handler is registered for the specified type.\n     */\n    public getPlugin(type: FieldType, widgetName?: string): IPlugin {\n        let PluginClass;\n        \n        if (widgetName) {\n            PluginClass = this.registry.get(`${type}:${widgetName}`);\n        }\n        \n        if (!PluginClass) {\n            PluginClass = this.registry.get(type);\n        }\n\n        if (!PluginClass) {\n            const msg = `No control plugin registered for FieldType: ${type}${widgetName ? ` (widget: ${widgetName})` : ''}`;\n            Logger.error(\"[MetaUI PluginRegistry]\", msg);\n            Logger.showErrorPopup(`Plugin Registry Error.\\n\\nDetails: ${msg}`);\n            throw new Error(`[MetaUI] ${msg}`);\n        }\n        \n        try {\n            return new PluginClass();\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI PluginRegistry] Failed to instantiate plugin for ${type}`, msg);\n            Logger.showErrorPopup(`Failed to instantiate plugin for '${type}'.\\n\\nDetails: ${msg}`);\n            throw new Error(`[MetaUI Plugin Instantiation] ${msg}`);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -7,31 +7,41 @@ declare module "nz/co/siliconst/ui5/metaui/core/PluginRegistry" {
     import { IPlugin } from "nz/co/siliconst/ui5/metaui/interfaces/IPlugin";
     import { FieldType } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
     /**
-     * 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;
-        /** Internal map linking string types to their respective constructor functions. */
-        private plugins;
+        /** Internal strongly typed registry holding plugin constructors. */
+        private readonly registry;
         private constructor();
         /**
          * Retrieves the singular instance of the PluginRegistry.
-         * @returns The PluginRegistry singleton.
+         * @returns {PluginRegistry} The active instance.
          */
         static getInstance(): PluginRegistry;
         /**
-         * 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.
+         * 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').
          */
-        register(type: FieldType, pluginConstructor: new () => IPlugin): void;
+        register(type: FieldType, pluginConstructor: new () => IPlugin, widgetName?: string): void;
         /**
-         * 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.
+         * 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.
          */
-        getPlugin(type: FieldType): IPlugin;
+        getPlugin(type: FieldType, widgetName?: string): IPlugin;
     }
 }
 //# sourceMappingURL=PluginRegistry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PluginRegistry.d.ts","sourceRoot":"..\\..\\..\\..\\..\\..\\..\\..","sources":["src\\nz\\co\\siliconst\\ui5\\metaui\\core\\PluginRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,gDAAgD,CAAC;IAChE;;;;OAIG;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;IACxE,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;IAE1E;;OAEG;IACH,MAAa,cAAc;QACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;QAExC,mFAAmF;QACnF,OAAO,CAAC,OAAO,CAAgD;QAE/D,OAAO;QAIP;;;WAGG;eACW,WAAW,IAAI,cAAc;QAO3C;;;;WAIG;QACI,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,iBAAiB,EAAE,UAAU,OAAO,GAAG,IAAI;QAI5E;;;;;WAKG;QACI,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;KAO7C;CAEA"}
+{"version":3,"file":"PluginRegistry.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/PluginRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,gDAAgD,CAAC;IAChE;;;;OAIG;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;IACxE,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;IAuC1E;;;;;;OAMG;IACH,MAAa,cAAc;QACvB,iDAAiD;QACjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;QAExC,oEAAoE;QACpE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4E;QAErG,OAAO;QAwCP;;;WAGG;eACW,WAAW,IAAI,cAAc;QAO3C;;;;;;WAMG;QACI,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,iBAAiB,EAAE,UAAU,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;QAKjG;;;;;;;;WAQG;QACI,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO;KA2BlE;CAEA"}

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

@@ -1,2 +1,2 @@
-sap.ui.define([],function(){"use strict";class e{plugins=new Map;constructor(){}static getInstance(){if(!e.instance){e.instance=new e}return e.instance}register(e,t){this.plugins.set(e,t)}getPlugin(e){const t=this.plugins.get(e);if(!t){throw new Error(`[MetaUI] No plugin registered for FieldType: ${e}`)}return new t}}var t={__esModule:true};t.PluginRegistry=e;return t});
+sap.ui.define(["./Registry","../utils/Logger","../plugins/controls/StringPlugin","../plugins/controls/NumberPlugin","../plugins/controls/DatePlugin","../plugins/controls/TimePlugin","../plugins/controls/DateTimePlugin","../plugins/controls/BooleanPlugin","../plugins/controls/SwitchPlugin","../plugins/controls/ArrayPlugin","../plugins/controls/ObjectPlugin","../plugins/controls/DropdownPlugin","../plugins/controls/TextAreaPlugin","../plugins/controls/CodeEditorPlugin","../plugins/controls/FileUploaderPlugin","../plugins/controls/MultiSelectPlugin","../plugins/controls/SliderPlugin","../plugins/controls/RatingIndicatorPlugin","../plugins/controls/MessageStripPlugin","../plugins/controls/CameraPlugin","../plugins/controls/SignaturePlugin","../plugins/controls/GeolocationPlugin","../plugins/controls/BarcodeScannerPlugin","../plugins/controls/VoiceInputPlugin","../plugins/controls/RichTextPlugin","../plugins/actions/UrlNavigationActionPlugin","../plugins/actions/SubmitFormActionPlugin","../plugins/datasources/ODataListBindingPlugin","../plugins/datasources/RemoteDropdownPlugin"],function(i,t,n,r,s,e,g,o,l,u,c,a,P,p,h,d,m,S,w,y,b,D,$,R,I,f,T,A,M){"use strict";const U=i["Registry"];const B=t["Logger"];const E=n["StringPlugin"];const F=r["NumberPlugin"];const x=s["DatePlugin"];const C=e["TimePlugin"];const N=g["DateTimePlugin"];const j=o["BooleanPlugin"];const v=l["SwitchPlugin"];const L=u["ArrayPlugin"];const O=c["ObjectPlugin"];const G=a["DropdownPlugin"];const V=P["TextAreaPlugin"];const _=p["CodeEditorPlugin"];const k=h["FileUploaderPlugin"];const q=d["MultiSelectPlugin"];const z=m["SliderPlugin"];const H=S["RatingIndicatorPlugin"];const J=w["MessageStripPlugin"];const K=y["CameraPlugin"];const Q=b["SignaturePlugin"];const W=D["GeolocationPlugin"];const X=$["BarcodeScannerPlugin"];const Y=R["VoiceInputPlugin"];const Z=I["RichTextPlugin"];const ii=f["UrlNavigationActionPlugin"];const ti=T["SubmitFormActionPlugin"];const ni=A["ODataListBindingPlugin"];const ri=M["RemoteDropdownPlugin"];class si{registry=new U("Controls");constructor(){this.register("string",E);this.register("number",F);this.register("integer",F);this.register("date",x);this.register("boolean",j);this.register("array",L);this.register("object",O);this.register("string",C,"time");this.register("string",N,"datetime");this.register("boolean",v,"switch");this.register("string",G,"select");this.register("string",V,"textArea");this.register("string",_,"codeEditor");this.register("string",k,"fileUploader");this.register("array",q,"multiSelect");this.register("number",z,"slider");this.register("number",H,"rating");this.register("string",J,"messageStrip");this.register("string",K,"camera");this.register("string",Q,"signature");this.register("object",W,"location");this.register("string",X,"scanner");this.register("string",Y,"voiceInput");this.register("string",Z,"richText");this.register("string",ii,"urlButton");this.register("string",ti,"submitButton");this.register("string",ni,"odataSelect");this.register("string",ri,"remoteDropdown")}static getInstance(){if(!si.instance){si.instance=new si}return si.instance}register(i,t,n){const r=n?`${i}:${n}`:i;this.registry.register(r,t)}getPlugin(i,t){let n;if(t){n=this.registry.get(`${i}:${t}`)}if(!n){n=this.registry.get(i)}if(!n){const n=`No control plugin registered for FieldType: ${i}${t?` (widget: ${t})`:""}`;B.error("[MetaUI PluginRegistry]",n);B.showErrorPopup(`Plugin Registry Error.\n\nDetails: ${n}`);throw new Error(`[MetaUI] ${n}`)}try{return new n}catch(t){const n=t.message;B.error(`[MetaUI PluginRegistry] Failed to instantiate plugin for ${i}`,n);B.showErrorPopup(`Failed to instantiate plugin for '${i}'.\n\nDetails: ${n}`);throw new Error(`[MetaUI Plugin Instantiation] ${n}`)}}}var ei={__esModule:true};ei.PluginRegistry=si;return ei});
 //# sourceMappingURL=PluginRegistry.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"PluginRegistry.js","names":["PluginRegistry","plugins","Map","constructor","getInstance","instance","register","type","pluginConstructor","this","set","getPlugin","PluginClass","get","Error","__exports","__esModule"],"sources":["PluginRegistry.ts"],"sourcesContent":["/**\r\n * @file PluginRegistry.ts\r\n * @description Centralized hub for mapping UI5 controls to SAP schema data types.\r\n * Enforces the Registry Pattern to decouple the core engine from specific UI5 control implementations.\r\n */\r\n\r\nimport { IPlugin } from \"../interfaces/IPlugin\";\r\nimport { FieldType } from \"../interfaces/ISchema\";\r\n\r\n/**\r\n * Singleton registry that manages the lifecycle and lookup of UI5 plugin constructors.\r\n */\r\nexport class PluginRegistry {\r\n    private static instance: PluginRegistry;\r\n    \r\n    /** Internal map linking string types to their respective constructor functions. */\r\n    private plugins: Map<FieldType, new () => IPlugin> = new Map();\r\n\r\n    private constructor() {\r\n        // Enforce singleton\r\n    }\r\n\r\n    /**\r\n     * Retrieves the singular instance of the PluginRegistry.\r\n     * @returns The PluginRegistry singleton.\r\n     */\r\n    public static getInstance(): PluginRegistry {\r\n        if (!PluginRegistry.instance) {\r\n            PluginRegistry.instance = new PluginRegistry();\r\n        }\r\n        return PluginRegistry.instance;\r\n    }\r\n\r\n    /**\r\n     * Registers a new UI control plugin against a specific schema primitive type.\r\n     * @param type The primitive FieldType (e.g., 'string', 'date').\r\n     * @param pluginConstructor The class constructor for the plugin.\r\n     */\r\n    public register(type: FieldType, pluginConstructor: new () => IPlugin): void {\r\n        this.plugins.set(type, pluginConstructor);\r\n    }\r\n\r\n    /**\r\n     * Instantiates and returns a new plugin based on the requested primitive type.\r\n     * @param type The primitive FieldType to look up.\r\n     * @throws Error if no plugin has been registered for the provided type.\r\n     * @returns A newly instantiated plugin ready for rendering.\r\n     */\r\n    public getPlugin(type: FieldType): IPlugin {\r\n        const PluginClass = this.plugins.get(type);\r\n        if (!PluginClass) {\r\n            throw new Error(`[MetaUI] No plugin registered for FieldType: ${type}`);\r\n        }\r\n        return new PluginClass();\r\n    }\r\n}\r\n"],"mappings":"yCAYO,MAAMA,EAIDC,QAA6C,IAAIC,IAEjDC,cACJ,CAOJ,kBAAcC,GACV,IAAKJ,EAAeK,SAAU,CAC1BL,EAAeK,SAAW,IAAIL,CAClC,CACA,OAAOA,EAAeK,QAC1B,CAOOC,SAASC,EAAiBC,GAC7BC,KAAKR,QAAQS,IAAIH,EAAMC,EAC3B,CAQOG,UAAUJ,GACb,MAAMK,EAAcH,KAAKR,QAAQY,IAAIN,GACrC,IAAKK,EAAa,CACd,MAAM,IAAIE,MAAM,gDAAgDP,IACpE,CACA,OAAO,IAAIK,CACf,EACH,IAAAG,EAAA,CAAAC,WAAA,MAAAD,EAAAf,iBAAA,OAAAe,CAAA","ignoreList":[]}
+{"version":3,"file":"PluginRegistry.js","names":["Registry","___Registry","Logger","___utils_Logger","StringPlugin","___plugins_controls_StringPlugin","NumberPlugin","___plugins_controls_NumberPlugin","DatePlugin","___plugins_controls_DatePlugin","TimePlugin","___plugins_controls_TimePlugin","DateTimePlugin","___plugins_controls_DateTimePlugin","BooleanPlugin","___plugins_controls_BooleanPlugin","SwitchPlugin","___plugins_controls_SwitchPlugin","ArrayPlugin","___plugins_controls_ArrayPlugin","ObjectPlugin","___plugins_controls_ObjectPlugin","DropdownPlugin","___plugins_controls_DropdownPlugin","TextAreaPlugin","___plugins_controls_TextAreaPlugin","CodeEditorPlugin","___plugins_controls_CodeEditorPlugin","FileUploaderPlugin","___plugins_controls_FileUploaderPlugin","MultiSelectPlugin","___plugins_controls_MultiSelectPlugin","SliderPlugin","___plugins_controls_SliderPlugin","RatingIndicatorPlugin","___plugins_controls_RatingIndicatorPlugin","MessageStripPlugin","___plugins_controls_MessageStripPlugin","CameraPlugin","___plugins_controls_CameraPlugin","SignaturePlugin","___plugins_controls_SignaturePlugin","GeolocationPlugin","___plugins_controls_GeolocationPlugin","BarcodeScannerPlugin","___plugins_controls_BarcodeScannerPlugin","VoiceInputPlugin","___plugins_controls_VoiceInputPlugin","RichTextPlugin","___plugins_controls_RichTextPlugin","UrlNavigationActionPlugin","___plugins_actions_UrlNavigationActionPlugin","SubmitFormActionPlugin","___plugins_actions_SubmitFormActionPlugin","ODataListBindingPlugin","___plugins_datasources_ODataListBindingPlugin","RemoteDropdownPlugin","___plugins_datasources_RemoteDropdownPlugin","PluginRegistry","registry","constructor","this","register","getInstance","instance","type","pluginConstructor","widgetName","key","getPlugin","PluginClass","get","msg","error","showErrorPopup","Error","message","__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 */\n\nimport { IPlugin } from \"../interfaces/IPlugin\";\nimport { FieldType } from \"../interfaces/ISchema\";\n\nimport { Registry } from \"./Registry\";\nimport { Logger } from \"../utils/Logger\";\n\nimport { StringPlugin } from \"../plugins/controls/StringPlugin\";\nimport { NumberPlugin } from \"../plugins/controls/NumberPlugin\";\nimport { DatePlugin } from \"../plugins/controls/DatePlugin\";\nimport { TimePlugin } from \"../plugins/controls/TimePlugin\";\nimport { DateTimePlugin } from \"../plugins/controls/DateTimePlugin\";\nimport { BooleanPlugin } from \"../plugins/controls/BooleanPlugin\";\nimport { SwitchPlugin } from \"../plugins/controls/SwitchPlugin\";\nimport { ArrayPlugin } from \"../plugins/controls/ArrayPlugin\";\nimport { ObjectPlugin } from \"../plugins/controls/ObjectPlugin\";\nimport { DropdownPlugin } from \"../plugins/controls/DropdownPlugin\";\nimport { TextAreaPlugin } from \"../plugins/controls/TextAreaPlugin\";\nimport { CodeEditorPlugin } from \"../plugins/controls/CodeEditorPlugin\";\n\n// New Phase 1 Controls\nimport { FileUploaderPlugin } from \"../plugins/controls/FileUploaderPlugin\";\nimport { MultiSelectPlugin } from \"../plugins/controls/MultiSelectPlugin\";\nimport { SliderPlugin } from \"../plugins/controls/SliderPlugin\";\nimport { RatingIndicatorPlugin } from \"../plugins/controls/RatingIndicatorPlugin\";\nimport { MessageStripPlugin } from \"../plugins/controls/MessageStripPlugin\";\n\n// New Phase 5 Hardware / Base64 Plugins\nimport { CameraPlugin } from \"../plugins/controls/CameraPlugin\";\nimport { SignaturePlugin } from \"../plugins/controls/SignaturePlugin\";\nimport { GeolocationPlugin } from \"../plugins/controls/GeolocationPlugin\";\nimport { BarcodeScannerPlugin } from \"../plugins/controls/BarcodeScannerPlugin\";\nimport { VoiceInputPlugin } from \"../plugins/controls/VoiceInputPlugin\";\nimport { RichTextPlugin } from \"../plugins/controls/RichTextPlugin\";\n\n// New Phase 4 Actions & Datasources\nimport { UrlNavigationActionPlugin } from \"../plugins/actions/UrlNavigationActionPlugin\";\nimport { SubmitFormActionPlugin } from \"../plugins/actions/SubmitFormActionPlugin\";\nimport { ODataListBindingPlugin } from \"../plugins/datasources/ODataListBindingPlugin\";\nimport { RemoteDropdownPlugin } from \"../plugins/datasources/RemoteDropdownPlugin\";\n\n/**\n * Singleton orchestrator responsible for maintaining the registry of all available UI control plugins.\n * Resolves standard JSON schema types to their respective UI5 native controls.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class PluginRegistry {\n    /** The single instance of the PluginRegistry. */\n    private static instance: PluginRegistry;\n    \n    /** Internal strongly typed registry holding plugin constructors. */\n    private readonly registry: Registry<new () => IPlugin> = new Registry<new () => IPlugin>(\"Controls\");\n\n    private constructor() {\n        // Built-in Default Mappings\n        this.register(\"string\", StringPlugin);\n        this.register(\"number\", NumberPlugin);\n        this.register(\"integer\", NumberPlugin);\n        this.register(\"date\", DatePlugin);\n        this.register(\"boolean\", BooleanPlugin);\n        this.register(\"array\", ArrayPlugin);\n        this.register(\"object\", ObjectPlugin);\n\n        // Widget Overrides\n        this.register(\"string\", TimePlugin, \"time\");\n        this.register(\"string\", DateTimePlugin, \"datetime\");\n        this.register(\"boolean\", SwitchPlugin, \"switch\");\n        this.register(\"string\", DropdownPlugin, \"select\");\n        this.register(\"string\", TextAreaPlugin, \"textArea\");\n        this.register(\"string\", CodeEditorPlugin, \"codeEditor\");\n        \n        // Phase 1 Mappings\n        this.register(\"string\", FileUploaderPlugin, \"fileUploader\");\n        this.register(\"array\", MultiSelectPlugin, \"multiSelect\");\n        this.register(\"number\", SliderPlugin, \"slider\");\n        this.register(\"number\", RatingIndicatorPlugin, \"rating\");\n        this.register(\"string\", MessageStripPlugin, \"messageStrip\");\n\n        // Phase 5 Mappings (Hardware)\n        this.register(\"string\", CameraPlugin, \"camera\");\n        this.register(\"string\", SignaturePlugin, \"signature\");\n        this.register(\"object\", GeolocationPlugin, \"location\");\n        this.register(\"string\", BarcodeScannerPlugin, \"scanner\");\n        this.register(\"string\", VoiceInputPlugin, \"voiceInput\");\n        this.register(\"string\", RichTextPlugin, \"richText\");\n\n        // Phase 4 Mappings\n        this.register(\"string\", UrlNavigationActionPlugin, \"urlButton\");\n        this.register(\"string\", SubmitFormActionPlugin, \"submitButton\");\n        this.register(\"string\", ODataListBindingPlugin, \"odataSelect\");\n        this.register(\"string\", RemoteDropdownPlugin, \"remoteDropdown\");\n    }\n\n    /**\n     * Retrieves the singular instance of the PluginRegistry.\n     * @returns {PluginRegistry} The active instance.\n     */\n    public static getInstance(): PluginRegistry {\n        if (!PluginRegistry.instance) {\n            PluginRegistry.instance = new PluginRegistry();\n        }\n        return PluginRegistry.instance;\n    }\n\n    /**\n     * Registers a new control plugin to be utilized by the Layout Managers.\n     * \n     * @param type The JSON Schema primitive type (e.g., 'string', 'number').\n     * @param pluginConstructor The class constructor for the plugin implementation.\n     * @param widgetName Optional UI hint to override the default type handler (e.g., 'textArea' for a 'string').\n     */\n    public register(type: FieldType, pluginConstructor: new () => IPlugin, widgetName?: string): void {\n        const key = widgetName ? `${type}:${widgetName}` : type;\n        this.registry.register(key, pluginConstructor);\n    }\n\n    /**\n     * Resolves and instantiates the correct control plugin based on the field type and widget hint.\n     * Falls back to the primitive type handler if the specific widget is not registered.\n     * \n     * @param type The JSON Schema primitive type.\n     * @param widgetName The specific UI widget hint (if provided in schema.ui.widget).\n     * @returns {IPlugin} A new instance of the resolved plugin.\n     * @throws {Error} If no handler is registered for the specified type.\n     */\n    public getPlugin(type: FieldType, widgetName?: string): IPlugin {\n        let PluginClass;\n        \n        if (widgetName) {\n            PluginClass = this.registry.get(`${type}:${widgetName}`);\n        }\n        \n        if (!PluginClass) {\n            PluginClass = this.registry.get(type);\n        }\n\n        if (!PluginClass) {\n            const msg = `No control plugin registered for FieldType: ${type}${widgetName ? ` (widget: ${widgetName})` : ''}`;\n            Logger.error(\"[MetaUI PluginRegistry]\", msg);\n            Logger.showErrorPopup(`Plugin Registry Error.\\n\\nDetails: ${msg}`);\n            throw new Error(`[MetaUI] ${msg}`);\n        }\n        \n        try {\n            return new PluginClass();\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI PluginRegistry] Failed to instantiate plugin for ${type}`, msg);\n            Logger.showErrorPopup(`Failed to instantiate plugin for '${type}'.\\n\\nDetails: ${msg}`);\n            throw new Error(`[MetaUI Plugin Instantiation] ${msg}`);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}