@cosmicdrift/kumiko-headless 0.34.1 → 0.35.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.34.1",
+  "version": "0.35.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>",

package/src/index.ts

@@ -77,6 +77,7 @@ export type {
   ListColumnViewModel,
   ListRowViewModel,
   ListViewModel,
+  RuntimeRenderer,
   ScreenSlots,
   Translate,
 } from "./view-model";

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

@@ -57,7 +57,7 @@ describe("computeListViewModel", () => {
   });
 
   test("object-form column carries renderer through to the view model", () => {
-    const fmt = (v: unknown) => `${v} !`;
+    const fmt = { format: "currency" as const, symbol: "€" };
     const vm = computeListViewModel({
       screen: listScreen([{ field: "title", renderer: fmt }]),
       entity: taskEntity,
@@ -66,7 +66,7 @@ describe("computeListViewModel", () => {
       featureName: "tasks",
     });
 
-    expect(vm.columns[0]?.renderer).toBe(fmt);
+    expect(vm.columns[0]?.renderer).toEqual(fmt);
   });
 
   test("rows map to { id, values } with id pulled from the row", () => {

package/src/view-model/index.ts

@@ -16,6 +16,7 @@ export type {
   ListColumnViewModel,
   ListRowViewModel,
   ListViewModel,
+  RuntimeRenderer,
   ScreenSlots,
   Translate,
 } from "./types";

package/src/view-model/types.ts

@@ -7,6 +7,11 @@ import type {
   ScreenSlots,
 } from "@cosmicdrift/kumiko-framework/ui-types";
 
+// Runtime-only renderer — function form allowed here because the renderer
+// layer (render-list) injects reference-column lookup closures at mount time.
+// Never serialized to JSON.
+export type RuntimeRenderer = (value: unknown, row?: Readonly<Record<string, unknown>>) => string;
+
 // View-Models — plain data structures produced by computeListViewModel and
 // computeEditViewModel. They flatten the combined [screen-def + entity-def
 // + row-data + user] inputs into a shape the renderer draws directly,
@@ -29,12 +34,13 @@ import type {
 // One column, fully resolved. `label` is the localized string the
 // renderer puts in the column header; view-model builder runs it through
 // LocaleResolver.translate() from the i18nKey wired onto the field.
-// `renderer` passes through ScreenDefinition's FieldRenderer verbatim.
+// `renderer` passes through ScreenDefinition's FieldRenderer verbatim; the
+// renderer layer may also inject a RuntimeRenderer closure (reference lookups).
 export type ListColumnViewModel = {
   readonly field: string;
   readonly label: string;
   readonly type: string; // field-type ("text", "number", "money", ...)
-  readonly renderer?: FieldRenderer;
+  readonly renderer?: FieldRenderer | RuntimeRenderer;
   readonly sortable: boolean;
   /** Nur bei `type: "select"` — translated Option-Labels keyed nach raw
    *  value. Renderer rendert `optionLabels[value]` statt humanizeSlug