@cosmicdrift/kumiko-renderer 0.220.0 → 0.220.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.220.0",
+  "version": "0.220.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,8 +15,8 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.220.0",
-    "@cosmicdrift/kumiko-headless": "0.220.0",
+    "@cosmicdrift/kumiko-framework": "0.220.1",
+    "@cosmicdrift/kumiko-headless": "0.220.1",
     "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.220.0"
+    "@cosmicdrift/kumiko-locale-de": "0.220.1"
   },
   "repository": {
     "type": "git",

package/src/__tests__/merge-search-params-into-initial.test.ts

@@ -77,4 +77,27 @@ describe("mergeSearchParamsIntoInitial", () => {
     const result = mergeSearchParamsIntoInitial(fields, { ownerId: "user-123" });
     expect(result["ownerId"]).toBe("user-123");
   });
+
+  test("multiSelect coerces comma-separated searchParam to string[]", () => {
+    const fields: Record<string, FieldDef> = { roles: { type: "multiSelect" } };
+    expect(mergeSearchParamsIntoInitial(fields, { roles: "TenantAdmin" })["roles"]).toEqual([
+      "TenantAdmin",
+    ]);
+    expect(mergeSearchParamsIntoInitial(fields, { roles: "Admin,User" })["roles"]).toEqual([
+      "Admin",
+      "User",
+    ]);
+  });
+
+  test("multiSelect coerces JSON-array searchParam to string[]", () => {
+    const fields: Record<string, FieldDef> = { roles: { type: "multiSelect" } };
+    expect(
+      mergeSearchParamsIntoInitial(fields, { roles: JSON.stringify(["Admin", "Editor"]) })["roles"],
+    ).toEqual(["Admin", "Editor"]);
+  });
+
+  test("multiSelect defaults to [] when unset", () => {
+    const fields: Record<string, FieldDef> = { roles: { type: "multiSelect" } };
+    expect(mergeSearchParamsIntoInitial(fields, {})["roles"]).toEqual([]);
+  });
 });

package/src/app/kumiko-screen.tsx

@@ -341,7 +341,13 @@ export function buildInitialValues(
       continue;
     }
     out[name] =
-      shape.type === "boolean" ? false : shape.type === "number" || shape.type === "money" ? 0 : "";
+      shape.type === "boolean"
+        ? false
+        : shape.type === "number" || shape.type === "money"
+          ? 0
+          : shape.type === "multiSelect"
+            ? []
+            : "";
   }
   return out;
 }
@@ -372,6 +378,26 @@ export function mergeSearchParamsIntoInitial(
           : parsed;
     } else if (shape.type === "boolean") {
       merged[name] = raw === "true";
+    } else if (shape.type === "multiSelect") {
+      // Row-action navigate stringifies arrays via String(arr) → "a,b" (or
+      // JSON when the navigate helper JSON.stringifies). Accept both so
+      // member-roles-edit can prefill from ?roles=TenantAdmin.
+      if (raw.startsWith("[")) {
+        try {
+          const parsed: unknown = JSON.parse(raw);
+          merged[name] = Array.isArray(parsed) ? parsed.map((v) => String(v)) : defaults[name];
+        } catch {
+          merged[name] = defaults[name];
+        }
+      } else {
+        merged[name] =
+          raw === ""
+            ? []
+            : raw
+                .split(",")
+                .map((s) => s.trim())
+                .filter(Boolean);
+      }
     } else {
       merged[name] = raw;
     }
@@ -1343,7 +1369,8 @@ function EntityListBody({
         // Row-Actions praktisch nicht erreichbar, Pfad differiert).
         const stringified: Record<string, string | null> = {};
         for (const [k, v] of Object.entries(params)) {
-          stringified[k] = v === null || v === undefined ? null : String(v);
+          stringified[k] =
+            v === null || v === undefined ? null : Array.isArray(v) ? JSON.stringify(v) : String(v);
         }
         nav.setSearchParams(stringified);
       }
@@ -1705,7 +1732,8 @@ function ProjectionListBody({
       if (params !== undefined) {
         const stringified: Record<string, string | null> = {};
         for (const [k, v] of Object.entries(params)) {
-          stringified[k] = v === null || v === undefined ? null : String(v);
+          stringified[k] =
+            v === null || v === undefined ? null : Array.isArray(v) ? JSON.stringify(v) : String(v);
         }
         nav.setSearchParams(stringified);
       }
@@ -2005,7 +2033,12 @@ function ProjectionDetailBody({
           if (params !== undefined) {
             const stringified: Record<string, string | null> = {};
             for (const [k, v] of Object.entries(params)) {
-              stringified[k] = v === null || v === undefined ? null : String(v);
+              stringified[k] =
+                v === null || v === undefined
+                  ? null
+                  : Array.isArray(v)
+                    ? JSON.stringify(v)
+                    : String(v);
             }
             nav.setSearchParams(stringified);
           }

package/src/components/__tests__/render-edit-action-button.test.tsx

@@ -138,6 +138,7 @@ describe("RenderEditActionButton", () => {
 
     fireEvent.click(rtlScreen.getByTestId("render-edit-action-boom"));
     await waitFor(() => expect(errors).toContain("action exploded"));
+    // Cleared at the start of trigger, then set on failure.
     expect(errors[0]).toBeNull();
   });
 

package/src/hooks/use-form.ts

@@ -23,20 +23,10 @@ import { useOptionalDispatcher } from "../context/dispatcher-context";
 //   });
 // and the hook wires the ambient DispatcherProvider's dispatcher in.
 
-export type UseFormOptions<TValues extends FormValues, TCtx = unknown> = Omit<
-  FormControllerOptions<TValues, TCtx>,
-  "submit"
-> & {
-  // `submit` here takes everything the ui-core SubmitConfig takes
-  // EXCEPT dispatcher — that comes from context. Passing an explicit
-  // dispatcher here (e.g. from a test) overrides the context one.
-  readonly submit?: Omit<
-    NonNullable<FormControllerOptions<TValues, TCtx>["submit"]>,
-    "dispatcher"
-  > & {
-    readonly dispatcher?: NonNullable<FormControllerOptions<TValues, TCtx>["submit"]>["dispatcher"];
-  };
-};
+export type UseFormOptions<TValues extends FormValues, TCtx = unknown> = FormControllerOptions<
+  TValues,
+  TCtx
+>;
 
 export type UseFormResult<TValues extends FormValues> = {
   readonly controller: FormController<TValues>;
@@ -63,10 +53,7 @@ export function useForm<TValues extends FormValues, TCtx = unknown>(
   // in-flight state and dirty edits on every parent re-render.
   // biome-ignore lint/correctness/useExhaustiveDependencies: intentional — controller is lifetime-scoped, not render-scoped
   const controller = useMemo<FormController<TValues>>(() => {
-    // Default the dispatcher to the ambient one, then hand ui-core
-    // a fully-populated SubmitConfig. The input signature lets the
-    // caller omit `dispatcher`; the output shape createFormController
-    // expects requires it.
+    // Default submit.dispatcher to the ambient one when omitted.
     type FullOptions = FormControllerOptions<TValues, TCtx>;
     const rawSubmit = options.submit;
     const submitConfig: FullOptions["submit"] = rawSubmit