@elytracms/core 0.0.6

package/dist/cms-core/json-schema.js

@@ -0,0 +1,110 @@
+function fieldSchema(field) {
+    switch (field.type) {
+        case 'text':
+        case 'richText': {
+            const schema = { type: 'string' };
+            if (field.validation?.min !== undefined)
+                schema.minLength = field.validation.min;
+            if (field.validation?.max !== undefined)
+                schema.maxLength = field.validation.max;
+            if (field.validation?.pattern !== undefined)
+                schema.pattern = field.validation.pattern;
+            return schema;
+        }
+        case 'number': {
+            const schema = { type: 'number' };
+            if (field.validation?.min !== undefined)
+                schema.minimum = field.validation.min;
+            if (field.validation?.max !== undefined)
+                schema.maximum = field.validation.max;
+            return schema;
+        }
+        case 'boolean':
+            return { type: 'boolean' };
+        case 'date':
+            // ISO string or epoch number.
+            return { type: ['string', 'number'], format: 'date-time' };
+        case 'select': {
+            const values = field.options.map((o) => o.value);
+            const item = { type: 'string', enum: values };
+            return field.multiple ? { type: 'array', items: item } : item;
+        }
+        case 'relation': {
+            const ref = {
+                type: 'object',
+                properties: {
+                    collection: { type: 'string', const: field.target },
+                    id: { type: 'string' },
+                },
+                required: ['collection', 'id'],
+                additionalProperties: false,
+            };
+            return field.cardinality === 'many' ? { type: 'array', items: ref } : ref;
+        }
+        case 'asset': {
+            const id = { type: 'string' };
+            return field.cardinality === 'many' ? { type: 'array', items: id } : id;
+        }
+        case 'blocks':
+            // A composition value (EC-186): a ComponentNode tree the host renders via
+            // the canvas engine. Opaque to JSON Schema consumers — `many` is an
+            // ordered list, `one` a single tree.
+            return field.cardinality === 'many' ? { type: 'array' } : { type: 'object' };
+        case 'object': {
+            // EC-253: a nested object of the subfield schemas; `many` wraps it in an
+            // array (the repeater). Recurses for nested objects.
+            const properties = {};
+            const required = [];
+            for (const sub of field.fields) {
+                properties[sub.name] = fieldSchema(sub);
+                if (sub.validation?.required)
+                    required.push(sub.name);
+            }
+            const objectSchema = { type: 'object', properties, additionalProperties: false };
+            if (required.length > 0)
+                objectSchema.required = required;
+            return field.cardinality === 'many'
+                ? { type: 'array', items: objectSchema }
+                : objectSchema;
+        }
+        default: {
+            // Exhaustiveness: a new field type must add a case above (EC-253).
+            const _exhaustive = field;
+            void _exhaustive;
+            return {};
+        }
+    }
+}
+/**
+ * Produce a JSON Schema for a collection's document shape (EC-016). Required
+ * fields populate `required`; declared validation metadata maps to standard
+ * JSON Schema keywords. Localized fields can be wrapped in a per-locale object.
+ */
+export function collectionJsonSchema(collection, options = {}) {
+    const properties = {};
+    const required = [];
+    for (const field of collection.fields) {
+        let schema = fieldSchema(field);
+        if (field.localized && options.locales && options.locales.length > 0) {
+            const localeProps = {};
+            for (const locale of options.locales)
+                localeProps[locale] = schema;
+            schema = { type: 'object', properties: localeProps };
+        }
+        properties[field.name] = schema;
+        if (field.validation?.required)
+            required.push(field.name);
+    }
+    const out = {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        $id: options.$id ?? `urn:elytra:collection:${collection.id}`,
+        title: collection.form?.labelSingular ?? collection.form?.label ?? collection.id,
+        type: 'object',
+        properties,
+        additionalProperties: false,
+    };
+    if (required.length > 0)
+        out.required = required;
+    return out;
+}
+//# sourceMappingURL=json-schema.js.map

package/dist/cms-core/json-schema.js.map

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

package/dist/cms-core/localization.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import type { CollectionDef } from './collections';
+import type { CmsDocument, FieldValues, Locale } from './documents';
+import type { CmsValidationIssue } from './issues';
+/**
+ * Locale configuration for a project (EC-018): the set of supported locales and
+ * the default used for fallback. Provider-neutral.
+ */
+export declare const localeConfigSchema: z.ZodObject<{
+    default: z.ZodString;
+    locales: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type LocaleConfig = z.infer<typeof localeConfigSchema>;
+/** Build a locale config, ensuring the default is included in the locale set. */
+export declare function createLocaleConfig(init: {
+    default: Locale;
+    locales: readonly Locale[];
+}): LocaleConfig;
+/** True if a locale is part of the configured set. */
+export declare function isKnownLocale(config: LocaleConfig, locale: Locale): boolean;
+/** Whether a given field stores per-locale values. */
+export declare function isFieldLocalized(collection: CollectionDef, fieldName: string): boolean;
+/** The document's authoring/default locale, falling back to the project default. */
+export declare function documentDefaultLocale(doc: CmsDocument, config: LocaleConfig): Locale;
+export interface ResolvedField {
+    value: unknown;
+    /** The locale the value was actually read from (may differ from requested). */
+    sourceLocale: Locale;
+    /** True when the requested locale had no value and fallback was used. */
+    fellBack: boolean;
+}
+/**
+ * Resolve a single field's value for a requested locale with default-locale
+ * fallback (EC-018):
+ * - Non-localized fields always read from `doc.values`.
+ * - Localized fields read `doc.localized[locale]`; if absent, fall back to the
+ *   document's default locale, then to `doc.values` as a last resort.
+ */
+export declare function resolveField(collection: CollectionDef, doc: CmsDocument, fieldName: string, locale: Locale, config: LocaleConfig): ResolvedField;
+/**
+ * Resolve the full field-values view of a document for a locale, applying
+ * default-locale fallback per field (EC-018). The returned bag is flat:
+ * `{ [field]: value }`, suitable for rendering or relation resolution.
+ */
+export declare function resolveDocumentForLocale(collection: CollectionDef, doc: CmsDocument, locale: Locale, config: LocaleConfig): FieldValues;
+/**
+ * Validate that requesting `locale` is well-formed against the project config
+ * (EC-018): emits `unknown-locale` for unsupported locales. Resolution itself
+ * never throws; this surfaces an explicit structured issue.
+ */
+export declare function validateLocale(config: LocaleConfig, locale: Locale, path?: ReadonlyArray<string | number>): CmsValidationIssue[];

package/dist/cms-core/localization.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { fieldOf } from './collections';
+import { cmsIssue } from './issues';
+/**
+ * Locale configuration for a project (EC-018): the set of supported locales and
+ * the default used for fallback. Provider-neutral.
+ */
+export const localeConfigSchema = z.object({
+    default: z.string().min(1),
+    locales: z.array(z.string().min(1)).min(1),
+});
+/** Build a locale config, ensuring the default is included in the locale set. */
+export function createLocaleConfig(init) {
+    const locales = init.locales.includes(init.default)
+        ? [...init.locales]
+        : [init.default, ...init.locales];
+    return { default: init.default, locales };
+}
+/** True if a locale is part of the configured set. */
+export function isKnownLocale(config, locale) {
+    return config.locales.includes(locale);
+}
+/** Whether a given field stores per-locale values. */
+export function isFieldLocalized(collection, fieldName) {
+    return fieldOf(collection, fieldName)?.localized === true;
+}
+/** The document's authoring/default locale, falling back to the project default. */
+export function documentDefaultLocale(doc, config) {
+    return doc.defaultLocale ?? config.default;
+}
+/**
+ * Resolve a single field's value for a requested locale with default-locale
+ * fallback (EC-018):
+ * - Non-localized fields always read from `doc.values`.
+ * - Localized fields read `doc.localized[locale]`; if absent, fall back to the
+ *   document's default locale, then to `doc.values` as a last resort.
+ */
+export function resolveField(collection, doc, fieldName, locale, config) {
+    if (!isFieldLocalized(collection, fieldName)) {
+        return { value: doc.values[fieldName], sourceLocale: locale, fellBack: false };
+    }
+    const requested = doc.localized?.[locale];
+    if (requested && fieldName in requested) {
+        return { value: requested[fieldName], sourceLocale: locale, fellBack: false };
+    }
+    const fallbackLocale = documentDefaultLocale(doc, config);
+    if (fallbackLocale !== locale) {
+        const fallback = doc.localized?.[fallbackLocale];
+        if (fallback && fieldName in fallback) {
+            return { value: fallback[fieldName], sourceLocale: fallbackLocale, fellBack: true };
+        }
+    }
+    // Last resort: a value stored on the shared bag (e.g. authored before the
+    // field was localized). Reported as a fallback to the default locale.
+    if (fieldName in doc.values) {
+        return { value: doc.values[fieldName], sourceLocale: fallbackLocale, fellBack: true };
+    }
+    return { value: undefined, sourceLocale: fallbackLocale, fellBack: fallbackLocale !== locale };
+}
+/**
+ * Resolve the full field-values view of a document for a locale, applying
+ * default-locale fallback per field (EC-018). The returned bag is flat:
+ * `{ [field]: value }`, suitable for rendering or relation resolution.
+ */
+export function resolveDocumentForLocale(collection, doc, locale, config) {
+    const out = {};
+    for (const field of collection.fields) {
+        out[field.name] = resolveField(collection, doc, field.name, locale, config).value;
+    }
+    return out;
+}
+/**
+ * Validate that requesting `locale` is well-formed against the project config
+ * (EC-018): emits `unknown-locale` for unsupported locales. Resolution itself
+ * never throws; this surfaces an explicit structured issue.
+ */
+export function validateLocale(config, locale, path = ['locale']) {
+    if (isKnownLocale(config, locale))
+        return [];
+    return [
+        cmsIssue({
+            code: 'unknown-locale',
+            message: `Locale "${locale}" is not in the configured locale set.`,
+            path,
+            meta: { locale, configured: config.locales },
+        }),
+    ];
+}
+//# sourceMappingURL=localization.js.map

package/dist/cms-core/localization.js.map

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

package/dist/cms-core/routes.d.ts

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import type { DocumentRef } from './documents';
+import type { CmsValidationIssue } from './issues';
+/**
+ * A route record (EC-019, reshaped by EC-187). A path pattern may contain
+ * dynamic segments written `:name` (e.g. `/blog/:slug`). A route maps a concrete
+ * URL to a **render target = a collection + document** via its `document` ref
+ * — `/` → `{ collection: 'page', id: 'home' }`, `/blog/:slug` →
+ * `{ collection: 'post', id: ':slug' }`. The catch-all dispatches on the
+ * resolved document's collection. There is no `templateId`/`pageId` anymore:
+ * page content is a `page`-collection document, not a graph page.
+ */
+export declare const routeRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    pattern: z.ZodString;
+    locale: z.ZodOptional<z.ZodString>;
+    document: z.ZodOptional<z.ZodObject<{
+        collection: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RouteRecord = z.infer<typeof routeRecordSchema>;
+/** A redirect record (EC-019/020). */
+export declare const redirectRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodString;
+    permanent: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RedirectRecord = z.infer<typeof redirectRecordSchema>;
+/** Result of `resolveUrl` (EC-019). */
+export type ResolveStatus = 'ok' | 'redirect' | 'notFound';
+export interface ResolveResult {
+    status: ResolveStatus;
+    /** The matched route, when status is `ok`. */
+    route?: RouteRecord;
+    /** The document the URL resolves to, when known. */
+    documentRef?: DocumentRef;
+    /** The terminal redirect target, when status is `redirect`. */
+    redirectTarget?: string;
+    /** Extracted dynamic params, e.g. `{ slug: 'hello' }`. */
+    dynamicParams: Record<string, string>;
+    /** True when resolution fell back to a default-locale route (EC-018). */
+    fallback: boolean;
+    /** Whether the matched redirect is permanent (301) vs temporary (302). */
+    permanent?: boolean;
+}
+/** Split a path into non-empty segments, ignoring a trailing slash. */
+export declare function splitPath(path: string): string[];
+/**
+ * The router (EC-019/020). Compiles routes + redirects once, then answers
+ * `resolveUrl`. Construction surfaces structural issues (route conflicts,
+ * redirect loops) as structured issues — it never throws or loops.
+ */
+export interface Router {
+    readonly issues: readonly CmsValidationIssue[];
+    resolveUrl(url: string, locale?: string): ResolveResult;
+    /** Resolve a redirect chain from `from` to its terminus (EC-020). */
+    followRedirects(from: string): RedirectResolution;
+}
+export interface RouterOptions {
+    /** Default locale used for locale fallback during resolution (EC-018). */
+    defaultLocale?: string;
+}
+export interface RedirectResolution {
+    /** Final URL after following all hops. */
+    target: string;
+    /** Ordered list of intermediate URLs visited (including `from` and `target`). */
+    chain: string[];
+    /** True if a loop was detected; `target` is then the loop entry point. */
+    loop: boolean;
+    /** Whether every hop was permanent. */
+    permanent: boolean;
+}
+/** Build a router from route + redirect records. */
+export declare function createRouter(routes: readonly RouteRecord[], redirects?: readonly RedirectRecord[], options?: RouterOptions): Router;

package/dist/cms-core/routes.js

@@ -0,0 +1,220 @@
+import { z } from 'zod';
+import { localeSchema } from './documents';
+import { cmsIssue } from './issues';
+/**
+ * A route record (EC-019, reshaped by EC-187). A path pattern may contain
+ * dynamic segments written `:name` (e.g. `/blog/:slug`). A route maps a concrete
+ * URL to a **render target = a collection + document** via its `document` ref
+ * — `/` → `{ collection: 'page', id: 'home' }`, `/blog/:slug` →
+ * `{ collection: 'post', id: ':slug' }`. The catch-all dispatches on the
+ * resolved document's collection. There is no `templateId`/`pageId` anymore:
+ * page content is a `page`-collection document, not a graph page.
+ */
+export const routeRecordSchema = z.object({
+    id: z.string().min(1),
+    /** Path pattern, leading slash, with optional `:param` segments. */
+    pattern: z.string().min(1),
+    /** Locale this route serves (EC-018). Omitted = locale-agnostic. */
+    locale: localeSchema.optional(),
+    /**
+     * The document this route resolves to: a `page`-collection document (whose
+     * `body` composition renders into a layout), or a content-collection document
+     * (rendered by a dev route component). The `id` may be a `:param` placeholder
+     * materialized from the matched URL (EC-166).
+     */
+    document: z
+        .object({ collection: z.string().min(1), id: z.string().min(1) })
+        .optional(),
+});
+/** A redirect record (EC-019/020). */
+export const redirectRecordSchema = z.object({
+    id: z.string().min(1),
+    from: z.string().min(1),
+    to: z.string().min(1),
+    /** 301 permanent (default) or 302 temporary. */
+    permanent: z.boolean().default(true),
+});
+/** Split a path into non-empty segments, ignoring a trailing slash. */
+export function splitPath(path) {
+    const [pathname] = path.split(/[?#]/, 1);
+    return (pathname ?? '')
+        .split('/')
+        .filter((s) => s.length > 0);
+}
+function compilePattern(pattern) {
+    return splitPath(pattern).map((seg) => seg.startsWith(':')
+        ? { kind: 'param', name: seg.slice(1) }
+        : { kind: 'static', value: seg });
+}
+/**
+ * Match a concrete URL path against a compiled pattern. Returns extracted params
+ * or `undefined` if it doesn't match. Segment counts must be equal.
+ */
+function matchSegments(segments, urlSegments) {
+    if (segments.length !== urlSegments.length)
+        return undefined;
+    const params = {};
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        const value = urlSegments[i];
+        if (seg === undefined || value === undefined)
+            return undefined;
+        if (seg.kind === 'static') {
+            if (seg.value !== value)
+                return undefined;
+        }
+        else {
+            params[seg.name] = decodeURIComponent(value);
+        }
+    }
+    return params;
+}
+/**
+ * A "specificity key": more static segments and fewer params win when two routes
+ * could match. Used to choose deterministically and to detect *true* conflicts
+ * (two patterns with identical specificity matching the same concrete URL).
+ */
+function specificity(segments) {
+    return segments.map((s) => (s.kind === 'static' ? 'S' : 'P')).join('');
+}
+function normalizePath(path) {
+    const [pathname] = path.split(/[?#]/, 1);
+    const segs = splitPath(pathname ?? '');
+    return '/' + segs.join('/');
+}
+/** Build a router from route + redirect records. */
+export function createRouter(routes, redirects = [], options = {}) {
+    const issues = [];
+    const compiled = routes.map((route) => ({
+        route,
+        segments: compilePattern(route.pattern),
+    }));
+    // --- Route conflict detection (EC-020) ---
+    // Two routes conflict when, for the same locale, they would match the exact
+    // same set of concrete URLs: identical specificity signature AND the static
+    // segments line up at the same positions.
+    const conflictKey = (c) => {
+        const locale = c.route.locale ?? '*';
+        const sig = c.segments
+            .map((s) => (s.kind === 'static' ? `s:${s.value}` : 'p'))
+            .join('/');
+        return `${locale}|${sig}`;
+    };
+    const byKey = new Map();
+    for (const c of compiled) {
+        const key = conflictKey(c);
+        const existing = byKey.get(key);
+        if (existing) {
+            issues.push(cmsIssue({
+                code: 'route-conflict',
+                message: `Routes "${existing.route.id}" and "${c.route.id}" both match the same URLs (pattern "${c.route.pattern}").`,
+                path: ['routes', c.route.id],
+                meta: { conflictsWith: existing.route.id, pattern: c.route.pattern },
+            }));
+        }
+        else {
+            byKey.set(key, c);
+        }
+    }
+    // --- Redirect map + loop detection (EC-020) ---
+    const redirectMap = new Map();
+    for (const r of redirects) {
+        redirectMap.set(normalizePath(r.from), r);
+    }
+    const followRedirects = (from) => {
+        const chain = [];
+        const seen = new Set();
+        let current = normalizePath(from);
+        let permanent = true;
+        chain.push(current);
+        // Bounded by the number of redirects; the `seen` guard makes loops impossible.
+        while (true) {
+            const hop = redirectMap.get(current);
+            if (!hop) {
+                return { target: current, chain, loop: false, permanent };
+            }
+            if (!hop.permanent)
+                permanent = false;
+            const next = normalizePath(hop.to);
+            if (seen.has(next) || next === current) {
+                chain.push(next);
+                return { target: next, chain, loop: true, permanent };
+            }
+            seen.add(current);
+            current = next;
+            chain.push(current);
+        }
+    };
+    // Eagerly report redirect loops as structured issues (EC-020).
+    const loopReported = new Set();
+    for (const r of redirects) {
+        const res = followRedirects(r.from);
+        if (res.loop && !loopReported.has(res.target)) {
+            loopReported.add(res.target);
+            issues.push(cmsIssue({
+                code: 'redirect-loop',
+                message: `Redirect chain starting at "${r.from}" loops (…${res.chain.slice(-3).join(' -> ')}).`,
+                path: ['redirects', r.id],
+                meta: { chain: res.chain },
+            }));
+        }
+    }
+    const orderedMatches = (urlSegments, locale) => {
+        const matches = [];
+        for (const c of compiled) {
+            if (locale !== undefined && c.route.locale !== undefined && c.route.locale !== locale) {
+                continue;
+            }
+            const params = matchSegments(c.segments, urlSegments);
+            if (params)
+                matches.push({ compiled: c, params });
+        }
+        // Most specific first (fewest params, more static).
+        matches.sort((a, b) => specificity(a.compiled.segments).localeCompare(specificity(b.compiled.segments)) * -1);
+        return matches;
+    };
+    const resolveUrl = (url, locale) => {
+        const path = normalizePath(url);
+        // 1. Redirects take precedence (resolve to terminus).
+        if (redirectMap.has(path)) {
+            const res = followRedirects(path);
+            return {
+                status: 'redirect',
+                redirectTarget: res.target,
+                permanent: res.permanent,
+                dynamicParams: {},
+                fallback: false,
+            };
+        }
+        const urlSegments = splitPath(path);
+        // 2. Match routes for the requested locale.
+        let fallback = false;
+        let matches = orderedMatches(urlSegments, locale);
+        // 3. Locale fallback to the default locale (EC-018).
+        if (matches.length === 0 && locale && options.defaultLocale && locale !== options.defaultLocale) {
+            const fallbackMatches = orderedMatches(urlSegments, options.defaultLocale);
+            if (fallbackMatches.length > 0) {
+                matches = fallbackMatches;
+                fallback = true;
+            }
+        }
+        // 3b. As a last resort try locale-agnostic routes (no locale on requested pass).
+        if (matches.length === 0 && locale === undefined) {
+            matches = orderedMatches(urlSegments, undefined);
+        }
+        const best = matches[0];
+        if (!best) {
+            return { status: 'notFound', dynamicParams: {}, fallback };
+        }
+        const route = best.compiled.route;
+        return {
+            status: 'ok',
+            route,
+            ...(route.document ? { documentRef: route.document } : {}),
+            dynamicParams: best.params,
+            fallback,
+        };
+    };
+    return { issues, resolveUrl, followRedirects };
+}
+//# sourceMappingURL=routes.js.map

package/dist/cms-core/routes.js.map

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

package/dist/cms-core/self-type.d.ts

@@ -0,0 +1,41 @@
+import type { CollectionDef } from './collections';
+import type { CmsDocument } from './documents';
+import type { FieldDef } from './fields';
+/**
+ * Self-typing on write (EC-277, vision AD-14/AD-15): the *write-time lens*.
+ *
+ * The schema is a lens, not a mirror — it shapes the editing UI and, on write,
+ * wraps bare field values into their self-describing envelope so the stored value
+ * carries its own `type` discriminator. This is the only place the schema (and, for
+ * a composition's static props, the component manifest) touches the value on the way
+ * IN; from then on derivation (the reference walk) reads the envelope and needs
+ * neither. It is also the exact transform the lazy migration applies to legacy bare
+ * content (the migration IS this lens, applied once).
+ *
+ * "Schema leads, component adopts": the field-def (and the manifest's prop field-defs)
+ * lead the write-time wrapping; the component adopts the self-typed value on read.
+ * Using the manifest HERE (write) is what keeps extraction schema-free THERE (read).
+ *
+ * Idempotent: an already-self-typed value passes through unchanged, so running it
+ * over partially-migrated content is safe.
+ */
+/**
+ * Resolves a component id to its prop field-defs (the manifest's `props`, name → def).
+ * Manifests are code (AD-11); cms-core stays free of `@elytracms/core/component-registry`
+ * by accepting this structural lookup, threaded from the layer that owns the registry
+ * (operations / the studio form engine). Omit → composition static props are not
+ * self-typed (component usage still self-describes via `componentId`).
+ */
+export type PropFieldLookup = (componentId: string) => Record<string, FieldDef> | undefined;
+export interface SelfTypeOptions {
+    lookupManifest?: PropFieldLookup;
+}
+/** Self-type one field value through the lens of its field-def. Idempotent. */
+export declare function selfTypeFieldValue(field: FieldDef, value: unknown, options?: SelfTypeOptions): unknown;
+/**
+ * Self-type a whole document (its `values` and every `localized` locale) through the
+ * collection schema. Returns a new document; the input is not mutated. A document
+ * whose collection is absent from the schema is returned unchanged (drift-tolerant —
+ * AD-14: the store never blocks on schema divergence).
+ */
+export declare function selfTypeDocument(document: CmsDocument, collection: CollectionDef, options?: SelfTypeOptions): CmsDocument;