void 1.2.0 → 1.2.1

package/dist/pages/client.d.mts

@@ -50,6 +50,8 @@ type VisitOptions = {
   } | null;
   /** @internal Used by popstate handler to avoid writing history while traversing */
   _popstate?: boolean;
+  /** @internal Used by router.refresh() to refetch the current URL even when it has a hash */
+  _refresh?: boolean;
 };
 type PrefetchOptions = {
   method?: string;
@@ -170,6 +172,8 @@ export declare function idleNavigationState(): NavigationState;
 export declare function createRouterFacade(router: VoidRouter, getCurrentUrl: () => string, getCurrentParams?: () => Record<string, string>): VoidRouter;
 export declare function createSsrRouter(url?: string, params?: Record<string, string>): VoidRouter;
 export declare const ssrProxy: VoidRouter;
+/** Refetch the current page in place: same history entry, URL hash, state and scroll. */
+export declare function refreshPage(router: Pick<VoidRouter, "visit">, options?: VisitOptions): Promise<unknown>;
 export declare function submitAction(router: VoidRouter, url: string, options: VisitOptions): Promise<ActionResult>;
 type ActionMethod = "POST" | "PUT" | "PATCH" | "DELETE";
 type HasParams<U extends string> = [ResolveActionParams<U>] extends [never] ? false : true;

package/dist/pages/client.mjs

@@ -215,7 +215,7 @@ function createScrollRestoration() {
 		},
 		save,
 		writeHistory(url, replace) {
-			renderedKey = newKey();
+			renderedKey = (replace ? readKey(history.state) : null) ?? newKey();
 			const state = {
 				...replace ? history.state : {},
 				__voidScrollKey: renderedKey
@@ -726,7 +726,7 @@ async function createPageNavigationEngine(config) {
 			if (preservedDeferredRegistry && preservedDeferredRegistry !== deferredRegistry) deferredRegistry.dispose();
 			applyClientHead(result.pageData.head);
 			_currentFetchUrl = commitTarget.fetchUrl;
-			if (!options.preserveState) {
+			if (!options._popstate) {
 				const historyUrl = commitTarget.fetchUrl + commitTarget.hash;
 				scrollRestoration.writeHistory(historyUrl, !!options.replace);
 			}
@@ -760,8 +760,8 @@ async function createPageNavigationEngine(config) {
 			const hashNavigationBaseUrl = options._popstate ? _currentFetchUrl : currentPath;
 			_pendingResource?.abort();
 			_pendingResource = null;
-			if (effectiveFetchUrl === hashNavigationBaseUrl && method === "GET" && !options.data && Boolean(hash || options._popstate)) {
-				commitHashNavigation(effectiveFetchUrl, hash, options, !options._popstate && !options.preserveState);
+			if (!options._refresh && effectiveFetchUrl === hashNavigationBaseUrl && method === "GET" && !options.data && Boolean(hash || options._popstate)) {
+				commitHashNavigation(effectiveFetchUrl, hash, options, !options._popstate);
 				return {
 					id,
 					url,
@@ -1069,6 +1069,17 @@ function createSsrRouter(url = "/", params = {}) {
 	};
 }
 const ssrProxy = createSsrRouter();
+/** Refetch the current page in place: same history entry, URL hash, state and scroll. */
+function refreshPage(router, options = {}) {
+	const { pathname, search, hash } = window.location;
+	return router.visit(pathname + search + hash, {
+		preserveState: true,
+		preserveScroll: true,
+		replace: true,
+		...options,
+		_refresh: true
+	});
+}
 async function submitAction(router, url, options) {
 	try {
 		const pageData = await router.visit(url, options);
@@ -1172,11 +1183,7 @@ async function createVoidRouter(config) {
 			return applyNavigationResource(engine.prepareVisit(normalizeUrl(url), options));
 		},
 		refresh(options = {}) {
-			return router.visit(window.location.pathname + window.location.search, {
-				preserveState: true,
-				preserveScroll: true,
-				...options
-			});
+			return refreshPage(router, options);
 		},
 		prefetch(url, options = {}) {
 			return engine.prefetch(normalizeUrl(url), options);
@@ -1238,4 +1245,4 @@ function initIslands(islands, hydrateFn) {
 	});
 }
 //#endregion
-export { VoidActionError, categorizeActionError, createActionClient, createPageNavigationEngine, createRouterFacade, createSsrRouter, createVoidRouter, formErrorMessage, formRetryMessage, formSubmissionBlocked, getValidationErrors, hasFiles, idleNavigationState, initIslands, interpolateRouteParams, isAbortError, isCallSiteActionError, isEqualFormValue, isFile, isModifiedEvent, mergeDataIntoHref, objectToFormData, scheduleFormRetry, scheduleHydration, ssrProxy, submitAction };
+export { VoidActionError, categorizeActionError, createActionClient, createPageNavigationEngine, createRouterFacade, createSsrRouter, createVoidRouter, formErrorMessage, formRetryMessage, formSubmissionBlocked, getValidationErrors, hasFiles, idleNavigationState, initIslands, interpolateRouteParams, isAbortError, isCallSiteActionError, isEqualFormValue, isFile, isModifiedEvent, mergeDataIntoHref, objectToFormData, refreshPage, scheduleFormRetry, scheduleHydration, ssrProxy, submitAction };

package/docs/guide/pages-routing/overview.md

@@ -208,7 +208,7 @@ import { useRouter } from '@void/vue'; // or "@void/react", "@void/svelte", "@vo
 
 const router = useRouter();
 router.visit('/users');
-router.refresh(); // re-fetch current page props
+router.refresh(); // re-fetch current page props, keeping the same history entry
 router.visit('/logout', { method: 'POST' }); // non-GET navigation
 ```
 

package/docs/guide/quickstart.md

@@ -32,6 +32,11 @@ bun add -D void
 bunx void init
 ```
 
+```sh [vite+]
+vp add -D void
+vpx void init
+```
+
 :::
 
 Choose your UI framework, a starter, and a deployment target. Vite+ is the default build tool. D1 is a good first database: it runs locally without a separate database server. Choose Cloudflare to deploy to your own account, or skip deployment setup for now.
@@ -42,10 +47,30 @@ With pnpm, `pnpm create void my-app` also creates the project directory and conf
 
 ## Run locally
 
-```sh
+::: code-group
+
+```sh [npm]
 npm run dev
 ```
 
+```sh [pnpm]
+pnpm run dev
+```
+
+```sh [yarn]
+yarn run dev
+```
+
+```sh [bun]
+bun run dev
+```
+
+```sh [vite+]
+vpr dev
+```
+
+:::
+
 Open `http://localhost:5173`. In a Pages starter, `pages/` contains your UI and companion `.server.ts` files contain its server loaders and actions. Loaders return data to page components as typed props.
 
 ## Call a server route

package/docs/guide/sandboxes.md

@@ -120,8 +120,8 @@ See the [configuration reference](../reference/config.md#sandbox) for binding na
 Custom images must include the helper matching Void's installed Sandbox SDK version. The SDK image supplies this binary, but is not a runnable environment itself:
 
 ```dockerfile
-FROM node:26.10.0-trixie-slim
-COPY --from=docker.io/cloudflare/sandbox:1.0.1 /usr/local/bin/sandbox-shim /usr/local/bin/sandbox-shim
+FROM node:26.12.1-trixie-slim
+COPY --from=docker.io/cloudflare/sandbox:1.0.2 /usr/local/bin/sandbox-shim /usr/local/bin/sandbox-shim
 WORKDIR /workspace
 CMD ["sleep", "infinity"]
 ```

package/docs/reference/cli.md

@@ -79,7 +79,7 @@ Use this page as a command reference. If you are setting up a project for the fi
 
 ## Binary Invocation {#binary-invocation}
 
-The docs use `void` for brevity. Outside package scripts, run it with your package manager: `npx void`, `pnpm void`, `yarn void`, or `bunx void`.
+The docs use `void` for brevity. Outside package scripts, run it with your package manager: `npx void`, `pnpm void`, `yarn void`, `bunx void`, or `vpx void`.
 
 Alternatively, you can add `./node_modules/.bin` to your `PATH` so that you can invoke `void` directly when you are in the root directory of your app.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "void",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Full-stack framework and deployment CLI for Cloudflare Workers, powered by Vite.",
   "homepage": "https://void.cloud",
   "bugs": {
@@ -348,11 +348,11 @@
     "@cloudflare/workers-auth": "^0.14.1",
     "@cloudflare/workers-types": "^5.20261019.1",
     "@napi-rs/keyring": "^2.1.2",
-    "@void/deploy-cloudflare": "1.2.0",
-    "@void/deploy-core": "1.2.0",
-    "@void/edge": "1.2.0",
-    "@void/isr": "1.2.0",
-    "@void/platform": "1.2.0",
+    "@void/deploy-cloudflare": "1.2.1",
+    "@void/deploy-core": "1.2.1",
+    "@void/edge": "1.2.1",
+    "@void/isr": "1.2.1",
+    "@void/platform": "1.2.1",
     "better-auth": "^1.7.11",
     "better-sqlite3": "^13.0.3",
     "blake3-jit": "^1.1.0",
@@ -401,7 +401,7 @@
     "zod": "^4.6.7"
   },
   "peerDependencies": {
-    "@void/md": "1.2.0",
+    "@void/md": "1.2.1",
     "arktype": ">=2.0.0",
     "valibot": ">=1.0.0-beta.7",
     "vite": "^8.0.0",

package/sandbox.Dockerfile

@@ -1,4 +1,4 @@
-FROM node:26.10.0-trixie-slim
+FROM node:26.12.1-trixie-slim
 COPY --from=docker.io/cloudflare/sandbox:1.0.2 /usr/local/bin/sandbox-shim /usr/local/bin/sandbox-shim
 WORKDIR /workspace
 CMD ["sleep", "infinity"]