@rpgjs/map-builder 0.0.0-stage → 5.0.0

package/dist/features/terrain.js

@@ -0,0 +1,291 @@
+import { defineMapFeature } from "../renderer/feature.js";
+import { tryReadTerrain } from "../terrain/data.js";
+import { readRect, shapeBounds } from "../terrain/mask.js";
+import { dirtyOfPatch, globalOverlayMaterials, renderMargin, widestBlend } from "../terrain/kernel.js";
+import { createTerrainScheduler } from "../terrain/scheduler.js";
+import { registerTerrainIntents, terrainBrush } from "../terrain/editing.js";
+import { Container, Sprite, Texture, TextureSource } from "pixi.js";
+//#region src/features/terrain.ts
+var TERRAIN_FEATURE_ID = "terrain";
+/** Pixels of an image, decoded in the browser. */
+async function decodeRaster(src) {
+	const response = await fetch(src);
+	if (!response.ok) throw new Error(`Could not load "${src}" (${response.status})`);
+	const bitmap = await createImageBitmap(await response.blob());
+	const context = (typeof OffscreenCanvas !== "undefined" ? new OffscreenCanvas(bitmap.width, bitmap.height) : Object.assign(document.createElement("canvas"), {
+		width: bitmap.width,
+		height: bitmap.height
+	})).getContext("2d");
+	context.drawImage(bitmap, 0, 0);
+	const image = context.getImageData(0, 0, bitmap.width, bitmap.height);
+	bitmap.close();
+	return {
+		width: image.width,
+		height: image.height,
+		pixels: image.data
+	};
+}
+/** Surfaces backed by canvases (nearest filtering, 1:1: the pixels are what the kernel produced). */
+var canvasSurface = (width, height) => {
+	const canvas = document.createElement("canvas");
+	canvas.width = width;
+	canvas.height = height;
+	const context = canvas.getContext("2d");
+	const texture = Texture.from(canvas);
+	texture.source.scaleMode = "nearest";
+	return {
+		texture,
+		put(x, y, w, h, pixels) {
+			context.putImageData(new ImageData(pixels, w, h), x, y);
+			texture.source.update();
+		},
+		destroy: () => texture.destroy(true)
+	};
+};
+/** Surfaces that only keep their pixels in memory: for tests and tools that read them back. */
+function memorySurface() {
+	const store = /* @__PURE__ */ new WeakMap();
+	const factory = (width, height) => {
+		const pixels = new Uint8ClampedArray(width * height * 4);
+		const texture = new Texture({ source: new TextureSource({
+			width,
+			height
+		}) });
+		store.set(texture, pixels);
+		return {
+			texture,
+			put(x, y, w, h, source) {
+				for (let row = 0; row < h; row += 1) pixels.set(source.subarray(row * w * 4, (row + 1) * w * 4), ((y + row) * width + x) * 4);
+			},
+			destroy: () => texture.destroy(true)
+		};
+	};
+	return Object.assign(factory, { pixelsOf: (texture) => store.get(texture) });
+}
+/**
+* Draws the painted terrain of the map (`extensions.terrain`): the control mask, the materials and
+* their render modes, rendered by the kernel of `@rpgjs/render-map2d` into chunk textures.
+* Painting changes only the chunks it touches. What is on screen renders first.
+*/
+function terrain(options = {}) {
+	return defineMapFeature({
+		id: TERRAIN_FEATURE_ID,
+		setup(host) {
+			const chunk = options.chunk ?? 512;
+			const makeSurface = options.surface ?? canvasSurface;
+			const report = options.onError ?? ((error) => console.warn("[map-builder] terrain:", error));
+			const container = new Container();
+			container.label = "terrain";
+			host.stages.ground.addChild(container);
+			const sprites = /* @__PURE__ */ new Map();
+			let backend;
+			let scheduler;
+			let current;
+			let grow = 0;
+			let margin = 0;
+			let viewport = null;
+			let generation = 0;
+			let destroyed = false;
+			let starting = Promise.resolve();
+			let phase = "idle";
+			let queued = [];
+			const images = /* @__PURE__ */ new Map();
+			const loadImage = (src) => {
+				let promise = images.get(src);
+				if (!promise) {
+					promise = (options.loadImage ?? decodeRaster)(src);
+					images.set(src, promise);
+					promise.catch(() => images.delete(src));
+				}
+				return promise;
+			};
+			const colsOf = (data) => Math.ceil((host.model.state.size[0] ?? data.mask.width) / chunk);
+			const place = (frame) => {
+				const data = current;
+				if (!data || destroyed) return;
+				const col = Math.floor(frame.x / chunk);
+				const row = Math.floor(frame.y / chunk);
+				const index = row * colsOf(data) + col;
+				let entry = sprites.get(index);
+				if (!entry) {
+					const surface = makeSurface(chunk, chunk);
+					const sprite = new Sprite(surface.texture);
+					sprite.position.set(col * chunk, row * chunk);
+					container.addChild(sprite);
+					entry = {
+						sprite,
+						surface
+					};
+					sprites.set(index, entry);
+				}
+				entry.surface.put(frame.x - col * chunk, frame.y - row * chunk, frame.width, frame.height, frame.pixels);
+			};
+			const sourcesOf = (data) => {
+				const out = {};
+				for (const material of data.materials) {
+					const asset = host.assets.resolve(material.texture);
+					if (asset) out[material.id] = {
+						src: asset.src,
+						...asset.frame ? { frame: asset.frame } : {}
+					};
+					else report(/* @__PURE__ */ new Error(`terrain material "${material.id}": unknown asset "${material.texture}"`));
+				}
+				return out;
+			};
+			const clearChunks = () => {
+				for (const { sprite, surface } of sprites.values()) {
+					sprite.destroy();
+					surface.destroy();
+				}
+				sprites.clear();
+			};
+			/** Gives the backend the terrain as it is now and renders everything. */
+			async function begin(first, token) {
+				const sources = sourcesOf(first);
+				const loaded = {};
+				await Promise.all([...new Set(Object.values(sources).map((source) => source.src))].map(async (src) => {
+					try {
+						loaded[src] = await loadImage(src);
+					} catch (error) {
+						report(error);
+					}
+				}));
+				if (token !== generation || destroyed) return;
+				if (!backend) {
+					backend = (typeof options.backend === "function" ? await options.backend() : options.backend) ?? (await import("../terrain-render/backend.js")).inlineTerrainBackend();
+					if (token !== generation || destroyed) return;
+				}
+				const state = host.model.state;
+				const data = tryReadTerrain(state);
+				if (!data) return;
+				const init = {
+					data,
+					size: state.size,
+					tileSize: state.tileSize ?? 48,
+					sources,
+					images: loaded
+				};
+				phase = "initializing";
+				queued = [];
+				await backend.init(init);
+				if (token !== generation || destroyed) return;
+				for (const change of queued) backend.updateMask(change.rect, change.values);
+				queued = [];
+				phase = "ready";
+				current = data;
+				grow = widestBlend(data);
+				margin = renderMargin(data);
+				scheduler?.destroy();
+				clearChunks();
+				const used = backend;
+				scheduler = createTerrainScheduler({
+					size: state.size,
+					chunk,
+					concurrency: used.concurrency,
+					render: (rect) => used.render(rect, margin),
+					apply: place,
+					onError: (error) => report(error)
+				});
+				scheduler.setViewport(viewport);
+				scheduler.invalidate("all");
+			}
+			const restart = () => {
+				generation += 1;
+				const token = generation;
+				const data = tryReadTerrain(host.model.state);
+				phase = data ? "loading" : "idle";
+				if (!data) {
+					scheduler?.destroy();
+					scheduler = void 0;
+					current = void 0;
+					clearChunks();
+					return;
+				}
+				starting = begin(data, token).catch(report);
+			};
+			const onChange = (change) => {
+				if (destroyed) return;
+				if (change.reset) return restart();
+				let rebuild = false;
+				const patches = change.patches.filter((patch) => patch.type.startsWith("terrain.") || patch.type === "extension.set" && patch.id === "terrain");
+				if (patches.length === 0) return;
+				const next = tryReadTerrain(change.state);
+				if (!next) return restart();
+				for (const patch of patches) if (patch.type === "extension.set" || patch.type === "terrain.materials" || patch.type === "terrain.morphology") rebuild = true;
+				if (rebuild || phase === "idle") return restart();
+				if (phase === "loading") return;
+				let overlay = false;
+				const touchesOverlay = (was, now, rect) => {
+					const indexes = globalOverlayMaterials(now);
+					if (indexes.length === 0) return false;
+					const seen = /* @__PURE__ */ new Set([...readRect(was.mask, rect), ...readRect(now.mask, rect)]);
+					return indexes.some((index) => seen.has(index));
+				};
+				for (const patch of patches) {
+					const dirty = dirtyOfPatch(patch, next, grow);
+					if (dirty === "none") continue;
+					if (patch.type === "terrain.paint" || patch.type === "terrain.region") {
+						const rect = patch.type === "terrain.region" ? {
+							x: patch.x,
+							y: patch.y,
+							width: patch.width,
+							height: patch.height
+						} : shapeBounds(next.mask, patch.shape);
+						if (rect && phase === "initializing") queued.push({
+							rect,
+							values: readRect(next.mask, rect)
+						});
+						else if (rect) backend?.updateMask(rect, readRect(next.mask, rect));
+						if (rect && phase === "ready" && current && touchesOverlay(current, next, rect)) overlay = true;
+					}
+					if (phase === "ready") scheduler?.invalidate(dirty);
+				}
+				if (phase === "ready") {
+					current = next;
+					if (overlay) scheduler?.invalidate("all");
+				}
+			};
+			const editable = options.edit === true || options.pipeline !== void 0;
+			const brush = editable ? terrainBrush(options.brushModes ? { modes: options.brushModes } : {}) : void 0;
+			const stops = [];
+			if (editable) {
+				stops.push(registerTerrainIntents(host.interaction));
+				if (options.pipeline) stops.push(host.interaction.usePipeline("terrain.paint", options.pipeline));
+				stops.push(host.interaction.addTool(brush.tool));
+			}
+			stops.push(host.model.subscribe(onChange), host.onViewport((next) => {
+				viewport = next;
+				scheduler?.setViewport(next);
+			}));
+			restart();
+			return {
+				api: {
+					whenIdle: async () => {
+						await starting;
+						await scheduler?.whenIdle();
+					},
+					get pending() {
+						return scheduler?.pending ?? 0;
+					},
+					get backend() {
+						return backend;
+					},
+					brush: brush?.api
+				},
+				dispose() {
+					destroyed = true;
+					generation += 1;
+					for (const stop of stops) stop();
+					scheduler?.destroy();
+					clearChunks();
+					container.destroy();
+					backend?.destroy();
+				}
+			};
+		}
+	});
+}
+//#endregion
+export { TERRAIN_FEATURE_ID, canvasSurface, decodeRaster, memorySurface, terrain };
+
+//# sourceMappingURL=terrain.js.map

package/dist/features/terrain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain.js","names":[],"sources":["../../src/features/terrain.ts"],"sourcesContent":["import { Container, Sprite, Texture, TextureSource } from \"pixi.js\";\nimport type { RasterImage } from \"@rpgjs/render-map2d\";\nimport type { InteractionController } from \"../interaction/controller\";\nimport type { PipelineStep } from \"../interaction/pipeline\";\nimport type { MapChange } from \"../model/model\";\nimport type { Unsubscribe } from \"../model/result\";\nimport { defineMapFeature, type MapFeature } from \"../renderer/feature\";\nimport type { TerrainBackend } from \"../terrain-render/backend\";\nimport { readTerrain, tryReadTerrain } from \"../terrain/data\";\nimport { dirtyOfPatch, globalOverlayMaterials, renderMargin, widestBlend, type MaterialSource, type TerrainRenderInit } from \"../terrain/kernel\";\nimport { readRect, shapeBounds } from \"../terrain/mask\";\nimport { createTerrainScheduler, type TerrainFrame, type TerrainScheduler } from \"../terrain/scheduler\";\nimport { registerTerrainIntents, terrainBrush, type BrushApi } from \"../terrain/editing\";\nimport type { MaskRect, TerrainData } from \"../terrain/types\";\n\nexport const TERRAIN_FEATURE_ID = \"terrain\";\n\n/** One chunk of the terrain as pixels: a texture, and a way to write into it. */\nexport interface TerrainSurface {\n  readonly texture: Texture;\n  /** Writes RGBA pixels at `(x, y)` inside the surface, then makes the change visible. */\n  put(x: number, y: number, width: number, height: number, pixels: Uint8ClampedArray): void;\n  destroy(): void;\n}\n\nexport type TerrainSurfaceFactory = (width: number, height: number) => TerrainSurface;\n\nexport interface TerrainOptions {\n  /**\n   * Where the kernel runs. Defaults to the calling thread, which is fine for small maps and tests.\n   * For live painting use `workerTerrainBackend` from `@rpgjs/map-builder/terrain-render`.\n   */\n  readonly backend?: TerrainBackend | (() => TerrainBackend | Promise<TerrainBackend>);\n  /** Decodes an image into pixels. Defaults to the browser (`createImageBitmap`). */\n  readonly loadImage?: (src: string) => Promise<RasterImage>;\n  /** Side of the squares the terrain is rendered in. Defaults to 512. */\n  readonly chunk?: number;\n  /** How chunk textures are made. Defaults to canvases; replaceable for tests. */\n  readonly surface?: TerrainSurfaceFactory;\n  /** Receives non-fatal problems (an image that did not load, a render that failed). Defaults to `console.warn`. */\n  readonly onError?: (error: unknown) => void;\n  /**\n   * Make the terrain editable: registers the `terrain.paint` intent and the brush (`view.terrain.brush`).\n   * Passing `pipeline` also turns it on.\n   */\n  readonly edit?: boolean;\n  /** Rules every painting goes through, whoever asks: the brush, `view.submit`, a game. */\n  readonly pipeline?: readonly PipelineStep<\"terrain.paint\">[];\n  /** Modes in which the brush is active. Defaults to `[\"edit\"]`. */\n  readonly brushModes?: readonly string[];\n}\n\nexport interface TerrainApi {\n  /** Resolves when everything that was asked to be (re)rendered has been. */\n  whenIdle(): Promise<void>;\n  /** Chunks waiting or being rendered. */\n  readonly pending: number;\n  /** The backend in use, once there is one. */\n  readonly backend: TerrainBackend | undefined;\n  /** The brush, when the terrain is editable (`terrain({ edit: true })`). */\n  readonly brush: BrushApi | undefined;\n}\n\n/** Pixels of an image, decoded in the browser. */\nexport async function decodeRaster(src: string): Promise<RasterImage> {\n  const response = await fetch(src);\n  if (!response.ok) throw new Error(`Could not load \"${src}\" (${response.status})`);\n  const bitmap = await createImageBitmap(await response.blob());\n  const canvas = typeof OffscreenCanvas !== \"undefined\" ? new OffscreenCanvas(bitmap.width, bitmap.height) : Object.assign(document.createElement(\"canvas\"), { width: bitmap.width, height: bitmap.height });\n  const context = canvas.getContext(\"2d\") as OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D;\n  context.drawImage(bitmap, 0, 0);\n  const image = context.getImageData(0, 0, bitmap.width, bitmap.height);\n  bitmap.close();\n  return { width: image.width, height: image.height, pixels: image.data };\n}\n\n/** Surfaces backed by canvases (nearest filtering, 1:1: the pixels are what the kernel produced). */\nexport const canvasSurface: TerrainSurfaceFactory = (width, height) => {\n  const canvas = document.createElement(\"canvas\");\n  canvas.width = width;\n  canvas.height = height;\n  const context = canvas.getContext(\"2d\")!;\n  const texture = Texture.from(canvas);\n  texture.source.scaleMode = \"nearest\";\n  return {\n    texture,\n    put(x, y, w, h, pixels) {\n      context.putImageData(new ImageData(pixels as Uint8ClampedArray<ArrayBuffer>, w, h), x, y);\n      texture.source.update();\n    },\n    destroy: () => texture.destroy(true),\n  };\n};\n\n/** Surfaces that only keep their pixels in memory: for tests and tools that read them back. */\nexport function memorySurface(): TerrainSurfaceFactory & { pixelsOf(texture: Texture): Uint8ClampedArray | undefined } {\n  const store = new WeakMap<Texture, Uint8ClampedArray>();\n  const factory: TerrainSurfaceFactory = (width, height) => {\n    const pixels = new Uint8ClampedArray(width * height * 4);\n    const texture = new Texture({ source: new TextureSource({ width, height }) });\n    store.set(texture, pixels);\n    return {\n      texture,\n      put(x, y, w, h, source) {\n        for (let row = 0; row < h; row += 1) pixels.set(source.subarray(row * w * 4, (row + 1) * w * 4), ((y + row) * width + x) * 4);\n      },\n      destroy: () => texture.destroy(true),\n    };\n  };\n  return Object.assign(factory, { pixelsOf: (texture: Texture) => store.get(texture) });\n}\n\n/**\n * Draws the painted terrain of the map (`extensions.terrain`): the control mask, the materials and\n * their render modes, rendered by the kernel of `@rpgjs/render-map2d` into chunk textures.\n * Painting changes only the chunks it touches. What is on screen renders first.\n */\nexport function terrain(options: TerrainOptions = {}): MapFeature<\"terrain\", TerrainApi> {\n  return defineMapFeature<\"terrain\", TerrainApi>({\n    id: TERRAIN_FEATURE_ID,\n    setup(host) {\n      const chunk = options.chunk ?? 512;\n      const makeSurface = options.surface ?? canvasSurface;\n      const report = options.onError ?? ((error: unknown) => console.warn(\"[map-builder] terrain:\", error));\n      const container = new Container();\n      container.label = \"terrain\";\n      host.stages.ground.addChild(container);\n\n      const sprites = new Map<number, { sprite: Sprite; surface: TerrainSurface }>();\n      let backend: TerrainBackend | undefined;\n      let scheduler: TerrainScheduler | undefined;\n      let current: TerrainData | undefined;\n      let grow = 0;\n      let margin = 0;\n      let viewport: { x: number; y: number; width: number; height: number } | null = null;\n      let generation = 0;\n      let destroyed = false;\n      let starting: Promise<void> = Promise.resolve();\n      // \"loading\": images and backend are being prepared, the terrain is read when they are ready.\n      // \"initializing\": the backend has its copy of the terrain; changes made since are queued and replayed.\n      // \"ready\": changes go straight to the backend.\n      let phase: \"idle\" | \"loading\" | \"initializing\" | \"ready\" = \"idle\";\n      let queued: Array<{ rect: MaskRect; values: Uint16Array }> = [];\n      const images = new Map<string, Promise<RasterImage>>();\n\n      const loadImage = (src: string): Promise<RasterImage> => {\n        let promise = images.get(src);\n        if (!promise) {\n          promise = (options.loadImage ?? decodeRaster)(src);\n          images.set(src, promise);\n          promise.catch(() => images.delete(src));\n        }\n        return promise;\n      };\n\n      const colsOf = (data: TerrainData): number => Math.ceil((host.model.state.size[0] ?? data.mask.width) / chunk);\n\n      const place = (frame: TerrainFrame): void => {\n        const data = current;\n        if (!data || destroyed) return;\n        const col = Math.floor(frame.x / chunk);\n        const row = Math.floor(frame.y / chunk);\n        const index = row * colsOf(data) + col;\n        let entry = sprites.get(index);\n        if (!entry) {\n          const surface = makeSurface(chunk, chunk);\n          const sprite = new Sprite(surface.texture);\n          sprite.position.set(col * chunk, row * chunk);\n          container.addChild(sprite);\n          entry = { sprite, surface };\n          sprites.set(index, entry);\n        }\n        entry.surface.put(frame.x - col * chunk, frame.y - row * chunk, frame.width, frame.height, frame.pixels);\n      };\n\n      const sourcesOf = (data: TerrainData): Record<string, MaterialSource> => {\n        const out: Record<string, MaterialSource> = {};\n        for (const material of data.materials) {\n          const asset = host.assets.resolve(material.texture);\n          if (asset) out[material.id] = { src: asset.src, ...(asset.frame ? { frame: asset.frame } : {}) };\n          else report(new Error(`terrain material \"${material.id}\": unknown asset \"${material.texture}\"`));\n        }\n        return out;\n      };\n\n      const clearChunks = (): void => {\n        for (const { sprite, surface } of sprites.values()) {\n          sprite.destroy();\n          surface.destroy();\n        }\n        sprites.clear();\n      };\n\n      /** Gives the backend the terrain as it is now and renders everything. */\n      async function begin(first: TerrainData, token: number): Promise<void> {\n        const sources = sourcesOf(first);\n        const loaded: Record<string, RasterImage> = {};\n        await Promise.all(\n          [...new Set(Object.values(sources).map((source) => source.src))].map(async (src) => {\n            try {\n              loaded[src] = await loadImage(src);\n            } catch (error) {\n              report(error);\n            }\n          }),\n        );\n        if (token !== generation || destroyed) return;\n        if (!backend) {\n          const made = typeof options.backend === \"function\" ? await options.backend() : options.backend;\n          backend = made ?? (await import(\"../terrain-render/backend\")).inlineTerrainBackend();\n          if (token !== generation || destroyed) return;\n        }\n        // The terrain as it is now, not as it was when the restart began: edits may have come in while loading.\n        const state = host.model.state;\n        const data = tryReadTerrain(state);\n        if (!data) return;\n        const init: TerrainRenderInit = { data, size: state.size, tileSize: state.tileSize ?? 48, sources, images: loaded };\n        phase = \"initializing\";\n        queued = [];\n        await backend.init(init);\n        if (token !== generation || destroyed) return;\n        for (const change of queued) backend.updateMask(change.rect, change.values);\n        queued = [];\n        phase = \"ready\";\n        current = data;\n        grow = widestBlend(data);\n        margin = renderMargin(data);\n        scheduler?.destroy();\n        clearChunks();\n        const used = backend;\n        scheduler = createTerrainScheduler({\n          size: state.size,\n          chunk,\n          concurrency: used.concurrency,\n          render: (rect) => used.render(rect, margin),\n          apply: place,\n          onError: (error) => report(error),\n        });\n        scheduler.setViewport(viewport);\n        scheduler.invalidate(\"all\");\n      }\n\n      const restart = (): void => {\n        generation += 1;\n        const token = generation;\n        const data = tryReadTerrain(host.model.state);\n        phase = data ? \"loading\" : \"idle\";\n        if (!data) {\n          scheduler?.destroy();\n          scheduler = undefined;\n          current = undefined;\n          clearChunks();\n          return;\n        }\n        starting = begin(data, token).catch(report);\n      };\n\n      const onChange = (change: MapChange): void => {\n        if (destroyed) return;\n        if (change.reset) return restart();\n        let rebuild = false;\n        const patches = change.patches.filter((patch) => patch.type.startsWith(\"terrain.\") || (patch.type === \"extension.set\" && patch.id === \"terrain\"));\n        if (patches.length === 0) return;\n        const next = tryReadTerrain(change.state);\n        if (!next) return restart();\n        for (const patch of patches) {\n          if (patch.type === \"extension.set\" || patch.type === \"terrain.materials\" || patch.type === \"terrain.morphology\") rebuild = true;\n        }\n        if (rebuild || phase === \"idle\") return restart();\n        // The terrain is read when loading ends: it already includes this change.\n        if (phase === \"loading\") return;\n        // Mask changes: the backend gets the new values, in order, then the affected chunks render again.\n        let overlay = false;\n        const touchesOverlay = (was: TerrainData, now: TerrainData, rect: MaskRect): boolean => {\n          const indexes = globalOverlayMaterials(now);\n          if (indexes.length === 0) return false;\n          const seen = new Set<number>([...readRect(was.mask, rect), ...readRect(now.mask, rect)]);\n          return indexes.some((index) => seen.has(index));\n        };\n        for (const patch of patches) {\n          const dirty = dirtyOfPatch(patch, next, grow);\n          if (dirty === \"none\") continue;\n          if (patch.type === \"terrain.paint\" || patch.type === \"terrain.region\") {\n            const rect: MaskRect | undefined = patch.type === \"terrain.region\" ? { x: patch.x, y: patch.y, width: patch.width, height: patch.height } : shapeBounds(next.mask, patch.shape);\n            if (rect && phase === \"initializing\") queued.push({ rect, values: readRect(next.mask, rect) });\n            else if (rect) backend?.updateMask(rect, readRect(next.mask, rect));\n            // A preset that follows the whole shape (lane marks of a road) may change anywhere when its material is touched.\n            if (rect && phase === \"ready\" && current && touchesOverlay(current, next, rect)) overlay = true;\n          }\n          if (phase === \"ready\") scheduler?.invalidate(dirty);\n        }\n        if (phase === \"ready\") {\n          current = next;\n          if (overlay) scheduler?.invalidate(\"all\");\n        }\n      };\n\n      const editable = options.edit === true || options.pipeline !== undefined;\n      const brush = editable ? terrainBrush(options.brushModes ? { modes: options.brushModes } : {}) : undefined;\n      const stops: Unsubscribe[] = [];\n      if (editable) {\n        stops.push(registerTerrainIntents(host.interaction as unknown as InteractionController));\n        if (options.pipeline) stops.push(host.interaction.usePipeline(\"terrain.paint\", options.pipeline));\n        stops.push(host.interaction.addTool(brush!.tool));\n      }\n      stops.push(host.model.subscribe(onChange), host.onViewport((next) => { viewport = next; scheduler?.setViewport(next); }));\n      restart();\n\n      return {\n        api: {\n          whenIdle: async () => {\n            await starting;\n            await scheduler?.whenIdle();\n          },\n          get pending() {\n            return scheduler?.pending ?? 0;\n          },\n          get backend() {\n            return backend;\n          },\n          brush: brush?.api,\n        },\n        dispose() {\n          destroyed = true;\n          generation += 1;\n          for (const stop of stops) stop();\n          scheduler?.destroy();\n          clearChunks();\n          container.destroy();\n          backend?.destroy();\n        },\n      };\n    },\n  });\n}\n\nexport { readTerrain };\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './model/index';
+export * from './renderer/index';
+export * from './features/index';
+export * from './interaction/index';
+export * from './skins/index';
+export * from './protocol/index';
+export * from './authority/index';
+export * from './remote/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,51 @@
+import { cloneJson, isFiniteNumberValue, isJsonObject, isJsonValue, isPlainObject } from "./model/json.js";
+import { MAP_DEFINITION_VERSION } from "./model/definition.js";
+import { MapDefinitionError } from "./model/errors.js";
+import { checkPlaced, defaultMapMigrations, isScale, parseMapDefinition } from "./model/parse.js";
+import { defineAssets } from "./model/assets.js";
+import { defineMap, el, event } from "./model/define-map.js";
+import { definePatchHandlers, patchFail, patchOk } from "./model/patches.js";
+import { chain, isThenable } from "./model/result.js";
+import { createHistory } from "./model/history.js";
+import { localCommitter } from "./model/committer.js";
+import { coreHandlers } from "./model/core-patches.js";
+import { DEFAULT_HISTORY_LIMIT, createMapModel } from "./model/model.js";
+import { MapSourceError, codeMapSource, httpMapSource, jsonMapSource, loadMapRegion, regionOf } from "./model/source.js";
+import "./model/index.js";
+import { grow, intersects, normalizeScale, resolveElementGeometry, unionBounds } from "./renderer/geometry.js";
+import { STAGE_ORDER, describeElement, describeEvent } from "./renderer/scene.js";
+import { blinkEffect, builtInEffects, createEffectRunner, shakeEffect } from "./renderer/effects.js";
+import { MAP_FEATURE_API_VERSION, MapFeatureError, RESERVED_FEATURE_IDS, defineMapFeature, validateFeatures } from "./renderer/feature.js";
+import { createTextureStore, pixiTextureProvider } from "./renderer/textures.js";
+import { bindKeyboard, toKeyInput } from "./interaction/keyboard.js";
+import { nodesIn, pickNode, pickNodes, sameTarget, targetKey, targetOf } from "./interaction/picking.js";
+import { compose, runPipeline } from "./interaction/pipeline.js";
+import { createStore } from "./interaction/store.js";
+import { createInteraction, uniqueTargets as unique } from "./interaction/controller.js";
+import { attachMapView, createMapView } from "./renderer/view.js";
+import "./renderer/index.js";
+import { registerElementIntents } from "./interaction/builtin-intents.js";
+import { createPlacement, registerPlacementIntent } from "./interaction/placement.js";
+import { selectionTool } from "./interaction/selection-tool.js";
+import { drawFrames, frameLayer, nodeOf } from "./skins/frames.js";
+import { SKIN_COLORS, defaultSkin, framesSkin, ghostLayer } from "./skins/default.js";
+import { defineSkin, mergeSkin } from "./skins/types.js";
+import { mountSkinLayers } from "./features/skin.js";
+import { TERRAIN_FEATURE_ID, canvasSurface, decodeRaster, memorySurface, terrain } from "./features/terrain.js";
+import { ELEMENTS_FEATURE_ID, EVENTS_FEATURE_ID, HISTORY_FEATURE_ID, PLACEMENT_FEATURE_ID, SELECTION_FEATURE_ID, elements, events, history, placement, selection } from "./features/index.js";
+import { NO_MODIFIERS, key, pointer } from "./interaction/input.js";
+import { maxCount, minDistance, ownerOnly, protectedZone, rateLimit, requireFree, snapToGrid, withinMap } from "./interaction/steps.js";
+import { defineCatalog } from "./interaction/catalog.js";
+import { hoverTool, playTool } from "./interaction/tools.js";
+import "./interaction/index.js";
+import { gameSkin } from "./skins/game.js";
+import "./skins/index.js";
+import { MAP_BUILDER_EVENT, PROTOCOL_LIMITS, parseClientMessage, parseServerMessage } from "./protocol/index.js";
+import { MapStoreCorruptError, memoryMapStore } from "./authority/store.js";
+import { createMapAuthority, restoreMapAuthority } from "./authority/authority.js";
+import "./authority/index.js";
+import { remoteCommitter } from "./remote/committer.js";
+import { bindRemoteEffects, joinRemoteMap } from "./remote/join.js";
+import { connectInMemory } from "./remote/memory-transport.js";
+import "./remote/index.js";
+export { DEFAULT_HISTORY_LIMIT, ELEMENTS_FEATURE_ID, EVENTS_FEATURE_ID, HISTORY_FEATURE_ID, MAP_BUILDER_EVENT, MAP_DEFINITION_VERSION, MAP_FEATURE_API_VERSION, MapDefinitionError, MapFeatureError, MapSourceError, MapStoreCorruptError, NO_MODIFIERS, PLACEMENT_FEATURE_ID, PROTOCOL_LIMITS, RESERVED_FEATURE_IDS, SELECTION_FEATURE_ID, SKIN_COLORS, STAGE_ORDER, TERRAIN_FEATURE_ID, attachMapView, bindKeyboard, bindRemoteEffects, blinkEffect, builtInEffects, canvasSurface, chain, checkPlaced, cloneJson, codeMapSource, compose, connectInMemory, coreHandlers, createEffectRunner, createHistory, createInteraction, createMapAuthority, createMapModel, createMapView, createPlacement, createStore, createTextureStore, decodeRaster, defaultMapMigrations, defaultSkin, defineAssets, defineCatalog, defineMap, defineMapFeature, definePatchHandlers, defineSkin, describeElement, describeEvent, drawFrames, el, elements, event, events, frameLayer, framesSkin, gameSkin, ghostLayer, grow, history, hoverTool, httpMapSource, intersects, isFiniteNumberValue, isJsonObject, isJsonValue, isPlainObject, isScale, isThenable, joinRemoteMap, jsonMapSource, key, loadMapRegion, localCommitter, maxCount, memoryMapStore, memorySurface, mergeSkin, minDistance, mountSkinLayers, nodeOf, nodesIn, normalizeScale, ownerOnly, parseClientMessage, parseMapDefinition, parseServerMessage, patchFail, patchOk, pickNode, pickNodes, pixiTextureProvider, placement, playTool, pointer, protectedZone, rateLimit, regionOf, registerElementIntents, registerPlacementIntent, remoteCommitter, requireFree, resolveElementGeometry, restoreMapAuthority, runPipeline, sameTarget, selection, selectionTool, shakeEffect, snapToGrid, targetKey, targetOf, terrain, toKeyInput, unionBounds, unique as uniqueTargets, validateFeatures, withinMap };

package/dist/interaction/builtin-intents.d.ts

@@ -0,0 +1,9 @@
+import { InteractionController } from './controller';
+import { Unsubscribe } from '../model/result';
+/**
+ * Registers `element.move` and `element.remove`, the intents every editing tool of
+ * elements relies on. Those already registered are left alone, so several features
+ * can each make sure they are there.
+ */
+export declare function registerElementIntents(controller: InteractionController): Unsubscribe;
+//# sourceMappingURL=builtin-intents.d.ts.map

package/dist/interaction/builtin-intents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-intents.d.ts","sourceRoot":"","sources":["../../src/interaction/builtin-intents.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAiCnD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,qBAAqB,GAAG,WAAW,CAKrF"}

package/dist/interaction/builtin-intents.js

@@ -0,0 +1,61 @@
+import { describeElement } from "../renderer/scene.js";
+//#region src/interaction/builtin-intents.ts
+var footprintAt = (element, x, y, context) => {
+	if (!element) return void 0;
+	const node = describeElement({
+		...element,
+		x,
+		y
+	}, context.describe);
+	if (!node) return void 0;
+	return {
+		bounds: node.bounds,
+		...node.hitbox ? { hitbox: node.hitbox } : {},
+		ignore: [{
+			type: "element",
+			id: element.id
+		}]
+	};
+};
+var move = {
+	resolve(intent, { state }) {
+		if (!state.elements.some((element) => element.id === intent.id)) return {
+			ok: false,
+			reason: "not-found",
+			message: `Element "${intent.id}" does not exist`
+		};
+		return {
+			type: "element.move",
+			id: intent.id,
+			x: intent.x,
+			y: intent.y
+		};
+	},
+	footprint: (intent, context) => footprintAt(context.state.elements.find((element) => element.id === intent.id), intent.x, intent.y, context)
+};
+var remove = { resolve(intent, { state }) {
+	if (!state.elements.some((element) => element.id === intent.id)) return {
+		ok: false,
+		reason: "not-found",
+		message: `Element "${intent.id}" does not exist`
+	};
+	return {
+		type: "element.remove",
+		id: intent.id
+	};
+} };
+/**
+* Registers `element.move` and `element.remove`, the intents every editing tool of
+* elements relies on. Those already registered are left alone, so several features
+* can each make sure they are there.
+*/
+function registerElementIntents(controller) {
+	const stops = [];
+	if (!controller.hasIntent("element.move")) stops.push(controller.registerIntent("element.move", move));
+	if (!controller.hasIntent("element.remove")) stops.push(controller.registerIntent("element.remove", remove));
+	return () => stops.forEach((stop) => stop());
+}
+//#endregion
+export { registerElementIntents };
+
+//# sourceMappingURL=builtin-intents.js.map

package/dist/interaction/builtin-intents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-intents.js","names":[],"sources":["../../src/interaction/builtin-intents.ts"],"sourcesContent":["import type { MapElement } from \"../model/definition\";\nimport { describeElement } from \"../renderer/scene\";\nimport type { InteractionController } from \"./controller\";\nimport type { Footprint, IntentContext, IntentDefinition } from \"./intents\";\nimport type { Unsubscribe } from \"../model/result\";\n\nconst footprintAt = (element: MapElement | undefined, x: number, y: number, context: IntentContext): Footprint | undefined => {\n  if (!element) return undefined;\n  const node = describeElement({ ...element, x, y }, context.describe);\n  if (!node) return undefined;\n  return {\n    bounds: node.bounds,\n    ...(node.hitbox ? { hitbox: node.hitbox } : {}),\n    // The element does not block itself at its new position.\n    ignore: [{ type: \"element\", id: element.id }],\n  };\n};\n\nconst move: IntentDefinition<\"element.move\"> = {\n  resolve(intent, { state }) {\n    if (!state.elements.some((element) => element.id === intent.id)) {\n      return { ok: false, reason: \"not-found\", message: `Element \"${intent.id}\" does not exist` };\n    }\n    return { type: \"element.move\", id: intent.id, x: intent.x, y: intent.y };\n  },\n  footprint: (intent, context) => footprintAt(context.state.elements.find((element) => element.id === intent.id), intent.x, intent.y, context),\n};\n\nconst remove: IntentDefinition<\"element.remove\"> = {\n  resolve(intent, { state }) {\n    if (!state.elements.some((element) => element.id === intent.id)) {\n      return { ok: false, reason: \"not-found\", message: `Element \"${intent.id}\" does not exist` };\n    }\n    return { type: \"element.remove\", id: intent.id };\n  },\n};\n\n/**\n * Registers `element.move` and `element.remove`, the intents every editing tool of\n * elements relies on. Those already registered are left alone, so several features\n * can each make sure they are there.\n */\nexport function registerElementIntents(controller: InteractionController): Unsubscribe {\n  const stops: Unsubscribe[] = [];\n  if (!controller.hasIntent(\"element.move\")) stops.push(controller.registerIntent(\"element.move\", move));\n  if (!controller.hasIntent(\"element.remove\")) stops.push(controller.registerIntent(\"element.remove\", remove));\n  return () => stops.forEach((stop) => stop());\n}\n"],"mappings":";;AAMA,IAAM,eAAe,SAAiC,GAAW,GAAW,YAAkD;CAC5H,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,MAAM,OAAO,gBAAgB;EAAE,GAAG;EAAS;EAAG;CAAE,GAAG,QAAQ,QAAQ;CACnE,IAAI,CAAC,MAAM,OAAO,KAAA;CAClB,OAAO;EACL,QAAQ,KAAK;EACb,GAAI,KAAK,SAAS,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;EAE7C,QAAQ,CAAC;GAAE,MAAM;GAAW,IAAI,QAAQ;EAAG,CAAC;CAC9C;AACF;AAEA,IAAM,OAAyC;CAC7C,QAAQ,QAAQ,EAAE,SAAS;EACzB,IAAI,CAAC,MAAM,SAAS,MAAM,YAAY,QAAQ,OAAO,OAAO,EAAE,GAC5D,OAAO;GAAE,IAAI;GAAO,QAAQ;GAAa,SAAS,YAAY,OAAO,GAAG;EAAkB;EAE5F,OAAO;GAAE,MAAM;GAAgB,IAAI,OAAO;GAAI,GAAG,OAAO;GAAG,GAAG,OAAO;EAAE;CACzE;CACA,YAAY,QAAQ,YAAY,YAAY,QAAQ,MAAM,SAAS,MAAM,YAAY,QAAQ,OAAO,OAAO,EAAE,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO;AAC7I;AAEA,IAAM,SAA6C,EACjD,QAAQ,QAAQ,EAAE,SAAS;CACzB,IAAI,CAAC,MAAM,SAAS,MAAM,YAAY,QAAQ,OAAO,OAAO,EAAE,GAC5D,OAAO;EAAE,IAAI;EAAO,QAAQ;EAAa,SAAS,YAAY,OAAO,GAAG;CAAkB;CAE5F,OAAO;EAAE,MAAM;EAAkB,IAAI,OAAO;CAAG;AACjD,EACF;;;;;;AAOA,SAAgB,uBAAuB,YAAgD;CACrF,MAAM,QAAuB,CAAC;CAC9B,IAAI,CAAC,WAAW,UAAU,cAAc,GAAG,MAAM,KAAK,WAAW,eAAe,gBAAgB,IAAI,CAAC;CACrG,IAAI,CAAC,WAAW,UAAU,gBAAgB,GAAG,MAAM,KAAK,WAAW,eAAe,kBAAkB,MAAM,CAAC;CAC3G,aAAa,MAAM,SAAS,SAAS,KAAK,CAAC;AAC7C"}

package/dist/interaction/catalog.d.ts

@@ -0,0 +1,24 @@
+import { JsonObject } from '../model/json';
+import { IntentType, PositionedIntentType } from './intents';
+import { PipelineStep } from './pipeline';
+export interface CatalogItem<Id extends string = string> {
+    /** What the UI and `placement.start()` call it. */
+    readonly id: Id;
+    /** The asset drawn once placed (an `AssetResolver` reference). */
+    readonly sprite: string;
+    /** Initial `data` of the element created. */
+    readonly data?: JsonObject;
+    /** Rules specific to this item, run after those of the feature. */
+    readonly pipeline?: readonly PipelineStep<"element.place">[];
+}
+export interface Catalog<Id extends string = string> {
+    readonly ids: readonly Id[];
+    readonly items: readonly CatalogItem<Id>[];
+    get(id: string): CatalogItem<Id> | undefined;
+    has(id: string): id is Id;
+}
+/** What can be placed, as data: Studio brings a rich catalog, a game three trees. Ids are checked by the compiler. */
+export declare function defineCatalog<const Items extends readonly CatalogItem<string>[]>(items: Items): Catalog<Items[number]["id"]>;
+export type CatalogId<C> = C extends Catalog<infer Id> ? Id : never;
+export type { IntentType, PositionedIntentType };
+//# sourceMappingURL=catalog.d.ts.map

package/dist/interaction/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/interaction/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,WAAW,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM;IACrD,mDAAmD;IACnD,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,CAAC,eAAe,CAAC,EAAE,CAAC;CAC9D;AAED,MAAM,WAAW,OAAO,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM;IACjD,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;IAC3C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;IAC7C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,EAAE,CAAC;CAC3B;AAED,sHAAsH;AACtH,wBAAgB,aAAa,CAAC,KAAK,CAAC,KAAK,SAAS,SAAS,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAa5H;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/interaction/catalog.js

@@ -0,0 +1,20 @@
+//#region src/interaction/catalog.ts
+/** What can be placed, as data: Studio brings a rich catalog, a game three trees. Ids are checked by the compiler. */
+function defineCatalog(items) {
+	const table = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		if (typeof item.id !== "string" || item.id.length === 0) throw new Error("A catalog item needs a non-empty id");
+		if (table.has(item.id)) throw new Error(`Catalog item "${item.id}" is defined twice`);
+		table.set(item.id, item);
+	}
+	return {
+		ids: [...table.keys()],
+		items: [...table.values()],
+		get: (id) => table.get(id),
+		has: (id) => table.has(id)
+	};
+}
+//#endregion
+export { defineCatalog };
+
+//# sourceMappingURL=catalog.js.map

package/dist/interaction/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","names":[],"sources":["../../src/interaction/catalog.ts"],"sourcesContent":["import type { JsonObject } from \"../model/json\";\nimport type { IntentType, PositionedIntentType } from \"./intents\";\nimport type { PipelineStep } from \"./pipeline\";\n\nexport interface CatalogItem<Id extends string = string> {\n  /** What the UI and `placement.start()` call it. */\n  readonly id: Id;\n  /** The asset drawn once placed (an `AssetResolver` reference). */\n  readonly sprite: string;\n  /** Initial `data` of the element created. */\n  readonly data?: JsonObject;\n  /** Rules specific to this item, run after those of the feature. */\n  readonly pipeline?: readonly PipelineStep<\"element.place\">[];\n}\n\nexport interface Catalog<Id extends string = string> {\n  readonly ids: readonly Id[];\n  readonly items: readonly CatalogItem<Id>[];\n  get(id: string): CatalogItem<Id> | undefined;\n  has(id: string): id is Id;\n}\n\n/** What can be placed, as data: Studio brings a rich catalog, a game three trees. Ids are checked by the compiler. */\nexport function defineCatalog<const Items extends readonly CatalogItem<string>[]>(items: Items): Catalog<Items[number][\"id\"]> {\n  const table = new Map<string, CatalogItem<Items[number][\"id\"]>>();\n  for (const item of items) {\n    if (typeof item.id !== \"string\" || item.id.length === 0) throw new Error(\"A catalog item needs a non-empty id\");\n    if (table.has(item.id)) throw new Error(`Catalog item \"${item.id}\" is defined twice`);\n    table.set(item.id, item);\n  }\n  return {\n    ids: [...table.keys()],\n    items: [...table.values()],\n    get: (id) => table.get(id),\n    has: (id): id is Items[number][\"id\"] => table.has(id),\n  };\n}\n\nexport type CatalogId<C> = C extends Catalog<infer Id> ? Id : never;\nexport type { IntentType, PositionedIntentType };\n"],"mappings":";;AAuBA,SAAgB,cAAkE,OAA4C;CAC5H,MAAM,wBAAQ,IAAI,IAA8C;CAChE,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,OAAO,KAAK,OAAO,YAAY,KAAK,GAAG,WAAW,GAAG,MAAM,IAAI,MAAM,qCAAqC;EAC9G,IAAI,MAAM,IAAI,KAAK,EAAE,GAAG,MAAM,IAAI,MAAM,iBAAiB,KAAK,GAAG,mBAAmB;EACpF,MAAM,IAAI,KAAK,IAAI,IAAI;CACzB;CACA,OAAO;EACL,KAAK,CAAC,GAAG,MAAM,KAAK,CAAC;EACrB,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC;EACzB,MAAM,OAAO,MAAM,IAAI,EAAE;EACzB,MAAM,OAAkC,MAAM,IAAI,EAAE;CACtD;AACF"}