@sadhaka/loom-engine 0.10.0

package/dist/director/director-system.js

@@ -0,0 +1,179 @@
+// DirectorSystem - drains the IDirectorBridge each tick, applies
+// each event to the world's resources, and ticks the knot palette
+// crossfade.
+//
+// Runs in PHASE_INPUT, AFTER InputSystem and VeilBudgetSystem so:
+//   1. Input snapshot is fresh first
+//   2. Any prior frame's VeilBudget propagation has already applied
+//   3. THIS system overlays Director events on top, mutating
+//      VeilBudget + KnotContext + others as the events stream in
+//   4. VeilBudgetSystem next frame picks up the new budget and
+//      pushes it to AudioBus + ParticlePool
+//
+// Per spec invariants:
+//   - Section 5.1: renderer never decides palette logic. We just
+//     apply what the Director sends.
+//   - Section 6.5: renderer never computes VE tier. Just receives.
+//   - Section 4.2: gap detection is the bridge's job, not ours.
+//     This system trusts the bridge has already reordered / dropped.
+//
+// What this system does for each event type:
+//
+//   knot.context        -> KnotContextResource.beginFade(palette,
+//                          fade_ms, now)
+//   ve.budget.update    -> mutate VeilBudgetResource (ve fields, tier)
+//                          into engine-internal scalar (audioBudget,
+//                          particleBudget) per Section 6.2 tier table.
+//                          VeilBudgetSystem picks up next frame.
+//   encounter.spawn     -> log + push narrator-line to a new
+//                          NarratorEvent queue (consumer-defined; v1
+//                          just exposes the latest event)
+//   encounter.tick      -> log; v1 doesn't react to mid-fight ticks
+//   encounter.end       -> log + clear current encounter state
+//   encounter.loot      -> log + push loot data
+//   scene.transition    -> log + emit scene change marker
+//   narrator.line       -> push to narrator queue
+//   system.heartbeat    -> stats only; bridge already extracted drops
+//   system.replay.*     -> log only
+//   system.snapshot.*   -> log + bridge has already closed; consumer
+//                          must reconnect
+//
+// Lightweight-by-design: most events are just logged + appended to
+// a recent-events ring buffer that gameplay code can read. Heavy
+// state mutation (combat state machines, world graph, NPC dialog
+// queues) lives in higher-level systems that read from this resource.
+import { RESOURCE_DIRECTOR_BRIDGE, RESOURCE_KNOT_CONTEXT, } from './director-bridge.js';
+import { RESOURCE_VEIL_BUDGET, RESOURCE_TIME, } from '../resources.js';
+export const RESOURCE_DIRECTOR_LOG = 'director_log';
+const RING_SIZE = 32;
+export function createDirectorEventLog() {
+    return {
+        recent: [],
+        lastNarratorLine: null,
+        lastNarratorTtlMs: 0,
+        lastKnot: null,
+        activeEncounterId: null,
+        lastTier: 'green',
+        eventsApplied: 0,
+    };
+}
+// Section 6.2 tier-to-multiplier table. Renderer-internal scalars
+// that tune the engine subsystems each tick.
+//
+// particleBudget: max simultaneous particles (was 4096 default; we
+//                 multiply by tier scalar)
+// audioBudget:    [0, 1] passed to AudioBus.setAudioBudget (Section 6.2
+//                 amber drops ambient stages, red minimal)
+// shaderBudget:   passes through; downstream VFX gates on this when
+//                 Phase 6+ shader effects land
+//
+// These scalars are applied multiplicatively to the engine's standalone
+// defaults so demos / standalone runs (no Director) keep their generous
+// settings, while connected runs scale down under load.
+const TIER_SCALARS = {
+    green: { particle: 1.0, audio: 1.0, shader: 1.0 },
+    amber: { particle: 0.5, audio: 0.7, shader: 0.5 },
+    red: { particle: 0.05, audio: 0.4, shader: 0.0 },
+};
+const PARTICLE_BUDGET_BASE = 4096;
+const SHADER_BUDGET_BASE = 8;
+export class DirectorSystem {
+    name = 'director';
+    update(world, _dt) {
+        const bridge = world.resources.get(RESOURCE_DIRECTOR_BRIDGE);
+        const knotCtx = world.resources.get(RESOURCE_KNOT_CONTEXT);
+        const log = world.resources.get(RESOURCE_DIRECTOR_LOG);
+        const time = world.resources.get(RESOURCE_TIME);
+        if (!bridge || !knotCtx || !log)
+            return;
+        const nowMs = (time ? time.elapsed * 1000 : 0) + (typeof performance !== 'undefined' ? performance.now() : 0);
+        // 1. Drain queued events.
+        const events = bridge.pollEvents();
+        if (events.length > 0) {
+            const budget = world.resources.get(RESOURCE_VEIL_BUDGET);
+            const frameNow = time ? time.frame : -1;
+            for (let i = 0; i < events.length; i++) {
+                const ev = events[i];
+                if (!ev)
+                    continue;
+                applyEvent(ev, knotCtx, log, budget ?? null, nowMs, frameNow);
+            }
+        }
+        // 2. Tick the palette crossfade (idempotent if no fade active).
+        knotCtx.tickFade(nowMs);
+    }
+}
+// applyEvent mutates KnotContextResource + DirectorEventLog +
+// optionally VeilBudgetResource. Pure: no I/O, no allocation beyond
+// the ring buffer push.
+function applyEvent(ev, knotCtx, log, budget, nowMs, frameNow) {
+    // Append to ring buffer (newest first).
+    log.recent.unshift(ev);
+    if (log.recent.length > RING_SIZE) {
+        log.recent.length = RING_SIZE;
+    }
+    log.eventsApplied++;
+    switch (ev.type) {
+        case 'knot.context': {
+            const d = ev.data;
+            knotCtx.knot = d.knot;
+            knotCtx.mood = d.mood;
+            knotCtx.beginFade(d.palette, d.fade_ms, nowMs);
+            log.lastKnot = d.knot;
+            break;
+        }
+        case 've.budget.update': {
+            const d = ev.data;
+            log.lastTier = d.tier;
+            if (budget) {
+                const scalars = TIER_SCALARS[d.tier];
+                budget.particleBudget = Math.round(PARTICLE_BUDGET_BASE * scalars.particle);
+                budget.audioBudget = scalars.audio;
+                budget.shaderBudget = Math.round(SHADER_BUDGET_BASE * scalars.shader);
+                budget.eventBudget = d.encounter_budget_ve;
+                if (frameNow >= 0)
+                    budget.lastUpdatedFrame = frameNow;
+            }
+            break;
+        }
+        case 'encounter.spawn': {
+            log.activeEncounterId = ev.data.encounter_id;
+            if (ev.data.narrator_line) {
+                log.lastNarratorLine = ev.data.narrator_line;
+                log.lastNarratorTtlMs = 0;
+            }
+            break;
+        }
+        case 'encounter.tick': {
+            if (ev.data.narrator_line) {
+                log.lastNarratorLine = ev.data.narrator_line;
+                log.lastNarratorTtlMs = 0;
+            }
+            break;
+        }
+        case 'encounter.end': {
+            log.activeEncounterId = null;
+            break;
+        }
+        case 'encounter.loot': {
+            if (ev.data.narrator_line) {
+                log.lastNarratorLine = ev.data.narrator_line;
+                log.lastNarratorTtlMs = 0;
+            }
+            break;
+        }
+        case 'narrator.line': {
+            log.lastNarratorLine = ev.data.line;
+            log.lastNarratorTtlMs = ev.data.ttl_ms;
+            break;
+        }
+        case 'scene.transition':
+        case 'system.heartbeat':
+        case 'system.replay.complete':
+        case 'system.snapshot.required':
+            // Logged only via the ring buffer above. Specialized systems
+            // (scene loader, telemetry) read from log.recent.
+            break;
+    }
+}
+//# sourceMappingURL=director-system.js.map

package/dist/director/director-system.js.map

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

package/dist/director/event-envelope.d.ts

@@ -0,0 +1,144 @@
+export interface EventEnvelope<T extends DirectorEventType = DirectorEventType> {
+    id: number;
+    ts: number;
+    type: T;
+    character_id: string;
+    encounter_id: string | null;
+    priority?: EventPriority;
+    data: DirectorEventDataMap[T];
+}
+export interface MobSpec {
+    type: string;
+    name: string;
+    hp: number;
+    dmg: number;
+    count: number;
+    position_hint: {
+        x: number;
+        y: number;
+    };
+    knot_flavor: string;
+}
+export interface BossSpec {
+    type: string;
+    name: string;
+    hp: number;
+    dmg: number;
+    position_hint: {
+        x: number;
+        y: number;
+    };
+    knot_flavor: string;
+}
+export interface DropSpec {
+    item_id: string;
+    name: string;
+    slot: string;
+    knot_affinity: string;
+    stats: Record<string, number>;
+}
+export interface EncounterSpawnData {
+    encounter_id: string;
+    zone_id: string;
+    level: number;
+    knot: string;
+    mobs: ReadonlyArray<MobSpec>;
+    boss: BossSpec | null;
+    narrator_line: string | null;
+    difficulty_score: number;
+}
+export interface EncounterTickData {
+    encounter_id: string;
+    elapsed_ms: number;
+    difficulty_delta: number;
+    narrator_line: string | null;
+    vfx_prompt: string | null;
+}
+export interface EncounterEndData {
+    encounter_id: string;
+    outcome: 'victory' | 'death' | 'flee';
+    duration_ms: number;
+    mob_killed: ReadonlyArray<string>;
+    next_step: 'loot' | 'respawn' | 'transition' | 'idle';
+}
+export interface EncounterLootData {
+    encounter_id: string;
+    drops: ReadonlyArray<DropSpec>;
+    ve_bonus: number;
+    narrator_line: string | null;
+}
+export interface KnotPaletteHex {
+    primary: string;
+    secondary: string;
+    accent: string;
+}
+export type KnotMood = 'calm' | 'tense' | 'climactic';
+export interface KnotContextData {
+    knot: string;
+    palette: KnotPaletteHex;
+    mood: KnotMood;
+    fade_ms: number;
+}
+export type VeilTier = 'green' | 'amber' | 'red';
+export interface VeBudgetUpdateData {
+    ve_remaining_month: number;
+    ve_ceiling_month: number;
+    tier: VeilTier;
+    tier_prev: VeilTier;
+    encounter_budget_ve: number;
+    encounter_budget_usd: number;
+}
+export type SceneTransitionKind = 'walk' | 'portal' | 'cinematic' | 'instant';
+export interface SceneTransitionData {
+    from_zone: string;
+    to_zone: string;
+    transition_kind: SceneTransitionKind;
+    duration_ms: number;
+}
+export type NarratorVoice = 'ambient' | 'urgent' | 'whisper';
+export interface NarratorLineData {
+    line: string;
+    voice: NarratorVoice;
+    ttl_ms: number;
+}
+export interface SystemHeartbeatData {
+    tail_id: number;
+    drops_p2: number;
+    drops_p1: number;
+}
+export interface SystemReplayCompleteData {
+    from_id: number;
+    to_id: number;
+    events_sent: number;
+}
+export interface SystemSnapshotRequiredData {
+    last_known_id: number;
+    current_tail_id: number;
+    retention_window: number;
+}
+export type DirectorEventType = 'encounter.spawn' | 'encounter.tick' | 'encounter.end' | 'encounter.loot' | 'knot.context' | 've.budget.update' | 'scene.transition' | 'narrator.line' | 'system.heartbeat' | 'system.replay.complete' | 'system.snapshot.required';
+export interface DirectorEventDataMap {
+    'encounter.spawn': EncounterSpawnData;
+    'encounter.tick': EncounterTickData;
+    'encounter.end': EncounterEndData;
+    'encounter.loot': EncounterLootData;
+    'knot.context': KnotContextData;
+    've.budget.update': VeBudgetUpdateData;
+    'scene.transition': SceneTransitionData;
+    'narrator.line': NarratorLineData;
+    'system.heartbeat': SystemHeartbeatData;
+    'system.replay.complete': SystemReplayCompleteData;
+    'system.snapshot.required': SystemSnapshotRequiredData;
+}
+export type DirectorEvent = {
+    [K in DirectorEventType]: EventEnvelope<K>;
+}[DirectorEventType];
+export type EventPriority = 'P0' | 'P1' | 'P2';
+export declare function priorityFor(type: DirectorEventType): EventPriority;
+export declare class EventEnvelopeParseError extends Error {
+    readonly raw: unknown;
+    constructor(message: string, raw: unknown);
+}
+export declare function parseEnvelope(raw: unknown): DirectorEvent;
+export declare function parseEnvelopeJson(json: string): DirectorEvent | null;
+//# sourceMappingURL=event-envelope.d.ts.map

package/dist/director/event-envelope.d.ts.map

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

package/dist/director/event-envelope.js

@@ -0,0 +1,108 @@
+// Director event envelope + typed event payloads.
+//
+// Per LOOM-DIRECTOR-PROTOCOL.md Section 3: every event shares an
+// envelope of {id, ts, type, character_id, encounter_id, data} where
+// `data` is type-specific. This file defines all 11 event types and
+// the discriminated-union DirectorEvent that callers parse against.
+//
+// Spec invariants preserved:
+//   - id is monotonic positive integer per (user, character)
+//   - encounter_id is null for non-encounter-scoped events
+//   - all hex palette values in knot.context come straight from
+//     LOOM-CLASS-SYSTEM-SPEC Section 4 (Director sources them at
+//     emit time; renderer trusts and applies)
+//   - mood is one of 'calm' | 'tense' | 'climactic'
+//   - tier is one of 'green' | 'amber' | 'red'
+const PRIORITY_BY_TYPE = {
+    'encounter.spawn': 'P0',
+    'encounter.end': 'P0',
+    'encounter.loot': 'P0',
+    'system.replay.complete': 'P0',
+    'system.snapshot.required': 'P0',
+    'knot.context': 'P1',
+    'scene.transition': 'P1',
+    'narrator.line': 'P1',
+    've.budget.update': 'P1',
+    'encounter.tick': 'P2',
+    'system.heartbeat': 'P2',
+};
+export function priorityFor(type) {
+    return PRIORITY_BY_TYPE[type];
+}
+// ----- Parsers -----
+export class EventEnvelopeParseError extends Error {
+    raw;
+    constructor(message, raw) {
+        super('EventEnvelopeParseError: ' + message);
+        this.raw = raw;
+        this.name = 'EventEnvelopeParseError';
+    }
+}
+const KNOWN_EVENT_TYPES = new Set([
+    'encounter.spawn',
+    'encounter.tick',
+    'encounter.end',
+    'encounter.loot',
+    'knot.context',
+    've.budget.update',
+    'scene.transition',
+    'narrator.line',
+    'system.heartbeat',
+    'system.replay.complete',
+    'system.snapshot.required',
+]);
+// Validate the envelope shape only - data payload validation is the
+// caller's responsibility (downstream type narrowing on `event.type`
+// gives full payload typing). Throws on shape errors so the bridge
+// can decide to drop / log / reconnect.
+export function parseEnvelope(raw) {
+    if (!raw || typeof raw !== 'object') {
+        throw new EventEnvelopeParseError('envelope is not an object', raw);
+    }
+    const e = raw;
+    if (typeof e['id'] !== 'number' || e['id'] < 0 || !Number.isFinite(e['id'])) {
+        throw new EventEnvelopeParseError('id must be a non-negative number', raw);
+    }
+    if (typeof e['ts'] !== 'number') {
+        throw new EventEnvelopeParseError('ts must be a number', raw);
+    }
+    if (typeof e['type'] !== 'string' || !KNOWN_EVENT_TYPES.has(e['type'])) {
+        throw new EventEnvelopeParseError('unknown event type: ' + String(e['type']), raw);
+    }
+    if (typeof e['character_id'] !== 'string') {
+        throw new EventEnvelopeParseError('character_id must be a string', raw);
+    }
+    if (e['encounter_id'] !== null && typeof e['encounter_id'] !== 'string') {
+        throw new EventEnvelopeParseError('encounter_id must be string or null', raw);
+    }
+    // Priority field is optional (Phase 6.4 backend addition; pre-6.4
+    // events on disk lack it). When present, must be a known class.
+    if (e['priority'] !== undefined) {
+        if (e['priority'] !== 'P0' && e['priority'] !== 'P1' && e['priority'] !== 'P2') {
+            throw new EventEnvelopeParseError('priority must be P0 / P1 / P2 when present, got: ' + String(e['priority']), raw);
+        }
+    }
+    if (!e['data'] || typeof e['data'] !== 'object') {
+        throw new EventEnvelopeParseError('data must be an object', raw);
+    }
+    return e;
+}
+// Convenience: parse a string (typically an SSE 'data:' line) into
+// an envelope. Returns null on JSON parse error so the caller can
+// decide whether to log or re-throw.
+export function parseEnvelopeJson(json) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        return null;
+    }
+    try {
+        return parseEnvelope(parsed);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=event-envelope.js.map

package/dist/director/event-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-envelope.js","sourceRoot":"","sources":["../../src/director/event-envelope.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,iEAAiE;AACjE,qEAAqE;AACrE,oEAAoE;AACpE,oEAAoE;AACpE,EAAE;AACF,6BAA6B;AAC7B,6DAA6D;AAC7D,2DAA2D;AAC3D,gEAAgE;AAChE,iEAAiE;AACjE,8CAA8C;AAC9C,oDAAoD;AACpD,+CAA+C;AAqL/C,MAAM,gBAAgB,GAA6C;IACjE,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,wBAAwB,EAAE,IAAI;IAC9B,0BAA0B,EAAE,IAAI;IAChC,cAAc,EAAE,IAAI;IACpB,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,IAAI;IACrB,kBAAkB,EAAE,IAAI;IACxB,gBAAgB,EAAE,IAAI;IACtB,kBAAkB,EAAE,IAAI;CACzB,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,IAAuB;IACjD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,sBAAsB;AAEtB,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACH;IAA7C,YAAY,OAAe,EAAkB,GAAY;QACvD,KAAK,CAAC,2BAA2B,GAAG,OAAO,CAAC,CAAC;QADF,QAAG,GAAH,GAAG,CAAS;QAEvD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,iBAAiB,GAAmC,IAAI,GAAG,CAAC;IAChE,iBAAiB;IACjB,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,cAAc;IACd,kBAAkB;IAClB,kBAAkB;IAClB,eAAe;IACf,kBAAkB;IAClB,wBAAwB;IACxB,0BAA0B;CAC3B,CAAC,CAAC;AAEH,oEAAoE;AACpE,qEAAqE;AACrE,mEAAmE;AACnE,wCAAwC;AACxC,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,uBAAuB,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,uBAAuB,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,uBAAuB,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAsB,CAAC,EAAE,CAAC;QAC5F,MAAM,IAAI,uBAAuB,CAAC,sBAAsB,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,uBAAuB,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,CAAC,cAAc,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,QAAQ,EAAE,CAAC;QACxE,MAAM,IAAI,uBAAuB,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC;IAChF,CAAC;IACD,kEAAkE;IAClE,gEAAgE;IAChE,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;YAC/E,MAAM,IAAI,uBAAuB,CAC/B,mDAAmD,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,EAC3E,GAAG,CACJ,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,uBAAuB,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,CAA6B,CAAC;AACvC,CAAC;AAED,mEAAmE;AACnE,kEAAkE;AAClE,qCAAqC;AACrC,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/director/knot-context-resource.d.ts

@@ -0,0 +1,25 @@
+import type { ColorRGBA } from '../util/color.js';
+import type { KnotMood, KnotPaletteHex } from './event-envelope.js';
+export interface KnotPaletteRgba {
+    primary: ColorRGBA;
+    secondary: ColorRGBA;
+    accent: ColorRGBA;
+}
+export declare class KnotContextResource {
+    current: KnotPaletteRgba;
+    target: KnotPaletteRgba;
+    knot: string;
+    mood: KnotMood;
+    fadeStartMs: number;
+    fadeDurationMs: number;
+    fadeFromPalette: KnotPaletteRgba;
+    constructor();
+    beginFade(targetHex: KnotPaletteHex, fadeMs: number, nowMs: number): void;
+    tickFade(nowMs: number): void;
+    isFading(): boolean;
+    getBloomMultiplier(): number;
+    getShakeMultiplier(): number;
+    getMusicIntensity(): number;
+    hexSnapshot(): KnotPaletteHex;
+}
+//# sourceMappingURL=knot-context-resource.d.ts.map

package/dist/director/knot-context-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knot-context-resource.d.ts","sourceRoot":"","sources":["../../src/director/knot-context-resource.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;CACnB;AAUD,qBAAa,mBAAmB;IAG9B,OAAO,EAAE,eAAe,CAAC;IAGzB,MAAM,EAAE,eAAe,CAAC;IAGxB,IAAI,EAAE,MAAM,CAAS;IAGrB,IAAI,EAAE,QAAQ,CAAW;IAIzB,WAAW,EAAE,MAAM,CAAM;IACzB,cAAc,EAAE,MAAM,CAAK;IAG3B,eAAe,EAAE,eAAe,CAAC;;IAWjC,SAAS,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAUzE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAU7B,QAAQ,IAAI,OAAO;IAKnB,kBAAkB,IAAI,MAAM;IAI5B,kBAAkB,IAAI,MAAM;IAI5B,iBAAiB,IAAI,MAAM;IAK3B,WAAW,IAAI,cAAc;CAO9B"}

package/dist/director/knot-context-resource.js

@@ -0,0 +1,152 @@
+// KnotContextResource - the renderer's current palette + mood state.
+//
+// Per LOOM-DIRECTOR-PROTOCOL.md Section 5: Director picks the active
+// knot, the renderer applies the palette it is told to apply. This
+// resource holds:
+//   - current palette + mood (what's rendered right now)
+//   - target palette + mood (what we're crossfading toward)
+//   - fade timing for the active transition
+//
+// DirectorSystem mutates `target` and `fadeStartMs` on knot.context
+// events. A small per-tick interpolation (also inside DirectorSystem)
+// advances `current` toward `target` over fade_ms. A fade_ms of 0 is
+// rendered as a 1-frame fade so animation systems do not skip a beat
+// (Section 5.3).
+//
+// Mood multipliers (Section 5.4) are exposed as derived getters on
+// the resource. Render systems read them when computing bloom + shake
+// + music intensity.
+import { hexToRgba, rgbaToHexString } from '../util/color.js';
+// Default palette - Strknot per LOOM-CLASS-SYSTEM-SPEC Section 4.
+// Used until the first knot.context event lands.
+const DEFAULT_PALETTE_HEX = {
+    primary: '#b04a24',
+    secondary: '#5ac9d6',
+    accent: '#ffd86a',
+};
+export class KnotContextResource {
+    // Active palette currently in use by render systems. Interpolates
+    // toward `target` over the fade window.
+    current;
+    // Target palette the active fade is moving toward. Equals `current`
+    // when no fade is active.
+    target;
+    // Currently displayed knot id (e.g. 'str', 'dex', 'int', 'center').
+    knot = 'str';
+    // Currently active mood. Updated immediately on knot.context (no
+    // mood crossfade in v1; mood is a hint, not a continuous param).
+    mood = 'tense';
+    // Crossfade timing (ms-based; uses performance.now() coordinates).
+    // -1 means no fade is in progress.
+    fadeStartMs = -1;
+    fadeDurationMs = 0;
+    // Snapshot of `current` at the moment the fade started, so each
+    // tick can interpolate from a stable origin.
+    fadeFromPalette;
+    constructor() {
+        this.current = paletteFromHex(DEFAULT_PALETTE_HEX);
+        this.target = paletteFromHex(DEFAULT_PALETTE_HEX);
+        this.fadeFromPalette = paletteFromHex(DEFAULT_PALETTE_HEX);
+    }
+    // Begin a crossfade to a new palette. Called by DirectorSystem on
+    // knot.context. fade_ms = 0 is treated as 16ms (one frame at 60fps)
+    // so animation systems always observe at least one frame of fade.
+    beginFade(targetHex, fadeMs, nowMs) {
+        this.fadeFromPalette = clonePalette(this.current);
+        this.target = paletteFromHex(targetHex);
+        this.fadeStartMs = nowMs;
+        this.fadeDurationMs = fadeMs <= 0 ? 16 : fadeMs;
+    }
+    // Per-tick interpolation. Call from DirectorSystem.update each tick
+    // with performance.now(). Updates `current` toward `target` based
+    // on elapsed fade time. Idempotent if no fade is active.
+    tickFade(nowMs) {
+        if (this.fadeStartMs < 0)
+            return;
+        const elapsed = nowMs - this.fadeStartMs;
+        const t = Math.min(1, Math.max(0, elapsed / this.fadeDurationMs));
+        interpolatePaletteInto(this.fadeFromPalette, this.target, t, this.current);
+        if (t >= 1) {
+            this.fadeStartMs = -1;
+        }
+    }
+    isFading() {
+        return this.fadeStartMs >= 0;
+    }
+    // Mood multipliers per Section 5.4.
+    getBloomMultiplier() {
+        return moodBloomMult(this.mood);
+    }
+    getShakeMultiplier() {
+        return moodShakeMult(this.mood);
+    }
+    getMusicIntensity() {
+        return moodMusicMult(this.mood);
+    }
+    // Snapshot in hex form. Useful for debug HUD / serialization.
+    hexSnapshot() {
+        return {
+            primary: rgbaToHexString(this.current.primary),
+            secondary: rgbaToHexString(this.current.secondary),
+            accent: rgbaToHexString(this.current.accent),
+        };
+    }
+}
+// ----- Helpers -----
+function paletteFromHex(p) {
+    return {
+        primary: hexToRgba(parseHex(p.primary)),
+        secondary: hexToRgba(parseHex(p.secondary)),
+        accent: hexToRgba(parseHex(p.accent)),
+    };
+}
+function clonePalette(p) {
+    return {
+        primary: { ...p.primary },
+        secondary: { ...p.secondary },
+        accent: { ...p.accent },
+    };
+}
+function interpolatePaletteInto(from, to, t, out) {
+    out.primary.r = from.primary.r + (to.primary.r - from.primary.r) * t;
+    out.primary.g = from.primary.g + (to.primary.g - from.primary.g) * t;
+    out.primary.b = from.primary.b + (to.primary.b - from.primary.b) * t;
+    out.primary.a = from.primary.a + (to.primary.a - from.primary.a) * t;
+    out.secondary.r = from.secondary.r + (to.secondary.r - from.secondary.r) * t;
+    out.secondary.g = from.secondary.g + (to.secondary.g - from.secondary.g) * t;
+    out.secondary.b = from.secondary.b + (to.secondary.b - from.secondary.b) * t;
+    out.secondary.a = from.secondary.a + (to.secondary.a - from.secondary.a) * t;
+    out.accent.r = from.accent.r + (to.accent.r - from.accent.r) * t;
+    out.accent.g = from.accent.g + (to.accent.g - from.accent.g) * t;
+    out.accent.b = from.accent.b + (to.accent.b - from.accent.b) * t;
+    out.accent.a = from.accent.a + (to.accent.a - from.accent.a) * t;
+}
+function parseHex(hex) {
+    if (!hex || typeof hex !== 'string')
+        return 0xffffff;
+    const trimmed = hex.startsWith('#') ? hex.slice(1) : hex;
+    const n = parseInt(trimmed, 16);
+    return Number.isFinite(n) ? n : 0xffffff;
+}
+function moodBloomMult(mood) {
+    if (mood === 'calm')
+        return 0.6;
+    if (mood === 'climactic')
+        return 1.4;
+    return 1.0; // tense or unknown
+}
+function moodShakeMult(mood) {
+    if (mood === 'calm')
+        return 0.5;
+    if (mood === 'climactic')
+        return 1.5;
+    return 1.0;
+}
+function moodMusicMult(mood) {
+    if (mood === 'calm')
+        return 0.5;
+    if (mood === 'climactic')
+        return 1.4;
+    return 1.0;
+}
+//# sourceMappingURL=knot-context-resource.js.map

package/dist/director/knot-context-resource.js.map

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