@vue-solana/vue 0.3.2 → 0.4.0

package/README.md

@@ -11,6 +11,7 @@ New to Solana? Start with the official docs and the project concepts guide:
 - [Solana Clusters](https://solana.com/docs/references/clusters)
 - [Vue Solana Concepts Guide](https://vue-solana-docs.vercel.app/concepts/solana-for-vue-developers)
 - [`@vue-solana/vue` docs](https://vue-solana-docs.vercel.app/packages/vue)
+- [Agent Skill](https://vue-solana-docs.vercel.app/agent-skill)
 - [Live demo](https://vue-solana-docs.vercel.app/demo)
 
 ## Install
@@ -151,9 +152,9 @@ const { publicKey, connected, connecting, connect, disconnect } = useWallet();
 </template>
 ```
 
-Browser extension wallets are discovered through the Solana Wallet Standard. Android Mobile Wallet Adapter wallets are registered through `@solana-mobile/wallet-standard-mobile` and exposed through the same `useWallets()` list on supported Android Chrome clients. `connect()` works 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` and exposed through the same `useWallets()` list on supported Android Chrome clients. iOS Phantom, Solflare, and Backpack entries are exposed through wallet-specific universal links on iOS browsers. `connect()` works after selecting a discovered wallet or configuring a custom `SolanaWallet`.
 
-iOS browser wallet adapters and desktop native app wallet adapters are planned but not implemented yet.
+Desktop native app wallet adapters are planned but not implemented yet.
 
 Composables return inert SSR-safe state when no plugin context is available. Real RPC and wallet operations still require the plugin-provided client context.
 
@@ -183,6 +184,16 @@ Docs: <a href="https://vue-solana-docs.vercel.app/examples/vue-vite" target="_bl
 
 Live demo: [vue-solana-docs.vercel.app/demo](https://vue-solana-docs.vercel.app/demo)
 
+## AI Agent Skill
+
+If you use an AI coding agent, install the Vue Solana Agent Skill for plugin setup, composable imports, wallet flow guidance, transaction gotchas, and verification commands:
+
+```sh
+npx skills add vue-solana/vue-solana --skill vue-solana
+```
+
+Docs: [Vue Solana Agent Skill](https://vue-solana-docs.vercel.app/agent-skill)
+
 ## API
 
 - `createSolanaPlugin(options?)`: installs the Vue Solana context.

package/dist/index.cjs

@@ -8,6 +8,7 @@ const useSolana = require('./shared/vue.C4tLiG3R.cjs');
 const useTransaction = require('./shared/vue.CNhelr8H.cjs');
 const useWallet = require('./shared/vue.CwPjPFN6.cjs');
 const useWallets = require('./shared/vue.P9tgeC5S.cjs');
+const iosWallet = require('@vue-solana/core/ios-wallet');
 const walletStandard = require('@vue-solana/core/wallet-standard');
 const rpc = require('@vue-solana/core/rpc');
 const vue = require('vue');
@@ -66,9 +67,10 @@ function createSolanaPlugin(options = {}) {
       }
       function refreshWallets() {
         unsubscribeWallets ??= walletStandard.subscribeSolanaWallets(refreshWallets);
-        wallets.value = walletStandard.getRegisteredSolanaWallets();
+        handleIosWalletCallback();
+        wallets.value = getDiscoveredWallets();
         if (selectedWallet.value) {
-          selectedWallet.value = wallets.value.find((nextWallet) => nextWallet.name === selectedWallet.value?.name) ?? null;
+          selectedWallet.value = wallets.value.find((nextWallet) => isSameWallet(nextWallet, selectedWallet.value)) ?? null;
           if (!selectedWallet.value) {
             wallet.value = options.wallet ?? null;
           }
@@ -83,7 +85,7 @@ function createSolanaPlugin(options = {}) {
             chains: [walletStandard.getSolanaChain(context.cluster)],
             ...options.mobileWallet || {}
           });
-          wallets.value = walletStandard.getRegisteredSolanaWallets();
+          wallets.value = getDiscoveredWallets();
         }).catch((cause) => {
           console.error("[Vue Solana] Mobile wallet registration failed", cause);
         }).finally(() => {
@@ -95,6 +97,14 @@ function createSolanaPlugin(options = {}) {
         wallet.value = nextWallet ? getAdaptedWallet(nextWallet) : options.wallet ?? null;
       }
       function getAdaptedWallet(walletInfo) {
+        if (iosWallet.isSolanaIosWalletInfo(walletInfo)) {
+          return iosWallet.adaptSolanaIosWallet(walletInfo, {
+            chain: walletStandard.getSolanaChain(context.cluster),
+            cluster: context.cluster,
+            onChange: () => vue.triggerRef(wallet),
+            ...options.iosWallet || {}
+          });
+        }
         if (!isObject(walletInfo.wallet)) {
           return walletStandard.adaptSolanaStandardWallet(walletInfo, {
             chain: walletStandard.getSolanaChain(context.cluster),
@@ -140,6 +150,23 @@ function createSolanaPlugin(options = {}) {
         adaptedWallets.set(walletInfo.wallet, cachedAdapter);
         return cachedAdapter;
       }
+      function getDiscoveredWallets() {
+        return [
+          ...walletStandard.getRegisteredSolanaWallets(),
+          ...options.iosWallet === false ? [] : iosWallet.getSolanaIosWallets({
+            chains: [walletStandard.getSolanaChain(context.cluster)],
+            cluster: context.cluster,
+            ...options.iosWallet || {}
+          })
+        ];
+      }
+      function handleIosWalletCallback() {
+        try {
+          iosWallet.handleSolanaIosWalletCallback({ clearUrl: true });
+        } catch (cause) {
+          console.error("[Vue Solana] iOS wallet callback failed", cause);
+        }
+      }
       function* getCachedWallets() {
         for (const walletInfo of wallets.value) {
           if (isObject(walletInfo.wallet)) {
@@ -178,6 +205,9 @@ function createSolanaPlugin(options = {}) {
 function isObject(value) {
   return typeof value === "object" && value !== null || typeof value === "function";
 }
+function isSameWallet(wallet, selectedWallet) {
+  return wallet.name === selectedWallet?.name && wallet.source === selectedWallet.source && wallet.platform === selectedWallet.platform;
+}
 const VueSolana = createSolanaPlugin;
 function withTimeout(promise, timeoutMs, message) {
   let timeoutId;

package/dist/index.d.cts

@@ -7,6 +7,7 @@ export { UseTransactionOptions, useTransaction } from './useTransaction.cjs';
 export { useWallet } from './useWallet.cjs';
 export { useWallets } from './useWallets.cjs';
 export { S as SolanaConnectionStatus, V as VueSolanaContext, s as solanaInjectionKey } from './shared/vue.DGhodYJh.cjs';
+import { GetSolanaIosWalletsOptions } from '@vue-solana/core/ios-wallet';
 import { RegisterSolanaMobileWalletOptions } from '@vue-solana/core/mobile-wallet';
 import { SolanaConfig, SolanaWallet } from '@vue-solana/core/types';
 import { App } from 'vue';
@@ -15,6 +16,7 @@ import '@solana/web3-compat';
 interface VueSolanaPluginOptions extends SolanaConfig {
     wallet?: SolanaWallet | null;
     mobileWallet?: false | RegisterSolanaMobileWalletOptions;
+    iosWallet?: false | GetSolanaIosWalletsOptions;
 }
 declare function createSolanaPlugin(options?: VueSolanaPluginOptions): {
     install(app: App): void;

package/dist/index.d.mts

@@ -7,6 +7,7 @@ export { UseTransactionOptions, useTransaction } from './useTransaction.mjs';
 export { useWallet } from './useWallet.mjs';
 export { useWallets } from './useWallets.mjs';
 export { S as SolanaConnectionStatus, V as VueSolanaContext, s as solanaInjectionKey } from './shared/vue.DGhodYJh.mjs';
+import { GetSolanaIosWalletsOptions } from '@vue-solana/core/ios-wallet';
 import { RegisterSolanaMobileWalletOptions } from '@vue-solana/core/mobile-wallet';
 import { SolanaConfig, SolanaWallet } from '@vue-solana/core/types';
 import { App } from 'vue';
@@ -15,6 +16,7 @@ import '@solana/web3-compat';
 interface VueSolanaPluginOptions extends SolanaConfig {
     wallet?: SolanaWallet | null;
     mobileWallet?: false | RegisterSolanaMobileWalletOptions;
+    iosWallet?: false | GetSolanaIosWalletsOptions;
 }
 declare function createSolanaPlugin(options?: VueSolanaPluginOptions): {
     install(app: App): void;

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export { UseTransactionOptions, useTransaction } from './useTransaction.js';
 export { useWallet } from './useWallet.js';
 export { useWallets } from './useWallets.js';
 export { S as SolanaConnectionStatus, V as VueSolanaContext, s as solanaInjectionKey } from './shared/vue.DGhodYJh.js';
+import { GetSolanaIosWalletsOptions } from '@vue-solana/core/ios-wallet';
 import { RegisterSolanaMobileWalletOptions } from '@vue-solana/core/mobile-wallet';
 import { SolanaConfig, SolanaWallet } from '@vue-solana/core/types';
 import { App } from 'vue';
@@ -15,6 +16,7 @@ import '@solana/web3-compat';
 interface VueSolanaPluginOptions extends SolanaConfig {
     wallet?: SolanaWallet | null;
     mobileWallet?: false | RegisterSolanaMobileWalletOptions;
+    iosWallet?: false | GetSolanaIosWalletsOptions;
 }
 declare function createSolanaPlugin(options?: VueSolanaPluginOptions): {
     install(app: App): void;

package/dist/index.mjs

@@ -7,7 +7,8 @@ export { t as tryUseSolana, u as useSolana } from './shared/vue.1M_c5FWA.mjs';
 export { u as useTransaction } from './shared/vue.CuhLIeDx.mjs';
 export { u as useWallet } from './shared/vue.DYf_CRDv.mjs';
 export { u as useWallets } from './shared/vue.h-uS8MXN.mjs';
-import { subscribeSolanaWallets, getRegisteredSolanaWallets, adaptSolanaStandardWallet, getSolanaChain } from '@vue-solana/core/wallet-standard';
+import { isSolanaIosWalletInfo, adaptSolanaIosWallet, handleSolanaIosWalletCallback, getSolanaIosWallets } from '@vue-solana/core/ios-wallet';
+import { subscribeSolanaWallets, getSolanaChain, adaptSolanaStandardWallet, getRegisteredSolanaWallets } from '@vue-solana/core/wallet-standard';
 import { createSolanaContext } from '@vue-solana/core/rpc';
 import { shallowRef, ref, triggerRef } from 'vue';
 import '@solana/web3-compat';
@@ -65,9 +66,10 @@ function createSolanaPlugin(options = {}) {
       }
       function refreshWallets() {
         unsubscribeWallets ??= subscribeSolanaWallets(refreshWallets);
-        wallets.value = getRegisteredSolanaWallets();
+        handleIosWalletCallback();
+        wallets.value = getDiscoveredWallets();
         if (selectedWallet.value) {
-          selectedWallet.value = wallets.value.find((nextWallet) => nextWallet.name === selectedWallet.value?.name) ?? null;
+          selectedWallet.value = wallets.value.find((nextWallet) => isSameWallet(nextWallet, selectedWallet.value)) ?? null;
           if (!selectedWallet.value) {
             wallet.value = options.wallet ?? null;
           }
@@ -82,7 +84,7 @@ function createSolanaPlugin(options = {}) {
             chains: [getSolanaChain(context.cluster)],
             ...options.mobileWallet || {}
           });
-          wallets.value = getRegisteredSolanaWallets();
+          wallets.value = getDiscoveredWallets();
         }).catch((cause) => {
           console.error("[Vue Solana] Mobile wallet registration failed", cause);
         }).finally(() => {
@@ -94,6 +96,14 @@ function createSolanaPlugin(options = {}) {
         wallet.value = nextWallet ? getAdaptedWallet(nextWallet) : options.wallet ?? null;
       }
       function getAdaptedWallet(walletInfo) {
+        if (isSolanaIosWalletInfo(walletInfo)) {
+          return adaptSolanaIosWallet(walletInfo, {
+            chain: getSolanaChain(context.cluster),
+            cluster: context.cluster,
+            onChange: () => triggerRef(wallet),
+            ...options.iosWallet || {}
+          });
+        }
         if (!isObject(walletInfo.wallet)) {
           return adaptSolanaStandardWallet(walletInfo, {
             chain: getSolanaChain(context.cluster),
@@ -139,6 +149,23 @@ function createSolanaPlugin(options = {}) {
         adaptedWallets.set(walletInfo.wallet, cachedAdapter);
         return cachedAdapter;
       }
+      function getDiscoveredWallets() {
+        return [
+          ...getRegisteredSolanaWallets(),
+          ...options.iosWallet === false ? [] : getSolanaIosWallets({
+            chains: [getSolanaChain(context.cluster)],
+            cluster: context.cluster,
+            ...options.iosWallet || {}
+          })
+        ];
+      }
+      function handleIosWalletCallback() {
+        try {
+          handleSolanaIosWalletCallback({ clearUrl: true });
+        } catch (cause) {
+          console.error("[Vue Solana] iOS wallet callback failed", cause);
+        }
+      }
       function* getCachedWallets() {
         for (const walletInfo of wallets.value) {
           if (isObject(walletInfo.wallet)) {
@@ -177,6 +204,9 @@ function createSolanaPlugin(options = {}) {
 function isObject(value) {
   return typeof value === "object" && value !== null || typeof value === "function";
 }
+function isSameWallet(wallet, selectedWallet) {
+  return wallet.name === selectedWallet?.name && wallet.source === selectedWallet.source && wallet.platform === selectedWallet.platform;
+}
 const VueSolana = createSolanaPlugin;
 function withTimeout(promise, timeoutMs, message) {
   let timeoutId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vue-solana/vue",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Vue plugin and composables for Solana applications.",
   "license": "MIT",
   "keywords": [
@@ -78,7 +78,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@vue-solana/core": "0.3.2"
+    "@vue-solana/core": "0.4.0"
   },
   "peerDependencies": {
     "@solana/web3-compat": "^0.0.21",