@cosmicdrift/kumiko-headless 0.170.0 → 0.171.0

package/package.json

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

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

@@ -287,6 +287,42 @@ describe("computeEditViewModel", () => {
     });
     expect(asFields(vm.sections[0]).fields[0]?.span).toBe(2);
   });
+
+  test("section.description is translated and passed through; absent stays undefined", () => {
+    const vm = computeEditViewModel({
+      screen: editScreen({
+        sections: [
+          {
+            title: "Basics",
+            description: "orders:screen:order-edit.basics.help",
+            fields: ["notes"],
+          },
+          { title: "Extra", fields: ["kind"] },
+        ],
+      }),
+      entity: orderEntity,
+      values: {},
+      translate,
+      featureName: "orders",
+    });
+    expect(asFields(vm.sections[0]).description).toBe("orders:screen:order-edit.basics.help");
+    expect(asFields(vm.sections[1]).description).toBeUndefined();
+  });
+
+  test("field.icon propagates to the view model; absent stays undefined", () => {
+    const vm = computeEditViewModel({
+      screen: editScreen({
+        sections: [{ title: "x", fields: [{ field: "customerName", icon: "user" }, "notes"] }],
+      }),
+      entity: orderEntity,
+      values: {},
+      translate,
+      featureName: "orders",
+    });
+    const fields = asFields(vm.sections[0]).fields;
+    expect(fields[0]?.icon).toBe("user");
+    expect(fields[1]?.icon).toBeUndefined();
+  });
 });
 
 describe("computeEditViewModel — date/timestamp min/max/locale (#369)", () => {

package/src/view-model/edit.ts

@@ -151,6 +151,7 @@ export function computeEditViewModel<
         ...(fileDef?.accept !== undefined && { accept: fileDef.accept }),
         ...(fileDef?.maxSize !== undefined && { maxSize: fileDef.maxSize }),
         ...(isFileType && { entityType: screen.entity, fieldName: normalized.field }),
+        ...(normalized.icon !== undefined && { icon: normalized.icon }),
       };
       return view;
     });
@@ -162,6 +163,9 @@ export function computeEditViewModel<
       visible,
       // Titellose Section (flache Form) → kein h3; nur übersetzen wenn gesetzt.
       ...(sectionSpec.title !== undefined && { title: translate(sectionSpec.title) }),
+      ...(sectionSpec.description !== undefined && {
+        description: translate(sectionSpec.description),
+      }),
       columns: sectionSpec.columns ?? 1,
       fields,
     };

package/src/view-model/types.ts

@@ -143,6 +143,11 @@ export type EditFieldViewModel = {
    *  die richtige Field-Def prüfen kann. */
   readonly entityType?: string;
   readonly fieldName?: string;
+  /** Prefix-icon key from `EditFieldSpec.icon`, passed through unchanged
+   *  (no i18n — it's a symbolic key, not a display string). The renderer
+   *  resolves it against the FIELD_ICONS registry; unknown keys silently
+   *  fall back to "no icon". */
+  readonly icon?: string;
 };
 
 // Discriminated by `kind` — mirrors EditSectionSpec on the engine side.
@@ -158,6 +163,9 @@ export type EditFieldsSectionViewModel = {
   readonly visible: boolean;
   /** Optional — eine titellose Section rendert nur ihre Felder (flache Form). */
   readonly title?: string;
+  /** Translated help text under the block heading, from
+   *  `EditFieldsSection.description`. Renders even without `title`. */
+  readonly description?: string;
   readonly columns: number;
   readonly fields: readonly EditFieldViewModel[];
 };