isaacscript-common 2.3.0 → 2.3.1

package/scripts/docsEntryPointLint.ts

@@ -1,135 +0,0 @@
-import glob from "glob";
-import path from "path";
-
-const TYPEDOC_CONFIG_PATH = path.join(__dirname, "..", "typedoc.json");
-
-main();
-
-function main() {
-  let atLeastOneError = false;
-
-  const entryPoints = getEntryPoints();
-  const entryPointsSet = new Set(entryPoints);
-
-  const classesFilePaths = glob
-    .sync("../isaacscript-common/src/classes/*.ts")
-    .map((string) => string.replace(/^\.\.\/isaacscript-common\//, ""));
-  for (const filePath of classesFilePaths) {
-    if (!entryPointsSet.has(filePath)) {
-      console.error(
-        `Failed to find the following file in the entry point: ${filePath}`,
-      );
-      atLeastOneError = true;
-    }
-  }
-
-  const enumsFilePaths = glob
-    .sync("../isaacscript-common/src/enums/*.ts")
-    .map((string) => string.replace(/^\.\.\/isaacscript-common\//, ""));
-  for (const filePath of enumsFilePaths) {
-    if (filePath.endsWith("private")) {
-      continue;
-    }
-
-    if (!entryPointsSet.has(filePath)) {
-      console.error(
-        `Failed to find the following file in the entry point: ${filePath}`,
-      );
-      atLeastOneError = true;
-    }
-  }
-
-  const featuresFilePaths = glob
-    .sync("../isaacscript-common/src/features/*.ts")
-    .map((string) => string.replace(/^\.\.\/isaacscript-common\//, ""));
-  for (const filePath of featuresFilePaths) {
-    if (!entryPointsSet.has(filePath)) {
-      if (!filePath.endsWith(".ts")) {
-        continue;
-      }
-
-      console.error(
-        `Failed to find the following file in the entry point: ${filePath}`,
-      );
-      atLeastOneError = true;
-    }
-  }
-
-  const functionFilePaths = glob
-    .sync("../isaacscript-common/src/functions/*.ts")
-    .map((string) => string.replace(/^\.\.\/isaacscript-common\//, ""));
-  for (const filePath of functionFilePaths) {
-    if (filePath.endsWith("Tests.ts")) {
-      continue;
-    }
-
-    if (!entryPointsSet.has(filePath)) {
-      console.error(
-        `Failed to find the following file in the entry point: ${filePath}`,
-      );
-      atLeastOneError = true;
-    }
-  }
-
-  const interfacesFilePaths = glob
-    .sync("../isaacscript-common/src/interfaces/*.ts")
-    .map((string) => string.replace(/^\.\.\/isaacscript-common\//, ""));
-  for (const filePath of interfacesFilePaths) {
-    if (
-      filePath.endsWith("private") ||
-      filePath.endsWith("AddCallbackParameterCustom.ts")
-    ) {
-      continue;
-    }
-
-    if (!entryPointsSet.has(filePath)) {
-      console.error(
-        `Failed to find the following file in the entry point: ${filePath}`,
-      );
-      atLeastOneError = true;
-    }
-  }
-
-  // Only specific maps in the "maps" directory are exported. Thus, we do not check this directory.
-
-  const typesFilePaths = glob
-    .sync("../isaacscript-common/src/types/*.ts")
-    .map((string) => string.replace(/^\.\.\/isaacscript-common\//, ""));
-  for (const filePath of typesFilePaths) {
-    if (filePath.endsWith("private") || filePath.endsWith(".d.ts")) {
-      continue;
-    }
-
-    if (!entryPointsSet.has(filePath)) {
-      console.error(
-        `Failed to find the following file in the entry point: ${filePath}`,
-      );
-      atLeastOneError = true;
-    }
-  }
-
-  if (atLeastOneError) {
-    process.exit(1);
-  }
-}
-
-function getEntryPoints(): string[] {
-  // eslint-disable-next-line @typescript-eslint/no-var-requires,import/no-dynamic-require,global-require
-  const typeDocConfig = require(TYPEDOC_CONFIG_PATH) as Record<string, unknown>;
-
-  if (typeof typeDocConfig !== "object") {
-    error(`Failed to read the config file: ${TYPEDOC_CONFIG_PATH}`);
-  }
-
-  const { entryPoints } = typeDocConfig;
-  if (!Array.isArray(entryPoints)) {
-    error(`Failed to read the "entryPoints" field: ${TYPEDOC_CONFIG_PATH}`);
-  }
-
-  return entryPoints as string[];
-}
-
-export function error(...args: unknown[]): never {
-  console.error(...args);
-  return process.exit(1);
-}

package/scripts/tsconfig.json

@@ -1,5 +0,0 @@
-{
-  "extends": "../../../tsconfig.node.json",
-
-  "include": [".eslintrc.js", "*.ts"],
-}

package/src/cachedClasses.ts

@@ -1,39 +0,0 @@
-/**
- * A cached version of the class returned from the `Game()` constructor.
- *
- * Use this instead of invoking the constructor again for a miniscule performance increase.
- *
- * Caching the results of a this constructor is safe, but caching other classes (like `Level` or
- * `Room`) is not safe and can lead to the game crashing in certain situations.
- */
-export const game = Game();
-
-/**
- * A cached version of the class returned from the `Isaac.GetItemConfig()` constructor.
- *
- * Use this instead of invoking the constructor again for a miniscule performance increase.
- *
- * Caching the results of a this constructor is safe, but caching other classes (like `Level` or
- * `Room`) is not safe and can lead to the game crashing in certain situations.
- */
-export const itemConfig = Isaac.GetItemConfig();
-
-/**
- * A cached version of the class returned from the `MusicManager()` constructor.
- *
- * Use this instead of invoking the constructor again for a miniscule performance increase.
- *
- * Caching the results of a this constructor is safe, but caching other classes (like `Level` or
- * `Room`) is not safe and can lead to the game crashing in certain situations.
- */
-export const musicManager = MusicManager();
-
-/**
- * A cached version of the class returned from the `SFXManager()` constructor.
- *
- * Use this instead of invoking the constructor again for a miniscule performance increase.
- *
- * Caching the results of a this constructor is safe, but caching other classes (like `Level` or
- * `Room`) is not safe and can lead to the game crashing in certain situations.
- */
-export const sfxManager = SFXManager();

package/src/callbacks/customRevive.ts

@@ -1,206 +0,0 @@
-import {
-  CollectibleType,
-  FamiliarVariant,
-  ModCallback,
-  PlayerType,
-  SoundEffect,
-} from "isaac-typescript-definitions";
-import { sfxManager } from "../cachedClasses";
-import { ModUpgraded } from "../classes/ModUpgraded";
-import { ModCallbackCustom } from "../enums/ModCallbackCustom";
-import { runNextGameFrame } from "../features/runInNFrames";
-import { saveDataManager } from "../features/saveDataManager/exports";
-import { removeCollectibleFromItemTracker } from "../functions/collectibles";
-import { removeAllFamiliars } from "../functions/entitySpecific";
-import { log, logError } from "../functions/log";
-import { isCharacter } from "../functions/player";
-import { getPlayerFromIndex, getPlayerIndex } from "../functions/playerIndex";
-import { PlayerIndex } from "../types/PlayerIndex";
-import {
-  postCustomReviveFire,
-  postCustomReviveHasSubscriptions,
-} from "./subscriptions/postCustomRevive";
-import {
-  preCustomReviveFire,
-  preCustomReviveHasSubscriptions,
-} from "./subscriptions/preCustomRevive";
-
-const DEBUG = false;
-
-enum CustomReviveState {
-  DISABLED,
-
-  /**
-   * We can't immediately jump to waiting for an item animation because it is possible for a player
-   * to be holding an item above their head as they are dying (e.g. with Razor Blade).
-   */
-  WAITING_FOR_ROOM_TRANSITION,
-
-  WAITING_FOR_ITEM_ANIMATION,
-}
-
-const v = {
-  run: {
-    state: CustomReviveState.DISABLED,
-    revivalType: null as int | null,
-    dyingPlayerIndex: null as PlayerIndex | null,
-  },
-};
-
-/** @internal */
-export function customReviveCallbacksInit(mod: ModUpgraded): void {
-  saveDataManager("customRevive", v, hasSubscriptions);
-
-  mod.AddCallback(ModCallback.POST_RENDER, postRender); // 2
-  mod.AddCallback(ModCallback.POST_NEW_ROOM, postNewRoom); // 19
-  mod.AddCallbackCustom(
-    ModCallbackCustom.POST_PEFFECT_UPDATE_REORDERED,
-    postPEffectUpdateReordered,
-  );
-  mod.AddCallbackCustom(
-    ModCallbackCustom.POST_PLAYER_FATAL_DAMAGE,
-    postPlayerFatalDamage,
-  );
-  mod.AddCallbackCustom(ModCallbackCustom.PRE_BERSERK_DEATH, preBerserkDeath);
-}
-
-function hasSubscriptions() {
-  return (
-    preCustomReviveHasSubscriptions() || postCustomReviveHasSubscriptions()
-  );
-}
-
-// ModCallback.POST_RENDER (2)
-function postRender() {
-  if (v.run.state !== CustomReviveState.WAITING_FOR_ITEM_ANIMATION) {
-    return;
-  }
-
-  // The 1-up sound will fire before the item holding animation begins, so we mute it on every
-  // render frame.
-  sfxManager.Stop(SoundEffect.ONE_UP);
-}
-
-// ModCallback.POST_NEW_ROOM (19)
-function postNewRoom() {
-  if (v.run.state !== CustomReviveState.WAITING_FOR_ROOM_TRANSITION) {
-    return;
-  }
-
-  v.run.state = CustomReviveState.WAITING_FOR_ITEM_ANIMATION;
-  logStateChanged();
-}
-
-// ModCallbackCustom.POST_PEFFECT_UPDATE_REORDERED
-function postPEffectUpdateReordered(player: EntityPlayer) {
-  checkWaitingForItemAnimation(player);
-}
-
-function checkWaitingForItemAnimation(player: EntityPlayer) {
-  if (v.run.state !== CustomReviveState.WAITING_FOR_ITEM_ANIMATION) {
-    return;
-  }
-
-  if (v.run.dyingPlayerIndex === null) {
-    return;
-  }
-
-  const playerIndex = getPlayerIndex(player);
-  if (playerIndex !== v.run.dyingPlayerIndex) {
-    return;
-  }
-
-  let playerToCheckHoldingItem = player;
-  if (isCharacter(player, PlayerType.THE_SOUL_B)) {
-    const forgottenBody = player.GetOtherTwin();
-    if (forgottenBody !== undefined) {
-      playerToCheckHoldingItem = forgottenBody;
-    }
-  }
-
-  if (!playerToCheckHoldingItem.IsHoldingItem()) {
-    return;
-  }
-
-  // The player is now playing the animation where they hold the 1-Up item overhead. The
-  // `EntityPlayer.StopExtraAnimation` method will not work to stop this animation. End-users are
-  // expected to play a new animation in the PostCustomRevive callback, which will overwrite the
-  // 1-Up animation.
-
-  if (v.run.revivalType !== null) {
-    postCustomReviveFire(playerToCheckHoldingItem, v.run.revivalType);
-  }
-
-  v.run.state = CustomReviveState.DISABLED;
-  v.run.revivalType = null;
-  v.run.dyingPlayerIndex = null;
-  logStateChanged();
-}
-
-// ModCallbackCustom.POST_PLAYER_FATAL_DAMAGE
-function postPlayerFatalDamage(player: EntityPlayer) {
-  if (!hasSubscriptions()) {
-    return;
-  }
-
-  playerIsAboutToDie(player);
-}
-
-// ModCallbackCustom.PRE_BERSERK_DEATH
-function preBerserkDeath(player: EntityPlayer) {
-  if (!hasSubscriptions()) {
-    return;
-  }
-
-  playerIsAboutToDie(player);
-}
-
-/**
- * The player is about to die, which will immediately delete the save data for the run. To prevent
- * this from happening, we grant the 1-Up item.
- */
-function playerIsAboutToDie(player: EntityPlayer) {
-  const revivalType = preCustomReviveFire(player);
-  if (revivalType === undefined) {
-    return;
-  }
-
-  v.run.state = CustomReviveState.WAITING_FOR_ROOM_TRANSITION;
-  v.run.revivalType = revivalType;
-  v.run.dyingPlayerIndex = getPlayerIndex(player);
-  logStateChanged();
-
-  player.AddCollectible(CollectibleType.ONE_UP, 0, false);
-  removeAllFamiliars(FamiliarVariant.ONE_UP);
-  removeCollectibleFromItemTracker(CollectibleType.ONE_UP);
-
-  // The player should always be dead one frame from now. If they are not, then something has gone
-  // wrong, probably with the `isDamageToPlayerFatal` function. Since end-user code is already
-  // assuming that a custom revive is occurring, explicitly kill the player.
-  const playerIndex = getPlayerIndex(player);
-  runNextGameFrame(() => {
-    const futurePlayer = getPlayerFromIndex(playerIndex);
-    if (futurePlayer === undefined) {
-      return;
-    }
-
-    if (futurePlayer.IsDead()) {
-      return;
-    }
-
-    logError(
-      "The player is still alive after initializing a custom revive. Explicitly killing the player.",
-    );
-    futurePlayer.Kill();
-  });
-}
-
-function logStateChanged() {
-  if (DEBUG) {
-    log(
-      `Custom revive state changed: ${CustomReviveState[v.run.state]} (${
-        v.run.state
-      })`,
-    );
-  }
-}

package/src/callbacks/itemPickup.ts

@@ -1,101 +0,0 @@
-// This provides the logic for:
-// - PreItemPickup
-// - PostItemPickup
-
-import {
-  CollectibleType,
-  ItemType,
-  TrinketType,
-} from "isaac-typescript-definitions";
-import { DefaultMap } from "../classes/DefaultMap";
-import { ModUpgraded } from "../classes/ModUpgraded";
-import { ModCallbackCustom } from "../enums/ModCallbackCustom";
-import { saveDataManager } from "../features/saveDataManager/exports";
-import { defaultMapGetPlayer } from "../functions/playerDataStructures";
-import {
-  newPickingUpItem,
-  PickingUpItem,
-  resetPickingUpItem,
-} from "../types/PickingUpItem";
-import { PlayerIndex } from "../types/PlayerIndex";
-import {
-  postItemPickupFire,
-  postItemPickupHasSubscriptions,
-} from "./subscriptions/postItemPickup";
-import {
-  preItemPickupFire,
-  preItemPickupHasSubscriptions,
-} from "./subscriptions/preItemPickup";
-
-const v = {
-  run: {
-    playersPickingUpItemMap: new DefaultMap<PlayerIndex, PickingUpItem>(() =>
-      newPickingUpItem(),
-    ),
-  },
-};
-
-/** @internal */
-export function itemPickupCallbacksInit(mod: ModUpgraded): void {
-  saveDataManager("itemPickup", v, hasSubscriptions);
-
-  mod.AddCallbackCustom(
-    ModCallbackCustom.POST_PEFFECT_UPDATE_REORDERED,
-    postPEffectUpdateReordered,
-  );
-}
-
-function hasSubscriptions() {
-  return preItemPickupHasSubscriptions() || postItemPickupHasSubscriptions();
-}
-
-// ModCallbackCustom.POST_PEFFECT_UPDATE_REORDERED
-function postPEffectUpdateReordered(player: EntityPlayer) {
-  if (!hasSubscriptions()) {
-    return;
-  }
-
-  const pickingUpItem = defaultMapGetPlayer(
-    v.run.playersPickingUpItemMap,
-    player,
-  );
-
-  if (player.IsItemQueueEmpty()) {
-    queueEmpty(player, pickingUpItem);
-    // If a player enters a room with a trinket next to the entrance, the player will pick up the
-    // trinket, but it will not become queued (it will be deposited into their inventory
-    // immediately). Since we don't know what type of item the player is holding, don't account for
-    // this bug.
-  } else {
-    queueNotEmpty(player, pickingUpItem);
-  }
-}
-
-function queueEmpty(player: EntityPlayer, pickingUpItem: PickingUpItem) {
-  // eslint-disable-next-line isaacscript/strict-enums
-  if (pickingUpItem.itemType === ItemType.NULL || pickingUpItem.subType === 0) {
-    return;
-  }
-
-  postItemPickupFire(player, pickingUpItem);
-  resetPickingUpItem(pickingUpItem);
-}
-
-function queueNotEmpty(player: EntityPlayer, pickingUpItem: PickingUpItem) {
-  const queuedItem = player.QueuedItem.Item;
-  if (queuedItem === undefined || queuedItem.Type === ItemType.NULL) {
-    // This should never happen, since the `EntityPlayer.IsItemQueueEmpty` method returned true.
-    return;
-  }
-
-  if (
-    queuedItem.Type !== pickingUpItem.itemType ||
-    queuedItem.ID !== pickingUpItem.subType
-  ) {
-    // Record which item we are picking up.
-    pickingUpItem.itemType = queuedItem.Type;
-    pickingUpItem.subType = queuedItem.ID as CollectibleType | TrinketType;
-
-    preItemPickupFire(player, pickingUpItem);
-  }
-}

package/src/callbacks/postBombInitLate.ts

@@ -1,36 +0,0 @@
-import { ModCallback } from "isaac-typescript-definitions";
-import { saveDataManager } from "../features/saveDataManager/exports";
-import {
-  postBombInitLateFire,
-  postBombInitLateHasSubscriptions,
-} from "./subscriptions/postBombInitLate";
-
-const v = {
-  room: {
-    firedSet: new Set<PtrHash>(),
-  },
-};
-
-/** @internal */
-export function postBombInitLateCallbackInit(mod: Mod): void {
-  saveDataManager("postBombInitLate", v, hasSubscriptions);
-
-  mod.AddCallback(ModCallback.POST_BOMB_UPDATE, postBombUpdate); // 58
-}
-
-function hasSubscriptions() {
-  return postBombInitLateHasSubscriptions();
-}
-
-// ModCallback.POST_BOMB_UPDATE (58)
-function postBombUpdate(bomb: EntityBomb) {
-  if (!hasSubscriptions()) {
-    return;
-  }
-
-  const index = GetPtrHash(bomb);
-  if (!v.room.firedSet.has(index)) {
-    v.room.firedSet.add(index);
-    postBombInitLateFire(bomb);
-  }
-}

package/src/callbacks/postBoneSwing.ts

@@ -1,64 +0,0 @@
-import { KnifeVariant, ModCallback } from "isaac-typescript-definitions";
-import { saveDataManager } from "../features/saveDataManager/exports";
-import {
-  postBoneSwingFire,
-  postBoneSwingHasSubscriptions,
-} from "./subscriptions/postBoneSwing";
-
-const BONE_SWING_ANIMATIONS: ReadonlySet<string> = new Set([
-  "Swing",
-  "Swing2",
-  "Spin",
-]);
-
-const v = {
-  room: {
-    boneClubAnimations: new Map<PtrHash, string>(),
-  },
-};
-
-/** @internal */
-export function postBoneSwingCallbackInit(mod: Mod): void {
-  saveDataManager("postBoneSwing", v, hasSubscriptions);
-
-  mod.AddCallback(ModCallback.POST_KNIFE_RENDER, postKnifeRender); // 52
-}
-
-function hasSubscriptions() {
-  return postBoneSwingHasSubscriptions();
-}
-
-// ModCallback.POST_KNIFE_RENDER (52)
-function postKnifeRender(knife: EntityKnife) {
-  if (!hasSubscriptions()) {
-    return;
-  }
-
-  // The PostKnifeRender callback cannot be registered with knife variants for some reason.
-  if (knife.Variant !== KnifeVariant.BONE_CLUB) {
-    return;
-  }
-
-  postKnifeRenderBoneClub(knife);
-}
-
-function postKnifeRenderBoneClub(boneClub: EntityKnife) {
-  const sprite = boneClub.GetSprite();
-  const animation = sprite.GetAnimation();
-  const ptrHash = GetPtrHash(boneClub);
-  const animationOnLastFrame = v.room.boneClubAnimations.get(ptrHash);
-  v.room.boneClubAnimations.set(ptrHash, animation);
-
-  if (
-    animationOnLastFrame !== undefined &&
-    animation !== animationOnLastFrame
-  ) {
-    boneClubAnimationChanged(boneClub, animation);
-  }
-}
-
-function boneClubAnimationChanged(boneClub: EntityKnife, animation: string) {
-  if (BONE_SWING_ANIMATIONS.has(animation)) {
-    postBoneSwingFire(boneClub);
-  }
-}

package/src/callbacks/postCollectibleInitFirst.ts

@@ -1,39 +0,0 @@
-import { ModCallback, PickupVariant } from "isaac-typescript-definitions";
-import { saveDataManager } from "../features/saveDataManager/exports";
-import { getCollectibleIndex } from "../functions/collectibles";
-import { CollectibleIndex } from "../types/CollectibleIndex";
-import {
-  postCollectibleInitFirstFire,
-  postCollectibleInitFirstHasSubscriptions,
-} from "./subscriptions/postCollectibleInitFirst";
-
-const v = {
-  run: {
-    seenCollectibles: new Set<CollectibleIndex>(),
-  },
-};
-
-/** @internal */
-export function postCollectibleInitFirstCallbackInit(mod: Mod): void {
-  saveDataManager("postCollectibleInitFirst", v, hasSubscriptions);
-
-  mod.AddCallback(
-    ModCallback.POST_PICKUP_INIT,
-    postPickupInitCollectible,
-    PickupVariant.COLLECTIBLE,
-  ); // 34
-}
-
-function hasSubscriptions() {
-  return postCollectibleInitFirstHasSubscriptions();
-}
-
-function postPickupInitCollectible(collectible: EntityPickupCollectible) {
-  const collectibleIndex = getCollectibleIndex(collectible);
-  if (v.run.seenCollectibles.has(collectibleIndex)) {
-    return;
-  }
-
-  v.run.seenCollectibles.add(collectibleIndex);
-  postCollectibleInitFirstFire(collectible);
-}