1681-engine 0.6.5 → 0.6.7

package/CHANGELOG.md

@@ -3,6 +3,36 @@
 All notable changes to this package are written here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and versions follow [Semantic Versioning](https://semver.org/); before 1.0 a minor version may break the API.
 
+## 0.6.7
+
+### Added
+
+- `Group.keepAbove` / `keepBelow`: keep a child on one side of another, moved only when it is on the wrong side. Two
+  pieces each placed *directly* above one body with `moveAbove` (two blades, a fist on a hilt) pushed each other out
+  every frame, and every push rebuilt Pixi's draw instructions.
+
+### Changed
+
+- The world layer sorts by depth once a frame (`deferDepthSort`, `flushDepthSorts`, run by `Stage.frame` after the
+  camera): a child's `zIndex` changing only notes the container, and the children are sorted — the render group's
+  structure marked changed — only when they are out of order. Pixi marked the structure changed at every `zIndex`
+  change, so a world sorted by its bodies' feet rebuilt every draw instruction every frame anything walked up or down
+  the screen. A container not handed over keeps Pixi's own behaviour.
+
+## 0.6.6
+
+### Added
+
+- `TextureRegistry.addView(key, page, x, y, w, h)`: a key that is one rect of another texture, on that texture's own
+  source (`CanvasTexture`'s `view`), so pieces swapped every few frames batch together.
+
+### Changed
+
+- `paintLifeArt` lays every piece of the ambient life (leaves, seeds, embers, motes, ash, butterflies, birds,
+  fireflies, smoke) on one page and registers each key as a view of it (`packShelves`). A canvas each made every flap
+  of a butterfly or puff of smoke a texture of another source, and Pixi rebuilt the world's draw instructions at each.
+  The keys and `LifeArt` are unchanged.
+
 ## 0.6.5
 
 ### Changed

package/dist/core/Group.js

@@ -22,6 +22,18 @@ class d extends r(i) {
   moveBelow(t, e) {
     return t.parent !== this || e.parent !== this || t === e ? this : this.getChildIndex(t) === this.getChildIndex(e) - 1 ? this : (this.removeChild(t), this.addChildAt(t, this.getChildIndex(e)), this);
   }
+  /**
+   * Keeps `child` drawn above `other`, anywhere above it: moved (directly above) only when it is below. What a weapon
+   * held over its body asks for. `moveAbove` from two pieces each wanting to sit *directly* above the same body (two
+   * blades, a fist on a hilt, a load) pushed the other out every frame, and every push rebuilt Pixi's instructions.
+   */
+  keepAbove(t, e) {
+    return t.parent !== this || e.parent !== this || t === e ? this : this.getChildIndex(t) > this.getChildIndex(e) ? this : this.moveAbove(t, e);
+  }
+  /** Keeps `child` drawn below `other`, anywhere below it: moved (directly below) only when it is above (`keepAbove`). */
+  keepBelow(t, e) {
+    return t.parent !== this || e.parent !== this || t === e ? this : this.getChildIndex(t) < this.getChildIndex(e) ? this : this.moveBelow(t, e);
+  }
   /** Puts `child` directly above `other` in the draw order; already there, it does nothing (see `moveBelow`). */
   moveAbove(t, e) {
     return t.parent !== this || e.parent !== this || t === e ? this : this.getChildIndex(t) === this.getChildIndex(e) + 1 ? this : (this.removeChild(t), this.addChildAt(t, this.getChildIndex(e) + 1), this);

package/dist/core/Stage.js

@@ -1,13 +1,14 @@
 import { Container as s } from "pixi.js";
 import { Camera as n } from "./Camera.js";
 import { Clock as a } from "./Clock.js";
-import { ObjectFactory as o } from "./ObjectFactory.js";
-import { PixelGrid as d } from "./PixelGrid.js";
-import { Pointer as c } from "./Pointer.js";
-import { Tweener as m } from "./Tweener.js";
+import { deferDepthSort as o, flushDepthSorts as d } from "./depthSort.js";
+import { ObjectFactory as c } from "./ObjectFactory.js";
+import { PixelGrid as m } from "./PixelGrid.js";
+import { Pointer as p } from "./Pointer.js";
+import { Tweener as u } from "./Tweener.js";
 class h {
   constructor(t, e) {
-    this.app = t, this.textures = e, t.stage.addChild(this.world, this.screen), this.cameras = { main: new n(this.world, this.screen) }, this.input = { activePointer: new c(t.canvas) }, this.grid = new d(t, this.world), this.time.onError = (i) => this.caught("timers", i), this.syncSize();
+    this.app = t, this.textures = e, t.stage.addChild(this.world, this.screen), o(this.world), this.cameras = { main: new n(this.world, this.screen) }, this.input = { activePointer: new p(t.canvas) }, this.grid = new m(t, this.world), this.time.onError = (i) => this.caught("timers", i), this.syncSize();
   }
   app;
   textures;
@@ -15,8 +16,8 @@ class h {
   static onCaught = null;
   world = new s({ sortableChildren: !0 });
   screen = new s();
-  add = new o(this);
-  tweens = new m();
+  add = new c(this);
+  tweens = new u();
   time = new a();
   cameras;
   input;
@@ -61,7 +62,7 @@ class h {
    */
   frame(t) {
     const e = performance.now();
-    this.guard("resize", () => this.syncSize()), this.guard("update", () => this.update(e, t)), this.guard("tweens", () => this.tweens.update(t)), this.guard("timers", () => this.time.update(e)), this.guard("camera", () => this.cameras.main.apply(e)), (this.pixelPerfect || this.gridLive) && (this.gridLive = this.pixelPerfect, this.guard("pixel grid", () => this.grid.render(this.cameras.main, this.pixelPerfect, this.pixelDensity)));
+    this.guard("resize", () => this.syncSize()), this.guard("update", () => this.update(e, t)), this.guard("tweens", () => this.tweens.update(t)), this.guard("timers", () => this.time.update(e)), this.guard("camera", () => this.cameras.main.apply(e)), this.guard("depth", d), (this.pixelPerfect || this.gridLive) && (this.gridLive = this.pixelPerfect, this.guard("pixel grid", () => this.grid.render(this.cameras.main, this.pixelPerfect, this.pixelDensity)));
   }
   /**
    * Keeps a piece of text made outside `add.text`/`add.label` (put on the world any way) at screen resolution while the

package/dist/core/TextureRegistry.js

@@ -1,25 +1,26 @@
-import { CanvasSource as f, Texture as d, Rectangle as u } from "pixi.js";
-class v {
-  constructor(t, s) {
-    this.key = t, this.canvas = s, this.source = new f({ resource: s, scaleMode: "nearest" }), this.whole = new d({ source: this.source });
+import { CanvasSource as m, Texture as c, Rectangle as u } from "pixi.js";
+class f {
+  constructor(t, s, e) {
+    this.key = t, this.canvas = s, this.owned = !e, this.source = e?.source ?? new m({ resource: s, scaleMode: "nearest" }), this.whole = e ? new c({ source: this.source, frame: e.frame }) : new c({ source: this.source });
   }
   key;
   canvas;
   frames = /* @__PURE__ */ new Map();
   source;
   whole;
+  owned;
   get width() {
-    return this.canvas.width;
+    return this.owned ? this.canvas.width : this.whole.frame.width;
   }
   get height() {
-    return this.canvas.height;
+    return this.owned ? this.canvas.height : this.whole.frame.height;
   }
   get context() {
     return this.canvas.getContext("2d");
   }
   /** Adds a frame cut from the canvas (`_source` kept for the old call shape). */
-  add(t, s, e, a, n, i) {
-    this.frames.get(t)?.destroy(), this.frames.set(t, new d({ source: this.source, frame: new u(e, a, n, i) }));
+  add(t, s, e, a, i, h) {
+    this.frames.get(t)?.destroy(), this.frames.set(t, new c({ source: this.source, frame: new u(e, a, i, h) }));
   }
   /**
    * Adds a packed frame cut from `page` (this texture's canvas by default): trimmed frames keep their untrimmed size
@@ -27,7 +28,7 @@ class v {
    */
   addPacked(t, s = this) {
     this.frames.get(t.name)?.destroy();
-    const e = new d({
+    const e = new c({
       source: s.source,
       frame: new u(t.x, t.y, t.w, t.h),
       orig: new u(0, 0, t.sourceW, t.sourceH),
@@ -43,17 +44,17 @@ class v {
    */
   adopt(t, s) {
     const e = s.frames.get(t);
-    e && (this.frames.get(t)?.destroy(), this.frames.set(t, new d({ source: s.source, frame: e.frame.clone() })));
+    e && (this.frames.get(t)?.destroy(), this.frames.set(t, new c({ source: s.source, frame: e.frame.clone() })));
   }
   refresh() {
     this.source.update();
   }
   destroy() {
     for (const t of this.frames.values()) t.destroy();
-    this.frames.clear(), this.whole.destroy(), this.source.destroy();
+    this.frames.clear(), this.whole.destroy(), this.owned && this.source.destroy();
   }
 }
-class m {
+class v {
   textures = /* @__PURE__ */ new Map();
   /** Textures repainted or freed while in use (a rig body, its hand): a copy of one must snapshot it first. */
   live = /* @__PURE__ */ new Set();
@@ -67,42 +68,42 @@ class m {
   }
   /** A new texture holding frame `frame` of `key` as it is painted right now; returns its key (one frame, '0'). */
   snapshot(t, s) {
-    const e = this.get(t, s), { x: a, y: n, width: i, height: r } = e.frame, h = document.createElement("canvas");
-    h.width = i, h.height = r;
+    const e = this.get(t, s), { x: a, y: i, width: h, height: r } = e.frame, n = document.createElement("canvas");
+    n.width = h, n.height = r;
     const o = this.textures.get(t)?.canvas;
-    o && h.getContext("2d").drawImage(o, a, n, i, r, 0, 0, i, r);
-    const c = `${t}#still${++this.snapshots}`;
-    return this.addCanvas(c, h).add("0", 0, 0, 0, i, r), c;
+    o && n.getContext("2d").drawImage(o, a, i, h, r, 0, 0, h, r);
+    const d = `${t}#still${++this.snapshots}`;
+    return this.addCanvas(d, n).add("0", 0, 0, 0, h, r), d;
   }
   /**
    * `snapshot` into a texture kept for reuse (`into`): its canvas is repainted in place and uploaded again, and only
    * made anew when the frame's size changes. Frame '0' is the copy.
    */
   snapshotInto(t, s, e) {
-    const a = this.get(t, s), { x: n, y: i, width: r, height: h } = a.frame;
+    const a = this.get(t, s), { x: i, y: h, width: r, height: n } = a.frame;
     let o = this.textures.get(e);
-    if (!o || o.width !== r || o.height !== h) {
+    if (!o || o.width !== r || o.height !== n) {
       const g = document.createElement("canvas");
-      g.width = r, g.height = h, o = this.addCanvas(e, g), o.add("0", 0, 0, 0, r, h);
+      g.width = r, g.height = n, o = this.addCanvas(e, g), o.add("0", 0, 0, 0, r, n);
     }
-    const c = o.context;
-    c.clearRect(0, 0, r, h);
+    const d = o.context;
+    d.clearRect(0, 0, r, n);
     const w = this.textures.get(t)?.canvas;
-    w && c.drawImage(w, n, i, r, h, 0, 0, r, h), o.refresh();
+    w && d.drawImage(w, i, h, r, n, 0, 0, r, n), o.refresh();
   }
   exists(t) {
     return this.textures.has(t);
   }
   addCanvas(t, s) {
     this.remove(t);
-    const e = new v(t, s);
+    const e = new f(t, s);
     return this.textures.set(t, e), e;
   }
   /** A canvas cut into equal frames named 0, 1, 2... left to right, then row by row. */
   addSpriteSheet(t, s, e) {
-    const a = this.addCanvas(t, s), n = Math.floor(s.width / e.frameWidth), i = Math.floor(s.height / e.frameHeight);
-    for (let r = 0; r < n * i; r++)
-      a.add(String(r), 0, r % n * e.frameWidth, Math.floor(r / n) * e.frameHeight, e.frameWidth, e.frameHeight);
+    const a = this.addCanvas(t, s), i = Math.floor(s.width / e.frameWidth), h = Math.floor(s.height / e.frameHeight);
+    for (let r = 0; r < i * h; r++)
+      a.add(String(r), 0, r % i * e.frameWidth, Math.floor(r / i) * e.frameHeight, e.frameWidth, e.frameHeight);
     return a;
   }
   /**
@@ -114,12 +115,23 @@ class m {
     for (let a = 1; this.textures.has(`${t}~${a}`); a++)
       this.remove(`${t}~${a}`);
     const e = this.addCanvas(t, s[0].canvas);
-    return s.forEach((a, n) => {
-      const i = n === 0 ? e : this.addCanvas(`${t}~${n}`, a.canvas);
+    return s.forEach((a, i) => {
+      const h = i === 0 ? e : this.addCanvas(`${t}~${i}`, a.canvas);
       for (const r of a.frames)
-        i !== e && i.addPacked(r), e.addPacked(r, i);
+        h !== e && h.addPacked(r), e.addPacked(r, h);
     }), e;
   }
+  /**
+   * Registers `key` as the rect (x, y, w, h) of the texture `page`, on the page's source: shown by `setTexture(key)`
+   * like any texture, and batched with every other view of that page. Null when the page is not registered.
+   */
+  addView(t, s, e, a, i, h) {
+    const r = this.textures.get(s);
+    if (!r) return null;
+    this.remove(t);
+    const n = new f(t, r.canvas, { source: r.source, frame: new u(e, a, i, h) });
+    return this.textures.set(t, n), n;
+  }
   createCanvas(t, s, e) {
     const a = document.createElement("canvas");
     return a.width = s, a.height = e, this.addCanvas(t, a);
@@ -132,10 +144,10 @@ class m {
     return e ? s === void 0 || s === "" ? e.whole : e.frames.get(String(s)) ?? this.warn(`${t}/${s}`) : this.warn(t);
   }
   warn(t) {
-    return this.missing.has(t) || (this.missing.add(t), console.warn(`[textures] missing ${t}`)), d.EMPTY;
+    return this.missing.has(t) || (this.missing.add(t), console.warn(`[textures] missing ${t}`)), c.EMPTY;
   }
 }
 export {
-  v as CanvasTexture,
-  m as TextureRegistry
+  f as CanvasTexture,
+  v as TextureRegistry
 };

package/dist/core/depthSort.js

@@ -0,0 +1,44 @@
+import { Container as c } from "pixi.js";
+const s = /* @__PURE__ */ new WeakSet(), d = /* @__PURE__ */ new Set();
+let f = !1;
+function p() {
+  if (f) return;
+  f = !0;
+  const e = c.prototype, r = e.depthOfChildModified;
+  e.depthOfChildModified = function() {
+    const t = this.parent;
+    if (t && s.has(t)) {
+      const n = t;
+      n.sortableChildren = !0, n.sortDirty = !0, d.add(t);
+      return;
+    }
+    r.call(this);
+  };
+}
+function h(e) {
+  p(), s.add(e);
+}
+function l() {
+  for (const e of d) {
+    if (e.destroyed) continue;
+    const r = e, o = e.children;
+    let t = !0;
+    for (let i = 1; i < o.length; i++)
+      if (o[i - 1].zIndex > o[i].zIndex) {
+        t = !1;
+        break;
+      }
+    if (t) {
+      r.sortDirty = !1;
+      continue;
+    }
+    r.sortChildren();
+    const n = r.renderGroup ?? r.parentRenderGroup;
+    n && (n.structureDidChange = !0);
+  }
+  d.clear();
+}
+export {
+  h as deferDepthSort,
+  l as flushDepthSorts
+};

package/dist/pixel/lifeArt.js

@@ -1,4 +1,4 @@
-const F = {
+const M = {
   leaves: [
     ["#7ab04e", "#3d7a36"],
     ["#d8a040", "#9a5a24"]
@@ -22,62 +22,77 @@ const F = {
   firefly: ["#f0ff9a", "#a8c850"],
   smoke: ["#b8b0b4", "#9a9296", "#7c7478"]
 }, v = 6;
-function L(o, e) {
+function O(o, b) {
   const l = Number.parseInt(o.replace("#", ""), 16);
-  return `rgba(${l >> 16 & 255},${l >> 8 & 255},${l & 255},${e})`;
+  return `rgba(${l >> 16 & 255},${l >> 8 & 255},${l & 255},${b})`;
 }
-function M(o, e = F.smoke) {
-  const l = [[2, 2], [3, 3], [4, 3], [5, 4], [6, 5], [7, 5]], [s, n] = l[Math.max(0, Math.min(v - 1, o))], [b, _, p] = e, h = [], y = (s - 1) / 2, u = (n - 1) / 2, S = o < 3 ? 0.9 : o < 5 ? 0.78 : 0.62;
-  for (let a = 0; a < n; a++)
-    for (let r = 0; r < s; r++) {
-      const $ = (r - y) / (s / 2), m = (a - u) / (n / 2), g = (r * 7 + a * 13 + o * 5) % 5 / 10;
-      if ($ * $ + m * m > 0.85 + g || o >= v - 2 && (r + a + o) % 2) continue;
-      const w = $ + m, d = w < -0.35 ? b : w > 0.45 ? p : _;
-      h.push([r, a, d.startsWith("#") ? L(d, S) : d]);
+function P(o, b = M.smoke) {
+  const l = [[2, 2], [3, 3], [4, 3], [5, 4], [6, 5], [7, 5]], [n, c] = l[Math.max(0, Math.min(v - 1, o))], [h, t, _] = b, p = [], f = (n - 1) / 2, m = (c - 1) / 2, $ = o < 3 ? 0.9 : o < 5 ? 0.78 : 0.62;
+  for (let d = 0; d < c; d++)
+    for (let r = 0; r < n; r++) {
+      const e = (r - f) / (n / 2), y = (d - m) / (c / 2), k = (r * 7 + d * 13 + o * 5) % 5 / 10;
+      if (e * e + y * y > 0.85 + k || o >= v - 2 && (r + d + o) % 2) continue;
+      const g = e + y, u = g < -0.35 ? h : g > 0.45 ? _ : t;
+      p.push([r, d, u.startsWith("#") ? O(u, $) : u]);
     }
-  return { w: s, h: n, px: h };
+  return { w: n, h: c, px: p };
 }
-function f(o, e, l, s, n) {
-  if (o.exists(e)) return e;
-  const b = document.createElement("canvas");
-  b.width = l, b.height = s;
-  const _ = b.getContext("2d");
-  for (const [p, h, y] of n)
-    _.fillStyle = y, _.fillRect(p, h, 1, 1);
-  return o.addCanvas(e, b), e;
+const A = 64;
+function R(o, b = A) {
+  const l = [];
+  let n = 0, c = 0, h = 0;
+  for (const [t, _] of o)
+    n > 0 && n + t > b && (n = 0, c += h + 1, h = 0), l.push([n, c]), n += t + 1, h = Math.max(h, _);
+  return { at: l, height: c + h };
 }
-function R(o, e = {}, l = "life_") {
-  const s = { ...F, ...e }, n = (c) => l + c, b = s.leaves.map(([c, t], i) => [
-    f(o, n(`leaf_${i}_0`), 2, 1, [[0, 0, c], [1, 0, t]]),
-    f(o, n(`leaf_${i}_1`), 2, 2, [[0, 0, c], [1, 1, t]]),
-    f(o, n(`leaf_${i}_2`), 1, 2, [[0, 0, c], [0, 1, t]])
-  ]), _ = [
-    [f(o, n("seed_0"), 1, 1, [[0, 0, s.seed[0]]])],
-    [f(o, n("seed_1"), 2, 1, [[0, 0, s.seed[0]], [1, 0, s.seed[1]]])]
-  ], p = [s.ember.map((c, t) => f(o, n(`ember_${t}`), 1, 1, [[0, 0, c]]))], h = s.mote.map((c, t) => [f(o, n(`mote_${t}`), 1, 1, [[0, 0, c]])]), y = s.ash.map(
-    ([c, t], i) => (
+let B = 0;
+function I(o, b, l) {
+  const n = l.filter((f) => !o.exists(f.key));
+  if (!n.length) return;
+  const { at: c, height: h } = R(n.map((f) => [f.w, f.h])), t = document.createElement("canvas");
+  t.width = A, t.height = Math.max(1, h);
+  const _ = t.getContext("2d");
+  n.forEach((f, m) => {
+    const [$, d] = c[m];
+    for (const [r, e, y] of f.pixels)
+      _.fillStyle = y, _.fillRect($ + r, d + e, 1, 1);
+  });
+  const p = `${b}page${++B}`;
+  o.addCanvas(p, t), n.forEach((f, m) => o.addView(f.key, p, c[m][0], c[m][1], f.w, f.h));
+}
+function W(o, b = {}, l = "life_") {
+  const n = { ...M, ...b }, c = (s) => l + s, h = [], t = (s, a, i, S, L) => (h.push({ key: a, w: i, h: S, pixels: L }), a), _ = n.leaves.map(([s, a], i) => [
+    t(o, c(`leaf_${i}_0`), 2, 1, [[0, 0, s], [1, 0, a]]),
+    t(o, c(`leaf_${i}_1`), 2, 2, [[0, 0, s], [1, 1, a]]),
+    t(o, c(`leaf_${i}_2`), 1, 2, [[0, 0, s], [0, 1, a]])
+  ]), p = [
+    [t(o, c("seed_0"), 1, 1, [[0, 0, n.seed[0]]])],
+    [t(o, c("seed_1"), 2, 1, [[0, 0, n.seed[0]], [1, 0, n.seed[1]]])]
+  ], f = [n.ember.map((s, a) => t(o, c(`ember_${a}`), 1, 1, [[0, 0, s]]))], m = n.mote.map((s, a) => [t(o, c(`mote_${a}`), 1, 1, [[0, 0, s]])]), $ = n.ash.map(
+    ([s, a], i) => (
       // the first flake flat, the next tumbling on its corner
-      [f(o, n(`ash_${i}`), 2, i % 2 ? 2 : 1, i % 2 ? [[0, 0, c], [1, 1, t]] : [[0, 0, c], [1, 0, t]])]
+      [t(o, c(`ash_${i}`), 2, i % 2 ? 2 : 1, i % 2 ? [[0, 0, s], [1, 1, a]] : [[0, 0, s], [1, 0, a]])]
     )
-  ), u = s.butterflyBody, S = s.butterflies.map(([c, t], i) => [
-    f(o, n(`fly_${i}_o`), 3, 2, [[0, 0, c], [2, 0, c], [1, 0, u], [0, 1, t], [1, 1, u], [2, 1, t]]),
-    f(o, n(`fly_${i}_c`), 3, 2, [[1, 0, c], [1, 1, t]])
-  ]), a = s.bird, r = [
-    f(o, n("bird_0"), 5, 2, [[0, 0, a], [4, 0, a], [1, 1, a], [2, 1, a], [3, 1, a]]),
-    f(o, n("bird_1"), 5, 2, [[0, 1, a], [1, 0, a], [2, 0, a], [3, 0, a], [4, 1, a]])
-  ], [$, m] = s.birdShadow, g = f(o, n("bird_shadow"), 3, 1, [[0, 0, m], [1, 0, $], [2, 0, m]]), [w, d] = s.firefly, A = [
-    f(o, n("firefly_dim"), 3, 3, [[1, 1, d]]),
-    f(o, n("firefly_lit"), 3, 3, [[1, 1, w], [0, 1, d], [2, 1, d], [1, 0, d], [1, 2, d]])
-  ], C = [];
-  for (let c = 0; c < v; c++) {
-    const { w: t, h: i, px: E } = M(c, s.smoke);
-    C.push(f(o, n(`puff_${c}`), t, i, E));
+  ), d = n.butterflyBody, r = n.butterflies.map(([s, a], i) => [
+    t(o, c(`fly_${i}_o`), 3, 2, [[0, 0, s], [2, 0, s], [1, 0, d], [0, 1, a], [1, 1, d], [2, 1, a]]),
+    t(o, c(`fly_${i}_c`), 3, 2, [[1, 0, s], [1, 1, a]])
+  ]), e = n.bird, y = [
+    t(o, c("bird_0"), 5, 2, [[0, 0, e], [4, 0, e], [1, 1, e], [2, 1, e], [3, 1, e]]),
+    t(o, c("bird_1"), 5, 2, [[0, 1, e], [1, 0, e], [2, 0, e], [3, 0, e], [4, 1, e]])
+  ], [k, g] = n.birdShadow, u = t(o, c("bird_shadow"), 3, 1, [[0, 0, g], [1, 0, k], [2, 0, g]]), [C, w] = n.firefly, F = [
+    t(o, c("firefly_dim"), 3, 3, [[1, 1, w]]),
+    t(o, c("firefly_lit"), 3, 3, [[1, 1, C], [0, 1, w], [2, 1, w], [1, 0, w], [1, 2, w]])
+  ], E = [];
+  for (let s = 0; s < v; s++) {
+    const { w: a, h: i, px: S } = P(s, n.smoke);
+    E.push(t(o, c(`puff_${s}`), a, i, S));
   }
-  return { leaves: b, seeds: _, embers: p, motes: h, ash: y, butterflies: S, bird: r, birdShadow: g, firefly: A, puffs: C };
+  return I(o, l, h), { leaves: _, seeds: p, embers: f, motes: m, ash: $, butterflies: r, bird: y, birdShadow: u, firefly: F, puffs: E };
 }
 export {
-  F as LIFE_COLORS,
+  M as LIFE_COLORS,
   v as PUFF_FRAMES,
-  R as paintLifeArt,
-  M as puffPixels
+  R as packShelves,
+  W as paintLifeArt,
+  P as puffPixels
 };

package/dist/types/core/Group.d.ts

@@ -12,6 +12,14 @@ export declare class Group extends Group_base {
      * frame — a held weapon ordered against its body every frame did it every frame.
      */
     moveBelow(child: PixiContainer, other: PixiContainer): this;
+    /**
+     * Keeps `child` drawn above `other`, anywhere above it: moved (directly above) only when it is below. What a weapon
+     * held over its body asks for. `moveAbove` from two pieces each wanting to sit *directly* above the same body (two
+     * blades, a fist on a hilt, a load) pushed the other out every frame, and every push rebuilt Pixi's instructions.
+     */
+    keepAbove(child: PixiContainer, other: PixiContainer): this;
+    /** Keeps `child` drawn below `other`, anywhere below it: moved (directly below) only when it is above (`keepAbove`). */
+    keepBelow(child: PixiContainer, other: PixiContainer): this;
     /** Puts `child` directly above `other` in the draw order; already there, it does nothing (see `moveBelow`). */
     moveAbove(child: PixiContainer, other: PixiContainer): this;
 }

package/dist/types/core/Group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../../src/core/Group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;;AAGrE,yFAAyF;AACzF,qBAAa,KAAM,SAAQ,UAAqB;IAC9C,IAAI,IAAI,IAAI,aAAa,EAAE,CAE1B;IAED,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,EAAE,GAAG,IAAI;IAKjD,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKhD,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,UAAQ,GAAG,IAAI;IAMnD;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAQ3D,+GAA+G;IAC/G,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;CAO5D"}
+{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../../src/core/Group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;;AAGrE,yFAAyF;AACzF,qBAAa,KAAM,SAAQ,UAAqB;IAC9C,IAAI,IAAI,IAAI,aAAa,EAAE,CAE1B;IAED,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,EAAE,GAAG,IAAI;IAKjD,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKhD,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,UAAQ,GAAG,IAAI;IAMnD;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAQ3D;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAM3D,wHAAwH;IACxH,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAM3D,+GAA+G;IAC/G,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;CAO5D"}

package/dist/types/core/Stage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Stage.d.ts","sourceRoot":"","sources":["../../../src/core/Stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,8BAAsB,KAAK;IA+BvB,QAAQ,CAAC,GAAG,EAAE,WAAW;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe;IA/BpC,yFAAyF;IACzF,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEvE,QAAQ,CAAC,KAAK,8CAA6C;IAC3D,QAAQ,CAAC,MAAM,8CAAmB;IAClC,QAAQ,CAAC,GAAG,gBAA2B;IACvC,QAAQ,CAAC,MAAM,UAAiB;IAChC,QAAQ,CAAC,IAAI,QAAe;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3C;;;;OAIG;IACH,YAAY,UAAS;IACrB;;;;OAIG;IACH,YAAY,SAAK;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;gBAGZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,eAAe;IAWpC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQpC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAEjD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAc1B;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAI/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C;;;;OAIG;IACH,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAInD,2EAA2E;IAC3E,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAS/D,iIAAiI;IACjI,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IASlD,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,QAAQ;CAWjB"}
+{"version":3,"file":"Stage.d.ts","sourceRoot":"","sources":["../../../src/core/Stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,8BAAsB,KAAK;IA+BvB,QAAQ,CAAC,GAAG,EAAE,WAAW;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe;IA/BpC,yFAAyF;IACzF,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEvE,QAAQ,CAAC,KAAK,8CAA6C;IAC3D,QAAQ,CAAC,MAAM,8CAAmB;IAClC,QAAQ,CAAC,GAAG,gBAA2B;IACvC,QAAQ,CAAC,MAAM,UAAiB;IAChC,QAAQ,CAAC,IAAI,QAAe;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3C;;;;OAIG;IACH,YAAY,UAAS;IACrB;;;;OAIG;IACH,YAAY,SAAK;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;gBAGZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,eAAe;IAapC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQpC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAEjD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAe1B;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAI/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C;;;;OAIG;IACH,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAInD,2EAA2E;IAC3E,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAS/D,iIAAiI;IACjI,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IASlD,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,QAAQ;CAWjB"}

package/dist/types/core/TextureRegistry.d.ts

@@ -1,4 +1,4 @@
-import { CanvasSource, Texture } from 'pixi.js';
+import { CanvasSource, Rectangle, Texture } from 'pixi.js';
 /** A frame packed on an atlas page (TexturePacker and the like), as `assets/textureAtlas.ts` parses it. */
 export interface PackedFrame {
     name: string;
@@ -25,14 +25,23 @@ export interface PackedFrame {
         y: number;
     };
 }
-/** A canvas-backed texture with named frames; repaint the canvas, then `refresh()` to upload it. */
+/**
+ * A canvas-backed texture with named frames; repaint the canvas, then `refresh()` to upload it. Made with a `view`, it
+ * is one rect of another texture's canvas on that texture's own source (`TextureRegistry.addView`): small pieces
+ * swapped every few frames then batch together, where a source each made Pixi rebuild its draw instructions at every
+ * swap.
+ */
 export declare class CanvasTexture {
     readonly key: string;
     readonly canvas: HTMLCanvasElement;
     readonly frames: Map<string, Texture<import("pixi.js").TextureSource<any>>>;
     readonly source: CanvasSource;
     readonly whole: Texture;
-    constructor(key: string, canvas: HTMLCanvasElement);
+    private readonly owned;
+    constructor(key: string, canvas: HTMLCanvasElement, view?: {
+        source: CanvasSource;
+        frame: Rectangle;
+    });
     get width(): number;
     get height(): number;
     get context(): CanvasRenderingContext2D;
@@ -82,6 +91,11 @@ export declare class TextureRegistry {
         canvas: HTMLCanvasElement;
         frames: readonly PackedFrame[];
     }[]): CanvasTexture;
+    /**
+     * Registers `key` as the rect (x, y, w, h) of the texture `page`, on the page's source: shown by `setTexture(key)`
+     * like any texture, and batched with every other view of that page. Null when the page is not registered.
+     */
+    addView(key: string, page: string, x: number, y: number, w: number, h: number): CanvasTexture | null;
     createCanvas(key: string, width: number, height: number): CanvasTexture;
     remove(key: string): void;
     get(key: string, frame?: string | number): Texture;

package/dist/types/core/TextureRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextureRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/TextureRegistry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TextureRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/TextureRegistry.ts"],"names":[],"mappings":"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"}

package/dist/types/core/depthSort.d.ts

@@ -0,0 +1,6 @@
+import { Container } from 'pixi.js';
+/** Checks `container`'s depth order once a frame (`flushDepthSorts`) instead of at every child's `zIndex` change. */
+export declare function deferDepthSort(container: Container): void;
+/** Sorts each container whose children changed depth, marking its render group changed only if the order did. */
+export declare function flushDepthSorts(): void;
+//# sourceMappingURL=depthSort.d.ts.map

package/dist/types/core/depthSort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depthSort.d.ts","sourceRoot":"","sources":["../../../src/core/depthSort.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAyCpC,qHAAqH;AACrH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAGzD;AAED,iHAAiH;AACjH,wBAAgB,eAAe,IAAI,IAAI,CAqBtC"}

package/dist/types/pixel/lifeArt.d.ts

@@ -55,6 +55,14 @@ export declare function puffPixels(frame: number, colors?: readonly [string, str
     h: number;
     px: LifePixel[];
 };
+/**
+ * Where each of `sizes` goes on one page `width` wide: left to right, a new row below the tallest of the last when the
+ * next does not fit, one clear pixel between pieces (so nothing bleeds into a neighbour). Also the page's height.
+ */
+export declare function packShelves(sizes: readonly (readonly [w: number, h: number])[], width?: number): {
+    at: [number, number][];
+    height: number;
+};
 /**
  * Paints the life's art under `prefix` (default `'life_'`) and returns its keys. A key already registered is kept, so
  * calling it again (every map) costs nothing — and painting other colours needs another prefix.

package/dist/types/pixel/lifeArt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifeArt.d.ts","sourceRoot":"","sources":["../../../src/pixel/lifeArt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAS/D,kDAAkD;AAClD,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAEvE,8FAA8F;AAC9F,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAC/C,qEAAqE;IACrE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iCAAiC;IACjC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,iBAAiB;IACjB,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2CAA2C;IAC3C,GAAG,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAC5C,gDAAgD;IAChD,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACpD,oDAAoD;IACpD,OAAO,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7C,yDAAyD;IACzD,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,eAAO,MAAM,WAAW,EAAE,UAuBzB,CAAC;AAEF,6EAA6E;AAC7E,MAAM,WAAW,OAAO;IACtB,mCAAmC;IACnC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;IAChB,kDAAkD;IAClD,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAChC,iCAAiC;IACjC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,4CAA4C;AAC5C,eAAO,MAAM,WAAW,IAAI,CAAC;AAQ7B;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAqB,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,SAAS,EAAE,CAAA;CAAE,CAqBlJ;AAgBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,GAAE,OAAO,CAAC,UAAU,CAAM,EAAE,MAAM,SAAU,GAAG,OAAO,CA2CnH"}
+{"version":3,"file":"lifeArt.d.ts","sourceRoot":"","sources":["../../../src/pixel/lifeArt.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "1681-engine",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "A 2D game engine on PixiJS 8 for any art style: scenes and a fast ECS, a fixed-step loop, asset loading, Tiled maps, sprite animation, input actions, camera follow, audio and deterministic, server-replayable movement, plus Dither, an optional pixel-art module (pixel-perfect effects, dithered lighting).",
   "type": "module",
   "types": "./dist/types/index.d.ts",