@rpgjs/client 5.0.0-beta.2 → 5.0.0-beta.22

package/dist/services/actionInput.d.ts

@@ -0,0 +1,14 @@
+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;
+    action?: RpgActionName;
+    data?: any | KeyboardActionDataResolver<TClient, TSprite>;
+}
+export declare function normalizeActionInput(action: RpgActionName, data?: any): RpgActionInput;
+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

@@ -0,0 +1,59 @@
+import { Direction } from "@rpgjs/common";
+//#region src/services/actionInput.ts
+function normalizeActionInput(action, data) {
+	if (typeof action === "object") return action;
+	return data === void 0 ? { action } : {
+		action,
+		data
+	};
+}
+function isKeyboardActionConfig(value) {
+	return value !== null && typeof value === "object" && Object.prototype.hasOwnProperty.call(value, "bind");
+}
+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;
+	const data = typeof control.data === "function" ? control.data(client, sprite) : control.data;
+	return data === void 0 ? { action } : {
+		action,
+		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, keyboardEventMatchesBind, normalizeActionInput, resolveKeyboardActionInput, resolveKeyboardDirectionInput };
+
+//# sourceMappingURL=actionInput.js.map

package/dist/services/actionInput.js.map

@@ -0,0 +1 @@
+{"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/actionInput.spec.d.ts

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

package/dist/services/cameraFollow.d.ts

@@ -0,0 +1,51 @@
+export declare const DEFAULT_CAMERA_FOLLOW_TIME = 1000;
+export declare const DEFAULT_CAMERA_FOLLOW_EASE = "easeInOutSine";
+export declare const CAMERA_FOLLOW_EASES: readonly ["linear", "easeInQuad", "easeOutQuad", "easeInOutQuad", "easeInCubic", "easeOutCubic", "easeInOutCubic", "easeInQuart", "easeOutQuart", "easeInOutQuart", "easeInQuint", "easeOutQuint", "easeInOutQuint", "easeInSine", "easeOutSine", "easeInOutSine", "easeInExpo", "easeOutExpo", "easeInOutExpo", "easeInCirc", "easeOutCirc", "easeInOutCirc", "easeInElastic", "easeOutElastic", "easeInOutElastic", "easeInBack", "easeOutBack", "easeInOutBack", "easeInBounce", "easeOutBounce", "easeInOutBounce"];
+export type CameraFollowEase = typeof CAMERA_FOLLOW_EASES[number];
+export type CameraFollowSmoothMoveOptions = {
+    /** Enable or disable the smooth transition when options are sent as an object. */
+    enabled?: boolean;
+    /** Duration of the transition to the new camera target, in milliseconds. */
+    time?: number;
+    /** pixi-viewport easing name, for example "easeInOutQuad". */
+    ease?: CameraFollowEase;
+    /** Continuous follow speed after the transition. 0 keeps the target centered instantly. */
+    speed?: number;
+    /** Continuous follow acceleration after the transition. */
+    acceleration?: number | null;
+    /** Center radius where the followed target can move without moving the viewport. */
+    radius?: number | null;
+};
+export type CameraFollowSmoothMove = boolean | CameraFollowSmoothMoveOptions;
+export type CameraFollowTarget = {
+    x: number;
+    y: number;
+    destroyed?: boolean;
+} | null | undefined;
+export type CameraFollowPosition = {
+    x: number;
+    y: number;
+};
+export interface CameraFollowApplyContext {
+    viewport: any;
+    target: CameraFollowTarget;
+    smoothMove: CameraFollowSmoothMove;
+    followRevision: number;
+    isCurrentRevision: (revision: number) => boolean;
+    shouldFollowCamera: () => boolean;
+}
+export declare const smoothMoveEnabled: (smoothMove: CameraFollowSmoothMove) => boolean;
+export declare const cameraFollowAnimationOptions: (smoothMove: CameraFollowSmoothMove) => {
+    time: number;
+    ease: "easeInOutSine" | "linear" | "easeInQuad" | "easeOutQuad" | "easeInOutQuad" | "easeInCubic" | "easeOutCubic" | "easeInOutCubic" | "easeInQuart" | "easeOutQuart" | "easeInOutQuart" | "easeInQuint" | "easeOutQuint" | "easeInOutQuint" | "easeInSine" | "easeOutSine" | "easeInExpo" | "easeOutExpo" | "easeInOutExpo" | "easeInCirc" | "easeOutCirc" | "easeInOutCirc" | "easeInElastic" | "easeOutElastic" | "easeInOutElastic" | "easeInBack" | "easeOutBack" | "easeInOutBack" | "easeInBounce" | "easeOutBounce" | "easeInOutBounce";
+} | null;
+export declare const cameraFollowOptions: (smoothMove: CameraFollowSmoothMove) => {
+    speed?: number;
+    acceleration?: number | null;
+    radius?: number | null;
+} | undefined;
+export declare const clearCameraFollowPlugins: (viewport: any) => void;
+export declare const ownsCameraFollowRevision: (appliedRevision: number | null, currentRevision: number) => boolean;
+export declare const readCameraFollowPosition: (target: CameraFollowTarget) => CameraFollowPosition | null;
+export declare const followCameraInstantly: (viewport: any, target: CameraFollowTarget, smoothMove: CameraFollowSmoothMove) => boolean;
+export declare const applyCameraFollow: ({ viewport, target, smoothMove, followRevision, isCurrentRevision, shouldFollowCamera, }: CameraFollowApplyContext) => boolean;

package/dist/services/cameraFollow.js

@@ -0,0 +1,134 @@
+//#region src/services/cameraFollow.ts
+var DEFAULT_CAMERA_FOLLOW_TIME = 1e3;
+var DEFAULT_CAMERA_FOLLOW_EASE = "easeInOutSine";
+var CAMERA_FOLLOW_EASES = [
+	"linear",
+	"easeInQuad",
+	"easeOutQuad",
+	"easeInOutQuad",
+	"easeInCubic",
+	"easeOutCubic",
+	"easeInOutCubic",
+	"easeInQuart",
+	"easeOutQuart",
+	"easeInOutQuart",
+	"easeInQuint",
+	"easeOutQuint",
+	"easeInOutQuint",
+	"easeInSine",
+	"easeOutSine",
+	"easeInOutSine",
+	"easeInExpo",
+	"easeOutExpo",
+	"easeInOutExpo",
+	"easeInCirc",
+	"easeOutCirc",
+	"easeInOutCirc",
+	"easeInElastic",
+	"easeOutElastic",
+	"easeInOutElastic",
+	"easeInBack",
+	"easeOutBack",
+	"easeInOutBack",
+	"easeInBounce",
+	"easeOutBounce",
+	"easeInOutBounce"
+];
+var finiteNumber = (value, fallback) => {
+	return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+};
+var isCameraFollowEase = (value) => {
+	return typeof value === "string" && CAMERA_FOLLOW_EASES.includes(value);
+};
+var smoothMoveEnabled = (smoothMove) => {
+	if (smoothMove === false) return false;
+	if (typeof smoothMove === "object" && smoothMove !== null && smoothMove.enabled === false) return false;
+	return true;
+};
+var cameraFollowAnimationOptions = (smoothMove) => {
+	if (!smoothMoveEnabled(smoothMove)) return null;
+	const options = typeof smoothMove === "object" && smoothMove !== null ? smoothMove : {};
+	return {
+		time: Math.max(0, finiteNumber(options.time, DEFAULT_CAMERA_FOLLOW_TIME)),
+		ease: isCameraFollowEase(options.ease) ? options.ease : DEFAULT_CAMERA_FOLLOW_EASE
+	};
+};
+var cameraFollowOptions = (smoothMove) => {
+	if (typeof smoothMove !== "object" || smoothMove === null) return void 0;
+	const options = {};
+	if (typeof smoothMove.speed === "number" && Number.isFinite(smoothMove.speed)) options.speed = Math.max(0, smoothMove.speed);
+	if (typeof smoothMove.acceleration === "number" && Number.isFinite(smoothMove.acceleration)) options.acceleration = Math.max(0, smoothMove.acceleration);
+	else if (smoothMove.acceleration === null) options.acceleration = null;
+	if (typeof smoothMove.radius === "number" && Number.isFinite(smoothMove.radius)) options.radius = Math.max(0, smoothMove.radius);
+	else if (smoothMove.radius === null) options.radius = null;
+	return Object.keys(options).length > 0 ? options : void 0;
+};
+var clearCameraFollowPlugins = (viewport) => {
+	viewport?.plugins?.remove?.("animate");
+	viewport?.plugins?.remove?.("follow");
+};
+var ownsCameraFollowRevision = (appliedRevision, currentRevision) => {
+	return appliedRevision !== null && appliedRevision === currentRevision;
+};
+var readCameraFollowPosition = (target) => {
+	if (!target) return null;
+	try {
+		if (target.destroyed) return null;
+		const x = target.x;
+		const y = target.y;
+		if (!Number.isFinite(x) || !Number.isFinite(y)) return null;
+		return {
+			x,
+			y
+		};
+	} catch {
+		return null;
+	}
+};
+var createCameraFollowTarget = (target, initialPosition) => {
+	let lastPosition = initialPosition;
+	const readPosition = () => {
+		const nextPosition = readCameraFollowPosition(target);
+		if (nextPosition) lastPosition = nextPosition;
+		return lastPosition;
+	};
+	return {
+		get x() {
+			return readPosition().x;
+		},
+		get y() {
+			return readPosition().y;
+		}
+	};
+};
+var followCameraInstantly = (viewport, target, smoothMove) => {
+	const position = readCameraFollowPosition(target);
+	if (!position) return false;
+	const followTarget = createCameraFollowTarget(target, position);
+	const followOptions = cameraFollowOptions(smoothMove);
+	if (followOptions) viewport.follow(followTarget, followOptions);
+	else viewport.follow(followTarget);
+	return true;
+};
+var applyCameraFollow = ({ viewport, target, smoothMove, followRevision, isCurrentRevision, shouldFollowCamera }) => {
+	clearCameraFollowPlugins(viewport);
+	const position = readCameraFollowPosition(target);
+	if (!position) return false;
+	const animationOptions = cameraFollowAnimationOptions(smoothMove);
+	if (!animationOptions || animationOptions.time <= 0) return followCameraInstantly(viewport, target, smoothMove);
+	viewport.animate({
+		position,
+		time: animationOptions.time,
+		ease: animationOptions.ease,
+		callbackOnComplete: () => {
+			if (!isCurrentRevision(followRevision) || !shouldFollowCamera()) return;
+			if (!readCameraFollowPosition(target)) return;
+			followCameraInstantly(viewport, target, smoothMove);
+		}
+	});
+	return true;
+};
+//#endregion
+export { applyCameraFollow, clearCameraFollowPlugins, ownsCameraFollowRevision };
+
+//# sourceMappingURL=cameraFollow.js.map

package/dist/services/cameraFollow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraFollow.js","names":[],"sources":["../../src/services/cameraFollow.ts"],"sourcesContent":["export const DEFAULT_CAMERA_FOLLOW_TIME = 1000;\nexport const DEFAULT_CAMERA_FOLLOW_EASE = \"easeInOutSine\";\n\nexport const CAMERA_FOLLOW_EASES = [\n  \"linear\",\n  \"easeInQuad\",\n  \"easeOutQuad\",\n  \"easeInOutQuad\",\n  \"easeInCubic\",\n  \"easeOutCubic\",\n  \"easeInOutCubic\",\n  \"easeInQuart\",\n  \"easeOutQuart\",\n  \"easeInOutQuart\",\n  \"easeInQuint\",\n  \"easeOutQuint\",\n  \"easeInOutQuint\",\n  \"easeInSine\",\n  \"easeOutSine\",\n  \"easeInOutSine\",\n  \"easeInExpo\",\n  \"easeOutExpo\",\n  \"easeInOutExpo\",\n  \"easeInCirc\",\n  \"easeOutCirc\",\n  \"easeInOutCirc\",\n  \"easeInElastic\",\n  \"easeOutElastic\",\n  \"easeInOutElastic\",\n  \"easeInBack\",\n  \"easeOutBack\",\n  \"easeInOutBack\",\n  \"easeInBounce\",\n  \"easeOutBounce\",\n  \"easeInOutBounce\",\n] as const;\n\nexport type CameraFollowEase = typeof CAMERA_FOLLOW_EASES[number];\n\nexport type CameraFollowSmoothMoveOptions = {\n  /** Enable or disable the smooth transition when options are sent as an object. */\n  enabled?: boolean;\n  /** Duration of the transition to the new camera target, in milliseconds. */\n  time?: number;\n  /** pixi-viewport easing name, for example \"easeInOutQuad\". */\n  ease?: CameraFollowEase;\n  /** Continuous follow speed after the transition. 0 keeps the target centered instantly. */\n  speed?: number;\n  /** Continuous follow acceleration after the transition. */\n  acceleration?: number | null;\n  /** Center radius where the followed target can move without moving the viewport. */\n  radius?: number | null;\n};\n\nexport type CameraFollowSmoothMove = boolean | CameraFollowSmoothMoveOptions;\n\nexport type CameraFollowTarget = {\n  x: number;\n  y: number;\n  destroyed?: boolean;\n} | null | undefined;\n\nexport type CameraFollowPosition = {\n  x: number;\n  y: number;\n};\n\nexport interface CameraFollowApplyContext {\n  viewport: any;\n  target: CameraFollowTarget;\n  smoothMove: CameraFollowSmoothMove;\n  followRevision: number;\n  isCurrentRevision: (revision: number) => boolean;\n  shouldFollowCamera: () => boolean;\n}\n\nconst finiteNumber = (value: unknown, fallback: number) => {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : fallback;\n};\n\nconst isCameraFollowEase = (value: unknown): value is CameraFollowEase => {\n  return typeof value === \"string\" && (CAMERA_FOLLOW_EASES as readonly string[]).includes(value);\n};\n\nexport const smoothMoveEnabled = (smoothMove: CameraFollowSmoothMove) => {\n  if (smoothMove === false) return false;\n  if (typeof smoothMove === \"object\" && smoothMove !== null && smoothMove.enabled === false) {\n    return false;\n  }\n  return true;\n};\n\nexport const cameraFollowAnimationOptions = (\n  smoothMove: CameraFollowSmoothMove\n) => {\n  if (!smoothMoveEnabled(smoothMove)) return null;\n  const options = typeof smoothMove === \"object\" && smoothMove !== null ? smoothMove : {};\n  return {\n    time: Math.max(0, finiteNumber(options.time, DEFAULT_CAMERA_FOLLOW_TIME)),\n    ease: isCameraFollowEase(options.ease) ? options.ease : DEFAULT_CAMERA_FOLLOW_EASE,\n  };\n};\n\nexport const cameraFollowOptions = (smoothMove: CameraFollowSmoothMove) => {\n  if (typeof smoothMove !== \"object\" || smoothMove === null) return undefined;\n  const options: { speed?: number; acceleration?: number | null; radius?: number | null } = {};\n  if (typeof smoothMove.speed === \"number\" && Number.isFinite(smoothMove.speed)) {\n    options.speed = Math.max(0, smoothMove.speed);\n  }\n  if (typeof smoothMove.acceleration === \"number\" && Number.isFinite(smoothMove.acceleration)) {\n    options.acceleration = Math.max(0, smoothMove.acceleration);\n  } else if (smoothMove.acceleration === null) {\n    options.acceleration = null;\n  }\n  if (typeof smoothMove.radius === \"number\" && Number.isFinite(smoothMove.radius)) {\n    options.radius = Math.max(0, smoothMove.radius);\n  } else if (smoothMove.radius === null) {\n    options.radius = null;\n  }\n  return Object.keys(options).length > 0 ? options : undefined;\n};\n\nexport const clearCameraFollowPlugins = (viewport: any) => {\n  viewport?.plugins?.remove?.(\"animate\");\n  viewport?.plugins?.remove?.(\"follow\");\n};\n\nexport const ownsCameraFollowRevision = (\n  appliedRevision: number | null,\n  currentRevision: number\n) => {\n  return appliedRevision !== null && appliedRevision === currentRevision;\n};\n\nexport const readCameraFollowPosition = (\n  target: CameraFollowTarget\n): CameraFollowPosition | null => {\n  if (!target) return null;\n\n  try {\n    if (target.destroyed) return null;\n    const x = target.x;\n    const y = target.y;\n    if (!Number.isFinite(x) || !Number.isFinite(y)) return null;\n    return { x, y };\n  } catch {\n    return null;\n  }\n};\n\nconst createCameraFollowTarget = (\n  target: CameraFollowTarget,\n  initialPosition: CameraFollowPosition\n) => {\n  let lastPosition = initialPosition;\n\n  const readPosition = () => {\n    const nextPosition = readCameraFollowPosition(target);\n    if (nextPosition) {\n      lastPosition = nextPosition;\n    }\n    return lastPosition;\n  };\n\n  return {\n    get x() {\n      return readPosition().x;\n    },\n    get y() {\n      return readPosition().y;\n    },\n  };\n};\n\nexport const followCameraInstantly = (\n  viewport: any,\n  target: CameraFollowTarget,\n  smoothMove: CameraFollowSmoothMove\n) => {\n  const position = readCameraFollowPosition(target);\n  if (!position) return false;\n\n  const followTarget = createCameraFollowTarget(target, position);\n  const followOptions = cameraFollowOptions(smoothMove);\n  if (followOptions) {\n    viewport.follow(followTarget, followOptions);\n  } else {\n    viewport.follow(followTarget);\n  }\n  return true;\n};\n\nexport const applyCameraFollow = ({\n  viewport,\n  target,\n  smoothMove,\n  followRevision,\n  isCurrentRevision,\n  shouldFollowCamera,\n}: CameraFollowApplyContext) => {\n  clearCameraFollowPlugins(viewport);\n\n  const position = readCameraFollowPosition(target);\n  if (!position) return false;\n\n  const animationOptions = cameraFollowAnimationOptions(smoothMove);\n  if (!animationOptions || animationOptions.time <= 0) {\n    return followCameraInstantly(viewport, target, smoothMove);\n  }\n\n  viewport.animate({\n    position,\n    time: animationOptions.time,\n    ease: animationOptions.ease,\n    callbackOnComplete: () => {\n      if (!isCurrentRevision(followRevision) || !shouldFollowCamera()) return;\n      if (!readCameraFollowPosition(target)) return;\n      followCameraInstantly(viewport, target, smoothMove);\n    },\n  });\n  return true;\n};\n"],"mappings":"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"}

package/dist/services/cameraFollow.spec.d.ts

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

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