@cosmicdrift/kumiko-framework 0.96.0 → 0.97.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-framework",
-  "version": "0.96.0",
+  "version": "0.97.0",
   "description": "Framework core — engine, pipeline, API, DB, and every other bit that makes Kumiko go.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -181,7 +181,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.96.0",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.97.0",
     "bun-types": "^1.3.13",
     "pino-pretty": "^13.1.3"
   },

package/src/engine/__tests__/boot-validator.test.ts

@@ -1920,6 +1920,28 @@ describe("boot-validator", () => {
         /rowAction "edit" navigate-target "ghost-screen" does not resolve/,
       );
     });
+
+    test("navigate-target → screen in ANOTHER feature → kein Throw (cross-feature)", () => {
+      // Eine deklarative Liste im owning-Feature der Entity navigiert zum
+      // Custom-Editor der Consumer-App (anderes Feature). Runtime löst die bare
+      // id app-weit auf → der Validator muss das erlauben.
+      const list = defineFeature("shop", (r) => {
+        r.entity("product", createEntity({ fields: { name: createTextField() } }));
+        r.screen({
+          id: "product-list",
+          type: "entityList",
+          entity: "product",
+          columns: ["name"],
+          rowActions: [
+            { kind: "navigate", id: "edit", label: "actions.edit", screen: "product-editor" },
+          ],
+        });
+      });
+      const consumer = defineFeature("app", (r) => {
+        r.screen({ id: "product-editor", type: "custom", renderer: { react: "stub" } });
+      });
+      expect(() => validateBoot([list, consumer])).not.toThrow();
+    });
   });
 
   // --- rowAction kind="writeHandler" handler-QN-Validierung (Tier 2.7e-1 erw.) ---
@@ -2125,6 +2147,25 @@ describe("boot-validator", () => {
         /toolbarAction "open-form" navigate-target "ghost-form" does not resolve/,
       );
     });
+
+    test("navigate-target → screen in ANOTHER feature → kein Throw (cross-feature)", () => {
+      const list = defineFeature("shop", (r) => {
+        r.entity("product", createEntity({ fields: { name: createTextField() } }));
+        r.screen({
+          id: "product-list",
+          type: "entityList",
+          entity: "product",
+          columns: ["name"],
+          toolbarActions: [
+            { kind: "navigate", id: "new", label: "actions.new", screen: "product-editor" },
+          ],
+        });
+      });
+      const consumer = defineFeature("app", (r) => {
+        r.screen({ id: "product-editor", type: "custom", renderer: { react: "stub" } });
+      });
+      expect(() => validateBoot([list, consumer])).not.toThrow();
+    });
   });
 
   describe("entityList toolbarAction writeHandler handler-QN (Tier 2.7e-2)", () => {

package/src/engine/boot-validator/screens-nav.ts

@@ -88,6 +88,13 @@ export function validateScreens(
   allScreenQns: ReadonlySet<string>,
   allConfigKeyQns: ReadonlySet<string>,
 ): void {
+  // navigate-Targets (rowAction/toolbarAction) dürfen cross-feature zeigen —
+  // der Runtime-Router (create-app) löst eine bare screenId app-weit über ALLE
+  // Features auf (eine deklarative Liste im owning-Feature der Entity navigiert
+  // so zu den Custom-Editoren der Consumer-App). Der Validator spiegelt das:
+  // same-feature ODER irgendein Feature. (redirect/cancelTarget bleiben bewusst
+  // same-feature: deren Router baut die URL direkt aus der kurzen id.)
+  const navTargetShortIds = screenShortIdsFrom(allScreenQns);
   for (const [screenId, screen] of Object.entries(feature.screens)) {
     if (screen.type === "custom") {
       if (!screen.renderer.react && !screen.renderer.native) {
@@ -429,10 +436,10 @@ export function validateScreens(
         for (const action of screen.rowActions) {
           if (action.kind === "navigate") {
             const candidateQn = qualifyEntityName(feature.name, "screen", action.screen);
-            if (!allScreenQns.has(candidateQn)) {
+            if (!allScreenQns.has(candidateQn) && !navTargetShortIds.has(action.screen)) {
               throw new Error(
                 `[Feature ${feature.name}] Screen "${screenId}" (entityList) rowAction "${action.id}" ` +
-                  `navigate-target "${action.screen}" does not resolve to a registered screen in this feature.`,
+                  `navigate-target "${action.screen}" does not resolve to a registered screen in any feature.`,
               );
             }
           } else {
@@ -462,10 +469,10 @@ export function validateScreens(
         for (const action of screen.toolbarActions) {
           if (action.kind === "navigate") {
             const candidateQn = qualifyEntityName(feature.name, "screen", action.screen);
-            if (!allScreenQns.has(candidateQn)) {
+            if (!allScreenQns.has(candidateQn) && !navTargetShortIds.has(action.screen)) {
               throw new Error(
                 `[Feature ${feature.name}] Screen "${screenId}" (entityList) toolbarAction "${action.id}" ` +
-                  `navigate-target "${action.screen}" does not resolve to a registered screen in this feature.`,
+                  `navigate-target "${action.screen}" does not resolve to a registered screen in any feature.`,
               );
             }
           } else {
@@ -615,6 +622,19 @@ export function collectScreenQns(features: readonly FeatureDefinition[]): Set<st
   return set;
 }
 
+// Bare Screen-ids (ohne `<feature>:screen:`-Prefix) aus den qualifizierten
+// QNs — für die app-weite Auflösung von navigate-Targets (s. validateScreens).
+// Spiegelt den Runtime-Router, der bare ids feature-übergreifend matcht.
+export function screenShortIdsFrom(allScreenQns: ReadonlySet<string>): Set<string> {
+  const marker = ":screen:";
+  const set = new Set<string>();
+  for (const qn of allScreenQns) {
+    const at = qn.indexOf(marker);
+    if (at !== -1) set.add(qn.slice(at + marker.length));
+  }
+  return set;
+}
+
 // Sammelt alle qualifizierten Write-Handler-QNs (`<feature>:write:<short>`).
 // Wird vom actionForm-Screen-Validator genutzt um zu prüfen ob der
 // im Schema deklarierte handler tatsächlich registriert ist —