@cosmicdrift/kumiko-bundled-features 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # @cosmicdrift/kumiko-bundled-features
 
+## 0.4.0
+
+### Minor Changes
+
+- 825e7d2: Visual-Tree V.1.4 → V.1.6 — Feature-complete Editor + Folder-Hierarchy + Roving-tabindex.
+
+  **V.1.4** — explicit `folder?: string` Schema-Field auf text-block-entity. Slug bleibt
+  kebab-only validiert, Folder explizit gesetzt. Tree gruppiert via `groupBlocksByFolder`
+  (ersetzt `groupBlocksBySlugPrefix`). `Subscribe<T>` Signature um optional `emitError`
+  erweitert für explicit async-error-Pfade. ProviderBranch zeigt Error-Banner mit
+  Retry-Button. Drift-Test pinnt seedTextBlock-vs-set.write Slug-Validation.
+
+  **V.1.4b** — URL-State-Routing für Editor-Target via `nav.searchParams`. F5 + Back-Button
+  stellen den Editor-State wieder her. Format: `?t=text-content:edit&a_slug=...&a_lang=...`.
+  Plus `useDispatchTarget` hook ersetzt globalen `dispatchTarget` als empfohlenen Production-
+  Pfad (legacy bleibt für Test-Hooks).
+
+  **V.1.5** — Arrow-Key-Navigation (`<aside role="tree">`, ARIA-tree-Pattern) + SSE-driven
+  Tree-Refresh. `ClientFeatureDefinition.treeEntities?: string[]` listet Entity-Namen pro
+  Provider; live-events triggern provider-re-mount → Stale-Tree-state="stub"→"filled"
+  flippt nach save automatisch.
+
+  **V.1.5c+d** — Active-Node-Highlight (explicit blue + 2px border-l + scrollIntoView),
+  VS-Code-Polish (compact spacing, focus-visible, folder-icon-color text-amber, indent-
+  guides per ancestor-depth), Folder-Wrapper für legal-pages ("📁 Legal" + slug-first
+  Verschachtelung) und text-content ("📁 Content").
+
+  **V.1.6** — Multi-level Folder-Splitting (`folder="page/marketing"` → nested folders,
+  walk-or-create-pattern, folder/leaf-collision-tolerant). Roving-tabindex (nur focused-
+  treeitem hat tabIndex=0, Tab cyclt aus dem Tree raus).
+
+  35/35 kumiko check PASS, 13/13 group-blocks + 22/22 text-content integration tests grün.
+  Browser + Keyboard lokal validated.
+
+  **Breaking**: `TreeContext` Type entfernt (V.1.2 SR2-Rip — war nie genutzt). Provider sind
+  session-bound: `TreeChildrenSubscribe = () => Subscribe<T>` statt `(ctx) => Subscribe<T>`.
+
+  **V.1.7-Followups**: useEffect-deps in VisualTree-focus-init (Performance), Cancellation-
+  Token in TreeProvider's fetch (emit-after-unmount-warning), inline-rename, drag-drop,
+  file-icons per slug-extension, parent-jump bei ArrowLeft auf collapsed-item.
+
+### Patch Changes
+
+- Updated dependencies [825e7d2]
+  - @cosmicdrift/kumiko-framework@0.4.0
+  - @cosmicdrift/kumiko-dispatcher-live@0.4.0
+  - @cosmicdrift/kumiko-renderer@0.4.0
+  - @cosmicdrift/kumiko-renderer-web@0.4.0
+
 ## 0.3.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-bundled-features",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Built-in features — tenant, user, auth, delivery. The stuff you'd rewrite anyway, already typed.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -64,6 +64,8 @@
     "./text-content": "./src/text-content/index.ts",
     "./text-content/seeding": "./src/text-content/seeding.ts",
     "./text-content/web": "./src/text-content/web/index.ts",
+    "./template-resolver": "./src/template-resolver/index.ts",
+    "./renderer-foundation": "./src/renderer-foundation/index.ts",
     "./legal-pages": "./src/legal-pages/index.ts",
     "./legal-pages/web": "./src/legal-pages/web/index.ts",
     "./step-dispatcher": "./src/step-dispatcher/index.ts"
@@ -72,10 +74,10 @@
     "@aws-sdk/client-s3": "^3.1045.0",
     "@aws-sdk/lib-storage": "^3.1045.0",
     "@aws-sdk/s3-request-presigner": "^3.1045.0",
-    "@cosmicdrift/kumiko-dispatcher-live": "0.3.0",
-    "@cosmicdrift/kumiko-framework": "0.3.0",
-    "@cosmicdrift/kumiko-renderer": "0.3.0",
-    "@cosmicdrift/kumiko-renderer-web": "0.3.0",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.4.0",
+    "@cosmicdrift/kumiko-framework": "0.4.0",
+    "@cosmicdrift/kumiko-renderer": "0.4.0",
+    "@cosmicdrift/kumiko-renderer-web": "0.4.0",
     "@mollie/api-client": "^4.5.0",
     "@node-rs/argon2": "^2.0.2",
     "@types/nodemailer": "^8.0.0",

package/src/delivery/__tests__/delivery.integration.ts

@@ -27,8 +27,10 @@ import { createChannelPushFeature } from "../../channel-push/feature";
 import { createInMemoryPushTransport } from "../../channel-push/types";
 import { createConfigFeature } from "../../config/feature";
 import { configValuesTable } from "../../config/table";
+import { createRendererFoundationFeature } from "../../renderer-foundation/feature";
 import { createRendererSimpleFeature } from "../../renderer-simple/feature";
 import { simpleRenderer } from "../../renderer-simple/simple-renderer";
+import { createTemplateResolverFeature } from "../../template-resolver/feature";
 import { TenantQueries } from "../../tenant/constants";
 import { createTenantFeature } from "../../tenant/feature";
 import { tenantMembershipsTable } from "../../tenant/membership-table";
@@ -241,6 +243,8 @@ const ticketFeature = defineFeature("tickets", (r) => {
 
 const configFeature = createConfigFeature();
 const tenantFeature = createTenantFeature();
+const templateResolverFeature = createTemplateResolverFeature();
+const rendererFoundationFeature = createRendererFoundationFeature();
 const deliveryFeature = createDeliveryFeature();
 const channelInAppFeature = createChannelInAppFeature();
 const rendererSimpleFeature = createRendererSimpleFeature();
@@ -256,6 +260,8 @@ const channelPushFeature = createChannelPushFeature({
 const features = [
   configFeature,
   tenantFeature,
+  templateResolverFeature,
+  rendererFoundationFeature,
   deliveryFeature,
   channelInAppFeature,
   rendererSimpleFeature,

package/src/delivery/delivery-service.ts

@@ -18,7 +18,6 @@ import type {
   DeliveryChannel,
   DeliveryLogEntry,
   DeliveryService,
-  NotificationRenderer,
 } from "./types";
 
 export type RateLimitConfig = {
@@ -56,17 +55,10 @@ export function collectChannels(registry: Registry): DeliveryChannel[] {
   });
 }
 
-// Build renderer map from registry extension usages
-export function collectRenderers(registry: Registry): Map<string, NotificationRenderer> {
-  const usages = registry.getExtensionUsages("notificationRenderer");
-  const map = new Map<string, NotificationRenderer>();
-  for (const usage of usages) {
-    // @cast-boundary engine-payload — extension-usage carries unknown options
-    const opts = usage.options as { render: NotificationRenderer["render"] };
-    map.set(usage.entityName, { name: usage.entityName, render: opts.render });
-  }
-  return map;
-}
+// `collectRenderers` entfernt 2026-05-19: notificationRenderer-Extension-Point
+// wurde nie konsumiert (channel-email nimmt renderer als Konstruktor-Option,
+// nicht aus Extension-Usages). Multi-Kind-Plugin-Pool lebt jetzt im
+// `renderer-foundation`-Bundle via `collectRendererPlugins`.
 
 export function createDeliveryService(options: DeliveryServiceOptions): DeliveryService {
   const {

package/src/delivery/feature.ts

@@ -48,13 +48,15 @@ export function createDeliveryFeature(): FeatureDefinition {
       },
     });
 
-    // Extension points: channels and renderers register as features
+    // Extension point: delivery-channels (email/in-app/push). Renderer-
+    // Extension-Point lebt jetzt im `renderer-foundation`-Bundle als
+    // `renderer` (Multi-Kind-Plugin-Contract). delivery hostet keinen
+    // eigenen mehr — channel-email nimmt renderer als direkte
+    // Konstruktor-Option (siehe email-channel.ts), nicht via Extension-
+    // Usage. Migration 2026-05-19.
     r.extendsRegistrar("deliveryChannel", {
       onRegister: () => {},
     });
-    r.extendsRegistrar("notificationRenderer", {
-      onRegister: () => {},
-    });
 
     const handlers = {
       setPreference: r.writeHandler(setPreferenceWrite),

package/src/delivery/index.ts

@@ -8,7 +8,6 @@ export {
 } from "./constants";
 export {
   collectChannels,
-  collectRenderers,
   createDeliveryService,
   type DeliveryServiceOptions,
   type KillSwitchResolver,

package/src/legal-pages/web/client-plugin.ts

@@ -20,17 +20,57 @@ import type { TreeChildrenSubscribe, TreeNode } from "@cosmicdrift/kumiko-framew
 import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer-web";
 import { LEGAL_OPTIONAL_BLOCKS, LEGAL_REQUIRED_BLOCKS } from "../constants";
 
-const treeProvider: TreeChildrenSubscribe = (_ctx) => (emit) => {
-  const allBlocks = [...LEGAL_REQUIRED_BLOCKS, ...LEGAL_OPTIONAL_BLOCKS];
-  const nodes: readonly TreeNode[] = allBlocks.map((b) => ({
-    label: `${b.slug} (${b.lang})`,
-    target: {
-      featureId: "text-content",
-      action: "edit",
-      args: { slug: b.slug, lang: b.lang },
+const treeProvider: TreeChildrenSubscribe = () => (emit) => {
+  // V.1.5d Slug-first Verschachtelung (Variante C):
+  //   📁 Legal
+  //     📁 imprint
+  //       de
+  //       en
+  //     📁 privacy
+  //       de
+  //       en
+  //
+  // Slug ist der Übersetzungs-Anker — User pflegt DE+EN-Versionen
+  // desselben Inhalts zusammen statt nach Sprache zu gruppieren.
+  // Sub-Items sind reine Sprach-Leaves; Label = Sprache, target zeigt
+  // auf text-content:edit mit slug+lang.
+
+  // Group all blocks by slug, collect set of langs per slug.
+  const bySlug = new Map<string, string[]>();
+  for (const b of [...LEGAL_REQUIRED_BLOCKS, ...LEGAL_OPTIONAL_BLOCKS]) {
+    const langs = bySlug.get(b.slug) ?? [];
+    if (!langs.includes(b.lang)) langs.push(b.lang);
+    bySlug.set(b.slug, langs);
+  }
+
+  const slugFolders: TreeNode[] = [];
+  for (const slug of [...bySlug.keys()].sort()) {
+    const langs = bySlug.get(slug);
+    if (langs === undefined) continue;
+    const langLeaves: TreeNode[] = langs.sort().map((lang) => ({
+      label: lang,
+      target: {
+        featureId: "text-content",
+        action: "edit",
+        args: { slug, lang },
+      },
+    }));
+    slugFolders.push({
+      label: slug,
+      icon: "folder",
+      state: "filled",
+      children: langLeaves,
+    });
+  }
+
+  emit([
+    {
+      label: "Legal",
+      icon: "folder",
+      state: "filled",
+      children: slugFolders,
     },
-  }));
-  emit(nodes);
+  ]);
   return () => {};
 };
 

package/src/renderer-foundation/README.md

@@ -0,0 +1,86 @@
+# renderer-foundation
+
+Plugin-Foundation für Renderer (Notification, HTML-Mail, PDF, Image). Plugins (`renderer-simple`, `renderer-mail-html`, `renderer-puppeteer-client`) registrieren sich via `r.useExtension("renderer", "<name>", { kinds, render })`.
+
+**Plan-Doc:** [`kumiko-platform/docs/plans/features/renderer-foundation.md`](../../../../../../kumiko-platform/docs/plans/features/renderer-foundation.md)
+
+## Mount
+
+```typescript
+import {
+  collectRendererPlugins,
+  createRendererFoundationApi,
+  createRendererFoundationFeature,
+} from "@cosmicdrift/kumiko-bundled-features/renderer-foundation";
+
+const features = [
+  createTemplateResolverFeature(),
+  createRendererFoundationFeature(),
+  createRendererSimpleFeature(),   // Plugin
+  createRendererMailHtmlFeature(), // Plugin (enterprise)
+  // weitere Plugins...
+];
+
+const app = createKumikoApp({
+  features,
+  extraContext: ({ registry }) => ({
+    rendererFoundation: createRendererFoundationApi(
+      collectRendererPlugins(registry),
+    ),
+  }),
+});
+```
+
+## Konsumtion
+
+```typescript
+import { requireRendererFoundation } from "@cosmicdrift/kumiko-bundled-features/renderer-foundation";
+
+async function sendMail(ctx, tenantId) {
+  const foundation = requireRendererFoundation(ctx, "sendMail");
+  const renderer = foundation.createRendererForTenant({ tenantId, kind: "mail-html" });
+  const result = await renderer.render(
+    {
+      kind: "mail-html",
+      payload: { content: "Hello {{name}}", contentFormat: "markdown", variables: { name: "Frau Schmidt" } },
+    },
+    { db: ctx.db, registry: ctx.registry, tenantId },
+  );
+  // result.html, result.text
+}
+```
+
+Plugins ohne Service-Deps (`renderer-simple`) ignorieren den zweiten `ctx`-Parameter.
+
+## Plugin-Auswahl-Reihenfolge
+
+1. Tenant-Override (Config-Key `rendererPluginByKind`, z.B. `{ "mail-html": "mail-html" }`)
+2. `DEFAULT_PLUGIN_BY_KIND` aus constants
+3. Erstes Plugin im Pool das das kind bedient
+4. `RendererError("no_plugin_for_kind")` wenn nichts passt
+
+## Eigenes Plugin schreiben
+
+```typescript
+import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
+
+export const myRendererFeature = defineFeature("renderer-myown", (r) => {
+  r.requires("renderer-foundation");
+  r.useExtension("renderer", "myown", {
+    kinds: ["document-pdf"],
+    // ctx ist optional — nur nehmen wenn Service-Access nötig
+    render: async (req, ctx) => {
+      // ctx.db, ctx.registry, ctx.tenantId verfügbar
+      // eigene PDF-Logik
+      return { kind: "document-pdf", pdfBytes: ..., pageCount: 1, sizeBytes: ... };
+    },
+  });
+});
+```
+
+## Out-of-Scope
+
+- Template-Storage (kommt aus `template-resolver`)
+- Resource-URL-Substitution (Caller-Verantwortung: signed-URL vs. data-URI je nach kind)
+- Template-Authoring-UI — `designer`-Bundle (geplant)
+- Mail-Versand — `delivery` + `mail-transport-smtp`

package/src/renderer-foundation/__tests__/api.test.ts

@@ -0,0 +1,188 @@
+import type { TenantId } from "@cosmicdrift/kumiko-framework/engine";
+import { describe, expect, test } from "vitest";
+import { createRendererFoundationApi } from "../api";
+import {
+  type RendererContext,
+  RendererError,
+  type RendererPlugin,
+  type RenderRequest,
+  type RenderResponse,
+} from "../types";
+
+// Stub-Context für Plugin-Render-Calls in Unit-Tests. makePlugin ignoriert
+// ctx; db+registry sind hier null-cast weil Unit-Tests keinen echten
+// Stack haben — Integration-Tests (collect-plugins.integration.ts) nutzen
+// echte stack.db / stack.registry. tenantId ist valid UUID (Memory-Lesson
+// feedback_system_tenant_id_is_uuid).
+const STUB_CTX: RendererContext = {
+  db: null as never,
+  registry: null as never,
+  tenantId: "11111111-1111-4111-8111-111111111111" as TenantId,
+};
+
+// Test-Helper: minimal Plugin mit fix-Response. Mehrere im Pool für
+// Multi-Kind- + Tenant-Override-Tests.
+function makePlugin(name: string, kinds: RendererPlugin["kinds"]): RendererPlugin {
+  return {
+    name,
+    kinds,
+    render: async (req: RenderRequest): Promise<RenderResponse> => {
+      // shape-by-kind, gibt name in der response damit Tests sehen welcher plugin lief
+      switch (req.kind) {
+        case "notification":
+          return { kind: "notification", html: `from:${name}` };
+        case "mail-html":
+          return { kind: "mail-html", html: `from:${name}`, text: `from:${name}` };
+        case "document-pdf":
+          return {
+            kind: "document-pdf",
+            pdfBytes: new Uint8Array([1, 2, 3]),
+            pageCount: 1,
+            sizeBytes: 3,
+          };
+        case "image-snapshot":
+          return {
+            kind: "image-snapshot",
+            imageBytes: new Uint8Array([1]),
+            format: "png",
+            width: 1,
+            height: 1,
+          };
+      }
+    },
+  };
+}
+
+const TENANT: TenantId = "22222222-2222-4222-8222-222222222222" as TenantId;
+
+describe("renderer-foundation :: Plugin-Selection", () => {
+  test("default-plugin für notification = 'simple'", async () => {
+    const api = createRendererFoundationApi([
+      makePlugin("simple", ["notification"]),
+      makePlugin("other", ["notification"]),
+    ]);
+    const plugin = api.createRendererForTenant({ tenantId: TENANT, kind: "notification" });
+    expect(plugin.name).toBe("simple");
+  });
+
+  test("default-plugin für mail-html = 'mail-html'", async () => {
+    const api = createRendererFoundationApi([
+      makePlugin("simple", ["notification", "mail-html"]),
+      makePlugin("mail-html", ["mail-html"]),
+    ]);
+    const plugin = api.createRendererForTenant({ tenantId: TENANT, kind: "mail-html" });
+    expect(plugin.name).toBe("mail-html");
+  });
+
+  test("default-plugin für document-pdf = 'puppeteer'", async () => {
+    const api = createRendererFoundationApi([
+      makePlugin("puppeteer", ["document-pdf", "image-snapshot"]),
+    ]);
+    const plugin = api.createRendererForTenant({ tenantId: TENANT, kind: "document-pdf" });
+    expect(plugin.name).toBe("puppeteer");
+  });
+
+  test("Tenant-Override gewinnt vor Default", async () => {
+    const api = createRendererFoundationApi(
+      [makePlugin("simple", ["notification"]), makePlugin("custom-notif", ["notification"])],
+      (tid) => (tid === TENANT ? { notification: "custom-notif" } : null),
+    );
+    const plugin = api.createRendererForTenant({ tenantId: TENANT, kind: "notification" });
+    expect(plugin.name).toBe("custom-notif");
+  });
+
+  test("Tenant-Override auf nicht-registriertes Plugin → fällt durch auf Default", async () => {
+    const api = createRendererFoundationApi([makePlugin("simple", ["notification"])], () => ({
+      notification: "ghost-plugin",
+    }));
+    const plugin = api.createRendererForTenant({ tenantId: TENANT, kind: "notification" });
+    expect(plugin.name).toBe("simple");
+  });
+
+  test("Fallback auf erstes passendes Plugin wenn weder Tenant-Config noch Default-Name matchen", async () => {
+    const api = createRendererFoundationApi([makePlugin("nonstandard-name", ["notification"])]);
+    const plugin = api.createRendererForTenant({ tenantId: TENANT, kind: "notification" });
+    expect(plugin.name).toBe("nonstandard-name");
+  });
+
+  test("kein Plugin für kind → RendererError", () => {
+    const api = createRendererFoundationApi([makePlugin("simple", ["notification"])]);
+    expect(() => api.createRendererForTenant({ tenantId: TENANT, kind: "document-pdf" })).toThrow(
+      RendererError,
+    );
+  });
+
+  test("leerer Plugin-Pool → RendererError für jeden kind", () => {
+    const api = createRendererFoundationApi([]);
+    expect(() => api.createRendererForTenant({ tenantId: TENANT, kind: "notification" })).toThrow(
+      RendererError,
+    );
+    expect(() => api.createRendererForTenant({ tenantId: TENANT, kind: "mail-html" })).toThrow(
+      RendererError,
+    );
+    expect(() => api.createRendererForTenant({ tenantId: TENANT, kind: "document-pdf" })).toThrow(
+      RendererError,
+    );
+    expect(() => api.createRendererForTenant({ tenantId: TENANT, kind: "image-snapshot" })).toThrow(
+      RendererError,
+    );
+  });
+
+  test("RendererError code='no_plugin_for_kind' wenn kein Plugin", () => {
+    const api = createRendererFoundationApi([]);
+    try {
+      api.createRendererForTenant({ tenantId: TENANT, kind: "notification" });
+      expect.fail("expected RendererError");
+    } catch (e) {
+      expect(e).toBeInstanceOf(RendererError);
+      expect((e as RendererError).code).toBe("no_plugin_for_kind");
+    }
+  });
+
+  test("Plugin mit mehreren kinds wird für jeden passend gewählt", async () => {
+    const multi = makePlugin("multi", ["notification", "mail-html", "document-pdf"]);
+    const api = createRendererFoundationApi([multi]);
+    expect(api.createRendererForTenant({ tenantId: TENANT, kind: "notification" }).name).toBe(
+      "multi",
+    );
+    expect(api.createRendererForTenant({ tenantId: TENANT, kind: "mail-html" }).name).toBe("multi");
+    expect(api.createRendererForTenant({ tenantId: TENANT, kind: "document-pdf" }).name).toBe(
+      "multi",
+    );
+  });
+
+  test("Plugin mit leeren kinds wird nie ausgewählt", () => {
+    const api = createRendererFoundationApi([
+      makePlugin("empty-kinds", []),
+      makePlugin("simple", ["notification"]),
+    ]);
+    const plugin = api.createRendererForTenant({ tenantId: TENANT, kind: "notification" });
+    expect(plugin.name).toBe("simple");
+  });
+
+  test("Tenant-Override mit falschem kind-Plugin → ignoriert, Fallback", async () => {
+    // Tenant config sagt "puppeteer" für notification, aber puppeteer kann
+    // nur document-pdf. Foundation muss den falsche-kind-Eintrag ignorieren.
+    const api = createRendererFoundationApi(
+      [makePlugin("simple", ["notification"]), makePlugin("puppeteer", ["document-pdf"])],
+      () => ({ notification: "puppeteer" }),
+    );
+    const plugin = api.createRendererForTenant({ tenantId: TENANT, kind: "notification" });
+    expect(plugin.name).toBe("simple");
+  });
+});
+
+describe("renderer-foundation :: Plugin executes render", () => {
+  test("Plugin.render returnt RenderResponse mit gleichem kind", async () => {
+    const api = createRendererFoundationApi([makePlugin("simple", ["notification"])]);
+    const plugin = api.createRendererForTenant({ tenantId: TENANT, kind: "notification" });
+    const response = await plugin.render(
+      { kind: "notification", payload: { content: "hello", contentFormat: "markdown" } },
+      STUB_CTX,
+    );
+    expect(response.kind).toBe("notification");
+    if (response.kind === "notification") {
+      expect(response.html).toBe("from:simple");
+    }
+  });
+});

package/src/renderer-foundation/__tests__/collect-plugins.integration.ts

@@ -0,0 +1,101 @@
+import { defineFeature, type TenantId } from "@cosmicdrift/kumiko-framework/engine";
+import { setupTestStack, type TestStack } from "@cosmicdrift/kumiko-framework/stack";
+import { afterAll, beforeAll, describe, expect, test } from "vitest";
+import { createTemplateResolverFeature } from "../../template-resolver/feature";
+import { createRendererFoundationApi } from "../api";
+import { collectRendererPlugins, createRendererFoundationFeature } from "../feature";
+import type { RenderRequest, RenderResponse } from "../types";
+
+const TEST_TENANT = "11111111-1111-4111-8111-111111111111" as TenantId;
+
+let stack: TestStack;
+
+// Mini-Plugin via defineFeature + r.useExtension — wie ein echter
+// renderer-plugin (renderer-simple, renderer-mail-html) sich registriert.
+function createTestPluginFeature(name: string, kinds: ReadonlyArray<string>) {
+  return defineFeature(`renderer-${name}`, (r) => {
+    r.requires("renderer-foundation");
+    r.useExtension("renderer", name, {
+      kinds,
+      render: async (req: RenderRequest): Promise<RenderResponse> => {
+        if (req.kind === "notification") return { kind: "notification", html: `via:${name}` };
+        if (req.kind === "mail-html")
+          return { kind: "mail-html", html: `via:${name}`, text: `via:${name}` };
+        if (req.kind === "document-pdf")
+          return {
+            kind: "document-pdf",
+            pdfBytes: new Uint8Array([1]),
+            pageCount: 1,
+            sizeBytes: 1,
+          };
+        return {
+          kind: "image-snapshot",
+          imageBytes: new Uint8Array([1]),
+          format: "png",
+          width: 1,
+          height: 1,
+        };
+      },
+    });
+  });
+}
+
+beforeAll(async () => {
+  stack = await setupTestStack({
+    features: [
+      createTemplateResolverFeature(),
+      createRendererFoundationFeature(),
+      createTestPluginFeature("simple", ["notification"]),
+      createTestPluginFeature("mail-html", ["mail-html"]),
+      createTestPluginFeature("puppeteer", ["document-pdf", "image-snapshot"]),
+    ],
+  });
+});
+
+afterAll(async () => {
+  await stack.cleanup();
+});
+
+describe("renderer-foundation :: Plugin-Pool aus Registry", () => {
+  test("collectRendererPlugins findet alle registrierten Plugins", () => {
+    const plugins = collectRendererPlugins(stack.registry);
+    const names = plugins.map((p) => p.name).sort();
+    expect(names).toEqual(["mail-html", "puppeteer", "simple"]);
+  });
+
+  test("jeder Plugin behält seine kinds-Deklaration", () => {
+    const plugins = collectRendererPlugins(stack.registry);
+    const byName = new Map(plugins.map((p) => [p.name, p]));
+    expect([...byName.get("simple")!.kinds]).toEqual(["notification"]);
+    expect([...byName.get("mail-html")!.kinds]).toEqual(["mail-html"]);
+    expect([...byName.get("puppeteer")!.kinds].sort()).toEqual(["document-pdf", "image-snapshot"]);
+  });
+
+  test("API findet Default-Plugin pro kind aus echtem Pool", () => {
+    const plugins = collectRendererPlugins(stack.registry);
+    const api = createRendererFoundationApi(plugins);
+    expect(api.createRendererForTenant({ tenantId: TEST_TENANT, kind: "notification" }).name).toBe(
+      "simple",
+    );
+    expect(api.createRendererForTenant({ tenantId: TEST_TENANT, kind: "mail-html" }).name).toBe(
+      "mail-html",
+    );
+    expect(api.createRendererForTenant({ tenantId: TEST_TENANT, kind: "document-pdf" }).name).toBe(
+      "puppeteer",
+    );
+  });
+
+  test("Plugin.render mit echtem Pool fließt end-to-end durch", async () => {
+    const plugins = collectRendererPlugins(stack.registry);
+    const api = createRendererFoundationApi(plugins);
+    const plugin = api.createRendererForTenant({ tenantId: TEST_TENANT, kind: "notification" });
+    const result = await plugin.render(
+      { kind: "notification", payload: { content: "hello", contentFormat: "markdown" } },
+      { db: stack.db, registry: stack.registry, tenantId: TEST_TENANT },
+    );
+    expect(result.kind).toBe("notification");
+    if (result.kind === "notification") {
+      expect(result.html).toBe("via:simple");
+    }
+  });
+});