@bct-app/game-engine 0.1.6-beta.2 → 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

@@ -24,6 +24,7 @@ __export(index_exports, {
   adjustValueAsNumberArray: () => adjustValueAsNumberArray,
   applyOperationToPlayers: () => applyOperationToPlayers,
   buildPlayerSeatMap: () => buildPlayerSeatMap,
+  canInvokeAbility: () => canInvokeAbility,
   copyPlayers: () => copyPlayers,
   getSourceValue: () => getSourceValue,
   getValueFromPayloads: () => getValueFromPayloads,
@@ -159,8 +160,7 @@ var resolveSourceValue = (source, writableInputs, payloads, effector, snapshotSe
       }
       const characterIds = typeof payloadValue === "string" ? [payloadValue] : payloadValue;
       return characterIds.flatMap((id) => {
-        const resolved = resolveFromCharacter ? resolveFromCharacter(id) : void 0;
-        return resolved !== void 0 ? [resolved] : [];
+        return resolveFromCharacter ? resolveFromCharacter(id) : [];
       });
     }
     return castOrValidate(payloadValue);
@@ -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);
+          }
+        });
+      });
+    }
   });
 });
 
@@ -393,8 +397,6 @@ var applyPerceivedCharacterChange = createEffectHandler("PERCEIVED_CHARACTER_CHA
 var applyReminderAdd = createEffectHandler("REMINDER_ADD", ({
   effect,
   payloads,
-  nowTimelineIndex,
-  operationInTimelineIdx,
   makePlayersEffect
 }) => {
   const maybeReminder = getSourceValue(effect.source, payloads);
@@ -402,10 +404,6 @@ var applyReminderAdd = createEffectHandler("REMINDER_ADD", ({
     console.warn("Invalid reminder data for REMINDER_ADD effect:", maybeReminder);
     return;
   }
-  const timelineDistance = nowTimelineIndex - operationInTimelineIdx;
-  if (typeof maybeReminder.duration === "number" && maybeReminder.duration > 0 && timelineDistance >= maybeReminder.duration) {
-    return;
-  }
   makePlayersEffect.forEach((player) => {
     if (!player.reminders) {
       player.reminders = [];
@@ -675,10 +673,16 @@ var resolveEffectTargets = ({
 };
 
 // src/effects/evaluate-lifetime.ts
-var getLifetime = (effect) => {
-  if ("lifetime" in effect) {
+var getLifetime = (effect, payloads) => {
+  if ("lifetime" in effect && effect.lifetime) {
     return effect.lifetime;
   }
+  if (effect.type === "REMINDER_ADD") {
+    const maybeReminder = getSourceValue(effect.source, payloads);
+    if (isReminder(maybeReminder) && typeof maybeReminder.duration === "number" && maybeReminder.duration > 0) {
+      return { kind: "PHASES", count: maybeReminder.duration };
+    }
+  }
   return void 0;
 };
 var matchesLifetimeCondition = (player, condition, characterMap) => {
@@ -723,9 +727,10 @@ var evaluateLifetime = ({
   effector,
   targets,
   snapshotSeatMap,
-  characterMap
+  characterMap,
+  payloads
 }) => {
-  const lifetime = getLifetime(effect);
+  const lifetime = getLifetime(effect, payloads);
   if (!lifetime || lifetime.kind === "PERMANENT") {
     return targets;
   }
@@ -737,6 +742,10 @@ var evaluateLifetime = ({
     }
     return nowTurn - opTurn < lifetime.count ? targets : [];
   }
+  if (lifetime.kind === "PHASES") {
+    if (operationTimelineIdx < 0) return targets;
+    return nowTimelineIndex - operationTimelineIdx < lifetime.count ? targets : [];
+  }
   if (lifetime.kind === "UNTIL_EVENT") {
     if (operationTimelineIdx < 0) return targets;
     for (let idx = operationTimelineIdx + 1; idx <= nowTimelineIndex; idx += 1) {
@@ -844,7 +853,8 @@ var applyOperationToPlayers = ({
             effector,
             targets: resolvedTargets,
             snapshotSeatMap: lifetimeSnapshotSeatMap,
-            characterMap
+            characterMap,
+            payloads
           });
           const handler = effectHandlers[effect.type];
           if (!handler) {
@@ -922,12 +932,84 @@ var applyOperationToPlayers = ({
   const final = runReplay(groundTruthSeatMap);
   return transformEmptyArray(final);
 };
+
+// src/can-invoke-ability.ts
+var checkTurns = (turns, currentTurn) => {
+  if (turns.only && turns.only.length > 0 && !turns.only.includes(currentTurn)) {
+    return `turn ${currentTurn} not in allowed turns ${JSON.stringify(turns.only)}`;
+  }
+  if (typeof turns.from === "number" && currentTurn < turns.from) {
+    return `turn ${currentTurn} is before allowed start turn ${turns.from}`;
+  }
+  if (typeof turns.to === "number" && currentTurn > turns.to) {
+    return `turn ${currentTurn} is after allowed end turn ${turns.to}`;
+  }
+  return null;
+};
+var countMatchingPriorOps = (priorOperations, abilityId, effectorSeat, operationTimelineMap, matchTurn, matchTime, timelines) => {
+  return priorOperations.filter((op) => {
+    if (op.abilityId !== abilityId) return false;
+    if (typeof effectorSeat === "number" && op.effector !== effectorSeat) return false;
+    if (matchTurn === null && matchTime === null) return true;
+    const idx = operationTimelineMap.get(op);
+    if (typeof idx !== "number") return false;
+    const tl = timelines[idx];
+    if (!tl) return false;
+    if (matchTurn !== null && tl.turn !== matchTurn) return false;
+    if (matchTime !== null && tl.time !== matchTime) return false;
+    return true;
+  }).length;
+};
+var canInvokeAbility = ({
+  ability,
+  effector,
+  currentTimelineIdx,
+  timelines,
+  priorOperations = []
+}) => {
+  const trigger = ability.triggerWindow;
+  if (!trigger) return { allowed: true };
+  const currentTimeline = timelines[currentTimelineIdx];
+  if (!currentTimeline) {
+    return { allowed: false, reason: `no timeline at index ${currentTimelineIdx}` };
+  }
+  if (trigger.turns) {
+    const turnError = checkTurns(trigger.turns, currentTimeline.turn);
+    if (turnError) return { allowed: false, reason: turnError };
+  }
+  if (trigger.phases && trigger.phases.length > 0 && !trigger.phases.includes(currentTimeline.time)) {
+    return { allowed: false, reason: `phase ${currentTimeline.time} not in allowed phases ${JSON.stringify(trigger.phases)}` };
+  }
+  if (trigger.requireEffectorAlive && (!effector || effector.isDead)) {
+    return { allowed: false, reason: "effector is not alive" };
+  }
+  if (trigger.frequency && priorOperations.length > 0) {
+    const operationTimelineMap = /* @__PURE__ */ new Map();
+    timelines.forEach((tl, idx) => tl.operations?.forEach((op) => operationTimelineMap.set(op, idx)));
+    const matchTurn = trigger.frequency === "ONCE_PER_GAME" ? null : currentTimeline.turn;
+    const matchTime = trigger.frequency === "ONCE_PER_GAME" ? null : trigger.frequency === "ONCE_PER_NIGHT" ? "night" : "day";
+    const count = countMatchingPriorOps(
+      priorOperations,
+      ability.id,
+      effector?.seat,
+      operationTimelineMap,
+      matchTurn,
+      matchTime,
+      timelines
+    );
+    if (count > 0) {
+      return { allowed: false, reason: `frequency ${trigger.frequency} already exhausted (${count} prior op${count === 1 ? "" : "s"})` };
+    }
+  }
+  return { allowed: true };
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   adjustValueAsNumber,
   adjustValueAsNumberArray,
   applyOperationToPlayers,
   buildPlayerSeatMap,
+  canInvokeAbility,
   copyPlayers,
   getSourceValue,
   getValueFromPayloads,

package/dist/index.mjs

@@ -122,8 +122,7 @@ var resolveSourceValue = (source, writableInputs, payloads, effector, snapshotSe
       }
       const characterIds = typeof payloadValue === "string" ? [payloadValue] : payloadValue;
       return characterIds.flatMap((id) => {
-        const resolved = resolveFromCharacter ? resolveFromCharacter(id) : void 0;
-        return resolved !== void 0 ? [resolved] : [];
+        return resolveFromCharacter ? resolveFromCharacter(id) : [];
       });
     }
     return castOrValidate(payloadValue);
@@ -156,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;
   }
@@ -174,8 +173,8 @@ var applyAbilityChange = createEffectHandler("ABILITY_CHANGE", ({
   writableInputs,
   getSnapshotSeatMap,
   abilityMap,
-  makePlayersEffect,
-  characterMap
+  characterMap,
+  makePlayersEffect
 }) => {
   const resolvedRaw = resolveSourceValue(
     effect.source,
@@ -183,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);
+          }
+        });
+      });
+    }
   });
 });
 
@@ -356,8 +359,6 @@ var applyPerceivedCharacterChange = createEffectHandler("PERCEIVED_CHARACTER_CHA
 var applyReminderAdd = createEffectHandler("REMINDER_ADD", ({
   effect,
   payloads,
-  nowTimelineIndex,
-  operationInTimelineIdx,
   makePlayersEffect
 }) => {
   const maybeReminder = getSourceValue(effect.source, payloads);
@@ -365,10 +366,6 @@ var applyReminderAdd = createEffectHandler("REMINDER_ADD", ({
     console.warn("Invalid reminder data for REMINDER_ADD effect:", maybeReminder);
     return;
   }
-  const timelineDistance = nowTimelineIndex - operationInTimelineIdx;
-  if (typeof maybeReminder.duration === "number" && maybeReminder.duration > 0 && timelineDistance >= maybeReminder.duration) {
-    return;
-  }
   makePlayersEffect.forEach((player) => {
     if (!player.reminders) {
       player.reminders = [];
@@ -638,10 +635,16 @@ var resolveEffectTargets = ({
 };
 
 // src/effects/evaluate-lifetime.ts
-var getLifetime = (effect) => {
-  if ("lifetime" in effect) {
+var getLifetime = (effect, payloads) => {
+  if ("lifetime" in effect && effect.lifetime) {
     return effect.lifetime;
   }
+  if (effect.type === "REMINDER_ADD") {
+    const maybeReminder = getSourceValue(effect.source, payloads);
+    if (isReminder(maybeReminder) && typeof maybeReminder.duration === "number" && maybeReminder.duration > 0) {
+      return { kind: "PHASES", count: maybeReminder.duration };
+    }
+  }
   return void 0;
 };
 var matchesLifetimeCondition = (player, condition, characterMap) => {
@@ -686,9 +689,10 @@ var evaluateLifetime = ({
   effector,
   targets,
   snapshotSeatMap,
-  characterMap
+  characterMap,
+  payloads
 }) => {
-  const lifetime = getLifetime(effect);
+  const lifetime = getLifetime(effect, payloads);
   if (!lifetime || lifetime.kind === "PERMANENT") {
     return targets;
   }
@@ -700,6 +704,10 @@ var evaluateLifetime = ({
     }
     return nowTurn - opTurn < lifetime.count ? targets : [];
   }
+  if (lifetime.kind === "PHASES") {
+    if (operationTimelineIdx < 0) return targets;
+    return nowTimelineIndex - operationTimelineIdx < lifetime.count ? targets : [];
+  }
   if (lifetime.kind === "UNTIL_EVENT") {
     if (operationTimelineIdx < 0) return targets;
     for (let idx = operationTimelineIdx + 1; idx <= nowTimelineIndex; idx += 1) {
@@ -807,7 +815,8 @@ var applyOperationToPlayers = ({
             effector,
             targets: resolvedTargets,
             snapshotSeatMap: lifetimeSnapshotSeatMap,
-            characterMap
+            characterMap,
+            payloads
           });
           const handler = effectHandlers[effect.type];
           if (!handler) {
@@ -885,11 +894,83 @@ var applyOperationToPlayers = ({
   const final = runReplay(groundTruthSeatMap);
   return transformEmptyArray(final);
 };
+
+// src/can-invoke-ability.ts
+var checkTurns = (turns, currentTurn) => {
+  if (turns.only && turns.only.length > 0 && !turns.only.includes(currentTurn)) {
+    return `turn ${currentTurn} not in allowed turns ${JSON.stringify(turns.only)}`;
+  }
+  if (typeof turns.from === "number" && currentTurn < turns.from) {
+    return `turn ${currentTurn} is before allowed start turn ${turns.from}`;
+  }
+  if (typeof turns.to === "number" && currentTurn > turns.to) {
+    return `turn ${currentTurn} is after allowed end turn ${turns.to}`;
+  }
+  return null;
+};
+var countMatchingPriorOps = (priorOperations, abilityId, effectorSeat, operationTimelineMap, matchTurn, matchTime, timelines) => {
+  return priorOperations.filter((op) => {
+    if (op.abilityId !== abilityId) return false;
+    if (typeof effectorSeat === "number" && op.effector !== effectorSeat) return false;
+    if (matchTurn === null && matchTime === null) return true;
+    const idx = operationTimelineMap.get(op);
+    if (typeof idx !== "number") return false;
+    const tl = timelines[idx];
+    if (!tl) return false;
+    if (matchTurn !== null && tl.turn !== matchTurn) return false;
+    if (matchTime !== null && tl.time !== matchTime) return false;
+    return true;
+  }).length;
+};
+var canInvokeAbility = ({
+  ability,
+  effector,
+  currentTimelineIdx,
+  timelines,
+  priorOperations = []
+}) => {
+  const trigger = ability.triggerWindow;
+  if (!trigger) return { allowed: true };
+  const currentTimeline = timelines[currentTimelineIdx];
+  if (!currentTimeline) {
+    return { allowed: false, reason: `no timeline at index ${currentTimelineIdx}` };
+  }
+  if (trigger.turns) {
+    const turnError = checkTurns(trigger.turns, currentTimeline.turn);
+    if (turnError) return { allowed: false, reason: turnError };
+  }
+  if (trigger.phases && trigger.phases.length > 0 && !trigger.phases.includes(currentTimeline.time)) {
+    return { allowed: false, reason: `phase ${currentTimeline.time} not in allowed phases ${JSON.stringify(trigger.phases)}` };
+  }
+  if (trigger.requireEffectorAlive && (!effector || effector.isDead)) {
+    return { allowed: false, reason: "effector is not alive" };
+  }
+  if (trigger.frequency && priorOperations.length > 0) {
+    const operationTimelineMap = /* @__PURE__ */ new Map();
+    timelines.forEach((tl, idx) => tl.operations?.forEach((op) => operationTimelineMap.set(op, idx)));
+    const matchTurn = trigger.frequency === "ONCE_PER_GAME" ? null : currentTimeline.turn;
+    const matchTime = trigger.frequency === "ONCE_PER_GAME" ? null : trigger.frequency === "ONCE_PER_NIGHT" ? "night" : "day";
+    const count = countMatchingPriorOps(
+      priorOperations,
+      ability.id,
+      effector?.seat,
+      operationTimelineMap,
+      matchTurn,
+      matchTime,
+      timelines
+    );
+    if (count > 0) {
+      return { allowed: false, reason: `frequency ${trigger.frequency} already exhausted (${count} prior op${count === 1 ? "" : "s"})` };
+    }
+  }
+  return { allowed: true };
+};
 export {
   adjustValueAsNumber,
   adjustValueAsNumberArray,
   applyOperationToPlayers,
   buildPlayerSeatMap,
+  canInvokeAbility,
   copyPlayers,
   getSourceValue,
   getValueFromPayloads,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bct-app/game-engine",
-  "version": "0.1.6-beta.2",
+  "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",