@sadhaka/loom-engine 0.14.0 → 0.16.0

package/dist/audio/spatial-audio-system.js

@@ -0,0 +1,98 @@
+// SpatialAudioSystem - pushes the local character's transform into
+// the AudioListener resource and the SpatialAudioBus each frame.
+//
+// Phasing rationale (matches PeerRenderSystem / animation-system):
+//   PHASE_RENDER, AFTER any camera/transform sync systems, BEFORE
+//   the renderer submits draw calls. The listener pose for THIS frame
+//   reflects the THIS-FRAME world transform of the player - so a
+//   positional sound triggered by a render-phase system (e.g. cue
+//   reactions to zone events drained earlier in PHASE_LOGIC) hears
+//   the world from the up-to-date listener pose.
+//
+// Per LOOM-AUDIO-SPEC.md §3.3 the work is one-line: read the local
+// character's TransformPool entry by entity id, write its (x, y, z)
+// into the AudioListenerResource.pose, stamp lastUpdateFrame, and
+// hand the pose to SpatialAudioBus.setListener.
+//
+// Identity binding: the engine doesn't know which entity is the local
+// character - that's a consumer concern (TWT wires it after server
+// auth completes). Consumers call setLocalCharacterEntity(entity) on
+// the system. setLocalCharacterEntity(null) puts the system back into
+// no-op mode (e.g. between zones during a teleport).
+//
+// Tolerates:
+//   - missing AudioListenerResource (silent no-op; engine probably
+//     not yet fully wired)
+//   - missing SpatialAudioBus (silent no-op; consumer might have
+//     opted out of spatial audio entirely - the system still keeps
+//     the resource fresh for debug/HUD readers)
+//   - missing TransformPool (silent no-op; engine without ECS
+//     transforms is unusual but valid in headless server tests)
+//   - local character set but transform not attached yet (no-op)
+//
+// What this system does NOT do (deferred to future phases):
+//   - rotate the listener with the player's facing (spec §8.4 fixes
+//     forward = (0, 0, -1))
+//   - apply velocity-based Doppler (PannerNode.setVelocity is
+//     deprecated; v1 ships flat doppler-off audio)
+//   - any per-source position update (handle.setPosition owns that)
+import { entityIndex } from '../entity.js';
+import { POOL_TRANSFORM } from '../world.js';
+import { RESOURCE_TIME, } from '../resources.js';
+import { RESOURCE_AUDIO_LISTENER, } from './audio-listener-resource.js';
+export class SpatialAudioSystem {
+    name = 'spatial-audio';
+    localCharacter = null;
+    spatialBus = null;
+    // Optional spatial bus reference. The system can also work without
+    // a bus (resource-only mode) - useful for tests and for consumers
+    // who do not want positional audio but still want a tracked listener
+    // pose (e.g. for visual SFX triggered relative to the player).
+    constructor(opts = {}) {
+        this.spatialBus = opts.spatialBus ?? null;
+    }
+    // Wire (or rewire) the spatial bus. Useful when the AudioBus is
+    // created lazily after first user gesture - the system can be
+    // registered upfront and the bus attached later.
+    setSpatialBus(bus) {
+        this.spatialBus = bus;
+    }
+    // Bind the local character entity. null means "no local character"
+    // (e.g. mid-teleport, character not yet allocated, headless mode).
+    // The system tolerates an entity that doesn't have a transform yet
+    // by silently skipping the update.
+    setLocalCharacterEntity(entity) {
+        this.localCharacter = entity;
+    }
+    getLocalCharacterEntity() {
+        return this.localCharacter;
+    }
+    update(world, _dt) {
+        if (this.localCharacter === null)
+            return;
+        var listener = world.resources.get(RESOURCE_AUDIO_LISTENER);
+        if (!listener)
+            return;
+        var transforms = world.getPool(POOL_TRANSFORM);
+        if (!transforms)
+            return;
+        var idx = entityIndex(this.localCharacter);
+        // Bounds check against the high-water mark so a fresh entity that
+        // the consumer registered before attaching a transform doesn't
+        // produce undefined reads on the typed arrays.
+        if (idx >= transforms.getHighWaterMark())
+            return;
+        var x = transforms.x[idx] ?? 0;
+        var y = transforms.y[idx] ?? 0;
+        var z = transforms.z[idx] ?? 0;
+        listener.pose.x = x;
+        listener.pose.y = y;
+        listener.pose.z = z;
+        var time = world.resources.get(RESOURCE_TIME);
+        listener.lastUpdateFrame = time ? time.frame : listener.lastUpdateFrame + 1;
+        if (this.spatialBus) {
+            this.spatialBus.setListener(listener.pose);
+        }
+    }
+}
+//# sourceMappingURL=spatial-audio-system.js.map

package/dist/audio/spatial-audio-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-audio-system.js","sourceRoot":"","sources":["../../src/audio/spatial-audio-system.ts"],"names":[],"mappings":"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"}

package/dist/audio/zone-audio-system.d.ts

@@ -0,0 +1,78 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+import type { ZoneEvent, ZoneEventType } from '../director/zone/zone-event-envelope.js';
+export interface PositionalPlayOptionsStub {
+    x?: number;
+    y?: number;
+    z?: number;
+    gain?: number;
+    rate?: number;
+    loop?: boolean;
+    refDistance?: number;
+    maxDistance?: number;
+    rolloffFactor?: number;
+    distanceModel?: 'linear' | 'inverse' | 'exponential';
+}
+export interface AudioListenerPoseStub {
+    x: number;
+    y: number;
+    z?: number;
+    forward?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    up?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+export interface AudioListenerResourceStub {
+    pose: AudioListenerPoseStub;
+    lastUpdateFrame: number;
+}
+export interface CueCatalogStub {
+    play(name: string, options?: PositionalPlayOptionsStub): unknown;
+}
+export interface MusicDirectorStub {
+    playMusic(name: string, fadeInMs?: number): void;
+    stopMusic(fadeOutMs?: number): Promise<void> | void;
+    crossfadeMusic(name: string, fadeMs?: number): void;
+    currentMusic(): string | null;
+}
+export declare const RESOURCE_AUDIO_LISTENER_STUB = "audio_listener";
+export declare const RESOURCE_CUE_CATALOG_STUB = "cue_catalog";
+export declare const RESOURCE_MUSIC_DIRECTOR_STUB = "music_director";
+export interface ZoneCuePlay {
+    cue: string;
+    options?: PositionalPlayOptionsStub;
+}
+export interface ZoneAudioContext {
+    cues: CueCatalogStub | null;
+    music: MusicDirectorStub | null;
+    localZone: string | null;
+    listener: AudioListenerPoseStub;
+}
+export interface ZoneAudioMapping {
+    eventType: ZoneEventType;
+    handle(event: ZoneEvent, ctx: ZoneAudioContext): ZoneCuePlay | null;
+}
+export interface ZoneAudioSystemOptions {
+    currentZone?: () => string | null;
+    verbose?: boolean;
+}
+export declare class ZoneAudioSystem implements System {
+    readonly name: string;
+    private readonly mappings;
+    private readonly currentZone;
+    private readonly verbose;
+    private readonly lastProcessedIdByZone;
+    constructor(opts?: ZoneAudioSystemOptions);
+    registerMapping(mapping: ZoneAudioMapping): void;
+    unregisterMapping(eventType: ZoneEventType): void;
+    hasMapping(eventType: ZoneEventType): boolean;
+    mappingCount(): number;
+    update(world: World, _dt: number): void;
+}
+//# sourceMappingURL=zone-audio-system.d.ts.map

package/dist/audio/zone-audio-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-audio-system.d.ts","sourceRoot":"","sources":["../../src/audio/zone-audio-system.ts"],"names":[],"mappings":"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"}

package/dist/audio/zone-audio-system.js

@@ -0,0 +1,206 @@
+// ZoneAudioSystem - zone-event audio integration shell (Phase 17, Track C).
+//
+// Runs PHASE_RENDER, AFTER ZoneEventSystem (which appends every
+// observed zone event to the per-zone ring buffer in
+// ZoneEventLog.byZone[<zone>].recent). Each tick the audio system
+// drains the local zone's ring buffer for events that landed THIS
+// frame (i.e. events with id strictly greater than the last id we
+// processed for that zone), looks up the consumer-registered mapping
+// for each event type, and dispatches the resulting cue play through
+// the registered CueCatalog / MusicDirector resources.
+//
+// This file ships ZERO mappings. Engine consumers (TheWorldTable.ai,
+// etc.) register their own mappings for the cues they want to fire on
+// each zone event type.
+//
+// Tolerances:
+//   - Missing mapping for an event type: log + skip silently. Most
+//     consumers will register only a subset of the seven zone event
+//     types.
+//   - Missing CueCatalog / MusicDirector resources: no-op gracefully.
+//     The system keeps draining events but cue plays evaporate. This
+//     lets a consumer wire ZoneAudioSystem before the catalog is built
+//     (e.g. while audio assets are still loading) without crashing.
+//   - Missing ZoneEventLog: no-op (nothing to drain).
+//   - Missing AudioListener resource: cue plays still dispatch but
+//     `listener` in the handler context falls back to a zero pose.
+//   - Multiple mappings for the SAME event type: registerMapping
+//     overwrites. unregisterMapping by eventType.
+//
+// Dispatch ORDER: registerMapping registration order is irrelevant
+// since each event type has at most ONE handler. The order in which
+// events are processed within a tick is the order they appear in
+// ZoneEventLog.byZone[<zone>].recent (newest first, per Phase 16
+// log semantics). Per spec we replay newest-first so a consumer that
+// registers a music crossfade reacts to the latest knot pulse before
+// older ones; the zone-events log is a deduped ring, so duplicates
+// are not a concern.
+import { RESOURCE_ZONE_EVENT_LOG, } from '../director/zone/zone-event-log.js';
+// Resource keys (defined here as duplicate string constants to keep
+// the system standalone). The values MATCH the ones declared in the
+// Track A / Track B files; coordination merge will swap to a single
+// import after 0.15.0 assembles.
+// TODO[phase-17-merge]: replace these constants with re-imports from
+// audio-listener-resource.ts / cue-catalog.ts / music-director.ts.
+export const RESOURCE_AUDIO_LISTENER_STUB = 'audio_listener';
+export const RESOURCE_CUE_CATALOG_STUB = 'cue_catalog';
+export const RESOURCE_MUSIC_DIRECTOR_STUB = 'music_director';
+// ---- The system ----
+export class ZoneAudioSystem {
+    name = 'zone-audio';
+    mappings;
+    currentZone;
+    verbose;
+    // Per-zone last processed event id. Drives the "events landed this
+    // frame" filter so the system reads the per-zone ring buffer once
+    // per tick and fires only fresh events.
+    lastProcessedIdByZone;
+    constructor(opts = {}) {
+        this.mappings = new Map();
+        this.currentZone = opts.currentZone ?? null;
+        this.verbose = opts.verbose ?? false;
+        this.lastProcessedIdByZone = new Map();
+    }
+    registerMapping(mapping) {
+        if (!mapping || typeof mapping.eventType !== 'string'
+            || typeof mapping.handle !== 'function') {
+            return;
+        }
+        this.mappings.set(mapping.eventType, mapping);
+    }
+    unregisterMapping(eventType) {
+        this.mappings.delete(eventType);
+    }
+    // For tests + introspection.
+    hasMapping(eventType) {
+        return this.mappings.has(eventType);
+    }
+    mappingCount() {
+        return this.mappings.size;
+    }
+    update(world, _dt) {
+        const log = world.resources.get(RESOURCE_ZONE_EVENT_LOG);
+        if (!log)
+            return;
+        const cues = world.resources.get(RESOURCE_CUE_CATALOG_STUB) ?? null;
+        const music = world.resources.get(RESOURCE_MUSIC_DIRECTOR_STUB) ?? null;
+        const listenerRes = world.resources.get(RESOURCE_AUDIO_LISTENER_STUB);
+        const listener = listenerRes
+            ? listenerRes.pose
+            : { x: 0, y: 0, z: 0 };
+        const localZone = safeCurrentZone(this.currentZone);
+        // Decide which zones to drain. With a local-zone filter set, we
+        // drain ONLY that zone; without it, we drain every zone present
+        // in the log (single-zone consumers + tests).
+        const zonesToDrain = [];
+        if (localZone !== null) {
+            if (log.byZone.has(localZone))
+                zonesToDrain.push(localZone);
+        }
+        else {
+            for (const z of log.byZone.keys())
+                zonesToDrain.push(z);
+        }
+        for (let zi = 0; zi < zonesToDrain.length; zi++) {
+            const zone = zonesToDrain[zi];
+            const entry = log.byZone.get(zone);
+            if (!entry)
+                continue;
+            // recent[] is newest-first per Phase 16 ZoneEventLog convention.
+            // We walk from oldest -> newest among UNSEEN events so handlers
+            // see events in chronological order (e.g. boss.spawn before
+            // boss.tick). Determine the cutoff by lastProcessedId for this
+            // zone.
+            const lastId = this.lastProcessedIdByZone.get(zone) ?? 0;
+            let maxIdSeen = lastId;
+            // Walk newest->oldest, collect unseen, then reverse so dispatch
+            // is oldest->newest.
+            const fresh = [];
+            for (let i = 0; i < entry.recent.length; i++) {
+                const ev = entry.recent[i];
+                if (!ev)
+                    continue;
+                if (ev.id > lastId) {
+                    fresh.push(ev);
+                    if (ev.id > maxIdSeen)
+                        maxIdSeen = ev.id;
+                }
+                else {
+                    // Past the boundary; older events have already been
+                    // processed.
+                    break;
+                }
+            }
+            if (fresh.length === 0)
+                continue;
+            // Reverse to oldest-first.
+            for (let i = fresh.length - 1; i >= 0; i--) {
+                const ev = fresh[i];
+                const mapping = this.mappings.get(ev.type);
+                if (!mapping) {
+                    if (this.verbose) {
+                        try {
+                            console.log('[zone-audio] no mapping for ' + ev.type + ' (zone='
+                                + ev.zone_id + ', id=' + ev.id + ')');
+                        }
+                        catch { /* ignore */ }
+                    }
+                    continue;
+                }
+                const ctx = {
+                    cues,
+                    music,
+                    localZone,
+                    listener,
+                };
+                let result = null;
+                try {
+                    result = mapping.handle(ev, ctx);
+                }
+                catch (err) {
+                    if (this.verbose) {
+                        try {
+                            console.warn('[zone-audio] mapping handle threw', err);
+                        }
+                        catch { /* ignore */ }
+                    }
+                    result = null;
+                }
+                if (!result)
+                    continue;
+                if (typeof result.cue !== 'string' || result.cue.length === 0)
+                    continue;
+                if (!cues) {
+                    // Catalog absent: silently drop the cue. The handler
+                    // already ran (e.g. it called ctx.music.crossfadeMusic) so
+                    // music side-effects still happen.
+                    continue;
+                }
+                try {
+                    cues.play(result.cue, result.options);
+                }
+                catch (err) {
+                    if (this.verbose) {
+                        try {
+                            console.warn('[zone-audio] cues.play threw', err);
+                        }
+                        catch { /* ignore */ }
+                    }
+                }
+            }
+            this.lastProcessedIdByZone.set(zone, maxIdSeen);
+        }
+    }
+}
+function safeCurrentZone(fn) {
+    if (!fn)
+        return null;
+    try {
+        const z = fn();
+        return typeof z === 'string' && z.length > 0 ? z : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=zone-audio-system.js.map

package/dist/audio/zone-audio-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-audio-system.js","sourceRoot":"","sources":["../../src/audio/zone-audio-system.ts"],"names":[],"mappings":"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"}

package/dist/director/zone/zone-boss-entity-system.d.ts

@@ -0,0 +1,9 @@
+import type { System } from '../../system.js';
+import type { World } from '../../world.js';
+export declare class ZoneBossEntitySystem implements System {
+    readonly name: string;
+    private readonly cursors;
+    update(world: World, _dt: number): void;
+    cursorFor(zoneId: string): number;
+}
+//# sourceMappingURL=zone-boss-entity-system.d.ts.map

package/dist/director/zone/zone-boss-entity-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-boss-entity-system.d.ts","sourceRoot":"","sources":["../../../src/director/zone/zone-boss-entity-system.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAgB5C,qBAAa,oBAAqB,YAAW,MAAM;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAsB;IAI3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAkCvC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGlC"}

package/dist/director/zone/zone-boss-entity-system.js

@@ -0,0 +1,114 @@
+// ZoneBossEntitySystem - converts zone events into a typed
+// ZoneBossEntityResource that any renderer (Three.js, Canvas2D, etc.)
+// can poll each frame without parsing SSE protocol envelopes
+// (LOOM-BOSS-RENDER-SPEC §3.2).
+//
+// Runs in PHASE_LOGIC, AFTER ZoneEventSystem (which runs in PHASE_INPUT
+// and is the source of truth on event ordering + ZoneEventLog state).
+// This system is a downstream projection of ZoneEventLog into a
+// renderer-friendly entity shape.
+//
+// Cursor strategy: per-zone lastProcessedEventId. Each tick we scan
+// ZoneEventLog.byZone[zid].recent (newest-first ring) and process any
+// events with id > cursor, then advance the cursor. The ring caps at
+// ZONE_RING_SIZE = 32 entries; if more than 32 events landed for one
+// zone in a single frame, some are lost. Acceptable in practice
+// (60 Hz tick vs server bursts of <32/frame) since zone.boss.end +
+// zone.snapshot are P0 priority and will not be dropped by the bridge.
+//
+// Dispatch table:
+//
+//   zone.boss.spawn  -> entities.byZone[zid] = buildEntityFromSpawn(env)
+//   zone.boss.tick   -> if boss_id matches current, applyTick; else ignore
+//   zone.boss.end    -> if boss_id matches current, clear to null
+//   zone.snapshot    -> replace wholesale (entity if active_boss non-null,
+//                       null otherwise)
+//   other            -> no-op
+//
+// v1 supports at most one active boss per zone (matches Phase 16 spec).
+import { RESOURCE_ZONE_EVENT_LOG, } from './zone-event-log.js';
+import { RESOURCE_ZONE_BOSS_ENTITY, buildEntityFromSpawn, applyTick, } from './zone-boss-entity.js';
+export class ZoneBossEntitySystem {
+    name = 'zone-boss-entity';
+    // Per-zone last-processed event id. Events with id > cursor are new
+    // since the previous frame.
+    cursors = new Map();
+    update(world, _dt) {
+        const log = world.resources.get(RESOURCE_ZONE_EVENT_LOG);
+        const entities = world.resources.get(RESOURCE_ZONE_BOSS_ENTITY);
+        if (!log || !entities)
+            return;
+        for (const [zoneId, entry] of log.byZone) {
+            const cursor = this.cursors.get(zoneId) ?? 0;
+            // Walk the newest-first ring. Collect events with id > cursor,
+            // then reverse to apply oldest-first.
+            const fresh = [];
+            for (let i = 0; i < entry.recent.length; i++) {
+                const ev = entry.recent[i];
+                if (!ev)
+                    continue;
+                if (ev.id <= cursor)
+                    break;
+                fresh.push(ev);
+            }
+            if (fresh.length === 0)
+                continue;
+            fresh.reverse();
+            let highestId = cursor;
+            for (let i = 0; i < fresh.length; i++) {
+                const ev = fresh[i];
+                if (!ev)
+                    continue;
+                if (ev.id > highestId)
+                    highestId = ev.id;
+                applyEventToEntity(ev, zoneId, entities);
+            }
+            this.cursors.set(zoneId, highestId);
+        }
+    }
+    // Diagnostic accessor for tests + debug HUDs.
+    cursorFor(zoneId) {
+        return this.cursors.get(zoneId) ?? 0;
+    }
+}
+function applyEventToEntity(ev, zoneId, entities) {
+    switch (ev.type) {
+        case 'zone.boss.spawn': {
+            entities.byZone.set(zoneId, buildEntityFromSpawn(ev));
+            break;
+        }
+        case 'zone.boss.tick': {
+            const e = ev;
+            const current = entities.byZone.get(zoneId);
+            if (!current)
+                return;
+            if (current.boss_id !== e.data.boss_id)
+                return;
+            applyTick(current, ev);
+            break;
+        }
+        case 'zone.boss.end': {
+            const e = ev;
+            const current = entities.byZone.get(zoneId);
+            if (current && current.boss_id === e.data.boss_id) {
+                entities.byZone.set(zoneId, null);
+            }
+            break;
+        }
+        case 'zone.snapshot': {
+            const e = ev;
+            if (e.data.active_boss) {
+                entities.byZone.set(zoneId, buildEntityFromSpawn(ev));
+            }
+            else {
+                entities.byZone.set(zoneId, null);
+            }
+            break;
+        }
+        default:
+            // Other event types (zone.narrator, zone.knot, zone.state) do
+            // not affect the boss entity. Pure no-op.
+            break;
+    }
+}
+//# sourceMappingURL=zone-boss-entity-system.js.map

package/dist/director/zone/zone-boss-entity-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-boss-entity-system.js","sourceRoot":"","sources":["../../../src/director/zone/zone-boss-entity-system.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,sEAAsE;AACtE,6DAA6D;AAC7D,gCAAgC;AAChC,EAAE;AACF,wEAAwE;AACxE,sEAAsE;AACtE,gEAAgE;AAChE,kCAAkC;AAClC,EAAE;AACF,oEAAoE;AACpE,sEAAsE;AACtE,qEAAqE;AACrE,qEAAqE;AACrE,gEAAgE;AAChE,mEAAmE;AACnE,uEAAuE;AACvE,EAAE;AACF,kBAAkB;AAClB,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,kEAAkE;AAClE,2EAA2E;AAC3E,wCAAwC;AACxC,8BAA8B;AAC9B,EAAE;AACF,wEAAwE;AAIxE,OAAO,EAEL,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAEL,yBAAyB,EACzB,oBAAoB,EACpB,SAAS,GACV,MAAM,uBAAuB,CAAC;AAE/B,MAAM,OAAO,oBAAoB;IACtB,IAAI,GAAW,kBAAkB,CAAC;IAE3C,oEAAoE;IACpE,4BAA4B;IACX,OAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;IAE1D,MAAM,CAAC,KAAY,EAAE,GAAW;QAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAe,uBAAuB,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAClC,yBAAyB,CAC1B,CAAC;QACF,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE9B,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE7C,+DAA+D;YAC/D,sCAAsC;YACtC,MAAM,KAAK,GAAgB,EAAE,CAAC;YAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7C,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC3B,IAAI,CAAC,EAAE;oBAAE,SAAS;gBAClB,IAAI,EAAE,CAAC,EAAE,IAAI,MAAM;oBAAE,MAAM;gBAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACjC,KAAK,CAAC,OAAO,EAAE,CAAC;YAEhB,IAAI,SAAS,GAAG,MAAM,CAAC;YACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACpB,IAAI,CAAC,EAAE;oBAAE,SAAS;gBAClB,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS;oBAAE,SAAS,GAAG,EAAE,CAAC,EAAE,CAAC;gBACzC,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC3C,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,SAAS,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF;AAED,SAAS,kBAAkB,CACzB,EAAa,EACb,MAAc,EACd,QAAgC;IAEhC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC;YACtD,MAAM;QACR,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,CAAC,GAAG,EAAyC,CAAC;YACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAC/C,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACvB,MAAM;QACR,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,CAAC,GAAG,EAAwC,CAAC;YACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACpC,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,CAAC,GAAG,EAAwC,CAAC;YACnD,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACvB,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACpC,CAAC;YACD,MAAM;QACR,CAAC;QACD;YACE,8DAA8D;YAC9D,0CAA0C;YAC1C,MAAM;IACV,CAAC;AACH,CAAC"}

package/dist/director/zone/zone-boss-entity.d.ts

@@ -0,0 +1,30 @@
+import type { ZoneEvent } from './zone-event-envelope.js';
+export interface ZoneBossHitRecord {
+    amount: number;
+    at_ms: number;
+    from_character_id: string;
+}
+export interface ZoneBossEntity {
+    zone_id: string;
+    boss_id: string;
+    name: string;
+    type: string;
+    hp_max: number;
+    hp_current: number;
+    dmg: number;
+    x: number;
+    y: number;
+    knot_flavor: string;
+    spawned_at_ms: number;
+    last_tick_ms: number;
+    recent_hits: ZoneBossHitRecord[];
+}
+export interface ZoneBossEntityResource {
+    byZone: Map<string, ZoneBossEntity | null>;
+}
+export declare const RESOURCE_ZONE_BOSS_ENTITY = "zone_boss_entity";
+export declare const RECENT_HITS_RING_SIZE = 32;
+export declare function createZoneBossEntityResource(): ZoneBossEntityResource;
+export declare function buildEntityFromSpawn(env: ZoneEvent): ZoneBossEntity;
+export declare function applyTick(entity: ZoneBossEntity, env: ZoneEvent): void;
+//# sourceMappingURL=zone-boss-entity.d.ts.map

package/dist/director/zone/zone-boss-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-boss-entity.d.ts","sourceRoot":"","sources":["../../../src/director/zone/zone-boss-entity.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAEV,SAAS,EAEV,MAAM,0BAA0B,CAAC;AAIlC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IAGb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;IAGpB,aAAa,EAAE,MAAM,CAAC;IAItB,YAAY,EAAE,MAAM,CAAC;IAKrB,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IAGrC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC;CAC5C;AAED,eAAO,MAAM,yBAAyB,qBAAqB,CAAC;AAI5D,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAIxC,wBAAgB,4BAA4B,IAAI,sBAAsB,CAErE;AAcD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,GAAG,cAAc,CAcnE;AAyBD,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAyBtE"}