@vue-solana/nuxt 0.6.3 → 0.6.5

package/README.md

@@ -30,22 +30,20 @@ New to Solana? Start with the official docs and the project concepts guide:
 
 ## Compatibility
 
-| Requirement        | Supported                                       |
-| ------------------ | ----------------------------------------------- |
-| Nuxt               | `^3.0.0 \|\| ^4.0.0`                            |
-| TypeScript         | TypeScript 5.x recommended                      |
-| Solana client peer | `@solana/web3-compat@^0.0.21`                   |
-| Clusters           | `mainnet-beta`, `devnet`, `testnet`, `localnet` |
+| Requirement   | Supported                                       |
+| ------------- | ----------------------------------------------- |
+| Nuxt          | `^3.0.0 \|\| ^4.0.0`                            |
+| TypeScript    | TypeScript 5.x recommended                      |
+| Solana client | Provided through `@vue-solana/core`             |
+| Clusters      | `mainnet-beta`, `devnet`, `testnet`, `localnet` |
 
 ## Install
 
 ```sh
-pnpm add @vue-solana/nuxt @vue-solana/vue @vue-solana/core @solana/web3-compat buffer
+npx nuxt module add @vue-solana/nuxt
 ```
 
-```sh
-npm install @vue-solana/nuxt @vue-solana/vue @vue-solana/core @solana/web3-compat buffer
-```
+This installs the package and adds `@vue-solana/nuxt` to the `modules` array in `nuxt.config.ts`.
 
 ## Module Setup
 
@@ -128,6 +126,11 @@ The runtime plugin is client-only. Auto-imported composables can be called durin
 
 Android Mobile Wallet Adapter registration also runs only on the client. On Android Chrome and Chrome PWAs, `Mobile Wallet Adapter` can appear in the same `useSolanaWallets()` list as browser extension wallets. On iOS browsers, Phantom, Solflare, and Backpack can appear in the same list through wallet-specific universal links. Desktop native app wallet adapters are planned but not implemented yet.
 
+The package also exposes Solana helper subpaths for Nuxt apps that need transaction primitives or the browser Buffer polyfill without importing lower-level packages directly:
+
+- `@vue-solana/nuxt/web3`
+- `@vue-solana/nuxt/buffer-polyfill`
+
 ## Read RPC State
 
 ```vue
@@ -212,7 +215,7 @@ const { publicKey, connected, canSignMessage, connect, disconnect } = useSolanaW
 </template>
 ```
 
-Browser extension wallets are discovered through the Solana Wallet Standard. Android Mobile Wallet Adapter wallets are registered through `@solana-mobile/wallet-standard-mobile` on supported Android Chrome clients and exposed through the same wallet list. Wallet actions work after selecting a discovered wallet or configuring a custom `SolanaWallet`.
+Browser extension wallets are discovered through the Solana Wallet Standard. Android Mobile Wallet Adapter wallets are registered through `@solana-mobile/wallet-standard-mobile` on supported Android Chrome clients and exposed through the same wallet list. iOS Phantom, Solflare, and Backpack entries are exposed through wallet-specific universal links on iOS browsers. Wallet actions work after selecting a discovered wallet or configuring a custom `SolanaWallet`.
 
 Selected discovered wallets are persisted under `localStorage["vue-solana:selected-wallet"]` as non-sensitive identity metadata: `name`, and `platform`/`source` when available. On reload, Vue Solana restores the selected wallet if the same wallet is discovered again. Set `solana.autoConnect: true` to opt into calling `connect()` for that restored wallet; arbitrary installed wallets are never auto-connected. Calling `selectWallet(null)` or `setWallet(customWallet)` clears the stored selection.
 
@@ -272,7 +275,7 @@ Docs: [Vue Solana Agent Skill](https://vue-solana-docs.vercel.app/agent-skill)
 - Public Solana RPC endpoints are useful for development, but production apps should use dedicated RPC infrastructure.
 - Broad `useSolanaProgramAccounts()` scans can be expensive or blocked on public RPC nodes. Prefer narrow filters and `dataSlice`.
 - Use `mainnet-beta` for Solana mainnet. `mainnet` is intentionally not accepted as a cluster alias.
-- `@solana/web3-compat@0.0.21` currently has broken TypeScript package metadata. Runtime imports still use the real package, but TypeScript consumers may need a local declaration shim. See [Troubleshooting](https://vue-solana-docs.vercel.app/troubleshooting) for the workaround.
+- `@solana/web3-compat@0.0.21` currently has broken TypeScript package metadata. Runtime imports still use the real package, and current Vue Solana packages publish temporary declaration shims for documented imports. See [Troubleshooting](https://vue-solana-docs.vercel.app/troubleshooting) for details.
 - Desktop native app wallets are planned but not implemented yet.
 
 ## Status

package/dist/module.cjs

@@ -39,10 +39,14 @@ const VITE_OPTIMIZE_DEPS = [
   "tweetnacl",
   "tweetnacl/nacl-fast.js"
 ];
+const VITE_NEEDS_INTEROP = ["eventemitter3", "tweetnacl", "tweetnacl/nacl-fast.js"];
 const module$1 = kit.defineNuxtModule({
   meta: {
     name: "@vue-solana/nuxt",
-    configKey: "solana"
+    configKey: "solana",
+    compatibility: {
+      nuxt: "^3.0.0 || ^4.0.0"
+    }
   },
   defaults: {
     cluster: "devnet",
@@ -55,17 +59,16 @@ const module$1 = kit.defineNuxtModule({
       ...typeof publicConfig.solana === "object" && publicConfig.solana !== null ? publicConfig.solana : {},
       ...toPublicSolanaConfig(options)
     };
-    nuxt.options.vite.optimizeDeps ??= {};
-    nuxt.options.vite.optimizeDeps.include = Array.from(
-      /* @__PURE__ */ new Set([...nuxt.options.vite.optimizeDeps.include ?? [], ...VITE_OPTIMIZE_DEPS])
-    );
-    nuxt.options.vite.optimizeDeps.needsInterop = Array.from(
-      /* @__PURE__ */ new Set([
-        ...nuxt.options.vite.optimizeDeps.needsInterop ?? [],
-        "tweetnacl",
-        "tweetnacl/nacl-fast.js"
-      ])
-    );
+    mergeViteOptimizeDeps(nuxt.options.vite);
+    nuxt.hook("vite:extendConfig", (config, { isClient }) => {
+      if (!isClient) {
+        return;
+      }
+      mergeViteOptimizeDeps(config);
+      if (config.environments?.client) {
+        mergeViteOptimizeDeps(config.environments.client);
+      }
+    });
     kit.addPlugin({
       src: resolver.resolve("./runtime/plugin"),
       mode: "client"
@@ -78,5 +81,14 @@ function toPublicSolanaConfig(options) {
   delete runtimeOptions.wallet;
   return runtimeOptions;
 }
+function mergeViteOptimizeDeps(target) {
+  target.optimizeDeps ??= {};
+  target.optimizeDeps.include = Array.from(
+    /* @__PURE__ */ new Set([...target.optimizeDeps.include ?? [], ...VITE_OPTIMIZE_DEPS])
+  );
+  target.optimizeDeps.needsInterop = Array.from(
+    /* @__PURE__ */ new Set([...target.optimizeDeps.needsInterop ?? [], ...VITE_NEEDS_INTEROP])
+  );
+}
 
 module.exports = module$1;

package/dist/module.mjs

@@ -36,10 +36,14 @@ const VITE_OPTIMIZE_DEPS = [
   "tweetnacl",
   "tweetnacl/nacl-fast.js"
 ];
+const VITE_NEEDS_INTEROP = ["eventemitter3", "tweetnacl", "tweetnacl/nacl-fast.js"];
 const module$1 = defineNuxtModule({
   meta: {
     name: "@vue-solana/nuxt",
-    configKey: "solana"
+    configKey: "solana",
+    compatibility: {
+      nuxt: "^3.0.0 || ^4.0.0"
+    }
   },
   defaults: {
     cluster: "devnet",
@@ -52,17 +56,16 @@ const module$1 = defineNuxtModule({
       ...typeof publicConfig.solana === "object" && publicConfig.solana !== null ? publicConfig.solana : {},
       ...toPublicSolanaConfig(options)
     };
-    nuxt.options.vite.optimizeDeps ??= {};
-    nuxt.options.vite.optimizeDeps.include = Array.from(
-      /* @__PURE__ */ new Set([...nuxt.options.vite.optimizeDeps.include ?? [], ...VITE_OPTIMIZE_DEPS])
-    );
-    nuxt.options.vite.optimizeDeps.needsInterop = Array.from(
-      /* @__PURE__ */ new Set([
-        ...nuxt.options.vite.optimizeDeps.needsInterop ?? [],
-        "tweetnacl",
-        "tweetnacl/nacl-fast.js"
-      ])
-    );
+    mergeViteOptimizeDeps(nuxt.options.vite);
+    nuxt.hook("vite:extendConfig", (config, { isClient }) => {
+      if (!isClient) {
+        return;
+      }
+      mergeViteOptimizeDeps(config);
+      if (config.environments?.client) {
+        mergeViteOptimizeDeps(config.environments.client);
+      }
+    });
     addPlugin({
       src: resolver.resolve("./runtime/plugin"),
       mode: "client"
@@ -75,5 +78,14 @@ function toPublicSolanaConfig(options) {
   delete runtimeOptions.wallet;
   return runtimeOptions;
 }
+function mergeViteOptimizeDeps(target) {
+  target.optimizeDeps ??= {};
+  target.optimizeDeps.include = Array.from(
+    /* @__PURE__ */ new Set([...target.optimizeDeps.include ?? [], ...VITE_OPTIMIZE_DEPS])
+  );
+  target.optimizeDeps.needsInterop = Array.from(
+    /* @__PURE__ */ new Set([...target.optimizeDeps.needsInterop ?? [], ...VITE_NEEDS_INTEROP])
+  );
+}
 
 export { module$1 as default };

package/dist/runtime/buffer-polyfill.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+const bufferPolyfill = require('@vue-solana/vue/buffer-polyfill');
+
+
+
+exports.Buffer = bufferPolyfill.Buffer;
+exports.installSolanaBufferPolyfill = bufferPolyfill.installSolanaBufferPolyfill;

package/dist/runtime/buffer-polyfill.d.cts

@@ -0,0 +1,2 @@
+export { Buffer, installSolanaBufferPolyfill } from '@vue-solana/vue/buffer-polyfill';
+import '@vue-solana/vue/web3';

package/dist/runtime/buffer-polyfill.d.mts

@@ -0,0 +1,2 @@
+export { Buffer, installSolanaBufferPolyfill } from '@vue-solana/vue/buffer-polyfill';
+import '@vue-solana/vue/web3';

package/dist/runtime/buffer-polyfill.d.ts

@@ -0,0 +1,2 @@
+export { Buffer, installSolanaBufferPolyfill } from '@vue-solana/vue/buffer-polyfill';
+import '@vue-solana/vue/web3';

package/dist/runtime/buffer-polyfill.mjs

@@ -0,0 +1 @@
+export { Buffer, installSolanaBufferPolyfill } from '@vue-solana/vue/buffer-polyfill';

package/dist/runtime/web3.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+const web3 = require('@vue-solana/vue/web3');
+
+
+
+exports.Connection = web3.Connection;
+exports.Keypair = web3.Keypair;
+exports.PublicKey = web3.PublicKey;
+exports.SystemProgram = web3.SystemProgram;
+exports.Transaction = web3.Transaction;
+exports.TransactionInstruction = web3.TransactionInstruction;
+exports.VersionedTransaction = web3.VersionedTransaction;

package/dist/runtime/web3.d.cts

@@ -0,0 +1 @@
+export { AccountInfo, Commitment, Connection, Keypair, PublicKey, RpcResponseAndContext, SendOptions, SignatureResult, SignatureStatus, SystemProgram, Transaction, TransactionInstruction, TransactionSignature, VersionedTransaction } from '@vue-solana/vue/web3';

package/dist/runtime/web3.d.mts

@@ -0,0 +1 @@
+export { AccountInfo, Commitment, Connection, Keypair, PublicKey, RpcResponseAndContext, SendOptions, SignatureResult, SignatureStatus, SystemProgram, Transaction, TransactionInstruction, TransactionSignature, VersionedTransaction } from '@vue-solana/vue/web3';

package/dist/runtime/web3.d.ts

@@ -0,0 +1 @@
+export { AccountInfo, Commitment, Connection, Keypair, PublicKey, RpcResponseAndContext, SendOptions, SignatureResult, SignatureStatus, SystemProgram, Transaction, TransactionInstruction, TransactionSignature, VersionedTransaction } from '@vue-solana/vue/web3';

package/dist/runtime/web3.mjs

@@ -0,0 +1 @@
+export { Connection, Keypair, PublicKey, SystemProgram, Transaction, TransactionInstruction, VersionedTransaction } from '@vue-solana/vue/web3';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vue-solana/nuxt",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "description": "Nuxt module for Solana applications.",
   "license": "MIT",
   "keywords": [
@@ -23,12 +23,22 @@
   "type": "module",
   "main": "./dist/module.cjs",
   "module": "./dist/module.mjs",
-  "types": "./dist/module.d.ts",
+  "types": "./dist/module.d.mts",
   "exports": {
     ".": {
-      "types": "./dist/module.d.ts",
+      "types": "./dist/module.d.mts",
       "import": "./dist/module.mjs",
       "require": "./dist/module.cjs"
+    },
+    "./buffer-polyfill": {
+      "types": "./dist/runtime/buffer-polyfill.d.ts",
+      "import": "./dist/runtime/buffer-polyfill.mjs",
+      "require": "./dist/runtime/buffer-polyfill.cjs"
+    },
+    "./web3": {
+      "types": "./dist/runtime/web3.d.ts",
+      "import": "./dist/runtime/web3.mjs",
+      "require": "./dist/runtime/web3.cjs"
     }
   },
   "files": [
@@ -38,16 +48,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@vue-solana/core": "0.7.1",
-    "@vue-solana/vue": "0.8.2"
+    "@solana/web3-compat": "^0.0.21",
+    "@vue-solana/vue": "0.8.3"
   },
   "peerDependencies": {
-    "@solana/web3-compat": "^0.0.21",
     "nuxt": "^3.0.0 || ^4.0.0"
   },
   "devDependencies": {
     "@nuxt/kit": "^4.4.6",
-    "@solana/web3-compat": "^0.0.21",
     "nuxt": "^4.4.6",
     "typescript": "^5.8.3",
     "unbuild": "^3.5.0",