@void/react 0.10.13 → 0.20.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present, Cloudflare, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -219,8 +219,9 @@ export const loader = defineHandler(() => ({ title: 'Home' }));
 
 ## Tests
 
-- `test/unit/use-form.test.ts`
 - `test/unit/link.test.ts`
 - `test/integration/react-pages-client.test.ts`
 
-Cross-package SSR/protocol coverage for React pages mode also lives in `framework/packages/void/test/integration/*`.
+Cross-package SSR/protocol coverage for React pages mode also lives in `packages/void/test/integration/*`.
+
+The [shared client](../../test/pages-client-contract.ts) and [island](../../test/pages-island-contract.ts) contracts run against this adapter in both dev and preview. Shared form equality is tested directly in [Void](../void/test/unit/form-value-equality.test.ts); tests do not copy the hook implementation.

package/dist/{index-5JoQg_-q.d.mts → index-Cx2A1XEu.d.mts}

@@ -2,7 +2,6 @@ import { AnchorHTMLAttributes, ButtonHTMLAttributes, Context, JSX } from "react"
 import { ActionResult, NavigationState, VoidActionError, VoidRouter } from "void/pages-client";
 import { CloudContextVariables, InferProps } from "void";
 import { ActionFormOptions, ActionUrl, ResolveActionBody, ResolveActionParams } from "void/routes";
-
 //#region src/runtime/link.d.ts
 type PrefetchStrategy = "hover" | "click" | "mount" | "visible";
 type LinkMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
@@ -22,28 +21,7 @@ type CommonProps = {
   }) => void;
 };
 type LinkProps = CommonProps & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, keyof CommonProps> & Omit<ButtonHTMLAttributes<HTMLButtonElement>, keyof CommonProps>;
-declare function Link({
-  href,
-  method,
-  data,
-  preserveScroll,
-  preserveState,
-  replace,
-  reloadDocument,
-  viewTransition,
-  prefetch: prefetchProp,
-  cacheFor,
-  onNavigate,
-  children,
-  style,
-  onClick: onClickProp,
-  onMouseEnter: onMouseEnterProp,
-  onMouseLeave: onMouseLeaveProp,
-  onFocus: onFocusProp,
-  onMouseDown: onMouseDownProp,
-  onTouchStart: onTouchStartProp,
-  ...rest
-}: LinkProps): JSX.Element;
+declare function Link({ href, method, data, preserveScroll, preserveState, replace, reloadDocument, viewTransition, prefetch: prefetchProp, cacheFor, onNavigate, children, style, onClick: onClickProp, onMouseEnter: onMouseEnterProp, onMouseLeave: onMouseLeaveProp, onFocus: onFocusProp, onMouseDown: onMouseDownProp, onTouchStart: onTouchStartProp, ...rest }: LinkProps): JSX.Element;
 //#endregion
 //#region src/runtime/use-router.d.ts
 declare function useRouter(): VoidRouter;
@@ -95,9 +73,9 @@ type IslandFormReturn<T extends Record<string, unknown>> = Readonly<{
   delete: (url: string) => Promise<void>;
 }>;
 /**
-* Form hook for island pages. Uses fetch + page reload instead of the
-* Void Router (which is not available in island mode).
-*/
+ * Form hook for island pages. Uses fetch + page reload instead of the
+ * Void Router (which is not available in island mode).
+ */
 declare function useIslandForm<T extends Record<string, unknown>>(defaults: T): IslandFormReturn<T>;
 //#endregion
 //#region src/runtime/action.d.ts

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { a as ParamsContext, c as action, d as useNavigation, f as useForm, g as Link, h as useRouter, i as NavigationContext, l as setActionRouter, m as useParams, n as InferProps, o as RouterContext, p as useShared, r as ErrorsContext, s as SharedContext, t as Deferred, u as useIslandForm } from "./index-5JoQg_-q.mjs";
+import { a as ParamsContext, c as action, d as useNavigation, f as useForm, g as Link, h as useRouter, i as NavigationContext, l as setActionRouter, m as useParams, n as InferProps, o as RouterContext, p as useShared, r as ErrorsContext, s as SharedContext, t as Deferred, u as useIslandForm } from "./index-Cx2A1XEu.mjs";
 export { Deferred, ErrorsContext, type InferProps, Link, NavigationContext, ParamsContext, RouterContext, SharedContext, action, setActionRouter, useForm, useIslandForm, useNavigation, useParams, useRouter, useShared };

package/dist/plugin.d.mts

@@ -1,16 +1,14 @@
 import react from "@vitejs/plugin-react";
 import { Plugin } from "vite";
-
 //#region src/plugin.d.ts
 type PrefetchConfig = {
   hoverDelay?: number;
   cacheFor?: number | string | [string, string];
 };
-type VoidReactOptions = Readonly<{
+export type VoidReactOptions = Readonly<{
   react?: Parameters<typeof react>[0];
   viewTransitions?: boolean;
   prefetch?: PrefetchConfig;
 }>;
-declare function voidReact(options?: VoidReactOptions): Array<Plugin>;
-//#endregion
-export { VoidReactOptions, voidReact };
+export declare function voidReact(options?: VoidReactOptions): Array<Plugin>;
+//#endregion

package/dist/plugin.mjs

@@ -319,6 +319,7 @@ initIslands(islands, hydrateIsland);
 }
 //#endregion
 //#region src/plugin-pages.ts
+const RENDERER_ID = "virtual:void-pages-renderer";
 const CLIENT_ENTRY_ID = "virtual:void-pages-client";
 const WORKER_ENVIRONMENT_NAME = "void_worker";
 const REACT_DEDUPE = ["react", "react-dom"];
@@ -364,7 +365,7 @@ function pagesPlugin(pagesDir, options) {
 		return pendingRescan;
 	};
 	const invalidatePageModules = (server) => {
-		for (const env of Object.values(server.environments)) for (const id of ["\0virtual:void-pages-renderer", "\0virtual:void-pages-client"]) {
+		for (const env of Object.values(server.environments)) for (const id of ["\0" + RENDERER_ID, "\0" + CLIENT_ENTRY_ID]) {
 			const mod = env.moduleGraph.getModuleById(id);
 			if (mod) env.moduleGraph.invalidateModule(mod);
 		}
@@ -385,11 +386,11 @@ function pagesPlugin(pagesDir, options) {
 			async handler(id) {
 				if (isDev && pendingRescan) await pendingRescan;
 				if (!pageScan && existsSync(pagesDir)) await runRescan();
-				if (id === "\0virtual:void-pages-renderer") {
+				if (id === "\0" + RENDERER_ID) {
 					if (!pageScan) return "export function renderPage() { throw new Error('No pages found'); }";
 					return generateRendererModule(pageScan, pagesDir, isDev);
 				}
-				if (id === "\0virtual:void-pages-client") {
+				if (id === "\0" + CLIENT_ENTRY_ID) {
 					if (!pageScan) return "";
 					return generateClientEntry(pageScan, pagesDir, options?.viewTransitions, options?.prefetch, resolveStaticPageDataBuildOptions(root, { publicDir: viteConfig?.publicDir }));
 				}

package/dist/runtime/index.d.mts

@@ -1,2 +1,2 @@
-import { a as ParamsContext, c as action, d as useNavigation, f as useForm, g as Link, h as useRouter, i as NavigationContext, l as setActionRouter, m as useParams, n as InferProps, o as RouterContext, p as useShared, r as ErrorsContext, s as SharedContext, t as Deferred, u as useIslandForm } from "../index-5JoQg_-q.mjs";
+import { a as ParamsContext, c as action, d as useNavigation, f as useForm, g as Link, h as useRouter, i as NavigationContext, l as setActionRouter, m as useParams, n as InferProps, o as RouterContext, p as useShared, r as ErrorsContext, s as SharedContext, t as Deferred, u as useIslandForm } from "../index-Cx2A1XEu.mjs";
 export { Deferred, ErrorsContext, type InferProps, Link, NavigationContext, ParamsContext, RouterContext, SharedContext, action, setActionRouter, useForm, useIslandForm, useNavigation, useParams, useRouter, useShared };

package/dist/runtime/pages-client.d.mts

@@ -1,12 +1,11 @@
 import { ComponentType } from "react";
 import { VoidRouter } from "void/pages-client";
 import { CacheForResult } from "void/pages-prefetch";
-
 //#region src/runtime/pages-client.d.ts
 type ComponentModule = {
   default: ComponentType<any>;
 };
-type ReactPagesConfig = Readonly<{
+export type ReactPagesConfig = Readonly<{
   components: Record<string, () => Promise<ComponentModule>>;
   layoutTree: Record<string, Array<string>>;
   routeMeta: Record<string, {
@@ -19,9 +18,8 @@ type ReactPagesConfig = Readonly<{
   prefetchHoverDelay: number;
   prefetchDefaultCacheFor: CacheForResult;
 }>;
-type ReactPagesClient = Readonly<{
+export type ReactPagesClient = Readonly<{
   router: VoidRouter;
 }>;
-declare function startReactPages(config: ReactPagesConfig): Promise<ReactPagesClient>;
-//#endregion
-export { ReactPagesClient, ReactPagesConfig, startReactPages };
+export declare function startReactPages(config: ReactPagesConfig): Promise<ReactPagesClient>;
+//#endregion

package/dist/runtime/pages-client.mjs

@@ -193,27 +193,28 @@ function startViewTransition(resource, reveal, enabled) {
 function App({ engine, router, viewTransitions }) {
 	const initialPageData = engine.initialPageData;
 	const sharedStateRef = useRef(initialPageData.shared);
+	const initialResource = useMemo(() => ({
+		id: 0,
+		url: initialPageData.url || currentUrl(),
+		fetchUrl: initialPageData.url || currentUrl(),
+		hash: window.location.hash,
+		method: "GET",
+		options: {},
+		immediate: false,
+		shell: Promise.resolve({
+			pageData: {
+				...initialPageData,
+				shared: initialPageData.shared
+			},
+			component: engine.initialComponent,
+			layouts: engine.initialLayouts
+		}),
+		abort() {},
+		async commit() {},
+		dispose() {}
+	}), [engine, initialPageData]);
 	const [state, dispatch] = useReducer(appReducer, {
-		resource: useMemo(() => ({
-			id: 0,
-			url: initialPageData.url || currentUrl(),
-			fetchUrl: initialPageData.url || currentUrl(),
-			hash: window.location.hash,
-			method: "GET",
-			options: {},
-			immediate: false,
-			shell: Promise.resolve({
-				pageData: {
-					...initialPageData,
-					shared: initialPageData.shared
-				},
-				component: engine.initialComponent,
-				layouts: engine.initialLayouts
-			}),
-			abort() {},
-			async commit() {},
-			dispose() {}
-		}), [engine, initialPageData]),
+		resource: initialResource,
 		rollbackResource: null,
 		pendingId: null,
 		routeUrl: currentUrl(),

package/dist/runtime/pages-server.d.mts

@@ -1,11 +1,10 @@
 import { ComponentType } from "react";
 import { PageObject } from "void/pages-protocol";
-
 //#region src/runtime/pages-server.d.ts
 type ComponentModule = {
   default: ComponentType<any>;
 };
-type ReactPagesServerConfig = Readonly<{
+export type ReactPagesServerConfig = Readonly<{
   pageObj: PageObject;
   assetTags: {
     css: string;
@@ -16,12 +15,5 @@ type ReactPagesServerConfig = Readonly<{
   layoutTree: Record<string, Array<string>>;
   preambleScript?: string;
 }>;
-declare function renderReactPage({
-  pageObj,
-  assetTags,
-  components,
-  layoutTree,
-  preambleScript
-}: ReactPagesServerConfig): Promise<ReadableStream<Uint8Array>>;
-//#endregion
-export { ReactPagesServerConfig, renderReactPage };
+export declare function renderReactPage({ pageObj, assetTags, components, layoutTree, preambleScript }: ReactPagesServerConfig): Promise<ReadableStream<Uint8Array>>;
+//#endregion

package/dist/runtime/pages-server.mjs

@@ -84,7 +84,8 @@ async function renderReactPage({ pageObj, assetTags, components, layoutTree, pre
 	let element = React.createElement(PageComponent, renderProps);
 	for (let i = layoutComponents.length - 1; i >= 0; i--) element = React.createElement(layoutComponents[i], null, element);
 	element = React.createElement(RouterContext.Provider, { value: createSsrRouter(pageObj.url || "/", pageObj.params ?? {}) }, React.createElement(NavigationContext.Provider, { value: idleNavigationState() }, React.createElement(React.Suspense, { fallback: null }, React.createElement(SharedContext.Provider, { value: pageObj.shared || {} }, React.createElement(ParamsContext.Provider, { value: pageObj.params ?? {} }, React.createElement(ErrorsContext.Provider, { value: pageObj.errors || {} }, element))))));
-	const appStream = await renderToReadableStream(pageObj.deferredKeys ? React.createElement(React.Fragment, null, element, React.createElement("template", { id: DEFERRED_SHELL_END_ID })) : element, { onError(error) {
+	const renderElement = pageObj.deferredKeys ? React.createElement(React.Fragment, null, element, React.createElement("template", { id: DEFERRED_SHELL_END_ID })) : element;
+	const appStream = await renderToReadableStream(renderElement, { onError(error) {
 		if (error === DEFERRED_SHELL_CANCEL_REASON) return;
 		throw error;
 	} });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@void/react",
-  "version": "0.10.13",
+  "version": "0.20.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/voidzero-dev/void.git",
@@ -19,14 +19,6 @@
       "types": "./dist/plugin.d.mts",
       "import": "./dist/plugin.mjs"
     },
-    "./runtime": {
-      "types": "./dist/runtime/index.d.mts",
-      "import": "./dist/runtime/index.mjs"
-    },
-    "./prefetch": {
-      "types": "./dist/runtime/prefetch.d.mts",
-      "import": "./dist/runtime/prefetch.mjs"
-    },
     "./pages-client": {
       "types": "./dist/runtime/pages-client.d.mts",
       "import": "./dist/runtime/pages-client.mjs"
@@ -40,28 +32,28 @@
     "access": "public"
   },
   "dependencies": {
-    "@vitejs/plugin-react": "^6.0.3"
+    "@vitejs/plugin-react": "^6.1.1"
   },
   "devDependencies": {
-    "@types/node": "^26.1.0",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
+    "@types/node": "^26.5.1",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
     "pathslash": "^0.1.0",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7",
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.2",
-    "vite-plus": "^0.2.2",
-    "void": "0.10.13"
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.1",
+    "vite-plus": "0.3.1",
+    "void": "0.20.1"
   },
   "peerDependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "vite": "^8.0.0",
-    "void": "0.10.13"
+    "void": "0.20.1"
   },
   "scripts": {
     "build": "vp pack",
     "dev": "vp pack --watch",
-    "typecheck": "tsgo --noEmit"
+    "typecheck": "tsc --noEmit --rootDir ../.."
   }
 }

package/dist/runtime/prefetch.d.mts

@@ -1,2 +0,0 @@
-import { CacheEntry, CacheForInput, CacheForResult, PrefetchCache, parseCacheFor } from "void/pages-prefetch";
-export { type CacheEntry, type CacheForInput, type CacheForResult, PrefetchCache, parseCacheFor };

package/dist/runtime/prefetch.mjs

@@ -1,2 +0,0 @@
-import { PrefetchCache, parseCacheFor } from "void/pages-prefetch";
-export { PrefetchCache, parseCacheFor };