littlejsengine 1.26.0 → 1.27.0

package/CHANGELOG.md

@@ -7,6 +7,34 @@ What changed in each release, newest first. Releases before 1.20.0 are on the
 
 Nothing yet.
 
+## 1.27.0 - 2026-10-08
+
+### New Changes
+- 2D lights have cones and gels, as 3D spotlights do: `light.coneAngle` makes a light a cone, like a flashlight or a car's headlights, looking along its up and turned by its `angle`, its edge fading by `coneSoftness`; `light.gel` is a picture the light shines through, a tile or a texture across its square that turns with it, so one light can be a car's headlights and tail lights. Shadows still fall through both, and a light with neither draws as before. The Light System short has a swinging searchlight, and Light Shadows a mouse light shining through colored panes
+- One way collision, platforms jumped up through and landed on: `layer.setOneWay(tile, direction)` makes the cells that draw a tile passable moving that way, up, down, left or right, so they block only what was wholly on their far side before it moved; turned and mirrored as each cell's tile is, so a platform turned a quarter is one way to the side. Objects, particles and raycasts all follow it, `collideWithTile` is not asked about a tile passed through, and returning false from it drops through. A solid object's `oneWay` does the same for objects, and a rising platform keeps its rider. The new Platform Physics short shows it with a lift, a crate, a bouncy ball and an ice floor
+- `obj.isBullet` for small fast objects: it moves through the tiles as a point along a ray, so it never passes through a tile at any speed and is not held to objectMaxSpeed for them; `collideWithTile` sees it where it meets the tile, so sparks start on the surface; it bounces by restitution and goes on with the rest of its move, so it rolls along a floor as a box does. One with a size that collides with solid objects is still held to objectMaxSpeed. The platformer's bullets use it in place of their own raycast
+- Cloud saves on Newgrounds and Wavedash, the same on both: `cloudSave(slot, data)` keeps any value JSON can hold for the player, `cloudLoad(slot)` gives it back, null for an empty slot and undefined for a load that failed, so a game does not save over a save it could not load, with `loadFailure(slot)` saying when the slot holds a file that is not a save, and off the platform or not logged in they do nothing; Wavedash stats, `setStat` and `getStat`, and presence, `setPresence(status, details)`; Newgrounds events, `logEvent(name)`. The Newgrounds calls are built from its API docs and not yet tried on the site
+
+### Fixes
+- An object of no size is no longer held to objectMaxSpeed by `collideSolidObjects`, since it never collides with solids; one with `collideLevel` and a mass still is
+- A Shader disposed before its first draw was drawn stayed in the engine's list of shaders, the flush compiling it put it back
+- A ParticleEmitter3D callback that changed a particle's `age` or `lifeTime` had the change thrown away, now it is kept as `pos` and `velocity` are
+- A light pass whose `renderLight` or `renderEmissive` throws hands back the screen, its viewport, texture and blend, where a game that caught the error went on drawing into the lightmap
+- A tile layer redraw whose `onRedraw` or tile draw throws hands back the camera, the canvas and the draw target, where it left the game drawing into the layer
+- 3D level editor: a scale drag keeps a mirrored axis mirrored, where it turned every negative axis to the smallest size; a turned object lands, drops and pastes by the box around it as turned; opening the editor lets go of a mouse the game captured; a frame that throws gives the game its camera back; an orthographic game camera's near is not copied to the editor's view; the box select is drawn over a 3D pass drawn after the 2D
+
+## 1.26.1 - 2026-10-08
+
+### New Changes
+- A 3D Shader may define `void mainNormal(inout vec3 n)`, given the world normal after the normal map, to bend it per pixel for waves, ripples or a flag; the lighting, shadows, specular, Fresnel, environment reflection and fog all use it
+- `postProcess.enabled`: false skips the post process pass, so an effect turns off and on without taking the plugin apart
+- `averageFPS` is public and kept in release builds, where it read 0 unless debug or the watermark was on; it starts at the first frame's rate rather than climbing from 0
+- `camera.align2DZ`: the z of the plane an align2D camera lines up with the 2D view, 0 as before
+- The right click menu is left on links, as it is on text fields
+
+### Fixes
+- A tap starts the audio with touch input off too
+
 ## 1.26.0 - 2026-10-07
 
 ### New Changes

package/FAQ.md

@@ -282,7 +282,8 @@ Plugins are self-contained features that live alongside the engine but aren't pa
 | `pathFinder.js` | Grid-based A* pathfinding with optional path smoothing |
 | `tweakables.js` | A debug panel to change values live while the game runs, press 9 with the debug overlay open |
 | `medalSystem.js` | Achievement / medal tracking with popup notifications |
-| `newgrounds.js` | Newgrounds.io integration (medals held on the server, scoreboards) |
+| `newgrounds.js` | Newgrounds.io integration (medals held on the server, scoreboards, cloud saves, events) |
+| `wavedash.js` | Wavedash integration (achievements, leaderboards, cloud saves, stats, presence), the same shape as the Newgrounds one |
 | `audioEffects.js` | Web Audio effects like filter, reverb, delay, distortion and compressor, for a group of sounds or everything |
 | `drawUtilities.js` | Higher-level drawing helpers like nine-slice and three-slice |
 | `render3dVoxels.js` | `VoxelMap`, a 3D grid of blocks that draws itself and that objects collide with |
@@ -826,7 +827,7 @@ medal_firstWin.unlock();
 
 You can pass an image URL as the fifth argument to `Medal` instead of an emoji icon. The `saveName` you pass to `medalsInit` is used to track which medals have been unlocked in localStorage, so unlocks persist across visits. Give it a name of its own, not the one you pass to `readSaveData` and `writeSaveData`, or the medals and your save data overwrite each other.
 
-The plugin also supports [Newgrounds](https://www.newgrounds.com) scoreboards and medals held on the server through [plugins/newgrounds.js](plugins/newgrounds.js): create each medal as a `NewgroundsMedal` with the id Newgrounds gave it, call `medalsInit` as usual, then `new NewgroundsPlugin(app_id, cipher)`. The "LittleJS Medals & Newgrounds" section of REFERENCE.md has a short example.
+The plugin also supports [Newgrounds](https://www.newgrounds.com) scoreboards and medals held on the server through [plugins/newgrounds.js](plugins/newgrounds.js): create each medal as a `NewgroundsMedal` with the id Newgrounds gave it, call `medalsInit` as usual, then `new NewgroundsPlugin(app_id, cipher)`. The "LittleJS Medals & Newgrounds" section of REFERENCE.md has a short example. [plugins/wavedash.js](plugins/wavedash.js) does the same for [Wavedash](https://wavedash.com/) with `WavedashMedal` and `WavedashPlugin`, and both have `cloudSave(slot, data)` and `cloudLoad(slot)` to keep a player's save on the platform.
 
 ---
 

package/README.md

@@ -39,7 +39,7 @@ The code is very clean and well documented with many examples to get you started
 
 - Blazing fast WebGL2 + Canvas2D hybrid rendering system
 - Apply [Shadertoy](https://www.shadertoy.com) style shaders for post-processing effects, or on any object or draw
-- 2D lights with soft shadows, tinted glass and emissive objects
+- 2D lights with soft shadows, tinted glass and emissive objects, a sun with long shadows, and spotlight cones and gels
 - Robust particle effect system with a library of ready made effects and an [effect design tool](https://killedbyapixel.github.io/LittleJS/examples/particles/)
 - Parallax background layers that repeat across a level of any size
 - Load sprites and animations into texture sheets at runtime, or import [TexturePacker](https://www.codeandweb.com/texturepacker) and [Aseprite](https://www.aseprite.org) atlases
@@ -74,7 +74,8 @@ The code is very clean and well documented with many examples to get you started
 ### 💥 Physics
 
 - Robust arcade physics system with collision handling
-- Fast tilemap collision and raycasting
+- Fast tilemap collision and raycasting, with one-way platforms that turn with their tiles
+- Swept bullet collision, so small fast objects never pass through a wall
 - Object collision that stays fast with thousands of objects
 - Full Box2D integration for realistic physics using [Box2D v2.3.1 wasm](https://github.com/kripken/box2d.js)
 - Grid-based A* pathfinding plugin with optional path smoothing
@@ -96,7 +97,7 @@ The code is very clean and well documented with many examples to get you started
 - UI system with buttons, sliders, text input and nine-slice skins
 - Tween system with easing curves, and a scene system for titles, menus and game states
 - Debug overlay and primitive rendering system
-- Medal tracking system with [Newgrounds](https://www.newgrounds.com/) support
+- Medals, leaderboards and cloud saves on [Newgrounds](https://www.newgrounds.com/) and [Wavedash](https://wavedash.com/)
 - Node.js build system
 
 ### 🤖 AI Friendly

package/REFERENCE.md

@@ -25,8 +25,9 @@ engineName            // Name of the engine: 'LittleJS'
 engineVersion         // Version of the engine
 frameRate             // Fixed frame rate for updates (60)
 frame                 // Current update frame
-time                  // Game time since start in seconds (stops when paused)
+time                  // Game time since start in seconds (stops when paused, falls behind the clock below 20 FPS)
 timeReal              // Real time since start in seconds (keeps running when paused; the debug speed keys scale it)
+averageFPS            // Frames drawn per second, smoothed
 timeDelta             // Seconds the update covers: 1/60, or the display frame's time with engineVariableStep
 timeScale = 1         // Game speed, more or fewer fixed updates per second; with engineVariableStep it scales timeDelta
 paused                // Is the game paused? (set with setPaused)
@@ -325,7 +326,9 @@ toggleFullscreen()
 // Shader Object - a custom fragment shader for objects and draws, 2D or 3D
 new Shader(fragmentCode)          // fragmentCode defines void mainImage(out vec4 c, vec2 uv) in the post processing
                                   // style; it gives the surface color, then the object's color and additive color
-                                  // apply in 2D, and the lighting, shadows and fog in 3D
+                                  // apply in 2D, and the lighting, shadows and fog in 3D; in 3D it may also define
+                                  // void mainNormal(inout vec3 n), the world normal after the normal map, to bend
+                                  // it per pixel (waves, ripples) for the lighting, specular and reflection
 obj.shader = shader               // any EngineObject or EngineObject3D; draws that share a Shader share a batch
 shader.dispose()                  // frees its programs and takes it off the engine's list, which keeps every Shader
                                   // for a lost context; for one made each time a scene starts; drawn again it
@@ -686,6 +689,12 @@ EngineObject.clampSpeed    // Hold each axis of velocity to objectMaxSpeed while
                            // while it has a mass, so it can not pass through a thin wall; true by default, false for
                            // a fast bullet that collides; what does not collide moves as fast as it is told
 EngineObject.parent / children // Set by addChild, a child is placed by its parent and sits out solid collision
+EngineObject.isBullet      // Moves through the tiles as a point along a ray, never passing one at any speed and not held
+                           // to objectMaxSpeed for them; collideWithTile sees it where it meets the tile; on a hit it
+                           // bounces by restitution and goes on with the rest of its move, so it rolls along a floor;
+                           // its collision with solid objects is the usual one, so one with a size is still clamped
+EngineObject.oneWay        // Up, down, left or right, like vec2(0, 1): a solid passed through that way, a platform
+                           // jumped up through; it blocks only what was wholly on its far side or stood on it
 
 // Engine Object settings
 enablePhysicsSolver = true    // Enable collisions, between objects and with tiles, and in 3D with solids and the level?
@@ -763,6 +772,12 @@ TileCollisionLayer.collisionTest(pos, size=(0,0), object) // Like tileCollisionT
 TileCollisionLayer.collisionRaycast(posStart, posEnd, object, normal) // Like tileCollisionRaycast for this layer only
 TileCollisionLayer.isSolid = true                   // Solid layers block objects and particles, the solidOnly tests
                                                     // skip the others
+TileCollisionLayer.setOneWay(tile, direction=vec2(0,1)) // The cells drawing that tile index are passed through
+                                                    // moving that way and block only what was wholly on the far
+                                                    // side, objects, particles and rays; turned and mirrored with
+                                                    // each cell's art; vec2(0, 1) is a platform jumped up through
+TileCollisionLayer.oneWayTiles                      // Map of the one way tiles, tile index to direction; delete one
+                                                    // to make it solid again
 tileCollisionGetData(pos, solidOnly=true)           // Get tile collision data at pos
 tileCollisionTest(pos, size=(0,0), object)          // Check if collision should occur
 tileCollisionRaycast(posStart, posEnd, callbackObject, normal, solidOnly=true) // Where the ray meets the first tile hit,
@@ -1134,6 +1149,11 @@ new Light(pos, radius, color=WHITE, fadeRange=radius)
 light.glow = 0          // size across of a soft hazy glow over the light, like a lamp at night, 0 for none; added
                         // over the lit scene after the lightmap, so it shows in the dark, in front of everything
 light.glowFalloff = 1   // how fast the glow fades from its middle, .5 a wide haze, 2 a tight bright core
+light.coneAngle = 0     // a cone, like a flashlight or headlight: radians from its up to the cone's edge, the beam
+                        // twice this across; it looks along getUp(), turned by its angle; 0 shines every way
+light.coneSoftness = .2 // how much of the cone is its fading edge: 0 a hard edge, 1 fading from the middle
+light.gel = tileInfo    // or a whole TextureInfo: a picture the light shines through, across its square, its top
+                        // the way it looks, turned with it, multiplied into its color; shadows still fall
 
 // One directional light, a sun: lights the whole scene from one direction, added with the point lights
 new DirectionalLight(sunDirection=vec2(-1,1), color=WHITE) // toward the sun, as render3D.sunDirection; its color
@@ -1179,6 +1199,7 @@ postProcessBloom(threshold=.6, strength=1, size=6, includeMainCanvas=false) // s
                                // and past a size of 32 it would take hundreds, so that is as wide as it goes
 postProcessBloomShader(threshold, strength, size) // its shader code, to pass to PostProcessPlugin or build on
 postProcess.setShaderCode(shaderCode) // shade with new code from the next frame, to switch effects while running
+postProcess.enabled = true     // false skips the pass, the frame showing as drawn, to turn an effect off and back on
 
 // Built in effects: each is a piece of shader code with its settings written in, working on c, the pixel's color,
 // and uv, where it is on the screen from 0 to 1; postProcessEffects joins pieces in order into one shader, and your
@@ -1333,6 +1354,7 @@ render3D.camera.follow(target, offset, percent=1) // chase camera: ease toward t
                                                   // is how far it moves each call, so call it every frame, from
                                                   // gameUpdatePost once the target has moved
 render3D.camera.align2D = true        // lock to the 2D camera so the z=0 plane matches world space, false by default
+render3D.camera.align2DZ = 0          // the z of the plane align2D lines up, the camera its distance in front
 render3D.camera.getForward() .getRight() .getUp() // the camera's axes as it is right now; render3D.cameraRight
                                                   // .cameraUp .cameraForward are this frame's, read only
 render3D.viewMatrix .projectionMatrix .viewProjection .shadowMatrix // this frame's, rebuilt by updateMatrices()
@@ -1408,7 +1430,8 @@ render3D.shadowLight = flashlight     // a spotlight, a Light3D with a coneAngle
 render3D.shadowRange = 40             // world size the map covers around shadowCenter, smaller is sharper
                                       // it is a square facing the light, so ~1.5x an area's width covers it
 render3D.shadowCenter = undefined // Vector3 center of the shadowed area, read each frame; undefined follows the camera
-render3D.shadowBias = .003 // raise if lit surfaces get speckled with their own shadow, lower if shadows float away
+render3D.shadowBias = .003 // raise if lit surfaces get speckled with their own shadow, lower if shadows float away;
+                           // a share of the map's depth (2 * shadowRange for the sun), so the gap grows with the range
                            // from their casters
 render3D.shadowSoftness = 1           // how far to blur the shadow edge, in shadow map pixels
 
@@ -2264,6 +2287,15 @@ newgrounds.postScore(id, value)      // needs a logged in player and a whole num
 await newgrounds.getScores(id, user, social, skip, limit, period) // the scores are in result.data.scores; period
                                      // 'D' today (the server default), 'W', 'M', 'Y', 'A' all time; a user or social
                                      // narrows it down, and without either it is the whole board even when logged in
+await newgrounds.cloudSave(slot, data) // any value JSON can hold, to a slot numbered from 1, as many as the app's
+                                     // settings give; needs a logged in player; true once saved, false with a
+                                     // warning for a value JSON can not hold
+await newgrounds.cloudLoad(slot)     // the value saved there, null when the slot is empty, undefined when it could
+                                     // not be loaded or the player is not logged in: never save over one undefined
+newgrounds.loadFailure(slot)         // why that slot's last cloudLoad gave undefined: 'notSave' for a file there that
+                                     // is not a save, where a game may offer to start over, else 'failed'; a saved
+                                     // null loads as null, as an empty slot does
+newgrounds.logEvent(name)            // count an event of the game's own, by name, on its stats page
 newgrounds.unlockMedal(id)           // low level request only, the medal is not changed; games call medal.unlock()
 newgrounds.pendingUnlocks            // advanced: the unlocks in flight or waiting to be resent, with their promises
 newgrounds.resendUnlocks()           // advanced: send the ones whose request did not reach the server again now, as
@@ -2308,6 +2340,18 @@ await wavedash.postScore(name, score) // a whole number, milliseconds for a time
 await wavedash.getScores(name, offset=0, limit=10, friendsOnly=false) // the entries as Wavedash gives them,
                                      // undefined off Wavedash or when they could not be read
 wavedash.leaderboards                // each board's id promise by its name
+await wavedash.cloudSave(slot, data) // any value JSON can hold, kept across devices as saves/slot#.json; at most 30
+                                     // saves a minute and 300 an hour, so at checkpoints; true once saved, false
+                                     // with a warning for a value JSON can not hold
+await wavedash.cloudLoad(slot)       // the value saved there, null when the slot is empty, undefined when it could
+                                     // not be loaded or off Wavedash: never save over one that loaded undefined
+wavedash.loadFailure(slot)           // why that slot's last cloudLoad gave undefined: 'notSave' for a file there that
+                                     // is not a save, where a game may offer to start over, else 'failed'; a saved
+                                     // null loads as null, as an empty slot does
+await wavedash.setStat(name, value, storeNow=false) // a stat made in the developer portal, kept a second later or
+                                     // at once; the player's stats load the first time one is used
+await wavedash.getStat(name)         // a stat's value, 0 for one never set or off Wavedash
+await wavedash.setPresence(status, details) // what the player is doing, kept with their presence; none clears it
 ```
 
 ## LittleJS Drawing Utilities

package/dist/littlejs.d.ts

@@ -606,6 +606,8 @@ declare module "littlejsengine" {
      *  @memberof Engine */
     export let frame: number;
     /** Current engine time since start in seconds
+     *  - Below 20 FPS it falls behind the clock, since a frame catches up at most 50 ms of updates, so a timer in
+     *    real seconds, one that must keep up on a slow device, goes by timeReal
      *  @type {number}
      *  @memberof Engine */
     export let time: number;
@@ -613,6 +615,10 @@ declare module "littlejsengine" {
      *  @type {number}
      *  @memberof Engine */
     export let timeReal: number;
+    /** Frames drawn per second, smoothed over the last few seconds, in release builds too
+     *  @type {number}
+     *  @memberof Engine */
+    export let averageFPS: number;
     /** Is the game paused? Causes time and objects to not be updated
      *  @type {boolean}
      *  @default false
@@ -647,7 +653,9 @@ declare module "littlejsengine" {
      *  @param {GameCallback} [gameRender] - Called before objects are rendered, use for drawing backgrounds/world elements
      *  @param {GameCallback} [gameRenderPost] - Called after objects are rendered, use for drawing UI/overlays
      *  @param {Array<string>|string} [imageSources=[]] - List of image file paths to preload (e.g., ['player.png', 'tiles.png']), or one path
-     *  @param {HTMLElement} [rootElement] - Root DOM element to attach canvas to, defaults to document.body
+     *  @param {HTMLElement} [rootElement] - Root DOM element to attach canvas to, defaults to document.body; it is
+     *                                       styled for a game (no scroll bars or selection, touch-action none),
+     *                                       where its own inline style does not say otherwise
      *    It keeps its own inline styles and the canvas centers inside it, but the canvas is still sized from the window,
      *    so set canvasFixedSize or canvasMaxSize to fit a smaller element
      *  @example
@@ -2890,6 +2898,9 @@ declare module "littlejsengine" {
      *   across the sprite or the mesh's own uv
      * - Names in 3D only: worldPos, worldNormal, cameraPos, sunDirection, sunColor, ambientColor, ambientGroundColor,
      *   lightCount, lights[i], lightColors[i] and shadow()
+     * - In 3D the snippet may also define void mainNormal(inout vec3 n), given the normal facing the camera after the
+     *   normal map, in world space, to bend it per pixel for waves or ripples; the lighting, specular, reflection and
+     *   fog then all use it, as they use a normal map
      * - In 3D the shadow map is drawn without the Shader, cut only by the texture's alpha, so a snippet that removes
      *   parts of a surface still shadows with the whole of it
      * @example
@@ -4099,16 +4110,6 @@ declare module "littlejsengine" {
      *  @return {Float32Array} - The audio samples
      *  @memberof Audio */
     export function zzfxG(volume?: number, randomness?: number, frequency?: number, attack?: number, sustain?: number, release?: number, shape?: number, shapeCurve?: number, slide?: number, deltaSlide?: number, pitchJump?: number, pitchJumpTime?: number, repeatTime?: number, noise?: number, modulation?: number, bitCrush?: number, delay?: number, sustainVolume?: number, decay?: number, tremolo?: number, filter?: number): Float32Array;
-    /**
-     * LittleJS Object System
-     * - EngineObject is the base class for all game objects
-     * - Handles automatic updating, rendering, physics, and collision
-     * - Supports parent-child hierarchies with transform inheritance
-     * - 2D physics with velocity, acceleration, damping, and gravity
-     * - Collision system with tiles and other objects
-     * - Renders sprites from tile sheets with color and rotation
-     * - Objects sorted by renderOrder for layered rendering
-     */
     /**
      * LittleJS Object Base Object Class
      * - Top level object class used by the engine
@@ -4208,9 +4209,27 @@ declare module "littlejsengine" {
         children: Array<EngineObject>;
         /** @property {boolean} - Limit object speed along x and y axis */
         clampSpeed: boolean;
+        /** @property {boolean} - Move through the tiles as a point along a ray, so it can not pass through one at
+         *  any speed, for small fast things like bullets: its speed is not held to objectMaxSpeed for the tiles,
+         *  collideWithTile is asked with this.pos where the ray goes into the tile, and on a hit it stops at the
+         *  surface, bounces off it by restitution and goes on with the rest of its move, so it slides along a floor
+         *  - Its collision with solid objects is the usual one, so one with a size that collides with them is still held
+         *    to objectMaxSpeed; one of no size is not, it never collides with them
+         *  - this.pos is set for each tile asked about and put where the move ends after, so a change collideWithTile
+         *    makes to it is not kept; move it after the physics, in update
+         *  - Once destroyed, as by its own collideWithTile, it is asked about no more tiles that frame, where an object
+         *    that is not a bullet still is */
+        isBullet: boolean;
         /** @property {EngineObject|undefined} - Object we are standing on, if any
          *  @type {EngineObject|undefined} */
         groundObject: EngineObject | undefined;
+        /** @property {Vector2|undefined} - Makes a solid object one way, like a platform jumped up through: up, down,
+         *  left or right, the way others pass through it; it blocks only what was wholly on its far side before it
+         *  moved, or stood on it, and the rest are not stopped or asked through collideWithObject; with no mass it
+         *  moves before the other objects each frame, so a lift works the same at any render order; tiles are made one
+         *  way by the layer's setOneWay
+         *  @type {Vector2|undefined} */
+        oneWay: Vector2 | undefined;
         /** @property {EngineObject|undefined} - Parent of object if in local space
          *  @type {EngineObject|undefined} */
         parent: EngineObject | undefined;
@@ -4239,6 +4258,10 @@ declare module "littlejsengine" {
          *    update: a solid an override moves for another object, a lift carrying a crate, is found there from the next
          *    update on */
         updatePhysics(): void;
+        /** @private */
+        private updatePhysicsBullet;
+        /** @private */
+        private updatePhysicsTiles;
         /** Update the object, called automatically by engine once each frame. Does nothing by default */
         update(): void;
         /** Render the object, draws a tile by default, automatically called each frame, sorted by renderOrder */
@@ -4276,10 +4299,10 @@ declare module "littlejsengine" {
         /** Called to check if a tile collision should be resolved. Return true for physics to resolve the collision or false to ignore and resolve it manually
          *  - Called for each solid tile the physics tests, which can be several times a frame for the same tile, and for
          *    positions it only tries, so keep it free of side effects or guard them to once a frame
-         *  - this.pos has already moved, so a check on where it came from, like a one way platform, needs the position
-         *    saved in update, as the platformer example does
-         *  - For the point of impact, like sparks where a bullet hit, raycast from where this frame's move started,
-         *    this.pos minus this.velocity, to this.pos with tileCollisionRaycast, as the platformer's Bullet does
+         *  - this.pos has already moved, so a check on where it came from needs the position saved in update; for a one
+         *    way platform the layer's setOneWay does that, and this is not asked about a one way tile it passes through
+         *  - For the point of impact, like sparks where a bullet hit, set isBullet: this.pos is then where it meets the
+         *    tile, as the platformer's Bullet uses it
          *  @param {number}  tileData - the value of the tile at the position
          *  @param {Vector2} pos - the tile's bottom left corner in world space
          *  @return {boolean} - true if the collision should be resolved by modifying it's position and velocity */
@@ -4701,6 +4724,24 @@ declare module "littlejsengine" {
         /** @property {boolean} - In the light system's shadow pass, cast only from the cells with collision, drawn
          *  as the layer shows them, so a floor in the same layer stays lit; false casts every tile */
         shadowSolidOnly: boolean;
+        /** @property {Map<number, Vector2>} - The tiles set one way, by tile index, and the way each can be passed
+         *  through, see setOneWay
+         *  @type {Map<number, Vector2>} */
+        oneWayTiles: Map<number, Vector2>;
+        /** Make the cells that draw a tile one way, like a platform jumped up through and landed on: an object, a
+         *  particle or a ray passes through moving that way, and the tile blocks only what was wholly on its far side
+         *  before it moved, the side it is passed toward; turned and mirrored as each cell's tile is, so a platform turned
+         *  a quarter is one way to the side
+         *  - A moving object is not stopped or asked through collideWithTile until the tile would block it, so a
+         *    collideWithTile that returns false lets it drop through
+         *  - tileCollisionTest with an object goes by the object's pos, a raycast by its start, and a test with no object
+         *    or with a callback finds every one way tile solid
+         *  @param {number} tile - The tile index, as tile() and TileLayerData take it
+         *  @param {Vector2} [direction] - Up, down, left or right, the way it can be passed through: vec2(0, 1), the
+         *    default, is a platform landed on from above; layer.oneWayTiles.delete(tile) makes the tile solid again
+         *  @example
+         *  layer.setOneWay(5); // tile 5 is a platform, jumped up through and stood on */
+        setOneWay(tile: number, direction?: Vector2): void;
         /** Clear and initialize tile collision, the size is the layer's own, the tile data and canvas keep it
         *  @param {Vector2} size - width and height of tile collision 2d grid */
         initCollision(size: Vector2): void;
@@ -5122,6 +5163,8 @@ declare module "littlejsengine" {
         /** @property {Array<Object>} - Scoreboards fetched from Newgrounds, empty until ready
          *  @type {Array<Object>} */
         scoreboards: Array<any>;
+        /** @type {Map<number, 'failed'|'notSave'>} */
+        loadFailures: Map<number, 'failed' | 'notSave'>;
         /** @property {{id: number, name: string, url: string, supporter: boolean}|null} - The logged in player once ready, null when not logged in
          *  @type {{id: number, name: string, url: string, supporter: boolean}|null} */
         user: {
@@ -5171,6 +5214,42 @@ declare module "littlejsengine" {
          *    result.data.scores, each with user.name, value and formatted_value; without a user or social it is the whole board
          */
         getScores(id: number, user?: string | number, social?: boolean, skip?: number, limit?: number, period?: string): Promise<any>;
+        /** Save a value to one of the player's cloud save slots, which needs a logged in player
+         *  - Any value JSON can hold; the slots are numbered from 1, as many as the app's Newgrounds settings give it
+         *  @param {number} slot - The slot number
+         *  @param {*} data - The value to save
+         *  @return {Promise<boolean>} - Whether it saved, false when not logged in
+         *  @example
+         *  newgrounds.cloudSave(1, {level, coins}); */
+        cloudSave(slot: number, data: any): Promise<boolean>;
+        /** Load the value a cloud save slot holds: null when Newgrounds says it holds none, undefined when it could not be
+         *  loaded or the player is not logged in, said in the console when logged in
+         *  - Do not save over a slot that loaded as undefined, it may hold the player's save; loadFailure(slot) says why
+         *    it did: 'notSave' for a file there that is not a save, where a game may offer to start over, 'failed' otherwise
+         *  - A saved null loads as null, as an empty slot does
+         *  @param {number} slot - The slot number
+         *  @return {Promise<*>} - The value saved, null for none, undefined for a load that failed
+         *  @example
+         *  const save = await newgrounds.cloudLoad(1); */
+        cloudLoad(slot: number): Promise<any>;
+        /** Why a slot's last cloudLoad gave undefined: 'notSave' when the slot holds a file that is not a save, where a
+         *  game may offer to start over, 'failed' when it could not be loaded, as when not logged in, where a game must
+         *  not save over it; undefined when it loaded a save or found the slot empty, or was not loaded
+         *  @param {number} slot - The slot number
+         *  @return {'failed'|'notSave'|undefined} */
+        loadFailure(slot: number): 'failed' | 'notSave' | undefined;
+        /** A slot's load, its value and why it failed, if it did
+         *  @param {number} slot
+         *  @return {Promise<{value: *, failure: 'failed'|'notSave'|undefined}>}
+         *  @ignore */
+        loadSlot(slot: number): Promise<{
+            value: any;
+            failure: 'failed' | 'notSave' | undefined;
+        }>;
+        /** Count an event of the game's own on its Newgrounds stats page, like a level finished or a button pressed
+         *  @param {string} name - The event's name
+         *  @return {Promise<Object>} - The response JSON object, undefined when the call failed */
+        logEvent(name: string): Promise<any>;
         /** Encrypt text the way the Newgrounds gateway expects, AES-128 CBC with a random iv in front, as Base64
          *  @param {string} text
          *  @return {Promise<string>} */
@@ -5199,7 +5278,8 @@ declare module "littlejsengine" {
     }
     /**
      * LittleJS Wavedash Plugin
-     * - The Wavedash twin of the Newgrounds plugin: achievements and leaderboards, the same shape so a game can switch
+     * - The Wavedash twin of the Newgrounds plugin: achievements, leaderboards and cloud saves, the same shape so a game
+     *   can switch, and stats and presence of Wavedash's own
      * - Wavedash serves the game's page and puts its SDK in window.Wavedash before the game runs, so nothing is bundled;
      *   off Wavedash (local, itch, GitHub Pages) there is none, and every call does nothing
      * - Make the plugin when the game can draw, at the end of gameInit: Wavedash.init is called then, and until it is
@@ -5259,6 +5339,14 @@ declare module "littlejsengine" {
         };
         /** @type {number|undefined} */
         achievementRetry: number | undefined;
+        /** @type {Promise<boolean>|undefined} */
+        stats: Promise<boolean> | undefined;
+        /** @type {Map<string, Promise<*>>} */
+        slotQueues: Map<string, Promise<any>>;
+        /** @type {Map<string, Set<Promise<*>>>} */
+        slotCalls: Map<string, Set<Promise<any>>>;
+        /** @type {Map<string, 'failed'|'notSave'>} */
+        loadFailures: Map<string, 'failed' | 'notSave'>;
         /** Whether the game is on Wavedash, its SDK on the page
          *  @return {boolean} */
         isActive(): boolean;
@@ -5287,6 +5375,74 @@ declare module "littlejsengine" {
          *  @param {boolean} [friendsOnly] - Only the player and their friends
          *  @return {Promise<Array<Object>|undefined>} - The entries, as Wavedash gives them */
         getScores(name: string, offset?: number, limit?: number, friendsOnly?: boolean): Promise<Array<any> | undefined>;
+        /** Save a value to one of the player's cloud save slots, kept by Wavedash across devices; off Wavedash it does
+         *  nothing
+         *  - Any value JSON can hold, stored as the file saves/slot#.json
+         *  - Wavedash takes at most 30 saves a minute and 300 an hour from a player, so save at checkpoints, the end of a
+         *    level or when asked, not every frame; one over the limit is refused, said in the console
+         *  @param {number} slot - The slot number, any whole number the game picks
+         *  @param {*} data - The value to save
+         *  @return {Promise<boolean>} - Whether it saved
+         *  @example
+         *  wavedash.cloudSave(1, {level, coins}); */
+        cloudSave(slot: number, data: any): Promise<boolean>;
+        /** Load the value a cloud save slot holds: null when Wavedash says it holds none, undefined when it could not be
+         *  loaded or off Wavedash, said in the console on Wavedash
+         *  - Do not save over a slot that loaded as undefined, it may hold the player's save; loadFailure(slot) says why
+         *    it did: 'notSave' for a file there that is not a save, where a game may offer to start over, 'failed' otherwise
+         *  - A saved null loads as null, as an empty slot does
+         *  @param {number} slot - The slot number
+         *  @return {Promise<*>} - The value saved, null for none, undefined for a load that failed
+         *  @example
+         *  const save = await wavedash.cloudLoad(1); */
+        cloudLoad(slot: number): Promise<any>;
+        /** Why a slot's last cloudLoad gave undefined: 'notSave' when the slot holds a file that is not a save, where a
+         *  game may offer to start over, 'failed' when it could not be loaded, as off Wavedash or on a timeout, where a
+         *  game must not save over it; undefined when it loaded a save or found the slot empty, or was not loaded
+         *  @param {number} slot - The slot number
+         *  @return {'failed'|'notSave'|undefined} */
+        loadFailure(slot: number): 'failed' | 'notSave' | undefined;
+        /** A slot's load, its value and why it failed, if it did
+         *  @param {number} slot
+         *  @param {function(*): *} track
+         *  @return {Promise<{value: *, failure: 'failed'|'notSave'|undefined}>}
+         *  @ignore */
+        loadSlot(slot: number, track: (arg0: any) => any): Promise<{
+            value: any;
+            failure: 'failed' | 'notSave' | undefined;
+        }>;
+        /** Run a slot's save or load after the one before it, as they share the slot's local file; other slots go on
+         *  at once, and one that fails does not hold up the next
+         *  - A call that timed out may still change the file when Wavedash gets to it, so the next waits for it to be
+         *    answered too, and gives up with failed when it is not, leaving the file alone
+         *  @param {number} slot
+         *  @param {*} failed - What the task gives when it can not run
+         *  @param {function(function(*): *): Promise<*>} task - Given track, which keeps a call's answer until it is in
+         *  @return {Promise<*>}
+         *  @ignore */
+        slotQueue(slot: number, failed: any, task: (arg0: (arg0: any) => any) => Promise<any>): Promise<any>;
+        /** Set one of the player's stats, as made for the game in the Wavedash developer portal, which can unlock an
+         *  achievement set to follow it; Wavedash keeps it about a second later, or at once with storeNow; off Wavedash it
+         *  does nothing
+         *  @param {string} name - The stat's identifier
+         *  @param {number} value
+         *  @param {boolean} [storeNow] - Keep it now, as at the end of a game, not a second later
+         *  @return {Promise<boolean>} - Whether Wavedash took it */
+        setStat(name: string, value: number, storeNow?: boolean): Promise<boolean>;
+        /** Read one of the player's stats, 0 for one never set or off Wavedash
+         *  @param {string} name - The stat's identifier
+         *  @return {Promise<number>} */
+        getStat(name: string): Promise<number>;
+        /** The player's stats loaded from Wavedash, which they must be before they are read or set, asked for the first
+         *  time a stat is
+         *  @return {Promise<boolean>} - Whether they loaded
+         *  @ignore */
+        statsLoaded(): Promise<boolean>;
+        /** Set what the player is doing, kept with their presence on Wavedash; off Wavedash it does nothing
+         *  @param {string} [status] - One line of what they are doing, like 'In a race'
+         *  @param {string} [details] - More about it, like 'Lap 2 of 3'; both left out clears it
+         *  @return {Promise<boolean>} - Whether it was set */
+        setPresence(status?: string, details?: string): Promise<boolean>;
         /** Send every unlocked WavedashMedal's achievement Wavedash has not taken yet, again every two seconds while it
          *  refuses some, as it does until it has loaded the player's achievements; one refused for about a minute is
          *  taken as an identifier Wavedash does not have, said once in the console, and not sent again this visit
@@ -5350,6 +5506,9 @@ declare module "littlejsengine" {
         constructor(shaderCode?: string, includeMainCanvas?: boolean, feedbackTexture?: boolean);
         /** @property {string} - The shadertoy style mainImage code it shades with, see setShaderCode */
         shaderCode: string;
+        /** @property {boolean} - Is the pass on? Off, the frame shows as the engine drew it, the shader is kept,
+         *  and the feedback texture holds the last frame drawn with it on */
+        enabled: boolean;
         /** @property {Object<string, number|Array<number>>} - The game's own values for the shader, a uniform each
          *  by its name, a number a float and a list of 2 to 4 numbers a vector, set every frame as they are; an
          *  effect setting can be one of these names, so it changes every frame without making the shader again, all
@@ -5699,11 +5858,16 @@ declare module "littlejsengine" {
      * - A light inside a caster is blocked entirely, so the object that holds it, its lamp, a torch, the player
      *   carrying it, needs a shadowCore that reaches past it, castShadow = false, or a renderShadow that leaves
      *   the light's spot out
+     * - A coneAngle makes it a cone along its up, turned by its angle, and a gel is a picture it shines through; both
+     *   are applied over the round light with its shadows, so they cost next to nothing
      * @extends EngineObject
      * @memberof LightSystem
      * @example
      * new Light(vec2(5, 5), 4, rgb(1, 0.5, 0));        // orange light, full soft blob
      * new Light(vec2(0, 0), 8, rgb(1, 1, 1), 2);       // white core with 2-unit soft halo
+     * const flashlight = new Light(vec2(), 10);        // a flashlight looking right, its beam 60 degrees across
+     * flashlight.coneAngle = PI/6;
+     * flashlight.angle = PI/2;
      */
     export class Light extends EngineObject {
         /** Create a light object and add it to the engine object list
@@ -5728,6 +5892,19 @@ declare module "littlejsengine" {
         glowFalloff: number;
         /** @type {TileInfo|undefined} */
         glowTileInfo: TileInfo | undefined;
+        /** @property {number} - Makes it a cone, like a flashlight or headlight: the angle in radians from its up out
+         *  to the edge of the cone, so the beam is twice this across; it looks along getUp(), turned by its angle and
+         *  by what it is attached to; 0 for a light that shines every way */
+        coneAngle: number;
+        /** @property {number} - How much of the cone is its fading edge: 0 a hard edge, .2 by default, the outer
+         *  fifth, 1 fading all the way from the middle of the beam */
+        coneSoftness: number;
+        /** @property {TileInfo|TextureInfo|undefined} - A gel, a picture the light shines through, called a cookie in
+         *  some engines: stretched across the light's square, twice its radius, its top the way the light looks,
+         *  turned with it, and multiplied into its color, so one light can be a car's headlights and tail lights;
+         *  a TileInfo's own tile, or a whole TextureInfo; shadows still fall through it
+         *  @type {TileInfo|TextureInfo|undefined} */
+        gel: TileInfo | TextureInfo | undefined;
         /** Draw this light's glow, soft and round, its glow size across and in its color, added over the lit scene;
          *  called by LightSystemPlugin after the lightmap is applied */
         renderGlow(): void;
@@ -8054,7 +8231,9 @@ declare module "littlejsengine" {
          *    and 1 with the screen, a Vector2 to follow x and y by different amounts
          *  @param {number} [renderOrder] - Low to draw behind the game, far layers lowest
          *  @param {function(OffscreenCanvasRenderingContext2D, Vector2, ParallaxLayer): void} [drawFunction] - Draws
-         *    the image, given the canvas context, its size in pixels and the layer; mountains when not given
+         *    the image, given the canvas context, its size in pixels and the layer; mountains when not given; called
+         *    once when the layer is made and on redraw(), not each frame, so it draws with the canvas 2D context, not
+         *    the engine's draws like drawTile
          *  @param {Vector2} [canvasSize] - Size of the image in pixels */
         constructor(pos?: Vector2, size?: Vector2, parallax?: number | Vector2, renderOrder?: number, drawFunction?: (arg0: OffscreenCanvasRenderingContext2D, arg1: Vector2, arg2: ParallaxLayer) => void, canvasSize?: Vector2);
         /** @property {Vector2} - How much of the camera's movement it follows on each axis, 0 stays with the world
@@ -8788,7 +8967,8 @@ declare module "littlejsengine" {
      * - EngineObject3D is an EngineObject with a 3D position, rotation and mesh
      * - The 3D scene draws under the 2D sprites, so HUD and text land on top
      * - Lighting is the sun plus ambient, with optional extra lights, fog and shadows
-     * - Any object or draw can bring its own Shader, a mainImage snippet the lighting then applies to
+     * - Any object or draw can bring its own Shader, a mainImage snippet the lighting then applies to, and a
+     *   mainNormal in it bends the normal the lighting uses
      * - Meshes and the basic builders are in render3dMesh.js, EngineObject3D, instancing and lights in
      *   render3dObject.js, both right after this one; the other builders, terrain, particles, camera controls and the
      *   OBJ loader are in the Render3D Extras plugin, which goes after those
@@ -8873,7 +9053,9 @@ declare module "littlejsengine" {
         /** @property {Vector3|undefined} - Center of the shadowed area, read each frame, undefined follows the camera
          *  @type {Vector3|undefined} */
         shadowCenter: Vector3 | undefined;
-        /** @property {number} - Stops surfaces shadowing themselves, raise for speckles, lower if shadows drift off */
+        /** @property {number} - Stops surfaces shadowing themselves, raise for speckles, lower if shadows drift off;
+         *  a share of the shadow map's depth, twice shadowRange for the sun and a spotlight's radius, so the gap behind
+         *  a caster grows with the range as the map's texels do, and the speckles they make stay away */
         shadowBias: number;
         /** @property {number} - How much to blur the shadow edges */
         shadowSoftness: number;
@@ -9417,6 +9599,9 @@ declare module "littlejsengine" {
         /** @property {boolean} - Line the 3D camera up with the 2D camera, so 3D things at z=0 sit on the 2D sprites;
          *  it lines up with the 2D view of the main canvas, whatever canvas size a screenToRay is given */
         align2D: boolean;
+        /** @property {number} - The z of the plane align2D lines up with the 2D view, the camera sitting its
+         *  distance in front of it */
+        align2DZ: number;
         /** Returns the camera's world transform
          *  @return {Matrix4} */
         getMatrix(): Matrix4;