@cosmicdrift/kumiko-headless 0.234.0 → 0.235.1

package/package.json

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

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

@@ -3,6 +3,7 @@ import type {
   EntityDefinition,
   EntityListScreenDefinition,
 } from "@cosmicdrift/kumiko-framework/ui-types";
+import { LIST_ROW_META_COLUMNS } from "@cosmicdrift/kumiko-framework/ui-types";
 import { computeListViewModel } from "../list";
 
 // Minimal EntityDefinition-shape. ui-core's view-model only reads
@@ -264,6 +265,52 @@ describe("computeListViewModel", () => {
     });
   });
 
+  // Table-driven over LIST_ROW_META_COLUMNS itself (not one-off cases) — a
+  // row-meta column (id/tenantId/version/insertedAt/...) is a base-table
+  // column, never a declared entity field (a SystemAdmin cross-tenant list
+  // picks tenantId as a column this way). Together with boot-validator.test.ts
+  // (both boot validators accept the same set) and list-row-meta-drift.test.ts
+  // (LIST_ROW_META_COLUMNS key-set drift guard), this pins "whatever boot
+  // accepts as a row-meta column, the renderer can actually draw" — a #2601
+  // review found the two sides had drifted apart.
+  test("every row-meta column resolves to its declared type, sortable, no throw", () => {
+    for (const [field, expectedType] of Object.entries(LIST_ROW_META_COLUMNS)) {
+      const vm = computeListViewModel({
+        screen: listScreen(["title", field]),
+        entity: taskEntity,
+        rows: [],
+        translate,
+        featureName: "tasks",
+      });
+
+      expect(vm.columns[1]).toEqual({
+        field,
+        label: `tasks:entity:task:field:${field}`,
+        type: expectedType,
+        sortable: true,
+      });
+    }
+  });
+
+  test("row-meta column: explicit label + renderer are passed through unchanged", () => {
+    const fmt = { format: "currency" as const, symbol: "€" };
+    const vm = computeListViewModel({
+      screen: listScreen([{ field: "insertedAt", label: "custom.created", renderer: fmt }]),
+      entity: taskEntity,
+      rows: [],
+      translate,
+      featureName: "tasks",
+    });
+
+    expect(vm.columns[0]).toEqual({
+      field: "insertedAt",
+      label: "custom.created",
+      type: "timestamp",
+      sortable: true,
+      renderer: fmt,
+    });
+  });
+
   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

@@ -3,7 +3,11 @@ import type {
   EntityListScreenDefinition,
   FieldDefinition,
 } from "@cosmicdrift/kumiko-framework/ui-types";
-import { normalizeListColumn, parseRefTarget } from "@cosmicdrift/kumiko-framework/ui-types";
+import {
+  LIST_ROW_META_COLUMNS,
+  normalizeListColumn,
+  parseRefTarget,
+} from "@cosmicdrift/kumiko-framework/ui-types";
 import type { ListColumnViewModel, ListRowViewModel, ListViewModel, Translate } from "./types";
 
 export type ComputeListViewModelInput = {
@@ -42,6 +46,24 @@ export function computeListViewModel(input: ComputeListViewModelInput): ListView
       // columns carry no reference/select metadata and never server-sort.
       const derivedDef = entity.derivedFields?.[normalized.field];
       if (!derivedDef) {
+        // Row-meta column (id/tenantId/version/insertedAt/modifiedAt/...) —
+        // 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.
+        const rowMetaType = LIST_ROW_META_COLUMNS[normalized.field];
+        if (rowMetaType !== undefined) {
+          columns.push({
+            field: normalized.field,
+            label: translate(
+              normalized.label ?? fieldLabelKey(featureName, screen.entity, normalized.field),
+            ),
+            type: rowMetaType,
+            sortable: true,
+            ...(normalized.renderer !== undefined && { renderer: normalized.renderer }),
+          });
+          continue;
+        }
         // A virtual presentational column — drawn entirely by a columnRenderer
         // component from the row (e.g. tag chips); value is undefined and it
         // never server-sorts. `field` is just the column key. It needs BOTH a