@sadhaka/loom-engine 0.10.0

package/dist/systems/input-system.js

@@ -0,0 +1,27 @@
+// InputSystem - bridges DOM input accumulator into a frame-coherent
+// resource. Runs as the FIRST registered system in PHASE_INPUT, so
+// every subsequent phase reads the same snapshot.
+//
+// The system does two things each tick:
+//   1. Calls inputManager.beginFrame() so per-frame transient state
+//      (pressed-this-frame / released-this-frame / wheel delta /
+//      touchesStarted / touchesEnded) snapshots from the accumulator
+//   2. Writes the resulting InputSnapshot into the world's resource
+//      registry under RESOURCE_INPUT
+//
+// Other systems (camera pan, click-to-spawn, etc.) read from
+// world.resources.get<InputSnapshot>(RESOURCE_INPUT). The snapshot is
+// replaced each tick so consumers should not hold a reference across
+// frames.
+import { RESOURCE_INPUT_MANAGER, RESOURCE_INPUT, } from '../input/input-manager.js';
+export class InputSystem {
+    name = 'input';
+    update(world, _dt) {
+        const manager = world.resources.get(RESOURCE_INPUT_MANAGER);
+        if (!manager)
+            return;
+        manager.beginFrame();
+        world.resources.set(RESOURCE_INPUT, manager.snapshot());
+    }
+}
+//# sourceMappingURL=input-system.js.map

package/dist/systems/input-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-system.js","sourceRoot":"","sources":["../../src/systems/input-system.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,mEAAmE;AACnE,kDAAkD;AAClD,EAAE;AACF,wCAAwC;AACxC,oEAAoE;AACpE,iEAAiE;AACjE,qEAAqE;AACrE,oEAAoE;AACpE,qCAAqC;AACrC,EAAE;AACF,6DAA6D;AAC7D,sEAAsE;AACtE,qEAAqE;AACrE,UAAU;AAIV,OAAO,EAEL,sBAAsB,EACtB,cAAc,GACf,MAAM,2BAA2B,CAAC;AAEnC,MAAM,OAAO,WAAW;IACb,IAAI,GAAW,OAAO,CAAC;IAEhC,MAAM,CAAC,KAAY,EAAE,GAAW;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAe,sBAAsB,CAAC,CAAC;QAC1E,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,OAAO,CAAC,UAAU,EAAE,CAAC;QACrB,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/systems/interaction-system.d.ts

@@ -0,0 +1,23 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+import { type InteractableKind } from '../components/interactable.js';
+import { type EntityId } from '../entity.js';
+export interface LastInteractionResource {
+    entityIndex: number;
+    atFrame: number;
+    kind: InteractableKind;
+    payload: string;
+    prompt: string;
+}
+export declare function createLastInteraction(): LastInteractionResource;
+export declare const RESOURCE_LAST_INTERACTION = "last_interaction";
+export interface InteractionSystemOptions {
+    player: EntityId;
+}
+export declare class InteractionSystem implements System {
+    private opts;
+    readonly name: string;
+    constructor(opts: InteractionSystemOptions);
+    update(world: World, _dt: number): void;
+}
+//# sourceMappingURL=interaction-system.d.ts.map

package/dist/systems/interaction-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-system.d.ts","sourceRoot":"","sources":["../../src/systems/interaction-system.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AASvC,OAAO,EAAE,KAAK,QAAQ,EAA2B,MAAM,cAAc,CAAC;AAItE,MAAM,WAAW,uBAAuB;IAGtC,WAAW,EAAE,MAAM,CAAC;IAGpB,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,qBAAqB,IAAI,uBAAuB,CAQ/D;AAED,eAAO,MAAM,yBAAyB,qBAAqB,CAAC;AAE5D,MAAM,WAAW,wBAAwB;IAGvC,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,qBAAa,iBAAkB,YAAW,MAAM;IAGlC,OAAO,CAAC,IAAI;IAFxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAiB;gBAElB,IAAI,EAAE,wBAAwB;IAElD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAgFxC"}

package/dist/systems/interaction-system.js

@@ -0,0 +1,120 @@
+// InteractionSystem - detects player interactions with Interactable
+// entities (NPCs, portals, lore stones).
+//
+// Two trigger paths:
+//   1. Click on or near an interactable entity (within its radius)
+//   2. Press 'KeyE' or 'Enter' while in range of any interactable
+//      (per CLAUDE.md hotkey lock list: E + Enter open NPC dialog)
+//
+// Output: writes the most recently triggered interaction to the
+// LastInteractionResource. Gameplay code reads this to show dialog,
+// trigger zone transitions, etc. Cleared after one tick of being
+// read so each interaction fires exactly once.
+import { POOL_TRANSFORM } from '../world.js';
+import { POOL_INTERACTABLE, INTERACTABLE_FLAG_ACTIVE, } from '../components/interactable.js';
+import { RESOURCE_INPUT, } from '../input/input-manager.js';
+import { RESOURCE_CAMERA } from '../resources.js';
+import { isoToTile } from '../renderer/iso-projection.js';
+import { vec2 } from '../util/math.js';
+import { makeEntity, entityIndex } from '../entity.js';
+const SCRATCH_TILE = vec2(0, 0);
+export function createLastInteraction() {
+    return {
+        entityIndex: -1,
+        atFrame: -1,
+        kind: 'npc',
+        payload: '',
+        prompt: '',
+    };
+}
+export const RESOURCE_LAST_INTERACTION = 'last_interaction';
+export class InteractionSystem {
+    opts;
+    name = 'interaction';
+    constructor(opts) {
+        this.opts = opts;
+    }
+    update(world, _dt) {
+        const input = world.resources.get(RESOURCE_INPUT);
+        if (!input)
+            return;
+        const camera = world.resources.get(RESOURCE_CAMERA);
+        const transforms = world.getPool(POOL_TRANSFORM);
+        const interactables = world.getPool(POOL_INTERACTABLE);
+        const last = world.resources.get(RESOURCE_LAST_INTERACTION);
+        if (!camera || !transforms || !interactables || !last)
+            return;
+        const playerIdx = entityIndex(this.opts.player);
+        const px = transforms.x[playerIdx] ?? 0;
+        const py = transforms.y[playerIdx] ?? 0;
+        // Trigger paths:
+        //   - Left click anywhere -> find interactable nearest the click
+        //     point that is within its own radius
+        //   - 'KeyE' or 'Enter' pressedThisFrame -> find nearest
+        //     interactable to the player that is within its own radius
+        const leftClicked = (input.pointerPressedThisFrame & 1) !== 0;
+        const eKey = input.keysPressedThisFrame.has('KeyE') || input.keysPressedThisFrame.has('Enter');
+        if (!leftClicked && !eKey)
+            return;
+        let probeX;
+        let probeY;
+        if (leftClicked) {
+            // Convert click pixel coords -> world iso -> tile.
+            const worldIsoX = (input.pointer.x - camera.viewportWidth / 2) / camera.zoom + camera.centerX;
+            const worldIsoY = (input.pointer.y - camera.viewportHeight / 2) / camera.zoom + camera.centerY;
+            isoToTile(worldIsoX, worldIsoY, SCRATCH_TILE);
+            probeX = SCRATCH_TILE.x;
+            probeY = SCRATCH_TILE.y;
+        }
+        else {
+            // E / Enter: probe at player's position.
+            probeX = px;
+            probeY = py;
+        }
+        // Find the nearest interactable whose radius contains the probe.
+        const hwm = interactables.getHighWaterMark();
+        let bestIdx = -1;
+        let bestDist = Infinity;
+        for (let i = 1; i < hwm; i++) {
+            if (i === playerIdx)
+                continue;
+            const f = interactables.flags[i] ?? 0;
+            if ((f & INTERACTABLE_FLAG_ACTIVE) === 0)
+                continue;
+            const tx = transforms.x[i] ?? 0;
+            const ty = transforms.y[i] ?? 0;
+            const dx = tx - probeX;
+            const dy = ty - probeY;
+            const dist = Math.sqrt(dx * dx + dy * dy);
+            const radius = interactables.radius[i] ?? 0;
+            if (dist > radius)
+                continue;
+            // For E/Enter: also require the player itself be within radius
+            // (so the player can't trigger an NPC across the map by pressing
+            // E while standing right next to a different one).
+            if (eKey) {
+                const playerDx = tx - px;
+                const playerDy = ty - py;
+                if (Math.sqrt(playerDx * playerDx + playerDy * playerDy) > radius)
+                    continue;
+            }
+            if (dist < bestDist) {
+                bestDist = dist;
+                bestIdx = i;
+            }
+        }
+        if (bestIdx < 0)
+            return;
+        last.entityIndex = bestIdx;
+        last.kind = interactables.kind[bestIdx] ?? 'npc';
+        last.payload = interactables.payload[bestIdx] ?? '';
+        last.prompt = interactables.prompt[bestIdx] ?? '';
+        // atFrame is read by the gameplay handler to detect "new" - we
+        // bump it to the entity index plus a tick salt so successive
+        // identical-target reads still register as new. Simpler: any
+        // monotonic increment works.
+        last.atFrame = (last.atFrame ?? 0) + 1;
+        void makeEntity; // imported but only used by callers via index
+    }
+}
+//# sourceMappingURL=interaction-system.js.map

package/dist/systems/interaction-system.js.map

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

package/dist/systems/particle-emitter-system.d.ts

@@ -0,0 +1,8 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+export declare const POOL_EMITTER = "emitter";
+export declare class ParticleEmitterSystem implements System {
+    readonly name: string;
+    update(world: World, dt: number): void;
+}
+//# sourceMappingURL=particle-emitter-system.d.ts.map

package/dist/systems/particle-emitter-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle-emitter-system.d.ts","sourceRoot":"","sources":["../../src/systems/particle-emitter-system.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAOzC,eAAO,MAAM,YAAY,YAAY,CAAC;AAkEtC,qBAAa,qBAAsB,YAAW,MAAM;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAsB;IAE3C,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CA0EvC"}

package/dist/systems/particle-emitter-system.js

@@ -0,0 +1,161 @@
+// ParticleEmitterSystem - reads ECS entities that have BOTH a
+// Transform AND a ParticleEmitter, computes how many particles to
+// spawn this tick (continuous rate + pending burst), and pushes
+// each spawn into the shared ParticlePool.
+//
+// Runs in PHASE_LOGIC. Simulation happens in PHASE_PHYSICS afterward,
+// so a particle spawned this tick gets its first physics step in the
+// same frame.
+//
+// Spawn math:
+//   - Continuous: emitter.rate * dt + emitter.spawnCarry, floor that
+//     for the count this tick, save the fractional part as new carry
+//   - Burst: emit min(burstRemaining, available-budget) all at once
+//   - Direction: sample a random direction inside the cone defined
+//     by (dirX, dirY, dirZ) and coneRadians half-angle
+//   - Speed: uniform random in [speedMin, speedMax]
+//
+// The pool's maxParticles cap is enforced inside ParticlePool.spawn;
+// when it returns -1 we stop emitting from this entity for this tick
+// and the missed spawns are NOT carried over (a budget under-fire is
+// a render-budget signal, not a debt).
+import { POOL_TRANSFORM } from '../world.js';
+import { EMITTER_FLAG_ACTIVE } from '../components/particle-emitter.js';
+import { POOL_PARTICLE } from './particle-simulation-system.js';
+export const POOL_EMITTER = 'emitter';
+// Sample a random unit direction inside a cone of half-angle
+// `coneHalf` around the axis (ax, ay, az). For coneHalf = 0 the
+// returned vector equals the axis. For coneHalf = PI it's a random
+// direction on the full sphere.
+//
+// Algorithm: pick a random angle phi in [0, coneHalf], a random
+// azimuth theta in [0, 2*PI], and rotate that into the axis-aligned
+// frame. We use a small-angle approximation that's exact for our
+// 2.5D usage (the axis is mostly axis-aligned in iso space).
+function sampleConeDirection(ax, ay, az, coneHalf, out) {
+    if (coneHalf <= 0) {
+        out.x = ax;
+        out.y = ay;
+        out.z = az;
+        return;
+    }
+    // Random angle from axis (cosine-weighted for uniform sphere
+    // coverage as cone widens).
+    const cosLimit = Math.cos(coneHalf);
+    const cosAngle = cosLimit + (1 - cosLimit) * Math.random();
+    const sinAngle = Math.sqrt(Math.max(0, 1 - cosAngle * cosAngle));
+    const azimuth = Math.random() * Math.PI * 2;
+    // Build a local frame around the axis.
+    const len = Math.sqrt(ax * ax + ay * ay + az * az) || 1;
+    const aux = ax / len;
+    const auy = ay / len;
+    const auz = az / len;
+    // Find a perpendicular to (aux, auy, auz). Use the smaller axis
+    // as the helper to avoid degenerate cross products.
+    let hx, hy, hz;
+    if (Math.abs(aux) < 0.9) {
+        hx = 1;
+        hy = 0;
+        hz = 0;
+    }
+    else {
+        hx = 0;
+        hy = 1;
+        hz = 0;
+    }
+    // First perpendicular = axis x helper
+    let p1x = auy * hz - auz * hy;
+    let p1y = auz * hx - aux * hz;
+    let p1z = aux * hy - auy * hx;
+    const p1Len = Math.sqrt(p1x * p1x + p1y * p1y + p1z * p1z) || 1;
+    p1x /= p1Len;
+    p1y /= p1Len;
+    p1z /= p1Len;
+    // Second perpendicular = axis x p1
+    const p2x = auy * p1z - auz * p1y;
+    const p2y = auz * p1x - aux * p1z;
+    const p2z = aux * p1y - auy * p1x;
+    const cosA = Math.cos(azimuth);
+    const sinA = Math.sin(azimuth);
+    // Combine: result = cosAngle*axis + sinAngle*(cosA*p1 + sinA*p2)
+    out.x = cosAngle * aux + sinAngle * (cosA * p1x + sinA * p2x);
+    out.y = cosAngle * auy + sinAngle * (cosA * p1y + sinA * p2y);
+    out.z = cosAngle * auz + sinAngle * (cosA * p1z + sinA * p2z);
+}
+const SCRATCH_DIR = { x: 0, y: 0, z: 0 };
+export class ParticleEmitterSystem {
+    name = 'particle-emitter';
+    update(world, dt) {
+        const transforms = world.getPool(POOL_TRANSFORM);
+        const emitters = world.getPool(POOL_EMITTER);
+        const particles = world.getPool(POOL_PARTICLE);
+        if (!transforms || !emitters || !particles)
+            return;
+        const hwm = Math.min(transforms.getHighWaterMark(), emitters.getHighWaterMark());
+        for (let i = 1; i < hwm; i++) { // index 0 is NULL_ENTITY
+            const flags = emitters.flags[i] ?? 0;
+            if ((flags & EMITTER_FLAG_ACTIVE) === 0)
+                continue;
+            const x = transforms.x[i] ?? 0;
+            const y = transforms.y[i] ?? 0;
+            const z = transforms.z[i] ?? 0;
+            // Total spawns this tick = continuous fractional accumulator
+            // + pending burst.
+            const carry = (emitters.spawnCarry[i] ?? 0) + (emitters.rate[i] ?? 0) * dt;
+            const continuousCount = Math.floor(carry);
+            emitters.spawnCarry[i] = carry - continuousCount;
+            const burstCount = emitters.burstRemaining[i] ?? 0;
+            const total = continuousCount + burstCount;
+            if (total === 0)
+                continue;
+            let spawnedFromBurst = 0;
+            const additive = (flags & 0x02) !== 0;
+            const dirX = emitters.dirX[i] ?? 0;
+            const dirY = emitters.dirY[i] ?? -1;
+            const dirZ = emitters.dirZ[i] ?? 0;
+            const coneHalf = emitters.coneRadians[i] ?? 0;
+            const speedMin = emitters.speedMin[i] ?? 0;
+            const speedMax = emitters.speedMax[i] ?? speedMin;
+            const ax = emitters.ax[i] ?? 0;
+            const ay = emitters.ay[i] ?? 0;
+            const az = emitters.az[i] ?? 0;
+            const life = emitters.particleLife[i] ?? 1;
+            const startSize = emitters.startSize[i] ?? 4;
+            const endSize = emitters.endSize[i] ?? startSize;
+            for (let k = 0; k < total; k++) {
+                sampleConeDirection(dirX, dirY, dirZ, coneHalf, SCRATCH_DIR);
+                const speed = speedMin + Math.random() * (speedMax - speedMin);
+                const slot = particles.spawn({
+                    x, y, z,
+                    vx: SCRATCH_DIR.x * speed,
+                    vy: SCRATCH_DIR.y * speed,
+                    vz: SCRATCH_DIR.z * speed,
+                    ax, ay, az,
+                    life,
+                    size: startSize,
+                    endSize,
+                    color: {
+                        r: emitters.startR[i] ?? 1,
+                        g: emitters.startG[i] ?? 1,
+                        b: emitters.startB[i] ?? 1,
+                        a: emitters.startA[i] ?? 1,
+                    },
+                    endColor: {
+                        r: emitters.endR[i] ?? 1,
+                        g: emitters.endG[i] ?? 1,
+                        b: emitters.endB[i] ?? 1,
+                        a: emitters.endA[i] ?? 0,
+                    },
+                    additive,
+                });
+                if (slot < 0)
+                    break; // budget hit
+                if (k < burstCount)
+                    spawnedFromBurst++;
+            }
+            // Reduce burstRemaining only by what we actually spawned.
+            emitters.burstRemaining[i] = burstCount - spawnedFromBurst;
+        }
+    }
+}
+//# sourceMappingURL=particle-emitter-system.js.map

package/dist/systems/particle-emitter-system.js.map

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

package/dist/systems/particle-render-system.d.ts

@@ -0,0 +1,7 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+export declare class ParticleRenderSystem implements System {
+    readonly name: string;
+    update(world: World, _dt: number): void;
+}
+//# sourceMappingURL=particle-render-system.d.ts.map

package/dist/systems/particle-render-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle-render-system.d.ts","sourceRoot":"","sources":["../../src/systems/particle-render-system.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAYzC,qBAAa,oBAAqB,YAAW,MAAM;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAqB;IAE1C,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAwCxC"}

package/dist/systems/particle-render-system.js

@@ -0,0 +1,53 @@
+// ParticleRenderSystem - iterates the ParticlePool and submits
+// drawParticle calls to the device.
+//
+// Runs in PHASE_RENDER. Registration order matters: this system
+// should be registered AFTER SpriteRenderSystem so particles draw
+// on top of sprites (typical "VFX above" layering). Caller can
+// reverse the order to put particles UNDER sprites for, say, ground-
+// level smoke trails.
+//
+// Particle draw order is insertion order; the pool's free-list
+// recycles slots so the order isn't strictly back-to-front. For
+// additive-blended particles this doesn't matter; for alpha-blended
+// the visual difference is rarely noticeable at typical particle
+// sizes. Phase 4 ships without sort to keep the hot loop tight;
+// Phase 5+ may add a sorted-render variant if profiling demands.
+import { PARTICLE_FLAG_ALIVE, PARTICLE_FLAG_ADDITIVE } from '../vfx/particle-pool.js';
+import { RESOURCE_DEVICE, RESOURCE_CAMERA, } from '../resources.js';
+import { POOL_PARTICLE } from './particle-simulation-system.js';
+const SCRATCH_COLOR = { r: 1, g: 1, b: 1, a: 1 };
+export class ParticleRenderSystem {
+    name = 'particle-render';
+    update(world, _dt) {
+        const pool = world.getPool(POOL_PARTICLE);
+        const device = world.resources.get(RESOURCE_DEVICE);
+        const camera = world.resources.get(RESOURCE_CAMERA);
+        if (!pool || !device || !camera)
+            return;
+        if (pool.getLiveCount() === 0)
+            return;
+        device.setCamera(camera);
+        const hwm = pool.getHighWaterMark();
+        for (let i = 0; i < hwm; i++) {
+            const f = pool.flags[i] ?? 0;
+            if ((f & PARTICLE_FLAG_ALIVE) === 0)
+                continue;
+            const life = pool.life[i] ?? 0;
+            const maxLife = pool.maxLife[i] ?? 1;
+            // t = 0 at spawn, t = 1 at death.
+            const t = maxLife > 0 ? 1 - life / maxLife : 1;
+            const r = (pool.r0[i] ?? 1) + ((pool.r1[i] ?? 1) - (pool.r0[i] ?? 1)) * t;
+            const g = (pool.g0[i] ?? 1) + ((pool.g1[i] ?? 1) - (pool.g0[i] ?? 1)) * t;
+            const b = (pool.b0[i] ?? 1) + ((pool.b1[i] ?? 1) - (pool.b0[i] ?? 1)) * t;
+            const a = (pool.a0[i] ?? 1) + ((pool.a1[i] ?? 0) - (pool.a0[i] ?? 1)) * t;
+            const size = (pool.size[i] ?? 4) + ((pool.endSize[i] ?? 4) - (pool.size[i] ?? 4)) * t;
+            SCRATCH_COLOR.r = r;
+            SCRATCH_COLOR.g = g;
+            SCRATCH_COLOR.b = b;
+            SCRATCH_COLOR.a = a;
+            device.drawParticle(pool.x[i] ?? 0, pool.y[i] ?? 0, pool.z[i] ?? 0, size, SCRATCH_COLOR, (f & PARTICLE_FLAG_ADDITIVE) !== 0);
+        }
+    }
+}
+//# sourceMappingURL=particle-render-system.js.map

package/dist/systems/particle-render-system.js.map

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

package/dist/systems/particle-simulation-system.d.ts

@@ -0,0 +1,8 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+export declare const POOL_PARTICLE = "particle";
+export declare class ParticleSimulationSystem implements System {
+    readonly name: string;
+    update(world: World, dt: number): void;
+}
+//# sourceMappingURL=particle-simulation-system.d.ts.map

package/dist/systems/particle-simulation-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle-simulation-system.d.ts","sourceRoot":"","sources":["../../src/systems/particle-simulation-system.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,eAAO,MAAM,aAAa,aAAa,CAAC;AAExC,qBAAa,wBAAyB,YAAW,MAAM;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAyB;IAE9C,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CA8BvC"}

package/dist/systems/particle-simulation-system.js

@@ -0,0 +1,45 @@
+// ParticleSimulationSystem - advances every live particle's state
+// each tick. Position, velocity, life. Particles whose life drops
+// below zero are killed and their slots returned to the free list.
+//
+// Runs in PHASE_PHYSICS, after the emitter system has spawned this
+// frame's new particles (emitter runs in PHASE_LOGIC).
+//
+// Hot loop: walks [0, highWaterMark) of the pool, branchless on the
+// alive flag (skip via continue), in-place mutation. No allocations
+// per particle.
+import { PARTICLE_FLAG_ALIVE } from '../vfx/particle-pool.js';
+export const POOL_PARTICLE = 'particle';
+export class ParticleSimulationSystem {
+    name = 'particle-simulation';
+    update(world, dt) {
+        const pool = world.getPool(POOL_PARTICLE);
+        if (!pool)
+            return;
+        const hwm = pool.getHighWaterMark();
+        if (hwm === 0)
+            return;
+        for (let i = 0; i < hwm; i++) {
+            const f = pool.flags[i] ?? 0;
+            if ((f & PARTICLE_FLAG_ALIVE) === 0)
+                continue;
+            const remaining = (pool.life[i] ?? 0) - dt;
+            if (remaining <= 0) {
+                pool.kill(i);
+                continue;
+            }
+            pool.life[i] = remaining;
+            // Velocity integration with constant acceleration.
+            const vx = (pool.vx[i] ?? 0) + (pool.ax[i] ?? 0) * dt;
+            const vy = (pool.vy[i] ?? 0) + (pool.ay[i] ?? 0) * dt;
+            const vz = (pool.vz[i] ?? 0) + (pool.az[i] ?? 0) * dt;
+            pool.vx[i] = vx;
+            pool.vy[i] = vy;
+            pool.vz[i] = vz;
+            pool.x[i] = (pool.x[i] ?? 0) + vx * dt;
+            pool.y[i] = (pool.y[i] ?? 0) + vy * dt;
+            pool.z[i] = (pool.z[i] ?? 0) + vz * dt;
+        }
+    }
+}
+//# sourceMappingURL=particle-simulation-system.js.map

package/dist/systems/particle-simulation-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle-simulation-system.js","sourceRoot":"","sources":["../../src/systems/particle-simulation-system.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,kEAAkE;AAClE,mEAAmE;AACnE,EAAE;AACF,mEAAmE;AACnE,uDAAuD;AACvD,EAAE;AACF,oEAAoE;AACpE,oEAAoE;AACpE,gBAAgB;AAIhB,OAAO,EAAgB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE5E,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;AAExC,MAAM,OAAO,wBAAwB;IAC1B,IAAI,GAAW,qBAAqB,CAAC;IAE9C,MAAM,CAAC,KAAY,EAAE,EAAU;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAe,aAAa,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACpC,IAAI,GAAG,KAAK,CAAC;YAAE,OAAO;QAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,CAAC,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC;gBAAE,SAAS;YAE9C,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;YAC3C,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACb,SAAS;YACX,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;YAEzB,mDAAmD;YACnD,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;YACtD,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;YACtD,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;YACtD,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YAEhB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;YACvC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;YACvC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;CACF"}

package/dist/systems/projectile-render-system.d.ts

@@ -0,0 +1,7 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+export declare class ProjectileRenderSystem implements System {
+    readonly name: string;
+    update(world: World, _dt: number): void;
+}
+//# sourceMappingURL=projectile-render-system.d.ts.map

package/dist/systems/projectile-render-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectile-render-system.d.ts","sourceRoot":"","sources":["../../src/systems/projectile-render-system.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAWzC,qBAAa,sBAAuB,YAAW,MAAM;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAuB;IAE5C,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CA0BxC"}

package/dist/systems/projectile-render-system.js

@@ -0,0 +1,35 @@
+// ProjectileRenderSystem - draws live projectiles each frame.
+//
+// Reuses Canvas2DDevice.drawParticle for rendering since projectiles
+// are visually similar to particles (small bright dots / lines). For
+// a dedicated arrow/bolt sprite, future work can extend with a
+// drawProjectile primitive that renders an oriented sprite. For v1
+// of Phase 7 deeper, code-painted dots are sufficient.
+import { POOL_PROJECTILE, PROJECTILE_FLAG_ALIVE } from '../vfx/projectile-pool.js';
+import { RESOURCE_DEVICE, RESOURCE_CAMERA, } from '../resources.js';
+const SCRATCH_COLOR = { r: 1, g: 1, b: 1, a: 1 };
+export class ProjectileRenderSystem {
+    name = 'projectile-render';
+    update(world, _dt) {
+        const pool = world.getPool(POOL_PROJECTILE);
+        const device = world.resources.get(RESOURCE_DEVICE);
+        const camera = world.resources.get(RESOURCE_CAMERA);
+        if (!pool || !device || !camera)
+            return;
+        if (pool.getLiveCount() === 0)
+            return;
+        device.setCamera(camera);
+        const hwm = pool.getHighWaterMark();
+        for (let i = 0; i < hwm; i++) {
+            const f = pool.flags[i] ?? 0;
+            if ((f & PROJECTILE_FLAG_ALIVE) === 0)
+                continue;
+            SCRATCH_COLOR.r = pool.r[i] ?? 1;
+            SCRATCH_COLOR.g = pool.g[i] ?? 1;
+            SCRATCH_COLOR.b = pool.b[i] ?? 1;
+            SCRATCH_COLOR.a = pool.a[i] ?? 1;
+            device.drawParticle(pool.x[i] ?? 0, pool.y[i] ?? 0, pool.z[i] ?? 0, pool.size[i] ?? 4, SCRATCH_COLOR, true);
+        }
+    }
+}
+//# sourceMappingURL=projectile-render-system.js.map

package/dist/systems/projectile-render-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectile-render-system.js","sourceRoot":"","sources":["../../src/systems/projectile-render-system.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,qEAAqE;AACrE,qEAAqE;AACrE,+DAA+D;AAC/D,mEAAmE;AACnE,uDAAuD;AAIvD,OAAO,EAAkB,eAAe,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACnG,OAAO,EACL,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAIzB,MAAM,aAAa,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AAEjD,MAAM,OAAO,sBAAsB;IACxB,IAAI,GAAW,mBAAmB,CAAC;IAE5C,MAAM,CAAC,KAAY,EAAE,GAAW;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAiB,eAAe,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAkB,eAAe,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAa,eAAe,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;YAAE,OAAO;QACxC,IAAI,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC;YAAE,OAAO;QAEtC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,CAAC,CAAC,GAAG,qBAAqB,CAAC,KAAK,CAAC;gBAAE,SAAS;YAChD,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACjC,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACjC,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACjC,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EACd,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EACd,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EACd,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EACjB,aAAa,EACb,IAAI,CACL,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/systems/projectile-system.d.ts

@@ -0,0 +1,7 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+export declare class ProjectileSystem implements System {
+    readonly name: string;
+    update(world: World, dt: number): void;
+}
+//# sourceMappingURL=projectile-system.d.ts.map

package/dist/systems/projectile-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectile-system.d.ts","sourceRoot":"","sources":["../../src/systems/projectile-system.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAOzC,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAgB;IAErC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CA4FvC"}