@siggn/react 0.1.3 → 0.1.5

package/README.md

@@ -49,7 +49,7 @@ Alternatively, you can use the `useSiggn` hook to create a `Siggn` instance that
 
 ### 2. Subscribe to Events in a Component
 
-Use the `useSubscribe` hook to listen for messages. It automatically handles subscribing and unsubscribing.
+Use the `useSubscribe` hook to listen for a message. It automatically handles subscribing and unsubscribing.
 
 ```tsx
 // src/components/Notification.tsx
@@ -60,7 +60,30 @@ import { siggn, type Message } from '../siggn';
 function Notification() {
   const [notification, setNotification] = useState<string | null>(null);
 
-  useSubscribe(siggn, (subscribe) => {
+  useSubscribe(siggn, 'user_login', (msg) => {
+    setNotification(`Welcome, ${msg.name}!`);
+  });
+
+  if (!notification) {
+    return null;
+  }
+
+  return <div className='notification'>{notification}</div>;
+}
+```
+
+You can also use the `useSubscribeMany` hook to listen for multiple messages. It automatically handles subscribing and unsubscribing.
+
+```tsx
+// src/components/Notification.tsx
+import { useState } from 'react';
+import { useSubscribeMany } from '@siggn/react';
+import { siggn, type Message } from '../siggn';
+
+function Notification() {
+  const [notification, setNotification] = useState<string | null>(null);
+
+  useSubscribeMany(siggn, (subscribe) => {
     subscribe('user_login', (msg) => {
       setNotification(`Welcome, ${msg.name}!`);
     });

package/dist/hooks.d.ts

@@ -1,5 +1,4 @@
 import { Msg, Siggn } from '@siggn/core';
-import { SubscriptionOptions } from 'packages/react/src/types';
 import { DependencyList } from 'react';
 /**
  * Creates and returns a `Siggn` instance that persists for the lifetime of the component.
@@ -20,7 +19,7 @@ import { DependencyList } from 'react';
  */
 export declare function useSiggn<T extends Msg>(): Siggn<T>;
 /**
- * Subscribes to messages and automatically unsubscribes when the component unmounts.
+ * Subscribes to multiple messages and automatically unsubscribes when the component unmounts.
  *
  * @template T A union of all possible message types.
  * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.
@@ -34,16 +33,46 @@ export declare function useSiggn<T extends Msg>(): Siggn<T>;
  * import { siggn } from './siggn'; // Your shared instance
  *
  * function MyComponent() {
- *   useSubscribe(siggn, (subscribe) => {
+ *   useSubscribeMany(siggn, (subscribe) => {
  *     subscribe('user-created', (msg) => console.log(msg.name));
+ *     subscribe('user-updated', (msg) => console.log(msg.name));
  *   });
  *   // ...
  * }
  * ```
  */
-export declare function useSubscribe<T extends Msg>(options: SubscriptionOptions<T>, setup: (subscribe: <K extends T['type']>(type: K, callback: (msg: Extract<T, {
-    type: K;
+export declare function useSubscribeMany<M extends Msg>(options: Siggn<M> | {
+    instance: Siggn<M>;
+    id?: string;
+}, setup: (subscribe: <T extends M['type']>(type: T, callback: (msg: Extract<M, {
+    type: T;
 }>) => void) => void) => void, deps?: DependencyList): void;
+/**
+ * Subscribes to a single message and automatically unsubscribe when the component unmounts.
+ *
+ * @template T A union of all possible message types.
+ * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.
+ * @param setup A function that receives a `subscribe` helper to define subscriptions.
+ * @param deps An optional dependency array to control when the subscriptions are re-created.
+ * @category Subscription
+ * @since 0.0.1
+ * @example
+ *
+```tsx
+ * import { siggn } from './siggn'; // Your shared instance
+ *
+ * function MyComponent() {
+ *   useSubscribe(siggn, 'user-created', (msg) => console.log(msg.name));
+ *   // ...
+ * }
+ * ```
+ */
+export declare function useSubscribe<M extends Msg, T extends string>(options: Siggn<M> | {
+    instance: Siggn<M>;
+    id?: string;
+}, type: T, callback: (msg: Extract<M, {
+    type: T;
+}>) => void, deps?: DependencyList): void;
 /**
  * Subscribes to all messages on a `Siggn` instance and automatically unsubscribes
  * when the component unmounts.
@@ -67,5 +96,8 @@ export declare function useSubscribe<T extends Msg>(options: SubscriptionOptions
  * }
  * ```
  */
-export declare function useSubscribeAll<T extends Msg>(options: SubscriptionOptions<T>, callback: (msg: T) => void, deps?: DependencyList): void;
+export declare function useSubscribeAll<T extends Msg>(options: Siggn<T> | {
+    instance: Siggn<T>;
+    id?: string;
+}, callback: (msg: T) => void, deps?: DependencyList): void;
 //# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAA8B,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAGlD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,GAAG,EACxC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC/B,KAAK,EAAE,CACL,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,KACN,IAAI,EACT,IAAI,GAAE,cAAmB,QAe1B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,GAAG,EAC3C,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAC1B,IAAI,GAAE,cAAmB,QAe1B"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAE1E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAGlD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,GAAG,EAC5C,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EACvD,KAAK,EAAE,CACL,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,KACN,IAAI,EACT,IAAI,GAAE,cAAmB,QAe1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,MAAM,EAC1D,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EACvD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,KAAK,IAAI,EAChD,IAAI,GAAE,cAAmB,QAe1B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,GAAG,EAC3C,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EACvD,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAC1B,IAAI,GAAE,cAAmB,QAe1B"}

package/dist/index.cjs.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("react");class b{nextId=0;subscriptions;globalSubscriptions=[];registry=new FinalizationRegistry(s=>{this.unsubscribe(s)});registryGlobal=new FinalizationRegistry(s=>{this.unsubscribeGlobal(s)});constructor(){this.subscriptions=new Map}createClone(){return new b}makeId(s){return s??`sub_${(this.nextId++).toString(36)}`}make(s){return{subscribe:(i,e)=>{this.subscribe(s,i,e)},unsubscribe:()=>{this.unsubscribe(s)},subscribeMany:i=>{this.subscribeMany(s,i)},subscribeAll:i=>{this.subscribeAll(s,i)}}}subscribeMany(s,i){i((e,r)=>this.subscribe(s,e,r))}subscribe(s,i,e){this.subscriptions.has(i)||this.subscriptions.set(i,[]),this.registry.register(e,s),this.subscriptions.get(i)?.push({id:s,ref:new WeakRef(e)})}subscribeAll(s,i){this.registryGlobal.register(i,s),this.globalSubscriptions.push({id:s,ref:new WeakRef(i)})}publish(s){this.globalSubscriptions.forEach(i=>{const e=i.ref.deref();if(!e){this.unsubscribeGlobal(i.id);return}e(s)}),this.subscriptions.has(s.type)&&this.subscriptions.get(s.type)?.forEach(i=>{const e=i.ref.deref();if(!e){this.unsubscribe(i.id);return}e(s)})}unsubscribe(s){this.unsubscribeGlobal(s);for(const[i,e]of this.subscriptions)this.subscriptions.set(i,e.filter(r=>r.id!==s))}unsubscribeGlobal(s){this.globalSubscriptions=this.globalSubscriptions.filter(i=>i.id!==s)}get subscriptionsCount(){let s=0;return this.subscriptions.forEach(i=>{s+=i.length}),s+=this.globalSubscriptions.length,s}}function n(){return u.useRef(new b).current}function c(t,s,i=[]){const e=u.useMemo(()=>t instanceof b?t:t.instance,[t]),r=u.useMemo(()=>e.makeId("id"in t?t.id:void 0),[e]);u.useEffect(()=>(e.subscribeMany(r,s),()=>{e.unsubscribe(r)}),[e,r,...i])}function l(t,s,i=[]){const e=u.useMemo(()=>t instanceof b?t:t.instance,[t]),r=u.useMemo(()=>e.makeId("id"in t?t.id:void 0),[e]);u.useEffect(()=>(e.subscribeAll(r,s),()=>{e.unsubscribeGlobal(r)}),[e,r,...i])}exports.Siggn=b;exports.useSiggn=n;exports.useSubscribe=c;exports.useSubscribeAll=l;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("@siggn/core"),n=require("react");function b(){const[e]=n.useState(new s.Siggn);return e}function a(e,i,r=[]){const u=n.useMemo(()=>e instanceof s.Siggn?e:e.instance,[e]),c=n.useMemo(()=>u.makeId("id"in e?e.id:void 0),[u]);n.useEffect(()=>(u.subscribeMany(c,i),()=>{u.unsubscribe(c)}),[u,c,...r])}function d(e,i,r,u=[]){const c=n.useMemo(()=>e instanceof s.Siggn?e:e.instance,[e]),t=n.useMemo(()=>c.makeId("id"in e?e.id:void 0),[c]);n.useEffect(()=>(c.subscribe(t,i,r),()=>{c.unsubscribe(t)}),[c,t,...u])}function f(e,i,r=[]){const u=n.useMemo(()=>e instanceof s.Siggn?e:e.instance,[e]),c=n.useMemo(()=>u.makeId("id"in e?e.id:void 0),[u]);n.useEffect(()=>(u.subscribeAll(c,i),()=>{u.unsubscribeGlobal(c)}),[u,c,...r])}exports.useSiggn=b;exports.useSubscribe=d;exports.useSubscribeAll=f;exports.useSubscribeMany=a;Object.keys(s).forEach(e=>{e!=="default"&&!Object.prototype.hasOwnProperty.call(exports,e)&&Object.defineProperty(exports,e,{enumerable:!0,get:()=>s[e]})});
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../../core/dist/index.es.js","../src/hooks.ts"],"sourcesContent":["class e {\n  nextId = 0;\n  subscriptions;\n  globalSubscriptions = [];\n  /**\n   * A FinalizationRegistry to automatically unregister specific subscriptions\n   * when the subscribed callback function is garbage collected.\n   */\n  registry = new FinalizationRegistry((s) => {\n    this.unsubscribe(s);\n  });\n  /**\n   * A FinalizationRegistry to automatically unregister global subscriptions\n   * when the subscribed callback function is garbage collected.\n   */\n  registryGlobal = new FinalizationRegistry((s) => {\n    this.unsubscribeGlobal(s);\n  });\n  /**\n   * Creates a new Siggn instance.\n   * @category Lifecycle\n   * @since 0.0.5\n   */\n  constructor() {\n    this.subscriptions = /* @__PURE__ */ new Map();\n  }\n  /**\n     * Creates a new, independent `Siggn` instance that inherits the message\n     * types of its parent and adds new ones.\n     *\n     * @template C The new message types to add.\n     * @returns A new `Siggn` instance with combined message types.\n     * @category Lifecycle\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const baseSiggn = new Siggn<{ type: 'A' }>();\n   * const childSiggn = baseSiggn.createClone<{ type: 'B' }>();\n   * // childSiggn can now publish and subscribe to types 'A' and 'B'.\n   * ```\n     */\n  createClone() {\n    return new e();\n  }\n  /**\n     * Generates a unique ID for a subscriber.\n     * If an ID is provided, it will be used; otherwise, a new one is generated.\n     *\n     * @param id An optional ID to use.\n     * @returns A unique subscriber ID.\n     * @category Utilities\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn();\n   * const id1 = siggn.makeId(); // e.g., \"sub_0\"\n   * const id2 = siggn.makeId('custom-id'); // \"custom-id\"\n   * ```\n     */\n  makeId(s) {\n    return s ?? `sub_${(this.nextId++).toString(36)}`;\n  }\n  /**\n     * Creates a subscription helper object that is pre-configured with a\n     * specific subscriber ID. This simplifies managing multiple subscriptions\n     * for a single component or service.\n     *\n     * @param id The subscriber ID to use for all subscriptions.\n     * @returns An object with `subscribe`, `unsubscribe`, `subscribeMany`, and `subscribeAll` methods.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'event' }>();\n   * const component = siggn.make('my-component');\n   * component.subscribe('event', () => console.log('event received!'));\n   * component.unsubscribe();\n   * ```\n     */\n  make(s) {\n    return {\n      subscribe: (i, t) => {\n        this.subscribe(s, i, t);\n      },\n      unsubscribe: () => {\n        this.unsubscribe(s);\n      },\n      subscribeMany: (i) => {\n        this.subscribeMany(s, i);\n      },\n      subscribeAll: (i) => {\n        this.subscribeAll(s, i);\n      }\n    };\n  }\n  /**\n     * Subscribes to multiple message types using a single subscriber ID.\n     *\n     * @param id The subscriber ID.\n     * @param setup A function that receives a `subscribe` helper to register callbacks.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'A' } | { type: 'B' }>();\n   * siggn.subscribeMany('subscriber-1', (subscribe) => {\n   *   subscribe('A', () => console.log('A received'));\n   *   subscribe('B', () => console.log('B received'));\n   * });\n   * ```\n     */\n  subscribeMany(s, i) {\n    i((t, r) => this.subscribe(s, t, r));\n  }\n  /**\n     * Subscribes to a specific message type.\n     *\n     * @param id The subscriber ID.\n     * @param type The message type to subscribe to.\n     * @param callback The function to call when a message of the specified type is published.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event', payload: string }>();\n   * siggn.subscribe('subscriber-1', 'my-event', (msg) => {\n   *   console.log(msg.payload);\n   * });\n   * ```\n     */\n  subscribe(s, i, t) {\n    this.subscriptions.has(i) || this.subscriptions.set(i, []), this.registry.register(t, s), this.subscriptions.get(i)?.push({ id: s, ref: new WeakRef(t) });\n  }\n  /**\n     * Subscribes to all message types. The callback will be invoked for every\n     * message published on the bus.\n     *\n     * @param id The subscriber ID.\n     * @param callback The function to call for any message.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'A' } | { type: 'B' }>();\n   * siggn.subscribeAll('logger', (msg) => {\n   *   console.log(`Received message of type: ${msg.type}`);\n   * });\n   * ```\n     */\n  subscribeAll(s, i) {\n    this.registryGlobal.register(i, s), this.globalSubscriptions.push({ id: s, ref: new WeakRef(i) });\n  }\n  /**\n     * Publishes a message to all relevant subscribers.\n     *\n     * @param msg The message to publish.\n     * @category Publishing\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribe('sub-1', 'my-event', () => console.log('received'));\n   * siggn.publish({ type: 'my-event' }); // \"received\"\n   * ```\n     */\n  publish(s) {\n    this.globalSubscriptions.forEach((i) => {\n      const t = i.ref.deref();\n      if (!t) {\n        this.unsubscribeGlobal(i.id);\n        return;\n      }\n      t(s);\n    }), this.subscriptions.has(s.type) && this.subscriptions.get(s.type)?.forEach((i) => {\n      const t = i.ref.deref();\n      if (!t) {\n        this.unsubscribe(i.id);\n        return;\n      }\n      t(s);\n    });\n  }\n  /**\n     * Removes all subscriptions (both specific and global) for a given\n     * subscriber ID.\n     *\n     * @param id The subscriber ID to unsubscribe.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribe('sub-1', 'my-event', () => console.log('received'));\n   * siggn.unsubscribe('sub-1');\n   * siggn.publish({ type: 'my-event' }); // (nothing is logged)\n   * ```\n     */\n  unsubscribe(s) {\n    this.unsubscribeGlobal(s);\n    for (const [i, t] of this.subscriptions)\n      this.subscriptions.set(\n        i,\n        t.filter((r) => r.id !== s)\n      );\n  }\n  /**\n     * Removes a global subscription for a given subscriber ID.\n     *\n     * @param id The subscriber ID to unsubscribe.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribeAll('logger', console.log);\n   * siggn.unsubscribeGlobal('logger');\n   * siggn.publish({ type: 'my-event' }); // (nothing is logged)\n   * ```\n     */\n  unsubscribeGlobal(s) {\n    this.globalSubscriptions = this.globalSubscriptions.filter((i) => i.id !== s);\n  }\n  /**\n     * Returns the total number of subscriptions (both specific and global).\n     *\n     * @category Subscription\n     * @since 0.1.0\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribe('sub-1', 'my-event', () => {});\n   * siggn.subscribeAll('logger', () => {});\n   * console.log(siggn.subscriptionsCount); // 2\n   * ```\n     */\n  get subscriptionsCount() {\n    let s = 0;\n    return this.subscriptions.forEach((i) => {\n      s += i.length;\n    }), s += this.globalSubscriptions.length, s;\n  }\n}\nexport {\n  e as Siggn\n};\n//# sourceMappingURL=index.es.js.map\n","import { type Msg, Siggn } from '@siggn/core';\nimport type { SubscriptionOptions } from 'packages/react/src/types';\nimport { useEffect, useMemo, useRef, type DependencyList } from 'react';\n\n/**\n * Creates and returns a `Siggn` instance that persists for the lifetime of the component.\n * This is useful for creating a message bus scoped to a component and its children.\n *\n * @template T A union of all possible message types for the new instance.\n * @returns A `Siggn<T>` instance.\n * @category Lifecycle\n * @since 0.0.1\n * @example\n * \n```tsx\n * function MyComponent() {\n *   const localSiggn = useSiggn<{ type: 'local-event' }>();\n *   // ...\n * }\n * ```\n */\nexport function useSiggn<T extends Msg>(): Siggn<T> {\n  const siggn = useRef(new Siggn<T>());\n  return siggn.current;\n}\n\n/**\n * Subscribes to messages and automatically unsubscribes when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribe(siggn, (subscribe) => {\n *     subscribe('user-created', (msg) => console.log(msg.name));\n *   });\n *   // ...\n * }\n * ```\n */\nexport function useSubscribe<T extends Msg>(\n  options: SubscriptionOptions<T>,\n  setup: (\n    subscribe: <K extends T['type']>(\n      type: K,\n      callback: (msg: Extract<T, { type: K }>) => void,\n    ) => void,\n  ) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeMany(id, setup);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to all messages on a `Siggn` instance and automatically unsubscribes\n * when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param callback The function to call for any message.\n * @param deps An optional dependency array to control when the subscription is re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn';\n *\n * function LoggerComponent() {\n *   useSubscribeAll(siggn, (msg) => {\n *     console.log(`[LOG]: ${msg.type}`);\n *   }, []);\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeAll<T extends Msg>(\n  options: SubscriptionOptions<T>,\n  callback: (msg: T) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeAll(id, callback);\n\n    return () => {\n      instance.unsubscribeGlobal(id);\n    };\n  }, [instance, id, ...deps]);\n}\n"],"names":["e","t","useSiggn","useRef","Siggn","useSubscribe","options","setup","deps","instance","useMemo","id","useEffect","useSubscribeAll","callback"],"mappings":"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"}
+{"version":3,"file":"index.cjs.js","sources":["../src/hooks.ts"],"sourcesContent":["import { type Msg, Siggn } from '@siggn/core';\n\nimport { useEffect, useMemo, useState, type DependencyList } from 'react';\n\n/**\n * Creates and returns a `Siggn` instance that persists for the lifetime of the component.\n * This is useful for creating a message bus scoped to a component and its children.\n *\n * @template T A union of all possible message types for the new instance.\n * @returns A `Siggn<T>` instance.\n * @category Lifecycle\n * @since 0.0.1\n * @example\n * \n```tsx\n * function MyComponent() {\n *   const localSiggn = useSiggn<{ type: 'local-event' }>();\n *   // ...\n * }\n * ```\n */\nexport function useSiggn<T extends Msg>(): Siggn<T> {\n  const [siggn] = useState(new Siggn<T>());\n  return siggn;\n}\n\n/**\n * Subscribes to multiple messages and automatically unsubscribes when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribeMany(siggn, (subscribe) => {\n *     subscribe('user-created', (msg) => console.log(msg.name));\n *     subscribe('user-updated', (msg) => console.log(msg.name));\n *   });\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeMany<M extends Msg>(\n  options: Siggn<M> | { instance: Siggn<M>; id?: string },\n  setup: (\n    subscribe: <T extends M['type']>(\n      type: T,\n      callback: (msg: Extract<M, { type: T }>) => void,\n    ) => void,\n  ) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeMany(id, setup);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to a single message and automatically unsubscribe when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribe(siggn, 'user-created', (msg) => console.log(msg.name));\n *   // ...\n * }\n * ```\n */\nexport function useSubscribe<M extends Msg, T extends string>(\n  options: Siggn<M> | { instance: Siggn<M>; id?: string },\n  type: T,\n  callback: (msg: Extract<M, { type: T }>) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribe(id, type, callback);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to all messages on a `Siggn` instance and automatically unsubscribes\n * when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param callback The function to call for any message.\n * @param deps An optional dependency array to control when the subscription is re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn';\n *\n * function LoggerComponent() {\n *   useSubscribeAll(siggn, (msg) => {\n *     console.log(`[LOG]: ${msg.type}`);\n *   }, []);\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeAll<T extends Msg>(\n  options: Siggn<T> | { instance: Siggn<T>; id?: string },\n  callback: (msg: T) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeAll(id, callback);\n\n    return () => {\n      instance.unsubscribeGlobal(id);\n    };\n  }, [instance, id, ...deps]);\n}\n"],"names":["useSiggn","siggn","useState","Siggn","useSubscribeMany","options","setup","deps","instance","useMemo","id","useEffect","useSubscribe","type","callback","useSubscribeAll"],"mappings":"kIAqBO,SAASA,GAAoC,CAClD,KAAM,CAACC,CAAK,EAAIC,WAAS,IAAIC,EAAAA,KAAU,EACvC,OAAOF,CACT,CAyBO,SAASG,EACdC,EACAC,EAMAC,EAAuB,CAAA,EACvB,CACA,MAAMC,EAAWC,EAAAA,QACf,IAAOJ,aAAmBF,EAAAA,MAAQE,EAAUA,EAAQ,SACpD,CAACA,CAAO,CAAA,EAEJK,EAAKD,EAAAA,QAAQ,IAAMD,EAAS,OAAO,OAAQH,EAAUA,EAAQ,GAAK,MAAS,EAAG,CAACG,CAAQ,CAAC,EAE9FG,EAAAA,UAAU,KACRH,EAAS,cAAcE,EAAIJ,CAAK,EAEzB,IAAM,CACXE,EAAS,YAAYE,CAAE,CACzB,GACC,CAACF,EAAUE,EAAI,GAAGH,CAAI,CAAC,CAC5B,CAsBO,SAASK,EACdP,EACAQ,EACAC,EACAP,EAAuB,CAAA,EACvB,CACA,MAAMC,EAAWC,EAAAA,QACf,IAAOJ,aAAmBF,EAAAA,MAAQE,EAAUA,EAAQ,SACpD,CAACA,CAAO,CAAA,EAEJK,EAAKD,EAAAA,QAAQ,IAAMD,EAAS,OAAO,OAAQH,EAAUA,EAAQ,GAAK,MAAS,EAAG,CAACG,CAAQ,CAAC,EAE9FG,EAAAA,UAAU,KACRH,EAAS,UAAUE,EAAIG,EAAMC,CAAQ,EAE9B,IAAM,CACXN,EAAS,YAAYE,CAAE,CACzB,GACC,CAACF,EAAUE,EAAI,GAAGH,CAAI,CAAC,CAC5B,CAyBO,SAASQ,EACdV,EACAS,EACAP,EAAuB,CAAA,EACvB,CACA,MAAMC,EAAWC,EAAAA,QACf,IAAOJ,aAAmBF,EAAAA,MAAQE,EAAUA,EAAQ,SACpD,CAACA,CAAO,CAAA,EAEJK,EAAKD,EAAAA,QAAQ,IAAMD,EAAS,OAAO,OAAQH,EAAUA,EAAQ,GAAK,MAAS,EAAG,CAACG,CAAQ,CAAC,EAE9FG,EAAAA,UAAU,KACRH,EAAS,aAAaE,EAAII,CAAQ,EAE3B,IAAM,CACXN,EAAS,kBAAkBE,CAAE,CAC/B,GACC,CAACF,EAAUE,EAAI,GAAGH,CAAI,CAAC,CAC5B"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './hooks.js';
+export * from './types.js';
 export * from '@siggn/core';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/index.es.js

@@ -1,281 +1,41 @@
-import { useRef as c, useMemo as b, useEffect as u } from "react";
-class n {
-  nextId = 0;
-  subscriptions;
-  globalSubscriptions = [];
-  /**
-   * A FinalizationRegistry to automatically unregister specific subscriptions
-   * when the subscribed callback function is garbage collected.
-   */
-  registry = new FinalizationRegistry((s) => {
-    this.unsubscribe(s);
-  });
-  /**
-   * A FinalizationRegistry to automatically unregister global subscriptions
-   * when the subscribed callback function is garbage collected.
-   */
-  registryGlobal = new FinalizationRegistry((s) => {
-    this.unsubscribeGlobal(s);
-  });
-  /**
-   * Creates a new Siggn instance.
-   * @category Lifecycle
-   * @since 0.0.5
-   */
-  constructor() {
-    this.subscriptions = /* @__PURE__ */ new Map();
-  }
-  /**
-     * Creates a new, independent `Siggn` instance that inherits the message
-     * types of its parent and adds new ones.
-     *
-     * @template C The new message types to add.
-     * @returns A new `Siggn` instance with combined message types.
-     * @category Lifecycle
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const baseSiggn = new Siggn<{ type: 'A' }>();
-   * const childSiggn = baseSiggn.createClone<{ type: 'B' }>();
-   * // childSiggn can now publish and subscribe to types 'A' and 'B'.
-   * ```
-     */
-  createClone() {
-    return new n();
-  }
-  /**
-     * Generates a unique ID for a subscriber.
-     * If an ID is provided, it will be used; otherwise, a new one is generated.
-     *
-     * @param id An optional ID to use.
-     * @returns A unique subscriber ID.
-     * @category Utilities
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn();
-   * const id1 = siggn.makeId(); // e.g., "sub_0"
-   * const id2 = siggn.makeId('custom-id'); // "custom-id"
-   * ```
-     */
-  makeId(s) {
-    return s ?? `sub_${(this.nextId++).toString(36)}`;
-  }
-  /**
-     * Creates a subscription helper object that is pre-configured with a
-     * specific subscriber ID. This simplifies managing multiple subscriptions
-     * for a single component or service.
-     *
-     * @param id The subscriber ID to use for all subscriptions.
-     * @returns An object with `subscribe`, `unsubscribe`, `subscribeMany`, and `subscribeAll` methods.
-     * @category Subscription
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'event' }>();
-   * const component = siggn.make('my-component');
-   * component.subscribe('event', () => console.log('event received!'));
-   * component.unsubscribe();
-   * ```
-     */
-  make(s) {
-    return {
-      subscribe: (i, e) => {
-        this.subscribe(s, i, e);
-      },
-      unsubscribe: () => {
-        this.unsubscribe(s);
-      },
-      subscribeMany: (i) => {
-        this.subscribeMany(s, i);
-      },
-      subscribeAll: (i) => {
-        this.subscribeAll(s, i);
-      }
-    };
-  }
-  /**
-     * Subscribes to multiple message types using a single subscriber ID.
-     *
-     * @param id The subscriber ID.
-     * @param setup A function that receives a `subscribe` helper to register callbacks.
-     * @category Subscription
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'A' } | { type: 'B' }>();
-   * siggn.subscribeMany('subscriber-1', (subscribe) => {
-   *   subscribe('A', () => console.log('A received'));
-   *   subscribe('B', () => console.log('B received'));
-   * });
-   * ```
-     */
-  subscribeMany(s, i) {
-    i((e, r) => this.subscribe(s, e, r));
-  }
-  /**
-     * Subscribes to a specific message type.
-     *
-     * @param id The subscriber ID.
-     * @param type The message type to subscribe to.
-     * @param callback The function to call when a message of the specified type is published.
-     * @category Subscription
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'my-event', payload: string }>();
-   * siggn.subscribe('subscriber-1', 'my-event', (msg) => {
-   *   console.log(msg.payload);
-   * });
-   * ```
-     */
-  subscribe(s, i, e) {
-    this.subscriptions.has(i) || this.subscriptions.set(i, []), this.registry.register(e, s), this.subscriptions.get(i)?.push({ id: s, ref: new WeakRef(e) });
-  }
-  /**
-     * Subscribes to all message types. The callback will be invoked for every
-     * message published on the bus.
-     *
-     * @param id The subscriber ID.
-     * @param callback The function to call for any message.
-     * @category Subscription
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'A' } | { type: 'B' }>();
-   * siggn.subscribeAll('logger', (msg) => {
-   *   console.log(`Received message of type: ${msg.type}`);
-   * });
-   * ```
-     */
-  subscribeAll(s, i) {
-    this.registryGlobal.register(i, s), this.globalSubscriptions.push({ id: s, ref: new WeakRef(i) });
-  }
-  /**
-     * Publishes a message to all relevant subscribers.
-     *
-     * @param msg The message to publish.
-     * @category Publishing
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'my-event' }>();
-   * siggn.subscribe('sub-1', 'my-event', () => console.log('received'));
-   * siggn.publish({ type: 'my-event' }); // "received"
-   * ```
-     */
-  publish(s) {
-    this.globalSubscriptions.forEach((i) => {
-      const e = i.ref.deref();
-      if (!e) {
-        this.unsubscribeGlobal(i.id);
-        return;
-      }
-      e(s);
-    }), this.subscriptions.has(s.type) && this.subscriptions.get(s.type)?.forEach((i) => {
-      const e = i.ref.deref();
-      if (!e) {
-        this.unsubscribe(i.id);
-        return;
-      }
-      e(s);
-    });
-  }
-  /**
-     * Removes all subscriptions (both specific and global) for a given
-     * subscriber ID.
-     *
-     * @param id The subscriber ID to unsubscribe.
-     * @category Subscription
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'my-event' }>();
-   * siggn.subscribe('sub-1', 'my-event', () => console.log('received'));
-   * siggn.unsubscribe('sub-1');
-   * siggn.publish({ type: 'my-event' }); // (nothing is logged)
-   * ```
-     */
-  unsubscribe(s) {
-    this.unsubscribeGlobal(s);
-    for (const [i, e] of this.subscriptions)
-      this.subscriptions.set(
-        i,
-        e.filter((r) => r.id !== s)
-      );
-  }
-  /**
-     * Removes a global subscription for a given subscriber ID.
-     *
-     * @param id The subscriber ID to unsubscribe.
-     * @category Subscription
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'my-event' }>();
-   * siggn.subscribeAll('logger', console.log);
-   * siggn.unsubscribeGlobal('logger');
-   * siggn.publish({ type: 'my-event' }); // (nothing is logged)
-   * ```
-     */
-  unsubscribeGlobal(s) {
-    this.globalSubscriptions = this.globalSubscriptions.filter((i) => i.id !== s);
-  }
-  /**
-     * Returns the total number of subscriptions (both specific and global).
-     *
-     * @category Subscription
-     * @since 0.1.0
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'my-event' }>();
-   * siggn.subscribe('sub-1', 'my-event', () => {});
-   * siggn.subscribeAll('logger', () => {});
-   * console.log(siggn.subscriptionsCount); // 2
-   * ```
-     */
-  get subscriptionsCount() {
-    let s = 0;
-    return this.subscriptions.forEach((i) => {
-      s += i.length;
-    }), s += this.globalSubscriptions.length, s;
-  }
+import { Siggn as s } from "@siggn/core";
+export * from "@siggn/core";
+import { useState as t, useMemo as i, useEffect as a } from "react";
+function m() {
+  const [e] = t(new s());
+  return e;
 }
-function a() {
-  return c(new n()).current;
+function g(e, u, r = []) {
+  const n = i(
+    () => e instanceof s ? e : e.instance,
+    [e]
+  ), c = i(() => n.makeId("id" in e ? e.id : void 0), [n]);
+  a(() => (n.subscribeMany(c, u), () => {
+    n.unsubscribe(c);
+  }), [n, c, ...r]);
 }
-function o(t, s, i = []) {
-  const e = b(
-    () => t instanceof n ? t : t.instance,
-    [t]
-  ), r = b(() => e.makeId("id" in t ? t.id : void 0), [e]);
-  u(() => (e.subscribeMany(r, s), () => {
-    e.unsubscribe(r);
-  }), [e, r, ...i]);
+function l(e, u, r, n = []) {
+  const c = i(
+    () => e instanceof s ? e : e.instance,
+    [e]
+  ), b = i(() => c.makeId("id" in e ? e.id : void 0), [c]);
+  a(() => (c.subscribe(b, u, r), () => {
+    c.unsubscribe(b);
+  }), [c, b, ...n]);
 }
-function h(t, s, i = []) {
-  const e = b(
-    () => t instanceof n ? t : t.instance,
-    [t]
-  ), r = b(() => e.makeId("id" in t ? t.id : void 0), [e]);
-  u(() => (e.subscribeAll(r, s), () => {
-    e.unsubscribeGlobal(r);
-  }), [e, r, ...i]);
+function S(e, u, r = []) {
+  const n = i(
+    () => e instanceof s ? e : e.instance,
+    [e]
+  ), c = i(() => n.makeId("id" in e ? e.id : void 0), [n]);
+  a(() => (n.subscribeAll(c, u), () => {
+    n.unsubscribeGlobal(c);
+  }), [n, c, ...r]);
 }
 export {
-  n as Siggn,
-  a as useSiggn,
-  o as useSubscribe,
-  h as useSubscribeAll
+  m as useSiggn,
+  l as useSubscribe,
+  S as useSubscribeAll,
+  g as useSubscribeMany
 };
 //# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.es.js","sources":["../../core/dist/index.es.js","../src/hooks.ts"],"sourcesContent":["class e {\n  nextId = 0;\n  subscriptions;\n  globalSubscriptions = [];\n  /**\n   * A FinalizationRegistry to automatically unregister specific subscriptions\n   * when the subscribed callback function is garbage collected.\n   */\n  registry = new FinalizationRegistry((s) => {\n    this.unsubscribe(s);\n  });\n  /**\n   * A FinalizationRegistry to automatically unregister global subscriptions\n   * when the subscribed callback function is garbage collected.\n   */\n  registryGlobal = new FinalizationRegistry((s) => {\n    this.unsubscribeGlobal(s);\n  });\n  /**\n   * Creates a new Siggn instance.\n   * @category Lifecycle\n   * @since 0.0.5\n   */\n  constructor() {\n    this.subscriptions = /* @__PURE__ */ new Map();\n  }\n  /**\n     * Creates a new, independent `Siggn` instance that inherits the message\n     * types of its parent and adds new ones.\n     *\n     * @template C The new message types to add.\n     * @returns A new `Siggn` instance with combined message types.\n     * @category Lifecycle\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const baseSiggn = new Siggn<{ type: 'A' }>();\n   * const childSiggn = baseSiggn.createClone<{ type: 'B' }>();\n   * // childSiggn can now publish and subscribe to types 'A' and 'B'.\n   * ```\n     */\n  createClone() {\n    return new e();\n  }\n  /**\n     * Generates a unique ID for a subscriber.\n     * If an ID is provided, it will be used; otherwise, a new one is generated.\n     *\n     * @param id An optional ID to use.\n     * @returns A unique subscriber ID.\n     * @category Utilities\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn();\n   * const id1 = siggn.makeId(); // e.g., \"sub_0\"\n   * const id2 = siggn.makeId('custom-id'); // \"custom-id\"\n   * ```\n     */\n  makeId(s) {\n    return s ?? `sub_${(this.nextId++).toString(36)}`;\n  }\n  /**\n     * Creates a subscription helper object that is pre-configured with a\n     * specific subscriber ID. This simplifies managing multiple subscriptions\n     * for a single component or service.\n     *\n     * @param id The subscriber ID to use for all subscriptions.\n     * @returns An object with `subscribe`, `unsubscribe`, `subscribeMany`, and `subscribeAll` methods.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'event' }>();\n   * const component = siggn.make('my-component');\n   * component.subscribe('event', () => console.log('event received!'));\n   * component.unsubscribe();\n   * ```\n     */\n  make(s) {\n    return {\n      subscribe: (i, t) => {\n        this.subscribe(s, i, t);\n      },\n      unsubscribe: () => {\n        this.unsubscribe(s);\n      },\n      subscribeMany: (i) => {\n        this.subscribeMany(s, i);\n      },\n      subscribeAll: (i) => {\n        this.subscribeAll(s, i);\n      }\n    };\n  }\n  /**\n     * Subscribes to multiple message types using a single subscriber ID.\n     *\n     * @param id The subscriber ID.\n     * @param setup A function that receives a `subscribe` helper to register callbacks.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'A' } | { type: 'B' }>();\n   * siggn.subscribeMany('subscriber-1', (subscribe) => {\n   *   subscribe('A', () => console.log('A received'));\n   *   subscribe('B', () => console.log('B received'));\n   * });\n   * ```\n     */\n  subscribeMany(s, i) {\n    i((t, r) => this.subscribe(s, t, r));\n  }\n  /**\n     * Subscribes to a specific message type.\n     *\n     * @param id The subscriber ID.\n     * @param type The message type to subscribe to.\n     * @param callback The function to call when a message of the specified type is published.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event', payload: string }>();\n   * siggn.subscribe('subscriber-1', 'my-event', (msg) => {\n   *   console.log(msg.payload);\n   * });\n   * ```\n     */\n  subscribe(s, i, t) {\n    this.subscriptions.has(i) || this.subscriptions.set(i, []), this.registry.register(t, s), this.subscriptions.get(i)?.push({ id: s, ref: new WeakRef(t) });\n  }\n  /**\n     * Subscribes to all message types. The callback will be invoked for every\n     * message published on the bus.\n     *\n     * @param id The subscriber ID.\n     * @param callback The function to call for any message.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'A' } | { type: 'B' }>();\n   * siggn.subscribeAll('logger', (msg) => {\n   *   console.log(`Received message of type: ${msg.type}`);\n   * });\n   * ```\n     */\n  subscribeAll(s, i) {\n    this.registryGlobal.register(i, s), this.globalSubscriptions.push({ id: s, ref: new WeakRef(i) });\n  }\n  /**\n     * Publishes a message to all relevant subscribers.\n     *\n     * @param msg The message to publish.\n     * @category Publishing\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribe('sub-1', 'my-event', () => console.log('received'));\n   * siggn.publish({ type: 'my-event' }); // \"received\"\n   * ```\n     */\n  publish(s) {\n    this.globalSubscriptions.forEach((i) => {\n      const t = i.ref.deref();\n      if (!t) {\n        this.unsubscribeGlobal(i.id);\n        return;\n      }\n      t(s);\n    }), this.subscriptions.has(s.type) && this.subscriptions.get(s.type)?.forEach((i) => {\n      const t = i.ref.deref();\n      if (!t) {\n        this.unsubscribe(i.id);\n        return;\n      }\n      t(s);\n    });\n  }\n  /**\n     * Removes all subscriptions (both specific and global) for a given\n     * subscriber ID.\n     *\n     * @param id The subscriber ID to unsubscribe.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribe('sub-1', 'my-event', () => console.log('received'));\n   * siggn.unsubscribe('sub-1');\n   * siggn.publish({ type: 'my-event' }); // (nothing is logged)\n   * ```\n     */\n  unsubscribe(s) {\n    this.unsubscribeGlobal(s);\n    for (const [i, t] of this.subscriptions)\n      this.subscriptions.set(\n        i,\n        t.filter((r) => r.id !== s)\n      );\n  }\n  /**\n     * Removes a global subscription for a given subscriber ID.\n     *\n     * @param id The subscriber ID to unsubscribe.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribeAll('logger', console.log);\n   * siggn.unsubscribeGlobal('logger');\n   * siggn.publish({ type: 'my-event' }); // (nothing is logged)\n   * ```\n     */\n  unsubscribeGlobal(s) {\n    this.globalSubscriptions = this.globalSubscriptions.filter((i) => i.id !== s);\n  }\n  /**\n     * Returns the total number of subscriptions (both specific and global).\n     *\n     * @category Subscription\n     * @since 0.1.0\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribe('sub-1', 'my-event', () => {});\n   * siggn.subscribeAll('logger', () => {});\n   * console.log(siggn.subscriptionsCount); // 2\n   * ```\n     */\n  get subscriptionsCount() {\n    let s = 0;\n    return this.subscriptions.forEach((i) => {\n      s += i.length;\n    }), s += this.globalSubscriptions.length, s;\n  }\n}\nexport {\n  e as Siggn\n};\n//# sourceMappingURL=index.es.js.map\n","import { type Msg, Siggn } from '@siggn/core';\nimport type { SubscriptionOptions } from 'packages/react/src/types';\nimport { useEffect, useMemo, useRef, type DependencyList } from 'react';\n\n/**\n * Creates and returns a `Siggn` instance that persists for the lifetime of the component.\n * This is useful for creating a message bus scoped to a component and its children.\n *\n * @template T A union of all possible message types for the new instance.\n * @returns A `Siggn<T>` instance.\n * @category Lifecycle\n * @since 0.0.1\n * @example\n * \n```tsx\n * function MyComponent() {\n *   const localSiggn = useSiggn<{ type: 'local-event' }>();\n *   // ...\n * }\n * ```\n */\nexport function useSiggn<T extends Msg>(): Siggn<T> {\n  const siggn = useRef(new Siggn<T>());\n  return siggn.current;\n}\n\n/**\n * Subscribes to messages and automatically unsubscribes when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribe(siggn, (subscribe) => {\n *     subscribe('user-created', (msg) => console.log(msg.name));\n *   });\n *   // ...\n * }\n * ```\n */\nexport function useSubscribe<T extends Msg>(\n  options: SubscriptionOptions<T>,\n  setup: (\n    subscribe: <K extends T['type']>(\n      type: K,\n      callback: (msg: Extract<T, { type: K }>) => void,\n    ) => void,\n  ) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeMany(id, setup);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to all messages on a `Siggn` instance and automatically unsubscribes\n * when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param callback The function to call for any message.\n * @param deps An optional dependency array to control when the subscription is re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn';\n *\n * function LoggerComponent() {\n *   useSubscribeAll(siggn, (msg) => {\n *     console.log(`[LOG]: ${msg.type}`);\n *   }, []);\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeAll<T extends Msg>(\n  options: SubscriptionOptions<T>,\n  callback: (msg: T) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeAll(id, callback);\n\n    return () => {\n      instance.unsubscribeGlobal(id);\n    };\n  }, [instance, id, ...deps]);\n}\n"],"names":["e","t","useSiggn","useRef","Siggn","useSubscribe","options","setup","deps","instance","useMemo","id","useEffect","useSubscribeAll","callback"],"mappings":"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"}
+{"version":3,"file":"index.es.js","sources":["../src/hooks.ts"],"sourcesContent":["import { type Msg, Siggn } from '@siggn/core';\n\nimport { useEffect, useMemo, useState, type DependencyList } from 'react';\n\n/**\n * Creates and returns a `Siggn` instance that persists for the lifetime of the component.\n * This is useful for creating a message bus scoped to a component and its children.\n *\n * @template T A union of all possible message types for the new instance.\n * @returns A `Siggn<T>` instance.\n * @category Lifecycle\n * @since 0.0.1\n * @example\n * \n```tsx\n * function MyComponent() {\n *   const localSiggn = useSiggn<{ type: 'local-event' }>();\n *   // ...\n * }\n * ```\n */\nexport function useSiggn<T extends Msg>(): Siggn<T> {\n  const [siggn] = useState(new Siggn<T>());\n  return siggn;\n}\n\n/**\n * Subscribes to multiple messages and automatically unsubscribes when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribeMany(siggn, (subscribe) => {\n *     subscribe('user-created', (msg) => console.log(msg.name));\n *     subscribe('user-updated', (msg) => console.log(msg.name));\n *   });\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeMany<M extends Msg>(\n  options: Siggn<M> | { instance: Siggn<M>; id?: string },\n  setup: (\n    subscribe: <T extends M['type']>(\n      type: T,\n      callback: (msg: Extract<M, { type: T }>) => void,\n    ) => void,\n  ) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeMany(id, setup);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to a single message and automatically unsubscribe when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribe(siggn, 'user-created', (msg) => console.log(msg.name));\n *   // ...\n * }\n * ```\n */\nexport function useSubscribe<M extends Msg, T extends string>(\n  options: Siggn<M> | { instance: Siggn<M>; id?: string },\n  type: T,\n  callback: (msg: Extract<M, { type: T }>) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribe(id, type, callback);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to all messages on a `Siggn` instance and automatically unsubscribes\n * when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param callback The function to call for any message.\n * @param deps An optional dependency array to control when the subscription is re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn';\n *\n * function LoggerComponent() {\n *   useSubscribeAll(siggn, (msg) => {\n *     console.log(`[LOG]: ${msg.type}`);\n *   }, []);\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeAll<T extends Msg>(\n  options: Siggn<T> | { instance: Siggn<T>; id?: string },\n  callback: (msg: T) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeAll(id, callback);\n\n    return () => {\n      instance.unsubscribeGlobal(id);\n    };\n  }, [instance, id, ...deps]);\n}\n"],"names":["useSiggn","siggn","useState","Siggn","useSubscribeMany","options","setup","deps","instance","useMemo","id","useEffect","useSubscribe","type","callback","useSubscribeAll"],"mappings":";;;AAqBO,SAASA,IAAoC;AAClD,QAAM,CAACC,CAAK,IAAIC,EAAS,IAAIC,GAAU;AACvC,SAAOF;AACT;AAyBO,SAASG,EACdC,GACAC,GAMAC,IAAuB,CAAA,GACvB;AACA,QAAMC,IAAWC;AAAA,IACf,MAAOJ,aAAmBF,IAAQE,IAAUA,EAAQ;AAAA,IACpD,CAACA,CAAO;AAAA,EAAA,GAEJK,IAAKD,EAAQ,MAAMD,EAAS,OAAO,QAAQH,IAAUA,EAAQ,KAAK,MAAS,GAAG,CAACG,CAAQ,CAAC;AAE9F,EAAAG,EAAU,OACRH,EAAS,cAAcE,GAAIJ,CAAK,GAEzB,MAAM;AACX,IAAAE,EAAS,YAAYE,CAAE;AAAA,EACzB,IACC,CAACF,GAAUE,GAAI,GAAGH,CAAI,CAAC;AAC5B;AAsBO,SAASK,EACdP,GACAQ,GACAC,GACAP,IAAuB,CAAA,GACvB;AACA,QAAMC,IAAWC;AAAA,IACf,MAAOJ,aAAmBF,IAAQE,IAAUA,EAAQ;AAAA,IACpD,CAACA,CAAO;AAAA,EAAA,GAEJK,IAAKD,EAAQ,MAAMD,EAAS,OAAO,QAAQH,IAAUA,EAAQ,KAAK,MAAS,GAAG,CAACG,CAAQ,CAAC;AAE9F,EAAAG,EAAU,OACRH,EAAS,UAAUE,GAAIG,GAAMC,CAAQ,GAE9B,MAAM;AACX,IAAAN,EAAS,YAAYE,CAAE;AAAA,EACzB,IACC,CAACF,GAAUE,GAAI,GAAGH,CAAI,CAAC;AAC5B;AAyBO,SAASQ,EACdV,GACAS,GACAP,IAAuB,CAAA,GACvB;AACA,QAAMC,IAAWC;AAAA,IACf,MAAOJ,aAAmBF,IAAQE,IAAUA,EAAQ;AAAA,IACpD,CAACA,CAAO;AAAA,EAAA,GAEJK,IAAKD,EAAQ,MAAMD,EAAS,OAAO,QAAQH,IAAUA,EAAQ,KAAK,MAAS,GAAG,CAACG,CAAQ,CAAC;AAE9F,EAAAG,EAAU,OACRH,EAAS,aAAaE,GAAII,CAAQ,GAE3B,MAAM;AACX,IAAAN,EAAS,kBAAkBE,CAAE;AAAA,EAC/B,IACC,CAACF,GAAUE,GAAI,GAAGH,CAAI,CAAC;AAC5B;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siggn/react",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "A lightweight type safe message bus system for React",
   "keywords": [
     "pub/sub",
@@ -58,7 +58,7 @@
     "react": ">=18 <20"
   },
   "dependencies": {
-    "@siggn/core": "0.1.0"
+    "@siggn/core": "0.1.1"
   },
   "scripts": {
     "dev": "vite build --watch",