@cosmicdrift/kumiko-headless 0.240.0 → 0.242.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.240.0",
+  "version": "0.242.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.240.0",
+    "@cosmicdrift/kumiko-framework": "0.242.0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
   },

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

@@ -209,6 +209,41 @@ describe("applyFormatSpec — enumOption (fw#2315)", () => {
   });
 });
 
+describe("applyFormatSpec — boolean labels through translate (fw#2683)", () => {
+  const TRUE_KEY = "managed-pages:entity:page:field:published:option:true";
+  const FALSE_KEY = "managed-pages:entity:page:field:published:option:false";
+  const spec = { format: "boolean", trueLabel: TRUE_KEY, falseLabel: FALSE_KEY };
+  const translate = (key: string): string => {
+    if (key === TRUE_KEY) return "Published";
+    if (key === FALSE_KEY) return "Draft";
+    return key;
+  };
+
+  test("an i18n key as trueLabel renders translated", () => {
+    expect(applyFormatSpec(spec, true, translate)).toBe("Published");
+  });
+
+  test("an i18n key as falseLabel renders translated", () => {
+    expect(applyFormatSpec(spec, false, translate)).toBe("Draft");
+  });
+
+  test("without translate the declared labels stay verbatim", () => {
+    expect(applyFormatSpec(spec, true)).toBe(TRUE_KEY);
+    expect(applyFormatSpec(spec, false)).toBe(FALSE_KEY);
+  });
+
+  test("a plain-text label is not mangled by a pass-through translate", () => {
+    const plain = { format: "boolean", trueLabel: "Yes", falseLabel: "No" };
+    expect(applyFormatSpec(plain, true, (k) => k)).toBe("Yes");
+    expect(applyFormatSpec(plain, false, (k) => k)).toBe("No");
+  });
+
+  test("undeclared labels keep the ✓ / empty defaults even with translate", () => {
+    expect(applyFormatSpec({ format: "boolean" }, true, translate)).toBe("✓");
+    expect(applyFormatSpec({ format: "boolean" }, false, translate)).toBe("");
+  });
+});
+
 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.

package/src/format/index.ts

@@ -162,8 +162,14 @@ export function applyFormatSpec(
             : undefined,
       });
     case "boolean": {
-      if (value === true) return (spec["trueLabel"] as string | undefined) ?? "✓";
-      if (value === false) return (spec["falseLabel"] as string | undefined) ?? "";
+      if (value === true) {
+        const trueLabel = spec["trueLabel"] as string | undefined;
+        return trueLabel === undefined ? "✓" : (translate?.(trueLabel) ?? trueLabel);
+      }
+      if (value === false) {
+        const falseLabel = spec["falseLabel"] as string | undefined;
+        return falseLabel === undefined ? "" : (translate?.(falseLabel) ?? falseLabel);
+      }
       return "";
     }
     case "currency": {
@@ -195,6 +201,8 @@ export function applyFormatSpec(
       const translated = translate(key);
       return translated === key ? raw : translated;
     }
+    case "json":
+      return JSON.stringify(value, null, (spec["indent"] as number | undefined) ?? 2);
     default:
       if (typeof process !== "undefined" && process.env.NODE_ENV !== "production") {
         // biome-ignore lint/suspicious/noConsole: dev-only warning