@cosmicdrift/kumiko-renderer 0.97.0 → 0.98.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.97.0",
+  "version": "0.98.0",
   "description": "Platform-agnostic React renderer for Kumiko screens. Contains the shared logic — primitives-contract, hooks, KumikoScreen, navigation & SSE abstractions — that any platform-specific renderer (web, native) composes. No DOM, no EventSource, no react-dom.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -15,8 +15,8 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.97.0",
-    "@cosmicdrift/kumiko-headless": "0.97.0",
+    "@cosmicdrift/kumiko-framework": "0.98.0",
+    "@cosmicdrift/kumiko-headless": "0.98.0",
     "react": "^19.2.6"
   },
   "devDependencies": {

package/src/app/extension-sections.tsx

@@ -34,6 +34,11 @@ export type ExtensionSectionProps = {
    *  Host-Screen keine Werte liefert. Erlaubt der Section, den Bestand
    *  beim Edit anzuzeigen statt write-only zu sein. */
   readonly initialValues?: Readonly<Record<string, unknown>>;
+  /** Nur im List-Header-Slot gesetzt (entityId ist dort null): die screen.id
+   *  der Liste, damit ein Header-Control den per-Screen URL-Filter-State
+   *  (useListUrlState) ansprechen kann — z.B. ein Tag-Filter der die Liste auf
+   *  eine id-Menge narrowed. In entityEdit-Sections undefined. */
+  readonly screenId?: string;
 };
 
 export type ExtensionSectionComponent = ComponentType<ExtensionSectionProps>;

package/src/app/kumiko-screen.tsx

@@ -604,6 +604,13 @@ function EntityListBody({
     const out: { field: string; op: "in"; value: unknown }[] = [];
     for (const [field, values] of Object.entries(urlState.filters)) {
       if (values.length === 0) continue;
+      // `id` is a base column (not in entity.fields), allowed as an id-set
+      // filter so a header-slot control — e.g. the tags TagFilter — can narrow
+      // ANY list to a resolved set of row ids without the host declaring a facet.
+      if (field === "id") {
+        out.push({ field, op: "in", value: values });
+        continue;
+      }
       // entity.fields ist am Renderer-Layer schwach getypt (vom Schema
       // deserialisiert) — Boundary-Cast wie buildInitialValues.
       const def = entity.fields[field] as { type?: string } | undefined;

package/src/components/render-list.tsx

@@ -382,7 +382,9 @@ function ListHeaderSlotMount({
     }
   }, [name, Component, screen.id]);
   if (Component === undefined) return null;
-  return <Component entityName={screen.entity} entityId={null} />;
+  // screenId lets a header control drive this list's URL-filter state
+  // (useListUrlState) — e.g. a tag filter narrowing the list to an id-set.
+  return <Component entityName={screen.entity} entityId={null} screenId={screen.id} />;
 }
 
 // Tier 2.7e-4: Bridge-Component pro reference-Spalte. Mounted für jede