@rune-kit/rune 2.10.0 → 2.12.0

package/extensions/gamedev/skills/audio-system.md

@@ -1,129 +1,129 @@
----
-name: "audio-system"
-pack: "@rune/gamedev"
-description: "Web Audio API, spatial audio, SFX management — AudioManager with spatial audio, music crossfade, and SFX pooling."
-model: sonnet
-tools: [Read, Edit, Write, Grep, Glob, Bash]
----
-
-# audio-system
-
-Web Audio API, spatial audio, SFX management — AudioManager with spatial audio, music crossfade, and SFX pooling.
-
-#### Workflow
-
-**Step 1 — Detect audio setup**
-Use Grep to find audio code: `AudioContext`, `Howler`, `Audio`, `createBufferSource`, `createGain`. Read the audio initialization to understand: context management, volume controls, and loading strategy.
-
-**Step 2 — Audit audio configuration**
-Check for: AudioContext not resumed on user gesture (browser autoplay policy), SFX creating new nodes on every play (memory pressure), no volume normalization (clipping), missing cleanup on scene exit.
-
-**Step 3 — Emit AudioManager**
-Emit: AudioManager class with master/music/sfx gain chain, music crossfade, spatial (3D) audio via PannerNode, and SFX pooling.
-
-#### Web Audio API — Full Audio Manager
-
-```typescript
-// AudioManager — spatial audio, music crossfade, SFX pooling
-class AudioManager {
-  private ctx: AudioContext;
-  private masterGain: GainNode;
-  private musicGain: GainNode;
-  private sfxGain: GainNode;
-  private buffers = new Map<string, AudioBuffer>();
-  private sfxPool = new Map<string, AudioBufferSourceNode[]>();
-  private currentMusic: AudioBufferSourceNode | null = null;
-
-  constructor() {
-    this.ctx = new AudioContext();
-    this.masterGain = this.ctx.createGain();
-    this.musicGain = this.ctx.createGain();
-    this.sfxGain = this.ctx.createGain();
-
-    this.musicGain.connect(this.masterGain);
-    this.sfxGain.connect(this.masterGain);
-    this.masterGain.connect(this.ctx.destination);
-
-    this.musicGain.gain.value = 0.6;
-    this.sfxGain.gain.value = 1.0;
-  }
-
-  async load(id: string, url: string) {
-    const response = await fetch(url);
-    const arrayBuffer = await response.arrayBuffer();
-    this.buffers.set(id, await this.ctx.decodeAudioData(arrayBuffer));
-  }
-
-  playSfx(id: string, options: { volume?: number; detune?: number } = {}) {
-    const buffer = this.buffers.get(id);
-    if (!buffer) return;
-
-    // Resume context if suspended (browser autoplay policy)
-    if (this.ctx.state === 'suspended') this.ctx.resume();
-
-    const source = this.ctx.createBufferSource();
-    const gain = this.ctx.createGain();
-    source.buffer = buffer;
-    source.detune.value = options.detune ?? 0;
-    gain.gain.value = options.volume ?? 1;
-
-    source.connect(gain).connect(this.sfxGain);
-    source.start();
-  }
-
-  // Music crossfade — smooth transition between tracks
-  async crossfadeTo(id: string, fadeDuration = 2) {
-    const buffer = this.buffers.get(id);
-    if (!buffer) return;
-    if (this.ctx.state === 'suspended') await this.ctx.resume();
-
-    const newSource = this.ctx.createBufferSource();
-    newSource.buffer = buffer;
-    newSource.loop = true;
-
-    const newGain = this.ctx.createGain();
-    newGain.gain.setValueAtTime(0, this.ctx.currentTime);
-    newGain.gain.linearRampToValueAtTime(1, this.ctx.currentTime + fadeDuration);
-
-    newSource.connect(newGain).connect(this.musicGain);
-    newSource.start();
-
-    if (this.currentMusic) {
-      const oldGain = this.ctx.createGain();
-      oldGain.gain.setValueAtTime(1, this.ctx.currentTime);
-      oldGain.gain.linearRampToValueAtTime(0, this.ctx.currentTime + fadeDuration);
-      this.currentMusic.connect(oldGain).connect(this.musicGain);
-      const old = this.currentMusic;
-      setTimeout(() => old.stop(), fadeDuration * 1000);
-    }
-
-    this.currentMusic = newSource;
-  }
-
-  // Spatial (3D) audio — attenuate by distance from listener
-  playSpatial(id: string, x: number, y: number, z: number) {
-    const buffer = this.buffers.get(id);
-    if (!buffer) return;
-
-    const source = this.ctx.createBufferSource();
-    const panner = this.ctx.createPanner();
-    source.buffer = buffer;
-
-    panner.panningModel = 'HRTF';
-    panner.distanceModel = 'inverse';
-    panner.refDistance = 1;
-    panner.maxDistance = 100;
-    panner.rolloffFactor = 1;
-    panner.positionX.value = x;
-    panner.positionY.value = y;
-    panner.positionZ.value = z;
-
-    source.connect(panner).connect(this.sfxGain);
-    source.start();
-  }
-
-  setMasterVolume(v: number) { this.masterGain.gain.value = Math.max(0, Math.min(1, v)); }
-  setMusicVolume(v: number) { this.musicGain.gain.value = Math.max(0, Math.min(1, v)); }
-  setSfxVolume(v: number) { this.sfxGain.gain.value = Math.max(0, Math.min(1, v)); }
-}
-```
+---
+name: "audio-system"
+pack: "@rune/gamedev"
+description: "Web Audio API, spatial audio, SFX management — AudioManager with spatial audio, music crossfade, and SFX pooling."
+model: sonnet
+tools: [Read, Edit, Write, Grep, Glob, Bash]
+---
+
+# audio-system
+
+Web Audio API, spatial audio, SFX management — AudioManager with spatial audio, music crossfade, and SFX pooling.
+
+#### Workflow
+
+**Step 1 — Detect audio setup**
+Use Grep to find audio code: `AudioContext`, `Howler`, `Audio`, `createBufferSource`, `createGain`. Read the audio initialization to understand: context management, volume controls, and loading strategy.
+
+**Step 2 — Audit audio configuration**
+Check for: AudioContext not resumed on user gesture (browser autoplay policy), SFX creating new nodes on every play (memory pressure), no volume normalization (clipping), missing cleanup on scene exit.
+
+**Step 3 — Emit AudioManager**
+Emit: AudioManager class with master/music/sfx gain chain, music crossfade, spatial (3D) audio via PannerNode, and SFX pooling.
+
+#### Web Audio API — Full Audio Manager
+
+```typescript
+// AudioManager — spatial audio, music crossfade, SFX pooling
+class AudioManager {
+  private ctx: AudioContext;
+  private masterGain: GainNode;
+  private musicGain: GainNode;
+  private sfxGain: GainNode;
+  private buffers = new Map<string, AudioBuffer>();
+  private sfxPool = new Map<string, AudioBufferSourceNode[]>();
+  private currentMusic: AudioBufferSourceNode | null = null;
+
+  constructor() {
+    this.ctx = new AudioContext();
+    this.masterGain = this.ctx.createGain();
+    this.musicGain = this.ctx.createGain();
+    this.sfxGain = this.ctx.createGain();
+
+    this.musicGain.connect(this.masterGain);
+    this.sfxGain.connect(this.masterGain);
+    this.masterGain.connect(this.ctx.destination);
+
+    this.musicGain.gain.value = 0.6;
+    this.sfxGain.gain.value = 1.0;
+  }
+
+  async load(id: string, url: string) {
+    const response = await fetch(url);
+    const arrayBuffer = await response.arrayBuffer();
+    this.buffers.set(id, await this.ctx.decodeAudioData(arrayBuffer));
+  }
+
+  playSfx(id: string, options: { volume?: number; detune?: number } = {}) {
+    const buffer = this.buffers.get(id);
+    if (!buffer) return;
+
+    // Resume context if suspended (browser autoplay policy)
+    if (this.ctx.state === 'suspended') this.ctx.resume();
+
+    const source = this.ctx.createBufferSource();
+    const gain = this.ctx.createGain();
+    source.buffer = buffer;
+    source.detune.value = options.detune ?? 0;
+    gain.gain.value = options.volume ?? 1;
+
+    source.connect(gain).connect(this.sfxGain);
+    source.start();
+  }
+
+  // Music crossfade — smooth transition between tracks
+  async crossfadeTo(id: string, fadeDuration = 2) {
+    const buffer = this.buffers.get(id);
+    if (!buffer) return;
+    if (this.ctx.state === 'suspended') await this.ctx.resume();
+
+    const newSource = this.ctx.createBufferSource();
+    newSource.buffer = buffer;
+    newSource.loop = true;
+
+    const newGain = this.ctx.createGain();
+    newGain.gain.setValueAtTime(0, this.ctx.currentTime);
+    newGain.gain.linearRampToValueAtTime(1, this.ctx.currentTime + fadeDuration);
+
+    newSource.connect(newGain).connect(this.musicGain);
+    newSource.start();
+
+    if (this.currentMusic) {
+      const oldGain = this.ctx.createGain();
+      oldGain.gain.setValueAtTime(1, this.ctx.currentTime);
+      oldGain.gain.linearRampToValueAtTime(0, this.ctx.currentTime + fadeDuration);
+      this.currentMusic.connect(oldGain).connect(this.musicGain);
+      const old = this.currentMusic;
+      setTimeout(() => old.stop(), fadeDuration * 1000);
+    }
+
+    this.currentMusic = newSource;
+  }
+
+  // Spatial (3D) audio — attenuate by distance from listener
+  playSpatial(id: string, x: number, y: number, z: number) {
+    const buffer = this.buffers.get(id);
+    if (!buffer) return;
+
+    const source = this.ctx.createBufferSource();
+    const panner = this.ctx.createPanner();
+    source.buffer = buffer;
+
+    panner.panningModel = 'HRTF';
+    panner.distanceModel = 'inverse';
+    panner.refDistance = 1;
+    panner.maxDistance = 100;
+    panner.rolloffFactor = 1;
+    panner.positionX.value = x;
+    panner.positionY.value = y;
+    panner.positionZ.value = z;
+
+    source.connect(panner).connect(this.sfxGain);
+    source.start();
+  }
+
+  setMasterVolume(v: number) { this.masterGain.gain.value = Math.max(0, Math.min(1, v)); }
+  setMusicVolume(v: number) { this.musicGain.gain.value = Math.max(0, Math.min(1, v)); }
+  setSfxVolume(v: number) { this.sfxGain.gain.value = Math.max(0, Math.min(1, v)); }
+}
+```

package/extensions/gamedev/skills/camera-system.md

@@ -1,87 +1,87 @@
----
-name: "camera-system"
-pack: "@rune/gamedev"
-description: "Follow camera, screen shake, zoom — 2D camera with smooth lerp follow, dead zone, screen shake on impact, and zoom-to target."
-model: sonnet
-tools: [Read, Edit, Write, Grep, Glob, Bash]
----
-
-# camera-system
-
-Follow camera, screen shake, zoom — 2D camera with smooth lerp follow, dead zone, screen shake on impact, and zoom-to target.
-
-#### Workflow
-
-**Step 1 — Detect camera usage**
-Use Grep to find camera code: `Camera`, `follow`, `viewport`, `ctx.translate`, `ctx.setTransform`. Read to understand: follow strategy, any existing shake/zoom, and how transform is applied to canvas.
-
-**Step 2 — Audit camera configuration**
-Check for: camera snapping to target each frame (no lerp = no smoothness), no dead zone (camera moves even for tiny player motion), screen shake with random offset not decaying.
-
-**Step 3 — Emit Camera2D**
-Emit: Camera2D with smooth lerp, configurable dead zone, screen shake with intensity decay, zoom-to target, and `applyToContext` helper.
-
-#### Smooth Follow, Screen Shake, Dead Zone
-
-```typescript
-// 2D camera system — smooth follow, screen shake, zoom, dead zone
-class Camera2D {
-  x = 0; y = 0;
-  zoom = 1;
-  private targetX = 0; private targetY = 0;
-  private shakeIntensity = 0; private shakeDuration = 0;
-  lerpSpeed = 5;
-
-  // Dead zone — camera only moves when target leaves this box
-  private deadZone = { w: 80, h: 60 };
-
-  follow(targetX: number, targetY: number, dt: number) {
-    const dx = targetX - this.targetX;
-    const dy = targetY - this.targetY;
-
-    // Only move camera when target exits dead zone
-    if (Math.abs(dx) > this.deadZone.w / 2) this.targetX += dx - Math.sign(dx) * this.deadZone.w / 2;
-    if (Math.abs(dy) > this.deadZone.h / 2) this.targetY += dy - Math.sign(dy) * this.deadZone.h / 2;
-
-    // Smooth lerp
-    this.x += (this.targetX - this.x) * this.lerpSpeed * dt;
-    this.y += (this.targetY - this.y) * this.lerpSpeed * dt;
-  }
-
-  shake(intensity: number, duration: number) {
-    this.shakeIntensity = intensity;
-    this.shakeDuration = duration;
-  }
-
-  zoomTo(target: number, dt: number, speed = 3) {
-    this.zoom += (target - this.zoom) * speed * dt;
-  }
-
-  update(dt: number): { x: number; y: number; zoom: number } {
-    let sx = 0; let sy = 0;
-    if (this.shakeDuration > 0) {
-      this.shakeDuration -= dt;
-      const t = Math.max(0, this.shakeDuration);
-      sx = (Math.random() * 2 - 1) * this.shakeIntensity * t;
-      sy = (Math.random() * 2 - 1) * this.shakeIntensity * t;
-    }
-    return { x: this.x + sx, y: this.y + sy, zoom: this.zoom };
-  }
-
-  // Apply to Canvas 2D context
-  applyToContext(ctx: CanvasRenderingContext2D, screenW: number, screenH: number) {
-    const { x, y, zoom } = this.update(1 / 60);
-    ctx.setTransform(zoom, 0, 0, zoom, screenW / 2 - x * zoom, screenH / 2 - y * zoom);
-  }
-}
-
-// Usage
-const camera = new Camera2D();
-camera.lerpSpeed = 8;
-
-// In game loop render:
-// camera.follow(player.x, player.y, dt);
-// camera.applyToContext(ctx, canvas.width, canvas.height);
-// ... draw scene ...
-// ctx.setTransform(1, 0, 0, 1, 0, 0); // reset for HUD
-```
+---
+name: "camera-system"
+pack: "@rune/gamedev"
+description: "Follow camera, screen shake, zoom — 2D camera with smooth lerp follow, dead zone, screen shake on impact, and zoom-to target."
+model: sonnet
+tools: [Read, Edit, Write, Grep, Glob, Bash]
+---
+
+# camera-system
+
+Follow camera, screen shake, zoom — 2D camera with smooth lerp follow, dead zone, screen shake on impact, and zoom-to target.
+
+#### Workflow
+
+**Step 1 — Detect camera usage**
+Use Grep to find camera code: `Camera`, `follow`, `viewport`, `ctx.translate`, `ctx.setTransform`. Read to understand: follow strategy, any existing shake/zoom, and how transform is applied to canvas.
+
+**Step 2 — Audit camera configuration**
+Check for: camera snapping to target each frame (no lerp = no smoothness), no dead zone (camera moves even for tiny player motion), screen shake with random offset not decaying.
+
+**Step 3 — Emit Camera2D**
+Emit: Camera2D with smooth lerp, configurable dead zone, screen shake with intensity decay, zoom-to target, and `applyToContext` helper.
+
+#### Smooth Follow, Screen Shake, Dead Zone
+
+```typescript
+// 2D camera system — smooth follow, screen shake, zoom, dead zone
+class Camera2D {
+  x = 0; y = 0;
+  zoom = 1;
+  private targetX = 0; private targetY = 0;
+  private shakeIntensity = 0; private shakeDuration = 0;
+  lerpSpeed = 5;
+
+  // Dead zone — camera only moves when target leaves this box
+  private deadZone = { w: 80, h: 60 };
+
+  follow(targetX: number, targetY: number, dt: number) {
+    const dx = targetX - this.targetX;
+    const dy = targetY - this.targetY;
+
+    // Only move camera when target exits dead zone
+    if (Math.abs(dx) > this.deadZone.w / 2) this.targetX += dx - Math.sign(dx) * this.deadZone.w / 2;
+    if (Math.abs(dy) > this.deadZone.h / 2) this.targetY += dy - Math.sign(dy) * this.deadZone.h / 2;
+
+    // Smooth lerp
+    this.x += (this.targetX - this.x) * this.lerpSpeed * dt;
+    this.y += (this.targetY - this.y) * this.lerpSpeed * dt;
+  }
+
+  shake(intensity: number, duration: number) {
+    this.shakeIntensity = intensity;
+    this.shakeDuration = duration;
+  }
+
+  zoomTo(target: number, dt: number, speed = 3) {
+    this.zoom += (target - this.zoom) * speed * dt;
+  }
+
+  update(dt: number): { x: number; y: number; zoom: number } {
+    let sx = 0; let sy = 0;
+    if (this.shakeDuration > 0) {
+      this.shakeDuration -= dt;
+      const t = Math.max(0, this.shakeDuration);
+      sx = (Math.random() * 2 - 1) * this.shakeIntensity * t;
+      sy = (Math.random() * 2 - 1) * this.shakeIntensity * t;
+    }
+    return { x: this.x + sx, y: this.y + sy, zoom: this.zoom };
+  }
+
+  // Apply to Canvas 2D context
+  applyToContext(ctx: CanvasRenderingContext2D, screenW: number, screenH: number) {
+    const { x, y, zoom } = this.update(1 / 60);
+    ctx.setTransform(zoom, 0, 0, zoom, screenW / 2 - x * zoom, screenH / 2 - y * zoom);
+  }
+}
+
+// Usage
+const camera = new Camera2D();
+camera.lerpSpeed = 8;
+
+// In game loop render:
+// camera.follow(player.x, player.y, dt);
+// camera.applyToContext(ctx, canvas.width, canvas.height);
+// ... draw scene ...
+// ctx.setTransform(1, 0, 0, 1, 0, 0); // reset for HUD
+```

package/extensions/gamedev/skills/ecs.md

@@ -1,98 +1,98 @@
----
-name: "ecs"
-pack: "@rune/gamedev"
-description: "Entity Component System architecture — archetype-based ECS with dense array storage for cache efficiency, pure system functions, and query-based entity iteration."
-model: sonnet
-tools: [Read, Edit, Write, Grep, Glob, Bash]
----
-
-# ecs
-
-Entity Component System architecture — archetype-based ECS with dense array storage for cache efficiency, pure system functions, and query-based entity iteration.
-
-#### Workflow
-
-**Step 1 — Detect ECS usage**
-Use Grep to find ECS patterns: `Entity`, `Component`, `System`, `World`, `bitECS`, `createWorld`. Read entity management code to understand: component storage, system execution order, and query patterns.
-
-**Step 2 — Audit ECS architecture**
-Check for: logic mixed into components (components should be pure data), O(n²) entity iteration without spatial partitioning, components stored as objects (prefer flat arrays for cache efficiency), and missing entity cleanup on destroy.
-
-**Step 3 — Emit ECS scaffold**
-Emit: World class with entity registry + component storage, query-based entity iteration, pure system functions, and proper cleanup.
-
-#### Lightweight ECS — Archetype-Based
-
-```typescript
-// Minimal ECS — dense array storage per archetype for cache efficiency
-type EntityId = number;
-type ComponentType<T> = { new(...args: unknown[]): T; readonly typeName: string; };
-
-// Components are plain data, no logic
-class Position { static typeName = 'Position'; constructor(public x = 0, public y = 0) {} }
-class Velocity { static typeName = 'Velocity'; constructor(public vx = 0, public vy = 0) {} }
-class Sprite   { static typeName = 'Sprite';   constructor(public textureId = '') {} }
-class Health   { static typeName = 'Health';   constructor(public hp = 100, public max = 100) {} }
-
-// World — entity registry + component storage
-class World {
-  private nextId = 1;
-  private components = new Map<string, Map<EntityId, unknown>>();
-
-  createEntity(): EntityId { return this.nextId++; }
-
-  addComponent<T extends object>(entity: EntityId, component: T & { constructor: { typeName: string } }) {
-    const name = component.constructor.typeName;
-    if (!this.components.has(name)) this.components.set(name, new Map());
-    this.components.get(name)!.set(entity, component);
-  }
-
-  getComponent<T>(entity: EntityId, type: ComponentType<T>): T | undefined {
-    return this.components.get(type.typeName)?.get(entity) as T | undefined;
-  }
-
-  removeComponent<T>(entity: EntityId, type: ComponentType<T>) {
-    this.components.get(type.typeName)?.delete(entity);
-  }
-
-  // Query — iterate entities that have ALL specified components
-  query<T extends object[]>(...types: { [K in keyof T]: ComponentType<T[K]> }): EntityId[] {
-    if (types.length === 0) return [];
-    const [first, ...rest] = types;
-    const candidates = Array.from(this.components.get(first.typeName)?.keys() ?? []);
-    return candidates.filter(id => rest.every(t => this.components.get(t.typeName)?.has(id)));
-  }
-
-  destroyEntity(entity: EntityId) {
-    this.components.forEach(store => store.delete(entity));
-  }
-}
-
-// Systems — pure functions over component queries
-const movementSystem = (world: World, dt: number) => {
-  for (const id of world.query(Position, Velocity)) {
-    const pos = world.getComponent(id, Position)!;
-    const vel = world.getComponent(id, Velocity)!;
-    pos.x += vel.vx * dt;
-    pos.y += vel.vy * dt;
-  }
-};
-
-const healthSystem = (world: World) => {
-  for (const id of world.query(Health)) {
-    const hp = world.getComponent(id, Health)!;
-    if (hp.hp <= 0) world.destroyEntity(id);
-  }
-};
-
-// Usage
-const world = new World();
-const player = world.createEntity();
-world.addComponent(player, new Position(100, 100));
-world.addComponent(player, new Velocity(0, 0));
-world.addComponent(player, new Health(100, 100));
-
-// In fixed update:
-// movementSystem(world, dt);
-// healthSystem(world);
-```
+---
+name: "ecs"
+pack: "@rune/gamedev"
+description: "Entity Component System architecture — archetype-based ECS with dense array storage for cache efficiency, pure system functions, and query-based entity iteration."
+model: sonnet
+tools: [Read, Edit, Write, Grep, Glob, Bash]
+---
+
+# ecs
+
+Entity Component System architecture — archetype-based ECS with dense array storage for cache efficiency, pure system functions, and query-based entity iteration.
+
+#### Workflow
+
+**Step 1 — Detect ECS usage**
+Use Grep to find ECS patterns: `Entity`, `Component`, `System`, `World`, `bitECS`, `createWorld`. Read entity management code to understand: component storage, system execution order, and query patterns.
+
+**Step 2 — Audit ECS architecture**
+Check for: logic mixed into components (components should be pure data), O(n²) entity iteration without spatial partitioning, components stored as objects (prefer flat arrays for cache efficiency), and missing entity cleanup on destroy.
+
+**Step 3 — Emit ECS scaffold**
+Emit: World class with entity registry + component storage, query-based entity iteration, pure system functions, and proper cleanup.
+
+#### Lightweight ECS — Archetype-Based
+
+```typescript
+// Minimal ECS — dense array storage per archetype for cache efficiency
+type EntityId = number;
+type ComponentType<T> = { new(...args: unknown[]): T; readonly typeName: string; };
+
+// Components are plain data, no logic
+class Position { static typeName = 'Position'; constructor(public x = 0, public y = 0) {} }
+class Velocity { static typeName = 'Velocity'; constructor(public vx = 0, public vy = 0) {} }
+class Sprite   { static typeName = 'Sprite';   constructor(public textureId = '') {} }
+class Health   { static typeName = 'Health';   constructor(public hp = 100, public max = 100) {} }
+
+// World — entity registry + component storage
+class World {
+  private nextId = 1;
+  private components = new Map<string, Map<EntityId, unknown>>();
+
+  createEntity(): EntityId { return this.nextId++; }
+
+  addComponent<T extends object>(entity: EntityId, component: T & { constructor: { typeName: string } }) {
+    const name = component.constructor.typeName;
+    if (!this.components.has(name)) this.components.set(name, new Map());
+    this.components.get(name)!.set(entity, component);
+  }
+
+  getComponent<T>(entity: EntityId, type: ComponentType<T>): T | undefined {
+    return this.components.get(type.typeName)?.get(entity) as T | undefined;
+  }
+
+  removeComponent<T>(entity: EntityId, type: ComponentType<T>) {
+    this.components.get(type.typeName)?.delete(entity);
+  }
+
+  // Query — iterate entities that have ALL specified components
+  query<T extends object[]>(...types: { [K in keyof T]: ComponentType<T[K]> }): EntityId[] {
+    if (types.length === 0) return [];
+    const [first, ...rest] = types;
+    const candidates = Array.from(this.components.get(first.typeName)?.keys() ?? []);
+    return candidates.filter(id => rest.every(t => this.components.get(t.typeName)?.has(id)));
+  }
+
+  destroyEntity(entity: EntityId) {
+    this.components.forEach(store => store.delete(entity));
+  }
+}
+
+// Systems — pure functions over component queries
+const movementSystem = (world: World, dt: number) => {
+  for (const id of world.query(Position, Velocity)) {
+    const pos = world.getComponent(id, Position)!;
+    const vel = world.getComponent(id, Velocity)!;
+    pos.x += vel.vx * dt;
+    pos.y += vel.vy * dt;
+  }
+};
+
+const healthSystem = (world: World) => {
+  for (const id of world.query(Health)) {
+    const hp = world.getComponent(id, Health)!;
+    if (hp.hp <= 0) world.destroyEntity(id);
+  }
+};
+
+// Usage
+const world = new World();
+const player = world.createEntity();
+world.addComponent(player, new Position(100, 100));
+world.addComponent(player, new Velocity(0, 0));
+world.addComponent(player, new Health(100, 100));
+
+// In fixed update:
+// movementSystem(world, dt);
+// healthSystem(world);
+```