@cosmicdrift/kumiko-renderer 0.215.7 → 0.216.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.215.7",
+  "version": "0.216.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.215.7",
-    "@cosmicdrift/kumiko-headless": "0.215.7",
+    "@cosmicdrift/kumiko-framework": "0.216.0",
+    "@cosmicdrift/kumiko-headless": "0.216.0",
     "react": "^19.2.6",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
@@ -25,7 +25,7 @@
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.14",
     "jsdom": "^29.1.1",
-    "@cosmicdrift/kumiko-locale-de": "0.215.7"
+    "@cosmicdrift/kumiko-locale-de": "0.216.0"
   },
   "repository": {
     "type": "git",

package/src/components/__tests__/render-edit-submit-actions.test.tsx

@@ -3,10 +3,11 @@ import type {
   EntityDefinition,
   EntityEditScreenDefinition,
 } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { DispatcherError, SubmitResult } from "@cosmicdrift/kumiko-headless";
+import type { Dispatcher, DispatcherError, SubmitResult } from "@cosmicdrift/kumiko-headless";
 import { fireEvent, render, screen as rtlScreen, waitFor } from "@testing-library/react";
 import type { ComponentType, ReactNode } from "react";
 import { buildFormSchema } from "../../app/form-schema";
+import { DispatcherProvider } from "../../context/dispatcher-context";
 import { createStaticLocaleResolver, LocaleProvider } from "../../i18n";
 import { kumikoDefaultTranslations } from "../../i18n-defaults";
 import {
@@ -114,12 +115,37 @@ function buildEntity(required = false): EntityDefinition {
   };
 }
 
+function stubDispatcher(writeImpl?: Dispatcher["write"]): {
+  dispatcher: Dispatcher;
+  writes: Array<{ type: string; payload: unknown }>;
+} {
+  const writes: Array<{ type: string; payload: unknown }> = [];
+  const dispatcher: Dispatcher = {
+    write: (async (type, payload) => {
+      writes.push({ type, payload });
+      if (writeImpl) return writeImpl(type, payload);
+      return { isSuccess: true, data: { id: "n1" } };
+    }) as Dispatcher["write"],
+    query: (async () => ({ isSuccess: true, data: {} })) as Dispatcher["query"],
+    batch: (async () => ({ isSuccess: true, results: [] })) as Dispatcher["batch"],
+    statusStore: {
+      getState: () => "online",
+      subscribe: () => () => {},
+    } as unknown as Dispatcher["statusStore"],
+    async *stream() {},
+    pendingWrites: () => [],
+    pendingFiles: () => [],
+  };
+  return { dispatcher, writes };
+}
+
 function renderEdit(
   screen: EntityEditScreenDefinition,
   overrides: Partial<RenderEditProps<Values>> = {},
   entity: EntityDefinition = buildEntity(),
+  dispatcher?: Dispatcher,
 ) {
-  return render(
+  const body = (
     <LocaleProvider
       resolver={createStaticLocaleResolver({ locale: "en-US" })}
       fallbackBundles={[kumikoDefaultTranslations]}
@@ -133,7 +159,14 @@ function renderEdit(
           {...overrides}
         />
       </PrimitivesProvider>
-    </LocaleProvider>,
+    </LocaleProvider>
+  );
+  return render(
+    dispatcher !== undefined ? (
+      <DispatcherProvider dispatcher={dispatcher}>{body}</DispatcherProvider>
+    ) : (
+      body
+    ),
   );
 }
 
@@ -298,3 +331,61 @@ describe("RenderEdit — custom actions", () => {
     );
   });
 });
+
+describe("RenderEdit — writeCommand path", () => {
+  test("successful writeCommand dispatches and notifies onSubmit", async () => {
+    const { dispatcher, writes } = stubDispatcher();
+    let submitted: SubmitResult<unknown> | undefined;
+    renderEdit(
+      oneFieldScreen,
+      {
+        writeCommand: "contacts:write:contact:update",
+        onSubmit: (result) => {
+          submitted = result;
+        },
+      },
+      buildEntity(),
+      dispatcher,
+    );
+
+    fireEvent.change(rtlScreen.getByLabelText(/name/i), { target: { value: "Ada" } });
+    fireEvent.click(rtlScreen.getByTestId("render-edit-submit"));
+
+    await waitFor(() => expect(submitted).toBeDefined());
+    expect(submitted?.isSuccess).toBe(true);
+    expect(writes).toHaveLength(1);
+    expect(writes[0]?.type).toBe("contacts:write:contact:update");
+    expect(writes[0]?.payload).toMatchObject({ name: "Ada" });
+  });
+
+  test("failed writeCommand without field issues shows form-error banner", async () => {
+    const writeFailure: DispatcherError = {
+      code: "conflict",
+      httpStatus: 409,
+      i18nKey: "errors.conflict",
+      message: "conflict",
+    };
+    const { dispatcher } = stubDispatcher(async () => ({
+      isSuccess: false,
+      error: writeFailure,
+    }));
+    let submitted: SubmitResult<unknown> | undefined;
+    renderEdit(
+      oneFieldScreen,
+      {
+        writeCommand: "contacts:write:contact:update",
+        onSubmit: (result) => {
+          submitted = result;
+        },
+      },
+      buildEntity(),
+      dispatcher,
+    );
+
+    fireEvent.change(rtlScreen.getByLabelText(/name/i), { target: { value: "Ada" } });
+    fireEvent.click(rtlScreen.getByTestId("render-edit-submit"));
+
+    await waitFor(() => expect(rtlScreen.getByTestId("render-edit-form-error")).toBeTruthy());
+    expect(submitted?.isSuccess).toBe(false);
+  });
+});