@tiny-event-bus/react 0.10.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vineet Desai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,220 @@
+# @tiny-event-bus/react
+
+[![npm version](https://img.shields.io/npm/v/@tiny-event-bus/react)](https://www.npmjs.com/package/@tiny-event-bus/react)
+
+React hooks plugin for `@tiny-event-bus/core`. ~915 B gzipped.
+
+Requires React >=17 and `@tiny-event-bus/core` as peer dependencies.
+
+## Install
+
+```bash
+npm install @tiny-event-bus/core @tiny-event-bus/react
+```
+
+## Quick Start
+
+```tsx
+import { createEventBus } from '@tiny-event-bus/core';
+import { useEvent, useEventBus } from '@tiny-event-bus/react';
+
+type AppEvents = {
+  'toast:show': { message: string; severity: 'info' | 'error' };
+};
+
+const bus = createEventBus<AppEvents>();
+
+function ToastListener() {
+  useEvent(
+    'toast:show',
+    (data) => {
+      console.log(data.message); // fully typed, auto-cleanup on unmount
+    },
+    bus,
+  );
+  return null;
+}
+
+function EmitButton() {
+  const { emit } = useEventBus(bus);
+  return (
+    <button
+      onClick={() => emit('toast:show', { message: 'Hi!', severity: 'info' })}
+    >
+      Show Toast
+    </button>
+  );
+}
+```
+
+## API
+
+| Hook                            | Description                                                                                                                    |
+| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| `useEvent(event, handler, bus)` | Subscribe with auto-cleanup on unmount. Uses `useRef` internally so handler updates never cause re-subscription.               |
+| `useEventBus(bus)`              | Returns `BusMethods<B>` — all function-valued properties of the bus with stable refs via `useMemo`. Works with any bus object. |
+| `useAnyEvent(handler, bus)`     | Subscribe to all events with auto-cleanup. Uses `useRef` for handler stability.                                                |
+| `createBusContext<T>()`         | Factory — returns `{ Provider, useEvent, useEventBus, useAnyEvent }`. Hooks read bus from context (no bus arg needed).         |
+
+### `useEvent` — subscribe to a single event
+
+```tsx
+function ToastListener() {
+  useEvent(
+    'toast:show',
+    (data) => {
+      showToast(data.message);
+    },
+    bus,
+  );
+  return null;
+}
+```
+
+Handler is stored in a `useRef` — updating the handler function doesn't cause re-subscription. Cleanup runs automatically on unmount.
+
+### `useEventBus` — emit, subscribe, and clear with stable refs
+
+```tsx
+function ActionBar() {
+  const { emit, on, once, clear } = useEventBus(bus);
+
+  return (
+    <button
+      onClick={() => emit('toast:show', { message: 'Hi!', severity: 'info' })}
+    >
+      Toast
+    </button>
+  );
+}
+```
+
+Returns `BusMethods<B>` — a mapped type that exposes every function-valued property on the bus object. This means it works with plain buses _and_ decorated buses like `ReplayBus`:
+
+```tsx
+import { withReplay } from '@tiny-event-bus/replay';
+
+const replayBus = withReplay(createEventBus<AppEvents>());
+
+function Component() {
+  // getHistory and clearHistory are also available
+  const { emit, getHistory, clearHistory } = useEventBus(replayBus);
+}
+```
+
+`clear()` removes all listeners. `clear(event)` removes only that event's listeners.
+
+### `useAnyEvent` — catch-all hook
+
+```tsx
+function AnalyticsLogger() {
+  useAnyEvent((event, data) => {
+    analytics.track(String(event), data);
+  }, bus);
+  return null;
+}
+```
+
+### `createBusContext` — scoped context (no prop drilling)
+
+```tsx
+import { createEventBus } from '@tiny-event-bus/core';
+import { createBusContext } from '@tiny-event-bus/react';
+
+type ChatEvents = { 'message:new': { text: string } };
+
+const { Provider, useEvent, useEventBus, useAnyEvent } =
+  createBusContext<ChatEvents>();
+
+// Provide a bus instance at the top
+function ChatRoot() {
+  const bus = createEventBus<ChatEvents>();
+  return (
+    <Provider bus={bus}>
+      <ChatMessages />
+    </Provider>
+  );
+}
+
+// Hooks read bus from context — no bus arg needed
+function ChatMessages() {
+  useEvent('message:new', (data) => console.log(data.text));
+  return null;
+}
+```
+
+Throws if hooks are used outside a `<Provider>`. Each `createBusContext()` call produces an isolated context — multiple scopes can coexist.
+
+## Using with `@tiny-event-bus/replay`
+
+All hooks work seamlessly with `withReplay` decorated buses. Install the replay plugin alongside:
+
+```bash
+npm install @tiny-event-bus/replay
+```
+
+Wrap your bus with `withReplay` and pass it to hooks as usual:
+
+```tsx
+import { createEventBus } from '@tiny-event-bus/core';
+import { withReplay } from '@tiny-event-bus/replay';
+import { createBusContext } from '@tiny-event-bus/react';
+
+type ActivityEvents = {
+  'activity:log': { action: string; timestamp: number };
+};
+
+const activityBus = withReplay(createEventBus<ActivityEvents>(), {
+  maxSize: 50,
+});
+
+const { Provider, useEvent, useEventBus, useAnyEvent } =
+  createBusContext<ActivityEvents>();
+```
+
+Late-mounting components can replay buffered events on mount:
+
+```tsx
+function ActivityFeed() {
+  const { getHistory } = useEventBus(activityBus);
+  const [entries, setEntries] = useState<string[]>([]);
+
+  useEffect(() => {
+    // Seed from replay buffer
+    setEntries(getHistory().map((e) => e.data.action));
+  }, [getHistory]);
+
+  // Live updates going forward
+  useEvent(
+    'activity:log',
+    (data) => {
+      setEntries((prev) => [...prev, data.action]);
+    },
+    activityBus,
+  );
+
+  return (
+    <ul>
+      {entries.map((e, i) => (
+        <li key={i}>{e}</li>
+      ))}
+    </ul>
+  );
+}
+```
+
+`useEventBus` automatically discovers `getHistory` and `clearHistory` from the replay bus — no extra configuration needed.
+
+## When to Use (vs React State)
+
+| Use event bus                                          | Use React state               |
+| ------------------------------------------------------ | ----------------------------- |
+| Fire-and-forget signals (toasts, analytics, shortcuts) | UI data that drives rendering |
+| Cross-module notifications                             | Component-local data          |
+| No re-renders needed                                   | Must trigger re-render        |
+
+**Rule of thumb**: if a component needs to _render_ data, use React state. If something needs to _react to a signal_, use the event bus.
+
+## License
+
+MIT

package/dist/cjs/create-bus-context.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { EventMap, EventKey, EventHandler, AnyEventHandler, IEventBus } from '@tiny-event-bus/core';
+export declare function createBusContext<T extends EventMap>(): {
+    Provider: ({ bus, children, }: {
+        bus: IEventBus<T>;
+        children: React.ReactNode;
+    }) => React.FunctionComponentElement<React.ProviderProps<IEventBus<T> | null>>;
+    useEvent: <K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>) => void;
+    useEventBus: () => import("./use-event-bus.js").BusMethods<IEventBus<T>>;
+    useAnyEvent: (handler: AnyEventHandler<T>) => void;
+};
+//# sourceMappingURL=create-bus-context.d.ts.map

package/dist/cjs/create-bus-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-bus-context.d.ts","sourceRoot":"","sources":["../../src/create-bus-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,SAAS,EACV,MAAM,sBAAsB,CAAC;AAK9B,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,QAAQ;mCAc9C;QACD,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;KAC3B;eAIiB,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,SAC9B,CAAC,WACC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;;2BASC,eAAe,CAAC,CAAC,CAAC;EAKjD"}

package/dist/cjs/create-bus-context.js

@@ -0,0 +1,64 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBusContext = createBusContext;
+const react_1 = __importStar(require("react"));
+const use_event_js_1 = require("./use-event.js");
+const use_event_bus_js_1 = require("./use-event-bus.js");
+const use_any_event_js_1 = require("./use-any-event.js");
+function createBusContext() {
+    const Ctx = (0, react_1.createContext)(null);
+    function useBus() {
+        const bus = (0, react_1.useContext)(Ctx);
+        if (!bus) {
+            throw new Error('useBus must be used within a <Provider>');
+        }
+        return bus;
+    }
+    function Provider({ bus, children, }) {
+        return react_1.default.createElement(Ctx.Provider, { value: bus }, children);
+    }
+    function useEvent(event, handler) {
+        return (0, use_event_js_1.useEvent)(event, handler, useBus());
+    }
+    function useEventBus() {
+        return (0, use_event_bus_js_1.useEventBus)(useBus());
+    }
+    function useAnyEvent(handler) {
+        return (0, use_any_event_js_1.useAnyEvent)(handler, useBus());
+    }
+    return { Provider, useEvent, useEventBus, useAnyEvent };
+}
+//# sourceMappingURL=create-bus-context.js.map

package/dist/cjs/create-bus-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-bus-context.js","sourceRoot":"","sources":["../../src/create-bus-context.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,4CAqCC;AAjDD,+CAAyD;AAQzD,iDAA0D;AAC1D,yDAAoE;AACpE,yDAAoE;AAEpE,SAAgB,gBAAgB;IAC9B,MAAM,GAAG,GAAG,IAAA,qBAAa,EAAsB,IAAI,CAAC,CAAC;IAErD,SAAS,MAAM;QACb,MAAM,GAAG,GAAG,IAAA,kBAAU,EAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,QAAQ,CAAC,EAChB,GAAG,EACH,QAAQ,GAIT;QACC,OAAO,eAAK,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED,SAAS,QAAQ,CACf,KAAQ,EACR,OAA2B;QAE3B,OAAO,IAAA,uBAAY,EAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,SAAS,WAAW;QAClB,OAAO,IAAA,8BAAe,EAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,SAAS,WAAW,CAAC,OAA2B;QAC9C,OAAO,IAAA,8BAAe,EAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAC1D,CAAC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,5 @@
+export { useEvent } from './use-event.js';
+export { useEventBus, type BusMethods } from './use-event-bus.js';
+export { useAnyEvent } from './use-any-event.js';
+export { createBusContext } from './create-bus-context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBusContext = exports.useAnyEvent = exports.useEventBus = exports.useEvent = void 0;
+var use_event_js_1 = require("./use-event.js");
+Object.defineProperty(exports, "useEvent", { enumerable: true, get: function () { return use_event_js_1.useEvent; } });
+var use_event_bus_js_1 = require("./use-event-bus.js");
+Object.defineProperty(exports, "useEventBus", { enumerable: true, get: function () { return use_event_bus_js_1.useEventBus; } });
+var use_any_event_js_1 = require("./use-any-event.js");
+Object.defineProperty(exports, "useAnyEvent", { enumerable: true, get: function () { return use_any_event_js_1.useAnyEvent; } });
+var create_bus_context_js_1 = require("./create-bus-context.js");
+Object.defineProperty(exports, "createBusContext", { enumerable: true, get: function () { return create_bus_context_js_1.createBusContext; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,+CAA0C;AAAjC,wGAAA,QAAQ,OAAA;AACjB,uDAAkE;AAAzD,+GAAA,WAAW,OAAA;AACpB,uDAAiD;AAAxC,+GAAA,WAAW,OAAA;AACpB,iEAA2D;AAAlD,yHAAA,gBAAgB,OAAA"}

package/dist/cjs/use-any-event.d.ts

@@ -0,0 +1,3 @@
+import type { EventMap, AnyEventHandler, IEventBus } from '@tiny-event-bus/core';
+export declare function useAnyEvent<T extends EventMap>(handler: AnyEventHandler<T>, bus: IEventBus<T>): void;
+//# sourceMappingURL=use-any-event.d.ts.map

package/dist/cjs/use-any-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-any-event.d.ts","sourceRoot":"","sources":["../../src/use-any-event.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EAER,eAAe,EACf,SAAS,EACV,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAC3B,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAChB,IAAI,CAWN"}

package/dist/cjs/use-any-event.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAnyEvent = useAnyEvent;
+const react_1 = require("react");
+function useAnyEvent(handler, bus) {
+    const handlerRef = (0, react_1.useRef)(handler);
+    // Assign during render to avoid stale closure between render and effect.
+    // eslint-disable-next-line react-hooks/refs
+    handlerRef.current = handler;
+    (0, react_1.useEffect)(() => {
+        return bus.onAny(((event, data) => {
+            handlerRef.current(event, data);
+        }));
+    }, [bus]);
+}
+//# sourceMappingURL=use-any-event.js.map

package/dist/cjs/use-any-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-any-event.js","sourceRoot":"","sources":["../../src/use-any-event.ts"],"names":[],"mappings":";;AAQA,kCAcC;AAtBD,iCAA0C;AAQ1C,SAAgB,WAAW,CACzB,OAA2B,EAC3B,GAAiB;IAEjB,MAAM,UAAU,GAAG,IAAA,cAAM,EAAqB,OAAO,CAAC,CAAC;IACvD,yEAAyE;IACzE,4CAA4C;IAC5C,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAkB,EAAE,IAAoB,EAAE,EAAE;YAC7D,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC,CAAuB,CAAC,CAAC;IAC5B,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/dist/cjs/use-event-bus.d.ts

@@ -0,0 +1,8 @@
+import type { IEventBus } from '@tiny-event-bus/core';
+type AnyFunction = (...args: any[]) => any;
+export type BusMethods<B> = {
+    [K in keyof B as B[K] extends AnyFunction ? K : never]: B[K];
+};
+export declare function useEventBus<B extends IEventBus<any>>(bus: B): BusMethods<B>;
+export {};
+//# sourceMappingURL=use-event-bus.d.ts.map

package/dist/cjs/use-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-bus.d.ts","sourceRoot":"","sources":["../../src/use-event-bus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAE3C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;KACzB,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,WAAW,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;CAC7D,CAAC;AAMF,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAe3E"}

package/dist/cjs/use-event-bus.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useEventBus = useEventBus;
+const react_1 = require("react");
+// IEventBus<any> — `any` is intentional: IEventBus<T> is invariant in T, so no
+// concrete IEventBus<MyEvents> is assignable to IEventBus<EventMap>. Using `any`
+// sidesteps invariance while BusMethods<B> still preserves full static typing.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function useEventBus(bus) {
+    return (0, react_1.useMemo)(() => {
+        const source = bus;
+        const methods = {};
+        for (const key of Object.keys(source)) {
+            const fn = source[key];
+            if (typeof fn === 'function') {
+                methods[key] = (...args) => fn.apply(bus, args);
+            }
+        }
+        return methods;
+    }, [bus]);
+}
+//# sourceMappingURL=use-event-bus.js.map

package/dist/cjs/use-event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-bus.js","sourceRoot":"","sources":["../../src/use-event-bus.ts"],"names":[],"mappings":";;AAcA,kCAeC;AA7BD,iCAAgC;AAUhC,+EAA+E;AAC/E,iFAAiF;AACjF,+EAA+E;AAC/E,8DAA8D;AAC9D,SAAgB,WAAW,CAA2B,GAAM;IAC1D,OAAO,IAAA,eAAO,EAAC,GAAG,EAAE;QAClB,MAAM,MAAM,GAAG,GAA8B,CAAC;QAC9C,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CACnC,EAAkB,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,OAAO,OAAwB,CAAC;IAClC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/dist/cjs/use-event.d.ts

@@ -0,0 +1,3 @@
+import type { EventMap, EventKey, EventHandler, IEventBus } from '@tiny-event-bus/core';
+export declare function useEvent<T extends EventMap, K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>, bus: IEventBus<T>): void;
+//# sourceMappingURL=use-event.d.ts.map

package/dist/cjs/use-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event.d.ts","sourceRoot":"","sources":["../../src/use-event.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,SAAS,EACV,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAChE,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAC3B,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAChB,IAAI,CAWN"}

package/dist/cjs/use-event.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useEvent = useEvent;
+const react_1 = require("react");
+function useEvent(event, handler, bus) {
+    const handlerRef = (0, react_1.useRef)(handler);
+    // Assign during render to avoid stale closure between render and effect.
+    // eslint-disable-next-line react-hooks/refs
+    handlerRef.current = handler;
+    (0, react_1.useEffect)(() => {
+        return bus.on(event, ((data) => {
+            handlerRef.current(data);
+        }));
+    }, [bus, event]);
+}
+//# sourceMappingURL=use-event.js.map

package/dist/cjs/use-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event.js","sourceRoot":"","sources":["../../src/use-event.ts"],"names":[],"mappings":";;AAQA,4BAeC;AAvBD,iCAA0C;AAQ1C,SAAgB,QAAQ,CACtB,KAAQ,EACR,OAA2B,EAC3B,GAAiB;IAEjB,MAAM,UAAU,GAAG,IAAA,cAAM,EAAqB,OAAO,CAAC,CAAC;IACvD,yEAAyE;IACzE,4CAA4C;IAC5C,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,OAAO,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,IAAU,EAAE,EAAE;YACnC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAuB,CAAC,CAAC;IAC5B,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/esm/create-bus-context.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { EventMap, EventKey, EventHandler, AnyEventHandler, IEventBus } from '@tiny-event-bus/core';
+export declare function createBusContext<T extends EventMap>(): {
+    Provider: ({ bus, children, }: {
+        bus: IEventBus<T>;
+        children: React.ReactNode;
+    }) => React.FunctionComponentElement<React.ProviderProps<IEventBus<T> | null>>;
+    useEvent: <K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>) => void;
+    useEventBus: () => import("./use-event-bus.js").BusMethods<IEventBus<T>>;
+    useAnyEvent: (handler: AnyEventHandler<T>) => void;
+};
+//# sourceMappingURL=create-bus-context.d.ts.map

package/dist/esm/create-bus-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-bus-context.d.ts","sourceRoot":"","sources":["../../src/create-bus-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,SAAS,EACV,MAAM,sBAAsB,CAAC;AAK9B,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,QAAQ;mCAc9C;QACD,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;KAC3B;eAIiB,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,SAC9B,CAAC,WACC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;;2BASC,eAAe,CAAC,CAAC,CAAC;EAKjD"}

package/dist/esm/create-bus-context.js

@@ -0,0 +1,28 @@
+import React, { createContext, useContext } from 'react';
+import { useEvent as useEventBase } from './use-event.js';
+import { useEventBus as useEventBusBase } from './use-event-bus.js';
+import { useAnyEvent as useAnyEventBase } from './use-any-event.js';
+export function createBusContext() {
+    const Ctx = createContext(null);
+    function useBus() {
+        const bus = useContext(Ctx);
+        if (!bus) {
+            throw new Error('useBus must be used within a <Provider>');
+        }
+        return bus;
+    }
+    function Provider({ bus, children, }) {
+        return React.createElement(Ctx.Provider, { value: bus }, children);
+    }
+    function useEvent(event, handler) {
+        return useEventBase(event, handler, useBus());
+    }
+    function useEventBus() {
+        return useEventBusBase(useBus());
+    }
+    function useAnyEvent(handler) {
+        return useAnyEventBase(handler, useBus());
+    }
+    return { Provider, useEvent, useEventBus, useAnyEvent };
+}
+//# sourceMappingURL=create-bus-context.js.map

package/dist/esm/create-bus-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-bus-context.js","sourceRoot":"","sources":["../../src/create-bus-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAQzD,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,aAAa,CAAsB,IAAI,CAAC,CAAC;IAErD,SAAS,MAAM;QACb,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,QAAQ,CAAC,EAChB,GAAG,EACH,QAAQ,GAIT;QACC,OAAO,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED,SAAS,QAAQ,CACf,KAAQ,EACR,OAA2B;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,SAAS,WAAW;QAClB,OAAO,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,SAAS,WAAW,CAAC,OAA2B;QAC9C,OAAO,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAC1D,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+export { useEvent } from './use-event.js';
+export { useEventBus, type BusMethods } from './use-event-bus.js';
+export { useAnyEvent } from './use-any-event.js';
+export { createBusContext } from './create-bus-context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+export { useEvent } from './use-event.js';
+export { useEventBus } from './use-event-bus.js';
+export { useAnyEvent } from './use-any-event.js';
+export { createBusContext } from './create-bus-context.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/esm/use-any-event.d.ts

@@ -0,0 +1,3 @@
+import type { EventMap, AnyEventHandler, IEventBus } from '@tiny-event-bus/core';
+export declare function useAnyEvent<T extends EventMap>(handler: AnyEventHandler<T>, bus: IEventBus<T>): void;
+//# sourceMappingURL=use-any-event.d.ts.map

package/dist/esm/use-any-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-any-event.d.ts","sourceRoot":"","sources":["../../src/use-any-event.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EAER,eAAe,EACf,SAAS,EACV,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAC3B,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAChB,IAAI,CAWN"}

package/dist/esm/use-any-event.js

@@ -0,0 +1,13 @@
+import { useEffect, useRef } from 'react';
+export function useAnyEvent(handler, bus) {
+    const handlerRef = useRef(handler);
+    // Assign during render to avoid stale closure between render and effect.
+    // eslint-disable-next-line react-hooks/refs
+    handlerRef.current = handler;
+    useEffect(() => {
+        return bus.onAny(((event, data) => {
+            handlerRef.current(event, data);
+        }));
+    }, [bus]);
+}
+//# sourceMappingURL=use-any-event.js.map

package/dist/esm/use-any-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-any-event.js","sourceRoot":"","sources":["../../src/use-any-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAQ1C,MAAM,UAAU,WAAW,CACzB,OAA2B,EAC3B,GAAiB;IAEjB,MAAM,UAAU,GAAG,MAAM,CAAqB,OAAO,CAAC,CAAC;IACvD,yEAAyE;IACzE,4CAA4C;IAC5C,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAkB,EAAE,IAAoB,EAAE,EAAE;YAC7D,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC,CAAuB,CAAC,CAAC;IAC5B,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/dist/esm/use-event-bus.d.ts

@@ -0,0 +1,8 @@
+import type { IEventBus } from '@tiny-event-bus/core';
+type AnyFunction = (...args: any[]) => any;
+export type BusMethods<B> = {
+    [K in keyof B as B[K] extends AnyFunction ? K : never]: B[K];
+};
+export declare function useEventBus<B extends IEventBus<any>>(bus: B): BusMethods<B>;
+export {};
+//# sourceMappingURL=use-event-bus.d.ts.map

package/dist/esm/use-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-bus.d.ts","sourceRoot":"","sources":["../../src/use-event-bus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAE3C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;KACzB,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,WAAW,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;CAC7D,CAAC;AAMF,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAe3E"}

package/dist/esm/use-event-bus.js

@@ -0,0 +1,19 @@
+import { useMemo } from 'react';
+// IEventBus<any> — `any` is intentional: IEventBus<T> is invariant in T, so no
+// concrete IEventBus<MyEvents> is assignable to IEventBus<EventMap>. Using `any`
+// sidesteps invariance while BusMethods<B> still preserves full static typing.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function useEventBus(bus) {
+    return useMemo(() => {
+        const source = bus;
+        const methods = {};
+        for (const key of Object.keys(source)) {
+            const fn = source[key];
+            if (typeof fn === 'function') {
+                methods[key] = (...args) => fn.apply(bus, args);
+            }
+        }
+        return methods;
+    }, [bus]);
+}
+//# sourceMappingURL=use-event-bus.js.map

package/dist/esm/use-event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-bus.js","sourceRoot":"","sources":["../../src/use-event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAUhC,+EAA+E;AAC/E,iFAAiF;AACjF,+EAA+E;AAC/E,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAA2B,GAAM;IAC1D,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,MAAM,GAAG,GAA8B,CAAC;QAC9C,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CACnC,EAAkB,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,OAAO,OAAwB,CAAC;IAClC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/dist/esm/use-event.d.ts

@@ -0,0 +1,3 @@
+import type { EventMap, EventKey, EventHandler, IEventBus } from '@tiny-event-bus/core';
+export declare function useEvent<T extends EventMap, K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>, bus: IEventBus<T>): void;
+//# sourceMappingURL=use-event.d.ts.map

package/dist/esm/use-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event.d.ts","sourceRoot":"","sources":["../../src/use-event.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,SAAS,EACV,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAChE,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAC3B,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAChB,IAAI,CAWN"}

package/dist/esm/use-event.js

@@ -0,0 +1,13 @@
+import { useEffect, useRef } from 'react';
+export function useEvent(event, handler, bus) {
+    const handlerRef = useRef(handler);
+    // Assign during render to avoid stale closure between render and effect.
+    // eslint-disable-next-line react-hooks/refs
+    handlerRef.current = handler;
+    useEffect(() => {
+        return bus.on(event, ((data) => {
+            handlerRef.current(data);
+        }));
+    }, [bus, event]);
+}
+//# sourceMappingURL=use-event.js.map

package/dist/esm/use-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event.js","sourceRoot":"","sources":["../../src/use-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAQ1C,MAAM,UAAU,QAAQ,CACtB,KAAQ,EACR,OAA2B,EAC3B,GAAiB;IAEjB,MAAM,UAAU,GAAG,MAAM,CAAqB,OAAO,CAAC,CAAC;IACvD,yEAAyE;IACzE,4CAA4C;IAC5C,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,IAAU,EAAE,EAAE;YACnC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAuB,CAAC,CAAC;IAC5B,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@tiny-event-bus/react",
+  "version": "0.10.0",
+  "description": "React hooks plugin for tiny-event-bus",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vineet2907/tiny-event-bus.git",
+    "directory": "packages/react"
+  },
+  "homepage": "https://github.com/vineet2907/tiny-event-bus/tree/main/packages/react#readme",
+  "bugs": {
+    "url": "https://github.com/vineet2907/tiny-event-bus/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "react": ">=17",
+    "@tiny-event-bus/core": "^0.10.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.0.0",
+    "jsdom": "^29.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@tiny-event-bus/core": "0.10.0"
+  },
+  "keywords": [
+    "event-bus",
+    "react",
+    "hooks",
+    "typescript",
+    "plugin"
+  ],
+  "scripts": {
+    "build:esm": "tsc -p tsconfig.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build": "rm -rf dist && pnpm run build:esm && pnpm run build:cjs",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}