@fougere/schema 0.1.0-alpha.0

package/dist/vocabulary/immutable.d.ts

@@ -0,0 +1,9 @@
+import { type Field } from '../field/index.js';
+/**
+ * Forbid re-writing after creation — `update: 'forbidden'` on the lifecycle
+ * axis. Creation is untouched; supplying the field in a patch is a validation
+ * error ("Immutable"). Derived views (`partial()`) keep the field for
+ * introspection — the lifecycle rule, not the view, is what rejects it.
+ */
+export declare function immutable<T, A extends boolean>(field: Field<T, A>): Field<T, A>;
+//# sourceMappingURL=immutable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"immutable.d.ts","sourceRoot":"","sources":["../../src/vocabulary/immutable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAE/E"}

package/dist/vocabulary/immutable.js

@@ -0,0 +1,11 @@
+import { createField } from '../field/index.js';
+/**
+ * Forbid re-writing after creation — `update: 'forbidden'` on the lifecycle
+ * axis. Creation is untouched; supplying the field in a patch is a validation
+ * error ("Immutable"). Derived views (`partial()`) keep the field for
+ * introspection — the lifecycle rule, not the view, is what rejects it.
+ */
+export function immutable(field) {
+    return createField({ ...field, lifecycle: { ...field.lifecycle, update: 'forbidden' } });
+}
+//# sourceMappingURL=immutable.js.map

package/dist/vocabulary/immutable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"immutable.js","sourceRoot":"","sources":["../../src/vocabulary/immutable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAuB,KAAkB;IAChE,OAAO,WAAW,CAAO,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;AACjG,CAAC"}

package/dist/vocabulary/indexed.d.ts

@@ -0,0 +1,19 @@
+import { type Field } from '../field/index.js';
+/**
+ * Reads filter on this field often — `index: true` on the role axis.
+ *
+ * Named `indexed` rather than `index`: `index` is taken everywhere in JavaScript (an
+ * array position, a module's entry point), and a vocabulary word has to read as what it
+ * says at the call site — `indexed(text())` states a property of the field, `index(...)`
+ * would read as an action on it.
+ *
+ * It changes no answer, only the cost of getting one — which is why it is the one word
+ * here that is a hint rather than a rule. The DDL emits `CREATE INDEX`; nothing else
+ * reads it, and nothing should: a query that only works with the index is a query with
+ * a bug.
+ *
+ * `unique()` already implies one — a uniqueness constraint is backed by an index on
+ * every engine — so declaring both is redundant, not additive.
+ */
+export declare function indexed<T, A extends boolean>(field: Field<T, A>): Field<T, A>;
+//# sourceMappingURL=indexed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexed.d.ts","sourceRoot":"","sources":["../../src/vocabulary/indexed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAE7E"}

package/dist/vocabulary/indexed.js

@@ -0,0 +1,21 @@
+import { createField } from '../field/index.js';
+/**
+ * Reads filter on this field often — `index: true` on the role axis.
+ *
+ * Named `indexed` rather than `index`: `index` is taken everywhere in JavaScript (an
+ * array position, a module's entry point), and a vocabulary word has to read as what it
+ * says at the call site — `indexed(text())` states a property of the field, `index(...)`
+ * would read as an action on it.
+ *
+ * It changes no answer, only the cost of getting one — which is why it is the one word
+ * here that is a hint rather than a rule. The DDL emits `CREATE INDEX`; nothing else
+ * reads it, and nothing should: a query that only works with the index is a query with
+ * a bug.
+ *
+ * `unique()` already implies one — a uniqueness constraint is backed by an index on
+ * every engine — so declaring both is redundant, not additive.
+ */
+export function indexed(field) {
+    return createField({ ...field, role: { ...field.role, index: true } });
+}
+//# sourceMappingURL=indexed.js.map

package/dist/vocabulary/indexed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexed.js","sourceRoot":"","sources":["../../src/vocabulary/indexed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,OAAO,CAAuB,KAAkB;IAC9D,OAAO,WAAW,CAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/dist/vocabulary/json.d.ts

@@ -0,0 +1,18 @@
+import { type Field, type SchemaLike } from '../field/index.js';
+/**
+ * A JSON value field.
+ *
+ * - `json()` — an OPAQUE value: passes validation unchecked.
+ * - `json(Entity)` — an embedded value object: the entity's SHAPE projection is
+ *   inlined as JSON Schema nesting (`properties`/`required`), so the engine
+ *   validates the nested structure and the portable descriptor carries it verbatim.
+ *
+ * Entity-only on purpose: an arbitrary live validator could not serialise, an
+ * entity's shape can. Only the value axis travels — `role`/`lifecycle`/`boundary` of
+ * the embedded fields are stripped (identity, write rules and wire conversion belong
+ * to the entity standing alone, not to its embedded VALUE form). Shallow consequence:
+ * nested boundaries don't run — a nested date stays its wire string.
+ */
+export declare function json<T = unknown>(): Field<T>;
+export declare function json<E extends SchemaLike & (new (...args: any[]) => any)>(of: E): Field<InstanceType<E>>;
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/vocabulary/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI7E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,CAAC,GAAG,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC;AAC9C,wBAAgB,IAAI,CAAC,CAAC,SAAS,UAAU,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/vocabulary/json.js

@@ -0,0 +1,16 @@
+import { createField } from '../field/index.js';
+import { describe } from '../projections/describe.js';
+export function json(of) {
+    if (!of)
+        return createField({ shape: { type: 'object' } });
+    const card = describe(of);
+    const properties = {};
+    for (const [key, prop] of Object.entries(card.properties)) {
+        const { 'x-fougere': _ext, ...shapeOnly } = prop;
+        properties[key] = shapeOnly;
+    }
+    return createField({
+        shape: { type: 'object', properties, ...(card.required ? { required: card.required } : {}) },
+    });
+}
+//# sourceMappingURL=json.js.map

package/dist/vocabulary/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/vocabulary/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA+B,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAmBtD,MAAM,UAAU,IAAI,CAAC,EAAe;IAClC,IAAI,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1B,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1D,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,SAAS,EAAE,GAAG,IAAuB,CAAC;QACpE,UAAU,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC9B,CAAC;IACD,OAAO,WAAW,CAAC;QACjB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;KAC7F,CAAC,CAAC;AACL,CAAC"}

package/dist/vocabulary/list.d.ts

@@ -0,0 +1,21 @@
+import { type Field } from '../field/index.js';
+export interface ListOptions {
+    /** Minimum number of elements. */
+    min?: number;
+    /** Maximum number of elements. */
+    max?: number;
+}
+/**
+ * A list of VALUES — `tags: list(text())`, `scores: list(number())`. The element's
+ * shape travels as JSON Schema `items`, so the engine validates every element natively.
+ *
+ * NOT a relation: `many(Post)` is a role (related rows, no value shape); `list(text())`
+ * is a value (an array column/JSON, fully owned by the record).
+ *
+ * Only the element's `shape` embeds. Its other axes are meaningless per-element and are
+ * DROPPED SILENTLY — `list(primary())` is accepted and loses the role. The guard below
+ * only rejects a field with no shape at all (a relation). Tightening it to reject a
+ * carried role/lifecycle/boundary is open.
+ */
+export declare function list<T>(item: Field<T, boolean>, opts?: ListOptions): Field<T[]>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/vocabulary/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAK/E"}

package/dist/vocabulary/list.js

@@ -0,0 +1,21 @@
+import { createField } from '../field/index.js';
+/**
+ * A list of VALUES — `tags: list(text())`, `scores: list(number())`. The element's
+ * shape travels as JSON Schema `items`, so the engine validates every element natively.
+ *
+ * NOT a relation: `many(Post)` is a role (related rows, no value shape); `list(text())`
+ * is a value (an array column/JSON, fully owned by the record).
+ *
+ * Only the element's `shape` embeds. Its other axes are meaningless per-element and are
+ * DROPPED SILENTLY — `list(primary())` is accepted and loses the role. The guard below
+ * only rejects a field with no shape at all (a relation). Tightening it to reject a
+ * carried role/lifecycle/boundary is open.
+ */
+export function list(item, opts) {
+    if (!item.shape)
+        throw new Error('list() takes a value field (text(), number()…) — a relation has no value shape');
+    return createField({
+        shape: { type: 'array', items: item.shape, minItems: opts?.min, maxItems: opts?.max },
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/vocabulary/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/vocabulary/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAS5D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,IAAI,CAAI,IAAuB,EAAE,IAAkB;IACjE,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;IACnH,OAAO,WAAW,CAAM;QACtB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE;KACtF,CAAC,CAAC;AACL,CAAC"}

package/dist/vocabulary/many.d.ts

@@ -0,0 +1,8 @@
+import { type EntityConstructor, type Field } from '../field/index.js';
+/**
+ * A collection of related entities — a many-relation role, no value shape of its own.
+ * Pass the target class (`many(Post)`) or, for circular/forward references, a thunk
+ * (`many(() => Post)`).
+ */
+export declare function many<E extends EntityConstructor>(target: E | (() => E)): Field<InstanceType<E>[]>;
+//# sourceMappingURL=many.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"many.d.ts","sourceRoot":"","sources":["../../src/vocabulary/many.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,iBAAiB,EAAE,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEnG;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAIjG"}

package/dist/vocabulary/many.js

@@ -0,0 +1,12 @@
+import { createField, toTargetThunk } from '../field/index.js';
+/**
+ * A collection of related entities — a many-relation role, no value shape of its own.
+ * Pass the target class (`many(Post)`) or, for circular/forward references, a thunk
+ * (`many(() => Post)`).
+ */
+export function many(target) {
+    return createField({
+        role: { relation: { to: toTargetThunk(target), kind: 'many' } },
+    });
+}
+//# sourceMappingURL=many.js.map

package/dist/vocabulary/many.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"many.js","sourceRoot":"","sources":["../../src/vocabulary/many.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAsC,MAAM,mBAAmB,CAAC;AAEnG;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAA8B,MAAqB;IACrE,OAAO,WAAW,CAAoB;QACpC,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;KAChE,CAAC,CAAC;AACL,CAAC"}

package/dist/vocabulary/nullable.d.ts

@@ -0,0 +1,9 @@
+import { type Field } from '../field/index.js';
+/**
+ * Make `null` a legal VALUE without touching presence — the field stays required
+ * at creation (the missing quadrant: "nullable but required"). The caller must
+ * say something, and "nothing to report" (`null`) is an acceptable answer.
+ * For null-legal-and-omissible, use `optional()`.
+ */
+export declare function nullable<T>(field: Field<T>): Field<T | null>;
+//# sourceMappingURL=nullable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nullable.d.ts","sourceRoot":"","sources":["../../src/vocabulary/nullable.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAI5D"}

package/dist/vocabulary/nullable.js

@@ -0,0 +1,13 @@
+import { cloneField, nullableShape } from '../field/index.js';
+/**
+ * Make `null` a legal VALUE without touching presence — the field stays required
+ * at creation (the missing quadrant: "nullable but required"). The caller must
+ * say something, and "nothing to report" (`null`) is an acceptable answer.
+ * For null-legal-and-omissible, use `optional()`.
+ */
+export function nullable(field) {
+    return cloneField(field, {
+        shape: field.shape && nullableShape(field.shape),
+    });
+}
+//# sourceMappingURL=nullable.js.map

package/dist/vocabulary/nullable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullable.js","sourceRoot":"","sources":["../../src/vocabulary/nullable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAc,MAAM,mBAAmB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAI,KAAe;IACzC,OAAO,UAAU,CAAC,KAAK,EAAE;QACvB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC;KACjD,CAAoB,CAAC;AACxB,CAAC"}

package/dist/vocabulary/number.d.ts

@@ -0,0 +1,10 @@
+import { type Field } from '../field/index.js';
+export interface NumberOptions {
+    min?: number;
+    max?: number;
+    integer?: boolean;
+    default?: number;
+    description?: string;
+}
+export declare function number(opts?: NumberOptions): Field<number>;
+//# sourceMappingURL=number.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/vocabulary/number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAM1D"}

package/dist/vocabulary/number.js

@@ -0,0 +1,9 @@
+import { createField } from '../field/index.js';
+export function number(opts) {
+    return createField({
+        shape: { type: opts?.integer ? 'integer' : 'number', minimum: opts?.min, maximum: opts?.max },
+        lifecycle: opts?.default !== undefined ? { create: { value: opts.default } } : undefined,
+        meta: opts?.description !== undefined ? { description: opts.description } : undefined,
+    });
+}
+//# sourceMappingURL=number.js.map

package/dist/vocabulary/number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../src/vocabulary/number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAU5D,MAAM,UAAU,MAAM,CAAC,IAAoB;IACzC,OAAO,WAAW,CAAS;QACzB,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE;QAC7F,SAAS,EAAE,IAAI,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS;QACxF,IAAI,EAAE,IAAI,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;KACtF,CAAC,CAAC;AACL,CAAC"}

package/dist/vocabulary/oneOf.d.ts

@@ -0,0 +1,16 @@
+import { type Field } from '../field/index.js';
+interface OneOfOptions<V extends string = string> {
+    description?: string;
+    /**
+     * Value filled at create when the input omits the field (same as text/number/bool).
+     *
+     * Typed to the members, not to `string`: a default is written into every row without
+     * passing the client judge, so `oneOf('draft', 'published', { default: 'typo' })` used
+     * to compile and produce rows the entity's own `validate` refuses.
+     */
+    default?: V;
+}
+export declare function oneOf<const T extends readonly string[]>(...values: [...T]): Field<T[number]>;
+export declare function oneOf<const T extends readonly string[]>(...args: [...T, OneOfOptions<T[number]>]): Field<T[number]>;
+export {};
+//# sourceMappingURL=oneOf.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oneOf.d.ts","sourceRoot":"","sources":["../../src/vocabulary/oneOf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE5D,UAAU,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC;CACb;AAID,wBAAgB,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9F,wBAAgB,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EACrD,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GACvC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/vocabulary/oneOf.js

@@ -0,0 +1,13 @@
+import { createField } from '../field/index.js';
+export function oneOf(...args) {
+    const last = args[args.length - 1];
+    const hasOpts = typeof last === 'object' && last !== null && !Array.isArray(last);
+    const values = (hasOpts ? args.slice(0, -1) : args);
+    const opts = hasOpts ? last : {};
+    return createField({
+        shape: { type: 'string', enum: values },
+        lifecycle: opts.default !== undefined ? { create: { value: opts.default } } : undefined,
+        meta: opts.description !== undefined ? { description: opts.description } : undefined,
+    });
+}
+//# sourceMappingURL=oneOf.js.map

package/dist/vocabulary/oneOf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneOf.js","sourceRoot":"","sources":["../../src/vocabulary/oneOf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAoB5D,MAAM,UAAU,KAAK,CACnB,GAAG,IAA8C;IAEjD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAiC,CAAC;IACpF,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAE,IAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,OAAO,WAAW,CAAY;QAC5B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE;QACvC,SAAS,EAAE,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS;QACvF,IAAI,EAAE,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;KACrF,CAAC,CAAC;AACL,CAAC"}

package/dist/vocabulary/optional.d.ts

@@ -0,0 +1,10 @@
+import { type Field } from '../field/index.js';
+/**
+ * Make a field nullable AND omissible at creation — `null` enters the shape's
+ * grammar (the `[T,'null']` union) and the lifecycle permits absence. The two
+ * moves are independent: for null-legal-but-still-required, use `nullable()`.
+ * An existing create rule (a default) wins over `'optional'` — it already
+ * answers absence, and with a value rather than an omission.
+ */
+export declare function optional<T>(field: Field<T>): Field<T | null, true>;
+//# sourceMappingURL=optional.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optional.d.ts","sourceRoot":"","sources":["../../src/vocabulary/optional.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1E;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAKlE"}

package/dist/vocabulary/optional.js

@@ -0,0 +1,15 @@
+import { cloneField, nullableShape } from '../field/index.js';
+/**
+ * Make a field nullable AND omissible at creation — `null` enters the shape's
+ * grammar (the `[T,'null']` union) and the lifecycle permits absence. The two
+ * moves are independent: for null-legal-but-still-required, use `nullable()`.
+ * An existing create rule (a default) wins over `'optional'` — it already
+ * answers absence, and with a value rather than an omission.
+ */
+export function optional(field) {
+    return cloneField(field, {
+        shape: field.shape && nullableShape(field.shape),
+        lifecycle: { ...field.lifecycle, create: field.lifecycle?.create ?? 'optional' },
+    });
+}
+//# sourceMappingURL=optional.js.map

package/dist/vocabulary/optional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional.js","sourceRoot":"","sources":["../../src/vocabulary/optional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAc,MAAM,mBAAmB,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAI,KAAe;IACzC,OAAO,UAAU,CAAC,KAAK,EAAE;QACvB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC;QAChD,SAAS,EAAE,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,IAAI,UAAU,EAAE;KACjF,CAA0B,CAAC;AAC9B,CAAC"}

package/dist/vocabulary/primary.d.ts

@@ -0,0 +1,22 @@
+import { type Field, type GeneratorRef } from '../field/index.js';
+interface PrimaryOptions {
+    /**
+     * Generator token: a built-in preset, a name registered via
+     * `registerGenerator`, or the colocated `[name, fn]` tuple — which registers
+     * and names in one gesture (the Field only ever carries the name).
+     */
+    generate?: GeneratorRef | [name: string, fn: () => string];
+}
+/**
+ * Create a primary key field.
+ *
+ * - `primary()` — auto-generated CUID2 string ID (default)
+ * - `primary({ generate: 'uuid' })` — auto-generated UUID v4
+ * - `primary({ generate: ['monId', fn] })` — custom generator, registered + named
+ * - `primary(field)` — promote any field to primary key (no auto-generation;
+ *   the value must be supplied, so its `auto` flag is preserved)
+ */
+export declare function primary(opts?: PrimaryOptions): Field<string, true>;
+export declare function primary<T, A extends boolean>(field: Field<T, A>): Field<T, A>;
+export {};
+//# sourceMappingURL=primary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primary.d.ts","sourceRoot":"","sources":["../../src/vocabulary/primary.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,KAAK,EACV,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAE3B,UAAU,cAAc;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC,CAAC;CAC5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACpE,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/vocabulary/primary.js

@@ -0,0 +1,31 @@
+import { cloneField, createField, registerGenerator, } from '../field/index.js';
+export function primary(fieldOrOptions) {
+    // primary(field) — promote an existing field to primary key. cloneField keeps
+    // every axis (boundary, meta…); the role gains `primary`, and identity in the
+    // graph implies immutability in time: `update: 'forbidden'` (decided 2026-07-15).
+    if (fieldOrOptions && '__brand' in fieldOrOptions && fieldOrOptions.__brand === 'fougere_field') {
+        const field = fieldOrOptions;
+        return cloneField(field, {
+            role: { ...field.role, primary: true },
+            lifecycle: { ...field.lifecycle, update: 'forbidden' },
+        });
+    }
+    // primary() or primary({ generate }) — auto-generated string ID
+    const opts = (fieldOrOptions ?? {});
+    let generate;
+    if (Array.isArray(opts.generate)) {
+        const [name, fn] = opts.generate;
+        registerGenerator(name, fn);
+        generate = name;
+    }
+    else {
+        generate = opts.generate ?? 'cuid2';
+    }
+    return createField({
+        shape: { type: 'string' },
+        role: { primary: true },
+        // An id is immutable by default: re-supplying it in a patch is an error.
+        lifecycle: { create: { generate }, update: 'forbidden' },
+    });
+}
+//# sourceMappingURL=primary.js.map

package/dist/vocabulary/primary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primary.js","sourceRoot":"","sources":["../../src/vocabulary/primary.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,EACX,iBAAiB,GAIlB,MAAM,mBAAmB,CAAC;AAsB3B,MAAM,UAAU,OAAO,CAAC,cAA0C;IAChE,8EAA8E;IAC9E,8EAA8E;IAC9E,kFAAkF;IAClF,IAAI,cAAc,IAAI,SAAS,IAAI,cAAc,IAAI,cAAc,CAAC,OAAO,KAAK,eAAe,EAAE,CAAC;QAChG,MAAM,KAAK,GAAG,cAAc,CAAC;QAC7B,OAAO,UAAU,CAAC,KAAK,EAAE;YACvB,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;YACtC,SAAS,EAAE,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE;SACvD,CAAC,CAAC;IACL,CAAC;IAED,gEAAgE;IAChE,MAAM,IAAI,GAAG,CAAC,cAAc,IAAI,EAAE,CAAmB,CAAC;IACtD,IAAI,QAAsB,CAAC;IAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACjC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5B,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC;IACtC,CAAC;IACD,OAAO,WAAW,CAAe;QAC/B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QACvB,yEAAyE;QACzE,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;KACzD,CAAC,CAAC;AACL,CAAC"}

package/dist/vocabulary/readOnly.d.ts

@@ -0,0 +1,10 @@
+import { type Field } from '../field/index.js';
+/**
+ * Close the field's INBOUND direction — emitted normally, never accepted from
+ * a client (a server-owned field, e.g. a computed counter). Supplying it in a
+ * create or patch input is a validation error ("Read-only"); its absence is
+ * never "Required" (the server provides it). Input types exclude it.
+ * The outbound direction (and its conversion) is untouched.
+ */
+export declare function readOnly<T, A extends boolean>(field: Field<T, A>): Field<T, A>;
+//# sourceMappingURL=readOnly.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readOnly.d.ts","sourceRoot":"","sources":["../../src/vocabulary/readOnly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAE9E"}

package/dist/vocabulary/readOnly.js

@@ -0,0 +1,12 @@
+import { createField, declaredBoundary } from '../field/index.js';
+/**
+ * Close the field's INBOUND direction — emitted normally, never accepted from
+ * a client (a server-owned field, e.g. a computed counter). Supplying it in a
+ * create or patch input is a validation error ("Read-only"); its absence is
+ * never "Required" (the server provides it). Input types exclude it.
+ * The outbound direction (and its conversion) is untouched.
+ */
+export function readOnly(field) {
+    return createField({ ...field, boundary: { ...declaredBoundary(field), in: 'closed' } });
+}
+//# sourceMappingURL=readOnly.js.map

package/dist/vocabulary/readOnly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readOnly.js","sourceRoot":"","sources":["../../src/vocabulary/readOnly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAc,MAAM,mBAAmB,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAuB,KAAkB;IAC/D,OAAO,WAAW,CAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;AACjG,CAAC"}

package/dist/vocabulary/ref.d.ts

@@ -0,0 +1,12 @@
+import { type EntityConstructor, type Field } from '../field/index.js';
+export interface RefOptions {
+    cascade?: boolean;
+}
+/**
+ * A reference to another entity — a foreign-key string plus a one-relation role.
+ * Pass the target class (`ref(Author)`) or, for circular/forward references, a
+ * thunk (`ref(() => Author)`). For a nullable FK, wrap it: `optional(ref(Author))`
+ * — that path also flips the type to `string | null` (which `ref` alone never did).
+ */
+export declare function ref<E extends EntityConstructor>(target: E | (() => E), opts?: RefOptions): Field<string>;
+//# sourceMappingURL=ref.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../src/vocabulary/ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,iBAAiB,EAAE,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEnG,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAWxG"}

package/dist/vocabulary/ref.js

@@ -0,0 +1,20 @@
+import { createField, toTargetThunk } from '../field/index.js';
+/**
+ * A reference to another entity — a foreign-key string plus a one-relation role.
+ * Pass the target class (`ref(Author)`) or, for circular/forward references, a
+ * thunk (`ref(() => Author)`). For a nullable FK, wrap it: `optional(ref(Author))`
+ * — that path also flips the type to `string | null` (which `ref` alone never did).
+ */
+export function ref(target, opts) {
+    return createField({
+        shape: { type: 'string' },
+        role: {
+            relation: {
+                to: toTargetThunk(target),
+                kind: 'one',
+                onDelete: opts?.cascade ? 'cascade' : undefined,
+            },
+        },
+    });
+}
+//# sourceMappingURL=ref.js.map

package/dist/vocabulary/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../../src/vocabulary/ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAsC,MAAM,mBAAmB,CAAC;AAMnG;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAA8B,MAAqB,EAAE,IAAiB;IACvF,OAAO,WAAW,CAAS;QACzB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,IAAI,EAAE;YACJ,QAAQ,EAAE;gBACR,EAAE,EAAE,aAAa,CAAC,MAAM,CAAC;gBACzB,IAAI,EAAE,KAAK;gBACX,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;aAChD;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/vocabulary/text.d.ts

@@ -0,0 +1,12 @@
+import { type Field, type StringFormat } from '../field/index.js';
+export interface TextOptions {
+    min?: number;
+    max?: number;
+    pattern?: string;
+    /** JSON Schema format predicate (email, uuid, uri, date, time…), asserted by the engine. */
+    format?: StringFormat;
+    default?: string;
+    description?: string;
+}
+export declare function text(opts?: TextOptions): Field<string>;
+//# sourceMappingURL=text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/vocabulary/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAMtD"}

package/dist/vocabulary/text.js

@@ -0,0 +1,9 @@
+import { createField } from '../field/index.js';
+export function text(opts) {
+    return createField({
+        shape: { type: 'string', minLength: opts?.min, maxLength: opts?.max, pattern: opts?.pattern, format: opts?.format },
+        lifecycle: opts?.default !== undefined ? { create: { value: opts.default } } : undefined,
+        meta: opts?.description !== undefined ? { description: opts.description } : undefined,
+    });
+}
+//# sourceMappingURL=text.js.map

package/dist/vocabulary/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/vocabulary/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiC,MAAM,mBAAmB,CAAC;AAY/E,MAAM,UAAU,IAAI,CAAC,IAAkB;IACrC,OAAO,WAAW,CAAS;QACzB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;QACnH,SAAS,EAAE,IAAI,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS;QACxF,IAAI,EAAE,IAAI,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;KACtF,CAAC,CAAC;AACL,CAAC"}

package/dist/vocabulary/unique.d.ts

@@ -0,0 +1,23 @@
+import { type Field } from '../field/index.js';
+/**
+ * No two rows may carry the same value — a unique constraint of one, on the role axis.
+ *
+ * The role axis is where it belongs because uniqueness is a fact about the field's
+ * place in the entity, not about the values it accepts: `text({ max: 80 })` says what
+ * a slug looks like, `unique(...)` says there is only one of each. A shape cannot
+ * express it — judging a single value can never see the other rows.
+ *
+ * So the realization is the storage's, and only the storage's: the DDL emits the
+ * constraint, the database enforces it on every write, including writes Fougere never
+ * saw. A collision surfaces as the driver's error, not as a `validate()` failure.
+ *
+ * It also travels: `describe()` carries `role.unique` on the card, so a consumer in
+ * another language reads the same promise — one that is now kept.
+ *
+ * The group is `[]` — the empty member list denoting THIS field, because a field does not
+ * know its own key here: `slug` is named by the object literal `entity({...})` receives,
+ * one call up. Keeping it empty rather than filling it in later means nothing to remap
+ * when `rename()` moves the key, and one shape shared with the composite form.
+ */
+export declare function unique<T, A extends boolean>(field: Field<T, A>): Field<T, A>;
+//# sourceMappingURL=unique.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unique.d.ts","sourceRoot":"","sources":["../../src/vocabulary/unique.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAE5E"}

package/dist/vocabulary/unique.js

@@ -0,0 +1,25 @@
+import { createField } from '../field/index.js';
+/**
+ * No two rows may carry the same value — a unique constraint of one, on the role axis.
+ *
+ * The role axis is where it belongs because uniqueness is a fact about the field's
+ * place in the entity, not about the values it accepts: `text({ max: 80 })` says what
+ * a slug looks like, `unique(...)` says there is only one of each. A shape cannot
+ * express it — judging a single value can never see the other rows.
+ *
+ * So the realization is the storage's, and only the storage's: the DDL emits the
+ * constraint, the database enforces it on every write, including writes Fougere never
+ * saw. A collision surfaces as the driver's error, not as a `validate()` failure.
+ *
+ * It also travels: `describe()` carries `role.unique` on the card, so a consumer in
+ * another language reads the same promise — one that is now kept.
+ *
+ * The group is `[]` — the empty member list denoting THIS field, because a field does not
+ * know its own key here: `slug` is named by the object literal `entity({...})` receives,
+ * one call up. Keeping it empty rather than filling it in later means nothing to remap
+ * when `rename()` moves the key, and one shape shared with the composite form.
+ */
+export function unique(field) {
+    return createField({ ...field, role: { ...field.role, unique: [[]] } });
+}
+//# sourceMappingURL=unique.js.map

package/dist/vocabulary/unique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique.js","sourceRoot":"","sources":["../../src/vocabulary/unique.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,MAAM,CAAuB,KAAkB;IAC7D,OAAO,WAAW,CAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/dist/vocabulary/updated.d.ts

@@ -0,0 +1,8 @@
+import { type Field } from '../field/index.js';
+/**
+ * `auto()`, plus the update stamp — the canonical `updatedAt` (Prisma
+ * `@updatedAt`, Kysely-side `$onUpdate` equivalents). The only new fact is `update: 'now'`;
+ * shape and creation rule are auto()'s, stated once there.
+ */
+export declare function updated(): Field<Date, true>;
+//# sourceMappingURL=updated.d.ts.map

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

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