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

package/README.md

@@ -52,4 +52,4 @@ pnpm add @fougere/schema
 
 Part of [Fougere](https://github.com/chok/fougere) — one schema, a gradient from
 monolith to distributed, the same user code.
-Reference documentation: [the site](https://chok.github.io/fougere/) (en/fr).
+Reference documentation: [the site](https://fougere.dev/) (en/fr).

package/dist/EntityAdapters.d.ts

@@ -0,0 +1,26 @@
+import type { FieldName, Fields } from './fields/Field.js';
+export interface FougereEntityAdapters<K extends string> {
+}
+export type EntityAdapters<TFields extends Fields> = Partial<FougereEntityAdapters<FieldName<TFields>>>;
+/**
+ * What one schema states per adapter: an adapter name, a field name, then that adapter's own value.
+ */
+export declare class EntityAdapterSet {
+    private readonly byAdapter;
+    private constructor();
+    static of(declared: EntityAdapters<Fields> | undefined): EntityAdapterSet | undefined;
+    /** Several schemas folded into one set; a later source wins, per adapter and per field. */
+    static merged(sources: readonly (EntityAdapters<Fields> | undefined)[]): EntityAdapterSet | undefined;
+    /** The plain object, which is what a reader outside this package receives. */
+    get stated(): EntityAdapters<Fields>;
+    /**
+     * The entries whose field survives a cut, re-addressed by that field's new name.
+     *
+     * The adapter name is not a field and does not move; only the level below it does. An
+     * entry left on the old name is not an error anywhere downstream — `adapter/sql` looks
+     * it up by the field it is iterating and simply finds nothing.
+     */
+    cut(survives: (key: string) => string | undefined): EntityAdapterSet | undefined;
+    private static made;
+}
+//# sourceMappingURL=EntityAdapters.d.ts.map

package/dist/EntityAdapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityAdapters.d.ts","sourceRoot":"","sources":["../src/EntityAdapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3D,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,MAAM;CAAI;AAE3D,MAAM,MAAM,cAAc,CAAC,OAAO,SAAS,MAAM,IAAI,OAAO,CAAC,qBAAqB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAOxG;;GAEG;AACH,qBAAa,gBAAgB;IACP,OAAO,CAAC,QAAQ,CAAC,SAAS;IAA9C,OAAO,eAA2D;IAElE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAyBpF;IAED,2FAA2F;IAC3F,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,GAAG,gBAAgB,GAAG,SAAS,CAapG;IAED,8EAA8E;IAC9E,IAAI,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,CAEnC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAe/E;IAED,OAAO,CAAC,MAAM,CAAC,IAAI;CAGpB"}

package/dist/EntityAdapters.js

@@ -0,0 +1,71 @@
+import { isObject } from './judge/ValueForm.js';
+/**
+ * What one schema states per adapter: an adapter name, a field name, then that adapter's own value.
+ */
+export class EntityAdapterSet {
+    byAdapter;
+    constructor(byAdapter) {
+        this.byAdapter = byAdapter;
+    }
+    static of(declared) {
+        if (declared === undefined)
+            return undefined;
+        if (!isObject(declared)) {
+            throw new Error(`adapters: expected an object keyed by adapter name, got ${typeof declared}.`);
+        }
+        const byAdapter = {};
+        for (const [adapter, perField] of Object.entries(declared)) {
+            if (perField === undefined)
+                continue;
+            if (!isObject(perField)) {
+                throw new Error(`adapters.${adapter}: expected an object keyed by field name, got ${typeof perField}. ` +
+                    `What an adapter is handed is addressed by the field it applies to.`);
+            }
+            if (Object.keys(perField).length)
+                byAdapter[adapter] = perField;
+        }
+        return EntityAdapterSet.made(byAdapter);
+    }
+    /** Several schemas folded into one set; a later source wins, per adapter and per field. */
+    static merged(sources) {
+        const out = {};
+        for (const source of sources) {
+            const set = EntityAdapterSet.of(source);
+            if (!set)
+                continue;
+            for (const [adapter, perField] of Object.entries(set.byAdapter)) {
+                out[adapter] = { ...out[adapter], ...perField };
+            }
+        }
+        return EntityAdapterSet.made(out);
+    }
+    /** The plain object, which is what a reader outside this package receives. */
+    get stated() {
+        return this.byAdapter;
+    }
+    /**
+     * The entries whose field survives a cut, re-addressed by that field's new name.
+     *
+     * The adapter name is not a field and does not move; only the level below it does. An
+     * entry left on the old name is not an error anywhere downstream — `adapter/sql` looks
+     * it up by the field it is iterating and simply finds nothing.
+     */
+    cut(survives) {
+        const out = {};
+        for (const [adapter, perField] of Object.entries(this.byAdapter)) {
+            const mapped = {};
+            for (const [key, entry] of Object.entries(perField)) {
+                const next = survives(key);
+                if (next !== undefined)
+                    mapped[next] = entry;
+            }
+            if (Object.keys(mapped).length)
+                out[adapter] = mapped;
+        }
+        return EntityAdapterSet.made(out);
+    }
+    static made(byAdapter) {
+        return Object.keys(byAdapter).length ? new EntityAdapterSet(byAdapter) : undefined;
+    }
+}
+//# sourceMappingURL=EntityAdapters.js.map

package/dist/EntityAdapters.js.map

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

package/dist/EntityDeclarations.d.ts

@@ -0,0 +1,15 @@
+import type { FieldName, Fields } from './fields/Field.js';
+import type { EntityAdapters } from './EntityAdapters.js';
+export type CompositeUnique<TFields extends Fields> = readonly (readonly FieldName<TFields>[])[];
+/** New name to old name: the field states what it WAS, which is how a human writes it. */
+export type PreviousNames<TFields extends Fields> = Partial<Record<FieldName<TFields>, string>>;
+export interface EntityDeclarations<TFields extends Fields> {
+    unique?: CompositeUnique<TFields>;
+    adapters?: EntityAdapters<TFields>;
+    /**
+     * What a field used to be called — read by `fougere freeze` and by nothing else.
+     * It answers the one question two shapes cannot, and is meant to be deleted after.
+     */
+    previous?: PreviousNames<TFields>;
+}
+//# sourceMappingURL=EntityDeclarations.d.ts.map

package/dist/EntityDeclarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityDeclarations.d.ts","sourceRoot":"","sources":["../src/EntityDeclarations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,MAAM,IAAI,SAAS,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;AAEjG,0FAA0F;AAC1F,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,MAAM,IAAI,OAAO,CACzD,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CACnC,CAAC;AAEF,MAAM,WAAW,kBAAkB,CAAC,OAAO,SAAS,MAAM;IACxD,MAAM,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACnC"}

package/dist/EntityDeclarations.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EntityDeclarations.js.map

package/dist/EntityDeclarations.js.map

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

package/dist/axis/Axis.d.ts

@@ -0,0 +1,12 @@
+import type { ValidationError } from '../judge/result.js';
+export interface Axis<Declared = unknown, Wire = unknown> {
+    readonly slot: 'role' | 'lifecycle' | 'boundary';
+    judge(value: unknown, errors: ValidationError[]): void;
+    describe(value: Declared, key: string): Wire | undefined;
+    reconstruct(wire: Wire, resolve?: Resolver): Declared;
+}
+export type Resolver = (name: string) => (abstract new (...args: never[]) => unknown) | undefined;
+export declare const EXTENSION_AXES: readonly Axis[];
+/** The slots they occupy: the keys of `x-fougere` on a field descriptor. */
+export declare const EXTENSION_SLOTS: ("boundary" | "lifecycle" | "role")[];
+//# sourceMappingURL=Axis.d.ts.map

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,oBAAoB,CAAC;AAE1D,MAAM,WAAW,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IAEjD,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAEvD,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

@@ -0,0 +1,11 @@
+import { roleAxis } from './role/RoleAxis.js';
+import { lifecycleAxis } from './lifecycle/LifecycleAxis.js';
+import { boundaryAxis } from './boundary/BoundaryAxis.js';
+export const EXTENSION_AXES = [
+    roleAxis,
+    lifecycleAxis,
+    boundaryAxis,
+];
+/** The slots they occupy: the keys of `x-fougere` on a field descriptor. */
+export const EXTENSION_SLOTS = EXTENSION_AXES.map((axis) => axis.slot);
+//# sourceMappingURL=Axis.js.map

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

@@ -0,0 +1,4 @@
+export interface Meta {
+    description?: string;
+}
+//# sourceMappingURL=Meta.d.ts.map

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/axis/Meta.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Meta.js.map

package/dist/axis/Meta.js.map

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

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

@@ -0,0 +1,20 @@
+import type { BoundaryRules } from './Boundary.js';
+export type Decoder = (value: unknown) => {
+    value: unknown;
+} | {
+    error: string;
+};
+export type Encoder = (value: unknown) => unknown;
+export declare class Boundaries {
+    private static readonly decoders;
+    private static readonly encoders;
+    private static readonly aliases;
+    static registerDecoder(name: string, fn: Decoder): void;
+    static registerEncoder(name: string, fn: Encoder): void;
+    static registerAlias(name: string, boundary: BoundaryRules): void;
+    static alias(name: string): BoundaryRules | undefined;
+    static decoder(name: string): Decoder;
+    static encoder(name: string): Encoder;
+    private static named;
+}
+//# 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;AAEnD,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,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAC9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAC9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAEnE,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAAiC;IACxF,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAAiC;IAExF,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAsC;IAEvG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAmC;IAExF,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAuD;IAC5F,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAuD;IAE5F,OAAO,CAAC,MAAM,CAAC,KAAK;CAUrB"}

package/dist/axis/boundary/Boundaries.js

@@ -0,0 +1,31 @@
+export class Boundaries {
+    static decoders = new Map();
+    static encoders = new Map();
+    static aliases = new Map();
+    static registerDecoder(name, fn) { this.decoders.set(name, fn); }
+    static registerEncoder(name, fn) { this.encoders.set(name, fn); }
+    static registerAlias(name, boundary) { this.aliases.set(name, boundary); }
+    static alias(name) { return this.aliases.get(name); }
+    static decoder(name) { return this.named(this.decoders, name, 'decoder'); }
+    static encoder(name) { return this.named(this.encoders, name, 'encoder'); }
+    static named(registry, name, kind) {
+        const fn = registry.get(name);
+        if (!fn) {
+            throw new Error(`Unknown boundary ${kind}: '${name}'. Register it with ` +
+                `Boundaries.register${kind[0].toUpperCase()}${kind.slice(1)}('${name}', …).`);
+        }
+        return fn;
+    }
+}
+Boundaries.registerDecoder('isoDate', (value) => {
+    if (value instanceof Date)
+        return { value };
+    if (typeof value === 'string') {
+        const d = new Date(value);
+        return Number.isNaN(d.getTime()) ? { error: 'Invalid date' } : { value: d };
+    }
+    return { error: 'Expected a date' };
+});
+Boundaries.registerEncoder('isoDate', (value) => value instanceof Date ? value.toISOString() : value);
+Boundaries.registerAlias('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":"AAKA,MAAM,OAAO,UAAU;IACb,MAAM,CAAU,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IACtD,MAAM,CAAU,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IACtD,MAAM,CAAU,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEnE,MAAM,CAAC,eAAe,CAAC,IAAY,EAAE,EAAW,IAAU,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACxF,MAAM,CAAC,eAAe,CAAC,IAAY,EAAE,EAAW,IAAU,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAExF,MAAM,CAAC,aAAa,CAAC,IAAY,EAAE,QAAuB,IAAU,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEvG,MAAM,CAAC,KAAK,CAAC,IAAY,IAA+B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAExF,MAAM,CAAC,OAAO,CAAC,IAAY,IAAa,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5F,MAAM,CAAC,OAAO,CAAC,IAAY,IAAa,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAEpF,MAAM,CAAC,KAAK,CAAI,QAAwB,EAAE,IAAY,EAAE,IAAY;QAC1E,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CACb,oBAAoB,IAAI,MAAM,IAAI,sBAAsB;gBACtD,sBAAsB,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,QAAQ,CAC/E,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,UAAU,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;IAC9C,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;AACtC,CAAC,CAAC,CAAC;AACH,UAAU,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAC9C,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CACpD,CAAC;AACF,UAAU,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC"}

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

@@ -0,0 +1,26 @@
+import type { Decoder, Encoder } from './Boundaries.js';
+import type { Field } from '../../fields/Field.js';
+import { type Shape } from '../shape/Shape.js';
+export interface BoundaryRules {
+    in?: 'closed' | {
+        decode: string;
+    };
+    out?: 'closed' | {
+        encode: string;
+    };
+}
+export type BoundaryRef = 'isoDate' | (string & {}) | BoundaryRules;
+export declare class Boundary implements BoundaryRules {
+    readonly in?: BoundaryRules['in'];
+    readonly out?: BoundaryRules['out'];
+    readonly decode: Decoder;
+    readonly encode: Encoder;
+    private constructor();
+    static declared(field: Field): Boundary;
+    static of(field: Field): Boundary;
+    static forShape(shape: Shape | undefined): Boundary;
+    with(overrides: BoundaryRules): Boundary;
+    get readOnly(): boolean;
+    get writeOnly(): boolean;
+}
+//# sourceMappingURL=Boundary.d.ts.map

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,uBAAuB,CAAC;AACnD,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAExD,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,eAKN;IAED,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAQtC;IAED,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAQhC;IAED,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;CAEF"}

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":"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"}

package/dist/axis/boundary/BoundaryAxis.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=BoundaryAxis.d.ts.map

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/axis/boundary/BoundaryAxis.js

@@ -0,0 +1,30 @@
+import { admitWire } from '../../card/admission.js';
+import { isObject } from '../../judge/ValueForm.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=BoundaryAxis.js.map

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,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD,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/Clock.d.ts

@@ -0,0 +1,18 @@
+/**
+ * What "now" means, for the two functions that stamp it.
+ *
+ * The ONE place either of them reads the time, which is what makes it substitutable at
+ * all: `created()`, `updated()` and `create: 'now'` are realized through this and nowhere
+ * else, so a test that needs a stable instant sets it here 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.
+ */
+export declare class Clock {
+    private static reading;
+    static now(): number;
+    /** Freeze the instant this clock reads. Returns the gesture that restores it. */
+    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,iFAAiF;IACjF,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,IAAI,CAK3C;CACF"}

package/dist/axis/lifecycle/Clock.js

@@ -0,0 +1,25 @@
+/**
+ * What "now" means, for the two functions that stamp it.
+ *
+ * The ONE place either of them reads the time, which is what makes it substitutable at
+ * all: `created()`, `updated()` and `create: 'now'` are realized through this and nowhere
+ * else, so a test that needs a stable instant sets it here 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.
+ */
+export class Clock {
+    static reading = Date.now;
+    static now() {
+        return this.reading();
+    }
+    /** Freeze the instant this clock reads. Returns the gesture that restores it. */
+    static freeze(at) {
+        const previous = this.reading;
+        const instant = at instanceof Date ? at.getTime() : at;
+        this.reading = () => instant;
+        return () => { this.reading = previous; };
+    }
+}
+//# sourceMappingURL=Clock.js.map

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,iFAAiF;IACjF,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,18 @@
+export type GeneratorRef = 'cuid2' | 'uuid' | 'nanoid' | (string & {});
+/**
+ * Who answers a `generate` by name — one registry per process, like `Formats` and
+ * `Boundaries`.
+ *
+ * The three builtins are REGISTERED rather than switched on, which is what brings the
+ * refusal back inside: a registry whose unknown name is refused by a `default:` branch in
+ * its caller does not know what it holds, so it cannot say so.
+ */
+export declare class Generators {
+    private static readonly registry;
+    static register(name: string, fn: () => string): void;
+    /** The generator this name stands for, refused by name when nothing does. */
+    static resolve(ref: GeneratorRef): () => string;
+    /** Whether a name is answered, for a caller that must not throw to find out. */
+    static answers(ref: GeneratorRef): boolean;
+}
+//# 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,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAUvE;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAI7B;IAEH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,MAAM,GAAG,IAAI,CAEpD;IAED,6EAA6E;IAC7E,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,MAAM,CAO9C;IAED,gFAAgF;IAChF,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAEzC;CACF"}

package/dist/axis/lifecycle/Generators.js

@@ -0,0 +1,38 @@
+import { createId } from '@paralleldrive/cuid2';
+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` by name — one registry per process, like `Formats` and
+ * `Boundaries`.
+ *
+ * The three builtins are REGISTERED rather than switched on, which is what brings the
+ * refusal back inside: a registry whose unknown name is refused by a `default:` branch in
+ * its caller does not know what it holds, so it cannot say so.
+ */
+export class Generators {
+    static registry = new Map([
+        ['cuid2', createId],
+        ['uuid', () => globalThis.crypto.randomUUID()],
+        ['nanoid', nanoid],
+    ]);
+    static register(name, fn) {
+        this.registry.set(name, fn);
+    }
+    /** The generator this name stands for, refused by name when nothing does. */
+    static resolve(ref) {
+        const found = this.registry.get(ref);
+        if (found)
+            return found;
+        throw new Error(`Unknown generator '${ref}' — register it with Generators.register('${ref}', fn). ` +
+            `This process answers ${[...this.registry.keys()].join(', ')}.`);
+    }
+    /** Whether a name is answered, for a caller that must not throw to find out. */
+    static answers(ref) {
+        return this.registry.has(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":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD,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;;;;;;;GAOG;AACH,MAAM,OAAO,UAAU;IACb,MAAM,CAAU,QAAQ,GAAG,IAAI,GAAG,CAAuB;QAC/D,CAAC,OAAO,EAAE,QAAQ,CAAC;QACnB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC9C,CAAC,QAAQ,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,CAAC,IAAY,EAAE,EAAgB;QAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,OAAO,CAAC,GAAiB;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,sBAAsB,GAAG,6CAA6C,GAAG,UAAU;YACnF,wBAAwB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAChE,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,MAAM,CAAC,OAAO,CAAC,GAAiB;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;CACF"}

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/LifecycleAxis.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=LifecycleAxis.d.ts.map

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"}