@elytracms/studio 0.0.88 → 0.0.91

package/dist/lib/references/references-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"references-store.js","sourceRoot":"","sources":["../../../src/lib/references/references-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react'\nimport { documentKey } from '@elytracms/core/cms-core'\nimport { useOperationQuery } from '@elytracms/studio/lib/query'\nimport type { CmsDocument, DocumentRef } from '@elytracms/core/cms-core'\nimport type {\n  ReferenceEntryRecord,\n  ReferenceSource,\n  ReferenceTarget,\n} from '@elytracms/core/persistence'\nimport { localizedLabel } from '../i18n'\nimport { getStudioOperations } from '../operations'\nimport type { OperationEvent, OperationsClient, StudioOperations } from '../operations'\nimport { getStudioRegistry } from '../registry'\nimport { buildReferenceEntryViews } from './reference-model'\nimport type { ReferenceEntryView, ReferenceLabelContext } from './reference-model'\n\n/**\n * Data layer for the EC-172 references panels. All reads go through\n * `@elytracms/core/operations` queries (`references.outbound` / `references.inbound`\n * plus the labeling queries) — UI code never touches persistence repositories\n * or index tables. The hook keeps panels live: any succeeded command in a\n * content-bearing domain re-queries after the EC-155 maintained-on-write\n * attachment has flushed.\n */\n\nexport interface ReferencePanelQuery {\n  projectId: string\n  /** Enables the outbound (\"references\") section. */\n  source?: ReferenceSource | undefined\n  /** Enables the inbound (\"used by\") section. */\n  target?: ReferenceTarget | undefined\n}\n\nexport interface ReferencePanelData {\n  outbound: ReferenceEntryView[]\n  inbound: ReferenceEntryView[]\n  /**\n   * Per-direction read error (EC-205): a direction whose query returns a\n   * structured non-ok degrades to an empty list plus this message, surfaced as a\n   * visible per-section error — instead of collapsing the whole panel into its\n   * hard-error state. `null` when the direction loaded (or was not requested).\n   */\n  outboundError: string | null\n  inboundError: string | null\n}\n\n// --- Index bootstrap -----------------------------------------------------------\n\n/**\n * The EC-155 index is maintained on write, but seeded/imported projects start\n * with an empty index. {@link ensureReferenceIndex} seeds it once per project per\n * operations client; failures (e.g. a viewer's command denial) degrade to\n * whatever the maintained-on-write index already holds.\n */\nconst backfillsByClient = new WeakMap<StudioOperations, Map<string, Promise<void>>>()\n\n/**\n * Seed the index once if it has never been backfilled, then never again — the\n * EC-269 mutation-free read path. The index is maintained on write, so the\n * (clear + rebuild) `backfill` is only needed to seed a never-built index. A\n * persisted marker (`references.buildMarker`, a read) records completion; when\n * present this returns after a single query with ZERO mutations — so opening the\n * References panel no longer rewrites the whole index every session (the normal\n * Convex case: the EC-233 import already backfilled). Only a genuinely empty/\n * never-built project still pays the one-time backfill (and a viewer who cannot\n * run it degrades to the maintained-on-write index, as before).\n */\nasync function seedReferenceIndex(studio: StudioOperations, projectId: string): Promise<void> {\n  try {\n    const marker = await studio.operations.references.buildMarker({ projectId })\n    if (marker.ok && marker.value !== null) return\n  } catch {\n    // A marker-read failure falls through to the backfill (best-effort seed).\n  }\n  await studio.operations.references.backfill({ projectId }).then(\n    () => undefined,\n    () => undefined,\n  )\n}\n\nexport function ensureReferenceIndex(studio: StudioOperations, projectId: string): Promise<void> {\n  let byProject = backfillsByClient.get(studio)\n  if (!byProject) {\n    byProject = new Map()\n    backfillsByClient.set(studio, byProject)\n  }\n  let pending = byProject.get(projectId)\n  if (!pending) {\n    pending = seedReferenceIndex(studio, projectId)\n    byProject.set(projectId, pending)\n  }\n  return pending\n}\n\n// --- Label context loading -------------------------------------------------------\n\nasync function loadLabelContext(\n  operations: OperationsClient,\n  projectId: string,\n): Promise<ReferenceLabelContext> {\n  const [schemaResult, documentsResult, assetsResult] = await Promise.all([\n    operations.schema.get({ projectId }),\n    operations.documents.list({ projectId }),\n    operations.assets.list({ projectId }),\n  ])\n\n  const collections = schemaResult.ok ? schemaResult.value.collections : []\n  const documents = new Map<string, CmsDocument>()\n  if (documentsResult.ok) {\n    for (const record of documentsResult.value) {\n      documents.set(\n        documentKey({ collection: record.document.collection, id: record.document.id }),\n        record.document,\n      )\n    }\n  }\n  // EC-287: the project graph is retired; reference source labels resolve from\n  // CMS documents only. `page`/`layout` graph sources no longer exist.\n  const assets = new Map<string, { filename: string; title?: string | undefined }>()\n  if (assetsResult.ok) {\n    for (const asset of assetsResult.value) {\n      assets.set(asset.id, { filename: asset.filename, title: asset.title })\n    }\n  }\n  const registry = getStudioRegistry().registry\n  return {\n    collections,\n    documents,\n    assets,\n    // EC-407: `title` is a LocalizedString — resolve it to the active UI locale\n    // (a plain string is unchanged), never leak a `{ en, de }` object to the label.\n    componentTitle: (componentId) => {\n      const title = registry.getManifest(componentId)?.title\n      return title === undefined ? undefined : localizedLabel(title) || undefined\n    },\n  }\n}\n\n// --- Panel data loading -----------------------------------------------------------\n\n/** Load both directions + labels for one panel (operations queries only). */\nexport async function loadReferencePanelData(\n  query: ReferencePanelQuery,\n): Promise<ReferencePanelData> {\n  const studio = await getStudioOperations()\n  await ensureReferenceIndex(studio, query.projectId)\n  // Observe a settled index: maintained-on-write updates run async after events.\n  await studio.references.flush()\n  const operations = studio.operations\n\n  // EC-205: load each direction INDEPENDENTLY. A structured non-ok from one\n  // direction is a degradable operation result (it carries an OperationError —\n  // the documented contract), not an exception: degrade that direction to empty\n  // and surface its error per-section (references-panel) while the other still\n  // renders, instead of throwing the whole panel into its hard-error state. A\n  // genuinely broken backend still throws from getStudioOperations/flush above.\n  const [outbound, inbound] = await Promise.all([\n    query.source\n      ? operations.references.outbound({ projectId: query.projectId, source: query.source })\n      : null,\n    query.target\n      ? operations.references.inbound({ projectId: query.projectId, target: query.target })\n      : null,\n  ])\n\n  type DirectionResult = Awaited<ReturnType<typeof operations.references.outbound>>\n  const settle = (\n    result: DirectionResult | null,\n  ): { records: ReferenceEntryRecord[]; error: string | null } =>\n    result === null\n      ? { records: [], error: null }\n      : result.ok\n        ? { records: result.value, error: null }\n        : { records: [], error: result.error.message }\n  const out = settle(outbound)\n  const inb = settle(inbound)\n\n  // EC-302: nothing referenced in either direction → no sources/targets to label,\n  // so skip the label-context load entirely (schema + ALL documents + ALL assets).\n  // Common for leaf content; mirrors the asset short-circuit in\n  // `loadInboundAssetReferenceViews`.\n  if (out.records.length === 0 && inb.records.length === 0) {\n    return { outbound: [], inbound: [], outboundError: out.error, inboundError: inb.error }\n  }\n\n  const context = await loadLabelContext(operations, query.projectId)\n  return {\n    outbound: buildReferenceEntryViews(out.records, context),\n    inbound: buildReferenceEntryViews(inb.records, context),\n    outboundError: out.error,\n    inboundError: inb.error,\n  }\n}\n\n// --- Impact loading (EC-173 safe unpublish/delete) -------------------------------\n\n/**\n * Load the labelled inbound entry views for a set of target documents in ONE\n * pass (one index flush, one label-context load) — the pre-flight data of the\n * EC-173 confirmation dialogs, including the bulk flows. Returns entries in\n * `targets` order; pair with `buildReferenceImpact` for break/block semantics.\n *\n * `toTarget` maps each acted-on ref to its reference-index target shape\n * (EC-433): the default is the document shape every `cmsDocuments` collection\n * indexes under; a rail whose records live under a different target type (the\n * assets rail, `{ type: 'asset' }`) supplies its own via\n * `CollectionViewSource.referenceTarget` — otherwise its pre-flight would\n * query the wrong shape and report referenced records as \"not referenced\".\n */\nexport async function loadInboundReferenceViews(\n  projectId: string,\n  targets: readonly DocumentRef[],\n  toTarget: (ref: DocumentRef) => ReferenceTarget = (ref) => ({\n    type: 'document',\n    id: documentKey(ref),\n  }),\n): Promise<{ ref: DocumentRef; inbound: ReferenceEntryView[] }[]> {\n  const studio = await getStudioOperations()\n  await ensureReferenceIndex(studio, projectId)\n  // Observe a settled index: maintained-on-write updates run async after events.\n  await studio.references.flush()\n  const operations = studio.operations\n\n  // EC-308: one batched query for ALL targets (the operation loops the by_target\n  // index server-side) instead of a per-target `inbound` fan-out. Returns one\n  // record list per target, in `targets` order.\n  const recordsPerTarget = await operations.references\n    .inboundMany({\n      projectId,\n      targets: targets.map((ref) => toTarget(ref)),\n    })\n    .then((result) => {\n      if (!result.ok) throw new Error(result.error.message)\n      return result.value\n    })\n  // EC-302: no inbound refs for ANY target → no sources to label, so skip the\n  // label-context load (schema + ALL documents + ALL assets). The common case when\n  // deleting/unpublishing unreferenced documents (incl. bulk); mirrors the EC-301\n  // short-circuit already in `loadInboundAssetReferenceViews`.\n  if (recordsPerTarget.every((records) => records.length === 0)) {\n    return targets.map((ref) => ({ ref, inbound: [] }))\n  }\n  const context = await loadLabelContext(operations, projectId)\n  return targets.map((ref, index) => ({\n    ref,\n    inbound: buildReferenceEntryViews(recordsPerTarget[index] ?? [], context),\n  }))\n}\n\n/**\n * Inbound reference views for ONE asset (EC-202): the \"what uses this asset\"\n * pre-flight of the asset-delete dialog, index-accurate (the EC-155 reference\n * index, not the retired `find-asset-usages` string scan). Mirrors\n * {@link loadInboundReferenceViews} for a single `{ type: 'asset' }` target —\n * the source labels resolve the referencing documents/graph-nodes identically.\n */\nexport async function loadInboundAssetReferenceViews(\n  projectId: string,\n  assetId: string,\n): Promise<ReferenceEntryView[]> {\n  const studio = await getStudioOperations()\n  await ensureReferenceIndex(studio, projectId)\n  // Observe a settled index: maintained-on-write updates run async after events.\n  await studio.references.flush()\n  const operations = studio.operations\n  const result = await operations.references.inbound({\n    projectId,\n    target: { type: 'asset', id: assetId },\n  })\n  if (!result.ok) throw new Error(result.error.message)\n  // No inbound references → no sources to label, so skip the label-context load\n  // entirely (schema + ALL documents + ALL assets). This is the common case for a\n  // deletable asset, making the delete dialog's pre-flight a single indexed query\n  // instead of three full-table lists (EC-301 perf).\n  if (result.value.length === 0) return []\n  const context = await loadLabelContext(operations, projectId)\n  return buildReferenceEntryViews(result.value, context)\n}\n\n// --- React hook ----------------------------------------------------------------\n\n/**\n * Domains whose successful commands can change the reference index or labels and\n * should refresh an open panel. `references` is deliberately ABSENT (EC-269):\n * reacting to reference-index command events (the `backfill`) would make the\n * panel re-trigger on its OWN index maintenance — a self-cascade that, compounded\n * with the per-keystroke `documents` events, produced hundreds of redundant\n * reloads per document. The index is maintained on write; the panel reacts to the\n * CONTENT domains that feed it, never to its own index writes.\n */\nconst REFERENCE_REFRESH_TRIGGERS = [\n  'documents',\n  'graph',\n  'publishing',\n  'assets',\n  'schema',\n] as const\n\nconst REFRESH_DOMAINS: ReadonlySet<string> = new Set(REFERENCE_REFRESH_TRIGGERS)\n\n/**\n * Whether one operation event should refresh an open reference panel. Exported\n * for tests — pins the EC-269 contract that reference-index commands (and any\n * non-succeeded / non-command event) never trigger a reload.\n */\nexport function isReferenceRefreshEvent(event: OperationEvent): boolean {\n  return (\n    event.kind === 'command' && event.status === 'succeeded' && REFRESH_DOMAINS.has(event.domain)\n  )\n}\n\nexport type ReferencePanelStatus = 'loading' | 'ready' | 'error'\n\nexport interface ReferencePanelState {\n  status: ReferencePanelStatus\n  data: ReferencePanelData | null\n  errorMessage: string | null\n  refresh: () => void\n}\n\n/**\n * Live panel state for one entity (EC-308/AD-17): loads + caches through the one\n * `useOperationQuery` seam, and re-queries whenever a content-bearing command\n * succeeds anywhere in the studio (the index is maintained on write). Per-direction\n * read errors degrade INSIDE `loadReferencePanelData` (carried on the data); a hard\n * failure (broken backend) surfaces as the query's error → `status: 'error'`.\n */\nexport function useReferencePanel(query: ReferencePanelQuery): ReferencePanelState {\n  const { projectId } = query\n  const sourceType = query.source?.type\n  const sourceId = query.source?.id\n  const targetType = query.target?.type\n  const targetId = query.target?.id\n\n  const stableQuery = useMemo<ReferencePanelQuery>(\n    () => ({\n      projectId,\n      ...(sourceType && sourceId ? { source: { type: sourceType, id: sourceId } } : {}),\n      ...(targetType && targetId ? { target: { type: targetType, id: targetId } } : {}),\n    }),\n    [projectId, sourceType, sourceId, targetType, targetId],\n  )\n\n  const result = useOperationQuery<ReferencePanelData>({\n    queryKey: [\n      'referencePanel',\n      projectId,\n      sourceType ?? '',\n      sourceId ?? '',\n      targetType ?? '',\n      targetId ?? '',\n    ],\n    loader: () => loadReferencePanelData(stableQuery),\n    invalidateOn: REFERENCE_REFRESH_TRIGGERS,\n  })\n\n  const status: ReferencePanelStatus = result.isPending\n    ? 'loading'\n    : result.isError\n      ? 'error'\n      : 'ready'\n  return {\n    status,\n    data: result.data ?? null,\n    errorMessage: result.error instanceof Error ? result.error.message : null,\n    refresh: () => void result.refetch(),\n  }\n}\n"]}
+{"version":3,"file":"references-store.js","sourceRoot":"","sources":["../../../src/lib/references/references-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react'\nimport { documentKey } from '@elytracms/core/cms-core'\nimport { useOperationQuery } from '@elytracms/studio/lib/query'\nimport type { CmsDocument, DocumentRef } from '@elytracms/core/cms-core'\nimport type {\n  ReferenceEntryRecord,\n  ReferenceSource,\n  ReferenceTarget,\n} from '@elytracms/core/persistence'\nimport { localizedLabel } from '../i18n'\nimport { getStudioLocaleConfig } from '../locale/locale-store'\nimport { resolveDeploymentLocaleConfig } from '../workspace'\nimport { getStudioOperations } from '../operations'\nimport type { OperationEvent, OperationsClient, StudioOperations } from '../operations'\nimport { getStudioRegistry } from '../registry'\nimport { buildReferenceEntryViews } from './reference-model'\nimport type { ReferenceEntryView, ReferenceLabelContext } from './reference-model'\n\n/**\n * Data layer for the EC-172 references panels. All reads go through\n * `@elytracms/core/operations` queries (`references.outbound` / `references.inbound`\n * plus the labeling queries) — UI code never touches persistence repositories\n * or index tables. The hook keeps panels live: any succeeded command in a\n * content-bearing domain re-queries after the EC-155 maintained-on-write\n * attachment has flushed.\n */\n\nexport interface ReferencePanelQuery {\n  projectId: string\n  /** Enables the outbound (\"references\") section. */\n  source?: ReferenceSource | undefined\n  /** Enables the inbound (\"used by\") section. */\n  target?: ReferenceTarget | undefined\n}\n\nexport interface ReferencePanelData {\n  outbound: ReferenceEntryView[]\n  inbound: ReferenceEntryView[]\n  /**\n   * Per-direction read error (EC-205): a direction whose query returns a\n   * structured non-ok degrades to an empty list plus this message, surfaced as a\n   * visible per-section error — instead of collapsing the whole panel into its\n   * hard-error state. `null` when the direction loaded (or was not requested).\n   */\n  outboundError: string | null\n  inboundError: string | null\n}\n\n// --- Index bootstrap -----------------------------------------------------------\n\n/**\n * The EC-155 index is maintained on write, but seeded/imported projects start\n * with an empty index. {@link ensureReferenceIndex} seeds it once per project per\n * operations client; failures (e.g. a viewer's command denial) degrade to\n * whatever the maintained-on-write index already holds.\n */\nconst backfillsByClient = new WeakMap<StudioOperations, Map<string, Promise<void>>>()\n\n/**\n * Seed the index once if it has never been backfilled, then never again — the\n * EC-269 mutation-free read path. The index is maintained on write, so the\n * (clear + rebuild) `backfill` is only needed to seed a never-built index. A\n * persisted marker (`references.buildMarker`, a read) records completion; when\n * present this returns after a single query with ZERO mutations — so opening the\n * References panel no longer rewrites the whole index every session (the normal\n * Convex case: the EC-233 import already backfilled). Only a genuinely empty/\n * never-built project still pays the one-time backfill (and a viewer who cannot\n * run it degrades to the maintained-on-write index, as before).\n */\nasync function seedReferenceIndex(studio: StudioOperations, projectId: string): Promise<void> {\n  try {\n    const marker = await studio.operations.references.buildMarker({ projectId })\n    if (marker.ok && marker.value !== null) return\n  } catch {\n    // A marker-read failure falls through to the backfill (best-effort seed).\n  }\n  await studio.operations.references.backfill({ projectId }).then(\n    () => undefined,\n    () => undefined,\n  )\n}\n\nexport function ensureReferenceIndex(studio: StudioOperations, projectId: string): Promise<void> {\n  let byProject = backfillsByClient.get(studio)\n  if (!byProject) {\n    byProject = new Map()\n    backfillsByClient.set(studio, byProject)\n  }\n  let pending = byProject.get(projectId)\n  if (!pending) {\n    pending = seedReferenceIndex(studio, projectId)\n    byProject.set(projectId, pending)\n  }\n  return pending\n}\n\n// --- Label context loading -------------------------------------------------------\n\nasync function loadLabelContext(\n  operations: OperationsClient,\n  projectId: string,\n): Promise<ReferenceLabelContext> {\n  const [schemaResult, documentsResult, assetsResult] = await Promise.all([\n    operations.schema.get({ projectId }),\n    operations.documents.list({ projectId }),\n    operations.assets.list({ projectId }),\n  ])\n\n  const collections = schemaResult.ok ? schemaResult.value.collections : []\n  const documents = new Map<string, CmsDocument>()\n  if (documentsResult.ok) {\n    for (const record of documentsResult.value) {\n      documents.set(\n        documentKey({ collection: record.document.collection, id: record.document.id }),\n        record.document,\n      )\n    }\n  }\n  // EC-287: the project graph is retired; reference source labels resolve from\n  // CMS documents only. `page`/`layout` graph sources no longer exist.\n  const assets = new Map<string, { filename: string; title?: string | undefined }>()\n  if (assetsResult.ok) {\n    for (const asset of assetsResult.value) {\n      assets.set(asset.id, { filename: asset.filename, title: asset.title })\n    }\n  }\n  const registry = getStudioRegistry().registry\n  return {\n    collections,\n    documents,\n    assets,\n    // EC-580: titles read the default-locale view of the project's ONE locale\n    // config — the one the CMS session installed (`configureStudioLocales`), else\n    // (a rail opened before any CMS session, e.g. Assets) the active config\n    // project's, which is where the session's value comes from in the first place.\n    locales: getStudioLocaleConfig() ?? resolveDeploymentLocaleConfig() ?? null,\n    // EC-407: `title` is a LocalizedString — resolve it to the active UI locale\n    // (a plain string is unchanged), never leak a `{ en, de }` object to the label.\n    componentTitle: (componentId) => {\n      const title = registry.getManifest(componentId)?.title\n      return title === undefined ? undefined : localizedLabel(title) || undefined\n    },\n  }\n}\n\n// --- Panel data loading -----------------------------------------------------------\n\n/** Load both directions + labels for one panel (operations queries only). */\nexport async function loadReferencePanelData(\n  query: ReferencePanelQuery,\n): Promise<ReferencePanelData> {\n  const studio = await getStudioOperations()\n  await ensureReferenceIndex(studio, query.projectId)\n  // Observe a settled index: maintained-on-write updates run async after events.\n  await studio.references.flush()\n  const operations = studio.operations\n\n  // EC-205: load each direction INDEPENDENTLY. A structured non-ok from one\n  // direction is a degradable operation result (it carries an OperationError —\n  // the documented contract), not an exception: degrade that direction to empty\n  // and surface its error per-section (references-panel) while the other still\n  // renders, instead of throwing the whole panel into its hard-error state. A\n  // genuinely broken backend still throws from getStudioOperations/flush above.\n  const [outbound, inbound] = await Promise.all([\n    query.source\n      ? operations.references.outbound({ projectId: query.projectId, source: query.source })\n      : null,\n    query.target\n      ? operations.references.inbound({ projectId: query.projectId, target: query.target })\n      : null,\n  ])\n\n  type DirectionResult = Awaited<ReturnType<typeof operations.references.outbound>>\n  const settle = (\n    result: DirectionResult | null,\n  ): { records: ReferenceEntryRecord[]; error: string | null } =>\n    result === null\n      ? { records: [], error: null }\n      : result.ok\n        ? { records: result.value, error: null }\n        : { records: [], error: result.error.message }\n  const out = settle(outbound)\n  const inb = settle(inbound)\n\n  // EC-302: nothing referenced in either direction → no sources/targets to label,\n  // so skip the label-context load entirely (schema + ALL documents + ALL assets).\n  // Common for leaf content; mirrors the asset short-circuit in\n  // `loadInboundAssetReferenceViews`.\n  if (out.records.length === 0 && inb.records.length === 0) {\n    return { outbound: [], inbound: [], outboundError: out.error, inboundError: inb.error }\n  }\n\n  const context = await loadLabelContext(operations, query.projectId)\n  return {\n    outbound: buildReferenceEntryViews(out.records, context),\n    inbound: buildReferenceEntryViews(inb.records, context),\n    outboundError: out.error,\n    inboundError: inb.error,\n  }\n}\n\n// --- Impact loading (EC-173 safe unpublish/delete) -------------------------------\n\n/**\n * Load the labelled inbound entry views for a set of target documents in ONE\n * pass (one index flush, one label-context load) — the pre-flight data of the\n * EC-173 confirmation dialogs, including the bulk flows. Returns entries in\n * `targets` order; pair with `buildReferenceImpact` for break/block semantics.\n *\n * `toTarget` maps each acted-on ref to its reference-index target shape\n * (EC-433): the default is the document shape every `cmsDocuments` collection\n * indexes under; a rail whose records live under a different target type (the\n * assets rail, `{ type: 'asset' }`) supplies its own via\n * `CollectionViewSource.referenceTarget` — otherwise its pre-flight would\n * query the wrong shape and report referenced records as \"not referenced\".\n */\nexport async function loadInboundReferenceViews(\n  projectId: string,\n  targets: readonly DocumentRef[],\n  toTarget: (ref: DocumentRef) => ReferenceTarget = (ref) => ({\n    type: 'document',\n    id: documentKey(ref),\n  }),\n): Promise<{ ref: DocumentRef; inbound: ReferenceEntryView[] }[]> {\n  const studio = await getStudioOperations()\n  await ensureReferenceIndex(studio, projectId)\n  // Observe a settled index: maintained-on-write updates run async after events.\n  await studio.references.flush()\n  const operations = studio.operations\n\n  // EC-308: one batched query for ALL targets (the operation loops the by_target\n  // index server-side) instead of a per-target `inbound` fan-out. Returns one\n  // record list per target, in `targets` order.\n  const recordsPerTarget = await operations.references\n    .inboundMany({\n      projectId,\n      targets: targets.map((ref) => toTarget(ref)),\n    })\n    .then((result) => {\n      if (!result.ok) throw new Error(result.error.message)\n      return result.value\n    })\n  // EC-302: no inbound refs for ANY target → no sources to label, so skip the\n  // label-context load (schema + ALL documents + ALL assets). The common case when\n  // deleting/unpublishing unreferenced documents (incl. bulk); mirrors the EC-301\n  // short-circuit already in `loadInboundAssetReferenceViews`.\n  if (recordsPerTarget.every((records) => records.length === 0)) {\n    return targets.map((ref) => ({ ref, inbound: [] }))\n  }\n  const context = await loadLabelContext(operations, projectId)\n  return targets.map((ref, index) => ({\n    ref,\n    inbound: buildReferenceEntryViews(recordsPerTarget[index] ?? [], context),\n  }))\n}\n\n/**\n * Inbound reference views for ONE asset (EC-202): the \"what uses this asset\"\n * pre-flight of the asset-delete dialog, index-accurate (the EC-155 reference\n * index, not the retired `find-asset-usages` string scan). Mirrors\n * {@link loadInboundReferenceViews} for a single `{ type: 'asset' }` target —\n * the source labels resolve the referencing documents/graph-nodes identically.\n */\nexport async function loadInboundAssetReferenceViews(\n  projectId: string,\n  assetId: string,\n): Promise<ReferenceEntryView[]> {\n  const studio = await getStudioOperations()\n  await ensureReferenceIndex(studio, projectId)\n  // Observe a settled index: maintained-on-write updates run async after events.\n  await studio.references.flush()\n  const operations = studio.operations\n  const result = await operations.references.inbound({\n    projectId,\n    target: { type: 'asset', id: assetId },\n  })\n  if (!result.ok) throw new Error(result.error.message)\n  // No inbound references → no sources to label, so skip the label-context load\n  // entirely (schema + ALL documents + ALL assets). This is the common case for a\n  // deletable asset, making the delete dialog's pre-flight a single indexed query\n  // instead of three full-table lists (EC-301 perf).\n  if (result.value.length === 0) return []\n  const context = await loadLabelContext(operations, projectId)\n  return buildReferenceEntryViews(result.value, context)\n}\n\n// --- React hook ----------------------------------------------------------------\n\n/**\n * Domains whose successful commands can change the reference index or labels and\n * should refresh an open panel. `references` is deliberately ABSENT (EC-269):\n * reacting to reference-index command events (the `backfill`) would make the\n * panel re-trigger on its OWN index maintenance — a self-cascade that, compounded\n * with the per-keystroke `documents` events, produced hundreds of redundant\n * reloads per document. The index is maintained on write; the panel reacts to the\n * CONTENT domains that feed it, never to its own index writes.\n */\nconst REFERENCE_REFRESH_TRIGGERS = [\n  'documents',\n  'graph',\n  'publishing',\n  'assets',\n  'schema',\n] as const\n\nconst REFRESH_DOMAINS: ReadonlySet<string> = new Set(REFERENCE_REFRESH_TRIGGERS)\n\n/**\n * Whether one operation event should refresh an open reference panel. Exported\n * for tests — pins the EC-269 contract that reference-index commands (and any\n * non-succeeded / non-command event) never trigger a reload.\n */\nexport function isReferenceRefreshEvent(event: OperationEvent): boolean {\n  return (\n    event.kind === 'command' && event.status === 'succeeded' && REFRESH_DOMAINS.has(event.domain)\n  )\n}\n\nexport type ReferencePanelStatus = 'loading' | 'ready' | 'error'\n\nexport interface ReferencePanelState {\n  status: ReferencePanelStatus\n  data: ReferencePanelData | null\n  errorMessage: string | null\n  refresh: () => void\n}\n\n/**\n * Live panel state for one entity (EC-308/AD-17): loads + caches through the one\n * `useOperationQuery` seam, and re-queries whenever a content-bearing command\n * succeeds anywhere in the studio (the index is maintained on write). Per-direction\n * read errors degrade INSIDE `loadReferencePanelData` (carried on the data); a hard\n * failure (broken backend) surfaces as the query's error → `status: 'error'`.\n */\nexport function useReferencePanel(query: ReferencePanelQuery): ReferencePanelState {\n  const { projectId } = query\n  const sourceType = query.source?.type\n  const sourceId = query.source?.id\n  const targetType = query.target?.type\n  const targetId = query.target?.id\n\n  const stableQuery = useMemo<ReferencePanelQuery>(\n    () => ({\n      projectId,\n      ...(sourceType && sourceId ? { source: { type: sourceType, id: sourceId } } : {}),\n      ...(targetType && targetId ? { target: { type: targetType, id: targetId } } : {}),\n    }),\n    [projectId, sourceType, sourceId, targetType, targetId],\n  )\n\n  const result = useOperationQuery<ReferencePanelData>({\n    queryKey: [\n      'referencePanel',\n      projectId,\n      sourceType ?? '',\n      sourceId ?? '',\n      targetType ?? '',\n      targetId ?? '',\n    ],\n    loader: () => loadReferencePanelData(stableQuery),\n    invalidateOn: REFERENCE_REFRESH_TRIGGERS,\n  })\n\n  const status: ReferencePanelStatus = result.isPending\n    ? 'loading'\n    : result.isError\n      ? 'error'\n      : 'ready'\n  return {\n    status,\n    data: result.data ?? null,\n    errorMessage: result.error instanceof Error ? result.error.message : null,\n    refresh: () => void result.refetch(),\n  }\n}\n"]}

package/dist/lib/registry/__fixtures__/demo-components.d.ts

@@ -0,0 +1,32 @@
+import type { ComponentManifest } from '@elytracms/core/component-registry';
+import type { ComponentEntry } from '@elytracms/core/runtime-renderer';
+import type { ComponentType } from 'react';
+import type { StudioRegistry } from '../index.js';
+/**
+ * TEST FIXTURES (EC-591). Sample `project.*` components that stand in for the
+ * project-specific components at the center of the product: each declares a full
+ * manifest (prop schema metadata, defaults, inspector controls, slot rules, and
+ * preview fixtures) and ships a self-contained implementation the fixture runner
+ * renders. Deterministic — no time/random.
+ *
+ * Until EC-591 these were the studio's DEMO FALLBACK: a project whose config
+ * listed no components got them in its palette — insertable, publish-valid, and
+ * missing on delivery (the worst row). The fallback is deleted; they live on only
+ * as the deterministic component set studio tests pin to.
+ */
+type Props = Record<string, unknown>;
+/** Project component manifests (including the deliberately-unimplemented one). */
+export declare const projectComponentManifests: ComponentManifest[];
+/** Implementations for the project components — note `LegacyBanner` is absent. */
+export declare const projectComponentImplementations: Record<string, ComponentType<Props>>;
+/** The demo components as config entries (`LegacyBanner` with no implementation). */
+export declare const demoComponentEntries: readonly ComponentEntry[];
+/**
+ * The deterministic registry studio tests pin to: the shipped components plus the
+ * demo components — what a config listing `[...elytraComponents, ...demo]` gets,
+ * through the one registration step.
+ */
+export declare function fixtureStudioRegistry(): StudioRegistry;
+/** The same list, for `setStudioComponentsForTests`. */
+export declare const fixtureComponentEntries: readonly ComponentEntry[];
+export {};

package/dist/lib/registry/{project-components.js → __fixtures__/demo-components.js}

@@ -1,5 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { defineComponent } from '@elytracms/core/component-registry';
+import { registerComponents } from '@elytracms/core/runtime-renderer';
+import { elytraComponents } from '@elytracms/components';
 function str(value, fallback = '') {
     return typeof value === 'string' && value.length > 0 ? value : fallback;
 }
@@ -10,7 +12,6 @@ function MarketingHero(props) {
 }
 const MarketingHeroManifest = defineComponent({
     id: 'project.MarketingHero',
-    namespace: 'project',
     title: 'Marketing Hero',
     description: 'A headline hero section with eyebrow, subheading, and a call to action.',
     category: 'marketing',
@@ -55,7 +56,6 @@ function FeatureCard(props) {
 }
 const FeatureCardManifest = defineComponent({
     id: 'project.FeatureCard',
-    namespace: 'project',
     title: 'Feature Card',
     description: 'A compact card highlighting a single feature.',
     category: 'marketing',
@@ -91,7 +91,6 @@ function PricingCallout(props) {
 }
 const PricingCalloutManifest = defineComponent({
     id: 'project.PricingCallout',
-    namespace: 'project',
     title: 'Pricing Callout',
     description: 'A pricing plan callout with an optional featured emphasis.',
     category: 'commerce',
@@ -116,7 +115,6 @@ const PricingCalloutManifest = defineComponent({
 // missing-component fallback (brief §4.11).
 const LegacyBannerManifest = defineComponent({
     id: 'project.LegacyBanner',
-    namespace: 'project',
     title: 'Legacy Banner',
     description: 'A deprecated banner whose implementation has not been wired up.',
     category: 'marketing',
@@ -139,4 +137,19 @@ export const projectComponentImplementations = {
     'project.FeatureCard': FeatureCard,
     'project.PricingCallout': PricingCallout,
 };
-//# sourceMappingURL=project-components.js.map
+/** The demo components as config entries (`LegacyBanner` with no implementation). */
+export const demoComponentEntries = projectComponentManifests.map((manifest) => ({
+    manifest,
+    implementation: projectComponentImplementations[manifest.id],
+}));
+/**
+ * The deterministic registry studio tests pin to: the shipped components plus the
+ * demo components — what a config listing `[...elytraComponents, ...demo]` gets,
+ * through the one registration step.
+ */
+export function fixtureStudioRegistry() {
+    return registerComponents([...elytraComponents, ...demoComponentEntries]);
+}
+/** The same list, for `setStudioComponentsForTests`. */
+export const fixtureComponentEntries = [...elytraComponents, ...demoComponentEntries];
+//# sourceMappingURL=demo-components.js.map

package/dist/lib/registry/__fixtures__/demo-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-components.js","sourceRoot":"","sources":["../../../../src/lib/registry/__fixtures__/demo-components.tsx"],"names":[],"mappings":"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","sourcesContent":["import { defineComponent } from '@elytracms/core/component-registry'\nimport type { ComponentManifest } from '@elytracms/core/component-registry'\nimport { registerComponents } from '@elytracms/core/runtime-renderer'\nimport type { ComponentEntry } from '@elytracms/core/runtime-renderer'\nimport { elytraComponents } from '@elytracms/components'\nimport type { ComponentType, ReactNode } from 'react'\nimport type { StudioRegistry } from '../index'\n\n/**\n * TEST FIXTURES (EC-591). Sample `project.*` components that stand in for the\n * project-specific components at the center of the product: each declares a full\n * manifest (prop schema metadata, defaults, inspector controls, slot rules, and\n * preview fixtures) and ships a self-contained implementation the fixture runner\n * renders. Deterministic — no time/random.\n *\n * Until EC-591 these were the studio's DEMO FALLBACK: a project whose config\n * listed no components got them in its palette — insertable, publish-valid, and\n * missing on delivery (the worst row). The fallback is deleted; they live on only\n * as the deterministic component set studio tests pin to.\n */\n\ntype Props = Record<string, unknown>\nfunction str(value: unknown, fallback = ''): string {\n  return typeof value === 'string' && value.length > 0 ? value : fallback\n}\n\n// --- project.MarketingHero -------------------------------------------------\n\nfunction MarketingHero(props: Props): ReactNode {\n  const align = props.align === 'center' ? 'items-center text-center' : 'items-start text-left'\n  return (\n    <div className={`flex flex-col gap-3 rounded-xl border border-border bg-card p-8 ${align}`}>\n      {str(props.eyebrow) ? (\n        <span className=\"text-[0.7rem] font-semibold uppercase tracking-[0.14em] text-primary\">\n          {str(props.eyebrow)}\n        </span>\n      ) : null}\n      <h2 className=\"text-2xl font-semibold tracking-tight text-foreground\">\n        {str(props.heading, 'Headline goes here')}\n      </h2>\n      {str(props.subheading) ? (\n        <p className=\"max-w-prose text-sm text-muted-foreground\">{str(props.subheading)}</p>\n      ) : null}\n      {str(props.ctaLabel) ? (\n        <span className=\"mt-1 inline-flex w-fit items-center rounded-md bg-primary px-3 py-1.5 text-sm font-medium text-primary-foreground\">\n          {str(props.ctaLabel)}\n        </span>\n      ) : null}\n    </div>\n  )\n}\n\nconst MarketingHeroManifest = defineComponent({\n  id: 'project.MarketingHero',\n  title: 'Marketing Hero',\n  description: 'A headline hero section with eyebrow, subheading, and a call to action.',\n  category: 'marketing',\n  props: {\n    eyebrow: { type: 'text', default: 'New', form: { label: 'Eyebrow' } },\n    heading: {\n      type: 'text',\n      default: 'Build code-first websites',\n      validation: { min: 1 },\n      form: { label: 'Heading' },\n    },\n    subheading: {\n      type: 'text',\n      default: 'One canonical graph powers editing, content, and export.',\n      form: { label: 'Subheading', control: 'textarea' },\n    },\n    ctaLabel: { type: 'text', default: 'Get started', form: { label: 'CTA label' } },\n    align: {\n      type: 'select',\n      default: 'left',\n      options: [\n        { value: 'left', label: 'Left' },\n        { value: 'center', label: 'Center' },\n      ],\n      form: { label: 'Alignment' },\n    },\n  },\n  slots: [],\n  fixtures: [\n    { name: 'Default' },\n    {\n      name: 'Centered',\n      props: { align: 'center', eyebrow: 'Launch', heading: 'Ship faster', ctaLabel: 'Try it' },\n    },\n    { name: 'Minimal', props: { eyebrow: '', subheading: '', ctaLabel: '', heading: 'Just a headline' } },\n  ],\n})\n\n// --- project.FeatureCard ---------------------------------------------------\n\nfunction FeatureCard(props: Props): ReactNode {\n  const accent = props.tone === 'accent'\n  return (\n    <div\n      className={`flex flex-col gap-2 rounded-lg border p-5 ${\n        accent ? 'border-primary/30 bg-primary/5' : 'border-border bg-card'\n      }`}\n    >\n      <div className={`grid size-8 place-items-center rounded-md ${accent ? 'bg-primary text-primary-foreground' : 'bg-muted text-foreground'}`}>\n        <span className=\"text-sm font-bold\">{str(props.title, 'F').charAt(0)}</span>\n      </div>\n      <h3 className=\"text-sm font-semibold text-foreground\">{str(props.title, 'Feature title')}</h3>\n      <p className=\"text-xs text-muted-foreground\">{str(props.body, 'A short description of the feature.')}</p>\n    </div>\n  )\n}\n\nconst FeatureCardManifest = defineComponent({\n  id: 'project.FeatureCard',\n  title: 'Feature Card',\n  description: 'A compact card highlighting a single feature.',\n  category: 'marketing',\n  props: {\n    title: {\n      type: 'text',\n      default: 'Validation first',\n      validation: { min: 1 },\n      form: { label: 'Title' },\n    },\n    body: {\n      type: 'text',\n      default: 'Broken bindings and missing components are explicit, never silent.',\n      form: { label: 'Body', control: 'textarea' },\n    },\n    tone: {\n      type: 'select',\n      default: 'default',\n      options: [\n        { value: 'default', label: 'Default' },\n        { value: 'accent', label: 'Accent' },\n      ],\n      form: { label: 'Tone' },\n    },\n  },\n  slots: [],\n  fixtures: [{ name: 'Default' }, { name: 'Accent', props: { tone: 'accent', title: 'AI inspectable' } }],\n})\n\n// --- project.PricingCallout ------------------------------------------------\n\nfunction PricingCallout(props: Props): ReactNode {\n  const featured = props.featured === true\n  return (\n    <div\n      className={`flex flex-col gap-1 rounded-xl border p-6 ${\n        featured ? 'border-primary bg-primary/5 shadow-md' : 'border-border bg-card'\n      }`}\n    >\n      {featured ? (\n        <span className=\"mb-1 w-fit rounded-full bg-primary px-2 py-0.5 text-[0.65rem] font-semibold uppercase tracking-wide text-primary-foreground\">\n          Popular\n        </span>\n      ) : null}\n      <span className=\"text-sm font-medium text-muted-foreground\">{str(props.plan, 'Plan')}</span>\n      <div className=\"flex items-baseline gap-1\">\n        <span className=\"text-3xl font-semibold tracking-tight text-foreground\">{str(props.price, '$0')}</span>\n        <span className=\"text-sm text-muted-foreground\">/{str(props.period, 'mo')}</span>\n      </div>\n    </div>\n  )\n}\n\nconst PricingCalloutManifest = defineComponent({\n  id: 'project.PricingCallout',\n  title: 'Pricing Callout',\n  description: 'A pricing plan callout with an optional featured emphasis.',\n  category: 'commerce',\n  props: {\n    plan: {\n      type: 'text',\n      default: 'Pro',\n      validation: { min: 1 },\n      form: { label: 'Plan' },\n    },\n    price: { type: 'text', default: '$29', form: { label: 'Price' } },\n    period: { type: 'text', default: 'mo', form: { label: 'Period' } },\n    featured: { type: 'boolean', default: false, form: { label: 'Featured' } },\n  },\n  slots: [],\n  fixtures: [{ name: 'Standard' }, { name: 'Featured', props: { featured: true, plan: 'Team', price: '$79' } }],\n})\n\n// --- project.LegacyBanner (intentionally has NO implementation) -------------\n//\n// Registered manifest with no implementation — exercises the \"incompatible /\n// missing implementation\" component status (EC-055) and the renderer's\n// missing-component fallback (brief §4.11).\n\nconst LegacyBannerManifest = defineComponent({\n  id: 'project.LegacyBanner',\n  title: 'Legacy Banner',\n  description: 'A deprecated banner whose implementation has not been wired up.',\n  category: 'marketing',\n  props: {\n    message: { type: 'text', default: 'Deprecated', form: { label: 'Message' } },\n  },\n  slots: [],\n  fixtures: [{ name: 'Default' }],\n})\n\n/** Project component manifests (including the deliberately-unimplemented one). */\nexport const projectComponentManifests: ComponentManifest[] = [\n  MarketingHeroManifest,\n  FeatureCardManifest,\n  PricingCalloutManifest,\n  LegacyBannerManifest,\n]\n\n/** Implementations for the project components — note `LegacyBanner` is absent. */\nexport const projectComponentImplementations: Record<string, ComponentType<Props>> = {\n  'project.MarketingHero': MarketingHero,\n  'project.FeatureCard': FeatureCard,\n  'project.PricingCallout': PricingCallout,\n}\n\n/** The demo components as config entries (`LegacyBanner` with no implementation). */\nexport const demoComponentEntries: readonly ComponentEntry[] = projectComponentManifests.map((manifest) => ({\n  manifest,\n  implementation: projectComponentImplementations[manifest.id],\n}))\n\n/**\n * The deterministic registry studio tests pin to: the shipped components plus the\n * demo components — what a config listing `[...elytraComponents, ...demo]` gets,\n * through the one registration step.\n */\nexport function fixtureStudioRegistry(): StudioRegistry {\n  return registerComponents([...elytraComponents, ...demoComponentEntries])\n}\n\n/** The same list, for `setStudioComponentsForTests`. */\nexport const fixtureComponentEntries: readonly ComponentEntry[] = [...elytraComponents, ...demoComponentEntries]\n"]}

package/dist/lib/registry/index.d.ts

@@ -1,11 +1,10 @@
-import { ComponentRegistry } from '@elytracms/core/component-registry';
-import type { ComponentManifest } from '@elytracms/core/component-registry';
+import type { ComponentManifest, ComponentRegistry } from '@elytracms/core/component-registry';
 import type { PropFieldLookup } from '@elytracms/core/cms-core';
-import type { ComponentImplementations, RenderContext } from '@elytracms/core/runtime-renderer';
+import type { ComponentEntry, ComponentImplementations, RenderContext } from '@elytracms/core/runtime-renderer';
 /**
  * The Studio's view of a project's component registry (brief §7.2, §8.3): the
- * platform primitives plus the project's own components, with their
- * implementations for live previews. Deterministic singleton, built in-process
+ * project's component LIST — exactly what its config's `components` names — with
+ * the implementations for live previews. Deterministic singleton, built in-process
  * from code-owned manifests — component manifests live in TS next to the
  * components, so local/CI/browser runs need no backend.
  */
@@ -13,16 +12,13 @@ export interface StudioRegistry {
     registry: ComponentRegistry;
     implementations: ComponentImplementations;
 }
-export declare function getStudioRegistry(): StudioRegistry;
 /**
- * The built-in demo fixtures as a StudioRegistry, independent of the active
- * project's `components` config ref. This is the golden-path component set
- * (`project.MarketingHero`, `FeatureCard`, `PricingCallout`, `LegacyBanner`) used
- * when a project declares no ref — and the deterministic registry that blocks /
- * clipboard / thumbnail tests pin to, so they assert against a known component set
- * regardless of which library `elytra.config.ts` happens to select (EC-194).
+ * Test seam: register this list instead of the active project's config list
+ * (`null` restores the config). Never used by app code — the studio's components
+ * come from `elytra.config.ts`.
  */
-export declare function fixtureStudioRegistry(): StudioRegistry;
+export declare function setStudioComponentsForTests(entries: readonly ComponentEntry[] | null): void;
+export declare function getStudioRegistry(): StudioRegistry;
 /**
  * Adapt the live registry to the cms-core {@link PropFieldLookup} contract (EC-277):
  * a component id → its prop field-defs, name-injected. Threaded into the studio's

package/dist/lib/registry/index.js

@@ -1,72 +1,45 @@
-import { ComponentRegistry, manifestPropFields } from '@elytracms/core/component-registry';
-import { basePrimitives, getImplementation, registerImplementations } from '@elytracms/core/runtime-renderer';
-import { getActiveProjectSlug, resolveDeploymentComponents } from '../workspace/index.js';
-import { projectComponentImplementations, projectComponentManifests } from './project-components.js';
+import { manifestPropFields } from '@elytracms/core/component-registry';
+import { getImplementation, registerComponents } from '@elytracms/core/runtime-renderer';
+import { resolveDeploymentComponents } from '../workspace/index.js';
 /**
- * EC-555: the config's implementations are `unknown` (`HostComponentEntry`), so
- * they go through core's one registration step — the same one the Next host
- * uses (EC-541) — instead of a cast: a non-component is withheld (its nodes
- * take the renderer's missing-component path, never `createElement`) and
- * recorded as an `invalid-implementation` issue. The fixture set below is
- * engine-owned and typed as components, so it needs no runtime check.
+ * EC-194/EC-208/EC-223, reshaped by EC-591: the consuming repo's component list,
+ * INJECTED through config-as-code (the mount contract) — the active project's
+ * `components`, the live (manifest + implementation) pairs its `elytra.config.ts`
+ * hands in (the components Elytra ships are an opt-in package listed there:
+ * `[...elytraComponents, ...siteComponents]`). The studio registers NOTHING of its
+ * own: no base primitives and no demo fallback. A project that lists no components
+ * gets an empty palette — the canvas says why (its role notices) — never a set of
+ * demo components the delivery host would render as missing-component fallbacks
+ * (the EC-591 worst row).
+ *
+ * The list goes through core's ONE registration step `registerComponents` — the
+ * same call the Next host and the preview harness make — so a duplicate id, a role
+ * claim or an `invalid-implementation` is the identical issue on every surface, in
+ * `registry.issues` (the one record the status readers below consult).
  */
-function projectComponents() {
-    const components = resolveDeploymentComponents();
-    if (components && components.length > 0) {
-        const { implementations, issues } = registerImplementations(components);
-        return { manifests: components.map((c) => c.manifest), implementations, issues };
-    }
-    return {
-        manifests: projectComponentManifests,
-        implementations: projectComponentImplementations,
-        issues: [],
-    };
-}
-/** Compose a StudioRegistry from the base primitives plus a project component set. */
-function buildStudioRegistry(project) {
-    const base = basePrimitives();
-    // Inline-editable opt-ins (EC-158) live directly on the base-primitive
-    // manifests (`Heading.text`, `Text.value`) in `@elytracms/core/runtime-renderer`.
-    const registry = new ComponentRegistry([...base.manifests, ...project.manifests]);
-    // EC-555: implementation issues join the registry's OWN list, because that is
-    // the one list every studio status reader consults — `componentStatus` below
-    // (→ 'invalid'), the Components surface, and the blocks panel tile, which
-    // prints each issue's message. A second list would be a second reader.
-    registry.issues.push(...project.issues);
-    return {
-        registry,
-        // Project wins over base by spread (a project entry under a `base.*` id
-        // replaces the primitive; a WITHHELD one leaves the primitive in place).
-        implementations: { ...base.implementations, ...project.implementations },
-    };
+let componentsForTests = null;
+/**
+ * Test seam: register this list instead of the active project's config list
+ * (`null` restores the config). Never used by app code — the studio's components
+ * come from `elytra.config.ts`.
+ */
+export function setStudioComponentsForTests(entries) {
+    componentsForTests = entries;
+    cached = null;
 }
+const NO_COMPONENTS = [];
 let cached = null;
-let cachedSlug = null;
+let cachedList = null;
 export function getStudioRegistry() {
-    // Re-derive when the active project changes — different projects may register
-    // different component libraries (per-project registry, AD-8).
-    const slug = getActiveProjectSlug();
-    if (cached && cachedSlug === slug)
+    // Re-derive when the list changes — a different active project (per-project
+    // registry, AD-8) or a re-mounted config hands over a different list.
+    const list = componentsForTests ?? resolveDeploymentComponents() ?? NO_COMPONENTS;
+    if (cached && cachedList === list)
         return cached;
-    cached = buildStudioRegistry(projectComponents());
-    cachedSlug = slug;
+    cached = registerComponents(list);
+    cachedList = list;
     return cached;
 }
-/**
- * The built-in demo fixtures as a StudioRegistry, independent of the active
- * project's `components` config ref. This is the golden-path component set
- * (`project.MarketingHero`, `FeatureCard`, `PricingCallout`, `LegacyBanner`) used
- * when a project declares no ref — and the deterministic registry that blocks /
- * clipboard / thumbnail tests pin to, so they assert against a known component set
- * regardless of which library `elytra.config.ts` happens to select (EC-194).
- */
-export function fixtureStudioRegistry() {
-    return buildStudioRegistry({
-        manifests: projectComponentManifests,
-        implementations: projectComponentImplementations,
-        issues: [],
-    });
-}
 /**
  * Adapt the live registry to the cms-core {@link PropFieldLookup} contract (EC-277):
  * a component id → its prop field-defs, name-injected. Threaded into the studio's

package/dist/lib/registry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/registry/index.tsx"],"names":[],"mappings":"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","sourcesContent":["import { ComponentRegistry, manifestPropFields } from '@elytracms/core/component-registry'\nimport type { ComponentIssue, ComponentManifest } from '@elytracms/core/component-registry'\nimport type { PropFieldLookup } from '@elytracms/core/cms-core'\nimport { basePrimitives, getImplementation, registerImplementations } from '@elytracms/core/runtime-renderer'\nimport type { ComponentImplementations, RenderContext } from '@elytracms/core/runtime-renderer'\nimport { getActiveProjectSlug, resolveDeploymentComponents } from '../workspace'\nimport { projectComponentImplementations, projectComponentManifests } from './project-components'\n\n/**\n * The Studio's view of a project's component registry (brief §7.2, §8.3): the\n * platform primitives plus the project's own components, with their\n * implementations for live previews. Deterministic singleton, built in-process\n * from code-owned manifests — component manifests live in TS next to the\n * components, so local/CI/browser runs need no backend.\n */\nexport interface StudioRegistry {\n  registry: ComponentRegistry\n  implementations: ComponentImplementations\n}\n\n/**\n * EC-194/EC-208/EC-223: the consuming repo's OWN real components, INJECTED through\n * config-as-code (the mount contract). The active project's `components` field holds\n * the live (manifest + implementation) pairs the consumer's `elytra.config.ts` handed\n * in by dependency injection — for Aurora these live in\n * `apps/example-site/components/marketing` (Next-free, so they render identically in\n * the studio canvas and the host). No `@site` alias and no static codegen seam: the\n * registry reads the live set off the resolved config. Absent any, the studio falls\n * back to the built-in demo fixtures (golden path).\n */\n/** A project component set, ready to layer over the base primitives. */\ninterface ProjectComponentSet {\n  manifests: ComponentManifest[]\n  implementations: ComponentImplementations\n  /** Registration issues the registry itself cannot see (`invalid-implementation`, EC-555). */\n  issues: readonly ComponentIssue[]\n}\n\n/**\n * EC-555: the config's implementations are `unknown` (`HostComponentEntry`), so\n * they go through core's one registration step — the same one the Next host\n * uses (EC-541) — instead of a cast: a non-component is withheld (its nodes\n * take the renderer's missing-component path, never `createElement`) and\n * recorded as an `invalid-implementation` issue. The fixture set below is\n * engine-owned and typed as components, so it needs no runtime check.\n */\nfunction projectComponents(): ProjectComponentSet {\n  const components = resolveDeploymentComponents()\n  if (components && components.length > 0) {\n    const { implementations, issues } = registerImplementations(components)\n    return { manifests: components.map((c) => c.manifest), implementations, issues }\n  }\n  return {\n    manifests: projectComponentManifests,\n    implementations: projectComponentImplementations,\n    issues: [],\n  }\n}\n\n/** Compose a StudioRegistry from the base primitives plus a project component set. */\nfunction buildStudioRegistry(project: ProjectComponentSet): StudioRegistry {\n  const base = basePrimitives()\n  // Inline-editable opt-ins (EC-158) live directly on the base-primitive\n  // manifests (`Heading.text`, `Text.value`) in `@elytracms/core/runtime-renderer`.\n  const registry = new ComponentRegistry([...base.manifests, ...project.manifests])\n  // EC-555: implementation issues join the registry's OWN list, because that is\n  // the one list every studio status reader consults — `componentStatus` below\n  // (→ 'invalid'), the Components surface, and the blocks panel tile, which\n  // prints each issue's message. A second list would be a second reader.\n  registry.issues.push(...project.issues)\n  return {\n    registry,\n    // Project wins over base by spread (a project entry under a `base.*` id\n    // replaces the primitive; a WITHHELD one leaves the primitive in place).\n    implementations: { ...base.implementations, ...project.implementations },\n  }\n}\n\nlet cached: StudioRegistry | null = null\nlet cachedSlug: string | null = null\n\nexport function getStudioRegistry(): StudioRegistry {\n  // Re-derive when the active project changes — different projects may register\n  // different component libraries (per-project registry, AD-8).\n  const slug = getActiveProjectSlug()\n  if (cached && cachedSlug === slug) return cached\n  cached = buildStudioRegistry(projectComponents())\n  cachedSlug = slug\n  return cached\n}\n\n/**\n * The built-in demo fixtures as a StudioRegistry, independent of the active\n * project's `components` config ref. This is the golden-path component set\n * (`project.MarketingHero`, `FeatureCard`, `PricingCallout`, `LegacyBanner`) used\n * when a project declares no ref — and the deterministic registry that blocks /\n * clipboard / thumbnail tests pin to, so they assert against a known component set\n * regardless of which library `elytra.config.ts` happens to select (EC-194).\n */\nexport function fixtureStudioRegistry(): StudioRegistry {\n  return buildStudioRegistry({\n    manifests: projectComponentManifests,\n    implementations: projectComponentImplementations,\n    issues: [],\n  })\n}\n\n/**\n * Adapt the live registry to the cms-core {@link PropFieldLookup} contract (EC-277):\n * a component id → its prop field-defs, name-injected. Threaded into the studio's\n * write-time self-typing lens so relation/asset props inside compositions are\n * self-typed on write (\"schema leads, component adopts\"). Manifests are code (AD-11);\n * persistence/cms-core never depend on the registry — the studio supplies this shape.\n */\nexport function studioManifestLookup(): PropFieldLookup {\n  const { registry } = getStudioRegistry()\n  return (componentId) => {\n    const manifest = registry.getManifest(componentId)\n    if (!manifest) return undefined\n    return Object.fromEntries(manifestPropFields(manifest).map((field) => [field.name, field]))\n  }\n}\n\n/** A RenderContext for fixture previews (static props only; no asset/relation resolvers). */\nexport function previewContext(studio: StudioRegistry): RenderContext {\n  return { registry: studio.registry, implementations: studio.implementations }\n}\n\n/**\n * Per-component status (brief §4.11, §8.3, EC-055):\n * - `invalid`: the registry reported a structured issue for this id — including\n *   an `invalid-implementation` (EC-555: the entry HAS an implementation, it is\n *   just not a component, so it is not merely missing).\n * - `incompatible`: a manifest exists but no implementation is wired up.\n * - `valid`: healthy.\n */\nexport type ComponentStatus = 'valid' | 'incompatible' | 'invalid'\n\nexport function componentStatus(\n  studio: StudioRegistry,\n  manifest: ComponentManifest,\n): ComponentStatus {\n  if (studio.registry.issues.some((i) => i.componentId === manifest.id)) return 'invalid'\n  if (!getImplementation(studio.implementations, manifest.id)) return 'incompatible'\n  return 'valid'\n}\n\nexport interface RegistryHealth {\n  total: number\n  valid: number\n  incompatible: number\n  invalid: number\n}\n\nexport function registryHealth(studio: StudioRegistry): RegistryHealth {\n  const all = studio.registry.list()\n  const health: RegistryHealth = { total: all.length, valid: 0, incompatible: 0, invalid: 0 }\n  for (const m of all) health[componentStatus(studio, m)] += 1\n  return health\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/registry/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AAGvE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAExF,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAA;AAc1D;;;;;;;;;;;;;;;GAeG;AACH,IAAI,kBAAkB,GAAqC,IAAI,CAAA;AAE/D;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAyC;IACnF,kBAAkB,GAAG,OAAO,CAAA;IAC5B,MAAM,GAAG,IAAI,CAAA;AACf,CAAC;AAED,MAAM,aAAa,GAA8B,EAAE,CAAA;AACnD,IAAI,MAAM,GAA0B,IAAI,CAAA;AACxC,IAAI,UAAU,GAAqC,IAAI,CAAA;AAEvD,MAAM,UAAU,iBAAiB;IAC/B,4EAA4E;IAC5E,sEAAsE;IACtE,MAAM,IAAI,GAAG,kBAAkB,IAAI,2BAA2B,EAAE,IAAI,aAAa,CAAA;IACjF,IAAI,MAAM,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,MAAM,CAAA;IAChD,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;IACjC,UAAU,GAAG,IAAI,CAAA;IACjB,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,EAAE,QAAQ,EAAE,GAAG,iBAAiB,EAAE,CAAA;IACxC,OAAO,CAAC,WAAW,EAAE,EAAE;QACrB,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,CAAA;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAA;QAC/B,OAAO,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;IAC7F,CAAC,CAAA;AACH,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAAA;AAC/E,CAAC;AAYD,MAAM,UAAU,eAAe,CAC7B,MAAsB,EACtB,QAA2B;IAE3B,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAA;IACvF,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,eAAe,EAAE,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,cAAc,CAAA;IAClF,OAAO,OAAO,CAAA;AAChB,CAAC;AASD,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,MAAM,GAAmB,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAA;IAC3F,KAAK,MAAM,CAAC,IAAI,GAAG;QAAE,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAC5D,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import { manifestPropFields } from '@elytracms/core/component-registry'\nimport type { ComponentManifest, ComponentRegistry } from '@elytracms/core/component-registry'\nimport type { PropFieldLookup } from '@elytracms/core/cms-core'\nimport { getImplementation, registerComponents } from '@elytracms/core/runtime-renderer'\nimport type { ComponentEntry, ComponentImplementations, RenderContext } from '@elytracms/core/runtime-renderer'\nimport { resolveDeploymentComponents } from '../workspace'\n\n/**\n * The Studio's view of a project's component registry (brief §7.2, §8.3): the\n * project's component LIST — exactly what its config's `components` names — with\n * the implementations for live previews. Deterministic singleton, built in-process\n * from code-owned manifests — component manifests live in TS next to the\n * components, so local/CI/browser runs need no backend.\n */\nexport interface StudioRegistry {\n  registry: ComponentRegistry\n  implementations: ComponentImplementations\n}\n\n/**\n * EC-194/EC-208/EC-223, reshaped by EC-591: the consuming repo's component list,\n * INJECTED through config-as-code (the mount contract) — the active project's\n * `components`, the live (manifest + implementation) pairs its `elytra.config.ts`\n * hands in (the components Elytra ships are an opt-in package listed there:\n * `[...elytraComponents, ...siteComponents]`). The studio registers NOTHING of its\n * own: no base primitives and no demo fallback. A project that lists no components\n * gets an empty palette — the canvas says why (its role notices) — never a set of\n * demo components the delivery host would render as missing-component fallbacks\n * (the EC-591 worst row).\n *\n * The list goes through core's ONE registration step `registerComponents` — the\n * same call the Next host and the preview harness make — so a duplicate id, a role\n * claim or an `invalid-implementation` is the identical issue on every surface, in\n * `registry.issues` (the one record the status readers below consult).\n */\nlet componentsForTests: readonly ComponentEntry[] | null = null\n\n/**\n * Test seam: register this list instead of the active project's config list\n * (`null` restores the config). Never used by app code — the studio's components\n * come from `elytra.config.ts`.\n */\nexport function setStudioComponentsForTests(entries: readonly ComponentEntry[] | null): void {\n  componentsForTests = entries\n  cached = null\n}\n\nconst NO_COMPONENTS: readonly ComponentEntry[] = []\nlet cached: StudioRegistry | null = null\nlet cachedList: readonly ComponentEntry[] | null = null\n\nexport function getStudioRegistry(): StudioRegistry {\n  // Re-derive when the list changes — a different active project (per-project\n  // registry, AD-8) or a re-mounted config hands over a different list.\n  const list = componentsForTests ?? resolveDeploymentComponents() ?? NO_COMPONENTS\n  if (cached && cachedList === list) return cached\n  cached = registerComponents(list)\n  cachedList = list\n  return cached\n}\n\n/**\n * Adapt the live registry to the cms-core {@link PropFieldLookup} contract (EC-277):\n * a component id → its prop field-defs, name-injected. Threaded into the studio's\n * write-time self-typing lens so relation/asset props inside compositions are\n * self-typed on write (\"schema leads, component adopts\"). Manifests are code (AD-11);\n * persistence/cms-core never depend on the registry — the studio supplies this shape.\n */\nexport function studioManifestLookup(): PropFieldLookup {\n  const { registry } = getStudioRegistry()\n  return (componentId) => {\n    const manifest = registry.getManifest(componentId)\n    if (!manifest) return undefined\n    return Object.fromEntries(manifestPropFields(manifest).map((field) => [field.name, field]))\n  }\n}\n\n/** A RenderContext for fixture previews (static props only; no asset/relation resolvers). */\nexport function previewContext(studio: StudioRegistry): RenderContext {\n  return { registry: studio.registry, implementations: studio.implementations }\n}\n\n/**\n * Per-component status (brief §4.11, §8.3, EC-055):\n * - `invalid`: the registry reported a structured issue for this id — including\n *   an `invalid-implementation` (EC-555: the entry HAS an implementation, it is\n *   just not a component, so it is not merely missing).\n * - `incompatible`: a manifest exists but no implementation is wired up.\n * - `valid`: healthy.\n */\nexport type ComponentStatus = 'valid' | 'incompatible' | 'invalid'\n\nexport function componentStatus(\n  studio: StudioRegistry,\n  manifest: ComponentManifest,\n): ComponentStatus {\n  if (studio.registry.issues.some((i) => i.componentId === manifest.id)) return 'invalid'\n  if (!getImplementation(studio.implementations, manifest.id)) return 'incompatible'\n  return 'valid'\n}\n\nexport interface RegistryHealth {\n  total: number\n  valid: number\n  incompatible: number\n  invalid: number\n}\n\nexport function registryHealth(studio: StudioRegistry): RegistryHealth {\n  const all = studio.registry.list()\n  const health: RegistryHealth = { total: all.length, valid: 0, incompatible: 0, invalid: 0 }\n  for (const m of all) health[componentStatus(studio, m)] += 1\n  return health\n}\n"]}

package/dist/lib/registry/preview.d.ts

@@ -1,15 +1,30 @@
 import type { ComponentNode, JsonValue } from '@elytracms/core/project-graph';
-import type { ComponentManifest } from '@elytracms/core/component-registry';
+import type { ComponentManifest, ComponentRegistry } from '@elytracms/core/component-registry';
 /** A named, renderable preview state for a component. */
 export interface PreviewSpec {
     name: string;
     node: ComponentNode;
 }
-/** Build a node from a manifest's defaults, overlaying any provided prop values. */
-export declare function nodeFromProps(manifest: ComponentManifest, overrides: Record<string, JsonValue>, id: string): ComponentNode;
 /**
- * Resolve the preview states for a component (brief §7.2, §8.3, EC-054):
- * declared manifest fixtures first; otherwise authored primitive previews;
- * otherwise a single default-props preview. Deterministic ids throughout.
+ * A node carrying exactly the given prop values (EC-591 / ratified 2f): a prop
+ * the caller does not set stays ABSENT — the implementation's own default applies
+ * — and the manifest `default` is never copied in (it is an authoring hint). Until
+ * EC-591 this overlaid the overrides on every manifest default, so a fixture
+ * insert stored — and rendered — something other than the same fixture pasted
+ * from "copy exact configuration" (COMPOSITION #19).
+ *
+ * Node ids are derived deterministically from a stable base (manifest id +
+ * fixture index) so previews are byte-identical across SSR and client hydration
+ * and reproducible across runs — no module-level counter, no time/random.
  */
-export declare function previewSpecs(manifest: ComponentManifest): PreviewSpec[];
+export declare function nodeFromProps(manifest: ComponentManifest, values: Record<string, JsonValue>, id: string): ComponentNode;
+/**
+ * Resolve the preview states for a component (brief §7.2, §8.3, EC-054): the
+ * declared manifest fixtures; otherwise the single `Default` — the SAME seeded
+ * node the blocks panel inserts and `elytra previews` renders for a fixture-less
+ * component (a layout container comes pre-filled through its role, EC-383).
+ * EC-591: there are no authored previews keyed by engine ids any more — a
+ * component that wants a richer preview declares `fixtures`, like any other.
+ * Deterministic ids throughout.
+ */
+export declare function previewSpecs(manifest: ComponentManifest, registry: ComponentRegistry): PreviewSpec[];

package/dist/lib/registry/preview.js

@@ -1,110 +1,47 @@
-import { staticProp } from '@elytracms/core/project-graph';
+import { cloneWithNewIds, staticProp } from '@elytracms/core/project-graph';
+import { seededNodeFromManifest } from '../../components/builder/node-factory.js';
 /**
+ * A node carrying exactly the given prop values (EC-591 / ratified 2f): a prop
+ * the caller does not set stays ABSENT — the implementation's own default applies
+ * — and the manifest `default` is never copied in (it is an authoring hint). Until
+ * EC-591 this overlaid the overrides on every manifest default, so a fixture
+ * insert stored — and rendered — something other than the same fixture pasted
+ * from "copy exact configuration" (COMPOSITION #19).
+ *
  * Node ids are derived deterministically from a stable base (manifest id +
  * fixture index) so previews are byte-identical across SSR and client hydration
  * and reproducible across runs — no module-level counter, no time/random.
  */
-function text(value, id) {
-    return { id, componentId: 'base.Text', props: { value: staticProp(value) } };
-}
-/** Build a node from a manifest's defaults, overlaying any provided prop values. */
-export function nodeFromProps(manifest, overrides, id) {
+export function nodeFromProps(manifest, values, id) {
     const props = {};
-    for (const [name, spec] of Object.entries(manifest.props)) {
-        const value = name in overrides ? overrides[name] : spec.default;
+    for (const name of Object.keys(manifest.props)) {
+        const value = values[name];
         if (value !== undefined)
             props[name] = staticProp(value);
     }
     return { id, componentId: manifest.id, props };
 }
-function nodeFromPropsRaw(componentId, props, id) {
-    const out = {};
-    for (const [k, v] of Object.entries(props))
-        out[k] = staticProp(v);
-    return { id, componentId, props: out };
-}
-/**
- * Authored preview nodes for the base primitives (which ship no fixtures of their
- * own). Slot-bearing primitives get sample children so previews aren't blank.
- * Each builder receives a deterministic `base` id prefix.
- */
-const PRIMITIVE_PREVIEWS = {
-    'base.Container': (base) => [
-        {
-            name: 'With content',
-            node: {
-                id: base,
-                componentId: 'base.Container',
-                slots: { children: [text('Container content', `${base}-c0`)] },
-            },
-        },
-    ],
-    'base.Stack': (base) => [
-        {
-            name: 'Gap 4',
-            node: {
-                id: base,
-                componentId: 'base.Stack',
-                props: { gap: staticProp(4) },
-                slots: {
-                    children: [
-                        text('Item one', `${base}-c0`),
-                        text('Item two', `${base}-c1`),
-                        text('Item three', `${base}-c2`),
-                    ],
-                },
-            },
-        },
-    ],
-    'base.Grid': (base) => [
-        {
-            name: '2 columns',
-            node: {
-                id: base,
-                componentId: 'base.Grid',
-                props: { columns: staticProp(2), gap: staticProp(3) },
-                slots: {
-                    children: [
-                        text('Cell A', `${base}-c0`),
-                        text('Cell B', `${base}-c1`),
-                        text('Cell C', `${base}-c2`),
-                        text('Cell D', `${base}-c3`),
-                    ],
-                },
-            },
-        },
-    ],
-    'base.Text': (base) => [
-        { name: 'Sample', node: nodeFromPropsRaw('base.Text', { value: 'The quick brown fox.' }, base) },
-    ],
-    'base.Heading': (base) => [
-        { name: 'Sample', node: nodeFromPropsRaw('base.Heading', { value: 'A section heading' }, base) },
-    ],
-    'base.Image': (base) => [
-        {
-            name: 'Placeholder',
-            node: nodeFromPropsRaw('base.Image', { src: 'https://placehold.co/320x180', alt: 'Placeholder image' }, base),
-        },
-    ],
-    'base.Button': (base) => [
-        { name: 'Sample', node: nodeFromPropsRaw('base.Button', { label: 'Click me' }, base) },
-    ],
-};
 /**
- * Resolve the preview states for a component (brief §7.2, §8.3, EC-054):
- * declared manifest fixtures first; otherwise authored primitive previews;
- * otherwise a single default-props preview. Deterministic ids throughout.
+ * Resolve the preview states for a component (brief §7.2, §8.3, EC-054): the
+ * declared manifest fixtures; otherwise the single `Default` — the SAME seeded
+ * node the blocks panel inserts and `elytra previews` renders for a fixture-less
+ * component (a layout container comes pre-filled through its role, EC-383).
+ * EC-591: there are no authored previews keyed by engine ids any more — a
+ * component that wants a richer preview declares `fixtures`, like any other.
+ * Deterministic ids throughout.
  */
-export function previewSpecs(manifest) {
+export function previewSpecs(manifest, registry) {
     if (manifest.fixtures && manifest.fixtures.length > 0) {
         return manifest.fixtures.map((fixture, i) => ({
             name: fixture.name,
             node: nodeFromProps(manifest, fixture.props ?? {}, `preview-${manifest.id}-${i}`),
         }));
     }
-    const authored = PRIMITIVE_PREVIEWS[manifest.id];
-    if (authored)
-        return authored(`preview-${manifest.id}-0`);
-    return [{ name: 'Default', node: nodeFromProps(manifest, {}, `preview-${manifest.id}-0`) }];
+    // The seed's placeholder ids are re-minted deterministically (root `…-0`, then
+    // `…-0-1`, `…-0-2` …) so every node in the preview tree has a distinct, stable id.
+    const base = `preview-${manifest.id}-0`;
+    let n = 0;
+    const node = cloneWithNewIds(seededNodeFromManifest(manifest, registry), () => (n++ === 0 ? base : `${base}-${n - 1}`));
+    return [{ name: 'Default', node }];
 }
 //# sourceMappingURL=preview.js.map