@cosmicdrift/kumiko-types 0.211.0 → 0.213.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.211.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/nav-icon.ts

@@ -36,6 +36,8 @@ export type NavIconKey =
   | "home"
   | "bell"
   | "shield"
+  | "shield-check"
+  | "send"
   | "settings"
   | "users"
   | "user"

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.
@@ -209,12 +222,19 @@ export type RowActionNavigate = {
   readonly id: string;
   readonly label: string;
   /** Screen-id (kurz, unqualified) zu dem navigiert wird. Boot-
-   *  Validator prüft Existenz im selben Feature. */
-  readonly screen: string;
+   *  Validator prüft Existenz im selben Feature. Genau eines von
+   *  `screen`/`entity` muss gesetzt sein. */
+  readonly screen?: string;
+  /** Entity-Name statt Screen-Id (fw#2228) — löst zur Boot-Zeit auf den
+   *  Screen auf, der `detailFor: "<entity>"` deklariert (siehe ObjectTarget/
+   *  resolveTarget in @cosmicdrift/kumiko-renderer's nav.tsx), egal in
+   *  welchem Feature dieser liegt. Genau eines von `screen`/`entity` muss
+   *  gesetzt sein. */
+  readonly entity?: string;
   /** Feldname dessen Wert als entityId in den URL-Pfad eingebettet wird
    *  (`/<workspace>/<screen>/<entityId>`). entityEdit liest die Id
-   *  AUSSCHLIESSLICH aus dem Pfad. Default: "id" wenn der Ziel-Screen
-   *  ein entityEdit ist. */
+   *  AUSSCHLIESSLICH aus dem Pfad. Default: "id" wenn der Ziel-Screen ein
+   *  entityEdit ist ODER wenn `entity` (statt `screen`) gesetzt ist. */
   readonly entityId?: string;
   /** Declarative URL search params extracted from the clicked row.
    *  Both actionForm and entityEdit-create targets read `params` as