isaacscript-common 31.5.0 → 31.6.0

package/dist/index.rollup.d.ts

@@ -1194,6 +1194,16 @@ export declare function asPillEffect(num: number): PillEffect;
  */
 export declare function asPlayerType(num: number): PlayerType;
 
+/**
+ * Helper function to throw an error (using the `error` Lua function) if the provided value is equal
+ * to `undefined`.
+ *
+ * This is useful to have TypeScript narrow a `T | undefined` value to `T` in a concise way.
+ */
+export declare function assertDefined<T>(value: T, ...[msg]: [undefined] extends [T] ? [string] : [
+"The assertion is useless because the provided value does not contain undefined."
+]): asserts value is Exclude<T, undefined>;
+
 /**
  * Helper function to safely cast an enum to a `string`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
@@ -5263,10 +5273,10 @@ export declare function getEnumEntries<T>(transpiledEnum: T): Array<[key: string
  * For a more in depth explanation, see:
  * https://isaacscript.github.io/main/gotchas#iterating-over-enums
  */
-export declare function getEnumKeys<T>(transpiledEnum: T): string[];
+export declare function getEnumKeys(transpiledEnum: Record<string | number, string | number>): string[];
 
 /** Helper function to get the amount of entries inside of an enum. */
-export declare function getEnumLength<T>(transpiledEnum: T): int;
+export declare function getEnumLength(transpiledEnum: Record<string | number, string | number>): int;
 
 /**
  * TypeScriptToLua will transpile TypeScript enums to Lua tables that have a double mapping. Thus,
@@ -5486,8 +5496,8 @@ export declare function getHeartsUIWidth(): int;
 /**
  * Helper function to get the enum value with the highest value.
  *
- * Note that this is not necessarily the enum value that is declared last, since there is no way to
- * infer that at run-time.
+ * Note that this is not necessarily the enum value that is declared last in the code, since there
+ * is no way to infer that at run-time.
  */
 export declare function getHighestEnumValue<T>(transpiledEnum: T): T[keyof T];
 
@@ -5628,6 +5638,9 @@ export declare function getLasers(laserVariant?: LaserVariant | -1, subType?: nu
  * Helper function to return the last element of an array.
  *
  * If the array is empty, this will return undefined.
+ *
+ * (Note that TSTL does not support `Array.at(-1)`, which would make this helper function largely
+ * unnecessary.)
  */
 export declare function getLastElement<T>(array: T[]): T | undefined;
 
@@ -8281,6 +8294,9 @@ export declare function isEntity(variable: unknown): variable is Entity;
  */
 export declare function isEntityMoving(entity: Entity, threshold?: number): boolean;
 
+/** Helper function to validate that a particular value exists inside of an enum. */
+export declare function isEnumValue(value: number | string, transpiledEnum: Record<string | number, string | number>): boolean;
+
 export declare function isEven(num: int): boolean;
 
 /** Helper function to detect if a variable is of type `EntityFamiliar`. */
@@ -13053,6 +13069,8 @@ export declare class ModFeature {
     uninit(): void;
 }
 
+export declare const MODIFIER_KEYS: readonly [Keyboard.LEFT_SHIFT, Keyboard.LEFT_CONTROL, Keyboard.LEFT_ALT, Keyboard.LEFT_SUPER, Keyboard.RIGHT_SHIFT, Keyboard.RIGHT_CONTROL, Keyboard.RIGHT_ALT, Keyboard.RIGHT_SUPER];
+
 /**
  * `isaacscript-common` has many custom callbacks that you can use in your mods. Instead of
  * hijacking the vanilla `Mod` object, we provide a `ModUpgraded` object for you to use, which
@@ -13146,6 +13164,8 @@ export declare class ModUpgraded implements Mod {
  */
 declare type ModUpgradedWithFeatures<T extends readonly ISCFeature[] = []> = ModUpgraded & ISCFeaturesToKeys<T>;
 
+export declare const MOVEMENT_ACTIONS: readonly [ButtonAction.LEFT, ButtonAction.RIGHT, ButtonAction.UP, ButtonAction.DOWN];
+
 export declare const MOVEMENT_ACTIONS_SET: ReadonlySet<ButtonAction>;
 
 /**
@@ -16004,6 +16024,8 @@ export declare function setUnseeded(): void;
  */
 export declare const sfxManager: SFXManager;
 
+export declare const SHOOTING_ACTIONS: readonly [ButtonAction.SHOOT_LEFT, ButtonAction.SHOOT_RIGHT, ButtonAction.SHOOT_UP, ButtonAction.SHOOT_DOWN];
+
 export declare const SHOOTING_ACTIONS_SET: ReadonlySet<ButtonAction>;
 
 declare function shouldFireCollectibleType(fireArgs: [player: EntityPlayer, collectibleType: CollectibleType], optionalArgs: [collectibleType?: CollectibleType]): boolean;