@rpgjs/map-builder 0.0.0-stage → 5.0.0

package/dist/embed/host.d.ts

@@ -0,0 +1,112 @@
+import { AuthorityConnection, AuthoritySession } from '../authority/authority';
+import { TargetRef } from '../interaction/picking';
+import { JsonValue } from '../model/json';
+import { TargetLike, WindowLike } from './protocol';
+/** The part of a map's authority the editor host needs. A `MapAuthority` fits. */
+export interface EditorAuthorityLike {
+    connect(session: AuthoritySession): AuthorityConnection;
+}
+/** The part of a map view the editor host drives. A `MapView` with the editing features fits. */
+export interface EditorViewLike {
+    readonly interaction: {
+        readonly modes: readonly string[];
+        setModes(modes: readonly string[]): void;
+        readonly pointer: {
+            readonly x: number;
+            readonly y: number;
+        } | null;
+        readonly state: {
+            get(): {
+                readonly selection: readonly TargetRef[];
+                readonly lastRejection: {
+                    readonly reason: string;
+                    readonly message?: string;
+                } | null;
+            };
+            subscribe(listener: () => void): () => void;
+        };
+    };
+    readonly selection?: {
+        select(targets: readonly TargetRef[]): void;
+        clear(): void;
+    };
+    readonly placement?: {
+        start(id: string): void;
+        cancel(): void;
+    };
+    readonly terrain?: {
+        readonly brush?: {
+            start(options: {
+                material: string | null;
+                radius: number;
+            }): void;
+            stop(): void;
+        };
+    };
+}
+export interface EditorHostOptions {
+    /**
+     * Origins that may embed this game as an editor, e.g. `["https://studio.rpgjs.dev"]`. `"*"` lets any page do it:
+     * for development only. An empty list lets nobody.
+     */
+    readonly allowedOrigins: readonly string[];
+    /** The authority of the map the player is on. Read each time the map changes (`notifyMap`). */
+    readonly authority: () => {
+        readonly id: string;
+        readonly authority: EditorAuthorityLike;
+    } | undefined;
+    /** The view of that map, when there is one. */
+    readonly view?: () => EditorViewLike | undefined;
+    /** Pauses or resumes the game (server loop and client display). */
+    readonly setPaused?: (paused: boolean) => void;
+    /** Moves the camera to a world position. */
+    readonly camera?: (x: number, y: number) => void;
+    /** Who the Studio acts as in the pipelines. The authority must trust it for raw patches (`trustPatches`). Defaults to `{ editor: true }`. */
+    readonly actor?: unknown;
+    readonly window?: WindowLike & {
+        readonly parent?: TargetLike;
+        readonly location?: {
+            readonly ancestorOrigins?: {
+                readonly [index: number]: string | undefined;
+                readonly length?: number;
+            };
+        };
+    };
+    /**
+     * Origin of the page that embeds the game, when the browser says (`location.ancestorOrigins`). Announcing only
+     * to it keeps the console clean; without it the game announces to every allowed origin.
+     */
+    readonly parentOrigin?: () => string | undefined;
+    /**
+     * What the game can be asked to do beyond the tools of the view: `{ copy: () => … }`. The Studio calls them by
+     * name (`frame.command("copy")`) with JSON arguments. A command that throws is reported as an error, not obeyed twice.
+     */
+    readonly commands?: Readonly<Record<string, (args: JsonValue | undefined) => void>>;
+    /**
+     * The window the Studio is in, when it is not the direct parent: a game that runs in a sandbox frame inside a
+     * wrapper page talks to the top window. Defaults to the parent.
+     */
+    readonly parent?: TargetLike;
+    /** How often the pointer position is reported, in milliseconds. Defaults to 100. 0 turns it off. */
+    readonly pointerEveryMs?: number;
+    readonly onError?: (error: unknown) => void;
+}
+export interface EditorHost {
+    /** Whether a Studio is connected. */
+    readonly connected: boolean;
+    /**
+     * Tells the Studio a value the game keeps (`publish("canUndo", true)`). Sent at once, and again to any Studio that
+     * connects later: it always has the last value of every key.
+     */
+    publish(key: string, value: JsonValue): void;
+    /** The player is on another map, or the view of this one now exists: bind to them. */
+    notifyMap(): void;
+    dispose(): void;
+}
+/**
+ * The game's end of the editor channels. It lets a Studio that is allowed to (origin checked) join the authority of
+ * the map the player is on as a trusted session, drive the tools of the view, and pause the game.
+ * Create it only when the game runs as an editor (`?editor`, or in a build the Studio makes): a player never has one.
+ */
+export declare function createEditorHost(options: EditorHostOptions): EditorHost;
+//# sourceMappingURL=host.d.ts.map

package/dist/embed/host.d.ts.map

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

package/dist/embed/host.js

@@ -0,0 +1,278 @@
+import { EDITOR_SOURCE, parseControl, parseEnvelope, parseHandshake } from "./protocol.js";
+//#region src/embed/host.ts
+var DEFAULT_ACTOR = Object.freeze({ editor: true });
+/**
+* The game's end of the editor channels. It lets a Studio that is allowed to (origin checked) join the authority of
+* the map the player is on as a trusted session, drive the tools of the view, and pause the game.
+* Create it only when the game runs as an editor (`?editor`, or in a build the Studio makes): a player never has one.
+*/
+function createEditorHost(options) {
+	const win = options.window ?? globalThis.window;
+	const parent = options.parent ?? win?.parent;
+	if (!win || !parent) throw new Error("createEditorHost needs a window and a parent to talk to");
+	const report = options.onError ?? ((error) => console.error("[map-builder editor]", error));
+	const allowed = (origin) => options.allowedOrigins.includes("*") || options.allowedOrigins.includes(origin);
+	let port;
+	let connection;
+	let mapId;
+	let stopView;
+	let paused = false;
+	let tool = { tool: "none" };
+	let pointerTimer;
+	let disposed = false;
+	const published = /* @__PURE__ */ new Map();
+	const post = (message) => {
+		try {
+			port?.postMessage(message);
+		} catch (error) {
+			report(error);
+		}
+	};
+	const emit = (event) => post({
+		ch: "event",
+		message: event
+	});
+	const announce = () => {
+		const known = (options.parentOrigin ?? (() => {
+			const ancestors = win.location?.ancestorOrigins;
+			for (let i = 0; ancestors && i < (ancestors.length ?? 0); i += 1) {
+				const origin = ancestors[i];
+				if (origin && allowed(origin)) return origin;
+			}
+		}))();
+		const targets = known && allowed(known) ? [known] : [...options.allowedOrigins];
+		for (const origin of targets) try {
+			parent.postMessage({
+				source: EDITOR_SOURCE,
+				type: "ready",
+				version: 1
+			}, origin);
+		} catch (error) {
+			report(error);
+		}
+	};
+	const view = () => options.view?.();
+	const interactionEvent = (v) => {
+		const rejection = v.interaction.state.get().lastRejection;
+		return {
+			type: "interaction",
+			modes: [...v.interaction.modes],
+			tool,
+			rejection: rejection ? {
+				reason: rejection.reason,
+				...rejection.message ? { message: rejection.message } : {}
+			} : null
+		};
+	};
+	const unbind = () => {
+		stopView?.();
+		stopView = void 0;
+		connection?.disconnect();
+		connection = void 0;
+		mapId = void 0;
+	};
+	/** Joins the authority of the map the player is on, and follows its view. */
+	const bind = () => {
+		unbind();
+		if (!port) return;
+		const found = options.authority();
+		if (!found) return;
+		mapId = found.id;
+		const id = found.id;
+		emit({
+			type: "map",
+			id
+		});
+		connection = found.authority.connect({
+			id: "studio",
+			actor: options.actor ?? DEFAULT_ACTOR,
+			send: (message) => post({
+				ch: "map",
+				map: id,
+				message
+			})
+		});
+		const v = view();
+		if (!v) return;
+		let lastSelection = "";
+		const push = () => {
+			const selection = v.interaction.state.get().selection;
+			const key = selection.map((target) => `${target.type}:${target.id}`).join("|");
+			if (key !== lastSelection) {
+				lastSelection = key;
+				emit({
+					type: "selection",
+					targets: selection.map((target) => ({
+						type: target.type,
+						id: target.id
+					}))
+				});
+			}
+			emit(interactionEvent(v));
+		};
+		stopView = v.interaction.state.subscribe(push);
+		push();
+	};
+	const control = (message) => {
+		const v = view();
+		switch (message.type) {
+			case "pause":
+				paused = message.paused;
+				options.setPaused?.(paused);
+				emit({
+					type: "paused",
+					paused
+				});
+				return;
+			case "camera":
+				options.camera?.(message.x, message.y);
+				return;
+			case "command": {
+				const run = options.commands && Object.hasOwn(options.commands, message.name) ? options.commands[message.name] : void 0;
+				if (!run) return emit({
+					type: "error",
+					message: `Unknown command "${message.name}"`
+				});
+				try {
+					run(message.args);
+				} catch (error) {
+					emit({
+						type: "error",
+						message: error instanceof Error ? error.message : String(error)
+					});
+				}
+				return;
+			}
+			default: break;
+		}
+		if (!v) return emit({
+			type: "error",
+			message: "No map is shown yet"
+		});
+		try {
+			if (message.type === "modes") v.interaction.setModes(message.modes);
+			else if (message.type === "select") {
+				if (!v.selection) return emit({
+					type: "error",
+					message: "This game has no selection"
+				});
+				if (message.targets.length === 0) v.selection.clear();
+				else v.selection.select(message.targets);
+			} else if (message.type === "tool") {
+				v.terrain?.brush?.stop();
+				v.placement?.cancel();
+				if (message.tool === "brush") {
+					if (!v.terrain?.brush) return emit({
+						type: "error",
+						message: "This map has no terrain to paint"
+					});
+					v.terrain.brush.start({
+						material: message.material,
+						radius: message.radius
+					});
+				} else if (message.tool === "place") {
+					if (!v.placement) return emit({
+						type: "error",
+						message: "This game has nothing to place"
+					});
+					v.placement.start(message.catalogId);
+				}
+				const { type: _type, ...next } = message;
+				tool = next;
+			}
+			emit(interactionEvent(v));
+		} catch (error) {
+			emit({
+				type: "error",
+				message: error instanceof Error ? error.message : String(error)
+			});
+		}
+	};
+	const onPort = (event) => {
+		const envelope = parseEnvelope(event.data);
+		if (!envelope) return;
+		if (envelope.ch === "map") {
+			if (envelope.map === mapId) connection?.receive(envelope.message);
+		} else if (envelope.ch === "control") {
+			const parsed = parseControl(envelope.message);
+			if (parsed) control(parsed);
+			else emit({
+				type: "error",
+				message: "Unknown or invalid control message"
+			});
+		}
+	};
+	const connect = (next) => {
+		unbind();
+		port?.close();
+		port = next;
+		port.addEventListener("message", onPort);
+		port.start?.();
+		bind();
+		for (const [key, value] of published) emit({
+			type: "state",
+			key,
+			value
+		});
+		if (pointerTimer) clearInterval(pointerTimer);
+		if ((options.pointerEveryMs ?? 100) > 0) {
+			let last = "";
+			pointerTimer = setInterval(() => {
+				const pointer = view()?.interaction.pointer;
+				if (!pointer) return;
+				const key = `${Math.round(pointer.x)},${Math.round(pointer.y)}`;
+				if (key === last) return;
+				last = key;
+				emit({
+					type: "pointer",
+					x: Math.round(pointer.x),
+					y: Math.round(pointer.y)
+				});
+			}, options.pointerEveryMs ?? 100);
+		}
+	};
+	const onWindow = (event) => {
+		if (disposed) return;
+		if (event.source !== parent || !allowed(event.origin)) return;
+		const handshake = parseHandshake(event.data);
+		if (!handshake) return;
+		if (handshake.type === "hello") return announce();
+		if (handshake.type !== "connect") return;
+		if (handshake.version !== 1) {
+			report(/* @__PURE__ */ new Error(`The Studio speaks editor protocol ${handshake.version}, this game speaks 1`));
+			return;
+		}
+		const given = event.ports?.[0];
+		if (given) connect(given);
+	};
+	win.addEventListener("message", onWindow);
+	announce();
+	return {
+		get connected() {
+			return port !== void 0;
+		},
+		publish(key, value) {
+			published.set(key, value);
+			emit({
+				type: "state",
+				key,
+				value
+			});
+		},
+		notifyMap: () => {
+			if (port && !disposed) bind();
+		},
+		dispose() {
+			disposed = true;
+			win.removeEventListener("message", onWindow);
+			if (pointerTimer) clearInterval(pointerTimer);
+			unbind();
+			port?.close();
+			port = void 0;
+		}
+	};
+}
+//#endregion
+export { createEditorHost };
+
+//# sourceMappingURL=host.js.map

package/dist/embed/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","names":[],"sources":["../../src/embed/host.ts"],"sourcesContent":["import type { AuthorityConnection, AuthoritySession } from \"../authority/authority\";\nimport type { TargetRef } from \"../interaction/picking\";\nimport type { JsonValue } from \"../model/json\";\nimport type { ServerMessage } from \"../protocol\";\nimport {\n  EDITOR_PROTOCOL_VERSION,\n  EDITOR_SOURCE,\n  parseControl,\n  parseEnvelope,\n  parseHandshake,\n  type ControlMessage,\n  type EditorEvent,\n  type EditorTool,\n  type MessageEventLike,\n  type PortLike,\n  type TargetLike,\n  type WindowLike,\n} from \"./protocol\";\n\n/** The part of a map's authority the editor host needs. A `MapAuthority` fits. */\nexport interface EditorAuthorityLike {\n  connect(session: AuthoritySession): AuthorityConnection;\n}\n\n/** The part of a map view the editor host drives. A `MapView` with the editing features fits. */\nexport interface EditorViewLike {\n  readonly interaction: {\n    readonly modes: readonly string[];\n    setModes(modes: readonly string[]): void;\n    readonly pointer: { readonly x: number; readonly y: number } | null;\n    readonly state: {\n      get(): { readonly selection: readonly TargetRef[]; readonly lastRejection: { readonly reason: string; readonly message?: string } | null };\n      subscribe(listener: () => void): () => void;\n    };\n  };\n  readonly selection?: { select(targets: readonly TargetRef[]): void; clear(): void };\n  readonly placement?: { start(id: string): void; cancel(): void };\n  readonly terrain?: { readonly brush?: { start(options: { material: string | null; radius: number }): void; stop(): void } };\n}\n\nexport interface EditorHostOptions {\n  /**\n   * Origins that may embed this game as an editor, e.g. `[\"https://studio.rpgjs.dev\"]`. `\"*\"` lets any page do it:\n   * for development only. An empty list lets nobody.\n   */\n  readonly allowedOrigins: readonly string[];\n  /** The authority of the map the player is on. Read each time the map changes (`notifyMap`). */\n  readonly authority: () => { readonly id: string; readonly authority: EditorAuthorityLike } | undefined;\n  /** The view of that map, when there is one. */\n  readonly view?: () => EditorViewLike | undefined;\n  /** Pauses or resumes the game (server loop and client display). */\n  readonly setPaused?: (paused: boolean) => void;\n  /** Moves the camera to a world position. */\n  readonly camera?: (x: number, y: number) => void;\n  /** Who the Studio acts as in the pipelines. The authority must trust it for raw patches (`trustPatches`). Defaults to `{ editor: true }`. */\n  readonly actor?: unknown;\n  readonly window?: WindowLike & { readonly parent?: TargetLike; readonly location?: { readonly ancestorOrigins?: { readonly [index: number]: string | undefined; readonly length?: number } } };\n  /**\n   * Origin of the page that embeds the game, when the browser says (`location.ancestorOrigins`). Announcing only\n   * to it keeps the console clean; without it the game announces to every allowed origin.\n   */\n  readonly parentOrigin?: () => string | undefined;\n  /**\n   * What the game can be asked to do beyond the tools of the view: `{ copy: () => … }`. The Studio calls them by\n   * name (`frame.command(\"copy\")`) with JSON arguments. A command that throws is reported as an error, not obeyed twice.\n   */\n  readonly commands?: Readonly<Record<string, (args: JsonValue | undefined) => void>>;\n  /**\n   * The window the Studio is in, when it is not the direct parent: a game that runs in a sandbox frame inside a\n   * wrapper page talks to the top window. Defaults to the parent.\n   */\n  readonly parent?: TargetLike;\n  /** How often the pointer position is reported, in milliseconds. Defaults to 100. 0 turns it off. */\n  readonly pointerEveryMs?: number;\n  readonly onError?: (error: unknown) => void;\n}\n\nexport interface EditorHost {\n  /** Whether a Studio is connected. */\n  readonly connected: boolean;\n  /**\n   * Tells the Studio a value the game keeps (`publish(\"canUndo\", true)`). Sent at once, and again to any Studio that\n   * connects later: it always has the last value of every key.\n   */\n  publish(key: string, value: JsonValue): void;\n  /** The player is on another map, or the view of this one now exists: bind to them. */\n  notifyMap(): void;\n  dispose(): void;\n}\n\nconst DEFAULT_ACTOR = Object.freeze({ editor: true });\n\n/**\n * The game's end of the editor channels. It lets a Studio that is allowed to (origin checked) join the authority of\n * the map the player is on as a trusted session, drive the tools of the view, and pause the game.\n * Create it only when the game runs as an editor (`?editor`, or in a build the Studio makes): a player never has one.\n */\nexport function createEditorHost(options: EditorHostOptions): EditorHost {\n  const win = options.window ?? (globalThis as unknown as { window?: EditorHostOptions[\"window\"] }).window;\n  const parent = options.parent ?? win?.parent;\n  if (!win || !parent) throw new Error(\"createEditorHost needs a window and a parent to talk to\");\n  const report = options.onError ?? ((error: unknown) => console.error(\"[map-builder editor]\", error));\n  const allowed = (origin: string): boolean => options.allowedOrigins.includes(\"*\") || options.allowedOrigins.includes(origin);\n\n  let port: PortLike | undefined;\n  let connection: AuthorityConnection | undefined;\n  let mapId: string | undefined;\n  let stopView: (() => void) | undefined;\n  let paused = false;\n  let tool: EditorTool = { tool: \"none\" };\n  let pointerTimer: ReturnType<typeof setInterval> | undefined;\n  let disposed = false;\n  const published = new Map<string, JsonValue>();\n\n  const post = (message: unknown): void => {\n    try {\n      port?.postMessage(message);\n    } catch (error) {\n      report(error);\n    }\n  };\n  const emit = (event: EditorEvent): void => post({ ch: \"event\", message: event });\n\n  const announce = (): void => {\n    const known = (options.parentOrigin ?? (() => {\n      // The first ancestor that is allowed: the wrapper page of a sandbox is not, the Studio above it is.\n      const ancestors = win.location?.ancestorOrigins;\n      for (let i = 0; ancestors && i < (ancestors.length ?? 0); i += 1) {\n        const origin = ancestors[i];\n        if (origin && allowed(origin)) return origin;\n      }\n      return undefined;\n    }))();\n    const targets = known && allowed(known) ? [known] : [...options.allowedOrigins];\n    for (const origin of targets) {\n      try {\n        parent.postMessage({ source: EDITOR_SOURCE, type: \"ready\", version: EDITOR_PROTOCOL_VERSION }, origin);\n      } catch (error) {\n        report(error);\n      }\n    }\n  };\n\n  const view = (): EditorViewLike | undefined => options.view?.();\n\n  const interactionEvent = (v: EditorViewLike): EditorEvent => {\n    const rejection = v.interaction.state.get().lastRejection;\n    return { type: \"interaction\", modes: [...v.interaction.modes], tool, rejection: rejection ? { reason: rejection.reason, ...(rejection.message ? { message: rejection.message } : {}) } : null };\n  };\n\n  const unbind = (): void => {\n    stopView?.();\n    stopView = undefined;\n    connection?.disconnect();\n    connection = undefined;\n    mapId = undefined;\n  };\n\n  /** Joins the authority of the map the player is on, and follows its view. */\n  const bind = (): void => {\n    unbind();\n    if (!port) return;\n    const found = options.authority();\n    if (!found) return;\n    mapId = found.id;\n    const id = found.id;\n    // Said first, so that the Studio is ready for the snapshot the authority sends as soon as it is connected.\n    emit({ type: \"map\", id });\n    connection = found.authority.connect({\n      id: \"studio\",\n      actor: options.actor ?? DEFAULT_ACTOR,\n      send: (message) => post({ ch: \"map\", map: id, message: message as ServerMessage }),\n    });\n    const v = view();\n    if (!v) return;\n    let lastSelection = \"\";\n    const push = (): void => {\n      const selection = v.interaction.state.get().selection;\n      const key = selection.map((target) => `${target.type}:${target.id}`).join(\"|\");\n      if (key !== lastSelection) {\n        lastSelection = key;\n        emit({ type: \"selection\", targets: selection.map((target) => ({ type: target.type, id: target.id })) });\n      }\n      emit(interactionEvent(v));\n    };\n    const stop = v.interaction.state.subscribe(push);\n    stopView = stop;\n    push();\n  };\n\n  const control = (message: ControlMessage): void => {\n    const v = view();\n    switch (message.type) {\n      case \"pause\":\n        paused = message.paused;\n        options.setPaused?.(paused);\n        emit({ type: \"paused\", paused });\n        return;\n      case \"camera\":\n        options.camera?.(message.x, message.y);\n        return;\n      case \"command\": {\n        const run = options.commands && Object.hasOwn(options.commands, message.name) ? options.commands[message.name] : undefined;\n        if (!run) return emit({ type: \"error\", message: `Unknown command \"${message.name}\"` });\n        try {\n          run(message.args);\n        } catch (error) {\n          emit({ type: \"error\", message: error instanceof Error ? error.message : String(error) });\n        }\n        return;\n      }\n      default:\n        break;\n    }\n    if (!v) return emit({ type: \"error\", message: \"No map is shown yet\" });\n    try {\n      if (message.type === \"modes\") {\n        v.interaction.setModes(message.modes);\n      } else if (message.type === \"select\") {\n        if (!v.selection) return emit({ type: \"error\", message: \"This game has no selection\" });\n        if (message.targets.length === 0) v.selection.clear();\n        else v.selection.select(message.targets);\n      } else if (message.type === \"tool\") {\n        // One tool at a time: whatever was in hand is put away.\n        v.terrain?.brush?.stop();\n        v.placement?.cancel();\n        if (message.tool === \"brush\") {\n          if (!v.terrain?.brush) return emit({ type: \"error\", message: \"This map has no terrain to paint\" });\n          v.terrain.brush.start({ material: message.material, radius: message.radius });\n        } else if (message.tool === \"place\") {\n          if (!v.placement) return emit({ type: \"error\", message: \"This game has nothing to place\" });\n          v.placement.start(message.catalogId);\n        }\n        const { type: _type, ...next } = message;\n        tool = next as EditorTool;\n      }\n      emit(interactionEvent(v));\n    } catch (error) {\n      emit({ type: \"error\", message: error instanceof Error ? error.message : String(error) });\n    }\n  };\n\n  const onPort = (event: { data: unknown }): void => {\n    const envelope = parseEnvelope(event.data);\n    if (!envelope) return;\n    if (envelope.ch === \"map\") {\n      if (envelope.map === mapId) connection?.receive(envelope.message);\n    } else if (envelope.ch === \"control\") {\n      const parsed = parseControl(envelope.message);\n      if (parsed) control(parsed);\n      else emit({ type: \"error\", message: \"Unknown or invalid control message\" });\n    }\n  };\n\n  const connect = (next: PortLike): void => {\n    unbind();\n    port?.close();\n    port = next;\n    port.addEventListener(\"message\", onPort);\n    port.start?.();\n    bind();\n    // A Studio that connects late learns what the game already keeps.\n    for (const [key, value] of published) emit({ type: \"state\", key, value });\n    if (pointerTimer) clearInterval(pointerTimer);\n    if ((options.pointerEveryMs ?? 100) > 0) {\n      let last = \"\";\n      pointerTimer = setInterval(() => {\n        const pointer = view()?.interaction.pointer;\n        if (!pointer) return;\n        const key = `${Math.round(pointer.x)},${Math.round(pointer.y)}`;\n        if (key === last) return;\n        last = key;\n        emit({ type: \"pointer\", x: Math.round(pointer.x), y: Math.round(pointer.y) });\n      }, options.pointerEveryMs ?? 100);\n    }\n  };\n\n  const onWindow = (event: MessageEventLike): void => {\n    if (disposed) return;\n    // Only the page that embeds us, and only if it is allowed to.\n    if (event.source !== parent || !allowed(event.origin)) return;\n    const handshake = parseHandshake(event.data);\n    if (!handshake) return;\n    if (handshake.type === \"hello\") return announce();\n    if (handshake.type !== \"connect\") return;\n    if (handshake.version !== EDITOR_PROTOCOL_VERSION) {\n      report(new Error(`The Studio speaks editor protocol ${handshake.version}, this game speaks ${EDITOR_PROTOCOL_VERSION}`));\n      return;\n    }\n    const given = event.ports?.[0];\n    if (given) connect(given);\n  };\n\n  win.addEventListener(\"message\", onWindow);\n  announce();\n\n  return {\n    get connected() {\n      return port !== undefined;\n    },\n    publish(key, value) {\n      published.set(key, value);\n      emit({ type: \"state\", key, value });\n    },\n    notifyMap: () => {\n      if (port && !disposed) bind();\n    },\n    dispose() {\n      disposed = true;\n      win.removeEventListener(\"message\", onWindow);\n      if (pointerTimer) clearInterval(pointerTimer);\n      unbind();\n      port?.close();\n      port = undefined;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/embed/index.d.ts

@@ -0,0 +1,4 @@
+export * from './protocol';
+export * from './host';
+export * from './client';
+//# sourceMappingURL=index.d.ts.map

package/dist/embed/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embed/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/embed/index.js

@@ -0,0 +1,4 @@
+import { EDITOR_PROTOCOL_VERSION, EDITOR_SOURCE, LIMITS, parseControl, parseEnvelope, parseEvent, parseHandshake, parseTargets } from "./protocol.js";
+import { createEditorHost } from "./host.js";
+import { connectEditorFrame } from "./client.js";
+export { EDITOR_PROTOCOL_VERSION, EDITOR_SOURCE, LIMITS, connectEditorFrame, createEditorHost, parseControl, parseEnvelope, parseEvent, parseHandshake, parseTargets };

package/dist/embed/protocol.d.ts

@@ -0,0 +1,137 @@
+import { JsonValue } from '../model/json';
+import { TargetRef } from '../interaction/picking';
+/** Version of the messages between the Studio and a game. Both ends say theirs in the handshake. */
+export declare const EDITOR_PROTOCOL_VERSION: 1;
+/** Marks the window messages of the handshake, so that the page ignores everybody else's. */
+export declare const EDITOR_SOURCE: "rpgjs-map-builder-editor";
+/** The tool that is in hand. */
+export type EditorTool = {
+    readonly tool: "none";
+} | {
+    readonly tool: "brush";
+    readonly material: string | null;
+    readonly radius: number;
+} | {
+    readonly tool: "place";
+    readonly catalogId: string;
+};
+/** What the Studio asks of the game. */
+export type ControlMessage = {
+    readonly type: "modes";
+    readonly modes: readonly string[];
+} | ({
+    readonly type: "tool";
+} & EditorTool) | {
+    readonly type: "select";
+    readonly targets: readonly TargetRef[];
+} | {
+    readonly type: "pause";
+    readonly paused: boolean;
+} | {
+    readonly type: "camera";
+    readonly x: number;
+    readonly y: number;
+}
+/** Something only the game knows how to do: a command it registered (`copy`, `place`…). */
+ | {
+    readonly type: "command";
+    readonly name: string;
+    readonly args?: JsonValue;
+};
+/** What the game tells the Studio. */
+export type EditorEvent = {
+    readonly type: "map";
+    readonly id: string;
+} | {
+    readonly type: "selection";
+    readonly targets: readonly TargetRef[];
+} | {
+    readonly type: "interaction";
+    readonly modes: readonly string[];
+    readonly tool: EditorTool;
+    /** Why the last intent was refused, until another is accepted. */
+    readonly rejection: {
+        readonly reason: string;
+        readonly message?: string;
+    } | null;
+} | {
+    readonly type: "paused";
+    readonly paused: boolean;
+} | {
+    readonly type: "pointer";
+    readonly x: number;
+    readonly y: number;
+}
+/** A value the game keeps and the Studio shows (`tool`, `canUndo`, `layer`…). */
+ | {
+    readonly type: "state";
+    readonly key: string;
+    readonly value: JsonValue;
+} | {
+    readonly type: "error";
+    readonly message: string;
+};
+/** Messages of the handshake, sent with `window.postMessage`. */
+export type HandshakeMessage = {
+    readonly source: typeof EDITOR_SOURCE;
+    readonly type: "hello";
+    readonly version: number;
+} | {
+    readonly source: typeof EDITOR_SOURCE;
+    readonly type: "ready";
+    readonly version: number;
+} | {
+    readonly source: typeof EDITOR_SOURCE;
+    readonly type: "connect";
+    readonly version: number;
+};
+export declare const LIMITS: {
+    /** Targets in one selection. */
+    readonly maxTargets: 10000;
+    readonly maxModes: 16;
+    readonly maxStringLength: 256;
+};
+export declare function parseTargets(raw: unknown): TargetRef[] | undefined;
+/** Reads a control message that came through the port. Anything with another shape is `undefined`. */
+export declare function parseControl(raw: unknown): ControlMessage | undefined;
+/** Reads an event from the game. */
+export declare function parseEvent(raw: unknown): EditorEvent | undefined;
+export declare function parseHandshake(raw: unknown): HandshakeMessage | undefined;
+/** What goes through the port. The map channel carries the authority protocol, tagged with the map. */
+export type Envelope = {
+    readonly ch: "map";
+    readonly map: string;
+    readonly message: unknown;
+} | {
+    readonly ch: "control";
+    readonly message: unknown;
+} | {
+    readonly ch: "event";
+    readonly message: unknown;
+};
+export declare function parseEnvelope(raw: unknown): Envelope | undefined;
+/** What a `MessagePort` offers, so that tests and other carriers can stand in. */
+export interface PortLike {
+    postMessage(message: unknown): void;
+    addEventListener(type: "message", listener: (event: {
+        data: unknown;
+    }) => void): void;
+    start?(): void;
+    close(): void;
+}
+/** What a window offers to listen to messages. */
+export interface WindowLike {
+    addEventListener(type: "message", listener: (event: MessageEventLike) => void): void;
+    removeEventListener(type: "message", listener: (event: MessageEventLike) => void): void;
+}
+export interface MessageEventLike {
+    readonly data: unknown;
+    readonly origin: string;
+    readonly source: unknown;
+    readonly ports?: readonly PortLike[];
+}
+/** Something a message can be posted to: a frame's window, or `window.parent`. */
+export interface TargetLike {
+    postMessage(message: unknown, targetOrigin: string, transfer?: Transferable[]): void;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/embed/protocol.d.ts.map

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