1681-engine 0.5.8 → 0.5.10

package/CHANGELOG.md

@@ -5,6 +5,101 @@ and versions follow [Semantic Versioning](https://semver.org/); before 1.0 a min
 
 ## Unreleased
 
+## 0.5.10
+
+### Added
+
+- **LDtk import**: `parseLdtk` reads a project's levels into the same `TileMap` Tiled maps use, so `TilemapView`,
+  `collisionFromTiled` and `objectsOf` work on them: IntGrid, AutoLayer, Tiles and Entities layers, entity and level
+  fields, tile custom data and enum tags, world layouts, multi-worlds projects and separate `.ldtkl` level files.
+  `levelByName`, `levelAt`, `entitiesOf`, `intGridAt`, `ldtkExternalLevels`, `loadLdtkLevel`;
+  `AssetLoader.ldtk(key, url, { levels })` and `ldtkProject(key)`; `collisionFromIntGrid(grid, solid)`.
+- **Autotiling**: `autotile`, `updateAutotile` and `paintTerrain` on 4-bit edge masks or 47-tile blob masks
+  (`edgeMask`, `blobMask`, `BLOB47_MASKS`, `blob47Index`), with stable variants, fallbacks and `connectsTo`; an edit
+  retiles only its 3x3 neighbourhood. `TilemapView.refreshTiles(layer, cells)` repaints only the chunks touched, and
+  `x`/`y` place a map at a world position. The `ldtk` example.
+- **Ambient life**: `Drift` (leaves, seeds, embers, motes, ash), `Birds`, `Butterflies`, `Fireflies` and
+  `ChimneySmoke`, bounded pools that live only in view on whole pixels, spawned from a `LifeSource` callback
+  (`sourceOf`, `pickInView`) under a `LifeAir`; `paintLifeArt` in `1681-engine/pixel` paints their art.
+- `Haptics` and `HapticGate`: a per-kind rate-limited buzz with an injectable player (`navigator.vibrate` by default).
+- `ApiClient` and `ApiError`: a JSON REST client with a timeout, a bearer token, a 401 refreshed once and retried,
+  status and error hooks, and abort.
+- `Prepainter` and `workerPainter`: big textures painted ahead in a worker for the neighbours of the current key, the
+  rest freed.
+- React kit: `ConfirmButton` (a button asked twice), `useJsonSelector`, `useStoreJson`, the optional label
+  `confirmAgain`.
+- **`1681-engine/updates`**: the pure half of file-by-file web updates from a release store, shared by desktop,
+  browser and phone builds — `LatestJson`/`WebManifest`/`WebFile`, `validManifest`, `planWeb`, `pickWebUpdate`,
+  `apkUpdateOf`, `pluginEntries`, `heldBundle`.
+- **`1681-engine/electron`**, the main-process side of an Electron build: `WebPatcher` (each newer web built beside the
+  running one, checked by sha256, only for the same shell; one that never boots is dropped for the last good one),
+  `shellId`, `SessionStore`/`registerSessionStore` (an OS-encrypted `safeStorage` secret, refused under `basic_text`),
+  `lockDownWindow`, `denyPermissions`, `refuseDebugLaunch` and the pure link rules. Both subpaths ship as ES modules
+  and CommonJS (`dist/cjs`); `electron` is an optional peer dependency that nothing imports.
+- **Browser tests** (`npm run test:browser`, Vitest browser mode on headless Chromium with SwiftShader): WebGL pixels
+  read back, canvas text, `FontFace`, `decodeAudioData`, TexturePacker atlases, silhouettes, `RichText`, `PixelLayer`,
+  `PixelMarks`, `Darkness`, the React `Panel`'s fitting, fullscreen and pointer lock, `Engine.create` and
+  `DrawCallCounter`, in a CI job of their own; `npm run check` stays node-only.
+- Guide page "Desktop: patching, sessions, lockdown"; the tilemap page covers LDtk and autotiling.
+
+### Fixed
+
+- `AssetLoader` names the URL when an image, sprite sheet or atlas page cannot be decoded, and the family and URL when
+  a font cannot be loaded; the browser's bare message named neither.
+
+## 0.5.9
+
+### Added
+
+- **Platform helpers**: `enterFullscreen`/`exitFullscreen`/`toggleFullscreen`/`isFullscreen`/`fullscreenSupported`/
+  `onFullscreenChange` (with webkit fallbacks), `lockOrientation`/`unlockOrientation`/`currentOrientationKind`,
+  `prefersReducedMotion`/`onReducedMotionChange`/`followReducedMotion`, `requestPointerLock`/`exitPointerLock`/
+  `isPointerLocked`/`onPointerLockChange`, `onAppResume` and `timeoutSignal` (an `AbortSignal.timeout` stand-in for
+  older iOS); each does nothing safely where unsupported.
+- `Engine.create({ pauseWhenHidden, followReducedMotion })` (both off by default): pause while the page is hidden with
+  no catch-up steps on return, and copy the system's reduced-motion setting into `engineSettings.reducedFx`.
+  `HiddenPause` holds the rule on its own.
+- **Gamepad rumble**: `rumble`, `rumblePad`, `stopRumble`, `rumbleParams` and `Actions.rumble`. `Pointer` gains
+  `lock`, `unlock`, `locked` and `takeMovement` for mouse-look.
+- **`AssetLoader`** loads `atlas` (TexturePacker/Pixi JSON, hash or array, multipack, trimmed and rotated frames;
+  `getAtlas`), `font` (a `FontFace` into `document.fonts`) and `audio` (`getAudio`/`decodeAudio`, decoded through the
+  sound context or kept until one exists). `parseAtlas`, `collectAtlasPages`, `duplicateFrames`,
+  `TextureRegistry.addAtlas`, `CanvasTexture.addPacked`, `SoundEngine.audioContext`.
+- **`RichText`** (`1681-engine/ui`): inline markup for colour, bold, italic, size and icons, wrapped and aligned, on
+  canvas or bitmap fonts; the pure `parseRichText`, `escapeRichText`, `stripRichText` and `layoutRichText`.
+- **Hit flashes and dash ghosts without a filter pass**: `solidSilhouette`, `fillSolid`, `clearSilhouettes` and pooled
+  `Afterimages`.
+- **Pixel-art zoom maths**: `worldZoom`, `baseZoom`, `zoomSteps`, `zoomResolution`, `fitScale` (whole steps and an
+  optional half step with the resolution that keeps a world pixel whole).
+- `blendLayer`: one container per stage for additive sprites, so they do not split batches.
+- In `1681-engine/pixel`: `spark`, `tail`, `pixelOn`; `PixelMarks` and `aimPixels` (chevron aim lines and lock rings
+  in world pixels).
+- `Connection`: `fatalCloseCodes` (close codes that never reconnect) and `resumeProbeMs` (a socket that does not answer
+  a ping after the app returns from the background is dropped with `CLOSE_NO_ANSWER` and reconnected);
+  `reconnectDelay` and `shouldReconnect`.
+- Guide pages: assets, platform, ECS, rig, tilemaps, audio, rich text, netcode.
+
+### Changed
+
+- Movement numbers no longer need a fork: `MovementParams` takes `dashFlag` and `stepDt` (defaults `INPUT_FLAG_DASH`,
+  1/60 s); the tile size and body half extents were already the grid's. `TILE_SIZE`, `BODY_HALF_*` and
+  `INPUT_FLAG_DASH` are kept as the defaults.
+- `Darkness` takes `{ carriedLight }` (default `CARRIED_LIGHT`, 80) and `update()`'s radius defaults to it; the pixel
+  module no longer imports `net/`.
+- `Clock` runs timers without allocating a frame; a timer that throws is reported to `Clock.onError` and dropped.
+- `DrawCallCounter` counts `drawRangeElements` and leaves a later wrapper in place when it uninstalls.
+- A socket replaced by a newer one no longer emits a stale `close`.
+- The package ships no source maps (`ENGINE_SOURCEMAP=1` builds them; they pointed at an unpublished `src/`) and no
+  longer declares `engines.node`; `Room`, `RoomHost` and `LobbyHost` on a server need Node 22 or later. The tarball went
+  from 931 kB to about 420 kB.
+- Typechecks against pixi.js 8.6, the peer floor, tested in CI along with the examples build. Workflows use v5 actions;
+  publishing pins npm 11 and uses no cache.
+
+### Tests
+
+- Golden bytes for the snapshot codec, cadence, `LobbyRooms`, `Connection`, the platform helpers, sparse sets, field
+  columns, sticks, long press, eases, synth, view culling, touch detection, the spatial hash and transient lights.
+
 ## 0.5.8
 
 ### Added

package/README.md

@@ -76,6 +76,9 @@ pixels. Without it, textures are smooth and drawn at the screen's own density.
 | **Localisation** | `Translator` with the English source as key, contexts, plurals, live switching; `extractStrings`. [Guide](docs/guide/i18n.md) |
 | **Ambient** | `DayClock`, deterministic `weatherAt` and `WeatherLayer`, `ColorGrade`; in `/pixel`, `NightShade`, `SwayProp`, `DitherVignette`. [Guide](docs/guide/ambient.md) |
 | **Game feel** | Pooled `FloatingText` for damage numbers, hit-stop, recoil and flash curves. [Guide](docs/guide/game-feel.md) |
+| **LDtk and autotiling** | LDtk projects (IntGrid, auto-layers, entities with fields, world layouts, level files) read into the same tile map as Tiled; 4-bit and 47-tile blob autotiling that retiles only what an edit touched. [Guide](docs/guide/tilemap.md) |
+| **Ambient life** | Drifting leaves, embers and ash, birds, butterflies, fireflies and chimney smoke, pooled and alive only in view. [Guide](docs/guide/ambient.md) |
+| **Desktop** (`/electron`, `/updates`) | File-by-file web patching by sha256, an OS-encrypted session store and a window lockdown for Electron; the update rules shared with phones. [Guide](docs/guide/desktop.md) |
 | **Diagnostics** | Error capture, WebGL context loss, a boot watch, frame sampling, and a `DebugOverlay` with collision boxes. [Guide](docs/guide/diagnostics-and-debug.md) |
 
 ### A React UI