@rpgjs/client 5.0.0-beta.12 → 5.0.0-beta.13

package/dist/index.js

@@ -32,6 +32,8 @@ import { PrebuiltComponentAnimations } from "./components/animations/index.js";
 import { ProjectileManager } from "./Game/ProjectileManager.js";
 import { ClientVisualRegistry } from "./Game/ClientVisuals.js";
 import { createClientPointerContext } from "./services/pointerContext.js";
+import { RpgClientInteractions, dragToTile, draggable, hoverPopover, selectable } from "./services/interactions.js";
+import { RpgClientBuiltinI18n, provideI18n } from "./i18n.js";
 import { RpgClientEngine } from "./RpgClientEngine.js";
 import { Control } from "./services/keyboardControls.js";
 import { provideRpg } from "./services/standalone.js";
@@ -47,4 +49,4 @@ import "./components/index.js";
 import { Spritesheet } from "./decorators/spritesheet.js";
 import { withMobile } from "./components/gui/mobile/index.js";
 import { Input, KeyboardControls } from "canvasengine";
-export { AbstractWebsocket, __ce_component as BoxComponent, BridgeWebsocket, __ce_component$1 as CharacterComponent, ClientVisualRegistry, Context, Control, __ce_component$2 as DialogboxComponent, __ce_component$3 as EquipMenuComponent, __ce_component$4 as EventLayerComponent, __ce_component$5 as ExitMenuComponent, __ce_component$6 as GameoverComponent, GlobalConfigToken, __ce_component$7 as HpBar, __ce_component$8 as HudComponent, Input, __ce_component$9 as ItemsMenuComponent, KeyboardControls, __ce_component$10 as LightHalo, LoadMapService, LoadMapToken, __ce_component$11 as MainMenuComponent, __ce_component$12 as NotificationComponent, __ce_component$13 as OptionsMenuComponent, PrebuiltComponentAnimations, Presets, ProjectileManager, RpgClientEngine, RpgClientEvent, RpgClientObject, RpgClientPlayer, RpgGui, RpgResource, RpgSound, SaveClientService, SaveClientToken, __ce_component$14 as SaveLoadComponent, __ce_component$15 as SceneMap, __ce_component$16 as ShopComponent, __ce_component$17 as SkillsMenuComponent, Sound, Spritesheet, __ce_component$18 as TitleScreenComponent, WebSocketToken, clearInject, context, createClientPointerContext, getEntityProp, getKeyboardControlBind, getSoundMetadata, inject, isKeyboardActionConfig, keyboardEventMatchesBind, normalizeActionInput, provideClientGlobalConfig, provideClientModules, provideGlobalConfig, provideLoadMap, provideMmorpg, provideRpg, provideSaveClient, resolveKeyboardActionInput, resolveKeyboardDirectionInput, setInject, startGame, withMobile };
+export { AbstractWebsocket, __ce_component as BoxComponent, BridgeWebsocket, __ce_component$1 as CharacterComponent, ClientVisualRegistry, Context, Control, __ce_component$2 as DialogboxComponent, __ce_component$3 as EquipMenuComponent, __ce_component$4 as EventLayerComponent, __ce_component$5 as ExitMenuComponent, __ce_component$6 as GameoverComponent, GlobalConfigToken, __ce_component$7 as HpBar, __ce_component$8 as HudComponent, Input, __ce_component$9 as ItemsMenuComponent, KeyboardControls, __ce_component$10 as LightHalo, LoadMapService, LoadMapToken, __ce_component$11 as MainMenuComponent, __ce_component$12 as NotificationComponent, __ce_component$13 as OptionsMenuComponent, PrebuiltComponentAnimations, Presets, ProjectileManager, RpgClientBuiltinI18n, RpgClientEngine, RpgClientEvent, RpgClientInteractions, RpgClientObject, RpgClientPlayer, RpgGui, RpgResource, RpgSound, SaveClientService, SaveClientToken, __ce_component$14 as SaveLoadComponent, __ce_component$15 as SceneMap, __ce_component$16 as ShopComponent, __ce_component$17 as SkillsMenuComponent, Sound, Spritesheet, __ce_component$18 as TitleScreenComponent, WebSocketToken, clearInject, context, createClientPointerContext, dragToTile, draggable, getEntityProp, getKeyboardControlBind, getSoundMetadata, hoverPopover, inject, isKeyboardActionConfig, keyboardEventMatchesBind, normalizeActionInput, provideClientGlobalConfig, provideClientModules, provideGlobalConfig, provideI18n, provideLoadMap, provideMmorpg, provideRpg, provideSaveClient, resolveKeyboardActionInput, resolveKeyboardDirectionInput, selectable, setInject, startGame, withMobile };

package/dist/module.js

@@ -1,7 +1,7 @@
 import { inject } from "./node_modules/.pnpm/@signe_di@3.0.1/node_modules/@signe/di/dist/index.js";
 import { RpgGui } from "./Gui/Gui.js";
 import { getSoundMetadata } from "./Sound.js";
-import { findModules, provideModules } from "@rpgjs/common";
+import { findModules, provideModules, registerI18nMessages } from "@rpgjs/common";
 //#region src/module.ts
 /**
 * Provides client modules configuration to Dependency Injection
@@ -49,6 +49,7 @@ function provideClientModules(modules) {
 				module = moduleObj;
 			}
 			if ("client" in module) module = module.client;
+			if (module.i18n) registerI18nMessages(context, module.i18n, "client-module", 10);
 			if (module.spritesheets) {
 				const spritesheets = [...module.spritesheets];
 				module.spritesheets = { load: (engine) => {
@@ -129,6 +130,23 @@ function provideClientModules(modules) {
 					}
 				};
 			}
+			if (module.interactions) {
+				const interactions = module.interactions;
+				module.interactions = {
+					...interactions,
+					load: (engine) => {
+						if (typeof interactions === "function") {
+							interactions(engine);
+							return;
+						}
+						interactions.load?.(engine);
+						interactions.setup?.(engine);
+						if (Array.isArray(interactions.use)) interactions.use.forEach(([matcher, behavior]) => {
+							engine.interactions.use(matcher, behavior);
+						});
+					}
+				};
+			}
 			if (module.transitions) {
 				const transitions = [...module.transitions];
 				module.transitions = { load: (engine) => {
@@ -181,13 +199,15 @@ function provideGlobalConfig(config) {
 	};
 }
 function provideClientGlobalConfig(config = {}) {
-	if (!config.keyboardControls) config.keyboardControls = {
+	config.keyboardControls = {
 		up: "up",
 		down: "down",
 		left: "left",
 		right: "right",
 		action: "space",
-		escape: "escape"
+		dash: "shift",
+		escape: "escape",
+		...config.keyboardControls ?? {}
 	};
 	return provideGlobalConfig(config);
 }

package/dist/module.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.js","names":[],"sources":["../src/module.ts"],"sourcesContent":["import { findModules, provideModules } from \"@rpgjs/common\";\nimport { FactoryProvider } from \"@signe/di\";\nimport { RpgClientEngine } from \"./RpgClientEngine\";\nimport { RpgClient } from \"./RpgClient\";\nimport { inject } from \"@signe/di\";\nimport { RpgGui } from \"./Gui/Gui\";\nimport { getSoundMetadata } from \"./Sound\";\n\n/**\n * Type for client modules that can be either:\n * - An object implementing RpgClient interface\n * - A class decorated with @RpgModule decorator\n */\nexport type RpgClientModule = RpgClient | (new () => any);\n\n/**\n * Provides client modules configuration to Dependency Injection\n * \n * This function accepts an array of client modules that can be either:\n * - Objects implementing the RpgClient interface\n * - Classes decorated with the @RpgModule decorator (which will be instantiated)\n * \n * @param modules - Array of client modules (objects or classes)\n * @returns FactoryProvider configuration for DI\n * @example\n * ```ts\n * // Using an object\n * provideClientModules([\n *   {\n *     engine: {\n *       onConnected(engine) {\n *         console.log('Client connected')\n *       }\n *     }\n *   }\n * ])\n * \n * // Using a decorated class\n * @RpgModule<RpgClient>({\n *   engine: {\n *     onStart(engine) {\n *       console.log('Client started')\n *     }\n *   }\n * })\n * class MyClientModule {}\n * \n * provideClientModules([MyClientModule])\n * ```\n */\nexport function provideClientModules(modules: RpgClientModule[]): FactoryProvider {\n  return provideModules(modules, \"client\", (modules, context) => {\n    const mainModuleClient = findModules(context, 'Client')\n    modules = [...mainModuleClient, ...modules]\n    modules = modules.map((module) => {\n      // If module is a class (constructor function), instantiate it\n      // The RpgModule decorator adds properties to the prototype, which will be accessible via the instance\n      if (typeof module === 'function') {\n        const instance = new module() as any;\n        // Copy all enumerable properties (including from prototype) to a plain object\n        const moduleObj: any = {};\n        for (const key in instance) {\n          moduleObj[key] = instance[key];\n        }\n        module = moduleObj;\n      }\n      if ('client' in module) {\n        module = module.client as any;\n      }\n      if (module.spritesheets) {\n        const spritesheets = [...module.spritesheets];\n        module.spritesheets = {\n          load: (engine: RpgClientEngine) => {\n            spritesheets.forEach((spritesheet) => {\n              engine.addSpriteSheet(spritesheet);\n            });\n          },\n        };\n      }\n      if (module.spritesheetResolver) {\n        const resolver = module.spritesheetResolver;\n        module.spritesheetResolver = {\n          load: (engine: RpgClientEngine) => {\n            engine.setSpritesheetResolver(resolver);\n          },\n        };\n      }\n      if (module.sounds) {\n        const sounds = [...module.sounds];\n        module.sounds = {\n          load: (engine: RpgClientEngine) => {\n            sounds.forEach((sound) => {\n              // Check if it's a class decorated with @Sound\n              if (typeof sound === 'function' || (sound && sound.constructor && sound.constructor !== Object)) {\n                const metadata = getSoundMetadata(sound);\n                if (metadata) {\n                  // Handle single sound\n                  if (metadata.id && metadata.sound) {\n                    engine.addSound({\n                      id: metadata.id,\n                      src: metadata.sound,\n                      loop: metadata.loop,\n                      volume: metadata.volume,\n                    });\n                  }\n                  // Handle multiple sounds\n                  if (metadata.sounds) {\n                    Object.entries(metadata.sounds).forEach(([soundId, soundSrc]) => {\n                      engine.addSound({\n                        id: soundId,\n                        src: soundSrc,\n                        loop: metadata.loop,\n                        volume: metadata.volume,\n                      });\n                    });\n                  }\n                } else {\n                  // Not a decorated class, treat as regular sound object\n                  engine.addSound(sound);\n                }\n              } else {\n                // Regular sound object\n                engine.addSound(sound);\n              }\n            });\n          },\n        };\n      }\n      if (module.soundResolver) {\n        const resolver = module.soundResolver;\n        module.soundResolver = {\n          load: (engine: RpgClientEngine) => {\n            engine.setSoundResolver(resolver);\n          },\n        };\n      }\n      if (module.gui) {\n        const gui = [...module.gui];\n        module.gui = {\n          load: (engine: RpgClientEngine) => {\n            const guiService = inject(engine.context, RpgGui) as RpgGui;\n            gui.forEach((gui) => {\n              guiService.add(gui);\n            });\n          },\n        };\n      }\n      if (module.componentAnimations) {\n        const componentAnimations = [...module.componentAnimations];\n        module.componentAnimations = {\n          load: (engine: RpgClientEngine) => {\n            componentAnimations.forEach((componentAnimation) => {\n              engine.addComponentAnimation(componentAnimation);\n            });\n          },\n        };\n      }\n      if (module.clientVisuals) {\n        const clientVisuals = { ...module.clientVisuals };\n        module.clientVisuals = {\n          load: (engine: RpgClientEngine) => {\n            engine.registerClientVisuals(clientVisuals);\n          },\n        };\n      }\n      if (module.projectiles) {\n        const projectiles = { ...module.projectiles };\n        module.projectiles = {\n          ...projectiles,\n          load: (engine: RpgClientEngine) => {\n            if (projectiles.components) {\n              Object.entries(projectiles.components).forEach(([type, component]) => {\n                engine.registerProjectileComponent(type, component);\n              });\n            }\n          },\n        };\n      }\n      if (module.transitions) {\n        const transitions = [...module.transitions];\n        module.transitions = {\n          load: (engine: RpgClientEngine) => {\n            const guiService = inject(engine.context, RpgGui) as RpgGui;\n            transitions.forEach((transition) => {\n              guiService.add({\n                name: transition.id,\n                component: transition.component,\n                data: transition.props || {}\n              });\n            });\n          },\n        };\n      }\n      if (module.particles) {\n        const particles = [...module.particles];\n        module.particles = {\n          load: (engine: RpgClientEngine) => {\n            particles.forEach((particle) => {\n              engine.addParticle(particle);\n            });\n          },\n        };\n      }\n      if (module.sprite) {\n        const sprite = {...module.sprite};\n        module.sprite = {\n          ...sprite,\n          load: (engine: RpgClientEngine) => {\n            if (sprite.componentsBehind) {\n              sprite.componentsBehind.forEach((component) => {\n                engine.addSpriteComponentBehind(component);\n              });\n            }\n            if (sprite.componentsInFront) {\n              sprite.componentsInFront.forEach((component) => {\n                engine.addSpriteComponentInFront(component);\n              });\n            }\n            if (sprite.components) {\n              Object.entries(sprite.components).forEach(([id, component]) => {\n                engine.registerSpriteComponent(id, component);\n              });\n            }\n            if (sprite.eventComponent) {\n              engine.addEventComponentResolver(sprite.eventComponent);\n            }\n          },\n        };\n      }\n      return module;\n    });\n    return modules\n  });\n}\n\nexport const GlobalConfigToken = \"GlobalConfigToken\";\n\nexport function provideGlobalConfig(config: any) {\n  return {\n    provide: GlobalConfigToken,\n    useValue: config ?? {},\n  };\n}\n\nexport function provideClientGlobalConfig(config: any = {}) {\n  if (!config.keyboardControls) {\n    config.keyboardControls = {\n      up: 'up',\n      down: 'down',\n      left: 'left',\n      right: 'right',\n      action: 'space',\n      escape: 'escape'\n    }\n  }\n  return provideGlobalConfig(config)\n}\n"],"mappings":"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"}
+{"version":3,"file":"module.js","names":[],"sources":["../src/module.ts"],"sourcesContent":["import { findModules, provideModules, registerI18nMessages } from \"@rpgjs/common\";\nimport { FactoryProvider } from \"@signe/di\";\nimport { RpgClientEngine } from \"./RpgClientEngine\";\nimport { RpgClient } from \"./RpgClient\";\nimport { inject } from \"@signe/di\";\nimport { RpgGui } from \"./Gui/Gui\";\nimport { getSoundMetadata } from \"./Sound\";\n\n/**\n * Type for client modules that can be either:\n * - An object implementing RpgClient interface\n * - A class decorated with @RpgModule decorator\n */\nexport type RpgClientModule = RpgClient | (new () => any);\n\n/**\n * Provides client modules configuration to Dependency Injection\n * \n * This function accepts an array of client modules that can be either:\n * - Objects implementing the RpgClient interface\n * - Classes decorated with the @RpgModule decorator (which will be instantiated)\n * \n * @param modules - Array of client modules (objects or classes)\n * @returns FactoryProvider configuration for DI\n * @example\n * ```ts\n * // Using an object\n * provideClientModules([\n *   {\n *     engine: {\n *       onConnected(engine) {\n *         console.log('Client connected')\n *       }\n *     }\n *   }\n * ])\n * \n * // Using a decorated class\n * @RpgModule<RpgClient>({\n *   engine: {\n *     onStart(engine) {\n *       console.log('Client started')\n *     }\n *   }\n * })\n * class MyClientModule {}\n * \n * provideClientModules([MyClientModule])\n * ```\n */\nexport function provideClientModules(modules: RpgClientModule[]): FactoryProvider {\n  return provideModules(modules, \"client\", (modules, context) => {\n    const mainModuleClient = findModules(context, 'Client')\n    modules = [...mainModuleClient, ...modules]\n    modules = modules.map((module) => {\n      // If module is a class (constructor function), instantiate it\n      // The RpgModule decorator adds properties to the prototype, which will be accessible via the instance\n      if (typeof module === 'function') {\n        const instance = new module() as any;\n        // Copy all enumerable properties (including from prototype) to a plain object\n        const moduleObj: any = {};\n        for (const key in instance) {\n          moduleObj[key] = instance[key];\n        }\n        module = moduleObj;\n      }\n      if ('client' in module) {\n        module = module.client as any;\n      }\n      if (module.i18n) {\n        registerI18nMessages(context, module.i18n, \"client-module\", 10);\n      }\n      if (module.spritesheets) {\n        const spritesheets = [...module.spritesheets];\n        module.spritesheets = {\n          load: (engine: RpgClientEngine) => {\n            spritesheets.forEach((spritesheet) => {\n              engine.addSpriteSheet(spritesheet);\n            });\n          },\n        };\n      }\n      if (module.spritesheetResolver) {\n        const resolver = module.spritesheetResolver;\n        module.spritesheetResolver = {\n          load: (engine: RpgClientEngine) => {\n            engine.setSpritesheetResolver(resolver);\n          },\n        };\n      }\n      if (module.sounds) {\n        const sounds = [...module.sounds];\n        module.sounds = {\n          load: (engine: RpgClientEngine) => {\n            sounds.forEach((sound) => {\n              // Check if it's a class decorated with @Sound\n              if (typeof sound === 'function' || (sound && sound.constructor && sound.constructor !== Object)) {\n                const metadata = getSoundMetadata(sound);\n                if (metadata) {\n                  // Handle single sound\n                  if (metadata.id && metadata.sound) {\n                    engine.addSound({\n                      id: metadata.id,\n                      src: metadata.sound,\n                      loop: metadata.loop,\n                      volume: metadata.volume,\n                    });\n                  }\n                  // Handle multiple sounds\n                  if (metadata.sounds) {\n                    Object.entries(metadata.sounds).forEach(([soundId, soundSrc]) => {\n                      engine.addSound({\n                        id: soundId,\n                        src: soundSrc,\n                        loop: metadata.loop,\n                        volume: metadata.volume,\n                      });\n                    });\n                  }\n                } else {\n                  // Not a decorated class, treat as regular sound object\n                  engine.addSound(sound);\n                }\n              } else {\n                // Regular sound object\n                engine.addSound(sound);\n              }\n            });\n          },\n        };\n      }\n      if (module.soundResolver) {\n        const resolver = module.soundResolver;\n        module.soundResolver = {\n          load: (engine: RpgClientEngine) => {\n            engine.setSoundResolver(resolver);\n          },\n        };\n      }\n      if (module.gui) {\n        const gui = [...module.gui];\n        module.gui = {\n          load: (engine: RpgClientEngine) => {\n            const guiService = inject(engine.context, RpgGui) as RpgGui;\n            gui.forEach((gui) => {\n              guiService.add(gui);\n            });\n          },\n        };\n      }\n      if (module.componentAnimations) {\n        const componentAnimations = [...module.componentAnimations];\n        module.componentAnimations = {\n          load: (engine: RpgClientEngine) => {\n            componentAnimations.forEach((componentAnimation) => {\n              engine.addComponentAnimation(componentAnimation);\n            });\n          },\n        };\n      }\n      if (module.clientVisuals) {\n        const clientVisuals = { ...module.clientVisuals };\n        module.clientVisuals = {\n          load: (engine: RpgClientEngine) => {\n            engine.registerClientVisuals(clientVisuals);\n          },\n        };\n      }\n      if (module.projectiles) {\n        const projectiles = { ...module.projectiles };\n        module.projectiles = {\n          ...projectiles,\n          load: (engine: RpgClientEngine) => {\n            if (projectiles.components) {\n              Object.entries(projectiles.components).forEach(([type, component]) => {\n                engine.registerProjectileComponent(type, component);\n              });\n            }\n          },\n        };\n      }\n      if (module.interactions) {\n        const interactions = module.interactions;\n        module.interactions = {\n          ...interactions,\n          load: (engine: RpgClientEngine) => {\n            if (typeof interactions === \"function\") {\n              interactions(engine);\n              return;\n            }\n            interactions.load?.(engine);\n            interactions.setup?.(engine);\n            if (Array.isArray(interactions.use)) {\n              interactions.use.forEach(([matcher, behavior]) => {\n                engine.interactions.use(matcher, behavior);\n              });\n            }\n          },\n        };\n      }\n      if (module.transitions) {\n        const transitions = [...module.transitions];\n        module.transitions = {\n          load: (engine: RpgClientEngine) => {\n            const guiService = inject(engine.context, RpgGui) as RpgGui;\n            transitions.forEach((transition) => {\n              guiService.add({\n                name: transition.id,\n                component: transition.component,\n                data: transition.props || {}\n              });\n            });\n          },\n        };\n      }\n      if (module.particles) {\n        const particles = [...module.particles];\n        module.particles = {\n          load: (engine: RpgClientEngine) => {\n            particles.forEach((particle) => {\n              engine.addParticle(particle);\n            });\n          },\n        };\n      }\n      if (module.sprite) {\n        const sprite = {...module.sprite};\n        module.sprite = {\n          ...sprite,\n          load: (engine: RpgClientEngine) => {\n            if (sprite.componentsBehind) {\n              sprite.componentsBehind.forEach((component) => {\n                engine.addSpriteComponentBehind(component);\n              });\n            }\n            if (sprite.componentsInFront) {\n              sprite.componentsInFront.forEach((component) => {\n                engine.addSpriteComponentInFront(component);\n              });\n            }\n            if (sprite.components) {\n              Object.entries(sprite.components).forEach(([id, component]) => {\n                engine.registerSpriteComponent(id, component);\n              });\n            }\n            if (sprite.eventComponent) {\n              engine.addEventComponentResolver(sprite.eventComponent);\n            }\n          },\n        };\n      }\n      return module;\n    });\n    return modules\n  });\n}\n\nexport const GlobalConfigToken = \"GlobalConfigToken\";\n\nexport function provideGlobalConfig(config: any) {\n  return {\n    provide: GlobalConfigToken,\n    useValue: config ?? {},\n  };\n}\n\nexport function provideClientGlobalConfig(config: any = {}) {\n  config.keyboardControls = {\n    up: 'up',\n    down: 'down',\n    left: 'left',\n    right: 'right',\n    action: 'space',\n    dash: 'shift',\n    escape: 'escape',\n    ...(config.keyboardControls ?? {}),\n  }\n  return provideGlobalConfig(config)\n}\n"],"mappings":"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"}

package/dist/services/interactions.d.ts

@@ -0,0 +1,159 @@
+import { RpgActionInput, RpgActionName } from '@rpgjs/common';
+import { RpgClientEngine } from '../RpgClientEngine';
+export type RpgInteractionEventName = "pointerenter" | "pointerleave" | "pointerover" | "pointerout" | "pointerdown" | "pointerup" | "pointermove" | "click" | "dragstart" | "dragmove" | "drop" | "cancel";
+export type RpgInteractionPosition = {
+    x: number;
+    y: number;
+};
+export type RpgInteractionBounds = {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+    centerX: number;
+    centerY: number;
+    contains(point: RpgInteractionPosition | null | undefined): boolean;
+};
+export type RpgInteractionBoundsSet = {
+    bounds?: RpgInteractionBounds;
+    hitbox?: RpgInteractionBounds;
+    graphic?: RpgInteractionBounds;
+    [key: string]: RpgInteractionBounds | undefined;
+};
+export type RpgInteractionTile = {
+    x: number;
+    y: number;
+    worldX: number;
+    worldY: number;
+    width: number;
+    height: number;
+};
+export type RpgInteractionState = {
+    hovered: boolean;
+    pressed: boolean;
+    selected: boolean;
+    dragging: boolean;
+    data: Record<string, any>;
+    overlays: Record<string, RpgInteractionOverlay>;
+};
+export type RpgInteractionOverlay = {
+    component: any;
+    props?: Record<string, any>;
+};
+export type RpgInteractionMatcher = string | ((ctx: RpgInteractionMatcherContext) => boolean);
+export type RpgInteractionMatcherContext = {
+    client: RpgClientEngine;
+    target: any;
+    sprite: any;
+};
+export type RpgInteractionHandler = (ctx: RpgInteractionContext) => void;
+export type RpgInteractionBehavior = {
+    component?: any;
+    props?: Record<string, any> | ((ctx: RpgInteractionContext) => Record<string, any>);
+    dependencies?: any[] | ((ctx: RpgInteractionContext) => any[]);
+    cursor?: string | ((ctx: RpgInteractionContext) => string | undefined);
+    hitTest?: (ctx: RpgInteractionContext) => boolean;
+    pointerenter?: RpgInteractionHandler;
+    pointerleave?: RpgInteractionHandler;
+    pointerover?: RpgInteractionHandler;
+    pointerout?: RpgInteractionHandler;
+    pointerdown?: RpgInteractionHandler;
+    pointerup?: RpgInteractionHandler;
+    pointermove?: RpgInteractionHandler;
+    click?: RpgInteractionHandler;
+    dragstart?: RpgInteractionHandler;
+    dragmove?: RpgInteractionHandler;
+    drop?: RpgInteractionHandler;
+    cancel?: RpgInteractionHandler;
+};
+export type RpgInteractionComponentEntry = {
+    component: any;
+    props: Record<string, any>;
+    dependencies: any[];
+};
+export type RpgInteractionContext = {
+    client: RpgClientEngine;
+    target: any;
+    sprite: any;
+    event?: any;
+    behavior: RpgInteractionBehavior;
+    behaviorId: string;
+    pointer: {
+        screen(): RpgInteractionPosition | null;
+        world(): RpgInteractionPosition | null;
+        tile(): RpgInteractionTile | null;
+    };
+    bounds(kind?: string): RpgInteractionBounds;
+    state: {
+        value(): RpgInteractionState;
+        get<T = any>(key: string): T | undefined;
+        set(key: string, value: any): void;
+        patch(patch: Partial<Omit<RpgInteractionState, "data" | "overlays">>): void;
+    };
+    overlay: {
+        render(component: any, props?: Record<string, any>): void;
+        update(props?: Record<string, any>): void;
+        clear(): void;
+    };
+    select(selected?: boolean): void;
+    action(action: RpgActionName, data?: any): void;
+    action(input: RpgActionInput): void;
+    cancel(): void;
+};
+type InteractionEventInput = {
+    event?: any;
+    bounds?: RpgInteractionBoundsSet;
+};
+export declare class RpgClientInteractions {
+    private client;
+    private registrations;
+    private states;
+    private activeDrag?;
+    private nextId;
+    constructor(client: RpgClientEngine);
+    use(matcher: RpgInteractionMatcher, behavior: RpgInteractionBehavior | any): () => void;
+    getState(sprite: any): RpgInteractionState;
+    getRenderedComponents(sprite: any, bounds?: RpgInteractionBoundsSet): RpgInteractionComponentEntry[];
+    cursorFor(sprite: any, bounds?: RpgInteractionBoundsSet): string | undefined;
+    handle(sprite: any, type: RpgInteractionEventName, input?: InteractionEventInput): void;
+    handlePointerMove(event?: any): void;
+    handlePointerUp(event?: any): void;
+    cancelDrag(event?: any): void;
+    private getMatches;
+    private matches;
+    private createContext;
+    private callHandler;
+    private passesHitTest;
+    private isDraggable;
+    private defaultComponentProps;
+    private resolveProps;
+    private resolveDependencies;
+    private getSpriteId;
+    private patchState;
+    private patchStateData;
+    private patchOverlay;
+    private updateOverlay;
+    private clearOverlay;
+    private getPointerTile;
+}
+export declare function hoverPopover(component: any, props?: Record<string, any>): RpgInteractionBehavior;
+export declare function selectable(options?: {
+    cursor?: string;
+    onSelect?: RpgInteractionHandler;
+}): RpgInteractionBehavior;
+export declare function draggable(options?: {
+    cursor?: string;
+    start?: RpgInteractionHandler;
+    move?: RpgInteractionHandler;
+    drop?: RpgInteractionHandler;
+    cancel?: RpgInteractionHandler;
+}): RpgInteractionBehavior;
+export declare function dragToTile(options: {
+    action?: RpgActionName;
+    data?: (ctx: RpgInteractionContext) => any;
+    onDrop?: RpgInteractionHandler;
+    cursor?: string;
+}): RpgInteractionBehavior;
+export {};