@cosmicdrift/kumiko-renderer 0.130.0 → 0.130.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.130.0",
+  "version": "0.130.1",
   "description": "Platform-agnostic React renderer for Kumiko screens. Contains the shared logic — primitives-contract, hooks, KumikoScreen, navigation & SSE abstractions — that any platform-specific renderer (web, native) composes. No DOM, no EventSource, no react-dom.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -15,8 +15,8 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.130.0",
-    "@cosmicdrift/kumiko-headless": "0.130.0",
+    "@cosmicdrift/kumiko-framework": "0.130.1",
+    "@cosmicdrift/kumiko-headless": "0.130.1",
     "react": "^19.2.6"
   },
   "devDependencies": {

package/src/__tests__/i18n.test.tsx

@@ -6,6 +6,7 @@ import {
   createStaticLocaleResolver,
   LocaleProvider,
   type TranslationsByLocale,
+  translationsByLocaleFromKeys,
   useLocale,
   useTranslation,
 } from "../i18n";
@@ -146,6 +147,23 @@ describe("useTranslation — referential stability", () => {
     expect((Probe as unknown as { lastT?: unknown }).lastT).toBe(firstT);
   });
 });
+describe("translationsByLocaleFromKeys", () => {
+  test("pivots key-first source to locale-first bundles losslessly", () => {
+    const source = {
+      "app:nav.home": { de: "Start", en: "Home" },
+      "app:nav.settings": { de: "Einstellungen", en: "Settings" },
+    };
+    const byLocale = translationsByLocaleFromKeys(source);
+    expect(byLocale["de"]).toEqual({
+      "app:nav.home": "Start",
+      "app:nav.settings": "Einstellungen",
+    });
+    expect(byLocale["en"]).toEqual({
+      "app:nav.home": "Home",
+      "app:nav.settings": "Settings",
+    });
+  });
+});
 describe("useLocale", () => {
   test("returns the resolver", () => {
     const resolver = createStaticLocaleResolver({ locale: "de" });

package/src/i18n.tsx

@@ -32,6 +32,22 @@ export type TranslationBundle = Readonly<Record<string, string>>;
 /** Map von Locale-Code (BCP-47, z.B. `"de"`, `"en-US"`) → Bundle. */
 export type TranslationsByLocale = Readonly<Record<string, TranslationBundle>>;
 
+/** Key-first shape for `r.translations({ keys })` — each key maps locale → string. */
+export type TranslationsByKey = Readonly<Record<string, Readonly<Record<string, string>>>>;
+
+/** Pivot key-first server translations to locale-first client bundles. */
+export function translationsByLocaleFromKeys(source: TranslationsByKey): TranslationsByLocale {
+  const out: Record<string, Record<string, string>> = {};
+  for (const [key, byLocale] of Object.entries(source)) {
+    for (const [locale, value] of Object.entries(byLocale)) {
+      const bucket = out[locale] ?? {};
+      bucket[key] = value;
+      out[locale] = bucket;
+    }
+  }
+  return out;
+}
+
 /** Merged zwei TranslationsByLocale-Maps — der override gewinnt pro Key,
  *  die Locales werden zusammengeführt. Standard-Baustein für Client-
  *  Plugins, die App-Overrides über ihre Default-Bundles legen. */

package/src/index.ts

@@ -77,12 +77,14 @@ export { useStore, useStoreSelector } from "./hooks/use-store";
 export type {
   LocaleProviderProps,
   TranslationBundle,
+  TranslationsByKey,
   TranslationsByLocale,
 } from "./i18n";
 export {
   createStaticLocaleResolver,
   LocaleProvider,
   mergeTranslations,
+  translationsByLocaleFromKeys,
   useLocale,
   useTranslation,
 } from "./i18n";