@elytracms/studio 0.0.1

package/dist/lib/cms-views/views-store.d.ts

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import type { CmsDocument, CollectionDef } from '@elytracms/cms-core';
+import type { OperationResult, OperationsClient } from '../operations';
+/**
+ * Saved-view persistence for the CMS collection table (EC-169).
+ *
+ * Views are project-scoped (shared by every editor on the project) and follow
+ * the EC-170 routing-store pattern: one system collection holds one document
+ * per saved view, and every mutation goes through the *existing*
+ * `@elytracms/operations` commands (`schema.upsertCollection`,
+ * `documents.upsert`, `documents.delete`). The settings domain was the other
+ * candidate, but `settings.update` patches the closed `projectSettingsSchema`
+ * (locales/environments/export target) — saved views don't fit it without a
+ * studio-core schema change, while the system collection needs no new
+ * operations surface at all.
+ *
+ * Deleting a saved view is exactly one `documents.delete` against THIS
+ * collection — it can never touch content documents.
+ */
+export declare const VIEWS_COLLECTION = "cms-saved-views";
+/** System collection holding one document per {@link SavedViewRecord}. */
+export declare const viewsCollectionDef: CollectionDef;
+/** A persisted saved view: identity + the table state it restores. */
+export declare const savedViewRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    collection: z.ZodString;
+    state: z.ZodObject<{
+        filters: z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                eq: "eq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+            }>;
+            value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>;
+        }, z.core.$strip>>;
+        sort: z.ZodNullable<z.ZodObject<{
+            field: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>;
+        columns: z.ZodArray<z.ZodString>;
+        hidden: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SavedViewRecord = z.infer<typeof savedViewRecordSchema>;
+export declare function viewToDocument(record: SavedViewRecord): CmsDocument;
+export declare function documentToView(document: CmsDocument): SavedViewRecord | undefined;
+/** Load every persisted saved view of a project (malformed records dropped). */
+export declare function loadSavedViews(operations: OperationsClient, projectId: string): Promise<OperationResult<SavedViewRecord[]>>;
+/** Group loaded records by their content collection (for per-collection lookup). */
+export declare function groupSavedViews(records: readonly SavedViewRecord[]): Record<string, SavedViewRecord[]>;
+/**
+ * Make sure the system collection exists in the project's CMS schema so
+ * `documents.upsert` accepts view documents. Idempotent. Callers that share a
+ * project with the CMS session must run the session's persisted baseline
+ * FIRST — creating this collection on a schema-less project would otherwise
+ * make the baseline think the content schema is already persisted.
+ */
+export declare function ensureViewsCollection(_operations: OperationsClient, _projectId: string): Promise<OperationResult<void>>;
+/** Create or update a saved view (operations command). */
+export declare function saveSavedView(operations: OperationsClient, projectId: string, record: SavedViewRecord): Promise<OperationResult<void>>;
+/** Delete a saved view — a view-only operation on the system collection. */
+export declare function deleteSavedView(operations: OperationsClient, projectId: string, viewId: string): Promise<OperationResult<void>>;

package/dist/lib/cms-views/views-store.js

@@ -0,0 +1,129 @@
+import { z } from 'zod';
+import { tableViewStateSchema } from './view-model';
+/**
+ * Saved-view persistence for the CMS collection table (EC-169).
+ *
+ * Views are project-scoped (shared by every editor on the project) and follow
+ * the EC-170 routing-store pattern: one system collection holds one document
+ * per saved view, and every mutation goes through the *existing*
+ * `@elytracms/operations` commands (`schema.upsertCollection`,
+ * `documents.upsert`, `documents.delete`). The settings domain was the other
+ * candidate, but `settings.update` patches the closed `projectSettingsSchema`
+ * (locales/environments/export target) — saved views don't fit it without a
+ * studio-core schema change, while the system collection needs no new
+ * operations surface at all.
+ *
+ * Deleting a saved view is exactly one `documents.delete` against THIS
+ * collection — it can never touch content documents.
+ */
+export const VIEWS_COLLECTION = 'cms-saved-views';
+/** System collection holding one document per {@link SavedViewRecord}. */
+export const viewsCollectionDef = {
+    id: VIEWS_COLLECTION,
+    kind: 'document',
+    titleField: 'name',
+    form: {
+        label: 'Saved views',
+        labelSingular: 'Saved view',
+        description: 'System collection managed by the CMS collection table.',
+    },
+    fields: [
+        { name: 'name', type: 'text', validation: { required: true } },
+        { name: 'collection', type: 'text', validation: { required: true } },
+        /** The view's filter/sort/column state, JSON-serialized (validated by Zod on read). */
+        { name: 'config', type: 'text', validation: { required: true } },
+    ],
+};
+/** A persisted saved view: identity + the table state it restores. */
+export const savedViewRecordSchema = z.object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    /** The content collection the view belongs to. */
+    collection: z.string().min(1),
+    state: tableViewStateSchema,
+});
+// ---- Record ⇄ document mapping ----
+export function viewToDocument(record) {
+    const parsed = savedViewRecordSchema.parse(record);
+    return {
+        collection: VIEWS_COLLECTION,
+        id: parsed.id,
+        values: {
+            name: parsed.name,
+            collection: parsed.collection,
+            config: JSON.stringify(parsed.state),
+        },
+    };
+}
+export function documentToView(document) {
+    const values = document.values;
+    let state;
+    try {
+        state = typeof values.config === 'string' ? JSON.parse(values.config) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+    const parsed = savedViewRecordSchema.safeParse({
+        id: document.id,
+        name: values.name,
+        collection: values.collection,
+        state,
+    });
+    return parsed.success ? parsed.data : undefined;
+}
+// ---- Reads & writes through @elytracms/operations ----
+/** Load every persisted saved view of a project (malformed records dropped). */
+export async function loadSavedViews(operations, projectId) {
+    const result = await operations.documents.list({ projectId, collection: VIEWS_COLLECTION });
+    if (!result.ok)
+        return result;
+    return {
+        ok: true,
+        value: result.value
+            .map((record) => documentToView(record.document))
+            .filter((view) => view !== undefined),
+    };
+}
+/** Group loaded records by their content collection (for per-collection lookup). */
+export function groupSavedViews(records) {
+    const grouped = {};
+    for (const record of records) {
+        ;
+        (grouped[record.collection] ??= []).push(record);
+    }
+    return grouped;
+}
+/**
+ * Make sure the system collection exists in the project's CMS schema so
+ * `documents.upsert` accepts view documents. Idempotent. Callers that share a
+ * project with the CMS session must run the session's persisted baseline
+ * FIRST — creating this collection on a schema-less project would otherwise
+ * make the baseline think the content schema is already persisted.
+ */
+export async function ensureViewsCollection(_operations, _projectId) {
+    // No-op (EC-183, AD-11): the saved-views system collection is config-owned and
+    // the backend stores documents without a schema-membership check — nothing to
+    // register. `viewsCollectionDef` remains the canonical document shape.
+    return { ok: true, value: undefined };
+}
+/** Create or update a saved view (operations command). */
+export async function saveSavedView(operations, projectId, record) {
+    const ensured = await ensureViewsCollection(operations, projectId);
+    if (!ensured.ok)
+        return ensured;
+    const result = await operations.documents.upsert({
+        projectId,
+        document: viewToDocument(record),
+    });
+    return result.ok ? { ok: true, value: undefined } : result;
+}
+/** Delete a saved view — a view-only operation on the system collection. */
+export async function deleteSavedView(operations, projectId, viewId) {
+    const result = await operations.documents.delete({
+        projectId,
+        ref: { collection: VIEWS_COLLECTION, id: viewId },
+    });
+    return result.ok ? { ok: true, value: undefined } : result;
+}
+//# sourceMappingURL=views-store.js.map

package/dist/lib/cms-views/views-store.js.map

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

package/dist/lib/data/collection-content.d.ts

@@ -0,0 +1,105 @@
+import type { GetDocumentResult, ListDocumentsQuery, ListDocumentsResult, ResolvedDocument } from '@elytracms/content';
+import type { CmsDocument, CollectionDef, DocumentRef, Locale, LocaleConfig } from '@elytracms/cms-core';
+import type { AssetRecord } from '@elytracms/persistence';
+import type { ListingQuery } from '@elytracms/runtime-renderer';
+/**
+ * The studio's content delivery engine for canvas previews (EC-166).
+ *
+ * Repeating sections and template pages preview *delivery-shaped* documents —
+ * the exact shape `@elytracms/content` serves in production — so the canvas
+ * shows what publishing will show. This module wires the canonical content
+ * client (closed AD-3 query vocabulary, published perspective, EC-018 locale
+ * fallback, depth-1 population, resolved assets) over a **content session**:
+ *
+ * - Playground mode (and tests): the deterministic EC-145 sample fixtures —
+ *   byte-identical to the pre-hydration behavior, no backend.
+ * - Convex mode: the project-session gate (`components/studio/project-session`)
+ *   configures the session with the project's HYDRATED schema + documents, so
+ *   "Preview with" lists and section previews show the live content — never
+ *   fixture titles (EC-177 gap 1).
+ *
+ * Nothing here invents query semantics; both shapes go through the same
+ * canonical client.
+ */
+/** The schema + documents the preview engine serves (one project session). */
+export interface ContentSessionState {
+    collections: readonly CollectionDef[];
+    documents: readonly CmsDocument[];
+    /**
+     * Published document keys via the version POINTER (EC-224). When present, the
+     * preview's published perspective resolves by the pin — never the flat
+     * `state` enum — so it matches what delivery serves. Absent (playground
+     * fixtures / tests) → the rows' own `state` gates the perspective, unchanged.
+     */
+    publishedKeys?: readonly string[];
+    /** Locale config of the session content; defaults to the sample config. */
+    localeConfig?: LocaleConfig;
+    /**
+     * The project's asset records (assets table). Wired into the lookup so the
+     * content client resolves `asset`-typed FIELDS on listing/relation results
+     * (e.g. a ProductGrid product's `gallery`) to delivery shape — the same assets
+     * the renderer's `resolveAsset` reads for static props (EC-262). Absent
+     * (playground/tests) → assets come only from `asset`-collection fixture docs.
+     */
+    assets?: readonly AssetRecord[];
+}
+/**
+ * Default (no-session) collection schema: EMPTY. The studio ships no demo content
+ * (Oli, 2026-06-19) — with no backend/content session configured, there is nothing
+ * to preview, and the studio says so rather than serving fixtures. A real project's
+ * collections + documents arrive via {@link configureContentSession} (Convex mode).
+ */
+export declare const playgroundCollections: readonly CollectionDef[];
+/**
+ * Point the preview engine at a project's hydrated content (Convex mode), or
+ * back at the deterministic playground fixtures (`null` — the default, and
+ * the only state playground mode ever sees).
+ */
+export declare function configureContentSession(next: ContentSessionState | null): void;
+/** Whether a hydrated content session is configured (Convex mode). */
+export declare function hasContentSession(): boolean;
+/** Resolve a collection in the active content session (fixtures in playground). */
+export declare function playgroundCollection(id: string): CollectionDef | undefined;
+/**
+ * Overlay the active session's canonical `filterable` declarations onto a
+ * schema that doesn't carry any of its own. The inspector hands the Content
+ * tab fixture collection defs; the filter/sort pickers must offer exactly the
+ * EC-143 declaration set the delivery engine enforces, so both ends agree. A
+ * collection that declares its own filterable fields is left untouched.
+ */
+export declare function withPlaygroundFilterable(collections: readonly CollectionDef[]): readonly CollectionDef[];
+/**
+ * Run a closed-vocabulary list query (AD-3: eq/in/lt/lte/gt/gte, AND-only,
+ * filterable fields only) and return the delivery-shaped result. Invalid
+ * queries come back as structured errors — never thrown, never silently
+ * widened. Resolves in the studio's active locale unless one is passed.
+ */
+export declare function runCollectionListQuery(collectionId: string, query?: ListDocumentsQuery, locale?: Locale): ListDocumentsResult;
+/** Resolve one document (by id or slug) into delivery shape. */
+export declare function getCollectionDocument(collectionId: string, idOrSlug: string, locale?: Locale): GetDocumentResult;
+/**
+ * Populate a composition-node `relation` prop to delivery shape for the canvas
+ * (EC-254) — the studio analog of the host's baked relations map. Resolves the
+ * ref through the active session's client (published perspective, active locale),
+ * so the canvas previews a block's picked documents (a ProductGrid's products, a
+ * Reusable's element) exactly as delivery renders them. `null` when the target is
+ * missing or not visible → the block degrades to its own empty state.
+ */
+export declare function resolveCanvasRelation(ref: DocumentRef, locale?: Locale): ResolvedDocument | null;
+/**
+ * Resolve a listing block's query to its documents for the canvas (EC-255) — the
+ * studio analog of the host's baked listings map. Runs the query (collection +
+ * AND-only filter, optional sort/limit) through the active session's client
+ * (published perspective, active locale), so the canvas previews a dynamic grid (a
+ * ProductGrid keyed to a category) exactly as delivery renders it. An invalid query
+ * (structured, never thrown) or a non-list lookup yields `[]` → the block's empty
+ * state. Reuses the same `listDocuments` path as `runCollectionListQuery`.
+ */
+export declare function resolveCanvasListing(query: ListingQuery, locale?: Locale): ResolvedDocument[];
+/** A pickable entry of a collection (the template-page preview switcher). */
+export interface CollectionEntrySummary {
+    id: string;
+    label: string;
+}
+/** Published entries of a collection, labeled by the schema's title field. */
+export declare function listCollectionEntries(collectionId: string): CollectionEntrySummary[];

package/dist/lib/data/collection-content.js

@@ -0,0 +1,196 @@
+import { createContentClient, createContentContext, } from '@elytracms/content';
+import { documentKey, sampleLocaleConfig } from '@elytracms/cms-core';
+import { getStudioLocale } from '../locale/locale-store';
+/**
+ * Default (no-session) collection schema: EMPTY. The studio ships no demo content
+ * (Oli, 2026-06-19) — with no backend/content session configured, there is nothing
+ * to preview, and the studio says so rather than serving fixtures. A real project's
+ * collections + documents arrive via {@link configureContentSession} (Convex mode).
+ */
+export const playgroundCollections = [];
+let contentSession = null;
+let lookup = createLookup(playgroundCollections, [], []);
+const clients = new Map();
+/**
+ * Point the preview engine at a project's hydrated content (Convex mode), or
+ * back at the deterministic playground fixtures (`null` — the default, and
+ * the only state playground mode ever sees).
+ */
+export function configureContentSession(next) {
+    contentSession = next;
+    lookup = next
+        ? createLookup(next.collections, next.documents, next.publishedKeys, next.assets)
+        : createLookup(playgroundCollections, [], []);
+    clients.clear();
+}
+/** Whether a hydrated content session is configured (Convex mode). */
+export function hasContentSession() {
+    return contentSession !== null;
+}
+/** The collections the preview engine currently serves (session or fixtures). */
+function activeCollections() {
+    return contentSession?.collections ?? playgroundCollections;
+}
+function activeLocaleConfig() {
+    return contentSession?.localeConfig ?? sampleLocaleConfig;
+}
+/** Resolve a collection in the active content session (fixtures in playground). */
+export function playgroundCollection(id) {
+    return activeCollections().find((collection) => collection.id === id);
+}
+/**
+ * Overlay the active session's canonical `filterable` declarations onto a
+ * schema that doesn't carry any of its own. The inspector hands the Content
+ * tab fixture collection defs; the filter/sort pickers must offer exactly the
+ * EC-143 declaration set the delivery engine enforces, so both ends agree. A
+ * collection that declares its own filterable fields is left untouched.
+ */
+export function withPlaygroundFilterable(collections) {
+    return collections.map((collection) => {
+        if (collection.fields.some((field) => field.filterable === true))
+            return collection;
+        const counterpart = playgroundCollection(collection.id);
+        if (counterpart === undefined)
+            return collection;
+        const flagged = new Set(counterpart.fields.filter((field) => field.filterable === true).map((field) => field.name));
+        if (flagged.size === 0)
+            return collection;
+        return {
+            ...collection,
+            fields: collection.fields.map((field) => flagged.has(field.name) ? { ...field, filterable: true } : field),
+        };
+    });
+}
+/** Synthesize the persistence-shaped asset record the asset resolver reads. */
+function assetRecordOf(doc) {
+    const values = doc.values;
+    const alt = doc.localized?.en?.alt;
+    return {
+        id: doc.id,
+        projectId: 'playground',
+        filename: typeof values.filename === 'string' ? values.filename : doc.id,
+        contentType: 'image/png',
+        byteSize: 0,
+        alt: typeof alt === 'string' ? alt : undefined,
+        storageKey: typeof values.url === 'string' ? values.url : doc.id,
+        createdAt: '2026-01-01T00:00:00.000Z',
+        updatedAt: '2026-01-01T00:00:00.000Z',
+    };
+}
+function createLookup(collectionDefs, documents, publishedKeys, assetRecords) {
+    const collections = new Map(collectionDefs.map((c) => [c.id, c]));
+    // EC-224: published-ness is the version POINTER, not the flat `state` enum.
+    // A hydrated session hands `publishedKeys` (the pinned set) → wrap each row as
+    // a `DocumentHistory` so the published perspective resolves by the pin (the
+    // live row is always a draft now) with ZERO dependence on `state`. Without a
+    // pointer set (playground fixtures / tests) we keep bare rows, whose own
+    // `state` gates the published perspective — byte-identical to before.
+    const published = publishedKeys ? new Set(publishedKeys) : null;
+    const toSource = (doc) => {
+        if (!published)
+            return doc;
+        return published.has(documentKey({ collection: doc.collection, id: doc.id }))
+            ? { draft: doc, published: doc, versions: [] }
+            : { draft: doc, published: undefined, versions: [] };
+    };
+    const byKey = new Map(documents.map((doc) => [`${doc.collection}:${doc.id}`, toSource(doc)]));
+    // Asset resolution source for `asset`-typed FIELDS on resolved documents
+    // (listing/relation results, e.g. a product's `gallery`). Two sources, real
+    // records last so they win: (1) `asset`-collection fixture documents — how
+    // playground/tests model assets; (2) the project's real asset-table records
+    // (EC-262) — a Convex session has its assets here, NOT as `asset` documents,
+    // so without these the content client resolves no nested image.
+    const assets = new Map();
+    for (const doc of documents) {
+        if (doc.collection === 'asset')
+            assets.set(doc.id, assetRecordOf(doc));
+    }
+    for (const record of assetRecords ?? [])
+        assets.set(record.id, record);
+    return {
+        collection: (id) => collections.get(id),
+        document: (ref) => byKey.get(`${ref.collection}:${ref.id}`),
+        documents: (collectionId) => documents.filter((doc) => doc.collection === collectionId).map(toSource),
+        asset: (id) => assets.get(id),
+        // Prefer the record's resolved servable `url` — the one the renderer's
+        // resolveAsset reads (EC-262). Real asset-table records carry a Convex blob
+        // locator in `storageKey` and the servable URL in `url`; fixture/`asset`-document
+        // records (assetRecordOf) leave `url` unset and store the servable url in
+        // `storageKey`. Falling back keeps both correct.
+        assetUrl: (asset) => asset.url ?? asset.storageKey,
+    };
+}
+/**
+ * One deterministic client per locale: published perspective, EC-018 locale
+ * fallback. The studio's ambient active locale (EC-176, `lib/locale`) picks
+ * the client at query time, so the canvas previews follow the locale switcher
+ * exactly like delivery would. The cache resets whenever the content session changes.
+ */
+function clientFor(locale) {
+    const existing = clients.get(locale);
+    if (existing)
+        return existing;
+    const client = createContentClient({
+        lookup,
+        context: createContentContext({
+            locale,
+            perspective: 'published',
+            locales: activeLocaleConfig(),
+        }),
+    });
+    clients.set(locale, client);
+    return client;
+}
+/**
+ * Run a closed-vocabulary list query (AD-3: eq/in/lt/lte/gt/gte, AND-only,
+ * filterable fields only) and return the delivery-shaped result. Invalid
+ * queries come back as structured errors — never thrown, never silently
+ * widened. Resolves in the studio's active locale unless one is passed.
+ */
+export function runCollectionListQuery(collectionId, query = {}, locale = getStudioLocale()) {
+    return clientFor(locale).listDocuments(collectionId, query);
+}
+/** Resolve one document (by id or slug) into delivery shape. */
+export function getCollectionDocument(collectionId, idOrSlug, locale = getStudioLocale()) {
+    return clientFor(locale).getDocument(collectionId, idOrSlug);
+}
+/**
+ * Populate a composition-node `relation` prop to delivery shape for the canvas
+ * (EC-254) — the studio analog of the host's baked relations map. Resolves the
+ * ref through the active session's client (published perspective, active locale),
+ * so the canvas previews a block's picked documents (a ProductGrid's products, a
+ * Reusable's element) exactly as delivery renders them. `null` when the target is
+ * missing or not visible → the block degrades to its own empty state.
+ */
+export function resolveCanvasRelation(ref, locale = getStudioLocale()) {
+    return clientFor(locale).resolveRelation(ref);
+}
+/**
+ * Resolve a listing block's query to its documents for the canvas (EC-255) — the
+ * studio analog of the host's baked listings map. Runs the query (collection +
+ * AND-only filter, optional sort/limit) through the active session's client
+ * (published perspective, active locale), so the canvas previews a dynamic grid (a
+ * ProductGrid keyed to a category) exactly as delivery renders it. An invalid query
+ * (structured, never thrown) or a non-list lookup yields `[]` → the block's empty
+ * state. Reuses the same `listDocuments` path as `runCollectionListQuery`.
+ */
+export function resolveCanvasListing(query, locale = getStudioLocale()) {
+    const result = clientFor(locale).listDocuments(query.collection, {
+        where: query.where,
+        ...(query.sort ? { sort: query.sort } : {}),
+        ...(query.limit !== undefined ? { limit: query.limit } : {}),
+    });
+    return result.ok ? result.documents : [];
+}
+/** Published entries of a collection, labeled by the schema's title field. */
+export function listCollectionEntries(collectionId) {
+    const collection = playgroundCollection(collectionId);
+    const result = runCollectionListQuery(collectionId);
+    if (!result.ok)
+        return [];
+    return result.documents.map((doc) => {
+        const title = collection?.titleField ? doc[collection.titleField] : undefined;
+        return { id: doc.id, label: typeof title === 'string' && title.length > 0 ? title : doc.id };
+    });
+}
+//# sourceMappingURL=collection-content.js.map

package/dist/lib/data/collection-content.js.map

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

package/dist/lib/data/data-store.d.ts

@@ -0,0 +1,97 @@
+import type { ReactNode } from 'react';
+import { SourceRegistry } from '@elytracms/data-binding';
+import type { BindingResolution, ConditionResolution, DataSource, InferredSchema, PayloadStore, RepeaterItemContext } from '@elytracms/data-binding';
+import type { BindingReference, Condition, JsonValue } from '@elytracms/project-graph';
+/**
+ * The project's live data layer (brief §4.6, §7.5, EC-167). Holds the source
+ * registry the Builder's Content tab binds through, plus the captured payloads
+ * that drive binding resolution. One uniform model across CMS queries, data
+ * providers, and the built-in REST/Convex kinds — resolution, sampling,
+ * inference and tokenization treat them all identically.
+ *
+ * There is no source-authoring UI (EC-167): sources exist because code declared
+ * them (registered data providers), the schema implied them (per-collection CMS
+ * queries), or an editor flow provisioned them (repeating sections, template
+ * pages).
+ *
+ * Persistence: when mounted with a `projectId`, the store hydrates the
+ * project's persisted source records (the `cms-data-sources` system collection,
+ * see `sources-store.ts`) over the deterministic playground seeds — persisted
+ * wins by id, but never over a source provisioned/removed in THIS session —
+ * and every provision/remove writes through `@elytracms/operations`. Without a
+ * `projectId` (tests, fixtures) the store is pure session state, exactly as
+ * before.
+ */
+export interface DataStore {
+    sources: DataSource[];
+    registry: SourceRegistry;
+    payloads: PayloadStore;
+    knownSourceIds: ReadonlySet<string>;
+    getSource: (id: string) => DataSource | undefined;
+    removeSource: (id: string) => void;
+    /**
+     * Create or replace a source with a known id + config and capture its sample
+     * immediately (EC-166/EC-167): repeating sections and template pages
+     * provision their per-scope CMS query / provider sources through this.
+     */
+    provisionSource: (source: DataSource) => void;
+    /**
+     * The latest persistence failure in plain language, or `null`. Persistence
+     * is best-effort on top of the live session (the canvas keeps working on
+     * session state), but a failure is recorded here — visible, never silent.
+     */
+    persistError: string | null;
+    /** The stable path tokens a source exposes from its inferred schema (EC-085). */
+    tokensOf: (id: string) => string[];
+    schemaOf: (id: string) => InferredSchema | undefined;
+    sampleOf: (id: string) => JsonValue | undefined;
+    /** Resolve a binding to a renderer-ready resolution (value/props/condition/issue). */
+    resolve: (ref: BindingReference, item?: RepeaterItemContext) => BindingResolution;
+    /** Resolve a binding to the concrete value the renderer injects (EC-086–089). */
+    resolveValue: (ref: BindingReference, item?: RepeaterItemContext) => JsonValue | undefined;
+    /** Evaluate a condition against the captured payloads (EC-088). */
+    resolveCondition: (condition: Condition, item?: RepeaterItemContext) => ConditionResolution;
+}
+export interface DataState {
+    sources: DataSource[];
+    /**
+     * Ids provisioned or removed in THIS session. Hydration (which resolves
+     * asynchronously) never overrides them — the editor's latest action wins
+     * over whatever was persisted before it.
+     */
+    sessionIds: ReadonlySet<string>;
+}
+export type DataAction = {
+    type: 'remove';
+    id: string;
+} | {
+    type: 'provision';
+    source: DataSource;
+}
+/** Merge the project's persisted source records in (persisted wins over seeds). */
+ | {
+    type: 'hydrate';
+    sources: DataSource[];
+};
+/**
+ * The store's reducer, exported because hydration/session-precedence semantics
+ * live here and the app's test harness has no DOM to drive effects through.
+ */
+export declare function dataStateReducer(state: DataState, action: DataAction): DataState;
+/**
+ * The session's starting state: EMPTY. The studio seeds no sample sources (Oli,
+ * 2026-06-19) — real sources arrive from the project's config collections (the
+ * hydrate effect, Convex mode) or are added by the author. Nothing is faked.
+ */
+export declare function initialDataState(): DataState;
+export interface DataProviderProps {
+    children: ReactNode;
+    /**
+     * When set, the store hydrates from and persists to this project's
+     * `cms-data-sources` system collection (through `@elytracms/operations`).
+     * Without it the store is pure session state (tests, fixtures).
+     */
+    projectId?: string;
+}
+export declare function DataProvider({ children, projectId }: DataProviderProps): import("react").JSX.Element;
+export declare function useData(): DataStore;