excaliburjs / Excalibur / 29337541870

89%

Build Type

push

github

Committed by web-flow

Commit Message

feat: Implement Plugin System (#3670)

# New 1st Party Plugin System

This allows deep configuration of the excalibur subsystems by providing lifecycle hooks/interception points at every critical juncture to boot the engine. Right now we are mainly focused on renderer/asset type plugins so this initial stab leans in that direction.

 1. **Engine construction** — `onEnginePreConfig` → (flags frozen) → `onEnginePostConfig`
 2. **Engine start** — `onLoad` → (resources loaded) → `onLoadComplete`
 3. **Engine initialize** — `onEnginePreInitialize` → `onEnginePostInitialize`
 4. **Graphics context construction** — `onGraphicsPreConfig` → `onGraphicsPostConfig`
 5. **Graphics context init** — `onGraphicsPreInitialize` → `onGraphicsPostInitialize`
 6. **Scene initialize** — `onScenePreInitialize` → `onScenePostInitialize`
 7. **Scene activate** — `onScenePreActivate` → `onScenePostActivate`
 8. **Scene deactivate** — `onScenePreDeactivate` → `onScenePostDeactivate`
 9. **Graphics context lost/restored** — `onGraphicsContextLost` → `onGraphicsContextRestored`
 10. **Engine dispose** — `dispose`

Coverage Stats

7061 of 9246 branches covered (76.37%)

103 of 107 new or added lines in 5 files covered. (96.26%)

1 existing line in 1 file now uncovered.

15624 of 17565 relevant lines covered (88.95%)

25333.38 hits per line