@siliconst/metaui 1.0.2 → 1.4.4

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

@@ -1,56 +1,205 @@
-/**
- * @file Engine.ts
- * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry.
- */
-
-import { ISchema } from "../interfaces/ISchema";
-import { ILayoutManager } from "../interfaces/ILayoutManager";
-import { ConditionEngine } from "./ConditionEngine";
-import Control from "sap/ui/core/Control";
-import VBox from "sap/m/VBox";
-
-/**
- * The MetaUI Engine. Responsible for bootstrapping the layout generation.
- * Follows strict Orchestrator patterns; delegates all actual rendering to LayoutManagers.
- */
-export class Engine {
-    private conditionEngine: ConditionEngine | null = null;
-    
-    /**
-     * Evaluates the schema and delegates generation to the layout factory.
-     * @param schema The fully normalized schema definition.
-     * @param layoutManager The injected layout factory class.
-     * @returns The populated UI5 layout container.
-     */
-    public build(schema: ISchema, layoutManager: ILayoutManager): Control {
-        // Bootstrap the condition engine to start listening for field events in this schema
-        this.conditionEngine = new ConditionEngine(schema);
-        
-        if (schema.mode === "form") {
-            return layoutManager.renderForm(schema);
-        } else if (schema.mode === "table") {
-            if (!schema.tables || schema.tables.length === 0) {
-                throw new Error("[MetaUI] Table mode requires at least one table definition.");
-            }
-            return layoutManager.renderTable(schema.tables[0]);
-        } else if (schema.mode === "mixed") {
-            const container = new VBox({ renderType: "Bare" });
-            
-            // 1. Render the top-level form if there are root fields
-            if (schema.rootFields && schema.rootFields.length > 0) {
-                container.addItem(layoutManager.renderForm(schema));
-            }
-            
-            // 2. Render all tables sequentially below the form
-            if (schema.tables && schema.tables.length > 0) {
-                schema.tables.forEach(tableMeta => {
-                    container.addItem(layoutManager.renderTable(tableMeta));
-                });
-            }
-            
-            return container;
-        }
-        
-        throw new Error(`[MetaUI] Mode '${schema.mode}' is not yet implemented or invalid.`);
-    }
-}
+/**
+ * @file Engine.ts
+ * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).
+ */
+
+import { ISchema, IPropertyMetadata } from "../interfaces/ISchema";
+import { ILayoutManager } from "../interfaces/ILayoutManager";
+import { IPlugin, IPluginValidationResult } from "../interfaces/IPlugin";
+import { ConditionEngine } from "./ConditionEngine";
+import { PluginRegistry } from "./PluginRegistry";
+import Control from "sap/ui/core/Control";
+import VBox from "sap/m/VBox";
+import Text from "sap/m/Text";
+import { Registry } from "./Registry";
+import { Logger } from "../utils/Logger";
+import { DefaultLayoutGenerator } from "./DefaultLayoutGenerator";
+import Core from "sap/ui/core/Core";
+import Messaging from "sap/ui/core/Messaging";
+
+/**
+ * The Engine is responsible for translating a normalized schema into a physical UI5 layout.
+ * It delegates layout generation to the configured `LayoutManager` and field generation to the `PluginRegistry`.
+ * It is NOT a God Class; it strictly routes execution flow and tracks active plugins for validation.
+ * It embodies the "Plugin-First Philosophy" by routing all complex field and layout rendering
+ * through discrete, decoupled plugins rather than handling native overrides.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.core
+ * @public
+ */
+export class Engine {
+    /** Global registry of all available layout strategies (e.g. Form, Table, Wizard). */
+    public static layoutRegistry: Registry<ILayoutManager>;
+    /** Handles dynamic conditional logic across the active form. */
+    private conditionEngine: ConditionEngine | null = null;
+    
+    /** Array of all instantiated plugins generated during the current build. */
+    private activePlugins: { plugin: IPlugin, path: string }[] = [];
+
+    /** Deterministic scope ID injected by the host control to prevent clone collisions. */
+    public engineScopeId?: string;
+    
+    private activeModel?: sap.ui.model.Model;
+    
+    /** Tracks whether the entire engine is running in Read-Only Display mode. */
+    public readonly isDisplayMode: boolean = false;
+
+    constructor(displayMode: boolean = false) {
+        this.isDisplayMode = displayMode;
+    }
+    
+    /**
+     * Bootstraps the layout generation process by resolving the correct layout strategy.
+     * 
+     * @param schema The normalized JSON schema representing the view.
+     * @param model The active StateManager JSONModel instance.
+     * @param modelName The UI5 model alias used for isolation.
+     * @param onSubmit Callback fired when form is submitted.
+     * @param engineScopeId Deterministic scope ID for this engine instance.
+     * @param onChange Callback fired when field values change.
+     * @returns The generated root UI5 Control container.
+     */
+    public build(schema: ISchema, model: sap.ui.model.Model, modelName: string = "meta", onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control {
+        this.conditionEngine = new ConditionEngine(schema);
+        this.activePlugins = [];
+        this.activeModel = model;
+        this.engineScopeId = engineScopeId;
+        this.onChange = (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => {
+            if (this.conditionEngine && fieldKey) {
+                this.conditionEngine.handleEvent(fieldKey, isValid);
+            }
+            if (onChange) {
+                onChange(isValid, fieldKey, errorMessage, controlId);
+            }
+        };
+        
+        try {
+            // Intercept and synthesize a default layout if the developer/backend failed to provide one
+            if (DefaultLayoutGenerator.ensureLayout(schema)) {
+                Logger.warn("[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.");
+            }
+
+            const layoutStrategy = schema.layoutStrategy || (schema.type === "array" ? "table" : "form");
+            const layoutManager = Engine.layoutRegistry.getStrict(layoutStrategy);
+            
+            return layoutManager.render(schema, modelName, this, onSubmit);
+        } catch (error) {
+            const msg = (error as Error).message;
+            Logger.error("[MetaUI Engine] Critical error during layout generation", msg);
+            Logger.showErrorPopup(`Engine failed to generate the layout.\n\nDetails: ${msg}`);
+            return new Text({ text: "Critical Layout Error" });
+        }
+    }
+
+    /**
+     * Instantiates the correct plugin for a specific field based on type and widget hints,
+     * and tracks the plugin for global validation.
+     * 
+     * @param fieldMeta The metadata schema specific to the field.
+     * @param bindingPath The JSON path representing the field within the payload.
+     * @param modelName The UI5 JSONModel name used for data binding.
+     * @returns The generated UI5 Control for the field.
+     */
+    public generateField(fieldMeta: IPropertyMetadata, bindingPath: string, modelName: string, isTemplate: boolean = false): Control {
+        try {
+            const plugin = PluginRegistry.getInstance().getPlugin(fieldMeta.type || "string", fieldMeta.ui?.widget);
+            plugin.setDisplayMode(this.isDisplayMode);
+            
+            if (!isTemplate) {
+                this.activePlugins.push({ plugin, path: bindingPath });
+            }
+            const scopeId = isTemplate ? undefined : this.engineScopeId;
+            const control = plugin.render(fieldMeta, bindingPath, modelName, scopeId, this.onChange);
+            
+            if (this.conditionEngine) {
+                this.conditionEngine.registerPlugin(bindingPath, plugin);
+            }
+            
+            return control;
+        } catch (error) {
+            const msg = (error as Error).message;
+            Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);
+            Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\n\nDetails: ${msg}`);
+            return new Text({ text: `[Error generating field ${bindingPath}]` });
+        }
+    }
+
+    /**
+     * Generates a sub-layout (like an embedded table or nested form) without 
+     * destroying the current Engine state or Condition tracking.
+     * 
+     * @param schema The normalized JSON schema representing the view.
+     * @param modelName The UI5 JSONModel name used for data binding (defaults to "meta").
+     * @param bindingPath Optional path to bind the sub-layout to a specific array/object property.
+     * @returns The generated root UI5 Control container.
+     */
+    public generateLayout(schema: ISchema, modelName: string, bindingPath?: string): Control {
+        try {
+            const layoutStrategy = schema.layoutStrategy || (schema.type === "array" ? "table" : "form");
+            const layoutManager = Engine.layoutRegistry.getStrict(layoutStrategy);
+            return layoutManager.render(schema, modelName, this, undefined, bindingPath);
+        } catch (error) {
+            const msg = (error as Error).message;
+            Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);
+            Logger.showErrorPopup(`Engine failed to generate a sub-layout.\n\nDetails: ${msg}`);
+            return new Text({ text: "Critical Sub-Layout Error" });
+        }
+    }
+
+    /**
+     * Iterates through all active plugins and triggers their internal validation pipelines.
+     * 
+     * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.
+     */
+    public validateAll(): IPluginValidationResult[] {
+        const errors: IPluginValidationResult[] = [];
+        for (const item of this.activePlugins) {
+            const result = item.plugin.validate();
+            if (!result.isValid) {
+                // Ensure the path is bound to the error so GeneratorHost knows where to target it
+                result.fieldKey = result.fieldKey || item.path.replace(/^\//, "");
+                errors.push(result);
+                // Add console log to find which plugin fails silently
+                Logger.error("[MetaUI Validation] Plugin failed validation silently:", item.path || item.plugin.constructor.name);
+            }
+        }
+        return errors;
+    }
+
+    /**
+     * Cleans up internal state and destroys the condition engine to prevent memory leaks.
+     */
+    public destroy(): void {
+        if (this.conditionEngine) {
+            this.conditionEngine.destroy();
+            this.conditionEngine = null;
+        }
+        
+        // ------------------------------------------------------------------------
+        // Ghost Error Prevention
+        // Flush MessageManager for active plugins before destroying their controls
+        // ------------------------------------------------------------------------
+        const messageManager = Messaging;
+        const existingMessages = messageManager.getMessageModel().getData();
+        const messagesToRemove: any[] = [];
+        
+        for (const item of this.activePlugins) {
+            if (this.activeModel) {
+                const targetPath = `/${item.path.replace(/^\//, "")}`;
+                const matched = existingMessages.filter((msg: any) => 
+                    msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.activeModel.getId()
+                );
+                messagesToRemove.push(...matched);
+            }
+            if (typeof item.plugin.destroy === "function") {
+                item.plugin.destroy();
+            }
+        }
+        
+        if (messagesToRemove.length > 0) {
+            messageManager.removeMessages(messagesToRemove);
+        }
+        
+        this.activePlugins = [];
+    }
+}

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

@@ -0,0 +1,32 @@
+sap.ui.define(["./Registry", "../layouts/FormLayout", "../layouts/TableLayout", "../layouts/WizardLayout", "../layouts/CompactLayout", "./Engine"], function (___Registry, ___layouts_FormLayout, ___layouts_TableLayout, ___layouts_WizardLayout, ___layouts_CompactLayout, ___Engine) {
+  "use strict";
+
+  /**
+   * @file LayoutRegistry.ts
+   * @description Centralized registry for all available layout managers (e.g. Form, Table, Wizard).
+   */
+  const Registry = ___Registry["Registry"];
+  const FormLayout = ___layouts_FormLayout["FormLayout"];
+  const TableLayout = ___layouts_TableLayout["TableLayout"];
+  const WizardLayout = ___layouts_WizardLayout["WizardLayout"];
+  const CompactLayout = ___layouts_CompactLayout["CompactLayout"];
+  const Engine = ___Engine["Engine"];
+  /** 
+   * The globally exposed registry containing instantiations of the layout strategies.
+   * It is injected directly into the Engine to avoid circular dependencies.
+   * 
+   * @public
+   */
+  const LayoutRegistry = new Registry("Layouts");
+  LayoutRegistry.register("form", new FormLayout());
+  LayoutRegistry.register("table", new TableLayout());
+  LayoutRegistry.register("wizard", new WizardLayout());
+  LayoutRegistry.register("compact", new CompactLayout());
+  Engine.layoutRegistry = LayoutRegistry;
+  var __exports = {
+    __esModule: true
+  };
+  __exports.LayoutRegistry = LayoutRegistry;
+  return __exports;
+});
+//# sourceMappingURL=LayoutRegistry-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutRegistry-dbg.js","names":["Registry","___Registry","FormLayout","___layouts_FormLayout","TableLayout","___layouts_TableLayout","WizardLayout","___layouts_WizardLayout","CompactLayout","___layouts_CompactLayout","Engine","___Engine","LayoutRegistry","register","layoutRegistry","__exports","__esModule"],"sources":["LayoutRegistry.ts"],"sourcesContent":["/**\n * @file LayoutRegistry.ts\n * @description Centralized registry for all available layout managers (e.g. Form, Table, Wizard).\n */\nimport { Registry } from \"./Registry\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { FormLayout } from \"../layouts/FormLayout\";\nimport { TableLayout } from \"../layouts/TableLayout\";\nimport { WizardLayout } from \"../layouts/WizardLayout\";\nimport { CompactLayout } from \"../layouts/CompactLayout\";\nimport { Engine } from \"./Engine\";\n\n/** \n * The globally exposed registry containing instantiations of the layout strategies.\n * It is injected directly into the Engine to avoid circular dependencies.\n * \n * @public\n */\nexport const LayoutRegistry = new Registry<ILayoutManager>(\"Layouts\");\n\nLayoutRegistry.register(\"form\", new FormLayout());\nLayoutRegistry.register(\"table\", new TableLayout());\nLayoutRegistry.register(\"wizard\", new WizardLayout());\nLayoutRegistry.register(\"compact\", new CompactLayout());\n\nEngine.layoutRegistry = LayoutRegistry;\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAISA,QAAQ,GAAAC,WAAA;EAAA,MAERC,UAAU,GAAAC,qBAAA;EAAA,MACVC,WAAW,GAAAC,sBAAA;EAAA,MACXC,YAAY,GAAAC,uBAAA;EAAA,MACZC,aAAa,GAAAC,wBAAA;EAAA,MACbC,MAAM,GAAAC,SAAA;EAEf;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,cAAc,GAAG,IAAIZ,QAAQ,CAAiB,SAAS,CAAC;EAErEY,cAAc,CAACC,QAAQ,CAAC,MAAM,EAAE,IAAIX,UAAU,CAAC,CAAC,CAAC;EACjDU,cAAc,CAACC,QAAQ,CAAC,OAAO,EAAE,IAAIT,WAAW,CAAC,CAAC,CAAC;EACnDQ,cAAc,CAACC,QAAQ,CAAC,QAAQ,EAAE,IAAIP,YAAY,CAAC,CAAC,CAAC;EACrDM,cAAc,CAACC,QAAQ,CAAC,SAAS,EAAE,IAAIL,aAAa,CAAC,CAAC,CAAC;EAEvDE,MAAM,CAACI,cAAc,GAAGF,cAAc;EAAC,IAAAG,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAH,cAAA,GAAAA,cAAA;EAAA,OAAAG,SAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,16 @@
+declare module "nz/co/siliconst/ui5/metaui/core/LayoutRegistry" {
+    /**
+     * @file LayoutRegistry.ts
+     * @description Centralized registry for all available layout managers (e.g. Form, Table, Wizard).
+     */
+    import { Registry } from "nz/co/siliconst/ui5/metaui/core/Registry";
+    import { ILayoutManager } from "nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager";
+    /**
+     * The globally exposed registry containing instantiations of the layout strategies.
+     * It is injected directly into the Engine to avoid circular dependencies.
+     *
+     * @public
+     */
+    export const LayoutRegistry: Registry<ILayoutManager>;
+}
+//# sourceMappingURL=LayoutRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutRegistry.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/LayoutRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,gDAAgD,CAAC;IAChE;;;OAGG;IACH,OAAO,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;IACpE,OAAO,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;IAOtF;;;;;OAKG;IACI,MAAM,cAAc,0BAA0C,CAAC;CASrE"}

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

@@ -0,0 +1,2 @@
+sap.ui.define(["./Registry","../layouts/FormLayout","../layouts/TableLayout","../layouts/WizardLayout","../layouts/CompactLayout","./Engine"],function(t,o,e,a,s,r){"use strict";const u=t["Registry"];const n=o["FormLayout"];const y=e["TableLayout"];const i=a["WizardLayout"];const c=s["CompactLayout"];const g=r["Engine"];const L=new u("Layouts");L.register("form",new n);L.register("table",new y);L.register("wizard",new i);L.register("compact",new c);g.layoutRegistry=L;var l={__esModule:true};l.LayoutRegistry=L;return l});
+//# sourceMappingURL=LayoutRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutRegistry.js","names":["Registry","___Registry","FormLayout","___layouts_FormLayout","TableLayout","___layouts_TableLayout","WizardLayout","___layouts_WizardLayout","CompactLayout","___layouts_CompactLayout","Engine","___Engine","LayoutRegistry","register","layoutRegistry","__exports","__esModule"],"sources":["LayoutRegistry.ts"],"sourcesContent":["/**\n * @file LayoutRegistry.ts\n * @description Centralized registry for all available layout managers (e.g. Form, Table, Wizard).\n */\nimport { Registry } from \"./Registry\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { FormLayout } from \"../layouts/FormLayout\";\nimport { TableLayout } from \"../layouts/TableLayout\";\nimport { WizardLayout } from \"../layouts/WizardLayout\";\nimport { CompactLayout } from \"../layouts/CompactLayout\";\nimport { Engine } from \"./Engine\";\n\n/** \n * The globally exposed registry containing instantiations of the layout strategies.\n * It is injected directly into the Engine to avoid circular dependencies.\n * \n * @public\n */\nexport const LayoutRegistry = new Registry<ILayoutManager>(\"Layouts\");\n\nLayoutRegistry.register(\"form\", new FormLayout());\nLayoutRegistry.register(\"table\", new TableLayout());\nLayoutRegistry.register(\"wizard\", new WizardLayout());\nLayoutRegistry.register(\"compact\", new CompactLayout());\n\nEngine.layoutRegistry = LayoutRegistry;\n"],"mappings":"iLAAA,MAISA,EAAQC,EAAA,kBAERC,EAAUC,EAAA,oBACVC,EAAWC,EAAA,qBACXC,EAAYC,EAAA,sBACZC,EAAaC,EAAA,uBACbC,EAAMC,EAAA,UAQR,MAAMC,EAAiB,IAAIZ,EAAyB,WAE3DY,EAAeC,SAAS,OAAQ,IAAIX,GACpCU,EAAeC,SAAS,QAAS,IAAIT,GACrCQ,EAAeC,SAAS,SAAU,IAAIP,GACtCM,EAAeC,SAAS,UAAW,IAAIL,GAEvCE,EAAOI,eAAiBF,EAAe,IAAAG,EAAA,CAAAC,WAAA,MAAAD,EAAAH,iBAAA,OAAAG,CAAA","ignoreList":[]}

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

@@ -0,0 +1,26 @@
+/**
+ * @file LayoutRegistry.ts
+ * @description Centralized registry for all available layout managers (e.g. Form, Table, Wizard).
+ */
+import { Registry } from "./Registry";
+import { ILayoutManager } from "../interfaces/ILayoutManager";
+import { FormLayout } from "../layouts/FormLayout";
+import { TableLayout } from "../layouts/TableLayout";
+import { WizardLayout } from "../layouts/WizardLayout";
+import { CompactLayout } from "../layouts/CompactLayout";
+import { Engine } from "./Engine";
+
+/** 
+ * The globally exposed registry containing instantiations of the layout strategies.
+ * It is injected directly into the Engine to avoid circular dependencies.
+ * 
+ * @public
+ */
+export const LayoutRegistry = new Registry<ILayoutManager>("Layouts");
+
+LayoutRegistry.register("form", new FormLayout());
+LayoutRegistry.register("table", new TableLayout());
+LayoutRegistry.register("wizard", new WizardLayout());
+LayoutRegistry.register("compact", new CompactLayout());
+
+Engine.layoutRegistry = LayoutRegistry;

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

@@ -0,0 +1,123 @@
+sap.ui.define(["./Registry", "../plugins/validators/PatternValidatorPlugin", "../plugins/validators/MinLengthValidatorPlugin", "../plugins/validators/RangeValidatorPlugin", "../plugins/validators/UrlValidatorPlugin", "../plugins/validators/IbanValidatorPlugin", "../plugins/validators/EmailValidatorPlugin", "../plugins/formatters/DateFormatterPlugin", "../plugins/formatters/PhoneFormatterPlugin", "../plugins/formatters/TextCaseFormatterPlugin", "../utils/Logger"], function (___Registry, ___plugins_validators_PatternValidatorPlugin, ___plugins_validators_MinLengthValidatorPlugin, ___plugins_validators_RangeValidatorPlugin, ___plugins_validators_UrlValidatorPlugin, ___plugins_validators_IbanValidatorPlugin, ___plugins_validators_EmailValidatorPlugin, ___plugins_formatters_DateFormatterPlugin, ___plugins_formatters_PhoneFormatterPlugin, ___plugins_formatters_TextCaseFormatterPlugin, ___utils_Logger) {
+  "use strict";
+
+  /**
+   * @file PipelineManager.ts
+   * @description Central manager for the data manipulation pipeline. 
+   * Orchestrates Formatting, Parsing, and Validating data using the generic Registry.
+   */
+  const Registry = ___Registry["Registry"];
+  const PatternValidatorPlugin = ___plugins_validators_PatternValidatorPlugin["PatternValidatorPlugin"];
+  const MinLengthValidatorPlugin = ___plugins_validators_MinLengthValidatorPlugin["MinLengthValidatorPlugin"];
+  const RangeValidatorPlugin = ___plugins_validators_RangeValidatorPlugin["RangeValidatorPlugin"];
+  const UrlValidatorPlugin = ___plugins_validators_UrlValidatorPlugin["UrlValidatorPlugin"];
+  const IbanValidatorPlugin = ___plugins_validators_IbanValidatorPlugin["IbanValidatorPlugin"];
+  const EmailValidatorPlugin = ___plugins_validators_EmailValidatorPlugin["EmailValidatorPlugin"];
+  const DateFormatterPlugin = ___plugins_formatters_DateFormatterPlugin["DateFormatterPlugin"];
+  const PhoneFormatterPlugin = ___plugins_formatters_PhoneFormatterPlugin["PhoneFormatterPlugin"];
+  const TextCaseFormatterPlugin = ___plugins_formatters_TextCaseFormatterPlugin["TextCaseFormatterPlugin"];
+  const Logger = ___utils_Logger["Logger"]; // --- Built-in Default Validators ---
+  class RequiredValidator {
+    validate(parsedValue, args) {
+      if (parsedValue === null || parsedValue === undefined || parsedValue === "") {
+        return {
+          isValid: false,
+          errorMessage: "This field is required."
+        };
+      }
+      return {
+        isValid: true
+      };
+    }
+  }
+  class MaxLengthValidator {
+    validate(parsedValue, args) {
+      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
+   */
+  class PipelineManager {
+    /** Registry of data formatters applied before pushing to the UI. */
+    formatters = new Registry("Formatters");
+    /** Registry of data parsers applied when pulling data from the UI. */
+    parsers = new Registry("Parsers");
+    /** Registry of business logic validators. */
+    validators = new Registry("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.
+     */
+    executeValidation(parsedValue, requestedValidators, argsMap) {
+      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 
+   */
+  const GlobalPipeline = new PipelineManager();
+  var __exports = {
+    __esModule: true
+  };
+  __exports.PipelineManager = PipelineManager;
+  __exports.GlobalPipeline = GlobalPipeline;
+  return __exports;
+});
+//# sourceMappingURL=PipelineManager-dbg.js.map

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

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

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

@@ -0,0 +1,49 @@
+declare module "nz/co/siliconst/ui5/metaui/core/PipelineManager" {
+    /**
+     * @file PipelineManager.ts
+     * @description Central manager for the data manipulation pipeline.
+     * Orchestrates Formatting, Parsing, and Validating data using the generic Registry.
+     */
+    import { Registry } from "nz/co/siliconst/ui5/metaui/core/Registry";
+    import { IFormatter, IParser, IValidator, IValidationResult } from "nz/co/siliconst/ui5/metaui/interfaces/IPipeline";
+    class RequiredValidator implements IValidator {
+        validate(parsedValue: unknown, args?: unknown): IValidationResult;
+    }
+    class MaxLengthValidator implements IValidator {
+        validate(parsedValue: unknown, args?: unknown): IValidationResult;
+    }
+    /**
+     * 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. */
+        readonly formatters: Registry<IFormatter>;
+        /** Registry of data parsers applied when pulling data from the UI. */
+        readonly parsers: Registry<IParser>;
+        /** Registry of business logic validators. */
+        readonly validators: Registry<IValidator>;
+        /**
+         * Bootstraps the PipelineManager with default validators (required, maxLength, email).
+         */
+        constructor();
+        /**
+         * 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.
+         */
+        executeValidation(parsedValue: unknown, requestedValidators: string[], argsMap?: Record<string, any>): IValidationResult;
+    }
+    /**
+     * Singleton instance for global access to the active validation pipeline.
+     * @public
+     */
+    export const GlobalPipeline: PipelineManager;
+}
+//# sourceMappingURL=PipelineManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineManager.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/PipelineManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iDAAiD,CAAC;IACjE;;;;OAIG;IAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;IACpE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;IAarH,MAAM,iBAAkB,YAAW,UAAU;QACzC,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,iBAAiB;KAMpE;IAED,MAAM,kBAAmB,YAAW,UAAU;QAC1C,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,iBAAiB;KAQpE;IAGD;;;;;;OAMG;IACH,MAAa,eAAe;QACxB,oEAAoE;QACpE,SAAgB,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAA0C;QAC1F,sEAAsE;QACtE,SAAgB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAoC;QAC9E,6CAA6C;QAC7C,SAAgB,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAA0C;QAE1F;;WAEG;;QAkBH;;;;;;;WAOG;QACI,iBAAiB,CAAC,WAAW,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,iBAAiB;KAelI;IAED;;;OAGG;IACI,MAAM,cAAc,iBAAwB,CAAC;CAEnD"}

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

@@ -0,0 +1,2 @@
+sap.ui.define(["./Registry","../plugins/validators/PatternValidatorPlugin","../plugins/validators/MinLengthValidatorPlugin","../plugins/validators/RangeValidatorPlugin","../plugins/validators/UrlValidatorPlugin","../plugins/validators/IbanValidatorPlugin","../plugins/validators/EmailValidatorPlugin","../plugins/formatters/DateFormatterPlugin","../plugins/formatters/PhoneFormatterPlugin","../plugins/formatters/TextCaseFormatterPlugin","../utils/Logger"],function(t,e,r,i,a,s,n,l,o,g,u){"use strict";const d=t["Registry"];const c=e["PatternValidatorPlugin"];const P=r["MinLengthValidatorPlugin"];const f=i["RangeValidatorPlugin"];const h=a["UrlValidatorPlugin"];const m=s["IbanValidatorPlugin"];const v=n["EmailValidatorPlugin"];const V=l["DateFormatterPlugin"];const p=o["PhoneFormatterPlugin"];const w=g["TextCaseFormatterPlugin"];const M=u["Logger"];class F{validate(t,e){if(t===null||t===undefined||t===""){return{isValid:false,errorMessage:"This field is required."}}return{isValid:true}}}class x{validate(t,e){if(typeof t==="string"&&e&&typeof e==="number"){if(t.length>e){return{isValid:false,errorMessage:`Maximum length is ${e} characters.`}}}return{isValid:true}}}class L{formatters=new d("Formatters");parsers=new d("Parsers");validators=new d("Validators");constructor(){this.validators.register("required",new F);this.validators.register("maxLength",new x);this.validators.register("pattern",new c);this.validators.register("minLength",new P);this.validators.register("range",new f);this.validators.register("url",new h);this.validators.register("iban",new m);this.validators.register("email",new v);this.formatters.register("date",new V);this.formatters.register("phone",new p);this.formatters.register("textCase",new w)}executeValidation(t,e,r){for(const i of e){const e=this.validators.get(i);if(e){const a=r?r[i]:undefined;const s=e.validate(t,a);if(!s.isValid){return s}}else{M.warn(`[MetaUI] PipelineManager: Requested validator '${i}' not found in registry.`)}}return{isValid:true}}}const b=new L;var y={__esModule:true};y.PipelineManager=L;y.GlobalPipeline=b;return y});
+//# sourceMappingURL=PipelineManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineManager.js","names":["Registry","___Registry","PatternValidatorPlugin","___plugins_validators_PatternValidatorPlugin","MinLengthValidatorPlugin","___plugins_validators_MinLengthValidatorPlugin","RangeValidatorPlugin","___plugins_validators_RangeValidatorPlugin","UrlValidatorPlugin","___plugins_validators_UrlValidatorPlugin","IbanValidatorPlugin","___plugins_validators_IbanValidatorPlugin","EmailValidatorPlugin","___plugins_validators_EmailValidatorPlugin","DateFormatterPlugin","___plugins_formatters_DateFormatterPlugin","PhoneFormatterPlugin","___plugins_formatters_PhoneFormatterPlugin","TextCaseFormatterPlugin","___plugins_formatters_TextCaseFormatterPlugin","Logger","___utils_Logger","RequiredValidator","validate","parsedValue","args","undefined","isValid","errorMessage","MaxLengthValidator","length","PipelineManager","formatters","parsers","validators","constructor","this","register","executeValidation","requestedValidators","argsMap","rule","validator","get","result","warn","GlobalPipeline","__exports","__esModule"],"sources":["PipelineManager.ts"],"sourcesContent":["/**\n * @file PipelineManager.ts\n * @description Central manager for the data manipulation pipeline. \n * Orchestrates Formatting, Parsing, and Validating data using the generic Registry.\n */\n\nimport { Registry } from \"./Registry\";\nimport { IFormatter, IParser, IValidator, IValidationResult } from \"../interfaces/IPipeline\";\nimport { PatternValidatorPlugin } from \"../plugins/validators/PatternValidatorPlugin\";\nimport { MinLengthValidatorPlugin } from \"../plugins/validators/MinLengthValidatorPlugin\";\nimport { RangeValidatorPlugin } from \"../plugins/validators/RangeValidatorPlugin\";\nimport { UrlValidatorPlugin } from \"../plugins/validators/UrlValidatorPlugin\";\nimport { IbanValidatorPlugin } from \"../plugins/validators/IbanValidatorPlugin\";\nimport { EmailValidatorPlugin } from \"../plugins/validators/EmailValidatorPlugin\";\nimport { DateFormatterPlugin } from \"../plugins/formatters/DateFormatterPlugin\";\nimport { PhoneFormatterPlugin } from \"../plugins/formatters/PhoneFormatterPlugin\";\nimport { TextCaseFormatterPlugin } from \"../plugins/formatters/TextCaseFormatterPlugin\";\nimport { Logger } from \"../utils/Logger\";\n\n// --- Built-in Default Validators ---\nclass RequiredValidator implements IValidator {\n    validate(parsedValue: unknown, args?: unknown): IValidationResult {\n        if (parsedValue === null || parsedValue === undefined || parsedValue === \"\") {\n            return { isValid: false, errorMessage: \"This field is required.\" };\n        }\n        return { isValid: true };\n    }\n}\n\nclass MaxLengthValidator implements IValidator {\n    validate(parsedValue: unknown, args?: unknown): IValidationResult {\n        if (typeof parsedValue === \"string\" && args && typeof args === \"number\") {\n            if (parsedValue.length > args) {\n                return { isValid: false, errorMessage: `Maximum length is ${args} characters.` };\n            }\n        }\n        return { isValid: true };\n    }\n}\n\n\n/**\n * The core engine responsible for marshalling data through the validation, formatting, and parsing phases.\n * Pluggable design allows new validators to be registered dynamically.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class PipelineManager {\n    /** Registry of data formatters applied before pushing to the UI. */\n    public readonly formatters: Registry<IFormatter> = new Registry<IFormatter>(\"Formatters\");\n    /** Registry of data parsers applied when pulling data from the UI. */\n    public readonly parsers: Registry<IParser> = new Registry<IParser>(\"Parsers\");\n    /** Registry of business logic validators. */\n    public readonly validators: Registry<IValidator> = new Registry<IValidator>(\"Validators\");\n\n    /**\n     * Bootstraps the PipelineManager with default validators (required, maxLength, email).\n     */\n    constructor() {\n        // Register default validators\n        this.validators.register(\"required\", new RequiredValidator());\n        this.validators.register(\"maxLength\", new MaxLengthValidator());\n        this.validators.register(\"pattern\", new PatternValidatorPlugin());\n        this.validators.register(\"minLength\", new MinLengthValidatorPlugin());\n        this.validators.register(\"range\", new RangeValidatorPlugin());\n        this.validators.register(\"url\", new UrlValidatorPlugin());\n        this.validators.register(\"iban\", new IbanValidatorPlugin());\n        this.validators.register(\"email\", new EmailValidatorPlugin());\n\n        // Register default formatters\n        this.formatters.register(\"date\", new DateFormatterPlugin());\n        this.formatters.register(\"phone\", new PhoneFormatterPlugin());\n        this.formatters.register(\"textCase\", new TextCaseFormatterPlugin());\n    }\n\n    /**\n     * Executes the validation pipeline sequentially. Fails fast on the first encountered error.\n     * \n     * @param parsedValue The raw extracted value from the UI control.\n     * @param requestedValidators Array of validation rule keys (e.g. ['required', 'email']).\n     * @param argsMap Optional map of parameters required by specific rules (e.g. { maxLength: 50 }).\n     * @returns {IValidationResult} The final result state and any associated error message.\n     */\n    public executeValidation(parsedValue: unknown, requestedValidators: string[], argsMap?: Record<string, any>): IValidationResult {\n        for (const rule of requestedValidators) {\n            const validator = this.validators.get(rule);\n            if (validator) {\n                const args = argsMap ? argsMap[rule] : undefined;\n                const result = validator.validate(parsedValue, args);\n                if (!result.isValid) {\n                    return result; // Fast fail on first error\n                }\n            } else {\n                Logger.warn(`[MetaUI] PipelineManager: Requested validator '${rule}' not found in registry.`);\n            }\n        }\n        return { isValid: true };\n    }\n}\n\n/** \n * Singleton instance for global access to the active validation pipeline. \n * @public \n */\nexport const GlobalPipeline = new PipelineManager();\n"],"mappings":"sfAAA,MAMSA,EAAQC,EAAA,kBAERC,EAAsBC,EAAA,gCACtBC,EAAwBC,EAAA,kCACxBC,EAAoBC,EAAA,8BACpBC,EAAkBC,EAAA,4BAClBC,EAAmBC,EAAA,6BACnBC,EAAoBC,EAAA,8BACpBC,EAAmBC,EAAA,6BACnBC,EAAoBC,EAAA,8BACpBC,EAAuBC,EAAA,iCACvBC,EAAMC,EAAA,UAGf,MAAMC,EACFC,SAASC,EAAsBC,GAC3B,GAAID,IAAgB,MAAQA,IAAgBE,WAAaF,IAAgB,GAAI,CACzE,MAAO,CAAEG,QAAS,MAAOC,aAAc,0BAC3C,CACA,MAAO,CAAED,QAAS,KACtB,EAGJ,MAAME,EACFN,SAASC,EAAsBC,GAC3B,UAAWD,IAAgB,UAAYC,UAAeA,IAAS,SAAU,CACrE,GAAID,EAAYM,OAASL,EAAM,CAC3B,MAAO,CAAEE,QAAS,MAAOC,aAAc,qBAAqBH,gBAChE,CACJ,CACA,MAAO,CAAEE,QAAS,KACtB,EAWG,MAAMI,EAEOC,WAAmC,IAAIhC,EAAqB,cAE5DiC,QAA6B,IAAIjC,EAAkB,WAEnDkC,WAAmC,IAAIlC,EAAqB,cAK5EmC,cAEIC,KAAKF,WAAWG,SAAS,WAAY,IAAIf,GACzCc,KAAKF,WAAWG,SAAS,YAAa,IAAIR,GAC1CO,KAAKF,WAAWG,SAAS,UAAW,IAAInC,GACxCkC,KAAKF,WAAWG,SAAS,YAAa,IAAIjC,GAC1CgC,KAAKF,WAAWG,SAAS,QAAS,IAAI/B,GACtC8B,KAAKF,WAAWG,SAAS,MAAO,IAAI7B,GACpC4B,KAAKF,WAAWG,SAAS,OAAQ,IAAI3B,GACrC0B,KAAKF,WAAWG,SAAS,QAAS,IAAIzB,GAGtCwB,KAAKJ,WAAWK,SAAS,OAAQ,IAAIvB,GACrCsB,KAAKJ,WAAWK,SAAS,QAAS,IAAIrB,GACtCoB,KAAKJ,WAAWK,SAAS,WAAY,IAAInB,EAC7C,CAUOoB,kBAAkBd,EAAsBe,EAA+BC,GAC1E,IAAK,MAAMC,KAAQF,EAAqB,CACpC,MAAMG,EAAYN,KAAKF,WAAWS,IAAIF,GACtC,GAAIC,EAAW,CACX,MAAMjB,EAAOe,EAAUA,EAAQC,GAAQf,UACvC,MAAMkB,EAASF,EAAUnB,SAASC,EAAaC,GAC/C,IAAKmB,EAAOjB,QAAS,CACjB,OAAOiB,CACX,CACJ,KAAO,CACHxB,EAAOyB,KAAK,kDAAkDJ,4BAClE,CACJ,CACA,MAAO,CAAEd,QAAS,KACtB,EAOG,MAAMmB,EAAiB,IAAIf,EAAkB,IAAAgB,EAAA,CAAAC,WAAA,MAAAD,EAAAhB,kBAAAgB,EAAAD,iBAAA,OAAAC,CAAA","ignoreList":[]}