@cosmicdrift/kumiko-renderer 0.82.0 → 0.84.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.82.0",
+  "version": "0.84.0",
   "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.82.0",
-    "@cosmicdrift/kumiko-headless": "0.82.0",
+    "@cosmicdrift/kumiko-framework": "0.84.0",
+    "@cosmicdrift/kumiko-headless": "0.84.0",
     "react": "^19.2.6"
   },
   "devDependencies": {

package/src/__tests__/error-i18n-defaults.test.ts

@@ -0,0 +1,59 @@
+import { describe, expect, test } from "bun:test";
+import {
+  AccessDeniedError,
+  ConflictError,
+  FeatureDisabledError,
+  InternalError,
+  NotFoundError,
+  RateLimitError,
+  UnconfiguredError,
+  UniqueViolationError,
+  UnprocessableError,
+  ValidationError,
+  VersionConflictError,
+} from "@cosmicdrift/kumiko-framework/errors";
+import { kumikoDefaultTranslations } from "../i18n-defaults";
+
+// Keys are read off LIVE error instances, not a hardcoded list — a copied list
+// would mirror the bundle and never catch a renamed i18nKey or a new error
+// class shipped without a default translation. Ship an 11th error class (or
+// rename a key) without adding the default → this fails.
+const errorInstances = [
+  new InternalError(),
+  new AccessDeniedError(),
+  new NotFoundError("Thing"),
+  new ConflictError(),
+  new VersionConflictError({ entityId: 1, expectedVersion: 1, currentVersion: 2 }),
+  new UniqueViolationError({ entityName: "Thing" }),
+  new UnprocessableError("reason"),
+  new UnconfiguredError({ feature: "f", key: "k" }),
+  new FeatureDisabledError("f", "h"),
+  new RateLimitError({
+    bucket: "b",
+    limit: 1,
+    windowSeconds: 1,
+    remaining: 0,
+    retryAfterSeconds: 1,
+    resetAt: "1970-01-01T00:00:00Z",
+  }),
+  new ValidationError({ fields: [] }),
+];
+
+const de = kumikoDefaultTranslations["de"];
+const en = kumikoDefaultTranslations["en"];
+
+describe("kumikoDefaultTranslations covers every error i18nKey", () => {
+  for (const e of errorInstances) {
+    test(`${e.code} → ${e.i18nKey} has de+en default`, () => {
+      expect(de?.[e.i18nKey]).toBeTruthy();
+      expect(en?.[e.i18nKey]).toBeTruthy();
+    });
+  }
+
+  // Client-emitted (renderer-web download helper) — not thrown by a class, but
+  // rendered through the same last-resort bundle. Gap #5 named it explicitly.
+  test("errors.download.urlMissing has de+en default", () => {
+    expect(de?.["errors.download.urlMissing"]).toBeTruthy();
+    expect(en?.["errors.download.urlMissing"]).toBeTruthy();
+  });
+});

package/src/i18n-defaults.ts

@@ -101,6 +101,23 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
     "errors.validation.out_of_bounds": "Wert außerhalb des erlaubten Bereichs.",
     "errors.validation.invalid_option": "Ungültige Auswahl.",
     "errors.validation.failed": "Validierung fehlgeschlagen.",
+
+    // errors.* — Top-Level-Error-Codes (eine pro httpStatus-Klasse). Letzter
+    // Fallback wenn eine App keine eigene Übersetzung liefert; bewusst
+    // generisch (keine technischen Entity-/Feature-/Key-Namen an End-User —
+    // die stecken in `details` für Devs). Apps überschreiben pro Key.
+    "errors.feature.disabled": "Diese Funktion ist derzeit nicht verfügbar.",
+    "errors.access.denied": "Dazu hast du keine Berechtigung.",
+    "errors.notFound": "Nicht gefunden.",
+    "errors.conflict": "Konflikt — der Vorgang konnte nicht abgeschlossen werden.",
+    "errors.versionConflict":
+      "Der Datensatz wurde zwischenzeitlich geändert. Lade neu und versuche es erneut.",
+    "errors.uniqueViolation": "Dieser Eintrag existiert bereits.",
+    "errors.unprocessable": "Die Anfrage konnte nicht verarbeitet werden.",
+    "errors.unconfigured": "Diese Funktion ist noch nicht konfiguriert.",
+    "errors.internal": "Etwas ist schiefgegangen. Bitte versuche es später erneut.",
+    "errors.rate_limited": "Zu viele Anfragen. Bitte versuche es in Kürze erneut.",
+    "errors.download.urlMissing": "Download nicht verfügbar — bitte versuche es erneut.",
   },
   en: {
     "kumiko.actions.save": "Save",
@@ -174,5 +191,17 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
     "errors.validation.out_of_bounds": "Value out of allowed range.",
     "errors.validation.invalid_option": "Invalid choice.",
     "errors.validation.failed": "Validation failed.",
+
+    "errors.feature.disabled": "This feature is currently unavailable.",
+    "errors.access.denied": "You don't have permission to do this.",
+    "errors.notFound": "Not found.",
+    "errors.conflict": "Conflict — the operation could not be completed.",
+    "errors.versionConflict": "The record was modified in the meantime. Reload and try again.",
+    "errors.uniqueViolation": "This entry already exists.",
+    "errors.unprocessable": "The request could not be processed.",
+    "errors.unconfigured": "This feature isn't configured yet.",
+    "errors.internal": "Something went wrong. Please try again later.",
+    "errors.rate_limited": "Too many requests. Please try again shortly.",
+    "errors.download.urlMissing": "Download unavailable — please try again.",
   },
 };