@cosmicdrift/kumiko-renderer 0.93.0 → 0.95.0

package/package.json

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

package/src/components/render-field.tsx

@@ -271,6 +271,18 @@ function renderInput({
           {...(field.max !== undefined && { max: field.max })}
         />
       );
+    case "locatedTimestamp":
+      return (
+        <Input
+          kind="locatedTimestamp"
+          {...common}
+          value={locatedValue(field.value)}
+          onChange={(v) => onChange(v)}
+          locale={field.dateLocale ?? appLocale}
+          {...(field.min !== undefined && { min: field.min })}
+          {...(field.max !== undefined && { max: field.max })}
+        />
+      );
     case "select": {
       // Translated Option-Labels kommen aus dem ViewModel-Builder
       // (computeEditViewModel, Convention-Key
@@ -346,3 +358,17 @@ function numberValue(v: unknown): number | "" {
   if (v === undefined || v === null || v === "") return "";
   return typeof v === "number" ? v : Number(v);
 }
+
+// locatedTimestamp-Feldwert: das Read-Wrapper liefert `{ at, tz, utc }`; leer
+// (noch nicht gesetzt) → "" als Empty-Sentinel, analog money/timestamp.
+function locatedValue(v: unknown): { at: string; tz: string; utc?: string } | "" {
+  if (v !== null && typeof v === "object" && "at" in v && "tz" in v) {
+    const o = v as { at?: unknown; tz?: unknown; utc?: unknown };
+    return {
+      at: typeof o.at === "string" ? o.at : "",
+      tz: typeof o.tz === "string" ? o.tz : "",
+      ...(typeof o.utc === "string" && { utc: o.utc }),
+    };
+  }
+  return "";
+}

package/src/i18n-defaults.ts

@@ -30,6 +30,8 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
     // Field — aria-Labels der Date/Timestamp-Primitives.
     "kumiko.field.open-calendar": "Kalender öffnen",
     "kumiko.field.time": "Uhrzeit",
+    "kumiko.field.timezone": "Zeitzone",
+    "kumiko.field.locatedTzHint": "Zeit lokal am angegebenen Ort",
 
     // List — DataTable Toolbar, Empty-State, Search.
     "kumiko.list.search-placeholder": "Suchen…",
@@ -134,6 +136,8 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
 
     "kumiko.field.open-calendar": "Open calendar",
     "kumiko.field.time": "Time",
+    "kumiko.field.timezone": "Time zone",
+    "kumiko.field.locatedTzHint": "Time local to the given location",
 
     "kumiko.list.search-placeholder": "Search…",
     "kumiko.list.empty.title": "No entries yet.",

package/src/primitives.tsx

@@ -312,6 +312,24 @@ export type InputProps =
       readonly required?: boolean;
       readonly hasError?: boolean;
     }
+  | {
+      readonly kind: "locatedTimestamp";
+      readonly id: string;
+      readonly name: string;
+      /** Located-Timestamp-Wert: Wall-Clock `at` (ohne Offset) + IANA-`tz`.
+       *  `utc` ist beim Read da (server-berechnet) und wird beim Write
+       *  ignoriert. Empty-State = `""`. onChange emittiert `{ at, tz }`. */
+      readonly value: { readonly at: string; readonly tz: string; readonly utc?: string } | "";
+      readonly onChange: (v: { readonly at: string; readonly tz: string } | undefined) => void;
+      /** Locale für den Datums-Teil. Default = Browser-Locale. */
+      readonly locale?: string;
+      /** Datumsgrenzen als ISO-Datetime — begrenzen den Kalender. */
+      readonly min?: string;
+      readonly max?: string;
+      readonly disabled?: boolean;
+      readonly required?: boolean;
+      readonly hasError?: boolean;
+    }
   | {
       readonly kind: "textarea";
       readonly id: string;