@streetui/events 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StreetUI contributors
+
+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,26 @@
+# @streetui/events
+
+StreetUI event abstraction — framework event bus, DOM event bridging
+
+Part of [StreetUI](https://github.com/streetui/streetui) — a semantic,
+signal-based UI framework with its own reactivity and keyed DOM reconciler
+(no virtual DOM).
+
+## Install
+
+```sh
+npm install @streetui/events
+```
+
+## Usage
+
+```ts
+import * as pkg from '@streetui/events';
+```
+
+Both ESM (`import`) and CommonJS (`require`) entry points are shipped, with
+matching TypeScript declarations.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,129 @@
+"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, {
+  DomEventRegistry: () => DomEventRegistry,
+  EventBus: () => EventBus,
+  bindDomEvent: () => bindDomEvent,
+  createStreetEvent: () => createStreetEvent,
+  globalEventBus: () => globalEventBus
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/event-types.ts
+function createStreetEvent(type, target, data, originalEvent) {
+  let _stopped = false;
+  const ev = {
+    type,
+    target,
+    data,
+    originalEvent,
+    timestamp: Date.now(),
+    defaultPrevented: false,
+    stopPropagation() {
+      _stopped = true;
+    },
+    preventDefault() {
+      ev.defaultPrevented = true;
+    }
+  };
+  return ev;
+}
+
+// src/event-bus.ts
+var EventBus = class {
+  _handlers = /* @__PURE__ */ new Map();
+  on(type, handler) {
+    let set = this._handlers.get(type);
+    if (set === void 0) {
+      set = /* @__PURE__ */ new Set();
+      this._handlers.set(type, set);
+    }
+    set.add(handler);
+    return () => this.off(type, handler);
+  }
+  off(type, handler) {
+    this._handlers.get(type)?.delete(handler);
+  }
+  once(type, handler) {
+    const wrapped = (event) => {
+      handler(event);
+      this.off(type, wrapped);
+    };
+    return this.on(type, wrapped);
+  }
+  emit(event) {
+    const handlers = this._handlers.get(event.type);
+    if (handlers === void 0) return;
+    for (const h of handlers) {
+      h(event);
+    }
+  }
+  clear(type) {
+    if (type !== void 0) {
+      this._handlers.delete(type);
+    } else {
+      this._handlers.clear();
+    }
+  }
+  listenerCount(type) {
+    return this._handlers.get(type)?.size ?? 0;
+  }
+};
+var globalEventBus = new EventBus();
+
+// src/dom-bridge.ts
+function bindDomEvent(element, domEventType, handler, options) {
+  const listener = (e) => {
+    const streetEvent = createStreetEvent(domEventType, element, void 0, e);
+    handler(streetEvent);
+  };
+  element.addEventListener(domEventType, listener, options);
+  return {
+    remove() {
+      element.removeEventListener(domEventType, listener, options);
+    }
+  };
+}
+var DomEventRegistry = class {
+  _bindings = [];
+  bind(element, type, handler, options) {
+    this._bindings.push(bindDomEvent(element, type, handler, options));
+  }
+  removeAll() {
+    for (const b of this._bindings) {
+      b.remove();
+    }
+    this._bindings.length = 0;
+  }
+  get count() {
+    return this._bindings.length;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DomEventRegistry,
+  EventBus,
+  bindDomEvent,
+  createStreetEvent,
+  globalEventBus
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/event-types.ts","../src/event-bus.ts","../src/dom-bridge.ts"],"sourcesContent":["export * from './event-types.js';\nexport * from './event-bus.js';\nexport * from './dom-bridge.js';\n","/**\n * StreetUI event type catalogue.\n * Framework events are distinct from raw DOM events.\n */\n\nexport type StreetEventType =\n  | 'click'\n  | 'dblclick'\n  | 'input'\n  | 'change'\n  | 'submit'\n  | 'focus'\n  | 'blur'\n  | 'keydown'\n  | 'keyup'\n  | 'keypress'\n  | 'mouseenter'\n  | 'mouseleave'\n  | 'mousemove'\n  | 'mousedown'\n  | 'mouseup'\n  | 'pointerdown'\n  | 'pointerup'\n  | 'pointermove'\n  | 'pointerenter'\n  | 'pointerleave'\n  | 'scroll'\n  | 'resize'\n  | 'mount'\n  | 'unmount'\n  | 'update';\n\nexport interface StreetEvent<T = unknown> {\n  readonly type: StreetEventType | string;\n  readonly target: unknown;\n  readonly data: T | undefined;\n  readonly originalEvent: Event | undefined;\n  readonly timestamp: number;\n  defaultPrevented: boolean;\n  stopPropagation(): void;\n  preventDefault(): void;\n}\n\nexport function createStreetEvent<T = unknown>(\n  type: StreetEventType | string,\n  target: unknown,\n  data?: T,\n  originalEvent?: Event,\n): StreetEvent<T> {\n  let _stopped = false;\n  const ev: StreetEvent<T> = {\n    type,\n    target,\n    data: data as T | undefined,\n    originalEvent: originalEvent as Event | undefined,\n    timestamp: Date.now(),\n    defaultPrevented: false,\n    stopPropagation() { _stopped = true; },\n    preventDefault() { ev.defaultPrevented = true; },\n  };\n  return ev;\n}\n\nexport type EventHandler<T = unknown> = (event: StreetEvent<T>) => void;\n","/**\n * Framework-internal event bus.\n * Decouples emitters from handlers across subsystems.\n */\n\nimport type { StreetEvent, EventHandler } from './event-types.js';\n\nexport class EventBus {\n  private readonly _handlers: Map<string, Set<EventHandler>> = new Map();\n\n  on<T = unknown>(type: string, handler: EventHandler<T>): () => void {\n    let set = this._handlers.get(type);\n    if (set === undefined) {\n      set = new Set();\n      this._handlers.set(type, set);\n    }\n    set.add(handler as EventHandler);\n    return () => this.off(type, handler as EventHandler);\n  }\n\n  off<T = unknown>(type: string, handler: EventHandler<T>): void {\n    this._handlers.get(type)?.delete(handler as EventHandler);\n  }\n\n  once<T = unknown>(type: string, handler: EventHandler<T>): () => void {\n    const wrapped: EventHandler<T> = (event) => {\n      handler(event);\n      this.off(type, wrapped);\n    };\n    return this.on(type, wrapped);\n  }\n\n  emit<T = unknown>(event: StreetEvent<T>): void {\n    const handlers = this._handlers.get(event.type);\n    if (handlers === undefined) return;\n    for (const h of handlers) {\n      h(event as StreetEvent);\n    }\n  }\n\n  clear(type?: string): void {\n    if (type !== undefined) {\n      this._handlers.delete(type);\n    } else {\n      this._handlers.clear();\n    }\n  }\n\n  listenerCount(type: string): number {\n    return this._handlers.get(type)?.size ?? 0;\n  }\n}\n\nexport const globalEventBus = new EventBus();\n","/**\n * DOM ↔ StreetUI event bridge.\n *\n * Attaches native DOM event listeners and translates them into\n * StreetUI events dispatched to registered handlers.\n * The renderer uses this to wire events without coupling\n * DOM event mechanics into the render pipeline directly.\n */\n\nimport { createStreetEvent, type EventHandler, type StreetEventType } from './event-types.js';\n\nexport interface DomBinding {\n  remove(): void;\n}\n\n/**\n * Attach a DOM event listener that fires the given StreetUI handler.\n * Returns a binding whose `remove()` detaches the listener.\n */\nexport function bindDomEvent<T extends Event = Event>(\n  element: EventTarget,\n  domEventType: StreetEventType | string,\n  handler: EventHandler,\n  options?: AddEventListenerOptions,\n): DomBinding {\n  const listener = (e: T) => {\n    const streetEvent = createStreetEvent(domEventType, element, undefined, e as unknown as Event);\n    handler(streetEvent);\n  };\n\n  element.addEventListener(domEventType, listener as EventListener, options);\n\n  return {\n    remove() {\n      element.removeEventListener(domEventType, listener as EventListener, options);\n    },\n  };\n}\n\n/**\n * A registry that tracks all DOM bindings for a single node,\n * making bulk teardown easy.\n */\nexport class DomEventRegistry {\n  private readonly _bindings: DomBinding[] = [];\n\n  bind(\n    element: EventTarget,\n    type: StreetEventType | string,\n    handler: EventHandler,\n    options?: AddEventListenerOptions,\n  ): void {\n    this._bindings.push(bindDomEvent(element, type, handler, options));\n  }\n\n  removeAll(): void {\n    for (const b of this._bindings) {\n      b.remove();\n    }\n    this._bindings.length = 0;\n  }\n\n  get count(): number {\n    return this._bindings.length;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC2CO,SAAS,kBACd,MACA,QACA,MACA,eACgB;AAChB,MAAI,WAAW;AACf,QAAM,KAAqB;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,KAAK,IAAI;AAAA,IACpB,kBAAkB;AAAA,IAClB,kBAAkB;AAAE,iBAAW;AAAA,IAAM;AAAA,IACrC,iBAAiB;AAAE,SAAG,mBAAmB;AAAA,IAAM;AAAA,EACjD;AACA,SAAO;AACT;;;ACtDO,IAAM,WAAN,MAAe;AAAA,EACH,YAA4C,oBAAI,IAAI;AAAA,EAErE,GAAgB,MAAc,SAAsC;AAClE,QAAI,MAAM,KAAK,UAAU,IAAI,IAAI;AACjC,QAAI,QAAQ,QAAW;AACrB,YAAM,oBAAI,IAAI;AACd,WAAK,UAAU,IAAI,MAAM,GAAG;AAAA,IAC9B;AACA,QAAI,IAAI,OAAuB;AAC/B,WAAO,MAAM,KAAK,IAAI,MAAM,OAAuB;AAAA,EACrD;AAAA,EAEA,IAAiB,MAAc,SAAgC;AAC7D,SAAK,UAAU,IAAI,IAAI,GAAG,OAAO,OAAuB;AAAA,EAC1D;AAAA,EAEA,KAAkB,MAAc,SAAsC;AACpE,UAAM,UAA2B,CAAC,UAAU;AAC1C,cAAQ,KAAK;AACb,WAAK,IAAI,MAAM,OAAO;AAAA,IACxB;AACA,WAAO,KAAK,GAAG,MAAM,OAAO;AAAA,EAC9B;AAAA,EAEA,KAAkB,OAA6B;AAC7C,UAAM,WAAW,KAAK,UAAU,IAAI,MAAM,IAAI;AAC9C,QAAI,aAAa,OAAW;AAC5B,eAAW,KAAK,UAAU;AACxB,QAAE,KAAoB;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,MAAM,MAAqB;AACzB,QAAI,SAAS,QAAW;AACtB,WAAK,UAAU,OAAO,IAAI;AAAA,IAC5B,OAAO;AACL,WAAK,UAAU,MAAM;AAAA,IACvB;AAAA,EACF;AAAA,EAEA,cAAc,MAAsB;AAClC,WAAO,KAAK,UAAU,IAAI,IAAI,GAAG,QAAQ;AAAA,EAC3C;AACF;AAEO,IAAM,iBAAiB,IAAI,SAAS;;;AClCpC,SAAS,aACd,SACA,cACA,SACA,SACY;AACZ,QAAM,WAAW,CAAC,MAAS;AACzB,UAAM,cAAc,kBAAkB,cAAc,SAAS,QAAW,CAAqB;AAC7F,YAAQ,WAAW;AAAA,EACrB;AAEA,UAAQ,iBAAiB,cAAc,UAA2B,OAAO;AAEzE,SAAO;AAAA,IACL,SAAS;AACP,cAAQ,oBAAoB,cAAc,UAA2B,OAAO;AAAA,IAC9E;AAAA,EACF;AACF;AAMO,IAAM,mBAAN,MAAuB;AAAA,EACX,YAA0B,CAAC;AAAA,EAE5C,KACE,SACA,MACA,SACA,SACM;AACN,SAAK,UAAU,KAAK,aAAa,SAAS,MAAM,SAAS,OAAO,CAAC;AAAA,EACnE;AAAA,EAEA,YAAkB;AAChB,eAAW,KAAK,KAAK,WAAW;AAC9B,QAAE,OAAO;AAAA,IACX;AACA,SAAK,UAAU,SAAS;AAAA,EAC1B;AAAA,EAEA,IAAI,QAAgB;AAClB,WAAO,KAAK,UAAU;AAAA,EACxB;AACF;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,63 @@
+/**
+ * StreetUI event type catalogue.
+ * Framework events are distinct from raw DOM events.
+ */
+type StreetEventType = 'click' | 'dblclick' | 'input' | 'change' | 'submit' | 'focus' | 'blur' | 'keydown' | 'keyup' | 'keypress' | 'mouseenter' | 'mouseleave' | 'mousemove' | 'mousedown' | 'mouseup' | 'pointerdown' | 'pointerup' | 'pointermove' | 'pointerenter' | 'pointerleave' | 'scroll' | 'resize' | 'mount' | 'unmount' | 'update';
+interface StreetEvent<T = unknown> {
+    readonly type: StreetEventType | string;
+    readonly target: unknown;
+    readonly data: T | undefined;
+    readonly originalEvent: Event | undefined;
+    readonly timestamp: number;
+    defaultPrevented: boolean;
+    stopPropagation(): void;
+    preventDefault(): void;
+}
+declare function createStreetEvent<T = unknown>(type: StreetEventType | string, target: unknown, data?: T, originalEvent?: Event): StreetEvent<T>;
+type EventHandler<T = unknown> = (event: StreetEvent<T>) => void;
+
+/**
+ * Framework-internal event bus.
+ * Decouples emitters from handlers across subsystems.
+ */
+
+declare class EventBus {
+    private readonly _handlers;
+    on<T = unknown>(type: string, handler: EventHandler<T>): () => void;
+    off<T = unknown>(type: string, handler: EventHandler<T>): void;
+    once<T = unknown>(type: string, handler: EventHandler<T>): () => void;
+    emit<T = unknown>(event: StreetEvent<T>): void;
+    clear(type?: string): void;
+    listenerCount(type: string): number;
+}
+declare const globalEventBus: EventBus;
+
+/**
+ * DOM ↔ StreetUI event bridge.
+ *
+ * Attaches native DOM event listeners and translates them into
+ * StreetUI events dispatched to registered handlers.
+ * The renderer uses this to wire events without coupling
+ * DOM event mechanics into the render pipeline directly.
+ */
+
+interface DomBinding {
+    remove(): void;
+}
+/**
+ * Attach a DOM event listener that fires the given StreetUI handler.
+ * Returns a binding whose `remove()` detaches the listener.
+ */
+declare function bindDomEvent<T extends Event = Event>(element: EventTarget, domEventType: StreetEventType | string, handler: EventHandler, options?: AddEventListenerOptions): DomBinding;
+/**
+ * A registry that tracks all DOM bindings for a single node,
+ * making bulk teardown easy.
+ */
+declare class DomEventRegistry {
+    private readonly _bindings;
+    bind(element: EventTarget, type: StreetEventType | string, handler: EventHandler, options?: AddEventListenerOptions): void;
+    removeAll(): void;
+    get count(): number;
+}
+
+export { type DomBinding, DomEventRegistry, EventBus, type EventHandler, type StreetEvent, type StreetEventType, bindDomEvent, createStreetEvent, globalEventBus };

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * StreetUI event type catalogue.
+ * Framework events are distinct from raw DOM events.
+ */
+type StreetEventType = 'click' | 'dblclick' | 'input' | 'change' | 'submit' | 'focus' | 'blur' | 'keydown' | 'keyup' | 'keypress' | 'mouseenter' | 'mouseleave' | 'mousemove' | 'mousedown' | 'mouseup' | 'pointerdown' | 'pointerup' | 'pointermove' | 'pointerenter' | 'pointerleave' | 'scroll' | 'resize' | 'mount' | 'unmount' | 'update';
+interface StreetEvent<T = unknown> {
+    readonly type: StreetEventType | string;
+    readonly target: unknown;
+    readonly data: T | undefined;
+    readonly originalEvent: Event | undefined;
+    readonly timestamp: number;
+    defaultPrevented: boolean;
+    stopPropagation(): void;
+    preventDefault(): void;
+}
+declare function createStreetEvent<T = unknown>(type: StreetEventType | string, target: unknown, data?: T, originalEvent?: Event): StreetEvent<T>;
+type EventHandler<T = unknown> = (event: StreetEvent<T>) => void;
+
+/**
+ * Framework-internal event bus.
+ * Decouples emitters from handlers across subsystems.
+ */
+
+declare class EventBus {
+    private readonly _handlers;
+    on<T = unknown>(type: string, handler: EventHandler<T>): () => void;
+    off<T = unknown>(type: string, handler: EventHandler<T>): void;
+    once<T = unknown>(type: string, handler: EventHandler<T>): () => void;
+    emit<T = unknown>(event: StreetEvent<T>): void;
+    clear(type?: string): void;
+    listenerCount(type: string): number;
+}
+declare const globalEventBus: EventBus;
+
+/**
+ * DOM ↔ StreetUI event bridge.
+ *
+ * Attaches native DOM event listeners and translates them into
+ * StreetUI events dispatched to registered handlers.
+ * The renderer uses this to wire events without coupling
+ * DOM event mechanics into the render pipeline directly.
+ */
+
+interface DomBinding {
+    remove(): void;
+}
+/**
+ * Attach a DOM event listener that fires the given StreetUI handler.
+ * Returns a binding whose `remove()` detaches the listener.
+ */
+declare function bindDomEvent<T extends Event = Event>(element: EventTarget, domEventType: StreetEventType | string, handler: EventHandler, options?: AddEventListenerOptions): DomBinding;
+/**
+ * A registry that tracks all DOM bindings for a single node,
+ * making bulk teardown easy.
+ */
+declare class DomEventRegistry {
+    private readonly _bindings;
+    bind(element: EventTarget, type: StreetEventType | string, handler: EventHandler, options?: AddEventListenerOptions): void;
+    removeAll(): void;
+    get count(): number;
+}
+
+export { type DomBinding, DomEventRegistry, EventBus, type EventHandler, type StreetEvent, type StreetEventType, bindDomEvent, createStreetEvent, globalEventBus };

package/dist/index.js

@@ -0,0 +1,98 @@
+// src/event-types.ts
+function createStreetEvent(type, target, data, originalEvent) {
+  let _stopped = false;
+  const ev = {
+    type,
+    target,
+    data,
+    originalEvent,
+    timestamp: Date.now(),
+    defaultPrevented: false,
+    stopPropagation() {
+      _stopped = true;
+    },
+    preventDefault() {
+      ev.defaultPrevented = true;
+    }
+  };
+  return ev;
+}
+
+// src/event-bus.ts
+var EventBus = class {
+  _handlers = /* @__PURE__ */ new Map();
+  on(type, handler) {
+    let set = this._handlers.get(type);
+    if (set === void 0) {
+      set = /* @__PURE__ */ new Set();
+      this._handlers.set(type, set);
+    }
+    set.add(handler);
+    return () => this.off(type, handler);
+  }
+  off(type, handler) {
+    this._handlers.get(type)?.delete(handler);
+  }
+  once(type, handler) {
+    const wrapped = (event) => {
+      handler(event);
+      this.off(type, wrapped);
+    };
+    return this.on(type, wrapped);
+  }
+  emit(event) {
+    const handlers = this._handlers.get(event.type);
+    if (handlers === void 0) return;
+    for (const h of handlers) {
+      h(event);
+    }
+  }
+  clear(type) {
+    if (type !== void 0) {
+      this._handlers.delete(type);
+    } else {
+      this._handlers.clear();
+    }
+  }
+  listenerCount(type) {
+    return this._handlers.get(type)?.size ?? 0;
+  }
+};
+var globalEventBus = new EventBus();
+
+// src/dom-bridge.ts
+function bindDomEvent(element, domEventType, handler, options) {
+  const listener = (e) => {
+    const streetEvent = createStreetEvent(domEventType, element, void 0, e);
+    handler(streetEvent);
+  };
+  element.addEventListener(domEventType, listener, options);
+  return {
+    remove() {
+      element.removeEventListener(domEventType, listener, options);
+    }
+  };
+}
+var DomEventRegistry = class {
+  _bindings = [];
+  bind(element, type, handler, options) {
+    this._bindings.push(bindDomEvent(element, type, handler, options));
+  }
+  removeAll() {
+    for (const b of this._bindings) {
+      b.remove();
+    }
+    this._bindings.length = 0;
+  }
+  get count() {
+    return this._bindings.length;
+  }
+};
+export {
+  DomEventRegistry,
+  EventBus,
+  bindDomEvent,
+  createStreetEvent,
+  globalEventBus
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/event-types.ts","../src/event-bus.ts","../src/dom-bridge.ts"],"sourcesContent":["/**\n * StreetUI event type catalogue.\n * Framework events are distinct from raw DOM events.\n */\n\nexport type StreetEventType =\n  | 'click'\n  | 'dblclick'\n  | 'input'\n  | 'change'\n  | 'submit'\n  | 'focus'\n  | 'blur'\n  | 'keydown'\n  | 'keyup'\n  | 'keypress'\n  | 'mouseenter'\n  | 'mouseleave'\n  | 'mousemove'\n  | 'mousedown'\n  | 'mouseup'\n  | 'pointerdown'\n  | 'pointerup'\n  | 'pointermove'\n  | 'pointerenter'\n  | 'pointerleave'\n  | 'scroll'\n  | 'resize'\n  | 'mount'\n  | 'unmount'\n  | 'update';\n\nexport interface StreetEvent<T = unknown> {\n  readonly type: StreetEventType | string;\n  readonly target: unknown;\n  readonly data: T | undefined;\n  readonly originalEvent: Event | undefined;\n  readonly timestamp: number;\n  defaultPrevented: boolean;\n  stopPropagation(): void;\n  preventDefault(): void;\n}\n\nexport function createStreetEvent<T = unknown>(\n  type: StreetEventType | string,\n  target: unknown,\n  data?: T,\n  originalEvent?: Event,\n): StreetEvent<T> {\n  let _stopped = false;\n  const ev: StreetEvent<T> = {\n    type,\n    target,\n    data: data as T | undefined,\n    originalEvent: originalEvent as Event | undefined,\n    timestamp: Date.now(),\n    defaultPrevented: false,\n    stopPropagation() { _stopped = true; },\n    preventDefault() { ev.defaultPrevented = true; },\n  };\n  return ev;\n}\n\nexport type EventHandler<T = unknown> = (event: StreetEvent<T>) => void;\n","/**\n * Framework-internal event bus.\n * Decouples emitters from handlers across subsystems.\n */\n\nimport type { StreetEvent, EventHandler } from './event-types.js';\n\nexport class EventBus {\n  private readonly _handlers: Map<string, Set<EventHandler>> = new Map();\n\n  on<T = unknown>(type: string, handler: EventHandler<T>): () => void {\n    let set = this._handlers.get(type);\n    if (set === undefined) {\n      set = new Set();\n      this._handlers.set(type, set);\n    }\n    set.add(handler as EventHandler);\n    return () => this.off(type, handler as EventHandler);\n  }\n\n  off<T = unknown>(type: string, handler: EventHandler<T>): void {\n    this._handlers.get(type)?.delete(handler as EventHandler);\n  }\n\n  once<T = unknown>(type: string, handler: EventHandler<T>): () => void {\n    const wrapped: EventHandler<T> = (event) => {\n      handler(event);\n      this.off(type, wrapped);\n    };\n    return this.on(type, wrapped);\n  }\n\n  emit<T = unknown>(event: StreetEvent<T>): void {\n    const handlers = this._handlers.get(event.type);\n    if (handlers === undefined) return;\n    for (const h of handlers) {\n      h(event as StreetEvent);\n    }\n  }\n\n  clear(type?: string): void {\n    if (type !== undefined) {\n      this._handlers.delete(type);\n    } else {\n      this._handlers.clear();\n    }\n  }\n\n  listenerCount(type: string): number {\n    return this._handlers.get(type)?.size ?? 0;\n  }\n}\n\nexport const globalEventBus = new EventBus();\n","/**\n * DOM ↔ StreetUI event bridge.\n *\n * Attaches native DOM event listeners and translates them into\n * StreetUI events dispatched to registered handlers.\n * The renderer uses this to wire events without coupling\n * DOM event mechanics into the render pipeline directly.\n */\n\nimport { createStreetEvent, type EventHandler, type StreetEventType } from './event-types.js';\n\nexport interface DomBinding {\n  remove(): void;\n}\n\n/**\n * Attach a DOM event listener that fires the given StreetUI handler.\n * Returns a binding whose `remove()` detaches the listener.\n */\nexport function bindDomEvent<T extends Event = Event>(\n  element: EventTarget,\n  domEventType: StreetEventType | string,\n  handler: EventHandler,\n  options?: AddEventListenerOptions,\n): DomBinding {\n  const listener = (e: T) => {\n    const streetEvent = createStreetEvent(domEventType, element, undefined, e as unknown as Event);\n    handler(streetEvent);\n  };\n\n  element.addEventListener(domEventType, listener as EventListener, options);\n\n  return {\n    remove() {\n      element.removeEventListener(domEventType, listener as EventListener, options);\n    },\n  };\n}\n\n/**\n * A registry that tracks all DOM bindings for a single node,\n * making bulk teardown easy.\n */\nexport class DomEventRegistry {\n  private readonly _bindings: DomBinding[] = [];\n\n  bind(\n    element: EventTarget,\n    type: StreetEventType | string,\n    handler: EventHandler,\n    options?: AddEventListenerOptions,\n  ): void {\n    this._bindings.push(bindDomEvent(element, type, handler, options));\n  }\n\n  removeAll(): void {\n    for (const b of this._bindings) {\n      b.remove();\n    }\n    this._bindings.length = 0;\n  }\n\n  get count(): number {\n    return this._bindings.length;\n  }\n}\n"],"mappings":";AA2CO,SAAS,kBACd,MACA,QACA,MACA,eACgB;AAChB,MAAI,WAAW;AACf,QAAM,KAAqB;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,KAAK,IAAI;AAAA,IACpB,kBAAkB;AAAA,IAClB,kBAAkB;AAAE,iBAAW;AAAA,IAAM;AAAA,IACrC,iBAAiB;AAAE,SAAG,mBAAmB;AAAA,IAAM;AAAA,EACjD;AACA,SAAO;AACT;;;ACtDO,IAAM,WAAN,MAAe;AAAA,EACH,YAA4C,oBAAI,IAAI;AAAA,EAErE,GAAgB,MAAc,SAAsC;AAClE,QAAI,MAAM,KAAK,UAAU,IAAI,IAAI;AACjC,QAAI,QAAQ,QAAW;AACrB,YAAM,oBAAI,IAAI;AACd,WAAK,UAAU,IAAI,MAAM,GAAG;AAAA,IAC9B;AACA,QAAI,IAAI,OAAuB;AAC/B,WAAO,MAAM,KAAK,IAAI,MAAM,OAAuB;AAAA,EACrD;AAAA,EAEA,IAAiB,MAAc,SAAgC;AAC7D,SAAK,UAAU,IAAI,IAAI,GAAG,OAAO,OAAuB;AAAA,EAC1D;AAAA,EAEA,KAAkB,MAAc,SAAsC;AACpE,UAAM,UAA2B,CAAC,UAAU;AAC1C,cAAQ,KAAK;AACb,WAAK,IAAI,MAAM,OAAO;AAAA,IACxB;AACA,WAAO,KAAK,GAAG,MAAM,OAAO;AAAA,EAC9B;AAAA,EAEA,KAAkB,OAA6B;AAC7C,UAAM,WAAW,KAAK,UAAU,IAAI,MAAM,IAAI;AAC9C,QAAI,aAAa,OAAW;AAC5B,eAAW,KAAK,UAAU;AACxB,QAAE,KAAoB;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,MAAM,MAAqB;AACzB,QAAI,SAAS,QAAW;AACtB,WAAK,UAAU,OAAO,IAAI;AAAA,IAC5B,OAAO;AACL,WAAK,UAAU,MAAM;AAAA,IACvB;AAAA,EACF;AAAA,EAEA,cAAc,MAAsB;AAClC,WAAO,KAAK,UAAU,IAAI,IAAI,GAAG,QAAQ;AAAA,EAC3C;AACF;AAEO,IAAM,iBAAiB,IAAI,SAAS;;;AClCpC,SAAS,aACd,SACA,cACA,SACA,SACY;AACZ,QAAM,WAAW,CAAC,MAAS;AACzB,UAAM,cAAc,kBAAkB,cAAc,SAAS,QAAW,CAAqB;AAC7F,YAAQ,WAAW;AAAA,EACrB;AAEA,UAAQ,iBAAiB,cAAc,UAA2B,OAAO;AAEzE,SAAO;AAAA,IACL,SAAS;AACP,cAAQ,oBAAoB,cAAc,UAA2B,OAAO;AAAA,IAC9E;AAAA,EACF;AACF;AAMO,IAAM,mBAAN,MAAuB;AAAA,EACX,YAA0B,CAAC;AAAA,EAE5C,KACE,SACA,MACA,SACA,SACM;AACN,SAAK,UAAU,KAAK,aAAa,SAAS,MAAM,SAAS,OAAO,CAAC;AAAA,EACnE;AAAA,EAEA,YAAkB;AAChB,eAAW,KAAK,KAAK,WAAW;AAC9B,QAAE,OAAO;AAAA,IACX;AACA,SAAK,UAAU,SAAS;AAAA,EAC1B;AAAA,EAEA,IAAI,QAAgB;AAClB,WAAO,KAAK,UAAU;AAAA,EACxB;AACF;","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@streetui/events",
+  "version": "1.0.0",
+  "description": "StreetUI event abstraction — framework event bus, DOM event bridging",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "typescript": "*",
+    "tsup": "*",
+    "vitest": "*"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
+}