@cosmicdrift/kumiko-renderer 0.325.0 → 0.325.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.325.0",
+  "version": "0.325.1",
   "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,9 +15,9 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.325.0",
-    "@cosmicdrift/kumiko-headless": "0.325.0",
-    "@cosmicdrift/kumiko-types": "0.325.0",
+    "@cosmicdrift/kumiko-framework": "0.325.1",
+    "@cosmicdrift/kumiko-headless": "0.325.1",
+    "@cosmicdrift/kumiko-types": "0.325.1",
     "react": "^19.2.6",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
@@ -28,7 +28,7 @@
     "@types/react-dom": "^19.2.3",
     "jsdom": "^29.1.1",
     "react-dom": "^19.2.6",
-    "@cosmicdrift/kumiko-locale-de": "0.325.0"
+    "@cosmicdrift/kumiko-locale-de": "0.325.1"
   },
   "repository": {
     "type": "git",

package/src/app/kumiko-screen.tsx

@@ -500,6 +500,9 @@ function resolveTenantCurrency(
 // lands here — same last resort as the entityEdit path's `?? "EUR"`.
 const ACTION_FORM_CURRENCY_FALLBACK = "EUR";
 
+// Shared by the update payload shape and the server-error path prefix so both can't drift.
+const UPDATE_CHANGES_KEY = "changes";
+
 // A money field naming a fixed ISO code (`currency: { kind: "literal", code }`,
 // fw#2839) resolves with no query at all. Read structurally, same idiom as
 // tenantCurrencyMoneyFieldNames above.
@@ -1196,7 +1199,7 @@ function EntityEditUpdateForm({
       (snap: { readonly changes: Readonly<Record<string, unknown>> }): unknown => ({
         id: entityId,
         version: recordVersion,
-        changes: snap.changes,
+        [UPDATE_CHANGES_KEY]: snap.changes,
       }),
     [entityId, recordVersion],
   );
@@ -1317,6 +1320,7 @@ function EntityEditUpdateForm({
         writeCommand={writeCommand}
         payloadMode="changes"
         buildPayload={buildPayload}
+        serverFieldPathPrefix={`${UPDATE_CHANGES_KEY}.`}
         onSubmit={handleSubmitted}
         // allowDelete:false marks an entity without a CRUD delete (history is
         // kept) — without this gate the button dispatched against an

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.325.1",
+    "type": "fix",
+    "title": "Server validation errors on entityEdit update forms reach their fields again",
+    "detail": "The update form sends `{ id, version, changes }`, so server validation issues arrive as\n`changes.<field>`. The form controller stored them under that key, so no field showed the\nerror, tabs/wizard layouts never jumped to the erroring tab (only the generic banner), and\nsingle-section forms failed silently. A new submit option `serverFieldPathPrefix` strips the\nnesting key; KumikoScreen's update form sets it to `changes.`. Paths without the prefix are unchanged."
+  },
   {
     "version": "0.320.0",
     "type": "improvement",

package/src/components/render-edit-types.ts

@@ -46,6 +46,10 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
   readonly onSubmit?: (result: SubmitResult<unknown>) => void;
   readonly payloadMode?: "values" | "changes";
   readonly buildPayload?: (snapshot: FormSnapshot<TValues>) => unknown;
+  /** Prefix to strip from server validation issue paths before mapping them
+   *  onto form fields — see SubmitConfig.serverFieldPathPrefix. Only needed
+   *  when buildPayload nests the form values under a key. */
+  readonly serverFieldPathPrefix?: string;
   readonly onDelete?: () => Promise<void> | void;
   readonly onCancel?: () => void;
   readonly onReload?: () => void;

package/src/components/render-edit.tsx

@@ -296,6 +296,7 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
     onSubmit,
     payloadMode = "values",
     buildPayload,
+    serverFieldPathPrefix,
     onDelete,
     onCancel,
     onReload,
@@ -434,6 +435,7 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
           type: writeCommand,
           payloadMode,
           ...(buildPayload !== undefined && { buildPayload }),
+          ...(serverFieldPathPrefix !== undefined && { serverFieldPathPrefix }),
           ...(scopeFieldNames !== undefined && { validateScope: scopeFieldNames }),
         }
       : undefined;