@void/vue 0.10.12 → 0.20.0

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

@@ -63,6 +63,11 @@ state, `errors` for field validation, and `error` for non-validation call-site
 failures. The submit helpers return promises so boundary-class failures can
 propagate through Vue async error handling or explicit `catch` handlers.
 
+GET navigation creates a fresh page instance, so forms receive the destination
+record's URL and defaults. Layouts remain mounted. Mutations and
+`router.refresh()` preserve page state by default; use `preserveState` to override
+this behavior when navigating within the same record.
+
 ```vue
 <script setup lang="ts">
 import { useForm } from '@void/vue';
@@ -111,8 +116,10 @@ request.
 
 ## Tests
 
-- `test/unit/use-form.test.ts`
-- `test/unit/prefetch.test.ts`
+Shared prefetch-cache tests live in `packages/void/test/unit/prefetch.test.ts`.
+
 - `test/integration/vue-pages-client.test.ts`
 
-Cross-package SSR/protocol coverage for Vue pages mode also lives in `framework/packages/void/test/integration/*`.
+Cross-package SSR/protocol coverage for Vue 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-CsYmObm4.d.mts → index-CD3rUeKP.d.mts}

@@ -2,7 +2,6 @@ import { Component } from "vue";
 import { ActionResult, NavigationState, VisitOptions, VoidActionError, VoidRouter } from "void/pages-client";
 import { CloudContextVariables, DeferredState as Deferred, InferProps } from "void";
 import { ActionFormOptions, ActionUrl, ResolveActionBody, ResolveActionParams } from "void/routes";
-
 //#region src/runtime/link.d.ts
 declare const Link: Component;
 //#endregion
@@ -58,9 +57,9 @@ type IslandFormReturn<T extends Record<string, unknown>> = Readonly<{
   clearError(): void;
 }>;
 /**
-* Form composable for island pages. Uses fetch + page reload instead of the
-* Void Router (which is not available in island mode).
-*/
+ * Form composable 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 useIslandForm, c as useShared, d as Link, i as setActionRouter, l as useParams, n as InferProps, o as useNavigation, r as action, s as useForm, t as Deferred, u as useRouter } from "./index-CsYmObm4.mjs";
+import { a as useIslandForm, c as useShared, d as Link, i as setActionRouter, l as useParams, n as InferProps, o as useNavigation, r as action, s as useForm, t as Deferred, u as useRouter } from "./index-CD3rUeKP.mjs";
 export { type Deferred, type InferProps, Link, action, setActionRouter, useForm, useIslandForm, useNavigation, useParams, useRouter, useShared };

package/dist/plugin.d.mts

@@ -1,11 +1,9 @@
 import vue from "@vitejs/plugin-vue";
 import { Plugin } from "vite";
-
 //#region src/plugin.d.ts
-type VoidVueOptions = Readonly<{
+export type VoidVueOptions = Readonly<{
   vue?: Parameters<typeof vue>[0];
   viewTransitions?: boolean;
 }>;
-declare function voidVue(options?: VoidVueOptions): Array<Plugin>;
-//#endregion
-export { VoidVueOptions, voidVue };
+export declare function voidVue(options?: VoidVueOptions): Array<Plugin>;
+//#endregion

package/dist/plugin.mjs

@@ -344,6 +344,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";
 function isVuePageFile(id, pagesDir) {
 	if (!id.startsWith(pagesDir + "/")) return false;
@@ -406,7 +407,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);
 		}
@@ -453,11 +454,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);
 				}
-				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 }));
 				}
@@ -568,6 +569,7 @@ const params = reactive({});
 const currentComponent = shallowRef(null);
 const currentLayouts = shallowRef([]);
 const currentProps = shallowRef({});
+const currentPageKey = ref(0);
 const routeUrl = ref(window.location.pathname + window.location.search + window.location.hash);
 const navigation = reactive(idleNavigationState());
 
@@ -589,7 +591,8 @@ const { router, initialPageData, initialComponent, initialLayouts, start } =
       resolveDeferred(ref, value) { resolveDeferred(ref, value); return ref; },
       rejectDeferred(ref, error) { rejectDeferred(ref, error); return ref; },
       isLoading: (ref) => ref.loading,
-      applyUpdate(pageData, comp, layouts) {
+      applyUpdate(pageData, comp, layouts, options) {
+        if (!options?.preserveState) currentPageKey.value++;
         Object.assign(shared, pageData.shared || {});
         replaceRecord(errors, pageData.errors || {});
         replaceRecord(params, pageData.params || {});
@@ -640,7 +643,7 @@ const app = createVoidApp({
     return () => {
       if (!currentComponent.value) return null;
       patchProps(currentComponent.value, currentProps.value);
-      let vnode = h(currentComponent.value, currentProps.value);
+      let vnode = h(currentComponent.value, { ...currentProps.value, key: currentPageKey.value });
       for (let i = currentLayouts.value.length - 1; i >= 0; i--) {
         const inner = vnode;
         vnode = h(currentLayouts.value[i], null, { default: () => inner });

package/dist/runtime/index.d.mts

@@ -1,2 +1,2 @@
-import { a as useIslandForm, c as useShared, d as Link, i as setActionRouter, l as useParams, n as InferProps, o as useNavigation, r as action, s as useForm, t as Deferred, u as useRouter } from "../index-CsYmObm4.mjs";
+import { a as useIslandForm, c as useShared, d as Link, i as setActionRouter, l as useParams, n as InferProps, o as useNavigation, r as action, s as useForm, t as Deferred, u as useRouter } from "../index-CD3rUeKP.mjs";
 export { type Deferred, type InferProps, Link, action, setActionRouter, useForm, useIslandForm, useNavigation, useParams, useRouter, useShared };

package/dist/runtime/use-deferred.d.mts

@@ -1,5 +1,5 @@
 //#region src/runtime/use-deferred.d.ts
-type DeferredRef<T = unknown> = {
+export type DeferredRef<T = unknown> = {
   value: null;
   loading: true;
   error: null;
@@ -12,8 +12,7 @@ type DeferredRef<T = unknown> = {
   loading: false;
   error: Error;
 };
-declare function createDeferred<T = unknown>(): DeferredRef<T>;
-declare function resolveDeferred(ref: DeferredRef, data: unknown): void;
-declare function rejectDeferred(ref: DeferredRef, error: string): void;
-//#endregion
-export { DeferredRef, createDeferred, rejectDeferred, resolveDeferred };
+export declare function createDeferred<T = unknown>(): DeferredRef<T>;
+export declare function resolveDeferred(ref: DeferredRef, data: unknown): void;
+export declare function rejectDeferred(ref: DeferredRef, error: string): void;
+//#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@void/vue",
-  "version": "0.10.12",
+  "version": "0.20.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/voidzero-dev/void.git",
@@ -19,41 +19,33 @@
       "types": "./dist/plugin.d.mts",
       "import": "./dist/plugin.mjs"
     },
-    "./runtime": {
-      "types": "./dist/runtime/index.d.mts",
-      "import": "./dist/runtime/index.mjs"
-    },
     "./deferred": {
       "types": "./dist/runtime/use-deferred.d.mts",
       "import": "./dist/runtime/use-deferred.mjs"
-    },
-    "./prefetch": {
-      "types": "./dist/runtime/prefetch.d.mts",
-      "import": "./dist/runtime/prefetch.mjs"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@vitejs/plugin-vue": "^6.0.7"
+    "@vitejs/plugin-vue": "^6.0.8"
   },
   "devDependencies": {
-    "@types/node": "^26.1.0",
+    "@types/node": "^26.5.1",
     "pathslash": "^0.1.0",
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.2",
-    "vite-plus": "^0.2.2",
-    "vue": "^3.5.39",
-    "void": "0.10.12"
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.1",
+    "vite-plus": "0.3.1",
+    "void": "0.20.0",
+    "vue": "^3.5.42"
   },
   "peerDependencies": {
     "vite": "^8.0.0",
-    "vue": "^3.5.0",
-    "void": "0.10.12"
+    "void": "0.20.0",
+    "vue": "^3.5.0"
   },
   "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 };