@queryweave/nuxt 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QueryWeave contributors
+
+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

@@ -0,0 +1,19 @@
+# `@queryweave/nuxt`
+
+A minimal Nuxt module and runtime plugin.
+
+```ts
+export default defineNuxtConfig({
+  modules: ["@queryweave/nuxt"],
+  queryweave: { autoImports: true, enabled: true },
+});
+```
+
+The module registers the runtime plugin and auto-imports `useQueryModel` and
+`provideQueryAdapter`. The plugin creates one Vue Router adapter per Vue application instance,
+which is per request on the server, so nothing is shared between concurrent renders and no browser
+global is read during server rendering. The first render already sees the decoded query, so
+hydration matches.
+
+Module-time exports and `./runtime` exports stay separate, and no runtime state is held at module
+scope. The Nuxt-specific API is deliberately small and not final.

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { NuxtModule } from "@nuxt/schema";
+//#region src/index.d.ts
+/**
+ * Module-time surface.
+ *
+ * Nothing here runs per request. Request-scoped state is created by the runtime plugin, which is
+ * registered below and exported separately under `@queryweave/nuxt/runtime`.
+ */
+/** Options accepted under the `queryweave` key of `nuxt.config`. */
+interface QueryWeaveModuleOptions {
+  /** Register auto-imports for the Vue binding. Enabled by default. */
+  readonly autoImports?: boolean;
+  /** Register the runtime plugin. Enabled by default. */
+  readonly enabled?: boolean;
+}
+/**
+ * The module is annotated explicitly so the generated declaration stays self-contained. Without
+ * it, the inferred type references type parameters a consumer cannot resolve.
+ */
+declare const queryWeaveModule: NuxtModule<QueryWeaveModuleOptions>;
+//#endregion
+export { QueryWeaveModuleOptions, queryWeaveModule as default };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;UAWiB;;WAEN;;WAEA;;;;;;cAOL,kBAAkB,WAAW"}

package/dist/index.js

@@ -0,0 +1,34 @@
+import { addImports, addPlugin, createResolver, defineNuxtModule } from "@nuxt/kit";
+
+//#region src/index.ts
+/**
+* The module is annotated explicitly so the generated declaration stays self-contained. Without
+* it, the inferred type references type parameters a consumer cannot resolve.
+*/
+const queryWeaveModule = defineNuxtModule({
+	meta: {
+		name: "@queryweave/nuxt",
+		configKey: "queryweave",
+		compatibility: { nuxt: ">=4.0.0" }
+	},
+	defaults: {
+		autoImports: true,
+		enabled: true
+	},
+	setup(options) {
+		if (options.enabled === false) return;
+		addPlugin(createResolver(import.meta.url).resolve("./runtime/plugin"));
+		if (options.autoImports === false) return;
+		addImports([{
+			name: "useQueryModel",
+			from: "@queryweave/vue"
+		}, {
+			name: "provideQueryAdapter",
+			from: "@queryweave/vue"
+		}]);
+	}
+});
+
+//#endregion
+export { queryWeaveModule as default };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { addImports, addPlugin, createResolver, defineNuxtModule } from \"@nuxt/kit\";\nimport type { NuxtModule } from \"@nuxt/schema\";\n\n/**\n * Module-time surface.\n *\n * Nothing here runs per request. Request-scoped state is created by the runtime plugin, which is\n * registered below and exported separately under `@queryweave/nuxt/runtime`.\n */\n\n/** Options accepted under the `queryweave` key of `nuxt.config`. */\nexport interface QueryWeaveModuleOptions {\n  /** Register auto-imports for the Vue binding. Enabled by default. */\n  readonly autoImports?: boolean;\n  /** Register the runtime plugin. Enabled by default. */\n  readonly enabled?: boolean;\n}\n\n/**\n * The module is annotated explicitly so the generated declaration stays self-contained. Without\n * it, the inferred type references type parameters a consumer cannot resolve.\n */\nconst queryWeaveModule: NuxtModule<QueryWeaveModuleOptions> =\n  defineNuxtModule<QueryWeaveModuleOptions>({\n    meta: {\n      name: \"@queryweave/nuxt\",\n      configKey: \"queryweave\",\n      compatibility: {\n        nuxt: \">=4.0.0\",\n      },\n    },\n    defaults: {\n      autoImports: true,\n      enabled: true,\n    },\n    setup(options: QueryWeaveModuleOptions) {\n      if (options.enabled === false) {\n        return;\n      }\n\n      const resolver = createResolver(import.meta.url);\n      addPlugin(resolver.resolve(\"./runtime/plugin\"));\n\n      if (options.autoImports === false) {\n        return;\n      }\n\n      addImports([\n        { name: \"useQueryModel\", from: \"@queryweave/vue\" },\n        { name: \"provideQueryAdapter\", from: \"@queryweave/vue\" },\n      ]);\n    },\n  });\n\nexport default queryWeaveModule;\n"],"mappings":";;;;;;;AAsBA,MAAM,mBACJ,iBAA0C;CACxC,MAAM;EACJ,MAAM;EACN,WAAW;EACX,eAAe,EACb,MAAM,UACR;CACF;CACA,UAAU;EACR,aAAa;EACb,SAAS;CACX;CACA,MAAM,SAAkC;EACtC,IAAI,QAAQ,YAAY,OACtB;EAIF,UADiB,eAAe,OAAO,KAAK,GAC3B,CAAC,CAAC,QAAQ,kBAAkB,CAAC;EAE9C,IAAI,QAAQ,gBAAgB,OAC1B;EAGF,WAAW,CACT;GAAE,MAAM;GAAiB,MAAM;EAAkB,GACjD;GAAE,MAAM;GAAuB,MAAM;EAAkB,CACzD,CAAC;CACH;AACF,CAAC"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,22 @@
+import { VueRouterQueryAdapter, VueRouterQueryAdapter as VueRouterQueryAdapter$1 } from "@queryweave/vue-router";
+import { QueryAdapter } from "@queryweave/core";
+import { App } from "vue";
+import { Router } from "vue-router";
+//#region src/runtime/adapter.d.ts
+/**
+ * Request-scoped runtime wiring.
+ *
+ * Every helper here takes the Vue application and router it should serve. Nothing is stored at
+ * module scope, so a server rendering two requests never shares adapter state between them.
+ */
+/** Create the adapter a Nuxt application should use. */
+declare function createNuxtQueryAdapter(router: Router): VueRouterQueryAdapter$1;
+/**
+ * Install an adapter into one Vue application instance.
+ *
+ * Any adapter is accepted, so an application can substitute its own without leaving the module.
+ */
+declare function installQueryAdapter(app: App, adapter: QueryAdapter): void;
+//#endregion
+export { type VueRouterQueryAdapter, createNuxtQueryAdapter, installQueryAdapter };
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/runtime/adapter.ts"],"mappings":";;;;;;;;;;;;iBAcgB,uBAAuB,QAAQ,SAAS;;;;;;iBASxC,oBAAoB,KAAK,KAAK,SAAS"}

package/dist/runtime/index.js

@@ -0,0 +1,3 @@
+import { n as installQueryAdapter, t as createNuxtQueryAdapter } from "../shared/adapter.js";
+
+export { createNuxtQueryAdapter, installQueryAdapter };

package/dist/runtime/plugin.d.ts

@@ -0,0 +1,15 @@
+//#region src/runtime/plugin.d.ts
+/**
+ * Registers one adapter per Vue application instance.
+ *
+ * Nuxt creates a fresh application for every server render, so the adapter is request-scoped by
+ * construction. No runtime global is read here, which keeps server rendering safe.
+ */
+declare const _default: import("nuxt/app").Plugin<{
+  queryWeaveAdapter: import("@queryweave/vue-router").VueRouterQueryAdapter;
+}> & import("nuxt/app").ObjectPlugin<{
+  queryWeaveAdapter: import("@queryweave/vue-router").VueRouterQueryAdapter;
+}>;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=plugin.d.ts.map

package/dist/runtime/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","names":[],"sources":["../../src/runtime/plugin.ts"],"mappings":";;;;;;;cAKA"}

package/dist/runtime/plugin.js

@@ -0,0 +1,23 @@
+import { n as installQueryAdapter, t as createNuxtQueryAdapter } from "../shared/adapter.js";
+import { defineNuxtPlugin } from "nuxt/app";
+
+//#region src/runtime/plugin.ts
+/**
+* Registers one adapter per Vue application instance.
+*
+* Nuxt creates a fresh application for every server render, so the adapter is request-scoped by
+* construction. No runtime global is read here, which keeps server rendering safe.
+*/
+var plugin_default = defineNuxtPlugin({
+	name: "queryweave:adapter",
+	setup(nuxtApp) {
+		const router = nuxtApp["$router"];
+		const adapter = createNuxtQueryAdapter(router);
+		installQueryAdapter(nuxtApp.vueApp, adapter);
+		return { provide: { queryWeaveAdapter: adapter } };
+	}
+});
+
+//#endregion
+export { plugin_default as default };
+//# sourceMappingURL=plugin.js.map

package/dist/runtime/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","names":[],"sources":["../../src/runtime/plugin.ts"],"sourcesContent":["import { defineNuxtPlugin } from \"nuxt/app\";\nimport type { Router } from \"vue-router\";\n\nimport { createNuxtQueryAdapter, installQueryAdapter } from \"./adapter\";\n\n/**\n * Registers one adapter per Vue application instance.\n *\n * Nuxt creates a fresh application for every server render, so the adapter is request-scoped by\n * construction. No runtime global is read here, which keeps server rendering safe.\n */\nexport default defineNuxtPlugin({\n  name: \"queryweave:adapter\",\n  setup(nuxtApp) {\n    const router = nuxtApp[\"$router\"] as Router;\n    const adapter = createNuxtQueryAdapter(router);\n    installQueryAdapter(nuxtApp.vueApp, adapter);\n\n    return {\n      provide: {\n        queryWeaveAdapter: adapter,\n      },\n    };\n  },\n});\n"],"mappings":";;;;;;;;;;AAWA,qBAAe,iBAAiB;CAC9B,MAAM;CACN,MAAM,SAAS;EACb,MAAM,SAAS,QAAQ;EACvB,MAAM,UAAU,uBAAuB,MAAM;EAC7C,oBAAoB,QAAQ,QAAQ,OAAO;EAE3C,OAAO,EACL,SAAS,EACP,mBAAmB,QACrB,EACF;CACF;AACF,CAAC"}

package/dist/shared/adapter.js

@@ -0,0 +1,26 @@
+import { queryAdapterKey } from "@queryweave/vue";
+import { createVueRouterAdapter } from "@queryweave/vue-router";
+
+//#region src/runtime/adapter.ts
+/**
+* Request-scoped runtime wiring.
+*
+* Every helper here takes the Vue application and router it should serve. Nothing is stored at
+* module scope, so a server rendering two requests never shares adapter state between them.
+*/
+/** Create the adapter a Nuxt application should use. */
+function createNuxtQueryAdapter(router) {
+	return createVueRouterAdapter(router);
+}
+/**
+* Install an adapter into one Vue application instance.
+*
+* Any adapter is accepted, so an application can substitute its own without leaving the module.
+*/
+function installQueryAdapter(app, adapter) {
+	app.provide(queryAdapterKey, adapter);
+}
+
+//#endregion
+export { installQueryAdapter as n, createNuxtQueryAdapter as t };
+//# sourceMappingURL=adapter.js.map

package/dist/shared/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","names":[],"sources":["../../src/runtime/adapter.ts"],"sourcesContent":["import type { QueryAdapter } from \"@queryweave/core\";\nimport { queryAdapterKey } from \"@queryweave/vue\";\nimport { createVueRouterAdapter, type VueRouterQueryAdapter } from \"@queryweave/vue-router\";\nimport type { App } from \"vue\";\nimport type { Router } from \"vue-router\";\n\n/**\n * Request-scoped runtime wiring.\n *\n * Every helper here takes the Vue application and router it should serve. Nothing is stored at\n * module scope, so a server rendering two requests never shares adapter state between them.\n */\n\n/** Create the adapter a Nuxt application should use. */\nexport function createNuxtQueryAdapter(router: Router): VueRouterQueryAdapter {\n  return createVueRouterAdapter(router);\n}\n\n/**\n * Install an adapter into one Vue application instance.\n *\n * Any adapter is accepted, so an application can substitute its own without leaving the module.\n */\nexport function installQueryAdapter(app: App, adapter: QueryAdapter): void {\n  app.provide(queryAdapterKey, adapter);\n}\n"],"mappings":";;;;;;;;;;;AAcA,SAAgB,uBAAuB,QAAuC;CAC5E,OAAO,uBAAuB,MAAM;AACtC;;;;;;AAOA,SAAgB,oBAAoB,KAAU,SAA6B;CACzE,IAAI,QAAQ,iBAAiB,OAAO;AACtC"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@queryweave/nuxt",
+  "version": "0.1.0-alpha.1",
+  "description": "Nuxt module and runtime integration contracts for QueryWeave.",
+  "keywords": [
+    "nuxt",
+    "query",
+    "state",
+    "url",
+    "vue"
+  ],
+  "homepage": "https://github.com/boussadjra/queryweave#readme",
+  "bugs": {
+    "url": "https://github.com/boussadjra/queryweave/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/boussadjra/queryweave.git",
+    "directory": "packages/nuxt"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
+    },
+    "./runtime/plugin": {
+      "types": "./dist/runtime/plugin.d.ts",
+      "import": "./dist/runtime/plugin.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@nuxt/kit": "4.5.0",
+    "@nuxt/schema": "4.5.0",
+    "@queryweave/core": "0.1.0-alpha.1",
+    "@queryweave/vue": "0.1.0-alpha.1",
+    "@queryweave/vue-router": "0.1.0-alpha.1"
+  },
+  "devDependencies": {
+    "nuxt": "4.5.0",
+    "vue": "3.5.40",
+    "vue-router": "5.2.0",
+    "@queryweave/typescript-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "nuxt": ">=4.5.0 <5",
+    "vue": ">=3.5.0 <4",
+    "vue-router": ">=5.2.0 <6"
+  },
+  "engines": {
+    "node": ">=24.18.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc -p tsconfig.json",
+    "test:types": "tsc -p tsconfig.json",
+    "package:check": "publint --strict && attw --pack . --profile esm-only",
+    "clean": "node ../../scripts/clean-package.mjs"
+  }
+}