@rpgjs/map-builder 0.0.0-stage → 5.0.0

package/dist/interaction/keyboard.js

@@ -0,0 +1,32 @@
+//#region src/interaction/keyboard.ts
+var isTyping = (target) => {
+	const element = target;
+	const tag = element?.tagName?.toUpperCase();
+	return tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT" || element?.isContentEditable === true;
+};
+var toKeyInput = (event) => ({
+	key: event.key,
+	modifiers: {
+		shift: !!event.shiftKey,
+		ctrl: !!event.ctrlKey,
+		alt: !!event.altKey,
+		meta: !!event.metaKey
+	}
+});
+/**
+* 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.
+*/
+function bindKeyboard(controller, target) {
+	const listener = (event) => {
+		if (isTyping(event.target)) return;
+		if (controller.feedKey(toKeyInput(event))) event.preventDefault?.();
+	};
+	target.addEventListener("keydown", listener);
+	return () => target.removeEventListener("keydown", listener);
+}
+//#endregion
+export { bindKeyboard, toKeyInput };
+
+//# sourceMappingURL=keyboard.js.map

package/dist/interaction/keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","names":[],"sources":["../../src/interaction/keyboard.ts"],"sourcesContent":["import type { Unsubscribe } from \"../model/result\";\nimport type { InteractionController } from \"./controller\";\nimport type { KeyInput } from \"./input\";\n\n/** The part of a `KeyboardEvent` that is used. */\nexport interface KeyEventLike {\n  readonly key: string;\n  readonly shiftKey?: boolean;\n  readonly ctrlKey?: boolean;\n  readonly altKey?: boolean;\n  readonly metaKey?: boolean;\n  readonly target?: unknown;\n  preventDefault?(): void;\n}\n\n/** Anything that emits key events: `window`, `document`, an element. */\nexport interface KeyTarget {\n  addEventListener(type: \"keydown\", listener: (event: KeyEventLike) => void): void;\n  removeEventListener(type: \"keydown\", listener: (event: KeyEventLike) => void): void;\n}\n\nconst isTyping = (target: unknown): boolean => {\n  const element = target as { tagName?: string; isContentEditable?: boolean } | null | undefined;\n  const tag = element?.tagName?.toUpperCase();\n  return tag === \"INPUT\" || tag === \"TEXTAREA\" || tag === \"SELECT\" || element?.isContentEditable === true;\n};\n\nexport const toKeyInput = (event: KeyEventLike): KeyInput => ({\n  key: event.key,\n  modifiers: { shift: !!event.shiftKey, ctrl: !!event.ctrlKey, alt: !!event.altKey, meta: !!event.metaKey },\n});\n\n/**\n * Gives key presses to the interaction layer: Escape cancels, Delete removes.\n * Keys typed in a text field are left alone, and a key a tool took is not passed\n * on to the browser. Returns the function that stops listening.\n */\nexport function bindKeyboard(controller: Pick<InteractionController, \"feedKey\">, target: KeyTarget): Unsubscribe {\n  const listener = (event: KeyEventLike): void => {\n    if (isTyping(event.target)) return;\n    if (controller.feedKey(toKeyInput(event))) event.preventDefault?.();\n  };\n  target.addEventListener(\"keydown\", listener);\n  return () => target.removeEventListener(\"keydown\", listener);\n}\n"],"mappings":";AAqBA,IAAM,YAAY,WAA6B;CAC7C,MAAM,UAAU;CAChB,MAAM,MAAM,SAAS,SAAS,YAAY;CAC1C,OAAO,QAAQ,WAAW,QAAQ,cAAc,QAAQ,YAAY,SAAS,sBAAsB;AACrG;AAEA,IAAa,cAAc,WAAmC;CAC5D,KAAK,MAAM;CACX,WAAW;EAAE,OAAO,CAAC,CAAC,MAAM;EAAU,MAAM,CAAC,CAAC,MAAM;EAAS,KAAK,CAAC,CAAC,MAAM;EAAQ,MAAM,CAAC,CAAC,MAAM;CAAQ;AAC1G;;;;;;AAOA,SAAgB,aAAa,YAAoD,QAAgC;CAC/G,MAAM,YAAY,UAA8B;EAC9C,IAAI,SAAS,MAAM,MAAM,GAAG;EAC5B,IAAI,WAAW,QAAQ,WAAW,KAAK,CAAC,GAAG,MAAM,iBAAiB;CACpE;CACA,OAAO,iBAAiB,WAAW,QAAQ;CAC3C,aAAa,OAAO,oBAAoB,WAAW,QAAQ;AAC7D"}

package/dist/interaction/picking.d.ts

@@ -0,0 +1,33 @@
+import { Rect } from '../renderer/geometry';
+import { SceneNode } from '../renderer/scene';
+/** An element or an event on the map. */
+export interface TargetRef {
+    readonly type: "element" | "event";
+    readonly id: string;
+}
+export declare const targetKey: (target: TargetRef) => string;
+export declare const sameTarget: (a: TargetRef, b: TargetRef) => boolean;
+export declare const targetOf: (node: SceneNode) => TargetRef;
+export interface Point {
+    readonly x: number;
+    readonly y: number;
+}
+export interface PickOptions {
+    /**
+     * What counts as being under the pointer: the drawn `"bounds"` (default), or
+     * only the `"hitbox"`, for dense maps where sprites overlap a lot.
+     */
+    readonly area?: "bounds" | "hitbox";
+    /** Only consider these kinds of target. */
+    readonly types?: readonly TargetRef["type"][];
+}
+/**
+ * Every node under `point`, front first. Front means drawn last: the highest
+ * sort key, and among equals the one that appears later in the list.
+ */
+export declare function pickNodes(nodes: readonly SceneNode[], point: Point, options?: PickOptions): SceneNode[];
+/** The node drawn in front under `point`, if any. */
+export declare const pickNode: (nodes: readonly SceneNode[], point: Point, options?: PickOptions) => SceneNode | undefined;
+/** Nodes whose bounds touch `area`, for a rubber-band selection. */
+export declare function nodesIn(nodes: readonly SceneNode[], area: Rect, types?: readonly TargetRef["type"][]): SceneNode[];
+//# sourceMappingURL=picking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"picking.d.ts","sourceRoot":"","sources":["../../src/interaction/picking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,yCAAyC;AACzC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,SAAS,GAAI,QAAQ,SAAS,KAAG,MAAwC,CAAC;AACvF,eAAO,MAAM,UAAU,GAAI,GAAG,SAAS,EAAE,GAAG,SAAS,KAAG,OAA6C,CAAC;AACtG,eAAO,MAAM,QAAQ,GAAI,MAAM,SAAS,KAAG,SAA+C,CAAC;AAE3F,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;CAC/C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,WAAgB,GAAG,SAAS,EAAE,CAW3G;AAED,qDAAqD;AACrD,eAAO,MAAM,QAAQ,GAAI,OAAO,SAAS,SAAS,EAAE,EAAE,OAAO,KAAK,EAAE,UAAU,WAAW,KAAG,SAAS,GAAG,SACnE,CAAC;AAEtC,oEAAoE;AACpE,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,EAAE,CAWlH"}

package/dist/interaction/picking.js

@@ -0,0 +1,35 @@
+//#region src/interaction/picking.ts
+var targetKey = (target) => `${target.type}s/${target.id}`;
+var sameTarget = (a, b) => a.type === b.type && a.id === b.id;
+var targetOf = (node) => ({
+	type: node.type,
+	id: node.id
+});
+var contains = (rect, point) => point.x >= rect.x && point.x <= rect.x + rect.width && point.y >= rect.y && point.y <= rect.y + rect.height;
+/**
+* Every node under `point`, front first. Front means drawn last: the highest
+* sort key, and among equals the one that appears later in the list.
+*/
+function pickNodes(nodes, point, options = {}) {
+	const area = options.area ?? "bounds";
+	return nodes.map((node, order) => ({
+		node,
+		order
+	})).filter(({ node }) => {
+		if (options.types && !options.types.includes(node.type)) return false;
+		const rect = area === "hitbox" ? node.hitbox : node.bounds;
+		return rect !== void 0 && contains(rect, point);
+	}).sort((a, b) => b.node.sortKey - a.node.sortKey || b.order - a.order).map(({ node }) => node);
+}
+/** The node drawn in front under `point`, if any. */
+var pickNode = (nodes, point, options) => pickNodes(nodes, point, options)[0];
+/** Nodes whose bounds touch `area`, for a rubber-band selection. */
+function nodesIn(nodes, area, types) {
+	const right = area.x + area.width;
+	const bottom = area.y + area.height;
+	return nodes.filter((node) => (!types || types.includes(node.type)) && node.bounds.x <= right && area.x <= node.bounds.x + node.bounds.width && node.bounds.y <= bottom && area.y <= node.bounds.y + node.bounds.height);
+}
+//#endregion
+export { nodesIn, pickNode, pickNodes, sameTarget, targetKey, targetOf };
+
+//# sourceMappingURL=picking.js.map

package/dist/interaction/picking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picking.js","names":[],"sources":["../../src/interaction/picking.ts"],"sourcesContent":["import type { Rect } from \"../renderer/geometry\";\nimport type { SceneNode } from \"../renderer/scene\";\n\n/** An element or an event on the map. */\nexport interface TargetRef {\n  readonly type: \"element\" | \"event\";\n  readonly id: string;\n}\n\nexport const targetKey = (target: TargetRef): string => `${target.type}s/${target.id}`;\nexport const sameTarget = (a: TargetRef, b: TargetRef): boolean => a.type === b.type && a.id === b.id;\nexport const targetOf = (node: SceneNode): TargetRef => ({ type: node.type, id: node.id });\n\nexport interface Point {\n  readonly x: number;\n  readonly y: number;\n}\n\nconst contains = (rect: Rect, point: Point): boolean =>\n  point.x >= rect.x && point.x <= rect.x + rect.width && point.y >= rect.y && point.y <= rect.y + rect.height;\n\nexport interface PickOptions {\n  /**\n   * What counts as being under the pointer: the drawn `\"bounds\"` (default), or\n   * only the `\"hitbox\"`, for dense maps where sprites overlap a lot.\n   */\n  readonly area?: \"bounds\" | \"hitbox\";\n  /** Only consider these kinds of target. */\n  readonly types?: readonly TargetRef[\"type\"][];\n}\n\n/**\n * Every node under `point`, front first. Front means drawn last: the highest\n * sort key, and among equals the one that appears later in the list.\n */\nexport function pickNodes(nodes: readonly SceneNode[], point: Point, options: PickOptions = {}): SceneNode[] {\n  const area = options.area ?? \"bounds\";\n  return nodes\n    .map((node, order) => ({ node, order }))\n    .filter(({ node }) => {\n      if (options.types && !options.types.includes(node.type)) return false;\n      const rect = area === \"hitbox\" ? node.hitbox : node.bounds;\n      return rect !== undefined && contains(rect, point);\n    })\n    .sort((a, b) => b.node.sortKey - a.node.sortKey || b.order - a.order)\n    .map(({ node }) => node);\n}\n\n/** The node drawn in front under `point`, if any. */\nexport const pickNode = (nodes: readonly SceneNode[], point: Point, options?: PickOptions): SceneNode | undefined =>\n  pickNodes(nodes, point, options)[0];\n\n/** Nodes whose bounds touch `area`, for a rubber-band selection. */\nexport function nodesIn(nodes: readonly SceneNode[], area: Rect, types?: readonly TargetRef[\"type\"][]): SceneNode[] {\n  const right = area.x + area.width;\n  const bottom = area.y + area.height;\n  return nodes.filter(\n    (node) =>\n      (!types || types.includes(node.type)) &&\n      node.bounds.x <= right &&\n      area.x <= node.bounds.x + node.bounds.width &&\n      node.bounds.y <= bottom &&\n      area.y <= node.bounds.y + node.bounds.height,\n  );\n}\n"],"mappings":";AASA,IAAa,aAAa,WAA8B,GAAG,OAAO,KAAK,IAAI,OAAO;AAClF,IAAa,cAAc,GAAc,MAA0B,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE;AACnG,IAAa,YAAY,UAAgC;CAAE,MAAM,KAAK;CAAM,IAAI,KAAK;AAAG;AAOxF,IAAM,YAAY,MAAY,UAC5B,MAAM,KAAK,KAAK,KAAK,MAAM,KAAK,KAAK,IAAI,KAAK,SAAS,MAAM,KAAK,KAAK,KAAK,MAAM,KAAK,KAAK,IAAI,KAAK;;;;;AAgBvG,SAAgB,UAAU,OAA6B,OAAc,UAAuB,CAAC,GAAgB;CAC3G,MAAM,OAAO,QAAQ,QAAQ;CAC7B,OAAO,MACJ,KAAK,MAAM,WAAW;EAAE;EAAM;CAAM,EAAE,CAAC,CACvC,QAAQ,EAAE,WAAW;EACpB,IAAI,QAAQ,SAAS,CAAC,QAAQ,MAAM,SAAS,KAAK,IAAI,GAAG,OAAO;EAChE,MAAM,OAAO,SAAS,WAAW,KAAK,SAAS,KAAK;EACpD,OAAO,SAAS,KAAA,KAAa,SAAS,MAAM,KAAK;CACnD,CAAC,CAAC,CACD,MAAM,GAAG,MAAM,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,CACpE,KAAK,EAAE,WAAW,IAAI;AAC3B;;AAGA,IAAa,YAAY,OAA6B,OAAc,YAClE,UAAU,OAAO,OAAO,OAAO,CAAC,CAAC;;AAGnC,SAAgB,QAAQ,OAA6B,MAAY,OAAmD;CAClH,MAAM,QAAQ,KAAK,IAAI,KAAK;CAC5B,MAAM,SAAS,KAAK,IAAI,KAAK;CAC7B,OAAO,MAAM,QACV,UACE,CAAC,SAAS,MAAM,SAAS,KAAK,IAAI,MACnC,KAAK,OAAO,KAAK,SACjB,KAAK,KAAK,KAAK,OAAO,IAAI,KAAK,OAAO,SACtC,KAAK,OAAO,KAAK,UACjB,KAAK,KAAK,KAAK,OAAO,IAAI,KAAK,OAAO,MAC1C;AACF"}

package/dist/interaction/pipeline.d.ts

@@ -0,0 +1,45 @@
+import { AssetResolver } from '../model/assets';
+import { MapState } from '../model/definition';
+import { SceneNode } from '../renderer/scene';
+import { Footprint, IntentOf, IntentType, Rejection } from './intents';
+export type PipelineAccepted<K extends IntentType> = {
+    readonly ok: true;
+    readonly intent: IntentOf<K>;
+};
+/** A rejection carries the intent as it was when it was refused, e.g. already snapped to the grid. */
+export type PipelineRejected<K extends IntentType> = Rejection & {
+    readonly intent?: IntentOf<K>;
+};
+export type PipelineResult<K extends IntentType = IntentType> = PipelineAccepted<K> | PipelineRejected<K>;
+export interface PipelineContext {
+    readonly state: MapState;
+    readonly assets: AssetResolver;
+    /**
+     * What can get in the way: what is drawn right now, with the sizes and hitboxes the
+     * player sees, minus the elements the intents are moving or removing.
+     */
+    readonly nodes: readonly SceneNode[];
+    /** Everything that is drawn, including what the intents are moving or removing. */
+    readonly scene: readonly SceneNode[];
+    /** Who is acting. Whatever the game decides: a player, a user. */
+    readonly actor: unknown;
+    /**
+     * True when the pipeline only previews (a ghost following the pointer) and nothing
+     * will happen. Steps with a side effect, such as `rateLimit`, must not act then.
+     */
+    readonly preview: boolean;
+    /** The space the intent would take, or `undefined` when it does not apply. */
+    footprint(intent: IntentOf<IntentType>): Footprint | undefined;
+    /** Refuses the intent: `return ctx.reject("not-enough-wood")`. */
+    reject(reason: string, message?: string): Rejection;
+}
+/**
+ * One link of the chain, in the style of Koa. It may modify the intent
+ * (`next({ ...intent, x: 32 })`), refuse it (`ctx.reject(reason)`) or pass it on (`next()`).
+ */
+export type PipelineStep<K extends IntentType = IntentType> = (intent: IntentOf<K>, context: PipelineContext, next: (intent?: IntentOf<K>) => PipelineResult<K>) => PipelineResult<K>;
+/** Runs `steps` in order. Pure and synchronous, so the same chain can preview on the client and validate on the server. */
+export declare function runPipeline<K extends IntentType>(steps: readonly PipelineStep<K>[], intent: IntentOf<K>, context: PipelineContext): PipelineResult<K>;
+/** Chains several steps into one, to give a catalog item or a game a reusable rule set. */
+export declare const compose: <K extends IntentType>(...steps: readonly PipelineStep<K>[]) => PipelineStep<K>;
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/interaction/pipeline.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,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE5E,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,UAAU,IAAI;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AACzG,sGAAsG;AACtG,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,UAAU,IAAI,SAAS,GAAG;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AACnG,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,IAAI,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAE1G,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,SAAS,CAAC;IAC/D,kEAAkE;IAClE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrD;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,IAAI,CAC5D,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,KAC9C,cAAc,CAAC,CAAC,CAAC,CAAC;AAEvB,2HAA2H;AAC3H,wBAAgB,WAAW,CAAC,CAAC,SAAS,UAAU,EAC9C,KAAK,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,EACjC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,eAAe,GACvB,cAAc,CAAC,CAAC,CAAC,CAQnB;AAED,2FAA2F;AAC3F,eAAO,MAAM,OAAO,GACjB,CAAC,SAAS,UAAU,EAAE,GAAG,OAAO,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,KAAG,YAAY,CAAC,CAAC,CAI3E,CAAC"}

package/dist/interaction/pipeline.js

@@ -0,0 +1,26 @@
+//#region src/interaction/pipeline.ts
+/** Runs `steps` in order. Pure and synchronous, so the same chain can preview on the client and validate on the server. */
+function runPipeline(steps, intent, context) {
+	const dispatch = (index, current) => {
+		const step = steps[index];
+		if (!step) return {
+			ok: true,
+			intent: current
+		};
+		const result = step(current, context, (replacement) => dispatch(index + 1, replacement ?? current));
+		return result.ok || result.intent !== void 0 ? result : {
+			...result,
+			intent: current
+		};
+	};
+	return dispatch(0, intent);
+}
+/** Chains several steps into one, to give a catalog item or a game a reusable rule set. */
+var compose = (...steps) => (intent, context, next) => {
+	const result = runPipeline(steps, intent, context);
+	return result.ok ? next(result.intent) : result;
+};
+//#endregion
+export { compose, runPipeline };
+
+//# sourceMappingURL=pipeline.js.map

package/dist/interaction/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","names":[],"sources":["../../src/interaction/pipeline.ts"],"sourcesContent":["import type { AssetResolver } from \"../model/assets\";\nimport type { MapState } from \"../model/definition\";\nimport type { SceneNode } from \"../renderer/scene\";\nimport type { Footprint, IntentOf, IntentType, Rejection } from \"./intents\";\n\nexport type PipelineAccepted<K extends IntentType> = { readonly ok: true; readonly intent: IntentOf<K> };\n/** A rejection carries the intent as it was when it was refused, e.g. already snapped to the grid. */\nexport type PipelineRejected<K extends IntentType> = Rejection & { readonly intent?: IntentOf<K> };\nexport type PipelineResult<K extends IntentType = IntentType> = PipelineAccepted<K> | PipelineRejected<K>;\n\nexport interface PipelineContext {\n  readonly state: MapState;\n  readonly assets: AssetResolver;\n  /**\n   * What can get in the way: what is drawn right now, with the sizes and hitboxes the\n   * player sees, minus the elements the intents are moving or removing.\n   */\n  readonly nodes: readonly SceneNode[];\n  /** Everything that is drawn, including what the intents are moving or removing. */\n  readonly scene: readonly SceneNode[];\n  /** Who is acting. Whatever the game decides: a player, a user. */\n  readonly actor: unknown;\n  /**\n   * True when the pipeline only previews (a ghost following the pointer) and nothing\n   * will happen. Steps with a side effect, such as `rateLimit`, must not act then.\n   */\n  readonly preview: boolean;\n  /** The space the intent would take, or `undefined` when it does not apply. */\n  footprint(intent: IntentOf<IntentType>): Footprint | undefined;\n  /** Refuses the intent: `return ctx.reject(\"not-enough-wood\")`. */\n  reject(reason: string, message?: string): Rejection;\n}\n\n/**\n * One link of the chain, in the style of Koa. It may modify the intent\n * (`next({ ...intent, x: 32 })`), refuse it (`ctx.reject(reason)`) or pass it on (`next()`).\n */\nexport type PipelineStep<K extends IntentType = IntentType> = (\n  intent: IntentOf<K>,\n  context: PipelineContext,\n  next: (intent?: IntentOf<K>) => PipelineResult<K>,\n) => PipelineResult<K>;\n\n/** Runs `steps` in order. Pure and synchronous, so the same chain can preview on the client and validate on the server. */\nexport function runPipeline<K extends IntentType>(\n  steps: readonly PipelineStep<K>[],\n  intent: IntentOf<K>,\n  context: PipelineContext,\n): PipelineResult<K> {\n  const dispatch = (index: number, current: IntentOf<K>): PipelineResult<K> => {\n    const step = steps[index];\n    if (!step) return { ok: true, intent: current };\n    const result = step(current, context, (replacement) => dispatch(index + 1, replacement ?? current));\n    return result.ok || result.intent !== undefined ? result : { ...result, intent: current };\n  };\n  return dispatch(0, intent);\n}\n\n/** Chains several steps into one, to give a catalog item or a game a reusable rule set. */\nexport const compose =\n  <K extends IntentType>(...steps: readonly PipelineStep<K>[]): PipelineStep<K> =>\n  (intent, context, next) => {\n    const result = runPipeline(steps, intent, context);\n    return result.ok ? next(result.intent) : result;\n  };\n"],"mappings":";;AA4CA,SAAgB,YACd,OACA,QACA,SACmB;CACnB,MAAM,YAAY,OAAe,YAA4C;EAC3E,MAAM,OAAO,MAAM;EACnB,IAAI,CAAC,MAAM,OAAO;GAAE,IAAI;GAAM,QAAQ;EAAQ;EAC9C,MAAM,SAAS,KAAK,SAAS,UAAU,gBAAgB,SAAS,QAAQ,GAAG,eAAe,OAAO,CAAC;EAClG,OAAO,OAAO,MAAM,OAAO,WAAW,KAAA,IAAY,SAAS;GAAE,GAAG;GAAQ,QAAQ;EAAQ;CAC1F;CACA,OAAO,SAAS,GAAG,MAAM;AAC3B;;AAGA,IAAa,WACY,GAAG,WACzB,QAAQ,SAAS,SAAS;CACzB,MAAM,SAAS,YAAY,OAAO,QAAQ,OAAO;CACjD,OAAO,OAAO,KAAK,KAAK,OAAO,MAAM,IAAI;AAC3C"}

package/dist/interaction/placement.d.ts

@@ -0,0 +1,76 @@
+import { JsonObject } from '../model/json';
+import { Unsubscribe, ApplyResult, MaybePromise } from '../model/result';
+import { describeElement } from '../renderer/scene';
+import { Catalog, CatalogId, CatalogItem } from './catalog';
+import { InteractionController } from './controller';
+import { IntentDefinition } from './intents';
+import { PipelineStep } from './pipeline';
+export type PlacementAnchor = "top-left" | "center" | "bottom-center";
+export interface PlacementOptions<C extends Catalog<string>> {
+    readonly catalog: C;
+    /** Rules every item goes through, before its own. Typically `[snapToGrid(32), withinMap(), requireFree()]`. */
+    readonly pipeline?: readonly PipelineStep<"element.place">[];
+    /** Which point of the item follows the pointer. Defaults to `"center"`. */
+    readonly anchor?: PlacementAnchor;
+    /** Stay in placement mode after an item was placed. Defaults to false. */
+    readonly keepPlacing?: boolean;
+    /** Ids of what gets placed. Defaults to `<catalog id>-<n>`. */
+    readonly idFactory?: (item: CatalogItem, taken: ReadonlySet<string>) => string;
+    /** Modes in which the tool is active. Defaults to `["play", "edit"]`: builders place in play. */
+    readonly modes?: readonly string[];
+    /**
+     * Data written on every element placed, from whoever places it: `(actor) => ({ owner: actor.id })`.
+     * Merged over the data of the catalog item.
+     */
+    readonly stamp?: (actor: unknown) => JsonObject | undefined;
+}
+export interface PlacedEvent {
+    readonly catalogId: string;
+    readonly id: string;
+    readonly x: number;
+    readonly y: number;
+}
+export interface RejectedEvent {
+    readonly catalogId: string;
+    /** Why: the reason of the step that refused, e.g. `"occupied"`. */
+    readonly reason: string;
+    readonly message: string;
+}
+export interface PlacementApi<Id extends string = string> {
+    readonly catalog: Catalog<Id>;
+    /** The item being placed, if any. */
+    readonly active: Id | null;
+    /** Starts placing: a ghost follows the pointer, valid or not, until a click or `cancel()`. */
+    start(id: Id): void;
+    cancel(): void;
+    onPlaced(listener: (event: PlacedEvent) => void): Unsubscribe;
+    onRejected(listener: (event: RejectedEvent) => void): Unsubscribe;
+}
+/** What the intent needs, with or without a tool: it is also what a server registers. */
+export type PlacementIntentOptions<C extends Catalog<string>> = Pick<PlacementOptions<C>, "catalog" | "pipeline" | "idFactory" | "stamp">;
+export interface PlacementCore {
+    readonly definition: IntentDefinition<"element.place">;
+    itemOf(id: string): CatalogItem | undefined;
+    /** What an item would look like at a position: its bounds and hitbox, as the renderer describes them. */
+    probe(item: CatalogItem, x: number, y: number): ReturnType<typeof describeElement>;
+    dispose(): void;
+}
+/**
+ * The `element.place` intent and the rules it goes through: those of the feature, then
+ * those of the catalog item. No tool and no ghost, so a server can register it too.
+ *
+ * Ids are given when the intent is resolved, numbered per item and never reused. A
+ * client that talks to an authority sends the intent without an id and reads the one
+ * it was given in the result: two clients can never choose the same.
+ */
+export declare function registerPlacementIntent<C extends Catalog<string>>(controller: Pick<InteractionController<MaybePromise<ApplyResult>>, "registerIntent" | "usePipeline" | "describeContext">, options: PlacementIntentOptions<C>): PlacementCore;
+/**
+ * Placing things of a catalog: the `element.place` intent, the ghost that
+ * previews it through the same pipeline that validates it, and the tool that
+ * drives both. Headless.
+ */
+export declare function createPlacement<C extends Catalog<string>>(controller: InteractionController<MaybePromise<ApplyResult>>, options: PlacementOptions<C>): {
+    readonly api: PlacementApi<CatalogId<C>>;
+    dispose(): void;
+};
+//# sourceMappingURL=placement.d.ts.map

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

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

package/dist/interaction/placement.js

@@ -0,0 +1,238 @@
+import { describeElement } from "../renderer/scene.js";
+import { runPipeline } from "./pipeline.js";
+//#region src/interaction/placement.ts
+var offsetOf = (anchor, width, height) => anchor === "center" ? {
+	x: -width / 2,
+	y: -height / 2
+} : anchor === "bottom-center" ? {
+	x: -width / 2,
+	y: -height
+} : {
+	x: 0,
+	y: 0
+};
+/**
+* The `element.place` intent and the rules it goes through: those of the feature, then
+* those of the catalog item. No tool and no ghost, so a server can register it too.
+*
+* Ids are given when the intent is resolved, numbered per item and never reused. A
+* client that talks to an authority sends the intent without an id and reads the one
+* it was given in the result: two clients can never choose the same.
+*/
+function registerPlacementIntent(controller, options) {
+	const { catalog } = options;
+	const counters = /* @__PURE__ */ new Map();
+	const itemOf = (id) => catalog.get(id);
+	const probe = (item, x, y) => describeElement({
+		id: "__placement__",
+		kind: item.sprite,
+		x,
+		y
+	}, controller.describeContext);
+	const nextId = (item, taken) => {
+		if (options.idFactory) return options.idFactory(item, taken);
+		let n = counters.get(item.id) ?? 0;
+		let id;
+		do {
+			n += 1;
+			id = `${item.id}-${n}`;
+		} while (taken.has(id));
+		counters.set(item.id, n);
+		return id;
+	};
+	const definition = {
+		resolve(intent, { state, actor }) {
+			const item = itemOf(intent.catalogId);
+			if (!item) return {
+				ok: false,
+				reason: "unknown-catalog-item",
+				message: `"${intent.catalogId}" is not in the catalog`
+			};
+			const id = intent.id ?? nextId(item, new Set(state.elements.map((element) => element.id)));
+			const data = {
+				...item.data,
+				...options.stamp?.(actor)
+			};
+			return {
+				type: "element.add",
+				element: {
+					id,
+					kind: item.sprite,
+					x: intent.x,
+					y: intent.y,
+					...Object.keys(data).length > 0 ? { data } : {}
+				}
+			};
+		},
+		footprint(intent) {
+			const item = itemOf(intent.catalogId);
+			const node = item ? probe(item, intent.x, intent.y) : void 0;
+			return node ? {
+				bounds: node.bounds,
+				...node.hitbox ? { hitbox: node.hitbox } : {}
+			} : void 0;
+		}
+	};
+	const itemRules = (intent, context, next) => {
+		const rules = itemOf(intent.catalogId)?.pipeline;
+		if (!rules || rules.length === 0) return next();
+		const result = runPipeline(rules, intent, context);
+		return result.ok ? next(result.intent) : result;
+	};
+	const stops = [controller.registerIntent("element.place", definition), controller.usePipeline("element.place", [...options.pipeline ?? [], itemRules])];
+	return {
+		definition,
+		itemOf,
+		probe,
+		dispose: () => stops.forEach((stop) => stop())
+	};
+}
+/**
+* Placing things of a catalog: the `element.place` intent, the ghost that
+* previews it through the same pipeline that validates it, and the tool that
+* drives both. Headless.
+*/
+function createPlacement(controller, options) {
+	const { catalog } = options;
+	const anchor = options.anchor ?? "center";
+	const placedListeners = /* @__PURE__ */ new Set();
+	const rejectedListeners = /* @__PURE__ */ new Set();
+	const core = registerPlacementIntent(controller, options);
+	const { itemOf, probe, definition } = core;
+	const stops = [core.dispose];
+	const ghostAt = (id, point) => {
+		const item = itemOf(id);
+		if (!item) return;
+		const size = probe(item, 0, 0)?.bounds;
+		const shift = size ? offsetOf(anchor, size.width, size.height) : {
+			x: 0,
+			y: 0
+		};
+		const wanted = {
+			type: "element.place",
+			catalogId: id,
+			x: point.x + shift.x,
+			y: point.y + shift.y
+		};
+		const result = controller.preview(wanted);
+		const final = result.intent ?? wanted;
+		const footprint = definition.footprint?.(final, {
+			state: controller.model.state,
+			assets: controller.assets,
+			describe: controller.describeContext,
+			actor: void 0
+		});
+		controller.state.update({ ghost: {
+			catalogId: id,
+			kind: item.sprite,
+			x: final.x,
+			y: final.y,
+			valid: result.ok,
+			...!result.ok ? { reason: result.reason } : {},
+			...footprint ? {
+				bounds: footprint.bounds,
+				...footprint.hitbox ? { hitbox: footprint.hitbox } : {}
+			} : {}
+		} });
+	};
+	const stopPlacing = () => controller.state.update({
+		placing: null,
+		ghost: null
+	});
+	const tool = {
+		id: "placement",
+		modes: options.modes ?? ["play", "edit"],
+		priority: 100,
+		pointerDown(input) {
+			const id = controller.state.get().placing;
+			if (id === null) return false;
+			if (input.button === 2) {
+				stopPlacing();
+				return true;
+			}
+			if (input.button !== 0) return false;
+			if (!itemOf(id)) return true;
+			ghostAt(id, input);
+			const ghost = controller.state.get().ghost;
+			if (!ghost) return true;
+			const result = controller.submit({
+				type: "element.place",
+				catalogId: id,
+				x: ghost.x,
+				y: ghost.y
+			});
+			const settle = (outcome) => {
+				if (outcome.ok) {
+					const added = outcome.patches.find((patch) => patch.type === "element.add");
+					const placedId = added && "element" in added ? added.element.id : "";
+					for (const listener of [...placedListeners]) listener({
+						catalogId: id,
+						id: placedId,
+						x: ghost.x,
+						y: ghost.y
+					});
+					if (!options.keepPlacing) stopPlacing();
+				} else {
+					const event = {
+						catalogId: id,
+						reason: outcome.rejection.code,
+						message: outcome.rejection.message
+					};
+					for (const listener of [...rejectedListeners]) listener(event);
+				}
+			};
+			if (typeof result.then === "function") result.then(settle);
+			else settle(result);
+			return true;
+		},
+		pointerMove(input) {
+			const id = controller.state.get().placing;
+			if (id === null) return false;
+			ghostAt(id, input);
+			return false;
+		},
+		key(input) {
+			if (input.key === "Escape" && controller.state.get().placing !== null) {
+				stopPlacing();
+				return true;
+			}
+			return false;
+		},
+		cancel: stopPlacing
+	};
+	stops.push(controller.addTool(tool));
+	return {
+		api: {
+			catalog,
+			get active() {
+				return controller.state.get().placing;
+			},
+			start(id) {
+				if (!catalog.has(id)) throw new Error(`"${id}" is not in the catalog`);
+				controller.state.update({
+					placing: id,
+					ghost: null
+				});
+				if (controller.pointer) ghostAt(id, controller.pointer);
+			},
+			cancel: stopPlacing,
+			onPlaced(listener) {
+				placedListeners.add(listener);
+				return () => placedListeners.delete(listener);
+			},
+			onRejected(listener) {
+				rejectedListeners.add(listener);
+				return () => rejectedListeners.delete(listener);
+			}
+		},
+		dispose() {
+			stops.forEach((stop) => stop());
+			placedListeners.clear();
+			rejectedListeners.clear();
+		}
+	};
+}
+//#endregion
+export { createPlacement, registerPlacementIntent };
+
+//# sourceMappingURL=placement.js.map

package/dist/interaction/placement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement.js","names":[],"sources":["../../src/interaction/placement.ts"],"sourcesContent":["import type { JsonObject } from \"../model/json\";\nimport type { Unsubscribe } from \"../model/result\";\nimport type { ApplyResult, MaybePromise } from \"../model/result\";\nimport { describeElement } from \"../renderer/scene\";\nimport type { Catalog, CatalogId, CatalogItem } from \"./catalog\";\nimport type { InteractionController, Tool } from \"./controller\";\nimport type { KeyInput, PointerInput } from \"./input\";\nimport type { Footprint, IntentDefinition } from \"./intents\";\nimport { runPipeline, type PipelineStep } from \"./pipeline\";\nimport type { Point } from \"./picking\";\n\nexport type PlacementAnchor = \"top-left\" | \"center\" | \"bottom-center\";\n\nexport interface PlacementOptions<C extends Catalog<string>> {\n  readonly catalog: C;\n  /** Rules every item goes through, before its own. Typically `[snapToGrid(32), withinMap(), requireFree()]`. */\n  readonly pipeline?: readonly PipelineStep<\"element.place\">[];\n  /** Which point of the item follows the pointer. Defaults to `\"center\"`. */\n  readonly anchor?: PlacementAnchor;\n  /** Stay in placement mode after an item was placed. Defaults to false. */\n  readonly keepPlacing?: boolean;\n  /** Ids of what gets placed. Defaults to `<catalog id>-<n>`. */\n  readonly idFactory?: (item: CatalogItem, taken: ReadonlySet<string>) => string;\n  /** Modes in which the tool is active. Defaults to `[\"play\", \"edit\"]`: builders place in play. */\n  readonly modes?: readonly string[];\n  /**\n   * Data written on every element placed, from whoever places it: `(actor) => ({ owner: actor.id })`.\n   * Merged over the data of the catalog item.\n   */\n  readonly stamp?: (actor: unknown) => JsonObject | undefined;\n}\n\nexport interface PlacedEvent {\n  readonly catalogId: string;\n  readonly id: string;\n  readonly x: number;\n  readonly y: number;\n}\n\nexport interface RejectedEvent {\n  readonly catalogId: string;\n  /** Why: the reason of the step that refused, e.g. `\"occupied\"`. */\n  readonly reason: string;\n  readonly message: string;\n}\n\nexport interface PlacementApi<Id extends string = string> {\n  readonly catalog: Catalog<Id>;\n  /** The item being placed, if any. */\n  readonly active: Id | null;\n  /** Starts placing: a ghost follows the pointer, valid or not, until a click or `cancel()`. */\n  start(id: Id): void;\n  cancel(): void;\n  onPlaced(listener: (event: PlacedEvent) => void): Unsubscribe;\n  onRejected(listener: (event: RejectedEvent) => void): Unsubscribe;\n}\n\nconst offsetOf = (anchor: PlacementAnchor, width: number, height: number): Point =>\n  anchor === \"center\" ? { x: -width / 2, y: -height / 2 } : anchor === \"bottom-center\" ? { x: -width / 2, y: -height } : { x: 0, y: 0 };\n\n/** What the intent needs, with or without a tool: it is also what a server registers. */\nexport type PlacementIntentOptions<C extends Catalog<string>> = Pick<PlacementOptions<C>, \"catalog\" | \"pipeline\" | \"idFactory\" | \"stamp\">;\n\nexport interface PlacementCore {\n  readonly definition: IntentDefinition<\"element.place\">;\n  itemOf(id: string): CatalogItem | undefined;\n  /** What an item would look like at a position: its bounds and hitbox, as the renderer describes them. */\n  probe(item: CatalogItem, x: number, y: number): ReturnType<typeof describeElement>;\n  dispose(): void;\n}\n\n/**\n * The `element.place` intent and the rules it goes through: those of the feature, then\n * those of the catalog item. No tool and no ghost, so a server can register it too.\n *\n * Ids are given when the intent is resolved, numbered per item and never reused. A\n * client that talks to an authority sends the intent without an id and reads the one\n * it was given in the result: two clients can never choose the same.\n */\nexport function registerPlacementIntent<C extends Catalog<string>>(\n  controller: Pick<InteractionController<MaybePromise<ApplyResult>>, \"registerIntent\" | \"usePipeline\" | \"describeContext\">,\n  options: PlacementIntentOptions<C>,\n): PlacementCore {\n  const { catalog } = options;\n  const counters = new Map<string, number>();\n  const itemOf = (id: string): CatalogItem | undefined => catalog.get(id);\n\n  const probe = (item: CatalogItem, x: number, y: number) =>\n    describeElement({ id: \"__placement__\", kind: item.sprite, x, y }, controller.describeContext);\n\n  const nextId = (item: CatalogItem, taken: ReadonlySet<string>): string => {\n    if (options.idFactory) return options.idFactory(item, taken);\n    let n = counters.get(item.id) ?? 0;\n    let id: string;\n    do {\n      n += 1;\n      id = `${item.id}-${n}`;\n    } while (taken.has(id));\n    counters.set(item.id, n);\n    return id;\n  };\n\n  const definition: IntentDefinition<\"element.place\"> = {\n    resolve(intent, { state, actor }) {\n      const item = itemOf(intent.catalogId);\n      if (!item) return { ok: false, reason: \"unknown-catalog-item\", message: `\"${intent.catalogId}\" is not in the catalog` };\n      const id = intent.id ?? nextId(item, new Set(state.elements.map((element) => element.id)));\n      const data = { ...item.data, ...options.stamp?.(actor) };\n      return {\n        type: \"element.add\",\n        element: { id, kind: item.sprite, x: intent.x, y: intent.y, ...(Object.keys(data).length > 0 ? { data } : {}) },\n      };\n    },\n    footprint(intent): Footprint | undefined {\n      const item = itemOf(intent.catalogId);\n      const node = item ? probe(item, intent.x, intent.y) : undefined;\n      return node ? { bounds: node.bounds, ...(node.hitbox ? { hitbox: node.hitbox } : {}) } : undefined;\n    },\n  };\n\n  // The rules of the item come after those of the feature, on every placement.\n  const itemRules: PipelineStep<\"element.place\"> = (intent, context, next) => {\n    const rules = itemOf(intent.catalogId)?.pipeline;\n    if (!rules || rules.length === 0) return next();\n    const result = runPipeline(rules, intent, context);\n    return result.ok ? next(result.intent) : result;\n  };\n\n  const stops: Unsubscribe[] = [\n    controller.registerIntent(\"element.place\", definition),\n    controller.usePipeline(\"element.place\", [...(options.pipeline ?? []), itemRules]),\n  ];\n\n  return { definition, itemOf, probe, dispose: () => stops.forEach((stop) => stop()) };\n}\n\n/**\n * Placing things of a catalog: the `element.place` intent, the ghost that\n * previews it through the same pipeline that validates it, and the tool that\n * drives both. Headless.\n */\nexport function createPlacement<C extends Catalog<string>>(\n  controller: InteractionController<MaybePromise<ApplyResult>>,\n  options: PlacementOptions<C>,\n): { readonly api: PlacementApi<CatalogId<C>>; dispose(): void } {\n  const { catalog } = options;\n  const anchor = options.anchor ?? \"center\";\n  const placedListeners = new Set<(event: PlacedEvent) => void>();\n  const rejectedListeners = new Set<(event: RejectedEvent) => void>();\n  const core = registerPlacementIntent(controller, options);\n  const { itemOf, probe, definition } = core;\n  const stops: Unsubscribe[] = [core.dispose];\n\n  const ghostAt = (id: string, point: Point): void => {\n    const item = itemOf(id);\n    if (!item) return;\n    const size = probe(item, 0, 0)?.bounds;\n    const shift = size ? offsetOf(anchor, size.width, size.height) : { x: 0, y: 0 };\n    const wanted = { type: \"element.place\" as const, catalogId: id, x: point.x + shift.x, y: point.y + shift.y };\n    const result = controller.preview(wanted);\n    const final = result.intent ?? wanted;\n    const footprint = definition.footprint?.(final, {\n      state: controller.model.state,\n      assets: controller.assets,\n      describe: controller.describeContext,\n      actor: undefined,\n    });\n    controller.state.update({\n      ghost: {\n        catalogId: id,\n        kind: item.sprite,\n        x: final.x,\n        y: final.y,\n        valid: result.ok,\n        ...(!result.ok ? { reason: result.reason } : {}),\n        ...(footprint ? { bounds: footprint.bounds, ...(footprint.hitbox ? { hitbox: footprint.hitbox } : {}) } : {}),\n      },\n    });\n  };\n\n  const stopPlacing = (): void => controller.state.update({ placing: null, ghost: null });\n\n  const tool: Tool = {\n    id: \"placement\",\n    modes: options.modes ?? [\"play\", \"edit\"],\n    // Placing comes before selecting: while an item is in hand, a click places it.\n    priority: 100,\n    pointerDown(input: PointerInput) {\n      const id = controller.state.get().placing;\n      if (id === null) return false;\n      if (input.button === 2) {\n        stopPlacing();\n        return true;\n      }\n      if (input.button !== 0) return false;\n\n      if (!itemOf(id)) return true;\n      ghostAt(id, input);\n      const ghost = controller.state.get().ghost;\n      if (!ghost) return true;\n\n      // No id is sent: whoever resolves the intent gives one, and it comes back in the result.\n      const result = controller.submit({ type: \"element.place\", catalogId: id, x: ghost.x, y: ghost.y });\n      const settle = (outcome: ApplyResult): void => {\n        if (outcome.ok) {\n          const added = outcome.patches.find((patch) => patch.type === \"element.add\");\n          const placedId = added && \"element\" in added ? added.element.id : \"\";\n          for (const listener of [...placedListeners]) listener({ catalogId: id, id: placedId, x: ghost.x, y: ghost.y });\n          if (!options.keepPlacing) stopPlacing();\n        } else {\n          const event = { catalogId: id, reason: outcome.rejection.code, message: outcome.rejection.message };\n          for (const listener of [...rejectedListeners]) listener(event);\n        }\n      };\n      if (typeof (result as Promise<unknown>).then === \"function\") void (result as Promise<ApplyResult>).then(settle);\n      else settle(result as ApplyResult);\n      return true;\n    },\n    pointerMove(input: PointerInput) {\n      const id = controller.state.get().placing;\n      if (id === null) return false;\n      ghostAt(id, input);\n      return false;\n    },\n    key(input: KeyInput) {\n      if (input.key === \"Escape\" && controller.state.get().placing !== null) {\n        stopPlacing();\n        return true;\n      }\n      return false;\n    },\n    cancel: stopPlacing,\n  };\n  stops.push(controller.addTool(tool));\n\n  const api: PlacementApi<CatalogId<C>> = {\n    catalog: catalog as unknown as Catalog<CatalogId<C>>,\n    get active() {\n      return controller.state.get().placing as CatalogId<C> | null;\n    },\n    start(id) {\n      if (!catalog.has(id)) throw new Error(`\"${id}\" is not in the catalog`);\n      controller.state.update({ placing: id, ghost: null });\n      if (controller.pointer) ghostAt(id, controller.pointer);\n    },\n    cancel: stopPlacing,\n    onPlaced(listener) {\n      placedListeners.add(listener);\n      return () => placedListeners.delete(listener);\n    },\n    onRejected(listener) {\n      rejectedListeners.add(listener);\n      return () => rejectedListeners.delete(listener);\n    },\n  };\n\n  return {\n    api,\n    dispose() {\n      stops.forEach((stop) => stop());\n      placedListeners.clear();\n      rejectedListeners.clear();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/interaction/selection-tool.d.ts

@@ -0,0 +1,29 @@
+import { Tool } from './controller';
+import { KeyInput, PointerInput } from './input';
+import { PickOptions, TargetRef } from './picking';
+export interface SelectionToolOptions {
+    readonly modes?: readonly string[];
+    /** What can be selected. Defaults to elements and events. */
+    readonly types?: readonly TargetRef["type"][];
+    readonly area?: PickOptions["area"];
+    /**
+     * Dragging selected elements. `false` turns it off. With `live`, the model
+     * follows the pointer (one undo step); without, it changes on release.
+     */
+    readonly drag?: false | {
+        readonly live?: boolean;
+        readonly threshold?: number;
+    };
+    /** Select with a rubber band on empty space. Defaults to true. */
+    readonly marquee?: boolean;
+    /** `Delete` and `Backspace` remove the selected elements. Defaults to false. */
+    readonly remove?: boolean;
+    readonly when?: (input: PointerInput | KeyInput) => boolean;
+    readonly priority?: number;
+}
+/**
+ * Hover, click and rubber-band selection, dragging and deleting. Headless: it
+ * only reads and writes the interaction state and submits intents.
+ */
+export declare function selectionTool(options?: SelectionToolOptions): Tool;
+//# sourceMappingURL=selection-tool.d.ts.map

package/dist/interaction/selection-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-tool.d.ts","sourceRoot":"","sources":["../../src/interaction/selection-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyB,IAAI,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEtD,OAAO,EAAiC,KAAK,WAAW,EAAc,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAExG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF,kEAAkE;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,KAAK,OAAO,CAAC;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAsBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,IAAI,CA2KtE"}