@cosmicdrift/kumiko-headless 0.250.0 → 0.251.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.250.0",
+  "version": "0.251.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.250.0",
+    "@cosmicdrift/kumiko-framework": "0.251.0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
   },

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

@@ -794,6 +794,59 @@ describe("computeEditViewModel — relatedList rowActions passthrough (fw editab
   });
 });
 
+describe("computeEditViewModel — relatedList searchable/facets passthrough (fw#2740)", () => {
+  test("searchable and facets pass through onto the relatedList section view-model untranslated", () => {
+    const facets = [
+      {
+        field: "status",
+        type: "select" as const,
+        label: "app:facet.status.label",
+        options: [{ value: "active", label: "app:facet.status.active" }],
+      },
+    ];
+    const vm = computeEditViewModel({
+      screen: editScreen({
+        sections: [
+          {
+            kind: "relatedList",
+            title: "History",
+            query: "app:query:history",
+            columns: ["name", "status"],
+            searchable: true,
+            facets,
+          },
+        ],
+      }),
+      entity: orderEntity,
+      values: {},
+      translate,
+      featureName: "orders",
+    });
+
+    const section = asRelatedList(vm.sections[0]);
+    expect(section.searchable).toBe(true);
+    expect(section.facets).toEqual(facets);
+  });
+
+  test("searchable and facets are 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",
+    });
+
+    const section = asRelatedList(vm.sections[0]);
+    expect(section.searchable).toBeUndefined();
+    expect(section.facets).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

@@ -1,4 +1,5 @@
 import type {
+  EditRelatedListSection,
   EditWriteFormSection,
   EntityDefinition,
   EntityEditScreenDefinition,
@@ -22,6 +23,7 @@ import {
 } from "./list";
 import type {
   EditFieldViewModel,
+  EditRelatedListSectionViewModel,
   EditSectionViewModel,
   EditViewModel,
   EditWriteFormSectionViewModel,
@@ -110,6 +112,27 @@ function computeWriteFormSectionViewModel<TValues extends Readonly<Record<string
   };
 }
 
+// relatedList runs its own query — nothing here to resolve against
+// entity/values, the spec passes through verbatim (fw#2166).
+function computeRelatedListSectionViewModel(
+  sectionSpec: EditRelatedListSection,
+  translate: Translate,
+): EditRelatedListSectionViewModel {
+  return {
+    kind: "relatedList" as const,
+    title: translate(sectionSpec.title),
+    query: sectionSpec.query,
+    ...(sectionSpec.parentParam !== undefined && { parentParam: sectionSpec.parentParam }),
+    columns: sectionSpec.columns,
+    ...(sectionSpec.pageSize !== undefined && { pageSize: sectionSpec.pageSize }),
+    ...(sectionSpec.defaultSort !== undefined && { defaultSort: sectionSpec.defaultSort }),
+    ...(sectionSpec.searchable !== undefined && { searchable: sectionSpec.searchable }),
+    ...(sectionSpec.facets !== undefined && { facets: sectionSpec.facets }),
+    ...(sectionSpec.rowClick !== undefined && { rowClick: sectionSpec.rowClick }),
+    ...(sectionSpec.rowActions !== undefined && { rowActions: sectionSpec.rowActions }),
+  };
+}
+
 // Pure transform from screen-def + entity-def + row-values to the flat
 // section/field tree the renderer draws. FieldConditions are evaluated here
 // so the renderer never re-runs them during React render.
@@ -138,19 +161,7 @@ export function computeEditViewModel<
       );
     }
     if (!isFieldsEditSection(sectionSpec)) {
-      // relatedList runs its own query — nothing here to resolve against
-      // entity/values, the spec passes through verbatim (fw#2166).
-      return {
-        kind: "relatedList" as const,
-        title: translate(sectionSpec.title),
-        query: sectionSpec.query,
-        ...(sectionSpec.parentParam !== undefined && { parentParam: sectionSpec.parentParam }),
-        columns: sectionSpec.columns,
-        ...(sectionSpec.pageSize !== undefined && { pageSize: sectionSpec.pageSize }),
-        ...(sectionSpec.defaultSort !== undefined && { defaultSort: sectionSpec.defaultSort }),
-        ...(sectionSpec.rowClick !== undefined && { rowClick: sectionSpec.rowClick }),
-        ...(sectionSpec.rowActions !== undefined && { rowActions: sectionSpec.rowActions }),
-      };
+      return computeRelatedListSectionViewModel(sectionSpec, translate);
     }
     const fields: EditFieldViewModel[] = sectionSpec.fields.map((fieldSpec) => {
       const normalized = normalizeEditField(fieldSpec);

package/src/view-model/types.ts

@@ -5,6 +5,7 @@ import type {
   FieldRenderer,
   IconKey,
   ListColumnSpec,
+  ListFacetSpec,
   ListSortSpec,
   PlatformComponent,
   RowAction,
@@ -292,6 +293,8 @@ export type EditRelatedListSectionViewModel = {
   readonly columns: readonly ListColumnSpec[];
   readonly pageSize?: number;
   readonly defaultSort?: ListSortSpec;
+  readonly searchable?: boolean;
+  readonly facets?: readonly ListFacetSpec[];
   readonly rowClick?: { readonly entity: string; readonly idColumn?: string };
   readonly rowActions?: readonly RowAction[];
 };