@vue-solana/nuxt 0.1.0 → 0.1.2

package/README.md

@@ -2,13 +2,27 @@
 
 Nuxt module for Solana applications.
 
+Use this package in Nuxt apps that need the Vue Solana plugin installed automatically plus auto-imported composables.
+
+New to Solana? Start with the official docs and the project concepts guide:
+
+- [Solana Documentation](https://solana.com/docs)
+- [Solana RPC Methods](https://solana.com/docs/rpc)
+- [Solana Clusters](https://solana.com/docs/references/clusters)
+- [Vue Solana Concepts Guide](https://github.com/vue-solana/vue-solana/tree/main/apps/docs/content/concepts/solana-for-vue-developers.md)
+- [`@vue-solana/nuxt` docs](https://github.com/vue-solana/vue-solana/tree/main/apps/docs/content/packages/nuxt.md)
+
 ## Install
 
 ```sh
 pnpm add @vue-solana/nuxt @vue-solana/vue @vue-solana/core @solana/web3-compat
 ```
 
-## Usage
+```sh
+npm install @vue-solana/nuxt @vue-solana/vue @vue-solana/core @solana/web3-compat
+```
+
+## Module Setup
 
 ```ts
 export default defineNuxtConfig({
@@ -19,8 +33,136 @@ export default defineNuxtConfig({
 })
 ```
 
+You can also configure a custom RPC endpoint:
+
+```ts
+export default defineNuxtConfig({
+  modules: ['@vue-solana/nuxt'],
+  solana: {
+    cluster: 'mainnet-beta',
+    endpoint: 'https://your-rpc.example.com',
+    commitment: 'confirmed'
+  }
+})
+```
+
+Supported clusters are `mainnet-beta`, `devnet`, `testnet`, and `localnet`. Use `mainnet-beta` for Solana mainnet; this is Solana's official cluster name.
+
+For development, use `devnet` and request free test SOL from the official faucet:
+
+```txt
+https://faucet.solana.com
+```
+
+## Auto-Imported Composables
+
+The module auto-imports these composables from `@vue-solana/vue`:
+
+- `useSolana()`
+- `useSolanaRpc()`
+- `useSolanaConnection()`
+- `useSolanaWallet()`
+- `useSolanaBalance()`
+- `useSolanaSignAndSendTransaction()`
+
+## Read RPC State
+
+```vue
+<script setup lang="ts">
+const {
+  cluster,
+  endpoint,
+  status,
+  latestBlockhash,
+  checkConnection
+} = useSolanaRpc()
+</script>
+
+<template>
+  <section>
+    <p>Cluster: {{ cluster }}</p>
+    <p>Endpoint: {{ endpoint }}</p>
+    <p>Status: {{ status }}</p>
+    <p>Latest blockhash: {{ latestBlockhash }}</p>
+    <button type="button" @click="checkConnection">Check RPC</button>
+  </section>
+</template>
+```
+
+## Read Balance
+
+```vue
+<script setup lang="ts">
+const address = ref('PASTE_A_SOLANA_ADDRESS')
+const { balance, loading, error, refresh } = useSolanaBalance(address)
+</script>
+
+<template>
+  <section>
+    <p>Lamports: {{ balance }}</p>
+    <p v-if="loading">Loading...</p>
+    <pre v-if="error">{{ error }}</pre>
+    <button type="button" @click="refresh">Refresh</button>
+  </section>
+</template>
+```
+
+## Wallet State
+
+```vue
+<script setup lang="ts">
+const { publicKey, connected, connect, disconnect } = useSolanaWallet()
+</script>
+
+<template>
+  <section>
+    <p>Connected: {{ connected }}</p>
+    <p>Public key: {{ publicKey?.toBase58() }}</p>
+    <button type="button" @click="connect">Connect</button>
+    <button type="button" @click="disconnect">Disconnect</button>
+  </section>
+</template>
+```
+
+Browser wallet discovery is not included yet. Wallet actions work only after you configure a wallet object that implements `SolanaWallet`.
+
+## Example App
+
+This README includes small snippets for quick reference. For a complete runnable Nuxt flow, see the example app:
+
+```sh
+pnpm dev:nuxt
+```
+
+Source: [`examples/nuxt`](https://github.com/vue-solana/vue-solana/tree/main/examples/nuxt)
+
 ## Known TypeScript Issue
 
 `@solana/web3-compat@0.0.21` currently has broken TypeScript metadata. Runtime imports still use the real package, but TypeScript consumers may need a local declaration shim.
 
-Add `types/web3-compat.d.ts` to your app if TypeScript cannot resolve `@solana/web3-compat`. See the repository README for the full workaround.
+If TypeScript cannot resolve `@solana/web3-compat`, add `types/web3-compat.d.ts` to your app:
+
+```ts
+declare module '@solana/web3-compat' {
+  export type {
+    Commitment,
+    SendOptions,
+    TransactionSignature
+  } from '@solana/web3.js'
+  export {
+    Connection,
+    Keypair,
+    PublicKey,
+    SystemProgram,
+    Transaction,
+    TransactionInstruction,
+    VersionedTransaction
+  } from '@solana/web3.js'
+}
+```
+
+Make sure your `tsconfig.json` includes `types/**/*.d.ts` or another pattern that includes the shim.
+
+## Status
+
+This package is early-stage. RPC and balance reads are usable; first-class browser wallet adapter support is planned.

package/dist/module.d.cts

@@ -1,9 +1,10 @@
-import * as nuxt_schema from 'nuxt/schema';
+import { defineNuxtModule } from '@nuxt/kit';
 import { SolanaConfig } from '@vue-solana/core';
 
 interface ModuleOptions extends SolanaConfig {
 }
-declare const _default: nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
+type DefinedNuxtModule = ReturnType<ReturnType<typeof defineNuxtModule<ModuleOptions>>['with']>;
+declare const module$1: DefinedNuxtModule;
 
-export = _default;
+export = module$1;
 export type { ModuleOptions };

package/dist/module.d.mts

@@ -1,9 +1,10 @@
-import * as nuxt_schema from 'nuxt/schema';
+import { defineNuxtModule } from '@nuxt/kit';
 import { SolanaConfig } from '@vue-solana/core';
 
 interface ModuleOptions extends SolanaConfig {
 }
-declare const _default: nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
+type DefinedNuxtModule = ReturnType<ReturnType<typeof defineNuxtModule<ModuleOptions>>['with']>;
+declare const module$1: DefinedNuxtModule;
 
-export { _default as default };
+export { module$1 as default };
 export type { ModuleOptions };

package/dist/module.d.ts

@@ -1,9 +1,10 @@
-import * as nuxt_schema from 'nuxt/schema';
+import { defineNuxtModule } from '@nuxt/kit';
 import { SolanaConfig } from '@vue-solana/core';
 
 interface ModuleOptions extends SolanaConfig {
 }
-declare const _default: nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
+type DefinedNuxtModule = ReturnType<ReturnType<typeof defineNuxtModule<ModuleOptions>>['with']>;
+declare const module$1: DefinedNuxtModule;
 
-export = _default;
+export = module$1;
 export type { ModuleOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vue-solana/nuxt",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Nuxt module for Solana applications.",
   "license": "MIT",
   "keywords": [
@@ -11,7 +11,7 @@
     "web3",
     "wallet"
   ],
-  "homepage": "https://github.com/vue-solana/vue-solana#readme",
+  "homepage": "https://vue-solana-docs.vercel.app/packages/nuxt",
   "bugs": {
     "url": "https://github.com/vue-solana/vue-solana/issues"
   },
@@ -38,8 +38,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@vue-solana/core": "0.1.0",
-    "@vue-solana/vue": "0.1.0"
+    "@vue-solana/core": "0.1.2",
+    "@vue-solana/vue": "0.1.2"
   },
   "peerDependencies": {
     "@solana/web3-compat": "^0.0.21",