@bct-app/game-engine 0.1.6-beta.3 → 0.1.6-beta.4

package/dist/index.d.mts

@@ -10,6 +10,21 @@ type TApplyOperationToPlayersArgs = {
 };
 declare const applyOperationToPlayers: ({ players, operations, allAbilities, characters, timelines, timelineIndexAtNow, }: TApplyOperationToPlayersArgs) => TPlayer[];
 
+type TCanInvokeAbilityArgs = {
+    ability: TAbility;
+    effector: TPlayer | undefined;
+    currentTimelineIdx: number;
+    timelines: TTimeline[];
+    priorOperations?: TOperation[];
+};
+type TCanInvokeAbilityResult = {
+    allowed: true;
+} | {
+    allowed: false;
+    reason: string;
+};
+declare const canInvokeAbility: ({ ability, effector, currentTimelineIdx, timelines, priorOperations, }: TCanInvokeAbilityArgs) => TCanInvokeAbilityResult;
+
 declare const transformEmptyArray: <T>(arr: T[]) => T[];
 declare const copyPlayers: (players: TPlayer[]) => TPlayer[];
 declare const buildPlayerSeatMap: (players: TPlayer[]) => Map<number, TPlayer>;
@@ -42,4 +57,4 @@ declare const isReminder: (value: unknown) => value is TReminder;
  */
 declare const isPlayerReminderArray: (value: unknown) => value is TPlayerReminder[];
 
-export { adjustValueAsNumber, adjustValueAsNumberArray, applyOperationToPlayers, buildPlayerSeatMap, copyPlayers, getSourceValue, getValueFromPayloads, isNumberOrNumberArray, isPlayerReminderArray, isReminder, resolveSourceValue, transformEmptyArray };
+export { type TCanInvokeAbilityArgs, type TCanInvokeAbilityResult, adjustValueAsNumber, adjustValueAsNumberArray, applyOperationToPlayers, buildPlayerSeatMap, canInvokeAbility, copyPlayers, getSourceValue, getValueFromPayloads, isNumberOrNumberArray, isPlayerReminderArray, isReminder, resolveSourceValue, transformEmptyArray };

package/dist/index.d.ts

@@ -10,6 +10,21 @@ type TApplyOperationToPlayersArgs = {
 };
 declare const applyOperationToPlayers: ({ players, operations, allAbilities, characters, timelines, timelineIndexAtNow, }: TApplyOperationToPlayersArgs) => TPlayer[];
 
+type TCanInvokeAbilityArgs = {
+    ability: TAbility;
+    effector: TPlayer | undefined;
+    currentTimelineIdx: number;
+    timelines: TTimeline[];
+    priorOperations?: TOperation[];
+};
+type TCanInvokeAbilityResult = {
+    allowed: true;
+} | {
+    allowed: false;
+    reason: string;
+};
+declare const canInvokeAbility: ({ ability, effector, currentTimelineIdx, timelines, priorOperations, }: TCanInvokeAbilityArgs) => TCanInvokeAbilityResult;
+
 declare const transformEmptyArray: <T>(arr: T[]) => T[];
 declare const copyPlayers: (players: TPlayer[]) => TPlayer[];
 declare const buildPlayerSeatMap: (players: TPlayer[]) => Map<number, TPlayer>;
@@ -42,4 +57,4 @@ declare const isReminder: (value: unknown) => value is TReminder;
  */
 declare const isPlayerReminderArray: (value: unknown) => value is TPlayerReminder[];
 
-export { adjustValueAsNumber, adjustValueAsNumberArray, applyOperationToPlayers, buildPlayerSeatMap, copyPlayers, getSourceValue, getValueFromPayloads, isNumberOrNumberArray, isPlayerReminderArray, isReminder, resolveSourceValue, transformEmptyArray };
+export { type TCanInvokeAbilityArgs, type TCanInvokeAbilityResult, adjustValueAsNumber, adjustValueAsNumberArray, applyOperationToPlayers, buildPlayerSeatMap, canInvokeAbility, copyPlayers, getSourceValue, getValueFromPayloads, isNumberOrNumberArray, isPlayerReminderArray, isReminder, resolveSourceValue, transformEmptyArray };

package/dist/index.js

@@ -193,7 +193,7 @@ var createEffectHandler = (type, handler) => {
 };
 
 // src/effects/handlers/ability-change.ts
-var toAbilityIdList = (value) => {
+var toIdList = (value) => {
   if (typeof value === "string") {
     return value.length > 0 ? [value] : void 0;
   }
@@ -211,8 +211,8 @@ var applyAbilityChange = createEffectHandler("ABILITY_CHANGE", ({
   writableInputs,
   getSnapshotSeatMap,
   abilityMap,
-  makePlayersEffect,
-  characterMap
+  characterMap,
+  makePlayersEffect
 }) => {
   const resolvedRaw = resolveSourceValue(
     effect.source,
@@ -220,45 +220,49 @@ var applyAbilityChange = createEffectHandler("ABILITY_CHANGE", ({
     payloads,
     effector,
     getSnapshotSeatMap(),
-    (player) => player.abilities,
+    (player) => player.characterId,
     (value) => typeof value === "string" && value.length > 0 || Array.isArray(value) && value.every((item) => typeof item === "string"),
-    (characterId) => {
-      const character = characterMap.get(characterId);
-      if (!character) {
-        console.warn("Character not found for ABILITY_CHANGE effect source:", characterId);
-        return [];
-      }
-      return character.abilities.map((a) => a.id);
-    }
+    (characterId) => characterId
   );
-  const resolvedAbilityIds = toAbilityIdList(resolvedRaw);
-  if (!resolvedAbilityIds) {
-    console.warn("Ability ID not found for ABILITY_CHANGE effect:", effect.source);
+  const resolvedCharacterIds = toIdList(resolvedRaw);
+  if (!resolvedCharacterIds) {
+    console.warn("Character ID not found for ABILITY_CHANGE effect:", effect.source);
     return;
   }
+  const mode = effect.mode ?? "REPLACE";
   makePlayersEffect.forEach((player) => {
     const overrideRaw = operation.abilityChangeOverrides?.[String(player.seat)];
-    const overrideIds = toAbilityIdList(overrideRaw);
-    const finalAbilityIds = overrideIds ?? resolvedAbilityIds;
-    finalAbilityIds.forEach((finalAbilityId) => {
-      const newAbility = abilityMap.get(finalAbilityId);
-      if (!newAbility) {
-        console.warn("Ability not found for ABILITY_CHANGE effect:", finalAbilityId);
-        return;
-      }
-      const replaceAtSameStage = (abilities) => {
-        const idx = abilities.findIndex((aid) => abilityMap.get(aid)?.stage === newAbility.stage);
-        if (idx >= 0) {
-          abilities[idx] = finalAbilityId;
-        } else {
-          abilities.push(finalAbilityId);
+    const overrideIds = toIdList(overrideRaw);
+    const finalCharacterIds = overrideIds ?? resolvedCharacterIds;
+    if (!player.gainCharactersAbility) {
+      player.gainCharactersAbility = [];
+    }
+    if (mode === "REPLACE") {
+      player.gainCharactersAbility = [...finalCharacterIds];
+    } else {
+      for (const characterId of finalCharacterIds) {
+        if (!player.gainCharactersAbility.includes(characterId)) {
+          player.gainCharactersAbility.push(characterId);
         }
-      };
-      replaceAtSameStage(player.abilities);
-      if (player.perceivedCharacter?.asCharacter) {
-        replaceAtSameStage(player.perceivedCharacter.abilities);
       }
-    });
+    }
+    if (player.perceivedCharacter?.asCharacter) {
+      const perceived = player.perceivedCharacter;
+      finalCharacterIds.forEach((characterId) => {
+        const character = characterMap.get(characterId);
+        if (!character) return;
+        character.abilities.forEach((newAbility) => {
+          const idx = perceived.abilities.findIndex(
+            (aid) => abilityMap.get(aid)?.stage === newAbility.stage
+          );
+          if (idx >= 0) {
+            perceived.abilities[idx] = newAbility.id;
+          } else {
+            perceived.abilities.push(newAbility.id);
+          }
+        });
+      });
+    }
   });
 });
 

package/dist/index.mjs

@@ -155,7 +155,7 @@ var createEffectHandler = (type, handler) => {
 };
 
 // src/effects/handlers/ability-change.ts
-var toAbilityIdList = (value) => {
+var toIdList = (value) => {
   if (typeof value === "string") {
     return value.length > 0 ? [value] : void 0;
   }
@@ -173,8 +173,8 @@ var applyAbilityChange = createEffectHandler("ABILITY_CHANGE", ({
   writableInputs,
   getSnapshotSeatMap,
   abilityMap,
-  makePlayersEffect,
-  characterMap
+  characterMap,
+  makePlayersEffect
 }) => {
   const resolvedRaw = resolveSourceValue(
     effect.source,
@@ -182,45 +182,49 @@ var applyAbilityChange = createEffectHandler("ABILITY_CHANGE", ({
     payloads,
     effector,
     getSnapshotSeatMap(),
-    (player) => player.abilities,
+    (player) => player.characterId,
     (value) => typeof value === "string" && value.length > 0 || Array.isArray(value) && value.every((item) => typeof item === "string"),
-    (characterId) => {
-      const character = characterMap.get(characterId);
-      if (!character) {
-        console.warn("Character not found for ABILITY_CHANGE effect source:", characterId);
-        return [];
-      }
-      return character.abilities.map((a) => a.id);
-    }
+    (characterId) => characterId
   );
-  const resolvedAbilityIds = toAbilityIdList(resolvedRaw);
-  if (!resolvedAbilityIds) {
-    console.warn("Ability ID not found for ABILITY_CHANGE effect:", effect.source);
+  const resolvedCharacterIds = toIdList(resolvedRaw);
+  if (!resolvedCharacterIds) {
+    console.warn("Character ID not found for ABILITY_CHANGE effect:", effect.source);
     return;
   }
+  const mode = effect.mode ?? "REPLACE";
   makePlayersEffect.forEach((player) => {
     const overrideRaw = operation.abilityChangeOverrides?.[String(player.seat)];
-    const overrideIds = toAbilityIdList(overrideRaw);
-    const finalAbilityIds = overrideIds ?? resolvedAbilityIds;
-    finalAbilityIds.forEach((finalAbilityId) => {
-      const newAbility = abilityMap.get(finalAbilityId);
-      if (!newAbility) {
-        console.warn("Ability not found for ABILITY_CHANGE effect:", finalAbilityId);
-        return;
-      }
-      const replaceAtSameStage = (abilities) => {
-        const idx = abilities.findIndex((aid) => abilityMap.get(aid)?.stage === newAbility.stage);
-        if (idx >= 0) {
-          abilities[idx] = finalAbilityId;
-        } else {
-          abilities.push(finalAbilityId);
+    const overrideIds = toIdList(overrideRaw);
+    const finalCharacterIds = overrideIds ?? resolvedCharacterIds;
+    if (!player.gainCharactersAbility) {
+      player.gainCharactersAbility = [];
+    }
+    if (mode === "REPLACE") {
+      player.gainCharactersAbility = [...finalCharacterIds];
+    } else {
+      for (const characterId of finalCharacterIds) {
+        if (!player.gainCharactersAbility.includes(characterId)) {
+          player.gainCharactersAbility.push(characterId);
         }
-      };
-      replaceAtSameStage(player.abilities);
-      if (player.perceivedCharacter?.asCharacter) {
-        replaceAtSameStage(player.perceivedCharacter.abilities);
       }
-    });
+    }
+    if (player.perceivedCharacter?.asCharacter) {
+      const perceived = player.perceivedCharacter;
+      finalCharacterIds.forEach((characterId) => {
+        const character = characterMap.get(characterId);
+        if (!character) return;
+        character.abilities.forEach((newAbility) => {
+          const idx = perceived.abilities.findIndex(
+            (aid) => abilityMap.get(aid)?.stage === newAbility.stage
+          );
+          if (idx >= 0) {
+            perceived.abilities[idx] = newAbility.id;
+          } else {
+            perceived.abilities.push(newAbility.id);
+          }
+        });
+      });
+    }
   });
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bct-app/game-engine",
-  "version": "0.1.6-beta.3",
+  "version": "0.1.6-beta.4",
   "description": "Game engine utilities for BCT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -37,7 +37,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@bct-app/game-model": "0.1.3-beta.0"
+    "@bct-app/game-model": "0.1.3-beta.1"
   },
   "devDependencies": {
     "@vitest/ui": "^4.1.3",