@siliconst/metaui 1.4.51 → 2.0.0

package/src/nz/co/siliconst/ui5/metaui/plugins/validators/MinLengthValidatorPlugin.ts

@@ -1,31 +1,56 @@
-/**
- * @file MinLengthValidatorPlugin.ts
- * @description Standard business logic validator for string minimum lengths.
- */
-
-import { IValidator, IValidationResult } from "../../interfaces/IPipeline";
-
-/**
- * Ensures string length meets a minimum threshold.
- * 
- * @namespace nz.co.siliconst.ui5.metaui.plugins.validators
- * @public
- */
-export class MinLengthValidatorPlugin implements IValidator {
-    /**
-     * Validates parsed data before it enters the JSON model.
-     * @param parsedValue The cleaned data to validate.
-     * @param args Optional arguments provided in the schema.
-     * @returns IValidationResult containing status and optional error message.
-     */
-    public validate(parsedValue: unknown, args?: unknown): IValidationResult {
-        if (!parsedValue) return { isValid: true }; // Let RequiredValidator handle empty
-        if (typeof args !== "number") return { isValid: true }; // Invalid config
-
-        if (typeof parsedValue === "string" && parsedValue.length < args) {
-            return { isValid: false, errorMessage: `Minimum length is ${args} characters.` };
-        }
-        
-        return { isValid: true };
-    }
-}
+/**
+ * @file MinLengthValidatorPlugin.ts
+ * @description Standard business logic validator for string minimum lengths.
+ */
+
+import { IValidator, IValidationResult, IValidatorRuleExtraction } from "../../interfaces/IPipeline";
+import { IPropertyMetadata } from "../../interfaces/ISchema";
+import { isEmptyValue } from "./RequiredValidatorPlugin";
+import { I18n, TEXT_KEY } from "../../utils/I18n";
+
+/**
+ * Ensures string length meets a minimum threshold.
+ *
+ * @namespace nz.co.siliconst.ui5.metaui.plugins.validators
+ * @internal
+ */
+export class MinLengthValidatorPlugin implements IValidator {
+    /**
+     * Extracts the `minLength` constraint from a schema property descriptor.
+     *
+     * @param propMeta The schema property descriptor.
+     * @returns {IValidatorRuleExtraction} Activation status and `minLength` threshold.
+     */
+    public extractRule(propMeta: IPropertyMetadata): IValidatorRuleExtraction {
+        return {
+            active: propMeta.minLength !== undefined,
+            args: propMeta.minLength
+        };
+    }
+
+    /**
+     * Validates parsed data before it enters the JSON model.
+     *
+     * A non-numeric `minLength` is a schema configuration error and fails closed, matching
+     * `PatternValidatorPlugin`: a constraint the engine cannot apply must never report the field as valid.
+     *
+     * @param parsedValue The cleaned data to validate.
+     * @param args Optional arguments provided in the schema.
+     * @returns IValidationResult containing status and optional error message.
+     */
+    public validate(parsedValue: unknown, args?: unknown): IValidationResult {
+        if (typeof args !== "number") {
+            return {
+                isValid: false,
+                errorMessage: I18n.getText(TEXT_KEY.schemaConfigMustBeNumber, ["minLength"])
+            };
+        }
+        if (isEmptyValue(parsedValue)) return { isValid: true }; // Let RequiredValidator handle empty
+
+        if (typeof parsedValue === "string" && Array.from(parsedValue).length < args) {
+            return { isValid: false, errorMessage: I18n.getText(TEXT_KEY.minLength, [args]) };
+        }
+
+        return { isValid: true };
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/plugins/validators/MultipleOfValidatorPlugin.ts

@@ -0,0 +1,55 @@
+/**
+ * @file MultipleOfValidatorPlugin.ts
+ * @description Enforces the JSON-Schema `multipleOf` keyword on numbers.
+ */
+
+import { IValidator, IValidationResult, IValidatorRuleExtraction } from "../../interfaces/IPipeline";
+import { IPropertyMetadata } from "../../interfaces/ISchema";
+import { I18n, TEXT_KEY } from "../../utils/I18n";
+
+/**
+ * Fails when a number is not an exact multiple of the configured step.
+ * Uses a relative epsilon so decimal steps (e.g. 0.01) are not rejected by floating-point noise.
+ */
+export class MultipleOfValidatorPlugin implements IValidator {
+    /**
+     * Extracts the `multipleOf` step divisor from a schema property descriptor.
+     *
+     * @param propMeta The schema property descriptor.
+     * @returns {IValidatorRuleExtraction} Activation status and divisor step.
+     */
+    public extractRule(propMeta: IPropertyMetadata): IValidatorRuleExtraction {
+        return {
+            active: propMeta.multipleOf !== undefined,
+            args: propMeta.multipleOf
+        };
+    }
+
+    /**
+     * @param parsedValue The value to test.
+     * @param args The positive step size.
+     * @returns {IValidationResult} Invalid if the value is not a multiple of the step.
+     */
+    public validate(parsedValue: unknown, args?: unknown): IValidationResult {
+        if (typeof parsedValue !== "number" || Number.isNaN(parsedValue)) return { isValid: true };
+        if (!Number.isFinite(parsedValue)) {
+            return { isValid: false, errorMessage: I18n.getText(TEXT_KEY.finiteNumber) };
+        }
+        if (typeof args !== "number" || !Number.isFinite(args) || args <= 0) {
+            return {
+                isValid: false,
+                errorMessage: I18n.getText(TEXT_KEY.schemaConfigMustBePositiveNumber, ["multipleOf"])
+            };
+        }
+        const quotient = parsedValue / args;
+        if (!Number.isFinite(quotient)) {
+            return { isValid: false, errorMessage: I18n.getText(TEXT_KEY.multipleOf, [args]) };
+        }
+        const nearestInt = Math.round(quotient);
+        const diff = Math.abs(quotient - nearestInt);
+        if (diff > 1e-7) {
+            return { isValid: false, errorMessage: I18n.getText(TEXT_KEY.multipleOf, [args]) };
+        }
+        return { isValid: true };
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/plugins/validators/ObjectPropertiesValidatorPlugin.ts

@@ -0,0 +1,63 @@
+/**
+ * @file ObjectPropertiesValidatorPlugin.ts
+ * @description Validates object key counts against JSON Schema `minProperties` and `maxProperties`.
+ */
+
+import { IValidator, IValidationResult, IValidatorRuleExtraction } from "../../interfaces/IPipeline";
+import { IPropertyMetadata } from "../../interfaces/ISchema";
+import { isRecord, readNumber } from "../../utils/TypeGuards";
+import { I18n, TEXT_KEY } from "../../utils/I18n";
+
+/**
+ * Enforces `minProperties` and `maxProperties` bounds on object payloads.
+ *
+ * @namespace nz.co.siliconst.ui5.metaui.plugins.validators
+ * @internal
+ */
+export class ObjectPropertiesValidatorPlugin implements IValidator {
+    /**
+     * Extracts `minProperties` and `maxProperties` bounds from an object schema descriptor.
+     *
+     * @param propMeta The schema property descriptor.
+     * @returns {IValidatorRuleExtraction} Activation status and property count bounds.
+     */
+    public extractRule(propMeta: IPropertyMetadata): IValidatorRuleExtraction {
+        const hasMin = typeof propMeta.minProperties === "number";
+        const hasMax = typeof propMeta.maxProperties === "number";
+        if (!hasMin && !hasMax) {
+            return { active: false };
+        }
+        return {
+            active: true,
+            args: {
+                minProperties: propMeta.minProperties,
+                maxProperties: propMeta.maxProperties
+            }
+        };
+    }
+
+    /**
+     * Validates that the key count of an object value satisfies `minProperties` and `maxProperties`.
+     *
+     * @param parsedValue The object value to test.
+     * @param args Bounds object containing `minProperties` and/or `maxProperties`.
+     * @returns {IValidationResult} Invalid if the object key count violates the configured bounds.
+     */
+    public validate(parsedValue: unknown, args?: unknown): IValidationResult {
+        if (!isRecord(parsedValue) || !isRecord(args)) {
+            return { isValid: true };
+        }
+        const keyCount = Object.keys(parsedValue).length;
+        const minProps = readNumber(args, "minProperties");
+        const maxProps = readNumber(args, "maxProperties");
+
+        if (minProps !== undefined && keyCount < minProps) {
+            return { isValid: false, errorMessage: I18n.getText(TEXT_KEY.objectMinProperties, [minProps]) };
+        }
+        if (maxProps !== undefined && keyCount > maxProps) {
+            return { isValid: false, errorMessage: I18n.getText(TEXT_KEY.objectMaxProperties, [maxProps]) };
+        }
+        return { isValid: true };
+    }
+}
+