@cosmicdrift/kumiko-headless 0.21.1 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.21.1",
+  "version": "0.22.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>",

package/src/index.ts

@@ -64,7 +64,9 @@ export { createStore, shallowEqual } from "./store";
 export type {
   ComputeEditViewModelInput,
   ComputeListViewModelInput,
+  EditExtensionSectionViewModel,
   EditFieldSpec,
+  EditFieldsSectionViewModel,
   EditFieldViewModel,
   EditSectionSpec,
   EditSectionViewModel,

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

@@ -4,6 +4,14 @@ import type {
   EntityEditScreenDefinition,
 } from "@cosmicdrift/kumiko-framework/ui-types";
 import { computeEditViewModel } from "../edit";
+import type { EditFieldsSectionViewModel, EditSectionViewModel } from "../types";
+
+function asFields(s: EditSectionViewModel | undefined): EditFieldsSectionViewModel {
+  if (s === undefined || s.kind !== "fields") {
+    throw new Error(`expected fields-section, got ${s?.kind ?? "undefined"}`);
+  }
+  return s;
+}
 
 const orderEntity = {
   fields: {
@@ -44,8 +52,8 @@ describe("computeEditViewModel", () => {
     expect(vm.sections).toHaveLength(1);
     const section = vm.sections[0];
     expect(section?.title).toBe("Hauptdaten");
-    expect(section?.columns).toBe(1); // default
-    expect(section?.fields).toEqual([
+    expect(asFields(section).columns).toBe(1); // default
+    expect(asFields(section).fields).toEqual([
       {
         field: "customerName",
         label: "orders:entity:order:field:customerName",
@@ -81,8 +89,8 @@ describe("computeEditViewModel", () => {
       featureName: "orders",
     });
 
-    expect(vm.sections[0]?.columns).toBe(2);
-    expect(vm.sections[1]?.columns).toBe(1);
+    expect(asFields(vm.sections[0]).columns).toBe(2);
+    expect(asFields(vm.sections[1]).columns).toBe(1);
   });
 
   test("visible predicate evaluated against current values (live-reactive)", () => {
@@ -110,7 +118,7 @@ describe("computeEditViewModel", () => {
       translate,
       featureName: "orders",
     });
-    const reasonHidden = hidden.sections[0]?.fields[1];
+    const reasonHidden = asFields(hidden.sections[0]).fields[1];
     expect(reasonHidden?.visible).toBe(false);
     expect(reasonHidden?.required).toBe(false);
 
@@ -121,7 +129,7 @@ describe("computeEditViewModel", () => {
       translate,
       featureName: "orders",
     });
-    const reasonShown = shown.sections[0]?.fields[1];
+    const reasonShown = asFields(shown.sections[0]).fields[1];
     expect(reasonShown?.visible).toBe(true);
     expect(reasonShown?.required).toBe(true);
   });
@@ -149,7 +157,7 @@ describe("computeEditViewModel", () => {
       translate,
       featureName: "orders",
     });
-    expect(nonAdmin.sections[0]?.fields[0]?.readOnly).toBe(true);
+    expect(asFields(nonAdmin.sections[0]).fields[0]?.readOnly).toBe(true);
 
     const admin = computeEditViewModel({
       screen,
@@ -159,7 +167,7 @@ describe("computeEditViewModel", () => {
       translate,
       featureName: "orders",
     });
-    expect(admin.sections[0]?.fields[0]?.readOnly).toBe(false);
+    expect(asFields(admin.sections[0]).fields[0]?.readOnly).toBe(false);
   });
 
   test("screen-level required override wins over entity-level required", () => {
@@ -180,7 +188,7 @@ describe("computeEditViewModel", () => {
       featureName: "orders",
     });
 
-    expect(vm.sections[0]?.fields[0]?.required).toBe(false);
+    expect(asFields(vm.sections[0]).fields[0]?.required).toBe(false);
   });
 
   test("id is extracted from values or null on create (no existing row)", () => {
@@ -237,6 +245,6 @@ describe("computeEditViewModel", () => {
       translate,
       featureName: "orders",
     });
-    expect(vm.sections[0]?.fields[0]?.span).toBe(2);
+    expect(asFields(vm.sections[0]).fields[0]?.span).toBe(2);
   });
 });

package/src/view-model/edit.ts

@@ -3,7 +3,11 @@ import type {
   EntityEditScreenDefinition,
   FieldCondition,
 } from "@cosmicdrift/kumiko-framework/ui-types";
-import { normalizeEditField, parseRefTarget } from "@cosmicdrift/kumiko-framework/ui-types";
+import {
+  isExtensionEditSection,
+  normalizeEditField,
+  parseRefTarget,
+} from "@cosmicdrift/kumiko-framework/ui-types";
 import { buildOptionLabels, fieldLabelKey } from "./list";
 import type { EditFieldViewModel, EditSectionViewModel, EditViewModel, Translate } from "./types";
 
@@ -36,6 +40,13 @@ export function computeEditViewModel<
   const { screen, entity, values, translate, featureName, ctx } = input;
 
   const sections: EditSectionViewModel[] = screen.layout.sections.map((sectionSpec) => {
+    if (isExtensionEditSection(sectionSpec)) {
+      return {
+        kind: "extension" as const,
+        title: translate(sectionSpec.title),
+        component: sectionSpec.component,
+      };
+    }
     const fields: EditFieldViewModel[] = sectionSpec.fields.map((fieldSpec) => {
       const normalized = normalizeEditField(fieldSpec);
       const fieldDef = entity.fields[normalized.field];
@@ -124,6 +135,7 @@ export function computeEditViewModel<
       return view;
     });
     return {
+      kind: "fields" as const,
       title: translate(sectionSpec.title),
       columns: sectionSpec.columns ?? 1,
       fields,

package/src/view-model/index.ts

@@ -3,7 +3,9 @@ export { computeEditViewModel } from "./edit";
 export type { ComputeListViewModelInput } from "./list";
 export { computeListViewModel, fieldLabelKey } from "./list";
 export type {
+  EditExtensionSectionViewModel,
   EditFieldSpec,
+  EditFieldsSectionViewModel,
   EditFieldViewModel,
   EditSectionSpec,
   EditSectionViewModel,

package/src/view-model/types.ts

@@ -3,6 +3,7 @@ import type {
   EditSectionSpec,
   FieldRenderer,
   ListColumnSpec,
+  PlatformComponent,
   ScreenSlots,
 } from "@cosmicdrift/kumiko-framework/ui-types";
 
@@ -117,12 +118,24 @@ export type EditFieldViewModel = {
   readonly refMultiple?: boolean;
 };
 
-export type EditSectionViewModel = {
+// Discriminated by `kind` — mirrors EditSectionSpec on the engine side.
+// The builder always emits `kind` explicitly (no defaulting), so the
+// renderer narrows with a strict equality check.
+export type EditSectionViewModel = EditFieldsSectionViewModel | EditExtensionSectionViewModel;
+
+export type EditFieldsSectionViewModel = {
+  readonly kind: "fields";
   readonly title: string;
   readonly columns: number;
   readonly fields: readonly EditFieldViewModel[];
 };
 
+export type EditExtensionSectionViewModel = {
+  readonly kind: "extension";
+  readonly title: string;
+  readonly component: PlatformComponent;
+};
+
 export type EditViewModel = {
   readonly screenId: string;
   readonly entityName: string;