@cosmicdrift/kumiko-headless 0.232.0 → 0.234.0

package/package.json

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

package/src/format/__tests__/format.test.ts

@@ -121,6 +121,17 @@ describe("applyFormatSpec — unit (fw#2187)", () => {
     );
   });
 
+  test("mi (Meilen) geht über Intl.NumberFormat(style:'unit') genau wie km", () => {
+    expect(applyFormatSpec({ format: "unit", unit: "mi" }, 58)).toBe(
+      new Intl.NumberFormat(undefined, {
+        style: "unit",
+        unit: "mile",
+        unitDisplay: "short",
+      }).format(58),
+    );
+    expect(applyFormatSpec({ format: "unit", unit: "mi", locale: "en-US" }, 12)).toBe("12 mi");
+  });
+
   test("m2 hat kein ECMA-402-sanktioniertes Intl-Unit (RangeError für 'square-meter') — Zahl + literales Suffix", () => {
     expect(applyFormatSpec({ format: "unit", unit: "m2", locale: "de-DE" }, 58)).toBe("58 m²");
     expect(applyFormatSpec({ format: "unit", unit: "m2", locale: "de-DE" }, 1234.5)).toBe(
@@ -201,7 +212,7 @@ describe("applyFormatSpec — enumOption (fw#2315)", () => {
 describe("unit format keys stay in lockstep with UnitKey", () => {
   // Mirror of packages/types/src/screen.ts UnitKey — keep lists equal without
   // adding a kumiko-types dependency to headless.
-  const TYPE_UNIT_KEYS = ["m2", "km", "m", "kg", "percent"] as const;
+  const TYPE_UNIT_KEYS = ["m2", "km", "m", "kg", "percent", "mi"] as const;
   test("every UnitKey formats with a non-bare number", () => {
     for (const k of TYPE_UNIT_KEYS) {
       expect(UNIT_FORMAT_KEYS.includes(k)).toBe(true);

package/src/format/index.ts

@@ -90,6 +90,7 @@ const UNIT_INTL_IDS = {
   m: "meter",
   kg: "kilogram",
   percent: "percent",
+  mi: "mile",
 } as const;
 
 // "m2" (square meter) has no ECMA-402 sanctioned unit — Intl.NumberFormat

package/src/view-model/edit.ts

@@ -316,6 +316,7 @@ export function computeEditViewModel<
         // per row — one value for the whole embedded list.
         ...(embeddedListDef !== undefined && { embeddedListCurrency: resolvedCurrency }),
         ...(fieldDef.type === "money" && { currency: resolvedCurrency }),
+        ...(fieldDef.type === "number" && fieldDef.unit !== undefined && { unit: fieldDef.unit }),
       };
       return view;
     });
@@ -332,6 +333,7 @@ export function computeEditViewModel<
       }),
       columns: sectionSpec.columns ?? 1,
       fields,
+      ...(sectionSpec.icon !== undefined && { icon: sectionSpec.icon }),
     };
   });
 

package/src/view-model/types.ts

@@ -3,6 +3,7 @@ import type {
   EditSectionSpec,
   FieldIconKey,
   FieldRenderer,
+  IconKey,
   ListColumnSpec,
   PlatformComponent,
   ScreenSlots,
@@ -234,6 +235,10 @@ export type EditFieldViewModel = {
    *  falls back to "EUR"). The renderer needs this to build the payload's
    *  `{amount, currency}` shape (kumiko-framework#1923). */
   readonly currency?: string;
+  /** Only set for `type: "number"` when NumberFieldDef.unit is set — a static
+   *  suffix string, or a sibling-field reference the renderer resolves against
+   *  the live row values. Display-only, never converts the stored number. */
+  readonly unit?: string | { readonly field: string };
 };
 
 // Discriminated by `kind` — mirrors EditSectionSpec on the engine side.
@@ -257,6 +262,9 @@ export type EditFieldsSectionViewModel = {
   readonly description?: string;
   readonly columns: number;
   readonly fields: readonly EditFieldViewModel[];
+  /** From `EditFieldsSection.icon` — closed IconKey vocabulary, renders
+   *  left of the title. No effect without `title`. */
+  readonly icon?: IconKey;
 };
 
 export type EditExtensionSectionViewModel = {