@cosmicdrift/kumiko-headless 0.225.0 → 0.226.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.225.0",
+  "version": "0.226.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.225.0",
+    "@cosmicdrift/kumiko-framework": "0.226.0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
   },

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

@@ -14,6 +14,8 @@ const taskEntity = {
     title: { type: "text", required: true, sortable: true },
     done: { type: "boolean" },
     priority: { type: "number", sortable: true },
+    role: { type: "select", options: ["admin", "member"] },
+    labels: { type: "multiSelect", options: ["urgent", "low-priority"] },
   },
   derivedFields: {
     // Read-time computed (value appended by the list-query handler). The
@@ -232,6 +234,36 @@ describe("computeListViewModel", () => {
     expect(vm.columns[0]?.renderer).toEqual(fmt);
   });
 
+  test("select field column includes translated optionLabels", () => {
+    const vm = computeListViewModel({
+      screen: listScreen(["role"]),
+      entity: taskEntity,
+      rows: [],
+      translate: (key) => (key === "tasks:entity:task:field:role:option:admin" ? "Admin" : key),
+      featureName: "tasks",
+    });
+
+    expect(vm.columns[0]?.optionLabels).toEqual({
+      admin: "Admin",
+      member: "member",
+    });
+  });
+
+  test("multiSelect field column includes translated optionLabels (fw#2491)", () => {
+    const vm = computeListViewModel({
+      screen: listScreen(["labels"]),
+      entity: taskEntity,
+      rows: [],
+      translate: (key) => (key === "tasks:entity:task:field:labels:option:urgent" ? "Urgent" : key),
+      featureName: "tasks",
+    });
+
+    expect(vm.columns[0]?.optionLabels).toEqual({
+      urgent: "Urgent",
+      "low-priority": "low-priority",
+    });
+  });
+
   test("slots pass through unchanged for the renderer to mount", () => {
     const slots = { header: { react: { component: "HeaderRef" } } };
     const vm = computeListViewModel({

package/src/view-model/list.ts

@@ -95,12 +95,12 @@ export function computeListViewModel(input: ComputeListViewModelInput): ListView
       fieldDef.type === "reference"
         ? ((fieldDef as unknown as { labelField?: string }).labelField ?? "id")
         : undefined;
-    // Bei select-Feldern: translated Option-Labels einbacken. Convention
-    // matcht den Form-Path → eine Translation-Quelle für List + Form.
-    // Missing-Key returnt convention-gemäß den Key zurück; Renderer hat
-    // dann humanizeSlug-Fallback.
+    // For select and multiSelect fields: bake in translated option labels.
+    // Convention matches the form path → one translation source for list +
+    // form. A missing key returns the key itself per convention; the
+    // renderer then falls back to humanizeSlug.
     const optionLabels =
-      fieldDef.type === "select"
+      fieldDef.type === "select" || fieldDef.type === "multiSelect"
         ? buildOptionLabels(
             translate,
             (value) => fieldOptionLabelKey(featureName, screen.entity, normalized.field, value),

package/src/view-model/types.ts

@@ -43,9 +43,10 @@ export type ListColumnViewModel = {
   readonly type: string; // field-type ("text", "number", "money", ...)
   readonly renderer?: FieldRenderer | RuntimeRenderer;
   readonly sortable: boolean;
-  /** Nur bei `type: "select"` — translated Option-Labels keyed nach raw
-   *  value. Renderer rendert `optionLabels[value]` statt humanizeSlug
-   *  wenn vorhanden. Convention-Key: `<feature>:entity:<entity>:field:<field>:option:<value>`. */
+  /** Only for `type: "select"` or `type: "multiSelect"` — translated option
+   *  labels keyed by raw value. The renderer renders `optionLabels[value]`
+   *  instead of humanizeSlug when present. Convention key:
+   *  `<feature>:entity:<entity>:field:<field>:option:<value>`. */
   readonly optionLabels?: Readonly<Record<string, string>>;
   /** Nur bei `type: "reference"` — referenced Entity-Name für Bulk-
    *  Lookup im Renderer (`<refFeature>:query:<refEntity>:list`). */