@fougere/schema 0.6.0-alpha.0 → 0.7.0-alpha.0

package/dist/{schema/SchemaView.d.ts → SchemaView.d.ts}

@@ -1,13 +1,13 @@
-import type { Field, Fields } from './fields/Field.js';
-import type { CompositeUnique, PreviousNames } from '../entity/EntityDeclarations.js';
-import type { EntityAdapters } from '../entity/EntityAdapters.js';
-import type { ValidationResult } from '../judge/result.js';
-import type { ValidateOptions } from '../judge/options.js';
+import type { Field, Fields } from './field/Field.js';
+import type { CompositeUnique, PreviousNames } from './entity/EntityDeclarations.js';
+import type { EntityAdapters } from './entity/EntityAdapters.js';
+import type { ValidationResult } from './validation.js';
+import type { ValidateOptions } from './validator/InputValidator.js';
 import type { SchemaDerivation } from './SchemaDerivation.js';
-export type Row<TFields extends Fields> = {
+export type Values<TFields extends Fields> = {
     [K in keyof TFields]: TFields[K] extends Field<infer T> ? T : never;
 };
-export type PartialRow<TFields extends Fields> = Partial<Row<TFields>>;
+export type PartialValues<TFields extends Fields> = Partial<Values<TFields>>;
 export interface SchemaView<TFields extends Fields = Fields> {
     readonly name: string;
     /** What this schema was cut from, when it was cut from anything. */
@@ -17,9 +17,9 @@ export interface SchemaView<TFields extends Fields = Fields> {
     /** Does it hold rows of its own? False on a derivation means an answer. */
     readonly anchored?: boolean;
     getFields(): TFields;
-    getAdapters(): EntityAdapters<TFields> | undefined;
+    getAdapters(): EntityAdapters<TFields>;
     getUnique(): CompositeUnique<TFields> | undefined;
     getOpts(): ValidateOptions;
-    validate(input: unknown): ValidationResult<Row<TFields>>;
+    validate(input: unknown): ValidationResult<Values<TFields>>;
 }
 //# sourceMappingURL=SchemaView.d.ts.map

package/dist/SchemaView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaView.d.ts","sourceRoot":"","sources":["../src/SchemaView.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,MAAM,CAAC,OAAO,SAAS,MAAM,IAAI;KAC1C,CAAC,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CACpE,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAE7E,MAAM,WAAW,UAAU,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IACvC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,IAAI,OAAO,CAAC;IACrB,WAAW,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;IACvC,SAAS,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAClD,OAAO,IAAI,eAAe,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;CAC7D"}

package/dist/{schema/SchemaView.js.map → SchemaView.js.map}

@@ -1 +1 @@
-{"version":3,"file":"SchemaView.js","sourceRoot":"","sources":["../../src/schema/SchemaView.ts"],"names":[],"mappings":""}
+{"version":3,"file":"SchemaView.js","sourceRoot":"","sources":["../src/SchemaView.ts"],"names":[],"mappings":""}

package/dist/{schema/axis → axis}/Axis.d.ts

@@ -1,7 +1,7 @@
-import type { ValidationError } from '../../judge/result.js';
+import type { ValidationError } from '../validation.js';
 export interface Axis<Declared = unknown, Wire = unknown> {
     readonly slot: 'role' | 'lifecycle' | 'boundary';
-    judge(value: unknown, errors: ValidationError[]): void;
+    validator(value: unknown, errors: ValidationError[]): void;
     describe(value: Declared, key: string): Wire | undefined;
     reconstruct(wire: Wire, resolve?: Resolver): Declared;
 }

package/dist/axis/Axis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Axis.d.ts","sourceRoot":"","sources":["../../src/axis/Axis.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IAEjD,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAE3D,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEzD,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACvD;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;AAElG,eAAO,MAAM,cAAc,EAAE,SAAS,IAAI,EAIzC,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,eAAe,uCAA0C,CAAC"}

package/dist/axis/Axis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Axis.js","sourceRoot":"","sources":["../../src/axis/Axis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAe1D,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,QAAQ;IACR,aAAa;IACb,YAAY;CACb,CAAC;AAEF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/axis/Meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Meta.d.ts","sourceRoot":"","sources":["../../src/axis/Meta.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/{schema/axis → axis}/Meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"Meta.js","sourceRoot":"","sources":["../../../src/schema/axis/Meta.ts"],"names":[],"mappings":""}
+{"version":3,"file":"Meta.js","sourceRoot":"","sources":["../../src/axis/Meta.ts"],"names":[],"mappings":""}

package/dist/axis/boundary/Boundaries.d.ts

@@ -0,0 +1,21 @@
+import type { BoundaryRules } from './Boundary.js';
+import { Registry } from '../../lib/Registry.js';
+export type Decoder = (value: unknown) => {
+    value: unknown;
+} | {
+    error: string;
+};
+export type Encoder = (value: unknown) => unknown;
+/**
+ * `decoders` for a value coming in, `encoders` for one going out, `aliases` for the word
+ * that names a pair. Three registries, so a codec is never half declared.
+ * FR : `decoders` à l'entrée, `encoders` à la sortie, `aliases` pour le mot qui nomme la paire.
+ * `Boundaries.aliases.register('isoDate', { in: { decode: 'isoDate' }, out: { encode: 'isoDate' } })`
+ * → a field saying `boundary: 'isoDate'` decodes to a `Date` and leaves as a string
+ */
+export declare const Boundaries: {
+    decoders: Registry<Decoder>;
+    encoders: Registry<Encoder>;
+    aliases: Registry<BoundaryRules>;
+};
+//# sourceMappingURL=Boundaries.d.ts.map

package/dist/axis/boundary/Boundaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Boundaries.d.ts","sourceRoot":"","sources":["../../../src/axis/boundary/Boundaries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACjF,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;IACrB,QAAQ;IAIR,QAAQ;IAIR,OAAO;CACR,CAAC"}

package/dist/axis/boundary/Boundaries.js

@@ -0,0 +1,25 @@
+import { Registry } from '../../lib/Registry.js';
+/**
+ * `decoders` for a value coming in, `encoders` for one going out, `aliases` for the word
+ * that names a pair. Three registries, so a codec is never half declared.
+ * FR : `decoders` à l'entrée, `encoders` à la sortie, `aliases` pour le mot qui nomme la paire.
+ * `Boundaries.aliases.register('isoDate', { in: { decode: 'isoDate' }, out: { encode: 'isoDate' } })`
+ * → a field saying `boundary: 'isoDate'` decodes to a `Date` and leaves as a string
+ */
+export const Boundaries = {
+    decoders: new Registry('boundary decoder', 'call Boundaries.decoders.register(name, fn)'),
+    encoders: new Registry('boundary encoder', 'call Boundaries.encoders.register(name, fn)'),
+    aliases: new Registry('boundary alias'),
+};
+Boundaries.decoders.register('isoDate', (value) => {
+    if (value instanceof Date)
+        return { value };
+    if (typeof value === 'string') {
+        const date = new Date(value);
+        return Number.isNaN(date.getTime()) ? { error: 'Invalid date' } : { value: date };
+    }
+    return { error: 'Expected a date' };
+});
+Boundaries.encoders.register('isoDate', (value) => value instanceof Date ? value.toISOString() : value);
+Boundaries.aliases.register('isoDate', { in: { decode: 'isoDate' }, out: { encode: 'isoDate' } });
+//# sourceMappingURL=Boundaries.js.map

package/dist/axis/boundary/Boundaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Boundaries.js","sourceRoot":"","sources":["../../../src/axis/boundary/Boundaries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKjD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,IAAI,QAAQ,CACpB,kBAAkB,EAClB,6CAA6C,CAC9C;IACD,QAAQ,EAAE,IAAI,QAAQ,CACpB,kBAAkB,EAClB,6CAA6C,CAC9C;IACD,OAAO,EAAE,IAAI,QAAQ,CAAgB,gBAAgB,CAAC;CACvD,CAAC;AAEF,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;IAChD,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACpF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;AACtC,CAAC,CAAC,CAAC;AACH,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAChD,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CACpD,CAAC;AACF,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC"}

package/dist/{schema/axis → axis}/boundary/Boundary.d.ts

@@ -1,5 +1,5 @@
 import type { Decoder, Encoder } from './Boundaries.js';
-import type { Field } from '../../fields/Field.js';
+import type { Field } from '../../field/Field.js';
 import { type Shape } from '../shape/Shape.js';
 export interface BoundaryRules {
     in?: 'closed' | {
@@ -16,8 +16,10 @@ export declare class Boundary implements BoundaryRules {
     readonly decode: Decoder;
     readonly encode: Encoder;
     private constructor();
+    /** An unknown alias stops here. */
     static declared(field: Field): Boundary;
     static of(field: Field): Boundary;
+    /** `date-time` means a `Date` on both sides, without a word in the entity. */
     static forShape(shape: Shape | undefined): Boundary;
     with(overrides: BoundaryRules): Boundary;
     get readOnly(): boolean;

package/dist/axis/boundary/Boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Boundary.d.ts","sourceRoot":"","sources":["../../../src/axis/boundary/Boundary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAU,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,QAAQ,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,GAAG,CAAC,EAAE,QAAQ,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACrC;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,aAAa,CAAC;AAKpE,qBAAa,QAAS,YAAW,aAAa;IAC5C,QAAQ,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,OAAO,eAQN;IAED,mCAAmC;IACnC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAQtC;IAED,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAiBhC;IAED,8EAA8E;IAC9E,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,CAMlD;IAED,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,QAAQ,CAEvC;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF"}

package/dist/{schema/axis → axis}/boundary/Boundary.js

@@ -1,5 +1,5 @@
 import { Boundaries } from './Boundaries.js';
-import { Anatomy } from '../shape/Shape.js';
+import { Shapes } from '../shape/Shape.js';
 const identityDecoder = (value) => ({ value });
 const identityEncoder = (value) => value;
 export class Boundary {
@@ -13,13 +13,14 @@ export class Boundary {
         this.decode = codecs?.decode ?? identityDecoder;
         this.encode = codecs?.encode ?? identityEncoder;
     }
+    /** An unknown alias stops here. */
     static declared(field) {
         const ref = field.boundary;
         if (ref === undefined)
             return new Boundary();
         if (typeof ref !== 'string')
             return new Boundary(ref);
-        const alias = Boundaries.alias(ref);
+        const alias = Boundaries.aliases.find(ref);
         if (!alias)
             throw new Error(`Unknown boundary alias: '${ref}'`);
         return new Boundary(alias);
@@ -33,17 +34,18 @@ export class Boundary {
         };
         return new Boundary(rules, {
             decode: typeof rules.in === 'object'
-                ? Boundaries.decoder(rules.in.decode)
+                ? Boundaries.decoders.resolve(rules.in.decode)
                 : identityDecoder,
             encode: typeof rules.out === 'object'
-                ? Boundaries.encoder(rules.out.encode)
+                ? Boundaries.encoders.resolve(rules.out.encode)
                 : identityEncoder,
         });
     }
+    /** `date-time` means a `Date` on both sides, without a word in the entity. */
     static forShape(shape) {
-        const base = Anatomy.of(shape).base;
+        const base = Shapes.of(shape).base;
         if (base?.type === 'string' && base.format === 'date-time') {
-            return new Boundary(Boundaries.alias('isoDate'));
+            return new Boundary(Boundaries.aliases.find('isoDate'));
         }
         return new Boundary();
     }

package/dist/axis/boundary/Boundary.js.map

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

package/dist/axis/boundary/BoundaryAxis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundaryAxis.d.ts","sourceRoot":"","sources":["../../../src/axis/boundary/BoundaryAxis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,eAAO,MAAM,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CA0BvD,CAAC"}

package/dist/{schema/axis → axis}/boundary/BoundaryAxis.js

@@ -1,8 +1,8 @@
-import { admitWire } from '../../../projection/card/admission.js';
-import { isObject } from '../../../utils.js';
+import { admitWire } from '../../projection/card/admission.js';
+import { isObject } from '../../lib/utils.js';
 export const boundaryAxis = {
     slot: 'boundary',
-    judge(value, errors) {
+    validator(value, errors) {
         if (typeof value === 'string')
             return;
         if (!isObject(value)) {
@@ -23,7 +23,7 @@ export const boundaryAxis = {
     },
     describe: (value) => value,
     reconstruct: (wire) => {
-        admitWire(boundaryAxis.judge, wire, 'boundary');
+        admitWire(boundaryAxis.validator, wire, 'boundary');
         return wire;
     },
 };

package/dist/axis/boundary/BoundaryAxis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundaryAxis.js","sourceRoot":"","sources":["../../../src/axis/boundary/BoundaryAxis.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,MAAM,CAAC,MAAM,YAAY,GAAmC;IAC1D,IAAI,EAAE,UAAU;IAEhB,SAAS,CAAC,KAAK,EAAE,MAAM;QACrB,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO;QACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,+CAA+C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;aAChF,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAU,EAAE,CAAC;YAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ;gBAAE,SAAS;YACtD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACtD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE,EAAE,OAAO,EAAE,0BAA0B,IAAI,YAAY,EAAE,CAAC,CAAC;YACjG,CAAC;QACH,CAAC;IACH,CAAC;IAED,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;IAC1B,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;QACpB,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/{schema/axis → axis}/lifecycle/Clock.d.ts

@@ -12,7 +12,7 @@
 export declare class Clock {
     private static reading;
     static now(): number;
-    /** Freeze the instant this clock reads. Returns the gesture that restores it. */
+    /** One substitution moves time for every stamp in the process at once. */
     static freeze(at: number | Date): () => void;
 }
 //# sourceMappingURL=Clock.d.ts.map

package/dist/axis/lifecycle/Clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Clock.d.ts","sourceRoot":"","sources":["../../../src/axis/lifecycle/Clock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAC,OAAO,CAA0B;IAEhD,MAAM,CAAC,GAAG,IAAI,MAAM,CAEnB;IAED,0EAA0E;IAC1E,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,IAAI,CAK3C;CACF"}

package/dist/{schema/axis → axis}/lifecycle/Clock.js

@@ -14,7 +14,7 @@ export class Clock {
     static now() {
         return this.reading();
     }
-    /** Freeze the instant this clock reads. Returns the gesture that restores it. */
+    /** One substitution moves time for every stamp in the process at once. */
     static freeze(at) {
         const previous = this.reading;
         const instant = at instanceof Date ? at.getTime() : at;

package/dist/axis/lifecycle/Clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Clock.js","sourceRoot":"","sources":["../../../src/axis/lifecycle/Clock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,KAAK;IACR,MAAM,CAAC,OAAO,GAAiB,IAAI,CAAC,GAAG,CAAC;IAEhD,MAAM,CAAC,GAAG;QACR,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED,0EAA0E;IAC1E,MAAM,CAAC,MAAM,CAAC,EAAiB;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,MAAM,OAAO,GAAG,EAAE,YAAY,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC;QAC7B,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/axis/lifecycle/Generators.d.ts

@@ -0,0 +1,10 @@
+import { Registry } from '../../lib/Registry.js';
+export type GeneratorRef = 'cuid2' | 'uuid' | 'nanoid' | (string & {});
+/**
+ * Who answers a `generate:` name. `cuid2`, `uuid` and `nanoid` are registered like any
+ * other, so `Generators.resolve('ulid')` is refused here and lists the three.
+ * FR : pour qu'un `generate:` soit répondu par un registre, builtins compris.
+ * `Generators.register('ulid', ulid)` → `create: { generate: 'ulid' }` now resolves
+ */
+export declare const Generators: Registry<() => string>;
+//# sourceMappingURL=Generators.d.ts.map

package/dist/axis/lifecycle/Generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Generators.d.ts","sourceRoot":"","sources":["../../../src/axis/lifecycle/Generators.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAUvE;;;;;GAKG;AACH,eAAO,MAAM,UAAU,iBAAsB,MAAM,CAQlD,CAAC"}

package/dist/axis/lifecycle/Generators.js

@@ -0,0 +1,20 @@
+import { createId } from '@paralleldrive/cuid2';
+import { Registry } from '../../lib/Registry.js';
+const NANOID_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+function nanoid() {
+    const bytes = new Uint8Array(21);
+    globalThis.crypto.getRandomValues(bytes);
+    return Array.from(bytes, (byte) => NANOID_ALPHABET[byte & 63]).join('');
+}
+/**
+ * Who answers a `generate:` name. `cuid2`, `uuid` and `nanoid` are registered like any
+ * other, so `Generators.resolve('ulid')` is refused here and lists the three.
+ * FR : pour qu'un `generate:` soit répondu par un registre, builtins compris.
+ * `Generators.register('ulid', ulid)` → `create: { generate: 'ulid' }` now resolves
+ */
+export const Generators = new Registry('generator', 'call Generators.register(name, fn)', [
+    ['cuid2', createId],
+    ['uuid', () => globalThis.crypto.randomUUID()],
+    ['nanoid', nanoid],
+]);
+//# sourceMappingURL=Generators.js.map

package/dist/axis/lifecycle/Generators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Generators.js","sourceRoot":"","sources":["../../../src/axis/lifecycle/Generators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAIjD,MAAM,eAAe,GAAG,kEAAkE,CAAC;AAE3F,SAAS,MAAM;IACb,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,QAAQ,CACpC,WAAW,EACX,oCAAoC,EACpC;IACE,CAAC,OAAO,EAAE,QAAQ,CAAC;IACnB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAC9C,CAAC,QAAQ,EAAE,MAAM,CAAC;CACnB,CACF,CAAC"}

package/dist/axis/lifecycle/Lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lifecycle.d.ts","sourceRoot":"","sources":["../../../src/axis/lifecycle/Lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,eAAO,MAAM,aAAa,YAAI,KAAK,EAAE,UAAU,CAAU,CAAC;AAC1D,eAAO,MAAM,aAAa,YAAI,KAAK,EAAE,WAAW,CAAU,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1F,MAAM,CAAC,EAAE,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;CACzC;AAED,qBAAa,SAAU,YAAW,cAAc;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE3C,OAAO,eAGN;IAED,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,SAAS,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,SAAS,CAE1D;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,IAAI,OAAO,IAAI;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAK5C;IAED,IAAI,SAAS,IAAI,YAAY,GAAG,SAAS,CAKxC;CACF"}

package/dist/axis/lifecycle/Lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lifecycle.js","sourceRoot":"","sources":["../../../src/axis/lifecycle/Lifecycle.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,UAAU,CAAU,CAAC;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,WAAW,CAAU,CAAC;AAO3D,MAAM,OAAO,SAAS;IACX,MAAM,CAA4B;IAClC,MAAM,CAA4B;IAE3C,YAAoB,KAAK,GAAmB,EAAE;QAC5C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,KAAqC;QAC7C,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IACnC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC;IACxD,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC;IACrC,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC;IAC/B,CAAC;IAED,IAAI,OAAO;QACT,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,IAAI;YACjE,CAAC,CAAC,EAAE,KAAK,EAAG,IAA2B,CAAC,KAAK,EAAE;YAC/C,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAED,IAAI,SAAS;QACX,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,UAAU,IAAI,IAAI;YACpE,CAAC,CAAE,IAAmC,CAAC,QAAQ;YAC/C,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;CACF"}

package/dist/axis/lifecycle/LifecycleAxis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LifecycleAxis.d.ts","sourceRoot":"","sources":["../../../src/axis/lifecycle/LifecycleAxis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnF,eAAO,MAAM,aAAa,EAAE,IAAI,CAAC,cAAc,EAAE,cAAc,CAsB9D,CAAC"}

package/dist/{schema/axis → axis}/lifecycle/LifecycleAxis.js

@@ -1,15 +1,15 @@
-import { admitWire, oneOfTokens } from '../../../projection/card/admission.js';
-import { isObject } from '../../../utils.js';
+import { admitWire, oneOfTokens } from '../../projection/card/admission.js';
+import { isObject } from '../../lib/utils.js';
 import { CREATE_TOKENS, UPDATE_TOKENS } from './Lifecycle.js';
 export const lifecycleAxis = {
     slot: 'lifecycle',
-    judge(value, errors) {
+    validator(value, errors) {
         if (!isObject(value)) {
             errors.push({ path: 'lifecycle', message: `Expected an object — got ${JSON.stringify(value)}` });
             return;
         }
         if (value.create !== undefined)
-            judgeCreate(value.create, errors);
+            validateCreate(value.create, errors);
         if (value.update !== undefined && !oneOfTokens(value.update, UPDATE_TOKENS)) {
             errors.push({
                 path: 'lifecycle.update',
@@ -19,11 +19,16 @@ export const lifecycleAxis = {
     },
     describe: (value) => value,
     reconstruct: (wire) => {
-        admitWire(lifecycleAxis.judge, wire, 'lifecycle');
+        admitWire(lifecycleAxis.validator, wire, 'lifecycle');
         return wire;
     },
 };
-function judgeCreate(rule, errors) {
+/**
+ * So the four legal ways to declare a creation are stated once, and anything else names them.
+ * FR : pour que les quatre façons de déclarer une création soient dites une fois.
+ * `create: 3` → `Expected 'now', 'optional', { value } or { generate } — got 3`
+ */
+function validateCreate(rule, errors) {
     if (oneOfTokens(rule, CREATE_TOKENS))
         return;
     if (isObject(rule)) {

package/dist/axis/lifecycle/LifecycleAxis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LifecycleAxis.js","sourceRoot":"","sources":["../../../src/axis/lifecycle/LifecycleAxis.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAuB,MAAM,gBAAgB,CAAC;AAEnF,MAAM,CAAC,MAAM,aAAa,GAAyC;IACjE,IAAI,EAAE,WAAW;IAEjB,SAAS,CAAC,KAAK,EAAE,MAAM;QACrB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,4BAA4B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACjG,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC;YAC5E,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,uCAAuC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;aAC/E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;IAC1B,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;QACpB,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF;;;;GAIG;AACH,SAAS,cAAc,CAAC,IAAa,EAAE,MAAyB;IAC9D,IAAI,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC;QAAE,OAAO;IAC7C,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,IAAI,OAAO,IAAI,IAAI;YAAE,OAAO;QAC5B,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACtC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,2BAA2B;oBACjC,OAAO,EAAE,mCAAmC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;iBAC5E,CAAC,CAAC;YACL,CAAC;YACD,OAAO;QACT,CAAC;IACH,CAAC;IACD,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,+DAA+D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;KAC/F,CAAC,CAAC;AACL,CAAC"}

package/dist/axis/lifecycle/apply.d.ts

@@ -0,0 +1,15 @@
+import { type Fields } from '../../field/Field.js';
+/**
+ * So every storage realizes a create the same way.
+ * FR : pour que chaque storage réalise une création de la même façon.
+ * `applyCreate({ id: primary(), createdAt: created() }, { title: 'a' })`
+ * → `id` generated, `createdAt` stamped, `title` untouched
+ */
+export declare function applyCreate(fields: Fields, input: Record<string, unknown>): Record<string, unknown>;
+/**
+ * So `updated()` is stamped by the storage, and no handler has to remember it.
+ * FR : pour qu'`updated()` soit estampé par le storage, pas par le handler.
+ * `applyUpdate(fields, { title: 'b' })` → `updatedAt` added, nothing else
+ */
+export declare function applyUpdate(fields: Fields, patch: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=apply.d.ts.map

package/dist/axis/lifecycle/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/axis/lifecycle/apply.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAcnG;AAYD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUnG"}

package/dist/axis/lifecycle/apply.js

@@ -0,0 +1,50 @@
+import { Lifecycle } from './Lifecycle.js';
+import { Generators } from './Generators.js';
+import { Clock } from './Clock.js';
+/**
+ * So every storage realizes a create the same way.
+ * FR : pour que chaque storage réalise une création de la même façon.
+ * `applyCreate({ id: primary(), createdAt: created() }, { title: 'a' })`
+ * → `id` generated, `createdAt` stamped, `title` untouched
+ */
+export function applyCreate(fields, input) {
+    const values = { ...input };
+    const instant = Clock.now();
+    for (const [name, field] of Object.entries(fields)) {
+        if (name in values)
+            continue;
+        const rule = Lifecycle.of(field);
+        if (rule.create === 'now')
+            values[name] = new Date(instant);
+        else if (rule.literal)
+            values[name] = freshValue(rule.literal.value);
+        else if (rule.generator)
+            values[name] = Generators.resolve(rule.generator)();
+    }
+    return values;
+}
+/**
+ * So two rows created from one declared default never end up sharing the same object.
+ * FR : pour que deux lignes nées d'un même défaut ne partagent pas l'objet.
+ * `create: { value: [] }` → each instance gets its own array
+ */
+function freshValue(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    return structuredClone(value);
+}
+/**
+ * So `updated()` is stamped by the storage, and no handler has to remember it.
+ * FR : pour qu'`updated()` soit estampé par le storage, pas par le handler.
+ * `applyUpdate(fields, { title: 'b' })` → `updatedAt` added, nothing else
+ */
+export function applyUpdate(fields, patch) {
+    const values = { ...patch };
+    const instant = Clock.now();
+    for (const [name, field] of Object.entries(fields)) {
+        if (Lifecycle.of(field).stampedOnUpdate && !(name in values))
+            values[name] = new Date(instant);
+    }
+    return values;
+}
+//# sourceMappingURL=apply.js.map

package/dist/axis/lifecycle/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/axis/lifecycle/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,KAA8B;IACxE,MAAM,MAAM,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IAE5B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAsB,EAAE,CAAC;QACxE,IAAI,IAAI,IAAI,MAAM;YAAE,SAAS;QAC7B,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAEjC,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;aACvD,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;aAChE,IAAI,IAAI,CAAC,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;IAC/E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,KAA8B;IACxE,MAAM,MAAM,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IAE5B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAsB,EAAE,CAAC;QACxE,IAAI,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/{schema/axis → axis}/role/Relation.d.ts

@@ -7,13 +7,14 @@ export interface Relation {
     onDelete?: (typeof ON_DELETE)[number];
 }
 /**
- * How a relation is built — the one place a target becomes a thunk.
+ * How a relation is built — the one place a target becomes `() => Entity`.
  *
  * A target arrives as the class or as a function returning it, because a cycle between two
  * entities can only be written the second way. Recognised by FORM, `getFields` on the
- * value: a class answers it, a thunk does not.
+ * value: a class answers it, `() => Post` does not.
  */
 export declare const Relation: {
+    /** `() => Post` so two entities can point at each other. */
     one(target: EntityConstructor | (() => EntityConstructor), cascade?: boolean): Relation;
     many(target: EntityConstructor | (() => EntityConstructor)): Relation;
 };

package/dist/axis/role/Relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Relation.d.ts","sourceRoot":"","sources":["../../../src/axis/role/Relation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAErE,eAAO,MAAM,cAAc,YAAI,KAAK,EAAE,MAAM,CAAU,CAAC;AACvD,eAAO,MAAM,SAAS,YAAI,SAAS,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;AAEtE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,iBAAiB,CAAC;IAC5B,IAAI,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;CACvC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ;IACnB,4DAA4D;IAC5D,GAAG,SAAS,iBAAiB,GAAG,CAAC,MAAM,iBAAiB,CAAC,YAAY,OAAO,GAAG,QAAQ;IAIvF,IAAI,SAAS,iBAAiB,GAAG,CAAC,MAAM,iBAAiB,CAAC,GAAG,QAAQ;CAGtE,CAAC"}

package/dist/{schema/axis → axis}/role/Relation.js

@@ -1,21 +1,22 @@
 export const RELATION_KINDS = ['one', 'many'];
 export const ON_DELETE = ['cascade', 'restrict', 'set null'];
 /**
- * How a relation is built — the one place a target becomes a thunk.
+ * How a relation is built — the one place a target becomes `() => Entity`.
  *
  * A target arrives as the class or as a function returning it, because a cycle between two
  * entities can only be written the second way. Recognised by FORM, `getFields` on the
- * value: a class answers it, a thunk does not.
+ * value: a class answers it, `() => Post` does not.
  */
 export const Relation = {
+    /** `() => Post` so two entities can point at each other. */
     one(target, cascade) {
-        return { to: thunk(target), kind: 'one', onDelete: cascade ? 'cascade' : undefined };
+        return { to: normalizeTarget(target), kind: 'one', onDelete: cascade ? 'cascade' : undefined };
     },
     many(target) {
-        return { to: thunk(target), kind: 'many' };
+        return { to: normalizeTarget(target), kind: 'many' };
     },
 };
-function thunk(target) {
+function normalizeTarget(target) {
     return 'getFields' in target ? () => target : target;
 }
 //# sourceMappingURL=Relation.js.map

package/dist/axis/role/Relation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Relation.js","sourceRoot":"","sources":["../../../src/axis/role/Relation.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AACvD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;AAQtE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,4DAA4D;IAC5D,GAAG,CAAC,MAAqD,EAAE,OAAiB;QAC1E,OAAO,EAAE,EAAE,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IACjG,CAAC;IAED,IAAI,CAAC,MAAqD;QACxD,OAAO,EAAE,EAAE,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACvD,CAAC;CACF,CAAC;AAEF,SAAS,eAAe,CAA8B,MAAqB;IACzE,OAAO,WAAW,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAW,CAAC,CAAC,CAAE,MAAkB,CAAC;AACzE,CAAC"}

package/dist/{schema/axis → axis}/role/Role.d.ts

@@ -1,26 +1,26 @@
-import { FieldGroup } from "../../fields/constraint/FieldGroup.js";
-import type { EntityConstructor, Relation } from "./Relation.js";
+import type { EntityConstructor, Relation } from './Relation.js';
 export interface RoleRules {
     primary?: boolean;
     index?: boolean;
+    unique?: boolean;
     relation?: Relation;
-    rules?: readonly FieldGroup[];
 }
 export declare class Role implements RoleRules {
     readonly primary?: boolean;
     readonly index?: boolean;
+    readonly unique?: boolean;
     readonly relation?: Relation;
-    readonly rules?: readonly FieldGroup[];
     private constructor();
     static of(field: {
         role?: RoleRules;
     }): Role;
-    /** A group written with no members means "this field": only the key it is declared under resolves it. */
-    static resolvedOn(role: RoleRules | undefined, key?: string): RoleRules | undefined;
     get isPrimary(): boolean;
     get isIndexed(): boolean;
+    /** A field unique on its own. A group spanning several belongs to the schema. */
+    get isUnique(): boolean;
     get isCollection(): boolean;
     get isReference(): boolean;
+    /** Calls `() => Post` so no caller has to. */
     get target(): EntityConstructor | undefined;
 }
 //# sourceMappingURL=Role.d.ts.map

package/dist/axis/role/Role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Role.d.ts","sourceRoot":"","sources":["../../../src/axis/role/Role.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEjE,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,qBAAa,IAAK,YAAW,SAAS;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAE7B,OAAO,eAKN;IAED,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,CAE3C;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,iFAAiF;IACjF,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,8CAA8C;IAC9C,IAAI,MAAM,IAAI,iBAAiB,GAAG,SAAS,CAE1C;CACF"}

package/dist/axis/role/Role.js

@@ -0,0 +1,36 @@
+export class Role {
+    primary;
+    index;
+    unique;
+    relation;
+    constructor(rules = {}) {
+        this.primary = rules.primary;
+        this.index = rules.index;
+        this.unique = rules.unique;
+        this.relation = rules.relation;
+    }
+    static of(field) {
+        return new Role(field.role);
+    }
+    get isPrimary() {
+        return this.primary === true;
+    }
+    get isIndexed() {
+        return this.index === true;
+    }
+    /** A field unique on its own. A group spanning several belongs to the schema. */
+    get isUnique() {
+        return this.unique === true;
+    }
+    get isCollection() {
+        return this.relation?.kind === 'many';
+    }
+    get isReference() {
+        return this.relation?.kind === 'one';
+    }
+    /** Calls `() => Post` so no caller has to. */
+    get target() {
+        return this.relation?.to();
+    }
+}
+//# sourceMappingURL=Role.js.map

package/dist/axis/role/Role.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Role.js","sourceRoot":"","sources":["../../../src/axis/role/Role.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,IAAI;IACN,OAAO,CAAW;IAClB,KAAK,CAAW;IAChB,MAAM,CAAW;IACjB,QAAQ,CAAY;IAE7B,YAAoB,KAAK,GAAc,EAAE;QACvC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,KAA2B;QACnC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;IAC/B,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC;IAC7B,CAAC;IAED,iFAAiF;IACjF,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,EAAE,IAAI,KAAK,MAAM,CAAC;IACxC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,QAAQ,EAAE,IAAI,KAAK,KAAK,CAAC;IACvC,CAAC;IAED,8CAA8C;IAC9C,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC7B,CAAC;CACF"}

package/dist/{schema/axis → axis}/role/RoleAxis.d.ts

@@ -1,5 +1,5 @@
 import type { Axis } from '../Axis.js';
 import { type RoleRules } from './Role.js';
-import type { RoleDescriptor } from '../../../projection/card/Descriptor.js';
+import type { RoleDescriptor } from '../../projection/card/Descriptor.js';
 export declare const roleAxis: Axis<RoleRules, RoleDescriptor>;
 //# sourceMappingURL=RoleAxis.d.ts.map

package/dist/axis/role/RoleAxis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoleAxis.d.ts","sourceRoot":"","sources":["../../../src/axis/role/RoleAxis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,YAAY,CAAC;AAKjD,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E,eAAO,MAAM,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,cAAc,CAgEpD,CAAC"}