@elytracms/core 0.0.6

package/dist/content/codegen.js

@@ -0,0 +1,305 @@
+/**
+ * Per-collection delivery-type codegen (EC-142, vision AD-4). Emits TypeScript
+ * source describing the *delivery shape* of each collection — the shape
+ * `resolveDocument` produces — so `article.author.name` just typechecks.
+ *
+ * Deterministic by construction: collections are emitted sorted by id, fields
+ * in declared order, with no timestamps or environment data — the same schema
+ * input yields byte-identical output. Consumed by EC-143/EC-145/EC-148.
+ *
+ * Typing stance: the generated types describe the *valid* delivery shape.
+ * Degraded states are always accompanied by structured issues at runtime —
+ * a missing relation target yields a `{ id, collection }` stub plus an
+ * `unknown-relation-target` issue; a missing asset yields `null` plus an
+ * `unknown-asset` issue (which is why asset fields carry `| null`).
+ */
+/** The generated TypeScript type name for a collection's delivery shape. */
+export function deliveryTypeName(collectionId) {
+    const name = collectionId
+        .split(/[^A-Za-z0-9]+/u)
+        .filter((part) => part.length > 0)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+    const safe = name.length > 0 ? name : 'Collection';
+    return /^[0-9]/u.test(safe) ? `_${safe}` : safe;
+}
+/** The generated type name for a collection's depth-1 populated reference. */
+export function deliveryRefTypeName(collectionId) {
+    return `${deliveryTypeName(collectionId)}Ref`;
+}
+/** The generated `where` type name for a collection's list accessor (EC-143). */
+export function whereTypeName(collectionId) {
+    return `${deliveryTypeName(collectionId)}Where`;
+}
+/** The generated sort-field union type name for a collection (EC-143). */
+export function sortFieldTypeName(collectionId) {
+    return `${deliveryTypeName(collectionId)}SortField`;
+}
+/** The generated list-query type name for a collection (EC-143). */
+export function listQueryTypeName(collectionId) {
+    return `${deliveryTypeName(collectionId)}ListQuery`;
+}
+const IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/u;
+function propertyKey(name) {
+    return IDENTIFIER.test(name) ? name : singleQuoted(name);
+}
+function singleQuoted(value) {
+    return `'${value.replace(/\\/gu, '\\\\').replace(/'/gu, "\\'")}'`;
+}
+function selectUnion(field) {
+    const union = field.options.map((option) => singleQuoted(option.value)).join(' | ');
+    return field.multiple ? `(${union})[]` : union;
+}
+function relationType(field, nested, knownCollections) {
+    const known = knownCollections.has(field.target);
+    const stub = known ? `DocumentStub<${singleQuoted(field.target)}>` : 'DocumentStub';
+    const populated = !nested && field.populate !== false && known;
+    const one = populated ? deliveryRefTypeName(field.target) : stub;
+    return field.cardinality === 'many' ? `${one}[]` : one;
+}
+/**
+ * The delivery-shape TS type expression for one field. `nested` marks fields
+ * inside a depth-1 populated reference, where relations stay stubs (population
+ * never recurses) while assets still resolve to objects.
+ */
+function deliveryFieldType(field, nested, knownCollections) {
+    switch (field.type) {
+        case 'text':
+        case 'richText':
+            return 'string';
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'date':
+            return 'string | number';
+        case 'select':
+            return selectUnion(field);
+        case 'relation':
+            return relationType(field, nested, knownCollections);
+        case 'asset':
+            return field.cardinality === 'many' ? 'ResolvedAsset[]' : 'ResolvedAsset | null';
+        case 'blocks':
+            // EC-188: a composition (block) field's value is a ComponentNode tree,
+            // delivered verbatim. Typed as the self-contained `CompositionBlock`.
+            return field.cardinality === 'one' ? 'CompositionBlock' : 'CompositionBlock[]';
+        case 'object': {
+            // EC-253: a nested object of the subfields' delivery types, `Array<...>` for
+            // a repeater. Subfields follow the same `nested` rule — a relation inside a
+            // top-level object populates to depth-1; inside a populated ref it stays a
+            // stub. Recurses for nested objects.
+            const shape = field.fields
+                .map((sub) => {
+                const optional = sub.validation?.required === true ? '' : '?';
+                return `${propertyKey(sub.name)}${optional}: ${deliveryFieldType(sub, nested, knownCollections)}`;
+            })
+                .join('; ');
+            const objectType = field.fields.length > 0 ? `{ ${shape} }` : 'Record<string, unknown>';
+            return field.cardinality === 'many' ? `Array<${objectType}>` : objectType;
+        }
+        default: {
+            // Exhaustiveness: a new field type must add a case above (EC-253).
+            const _exhaustive = field;
+            void _exhaustive;
+            return 'unknown';
+        }
+    }
+}
+function interfaceLines(name, doc, collection, nested, knownCollections) {
+    const lines = [];
+    lines.push(`/** ${doc} */`);
+    lines.push(`export interface ${name} {`);
+    lines.push('  id: string');
+    lines.push(`  collection: ${singleQuoted(collection.id)}`);
+    for (const field of collection.fields) {
+        const optional = field.validation?.required === true ? '' : '?';
+        const type = deliveryFieldType(field, nested, knownCollections);
+        lines.push(`  ${propertyKey(field.name)}${optional}: ${type}`);
+    }
+    lines.push('}');
+    return lines;
+}
+const HEADER = [
+    '// Generated by @elytracms/content delivery-type codegen (EC-142).',
+    '// Do not edit by hand — regenerate from the collection schemas.',
+    '// Deterministic: identical schema input yields byte-identical output.',
+];
+const PRELUDE = [
+    '/**',
+    ' * Reference stub for an unpopulated relation: `populate: false` opt-outs,',
+    ' * unknown/missing targets, and relations nested inside a populated document',
+    ' * (population never recurses past depth-1). Never a bare id string.',
+    ' */',
+    'export interface DocumentStub<TCollection extends string = string> {',
+    '  id: string',
+    '  collection: TCollection',
+    '}',
+    '',
+    '/** Delivery shape of a resolved asset; absent metadata is `null`. */',
+    'export interface ResolvedAsset {',
+    '  id: string',
+    '  url: string',
+    '  width: number | null',
+    '  height: number | null',
+    '  alt: string | null',
+    '  mimeType: string',
+    '  focalPoint: { x: number; y: number } | null',
+    '}',
+];
+/**
+ * EC-188: emitted only when a schema declares a `blocks` (composition) field. A
+ * self-contained, recursive ComponentNode shape — render it with
+ * `renderComposition`, don't read into it. Conditional so schemas without
+ * composition fields keep byte-identical output.
+ */
+const COMPOSITION_PRELUDE = [
+    '/**',
+    ' * One node of a composition (`blocks`) field tree (EC-188), delivered verbatim.',
+    ' * Opaque and recursive — render it with `renderComposition` rather than reading',
+    ' * into it; `props`/`slots` are intentionally loose.',
+    ' */',
+    'export interface CompositionBlock {',
+    '  id: string',
+    '  componentId: string',
+    '  props?: Record<string, unknown>',
+    '  slots?: Record<string, CompositionBlock[]>',
+    '  condition?: unknown',
+    '}',
+];
+/**
+ * Generate the per-collection delivery types as a TypeScript module source
+ * string. For each collection two interfaces are emitted:
+ *
+ * - `Name` — the top-level delivery shape (relations populated to depth-1
+ *   unless declared `populate: false`),
+ * - `NameRef` — the depth-1 populated reference shape used by relation fields
+ *   on *other* collections (its own relations are stubs).
+ *
+ * Output is deterministic: collections sorted by id, fields in declared
+ * order, fixed banner, no timestamps.
+ */
+export function generateDeliveryTypes(collections) {
+    const sorted = [...collections].sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    const knownCollections = new Set(sorted.map((c) => c.id));
+    const sections = [HEADER.join('\n'), PRELUDE.join('\n')];
+    // Composition types ride along only when a `blocks` field exists (EC-188), so
+    // schemas without one keep byte-identical output.
+    const hasComposition = sorted.some((c) => c.fields.some((f) => f.type === 'blocks'));
+    if (hasComposition)
+        sections.push(COMPOSITION_PRELUDE.join('\n'));
+    for (const collection of sorted) {
+        sections.push(interfaceLines(deliveryTypeName(collection.id), `Delivery shape for documents in the "${collection.id}" collection.`, collection, false, knownCollections).join('\n'));
+        sections.push(interfaceLines(deliveryRefTypeName(collection.id), `Depth-1 populated reference to the "${collection.id}" collection.`, collection, true, knownCollections).join('\n'));
+    }
+    return `${sections.join('\n\n')}\n`;
+}
+// ---------------------------------------------------------------------------
+// Accessor-type codegen (EC-143)
+// ---------------------------------------------------------------------------
+/**
+ * The TS type a filter compares against for one field — the scalar side of
+ * the value (relations and assets filter by target/asset id).
+ */
+function filterValueType(field) {
+    switch (field.type) {
+        case 'text':
+        case 'richText':
+            return 'string';
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'date':
+            return 'string | number';
+        case 'select':
+            return field.options.map((option) => singleQuoted(option.value)).join(' | ');
+        case 'relation':
+        case 'asset':
+            return 'string';
+        case 'blocks':
+        case 'object':
+            // Composition (EC-188) and object / repeater (EC-253) are not filter
+            // primitives — they can never be declared `filterable`, so no `where` clause
+            // is ever generated for them.
+            return 'never';
+        default: {
+            // Exhaustiveness: a new field type must add a case above (EC-253).
+            const _exhaustive = field;
+            void _exhaustive;
+            return 'never';
+        }
+    }
+}
+const ACCESSOR_HEADER = [
+    '// Generated by @elytracms/content accessor-type codegen (EC-143).',
+    '// Do not edit by hand — regenerate from the collection schemas.',
+    '// Deterministic: identical schema input yields byte-identical output.',
+];
+const ACCESSOR_PRELUDE = [
+    '/**',
+    ' * The closed filter vocabulary (vision AD-3): equality, `in`, comparisons,',
+    ' * AND-only — multiple fields and multiple operators all AND together.',
+    ' * A bare scalar is shorthand for `{ eq: value }`.',
+    ' */',
+    'export interface WhereCondition<T> {',
+    '  eq?: T',
+    '  gt?: T',
+    '  gte?: T',
+    '  in?: readonly T[]',
+    '  lt?: T',
+    '  lte?: T',
+    '}',
+    '',
+    '/** The list-query envelope every generated per-collection query reuses. */',
+    'export interface GeneratedListQuery<TWhere, TSortField extends string> {',
+    '  where?: TWhere',
+    "  sort?: { field: TSortField; direction?: 'asc' | 'desc' }",
+    '  limit?: number',
+    '  cursor?: string',
+    '}',
+];
+/**
+ * Generate the per-collection accessor types as a TypeScript module source
+ * string (EC-143). For each collection three aliases are emitted:
+ *
+ * - `NameWhere` — `where` keys narrowed to the fields declared `filterable`
+ *   in the schema; filtering on anything else is a compile error,
+ * - `NameSortField` — the sortable field union (the same filterable set),
+ * - `NameListQuery` — the full `listDocuments` query for the collection.
+ *
+ * Collections with no filterable fields get `Record<string, never>` / `never`,
+ * so no filter or sort can be expressed at all. Output is deterministic:
+ * collections sorted by id, fields in declared order, fixed banner, no
+ * timestamps — same schema input, byte-identical output.
+ */
+export function generateAccessorTypes(collections) {
+    const sorted = [...collections].sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    const sections = [ACCESSOR_HEADER.join('\n'), ACCESSOR_PRELUDE.join('\n')];
+    for (const collection of sorted) {
+        const filterable = collection.fields.filter((field) => field.filterable === true);
+        const lines = [];
+        lines.push(`/** Filter input for "${collection.id}" — only fields declared \`filterable\`. */`);
+        if (filterable.length === 0) {
+            lines.push(`export type ${whereTypeName(collection.id)} = Record<string, never>`);
+        }
+        else {
+            lines.push(`export type ${whereTypeName(collection.id)} = {`);
+            for (const field of filterable) {
+                const value = filterValueType(field);
+                lines.push(`  ${propertyKey(field.name)}?: ${value} | WhereCondition<${value}>`);
+            }
+            lines.push('}');
+        }
+        lines.push('');
+        lines.push(`/** Sortable fields of "${collection.id}" (the filterable set). */`);
+        lines.push(`export type ${sortFieldTypeName(collection.id)} = ${filterable.length === 0
+            ? 'never'
+            : filterable.map((field) => singleQuoted(field.name)).join(' | ')}`);
+        lines.push('');
+        lines.push(`/** \`listDocuments\` query for "${collection.id}". */`);
+        lines.push(`export type ${listQueryTypeName(collection.id)} = GeneratedListQuery<${whereTypeName(collection.id)}, ${sortFieldTypeName(collection.id)}>`);
+        sections.push(lines.join('\n'));
+    }
+    return `${sections.join('\n\n')}\n`;
+}
+//# sourceMappingURL=codegen.js.map

package/dist/content/codegen.js.map

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

package/dist/content/context.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import type { Locale, LocaleConfig } from '@elytracms/core/cms-core';
+/**
+ * Which side of the draft/published split a delivery request reads from
+ * (EC-021, vision AD-4). `published` never exposes draft content; `draft` is
+ * the editor/preview view.
+ */
+export declare const perspectiveSchema: z.ZodEnum<{
+    draft: "draft";
+    published: "published";
+}>;
+export type Perspective = z.infer<typeof perspectiveSchema>;
+/**
+ * Ambient request context (vision AD-4): locale and perspective are set once
+ * per request and threaded through every resolution function — never per-call
+ * ceremony. The locale config travels along so EC-018 fallback needs no extra
+ * arguments either.
+ */
+export interface ContentContext {
+    /** The locale requested for this delivery (EC-018 fallback applies). */
+    readonly locale: Locale;
+    /** Draft or published perspective (EC-021). */
+    readonly perspective: Perspective;
+    /** The project's locale configuration (default + supported set). */
+    readonly locales: LocaleConfig;
+}
+export interface ContentContextInit {
+    locale: Locale;
+    perspective: Perspective;
+    locales: LocaleConfig;
+}
+/**
+ * Create the ambient `{ locale, perspective }` context for a delivery request.
+ * Construction never throws — an unknown locale is surfaced as a structured
+ * `unknown-locale` issue by `resolveDocument`, while resolution still proceeds
+ * with default-locale fallback.
+ */
+export declare function createContentContext(init: ContentContextInit): ContentContext;

package/dist/content/context.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+/**
+ * Which side of the draft/published split a delivery request reads from
+ * (EC-021, vision AD-4). `published` never exposes draft content; `draft` is
+ * the editor/preview view.
+ */
+export const perspectiveSchema = z.enum(['draft', 'published']);
+/**
+ * Create the ambient `{ locale, perspective }` context for a delivery request.
+ * Construction never throws — an unknown locale is surfaced as a structured
+ * `unknown-locale` issue by `resolveDocument`, while resolution still proceeds
+ * with default-locale fallback.
+ */
+export function createContentContext(init) {
+    return {
+        locale: init.locale,
+        perspective: init.perspective,
+        locales: init.locales,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/content/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/content/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAA;AAwB/D;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAwB;IAC3D,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAA;AACH,CAAC"}

package/dist/content/cursor.d.ts

@@ -0,0 +1,33 @@
+import type { FilterScalar, SortDirection } from './query';
+/**
+ * Deterministic cursor pagination for `listDocuments` (EC-143).
+ *
+ * Format: `ec1.<base64url(JSON payload)>` where the payload is
+ * `{"v":1,"f":<sort field|null>,"d":"asc"|"desc","s":<sort value|null>,"i":<doc id>}`
+ * — the sort position (`f`/`d`/`s`) plus the id (`i`) of the last document
+ * returned, with keys always written in that order. The next page is every
+ * entry strictly after that position in the canonical list order
+ * (`compareListEntries`). Encoding the sort spec into the cursor lets decode
+ * reject a cursor reused with a different sort as `invalid-cursor` instead of
+ * silently misordering.
+ *
+ * Encoding is byte-stable: same position in, same cursor string out.
+ */
+export declare const LIST_CURSOR_PREFIX = "ec1.";
+export interface ListCursor {
+    /** Sort field the cursor was minted under (`null` = id order). */
+    sortField: string | null;
+    direction: SortDirection;
+    /** Sort value of the last returned document (`null` when missing). */
+    sortValue: FilterScalar | null;
+    /** Id of the last returned document (the unconditional tiebreak). */
+    id: string;
+}
+/** Encode a list position into an opaque, URL-safe cursor string. */
+export declare function encodeListCursor(cursor: ListCursor): string;
+/**
+ * Decode a cursor string. Returns `null` for anything malformed — wrong
+ * prefix, bad base64, bad JSON, wrong shape. Never throws; the caller maps
+ * `null` to a structured `invalid-cursor` error.
+ */
+export declare function decodeListCursor(text: string): ListCursor | null;

package/dist/content/cursor.js

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+/**
+ * Deterministic cursor pagination for `listDocuments` (EC-143).
+ *
+ * Format: `ec1.<base64url(JSON payload)>` where the payload is
+ * `{"v":1,"f":<sort field|null>,"d":"asc"|"desc","s":<sort value|null>,"i":<doc id>}`
+ * — the sort position (`f`/`d`/`s`) plus the id (`i`) of the last document
+ * returned, with keys always written in that order. The next page is every
+ * entry strictly after that position in the canonical list order
+ * (`compareListEntries`). Encoding the sort spec into the cursor lets decode
+ * reject a cursor reused with a different sort as `invalid-cursor` instead of
+ * silently misordering.
+ *
+ * Encoding is byte-stable: same position in, same cursor string out.
+ */
+export const LIST_CURSOR_PREFIX = 'ec1.';
+const cursorPayloadSchema = z.object({
+    v: z.literal(1),
+    f: z.string().nullable(),
+    d: z.enum(['asc', 'desc']),
+    s: z.union([z.string(), z.number(), z.boolean(), z.null()]),
+    i: z.string().min(1),
+});
+const BASE64URL = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+/** Unpadded base64url over raw bytes — environment-independent (no Buffer). */
+function toBase64Url(bytes) {
+    let out = '';
+    for (let i = 0; i < bytes.length; i += 3) {
+        const a = bytes[i] ?? 0;
+        const b = bytes[i + 1];
+        const c = bytes[i + 2];
+        out += BASE64URL[a >> 2];
+        out += BASE64URL[((a & 0b11) << 4) | ((b ?? 0) >> 4)];
+        if (b !== undefined)
+            out += BASE64URL[((b & 0b1111) << 2) | ((c ?? 0) >> 6)];
+        if (c !== undefined)
+            out += BASE64URL[c & 0b111111];
+    }
+    return out;
+}
+function fromBase64Url(text) {
+    const values = [];
+    for (const char of text) {
+        const value = BASE64URL.indexOf(char);
+        if (value === -1)
+            return null;
+        values.push(value);
+    }
+    if (values.length % 4 === 1)
+        return null;
+    const bytes = [];
+    for (let i = 0; i < values.length; i += 4) {
+        const [a, b, c, d] = [values[i], values[i + 1], values[i + 2], values[i + 3]];
+        if (a === undefined || b === undefined)
+            break;
+        bytes.push((a << 2) | (b >> 4));
+        if (c !== undefined)
+            bytes.push(((b & 0b1111) << 4) | (c >> 2));
+        if (d !== undefined)
+            bytes.push((((c ?? 0) & 0b11) << 6) | d);
+    }
+    return new Uint8Array(bytes);
+}
+/** Encode a list position into an opaque, URL-safe cursor string. */
+export function encodeListCursor(cursor) {
+    // Key order is fixed by construction (v, f, d, s, i) — byte-stable output.
+    const payload = JSON.stringify({
+        v: 1,
+        f: cursor.sortField,
+        d: cursor.direction,
+        s: cursor.sortValue,
+        i: cursor.id,
+    });
+    return LIST_CURSOR_PREFIX + toBase64Url(new TextEncoder().encode(payload));
+}
+/**
+ * Decode a cursor string. Returns `null` for anything malformed — wrong
+ * prefix, bad base64, bad JSON, wrong shape. Never throws; the caller maps
+ * `null` to a structured `invalid-cursor` error.
+ */
+export function decodeListCursor(text) {
+    if (!text.startsWith(LIST_CURSOR_PREFIX))
+        return null;
+    const bytes = fromBase64Url(text.slice(LIST_CURSOR_PREFIX.length));
+    if (!bytes)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(new TextDecoder().decode(bytes));
+    }
+    catch {
+        return null;
+    }
+    const payload = cursorPayloadSchema.safeParse(parsed);
+    if (!payload.success)
+        return null;
+    return {
+        sortField: payload.data.f,
+        direction: payload.data.d,
+        sortValue: payload.data.s,
+        id: payload.data.i,
+    };
+}
+//# sourceMappingURL=cursor.js.map

package/dist/content/cursor.js.map

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

package/dist/content/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @elytracms/content — delivery-shape resolution, the closed-form typed accessor
+ * surface, & per-collection type codegen (EC-142/EC-143, vision AD-3/AD-4).
+ *
+ * The unit of delivery is the resolved document, not the stored row: locale
+ * fallback applied (EC-018), draft/published perspective applied (EC-021),
+ * relations populated to depth-1 as declared in schema, assets resolved to
+ * usable objects. The entire v1 query surface is the accessor ladder —
+ * `resolvePage`, `getDocument`, `listDocuments` — no query language; every
+ * result carries deterministic cache-tag metadata (EC-146). Everything here is
+ * pure functions over `@elytracms/core/cms-core` models — no fetching, no Convex, no
+ * React — and invalid states surface as structured issues, never crashes.
+ */
+export declare const PACKAGE = "@elytracms/core/content";
+export * from './context';
+export * from './perspective';
+export * from './locale';
+export * from './populate';
+export * from './assets';
+export * from './resolve';
+export * from './raw';
+export * from './codegen';
+export * from './query';
+export * from './serialize';
+export * from './cursor';
+export * from './tags';
+export * from './client';
+export * from './binding-sources';

package/dist/content/index.js

@@ -0,0 +1,29 @@
+/**
+ * @elytracms/content — delivery-shape resolution, the closed-form typed accessor
+ * surface, & per-collection type codegen (EC-142/EC-143, vision AD-3/AD-4).
+ *
+ * The unit of delivery is the resolved document, not the stored row: locale
+ * fallback applied (EC-018), draft/published perspective applied (EC-021),
+ * relations populated to depth-1 as declared in schema, assets resolved to
+ * usable objects. The entire v1 query surface is the accessor ladder —
+ * `resolvePage`, `getDocument`, `listDocuments` — no query language; every
+ * result carries deterministic cache-tag metadata (EC-146). Everything here is
+ * pure functions over `@elytracms/core/cms-core` models — no fetching, no Convex, no
+ * React — and invalid states surface as structured issues, never crashes.
+ */
+export const PACKAGE = '@elytracms/core/content';
+export * from './context';
+export * from './perspective';
+export * from './locale';
+export * from './populate';
+export * from './assets';
+export * from './resolve';
+export * from './raw';
+export * from './codegen';
+export * from './query';
+export * from './serialize';
+export * from './cursor';
+export * from './tags';
+export * from './client';
+export * from './binding-sources';
+//# sourceMappingURL=index.js.map

package/dist/content/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,yBAAyB,CAAA;AAEhD,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,OAAO,CAAA;AACrB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,mBAAmB,CAAA"}

package/dist/content/locale.d.ts

@@ -0,0 +1,30 @@
+import type { CmsDocument, CmsPath, CollectionDef, FieldValues, Locale } from '@elytracms/core/cms-core';
+import type { ContentContext } from './context';
+/**
+ * A report entry for one field whose value was served from a different locale
+ * than the one requested (EC-018 default-locale fallback). Paths are rooted at
+ * the resolved document, e.g. `['title']` or `['author', 'bio']` for a field
+ * inside a populated relation.
+ */
+export interface FieldLocaleFallback {
+    path: CmsPath;
+    /** The field name (last path segment, repeated for convenience). */
+    field: string;
+    /** The locale the request asked for. */
+    requestedLocale: Locale;
+    /** The locale the value was actually read from. */
+    sourceLocale: Locale;
+}
+export interface LocaleResolution {
+    /** Flat field values for the requested locale, fallback applied. Fields with
+     * no value anywhere are omitted (never `undefined` entries). */
+    values: FieldValues;
+    /** Which fields used fallback, and from where (EC-018 reporting). */
+    fallbacks: FieldLocaleFallback[];
+}
+/**
+ * Resolve a stored row's field values for the context locale with EC-018
+ * default-locale fallback, reporting every field that actually fell back.
+ * Pure: reads only the given document; never throws.
+ */
+export declare function resolveLocaleValues(context: ContentContext, collection: CollectionDef, doc: CmsDocument, basePath?: CmsPath): LocaleResolution;

package/dist/content/locale.js

@@ -0,0 +1,26 @@
+import { resolveField } from '@elytracms/core/cms-core';
+/**
+ * Resolve a stored row's field values for the context locale with EC-018
+ * default-locale fallback, reporting every field that actually fell back.
+ * Pure: reads only the given document; never throws.
+ */
+export function resolveLocaleValues(context, collection, doc, basePath = []) {
+    const values = {};
+    const fallbacks = [];
+    for (const field of collection.fields) {
+        const resolved = resolveField(collection, doc, field.name, context.locale, context.locales);
+        if (resolved.value === undefined)
+            continue;
+        values[field.name] = resolved.value;
+        if (resolved.fellBack) {
+            fallbacks.push({
+                path: [...basePath, field.name],
+                field: field.name,
+                requestedLocale: context.locale,
+                sourceLocale: resolved.sourceLocale,
+            });
+        }
+    }
+    return { values, fallbacks };
+}
+//# sourceMappingURL=locale.js.map