@siliconst/metaui 1.4.44 → 2.0.0

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/PhoneFormatterPlugin.ts

@@ -1,32 +1,100 @@
-/**
- * @file PhoneFormatterPlugin.ts
- * @description Standard data formatter for phone numbers.
- */
-
-import { IFormatter } from "../../interfaces/IPipeline";
-
-/**
- * Simple mask for 10-digit phone numbers (e.g. 5551234567 -> (555) 123-4567).
- * 
- * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters
- * @public
- */
-export class PhoneFormatterPlugin implements IFormatter {
-    /**
-     * Formats raw JSON model data into a masked phone number.
-     * @param rawValue The raw phone string.
-     * @returns The formatted string for the UI control.
-     */
-    public format(rawValue: unknown, args?: unknown): string {
-        if (!rawValue || typeof rawValue !== "string") return String(rawValue || "");
-        
-        const cleaned = ('' + rawValue).replace(/\D/g, '');
-        const match = cleaned.match(/^(\d{3})(\d{3})(\d{4})$/);
-        
-        if (match) {
-            return '(' + match[1] + ') ' + match[2] + '-' + match[3];
-        }
-        
-        return rawValue as string;
-    }
-}
+/**
+ * @file PhoneFormatterPlugin.ts
+ * @description Standard data formatter for phone numbers.
+ */
+
+import { IFormatter, IParser } from "../../interfaces/IPipeline";
+import { safeToString } from "../../core/SafeConvert";
+
+/**
+ * Reversible presentational formatter and parser for phone numbers
+ * (e.g. `"5551234567"` <-> `"(555) 123-4567"`, `"+15551234567"` <-> `"+1 (555) 123-4567"`).
+ *
+ * Non-NANP E.164 inputs use a lightweight length heuristic (2-digit country prefix for 9-12 digits,
+ * 3-digit prefix for 13 digits) rather than embedding an ITU-T E.164 / national numbering plan table;
+ * {@link PhoneFormatterPlugin.parse} strips the grouping space so the E.164 round-trip is exact.
+ *
+ * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters
+ * @internal
+ */
+export class PhoneFormatterPlugin implements IFormatter, IParser {
+    /**
+     * Formats raw JSON model data into a masked phone number.
+     *
+     * @param rawValue The raw phone string or number.
+     * @param _args Optional unused formatter arguments.
+     * @returns {string} The formatted string for the UI control.
+     */
+    public format(rawValue: unknown, _args?: unknown): string {
+        if (rawValue === null || rawValue === undefined || rawValue === "") {
+            return "";
+        }
+        if (typeof rawValue !== "string" && typeof rawValue !== "number") {
+            return safeToString(rawValue);
+        }
+        const strVal = String(rawValue).trim();
+        if (strVal.startsWith("+")) {
+            const intlDigits = strVal.slice(1).replace(/\D/g, "");
+            const usIntl = intlDigits.match(/^1(\d{3})(\d{3})(\d{4})$/);
+            if (usIntl) {
+                return `+1 (${usIntl[1]}) ${usIntl[2]}-${usIntl[3]}`;
+            }
+            const cc2 = intlDigits.match(/^(\d{2})(\d{7,10})$/);
+            if (cc2) {
+                return `+${cc2[1]} ${cc2[2]}`;
+            }
+            const cc3 = intlDigits.match(/^(\d{3})(\d{6,10})$/);
+            if (cc3) {
+                return `+${cc3[1]} ${cc3[2]}`;
+            }
+            return strVal;
+        }
+        const cleaned = strVal.replace(/\D/g, "");
+        const match11 = cleaned.match(/^1(\d{3})(\d{3})(\d{4})$/);
+        if (match11) {
+            return `+1 (${match11[1]}) ${match11[2]}-${match11[3]}`;
+        }
+        const match = cleaned.match(/^(\d{3})(\d{3})(\d{4})$/);
+        if (match) {
+            return "(" + match[1] + ") " + match[2] + "-" + match[3];
+        }
+        return strVal;
+    }
+
+    /**
+     * Parses a formatted phone display string back into its raw digit/E.164 representation.
+     * Total function: returns the input unchanged when it does not match a supported phone shape.
+     *
+     * @param uiValue The value extracted from the UI control.
+     * @param _args Optional unused parser arguments.
+     * @returns {unknown} The raw phone string (preserving any leading `+`) or the original input if unparseable.
+     */
+    public parse(uiValue: unknown, _args?: unknown): unknown {
+        if (typeof uiValue !== "string") {
+            return uiValue;
+        }
+        const trimmed = uiValue.trim();
+        if (trimmed === "") {
+            return "";
+        }
+        if (!/^[\d+\s().-]+$/.test(trimmed)) {
+            return uiValue;
+        }
+        if (trimmed.startsWith("+")) {
+            const intlDigits = trimmed.slice(1).replace(/\D/g, "");
+            if (
+                /^1\d{10}$/.test(intlDigits) ||
+                /^\d{2}\d{7,10}$/.test(intlDigits) ||
+                /^\d{3}\d{6,10}$/.test(intlDigits)
+            ) {
+                return `+${intlDigits}`;
+            }
+            return uiValue;
+        }
+        const digits = trimmed.replace(/\D/g, "");
+        if (/^\d{10}$/.test(digits) || /^1\d{10}$/.test(digits)) {
+            return digits;
+        }
+        return uiValue;
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/TextCaseFormatterPlugin.ts

@@ -1,28 +1,42 @@
-/**
- * @file TextCaseFormatterPlugin.ts
- * @description Standard data formatter for text casing.
- */
-
-import { IFormatter } from "../../interfaces/IPipeline";
-
-/**
- * Transforms text to UPPERCASE, lowercase, or Title Case.
- * Defaults to uppercase.
- * 
- * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters
- * @public
- */
-export class TextCaseFormatterPlugin implements IFormatter {
-    /**
-     * Formats raw JSON model data into uppercase.
-     * @param rawValue The raw string.
-     * @returns The uppercase formatted string for the UI control.
-     */
-    public format(rawValue: unknown, args?: unknown): string {
-        if (typeof rawValue !== "string") return String(rawValue || "");
-        
-        // Default to uppercase if no specific arg could be easily parsed by simple formatter 
-        // (could be enhanced to support schema args if formatters allowed args).
-        return rawValue.toUpperCase();
-    }
-}
+/**
+ * @file TextCaseFormatterPlugin.ts
+ * @description Standard data formatter for text casing.
+ */
+
+import { IFormatter } from "../../interfaces/IPipeline";
+import { isRecord, readString } from "../../utils/TypeGuards";
+import { safeToString } from "../../core/SafeConvert";
+
+/**
+ * Transforms text to UPPERCASE, lowercase, or Title Case.
+ * Defaults to uppercase.
+ *
+ * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters
+ * @internal
+ */
+export class TextCaseFormatterPlugin implements IFormatter {
+    /**
+     * Formats raw JSON model data into the requested text case.
+     * @param rawValue The raw string.
+     * @param args Optional case mode (`"lower"`, `"lowercase"`, `"title"`, `"upper"`, or `{ case: "lower" | "title" | "upper" }`).
+     * @returns The formatted string for the UI control.
+     */
+    public format(rawValue: unknown, args?: unknown): string {
+        if (rawValue === undefined || rawValue === null) return "";
+        const str = typeof rawValue === "string" ? rawValue : safeToString(rawValue);
+        const rawMode =
+            typeof args === "string"
+                ? args
+                : isRecord(args)
+                  ? readString(args, "case") || readString(args, "mode") || readString(args, "format")
+                  : undefined;
+        const mode = rawMode ? rawMode.toLowerCase() : "upper";
+        if (mode === "lower" || mode === "lowercase") {
+            return str.toLowerCase();
+        }
+        if (mode === "title" || mode === "titlecase") {
+            return str.toLowerCase().replace(/\b\w/g, (c) => c.toUpperCase());
+        }
+        return str.toUpperCase();
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/plugins/policies/conditions/DateLessThanConditionPlugin.ts

@@ -0,0 +1,79 @@
+/**
+ * @file DateLessThanConditionPlugin.ts
+ * @description Policy condition plugin that evaluates whether date model values are strictly earlier than configured date thresholds or sibling date fields.
+ */
+
+import { IPolicyConditionPlugin } from "../../../interfaces/IPolicyPlugin";
+import { isRecord } from "../../../utils/TypeGuards";
+import { Logger } from "../../../utils/Logger";
+import { PolicyConditionUtil } from "../../../utils/PolicyConditionUtil";
+
+/**
+ * Evaluates whether a date value is strictly earlier than a defined date threshold or target date pointer.
+ *
+ * @namespace nz.co.siliconst.ui5.metaui.plugins.policies.conditions
+ * @internal
+ */
+export class DateLessThanConditionPlugin implements IPolicyConditionPlugin {
+    /**
+     * Evaluates the configured date thresholds against the live state payload.
+     *
+     * @param conditionPayload A record mapping JSON pointers to ISO date strings or comparison JSON pointers.
+     * @param data The live JSON model payload.
+     * @param resolvePointer A function to resolve a JSON pointer against the data payload.
+     * @returns {boolean} True if all mapped properties precede their date thresholds, false otherwise.
+     */
+    public evaluate(
+        conditionPayload: unknown,
+        data: unknown,
+        resolvePointer: (d: unknown, p: string) => unknown
+    ): boolean {
+        if (!isRecord(conditionPayload) || Object.keys(conditionPayload).length === 0) {
+            Logger.warn(
+                `Malformed condition payload for operator 'DateLessThan': ` +
+                `expected non-empty object, got ${typeof conditionPayload}. Failing closed (false).`,
+                undefined,
+                "DateLessThanConditionPlugin"
+            );
+            return false;
+        }
+
+        for (const [path, rawThreshold] of Object.entries(conditionPayload)) {
+            const val = resolvePointer(data, path);
+            const comparisonTarget = PolicyConditionUtil.resolveThreshold(rawThreshold, data, resolvePointer);
+            const valTime = this.coerceToTimestamp(val);
+            const threshTime = this.coerceToTimestamp(comparisonTarget);
+            if (Number.isNaN(valTime) || Number.isNaN(threshTime) || valTime >= threshTime) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    /**
+     * Safely coerces a Date instance, ISO date string, or numeric timestamp into epoch milliseconds.
+     *
+     * @param value The candidate date value.
+     * @returns {number} Epoch milliseconds, or `NaN` if invalid/empty.
+     */
+    private coerceToTimestamp(value: unknown): number {
+        if (value === undefined || value === null || value === "") {
+            return NaN;
+        }
+        if (value instanceof Date) {
+            return value.getTime();
+        }
+        if (typeof value === "number") {
+            return value;
+        }
+        if (typeof value === "string") {
+            const trimmed = value.trim();
+            const isoMatch = /^(\d{4})-(\d{2})-(\d{2})$/.exec(trimmed);
+            if (isoMatch) {
+                return Date.UTC(Number(isoMatch[1]), Number(isoMatch[2]) - 1, Number(isoMatch[3]));
+            }
+            return Date.parse(trimmed);
+        }
+        return NaN;
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/plugins/policies/conditions/IsNotNullConditionPlugin.ts

@@ -1,34 +1,47 @@
-import { IPolicyConditionPlugin } from "../../../interfaces/IPolicyPlugin";
-
-/**
- * Evaluates whether a set of JSON pointers currently point to valid, non-empty data.
- * Used for triggering advanced sections once basic information is filled.
- */
-export class IsNotNullConditionPlugin implements IPolicyConditionPlugin {
-    /**
-     * Determines if this plugin can handle the given schema condition block.
-     * @param conditionKey The key found in the schema (e.g., "IsNotNull").
-     * @returns True if the key is "IsNotNull".
-     */
-    public canHandle(conditionKey: string): boolean {
-        return conditionKey === "IsNotNull";
-    }
-
-    /**
-     * Evaluates whether the configured property paths contain data.
-     * @param conditionPayload An array of JSON pointer strings.
-     * @param data The live JSON model payload.
-     * @param resolvePointer A function to resolve a JSON pointer against the data payload.
-     * @returns True if all mapped properties have a value (not null, not undefined, not empty string).
-     */
-    public evaluate(conditionPayload: unknown, data: unknown, resolvePointer: (d: unknown, p: string) => unknown): boolean {
-        const payload = conditionPayload as string[];
-        if (!payload || !Array.isArray(payload)) return true;
-
-        for (const path of payload) {
-            const val = resolvePointer(data, path);
-            if (val === undefined || val === null || val === "") return false;
-        }
-        return true;
-    }
-}
+/**
+ * @file IsNotNullConditionPlugin.ts
+ * @description Evaluates whether a set of JSON pointers currently point to valid, non-empty data.
+ */
+
+import { IPolicyConditionPlugin } from "../../../interfaces/IPolicyPlugin";
+import { Logger } from "../../../utils/Logger";
+
+/**
+ * Evaluates whether a set of JSON pointers currently point to valid, non-empty data.
+ * Used for triggering advanced sections once basic information is filled.
+ */
+export class IsNotNullConditionPlugin implements IPolicyConditionPlugin {
+    /**
+     * Evaluates whether the configured property paths contain data.
+     * @param conditionPayload An array of JSON pointer strings or a single JSON pointer string.
+     * @param data The live JSON model payload.
+     * @param resolvePointer A function to resolve a JSON pointer against the data payload.
+     * @returns True if all mapped properties have a value (not null, not undefined, not empty string).
+     */
+    public evaluate(conditionPayload: unknown, data: unknown, resolvePointer: (d: unknown, p: string) => unknown): boolean {
+        const payload =
+            typeof conditionPayload === "string" && conditionPayload.trim().length > 0
+                ? [conditionPayload]
+                : Array.isArray(conditionPayload) &&
+                    conditionPayload.length > 0 &&
+                    conditionPayload.every((p): p is string => typeof p === "string" && p.trim().length > 0)
+                  ? conditionPayload
+                  : null;
+        if (!payload) {
+            Logger.warn(
+                `Malformed condition payload for operator 'IsNotNull': ` +
+                `expected non-empty string or string[], got ${typeof conditionPayload}. Failing closed (false).`,
+                undefined,
+                "IsNotNullConditionPlugin"
+            );
+            return false;
+        }
+
+        for (const path of payload) {
+            const val = resolvePointer(data, path);
+            const isEmpty = val === undefined || val === null || val === "" || (Array.isArray(val) && val.length === 0);
+            if (isEmpty) return false;
+        }
+        return true;
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/plugins/policies/conditions/IsNullConditionPlugin.ts

@@ -1,34 +1,47 @@
-import { IPolicyConditionPlugin } from "../../../interfaces/IPolicyPlugin";
-
-/**
- * Evaluates whether a set of JSON pointers currently point to empty or undefined values.
- * Useful for conditionally hiding/disabling fields until prerequisites are filled out.
- */
-export class IsNullConditionPlugin implements IPolicyConditionPlugin {
-    /**
-     * Determines if this plugin can handle the given schema condition block.
-     * @param conditionKey The key found in the schema (e.g., "IsNull").
-     * @returns True if the key is "IsNull".
-     */
-    public canHandle(conditionKey: string): boolean {
-        return conditionKey === "IsNull";
-    }
-
-    /**
-     * Evaluates whether the configured property paths are empty.
-     * @param conditionPayload An array of JSON pointer strings.
-     * @param data The live JSON model payload.
-     * @param resolvePointer A function to resolve a JSON pointer against the data payload.
-     * @returns True if all mapped properties evaluate to null, undefined, or empty string.
-     */
-    public evaluate(conditionPayload: unknown, data: unknown, resolvePointer: (d: unknown, p: string) => unknown): boolean {
-        const payload = conditionPayload as string[];
-        if (!payload || !Array.isArray(payload)) return true;
-
-        for (const path of payload) {
-            const val = resolvePointer(data, path);
-            if (val !== undefined && val !== null && val !== "") return false;
-        }
-        return true;
-    }
-}
+/**
+ * @file IsNullConditionPlugin.ts
+ * @description Evaluates whether a set of JSON pointers currently point to empty or undefined values.
+ */
+
+import { IPolicyConditionPlugin } from "../../../interfaces/IPolicyPlugin";
+import { Logger } from "../../../utils/Logger";
+
+/**
+ * Evaluates whether a set of JSON pointers currently point to empty or undefined values.
+ * Useful for conditionally hiding/disabling fields until prerequisites are filled out.
+ */
+export class IsNullConditionPlugin implements IPolicyConditionPlugin {
+    /**
+     * Evaluates whether the configured property paths are empty.
+     * @param conditionPayload An array of JSON pointer strings or a single JSON pointer string.
+     * @param data The live JSON model payload.
+     * @param resolvePointer A function to resolve a JSON pointer against the data payload.
+     * @returns True if all mapped properties evaluate to null, undefined, or empty string.
+     */
+    public evaluate(conditionPayload: unknown, data: unknown, resolvePointer: (d: unknown, p: string) => unknown): boolean {
+        const payload =
+            typeof conditionPayload === "string" && conditionPayload.trim().length > 0
+                ? [conditionPayload]
+                : Array.isArray(conditionPayload) &&
+                    conditionPayload.length > 0 &&
+                    conditionPayload.every((p): p is string => typeof p === "string" && p.trim().length > 0)
+                  ? conditionPayload
+                  : null;
+        if (!payload) {
+            Logger.warn(
+                `Malformed condition payload for operator 'IsNull': ` +
+                `expected non-empty string or string[], got ${typeof conditionPayload}. Failing closed (false).`,
+                undefined,
+                "IsNullConditionPlugin"
+            );
+            return false;
+        }
+
+        for (const path of payload) {
+            const val = resolvePointer(data, path);
+            const isEmpty = val === undefined || val === null || val === "" || (Array.isArray(val) && val.length === 0);
+            if (!isEmpty) return false;
+        }
+        return true;
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/plugins/policies/conditions/NumericGreaterThanConditionPlugin.ts

@@ -1,45 +1,43 @@
-import { IPolicyConditionPlugin } from "../../../interfaces/IPolicyPlugin";
-
-/**
- * Evaluates whether a numeric value is strictly greater than a defined threshold.
- * Used for dynamic UI policies like age restrictions or minimum order quantities.
- */
-export class NumericGreaterThanConditionPlugin implements IPolicyConditionPlugin {
-    /**
-     * Determines if this plugin can handle the given schema condition block.
-     * @param conditionKey The key found in the schema (e.g., "NumericGreaterThan").
-     * @returns True if the key is "NumericGreaterThan".
-     */
-    public canHandle(conditionKey: string): boolean {
-        return conditionKey === "NumericGreaterThan";
-    }
-
-    /**
-     * Evaluates the configured thresholds against the live state payload.
-     * @param conditionPayload A record mapping JSON pointers to numeric thresholds.
-     * @param data The live JSON model payload.
-     * @param resolvePointer A function to resolve a JSON pointer against the data payload.
-     * @returns True if all mapped properties exceed their numeric thresholds, false otherwise.
-     */
-    public evaluate(conditionPayload: unknown, data: unknown, resolvePointer: (d: unknown, p: string) => unknown): boolean {
-        const payload = conditionPayload as Record<string, number>;
-        if (!payload) return true;
-
-        for (const [path, threshold] of Object.entries(payload)) {
-            const val = resolvePointer(data, path);
-            const num = this.coerceToNumber(val);
-            if (isNaN(num) || num <= threshold) return false;
-        }
-        return true;
-    }
-
-    /**
-     * Safely coerces an arbitrary value into a number.
-     * @param value The value to coerce.
-     * @returns The parsed number, or NaN if the value is empty/invalid.
-     */
-    private coerceToNumber(value: unknown): number {
-        if (value === undefined || value === null || value === "") return NaN;
-        return Number(value);
-    }
-}
+/**
+ * @file NumericGreaterThanConditionPlugin.ts
+ * @description Policy condition plugin that evaluates whether numeric model values strictly exceed configured thresholds.
+ */
+
+import { IPolicyConditionPlugin } from "../../../interfaces/IPolicyPlugin";
+import { isRecord } from "../../../utils/TypeGuards";
+import { Logger } from "../../../utils/Logger";
+import { PolicyConditionUtil } from "../../../utils/PolicyConditionUtil";
+
+/**
+ * Evaluates whether a numeric value is strictly greater than a defined threshold.
+ * Used for dynamic UI policies like age restrictions or minimum order quantities.
+ */
+export class NumericGreaterThanConditionPlugin implements IPolicyConditionPlugin {
+    /**
+     * Evaluates the configured thresholds against the live state payload.
+     * @param conditionPayload A record mapping JSON pointers to numeric thresholds.
+     * @param data The live JSON model payload.
+     * @param resolvePointer A function to resolve a JSON pointer against the data payload.
+     * @returns True if all mapped properties exceed their numeric thresholds, false otherwise.
+     */
+    public evaluate(conditionPayload: unknown, data: unknown, resolvePointer: (d: unknown, p: string) => unknown): boolean {
+        if (!isRecord(conditionPayload) || Object.keys(conditionPayload).length === 0) {
+            Logger.warn(
+                `Malformed condition payload for operator 'NumericGreaterThan': ` +
+                `expected non-empty object, got ${typeof conditionPayload}. Failing closed (false).`,
+                undefined,
+                "NumericGreaterThanConditionPlugin"
+            );
+            return false;
+        }
+
+        for (const [path, threshold] of Object.entries(conditionPayload)) {
+            const val = resolvePointer(data, path);
+            const resolvedThreshold = PolicyConditionUtil.resolveThreshold(threshold, data, resolvePointer);
+            const num = PolicyConditionUtil.coerceToNumber(val);
+            const threshNum = PolicyConditionUtil.coerceToNumber(resolvedThreshold);
+            if (isNaN(num) || isNaN(threshNum) || num <= threshNum) return false;
+        }
+        return true;
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/plugins/policies/conditions/NumericLessThanConditionPlugin.ts

@@ -1,45 +1,43 @@
-import { IPolicyConditionPlugin } from "../../../interfaces/IPolicyPlugin";
-
-/**
- * Evaluates whether a numeric value is strictly less than a defined threshold.
- * Used for dynamic UI policies like maximum allowed quantities.
- */
-export class NumericLessThanConditionPlugin implements IPolicyConditionPlugin {
-    /**
-     * Determines if this plugin can handle the given schema condition block.
-     * @param conditionKey The key found in the schema (e.g., "NumericLessThan").
-     * @returns True if the key is "NumericLessThan".
-     */
-    public canHandle(conditionKey: string): boolean {
-        return conditionKey === "NumericLessThan";
-    }
-
-    /**
-     * Evaluates the configured thresholds against the live state payload.
-     * @param conditionPayload A record mapping JSON pointers to numeric thresholds.
-     * @param data The live JSON model payload.
-     * @param resolvePointer A function to resolve a JSON pointer against the data payload.
-     * @returns True if all mapped properties are below their numeric thresholds, false otherwise.
-     */
-    public evaluate(conditionPayload: unknown, data: unknown, resolvePointer: (d: unknown, p: string) => unknown): boolean {
-        const payload = conditionPayload as Record<string, number>;
-        if (!payload) return true;
-
-        for (const [path, threshold] of Object.entries(payload)) {
-            const val = resolvePointer(data, path);
-            const num = this.coerceToNumber(val);
-            if (isNaN(num) || num >= threshold) return false;
-        }
-        return true;
-    }
-
-    /**
-     * Safely coerces an arbitrary value into a number.
-     * @param value The value to coerce.
-     * @returns The parsed number, or NaN if the value is empty/invalid.
-     */
-    private coerceToNumber(value: unknown): number {
-        if (value === undefined || value === null || value === "") return NaN;
-        return Number(value);
-    }
-}
+/**
+ * @file NumericLessThanConditionPlugin.ts
+ * @description Policy condition plugin that evaluates whether numeric model values are strictly below configured thresholds.
+ */
+
+import { IPolicyConditionPlugin } from "../../../interfaces/IPolicyPlugin";
+import { isRecord } from "../../../utils/TypeGuards";
+import { Logger } from "../../../utils/Logger";
+import { PolicyConditionUtil } from "../../../utils/PolicyConditionUtil";
+
+/**
+ * Evaluates whether a numeric value is strictly less than a defined threshold.
+ * Used for dynamic UI policies like maximum allowed quantities.
+ */
+export class NumericLessThanConditionPlugin implements IPolicyConditionPlugin {
+    /**
+     * Evaluates the configured thresholds against the live state payload.
+     * @param conditionPayload A record mapping JSON pointers to numeric thresholds.
+     * @param data The live JSON model payload.
+     * @param resolvePointer A function to resolve a JSON pointer against the data payload.
+     * @returns True if all mapped properties are below their numeric thresholds, false otherwise.
+     */
+    public evaluate(conditionPayload: unknown, data: unknown, resolvePointer: (d: unknown, p: string) => unknown): boolean {
+        if (!isRecord(conditionPayload) || Object.keys(conditionPayload).length === 0) {
+            Logger.warn(
+                `Malformed condition payload for operator 'NumericLessThan': ` +
+                `expected non-empty object, got ${typeof conditionPayload}. Failing closed (false).`,
+                undefined,
+                "NumericLessThanConditionPlugin"
+            );
+            return false;
+        }
+
+        for (const [path, threshold] of Object.entries(conditionPayload)) {
+            const val = resolvePointer(data, path);
+            const resolvedThreshold = PolicyConditionUtil.resolveThreshold(threshold, data, resolvePointer);
+            const num = PolicyConditionUtil.coerceToNumber(val);
+            const threshNum = PolicyConditionUtil.coerceToNumber(resolvedThreshold);
+            if (isNaN(num) || isNaN(threshNum) || num >= threshNum) return false;
+        }
+        return true;
+    }
+}