1681-engine 0.0.0-stage → 0.5.8

package/dist/anim/asepriteTags.js

@@ -0,0 +1,35 @@
+const h = ["forward", "reverse", "pingpong", "pingpong_reverse"];
+function v(e) {
+  return h.includes(e) ? e : "forward";
+}
+function m(e) {
+  const o = typeof e == "number" ? e : e === void 0 ? 0 : Number.parseInt(e, 10);
+  return Number.isFinite(o) && o > 0 ? Math.floor(o) : 0;
+}
+function b(e, o, c, i) {
+  const l = Math.min(e, o), a = Math.max(e, o), t = [];
+  for (let n = l; n <= a; n++) t.push(n);
+  const p = t.slice().reverse(), u = c === "reverse" || c === "pingpong_reverse", s = u ? p : t, g = c === "pingpong" || c === "pingpong_reverse";
+  if (i === 0) {
+    if (!g || t.length <= 2) return s;
+    const n = u ? t : p;
+    return s.concat(n.slice(1, -1));
+  }
+  if (!g) {
+    const n = [];
+    for (let r = 0; r < i; r++) n.push(...s);
+    return n;
+  }
+  const f = s.slice();
+  for (let n = 1; n < i; n++) {
+    const r = n % 2 === 0 ? s : u ? t : p;
+    f.push(...t.length > 1 ? r.slice(1) : r);
+  }
+  return f;
+}
+export {
+  v as tagDirection,
+  b as tagFrames,
+  m as tagRepeat
+};
+//# sourceMappingURL=asepriteTags.js.map

package/dist/anim/asepriteTags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asepriteTags.js","sources":["../../src/anim/asepriteTags.ts"],"sourcesContent":["import type { AsepriteDirection } from './asepriteTypes';\n\nconst DIRECTIONS: readonly AsepriteDirection[] = ['forward', 'reverse', 'pingpong', 'pingpong_reverse'];\n\n/** Aseprite's direction name, or forward for anything unknown (older files write none). */\nexport function tagDirection(raw: string | undefined): AsepriteDirection {\n  return DIRECTIONS.includes(raw as AsepriteDirection) ? (raw as AsepriteDirection) : 'forward';\n}\n\n/** Aseprite writes the repeat count as a string; absent, 0 or nonsense is forever. */\nexport function tagRepeat(raw: string | number | undefined): number {\n  const n = typeof raw === 'number' ? raw : raw === undefined ? 0 : Number.parseInt(raw, 10);\n  return Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;\n}\n\n/**\n * The sheet frames a tag plays, in playing order, unrolled so the engine's `Animator` (which only ever plays a list\n * forward) shows exactly what Aseprite's own player shows.\n *\n * - forever (`repeat` 0): forward and reverse are one pass, looped; a ping-pong is one round trip without its two\n *   ends doubled (a b c d c b, then a again), so a loop never stutters on the turn.\n * - `repeat` n: n passes, played once. A ping-pong counts each pass in one direction as one, as Aseprite does, and two\n *   passes share their turning frame (repeat 2 of a b c is a b c b a).\n */\nexport function tagFrames(from: number, to: number, direction: AsepriteDirection, repeat: number): number[] {\n  const lo = Math.min(from, to);\n  const hi = Math.max(from, to);\n  const up: number[] = [];\n  for (let i = lo; i <= hi; i++) up.push(i);\n  const down = up.slice().reverse();\n  const backward = direction === 'reverse' || direction === 'pingpong_reverse';\n  const first = backward ? down : up;\n  const pingpong = direction === 'pingpong' || direction === 'pingpong_reverse';\n\n  if (repeat === 0) {\n    if (!pingpong || up.length <= 2) return first;\n    const second = backward ? up : down;\n    return first.concat(second.slice(1, -1));\n  }\n  if (!pingpong) {\n    const out: number[] = [];\n    for (let r = 0; r < repeat; r++) out.push(...first);\n    return out;\n  }\n  const out = first.slice();\n  for (let r = 1; r < repeat; r++) {\n    const pass = r % 2 === 0 ? first : backward ? up : down;\n    // the turning frame closes one pass and opens the next: shown once, as Aseprite shows it\n    out.push(...(up.length > 1 ? pass.slice(1) : pass));\n  }\n  return out;\n}\n"],"names":["DIRECTIONS","tagDirection","raw","tagRepeat","n","tagFrames","from","to","direction","repeat","lo","hi","up","i","down","backward","first","pingpong","second","out","r","pass"],"mappings":"AAEA,MAAMA,IAA2C,CAAC,WAAW,WAAW,YAAY,kBAAkB;AAG/F,SAASC,EAAaC,GAA4C;AACvE,SAAOF,EAAW,SAASE,CAAwB,IAAKA,IAA4B;AACtF;AAGO,SAASC,EAAUD,GAA0C;AAClE,QAAME,IAAI,OAAOF,KAAQ,WAAWA,IAAMA,MAAQ,SAAY,IAAI,OAAO,SAASA,GAAK,EAAE;AACzF,SAAO,OAAO,SAASE,CAAC,KAAKA,IAAI,IAAI,KAAK,MAAMA,CAAC,IAAI;AACvD;AAWO,SAASC,EAAUC,GAAcC,GAAYC,GAA8BC,GAA0B;AAC1G,QAAMC,IAAK,KAAK,IAAIJ,GAAMC,CAAE,GACtBI,IAAK,KAAK,IAAIL,GAAMC,CAAE,GACtBK,IAAe,CAAA;AACrB,WAASC,IAAIH,GAAIG,KAAKF,GAAIE,IAAK,CAAAD,EAAG,KAAKC,CAAC;AACxC,QAAMC,IAAOF,EAAG,MAAA,EAAQ,QAAA,GAClBG,IAAWP,MAAc,aAAaA,MAAc,oBACpDQ,IAAQD,IAAWD,IAAOF,GAC1BK,IAAWT,MAAc,cAAcA,MAAc;AAE3D,MAAIC,MAAW,GAAG;AAChB,QAAI,CAACQ,KAAYL,EAAG,UAAU,EAAG,QAAOI;AACxC,UAAME,IAASH,IAAWH,IAAKE;AAC/B,WAAOE,EAAM,OAAOE,EAAO,MAAM,GAAG,EAAE,CAAC;AAAA,EACzC;AACA,MAAI,CAACD,GAAU;AACb,UAAME,IAAgB,CAAA;AACtB,aAAS,IAAI,GAAG,IAAIV,GAAQ,IAAKU,CAAAA,EAAI,KAAK,GAAGH,CAAK;AAClD,WAAOG;AAAAA,EACT;AACA,QAAMA,IAAMH,EAAM,MAAA;AAClB,WAASI,IAAI,GAAGA,IAAIX,GAAQW,KAAK;AAC/B,UAAMC,IAAOD,IAAI,MAAM,IAAIJ,IAAQD,IAAWH,IAAKE;AAEnD,IAAAK,EAAI,KAAK,GAAIP,EAAG,SAAS,IAAIS,EAAK,MAAM,CAAC,IAAIA,CAAK;AAAA,EACpD;AACA,SAAOF;AACT;"}

package/dist/anim/parseAseprite.js

@@ -0,0 +1,83 @@
+import { tagRepeat as w, tagDirection as y, tagFrames as v } from "./asepriteTags.js";
+const A = 100;
+function S(s) {
+  if (!s || typeof s != "object") throw new Error("parseAseprite: not an Aseprite JSON object");
+  const r = s;
+  if (!r.frames || typeof r.frames != "object") throw new Error('parseAseprite: no "frames"');
+  const n = r.meta ?? {}, a = (Array.isArray(r.frames) ? r.frames.map((e, o) => [e.filename ?? String(o), e]) : Object.entries(r.frames)).map(([e, o], t) => b(e, o, t));
+  if (a.length === 0) throw new Error("parseAseprite: the sheet has no frames");
+  const i = (n.frameTags ?? []).map((e) => {
+    if (!(e.from >= 0 && e.to < a.length && e.from <= e.to))
+      throw new Error(`parseAseprite: tag "${e.name}" spans frames ${e.from}–${e.to} of ${a.length}`);
+    const o = { name: e.name, from: e.from, to: e.to, direction: y(e.direction), repeat: w(e.repeat) };
+    return e.color !== void 0 && (o.color = e.color), e.data !== void 0 && (o.data = e.data), o;
+  }), c = {};
+  for (const e of i) {
+    let o = e.name;
+    for (let t = 2; o in c; t++) o = `${e.name}#${t}`;
+    c[o] = h(a, v(e.from, e.to, e.direction, e.repeat), e.repeat === 0);
+  }
+  const f = h(a, a.map((e) => e.index), !0), p = (n.slices ?? []).map((e) => {
+    const o = {
+      name: e.name,
+      keys: (e.keys ?? []).map((t) => ({
+        frame: t.frame,
+        bounds: { ...t.bounds },
+        ...t.center ? { center: { ...t.center } } : {},
+        ...t.pivot ? { pivot: { ...t.pivot } } : {}
+      })).sort((t, g) => t.frame - g.frame)
+    };
+    return e.color !== void 0 && (o.color = e.color), e.data !== void 0 && (o.data = e.data), o;
+  }), d = [], u = [];
+  for (const e of n.layers ?? []) {
+    const o = { name: e.name, opacity: e.opacity ?? 255, blendMode: e.blendMode ?? "normal" };
+    e.group !== void 0 && (o.group = e.group), e.color !== void 0 && (o.color = e.color), e.data !== void 0 && (o.data = e.data), d.push(o);
+    for (const t of e.cels ?? []) t.data && u.push({ layer: e.name, frame: t.frame, data: t.data });
+  }
+  const l = n.size ?? { w: 0, h: 0 };
+  return { image: n.image ?? "", width: l.w, height: l.h, frames: a, tags: i, clips: c, all: f, slices: p, layers: d, cues: u };
+}
+function b(s, r, n) {
+  if (!r || !r.frame) throw new Error(`parseAseprite: frame "${s}" has no rect`);
+  if (r.rotated) throw new Error(`parseAseprite: frame "${s}" is rotated, which is not supported`);
+  const { x: m, y: a, w: i, h: c } = r.frame, f = r.sourceSize ?? { w: i, h: c }, p = r.trimmed && r.spriteSourceSize ? r.spriteSourceSize : { x: 0, y: 0 };
+  return {
+    index: n,
+    name: s,
+    rect: { x: m, y: a, w: i, h: c },
+    duration: r.duration !== void 0 && r.duration > 0 ? r.duration : A,
+    sourceW: f.w,
+    sourceH: f.h,
+    offsetX: p.x,
+    offsetY: p.y,
+    trimmed: r.trimmed === !0
+  };
+}
+function h(s, r, n) {
+  return { frames: r.slice(), durations: r.map((m) => s[m].duration), loop: n };
+}
+function $(s, r) {
+  return s.frames.findIndex((n) => n.name === r);
+}
+function x(s, r) {
+  const n = /* @__PURE__ */ new Map();
+  for (const a of s.cues) {
+    if (r !== void 0 && a.layer !== r) continue;
+    const i = n.get(a.frame) ?? [];
+    i.push(a.data), n.set(a.frame, i);
+  }
+  const m = {};
+  for (const [a, i] of Object.entries(s.clips)) {
+    const c = [];
+    i.frames.forEach((f, p) => {
+      for (const d of n.get(Number(f)) ?? []) c.push({ frame: p, name: d });
+    }), c.length && (m[a] = c);
+  }
+  return m;
+}
+export {
+  x as clipMarkers,
+  $ as frameNamed,
+  S as parseAseprite
+};
+//# sourceMappingURL=parseAseprite.js.map

package/dist/anim/parseAseprite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseAseprite.js","sources":["../../src/anim/parseAseprite.ts"],"sourcesContent":["import type { AnimationClip } from './Animator';\nimport { tagDirection, tagFrames, tagRepeat } from './asepriteTags';\nimport type {\n  AsepriteCue,\n  AsepriteFrame,\n  AsepriteJson,\n  AsepriteJsonFrame,\n  AsepriteLayer,\n  AsepriteSheet,\n  AsepriteSlice,\n  AsepriteTag,\n  ClipMarker,\n} from './asepriteTypes';\n\n// Aseprite's default when a frame has no duration of its own (its \"Frame Duration\" default)\nconst DEFAULT_DURATION_MS = 100;\n\n/**\n * Reads Aseprite's exported sprite-sheet JSON — either frame layout, \"hash\" (frames keyed by file name) or \"array\" —\n * into frames, one `Animator` clip per tag, slices, layers and cel cues. Pure: no image is touched, so it runs under\n * node and in a worker; `addAsepriteTextures` / `loadAseprite` cut the sheet image by the frames it returns.\n *\n * ```ts\n * const sheet = parseAseprite(json);\n * const anim = new Animator(sheet.clips, 'idle'); // tag names are clip names; frames are sheet frame indices\n * ```\n */\nexport function parseAseprite(json: unknown): AsepriteSheet {\n  if (!json || typeof json !== 'object') throw new Error('parseAseprite: not an Aseprite JSON object');\n  const doc = json as AsepriteJson;\n  if (!doc.frames || typeof doc.frames !== 'object') throw new Error('parseAseprite: no \"frames\"');\n  const meta = doc.meta ?? {};\n\n  const rawFrames: [string, AsepriteJsonFrame][] = Array.isArray(doc.frames)\n    ? doc.frames.map((f, i) => [f.filename ?? String(i), f])\n    : Object.entries(doc.frames);\n  const frames = rawFrames.map(([name, f], index) => toFrame(name, f, index));\n  if (frames.length === 0) throw new Error('parseAseprite: the sheet has no frames');\n\n  const tags: AsepriteTag[] = (meta.frameTags ?? []).map((t) => {\n    if (!(t.from >= 0 && t.to < frames.length && t.from <= t.to)) {\n      throw new Error(`parseAseprite: tag \"${t.name}\" spans frames ${t.from}–${t.to} of ${frames.length}`);\n    }\n    const tag: AsepriteTag = { name: t.name, from: t.from, to: t.to, direction: tagDirection(t.direction), repeat: tagRepeat(t.repeat) };\n    if (t.color !== undefined) tag.color = t.color;\n    if (t.data !== undefined) tag.data = t.data;\n    return tag;\n  });\n\n  const clips: Record<string, AnimationClip> = {};\n  for (const tag of tags) {\n    // Aseprite allows two tags of one name; the second must not silently replace the first\n    let name = tag.name;\n    for (let n = 2; name in clips; n++) name = `${tag.name}#${n}`;\n    clips[name] = clipOf(frames, tagFrames(tag.from, tag.to, tag.direction, tag.repeat), tag.repeat === 0);\n  }\n\n  const all = clipOf(frames, frames.map((f) => f.index), true);\n  const slices: AsepriteSlice[] = (meta.slices ?? []).map((s) => {\n    const slice: AsepriteSlice = {\n      name: s.name,\n      keys: (s.keys ?? [])\n        .map((k) => ({\n          frame: k.frame,\n          bounds: { ...k.bounds },\n          ...(k.center ? { center: { ...k.center } } : {}),\n          ...(k.pivot ? { pivot: { ...k.pivot } } : {}),\n        }))\n        .sort((a, b) => a.frame - b.frame),\n    };\n    if (s.color !== undefined) slice.color = s.color;\n    if (s.data !== undefined) slice.data = s.data;\n    return slice;\n  });\n\n  const layers: AsepriteLayer[] = [];\n  const cues: AsepriteCue[] = [];\n  for (const l of meta.layers ?? []) {\n    const layer: AsepriteLayer = { name: l.name, opacity: l.opacity ?? 255, blendMode: l.blendMode ?? 'normal' };\n    if (l.group !== undefined) layer.group = l.group;\n    if (l.color !== undefined) layer.color = l.color;\n    if (l.data !== undefined) layer.data = l.data;\n    layers.push(layer);\n    for (const c of l.cels ?? []) if (c.data) cues.push({ layer: l.name, frame: c.frame, data: c.data });\n  }\n\n  const size = meta.size ?? { w: 0, h: 0 };\n  return { image: meta.image ?? '', width: size.w, height: size.h, frames, tags, clips, all, slices, layers, cues };\n}\n\nfunction toFrame(name: string, f: AsepriteJsonFrame, index: number): AsepriteFrame {\n  if (!f || !f.frame) throw new Error(`parseAseprite: frame \"${name}\" has no rect`);\n  // Aseprite never rotates frames; a packer that did would need its rect read sideways, which nothing here does\n  if (f.rotated) throw new Error(`parseAseprite: frame \"${name}\" is rotated, which is not supported`);\n  const { x, y, w, h } = f.frame;\n  const src = f.sourceSize ?? { w, h };\n  const off = f.trimmed && f.spriteSourceSize ? f.spriteSourceSize : { x: 0, y: 0 };\n  return {\n    index,\n    name,\n    rect: { x, y, w, h },\n    duration: f.duration !== undefined && f.duration > 0 ? f.duration : DEFAULT_DURATION_MS,\n    sourceW: src.w,\n    sourceH: src.h,\n    offsetX: off.x,\n    offsetY: off.y,\n    trimmed: f.trimmed === true,\n  };\n}\n\nfunction clipOf(frames: readonly AsepriteFrame[], order: readonly number[], loop: boolean): AnimationClip {\n  return { frames: order.slice(), durations: order.map((i) => frames[i]!.duration), loop };\n}\n\n/** The index of the frame Aseprite named `name`, or -1. */\nexport function frameNamed(sheet: AsepriteSheet, name: string): number {\n  return sheet.frames.findIndex((f) => f.name === name);\n}\n\n/**\n * Markers for every clip from the sheet's cel cues: wherever a clip shows a sheet frame whose cel carries user data,\n * a marker of that data at that position of the clip. A ping-pong shows a frame twice a round trip, so it fires twice,\n * as a footstep should. `layer` keeps only the cues of one layer (a layer kept for marks, say \"events\").\n */\nexport function clipMarkers(sheet: AsepriteSheet, layer?: string): Record<string, ClipMarker[]> {\n  const byFrame = new Map<number, string[]>();\n  for (const c of sheet.cues) {\n    if (layer !== undefined && c.layer !== layer) continue;\n    const list = byFrame.get(c.frame) ?? [];\n    list.push(c.data);\n    byFrame.set(c.frame, list);\n  }\n  const out: Record<string, ClipMarker[]> = {};\n  for (const [name, clip] of Object.entries(sheet.clips)) {\n    const markers: ClipMarker[] = [];\n    clip.frames.forEach((f, i) => {\n      for (const data of byFrame.get(Number(f)) ?? []) markers.push({ frame: i, name: data });\n    });\n    if (markers.length) out[name] = markers;\n  }\n  return out;\n}\n"],"names":["DEFAULT_DURATION_MS","parseAseprite","json","doc","meta","frames","f","i","name","index","toFrame","tags","t","tag","tagDirection","tagRepeat","clips","n","clipOf","tagFrames","all","slices","s","slice","k","a","b","layers","cues","l","layer","c","size","x","y","w","h","src","off","order","loop","frameNamed","sheet","clipMarkers","byFrame","list","out","clip","markers","data"],"mappings":"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"}

package/dist/assets/AssetLoader.js

@@ -0,0 +1,104 @@
+import { parseTiled as h } from "../tilemap/tiled.js";
+function n(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);
+  return s.join("/");
+}
+async function c(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 {
+  constructor(t, e = {}) {
+    this.textures = t, this.options = e, this.fetcher = e.fetch ?? ((a) => fetch(a)), this.toCanvas = e.toCanvas ?? c;
+  }
+  textures;
+  options;
+  queue = [];
+  data = /* @__PURE__ */ new Map();
+  maps = /* @__PURE__ */ new Map();
+  fetcher;
+  toCanvas;
+  total = 0;
+  done = 0;
+  image(t, e) {
+    return this.add(t, async () => {
+      this.textures.addCanvas(t, await this.toCanvas(await this.blob(e)));
+    });
+  }
+  /** An image cut into equal frames named 0, 1, 2…, left to right, then row by row. */
+  spritesheet(t, e, a) {
+    return this.add(t, async () => {
+      this.textures.addSpriteSheet(t, await this.toCanvas(await this.blob(e)), a);
+    });
+  }
+  json(t, e) {
+    return this.add(t, async () => {
+      this.data.set(t, await (await this.request(e)).json());
+    });
+  }
+  text(t, e) {
+    return this.add(t, async () => {
+      this.data.set(t, await (await this.request(e)).text());
+    });
+  }
+  /** 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());
+      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));
+    });
+  }
+  /** 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 () => {
+      for (let s = this.queue.shift(); s; s = this.queue.shift())
+        await s.run(), this.done++, t?.({ done: this.done, total: this.total, key: s.key });
+    };
+    for (; this.queue.length; ) await Promise.all(Array.from({ length: e }, a));
+  }
+  /** A loaded JSON value. */
+  getJson(t) {
+    if (!this.data.has(t)) throw new Error(`AssetLoader: no JSON or text loaded as "${t}"`);
+    return this.data.get(t);
+  }
+  /** A loaded text file. */
+  getText(t) {
+    return this.getJson(t);
+  }
+  /** A loaded Tiled map. */
+  map(t) {
+    const e = this.maps.get(t);
+    if (!e) throw new Error(`AssetLoader: no tilemap loaded as "${t}"`);
+    return e;
+  }
+  add(t, e) {
+    return this.queue.push({ key: t, run: e }), this.total++, this;
+  }
+  async request(t) {
+    const e = n(t, this.options.baseUrl ?? "");
+    let a;
+    try {
+      a = await this.fetcher(e);
+    } catch (s) {
+      throw new Error(`AssetLoader: could not fetch ${e}: ${s instanceof Error ? s.message : String(s)}`);
+    }
+    if (!a.ok) throw new Error(`AssetLoader: ${e} answered ${a.status}`);
+    return a;
+  }
+  async blob(t) {
+    return (await this.request(t)).blob();
+  }
+}
+export {
+  u as AssetLoader,
+  n as resolveUrl
+};
+//# sourceMappingURL=AssetLoader.js.map

package/dist/assets/AssetLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetLoader.js","sources":["../../src/assets/AssetLoader.ts"],"sourcesContent":["import { parseTiled, type TileMap, type Tileset } from '../tilemap/tiled';\n\n/** Where loaded images go: the stage's `TextureRegistry` satisfies it. */\nexport interface TextureSink {\n  addCanvas(key: string, canvas: HTMLCanvasElement): unknown;\n  addSpriteSheet(key: string, canvas: HTMLCanvasElement, size: { frameWidth: number; frameHeight: number }): unknown;\n}\n\nexport interface AssetLoaderOptions {\n  /** Prefix for relative URLs (default: none, so relative to the page). */\n  baseUrl?: string;\n  /** Requests running at once (default 6). */\n  concurrency?: number;\n  /** For tests and custom transports: defaults to the global `fetch`. */\n  fetch?: (url: string) => Promise<{ ok: boolean; status: number; blob(): Promise<Blob>; json(): Promise<unknown>; text(): Promise<string> }>;\n  /** Turns image bytes into a canvas; defaults to `createImageBitmap` drawn onto a new canvas. */\n  toCanvas?: (blob: Blob) => Promise<HTMLCanvasElement>;\n}\n\nexport interface TilemapAssetOptions {\n  /** The texture key a tileset's image is loaded under (default: the tileset's name). */\n  textureKey?: (tileset: Tileset) => string;\n}\n\nexport interface LoadProgress {\n  done: number;\n  total: number;\n  /** The asset that just finished. */\n  key: string;\n}\n\ntype Job = { key: string; run: () => Promise<void> };\n\n/** `url` resolved against `base` the way a browser would (a bare file name sits beside its map). */\nexport function resolveUrl(url: string, base: string): string {\n  if (/^[a-z][a-z0-9+.-]*:/i.test(url) || url.startsWith('/')) return url;\n  const dir = base.slice(0, base.lastIndexOf('/') + 1);\n  const parts = (dir + url).split('/');\n  const out: string[] = [];\n  for (const p of parts) {\n    if (p === '..' && out.length && out[out.length - 1] !== '..' && out[out.length - 1] !== '') out.pop();\n    else if (p !== '.') out.push(p);\n  }\n  return out.join('/');\n}\n\nasync function defaultToCanvas(blob: Blob): Promise<HTMLCanvasElement> {\n  const bitmap = await createImageBitmap(blob);\n  const canvas = document.createElement('canvas');\n  canvas.width = bitmap.width;\n  canvas.height = bitmap.height;\n  const ctx = canvas.getContext('2d');\n  if (!ctx) throw new Error('AssetLoader: no 2D context (out of canvas memory?)');\n  ctx.drawImage(bitmap, 0, 0);\n  bitmap.close();\n  return canvas;\n}\n\n/**\n * Loads a scene's assets before it starts: queue them, then `await load()`. Images become textures in the stage's\n * registry (frames of a sprite sheet named 0, 1, 2…); JSON, text and Tiled maps are kept here by key. A failed asset\n * fails the whole load with its URL in the message.\n *\n * ```ts\n * override async onEnter() {\n *   const assets = new AssetLoader(this.engine.stage.textures);\n *   assets.spritesheet('hero', 'art/hero.png', { frameWidth: 20, frameHeight: 24 }).tilemap('level', 'maps/level.tmj');\n *   await assets.load(({ done, total }) => bar.set(done / total));\n *   const map = assets.map('level');\n * }\n * ```\n */\nexport class AssetLoader {\n  private readonly queue: Job[] = [];\n  private readonly data = new Map<string, unknown>();\n  private readonly maps = new Map<string, TileMap>();\n  private readonly fetcher: NonNullable<AssetLoaderOptions['fetch']>;\n  private readonly toCanvas: (blob: Blob) => Promise<HTMLCanvasElement>;\n  private total = 0;\n  private done = 0;\n\n  constructor(\n    private readonly textures: TextureSink,\n    private readonly options: AssetLoaderOptions = {},\n  ) {\n    this.fetcher = options.fetch ?? ((url) => fetch(url));\n    this.toCanvas = options.toCanvas ?? defaultToCanvas;\n  }\n\n  image(key: string, url: string): this {\n    return this.add(key, async () => {\n      this.textures.addCanvas(key, await this.toCanvas(await this.blob(url)));\n    });\n  }\n\n  /** An image cut into equal frames named 0, 1, 2…, left to right, then row by row. */\n  spritesheet(key: string, url: string, size: { frameWidth: number; frameHeight: number }): this {\n    return this.add(key, async () => {\n      this.textures.addSpriteSheet(key, await this.toCanvas(await this.blob(url)), size);\n    });\n  }\n\n  json(key: string, url: string): this {\n    return this.add(key, async () => {\n      this.data.set(key, await (await this.request(url)).json());\n    });\n  }\n\n  text(key: string, url: string): this {\n    return this.add(key, async () => {\n      this.data.set(key, await (await this.request(url)).text());\n    });\n  }\n\n  /** A Tiled JSON map, then every tileset image it names (resolved beside the map file). */\n  tilemap(key: string, url: string, options: TilemapAssetOptions = {}): this {\n    return this.add(key, async () => {\n      const map = parseTiled(await (await this.request(url)).json());\n      this.maps.set(key, map);\n      const textureKey = options.textureKey ?? ((ts: Tileset) => ts.name);\n      for (const ts of map.tilesets) this.image(textureKey(ts), resolveUrl(ts.image, url));\n    });\n  }\n\n  /** Runs everything queued; `onProgress` after each asset. Safe to call again after queueing more. */\n  async load(onProgress?: (p: LoadProgress) => void): Promise<void> {\n    const limit = Math.max(1, this.options.concurrency ?? 6);\n    const worker = async (): Promise<void> => {\n      for (let job = this.queue.shift(); job; job = this.queue.shift()) {\n        await job.run();\n        this.done++;\n        onProgress?.({ done: this.done, total: this.total, key: job.key });\n      }\n    };\n    // a finished tilemap queues its tilesets: keep draining until nothing is left\n    while (this.queue.length) await Promise.all(Array.from({ length: limit }, worker));\n  }\n\n  /** A loaded JSON value. */\n  getJson<T = unknown>(key: string): T {\n    if (!this.data.has(key)) throw new Error(`AssetLoader: no JSON or text loaded as \"${key}\"`);\n    return this.data.get(key) as T;\n  }\n\n  /** A loaded text file. */\n  getText(key: string): string {\n    return this.getJson<string>(key);\n  }\n\n  /** A loaded Tiled map. */\n  map(key: string): TileMap {\n    const m = this.maps.get(key);\n    if (!m) throw new Error(`AssetLoader: no tilemap loaded as \"${key}\"`);\n    return m;\n  }\n\n  private add(key: string, run: () => Promise<void>): this {\n    this.queue.push({ key, run });\n    this.total++;\n    return this;\n  }\n\n  private async request(url: string) {\n    const full = resolveUrl(url, this.options.baseUrl ?? '');\n    let res;\n    try {\n      res = await this.fetcher(full);\n    } catch (err) {\n      throw new Error(`AssetLoader: could not fetch ${full}: ${err instanceof Error ? err.message : String(err)}`);\n    }\n    if (!res.ok) throw new Error(`AssetLoader: ${full} answered ${res.status}`);\n    return res;\n  }\n\n  private async blob(url: string): Promise<Blob> {\n    return (await this.request(url)).blob();\n  }\n}\n"],"names":["resolveUrl","url","base","parts","out","p","defaultToCanvas","blob","bitmap","canvas","ctx","AssetLoader","textures","options","key","size","map","parseTiled","textureKey","ts","onProgress","limit","worker","job","m","run","full","res","err"],"mappings":"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"}

package/dist/assets/loadAseprite.js

@@ -0,0 +1,50 @@
+import { Texture as u, Rectangle as g } from "pixi.js";
+import { parseAseprite as l } from "../anim/parseAseprite.js";
+import { resolveUrl as h } from "./AssetLoader.js";
+function p(i, t, r, a) {
+  const o = i.addCanvas(t, r);
+  for (const e of a.frames) {
+    const { x: s, y: n, w: c, h: m } = e.rect;
+    if (!e.trimmed) {
+      o.add(String(e.index), 0, s, n, c, m);
+      continue;
+    }
+    o.frames.get(String(e.index))?.destroy(), o.frames.set(
+      String(e.index),
+      new u({
+        source: o.source,
+        frame: new g(s, n, c, m),
+        orig: new g(0, 0, e.sourceW, e.sourceH),
+        trim: new g(e.offsetX, e.offsetY, c, m)
+      })
+    );
+  }
+  return o;
+}
+async function A(i, t, r, a = {}) {
+  const o = a.fetch ?? ((f) => fetch(f)), e = async (f) => {
+    let w;
+    try {
+      w = await o(f);
+    } catch (d) {
+      throw new Error(`loadAseprite: could not fetch ${f}: ${d instanceof Error ? d.message : String(d)}`);
+    }
+    if (!w.ok) throw new Error(`loadAseprite: ${f} answered ${w.status}`);
+    return w;
+  }, s = h(r, a.baseUrl ?? ""), n = l(await (await e(s)).json());
+  if (!n.image) throw new Error(`loadAseprite: ${s} names no sheet image (meta.image)`);
+  const c = await (await e(h(n.image, s))).blob(), m = await (a.toCanvas ?? x)(c);
+  return p(i, t, m, n), n;
+}
+async function x(i) {
+  const t = await createImageBitmap(i), r = document.createElement("canvas");
+  r.width = t.width, r.height = t.height;
+  const a = r.getContext("2d");
+  if (!a) throw new Error("loadAseprite: no 2D context (out of canvas memory?)");
+  return a.drawImage(t, 0, 0), t.close(), r;
+}
+export {
+  p as addAsepriteTextures,
+  A as loadAseprite
+};
+//# sourceMappingURL=loadAseprite.js.map

package/dist/assets/loadAseprite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadAseprite.js","sources":["../../src/assets/loadAseprite.ts"],"sourcesContent":["import { Rectangle, Texture } from 'pixi.js';\nimport { parseAseprite } from '../anim/parseAseprite';\nimport type { AsepriteSheet } from '../anim/asepriteTypes';\nimport type { CanvasTexture } from '../core/TextureRegistry';\nimport { resolveUrl, type AssetLoaderOptions } from './AssetLoader';\n\n/** Where an Aseprite sheet's texture goes: the stage's `TextureRegistry` satisfies it. */\nexport interface AsepriteTextureSink {\n  addCanvas(key: string, canvas: HTMLCanvasElement): CanvasTexture;\n}\n\n/** Fetch and decode hooks, as `AssetLoader` takes them (tests, custom transports, a base URL). */\nexport type AsepriteLoadOptions = Pick<AssetLoaderOptions, 'baseUrl' | 'fetch' | 'toCanvas'>;\n\n/**\n * Registers `canvas` (the sheet image) under `key` with one frame per sheet frame, named by its index (\"0\", \"1\"…), so\n * the clips `parseAseprite` returns play on an `Image` of that key as they are. A trimmed frame keeps its untrimmed\n * size and offset (Pixi's `orig` and `trim`), so a sprite anchored at its feet does not jump as the trim changes.\n */\nexport function addAsepriteTextures(textures: AsepriteTextureSink, key: string, canvas: HTMLCanvasElement, sheet: AsepriteSheet): CanvasTexture {\n  const tex = textures.addCanvas(key, canvas);\n  for (const f of sheet.frames) {\n    const { x, y, w, h } = f.rect;\n    if (!f.trimmed) {\n      tex.add(String(f.index), 0, x, y, w, h);\n      continue;\n    }\n    tex.frames.get(String(f.index))?.destroy();\n    tex.frames.set(\n      String(f.index),\n      new Texture({\n        source: tex.source,\n        frame: new Rectangle(x, y, w, h),\n        orig: new Rectangle(0, 0, f.sourceW, f.sourceH),\n        trim: new Rectangle(f.offsetX, f.offsetY, w, h),\n      }),\n    );\n  }\n  return tex;\n}\n\n/**\n * Loads an Aseprite export — the JSON, then the sheet image it names (resolved beside the JSON) — registers its\n * frames under `key` and returns the parsed sheet (clips, slices, layers, cues).\n *\n * ```ts\n * const [hero] = await Promise.all([loadAseprite(stage.textures, 'hero', 'art/hero.json'), assets.load()]);\n * const sprite = stage.add.image(0, 0, 'hero', 0);\n * const anim = new Animator(hero.clips, 'idle');\n * ```\n */\nexport async function loadAseprite(textures: AsepriteTextureSink, key: string, jsonUrl: string, options: AsepriteLoadOptions = {}): Promise<AsepriteSheet> {\n  const fetcher = options.fetch ?? ((url: string) => fetch(url));\n  const get = async (url: string) => {\n    let res;\n    try {\n      res = await fetcher(url);\n    } catch (err) {\n      throw new Error(`loadAseprite: could not fetch ${url}: ${err instanceof Error ? err.message : String(err)}`);\n    }\n    if (!res.ok) throw new Error(`loadAseprite: ${url} answered ${res.status}`);\n    return res;\n  };\n  const jsonFull = resolveUrl(jsonUrl, options.baseUrl ?? '');\n  const sheet = parseAseprite(await (await get(jsonFull)).json());\n  if (!sheet.image) throw new Error(`loadAseprite: ${jsonFull} names no sheet image (meta.image)`);\n  const blob = await (await get(resolveUrl(sheet.image, jsonFull))).blob();\n  const canvas = await (options.toCanvas ?? blobToCanvas)(blob);\n  addAsepriteTextures(textures, key, canvas, sheet);\n  return sheet;\n}\n\nasync function blobToCanvas(blob: Blob): Promise<HTMLCanvasElement> {\n  const bitmap = await createImageBitmap(blob);\n  const canvas = document.createElement('canvas');\n  canvas.width = bitmap.width;\n  canvas.height = bitmap.height;\n  const ctx = canvas.getContext('2d');\n  if (!ctx) throw new Error('loadAseprite: no 2D context (out of canvas memory?)');\n  ctx.drawImage(bitmap, 0, 0);\n  bitmap.close();\n  return canvas;\n}\n"],"names":["addAsepriteTextures","textures","key","canvas","sheet","tex","f","x","y","w","h","Texture","Rectangle","loadAseprite","jsonUrl","options","fetcher","url","get","res","err","jsonFull","resolveUrl","parseAseprite","blob","blobToCanvas","bitmap","ctx"],"mappings":";;;AAmBO,SAASA,EAAoBC,GAA+BC,GAAaC,GAA2BC,GAAqC;AAC9I,QAAMC,IAAMJ,EAAS,UAAUC,GAAKC,CAAM;AAC1C,aAAWG,KAAKF,EAAM,QAAQ;AAC5B,UAAM,EAAE,GAAAG,GAAG,GAAAC,GAAG,GAAAC,GAAG,GAAAC,EAAA,IAAMJ,EAAE;AACzB,QAAI,CAACA,EAAE,SAAS;AACd,MAAAD,EAAI,IAAI,OAAOC,EAAE,KAAK,GAAG,GAAGC,GAAGC,GAAGC,GAAGC,CAAC;AACtC;AAAA,IACF;AACA,IAAAL,EAAI,OAAO,IAAI,OAAOC,EAAE,KAAK,CAAC,GAAG,QAAA,GACjCD,EAAI,OAAO;AAAA,MACT,OAAOC,EAAE,KAAK;AAAA,MACd,IAAIK,EAAQ;AAAA,QACV,QAAQN,EAAI;AAAA,QACZ,OAAO,IAAIO,EAAUL,GAAGC,GAAGC,GAAGC,CAAC;AAAA,QAC/B,MAAM,IAAIE,EAAU,GAAG,GAAGN,EAAE,SAASA,EAAE,OAAO;AAAA,QAC9C,MAAM,IAAIM,EAAUN,EAAE,SAASA,EAAE,SAASG,GAAGC,CAAC;AAAA,MAAA,CAC/C;AAAA,IAAA;AAAA,EAEL;AACA,SAAOL;AACT;AAYA,eAAsBQ,EAAaZ,GAA+BC,GAAaY,GAAiBC,IAA+B,CAAA,GAA4B;AACzJ,QAAMC,IAAUD,EAAQ,UAAU,CAACE,MAAgB,MAAMA,CAAG,IACtDC,IAAM,OAAOD,MAAgB;AACjC,QAAIE;AACJ,QAAI;AACF,MAAAA,IAAM,MAAMH,EAAQC,CAAG;AAAA,IACzB,SAASG,GAAK;AACZ,YAAM,IAAI,MAAM,iCAAiCH,CAAG,KAAKG,aAAe,QAAQA,EAAI,UAAU,OAAOA,CAAG,CAAC,EAAE;AAAA,IAC7G;AACA,QAAI,CAACD,EAAI,GAAI,OAAM,IAAI,MAAM,iBAAiBF,CAAG,aAAaE,EAAI,MAAM,EAAE;AAC1E,WAAOA;AAAA,EACT,GACME,IAAWC,EAAWR,GAASC,EAAQ,WAAW,EAAE,GACpDX,IAAQmB,EAAc,OAAO,MAAML,EAAIG,CAAQ,GAAG,MAAM;AAC9D,MAAI,CAACjB,EAAM,MAAO,OAAM,IAAI,MAAM,iBAAiBiB,CAAQ,oCAAoC;AAC/F,QAAMG,IAAO,OAAO,MAAMN,EAAII,EAAWlB,EAAM,OAAOiB,CAAQ,CAAC,GAAG,KAAA,GAC5DlB,IAAS,OAAOY,EAAQ,YAAYU,GAAcD,CAAI;AAC5D,SAAAxB,EAAoBC,GAAUC,GAAKC,GAAQC,CAAK,GACzCA;AACT;AAEA,eAAeqB,EAAaD,GAAwC;AAClE,QAAME,IAAS,MAAM,kBAAkBF,CAAI,GACrCrB,IAAS,SAAS,cAAc,QAAQ;AAC9C,EAAAA,EAAO,QAAQuB,EAAO,OACtBvB,EAAO,SAASuB,EAAO;AACvB,QAAMC,IAAMxB,EAAO,WAAW,IAAI;AAClC,MAAI,CAACwB,EAAK,OAAM,IAAI,MAAM,qDAAqD;AAC/E,SAAAA,EAAI,UAAUD,GAAQ,GAAG,CAAC,GAC1BA,EAAO,MAAA,GACAvB;AACT;"}

package/dist/assets/takeCleanerWorker-DTcI_Jqr.js

@@ -0,0 +1,31 @@
+function m(l, h) {
+  const a = l[0]?.length ?? 0, f = 1 / Math.max(1, l.length), e = new Float32Array(a);
+  for (const t of l) for (let n = 0; n < a; n++) e[n] += t[n] * f;
+  let r = 0;
+  for (let t = 0; t < a; t++) {
+    const n = Math.abs(e[t]);
+    n > r && (r = n);
+  }
+  if (r < 5e-3) return null;
+  const i = r * 0.01;
+  let s = 0;
+  for (; s < a && Math.abs(e[s]) < i; ) s++;
+  let c = a;
+  for (; c > s && Math.abs(e[c - 1]) < i; ) c--;
+  if (c <= s) return null;
+  s = Math.max(0, s - Math.round(2e-3 * h));
+  const o = e.slice(s, c);
+  let M = 0;
+  for (let t = 0; t < o.length; t++) M += o[t] * o[t];
+  const d = Math.sqrt(M / o.length), g = Math.min(0.16 / Math.max(d, 1e-6), 0.95 / r), E = Math.min(o.length, Math.round(0.01 * h));
+  for (let t = 0; t < o.length; t++) {
+    const n = o.length - t;
+    o[t] *= g * (n < E ? n / E : 1);
+  }
+  return o;
+}
+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/takeCleanerWorker-DTcI_Jqr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"takeCleanerWorker-DTcI_Jqr.js","sources":["../src/audio/cleanTake.ts","../src/audio/takeCleanerWorker.ts"],"sourcesContent":["/*\n * Cleans one recorded take (`SampleBank`): folded to mono, the silence an encoder or the model leaves at the start cut\n * (a swing heard 30 ms late reads as lag) and at the end trimmed, and brought to one loudness (`LOUDNESS`, RMS of what\n * is left, never past `PEAK`), so takes from different prompts sit at one level. Pure: run in `takeCleanerWorker.ts`,\n * because on the main thread the first blows of a fight froze the game 70–170 ms a take on a Mac and several times\n * that on a phone (profiled).\n */\n\n/** Below this share of the take's own peak a sample counts as silence when trimming (-40 dB). */\nconst FLOOR = 0.01;\n/** A take whose peak is under this is treated as empty (about -46 dBFS): the model returned near-silence. */\nconst EMPTY = 0.005;\n/** Target RMS of a cleaned take (-16 dBFS) and the peak it may not pass. */\nconst LOUDNESS = 0.16;\nconst PEAK = 0.95;\n/** Kept before the first loud sample, so the attack is not clipped into a click (s). */\nconst LEAD = 0.002;\n/** A short fade over the cut end, so a trimmed tail does not click (s). */\nconst TAIL_FADE = 0.01;\n\n/** The cleaned mono samples, or null for a take that is silence. */\nexport function cleanSamples(channels: Float32Array[], sampleRate: number): Float32Array | null {\n  const n = channels[0]?.length ?? 0;\n  const k0 = 1 / Math.max(1, channels.length);\n  const mono = new Float32Array(n);\n  for (const ch of channels) for (let i = 0; i < n; i++) mono[i]! += ch[i]! * k0;\n  let top = 0;\n  for (let i = 0; i < n; i++) {\n    const a = Math.abs(mono[i]!);\n    if (a > top) top = a;\n  }\n  if (top < EMPTY) return null;\n  const floor = top * FLOOR;\n  let start = 0;\n  while (start < n && Math.abs(mono[start]!) < floor) start++;\n  let end = n;\n  while (end > start && Math.abs(mono[end - 1]!) < floor) end--;\n  if (end <= start) return null;\n  start = Math.max(0, start - Math.round(LEAD * sampleRate));\n  const data = mono.slice(start, end);\n  let power = 0;\n  for (let i = 0; i < data.length; i++) power += data[i]! * data[i]!;\n  const rms = Math.sqrt(power / data.length);\n  const k = Math.min(LOUDNESS / Math.max(rms, 1e-6), PEAK / top);\n  const fade = Math.min(data.length, Math.round(TAIL_FADE * sampleRate));\n  for (let i = 0; i < data.length; i++) {\n    const left = data.length - i;\n    data[i]! *= k * (left < fade ? left / fade : 1);\n  }\n  return data;\n}\n","import { cleanSamples } from './cleanTake';\n\n/* Cleans recorded takes off the main thread (`SampleBank`); one message per take, answered with its id. */\nself.onmessage = (e: MessageEvent<{ id: number; channels: Float32Array[]; sampleRate: number }>) => {\n  const { id, channels, sampleRate } = e.data;\n  const data = cleanSamples(channels, sampleRate);\n  self.postMessage({ id, data }, data ? { transfer: [data.buffer as ArrayBuffer] } : undefined);\n};\n"],"names":["cleanSamples","channels","sampleRate","n","k0","mono","ch","i","top","a","floor","start","end","data","power","rms","k","fade","left","e","id"],"mappings":"AAqBO,SAASA,EAAaC,GAA0BC,GAAyC;AAC9F,QAAMC,IAAIF,EAAS,CAAC,GAAG,UAAU,GAC3BG,IAAK,IAAI,KAAK,IAAI,GAAGH,EAAS,MAAM,GACpCI,IAAO,IAAI,aAAaF,CAAC;AAC/B,aAAWG,KAAML,EAAU,UAASM,IAAI,GAAGA,IAAIJ,GAAGI,IAAK,CAAAF,EAAKE,CAAC,KAAMD,EAAGC,CAAC,IAAKH;AAC5E,MAAII,IAAM;AACV,WAASD,IAAI,GAAGA,IAAIJ,GAAGI,KAAK;AAC1B,UAAME,IAAI,KAAK,IAAIJ,EAAKE,CAAC,CAAE;AAC3B,IAAIE,IAAID,MAAKA,IAAMC;AAAA,EACrB;AACA,MAAID,IAAM,KAAO,QAAO;AACxB,QAAME,IAAQF,IAAM;AACpB,MAAIG,IAAQ;AACZ,SAAOA,IAAQR,KAAK,KAAK,IAAIE,EAAKM,CAAK,CAAE,IAAID,IAAO,CAAAC;AACpD,MAAIC,IAAMT;AACV,SAAOS,IAAMD,KAAS,KAAK,IAAIN,EAAKO,IAAM,CAAC,CAAE,IAAIF,IAAO,CAAAE;AACxD,MAAIA,KAAOD,EAAO,QAAO;AACzB,EAAAA,IAAQ,KAAK,IAAI,GAAGA,IAAQ,KAAK,MAAM,OAAOT,CAAU,CAAC;AACzD,QAAMW,IAAOR,EAAK,MAAMM,GAAOC,CAAG;AAClC,MAAIE,IAAQ;AACZ,WAASP,IAAI,GAAGA,IAAIM,EAAK,QAAQN,IAAK,CAAAO,KAASD,EAAKN,CAAC,IAAKM,EAAKN,CAAC;AAChE,QAAMQ,IAAM,KAAK,KAAKD,IAAQD,EAAK,MAAM,GACnCG,IAAI,KAAK,IAAI,OAAW,KAAK,IAAID,GAAK,IAAI,GAAG,OAAOP,CAAG,GACvDS,IAAO,KAAK,IAAIJ,EAAK,QAAQ,KAAK,MAAM,OAAYX,CAAU,CAAC;AACrE,WAASK,IAAI,GAAGA,IAAIM,EAAK,QAAQN,KAAK;AACpC,UAAMW,IAAOL,EAAK,SAASN;AAC3B,IAAAM,EAAKN,CAAC,KAAMS,KAAKE,IAAOD,IAAOC,IAAOD,IAAO;AAAA,EAC/C;AACA,SAAOJ;AACT;AC/CA,KAAK,YAAY,CAACM,MAAkF;AAClG,QAAM,EAAE,IAAAC,GAAI,UAAAnB,GAAU,YAAAC,EAAA,IAAeiB,EAAE,MACjCN,IAAOb,EAAaC,GAAUC,CAAU;AAC9C,OAAK,YAAY,EAAE,IAAAkB,GAAI,MAAAP,EAAA,GAAQA,IAAO,EAAE,UAAU,CAACA,EAAK,MAAqB,EAAA,IAAM,MAAS;AAC9F;"}

package/dist/audio/Footsteps.js

@@ -0,0 +1,26 @@
+import { sound as n } from "./SoundEngine.js";
+class u {
+  constructor(s) {
+    this.options = s;
+  }
+  options;
+  surfaceAt = () => {
+  };
+  /** Where the surface of a world point comes from; `undefined` is the fallback surface. */
+  setSurfaceAt(s) {
+    this.surfaceAt = s;
+  }
+  /** The surface at a world point. */
+  surface(s, o) {
+    return this.surfaceAt(s, o) ?? this.options.fallback;
+  }
+  /** One step (or a beat of hooves when `mounted`) at the feet, world x/y; `local` is the player's own. */
+  step(s, o, e, a = !1) {
+    const t = this.options, r = t.sounds[this.surface(s, o)] ?? t.sounds[t.fallback];
+    r && n.play(a ? r.hoof ?? r.step : r.step, { x: s, y: o, local: e, gain: t.gain ?? 0.5, range: t.range ?? 200, minor: !0 });
+  }
+}
+export {
+  u as Footsteps
+};
+//# sourceMappingURL=Footsteps.js.map

package/dist/audio/Footsteps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Footsteps.js","sources":["../../src/audio/Footsteps.ts"],"sourcesContent":["import { sound } from './SoundEngine';\n\n/** What a surface sounds like underfoot: a step, and a beat of hooves (a mount) if it differs. */\nexport interface SurfaceSounds {\n  step: string;\n  hoof?: string;\n}\n\nexport interface FootstepOptions {\n  /** Per surface name (`'grass'`, `'stone'`, `'wood'`…), the sounds a foot makes on it. */\n  sounds: Record<string, SurfaceSounds>;\n  /** The surface of anywhere `surfaceAt` does not name. */\n  fallback: string;\n  /** Weight of a step against other sounds (default 0.5). */\n  gain?: number;\n  /** Beyond this (world px) nobody else's steps are heard (default 200). */\n  range?: number;\n}\n\n/**\n * Footsteps by the ground under the feet. The game says what a point is made of (`surfaceAt`: a tile's surface, a\n * Tiled property, a floor collider), and calls `step` on each beat of a walk or a gait; the sound is the surface's,\n * through `sound` at the feet, quieter and muffled with distance like every other sound, and dropped first when too\n * many sounds play at once.\n */\nexport class Footsteps {\n  private surfaceAt: (x: number, y: number) => string | undefined = () => undefined;\n\n  constructor(private readonly options: FootstepOptions) {}\n\n  /** Where the surface of a world point comes from; `undefined` is the fallback surface. */\n  setSurfaceAt(surfaceAt: (x: number, y: number) => string | undefined): void {\n    this.surfaceAt = surfaceAt;\n  }\n\n  /** The surface at a world point. */\n  surface(x: number, y: number): string {\n    return this.surfaceAt(x, y) ?? this.options.fallback;\n  }\n\n  /** One step (or a beat of hooves when `mounted`) at the feet, world x/y; `local` is the player's own. */\n  step(x: number, y: number, local: boolean, mounted = false): void {\n    const o = this.options;\n    const s = o.sounds[this.surface(x, y)] ?? o.sounds[o.fallback];\n    if (!s) return;\n    sound.play(mounted ? (s.hoof ?? s.step) : s.step, { x, y, local, gain: o.gain ?? 0.5, range: o.range ?? 200, minor: true });\n  }\n}\n"],"names":["Footsteps","options","surfaceAt","x","y","local","mounted","o","s","sound"],"mappings":";AAyBO,MAAMA,EAAU;AAAA,EAGrB,YAA6BC,GAA0B;AAA1B,SAAA,UAAAA;AAAA,EAA2B;AAAA,EAA3B;AAAA,EAFrB,YAA0D,MAAA;AAAA;AAAA;AAAA,EAKlE,aAAaC,GAA+D;AAC1E,SAAK,YAAYA;AAAA,EACnB;AAAA;AAAA,EAGA,QAAQC,GAAWC,GAAmB;AACpC,WAAO,KAAK,UAAUD,GAAGC,CAAC,KAAK,KAAK,QAAQ;AAAA,EAC9C;AAAA;AAAA,EAGA,KAAKD,GAAWC,GAAWC,GAAgBC,IAAU,IAAa;AAChE,UAAMC,IAAI,KAAK,SACTC,IAAID,EAAE,OAAO,KAAK,QAAQJ,GAAGC,CAAC,CAAC,KAAKG,EAAE,OAAOA,EAAE,QAAQ;AAC7D,IAAKC,KACLC,EAAM,KAAKH,IAAWE,EAAE,QAAQA,EAAE,OAAQA,EAAE,MAAM,EAAE,GAAAL,GAAG,GAAAC,GAAG,OAAAC,GAAO,MAAME,EAAE,QAAQ,KAAK,OAAOA,EAAE,SAAS,KAAK,OAAO,GAAA,CAAM;AAAA,EAC5H;AACF;"}

package/dist/audio/MusicPlayer.js

@@ -0,0 +1,78 @@
+import { engineSettings as n } from "../settings.js";
+import { isTouchUi as r } from "../platform/touch.js";
+import { ElementVoice as i } from "./music/ElementVoice.js";
+import { GraphVoice as o } from "./music/GraphVoice.js";
+import { MusicChannel as h } from "./music/MusicChannel.js";
+import { elementVolumeLocked as u } from "./music/musicVoice.js";
+class a {
+  channels = /* @__PURE__ */ new Map();
+  route = "auto";
+  graph = null;
+  graphLocked = null;
+  pauseInBackground = null;
+  installed = !1;
+  /** Picks the route and background behaviour; call before the first track for the route to apply to every track. */
+  configure(e) {
+    return e.route && (this.route = e.route), e.pauseInBackground !== void 0 && (this.pauseInBackground = e.pauseInBackground), this;
+  }
+  /** The channel named `name`, made on first use. */
+  channel(e = "music") {
+    let t = this.channels.get(e);
+    return t || (this.install(), t = new h(() => n.getState().musicVolume, (s) => this.voiceFor(s)), this.channels.set(e, t)), t;
+  }
+  /** The url the `'music'` channel plays, if any. */
+  get current() {
+    return this.channels.get("music")?.current ?? null;
+  }
+  /** Plays `url` on the `'music'` channel. */
+  play(e, t) {
+    this.channel().play(e, t);
+  }
+  /** Fades every channel out. */
+  stop(e = 1200) {
+    for (const t of this.channels.values()) t.stop(e);
+  }
+  pause() {
+    for (const e of this.channels.values()) e.pause();
+  }
+  resume() {
+    this.wake();
+  }
+  destroy() {
+    for (const e of this.channels.values()) e.dispose();
+    this.channels.clear(), this.graph?.close(), this.graph = null;
+  }
+  voiceFor(e) {
+    const t = this.throughGraph() ? this.context() : null;
+    return t ? new o(e, t) : new i(e);
+  }
+  throughGraph() {
+    return this.route !== "auto" ? this.route === "graph" : this.graphLocked ??= u();
+  }
+  context() {
+    if (this.graph) return this.graph;
+    const e = globalThis.AudioContext ?? globalThis.webkitAudioContext;
+    return e ? (this.graph = new e(), this.graph) : null;
+  }
+  /** Retries every refused start and follows the volume; the graph's context resumes inside the gesture that called it. */
+  wake() {
+    if (this.graph && this.graph.state !== "running" && this.graph.resume().catch(() => {
+    }), !(typeof document < "u" && document.hidden))
+      for (const e of this.channels.values()) e.refresh();
+  }
+  install() {
+    if (this.installed || typeof window > "u") return;
+    this.installed = !0;
+    const e = () => this.wake();
+    for (const t of ["pointerdown", "touchend", "keydown"]) window.addEventListener(t, e, { capture: !0 });
+    n.subscribe(e), document.addEventListener("visibilitychange", () => {
+      (this.pauseInBackground ?? r()) && (document.hidden ? this.pause() : e());
+    });
+  }
+}
+const w = new a();
+export {
+  a as MusicPlayer,
+  w as music
+};
+//# sourceMappingURL=MusicPlayer.js.map

package/dist/audio/MusicPlayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MusicPlayer.js","sources":["../../src/audio/MusicPlayer.ts"],"sourcesContent":["import { engineSettings } from '../settings';\nimport { isTouchUi } from '../platform/touch';\nimport { ElementVoice } from './music/ElementVoice';\nimport { GraphVoice } from './music/GraphVoice';\nimport { MusicChannel, type PlayOptions } from './music/MusicChannel';\nimport { elementVolumeLocked, type MusicVoice } from './music/musicVoice';\n\nexport type { PlayOptions } from './music/MusicChannel';\n\n/**\n * How music reaches the speaker: `'element'` on the `<audio>` element's own volume (nothing in between; a file from\n * another origin plays as it is), `'graph'` through a Web Audio gain (the only way where that volume is read-only),\n * `'auto'` (default) the graph only where it has to be (iOS).\n */\nexport type MusicRoute = 'auto' | 'element' | 'graph';\n\nexport interface MusicOptions {\n  route?: MusicRoute;\n  /** Stop the music while the page is hidden (an app sent to the background). Default: on touch devices. */\n  pauseInBackground?: boolean;\n}\n\n/**\n * Background music in layers: each named channel (`'music'` by default, `'ambience'`, any other) plays one looping\n * track at a time, crossfaded when it changes, all at `engineSettings.musicVolume`. Tracks stream through `<audio>`\n * elements (no decoding a whole song into memory).\n *\n * Browsers start sound only after a user gesture: a track played before one starts on the first tap or key. On iOS the\n * graph's context is woken inside that gesture too, and again after the app comes back from the background.\n *\n * ```ts\n * music.play('music/forest.ogg');                                     // the 'music' channel\n * music.channel('ambience').play('amb/wind.ogg', { volume: 0.5 });     // a second layer under it\n * music.play('music/boss.ogg', { fadeMs: 600 });                      // crossfades the first only\n * music.stop(2000);\n * ```\n */\nexport class MusicPlayer {\n  private readonly channels = new Map<string, MusicChannel>();\n  private route: MusicRoute = 'auto';\n  private graph: AudioContext | null = null;\n  private graphLocked: boolean | null = null;\n  private pauseInBackground: boolean | null = null;\n  private installed = false;\n\n  /** Picks the route and background behaviour; call before the first track for the route to apply to every track. */\n  configure(options: MusicOptions): this {\n    if (options.route) this.route = options.route;\n    if (options.pauseInBackground !== undefined) this.pauseInBackground = options.pauseInBackground;\n    return this;\n  }\n\n  /** The channel named `name`, made on first use. */\n  channel(name = 'music'): MusicChannel {\n    let ch = this.channels.get(name);\n    if (!ch) {\n      this.install();\n      ch = new MusicChannel(() => engineSettings.getState().musicVolume, (el) => this.voiceFor(el));\n      this.channels.set(name, ch);\n    }\n    return ch;\n  }\n\n  /** The url the `'music'` channel plays, if any. */\n  get current(): string | null {\n    return this.channels.get('music')?.current ?? null;\n  }\n\n  /** Plays `url` on the `'music'` channel. */\n  play(url: string, options?: PlayOptions): void {\n    this.channel().play(url, options);\n  }\n\n  /** Fades every channel out. */\n  stop(fadeMs = 1200): void {\n    for (const ch of this.channels.values()) ch.stop(fadeMs);\n  }\n\n  pause(): void {\n    for (const ch of this.channels.values()) ch.pause();\n  }\n\n  resume(): void {\n    this.wake();\n  }\n\n  destroy(): void {\n    for (const ch of this.channels.values()) ch.dispose();\n    this.channels.clear();\n    void this.graph?.close();\n    this.graph = null;\n  }\n\n  private voiceFor(el: HTMLAudioElement): MusicVoice {\n    const graph = this.throughGraph() ? this.context() : null;\n    return graph ? new GraphVoice(el, graph) : new ElementVoice(el);\n  }\n\n  private throughGraph(): boolean {\n    if (this.route !== 'auto') return this.route === 'graph';\n    return (this.graphLocked ??= elementVolumeLocked());\n  }\n\n  private context(): AudioContext | null {\n    if (this.graph) return this.graph;\n    const Ctor = (globalThis as { AudioContext?: typeof AudioContext; webkitAudioContext?: typeof AudioContext }).AudioContext ?? (globalThis as { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n    if (!Ctor) return null;\n    this.graph = new Ctor();\n    return this.graph;\n  }\n\n  /** Retries every refused start and follows the volume; the graph's context resumes inside the gesture that called it. */\n  private wake(): void {\n    if (this.graph && this.graph.state !== 'running') void this.graph.resume().catch(() => {});\n    if (typeof document !== 'undefined' && document.hidden) return;\n    for (const ch of this.channels.values()) ch.refresh();\n  }\n\n  private install(): void {\n    if (this.installed || typeof window === 'undefined') return;\n    this.installed = true;\n    const wake = () => this.wake();\n    // `touchend` is the gesture iOS accepts for starting media; the others are the desktop's\n    for (const type of ['pointerdown', 'touchend', 'keydown'] as const) window.addEventListener(type, wake, { capture: true });\n    engineSettings.subscribe(wake);\n    document.addEventListener('visibilitychange', () => {\n      if (!(this.pauseInBackground ?? isTouchUi())) return;\n      if (document.hidden) this.pause();\n      else wake();\n    });\n  }\n}\n\n/** A fade's value at `now`: linear from `from` to `to` over `ms`. */\nexport function fadeValue(f: { from: number; to: number; start: number; ms: number }, now: number): number {\n  if (f.ms <= 0 || now >= f.start + f.ms) return f.to;\n  if (now <= f.start) return f.from;\n  return f.from + ((f.to - f.from) * (now - f.start)) / f.ms;\n}\n\n/** The shared music player. */\nexport const music = new MusicPlayer();\n"],"names":["MusicPlayer","options","name","ch","MusicChannel","engineSettings","el","url","fadeMs","graph","GraphVoice","ElementVoice","elementVolumeLocked","Ctor","wake","type","isTouchUi","music"],"mappings":";;;;;;AAqCO,MAAMA,EAAY;AAAA,EACN,+BAAe,IAAA;AAAA,EACxB,QAAoB;AAAA,EACpB,QAA6B;AAAA,EAC7B,cAA8B;AAAA,EAC9B,oBAAoC;AAAA,EACpC,YAAY;AAAA;AAAA,EAGpB,UAAUC,GAA6B;AACrC,WAAIA,EAAQ,UAAO,KAAK,QAAQA,EAAQ,QACpCA,EAAQ,sBAAsB,WAAW,KAAK,oBAAoBA,EAAQ,oBACvE;AAAA,EACT;AAAA;AAAA,EAGA,QAAQC,IAAO,SAAuB;AACpC,QAAIC,IAAK,KAAK,SAAS,IAAID,CAAI;AAC/B,WAAKC,MACH,KAAK,QAAA,GACLA,IAAK,IAAIC,EAAa,MAAMC,EAAe,SAAA,EAAW,aAAa,CAACC,MAAO,KAAK,SAASA,CAAE,CAAC,GAC5F,KAAK,SAAS,IAAIJ,GAAMC,CAAE,IAErBA;AAAA,EACT;AAAA;AAAA,EAGA,IAAI,UAAyB;AAC3B,WAAO,KAAK,SAAS,IAAI,OAAO,GAAG,WAAW;AAAA,EAChD;AAAA;AAAA,EAGA,KAAKI,GAAaN,GAA6B;AAC7C,SAAK,QAAA,EAAU,KAAKM,GAAKN,CAAO;AAAA,EAClC;AAAA;AAAA,EAGA,KAAKO,IAAS,MAAY;AACxB,eAAWL,KAAM,KAAK,SAAS,SAAU,CAAAA,EAAG,KAAKK,CAAM;AAAA,EACzD;AAAA,EAEA,QAAc;AACZ,eAAWL,KAAM,KAAK,SAAS,OAAA,KAAa,MAAA;AAAA,EAC9C;AAAA,EAEA,SAAe;AACb,SAAK,KAAA;AAAA,EACP;AAAA,EAEA,UAAgB;AACd,eAAWA,KAAM,KAAK,SAAS,OAAA,KAAa,QAAA;AAC5C,SAAK,SAAS,MAAA,GACT,KAAK,OAAO,MAAA,GACjB,KAAK,QAAQ;AAAA,EACf;AAAA,EAEQ,SAASG,GAAkC;AACjD,UAAMG,IAAQ,KAAK,aAAA,IAAiB,KAAK,YAAY;AACrD,WAAOA,IAAQ,IAAIC,EAAWJ,GAAIG,CAAK,IAAI,IAAIE,EAAaL,CAAE;AAAA,EAChE;AAAA,EAEQ,eAAwB;AAC9B,WAAI,KAAK,UAAU,SAAe,KAAK,UAAU,UACzC,KAAK,gBAAgBM,EAAA;AAAA,EAC/B;AAAA,EAEQ,UAA+B;AACrC,QAAI,KAAK,MAAO,QAAO,KAAK;AAC5B,UAAMC,IAAQ,WAAgG,gBAAiB,WAA4D;AAC3L,WAAKA,KACL,KAAK,QAAQ,IAAIA,EAAA,GACV,KAAK,SAFM;AAAA,EAGpB;AAAA;AAAA,EAGQ,OAAa;AAEnB,QADI,KAAK,SAAS,KAAK,MAAM,UAAU,aAAgB,KAAK,MAAM,OAAA,EAAS,MAAM,MAAM;AAAA,IAAC,CAAC,GACrF,SAAO,WAAa,OAAe,SAAS;AAChD,iBAAWV,KAAM,KAAK,SAAS,OAAA,KAAa,QAAA;AAAA,EAC9C;AAAA,EAEQ,UAAgB;AACtB,QAAI,KAAK,aAAa,OAAO,SAAW,IAAa;AACrD,SAAK,YAAY;AACjB,UAAMW,IAAO,MAAM,KAAK,KAAA;AAExB,eAAWC,KAAQ,CAAC,eAAe,YAAY,SAAS,EAAY,QAAO,iBAAiBA,GAAMD,GAAM,EAAE,SAAS,IAAM;AACzH,IAAAT,EAAe,UAAUS,CAAI,GAC7B,SAAS,iBAAiB,oBAAoB,MAAM;AAClD,OAAM,KAAK,qBAAqBE,EAAA,OAC5B,SAAS,SAAQ,KAAK,MAAA,IACrBF,EAAA;AAAA,IACP,CAAC;AAAA,EACH;AACF;AAUO,MAAMG,IAAQ,IAAIjB,EAAA;"}