@rpgjs/action-battle 5.0.0-beta.1 → 5.0.0-beta.11

package/src/types.ts

@@ -1,9 +1,63 @@
+import type {
+  ActionBattleAiBehavior,
+  ActionBattleCombatSystem,
+  ActionBattleHitHooks,
+  ActionBattleHitbox,
+} from "./core/contracts";
+
 export type ActionBattleAoeMask = string[] | string;
 
 export type ActionBattleActionBarMode = "items" | "skills" | "both";
 
 export type ActionBattleTargetingAffects = "events" | "players" | "both";
 
+export type ActionBattleAnimationKey =
+  | "attack"
+  | "hurt"
+  | "die"
+  | "castSkill"
+  | "castSpell";
+
+export type ActionBattleAnimationResult =
+  | string
+  | {
+      animationName?: string;
+      graphic?: string | string[];
+      repeat?: number;
+      waitEnd?: boolean;
+      delayMs?: number;
+    }
+  | null
+  | undefined;
+
+export type ActionBattleAnimationEntity = {
+  setGraphicAnimation(animationName: string, repeat: number): void;
+  setGraphicAnimation(
+    animationName: string,
+    graphic: string | string[],
+    repeat: number
+  ): void;
+  [key: string]: any;
+};
+
+export interface ActionBattleAnimationContext {
+  skill?: any;
+  attacker?: ActionBattleAnimationEntity;
+  target?: ActionBattleAnimationEntity;
+}
+
+export type ActionBattleAnimationResolver = (
+  entity: ActionBattleAnimationEntity,
+  context?: ActionBattleAnimationContext
+) => ActionBattleAnimationResult;
+
+export type ActionBattleAnimationOptions = Partial<
+  Record<
+    ActionBattleAnimationKey,
+    ActionBattleAnimationResult | ActionBattleAnimationResolver
+  >
+>;
+
 export interface ActionBattleSkillTargeting {
   range: number;
   aoeMask?: ActionBattleAoeMask;
@@ -35,6 +89,61 @@ export interface ActionBattleUiOptions {
   targeting?: ActionBattleUiTargetingOptions;
 }
 
+export type ActionBattleAttackDirection =
+  | "up"
+  | "down"
+  | "left"
+  | "right"
+  | "default";
+
+export interface ActionBattleAttackHitboxConfig {
+  offsetX: number;
+  offsetY: number;
+  width: number;
+  height: number;
+}
+
+export type ActionBattleAttackHitboxMap = Partial<
+  Record<ActionBattleAttackDirection, ActionBattleAttackHitboxConfig>
+>;
+
+export type ActionBattleAttackHitPolicy =
+  | "oncePerTarget"
+  | "allowRepeatHits";
+
+export interface ActionBattleHitReactionProfile {
+  invincibilityMs?: number;
+  hitstunMs?: number;
+  staggerPower?: number;
+}
+
+export interface NormalizedActionBattleHitReactionProfile {
+  invincibilityMs: number;
+  hitstunMs: number;
+  staggerPower: number;
+}
+
+export interface ActionBattleAttackProfile {
+  id?: string;
+  startupMs?: number;
+  activeMs?: number;
+  recoveryMs?: number;
+  cooldownMs?: number;
+  movementLock?: boolean;
+  directionLock?: boolean;
+  animationKey?: ActionBattleAnimationKey;
+  hitPolicy?: ActionBattleAttackHitPolicy;
+  reaction?: ActionBattleHitReactionProfile;
+  hitboxes?: ActionBattleAttackHitboxMap;
+}
+
+export interface NormalizedActionBattleAttackProfile
+  extends Required<Omit<ActionBattleAttackProfile, "hitboxes" | "reaction">> {
+  reaction: NormalizedActionBattleHitReactionProfile;
+  hitboxes?: ActionBattleAttackHitboxMap;
+  totalDurationMs: number;
+}
+
 export interface ActionBattleSkillOptions {
   getTargeting?: ActionBattleSkillTargetingResolver;
   defaultAoeMask?: ActionBattleAoeMask;
@@ -45,10 +154,49 @@ export interface ActionBattleTargetingOptions {
   allowEmptyTarget?: boolean;
 }
 
+export interface ActionBattleDebugOptions {
+  attacks?: boolean;
+}
+
+export interface ActionBattleAttackOptions {
+  profile?: ActionBattleAttackProfile;
+  lockMovement?: boolean;
+  lockDurationMs?: number;
+  showPreview?: boolean;
+  previewDurationMs?: number;
+  previewColor?: number;
+  previewAccentColor?: number;
+  hitboxes?: ActionBattleAttackHitboxMap;
+  resolveHitboxes?: (context: {
+    player: any;
+    direction: string;
+    defaultHitboxes: ActionBattleHitbox[];
+  }) => ActionBattleHitbox[];
+}
+
+export interface ActionBattleCombatOptions {
+  damage?: ActionBattleCombatSystem["resolveDamage"];
+  knockback?: ActionBattleCombatSystem["resolveKnockback"];
+  hooks?: ActionBattleHitHooks;
+}
+
+export interface ActionBattleAiSystemOptions {
+  behaviors?: Record<string, ActionBattleAiBehavior>;
+}
+
+export interface ActionBattleSystemOptions {
+  combat?: ActionBattleCombatOptions;
+  ai?: ActionBattleAiSystemOptions;
+}
+
 export interface ActionBattleOptions {
   ui?: ActionBattleUiOptions;
   skills?: ActionBattleSkillOptions;
   targeting?: ActionBattleTargetingOptions;
+  attack?: ActionBattleAttackOptions;
+  debug?: ActionBattleDebugOptions;
+  animations?: ActionBattleAnimationOptions;
+  systems?: ActionBattleSystemOptions;
 }
 
 export interface ActionBattleActionBarItem {

package/src/ui/state.ts

@@ -2,6 +2,16 @@ import { signal } from "canvasengine";
 import { ActionBattleActionBarSkill, ActionBattleOptions } from "../types";
 import { DEFAULT_ACTION_BATTLE_OPTIONS, normalizeActionBattleOptions } from "../config";
 
+export interface ActionBattleAttackPreviewState {
+  active: boolean;
+  id: number;
+  direction: string;
+  startedAt: number;
+  durationMs: number;
+  color: number;
+  accentColor: number;
+}
+
 export interface ActionBattleTargetingState {
   active: boolean;
   skill: ActionBattleActionBarSkill | null;
@@ -18,6 +28,16 @@ const defaultTargetingState: ActionBattleTargetingState = {
   aoeMask: DEFAULT_ACTION_BATTLE_OPTIONS.skills?.defaultAoeMask || ["#"],
 };
 
+const defaultAttackPreviewState: ActionBattleAttackPreviewState = {
+  active: false,
+  id: 0,
+  direction: "down",
+  startedAt: 0,
+  durationMs: 180,
+  color: 0xfff3b0,
+  accentColor: 0xffffff,
+};
+
 export const actionBattleUiOptions = signal(
   normalizeActionBattleOptions({}).ui || {}
 );
@@ -28,6 +48,10 @@ export const actionBattleSkillOptions = signal(
 export const actionBattleTargetingState = signal<ActionBattleTargetingState>({
   ...defaultTargetingState,
 });
+export const actionBattleAttackPreviewState =
+  signal<ActionBattleAttackPreviewState>({
+    ...defaultAttackPreviewState,
+  });
 
 export const setActionBattleOptions = (options: ActionBattleOptions = {}) => {
   const normalized = normalizeActionBattleOptions(options);
@@ -66,3 +90,36 @@ export const moveTargetingOffset = (dx: number, dy: number) => {
     offset: next,
   });
 };
+
+export const startAttackPreview = (options: {
+  direction: string;
+  durationMs?: number;
+  color?: number;
+  accentColor?: number;
+}) => {
+  const current = actionBattleAttackPreviewState();
+  const id = current.id + 1;
+  const durationMs = Math.max(
+    1,
+    options.durationMs ?? defaultAttackPreviewState.durationMs
+  );
+  actionBattleAttackPreviewState.set({
+    active: true,
+    id,
+    direction: options.direction,
+    startedAt: Date.now(),
+    durationMs,
+    color: options.color ?? defaultAttackPreviewState.color,
+    accentColor: options.accentColor ?? defaultAttackPreviewState.accentColor,
+  });
+  return id;
+};
+
+export const stopAttackPreview = (id?: number) => {
+  const current = actionBattleAttackPreviewState();
+  if (id !== undefined && current.id !== id) return;
+  actionBattleAttackPreviewState.set({
+    ...current,
+    active: false,
+  });
+};

package/dist/index.d.ts

@@ -1,11 +0,0 @@
-import { ActionBattleOptions } from './types';
-export { BattleAi, AiState, EnemyType, AttackPattern, AiDebug, DEFAULT_KNOCKBACK } from './ai.server';
-export type { HitResult, ApplyHitHooks } from './ai.server';
-export type { ActionBattleOptions, ActionBattleActionBarData, ActionBattleActionBarItem, ActionBattleActionBarSkill, ActionBattleSkillTargeting, ActionBattleSkillTargetingResolver, ActionBattleUiOptions, ActionBattleUiActionBarOptions, ActionBattleUiTargetingOptions, } from './types';
-export { DEFAULT_PLAYER_ATTACK_HITBOXES, getPlayerWeaponKnockbackForce, applyPlayerHitToEvent, ACTION_BATTLE_ACTION_BAR_GUI_ID, openActionBattleActionBar, updateActionBattleActionBar, createActionBattleServer, } from './server';
-export declare function provideActionBattle(options?: ActionBattleOptions): any;
-declare const _default: {
-    server: any;
-    client: any;
-};
-export default _default;

package/dist/ui/state.d.ts

@@ -1,18 +0,0 @@
-import { ActionBattleActionBarSkill, ActionBattleOptions } from '../types';
-export interface ActionBattleTargetingState {
-    active: boolean;
-    skill: ActionBattleActionBarSkill | null;
-    range: number;
-    offset: {
-        x: number;
-        y: number;
-    };
-    aoeMask: string[] | string;
-}
-export declare const actionBattleUiOptions: any;
-export declare const actionBattleSkillOptions: any;
-export declare const actionBattleTargetingState: any;
-export declare const setActionBattleOptions: (options?: ActionBattleOptions) => void;
-export declare const startTargeting: (skill: ActionBattleActionBarSkill) => void;
-export declare const stopTargeting: () => void;
-export declare const moveTargetingOffset: (dx: number, dy: number) => void;