@cosmicdrift/kumiko-headless 0.167.1 → 0.170.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.167.1",
+  "version": "0.170.0",
   "description": "Headless UI logic for Kumiko — Dispatcher contract, Form-Controller, View-Model, Nav-Resolver. Plattform- und React-frei; jeder Renderer (renderer, renderer-web, renderer-native, …) komponiert darauf.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -36,7 +36,7 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.167.1",
+    "@cosmicdrift/kumiko-framework": "0.170.0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
   },

package/src/view-model/__tests__/edit.test.ts

@@ -19,6 +19,7 @@ const orderEntity = {
     notes: { type: "text" },
     vatExempt: { type: "boolean" },
     vatReason: { type: "text" },
+    kind: { type: "text" },
   },
 } as unknown as EntityDefinition;
 
@@ -152,6 +153,34 @@ describe("computeEditViewModel", () => {
     expect(reasonShown?.required).toBe(true);
   });
 
+  test("section with all fields hidden by visible condition → section.visible is false but section stays in the array (key stability)", () => {
+    const screen = editScreen({
+      sections: [
+        {
+          title: "Person",
+          fields: [{ field: "customerName", visible: { field: "kind", eq: "person" } }],
+        },
+        {
+          title: "Firma",
+          fields: [{ field: "notes", visible: { field: "kind", eq: "company" } }],
+        },
+      ],
+    });
+
+    const vm = computeEditViewModel({
+      screen,
+      entity: orderEntity,
+      values: { kind: "person", customerName: "Acme" },
+      translate,
+      featureName: "orders",
+    });
+
+    expect(vm.sections).toHaveLength(2);
+    expect(asFields(vm.sections[0]).visible).toBe(true);
+    expect(asFields(vm.sections[1]).visible).toBe(false);
+    expect(vm.sections[1]?.title).toBe("Firma");
+  });
+
   test("readonly condition { field, ne } evaluates against form values", () => {
     const screen = editScreen({
       sections: [

package/src/view-model/edit.ts

@@ -154,8 +154,12 @@ export function computeEditViewModel<
       };
       return view;
     });
+    // Boot-validator rejects fields.length === 0 (screens.ts), so an empty
+    // section never reaches this code.
+    const visible = fields.some((field) => field.visible);
     return {
       kind: "fields" as const,
+      visible,
       // Titellose Section (flache Form) → kein h3; nur übersetzen wenn gesetzt.
       ...(sectionSpec.title !== undefined && { title: translate(sectionSpec.title) }),
       columns: sectionSpec.columns ?? 1,

package/src/view-model/types.ts

@@ -152,6 +152,10 @@ export type EditSectionViewModel = EditFieldsSectionViewModel | EditExtensionSec
 
 export type EditFieldsSectionViewModel = {
   readonly kind: "fields";
+  /** False when the section has fields but none of them is visible.
+   *  The renderer then draws nothing, but the section stays in the array
+   *  (key stability). */
+  readonly visible: boolean;
   /** Optional — eine titellose Section rendert nur ihre Felder (flache Form). */
   readonly title?: string;
   readonly columns: number;