@siliconst/metaui 1.0.2 → 1.4.4

package/README.md

@@ -1,123 +1,203 @@
-# MetaUI - Dynamic SAP UI5 Rendering Engine
-
-MetaUI is an UI5 library that dynamically generates fully accessible, Fiori-compliant forms and tables purely from JSON schemas. It utilizes an **Isolated State Pattern** to entirely decouple from host OData bindings, yielding a clean JSON payload upon submission.
-
-## 🏗️ Architecture
-1. **Standard UI5**: Relies strictly on native UI5 layout grids (`sap.ui.layout.form.SimpleForm`, `sap.m.Table`).
-2. **Schema Normalization**: Ingests ABAP RTTI JSON payloads and normalizes them into a strict `ISchema` layout matrix.
-3. **Plugin Registry**: Maps primitive schema types (`string`, `number`, `boolean`, `dropdown`, `date`) directly to discrete UI5 control plugins (`sap.m.Input`, `sap.m.StepInput`, etc.).
-
-## 📚 Documentation Wiki
-Full payload references and API details are tracked in Git under the `docs/` folder:
-*   [Payload Formats & Schema API](docs/payload_formats.md)
-
-## 🚀 How to Test the Sandbox
-
-To understand how the engine works, a standalone test sandbox has been provided. It asynchronously loads two physical files:
-*   `test/mockSchema.json` - The schema definition detailing field types, required states, and dropdown arrays.
-*   `test/mockData.json` - The initial state payload to populate the form.
-
-### Running the Test
-You **cannot** run this test by double-clicking the `index.html` file due to browser CORS restrictions blocking `fetch()`. You must run it via a local web server.
-
-1. Open a terminal in the root `MetaUI` project folder.
-2. Run a static file server using Node.js:
-   ```bash
-   npx serve -p 8080 .
-   ```
-3. Open your web browser and navigate to:
-   `http://localhost:8080/test/index.html`
-4. Click **"Open MetaUI Dialog"**.
-5. Modify the values in the form. Notice the built-in validation rules (e.g., required fields, dropdown selections).
-6. Click **Save**. The clean, extracted JSON payload will be printed directly to the text area.
-
-## 📦 Installation (NPM)
-
-If you are developing a modern UI5 application utilizing `ui5-tooling`, you can pull this engine in directly via NPM (once published to your internal registry):
-
-```bash
-npm install @siliconst/ui5-metaui
-```
-
-### 1. ui5.yaml Configuration
-Ensure your application consumes the library by adding it to your `ui5.yaml` dependencies:
-
-```yaml
-specVersion: "3.0"
-metadata:
-  name: my.custom.app
-type: application
-builder:
-  customTasks:
-    - name: ui5-tooling-transpile-task
-      afterTask: replaceVersion
----
-specVersion: "3.0"
-kind: extension
-type: project-shim
-metadata:
-  name: my.custom.app.shim
-shims:
-  configurations:
-    "@siliconst/ui5-metaui":
-      type: library
-```
-
-### 2. manifest.json Registration
-You must explicitly declare the library dependency in your application's `manifest.json` so the UI5 core automatically downloads the runtime files and triggers the internal `PluginRegistry` bootstrapper.
-
-```json
-"sap.ui5": {
-  "dependencies": {
-    "minUI5Version": "1.120.0",
-    "libs": {
-      "sap.m": {},
-      "sap.ui.core": {},
-      "nz.co.siliconst.ui5.metaui": {}
-    }
-  }
-}
-```
-
-## 💻 Instantiating the Engine in your Controller
-
-Once installed and registered, simply require the `GeneratorHost` control in your view controllers:
-
-```javascript
-sap.ui.define([
-    "sap/ui/core/mvc/Controller",
-    "nz/co/siliconst/ui5/metaui/controls/GeneratorHost"
-], function(Controller, GeneratorHost) {
-    return Controller.extend("my.app.controller.Main", {
-        
-        openDynamicForm: function(schemaPayload, dataPayload) {
-            const host = new GeneratorHost({
-                schemaDefinition: schemaPayload, // The RTTI schema from ABAP
-                initialData: dataPayload,        // Your isolated JSON payload
-                submit: (oEvent) => {
-                    const finalJsonPayload = oEvent.getParameter("payload");
-                    // Send finalJsonPayload back to SAP ABAP via your REST/OData API!
-                }
-            });
-            
-            host.openInDialog("Edit Customer");
-        }
-    });
-});
-```
-
-## 🔗 Declarative XML Model Binding
-Because `GeneratorHost` extends `sap.ui.core.Control`, you can also embed it directly into your XML Views and bind standard UI5 Models (JSON, OData) natively to its properties.
-
-First, add the namespace to your XML View:
-```xml
-xmlns:meta="nz.co.siliconst.ui5.metaui.controls"
-```
-
-Then bind your host application's models directly to the control:
-```xml
-<meta:GeneratorHost 
-    schemaDefinition="{schemaModel>/CustomerSchema}" 
-    initialData="{odataModel>/Customers('1001')}" />
-```
-*Note: The engine will safely clone the incoming `initialData` into its own isolated state, preventing any unwanted two-way binding bleed into your host OData models until you explicitly catch the `submit` event!*
+# MetaUI
+
+**MetaUI** is an extensible, metadata-driven UI engine built on top of SAP UI5. Instead of relying on static XML views, it parses standard JSON Schema definitions at runtime to dynamically generate SAP Fiori component trees. This enables server-driven architectures where the UI structure and data bindings are determined entirely by the incoming payload.
+
+## MetaUI vs. Fiori Elements
+It is important to note that MetaUI is **not** an attempt to replace SAP Fiori Elements. Fiori Elements is a robust framework for building UIs driven by static OData CDS annotations. 
+
+MetaUI is designed for use cases where **CDS annotations are unavailable, impossible, or too rigid.** 
+- **Highly Dynamic**: MetaUI parses standard JSON Schemas at runtime, allowing you to generate completely dynamic layouts based on user roles, remote APIs, or NoSQL databases where the schema isn't known until execution.
+- **Backend Agnostic**: Because it relies on universal JSON rather than OData metadata, MetaUI can be plugged into virtually any tech stack (Node.js, Firebase, GraphQL, REST).
+
+## 🚀 Key Features
+
+Built for strict UI5 architecture adherence, MetaUI enforces modularity through a Plugin-based design and explicitly avoids inline DOM manipulation.
+
+- **100% Schema Inference**: Bind raw JSON to the new `DynamicHost` and the engine will instantly infer the metadata, schema, and layout on the fly.
+- **Hybrid / Partial Schema Inference**: Supports the standard JSON-Schema `additionalProperties: true` directive. Provide a minimal "Partial Schema" to override specific UI elements (e.g. converting a string into a dropdown), and the engine will recursively deep-merge it with an automatically inferred schema generated from the rest of your data payload.
+- **Strict Array Routing**: Pure contract-based routing strictly separates sub-layouts (arrays of objects) from inline field plugins (primitive arrays), enabling flawless complex nested rendering without hacky edge cases.
+- **True Two-Way Sync**: Safely double-bind `data` and `data` to the exact same UI5 model property. Built-in `deepEqual` loop-breakers catch UI5 data echoes, perfectly preserving user cursor focus during live model swaps.
+
+✨ **[Play with the Live Interactive Demo Here!](https://SiliconStreetDev1.github.io/MetaUI/index.html)** ✨
+
+---
+
+## 📚 Technical Documentation
+
+For detailed information regarding the JSON Schema properties, `ui.*` orchestrations, and recursive nested arrays, consult the payload formats specification:
+
+- [MetaUI Documentation Wiki](docs/wiki/Home.md)
+- [Payload Formats & Directives](docs/payload_formats.md)
+- [Fiori Integration Guide](docs/fiori_integration.md)
+- [Custom Plugin Authorship Guide](docs/plugin_authorship.md)
+
+---
+
+## 🏗 Architecture & Design Tenets
+
+1. **JSON-Schema Core:** MetaUI parses standard recursive JSON Schema `properties` blocks (`Record<string, IPropertyMetadata>`).
+2. **Implicit Layout Orchestration:** The `Engine` determines standard Layouts based on payload shape. Root `object` types map to `FormLayout` clusters. Root `array` types map to `TableLayout` instances. Nested arrays trigger recursive drill-down dialogs.
+3. **ConditionEngine Compilation:** Cross-context visibility rules (e.g., `"$root.status === 'DRAFT'"`) are transpiled into native UI5 Expression Bindings to utilize native reactivity.
+4. **Universal Plugin Architecture:** The `PluginRegistry` isolates control instantiation. Core layout managers delegate to registered implementations of `IPlugin`. Plugins are rigorously segregated into:
+   - `plugins/controls/`: Visual UI components (e.g., String, Date).
+   - `plugins/validators/`: Custom business logic constraints.
+   - `plugins/formatters/`: Data transformation utilities.
+   - `plugins/actions/`: Button and execution handlers.
+   - `plugins/datasources/`: Remote value help providers.
+
+---
+
+## 🚀 Quick Start (Sandbox)
+
+The repository contains an internal UI5 sandbox for testing the engine's inference logic.
+
+```bash
+# Install dependencies
+npm install
+
+# Run the UI5 development server (Sandbox application)
+npm run start
+```
+The test suite will boot at `http://localhost:8080/index.html`.
+
+---
+
+## 🛠 Integration
+
+### Installation
+
+Import the compiled library namespace into your UI5 project. 
+
+```javascript
+sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/DynamicHost"], function (DynamicHost) {
+    const host = new DynamicHost({
+        // The Schema Definition
+        schemaDefinition: {
+            type: "object",
+            uiLayout: [
+                {
+                    type: "Group",
+                    label: "User Settings",
+                    elements: [
+                        { type: "Control", scope: "#/properties/Username" },
+                        { type: "Control", scope: "#/properties/IsActive" }
+                    ]
+                }
+            ],
+            properties: {
+                Username: { type: "string", ui: { label: "User Name" } },
+                IsActive: { type: "boolean", ui: { label: "Active", widget: "switch" } }
+            }
+        },
+        // The Data Payload
+        data: {
+            "FirstName": "John",
+            "LastName": "Doe"
+        },
+    });
+
+    // Option A: Render inside an existing container
+    myVBox.addItem(host);
+    
+    // Option B: Mount as an isolated Dialog
+    host.openInDialog("User Configuration", "OK");
+
+    // Capture the extracted JSON payload on submit
+    host.attachSubmit(function(oEvent) {
+        const payload = oEvent.getParameter("payload");
+        console.log(payload);
+    });
+});
+```
+
+### Declarative XML Binding
+
+The `DynamicHost` fully supports declarative XML instantiation in traditional UI5 views:
+
+```xml
+<mvc:View
+    xmlns:mvc="sap.ui.core.mvc"
+    xmlns:meta="nz.co.siliconst.ui5.metaui.controls">
+    
+    <meta:DynamicHost 
+        id="dynamicFormHost" 
+        schemaDefinition="{backend>/SchemaDefinition}" 
+        data="{backend>/PayloadData}" 
+        useMessageManager="true"
+        submit=".onMetaFormSubmit" />
+        
+</mvc:View>
+```
+
+### Validation
+
+MetaUI supports client-side validation based on JSON Schema constraints natively.
+
+#### Mandatory Fields
+Adding `"required": true` to any property in the schema will enforce input validation prior to the `submit` event being fired.
+
+### Custom Validation Exits (`beforeSubmit`)
+For business logic requiring custom checks (e.g., async validation), the `DynamicHost` provides a `beforeSubmit` event.
+
+```javascript
+onBeforeSubmit: function(oEvent) {
+    const payload = oEvent.getParameter("payload");
+    const preventDefault = oEvent.getParameter("preventDefault");
+    const addError = oEvent.getParameter("addError");
+
+    if (payload.CustomerName === "Reserved") {
+        addError("CustomerName", "This customer name is reserved.");
+        preventDefault();
+    }
+}
+```
+
+### Asynchronous Field Validation (`fieldChange`)
+For real-time validation (like checking if a username is taken), listen to the `fieldChange` event. You can lock the form using `setBusy(true)`, perform your async check, and imperatively paint the field red using `addCustomError()` if the check fails.
+
+```javascript
+onFieldChange: function(oEvent) {
+    const fieldPath = oEvent.getParameter("fieldPath");
+    const value = oEvent.getParameter("value");
+    const host = oEvent.getSource();
+
+    if (fieldPath === "Username") {
+        host.setBusy(true); // Lock the UI5 form
+        
+        myBackendService.checkUsername(value).then((isTaken) => {
+            if (isTaken) {
+                host.addCustomError("Username", "This username is taken.");
+            } else {
+                host.clearCustomError("Username");
+            }
+        }).finally(() => {
+            host.setBusy(false); // Unlock
+        });
+    }
+}
+```
+
+### Fiori Message Manager Integration
+By default, validation errors are shown locally. To aggregate validation errors into the global UI5 Message Popover, enable `useMessageManager` on the `DynamicHost`:
+
+```xml
+<meta:DynamicHost
+    schemaDefinition="{/mySchema}"
+    useMessageManager="true"
+    beforeSubmit=".onBeforeSubmit"
+    submit=".onSubmit" />
+```
+
+
+
+---
+
+## ⚖️ License & Disclaimer
+
+**MIT License**
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+> [!WARNING]
+> **Disclaimer**: This software is provided "as is", without warranty of any kind, express or implied. Use of this project in production environments is at your own risk. The authors shall not be liable for any damages or issues arising from its usage.
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siliconst/metaui",
-  "version": "1.0.2",
+  "version": "1.4.4",
   "description": "Dynamic Metadata UI5 Engine",
   "author": "SiliconStreetDev1",
   "license": "MIT",
@@ -18,5 +18,6 @@
     "test-resources",
     "ui5.yaml",
     "README.md"
-  ]
+  ],
+  "types": "index.d.ts"
 }

package/src/nz/co/siliconst/ui5/metaui/.library

@@ -1,7 +1,7 @@
-<?xml version="1.0" encoding="UTF-8" ?>
-<library xmlns="http://www.sap.com/sap.ui.library.xsd">
-	<name>nz.co.siliconst.ui5.metaui</name>
-	<vendor>Siliconst</vendor>
-	<version>1.0.0</version>
-	<title>MetaUI Engine</title>
-</library>
+<?xml version="1.0" encoding="UTF-8" ?>
+<library xmlns="http://www.sap.com/sap.ui.library.xsd">
+	<name>nz.co.siliconst.ui5.metaui</name>
+	<vendor>Siliconst</vendor>
+	<version>1.0.0</version>
+	<title>MetaUI Engine</title>
+</library>

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl-dbg.js

@@ -0,0 +1,70 @@
+sap.ui.define(["sap/ui/core/Control", "./BaseHardwareControlRenderer"], function (Control, __BaseHardwareControlRenderer) {
+  "use strict";
+
+  function _interopRequireDefault(obj) {
+    return obj && obj.__esModule && typeof obj.default !== "undefined" ? obj.default : obj;
+  }
+  const BaseHardwareControlRenderer = _interopRequireDefault(__BaseHardwareControlRenderer);
+  /**
+   * @namespace nz.co.siliconst.ui5.metaui.controls
+   */
+  const BaseHardwareControl = Control.extend("nz.co.siliconst.ui5.metaui.controls.BaseHardwareControl", {
+    /**
+     * Common renderer for all hardware controls
+     */
+    renderer: BaseHardwareControlRenderer,
+    metadata: {
+      properties: {
+        /** The raw data value. Two-way bound to the model. */
+        value: {
+          type: "any",
+          defaultValue: null
+        },
+        /** The schema metadata for rendering dynamic hints (like labels/readOnly) */
+        schemaMetadata: {
+          type: "object",
+          defaultValue: null
+        },
+        /** Indicates if the control should be in a read-only state */
+        readOnly: {
+          type: "boolean",
+          defaultValue: false
+        }
+      },
+      aggregations: {
+        _content: {
+          type: "sap.m.VBox",
+          multiple: false,
+          visibility: "hidden"
+        }
+      },
+      events: {
+        /** Fired when the hardware successfully captures a value */
+        capture: {
+          parameters: {
+            value: {
+              type: "any"
+            }
+          }
+        }
+      }
+    },
+    /**
+     * Updates the bound value and fires the capture event.
+     */
+    setValueAndFire: function _setValueAndFire(val) {
+      this.setProperty("value", val, true); // true to suppress re-rendering if desired, but we want the binding to update
+      this.fireEvent("capture", {
+        value: val
+      });
+    },
+    /**
+     * Abstract hook for subclasses to render their specific DOM/Controls.
+     */
+    renderContent: function _renderContent(rm, control) {
+      // To be overridden by hardware implementations
+    }
+  });
+  return BaseHardwareControl;
+});
+//# sourceMappingURL=BaseHardwareControl-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHardwareControl-dbg.js","names":["BaseHardwareControlRenderer","_interopRequireDefault","__BaseHardwareControlRenderer","BaseHardwareControl","Control","extend","renderer","metadata","properties","value","type","defaultValue","schemaMetadata","readOnly","aggregations","_content","multiple","visibility","events","capture","parameters","setValueAndFire","_setValueAndFire","val","setProperty","fireEvent","renderContent","_renderContent","rm","control"],"sources":["BaseHardwareControl.ts"],"sourcesContent":["/**\n * @file BaseHardwareControl.ts\n * @description Foundational UI5 Custom Control for hardware plugins.\n * Exposes a standard 'value' property for pure two-way data binding.\n * \n */\n\nimport Control from \"sap/ui/core/Control\";\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport BaseHardwareControlRenderer from \"./BaseHardwareControlRenderer\";\n\n/**\n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nexport default class BaseHardwareControl extends Control {\n    static readonly metadata = {\n        properties: {\n            /** The raw data value. Two-way bound to the model. */\n            value: { type: \"any\", defaultValue: null },\n            /** The schema metadata for rendering dynamic hints (like labels/readOnly) */\n            schemaMetadata: { type: \"object\", defaultValue: null },\n            /** Indicates if the control should be in a read-only state */\n            readOnly: { type: \"boolean\", defaultValue: false }\n        },\n        aggregations: {\n            _content: { type: \"sap.m.VBox\", multiple: false, visibility: \"hidden\" }\n        },\n        events: {\n            /** Fired when the hardware successfully captures a value */\n            capture: {\n                parameters: {\n                    value: { type: \"any\" }\n                }\n            }\n        }\n    };\n\n    /**\n     * Updates the bound value and fires the capture event.\n     */\n    protected setValueAndFire(val: unknown): void {\n        this.setProperty(\"value\", val, true); // true to suppress re-rendering if desired, but we want the binding to update\n        this.fireEvent(\"capture\", { value: val });\n    }\n\n    /**\n     * Common renderer for all hardware controls\n     */\n    static readonly renderer = BaseHardwareControlRenderer;\n\n    /**\n     * Abstract hook for subclasses to render their specific DOM/Controls.\n     */\n    protected renderContent(rm: RenderManager, control: BaseHardwareControl): void {\n        // To be overridden by hardware implementations\n    }\n}\n"],"mappings":";;;;;;QAUOA,2BAA2B,GAAAC,sBAAA,CAAAC,6BAAA;EAElC;AACA;AACA;EAFA,MAGqBC,mBAAmB,GAASC,OAAO,CAAAC,MAAA;IA+BpD;AACJ;AACA;IACoBC,QAAQ,EAAGN,2BAA2B;IAjCtCO,QAAQ,EAAG;MACvBC,UAAU,EAAE;QACR;QACAC,KAAK,EAAE;UAAEC,IAAI,EAAE,KAAK;UAAEC,YAAY,EAAE;QAAK,CAAC;QAC1C;QACAC,cAAc,EAAE;UAAEF,IAAI,EAAE,QAAQ;UAAEC,YAAY,EAAE;QAAK,CAAC;QACtD;QACAE,QAAQ,EAAE;UAAEH,IAAI,EAAE,SAAS;UAAEC,YAAY,EAAE;QAAM;MACrD,CAAC;MACDG,YAAY,EAAE;QACVC,QAAQ,EAAE;UAAEL,IAAI,EAAE,YAAY;UAAEM,QAAQ,EAAE,KAAK;UAAEC,UAAU,EAAE;QAAS;MAC1E,CAAC;MACDC,MAAM,EAAE;QACJ;QACAC,OAAO,EAAE;UACLC,UAAU,EAAE;YACRX,KAAK,EAAE;cAAEC,IAAI,EAAE;YAAM;UACzB;QACJ;MACJ;IACJ,CAAC;IAED;AACJ;AACA;IACcW,eAAe,WAAAC,iBAACC,GAAY,EAAQ;MAC1C,IAAI,CAACC,WAAW,CAAC,OAAO,EAAED,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;MACtC,IAAI,CAACE,SAAS,CAAC,SAAS,EAAE;QAAEhB,KAAK,EAAEc;MAAI,CAAC,CAAC;IAC7C,CAAC;IAOD;AACJ;AACA;IACcG,aAAa,WAAAC,eAACC,EAAiB,EAAEC,OAA4B,EAAQ;MAC3E;IAAA;EACH;EAAA,OAzCgB1B,mBAAmB;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl.d.ts

@@ -0,0 +1,67 @@
+declare module "nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl" {
+    /**
+     * @file BaseHardwareControl.ts
+     * @description Foundational UI5 Custom Control for hardware plugins.
+     * Exposes a standard 'value' property for pure two-way data binding.
+     *
+     */
+    import Control from "sap/ui/core/Control";
+    import RenderManager from "sap/ui/core/RenderManager";
+    /**
+     * @namespace nz.co.siliconst.ui5.metaui.controls
+     */
+    export default class BaseHardwareControl extends Control {
+        static readonly metadata: {
+            properties: {
+                /** The raw data value. Two-way bound to the model. */
+                value: {
+                    type: string;
+                    defaultValue: any;
+                };
+                /** The schema metadata for rendering dynamic hints (like labels/readOnly) */
+                schemaMetadata: {
+                    type: string;
+                    defaultValue: any;
+                };
+                /** Indicates if the control should be in a read-only state */
+                readOnly: {
+                    type: string;
+                    defaultValue: boolean;
+                };
+            };
+            aggregations: {
+                _content: {
+                    type: string;
+                    multiple: boolean;
+                    visibility: string;
+                };
+            };
+            events: {
+                /** Fired when the hardware successfully captures a value */
+                capture: {
+                    parameters: {
+                        value: {
+                            type: string;
+                        };
+                    };
+                };
+            };
+        };
+        /**
+         * Updates the bound value and fires the capture event.
+         */
+        protected setValueAndFire(val: unknown): void;
+        /**
+         * Common renderer for all hardware controls
+         */
+        static readonly renderer: {
+            apiVersion: number;
+            render: (rm: RenderManager, control: BaseHardwareControl) => void;
+        };
+        /**
+         * Abstract hook for subclasses to render their specific DOM/Controls.
+         */
+        protected renderContent(rm: RenderManager, control: BaseHardwareControl): void;
+    }
+}
+//# sourceMappingURL=BaseHardwareControl.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHardwareControl.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,yDAAyD,CAAC;IACzE;;;;;OAKG;IAEH,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAC1C,OAAO,aAAa,MAAM,2BAA2B,CAAC;IAItD;;OAEG;IACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,OAAO;QACpD,MAAM,CAAC,QAAQ,CAAC,QAAQ;;gBAEhB,sDAAsD;;;;;gBAEtD,6EAA6E;;;;;gBAE7E,8DAA8D;;;;;;;;;;;;;;gBAO9D,4DAA4D;;;;;;;;;UAOlE;QAEF;;WAEG;QACH,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;QAK7C;;WAEG;QACH,MAAM,CAAC,QAAQ,CAAC,QAAQ;;;UAA+B;QAEvD;;WAEG;QACH,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;KAGjF;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl.js

@@ -0,0 +1,2 @@
+sap.ui.define(["sap/ui/core/Control","./BaseHardwareControlRenderer"],function(e,t){"use strict";function a(e){return e&&e.__esModule&&typeof e.default!=="undefined"?e.default:e}const n=a(t);const r=e.extend("nz.co.siliconst.ui5.metaui.controls.BaseHardwareControl",{renderer:n,metadata:{properties:{value:{type:"any",defaultValue:null},schemaMetadata:{type:"object",defaultValue:null},readOnly:{type:"boolean",defaultValue:false}},aggregations:{_content:{type:"sap.m.VBox",multiple:false,visibility:"hidden"}},events:{capture:{parameters:{value:{type:"any"}}}}},setValueAndFire:function e(t){this.setProperty("value",t,true);this.fireEvent("capture",{value:t})},renderContent:function e(t,a){}});return r});
+//# sourceMappingURL=BaseHardwareControl.js.map

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHardwareControl.js","names":["BaseHardwareControlRenderer","_interopRequireDefault","__BaseHardwareControlRenderer","BaseHardwareControl","Control","extend","renderer","metadata","properties","value","type","defaultValue","schemaMetadata","readOnly","aggregations","_content","multiple","visibility","events","capture","parameters","setValueAndFire","_setValueAndFire","val","this","setProperty","fireEvent","renderContent","_renderContent","rm","control"],"sources":["BaseHardwareControl.ts"],"sourcesContent":["/**\n * @file BaseHardwareControl.ts\n * @description Foundational UI5 Custom Control for hardware plugins.\n * Exposes a standard 'value' property for pure two-way data binding.\n * \n */\n\nimport Control from \"sap/ui/core/Control\";\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport BaseHardwareControlRenderer from \"./BaseHardwareControlRenderer\";\n\n/**\n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nexport default class BaseHardwareControl extends Control {\n    static readonly metadata = {\n        properties: {\n            /** The raw data value. Two-way bound to the model. */\n            value: { type: \"any\", defaultValue: null },\n            /** The schema metadata for rendering dynamic hints (like labels/readOnly) */\n            schemaMetadata: { type: \"object\", defaultValue: null },\n            /** Indicates if the control should be in a read-only state */\n            readOnly: { type: \"boolean\", defaultValue: false }\n        },\n        aggregations: {\n            _content: { type: \"sap.m.VBox\", multiple: false, visibility: \"hidden\" }\n        },\n        events: {\n            /** Fired when the hardware successfully captures a value */\n            capture: {\n                parameters: {\n                    value: { type: \"any\" }\n                }\n            }\n        }\n    };\n\n    /**\n     * Updates the bound value and fires the capture event.\n     */\n    protected setValueAndFire(val: unknown): void {\n        this.setProperty(\"value\", val, true); // true to suppress re-rendering if desired, but we want the binding to update\n        this.fireEvent(\"capture\", { value: val });\n    }\n\n    /**\n     * Common renderer for all hardware controls\n     */\n    static readonly renderer = BaseHardwareControlRenderer;\n\n    /**\n     * Abstract hook for subclasses to render their specific DOM/Controls.\n     */\n    protected renderContent(rm: RenderManager, control: BaseHardwareControl): void {\n        // To be overridden by hardware implementations\n    }\n}\n"],"mappings":"wLAUOA,EAA2BC,EAAAC,GAElC,MAGqBC,EAA4BC,EAAOC,OAAA,2DAkCpCC,SAAWN,EAjCXO,SAAW,CACvBC,WAAY,CAERC,MAAO,CAAEC,KAAM,MAAOC,aAAc,MAEpCC,eAAgB,CAAEF,KAAM,SAAUC,aAAc,MAEhDE,SAAU,CAAEH,KAAM,UAAWC,aAAc,QAE/CG,aAAc,CACVC,SAAU,CAAEL,KAAM,aAAcM,SAAU,MAAOC,WAAY,WAEjEC,OAAQ,CAEJC,QAAS,CACLC,WAAY,CACRX,MAAO,CAAEC,KAAM,WASrBW,gBAAe,SAAAC,EAACC,GACtBC,KAAKC,YAAY,QAASF,EAAK,MAC/BC,KAAKE,UAAU,UAAW,CAAEjB,MAAOc,GACvC,EAUUI,cAAa,SAAAC,EAACC,EAAmBC,GACvC,IACH,OAzCgB3B,CAAmB","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl.ts

@@ -0,0 +1,58 @@
+/**
+ * @file BaseHardwareControl.ts
+ * @description Foundational UI5 Custom Control for hardware plugins.
+ * Exposes a standard 'value' property for pure two-way data binding.
+ * 
+ */
+
+import Control from "sap/ui/core/Control";
+import RenderManager from "sap/ui/core/RenderManager";
+import { IPropertyMetadata } from "../../interfaces/ISchema";
+import BaseHardwareControlRenderer from "./BaseHardwareControlRenderer";
+
+/**
+ * @namespace nz.co.siliconst.ui5.metaui.controls
+ */
+export default class BaseHardwareControl extends Control {
+    static readonly metadata = {
+        properties: {
+            /** The raw data value. Two-way bound to the model. */
+            value: { type: "any", defaultValue: null },
+            /** The schema metadata for rendering dynamic hints (like labels/readOnly) */
+            schemaMetadata: { type: "object", defaultValue: null },
+            /** Indicates if the control should be in a read-only state */
+            readOnly: { type: "boolean", defaultValue: false }
+        },
+        aggregations: {
+            _content: { type: "sap.m.VBox", multiple: false, visibility: "hidden" }
+        },
+        events: {
+            /** Fired when the hardware successfully captures a value */
+            capture: {
+                parameters: {
+                    value: { type: "any" }
+                }
+            }
+        }
+    };
+
+    /**
+     * Updates the bound value and fires the capture event.
+     */
+    protected setValueAndFire(val: unknown): void {
+        this.setProperty("value", val, true); // true to suppress re-rendering if desired, but we want the binding to update
+        this.fireEvent("capture", { value: val });
+    }
+
+    /**
+     * Common renderer for all hardware controls
+     */
+    static readonly renderer = BaseHardwareControlRenderer;
+
+    /**
+     * Abstract hook for subclasses to render their specific DOM/Controls.
+     */
+    protected renderContent(rm: RenderManager, control: BaseHardwareControl): void {
+        // To be overridden by hardware implementations
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControlRenderer-dbg.js

@@ -0,0 +1,28 @@
+sap.ui.define([], function () {
+  "use strict";
+
+  /**
+   * @file BaseHardwareControlRenderer.ts
+   * @description Standard renderer for all MetaUI hardware controls.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.controls
+   */
+  var __exports = {
+    apiVersion: 2,
+    render: function (rm, control) {
+      rm.openStart("div", control);
+      rm.class("sapUiSmallMarginBottom");
+      rm.openEnd();
+      const content = control.getAggregation("_content");
+      if (content) {
+        rm.renderControl(content);
+      }
+      if (typeof control.renderContent === "function") {
+        control.renderContent(rm, control);
+      }
+      rm.close("div");
+    }
+  };
+  return __exports;
+});
+//# sourceMappingURL=BaseHardwareControlRenderer-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControlRenderer-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHardwareControlRenderer-dbg.js","names":["__exports","apiVersion","render","rm","control","openStart","class","openEnd","content","getAggregation","renderControl","renderContent","close"],"sources":["BaseHardwareControlRenderer.ts"],"sourcesContent":["/**\n * @file BaseHardwareControlRenderer.ts\n * @description Standard renderer for all MetaUI hardware controls.\n * \n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport BaseHardwareControl from \"./BaseHardwareControl\";\n\nexport default {\n    apiVersion: 2,\n    render: function (rm: RenderManager, control: BaseHardwareControl) {\n        rm.openStart(\"div\", control);\n        rm.class(\"sapUiSmallMarginBottom\");\n        rm.openEnd();\n        \n        const content = control.getAggregation(\"_content\") as sap.ui.core.Control;\n        if (content) {\n            rm.renderControl(content);\n        }\n        \n        if (typeof (control as unknown).renderContent === \"function\") {\n            (control as unknown).renderContent(rm, control);\n        }\n        \n        rm.close(\"div\");\n    }\n};\n"],"mappings":";;;EAAA;AACA;AACA;AACA;AACA;AACA;EALA,IAAAA,SAAA,GASe;IACXC,UAAU,EAAE,CAAC;IACbC,MAAM,EAAE,SAAAA,CAAUC,EAAiB,EAAEC,OAA4B,EAAE;MAC/DD,EAAE,CAACE,SAAS,CAAC,KAAK,EAAED,OAAO,CAAC;MAC5BD,EAAE,CAACG,KAAK,CAAC,wBAAwB,CAAC;MAClCH,EAAE,CAACI,OAAO,CAAC,CAAC;MAEZ,MAAMC,OAAO,GAAGJ,OAAO,CAACK,cAAc,CAAC,UAAU,CAAwB;MACzE,IAAID,OAAO,EAAE;QACTL,EAAE,CAACO,aAAa,CAACF,OAAO,CAAC;MAC7B;MAEA,IAAI,OAAQJ,OAAO,CAAaO,aAAa,KAAK,UAAU,EAAE;QACzDP,OAAO,CAAaO,aAAa,CAACR,EAAE,EAAEC,OAAO,CAAC;MACnD;MAEAD,EAAE,CAACS,KAAK,CAAC,KAAK,CAAC;IACnB;EACJ,CAAC;EAAA,OAAAZ,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControlRenderer.d.ts

@@ -0,0 +1,16 @@
+declare module "nz/co/siliconst/ui5/metaui/controls/BaseHardwareControlRenderer" {
+    /**
+     * @file BaseHardwareControlRenderer.ts
+     * @description Standard renderer for all MetaUI hardware controls.
+     *
+     * @namespace nz.co.siliconst.ui5.metaui.controls
+     */
+    import RenderManager from "sap/ui/core/RenderManager";
+    import BaseHardwareControl from "nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl";
+    const _default: {
+        apiVersion: number;
+        render: (rm: RenderManager, control: BaseHardwareControl) => void;
+    };
+    export default _default;
+}
+//# sourceMappingURL=BaseHardwareControlRenderer.d.ts.map