@elytracms/core 0.0.6

package/dist/content/resolve.js

@@ -0,0 +1,261 @@
+import { cmsIssue, readAssetId, validateLocale } from '@elytracms/core/cms-core';
+import { resolveAssetValue } from './assets';
+import { resolveLocaleValues } from './locale';
+import { selectPerspective } from './perspective';
+import { isPopulatedRelation, parseRelationRef, relationStub } from './populate';
+function invalidValueIssue(field, collection, documentId, path, expected) {
+    return cmsIssue({
+        code: 'invalid-field-value',
+        message: `Field "${field.name}" on "${collection.id}" holds a value that is not ${expected}.`,
+        path,
+        collectionId: collection.id,
+        documentId,
+        meta: { field: field.name, expected },
+    });
+}
+/**
+ * Resolve a single relation target. At depth 0 with population enabled this
+ * returns the depth-1 populated reference (`{ id, collection, ...fields }`);
+ * otherwise the `{ id, collection }` stub. A missing or perspective-invisible
+ * target degrades to the stub plus an `unknown-relation-target` issue — the
+ * value is never a bare id string and resolution never throws.
+ */
+function resolveRelationTarget(context, lookup, ref, populate, path, ownerCollectionId, ownerDocumentId, acc) {
+    if (!populate)
+        return { ...relationStub(ref) };
+    const missing = (reason) => {
+        acc.issues.push(cmsIssue({
+            code: 'unknown-relation-target',
+            message: `Relation target "${ref.collection}:${ref.id}" could not be populated (${reason}).`,
+            path,
+            collectionId: ownerCollectionId,
+            documentId: ownerDocumentId,
+            meta: { targetCollection: ref.collection, targetId: ref.id, reason },
+        }));
+        return { ...relationStub(ref) };
+    };
+    const targetCollection = lookup.collection(ref.collection);
+    if (!targetCollection)
+        return missing('unknown collection');
+    const source = lookup.document(ref);
+    if (!source)
+        return missing('document not found');
+    const visible = selectPerspective(context, source);
+    if (!visible)
+        return missing(`not visible in ${context.perspective} perspective`);
+    // Depth-1 populated reference: id + resolved fields. Relations inside it
+    // stay stubs (depth > 0); assets inside it still resolve to objects.
+    const fields = resolveFields(context, lookup, targetCollection, visible, 1, path, acc);
+    return { id: ref.id, collection: ref.collection, ...fields };
+}
+function resolveRelationField(context, lookup, collection, doc, field, value, depth, path, acc) {
+    const populate = depth === 0 && isPopulatedRelation(field);
+    if (field.cardinality === 'many') {
+        if (!Array.isArray(value)) {
+            acc.issues.push(invalidValueIssue(field, collection, doc.id, path, 'an array of references'));
+            return undefined;
+        }
+        const out = [];
+        value.forEach((entry, index) => {
+            const ref = parseRelationRef(entry);
+            if (!ref) {
+                acc.issues.push(invalidValueIssue(field, collection, doc.id, [...path, index], 'a { collection, id } reference'));
+                return;
+            }
+            out.push(resolveRelationTarget(context, lookup, ref, populate, [...path, index], collection.id, doc.id, acc));
+        });
+        return out;
+    }
+    const ref = parseRelationRef(value);
+    if (!ref) {
+        acc.issues.push(invalidValueIssue(field, collection, doc.id, path, 'a { collection, id } reference'));
+        return undefined;
+    }
+    return resolveRelationTarget(context, lookup, ref, populate, path, collection.id, doc.id, acc);
+}
+function resolveAssetField(lookup, collection, doc, field, value, path, acc) {
+    const resolveOne = (rawAsset, entryPath) => {
+        // EC-277: asset values are self-typed (`{ type:'asset', id }`); `readAssetId`
+        // unwraps that and legacy bare id strings (lazy-on-read).
+        const assetId = readAssetId(rawAsset);
+        if (assetId === undefined) {
+            acc.issues.push(invalidValueIssue(field, collection, doc.id, entryPath, 'an asset id'));
+            return null;
+        }
+        const resolution = resolveAssetValue(lookup, assetId, {
+            path: entryPath,
+            collectionId: collection.id,
+            documentId: doc.id,
+        });
+        acc.issues.push(...resolution.issues);
+        return resolution.asset;
+    };
+    if (field.cardinality === 'many') {
+        if (!Array.isArray(value)) {
+            acc.issues.push(invalidValueIssue(field, collection, doc.id, path, 'an array of asset ids'));
+            return undefined;
+        }
+        // Unresolvable entries are dropped from the array (each already reported
+        // as an issue) so consumers never iterate over null holes.
+        return value
+            .map((entry, index) => resolveOne(entry, [...path, index]))
+            .filter((asset) => asset !== null);
+    }
+    return resolveOne(value, path);
+}
+/**
+ * Resolve an `object` / repeater field value (EC-253) by resolving each item's
+ * subfields at the same population depth, so a nested relation/asset subfield is
+ * populated exactly as a top-level field would be (depth-1 populated at the top,
+ * stubs inside a populated ref). `many` is an array of objects; `one` a single
+ * object. Malformed items are reported and dropped — resolution never throws.
+ */
+function resolveObjectField(context, lookup, collection, doc, field, value, depth, path, acc) {
+    const resolveItem = (item, itemPath) => {
+        if (typeof item !== 'object' || item === null || Array.isArray(item)) {
+            acc.issues.push(invalidValueIssue(field, collection, doc.id, itemPath, 'an object'));
+            return null;
+        }
+        const record = item;
+        const out = {};
+        for (const sub of field.fields) {
+            const subValue = record[sub.name];
+            if (subValue === undefined)
+                continue;
+            const resolved = resolveFieldValue(context, lookup, collection, doc, sub, subValue, depth, [...itemPath, sub.name], acc);
+            if (resolved !== undefined)
+                out[sub.name] = resolved;
+        }
+        return out;
+    };
+    if (field.cardinality === 'many') {
+        if (!Array.isArray(value)) {
+            acc.issues.push(invalidValueIssue(field, collection, doc.id, path, 'an array of objects'));
+            return undefined;
+        }
+        return value
+            .map((item, index) => resolveItem(item, [...path, index]))
+            .filter((item) => item !== null);
+    }
+    return resolveItem(value, path) ?? undefined;
+}
+/**
+ * Resolve one field value at a population depth — the switch shared by the
+ * document loop and the {@link resolveObjectField} recursion (EC-253). Relation
+ * population (depth-1 only) and asset resolution stay identical at every level.
+ */
+function resolveFieldValue(context, lookup, collection, doc, field, value, depth, path, acc) {
+    switch (field.type) {
+        case 'relation':
+            return resolveRelationField(context, lookup, collection, doc, field, value, depth, path, acc);
+        case 'asset':
+            return resolveAssetField(lookup, collection, doc, field, value, path, acc);
+        case 'object':
+            return resolveObjectField(context, lookup, collection, doc, field, value, depth, path, acc);
+        default:
+            return value;
+    }
+}
+/**
+ * Resolve all field values of one stored row at a given population depth:
+ * locale fallback first (EC-018), then relation population (depth-1 only),
+ * then asset resolution. Shared by the top-level document (depth 0) and by
+ * populated relation targets (depth 1, where relations stay stubs).
+ */
+function resolveFields(context, lookup, collection, doc, depth, basePath, acc) {
+    const localeResolution = resolveLocaleValues(context, collection, doc, basePath);
+    acc.fallbacks.push(...localeResolution.fallbacks);
+    const out = {};
+    for (const field of collection.fields) {
+        const value = localeResolution.values[field.name];
+        if (value === undefined)
+            continue;
+        const resolved = resolveFieldValue(context, lookup, collection, doc, field, value, depth, [...basePath, field.name], acc);
+        if (resolved !== undefined)
+            out[field.name] = resolved;
+    }
+    return out;
+}
+/**
+ * Resolve one document source into delivery shape (vision AD-4): locale
+ * fallback applied (EC-018), draft/published perspective applied (EC-021),
+ * relations populated to depth-1 as declared in schema, and assets resolved to
+ * `{ url, width, height, alt, mimeType }` objects. Pure and total: invalid
+ * states surface as structured issues alongside the result — never thrown.
+ */
+export function resolveDocument(context, lookup, source) {
+    const acc = {
+        fallbacks: [],
+        issues: [...validateLocale(context.locales, context.locale)],
+    };
+    const info = () => ({
+        locale: context.locale,
+        perspective: context.perspective,
+        localeFallbacks: acc.fallbacks,
+    });
+    const doc = selectPerspective(context, source);
+    if (!doc)
+        return { document: null, info: info(), issues: acc.issues };
+    const collection = lookup.collection(doc.collection);
+    if (!collection) {
+        acc.issues.push(cmsIssue({
+            code: 'unknown-collection',
+            message: `Document "${doc.id}" belongs to unknown collection "${doc.collection}".`,
+            path: ['collection'],
+            collectionId: doc.collection,
+            documentId: doc.id,
+        }));
+        return { document: null, info: info(), issues: acc.issues };
+    }
+    const fields = resolveFields(context, lookup, collection, doc, 0, [], acc);
+    return {
+        document: { id: doc.id, collection: doc.collection, ...fields },
+        info: info(),
+        issues: acc.issues,
+    };
+}
+/**
+ * Populate a single relation reference to depth-1 delivery shape — the public
+ * entry a renderer host wires as `RenderContext.resolveRelation` to populate a
+ * COMPOSITION-NODE relation PROP (EC-254). This is distinct from a document
+ * FIELD relation, which {@link resolveDocument} already populates inline via the
+ * internal `resolveRelationTarget`: a page's `blocks` field passes through as raw
+ * composition, so the relation props of the nodes inside it (e.g. a ProductGrid's
+ * picked `product`s) are never touched by document resolution and need this.
+ *
+ * Mirrors `resolveRelationTarget`'s populated branch exactly — perspective gated
+ * (EC-021), relations inside the target stay stubs (depth-1), assets inside it
+ * resolve to objects — but returns `null` (not the `{ id, collection }` stub) on
+ * a miss, the cleaner "populated or nothing" contract a prop wants. Pure and
+ * total: never throws; the reason for a miss is collected as a structured issue.
+ */
+export function populateRelationRef(context, lookup, ref) {
+    const acc = { fallbacks: [], issues: [] };
+    const miss = (reason) => {
+        acc.issues.push(cmsIssue({
+            code: 'unknown-relation-target',
+            message: `Relation target "${ref.collection}:${ref.id}" could not be populated (${reason}).`,
+            path: [ref.collection, ref.id],
+            collectionId: ref.collection,
+            documentId: ref.id,
+            meta: { targetCollection: ref.collection, targetId: ref.id, reason },
+        }));
+        return { document: null, issues: acc.issues };
+    };
+    const targetCollection = lookup.collection(ref.collection);
+    if (!targetCollection)
+        return miss('unknown collection');
+    const source = lookup.document(ref);
+    if (!source)
+        return miss('document not found');
+    const visible = selectPerspective(context, source);
+    if (!visible)
+        return miss(`not visible in ${context.perspective} perspective`);
+    // Depth-1: the target's own relations stay stubs, its assets resolve to objects.
+    const fields = resolveFields(context, lookup, targetCollection, visible, 1, [], acc);
+    return {
+        document: { id: ref.id, collection: ref.collection, ...fields },
+        issues: acc.issues,
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/content/resolve.js.map

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

package/dist/content/serialize.d.ts

@@ -0,0 +1,30 @@
+import type { ListDocumentsQuery } from './query';
+/**
+ * Deterministic query serialization (EC-143): a byte-stable string for
+ * `{ where, sort, limit, cursor }`, exported for cache-key use (EC-146 keys
+ * cached list fetches on it). Two semantically identical queries — regardless
+ * of object-key insertion order or the `eq` shorthand — serialize to the
+ * exact same bytes.
+ */
+/**
+ * JSON.stringify with object keys sorted recursively at every level. Arrays
+ * keep their order (order is meaningful for `in` lists). `undefined` entries
+ * are omitted, like JSON.stringify.
+ */
+export declare function stableStringify(value: unknown): string;
+/**
+ * The canonical serialization of a `listDocuments` query. Normal form:
+ *
+ * `{"cursor":<string|null>,"limit":<number|null>,"sort":{"direction":...,"field":...}|null,"where":{<field>:{<op>:<value>}}}`
+ *
+ * - `where` fields sorted by name; bare-scalar shorthand expanded to `eq`;
+ *   operators in alphabetical order (`eq,gt,gte,in,lt,lte`).
+ * - `sort.direction` defaults to `"asc"` explicitly so its presence never
+ *   changes the key.
+ * - Absent `cursor`/`limit`/`sort` serialize as `null` (fixed shape, fixed
+ *   key order — byte-stable).
+ *
+ * Compose with collection / locale / perspective externally when building a
+ * full cache key (EC-146).
+ */
+export declare function serializeListQuery(query: ListDocumentsQuery): string;

package/dist/content/serialize.js

@@ -0,0 +1,57 @@
+import { normalizeWhere } from './query';
+/**
+ * Deterministic query serialization (EC-143): a byte-stable string for
+ * `{ where, sort, limit, cursor }`, exported for cache-key use (EC-146 keys
+ * cached list fetches on it). Two semantically identical queries — regardless
+ * of object-key insertion order or the `eq` shorthand — serialize to the
+ * exact same bytes.
+ */
+/**
+ * JSON.stringify with object keys sorted recursively at every level. Arrays
+ * keep their order (order is meaningful for `in` lists). `undefined` entries
+ * are omitted, like JSON.stringify.
+ */
+export function stableStringify(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value) ?? 'null';
+    if (Array.isArray(value)) {
+        return `[${value.map((entry) => stableStringify(entry === undefined ? null : entry)).join(',')}]`;
+    }
+    const record = value;
+    const parts = [];
+    for (const key of Object.keys(record).sort()) {
+        const entry = record[key];
+        if (entry === undefined)
+            continue;
+        parts.push(`${JSON.stringify(key)}:${stableStringify(entry)}`);
+    }
+    return `{${parts.join(',')}}`;
+}
+/**
+ * The canonical serialization of a `listDocuments` query. Normal form:
+ *
+ * `{"cursor":<string|null>,"limit":<number|null>,"sort":{"direction":...,"field":...}|null,"where":{<field>:{<op>:<value>}}}`
+ *
+ * - `where` fields sorted by name; bare-scalar shorthand expanded to `eq`;
+ *   operators in alphabetical order (`eq,gt,gte,in,lt,lte`).
+ * - `sort.direction` defaults to `"asc"` explicitly so its presence never
+ *   changes the key.
+ * - Absent `cursor`/`limit`/`sort` serialize as `null` (fixed shape, fixed
+ *   key order — byte-stable).
+ *
+ * Compose with collection / locale / perspective externally when building a
+ * full cache key (EC-146).
+ */
+export function serializeListQuery(query) {
+    const where = {};
+    for (const entry of normalizeWhere(query.where ?? {})) {
+        where[entry.field] = entry.condition;
+    }
+    return stableStringify({
+        cursor: query.cursor ?? null,
+        limit: query.limit ?? null,
+        sort: query.sort ? { direction: query.sort.direction ?? 'asc', field: query.sort.field } : null,
+        where,
+    });
+}
+//# sourceMappingURL=serialize.js.map

package/dist/content/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/content/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAGxC;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAA;IACvF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IACnG,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAA;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QACzB,IAAI,KAAK,KAAK,SAAS;YAAE,SAAQ;QACjC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAChE,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;AAC/B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC1D,MAAM,KAAK,GAAwC,EAAE,CAAA;IACrD,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACtD,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,SAAS,CAAA;IACtC,CAAC;IACD,OAAO,eAAe,CAAC;QACrB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;QAC1B,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI;QAC/F,KAAK;KACN,CAAC,CAAA;AACJ,CAAC"}

package/dist/content/tags.d.ts

@@ -0,0 +1,54 @@
+import type { CollectionDef, Locale } from '@elytracms/core/cms-core';
+import type { ResolvedDocument } from './resolve';
+/**
+ * Cache-tag metadata carried by every accessor result (EC-143, vision AD-5):
+ * fetch-time tagging of what was *actually returned*, so EC-146 can map each
+ * entry to a `revalidateTag` call. Deterministic by construction — every list
+ * is sorted and deduplicated.
+ */
+export interface CacheTags {
+    /**
+     * Identities of every document whose content is present in the result —
+     * the returned documents themselves plus their depth-1 populated relation
+     * targets. Entries are `documentKey` strings (`collection:id`), sorted.
+     */
+    docs: string[];
+    /**
+     * Collections the accessor read from (the coarse membership tags of AD-5:
+     * create/delete/publish in a collection sweeps them). Sorted.
+     */
+    collections: string[];
+    /**
+     * Normalized URL paths the accessor touched (`resolvePage` only): the
+     * requested path, plus every hop of a redirect chain — editing any hop
+     * changes the result. Sorted.
+     */
+    routes: string[];
+    /**
+     * Asset ids the result *baked* its delivery shape from (EC-227): the page's
+     * page-scoped `ResolvedAsset` set (url/dimensions/alt) + its `seoOgImage`.
+     * Editing the asset record (alt/dimensions/re-upload) must drop the page that
+     * baked it — without this dimension the only invalidation triggers are
+     * unrelated (doc/collection/project), so an asset-only edit serves stale
+     * until one of those fires. Sorted.
+     */
+    assets: string[];
+    /** The locale the result was resolved for. */
+    locale: Locale;
+}
+export interface CacheTagsInit {
+    docs?: readonly string[];
+    collections?: readonly string[];
+    routes?: readonly string[];
+    assets?: readonly string[];
+    locale: Locale;
+}
+/** Build a `CacheTags` with deterministic (sorted, deduplicated) entries. */
+export declare function cacheTags(init: CacheTagsInit): CacheTags;
+/**
+ * The document tags one resolved document contributes: its own identity plus
+ * every relation target referenced in its top-level relation fields. Populated
+ * targets had their content returned (so a change to them must invalidate);
+ * stubs are included too — slightly coarse, always correct (AD-5 stance).
+ */
+export declare function documentCacheKeys(collection: CollectionDef, document: ResolvedDocument): string[];

package/dist/content/tags.js

@@ -0,0 +1,40 @@
+import { documentKey } from '@elytracms/core/cms-core';
+function sortedUnique(values) {
+    return [...new Set(values)].sort();
+}
+/** Build a `CacheTags` with deterministic (sorted, deduplicated) entries. */
+export function cacheTags(init) {
+    return {
+        docs: sortedUnique(init.docs ?? []),
+        collections: sortedUnique(init.collections ?? []),
+        routes: sortedUnique(init.routes ?? []),
+        assets: sortedUnique(init.assets ?? []),
+        locale: init.locale,
+    };
+}
+/**
+ * The document tags one resolved document contributes: its own identity plus
+ * every relation target referenced in its top-level relation fields. Populated
+ * targets had their content returned (so a change to them must invalidate);
+ * stubs are included too — slightly coarse, always correct (AD-5 stance).
+ */
+export function documentCacheKeys(collection, document) {
+    const keys = [documentKey({ collection: document.collection, id: document.id })];
+    for (const field of collection.fields) {
+        if (field.type !== 'relation')
+            continue;
+        const value = document[field.name];
+        const entries = Array.isArray(value) ? value : [value];
+        for (const entry of entries) {
+            if (entry !== null &&
+                typeof entry === 'object' &&
+                typeof entry.id === 'string' &&
+                typeof entry.collection === 'string') {
+                const ref = entry;
+                keys.push(documentKey({ collection: ref.collection, id: ref.id }));
+            }
+        }
+    }
+    return keys;
+}
+//# sourceMappingURL=tags.js.map

package/dist/content/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../src/content/tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAiDtD,SAAS,YAAY,CAAC,MAAyB;IAC7C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AACpC,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,SAAS,CAAC,IAAmB;IAC3C,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QACnC,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QACjD,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QACvC,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QACvC,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAyB,EAAE,QAA0B;IACrF,MAAM,IAAI,GAAG,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IAChF,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;YAAE,SAAQ;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAClC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACtD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IACE,KAAK,KAAK,IAAI;gBACd,OAAO,KAAK,KAAK,QAAQ;gBACzB,OAAQ,KAA0B,CAAC,EAAE,KAAK,QAAQ;gBAClD,OAAQ,KAAkC,CAAC,UAAU,KAAK,QAAQ,EAClE,CAAC;gBACD,MAAM,GAAG,GAAG,KAA2C,CAAA;gBACvD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;YACpE,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/data-binding/fixtures.d.ts

@@ -0,0 +1,20 @@
+import type { JsonValue } from '@elytracms/core/project-graph';
+import type { CmsSource, ConvexSource, DataSource, RestSource } from './sources';
+import { SourceRegistry } from './sources';
+/**
+ * Shared fixtures for the data-binding tests. One representative source per kind (EC-022) plus
+ * a captured sample (EC-023) so resolution (EC-024) is exercised end-to-end and deterministically.
+ */
+/** A representative list payload: an array of post objects, mirroring the project-graph fixtures. */
+export declare const samplePostsPayload: JsonValue;
+/** A representative single-document payload. */
+export declare const sampleHeroPayload: JsonValue;
+export declare const restSource: RestSource;
+export declare const cmsSource: CmsSource;
+export declare const convexSource: ConvexSource;
+/** All three sample sources as one uniform list. */
+export declare const sampleSources: DataSource[];
+/** A registry over all three sample sources. */
+export declare const sampleRegistry: SourceRegistry;
+/** A payload store keyed by source id, as the renderer would build it. */
+export declare const samplePayloadStore: Record<string, JsonValue>;

package/dist/data-binding/fixtures.js

@@ -0,0 +1,47 @@
+import { captureSample } from './sample';
+import { SourceRegistry } from './sources';
+/**
+ * Shared fixtures for the data-binding tests. One representative source per kind (EC-022) plus
+ * a captured sample (EC-023) so resolution (EC-024) is exercised end-to-end and deterministically.
+ */
+/** A representative list payload: an array of post objects, mirroring the project-graph fixtures. */
+export const samplePostsPayload = [
+    { id: 'p1', title: 'First Post', author: { name: 'Ada' }, tags: ['a', 'b'], featured: true, views: 10 },
+    { id: 'p2', title: 'Second Post', author: { name: 'Lin' }, tags: [], featured: false, views: 3 },
+];
+/** A representative single-document payload. */
+export const sampleHeroPayload = {
+    heading: 'Welcome',
+    subheading: 'A code-first website builder.',
+    cta: { label: 'Get started', href: '/start' },
+    published: true,
+};
+export const restSource = captureSample({
+    kind: 'rest',
+    id: 'rest.products',
+    label: 'Products API',
+    config: { url: 'https://api.example.com/products', method: 'GET', headers: {}, query: {} },
+}, samplePostsPayload);
+export const cmsSource = captureSample({
+    kind: 'cms',
+    id: 'cms.posts',
+    label: 'Blog Posts',
+    config: { collectionId: 'collection.posts', filter: {} },
+}, samplePostsPayload);
+export const convexSource = captureSample({
+    kind: 'convex',
+    id: 'convex.hero',
+    label: 'Hero document',
+    config: { operation: 'query', functionRef: 'hero:get', args: {} },
+}, sampleHeroPayload);
+/** All three sample sources as one uniform list. */
+export const sampleSources = [restSource, cmsSource, convexSource];
+/** A registry over all three sample sources. */
+export const sampleRegistry = SourceRegistry.from(sampleSources);
+/** A payload store keyed by source id, as the renderer would build it. */
+export const samplePayloadStore = {
+    'rest.products': samplePostsPayload,
+    'cms.posts': samplePostsPayload,
+    'convex.hero': sampleHeroPayload,
+};
+//# sourceMappingURL=fixtures.js.map

package/dist/data-binding/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/data-binding/fixtures.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE1C;;;GAGG;AAEH,qGAAqG;AACrG,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;IACvG,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE;CACjG,CAAA;AAED,gDAAgD;AAChD,MAAM,CAAC,MAAM,iBAAiB,GAAc;IAC1C,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,+BAA+B;IAC3C,GAAG,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC7C,SAAS,EAAE,IAAI;CAChB,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAe,aAAa,CACjD;IACE,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,EAAE,GAAG,EAAE,kCAAkC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;CAC3F,EACD,kBAAkB,CACnB,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAc,aAAa,CAC/C;IACE,IAAI,EAAE,KAAK;IACX,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAE,EAAE;CACzD,EACD,kBAAkB,CACnB,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAiB,aAAa,CACrD;IACE,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE;CAClE,EACD,iBAAiB,CAClB,CAAA;AAED,oDAAoD;AACpD,MAAM,CAAC,MAAM,aAAa,GAAiB,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CAAA;AAEhF,gDAAgD;AAChD,MAAM,CAAC,MAAM,cAAc,GAAmB,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;AAEhF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAA8B;IAC3D,eAAe,EAAE,kBAAkB;IACnC,WAAW,EAAE,kBAAkB;IAC/B,aAAa,EAAE,iBAAiB;CACjC,CAAA"}

package/dist/data-binding/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @elytracms/data-binding — the uniform binding model shared by REST, CMS, and Convex sources
+ * (brief §4.6, §7.5). Reuses `@elytracms/core/project-graph`'s BindingReference / BindingMode /
+ * Condition; adds source definitions + registry (EC-022), sample capture, schema inference and
+ * stable path tokens (EC-023), and binding-mode resolution with structured broken-binding
+ * issues (EC-024).
+ */
+export declare const PACKAGE = "@elytracms/core/data-binding";
+export * from './issues';
+export * from './tokens';
+export * from './sources';
+export * from './sample';
+export * from './resolve';
+export * from './fixtures';

package/dist/data-binding/index.js

@@ -0,0 +1,15 @@
+/**
+ * @elytracms/data-binding — the uniform binding model shared by REST, CMS, and Convex sources
+ * (brief §4.6, §7.5). Reuses `@elytracms/core/project-graph`'s BindingReference / BindingMode /
+ * Condition; adds source definitions + registry (EC-022), sample capture, schema inference and
+ * stable path tokens (EC-023), and binding-mode resolution with structured broken-binding
+ * issues (EC-024).
+ */
+export const PACKAGE = '@elytracms/core/data-binding';
+export * from './issues';
+export * from './tokens';
+export * from './sources';
+export * from './sample';
+export * from './resolve';
+export * from './fixtures';
+//# sourceMappingURL=index.js.map

package/dist/data-binding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data-binding/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,8BAA8B,CAAA;AAErD,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA"}

package/dist/data-binding/issues.d.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+/**
+ * Stable codes for structured binding issues. Broken bindings are represented as data —
+ * never thrown — so the renderer can show a fallback and the inspector can surface the
+ * problem (brief §4.6, §7.5; AGENTS.md "validation is first-class").
+ *
+ * - `unknown-source`     the binding's `sourceId` is not in the source registry
+ * - `unresolved-token`   the token does not resolve to a value in the payload
+ * - `missing-item`       a `repeaterItem` binding was resolved with no item context
+ * - `invalid-spread`     a `spread` binding resolved to a non-object (cannot spread)
+ * - `no-sample`          an operation needed a captured sample but none was present
+ */
+export declare const bindingIssueCodeSchema: z.ZodEnum<{
+    "unknown-source": "unknown-source";
+    "unresolved-token": "unresolved-token";
+    "missing-item": "missing-item";
+    "invalid-spread": "invalid-spread";
+    "no-sample": "no-sample";
+}>;
+export type BindingIssueCode = z.infer<typeof bindingIssueCodeSchema>;
+/**
+ * A structured binding issue. Mirrors `@elytracms/core/project-graph`'s ValidationIssue shape
+ * (code/message/meta) but scoped to binding resolution, where the relevant locator is the
+ * source id and token rather than a graph path.
+ */
+export declare const bindingIssueSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        "unknown-source": "unknown-source";
+        "unresolved-token": "unresolved-token";
+        "missing-item": "missing-item";
+        "invalid-spread": "invalid-spread";
+        "no-sample": "no-sample";
+    }>;
+    message: z.ZodString;
+    sourceId: z.ZodOptional<z.ZodString>;
+    token: z.ZodOptional<z.ZodString>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("@elytracms/core/project-graph").JsonValue, unknown, z.core.$ZodTypeInternals<import("@elytracms/core/project-graph").JsonValue, unknown>>>>;
+}, z.core.$strip>;
+export type BindingIssue = z.infer<typeof bindingIssueSchema>;
+/** Construct a {@link BindingIssue} with optional locator/meta fields omitted when absent. */
+export declare function bindingIssue(code: BindingIssueCode, message: string, fields?: {
+    sourceId?: string;
+    token?: string;
+    meta?: BindingIssue['meta'];
+}): BindingIssue;