@use-stellar/vue 0.0.0-stage → 0.2.3

package/dist/plugin-bXIRDH8_.d.ts

@@ -0,0 +1,84 @@
+import { InjectionKey, Ref, App } from 'vue';
+import { QueryStore, WalletState, QueryConfig } from 'use-stellar/core';
+
+type StellarNetwork = "testnet" | "mainnet" | "futurenet";
+interface NetworkConfig {
+    network: StellarNetwork;
+    horizonUrl: string;
+    sorobanUrl: string;
+    networkPassphrase: string;
+}
+type Asset = "XLM" | {
+    code: string;
+    issuer: string;
+};
+type Balance = {
+    asset: "XLM";
+    balance: string;
+} | {
+    asset: {
+        code: string;
+        issuer: string;
+    };
+    balance: string;
+    limit?: string;
+} | {
+    asset: "liquidity_pool_shares";
+    balance: string;
+    liquidityPoolId: string;
+};
+declare const NETWORK_CONFIGS: Record<StellarNetwork, NetworkConfig>;
+
+interface StellarPluginOptions {
+    /** Defaults to `"testnet"`. */
+    network?: StellarNetwork;
+    /** Override the built-in Horizon/Soroban endpoints for `network`. Any field left out keeps the default. */
+    networkConfig?: Partial<Pick<NetworkConfig, "horizonUrl" | "sorobanUrl" | "networkPassphrase">>;
+    /** Cache configuration shared by every composable. */
+    queryConfig?: QueryConfig;
+    /** Initial connected wallet address, primarily for restored client sessions. */
+    walletAddress?: string | null;
+}
+interface StellarRuntime {
+    network: StellarNetwork;
+    networkConfig: NetworkConfig;
+    /** One query cache per app, shared by every composable. */
+    queryStore: QueryStore;
+    /** The wallet connection the write composables sign with. */
+    wallet: WalletState;
+    /** Replaces the wallet state, and keeps `walletAddress` in step with it. */
+    setWallet: (wallet: WalletState) => void;
+    /** The address read composables default to when given none. */
+    walletAddress: Ref<string | null>;
+    setWalletAddress: (address: string | null) => void;
+}
+declare const STELLAR_RUNTIME_KEY: InjectionKey<StellarRuntime>;
+/**
+ * Builds a Stellar runtime without installing it as a plugin. Used by
+ * {@link createStellarPlugin} itself, and by the test harness in
+ * `use-stellar/vue/test-utils` to provide a runtime without a real app.
+ */
+declare function createStellarRuntime(options?: StellarPluginOptions): StellarRuntime;
+/**
+ * Vue plugin that installs the Stellar runtime — resolved network config plus
+ * one shared query cache — so every composable in this package reads and
+ * writes through the same instance.
+ *
+ * @example
+ * import { createApp } from "vue"
+ * import { createStellarPlugin } from "@use-stellar/vue"
+ *
+ * createApp(App).use(createStellarPlugin({ network: "testnet" })).mount("#app")
+ */
+declare function createStellarPlugin(options?: StellarPluginOptions): {
+    install(app: App): void;
+};
+/**
+ * Reads the installed Stellar runtime.
+ *
+ * @throws {Error} when called outside a component tree the plugin was
+ * installed on (or outside `app.runWithContext()` in tests).
+ */
+declare function useStellarRuntime(): StellarRuntime;
+
+export { type Asset as A, type Balance as B, NETWORK_CONFIGS as N, STELLAR_RUNTIME_KEY as S, type NetworkConfig as a, type StellarNetwork as b, type StellarPluginOptions as c, type StellarRuntime as d, createStellarPlugin as e, createStellarRuntime as f, useStellarRuntime as u };

package/dist/test-utils.d.mts

@@ -0,0 +1,27 @@
+import { App } from 'vue';
+import { d as StellarRuntime, c as StellarPluginOptions } from './plugin-bXIRDH8_.mjs';
+import 'use-stellar/core';
+
+interface StellarTestHarness {
+    app: App;
+    /** The exact runtime instance provided to the app — same `QueryStore` every composable in `run()` reads through. */
+    runtime: StellarRuntime;
+    /** Runs `fn` with the runtime available to `inject()` / composables, inside a disposable effect scope. */
+    run: <T>(fn: () => T) => T;
+    /** Stops the effect scope, tearing down every watcher/computed created via `run()`. Call in `afterEach`. */
+    dispose: () => void;
+}
+/**
+ * Mounts a throwaway Vue app with the Stellar plugin installed, for testing
+ * composables that call `useStellarRuntime()` — directly, or through
+ * `useBalance` and friends — with no real component tree.
+ *
+ * @example
+ * const harness = createStellarTestHarness({ network: "testnet" })
+ * const { balance } = harness.run(() => useBalance({ address: "GABC..." }))
+ * // ...assert...
+ * harness.dispose()
+ */
+declare function createStellarTestHarness(options?: StellarPluginOptions): StellarTestHarness;
+
+export { type StellarTestHarness, createStellarTestHarness };

package/dist/test-utils.d.ts

@@ -0,0 +1,27 @@
+import { App } from 'vue';
+import { d as StellarRuntime, c as StellarPluginOptions } from './plugin-bXIRDH8_.js';
+import 'use-stellar/core';
+
+interface StellarTestHarness {
+    app: App;
+    /** The exact runtime instance provided to the app — same `QueryStore` every composable in `run()` reads through. */
+    runtime: StellarRuntime;
+    /** Runs `fn` with the runtime available to `inject()` / composables, inside a disposable effect scope. */
+    run: <T>(fn: () => T) => T;
+    /** Stops the effect scope, tearing down every watcher/computed created via `run()`. Call in `afterEach`. */
+    dispose: () => void;
+}
+/**
+ * Mounts a throwaway Vue app with the Stellar plugin installed, for testing
+ * composables that call `useStellarRuntime()` — directly, or through
+ * `useBalance` and friends — with no real component tree.
+ *
+ * @example
+ * const harness = createStellarTestHarness({ network: "testnet" })
+ * const { balance } = harness.run(() => useBalance({ address: "GABC..." }))
+ * // ...assert...
+ * harness.dispose()
+ */
+declare function createStellarTestHarness(options?: StellarPluginOptions): StellarTestHarness;
+
+export { type StellarTestHarness, createStellarTestHarness };

package/dist/test-utils.js

@@ -0,0 +1,97 @@
+'use strict';
+
+var vue = require('vue');
+var core = require('use-stellar/core');
+
+// src/test-utils.ts
+
+// src/types.ts
+var NETWORK_PASSPHRASES = {
+  testnet: "Test SDF Network ; September 2015",
+  mainnet: "Public Global Stellar Network ; September 2015",
+  futurenet: "Test SDF Future Network ; October 2022"
+};
+var NETWORK_CONFIGS = {
+  testnet: {
+    network: "testnet",
+    horizonUrl: "https://horizon-testnet.stellar.org",
+    sorobanUrl: "https://soroban-testnet.stellar.org",
+    networkPassphrase: NETWORK_PASSPHRASES.testnet
+  },
+  mainnet: {
+    network: "mainnet",
+    horizonUrl: "https://horizon.stellar.org",
+    sorobanUrl: "https://soroban.stellar.org",
+    networkPassphrase: NETWORK_PASSPHRASES.mainnet
+  },
+  futurenet: {
+    network: "futurenet",
+    horizonUrl: "https://horizon-futurenet.stellar.org",
+    sorobanUrl: "https://rpc-futurenet.stellar.org",
+    networkPassphrase: NETWORK_PASSPHRASES.futurenet
+  }
+};
+
+// src/plugin.ts
+var STELLAR_RUNTIME_KEY = /* @__PURE__ */ Symbol("use-stellar/vue:runtime");
+var DISCONNECTED_WALLET = {
+  connected: false,
+  connecting: false,
+  address: null,
+  network: null,
+  wallet: null,
+  walletName: null,
+  error: null,
+  walletNetwork: null,
+  walletNetworkPassphrase: null
+};
+function resolveNetworkConfig(network, override) {
+  const builtIn = NETWORK_CONFIGS[network];
+  if (!override) return builtIn;
+  return {
+    network,
+    horizonUrl: override.horizonUrl ?? builtIn.horizonUrl,
+    sorobanUrl: override.sorobanUrl ?? builtIn.sorobanUrl,
+    networkPassphrase: override.networkPassphrase ?? builtIn.networkPassphrase
+  };
+}
+function createStellarRuntime(options = {}) {
+  const network = options.network ?? "testnet";
+  const walletAddress = vue.shallowRef(options.walletAddress ?? null);
+  const runtime = {
+    network,
+    networkConfig: resolveNetworkConfig(network, options.networkConfig),
+    queryStore: new core.QueryStore(options.queryConfig),
+    wallet: { ...DISCONNECTED_WALLET, address: options.walletAddress ?? null },
+    setWallet(wallet) {
+      runtime.wallet = wallet;
+      walletAddress.value = wallet.address;
+    },
+    walletAddress,
+    setWalletAddress(address) {
+      walletAddress.value = address;
+    }
+  };
+  return runtime;
+}
+
+// src/test-utils.ts
+function createStellarTestHarness(options = {}) {
+  const runtime = createStellarRuntime(options);
+  const app = vue.createApp({});
+  app.provide(STELLAR_RUNTIME_KEY, runtime);
+  const scope = vue.effectScope();
+  function run(fn) {
+    return scope.run(() => app.runWithContext(fn));
+  }
+  return {
+    app,
+    runtime,
+    run,
+    dispose: () => scope.stop()
+  };
+}
+
+exports.createStellarTestHarness = createStellarTestHarness;
+//# sourceMappingURL=test-utils.js.map
+//# sourceMappingURL=test-utils.js.map

package/dist/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/plugin.ts","../src/test-utils.ts"],"names":["shallowRef","QueryStore","createApp","effectScope"],"mappings":"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","file":"test-utils.js","sourcesContent":["// packages/vue/src/types.ts\n//\n// A small, self-contained type set for the Vue adapter. Deliberately not\n// imported from the `use-stellar` (React) package: that package declares\n// `react` as a required peer dependency, and pulling any part of it in here\n// would put a React peer-dependency warning in front of every Vue user who\n// installs this package — the exact installation friction `rn-03` fixed for\n// React Native. Custom networks aren't supported yet; only the three SDF\n// defaults are.\n\nexport type StellarNetwork = \"testnet\" | \"mainnet\" | \"futurenet\"\n\nexport interface NetworkConfig {\n  network: StellarNetwork\n  horizonUrl: string\n  sorobanUrl: string\n  networkPassphrase: string\n}\n\nexport type Asset = \"XLM\" | { code: string; issuer: string }\n\nexport type Balance =\n  | { asset: \"XLM\"; balance: string }\n  | { asset: { code: string; issuer: string }; balance: string; limit?: string }\n  | { asset: \"liquidity_pool_shares\"; balance: string; liquidityPoolId: string }\n\nconst NETWORK_PASSPHRASES: Record<StellarNetwork, string> = {\n  testnet: \"Test SDF Network ; September 2015\",\n  mainnet: \"Public Global Stellar Network ; September 2015\",\n  futurenet: \"Test SDF Future Network ; October 2022\",\n}\n\nexport const NETWORK_CONFIGS: Record<StellarNetwork, NetworkConfig> = {\n  testnet: {\n    network: \"testnet\",\n    horizonUrl: \"https://horizon-testnet.stellar.org\",\n    sorobanUrl: \"https://soroban-testnet.stellar.org\",\n    networkPassphrase: NETWORK_PASSPHRASES.testnet,\n  },\n  mainnet: {\n    network: \"mainnet\",\n    horizonUrl: \"https://horizon.stellar.org\",\n    sorobanUrl: \"https://soroban.stellar.org\",\n    networkPassphrase: NETWORK_PASSPHRASES.mainnet,\n  },\n  futurenet: {\n    network: \"futurenet\",\n    horizonUrl: \"https://horizon-futurenet.stellar.org\",\n    sorobanUrl: \"https://rpc-futurenet.stellar.org\",\n    networkPassphrase: NETWORK_PASSPHRASES.futurenet,\n  },\n}\n","// packages/vue/src/plugin.ts\n\nimport { inject, shallowRef, type App, type InjectionKey, type Ref } from \"vue\"\nimport {\n  QueryStore,\n  getWalletAdapter,\n  readWalletSession,\n  type QueryConfig,\n  type WalletState,\n} from \"use-stellar/core\"\nimport { NETWORK_CONFIGS, type NetworkConfig, type StellarNetwork } from \"./types\"\n\nexport interface StellarPluginOptions {\n  /** Defaults to `\"testnet\"`. */\n  network?: StellarNetwork\n  /** Override the built-in Horizon/Soroban endpoints for `network`. Any field left out keeps the default. */\n  networkConfig?: Partial<Pick<NetworkConfig, \"horizonUrl\" | \"sorobanUrl\" | \"networkPassphrase\">>\n  /** Cache configuration shared by every composable. */\n  queryConfig?: QueryConfig\n  /** Initial connected wallet address, primarily for restored client sessions. */\n  walletAddress?: string | null\n}\n\nexport interface StellarRuntime {\n  network: StellarNetwork\n  networkConfig: NetworkConfig\n  /** One query cache per app, shared by every composable. */\n  queryStore: QueryStore\n  /** The wallet connection the write composables sign with. */\n  wallet: WalletState\n  /** Replaces the wallet state, and keeps `walletAddress` in step with it. */\n  setWallet: (wallet: WalletState) => void\n  /** The address read composables default to when given none. */\n  walletAddress: Ref<string | null>\n  setWalletAddress: (address: string | null) => void\n}\n\nexport const STELLAR_RUNTIME_KEY: InjectionKey<StellarRuntime> = Symbol(\"use-stellar/vue:runtime\")\n\nconst DISCONNECTED_WALLET: WalletState = {\n  connected: false,\n  connecting: false,\n  address: null,\n  network: null,\n  wallet: null,\n  walletName: null,\n  error: null,\n  walletNetwork: null,\n  walletNetworkPassphrase: null,\n}\n\nfunction resolveNetworkConfig(\n  network: StellarNetwork,\n  override: StellarPluginOptions[\"networkConfig\"]\n): NetworkConfig {\n  const builtIn = NETWORK_CONFIGS[network]\n  if (!override) return builtIn\n\n  return {\n    network,\n    horizonUrl: override.horizonUrl ?? builtIn.horizonUrl,\n    sorobanUrl: override.sorobanUrl ?? builtIn.sorobanUrl,\n    networkPassphrase: override.networkPassphrase ?? builtIn.networkPassphrase,\n  }\n}\n\n/**\n * Builds a Stellar runtime without installing it as a plugin. Used by\n * {@link createStellarPlugin} itself, and by the test harness in\n * `use-stellar/vue/test-utils` to provide a runtime without a real app.\n */\nexport function createStellarRuntime(options: StellarPluginOptions = {}): StellarRuntime {\n  const network = options.network ?? \"testnet\"\n  const walletAddress = shallowRef(options.walletAddress ?? null)\n\n  const runtime: StellarRuntime = {\n    network,\n    networkConfig: resolveNetworkConfig(network, options.networkConfig),\n    queryStore: new QueryStore(options.queryConfig),\n    wallet: { ...DISCONNECTED_WALLET, address: options.walletAddress ?? null },\n    setWallet(wallet): void {\n      runtime.wallet = wallet\n      walletAddress.value = wallet.address\n    },\n    walletAddress,\n    setWalletAddress(address: string | null): void {\n      walletAddress.value = address\n    },\n  }\n  return runtime\n}\n\n/** Restores a persisted wallet without ever prompting during server rendering. */\nexport async function restoreWalletSession(\n  runtime: StellarRuntime,\n  storage: \"local\" | \"session\" = \"local\"\n): Promise<void> {\n  const session = await readWalletSession(storage)\n  if (!session) return\n\n  try {\n    const adapter = getWalletAdapter(session.wallet)\n    const available = await adapter.isAvailable()\n    if (!available) return\n\n    const canReconnect = adapter.canAutoConnect\n      ? await adapter.canAutoConnect(runtime.network)\n      : false\n    if (!canReconnect) {\n      runtime.setWallet({\n        ...runtime.wallet,\n        wallet: session.wallet,\n        walletName: adapter.metadata.name,\n        address: session.address ?? null,\n      })\n      return\n    }\n\n    const connection = await adapter.connect(runtime.network)\n    const network = await adapter.getNetworkDetails(runtime.network)\n    runtime.setWallet({\n      connected: true,\n      connecting: false,\n      address: connection.address,\n      network: runtime.network,\n      wallet: connection.wallet,\n      walletName: adapter.metadata.name,\n      error: null,\n      walletNetwork: network.network,\n      walletNetworkPassphrase: network.networkPassphrase,\n    })\n  } catch {\n    // Session restoration is best-effort; a normal disconnected app remains usable.\n  }\n}\n\n/**\n * Vue plugin that installs the Stellar runtime — resolved network config plus\n * one shared query cache — so every composable in this package reads and\n * writes through the same instance.\n *\n * @example\n * import { createApp } from \"vue\"\n * import { createStellarPlugin } from \"@use-stellar/vue\"\n *\n * createApp(App).use(createStellarPlugin({ network: \"testnet\" })).mount(\"#app\")\n */\nexport function createStellarPlugin(options: StellarPluginOptions = {}) {\n  return {\n    install(app: App): void {\n      app.provide(STELLAR_RUNTIME_KEY, createStellarRuntime(options))\n    },\n  }\n}\n\n/**\n * Reads the installed Stellar runtime.\n *\n * @throws {Error} when called outside a component tree the plugin was\n * installed on (or outside `app.runWithContext()` in tests).\n */\nexport function useStellarRuntime(): StellarRuntime {\n  const runtime = inject(STELLAR_RUNTIME_KEY)\n  if (!runtime) {\n    throw new Error(\n      \"@use-stellar/vue: no plugin installed. Call \" +\n        \"app.use(createStellarPlugin()) before using any composable.\"\n    )\n  }\n  return runtime\n}\n","// packages/vue/src/test-utils.ts\n//\n// A reusable harness for testing this package's composables without a real\n// component tree: no DOM, no @vue/test-utils, no mounted app.\n//\n// Two Vue primitives make this possible together:\n//  - `app.runWithContext(fn)` (Vue 3.3+) lets `inject()` resolve against the\n//    app's provided values from outside a component's `setup()`.\n//  - `effectScope()` gives every `watchEffect`/`computed` a lifecycle to\n//    belong to, so `dispose()` actually tears them down — `runWithContext`\n//    alone does not do this, since it only sets the injection context.\n//\n// Exported from a separate `@use-stellar/vue/test-utils` entry point so\n// `effectScope`/`createApp` test scaffolding never ends up in a consumer's\n// production bundle just because they imported the main package.\n\nimport { createApp, effectScope, type App, type EffectScope } from \"vue\"\nimport { STELLAR_RUNTIME_KEY, createStellarRuntime } from \"./plugin\"\nimport type { StellarPluginOptions, StellarRuntime } from \"./plugin\"\n\nexport interface StellarTestHarness {\n  app: App\n  /** The exact runtime instance provided to the app — same `QueryStore` every composable in `run()` reads through. */\n  runtime: StellarRuntime\n  /** Runs `fn` with the runtime available to `inject()` / composables, inside a disposable effect scope. */\n  run: <T>(fn: () => T) => T\n  /** Stops the effect scope, tearing down every watcher/computed created via `run()`. Call in `afterEach`. */\n  dispose: () => void\n}\n\n/**\n * Mounts a throwaway Vue app with the Stellar plugin installed, for testing\n * composables that call `useStellarRuntime()` — directly, or through\n * `useBalance` and friends — with no real component tree.\n *\n * @example\n * const harness = createStellarTestHarness({ network: \"testnet\" })\n * const { balance } = harness.run(() => useBalance({ address: \"GABC...\" }))\n * // ...assert...\n * harness.dispose()\n */\nexport function createStellarTestHarness(options: StellarPluginOptions = {}): StellarTestHarness {\n  const runtime = createStellarRuntime(options)\n  const app = createApp({})\n  app.provide(STELLAR_RUNTIME_KEY, runtime)\n\n  const scope: EffectScope = effectScope()\n\n  function run<T>(fn: () => T): T {\n    return scope.run(() => app.runWithContext(fn)) as T\n  }\n\n  return {\n    app,\n    runtime,\n    run,\n    dispose: () => scope.stop(),\n  }\n}\n"]}

package/dist/test-utils.mjs

@@ -0,0 +1,22 @@
+import { createStellarRuntime, STELLAR_RUNTIME_KEY } from './chunk-7ROX7ZPL.mjs';
+import { createApp, effectScope } from 'vue';
+
+function createStellarTestHarness(options = {}) {
+  const runtime = createStellarRuntime(options);
+  const app = createApp({});
+  app.provide(STELLAR_RUNTIME_KEY, runtime);
+  const scope = effectScope();
+  function run(fn) {
+    return scope.run(() => app.runWithContext(fn));
+  }
+  return {
+    app,
+    runtime,
+    run,
+    dispose: () => scope.stop()
+  };
+}
+
+export { createStellarTestHarness };
+//# sourceMappingURL=test-utils.mjs.map
+//# sourceMappingURL=test-utils.mjs.map

package/dist/test-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/test-utils.ts"],"names":[],"mappings":";;;AAyCO,SAAS,wBAAA,CAAyB,OAAA,GAAgC,EAAC,EAAuB;AAC/F,EAAA,MAAM,OAAA,GAAU,qBAAqB,OAAO,CAAA;AAC5C,EAAA,MAAM,GAAA,GAAM,SAAA,CAAU,EAAE,CAAA;AACxB,EAAA,GAAA,CAAI,OAAA,CAAQ,qBAAqB,OAAO,CAAA;AAExC,EAAA,MAAM,QAAqB,WAAA,EAAY;AAEvC,EAAA,SAAS,IAAO,EAAA,EAAgB;AAC9B,IAAA,OAAO,MAAM,GAAA,CAAI,MAAM,GAAA,CAAI,cAAA,CAAe,EAAE,CAAC,CAAA;AAAA,EAC/C;AAEA,EAAA,OAAO;AAAA,IACL,GAAA;AAAA,IACA,OAAA;AAAA,IACA,GAAA;AAAA,IACA,OAAA,EAAS,MAAM,KAAA,CAAM,IAAA;AAAK,GAC5B;AACF","file":"test-utils.mjs","sourcesContent":["// packages/vue/src/test-utils.ts\n//\n// A reusable harness for testing this package's composables without a real\n// component tree: no DOM, no @vue/test-utils, no mounted app.\n//\n// Two Vue primitives make this possible together:\n//  - `app.runWithContext(fn)` (Vue 3.3+) lets `inject()` resolve against the\n//    app's provided values from outside a component's `setup()`.\n//  - `effectScope()` gives every `watchEffect`/`computed` a lifecycle to\n//    belong to, so `dispose()` actually tears them down — `runWithContext`\n//    alone does not do this, since it only sets the injection context.\n//\n// Exported from a separate `@use-stellar/vue/test-utils` entry point so\n// `effectScope`/`createApp` test scaffolding never ends up in a consumer's\n// production bundle just because they imported the main package.\n\nimport { createApp, effectScope, type App, type EffectScope } from \"vue\"\nimport { STELLAR_RUNTIME_KEY, createStellarRuntime } from \"./plugin\"\nimport type { StellarPluginOptions, StellarRuntime } from \"./plugin\"\n\nexport interface StellarTestHarness {\n  app: App\n  /** The exact runtime instance provided to the app — same `QueryStore` every composable in `run()` reads through. */\n  runtime: StellarRuntime\n  /** Runs `fn` with the runtime available to `inject()` / composables, inside a disposable effect scope. */\n  run: <T>(fn: () => T) => T\n  /** Stops the effect scope, tearing down every watcher/computed created via `run()`. Call in `afterEach`. */\n  dispose: () => void\n}\n\n/**\n * Mounts a throwaway Vue app with the Stellar plugin installed, for testing\n * composables that call `useStellarRuntime()` — directly, or through\n * `useBalance` and friends — with no real component tree.\n *\n * @example\n * const harness = createStellarTestHarness({ network: \"testnet\" })\n * const { balance } = harness.run(() => useBalance({ address: \"GABC...\" }))\n * // ...assert...\n * harness.dispose()\n */\nexport function createStellarTestHarness(options: StellarPluginOptions = {}): StellarTestHarness {\n  const runtime = createStellarRuntime(options)\n  const app = createApp({})\n  app.provide(STELLAR_RUNTIME_KEY, runtime)\n\n  const scope: EffectScope = effectScope()\n\n  function run<T>(fn: () => T): T {\n    return scope.run(() => app.runWithContext(fn)) as T\n  }\n\n  return {\n    app,\n    runtime,\n    run,\n    dispose: () => scope.stop(),\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,135 @@
 {
   "name": "@use-stellar/vue",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.3",
+  "description": "Vue 3 composables for the Stellar network, built on use-stellar",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RaceeyXo/use-stellar.git",
+    "directory": "packages/vue"
+  },
+  "homepage": "https://github.com/RaceeyXo/use-stellar/tree/main/packages/vue#readme",
+  "bugs": {
+    "url": "https://github.com/RaceeyXo/use-stellar/issues"
+  },
+  "license": "Apache-2.0",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./test-utils": {
+      "import": {
+        "types": "./dist/test-utils.d.mts",
+        "default": "./dist/test-utils.mjs"
+      },
+      "require": {
+        "types": "./dist/test-utils.d.ts",
+        "default": "./dist/test-utils.js"
+      }
+    },
+    "./nuxt": {
+      "import": {
+        "types": "./dist/nuxt/module.d.mts",
+        "default": "./dist/nuxt/module.mjs"
+      },
+      "require": {
+        "types": "./dist/nuxt/module.d.ts",
+        "default": "./dist/nuxt/module.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@stellar/stellar-sdk": "^12.0.0"
+  },
+  "peerDependencies": {
+    "@nuxt/kit": "^3.0.0 || ^4.0.0",
+    "vue": "^3.3.0",
+    "use-stellar": "^0.2.3"
+  },
+  "peerDependenciesMeta": {
+    "@nuxt/kit": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@nuxt/kit": "^4.6.2",
+    "@size-limit/esbuild": "12.1.0",
+    "@size-limit/esbuild-why": "12.1.0",
+    "@size-limit/preset-small-lib": "^12.1.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@vue/server-renderer": "^3.5.0",
+    "jest": "^29.0.0",
+    "jest-environment-jsdom": "^29.0.0",
+    "size-limit": "^12.1.0",
+    "ts-jest": "^29.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.3",
+    "vue": "^3.5.0",
+    "use-stellar": "0.2.3"
+  },
+  "size-limit": [
+    {
+      "name": "Vue CommonJS bundle",
+      "path": "dist/index.js",
+      "limit": "15 kB",
+      "ignore": [
+        "@stellar/stellar-sdk",
+        "vue",
+        "use-stellar"
+      ]
+    },
+    {
+      "name": "Vue ES module bundle",
+      "path": "dist/index.mjs",
+      "limit": "11 kB",
+      "ignore": [
+        "@stellar/stellar-sdk",
+        "vue",
+        "use-stellar"
+      ]
+    }
+  ],
+  "keywords": [
+    "stellar",
+    "soroban",
+    "vue",
+    "vue3",
+    "nuxt",
+    "composables",
+    "blockchain",
+    "web3",
+    "xlm",
+    "usdc"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:package": "node scripts/smoke-test.js",
+    "typecheck": "tsc --noEmit",
+    "size": "size-limit",
+    "size:why": "size-limit --why"
+  }
 }