vapor-chamber 1.0.0 → 1.1.0

package/dist/chamber-vapor.d.ts

@@ -1,8 +1,11 @@
 /**
  * vapor-chamber — Vue 3.6+ Vapor-specific API
  *
- * createVaporChamberApp, getVaporInteropPlugin, defineVaporCommand,
- * useVaporCommand
+ * v1.1.0 — Added: defineVaporCustomElement, defineVaporComponent,
+ *           defineVaporAsyncComponent wrappers (Vue 3.6.0-beta.10+);
+ *           useVaporAsyncCommand for Suspense-aware async dispatch.
+ * v0.6.0 — Added: useVaporCommand composable.
+ * v0.4.0 — Added: createVaporChamberApp, getVaporInteropPlugin, defineVaporCommand.
  *
  * Separated from chamber.ts to keep the core composable module CDCC-compliant.
  */
@@ -28,6 +31,57 @@ export declare function createVaporChamberApp(rootComponent: any, rootProps?: an
  * if (plugin) createApp(App).use(plugin).mount('#app');
  */
 export declare function getVaporInteropPlugin(): any | null;
+/**
+ * defineVaporCustomElement — create a custom element backed by Vapor rendering.
+ *
+ * Wraps Vue 3.6.0-beta.10's `defineVaporCustomElement()`. The generated custom
+ * element uses Vapor's compiler-optimized rendering instead of the VDOM, giving
+ * zero-overhead DOM updates inside shadow DOM.
+ *
+ * SSR runtime is automatically tree-shaken from the generated code (beta.10 fix).
+ *
+ * Returns null if Vue 3.6.0-beta.10+ is not detected — check before calling
+ * `customElements.define()`.
+ *
+ * @example
+ * import { defineVaporCustomElement } from 'vapor-chamber';
+ * const MyEl = defineVaporCustomElement({
+ *   props: { label: String },
+ *   setup(props) { return () => h('span', props.label); }
+ * });
+ * if (MyEl) customElements.define('my-el', MyEl);
+ */
+export declare function defineVaporCustomElement(options: any, extraOptions?: any): any | null;
+/**
+ * defineVaporComponent — define a Vapor component with proper type inference.
+ *
+ * Wraps Vue 3.6.0-beta.10's `defineVaporComponent()`. Use this to get full
+ * TypeScript inference for props, emits, and slots in Vapor components.
+ *
+ * Returns null if Vue 3.6.0-beta.10+ is not detected.
+ *
+ * @example
+ * import { defineVaporComponent } from 'vapor-chamber';
+ * const Comp = defineVaporComponent({
+ *   props: { count: Number },
+ *   setup(props) { return () => h('div', `Count: ${props.count}`); }
+ * });
+ */
+export declare function defineVaporComponent(options: any): any | null;
+/**
+ * defineVaporAsyncComponent — define an async Vapor component for lazy loading.
+ *
+ * Wraps Vue 3.6.0-beta.10's `defineVaporAsyncComponent()`. Async Vapor
+ * components are properly cached by VaporKeepAlive and hydrate under VDOM
+ * Suspense boundaries (beta.10 fix).
+ *
+ * Returns null if Vue 3.6.0-beta.10+ is not detected.
+ *
+ * @example
+ * import { defineVaporAsyncComponent } from 'vapor-chamber';
+ * const AsyncPanel = defineVaporAsyncComponent(() => import('./Panel.vue'));
+ */
+export declare function defineVaporAsyncComponent(loader: any): any | null;
 /**
  * defineVaporCommand — zero-overhead command for hot paths in Vapor mode.
  *
@@ -62,9 +116,37 @@ export declare function defineVaporCommand(action: string, handler: Handler, opt
  * dispatch('cartAdd', { id: product.id });
  */
 export declare function useVaporCommand(): {
-    dispatch: (action: string, target: any, payload?: any) => CommandResult;
+    dispatch: (action: string, target: any, payload?: any) => CommandResult | Promise<CommandResult>;
     register: (action: string, handler: Handler, opts?: RegisterOptions) => () => void;
     on: (pattern: string, listener: (cmd: Command, result: CommandResult) => void) => () => void;
+    emit: (event: string, data?: any) => void;
+    loading: import("./chamber").Signal<boolean>;
+    lastError: import("./chamber").Signal<Error | null>;
+    dispose: () => void;
+};
+/**
+ * useVaporAsyncCommand — async-aware command dispatch for Vapor components
+ * used inside Suspense boundaries.
+ *
+ * Vue 3.6.0-beta.10 introduced proper async component hydration under VDOM
+ * Suspense. This composable wraps an AsyncCommandBus dispatch with reactive
+ * loading/error state, making it safe for `<script setup vapor>` components
+ * that await async operations.
+ *
+ * The dispatch function returns a Promise<CommandResult>, matching the
+ * AsyncCommandBus interface. Use this when your commands hit async transports
+ * (HTTP bridge, WS bridge) and you need awaitable results.
+ *
+ * @example
+ * // In a <script setup vapor> component under <Suspense>:
+ * import { useVaporAsyncCommand } from 'vapor-chamber';
+ * const { dispatch, loading, lastError } = useVaporAsyncCommand(asyncBus);
+ * const result = await dispatch('orderCreate', { items: cart });
+ */
+export declare function useVaporAsyncCommand(asyncBus?: {
+    dispatch: (action: string, target: any, payload?: any) => Promise<CommandResult>;
+}): {
+    dispatch: (action: string, target: any, payload?: any) => Promise<CommandResult>;
     loading: import("./chamber").Signal<boolean>;
     lastError: import("./chamber").Signal<Error | null>;
     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;;;;;;;GAOG;AASH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEtF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,OASxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,GAAG,IAAI,CAElD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,eAAe;uBAKC,GAAG,YAAY,GAAG,KAAG,aAAa;;EAS7D;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe;uBAMH,MAAM,UAAU,GAAG,YAAY,GAAG,KAAG,aAAa;uBASlD,MAAM,WAAW,OAAO,SAAS,eAAe,KAAG,MAAM,IAAI;kBAMlE,MAAM,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,KAAG,MAAM,IAAI;;;;EAclG"}
+{"version":3,"file":"chamber-vapor.d.ts","sourceRoot":"","sources":["../src/chamber-vapor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,OAAO,KAAK,EAAE,OAAO,EAAgB,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEpG;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,OASxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,GAAG,IAAI,CAElD;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAIrF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAI7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAIjE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,eAAe;uBAKC,GAAG,YAAY,GAAG,KAAG,aAAa;;EAS7D;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe;uBAMH,MAAM,UAAU,GAAG,YAAY,GAAG,KAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;uBA0B3E,MAAM,WAAW,OAAO,SAAS,eAAe,KAAG,MAAM,IAAI;kBAMlE,MAAM,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,KAAG,MAAM,IAAI;kBAO5E,MAAM,SAAS,GAAG,KAAG,IAAI;;;;EAY/C;AAMD;;;;;;;;;;;;;;;;;;GAkBG;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;uBAMlG,MAAM,UAAU,GAAG,YAAY,GAAG,KAAG,OAAO,CAAC,aAAa,CAAC;;;;EAwB5F"}

package/dist/chamber-vapor.js

@@ -1,12 +1,15 @@
 /**
  * vapor-chamber — Vue 3.6+ Vapor-specific API
  *
- * createVaporChamberApp, getVaporInteropPlugin, defineVaporCommand,
- * useVaporCommand
+ * v1.1.0 — Added: defineVaporCustomElement, defineVaporComponent,
+ *           defineVaporAsyncComponent wrappers (Vue 3.6.0-beta.10+);
+ *           useVaporAsyncCommand for Suspense-aware async dispatch.
+ * v0.6.0 — Added: useVaporCommand composable.
+ * v0.4.0 — Added: createVaporChamberApp, getVaporInteropPlugin, defineVaporCommand.
  *
  * Separated from chamber.ts to keep the core composable module CDCC-compliant.
  */
-import { getCommandBus, signal, tryAutoCleanup, getVaporAppFn, getVaporInteropRef, } from './chamber';
+import { getCommandBus, signal, tryAutoCleanup, getVaporAppFn, getVaporInteropRef, getDefineVaporCustomElementFn, getDefineVaporComponentFn, getDefineVaporAsyncComponentFn, } from './chamber';
 /**
  * Create a Vapor app instance with vapor-chamber ready.
  * Requires Vue 3.6+. Throws if Vapor is not available.
@@ -37,6 +40,78 @@ export function createVaporChamberApp(rootComponent, rootProps) {
 export function getVaporInteropPlugin() {
     return getVaporInteropRef();
 }
+// ---------------------------------------------------------------------------
+// Vue 3.6.0-beta.10+ Vapor Custom Elements
+// ---------------------------------------------------------------------------
+/**
+ * defineVaporCustomElement — create a custom element backed by Vapor rendering.
+ *
+ * Wraps Vue 3.6.0-beta.10's `defineVaporCustomElement()`. The generated custom
+ * element uses Vapor's compiler-optimized rendering instead of the VDOM, giving
+ * zero-overhead DOM updates inside shadow DOM.
+ *
+ * SSR runtime is automatically tree-shaken from the generated code (beta.10 fix).
+ *
+ * Returns null if Vue 3.6.0-beta.10+ is not detected — check before calling
+ * `customElements.define()`.
+ *
+ * @example
+ * import { defineVaporCustomElement } from 'vapor-chamber';
+ * const MyEl = defineVaporCustomElement({
+ *   props: { label: String },
+ *   setup(props) { return () => h('span', props.label); }
+ * });
+ * if (MyEl) customElements.define('my-el', MyEl);
+ */
+export function defineVaporCustomElement(options, extraOptions) {
+    const fn = getDefineVaporCustomElementFn();
+    if (!fn)
+        return null;
+    return extraOptions !== undefined ? fn(options, extraOptions) : fn(options);
+}
+/**
+ * defineVaporComponent — define a Vapor component with proper type inference.
+ *
+ * Wraps Vue 3.6.0-beta.10's `defineVaporComponent()`. Use this to get full
+ * TypeScript inference for props, emits, and slots in Vapor components.
+ *
+ * Returns null if Vue 3.6.0-beta.10+ is not detected.
+ *
+ * @example
+ * import { defineVaporComponent } from 'vapor-chamber';
+ * const Comp = defineVaporComponent({
+ *   props: { count: Number },
+ *   setup(props) { return () => h('div', `Count: ${props.count}`); }
+ * });
+ */
+export function defineVaporComponent(options) {
+    const fn = getDefineVaporComponentFn();
+    if (!fn)
+        return null;
+    return fn(options);
+}
+/**
+ * defineVaporAsyncComponent — define an async Vapor component for lazy loading.
+ *
+ * Wraps Vue 3.6.0-beta.10's `defineVaporAsyncComponent()`. Async Vapor
+ * components are properly cached by VaporKeepAlive and hydrate under VDOM
+ * Suspense boundaries (beta.10 fix).
+ *
+ * Returns null if Vue 3.6.0-beta.10+ is not detected.
+ *
+ * @example
+ * import { defineVaporAsyncComponent } from 'vapor-chamber';
+ * const AsyncPanel = defineVaporAsyncComponent(() => import('./Panel.vue'));
+ */
+export function defineVaporAsyncComponent(loader) {
+    const fn = getDefineVaporAsyncComponentFn();
+    if (!fn)
+        return null;
+    return fn(loader);
+}
+// ---------------------------------------------------------------------------
+// defineVaporCommand
+// ---------------------------------------------------------------------------
 /**
  * defineVaporCommand — zero-overhead command for hot paths in Vapor mode.
  *
@@ -87,7 +162,21 @@ export function useVaporCommand() {
     function dispatch(action, target, payload) {
         loading.value = true;
         lastError.value = null;
-        const result = bus.dispatch(action, target, payload);
+        let result;
+        try {
+            result = bus.dispatch(action, target, payload);
+        }
+        catch (e) {
+            loading.value = false;
+            const error = e;
+            lastError.value = error;
+            return { ok: false, error };
+        }
+        // Handle async results (when using async bus or async transport plugins)
+        if (result && typeof result.then === 'function') {
+            return result.then((r) => { loading.value = false; if (!r.ok)
+                lastError.value = r.error ?? null; return r; }, (e) => { loading.value = false; lastError.value = e; return { ok: false, error: e }; });
+        }
         loading.value = false;
         if (!result.ok)
             lastError.value = result.error ?? null;
@@ -103,10 +192,66 @@ export function useVaporCommand() {
         listeners.push(unsub);
         return unsub;
     }
+    /** Fire a domain event — notifies on() listeners, no handler required, no result. */
+    function emit(event, data) {
+        bus.emit(event, data);
+    }
+    function dispose() {
+        listeners.forEach(fn => fn());
+        listeners.length = 0;
+    }
+    tryAutoCleanup(dispose);
+    return { dispatch, register, on, emit, loading, lastError, dispose };
+}
+// ---------------------------------------------------------------------------
+// useVaporAsyncCommand
+// ---------------------------------------------------------------------------
+/**
+ * useVaporAsyncCommand — async-aware command dispatch for Vapor components
+ * used inside Suspense boundaries.
+ *
+ * Vue 3.6.0-beta.10 introduced proper async component hydration under VDOM
+ * Suspense. This composable wraps an AsyncCommandBus dispatch with reactive
+ * loading/error state, making it safe for `<script setup vapor>` components
+ * that await async operations.
+ *
+ * The dispatch function returns a Promise<CommandResult>, matching the
+ * AsyncCommandBus interface. Use this when your commands hit async transports
+ * (HTTP bridge, WS bridge) and you need awaitable results.
+ *
+ * @example
+ * // In a <script setup vapor> component under <Suspense>:
+ * import { useVaporAsyncCommand } from 'vapor-chamber';
+ * const { dispatch, loading, lastError } = useVaporAsyncCommand(asyncBus);
+ * const result = await dispatch('orderCreate', { items: cart });
+ */
+export function useVaporAsyncCommand(asyncBus) {
+    const bus = asyncBus ?? getCommandBus();
+    const loading = signal(false);
+    const lastError = signal(null);
+    const listeners = [];
+    async function dispatch(action, target, payload) {
+        loading.value = true;
+        lastError.value = null;
+        try {
+            const result = await bus.dispatch(action, target, payload);
+            if (!result.ok)
+                lastError.value = result.error ?? null;
+            return result;
+        }
+        catch (e) {
+            const error = e;
+            lastError.value = error;
+            return { ok: false, error };
+        }
+        finally {
+            loading.value = false;
+        }
+    }
     function dispose() {
         listeners.forEach(fn => fn());
         listeners.length = 0;
     }
     tryAutoCleanup(dispose);
-    return { dispatch, register, on, loading, lastError, dispose };
+    return { dispatch, loading, lastError, dispose };
 }

package/dist/chamber.d.ts

@@ -1,6 +1,8 @@
 /**
  * vapor-chamber - Vue Vapor integration
  *
+ * v1.1.0 — Vue 3.6.0-beta.10 alignment: defineVaporCustomElement, defineVaporComponent,
+ *           defineVaporAsyncComponent detection; improved hydration interop.
  * v0.4.1 — Added: useCommandGroup (namespace isolation), useCommandError (error boundary).
  * v0.4.0 — Vue 3.6 Vapor alignment: onScopeDispose, Vapor detection,
  *           defineVaporCommand, createVaporChamberApp.
@@ -43,6 +45,12 @@ export declare function isVaporAvailable(): boolean;
 export declare function getVaporAppFn(): any;
 /** @internal — for chamber-vapor.ts use only */
 export declare function getVaporInteropRef(): any;
+/** @internal — for chamber-vapor.ts use only */
+export declare function getDefineVaporCustomElementFn(): any;
+/** @internal — for chamber-vapor.ts use only */
+export declare function getDefineVaporComponentFn(): any;
+/** @internal — for chamber-vapor.ts use only */
+export declare function getDefineVaporAsyncComponentFn(): any;
 export declare function getCommandBus(): CommandBus;
 export declare function setCommandBus(bus: CommandBus): void;
 /**
@@ -61,13 +69,23 @@ export declare function resetCommandBus(): void;
  * No-ops entirely if not inside a Vue context.
  */
 export declare function tryAutoCleanup(disposeFn: () => void): void;
+/**
+ * Register KeepAlive lifecycle hooks to pause/resume bus subscriptions.
+ *
+ * When a component is deactivated by KeepAlive, `onPause` is called.
+ * When reactivated, `onResume` is called. No-ops if not inside a
+ * KeepAlive-wrapped component or if Vue is not available.
+ *
+ * @internal — used by composables that manage bus subscriptions.
+ */
+export declare function tryKeepAliveHooks(onPause: () => void, onResume: () => void): void;
 /**
  * useCommand - dispatch commands with reactive loading/error state
  *
  * Auto-cleanup on Vue component unmount or scope disposal.
  */
 export declare function useCommand(): {
-    dispatch: (action: string, target: any, payload?: any) => CommandResult;
+    dispatch: (action: string, target: any, payload?: any) => CommandResult | Promise<CommandResult>;
     loading: Signal<boolean>;
     lastError: Signal<Error | null>;
 };
@@ -105,6 +123,27 @@ export declare function useCommandHistory(options?: {
     clear: () => void;
     dispose: () => void;
 };
+/**
+ * useCommandQuery — CQRS read-side composable with reactive state.
+ *
+ * Wraps bus.query() with reactive `data`, `loading`, and `lastError` signals.
+ * query() skips onBefore hooks (no auth gates, no loading spinners for reads)
+ * but runs plugins, handlers, and afterHooks.
+ *
+ * Supports both sync and async buses — if the result is a Promise, loading
+ * stays true until it resolves.
+ *
+ * @example
+ * const { query, data, loading, lastError } = useCommandQuery();
+ * 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>;
+    data: Signal<any>;
+    loading: Signal<boolean>;
+    lastError: Signal<Error | null>;
+};
 /**
  * useCommandGroup — namespace isolation for large apps and multi-team projects.
  *
@@ -125,6 +164,8 @@ export declare function useCommandHistory(options?: {
  */
 export declare function useCommandGroup(namespace: string): {
     dispatch: (action: string, target: any, payload?: any) => CommandResult;
+    query: (action: string, target: any, payload?: any) => CommandResult;
+    emit: (event: string, data?: any) => void;
     register: (action: string, handler: Handler, opts?: RegisterOptions) => () => void;
     use: (plugin: Plugin) => () => void;
     on: (pattern: string, listener: Listener) => () => void;

package/dist/chamber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chamber.d.ts","sourceRoot":"","sources":["../src/chamber.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAoB,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAMpK,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AACrC,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC;AAwFxD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAGzD;AAoBD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAEtD;AAED,eAAO,MAAM,MAAM,EAAE,YAAoD,CAAC;AAM1E;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,gDAAgD;AAChD,wBAAgB,aAAa,IAAI,GAAG,CAA8B;AAClE,gDAAgD;AAChD,wBAAgB,kBAAkB,IAAI,GAAG,CAAmC;AAQ5E,wBAAgB,aAAa,IAAI,UAAU,CAK1C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAEnD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAMD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,IAAI,GAAG,IAAI,CAoC1D;AAMD;;;;GAIG;AACH,wBAAgB,UAAU;uBAKE,MAAM,UAAU,GAAG,YAAY,GAAG,KAAG,aAAa;;;EAU7E;AAMD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE;IACR,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,KAAK,CAAC,CAAC;CACjD;;;EAuBF;AAMD;;GAEG;AACH,wBAAgB,aAAa,mDAE5B;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CAC/B;;;;;gBAoBa,OAAO,GAAG,SAAS;gBAsBnB,OAAO,GAAG,SAAS;;;EAmCrC;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM;uBAQrB,MAAM,UAAU,GAAG,YAAY,GAAG,KAAG,aAAa;uBAIlD,MAAM,WAAW,OAAO,SAAS,eAAe,KAAG,MAAM,IAAI;kBAMlE,MAAM,KAAG,MAAM,IAAI;kBAMnB,MAAM,YAAY,QAAQ,KAAG,MAAM,IAAI;;;EAgB7D;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE;IACvC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CAC/B;;aAIqB,OAAO;eAAS,KAAK;mBAAa,MAAM;;;;;EAyBlE"}
+{"version":3,"file":"chamber.d.ts","sourceRoot":"","sources":["../src/chamber.ts"],"names":[],"mappings":"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"}

package/dist/chamber.js

@@ -1,6 +1,8 @@
 /**
  * vapor-chamber - Vue Vapor integration
  *
+ * v1.1.0 — Vue 3.6.0-beta.10 alignment: defineVaporCustomElement, defineVaporComponent,
+ *           defineVaporAsyncComponent detection; improved hydration interop.
  * v0.4.1 — Added: useCommandGroup (namespace isolation), useCommandError (error boundary).
  * v0.4.0 — Vue 3.6 Vapor alignment: onScopeDispose, Vapor detection,
  *           defineVaporCommand, createVaporChamberApp.
@@ -22,11 +24,17 @@ let _vueRef = null;
 let _vueOnUnmounted = null;
 let _vueOnScopeDispose = null;
 let _vueGetCurrentInstance = null;
+let _vueOnActivated = null;
+let _vueOnDeactivated = null;
 let _vueProbed = false;
 // Vue 3.6+ Vapor detection
 let _hasVapor = false;
 let _createVaporAppFn = null;
 let _vaporInteropPluginRef = null;
+// Vue 3.6.0-beta.10+ Vapor APIs
+let _defineVaporCustomElementFn = null;
+let _defineVaporComponentFn = null;
+let _defineVaporAsyncComponentFn = null;
 /** Promise that resolves once Vue detection is complete. Await this in composables
  *  that need Vue APIs to be available before first use. */
 let _probePromise = null;
@@ -44,6 +52,13 @@ function applyVueModule(vue) {
     if (vue && typeof vue.getCurrentInstance === 'function') {
         _vueGetCurrentInstance = vue.getCurrentInstance;
     }
+    // KeepAlive lifecycle hooks (Vue 3.x)
+    if (vue && typeof vue.onActivated === 'function') {
+        _vueOnActivated = vue.onActivated;
+    }
+    if (vue && typeof vue.onDeactivated === 'function') {
+        _vueOnDeactivated = vue.onDeactivated;
+    }
     // Vue 3.6+ Vapor detection
     if (vue && typeof vue.createVaporApp === 'function') {
         _hasVapor = true;
@@ -52,6 +67,16 @@ function applyVueModule(vue) {
     if (vue && typeof vue.vaporInteropPlugin !== 'undefined') {
         _vaporInteropPluginRef = vue.vaporInteropPlugin;
     }
+    // Vue 3.6.0-beta.10+: Vapor custom elements and component definitions
+    if (vue && typeof vue.defineVaporCustomElement === 'function') {
+        _defineVaporCustomElementFn = vue.defineVaporCustomElement;
+    }
+    if (vue && typeof vue.defineVaporComponent === 'function') {
+        _defineVaporComponentFn = vue.defineVaporComponent;
+    }
+    if (vue && typeof vue.defineVaporAsyncComponent === 'function') {
+        _defineVaporAsyncComponentFn = vue.defineVaporAsyncComponent;
+    }
 }
 function probeVue() {
     if (_vueProbed)
@@ -141,6 +166,12 @@ export function isVaporAvailable() {
 export function getVaporAppFn() { return _createVaporAppFn; }
 /** @internal — for chamber-vapor.ts use only */
 export function getVaporInteropRef() { return _vaporInteropPluginRef; }
+/** @internal — for chamber-vapor.ts use only */
+export function getDefineVaporCustomElementFn() { return _defineVaporCustomElementFn; }
+/** @internal — for chamber-vapor.ts use only */
+export function getDefineVaporComponentFn() { return _defineVaporComponentFn; }
+/** @internal — for chamber-vapor.ts use only */
+export function getDefineVaporAsyncComponentFn() { return _defineVaporAsyncComponentFn; }
 // ---------------------------------------------------------------------------
 // Shared command bus instance
 // ---------------------------------------------------------------------------
@@ -209,6 +240,33 @@ export function tryAutoCleanup(disposeFn) {
     }
 }
 // ---------------------------------------------------------------------------
+// KeepAlive pause/resume support
+// ---------------------------------------------------------------------------
+/**
+ * Register KeepAlive lifecycle hooks to pause/resume bus subscriptions.
+ *
+ * When a component is deactivated by KeepAlive, `onPause` is called.
+ * When reactivated, `onResume` is called. No-ops if not inside a
+ * KeepAlive-wrapped component or if Vue is not available.
+ *
+ * @internal — used by composables that manage bus subscriptions.
+ */
+export function tryKeepAliveHooks(onPause, onResume) {
+    probeVue();
+    if (_vueOnDeactivated) {
+        try {
+            _vueOnDeactivated(onPause);
+        }
+        catch { /* not in component context */ }
+    }
+    if (_vueOnActivated) {
+        try {
+            _vueOnActivated(onResume);
+        }
+        catch { /* not in component context */ }
+    }
+}
+// ---------------------------------------------------------------------------
 // useCommand
 // ---------------------------------------------------------------------------
 /**
@@ -223,7 +281,21 @@ export function useCommand() {
     function dispatch(action, target, payload) {
         loading.value = true;
         lastError.value = null;
-        const result = bus.dispatch(action, target, payload);
+        let result;
+        try {
+            result = bus.dispatch(action, target, payload);
+        }
+        catch (e) {
+            loading.value = false;
+            const error = e;
+            lastError.value = error;
+            return { ok: false, error };
+        }
+        // Handle async results (when using async bus or async transport plugins)
+        if (result && typeof result.then === 'function') {
+            return result.then((r) => { loading.value = false; if (!r.ok)
+                lastError.value = r.error ?? null; return r; }, (e) => { loading.value = false; lastError.value = e; return { ok: false, error: e }; });
+        }
         loading.value = false;
         if (!result.ok)
             lastError.value = result.error ?? null;
@@ -282,7 +354,10 @@ export function useCommandHistory(options = {}) {
     const future = signal([]);
     const canUndo = signal(false);
     const canRedo = signal(false);
+    let paused = false;
     const unsubscribe = bus.onAfter((cmd, result) => {
+        if (paused)
+            return;
         if (result.ok && (!filter || filter(cmd))) {
             const newPast = [...past.value, cmd];
             if (newPast.length > maxSize)
@@ -293,6 +368,8 @@ export function useCommandHistory(options = {}) {
             canRedo.value = false;
         }
     });
+    // KeepAlive: pause tracking when deactivated, resume when activated
+    tryKeepAliveHooks(() => { paused = true; }, () => { paused = false; });
     function undo() {
         const p = [...past.value];
         const cmd = p.pop();
@@ -319,6 +396,17 @@ export function useCommandHistory(options = {}) {
         const cmd = f.pop();
         if (cmd) {
             future.value = f;
+            // Pause tracking so the re-dispatch doesn't double-record
+            paused = true;
+            try {
+                bus.dispatch(cmd.action, cmd.target, cmd.payload);
+            }
+            catch (e) {
+                console.error(`[vapor-chamber] Redo dispatch error for "${cmd.action}":`, e);
+            }
+            finally {
+                paused = false;
+            }
             past.value = [...past.value, cmd];
             canUndo.value = true;
             canRedo.value = f.length > 0;
@@ -347,6 +435,62 @@ export function useCommandHistory(options = {}) {
     };
 }
 // ---------------------------------------------------------------------------
+// useCommandQuery
+// ---------------------------------------------------------------------------
+/**
+ * useCommandQuery — CQRS read-side composable with reactive state.
+ *
+ * Wraps bus.query() with reactive `data`, `loading`, and `lastError` signals.
+ * query() skips onBefore hooks (no auth gates, no loading spinners for reads)
+ * but runs plugins, handlers, and afterHooks.
+ *
+ * Supports both sync and async buses — if the result is a Promise, loading
+ * stays true until it resolves.
+ *
+ * @example
+ * const { query, data, loading, lastError } = useCommandQuery();
+ * const result = query('getUser', { id: 42 });
+ * // data.value = result.value after query completes
+ */
+export function useCommandQuery() {
+    const bus = getCommandBus();
+    const data = signal(null);
+    const loading = signal(false);
+    const lastError = signal(null);
+    function query(action, target, payload) {
+        loading.value = true;
+        lastError.value = null;
+        let result;
+        try {
+            result = bus.query(action, target, payload);
+        }
+        catch (e) {
+            loading.value = false;
+            const error = e;
+            lastError.value = error;
+            return { ok: false, error };
+        }
+        // Handle async results
+        if (result && typeof result.then === 'function') {
+            return result.then((r) => {
+                loading.value = false;
+                if (r.ok)
+                    data.value = r.value;
+                else
+                    lastError.value = r.error ?? null;
+                return r;
+            }, (e) => { loading.value = false; lastError.value = e; return { ok: false, error: e }; });
+        }
+        loading.value = false;
+        if (result.ok)
+            data.value = result.value;
+        else
+            lastError.value = result.error ?? null;
+        return result;
+    }
+    return { query, data, loading, lastError };
+}
+// ---------------------------------------------------------------------------
 // useCommandGroup
 // ---------------------------------------------------------------------------
 /**
@@ -376,6 +520,14 @@ export function useCommandGroup(namespace) {
     function dispatch(action, target, payload) {
         return bus.dispatch(prefixed(action), target, payload);
     }
+    /** Read-only dispatch — skips onBefore hooks, runs handler + plugins, fires afterHooks. */
+    function query(action, target, payload) {
+        return bus.query(prefixed(action), target, payload);
+    }
+    /** Fire a namespaced domain event — notifies on() listeners, no handler required. */
+    function emit(event, data) {
+        bus.emit(prefixed(event), data);
+    }
     function register(action, handler, opts) {
         const unregister = bus.register(prefixed(action), handler, opts);
         cleanups.push(unregister);
@@ -398,7 +550,7 @@ export function useCommandGroup(namespace) {
         cleanups.length = 0;
     }
     tryAutoCleanup(dispose);
-    return { dispatch, register, use, on, namespace, dispose };
+    return { dispatch, query, emit, register, use, on, namespace, dispose };
 }
 // ---------------------------------------------------------------------------
 // useCommandError
@@ -420,7 +572,10 @@ export function useCommandError(options = {}) {
     const bus = getCommandBus();
     const errors = signal([]);
     const latestError = signal(null);
+    let paused = false;
     const unsubscribe = bus.onAfter((cmd, result) => {
+        if (paused)
+            return;
         if (!result.ok && result.error) {
             if (!filter || filter(cmd)) {
                 latestError.value = result.error;
@@ -428,6 +583,8 @@ export function useCommandError(options = {}) {
             }
         }
     });
+    // KeepAlive: pause error capture when deactivated, resume when activated
+    tryKeepAliveHooks(() => { paused = true; }, () => { paused = false; });
     function clearErrors() {
         errors.value = [];
         latestError.value = null;

package/dist/directives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directives.d.ts","sourceRoot":"","sources":["../src/directives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAqHH;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI;IAAE,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAA;CAAE,CA8FnE"}
+{"version":3,"file":"directives.d.ts","sourceRoot":"","sources":["../src/directives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAqHH;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI;IAAE,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAA;CAAE,CAiGnE"}