@cosmicdrift/kumiko-headless 0.235.1 → 0.235.3

package/package.json

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

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

@@ -3,7 +3,10 @@ import type {
   EntityDefinition,
   EntityListScreenDefinition,
 } from "@cosmicdrift/kumiko-framework/ui-types";
-import { LIST_ROW_META_COLUMNS } from "@cosmicdrift/kumiko-framework/ui-types";
+import {
+  LIST_ROW_META_COLUMNS,
+  LIST_ROW_META_REFERENCES,
+} from "@cosmicdrift/kumiko-framework/ui-types";
 import { computeListViewModel } from "../list";
 
 // Minimal EntityDefinition-shape. ui-core's view-model only reads
@@ -283,15 +286,59 @@ describe("computeListViewModel", () => {
         featureName: "tasks",
       });
 
+      const ref = LIST_ROW_META_REFERENCES[field];
       expect(vm.columns[1]).toEqual({
         field,
         label: `tasks:entity:task:field:${field}`,
-        type: expectedType,
-        sortable: true,
+        ...(ref !== undefined
+          ? {
+              type: "reference",
+              sortable: false,
+              refFeature: ref.refFeature,
+              refEntity: ref.refEntity,
+              refLabelField: ref.refLabelField,
+            }
+          : { type: expectedType, sortable: true }),
       });
     }
   });
 
+  // tenantId carries a GUID in the DB but should render the referenced
+  // tenant's display name, like a declared reference field does — not the
+  // raw GUID. insertedById stays unchanged: this also pins that the map
+  // switches exactly one column, not every row-meta ID column.
+  test("tenantId row-meta column resolves as a reference column, insertedById unchanged", () => {
+    const vm = computeListViewModel({
+      screen: listScreen(["tenantId", "insertedById", "id"]),
+      entity: taskEntity,
+      rows: [],
+      translate,
+      featureName: "tasks",
+    });
+
+    expect(vm.columns[0]).toEqual({
+      field: "tenantId",
+      label: "tasks:entity:task:field:tenantId",
+      type: "reference",
+      sortable: false,
+      refFeature: "tenant",
+      refEntity: "tenant",
+      refLabelField: "name",
+    });
+    expect(vm.columns[1]).toEqual({
+      field: "insertedById",
+      label: "tasks:entity:task:field:insertedById",
+      type: "text",
+      sortable: true,
+    });
+    expect(vm.columns[2]).toEqual({
+      field: "id",
+      label: "tasks:entity:task:field:id",
+      type: "text",
+      sortable: true,
+    });
+  });
+
   test("row-meta column: explicit label + renderer are passed through unchanged", () => {
     const fmt = { format: "currency" as const, symbol: "€" };
     const vm = computeListViewModel({

package/src/view-model/list.ts

@@ -5,6 +5,7 @@ import type {
 } from "@cosmicdrift/kumiko-framework/ui-types";
 import {
   LIST_ROW_META_COLUMNS,
+  LIST_ROW_META_REFERENCES,
   normalizeListColumn,
   parseRefTarget,
 } from "@cosmicdrift/kumiko-framework/ui-types";
@@ -50,17 +51,26 @@ export function computeListViewModel(input: ComputeListViewModelInput): ListView
         // a real base-table column that's never a declared entity field, e.g.
         // a SystemAdmin cross-tenant list exposing tenantId. Unlike the
         // derivedFields branch above, these are actual DB columns, so
-        // server-side ORDER BY works — sortable stays true.
+        // server-side ORDER BY works — sortable stays true, except for the
+        // ID columns in LIST_ROW_META_REFERENCES (see their reference branch).
         const rowMetaType = LIST_ROW_META_COLUMNS[normalized.field];
         if (rowMetaType !== undefined) {
+          const rowMetaRef = LIST_ROW_META_REFERENCES[normalized.field];
           columns.push({
             field: normalized.field,
             label: translate(
               normalized.label ?? fieldLabelKey(featureName, screen.entity, normalized.field),
             ),
-            type: rowMetaType,
-            sortable: true,
+            type: rowMetaRef !== undefined ? "reference" : rowMetaType,
+            // The DB column holds the GUID, not the resolved label — server-side
+            // ORDER BY would sort by GUID while the cell shows the name.
+            sortable: rowMetaRef === undefined,
             ...(normalized.renderer !== undefined && { renderer: normalized.renderer }),
+            ...(rowMetaRef !== undefined && {
+              refEntity: rowMetaRef.refEntity,
+              refFeature: rowMetaRef.refFeature,
+              refLabelField: rowMetaRef.refLabelField,
+            }),
           });
           continue;
         }