@cosmicdrift/kumiko-framework 0.207.0 → 0.208.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-framework",
-  "version": "0.207.0",
+  "version": "0.208.0",
   "description": "Framework core — engine, pipeline, API, DB, and every other bit that makes Kumiko go.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -190,7 +190,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-types": "0.207.0",
+    "@cosmicdrift/kumiko-types": "0.208.0",
     "bullmq": "^5.76.7",
     "bun-types": "^1.3.13",
     "hono": "^4.13.1",
@@ -206,7 +206,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.207.0",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.208.0",
     "bun-types": "^1.3.13",
     "pino-pretty": "^13.1.3"
   },

package/src/engine/__tests__/boot-validator-i18n-keys.test.ts

@@ -77,15 +77,15 @@ describe("validateBoot — i18n surface keys", () => {
     expect(() => validateBoot([feature])).toThrow(/required translation key missing/);
   });
 
-  test("throws when de/en locale is missing", () => {
+  test("does not require every locale on every key", () => {
     const feature = defineFeature("demo", (r) => {
       r.nav({ id: "home", label: "demo:nav.home" });
       r.translations({
         keys: {
-          "demo:nav.home": { de: "Start", en: "" },
+          "demo:nav.home": { de: "Start" },
         },
       });
     });
-    expect(() => validateBoot([feature])).toThrow(/missing locale\(s\): en/);
+    expect(() => validateBoot([feature])).not.toThrow();
   });
 });

package/src/engine/boot-validator/i18n-keys.ts

@@ -1,7 +1,6 @@
 import {
   buildEffectiveTranslationKeys,
   featureHasI18nSurface,
-  findTranslationLocaleGaps,
   requiredKeysFromFeature,
   requiredKeysFromNav,
   requiredKeysFromScreen,
@@ -75,10 +74,4 @@ export function validateI18nSurfaceKeys(features: readonly FeatureDefinition[]):
       throw new Error(`[i18n] Settings-Hub: required translation key missing: "${key}"`);
     }
   }
-
-  for (const gap of findTranslationLocaleGaps(features)) {
-    throw new Error(
-      `[i18n] Feature "${gap.featureName}": key "${gap.key}" missing locale(s): ${gap.missingLocales.join(", ")}`,
-    );
-  }
 }

package/src/i18n/__tests__/mail-registry.test.ts

@@ -0,0 +1,23 @@
+import { describe, expect, test } from "bun:test";
+import { hasMailTranslations, mailT, registerMailTranslations } from "../mail-registry";
+
+describe("mail-registry", () => {
+  registerMailTranslations("en", { "test.hi": "Hello {name}" });
+
+  test("falls back to English when locale is missing", () => {
+    expect(mailT("fr", "test.hi", { name: "Ada" })).toBe("Hello Ada");
+  });
+
+  test("registered locale wins", () => {
+    registerMailTranslations("de", { "test.hi": "Hallo {name}" });
+    expect(mailT("de", "test.hi", { name: "Ada" })).toBe("Hallo Ada");
+  });
+});
+
+test("hasMailTranslations is true only for registered locales", () => {
+  expect(hasMailTranslations("en")).toBe(true);
+  expect(hasMailTranslations("fr")).toBe(false);
+  registerMailTranslations("de", { "test.hi": "Hallo {name}" });
+  expect(hasMailTranslations("de")).toBe(true);
+  expect(hasMailTranslations("de-AT")).toBe(true);
+});

package/src/i18n/index.ts

@@ -1,5 +1,7 @@
 import type { Registry, TranslationKeys } from "../engine/types";
 
+export { hasMailTranslations, mailT, registerMailTranslations } from "./mail-registry";
+
 export type I18nOptions = {
   defaultLocale: string;
 };

package/src/i18n/mail-registry.ts

@@ -0,0 +1,26 @@
+const tables = new Map<string, Readonly<Record<string, string>>>();
+
+export function registerMailTranslations(
+  locale: string,
+  bundle: Readonly<Record<string, string>>,
+): void {
+  const prev = tables.get(locale) ?? {};
+  tables.set(locale, { ...prev, ...bundle });
+}
+
+export function hasMailTranslations(locale: string): boolean {
+  const root = locale.split("-")[0] ?? locale;
+  return tables.has(locale) || tables.has(root);
+}
+
+export function mailT(
+  locale: string,
+  key: string,
+  params?: Readonly<Record<string, string>>,
+): string {
+  const root = locale.split("-")[0] ?? locale;
+  const raw =
+    tables.get(locale)?.[key] ?? tables.get(root)?.[key] ?? tables.get("en")?.[key] ?? key;
+  if (params === undefined) return raw;
+  return raw.replace(/\{(\w+)\}/g, (_, name: string) => params[name] ?? `{${name}}`);
+}

package/src/i18n/required-surface-keys.ts

@@ -322,23 +322,9 @@ export type TranslationLocaleGap = {
   readonly missingLocales: readonly string[];
 };
 
-const REQUIRED_LOCALES = ["de", "en"] as const;
-
+/** Locale completeness is opt-in via @cosmicdrift/kumiko-locale-* packages. */
 export function findTranslationLocaleGaps(
-  features: readonly FeatureDefinition[],
+  _features: readonly FeatureDefinition[],
 ): readonly TranslationLocaleGap[] {
-  const gaps: TranslationLocaleGap[] = [];
-  for (const feature of features) {
-    for (const [localKey, entry] of Object.entries(feature.translations ?? {})) {
-      const missing = REQUIRED_LOCALES.filter((locale) => (entry[locale] ?? "").length === 0);
-      if (missing.length > 0) {
-        gaps.push({
-          featureName: feature.name,
-          key: localKey,
-          missingLocales: missing,
-        });
-      }
-    }
-  }
-  return gaps;
+  return [];
 }