1681-engine 0.5.8 → 0.5.9

package/dist/ambient/ColorGrade.js

@@ -38,4 +38,3 @@ class c {
 export {
   c as ColorGrade
 };
-//# sourceMappingURL=ColorGrade.js.map

package/dist/ambient/DayClock.js

@@ -54,4 +54,3 @@ export {
   f as mixRgb,
   M as tintNight
 };
-//# sourceMappingURL=DayClock.js.map

package/dist/ambient/WeatherLayer.js

@@ -88,4 +88,3 @@ class c {
 export {
   c as WeatherLayer
 };
-//# sourceMappingURL=WeatherLayer.js.map

package/dist/ambient/grade.js

@@ -10,4 +10,3 @@ export {
   c as gradeAt,
   i as mixToWhite
 };
-//# sourceMappingURL=grade.js.map

package/dist/ambient/weather.js

@@ -49,4 +49,3 @@ export {
   l as hash01,
   w as weatherAt
 };
-//# sourceMappingURL=weather.js.map

package/dist/anim/AnimStateMachine.js

@@ -161,4 +161,3 @@ class v {
 export {
   v as AnimStateMachine
 };
-//# sourceMappingURL=AnimStateMachine.js.map

package/dist/anim/Animator.js

@@ -64,4 +64,3 @@ class r {
 export {
   r as Animator
 };
-//# sourceMappingURL=Animator.js.map

package/dist/anim/animStateCompile.js

@@ -110,4 +110,3 @@ export {
   F as compileStates,
   N as compileTransitions
 };
-//# sourceMappingURL=animStateCompile.js.map

package/dist/anim/animStateSystem.js

@@ -14,4 +14,3 @@ export {
   p as AnimStateComponent,
   u as animStateSystem
 };
-//# sourceMappingURL=animStateSystem.js.map

package/dist/anim/animationSystem.js

@@ -12,4 +12,3 @@ export {
   r as SpriteComponent,
   d as animationSystem
 };
-//# sourceMappingURL=animationSystem.js.map

package/dist/anim/asepriteSlices.js

@@ -19,4 +19,3 @@ export {
   c as sliceBorders,
   r as sliceNamed
 };
-//# sourceMappingURL=asepriteSlices.js.map

package/dist/anim/asepriteTags.js

@@ -32,4 +32,3 @@ export {
   b as tagFrames,
   m as tagRepeat
 };
-//# sourceMappingURL=asepriteTags.js.map

package/dist/anim/parseAseprite.js

@@ -80,4 +80,3 @@ export {
   $ as frameNamed,
   S as parseAseprite
 };
-//# sourceMappingURL=parseAseprite.js.map

package/dist/assets/AssetLoader.js

@@ -1,27 +1,40 @@
-import { parseTiled as h } from "../tilemap/tiled.js";
-function n(r, t) {
+import { sound as u } from "../audio/SoundEngine.js";
+import { parseTiled as f } from "../tilemap/tiled.js";
+import { collectAtlasPages as l, duplicateFrames as w, parseAtlas as p } from "./textureAtlas.js";
+function c(r, t) {
   if (/^[a-z][a-z0-9+.-]*:/i.test(r) || r.startsWith("/")) return r;
   const a = (t.slice(0, t.lastIndexOf("/") + 1) + r).split("/"), s = [];
-  for (const o of a)
-    o === ".." && s.length && s[s.length - 1] !== ".." && s[s.length - 1] !== "" ? s.pop() : o !== "." && s.push(o);
+  for (const i of a)
+    i === ".." && s.length && s[s.length - 1] !== ".." && s[s.length - 1] !== "" ? s.pop() : i !== "." && s.push(i);
   return s.join("/");
 }
-async function c(r) {
+async function m(r) {
   const t = await createImageBitmap(r), e = document.createElement("canvas");
   e.width = t.width, e.height = t.height;
   const a = e.getContext("2d");
   if (!a) throw new Error("AssetLoader: no 2D context (out of canvas memory?)");
   return a.drawImage(t, 0, 0), t.close(), e;
 }
-class u {
+async function g(r, t, e) {
+  if (typeof FontFace > "u" || typeof document > "u" || !document.fonts)
+    throw new Error(`AssetLoader: this browser cannot load the font "${r}" (no FontFace)`);
+  const a = new FontFace(r, t, e);
+  await a.load(), document.fonts.add(a);
+}
+class $ {
   constructor(t, e = {}) {
-    this.textures = t, this.options = e, this.fetcher = e.fetch ?? ((a) => fetch(a)), this.toCanvas = e.toCanvas ?? c;
+    this.textures = t, this.options = e, this.fetcher = e.fetch ?? ((a) => fetch(a)), this.toCanvas = e.toCanvas ?? m;
   }
   textures;
   options;
   queue = [];
   data = /* @__PURE__ */ new Map();
   maps = /* @__PURE__ */ new Map();
+  atlases = /* @__PURE__ */ new Map();
+  /** Decoded audio by key; a key with bytes only waits for a context (`decodeAudio`). */
+  audioBuffers = /* @__PURE__ */ new Map();
+  audioBytes = /* @__PURE__ */ new Map();
+  decoding = /* @__PURE__ */ new Map();
   fetcher;
   toCanvas;
   total = 0;
@@ -50,12 +63,87 @@ class u {
   /** A Tiled JSON map, then every tileset image it names (resolved beside the map file). */
   tilemap(t, e, a = {}) {
     return this.add(t, async () => {
-      const s = h(await (await this.request(e)).json());
+      const s = f(await (await this.request(e)).json());
       this.maps.set(t, s);
-      const o = a.textureKey ?? ((i) => i.name);
-      for (const i of s.tilesets) this.image(o(i), n(i.image, e));
+      const i = a.textureKey ?? ((n) => n.name);
+      for (const n of s.tilesets) this.image(i(n), c(n.image, e));
+    });
+  }
+  /**
+   * A TexturePacker (or Pixi) JSON atlas, hash or array format: its page image, and for a multipack atlas every page
+   * named in `meta.related_multi_packs` (each resolved beside the file naming it). The first page is the texture
+   * `key`, further pages `key~1`, `key~2`…, and every frame of every page is found as `textures.get(key, frameName)`.
+   * Counts as one asset in the progress.
+   */
+  atlas(t, e) {
+    return this.add(t, async () => {
+      const a = this.textures.addAtlas?.bind(this.textures);
+      if (!a) throw new Error(`AssetLoader: the texture sink cannot take atlases (no addAtlas) for "${t}"`);
+      const s = await l(
+        e,
+        async (o) => p(await (await this.request(o)).json(), o),
+        c
+      ), i = await Promise.all(s.map((o) => this.blob(c(o.page.image, o.url)).then((h) => this.toCanvas(h)))), n = w(s.map((o) => o.page));
+      n.length && console.warn(`[assets] atlas "${t}" names ${n.length} frame(s) on more than one page: ${n.slice(0, 5).join(", ")}`), a(t, s.map((o, h) => ({ canvas: i[h], frames: o.page.frames })));
+      const d = {};
+      for (const o of s) Object.assign(d, o.page.animations);
+      this.atlases.set(t, { frames: [...new Set(s.flatMap((o) => o.page.frames.map((h) => h.name)))], animations: d, pages: s.length });
+    });
+  }
+  /**
+   * A web font (woff2, woff, ttf) under `family`, added to `document.fonts` once loaded so canvas text and the DOM can
+   * use it at once — load fonts before the first `Text` is drawn, or it measures with the fallback.
+   */
+  font(t, e, a) {
+    const s = this.options.addFont ?? g;
+    return this.add(t, async () => {
+      await s(t, await this.bytes(e), a);
+    });
+  }
+  /**
+   * A sound file decoded into an `AudioBuffer` through the engine's audio context (`getAudio`). Before any context
+   * exists (browsers open one only after a gesture) the bytes are kept and decoded by `decodeAudio`, so a loading
+   * screen never has to wait for the player to click.
+   */
+  audio(t, e) {
+    return this.add(t, async () => {
+      const a = await this.bytes(e);
+      this.audioBuffers.delete(t), this.decoding.delete(t);
+      const s = (this.options.audioContext ?? (() => u.audioContext))();
+      s ? this.audioBuffers.set(t, await this.decode(s, a, e)) : this.audioBytes.set(t, a);
     });
   }
+  /** A loaded sound, decoded; null while it waits for an audio context (`decodeAudio`). */
+  getAudio(t) {
+    const e = this.audioBuffers.get(t);
+    if (e) return e;
+    if (this.audioBytes.has(t)) return null;
+    throw new Error(`AssetLoader: no audio loaded as "${t}"`);
+  }
+  /** A loaded sound, decoding its kept bytes through `ctx` (default: the loader's context) the first time. */
+  decodeAudio(t, e) {
+    const a = this.audioBuffers.get(t);
+    if (a) return Promise.resolve(a);
+    const s = this.decoding.get(t);
+    if (s) return s;
+    const i = this.audioBytes.get(t);
+    if (!i) return Promise.reject(new Error(`AssetLoader: no audio loaded as "${t}"`));
+    const n = e ?? (this.options.audioContext ?? (() => u.audioContext))();
+    if (!n) return Promise.reject(new Error(`AssetLoader: no audio context to decode "${t}" yet`));
+    const d = this.decode(n, i, t).then(
+      (o) => (this.audioBuffers.set(t, o), this.audioBytes.delete(t), this.decoding.delete(t), o),
+      (o) => {
+        throw this.decoding.delete(t), o;
+      }
+    );
+    return this.decoding.set(t, d), d;
+  }
+  /** What a loaded atlas holds: its frame names and animations. */
+  getAtlas(t) {
+    const e = this.atlases.get(t);
+    if (!e) throw new Error(`AssetLoader: no atlas loaded as "${t}"`);
+    return e;
+  }
   /** Runs everything queued; `onProgress` after each asset. Safe to call again after queueing more. */
   async load(t) {
     const e = Math.max(1, this.options.concurrency ?? 6), a = async () => {
@@ -83,7 +171,7 @@ class u {
     return this.queue.push({ key: t, run: e }), this.total++, this;
   }
   async request(t) {
-    const e = n(t, this.options.baseUrl ?? "");
+    const e = c(t, this.options.baseUrl ?? "");
     let a;
     try {
       a = await this.fetcher(e);
@@ -96,9 +184,19 @@ class u {
   async blob(t) {
     return (await this.request(t)).blob();
   }
+  async bytes(t) {
+    const e = await this.request(t);
+    return typeof e.arrayBuffer == "function" ? e.arrayBuffer() : (await e.blob()).arrayBuffer();
+  }
+  async decode(t, e, a) {
+    try {
+      return await t.decodeAudioData(e.slice(0));
+    } catch (s) {
+      throw new Error(`AssetLoader: could not decode audio ${a}: ${s instanceof Error ? s.message : String(s)}`);
+    }
+  }
 }
 export {
-  u as AssetLoader,
-  n as resolveUrl
+  $ as AssetLoader,
+  c as resolveUrl
 };
-//# sourceMappingURL=AssetLoader.js.map

package/dist/assets/loadAseprite.js

@@ -47,4 +47,3 @@ export {
   p as addAsepriteTextures,
   A as loadAseprite
 };
-//# sourceMappingURL=loadAseprite.js.map

package/dist/assets/takeCleanerWorker-DTcI_Jqr.js

@@ -28,4 +28,3 @@ self.onmessage = (l) => {
   const { id: h, channels: a, sampleRate: f } = l.data, e = m(a, f);
   self.postMessage({ id: h, data: e }, e ? { transfer: [e.buffer] } : void 0);
 };
-//# sourceMappingURL=takeCleanerWorker-DTcI_Jqr.js.map

package/dist/assets/textureAtlas.js

@@ -0,0 +1,58 @@
+function m(n) {
+  const e = n;
+  return typeof e == "object" && e !== null && [e.x, e.y, e.w, e.h].every((t) => typeof t == "number" && Number.isFinite(t));
+}
+function u(n, e, t) {
+  if (!m(e.frame)) throw new Error(`${t}: frame "${n}" has no frame rect`);
+  const o = e.frame, i = e.rotated === !0, a = {
+    name: n,
+    x: Math.floor(o.x),
+    y: Math.floor(o.y),
+    w: Math.floor(i ? o.h : o.w),
+    h: Math.floor(i ? o.w : o.h),
+    rotated: i,
+    sourceW: Math.floor(e.trimmed && e.sourceSize ? e.sourceSize.w : o.w),
+    sourceH: Math.floor(e.trimmed && e.sourceSize ? e.sourceSize.h : o.h)
+  };
+  if (e.trimmed !== !1 && m(e.spriteSourceSize) && e.sourceSize) {
+    const f = e.spriteSourceSize;
+    f.x === 0 && f.y === 0 && o.w === e.sourceSize.w && o.h === e.sourceSize.h || (a.trim = { x: Math.floor(f.x), y: Math.floor(f.y), w: Math.floor(o.w), h: Math.floor(o.h) }, a.sourceW = Math.floor(e.sourceSize.w), a.sourceH = Math.floor(e.sourceSize.h));
+  }
+  const r = e.anchor ?? e.pivot;
+  return r && typeof r.x == "number" && typeof r.y == "number" && (a.anchor = { x: r.x, y: r.y }), a;
+}
+function h(n, e = "atlas") {
+  const t = n;
+  if (typeof t != "object" || t === null || typeof t.frames != "object" || t.frames === null)
+    throw new Error(`${e}: not a TexturePacker JSON atlas (no "frames")`);
+  const o = t.meta?.image;
+  if (typeof o != "string" || o === "") throw new Error(`${e}: no "meta.image"`);
+  const i = Array.isArray(t.frames) ? t.frames.map((s, c) => u(typeof s?.filename == "string" ? s.filename : String(c), s ?? {}, e)) : Object.entries(t.frames).map(([s, c]) => u(s, c ?? {}, e)), a = Array.isArray(t.meta?.related_multi_packs) ? t.meta.related_multi_packs.filter((s) => typeof s == "string" && s !== "") : [], r = {};
+  if (typeof t.animations == "object" && t.animations !== null)
+    for (const [s, c] of Object.entries(t.animations))
+      Array.isArray(c) && (r[s] = c.filter((l) => typeof l == "string"));
+  const f = Number(t.meta?.scale);
+  return { image: o, frames: i, animations: r, related: a, scale: Number.isFinite(f) && f > 0 ? f : 1 };
+}
+async function y(n, e, t) {
+  const o = /* @__PURE__ */ new Set([n]), i = [], a = [n];
+  for (let r = a.shift(); r !== void 0; r = a.shift()) {
+    const f = await e(r);
+    i.push({ url: r, page: f });
+    for (const s of f.related) {
+      const c = t(s, r);
+      o.has(c) || (o.add(c), a.push(c));
+    }
+  }
+  return i;
+}
+function p(n) {
+  const e = /* @__PURE__ */ new Set(), t = /* @__PURE__ */ new Set();
+  for (const o of n) for (const i of o.frames) (e.has(i.name) ? t : e).add(i.name);
+  return [...t];
+}
+export {
+  y as collectAtlasPages,
+  p as duplicateFrames,
+  h as parseAtlas
+};

package/dist/audio/Footsteps.js

@@ -23,4 +23,3 @@ class u {
 export {
   u as Footsteps
 };
-//# sourceMappingURL=Footsteps.js.map

package/dist/audio/MusicPlayer.js

@@ -75,4 +75,3 @@ export {
   a as MusicPlayer,
   w as music
 };
-//# sourceMappingURL=MusicPlayer.js.map

package/dist/audio/SoundEngine.js

@@ -2,8 +2,8 @@ import { engineSettings as m } from "../settings.js";
 import { SampleBank as E, hasTakes as y } from "./sampleBank.js";
 import { SOUNDS as u } from "./soundTable.js";
 import { renderRecipe as R, SYNTH_RATE as k } from "./synth.js";
-const p = 480, _ = 10, q = 6, B = 60, F = 0.45, O = 0.05, w = 80, g = [18e3, 1800], T = { freq: 3500, gainDb: -7 }, V = 11e3;
-class C {
+const p = 480, _ = 10, q = 6, B = 60, F = 0.45, C = 0.05, w = 80, g = [18e3, 1800], T = { freq: 3500, gainDb: -7 }, O = 11e3;
+class V {
   ctx = null;
   master = null;
   buffers = /* @__PURE__ */ new Map();
@@ -32,6 +32,13 @@ class C {
       this.ctx && this.master && this.master.gain.setTargetAtTime(this.level(s.sfxVolume), this.ctx.currentTime, 0.02);
     });
   }
+  /**
+   * The effects' audio context once something opened it (the first gesture does), else null: never created here, so
+   * asking does not open a context the browser would hold suspended. `AssetLoader.audio` decodes through it.
+   */
+  get audioContext() {
+    return this.ctx;
+  }
   play(t, n = {}) {
     if (!t || !u.recipes[t] && !y(t) || m.getState().sfxVolume <= 0) return;
     const e = this.ctx;
@@ -53,7 +60,7 @@ class C {
     v && (i *= u.recipes[t]?.fileGain ?? 1), this.lastAt.set(t, x);
     const c = e.createBufferSource();
     c.buffer = l;
-    const S = u.recipes[t]?.jitter ?? O;
+    const S = u.recipes[t]?.jitter ?? C;
     c.playbackRate.value = 1 + (Math.random() * 2 - 1) * S;
     const a = e.createGain();
     a.gain.value = Math.min(1, i);
@@ -79,7 +86,7 @@ class C {
     const t = this.ctx.createBiquadFilter();
     t.type = "highshelf", t.frequency.value = T.freq, t.gain.value = T.gainDb;
     const n = this.ctx.createBiquadFilter();
-    n.type = "lowpass", n.frequency.value = V, this.master.connect(t).connect(n).connect(this.ctx.destination);
+    n.type = "lowpass", n.frequency.value = O, this.master.connect(t).connect(n).connect(this.ctx.destination);
     const e = this.ctx, i = () => {
       const s = e.state === "running";
       this.onRunning(s), s && this.prerender(e);
@@ -111,9 +118,8 @@ class C {
     return this.buffers.set(n, s), s;
   }
 }
-const H = new C();
+const H = new V();
 export {
-  C as SoundEngine,
+  V as SoundEngine,
   H as sound
 };
-//# sourceMappingURL=SoundEngine.js.map

package/dist/audio/cleanTake.js

@@ -27,4 +27,3 @@ function L(c, h) {
 export {
   L as cleanSamples
 };
-//# sourceMappingURL=cleanTake.js.map

package/dist/audio/music/ElementVoice.js

@@ -32,4 +32,3 @@ class m {
 export {
   m as ElementVoice
 };
-//# sourceMappingURL=ElementVoice.js.map

package/dist/audio/music/GraphVoice.js

@@ -36,4 +36,3 @@ class h {
 export {
   h as GraphVoice
 };
-//# sourceMappingURL=GraphVoice.js.map

package/dist/audio/music/MusicChannel.js

@@ -55,4 +55,3 @@ class h {
 export {
   h as MusicChannel
 };
-//# sourceMappingURL=MusicChannel.js.map

package/dist/audio/music/musicVoice.js

@@ -10,4 +10,3 @@ export {
   o as clamp01,
   n as elementVolumeLocked
 };
-//# sourceMappingURL=musicVoice.js.map

package/dist/audio/sampleBank.js

@@ -79,4 +79,3 @@ export {
   y as hasTakes,
   k as registerTakes
 };
-//# sourceMappingURL=sampleBank.js.map

package/dist/audio/soundTable.js

@@ -6,4 +6,3 @@ export {
   s as SOUNDS,
   r as registerSounds
 };
-//# sourceMappingURL=soundTable.js.map

package/dist/audio/synth.js

@@ -33,4 +33,3 @@ export {
   Y as SYNTH_RATE,
   _ as renderRecipe
 };
-//# sourceMappingURL=synth.js.map

package/dist/core/BitmapLabel.js

@@ -46,4 +46,3 @@ export {
   w as addLabelGlyphs,
   b as installLabelFont
 };
-//# sourceMappingURL=BitmapLabel.js.map

package/dist/core/Camera.js

@@ -8,7 +8,7 @@ class g {
   zoom = 1;
   /** The zoom `reset` goes back to: the engine sets it from its `zoom` option (default 1). */
   defaultZoom = 1;
-  /** Backing pixels per screen pixel (the renderer's resolution, `zoomResolution`): what `snap` rounds to. */
+  /** Backing pixels per screen pixel (the renderer's resolution, `zoomResolution(zoom, devicePixelRatio)`): what `snap` rounds to. */
   resolution = 1;
   /** Lands the view on whole backing pixels (pixel art); off, the world moves smoothly between them. */
   roundPixels = !1;
@@ -147,4 +147,3 @@ class g {
 export {
   g as Camera
 };
-//# sourceMappingURL=Camera.js.map

package/dist/core/Clock.js

@@ -1,30 +1,40 @@
-class o {
+import { runDue as o } from "./runDue.js";
+class i {
+  constructor(e, r) {
+    this.at = e, this.fn = r;
+  }
+  at;
+  fn;
+  removed = !1;
+  /** An arrow, so a handle's `remove` still works when taken off it (`const { remove } = …`). */
+  remove = () => {
+    this.removed = !0;
+  };
+}
+class h {
   now = performance.now();
+  /** Told of every error a timer throws (default: logged). `Stage` routes it into its guarded-step reporting. */
+  onError = (e) => console.error("[timer] failed", e);
   timers = [];
-  delayedCall(r, t) {
-    const e = { at: this.now + r, fn: t, removed: !1 };
-    return this.timers.push(e), { remove: () => {
-      e.removed = !0;
-    } };
+  due = [];
+  /** Made once, so `update` hands `runDue` no fresh closure; reads `onError` late so it may be swapped any time. */
+  report = (e) => this.onError(e);
+  delayedCall(e, r) {
+    const t = new i(this.now + e, r);
+    return this.timers.push(t), t;
+  }
+  /** Timers waiting to run (removed ones not yet swept included). */
+  get pending() {
+    return this.timers.length;
   }
-  update(r) {
-    this.now = r;
-    const t = this.timers.filter((e) => !e.removed && e.at <= r);
-    if (t.length) {
-      this.timers = this.timers.filter((e) => !e.removed && e.at > r);
-      for (const e of t)
-        try {
-          e.fn();
-        } catch (s) {
-          console.error("[timer] failed", s);
-        }
-    }
+  update(e) {
+    this.now = e, o(this.timers, this.due, e, this.report);
   }
   clear() {
-    this.timers = [];
+    for (const e of this.due) e.removed = !0;
+    this.timers.length = 0;
   }
 }
 export {
-  o as Clock
+  h as Clock
 };
-//# sourceMappingURL=Clock.js.map

package/dist/core/Graphics.js

@@ -66,4 +66,3 @@ class u extends o(n) {
 export {
   u as Graphics
 };
-//# sourceMappingURL=Graphics.js.map

package/dist/core/Group.js

@@ -26,4 +26,3 @@ class a extends i(r) {
 export {
   a as Group
 };
-//# sourceMappingURL=Group.js.map

package/dist/core/Image.js

@@ -48,4 +48,3 @@ class o extends a(h) {
 export {
   o as Image
 };
-//# sourceMappingURL=Image.js.map

package/dist/core/ObjectFactory.js

@@ -52,4 +52,3 @@ class L {
 export {
   L as ObjectFactory
 };
-//# sourceMappingURL=ObjectFactory.js.map

package/dist/core/Pointer.js

@@ -1,25 +1,26 @@
-import { isTouchUi as b } from "../platform/touch.js";
-function s(r) {
-  return r === 1 ? 4 : r === 2 ? 2 : r === 0 ? 1 : 0;
+import { isTouchUi as v } from "../platform/touch.js";
+import { isPointerLocked as m, requestPointerLock as d, exitPointerLock as a } from "../platform/pointerLock.js";
+function s(e) {
+  return e === 1 ? 4 : e === 2 ? 2 : e === 0 ? 1 : 0;
 }
-class l {
-  constructor(n) {
-    this.canvas = n;
-    const i = b(), o = (t, e, c) => {
-      const h = (u) => {
-        i && u instanceof PointerEvent && u.pointerType === "touch" || c(u);
+class c {
+  constructor(o) {
+    this.canvas = o;
+    const i = v(), n = (t, u, l) => {
+      const h = (r) => {
+        i && r instanceof PointerEvent && r.pointerType === "touch" || l(r);
       };
-      t.addEventListener(e, h), this.cleanup.push(() => t.removeEventListener(e, h));
+      t.addEventListener(u, h), this.cleanup.push(() => t.removeEventListener(u, h));
     };
-    o(n, "pointerdown", (t) => {
-      this.track(t), !l.ignorePress?.(t) && (this.buttons |= s(t.button));
-    }), o(window, "pointermove", (t) => {
-      this.track(t), t.button >= 0 && (this.buttons = (t.buttons & s(t.button)) !== 0 ? this.buttons | s(t.button) : this.buttons & ~s(t.button));
-    }), o(window, "pointerup", (t) => {
+    n(o, "pointerdown", (t) => {
+      this.track(t), !c.ignorePress?.(t) && (this.buttons |= s(t.button));
+    }), n(window, "pointermove", (t) => {
+      this.locked ? (this.moveX += t.movementX, this.moveY += t.movementY) : this.track(t), t.button >= 0 && (this.buttons = (t.buttons & s(t.button)) !== 0 ? this.buttons | s(t.button) : this.buttons & ~s(t.button));
+    }), n(window, "pointerup", (t) => {
       this.buttons &= ~s(t.button);
-    }), o(window, "blur", () => {
+    }), n(window, "blur", () => {
       this.buttons = 0;
-    }), o(n, "contextmenu", (t) => t.preventDefault());
+    }), n(o, "contextmenu", (t) => t.preventDefault());
   }
   canvas;
   /**
@@ -33,6 +34,9 @@ class l {
   worldX = 0;
   worldY = 0;
   buttons = 0;
+  /** Raw mouse travel (`movementX/Y`) summed since the last `takeMovement`, kept only while the pointer is locked. */
+  moveX = 0;
+  moveY = 0;
   cleanup = [];
   leftButtonDown() {
     return (this.buttons & 1) !== 0;
@@ -40,19 +44,37 @@ class l {
   rightButtonDown() {
     return (this.buttons & 2) !== 0;
   }
-  updateWorldPoint(n) {
-    this.worldX = n.scrollX + this.x / n.zoom, this.worldY = n.scrollY + this.y / n.zoom;
+  /** True while the canvas holds the pointer (`lock`). */
+  get locked() {
+    return m(this.canvas);
+  }
+  /**
+   * Locks the pointer to the canvas for mouse-look: the cursor hides and `takeMovement` returns how far the mouse went.
+   * Call from a press or key handler (browsers allow it only in a gesture); resolves whether the lock holds.
+   */
+  lock(o = {}) {
+    return this.moveX = this.moveY = 0, d(this.canvas, o);
+  }
+  unlock() {
+    this.locked && a();
+  }
+  /** The mouse travel (CSS pixels) since the last call while locked, then zeroed; read it once per step. */
+  takeMovement() {
+    const o = { x: this.moveX, y: this.moveY };
+    return this.moveX = this.moveY = 0, o;
+  }
+  updateWorldPoint(o) {
+    this.worldX = o.scrollX + this.x / o.zoom, this.worldY = o.scrollY + this.y / o.zoom;
   }
   destroy() {
-    for (const n of this.cleanup) n();
+    for (const o of this.cleanup) o();
     this.cleanup.length = 0;
   }
-  track(n) {
+  track(o) {
     const i = this.canvas.getBoundingClientRect();
-    this.x = n.clientX - i.left, this.y = n.clientY - i.top;
+    this.x = o.clientX - i.left, this.y = o.clientY - i.top;
   }
 }
 export {
-  l as Pointer
+  c as Pointer
 };
-//# sourceMappingURL=Pointer.js.map

package/dist/core/Rectangle.js

@@ -48,4 +48,3 @@ class c extends l(e) {
 export {
   c as Rectangle
 };
-//# sourceMappingURL=Rectangle.js.map