crosshook 1.0.6 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Manu Mohan
+
+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

@@ -196,16 +196,47 @@ Use React state / Zustand / Redux instead.
 
 ## 🔷 TypeScript Usage (Optional)
 
-You can strongly type events:
+crosshook supports global event typing via module augmentation.
+
+This provides:
+
+✅ Event name autocomplete
+✅ Payload type safety
+✅ No generics required
+
+✅ 1. Create crosshook.d.ts
+
+Place anywhere TypeScript can see (recommended: src/):
+
+``` ts
+// src/crosshook.d.ts
+import "crosshook";
+
+declare module "crosshook" {
+  interface CrosshookEvents {
+    "toast.show": { message: string };
+    "modal.open": { id: string };
+    "user.login": { userId: number };
+  }
+}
+```
+
+✅ 2. Use normally
 
 ``` ts
-type Events = {
-  "toast.show": { message: string };
-  "modal.open": void;
-};
+import { useRegister, call } from "crosshook";
+
+// Listener
+useRegister("toast.show", (payload) => {
+  // payload is typed as { message: string }
+  console.log(payload.message);
+});
+
+// Caller
+call("toast.show", { message: "Hello!" });
+// 👆 TypeScript error if payload wrong
 ```
 
-(Advanced typed helpers coming soon)
 
 ------------------------------------------------------------------------
 
@@ -252,4 +283,3 @@ Because not every interaction needs:
 ❌ Heavy state libraries
 
 Sometimes you just need a tiny event bridge.
-

package/dist/index.d.mts

@@ -6,12 +6,9 @@ type Handler<T = unknown> = (payload: T) => void;
 
 declare function register<T = any>(event: string, handler: Handler<T>): () => void;
 
-/** ✅ Typed overload */
 declare function call<K extends EventKey>(event: K, payload: EventPayload<K>): void;
-/** ✅ Void payload overload */
 declare function call<K extends EventKey>(event: K): void;
 
-/** ✅ STRICT typed overload */
 declare function useRegister<K extends EventKey>(event: K, handler: Handler<EventPayload<K>>): void;
 declare function useBridge(): {
     call: typeof call;

package/dist/index.d.ts

@@ -6,12 +6,9 @@ type Handler<T = unknown> = (payload: T) => void;
 
 declare function register<T = any>(event: string, handler: Handler<T>): () => void;
 
-/** ✅ Typed overload */
 declare function call<K extends EventKey>(event: K, payload: EventPayload<K>): void;
-/** ✅ Void payload overload */
 declare function call<K extends EventKey>(event: K): void;
 
-/** ✅ STRICT typed overload */
 declare function useRegister<K extends EventKey>(event: K, handler: Handler<EventPayload<K>>): void;
 declare function useBridge(): {
     call: typeof call;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/bridge.ts","../src/hooks.ts"],"sourcesContent":["export { call, register } from \"./bridge\";\nexport { useBridge, useRegister } from \"./hooks\";\n\nexport type { Handler } from \"./types\";\n\n/** 🔥 MUST export for augmentation */\nexport type { CrosshookEvents } from \"./types\";","import type { Handler } from \"./types\";\n\nconst listeners = new Map<string, Set<Handler>>();\n\nexport function register<T = any>(\n    event: string,\n    handler: Handler<T>\n) {\n    if (!listeners.has(event)) {\n        listeners.set(event, new Set());\n    }\n\n    listeners.get(event)!.add(handler as Handler);\n\n    return () => {\n        listeners.get(event)?.delete(handler as Handler);\n\n        if (listeners.get(event)?.size === 0) {\n            listeners.delete(event);\n        }\n    };\n}\n\nimport type { EventKey, EventPayload } from \"./types\";\n\n/** ✅ Typed overload */\nexport function call<K extends EventKey>(\n    event: K,\n    payload: EventPayload<K>\n): void;\n\n/** ✅ Void payload overload */\nexport function call<K extends EventKey>(\n    event: K\n): void;\n\n/** ✅ Fallback */\nexport function call(event: string, payload?: any) {\n    const handlers = listeners.get(event);\n\n    if (!handlers) {\n        if (process.env.NODE_ENV !== \"production\") {\n            console.warn(`[crosshook] No listeners for \"${event}\"`);\n        }\n        return;\n    }\n\n    handlers.forEach((handler) => {\n        try {\n            handler(payload);\n        } catch (err) {\n            console.error(\n                `[crosshook] Handler error in \"${event}\"`,\n                err\n            );\n        }\n    });\n}","import { useEffect } from \"react\";\nimport { register, call } from \"./bridge\";\nimport type { Handler, EventKey, EventPayload } from \"./types\";\n\n/** ✅ STRICT typed overload */\nexport function useRegister<K extends EventKey>(\n    event: K,\n    handler: Handler<EventPayload<K>>\n): void;\n\n/** ✅ fallback */\nexport function useRegister(\n    event: string,\n    handler: Handler\n) {\n    useEffect(() => {\n        const unregister = register(event, handler);\n        return unregister;\n    }, [event, handler]);\n}\n\nexport function useBridge() {\n    return { call };\n}"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,UAAAE,EAAA,aAAAC,EAAA,cAAAC,EAAA,gBAAAC,IAAA,eAAAC,EAAAN,GCEA,IAAMO,EAAY,IAAI,IAEf,SAASC,EACZC,EACAC,EACF,CACE,OAAKH,EAAU,IAAIE,CAAK,GACpBF,EAAU,IAAIE,EAAO,IAAI,GAAK,EAGlCF,EAAU,IAAIE,CAAK,EAAG,IAAIC,CAAkB,EAErC,IAAM,CACTH,EAAU,IAAIE,CAAK,GAAG,OAAOC,CAAkB,EAE3CH,EAAU,IAAIE,CAAK,GAAG,OAAS,GAC/BF,EAAU,OAAOE,CAAK,CAE9B,CACJ,CAgBO,SAASE,EAAKF,EAAeG,EAAe,CAC/C,IAAMC,EAAWN,EAAU,IAAIE,CAAK,EAEpC,GAAI,CAACI,EAAU,CACP,QAAQ,IAAI,WAAa,cACzB,QAAQ,KAAK,iCAAiCJ,CAAK,GAAG,EAE1D,MACJ,CAEAI,EAAS,QAASH,GAAY,CAC1B,GAAI,CACAA,EAAQE,CAAO,CACnB,OAASE,EAAK,CACV,QAAQ,MACJ,iCAAiCL,CAAK,IACtCK,CACJ,CACJ,CACJ,CAAC,CACL,CCzDA,IAAAC,EAA0B,iBAWnB,SAASC,EACZC,EACAC,EACF,IACE,aAAU,IACaC,EAASF,EAAOC,CAAO,EAE3C,CAACD,EAAOC,CAAO,CAAC,CACvB,CAEO,SAASE,GAAY,CACxB,MAAO,CAAE,KAAAC,CAAK,CAClB","names":["index_exports","__export","call","register","useBridge","useRegister","__toCommonJS","listeners","register","event","handler","call","payload","handlers","err","import_react","useRegister","event","handler","register","useBridge","call"]}
+{"version":3,"sources":["../src/index.ts","../src/bridge.ts","../src/hooks.ts"],"sourcesContent":["export { call, register } from \"./bridge\";\nexport { useBridge, useRegister } from \"./hooks\";\n\nexport type { Handler } from \"./types\";\n\nexport type { CrosshookEvents } from \"./types\";","import type { Handler } from \"./types\";\n\nconst listeners = new Map<string, Set<Handler>>();\n\nexport function register<T = any>(\n    event: string,\n    handler: Handler<T>\n) {\n    if (!listeners.has(event)) {\n        listeners.set(event, new Set());\n    }\n\n    listeners.get(event)!.add(handler as Handler);\n\n    return () => {\n        listeners.get(event)?.delete(handler as Handler);\n\n        if (listeners.get(event)?.size === 0) {\n            listeners.delete(event);\n        }\n    };\n}\n\nimport type { EventKey, EventPayload } from \"./types\";\n\nexport function call<K extends EventKey>(\n    event: K,\n    payload: EventPayload<K>\n): void;\n\nexport function call<K extends EventKey>(\n    event: K\n): void;\n\nexport function call(event: string, payload?: any) {\n    const handlers = listeners.get(event);\n\n    if (!handlers) {\n        if (process.env.NODE_ENV !== \"production\") {\n            console.warn(`[crosshook] No listeners for \"${event}\"`);\n        }\n        return;\n    }\n\n    handlers.forEach((handler) => {\n        try {\n            handler(payload);\n        } catch (err) {\n            console.error(\n                `[crosshook] Handler error in \"${event}\"`,\n                err\n            );\n        }\n    });\n}","import { useEffect } from \"react\";\nimport { register, call } from \"./bridge\";\nimport type { Handler, EventKey, EventPayload } from \"./types\";\n\nexport function useRegister<K extends EventKey>(\n    event: K,\n    handler: Handler<EventPayload<K>>\n): void;\n\nexport function useRegister(\n    event: string,\n    handler: Handler\n) {\n    useEffect(() => {\n        const unregister = register(event, handler);\n        return unregister;\n    }, [event, handler]);\n}\n\nexport function useBridge() {\n    return { call };\n}"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,UAAAE,EAAA,aAAAC,EAAA,cAAAC,EAAA,gBAAAC,IAAA,eAAAC,EAAAN,GCEA,IAAMO,EAAY,IAAI,IAEf,SAASC,EACZC,EACAC,EACF,CACE,OAAKH,EAAU,IAAIE,CAAK,GACpBF,EAAU,IAAIE,EAAO,IAAI,GAAK,EAGlCF,EAAU,IAAIE,CAAK,EAAG,IAAIC,CAAkB,EAErC,IAAM,CACTH,EAAU,IAAIE,CAAK,GAAG,OAAOC,CAAkB,EAE3CH,EAAU,IAAIE,CAAK,GAAG,OAAS,GAC/BF,EAAU,OAAOE,CAAK,CAE9B,CACJ,CAaO,SAASE,EAAKF,EAAeG,EAAe,CAC/C,IAAMC,EAAWN,EAAU,IAAIE,CAAK,EAEpC,GAAI,CAACI,EAAU,CACP,QAAQ,IAAI,WAAa,cACzB,QAAQ,KAAK,iCAAiCJ,CAAK,GAAG,EAE1D,MACJ,CAEAI,EAAS,QAASH,GAAY,CAC1B,GAAI,CACAA,EAAQE,CAAO,CACnB,OAASE,EAAK,CACV,QAAQ,MACJ,iCAAiCL,CAAK,IACtCK,CACJ,CACJ,CACJ,CAAC,CACL,CCtDA,IAAAC,EAA0B,iBASnB,SAASC,EACZC,EACAC,EACF,IACE,aAAU,IACaC,EAASF,EAAOC,CAAO,EAE3C,CAACD,EAAOC,CAAO,CAAC,CACvB,CAEO,SAASE,GAAY,CACxB,MAAO,CAAE,KAAAC,CAAK,CAClB","names":["index_exports","__export","call","register","useBridge","useRegister","__toCommonJS","listeners","register","event","handler","call","payload","handlers","err","import_react","useRegister","event","handler","register","useBridge","call"]}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/bridge.ts","../src/hooks.ts"],"sourcesContent":["import type { Handler } from \"./types\";\n\nconst listeners = new Map<string, Set<Handler>>();\n\nexport function register<T = any>(\n    event: string,\n    handler: Handler<T>\n) {\n    if (!listeners.has(event)) {\n        listeners.set(event, new Set());\n    }\n\n    listeners.get(event)!.add(handler as Handler);\n\n    return () => {\n        listeners.get(event)?.delete(handler as Handler);\n\n        if (listeners.get(event)?.size === 0) {\n            listeners.delete(event);\n        }\n    };\n}\n\nimport type { EventKey, EventPayload } from \"./types\";\n\n/** ✅ Typed overload */\nexport function call<K extends EventKey>(\n    event: K,\n    payload: EventPayload<K>\n): void;\n\n/** ✅ Void payload overload */\nexport function call<K extends EventKey>(\n    event: K\n): void;\n\n/** ✅ Fallback */\nexport function call(event: string, payload?: any) {\n    const handlers = listeners.get(event);\n\n    if (!handlers) {\n        if (process.env.NODE_ENV !== \"production\") {\n            console.warn(`[crosshook] No listeners for \"${event}\"`);\n        }\n        return;\n    }\n\n    handlers.forEach((handler) => {\n        try {\n            handler(payload);\n        } catch (err) {\n            console.error(\n                `[crosshook] Handler error in \"${event}\"`,\n                err\n            );\n        }\n    });\n}","import { useEffect } from \"react\";\nimport { register, call } from \"./bridge\";\nimport type { Handler, EventKey, EventPayload } from \"./types\";\n\n/** ✅ STRICT typed overload */\nexport function useRegister<K extends EventKey>(\n    event: K,\n    handler: Handler<EventPayload<K>>\n): void;\n\n/** ✅ fallback */\nexport function useRegister(\n    event: string,\n    handler: Handler\n) {\n    useEffect(() => {\n        const unregister = register(event, handler);\n        return unregister;\n    }, [event, handler]);\n}\n\nexport function useBridge() {\n    return { call };\n}"],"mappings":"AAEA,IAAMA,EAAY,IAAI,IAEf,SAASC,EACZC,EACAC,EACF,CACE,OAAKH,EAAU,IAAIE,CAAK,GACpBF,EAAU,IAAIE,EAAO,IAAI,GAAK,EAGlCF,EAAU,IAAIE,CAAK,EAAG,IAAIC,CAAkB,EAErC,IAAM,CACTH,EAAU,IAAIE,CAAK,GAAG,OAAOC,CAAkB,EAE3CH,EAAU,IAAIE,CAAK,GAAG,OAAS,GAC/BF,EAAU,OAAOE,CAAK,CAE9B,CACJ,CAgBO,SAASE,EAAKF,EAAeG,EAAe,CAC/C,IAAMC,EAAWN,EAAU,IAAIE,CAAK,EAEpC,GAAI,CAACI,EAAU,CACP,QAAQ,IAAI,WAAa,cACzB,QAAQ,KAAK,iCAAiCJ,CAAK,GAAG,EAE1D,MACJ,CAEAI,EAAS,QAASH,GAAY,CAC1B,GAAI,CACAA,EAAQE,CAAO,CACnB,OAASE,EAAK,CACV,QAAQ,MACJ,iCAAiCL,CAAK,IACtCK,CACJ,CACJ,CACJ,CAAC,CACL,CCzDA,OAAS,aAAAC,MAAiB,QAWnB,SAASC,EACZC,EACAC,EACF,CACEC,EAAU,IACaC,EAASH,EAAOC,CAAO,EAE3C,CAACD,EAAOC,CAAO,CAAC,CACvB,CAEO,SAASG,GAAY,CACxB,MAAO,CAAE,KAAAC,CAAK,CAClB","names":["listeners","register","event","handler","call","payload","handlers","err","useEffect","useRegister","event","handler","useEffect","register","useBridge","call"]}
+{"version":3,"sources":["../src/bridge.ts","../src/hooks.ts"],"sourcesContent":["import type { Handler } from \"./types\";\n\nconst listeners = new Map<string, Set<Handler>>();\n\nexport function register<T = any>(\n    event: string,\n    handler: Handler<T>\n) {\n    if (!listeners.has(event)) {\n        listeners.set(event, new Set());\n    }\n\n    listeners.get(event)!.add(handler as Handler);\n\n    return () => {\n        listeners.get(event)?.delete(handler as Handler);\n\n        if (listeners.get(event)?.size === 0) {\n            listeners.delete(event);\n        }\n    };\n}\n\nimport type { EventKey, EventPayload } from \"./types\";\n\nexport function call<K extends EventKey>(\n    event: K,\n    payload: EventPayload<K>\n): void;\n\nexport function call<K extends EventKey>(\n    event: K\n): void;\n\nexport function call(event: string, payload?: any) {\n    const handlers = listeners.get(event);\n\n    if (!handlers) {\n        if (process.env.NODE_ENV !== \"production\") {\n            console.warn(`[crosshook] No listeners for \"${event}\"`);\n        }\n        return;\n    }\n\n    handlers.forEach((handler) => {\n        try {\n            handler(payload);\n        } catch (err) {\n            console.error(\n                `[crosshook] Handler error in \"${event}\"`,\n                err\n            );\n        }\n    });\n}","import { useEffect } from \"react\";\nimport { register, call } from \"./bridge\";\nimport type { Handler, EventKey, EventPayload } from \"./types\";\n\nexport function useRegister<K extends EventKey>(\n    event: K,\n    handler: Handler<EventPayload<K>>\n): void;\n\nexport function useRegister(\n    event: string,\n    handler: Handler\n) {\n    useEffect(() => {\n        const unregister = register(event, handler);\n        return unregister;\n    }, [event, handler]);\n}\n\nexport function useBridge() {\n    return { call };\n}"],"mappings":"AAEA,IAAMA,EAAY,IAAI,IAEf,SAASC,EACZC,EACAC,EACF,CACE,OAAKH,EAAU,IAAIE,CAAK,GACpBF,EAAU,IAAIE,EAAO,IAAI,GAAK,EAGlCF,EAAU,IAAIE,CAAK,EAAG,IAAIC,CAAkB,EAErC,IAAM,CACTH,EAAU,IAAIE,CAAK,GAAG,OAAOC,CAAkB,EAE3CH,EAAU,IAAIE,CAAK,GAAG,OAAS,GAC/BF,EAAU,OAAOE,CAAK,CAE9B,CACJ,CAaO,SAASE,EAAKF,EAAeG,EAAe,CAC/C,IAAMC,EAAWN,EAAU,IAAIE,CAAK,EAEpC,GAAI,CAACI,EAAU,CACP,QAAQ,IAAI,WAAa,cACzB,QAAQ,KAAK,iCAAiCJ,CAAK,GAAG,EAE1D,MACJ,CAEAI,EAAS,QAASH,GAAY,CAC1B,GAAI,CACAA,EAAQE,CAAO,CACnB,OAASE,EAAK,CACV,QAAQ,MACJ,iCAAiCL,CAAK,IACtCK,CACJ,CACJ,CACJ,CAAC,CACL,CCtDA,OAAS,aAAAC,MAAiB,QASnB,SAASC,EACZC,EACAC,EACF,CACEC,EAAU,IACaC,EAASH,EAAOC,CAAO,EAE3C,CAACD,EAAOC,CAAO,CAAC,CACvB,CAEO,SAASG,GAAY,CACxB,MAAO,CAAE,KAAAC,CAAK,CAClB","names":["listeners","register","event","handler","call","payload","handlers","err","useEffect","useRegister","event","handler","useEffect","register","useBridge","call"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crosshook",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,6 +18,7 @@
     "@types/node": "^25.3.0",
     "@types/react": "^19.2.14",
     "tsup": "^8.0.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "yalc": "^1.0.0-pre.53"
   }
 }