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

package/dist/i18n.d.ts

@@ -0,0 +1,55 @@
+import { I18nConfig } from '@rpgjs/common';
+export declare const RpgClientBuiltinI18n: {
+    en: {
+        "rpg.menu.title": string;
+        "rpg.menu.status": string;
+        "rpg.menu.level": string;
+        "rpg.menu.gold": string;
+        "rpg.menu.parameters": string;
+        "rpg.menu.items": string;
+        "rpg.menu.skills": string;
+        "rpg.menu.equip": string;
+        "rpg.menu.options": string;
+        "rpg.menu.save": string;
+        "rpg.menu.exit": string;
+        "rpg.menu.weapons": string;
+        "rpg.menu.armor": string;
+        "rpg.menu.use": string;
+        "rpg.menu.cancel": string;
+        "rpg.menu.unequip": string;
+        "rpg.menu.remove-equipment": string;
+        "rpg.menu.empty": string;
+        "rpg.menu.leave-game": string;
+        "rpg.menu.exit-help": string;
+        "rpg.menu.options-help": string;
+        "rpg.save.title": string;
+        "rpg.save.subtitle": string;
+        "rpg.load.title": string;
+        "rpg.load.subtitle": string;
+        "rpg.save.auto": string;
+        "rpg.save.slot": string;
+        "rpg.save.empty-slot": string;
+        "rpg.save.level": string;
+        "rpg.save.exp": string;
+        "rpg.save.map": string;
+        "rpg.save.date": string;
+        "rpg.title.default": string;
+        "rpg.title.start": string;
+        "rpg.title.load": string;
+        "rpg.gameover.title": string;
+        "rpg.gameover.title-screen": string;
+        "rpg.gameover.load-game": string;
+        "rpg.shop.default-message": string;
+        "rpg.shop.choose-action": string;
+        "rpg.shop.buy": string;
+        "rpg.shop.sell": string;
+        "rpg.shop.back": string;
+        "rpg.shop.equipped": string;
+        "rpg.shop.already-equipped": string;
+        "rpg.shop.qty": string;
+        "rpg.shop.available": string;
+        "rpg.shop.quantity": string;
+        "rpg.shop.total": string;
+    };
+};
+export declare function provideI18n(config?: I18nConfig): import('@signe/di').FactoryProvider;

package/dist/i18n.js

@@ -0,0 +1,60 @@
+import { createI18nProvider } from "@rpgjs/common";
+//#region src/i18n.ts
+var RpgClientBuiltinI18n = { en: {
+	"rpg.menu.title": "Menu",
+	"rpg.menu.status": "Status",
+	"rpg.menu.level": "Level",
+	"rpg.menu.gold": "Gold",
+	"rpg.menu.parameters": "Parameters",
+	"rpg.menu.items": "Items",
+	"rpg.menu.skills": "Skills",
+	"rpg.menu.equip": "Equip",
+	"rpg.menu.options": "Options",
+	"rpg.menu.save": "Save",
+	"rpg.menu.exit": "Exit",
+	"rpg.menu.weapons": "Weapons",
+	"rpg.menu.armor": "Armor",
+	"rpg.menu.use": "Use",
+	"rpg.menu.cancel": "Cancel",
+	"rpg.menu.unequip": "Unequip",
+	"rpg.menu.remove-equipment": "Remove the current equipment",
+	"rpg.menu.empty": "Empty",
+	"rpg.menu.leave-game": "Leave the game?",
+	"rpg.menu.exit-help": "Press Action to confirm or Escape to go back.",
+	"rpg.menu.options-help": "Configure your preferences here.",
+	"rpg.save.title": "Save Game",
+	"rpg.save.subtitle": "Choose a slot to overwrite or create.",
+	"rpg.load.title": "Load Game",
+	"rpg.load.subtitle": "Select a slot to load your progress.",
+	"rpg.save.auto": "Auto Save",
+	"rpg.save.slot": "Slot {index}",
+	"rpg.save.empty-slot": "Empty Slot",
+	"rpg.save.level": "Level",
+	"rpg.save.exp": "Exp",
+	"rpg.save.map": "Map",
+	"rpg.save.date": "Date",
+	"rpg.title.default": "RPG",
+	"rpg.title.start": "Start",
+	"rpg.title.load": "Load",
+	"rpg.gameover.title": "Game Over",
+	"rpg.gameover.title-screen": "Title Screen",
+	"rpg.gameover.load-game": "Load Game",
+	"rpg.shop.default-message": "Welcome to my shop!",
+	"rpg.shop.choose-action": "Choose an action",
+	"rpg.shop.buy": "Buy",
+	"rpg.shop.sell": "Sell",
+	"rpg.shop.back": "Back",
+	"rpg.shop.equipped": "Equipped",
+	"rpg.shop.already-equipped": "Already equipped",
+	"rpg.shop.qty": "Qty",
+	"rpg.shop.available": "Available",
+	"rpg.shop.quantity": "Quantity",
+	"rpg.shop.total": "Total"
+} };
+function provideI18n(config = {}) {
+	return createI18nProvider(config);
+}
+//#endregion
+export { RpgClientBuiltinI18n, provideI18n };
+
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","names":[],"sources":["../src/i18n.ts"],"sourcesContent":["import { createI18nProvider, type I18nConfig } from \"@rpgjs/common\";\n\nexport const RpgClientBuiltinI18n = {\n  en: {\n    \"rpg.menu.title\": \"Menu\",\n    \"rpg.menu.status\": \"Status\",\n    \"rpg.menu.level\": \"Level\",\n    \"rpg.menu.gold\": \"Gold\",\n    \"rpg.menu.parameters\": \"Parameters\",\n    \"rpg.menu.items\": \"Items\",\n    \"rpg.menu.skills\": \"Skills\",\n    \"rpg.menu.equip\": \"Equip\",\n    \"rpg.menu.options\": \"Options\",\n    \"rpg.menu.save\": \"Save\",\n    \"rpg.menu.exit\": \"Exit\",\n    \"rpg.menu.weapons\": \"Weapons\",\n    \"rpg.menu.armor\": \"Armor\",\n    \"rpg.menu.use\": \"Use\",\n    \"rpg.menu.cancel\": \"Cancel\",\n    \"rpg.menu.unequip\": \"Unequip\",\n    \"rpg.menu.remove-equipment\": \"Remove the current equipment\",\n    \"rpg.menu.empty\": \"Empty\",\n    \"rpg.menu.leave-game\": \"Leave the game?\",\n    \"rpg.menu.exit-help\": \"Press Action to confirm or Escape to go back.\",\n    \"rpg.menu.options-help\": \"Configure your preferences here.\",\n    \"rpg.save.title\": \"Save Game\",\n    \"rpg.save.subtitle\": \"Choose a slot to overwrite or create.\",\n    \"rpg.load.title\": \"Load Game\",\n    \"rpg.load.subtitle\": \"Select a slot to load your progress.\",\n    \"rpg.save.auto\": \"Auto Save\",\n    \"rpg.save.slot\": \"Slot {index}\",\n    \"rpg.save.empty-slot\": \"Empty Slot\",\n    \"rpg.save.level\": \"Level\",\n    \"rpg.save.exp\": \"Exp\",\n    \"rpg.save.map\": \"Map\",\n    \"rpg.save.date\": \"Date\",\n    \"rpg.title.default\": \"RPG\",\n    \"rpg.title.start\": \"Start\",\n    \"rpg.title.load\": \"Load\",\n    \"rpg.gameover.title\": \"Game Over\",\n    \"rpg.gameover.title-screen\": \"Title Screen\",\n    \"rpg.gameover.load-game\": \"Load Game\",\n    \"rpg.shop.default-message\": \"Welcome to my shop!\",\n    \"rpg.shop.choose-action\": \"Choose an action\",\n    \"rpg.shop.buy\": \"Buy\",\n    \"rpg.shop.sell\": \"Sell\",\n    \"rpg.shop.back\": \"Back\",\n    \"rpg.shop.equipped\": \"Equipped\",\n    \"rpg.shop.already-equipped\": \"Already equipped\",\n    \"rpg.shop.qty\": \"Qty\",\n    \"rpg.shop.available\": \"Available\",\n    \"rpg.shop.quantity\": \"Quantity\",\n    \"rpg.shop.total\": \"Total\",\n  },\n};\n\nexport function provideI18n(config: I18nConfig = {}) {\n  return createI18nProvider(config);\n}\n"],"mappings":";;AAEA,IAAa,uBAAuB,EAClC,IAAI;CACF,kBAAkB;CAClB,mBAAmB;CACnB,kBAAkB;CAClB,iBAAiB;CACjB,uBAAuB;CACvB,kBAAkB;CAClB,mBAAmB;CACnB,kBAAkB;CAClB,oBAAoB;CACpB,iBAAiB;CACjB,iBAAiB;CACjB,oBAAoB;CACpB,kBAAkB;CAClB,gBAAgB;CAChB,mBAAmB;CACnB,oBAAoB;CACpB,6BAA6B;CAC7B,kBAAkB;CAClB,uBAAuB;CACvB,sBAAsB;CACtB,yBAAyB;CACzB,kBAAkB;CAClB,qBAAqB;CACrB,kBAAkB;CAClB,qBAAqB;CACrB,iBAAiB;CACjB,iBAAiB;CACjB,uBAAuB;CACvB,kBAAkB;CAClB,gBAAgB;CAChB,gBAAgB;CAChB,iBAAiB;CACjB,qBAAqB;CACrB,mBAAmB;CACnB,kBAAkB;CAClB,sBAAsB;CACtB,6BAA6B;CAC7B,0BAA0B;CAC1B,4BAA4B;CAC5B,0BAA0B;CAC1B,gBAAgB;CAChB,iBAAiB;CACjB,iBAAiB;CACjB,qBAAqB;CACrB,6BAA6B;CAC7B,gBAAgB;CAChB,sBAAsB;CACtB,qBAAqB;CACrB,kBAAkB;AACpB,EACF;AAEA,SAAgB,YAAY,SAAqB,CAAC,GAAG;CACnD,OAAO,mBAAmB,MAAM;AAClC"}

package/dist/i18n.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from './core/inject';
 export * from './services/loadMap';
 export * from './services/actionInput';
 export * from './services/pointerContext';
+export * from './services/interactions';
 export * from './module';
 export * from './Gui/Gui';
 export * from './components/gui';
@@ -27,5 +28,7 @@ export { RpgClientObject } from './Game/Object';
 export { RpgClientPlayer } from './Game/Player';
 export { RpgClientEvent } from './Game/Event';
 export * from './Game/ProjectileManager';
+export * from './Game/ClientVisuals';
 export { withMobile } from './components/gui/mobile';
 export * from './services/AbstractSocket';
+export * from './i18n';

package/dist/index.js

@@ -1,7 +1,7 @@
 import { Context } from "./node_modules/.pnpm/@signe_di@3.0.1/node_modules/@signe/di/dist/index.js";
 import { clearInject, context, inject, setInject } from "./core/inject.js";
 import { AbstractWebsocket, WebSocketToken } from "./services/AbstractSocket.js";
-import { getKeyboardControlBind, isKeyboardActionConfig, normalizeActionInput, resolveKeyboardActionInput } from "./services/actionInput.js";
+import { getKeyboardControlBind, isKeyboardActionConfig, keyboardEventMatchesBind, normalizeActionInput, resolveKeyboardActionInput, resolveKeyboardDirectionInput } from "./services/actionInput.js";
 import __ce_component$2 from "./components/gui/dialogbox/index.ce.js";
 import __ce_component from "./components/gui/box.ce.js";
 import __ce_component$16 from "./components/gui/shop/shop.ce.js";
@@ -30,7 +30,10 @@ import { RpgClientEvent } from "./Game/Event.js";
 import { GlobalConfigToken, provideClientGlobalConfig, provideClientModules, provideGlobalConfig } from "./module.js";
 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";
@@ -46,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, 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, normalizeActionInput, provideClientGlobalConfig, provideClientModules, provideGlobalConfig, provideLoadMap, provideMmorpg, provideRpg, provideSaveClient, resolveKeyboardActionInput, 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) => {
@@ -112,6 +113,12 @@ function provideClientModules(modules) {
 					});
 				} };
 			}
+			if (module.clientVisuals) {
+				const clientVisuals = { ...module.clientVisuals };
+				module.clientVisuals = { load: (engine) => {
+					engine.registerClientVisuals(clientVisuals);
+				} };
+			}
 			if (module.projectiles) {
 				const projectiles = { ...module.projectiles };
 				module.projectiles = {
@@ -123,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) => {
@@ -158,6 +182,7 @@ function provideClientModules(modules) {
 						if (sprite.components) Object.entries(sprite.components).forEach(([id, component]) => {
 							engine.registerSpriteComponent(id, component);
 						});
+						if (sprite.eventComponent) engine.addEventComponentResolver(sprite.eventComponent);
 					}
 				};
 			}
@@ -174,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.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          },\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/actionInput.d.ts

@@ -1,4 +1,4 @@
-import { RpgActionInput, RpgActionName } from '@rpgjs/common';
+import { Direction, RpgActionInput, RpgActionName } from '@rpgjs/common';
 export type KeyboardActionDataResolver<TClient = any, TSprite = any> = (client: TClient, sprite: TSprite) => any;
 export interface KeyboardActionConfig<TClient = any, TSprite = any> {
     bind: any;
@@ -9,4 +9,6 @@ export declare function normalizeActionInput(action: RpgActionName, data?: any):
 export declare function normalizeActionInput(action: RpgActionInput): RpgActionInput;
 export declare function isKeyboardActionConfig(value: any): value is KeyboardActionConfig;
 export declare function getKeyboardControlBind(control: any): any;
+export declare function keyboardEventMatchesBind(event: KeyboardEvent, bind: any): boolean;
 export declare function resolveKeyboardActionInput(control: any, client: any, sprite: any, defaultAction?: RpgActionName): RpgActionInput;
+export declare function resolveKeyboardDirectionInput(event: KeyboardEvent, keyboardControls: any): Direction | undefined;

package/dist/services/actionInput.js

@@ -1,3 +1,4 @@
+import { Direction } from "@rpgjs/common";
 //#region src/services/actionInput.ts
 function normalizeActionInput(action, data) {
 	if (typeof action === "object") return action;
@@ -12,6 +13,28 @@ function isKeyboardActionConfig(value) {
 function getKeyboardControlBind(control) {
 	return isKeyboardActionConfig(control) ? control.bind : control;
 }
+var KEY_CODE_NAMES = {
+	32: "space",
+	27: "escape",
+	37: "left",
+	38: "up",
+	39: "right",
+	40: "down"
+};
+var normalizeKeyboardName = (value) => {
+	if (typeof value !== "string") return void 0;
+	const normalized = value.toLowerCase();
+	if (normalized === " " || normalized === "spacebar" || normalized === "space") return "space";
+	if (normalized.startsWith("arrow")) return normalized.slice(5);
+	return normalized;
+};
+function keyboardEventMatchesBind(event, bind) {
+	if (Array.isArray(bind)) return bind.some((item) => keyboardEventMatchesBind(event, item));
+	if (typeof bind === "number") return event.keyCode === bind;
+	const expected = normalizeKeyboardName(bind);
+	if (!expected) return false;
+	return normalizeKeyboardName(event.key) === expected || normalizeKeyboardName(event.code) === expected || KEY_CODE_NAMES[event.keyCode] === expected;
+}
 function resolveKeyboardActionInput(control, client, sprite, defaultAction = "action") {
 	if (!isKeyboardActionConfig(control)) return { action: defaultAction };
 	const action = control.action ?? defaultAction;
@@ -21,7 +44,16 @@ function resolveKeyboardActionInput(control, client, sprite, defaultAction = "ac
 		data
 	};
 }
+function resolveKeyboardDirectionInput(event, keyboardControls) {
+	const directions = [
+		[keyboardControls?.up, Direction.Up],
+		[keyboardControls?.down, Direction.Down],
+		[keyboardControls?.left, Direction.Left],
+		[keyboardControls?.right, Direction.Right]
+	];
+	for (const [control, direction] of directions) if (keyboardEventMatchesBind(event, getKeyboardControlBind(control))) return direction;
+}
 //#endregion
-export { getKeyboardControlBind, isKeyboardActionConfig, normalizeActionInput, resolveKeyboardActionInput };
+export { getKeyboardControlBind, isKeyboardActionConfig, keyboardEventMatchesBind, normalizeActionInput, resolveKeyboardActionInput, resolveKeyboardDirectionInput };
 
 //# sourceMappingURL=actionInput.js.map

package/dist/services/actionInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"actionInput.js","names":[],"sources":["../../src/services/actionInput.ts"],"sourcesContent":["import type { RpgActionInput, RpgActionName } from \"@rpgjs/common\";\n\nexport type KeyboardActionDataResolver<TClient = any, TSprite = any> = (\n  client: TClient,\n  sprite: TSprite,\n) => any;\n\nexport interface KeyboardActionConfig<TClient = any, TSprite = any> {\n  bind: any;\n  action?: RpgActionName;\n  data?: any | KeyboardActionDataResolver<TClient, TSprite>;\n}\n\nexport function normalizeActionInput(action: RpgActionName, data?: any): RpgActionInput;\nexport function normalizeActionInput(action: RpgActionInput): RpgActionInput;\nexport function normalizeActionInput(action: RpgActionName | RpgActionInput, data?: any): RpgActionInput {\n  if (typeof action === \"object\") {\n    return action;\n  }\n  return data === undefined\n    ? { action }\n    : { action, data };\n}\n\nexport function isKeyboardActionConfig(value: any): value is KeyboardActionConfig {\n  return value !== null\n    && typeof value === \"object\"\n    && Object.prototype.hasOwnProperty.call(value, \"bind\");\n}\n\nexport function getKeyboardControlBind(control: any): any {\n  return isKeyboardActionConfig(control) ? control.bind : control;\n}\n\nexport function resolveKeyboardActionInput(\n  control: any,\n  client: any,\n  sprite: any,\n  defaultAction: RpgActionName = \"action\",\n): RpgActionInput {\n  if (!isKeyboardActionConfig(control)) {\n    return { action: defaultAction };\n  }\n\n  const action = control.action ?? defaultAction;\n  const data = typeof control.data === \"function\"\n    ? control.data(client, sprite)\n    : control.data;\n\n  return data === undefined\n    ? { action }\n    : { action, data };\n}\n"],"mappings":";AAeA,SAAgB,qBAAqB,QAAwC,MAA4B;CACvG,IAAI,OAAO,WAAW,UACpB,OAAO;CAET,OAAO,SAAS,KAAA,IACZ,EAAE,OAAO,IACT;EAAE;EAAQ;CAAK;AACrB;AAEA,SAAgB,uBAAuB,OAA2C;CAChF,OAAO,UAAU,QACZ,OAAO,UAAU,YACjB,OAAO,UAAU,eAAe,KAAK,OAAO,MAAM;AACzD;AAEA,SAAgB,uBAAuB,SAAmB;CACxD,OAAO,uBAAuB,OAAO,IAAI,QAAQ,OAAO;AAC1D;AAEA,SAAgB,2BACd,SACA,QACA,QACA,gBAA+B,UACf;CAChB,IAAI,CAAC,uBAAuB,OAAO,GACjC,OAAO,EAAE,QAAQ,cAAc;CAGjC,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,OAAO,OAAO,QAAQ,SAAS,aACjC,QAAQ,KAAK,QAAQ,MAAM,IAC3B,QAAQ;CAEZ,OAAO,SAAS,KAAA,IACZ,EAAE,OAAO,IACT;EAAE;EAAQ;CAAK;AACrB"}
+{"version":3,"file":"actionInput.js","names":[],"sources":["../../src/services/actionInput.ts"],"sourcesContent":["import { Direction, type RpgActionInput, type RpgActionName } from \"@rpgjs/common\";\n\nexport type KeyboardActionDataResolver<TClient = any, TSprite = any> = (\n  client: TClient,\n  sprite: TSprite,\n) => any;\n\nexport interface KeyboardActionConfig<TClient = any, TSprite = any> {\n  bind: any;\n  action?: RpgActionName;\n  data?: any | KeyboardActionDataResolver<TClient, TSprite>;\n}\n\nexport function normalizeActionInput(action: RpgActionName, data?: any): RpgActionInput;\nexport function normalizeActionInput(action: RpgActionInput): RpgActionInput;\nexport function normalizeActionInput(action: RpgActionName | RpgActionInput, data?: any): RpgActionInput {\n  if (typeof action === \"object\") {\n    return action;\n  }\n  return data === undefined\n    ? { action }\n    : { action, data };\n}\n\nexport function isKeyboardActionConfig(value: any): value is KeyboardActionConfig {\n  return value !== null\n    && typeof value === \"object\"\n    && Object.prototype.hasOwnProperty.call(value, \"bind\");\n}\n\nexport function getKeyboardControlBind(control: any): any {\n  return isKeyboardActionConfig(control) ? control.bind : control;\n}\n\nconst KEY_CODE_NAMES: Record<number, string> = {\n  32: \"space\",\n  27: \"escape\",\n  37: \"left\",\n  38: \"up\",\n  39: \"right\",\n  40: \"down\",\n};\n\nconst normalizeKeyboardName = (value: unknown): string | undefined => {\n  if (typeof value !== \"string\") return undefined;\n  const normalized = value.toLowerCase();\n  if (\n    normalized === \" \" ||\n    normalized === \"spacebar\" ||\n    normalized === \"space\"\n  ) {\n    return \"space\";\n  }\n  if (normalized.startsWith(\"arrow\")) {\n    return normalized.slice(\"arrow\".length);\n  }\n  return normalized;\n};\n\nexport function keyboardEventMatchesBind(\n  event: KeyboardEvent,\n  bind: any\n): boolean {\n  if (Array.isArray(bind)) {\n    return bind.some(item => keyboardEventMatchesBind(event, item));\n  }\n\n  if (typeof bind === \"number\") {\n    return event.keyCode === bind;\n  }\n\n  const expected = normalizeKeyboardName(bind);\n  if (!expected) return false;\n\n  return (\n    normalizeKeyboardName(event.key) === expected ||\n    normalizeKeyboardName(event.code) === expected ||\n    KEY_CODE_NAMES[event.keyCode] === expected\n  );\n}\n\nexport function resolveKeyboardActionInput(\n  control: any,\n  client: any,\n  sprite: any,\n  defaultAction: RpgActionName = \"action\",\n): RpgActionInput {\n  if (!isKeyboardActionConfig(control)) {\n    return { action: defaultAction };\n  }\n\n  const action = control.action ?? defaultAction;\n  const data = typeof control.data === \"function\"\n    ? control.data(client, sprite)\n    : control.data;\n\n  return data === undefined\n    ? { action }\n    : { action, data };\n}\n\nexport function resolveKeyboardDirectionInput(\n  event: KeyboardEvent,\n  keyboardControls: any\n): Direction | undefined {\n  const directions: Array<[any, Direction]> = [\n    [keyboardControls?.up, Direction.Up],\n    [keyboardControls?.down, Direction.Down],\n    [keyboardControls?.left, Direction.Left],\n    [keyboardControls?.right, Direction.Right],\n  ];\n\n  for (const [control, direction] of directions) {\n    if (keyboardEventMatchesBind(event, getKeyboardControlBind(control))) {\n      return direction;\n    }\n  }\n\n  return undefined;\n}\n"],"mappings":";;AAeA,SAAgB,qBAAqB,QAAwC,MAA4B;CACvG,IAAI,OAAO,WAAW,UACpB,OAAO;CAET,OAAO,SAAS,KAAA,IACZ,EAAE,OAAO,IACT;EAAE;EAAQ;CAAK;AACrB;AAEA,SAAgB,uBAAuB,OAA2C;CAChF,OAAO,UAAU,QACZ,OAAO,UAAU,YACjB,OAAO,UAAU,eAAe,KAAK,OAAO,MAAM;AACzD;AAEA,SAAgB,uBAAuB,SAAmB;CACxD,OAAO,uBAAuB,OAAO,IAAI,QAAQ,OAAO;AAC1D;AAEA,IAAM,iBAAyC;CAC7C,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;AAEA,IAAM,yBAAyB,UAAuC;CACpE,IAAI,OAAO,UAAU,UAAU,OAAO,KAAA;CACtC,MAAM,aAAa,MAAM,YAAY;CACrC,IACE,eAAe,OACf,eAAe,cACf,eAAe,SAEf,OAAO;CAET,IAAI,WAAW,WAAW,OAAO,GAC/B,OAAO,WAAW,MAAM,CAAc;CAExC,OAAO;AACT;AAEA,SAAgB,yBACd,OACA,MACS;CACT,IAAI,MAAM,QAAQ,IAAI,GACpB,OAAO,KAAK,MAAK,SAAQ,yBAAyB,OAAO,IAAI,CAAC;CAGhE,IAAI,OAAO,SAAS,UAClB,OAAO,MAAM,YAAY;CAG3B,MAAM,WAAW,sBAAsB,IAAI;CAC3C,IAAI,CAAC,UAAU,OAAO;CAEtB,OACE,sBAAsB,MAAM,GAAG,MAAM,YACrC,sBAAsB,MAAM,IAAI,MAAM,YACtC,eAAe,MAAM,aAAa;AAEtC;AAEA,SAAgB,2BACd,SACA,QACA,QACA,gBAA+B,UACf;CAChB,IAAI,CAAC,uBAAuB,OAAO,GACjC,OAAO,EAAE,QAAQ,cAAc;CAGjC,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,OAAO,OAAO,QAAQ,SAAS,aACjC,QAAQ,KAAK,QAAQ,MAAM,IAC3B,QAAQ;CAEZ,OAAO,SAAS,KAAA,IACZ,EAAE,OAAO,IACT;EAAE;EAAQ;CAAK;AACrB;AAEA,SAAgB,8BACd,OACA,kBACuB;CACvB,MAAM,aAAsC;EAC1C,CAAC,kBAAkB,IAAI,UAAU,EAAE;EACnC,CAAC,kBAAkB,MAAM,UAAU,IAAI;EACvC,CAAC,kBAAkB,MAAM,UAAU,IAAI;EACvC,CAAC,kBAAkB,OAAO,UAAU,KAAK;CAC3C;CAEA,KAAK,MAAM,CAAC,SAAS,cAAc,YACjC,IAAI,yBAAyB,OAAO,uBAAuB,OAAO,CAAC,GACjE,OAAO;AAKb"}

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 {};