@cogenta/schema 0.1.0

package/dist/define-collection.d.ts

@@ -0,0 +1,8 @@
+import { type CollectionDefinition } from './types.js';
+export declare function defineCollection<const TDefinition extends CollectionDefinition>(definition: TDefinition): TDefinition;
+/**
+ * Cross-collection checks, which no single `defineCollection` call can make:
+ * a relation only knows the *name* of its target.
+ */
+export declare function validateCollectionSet(collections: readonly CollectionDefinition[]): void;
+//# sourceMappingURL=define-collection.d.ts.map

package/dist/define-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-collection.d.ts","sourceRoot":"","sources":["../src/define-collection.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,oBAAoB,EAG1B,MAAM,YAAY,CAAA;AA4BnB,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,WAAW,SAAS,oBAAoB,EAC7E,UAAU,EAAE,WAAW,GACtB,WAAW,CAMb;AAsSD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,GAAG,IAAI,CAyBxF"}

package/dist/define-collection.js

@@ -0,0 +1,311 @@
+import { schemaError } from './errors.js';
+import { MEDIA_ACCEPT_KINDS } from './fields.js';
+import { isSystemFieldName } from './system-fields.js';
+import { CONTENT_ACTIONS, FIELD_KINDS, } from './types.js';
+import { fieldSchema } from './validation.js';
+/**
+ * `defineCollection` is the only door into the content model.
+ *
+ * It checks the definition eagerly, at import time, because everything
+ * downstream — types, migrations, admin, API — is generated from it. A schema
+ * mistake caught here costs a restart; the same mistake caught at migration
+ * time costs a database.
+ */
+/** Table-safe: the collection name becomes an identifier on three dialects. */
+const COLLECTION_NAME_PATTERN = /^[a-z][a-z0-9_]*$/;
+/** Property-safe: the field name becomes a TypeScript property and a column. */
+const FIELD_NAME_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+const ROUTE_PARAMETER_PATTERN = /:([a-zA-Z_][a-zA-Z0-9_]*)/g;
+const INDEX_DIRECTIONS = new Set(['asc', 'desc']);
+const ACTION_SET = new Set(CONTENT_ACTIONS);
+const KIND_SET = new Set(FIELD_KINDS);
+const ACCEPT_SET = new Set(MEDIA_ACCEPT_KINDS);
+export function defineCollection(definition) {
+    const issues = collectIssues(definition);
+    if (issues.length > 0) {
+        throw schemaError(definition.name ?? '(unnamed)', issues);
+    }
+    return definition;
+}
+function collectIssues(definition) {
+    const issues = [];
+    if (typeof definition.name !== 'string' || !COLLECTION_NAME_PATTERN.test(definition.name)) {
+        issues.push({
+            path: 'name',
+            message: 'must be a lowercase identifier such as "article" or "blog_post"',
+        });
+    }
+    if (definition.labels?.singular === undefined || definition.labels.singular === '') {
+        issues.push({ path: 'labels.singular', message: 'is required' });
+    }
+    if (definition.labels?.plural === undefined || definition.labels.plural === '') {
+        issues.push({ path: 'labels.plural', message: 'is required' });
+    }
+    const fields = definition.fields;
+    const fieldNames = fields === undefined ? [] : Object.keys(fields);
+    if (fieldNames.length === 0) {
+        issues.push({ path: 'fields', message: 'a collection needs at least one field' });
+    }
+    for (const name of fieldNames) {
+        checkField(name, fields[name], fieldNames, issues);
+    }
+    checkRouting(definition, fieldNames, issues);
+    checkIndexes(definition, fieldNames, issues);
+    checkPermissions(definition, issues);
+    checkVersioning(definition, issues);
+    return issues;
+}
+function checkField(name, field, fieldNames, issues) {
+    const path = `fields.${name}`;
+    if (!FIELD_NAME_PATTERN.test(name)) {
+        issues.push({ path, message: 'field name must be a valid identifier' });
+    }
+    // A collection cannot redeclare a system field: the runtime owns `status`,
+    // `locale` and `provenance`, and a shadowing column would be written twice
+    // with different meanings.
+    if (isSystemFieldName(name)) {
+        issues.push({ path, message: `"${name}" is a system field and cannot be redeclared` });
+        return;
+    }
+    if (field === undefined || typeof field !== 'object' || !KIND_SET.has(field.kind)) {
+        issues.push({ path, message: 'must be built with an `f.*` constructor' });
+        return;
+    }
+    switch (field.kind) {
+        case 'relation':
+            checkRelation(path, field, issues);
+            break;
+        case 'select':
+            checkSelect(path, field, issues);
+            break;
+        case 'slug':
+            checkSlug(path, field, fieldNames, issues);
+            break;
+        case 'media':
+            checkMedia(path, field, issues);
+            break;
+        case 'blocks':
+            checkBlocks(path, field, issues);
+            break;
+        default:
+            break;
+    }
+    const showWhen = field.admin?.showWhen;
+    if (showWhen !== undefined && !fieldNames.includes(showWhen.field)) {
+        issues.push({
+            path: `${path}.admin.showWhen.field`,
+            message: `refers to "${showWhen.field}", which this collection does not declare`,
+        });
+    }
+    checkDefault(path, field, issues);
+}
+function checkRelation(path, field, issues) {
+    const to = field.options.to;
+    if (typeof to !== 'string' || to === '') {
+        issues.push({ path: `${path}.to`, message: 'a relation must name the collection it points to' });
+    }
+    // Contract A: `'setNull'` only makes sense on a to-one, non-required
+    // relation. Anywhere else it describes an impossible row.
+    if (field.options.onDelete === 'setNull') {
+        if (field.options.many === true) {
+            issues.push({
+                path: `${path}.onDelete`,
+                message: "'setNull' is meaningless on a to-many relation; use 'cascade' or 'restrict'",
+            });
+        }
+        if (field.required === true) {
+            issues.push({
+                path: `${path}.onDelete`,
+                message: "'setNull' cannot apply to a required field, which may never be null",
+            });
+        }
+    }
+}
+function checkSelect(path, field, issues) {
+    const options = field.options.options;
+    if (!Array.isArray(options) || options.length === 0) {
+        issues.push({ path: `${path}.options`, message: 'a select needs at least one option' });
+        return;
+    }
+    const seen = new Set();
+    for (const choice of options) {
+        const value = typeof choice === 'object' && choice !== null && 'value' in choice
+            ? String(choice.value)
+            : String(choice);
+        if (value === '') {
+            issues.push({ path: `${path}.options`, message: 'an option value cannot be empty' });
+        }
+        if (seen.has(value)) {
+            issues.push({ path: `${path}.options`, message: `duplicate option value "${value}"` });
+        }
+        seen.add(value);
+    }
+}
+function checkSlug(path, field, fieldNames, issues) {
+    const from = field.options.from;
+    if (from !== undefined && !fieldNames.includes(String(from))) {
+        issues.push({
+            path: `${path}.from`,
+            message: `refers to "${String(from)}", which this collection does not declare`,
+        });
+    }
+}
+function checkMedia(path, field, issues) {
+    const accept = field.options.accept;
+    if (!Array.isArray(accept) || accept.length === 0) {
+        issues.push({ path: `${path}.accept`, message: 'must accept at least one kind of media' });
+        return;
+    }
+    for (const kind of accept) {
+        if (!ACCEPT_SET.has(String(kind))) {
+            issues.push({
+                path: `${path}.accept`,
+                message: `unknown media kind "${String(kind)}"; expected one of ${[...ACCEPT_SET].join(', ')}`,
+            });
+        }
+    }
+}
+function checkBlocks(path, field, issues) {
+    const allow = field.options.allow;
+    if (allow === '*')
+        return;
+    if (!Array.isArray(allow) || allow.length === 0) {
+        issues.push({
+            path: `${path}.allow`,
+            message: "must be '*' or a non-empty list of block names",
+        });
+        return;
+    }
+    for (const name of allow) {
+        if (typeof name !== 'string' || name === '') {
+            issues.push({ path: `${path}.allow`, message: 'block names must be non-empty strings' });
+        }
+    }
+}
+/**
+ * A default that the field itself would reject is a bug that only shows up the
+ * first time an editor creates an entry — long after the schema was written.
+ */
+function checkDefault(path, field, issues) {
+    if (field.default === undefined)
+        return;
+    const result = fieldSchema(field).safeParse(field.default);
+    if (!result.success) {
+        const reason = result.error.issues[0]?.message ?? 'is not a valid value for this field';
+        issues.push({ path: `${path}.default`, message: `${reason} (default value)` });
+    }
+}
+function checkRouting(definition, fieldNames, issues) {
+    const routing = definition.routing;
+    if (routing === undefined)
+        return;
+    if (typeof routing.pattern !== 'string' || !routing.pattern.startsWith('/')) {
+        issues.push({ path: 'routing.pattern', message: 'must start with "/"' });
+        return;
+    }
+    for (const match of routing.pattern.matchAll(ROUTE_PARAMETER_PATTERN)) {
+        const parameter = match[1];
+        if (parameter === undefined)
+            continue;
+        // `:locale` is served by the system field of the same name; anything else
+        // has to come from a declared field, or the route can never be built.
+        if (parameter === 'locale' || fieldNames.includes(parameter))
+            continue;
+        issues.push({
+            path: 'routing.pattern',
+            message: `":${parameter}" does not match any field of this collection`,
+        });
+    }
+}
+function checkIndexes(definition, fieldNames, issues) {
+    const indexes = definition.indexes;
+    if (indexes === undefined)
+        return;
+    for (const [position, index] of indexes.entries()) {
+        const path = `indexes[${position}]`;
+        if (!Array.isArray(index) || index.length === 0) {
+            issues.push({ path, message: 'an index needs at least one field' });
+            continue;
+        }
+        for (const [column, entry] of index.entries()) {
+            // The contract writes a direction as the last element: ['publishedAt', 'desc'].
+            const isTrailingDirection = column === index.length - 1 && INDEX_DIRECTIONS.has(entry);
+            if (isTrailingDirection)
+                continue;
+            if (fieldNames.includes(entry) || isSystemFieldName(entry))
+                continue;
+            issues.push({
+                path,
+                message: `"${entry}" is neither a field of this collection nor a system field`,
+            });
+        }
+    }
+}
+function checkPermissions(definition, issues) {
+    const permissions = definition.permissions;
+    if (permissions === undefined || typeof permissions !== 'object') {
+        issues.push({ path: 'permissions', message: 'is required' });
+        return;
+    }
+    for (const [action, roles] of Object.entries(permissions)) {
+        if (!ACTION_SET.has(action)) {
+            issues.push({
+                path: `permissions.${action}`,
+                message: `unknown action; the fixed set is ${CONTENT_ACTIONS.join(', ')}`,
+            });
+            continue;
+        }
+        if (!Array.isArray(roles)) {
+            issues.push({ path: `permissions.${action}`, message: 'must be a list of role names' });
+            continue;
+        }
+        for (const role of roles) {
+            if (typeof role !== 'string' || role === '') {
+                issues.push({
+                    path: `permissions.${action}`,
+                    message: 'role names must be non-empty strings',
+                });
+            }
+        }
+    }
+}
+function checkVersioning(definition, issues) {
+    const keep = definition.versioning?.keep;
+    if (keep === undefined)
+        return;
+    if (!Number.isInteger(keep) || keep < 1) {
+        issues.push({ path: 'versioning.keep', message: 'must be a positive whole number of versions' });
+    }
+}
+/**
+ * Cross-collection checks, which no single `defineCollection` call can make:
+ * a relation only knows the *name* of its target.
+ */
+export function validateCollectionSet(collections) {
+    const names = new Set();
+    for (const collection of collections) {
+        if (names.has(collection.name)) {
+            throw schemaError(collection.name, [
+                { path: 'name', message: 'two collections share this name' },
+            ]);
+        }
+        names.add(collection.name);
+    }
+    for (const collection of collections) {
+        const issues = [];
+        for (const [name, field] of Object.entries(collection.fields)) {
+            if (field.kind !== 'relation')
+                continue;
+            const target = String(field.options.to);
+            if (!names.has(target)) {
+                issues.push({
+                    path: `fields.${name}.to`,
+                    message: `points at "${target}", which no collection defines`,
+                });
+            }
+        }
+        if (issues.length > 0)
+            throw schemaError(collection.name, issues);
+    }
+}
+//# sourceMappingURL=define-collection.js.map

package/dist/define-collection.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+import { CogentaError } from '@cogenta/core';
+/** One thing wrong with a definition, located by a dotted path. */
+export interface SchemaIssue {
+    /** `fields.title.max`, `permissions.read`, `routing.pattern`… */
+    readonly path: string;
+    readonly message: string;
+}
+/**
+ * Every issue found in one definition, reported at once.
+ *
+ * Reporting the first problem only turns fixing a schema into a game of
+ * whack-a-mole: one `cogenta generate` per typo. The path is what names the
+ * offending field, which is the whole point of this error.
+ */
+export declare function schemaError(collection: string, issues: readonly SchemaIssue[]): CogentaError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,YAAY,CAS5F"}

package/dist/errors.js

@@ -0,0 +1,18 @@
+import { CogentaError } from '@cogenta/core';
+/**
+ * Every issue found in one definition, reported at once.
+ *
+ * Reporting the first problem only turns fixing a schema into a game of
+ * whack-a-mole: one `cogenta generate` per typo. The path is what names the
+ * offending field, which is the whole point of this error.
+ */
+export function schemaError(collection, issues) {
+    const lines = issues.map((issue) => `  ${issue.path}: ${issue.message}`).join('\n');
+    return new CogentaError({
+        code: 'SCHEMA_INVALID',
+        message: `Collection "${collection}" is not a valid schema:\n${lines}`,
+        hint: 'Fix the fields listed above in the collection file, then run `cogenta generate` again.',
+        details: { collection, issues },
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAS5C;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,MAA8B;IAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEnF,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,eAAe,UAAU,6BAA6B,KAAK,EAAE;QACtE,IAAI,EAAE,wFAAwF;QAC9F,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;KAChC,CAAC,CAAA;AACJ,CAAC"}

package/dist/fields.d.ts

@@ -0,0 +1,117 @@
+import type { BaseFieldOptions, FieldDefinition, OnDelete } from './types.js';
+export interface TextFieldOptions extends BaseFieldOptions {
+    readonly min?: number;
+    readonly max?: number;
+    /** Hint for the admin: render a textarea rather than a single-line input. */
+    readonly multiline?: boolean;
+}
+export interface SlugFieldOptions extends BaseFieldOptions {
+    /** Field the admin derives the slug from when the editor has not typed one. */
+    readonly from?: string;
+    readonly max?: number;
+}
+export interface NumberFieldOptions extends BaseFieldOptions {
+    readonly min?: number;
+    readonly max?: number;
+    readonly integer?: boolean;
+}
+export declare const MEDIA_ACCEPT_KINDS: readonly ['image', 'video', 'audio', 'file'];
+export type MediaAcceptKind = (typeof MEDIA_ACCEPT_KINDS)[number];
+export interface MediaFieldOptions extends BaseFieldOptions {
+    readonly accept?: readonly MediaAcceptKind[];
+    readonly many?: boolean;
+}
+export interface RelationFieldOptions extends BaseFieldOptions {
+    /** Name of the target collection. */
+    readonly to: string;
+    readonly many?: boolean;
+    readonly onDelete?: OnDelete;
+}
+/** A choice is a value plus what the editor reads. Bare strings are widened. */
+export interface SelectChoice {
+    readonly value: string;
+    readonly label?: string;
+}
+export interface SelectFieldOptions extends BaseFieldOptions {
+    readonly options: readonly (string | SelectChoice)[];
+    readonly many?: boolean;
+}
+export interface BlocksFieldOptions extends BaseFieldOptions {
+    /** `'*'` allows the whole vocabulary; a list restricts it. */
+    readonly allow?: '*' | readonly string[];
+}
+export declare const f: {
+    readonly text: (options?: TextFieldOptions) => FieldDefinition & {
+        readonly kind: "text";
+        readonly options: Readonly<Record<string, unknown>>;
+    };
+    readonly richText: (options?: BaseFieldOptions) => FieldDefinition & {
+        readonly kind: "richText";
+        readonly options: {};
+    };
+    readonly slug: (options?: SlugFieldOptions) => FieldDefinition & {
+        readonly kind: "slug";
+        readonly options: Readonly<Record<string, unknown>>;
+    };
+    readonly number: (options?: NumberFieldOptions) => FieldDefinition & {
+        readonly kind: "number";
+        readonly options: Readonly<Record<string, unknown>>;
+    };
+    readonly boolean: (options?: BaseFieldOptions) => FieldDefinition & {
+        readonly kind: "boolean";
+        readonly options: {};
+    };
+    /** Calendar day, no time zone: `YYYY-MM-DD`. */
+    readonly date: (options?: BaseFieldOptions) => FieldDefinition & {
+        readonly kind: "date";
+        readonly options: {};
+    };
+    /** Instant, stored as ISO 8601 with an offset. */
+    readonly datetime: (options?: BaseFieldOptions) => FieldDefinition & {
+        readonly kind: "datetime";
+        readonly options: {};
+    };
+    readonly media: (options?: MediaFieldOptions) => FieldDefinition & {
+        readonly kind: "media";
+        readonly options: {
+            accept: readonly ("audio" | "file" | "image" | "video")[];
+            many: boolean;
+        };
+    };
+    readonly relation: (options: RelationFieldOptions) => FieldDefinition & {
+        readonly kind: "relation";
+        readonly options: {
+            to: string;
+            many: boolean;
+            onDelete: OnDelete;
+        };
+    };
+    readonly select: (options: SelectFieldOptions) => FieldDefinition & {
+        readonly kind: "select";
+        readonly options: {
+            options: readonly SelectChoice[];
+            many: boolean;
+        };
+    };
+    readonly json: (options?: BaseFieldOptions) => FieldDefinition & {
+        readonly kind: "json";
+        readonly options: {};
+    };
+    /** A point on the globe: `{ lat, lng }`, degrees, WGS 84. */
+    readonly geo: (options?: BaseFieldOptions) => FieldDefinition & {
+        readonly kind: "geo";
+        readonly options: {};
+    };
+    /** Hex notation, `#rgb`, `#rrggbb` or `#rrggbbaa`. */
+    readonly color: (options?: BaseFieldOptions) => FieldDefinition & {
+        readonly kind: "color";
+        readonly options: {};
+    };
+    readonly blocks: (options?: BlocksFieldOptions) => FieldDefinition & {
+        readonly kind: "blocks";
+        readonly options: {
+            allow: "*" | readonly string[];
+        };
+    };
+};
+//# sourceMappingURL=fields.d.ts.map

package/dist/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAa,QAAQ,EAAE,MAAM,YAAY,CAAA;AAyCxF,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,eAAO,MAAM,kBAAkB,YAAI,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAA;AAE9E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjE,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,qCAAqC;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAC7B;AAED,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,GAAG,YAAY,CAAC,EAAE,CAAA;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG,SAAS,MAAM,EAAE,CAAA;CACzC;AAkBD,eAAO,MAAM,CAAC;aACZ,IAAI,aAAU,gBAAgB;;;;aAI9B,QAAQ,aAAU,gBAAgB;;;;aAIlC,IAAI,aAAU,gBAAgB;;;;aAI9B,MAAM,aAAU,kBAAkB;;;;aAIlC,OAAO,aAAU,gBAAgB;;;;IAIjC,gDAAgD;aAChD,IAAI,aAAU,gBAAgB;;;;IAI9B,kDAAkD;aAClD,QAAQ,aAAU,gBAAgB;;;;aAIlC,KAAK,aAAU,iBAAiB;;;;;;;aAOhC,QAAQ,YAAU,oBAAoB;;;;;;;;aAUtC,MAAM,YAAU,kBAAkB;;;;;;;aAOlC,IAAI,aAAU,gBAAgB;;;;IAI9B,6DAA6D;aAC7D,GAAG,aAAU,gBAAgB;;;;IAI7B,sDAAsD;aACtD,KAAK,aAAU,gBAAgB;;;;aAI/B,MAAM,aAAU,kBAAkB;;;;;;CAG1B,CAAA"}

package/dist/fields.js

@@ -0,0 +1,107 @@
+/**
+ * The field constructors of contract A § "Types de champ (v1)".
+ *
+ * Every constructor returns a plain, serialisable `FieldDefinition`: the schema
+ * is data, not behaviour, because three consumers read it — the validator, the
+ * type generator and the admin — and a closure would only be usable by the
+ * first one.
+ *
+ * Kind-specific defaults are materialised here rather than at each call site,
+ * so `onDelete` reads `'restrict'` in `.cogenta/schema.json` even when the
+ * author never typed it.
+ */
+const BASE_KEYS = ['required', 'default', 'localized', 'unique', 'validate', 'admin'];
+/**
+ * Copies only the base options that were actually provided.
+ *
+ * `exactOptionalPropertyTypes` is on: writing `required: input.required` would
+ * store an explicit `undefined`, which is not the same as an absent key — and
+ * it would show up in the generated JSON.
+ */
+function baseOf(input) {
+    const base = {};
+    for (const key of BASE_KEYS) {
+        const value = input[key];
+        if (value !== undefined)
+            base[key] = value;
+    }
+    return base;
+}
+function field(kind, input, options) {
+    return { kind, ...baseOf(input), options };
+}
+export const MEDIA_ACCEPT_KINDS = ['image', 'video', 'audio', 'file'];
+/** Drops the base keys so they are not duplicated inside `options`. */
+function specificOf(input, keys) {
+    const out = {};
+    for (const key of keys) {
+        const value = input[key];
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+function normaliseChoices(options) {
+    return options.map((choice) => (typeof choice === 'string' ? { value: choice } : choice));
+}
+export const f = {
+    text(options = {}) {
+        return field('text', options, specificOf(options, ['min', 'max', 'multiline']));
+    },
+    richText(options = {}) {
+        return field('richText', options, {});
+    },
+    slug(options = {}) {
+        return field('slug', options, specificOf(options, ['from', 'max']));
+    },
+    number(options = {}) {
+        return field('number', options, specificOf(options, ['min', 'max', 'integer']));
+    },
+    boolean(options = {}) {
+        return field('boolean', options, {});
+    },
+    /** Calendar day, no time zone: `YYYY-MM-DD`. */
+    date(options = {}) {
+        return field('date', options, {});
+    },
+    /** Instant, stored as ISO 8601 with an offset. */
+    datetime(options = {}) {
+        return field('datetime', options, {});
+    },
+    media(options = {}) {
+        return field('media', options, {
+            accept: options.accept ?? MEDIA_ACCEPT_KINDS,
+            many: options.many ?? false,
+        });
+    },
+    relation(options) {
+        // `'restrict'` by default, deliberately (contract A § "Relations"):
+        // deleting an author must not silently erase their articles.
+        return field('relation', options, {
+            to: options.to,
+            many: options.many ?? false,
+            onDelete: options.onDelete ?? 'restrict',
+        });
+    },
+    select(options) {
+        return field('select', options, {
+            options: normaliseChoices(options.options),
+            many: options.many ?? false,
+        });
+    },
+    json(options = {}) {
+        return field('json', options, {});
+    },
+    /** A point on the globe: `{ lat, lng }`, degrees, WGS 84. */
+    geo(options = {}) {
+        return field('geo', options, {});
+    },
+    /** Hex notation, `#rgb`, `#rrggbb` or `#rrggbbaa`. */
+    color(options = {}) {
+        return field('color', options, {});
+    },
+    blocks(options = {}) {
+        return field('blocks', options, { allow: options.allow ?? '*' });
+    },
+};
+//# sourceMappingURL=fields.js.map

package/dist/fields.js.map

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