@cosmicdrift/kumiko-types 0.212.0 → 0.213.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.212.0",
+  "version": "0.213.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

@@ -335,6 +335,11 @@ export type AppContext = SharedContextFields & {
    *  Sprint-8a Tier-Composition: `effectiveFeatures(ctx._tenantId)`-call
    *  in den hook-filter-Stellen. */
   readonly _tenantId?: TenantId;
+  /** Boot-configured default locale (BCP-47). Last fallback in ctx.locale's
+   *  Request-Locale → Boot-Default chain (dispatch-shared.ts) — used when
+   *  the request carries no X-Locale header and no usable Accept-Language.
+   *  Absent falls back to "en". */
+  readonly defaultLocale?: string;
 };
 
 // Handler execution: db (tenant-scoped) + registry guaranteed.
@@ -561,6 +566,13 @@ export type HandlerContext<TMap extends object = KumikoEventTypeMap> = SharedCon
   // back to tenant).
   readonly tz: TzContext;
 
+  // Resolved request locale (BCP-47): X-Locale header → Accept-Language →
+  // the app's boot-configured defaultLocale → "en" (dispatch-shared.ts).
+  // Always a concrete tag, never optional — mirrors ctx.tz's Request →
+  // Boot-Default fallback chain, so handlers never need to check for
+  // absence before using it.
+  readonly locale: string;
+
   // Resolve every registered r.authClaims() hook against `user` and return
   // the merged claim record (keys auto-prefixed with the feature name). Used
   // by login + switch-tenant write-handlers to populate SessionUser.claims

package/src/screen.ts

@@ -25,6 +25,14 @@ export type PlatformComponent = {
   readonly native?: unknown;
 };
 
+// Closed set of unit identifiers for `{ format: "unit" }` (no bare `string`
+// per house convention). "m2" has no ECMA-402 sanctioned unit — Intl throws
+// RangeError for "square-meter" — so kumiko-headless's applyFormatSpec
+// formats it as a locale-formatted number with a literal "m²" suffix. The
+// rest map to a CLDR-sanctioned Intl.NumberFormat unit id and get
+// locale-correct pluralization/spacing straight from Intl.
+export type UnitKey = "m2" | "km" | "m" | "kg" | "percent";
+
 // Built-in value formatters. Apps extend via module augmentation:
 //   declare module "@cosmicdrift/kumiko-framework/engine/types" {
 //     interface FieldFormatRegistry { myFormat: { myOption?: string } }
@@ -47,6 +55,11 @@ export interface FieldFormatRegistry {
   number: { readonly locale?: string };
   decimal: { readonly locale?: string };
   bigInt: { readonly locale?: string };
+  unit: {
+    readonly unit: UnitKey;
+    readonly locale?: string;
+    readonly unitDisplay?: "long" | "short" | "narrow";
+  };
 }
 
 // Discriminated union derived from the registry — one variant per key.