vapor-chamber 1.28.0 → 1.29.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file.
 
+## v1.29.0 - 2026-10-08
+
+- Added the root's whole surface to `vapor-chamber/vue` and `vapor-chamber/vapor`: the bus, plugins, transports and the HTTP client. A Vue app now imports from one entry, `import { createCommandBus, useCommand } from 'vapor-chamber/vue'`. They are the root's own functions, so code that imports the bus from the root is unchanged and shares the same bus.
+- Fixed a bundle that inlines Vue and runs in Node, such as a Vite SSR build with `ssr.noExternal`. The root's runtime lookup loaded a second Vue and replaced what `vapor-chamber/vue` wired at build time. Composables lost reactivity and cleanup, and `untracked()` went back to tracking. Composables on a bundled page with an import map for `vue` hit the same. The lookup now wires only the Vue the app already has, and keeps what `vapor-chamber/vue` wired.
+- Fixed the README's elements IIFE example, which registered no widget: it now hands Vue over with `configureVue` first. The README names one entry per kind of app, and says that `untracked()` cannot suspend tracking on a page with no build step.
+- Fixed the store guide on ordering a store's answers with `serialize`. Its default key is the action, so two different actions of one store were both in flight. One lane per store, keyed to the commands that reach the server, now orders the store's writes and its reads. The guide and `serialize`'s docblock say to key the store's local reducers to `null`: in the lane, a read that awaits one waits for ever. They also say that a command waiting in the lane already reads as loading in `isLoading()`.
+- Vue 3.5 is now tested on every run. Every entry that uses Vue loads and works on it, except `vapor-chamber/vapor`, `vapor-chamber/transitions/vapor` and `vapor-chamber/router/vapor`, which need Vue 3.6.
+- Fixed `useSharedCommandState().dispatch` throwing when a subscriber of `inFlight` or `isAnyLoading` throws. `isAnyLoading` then stayed true for every reader. The dispatch now fails with that error and the count returns to 0, as `useCommand`'s does.
+- Changed `dispatch` and `query` of `useCommand`, `useCommandQuery`, `useCommandGroup`, `useSharedCommandState` and `defineVaporCommand` to be typed by the bus they run on. A sync bus gives a `CommandResult`, an async one a promise of it, and the shared bus a `CommandResult`. A cast or a narrowing written for the old types can go. On an async bus, `useCommand`'s `dispatch` now returns a promise even when a subscriber throws.
+- Added `bus` to the options of `useCommand`, `useCommandState`, `useCommandHistory`, `useCommandQuery`, `useCommandGroup`, `useCommandError`, `defineVaporCommand` and `useDeepCommandState`. Each runs on the bus it is given, sync or async. A concurrent SSR server can now pass a bus per request, as `setCommandBus` advises. Without it they use the shared bus, as before. `useSharedCommandState` now accepts an async bus too.
+- Fixed the retry example, which stated the rule from before 1.27. Fixed the README row for `isLoading()`, which left out when counting starts and stops.
+- Fixed three docs. The SSR examples set the shared bus per request, which their own warning calls unsafe: they now give each request its own bus. `src/signal.ts` and the whitepaper now say what a read of `__VUE__` finds. The whitepaper's script-tag recipe loaded the core IIFE, which never reads the parked Vue: it now loads the full IIFE.
+- Fixed the examples to match this release. The Vue examples import from `vapor-chamber/vue` alone, and drop an `instanceof Promise` check on a dispatch result. Two retry comments now state the current rule. `feature-vite-wire.ts` says a root-only app needs the plugin on Vite.
+
 ## v1.28.0 - 2026-10-07
 
 - Fixed `createRouter()` throwing a TypeError on a route row whose `params` is `null`. The row now compiles as one without param types.

package/README.md

@@ -43,7 +43,7 @@ so each action has one place to read and to test.
 - **Vue <!-- vc:vueAligned -->3.6.0-rc.10<!-- /vc:vueAligned --> aligned**: signals, `onScopeDispose`, `getCurrentScope`, alien-signals internals. Tracked per release in the [CHANGELOG](CHANGELOG.md)
 - **No runtime dependency**. `alien-signals` is an optional peer, installed only by apps that use the `vapor-chamber/alien-signals` connector. Unimported modules tree-shake to zero
 - **ESM-only**, plus three IIFE `<script>` drop-ins for no-bundler pages
-- **<!-- vc:covStatements -->100.0<!-- /vc:covStatements -->% coverage on all four axes** - statements, branches, functions and lines, across **<!-- vc:tests -->3498<!-- /vc:tests --> tests** in <!-- vc:testFiles -->316<!-- /vc:testFiles --> files ([full table](docs/COVERAGE.md)). Every branch in the measured surface is taken by a test
+- **<!-- vc:covStatements -->100.0<!-- /vc:covStatements -->% coverage on all four axes** - statements, branches, functions and lines, across **<!-- vc:tests -->3572<!-- /vc:tests --> tests** in <!-- vc:testFiles -->326<!-- /vc:testFiles --> files ([full table](docs/COVERAGE.md)). Every branch in the measured surface is taken by a test
 
 ## Contents
 
@@ -156,20 +156,23 @@ A misspelled action or field in a component is a compile error, before any reque
 </details>
 
 <details>
-<summary><b>Gotcha:</b> in a Vue app, import the composables from <code>vapor-chamber/vue</code>, not the root</summary>
+<summary><b>Gotcha:</b> in a Vue app, import from <code>vapor-chamber/vue</code>, not the root</summary>
 
-Import the composables (`useCommand`, `useCommandState`, `signal`, ...) from the static entry,
-`vapor-chamber/vue` (or `vapor-chamber/vapor` in a Vapor app). Import the bus (`createCommandBus`,
-`getCommandBus`, plugins, transports) from the root. The static entry hands Vue to the library at
-build time, the moment it is imported, so even module-scope state is reactive:
+Import from the static entry, `vapor-chamber/vue` (or `vapor-chamber/vapor` when the app calls the
+library's Vapor API, such as `createVaporChamberApp`). It
+carries the composables (`useCommand`, `useCommandState`, `signal`, ...) and the root's whole
+surface: the bus, plugins, transports. The static entry hands Vue to the library at build time, the
+moment it is imported, so even module-scope state is reactive:
 
 ```ts
-import { createCommandBus, setCommandBus } from 'vapor-chamber';   // the bus: no Vue needed
-import { useCommand, signal } from 'vapor-chamber/vue';           // composables: Vue wired
+import { createCommandBus, setCommandBus, useCommand, signal } from 'vapor-chamber/vue';
 
 export const count = signal(0);   // reactive, no waiting
 ```
 
+They are the root's own functions, so code that still takes the bus from the root shares the same
+bus.
+
 The root has to work with no Vue in the tree, so it can only look for Vue at runtime. It does so
 through a bare `import('vue')` that resolves under a dev server and **fails in a production
 bundle**. There, composables imported from the root get plain `{ value }` state (no reactivity),
@@ -1101,8 +1104,7 @@ re-run. Every composable here suspends reactive tracking around its bus call. If
 **raw bus** inside an effect, wrap it:
 
 ```ts
-import { getCommandBus } from 'vapor-chamber';     // the bus comes from the root
-import { untracked } from 'vapor-chamber/vue';      // untracked() from the Vue entry
+import { getCommandBus, untracked } from 'vapor-chamber/vue';
 
 watchEffect(() => {
   // without untracked(), anything the HANDLER reads becomes a dependency of
@@ -1111,11 +1113,27 @@ watchEffect(() => {
 });
 ```
 
+On a page with no build step (a `<script>` tag or an import map), `untracked()` cannot suspend
+tracking: Vue's browser builds do not export what it needs. See
+[whitepaper 9.6](docs/whitepaper.md#96-blade--cdn-zero-build).
+
 </details>
 
 <details>
 <summary><b>Which entry to import from</b> - <code>/vapor</code>, <code>/vue</code>, or the package root, and what each one wires</summary>
 
+One entry per kind of app, measured on built apps of each kind (log s35.231). `/vue` and `/vapor`
+carry the bus too.
+
+| App | Import from | Build step |
+|---|---|---|
+| App that calls the library's Vapor API (`createVaporChamberApp`, `defineVaporComponent`, `defineVaporAsyncComponent`, `defineVaporCustomElement`, `getVaporInteropPlugin`) | `vapor-chamber/vapor` | Optional, drops the runtime lookup: `vaporChamberWire({ entry: 'vapor' })` on Vite, the define below elsewhere |
+| Any other Vue app, vDOM or Vapor, including one that uses only Vue's own Vapor APIs or `vapor-chamber/router/vapor` | `vapor-chamber/vue` | Optional, the same: `vaporChamberWire()` on Vite, the define elsewhere |
+| Server build (SSR) | `vapor-chamber/vue` | Optional: the define drops the runtime lookup from the server bundle |
+| App that imports only the root | the root | Needed on Vite: `vaporChamberWire()`. Other bundlers have none, so import from a subpath |
+| `<script>`-tag page | `VaporChamber.configureVue(Vue)` | None. `untracked()` is not available |
+| ESM page with an import map | `configureVue(Vue)` | None. `untracked()` cannot suspend tracking |
+
 **Import from `vapor-chamber/vue` in a Vue app.** The Gotcha above says why. The root can only
 look for Vue at runtime, and that lookup fails in a production bundle. So `untracked()` silently
 becomes a pass-through there. The static entry resolves Vue at build time, and re-exports the
@@ -1128,7 +1146,8 @@ in a page where DEV is on. That is a page served by Vite's dev server (measured
 on Vite 8), or a test runner with a DOM. A production build drops it, from every chunk. A server never
 shows it: Node resolves that lookup in production too (measured), so the advice would be wrong there.
 
-**On Vue 3.6 with Vapor, import from `vapor-chamber/vapor` instead.** It is a superset of
+**When the app calls the library's Vapor API, import from `vapor-chamber/vapor` instead.** It needs
+Vue 3.6. It is a superset of
 `vapor-chamber/vue`, with the same composables and the same tracking fix. It also wires Vue's
 Vapor APIs statically. So there is no `configureVue()` call to write and no runtime probe to
 depend on:
@@ -1173,12 +1192,12 @@ import vue from '@vitejs/plugin-vue';
 import { vaporChamberWire } from 'vapor-chamber/vite';
 
 export default defineConfig({
-  plugins: [vue(), vaporChamberWire()], // { entry: 'vapor' } when the app compiles <script setup vapor>
+  plugins: [vue(), vaporChamberWire()], // { entry: 'vapor' } when the app calls the library's Vapor API
 });
 ```
 
-`'vapor'` is your call, not a guess. It wires the Vapor runtime into the bundle, which a vDOM-only
-3.6 app should not pay for.
+`'vapor'` is your call, not a guess. It wires Vue's Vapor app and component helpers into the bundle,
+which an app that does not call the library's Vapor API should not pay for.
 
 The redirect runs in builds only. The dev server resolves the runtime lookup by itself. A
 redirect there, over a pre-bundled install, would put two copies of the library in the page
@@ -1204,8 +1223,13 @@ new webpack.DefinePlugin({ __VC_WIRED_BUILD__: 'true' })
 Leave it out only for an app that imports the composables from the root and wires nothing: there
 the lookup is what finds Vue (`tests/root-probe-builds.test.ts`).
 
-The bus itself (`createCommandBus`, `getCommandBus`, plugins, transports) still comes from the
-package root. It works with no Vue in the tree, so it is not part of a Vue-wiring entry.
+A Vite app that imports from the subpath, with neither `vaporChamberWire()` nor the define, still
+ships the lookup as dead code: +2,589 B raw, +932 B brotli on a vDOM app (measured 2026-10-08, log
+s35.231). Either one removes it.
+
+Both entries also carry the bus itself (`createCommandBus`, `getCommandBus`, plugins, transports),
+so a Vue app imports one entry. An app with no Vue imports the bus from the package root, which
+works with no Vue in the tree.
 
 </details>
 
@@ -1333,7 +1357,7 @@ Minified, comment-free, brotli q=11. Always-current per-export table:
 on any regression past budget.
 
 The two that matter: the dispatch core is **<!-- vc:sizeCore -->4.7<!-- /vc:sizeCore --> KB** and the import-everything barrel is
-<!-- vc:sizeBarrel -->32.2<!-- /vc:sizeBarrel --> KB. The main entries, and why the numbers are
+<!-- vc:sizeBarrel -->32.3<!-- /vc:sizeBarrel --> KB. The main entries, and why the numbers are
 machine-stamped rather than retyped:
 
 <details>
@@ -1342,14 +1366,14 @@ machine-stamped rather than retyped:
 | Entry | brotli |
 |---|--:|
 | dispatch core (`createCommandBus`, tree-shaken) | **<!-- vc:sizeCore -->4.7<!-- /vc:sizeCore --> KB** |
-| `vapor-chamber` (main barrel, import-*everything*) | <!-- vc:sizeBarrel -->32.2<!-- /vc:sizeBarrel --> KB |
+| `vapor-chamber` (main barrel, import-*everything*) | <!-- vc:sizeBarrel -->32.3<!-- /vc:sizeBarrel --> KB |
 | `vapor-chamber/router` | <!-- vc:sizeRouter -->10.6<!-- /vc:sizeRouter --> KB |
 | `vapor-chamber/router/vdom` | <!-- vc:sizeRouterVdom -->0.7<!-- /vc:sizeRouterVdom --> KB |
 | `vapor-chamber/router/vapor` | <!-- vc:sizeRouterVapor -->0.7<!-- /vc:sizeRouterVapor --> KB |
 | `vapor-chamber/router/remote` | <!-- vc:sizeRouterRemote -->5.3<!-- /vc:sizeRouterRemote --> KB |
 | `vapor-chamber/router-fetch` | <!-- vc:sizeRouterFetch -->5.6<!-- /vc:sizeRouterFetch --> KB |
-| `vapor-chamber/vue` | <!-- vc:sizeVue -->8.6<!-- /vc:sizeVue --> KB |
-| `vapor-chamber/vapor` | <!-- vc:sizeVapor -->8.9<!-- /vc:sizeVapor --> KB |
+| `vapor-chamber/vue` (with the root's surface, import-*everything*) | <!-- vc:sizeVue -->32.3<!-- /vc:sizeVue --> KB |
+| `vapor-chamber/vapor` (the same) | <!-- vc:sizeVapor -->32.5<!-- /vc:sizeVapor --> KB |
 | `vapor-chamber/reactive` | <!-- vc:sizeReactive -->6.1<!-- /vc:sizeReactive --> KB |
 | `vapor-chamber/transports` | <!-- vc:sizeTransports -->5.8<!-- /vc:sizeTransports --> KB |
 | `vapor-chamber/outbox` | <!-- vc:sizeOutbox -->2.7<!-- /vc:sizeOutbox --> KB |
@@ -1358,6 +1382,9 @@ machine-stamped rather than retyped:
 | `vapor-chamber/store` | <!-- vc:sizeStore -->2.2<!-- /vc:sizeStore --> KB |
 
 **Rows are not additive** - every row includes the shared core, which your bundle carries once.
+The `/vue` and `/vapor` rows include the whole root they carry. An app pays only for what it
+imports: one import from `/vapor` builds `examples/vapor-sfc` to the same bytes as two (log
+s35.236).
 `vapor-chamber` is the barrel measured import-everything. Your bundler drops what you don't use.
 
 These figures are **machine-stamped** from [docs/BUNDLE-SIZES.md](./docs/BUNDLE-SIZES.md). The
@@ -1374,8 +1401,8 @@ Three `<script>`-tag drop-ins. Pick by audience, not feature checklist.
 | Variant | Audience | Min | Brotli | Gzip |
 |---|---|--:|--:|--:|
 | **core** | Sprinkled JS on server-rendered pages (Blade, Rails, Django, WordPress). You dispatch user actions to a backend over HTTP. | <!-- vc:sizeIifeCoreRaw -->32.4<!-- /vc:sizeIifeCoreRaw --> KB | <!-- vc:sizeIifeCore -->10.2<!-- /vc:sizeIifeCore --> KB | <!-- vc:sizeIifeCoreGzip -->11.2<!-- /vc:sizeIifeCoreGzip --> KB |
-| **elements** | Embeddable widgets (chat bubbles, checkout buttons, third-party drop-ins). You ship a `<vc-widget>` custom element. | <!-- vc:sizeIifeElementsRaw -->34.0<!-- /vc:sizeIifeElementsRaw --> KB | <!-- vc:sizeIifeElements -->10.6<!-- /vc:sizeIifeElements --> KB | <!-- vc:sizeIifeElementsGzip -->11.7<!-- /vc:sizeIifeElementsGzip --> KB |
-| **full** | SPAs that grew big enough to want everything (realtime, undo/redo, persistence, full Vapor surface). | <!-- vc:sizeIifeFullRaw -->46.7<!-- /vc:sizeIifeFullRaw --> KB | <!-- vc:sizeIifeFull -->14.6<!-- /vc:sizeIifeFull --> KB | <!-- vc:sizeIifeFullGzip -->16.1<!-- /vc:sizeIifeFullGzip --> KB |
+| **elements** | Embeddable widgets (chat bubbles, checkout buttons, third-party drop-ins). You ship a `<vc-widget>` custom element. | <!-- vc:sizeIifeElementsRaw -->34.0<!-- /vc:sizeIifeElementsRaw --> KB | <!-- vc:sizeIifeElements -->10.7<!-- /vc:sizeIifeElements --> KB | <!-- vc:sizeIifeElementsGzip -->11.7<!-- /vc:sizeIifeElementsGzip --> KB |
+| **full** | SPAs that grew big enough to want everything (realtime, undo/redo, persistence, full Vapor surface). | <!-- vc:sizeIifeFullRaw -->46.9<!-- /vc:sizeIifeFullRaw --> KB | <!-- vc:sizeIifeFull -->14.7<!-- /vc:sizeIifeFull --> KB | <!-- vc:sizeIifeFullGzip -->16.2<!-- /vc:sizeIifeFullGzip --> KB |
 
 <details>
 <summary><b>What's in each variant</b>, plus drop-in examples</summary>
@@ -1405,7 +1432,10 @@ Three `<script>`-tag drop-ins. Pick by audience, not feature checklist.
 ```html
 <!-- elements: register a custom-element widget in one call -->
 <script src=".../vapor-chamber-elements.iife.min.js"></script>
-<script>
+<script type="module">
+  // Needed: without Vue's Vapor build handed over, defineWidget returns false.
+  const Vue = await import('.../vue.runtime-with-vapor.esm-browser.prod.js');
+  VaporChamber.configureVue(Vue);
   VaporChamber.defineWidget('vc-cart', {
     props: { sku: String },
     // A Vapor setup() returns a BLOCK - real DOM nodes. There is no compiler
@@ -1491,8 +1521,8 @@ Everything else is optional and tree-shaken when unimported.
    form.ts, schema.ts, devtools.ts, directives.ts, vite-hmr.ts
 ```
 
-**Coverage:** <!-- vc:covStatements -->100.0<!-- /vc:covStatements -->% statements, <!-- vc:covBranches -->100.0<!-- /vc:covBranches -->% branches, <!-- vc:covFunctions -->100.0<!-- /vc:covFunctions -->% functions, <!-- vc:covLines -->100.0<!-- /vc:covLines -->% lines across **<!-- vc:tests -->3498<!-- /vc:tests --> tests**
-(<!-- vc:testFiles -->316<!-- /vc:testFiles --> files). Per-file table:
+**Coverage:** <!-- vc:covStatements -->100.0<!-- /vc:covStatements -->% statements, <!-- vc:covBranches -->100.0<!-- /vc:covBranches -->% branches, <!-- vc:covFunctions -->100.0<!-- /vc:covFunctions -->% functions, <!-- vc:covLines -->100.0<!-- /vc:covLines -->% lines across **<!-- vc:tests -->3572<!-- /vc:tests --> tests**
+(<!-- vc:testFiles -->326<!-- /vc:testFiles --> files). Per-file table:
 [docs/COVERAGE.md](docs/COVERAGE.md). Run `npm run test:coverage` for live numbers.
 
 ## Testing
@@ -1625,12 +1655,12 @@ on a Facts layer: `setupDevtools(bus, app, { facts: ['router*'] })`.
 
 | Composable | Description |
 |------------|-------------|
-| `useCommand()` | Vapor-safe: dispatch + register/on/emit + reactive loading/error, auto-cleanup |
-| `useSharedCommandState(options?)` | Aggregate `isAnyLoading` + `errors` ring buffer, **shared** across subscribers on the same bus. For toolbars, status bars, global spinners. `isLoading(action, target?)` answers "is THIS one in flight?" per `commandKey(action, target)`, bus-wide, as its own reactive flag - a reader re-runs only on its key |
+| `useCommand(options?)` | Vapor-safe: dispatch + register/on/emit + reactive loading/error, auto-cleanup |
+| `useSharedCommandState(options?)` | Aggregate `isAnyLoading` + `errors` ring buffer, **shared** across subscribers on the same bus. For toolbars, status bars, global spinners. `isLoading(action, target?)` answers "is THIS one in flight?" per `commandKey(action, target)`, bus-wide, as its own reactive flag - a reader re-runs only on its key. Counting starts at the bus's first `isLoading()` call and stops when its last holder leaves with nothing in flight. A dispatch already in flight when counting starts reads `false` |
 | `defineVaporCommand(action, handler, options?)` | Zero-overhead dispatch for hot paths |
-| `useCommandState(initial, handlers)` | State managed by commands |
+| `useCommandState(initial, handlers, options?)` | State managed by commands |
 | `useCommandHistory(options?)` | Reactive undo/redo |
-| `useCommandGroup(namespace)` | Namespace isolation - prefixes all calls in camelCase |
+| `useCommandGroup(namespace, options?)` | Namespace isolation - prefixes all calls in camelCase |
 | `useCommandError(options?)` | Reactive error boundary for failed dispatches |
 | `getCommandBus()` | Get the shared bus |
 | `untracked(fn)` | Run a **raw-bus** dispatch without its handler's reads becoming dependencies of the surrounding effect. The composables above already do this - you only need it when calling `getCommandBus()` directly from inside a `watchEffect` / `computed`. No-op without Vue. **Import from `vapor-chamber/vue`** in a Vue app: from the package root it degrades to a pass-through in a production build |
@@ -1641,6 +1671,8 @@ on a Facts layer: `setupDevtools(bus, app, { facts: ['router*'] })`.
 | `getVaporInteropPlugin()` | `vaporInteropPlugin` for mixed trees |
 | `setupDevtools(bus, app, { facts? })` | Connect bus to Vue DevTools (`vapor-chamber/devtools`) |
 
+Every composable above takes `bus` in its options, sync or async. Without it, it uses the shared bus.
+
 **Router** - see [docs/router.md](docs/router.md) for the full surface:
 `createRouter`, `useRouter`, `useRoute`, `useQueryParam`, `useRouteData`, `useRouteError`,
 `useMenu`, `useBreadcrumbs`, `usePagination`, `onBeforeLeave`, `RouterOutlet`.

package/dist/LICENSE.txt

@@ -1,10 +1,10 @@
-vapor-chamber v1.28.0 - licence information for the distributed JavaScript
+vapor-chamber v1.29.0 - licence information for the distributed JavaScript
 ==============================================================================
 
 Every JavaScript file in this directory carries the one-line reference
 "/*! See LICENSE.txt */". This file is that reference.
 
-These 61 files:
+These 62 files:
 
   a11y.js
   alien-signals.js
@@ -44,6 +44,7 @@ These 61 files:
   router/vdom.js
   shared-bus.js
   signal.js
+  src.js
   ssr.js
   ssr2.js
   store-base.js

package/dist/chamber-vapor.d.ts

@@ -10,7 +10,8 @@
  *
  * Separated from chamber.ts to keep the core composable module CDCC-compliant.
  */
-import type { Handler, RegisterOptions, CommandResult } from './command-bus';
+import type { BaseBus, CommandBus, Handler, RegisterOptions, CommandResult } from './command-bus';
+import { type BusOption, type ResultOn } from './shared-bus';
 /**
  * Create a Vapor app instance with vapor-chamber ready.
  * Requires Vue 3.6+. Throws if Vapor is not available.
@@ -117,6 +118,8 @@ export declare function defineVaporComponent<T = any>(options: object): T | null
  * const AsyncPanel = defineVaporAsyncComponent(() => import('./Panel.vue'));
  */
 export declare function defineVaporAsyncComponent<T = any>(loader: (() => Promise<unknown>) | object): T | null;
+/** `defineVaporCommand`'s options: how the handler registers, and on which bus. */
+export type VaporCommandOptions<B extends BaseBus = BaseBus> = RegisterOptions & BusOption<B>;
 /**
  * defineVaporCommand - zero-overhead command for hot paths in Vapor mode.
  *
@@ -132,8 +135,8 @@ export declare function defineVaporAsyncComponent<T = any>(loader: (() => Promis
  * });
  * dispatch({ name: 'page_view', params: { page: '/landing' } });
  */
-export declare function defineVaporCommand(action: string, handler: Handler, options?: RegisterOptions): {
-    dispatch: (target: any, payload?: any) => CommandResult;
+export declare function defineVaporCommand<B extends BaseBus = CommandBus>(action: string, handler: Handler, options?: VaporCommandOptions<B>): {
+    dispatch: (target: any, payload?: any) => ResultOn<B>;
     dispose: () => void;
 };
 /**

package/dist/chamber-vapor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chamber-vapor.d.ts","sourceRoot":"","sources":["../src/chamber-vapor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAc,MAAM,eAAe,CAAC;AA2BzF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAG,GAAG,EAC9C,aAAa,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,IAAI,CAaN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,GAAG,IAAI,CAElD;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAOlG;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAOvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,GAAG,GAAG,EAC/C,MAAM,EAAE,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,GACxC,CAAC,GAAG,IAAI,CAOV;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,eAAe;uBAYC,GAAG,YAAY,GAAG,KAAG,aAAa;;EAS7D;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE;IAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;CAAE;uBAUlG,MAAM,UAAU,GAAG,YAAY,GAAG,KAAG,OAAO,CAAC,aAAa,CAAC;;;;EAgC5F"}
+{"version":3,"file":"chamber-vapor.d.ts","sourceRoot":"","sources":["../src/chamber-vapor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGlG,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAyBzE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAG,GAAG,EAC9C,aAAa,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,IAAI,CAaN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,GAAG,IAAI,CAElD;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAOlG;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAOvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,GAAG,GAAG,EAC/C,MAAM,EAAE,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,GACxC,CAAC,GAAG,IAAI,CAOV;AAMD,mFAAmF;AACnF,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAE9F;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,GAAG,UAAU,EAC/D,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;uBAcN,GAAG,YAAY,GAAG,KAAG,QAAQ,CAAC,CAAC,CAAC;;EAS3D;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE;IAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;CAAE;uBAUlG,MAAM,UAAU,GAAG,YAAY,GAAG,KAAG,OAAO,CAAC,aAAa,CAAC;;;;EAgC5F"}

package/dist/chamber-vapor.js

@@ -1,8 +1,8 @@
 /*! See LICENSE.txt */
-import { x as errResult } from "./command-bus.js";
+import { S as errResult } from "./command-bus.js";
 import { a as getDefineVaporComponentFn, b as vueDetectionHint, c as getVaporInteropRef, d as tryAutoCleanup, f as untracked, i as getDefineVaporAsyncComponentFn, o as getDefineVaporCustomElementFn, s as getVaporAppFn } from "./chamber.js";
 import { n as signal } from "./signal.js";
-import { t as getCommandBus } from "./shared-bus.js";
+import { r as resolveBus } from "./shared-bus.js";
 var DEV = typeof process !== "undefined" || import.meta.env?.DEV ? process.env.NODE_ENV !== "production" : false;
 function devWarnNoVapor(api) {
   console.warn(`[vapor-chamber] ${api}() returned null - Vue 3.6+ with Vapor mode was not detected, so the component was NOT created. ${vueDetectionHint()} For VDOM mode use the matching define* helper from vue instead.`);
@@ -40,7 +40,7 @@ function defineVaporAsyncComponent(loader) {
   return fn(loader);
 }
 function defineVaporCommand(action, handler, options) {
-  const bus = getCommandBus();
+  const bus = resolveBus(options?.bus);
   const unregister = bus.register(action, handler, options);
   function dispatch(target, payload) {
     return untracked(() => bus.dispatch(action, target, payload));
@@ -55,7 +55,7 @@ function defineVaporCommand(action, handler, options) {
   };
 }
 function useVaporAsyncCommand(asyncBus) {
-  const bus = asyncBus ?? getCommandBus();
+  const bus = resolveBus(asyncBus);
   const loading = signal(false);
   const lastError = signal(null);
   async function dispatch(action, target, payload) {

package/dist/chamber-vapor.js.map

@@ -1 +1 @@
-{"version":3,"file":"chamber-vapor.js","names":["_errResult"],"sources":["../src/chamber-vapor.ts"],"sourcesContent":["/**\n * vapor-chamber - Vue 3.6+ Vapor-specific API\n *\n * This file renders nothing: it forwards Vue's own define* functions, so\n * rendering-side work (attrs fallthrough, interop, hydration) lands below it.\n * The wrappers and createVaporChamberApp take an opt-in return generic\n * (`<T = any>`) and `object`-typed options: importing Vue's Vapor types here\n * would put a hard `vue` type dependency on the main barrel and break Vue-less\n * command-bus consumers, so callers opt in: `defineVaporComponent<MyComp>(opts)`.\n *\n * Separated from chamber.ts to keep the core composable module CDCC-compliant.\n */\n\nimport {\n  getCommandBus,\n  signal,\n  tryAutoCleanup,\n  untracked,\n  getVaporAppFn,\n  getVaporInteropRef,\n  getDefineVaporCustomElementFn,\n  getDefineVaporComponentFn,\n  getDefineVaporAsyncComponentFn,\n  vueDetectionHint,\n} from './chamber';\nimport type { Handler, RegisterOptions, CommandResult, CommandMap } from './command-bus';\nimport { _errResult } from './command-bus';\nimport { DEV } from './dev';\n\n/**\n * Why the `defineVapor*` wrappers warn instead of just returning null.\n *\n * Each returns `null` when the Vapor runtime is absent, and callers are\n * documented to check. But a bare `null` is the same failure shape that hid a\n * real bug for several releases: `tryKeepAliveHooks` guarded on an accessor\n * that silently answers \"no\" under Vapor, so a feature was inert with nothing\n * to see (rc.4 cycle - see tests/keepalive-input-scope-fixture.test.ts). Silent\n * negatives are how detection bugs survive.\n *\n * So the null stays - throwing would break the documented contract and the\n * tests that assert it - but it is not quiet. The call sites gate on\n * `DEV`, so the whole call (and every byte of message text) folds out of the\n * production IIFE builds; this helper is then unreferenced and tree-shaken.\n */\nfunction devWarnNoVapor(api: string): void {\n  console.warn(\n    `[vapor-chamber] ${api}() returned null - Vue 3.6+ with Vapor mode was not detected, ` +\n      `so the component was NOT created. ${vueDetectionHint()} ` +\n      'For VDOM mode use the matching define* helper from vue instead.',\n  );\n}\n\n/**\n * Create a Vapor app instance with vapor-chamber ready.\n * Requires Vue 3.6+. Throws if Vapor is not available.\n *\n * Pass-through over Vue's createVaporApp - scope-ID handling, HMR app-instance\n * refresh, and setup() error recovery are Vue runtime behavior (per-beta detail:\n * CHANGELOG / whitepaper alignment log).\n *\n * `rootProps` are Vue's raw props, passed through unchanged: a plain value is\n * the value, and a FUNCTION is a getter that Vue calls for the value. So a\n * callback is wrapped, `{ onSave: () => onSave }`; passed bare it is called\n * and the component receives what it returned. (A function set on a\n * `defineWidget` element property is the opposite: it arrives as itself.)\n * Pinned by tests/vapor/vapor-subpath-wiring.test.ts.\n *\n * @example\n * import { createVaporChamberApp } from 'vapor-chamber';\n * import App from './App.vue';\n * createVaporChamberApp(App).mount('#app');\n *\n * @example Root props\n * createVaporChamberApp(App, { title: 'Cart', onSave: () => onSave }).mount('#app');\n */\nexport function createVaporChamberApp<TApp = any>(\n  rootComponent: object,\n  rootProps?: Record<string, unknown>,\n): TApp {\n  const fn = getVaporAppFn();\n  if (!fn) {\n    // The bare \"Vapor required\" message was the same whether Vue was absent,\n    // present-without-Vapor, or present-but-unreachable - three different\n    // problems with three different fixes. vueDetectionHint() names which.\n    throw new Error(\n      // The diagnosis ships (vueDetectionHint says why); the advice is DEV's.\n      `[vapor-chamber] Vue 3.6+ with Vapor mode required. ${vueDetectionHint()}` +\n      (DEV ? ' For VDOM mode, use createApp() from vue instead.' : '')\n    );\n  }\n  return fn(rootComponent, rootProps) as TApp;\n}\n\n/**\n * Returns the vaporInteropPlugin if available (Vue 3.6+).\n * Use this to enable mixed Vapor/VDOM component trees.\n *\n * Pass-through over Vue's plugin. The returned reference is safe to hold\n * across HMR cycles (Vue does not mutate the bridge).\n *\n * @example\n * import { createApp } from 'vue';\n * import { getVaporInteropPlugin } from 'vapor-chamber';\n * const plugin = getVaporInteropPlugin();\n * if (plugin) createApp(App).use(plugin).mount('#app');\n */\nexport function getVaporInteropPlugin(): any | null {\n  return getVaporInteropRef();\n}\n\n// ---------------------------------------------------------------------------\n// Vapor Custom Elements (Vue 3.6 - defineVaporCustomElement introduced in 3.6.0-alpha.4, #14017)\n// ---------------------------------------------------------------------------\n\n/**\n * defineVaporCustomElement - create a custom element backed by Vapor rendering.\n *\n * Wraps Vue's `defineVaporCustomElement()` (introduced in 3.6.0-alpha.4, #14017). The generated custom\n * element uses Vapor's compiler-optimized rendering instead of the VDOM, giving\n * zero-overhead DOM updates inside shadow DOM. Safe to call with a reused\n * options object, and children re-render on reactive prop changes (beta.14+;\n * per-beta detail: CHANGELOG / whitepaper alignment log).\n *\n * Returns null if the Vapor runtime (Vue 3.6+) is not detected - check before calling\n * `customElements.define()`.\n *\n * @example\n * import { defineVaporCustomElement } from 'vapor-chamber';\n * const MyEl = defineVaporCustomElement({\n *   props: { label: String },\n *   // A Vapor setup() returns a BLOCK - real DOM nodes - not a render\n *   // function or h() output. An SFC's compiler builds this from its template.\n *   setup(props) {\n *     const span = document.createElement('span');\n *     span.textContent = String(props.label);\n *     return span;\n *   }\n * });\n * if (MyEl) customElements.define('vc-greeting', MyEl);\n */\nexport function defineVaporCustomElement<T = any>(options: object, extraOptions?: object): T | null {\n  const fn = getDefineVaporCustomElementFn();\n  if (!fn) {\n    if (DEV) devWarnNoVapor(\"defineVaporCustomElement\");\n    return null;\n  }\n  return (extraOptions !== undefined ? fn(options, extraOptions) : fn(options)) as T;\n}\n\n/**\n * defineVaporComponent - define a Vapor component with proper type inference.\n *\n * Wraps Vue's `defineVaporComponent()` (typed since 3.6.0-alpha.5, #13831). Use this to get full\n * TypeScript inference for props, emits, and slots in Vapor components.\n * Pass-through - emits/$attrs routing, v-once interop, scope IDs, and the\n * compiler optimizations are Vue behavior (per-beta detail: CHANGELOG /\n * whitepaper alignment log).\n *\n * Returns null if the Vapor runtime (Vue 3.6+) is not detected.\n *\n * @example\n * import { defineVaporComponent } from 'vapor-chamber';\n * const Comp = defineVaporComponent({\n *   props: { count: Number },\n *   emits: ['change'],\n *   // Returns DOM nodes (a block), not h(): see defineVaporCustomElement above.\n *   setup(props) {\n *     const div = document.createElement('div');\n *     div.textContent = `Count: ${props.count}`;\n *     return div;\n *   }\n * });\n */\nexport function defineVaporComponent<T = any>(options: object): T | null {\n  const fn = getDefineVaporComponentFn();\n  if (!fn) {\n    if (DEV) devWarnNoVapor(\"defineVaporComponent\");\n    return null;\n  }\n  return fn(options) as T;\n}\n\n/**\n * defineVaporAsyncComponent - define an async Vapor component for lazy loading.\n *\n * Wraps Vue's `defineVaporAsyncComponent()` (introduced in 3.6.0-alpha.3, #13059). Async Vapor\n * components are cached by VaporKeepAlive and hydrate under VDOM Suspense.\n * The loading placeholder receives the deferred component's props and slots\n * (beta.14+) - render a skeleton matching the final shape. Per-beta detail:\n * CHANGELOG / whitepaper alignment log.\n *\n * Returns null if the Vapor runtime (Vue 3.6+) is not detected.\n *\n * @example\n * import { defineVaporAsyncComponent } from 'vapor-chamber';\n * const AsyncPanel = defineVaporAsyncComponent(() => import('./Panel.vue'));\n */\nexport function defineVaporAsyncComponent<T = any>(\n  loader: (() => Promise<unknown>) | object,\n): T | null {\n  const fn = getDefineVaporAsyncComponentFn();\n  if (!fn) {\n    if (DEV) devWarnNoVapor(\"defineVaporAsyncComponent\");\n    return null;\n  }\n  return fn(loader) as T;\n}\n\n// ---------------------------------------------------------------------------\n// defineVaporCommand\n// ---------------------------------------------------------------------------\n\n/**\n * defineVaporCommand - zero-overhead command for hot paths in Vapor mode.\n *\n * Unlike useCommand(), this skips reactive loading/error signal creation.\n * Ideal for high-frequency, fire-and-forget patterns where reactive\n * loading/error state isn't needed: scroll-position tracking, mousemove\n * sampling, telemetry / metrics events, debounced search, autosave.\n *\n * @example\n * const { dispatch } = defineVaporCommand('telemetryEvent', (cmd) => {\n *   // forward to whatever metrics / analytics SDK you use\n *   sendMetric(cmd.target.name, cmd.target.params);\n * });\n * dispatch({ name: 'page_view', params: { page: '/landing' } });\n */\nexport function defineVaporCommand(\n  action: string,\n  handler: Handler,\n  options?: RegisterOptions\n) {\n  const bus = getCommandBus<CommandMap>();\n  const unregister = bus.register(action, handler, options);\n\n  // `untracked`, like every other composable's dispatch. This one was the gap,\n  // and the worst place for it: a dispatch is an ACTION, not a read, and this\n  // helper is documented for hot paths in Vapor mode - i.e. the call most\n  // likely to be made from inside a render effect, where the handler's reads\n  // become that effect's dependencies and the component re-renders on state it\n  // never mentions. Pass-through when Vue is absent, so the \"zero reactive\n  // overhead\" claim above is unaffected for non-Vue consumers.\n  function dispatch(target: any, payload?: any): CommandResult {\n    return untracked(() => bus.dispatch(action, target, payload));\n  }\n\n  function dispose() { unregister(); }\n\n  tryAutoCleanup(dispose);\n\n  return { dispatch, dispose };\n}\n\n// ---------------------------------------------------------------------------\n// useVaporAsyncCommand\n// ---------------------------------------------------------------------------\n\n/**\n * useVaporAsyncCommand - async-aware command dispatch for Vapor components\n * used inside Suspense boundaries.\n *\n * Vue 3.6.0-beta.10 introduced proper async component hydration under VDOM\n * Suspense. This composable wraps an AsyncCommandBus dispatch with reactive\n * loading/error state, making it safe for `<script setup vapor>` components\n * that await async operations. Error-boundary rendering and scheduler-flush\n * behavior around async components are Vue runtime concerns (per-beta detail:\n * CHANGELOG / whitepaper alignment log).\n *\n * The dispatch function returns a Promise<CommandResult>, matching the\n * AsyncCommandBus interface. Use this when your commands hit async transports\n * (HTTP bridge, WS bridge) and you need awaitable results.\n *\n * Vue 3.6.0-rc.8: an awaiting `<script setup vapor>` compiles to an\n * `async setup()` that uses runtime-core's `withAsyncContext` and returns its\n * template as a render closure, and it registers with the NEAREST `<Suspense>`.\n * Composables called after the `await` - this one, `useCommand()` - arm their\n * cleanup on the restored component scope, including when the app unmounts\n * during the await. Pinned by tests/async-vapor-setup-fixture.test.ts.\n *\n * @example\n * // In a <script setup vapor> component under <Suspense>:\n * import { useVaporAsyncCommand } from 'vapor-chamber';\n * const { dispatch, loading, lastError } = useVaporAsyncCommand(asyncBus);\n * const result = await dispatch('orderCreate', { items: cart });\n */\nexport function useVaporAsyncCommand(asyncBus?: { dispatch: (action: string, target: any, payload?: any) => Promise<CommandResult> }) {\n  const bus = asyncBus ?? (getCommandBus() as any);\n  const loading = signal(false);\n  const lastError = signal<Error | null>(null);\n\n  // Intentionally hand-rolled, NOT routed through the shared runDispatch() that\n  // useCommand / useCommandQuery use. A single async/await is\n  // ~1.2x leaner on the dispatch wrapper than runDispatch's .then-chain (measured);\n  // this is the awaited HTTP/WS path, so keep it lean. Do not \"consolidate\" into\n  // runDispatch - the consistency isn't worth the wrapper overhead here.\n  async function dispatch(action: string, target: any, payload?: any): Promise<CommandResult> {\n    try {\n      // Both opening writes are inside the try: a sync subscriber that throws\n      // on either becomes a failed result and `loading` ends false (pinned by\n      // tests/vapor-async-throwing-subscriber.test.ts).\n      loading.value = true;\n      lastError.value = null;\n      // Untracked around the SYNCHRONOUS entry only - once the dispatch\n      // suspends, the caller's effect has finished and there is no subscriber\n      // left to leak into (pinned by the \"synchronous entry is the whole\n      // exposure\" test). Same scope as runDispatch's, one call, so the leaner\n      // hand-rolled wrapper above stays leaner.\n      const result = await untracked(() => bus.dispatch(action, target, payload));\n      if (!result.ok) lastError.value = result.error ?? null;\n      return result;\n    } catch (e) {\n      const error = e as Error;\n      lastError.value = error;\n      return _errResult(error);\n    } finally {\n      loading.value = false;\n    }\n  }\n\n  // Dispatch-only composable (no register/on, unlike useCommand) - there are no\n  // subscriptions to tear down. Kept as a no-op for return-shape symmetry with the\n  // other composables (callers may destructure `dispose`).\n  function dispose() {}\n\n  tryAutoCleanup(dispose);\n\n  return { dispatch, loading, lastError, dispose };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,SAAS,eAAe,KAAmB;CACzC,QAAQ,KACN,mBAAmB,IAAI,kGACgB,iBAAiB,EAAE,iEAE5D;AACF;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,sBACd,eACA,WACM;CACN,MAAM,KAAK,cAAc;CACzB,IAAI,CAAC,IAIH,MAAM,IAAI,MAER,sDAAsD,iBAAiB,OACtE,MAAM,sDAAsD,GAC/D;CAEF,OAAO,GAAG,eAAe,SAAS;AACpC;;;;;;;;;;;;;;AAeA,SAAgB,wBAAoC;CAClD,OAAO,mBAAmB;AAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,yBAAkC,SAAiB,cAAiC;CAClG,MAAM,KAAK,8BAA8B;CACzC,IAAI,CAAC,IAAI;EACP,IAAI,KAAK,eAAe,0BAA0B;EAClD,OAAO;CACT;CACA,OAAQ,iBAAiB,KAAA,IAAY,GAAG,SAAS,YAAY,IAAI,GAAG,OAAO;AAC7E;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,qBAA8B,SAA2B;CACvE,MAAM,KAAK,0BAA0B;CACrC,IAAI,CAAC,IAAI;EACP,IAAI,KAAK,eAAe,sBAAsB;EAC9C,OAAO;CACT;CACA,OAAO,GAAG,OAAO;AACnB;;;;;;;;;;;;;;;;AAiBA,SAAgB,0BACd,QACU;CACV,MAAM,KAAK,+BAA+B;CAC1C,IAAI,CAAC,IAAI;EACP,IAAI,KAAK,eAAe,2BAA2B;EACnD,OAAO;CACT;CACA,OAAO,GAAG,MAAM;AAClB;;;;;;;;;;;;;;;;AAqBA,SAAgB,mBACd,QACA,SACA,SACA;CACA,MAAM,MAAM,cAA0B;CACtC,MAAM,aAAa,IAAI,SAAS,QAAQ,SAAS,OAAO;CASxD,SAAS,SAAS,QAAa,SAA8B;EAC3D,OAAO,gBAAgB,IAAI,SAAS,QAAQ,QAAQ,OAAO,CAAC;CAC9D;CAEA,SAAS,UAAU;EAAE,WAAW;CAAG;CAEnC,eAAe,OAAO;CAEtB,OAAO;EAAE;EAAU;CAAQ;AAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,qBAAqB,UAAiG;CACpI,MAAM,MAAM,YAAa,cAAc;CACvC,MAAM,UAAU,OAAO,KAAK;CAC5B,MAAM,YAAY,OAAqB,IAAI;CAO3C,eAAe,SAAS,QAAgB,QAAa,SAAuC;EAC1F,IAAI;GAIF,QAAQ,QAAQ;GAChB,UAAU,QAAQ;GAMlB,MAAM,SAAS,MAAM,gBAAgB,IAAI,SAAS,QAAQ,QAAQ,OAAO,CAAC;GAC1E,IAAI,CAAC,OAAO,IAAI,UAAU,QAAQ,OAAO,SAAS;GAClD,OAAO;EACT,SAAS,GAAG;GACV,MAAM,QAAQ;GACd,UAAU,QAAQ;GAClB,OAAOA,UAAW,KAAK;EACzB,UAAU;GACR,QAAQ,QAAQ;EAClB;CACF;CAKA,SAAS,UAAU,CAAC;CAEpB,eAAe,OAAO;CAEtB,OAAO;EAAE;EAAU;EAAS;EAAW;CAAQ;AACjD"}
+{"version":3,"file":"chamber-vapor.js","names":["_errResult"],"sources":["../src/chamber-vapor.ts"],"sourcesContent":["/**\n * vapor-chamber - Vue 3.6+ Vapor-specific API\n *\n * This file renders nothing: it forwards Vue's own define* functions, so\n * rendering-side work (attrs fallthrough, interop, hydration) lands below it.\n * The wrappers and createVaporChamberApp take an opt-in return generic\n * (`<T = any>`) and `object`-typed options: importing Vue's Vapor types here\n * would put a hard `vue` type dependency on the main barrel and break Vue-less\n * command-bus consumers, so callers opt in: `defineVaporComponent<MyComp>(opts)`.\n *\n * Separated from chamber.ts to keep the core composable module CDCC-compliant.\n */\n\nimport {\n  signal,\n  tryAutoCleanup,\n  untracked,\n  getVaporAppFn,\n  getVaporInteropRef,\n  getDefineVaporCustomElementFn,\n  getDefineVaporComponentFn,\n  getDefineVaporAsyncComponentFn,\n  vueDetectionHint,\n} from './chamber';\nimport type { BaseBus, CommandBus, Handler, RegisterOptions, CommandResult } from './command-bus';\nimport { _errResult } from './command-bus';\nimport { DEV } from './dev';\nimport { resolveBus, type BusOption, type ResultOn } from './shared-bus';\n\n/**\n * Why the `defineVapor*` wrappers warn instead of just returning null.\n *\n * Each returns `null` when the Vapor runtime is absent, and callers are\n * documented to check. But a bare `null` is the same failure shape that hid a\n * real bug for several releases: `tryKeepAliveHooks` guarded on an accessor\n * that silently answers \"no\" under Vapor, so a feature was inert with nothing\n * to see (rc.4 cycle - see tests/keepalive-input-scope-fixture.test.ts). Silent\n * negatives are how detection bugs survive.\n *\n * So the null stays - throwing would break the documented contract and the\n * tests that assert it - but it is not quiet. The call sites gate on\n * `DEV`, so the whole call (and every byte of message text) folds out of the\n * production IIFE builds; this helper is then unreferenced and tree-shaken.\n */\nfunction devWarnNoVapor(api: string): void {\n  console.warn(\n    `[vapor-chamber] ${api}() returned null - Vue 3.6+ with Vapor mode was not detected, ` +\n      `so the component was NOT created. ${vueDetectionHint()} ` +\n      'For VDOM mode use the matching define* helper from vue instead.',\n  );\n}\n\n/**\n * Create a Vapor app instance with vapor-chamber ready.\n * Requires Vue 3.6+. Throws if Vapor is not available.\n *\n * Pass-through over Vue's createVaporApp - scope-ID handling, HMR app-instance\n * refresh, and setup() error recovery are Vue runtime behavior (per-beta detail:\n * CHANGELOG / whitepaper alignment log).\n *\n * `rootProps` are Vue's raw props, passed through unchanged: a plain value is\n * the value, and a FUNCTION is a getter that Vue calls for the value. So a\n * callback is wrapped, `{ onSave: () => onSave }`; passed bare it is called\n * and the component receives what it returned. (A function set on a\n * `defineWidget` element property is the opposite: it arrives as itself.)\n * Pinned by tests/vapor/vapor-subpath-wiring.test.ts.\n *\n * @example\n * import { createVaporChamberApp } from 'vapor-chamber';\n * import App from './App.vue';\n * createVaporChamberApp(App).mount('#app');\n *\n * @example Root props\n * createVaporChamberApp(App, { title: 'Cart', onSave: () => onSave }).mount('#app');\n */\nexport function createVaporChamberApp<TApp = any>(\n  rootComponent: object,\n  rootProps?: Record<string, unknown>,\n): TApp {\n  const fn = getVaporAppFn();\n  if (!fn) {\n    // The bare \"Vapor required\" message was the same whether Vue was absent,\n    // present-without-Vapor, or present-but-unreachable - three different\n    // problems with three different fixes. vueDetectionHint() names which.\n    throw new Error(\n      // The diagnosis ships (vueDetectionHint says why); the advice is DEV's.\n      `[vapor-chamber] Vue 3.6+ with Vapor mode required. ${vueDetectionHint()}` +\n      (DEV ? ' For VDOM mode, use createApp() from vue instead.' : '')\n    );\n  }\n  return fn(rootComponent, rootProps) as TApp;\n}\n\n/**\n * Returns the vaporInteropPlugin if available (Vue 3.6+).\n * Use this to enable mixed Vapor/VDOM component trees.\n *\n * Pass-through over Vue's plugin. The returned reference is safe to hold\n * across HMR cycles (Vue does not mutate the bridge).\n *\n * @example\n * import { createApp } from 'vue';\n * import { getVaporInteropPlugin } from 'vapor-chamber';\n * const plugin = getVaporInteropPlugin();\n * if (plugin) createApp(App).use(plugin).mount('#app');\n */\nexport function getVaporInteropPlugin(): any | null {\n  return getVaporInteropRef();\n}\n\n// ---------------------------------------------------------------------------\n// Vapor Custom Elements (Vue 3.6 - defineVaporCustomElement introduced in 3.6.0-alpha.4, #14017)\n// ---------------------------------------------------------------------------\n\n/**\n * defineVaporCustomElement - create a custom element backed by Vapor rendering.\n *\n * Wraps Vue's `defineVaporCustomElement()` (introduced in 3.6.0-alpha.4, #14017). The generated custom\n * element uses Vapor's compiler-optimized rendering instead of the VDOM, giving\n * zero-overhead DOM updates inside shadow DOM. Safe to call with a reused\n * options object, and children re-render on reactive prop changes (beta.14+;\n * per-beta detail: CHANGELOG / whitepaper alignment log).\n *\n * Returns null if the Vapor runtime (Vue 3.6+) is not detected - check before calling\n * `customElements.define()`.\n *\n * @example\n * import { defineVaporCustomElement } from 'vapor-chamber';\n * const MyEl = defineVaporCustomElement({\n *   props: { label: String },\n *   // A Vapor setup() returns a BLOCK - real DOM nodes - not a render\n *   // function or h() output. An SFC's compiler builds this from its template.\n *   setup(props) {\n *     const span = document.createElement('span');\n *     span.textContent = String(props.label);\n *     return span;\n *   }\n * });\n * if (MyEl) customElements.define('vc-greeting', MyEl);\n */\nexport function defineVaporCustomElement<T = any>(options: object, extraOptions?: object): T | null {\n  const fn = getDefineVaporCustomElementFn();\n  if (!fn) {\n    if (DEV) devWarnNoVapor(\"defineVaporCustomElement\");\n    return null;\n  }\n  return (extraOptions !== undefined ? fn(options, extraOptions) : fn(options)) as T;\n}\n\n/**\n * defineVaporComponent - define a Vapor component with proper type inference.\n *\n * Wraps Vue's `defineVaporComponent()` (typed since 3.6.0-alpha.5, #13831). Use this to get full\n * TypeScript inference for props, emits, and slots in Vapor components.\n * Pass-through - emits/$attrs routing, v-once interop, scope IDs, and the\n * compiler optimizations are Vue behavior (per-beta detail: CHANGELOG /\n * whitepaper alignment log).\n *\n * Returns null if the Vapor runtime (Vue 3.6+) is not detected.\n *\n * @example\n * import { defineVaporComponent } from 'vapor-chamber';\n * const Comp = defineVaporComponent({\n *   props: { count: Number },\n *   emits: ['change'],\n *   // Returns DOM nodes (a block), not h(): see defineVaporCustomElement above.\n *   setup(props) {\n *     const div = document.createElement('div');\n *     div.textContent = `Count: ${props.count}`;\n *     return div;\n *   }\n * });\n */\nexport function defineVaporComponent<T = any>(options: object): T | null {\n  const fn = getDefineVaporComponentFn();\n  if (!fn) {\n    if (DEV) devWarnNoVapor(\"defineVaporComponent\");\n    return null;\n  }\n  return fn(options) as T;\n}\n\n/**\n * defineVaporAsyncComponent - define an async Vapor component for lazy loading.\n *\n * Wraps Vue's `defineVaporAsyncComponent()` (introduced in 3.6.0-alpha.3, #13059). Async Vapor\n * components are cached by VaporKeepAlive and hydrate under VDOM Suspense.\n * The loading placeholder receives the deferred component's props and slots\n * (beta.14+) - render a skeleton matching the final shape. Per-beta detail:\n * CHANGELOG / whitepaper alignment log.\n *\n * Returns null if the Vapor runtime (Vue 3.6+) is not detected.\n *\n * @example\n * import { defineVaporAsyncComponent } from 'vapor-chamber';\n * const AsyncPanel = defineVaporAsyncComponent(() => import('./Panel.vue'));\n */\nexport function defineVaporAsyncComponent<T = any>(\n  loader: (() => Promise<unknown>) | object,\n): T | null {\n  const fn = getDefineVaporAsyncComponentFn();\n  if (!fn) {\n    if (DEV) devWarnNoVapor(\"defineVaporAsyncComponent\");\n    return null;\n  }\n  return fn(loader) as T;\n}\n\n// ---------------------------------------------------------------------------\n// defineVaporCommand\n// ---------------------------------------------------------------------------\n\n/** `defineVaporCommand`'s options: how the handler registers, and on which bus. */\nexport type VaporCommandOptions<B extends BaseBus = BaseBus> = RegisterOptions & BusOption<B>;\n\n/**\n * defineVaporCommand - zero-overhead command for hot paths in Vapor mode.\n *\n * Unlike useCommand(), this skips reactive loading/error signal creation.\n * Ideal for high-frequency, fire-and-forget patterns where reactive\n * loading/error state isn't needed: scroll-position tracking, mousemove\n * sampling, telemetry / metrics events, debounced search, autosave.\n *\n * @example\n * const { dispatch } = defineVaporCommand('telemetryEvent', (cmd) => {\n *   // forward to whatever metrics / analytics SDK you use\n *   sendMetric(cmd.target.name, cmd.target.params);\n * });\n * dispatch({ name: 'page_view', params: { page: '/landing' } });\n */\nexport function defineVaporCommand<B extends BaseBus = CommandBus>(\n  action: string,\n  handler: Handler,\n  options?: VaporCommandOptions<B>\n) {\n  const bus = resolveBus(options?.bus);\n  // The options go to register() as they are: it reads the register fields,\n  // and an undo's stored copy keeps `bus`, which nothing reads.\n  const unregister = bus.register(action, handler, options);\n\n  // `untracked`, like every other composable's dispatch. This one was the gap,\n  // and the worst place for it: a dispatch is an ACTION, not a read, and this\n  // helper is documented for hot paths in Vapor mode - i.e. the call most\n  // likely to be made from inside a render effect, where the handler's reads\n  // become that effect's dependencies and the component re-renders on state it\n  // never mentions. Pass-through when Vue is absent, so the \"zero reactive\n  // overhead\" claim above is unaffected for non-Vue consumers.\n  function dispatch(target: any, payload?: any): ResultOn<B> {\n    return untracked(() => bus.dispatch(action, target, payload)) as ResultOn<B>;\n  }\n\n  function dispose() { unregister(); }\n\n  tryAutoCleanup(dispose);\n\n  return { dispatch, dispose };\n}\n\n// ---------------------------------------------------------------------------\n// useVaporAsyncCommand\n// ---------------------------------------------------------------------------\n\n/**\n * useVaporAsyncCommand - async-aware command dispatch for Vapor components\n * used inside Suspense boundaries.\n *\n * Vue 3.6.0-beta.10 introduced proper async component hydration under VDOM\n * Suspense. This composable wraps an AsyncCommandBus dispatch with reactive\n * loading/error state, making it safe for `<script setup vapor>` components\n * that await async operations. Error-boundary rendering and scheduler-flush\n * behavior around async components are Vue runtime concerns (per-beta detail:\n * CHANGELOG / whitepaper alignment log).\n *\n * The dispatch function returns a Promise<CommandResult>, matching the\n * AsyncCommandBus interface. Use this when your commands hit async transports\n * (HTTP bridge, WS bridge) and you need awaitable results.\n *\n * Vue 3.6.0-rc.8: an awaiting `<script setup vapor>` compiles to an\n * `async setup()` that uses runtime-core's `withAsyncContext` and returns its\n * template as a render closure, and it registers with the NEAREST `<Suspense>`.\n * Composables called after the `await` - this one, `useCommand()` - arm their\n * cleanup on the restored component scope, including when the app unmounts\n * during the await. Pinned by tests/async-vapor-setup-fixture.test.ts.\n *\n * @example\n * // In a <script setup vapor> component under <Suspense>:\n * import { useVaporAsyncCommand } from 'vapor-chamber';\n * const { dispatch, loading, lastError } = useVaporAsyncCommand(asyncBus);\n * const result = await dispatch('orderCreate', { items: cart });\n */\nexport function useVaporAsyncCommand(asyncBus?: { dispatch: (action: string, target: any, payload?: any) => Promise<CommandResult> }) {\n  const bus: any = resolveBus(asyncBus as BaseBus | undefined);\n  const loading = signal(false);\n  const lastError = signal<Error | null>(null);\n\n  // Intentionally hand-rolled, NOT routed through the shared runDispatch() that\n  // useCommand / useCommandQuery use. A single async/await is\n  // ~1.2x leaner on the dispatch wrapper than runDispatch's .then-chain (measured);\n  // this is the awaited HTTP/WS path, so keep it lean. Do not \"consolidate\" into\n  // runDispatch - the consistency isn't worth the wrapper overhead here.\n  async function dispatch(action: string, target: any, payload?: any): Promise<CommandResult> {\n    try {\n      // Both opening writes are inside the try: a sync subscriber that throws\n      // on either becomes a failed result and `loading` ends false (pinned by\n      // tests/vapor-async-throwing-subscriber.test.ts).\n      loading.value = true;\n      lastError.value = null;\n      // Untracked around the SYNCHRONOUS entry only - once the dispatch\n      // suspends, the caller's effect has finished and there is no subscriber\n      // left to leak into (pinned by the \"synchronous entry is the whole\n      // exposure\" test). Same scope as runDispatch's, one call, so the leaner\n      // hand-rolled wrapper above stays leaner.\n      const result = await untracked(() => bus.dispatch(action, target, payload));\n      if (!result.ok) lastError.value = result.error ?? null;\n      return result;\n    } catch (e) {\n      const error = e as Error;\n      lastError.value = error;\n      return _errResult(error);\n    } finally {\n      loading.value = false;\n    }\n  }\n\n  // Dispatch-only composable (no register/on, unlike useCommand) - there are no\n  // subscriptions to tear down. Kept as a no-op for return-shape symmetry with the\n  // other composables (callers may destructure `dispose`).\n  function dispose() {}\n\n  tryAutoCleanup(dispose);\n\n  return { dispatch, loading, lastError, dispose };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,SAAS,eAAe,KAAmB;CACzC,QAAQ,KACN,mBAAmB,IAAI,kGACgB,iBAAiB,EAAE,iEAE5D;AACF;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,sBACd,eACA,WACM;CACN,MAAM,KAAK,cAAc;CACzB,IAAI,CAAC,IAIH,MAAM,IAAI,MAER,sDAAsD,iBAAiB,OACtE,MAAM,sDAAsD,GAC/D;CAEF,OAAO,GAAG,eAAe,SAAS;AACpC;;;;;;;;;;;;;;AAeA,SAAgB,wBAAoC;CAClD,OAAO,mBAAmB;AAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,yBAAkC,SAAiB,cAAiC;CAClG,MAAM,KAAK,8BAA8B;CACzC,IAAI,CAAC,IAAI;EACP,IAAI,KAAK,eAAe,0BAA0B;EAClD,OAAO;CACT;CACA,OAAQ,iBAAiB,KAAA,IAAY,GAAG,SAAS,YAAY,IAAI,GAAG,OAAO;AAC7E;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,qBAA8B,SAA2B;CACvE,MAAM,KAAK,0BAA0B;CACrC,IAAI,CAAC,IAAI;EACP,IAAI,KAAK,eAAe,sBAAsB;EAC9C,OAAO;CACT;CACA,OAAO,GAAG,OAAO;AACnB;;;;;;;;;;;;;;;;AAiBA,SAAgB,0BACd,QACU;CACV,MAAM,KAAK,+BAA+B;CAC1C,IAAI,CAAC,IAAI;EACP,IAAI,KAAK,eAAe,2BAA2B;EACnD,OAAO;CACT;CACA,OAAO,GAAG,MAAM;AAClB;;;;;;;;;;;;;;;;AAwBA,SAAgB,mBACd,QACA,SACA,SACA;CACA,MAAM,MAAM,WAAW,SAAS,GAAG;CAGnC,MAAM,aAAa,IAAI,SAAS,QAAQ,SAAS,OAAO;CASxD,SAAS,SAAS,QAAa,SAA4B;EACzD,OAAO,gBAAgB,IAAI,SAAS,QAAQ,QAAQ,OAAO,CAAC;CAC9D;CAEA,SAAS,UAAU;EAAE,WAAW;CAAG;CAEnC,eAAe,OAAO;CAEtB,OAAO;EAAE;EAAU;CAAQ;AAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,qBAAqB,UAAiG;CACpI,MAAM,MAAW,WAAW,QAA+B;CAC3D,MAAM,UAAU,OAAO,KAAK;CAC5B,MAAM,YAAY,OAAqB,IAAI;CAO3C,eAAe,SAAS,QAAgB,QAAa,SAAuC;EAC1F,IAAI;GAIF,QAAQ,QAAQ;GAChB,UAAU,QAAQ;GAMlB,MAAM,SAAS,MAAM,gBAAgB,IAAI,SAAS,QAAQ,QAAQ,OAAO,CAAC;GAC1E,IAAI,CAAC,OAAO,IAAI,UAAU,QAAQ,OAAO,SAAS;GAClD,OAAO;EACT,SAAS,GAAG;GACV,MAAM,QAAQ;GACd,UAAU,QAAQ;GAClB,OAAOA,UAAW,KAAK;EACzB,UAAU;GACR,QAAQ,QAAQ;EAClB;CACF;CAKA,SAAS,UAAU,CAAC;CAEpB,eAAe,OAAO;CAEtB,OAAO;EAAE;EAAU;EAAS;EAAW;CAAQ;AACjD"}

package/dist/chamber.d.ts

@@ -10,9 +10,9 @@
  * composables came from the root with nothing wired. The history is in
  * CHANGELOG.md.
  */
-import { type CommandBus, type Command, type CommandResult, type CommandMap, type TargetOf, type PayloadOf, type ResultOf, type Handler, type Plugin, type RegisterOptions, type Listener } from './command-bus';
+import { type BaseBus, type CommandBus, type Command, type CommandResult, type CommandMap, type TargetOf, type PayloadOf, type ResultOf, type Handler, type Plugin, type RegisterOptions, type Listener } from './command-bus';
 import { configureSignal, signal } from './signal';
-import { getCommandBus, resetCommandBus, setCommandBus } from './shared-bus';
+import { getCommandBus, resetCommandBus, setCommandBus, type BusOption, type ResultOn } from './shared-bus';
 import type { Signal } from './signal';
 export type { Signal, CreateSignal } from './signal';
 export { configureSignal };
@@ -153,6 +153,7 @@ export type SharedCommandMap = [keyof GlobalCommands] extends [never] ? CommandM
     [K in keyof GlobalCommands]: GlobalCommands[K];
 };
 export { getCommandBus, setCommandBus, resetCommandBus };
+export type { BusOption, ResultOn };
 /**
  * Try to register a cleanup function on the nearest Vue scope/component.
  *
@@ -230,8 +231,8 @@ export declare function runDispatch(bus: CommandBus, query: boolean, action: str
  * register('cartAdd', (cmd) => addToCart(cmd.target));
  * dispatch('cartAdd', { id: product.id });
  */
-export declare function useCommand(): {
-    dispatch: <A extends keyof SharedCommandMap & string>(action: A, target: TargetOf<SharedCommandMap, A>, payload?: PayloadOf<SharedCommandMap, A>) => CommandResult<ResultOf<SharedCommandMap, A>> | Promise<CommandResult<ResultOf<SharedCommandMap, A>>>;
+export declare function useCommand<B extends BaseBus = CommandBus>(options?: BusOption<B>): {
+    dispatch: <A extends keyof SharedCommandMap & string>(action: A, target: TargetOf<SharedCommandMap, A>, payload?: PayloadOf<SharedCommandMap, A>) => ResultOn<B, CommandResult<ResultOf<SharedCommandMap, A>>>;
     register: <A extends keyof SharedCommandMap & string>(action: A, handler: (cmd: Command<A, TargetOf<SharedCommandMap, A>, PayloadOf<SharedCommandMap, A>>) => ResultOf<SharedCommandMap, A> | Promise<ResultOf<SharedCommandMap, A>>, opts?: RegisterOptions) => () => void;
     on: (pattern: string, listener: (cmd: Command, result: CommandResult) => void) => () => void;
     emit: (event: string, data?: any) => void;
@@ -239,18 +240,12 @@ export declare function useCommand(): {
     lastError: Signal<Error | null>;
     dispose: () => void;
 };
-export type UseSharedCommandStateOptions = {
+export type UseSharedCommandStateOptions<B extends BaseBus = BaseBus> = BusOption<B> & {
     /**
      * How many recent errors to retain in `errors`. The list is kept
      * newest-last; older entries drop off. Default: 10.
      */
     maxSize?: number;
-    /**
-     * Bus to attach to. Defaults to the shared instance from `getCommandBus()`,
-     * which matches the single-bus pattern most apps use. Pass an explicit bus
-     * to scope shared state to a feature group / island.
-     */
-    bus?: CommandBus;
 };
 /**
  * useSharedCommandState - one set of reactive signals shared across every
@@ -276,10 +271,10 @@ export type UseSharedCommandStateOptions = {
  *
  * Auto-cleanup on Vue scope/component disposal via tryAutoCleanup.
  */
-export declare function useSharedCommandState(options?: UseSharedCommandStateOptions): {
+export declare function useSharedCommandState<B extends BaseBus = CommandBus>(options?: UseSharedCommandStateOptions<B>): {
     dispatch: (action: string, target: any, payload?: any, opts?: {
         signal?: AbortSignal;
-    }) => CommandResult | Promise<CommandResult>;
+    }) => ResultOn<B>;
     /** Reactive per-(action, target) loading flag - see isLoading above. */
     isLoading: (action: string, target?: unknown) => Readonly<Signal<boolean>>;
     /** Number of dispatches currently in flight across all subscribers. */
@@ -298,7 +293,7 @@ export declare function useSharedCommandState(options?: UseSharedCommandStateOpt
      *  hooks Vue's scope/unmount lifecycle. */
     dispose: () => void;
 };
-export type UseCommandStateOptions = {
+export type UseCommandStateOptions = BusOption & {
     /**
      * When true, multiple synchronous dispatches within the same microtask are
      * accumulated and the signal is written once via `queueMicrotask`. Pairs with
@@ -359,7 +354,7 @@ export declare function _createCommandState<T>(initial: T, handlers: {
 export declare function useCommandHistory(options?: {
     maxSize?: number;
     filter?: (cmd: Command) => boolean;
-}): {
+} & BusOption): {
     past: Signal<Command[]>;
     future: Signal<Command[]>;
     canUndo: Signal<boolean>;
@@ -384,8 +379,8 @@ export declare function useCommandHistory(options?: {
  * const result = query('getUser', { id: 42 });
  * // data.value = result.value after query completes
  */
-export declare function useCommandQuery(): {
-    query: (action: string, target: any, payload?: any) => CommandResult | Promise<CommandResult>;
+export declare function useCommandQuery<B extends BaseBus = CommandBus>(options?: BusOption<B>): {
+    query: (action: string, target: any, payload?: any) => ResultOn<B>;
     data: Signal<any>;
     loading: Signal<boolean>;
     lastError: Signal<Error | null>;
@@ -408,9 +403,9 @@ export declare function useCommandQuery(): {
  * const orders = useCommandGroup('orders')
  * orders.dispatch('cancel', { id }) // dispatches 'ordersCancel'
  */
-export declare function useCommandGroup(namespace: string): {
-    dispatch: (action: string, target: any, payload?: any) => CommandResult;
-    query: (action: string, target: any, payload?: any) => CommandResult;
+export declare function useCommandGroup<B extends BaseBus = CommandBus>(namespace: string, options?: BusOption<B>): {
+    dispatch: (action: string, target: any, payload?: any) => ResultOn<B>;
+    query: (action: string, target: any, payload?: any) => ResultOn<B>;
     emit: (event: string, data?: any) => void;
     register: (action: string, handler: Handler, opts?: RegisterOptions) => () => void;
     use: (plugin: Plugin) => () => void;
@@ -434,7 +429,7 @@ export declare function useCommandError(options?: {
     filter?: (cmd: Command) => boolean;
     /** Max errors retained - oldest are dropped first (ring buffer). Default: 50. */
     maxSize?: number;
-}): {
+} & BusOption): {
     errors: Signal<{
         cmd: Command;
         error: Error;

package/dist/chamber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chamber.d.ts","sourceRoot":"","sources":["../src/chamber.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chamber.d.ts","sourceRoot":"","sources":["../src/chamber.ts"],"names":[],"mappings":"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"}