@elytracms/core 0.0.6

package/dist/content/__fixtures__/sample-accessor-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-accessor-types.js","sourceRoot":"","sources":["../../../src/content/__fixtures__/sample-accessor-types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,gEAAgE;AAChE,sEAAsE"}

package/dist/content/__fixtures__/sample-delivery-types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * 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;
+}
+/**
+ * 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;
+}
+/** Delivery shape for documents in the "asset" collection. */
+export interface Asset {
+    id: string;
+    collection: 'asset';
+    filename: string;
+    alt?: string;
+    url: string;
+}
+/** Depth-1 populated reference to the "asset" collection. */
+export interface AssetRef {
+    id: string;
+    collection: 'asset';
+    filename: string;
+    alt?: string;
+    url: string;
+}
+/** Delivery shape for documents in the "author" collection. */
+export interface Author {
+    id: string;
+    collection: 'author';
+    name: string;
+    bio?: string;
+}
+/** Depth-1 populated reference to the "author" collection. */
+export interface AuthorRef {
+    id: string;
+    collection: 'author';
+    name: string;
+    bio?: string;
+}
+/** Delivery shape for documents in the "page" collection. */
+export interface Page {
+    id: string;
+    collection: 'page';
+    name: string;
+    body?: CompositionBlock[];
+    layoutId?: string;
+    seoTitle?: string;
+    seoDescription?: string;
+    seoCanonical?: string;
+    seoOgTitle?: string;
+    seoOgImage?: string;
+    seoNoindex?: boolean;
+}
+/** Depth-1 populated reference to the "page" collection. */
+export interface PageRef {
+    id: string;
+    collection: 'page';
+    name: string;
+    body?: CompositionBlock[];
+    layoutId?: string;
+    seoTitle?: string;
+    seoDescription?: string;
+    seoCanonical?: string;
+    seoOgTitle?: string;
+    seoOgImage?: string;
+    seoNoindex?: boolean;
+}
+/** Delivery shape for documents in the "post" collection. */
+export interface Post {
+    id: string;
+    collection: 'post';
+    title: string;
+    slug: string;
+    body?: string;
+    views?: number;
+    featured?: boolean;
+    publishedAt?: string | number;
+    status?: 'news' | 'guide';
+    author: AuthorRef;
+    related?: PostRef[];
+    cover?: ResolvedAsset | null;
+}
+/** Depth-1 populated reference to the "post" collection. */
+export interface PostRef {
+    id: string;
+    collection: 'post';
+    title: string;
+    slug: string;
+    body?: string;
+    views?: number;
+    featured?: boolean;
+    publishedAt?: string | number;
+    status?: 'news' | 'guide';
+    author: DocumentStub<'author'>;
+    related?: DocumentStub<'post'>[];
+    cover?: ResolvedAsset | null;
+}

package/dist/content/__fixtures__/sample-delivery-types.js

@@ -0,0 +1,5 @@
+// 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.
+export {};
+//# sourceMappingURL=sample-delivery-types.js.map

package/dist/content/__fixtures__/sample-delivery-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-delivery-types.js","sourceRoot":"","sources":["../../../src/content/__fixtures__/sample-delivery-types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,gEAAgE;AAChE,sEAAsE"}

package/dist/content/assets.d.ts

@@ -0,0 +1,53 @@
+import type { CmsPath, CmsValidationIssue } from '@elytracms/core/cms-core';
+import type { AssetRecord } from '@elytracms/core/persistence';
+/**
+ * The delivery shape of an asset (vision AD-4): a directly usable object, not
+ * an id. Optional metadata that the stored record lacks is `null` (never
+ * `undefined`) so resolved documents stay JSON-stable.
+ */
+export interface ResolvedAsset {
+    /** The asset id the field stored (kept for cache keys and re-lookup). */
+    id: string;
+    /** Resolvable URL for the asset bytes (EC-044 blob storage locator). */
+    url: string;
+    width: number | null;
+    height: number | null;
+    alt: string | null;
+    mimeType: string;
+    /**
+     * Normalized image focal point `{ x, y }` in 0–1 (EC-230), or `null`. Threaded
+     * to the image primitive's CSS `object-position` so a migrated hotspot keeps
+     * the subject in frame when a layout crops the image (`object-fit: cover`).
+     */
+    focalPoint: {
+        x: number;
+        y: number;
+    } | null;
+}
+/**
+ * Pure lookup boundary for asset metadata (EC-044). The caller pre-fetches;
+ * resolution only reads. `assetUrl` turns a metadata record into a resolvable
+ * URL (e.g. via the blob storage adapter's `url(storageKey)`).
+ */
+export interface AssetLookup {
+    asset(id: string): AssetRecord | undefined;
+    assetUrl(asset: AssetRecord): string;
+}
+/** Map a persisted asset record (+ resolved URL) to its delivery shape. */
+export declare function resolvedAsset(record: AssetRecord, url: string): ResolvedAsset;
+export interface AssetResolution {
+    /** The delivery-shaped asset, or `null` when the asset is missing. */
+    asset: ResolvedAsset | null;
+    issues: CmsValidationIssue[];
+}
+export interface AssetResolutionLocation {
+    path: CmsPath;
+    collectionId?: string;
+    documentId?: string;
+}
+/**
+ * Resolve one stored asset id to its delivery shape. A missing asset is a
+ * structured `unknown-asset` issue plus a `null` value — never a crash
+ * (EC-142 acceptance).
+ */
+export declare function resolveAssetValue(lookup: AssetLookup, assetId: string, location: AssetResolutionLocation): AssetResolution;

package/dist/content/assets.js

@@ -0,0 +1,38 @@
+import { cmsIssue } from '@elytracms/core/cms-core';
+/** Map a persisted asset record (+ resolved URL) to its delivery shape. */
+export function resolvedAsset(record, url) {
+    return {
+        id: record.id,
+        url,
+        width: record.width ?? null,
+        height: record.height ?? null,
+        alt: record.alt ?? null,
+        mimeType: record.contentType,
+        focalPoint: record.focalPoint ?? null,
+    };
+}
+/**
+ * Resolve one stored asset id to its delivery shape. A missing asset is a
+ * structured `unknown-asset` issue plus a `null` value — never a crash
+ * (EC-142 acceptance).
+ */
+export function resolveAssetValue(lookup, assetId, location) {
+    const record = lookup.asset(assetId);
+    if (!record) {
+        return {
+            asset: null,
+            issues: [
+                cmsIssue({
+                    code: 'unknown-asset',
+                    message: `Asset "${assetId}" could not be resolved.`,
+                    path: location.path,
+                    ...(location.collectionId ? { collectionId: location.collectionId } : {}),
+                    ...(location.documentId ? { documentId: location.documentId } : {}),
+                    meta: { assetId },
+                }),
+            ],
+        };
+    }
+    return { asset: resolvedAsset(record, lookup.assetUrl(record)), issues: [] };
+}
+//# sourceMappingURL=assets.js.map

package/dist/content/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/content/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAoCnD,2EAA2E;AAC3E,MAAM,UAAU,aAAa,CAAC,MAAmB,EAAE,GAAW;IAC5D,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,GAAG;QACH,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;QAC7B,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI;QACvB,QAAQ,EAAE,MAAM,CAAC,WAAW;QAC5B,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;KACtC,CAAA;AACH,CAAC;AAcD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAmB,EACnB,OAAe,EACf,QAAiC;IAEjC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE;gBACN,QAAQ,CAAC;oBACP,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,UAAU,OAAO,0BAA0B;oBACpD,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzE,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnE,IAAI,EAAE,EAAE,OAAO,EAAE;iBAClB,CAAC;aACH;SACF,CAAA;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;AAC9E,CAAC"}

package/dist/content/binding-sources.d.ts

@@ -0,0 +1,53 @@
+import type { ListDocumentsQuery, SortInput, WhereInput } from './query';
+/**
+ * Binding-source identities & stored-query replay (EC-166 delivery half).
+ *
+ * The builder models collection-driven layouts as per-scope CMS sources. A
+ * repeating section is a per-section list source `cms.section.<nodeId>` whose
+ * config carries the closed AD-3 query (where/sort/limit).
+ *
+ * This prefix is a delivery contract: when a published graph renders in the
+ * embedded runtime, the host materializes each section source by replaying the
+ * stored query through `listDocuments` (published perspective, ambient locale).
+ * The constant lives here — the delivery side — so the builder and every host
+ * speak the same identity scheme.
+ *
+ * EC-187: the `cms.template.<pageId>` "current document" source is RETIRED.
+ * Pages are `page`-collection documents (no template page), and a collection
+ * detail route binds its document directly via the route's `document` ref —
+ * the dev route component reads it, no per-page source indirection.
+ */
+export declare const SECTION_SOURCE_PREFIX = "cms.section.";
+/** The per-section list source id of a repeating section node. */
+export declare function sectionSourceId(nodeId: string): string;
+export declare function isSectionSourceId(sourceId: string): boolean;
+/**
+ * The stored config of a CMS query source, as the builder persists it
+ * (`@elytracms/core/data-binding`'s cms config): the AD-3 `where` shape stored
+ * verbatim in `filter`, plus optional `sort` and `limit`. Structural — this
+ * package does not depend on the builder-side source schemas.
+ */
+export interface CmsSourceQueryConfig {
+    collectionId: string;
+    /** Set on single-document sources (template pages); list sources omit it. */
+    documentId?: string;
+    /** AD-3 `where` input (eq/in/lt/lte/gt/gte, AND-only), stored verbatim. */
+    filter?: WhereInput;
+    sort?: SortInput;
+    limit?: number;
+}
+/**
+ * Read a stored source config back into its structural shape. Total and
+ * lenient by design: only the envelope is checked here — `where`/`sort`/
+ * `limit` *contents* are validated by `listDocuments` itself, which answers
+ * invalid queries as structured errors (never a throw). A malformed envelope
+ * yields `undefined`, so the caller degrades to an unresolved binding (the
+ * renderer's visible fallback), never a crash.
+ */
+export declare function parseCmsSourceQueryConfig(value: unknown): CmsSourceQueryConfig | undefined;
+/**
+ * The `listDocuments` query a stored section config replays at delivery —
+ * exactly the where/sort/limit the editor picked in the builder (the canonical
+ * validators run inside `listDocuments`; nothing is widened here).
+ */
+export declare function listQueryOfCmsConfig(config: CmsSourceQueryConfig): ListDocumentsQuery;

package/dist/content/binding-sources.js

@@ -0,0 +1,73 @@
+/**
+ * Binding-source identities & stored-query replay (EC-166 delivery half).
+ *
+ * The builder models collection-driven layouts as per-scope CMS sources. A
+ * repeating section is a per-section list source `cms.section.<nodeId>` whose
+ * config carries the closed AD-3 query (where/sort/limit).
+ *
+ * This prefix is a delivery contract: when a published graph renders in the
+ * embedded runtime, the host materializes each section source by replaying the
+ * stored query through `listDocuments` (published perspective, ambient locale).
+ * The constant lives here — the delivery side — so the builder and every host
+ * speak the same identity scheme.
+ *
+ * EC-187: the `cms.template.<pageId>` "current document" source is RETIRED.
+ * Pages are `page`-collection documents (no template page), and a collection
+ * detail route binds its document directly via the route's `document` ref —
+ * the dev route component reads it, no per-page source indirection.
+ */
+export const SECTION_SOURCE_PREFIX = 'cms.section.';
+/** The per-section list source id of a repeating section node. */
+export function sectionSourceId(nodeId) {
+    return `${SECTION_SOURCE_PREFIX}${nodeId}`;
+}
+export function isSectionSourceId(sourceId) {
+    return sourceId.startsWith(SECTION_SOURCE_PREFIX);
+}
+const isPlainObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * Read a stored source config back into its structural shape. Total and
+ * lenient by design: only the envelope is checked here — `where`/`sort`/
+ * `limit` *contents* are validated by `listDocuments` itself, which answers
+ * invalid queries as structured errors (never a throw). A malformed envelope
+ * yields `undefined`, so the caller degrades to an unresolved binding (the
+ * renderer's visible fallback), never a crash.
+ */
+export function parseCmsSourceQueryConfig(value) {
+    if (!isPlainObject(value))
+        return undefined;
+    const collectionId = value.collectionId;
+    if (typeof collectionId !== 'string' || collectionId.length === 0)
+        return undefined;
+    const config = { collectionId };
+    if (typeof value.documentId === 'string')
+        config.documentId = value.documentId;
+    if (isPlainObject(value.filter))
+        config.filter = value.filter;
+    if (typeof value.limit === 'number')
+        config.limit = value.limit;
+    const sort = value.sort;
+    if (isPlainObject(sort) && typeof sort.field === 'string') {
+        const direction = sort.direction;
+        config.sort = {
+            field: sort.field,
+            ...(direction === 'asc' || direction === 'desc' ? { direction } : {}),
+        };
+    }
+    return config;
+}
+/**
+ * The `listDocuments` query a stored section config replays at delivery —
+ * exactly the where/sort/limit the editor picked in the builder (the canonical
+ * validators run inside `listDocuments`; nothing is widened here).
+ */
+export function listQueryOfCmsConfig(config) {
+    return {
+        ...(config.filter !== undefined && Object.keys(config.filter).length > 0
+            ? { where: config.filter }
+            : {}),
+        ...(config.sort !== undefined ? { sort: config.sort } : {}),
+        ...(config.limit !== undefined ? { limit: config.limit } : {}),
+    };
+}
+//# sourceMappingURL=binding-sources.js.map

package/dist/content/binding-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-sources.js","sourceRoot":"","sources":["../../src/content/binding-sources.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,cAAc,CAAA;AAEnD,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,GAAG,qBAAqB,GAAG,MAAM,EAAE,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,QAAQ,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAA;AACnD,CAAC;AAkBD,MAAM,aAAa,GAAG,CAAC,KAAc,EAAoC,EAAE,CACzE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAEtE;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAC3C,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAA;IACvC,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAEnF,MAAM,MAAM,GAAyB,EAAE,YAAY,EAAE,CAAA;IACrD,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QAAE,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAA;IAC9E,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAoB,CAAA;IAC3E,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;IAE/D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IACvB,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAA;QAChC,MAAM,CAAC,IAAI,GAAG;YACZ,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,CAAC,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA4B;IAC/D,OAAO;QACL,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC;YACtE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;YAC1B,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAA;AACH,CAAC"}

package/dist/content/client.d.ts

@@ -0,0 +1,90 @@
+import type { CmsValidationIssue, DocumentRef, Locale, RedirectRecord, ResolveStatus, RouteRecord } from '@elytracms/core/cms-core';
+import type { ContentContext } from './context';
+import type { ContentQueryError, ListDocumentsQuery, WhereInput } from './query';
+import type { ContentLookup, DeliveryDocument, ResolutionInfo, ResolvedDocument } from './resolve';
+import type { CacheTags } from './tags';
+/**
+ * The closed-form v1 query surface (EC-143, vision AD-3): `resolvePage`,
+ * `getDocument`, `listDocuments` — no query language. Every result is
+ * delivery-shaped (EC-142) and carries deterministic `CacheTags` for EC-146.
+ *
+ * Pure and synchronous like the rest of the package: the client reads through
+ * a `ContentLookup`; EC-144/EC-145 bind it to Convex/Next later. The ambient
+ * `{ locale, perspective }` context is taken once at creation — never per-call
+ * ceremony (per-call `locale` overrides exist for route-level needs only).
+ */
+export interface ResolvePageResult {
+    /** Route resolution status (EC-019 parity): ok | redirect | notFound. */
+    status: ResolveStatus;
+    /** The matched route record, when status is `ok`. */
+    route: RouteRecord | null;
+    /** Extracted dynamic params, e.g. `{ slug: 'hello-world' }`. */
+    dynamicParams: Record<string, string>;
+    /** True when route matching fell back to the default locale (EC-018). */
+    localeFallback: boolean;
+    /** Terminal redirect target + permanence, when status is `redirect`. */
+    redirect: {
+        target: string;
+        permanent: boolean;
+    } | null;
+    /**
+     * The document this URL resolves to, delivery-shaped (EC-142, EC-187). A
+     * `page`-collection document (its `body` composition renders into a layout)
+     * or a content-collection document (rendered by a dev route component). SEO
+     * for a page is read from this document's flat `seo*` fields — there is no
+     * separate page-graph `seo` block anymore.
+     */
+    document: ResolvedDocument | null;
+    issues: CmsValidationIssue[];
+    tags: CacheTags;
+}
+export interface GetDocumentResult<TDoc extends DeliveryDocument = ResolvedDocument> {
+    /**
+     * The delivery-shaped document, or `null` when not found / not visible in
+     * the context perspective (correct behavior, not an error — see EC-142).
+     */
+    document: TDoc | null;
+    info: ResolutionInfo | null;
+    issues: CmsValidationIssue[];
+    tags: CacheTags;
+}
+export type ListDocumentsResult<TDoc extends DeliveryDocument = ResolvedDocument> = {
+    ok: true;
+    documents: TDoc[];
+    /** Cursor for the next page, `null` when this page exhausts the list. */
+    nextCursor: string | null;
+    issues: CmsValidationIssue[];
+    tags: CacheTags;
+} | {
+    /** The query itself was invalid (never thrown — structured errors). */
+    ok: false;
+    errors: ContentQueryError[];
+    tags: CacheTags;
+};
+export interface ContentClient {
+    readonly context: ContentContext;
+    /** Structural route issues from construction (conflicts, redirect loops). */
+    readonly routerIssues: readonly CmsValidationIssue[];
+    resolvePage(url: string, locale?: Locale): ResolvePageResult;
+    getDocument<TDoc extends DeliveryDocument = ResolvedDocument>(collection: string, idOrSlug: string, locale?: Locale): GetDocumentResult<TDoc>;
+    listDocuments<TDoc extends DeliveryDocument = ResolvedDocument, TWhere extends WhereInput = WhereInput>(collection: string, query?: ListDocumentsQuery<TWhere>): ListDocumentsResult<TDoc>;
+    /**
+     * Populate a relation reference to depth-1 delivery shape (EC-254), or `null`
+     * when the target is missing or not visible in the active perspective. A
+     * renderer host wires this as `RenderContext.resolveRelation` to populate the
+     * COMPOSITION-NODE relation props of the nodes inside a page's `blocks` field
+     * (e.g. a ProductGrid block's picked `product`s) — which `resolvePage` leaves
+     * raw, since document resolution does not descend into a composition value.
+     */
+    resolveRelation(ref: DocumentRef): ResolvedDocument | null;
+}
+export interface ContentClientInit {
+    lookup: ContentLookup;
+    context: ContentContext;
+    /** Route records for `resolvePage` (EC-019). */
+    routes?: readonly RouteRecord[];
+    /** Redirect records for `resolvePage` (EC-019/020). */
+    redirects?: readonly RedirectRecord[];
+}
+/** Create the typed accessor client (vision AD-3 ladder, rungs 1–3). */
+export declare function createContentClient(init: ContentClientInit): ContentClient;