emitochondria 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pablo Díaz A.K.A exudev
+
+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,189 @@
+
+# 🔋 Emitochondria
+
+> *The powerhouse of your events*
+
+[![npm version](https://img.shields.io/npm/v/emitochondria.svg)](https://www.npmjs.com/package/emitochondria)
+[![CI](https://github.com/Exudev/emitochondria/actions/workflows/ci.yml/badge.svg)](https://github.com/Exudev/emitochondria/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+[![Bundle Size](https://img.shields.io/bundlephobia/minzip/emitochondria)](https://bundlephobia.com/package/emitochondria)
+
+A tiny, fully-typed event emitter for TypeScript. Zero dependencies, under 1KB.
+
+## Features
+
+- ✅ **Full type safety** — Event names and payloads checked at compile time
+- ✅ **Tiny** — Under 1KB minified
+- ✅ **Zero dependencies**
+- ✅ **Universal** — Works in browser and Node.js
+- ✅ **Async support** — `emitAsync` awaits all handlers
+- ✅ **Wildcard listeners** — `onAny` for debugging/logging
+
+## Installation
+
+```bash
+npm install emitochondria
+```
+
+## Quick Start
+
+```typescript
+import { createEmitochondria } from 'emitochondria';
+
+// Define your events
+type MyEvents = {
+  'user:login': { userId: string; email: string };
+  'user:logout': { userId: string };
+  'app:ready': void;
+};
+
+// Create emitter
+const events = createEmitochondria<MyEvents>();
+
+// Subscribe (with full autocomplete!)
+events.on('user:login', (data) => {
+  console.log(`${data.email} logged in`);
+});
+
+// Emit
+events.emit('user:login', { userId: '123', email: 'pablo@example.com' });
+
+// Void events need no payload
+events.emit('app:ready');
+```
+
+## API
+
+### `createEmitochondria<T>()`
+
+Create a new typed emitter.
+
+### `.on(event, handler)`
+
+Subscribe to an event. Returns an unsubscribe function.
+
+```typescript
+const unsubscribe = events.on('user:login', (data) => {
+  console.log(data);
+});
+
+// Later...
+unsubscribe();
+```
+
+### `.off(event, handler)`
+
+Remove a specific handler.
+
+### `.once(event, handler)`
+
+Subscribe for a single emission only.
+
+```typescript
+events.once('app:ready', () => {
+  console.log('This only runs once');
+});
+```
+
+### `.emit(event, payload?)`
+
+Emit an event synchronously.
+
+### `.emitAsync(event, payload?)`
+
+Emit and await all handlers (parallel execution).
+
+```typescript
+events.on('save', async (data) => {
+  await saveToDatabase(data);
+});
+
+await events.emitAsync('save', { id: '123' });
+console.log('All handlers complete');
+```
+
+### `.onAny(handler)`
+
+Subscribe to all events. Great for logging.
+
+```typescript
+events.onAny((event, payload) => {
+  console.log(`[${event}]`, payload);
+});
+```
+
+### `.offAny(handler)`
+
+Remove a wildcard handler.
+
+### `.clear(event?)`
+
+Clear handlers for an event, or all handlers if no event specified.
+
+### `.listenerCount(event)`
+
+Get the number of listeners for an event.
+
+## ⚡ Biological API (Alternative Naming)
+
+Emitochondria offers biologically-themed aliases for all methods. Use whichever style fits your project:
+
+| Standard API | Biological Alias | Description |
+|--------------|------------------|-------------|
+| `.on()` | `.bind()` | Bind a receptor to a signal |
+| `.off()` | `.release()` | Release a receptor |
+| `.emit()` | `.pulse()` | Pulse energy through the system |
+| `.emitAsync()` | `.cascade()` | Trigger a signal cascade |
+| `.once()` | `.spike()` | Single spike of energy |
+| `.onAny()` | `.membrane()` | Membrane catches all signals |
+| `.clear()` | `.apoptosis()` | Programmed cell death |
+| `.listenerCount()` | `.receptors()` | Count of receptors |
+
+```typescript
+// Standard API
+events.on('user:login', handler);
+events.emit('user:login', data);
+
+// Biological API - same functionality, different style
+events.bind('user:login', handler);
+events.pulse('user:login', data);
+
+// Mix and match freely
+events.bind('save', async (data) => await saveToDatabase(data));
+await events.cascade('save', { id: '123' });
+```
+
+## TypeScript Magic
+
+The type system prevents mistakes at compile time:
+
+```typescript
+// ❌ Compile error: event doesn't exist
+events.emit('user:logni', {});
+
+// ❌ Compile error: missing required fields
+events.emit('user:login', {});
+
+// ❌ Compile error: wrong payload type
+events.emit('user:login', { userId: 123 }); // should be string
+
+// ✅ All good
+events.emit('user:login', { userId: '123', email: 'test@example.com' });
+```
+
+## Examples
+
+Check out the [`examples/`](./examples) folder for more comprehensive usage examples including:
+- Basic event subscription and emission
+- Async event handlers
+- Wildcard listeners
+- Biological API usage
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT © Pablo Díaz

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";var c=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var v=Object.prototype.hasOwnProperty;var m=(a,t)=>{for(var r in t)c(a,r,{get:t[r],enumerable:!0})},u=(a,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of p(t))!v.call(a,e)&&e!==r&&c(a,e,{get:()=>t[e],enumerable:!(n=E(t,e))||n.enumerable});return a};var f=a=>u(c({},"__esModule",{value:!0}),a);var K={};m(K,{createEmitochondria:()=>T,default:()=>y});module.exports=f(K);function T(){let a=new Map,t=new Set;function r(e){let o=a.get(e);return o||(o=new Set,a.set(e,o)),o}let n={on(e,o){return r(e).add(o),()=>n.off(e,o)},off(e,o){r(e).delete(o)},once(e,o){let s=(i=>(n.off(e,s),o(i)));return n.on(e,s)},emit(e,...o){let s=o[0];r(e).forEach(i=>i(s)),t.forEach(i=>i(e,s))},async emitAsync(e,...o){let s=o[0],i=[];r(e).forEach(l=>{let d=l(s);d instanceof Promise&&i.push(d)}),t.forEach(l=>{let d=l(e,s);d instanceof Promise&&i.push(d)}),await Promise.all(i)},onAny(e){return t.add(e),()=>n.offAny(e)},offAny(e){t.delete(e)},clear(e){e?a.delete(e):(a.clear(),t.clear())},listenerCount(e){return r(e).size},bind:null,release:null,pulse:null,cascade:null,spike:null,membrane:null,apoptosis:null,receptors:null};return n.bind=n.on,n.release=n.off,n.pulse=n.emit,n.cascade=n.emitAsync,n.spike=n.once,n.membrane=n.onAny,n.apoptosis=n.clear,n.receptors=n.listenerCount,n}var y=T;0&&(module.exports={createEmitochondria});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Base type for event maps.\n * Keys are event names, values are payload types.\n */\nexport type EventMap = Record<string, unknown>;\n\n/**\n * Extracts event names from an event map as a string union.\n */\nexport type EventKey<T extends EventMap> = keyof T & string;\n\n/**\n * Handler function for a specific event payload.\n * Can be sync or async.\n */\nexport type EventHandler<T> = (payload: T) => void | Promise<void>;\n\n/**\n * Wildcard handler that receives event name and payload.\n * Useful for logging/debugging.\n */\nexport type WildcardHandler<T extends EventMap> = <K extends EventKey<T>>(\n  event: K,\n  payload: T[K]\n) => void | Promise<void>;\n\n/**\n * The typed emitter interface.\n */\nexport interface Emitochondria<T extends EventMap> {\n  /** Subscribe to an event. Returns unsubscribe function. */\n  on<K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>): () => void;\n  /** Unsubscribe a handler from an event. */\n  off<K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>): void;\n  /** Subscribe for a single emission only. */\n  once<K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>): () => void;\n  /** Emit an event synchronously. */\n  emit<K extends EventKey<T>>(event: K, ...payload: T[K] extends void ? [] : [T[K]]): void;\n  /** Emit an event and await all handlers. */\n  emitAsync<K extends EventKey<T>>(event: K, ...payload: T[K] extends void ? [] : [T[K]]): Promise<void>;\n  /** Subscribe to all events (wildcard). */\n  onAny(handler: WildcardHandler<T>): () => void;\n  /** Unsubscribe a wildcard handler. */\n  offAny(handler: WildcardHandler<T>): void;\n  /** Clear handlers for a specific event or all events. */\n  clear<K extends EventKey<T>>(event?: K): void;\n  /** Get the number of listeners for an event. */\n  listenerCount<K extends EventKey<T>>(event: K): number;\n\n  // ⚡ Biological aliases\n  /** Alias for `on` — Bind a receptor to a signal. */\n  bind: Emitochondria<T>['on'];\n  /** Alias for `off` — Release a receptor. */\n  release: Emitochondria<T>['off'];\n  /** Alias for `emit` — Pulse energy through the system. */\n  pulse: Emitochondria<T>['emit'];\n  /** Alias for `emitAsync` — Trigger a signal cascade. */\n  cascade: Emitochondria<T>['emitAsync'];\n  /** Alias for `once` — Single spike of energy. */\n  spike: Emitochondria<T>['once'];\n  /** Alias for `onAny` — Membrane catches all signals. */\n  membrane: Emitochondria<T>['onAny'];\n  /** Alias for `clear` — Programmed cell death. */\n  apoptosis: Emitochondria<T>['clear'];\n  /** Alias for `listenerCount` — Count of receptors. */\n  receptors: Emitochondria<T>['listenerCount'];\n}\n\n/**\n * Create a new typed event emitter.\n *\n * @example\n * ```typescript\n * type MyEvents = {\n *   'user:login': { userId: string };\n *   'app:ready': void;\n * };\n *\n * const mito = createEmitochondria<MyEvents>();\n *\n * // Standard API\n * mito.on('user:login', (data) => {\n *   console.log(data.userId); // fully typed!\n * });\n * mito.emit('user:login', { userId: '123' });\n * mito.emit('app:ready');\n *\n * // Biological API ⚡\n * mito.bind('user:login', (data) => console.log(data.userId));\n * mito.pulse('user:login', { userId: '123' });\n * ```\n */\nexport function createEmitochondria<T extends EventMap>(): Emitochondria<T> {\n  const handlers: Map<string, Set<EventHandler<unknown>>> = new Map();\n  const wildcardHandlers: Set<WildcardHandler<T>> = new Set();\n\n  function getHandlers(event: string): Set<EventHandler<unknown>> {\n    let set = handlers.get(event);\n    if (!set) {\n      set = new Set();\n      handlers.set(event, set);\n    }\n    return set;\n  }\n\n  const e: Emitochondria<T> = {\n    on(event, handler) {\n      getHandlers(event).add(handler as EventHandler<unknown>);\n      return () => e.off(event, handler);\n    },\n\n    off(event, handler) {\n      getHandlers(event).delete(handler as EventHandler<unknown>);\n    },\n\n    once(event, handler) {\n      const wrapper = ((payload: T[typeof event]) => {\n        e.off(event, wrapper as EventHandler<T[typeof event]>);\n        return handler(payload);\n      }) as EventHandler<T[typeof event]>;\n\n      return e.on(event, wrapper);\n    },\n\n    emit(event, ...payload) {\n      const data = payload[0];\n      getHandlers(event).forEach((handler) => handler(data));\n      wildcardHandlers.forEach((handler) => handler(event, data as T[typeof event]));\n    },\n\n    async emitAsync(event, ...payload) {\n      const data = payload[0];\n      const promises: Promise<void>[] = [];\n\n      getHandlers(event).forEach((handler) => {\n        const result = handler(data);\n        if (result instanceof Promise) {\n          promises.push(result);\n        }\n      });\n\n      wildcardHandlers.forEach((handler) => {\n        const result = handler(event, data as T[typeof event]);\n        if (result instanceof Promise) {\n          promises.push(result);\n        }\n      });\n\n      await Promise.all(promises);\n    },\n\n    onAny(handler) {\n      wildcardHandlers.add(handler);\n      return () => e.offAny(handler);\n    },\n\n    offAny(handler) {\n      wildcardHandlers.delete(handler);\n    },\n\n    clear(event?) {\n      if (event) {\n        handlers.delete(event);\n      } else {\n        handlers.clear();\n        wildcardHandlers.clear();\n      }\n    },\n\n    listenerCount(event) {\n      return getHandlers(event).size;\n    },\n\n    // ⚡ Biological aliases (zero-cost: just references)\n    bind: null as unknown as Emitochondria<T>['on'],\n    release: null as unknown as Emitochondria<T>['off'],\n    pulse: null as unknown as Emitochondria<T>['emit'],\n    cascade: null as unknown as Emitochondria<T>['emitAsync'],\n    spike: null as unknown as Emitochondria<T>['once'],\n    membrane: null as unknown as Emitochondria<T>['onAny'],\n    apoptosis: null as unknown as Emitochondria<T>['clear'],\n    receptors: null as unknown as Emitochondria<T>['listenerCount'],\n  };\n\n  // Assign aliases (smaller than repeating in object literal)\n  e.bind = e.on;\n  e.release = e.off;\n  e.pulse = e.emit;\n  e.cascade = e.emitAsync;\n  e.spike = e.once;\n  e.membrane = e.onAny;\n  e.apoptosis = e.clear;\n  e.receptors = e.listenerCount;\n\n  return e;\n}\n\n// Default export for convenience\nexport default createEmitochondria;\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,yBAAAE,EAAA,YAAAC,IAAA,eAAAC,EAAAJ,GA4FO,SAASE,GAA4D,CAC1E,IAAMG,EAAoD,IAAI,IACxDC,EAA4C,IAAI,IAEtD,SAASC,EAAYC,EAA2C,CAC9D,IAAIC,EAAMJ,EAAS,IAAIG,CAAK,EAC5B,OAAKC,IACHA,EAAM,IAAI,IACVJ,EAAS,IAAIG,EAAOC,CAAG,GAElBA,CACT,CAEA,IAAMC,EAAsB,CAC1B,GAAGF,EAAOG,EAAS,CACjB,OAAAJ,EAAYC,CAAK,EAAE,IAAIG,CAAgC,EAChD,IAAMD,EAAE,IAAIF,EAAOG,CAAO,CACnC,EAEA,IAAIH,EAAOG,EAAS,CAClBJ,EAAYC,CAAK,EAAE,OAAOG,CAAgC,CAC5D,EAEA,KAAKH,EAAOG,EAAS,CACnB,IAAMC,GAAYC,IAChBH,EAAE,IAAIF,EAAOI,CAAwC,EAC9CD,EAAQE,CAAO,IAGxB,OAAOH,EAAE,GAAGF,EAAOI,CAAO,CAC5B,EAEA,KAAKJ,KAAUK,EAAS,CACtB,IAAMC,EAAOD,EAAQ,CAAC,EACtBN,EAAYC,CAAK,EAAE,QAASG,GAAYA,EAAQG,CAAI,CAAC,EACrDR,EAAiB,QAASK,GAAYA,EAAQH,EAAOM,CAAuB,CAAC,CAC/E,EAEA,MAAM,UAAUN,KAAUK,EAAS,CACjC,IAAMC,EAAOD,EAAQ,CAAC,EAChBE,EAA4B,CAAC,EAEnCR,EAAYC,CAAK,EAAE,QAASG,GAAY,CACtC,IAAMK,EAASL,EAAQG,CAAI,EACvBE,aAAkB,SACpBD,EAAS,KAAKC,CAAM,CAExB,CAAC,EAEDV,EAAiB,QAASK,GAAY,CACpC,IAAMK,EAASL,EAAQH,EAAOM,CAAuB,EACjDE,aAAkB,SACpBD,EAAS,KAAKC,CAAM,CAExB,CAAC,EAED,MAAM,QAAQ,IAAID,CAAQ,CAC5B,EAEA,MAAMJ,EAAS,CACb,OAAAL,EAAiB,IAAIK,CAAO,EACrB,IAAMD,EAAE,OAAOC,CAAO,CAC/B,EAEA,OAAOA,EAAS,CACdL,EAAiB,OAAOK,CAAO,CACjC,EAEA,MAAMH,EAAQ,CACRA,EACFH,EAAS,OAAOG,CAAK,GAErBH,EAAS,MAAM,EACfC,EAAiB,MAAM,EAE3B,EAEA,cAAcE,EAAO,CACnB,OAAOD,EAAYC,CAAK,EAAE,IAC5B,EAGA,KAAM,KACN,QAAS,KACT,MAAO,KACP,QAAS,KACT,MAAO,KACP,SAAU,KACV,UAAW,KACX,UAAW,IACb,EAGA,OAAAE,EAAE,KAAOA,EAAE,GACXA,EAAE,QAAUA,EAAE,IACdA,EAAE,MAAQA,EAAE,KACZA,EAAE,QAAUA,EAAE,UACdA,EAAE,MAAQA,EAAE,KACZA,EAAE,SAAWA,EAAE,MACfA,EAAE,UAAYA,EAAE,MAChBA,EAAE,UAAYA,EAAE,cAETA,CACT,CAGA,IAAOP,EAAQD","names":["index_exports","__export","createEmitochondria","index_default","__toCommonJS","handlers","wildcardHandlers","getHandlers","event","set","e","handler","wrapper","payload","data","promises","result"]}

package/dist/index.d.cts

@@ -0,0 +1,85 @@
+/**
+ * Base type for event maps.
+ * Keys are event names, values are payload types.
+ */
+type EventMap = Record<string, unknown>;
+/**
+ * Extracts event names from an event map as a string union.
+ */
+type EventKey<T extends EventMap> = keyof T & string;
+/**
+ * Handler function for a specific event payload.
+ * Can be sync or async.
+ */
+type EventHandler<T> = (payload: T) => void | Promise<void>;
+/**
+ * Wildcard handler that receives event name and payload.
+ * Useful for logging/debugging.
+ */
+type WildcardHandler<T extends EventMap> = <K extends EventKey<T>>(event: K, payload: T[K]) => void | Promise<void>;
+/**
+ * The typed emitter interface.
+ */
+interface Emitochondria<T extends EventMap> {
+    /** Subscribe to an event. Returns unsubscribe function. */
+    on<K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>): () => void;
+    /** Unsubscribe a handler from an event. */
+    off<K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>): void;
+    /** Subscribe for a single emission only. */
+    once<K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>): () => void;
+    /** Emit an event synchronously. */
+    emit<K extends EventKey<T>>(event: K, ...payload: T[K] extends void ? [] : [T[K]]): void;
+    /** Emit an event and await all handlers. */
+    emitAsync<K extends EventKey<T>>(event: K, ...payload: T[K] extends void ? [] : [T[K]]): Promise<void>;
+    /** Subscribe to all events (wildcard). */
+    onAny(handler: WildcardHandler<T>): () => void;
+    /** Unsubscribe a wildcard handler. */
+    offAny(handler: WildcardHandler<T>): void;
+    /** Clear handlers for a specific event or all events. */
+    clear<K extends EventKey<T>>(event?: K): void;
+    /** Get the number of listeners for an event. */
+    listenerCount<K extends EventKey<T>>(event: K): number;
+    /** Alias for `on` — Bind a receptor to a signal. */
+    bind: Emitochondria<T>['on'];
+    /** Alias for `off` — Release a receptor. */
+    release: Emitochondria<T>['off'];
+    /** Alias for `emit` — Pulse energy through the system. */
+    pulse: Emitochondria<T>['emit'];
+    /** Alias for `emitAsync` — Trigger a signal cascade. */
+    cascade: Emitochondria<T>['emitAsync'];
+    /** Alias for `once` — Single spike of energy. */
+    spike: Emitochondria<T>['once'];
+    /** Alias for `onAny` — Membrane catches all signals. */
+    membrane: Emitochondria<T>['onAny'];
+    /** Alias for `clear` — Programmed cell death. */
+    apoptosis: Emitochondria<T>['clear'];
+    /** Alias for `listenerCount` — Count of receptors. */
+    receptors: Emitochondria<T>['listenerCount'];
+}
+/**
+ * Create a new typed event emitter.
+ *
+ * @example
+ * ```typescript
+ * type MyEvents = {
+ *   'user:login': { userId: string };
+ *   'app:ready': void;
+ * };
+ *
+ * const mito = createEmitochondria<MyEvents>();
+ *
+ * // Standard API
+ * mito.on('user:login', (data) => {
+ *   console.log(data.userId); // fully typed!
+ * });
+ * mito.emit('user:login', { userId: '123' });
+ * mito.emit('app:ready');
+ *
+ * // Biological API ⚡
+ * mito.bind('user:login', (data) => console.log(data.userId));
+ * mito.pulse('user:login', { userId: '123' });
+ * ```
+ */
+declare function createEmitochondria<T extends EventMap>(): Emitochondria<T>;
+
+export { type Emitochondria, type EventHandler, type EventKey, type EventMap, type WildcardHandler, createEmitochondria, createEmitochondria as default };

package/dist/index.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Base type for event maps.
+ * Keys are event names, values are payload types.
+ */
+type EventMap = Record<string, unknown>;
+/**
+ * Extracts event names from an event map as a string union.
+ */
+type EventKey<T extends EventMap> = keyof T & string;
+/**
+ * Handler function for a specific event payload.
+ * Can be sync or async.
+ */
+type EventHandler<T> = (payload: T) => void | Promise<void>;
+/**
+ * Wildcard handler that receives event name and payload.
+ * Useful for logging/debugging.
+ */
+type WildcardHandler<T extends EventMap> = <K extends EventKey<T>>(event: K, payload: T[K]) => void | Promise<void>;
+/**
+ * The typed emitter interface.
+ */
+interface Emitochondria<T extends EventMap> {
+    /** Subscribe to an event. Returns unsubscribe function. */
+    on<K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>): () => void;
+    /** Unsubscribe a handler from an event. */
+    off<K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>): void;
+    /** Subscribe for a single emission only. */
+    once<K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>): () => void;
+    /** Emit an event synchronously. */
+    emit<K extends EventKey<T>>(event: K, ...payload: T[K] extends void ? [] : [T[K]]): void;
+    /** Emit an event and await all handlers. */
+    emitAsync<K extends EventKey<T>>(event: K, ...payload: T[K] extends void ? [] : [T[K]]): Promise<void>;
+    /** Subscribe to all events (wildcard). */
+    onAny(handler: WildcardHandler<T>): () => void;
+    /** Unsubscribe a wildcard handler. */
+    offAny(handler: WildcardHandler<T>): void;
+    /** Clear handlers for a specific event or all events. */
+    clear<K extends EventKey<T>>(event?: K): void;
+    /** Get the number of listeners for an event. */
+    listenerCount<K extends EventKey<T>>(event: K): number;
+    /** Alias for `on` — Bind a receptor to a signal. */
+    bind: Emitochondria<T>['on'];
+    /** Alias for `off` — Release a receptor. */
+    release: Emitochondria<T>['off'];
+    /** Alias for `emit` — Pulse energy through the system. */
+    pulse: Emitochondria<T>['emit'];
+    /** Alias for `emitAsync` — Trigger a signal cascade. */
+    cascade: Emitochondria<T>['emitAsync'];
+    /** Alias for `once` — Single spike of energy. */
+    spike: Emitochondria<T>['once'];
+    /** Alias for `onAny` — Membrane catches all signals. */
+    membrane: Emitochondria<T>['onAny'];
+    /** Alias for `clear` — Programmed cell death. */
+    apoptosis: Emitochondria<T>['clear'];
+    /** Alias for `listenerCount` — Count of receptors. */
+    receptors: Emitochondria<T>['listenerCount'];
+}
+/**
+ * Create a new typed event emitter.
+ *
+ * @example
+ * ```typescript
+ * type MyEvents = {
+ *   'user:login': { userId: string };
+ *   'app:ready': void;
+ * };
+ *
+ * const mito = createEmitochondria<MyEvents>();
+ *
+ * // Standard API
+ * mito.on('user:login', (data) => {
+ *   console.log(data.userId); // fully typed!
+ * });
+ * mito.emit('user:login', { userId: '123' });
+ * mito.emit('app:ready');
+ *
+ * // Biological API ⚡
+ * mito.bind('user:login', (data) => console.log(data.userId));
+ * mito.pulse('user:login', { userId: '123' });
+ * ```
+ */
+declare function createEmitochondria<T extends EventMap>(): Emitochondria<T>;
+
+export { type Emitochondria, type EventHandler, type EventKey, type EventMap, type WildcardHandler, createEmitochondria, createEmitochondria as default };

package/dist/index.js

@@ -0,0 +1,2 @@
+function c(){let d=new Map,r=new Set;function i(e){let t=d.get(e);return t||(t=new Set,d.set(e,t)),t}let n={on(e,t){return i(e).add(t),()=>n.off(e,t)},off(e,t){i(e).delete(t)},once(e,t){let a=(o=>(n.off(e,a),t(o)));return n.on(e,a)},emit(e,...t){let a=t[0];i(e).forEach(o=>o(a)),r.forEach(o=>o(e,a))},async emitAsync(e,...t){let a=t[0],o=[];i(e).forEach(l=>{let s=l(a);s instanceof Promise&&o.push(s)}),r.forEach(l=>{let s=l(e,a);s instanceof Promise&&o.push(s)}),await Promise.all(o)},onAny(e){return r.add(e),()=>n.offAny(e)},offAny(e){r.delete(e)},clear(e){e?d.delete(e):(d.clear(),r.clear())},listenerCount(e){return i(e).size},bind:null,release:null,pulse:null,cascade:null,spike:null,membrane:null,apoptosis:null,receptors:null};return n.bind=n.on,n.release=n.off,n.pulse=n.emit,n.cascade=n.emitAsync,n.spike=n.once,n.membrane=n.onAny,n.apoptosis=n.clear,n.receptors=n.listenerCount,n}var T=c;export{c as createEmitochondria,T as default};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Base type for event maps.\n * Keys are event names, values are payload types.\n */\nexport type EventMap = Record<string, unknown>;\n\n/**\n * Extracts event names from an event map as a string union.\n */\nexport type EventKey<T extends EventMap> = keyof T & string;\n\n/**\n * Handler function for a specific event payload.\n * Can be sync or async.\n */\nexport type EventHandler<T> = (payload: T) => void | Promise<void>;\n\n/**\n * Wildcard handler that receives event name and payload.\n * Useful for logging/debugging.\n */\nexport type WildcardHandler<T extends EventMap> = <K extends EventKey<T>>(\n  event: K,\n  payload: T[K]\n) => void | Promise<void>;\n\n/**\n * The typed emitter interface.\n */\nexport interface Emitochondria<T extends EventMap> {\n  /** Subscribe to an event. Returns unsubscribe function. */\n  on<K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>): () => void;\n  /** Unsubscribe a handler from an event. */\n  off<K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>): void;\n  /** Subscribe for a single emission only. */\n  once<K extends EventKey<T>>(event: K, handler: EventHandler<T[K]>): () => void;\n  /** Emit an event synchronously. */\n  emit<K extends EventKey<T>>(event: K, ...payload: T[K] extends void ? [] : [T[K]]): void;\n  /** Emit an event and await all handlers. */\n  emitAsync<K extends EventKey<T>>(event: K, ...payload: T[K] extends void ? [] : [T[K]]): Promise<void>;\n  /** Subscribe to all events (wildcard). */\n  onAny(handler: WildcardHandler<T>): () => void;\n  /** Unsubscribe a wildcard handler. */\n  offAny(handler: WildcardHandler<T>): void;\n  /** Clear handlers for a specific event or all events. */\n  clear<K extends EventKey<T>>(event?: K): void;\n  /** Get the number of listeners for an event. */\n  listenerCount<K extends EventKey<T>>(event: K): number;\n\n  // ⚡ Biological aliases\n  /** Alias for `on` — Bind a receptor to a signal. */\n  bind: Emitochondria<T>['on'];\n  /** Alias for `off` — Release a receptor. */\n  release: Emitochondria<T>['off'];\n  /** Alias for `emit` — Pulse energy through the system. */\n  pulse: Emitochondria<T>['emit'];\n  /** Alias for `emitAsync` — Trigger a signal cascade. */\n  cascade: Emitochondria<T>['emitAsync'];\n  /** Alias for `once` — Single spike of energy. */\n  spike: Emitochondria<T>['once'];\n  /** Alias for `onAny` — Membrane catches all signals. */\n  membrane: Emitochondria<T>['onAny'];\n  /** Alias for `clear` — Programmed cell death. */\n  apoptosis: Emitochondria<T>['clear'];\n  /** Alias for `listenerCount` — Count of receptors. */\n  receptors: Emitochondria<T>['listenerCount'];\n}\n\n/**\n * Create a new typed event emitter.\n *\n * @example\n * ```typescript\n * type MyEvents = {\n *   'user:login': { userId: string };\n *   'app:ready': void;\n * };\n *\n * const mito = createEmitochondria<MyEvents>();\n *\n * // Standard API\n * mito.on('user:login', (data) => {\n *   console.log(data.userId); // fully typed!\n * });\n * mito.emit('user:login', { userId: '123' });\n * mito.emit('app:ready');\n *\n * // Biological API ⚡\n * mito.bind('user:login', (data) => console.log(data.userId));\n * mito.pulse('user:login', { userId: '123' });\n * ```\n */\nexport function createEmitochondria<T extends EventMap>(): Emitochondria<T> {\n  const handlers: Map<string, Set<EventHandler<unknown>>> = new Map();\n  const wildcardHandlers: Set<WildcardHandler<T>> = new Set();\n\n  function getHandlers(event: string): Set<EventHandler<unknown>> {\n    let set = handlers.get(event);\n    if (!set) {\n      set = new Set();\n      handlers.set(event, set);\n    }\n    return set;\n  }\n\n  const e: Emitochondria<T> = {\n    on(event, handler) {\n      getHandlers(event).add(handler as EventHandler<unknown>);\n      return () => e.off(event, handler);\n    },\n\n    off(event, handler) {\n      getHandlers(event).delete(handler as EventHandler<unknown>);\n    },\n\n    once(event, handler) {\n      const wrapper = ((payload: T[typeof event]) => {\n        e.off(event, wrapper as EventHandler<T[typeof event]>);\n        return handler(payload);\n      }) as EventHandler<T[typeof event]>;\n\n      return e.on(event, wrapper);\n    },\n\n    emit(event, ...payload) {\n      const data = payload[0];\n      getHandlers(event).forEach((handler) => handler(data));\n      wildcardHandlers.forEach((handler) => handler(event, data as T[typeof event]));\n    },\n\n    async emitAsync(event, ...payload) {\n      const data = payload[0];\n      const promises: Promise<void>[] = [];\n\n      getHandlers(event).forEach((handler) => {\n        const result = handler(data);\n        if (result instanceof Promise) {\n          promises.push(result);\n        }\n      });\n\n      wildcardHandlers.forEach((handler) => {\n        const result = handler(event, data as T[typeof event]);\n        if (result instanceof Promise) {\n          promises.push(result);\n        }\n      });\n\n      await Promise.all(promises);\n    },\n\n    onAny(handler) {\n      wildcardHandlers.add(handler);\n      return () => e.offAny(handler);\n    },\n\n    offAny(handler) {\n      wildcardHandlers.delete(handler);\n    },\n\n    clear(event?) {\n      if (event) {\n        handlers.delete(event);\n      } else {\n        handlers.clear();\n        wildcardHandlers.clear();\n      }\n    },\n\n    listenerCount(event) {\n      return getHandlers(event).size;\n    },\n\n    // ⚡ Biological aliases (zero-cost: just references)\n    bind: null as unknown as Emitochondria<T>['on'],\n    release: null as unknown as Emitochondria<T>['off'],\n    pulse: null as unknown as Emitochondria<T>['emit'],\n    cascade: null as unknown as Emitochondria<T>['emitAsync'],\n    spike: null as unknown as Emitochondria<T>['once'],\n    membrane: null as unknown as Emitochondria<T>['onAny'],\n    apoptosis: null as unknown as Emitochondria<T>['clear'],\n    receptors: null as unknown as Emitochondria<T>['listenerCount'],\n  };\n\n  // Assign aliases (smaller than repeating in object literal)\n  e.bind = e.on;\n  e.release = e.off;\n  e.pulse = e.emit;\n  e.cascade = e.emitAsync;\n  e.spike = e.once;\n  e.membrane = e.onAny;\n  e.apoptosis = e.clear;\n  e.receptors = e.listenerCount;\n\n  return e;\n}\n\n// Default export for convenience\nexport default createEmitochondria;\n"],"mappings":"AA4FO,SAASA,GAA4D,CAC1E,IAAMC,EAAoD,IAAI,IACxDC,EAA4C,IAAI,IAEtD,SAASC,EAAYC,EAA2C,CAC9D,IAAIC,EAAMJ,EAAS,IAAIG,CAAK,EAC5B,OAAKC,IACHA,EAAM,IAAI,IACVJ,EAAS,IAAIG,EAAOC,CAAG,GAElBA,CACT,CAEA,IAAMC,EAAsB,CAC1B,GAAGF,EAAOG,EAAS,CACjB,OAAAJ,EAAYC,CAAK,EAAE,IAAIG,CAAgC,EAChD,IAAMD,EAAE,IAAIF,EAAOG,CAAO,CACnC,EAEA,IAAIH,EAAOG,EAAS,CAClBJ,EAAYC,CAAK,EAAE,OAAOG,CAAgC,CAC5D,EAEA,KAAKH,EAAOG,EAAS,CACnB,IAAMC,GAAYC,IAChBH,EAAE,IAAIF,EAAOI,CAAwC,EAC9CD,EAAQE,CAAO,IAGxB,OAAOH,EAAE,GAAGF,EAAOI,CAAO,CAC5B,EAEA,KAAKJ,KAAUK,EAAS,CACtB,IAAMC,EAAOD,EAAQ,CAAC,EACtBN,EAAYC,CAAK,EAAE,QAASG,GAAYA,EAAQG,CAAI,CAAC,EACrDR,EAAiB,QAASK,GAAYA,EAAQH,EAAOM,CAAuB,CAAC,CAC/E,EAEA,MAAM,UAAUN,KAAUK,EAAS,CACjC,IAAMC,EAAOD,EAAQ,CAAC,EAChBE,EAA4B,CAAC,EAEnCR,EAAYC,CAAK,EAAE,QAASG,GAAY,CACtC,IAAMK,EAASL,EAAQG,CAAI,EACvBE,aAAkB,SACpBD,EAAS,KAAKC,CAAM,CAExB,CAAC,EAEDV,EAAiB,QAASK,GAAY,CACpC,IAAMK,EAASL,EAAQH,EAAOM,CAAuB,EACjDE,aAAkB,SACpBD,EAAS,KAAKC,CAAM,CAExB,CAAC,EAED,MAAM,QAAQ,IAAID,CAAQ,CAC5B,EAEA,MAAMJ,EAAS,CACb,OAAAL,EAAiB,IAAIK,CAAO,EACrB,IAAMD,EAAE,OAAOC,CAAO,CAC/B,EAEA,OAAOA,EAAS,CACdL,EAAiB,OAAOK,CAAO,CACjC,EAEA,MAAMH,EAAQ,CACRA,EACFH,EAAS,OAAOG,CAAK,GAErBH,EAAS,MAAM,EACfC,EAAiB,MAAM,EAE3B,EAEA,cAAcE,EAAO,CACnB,OAAOD,EAAYC,CAAK,EAAE,IAC5B,EAGA,KAAM,KACN,QAAS,KACT,MAAO,KACP,QAAS,KACT,MAAO,KACP,SAAU,KACV,UAAW,KACX,UAAW,IACb,EAGA,OAAAE,EAAE,KAAOA,EAAE,GACXA,EAAE,QAAUA,EAAE,IACdA,EAAE,MAAQA,EAAE,KACZA,EAAE,QAAUA,EAAE,UACdA,EAAE,MAAQA,EAAE,KACZA,EAAE,SAAWA,EAAE,MACfA,EAAE,UAAYA,EAAE,MAChBA,EAAE,UAAYA,EAAE,cAETA,CACT,CAGA,IAAOO,EAAQb","names":["createEmitochondria","handlers","wildcardHandlers","getHandlers","event","set","e","handler","wrapper","payload","data","promises","result","index_default"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "emitochondria",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "The powerhouse of your events — A tiny, fully-typed event emitter for TypeScript",
+  "author": "Pablo Díaz A.K.A exudev",
+  "license": "MIT",
+  "keywords": [
+    "events",
+    "emitter",
+    "event-emitter",
+    "typescript",
+    "typed",
+    "pubsub",
+    "pub-sub",
+    "subscribe",
+    "publish"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Exudev/emitochondria.git"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run test:run && npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  }
+}