@babylonjsmarket/arcade 0.3.7 → 0.3.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babylonjsmarket/arcade",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "type": "module",
   "license": "MIT",
   "description": "Reusable arcade-style components (mesh, camera, lights, input, physics, scoring, animation) for the @babylonjsmarket/ecs framework",
@@ -89,7 +89,7 @@
     "prepublishOnly": "npm run build && npm run test"
   },
   "dependencies": {
-    "@babylonjsmarket/ecs": "*",
+    "@babylonjsmarket/ecs": "^0.5.3",
     "@clack/prompts": "^0.10.0",
     "mri": "^1.2.0",
     "picocolors": "^1.1.1"

package/src/Components/ArcCamera/meta.json

@@ -10,5 +10,9 @@
   ],
   "dependencies": [
     "MeshPrimitive"
+  ],
+  "tags": [
+    "core",
+    "camera"
   ]
 }

package/src/Components/Bullet/meta.json

@@ -2,7 +2,19 @@
   "name": "Bullet",
   "description": "Drives pooled bullet entities (MeshPrimitive + Bullet). Each frame the system advances every live bullet along its direction, expires it on lifetime, on leaving the arena, or when its travel segment crosses a bullet-blocking Obstacle wall, and tests it against live enemies. On a hit it emits `bullet.hit` (for observers like SFX/flashes, carrying the shot direction) then routes damage through HealthSystem via `health.damage`, and releases the bullet back to its pool with `world.removeEntity` rather than destroying it.",
   "category": "shooter",
-  "components": ["BulletComponent"],
-  "systems": ["BulletSystem"],
-  "dependencies": ["MeshPrimitive", "Health", "Obstacle"]
+  "components": [
+    "BulletComponent"
+  ],
+  "systems": [
+    "BulletSystem"
+  ],
+  "dependencies": [
+    "MeshPrimitive",
+    "Health",
+    "Obstacle"
+  ],
+  "tags": [
+    "core",
+    "combat"
+  ]
 }

package/src/Components/BulletPool/meta.json

@@ -2,7 +2,19 @@
   "name": "BulletPool",
   "description": "Registers a framework entity pool of reusable bullet entities (MeshPrimitive + Bullet) so firing never allocates an entity or mesh. On `bulletPool.fire` it acquires a parked slot and resets its direction/speed/lifetime/damage + muzzle position (with an optional per-shot color), then BulletSystem flies it and parks it again on expiry or hit. Emits `bulletPool.ready` once the pool is pre-built. Parking is the World `active` flag; the park-aware MeshPrimitiveSystem keeps each bullet mesh alive (hidden) for reuse.",
   "category": "shooter",
-  "components": ["BulletPoolComponent"],
-  "systems": ["BulletPoolSystem"],
-  "dependencies": ["MeshPrimitive", "Bullet"]
+  "components": [
+    "BulletPoolComponent"
+  ],
+  "systems": [
+    "BulletPoolSystem"
+  ],
+  "dependencies": [
+    "MeshPrimitive",
+    "Bullet"
+  ],
+  "tags": [
+    "core",
+    "combat",
+    "spawning"
+  ]
 }

package/src/Components/Bumper/meta.json

@@ -2,7 +2,18 @@
   "name": "Bumper",
   "description": "Proximity-based scoring trigger. Each bumper owns a hitRadius and a point value; the system runs an XZ distance check against every ball-tagged entity and, on entry, emits bumper.hit plus score.add to award points to ownerEntity. A per-bumper-per-ball debounce keeps a slow rolling ball from re-triggering every frame — the flag only clears once the ball moves beyond releaseRadius. Renderer-agnostic: it reads MeshPrimitive positions only and never touches Babylon or Havok, leaving the physical deflection to a Physics component on the same entity.",
   "category": "pinball",
-  "components": ["BumperComponent"],
-  "systems": ["BumperSystem"],
-  "dependencies": ["MeshPrimitive", "Score"]
+  "components": [
+    "BumperComponent"
+  ],
+  "systems": [
+    "BumperSystem"
+  ],
+  "dependencies": [
+    "MeshPrimitive",
+    "Score"
+  ],
+  "tags": [
+    "pinball",
+    "physics"
+  ]
 }

package/src/Components/CameraFollow/CameraFollow.contract.test.ts

@@ -5,6 +5,7 @@ import {
   CameraFollowEvents,
 } from './CameraFollow';
 import { ArcCameraComponent } from '../ArcCamera/ArcCamera';
+import { getArcCameraRuntime } from '../ArcCamera/ArcCamera.core';
 
 runMechanicContract({
   name: 'CameraFollow',
@@ -30,7 +31,7 @@ runMechanicContract({
     const arcEntity = world.createEntity();
     const arc = new ArcCameraComponent();
     arc.handle = renderer.createArcCamera(arcEntity.id, arc.toSpec());
-    arc.initialized = true;
+    getArcCameraRuntime(arc).initialized = true;
     arcEntity.add(arc);
 
     // Stub a world position the mesh handle reports through the adapter.

package/src/Components/CameraFollow/CameraFollow.test.ts

@@ -1,6 +1,7 @@
 import { describe, it, expect, beforeEach } from 'vitest';
 import { CameraFollowComponent, CameraFollowSystem } from './CameraFollow';
 import { ArcCameraComponent } from '../ArcCamera/ArcCamera';
+import { getArcCameraRuntime } from '../ArcCamera/ArcCamera.core';
 import { EventBus, World } from '@babylonjsmarket/ecs';
 import { MockRendererAdapter } from '@babylonjsmarket/ecs';
 import type { MeshHandle } from '@babylonjsmarket/ecs/renderer-types';
@@ -60,7 +61,7 @@ describe('CameraFollowSystem', () => {
     const arcEntity = world.createEntity('Camera');
     const arcComp = new ArcCameraComponent();
     arcComp.handle = renderer.createArcCamera(arcEntity.id, arcComp.toSpec());
-    arcComp.initialized = true;
+    getArcCameraRuntime(arcComp).initialized = true;
     arcEntity.add(arcComp);
 
     const followEntity = world.createEntity('Follow');
@@ -76,7 +77,7 @@ describe('CameraFollowSystem', () => {
     const arcEntity = world.createEntity('Camera');
     const arcComp = new ArcCameraComponent();
     arcComp.handle = renderer.createArcCamera(arcEntity.id, arcComp.toSpec());
-    arcComp.initialized = true;
+    getArcCameraRuntime(arcComp).initialized = true;
     arcEntity.add(arcComp);
 
     // Fake a Player mesh and emit the creation event the system listens for.
@@ -106,7 +107,7 @@ describe('CameraFollowSystem', () => {
     const arcEntity = world.createEntity('Camera');
     const arcComp = new ArcCameraComponent();
     arcComp.handle = renderer.createArcCamera(arcEntity.id, arcComp.toSpec());
-    arcComp.initialized = true;
+    getArcCameraRuntime(arcComp).initialized = true;
     arcEntity.add(arcComp);
 
     const fakeHandle = renderer.createMesh('Player', { kind: 'capsule' });

package/src/Components/Enemy/meta.json

@@ -2,7 +2,25 @@
   "name": "Enemy",
   "description": "Chases the entity tagged `player`, separates from other enemies so they don't stack, and deals contact damage via `health.damage`. Takes bullet hits as `bullet.hit`; on death (HealthSystem's `health.died`) it emits `enemy.killed` and `score.add`. Pooled — instead of being destroyed it asks EntityPool to re-park its slot (`entityPool.release`). Optional SkeletonAnimator support drives walk/attack/death clips, directional fall animations, and a knockback slide that barrels the corpse into the swarm; chase vs wander is driven by LineOfSight's acquired/lost events.",
   "category": "shooter",
-  "components": ["EnemyComponent"],
-  "systems": ["EnemySystem"],
-  "dependencies": ["MeshPrimitive", "EntityPool", "SkeletonAnimator", "Health", "Score", "Bullet", "Obstacle", "LineOfSight"]
+  "components": [
+    "EnemyComponent"
+  ],
+  "systems": [
+    "EnemySystem"
+  ],
+  "dependencies": [
+    "MeshPrimitive",
+    "EntityPool",
+    "SkeletonAnimator",
+    "Health",
+    "Score",
+    "Bullet",
+    "Obstacle",
+    "LineOfSight"
+  ],
+  "tags": [
+    "core",
+    "ai",
+    "combat"
+  ]
 }

package/src/Components/EnemySpawner/meta.json

@@ -2,7 +2,19 @@
   "name": "EnemySpawner",
   "description": "Pulses enemies out from its own world position on a timer, up to a per-spawner live cap. It never creates entities itself — it emits `entityPool.spawn` naming its pool, and EntityPool hands out a reused enemy. The cap stays a true live count by tracking the pool's `entityPool.spawned` / `entityPool.released` events (a release covers both a kill and the pool recycling under pressure). Per-spawn hp/speed/color ride along for games that apply overrides on acquire.",
   "category": "shooter",
-  "components": ["EnemySpawnerComponent"],
-  "systems": ["EnemySpawnerSystem"],
-  "dependencies": ["MeshPrimitive", "EntityPool"]
+  "components": [
+    "EnemySpawnerComponent"
+  ],
+  "systems": [
+    "EnemySpawnerSystem"
+  ],
+  "dependencies": [
+    "MeshPrimitive",
+    "EntityPool"
+  ],
+  "tags": [
+    "core",
+    "spawning",
+    "ai"
+  ]
 }

package/src/Components/EntityPool/meta.json

@@ -10,5 +10,9 @@
   ],
   "dependencies": [
     "MeshPrimitive"
+  ],
+  "tags": [
+    "core",
+    "spawning"
   ]
 }

package/src/Components/Flipper/meta.json

@@ -2,7 +2,21 @@
   "name": "Flipper",
   "description": "Keyboard-driven kinematic flipper bat. Holding the trigger key (default KeyZ) ramps the bat's Y rotation toward flipAngle at flipSpeed and releasing returns it to restAngle, driving the MeshPrimitive's pose each frame so Havok computes the contact impulse that pings the ball. Opt into taperedGeometry to rebuild the mesh as a trapezoidal prism hinged at the pivot end and inflate the collider against tunneling; pair with Physics autoCreate:false. Emits flipper.colliderRebuilt and listens for flipper.rebuildColliders so debug panels can refit collider extents live. Ships with FlipperColliderDebugger, a Babylon wireframe overlay of the inflated collider toggled by a hotkey.",
   "category": "pinball",
-  "components": ["FlipperComponent", "FlipperColliderDebuggerComponent"],
-  "systems": ["FlipperSystem", "FlipperColliderDebuggerSystem"],
-  "dependencies": ["MeshPrimitive", "Physics"]
+  "components": [
+    "FlipperComponent",
+    "FlipperColliderDebuggerComponent"
+  ],
+  "systems": [
+    "FlipperSystem",
+    "FlipperColliderDebuggerSystem"
+  ],
+  "dependencies": [
+    "MeshPrimitive",
+    "Physics"
+  ],
+  "tags": [
+    "pinball",
+    "controller",
+    "input"
+  ]
 }

package/src/Components/Health/meta.json

@@ -10,5 +10,9 @@
   ],
   "dependencies": [
     "MeshPrimitive"
+  ],
+  "tags": [
+    "core",
+    "combat"
   ]
 }

package/src/Components/KeyboardMover/KeyboardMover.test.ts

@@ -2,6 +2,7 @@ import { describe, it, expect, beforeEach } from 'vitest';
 import { KeyboardMoverComponent, KeyboardMoverSystem } from './KeyboardMover';
 import { MeshPrimitiveComponent } from '../MeshPrimitive/MeshPrimitive.core';
 import { ArcCameraComponent } from '../ArcCamera/ArcCamera';
+import { getArcCameraRuntime } from '../ArcCamera/ArcCamera.core';
 import { EventBus, World } from '@babylonjsmarket/ecs';
 import { MockRendererAdapter } from '@babylonjsmarket/ecs';
 
@@ -29,7 +30,7 @@ describe('KeyboardMover', () => {
     const camEntity = world.createEntity('Camera');
     const arc = new ArcCameraComponent({ alpha: 0 });
     arc.handle = renderer.createArcCamera(camEntity.id, arc.toSpec());
-    arc.initialized = true;
+    getArcCameraRuntime(arc).initialized = true;
     camEntity.add(arc);
 
     const playerEntity = world.createEntity('Player');
@@ -54,7 +55,7 @@ describe('KeyboardMover', () => {
     const camEntity = world.createEntity('Camera');
     const arc = new ArcCameraComponent({ alpha: 0 });
     arc.handle = renderer.createArcCamera(camEntity.id, arc.toSpec());
-    arc.initialized = true;
+    getArcCameraRuntime(arc).initialized = true;
     camEntity.add(arc);
 
     const playerEntity = world.createEntity('Player');
@@ -79,7 +80,7 @@ describe('KeyboardMover', () => {
     const camEntity = world.createEntity('Camera');
     const arc = new ArcCameraComponent({ alpha: 0 });
     arc.handle = renderer.createArcCamera(camEntity.id, arc.toSpec());
-    arc.initialized = true;
+    getArcCameraRuntime(arc).initialized = true;
     camEntity.add(arc);
 
     const playerEntity = world.createEntity('Player');

package/src/Components/LineOfSight/meta.json

@@ -11,5 +11,9 @@
   "dependencies": [
     "MeshPrimitive",
     "Obstacle"
+  ],
+  "tags": [
+    "core",
+    "ai"
   ]
 }

package/src/Components/Mesh/meta.json

@@ -10,5 +10,9 @@
   ],
   "dependencies": [
     "MeshPrimitive"
+  ],
+  "tags": [
+    "core",
+    "rendering"
   ]
 }

package/src/Components/MeshPrimitive/meta.json

@@ -8,5 +8,9 @@
   "systems": [
     "MeshPrimitiveSystem"
   ],
-  "dependencies": []
+  "dependencies": [],
+  "tags": [
+    "core",
+    "rendering"
+  ]
 }

package/src/Components/MouseHole/meta.json

@@ -2,7 +2,17 @@
   "name": "MouseHole",
   "description": "Saucer / scoop that captures the ball, holds it briefly, then kicks it back into play. A proximity check against the ball's XZ position triggers capture: the system emits mouseHole.captured and score.add (points to ownerEntity), pins the ball to the hole with its velocity zeroed for holdSeconds, then on release applies kickoutVelocity via the physics body and emits mouseHole.released. A short post-kickout cooldown stops the hole from immediately re-capturing the ball it just launched.",
   "category": "pinball",
-  "components": ["MouseHoleComponent"],
-  "systems": ["MouseHoleSystem"],
-  "dependencies": ["MeshPrimitive", "Score"]
+  "components": [
+    "MouseHoleComponent"
+  ],
+  "systems": [
+    "MouseHoleSystem"
+  ],
+  "dependencies": [
+    "MeshPrimitive",
+    "Score"
+  ],
+  "tags": [
+    "pinball"
+  ]
 }

package/src/Components/Obstacle/meta.json

@@ -8,5 +8,9 @@
   "systems": [],
   "dependencies": [
     "MeshPrimitive"
+  ],
+  "tags": [
+    "core",
+    "physics"
   ]
 }

package/src/Components/Physics/meta.json

@@ -10,5 +10,9 @@
   ],
   "dependencies": [
     "MeshPrimitive"
+  ],
+  "tags": [
+    "core",
+    "physics"
   ]
 }

package/src/Components/PinballBuilder/meta.json

@@ -2,7 +2,23 @@
   "name": "PinballBuilder",
   "description": "Data-driven, in-game placer for pinball elements. Listens for `pinballBuilder.addBumper`/`addWall`/`addRail`/`addRamp`/`addSpinner`/`addMouseHole` and spawns a fully-wired entity (MeshPrimitive + Shadow + Physics, plus the matching Bumper/Spinner/MouseHole behavior) at the requested table coordinates, emitting `pinballBuilder.entityAdded`. Also handles freehand draw mode: `pinballBuilder.setDrawMode` toggles drawing (echoed via `pinballBuilder.drawModeChanged`) and `pinballBuilder.drawPath` smooths a raw pointer polyline with a Catmull-Rom spline, resamples it at uniform arc-length, and chains one rail/wall segment per interval to turn a freehand line into a clean curved track.",
   "category": "pinball",
-  "components": ["PinballBuilderComponent", "PinballBuilderDebuggerComponent"],
-  "systems": ["PinballBuilderSystem", "PinballBuilderDebuggerSystem"],
-  "dependencies": ["MeshPrimitive", "Bumper", "Spinner", "MouseHole", "PinballTable"]
+  "components": [
+    "PinballBuilderComponent",
+    "PinballBuilderDebuggerComponent"
+  ],
+  "systems": [
+    "PinballBuilderSystem",
+    "PinballBuilderDebuggerSystem"
+  ],
+  "dependencies": [
+    "MeshPrimitive",
+    "Bumper",
+    "Spinner",
+    "MouseHole",
+    "PinballTable"
+  ],
+  "tags": [
+    "pinball",
+    "builder"
+  ]
 }

package/src/Components/PinballBuilderInput/PinballBuilderInput.test.ts

@@ -42,7 +42,7 @@ describe('PinballBuilderInputSystem', () => {
   const defaultPick = (x: number, y: number): PickResult =>
     ({ x: x / 10, y: 0, z: y / 10, meshId: 'mesh_Playfield' }) as unknown as PickResult;
 
-  function setup(pick = defaultPick) {
+  function setup(pick: (x: number, y: number) => PickResult | null = defaultPick) {
     eventBus = new EventBus();
     canvas = document.createElement('canvas');
     canvas.getBoundingClientRect = () => ({ left: 0, top: 0, width: 800, height: 600 }) as DOMRect;

package/src/Components/PinballBuilderInput/meta.json

@@ -2,7 +2,18 @@
   "name": "PinballBuilderInput",
   "description": "Canvas-side counterpart to PinballBuilder's freehand drawing. On `pinballBuilder.setDrawMode` { enabled, kind } it attaches (or detaches) pointer listeners to the rendering canvas, projects each sample onto the playfield mesh via the renderer's screen-point pick (filtered by pickMeshPrefix), accumulates a jitter-filtered XZ polyline, and emits `pinballBuilder.drawPath` on pointer release for PinballBuilder to turn into a chained rail or wall. Parameter-free singleton; declare one on any entity to activate the system.",
   "category": "pinball",
-  "components": ["PinballBuilderInputComponent"],
-  "systems": ["PinballBuilderInputSystem"],
-  "dependencies": ["PinballBuilder"]
+  "components": [
+    "PinballBuilderInputComponent"
+  ],
+  "systems": [
+    "PinballBuilderInputSystem"
+  ],
+  "dependencies": [
+    "PinballBuilder"
+  ],
+  "tags": [
+    "pinball",
+    "builder",
+    "input"
+  ]
 }

package/src/Components/PinballCamera/PinballCamera.test.ts

@@ -33,7 +33,14 @@ describe('PinballCameraSystem', () => {
       alpha: Math.PI / 2,
       beta: Math.PI / 3,
       radius: 15,
+      minRadius: 5,
+      maxRadius: 50,
+      minBeta: 0.1,
+      maxBeta: Math.PI / 2 - 0.1,
       target: [0, 0, 0],
+      inertia: 0.9,
+      wheelPrecision: 50,
+      angularSensibility: 1000,
     });
     e.add(arc);
     return { entity: e, arc };

package/src/Components/PinballCamera/meta.json

@@ -2,7 +2,18 @@
   "name": "PinballCamera",
   "description": "Locks a fixed top-down pinball view on top of a sibling ArcCamera. Detaches the ArcRotateCamera's pointer controls and overrides its FOV (retrying each frame until the camera handle exists), then listens for `pinballTable.resized` and recomputes the fit distance so the whole table frames neatly at any dimensions, padded by marginFactor. Drives ArcCamera's `distance` (not the raw radius) so a tuning panel can still override zoom. Attach next to ArcCamera on the same entity.",
   "category": "pinball",
-  "components": ["PinballCameraComponent"],
-  "systems": ["PinballCameraSystem"],
-  "dependencies": ["ArcCamera", "PinballTable"]
+  "components": [
+    "PinballCameraComponent"
+  ],
+  "systems": [
+    "PinballCameraSystem"
+  ],
+  "dependencies": [
+    "ArcCamera",
+    "PinballTable"
+  ],
+  "tags": [
+    "pinball",
+    "camera"
+  ]
 }

package/src/Components/PinballLayout/meta.json

@@ -2,7 +2,18 @@
   "name": "PinballLayout",
   "description": "Declarative proportional placement for table elements. Each entity expresses its position as `x = xCoeff * tableWidth + xOffset` and `z = zCoeff * tableDepth + zOffset`, plus optional X/Z mesh scaling tied to the same dims (scaleWith: both/width/depth/none). The system listens for `pinballTable.resized` and, in one pass, rewrites every layout entity's MeshPrimitive position and scale through the renderer — so resizing the table from the viz panel keeps walls, bumpers, flippers and the playfield correctly arranged.",
   "category": "pinball",
-  "components": ["PinballLayoutComponent"],
-  "systems": ["PinballLayoutSystem"],
-  "dependencies": ["MeshPrimitive", "PinballTable"]
+  "components": [
+    "PinballLayoutComponent"
+  ],
+  "systems": [
+    "PinballLayoutSystem"
+  ],
+  "dependencies": [
+    "MeshPrimitive",
+    "PinballTable"
+  ],
+  "tags": [
+    "pinball",
+    "builder"
+  ]
 }

package/src/Components/PinballTable/meta.json

@@ -2,7 +2,17 @@
   "name": "PinballTable",
   "description": "Single source of truth for the playfield's width (X) and depth (Z). One PinballTable entity per scene; the system broadcasts the seed dimensions once as `pinballTable.resized` on init, and on every `pinballTable.resize` request (from the viz panel) it updates the dims and re-broadcasts `pinballTable.resized` so dependent entities (walls, slingshots, flippers, inlanes) reposition and the camera reframes. Defaults match a regulation 20.25\"×42\" Williams/Bally playfield.",
   "category": "pinball",
-  "components": ["PinballTableComponent", "PinballTableDebuggerComponent"],
-  "systems": ["PinballTableSystem", "PinballTableDebuggerSystem"],
-  "dependencies": []
+  "components": [
+    "PinballTableComponent",
+    "PinballTableDebuggerComponent"
+  ],
+  "systems": [
+    "PinballTableSystem",
+    "PinballTableDebuggerSystem"
+  ],
+  "dependencies": [],
+  "tags": [
+    "pinball",
+    "builder"
+  ]
 }

package/src/Components/Plunger/meta.json

@@ -2,7 +2,19 @@
   "name": "Plunger",
   "description": "Owns the pinball's ball lifecycle. Auto-launches the ball the moment its Havok body appears, re-launches on drain (when the ball falls below drainY or rolls past the bottom-edge drain Z), and fires on a trigger key (default Space) for a manual re-plunge — each launch teleports the ball to spawnPosition and kicks it down-table with launchVelocityZ plus sideways jitter. Also installs the table's tilted scene gravity and Havok's 240 Hz sub-time-step once physics is alive, and listens to pinballTable.resized to keep the drain threshold lined up with the table's bottom edge. Optionally swaps the ball's material for a chrome-mirror PBR.",
   "category": "pinball",
-  "components": ["PlungerComponent"],
-  "systems": ["PlungerSystem"],
-  "dependencies": ["MeshPrimitive", "PinballTable"]
+  "components": [
+    "PlungerComponent"
+  ],
+  "systems": [
+    "PlungerSystem"
+  ],
+  "dependencies": [
+    "MeshPrimitive",
+    "PinballTable"
+  ],
+  "tags": [
+    "pinball",
+    "controller",
+    "input"
+  ]
 }

package/src/Components/Score/meta.json

@@ -8,5 +8,9 @@
   "systems": [
     "ScoreSystem"
   ],
-  "dependencies": []
+  "dependencies": [],
+  "tags": [
+    "core",
+    "ui"
+  ]
 }

package/src/Components/ShooterCamera/ShooterCamera.test.ts

@@ -61,7 +61,14 @@ describe('ShooterCameraSystem', () => {
       alpha: Math.PI / 2,
       beta: Math.PI / 3,
       radius: 15,
+      minRadius: 5,
+      maxRadius: 50,
+      minBeta: 0.1,
+      maxBeta: Math.PI / 2 - 0.1,
       target: [0, 0, 0],
+      inertia: 0.9,
+      wheelPrecision: 50,
+      angularSensibility: 1000,
     });
     e.add(arc);
     return { entity: e, arc };

package/src/Components/ShooterCamera/meta.json

@@ -2,7 +2,18 @@
   "name": "ShooterCamera",
   "description": "Top-down follow camera companion for twin-stick / top-down shooters. Configures a sibling ArcCamera rather than creating its own: it resolves the live ArcCameraComponent and writes its data — a steep look-down beta + fixed distance, the follow target (so ArcCameraSystem, the single target writer, tracks the player) — then once detaches the orbit controls so the player can't unhinge the framing and overrides the FOV. It no longer reads the player mesh or writes the camera target itself, so it never races ArcCameraSystem. Attach it next to ArcCamera on the same entity.",
   "category": "shooter",
-  "components": ["ShooterCameraComponent"],
-  "systems": ["ShooterCameraSystem"],
-  "dependencies": ["ArcCamera"]
+  "components": [
+    "ShooterCameraComponent"
+  ],
+  "systems": [
+    "ShooterCameraSystem"
+  ],
+  "dependencies": [
+    "ArcCamera"
+  ],
+  "tags": [
+    "shooter",
+    "twin-stick-shooter",
+    "camera"
+  ]
 }

package/src/Components/SkeletonAnimator/meta.json

@@ -10,5 +10,9 @@
   ],
   "dependencies": [
     "Mesh"
+  ],
+  "tags": [
+    "core",
+    "animation"
   ]
 }

package/src/Components/Spinner/meta.json

@@ -2,7 +2,18 @@
   "name": "Spinner",
   "description": "A freely-spinning bar mounted to the playfield. When a ball passes within hitRadius the system imparts angular velocity to the bar (direction set by which side the ball crossed), then integrates that spin each frame with drag decaying it toward zero. Purely kinematic — it rotates the MeshPrimitive directly rather than using a Havok hinge. Every completed revolution emits spinner.spun and score.add for pointsPerSpin to ownerEntity, so one strong hit rewards multiple points as the bar coasts.",
   "category": "pinball",
-  "components": ["SpinnerComponent"],
-  "systems": ["SpinnerSystem"],
-  "dependencies": ["MeshPrimitive", "Score"]
+  "components": [
+    "SpinnerComponent"
+  ],
+  "systems": [
+    "SpinnerSystem"
+  ],
+  "dependencies": [
+    "MeshPrimitive",
+    "Score"
+  ],
+  "tags": [
+    "pinball",
+    "physics"
+  ]
 }

package/src/Components/TwinStickShooter/TwinStickShooter.test.ts

@@ -45,7 +45,14 @@ describe('TwinStickShooterSystem', () => {
       alpha: -Math.PI / 2,
       beta: Math.PI / 3,
       radius: 15,
+      minRadius: 5,
+      maxRadius: 50,
+      minBeta: 0.1,
+      maxBeta: Math.PI / 2 - 0.1,
       target: [0, 0, 0],
+      inertia: 0.9,
+      wheelPrecision: 50,
+      angularSensibility: 1000,
     });
     e.add(arc);
     return e;

package/src/Components/TwinStickShooter/meta.json

@@ -3,7 +3,21 @@
   "description": "SmashTV-style player controller: WASD moves, the arrow keys fire in 8 directions, both camera-relative (W is always up the screen). The body eases to face where it shoots or heads, and movement is clamped to the arena and pushed out of Obstacle barriers. Firing is pooled — instead of spawning entities it emits `bulletPool.fire` at the muzzle, and reuses a single muzzle-flash mesh per shooter (no per-shot mesh churn).",
   "category": "shooter",
   "subgenre": "twin-stick-shooter",
-  "components": ["TwinStickShooterComponent"],
-  "systems": ["TwinStickShooterSystem"],
-  "dependencies": ["MeshPrimitive", "BulletPool", "Obstacle", "ArcCamera"]
+  "components": [
+    "TwinStickShooterComponent"
+  ],
+  "systems": [
+    "TwinStickShooterSystem"
+  ],
+  "dependencies": [
+    "MeshPrimitive",
+    "BulletPool",
+    "Obstacle",
+    "ArcCamera"
+  ],
+  "tags": [
+    "shooter",
+    "twin-stick-shooter",
+    "controller"
+  ]
 }