@elytracms/studio 0.0.86 → 0.0.87

package/dist/lib/data/providers.js

@@ -1,255 +0,0 @@
-import { z } from 'zod';
-/**
- * Define a provider with the output type checked against the schema — the
- * provider-side mirror of `defineDataSourceAdapter` (EC-132) and component
- * `ComponentManifest` definitions.
- */
-export function defineDataProvider(provider) {
-    return provider;
-}
-const PROVIDER_ID_PATTERN = /^[a-z][a-z0-9-]*$/;
-/**
- * Registry of data providers keyed by id. First registration wins; duplicates
- * and malformed ids are recorded as structured issues (component-registry
- * semantics).
- */
-export class DataProviderRegistry {
-    byId = new Map();
-    issues = [];
-    constructor(providers = []) {
-        for (const provider of providers)
-            this.register(provider);
-    }
-    register(provider) {
-        const id = provider.manifest.id;
-        if (!PROVIDER_ID_PATTERN.test(id)) {
-            this.issues.push({
-                code: 'invalid-id',
-                ref: id,
-                message: `Provider id "${id}" must be lower-case and dash-separated (e.g. "pricing-plans").`,
-            });
-            return;
-        }
-        if (this.byId.has(id)) {
-            this.issues.push({
-                code: 'duplicate',
-                ref: id,
-                message: `Duplicate provider id "${id}" — keeping the first registration.`,
-            });
-            return;
-        }
-        this.byId.set(id, provider);
-    }
-    get(id) {
-        return this.byId.get(id);
-    }
-    list() {
-        return [...this.byId.values()];
-    }
-    get size() {
-        return this.byId.size;
-    }
-}
-/** Default args of a provider (its params' declared defaults). */
-export function defaultProviderArgs(manifest) {
-    return Object.fromEntries((manifest.params ?? []).map((p) => [p.name, p.defaultValue]));
-}
-/**
- * Run a provider and validate the result against its output schema. A thrown
- * error or a schema mismatch comes back as a plain-language issue — the
- * binding layer renders a visible fallback, never a crash.
- */
-export function runProvider(provider, args) {
-    const title = provider.manifest.title;
-    let raw;
-    try {
-        raw = provider.fetch(args ?? defaultProviderArgs(provider.manifest));
-    }
-    catch {
-        return {
-            ok: false,
-            message: `“${title}” couldn't load right now — the project code reported a problem. Anything showing it stays empty until it's fixed.`,
-        };
-    }
-    const parsed = provider.manifest.output.safeParse(raw);
-    if (!parsed.success) {
-        return {
-            ok: false,
-            message: `“${title}” returned data in an unexpected shape, so it can't be shown. The project code and its declared output no longer agree.`,
-        };
-    }
-    return { ok: true, value: parsed.data };
-}
-// ---------------------------------------------------------------------------
-// Bridging providers into the binding engine's source vocabulary
-// ---------------------------------------------------------------------------
-/** Shared project-wide provider sources: `provider.<providerId>`. */
-export const PROVIDER_SOURCE_PREFIX = 'provider.';
-/** The functionRef namespace marking a source as provider-backed. */
-const PROVIDER_FUNCTION_PREFIX = 'provider:';
-export function providerSourceIdFor(providerId) {
-    return `${PROVIDER_SOURCE_PREFIX}${providerId}`;
-}
-/** The provider a source is backed by, or undefined for non-provider sources. */
-export function providerIdOfSource(source) {
-    if (source === undefined || source.kind !== 'convex')
-        return undefined;
-    const ref = source.config.functionRef;
-    return ref.startsWith(PROVIDER_FUNCTION_PREFIX)
-        ? ref.slice(PROVIDER_FUNCTION_PREFIX.length)
-        : undefined;
-}
-/**
- * The engine-shaped source addressing a provider. `args` carry the editor's
- * param choices; `id` defaults to the shared project-wide source.
- */
-export function providerSourceFor(provider, args, id, label) {
-    return {
-        kind: 'convex',
-        id: id ?? providerSourceIdFor(provider.manifest.id),
-        label: label ?? provider.manifest.title,
-        config: {
-            operation: 'query',
-            functionRef: `${PROVIDER_FUNCTION_PREFIX}${provider.manifest.id}`,
-            args: args ?? defaultProviderArgs(provider.manifest),
-        },
-    };
-}
-// ---------------------------------------------------------------------------
-// The project's registered providers (project-owned, code-first)
-// ---------------------------------------------------------------------------
-const pricingPlanSchema = z.object({
-    id: z.string(),
-    name: z.string(),
-    monthlyPrice: z.number(),
-    summary: z.string(),
-    featured: z.boolean(),
-});
-/** Example provider: a static, code-owned pricing table (think Stripe prices). */
-export const pricingPlansProvider = defineDataProvider({
-    manifest: {
-        id: 'pricing-plans',
-        title: 'Pricing plans',
-        description: 'The pricing tiers exactly as the billing code defines them.',
-        output: z.array(pricingPlanSchema),
-    },
-    fetch: () => [
-        {
-            id: 'starter',
-            name: 'Starter',
-            monthlyPrice: 19,
-            summary: 'For solo builders shipping their first site.',
-            featured: false,
-        },
-        {
-            id: 'studio',
-            name: 'Studio',
-            monthlyPrice: 49,
-            summary: 'For teams that publish every week.',
-            featured: true,
-        },
-        {
-            id: 'enterprise',
-            name: 'Enterprise',
-            monthlyPrice: 199,
-            summary: 'For organizations with compliance needs.',
-            featured: false,
-        },
-    ],
-});
-const jobListingSchema = z.object({
-    id: z.string(),
-    title: z.string(),
-    department: z.string(),
-    location: z.string(),
-    remote: z.boolean(),
-});
-const JOB_LISTINGS = [
-    {
-        id: 'job-fe',
-        title: 'Frontend Engineer',
-        department: 'Engineering',
-        location: 'Berlin',
-        remote: true,
-    },
-    {
-        id: 'job-be',
-        title: 'Backend Engineer',
-        department: 'Engineering',
-        location: 'Amsterdam',
-        remote: true,
-    },
-    {
-        id: 'job-pd',
-        title: 'Product Designer',
-        department: 'Design',
-        location: 'Berlin',
-        remote: false,
-    },
-    {
-        id: 'job-cm',
-        title: 'Content Marketer',
-        department: 'Marketing',
-        location: 'Remote',
-        remote: true,
-    },
-];
-/** Example provider with a param: job listings filterable by department. */
-export const jobListingsProvider = defineDataProvider({
-    manifest: {
-        id: 'job-listings',
-        title: 'Job listings',
-        description: 'Open roles from the hiring system, optionally narrowed to one department.',
-        output: z.array(jobListingSchema),
-        params: [
-            {
-                name: 'department',
-                label: 'Department',
-                kind: 'choice',
-                choices: [
-                    { value: 'all', label: 'All departments' },
-                    { value: 'Engineering', label: 'Engineering' },
-                    { value: 'Design', label: 'Design' },
-                    { value: 'Marketing', label: 'Marketing' },
-                ],
-                defaultValue: 'all',
-            },
-        ],
-    },
-    fetch: ({ department }) => typeof department === 'string' && department !== 'all'
-        ? JOB_LISTINGS.filter((job) => job.department === department)
-        : [...JOB_LISTINGS],
-});
-/**
- * The project's provider registry. In a deployed studio this hydrates from
- * synced provider manifests (the component-manifest sync path); in the
- * playground the project code registers directly.
- */
-export const projectDataProviders = new DataProviderRegistry([
-    pricingPlansProvider,
-    jobListingsProvider,
-]);
-export function listDataProviders() {
-    return projectDataProviders.list();
-}
-export function getDataProvider(id) {
-    return projectDataProviders.get(id);
-}
-/**
- * The payload a provider-backed source serves, or `null` when the provider is
- * unregistered or failing — a `null` sample makes every binding against it a
- * visible plain-language issue instead of a crash.
- */
-export function providerPayload(providerId, args) {
-    const provider = getDataProvider(providerId);
-    if (provider === undefined)
-        return null;
-    const run = runProvider(provider, args);
-    return run.ok ? run.value : null;
-}
-/** A provider's canonical sample (its default-args run), or undefined when failing. */
-export function providerSample(provider) {
-    const run = runProvider(provider);
-    return run.ok ? run.value : undefined;
-}
-//# sourceMappingURL=providers.js.map

package/dist/lib/data/providers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../../src/lib/data/providers.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod'\nimport type { ConvexSource, DataSource } from '@elytracms/core/data-binding'\nimport type { JsonValue } from '@elytracms/core/project-graph'\n\n/**\n * Typed data providers (EC-167, vision AD-9). External data is a developer\n * concern expressed exactly like a component: a provider is a plain function\n * plus a manifest (id, title, description, output schema, optional params)\n * registered in code. Editors never see providers as anything technical — the\n * Content tab offers them next to CMS collections, labeled by their\n * plain-language titles, and provider results resolve through the unchanged\n * `@elytracms/core/data-binding` engine.\n *\n * Registration mirrors how component manifests register: project code defines\n * providers and registers them in-process here. In a host repository the same\n * definitions would be extracted into synced manifests (the EC-147 component\n * manifest sync path) with the function itself executed behind the\n * project-owned adapter — an honest gap today: this playground registry IS the\n * project code, so \"sync\" is a direct import.\n *\n * Bridging into the engine: a provider is addressed as a `convex`-kind data\n * source whose `functionRef` is `provider:<id>` — a provider is exactly a\n * typed server function, and the engine's source vocabulary already models\n * that. Resolution, sampling, inference, tokens, and broken-binding issues all\n * apply unchanged. (See NOTES: the engine could gain a first-class `provider`\n * source kind as a purely additive change.)\n */\n\n/** A scalar an editor can put into a provider param control. */\nexport type ProviderParamValue = string | number | boolean\n\n/** One choice of a `choice`-kind param. */\nexport interface ProviderParamChoice {\n  value: string\n  label: string\n}\n\n/**\n * A provider param, surfaced to editors as one plain control (no syntax, no\n * JSON): `choice` renders a select over {@link choices}; the scalar kinds\n * render a matching input.\n */\nexport interface ProviderParamSpec {\n  name: string\n  /** Plain-language control label, e.g. \"Department\". */\n  label: string\n  kind: 'text' | 'number' | 'boolean' | 'choice'\n  /** For `choice` params: the closed set of offered values. */\n  choices?: ProviderParamChoice[]\n  defaultValue: ProviderParamValue\n}\n\n/** Arguments a provider runs with (param name → value). */\nexport type ProviderArgs = Record<string, JsonValue>\n\n/** The manifest half of a provider — everything the builder surfaces. */\nexport interface DataProviderManifest {\n  /** Stable provider id, e.g. `pricing-plans`. */\n  id: string\n  /** Plain-language title editors pick, e.g. \"Pricing plans\". */\n  title: string\n  description: string\n  /** Zod schema of the payload; every run is validated against it. */\n  output: z.ZodType<JsonValue>\n  params?: ProviderParamSpec[]\n}\n\n/** A data provider: a typed function plus its manifest. */\nexport interface DataProvider {\n  manifest: DataProviderManifest\n  /** Produce the payload. Deterministic here; a host repo may make this async behind its adapter. */\n  fetch: (args: ProviderArgs) => JsonValue\n}\n\n/**\n * Define a provider with the output type checked against the schema — the\n * provider-side mirror of `defineDataSourceAdapter` (EC-132) and component\n * `ComponentManifest` definitions.\n */\nexport function defineDataProvider<T extends JsonValue>(provider: {\n  manifest: Omit<DataProviderManifest, 'output'> & { output: z.ZodType<T> }\n  fetch: (args: ProviderArgs) => T\n}): DataProvider {\n  return provider as DataProvider\n}\n\n// ---------------------------------------------------------------------------\n// Registration (mirrors the component-registry contract)\n// ---------------------------------------------------------------------------\n\n/** A structured registration issue — duplicates are reported, never thrown. */\nexport interface ProviderRegistrationIssue {\n  code: 'duplicate' | 'invalid-id'\n  message: string\n  ref: string\n}\n\nconst PROVIDER_ID_PATTERN = /^[a-z][a-z0-9-]*$/\n\n/**\n * Registry of data providers keyed by id. First registration wins; duplicates\n * and malformed ids are recorded as structured issues (component-registry\n * semantics).\n */\nexport class DataProviderRegistry {\n  private readonly byId = new Map<string, DataProvider>()\n  readonly issues: ProviderRegistrationIssue[] = []\n\n  constructor(providers: Iterable<DataProvider> = []) {\n    for (const provider of providers) this.register(provider)\n  }\n\n  register(provider: DataProvider): void {\n    const id = provider.manifest.id\n    if (!PROVIDER_ID_PATTERN.test(id)) {\n      this.issues.push({\n        code: 'invalid-id',\n        ref: id,\n        message: `Provider id \"${id}\" must be lower-case and dash-separated (e.g. \"pricing-plans\").`,\n      })\n      return\n    }\n    if (this.byId.has(id)) {\n      this.issues.push({\n        code: 'duplicate',\n        ref: id,\n        message: `Duplicate provider id \"${id}\" — keeping the first registration.`,\n      })\n      return\n    }\n    this.byId.set(id, provider)\n  }\n\n  get(id: string): DataProvider | undefined {\n    return this.byId.get(id)\n  }\n\n  list(): DataProvider[] {\n    return [...this.byId.values()]\n  }\n\n  get size(): number {\n    return this.byId.size\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Running a provider (never throws, never crashes a surface)\n// ---------------------------------------------------------------------------\n\n/** The outcome of one provider run: a validated payload or a plain-language issue. */\nexport type ProviderRun =\n  | { ok: true; value: JsonValue }\n  | { ok: false; message: string }\n\n/** Default args of a provider (its params' declared defaults). */\nexport function defaultProviderArgs(manifest: DataProviderManifest): ProviderArgs {\n  return Object.fromEntries((manifest.params ?? []).map((p) => [p.name, p.defaultValue]))\n}\n\n/**\n * Run a provider and validate the result against its output schema. A thrown\n * error or a schema mismatch comes back as a plain-language issue — the\n * binding layer renders a visible fallback, never a crash.\n */\nexport function runProvider(provider: DataProvider, args?: ProviderArgs): ProviderRun {\n  const title = provider.manifest.title\n  let raw: JsonValue\n  try {\n    raw = provider.fetch(args ?? defaultProviderArgs(provider.manifest))\n  } catch {\n    return {\n      ok: false,\n      message: `“${title}” couldn't load right now — the project code reported a problem. Anything showing it stays empty until it's fixed.`,\n    }\n  }\n  const parsed = provider.manifest.output.safeParse(raw)\n  if (!parsed.success) {\n    return {\n      ok: false,\n      message: `“${title}” returned data in an unexpected shape, so it can't be shown. The project code and its declared output no longer agree.`,\n    }\n  }\n  return { ok: true, value: parsed.data }\n}\n\n// ---------------------------------------------------------------------------\n// Bridging providers into the binding engine's source vocabulary\n// ---------------------------------------------------------------------------\n\n/** Shared project-wide provider sources: `provider.<providerId>`. */\nexport const PROVIDER_SOURCE_PREFIX = 'provider.'\n\n/** The functionRef namespace marking a source as provider-backed. */\nconst PROVIDER_FUNCTION_PREFIX = 'provider:'\n\nexport function providerSourceIdFor(providerId: string): string {\n  return `${PROVIDER_SOURCE_PREFIX}${providerId}`\n}\n\n/** The provider a source is backed by, or undefined for non-provider sources. */\nexport function providerIdOfSource(source: DataSource | undefined): string | undefined {\n  if (source === undefined || source.kind !== 'convex') return undefined\n  const ref = source.config.functionRef\n  return ref.startsWith(PROVIDER_FUNCTION_PREFIX)\n    ? ref.slice(PROVIDER_FUNCTION_PREFIX.length)\n    : undefined\n}\n\n/**\n * The engine-shaped source addressing a provider. `args` carry the editor's\n * param choices; `id` defaults to the shared project-wide source.\n */\nexport function providerSourceFor(\n  provider: DataProvider,\n  args?: ProviderArgs,\n  id?: string,\n  label?: string,\n): ConvexSource {\n  return {\n    kind: 'convex',\n    id: id ?? providerSourceIdFor(provider.manifest.id),\n    label: label ?? provider.manifest.title,\n    config: {\n      operation: 'query',\n      functionRef: `${PROVIDER_FUNCTION_PREFIX}${provider.manifest.id}`,\n      args: args ?? defaultProviderArgs(provider.manifest),\n    },\n  }\n}\n\n// ---------------------------------------------------------------------------\n// The project's registered providers (project-owned, code-first)\n// ---------------------------------------------------------------------------\n\nconst pricingPlanSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  monthlyPrice: z.number(),\n  summary: z.string(),\n  featured: z.boolean(),\n})\n\n/** Example provider: a static, code-owned pricing table (think Stripe prices). */\nexport const pricingPlansProvider = defineDataProvider({\n  manifest: {\n    id: 'pricing-plans',\n    title: 'Pricing plans',\n    description: 'The pricing tiers exactly as the billing code defines them.',\n    output: z.array(pricingPlanSchema),\n  },\n  fetch: () => [\n    {\n      id: 'starter',\n      name: 'Starter',\n      monthlyPrice: 19,\n      summary: 'For solo builders shipping their first site.',\n      featured: false,\n    },\n    {\n      id: 'studio',\n      name: 'Studio',\n      monthlyPrice: 49,\n      summary: 'For teams that publish every week.',\n      featured: true,\n    },\n    {\n      id: 'enterprise',\n      name: 'Enterprise',\n      monthlyPrice: 199,\n      summary: 'For organizations with compliance needs.',\n      featured: false,\n    },\n  ],\n})\n\nconst jobListingSchema = z.object({\n  id: z.string(),\n  title: z.string(),\n  department: z.string(),\n  location: z.string(),\n  remote: z.boolean(),\n})\n\nconst JOB_LISTINGS = [\n  {\n    id: 'job-fe',\n    title: 'Frontend Engineer',\n    department: 'Engineering',\n    location: 'Berlin',\n    remote: true,\n  },\n  {\n    id: 'job-be',\n    title: 'Backend Engineer',\n    department: 'Engineering',\n    location: 'Amsterdam',\n    remote: true,\n  },\n  {\n    id: 'job-pd',\n    title: 'Product Designer',\n    department: 'Design',\n    location: 'Berlin',\n    remote: false,\n  },\n  {\n    id: 'job-cm',\n    title: 'Content Marketer',\n    department: 'Marketing',\n    location: 'Remote',\n    remote: true,\n  },\n] as const\n\n/** Example provider with a param: job listings filterable by department. */\nexport const jobListingsProvider = defineDataProvider({\n  manifest: {\n    id: 'job-listings',\n    title: 'Job listings',\n    description: 'Open roles from the hiring system, optionally narrowed to one department.',\n    output: z.array(jobListingSchema),\n    params: [\n      {\n        name: 'department',\n        label: 'Department',\n        kind: 'choice',\n        choices: [\n          { value: 'all', label: 'All departments' },\n          { value: 'Engineering', label: 'Engineering' },\n          { value: 'Design', label: 'Design' },\n          { value: 'Marketing', label: 'Marketing' },\n        ],\n        defaultValue: 'all',\n      },\n    ],\n  },\n  fetch: ({ department }) =>\n    typeof department === 'string' && department !== 'all'\n      ? JOB_LISTINGS.filter((job) => job.department === department)\n      : [...JOB_LISTINGS],\n})\n\n/**\n * The project's provider registry. In a deployed studio this hydrates from\n * synced provider manifests (the component-manifest sync path); in the\n * playground the project code registers directly.\n */\nexport const projectDataProviders = new DataProviderRegistry([\n  pricingPlansProvider,\n  jobListingsProvider,\n])\n\nexport function listDataProviders(): DataProvider[] {\n  return projectDataProviders.list()\n}\n\nexport function getDataProvider(id: string): DataProvider | undefined {\n  return projectDataProviders.get(id)\n}\n\n/**\n * The payload a provider-backed source serves, or `null` when the provider is\n * unregistered or failing — a `null` sample makes every binding against it a\n * visible plain-language issue instead of a crash.\n */\nexport function providerPayload(providerId: string, args?: ProviderArgs): JsonValue {\n  const provider = getDataProvider(providerId)\n  if (provider === undefined) return null\n  const run = runProvider(provider, args)\n  return run.ok ? run.value : null\n}\n\n/** A provider's canonical sample (its default-args run), or undefined when failing. */\nexport function providerSample(provider: DataProvider): JsonValue | undefined {\n  const run = runProvider(provider)\n  return run.ok ? run.value : undefined\n}\n"]}

package/dist/lib/data/sample-capture.d.ts

@@ -1,30 +0,0 @@
-import type { DataSource } from '@elytracms/core/data-binding';
-import type { JsonValue } from '@elytracms/core/project-graph';
-import type { CollectionDef } from '@elytracms/core/cms-core';
-/**
- * Data-source sample capture (EC-083/EC-166/EC-167). The hosted builder is
- * separate from the site it exports: actually performing a REST fetch / external
- * query happens behind the project-owned adapters in the deployed site, NOT here.
- * So the studio captures a sample ONLY when it can do so honestly — it never
- * fabricates data (Oli, 2026-06-19; cf. backend-mode's "never silently swap in
- * in-memory storage", and the v1 "static props, bindings parked" direction):
- *
- * - a provider-backed source runs its registered provider (real project code);
- * - a CMS source replays its stored query over the live content session (Convex
- *   mode — EC-177 gap 1), so section/template previews show what delivery serves;
- * - anything else — an external source with no in-studio data path — returns
- *   `undefined`. The source then carries no sample, and the binding UI shows an
- *   honest "no sample yet" state instead of inventing rows that aren't there.
- */
-export declare function captureSourceSample(source: DataSource): JsonValue | undefined;
-/**
- * A live CMS data source for one config-driven collection (EC-192). The binding
- * and condition pickers enumerate `data.sources`; deriving one source per
- * configured content collection — the same set the CMS uses
- * (`resolveDeploymentCollections`) — means what an editor can bind matches what
- * actually exists. The sample is captured by replaying the collection's list
- * query through the canonical content engine, so when a content session is
- * configured (Convex mode) the inferred field tokens are the collection's real
- * fields; with no session the source is listed but carries no sample.
- */
-export declare function cmsSourceForCollection(collection: CollectionDef): DataSource;

package/dist/lib/data/sample-capture.js

@@ -1,70 +0,0 @@
-import { captureSample } from '@elytracms/core/data-binding';
-import { humanizeName } from '../utils.js';
-import { listQueryOfConfig } from '../bindings/section-bindings.js';
-import { getCollectionDocument, hasContentSession, playgroundCollection, runCollectionListQuery, } from './collection-content.js';
-import { providerIdOfSource, providerPayload } from './providers.js';
-/**
- * Data-source sample capture (EC-083/EC-166/EC-167). The hosted builder is
- * separate from the site it exports: actually performing a REST fetch / external
- * query happens behind the project-owned adapters in the deployed site, NOT here.
- * So the studio captures a sample ONLY when it can do so honestly — it never
- * fabricates data (Oli, 2026-06-19; cf. backend-mode's "never silently swap in
- * in-memory storage", and the v1 "static props, bindings parked" direction):
- *
- * - a provider-backed source runs its registered provider (real project code);
- * - a CMS source replays its stored query over the live content session (Convex
- *   mode — EC-177 gap 1), so section/template previews show what delivery serves;
- * - anything else — an external source with no in-studio data path — returns
- *   `undefined`. The source then carries no sample, and the binding UI shows an
- *   honest "no sample yet" state instead of inventing rows that aren't there.
- */
-export function captureSourceSample(source) {
-    const providerId = providerIdOfSource(source);
-    if (providerId !== undefined) {
-        return providerPayload(providerId, source.kind === 'convex' ? source.config.args : undefined);
-    }
-    if (source.kind === 'cms') {
-        return cmsDeliverySample(source.config);
-    }
-    return undefined;
-}
-/**
- * A live CMS data source for one config-driven collection (EC-192). The binding
- * and condition pickers enumerate `data.sources`; deriving one source per
- * configured content collection — the same set the CMS uses
- * (`resolveDeploymentCollections`) — means what an editor can bind matches what
- * actually exists. The sample is captured by replaying the collection's list
- * query through the canonical content engine, so when a content session is
- * configured (Convex mode) the inferred field tokens are the collection's real
- * fields; with no session the source is listed but carries no sample.
- */
-export function cmsSourceForCollection(collection) {
-    const source = {
-        kind: 'cms',
-        id: `cms.${collection.id}`,
-        label: humanizeName(collection.id),
-        config: { collectionId: collection.id, filter: {}, limit: 20 },
-    };
-    const sample = captureSourceSample(source);
-    return sample !== undefined ? captureSample(source, sample) : source;
-}
-/**
- * Replay a CMS source's stored query over the configured content session, in
- * delivery shape (EC-166). Returns `undefined` when no session serves the
- * collection (playground / no backend) — the caller then leaves the source
- * sample-less rather than fabricating one. A query the engine rejects — or one
- * matching nothing — yields an empty list / `null`, never a crash.
- */
-function cmsDeliverySample(config) {
-    if (!hasContentSession())
-        return undefined;
-    if (playgroundCollection(config.collectionId) === undefined)
-        return undefined;
-    if (config.documentId !== undefined) {
-        const result = getCollectionDocument(config.collectionId, config.documentId);
-        return result.document ?? null;
-    }
-    const result = runCollectionListQuery(config.collectionId, listQueryOfConfig(config));
-    return result.ok ? result.documents : [];
-}
-//# sourceMappingURL=sample-capture.js.map

package/dist/lib/data/sample-capture.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sample-capture.js","sourceRoot":"","sources":["../../../src/lib/data/sample-capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAI5D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAEhE,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAEjE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB;IACpD,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;IAC7C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC/F,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,iBAAiB,CAAC,MAAM,CAAC,MAAwB,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAyB;IAC9D,MAAM,MAAM,GAAe;QACzB,IAAI,EAAE,KAAK;QACX,EAAE,EAAE,OAAO,UAAU,CAAC,EAAE,EAAE;QAC1B,KAAK,EAAE,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,MAAM,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;KAC/D,CAAA;IACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;AACtE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,MAAsB;IAC/C,IAAI,CAAC,iBAAiB,EAAE;QAAE,OAAO,SAAS,CAAA;IAC1C,IAAI,oBAAoB,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC7E,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;QAC5E,OAAQ,MAAM,CAAC,QAAiC,IAAI,IAAI,CAAA;IAC1D,CAAC;IACD,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAA;IACrF,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAE,MAAM,CAAC,SAAkC,CAAC,CAAC,CAAC,EAAE,CAAA;AACpE,CAAC","sourcesContent":["import { captureSample } from '@elytracms/core/data-binding'\nimport type { DataSource } from '@elytracms/core/data-binding'\nimport type { JsonValue } from '@elytracms/core/project-graph'\nimport type { CollectionDef } from '@elytracms/core/cms-core'\nimport { humanizeName } from '../utils'\nimport { listQueryOfConfig } from '../bindings/section-bindings'\nimport type { QueryCmsConfig } from '../bindings/section-bindings'\nimport {\n  getCollectionDocument,\n  hasContentSession,\n  playgroundCollection,\n  runCollectionListQuery,\n} from './collection-content'\nimport { providerIdOfSource, providerPayload } from './providers'\n\n/**\n * Data-source sample capture (EC-083/EC-166/EC-167). The hosted builder is\n * separate from the site it exports: actually performing a REST fetch / external\n * query happens behind the project-owned adapters in the deployed site, NOT here.\n * So the studio captures a sample ONLY when it can do so honestly — it never\n * fabricates data (Oli, 2026-06-19; cf. backend-mode's \"never silently swap in\n * in-memory storage\", and the v1 \"static props, bindings parked\" direction):\n *\n * - a provider-backed source runs its registered provider (real project code);\n * - a CMS source replays its stored query over the live content session (Convex\n *   mode — EC-177 gap 1), so section/template previews show what delivery serves;\n * - anything else — an external source with no in-studio data path — returns\n *   `undefined`. The source then carries no sample, and the binding UI shows an\n *   honest \"no sample yet\" state instead of inventing rows that aren't there.\n */\nexport function captureSourceSample(source: DataSource): JsonValue | undefined {\n  const providerId = providerIdOfSource(source)\n  if (providerId !== undefined) {\n    return providerPayload(providerId, source.kind === 'convex' ? source.config.args : undefined)\n  }\n  if (source.kind === 'cms') {\n    return cmsDeliverySample(source.config as QueryCmsConfig)\n  }\n  return undefined\n}\n\n/**\n * A live CMS data source for one config-driven collection (EC-192). The binding\n * and condition pickers enumerate `data.sources`; deriving one source per\n * configured content collection — the same set the CMS uses\n * (`resolveDeploymentCollections`) — means what an editor can bind matches what\n * actually exists. The sample is captured by replaying the collection's list\n * query through the canonical content engine, so when a content session is\n * configured (Convex mode) the inferred field tokens are the collection's real\n * fields; with no session the source is listed but carries no sample.\n */\nexport function cmsSourceForCollection(collection: CollectionDef): DataSource {\n  const source: DataSource = {\n    kind: 'cms',\n    id: `cms.${collection.id}`,\n    label: humanizeName(collection.id),\n    config: { collectionId: collection.id, filter: {}, limit: 20 },\n  }\n  const sample = captureSourceSample(source)\n  return sample !== undefined ? captureSample(source, sample) : source\n}\n\n/**\n * Replay a CMS source's stored query over the configured content session, in\n * delivery shape (EC-166). Returns `undefined` when no session serves the\n * collection (playground / no backend) — the caller then leaves the source\n * sample-less rather than fabricating one. A query the engine rejects — or one\n * matching nothing — yields an empty list / `null`, never a crash.\n */\nfunction cmsDeliverySample(config: QueryCmsConfig): JsonValue | undefined {\n  if (!hasContentSession()) return undefined\n  if (playgroundCollection(config.collectionId) === undefined) return undefined\n  if (config.documentId !== undefined) {\n    const result = getCollectionDocument(config.collectionId, config.documentId)\n    return (result.document as unknown as JsonValue) ?? null\n  }\n  const result = runCollectionListQuery(config.collectionId, listQueryOfConfig(config))\n  return result.ok ? (result.documents as unknown as JsonValue) : []\n}\n"]}

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

@@ -1,42 +0,0 @@
-import type { DataSource } from '@elytracms/core/data-binding';
-import type { CmsDocument, CollectionDef } from '@elytracms/core/cms-core';
-import type { OperationResult, OperationsClient } from '../operations/index.js';
-/**
- * Data-source persistence for the Builder's data layer (LIVE-mode gap fix).
- *
- * EC-166/EC-167 made the builder provision per-section (`cms.section.<nodeId>`)
- * and per-template (`cms.template.<pageId>`) CMS sources, but only as session
- * state — the live delivery chain (`convex/delivery.ts` →
- * `apps/example-site/lib/live-content.ts`) had nothing to carry. Following the
- * EC-170 routing-store / EC-169 views-store pattern, sources persist as
- * documents in ONE system collection, one document per source, and every
- * mutation goes through the *existing* `@elytracms/core/operations` commands
- * (`schema.upsertCollection`, `documents.upsert`, `documents.delete`) — no new
- * operations surface, no direct repository access.
- *
- * The record round-trips the FULL canonical `DataSource` shape (including the
- * captured `sample` + inferred `schema` envelope and the cms config's `sort`):
- * `@elytracms/core/data-binding`'s `dataSourceSchema` is the source of truth, applied
- * on both write and read, so a malformed stored record is dropped on load —
- * never a crash, never a half-parsed source.
- */
-export declare const DATA_SOURCES_COLLECTION = "cms-data-sources";
-/** System collection holding one document per persisted {@link DataSource}. */
-export declare const dataSourcesCollectionDef: CollectionDef;
-export declare function sourceToDocument(source: DataSource): CmsDocument;
-export declare function documentToSource(document: CmsDocument): DataSource | undefined;
-/** Load every persisted data source of a project (malformed records dropped). */
-export declare function loadDataSources(operations: OperationsClient, projectId: string): Promise<OperationResult<DataSource[]>>;
-/**
- * Make sure the system collection exists in the project's CMS schema so
- * `documents.upsert` accepts source documents. Idempotent.
- */
-export declare function ensureDataSourcesCollection(_operations: OperationsClient, _projectId: string): Promise<OperationResult<void>>;
-/** Create or update a persisted data source (operations command). */
-export declare function saveDataSource(operations: OperationsClient, projectId: string, source: DataSource): Promise<OperationResult<void>>;
-/**
- * Delete a persisted data source. A source that was never persisted (pure
- * session state, e.g. a seed) deletes as a no-op — `not-found` is success
- * here, since the goal state ("no persisted record") already holds.
- */
-export declare function deleteDataSource(operations: OperationsClient, projectId: string, sourceId: string): Promise<OperationResult<void>>;

package/dist/lib/data/sources-store.js

@@ -1,120 +0,0 @@
-import { dataSourceSchema } from '@elytracms/core/data-binding';
-/**
- * Data-source persistence for the Builder's data layer (LIVE-mode gap fix).
- *
- * EC-166/EC-167 made the builder provision per-section (`cms.section.<nodeId>`)
- * and per-template (`cms.template.<pageId>`) CMS sources, but only as session
- * state — the live delivery chain (`convex/delivery.ts` →
- * `apps/example-site/lib/live-content.ts`) had nothing to carry. Following the
- * EC-170 routing-store / EC-169 views-store pattern, sources persist as
- * documents in ONE system collection, one document per source, and every
- * mutation goes through the *existing* `@elytracms/core/operations` commands
- * (`schema.upsertCollection`, `documents.upsert`, `documents.delete`) — no new
- * operations surface, no direct repository access.
- *
- * The record round-trips the FULL canonical `DataSource` shape (including the
- * captured `sample` + inferred `schema` envelope and the cms config's `sort`):
- * `@elytracms/core/data-binding`'s `dataSourceSchema` is the source of truth, applied
- * on both write and read, so a malformed stored record is dropped on load —
- * never a crash, never a half-parsed source.
- */
-export const DATA_SOURCES_COLLECTION = 'cms-data-sources';
-/** System collection holding one document per persisted {@link DataSource}. */
-export const dataSourcesCollectionDef = {
-    id: DATA_SOURCES_COLLECTION,
-    kind: 'document',
-    titleField: 'label',
-    form: {
-        label: 'Data sources',
-        labelSingular: 'Data source',
-        description: "System collection managed by the Builder's data layer.",
-    },
-    fields: [
-        { name: 'label', type: 'text', validation: { required: true } },
-        /** The source kind (`rest` | `cms` | `convex`), denormalized for table views. */
-        { name: 'kind', type: 'text', validation: { required: true } },
-        /** The FULL canonical DataSource, JSON-serialized (validated by Zod on read). */
-        { name: 'config', type: 'text', validation: { required: true } },
-    ],
-};
-// ---- Source ⇄ document mapping ----
-export function sourceToDocument(source) {
-    const parsed = dataSourceSchema.parse(source);
-    return {
-        collection: DATA_SOURCES_COLLECTION,
-        id: parsed.id,
-        values: {
-            label: parsed.label,
-            kind: parsed.kind,
-            config: JSON.stringify(parsed),
-        },
-    };
-}
-export function documentToSource(document) {
-    const raw = document.values.config;
-    let value;
-    try {
-        value = typeof raw === 'string' ? JSON.parse(raw) : undefined;
-    }
-    catch {
-        return undefined;
-    }
-    const parsed = dataSourceSchema.safeParse(value);
-    if (!parsed.success)
-        return undefined;
-    // The document id is the source id — a record whose payload disagrees with
-    // its own key is malformed and never loads.
-    return parsed.data.id === document.id ? parsed.data : undefined;
-}
-// ---- Reads & writes through @elytracms/operations ----
-/** Load every persisted data source of a project (malformed records dropped). */
-export async function loadDataSources(operations, projectId) {
-    const result = await operations.documents.list({
-        projectId,
-        collection: DATA_SOURCES_COLLECTION,
-    });
-    if (!result.ok)
-        return result;
-    return {
-        ok: true,
-        value: result.value
-            .map((record) => documentToSource(record.document))
-            .filter((source) => source !== undefined),
-    };
-}
-/**
- * Make sure the system collection exists in the project's CMS schema so
- * `documents.upsert` accepts source documents. Idempotent.
- */
-export async function ensureDataSourcesCollection(_operations, _projectId) {
-    // No-op (EC-183, AD-11): the data-sources system collection is config-owned and
-    // the backend stores documents without a schema-membership check — nothing to
-    // register. `dataSourcesCollectionDef` remains the canonical document shape.
-    return { ok: true, value: undefined };
-}
-/** Create or update a persisted data source (operations command). */
-export async function saveDataSource(operations, projectId, source) {
-    const ensured = await ensureDataSourcesCollection(operations, projectId);
-    if (!ensured.ok)
-        return ensured;
-    const result = await operations.documents.upsert({
-        projectId,
-        document: sourceToDocument(source),
-    });
-    return result.ok ? { ok: true, value: undefined } : result;
-}
-/**
- * Delete a persisted data source. A source that was never persisted (pure
- * session state, e.g. a seed) deletes as a no-op — `not-found` is success
- * here, since the goal state ("no persisted record") already holds.
- */
-export async function deleteDataSource(operations, projectId, sourceId) {
-    const result = await operations.documents.delete({
-        projectId,
-        ref: { collection: DATA_SOURCES_COLLECTION, id: sourceId },
-    });
-    if (!result.ok && result.error.code === 'not-found')
-        return { ok: true, value: undefined };
-    return result.ok ? { ok: true, value: undefined } : result;
-}
-//# sourceMappingURL=sources-store.js.map

package/dist/lib/data/sources-store.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sources-store.js","sourceRoot":"","sources":["../../../src/lib/data/sources-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { dataSourceSchema } from '@elytracms/core/data-binding'\nimport type { DataSource } from '@elytracms/core/data-binding'\nimport type { CmsDocument, CollectionDef } from '@elytracms/core/cms-core'\nimport type { OperationResult, OperationsClient } from '../operations'\n\n/**\n * Data-source persistence for the Builder's data layer (LIVE-mode gap fix).\n *\n * EC-166/EC-167 made the builder provision per-section (`cms.section.<nodeId>`)\n * and per-template (`cms.template.<pageId>`) CMS sources, but only as session\n * state — the live delivery chain (`convex/delivery.ts` →\n * `apps/example-site/lib/live-content.ts`) had nothing to carry. Following the\n * EC-170 routing-store / EC-169 views-store pattern, sources persist as\n * documents in ONE system collection, one document per source, and every\n * mutation goes through the *existing* `@elytracms/core/operations` commands\n * (`schema.upsertCollection`, `documents.upsert`, `documents.delete`) — no new\n * operations surface, no direct repository access.\n *\n * The record round-trips the FULL canonical `DataSource` shape (including the\n * captured `sample` + inferred `schema` envelope and the cms config's `sort`):\n * `@elytracms/core/data-binding`'s `dataSourceSchema` is the source of truth, applied\n * on both write and read, so a malformed stored record is dropped on load —\n * never a crash, never a half-parsed source.\n */\n\nexport const DATA_SOURCES_COLLECTION = 'cms-data-sources'\n\n/** System collection holding one document per persisted {@link DataSource}. */\nexport const dataSourcesCollectionDef: CollectionDef = {\n  id: DATA_SOURCES_COLLECTION,\n  kind: 'document',\n  titleField: 'label',\n  form: {\n    label: 'Data sources',\n    labelSingular: 'Data source',\n    description: \"System collection managed by the Builder's data layer.\",\n  },\n  fields: [\n    { name: 'label', type: 'text', validation: { required: true } },\n    /** The source kind (`rest` | `cms` | `convex`), denormalized for table views. */\n    { name: 'kind', type: 'text', validation: { required: true } },\n    /** The FULL canonical DataSource, JSON-serialized (validated by Zod on read). */\n    { name: 'config', type: 'text', validation: { required: true } },\n  ],\n}\n\n// ---- Source ⇄ document mapping ----\n\nexport function sourceToDocument(source: DataSource): CmsDocument {\n  const parsed = dataSourceSchema.parse(source)\n  return {\n    collection: DATA_SOURCES_COLLECTION,\n    id: parsed.id,\n    values: {\n      label: parsed.label,\n      kind: parsed.kind,\n      config: JSON.stringify(parsed),\n    },\n  }\n}\n\nexport function documentToSource(document: CmsDocument): DataSource | undefined {\n  const raw = document.values.config\n  let value: unknown\n  try {\n    value = typeof raw === 'string' ? JSON.parse(raw) : undefined\n  } catch {\n    return undefined\n  }\n  const parsed = dataSourceSchema.safeParse(value)\n  if (!parsed.success) return undefined\n  // The document id is the source id — a record whose payload disagrees with\n  // its own key is malformed and never loads.\n  return parsed.data.id === document.id ? parsed.data : undefined\n}\n\n// ---- Reads & writes through @elytracms/operations ----\n\n/** Load every persisted data source of a project (malformed records dropped). */\nexport async function loadDataSources(\n  operations: OperationsClient,\n  projectId: string,\n): Promise<OperationResult<DataSource[]>> {\n  const result = await operations.documents.list({\n    projectId,\n    collection: DATA_SOURCES_COLLECTION,\n  })\n  if (!result.ok) return result\n  return {\n    ok: true,\n    value: result.value\n      .map((record) => documentToSource(record.document))\n      .filter((source): source is DataSource => source !== undefined),\n  }\n}\n\n/**\n * Make sure the system collection exists in the project's CMS schema so\n * `documents.upsert` accepts source documents. Idempotent.\n */\nexport async function ensureDataSourcesCollection(\n  _operations: OperationsClient,\n  _projectId: string,\n): Promise<OperationResult<void>> {\n  // No-op (EC-183, AD-11): the data-sources system collection is config-owned and\n  // the backend stores documents without a schema-membership check — nothing to\n  // register. `dataSourcesCollectionDef` remains the canonical document shape.\n  return { ok: true, value: undefined }\n}\n\n/** Create or update a persisted data source (operations command). */\nexport async function saveDataSource(\n  operations: OperationsClient,\n  projectId: string,\n  source: DataSource,\n): Promise<OperationResult<void>> {\n  const ensured = await ensureDataSourcesCollection(operations, projectId)\n  if (!ensured.ok) return ensured\n  const result = await operations.documents.upsert({\n    projectId,\n    document: sourceToDocument(source),\n  })\n  return result.ok ? { ok: true, value: undefined } : result\n}\n\n/**\n * Delete a persisted data source. A source that was never persisted (pure\n * session state, e.g. a seed) deletes as a no-op — `not-found` is success\n * here, since the goal state (\"no persisted record\") already holds.\n */\nexport async function deleteDataSource(\n  operations: OperationsClient,\n  projectId: string,\n  sourceId: string,\n): Promise<OperationResult<void>> {\n  const result = await operations.documents.delete({\n    projectId,\n    ref: { collection: DATA_SOURCES_COLLECTION, id: sourceId },\n  })\n  if (!result.ok && result.error.code === 'not-found') return { ok: true, value: undefined }\n  return result.ok ? { ok: true, value: undefined } : result\n}\n"]}

package/dist/lib/locale/binding-fallback.d.ts

@@ -1,35 +0,0 @@
-import type { Locale } from '@elytracms/core/cms-core';
-import type { BindingReference } from '@elytracms/core/project-graph';
-import type { DataSource } from '@elytracms/core/data-binding';
-import type { DisplayedFallback } from './fallback.js';
-/**
- * Fallback visibility for BOUND content (EC-176): given a stored content
- * binding and its CMS source, decide whether the value the canvas currently
- * previews for the active locale is served via EC-018 locale fallback. Used
- * by the inspector's Content tab — the surface that explains what a bound
- * field shows (the canvas overlay itself is out of this wave's reach; see
- * EC-176 notes).
- *
- * Deterministic over the playground delivery engine: the same
- * `@elytracms/core/content` resolution that produced the previewed value reports
- * which fields fell back (`ResolutionInfo.localeFallbacks`), so the label can
- * never disagree with the displayed value.
- */
-/** A previewed bound value that fell back, plus which field it came from. */
-export interface BoundValueFallback extends DisplayedFallback {
-    field: string;
-}
-/**
- * Whether the bound field's previewed value (first entry for list/repeater
- * bindings, the bound document otherwise) is a locale fallback in `locale`.
- * `null` when the binding is not CMS-shaped, points at no field, or the value
- * is a real translation.
- */
-export declare function cmsBindingFallback(binding: BindingReference, source: DataSource | undefined, 
-/**
- * The locale to judge fallback in. Optional (EC-479): the ambient studio locale
- * is `null` until a project's locale config is installed, and the content engine
- * then resolves in the session's own default — so a caller that has no locale
- * omits it rather than substituting one.
- */
-locale?: Locale): BoundValueFallback | null;