@cosmicdrift/kumiko-headless 0.214.0 → 0.215.1

package/package.json

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

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

@@ -154,3 +154,38 @@ describe("applyFormatSpec — unit (fw#2187)", () => {
     expect(applyFormatSpec({ format: "unit", unit: "km" }, "")).toBe("");
   });
 });
+
+describe("applyFormatSpec — enumOption (fw#2315)", () => {
+  const spec = { format: "enumOption", keyPrefix: "contact:entity:contact:field:status:option:" };
+
+  test("übersetzter Key gewinnt gegen den Rohwert", () => {
+    const translate = (key: string) =>
+      key === "contact:entity:contact:field:status:option:active" ? "Aktiv" : key;
+    expect(applyFormatSpec(spec, "active", translate)).toBe("Aktiv");
+  });
+
+  test("unbekannter Key fällt auf den Rohwert zurück (translate gibt den Key unverändert zurück)", () => {
+    const translate = (key: string) => key;
+    expect(applyFormatSpec(spec, "active", translate)).toBe("active");
+  });
+
+  test("ohne translate-Parameter fällt auf den Rohwert zurück", () => {
+    expect(applyFormatSpec(spec, "active")).toBe("active");
+  });
+
+  test("ohne keyPrefix fällt auf den Rohwert zurück, auch mit translate", () => {
+    const translate = (key: string) => `translated:${key}`;
+    expect(applyFormatSpec({ format: "enumOption" }, "active", translate)).toBe("active");
+  });
+
+  test("nicht-string-Wert wird vor der Key-Bildung stringifiziert", () => {
+    const translate = (key: string) =>
+      key === "contact:entity:contact:field:status:option:1" ? "Eins" : key;
+    expect(applyFormatSpec(spec, 1, translate)).toBe("Eins");
+  });
+
+  test("leerer Wert collapst zu '' wie jedes andere Nicht-priority-Format", () => {
+    expect(applyFormatSpec(spec, null, (k) => k)).toBe("");
+    expect(applyFormatSpec(spec, "", (k) => k)).toBe("");
+  });
+});

package/src/format/index.ts

@@ -134,6 +134,7 @@ export { currencyDecimals } from "./money";
 export function applyFormatSpec(
   spec: { format: string } & Record<string, unknown>,
   value: unknown,
+  translate?: (key: string) => string,
 ): string {
   const isEmpty = value === null || value === undefined || value === "";
   // priority renders its emptyLabel for empty values — every other format
@@ -176,6 +177,14 @@ export function applyFormatSpec(
       if (isEmpty || value === 0) return emptyLabel;
       return `${prefix}${value}`;
     }
+    case "enumOption": {
+      const raw = typeof value === "string" ? value : String(value);
+      const keyPrefix = spec["keyPrefix"] as string | undefined;
+      if (keyPrefix === undefined || translate === undefined) return raw;
+      const key = `${keyPrefix}${raw}`;
+      const translated = translate(key);
+      return translated === key ? raw : translated;
+    }
     default:
       if (typeof process !== "undefined" && process.env.NODE_ENV !== "production") {
         // biome-ignore lint/suspicious/noConsole: dev-only warning