@elytracms/studio 0.0.90 → 0.0.91

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

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

@@ -1 +1 @@
-{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../../src/lib/registry/preview.ts"],"names":[],"mappings":"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","sourcesContent":["import { staticProp } from '@elytracms/core/project-graph'\nimport type { ComponentNode, JsonValue } from '@elytracms/core/project-graph'\nimport type { ComponentManifest } from '@elytracms/core/component-registry'\n\n/** A named, renderable preview state for a component. */\nexport interface PreviewSpec {\n  name: string\n  node: ComponentNode\n}\n\n/**\n * Node ids are derived deterministically from a stable base (manifest id +\n * fixture index) so previews are byte-identical across SSR and client hydration\n * and reproducible across runs — no module-level counter, no time/random.\n */\nfunction text(value: string, id: string): ComponentNode {\n  return { id, componentId: 'base.Text', props: { value: staticProp(value) } }\n}\n\n/** Build a node from a manifest's defaults, overlaying any provided prop values. */\nexport function nodeFromProps(\n  manifest: ComponentManifest,\n  overrides: Record<string, JsonValue>,\n  id: string,\n): ComponentNode {\n  const props: ComponentNode['props'] = {}\n  for (const [name, spec] of Object.entries(manifest.props)) {\n    const value = name in overrides ? overrides[name] : (spec.default as JsonValue | undefined)\n    if (value !== undefined) props[name] = staticProp(value)\n  }\n  return { id, componentId: manifest.id, props }\n}\n\nfunction nodeFromPropsRaw(componentId: string, props: Record<string, JsonValue>, id: string): ComponentNode {\n  const out: ComponentNode['props'] = {}\n  for (const [k, v] of Object.entries(props)) out[k] = staticProp(v)\n  return { id, componentId, props: out }\n}\n\n/**\n * Authored preview nodes for the base primitives (which ship no fixtures of their\n * own). Slot-bearing primitives get sample children so previews aren't blank.\n * Each builder receives a deterministic `base` id prefix.\n */\nconst PRIMITIVE_PREVIEWS: Record<string, (base: string) => PreviewSpec[]> = {\n  'base.Container': (base) => [\n    {\n      name: 'With content',\n      node: {\n        id: base,\n        componentId: 'base.Container',\n        slots: { children: [text('Container content', `${base}-c0`)] },\n      },\n    },\n  ],\n  'base.Stack': (base) => [\n    {\n      name: 'Gap 4',\n      node: {\n        id: base,\n        componentId: 'base.Stack',\n        props: { gap: staticProp(4) },\n        slots: {\n          children: [\n            text('Item one', `${base}-c0`),\n            text('Item two', `${base}-c1`),\n            text('Item three', `${base}-c2`),\n          ],\n        },\n      },\n    },\n  ],\n  'base.Grid': (base) => [\n    {\n      name: '2 columns',\n      node: {\n        id: base,\n        componentId: 'base.Grid',\n        props: { columns: staticProp(2), gap: staticProp(3) },\n        slots: {\n          children: [\n            text('Cell A', `${base}-c0`),\n            text('Cell B', `${base}-c1`),\n            text('Cell C', `${base}-c2`),\n            text('Cell D', `${base}-c3`),\n          ],\n        },\n      },\n    },\n  ],\n  'base.Text': (base) => [\n    { name: 'Sample', node: nodeFromPropsRaw('base.Text', { value: 'The quick brown fox.' }, base) },\n  ],\n  'base.Heading': (base) => [\n    { name: 'Sample', node: nodeFromPropsRaw('base.Heading', { value: 'A section heading' }, base) },\n  ],\n  'base.Image': (base) => [\n    {\n      name: 'Placeholder',\n      node: nodeFromPropsRaw(\n        'base.Image',\n        { src: 'https://placehold.co/320x180', alt: 'Placeholder image' },\n        base,\n      ),\n    },\n  ],\n  'base.Button': (base) => [\n    { name: 'Sample', node: nodeFromPropsRaw('base.Button', { label: 'Click me' }, base) },\n  ],\n}\n\n/**\n * Resolve the preview states for a component (brief §7.2, §8.3, EC-054):\n * declared manifest fixtures first; otherwise authored primitive previews;\n * otherwise a single default-props preview. Deterministic ids throughout.\n */\nexport function previewSpecs(manifest: ComponentManifest): PreviewSpec[] {\n  if (manifest.fixtures && manifest.fixtures.length > 0) {\n    return manifest.fixtures.map((fixture, i) => ({\n      name: fixture.name,\n      node: nodeFromProps(manifest, fixture.props ?? {}, `preview-${manifest.id}-${i}`),\n    }))\n  }\n  const authored = PRIMITIVE_PREVIEWS[manifest.id]\n  if (authored) return authored(`preview-${manifest.id}-0`)\n  return [{ name: 'Default', node: nodeFromProps(manifest, {}, `preview-${manifest.id}-0`) }]\n}\n"]}
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../../src/lib/registry/preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAG3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AAQ9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,QAA2B,EAC3B,MAAiC,EACjC,EAAU;IAEV,MAAM,KAAK,GAA2B,EAAE,CAAA;IACxC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAC1B,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IAC1D,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,CAAA;AAChD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,QAA2B,EAAE,QAA2B;IACnF,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,WAAW,QAAQ,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC;SAClF,CAAC,CAAC,CAAA;IACL,CAAC;IACD,+EAA+E;IAC/E,mFAAmF;IACnF,MAAM,IAAI,GAAG,WAAW,QAAQ,CAAC,EAAE,IAAI,CAAA;IACvC,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,MAAM,IAAI,GAAG,eAAe,CAAC,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACvH,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AACpC,CAAC","sourcesContent":["import { cloneWithNewIds, staticProp } from '@elytracms/core/project-graph'\nimport type { ComponentNode, JsonValue } from '@elytracms/core/project-graph'\nimport type { ComponentManifest, ComponentRegistry } from '@elytracms/core/component-registry'\nimport { seededNodeFromManifest } from '../../components/builder/node-factory'\n\n/** A named, renderable preview state for a component. */\nexport interface PreviewSpec {\n  name: string\n  node: ComponentNode\n}\n\n/**\n * A node carrying exactly the given prop values (EC-591 / ratified 2f): a prop\n * the caller does not set stays ABSENT — the implementation's own default applies\n * — and the manifest `default` is never copied in (it is an authoring hint). Until\n * EC-591 this overlaid the overrides on every manifest default, so a fixture\n * insert stored — and rendered — something other than the same fixture pasted\n * from \"copy exact configuration\" (COMPOSITION #19).\n *\n * Node ids are derived deterministically from a stable base (manifest id +\n * fixture index) so previews are byte-identical across SSR and client hydration\n * and reproducible across runs — no module-level counter, no time/random.\n */\nexport function nodeFromProps(\n  manifest: ComponentManifest,\n  values: Record<string, JsonValue>,\n  id: string,\n): ComponentNode {\n  const props: ComponentNode['props'] = {}\n  for (const name of Object.keys(manifest.props)) {\n    const value = values[name]\n    if (value !== undefined) props[name] = staticProp(value)\n  }\n  return { id, componentId: manifest.id, props }\n}\n\n/**\n * Resolve the preview states for a component (brief §7.2, §8.3, EC-054): the\n * declared manifest fixtures; otherwise the single `Default` — the SAME seeded\n * node the blocks panel inserts and `elytra previews` renders for a fixture-less\n * component (a layout container comes pre-filled through its role, EC-383).\n * EC-591: there are no authored previews keyed by engine ids any more — a\n * component that wants a richer preview declares `fixtures`, like any other.\n * Deterministic ids throughout.\n */\nexport function previewSpecs(manifest: ComponentManifest, registry: ComponentRegistry): PreviewSpec[] {\n  if (manifest.fixtures && manifest.fixtures.length > 0) {\n    return manifest.fixtures.map((fixture, i) => ({\n      name: fixture.name,\n      node: nodeFromProps(manifest, fixture.props ?? {}, `preview-${manifest.id}-${i}`),\n    }))\n  }\n  // The seed's placeholder ids are re-minted deterministically (root `…-0`, then\n  // `…-0-1`, `…-0-2` …) so every node in the preview tree has a distinct, stable id.\n  const base = `preview-${manifest.id}-0`\n  let n = 0\n  const node = cloneWithNewIds(seededNodeFromManifest(manifest, registry), () => (n++ === 0 ? base : `${base}-${n - 1}`))\n  return [{ name: 'Default', node }]\n}\n"]}

package/dist/previews/enumerate.d.ts

@@ -1,5 +1,5 @@
-import type { ComponentFixture, ComponentIssue, ComponentManifest } from '@elytracms/core/component-registry';
-import type { ComponentImplementations } from '@elytracms/core/runtime-renderer';
+import type { ComponentFixture, ComponentManifest } from '@elytracms/core/component-registry';
+import type { ComponentEntry } from '@elytracms/core/runtime-renderer';
 import type { StudioRegistry } from '../lib/registry/index.js';
 /**
  * EC-440 — the fixture-preview enumeration behind `elytra previews`. ONE
@@ -13,9 +13,10 @@ import type { StudioRegistry } from '../lib/registry/index.js';
  * manifests + implementations — code), never a persistence adapter, auth, or
  * content data. The entry set mirrors the blocks panel exactly (EC-439): every
  * canvas-eligible manifest, one entry per declared fixture, and a single
- * implicit {@link DEFAULT_VARIANT} entry for fixture-less manifests. Base
- * primitives are included — they are insertable tiles too. Layout-helper
- * presets are NOT manifests and keep their placeholder treatment.
+ * implicit {@link DEFAULT_VARIANT} entry for fixture-less manifests. Exactly the
+ * config's components — the engine adds none (EC-591; the shipped components are
+ * there when the config lists `@elytracms/components`). Layout-helper presets are
+ * NOT manifests and keep their placeholder treatment.
  */
 /** One renderable preview: a component fixture plus its staleness-hash inputs. */
 export interface PreviewEntrySpec {
@@ -49,30 +50,25 @@ export interface PreviewEntrySpec {
     };
 }
 /**
- * The component set a config carries, as the harness registry input: the base
- * primitives plus every resolved project's `components` entries, deduped by
- * component id (first declaration wins — the generated-preview seam is keyed
- * by component id alone, so one image serves every project that registers the
- * id). A config that fails shape-resolution contributes no project components
- * — the primitives still enumerate, and the CLI surfaces config problems
- * through the studio/doctor, not here.
- *
- * EC-555: the kept entries' implementations (`unknown` in the config) go through
- * core's one registration step, like the studio registry's and the Next host's —
- * a non-component is withheld (its preview renders the missing-component
- * fallback, never `createElement`) and returned as an `invalid-implementation`
- * issue. The first-wins dedupe runs BEFORE the check, so a withheld entry still
- * claims its id.
+ * The component list a config carries, as the harness registry input: every
+ * resolved project's `components`, concatenated in project order. An entry two
+ * projects share (the same `{ manifest, implementation }` object — e.g. both list
+ * `...elytraComponents`) is the SAME component and is kept once; two DIFFERENT
+ * entries under one id are a real conflict — the generated-preview seam is keyed
+ * by component id alone, so one image would serve both — and go to the one
+ * registration rule like any duplicate: the first is kept whole, the second is a
+ * `duplicate-id` issue (EC-591; before, previews skipped it silently and showed
+ * the first project's render in the second project's tile — COMPOSITION #13).
+ * A config that fails shape-resolution contributes no components; the CLI
+ * surfaces config problems through the studio/doctor, not here.
  */
-export declare function previewComponentsFromConfig(config: unknown): {
-    manifests: ComponentManifest[];
-    implementations: ComponentImplementations;
-    issues: ComponentIssue[];
-};
+export declare function previewComponentsFromConfig(config: unknown): readonly ComponentEntry[];
 /**
- * The {@link StudioRegistry}-shaped registry the harness renders against. Its
- * `registry.issues` carries the implementation issues too — the same list the
- * studio registry records them into (EC-555).
+ * The {@link StudioRegistry}-shaped registry the harness renders against: the
+ * config's list through core's ONE registration step (`registerComponents`, the
+ * same call the studio registry and the Next host make — EC-591), so a duplicate,
+ * a role claim and an `invalid-implementation` are the identical issue in
+ * `registry.issues` on every surface.
  */
 export declare function previewRegistryFromConfig(config: unknown): StudioRegistry;
 /**

package/dist/previews/enumerate.js

@@ -1,63 +1,42 @@
-import { ComponentRegistry, isCanvasEligible } from '@elytracms/core/component-registry';
-import { basePrimitives, getImplementation, registerImplementations } from '@elytracms/core/runtime-renderer';
+import { isCanvasEligible } from '@elytracms/core/component-registry';
+import { registerComponents } from '@elytracms/core/runtime-renderer';
 import { resolveWorkspaceConfig } from '@elytracms/core/studio-core';
 import { DEFAULT_VARIANT } from '../components/builder/blocks-model.js';
 /**
- * The component set a config carries, as the harness registry input: the base
- * primitives plus every resolved project's `components` entries, deduped by
- * component id (first declaration wins — the generated-preview seam is keyed
- * by component id alone, so one image serves every project that registers the
- * id). A config that fails shape-resolution contributes no project components
- * — the primitives still enumerate, and the CLI surfaces config problems
- * through the studio/doctor, not here.
- *
- * EC-555: the kept entries' implementations (`unknown` in the config) go through
- * core's one registration step, like the studio registry's and the Next host's —
- * a non-component is withheld (its preview renders the missing-component
- * fallback, never `createElement`) and returned as an `invalid-implementation`
- * issue. The first-wins dedupe runs BEFORE the check, so a withheld entry still
- * claims its id.
+ * The component list a config carries, as the harness registry input: every
+ * resolved project's `components`, concatenated in project order. An entry two
+ * projects share (the same `{ manifest, implementation }` object — e.g. both list
+ * `...elytraComponents`) is the SAME component and is kept once; two DIFFERENT
+ * entries under one id are a real conflict — the generated-preview seam is keyed
+ * by component id alone, so one image would serve both — and go to the one
+ * registration rule like any duplicate: the first is kept whole, the second is a
+ * `duplicate-id` issue (EC-591; before, previews skipped it silently and showed
+ * the first project's render in the second project's tile — COMPOSITION #13).
+ * A config that fails shape-resolution contributes no components; the CLI
+ * surfaces config problems through the studio/doctor, not here.
  */
 export function previewComponentsFromConfig(config) {
-    const base = basePrimitives();
-    const manifests = [...base.manifests];
-    const implementations = {};
-    for (const manifest of base.manifests) {
-        const implementation = getImplementation(base.implementations, manifest.id);
-        if (implementation)
-            implementations[manifest.id] = implementation;
-    }
-    const seen = new Set(manifests.map((m) => m.id));
-    const kept = [];
-    const resolved = resolveWorkspaceConfig(config);
-    for (const project of resolved.projects) {
+    const seen = new Set();
+    const entries = [];
+    for (const project of resolveWorkspaceConfig(config).projects) {
         for (const entry of project.components ?? []) {
-            if (seen.has(entry.manifest.id))
+            if (seen.has(entry))
                 continue;
-            seen.add(entry.manifest.id);
-            manifests.push(entry.manifest);
-            kept.push(entry);
+            seen.add(entry);
+            entries.push(entry);
         }
     }
-    // Ids are unique by construction here (deduped against the primitives too),
-    // so the merge order below decides nothing.
-    const project = registerImplementations(kept);
-    return {
-        manifests,
-        implementations: { ...implementations, ...project.implementations },
-        issues: project.issues,
-    };
+    return entries;
 }
 /**
- * The {@link StudioRegistry}-shaped registry the harness renders against. Its
- * `registry.issues` carries the implementation issues too — the same list the
- * studio registry records them into (EC-555).
+ * The {@link StudioRegistry}-shaped registry the harness renders against: the
+ * config's list through core's ONE registration step (`registerComponents`, the
+ * same call the studio registry and the Next host make — EC-591), so a duplicate,
+ * a role claim and an `invalid-implementation` are the identical issue in
+ * `registry.issues` on every surface.
  */
 export function previewRegistryFromConfig(config) {
-    const { manifests, implementations, issues } = previewComponentsFromConfig(config);
-    const registry = new ComponentRegistry(manifests);
-    registry.issues.push(...issues);
-    return { registry, implementations };
+    return registerComponents(previewComponentsFromConfig(config));
 }
 /**
  * Enumerate every generated-preview entry for a config: canvas-eligible
@@ -68,7 +47,7 @@ export function previewRegistryFromConfig(config) {
  * deterministic regardless of registration order.
  */
 export function previewEntriesForConfig(config) {
-    const { manifests } = previewComponentsFromConfig(config);
+    const manifests = previewRegistryFromConfig(config).registry.list();
     const entries = [];
     for (const manifest of [...manifests].sort((a, b) => a.id.localeCompare(b.id))) {
         if (!isCanvasEligible(manifest))

package/dist/previews/enumerate.js.map

@@ -1 +1 @@
-{"version":3,"file":"enumerate.js","sourceRoot":"","sources":["../../src/previews/enumerate.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ComponentType } from 'react'\nimport { ComponentRegistry, isCanvasEligible } from '@elytracms/core/component-registry'\nimport type {\n  ComponentFixture,\n  ComponentIssue,\n  ComponentManifest,\n} from '@elytracms/core/component-registry'\nimport { basePrimitives, getImplementation, registerImplementations } from '@elytracms/core/runtime-renderer'\nimport type { ComponentImplementations } from '@elytracms/core/runtime-renderer'\nimport { resolveWorkspaceConfig } from '@elytracms/core/studio-core'\nimport type { HostComponentEntry } from '@elytracms/core/studio-core'\nimport { DEFAULT_VARIANT } from '../components/builder/blocks-model'\nimport type { StudioRegistry } from '../lib/registry'\n\n/**\n * EC-440 — the fixture-preview enumeration behind `elytra previews`. ONE\n * source of truth for \"which previews exist\" shared by the CLI's node-side\n * driver (hashing, staleness `--check`) and the browser render harness\n * ({@link import('./harness').mountPreviewHarness}) — both derive the entry\n * set from the consumer's `elytra.config.ts` default export through here, so\n * generation, staleness checking, and rendering can never disagree.\n *\n * DATA-FREE by construction: this module reads the consumer CONFIG (registry\n * manifests + implementations — code), never a persistence adapter, auth, or\n * content data. The entry set mirrors the blocks panel exactly (EC-439): every\n * canvas-eligible manifest, one entry per declared fixture, and a single\n * implicit {@link DEFAULT_VARIANT} entry for fixture-less manifests. Base\n * primitives are included — they are insertable tiles too. Layout-helper\n * presets are NOT manifests and keep their placeholder treatment.\n */\n\n/** One renderable preview: a component fixture plus its staleness-hash inputs. */\nexport interface PreviewEntrySpec {\n  componentId: string\n  /** The fixture name, or {@link DEFAULT_VARIANT} for a fixture-less manifest. */\n  fixture: string\n  /**\n   * The DECLARED render inputs the CLI hashes per entry for staleness: the\n   * manifest's prop + slot shape (defaults live in the prop field-defs, so\n   * seeded renders are covered) and the declared fixture's own\n   * props/slotChildren (`fixture: null` for the implicit Default variant). A\n   * change here re-renders one entry.\n   *\n   * NOT in here: the component implementation and the theme — a config arrives\n   * evaluated, so neither has a per-entry identity. The CLI covers them as\n   * manifest-level render dependencies instead (EC-600: content hashes of the\n   * project source files the config imports plus the theme `@import` chain),\n   * and a change there re-renders every entry. Before EC-600 this comment said\n   * regeneration caught such drift; it did not — regeneration only rendered what\n   * this hash called stale.\n   */\n  hashInput: {\n    manifest: { props: ComponentManifest['props']; slots: ComponentManifest['slots'] }\n    fixture: {\n      props: NonNullable<ComponentFixture['props']> | null\n      slotChildren: NonNullable<ComponentFixture['slotChildren']> | null\n    } | null\n  }\n}\n\n/**\n * The component set a config carries, as the harness registry input: the base\n * primitives plus every resolved project's `components` entries, deduped by\n * component id (first declaration wins — the generated-preview seam is keyed\n * by component id alone, so one image serves every project that registers the\n * id). A config that fails shape-resolution contributes no project components\n * — the primitives still enumerate, and the CLI surfaces config problems\n * through the studio/doctor, not here.\n *\n * EC-555: the kept entries' implementations (`unknown` in the config) go through\n * core's one registration step, like the studio registry's and the Next host's —\n * a non-component is withheld (its preview renders the missing-component\n * fallback, never `createElement`) and returned as an `invalid-implementation`\n * issue. The first-wins dedupe runs BEFORE the check, so a withheld entry still\n * claims its id.\n */\nexport function previewComponentsFromConfig(config: unknown): {\n  manifests: ComponentManifest[]\n  implementations: ComponentImplementations\n  issues: ComponentIssue[]\n} {\n  const base = basePrimitives()\n  const manifests: ComponentManifest[] = [...base.manifests]\n  const implementations: Record<string, ComponentType<Record<string, unknown>>> = {}\n  for (const manifest of base.manifests) {\n    const implementation = getImplementation(base.implementations, manifest.id)\n    if (implementation) implementations[manifest.id] = implementation\n  }\n  const seen = new Set(manifests.map((m) => m.id))\n\n  const kept: HostComponentEntry[] = []\n  const resolved = resolveWorkspaceConfig(config)\n  for (const project of resolved.projects) {\n    for (const entry of project.components ?? []) {\n      if (seen.has(entry.manifest.id)) continue\n      seen.add(entry.manifest.id)\n      manifests.push(entry.manifest)\n      kept.push(entry)\n    }\n  }\n  // Ids are unique by construction here (deduped against the primitives too),\n  // so the merge order below decides nothing.\n  const project = registerImplementations(kept)\n  return {\n    manifests,\n    implementations: { ...implementations, ...project.implementations },\n    issues: project.issues,\n  }\n}\n\n/**\n * The {@link StudioRegistry}-shaped registry the harness renders against. Its\n * `registry.issues` carries the implementation issues too — the same list the\n * studio registry records them into (EC-555).\n */\nexport function previewRegistryFromConfig(config: unknown): StudioRegistry {\n  const { manifests, implementations, issues } = previewComponentsFromConfig(config)\n  const registry = new ComponentRegistry(manifests)\n  registry.issues.push(...issues)\n  return { registry, implementations }\n}\n\n/**\n * Enumerate every generated-preview entry for a config: canvas-eligible\n * manifests only (server-only components never render on the client canvas),\n * one entry per declared fixture in declaration order, else one implicit\n * {@link DEFAULT_VARIANT} entry. Components are sorted by id so the output —\n * and everything the CLI derives from it (manifest JSON, file writes) — is\n * deterministic regardless of registration order.\n */\nexport function previewEntriesForConfig(config: unknown): PreviewEntrySpec[] {\n  const { manifests } = previewComponentsFromConfig(config)\n  const entries: PreviewEntrySpec[] = []\n  for (const manifest of [...manifests].sort((a, b) => a.id.localeCompare(b.id))) {\n    if (!isCanvasEligible(manifest)) continue\n    const manifestShape = { props: manifest.props, slots: manifest.slots }\n    if (manifest.fixtures && manifest.fixtures.length > 0) {\n      for (const fixture of manifest.fixtures) {\n        entries.push({\n          componentId: manifest.id,\n          fixture: fixture.name,\n          hashInput: {\n            manifest: manifestShape,\n            fixture: { props: fixture.props ?? null, slotChildren: fixture.slotChildren ?? null },\n          },\n        })\n      }\n    } else {\n      entries.push({\n        componentId: manifest.id,\n        fixture: DEFAULT_VARIANT,\n        hashInput: { manifest: manifestShape, fixture: null },\n      })\n    }\n  }\n  return entries\n}\n"]}
+{"version":3,"file":"enumerate.js","sourceRoot":"","sources":["../../src/previews/enumerate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAErE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAkDpE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAe;IACzD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAA;IACtC,MAAM,OAAO,GAAqB,EAAE,CAAA;IACpC,KAAK,MAAM,OAAO,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC9D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;YAC7C,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAQ;YAC7B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAe;IACvD,OAAO,kBAAkB,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAA;AAChE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAe;IACrD,MAAM,SAAS,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;IACnE,MAAM,OAAO,GAAuB,EAAE,CAAA;IACtC,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC/E,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC;YAAE,SAAQ;QACzC,MAAM,aAAa,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAA;QACtE,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtD,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACxC,OAAO,CAAC,IAAI,CAAC;oBACX,WAAW,EAAE,QAAQ,CAAC,EAAE;oBACxB,OAAO,EAAE,OAAO,CAAC,IAAI;oBACrB,SAAS,EAAE;wBACT,QAAQ,EAAE,aAAa;wBACvB,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI,EAAE;qBACtF;iBACF,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC;gBACX,WAAW,EAAE,QAAQ,CAAC,EAAE;gBACxB,OAAO,EAAE,eAAe;gBACxB,SAAS,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE;aACtD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC","sourcesContent":["import { isCanvasEligible } from '@elytracms/core/component-registry'\nimport type { ComponentFixture, ComponentManifest } from '@elytracms/core/component-registry'\nimport { registerComponents } from '@elytracms/core/runtime-renderer'\nimport type { ComponentEntry } from '@elytracms/core/runtime-renderer'\nimport { resolveWorkspaceConfig } from '@elytracms/core/studio-core'\nimport { DEFAULT_VARIANT } from '../components/builder/blocks-model'\nimport type { StudioRegistry } from '../lib/registry'\n\n/**\n * EC-440 — the fixture-preview enumeration behind `elytra previews`. ONE\n * source of truth for \"which previews exist\" shared by the CLI's node-side\n * driver (hashing, staleness `--check`) and the browser render harness\n * ({@link import('./harness').mountPreviewHarness}) — both derive the entry\n * set from the consumer's `elytra.config.ts` default export through here, so\n * generation, staleness checking, and rendering can never disagree.\n *\n * DATA-FREE by construction: this module reads the consumer CONFIG (registry\n * manifests + implementations — code), never a persistence adapter, auth, or\n * content data. The entry set mirrors the blocks panel exactly (EC-439): every\n * canvas-eligible manifest, one entry per declared fixture, and a single\n * implicit {@link DEFAULT_VARIANT} entry for fixture-less manifests. Exactly the\n * config's components — the engine adds none (EC-591; the shipped components are\n * there when the config lists `@elytracms/components`). Layout-helper presets are\n * NOT manifests and keep their placeholder treatment.\n */\n\n/** One renderable preview: a component fixture plus its staleness-hash inputs. */\nexport interface PreviewEntrySpec {\n  componentId: string\n  /** The fixture name, or {@link DEFAULT_VARIANT} for a fixture-less manifest. */\n  fixture: string\n  /**\n   * The DECLARED render inputs the CLI hashes per entry for staleness: the\n   * manifest's prop + slot shape (defaults live in the prop field-defs, so\n   * seeded renders are covered) and the declared fixture's own\n   * props/slotChildren (`fixture: null` for the implicit Default variant). A\n   * change here re-renders one entry.\n   *\n   * NOT in here: the component implementation and the theme — a config arrives\n   * evaluated, so neither has a per-entry identity. The CLI covers them as\n   * manifest-level render dependencies instead (EC-600: content hashes of the\n   * project source files the config imports plus the theme `@import` chain),\n   * and a change there re-renders every entry. Before EC-600 this comment said\n   * regeneration caught such drift; it did not — regeneration only rendered what\n   * this hash called stale.\n   */\n  hashInput: {\n    manifest: { props: ComponentManifest['props']; slots: ComponentManifest['slots'] }\n    fixture: {\n      props: NonNullable<ComponentFixture['props']> | null\n      slotChildren: NonNullable<ComponentFixture['slotChildren']> | null\n    } | null\n  }\n}\n\n/**\n * The component list a config carries, as the harness registry input: every\n * resolved project's `components`, concatenated in project order. An entry two\n * projects share (the same `{ manifest, implementation }` object — e.g. both list\n * `...elytraComponents`) is the SAME component and is kept once; two DIFFERENT\n * entries under one id are a real conflict — the generated-preview seam is keyed\n * by component id alone, so one image would serve both — and go to the one\n * registration rule like any duplicate: the first is kept whole, the second is a\n * `duplicate-id` issue (EC-591; before, previews skipped it silently and showed\n * the first project's render in the second project's tile — COMPOSITION #13).\n * A config that fails shape-resolution contributes no components; the CLI\n * surfaces config problems through the studio/doctor, not here.\n */\nexport function previewComponentsFromConfig(config: unknown): readonly ComponentEntry[] {\n  const seen = new Set<ComponentEntry>()\n  const entries: ComponentEntry[] = []\n  for (const project of resolveWorkspaceConfig(config).projects) {\n    for (const entry of project.components ?? []) {\n      if (seen.has(entry)) continue\n      seen.add(entry)\n      entries.push(entry)\n    }\n  }\n  return entries\n}\n\n/**\n * The {@link StudioRegistry}-shaped registry the harness renders against: the\n * config's list through core's ONE registration step (`registerComponents`, the\n * same call the studio registry and the Next host make — EC-591), so a duplicate,\n * a role claim and an `invalid-implementation` are the identical issue in\n * `registry.issues` on every surface.\n */\nexport function previewRegistryFromConfig(config: unknown): StudioRegistry {\n  return registerComponents(previewComponentsFromConfig(config))\n}\n\n/**\n * Enumerate every generated-preview entry for a config: canvas-eligible\n * manifests only (server-only components never render on the client canvas),\n * one entry per declared fixture in declaration order, else one implicit\n * {@link DEFAULT_VARIANT} entry. Components are sorted by id so the output —\n * and everything the CLI derives from it (manifest JSON, file writes) — is\n * deterministic regardless of registration order.\n */\nexport function previewEntriesForConfig(config: unknown): PreviewEntrySpec[] {\n  const manifests = previewRegistryFromConfig(config).registry.list()\n  const entries: PreviewEntrySpec[] = []\n  for (const manifest of [...manifests].sort((a, b) => a.id.localeCompare(b.id))) {\n    if (!isCanvasEligible(manifest)) continue\n    const manifestShape = { props: manifest.props, slots: manifest.slots }\n    if (manifest.fixtures && manifest.fixtures.length > 0) {\n      for (const fixture of manifest.fixtures) {\n        entries.push({\n          componentId: manifest.id,\n          fixture: fixture.name,\n          hashInput: {\n            manifest: manifestShape,\n            fixture: { props: fixture.props ?? null, slotChildren: fixture.slotChildren ?? null },\n          },\n        })\n      }\n    } else {\n      entries.push({\n        componentId: manifest.id,\n        fixture: DEFAULT_VARIANT,\n        hashInput: { manifest: manifestShape, fixture: null },\n      })\n    }\n  }\n  return entries\n}\n"]}

package/dist/previews/harness.js

@@ -71,7 +71,7 @@ function nodeForEntry(studio, componentId, fixture) {
     if (declared)
         return { node: fixtureSubtree(studio, manifest, declared, `preview-${componentId}`).node };
     if (fixture === DEFAULT_VARIANT && (manifest.fixtures ?? []).length === 0) {
-        return { node: seededNodeFromManifest(manifest) };
+        return { node: seededNodeFromManifest(manifest, studio.registry) };
     }
     return { error: `Unknown fixture "${fixture}" for component "${componentId}".` };
 }