@cosmicdrift/kumiko-headless 0.270.0 → 0.273.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.270.0",
+  "version": "0.273.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.270.0",
+    "@cosmicdrift/kumiko-framework": "0.273.0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
   },

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

@@ -847,6 +847,46 @@ describe("computeEditViewModel — relatedList searchable/facets passthrough (fw
   });
 });
 
+describe("computeEditViewModel — relatedList parentFilter passthrough", () => {
+  test("parentFilter passes through onto the relatedList section view-model verbatim", () => {
+    const vm = computeEditViewModel({
+      screen: editScreen({
+        sections: [
+          {
+            kind: "relatedList",
+            title: "History",
+            query: "app:query:history",
+            columns: ["name"],
+            parentFilter: { field: "orderId" },
+          },
+        ],
+      }),
+      entity: orderEntity,
+      values: {},
+      translate,
+      featureName: "orders",
+    });
+
+    expect(asRelatedList(vm.sections[0]).parentFilter).toEqual({ field: "orderId" });
+  });
+
+  test("parentFilter is absent from the view-model when the section spec has none", () => {
+    const vm = computeEditViewModel({
+      screen: editScreen({
+        sections: [
+          { kind: "relatedList", title: "History", query: "app:query:history", columns: ["name"] },
+        ],
+      }),
+      entity: orderEntity,
+      values: {},
+      translate,
+      featureName: "orders",
+    });
+
+    expect(asRelatedList(vm.sections[0]).parentFilter).toBeUndefined();
+  });
+});
+
 describe("computeEditViewModel — writeForm sections (fw editable-detail-screens)", () => {
   test("resolves the section's own fieldDefs/fields through the same per-field pipeline as a fields section", () => {
     const vm = computeEditViewModel({

package/src/view-model/edit.ts

@@ -123,6 +123,7 @@ function computeRelatedListSectionViewModel(
     title: translate(sectionSpec.title),
     query: sectionSpec.query,
     ...(sectionSpec.parentParam !== undefined && { parentParam: sectionSpec.parentParam }),
+    ...(sectionSpec.parentFilter !== undefined && { parentFilter: sectionSpec.parentFilter }),
     columns: sectionSpec.columns,
     ...(sectionSpec.pageSize !== undefined && { pageSize: sectionSpec.pageSize }),
     ...(sectionSpec.defaultSort !== undefined && { defaultSort: sectionSpec.defaultSort }),
@@ -130,6 +131,7 @@ function computeRelatedListSectionViewModel(
     ...(sectionSpec.facets !== undefined && { facets: sectionSpec.facets }),
     ...(sectionSpec.rowClick !== undefined && { rowClick: sectionSpec.rowClick }),
     ...(sectionSpec.rowActions !== undefined && { rowActions: sectionSpec.rowActions }),
+    ...(sectionSpec.toolbarActions !== undefined && { toolbarActions: sectionSpec.toolbarActions }),
   };
 }
 
@@ -163,7 +165,13 @@ export function computeEditViewModel<
     if (!isFieldsEditSection(sectionSpec)) {
       return computeRelatedListSectionViewModel(sectionSpec, translate);
     }
-    const fields: EditFieldViewModel[] = sectionSpec.fields.map((fieldSpec) => {
+    // `groups` flattens into the same per-field pipeline as plain `fields`;
+    // the group structure below just re-groups the computed views by name.
+    const flatFieldSpecs =
+      sectionSpec.groups !== undefined
+        ? sectionSpec.groups.flatMap((group) => group.fields)
+        : sectionSpec.fields;
+    const fields: EditFieldViewModel[] = flatFieldSpecs.map((fieldSpec) => {
       const normalized = normalizeEditField(fieldSpec);
       const fieldDef = entity.fields[normalized.field];
       if (!fieldDef) {
@@ -424,9 +432,27 @@ export function computeEditViewModel<
       };
       return view;
     });
-    // Boot-validator rejects fields.length === 0 (screens.ts), so an empty
-    // section never reaches this code.
+    // Boot-validator rejects fields.length === 0 with no groups (screens.ts),
+    // so an empty section never reaches this code.
     const visible = fields.some((field) => field.visible);
+    // Tabs mode renders this section as its own card, where two columns reads
+    // better than the single-column default a stacked form keeps.
+    const defaultColumns = screen.layout.mode === "tabs" ? 2 : 1;
+    const groups = sectionSpec.groups?.map((group) => ({
+      title: translate(group.title),
+      columns: group.columns ?? 2,
+      fields: group.fields.map((fieldSpec) => {
+        const fieldName = normalizeEditField(fieldSpec).field;
+        const fieldView = fields.find((f) => f.field === fieldName);
+        if (fieldView === undefined) {
+          throw new Error(
+            `computeEditViewModel: screen "${screen.id}" group "${group.title}" references field ` +
+              `"${fieldName}" that failed to resolve.`,
+          );
+        }
+        return fieldView;
+      }),
+    }));
     return {
       kind: "fields" as const,
       visible,
@@ -435,8 +461,9 @@ export function computeEditViewModel<
       ...(sectionSpec.description !== undefined && {
         description: translate(sectionSpec.description),
       }),
-      columns: sectionSpec.columns ?? 1,
+      columns: sectionSpec.columns ?? defaultColumns,
       fields,
+      ...(groups !== undefined && { groups }),
       ...(sectionSpec.icon !== undefined && { icon: sectionSpec.icon }),
     };
   });

package/src/view-model/types.ts

@@ -8,6 +8,7 @@ import type {
   ListFacetSpec,
   ListSortSpec,
   PlatformComponent,
+  RelatedListToolbarAction,
   RowAction,
   ScreenSlots,
 } from "@cosmicdrift/kumiko-framework/ui-types";
@@ -270,6 +271,13 @@ export type EditFieldsSectionViewModel = {
   readonly description?: string;
   readonly columns: number;
   readonly fields: readonly EditFieldViewModel[];
+  /** From `EditFieldsSection.groups` — each entry's `fields` are the same
+   *  view-model objects as `fields` above, re-grouped (not recomputed). */
+  readonly groups?: readonly {
+    readonly title: string;
+    readonly columns: number;
+    readonly fields: readonly EditFieldViewModel[];
+  }[];
   /** From `EditFieldsSection.icon` — closed IconKey vocabulary, renders
    *  left of the title. No effect without `title`. */
   readonly icon?: IconKey;
@@ -292,6 +300,7 @@ export type EditRelatedListSectionViewModel = {
   readonly title: string;
   readonly query: string;
   readonly parentParam?: string;
+  readonly parentFilter?: { readonly field: string };
   readonly columns: readonly ListColumnSpec[];
   readonly pageSize?: number;
   readonly defaultSort?: ListSortSpec;
@@ -299,6 +308,7 @@ export type EditRelatedListSectionViewModel = {
   readonly facets?: readonly ListFacetSpec[];
   readonly rowClick?: { readonly entity: string; readonly idColumn?: string };
   readonly rowActions?: readonly RowAction[];
+  readonly toolbarActions?: readonly RelatedListToolbarAction[];
 };
 
 // Mirrors EditWriteFormSection, except `fields` is already resolved through