@fougere/schema 0.2.0-alpha.2 → 0.3.0-alpha.0

package/dist/axis/boundary/Boundary.js

@@ -0,0 +1,53 @@
+import { Boundaries } from './Boundaries.js';
+import { Anatomy } from '../shape/Shape.js';
+const identityDecoder = (value) => ({ value });
+const identityEncoder = (value) => value;
+export class Boundary {
+    in;
+    out;
+    decode;
+    encode;
+    constructor(rules = {}, codecs) {
+        this.in = rules.in;
+        this.out = rules.out;
+        this.decode = codecs?.decode ?? identityDecoder;
+        this.encode = codecs?.encode ?? identityEncoder;
+    }
+    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);
+        if (!alias)
+            throw new Error(`Unknown boundary alias: '${ref}'`);
+        return new Boundary(alias);
+    }
+    static of(field) {
+        const declared = Boundary.declared(field);
+        const derived = Boundary.forShape(field.shape);
+        const rules = { in: declared.in ?? derived.in, out: declared.out ?? derived.out };
+        return new Boundary(rules, {
+            decode: typeof rules.in === 'object' ? Boundaries.decoder(rules.in.decode) : identityDecoder,
+            encode: typeof rules.out === 'object' ? Boundaries.encoder(rules.out.encode) : identityEncoder,
+        });
+    }
+    static forShape(shape) {
+        const base = Anatomy.of(shape).base;
+        if (base?.type === 'string' && base.format === 'date-time') {
+            return new Boundary(Boundaries.alias('isoDate'));
+        }
+        return new Boundary();
+    }
+    with(overrides) {
+        return new Boundary({ in: overrides.in ?? this.in, out: overrides.out ?? this.out });
+    }
+    get readOnly() {
+        return this.in === 'closed';
+    }
+    get writeOnly() {
+        return this.out === 'closed';
+    }
+}
+//# sourceMappingURL=Boundary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Boundary.js","sourceRoot":"","sources":["../../../src/axis/boundary/Boundary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAc,MAAM,mBAAmB,CAAC;AASxD,MAAM,eAAe,GAAY,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACxD,MAAM,eAAe,GAAY,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;AAElD,MAAM,OAAO,QAAQ;IACV,EAAE,CAAuB;IACzB,GAAG,CAAwB;IAC3B,MAAM,CAAU;IAChB,MAAM,CAAU;IAEzB,YAAoB,KAAK,GAAkB,EAAE,EAAE,MAA6C;QAC1F,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,eAAe,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,eAAe,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,KAAY;QAC1B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC3B,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7C,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;QAEtD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,GAAG,CAAC,CAAC;QAChE,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,KAAY;QACpB,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAkB,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACjG,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE;YACzB,MAAM,EAAE,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe;YAC5F,MAAM,EAAE,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe;SAC/F,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,KAAwB;QACtC,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;QACpC,IAAI,IAAI,EAAE,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3D,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,IAAI,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED,IAAI,CAAC,SAAwB;QAC3B,OAAO,IAAI,QAAQ,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC;IAC9B,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC;IAC/B,CAAC;CAEF"}

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

@@ -0,0 +1,4 @@
+import type { Axis } from '../Axis.js';
+import type { BoundaryRef } from './Boundary.js';
+export declare const boundaryAxis: Axis<BoundaryRef, BoundaryRef>;
+//# sourceMappingURL=axis.d.ts.map

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

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

package/dist/axis/boundary/axis.js

@@ -0,0 +1,29 @@
+import { admitWire, isObject } from '../../judge/form.js';
+export const boundaryAxis = {
+    slot: 'boundary',
+    judge(value, errors) {
+        if (typeof value === 'string')
+            return;
+        if (!isObject(value)) {
+            errors.push({
+                path: 'boundary',
+                message: `Expected an alias name or { in, out } — got ${JSON.stringify(value)}`,
+            });
+            return;
+        }
+        for (const [side, verb] of [['in', 'decode'], ['out', 'encode']]) {
+            const rule = value[side];
+            if (rule === undefined || rule === 'closed')
+                continue;
+            if (!isObject(rule) || typeof rule[verb] !== 'string') {
+                errors.push({ path: `boundary.${side}`, message: `Expected 'closed' or { ${verb}: <name> }` });
+            }
+        }
+    },
+    describe: (value) => value,
+    reconstruct: (wire) => {
+        admitWire(boundaryAxis.judge, wire, 'boundary');
+        return wire;
+    },
+};
+//# sourceMappingURL=axis.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"axis.js","sourceRoot":"","sources":["../../../src/axis/boundary/axis.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG1D,MAAM,CAAC,MAAM,YAAY,GAAmC;IAC1D,IAAI,EAAE,UAAU;IAEhB,KAAK,CAAC,KAAK,EAAE,MAAM;QACjB,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,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,4 @@
+export type GeneratorRef = 'cuid2' | 'uuid' | 'nanoid' | (string & {});
+export declare function registerGenerator(name: string, fn: () => string): void;
+export declare function resolveCustomGenerator(ref: GeneratorRef): (() => string) | undefined;
+//# 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":"AAAA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAIvE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,MAAM,GAAG,IAAI,CAEtE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,YAAY,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAEpF"}

package/dist/axis/lifecycle/Generators.js

@@ -0,0 +1,8 @@
+const generators = new Map();
+export function registerGenerator(name, fn) {
+    generators.set(name, fn);
+}
+export function resolveCustomGenerator(ref) {
+    return generators.get(ref);
+}
+//# 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":"AAEA,MAAM,UAAU,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEnD,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,EAAgB;IAC9D,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAiB;IACtD,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { GeneratorRef } from './Generators.js';
+export declare const CREATE_TOKENS: readonly ['now', 'optional'];
+export declare const UPDATE_TOKENS: readonly ['now', 'forbidden'];
+export interface LifecycleRules {
+    create?: {
+        value: unknown;
+    } | {
+        generate: GeneratorRef;
+    } | (typeof CREATE_TOKENS)[number];
+    update?: (typeof UPDATE_TOKENS)[number];
+}
+export declare class Lifecycle implements LifecycleRules {
+    readonly create?: LifecycleRules['create'];
+    readonly update?: LifecycleRules['update'];
+    private constructor();
+    static of(field: {
+        lifecycle?: LifecycleRules;
+    }): Lifecycle;
+    get requiredAtCreate(): boolean;
+    get stampedOnce(): boolean;
+    get immutable(): boolean;
+    get stampedOnUpdate(): boolean;
+    get literal(): {
+        value: unknown;
+    } | undefined;
+    get generator(): GeneratorRef | undefined;
+}
+//# sourceMappingURL=Lifecycle.d.ts.map

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

@@ -0,0 +1,38 @@
+export const CREATE_TOKENS = ['now', 'optional'];
+export const UPDATE_TOKENS = ['now', 'forbidden'];
+export class Lifecycle {
+    create;
+    update;
+    constructor(rules = {}) {
+        this.create = rules.create;
+        this.update = rules.update;
+    }
+    static of(field) {
+        return new Lifecycle(field.lifecycle);
+    }
+    get requiredAtCreate() {
+        return this.create === undefined;
+    }
+    get stampedOnce() {
+        return this.create === 'now' && this.update !== 'now';
+    }
+    get immutable() {
+        return this.update === 'forbidden';
+    }
+    get stampedOnUpdate() {
+        return this.update === 'now';
+    }
+    get literal() {
+        const rule = this.create;
+        return typeof rule === 'object' && rule !== null && 'value' in rule
+            ? { value: rule.value }
+            : undefined;
+    }
+    get generator() {
+        const rule = this.create;
+        return typeof rule === 'object' && rule !== null && 'generate' in rule
+            ? rule.generate
+            : undefined;
+    }
+}
+//# sourceMappingURL=Lifecycle.js.map

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/apply.d.ts

@@ -0,0 +1,8 @@
+import { type Fields } from '../../Field.js';
+type Row = Record<string, unknown>;
+/** Freeze the instant these two functions stamp. Returns the gesture that restores it. */
+export declare function freezeClock(at: number | Date): () => void;
+export declare function applyCreate(fields: Fields, input: Row): Row;
+export declare function applyUpdate(fields: Fields, patch: Row): Row;
+export {};
+//# 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":"AAEA,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGzD,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAkCnC,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,IAAI,CAKzD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAc3D;AAOD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAS3D"}

package/dist/axis/lifecycle/apply.js

@@ -0,0 +1,72 @@
+import { Lifecycle } from './Lifecycle.js';
+import { resolveCustomGenerator } from './Generators.js';
+import { createId } from '@paralleldrive/cuid2';
+function generatorFor(ref) {
+    const custom = resolveCustomGenerator(ref);
+    if (custom)
+        return custom;
+    switch (ref) {
+        case 'cuid2': return createId;
+        case 'uuid': return () => globalThis.crypto.randomUUID();
+        case 'nanoid': {
+            return () => {
+                const bytes = new Uint8Array(21);
+                globalThis.crypto.getRandomValues(bytes);
+                const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+                return Array.from(bytes, (b) => alphabet[b & 63]).join('');
+            };
+        }
+        default:
+            throw new Error(`Unknown generator '${ref}' — register it with registerGenerator('${ref}', fn)`);
+    }
+}
+/**
+ * What "now" means, for the two functions that stamp it.
+ *
+ * The ONE place either of them reads the clock, which is what makes it substitutable at
+ * all: `created()`, `updated()` and `create: 'now'` are realized here and nowhere else, so
+ * a test that needs a stable instant sets this instead of intercepting `Date` globally —
+ * where Rails had to build `travel_to` over the language.
+ *
+ * A value rather than a mock: nothing here is a channel, and a frozen clock is a fact
+ * about the run, not an interception of a call.
+ */
+let clock = Date.now;
+/** Freeze the instant these two functions stamp. Returns the gesture that restores it. */
+export function freezeClock(at) {
+    const previous = clock;
+    const instant = at instanceof Date ? at.getTime() : at;
+    clock = () => instant;
+    return () => { clock = previous; };
+}
+export function applyCreate(fields, input) {
+    const out = { ...input };
+    const instant = clock();
+    for (const [name, field] of Object.entries(fields)) {
+        if (name in out)
+            continue;
+        const rule = Lifecycle.of(field);
+        if (rule.create === 'now')
+            out[name] = new Date(instant);
+        else if (rule.literal)
+            out[name] = freshValue(rule.literal.value);
+        else if (rule.generator)
+            out[name] = generatorFor(rule.generator)();
+    }
+    return out;
+}
+function freshValue(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    return structuredClone(value);
+}
+export function applyUpdate(fields, patch) {
+    const out = { ...patch };
+    const instant = clock();
+    for (const [name, field] of Object.entries(fields)) {
+        if (Lifecycle.of(field).stampedOnUpdate && !(name in out))
+            out[name] = new Date(instant);
+    }
+    return out;
+}
+//# 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":"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"}

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

@@ -0,0 +1,4 @@
+import type { Axis } from '../Axis.js';
+import { type LifecycleRules } from './Lifecycle.js';
+export declare const lifecycleAxis: Axis<LifecycleRules, LifecycleRules>;
+//# sourceMappingURL=axis.d.ts.map

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

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

package/dist/axis/lifecycle/axis.js

@@ -0,0 +1,46 @@
+import { admitWire, isObject, oneOfTokens } from '../../judge/form.js';
+import { CREATE_TOKENS, UPDATE_TOKENS } from './Lifecycle.js';
+export const lifecycleAxis = {
+    slot: 'lifecycle',
+    judge(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);
+        if (value.update !== undefined && !oneOfTokens(value.update, UPDATE_TOKENS)) {
+            errors.push({
+                path: 'lifecycle.update',
+                message: `Expected 'now' or 'forbidden' — got ${JSON.stringify(value.update)}`,
+            });
+        }
+    },
+    describe: (value) => value,
+    reconstruct: (wire) => {
+        admitWire(lifecycleAxis.judge, wire, 'lifecycle');
+        return wire;
+    },
+};
+function judgeCreate(rule, errors) {
+    if (oneOfTokens(rule, CREATE_TOKENS))
+        return;
+    if (isObject(rule)) {
+        if ('value' in rule)
+            return;
+        if ('generate' in rule) {
+            if (typeof rule.generate !== 'string') {
+                errors.push({
+                    path: 'lifecycle.create.generate',
+                    message: `Expected a generator name — got ${JSON.stringify(rule.generate)}`,
+                });
+            }
+            return;
+        }
+    }
+    errors.push({
+        path: 'lifecycle.create',
+        message: `Expected 'now', 'optional', { value } or { generate } — got ${JSON.stringify(rule)}`,
+    });
+}
+//# sourceMappingURL=axis.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"axis.js","sourceRoot":"","sources":["../../../src/axis/lifecycle/axis.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAuB,MAAM,gBAAgB,CAAC;AAEnF,MAAM,CAAC,MAAM,aAAa,GAAyC;IACjE,IAAI,EAAE,WAAW;IAEjB,KAAK,CAAC,KAAK,EAAE,MAAM;QACjB,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,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClE,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,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF,SAAS,WAAW,CAAC,IAAa,EAAE,MAAyB;IAC3D,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/role/Relation.d.ts

@@ -0,0 +1,10 @@
+export type EntityConstructor = abstract new (...args: any[]) => any;
+export declare function toTargetThunk<E extends EntityConstructor>(target: E | (() => E)): () => E;
+export declare const RELATION_KINDS: readonly ['one', 'many'];
+export declare const ON_DELETE: readonly ['cascade', 'restrict', 'set null'];
+export interface Relation {
+    to: () => EntityConstructor;
+    kind: (typeof RELATION_KINDS)[number];
+    onDelete?: (typeof ON_DELETE)[number];
+}
+//# sourceMappingURL=Relation.d.ts.map

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,wBAAgB,aAAa,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAEzF;AAED,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"}

package/dist/axis/role/Relation.js

@@ -0,0 +1,6 @@
+export function toTargetThunk(target) {
+    return 'getFields' in target ? () => target : target;
+}
+export const RELATION_KINDS = ['one', 'many'];
+export const ON_DELETE = ['cascade', 'restrict', 'set null'];
+//# 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,UAAU,aAAa,CAA8B,MAAqB;IAC9E,OAAO,WAAW,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAW,CAAC,CAAC,CAAE,MAAkB,CAAC;AACzE,CAAC;AAED,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"}

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

@@ -0,0 +1,38 @@
+import type { FieldGroup } from "../../constraint/FieldGroup.js";
+import type { Fields } from "../../Field.js";
+import type { EntityConstructor, Relation } from "./Relation.js";
+export interface RoleRules {
+    primary?: boolean;
+    index?: boolean;
+    relation?: Relation;
+    rules?: ReadonlyArray<FieldGroup>;
+}
+export declare class Role implements RoleRules {
+    readonly primary?: boolean;
+    readonly index?: boolean;
+    readonly relation?: Relation;
+    readonly rules?: ReadonlyArray<FieldGroup>;
+    private constructor();
+    static of(field: {
+        role?: RoleRules;
+    }): Role;
+    get isPrimary(): boolean;
+    get isIndexed(): boolean;
+    get isCollection(): boolean;
+    get isReference(): boolean;
+    get target(): EntityConstructor | undefined;
+}
+/**
+ * The name of the field that carries `primary`, or `undefined` when none does.
+ *
+ * `Role.of(field).isPrimary` answers about ONE field; this answers about a shape, which
+ * is the question every reader actually had. It was the same three lines spelled five
+ * times — a mirror's key, a form's row identity, GraphQL's node id, the DDL's primary
+ * key and the ORM's `findById` column — so a shape with two primaries meant whichever
+ * one that loop happened to see first, five times over.
+ *
+ * The absence is answered and not defaulted: `'id'` is a fine fallback for a form and a
+ * lie for a DDL, so the caller decides.
+ */
+export declare function primaryFieldOf(fields: Fields): string | 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,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,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,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACnC;AAED,qBAAa,IAAK,YAAW,SAAS;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAE3C,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,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,MAAM,IAAI,iBAAiB,GAAG,SAAS,CAE1C;CACF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKjE"}

package/dist/axis/role/Role.js

@@ -0,0 +1,50 @@
+export class Role {
+    primary;
+    index;
+    relation;
+    rules;
+    constructor(declared = {}) {
+        this.primary = declared.primary;
+        this.index = declared.index;
+        this.relation = declared.relation;
+        this.rules = declared.rules;
+    }
+    static of(field) {
+        return new Role(field.role);
+    }
+    get isPrimary() {
+        return this.primary === true;
+    }
+    get isIndexed() {
+        return this.index === true;
+    }
+    get isCollection() {
+        return this.relation?.kind === "many";
+    }
+    get isReference() {
+        return this.relation?.kind === "one";
+    }
+    get target() {
+        return this.relation?.to();
+    }
+}
+/**
+ * The name of the field that carries `primary`, or `undefined` when none does.
+ *
+ * `Role.of(field).isPrimary` answers about ONE field; this answers about a shape, which
+ * is the question every reader actually had. It was the same three lines spelled five
+ * times — a mirror's key, a form's row identity, GraphQL's node id, the DDL's primary
+ * key and the ORM's `findById` column — so a shape with two primaries meant whichever
+ * one that loop happened to see first, five times over.
+ *
+ * The absence is answered and not defaulted: `'id'` is a fine fallback for a form and a
+ * lie for a DDL, so the caller decides.
+ */
+export function primaryFieldOf(fields) {
+    for (const [name, field] of Object.entries(fields)) {
+        if (Role.of(field).isPrimary)
+            return name;
+    }
+    return undefined;
+}
+//# 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":"AAWA,MAAM,OAAO,IAAI;IACN,OAAO,CAAW;IAClB,KAAK,CAAW;IAChB,QAAQ,CAAY;IACpB,KAAK,CAA6B;IAE3C,YAAoB,QAAQ,GAAc,EAAE;QAC1C,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC9B,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,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,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"axis.d.ts","sourceRoot":"","sources":["../../../src/axis/role/axis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,YAAY,CAAC;AAIjD,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,eAAO,MAAM,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,cAAc,CA+EpD,CAAC"}

package/dist/axis/role/axis.js

@@ -0,0 +1,101 @@
+import { isObject, oneOfTokens, refuse } from '../../judge/form.js';
+import { ON_DELETE, RELATION_KINDS } from './Relation.js';
+import { FieldGroup } from '../../constraint/FieldGroup.js';
+import { Unique } from '../../constraint/Unique.js';
+import { registrationKeyOf } from '../../name.js';
+export const roleAxis = {
+    slot: 'role',
+    judge(value, errors) {
+        if (!isObject(value)) {
+            errors.push({ path: 'role', message: `Expected an object — got ${JSON.stringify(value)}` });
+            return;
+        }
+        for (const flag of ['primary', 'index']) {
+            if (value[flag] !== undefined && typeof value[flag] !== 'boolean') {
+                errors.push({
+                    path: `role.${flag}`,
+                    message: `Expected a boolean — got ${JSON.stringify(value[flag])}`,
+                });
+            }
+        }
+        if (value.rules !== undefined) {
+            const legal = Array.isArray(value.rules) &&
+                value.rules.every((rule) => rule instanceof FieldGroup ||
+                    (Array.isArray(rule) && rule.every((member) => typeof member === 'string')));
+            if (!legal) {
+                errors.push({
+                    path: 'role.rules',
+                    message: 'Expected field groups, or the member lists they denote — string[][]',
+                });
+            }
+        }
+        if (value.relation !== undefined)
+            judgeRelation(value.relation, errors);
+    },
+    describe(role, key) {
+        const out = {};
+        if (role.primary)
+            out.primary = true;
+        const unique = (role.rules ?? []).filter((rule) => rule instanceof Unique);
+        if (unique.length)
+            out.unique = unique.map((rule) => [...rule.resolvedOn(key).members]);
+        if (role.index)
+            out.index = true;
+        if (role.relation) {
+            const target = role.relation.to();
+            out.relation = {
+                to: registrationKeyOf(target.name ?? ''),
+                kind: role.relation.kind,
+                ...(role.relation.onDelete ? { onDelete: role.relation.onDelete } : {}),
+            };
+        }
+        return Object.keys(out).length ? out : undefined;
+    },
+    reconstruct(wire, resolve) {
+        const out = {};
+        if (wire.primary)
+            out.primary = true;
+        if (wire.unique?.length)
+            out.rules = wire.unique.map((group) => new Unique(group));
+        if (wire.index)
+            out.index = true;
+        if (wire.relation) {
+            // `judge` cannot serve here: it demands a thunk where a card carries a name.
+            if (!oneOfTokens(wire.relation.kind, RELATION_KINDS)) {
+                refuse(`role.relation.kind is ${JSON.stringify(wire.relation.kind)}`, `Expected one of ${RELATION_KINDS.join(', ')}.`);
+            }
+            if (wire.relation.onDelete !== undefined && !oneOfTokens(wire.relation.onDelete, ON_DELETE)) {
+                refuse(`role.relation.onDelete is ${JSON.stringify(wire.relation.onDelete)}`, `Expected one of ${ON_DELETE.join(', ')}.`);
+            }
+            const name = wire.relation.to;
+            out.relation = {
+                to: () => (resolve?.(name) ?? { name }),
+                kind: wire.relation.kind,
+                ...(wire.relation.onDelete ? { onDelete: wire.relation.onDelete } : {}),
+            };
+        }
+        return out;
+    },
+};
+function judgeRelation(relation, errors) {
+    if (!isObject(relation)) {
+        errors.push({ path: 'role.relation', message: `Expected an object — got ${JSON.stringify(relation)}` });
+        return;
+    }
+    if (!oneOfTokens(relation.kind, RELATION_KINDS)) {
+        errors.push({
+            path: 'role.relation.kind',
+            message: `Expected 'one' or 'many' — got ${JSON.stringify(relation.kind)}`,
+        });
+    }
+    if (typeof relation.to !== 'function') {
+        errors.push({ path: 'role.relation.to', message: 'Expected a thunk returning the target entity' });
+    }
+    if (relation.onDelete !== undefined && !oneOfTokens(relation.onDelete, ON_DELETE)) {
+        errors.push({
+            path: 'role.relation.onDelete',
+            message: `Expected 'cascade', 'restrict' or 'set null' — got ${JSON.stringify(relation.onDelete)}`,
+        });
+    }
+}
+//# sourceMappingURL=axis.js.map

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

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

package/dist/axis/shape/Formats.d.ts

@@ -0,0 +1,8 @@
+export type StringFormat = 'date-time' | 'date' | 'time' | 'email' | 'uuid' | 'uri' | (string & {});
+export type FormatPredicate = (value: string) => boolean;
+export declare class Formats {
+    private static readonly registry;
+    static register(name: string, predicate: FormatPredicate): void;
+    static resolve(name: string): FormatPredicate | undefined;
+}
+//# sourceMappingURL=Formats.d.ts.map

package/dist/axis/shape/Formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Formats.d.ts","sourceRoot":"","sources":["../../../src/axis/shape/Formats.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,KAAK,GACL,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAEzD,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAEtE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,IAAI,CAE9D;IAED,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAExD;CACF"}