@sculptr/sdk 0.0.0-stage → 2.17.1

package/dist/index.js

@@ -0,0 +1,663 @@
+//#region src/resources/object.ts
+var e = function(e) {
+	let { identity: t, hostApi: n, prefix: r, objects: i, internalReceive: a, internalCreate: o, normalizeEventName: s, context: c, queue: l, scratch: u } = e, d = /* @__PURE__ */ new Map();
+	for (let e of i) for (let n of Object.keys(e.receive ?? {})) {
+		let r = s(n), i = d.get(r);
+		if (i) throw Error(`mod ${t.id}: both ${i} and ${e.name} receive ${JSON.stringify(r)}. They would race for each message; give it to one of them.`);
+		d.set(r, e.name);
+	}
+	for (let e of Object.keys(a)) d.set(e, `${r}inbox`);
+	let f = (e, t) => `while (ds_list_size(${l(e)}) > 0) {
+    ${u("pl")} = ds_list_find_value(${l(e)}, 0);
+    ds_list_delete(${l(e)}, 0);
+    ${t}
+  }`;
+	if (d.size > 0) {
+		let e = [...d.keys()], t = e.map((e, t) => `${t === 0 ? "if" : "else if"} (${u("ev")} == "${e}") ds_list_add(${l(e)}, ${u("pl")});`).join("\n"), i = Object.entries(a).map(([e, t]) => f(e, t)).join("\n");
+		n.resource.create({
+			kind: "object",
+			name: `${r}inbox`,
+			persistent: !0,
+			visible: !1,
+			depth: 0,
+			events: {
+				create: e.map((e) => `${l(e)} = ds_list_create();`).join("\n") + o,
+				step: i || void 0,
+				beginStep: `${n.gml.receive(u("m"))}
+while (${u("m")} != "") {
+  ${u("at")} = string_pos(" ", ${u("m")});
+  if (${u("at")} > 1) {
+    ${u("ev")} = string_copy(${u("m")}, 1, ${u("at")} - 1);
+    ${u("pl")} = string_delete(${u("m")}, 1, ${u("at")});
+    ${t}
+  }
+  ${n.gml.receive(u("m"))}
+}`
+			}
+		});
+	}
+	for (let e of i) {
+		let t = (t) => t?.(c(e)), i = [Object.entries(e.receive ?? {}).map(([t, n]) => f(s(t), n({
+			...c(e),
+			payload: u("pl")
+		}))).join("\n"), t(e.events?.step)].filter(Boolean).join("\n"), a = {};
+		for (let [n, r] of [
+			["create", t(e.events?.create)],
+			["beginStep", t(e.events?.beginStep)],
+			["step", i || void 0],
+			["endStep", t(e.events?.endStep)],
+			["draw", t(e.events?.draw)],
+			["destroy", t(e.events?.destroy)]
+		]) r && (a[n] = r);
+		n.resource.create({
+			kind: "object",
+			name: `${r}o_${e.name}`,
+			depth: e.depth,
+			persistent: e.persistent,
+			visible: e.visible,
+			events: a
+		});
+	}
+}, t = function(e) {
+	let t = -1, n = (e) => {
+		switch (e.k) {
+			case "arg":
+				e.index !== null && e.index < 16 && (t = Math.max(t, e.index));
+				break;
+			case "field":
+				n(e.of);
+				break;
+			case "index":
+				n(e.of), e.at.forEach(n);
+				break;
+			case "op":
+				e.args.forEach(n);
+				break;
+			case "call": e.args.forEach(n);
+		}
+	}, r = (e) => {
+		for (let t of e) t.k === "assign" ? (n(t.target), n(t.value)) : t.k === "call" ? n(t.call) : t.k === "if" ? (n(t.cond), r(t.then), r(t.else)) : t.k === "with" ? (n(t.target), r(t.body)) : t.k === "loop" ? r(t.body) : t.k === "switch" ? (n(t.value), t.bodies.forEach(r)) : t.k === "exit" && t.value && n(t.value);
+	};
+	return r(e), t;
+}, n = /^[A-Za-z][A-Za-z0-9_-]*$/u, r = /^[A-Za-z][A-Za-z0-9_]*$/u, i = /^[A-Za-z0-9_.-]+$/u, a = function(e) {
+	e.hooks.forEach(({ script: n, wrap: r }, i) => {
+		let a = `${e.prefix}__orig${i}_${n}`, o = t(e.content.scripts.find((e) => e.name === n)?.body ?? []) + 1, s = `${e.prefix}__fwd${i}`, c = `global.${e.prefix}__hc${i}`, l = `global.${e.prefix}__ha${i}`, u = `global.${e.prefix}__hi${i}`, d = Array.from({ length: 17 }, (e, t) => {
+			let n = Array.from({ length: t }, (e, t) => `${l}[${t}]`).join(", ");
+			return `  case ${t}: return ${a}(${n});`;
+		}).join("\n");
+		e.hostApi.resource.create({
+			kind: "script",
+			name: s,
+			source: `switch (${c}) {\n${d}\n}\nreturn 0;`
+		});
+		let f = r({
+			engine: e.hostApi.target.engine,
+			original: {
+				call: (...e) => e.length === 0 ? `${s}()` : `${a}(${e.join(", ")})`,
+				arg: (e) => e >= 0 && e < 16 ? `argument${e}` : `argument[${e}]`,
+				argumentCount: "argument_count"
+			},
+			send: e.send,
+			call: e.call
+		});
+		e.hostApi.resource.create({
+			kind: "hook",
+			script: n,
+			original: a,
+			source: `
+        ${c} = argument_count;
+        ${u} = 0;
+        while (${u} < argument_count) {
+          ${l}[${u}] = argument[${u}];
+          ${u} += 1;
+        }
+        ${o > 0 ? `if (0) { ${l}[${o - 1}] = argument${o - 1}; }\n` : ""}${f}`
+		});
+	});
+};
+function o(e) {
+	switch (e.k) {
+		case "assign": return e.target.k === "var" ? `an assignment to ${e.target.name}` : "an assignment";
+		case "call": return `a call to ${e.call.name}`;
+		case "exit": return e.value ? "a return" : "an exit";
+		default: return `a ${e.k} statement`;
+	}
+}
+function s(e, t) {
+	let n = t.at.at;
+	if (n === void 0) throw Error(`mod ${e}: cannot insert at ${o(t.at)} -- this game's engine could not place it, so there is nothing to insert around. Statements without a place include the parts of a \`for\` header and temporaries a decompiler invented.`);
+	if (t.place !== "before" && t.place !== "after" && t.place !== "instead") throw Error(`mod ${e}: an insertion's place is "before", "after" or "instead", not ${JSON.stringify(t.place)}`);
+	if (t.place === "after" && t.at.k === "exit") throw Error(`mod ${e}: nothing follows ${o(t.at)}, so there is no "after" to insert at. Use "before" to run something on the way out.`);
+	return n;
+}
+var c = function(e) {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e.inserts) {
+		let r = n.body({
+			engine: e.hostApi.target.engine,
+			send: e.send,
+			call: e.call
+		}), i = t.get(r);
+		i === void 0 && (i = `${e.prefix}__ins${t.size}`, t.set(r, i), e.hostApi.resource.create({
+			kind: "script",
+			name: i,
+			source: r
+		})), e.hostApi.resource.create({
+			kind: "insert",
+			at: n.at,
+			place: n.place,
+			call: i
+		});
+	}
+}, l = function(e) {
+	for (let t of e.scripts) {
+		let n = {};
+		(t.args ?? []).forEach((i, a) => {
+			if (!r.test(i)) throw Error(`mod ${e.identity.id}: script ${JSON.stringify(t.name)} has an argument called ${JSON.stringify(i)}, which is not a usable name`);
+			n[i] = `argument${a}`;
+		}), e.hostApi.resource.create({
+			kind: "script",
+			name: `${e.prefix}s_${t.name}`,
+			source: t.body({
+				engine: e.hostApi.target.engine,
+				a: n,
+				send: e.send,
+				call: e.call
+			})
+		});
+	}
+}, u = 15e3, d = 2e3, f = (e) => e[0] === 137 && e[1] === 80 ? {
+	extension: "png",
+	type: "image/png"
+} : e[0] === 255 && e[1] === 216 ? {
+	extension: "jpg",
+	type: "image/jpeg"
+} : e[0] === 66 && e[1] === 77 ? {
+	extension: "bmp",
+	type: "image/bmp"
+} : null, p = class extends Error {
+	constructor() {
+		super("superseded by a newer load after the game restarted");
+	}
+}, m = async function(e) {
+	if (typeof e != "string") return e instanceof Uint8Array ? e : new Uint8Array(e);
+	if (e.startsWith("data:")) {
+		let t = e.indexOf(",");
+		if (t < 0) throw Error("that data: URI has no comma in it");
+		let n = e.slice(0, t), r = e.slice(t + 1);
+		if (!n.endsWith(";base64")) return new TextEncoder().encode(decodeURIComponent(r));
+		let i = atob(r), a = new Uint8Array(i.length);
+		for (let e = 0; e < i.length; e += 1) a[e] = i.charCodeAt(e);
+		return a;
+	}
+	let t = await fetch(e, { cache: "no-store" });
+	if (!t.ok) throw Error(`${e}: ${t.status}`);
+	return new Uint8Array(await t.arrayBuffer());
+}, h = async function(e, t) {
+	if (typeof OffscreenCanvas == "function" && typeof createImageBitmap == "function") {
+		let n = await Promise.all(e.map((e, t) => {
+			let n = f(e);
+			if (!n) throw Error(`frame ${t + 1} is not a PNG, JPEG or BMP`);
+			return createImageBitmap(new Blob([e], { type: n.type }));
+		})), r = n[0];
+		for (let [e, t] of n.entries()) if (t.width !== r.width || t.height !== r.height) throw Error(`frame ${e + 1} is ${t.width}x${t.height} but frame 1 is ${r.width}x${r.height}; every frame of a sprite is the same size`);
+		let i = t ? Math.min(1, t / Math.max(r.width, r.height)) : 1, a = Math.max(1, Math.round(r.width * i)), o = Math.max(1, Math.round(r.height * i)), s = new OffscreenCanvas(a * n.length, o), c = s.getContext("2d");
+		return n.forEach((e, t) => {
+			c.drawImage(e, t * a, 0, a, o), e.close();
+		}), new Uint8Array(await (await s.convertToBlob({ type: "image/png" })).arrayBuffer());
+	}
+	throw Error("this host has no canvas to compose a sprite strip with");
+}, g = async function(e, t, n) {
+	if (typeof OffscreenCanvas == "function" && typeof createImageBitmap == "function") {
+		let r = await createImageBitmap(new Blob([e], { type: t })), i = n ? Math.min(1, n / Math.max(r.width, r.height)) : 1, a = Math.max(1, Math.round(r.width * i)), o = Math.max(1, Math.round(r.height * i)), s = new OffscreenCanvas(a, o);
+		return s.getContext("2d").drawImage(r, 0, 0, a, o), r.close(), new Uint8Array(await (await s.convertToBlob({ type: "image/png" })).arrayBuffer());
+	}
+	throw Error("this host has no canvas to re-encode a picture with");
+}, _ = (e) => e === "gm8" ? "temp_directory + \"\\\"" : "game_save_id", v = {
+	put: "__spr_put",
+	ok: "__spr_ok",
+	failed: "__spr_failed",
+	hello: "__spr_hello",
+	where: "__spr_where"
+}, y = function(e) {
+	let t = null, n = "", r, i = new Promise((e) => {
+		r = e;
+	}), a = Promise.resolve(), o = new Promise((t) => {
+		e.hostApi.on("start", t);
+	}), s = async function(t, n) {
+		let r = Array.isArray(t) ? t : [t];
+		if (r.length === 0) throw Error("there is no picture in that list");
+		let i = await Promise.all(r.map((e) => m(e))), a = n.frames ?? 1;
+		if (i.length > 1) return {
+			bytes: await h(i, n.maxSize),
+			extension: "png",
+			frames: i.length * a
+		};
+		let o = i[0], s = f(o);
+		if (!s) throw Error("those bytes are not a PNG, JPEG or BMP");
+		let c = e.hostApi.target.engine === "gms" && s.extension !== "png", l = n.maxSize !== void 0;
+		return !c && !l ? {
+			bytes: o,
+			extension: s.extension,
+			frames: a
+		} : {
+			bytes: await g(o, s.type, n.maxSize),
+			extension: "png",
+			frames: a
+		};
+	}, c = function(n, r, i, a) {
+		return new Promise((o, s) => {
+			let c = (e, n) => {
+				clearTimeout(d), t = null, e ? s(e) : o(n);
+			};
+			t = {
+				slot: n,
+				done: (e) => c(null, e),
+				failed: (e) => c(Error(e)),
+				abandon: () => c(new p())
+			};
+			let l = r.origin ?? {
+				x: 0,
+				y: 0
+			};
+			e.sendInternal(v.put, `${n} ${i} ${l.x} ${l.y} ${a}`);
+			let d = setTimeout(() => c(/* @__PURE__ */ Error(`the game never answered about ${a}`)), u);
+		});
+	};
+	return {
+		loadSprite: function(t, r, l, u = () => !0) {
+			let f = async () => {
+				let a = await s(l, r);
+				if (await o, await Promise.race([i, new Promise((e) => {
+					setTimeout(e, d);
+				})]), !u()) throw new p();
+				let f = await e.hostApi.files.write(`${t}.${a.extension}`, a.bytes, n);
+				if (!u()) throw new p();
+				return c(t, r, a.frames, f);
+			}, m = a.then(f, f);
+			return a = m.catch(() => {}), m;
+		},
+		where: (e) => {
+			n = e, r();
+		},
+		done: (e, n) => {
+			t?.slot === e && t.done(n);
+		},
+		failed: (e, n) => {
+			t?.slot === e && t.failed(n);
+		},
+		abandon: () => t?.abandon()
+	};
+}, b = function(e) {
+	let { hostApi: t, prefix: n, sprites: r, payload: i, sendInternalGml: a } = e;
+	if (r.length === 0) return {};
+	let o = (e) => `global.${n}__${e}`, s = `${n}__sprfield`, c = `${n}__sprrest`;
+	t.resource.create({
+		kind: "script",
+		name: s,
+		source: `${o("fs")} = argument0;
+${o("fn")} = 1;
+while (${o("fn")} < argument1) {
+  ${o("fat")} = string_pos(" ", ${o("fs")});
+  if (${o("fat")} == 0) return "";
+  ${o("fs")} = string_delete(${o("fs")}, 1, ${o("fat")});
+  ${o("fn")} += 1;
+}
+${o("fat")} = string_pos(" ", ${o("fs")});
+if (${o("fat")} > 0) ${o("fs")} = string_copy(${o("fs")}, 1, ${o("fat")} - 1);
+return ${o("fs")};`
+	}), t.resource.create({
+		kind: "script",
+		name: c,
+		source: `${o("rs")} = argument0;
+${o("rn")} = 1;
+while (${o("rn")} < argument1) {
+  ${o("rat")} = string_pos(" ", ${o("rs")});
+  if (${o("rat")} == 0) return "";
+  ${o("rs")} = string_delete(${o("rs")}, 1, ${o("rat")});
+  ${o("rn")} += 1;
+}
+return ${o("rs")};`
+	});
+	let l = t.target.engine === "gm8" ? `if (!file_exists(${o("sprfile")})) {
+      ${a(v.failed, `${o("sprslot")} + " nothing at " + ${o("sprfile")}`)}
+      exit;
+    }` : "", u = r.map(({ name: e }) => `if (${o("sprslot")} == "${e}") {
+      if (is_real(global.${n}spr_${e}) && global.${n}spr_${e} >= 0) sprite_delete(global.${n}spr_${e});
+      global.${n}spr_${e} = ${o("sprnew")};
+    }`).join(" else ");
+	return { [v.put]: `${o("sprslot")} = ${s}(${i}, 1);
+    ${o("sprimgs")} = real(${s}(${i}, 2));
+    ${o("sprox")} = real(${s}(${i}, 3));
+    ${o("sproy")} = real(${s}(${i}, 4));
+    ${o("sprfile")} = ${c}(${i}, 5);
+    ${l}
+    // is_real first: a game script named sprite_add shadows the builtin.
+    ${o("sprnew")} = sprite_add(${o("sprfile")}, ${o("sprimgs")}, false, false, ${o("sprox")}, ${o("sproy")});
+    if (is_real(${o("sprnew")}) && ${o("sprnew")} >= 0) {
+      ${u}
+      ${a(v.ok, `${o("sprslot")} + " " + string(sprite_get_width(${o("sprnew")})) + " " + string(sprite_get_height(${o("sprnew")}))`)}
+    } else {
+      ${a(v.failed, `${o("sprslot")} + " sprite_add answered " + string(${o("sprnew")})`)}
+    }` };
+}, x = function(e) {
+	let { engine: t, prefix: n, sprites: r, sendInternalGml: i } = e;
+	return r.length === 0 ? "" : `
+${r.map(({ name: e }) => `global.${n}spr_${e} = -1;`).join("\n")}
+${i(v.where, _(t))}
+${i(v.hello)}`;
+}, S = function(e) {
+	let { identity: t, sprites: n, shown: r, spriteLoader: i, handlers: a } = e;
+	if (n.length === 0) return;
+	a.set(v.where, [(e) => i.where(e)]);
+	let o = 0;
+	a.set(v.hello, [() => {
+		if (o += 1, o === 1 || r.size === 0) return;
+		i.abandon();
+		let e = o, a = () => e === o;
+		for (let [e, o] of r) {
+			let r = n.find((t) => t.name === e)?.options ?? {};
+			i.loadSprite(e, r, o, a).catch((n) => {
+				n instanceof p || console.error(`[${t.id}] sprite ${JSON.stringify(e)} is gone:`, n);
+			});
+		}
+	}]), a.set(v.ok, [(e) => {
+		let [t, n, r] = e.split(" ");
+		i.done(t ?? "", {
+			width: Number(n),
+			height: Number(r)
+		});
+	}]), a.set(v.failed, [(e) => {
+		let t = e.indexOf(" ");
+		i.failed(t < 0 ? e : e.slice(0, t), t < 0 ? "the game refused the picture" : e.slice(t + 1));
+	}]);
+}, C = {
+	up: "ArrowUp",
+	down: "ArrowDown",
+	left: "ArrowLeft",
+	right: "ArrowRight",
+	confirm: "ShiftLeft",
+	cancel: "KeyZ",
+	retry: "KeyR"
+}, w = [
+	"up",
+	"down",
+	"left",
+	"right",
+	"confirm",
+	"cancel",
+	"retry"
+];
+function T(e) {
+	return /^Pad(?:Button\d{1,2}|Axis\d{1,2}(?:Plus|Minus))$/u.test(e);
+}
+//#endregion
+//#region src/image/index.ts
+var E = [
+	137,
+	80,
+	78,
+	71,
+	13,
+	10,
+	26,
+	10
+], D = function(e) {
+	if (e.length < 24 || E.some((t, n) => e[n] !== t)) throw Error("that is not a PNG");
+	let t = (t) => (e[t] << 24 | e[t + 1] << 16 | e[t + 2] << 8 | e[t + 3]) >>> 0;
+	return {
+		width: t(16),
+		height: t(20)
+	};
+}, O = function(e, t) {
+	if (e.width <= 0 || e.height <= 0) throw Error("a slice needs a positive size");
+	if (e.x < 0 || e.y < 0 || e.x + e.width > t.width || e.y + e.height > t.height) throw Error(`slice ${e.width}x${e.height} at ${e.x},${e.y} falls outside a ${t.width}x${t.height} picture`);
+}, k = async function(e, t) {
+	if (O(t, D(e)), typeof OffscreenCanvas == "function" && typeof createImageBitmap == "function") {
+		let n = f(e);
+		if (!n) throw Error("that is not a PNG, JPEG or BMP");
+		let r = await createImageBitmap(new Blob([e], { type: n.type }));
+		try {
+			let e = new OffscreenCanvas(t.width, t.height), n = e.getContext("2d");
+			if (!n) throw Error("no 2d context");
+			n.drawImage(r, t.x, t.y, t.width, t.height, 0, 0, t.width, t.height);
+			let i = await e.convertToBlob({ type: "image/png" });
+			return new Uint8Array(await i.arrayBuffer());
+		} finally {
+			r.close();
+		}
+	}
+	throw Error("this host has no canvas to slice a picture with");
+};
+//#endregion
+//#region src/decompiled-gml.ts
+function* A(e) {
+	for (let t of e) switch (yield t, t.k) {
+		case "if":
+			yield* A(t.then), yield* A(t.else);
+			break;
+		case "with":
+		case "loop":
+			yield* A(t.body);
+			break;
+		case "switch": for (let e of t.bodies) yield* A(e);
+	}
+}
+//#endregion
+//#region src/keyboard/index.ts
+var j = {
+	Backspace: 8,
+	Tab: 9,
+	Enter: 13,
+	NumpadEnter: 13,
+	ShiftLeft: 16,
+	ShiftRight: 16,
+	ControlLeft: 17,
+	ControlRight: 17,
+	AltLeft: 18,
+	AltRight: 18,
+	Pause: 19,
+	CapsLock: 20,
+	Escape: 27,
+	Space: 32,
+	PageUp: 33,
+	PageDown: 34,
+	End: 35,
+	Home: 36,
+	ArrowLeft: 37,
+	ArrowUp: 38,
+	ArrowRight: 39,
+	ArrowDown: 40,
+	Insert: 45,
+	Delete: 46,
+	NumpadMultiply: 106,
+	NumpadAdd: 107,
+	NumpadSubtract: 109,
+	NumpadDecimal: 110,
+	NumpadDivide: 111,
+	Semicolon: 186,
+	Equal: 187,
+	Comma: 188,
+	Minus: 189,
+	Period: 190,
+	Slash: 191,
+	Backquote: 192,
+	BracketLeft: 219,
+	Backslash: 220,
+	BracketRight: 221,
+	Quote: 222
+}, M = function(e) {
+	if (!e) return 0;
+	let t = j[e];
+	if (t !== void 0) return t;
+	if (e.length === 4 && e.startsWith("Key")) {
+		let t = e.charCodeAt(3);
+		if (t >= 65 && t <= 90) return t;
+	}
+	if (e.length === 6 && e.startsWith("Digit")) {
+		let t = e.charCodeAt(5);
+		if (t >= 48 && t <= 57) return t;
+	}
+	if (e.length === 7 && e.startsWith("Numpad")) {
+		let t = e.charCodeAt(6);
+		if (t >= 48 && t <= 57) return 96 + (t - 48);
+	}
+	let n = /^F(\d{1,2})$/u.exec(e);
+	if (n) {
+		let e = Number(n[1]);
+		if (e >= 1 && e <= 24) return 111 + e;
+	}
+	return 0;
+}, N = function(e) {
+	let t = (e.split(/[/.]/u).pop() ?? e).replaceAll(/[^A-Za-z0-9]/gu, "").slice(0, 12), n = 2166136261;
+	for (let t = 0; t < e.length; t += 1) n = Math.imul(n ^ e.charCodeAt(t), 16777619);
+	return `m${t}_${((n >>> 0) % 65536).toString(16).padStart(4, "0")}_`;
+}, P = function(t) {
+	return { activate(o) {
+		let u = o.identity, d = N(u.id), f = [], p = [], m = [], h = [], g = [], _ = /* @__PURE__ */ new Map(), v = !0, C = (e) => {
+			if (!n.test(e)) throw Error(`mod ${u.id}: ${JSON.stringify(e)} is not a usable event name (letters, digits, - and _, starting with a letter)`);
+			return e.replaceAll("-", "_");
+		}, w = (e) => `${d}__${e}`, T = (e) => {
+			let t = {};
+			for (let n of e.vars ?? []) {
+				if (!r.test(n)) throw Error(`mod ${u.id}: ${JSON.stringify(n)} is not a usable variable name (letters, digits and _, starting with a letter)`);
+				t[n] = `${d}v_${n}`;
+			}
+			return t;
+		}, E = (e) => `global.${d}q_${e}`, D = (e, t = "") => o.send(`${e} ${t}`), O = (e, t) => o.gml.send(t ? `"${e} " + (${t})` : `"${e} "`), k = (e, t) => O(C(e), t), A = (e, ...t) => {
+			if (!p.some((t) => t.name === e)) throw Error(`mod ${u.id}: call(${JSON.stringify(e)}) names a script this mod never declared. It has: ${p.map((e) => e.name).join(", ") || "none"}`);
+			return `${d}s_${e}(${t.join(", ")})`;
+		}, j = (e) => ({
+			engine: o.target.engine,
+			v: T(e),
+			send: k,
+			call: A
+		}), M = y({
+			hostApi: o,
+			identity: u,
+			sendInternal: D
+		}), P = /* @__PURE__ */ new Map(), F = o.game;
+		t({
+			engine: o.target.engine,
+			call: A,
+			ui: o.ui,
+			getPlayer: () => o.getPlayer(),
+			onPlayerChange: (e) => o.on("player", e),
+			content: F,
+			resource: {
+				object: { create(e) {
+					if (!v) throw Error(`mod ${u.id}: objects can only be declared while the mod is built`);
+					f.push(e);
+				} },
+				script: {
+					create(e) {
+						if (!v) throw Error(`mod ${u.id}: scripts can only be declared while the mod is built`);
+						if (!r.test(e.name)) throw Error(`mod ${u.id}: ${JSON.stringify(e.name)} is not a usable script name (letters, digits and _, starting with a letter)`);
+						if (p.some((t) => t.name === e.name)) throw Error(`mod ${u.id}: two scripts are called ${JSON.stringify(e.name)}`);
+						p.push(e);
+					},
+					hook(e, t) {
+						if (!v) throw Error(`mod ${u.id}: hooks can only be declared while the mod is built`);
+						h.push({
+							script: e,
+							wrap: t
+						});
+					},
+					insert(e) {
+						if (!v) throw Error(`mod ${u.id}: insertions can only be declared while the mod is built`);
+						g.push({
+							at: s(u.id, e),
+							place: e.place,
+							body: e.body
+						});
+					}
+				},
+				sprite: { create(e, t = {}) {
+					if (!v) throw Error(`mod ${u.id}: sprites can only be declared while the mod is built`);
+					if (!r.test(e)) throw Error(`mod ${u.id}: ${JSON.stringify(e)} is not a usable sprite name (letters, digits and _, starting with a letter)`);
+					if (m.some((t) => t.name === e)) throw Error(`mod ${u.id}: two sprites are called ${JSON.stringify(e)}`);
+					return m.push({
+						name: e,
+						options: t
+					}), {
+						id: `global.${d}spr_${e}`,
+						load: (n) => (P.set(e, n), M.loadSprite(e, t, n))
+					};
+				} }
+			},
+			on(e, t) {
+				let n = C(e), r = _.get(n);
+				r ? r.push(t) : _.set(n, [t]);
+			},
+			onStart(e) {
+				o.on("start", e);
+			},
+			scratchPath(e) {
+				if (!i.test(e)) throw Error(`mod ${u.id}: ${JSON.stringify(e)} is not a usable scratch file name (letters, digits, _ . and -)`);
+				return o.target.engine === "gm8" ? `temp_directory + "\\${d}${e}"` : `"${d}${e}"`;
+			},
+			send(e, t = "") {
+				o.send(`${C(e)} ${t}`);
+			}
+		}), v = !1, c({
+			identity: u,
+			inserts: g,
+			prefix: d,
+			hostApi: o,
+			send: k,
+			call: A
+		}), l({
+			identity: u,
+			scripts: p,
+			hostApi: o,
+			prefix: d,
+			send: k,
+			call: A
+		}), a({
+			identity: u,
+			hooks: h,
+			content: F,
+			hostApi: o,
+			prefix: d,
+			send: k,
+			call: A
+		}), e({
+			identity: u,
+			hostApi: o,
+			prefix: d,
+			objects: f,
+			internalReceive: b({
+				hostApi: o,
+				prefix: d,
+				sprites: m,
+				payload: w("pl"),
+				sendInternalGml: O
+			}),
+			internalCreate: x({
+				engine: o.target.engine,
+				prefix: d,
+				sprites: m,
+				sendInternalGml: O
+			}),
+			normalizeEventName: C,
+			context: j,
+			queue: E,
+			scratch: w
+		}), S({
+			identity: u,
+			sprites: m,
+			shown: P,
+			spriteLoader: M,
+			handlers: _
+		}), o.on("message", (e) => {
+			let t = e.indexOf(" "), n = t < 0 ? e : e.slice(0, t), r = t < 0 ? "" : e.slice(t + 1), i = _.get(n);
+			if (i) for (let e of i) new Promise((t) => {
+				t(e(r));
+			}).catch((e) => {
+				console.error(`[${u.id}] handling ${n} failed:`, e);
+			});
+		});
+	} };
+};
+//#endregion
+export { C as CANONICAL_CONTROL_KEYS, w as CONTROL_ACTIONS, P as createMod, M as gameMakerKey, t as highestArgument, T as isPadBinding, D as pngSize, k as sliceImage, A as walk };

package/dist/keyboard/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Turning a rebindable key into the number GameMaker checks.
+ *
+ * A `keybind` control hands you a `KeyboardEvent.code` -- `"KeyH"`, `"ArrowLeft"`, `"Space"` -- which
+ * names the *physical* key, so a binding made on an AZERTY keyboard stays under the same finger
+ * rather than following the letter printed on it. GML wants a number: the Windows virtual-key code,
+ * which is what `vk_left` is and what `ord("H")` comes out as.
+ *
+ * ```ts
+ * const jump = mod.ui.state("KeyZ", { persist: "jump" });
+ *
+ * mod.resource.object.create({
+ *   name: "mymod",
+ *   vars: ["jumpKey"],
+ *   events: {
+ *     create: ({ v }) => `${v.jumpKey} = ${gameMakerKey("KeyZ")};`,
+ *     step: ({ v, send }) => `
+ *       if (${v.jumpKey} > 0 && keyboard_check_pressed(${v.jumpKey})) ${send("jump")}
+ *     `,
+ *   },
+ *   receive: { key: ({ v, payload }) => `${v.jumpKey} = real(${payload});` },
+ * });
+ *
+ * const push = () => mod.send("key", String(gameMakerKey(jump.value)));
+ * mod.onStart(push);
+ * ```
+ *
+ * The default in `create` matters: a game can run for a moment before the panel's first push
+ * arrives, and a key of 0 matches nothing.
+ */
+/**
+ * The GameMaker key code for a `KeyboardEvent.code`, or `0` when there is no sensible one.
+ *
+ * `0` rather than a throw, and rather than a guess: an unbound control and a key GameMaker has no
+ * number for should behave the same way -- nothing happens -- and neither is a reason to take a
+ * running game down. Guard with `> 0` in the GML, since `keyboard_check_pressed(0)` is not reliably
+ * false on every runner.
+ *
+ * Left and right modifiers collapse onto one code, which is what GameMaker offers: `vk_shift` is
+ * either shift. A mod that needs to tell them apart cannot, here or in GML.
+ */
+export declare const gameMakerKey: (code: string) => number;