@fougere/schema 0.8.3-alpha.0 → 0.8.4-alpha.0

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

@@ -1,8 +1,3 @@
 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/preset/created.d.ts.map

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

package/dist/vocabulary/preset/created.js

@@ -1,9 +1,4 @@
 import { date } from '../primitive/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' },

package/dist/vocabulary/preset/created.js.map

@@ -1 +1 @@
-{"version":3,"file":"created.js","sourceRoot":"","sources":["../../../src/vocabulary/preset/created.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C;;;;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"}
+{"version":3,"file":"created.js","sourceRoot":"","sources":["../../../src/vocabulary/preset/created.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C,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/preset/email.d.ts

@@ -1,9 +1,4 @@
 import { type TextOptions } from '../primitive/text.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/preset/email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/preset/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;GAIG;AACH,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/preset/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,wBAAgB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAEvE"}

package/dist/vocabulary/preset/email.js

@@ -1,9 +1,4 @@
 import { text } from '../primitive/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/preset/email.js.map

@@ -1 +1 @@
-{"version":3,"file":"email.js","sourceRoot":"","sources":["../../../src/vocabulary/preset/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,sBAAsB,CAAC;AAG9D;;;;GAIG;AACH,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/preset/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,sBAAsB,CAAC;AAG9D,MAAM,UAAU,KAAK,CAAC,IAAkC;IACtD,OAAO,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/vocabulary/preset/updated.d.ts

@@ -1,8 +1,3 @@
 import { Field } from '../../field/Field.js';
-/**
- * So the dual of `created()` is re-stamped at every write, by the same hand.
- * FR : pour que le dual de `created()` soit ré-estampé à chaque écriture, par la même main.
- * `updated()` → `create: 'now'`, `update: 'now'`
- */
 export declare function updated(): Field<Date>;
 //# sourceMappingURL=updated.d.ts.map

package/dist/vocabulary/preset/updated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updated.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/preset/updated.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAGrC"}
+{"version":3,"file":"updated.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/preset/updated.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,wBAAgB,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAGrC"}

package/dist/vocabulary/preset/updated.js

@@ -1,9 +1,4 @@
 import { created } from './created.js';
-/**
- * So the dual of `created()` is re-stamped at every write, by the same hand.
- * FR : pour que le dual de `created()` soit ré-estampé à chaque écriture, par la même main.
- * `updated()` → `create: 'now'`, `update: 'now'`
- */
 export function updated() {
     const base = created();
     return base.with({ lifecycle: { ...base.lifecycle, update: 'now' } });

package/dist/vocabulary/preset/updated.js.map

@@ -1 +1 @@
-{"version":3,"file":"updated.js","sourceRoot":"","sources":["../../../src/vocabulary/preset/updated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;;;GAIG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC"}
+{"version":3,"file":"updated.js","sourceRoot":"","sources":["../../../src/vocabulary/preset/updated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,MAAM,UAAU,OAAO;IACrB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/vocabulary/preset/url.d.ts

@@ -1,9 +1,4 @@
 import { type TextOptions } from '../primitive/text.js';
 import type { Field } from '../../field/Field.js';
-/**
- * So a URL is a text with a stated format, not a type of its own.
- * FR : pour qu'une URL soit un texte au format énoncé, pas un type à part.
- * `url()` → `{ type: 'string', format: 'uri' }`
- */
 export declare function url(opts?: Omit<TextOptions, 'format'>): Field<string>;
 //# sourceMappingURL=url.d.ts.map

package/dist/vocabulary/preset/url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/preset/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAErE"}
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/preset/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,wBAAgB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAErE"}

package/dist/vocabulary/preset/url.js

@@ -1,9 +1,4 @@
 import { text } from '../primitive/text.js';
-/**
- * So a URL is a text with a stated format, not a type of its own.
- * FR : pour qu'une URL soit un texte au format énoncé, pas un type à part.
- * `url()` → `{ type: 'string', format: 'uri' }`
- */
 export function url(opts) {
     return text({ ...opts, format: 'uri' });
 }

package/dist/vocabulary/preset/url.js.map

@@ -1 +1 @@
-{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../src/vocabulary/preset/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,sBAAsB,CAAC;AAG9D;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,IAAkC;IACpD,OAAO,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../src/vocabulary/preset/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,sBAAsB,CAAC;AAG9D,MAAM,UAAU,GAAG,CAAC,IAAkC;IACpD,OAAO,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -1,9 +1,4 @@
 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/primitive/bool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bool.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/primitive/bool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C;;;;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"}
+{"version":3,"file":"bool.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/primitive/bool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,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/primitive/bool.js

@@ -1,9 +1,4 @@
 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/primitive/bool.js.map

@@ -1 +1 @@
-{"version":3,"file":"bool.js","sourceRoot":"","sources":["../../../src/vocabulary/primitive/bool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C;;;;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"}
+{"version":3,"file":"bool.js","sourceRoot":"","sources":["../../../src/vocabulary/primitive/bool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,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/primitive/date.d.ts

@@ -1,8 +1,8 @@
 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
+ * A `Date` in a handler, an ISO string on the wire — the `isoDate` boundary converts.
+ * FR : un `Date` dans un handler, une chaîne ISO sur le fil — `isoDate` convertit.
+ * `date()` → `{ type: 'string', format: 'date-time' }`
  */
 export declare function date(): Field<Date>;
 //# sourceMappingURL=date.d.ts.map

package/dist/vocabulary/primitive/date.js

@@ -1,8 +1,8 @@
 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
+ * A `Date` in a handler, an ISO string on the wire — the `isoDate` boundary converts.
+ * FR : un `Date` dans un handler, une chaîne ISO sur le fil — `isoDate` convertit.
+ * `date()` → `{ type: 'string', format: 'date-time' }`
  */
 export function date() {
     return new Field({ shape: { type: 'string', format: 'date-time' } });

package/dist/vocabulary/primitive/json.js

@@ -1,9 +1,9 @@
 import { Field } from '../../field/Field.js';
 import { InputValidator } from '../../validator/InputValidator.js';
 /**
- * So a stored object can carry a schema, instead of admitting any shape forever.
- * FR : pour qu'un objet stocké porte un schéma, au lieu d'admettre toute forme à jamais.
- * `json(Address)` → the object's properties and its required keys
+ * `json(Address)` where the object has a shape; `json()` alone admits any shape forever.
+ * FR : `json(Address)` quand l'objet a une forme ; `json()` seul admet tout, à jamais.
+ * `json(Address)` → the entity's properties, and its required keys
  */
 export function json(of) {
     if (!of)

package/dist/vocabulary/primitive/list.d.ts

@@ -4,9 +4,9 @@ export interface ListOptions {
     max?: number;
 }
 /**
- * So a list of values is told apart from a relation, which `many()` declares.
- * FR : pour qu'une liste de valeurs se distingue d'une relation, que `many()` déclare.
- * `list(text(), { max: 5 })`; `list(ref(User))` → throws
+ * A list of VALUES. The other side of a relation is `many()`, and passing one here throws.
+ * FR : une liste de VALEURS. L'autre côté d'une relation est `many()`, et en passer une ici lève.
+ * `list(text(), { max: 5 })` → `{ type: 'array', items: { type: 'string' }, maxItems: 5 }`
  */
 export declare function list<T>(item: Field<T>, opts?: ListOptions): Field<T[]>;
 //# sourceMappingURL=list.d.ts.map

package/dist/vocabulary/primitive/list.js

@@ -1,8 +1,8 @@
 import { Field } from '../../field/Field.js';
 /**
- * So a list of values is told apart from a relation, which `many()` declares.
- * FR : pour qu'une liste de valeurs se distingue d'une relation, que `many()` déclare.
- * `list(text(), { max: 5 })`; `list(ref(User))` → throws
+ * A list of VALUES. The other side of a relation is `many()`, and passing one here throws.
+ * FR : une liste de VALEURS. L'autre côté d'une relation est `many()`, et en passer une ici lève.
+ * `list(text(), { max: 5 })` → `{ type: 'array', items: { type: 'string' }, maxItems: 5 }`
  */
 export function list(item, opts) {
     if (item.role?.relation)

package/dist/vocabulary/primitive/many.d.ts

@@ -1,9 +1,9 @@
 import { type EntityConstructor } from '../../axis/role/Relation.js';
 import { Field } from '../../field/Field.js';
 /**
- * So the other side of a reference is declared, and holds no column.
- * FR : pour que l'autre côté d'une référence soit déclaré, sans porter de colonne.
- * `many(() => Post)` → a collection, absent from the row a client sends
+ * The far side of a `ref()`: no column of its own, and absent from what a client sends.
+ * FR : l'autre côté d'un `ref()` : aucune colonne à lui, et absent de ce qu'un client envoie.
+ * `many(() => Post)` → `{ type: 'array' }` with `role.relation.kind` `'many'`
  */
 export declare function many<E extends EntityConstructor>(target: E | (() => E)): Field<InstanceType<E>[]>;
 //# sourceMappingURL=many.d.ts.map

package/dist/vocabulary/primitive/many.js

@@ -1,9 +1,9 @@
 import { Relation } from '../../axis/role/Relation.js';
 import { Field } from '../../field/Field.js';
 /**
- * So the other side of a reference is declared, and holds no column.
- * FR : pour que l'autre côté d'une référence soit déclaré, sans porter de colonne.
- * `many(() => Post)` → a collection, absent from the row a client sends
+ * The far side of a `ref()`: no column of its own, and absent from what a client sends.
+ * FR : l'autre côté d'un `ref()` : aucune colonne à lui, et absent de ce qu'un client envoie.
+ * `many(() => Post)` → `{ type: 'array' }` with `role.relation.kind` `'many'`
  */
 export function many(target) {
     return new Field({

package/dist/vocabulary/primitive/number.d.ts

@@ -6,10 +6,5 @@ export interface NumberOptions {
     default?: number;
     description?: string;
 }
-/**
- * So `integer` is a shape, not a second word to remember.
- * FR : pour qu'`integer` soit une forme, pas un second mot à retenir.
- * `number({ integer: true, min: 0 })` → `{ type: 'integer', minimum: 0 }`
- */
 export declare function number(opts?: NumberOptions): Field<number>;
 //# sourceMappingURL=number.d.ts.map

package/dist/vocabulary/primitive/number.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/primitive/number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAW1D"}
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/primitive/number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAW1D"}

package/dist/vocabulary/primitive/number.js

@@ -1,9 +1,4 @@
 import { Field } from '../../field/Field.js';
-/**
- * So `integer` is a shape, not a second word to remember.
- * FR : pour qu'`integer` soit une forme, pas un second mot à retenir.
- * `number({ integer: true, min: 0 })` → `{ type: 'integer', minimum: 0 }`
- */
 export function number(opts) {
     return new Field({
         shape: {

package/dist/vocabulary/primitive/number.js.map

@@ -1 +1 @@
-{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../src/vocabulary/primitive/number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAU7C;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,IAAoB;IACzC,OAAO,IAAI,KAAK,CAAS;QACvB,KAAK,EAAE;YACL,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;YAC1C,OAAO,EAAE,IAAI,EAAE,GAAG;YAClB,OAAO,EAAE,IAAI,EAAE,GAAG;SACnB;QACD,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"}
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../src/vocabulary/primitive/number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAU7C,MAAM,UAAU,MAAM,CAAC,IAAoB;IACzC,OAAO,IAAI,KAAK,CAAS;QACvB,KAAK,EAAE;YACL,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;YAC1C,OAAO,EAAE,IAAI,EAAE,GAAG;YAClB,OAAO,EAAE,IAAI,EAAE,GAAG;SACnB;QACD,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/primitive/oneOf.js

@@ -1,8 +1,8 @@
 import { Field } from '../../field/Field.js';
 /**
- * So the set is in the type and in the CHECK constraint, from one declaration.
- * FR : pour que l'ensemble soit dans le type et dans la contrainte CHECK, d'une déclaration.
- * `oneOf('draft', 'published', { default: 'draft' })`
+ * The set travels: GraphQL enum, form `select` and DDL `CHECK`, from this one declaration.
+ * FR : l'ensemble voyage : enum GraphQL, `select` du formulaire, `CHECK` du DDL.
+ * `oneOf('draft', 'published', { default: 'draft' })` → `{ type: 'string', enum: [...] }`
  */
 export function oneOf(...args) {
     const last = args[args.length - 1];

package/dist/vocabulary/primitive/primary.js

@@ -1,9 +1,9 @@
 import { Field } from '../../field/Field.js';
 import { Generators } from '../../axis/lifecycle/Generators.js';
 /**
- * So an id is generated and write-once by declaring nothing else.
- * FR : pour qu'un identifiant soit généré et écrit une fois sans rien déclarer d'autre.
- * `primary()` → cuid2, `update: 'forbidden'`; `primary(number())` → the same on a number
+ * `primary()` for a generated id; `primary(number())` to make a declared field the key.
+ * FR : `primary()` pour un identifiant généré ; `primary(number())` pour promouvoir un champ.
+ * `primary()` → `create: { generate: 'cuid2' }`, `update: 'forbidden'`
  */
 export function primary(fieldOrOptions) {
     if (Field.is(fieldOrOptions)) {

package/dist/vocabulary/primitive/ref.d.ts

@@ -3,10 +3,5 @@ import { Field } from '../../field/Field.js';
 export interface RefOptions {
     cascade?: boolean;
 }
-/**
- * So a reference names the target entity, and the column type follows from it.
- * FR : pour qu'une référence nomme l'entité cible, la colonne en découlant.
- * `ref(() => User, { cascade: true })`
- */
 export declare function ref<E extends EntityConstructor>(target: E | (() => E), opts?: RefOptions): Field<string>;
 //# sourceMappingURL=ref.d.ts.map

package/dist/vocabulary/primitive/ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/primitive/ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,iBAAiB,EAC7C,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EACrB,IAAI,CAAC,EAAE,UAAU,GAChB,KAAK,CAAC,MAAM,CAAC,CAKf"}
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/primitive/ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,GAAG,CAAC,CAAC,SAAS,iBAAiB,EAC7C,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EACrB,IAAI,CAAC,EAAE,UAAU,GAChB,KAAK,CAAC,MAAM,CAAC,CAKf"}

package/dist/vocabulary/primitive/ref.js

@@ -1,10 +1,5 @@
 import { Relation } from '../../axis/role/Relation.js';
 import { Field } from '../../field/Field.js';
-/**
- * So a reference names the target entity, and the column type follows from it.
- * FR : pour qu'une référence nomme l'entité cible, la colonne en découlant.
- * `ref(() => User, { cascade: true })`
- */
 export function ref(target, opts) {
     return new Field({
         shape: { type: 'string' },

package/dist/vocabulary/primitive/ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"ref.js","sourceRoot":"","sources":["../../../src/vocabulary/primitive/ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA0B,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAM7C;;;;GAIG;AACH,MAAM,UAAU,GAAG,CACjB,MAAqB,EACrB,IAAiB;IAEjB,OAAO,IAAI,KAAK,CAAS;QACvB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE;KACxD,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../../../src/vocabulary/primitive/ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA0B,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAM7C,MAAM,UAAU,GAAG,CACjB,MAAqB,EACrB,IAAiB;IAEjB,OAAO,IAAI,KAAK,CAAS;QACvB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE;KACxD,CAAC,CAAC;AACL,CAAC"}

package/dist/vocabulary/primitive/text.d.ts

@@ -8,10 +8,5 @@ export interface TextOptions {
     default?: string;
     description?: string;
 }
-/**
- * So a string field states its bounds where the DDL and the validator both read them.
- * FR : pour qu'un champ texte énonce ses bornes là où le DDL et le juge les lisent.
- * `text({ max: 200, format: 'email' })`
- */
 export declare function text(opts?: TextOptions): Field<string>;
 //# sourceMappingURL=text.d.ts.map

package/dist/vocabulary/primitive/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/primitive/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAatD"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/primitive/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAatD"}

package/dist/vocabulary/primitive/text.js

@@ -1,9 +1,4 @@
 import { Field } from '../../field/Field.js';
-/**
- * So a string field states its bounds where the DDL and the validator both read them.
- * FR : pour qu'un champ texte énonce ses bornes là où le DDL et le juge les lisent.
- * `text({ max: 200, format: 'email' })`
- */
 export function text(opts) {
     return new Field({
         shape: {

package/dist/vocabulary/primitive/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/vocabulary/primitive/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAY7C;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,IAAkB;IACrC,OAAO,IAAI,KAAK,CAAS;QACvB,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI,EAAE,GAAG;YACpB,SAAS,EAAE,IAAI,EAAE,GAAG;YACpB,OAAO,EAAE,IAAI,EAAE,OAAO;YACtB,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB;QACD,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"}
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/vocabulary/primitive/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAY7C,MAAM,UAAU,IAAI,CAAC,IAAkB;IACrC,OAAO,IAAI,KAAK,CAAS;QACvB,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI,EAAE,GAAG;YACpB,SAAS,EAAE,IAAI,EAAE,GAAG;YACpB,OAAO,EAAE,IAAI,EAAE,OAAO;YACtB,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB;QACD,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/rule/immutable.d.ts

@@ -1,8 +1,3 @@
 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/rule/immutable.d.ts.map

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

package/dist/vocabulary/rule/immutable.js

@@ -1,9 +1,4 @@
 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/rule/immutable.js.map

@@ -1 +1 @@
-{"version":3,"file":"immutable.js","sourceRoot":"","sources":["../../../src/vocabulary/rule/immutable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;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"}
+{"version":3,"file":"immutable.js","sourceRoot":"","sources":["../../../src/vocabulary/rule/immutable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,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/rule/indexed.d.ts

@@ -1,8 +1,3 @@
 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/rule/indexed.d.ts.map

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

package/dist/vocabulary/rule/indexed.js

@@ -1,9 +1,4 @@
 import { vocabulary } from '../vocabulary.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 const indexed = vocabulary('indexed', () => ({
     role: { index: true },
 }));

package/dist/vocabulary/rule/indexed.js.map

@@ -1 +1 @@
-{"version":3,"file":"indexed.js","sourceRoot":"","sources":["../../../src/vocabulary/rule/indexed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;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"}
+{"version":3,"file":"indexed.js","sourceRoot":"","sources":["../../../src/vocabulary/rule/indexed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,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/rule/nullable.d.ts

@@ -1,8 +1,8 @@
 import { type Field } from '../../field/Field.js';
 /**
- * So `null` becomes a legal value, without touching whether the field is required.
- * FR : pour que `null` devienne légal, sans toucher au caractère obligatoire du champ.
- * `nullable(text())` → `{ type: ['string', 'null'] }`, still required at create
+ * Adds `null` and leaves the field REQUIRED — `optional()` is the one permitting absence.
+ * FR : ajoute `null` en laissant le champ OBLIGATOIRE — `optional()` permet l'absence.
+ * `nullable(text())` → `{ type: ['string', 'null'] }`, and `validate({})` still refuses
  */
 export declare const nullable: <T>(field: Field<T>) => Field<T | null>;
 //# sourceMappingURL=nullable.d.ts.map

package/dist/vocabulary/rule/nullable.js

@@ -1,9 +1,9 @@
 import { vocabulary } from '../vocabulary.js';
 import { Shapes } from '../../axis/shape/Shape.js';
 /**
- * So `null` becomes a legal value, without touching whether the field is required.
- * FR : pour que `null` devienne légal, sans toucher au caractère obligatoire du champ.
- * `nullable(text())` → `{ type: ['string', 'null'] }`, still required at create
+ * Adds `null` and leaves the field REQUIRED — `optional()` is the one permitting absence.
+ * FR : ajoute `null` en laissant le champ OBLIGATOIRE — `optional()` permet l'absence.
+ * `nullable(text())` → `{ type: ['string', 'null'] }`, and `validate({})` still refuses
  */
 export const nullable = vocabulary('nullable', (field) => ({
     shape: Shapes.nullable(field.shape),

package/dist/vocabulary/rule/optional.d.ts

@@ -1,8 +1,8 @@
 import { type Field } from '../../field/Field.js';
 /**
- * So the two questions are settled at once: `null` is legal, and absence is too.
- * FR : pour que les deux questions soient réglées d'un coup : `null` légal, absence permise.
- * `optional(text())` → nullable shape and `create: 'optional'`
+ * Adds `null` AND permits absence. A field that already states a `create` rule keeps it.
+ * FR : ajoute `null` ET permet l'absence. Un champ qui énonce déjà un `create` le garde.
+ * `optional(text())` → `{ type: ['string', 'null'] }` and `create: 'optional'`
  */
 export declare const optional: <T>(field: Field<T>) => Field<T | null>;
 //# sourceMappingURL=optional.d.ts.map

package/dist/vocabulary/rule/optional.js

@@ -1,9 +1,9 @@
 import { vocabulary } from '../vocabulary.js';
 import { Shapes } from '../../axis/shape/Shape.js';
 /**
- * So the two questions are settled at once: `null` is legal, and absence is too.
- * FR : pour que les deux questions soient réglées d'un coup : `null` légal, absence permise.
- * `optional(text())` → nullable shape and `create: 'optional'`
+ * Adds `null` AND permits absence. A field that already states a `create` rule keeps it.
+ * FR : ajoute `null` ET permet l'absence. Un champ qui énonce déjà un `create` le garde.
+ * `optional(text())` → `{ type: ['string', 'null'] }` and `create: 'optional'`
  */
 export const optional = vocabulary('optional', (field) => ({
     shape: Shapes.nullable(field.shape),

package/dist/vocabulary/rule/readOnly.d.ts

@@ -1,8 +1,8 @@
 import { Field } from '../../field/Field.js';
 /**
- * So a field a client may read but never write says so once, on the field.
- * FR : pour qu'un champ lisible mais non écrivable le dise une fois, sur le champ.
- * `readOnly(text())` → `boundary.in` is `'closed'`, absent from every form
+ * Closes the way in, so the field leaves `Visibility.input` and every form derived from it.
+ * FR : ferme l'entrée : le champ quitte `Visibility.input` et tout formulaire qui en dérive.
+ * `readOnly(text())` → `boundary.in` is `'closed'`
  */
 export declare const readOnly: <T>(field: Field<T>) => Field<T>;
 //# sourceMappingURL=readOnly.d.ts.map

package/dist/vocabulary/rule/readOnly.js

@@ -1,11 +1,11 @@
 import { vocabulary } from '../vocabulary.js';
 import { Boundary } from '../../axis/boundary/Boundary.js';
 /**
- * So a field a client may read but never write says so once, on the field.
- * FR : pour qu'un champ lisible mais non écrivable le dise une fois, sur le champ.
- * `readOnly(text())` → `boundary.in` is `'closed'`, absent from every form
+ * Closes the way in, so the field leaves `Visibility.input` and every form derived from it.
+ * FR : ferme l'entrée : le champ quitte `Visibility.input` et tout formulaire qui en dérive.
+ * `readOnly(text())` → `boundary.in` is `'closed'`
  */
 export const readOnly = vocabulary('readOnly', (field) => ({
-    boundary: Boundary.declared(field).with({ in: 'closed' }),
+    boundary: Boundary.declared(field).declaring({ in: 'closed' }),
 }));
 //# sourceMappingURL=readOnly.js.map

package/dist/vocabulary/rule/readOnly.js.map

@@ -1 +1 @@
-{"version":3,"file":"readOnly.js","sourceRoot":"","sources":["../../../src/vocabulary/rule/readOnly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAqC,UAAU,CAClE,UAAU,EACV,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACV,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;CAC1D,CAAC,CACH,CAAC"}
+{"version":3,"file":"readOnly.js","sourceRoot":"","sources":["../../../src/vocabulary/rule/readOnly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAqC,UAAU,CAClE,UAAU,EACV,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACV,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;CAC/D,CAAC,CACH,CAAC"}

package/dist/vocabulary/rule/unique.d.ts

@@ -1,8 +1,3 @@
 import { Field } from '../../field/Field.js';
-/**
- * So a field is unique on its own, whatever key it ends up under.
- * FR : pour qu'un champ soit unique à lui seul, quelle que soit sa clé.
- * `unique(email)` → `role.unique` is true
- */
 export declare const unique: <T>(field: Field<T>) => Field<T>;
 //# sourceMappingURL=unique.d.ts.map

package/dist/vocabulary/rule/unique.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unique.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/rule/unique.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAEjD,CAAC"}
+{"version":3,"file":"unique.d.ts","sourceRoot":"","sources":["../../../src/vocabulary/rule/unique.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAEjD,CAAC"}

package/dist/vocabulary/rule/unique.js

@@ -1,9 +1,4 @@
 import { vocabulary } from '../vocabulary.js';
-/**
- * So a field is unique on its own, whatever key it ends up under.
- * FR : pour qu'un champ soit unique à lui seul, quelle que soit sa clé.
- * `unique(email)` → `role.unique` is true
- */
 export const unique = vocabulary('unique', () => ({
     role: { unique: true },
 }));