@cosmicdrift/kumiko-framework 0.31.1 → 0.32.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-framework",
-  "version": "0.31.1",
+  "version": "0.32.1",
   "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>",

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

@@ -1287,6 +1287,7 @@ describe("boot-validator", () => {
         readonly fields: readonly string[];
       }>;
       readonly redirect?: string;
+      readonly cancelTarget?: string | false;
       readonly extraScreens?: readonly string[];
     };
 
@@ -1318,6 +1319,7 @@ describe("boot-validator", () => {
           fields: fields as never,
           layout: { sections: sections as never },
           ...(override.redirect !== undefined && { redirect: override.redirect }),
+          ...(override.cancelTarget !== undefined && { cancelTarget: override.cancelTarget }),
         });
         for (const extra of override.extraScreens ?? []) {
           r.screen({
@@ -1387,6 +1389,22 @@ describe("boot-validator", () => {
       );
     });
 
+    test("cancelTarget → existing screen-id → kein Throw", () => {
+      expect(() =>
+        validateBoot([makeFeature({ cancelTarget: "after-form", extraScreens: ["after-form"] })]),
+      ).not.toThrow();
+    });
+
+    test("cancelTarget → unknown screen-id → Throw", () => {
+      expect(() => validateBoot([makeFeature({ cancelTarget: "ghost-screen" })])).toThrow(
+        /cancelTarget "ghost-screen" does not resolve to a registered screen/,
+      );
+    });
+
+    test("cancelTarget=false (Button abgeschaltet) → kein Throw", () => {
+      expect(() => validateBoot([makeFeature({ cancelTarget: false })])).not.toThrow();
+    });
+
     test("extension section ohne component → Throw (Parität zu entityEdit)", () => {
       // synthesizeActionFormScreen reicht die layout 1:1 an RenderEdit weiter —
       // eine Extension-Section ohne react/native-Marker rendert sonst stumm leer.

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

@@ -210,6 +210,19 @@ export function validateScreens(
           );
         }
       }
+      if (typeof screen.cancelTarget === "string") {
+        // Gleiche Regel wie redirect — `false` (kein Cancel-Button)
+        // braucht keine Validierung.
+        const candidateQn = qualifyEntityName(feature.name, "screen", screen.cancelTarget);
+        if (!allScreenQns.has(candidateQn)) {
+          throw new Error(
+            `[Feature ${feature.name}] Screen "${screenId}" (actionForm) cancelTarget "${screen.cancelTarget}" ` +
+              `does not resolve to a registered screen in this feature. Known screens: ${
+                [...Object.keys(feature.screens)].sort().join(", ") || "(none)"
+              }.`,
+          );
+        }
+      }
       continue;
     }
 

package/src/engine/types/screen.ts

@@ -177,6 +177,11 @@ export type RowActionNavigate = {
   /** Screen-id (kurz, unqualified) zu dem navigiert wird. Boot-
    *  Validator prüft Existenz im selben Feature. */
   readonly screen: string;
+  /** Optional: Entity-Id für entityEdit-Targets — landet als Pfad-
+   *  Segment (`/<workspace>/<screen>/<entityId>`). entityEdit liest die
+   *  Id AUSSCHLIESSLICH aus dem Pfad; ein `?id=`-Search-Param öffnet
+   *  den Create-Mode. ⚠️ Function-Form nur im Monolith-Bundle-Pattern. */
+  readonly entityId?: (row: Readonly<Record<string, unknown>>) => string;
   /** Optional: URL-Search-Params aus row-Context. Wird in actionForm-
    *  Targets als initial values gelesen ("Edit Customer X" → URL hat
    *  `?customerId=row-uuid`, actionForm initial values pre-fillen).
@@ -359,6 +364,13 @@ export type ActionFormScreenDefinition = {
    *  Wenn nicht gesetzt, bleibt der User auf dem Form-Screen. Boot-
    *  Validator prüft dass die ID einen registrierten Screen meint. */
   readonly redirect?: string;
+  /** Ziel des Abbrechen-Buttons. Default: `redirect` (historisches
+   *  Verhalten — Cancel und Submit-Redirect landen dann am selben Ort).
+   *  `false` = kein Abbrechen-Button; richtig für Single-Action-Screens
+   *  ohne verwerfbaren Zustand (z.B. "Test-Mail senden"), wo Abbrechen
+   *  nur ein zweiter Weg zum selben Ziel wäre. Boot-Validator prüft
+   *  String-Targets wie `redirect`. */
+  readonly cancelTarget?: string | false;
   readonly slots?: ScreenSlots;
   readonly access?: AccessRule;
 };