@flare-engine/events 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Grzegorz Otto
+
+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,29 @@
+# @flare-engine/events
+
+Type-safe event primitives — `EventEmitter<EventMap>` for keyed events and `Signal<T>` for single-payload broadcast. Both support `once()`, deferred-remove during `emit()`, and zero-alloc `Unsubscribe` returns.
+
+## Install
+
+```sh
+bun add @flare-engine/events
+```
+
+## Usage
+
+```ts
+import { EventEmitter, Signal } from '@flare-engine/events';
+
+type GameEvents = { 'enemy-killed': { id: number; score: number } };
+const bus = new EventEmitter<GameEvents>();
+const off = bus.on('enemy-killed', (e) => console.log(e.score));
+
+const onHit = new Signal<number>();
+onHit.add((dmg) => console.log(dmg));
+onHit.emit(10);
+```
+
+See [API spec](../../docs/design/api-specs.md#flare-engineevents--1kb-gzip) and [skill reference](../../.github/skills/flare-events/SKILL.md).
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,39 @@
+/** Unsubscribe function returned by on/once. */
+type Unsubscribe = () => void;
+/** Map of event names to handler signatures. */
+type EventMap = Record<string, (...args: never[]) => void>;
+/** Type-safe event emitter. */
+declare class EventEmitter<E extends EventMap> {
+    private listeners;
+    private iterating;
+    private pendingRemove;
+    /** Subscribe to an event. Returns unsubscribe function. */
+    on<K extends keyof E>(event: K, handler: E[K]): Unsubscribe;
+    /** Subscribe to an event once. Returns unsubscribe function. */
+    once<K extends keyof E>(event: K, handler: E[K]): Unsubscribe;
+    /** Unsubscribe a specific handler. */
+    off<K extends keyof E>(event: K, handler: E[K]): void;
+    /** Emit an event to all subscribers. Zero-alloc on the hot path. */
+    emit<K extends keyof E>(event: K, ...args: Parameters<E[K]>): void;
+    /** Remove all listeners for a specific event, or all listeners. */
+    removeAll(event?: keyof E): void;
+}
+
+/** Lightweight single-event emitter. Less overhead than EventEmitter. */
+declare class Signal<T = void> {
+    private handlers;
+    private iterating;
+    private pendingRemove;
+    /** Subscribe to the signal. Returns unsubscribe function. */
+    add(handler: (value: T) => void): Unsubscribe;
+    /** Subscribe once. Returns unsubscribe function. */
+    once(handler: (value: T) => void): Unsubscribe;
+    /** Unsubscribe a specific handler. */
+    remove(handler: (value: T) => void): void;
+    /** Emit a value to all subscribers. Zero-alloc on the hot path. */
+    emit(...args: T extends void ? [] : [value: T]): void;
+    /** Remove all handlers. */
+    clear(): void;
+}
+
+export { EventEmitter, type EventMap, Signal, type Unsubscribe };

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/** Unsubscribe function returned by on/once. */
+type Unsubscribe = () => void;
+/** Map of event names to handler signatures. */
+type EventMap = Record<string, (...args: never[]) => void>;
+/** Type-safe event emitter. */
+declare class EventEmitter<E extends EventMap> {
+    private listeners;
+    private iterating;
+    private pendingRemove;
+    /** Subscribe to an event. Returns unsubscribe function. */
+    on<K extends keyof E>(event: K, handler: E[K]): Unsubscribe;
+    /** Subscribe to an event once. Returns unsubscribe function. */
+    once<K extends keyof E>(event: K, handler: E[K]): Unsubscribe;
+    /** Unsubscribe a specific handler. */
+    off<K extends keyof E>(event: K, handler: E[K]): void;
+    /** Emit an event to all subscribers. Zero-alloc on the hot path. */
+    emit<K extends keyof E>(event: K, ...args: Parameters<E[K]>): void;
+    /** Remove all listeners for a specific event, or all listeners. */
+    removeAll(event?: keyof E): void;
+}
+
+/** Lightweight single-event emitter. Less overhead than EventEmitter. */
+declare class Signal<T = void> {
+    private handlers;
+    private iterating;
+    private pendingRemove;
+    /** Subscribe to the signal. Returns unsubscribe function. */
+    add(handler: (value: T) => void): Unsubscribe;
+    /** Subscribe once. Returns unsubscribe function. */
+    once(handler: (value: T) => void): Unsubscribe;
+    /** Unsubscribe a specific handler. */
+    remove(handler: (value: T) => void): void;
+    /** Emit a value to all subscribers. Zero-alloc on the hot path. */
+    emit(...args: T extends void ? [] : [value: T]): void;
+    /** Remove all handlers. */
+    clear(): void;
+}
+
+export { EventEmitter, type EventMap, Signal, type Unsubscribe };

package/dist/index.js

@@ -0,0 +1,155 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  EventEmitter: () => EventEmitter,
+  Signal: () => Signal
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/emitter.ts
+var EventEmitter = class {
+  listeners = /* @__PURE__ */ new Map();
+  iterating = false;
+  pendingRemove = [];
+  /** Subscribe to an event. Returns unsubscribe function. */
+  on(event, handler) {
+    let set = this.listeners.get(event);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(event, set);
+    }
+    set.add(handler);
+    return () => {
+      this.off(event, handler);
+    };
+  }
+  /** Subscribe to an event once. Returns unsubscribe function. */
+  once(event, handler) {
+    const wrapper = ((...args) => {
+      unsub();
+      handler(...args);
+    });
+    const unsub = this.on(event, wrapper);
+    return unsub;
+  }
+  /** Unsubscribe a specific handler. */
+  off(event, handler) {
+    if (this.iterating) {
+      this.pendingRemove.push({ event, handler });
+      return;
+    }
+    const set = this.listeners.get(event);
+    if (set) {
+      set.delete(handler);
+      if (set.size === 0) this.listeners.delete(event);
+    }
+  }
+  /** Emit an event to all subscribers. Zero-alloc on the hot path. */
+  emit(event, ...args) {
+    const set = this.listeners.get(event);
+    if (!set) return;
+    this.iterating = true;
+    for (const handler of set) {
+      handler(...args);
+    }
+    this.iterating = false;
+    if (this.pendingRemove.length > 0) {
+      for (let i = 0; i < this.pendingRemove.length; i++) {
+        const { event: ev, handler: h } = this.pendingRemove[i];
+        const s = this.listeners.get(ev);
+        if (s) {
+          s.delete(h);
+          if (s.size === 0) this.listeners.delete(ev);
+        }
+      }
+      this.pendingRemove.length = 0;
+    }
+  }
+  /** Remove all listeners for a specific event, or all listeners. */
+  removeAll(event) {
+    if (event !== void 0) {
+      this.listeners.delete(event);
+    } else {
+      this.listeners.clear();
+    }
+    this.pendingRemove.length = 0;
+    this.iterating = false;
+  }
+};
+
+// src/signal.ts
+var Signal = class {
+  handlers = /* @__PURE__ */ new Set();
+  iterating = false;
+  pendingRemove = [];
+  /** Subscribe to the signal. Returns unsubscribe function. */
+  add(handler) {
+    this.handlers.add(handler);
+    return () => {
+      this.remove(handler);
+    };
+  }
+  /** Subscribe once. Returns unsubscribe function. */
+  once(handler) {
+    const wrapper = (value) => {
+      unsub();
+      handler(value);
+    };
+    const unsub = this.add(wrapper);
+    return unsub;
+  }
+  /** Unsubscribe a specific handler. */
+  remove(handler) {
+    if (this.iterating) {
+      this.pendingRemove.push(handler);
+    } else {
+      this.handlers.delete(handler);
+    }
+  }
+  /** Emit a value to all subscribers. Zero-alloc on the hot path. */
+  emit(...args) {
+    const value = args[0];
+    this.iterating = true;
+    for (const handler of this.handlers) {
+      handler(value);
+    }
+    this.iterating = false;
+    if (this.pendingRemove.length > 0) {
+      for (let i = 0; i < this.pendingRemove.length; i++) {
+        this.handlers.delete(this.pendingRemove[i]);
+      }
+      this.pendingRemove.length = 0;
+    }
+  }
+  /** Remove all handlers. */
+  clear() {
+    this.handlers.clear();
+    this.pendingRemove.length = 0;
+    this.iterating = false;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EventEmitter,
+  Signal
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/emitter.ts","../src/signal.ts"],"sourcesContent":["export { EventEmitter } from './emitter.js';\nexport type { Unsubscribe, EventMap } from './emitter.js';\nexport { Signal } from './signal.js';\n","/** Unsubscribe function returned by on/once. */\nexport type Unsubscribe = () => void;\n\n/** Map of event names to handler signatures. */\nexport type EventMap = Record<string, (...args: never[]) => void>;\n\n/** Type-safe event emitter. */\nexport class EventEmitter<E extends EventMap> {\n  private listeners = new Map<keyof E, Set<E[keyof E]>>();\n  private iterating = false;\n  private pendingRemove: Array<{ event: keyof E; handler: E[keyof E] }> = [];\n\n  /** Subscribe to an event. Returns unsubscribe function. */\n  on<K extends keyof E>(event: K, handler: E[K]): Unsubscribe {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    set.add(handler);\n    return () => {\n      this.off(event, handler);\n    };\n  }\n\n  /** Subscribe to an event once. Returns unsubscribe function. */\n  once<K extends keyof E>(event: K, handler: E[K]): Unsubscribe {\n    const wrapper = ((...args: never[]) => {\n      unsub();\n      // biome-ignore lint/complexity/noBannedTypes: generic handler call\n      (handler as Function)(...args);\n    }) as E[K];\n    const unsub = this.on(event, wrapper);\n    return unsub;\n  }\n\n  /** Unsubscribe a specific handler. */\n  off<K extends keyof E>(event: K, handler: E[K]): void {\n    if (this.iterating) {\n      this.pendingRemove.push({ event, handler });\n      return;\n    }\n    const set = this.listeners.get(event);\n    if (set) {\n      set.delete(handler);\n      if (set.size === 0) this.listeners.delete(event);\n    }\n  }\n\n  /** Emit an event to all subscribers. Zero-alloc on the hot path. */\n  emit<K extends keyof E>(event: K, ...args: Parameters<E[K]>): void {\n    const set = this.listeners.get(event);\n    if (!set) return;\n    this.iterating = true;\n    for (const handler of set) {\n      // biome-ignore lint/complexity/noBannedTypes: generic handler call\n      (handler as Function)(...args);\n    }\n    this.iterating = false;\n    // Flush pending removes (rare path — only when handler unsubscribed during emit)\n    if (this.pendingRemove.length > 0) {\n      for (let i = 0; i < this.pendingRemove.length; i++) {\n        const { event: ev, handler: h } = this.pendingRemove[i]!;\n        const s = this.listeners.get(ev);\n        if (s) {\n          s.delete(h);\n          if (s.size === 0) this.listeners.delete(ev);\n        }\n      }\n      this.pendingRemove.length = 0;\n    }\n  }\n\n  /** Remove all listeners for a specific event, or all listeners. */\n  removeAll(event?: keyof E): void {\n    if (event !== undefined) {\n      this.listeners.delete(event);\n    } else {\n      this.listeners.clear();\n    }\n    this.pendingRemove.length = 0;\n    this.iterating = false;\n  }\n}\n","import type { Unsubscribe } from './emitter.js';\n\n/** Lightweight single-event emitter. Less overhead than EventEmitter. */\nexport class Signal<T = void> {\n  private handlers = new Set<(value: T) => void>();\n  private iterating = false;\n  private pendingRemove: Array<(value: T) => void> = [];\n\n  /** Subscribe to the signal. Returns unsubscribe function. */\n  add(handler: (value: T) => void): Unsubscribe {\n    this.handlers.add(handler);\n    return () => {\n      this.remove(handler);\n    };\n  }\n\n  /** Subscribe once. Returns unsubscribe function. */\n  once(handler: (value: T) => void): Unsubscribe {\n    const wrapper = (value: T) => {\n      unsub();\n      handler(value);\n    };\n    const unsub = this.add(wrapper);\n    return unsub;\n  }\n\n  /** Unsubscribe a specific handler. */\n  remove(handler: (value: T) => void): void {\n    if (this.iterating) {\n      this.pendingRemove.push(handler);\n    } else {\n      this.handlers.delete(handler);\n    }\n  }\n\n  /** Emit a value to all subscribers. Zero-alloc on the hot path. */\n  emit(...args: T extends void ? [] : [value: T]): void {\n    const value = args[0] as T;\n    this.iterating = true;\n    for (const handler of this.handlers) {\n      handler(value);\n    }\n    this.iterating = false;\n    // Flush pending removes (rare path — only when handler removed itself during emit)\n    if (this.pendingRemove.length > 0) {\n      for (let i = 0; i < this.pendingRemove.length; i++) {\n        this.handlers.delete(this.pendingRemove[i]!);\n      }\n      this.pendingRemove.length = 0;\n    }\n  }\n\n  /** Remove all handlers. */\n  clear(): void {\n    this.handlers.clear();\n    this.pendingRemove.length = 0;\n    this.iterating = false;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,127 @@
+// src/emitter.ts
+var EventEmitter = class {
+  listeners = /* @__PURE__ */ new Map();
+  iterating = false;
+  pendingRemove = [];
+  /** Subscribe to an event. Returns unsubscribe function. */
+  on(event, handler) {
+    let set = this.listeners.get(event);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(event, set);
+    }
+    set.add(handler);
+    return () => {
+      this.off(event, handler);
+    };
+  }
+  /** Subscribe to an event once. Returns unsubscribe function. */
+  once(event, handler) {
+    const wrapper = ((...args) => {
+      unsub();
+      handler(...args);
+    });
+    const unsub = this.on(event, wrapper);
+    return unsub;
+  }
+  /** Unsubscribe a specific handler. */
+  off(event, handler) {
+    if (this.iterating) {
+      this.pendingRemove.push({ event, handler });
+      return;
+    }
+    const set = this.listeners.get(event);
+    if (set) {
+      set.delete(handler);
+      if (set.size === 0) this.listeners.delete(event);
+    }
+  }
+  /** Emit an event to all subscribers. Zero-alloc on the hot path. */
+  emit(event, ...args) {
+    const set = this.listeners.get(event);
+    if (!set) return;
+    this.iterating = true;
+    for (const handler of set) {
+      handler(...args);
+    }
+    this.iterating = false;
+    if (this.pendingRemove.length > 0) {
+      for (let i = 0; i < this.pendingRemove.length; i++) {
+        const { event: ev, handler: h } = this.pendingRemove[i];
+        const s = this.listeners.get(ev);
+        if (s) {
+          s.delete(h);
+          if (s.size === 0) this.listeners.delete(ev);
+        }
+      }
+      this.pendingRemove.length = 0;
+    }
+  }
+  /** Remove all listeners for a specific event, or all listeners. */
+  removeAll(event) {
+    if (event !== void 0) {
+      this.listeners.delete(event);
+    } else {
+      this.listeners.clear();
+    }
+    this.pendingRemove.length = 0;
+    this.iterating = false;
+  }
+};
+
+// src/signal.ts
+var Signal = class {
+  handlers = /* @__PURE__ */ new Set();
+  iterating = false;
+  pendingRemove = [];
+  /** Subscribe to the signal. Returns unsubscribe function. */
+  add(handler) {
+    this.handlers.add(handler);
+    return () => {
+      this.remove(handler);
+    };
+  }
+  /** Subscribe once. Returns unsubscribe function. */
+  once(handler) {
+    const wrapper = (value) => {
+      unsub();
+      handler(value);
+    };
+    const unsub = this.add(wrapper);
+    return unsub;
+  }
+  /** Unsubscribe a specific handler. */
+  remove(handler) {
+    if (this.iterating) {
+      this.pendingRemove.push(handler);
+    } else {
+      this.handlers.delete(handler);
+    }
+  }
+  /** Emit a value to all subscribers. Zero-alloc on the hot path. */
+  emit(...args) {
+    const value = args[0];
+    this.iterating = true;
+    for (const handler of this.handlers) {
+      handler(value);
+    }
+    this.iterating = false;
+    if (this.pendingRemove.length > 0) {
+      for (let i = 0; i < this.pendingRemove.length; i++) {
+        this.handlers.delete(this.pendingRemove[i]);
+      }
+      this.pendingRemove.length = 0;
+    }
+  }
+  /** Remove all handlers. */
+  clear() {
+    this.handlers.clear();
+    this.pendingRemove.length = 0;
+    this.iterating = false;
+  }
+};
+export {
+  EventEmitter,
+  Signal
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/emitter.ts","../src/signal.ts"],"sourcesContent":["/** Unsubscribe function returned by on/once. */\nexport type Unsubscribe = () => void;\n\n/** Map of event names to handler signatures. */\nexport type EventMap = Record<string, (...args: never[]) => void>;\n\n/** Type-safe event emitter. */\nexport class EventEmitter<E extends EventMap> {\n  private listeners = new Map<keyof E, Set<E[keyof E]>>();\n  private iterating = false;\n  private pendingRemove: Array<{ event: keyof E; handler: E[keyof E] }> = [];\n\n  /** Subscribe to an event. Returns unsubscribe function. */\n  on<K extends keyof E>(event: K, handler: E[K]): Unsubscribe {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    set.add(handler);\n    return () => {\n      this.off(event, handler);\n    };\n  }\n\n  /** Subscribe to an event once. Returns unsubscribe function. */\n  once<K extends keyof E>(event: K, handler: E[K]): Unsubscribe {\n    const wrapper = ((...args: never[]) => {\n      unsub();\n      // biome-ignore lint/complexity/noBannedTypes: generic handler call\n      (handler as Function)(...args);\n    }) as E[K];\n    const unsub = this.on(event, wrapper);\n    return unsub;\n  }\n\n  /** Unsubscribe a specific handler. */\n  off<K extends keyof E>(event: K, handler: E[K]): void {\n    if (this.iterating) {\n      this.pendingRemove.push({ event, handler });\n      return;\n    }\n    const set = this.listeners.get(event);\n    if (set) {\n      set.delete(handler);\n      if (set.size === 0) this.listeners.delete(event);\n    }\n  }\n\n  /** Emit an event to all subscribers. Zero-alloc on the hot path. */\n  emit<K extends keyof E>(event: K, ...args: Parameters<E[K]>): void {\n    const set = this.listeners.get(event);\n    if (!set) return;\n    this.iterating = true;\n    for (const handler of set) {\n      // biome-ignore lint/complexity/noBannedTypes: generic handler call\n      (handler as Function)(...args);\n    }\n    this.iterating = false;\n    // Flush pending removes (rare path — only when handler unsubscribed during emit)\n    if (this.pendingRemove.length > 0) {\n      for (let i = 0; i < this.pendingRemove.length; i++) {\n        const { event: ev, handler: h } = this.pendingRemove[i]!;\n        const s = this.listeners.get(ev);\n        if (s) {\n          s.delete(h);\n          if (s.size === 0) this.listeners.delete(ev);\n        }\n      }\n      this.pendingRemove.length = 0;\n    }\n  }\n\n  /** Remove all listeners for a specific event, or all listeners. */\n  removeAll(event?: keyof E): void {\n    if (event !== undefined) {\n      this.listeners.delete(event);\n    } else {\n      this.listeners.clear();\n    }\n    this.pendingRemove.length = 0;\n    this.iterating = false;\n  }\n}\n","import type { Unsubscribe } from './emitter.js';\n\n/** Lightweight single-event emitter. Less overhead than EventEmitter. */\nexport class Signal<T = void> {\n  private handlers = new Set<(value: T) => void>();\n  private iterating = false;\n  private pendingRemove: Array<(value: T) => void> = [];\n\n  /** Subscribe to the signal. Returns unsubscribe function. */\n  add(handler: (value: T) => void): Unsubscribe {\n    this.handlers.add(handler);\n    return () => {\n      this.remove(handler);\n    };\n  }\n\n  /** Subscribe once. Returns unsubscribe function. */\n  once(handler: (value: T) => void): Unsubscribe {\n    const wrapper = (value: T) => {\n      unsub();\n      handler(value);\n    };\n    const unsub = this.add(wrapper);\n    return unsub;\n  }\n\n  /** Unsubscribe a specific handler. */\n  remove(handler: (value: T) => void): void {\n    if (this.iterating) {\n      this.pendingRemove.push(handler);\n    } else {\n      this.handlers.delete(handler);\n    }\n  }\n\n  /** Emit a value to all subscribers. Zero-alloc on the hot path. */\n  emit(...args: T extends void ? [] : [value: T]): void {\n    const value = args[0] as T;\n    this.iterating = true;\n    for (const handler of this.handlers) {\n      handler(value);\n    }\n    this.iterating = false;\n    // Flush pending removes (rare path — only when handler removed itself during emit)\n    if (this.pendingRemove.length > 0) {\n      for (let i = 0; i < this.pendingRemove.length; i++) {\n        this.handlers.delete(this.pendingRemove[i]!);\n      }\n      this.pendingRemove.length = 0;\n    }\n  }\n\n  /** Remove all handlers. */\n  clear(): void {\n    this.handlers.clear();\n    this.pendingRemove.length = 0;\n    this.iterating = false;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@flare-engine/events",
+  "version": "0.1.0",
+  "description": "Type-safe EventEmitter and Signal",
+  "keywords": ["flare-engine", "events", "signal", "emitter"],
+  "license": "MIT",
+  "author": "Grzegorz Otto",
+  "homepage": "https://github.com/grzott/flare-engine#readme",
+  "bugs": {
+    "url": "https://github.com/grzott/flare-engine/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grzott/flare-engine.git",
+    "directory": "packages/events"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsup",
+    "test": "bun test",
+    "lint": "biome check src/",
+    "typecheck": "tsc --noEmit"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "sideEffects": false
+}