@vielzeug/herald 1.0.5 → 2.0.0

package/dist/bus.js

@@ -1,150 +1,180 @@
+import "./_dev.js";
 import { callSafely as e } from "./_safe.js";
-import { warn as t } from "./_dev.js";
-import { BusDisposedError as n, HeraldConfigError as r } from "./errors.js";
+import { BusDisposedError as t, HeraldConfigError as n } from "./errors.js";
 //#region src/bus.ts
-var i = () => {};
-function a(e, t) {
-	if (e.aborted) return e;
-	if (t.aborted) return t;
-	let n = new AbortController(), r = () => n.abort(e.reason), i = () => n.abort(t.reason);
-	return e.addEventListener("abort", r, { once: !0 }), t.addEventListener("abort", i, { once: !0 }), n.signal.addEventListener("abort", () => {
-		e.removeEventListener("abort", r), t.removeEventListener("abort", i);
-	}, { once: !0 }), n.signal;
+var r = () => {};
+function i(...e) {
+	let t = e.filter((e) => e !== void 0);
+	if (t.length === 1) return {
+		dispose: r,
+		signal: t[0]
+	};
+	let n = t.find((e) => e.aborted);
+	if (n) return {
+		dispose: r,
+		signal: n
+	};
+	let i = new AbortController(), a = /* @__PURE__ */ new Map(), o = !1;
+	function s() {
+		if (!o) {
+			o = !0;
+			for (let [e, t] of a) e.removeEventListener("abort", t);
+			a.clear();
+		}
+	}
+	for (let e of t) {
+		let t = () => {
+			i.abort(e.reason), s();
+		};
+		a.set(e, t), e.addEventListener("abort", t, { once: !0 });
+	}
+	return {
+		dispose: s,
+		signal: i.signal
+	};
 }
-function o(e, ...t) {
-	return t.length === 0 ? e : t.reduce(a, e);
+function a(e, ...t) {
+	return i(e, ...t).signal;
 }
-function s(e, t) {
+function o(e, t) {
 	return Object.assign(e, { [Symbol.asyncDispose]: t });
 }
-function c(a) {
-	let c = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Set(), u = new AbortController(), d = a?.name, f = a?.maxListeners, p = a?.logger?.debug, m = p && d ? (e) => p(`${e} (${d})`) : p, h = a?.logger !== void 0, g = a?.logger?.warn, _ = d ? ` (${d})` : "";
-	function v(e) {
-		g ? g(e) : h || t(e);
+function s(a) {
+	let s = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Set(), l = new AbortController(), u = a?.name, d = a?.maxListeners, f = a?.logger?.debug, p = f && u ? (e) => f(`${e} (${u})`) : f;
+	a?.logger;
+	let m = a?.logger?.warn, h = u ? ` (${u})` : "";
+	function g(e) {
+		m && m(e);
 	}
-	function y(e) {
-		return e ? o(u.signal, e) : u.signal;
+	function _(e) {
+		return e ? i(l.signal, e) : {
+			dispose: r,
+			signal: l.signal
+		};
 	}
-	function b(t, n, r, i) {
-		return e(t, a?.onError ? (e) => a.onError({
+	function v(t, n, r, i) {
+		let o = a?.onError ? (e) => a.onError({
 			err: e,
 			event: n,
 			payload: r,
 			timestamp: i
-		}) : void 0);
+		}) : void 0;
+		return e(t, o);
 	}
-	function x(e, t, n, { offLog: r, onLog: a, onRemove: o }) {
-		if (n.aborted) return i;
+	function y(e, t, n, { offLog: i, onLog: a, onRemove: o }) {
+		if (n.aborted) return r;
 		let s = !1;
 		function c() {
-			s || (s = !0, e.delete(l), o?.(), n.removeEventListener("abort", c), m?.(`[herald:sub] ${r} — ${e.size} listener(s) remaining`));
+			s || (s = !0, e.delete(l), o?.(), n.removeEventListener("abort", c), p?.(`[herald:sub] ${i} — ${e.size} listener(s) remaining`));
 		}
 		let l = t(c);
-		return e.add(l), n.addEventListener("abort", c, { once: !0 }), m?.(`[herald:sub] ${a} — ${e.size} listener(s)`), f !== void 0 && e.size > f && v(`${a} has ${e.size} listeners, exceeding maxListeners (${f}). Possible memory leak.${_}`), c;
+		return e.add(l), n.addEventListener("abort", c, { once: !0 }), p?.(`[herald:sub] ${a} — ${e.size} listener(s)`), d !== void 0 && e.size > d && g(`${a} has ${e.size} listeners, exceeding maxListeners (${d}). Possible memory leak.${h}`), c;
 	}
-	function S(e, t, n) {
-		let r = c.get(e);
-		r || (r = /* @__PURE__ */ new Set(), c.set(e, r));
-		let i = r;
-		return x(i, (e) => ({
+	function b(e, t, n, r) {
+		let i = s.get(e);
+		i || (i = /* @__PURE__ */ new Set(), s.set(e, i));
+		let a = i;
+		return y(a, (e) => ({
 			fn: t,
 			unsub: e
 		}), n, {
 			offLog: `off("${e}")`,
 			onLog: `on("${e}")`,
 			onRemove: () => {
-				i.size === 0 && c.delete(e);
+				a.size === 0 && s.delete(e), r?.();
 			}
 		});
 	}
-	function C(e, t) {
-		return x(l, (t) => ({
+	function x(e, t, n) {
+		return y(c, (t) => ({
 			fn: e,
 			unsub: t
 		}), t, {
 			offLog: "onAny off",
-			onLog: "onAny"
+			onLog: "onAny",
+			onRemove: n
 		});
 	}
-	function w(e, t, n) {
-		let r = { unsub: i };
-		return r.unsub = S(e, (e) => {
-			r.unsub(), t(e);
-		}, n), r.unsub;
+	function S(e, t, n, i) {
+		let a = { unsub: r };
+		return a.unsub = b(e, (e) => {
+			a.unsub(), t(e);
+		}, n, i), a.unsub;
+	}
+	function C(e, t, n) {
+		let i = { unsub: r };
+		return i.unsub = x((t, n) => {
+			i.unsub(), e(t, n);
+		}, t, n), i.unsub;
 	}
-	function T(e, t) {
-		let n = { unsub: i };
-		return n.unsub = C((t, r) => {
-			n.unsub(), e(t, r);
-		}, t), n.unsub;
+	function w(e, t, n) {
+		let r = _(n?.signal);
+		return n?.once ? S(e, t, r.signal, r.dispose) : b(e, t, r.signal, r.dispose);
 	}
-	function E(e, t, n) {
-		let r = y(n?.signal);
-		return n?.once ? w(e, t, r) : S(e, t, r);
+	function T(e, t, n) {
+		let r = _(n?.signal);
+		return S(e, t, r.signal, r.dispose);
 	}
-	function D(e, t, n) {
-		return w(e, t, y(n?.signal));
+	function E(e, t) {
+		let n = _(t?.signal);
+		return t?.once ? C(e, n.signal, n.dispose) : x(e, n.signal, n.dispose);
 	}
-	function O(e, t) {
-		let n = y(t?.signal);
-		return t?.once ? T(e, n) : C(e, n);
-	}
-	function k(e, t) {
-		let n = y(t?.signal);
-		return n.aborted ? Promise.reject(n.reason) : new Promise((t, r) => {
-			function i() {
-				r(n.reason);
-			}
-			w(e, (e) => {
-				n.removeEventListener("abort", i), t(e);
-			}, n), n.addEventListener("abort", i, { once: !0 });
+	function D(e, t) {
+		let n = _(t?.signal);
+		return n.signal.aborted ? Promise.reject(n.signal.reason) : new Promise((t, r) => {
+			let i = () => {
+				n.dispose(), r(n.signal.reason);
+			};
+			S(e, (e) => {
+				n.signal.removeEventListener("abort", i), n.dispose(), t(e);
+			}, n.signal), n.signal.addEventListener("abort", i, { once: !0 });
 		});
 	}
-	function A(e, t) {
-		let n = t?.maxBuffer ?? Infinity;
-		if (!(n > 0)) throw new r("maxBuffer must be a positive number");
-		let i = y(t?.signal);
-		if (i.aborted) return s((async function* () {})(), async () => {});
-		let a = [], o, c = S(e, (e) => {
-			a.length >= n && a.shift(), a.push(e), o?.();
-		}, i);
-		async function* l() {
+	function O(e, t) {
+		let r = t?.maxBuffer ?? Infinity;
+		if (!(r > 0)) throw new n("maxBuffer must be a positive number");
+		let i = _(t?.signal), a = i.signal;
+		if (a.aborted) return o((async function* () {})(), async () => {});
+		let s = [], c, l = b(e, (e) => {
+			s.length >= r && s.shift(), s.push(e), c?.();
+		}, a, i.dispose);
+		async function* u() {
 			try {
-				for (; !i.aborted;) {
-					if (a.length) {
-						yield a.shift();
+				for (; !a.aborted;) {
+					if (s.length) {
+						yield s.shift();
 						continue;
 					}
 					let { promise: e, resolve: t } = Promise.withResolvers(), n = () => {
 						t();
 					};
-					o = t, i.addEventListener("abort", n, { once: !0 }), await e, i.removeEventListener("abort", n), o = void 0;
+					c = t, a.addEventListener("abort", n, { once: !0 }), await e, a.removeEventListener("abort", n), c = void 0;
 				}
 			} finally {
-				c();
+				l();
 			}
 		}
-		let u = l();
-		return s(u, async () => {
-			c(), await u.return(void 0);
+		let d = u();
+		return o(d, async () => {
+			l(), await d.return(void 0);
 		});
 	}
-	function j(e, t, n) {
+	function k(e, t, n) {
 		a?._onDispatch?.(e, t);
-		let r = 0, i, o = c.get(e);
+		let r = 0, i, o = s.get(e);
 		if (o?.size) for (let a of [...o]) {
-			let o = b(() => a.fn(t), e, t, n);
+			let o = v(() => a.fn(t), e, t, n);
 			o.threw && !i && (i = { err: o.err }), r++;
 		}
-		if (l.size) for (let a of [...l]) {
-			let o = b(() => a.fn(e, t), e, t, n);
+		if (c.size) for (let a of [...c]) {
+			let o = v(() => a.fn(e, t), e, t, n);
 			o.threw && !i && (i = { err: o.err }), r++;
 		}
 		if (i) throw i.err;
 		return r;
 	}
-	function M(e, ...t) {
-		if (u.signal.aborted) return 0;
+	function A(e, ...t) {
+		if (l.signal.aborted) return 0;
 		let n = t[0], r = Date.now();
 		if (a?.validatePayload) try {
 			a.validatePayload(e, n);
@@ -157,75 +187,81 @@ function c(a) {
 			}), 0;
 			throw t;
 		}
-		if (m) {
-			let t = c.get(e)?.size ?? 0, n = l.size;
-			m(`[herald:emit] emit("${e}") — ${t + n} listener(s) (${t} specific, ${n} wildcard)`);
+		if (p) {
+			let t = s.get(e)?.size ?? 0, n = c.size;
+			p(`[herald:emit] emit("${e}") — ${t + n} listener(s) (${t} specific, ${n} wildcard)`);
 		}
 		let i = a?.middleware;
-		if (i?.length) {
-			let t = 0, a = 0;
-			function o() {
-				let s = a++;
-				s < i.length ? i[s](e, n, o) : s === i.length && (t = j(e, n, r));
-			}
-			return o(), t;
+		if (!i?.length) return k(e, n, r);
+		let o = i;
+		function u(t) {
+			let i = o[t];
+			if (!i) return k(e, n, r);
+			let a = 0, s = !1, c = !0;
+			return i(e, n, () => {
+				!c || s || (s = !0, a = u(t + 1));
+			}), c = !1, a;
 		}
-		return j(e, n, r);
+		return u(0);
 	}
-	function N(e) {
-		if (e !== void 0) return c.get(e)?.size ?? 0;
+	function j(e) {
+		if (e !== void 0) return s.get(e)?.size ?? 0;
 		let t = 0;
-		for (let e of c.values()) t += e.size;
+		for (let e of s.values()) t += e.size;
 		return t;
 	}
-	function P() {
-		return l.size;
+	function M() {
+		return c.size;
 	}
-	function F() {
-		return [...c.keys()];
-	}
-	function I(e, t) {
-		if (e.length < 2) throw new r("waitAny() requires at least 2 event keys");
-		let n = y(t?.signal);
-		return n.aborted ? Promise.reject(n.reason) : new Promise((t, r) => {
-			let i = new AbortController(), a = o(n, i.signal);
-			function s() {
-				i.abort(), r(n.reason);
+	function N() {
+		return [...s.keys()];
+	}
+	function P(e, t) {
+		if (e.length < 2) throw new n("waitAny() requires at least 2 event keys");
+		let r = _(t?.signal);
+		return r.signal.aborted ? Promise.reject(r.signal.reason) : new Promise((t, n) => {
+			let a = new AbortController(), o = i(r.signal, a.signal), s = [], c = !1;
+			function l() {
+				r.signal.removeEventListener("abort", u), a.abort(), o.dispose(), r.dispose();
+				for (let e of s) e();
 			}
-			n.addEventListener("abort", s, { once: !0 });
-			for (let r of e) w(r, (e) => {
-				n.removeEventListener("abort", s), i.abort(), t({
-					event: r,
+			function u() {
+				c || (c = !0, l(), n(r.signal.reason));
+			}
+			r.signal.addEventListener("abort", u, { once: !0 });
+			for (let n of e) s.push(S(n, (e) => {
+				c || (c = !0, l(), t({
+					event: n,
 					payload: e
-				});
-			}, a);
+				}));
+			}, o.signal));
 		});
 	}
-	function L() {
-		u.signal.aborted || (m?.("[herald:lifecycle] dispose()"), u.abort(new n(d)), c.clear(), l.clear());
+	function F() {
+		l.signal.aborted || (p?.("[herald:lifecycle] dispose()"), l.abort(new t(u)), s.clear(), c.clear());
 	}
 	return {
 		get disposalSignal() {
-			return u.signal;
+			return l.signal;
 		},
-		dispose: L,
+		dispose: F,
 		get disposed() {
-			return u.signal.aborted;
+			return l.signal.aborted;
 		},
-		emit: M,
-		eventNames: F,
-		events: A,
-		listenerCount: N,
-		on: E,
-		onAny: O,
-		once: D,
-		[Symbol.dispose]: L,
-		wait: k,
-		waitAny: I,
-		wildcardCount: P
+		emit: A,
+		eventNames: N,
+		events: O,
+		listenerCount: j,
+		on: w,
+		onAny: E,
+		once: T,
+		[Symbol.dispose]: F,
+		wait: D,
+		waitAny: P,
+		wildcardCount: M
 	};
 }
 //#endregion
-export { o as combineSignals, c as createBus, i as noop };
+export { a as combineSignals, s as createBus, i as createSignalScope, r as noop };
 
 //# sourceMappingURL=bus.js.map

package/dist/bus.js.map

@@ -1 +1 @@
-{"version":3,"file":"bus.js","names":[],"sources":["../src/bus.ts"],"sourcesContent":["import type {\n  Bus,\n  BusOptions,\n  EmissionErrorContext,\n  EventKey,\n  EventMap,\n  EventStream,\n  Listener,\n  SubscribeOptions,\n  Unsubscribe,\n  WaitAnyResult,\n} from './types';\n\nimport { warn as _internalWarn } from './_dev';\nimport { type SafeCallResult, callSafely } from './_safe';\nimport { BusDisposedError, HeraldConfigError } from './errors';\n\n// Module-scoped noop — shared across all bus instances to avoid per-bus allocation.\n// @internal — exported only for sibling internal modules; stripped from public declarations via stripInternal.\n/** @internal */\nexport const noop = () => {};\n\n/** @internal */\nfunction mergeTwo(a: AbortSignal, b: AbortSignal): AbortSignal {\n  if (a.aborted) return a;\n\n  if (b.aborted) return b;\n\n  const ctrl = new AbortController();\n  const onA = (): void => ctrl.abort(a.reason);\n  const onB = (): void => ctrl.abort(b.reason);\n\n  a.addEventListener('abort', onA, { once: true });\n  b.addEventListener('abort', onB, { once: true });\n  ctrl.signal.addEventListener(\n    'abort',\n    () => {\n      a.removeEventListener('abort', onA);\n      b.removeEventListener('abort', onB);\n    },\n    { once: true },\n  );\n\n  return ctrl.signal;\n}\n\n/**\n * Returns a signal that aborts as soon as any of the provided signals abort.\n * With a single argument, returns it directly (no allocation).\n * Registers and cleans up its own event listeners — no leaks when no signal fires.\n *\n * @example\n * const signal = combineSignals(timeoutSignal, bus.disposalSignal);\n * bus.on('event', handler, { signal });\n *\n * @example\n * // Three signals — no nesting required\n * const signal = combineSignals(userSignal, timeoutSignal, bus.disposalSignal);\n */\nexport function combineSignals(first: AbortSignal, ...rest: AbortSignal[]): AbortSignal {\n  if (rest.length === 0) return first;\n\n  return rest.reduce(mergeTwo, first);\n}\n\n// Each registration gets a unique Entry object, allowing the same listener function\n// to be registered multiple times independently (aligns with Node EventEmitter / mitt).\ntype Entry = { fn: Listener<unknown>; unsub: () => void };\ntype WildcardEntry = { fn: (event: string, payload: unknown) => void; unsub: () => void };\n\ntype RegisterEntryOpts = { offLog: string; onLog: string; onRemove?: () => void };\n\n// makeEventStream wraps an AsyncGenerator with AsyncDisposable.\nfunction makeEventStream<V>(gen: AsyncGenerator<V>, onDispose: () => Promise<void>): EventStream<V> {\n  return Object.assign(gen, {\n    [Symbol.asyncDispose]: onDispose,\n  }) as unknown as EventStream<V>;\n}\n\n/** @internal */\nexport type InternalBusOptions<T extends EventMap> = BusOptions<T> & {\n  /** @internal Called after middleware passes, before listeners run. Used by BehaviorBus. */\n  _onDispatch?: (event: EventKey<T>, payload: unknown) => void;\n};\n\nexport function createBus<T extends EventMap>(options?: InternalBusOptions<T>): Bus<T> {\n  // Per-event set of Entry objects. Set identity prevents accidental dedup of entries;\n  // the same fn can appear in multiple entries with independent lifetimes.\n  const listeners = new Map<string, Set<Entry>>();\n  const wildcards = new Set<WildcardEntry>();\n  const disposeController = new AbortController();\n  const busName = options?.name;\n  const maxListeners = options?.maxListeners;\n  const rawDebug = options?.logger?.debug;\n  const logDebug = rawDebug && busName ? (msg: string) => rawDebug(`${msg} (${busName})`) : rawDebug;\n  const hasLogger = options?.logger !== undefined;\n  const customLogWarn = options?.logger?.warn;\n  const busTag = busName ? ` (${busName})` : '';\n\n  function doWarn(msg: string): void {\n    if (customLogWarn) {\n      customLogWarn(msg);\n    } else if (!hasLogger) {\n      _internalWarn(msg);\n    }\n  }\n\n  function mergeSignal(signal?: AbortSignal): AbortSignal {\n    return signal ? combineSignals(disposeController.signal, signal) : disposeController.signal;\n  }\n\n  // callSafe is defined once per bus (not per emit) — avoids re-allocating on every emission.\n  // Captures options.onError via closure. Used in emit() for both specific and wildcard loops.\n  // Does not rethrow directly — see dispatch(), which continues the broadcast to every remaining\n  // listener (including wildcards) before rethrowing the first captured error, if any.\n  function callSafe(fn: () => void, event: EventKey<T>, payload: unknown, timestamp: number): SafeCallResult {\n    const onError = options?.onError\n      ? (err: unknown) => options.onError!({ err, event, payload, timestamp } as EmissionErrorContext<T>)\n      : undefined;\n\n    return callSafely(fn, onError);\n  }\n\n  // registerEntry opts object — self-documenting call sites.\n  function registerEntry<E extends { unsub: () => void }>(\n    container: Set<E>,\n    makeEntry: (unsub: () => void) => E,\n    signal: AbortSignal,\n    { offLog, onLog, onRemove }: RegisterEntryOpts,\n  ): () => void {\n    if (signal.aborted) return noop;\n\n    // Boolean guard makes unsub idempotent — a second call after re-registration would\n    // otherwise see an empty container and incorrectly delete the outer map entry.\n    let called = false;\n\n    function unsub() {\n      if (called) return;\n\n      called = true;\n      container.delete(entry);\n      onRemove?.();\n      signal.removeEventListener('abort', unsub);\n\n      logDebug?.(`[herald:sub] ${offLog} — ${container.size} listener(s) remaining`);\n    }\n\n    // Function declaration is hoisted so `entry` can reference `unsub` directly.\n    const entry = makeEntry(unsub);\n\n    container.add(entry);\n    signal.addEventListener('abort', unsub, { once: true });\n\n    logDebug?.(`[herald:sub] ${onLog} — ${container.size} listener(s)`);\n\n    if (maxListeners !== undefined && container.size > maxListeners) {\n      doWarn(\n        `${onLog} has ${container.size} listeners, exceeding maxListeners (${maxListeners}). Possible memory leak.${busTag}`,\n      );\n    }\n\n    return unsub;\n  }\n\n  function onWithSignal<K extends EventKey<T>>(event: K, listener: Listener<T[K]>, signal: AbortSignal): () => void {\n    let set = listeners.get(event);\n\n    if (!set) {\n      set = new Set();\n      listeners.set(event, set);\n    }\n\n    // Capture the set reference so unsub can safely delete from it even after\n    // the event key has been removed from the outer map.\n    const capturedSet = set;\n\n    return registerEntry(capturedSet, (unsub) => ({ fn: listener as Listener<unknown>, unsub }), signal, {\n      offLog: `off(\"${event}\")`,\n      onLog: `on(\"${event}\")`,\n      onRemove: () => {\n        if (capturedSet.size === 0) listeners.delete(event);\n      },\n    });\n  }\n\n  function onAnyWithSignal(listener: (event: EventKey<T>, payload: unknown) => void, signal: AbortSignal): () => void {\n    return registerEntry(\n      wildcards,\n      (unsub) => ({ fn: listener as (event: string, payload: unknown) => void, unsub }),\n      signal,\n      { offLog: 'onAny off', onLog: 'onAny' },\n    );\n  }\n\n  // Use a const ref object to hold the unsub handle — avoids the forward-reference that\n  // TypeScript cannot prove safe with `const unsub = f(() => unsub)`. The `ref` binding never\n  // changes (only its property is mutated), satisfying prefer-const. By the time the inner\n  // callback fires (only possible after onWithSignal returns), ref.unsub is the real handle.\n  function onceWithSignal<K extends EventKey<T>>(event: K, listener: Listener<T[K]>, signal: AbortSignal): () => void {\n    const ref = { unsub: noop as Unsubscribe };\n\n    ref.unsub = onWithSignal(\n      event,\n      (payload) => {\n        ref.unsub();\n        listener(payload);\n      },\n      signal,\n    );\n\n    return ref.unsub;\n  }\n\n  // onAny with once — fires the wildcard listener exactly once, then auto-removes.\n  function onAnyWithOnce(listener: (event: EventKey<T>, payload: unknown) => void, signal: AbortSignal): () => void {\n    const ref = { unsub: noop as Unsubscribe };\n\n    ref.unsub = onAnyWithSignal((event, payload) => {\n      ref.unsub();\n      listener(event, payload);\n    }, signal);\n\n    return ref.unsub;\n  }\n\n  function on<K extends EventKey<T>>(event: K, listener: Listener<T[K]>, opts?: SubscribeOptions): () => void {\n    const signal = mergeSignal(opts?.signal);\n\n    if (opts?.once) return onceWithSignal(event, listener, signal);\n\n    return onWithSignal(event, listener, signal);\n  }\n\n  // once() and onAny() take an options object — consistent with on(), extensible for future options.\n  function once<K extends EventKey<T>>(\n    event: K,\n    listener: Listener<T[K]>,\n    opts?: { signal?: AbortSignal },\n  ): () => void {\n    return onceWithSignal(event, listener, mergeSignal(opts?.signal));\n  }\n\n  function onAny(listener: (event: EventKey<T>, payload: unknown) => void, opts?: SubscribeOptions): () => void {\n    const signal = mergeSignal(opts?.signal);\n\n    if (opts?.once) return onAnyWithOnce(listener, signal);\n\n    return onAnyWithSignal(listener, signal);\n  }\n\n  function wait<K extends EventKey<T>>(event: K, opts?: { signal?: AbortSignal }): Promise<T[K]> {\n    const activeSignal = mergeSignal(opts?.signal);\n\n    if (activeSignal.aborted) return Promise.reject(activeSignal.reason);\n\n    return new Promise<T[K]>((resolve, reject) => {\n      function onAbort() {\n        reject(activeSignal.reason);\n      }\n\n      onceWithSignal(\n        event,\n        (payload) => {\n          activeSignal.removeEventListener('abort', onAbort);\n          resolve(payload);\n        },\n        activeSignal,\n      );\n\n      activeSignal.addEventListener('abort', onAbort, { once: true });\n    });\n  }\n\n  // events() subscribes eagerly — the listener is registered when events() is called, not when\n  // the first .next() runs. This ensures events emitted before iteration begins are buffered.\n  // maxBuffer is validated synchronously so callers get a RangeError at call time.\n  function events<K extends EventKey<T>>(\n    event: K,\n    opts?: { maxBuffer?: number; signal?: AbortSignal },\n  ): EventStream<T[K]> {\n    const maxBuffer = opts?.maxBuffer ?? Infinity;\n\n    if (!(maxBuffer > 0)) throw new HeraldConfigError('maxBuffer must be a positive number');\n\n    const activeSignal = mergeSignal(opts?.signal);\n\n    if (activeSignal.aborted) {\n      const empty = (async function* (): AsyncGenerator<T[K]> {})();\n\n      return makeEventStream(empty, async (): Promise<void> => {});\n    }\n\n    const queue: T[K][] = [];\n    let wake: (() => void) | undefined;\n\n    const unsub = onWithSignal(\n      event,\n      (payload) => {\n        if (queue.length >= maxBuffer) queue.shift();\n\n        queue.push(payload);\n        wake?.();\n      },\n      activeSignal,\n    );\n\n    async function* generate(): AsyncGenerator<T[K]> {\n      try {\n        while (!activeSignal.aborted) {\n          if (queue.length) {\n            yield queue.shift()!;\n            continue;\n          }\n\n          const { promise, resolve } = Promise.withResolvers<void>();\n          const abortHandler = (): void => {\n            resolve();\n          };\n\n          wake = resolve;\n          activeSignal.addEventListener('abort', abortHandler, { once: true });\n          await promise;\n          activeSignal.removeEventListener('abort', abortHandler);\n          wake = undefined;\n        }\n      } finally {\n        unsub();\n      }\n    }\n\n    const gen = generate();\n\n    // Symbol.asyncDispose calls unsub() directly because gen.return() only runs the finally\n    // block when the generator has been started (at least one next() call). The unsub guard\n    // (called = false in registerEntry) makes this idempotent.\n    return makeEventStream(gen, async (): Promise<void> => {\n      unsub();\n      await gen.return(undefined as unknown as T[K]);\n    });\n  }\n\n  // dispatch is defined at createBus() scope (once per bus, not per emit call) — consistent with\n  // callSafe. Receives event/payload/timestamp as arguments so it can be invoked from both the\n  // direct path and the middleware chain without capturing per-emit locals in a closure.\n  function dispatch(event: EventKey<T>, payload: unknown, timestamp: number): number {\n    options?._onDispatch?.(event, payload);\n\n    let count = 0;\n    // Only the first unforwarded error is kept — every listener still runs (see callSafe's\n    // doc comment) — then it's rethrown once the whole broadcast (specific + wildcard) is done.\n    let firstError: { err: unknown } | undefined;\n    const set = listeners.get(event);\n\n    if (set?.size) {\n      for (const entry of [...set]) {\n        const result = callSafe(() => entry.fn(payload), event, payload, timestamp);\n\n        if (result.threw && !firstError) firstError = { err: result.err };\n\n        count++;\n      }\n    }\n\n    if (wildcards.size) {\n      for (const entry of [...wildcards]) {\n        const result = callSafe(() => entry.fn(event, payload), event, payload, timestamp);\n\n        if (result.threw && !firstError) firstError = { err: result.err };\n\n        count++;\n      }\n    }\n\n    if (firstError) throw firstError.err;\n\n    return count;\n  }\n\n  // emit() returns the number of listeners invoked (specific + wildcard).\n  // Returns 0 if bus is disposed, middleware blocked dispatch, or validatePayload rejected.\n  // validatePayload runs first, then middleware, then listeners.\n  function emit<K extends EventKey<T>>(event: K, ...args: T[K] extends void ? [] : [payload: T[K]]): number {\n    if (disposeController.signal.aborted) return 0;\n\n    const payload = (args as unknown[])[0];\n    const timestamp = Date.now();\n\n    if (options?.validatePayload) {\n      try {\n        options.validatePayload(event, payload as T[K]);\n      } catch (err) {\n        if (options?.onError) {\n          options.onError({ err, event, payload, timestamp } as EmissionErrorContext<T>);\n\n          return 0;\n        }\n\n        throw err;\n      }\n    }\n\n    if (logDebug) {\n      const specific = listeners.get(event)?.size ?? 0;\n      const wild = wildcards.size;\n\n      logDebug(\n        `[herald:emit] emit(\"${event}\") — ${specific + wild} listener(s) (${specific} specific, ${wild} wildcard)`,\n      );\n    }\n\n    // Middleware pipeline — each middleware calls next() to proceed.\n    const middleware = options?.middleware;\n\n    if (middleware?.length) {\n      let dispatched = 0;\n      let i = 0;\n\n      // Guard prevents a misbehaving middleware from calling next() twice and\n      // triggering a double-dispatch to listeners. Note: a middleware calling next()\n      // more than twice can still invoke downstream middleware multiple times.\n      function next(): void {\n        const idx = i++;\n\n        if (idx < middleware!.length) middleware![idx](event, payload, next);\n        else if (idx === middleware!.length) dispatched = dispatch(event, payload, timestamp);\n      }\n\n      next();\n\n      return dispatched;\n    }\n\n    return dispatch(event, payload, timestamp);\n  }\n\n  // listenerCount counts specific-event listeners only.\n  // wildcardCount() is the separate accessor for onAny listeners.\n  function listenerCount(event?: EventKey<T>): number {\n    if (event !== undefined) return listeners.get(event)?.size ?? 0;\n\n    let total = 0;\n\n    for (const set of listeners.values()) total += set.size;\n\n    return total;\n  }\n\n  function wildcardCount(): number {\n    return wildcards.size;\n  }\n\n  function eventNames(): EventKey<T>[] {\n    return [...listeners.keys()] as EventKey<T>[];\n  }\n\n  function waitAny<K extends readonly [EventKey<T>, EventKey<T>, ...EventKey<T>[]]>(\n    eventList: K,\n    opts?: { signal?: AbortSignal },\n  ): Promise<WaitAnyResult<T, K>> {\n    if (eventList.length < 2) throw new HeraldConfigError('waitAny() requires at least 2 event keys');\n\n    const activeSignal = mergeSignal(opts?.signal);\n\n    if (activeSignal.aborted) return Promise.reject(activeSignal.reason);\n\n    return new Promise<WaitAnyResult<T, K>>((resolve, reject) => {\n      const raceController = new AbortController();\n      const raceSignal = combineSignals(activeSignal, raceController.signal);\n\n      function onAbort() {\n        raceController.abort();\n        reject(activeSignal.reason);\n      }\n\n      activeSignal.addEventListener('abort', onAbort, { once: true });\n\n      for (const event of eventList) {\n        onceWithSignal(\n          event as EventKey<T>,\n          (payload) => {\n            activeSignal.removeEventListener('abort', onAbort);\n            raceController.abort();\n            resolve({ event, payload } as WaitAnyResult<T, K>);\n          },\n          raceSignal,\n        );\n      }\n    });\n  }\n\n  function dispose(): void {\n    if (disposeController.signal.aborted) return;\n\n    logDebug?.('[herald:lifecycle] dispose()');\n\n    disposeController.abort(new BusDisposedError(busName));\n    // disposeController.abort() fires all unsub handlers synchronously, which\n    // removes every entry and deletes empty keys. By here both maps are already\n    // empty. clear() is a cheap defensive measure against any future code path\n    // that bypasses the signal (e.g. a direct listeners.set() before a guard).\n    listeners.clear();\n    wildcards.clear();\n  }\n\n  return {\n    get disposalSignal() {\n      return disposeController.signal;\n    },\n    dispose,\n    get disposed() {\n      return disposeController.signal.aborted;\n    },\n    emit,\n    eventNames,\n    events,\n    listenerCount,\n    on,\n    onAny,\n    once,\n    [Symbol.dispose]: dispose,\n    wait,\n    waitAny,\n    wildcardCount,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"bus.js","names":[],"sources":["../src/bus.ts"],"sourcesContent":["import type {\n  Bus,\n  BusOptions,\n  EmissionErrorContext,\n  EventKey,\n  EventMap,\n  EventStream,\n  Listener,\n  SubscribeOptions,\n  Unsubscribe,\n  WaitAnyResult,\n} from './types';\n\nimport { warn as _internalWarn } from './_dev';\nimport { type SafeCallResult, callSafely } from './_safe';\nimport { BusDisposedError, HeraldConfigError } from './errors';\n\n// Module-scoped noop — shared across all bus instances to avoid per-bus allocation.\n// @internal — exported only for sibling internal modules; stripped from public declarations via stripInternal.\n/** @internal */\nexport const noop = () => {};\n\n/** @internal */\nexport type SignalScope = { dispose(): void; signal: AbortSignal };\n\n/** @internal */\nexport function createSignalScope(...candidates: Array<AbortSignal | undefined>): SignalScope {\n  const signals = candidates.filter((signal): signal is AbortSignal => signal !== undefined);\n\n  if (signals.length === 1) return { dispose: noop, signal: signals[0]! };\n\n  const aborted = signals.find((signal) => signal.aborted);\n\n  if (aborted) return { dispose: noop, signal: aborted };\n\n  const controller = new AbortController();\n  const listeners = new Map<AbortSignal, () => void>();\n  let disposed = false;\n\n  function dispose(): void {\n    if (disposed) return;\n\n    disposed = true;\n    for (const [signal, listener] of listeners) signal.removeEventListener('abort', listener);\n    listeners.clear();\n  }\n\n  for (const signal of signals) {\n    const listener = () => {\n      controller.abort(signal.reason);\n      dispose();\n    };\n\n    listeners.set(signal, listener);\n    signal.addEventListener('abort', listener, { once: true });\n  }\n\n  return { dispose, signal: controller.signal };\n}\n\n/**\n * Returns a signal that aborts as soon as any provided signal aborts.\n * Input listeners remain active until one input aborts; use signal-owning APIs for early cleanup.\n */\nexport function combineSignals(first: AbortSignal, ...rest: AbortSignal[]): AbortSignal {\n  return createSignalScope(first, ...rest).signal;\n}\n\n// Each registration gets a unique Entry object, allowing the same listener function\n// to be registered multiple times independently (aligns with Node EventEmitter / mitt).\ntype Entry = { fn: Listener<unknown>; unsub: () => void };\ntype WildcardEntry = { fn: (event: string, payload: unknown) => void; unsub: () => void };\n\ntype RegisterEntryOpts = { offLog: string; onLog: string; onRemove?: () => void };\n\n// makeEventStream wraps an AsyncGenerator with AsyncDisposable.\nfunction makeEventStream<V>(gen: AsyncGenerator<V>, onDispose: () => Promise<void>): EventStream<V> {\n  return Object.assign(gen, {\n    [Symbol.asyncDispose]: onDispose,\n  }) as unknown as EventStream<V>;\n}\n\n/** @internal */\nexport type InternalBusOptions<T extends EventMap> = BusOptions<T> & {\n  /** @internal Called after middleware passes, before listeners run. Used by TestBus. */\n  _onDispatch?: (event: EventKey<T>, payload: unknown) => void;\n};\n\nexport function createBus<T extends EventMap = Record<string, unknown>>(options?: InternalBusOptions<T>): Bus<T> {\n  // Per-event set of Entry objects. Set identity prevents accidental dedup of entries;\n  // the same fn can appear in multiple entries with independent lifetimes.\n  const listeners = new Map<string, Set<Entry>>();\n  const wildcards = new Set<WildcardEntry>();\n  const disposeController = new AbortController();\n  const busName = options?.name;\n  const maxListeners = options?.maxListeners;\n  const rawDebug = options?.logger?.debug;\n  const logDebug = rawDebug && busName ? (msg: string) => rawDebug(`${msg} (${busName})`) : rawDebug;\n  const hasLogger = options?.logger !== undefined;\n  const customLogWarn = options?.logger?.warn;\n  const busTag = busName ? ` (${busName})` : '';\n\n  function doWarn(msg: string): void {\n    if (customLogWarn) {\n      customLogWarn(msg);\n    } else if (!hasLogger) {\n      _internalWarn(msg);\n    }\n  }\n\n  function createSubscriptionScope(signal?: AbortSignal): SignalScope {\n    return signal\n      ? createSignalScope(disposeController.signal, signal)\n      : { dispose: noop, signal: disposeController.signal };\n  }\n\n  // callSafe is defined once per bus (not per emit) — avoids re-allocating on every emission.\n  // Captures options.onError via closure. Used in emit() for both specific and wildcard loops.\n  // Does not rethrow directly — see dispatch(), which continues the broadcast to every remaining\n  // listener (including wildcards) before rethrowing the first captured error, if any.\n  function callSafe(fn: () => void, event: EventKey<T>, payload: unknown, timestamp: number): SafeCallResult {\n    const onError = options?.onError\n      ? (err: unknown) => options.onError!({ err, event, payload, timestamp } as EmissionErrorContext<T>)\n      : undefined;\n\n    return callSafely(fn, onError);\n  }\n\n  // registerEntry opts object — self-documenting call sites.\n  function registerEntry<E extends { unsub: () => void }>(\n    container: Set<E>,\n    makeEntry: (unsub: () => void) => E,\n    signal: AbortSignal,\n    { offLog, onLog, onRemove }: RegisterEntryOpts,\n  ): () => void {\n    if (signal.aborted) return noop;\n\n    // Boolean guard makes unsub idempotent — a second call after re-registration would\n    // otherwise see an empty container and incorrectly delete the outer map entry.\n    let called = false;\n\n    function unsub() {\n      if (called) return;\n\n      called = true;\n      container.delete(entry);\n      onRemove?.();\n      signal.removeEventListener('abort', unsub);\n\n      logDebug?.(`[herald:sub] ${offLog} — ${container.size} listener(s) remaining`);\n    }\n\n    // Function declaration is hoisted so `entry` can reference `unsub` directly.\n    const entry = makeEntry(unsub);\n\n    container.add(entry);\n    signal.addEventListener('abort', unsub, { once: true });\n\n    logDebug?.(`[herald:sub] ${onLog} — ${container.size} listener(s)`);\n\n    if (maxListeners !== undefined && container.size > maxListeners) {\n      doWarn(\n        `${onLog} has ${container.size} listeners, exceeding maxListeners (${maxListeners}). Possible memory leak.${busTag}`,\n      );\n    }\n\n    return unsub;\n  }\n\n  function onWithSignal<K extends EventKey<T>>(\n    event: K,\n    listener: Listener<T[K]>,\n    signal: AbortSignal,\n    onRemove?: () => void,\n  ): () => void {\n    let set = listeners.get(event);\n\n    if (!set) {\n      set = new Set();\n      listeners.set(event, set);\n    }\n\n    // Capture the set reference so unsub can safely delete from it even after\n    // the event key has been removed from the outer map.\n    const capturedSet = set;\n\n    return registerEntry(capturedSet, (unsub) => ({ fn: listener as Listener<unknown>, unsub }), signal, {\n      offLog: `off(\"${event}\")`,\n      onLog: `on(\"${event}\")`,\n      onRemove: () => {\n        if (capturedSet.size === 0) listeners.delete(event);\n\n        onRemove?.();\n      },\n    });\n  }\n\n  function onAnyWithSignal(\n    listener: (event: EventKey<T>, payload: unknown) => void,\n    signal: AbortSignal,\n    onRemove?: () => void,\n  ): () => void {\n    return registerEntry(\n      wildcards,\n      (unsub) => ({ fn: listener as (event: string, payload: unknown) => void, unsub }),\n      signal,\n      { offLog: 'onAny off', onLog: 'onAny', onRemove },\n    );\n  }\n\n  // Use a const ref object to hold the unsub handle — avoids the forward-reference that\n  // TypeScript cannot prove safe with `const unsub = f(() => unsub)`. The `ref` binding never\n  // changes (only its property is mutated), satisfying prefer-const. By the time the inner\n  // callback fires (only possible after onWithSignal returns), ref.unsub is the real handle.\n  function onceWithSignal<K extends EventKey<T>>(\n    event: K,\n    listener: Listener<T[K]>,\n    signal: AbortSignal,\n    onRemove?: () => void,\n  ): () => void {\n    const ref = { unsub: noop as Unsubscribe };\n\n    ref.unsub = onWithSignal(\n      event,\n      (payload) => {\n        ref.unsub();\n        listener(payload);\n      },\n      signal,\n      onRemove,\n    );\n\n    return ref.unsub;\n  }\n\n  // onAny with once — fires the wildcard listener exactly once, then auto-removes.\n  function onAnyWithOnce(\n    listener: (event: EventKey<T>, payload: unknown) => void,\n    signal: AbortSignal,\n    onRemove?: () => void,\n  ): () => void {\n    const ref = { unsub: noop as Unsubscribe };\n\n    ref.unsub = onAnyWithSignal(\n      (event, payload) => {\n        ref.unsub();\n        listener(event, payload);\n      },\n      signal,\n      onRemove,\n    );\n\n    return ref.unsub;\n  }\n\n  function on<K extends EventKey<T>>(event: K, listener: Listener<T[K]>, opts?: SubscribeOptions): () => void {\n    const scope = createSubscriptionScope(opts?.signal);\n\n    if (opts?.once) return onceWithSignal(event, listener, scope.signal, scope.dispose);\n\n    return onWithSignal(event, listener, scope.signal, scope.dispose);\n  }\n\n  function once<K extends EventKey<T>>(\n    event: K,\n    listener: Listener<T[K]>,\n    opts?: { signal?: AbortSignal },\n  ): () => void {\n    const scope = createSubscriptionScope(opts?.signal);\n\n    return onceWithSignal(event, listener, scope.signal, scope.dispose);\n  }\n\n  function onAny(listener: (event: EventKey<T>, payload: unknown) => void, opts?: SubscribeOptions): () => void {\n    const scope = createSubscriptionScope(opts?.signal);\n\n    if (opts?.once) return onAnyWithOnce(listener, scope.signal, scope.dispose);\n\n    return onAnyWithSignal(listener, scope.signal, scope.dispose);\n  }\n\n  function wait<K extends EventKey<T>>(event: K, opts?: { signal?: AbortSignal }): Promise<T[K]> {\n    const scope = createSubscriptionScope(opts?.signal);\n\n    if (scope.signal.aborted) return Promise.reject(scope.signal.reason);\n\n    return new Promise<T[K]>((resolve, reject) => {\n      const onAbort = () => {\n        scope.dispose();\n        reject(scope.signal.reason);\n      };\n\n      onceWithSignal(\n        event,\n        (payload) => {\n          scope.signal.removeEventListener('abort', onAbort);\n          scope.dispose();\n          resolve(payload);\n        },\n        scope.signal,\n      );\n\n      scope.signal.addEventListener('abort', onAbort, { once: true });\n    });\n  }\n\n  // events() subscribes eagerly — the listener is registered when events() is called, not when\n  // the first .next() runs. This ensures events emitted before iteration begins are buffered.\n  // maxBuffer is validated synchronously so callers get a RangeError at call time.\n  function events<K extends EventKey<T>>(\n    event: K,\n    opts?: { maxBuffer?: number; signal?: AbortSignal },\n  ): EventStream<T[K]> {\n    const maxBuffer = opts?.maxBuffer ?? Infinity;\n\n    if (!(maxBuffer > 0)) throw new HeraldConfigError('maxBuffer must be a positive number');\n\n    const scope = createSubscriptionScope(opts?.signal);\n    const activeSignal = scope.signal;\n\n    if (activeSignal.aborted) {\n      const empty = (async function* (): AsyncGenerator<T[K]> {})();\n\n      return makeEventStream(empty, async (): Promise<void> => {});\n    }\n\n    const queue: T[K][] = [];\n    let wake: (() => void) | undefined;\n\n    const unsub = onWithSignal(\n      event,\n      (payload) => {\n        if (queue.length >= maxBuffer) queue.shift();\n\n        queue.push(payload);\n        wake?.();\n      },\n      activeSignal,\n      scope.dispose,\n    );\n\n    async function* generate(): AsyncGenerator<T[K]> {\n      try {\n        while (!activeSignal.aborted) {\n          if (queue.length) {\n            yield queue.shift()!;\n            continue;\n          }\n\n          const { promise, resolve } = Promise.withResolvers<void>();\n          const abortHandler = (): void => {\n            resolve();\n          };\n\n          wake = resolve;\n          activeSignal.addEventListener('abort', abortHandler, { once: true });\n          await promise;\n          activeSignal.removeEventListener('abort', abortHandler);\n          wake = undefined;\n        }\n      } finally {\n        unsub();\n      }\n    }\n\n    const gen = generate();\n\n    // Symbol.asyncDispose calls unsub() directly because gen.return() only runs the finally\n    // block when the generator has been started (at least one next() call). The unsub guard\n    // (called = false in registerEntry) makes this idempotent.\n    return makeEventStream(gen, async (): Promise<void> => {\n      unsub();\n      await gen.return(undefined as unknown as T[K]);\n    });\n  }\n\n  // dispatch is defined at createBus() scope (once per bus, not per emit call) — consistent with\n  // callSafe. Receives event/payload/timestamp as arguments so it can be invoked from both the\n  // direct path and the middleware chain without capturing per-emit locals in a closure.\n  function dispatch(event: EventKey<T>, payload: unknown, timestamp: number): number {\n    options?._onDispatch?.(event, payload);\n\n    let count = 0;\n    // Only the first unforwarded error is kept — every listener still runs (see callSafe's\n    // doc comment) — then it's rethrown once the whole broadcast (specific + wildcard) is done.\n    let firstError: { err: unknown } | undefined;\n    const set = listeners.get(event);\n\n    if (set?.size) {\n      for (const entry of [...set]) {\n        const result = callSafe(() => entry.fn(payload), event, payload, timestamp);\n\n        if (result.threw && !firstError) firstError = { err: result.err };\n\n        count++;\n      }\n    }\n\n    if (wildcards.size) {\n      for (const entry of [...wildcards]) {\n        const result = callSafe(() => entry.fn(event, payload), event, payload, timestamp);\n\n        if (result.threw && !firstError) firstError = { err: result.err };\n\n        count++;\n      }\n    }\n\n    if (firstError) throw firstError.err;\n\n    return count;\n  }\n\n  // emit() returns the number of listeners invoked (specific + wildcard).\n  // Returns 0 if bus is disposed, middleware blocked dispatch, or validatePayload rejected.\n  // validatePayload runs first, then middleware, then listeners.\n  function emit<K extends EventKey<T>>(event: K, ...args: T[K] extends void ? [] : [payload: T[K]]): number {\n    if (disposeController.signal.aborted) return 0;\n\n    const payload = (args as unknown[])[0];\n    const timestamp = Date.now();\n\n    if (options?.validatePayload) {\n      try {\n        options.validatePayload(event, payload as T[K]);\n      } catch (err) {\n        if (options?.onError) {\n          options.onError({ err, event, payload, timestamp } as EmissionErrorContext<T>);\n\n          return 0;\n        }\n\n        throw err;\n      }\n    }\n\n    if (logDebug) {\n      const specific = listeners.get(event)?.size ?? 0;\n      const wild = wildcards.size;\n\n      logDebug(\n        `[herald:emit] emit(\"${event}\") — ${specific + wild} listener(s) (${specific} specific, ${wild} wildcard)`,\n      );\n    }\n\n    const middleware = options?.middleware;\n\n    if (!middleware?.length) return dispatch(event, payload, timestamp);\n\n    const middlewareList = middleware;\n\n    function run(index: number): number {\n      const current = middlewareList[index];\n\n      if (!current) return dispatch(event, payload, timestamp);\n\n      let result = 0;\n      let continued = false;\n      let synchronous = true;\n\n      current(event, payload, () => {\n        if (!synchronous || continued) return;\n\n        continued = true;\n        result = run(index + 1);\n      });\n\n      synchronous = false;\n\n      return result;\n    }\n\n    return run(0);\n  }\n\n  // listenerCount counts specific-event listeners only.\n  // wildcardCount() is the separate accessor for onAny listeners.\n  function listenerCount(event?: EventKey<T>): number {\n    if (event !== undefined) return listeners.get(event)?.size ?? 0;\n\n    let total = 0;\n\n    for (const set of listeners.values()) total += set.size;\n\n    return total;\n  }\n\n  function wildcardCount(): number {\n    return wildcards.size;\n  }\n\n  function eventNames(): EventKey<T>[] {\n    return [...listeners.keys()] as EventKey<T>[];\n  }\n\n  function waitAny<K extends readonly [EventKey<T>, EventKey<T>, ...EventKey<T>[]]>(\n    eventList: K,\n    opts?: { signal?: AbortSignal },\n  ): Promise<WaitAnyResult<T, K>> {\n    if (eventList.length < 2) throw new HeraldConfigError('waitAny() requires at least 2 event keys');\n\n    const activeScope = createSubscriptionScope(opts?.signal);\n\n    if (activeScope.signal.aborted) return Promise.reject(activeScope.signal.reason);\n\n    return new Promise<WaitAnyResult<T, K>>((resolve, reject) => {\n      const raceController = new AbortController();\n      const raceScope = createSignalScope(activeScope.signal, raceController.signal);\n      const unsubs: Unsubscribe[] = [];\n      let settled = false;\n\n      function cleanup(): void {\n        activeScope.signal.removeEventListener('abort', onAbort);\n        raceController.abort();\n        raceScope.dispose();\n        activeScope.dispose();\n        for (const unsub of unsubs) unsub();\n      }\n\n      function onAbort(): void {\n        if (settled) return;\n\n        settled = true;\n        cleanup();\n        reject(activeScope.signal.reason);\n      }\n\n      activeScope.signal.addEventListener('abort', onAbort, { once: true });\n\n      for (const event of eventList) {\n        unsubs.push(\n          onceWithSignal(\n            event as EventKey<T>,\n            (payload) => {\n              if (settled) return;\n\n              settled = true;\n              cleanup();\n              resolve({ event, payload } as WaitAnyResult<T, K>);\n            },\n            raceScope.signal,\n          ),\n        );\n      }\n    });\n  }\n\n  function dispose(): void {\n    if (disposeController.signal.aborted) return;\n\n    logDebug?.('[herald:lifecycle] dispose()');\n\n    disposeController.abort(new BusDisposedError(busName));\n    // disposeController.abort() fires all unsub handlers synchronously, which\n    // removes every entry and deletes empty keys. By here both maps are already\n    // empty. clear() is a cheap defensive measure against any future code path\n    // that bypasses the signal (e.g. a direct listeners.set() before a guard).\n    listeners.clear();\n    wildcards.clear();\n  }\n\n  return {\n    get disposalSignal() {\n      return disposeController.signal;\n    },\n    dispose,\n    get disposed() {\n      return disposeController.signal.aborted;\n    },\n    emit,\n    eventNames,\n    events,\n    listenerCount,\n    on,\n    onAny,\n    once,\n    [Symbol.dispose]: dispose,\n    wait,\n    waitAny,\n    wildcardCount,\n  };\n}\n"],"mappings":";;;;AAoBA,IAAa,UAAa,CAAC;AAM3B,SAAgB,EAAkB,GAAG,GAAyD;CAC5F,IAAM,IAAU,EAAW,QAAQ,MAAkC,MAAW,KAAA,CAAS;CAEzF,IAAI,EAAQ,WAAW,GAAG,OAAO;EAAE,SAAS;EAAM,QAAQ,EAAQ;CAAI;CAEtE,IAAM,IAAU,EAAQ,MAAM,MAAW,EAAO,OAAO;CAEvD,IAAI,GAAS,OAAO;EAAE,SAAS;EAAM,QAAQ;CAAQ;CAErD,IAAM,IAAa,IAAI,gBAAgB,GACjC,oBAAY,IAAI,IAA6B,GAC/C,IAAW;CAEf,SAAS,IAAgB;EACnB,QAEJ;OAAW;GACX,KAAK,IAAM,CAAC,GAAQ,MAAa,GAAW,EAAO,oBAAoB,SAAS,CAAQ;GACxF,EAAU,MAAM;EAFL;CAGb;CAEA,KAAK,IAAM,KAAU,GAAS;EAC5B,IAAM,UAAiB;GAErB,AADA,EAAW,MAAM,EAAO,MAAM,GAC9B,EAAQ;EACV;EAGA,AADA,EAAU,IAAI,GAAQ,CAAQ,GAC9B,EAAO,iBAAiB,SAAS,GAAU,EAAE,MAAM,GAAK,CAAC;CAC3D;CAEA,OAAO;EAAE;EAAS,QAAQ,EAAW;CAAO;AAC9C;AAMA,SAAgB,EAAe,GAAoB,GAAG,GAAkC;CACtF,OAAO,EAAkB,GAAO,GAAG,CAAI,CAAC,CAAC;AAC3C;AAUA,SAAS,EAAmB,GAAwB,GAAgD;CAClG,OAAO,OAAO,OAAO,GAAK,GACvB,OAAO,eAAe,EACzB,CAAC;AACH;AAQA,SAAgB,EAAwD,GAAyC;CAG/G,IAAM,oBAAY,IAAI,IAAwB,GACxC,oBAAY,IAAI,IAAmB,GACnC,IAAoB,IAAI,gBAAgB,GACxC,IAAU,GAAS,MACnB,IAAe,GAAS,cACxB,IAAW,GAAS,QAAQ,OAC5B,IAAW,KAAY,KAAW,MAAgB,EAAS,GAAG,EAAI,IAAI,EAAQ,EAAE,IAAI;CACxE,GAAS;CAP3B,IAQM,IAAgB,GAAS,QAAQ,MACjC,IAAS,IAAU,KAAK,EAAQ,KAAK;CAE3C,SAAS,EAAO,GAAmB;EACjC,AAAI,KACF,EAAc,CAAG;CAIrB;CAEA,SAAS,EAAwB,GAAmC;EAClE,OAAO,IACH,EAAkB,EAAkB,QAAQ,CAAM,IAClD;GAAE,SAAS;GAAM,QAAQ,EAAkB;EAAO;CACxD;CAMA,SAAS,EAAS,GAAgB,GAAoB,GAAkB,GAAmC;EACzG,IAAM,IAAU,GAAS,WACpB,MAAiB,EAAQ,QAAS;GAAE;GAAK;GAAO;GAAS;EAAU,CAA4B,IAChG,KAAA;EAEJ,OAAO,EAAW,GAAI,CAAO;CAC/B;CAGA,SAAS,EACP,GACA,GACA,GACA,EAAE,WAAQ,UAAO,eACL;EACZ,IAAI,EAAO,SAAS,OAAO;EAI3B,IAAI,IAAS;EAEb,SAAS,IAAQ;GACX,MAEJ,IAAS,IACT,EAAU,OAAO,CAAK,GACtB,IAAW,GACX,EAAO,oBAAoB,SAAS,CAAK,GAEzC,IAAW,gBAAgB,EAAO,KAAK,EAAU,KAAK,uBAAuB;EAC/E;EAGA,IAAM,IAAQ,EAAU,CAAK;EAa7B,OAXA,EAAU,IAAI,CAAK,GACnB,EAAO,iBAAiB,SAAS,GAAO,EAAE,MAAM,GAAK,CAAC,GAEtD,IAAW,gBAAgB,EAAM,KAAK,EAAU,KAAK,aAAa,GAE9D,MAAiB,KAAA,KAAa,EAAU,OAAO,KACjD,EACE,GAAG,EAAM,OAAO,EAAU,KAAK,sCAAsC,EAAa,0BAA0B,GAC9G,GAGK;CACT;CAEA,SAAS,EACP,GACA,GACA,GACA,GACY;EACZ,IAAI,IAAM,EAAU,IAAI,CAAK;EAE7B,AAAK,MACH,oBAAM,IAAI,IAAI,GACd,EAAU,IAAI,GAAO,CAAG;EAK1B,IAAM,IAAc;EAEpB,OAAO,EAAc,IAAc,OAAW;GAAE,IAAI;GAA+B;EAAM,IAAI,GAAQ;GACnG,QAAQ,QAAQ,EAAM;GACtB,OAAO,OAAO,EAAM;GACpB,gBAAgB;IAGd,AAFI,EAAY,SAAS,KAAG,EAAU,OAAO,CAAK,GAElD,IAAW;GACb;EACF,CAAC;CACH;CAEA,SAAS,EACP,GACA,GACA,GACY;EACZ,OAAO,EACL,IACC,OAAW;GAAE,IAAI;GAAuD;EAAM,IAC/E,GACA;GAAE,QAAQ;GAAa,OAAO;GAAS;EAAS,CAClD;CACF;CAMA,SAAS,EACP,GACA,GACA,GACA,GACY;EACZ,IAAM,IAAM,EAAE,OAAO,EAAoB;EAYzC,OAVA,EAAI,QAAQ,EACV,IACC,MAAY;GAEX,AADA,EAAI,MAAM,GACV,EAAS,CAAO;EAClB,GACA,GACA,CACF,GAEO,EAAI;CACb;CAGA,SAAS,EACP,GACA,GACA,GACY;EACZ,IAAM,IAAM,EAAE,OAAO,EAAoB;EAWzC,OATA,EAAI,QAAQ,GACT,GAAO,MAAY;GAElB,AADA,EAAI,MAAM,GACV,EAAS,GAAO,CAAO;EACzB,GACA,GACA,CACF,GAEO,EAAI;CACb;CAEA,SAAS,EAA0B,GAAU,GAA0B,GAAqC;EAC1G,IAAM,IAAQ,EAAwB,GAAM,MAAM;EAIlD,OAFI,GAAM,OAAa,EAAe,GAAO,GAAU,EAAM,QAAQ,EAAM,OAAO,IAE3E,EAAa,GAAO,GAAU,EAAM,QAAQ,EAAM,OAAO;CAClE;CAEA,SAAS,EACP,GACA,GACA,GACY;EACZ,IAAM,IAAQ,EAAwB,GAAM,MAAM;EAElD,OAAO,EAAe,GAAO,GAAU,EAAM,QAAQ,EAAM,OAAO;CACpE;CAEA,SAAS,EAAM,GAA0D,GAAqC;EAC5G,IAAM,IAAQ,EAAwB,GAAM,MAAM;EAIlD,OAFI,GAAM,OAAa,EAAc,GAAU,EAAM,QAAQ,EAAM,OAAO,IAEnE,EAAgB,GAAU,EAAM,QAAQ,EAAM,OAAO;CAC9D;CAEA,SAAS,EAA4B,GAAU,GAAgD;EAC7F,IAAM,IAAQ,EAAwB,GAAM,MAAM;EAIlD,OAFI,EAAM,OAAO,UAAgB,QAAQ,OAAO,EAAM,OAAO,MAAM,IAE5D,IAAI,SAAe,GAAS,MAAW;GAC5C,IAAM,UAAgB;IAEpB,AADA,EAAM,QAAQ,GACd,EAAO,EAAM,OAAO,MAAM;GAC5B;GAYA,AAVA,EACE,IACC,MAAY;IAGX,AAFA,EAAM,OAAO,oBAAoB,SAAS,CAAO,GACjD,EAAM,QAAQ,GACd,EAAQ,CAAO;GACjB,GACA,EAAM,MACR,GAEA,EAAM,OAAO,iBAAiB,SAAS,GAAS,EAAE,MAAM,GAAK,CAAC;EAChE,CAAC;CACH;CAKA,SAAS,EACP,GACA,GACmB;EACnB,IAAM,IAAY,GAAM,aAAa;EAErC,IAAI,EAAE,IAAY,IAAI,MAAM,IAAI,EAAkB,qCAAqC;EAEvF,IAAM,IAAQ,EAAwB,GAAM,MAAM,GAC5C,IAAe,EAAM;EAE3B,IAAI,EAAa,SAGf,OAAO,GAFQ,mBAAyC,CAAC,EAAA,CAElC,GAAO,YAA2B,CAAC,CAAC;EAG7D,IAAM,IAAgB,CAAC,GACnB,GAEE,IAAQ,EACZ,IACC,MAAY;GAIX,AAHI,EAAM,UAAU,KAAW,EAAM,MAAM,GAE3C,EAAM,KAAK,CAAO,GAClB,IAAO;EACT,GACA,GACA,EAAM,OACR;EAEA,gBAAgB,IAAiC;GAC/C,IAAI;IACF,OAAO,CAAC,EAAa,UAAS;KAC5B,IAAI,EAAM,QAAQ;MAChB,MAAM,EAAM,MAAM;MAClB;KACF;KAEA,IAAM,EAAE,YAAS,eAAY,QAAQ,cAAoB,GACnD,UAA2B;MAC/B,EAAQ;KACV;KAMA,AAJA,IAAO,GACP,EAAa,iBAAiB,SAAS,GAAc,EAAE,MAAM,GAAK,CAAC,GACnE,MAAM,GACN,EAAa,oBAAoB,SAAS,CAAY,GACtD,IAAO,KAAA;IACT;GACF,UAAU;IACR,EAAM;GACR;EACF;EAEA,IAAM,IAAM,EAAS;EAKrB,OAAO,EAAgB,GAAK,YAA2B;GAErD,AADA,EAAM,GACN,MAAM,EAAI,OAAO,KAAA,CAA4B;EAC/C,CAAC;CACH;CAKA,SAAS,EAAS,GAAoB,GAAkB,GAA2B;EACjF,GAAS,cAAc,GAAO,CAAO;EAErC,IAAI,IAAQ,GAGR,GACE,IAAM,EAAU,IAAI,CAAK;EAE/B,IAAI,GAAK,MACP,KAAK,IAAM,KAAS,CAAC,GAAG,CAAG,GAAG;GAC5B,IAAM,IAAS,QAAe,EAAM,GAAG,CAAO,GAAG,GAAO,GAAS,CAAS;GAI1E,AAFI,EAAO,SAAS,CAAC,MAAY,IAAa,EAAE,KAAK,EAAO,IAAI,IAEhE;EACF;EAGF,IAAI,EAAU,MACZ,KAAK,IAAM,KAAS,CAAC,GAAG,CAAS,GAAG;GAClC,IAAM,IAAS,QAAe,EAAM,GAAG,GAAO,CAAO,GAAG,GAAO,GAAS,CAAS;GAIjF,AAFI,EAAO,SAAS,CAAC,MAAY,IAAa,EAAE,KAAK,EAAO,IAAI,IAEhE;EACF;EAGF,IAAI,GAAY,MAAM,EAAW;EAEjC,OAAO;CACT;CAKA,SAAS,EAA4B,GAAU,GAAG,GAAwD;EACxG,IAAI,EAAkB,OAAO,SAAS,OAAO;EAE7C,IAAM,IAAW,EAAmB,IAC9B,IAAY,KAAK,IAAI;EAE3B,IAAI,GAAS,iBACX,IAAI;GACF,EAAQ,gBAAgB,GAAO,CAAe;EAChD,SAAS,GAAK;GACZ,IAAI,GAAS,SAGX,OAFA,EAAQ,QAAQ;IAAE;IAAK;IAAO;IAAS;GAAU,CAA4B,GAEtE;GAGT,MAAM;EACR;EAGF,IAAI,GAAU;GACZ,IAAM,IAAW,EAAU,IAAI,CAAK,CAAC,EAAE,QAAQ,GACzC,IAAO,EAAU;GAEvB,EACE,uBAAuB,EAAM,OAAO,IAAW,EAAK,gBAAgB,EAAS,aAAa,EAAK,WACjG;EACF;EAEA,IAAM,IAAa,GAAS;EAE5B,IAAI,CAAC,GAAY,QAAQ,OAAO,EAAS,GAAO,GAAS,CAAS;EAElE,IAAM,IAAiB;EAEvB,SAAS,EAAI,GAAuB;GAClC,IAAM,IAAU,EAAe;GAE/B,IAAI,CAAC,GAAS,OAAO,EAAS,GAAO,GAAS,CAAS;GAEvD,IAAI,IAAS,GACT,IAAY,IACZ,IAAc;GAWlB,OATA,EAAQ,GAAO,SAAe;IACxB,CAAC,KAAe,MAEpB,IAAY,IACZ,IAAS,EAAI,IAAQ,CAAC;GACxB,CAAC,GAED,IAAc,IAEP;EACT;EAEA,OAAO,EAAI,CAAC;CACd;CAIA,SAAS,EAAc,GAA6B;EAClD,IAAI,MAAU,KAAA,GAAW,OAAO,EAAU,IAAI,CAAK,CAAC,EAAE,QAAQ;EAE9D,IAAI,IAAQ;EAEZ,KAAK,IAAM,KAAO,EAAU,OAAO,GAAG,KAAS,EAAI;EAEnD,OAAO;CACT;CAEA,SAAS,IAAwB;EAC/B,OAAO,EAAU;CACnB;CAEA,SAAS,IAA4B;EACnC,OAAO,CAAC,GAAG,EAAU,KAAK,CAAC;CAC7B;CAEA,SAAS,EACP,GACA,GAC8B;EAC9B,IAAI,EAAU,SAAS,GAAG,MAAM,IAAI,EAAkB,0CAA0C;EAEhG,IAAM,IAAc,EAAwB,GAAM,MAAM;EAIxD,OAFI,EAAY,OAAO,UAAgB,QAAQ,OAAO,EAAY,OAAO,MAAM,IAExE,IAAI,SAA8B,GAAS,MAAW;GAC3D,IAAM,IAAiB,IAAI,gBAAgB,GACrC,IAAY,EAAkB,EAAY,QAAQ,EAAe,MAAM,GACvE,IAAwB,CAAC,GAC3B,IAAU;GAEd,SAAS,IAAgB;IAIvB,AAHA,EAAY,OAAO,oBAAoB,SAAS,CAAO,GACvD,EAAe,MAAM,GACrB,EAAU,QAAQ,GAClB,EAAY,QAAQ;IACpB,KAAK,IAAM,KAAS,GAAQ,EAAM;GACpC;GAEA,SAAS,IAAgB;IACnB,MAEJ,IAAU,IACV,EAAQ,GACR,EAAO,EAAY,OAAO,MAAM;GAClC;GAEA,EAAY,OAAO,iBAAiB,SAAS,GAAS,EAAE,MAAM,GAAK,CAAC;GAEpE,KAAK,IAAM,KAAS,GAClB,EAAO,KACL,EACE,IACC,MAAY;IACP,MAEJ,IAAU,IACV,EAAQ,GACR,EAAQ;KAAE;KAAO;IAAQ,CAAwB;GACnD,GACA,EAAU,MACZ,CACF;EAEJ,CAAC;CACH;CAEA,SAAS,IAAgB;EACnB,EAAkB,OAAO,YAE7B,IAAW,8BAA8B,GAEzC,EAAkB,MAAM,IAAI,EAAiB,CAAO,CAAC,GAKrD,EAAU,MAAM,GAChB,EAAU,MAAM;CAClB;CAEA,OAAO;EACL,IAAI,iBAAiB;GACnB,OAAO,EAAkB;EAC3B;EACA;EACA,IAAI,WAAW;GACb,OAAO,EAAkB,OAAO;EAClC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;GACC,OAAO,UAAU;EAClB;EACA;EACA;CACF;AACF"}

package/dist/devtools.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./bus.cjs"),t=require("./behavior-bus.cjs");function n(t){let{logger:n,...r}=t??{};return e.createBus({...r,logger:{debug:console.debug,warn:n?.warn}})}function r(e,n){let{logger:r,...i}=n??{};return t.createBehaviorBus(e,{...i,logger:{debug:console.debug,warn:r?.warn}})}exports.debugBehaviorBus=r,exports.debugBus=n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./bus.cjs");function t(t){let{logger:n,...r}=t??{};return e.createBus({...r,logger:{debug:console.debug,warn:n?.warn}})}exports.debugBus=t;
 //# sourceMappingURL=devtools.cjs.map

package/dist/devtools.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"devtools.cjs","names":[],"sources":["../src/devtools.ts"],"sourcesContent":["/**\n * @vielzeug/herald — debug utilities for bus visualisation.\n *\n * Import from the dedicated sub-path so it is tree-shaken from production bundles:\n * ```ts\n * import { debugBus } from '@vielzeug/herald/devtools';\n * ```\n */\n\nimport type { BehaviorBus, BehaviorBusOptions, BehaviorInitial, Bus, BusLogger, BusOptions, EventMap } from './types';\n\nimport { createBehaviorBus } from './behavior-bus';\nimport { createBus } from './bus';\n\n/**\n * Creates a {@link Bus} with debug logging pre-wired to `console.debug`.\n *\n * Equivalent to `createBus({ logger: { debug: console.debug } })` but imported\n * from a dedicated sub-path so `console.debug` references are tree-shaken from\n * production bundles when this sub-path is not imported.\n *\n * Logs subscription registrations/removals, emissions, and disposal with\n * `[herald:*]` prefixes. Pass `logger.warn` to also redirect or silence warnings.\n *\n * @example\n * ```ts\n * import { debugBus } from '@vielzeug/herald/devtools';\n *\n * const bus = debugBus<MyEvents>();\n * // or redirect to a custom logger:\n * const bus = debugBus<MyEvents>({ logger: { warn: myLogger.warn } });\n * ```\n */\nexport function debugBus<T extends EventMap>(\n  options?: Omit<BusOptions<T>, 'logger'> & { logger?: { warn?: BusLogger['warn'] } },\n): Bus<T> {\n  const { logger, ...rest } = options ?? {};\n\n  return createBus<T>({\n    ...rest,\n    logger: { debug: console.debug, warn: logger?.warn },\n  });\n}\n\n/**\n * Creates a {@link BehaviorBus} with debug logging pre-wired to `console.debug`.\n *\n * Equivalent to `createBehaviorBus(initial, { logger: { debug: console.debug } })` but imported\n * from a dedicated sub-path so `console.debug` references are tree-shaken from\n * production bundles when this sub-path is not imported.\n *\n * @example\n * ```ts\n * import { debugBehaviorBus } from '@vielzeug/herald/devtools';\n *\n * const bus = debugBehaviorBus<MyEvents>({ theme: 'light' });\n * // or redirect warnings:\n * const bus = debugBehaviorBus<MyEvents>({ theme: 'light' }, { logger: { warn: myLogger.warn } });\n * ```\n */\nexport function debugBehaviorBus<T extends EventMap>(\n  initial?: BehaviorInitial<T>,\n  options?: Omit<BehaviorBusOptions<T>, 'logger'> & { logger?: { warn?: BusLogger['warn'] } },\n): BehaviorBus<T> {\n  const { logger, ...rest } = options ?? {};\n\n  return createBehaviorBus<T>(initial, {\n    ...rest,\n    logger: { debug: console.debug, warn: logger?.warn },\n  });\n}\n"],"mappings":"gIAiCA,SAAgB,EACd,EACQ,CACR,GAAM,CAAE,SAAQ,GAAG,GAAS,GAAW,CAAC,EAExC,OAAO,EAAA,UAAa,CAClB,GAAG,EACH,OAAQ,CAAE,MAAO,QAAQ,MAAO,KAAM,GAAQ,IAAK,CACrD,CAAC,CACH,CAkBA,SAAgB,EACd,EACA,EACgB,CAChB,GAAM,CAAE,SAAQ,GAAG,GAAS,GAAW,CAAC,EAExC,OAAO,EAAA,kBAAqB,EAAS,CACnC,GAAG,EACH,OAAQ,CAAE,MAAO,QAAQ,MAAO,KAAM,GAAQ,IAAK,CACrD,CAAC,CACH"}
+{"version":3,"file":"devtools.cjs","names":[],"sources":["../src/devtools.ts"],"sourcesContent":["/**\n * @vielzeug/herald — debug utilities for bus visualisation.\n *\n * Import from the dedicated sub-path so it is tree-shaken from production bundles:\n * ```ts\n * import { debugBus } from '@vielzeug/herald/devtools';\n * ```\n */\n\nimport type { Bus, BusLogger, BusOptions, EventMap } from './types';\n\nimport { createBus } from './bus';\n\n/**\n * Creates a {@link Bus} with debug logging pre-wired to `console.debug`.\n *\n * Equivalent to `createBus({ logger: { debug: console.debug } })` but imported\n * from a dedicated sub-path so `console.debug` references are tree-shaken from\n * production bundles when this sub-path is not imported.\n *\n * Logs subscription registrations/removals, emissions, and disposal with\n * `[herald:*]` prefixes. Pass `logger.warn` to also redirect or silence warnings.\n *\n * @example\n * ```ts\n * import { debugBus } from '@vielzeug/herald/devtools';\n *\n * const bus = debugBus<MyEvents>();\n * // or redirect to a custom logger:\n * const bus = debugBus<MyEvents>({ logger: { warn: myLogger.warn } });\n * ```\n */\nexport function debugBus<T extends EventMap>(\n  options?: Omit<BusOptions<T>, 'logger'> & { logger?: { warn?: BusLogger['warn'] } },\n): Bus<T> {\n  const { logger, ...rest } = options ?? {};\n\n  return createBus<T>({\n    ...rest,\n    logger: { debug: console.debug, warn: logger?.warn },\n  });\n}\n"],"mappings":"gGAgCA,SAAgB,EACd,EACQ,CACR,GAAM,CAAE,SAAQ,GAAG,GAAS,GAAW,CAAC,EAExC,OAAO,EAAA,UAAa,CAClB,GAAG,EACH,OAAQ,CAAE,MAAO,QAAQ,MAAO,KAAM,GAAQ,IAAK,CACrD,CAAC,CACH"}

package/dist/devtools.d.ts

@@ -6,7 +6,7 @@
  * import { debugBus } from '@vielzeug/herald/devtools';
  * ```
  */
-import type { BehaviorBus, BehaviorBusOptions, BehaviorInitial, Bus, BusLogger, BusOptions, EventMap } from './types';
+import type { Bus, BusLogger, BusOptions, EventMap } from './types';
 /**
  * Creates a {@link Bus} with debug logging pre-wired to `console.debug`.
  *
@@ -31,25 +31,4 @@ export declare function debugBus<T extends EventMap>(options?: Omit<BusOptions<T
         warn?: BusLogger['warn'];
     };
 }): Bus<T>;
-/**
- * Creates a {@link BehaviorBus} with debug logging pre-wired to `console.debug`.
- *
- * Equivalent to `createBehaviorBus(initial, { logger: { debug: console.debug } })` but imported
- * from a dedicated sub-path so `console.debug` references are tree-shaken from
- * production bundles when this sub-path is not imported.
- *
- * @example
- * ```ts
- * import { debugBehaviorBus } from '@vielzeug/herald/devtools';
- *
- * const bus = debugBehaviorBus<MyEvents>({ theme: 'light' });
- * // or redirect warnings:
- * const bus = debugBehaviorBus<MyEvents>({ theme: 'light' }, { logger: { warn: myLogger.warn } });
- * ```
- */
-export declare function debugBehaviorBus<T extends EventMap>(initial?: BehaviorInitial<T>, options?: Omit<BehaviorBusOptions<T>, 'logger'> & {
-    logger?: {
-        warn?: BusLogger['warn'];
-    };
-}): BehaviorBus<T>;
 //# sourceMappingURL=devtools.d.ts.map

package/dist/devtools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"devtools.d.ts","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKtH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EACzC,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;KAAE,CAAA;CAAE,GAClF,GAAG,CAAC,CAAC,CAAC,CAOR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,QAAQ,EACjD,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;KAAE,CAAA;CAAE,GAC1F,WAAW,CAAC,CAAC,CAAC,CAOhB"}
+{"version":3,"file":"devtools.d.ts","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EACzC,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;KAAE,CAAA;CAAE,GAClF,GAAG,CAAC,CAAC,CAAC,CAOR"}

package/dist/devtools.js

@@ -1,7 +1,6 @@
 import { createBus as e } from "./bus.js";
-import { createBehaviorBus as t } from "./behavior-bus.js";
 //#region src/devtools.ts
-function n(t) {
+function t(t) {
 	let { logger: n, ...r } = t ?? {};
 	return e({
 		...r,
@@ -11,17 +10,7 @@ function n(t) {
 		}
 	});
 }
-function r(e, n) {
-	let { logger: r, ...i } = n ?? {};
-	return t(e, {
-		...i,
-		logger: {
-			debug: console.debug,
-			warn: r?.warn
-		}
-	});
-}
 //#endregion
-export { r as debugBehaviorBus, n as debugBus };
+export { t as debugBus };
 
 //# sourceMappingURL=devtools.js.map

package/dist/devtools.js.map

@@ -1 +1 @@
-{"version":3,"file":"devtools.js","names":[],"sources":["../src/devtools.ts"],"sourcesContent":["/**\n * @vielzeug/herald — debug utilities for bus visualisation.\n *\n * Import from the dedicated sub-path so it is tree-shaken from production bundles:\n * ```ts\n * import { debugBus } from '@vielzeug/herald/devtools';\n * ```\n */\n\nimport type { BehaviorBus, BehaviorBusOptions, BehaviorInitial, Bus, BusLogger, BusOptions, EventMap } from './types';\n\nimport { createBehaviorBus } from './behavior-bus';\nimport { createBus } from './bus';\n\n/**\n * Creates a {@link Bus} with debug logging pre-wired to `console.debug`.\n *\n * Equivalent to `createBus({ logger: { debug: console.debug } })` but imported\n * from a dedicated sub-path so `console.debug` references are tree-shaken from\n * production bundles when this sub-path is not imported.\n *\n * Logs subscription registrations/removals, emissions, and disposal with\n * `[herald:*]` prefixes. Pass `logger.warn` to also redirect or silence warnings.\n *\n * @example\n * ```ts\n * import { debugBus } from '@vielzeug/herald/devtools';\n *\n * const bus = debugBus<MyEvents>();\n * // or redirect to a custom logger:\n * const bus = debugBus<MyEvents>({ logger: { warn: myLogger.warn } });\n * ```\n */\nexport function debugBus<T extends EventMap>(\n  options?: Omit<BusOptions<T>, 'logger'> & { logger?: { warn?: BusLogger['warn'] } },\n): Bus<T> {\n  const { logger, ...rest } = options ?? {};\n\n  return createBus<T>({\n    ...rest,\n    logger: { debug: console.debug, warn: logger?.warn },\n  });\n}\n\n/**\n * Creates a {@link BehaviorBus} with debug logging pre-wired to `console.debug`.\n *\n * Equivalent to `createBehaviorBus(initial, { logger: { debug: console.debug } })` but imported\n * from a dedicated sub-path so `console.debug` references are tree-shaken from\n * production bundles when this sub-path is not imported.\n *\n * @example\n * ```ts\n * import { debugBehaviorBus } from '@vielzeug/herald/devtools';\n *\n * const bus = debugBehaviorBus<MyEvents>({ theme: 'light' });\n * // or redirect warnings:\n * const bus = debugBehaviorBus<MyEvents>({ theme: 'light' }, { logger: { warn: myLogger.warn } });\n * ```\n */\nexport function debugBehaviorBus<T extends EventMap>(\n  initial?: BehaviorInitial<T>,\n  options?: Omit<BehaviorBusOptions<T>, 'logger'> & { logger?: { warn?: BusLogger['warn'] } },\n): BehaviorBus<T> {\n  const { logger, ...rest } = options ?? {};\n\n  return createBehaviorBus<T>(initial, {\n    ...rest,\n    logger: { debug: console.debug, warn: logger?.warn },\n  });\n}\n"],"mappings":";;;AAiCA,SAAgB,EACd,GACQ;CACR,IAAM,EAAE,WAAQ,GAAG,MAAS,KAAW,CAAC;CAExC,OAAO,EAAa;EAClB,GAAG;EACH,QAAQ;GAAE,OAAO,QAAQ;GAAO,MAAM,GAAQ;EAAK;CACrD,CAAC;AACH;AAkBA,SAAgB,EACd,GACA,GACgB;CAChB,IAAM,EAAE,WAAQ,GAAG,MAAS,KAAW,CAAC;CAExC,OAAO,EAAqB,GAAS;EACnC,GAAG;EACH,QAAQ;GAAE,OAAO,QAAQ;GAAO,MAAM,GAAQ;EAAK;CACrD,CAAC;AACH"}
+{"version":3,"file":"devtools.js","names":[],"sources":["../src/devtools.ts"],"sourcesContent":["/**\n * @vielzeug/herald — debug utilities for bus visualisation.\n *\n * Import from the dedicated sub-path so it is tree-shaken from production bundles:\n * ```ts\n * import { debugBus } from '@vielzeug/herald/devtools';\n * ```\n */\n\nimport type { Bus, BusLogger, BusOptions, EventMap } from './types';\n\nimport { createBus } from './bus';\n\n/**\n * Creates a {@link Bus} with debug logging pre-wired to `console.debug`.\n *\n * Equivalent to `createBus({ logger: { debug: console.debug } })` but imported\n * from a dedicated sub-path so `console.debug` references are tree-shaken from\n * production bundles when this sub-path is not imported.\n *\n * Logs subscription registrations/removals, emissions, and disposal with\n * `[herald:*]` prefixes. Pass `logger.warn` to also redirect or silence warnings.\n *\n * @example\n * ```ts\n * import { debugBus } from '@vielzeug/herald/devtools';\n *\n * const bus = debugBus<MyEvents>();\n * // or redirect to a custom logger:\n * const bus = debugBus<MyEvents>({ logger: { warn: myLogger.warn } });\n * ```\n */\nexport function debugBus<T extends EventMap>(\n  options?: Omit<BusOptions<T>, 'logger'> & { logger?: { warn?: BusLogger['warn'] } },\n): Bus<T> {\n  const { logger, ...rest } = options ?? {};\n\n  return createBus<T>({\n    ...rest,\n    logger: { debug: console.debug, warn: logger?.warn },\n  });\n}\n"],"mappings":";;AAgCA,SAAgB,EACd,GACQ;CACR,IAAM,EAAE,WAAQ,GAAG,MAAS,KAAW,CAAC;CAExC,OAAO,EAAa;EAClB,GAAG;EACH,QAAQ;GAAE,OAAO,QAAQ;GAAO,MAAM,GAAQ;EAAK;CACrD,CAAC;AACH"}

package/dist/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all herald errors. Use `instanceof HeraldError` to catch any herald-originated error. */\nexport class HeraldError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is HeraldError {\n    return err instanceof HeraldError;\n  }\n}\n\n/** Thrown when an operation is attempted on a disposed event bus. */\nexport class BusDisposedError extends HeraldError {\n  constructor(busName?: string) {\n    super(busName ? `Bus \"${busName}\" is disposed` : 'Bus is disposed');\n  }\n}\n\n/** Thrown when a herald API is called with invalid arguments or configuration. */\nexport class HeraldConfigError extends HeraldError {\n  constructor(message: string) {\n    super(message);\n  }\n}\n"],"mappings":"AACA,IAAa,EAAb,MAAa,UAAoB,KAAM,CACrC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,IAAI,OAAO,KACvB,OAAO,eAAe,KAAM,IAAI,OAAO,SAAS,CAClD,CAEA,OAAO,GAAG,EAAkC,CAC1C,OAAO,aAAe,CACxB,CACF,EAGa,EAAb,cAAsC,CAAY,CAChD,YAAY,EAAkB,CAC5B,MAAM,EAAU,QAAQ,EAAQ,eAAiB,iBAAiB,CACpE,CACF,EAGa,EAAb,cAAuC,CAAY,CACjD,YAAY,EAAiB,CAC3B,MAAM,CAAO,CACf,CACF"}
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all herald errors. Use `instanceof HeraldError` to catch any herald-originated error. */\nexport class HeraldError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is HeraldError {\n    return err instanceof HeraldError;\n  }\n}\n\n/** Thrown when an operation is attempted on a disposed event bus. */\nexport class BusDisposedError extends HeraldError {\n  constructor(busName?: string) {\n    super(busName ? `Bus \"${busName}\" is disposed` : 'Bus is disposed');\n  }\n}\n\n/** Thrown when a herald API is called with invalid arguments or configuration. */\nexport class HeraldConfigError extends HeraldError {\n  constructor(message: string) {\n    super(message);\n  }\n}\n"],"mappings":"AACA,IAAa,EAAb,MAAa,UAAoB,KAAM,CACrC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CAEA,OAAO,GAAG,EAAkC,CAC1C,OAAO,aAAe,CACxB,CACF,EAGa,EAAb,cAAsC,CAAY,CAChD,YAAY,EAAkB,CAC5B,MAAM,EAAU,QAAQ,EAAQ,eAAiB,iBAAiB,CACpE,CACF,EAGa,EAAb,cAAuC,CAAY,CACjD,YAAY,EAAiB,CAC3B,MAAM,CAAO,CACf,CACF"}