@siliconst/metaui 1.4.51 → 2.0.0

package/src/nz/co/siliconst/ui5/metaui/layouts/WizardStepRenderer.ts

@@ -0,0 +1,112 @@
+/**
+ * @file WizardStepRenderer.ts
+ * @description Renders individual wizard step SimpleForm containers and validates per-step field paths.
+ */
+
+import SimpleForm from "sap/ui/layout/form/SimpleForm";
+import { ISchema, ILayoutElement } from "../interfaces/ISchema";
+import { Engine } from "../core/Engine";
+import { PayloadValidator } from "../core/PayloadValidator";
+import { SchemaNormalizer } from "../core/SchemaNormalizer";
+import { LayoutElementWalker, LayoutFieldFactory } from "./LayoutElementWalker";
+
+/**
+ * Stateless helper for building and validating individual wizard steps in `WizardLayout`.
+ *
+ * @namespace nz.co.siliconst.ui5.metaui.layouts
+ * @internal
+ */
+export class WizardStepRenderer {
+    /**
+     * Validates all fields registered during a specific step's form build.
+     * Routes error painting through `engine.reportSchemaError()` so both default and
+     * `useMessageManager` modes are updated consistently.
+     *
+     * @param fieldPaths The list of binding paths collected during the step's form build.
+     * @param engine The Engine instance that holds the plugin registry and validation ledger.
+     * @param schema Optional root schema for resolving array/table sub-layouts.
+     * @returns {boolean} True if all fields are valid, false if any failed.
+     */
+    public static validateStep(fieldPaths: string[], engine: Engine, schema?: ISchema): boolean {
+        engine.host?.evaluatePoliciesNow?.();
+        let allValid = true;
+        const activeModel = engine.getModel() as { getProperty?: (p: string) => unknown } | undefined;
+
+        for (const path of fieldPaths) {
+            const plugin = engine.getPluginByPath(path);
+            if (plugin) {
+                if (engine.isInsideAbsentOptionalObject(path)) {
+                    engine.reportSchemaError(path, null);
+                    continue;
+                }
+                const result = plugin.validate();
+                if (!result.isValid) {
+                    engine.reportSchemaError(path, result.errorMessage || "This field is required.");
+                    allValid = false;
+                } else {
+                    engine.reportSchemaError(path, null);
+                }
+            } else if (schema) {
+                const scopeStr = `#/properties/${path.replace(/^\//, "").replace(/\//g, "/properties/")}`;
+                const { meta } = SchemaNormalizer.resolveScope(schema, scopeStr);
+                if (meta && meta.ui?.visible !== false) {
+                    if (meta.type === "array") {
+                        if (!engine.validateArrayPath(path, meta)) {
+                            allValid = false;
+                        }
+                    } else {
+                        const val = activeModel?.getProperty ? activeModel.getProperty(path) : undefined;
+                        const res = PayloadValidator.validateTree(
+                            meta,
+                            val,
+                            (ref) => engine.host?.getSchemaDefinition?.(ref) ?? null
+                        );
+                        if (!res.isValid) {
+                            engine.reportSchemaError(path, res.errorMessage || "Invalid field.");
+                            allValid = false;
+                        } else {
+                            engine.reportSchemaError(path, null);
+                        }
+                    }
+                }
+            }
+        }
+        if (engine.hasActiveErrorsForPaths(fieldPaths)) {
+            allValid = false;
+        }
+        return allValid;
+    }
+
+    /**
+     * Constructs a `SimpleForm` for a single wizard step, recursively rendering all
+     * child layout elements and collecting their binding paths into `fieldPaths`.
+     *
+     * @param stepElement The top-level Group/WizardStep layout element for this step.
+     * @param schema The active JSON schema.
+     * @param modelName The UI5 JSONModel alias for data binding.
+     * @param engine The Engine instance for field generation.
+     * @param fieldPaths Collector array — all binding paths generated for this step are pushed here.
+     * @returns {SimpleForm} The assembled `SimpleForm` for this wizard step.
+     */
+    public static buildStepForm(
+        stepElement: ILayoutElement,
+        schema: ISchema,
+        modelName: string,
+        engine: Engine,
+        fieldPaths: string[]
+    ): SimpleForm {
+        const form = LayoutFieldFactory.createSimpleForm(undefined, schema.ui);
+
+        if (stepElement.elements && Array.isArray(stepElement.elements)) {
+            LayoutElementWalker.walk(
+                stepElement.elements,
+                schema,
+                engine,
+                LayoutElementWalker.createSimpleFormSink(form, schema, modelName, engine, "WizardLayout", fieldPaths),
+                "WizardLayout"
+            );
+        }
+
+        return form;
+    }
+}

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

@@ -1,74 +1,87 @@
-/**
- * @file library.ts
- * @description Standard SAP UI5 library registration file. Exposes the MetaUI namespace 
- * and automatically bootstraps the internal PluginRegistry.
- */
-
-import Core from "sap/ui/core/Core";
-
-// Explicitly import core plugins to bundle them into library-preload.js
-import "nz/co/siliconst/ui5/metaui/plugins/controls/StringPlugin";
-import "nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin";
-import "nz/co/siliconst/ui5/metaui/plugins/controls/BooleanPlugin";
-import "nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin";
-import "nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin";
-import "nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin";
-import "nz/co/siliconst/ui5/metaui/plugins/controls/MultiInputPlugin";
-import "nz/co/siliconst/ui5/metaui/plugins/controls/DatePlugin";
-import "nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator";
-import "nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder";
-
-// Explicitly import core Layouts
-import "nz/co/siliconst/ui5/metaui/layouts/FormLayout";
-import "nz/co/siliconst/ui5/metaui/layouts/TableLayout";
-import "nz/co/siliconst/ui5/metaui/layouts/WizardLayout";
-import "nz/co/siliconst/ui5/metaui/layouts/CompactLayout";
-
-// AI Inference
-import "nz/co/siliconst/ui5/metaui/ai/BaseAIGenerator";
-import "nz/co/siliconst/ui5/metaui/ai/MockLLMProxy";
-import "nz/co/siliconst/ui5/metaui/ai/RestLLMProxy";
-import "nz/co/siliconst/ui5/metaui/ai/AIConfig";
-
-// Delegate to standard library registration
-Core.initLibrary({
-    name: "nz.co.siliconst.ui5.metaui",
-    version: "1.0.0",
-    dependencies: [
-        "sap.ui.core",
-        "sap.m",
-        "sap.ui.layout",
-        "sap.ui.table"
-    ],
-    controls: [
-        "nz.co.siliconst.ui5.metaui.controls.DynamicHost",
-        "nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost",
-        "nz.co.siliconst.ui5.metaui.controls.BaseHardwareControl",
-        "nz.co.siliconst.ui5.metaui.controls.CameraControl",
-        "nz.co.siliconst.ui5.metaui.controls.BarcodeScannerControl",
-        "nz.co.siliconst.ui5.metaui.controls.SignatureControl",
-        "nz.co.siliconst.ui5.metaui.controls.VoiceInputControl",
-        "nz.co.siliconst.ui5.metaui.controls.GeolocationControl",
-        "nz.co.siliconst.ui5.metaui.controls.RichTextControl"
-    ],
-    elements: [],
-    interfaces: [],
-    noLibraryCSS: true
-});
-
-// Exporting window object safely for UI5 compatibility if needed
-declare global {
-    interface Window {
-        nz: {
-            co: {
-                siliconst: {
-                    ui5: {
-                        metaui: Record<string, unknown>;
-                    };
-                };
-            };
-        };
-    }
-}
-
-export default window.nz.co.siliconst.ui5.metaui;
+/**
+ * @file library.ts
+ * @description Standard SAP UI5 library registration file. Exposes the MetaUI namespace
+ * and automatically bootstraps the internal PluginRegistry.
+ */
+
+import Core from "sap/ui/core/Core";
+
+// Eagerly bundle the 8 baseline primitive/container control plugins and 4 layout managers into library-preload.js
+// so standard JSON Schema / inferred forms render with zero extra AMD network round-trips; specialized, hardware,
+// action, and remote-datasource plugins are lazy-loaded on demand via PluginRegistry.preloadDependencies().
+import "nz/co/siliconst/ui5/metaui/plugins/controls/StringPlugin";
+import "nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin";
+import "nz/co/siliconst/ui5/metaui/plugins/controls/BooleanPlugin";
+import "nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin";
+import "nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin";
+import "nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin";
+import "nz/co/siliconst/ui5/metaui/plugins/controls/MultiInputPlugin";
+import "nz/co/siliconst/ui5/metaui/plugins/controls/DatePlugin";
+import "nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator";
+import "nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder";
+
+// Explicitly import core Layouts
+import "nz/co/siliconst/ui5/metaui/layouts/FormLayout";
+import "nz/co/siliconst/ui5/metaui/layouts/TableLayout";
+import "nz/co/siliconst/ui5/metaui/layouts/WizardLayout";
+import "nz/co/siliconst/ui5/metaui/layouts/CompactLayout";
+
+// Delegate to standard library registration.
+//
+// `dependencies` is the EAGER list: UI5 resolves every entry while this factory runs. It must
+// therefore contain exactly the libraries the eagerly bundled plugins and layouts above import,
+// and nothing else. `sap.ui.unified` (FileUploaderPlugin) and `sap.ui.codeeditor`
+// (CodeEditorPlugin) are reachable only through plugin modules that
+// PluginRegistry.preloadDependencies() requires on demand, so both are declared
+// `<lazy>true</lazy>` in `.library` and are deliberately absent here.
+//
+// Listing a library here that is not eagerly imported is not merely redundant. This list once
+// carried `sap.ndc`, which ships with SAPUI5 but not with OpenUI5, so resolving
+// `sap/ndc/library.js` 404'd on every OpenUI5 distribution and took the whole library factory -
+// and therefore the whole form - down with it. Both survivors ship with OpenUI5 too.
+Core.initLibrary({
+    name: "nz.co.siliconst.ui5.metaui",
+    version: "2.0.0",
+    dependencies: [
+        "sap.ui.core",
+        "sap.m",
+        "sap.ui.layout"
+    ],
+    controls: [
+        "nz.co.siliconst.ui5.metaui.controls.DynamicHost",
+        "nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost",
+        "nz.co.siliconst.ui5.metaui.controls.host.InferredGeneratorHost",
+        "nz.co.siliconst.ui5.metaui.controls.BaseHardwareControl",
+        "nz.co.siliconst.ui5.metaui.controls.CameraControl",
+        "nz.co.siliconst.ui5.metaui.controls.SignatureControl",
+        "nz.co.siliconst.ui5.metaui.controls.VoiceInputControl",
+        "nz.co.siliconst.ui5.metaui.controls.GeolocationControl",
+        "nz.co.siliconst.ui5.metaui.controls.RichTextControl"
+    ],
+    elements: [],
+    interfaces: [],
+    noLibraryCSS: true
+});
+
+// Exporting window object safely for UI5 compatibility if needed
+declare global {
+    interface Window {
+        nz: {
+            co: {
+                siliconst: {
+                    ui5: {
+                        metaui: Record<string, unknown>;
+                    };
+                };
+            };
+        };
+    }
+}
+
+/**
+ * Default export exposing the initialized `nz.co.siliconst.ui5.metaui` UI5 library namespace.
+ *
+ * @namespace nz.co.siliconst.ui5.metaui
+ * @public
+ */
+export default window.nz.co.siliconst.ui5.metaui;