@rpgjs/map-builder 0.0.0-stage → 5.0.0

package/dist/interaction/controller.d.ts

@@ -0,0 +1,137 @@
+import { AssetResolver } from '../model/assets';
+import { MapState } from '../model/definition';
+import { MapHistory } from '../model/history';
+import { MapChange } from '../model/model';
+import { MapPatch } from '../model/patches';
+import { ApplyFailure, ApplyResult, MaybePromise, Unsubscribe } from '../model/result';
+import { Rect } from '../renderer/geometry';
+import { DescribeContext, SceneNode } from '../renderer/scene';
+import { IntentDefinition, IntentOf, IntentType, MapIntent, Rejection } from './intents';
+import { KeyInput, PointerInput } from './input';
+import { PickOptions, Point, TargetRef } from './picking';
+import { PipelineResult, PipelineStep } from './pipeline';
+import { Store } from './store';
+export interface DragState {
+    readonly targets: readonly TargetRef[];
+    readonly origin: Point;
+    readonly delta: Point;
+    /** False when the pipeline refuses where the targets would land. */
+    readonly valid: boolean;
+    readonly reason?: string;
+    /** True when the model follows the pointer while dragging, false when it changes only on drop. */
+    readonly live: boolean;
+}
+export interface GhostState {
+    readonly catalogId: string;
+    /** Asset drawn by the ghost. */
+    readonly kind: string;
+    /** Where it would be placed, after the pipeline (snapped…). */
+    readonly x: number;
+    readonly y: number;
+    readonly valid: boolean;
+    readonly reason?: string;
+    readonly bounds?: Rect;
+    readonly hitbox?: Rect;
+}
+/** Everything the interaction layer publishes. Skins and UIs read it; nothing here is drawn. */
+export interface InteractionSnapshot {
+    readonly modes: readonly string[];
+    readonly hovered: TargetRef | null;
+    readonly selection: readonly TargetRef[];
+    readonly drag: DragState | null;
+    /** Rubber-band rectangle of a selection in progress. */
+    readonly marquee: Rect | null;
+    /** Id of the catalog item being placed, once `placement.start` was called. */
+    readonly placing: string | null;
+    /** Where the item being placed would land. Absent until the pointer has moved. */
+    readonly ghost: GhostState | null;
+    /** The last intent that was refused, and why, so the UI can tell the user. */
+    readonly lastRejection: (Rejection & {
+        readonly intent: MapIntent;
+    }) | null;
+}
+/** The part of a model the interaction layer needs. Any `MapModel` fits. */
+export interface ModelApi<R extends MaybePromise<ApplyResult> = MaybePromise<ApplyResult>> {
+    readonly state: MapState;
+    subscribe(listener: (change: MapChange) => void): Unsubscribe;
+    apply(input: MapPatch | readonly MapPatch[], options?: {
+        readonly coalesce?: string;
+        readonly intents?: readonly unknown[];
+    }): R;
+    /** Used to take back a drag that applied its moves as it went. */
+    readonly history?: MapHistory<R>;
+}
+export interface Tool {
+    readonly id: string;
+    /** The tool is active while one of these modes is. */
+    readonly modes: readonly string[];
+    /** Tools with a higher priority see events first. Defaults to 0. */
+    readonly priority?: number;
+    /** Gate: the tool only reacts to events for which this is true, e.g. a modifier key. */
+    readonly when?: (input: PointerInput | KeyInput) => boolean;
+    /** Return `true` to take the event: the tool then also gets the moves and the release. */
+    pointerDown?(input: PointerInput, controller: InteractionController): boolean | void;
+    pointerMove?(input: PointerInput, controller: InteractionController): boolean | void;
+    pointerUp?(input: PointerInput, controller: InteractionController): void;
+    key?(input: KeyInput, controller: InteractionController): boolean | void;
+    /** The tool stops being active (mode change, `controller.cancel()`): drop what is in progress. */
+    cancel?(controller: InteractionController): void;
+}
+export interface SubmitOptions {
+    /** Consecutive submissions with the same key become one undo step. */
+    readonly coalesce?: string;
+}
+export interface PreviewOptions {
+    /** Targets to leave out of the obstacles, e.g. those being moved. */
+    readonly ignore?: readonly TargetRef[];
+}
+export interface InteractionController<R extends MaybePromise<ApplyResult> = MaybePromise<ApplyResult>> {
+    readonly state: Store<InteractionSnapshot>;
+    readonly model: ModelApi<R>;
+    readonly assets: AssetResolver;
+    readonly describeContext: DescribeContext;
+    readonly modes: readonly string[];
+    /** Replaces the active modes. Tools of a mode that is no longer active are cancelled. */
+    setModes(modes: readonly string[]): void;
+    readonly tools: readonly Tool[];
+    addTool(tool: Tool): Unsubscribe;
+    registerIntent<K extends IntentType>(type: K, definition: IntentDefinition<K>): Unsubscribe;
+    hasIntent(type: IntentType): boolean;
+    /** Adds steps to the chain an intent goes through. Steps run in the order they were added. */
+    usePipeline<K extends IntentType>(type: K, steps: readonly PipelineStep<K>[]): Unsubscribe;
+    /** Runs the pipeline only, without changing anything: what the ghost and the drag preview use. */
+    preview<K extends IntentType>(intent: IntentOf<K>, options?: PreviewOptions): PipelineResult<K>;
+    /**
+     * Turns intents into patches through the pipeline and applies them. Several
+     * intents are applied as one atomic batch. A refusal comes back as a failure
+     * whose `rejection.code` is the reason, and is kept in `state.lastRejection`.
+     */
+    submit(intent: MapIntent | readonly MapIntent[], options?: SubmitOptions): R | ApplyFailure;
+    /** What is drawn right now. */
+    nodes(): readonly SceneNode[];
+    pick(point: Point, options?: PickOptions): SceneNode | undefined;
+    pickAll(point: Point, options?: PickOptions): SceneNode[];
+    /** Last known pointer position in world coordinates. */
+    readonly pointer: Point | null;
+    feedPointer(kind: "down" | "move" | "up", input: PointerInput): boolean;
+    feedKey(input: KeyInput): boolean;
+    /** Cancels whatever is in progress: a drag, a placement. */
+    cancel(): void;
+    destroy(): void;
+}
+export interface InteractionOptions<R extends MaybePromise<ApplyResult>> {
+    readonly model: ModelApi<R>;
+    readonly assets: AssetResolver;
+    readonly describe: DescribeContext;
+    /** What is drawn right now. */
+    readonly nodes: () => readonly SceneNode[];
+    /** Who is acting, handed to the steps of the pipeline. */
+    readonly actor?: () => unknown;
+    /** Active modes at the start. Defaults to `["edit"]`. */
+    readonly modes?: readonly string[];
+    readonly onError?: (error: unknown) => void;
+}
+declare const unique: (targets: readonly TargetRef[]) => TargetRef[];
+export declare function createInteraction<R extends MaybePromise<ApplyResult>>(options: InteractionOptions<R>): InteractionController<R>;
+export { unique as uniqueTargets };
+//# sourceMappingURL=controller.d.ts.map

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

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

package/dist/interaction/controller.js

@@ -0,0 +1,215 @@
+import { pickNode, pickNodes, sameTarget, targetOf } from "./picking.js";
+import { runPipeline } from "./pipeline.js";
+import { createStore } from "./store.js";
+//#region src/interaction/controller.ts
+var unique = (targets) => targets.filter((target, index) => targets.findIndex((other) => sameTarget(other, target)) === index);
+var exists = (state, target) => (target.type === "element" ? state.elements : state.events).some((entry) => entry.id === target.id);
+function createInteraction(options) {
+	const reportError = options.onError ?? ((error) => console.error(error));
+	const store = createStore({
+		modes: [...options.modes ?? ["edit"]],
+		hovered: null,
+		selection: [],
+		drag: null,
+		marquee: null,
+		placing: null,
+		ghost: null,
+		lastRejection: null
+	}, reportError);
+	const tools = [];
+	const intents = /* @__PURE__ */ new Map();
+	const pipelines = /* @__PURE__ */ new Map();
+	let captured = null;
+	let lastPointer = null;
+	let destroyed = false;
+	const isActive = (tool) => tool.modes.some((mode) => store.get().modes.includes(mode));
+	const ordered = () => [...tools].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+	const intentContext = () => ({
+		state: options.model.state,
+		assets: options.assets,
+		describe: options.describe,
+		actor: options.actor?.()
+	});
+	const footprintOf = (intent) => intents.get(intent.type)?.footprint?.(intent, intentContext());
+	const pipelineContext = (nodes, preview) => ({
+		state: options.model.state,
+		assets: options.assets,
+		nodes,
+		scene: options.nodes(),
+		actor: options.actor?.(),
+		preview,
+		footprint: footprintOf,
+		reject: (reason, message) => ({
+			ok: false,
+			reason,
+			...message !== void 0 ? { message } : {}
+		})
+	});
+	const refuse = (rejection, intent, patchIndex) => {
+		store.update({ lastRejection: {
+			...rejection,
+			intent
+		} });
+		return {
+			ok: false,
+			rejection: {
+				code: rejection.reason,
+				message: rejection.message ?? rejection.reason,
+				...patchIndex !== void 0 ? { patchIndex } : {}
+			}
+		};
+	};
+	const stepsFor = (type) => pipelines.get(type) ?? [];
+	const controller = {
+		state: store,
+		model: options.model,
+		assets: options.assets,
+		describeContext: options.describe,
+		get modes() {
+			return store.get().modes;
+		},
+		setModes(modes) {
+			const next = [...new Set(modes)];
+			const before = store.get().modes;
+			if (next.length === before.length && next.every((mode, index) => mode === before[index])) return;
+			store.update({ modes: next });
+			for (const tool of tools) if (!isActive(tool)) {
+				if (captured === tool) captured = null;
+				tool.cancel?.(controller);
+			}
+		},
+		get tools() {
+			return tools;
+		},
+		addTool(tool) {
+			if (tools.some((other) => other.id === tool.id)) throw new Error(`A tool with the id "${tool.id}" already exists`);
+			tools.push(tool);
+			return () => {
+				const index = tools.indexOf(tool);
+				if (index >= 0) tools.splice(index, 1);
+				if (captured === tool) captured = null;
+				tool.cancel?.(controller);
+			};
+		},
+		registerIntent(type, definition) {
+			if (intents.has(type)) throw new Error(`Intent "${type}" is already registered`);
+			intents.set(type, definition);
+			return () => intents.delete(type);
+		},
+		hasIntent: (type) => intents.has(type),
+		usePipeline(type, steps) {
+			const list = pipelines.get(type) ?? [];
+			list.push(...steps);
+			pipelines.set(type, list);
+			return () => {
+				const current = pipelines.get(type);
+				if (!current) return;
+				pipelines.set(type, current.filter((step) => !steps.includes(step)));
+			};
+		},
+		preview(intent, previewOptions = {}) {
+			const ignore = previewOptions.ignore ?? [];
+			const nodes = options.nodes().filter((node) => !ignore.some((target) => sameTarget(target, targetOf(node))));
+			return runPipeline(stepsFor(intent.type), intent, pipelineContext(nodes, true));
+		},
+		submit(input, submitOptions) {
+			const list = Array.isArray(input) ? input : [input];
+			const leaving = list.flatMap((intent) => intent.type === "element.move" || intent.type === "element.remove" ? [{
+				type: "element",
+				id: intent.id
+			}] : []);
+			const nodes = options.nodes().filter((node) => !leaving.some((target) => sameTarget(target, targetOf(node))));
+			const context = pipelineContext(nodes, false);
+			const patches = [];
+			for (const [index, intent] of list.entries()) {
+				const definition = intents.get(intent.type);
+				if (!definition) return refuse({
+					ok: false,
+					reason: "unknown-intent",
+					message: `No intent "${intent.type}"`
+				}, intent, index);
+				const result = runPipeline(stepsFor(intent.type), intent, context);
+				if (!result.ok) return refuse(result, intent, index);
+				const resolved = definition.resolve(result.intent, intentContext());
+				if (typeof resolved === "object" && resolved !== null && "ok" in resolved && resolved.ok === false) return refuse(resolved, intent, index);
+				patches.push(...Array.isArray(resolved) ? resolved : [resolved]);
+			}
+			store.update({ lastRejection: null });
+			return options.model.apply(patches.length === 1 ? patches[0] : patches, {
+				...submitOptions,
+				intents: list
+			});
+		},
+		nodes: () => options.nodes(),
+		pick: (point, pickOptions) => pickNode(options.nodes(), point, pickOptions),
+		pickAll: (point, pickOptions) => pickNodes(options.nodes(), point, pickOptions),
+		get pointer() {
+			return lastPointer;
+		},
+		feedPointer(kind, input) {
+			if (destroyed) return false;
+			lastPointer = {
+				x: input.x,
+				y: input.y
+			};
+			const run = (tool) => {
+				if (tool.when && !tool.when(input)) return false;
+				return kind === "down" ? tool.pointerDown?.(input, controller) : kind === "move" ? tool.pointerMove?.(input, controller) : void 0;
+			};
+			if (kind === "up") {
+				const tool = captured;
+				captured = null;
+				tool?.pointerUp?.(input, controller);
+				return tool !== null;
+			}
+			if (captured && kind === "move") {
+				captured.pointerMove?.(input, controller);
+				return true;
+			}
+			for (const tool of ordered()) {
+				if (!isActive(tool)) continue;
+				if (run(tool) === true) {
+					if (kind === "down") captured = tool;
+					return true;
+				}
+			}
+			return false;
+		},
+		feedKey(input) {
+			if (destroyed) return false;
+			for (const tool of ordered()) {
+				if (!isActive(tool) || tool.when && !tool.when(input)) continue;
+				if (tool.key?.(input, controller) === true) return true;
+			}
+			return false;
+		},
+		cancel() {
+			captured = null;
+			for (const tool of tools) tool.cancel?.(controller);
+		},
+		destroy() {
+			if (destroyed) return;
+			destroyed = true;
+			unsubscribe();
+			controller.cancel();
+			tools.length = 0;
+			intents.clear();
+			pipelines.clear();
+		}
+	};
+	const unsubscribe = options.model.subscribe(() => {
+		const snapshot = store.get();
+		const state = options.model.state;
+		const selection = snapshot.selection.filter((target) => exists(state, target));
+		store.update({
+			...selection.length !== snapshot.selection.length ? { selection } : {},
+			...snapshot.hovered && !exists(state, snapshot.hovered) ? { hovered: null } : {},
+			...snapshot.drag && snapshot.drag.targets.some((target) => !exists(state, target)) ? { drag: null } : {}
+		});
+	});
+	return controller;
+}
+//#endregion
+export { createInteraction, unique as uniqueTargets };
+
+//# sourceMappingURL=controller.js.map

package/dist/interaction/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","names":[],"sources":["../../src/interaction/controller.ts"],"sourcesContent":["import type { AssetResolver } from \"../model/assets\";\nimport type { MapState } from \"../model/definition\";\nimport type { MapHistory } from \"../model/history\";\nimport type { MapChange } from \"../model/model\";\nimport type { MapPatch } from \"../model/patches\";\nimport type { ApplyFailure, ApplyResult, MaybePromise, Unsubscribe } from \"../model/result\";\nimport type { Rect } from \"../renderer/geometry\";\nimport type { DescribeContext, SceneNode } from \"../renderer/scene\";\nimport type { Footprint, IntentContext, IntentDefinition, IntentOf, IntentType, MapIntent, Rejection } from \"./intents\";\nimport type { KeyInput, PointerInput } from \"./input\";\nimport { pickNode, pickNodes, sameTarget, targetOf, type PickOptions, type Point, type TargetRef } from \"./picking\";\nimport { runPipeline, type PipelineContext, type PipelineResult, type PipelineStep } from \"./pipeline\";\nimport { createStore, type Store } from \"./store\";\n\nexport interface DragState {\n  readonly targets: readonly TargetRef[];\n  readonly origin: Point;\n  readonly delta: Point;\n  /** False when the pipeline refuses where the targets would land. */\n  readonly valid: boolean;\n  readonly reason?: string;\n  /** True when the model follows the pointer while dragging, false when it changes only on drop. */\n  readonly live: boolean;\n}\n\nexport interface GhostState {\n  readonly catalogId: string;\n  /** Asset drawn by the ghost. */\n  readonly kind: string;\n  /** Where it would be placed, after the pipeline (snapped…). */\n  readonly x: number;\n  readonly y: number;\n  readonly valid: boolean;\n  readonly reason?: string;\n  readonly bounds?: Rect;\n  readonly hitbox?: Rect;\n}\n\n/** Everything the interaction layer publishes. Skins and UIs read it; nothing here is drawn. */\nexport interface InteractionSnapshot {\n  readonly modes: readonly string[];\n  readonly hovered: TargetRef | null;\n  readonly selection: readonly TargetRef[];\n  readonly drag: DragState | null;\n  /** Rubber-band rectangle of a selection in progress. */\n  readonly marquee: Rect | null;\n  /** Id of the catalog item being placed, once `placement.start` was called. */\n  readonly placing: string | null;\n  /** Where the item being placed would land. Absent until the pointer has moved. */\n  readonly ghost: GhostState | null;\n  /** The last intent that was refused, and why, so the UI can tell the user. */\n  readonly lastRejection: (Rejection & { readonly intent: MapIntent }) | null;\n}\n\n/** The part of a model the interaction layer needs. Any `MapModel` fits. */\nexport interface ModelApi<R extends MaybePromise<ApplyResult> = MaybePromise<ApplyResult>> {\n  readonly state: MapState;\n  subscribe(listener: (change: MapChange) => void): Unsubscribe;\n  apply(input: MapPatch | readonly MapPatch[], options?: { readonly coalesce?: string; readonly intents?: readonly unknown[] }): R;\n  /** Used to take back a drag that applied its moves as it went. */\n  readonly history?: MapHistory<R>;\n}\n\nexport interface Tool {\n  readonly id: string;\n  /** The tool is active while one of these modes is. */\n  readonly modes: readonly string[];\n  /** Tools with a higher priority see events first. Defaults to 0. */\n  readonly priority?: number;\n  /** Gate: the tool only reacts to events for which this is true, e.g. a modifier key. */\n  readonly when?: (input: PointerInput | KeyInput) => boolean;\n  /** Return `true` to take the event: the tool then also gets the moves and the release. */\n  pointerDown?(input: PointerInput, controller: InteractionController): boolean | void;\n  pointerMove?(input: PointerInput, controller: InteractionController): boolean | void;\n  pointerUp?(input: PointerInput, controller: InteractionController): void;\n  key?(input: KeyInput, controller: InteractionController): boolean | void;\n  /** The tool stops being active (mode change, `controller.cancel()`): drop what is in progress. */\n  cancel?(controller: InteractionController): void;\n}\n\nexport interface SubmitOptions {\n  /** Consecutive submissions with the same key become one undo step. */\n  readonly coalesce?: string;\n}\n\nexport interface PreviewOptions {\n  /** Targets to leave out of the obstacles, e.g. those being moved. */\n  readonly ignore?: readonly TargetRef[];\n}\n\nexport interface InteractionController<R extends MaybePromise<ApplyResult> = MaybePromise<ApplyResult>> {\n  readonly state: Store<InteractionSnapshot>;\n  readonly model: ModelApi<R>;\n  readonly assets: AssetResolver;\n  readonly describeContext: DescribeContext;\n  readonly modes: readonly string[];\n  /** Replaces the active modes. Tools of a mode that is no longer active are cancelled. */\n  setModes(modes: readonly string[]): void;\n  readonly tools: readonly Tool[];\n  addTool(tool: Tool): Unsubscribe;\n  registerIntent<K extends IntentType>(type: K, definition: IntentDefinition<K>): Unsubscribe;\n  hasIntent(type: IntentType): boolean;\n  /** Adds steps to the chain an intent goes through. Steps run in the order they were added. */\n  usePipeline<K extends IntentType>(type: K, steps: readonly PipelineStep<K>[]): Unsubscribe;\n  /** Runs the pipeline only, without changing anything: what the ghost and the drag preview use. */\n  preview<K extends IntentType>(intent: IntentOf<K>, options?: PreviewOptions): PipelineResult<K>;\n  /**\n   * Turns intents into patches through the pipeline and applies them. Several\n   * intents are applied as one atomic batch. A refusal comes back as a failure\n   * whose `rejection.code` is the reason, and is kept in `state.lastRejection`.\n   */\n  submit(intent: MapIntent | readonly MapIntent[], options?: SubmitOptions): R | ApplyFailure;\n  /** What is drawn right now. */\n  nodes(): readonly SceneNode[];\n  pick(point: Point, options?: PickOptions): SceneNode | undefined;\n  pickAll(point: Point, options?: PickOptions): SceneNode[];\n  /** Last known pointer position in world coordinates. */\n  readonly pointer: Point | null;\n  feedPointer(kind: \"down\" | \"move\" | \"up\", input: PointerInput): boolean;\n  feedKey(input: KeyInput): boolean;\n  /** Cancels whatever is in progress: a drag, a placement. */\n  cancel(): void;\n  destroy(): void;\n}\n\nexport interface InteractionOptions<R extends MaybePromise<ApplyResult>> {\n  readonly model: ModelApi<R>;\n  readonly assets: AssetResolver;\n  readonly describe: DescribeContext;\n  /** What is drawn right now. */\n  readonly nodes: () => readonly SceneNode[];\n  /** Who is acting, handed to the steps of the pipeline. */\n  readonly actor?: () => unknown;\n  /** Active modes at the start. Defaults to `[\"edit\"]`. */\n  readonly modes?: readonly string[];\n  readonly onError?: (error: unknown) => void;\n}\n\nconst unique = (targets: readonly TargetRef[]): TargetRef[] =>\n  targets.filter((target, index) => targets.findIndex((other) => sameTarget(other, target)) === index);\n\nconst exists = (state: MapState, target: TargetRef): boolean =>\n  (target.type === \"element\" ? state.elements : state.events).some((entry) => entry.id === target.id);\n\nexport function createInteraction<R extends MaybePromise<ApplyResult>>(options: InteractionOptions<R>): InteractionController<R> {\n  const reportError = options.onError ?? ((error: unknown) => console.error(error));\n  const store = createStore<InteractionSnapshot>(\n    {\n      modes: [...(options.modes ?? [\"edit\"])],\n      hovered: null,\n      selection: [],\n      drag: null,\n      marquee: null,\n      placing: null,\n      ghost: null,\n      lastRejection: null,\n    },\n    reportError,\n  );\n\n  const tools: Tool[] = [];\n  const intents = new Map<string, IntentDefinition<IntentType>>();\n  const pipelines = new Map<string, PipelineStep<IntentType>[]>();\n  let captured: Tool | null = null;\n  let lastPointer: Point | null = null;\n  let destroyed = false;\n\n  const isActive = (tool: Tool): boolean => tool.modes.some((mode) => store.get().modes.includes(mode));\n  const ordered = (): Tool[] => [...tools].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));\n\n  const intentContext = (): IntentContext => ({\n    state: options.model.state,\n    assets: options.assets,\n    describe: options.describe,\n    actor: options.actor?.(),\n  });\n\n  const footprintOf = (intent: IntentOf<IntentType>): Footprint | undefined =>\n    intents.get(intent.type)?.footprint?.(intent as never, intentContext());\n\n  const pipelineContext = (nodes: readonly SceneNode[], preview: boolean): PipelineContext => ({\n    state: options.model.state,\n    assets: options.assets,\n    nodes,\n    scene: options.nodes(),\n    actor: options.actor?.(),\n    preview,\n    footprint: footprintOf,\n    reject: (reason, message) => ({ ok: false, reason, ...(message !== undefined ? { message } : {}) }),\n  });\n\n  const refuse = (rejection: Rejection, intent: MapIntent, patchIndex?: number): ApplyFailure => {\n    store.update({ lastRejection: { ...rejection, intent } });\n    return {\n      ok: false,\n      rejection: {\n        code: rejection.reason,\n        message: rejection.message ?? rejection.reason,\n        ...(patchIndex !== undefined ? { patchIndex } : {}),\n      },\n    };\n  };\n\n  const stepsFor = (type: IntentType): readonly PipelineStep<IntentType>[] => pipelines.get(type) ?? [];\n\n  const controller: InteractionController<R> = {\n    state: store,\n    model: options.model,\n    assets: options.assets,\n    describeContext: options.describe,\n    get modes() {\n      return store.get().modes;\n    },\n    setModes(modes) {\n      const next = [...new Set(modes)];\n      const before = store.get().modes;\n      if (next.length === before.length && next.every((mode, index) => mode === before[index])) return;\n      store.update({ modes: next });\n      for (const tool of tools) {\n        if (!isActive(tool)) {\n          if (captured === tool) captured = null;\n          tool.cancel?.(controller);\n        }\n      }\n    },\n    get tools() {\n      return tools;\n    },\n    addTool(tool) {\n      if (tools.some((other) => other.id === tool.id)) throw new Error(`A tool with the id \"${tool.id}\" already exists`);\n      tools.push(tool);\n      return () => {\n        const index = tools.indexOf(tool);\n        if (index >= 0) tools.splice(index, 1);\n        if (captured === tool) captured = null;\n        tool.cancel?.(controller);\n      };\n    },\n    registerIntent(type, definition) {\n      if (intents.has(type)) throw new Error(`Intent \"${type}\" is already registered`);\n      intents.set(type, definition as unknown as IntentDefinition<IntentType>);\n      return () => intents.delete(type);\n    },\n    hasIntent: (type) => intents.has(type),\n    usePipeline(type, steps) {\n      const list = pipelines.get(type) ?? [];\n      list.push(...(steps as unknown as PipelineStep<IntentType>[]));\n      pipelines.set(type, list);\n      return () => {\n        const current = pipelines.get(type);\n        if (!current) return;\n        pipelines.set(type, current.filter((step) => !(steps as readonly unknown[]).includes(step)));\n      };\n    },\n    preview(intent, previewOptions = {}) {\n      const ignore = previewOptions.ignore ?? [];\n      const nodes = options.nodes().filter((node) => !ignore.some((target) => sameTarget(target, targetOf(node))));\n      return runPipeline(stepsFor(intent.type) as unknown as readonly PipelineStep<typeof intent.type>[], intent, pipelineContext(nodes, true));\n    },\n    submit(input, submitOptions) {\n      const list: readonly MapIntent[] = Array.isArray(input) ? (input as readonly MapIntent[]) : [input as MapIntent];\n      // Elements moved or removed together do not block one another.\n      const leaving: TargetRef[] = list.flatMap((intent) =>\n        intent.type === \"element.move\" || intent.type === \"element.remove\" ? [{ type: \"element\" as const, id: intent.id }] : [],\n      );\n      const nodes = options.nodes().filter((node) => !leaving.some((target) => sameTarget(target, targetOf(node))));\n      const context = pipelineContext(nodes, false);\n\n      const patches: MapPatch[] = [];\n      for (const [index, intent] of list.entries()) {\n        const definition = intents.get(intent.type);\n        if (!definition) return refuse({ ok: false, reason: \"unknown-intent\", message: `No intent \"${intent.type}\"` }, intent, index);\n\n        const result = runPipeline(stepsFor(intent.type) as unknown as readonly PipelineStep<typeof intent.type>[], intent, context);\n        if (!result.ok) return refuse(result, intent, index);\n\n        const resolved = definition.resolve(result.intent as never, intentContext());\n        if (typeof resolved === \"object\" && resolved !== null && \"ok\" in resolved && resolved.ok === false) {\n          return refuse(resolved, intent, index);\n        }\n        patches.push(...(Array.isArray(resolved) ? (resolved as MapPatch[]) : [resolved as MapPatch]));\n      }\n\n      store.update({ lastRejection: null });\n      // The intents travel with the patches: a committer that talks to an authority sends those.\n      return options.model.apply(patches.length === 1 ? patches[0]! : patches, { ...submitOptions, intents: list });\n    },\n    nodes: () => options.nodes(),\n    pick: (point, pickOptions) => pickNode(options.nodes(), point, pickOptions),\n    pickAll: (point, pickOptions) => pickNodes(options.nodes(), point, pickOptions),\n    get pointer() {\n      return lastPointer;\n    },\n    feedPointer(kind, input) {\n      if (destroyed) return false;\n      lastPointer = { x: input.x, y: input.y };\n      const run = (tool: Tool): boolean | void => {\n        if (tool.when && !tool.when(input)) return false;\n        return kind === \"down\" ? tool.pointerDown?.(input, controller) : kind === \"move\" ? tool.pointerMove?.(input, controller) : undefined;\n      };\n\n      if (kind === \"up\") {\n        const tool = captured;\n        captured = null;\n        tool?.pointerUp?.(input, controller);\n        return tool !== null;\n      }\n      if (captured && kind === \"move\") {\n        captured.pointerMove?.(input, controller);\n        return true;\n      }\n      for (const tool of ordered()) {\n        if (!isActive(tool)) continue;\n        if (run(tool) === true) {\n          if (kind === \"down\") captured = tool;\n          return true;\n        }\n      }\n      return false;\n    },\n    feedKey(input) {\n      if (destroyed) return false;\n      for (const tool of ordered()) {\n        if (!isActive(tool) || (tool.when && !tool.when(input))) continue;\n        if (tool.key?.(input, controller) === true) return true;\n      }\n      return false;\n    },\n    cancel() {\n      captured = null;\n      for (const tool of tools) tool.cancel?.(controller);\n    },\n    destroy() {\n      if (destroyed) return;\n      destroyed = true;\n      unsubscribe();\n      controller.cancel();\n      tools.length = 0;\n      intents.clear();\n      pipelines.clear();\n    },\n  };\n\n  // What no longer exists can neither be selected, hovered nor dragged.\n  const unsubscribe = options.model.subscribe(() => {\n    const snapshot = store.get();\n    const state = options.model.state;\n    const selection = snapshot.selection.filter((target) => exists(state, target));\n    store.update({\n      ...(selection.length !== snapshot.selection.length ? { selection } : {}),\n      ...(snapshot.hovered && !exists(state, snapshot.hovered) ? { hovered: null } : {}),\n      ...(snapshot.drag && snapshot.drag.targets.some((target) => !exists(state, target)) ? { drag: null } : {}),\n    });\n  });\n\n  return controller;\n}\n\nexport { unique as uniqueTargets };\n"],"mappings":"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"}

package/dist/interaction/index.d.ts

@@ -0,0 +1,14 @@
+export * from './input';
+export * from './store';
+export * from './picking';
+export * from './intents';
+export * from './pipeline';
+export * from './steps';
+export * from './catalog';
+export * from './controller';
+export * from './builtin-intents';
+export * from './tools';
+export * from './selection-tool';
+export * from './placement';
+export * from './keyboard';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interaction/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/interaction/index.js

@@ -0,0 +1,13 @@
+import { bindKeyboard, toKeyInput } from "./keyboard.js";
+import { nodesIn, pickNode, pickNodes, sameTarget, targetKey, targetOf } from "./picking.js";
+import { compose, runPipeline } from "./pipeline.js";
+import { createStore } from "./store.js";
+import { createInteraction, uniqueTargets as unique } from "./controller.js";
+import { registerElementIntents } from "./builtin-intents.js";
+import { createPlacement, registerPlacementIntent } from "./placement.js";
+import { selectionTool } from "./selection-tool.js";
+import { NO_MODIFIERS, key, pointer } from "./input.js";
+import { maxCount, minDistance, ownerOnly, protectedZone, rateLimit, requireFree, snapToGrid, withinMap } from "./steps.js";
+import { defineCatalog } from "./catalog.js";
+import { hoverTool, playTool } from "./tools.js";
+export { NO_MODIFIERS, bindKeyboard, compose, createInteraction, createPlacement, createStore, defineCatalog, hoverTool, key, maxCount, minDistance, nodesIn, ownerOnly, pickNode, pickNodes, playTool, pointer, protectedZone, rateLimit, registerElementIntents, registerPlacementIntent, requireFree, runPipeline, sameTarget, selectionTool, snapToGrid, targetKey, targetOf, toKeyInput, unique as uniqueTargets, withinMap };

package/dist/interaction/input.d.ts

@@ -0,0 +1,26 @@
+export interface Modifiers {
+    readonly shift: boolean;
+    readonly ctrl: boolean;
+    readonly alt: boolean;
+    readonly meta: boolean;
+}
+export declare const NO_MODIFIERS: Modifiers;
+/** A pointer event, already converted to world coordinates (pixels of the map). */
+export interface PointerInput {
+    readonly x: number;
+    readonly y: number;
+    /** 0 is the main button, 2 the secondary one. */
+    readonly button: number;
+    readonly modifiers: Modifiers;
+}
+export interface KeyInput {
+    /** `KeyboardEvent.key`: `"Escape"`, `"Delete"`, `"a"`… */
+    readonly key: string;
+    readonly modifiers: Modifiers;
+}
+/** Builds a pointer input: `pointer(10, 20, { shift: true })`. Handy in tests and in hosts that have no DOM events. */
+export declare function pointer(x: number, y: number, options?: {
+    button?: number;
+} & Partial<Modifiers>): PointerInput;
+export declare function key(name: string, modifiers?: Partial<Modifiers>): KeyInput;
+//# sourceMappingURL=input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/interaction/input.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,YAAY,EAAE,SAAiF,CAAC;AAE7G,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,uHAAuH;AACvH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,SAAS,CAAM,GAAG,YAAY,CAGlH;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,QAAQ,CAE9E"}

package/dist/interaction/input.js

@@ -0,0 +1,33 @@
+//#region src/interaction/input.ts
+var NO_MODIFIERS = Object.freeze({
+	shift: false,
+	ctrl: false,
+	alt: false,
+	meta: false
+});
+/** Builds a pointer input: `pointer(10, 20, { shift: true })`. Handy in tests and in hosts that have no DOM events. */
+function pointer(x, y, options = {}) {
+	const { button = 0, ...modifiers } = options;
+	return {
+		x,
+		y,
+		button,
+		modifiers: {
+			...NO_MODIFIERS,
+			...modifiers
+		}
+	};
+}
+function key(name, modifiers = {}) {
+	return {
+		key: name,
+		modifiers: {
+			...NO_MODIFIERS,
+			...modifiers
+		}
+	};
+}
+//#endregion
+export { NO_MODIFIERS, key, pointer };
+
+//# sourceMappingURL=input.js.map

package/dist/interaction/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","names":[],"sources":["../../src/interaction/input.ts"],"sourcesContent":["export interface Modifiers {\n  readonly shift: boolean;\n  readonly ctrl: boolean;\n  readonly alt: boolean;\n  readonly meta: boolean;\n}\n\nexport const NO_MODIFIERS: Modifiers = Object.freeze({ shift: false, ctrl: false, alt: false, meta: false });\n\n/** A pointer event, already converted to world coordinates (pixels of the map). */\nexport interface PointerInput {\n  readonly x: number;\n  readonly y: number;\n  /** 0 is the main button, 2 the secondary one. */\n  readonly button: number;\n  readonly modifiers: Modifiers;\n}\n\nexport interface KeyInput {\n  /** `KeyboardEvent.key`: `\"Escape\"`, `\"Delete\"`, `\"a\"`… */\n  readonly key: string;\n  readonly modifiers: Modifiers;\n}\n\n/** Builds a pointer input: `pointer(10, 20, { shift: true })`. Handy in tests and in hosts that have no DOM events. */\nexport function pointer(x: number, y: number, options: { button?: number } & Partial<Modifiers> = {}): PointerInput {\n  const { button = 0, ...modifiers } = options;\n  return { x, y, button, modifiers: { ...NO_MODIFIERS, ...modifiers } };\n}\n\nexport function key(name: string, modifiers: Partial<Modifiers> = {}): KeyInput {\n  return { key: name, modifiers: { ...NO_MODIFIERS, ...modifiers } };\n}\n"],"mappings":";AAOA,IAAa,eAA0B,OAAO,OAAO;CAAE,OAAO;CAAO,MAAM;CAAO,KAAK;CAAO,MAAM;AAAM,CAAC;;AAkB3G,SAAgB,QAAQ,GAAW,GAAW,UAAoD,CAAC,GAAiB;CAClH,MAAM,EAAE,SAAS,GAAG,GAAG,cAAc;CACrC,OAAO;EAAE;EAAG;EAAG;EAAQ,WAAW;GAAE,GAAG;GAAc,GAAG;EAAU;CAAE;AACtE;AAEA,SAAgB,IAAI,MAAc,YAAgC,CAAC,GAAa;CAC9E,OAAO;EAAE,KAAK;EAAM,WAAW;GAAE,GAAG;GAAc,GAAG;EAAU;CAAE;AACnE"}

package/dist/interaction/intents.d.ts

@@ -0,0 +1,80 @@
+import { AssetResolver } from '../model/assets';
+import { MapState } from '../model/definition';
+import { MapPatch } from '../model/patches';
+import { Rect } from '../renderer/geometry';
+import { DescribeContext } from '../renderer/scene';
+import { TargetRef } from './picking';
+/**
+ * Everything a user can ask for, mapped to its payload. Open on purpose: a
+ * feature adds its intents by merging into this interface.
+ *
+ * ```ts
+ * declare module "@rpgjs/map-builder/interaction" {
+ *   interface IntentRegistry {
+ *     "tilling.till": { readonly x: number; readonly y: number };
+ *   }
+ * }
+ * ```
+ *
+ * An intent is a wish, not a fact: it goes through the pipeline, then becomes
+ * patches, which the committer decides to apply.
+ */
+export interface IntentRegistry {
+    "element.move": {
+        readonly id: string;
+        readonly x: number;
+        readonly y: number;
+    };
+    "element.remove": {
+        readonly id: string;
+    };
+    /** Put something of the catalog on the map. `id` is generated when omitted. */
+    "element.place": {
+        readonly catalogId: string;
+        readonly x: number;
+        readonly y: number;
+        readonly id?: string;
+    };
+}
+export type IntentType = keyof IntentRegistry & string;
+export type IntentOf<K extends IntentType> = {
+    readonly type: K;
+} & IntentRegistry[K];
+export type MapIntent = {
+    [K in IntentType]: IntentOf<K>;
+}[IntentType];
+/** Intents that carry a position, the ones a grid can snap. */
+export type PositionedIntentType = {
+    [K in IntentType]: IntentRegistry[K] extends {
+        readonly x: number;
+        readonly y: number;
+    } ? K : never;
+}[IntentType];
+/** Why an intent was refused. Structured, so the UI can explain and the server can log. */
+export interface Rejection {
+    readonly ok: false;
+    /** Machine-readable, open: `"occupied"`, `"not-enough-wood"`… */
+    readonly reason: string;
+    readonly message?: string;
+}
+/** The space an intent would take, for checks like "is this spot free?". */
+export interface Footprint {
+    readonly bounds: Rect;
+    readonly hitbox?: Rect;
+    /** Things that must not count as obstacles: the element being moved itself. */
+    readonly ignore?: readonly TargetRef[];
+}
+export interface IntentContext {
+    readonly state: MapState;
+    readonly assets: AssetResolver;
+    readonly describe: DescribeContext;
+    /** Who is acting. Whatever the game decides: a player, a user. */
+    readonly actor: unknown;
+}
+export interface IntentDefinition<K extends IntentType> {
+    /** Turns the (validated) intent into patches. */
+    resolve(intent: IntentOf<K>, context: IntentContext): MapPatch | readonly MapPatch[] | Rejection;
+    /** Where the intent would put things, when it makes sense. */
+    footprint?(intent: IntentOf<K>, context: IntentContext): Footprint | undefined;
+}
+//# sourceMappingURL=intents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intents.d.ts","sourceRoot":"","sources":["../../src/interaction/intents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChF,gBAAgB,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,+EAA+E;IAC/E,eAAe,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/G;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,cAAc,GAAG,MAAM,CAAC;AACvD,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,UAAU,IAAI;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;AACtF,MAAM,MAAM,SAAS,GAAG;KAAG,CAAC,IAAI,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC;CAAE,CAAC,UAAU,CAAC,CAAC;AAEvE,+DAA+D;AAC/D,MAAM,MAAM,oBAAoB,GAAG;KAChC,CAAC,IAAI,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK;CACpG,CAAC,UAAU,CAAC,CAAC;AAEd,2FAA2F;AAC3F,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,UAAU;IACpD,iDAAiD;IACjD,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,GAAG,QAAQ,GAAG,SAAS,QAAQ,EAAE,GAAG,SAAS,CAAC;IACjG,8DAA8D;IAC9D,SAAS,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC;CAChF"}

package/dist/interaction/keyboard.d.ts

@@ -0,0 +1,26 @@
+import { Unsubscribe } from '../model/result';
+import { InteractionController } from './controller';
+import { KeyInput } from './input';
+/** The part of a `KeyboardEvent` that is used. */
+export interface KeyEventLike {
+    readonly key: string;
+    readonly shiftKey?: boolean;
+    readonly ctrlKey?: boolean;
+    readonly altKey?: boolean;
+    readonly metaKey?: boolean;
+    readonly target?: unknown;
+    preventDefault?(): void;
+}
+/** Anything that emits key events: `window`, `document`, an element. */
+export interface KeyTarget {
+    addEventListener(type: "keydown", listener: (event: KeyEventLike) => void): void;
+    removeEventListener(type: "keydown", listener: (event: KeyEventLike) => void): void;
+}
+export declare const toKeyInput: (event: KeyEventLike) => KeyInput;
+/**
+ * Gives key presses to the interaction layer: Escape cancels, Delete removes.
+ * Keys typed in a text field are left alone, and a key a tool took is not passed
+ * on to the browser. Returns the function that stops listening.
+ */
+export declare function bindKeyboard(controller: Pick<InteractionController, "feedKey">, target: KeyTarget): Unsubscribe;
+//# sourceMappingURL=keyboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/interaction/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,IAAI,IAAI,CAAC;CACzB;AAED,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;IACjF,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;CACrF;AAQD,eAAO,MAAM,UAAU,GAAI,OAAO,YAAY,KAAG,QAG/C,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,GAAG,WAAW,CAO/G"}