@nice2dev/ui-core 1.0.25 → 1.0.27

package/dist/core/validation.d.ts

@@ -0,0 +1,46 @@
+import type { NiceFilterGroup } from './datasource';
+/** A validation operator. `*Field` variants compare against another record field. */
+export type NiceFieldValidationOp = 'required' | 'minLength' | 'maxLength' | 'min' | 'max' | 'pattern' | 'email' | 'url' | 'equals' | 'notEquals' | 'greaterThan' | 'lessThan' | 'matchesField' | 'greaterThanField' | 'lessThanField' | 'custom';
+/** A single validation rule targeting one field of a record. */
+export interface NiceFieldValidationRule {
+    /** Stable id (for keyed rendering / diagnostics). */
+    id: string;
+    /** Field this rule validates. */
+    field: string;
+    /** What to check. */
+    op: NiceFieldValidationOp;
+    /** Literal comparison value (minLength/min/pattern/equals/…). */
+    value?: string | number;
+    /** Other field to compare against (matchesField/greaterThanField/lessThanField). */
+    compareField?: string;
+    /** Error message shown when the rule fails (a sensible default is generated). */
+    message?: string;
+    /** Severity — `'error'` blocks, `'warning'` is advisory. Default `'error'`. */
+    severity?: 'error' | 'warning';
+    /** Apply this rule only when the record matches this filter group (reuses the filter model). */
+    when?: NiceFilterGroup;
+    /** For `op: 'custom'` — predicate returning `true` when the value is VALID. */
+    validate?: (value: unknown, record: Record<string, unknown>) => boolean;
+}
+/** A validation problem produced by {@link evaluateValidation}. */
+export interface NiceFieldValidationIssue {
+    field: string;
+    message: string;
+    severity: 'error' | 'warning';
+    ruleId?: string;
+}
+/** Default human-readable message for a rule that failed. */
+export declare function defaultValidationMessage(rule: NiceFieldValidationRule): string;
+/**
+ * Evaluate a single rule against a record. Returns `true` when the value PASSES.
+ * Non-`required` rules pass on empty values (let `required` own emptiness).
+ */
+export declare function evaluateValidationRule(rule: NiceFieldValidationRule, record: Record<string, unknown>): boolean;
+/**
+ * Evaluate all rules against a record, honoring each rule's `when` clause.
+ * Returns one issue per failing rule (empty array ⇒ valid).
+ */
+export declare function evaluateValidation(rules: NiceFieldValidationRule[] | undefined, record: Record<string, unknown>): NiceFieldValidationIssue[];
+/** Convenience: does the record satisfy every `error`-severity rule? */
+export declare function isRecordValid(rules: NiceFieldValidationRule[] | undefined, record: Record<string, unknown>): boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,qFAAqF;AACrF,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,WAAW,GACX,WAAW,GACX,KAAK,GACL,KAAK,GACL,SAAS,GACT,OAAO,GACP,KAAK,GACL,QAAQ,GACR,WAAW,GACX,aAAa,GACb,UAAU,GACV,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,QAAQ,CAAC;AAEb,gEAAgE;AAChE,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,EAAE,EAAE,qBAAqB,CAAC;IAC1B,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,gGAAgG;IAChG,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;CACzE;AAED,mEAAmE;AACnE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAsBD,6DAA6D;AAC7D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAoC9E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,uBAAuB,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CA+CT;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,EAAE,GAAG,SAAS,EAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,wBAAwB,EAAE,CAgB5B;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,uBAAuB,EAAE,GAAG,SAAS,EAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAET"}