WorldObjectComponent

A component attached to a WorldObject. Use this rather than the lower-level Component interface for any per-object behaviour — controllers, graphics, colliders, audio sources, gameplay logic — both because the name reads better in docs/imports and because the dependency resolver also exposes cross-tier lookups against the parent World via requireFromWorld / optionalFromWorld.

Declaring dependencies on world-scoped infrastructure

The canonical use case for object-component dependencies is "I need to talk to a world-scoped system." A graphics component needs the renderer. A physics body needs the simulation. An audio source needs the mixer.

type GraphicsDeps = { renderer: RendererSystem };

class GraphicsComponent implements WorldObjectComponent<GraphicsDeps> {
  constructor(public readonly host: WorldObject) {}

  resolveDependencies(
    resolver: WorldObjectDependencyResolver,
  ): GraphicsDeps {
    return { renderer: resolver.requireFromWorld(RendererSystem) };
  }

  onAdded({ renderer }: GraphicsDeps): void {
    renderer.register(this);
  }

  onDestroy({ renderer }: GraphicsDeps): void {
    renderer.unregister(this);
  }
}