@cosmicdrift/kumiko-renderer 0.196.1 → 0.197.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.196.1",
+  "version": "0.197.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.196.1",
-    "@cosmicdrift/kumiko-headless": "0.196.1",
+    "@cosmicdrift/kumiko-framework": "0.197.0",
+    "@cosmicdrift/kumiko-headless": "0.197.0",
     "react": "^19.2.6",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"

package/src/hooks/__tests__/use-form.test.tsx

@@ -0,0 +1,61 @@
+import { describe, expect, mock, test } from "bun:test";
+import type { Dispatcher, WriteResult } from "@cosmicdrift/kumiko-headless";
+import { act, renderHook } from "@testing-library/react";
+import { useForm } from "../use-form";
+
+function makeDispatcher(response?: WriteResult): Dispatcher & {
+  readonly writeSpy: ReturnType<typeof mock>;
+} {
+  const writeSpy = mock(
+    async () => response ?? ({ isSuccess: true, data: { id: "srv-1" } } as WriteResult),
+  );
+  return {
+    writeSpy,
+    write: writeSpy as unknown as Dispatcher["write"],
+    query: (async () => ({ isSuccess: true, data: null })) as unknown as Dispatcher["query"],
+    batch: (async () => ({ isSuccess: true, results: [] })) as unknown as Dispatcher["batch"],
+    async *stream() {},
+    statusStore: {
+      getState: () => "online",
+      subscribe: () => () => {},
+    } as unknown as Dispatcher["statusStore"],
+    pendingWrites: () => [],
+    pendingFiles: () => [],
+  };
+}
+
+describe("useForm — mounted without a DispatcherProvider", () => {
+  test("does not throw on mount — fw#1999 regression", () => {
+    const { result } = renderHook(() =>
+      useForm({ initial: { title: "" }, submit: { type: "app:write:task:create" } }),
+    );
+
+    expect(result.current.snapshot.values.title).toBe("");
+  });
+
+  test("submit() without an explicit dispatcher rejects instead of crashing the hook", async () => {
+    const { result } = renderHook(() =>
+      useForm({ initial: { title: "hello" }, submit: { type: "app:write:task:create" } }),
+    );
+
+    await expect(result.current.controller.submit()).rejects.toThrow(
+      /submit\(\) called without a dispatcher/,
+    );
+  });
+
+  test("submit() with an explicit dispatcher still works without a provider", async () => {
+    const dispatcher = makeDispatcher();
+    const { result } = renderHook(() =>
+      useForm({
+        initial: { title: "hello" },
+        submit: { type: "app:write:task:create", dispatcher },
+      }),
+    );
+
+    await act(async () => {
+      await result.current.controller.submit();
+    });
+
+    expect(dispatcher.writeSpy).toHaveBeenCalledWith("app:write:task:create", { title: "hello" });
+  });
+});

package/src/hooks/use-form.ts

@@ -6,7 +6,7 @@ import type {
 } from "@cosmicdrift/kumiko-headless";
 import { createFormController } from "@cosmicdrift/kumiko-headless";
 import { useMemo, useSyncExternalStore } from "react";
-import { useDispatcher } from "../context/dispatcher-context";
+import { useOptionalDispatcher } from "../context/dispatcher-context";
 
 // Thin React wrapper around createFormController. Returns both the
 // controller (imperative — setField, submit, reset) and the current
@@ -46,7 +46,10 @@ export type UseFormResult<TValues extends FormValues> = {
 export function useForm<TValues extends FormValues, TCtx = unknown>(
   options: UseFormOptions<TValues, TCtx>,
 ): UseFormResult<TValues> {
-  const contextDispatcher = useDispatcher();
+  // Optional: a form with no `submit` config (or one with an explicit
+  // dispatcher) never needs the ambient one, and mounting without a
+  // DispatcherProvider must not crash just because useForm was called.
+  const contextDispatcher = useOptionalDispatcher();
 
   // The controller is created once per mount. `options` mutates across
   // renders in normal React usage (closures get new references), but

package/src/i18n-defaults.ts

@@ -66,6 +66,12 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
     "kumiko.list.no-entries": "Keine Einträge.",
     "kumiko.list.end-of-list": "— Ende der Liste —",
 
+    // Pager — Status-Zeile + Prev/Next/Page-aria-Labels (DataTable pagination="pages").
+    "kumiko.pager.status": "{from}–{to} von {total}",
+    "kumiko.pager.previousPage": "Vorherige Seite",
+    "kumiko.pager.nextPage": "Nächste Seite",
+    "kumiko.pager.page": "Seite {entry}",
+
     // Combobox — Tier 2.1c Searchable-Select.
     "kumiko.combobox.search-placeholder": "Suchen…",
     "kumiko.combobox.empty": "Keine Treffer.",
@@ -257,6 +263,11 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
     "kumiko.list.no-entries": "No entries.",
     "kumiko.list.end-of-list": "— End of list —",
 
+    "kumiko.pager.status": "{from}–{to} of {total}",
+    "kumiko.pager.previousPage": "Previous page",
+    "kumiko.pager.nextPage": "Next page",
+    "kumiko.pager.page": "Page {entry}",
+
     "kumiko.combobox.search-placeholder": "Search…",
     "kumiko.combobox.empty": "No matches.",
     "kumiko.combobox.loading": "Loading…",