refactor(event-bus): extract to shared module
The EventBus was duplicated inside shapeseq/ but is used by other playground code too. Move the canonical implementation to js/event-bus.js and turn the shapeseq copy into a re-export shim.
This commit is contained in:
w1n5t0n
parent
452754f448
commit
3f4ffcd4f9
2 changed files with 119 additions and 117 deletions
117
playground/js/event-bus.js
Normal file
117
playground/js/event-bus.js
Normal file
|
|
@ -0,0 +1,117 @@
|
||||||
|
// Namespaced Event Bus
|
||||||
|
// Lightweight pub/sub with seq.*/ml.*/ui.* namespaces and wildcard support.
|
||||||
|
|
||||||
|
// ── Event name constants ────────────────────────────────────────────
|
||||||
|
|
||||||
|
export const SEQ = Object.freeze({
|
||||||
|
STEP: 'seq.step',
|
||||||
|
NOTE_ON: 'seq.noteOn',
|
||||||
|
NOTE_OFF: 'seq.noteOff',
|
||||||
|
PARAM_CHANGE: 'seq.paramChange',
|
||||||
|
LOOP_START: 'seq.loopStart',
|
||||||
|
});
|
||||||
|
|
||||||
|
export const ML = Object.freeze({
|
||||||
|
TRAINED: 'ml.trained',
|
||||||
|
FROZEN: 'ml.frozen',
|
||||||
|
UNFROZEN: 'ml.unfrozen',
|
||||||
|
DELTA_UPDATE: 'ml.deltaUpdate',
|
||||||
|
});
|
||||||
|
|
||||||
|
export const UI = Object.freeze({
|
||||||
|
PARAM_SELECT: 'ui.paramSelect',
|
||||||
|
CHAIN_EDIT: 'ui.chainEdit',
|
||||||
|
PRESET_LOAD: 'ui.presetLoad',
|
||||||
|
FREEZE_TOGGLE: 'ui.freezeToggle',
|
||||||
|
});
|
||||||
|
|
||||||
|
// ── Bus implementation ──────────────────────────────────────────────
|
||||||
|
|
||||||
|
export class EventBus {
|
||||||
|
/** @param {AudioContext} [audioCtx] - optional, used for seq.* timestamps */
|
||||||
|
constructor(audioCtx) {
|
||||||
|
this._listeners = new Map(); // event -> Set<callback>
|
||||||
|
this._wildcards = new Map(); // namespace prefix (e.g. "seq") -> Set<callback>
|
||||||
|
this._audioCtx = audioCtx ?? null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Provide or replace the AudioContext used for seq.* timestamps. */
|
||||||
|
setAudioContext(ctx) {
|
||||||
|
this._audioCtx = ctx;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Subscribe to an event or a wildcard namespace.
|
||||||
|
* on('seq.step', cb) — exact match
|
||||||
|
* on('seq.*', cb) — all events in the seq namespace
|
||||||
|
*/
|
||||||
|
on(event, callback) {
|
||||||
|
if (event.endsWith('.*')) {
|
||||||
|
const ns = event.slice(0, -2); // "seq.*" -> "seq"
|
||||||
|
if (!this._wildcards.has(ns)) this._wildcards.set(ns, new Set());
|
||||||
|
this._wildcards.get(ns).add(callback);
|
||||||
|
} else {
|
||||||
|
if (!this._listeners.has(event)) this._listeners.set(event, new Set());
|
||||||
|
this._listeners.get(event).add(callback);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Unsubscribe. Mirrors the on() signature. */
|
||||||
|
off(event, callback) {
|
||||||
|
if (event.endsWith('.*')) {
|
||||||
|
const ns = event.slice(0, -2);
|
||||||
|
const set = this._wildcards.get(ns);
|
||||||
|
if (set) {
|
||||||
|
set.delete(callback);
|
||||||
|
if (set.size === 0) this._wildcards.delete(ns);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
const set = this._listeners.get(event);
|
||||||
|
if (set) {
|
||||||
|
set.delete(callback);
|
||||||
|
if (set.size === 0) this._listeners.delete(event);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Emit an event.
|
||||||
|
* A `timestamp` field is added automatically:
|
||||||
|
* - seq.* events use AudioContext.currentTime (seconds)
|
||||||
|
* - all others use performance.now() (milliseconds)
|
||||||
|
*/
|
||||||
|
emit(event, data = {}) {
|
||||||
|
const ns = event.split('.')[0];
|
||||||
|
const stamped = Object.assign({ timestamp: this._stamp(ns) }, data);
|
||||||
|
|
||||||
|
// Exact listeners
|
||||||
|
const exact = this._listeners.get(event);
|
||||||
|
if (exact) {
|
||||||
|
for (const cb of exact) cb(stamped, event);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Wildcard listeners for this namespace
|
||||||
|
const wild = this._wildcards.get(ns);
|
||||||
|
if (wild) {
|
||||||
|
for (const cb of wild) cb(stamped, event);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ── private ──
|
||||||
|
|
||||||
|
_stamp(ns) {
|
||||||
|
if (ns === 'seq' && this._audioCtx) return this._audioCtx.currentTime;
|
||||||
|
return performance.now();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ── Singleton convenience ───────────────────────────────────────────
|
||||||
|
|
||||||
|
let _default = null;
|
||||||
|
|
||||||
|
/** Return (and lazily create) the shared default bus. */
|
||||||
|
export function getDefaultBus(audioCtx) {
|
||||||
|
if (!_default) _default = new EventBus(audioCtx);
|
||||||
|
else if (audioCtx) _default.setAudioContext(audioCtx);
|
||||||
|
return _default;
|
||||||
|
}
|
||||||
|
|
@ -1,117 +1,2 @@
|
||||||
// ShapeSeq Namespaced Event Bus
|
// playground/js/shapeseq/event-bus.js — re-exports from shared module
|
||||||
// Lightweight pub/sub with seq.*/ml.*/ui.* namespaces and wildcard support.
|
export { EventBus, SEQ, ML, UI, getDefaultBus } from '../event-bus.js';
|
||||||
|
|
||||||
// ── Event name constants ────────────────────────────────────────────
|
|
||||||
|
|
||||||
export const SEQ = Object.freeze({
|
|
||||||
STEP: 'seq.step',
|
|
||||||
NOTE_ON: 'seq.noteOn',
|
|
||||||
NOTE_OFF: 'seq.noteOff',
|
|
||||||
PARAM_CHANGE: 'seq.paramChange',
|
|
||||||
LOOP_START: 'seq.loopStart',
|
|
||||||
});
|
|
||||||
|
|
||||||
export const ML = Object.freeze({
|
|
||||||
TRAINED: 'ml.trained',
|
|
||||||
FROZEN: 'ml.frozen',
|
|
||||||
UNFROZEN: 'ml.unfrozen',
|
|
||||||
DELTA_UPDATE: 'ml.deltaUpdate',
|
|
||||||
});
|
|
||||||
|
|
||||||
export const UI = Object.freeze({
|
|
||||||
PARAM_SELECT: 'ui.paramSelect',
|
|
||||||
CHAIN_EDIT: 'ui.chainEdit',
|
|
||||||
PRESET_LOAD: 'ui.presetLoad',
|
|
||||||
FREEZE_TOGGLE: 'ui.freezeToggle',
|
|
||||||
});
|
|
||||||
|
|
||||||
// ── Bus implementation ──────────────────────────────────────────────
|
|
||||||
|
|
||||||
export class EventBus {
|
|
||||||
/** @param {AudioContext} [audioCtx] - optional, used for seq.* timestamps */
|
|
||||||
constructor(audioCtx) {
|
|
||||||
this._listeners = new Map(); // event -> Set<callback>
|
|
||||||
this._wildcards = new Map(); // namespace prefix (e.g. "seq") -> Set<callback>
|
|
||||||
this._audioCtx = audioCtx ?? null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Provide or replace the AudioContext used for seq.* timestamps. */
|
|
||||||
setAudioContext(ctx) {
|
|
||||||
this._audioCtx = ctx;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Subscribe to an event or a wildcard namespace.
|
|
||||||
* on('seq.step', cb) — exact match
|
|
||||||
* on('seq.*', cb) — all events in the seq namespace
|
|
||||||
*/
|
|
||||||
on(event, callback) {
|
|
||||||
if (event.endsWith('.*')) {
|
|
||||||
const ns = event.slice(0, -2); // "seq.*" -> "seq"
|
|
||||||
if (!this._wildcards.has(ns)) this._wildcards.set(ns, new Set());
|
|
||||||
this._wildcards.get(ns).add(callback);
|
|
||||||
} else {
|
|
||||||
if (!this._listeners.has(event)) this._listeners.set(event, new Set());
|
|
||||||
this._listeners.get(event).add(callback);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Unsubscribe. Mirrors the on() signature. */
|
|
||||||
off(event, callback) {
|
|
||||||
if (event.endsWith('.*')) {
|
|
||||||
const ns = event.slice(0, -2);
|
|
||||||
const set = this._wildcards.get(ns);
|
|
||||||
if (set) {
|
|
||||||
set.delete(callback);
|
|
||||||
if (set.size === 0) this._wildcards.delete(ns);
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
const set = this._listeners.get(event);
|
|
||||||
if (set) {
|
|
||||||
set.delete(callback);
|
|
||||||
if (set.size === 0) this._listeners.delete(event);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Emit an event.
|
|
||||||
* A `timestamp` field is added automatically:
|
|
||||||
* - seq.* events use AudioContext.currentTime (seconds)
|
|
||||||
* - all others use performance.now() (milliseconds)
|
|
||||||
*/
|
|
||||||
emit(event, data = {}) {
|
|
||||||
const ns = event.split('.')[0];
|
|
||||||
const stamped = Object.assign({ timestamp: this._stamp(ns) }, data);
|
|
||||||
|
|
||||||
// Exact listeners
|
|
||||||
const exact = this._listeners.get(event);
|
|
||||||
if (exact) {
|
|
||||||
for (const cb of exact) cb(stamped, event);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Wildcard listeners for this namespace
|
|
||||||
const wild = this._wildcards.get(ns);
|
|
||||||
if (wild) {
|
|
||||||
for (const cb of wild) cb(stamped, event);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// ── private ──
|
|
||||||
|
|
||||||
_stamp(ns) {
|
|
||||||
if (ns === 'seq' && this._audioCtx) return this._audioCtx.currentTime;
|
|
||||||
return performance.now();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// ── Singleton convenience ───────────────────────────────────────────
|
|
||||||
|
|
||||||
let _default = null;
|
|
||||||
|
|
||||||
/** Return (and lazily create) the shared default bus. */
|
|
||||||
export function getDefaultBus(audioCtx) {
|
|
||||||
if (!_default) _default = new EventBus(audioCtx);
|
|
||||||
else if (audioCtx) _default.setAudioContext(audioCtx);
|
|
||||||
return _default;
|
|
||||||
}
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue