@rpgjs/map-builder 0.0.0-stage → 5.0.0

package/dist/embed/protocol.js

@@ -0,0 +1,161 @@
+import { isJsonValue, isPlainObject } from "../model/json.js";
+//#region src/embed/protocol.ts
+/** Version of the messages between the Studio and a game. Both ends say theirs in the handshake. */
+var EDITOR_PROTOCOL_VERSION = 1;
+/** Marks the window messages of the handshake, so that the page ignores everybody else's. */
+var EDITOR_SOURCE = "rpgjs-map-builder-editor";
+var LIMITS = {
+	/** Targets in one selection. */
+	maxTargets: 1e4,
+	maxModes: 16,
+	maxStringLength: 256
+};
+var isString = (value) => typeof value === "string" && value.length > 0 && value.length <= LIMITS.maxStringLength;
+var isFinite = (value) => typeof value === "number" && Number.isFinite(value);
+function parseTargets(raw) {
+	if (!Array.isArray(raw) || raw.length > LIMITS.maxTargets) return void 0;
+	const out = [];
+	for (const item of raw) {
+		if (!isPlainObject(item) || item.type !== "element" && item.type !== "event" || !isString(item.id)) return void 0;
+		out.push({
+			type: item.type,
+			id: item.id
+		});
+	}
+	return out;
+}
+/** Reads a control message that came through the port. Anything with another shape is `undefined`. */
+function parseControl(raw) {
+	if (!isPlainObject(raw)) return void 0;
+	switch (raw.type) {
+		case "modes": return Array.isArray(raw.modes) && raw.modes.length <= LIMITS.maxModes && raw.modes.every(isString) ? {
+			type: "modes",
+			modes: raw.modes
+		} : void 0;
+		case "tool":
+			if (raw.tool === "none") return {
+				type: "tool",
+				tool: "none"
+			};
+			if (raw.tool === "brush") {
+				if (!(raw.material === null || isString(raw.material)) || !isFinite(raw.radius) || raw.radius <= 0 || raw.radius > 1e4) return void 0;
+				return {
+					type: "tool",
+					tool: "brush",
+					material: raw.material,
+					radius: raw.radius
+				};
+			}
+			return raw.tool === "place" && isString(raw.catalogId) ? {
+				type: "tool",
+				tool: "place",
+				catalogId: raw.catalogId
+			} : void 0;
+		case "select": {
+			const targets = parseTargets(raw.targets);
+			return targets ? {
+				type: "select",
+				targets
+			} : void 0;
+		}
+		case "pause": return typeof raw.paused === "boolean" ? {
+			type: "pause",
+			paused: raw.paused
+		} : void 0;
+		case "camera": return isFinite(raw.x) && isFinite(raw.y) ? {
+			type: "camera",
+			x: raw.x,
+			y: raw.y
+		} : void 0;
+		case "command":
+			if (!isString(raw.name) || !/^[a-zA-Z][\w.:-]*$/.test(raw.name)) return void 0;
+			if (raw.args !== void 0 && !isJsonValue(raw.args)) return void 0;
+			return {
+				type: "command",
+				name: raw.name,
+				...raw.args !== void 0 ? { args: raw.args } : {}
+			};
+		default: return;
+	}
+}
+var parseTool = (raw) => {
+	const parsed = parseControl({
+		type: "tool",
+		...isPlainObject(raw) ? raw : {}
+	});
+	return parsed?.type === "tool" ? (({ type: _type, ...tool }) => tool)(parsed) : void 0;
+};
+/** Reads an event from the game. */
+function parseEvent(raw) {
+	if (!isPlainObject(raw)) return void 0;
+	switch (raw.type) {
+		case "map": return isString(raw.id) ? {
+			type: "map",
+			id: raw.id
+		} : void 0;
+		case "selection": {
+			const targets = parseTargets(raw.targets);
+			return targets ? {
+				type: "selection",
+				targets
+			} : void 0;
+		}
+		case "interaction": {
+			const tool = parseTool(raw.tool);
+			if (!tool || !Array.isArray(raw.modes) || !raw.modes.every(isString)) return void 0;
+			const rejection = isPlainObject(raw.rejection) && typeof raw.rejection.reason === "string" ? {
+				reason: raw.rejection.reason,
+				...typeof raw.rejection.message === "string" ? { message: raw.rejection.message } : {}
+			} : null;
+			return {
+				type: "interaction",
+				modes: raw.modes,
+				tool,
+				rejection
+			};
+		}
+		case "paused": return typeof raw.paused === "boolean" ? {
+			type: "paused",
+			paused: raw.paused
+		} : void 0;
+		case "pointer": return isFinite(raw.x) && isFinite(raw.y) ? {
+			type: "pointer",
+			x: raw.x,
+			y: raw.y
+		} : void 0;
+		case "state": return isString(raw.key) && raw.value !== void 0 && isJsonValue(raw.value) ? {
+			type: "state",
+			key: raw.key,
+			value: raw.value
+		} : void 0;
+		case "error": return typeof raw.message === "string" ? {
+			type: "error",
+			message: raw.message.slice(0, 1e3)
+		} : void 0;
+		default: return;
+	}
+}
+function parseHandshake(raw) {
+	if (!isPlainObject(raw) || raw.source !== "rpgjs-map-builder-editor" || !isFinite(raw.version)) return void 0;
+	return raw.type === "hello" || raw.type === "ready" || raw.type === "connect" ? {
+		source: EDITOR_SOURCE,
+		type: raw.type,
+		version: raw.version
+	} : void 0;
+}
+function parseEnvelope(raw) {
+	if (!isPlainObject(raw) || !isJsonValue(raw)) return void 0;
+	if (raw.ch === "map") return isString(raw.map) ? {
+		ch: "map",
+		map: raw.map,
+		message: raw.message
+	} : void 0;
+	if (raw.ch === "control" || raw.ch === "event") return {
+		ch: raw.ch,
+		message: raw.message
+	};
+}
+//#endregion
+export { EDITOR_PROTOCOL_VERSION, EDITOR_SOURCE, LIMITS, parseControl, parseEnvelope, parseEvent, parseHandshake, parseTargets };
+
+//# sourceMappingURL=protocol.js.map

package/dist/embed/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","names":[],"sources":["../../src/embed/protocol.ts"],"sourcesContent":["import { isPlainObject, isJsonValue, type JsonValue } from \"../model/json\";\nimport type { TargetRef } from \"../interaction/picking\";\n\n/** Version of the messages between the Studio and a game. Both ends say theirs in the handshake. */\nexport const EDITOR_PROTOCOL_VERSION = 1 as const;\n\n/** Marks the window messages of the handshake, so that the page ignores everybody else's. */\nexport const EDITOR_SOURCE = \"rpgjs-map-builder-editor\" as const;\n\n/** The tool that is in hand. */\nexport type EditorTool =\n  | { readonly tool: \"none\" }\n  | { readonly tool: \"brush\"; readonly material: string | null; readonly radius: number }\n  | { readonly tool: \"place\"; readonly catalogId: string };\n\n/** What the Studio asks of the game. */\nexport type ControlMessage =\n  | { readonly type: \"modes\"; readonly modes: readonly string[] }\n  | ({ readonly type: \"tool\" } & EditorTool)\n  | { readonly type: \"select\"; readonly targets: readonly TargetRef[] }\n  | { readonly type: \"pause\"; readonly paused: boolean }\n  | { readonly type: \"camera\"; readonly x: number; readonly y: number }\n  /** Something only the game knows how to do: a command it registered (`copy`, `place`…). */\n  | { readonly type: \"command\"; readonly name: string; readonly args?: JsonValue };\n\n/** What the game tells the Studio. */\nexport type EditorEvent =\n  | { readonly type: \"map\"; readonly id: string }\n  | { readonly type: \"selection\"; readonly targets: readonly TargetRef[] }\n  | {\n      readonly type: \"interaction\";\n      readonly modes: readonly string[];\n      readonly tool: EditorTool;\n      /** Why the last intent was refused, until another is accepted. */\n      readonly rejection: { readonly reason: string; readonly message?: string } | null;\n    }\n  | { readonly type: \"paused\"; readonly paused: boolean }\n  | { readonly type: \"pointer\"; readonly x: number; readonly y: number }\n  /** A value the game keeps and the Studio shows (`tool`, `canUndo`, `layer`…). */\n  | { readonly type: \"state\"; readonly key: string; readonly value: JsonValue }\n  | { readonly type: \"error\"; readonly message: string };\n\n/** Messages of the handshake, sent with `window.postMessage`. */\nexport type HandshakeMessage =\n  | { readonly source: typeof EDITOR_SOURCE; readonly type: \"hello\"; readonly version: number }\n  | { readonly source: typeof EDITOR_SOURCE; readonly type: \"ready\"; readonly version: number }\n  | { readonly source: typeof EDITOR_SOURCE; readonly type: \"connect\"; readonly version: number };\n\nexport const LIMITS = {\n  /** Targets in one selection. */\n  maxTargets: 10_000,\n  maxModes: 16,\n  maxStringLength: 256,\n} as const;\n\nconst isString = (value: unknown): value is string => typeof value === \"string\" && value.length > 0 && value.length <= LIMITS.maxStringLength;\nconst isFinite = (value: unknown): value is number => typeof value === \"number\" && Number.isFinite(value);\n\nexport function parseTargets(raw: unknown): TargetRef[] | undefined {\n  if (!Array.isArray(raw) || raw.length > LIMITS.maxTargets) return undefined;\n  const out: TargetRef[] = [];\n  for (const item of raw) {\n    if (!isPlainObject(item) || (item.type !== \"element\" && item.type !== \"event\") || !isString(item.id)) return undefined;\n    out.push({ type: item.type, id: item.id });\n  }\n  return out;\n}\n\n/** Reads a control message that came through the port. Anything with another shape is `undefined`. */\nexport function parseControl(raw: unknown): ControlMessage | undefined {\n  if (!isPlainObject(raw)) return undefined;\n  switch (raw.type) {\n    case \"modes\":\n      return Array.isArray(raw.modes) && raw.modes.length <= LIMITS.maxModes && raw.modes.every(isString) ? { type: \"modes\", modes: raw.modes as string[] } : undefined;\n    case \"tool\":\n      if (raw.tool === \"none\") return { type: \"tool\", tool: \"none\" };\n      if (raw.tool === \"brush\") {\n        if (!(raw.material === null || isString(raw.material)) || !isFinite(raw.radius) || raw.radius <= 0 || raw.radius > 10_000) return undefined;\n        return { type: \"tool\", tool: \"brush\", material: raw.material, radius: raw.radius };\n      }\n      return raw.tool === \"place\" && isString(raw.catalogId) ? { type: \"tool\", tool: \"place\", catalogId: raw.catalogId } : undefined;\n    case \"select\": {\n      const targets = parseTargets(raw.targets);\n      return targets ? { type: \"select\", targets } : undefined;\n    }\n    case \"pause\":\n      return typeof raw.paused === \"boolean\" ? { type: \"pause\", paused: raw.paused } : undefined;\n    case \"camera\":\n      return isFinite(raw.x) && isFinite(raw.y) ? { type: \"camera\", x: raw.x, y: raw.y } : undefined;\n    case \"command\":\n      if (!isString(raw.name) || !/^[a-zA-Z][\\w.:-]*$/.test(raw.name)) return undefined;\n      if (raw.args !== undefined && !isJsonValue(raw.args)) return undefined;\n      return { type: \"command\", name: raw.name, ...(raw.args !== undefined ? { args: raw.args as JsonValue } : {}) };\n    default:\n      return undefined;\n  }\n}\n\nconst parseTool = (raw: unknown): EditorTool | undefined => {\n  const parsed = parseControl({ type: \"tool\", ...(isPlainObject(raw) ? raw : {}) });\n  return parsed?.type === \"tool\" ? (({ type: _type, ...tool }) => tool as EditorTool)(parsed) : undefined;\n};\n\n/** Reads an event from the game. */\nexport function parseEvent(raw: unknown): EditorEvent | undefined {\n  if (!isPlainObject(raw)) return undefined;\n  switch (raw.type) {\n    case \"map\":\n      return isString(raw.id) ? { type: \"map\", id: raw.id } : undefined;\n    case \"selection\": {\n      const targets = parseTargets(raw.targets);\n      return targets ? { type: \"selection\", targets } : undefined;\n    }\n    case \"interaction\": {\n      const tool = parseTool(raw.tool);\n      if (!tool || !Array.isArray(raw.modes) || !raw.modes.every(isString)) return undefined;\n      const rejection = isPlainObject(raw.rejection) && typeof raw.rejection.reason === \"string\"\n        ? { reason: raw.rejection.reason, ...(typeof raw.rejection.message === \"string\" ? { message: raw.rejection.message } : {}) }\n        : null;\n      return { type: \"interaction\", modes: raw.modes as string[], tool, rejection };\n    }\n    case \"paused\":\n      return typeof raw.paused === \"boolean\" ? { type: \"paused\", paused: raw.paused } : undefined;\n    case \"pointer\":\n      return isFinite(raw.x) && isFinite(raw.y) ? { type: \"pointer\", x: raw.x, y: raw.y } : undefined;\n    case \"state\":\n      return isString(raw.key) && raw.value !== undefined && isJsonValue(raw.value) ? { type: \"state\", key: raw.key, value: raw.value as JsonValue } : undefined;\n    case \"error\":\n      return typeof raw.message === \"string\" ? { type: \"error\", message: raw.message.slice(0, 1000) } : undefined;\n    default:\n      return undefined;\n  }\n}\n\nexport function parseHandshake(raw: unknown): HandshakeMessage | undefined {\n  if (!isPlainObject(raw) || raw.source !== EDITOR_SOURCE || !isFinite(raw.version)) return undefined;\n  return raw.type === \"hello\" || raw.type === \"ready\" || raw.type === \"connect\" ? { source: EDITOR_SOURCE, type: raw.type, version: raw.version } : undefined;\n}\n\n/** What goes through the port. The map channel carries the authority protocol, tagged with the map. */\nexport type Envelope =\n  | { readonly ch: \"map\"; readonly map: string; readonly message: unknown }\n  | { readonly ch: \"control\"; readonly message: unknown }\n  | { readonly ch: \"event\"; readonly message: unknown };\n\nexport function parseEnvelope(raw: unknown): Envelope | undefined {\n  if (!isPlainObject(raw) || !isJsonValue(raw)) return undefined;\n  if (raw.ch === \"map\") return isString(raw.map) ? { ch: \"map\", map: raw.map, message: raw.message } : undefined;\n  if (raw.ch === \"control\" || raw.ch === \"event\") return { ch: raw.ch, message: raw.message };\n  return undefined;\n}\n\n/** What a `MessagePort` offers, so that tests and other carriers can stand in. */\nexport interface PortLike {\n  postMessage(message: unknown): void;\n  addEventListener(type: \"message\", listener: (event: { data: unknown }) => void): void;\n  start?(): void;\n  close(): void;\n}\n\n/** What a window offers to listen to messages. */\nexport interface WindowLike {\n  addEventListener(type: \"message\", listener: (event: MessageEventLike) => void): void;\n  removeEventListener(type: \"message\", listener: (event: MessageEventLike) => void): void;\n}\n\nexport interface MessageEventLike {\n  readonly data: unknown;\n  readonly origin: string;\n  readonly source: unknown;\n  readonly ports?: readonly PortLike[];\n}\n\n/** Something a message can be posted to: a frame's window, or `window.parent`. */\nexport interface TargetLike {\n  postMessage(message: unknown, targetOrigin: string, transfer?: Transferable[]): void;\n}\n"],"mappings":"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"}

package/dist/features/index.d.ts

@@ -0,0 +1,66 @@
+import { Unsubscribe, ApplyResult, MaybePromise } from '../model/result';
+import { Catalog, CatalogId } from '../interaction/catalog';
+import { TargetRef } from '../interaction/picking';
+import { PlacementApi, PlacementOptions } from '../interaction/placement';
+import { PipelineStep } from '../interaction/pipeline';
+import { SelectionToolOptions } from '../interaction/selection-tool';
+import { MapFeature } from '../renderer/feature';
+import { Skin } from '../skins/types';
+import { MapHistory } from '../model/history';
+export { defineMapFeature, MapFeatureError, type FeatureApis, type FeatureHost, type FeatureInstance, type FeatureRender, type MapFeature, type MapFeatureDefinition, } from '../renderer/feature';
+export { mountSkinLayers } from './skin';
+export declare const ELEMENTS_FEATURE_ID = "elements";
+export declare const EVENTS_FEATURE_ID = "events";
+export declare const SELECTION_FEATURE_ID = "selection";
+export declare const PLACEMENT_FEATURE_ID = "placement";
+export declare const HISTORY_FEATURE_ID = "history";
+export interface ElementsOptions {
+    /**
+     * Make elements editable through `view.submit`: registers the `element.move` and
+     * `element.remove` intents. Editing tools (`selection()`) do it on their own.
+     */
+    readonly edit?: boolean;
+    /** Rules every move and every removal goes through, whoever asks: a tool, `view.submit`, a game. */
+    readonly pipeline?: {
+        readonly move?: readonly PipelineStep<"element.move">[];
+        readonly remove?: readonly PipelineStep<"element.remove">[];
+    };
+}
+/** Draws the elements of the map: trees, houses, anything placed. */
+export declare function elements(options?: ElementsOptions): MapFeature<"elements">;
+/** Draws the events that have a graphic. Events without one are invisible in the map. */
+export declare function events(): MapFeature<"events">;
+export interface SelectionApi {
+    /** What is selected, in the order it was selected. */
+    readonly current: readonly TargetRef[];
+    /** What is under the pointer. */
+    readonly hovered: TargetRef | null;
+    select(targets: TargetRef | readonly TargetRef[], options?: {
+        readonly additive?: boolean;
+    }): void;
+    clear(): void;
+    has(target: TargetRef): boolean;
+    /** Called when the selection or the hover changes. Plugs into Angular signals, Vue, React… */
+    subscribe(listener: (selection: readonly TargetRef[]) => void): Unsubscribe;
+}
+export interface SelectionFeatureOptions extends SelectionToolOptions {
+    /** Replaces parts of the default skin: `{ selection: myGlow }`. */
+    readonly skin?: Skin;
+}
+/** Hover, selection, rubber band, dragging and deleting. Needs the elements feature. */
+export declare function selection(options?: SelectionFeatureOptions): MapFeature<"selection", SelectionApi>;
+export interface PlacementFeatureOptions<C extends Catalog<string>> extends PlacementOptions<C> {
+    /** Replaces parts of the default skin: `{ ghost: myGhost }`. */
+    readonly skin?: Skin;
+}
+/** Placing things of a catalog, with a ghost that previews the rules. Needs the elements feature. */
+export declare function placement<const C extends Catalog<string>>(options: PlacementFeatureOptions<C>): MapFeature<"placement", PlacementApi<CatalogId<C>>>;
+/**
+ * Undo and redo of the model, on the view: `view.history.undo()`.
+ *
+ * The feature cannot know whether the model answers at once or later, so results are
+ * typed `MaybePromise<ApplyResult>`. With a local committer, say so: `history<ApplyResult>()`.
+ */
+export declare function history<R extends MaybePromise<ApplyResult> = MaybePromise<ApplyResult>>(): MapFeature<"history", MapHistory<R>>;
+export { terrain, canvasSurface, decodeRaster, memorySurface, TERRAIN_FEATURE_ID, type TerrainApi, type TerrainOptions, type TerrainSurface, type TerrainSurfaceFactory, } from './terrain';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACrG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGjE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAC9C,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAC1C,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAChD,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAChD,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;QACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,CAAC,gBAAgB,CAAC,EAAE,CAAC;KAC7D,CAAC;CACH;AAED,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,UAAU,CAAC,UAAU,CAAC,CAoC9E;AAED,yFAAyF;AACzF,wBAAgB,MAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,CAuB7C;AAED,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IACnC,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACnG,KAAK,IAAI,IAAI,CAAC;IACd,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAChC,8FAA8F;IAC9F,SAAS,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,KAAK,IAAI,GAAG,WAAW,CAAC;CAC7E;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;CACtB;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,OAAO,GAAE,uBAA4B,GAAG,UAAU,CAAC,WAAW,EAAE,YAAY,CAAC,CA6CtG;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IAC7F,gEAAgE;IAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;CACtB;AAED,qGAAqG;AACrG,wBAAgB,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EACvD,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAClC,UAAU,CAAC,WAAW,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAiBrD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,YAAY,CAAC,WAAW,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,KAAK,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAS/H;AAED,OAAO,EACL,OAAO,EACP,aAAa,EACb,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC"}

package/dist/features/index.js

@@ -0,0 +1,157 @@
+import { describeElement, describeEvent } from "../renderer/scene.js";
+import { MapFeatureError, defineMapFeature } from "../renderer/feature.js";
+import { sameTarget } from "../interaction/picking.js";
+import { registerElementIntents } from "../interaction/builtin-intents.js";
+import { createPlacement } from "../interaction/placement.js";
+import { selectionTool } from "../interaction/selection-tool.js";
+import { defaultSkin } from "../skins/default.js";
+import { mergeSkin } from "../skins/types.js";
+import { mountSkinLayers } from "./skin.js";
+import { TERRAIN_FEATURE_ID, canvasSurface, decodeRaster, memorySurface, terrain } from "./terrain.js";
+//#region src/features/index.ts
+var ELEMENTS_FEATURE_ID = "elements";
+var EVENTS_FEATURE_ID = "events";
+var SELECTION_FEATURE_ID = "selection";
+var PLACEMENT_FEATURE_ID = "placement";
+var HISTORY_FEATURE_ID = "history";
+/** Draws the elements of the map: trees, houses, anything placed. */
+function elements(options = {}) {
+	return defineMapFeature({
+		id: ELEMENTS_FEATURE_ID,
+		render: {
+			stage: "objects",
+			describeAll: (state, context) => state.elements.flatMap((element) => describeElement(element, context) ?? []),
+			describeOne(state, id, context) {
+				const element = state.elements.find((entry) => entry.id === id);
+				return element ? describeElement(element, context) : void 0;
+			},
+			affected(patch) {
+				switch (patch.type) {
+					case "element.add": return [patch.element.id];
+					case "element.remove":
+					case "element.move":
+					case "element.update":
+					case "element.data": return [patch.id];
+					default: return "none";
+				}
+			}
+		},
+		...options.edit === true || options.pipeline !== void 0 ? { setup(host) {
+			const stops = [registerElementIntents(host.interaction)];
+			if (options.pipeline?.move) stops.push(host.interaction.usePipeline("element.move", options.pipeline.move));
+			if (options.pipeline?.remove) stops.push(host.interaction.usePipeline("element.remove", options.pipeline.remove));
+			return { dispose: () => stops.forEach((stop) => stop()) };
+		} } : {}
+	});
+}
+/** Draws the events that have a graphic. Events without one are invisible in the map. */
+function events() {
+	return defineMapFeature({
+		id: EVENTS_FEATURE_ID,
+		render: {
+			stage: "objects",
+			describeAll: (state, context) => state.events.flatMap((event) => describeEvent(event, context) ?? []),
+			describeOne(state, id, context) {
+				const event = state.events.find((entry) => entry.id === id);
+				return event ? describeEvent(event, context) : void 0;
+			},
+			affected(patch) {
+				switch (patch.type) {
+					case "event.add": return [patch.event.id];
+					case "event.remove":
+					case "event.move": return [patch.id];
+					default: return "none";
+				}
+			}
+		}
+	});
+}
+/** Hover, selection, rubber band, dragging and deleting. Needs the elements feature. */
+function selection(options = {}) {
+	const { skin, ...toolOptions } = options;
+	return defineMapFeature({
+		id: SELECTION_FEATURE_ID,
+		requires: [ELEMENTS_FEATURE_ID],
+		setup(host) {
+			const controller = host.interaction;
+			const stops = [
+				registerElementIntents(controller),
+				controller.addTool(selectionTool(toolOptions)),
+				mountSkinLayers(host, (() => {
+					const look = mergeSkin(defaultSkin(), skin);
+					return [
+						look.selection,
+						look.hover,
+						look.drag,
+						look.marquee
+					];
+				})())
+			];
+			return {
+				api: {
+					get current() {
+						return controller.state.get().selection;
+					},
+					get hovered() {
+						return controller.state.get().hovered;
+					},
+					select(targets, selectOptions) {
+						const list = Array.isArray(targets) ? targets : [targets];
+						const next = [...selectOptions?.additive ? controller.state.get().selection : []];
+						for (const target of list) if (!next.some((other) => sameTarget(other, target))) next.push(target);
+						controller.state.update({ selection: next });
+					},
+					clear: () => controller.state.update({ selection: [] }),
+					has: (target) => controller.state.get().selection.some((other) => sameTarget(other, target)),
+					subscribe(listener) {
+						let last = controller.state.get();
+						return controller.state.subscribe((state) => {
+							if (state.selection !== last.selection || state.hovered !== last.hovered) listener(state.selection);
+							last = state;
+						});
+					}
+				},
+				dispose: () => stops.forEach((stop) => stop())
+			};
+		}
+	});
+}
+/** Placing things of a catalog, with a ghost that previews the rules. Needs the elements feature. */
+function placement(options) {
+	const { skin, ...placementOptions } = options;
+	return defineMapFeature({
+		id: PLACEMENT_FEATURE_ID,
+		requires: [ELEMENTS_FEATURE_ID],
+		setup(host) {
+			const placed = createPlacement(host.interaction, placementOptions);
+			const unmount = mountSkinLayers(host, [mergeSkin(defaultSkin(), skin).ghost]);
+			return {
+				api: placed.api,
+				dispose() {
+					unmount();
+					placed.dispose();
+				}
+			};
+		}
+	});
+}
+/**
+* Undo and redo of the model, on the view: `view.history.undo()`.
+*
+* The feature cannot know whether the model answers at once or later, so results are
+* typed `MaybePromise<ApplyResult>`. With a local committer, say so: `history<ApplyResult>()`.
+*/
+function history() {
+	return defineMapFeature({
+		id: HISTORY_FEATURE_ID,
+		setup(host) {
+			const model = host.model;
+			if (!model.history) throw new Error("The history feature needs a model that has a history");
+			return { api: model.history };
+		}
+	});
+}
+//#endregion
+export { ELEMENTS_FEATURE_ID, EVENTS_FEATURE_ID, HISTORY_FEATURE_ID, MapFeatureError, PLACEMENT_FEATURE_ID, SELECTION_FEATURE_ID, TERRAIN_FEATURE_ID, canvasSurface, decodeRaster, defineMapFeature, elements, events, history, memorySurface, mountSkinLayers, placement, selection, terrain };
+
+//# sourceMappingURL=index.js.map

package/dist/features/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/features/index.ts"],"sourcesContent":["import type { Unsubscribe } from \"../model/result\";\nimport { registerElementIntents } from \"../interaction/builtin-intents\";\nimport type { Catalog, CatalogId } from \"../interaction/catalog\";\nimport type { InteractionController } from \"../interaction/controller\";\nimport type { TargetRef } from \"../interaction/picking\";\nimport { sameTarget } from \"../interaction/picking\";\nimport { createPlacement, type PlacementApi, type PlacementOptions } from \"../interaction/placement\";\nimport type { PipelineStep } from \"../interaction/pipeline\";\nimport { selectionTool, type SelectionToolOptions } from \"../interaction/selection-tool\";\nimport { defineMapFeature, type MapFeature } from \"../renderer/feature\";\nimport { describeElement, describeEvent } from \"../renderer/scene\";\nimport { defaultSkin } from \"../skins/default\";\nimport { mergeSkin, type Skin } from \"../skins/types\";\nimport type { MapHistory } from \"../model/history\";\nimport type { ApplyResult, MaybePromise } from \"../model/result\";\nimport { mountSkinLayers } from \"./skin\";\n\nexport {\n  defineMapFeature,\n  MapFeatureError,\n  type FeatureApis,\n  type FeatureHost,\n  type FeatureInstance,\n  type FeatureRender,\n  type MapFeature,\n  type MapFeatureDefinition,\n} from \"../renderer/feature\";\nexport { mountSkinLayers } from \"./skin\";\n\nexport const ELEMENTS_FEATURE_ID = \"elements\";\nexport const EVENTS_FEATURE_ID = \"events\";\nexport const SELECTION_FEATURE_ID = \"selection\";\nexport const PLACEMENT_FEATURE_ID = \"placement\";\nexport const HISTORY_FEATURE_ID = \"history\";\n\nexport interface ElementsOptions {\n  /**\n   * Make elements editable through `view.submit`: registers the `element.move` and\n   * `element.remove` intents. Editing tools (`selection()`) do it on their own.\n   */\n  readonly edit?: boolean;\n  /** Rules every move and every removal goes through, whoever asks: a tool, `view.submit`, a game. */\n  readonly pipeline?: {\n    readonly move?: readonly PipelineStep<\"element.move\">[];\n    readonly remove?: readonly PipelineStep<\"element.remove\">[];\n  };\n}\n\n/** Draws the elements of the map: trees, houses, anything placed. */\nexport function elements(options: ElementsOptions = {}): MapFeature<\"elements\"> {\n  const editable = options.edit === true || options.pipeline !== undefined;\n  return defineMapFeature({\n    id: ELEMENTS_FEATURE_ID,\n    render: {\n      stage: \"objects\",\n      describeAll: (state, context) => state.elements.flatMap((element) => describeElement(element, context) ?? []),\n      describeOne(state, id, context) {\n        const element = state.elements.find((entry) => entry.id === id);\n        return element ? describeElement(element, context) : undefined;\n      },\n      affected(patch) {\n        switch (patch.type) {\n          case \"element.add\":\n            return [patch.element.id];\n          case \"element.remove\":\n          case \"element.move\":\n          case \"element.update\":\n          case \"element.data\":\n            return [patch.id];\n          default:\n            return \"none\";\n        }\n      },\n    },\n    ...(editable\n      ? {\n          setup(host) {\n            const stops: Unsubscribe[] = [registerElementIntents(host.interaction as unknown as InteractionController)];\n            if (options.pipeline?.move) stops.push(host.interaction.usePipeline(\"element.move\", options.pipeline.move));\n            if (options.pipeline?.remove) stops.push(host.interaction.usePipeline(\"element.remove\", options.pipeline.remove));\n            return { dispose: () => stops.forEach((stop) => stop()) };\n          },\n        }\n      : {}),\n  });\n}\n\n/** Draws the events that have a graphic. Events without one are invisible in the map. */\nexport function events(): MapFeature<\"events\"> {\n  return defineMapFeature({\n    id: EVENTS_FEATURE_ID,\n    render: {\n      stage: \"objects\",\n      describeAll: (state, context) => state.events.flatMap((event) => describeEvent(event, context) ?? []),\n      describeOne(state, id, context) {\n        const event = state.events.find((entry) => entry.id === id);\n        return event ? describeEvent(event, context) : undefined;\n      },\n      affected(patch) {\n        switch (patch.type) {\n          case \"event.add\":\n            return [patch.event.id];\n          case \"event.remove\":\n          case \"event.move\":\n            return [patch.id];\n          default:\n            return \"none\";\n        }\n      },\n    },\n  });\n}\n\nexport interface SelectionApi {\n  /** What is selected, in the order it was selected. */\n  readonly current: readonly TargetRef[];\n  /** What is under the pointer. */\n  readonly hovered: TargetRef | null;\n  select(targets: TargetRef | readonly TargetRef[], options?: { readonly additive?: boolean }): void;\n  clear(): void;\n  has(target: TargetRef): boolean;\n  /** Called when the selection or the hover changes. Plugs into Angular signals, Vue, React… */\n  subscribe(listener: (selection: readonly TargetRef[]) => void): Unsubscribe;\n}\n\nexport interface SelectionFeatureOptions extends SelectionToolOptions {\n  /** Replaces parts of the default skin: `{ selection: myGlow }`. */\n  readonly skin?: Skin;\n}\n\n/** Hover, selection, rubber band, dragging and deleting. Needs the elements feature. */\nexport function selection(options: SelectionFeatureOptions = {}): MapFeature<\"selection\", SelectionApi> {\n  const { skin, ...toolOptions } = options;\n  return defineMapFeature({\n    id: SELECTION_FEATURE_ID,\n    requires: [ELEMENTS_FEATURE_ID],\n    setup(host) {\n      const controller = host.interaction;\n      const stops: Unsubscribe[] = [\n        registerElementIntents(controller as unknown as InteractionController),\n        controller.addTool(selectionTool(toolOptions)),\n        mountSkinLayers(\n          host,\n          (() => {\n            const look = mergeSkin(defaultSkin(), skin);\n            return [look.selection, look.hover, look.drag, look.marquee];\n          })(),\n        ),\n      ];\n      const api: SelectionApi = {\n        get current() {\n          return controller.state.get().selection;\n        },\n        get hovered() {\n          return controller.state.get().hovered;\n        },\n        select(targets, selectOptions) {\n          const list = Array.isArray(targets) ? (targets as readonly TargetRef[]) : [targets as TargetRef];\n          const base = selectOptions?.additive ? controller.state.get().selection : [];\n          const next = [...base];\n          for (const target of list) if (!next.some((other) => sameTarget(other, target))) next.push(target);\n          controller.state.update({ selection: next });\n        },\n        clear: () => controller.state.update({ selection: [] }),\n        has: (target) => controller.state.get().selection.some((other) => sameTarget(other, target)),\n        subscribe(listener) {\n          let last = controller.state.get();\n          return controller.state.subscribe((state) => {\n            if (state.selection !== last.selection || state.hovered !== last.hovered) listener(state.selection);\n            last = state;\n          });\n        },\n      };\n      return { api, dispose: () => stops.forEach((stop) => stop()) };\n    },\n  });\n}\n\nexport interface PlacementFeatureOptions<C extends Catalog<string>> extends PlacementOptions<C> {\n  /** Replaces parts of the default skin: `{ ghost: myGhost }`. */\n  readonly skin?: Skin;\n}\n\n/** Placing things of a catalog, with a ghost that previews the rules. Needs the elements feature. */\nexport function placement<const C extends Catalog<string>>(\n  options: PlacementFeatureOptions<C>,\n): MapFeature<\"placement\", PlacementApi<CatalogId<C>>> {\n  const { skin, ...placementOptions } = options;\n  return defineMapFeature({\n    id: PLACEMENT_FEATURE_ID,\n    requires: [ELEMENTS_FEATURE_ID],\n    setup(host) {\n      const placed = createPlacement(host.interaction as never, placementOptions);\n      const unmount = mountSkinLayers(host, [mergeSkin(defaultSkin(), skin).ghost]);\n      return {\n        api: placed.api,\n        dispose() {\n          unmount();\n          placed.dispose();\n        },\n      };\n    },\n  });\n}\n\n/**\n * Undo and redo of the model, on the view: `view.history.undo()`.\n *\n * The feature cannot know whether the model answers at once or later, so results are\n * typed `MaybePromise<ApplyResult>`. With a local committer, say so: `history<ApplyResult>()`.\n */\nexport function history<R extends MaybePromise<ApplyResult> = MaybePromise<ApplyResult>>(): MapFeature<\"history\", MapHistory<R>> {\n  return defineMapFeature({\n    id: HISTORY_FEATURE_ID,\n    setup(host) {\n      const model = host.model;\n      if (!model.history) throw new Error(\"The history feature needs a model that has a history\");\n      return { api: model.history as unknown as MapHistory<R> };\n    },\n  });\n}\n\nexport {\n  terrain,\n  canvasSurface,\n  decodeRaster,\n  memorySurface,\n  TERRAIN_FEATURE_ID,\n  type TerrainApi,\n  type TerrainOptions,\n  type TerrainSurface,\n  type TerrainSurfaceFactory,\n} from \"./terrain\";\n"],"mappings":"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"}

package/dist/features/skin.d.ts

@@ -0,0 +1,9 @@
+import { FeatureHost } from '../renderer/feature';
+import { SkinLayerFactory } from '../skins/types';
+/**
+ * Puts skin layers in the overlay stage and keeps them up to date: they redraw when
+ * the interaction state changes, when the map changes, and animate on each tick.
+ * Returns the function that removes them.
+ */
+export declare function mountSkinLayers(host: FeatureHost, factories: ReadonlyArray<SkinLayerFactory | undefined>): () => void;
+//# sourceMappingURL=skin.d.ts.map

package/dist/features/skin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skin.d.ts","sourceRoot":"","sources":["../../src/features/skin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,gBAAgB,GAAG,SAAS,CAAC,GAAG,MAAM,IAAI,CA6BrH"}

package/dist/features/skin.js

@@ -0,0 +1,43 @@
+import { Container } from "pixi.js";
+//#region src/features/skin.ts
+/**
+* Puts skin layers in the overlay stage and keeps them up to date: they redraw when
+* the interaction state changes, when the map changes, and animate on each tick.
+* Returns the function that removes them.
+*/
+function mountSkinLayers(host, factories) {
+	const containers = [];
+	const layers = [];
+	const refresh = () => {
+		const snapshot = host.interaction.state.get();
+		for (const layer of layers) layer.update(snapshot);
+	};
+	for (const factory of factories) {
+		if (!factory) continue;
+		const container = new Container();
+		host.stages.overlay.addChild(container);
+		containers.push(container);
+		layers.push(factory({
+			layer: container,
+			textures: host.textures,
+			assets: host.assets,
+			nodes: host.describe,
+			requestUpdate: refresh
+		}));
+	}
+	const stops = [
+		host.interaction.state.subscribe(refresh),
+		host.model.subscribe(refresh),
+		host.onTick((deltaMs) => layers.forEach((layer) => layer.tick?.(deltaMs)))
+	];
+	refresh();
+	return () => {
+		stops.forEach((stop) => stop());
+		layers.forEach((layer) => layer.destroy());
+		containers.forEach((container) => container.destroy({ children: true }));
+	};
+}
+//#endregion
+export { mountSkinLayers };
+
+//# sourceMappingURL=skin.js.map

package/dist/features/skin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skin.js","names":[],"sources":["../../src/features/skin.ts"],"sourcesContent":["import { Container } from \"pixi.js\";\nimport type { FeatureHost } from \"../renderer/feature\";\nimport type { SkinLayer, SkinLayerFactory } from \"../skins/types\";\n\n/**\n * Puts skin layers in the overlay stage and keeps them up to date: they redraw when\n * the interaction state changes, when the map changes, and animate on each tick.\n * Returns the function that removes them.\n */\nexport function mountSkinLayers(host: FeatureHost, factories: ReadonlyArray<SkinLayerFactory | undefined>): () => void {\n  const containers: Container[] = [];\n  const layers: SkinLayer[] = [];\n  const refresh = (): void => {\n    const snapshot = host.interaction.state.get();\n    for (const layer of layers) layer.update(snapshot);\n  };\n\n  for (const factory of factories) {\n    if (!factory) continue;\n    const container = new Container();\n    host.stages.overlay.addChild(container);\n    containers.push(container);\n    layers.push(factory({ layer: container, textures: host.textures, assets: host.assets, nodes: host.describe, requestUpdate: refresh }));\n  }\n\n  const stops = [\n    host.interaction.state.subscribe(refresh),\n    // The view subscribed to the model before any feature, so the scene is already up to date here.\n    host.model.subscribe(refresh),\n    host.onTick((deltaMs) => layers.forEach((layer) => layer.tick?.(deltaMs))),\n  ];\n  refresh();\n\n  return () => {\n    stops.forEach((stop) => stop());\n    layers.forEach((layer) => layer.destroy());\n    containers.forEach((container) => container.destroy({ children: true }));\n  };\n}\n"],"mappings":";;;;;;;AASA,SAAgB,gBAAgB,MAAmB,WAAoE;CACrH,MAAM,aAA0B,CAAC;CACjC,MAAM,SAAsB,CAAC;CAC7B,MAAM,gBAAsB;EAC1B,MAAM,WAAW,KAAK,YAAY,MAAM,IAAI;EAC5C,KAAK,MAAM,SAAS,QAAQ,MAAM,OAAO,QAAQ;CACnD;CAEA,KAAK,MAAM,WAAW,WAAW;EAC/B,IAAI,CAAC,SAAS;EACd,MAAM,YAAY,IAAI,UAAU;EAChC,KAAK,OAAO,QAAQ,SAAS,SAAS;EACtC,WAAW,KAAK,SAAS;EACzB,OAAO,KAAK,QAAQ;GAAE,OAAO;GAAW,UAAU,KAAK;GAAU,QAAQ,KAAK;GAAQ,OAAO,KAAK;GAAU,eAAe;EAAQ,CAAC,CAAC;CACvI;CAEA,MAAM,QAAQ;EACZ,KAAK,YAAY,MAAM,UAAU,OAAO;EAExC,KAAK,MAAM,UAAU,OAAO;EAC5B,KAAK,QAAQ,YAAY,OAAO,SAAS,UAAU,MAAM,OAAO,OAAO,CAAC,CAAC;CAC3E;CACA,QAAQ;CAER,aAAa;EACX,MAAM,SAAS,SAAS,KAAK,CAAC;EAC9B,OAAO,SAAS,UAAU,MAAM,QAAQ,CAAC;EACzC,WAAW,SAAS,cAAc,UAAU,QAAQ,EAAE,UAAU,KAAK,CAAC,CAAC;CACzE;AACF"}

package/dist/features/terrain.d.ts

@@ -0,0 +1,66 @@
+import { Texture } from 'pixi.js';
+import { RasterImage } from '@rpgjs/render-map2d';
+import { PipelineStep } from '../interaction/pipeline';
+import { MapFeature } from '../renderer/feature';
+import { TerrainBackend } from '../terrain-render/backend';
+import { readTerrain } from '../terrain/data';
+import { BrushApi } from '../terrain/editing';
+export declare const TERRAIN_FEATURE_ID = "terrain";
+/** One chunk of the terrain as pixels: a texture, and a way to write into it. */
+export interface TerrainSurface {
+    readonly texture: Texture;
+    /** Writes RGBA pixels at `(x, y)` inside the surface, then makes the change visible. */
+    put(x: number, y: number, width: number, height: number, pixels: Uint8ClampedArray): void;
+    destroy(): void;
+}
+export type TerrainSurfaceFactory = (width: number, height: number) => TerrainSurface;
+export interface TerrainOptions {
+    /**
+     * Where the kernel runs. Defaults to the calling thread, which is fine for small maps and tests.
+     * For live painting use `workerTerrainBackend` from `@rpgjs/map-builder/terrain-render`.
+     */
+    readonly backend?: TerrainBackend | (() => TerrainBackend | Promise<TerrainBackend>);
+    /** Decodes an image into pixels. Defaults to the browser (`createImageBitmap`). */
+    readonly loadImage?: (src: string) => Promise<RasterImage>;
+    /** Side of the squares the terrain is rendered in. Defaults to 512. */
+    readonly chunk?: number;
+    /** How chunk textures are made. Defaults to canvases; replaceable for tests. */
+    readonly surface?: TerrainSurfaceFactory;
+    /** Receives non-fatal problems (an image that did not load, a render that failed). Defaults to `console.warn`. */
+    readonly onError?: (error: unknown) => void;
+    /**
+     * Make the terrain editable: registers the `terrain.paint` intent and the brush (`view.terrain.brush`).
+     * Passing `pipeline` also turns it on.
+     */
+    readonly edit?: boolean;
+    /** Rules every painting goes through, whoever asks: the brush, `view.submit`, a game. */
+    readonly pipeline?: readonly PipelineStep<"terrain.paint">[];
+    /** Modes in which the brush is active. Defaults to `["edit"]`. */
+    readonly brushModes?: readonly string[];
+}
+export interface TerrainApi {
+    /** Resolves when everything that was asked to be (re)rendered has been. */
+    whenIdle(): Promise<void>;
+    /** Chunks waiting or being rendered. */
+    readonly pending: number;
+    /** The backend in use, once there is one. */
+    readonly backend: TerrainBackend | undefined;
+    /** The brush, when the terrain is editable (`terrain({ edit: true })`). */
+    readonly brush: BrushApi | undefined;
+}
+/** Pixels of an image, decoded in the browser. */
+export declare function decodeRaster(src: string): Promise<RasterImage>;
+/** Surfaces backed by canvases (nearest filtering, 1:1: the pixels are what the kernel produced). */
+export declare const canvasSurface: TerrainSurfaceFactory;
+/** Surfaces that only keep their pixels in memory: for tests and tools that read them back. */
+export declare function memorySurface(): TerrainSurfaceFactory & {
+    pixelsOf(texture: Texture): Uint8ClampedArray | undefined;
+};
+/**
+ * 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.
+ */
+export declare function terrain(options?: TerrainOptions): MapFeature<"terrain", TerrainApi>;
+export { readTerrain };
+//# sourceMappingURL=terrain.d.ts.map

package/dist/features/terrain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain.d.ts","sourceRoot":"","sources":["../../src/features/terrain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,OAAO,EAAiB,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAkB,MAAM,iBAAiB,CAAC;AAI9D,OAAO,EAAwC,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGzF,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,wFAAwF;IACxF,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1F,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,cAAc,CAAC;AAEtF,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IACrF,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3D,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IACzC,kHAAkH;IAClH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,CAAC,eAAe,CAAC,EAAE,CAAC;IAC7D,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC;IAC7C,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;CACtC;AAED,kDAAkD;AAClD,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAUpE;AAED,qGAAqG;AACrG,eAAO,MAAM,aAAa,EAAE,qBAe3B,CAAC;AAEF,+FAA+F;AAC/F,wBAAgB,aAAa,IAAI,qBAAqB,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAAA;CAAE,CAerH;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAyNvF;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}