excalibur 1.1.0-alpha.317 → 1.1.0-alpha.320
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +16 -0
- package/build/esm/excalibur.development.js +643 -1086
- package/build/esm/excalibur.js +643 -1086
- package/build/esm/excalibur.min.development.js +2380 -2544
- package/build/esm/excalibur.min.js +2380 -2544
- package/build/esm/src/engine/actions/action/curve-by.d.ts +1 -1
- package/build/esm/src/engine/actions/action/curve-to.d.ts +1 -1
- package/build/esm/src/engine/actions/action/flash.d.ts +3 -1
- package/build/esm/src/engine/actions/action/move-by.d.ts +3 -0
- package/build/esm/src/engine/actions/action/move-to.d.ts +3 -0
- package/build/esm/src/engine/actions/action-queue.d.ts +1 -1
- package/build/esm/src/engine/actions/actions-component.d.ts +1 -1
- package/build/esm/src/engine/actor.d.ts +4 -9
- package/build/esm/src/engine/camera.d.ts +3 -3
- package/build/esm/src/engine/collision/body-component.d.ts +28 -4
- package/build/esm/src/engine/collision/collider-component.d.ts +0 -7
- package/build/esm/src/engine/collision/colliders/collider.d.ts +22 -1
- package/build/esm/src/engine/collision/colliders/colliders.d.ts +0 -53
- package/build/esm/src/engine/collision/detection/sparse-hash-grid-collision-processor.d.ts +2 -2
- package/build/esm/src/engine/collision/physics-config.d.ts +5 -2
- package/build/esm/src/engine/color.d.ts +7 -2
- package/build/esm/src/engine/context.d.ts +17 -2
- package/build/esm/src/engine/debug/debug-config.d.ts +8 -5
- package/build/esm/src/engine/director/cross-fade.d.ts +3 -0
- package/build/esm/src/engine/director/default-loader.d.ts +6 -6
- package/build/esm/src/engine/director/fade-in-out.d.ts +3 -0
- package/build/esm/src/engine/director/slide.d.ts +0 -6
- package/build/esm/src/engine/director/transition.d.ts +4 -1
- package/build/esm/src/engine/engine.d.ts +2 -2
- package/build/esm/src/engine/entity-component-system/components/transform-component.d.ts +2 -1
- package/build/esm/src/engine/entity-component-system/entity-manager.d.ts +1 -1
- package/build/esm/src/engine/entity-component-system/entity.d.ts +2 -27
- package/build/esm/src/engine/events.d.ts +24 -120
- package/build/esm/src/engine/flags.d.ts +0 -4
- package/build/esm/src/engine/graphics/animation.d.ts +8 -4
- package/build/esm/src/engine/graphics/context/excalibur-graphics-context-2d-canvas.d.ts +2 -0
- package/build/esm/src/engine/graphics/context/excalibur-graphics-context-webgl.d.ts +14 -3
- package/build/esm/src/engine/graphics/context/excalibur-graphics-context.d.ts +12 -2
- package/build/esm/src/engine/graphics/context/material.d.ts +1 -1
- package/build/esm/src/engine/graphics/context/shader-pipeline/effects/bloom-effect.d.ts +2 -2
- package/build/esm/src/engine/graphics/context/shader-pipeline/effects/blur-passes.d.ts +2 -2
- package/build/esm/src/engine/graphics/context/shader-pipeline/effects/glow-passes.d.ts +2 -2
- package/build/esm/src/engine/graphics/context/shader-pipeline/shader-pass.d.ts +2 -1
- package/build/esm/src/engine/graphics/context/shader-pipeline/shader-pipeline.d.ts +2 -2
- package/build/esm/src/engine/graphics/context/shader.d.ts +10 -1
- package/build/esm/src/engine/graphics/graphics-component.d.ts +2 -2
- package/build/esm/src/engine/graphics/index.d.ts +0 -1
- package/build/esm/src/engine/graphics/post-processor/post-processor.d.ts +2 -20
- package/build/esm/src/engine/index.d.ts +0 -1
- package/build/esm/src/engine/input/gamepad.d.ts +11 -6
- package/build/esm/src/engine/input/keyboard.d.ts +5 -5
- package/build/esm/src/engine/input/pointer-event-receiver.d.ts +16 -4
- package/build/esm/src/engine/interfaces/lifecycle-events.d.ts +39 -39
- package/build/esm/src/engine/interfaces/pointer-event-handlers.d.ts +36 -37
- package/build/esm/src/engine/lighting/light-occluder-component.d.ts +3 -3
- package/build/esm/src/engine/math/graph.d.ts +8 -5
- package/build/esm/src/engine/particles/gpu-particle-emitter.d.ts +3 -2
- package/build/esm/src/engine/particles/particles.d.ts +3 -5
- package/build/esm/src/engine/resources/gif.d.ts +3 -53
- package/build/esm/src/engine/resources/resource.d.ts +5 -5
- package/build/esm/src/engine/resources/sound/sound-track.d.ts +14 -8
- package/build/esm/src/engine/resources/sound/sound.d.ts +20 -22
- package/build/esm/src/engine/scene.d.ts +15 -5
- package/build/esm/src/engine/tile-map/tile-map.d.ts +10 -10
- package/build/esm/src/engine/timer.d.ts +3 -0
- package/build/esm/src/engine/trigger.d.ts +4 -4
- package/build/esm/src/engine/util/arena-pool.d.ts +0 -5
- package/build/esm/src/engine/util/clock.d.ts +9 -9
- package/build/esm/src/engine/util/util.d.ts +1 -7
- package/build/esm/src/engine/util/web-audio.d.ts +0 -5
- package/package.json +3 -1
- package/build/esm/src/engine/actions/action/ease-by.d.ts +0 -24
- package/build/esm/src/engine/actions/action/ease-to.d.ts +0 -23
- package/build/esm/src/engine/deprecated.d.ts +0 -1
- package/build/esm/src/engine/entity-component-system/components/tags-component.d.ts +0 -5
- package/build/esm/src/engine/events/ex-event.d.ts +0 -6
- package/build/esm/src/engine/events/pointer-events.d.ts +0 -37
- package/build/esm/src/engine/graphics/context/image-renderer/image-renderer.d.ts +0 -46
- package/build/esm/src/engine/graphics/context/screen-pass-painter/screen-pass-painter.d.ts +0 -14
- package/build/esm/src/engine/graphics/post-processor/screen-shader.d.ts +0 -17
- package/build/esm/src/engine/input/capture-pointer-config.d.ts +0 -13
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,9 @@ This project adheres to [Semantic Versioning](http://semver.org/).
|
|
|
7
7
|
|
|
8
8
|
### Breaking Changes
|
|
9
9
|
|
|
10
|
+
- Time units are implicitly **milliseconds** everywhere, with no `Ms` suffix on public API:
|
|
11
|
+
- `Engine.currentFrameElapsedMs` -> `currentFrameElapsed`, `Engine.currentFrameLagMs` -> `currentFrameLag`, `FrameStats.elapsedMs` -> `elapsed`, `GifFrame.delayMs` -> `delay`, `ClockOptions.defaultUpdateMs` -> `defaultUpdate`
|
|
12
|
+
- `Sound`, `SoundTrack` and `PlayOptions` `position`/`duration`, `seek()`, `getPlaybackPosition()`, `getTotalPlaybackDuration()` and `SoundTrack.scheduledStartTime` are now in **milliseconds** (previously seconds). `sound.play({ duration: 500 })` now plays for half a second.
|
|
10
13
|
- API naming is now consistent: synchronous boolean state is always a **getter** (`isX`), side-effecting calls are **verb methods**, and async state is a **Promise property** that never has an `isX()` form. Zero-arg `isX()`/`hasX()` methods became getters, drop the parentheses:
|
|
11
14
|
- `Entity.isKilled` (and `Actor`), `Engine.isRunning`, `Engine.isDisposed`, `Clock.isRunning`, `Scene.isCurrentScene`, `CollisionContact.isCanceled`, `CoroutineInstance.isRunning/isComplete`
|
|
12
15
|
- `Sound` and `SoundTrack`: `isPlaying`, `isPaused`, `isStopped`
|
|
@@ -16,8 +19,10 @@ This project adheres to [Semantic Versioning](http://semver.org/).
|
|
|
16
19
|
- Settable booleans follow the same `isX` naming as the already-shipped `isVisible`: the `visible` option on `ActorOptions`, `TriggerOptions` and `GraphicsComponentOptions` is now `isVisible`, and `Particle.visible` is now `Particle.isVisible`
|
|
17
20
|
- `Tile.solid` (`TileMap` and `IsometricMap` tiles) and the `solid` tile option are now `isSolid`
|
|
18
21
|
- `GarbageCollector.running()` is now the getter `isRunning`; `FontTextInstance.disposed` is now `isDisposed`
|
|
22
|
+
- `Slide({ easingFunction })` is now `Slide({ easing })`, matching every other transition; previously `easing` was silently ignored by `Slide`
|
|
19
23
|
- Pausing: `Actor.paused` (a `PauseComponent`, not a boolean) and `Particle.paused` are now the read-only `pauseComponent`, `PauseComponent.paused` is now the read-only `isPaused`, and `PauseComponentInterface` is now `PauseComponentOptions`. Use `Actor.canPause` and `Actor.isPaused` for everyday code
|
|
20
24
|
- Spelling: `isOffScreen` -> `isOffscreen` (one word, like the web platform's `OffscreenCanvas`; "on screen" stays split: `forceOnScreen`, `onScreenOnly`, `getOnScreenTiles()`), `isHiDpi` -> `isHiDPI` on `Engine` and `Screen`, and `Future.isCompleted` -> `isComplete`
|
|
25
|
+
- Renamed: `Color.equal` -> `Color.equals`
|
|
21
26
|
- Renamed: `Engine.loadingComplete` -> `Engine.isLoaded`; `Engine.ready` (boolean) -> `Engine.isReady`; `Engine.isReady()` (Promise) -> `await engine.ready`; `Animation.done` -> `Animation.isComplete`; `Timer.complete` and `Transition.complete` -> `isComplete`; `Gamepad.connected` -> `Gamepad.isConnected`; `SystemManager.initialized` -> `isInitialized`; `Engine.toggleInputEnabled(enabled)` -> `Engine.setInputEnabled(enabled)`; graph edge option `directed` -> `isDirected`; `PointerEvent.active`/`WheelEvent.active` -> `isActive`; `Transition.started` -> `hasStarted`; `Gamepads.enabled` (polling opt-in) -> `Gamepads.pollingEnabled`
|
|
22
27
|
|
|
23
28
|
- Sound: the audio implementation abstraction has been removed and Web Audio is the only implementation. `ex.WebAudioInstance` is replaced by `ex.SoundTrack` (returned by `Sound.instances` and `NativeSoundEvent.track`), and the `ex.Audio`, `ex.AudioImplementation`, `ex.ExResponse`, `ex.ExResponseType` and `ex.ExResponseTypesLookup` exports are gone (pass the response type string to `new ex.Resource(path, 'arraybuffer')` instead). Per-track volume moved to the owning `Sound`, so `SoundTrack` has no `volume`.
|
|
@@ -62,6 +67,17 @@ This project adheres to [Semantic Versioning](http://semver.org/).
|
|
|
62
67
|
- Build: Docusaurus now throws the build on broken markdown links, broken anchors, and broken markdown images instead of warning. Any custom docs/blog content must have valid internal links, anchors, and images.
|
|
63
68
|
- Build: The engine `tsconfig.json` now uses `module: "esnext"` with `moduleResolution: "bundler"` (previously `module: "es2015"` / `moduleResolution: "node"`), and `downlevelIteration` has been removed. The per-package `tsconfig.json` overrides in `director`, `entity-component-system`, `graphics`, and `resources` have been removed in favor of the single engine `tsconfig.json`. Consumers importing source directly may need bundler-compatible tooling.
|
|
64
69
|
- Build: TypeDoc runner has been replaced by `site/scripts/gen-typedoc-api.mjs`.
|
|
70
|
+
- Removed all remaining deprecated/legacy API ahead of v1:
|
|
71
|
+
- `ex.Shape` in favor of `ex.Colliders` (`Colliders.Box/Polygon/Circle/Edge/Capsule`)
|
|
72
|
+
- `ColliderComponent.set()` in favor of `use()`
|
|
73
|
+
- `ActorArgs` in favor of `ActorOptions`, `ParticleEmitterArgs` in favor of `ParticleEmitterOptions`, `ex.Pool` in favor of `ex.ArenaPool`
|
|
74
|
+
- `PostProcessor.getShader()/getLayout()` single-pass path, `PostProcessor.process(source, destination)` is now required (use `ShaderPipelinePostProcessor` or `ShaderPass`); `ex.ScreenShader` removed along with the `v_texcoord` varying (use `v_uv`)
|
|
75
|
+
- `Sound.play(volume: number)` in favor of `Sound.play({ volume })`
|
|
76
|
+
- `Flags.useLegacyImageRenderer()`, `ExcaliburGraphicsContextWebGL.imageRenderer` and the legacy `ex.image` renderer, `ex.image-v2` is the only image renderer
|
|
77
|
+
- `ex.EventTypes`, the lowercase event-name type aliases of `ex.Events` (`ex.Events.kill`, `ex.Events.pointerup`, ...), `AddedComponent`/`RemovedComponent` messages and type guards, `TagsComponent`
|
|
78
|
+
- `Util.addItemToArray` (`Util.removeItemFromArray` stays, no longer deprecated)
|
|
79
|
+
- `CapturePointerConfig`, `Particle.DefaultConfig`, and the exports of `GifParser`, `Stream` and `LegacyWebAudioSource` (internal only now)
|
|
80
|
+
- rAF/cAF/AudioContext-prefix polyfills, only the `requestIdleCallback` shim remains
|
|
65
81
|
|
|
66
82
|
### Deprecated
|
|
67
83
|
|