@fougere/schema 0.5.0-alpha.1 → 0.7.0-alpha.0

package/dist/validator/AdapterFieldValidator.js

@@ -0,0 +1,36 @@
+import { Validator } from '@cfworker/json-schema';
+import { isObject } from '../lib/utils.js';
+/**
+ * The format is DATA, not a TypeScript interface: an interface is erased before a JS
+ * caller, a config or a card from another language could be measured against it.
+ */
+export class AdapterFieldValidator {
+    validator;
+    constructor(validator) {
+        this.validator = validator;
+    }
+    /** Compiled once, at the adapter's own module load. */
+    static of(format) {
+        return new AdapterFieldValidator(new Validator(format, '2020-12', true));
+    }
+    /** `Post.adapters.sql.body.columnType: Property "postgre" does not match …` */
+    assert(entries, path) {
+        if (entries === undefined)
+            return;
+        if (!isObject(entries)) {
+            throw new Error(`${path}: expected an object keyed by field name, got ${typeof entries}.`);
+        }
+        for (const [field, entry] of Object.entries(entries)) {
+            const verdict = this.validator.validate(entry);
+            if (verdict.valid)
+                continue;
+            // The engine reports outermost first and ends on `False boolean schema`, which names
+            // nothing. The last unit above that one is the one carrying the offending key.
+            const units = verdict.errors.filter((unit) => unit.keyword !== 'false');
+            const failure = units[units.length - 1] ?? verdict.errors[0];
+            const nested = (failure?.instanceLocation ?? '#').slice(1).replaceAll('/', '.');
+            throw new Error(`${path}.${field}${nested}: ${failure?.error ?? 'does not match the format'}`);
+        }
+    }
+}
+//# sourceMappingURL=AdapterFieldValidator.js.map

package/dist/validator/AdapterFieldValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdapterFieldValidator.js","sourceRoot":"","sources":["../../src/validator/AdapterFieldValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACK,SAAS;IAA9C,YAAqC,SAAoB;yBAApB,SAAS;IAAc,CAAC;IAE7D,uDAAuD;IACvD,MAAM,CAAC,EAAE,CAAC,MAAa;QACrB,OAAO,IAAI,qBAAqB,CAAC,IAAI,SAAS,CAAC,MAAgB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,+EAA+E;IAC/E,MAAM,CAAC,OAAgB,EAAE,IAAY;QACnC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO;QAElC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,iDAAiD,OAAO,OAAO,GAAG,CAC1E,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC/C,IAAI,OAAO,CAAC,KAAK;gBAAE,SAAS;YAE5B,qFAAqF;YACrF,+EAA+E;YAC/E,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;YACxE,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,gBAAgB,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAEhF,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,MAAM,KAAK,OAAO,EAAE,KAAK,IAAI,2BAA2B,EAAE,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;CACF"}

package/dist/validator/FieldDeclarationValidator.d.ts

@@ -0,0 +1,9 @@
+import type { Field } from '../field/Field.js';
+import type { ValidationResult } from '../validation.js';
+export declare class FieldDeclarationValidator {
+    private readonly declaration;
+    private constructor();
+    static of(declaration: unknown): FieldDeclarationValidator;
+    get verdict(): ValidationResult<Field>;
+}
+//# sourceMappingURL=FieldDeclarationValidator.d.ts.map

package/dist/validator/FieldDeclarationValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldDeclarationValidator.d.ts","sourceRoot":"","sources":["../../src/validator/FieldDeclarationValidator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,qBAAa,yBAAyB;IAChB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAAhD,OAAO,eAAsD;IAE7D,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,GAAG,yBAAyB,CAEzD;IAED,IAAI,OAAO,IAAI,gBAAgB,CAAC,KAAK,CAAC,CA8CrC;CACF"}

package/dist/{judge/FieldJudge.js → validator/FieldDeclarationValidator.js}

@@ -1,13 +1,13 @@
-import { EXTENSION_AXES } from "../axis/Axis.js";
-import { Anatomy } from "../axis/shape/Shape.js";
-import { isObject } from "./ValueForm.js";
-export class FieldJudge {
+import { EXTENSION_AXES } from '../axis/Axis.js';
+import { Shapes } from '../axis/shape/Shape.js';
+import { isObject } from '../lib/utils.js';
+export class FieldDeclarationValidator {
     declaration;
     constructor(declaration) {
         this.declaration = declaration;
     }
     static of(declaration) {
-        return new FieldJudge(declaration);
+        return new FieldDeclarationValidator(declaration);
     }
     get verdict() {
         const declaration = this.declaration;
@@ -16,34 +16,34 @@ export class FieldJudge {
                 success: false,
                 errors: [
                     {
-                        path: ".",
+                        path: '.',
                         message: `Expected an object — got ${JSON.stringify(declaration)}`,
                     },
                 ],
             };
         }
         const errors = [];
-        if (!Anatomy.is(declaration.shape)) {
+        if (!Shapes.is(declaration.shape)) {
             errors.push({
-                path: "shape",
+                path: 'shape',
                 message: `Every field states a shape — got ${JSON.stringify(declaration.shape)}`,
             });
         }
         for (const axis of EXTENSION_AXES) {
             const declared = declaration[axis.slot];
             if (declared !== undefined)
-                axis.judge(declared, errors);
+                axis.validator(declared, errors);
         }
         if (declaration.meta !== undefined) {
             if (!isObject(declaration.meta)) {
                 errors.push({
-                    path: "meta",
+                    path: 'meta',
                     message: `Expected an object — got ${JSON.stringify(declaration.meta)}`,
                 });
             }
             else if (declaration.meta.description !== undefined &&
-                typeof declaration.meta.description !== "string") {
-                errors.push({ path: "meta.description", message: "Expected a string" });
+                typeof declaration.meta.description !== 'string') {
+                errors.push({ path: 'meta.description', message: 'Expected a string' });
             }
         }
         return errors.length
@@ -51,4 +51,4 @@ export class FieldJudge {
             : { success: true, data: declaration };
     }
 }
-//# sourceMappingURL=FieldJudge.js.map
+//# sourceMappingURL=FieldDeclarationValidator.js.map

package/dist/validator/FieldDeclarationValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldDeclarationValidator.js","sourceRoot":"","sources":["../../src/validator/FieldDeclarationValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,MAAM,OAAO,yBAAyB;IACC,WAAW;IAAhD,YAAqC,WAAoB;2BAApB,WAAW;IAAY,CAAC;IAE7D,MAAM,CAAC,EAAE,CAAC,WAAoB;QAC5B,OAAO,IAAI,yBAAyB,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,OAAO;QACT,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAErC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE;oBACN;wBACE,IAAI,EAAE,GAAG;wBACT,OAAO,EAAE,4BAA4B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE;qBACnE;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,oCAAoC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;aACjF,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,QAAQ,KAAK,SAAS;gBAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,4BAA4B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;iBACxE,CAAC,CAAC;YACL,CAAC;iBAAM,IACL,WAAW,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS;gBAC1C,OAAO,WAAW,CAAC,IAAI,CAAC,WAAW,KAAK,QAAQ,EAChD,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,MAAM;YAClB,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE;YAC5B,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAA+B,EAAE,CAAC;IAC/D,CAAC;CACF"}

package/dist/validator/FieldValueValidator.d.ts

@@ -0,0 +1,13 @@
+import type { Field } from '../field/Field.js';
+import type { Checked } from '../validation.js';
+export declare class FieldValueValidator {
+    private readonly field;
+    private static readonly plans;
+    private constructor();
+    /** The shape is compiled once and reused, not rebuilt per value. */
+    static of(field: Field): FieldValueValidator;
+    validate(value: unknown): Checked;
+    private static planFor;
+    private static customFormatOf;
+}
+//# sourceMappingURL=FieldValueValidator.d.ts.map

package/dist/validator/FieldValueValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldValueValidator.d.ts","sourceRoot":"","sources":["../../src/validator/FieldValueValidator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAQhD,qBAAa,mBAAmB;IAGV,OAAO,CAAC,QAAQ,CAAC,KAAK;IAF1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAEjE,OAAO,eAA8C;IAErD,oEAAoE;IACpE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,mBAAmB,CAE3C;IAED,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA2BhC;IAED,OAAO,CAAC,MAAM,CAAC,OAAO;IAetB,OAAO,CAAC,MAAM,CAAC,cAAc;CAU9B"}

package/dist/{judge/ValueJudge.js → validator/FieldValueValidator.js}

@@ -1,22 +1,25 @@
 import { Validator, format as engineFormats } from '@cfworker/json-schema';
 import { Formats } from '../axis/shape/Formats.js';
-import { Anatomy } from '../axis/shape/Shape.js';
-export class ValueJudge {
+import { Shapes } from '../axis/shape/Shape.js';
+export class FieldValueValidator {
     field;
     static plans = new WeakMap();
     constructor(field) {
         this.field = field;
     }
+    /** The shape is compiled once and reused, not rebuilt per value. */
     static of(field) {
-        return new ValueJudge(field);
+        return new FieldValueValidator(field);
     }
-    check(value) {
+    validate(value) {
         const shape = this.field.shape;
-        const base = Anatomy.of(shape).base;
+        const base = Shapes.of(shape).base;
         if (value !== null) {
             if (base?.type === 'object' && !base.properties)
                 return { value };
-            if (base?.type === 'string' && base.format === 'date-time' && value instanceof Date) {
+            if (base?.type === 'string' &&
+                base.format === 'date-time' &&
+                value instanceof Date) {
                 return Number.isNaN(value.getTime()) ? { error: 'Invalid date' } : { value };
             }
             if ((base?.type === 'number' || base?.type === 'integer') &&
@@ -25,7 +28,7 @@ export class ValueJudge {
                 return { error: 'Expected a number' };
             }
         }
-        const plan = ValueJudge.planFor(shape);
+        const plan = FieldValueValidator.planFor(shape);
         const result = plan.validator.validate(value);
         if (!result.valid)
             return { error: result.errors[0]?.error ?? 'Invalid value' };
@@ -37,7 +40,7 @@ export class ValueJudge {
     static planFor(shape) {
         let plan = this.plans.get(shape);
         if (!plan) {
-            const base = Anatomy.of(shape).base;
+            const base = Shapes.of(shape).base;
             const formatName = base?.type === 'string' ? base.format : undefined;
             plan = {
                 validator: new Validator(shape, '2020-12', true),
@@ -49,12 +52,12 @@ export class ValueJudge {
         return plan;
     }
     static customFormatOf(name) {
-        const custom = Formats.resolve(name);
+        const custom = Formats.find(name);
         if (!custom && !(name in engineFormats)) {
             throw new Error(`Unknown format: '${name}'. Register it with Formats.register('${name}', …) — ` +
-                `the engine judges ${Object.keys(engineFormats).length} formats natively and this is not one of them.`);
+                `the engine validates ${Object.keys(engineFormats).length} formats natively and this is not one of them.`);
         }
         return custom;
     }
 }
-//# sourceMappingURL=ValueJudge.js.map
+//# sourceMappingURL=FieldValueValidator.js.map

package/dist/validator/FieldValueValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldValueValidator.js","sourceRoot":"","sources":["../../src/validator/FieldValueValidator.ts"],"names":[],"mappings":"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"}

package/dist/{judge/RowRefusal.d.ts → validator/InputRefusal.d.ts}

@@ -3,15 +3,14 @@
  *
  * A value refused by its own shape carries the engine's message and a decoder refused by
  * user code carries that code's; neither is structural and neither belongs here. These
- * five are `RowJudge`'s own, and a table of cases enumerates them instead of reading the
+ * five are `InputValidator`'s own, and a table of cases enumerates them instead of reading the
  * text of a function — which a minifier rewrites without a word.
  */
-export declare const RowRefusal: {
+export declare const InputRefusal: {
     readonly notAnObject: 'Expected an object';
     readonly unknownField: 'Unknown field';
     readonly required: 'Required';
     readonly readOnly: 'Read-only';
     readonly immutable: 'Immutable';
 };
-export type RowRefusal = (typeof RowRefusal)[keyof typeof RowRefusal];
-//# sourceMappingURL=RowRefusal.d.ts.map
+//# sourceMappingURL=InputRefusal.d.ts.map

package/dist/validator/InputRefusal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputRefusal.d.ts","sourceRoot":"","sources":["../../src/validator/InputRefusal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;aACvB,WAAW,EAAE,oBAAoB;aACjC,YAAY,EAAE,eAAe;aAC7B,QAAQ,EAAE,UAAU;aACpB,QAAQ,EAAE,WAAW;aACrB,SAAS,EAAE,WAAW;CACd,CAAC"}

package/dist/{judge/RowRefusal.js → validator/InputRefusal.js}

@@ -3,14 +3,14 @@
  *
  * A value refused by its own shape carries the engine's message and a decoder refused by
  * user code carries that code's; neither is structural and neither belongs here. These
- * five are `RowJudge`'s own, and a table of cases enumerates them instead of reading the
+ * five are `InputValidator`'s own, and a table of cases enumerates them instead of reading the
  * text of a function — which a minifier rewrites without a word.
  */
-export const RowRefusal = {
+export const InputRefusal = {
     notAnObject: 'Expected an object',
     unknownField: 'Unknown field',
     required: 'Required',
     readOnly: 'Read-only',
     immutable: 'Immutable',
 };
-//# sourceMappingURL=RowRefusal.js.map
+//# sourceMappingURL=InputRefusal.js.map

package/dist/validator/InputRefusal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputRefusal.js","sourceRoot":"","sources":["../../src/validator/InputRefusal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,eAAe;IAC7B,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,WAAW;IACrB,SAAS,EAAE,WAAW;CACd,CAAC"}

package/dist/validator/InputValidator.d.ts

@@ -0,0 +1,15 @@
+import type { Field, Fields } from '../field/Field.js';
+import type { ValidationResult } from '../validation.js';
+export interface ValidateOptions {
+    patch?: boolean;
+}
+export declare class InputValidator {
+    private readonly fields;
+    private readonly options;
+    private constructor();
+    static of(fields: Fields, options?: ValidateOptions): InputValidator;
+    onAbsent(field: Field): 'skip' | 'empty-list' | null;
+    /** Hands on the value it PARSED, so a handler never re-checks a row. */
+    validate(input: unknown): ValidationResult<Record<string, unknown>>;
+}
+//# sourceMappingURL=InputValidator.d.ts.map

package/dist/validator/InputValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputValidator.d.ts","sourceRoot":"","sources":["../../src/validator/InputValidator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAI1E,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF1B,OAAO,eAGH;IAEJ,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc,CAEvE;IAED,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,YAAY,GAAG,IAAI,CAKnD;IAED,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA2DlE;CACF"}

package/dist/{judge/RowJudge.js → validator/InputValidator.js}

@@ -1,9 +1,9 @@
 import { Boundary } from '../axis/boundary/Boundary.js';
 import { Lifecycle } from '../axis/lifecycle/Lifecycle.js';
 import { Role } from '../axis/role/Role.js';
-import { ValueJudge } from './ValueJudge.js';
-import { RowRefusal } from './RowRefusal.js';
-export class RowJudge {
+import { FieldValueValidator } from './FieldValueValidator.js';
+import { InputRefusal } from './InputRefusal.js';
+export class InputValidator {
     fields;
     options;
     constructor(fields, options) {
@@ -11,7 +11,7 @@ export class RowJudge {
         this.options = options;
     }
     static of(fields, options = {}) {
-        return new RowJudge(fields, options);
+        return new InputValidator(fields, options);
     }
     onAbsent(field) {
         if (Boundary.of(field).readOnly)
@@ -22,16 +22,20 @@ export class RowJudge {
             return 'empty-list';
         return null;
     }
-    check(input) {
+    /** Hands on the value it PARSED, so a handler never re-checks a row. */
+    validate(input) {
         if (typeof input !== 'object' || input === null) {
-            return { success: false, errors: [{ path: '.', message: RowRefusal.notAnObject }] };
+            return {
+                success: false,
+                errors: [{ path: '.', message: InputRefusal.notAnObject }],
+            };
         }
         const data = input;
         const errors = [];
-        const out = {};
+        const row = {};
         for (const key of Object.keys(data)) {
             if (!(key in this.fields)) {
-                errors.push({ path: key, message: RowRefusal.unknownField });
+                errors.push({ path: key, message: InputRefusal.unknownField });
             }
         }
         for (const [key, field] of Object.entries(this.fields)) {
@@ -42,40 +46,40 @@ export class RowJudge {
                     continue;
                 const absence = this.onAbsent(field);
                 if (absence === null) {
-                    errors.push({ path, message: RowRefusal.required });
+                    errors.push({ path, message: InputRefusal.required });
                     continue;
                 }
                 if (absence === 'empty-list')
-                    out[key] = [];
+                    row[key] = [];
                 continue;
             }
             const boundary = Boundary.of(field);
             if (boundary.readOnly) {
-                errors.push({ path, message: RowRefusal.readOnly });
+                errors.push({ path, message: InputRefusal.readOnly });
                 continue;
             }
             if (this.options.patch && Lifecycle.of(field).immutable) {
-                errors.push({ path, message: RowRefusal.immutable });
+                errors.push({ path, message: InputRefusal.immutable });
                 continue;
             }
-            const checked = ValueJudge.of(field).check(value);
+            const checked = FieldValueValidator.of(field).validate(value);
             if ('error' in checked) {
                 errors.push({ path, message: checked.error });
                 continue;
             }
             if (checked.value === null) {
-                out[key] = null;
+                row[key] = null;
                 continue;
             }
             const decoded = boundary.decode(checked.value);
             if ('error' in decoded)
                 errors.push({ path, message: decoded.error });
             else
-                out[key] = decoded.value;
+                row[key] = decoded.value;
         }
         if (errors.length > 0)
             return { success: false, errors };
-        return { success: true, data: out };
+        return { success: true, data: row };
     }
 }
-//# sourceMappingURL=RowJudge.js.map
+//# sourceMappingURL=InputValidator.js.map

package/dist/validator/InputValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputValidator.js","sourceRoot":"","sources":["../../src/validator/InputValidator.ts"],"names":[],"mappings":"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"}

package/dist/vocabulary/bool.d.ts

@@ -1,4 +1,9 @@
-import { Field } from '../fields/Field.js';
+import { Field } from '../field/Field.js';
+/**
+ * So a default is a lifecycle rule, not a value the handler remembers to set.
+ * FR : pour qu'un défaut soit une règle de cycle de vie, pas un oubli possible du handler.
+ * `bool({ default: false })`
+ */
 export declare function bool(opts?: {
     default?: boolean;
     description?: string;

package/dist/vocabulary/bool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bool.d.ts","sourceRoot":"","sources":["../../src/vocabulary/bool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,wBAAgB,IAAI,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAMvF"}
+{"version":3,"file":"bool.d.ts","sourceRoot":"","sources":["../../src/vocabulary/bool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAOvF"}

package/dist/vocabulary/bool.js

@@ -1,4 +1,9 @@
-import { Field } from '../fields/Field.js';
+import { Field } from '../field/Field.js';
+/**
+ * So a default is a lifecycle rule, not a value the handler remembers to set.
+ * FR : pour qu'un défaut soit une règle de cycle de vie, pas un oubli possible du handler.
+ * `bool({ default: false })`
+ */
 export function bool(opts) {
     return new Field({
         shape: { type: 'boolean' },

package/dist/vocabulary/bool.js.map

@@ -1 +1 @@
-{"version":3,"file":"bool.js","sourceRoot":"","sources":["../../src/vocabulary/bool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,UAAU,IAAI,CAAC,IAAkD;IACrE,OAAO,IAAI,KAAK,CAAU;QACxB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC1B,SAAS,EAAE,IAAI,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS;QACxF,IAAI,EAAE,IAAI,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;KACtF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"bool.js","sourceRoot":"","sources":["../../src/vocabulary/bool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,IAAkD;IACrE,OAAO,IAAI,KAAK,CAAU;QACxB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC1B,SAAS,EACP,IAAI,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS;QAC/E,IAAI,EAAE,IAAI,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;KACtF,CAAC,CAAC;AACL,CAAC"}

package/dist/vocabulary/created.d.ts

@@ -1,3 +1,8 @@
-import { Field } from '../fields/Field.js';
+import { Field } from '../field/Field.js';
+/**
+ * So a creation stamp is written by the storage and refused from a client.
+ * FR : pour qu'un horodatage de création soit écrit par le storage et refusé au client.
+ * `created()` → `create: 'now'`, `update: 'forbidden'`
+ */
 export declare function created(): Field<Date>;
 //# sourceMappingURL=created.d.ts.map

package/dist/vocabulary/created.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"created.d.ts","sourceRoot":"","sources":["../../src/vocabulary/created.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,wBAAgB,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAIrC"}
+{"version":3,"file":"created.d.ts","sourceRoot":"","sources":["../../src/vocabulary/created.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG1C;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAIrC"}

package/dist/vocabulary/created.js

@@ -1,7 +1,12 @@
 import { date } from './date.js';
+/**
+ * So a creation stamp is written by the storage and refused from a client.
+ * FR : pour qu'un horodatage de création soit écrit par le storage et refusé au client.
+ * `created()` → `create: 'now'`, `update: 'forbidden'`
+ */
 export function created() {
     return date().with({
-        lifecycle: { create: "now", update: "forbidden" },
+        lifecycle: { create: 'now', update: 'forbidden' },
     });
 }
 //# sourceMappingURL=created.js.map

package/dist/vocabulary/created.js.map

@@ -1 +1 @@
-{"version":3,"file":"created.js","sourceRoot":"","sources":["../../src/vocabulary/created.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,OAAO;IACrB,OAAO,IAAI,EAAE,CAAC,IAAI,CAAC;QACjB,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE;KAClD,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"created.js","sourceRoot":"","sources":["../../src/vocabulary/created.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,IAAI,EAAE,CAAC,IAAI,CAAC;QACjB,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE;KAClD,CAAC,CAAC;AACL,CAAC"}

package/dist/vocabulary/date.d.ts

@@ -1,3 +1,8 @@
-import { Field } from '../fields/Field.js';
+import { Field } from '../field/Field.js';
+/**
+ * So a date is a string on the wire and a `Date` in a handler, with no word said.
+ * FR : pour qu'une date soit une chaîne sur le fil et une `Date` dans un handler.
+ * `date()` → `{ type: 'string', format: 'date-time' }`, decoded by the `isoDate` boundary
+ */
 export declare function date(): Field<Date>;
 //# sourceMappingURL=date.d.ts.map

package/dist/vocabulary/date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/vocabulary/date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,wBAAgB,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,CAElC"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/vocabulary/date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,CAElC"}

package/dist/vocabulary/date.js

@@ -1,4 +1,9 @@
-import { Field } from '../fields/Field.js';
+import { Field } from '../field/Field.js';
+/**
+ * So a date is a string on the wire and a `Date` in a handler, with no word said.
+ * FR : pour qu'une date soit une chaîne sur le fil et une `Date` dans un handler.
+ * `date()` → `{ type: 'string', format: 'date-time' }`, decoded by the `isoDate` boundary
+ */
 export function date() {
     return new Field({ shape: { type: 'string', format: 'date-time' } });
 }

package/dist/vocabulary/date.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/vocabulary/date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,UAAU,IAAI;IAClB,OAAO,IAAI,KAAK,CAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC"}
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/vocabulary/date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,IAAI;IAClB,OAAO,IAAI,KAAK,CAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/dist/vocabulary/email.d.ts

@@ -1,4 +1,9 @@
 import { type TextOptions } from './text.js';
-import type { Field } from '../fields/Field.js';
+import type { Field } from '../field/Field.js';
+/**
+ * So the format is stated once, where everyone would otherwise write the same regex.
+ * FR : pour que le format soit énoncé une fois, là où chacun réécrirait la même regex.
+ * `email({ max: 254 })`
+ */
 export declare function email(opts?: Omit<TextOptions, 'format'>): Field<string>;
 //# sourceMappingURL=email.d.ts.map

package/dist/vocabulary/email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/vocabulary/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,wBAAgB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAEvE"}
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/vocabulary/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAEvE"}

package/dist/vocabulary/email.js

@@ -1,4 +1,9 @@
 import { text } from './text.js';
+/**
+ * So the format is stated once, where everyone would otherwise write the same regex.
+ * FR : pour que le format soit énoncé une fois, là où chacun réécrirait la même regex.
+ * `email({ max: 254 })`
+ */
 export function email(opts) {
     return text({ ...opts, format: 'email' });
 }

package/dist/vocabulary/email.js.map

@@ -1 +1 @@
-{"version":3,"file":"email.js","sourceRoot":"","sources":["../../src/vocabulary/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,WAAW,CAAC;AAGnD,MAAM,UAAU,KAAK,CAAC,IAAkC;IACtD,OAAO,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../src/vocabulary/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,WAAW,CAAC;AAGnD;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,IAAkC;IACtD,OAAO,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/vocabulary/immutable.d.ts

@@ -1,3 +1,8 @@
-import { Field } from '../fields/Field.js';
+import { Field } from '../field/Field.js';
+/**
+ * So a write-once field is refused on a patch by the validator, not by the table.
+ * FR : pour qu'un champ écrit une fois soit refusé par le juge sur une modification.
+ * `immutable(text())` → `update: 'forbidden'`
+ */
 export declare const immutable: <T>(field: Field<T>) => Field<T>;
 //# sourceMappingURL=immutable.d.ts.map

package/dist/vocabulary/immutable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"immutable.d.ts","sourceRoot":"","sources":["../../src/vocabulary/immutable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAEpD,CAAC"}
+{"version":3,"file":"immutable.d.ts","sourceRoot":"","sources":["../../src/vocabulary/immutable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAKtD,CAAC"}

package/dist/vocabulary/immutable.js

@@ -1,4 +1,9 @@
 import { vocabulary } from './vocabulary.js';
+/**
+ * So a write-once field is refused on a patch by the validator, not by the table.
+ * FR : pour qu'un champ écrit une fois soit refusé par le juge sur une modification.
+ * `immutable(text())` → `update: 'forbidden'`
+ */
 export const immutable = vocabulary('immutable', () => ({
     lifecycle: { update: 'forbidden' },
 }));

package/dist/vocabulary/immutable.js.map

@@ -1 +1 @@
-{"version":3,"file":"immutable.js","sourceRoot":"","sources":["../../src/vocabulary/immutable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,MAAM,CAAC,MAAM,SAAS,GAAqC,UAAU,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IACxF,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;CACnC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"immutable.js","sourceRoot":"","sources":["../../src/vocabulary/immutable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAqC,UAAU,CACnE,WAAW,EACX,GAAG,EAAE,CAAC,CAAC;IACL,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;CACnC,CAAC,CACH,CAAC"}

package/dist/vocabulary/indexed.d.ts

@@ -1,3 +1,8 @@
-import { Field } from '../fields/Field.js';
+import { Field } from '../field/Field.js';
+/**
+ * So the entity states the index, and the DDL is the one that emits it.
+ * FR : pour que l'entité énonce l'index, le DDL étant celui qui l'émet.
+ * `indexed(text())` → `role.index` is `true`
+ */
 export declare const indexed: <T>(field: Field<T>) => Field<T>;
 //# sourceMappingURL=indexed.d.ts.map

package/dist/vocabulary/indexed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexed.d.ts","sourceRoot":"","sources":["../../src/vocabulary/indexed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,eAAO,MAAM,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAA4D,CAAC"}
+{"version":3,"file":"indexed.d.ts","sourceRoot":"","sources":["../../src/vocabulary/indexed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAElD,CAAC"}

package/dist/vocabulary/indexed.js

@@ -1,3 +1,10 @@
 import { vocabulary } from './vocabulary.js';
-export const indexed = vocabulary('indexed', () => ({ role: { index: true } }));
+/**
+ * So the entity states the index, and the DDL is the one that emits it.
+ * FR : pour que l'entité énonce l'index, le DDL étant celui qui l'émet.
+ * `indexed(text())` → `role.index` is `true`
+ */
+export const indexed = vocabulary('indexed', () => ({
+    role: { index: true },
+}));
 //# sourceMappingURL=indexed.js.map

package/dist/vocabulary/indexed.js.map

@@ -1 +1 @@
-{"version":3,"file":"indexed.js","sourceRoot":"","sources":["../../src/vocabulary/indexed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,MAAM,CAAC,MAAM,OAAO,GAAqC,UAAU,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"indexed.js","sourceRoot":"","sources":["../../src/vocabulary/indexed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAqC,UAAU,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACpF,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;CACtB,CAAC,CAAC,CAAC"}

package/dist/vocabulary/json.d.ts

@@ -1,5 +1,5 @@
-import { Field } from '../fields/Field.js';
-import type { SchemaView } from '../schema/SchemaView.js';
+import { Field } from '../field/Field.js';
+import type { SchemaView } from '../SchemaView.js';
 export declare function json<T = unknown>(): Field<T>;
 export declare function json<E extends SchemaView & (new (...args: any[]) => any)>(of: E): Field<InstanceType<E>>;
 //# sourceMappingURL=json.d.ts.map