@cosmicdrift/kumiko-headless 0.98.0 → 0.100.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.98.0",
+  "version": "0.100.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>",
@@ -32,7 +32,7 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.98.0",
+    "@cosmicdrift/kumiko-framework": "0.100.0",
     "zod": "^4.4.3"
   },
   "publishConfig": {

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

@@ -118,6 +118,41 @@ describe("computeListViewModel", () => {
     ).toThrow(/unknown field "doesNotExist"/);
   });
 
+  test("labeled column with no matching field → virtual presentational column (no throw)", () => {
+    const vm = computeListViewModel({
+      screen: listScreen([
+        "title",
+        { field: "tags", label: "Tags", renderer: { react: { __component: "TagsCell" } } },
+      ]),
+      entity: taskEntity,
+      rows: [],
+      translate,
+      featureName: "tasks",
+    });
+    // `field` becomes the column key; label is taken verbatim (translate is
+    // identity here), type defaults to text, never server-sortable.
+    expect(vm.columns[1]).toEqual({
+      field: "tags",
+      label: "Tags",
+      type: "text",
+      sortable: false,
+      renderer: { react: { __component: "TagsCell" } },
+    });
+  });
+
+  test("label overrides the field-convention header on a real field", () => {
+    const vm = computeListViewModel({
+      screen: listScreen([{ field: "title", label: "custom.header" }]),
+      entity: taskEntity,
+      rows: [],
+      translate,
+      featureName: "tasks",
+    });
+    // label goes through translate (identity here) instead of the
+    // tasks:entity:task:field:title convention key.
+    expect(vm.columns[0]?.label).toBe("custom.header");
+  });
+
   test("translate is called with the expected i18n-key per field", () => {
     const spy = mock((key: string) => `T:${key}`);
     computeListViewModel({

package/src/view-model/list.ts

@@ -42,18 +42,31 @@ export function computeListViewModel(input: ComputeListViewModelInput): ListView
       // columns carry no reference/select metadata and never server-sort.
       const derivedDef = entity.derivedFields?.[normalized.field];
       if (!derivedDef) {
-        // Screen references a field that's neither stored nor derived. Fail
-        // loud — the boot-validator (r.screen) should catch this, but a stale
-        // field-rename would leave the screen referring to a ghost column
-        // until ops re-runs boot. We throw so the renderer sees the error
-        // instead of drawing an empty column.
+        // A labeled column with no matching stored/derived field is 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. Without a label it's an
+        // author typo (or a stale field-rename) → fail loud so the renderer
+        // doesn't silently draw an empty column.
+        if (normalized.label !== undefined) {
+          columns.push({
+            field: normalized.field,
+            label: translate(normalized.label),
+            type: "text",
+            sortable: false,
+            ...(normalized.renderer !== undefined && { renderer: normalized.renderer }),
+          });
+          continue;
+        }
         throw new Error(
           `computeListViewModel: screen "${screen.id}" references unknown field "${normalized.field}" on entity "${screen.entity}"`,
         );
       }
       columns.push({
         field: normalized.field,
-        label: translate(fieldLabelKey(featureName, screen.entity, normalized.field)),
+        label: translate(
+          normalized.label ?? fieldLabelKey(featureName, screen.entity, normalized.field),
+        ),
         type: derivedDef.valueType,
         // Display-only: a header sort would round-trip to the server, which has
         // no column to sort by (see DerivedFieldDef). Never offer the affordance.
@@ -62,7 +75,9 @@ export function computeListViewModel(input: ComputeListViewModelInput): ListView
       });
       continue;
     }
-    const label = translate(fieldLabelKey(featureName, screen.entity, normalized.field));
+    const label = translate(
+      normalized.label ?? fieldLabelKey(featureName, screen.entity, normalized.field),
+    );
     // Tier 2.7e-3 + Cross-Feature: Reference-Field — entity-String
     // kann same-feature ("user") oder cross-feature ("users:user")
     // sein. parseRefTarget gibt (featureName, entityName), der