@cosmicdrift/kumiko-types 0.214.0 → 0.215.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.214.0",
+  "version": "0.215.0",
   "description": "Framework-Type-Definitions für Kumiko — FeatureDefinition, BootCheck-Types und die reinen Engine-Types. Erlaubt Downstream-Konsumenten, gegen die Type-Contracts zu bauen, ohne das ganze Framework-Package zu importieren. Enthaelt keine identitaets-sensitiven Runtime-Werte mehr (Error-Klassen leben seit #1629 in kumiko-framework, Brand-Symbole nutzen Symbol.for) und ist deshalb eine plain dependency, keine peerDependency.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",

package/src/handlers.ts

@@ -35,6 +35,11 @@ export type SessionUser = {
   // to tenant.timezone, then "UTC" (buildHandlerContext, fw#1636). Stale
   // until re-login — same tradeoff as `roles`.
   readonly timezone?: string;
+  // BCP-47 tag from user.locale, set at login. Absent → ctx.locale falls
+  // back to the app's boot-configured defaultLocale, then "en"
+  // (dispatch-shared.ts, fw#2333). Stale until re-login — same tradeoff as
+  // `timezone`.
+  readonly locale?: string;
   // App-specific identity facts baked into the JWT at login time.
   // Populated by `r.authClaims()` hooks (not yet implemented — see the
   // auth-claims design note in docs/plans). Reserved here so the type shape

package/src/screen.ts

@@ -60,6 +60,11 @@ export interface FieldFormatRegistry {
     readonly locale?: string;
     readonly unitDisplay?: "long" | "short" | "narrow";
   };
+  // Resolves an enum value through the i18n convention
+  // `<feature>:entity:<entity>:field:<field>:option:<value>` — same
+  // fallback-to-raw-value rule as buildOptionLabels: an untranslated key
+  // renders the raw enum value instead of the literal i18n key.
+  enumOption: { readonly keyPrefix: string };
 }
 
 // Discriminated union derived from the registry — one variant per key.