@elytracms/studio 0.0.69 → 0.0.70

package/dist/components/app-views/studio-config.d.ts

@@ -2,6 +2,7 @@ import type { ReactNode } from 'react';
 import type { FieldDef } from '@elytracms/core/cms-core';
 import type { StudioI18nConfig } from '@elytracms/studio/lib/i18n';
 import type { StudioAiConfig } from '@elytracms/studio/lib/ai';
+import type { GeneratedPreviewLookup } from '../builder/blocks-model.js';
 import type { SidebarNode } from './module.js';
 /**
  * EC-236 — the studio customization config: the single, studio-only home for
@@ -68,6 +69,27 @@ export interface StudioConfig {
      * separate key).
      */
     canvas?: StudioCanvasTheme;
+    /**
+     * Insert-menu preview artifacts (EC-439, the seam EC-440 fills): where the
+     * studio's blocks panel finds GENERATED preview images for component
+     * fixtures. Studio-only (from `defineStudio`, never the delivery bundle) and
+     * fully optional — absent, tiles fall back from a curated
+     * `manifest.previewImage` straight to the icon+name placeholder. The EC-440
+     * CLI (`elytra previews`) renders fixtures headlessly against the consumer
+     * theme and writes a previews manifest; the consumer adapts that manifest
+     * into `previews.generated` here.
+     */
+    previews?: StudioPreviewsConfig;
+}
+/**
+ * The generated-preview seam (EC-439 AD-2). `generated` is a PURE lookup —
+ * component id + fixture name → image URL (`undefined` = no artifact). A
+ * fixture-less component's single implicit variant is looked up under the
+ * fixture name `'Default'`. Curated `manifest.previewImage` always wins over
+ * this lookup; the lookup wins over the placeholder.
+ */
+export interface StudioPreviewsConfig {
+    generated?: GeneratedPreviewLookup;
 }
 /**
  * The canvas page-surface theme (EC-389). Both knobs target the preview iframe

package/dist/components/app-views/studio-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"studio-config.js","sourceRoot":"","sources":["../../../src/components/app-views/studio-config.ts"],"names":[],"mappings":"AA6GA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import type { ReactNode } from 'react'\nimport type { FieldDef } from '@elytracms/core/cms-core'\nimport type { StudioI18nConfig } from '@elytracms/studio/lib/i18n'\nimport type { StudioAiConfig } from '@elytracms/studio/lib/ai'\nimport type { SidebarNode } from './module'\n\n/**\n * EC-236 — the studio customization config: the single, studio-only home for\n * everything a consuming repo customizes about the builder UI.\n *\n * This is the \"separate studio-only config solution\": it lives in the consumer's\n * `studio.config.tsx`, is `defineStudio({...})`-typed, and is passed to\n * `createStudio(config, studioConfig)` at the mount — NEVER mixed into the shared\n * `elytra.config.ts`, so the live React it carries (views, icons, field renderers,\n * future branding) never reaches the `frontend/` delivery bundle.\n *\n * The customization PRINCIPLE it embodies: customization is **code passed\n * directly**, not data referenced by a string key. Every field here holds live\n * values/components by reference — `sidebar` is built from `nav.*` view objects,\n * `fieldRenderers` maps a control name to a component. The only string indirection\n * in the whole surface is `fieldRenderers`' key, and ONLY because its other end\n * (`form.control` on a field) lives in the delivery-shared serializable schema and\n * cannot import studio code. This config grows by adding direct-value keys\n * (branding/logo/panels/theme), never by adding registries.\n */\nexport interface StudioConfig {\n  /**\n   * The section rail (EC-237) as an ordered list of `nav.*` nodes — views, groups,\n   * and separators. Omitted → the studio derives the default rail from its built-in\n   * views. A rail node carries its view object directly; there are no string ids to\n   * keep in sync.\n   */\n  sidebar?: SidebarNode[]\n  /**\n   * Custom field renderers (EC-238) keyed by CONTROL name (`form.control`), each a\n   * React component replacing the built-in document-editor control. A field opts in\n   * per-field via `form: { control: '<name>' }` — so a renderer targets exactly the\n   * fields that ask for it, not every field of a datatype. This is the one\n   * boundary-crossing seam: the field names its control by string in the shared\n   * schema, this map binds that name to a studio-only component.\n   */\n  fieldRenderers?: Record<string, CustomFieldRenderer>\n  /**\n   * Studio-UI localization (EC-241): the default locale + imported translation\n   * catalogs. English is the built-in source; a consumer adds e.g.\n   * `i18n: { locales: { de: deMessages } }` and the studio chrome renders in the\n   * browser's preferred locale (no persisted selector in v1). Studio-only — never\n   * reaches the delivery bundle. Schema labels localize separately, via a\n   * `LocalizedString` on the field/collection def.\n   */\n  i18n?: StudioI18nConfig\n  /**\n   * AI platform (EC-331): provider, project knowledge, and soft limits. The block's\n   * PRESENCE enables the AI feature; its ABSENCE means the feature is fully absent —\n   * no AI UI and no AI dependencies on the critical path (the runtime lives behind a\n   * lazy boundary in `@elytracms/studio/lib/ai`, only reached when configured).\n   * `enabled: false` is a temporary kill-switch. Studio-only live code (holds the\n   * provider adapter + knowledge functions) — never reaches the delivery bundle.\n   * Validated at load by `resolveAiConfig` (capability gate: tool calling + structured\n   * output required, fail-loud).\n   */\n  ai?: StudioAiConfig\n  /**\n   * Canvas page-surface theming (EC-389): make the preview iframe wear the SITE's\n   * chrome. Direct values (no registries): body classes + raw CSS, injected LAST\n   * into the canvas iframe — after the studio defaults and an instantiated starter\n   * kit's `tokensCss` — so consumer values win the cascade. This themes the canvas\n   * PAGE surface only, never the studio chrome (branding/logo theming is a future,\n   * separate key).\n   */\n  canvas?: StudioCanvasTheme\n}\n\n/**\n * The canvas page-surface theme (EC-389). Both knobs target the preview iframe\n * document — the isolated page the builder renders into — so a site whose theme\n * styles `body` (background, color, font) previews exactly as it delivers.\n */\nexport interface StudioCanvasTheme {\n  /**\n   * REPLACES the studio's default canvas body classes\n   * (`bg-background text-foreground font-sans`). The default's utility classes\n   * out-cascade a site theme's `@layer base body` rules (Tailwind layers lose to\n   * later layers/un-layered styles), which is exactly how a site's page background\n   * used to paint white in the canvas — pass `''` to drop the default entirely and\n   * let the site's own `body` rules (from the canvas stylesheet) take over, or\n   * pass your own classes. Omitted → the studio default stays.\n   */\n  bodyClassName?: string\n  /**\n   * Raw CSS injected into the canvas iframe as the LAST style element — after the\n   * canvas stylesheet, the studio editing chrome, and a kit's `tokensCss` — so it\n   * wins the cascade over all of them (an un-layered `body { background: … }` or a\n   * `:root { --token: … }` override both work). The kit seam keeps working: a kit\n   * provides, this overrides.\n   */\n  tokensCss?: string\n}\n\n/** The props a custom field renderer receives — identical to the built-in control. */\nexport interface CustomFieldRendererProps {\n  field: FieldDef\n  value: unknown\n  onChange: (value: unknown) => void\n  readOnly: boolean\n  id: string\n}\nexport type CustomFieldRenderer = (props: CustomFieldRendererProps) => ReactNode\n\n/**\n * Typed identity helper for `studio.config.tsx` — keeps the config declarative\n * (like {@link import('@elytracms/core/studio-core').defineElytraConfig}). No\n * validation here; the studio resolves + validates the sidebar and field renderers\n * through the EC-236 seam at mount, surfacing every issue visibly (never throws).\n *\n * @example\n * ```tsx\n * // studio.config.tsx\n * import { defineStudio, nav } from '@elytracms/studio/customization'\n * import { ColorField } from './fields/color'\n *\n * export default defineStudio({\n *   sidebar: [\n *     nav.cms({ label: 'Content' }),\n *     nav.group('Catalog', [\n *       nav.cms({ label: 'Catalog', collections: ['product', 'productCategory'] }),\n *       nav.cms({ label: 'Categories', collection: 'productCategory' }),\n *     ]),\n *     nav.separator(),\n *     nav.assets(),\n *     nav.settings(),\n *   ],\n *   fieldRenderers: { color: ColorField },\n * })\n * ```\n */\nexport function defineStudio(config: StudioConfig): StudioConfig {\n  return config\n}\n"]}
+{"version":3,"file":"studio-config.js","sourceRoot":"","sources":["../../../src/components/app-views/studio-config.ts"],"names":[],"mappings":"AAoIA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import type { ReactNode } from 'react'\nimport type { FieldDef } from '@elytracms/core/cms-core'\nimport type { StudioI18nConfig } from '@elytracms/studio/lib/i18n'\nimport type { StudioAiConfig } from '@elytracms/studio/lib/ai'\nimport type { GeneratedPreviewLookup } from '../builder/blocks-model'\nimport type { SidebarNode } from './module'\n\n/**\n * EC-236 — the studio customization config: the single, studio-only home for\n * everything a consuming repo customizes about the builder UI.\n *\n * This is the \"separate studio-only config solution\": it lives in the consumer's\n * `studio.config.tsx`, is `defineStudio({...})`-typed, and is passed to\n * `createStudio(config, studioConfig)` at the mount — NEVER mixed into the shared\n * `elytra.config.ts`, so the live React it carries (views, icons, field renderers,\n * future branding) never reaches the `frontend/` delivery bundle.\n *\n * The customization PRINCIPLE it embodies: customization is **code passed\n * directly**, not data referenced by a string key. Every field here holds live\n * values/components by reference — `sidebar` is built from `nav.*` view objects,\n * `fieldRenderers` maps a control name to a component. The only string indirection\n * in the whole surface is `fieldRenderers`' key, and ONLY because its other end\n * (`form.control` on a field) lives in the delivery-shared serializable schema and\n * cannot import studio code. This config grows by adding direct-value keys\n * (branding/logo/panels/theme), never by adding registries.\n */\nexport interface StudioConfig {\n  /**\n   * The section rail (EC-237) as an ordered list of `nav.*` nodes — views, groups,\n   * and separators. Omitted → the studio derives the default rail from its built-in\n   * views. A rail node carries its view object directly; there are no string ids to\n   * keep in sync.\n   */\n  sidebar?: SidebarNode[]\n  /**\n   * Custom field renderers (EC-238) keyed by CONTROL name (`form.control`), each a\n   * React component replacing the built-in document-editor control. A field opts in\n   * per-field via `form: { control: '<name>' }` — so a renderer targets exactly the\n   * fields that ask for it, not every field of a datatype. This is the one\n   * boundary-crossing seam: the field names its control by string in the shared\n   * schema, this map binds that name to a studio-only component.\n   */\n  fieldRenderers?: Record<string, CustomFieldRenderer>\n  /**\n   * Studio-UI localization (EC-241): the default locale + imported translation\n   * catalogs. English is the built-in source; a consumer adds e.g.\n   * `i18n: { locales: { de: deMessages } }` and the studio chrome renders in the\n   * browser's preferred locale (no persisted selector in v1). Studio-only — never\n   * reaches the delivery bundle. Schema labels localize separately, via a\n   * `LocalizedString` on the field/collection def.\n   */\n  i18n?: StudioI18nConfig\n  /**\n   * AI platform (EC-331): provider, project knowledge, and soft limits. The block's\n   * PRESENCE enables the AI feature; its ABSENCE means the feature is fully absent —\n   * no AI UI and no AI dependencies on the critical path (the runtime lives behind a\n   * lazy boundary in `@elytracms/studio/lib/ai`, only reached when configured).\n   * `enabled: false` is a temporary kill-switch. Studio-only live code (holds the\n   * provider adapter + knowledge functions) — never reaches the delivery bundle.\n   * Validated at load by `resolveAiConfig` (capability gate: tool calling + structured\n   * output required, fail-loud).\n   */\n  ai?: StudioAiConfig\n  /**\n   * Canvas page-surface theming (EC-389): make the preview iframe wear the SITE's\n   * chrome. Direct values (no registries): body classes + raw CSS, injected LAST\n   * into the canvas iframe — after the studio defaults and an instantiated starter\n   * kit's `tokensCss` — so consumer values win the cascade. This themes the canvas\n   * PAGE surface only, never the studio chrome (branding/logo theming is a future,\n   * separate key).\n   */\n  canvas?: StudioCanvasTheme\n  /**\n   * Insert-menu preview artifacts (EC-439, the seam EC-440 fills): where the\n   * studio's blocks panel finds GENERATED preview images for component\n   * fixtures. Studio-only (from `defineStudio`, never the delivery bundle) and\n   * fully optional — absent, tiles fall back from a curated\n   * `manifest.previewImage` straight to the icon+name placeholder. The EC-440\n   * CLI (`elytra previews`) renders fixtures headlessly against the consumer\n   * theme and writes a previews manifest; the consumer adapts that manifest\n   * into `previews.generated` here.\n   */\n  previews?: StudioPreviewsConfig\n}\n\n/**\n * The generated-preview seam (EC-439 AD-2). `generated` is a PURE lookup —\n * component id + fixture name → image URL (`undefined` = no artifact). A\n * fixture-less component's single implicit variant is looked up under the\n * fixture name `'Default'`. Curated `manifest.previewImage` always wins over\n * this lookup; the lookup wins over the placeholder.\n */\nexport interface StudioPreviewsConfig {\n  generated?: GeneratedPreviewLookup\n}\n\n/**\n * The canvas page-surface theme (EC-389). Both knobs target the preview iframe\n * document — the isolated page the builder renders into — so a site whose theme\n * styles `body` (background, color, font) previews exactly as it delivers.\n */\nexport interface StudioCanvasTheme {\n  /**\n   * REPLACES the studio's default canvas body classes\n   * (`bg-background text-foreground font-sans`). The default's utility classes\n   * out-cascade a site theme's `@layer base body` rules (Tailwind layers lose to\n   * later layers/un-layered styles), which is exactly how a site's page background\n   * used to paint white in the canvas — pass `''` to drop the default entirely and\n   * let the site's own `body` rules (from the canvas stylesheet) take over, or\n   * pass your own classes. Omitted → the studio default stays.\n   */\n  bodyClassName?: string\n  /**\n   * Raw CSS injected into the canvas iframe as the LAST style element — after the\n   * canvas stylesheet, the studio editing chrome, and a kit's `tokensCss` — so it\n   * wins the cascade over all of them (an un-layered `body { background: … }` or a\n   * `:root { --token: … }` override both work). The kit seam keeps working: a kit\n   * provides, this overrides.\n   */\n  tokensCss?: string\n}\n\n/** The props a custom field renderer receives — identical to the built-in control. */\nexport interface CustomFieldRendererProps {\n  field: FieldDef\n  value: unknown\n  onChange: (value: unknown) => void\n  readOnly: boolean\n  id: string\n}\nexport type CustomFieldRenderer = (props: CustomFieldRendererProps) => ReactNode\n\n/**\n * Typed identity helper for `studio.config.tsx` — keeps the config declarative\n * (like {@link import('@elytracms/core/studio-core').defineElytraConfig}). No\n * validation here; the studio resolves + validates the sidebar and field renderers\n * through the EC-236 seam at mount, surfacing every issue visibly (never throws).\n *\n * @example\n * ```tsx\n * // studio.config.tsx\n * import { defineStudio, nav } from '@elytracms/studio/customization'\n * import { ColorField } from './fields/color'\n *\n * export default defineStudio({\n *   sidebar: [\n *     nav.cms({ label: 'Content' }),\n *     nav.group('Catalog', [\n *       nav.cms({ label: 'Catalog', collections: ['product', 'productCategory'] }),\n *       nav.cms({ label: 'Categories', collection: 'productCategory' }),\n *     ]),\n *     nav.separator(),\n *     nav.assets(),\n *     nav.settings(),\n *   ],\n *   fieldRenderers: { color: ColorField },\n * })\n * ```\n */\nexport function defineStudio(config: StudioConfig): StudioConfig {\n  return config\n}\n"]}

package/dist/components/builder/blocks-model.d.ts

@@ -2,40 +2,84 @@ import type { ComponentNode } from '@elytracms/core/project-graph';
 import type { ComponentFixture, ComponentManifest } from '@elytracms/core/component-registry';
 import type { StudioRegistry } from '@elytracms/studio/lib/registry';
 /**
- * Blocks panel model (EC-164) — the pure, React-free derivation behind the
- * visual insert surface. Every registry manifest yields one tile per declared
- * fixture (or a single default-props tile), grouped by manifest `category`
- * and filtered by a free-text query over name / description / category — no
- * hand-maintained panel config. Broken fixtures degrade to tiles carrying
- * explicit `issues`, never to a missing entry or a crash.
+ * Blocks panel model (EC-164, reshaped by EC-439) — the pure, React-free
+ * derivation behind the visual insert surface. Every canvas-eligible registry
+ * manifest yields **one tile** carrying the component identity plus a
+ * `variants` list (one per declared fixture, or a single implicit `Default`
+ * variant built from the seeded manifest defaults). Tiles group by manifest
+ * `category` and filter by a free-text query over name / description /
+ * category / **fixture names** — no hand-maintained panel config. Broken
+ * fixtures degrade to variants carrying explicit `issues`, never to a missing
+ * entry or a crash.
+ *
+ * Previews are ARTIFACTS, never runtime renders (EC-439 AD-2). Per tile and
+ * per variant, `previewUrl` resolves: curated `manifest.previewImage` (EC-409,
+ * always wins) → the {@link GeneratedPreviewLookup} seam (EC-440's build-time
+ * fixture renders) → `undefined` (the panel shows an icon+name placeholder).
  */
-/** One insertable tile in the blocks panel. */
+/**
+ * The generated-preview seam (EC-439 AD-2, filled by EC-440): a pure lookup
+ * from component id + fixture name to an image URL. The EC-440 CLI renders
+ * every canvas-eligible component's fixtures headlessly against the consumer
+ * theme and writes a previews manifest; the consumer's `studio.config.tsx`
+ * adapts that manifest into this function via `defineStudio({ previews:
+ * { generated } })`. A fixture-less manifest's single implicit variant is
+ * looked up under the name {@link DEFAULT_VARIANT}. Empty/undefined everywhere
+ * until EC-440 lands — the panel then falls back to placeholders.
+ */
+export type GeneratedPreviewLookup = (componentId: string, fixtureName: string) => string | undefined;
+/**
+ * The implicit variant name of a fixture-less manifest (and the fixture name
+ * a {@link GeneratedPreviewLookup} is queried with for it).
+ */
+export declare const DEFAULT_VARIANT = "Default";
+/**
+ * One insertable variant of a component tile: a declared manifest fixture, or
+ * the single implicit `Default` for a fixture-less manifest. `variants[0]` is
+ * the tile's default — what tile click / Enter / drag inserts.
+ */
+export interface BlockVariant {
+    /** The fixture name, or {@link DEFAULT_VARIANT} for the implicit variant. */
+    name: string;
+    /**
+     * Validation problems for this variant (manifest-level statuses plus the
+     * fixture's own issues). A non-empty list marks the variant as degraded —
+     * it still lists and still inserts.
+     */
+    issues: string[];
+    /**
+     * Resolved preview image URL: curated `manifest.previewImage` (wins) else
+     * the generated-preview lookup's URL for this fixture. `undefined` → the
+     * panel renders the icon+name placeholder.
+     */
+    previewUrl?: string;
+    /** Build the subtree this variant inserts (ids are reassigned on insert). */
+    build: () => ComponentNode;
+}
+/** One component (or layout preset) in the blocks panel — ONE tile per component (EC-439 AD-1). */
 export interface BlockTile {
-    /** Stable identity (`<componentId>::<variant>` or `preset::<key>`). */
+    /** Stable identity: the component id, or `preset::<key>` for layout helpers. */
     key: string;
     /** Component id of the node the tile inserts. */
     componentId: string;
     title: string;
-    /** Variation label: the fixture name, `Default`, or a preset description. */
-    variant: string;
     description?: string;
     /**
-     * Validation problems detected while building the preview (unknown child
-     * component, undeclared slot, invalid fixture prop, missing
-     * implementation). A non-empty list marks the tile as degraded — it still
-     * renders and still inserts.
+     * The DEFAULT variant's validation problems — what clicking the tile
+     * inserts. Per-variant issues live on {@link BlockTile.variants}.
      */
     issues: string[];
-    /** Deterministic-id subtree rendered live in the tile thumbnail. */
-    previewNode: ComponentNode;
+    /** The default variant's resolved preview URL (see {@link BlockVariant.previewUrl}). */
+    previewUrl?: string;
+    /** All insertable variants; `variants[0]` is the default the tile inserts. */
+    variants: BlockVariant[];
     /**
-     * Curated preview image URL (EC-409, `manifest.previewImage`). When set, the
-     * tile renders this image instead of the live `previewNode` render — the
-     * escape hatch for components whose real render needs data/context (e.g.
-     * listings) and previews as "just text". Insertion is unaffected.
+     * Fixture names the active query matched (stamped by {@link blockGroups}
+     * when a query is present) — the panel highlights the variant affordance and
+     * the matching flyout rows so "found by fixture name" is visible.
      */
-    previewImage?: string;
-    /** Build the subtree to insert (ids are reassigned by the builder store). */
+    matchedVariants?: string[];
+    /** Build the DEFAULT subtree to insert: the first declared fixture's, else the seeded manifest default. */
     build: () => ComponentNode;
 }
 /** Tiles of one manifest `category`. */
@@ -44,7 +88,7 @@ export interface BlockGroup {
     tiles: BlockTile[];
 }
 export interface BlockFilter {
-    /** Case-insensitive match over id, title, description, and category. */
+    /** Case-insensitive match over id, title, description, category, and fixture names. */
     query?: string;
     /** When set, only these component ids may be inserted (slot.allow). */
     slotAllow?: string[];
@@ -72,14 +116,31 @@ export declare function fixtureSubtree(studio: StudioRegistry, manifest: Compone
     node: ComponentNode;
     issues: string[];
 };
-/** All tiles for one manifest: one per fixture, else a single default tile. */
-export declare function tilesForManifest(studio: StudioRegistry, manifest: ComponentManifest): BlockTile[];
+/**
+ * The ONE tile for a manifest (EC-439 AD-1): component identity plus one
+ * variant per declared fixture — or a single implicit `Default` variant using
+ * the seeded manifest default (a bare layout container is seeded so it
+ * survives EC-161 normalization instead of vanishing on commit, EC-383). The
+ * tile's own `issues`/`previewUrl`/`build` mirror the default variant
+ * (`variants[0]`), so tile click/Enter/drag inserts exactly what the first
+ * fixture tile inserted before the reshape.
+ */
+export declare function tileForManifest(studio: StudioRegistry, manifest: ComponentManifest, generatedPreview?: GeneratedPreviewLookup): BlockTile;
+/**
+ * A two-letter monogram from a tile title — the deliberate icon+name
+ * placeholder glyph (EC-439 AD-2 tier 3) for tiles with neither a curated nor
+ * a generated preview image: first letters of the first two words, else the
+ * first two letters of a single word. Deterministic and pure.
+ */
+export declare function tileMonogram(title: string): string;
 /**
  * Derive the panel's category groups from the registry: filter by slot allow
- * list and query, expand manifests into tiles, group by `category`, and sort
+ * list and query, derive ONE tile per manifest, group by `category`, and sort
  * categories alphabetically (registry order within a group). Deterministic.
+ * When a query is active, each tile is stamped with the fixture names it
+ * matched (see {@link BlockTile.matchedVariants}).
  */
-export declare function blockGroups(studio: StudioRegistry, filter?: BlockFilter): BlockGroup[];
+export declare function blockGroups(studio: StudioRegistry, filter?: BlockFilter, generatedPreview?: GeneratedPreviewLookup): BlockGroup[];
 /**
  * Whether ANY component could be inserted under a slot allow-list (EC-405) — the
  * cheap existence check behind the canvas insertion affordances: a "+" only shows
@@ -92,7 +153,8 @@ export declare function blockGroups(studio: StudioRegistry, filter?: BlockFilter
  */
 export declare function hasInsertableComponent(studio: StudioRegistry, slotAllow?: string[]): boolean;
 /**
- * Layout helper presets (EC-067) as panel tiles. Preview nodes are re-id'd
- * deterministically so sibling React keys stay unique.
+ * Layout helper presets (EC-067) as panel tiles — already one tile per preset.
+ * A preset has a single implicit variant and never a preview image, so its
+ * tile renders the placeholder treatment.
  */
 export declare function presetTiles(slotAllow?: string[]): BlockTile[];

package/dist/components/builder/blocks-model.js

@@ -1,10 +1,14 @@
-import { cloneWithNewIds, isLayoutContainerId } from '@elytracms/core/project-graph';
 import { isCanvasEligible, manifestSlots, propValueValidator } from '@elytracms/core/component-registry';
 import { localizedStringVariants } from '@elytracms/core/cms-core';
 import { localizedLabel } from '@elytracms/studio/lib/i18n';
 import { componentStatus } from '@elytracms/studio/lib/registry';
-import { nodeFromProps, previewSpecs } from '@elytracms/studio/lib/registry/preview';
+import { nodeFromProps } from '@elytracms/studio/lib/registry/preview';
 import { LAYOUT_PRESETS, nodeFromManifest, seededNodeFromManifest } from './node-factory.js';
+/**
+ * The implicit variant name of a fixture-less manifest (and the fixture name
+ * a {@link GeneratedPreviewLookup} is queried with for it).
+ */
+export const DEFAULT_VARIANT = 'Default';
 /**
  * Intersect two component-id allow-lists. `undefined` means "no constraint from
  * this source", so the result is the other list (copied); two present lists yield
@@ -25,13 +29,6 @@ export function intersectAllow(slotAllow, fieldAllow) {
     return slotAllow.filter((id) => inField.has(id));
 }
 const UNCATEGORIZED = 'other';
-function prefixedCounter(prefix) {
-    let n = 0;
-    return () => {
-        n += 1;
-        return `${prefix}-${n}`;
-    };
-}
 /** A node built from a manifest's defaults with an explicit id. */
 function defaultNode(manifest, id) {
     return { ...nodeFromManifest(manifest), id };
@@ -94,64 +91,90 @@ export function fixtureSubtree(studio, manifest, fixture, baseId) {
     }
     return { node, issues };
 }
-/** All tiles for one manifest: one per fixture, else a single default tile. */
-export function tilesForManifest(studio, manifest) {
+/**
+ * The ONE tile for a manifest (EC-439 AD-1): component identity plus one
+ * variant per declared fixture — or a single implicit `Default` variant using
+ * the seeded manifest default (a bare layout container is seeded so it
+ * survives EC-161 normalization instead of vanishing on commit, EC-383). The
+ * tile's own `issues`/`previewUrl`/`build` mirror the default variant
+ * (`variants[0]`), so tile click/Enter/drag inserts exactly what the first
+ * fixture tile inserted before the reshape.
+ */
+export function tileForManifest(studio, manifest, generatedPreview) {
     const title = localizedLabel(manifest.title, manifest.id);
     const baseIssues = manifestIssues(studio, manifest);
-    if (!manifest.fixtures || manifest.fixtures.length === 0) {
-        // No declared fixtures: insert the manifest defaults, seeding layout
-        // containers so a bare Stack/Grid survives EC-161 normalization instead of
-        // vanishing on commit (EC-383). Preview from the seeded node for containers
-        // (WYSIWYG with the insert) and from the shared preview specs otherwise
-        // (authored primitive previews or plain defaults).
-        const previewNode = isLayoutContainerId(manifest.id)
-            ? cloneWithNewIds(seededNodeFromManifest(manifest), prefixedCounter(`preview-${manifest.id}`))
-            : previewSpecs(manifest)[0].node;
-        return [
+    // EC-409: a curated preview image previews the COMPONENT, not one fixture —
+    // when declared it wins on the tile and on every variant row (AD-2 tier 1).
+    const curated = manifest.previewImage;
+    const variants = manifest.fixtures && manifest.fixtures.length > 0
+        ? manifest.fixtures.map((fixture, index) => {
+            const { issues } = fixtureSubtree(studio, manifest, fixture, `probe-${manifest.id}-${index}`);
+            return {
+                name: fixture.name,
+                issues: [...baseIssues, ...issues],
+                ...previewUrlEntry(curated ?? generatedPreview?.(manifest.id, fixture.name)),
+                build: () => fixtureSubtree(studio, manifest, fixture, 'tmp').node,
+            };
+        })
+        : [
             {
-                key: `${manifest.id}::default`,
-                componentId: manifest.id,
-                title,
-                variant: 'Default',
-                description: manifest.description,
+                name: DEFAULT_VARIANT,
                 issues: baseIssues,
-                previewNode,
-                // EC-409: the curated preview image (when declared) replaces the live
-                // render on EVERY tile of the manifest — it previews the component,
-                // not one fixture variation.
-                ...(manifest.previewImage ? { previewImage: manifest.previewImage } : {}),
+                ...previewUrlEntry(curated ?? generatedPreview?.(manifest.id, DEFAULT_VARIANT)),
                 build: () => seededNodeFromManifest(manifest),
             },
         ];
-    }
-    return manifest.fixtures.map((fixture, index) => {
-        const { node, issues } = fixtureSubtree(studio, manifest, fixture, `preview-${manifest.id}-${index}`);
-        return {
-            key: `${manifest.id}::${fixture.name}`,
-            componentId: manifest.id,
-            title,
-            variant: fixture.name,
-            description: manifest.description,
-            issues: [...baseIssues, ...issues],
-            previewNode: node,
-            ...(manifest.previewImage ? { previewImage: manifest.previewImage } : {}),
-            build: () => fixtureSubtree(studio, manifest, fixture, 'tmp').node,
-        };
-    });
+    const defaultVariant = variants[0];
+    return {
+        key: manifest.id,
+        componentId: manifest.id,
+        title,
+        description: manifest.description,
+        issues: defaultVariant.issues,
+        ...previewUrlEntry(defaultVariant.previewUrl),
+        variants,
+        build: defaultVariant.build,
+    };
+}
+/** Spreadable `{ previewUrl }` entry — omitted (not `undefined`-valued) when absent. */
+function previewUrlEntry(url) {
+    return url === undefined ? {} : { previewUrl: url };
+}
+/**
+ * A two-letter monogram from a tile title — the deliberate icon+name
+ * placeholder glyph (EC-439 AD-2 tier 3) for tiles with neither a curated nor
+ * a generated preview image: first letters of the first two words, else the
+ * first two letters of a single word. Deterministic and pure.
+ */
+export function tileMonogram(title) {
+    const words = title.trim().split(/\s+/).filter(Boolean);
+    if (words.length === 0)
+        return '?';
+    const glyph = words.length === 1 ? words[0].slice(0, 2) : `${words[0].charAt(0)}${words[1].charAt(0)}`;
+    return glyph.toUpperCase();
+}
+function matchedFixtureNames(manifest, query) {
+    return (manifest.fixtures ?? [])
+        .map((fixture) => fixture.name)
+        .filter((name) => name.toLowerCase().includes(query));
 }
 function matches(manifest, query) {
     const hay = [manifest.id, ...localizedStringVariants(manifest.title), manifest.description, manifest.category]
         .filter(Boolean)
         .join(' ')
         .toLowerCase();
-    return hay.includes(query);
+    // EC-439: fixture names are searchable too — a content-seeded fixture name
+    // ("Startseite") must find its component even when no manifest field matches.
+    return hay.includes(query) || matchedFixtureNames(manifest, query).length > 0;
 }
 /**
  * Derive the panel's category groups from the registry: filter by slot allow
- * list and query, expand manifests into tiles, group by `category`, and sort
+ * list and query, derive ONE tile per manifest, group by `category`, and sort
  * categories alphabetically (registry order within a group). Deterministic.
+ * When a query is active, each tile is stamped with the fixture names it
+ * matched (see {@link BlockTile.matchedVariants}).
  */
-export function blockGroups(studio, filter = {}) {
+export function blockGroups(studio, filter = {}, generatedPreview) {
     const query = filter.query?.trim().toLowerCase();
     const allow = filter.slotAllow;
     const groups = new Map();
@@ -165,9 +188,15 @@ export function blockGroups(studio, filter = {}) {
             continue;
         if (query && !matches(manifest, query))
             continue;
+        const tile = tileForManifest(studio, manifest, generatedPreview);
+        if (query) {
+            const matched = matchedFixtureNames(manifest, query);
+            if (matched.length > 0)
+                tile.matchedVariants = matched;
+        }
         const category = manifest.category ?? UNCATEGORIZED;
         const tiles = groups.get(category) ?? [];
-        tiles.push(...tilesForManifest(studio, manifest));
+        tiles.push(tile);
         groups.set(category, tiles);
     }
     return [...groups.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([category, tiles]) => ({ category, tiles }));
@@ -193,18 +222,18 @@ export function hasInsertableComponent(studio, slotAllow) {
     return presetTiles(slotAllow).length > 0;
 }
 /**
- * Layout helper presets (EC-067) as panel tiles. Preview nodes are re-id'd
- * deterministically so sibling React keys stay unique.
+ * Layout helper presets (EC-067) as panel tiles — already one tile per preset.
+ * A preset has a single implicit variant and never a preview image, so its
+ * tile renders the placeholder treatment.
  */
 export function presetTiles(slotAllow) {
     return LAYOUT_PRESETS.filter((preset) => !slotAllow || slotAllow.includes(preset.build().componentId)).map((preset) => ({
         key: `preset::${preset.key}`,
         componentId: preset.build().componentId,
         title: preset.label,
-        variant: preset.description,
         description: preset.description,
         issues: [],
-        previewNode: cloneWithNewIds(preset.build(), prefixedCounter(`preview-preset-${preset.key}`)),
+        variants: [{ name: DEFAULT_VARIANT, issues: [], build: () => preset.build() }],
         build: () => preset.build(),
     }));
 }

package/dist/components/builder/blocks-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"blocks-model.js","sourceRoot":"","sources":["../../../src/components/builder/blocks-model.ts"],"names":[],"mappings":"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","sourcesContent":["import { cloneWithNewIds, isLayoutContainerId } from '@elytracms/core/project-graph'\nimport type { ComponentNode } from '@elytracms/core/project-graph'\nimport type { ComponentFixture, ComponentManifest } from '@elytracms/core/component-registry'\nimport { isCanvasEligible, manifestSlots, propValueValidator } from '@elytracms/core/component-registry'\nimport { localizedStringVariants } from '@elytracms/core/cms-core'\nimport { localizedLabel } from '@elytracms/studio/lib/i18n'\nimport { componentStatus } from '@elytracms/studio/lib/registry'\nimport type { StudioRegistry } from '@elytracms/studio/lib/registry'\nimport { nodeFromProps, previewSpecs } from '@elytracms/studio/lib/registry/preview'\nimport { LAYOUT_PRESETS, nodeFromManifest, seededNodeFromManifest } from './node-factory'\n\n/**\n * Blocks panel model (EC-164) — the pure, React-free derivation behind the\n * visual insert surface. Every registry manifest yields one tile per declared\n * fixture (or a single default-props tile), grouped by manifest `category`\n * and filtered by a free-text query over name / description / category — no\n * hand-maintained panel config. Broken fixtures degrade to tiles carrying\n * explicit `issues`, never to a missing entry or a crash.\n */\n\n/** One insertable tile in the blocks panel. */\nexport interface BlockTile {\n  /** Stable identity (`<componentId>::<variant>` or `preset::<key>`). */\n  key: string\n  /** Component id of the node the tile inserts. */\n  componentId: string\n  title: string\n  /** Variation label: the fixture name, `Default`, or a preset description. */\n  variant: string\n  description?: string\n  /**\n   * Validation problems detected while building the preview (unknown child\n   * component, undeclared slot, invalid fixture prop, missing\n   * implementation). A non-empty list marks the tile as degraded — it still\n   * renders and still inserts.\n   */\n  issues: string[]\n  /** Deterministic-id subtree rendered live in the tile thumbnail. */\n  previewNode: ComponentNode\n  /**\n   * Curated preview image URL (EC-409, `manifest.previewImage`). When set, the\n   * tile renders this image instead of the live `previewNode` render — the\n   * escape hatch for components whose real render needs data/context (e.g.\n   * listings) and previews as \"just text\". Insertion is unaffected.\n   */\n  previewImage?: string\n  /** Build the subtree to insert (ids are reassigned by the builder store). */\n  build: () => ComponentNode\n}\n\n/** Tiles of one manifest `category`. */\nexport interface BlockGroup {\n  category: string\n  tiles: BlockTile[]\n}\n\nexport interface BlockFilter {\n  /** Case-insensitive match over id, title, description, and category. */\n  query?: string\n  /** When set, only these component ids may be inserted (slot.allow). */\n  slotAllow?: string[]\n}\n\n/**\n * Intersect two component-id allow-lists. `undefined` means \"no constraint from\n * this source\", so the result is the other list (copied); two present lists yield\n * their set intersection, preserving the first list's order. This layers a\n * composition field's top-level `allow` vocabulary over a slot's positional\n * `allow` at the canvas root (EC-188): a component must satisfy BOTH leashes to be\n * offered. An empty array stays empty (\"allow nothing\"); callers wanting the\n * validator's \"empty = allow any\" must coalesce `[]` to `undefined` first (which\n * `resolveInsertContext` does via its `length > 0` guard, mirroring\n * `validateCompositionValue`).\n */\nexport function intersectAllow(\n  slotAllow: readonly string[] | undefined,\n  fieldAllow: readonly string[] | undefined,\n): string[] | undefined {\n  if (!slotAllow) return fieldAllow ? [...fieldAllow] : undefined\n  if (!fieldAllow) return [...slotAllow]\n  const inField = new Set(fieldAllow)\n  return slotAllow.filter((id) => inField.has(id))\n}\n\nconst UNCATEGORIZED = 'other'\n\nfunction prefixedCounter(prefix: string): () => string {\n  let n = 0\n  return () => {\n    n += 1\n    return `${prefix}-${n}`\n  }\n}\n\n/** A node built from a manifest's defaults with an explicit id. */\nfunction defaultNode(manifest: ComponentManifest, id: string): ComponentNode {\n  return { ...nodeFromManifest(manifest), id }\n}\n\n/** Structured issues for a component that cannot render (EC-055 statuses). */\nfunction manifestIssues(studio: StudioRegistry, manifest: ComponentManifest): string[] {\n  const status = componentStatus(studio, manifest)\n  if (status === 'incompatible') {\n    return [`No implementation is registered for \"${manifest.id}\".`]\n  }\n  if (status === 'invalid') {\n    return studio.registry.issues.filter((issue) => issue.componentId === manifest.id).map((issue) => issue.message)\n  }\n  return []\n}\n\n/**\n * Build the configured subtree a fixture describes: manifest defaults overlaid\n * with the fixture's props, plus one default-props child node per\n * `slotChildren` component id. Never throws — unknown components, undeclared\n * slots, and invalid prop values become entries in `issues` while the node is\n * still produced (the renderer shows its own visible fallbacks for them).\n */\nexport function fixtureSubtree(\n  studio: StudioRegistry,\n  manifest: ComponentManifest,\n  fixture: ComponentFixture,\n  baseId: string,\n): { node: ComponentNode; issues: string[] } {\n  const issues: string[] = []\n  const fixtureProps = fixture.props ?? {}\n\n  for (const [name, value] of Object.entries(fixtureProps)) {\n    const spec = manifest.props[name]\n    if (!spec) {\n      issues.push(`Fixture \"${fixture.name}\" sets unknown prop \"${name}\".`)\n      continue\n    }\n    // EC-190: validate the fixture value with the prop's field-def validator.\n    if (!(propValueValidator(manifest, name)?.(value) ?? true)) {\n      issues.push(`Fixture \"${fixture.name}\" sets an invalid value for prop \"${name}\".`)\n    }\n  }\n\n  const node = nodeFromProps(manifest, fixtureProps, baseId)\n\n  if (fixture.slotChildren) {\n    // EC-386: blocks-prop regions are declared slots too (`manifestSlots`), so a\n    // fixture may seed a Section-style body without a false \"undeclared slot\" issue.\n    const declared = new Set(manifestSlots(manifest).map((slot) => slot.name))\n    const slots: NonNullable<ComponentNode['slots']> = {}\n    for (const [slotName, childIds] of Object.entries(fixture.slotChildren)) {\n      if (!declared.has(slotName)) {\n        issues.push(`Fixture \"${fixture.name}\" fills undeclared slot \"${slotName}\".`)\n      }\n      slots[slotName] = childIds.map((childId, index) => {\n        const id = `${baseId}-${slotName}-${index}`\n        const childManifest = studio.registry.getManifest(childId)\n        if (!childManifest) {\n          issues.push(`Fixture \"${fixture.name}\" references unknown component \"${childId}\" in slot \"${slotName}\".`)\n          // Keep the reference: the renderer shows a visible missing-component fallback.\n          return { id, componentId: childId }\n        }\n        return defaultNode(childManifest, id)\n      })\n    }\n    if (Object.keys(slots).length > 0) node.slots = slots\n  }\n\n  return { node, issues }\n}\n\n/** All tiles for one manifest: one per fixture, else a single default tile. */\nexport function tilesForManifest(studio: StudioRegistry, manifest: ComponentManifest): BlockTile[] {\n  const title = localizedLabel(manifest.title, manifest.id)\n  const baseIssues = manifestIssues(studio, manifest)\n\n  if (!manifest.fixtures || manifest.fixtures.length === 0) {\n    // No declared fixtures: insert the manifest defaults, seeding layout\n    // containers so a bare Stack/Grid survives EC-161 normalization instead of\n    // vanishing on commit (EC-383). Preview from the seeded node for containers\n    // (WYSIWYG with the insert) and from the shared preview specs otherwise\n    // (authored primitive previews or plain defaults).\n    const previewNode = isLayoutContainerId(manifest.id)\n      ? cloneWithNewIds(seededNodeFromManifest(manifest), prefixedCounter(`preview-${manifest.id}`))\n      : previewSpecs(manifest)[0]!.node\n    return [\n      {\n        key: `${manifest.id}::default`,\n        componentId: manifest.id,\n        title,\n        variant: 'Default',\n        description: manifest.description,\n        issues: baseIssues,\n        previewNode,\n        // EC-409: the curated preview image (when declared) replaces the live\n        // render on EVERY tile of the manifest — it previews the component,\n        // not one fixture variation.\n        ...(manifest.previewImage ? { previewImage: manifest.previewImage } : {}),\n        build: () => seededNodeFromManifest(manifest),\n      },\n    ]\n  }\n\n  return manifest.fixtures.map((fixture, index) => {\n    const { node, issues } = fixtureSubtree(studio, manifest, fixture, `preview-${manifest.id}-${index}`)\n    return {\n      key: `${manifest.id}::${fixture.name}`,\n      componentId: manifest.id,\n      title,\n      variant: fixture.name,\n      description: manifest.description,\n      issues: [...baseIssues, ...issues],\n      previewNode: node,\n      ...(manifest.previewImage ? { previewImage: manifest.previewImage } : {}),\n      build: () => fixtureSubtree(studio, manifest, fixture, 'tmp').node,\n    }\n  })\n}\n\nfunction matches(manifest: ComponentManifest, query: string): boolean {\n  const hay = [manifest.id, ...localizedStringVariants(manifest.title), manifest.description, manifest.category]\n    .filter(Boolean)\n    .join(' ')\n    .toLowerCase()\n  return hay.includes(query)\n}\n\n/**\n * Derive the panel's category groups from the registry: filter by slot allow\n * list and query, expand manifests into tiles, group by `category`, and sort\n * categories alphabetically (registry order within a group). Deterministic.\n */\nexport function blockGroups(studio: StudioRegistry, filter: BlockFilter = {}): BlockGroup[] {\n  const query = filter.query?.trim().toLowerCase()\n  const allow = filter.slotAllow\n\n  const groups = new Map<string, BlockTile[]>()\n  for (const manifest of studio.registry.list()) {\n    // EC-191: the canvas is client-rendered, so only canvas-eligible\n    // (client-renderable) components are offered for insertion; server-only / RSC\n    // components are usable in dev frames, not placed on the canvas.\n    if (!isCanvasEligible(manifest)) continue\n    if (allow && !allow.includes(manifest.id)) continue\n    if (query && !matches(manifest, query)) continue\n    const category = manifest.category ?? UNCATEGORIZED\n    const tiles = groups.get(category) ?? []\n    tiles.push(...tilesForManifest(studio, manifest))\n    groups.set(category, tiles)\n  }\n\n  return [...groups.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([category, tiles]) => ({ category, tiles }))\n}\n\n/**\n * Whether ANY component could be inserted under a slot allow-list (EC-405) — the\n * cheap existence check behind the canvas insertion affordances: a \"+\" only shows\n * at a position where the blocks panel would offer at least one tile. Mirrors the\n * exact filter {@link blockGroups} applies (canvas-eligible AND, when an allow-list\n * is present, on that list), short-circuiting on the first match instead of\n * building tiles; falls back to the layout-helper presets (which are also\n * insertable there). `undefined`/absent `slotAllow` means \"allow any\" → true when\n * the registry has any canvas-eligible component.\n */\nexport function hasInsertableComponent(studio: StudioRegistry, slotAllow?: string[]): boolean {\n  for (const manifest of studio.registry.list()) {\n    if (!isCanvasEligible(manifest)) continue\n    if (slotAllow && !slotAllow.includes(manifest.id)) continue\n    return true\n  }\n  return presetTiles(slotAllow).length > 0\n}\n\n/**\n * Layout helper presets (EC-067) as panel tiles. Preview nodes are re-id'd\n * deterministically so sibling React keys stay unique.\n */\nexport function presetTiles(slotAllow?: string[]): BlockTile[] {\n  return LAYOUT_PRESETS.filter((preset) => !slotAllow || slotAllow.includes(preset.build().componentId)).map(\n    (preset) => ({\n      key: `preset::${preset.key}`,\n      componentId: preset.build().componentId,\n      title: preset.label,\n      variant: preset.description,\n      description: preset.description,\n      issues: [],\n      previewNode: cloneWithNewIds(preset.build(), prefixedCounter(`preview-preset-${preset.key}`)),\n      build: () => preset.build(),\n    }),\n  )\n}\n"]}
+{"version":3,"file":"blocks-model.js","sourceRoot":"","sources":["../../../src/components/builder/blocks-model.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ComponentNode } from '@elytracms/core/project-graph'\nimport type { ComponentFixture, ComponentManifest } from '@elytracms/core/component-registry'\nimport { isCanvasEligible, manifestSlots, propValueValidator } from '@elytracms/core/component-registry'\nimport { localizedStringVariants } from '@elytracms/core/cms-core'\nimport { localizedLabel } from '@elytracms/studio/lib/i18n'\nimport { componentStatus } from '@elytracms/studio/lib/registry'\nimport type { StudioRegistry } from '@elytracms/studio/lib/registry'\nimport { nodeFromProps } from '@elytracms/studio/lib/registry/preview'\nimport { LAYOUT_PRESETS, nodeFromManifest, seededNodeFromManifest } from './node-factory'\n\n/**\n * Blocks panel model (EC-164, reshaped by EC-439) — the pure, React-free\n * derivation behind the visual insert surface. Every canvas-eligible registry\n * manifest yields **one tile** carrying the component identity plus a\n * `variants` list (one per declared fixture, or a single implicit `Default`\n * variant built from the seeded manifest defaults). Tiles group by manifest\n * `category` and filter by a free-text query over name / description /\n * category / **fixture names** — no hand-maintained panel config. Broken\n * fixtures degrade to variants carrying explicit `issues`, never to a missing\n * entry or a crash.\n *\n * Previews are ARTIFACTS, never runtime renders (EC-439 AD-2). Per tile and\n * per variant, `previewUrl` resolves: curated `manifest.previewImage` (EC-409,\n * always wins) → the {@link GeneratedPreviewLookup} seam (EC-440's build-time\n * fixture renders) → `undefined` (the panel shows an icon+name placeholder).\n */\n\n/**\n * The generated-preview seam (EC-439 AD-2, filled by EC-440): a pure lookup\n * from component id + fixture name to an image URL. The EC-440 CLI renders\n * every canvas-eligible component's fixtures headlessly against the consumer\n * theme and writes a previews manifest; the consumer's `studio.config.tsx`\n * adapts that manifest into this function via `defineStudio({ previews:\n * { generated } })`. A fixture-less manifest's single implicit variant is\n * looked up under the name {@link DEFAULT_VARIANT}. Empty/undefined everywhere\n * until EC-440 lands — the panel then falls back to placeholders.\n */\nexport type GeneratedPreviewLookup = (componentId: string, fixtureName: string) => string | undefined\n\n/**\n * The implicit variant name of a fixture-less manifest (and the fixture name\n * a {@link GeneratedPreviewLookup} is queried with for it).\n */\nexport const DEFAULT_VARIANT = 'Default'\n\n/**\n * One insertable variant of a component tile: a declared manifest fixture, or\n * the single implicit `Default` for a fixture-less manifest. `variants[0]` is\n * the tile's default — what tile click / Enter / drag inserts.\n */\nexport interface BlockVariant {\n  /** The fixture name, or {@link DEFAULT_VARIANT} for the implicit variant. */\n  name: string\n  /**\n   * Validation problems for this variant (manifest-level statuses plus the\n   * fixture's own issues). A non-empty list marks the variant as degraded —\n   * it still lists and still inserts.\n   */\n  issues: string[]\n  /**\n   * Resolved preview image URL: curated `manifest.previewImage` (wins) else\n   * the generated-preview lookup's URL for this fixture. `undefined` → the\n   * panel renders the icon+name placeholder.\n   */\n  previewUrl?: string\n  /** Build the subtree this variant inserts (ids are reassigned on insert). */\n  build: () => ComponentNode\n}\n\n/** One component (or layout preset) in the blocks panel — ONE tile per component (EC-439 AD-1). */\nexport interface BlockTile {\n  /** Stable identity: the component id, or `preset::<key>` for layout helpers. */\n  key: string\n  /** Component id of the node the tile inserts. */\n  componentId: string\n  title: string\n  description?: string\n  /**\n   * The DEFAULT variant's validation problems — what clicking the tile\n   * inserts. Per-variant issues live on {@link BlockTile.variants}.\n   */\n  issues: string[]\n  /** The default variant's resolved preview URL (see {@link BlockVariant.previewUrl}). */\n  previewUrl?: string\n  /** All insertable variants; `variants[0]` is the default the tile inserts. */\n  variants: BlockVariant[]\n  /**\n   * Fixture names the active query matched (stamped by {@link blockGroups}\n   * when a query is present) — the panel highlights the variant affordance and\n   * the matching flyout rows so \"found by fixture name\" is visible.\n   */\n  matchedVariants?: string[]\n  /** Build the DEFAULT subtree to insert: the first declared fixture's, else the seeded manifest default. */\n  build: () => ComponentNode\n}\n\n/** Tiles of one manifest `category`. */\nexport interface BlockGroup {\n  category: string\n  tiles: BlockTile[]\n}\n\nexport interface BlockFilter {\n  /** Case-insensitive match over id, title, description, category, and fixture names. */\n  query?: string\n  /** When set, only these component ids may be inserted (slot.allow). */\n  slotAllow?: string[]\n}\n\n/**\n * Intersect two component-id allow-lists. `undefined` means \"no constraint from\n * this source\", so the result is the other list (copied); two present lists yield\n * their set intersection, preserving the first list's order. This layers a\n * composition field's top-level `allow` vocabulary over a slot's positional\n * `allow` at the canvas root (EC-188): a component must satisfy BOTH leashes to be\n * offered. An empty array stays empty (\"allow nothing\"); callers wanting the\n * validator's \"empty = allow any\" must coalesce `[]` to `undefined` first (which\n * `resolveInsertContext` does via its `length > 0` guard, mirroring\n * `validateCompositionValue`).\n */\nexport function intersectAllow(\n  slotAllow: readonly string[] | undefined,\n  fieldAllow: readonly string[] | undefined,\n): string[] | undefined {\n  if (!slotAllow) return fieldAllow ? [...fieldAllow] : undefined\n  if (!fieldAllow) return [...slotAllow]\n  const inField = new Set(fieldAllow)\n  return slotAllow.filter((id) => inField.has(id))\n}\n\nconst UNCATEGORIZED = 'other'\n\n/** A node built from a manifest's defaults with an explicit id. */\nfunction defaultNode(manifest: ComponentManifest, id: string): ComponentNode {\n  return { ...nodeFromManifest(manifest), id }\n}\n\n/** Structured issues for a component that cannot render (EC-055 statuses). */\nfunction manifestIssues(studio: StudioRegistry, manifest: ComponentManifest): string[] {\n  const status = componentStatus(studio, manifest)\n  if (status === 'incompatible') {\n    return [`No implementation is registered for \"${manifest.id}\".`]\n  }\n  if (status === 'invalid') {\n    return studio.registry.issues.filter((issue) => issue.componentId === manifest.id).map((issue) => issue.message)\n  }\n  return []\n}\n\n/**\n * Build the configured subtree a fixture describes: manifest defaults overlaid\n * with the fixture's props, plus one default-props child node per\n * `slotChildren` component id. Never throws — unknown components, undeclared\n * slots, and invalid prop values become entries in `issues` while the node is\n * still produced (the renderer shows its own visible fallbacks for them).\n */\nexport function fixtureSubtree(\n  studio: StudioRegistry,\n  manifest: ComponentManifest,\n  fixture: ComponentFixture,\n  baseId: string,\n): { node: ComponentNode; issues: string[] } {\n  const issues: string[] = []\n  const fixtureProps = fixture.props ?? {}\n\n  for (const [name, value] of Object.entries(fixtureProps)) {\n    const spec = manifest.props[name]\n    if (!spec) {\n      issues.push(`Fixture \"${fixture.name}\" sets unknown prop \"${name}\".`)\n      continue\n    }\n    // EC-190: validate the fixture value with the prop's field-def validator.\n    if (!(propValueValidator(manifest, name)?.(value) ?? true)) {\n      issues.push(`Fixture \"${fixture.name}\" sets an invalid value for prop \"${name}\".`)\n    }\n  }\n\n  const node = nodeFromProps(manifest, fixtureProps, baseId)\n\n  if (fixture.slotChildren) {\n    // EC-386: blocks-prop regions are declared slots too (`manifestSlots`), so a\n    // fixture may seed a Section-style body without a false \"undeclared slot\" issue.\n    const declared = new Set(manifestSlots(manifest).map((slot) => slot.name))\n    const slots: NonNullable<ComponentNode['slots']> = {}\n    for (const [slotName, childIds] of Object.entries(fixture.slotChildren)) {\n      if (!declared.has(slotName)) {\n        issues.push(`Fixture \"${fixture.name}\" fills undeclared slot \"${slotName}\".`)\n      }\n      slots[slotName] = childIds.map((childId, index) => {\n        const id = `${baseId}-${slotName}-${index}`\n        const childManifest = studio.registry.getManifest(childId)\n        if (!childManifest) {\n          issues.push(`Fixture \"${fixture.name}\" references unknown component \"${childId}\" in slot \"${slotName}\".`)\n          // Keep the reference: the renderer shows a visible missing-component fallback.\n          return { id, componentId: childId }\n        }\n        return defaultNode(childManifest, id)\n      })\n    }\n    if (Object.keys(slots).length > 0) node.slots = slots\n  }\n\n  return { node, issues }\n}\n\n/**\n * The ONE tile for a manifest (EC-439 AD-1): component identity plus one\n * variant per declared fixture — or a single implicit `Default` variant using\n * the seeded manifest default (a bare layout container is seeded so it\n * survives EC-161 normalization instead of vanishing on commit, EC-383). The\n * tile's own `issues`/`previewUrl`/`build` mirror the default variant\n * (`variants[0]`), so tile click/Enter/drag inserts exactly what the first\n * fixture tile inserted before the reshape.\n */\nexport function tileForManifest(\n  studio: StudioRegistry,\n  manifest: ComponentManifest,\n  generatedPreview?: GeneratedPreviewLookup,\n): BlockTile {\n  const title = localizedLabel(manifest.title, manifest.id)\n  const baseIssues = manifestIssues(studio, manifest)\n  // EC-409: a curated preview image previews the COMPONENT, not one fixture —\n  // when declared it wins on the tile and on every variant row (AD-2 tier 1).\n  const curated = manifest.previewImage\n\n  const variants: BlockVariant[] =\n    manifest.fixtures && manifest.fixtures.length > 0\n      ? manifest.fixtures.map((fixture, index) => {\n          const { issues } = fixtureSubtree(studio, manifest, fixture, `probe-${manifest.id}-${index}`)\n          return {\n            name: fixture.name,\n            issues: [...baseIssues, ...issues],\n            ...previewUrlEntry(curated ?? generatedPreview?.(manifest.id, fixture.name)),\n            build: () => fixtureSubtree(studio, manifest, fixture, 'tmp').node,\n          }\n        })\n      : [\n          {\n            name: DEFAULT_VARIANT,\n            issues: baseIssues,\n            ...previewUrlEntry(curated ?? generatedPreview?.(manifest.id, DEFAULT_VARIANT)),\n            build: () => seededNodeFromManifest(manifest),\n          },\n        ]\n\n  const defaultVariant = variants[0]!\n  return {\n    key: manifest.id,\n    componentId: manifest.id,\n    title,\n    description: manifest.description,\n    issues: defaultVariant.issues,\n    ...previewUrlEntry(defaultVariant.previewUrl),\n    variants,\n    build: defaultVariant.build,\n  }\n}\n\n/** Spreadable `{ previewUrl }` entry — omitted (not `undefined`-valued) when absent. */\nfunction previewUrlEntry(url: string | undefined): { previewUrl?: string } {\n  return url === undefined ? {} : { previewUrl: url }\n}\n\n/**\n * A two-letter monogram from a tile title — the deliberate icon+name\n * placeholder glyph (EC-439 AD-2 tier 3) for tiles with neither a curated nor\n * a generated preview image: first letters of the first two words, else the\n * first two letters of a single word. Deterministic and pure.\n */\nexport function tileMonogram(title: string): string {\n  const words = title.trim().split(/\\s+/).filter(Boolean)\n  if (words.length === 0) return '?'\n  const glyph = words.length === 1 ? words[0]!.slice(0, 2) : `${words[0]!.charAt(0)}${words[1]!.charAt(0)}`\n  return glyph.toUpperCase()\n}\n\nfunction matchedFixtureNames(manifest: ComponentManifest, query: string): string[] {\n  return (manifest.fixtures ?? [])\n    .map((fixture) => fixture.name)\n    .filter((name) => name.toLowerCase().includes(query))\n}\n\nfunction matches(manifest: ComponentManifest, query: string): boolean {\n  const hay = [manifest.id, ...localizedStringVariants(manifest.title), manifest.description, manifest.category]\n    .filter(Boolean)\n    .join(' ')\n    .toLowerCase()\n  // EC-439: fixture names are searchable too — a content-seeded fixture name\n  // (\"Startseite\") must find its component even when no manifest field matches.\n  return hay.includes(query) || matchedFixtureNames(manifest, query).length > 0\n}\n\n/**\n * Derive the panel's category groups from the registry: filter by slot allow\n * list and query, derive ONE tile per manifest, group by `category`, and sort\n * categories alphabetically (registry order within a group). Deterministic.\n * When a query is active, each tile is stamped with the fixture names it\n * matched (see {@link BlockTile.matchedVariants}).\n */\nexport function blockGroups(\n  studio: StudioRegistry,\n  filter: BlockFilter = {},\n  generatedPreview?: GeneratedPreviewLookup,\n): BlockGroup[] {\n  const query = filter.query?.trim().toLowerCase()\n  const allow = filter.slotAllow\n\n  const groups = new Map<string, BlockTile[]>()\n  for (const manifest of studio.registry.list()) {\n    // EC-191: the canvas is client-rendered, so only canvas-eligible\n    // (client-renderable) components are offered for insertion; server-only / RSC\n    // components are usable in dev frames, not placed on the canvas.\n    if (!isCanvasEligible(manifest)) continue\n    if (allow && !allow.includes(manifest.id)) continue\n    if (query && !matches(manifest, query)) continue\n    const tile = tileForManifest(studio, manifest, generatedPreview)\n    if (query) {\n      const matched = matchedFixtureNames(manifest, query)\n      if (matched.length > 0) tile.matchedVariants = matched\n    }\n    const category = manifest.category ?? UNCATEGORIZED\n    const tiles = groups.get(category) ?? []\n    tiles.push(tile)\n    groups.set(category, tiles)\n  }\n\n  return [...groups.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([category, tiles]) => ({ category, tiles }))\n}\n\n/**\n * Whether ANY component could be inserted under a slot allow-list (EC-405) — the\n * cheap existence check behind the canvas insertion affordances: a \"+\" only shows\n * at a position where the blocks panel would offer at least one tile. Mirrors the\n * exact filter {@link blockGroups} applies (canvas-eligible AND, when an allow-list\n * is present, on that list), short-circuiting on the first match instead of\n * building tiles; falls back to the layout-helper presets (which are also\n * insertable there). `undefined`/absent `slotAllow` means \"allow any\" → true when\n * the registry has any canvas-eligible component.\n */\nexport function hasInsertableComponent(studio: StudioRegistry, slotAllow?: string[]): boolean {\n  for (const manifest of studio.registry.list()) {\n    if (!isCanvasEligible(manifest)) continue\n    if (slotAllow && !slotAllow.includes(manifest.id)) continue\n    return true\n  }\n  return presetTiles(slotAllow).length > 0\n}\n\n/**\n * Layout helper presets (EC-067) as panel tiles — already one tile per preset.\n * A preset has a single implicit variant and never a preview image, so its\n * tile renders the placeholder treatment.\n */\nexport function presetTiles(slotAllow?: string[]): BlockTile[] {\n  return LAYOUT_PRESETS.filter((preset) => !slotAllow || slotAllow.includes(preset.build().componentId)).map(\n    (preset) => ({\n      key: `preset::${preset.key}`,\n      componentId: preset.build().componentId,\n      title: preset.label,\n      description: preset.description,\n      issues: [],\n      variants: [{ name: DEFAULT_VARIANT, issues: [], build: () => preset.build() }],\n      build: () => preset.build(),\n    }),\n  )\n}\n"]}

package/dist/components/builder/blocks-panel.d.ts

@@ -1,13 +1,16 @@
 import type { InsertTarget } from '@elytracms/core/project-graph';
 import type { ClipboardFragment } from '@elytracms/core/clipboard';
 import type { StudioRegistry } from '@elytracms/studio/lib/registry';
-import type { BlockTile } from './blocks-model.js';
+import type { BlockTile, BlockVariant } from './blocks-model.js';
 /**
- * Blocks panel (EC-164): the visual insert surface. Every registry component
- * and each of its fixture variations is a tile with a live, scaled render —
- * the component library *is* the insert surface. Clicking a tile inserts the
- * fixture's configured subtree through the builder's `insert` action (one
- * history entry, mirrored onto the `graph.insertNode` operation).
+ * Blocks panel (EC-164, redesigned by EC-439): the visual insert surface.
+ * Every canvas-eligible registry component is ONE tile; a component with 2+
+ * fixtures carries a compact "n variants" chip opening a flyout with one
+ * insert/copy row per fixture. Clicking a tile (or dragging it) inserts the
+ * DEFAULT — the first declared fixture's configured subtree, else the seeded
+ * manifest default — through the builder's `insert` action (one history entry).
+ * Previews are artifacts (curated `previewImage` → generated artifact →
+ * icon+name placeholder), never in-document runtime renders.
  */
 export interface InsertContext {
     target: InsertTarget;
@@ -18,13 +21,14 @@ export interface InsertContext {
 }
 /**
  * "Copy exact configuration" (EC-175, vision 3.3): the EC-174 fragment for a
- * blocks-panel tile. Tiles backed by a declared manifest fixture go through
- * `buildFragmentFromRegistryFixture` (the fixture's exact configuration);
- * preset/default tiles fragment the same subtree the tile inserts. Both paths
- * share `buildFragmentFromSubtree`, so the fragment shape — and the paste
- * path — is identical to copying a live canvas instance.
+ * blocks-panel variant. Variants backed by a declared manifest fixture go
+ * through `buildFragmentFromRegistryFixture` (the fixture's exact
+ * configuration); implicit-default and preset variants fragment the same
+ * subtree they insert. Both paths share `buildFragmentFromSubtree`, so the
+ * fragment shape — and the paste path — is identical to copying a live canvas
+ * instance.
  */
-export declare function tileFragment(studio: StudioRegistry, tile: BlockTile, projectId: string): ClipboardFragment | null;
+export declare function tileFragment(studio: StudioRegistry, tile: BlockTile, variant: BlockVariant, projectId: string): ClipboardFragment | null;
 /**
  * The Insert dialog never dismisses on pointer interactions outside its
  * content. Rows scrolled below the list's fold keep their layout position
@@ -42,3 +46,27 @@ export declare function BlocksPanel({ context, open, onOpenChange, }: {
     open: boolean;
     onOpenChange: (open: boolean) => void;
 }): import("react").JSX.Element | null;
+/**
+ * One component tile (exported for markup tests). Not a native `<button>`: the
+ * tile CONTAINS interactive controls (the copy-exact button and the variants
+ * chip), and nested `<button>`s are invalid HTML — so it stays a keyboard-
+ * operable `role="button"` element whose own key handler ignores events
+ * bubbling from those inner controls.
+ */
+export declare function BlockTileButton({ tile, onInsert, onCopy, onDragStart, onDragEnd, }: {
+    tile: BlockTile;
+    onInsert: (variant: BlockVariant) => void;
+    onCopy: (tile: BlockTile, variant: BlockVariant) => void;
+    onDragStart: (e: React.DragEvent) => void;
+    onDragEnd: () => void;
+}): import("react").JSX.Element;
+/**
+ * The flyout's variant rows (exported for markup tests): one insert row +
+ * copy-exact button per fixture (EC-175 semantics per variant). Rows matched
+ * by the active fixture-name search are highlighted.
+ */
+export declare function VariantRows({ tile, onInsert, onCopy, }: {
+    tile: BlockTile;
+    onInsert: (variant: BlockVariant) => void;
+    onCopy: (tile: BlockTile, variant: BlockVariant) => void;
+}): import("react").JSX.Element;