isaacscript-common 1.2.117 → 1.2.120

package/dist/features/disableSound.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Helper function to stop muting all sound effects and music.
+ *
+ * Use this function to set things back to normal after having used [[`disableAllSounds`]].
+ *
+ * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
+ * that multiple mod features can work in tandem.
+ */
+export declare function enableAllSound(key: string): void;
+/**
+ * Helper function to disable all sound effects and music (by constantly musting them).
+ *
+ * Use the [[`enableAllSounds`]] helper function to set things back to normal.
+ *
+ * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
+ * that multiple mod features can work in tandem.
+ */
+export declare function disableAllSound(key: string): void;

package/dist/features/disableSound.lua

@@ -0,0 +1,55 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local postRender, v
+local ____errors = require("errors")
+local getUpgradeErrorMsg = ____errors.getUpgradeErrorMsg
+local ____sound = require("functions.sound")
+local stopAllSoundEffects = ____sound.stopAllSoundEffects
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function postRender(self)
+    if v.run.disableSoundSet.size == 0 then
+        return
+    end
+    stopAllSoundEffects(nil)
+end
+local FEATURE_NAME = "sound disabler"
+local initialized = false
+local musicWasEnabled = false
+v = {run = {disableSoundSet = __TS__New(Set)}}
+function ____exports.disableSoundsInit(self, mod)
+    initialized = true
+    saveDataManager(nil, "disableSounds", v)
+    mod:AddCallback(ModCallbacks.MC_POST_RENDER, postRender)
+end
+function ____exports.enableAllSound(self, key)
+    if not initialized then
+        local msg = getUpgradeErrorMsg(nil, FEATURE_NAME)
+        error(msg)
+    end
+    if not v.run.disableSoundSet:has(key) then
+        return
+    end
+    v.run.disableSoundSet:delete(key)
+    if v.run.disableSoundSet.size == 0 and musicWasEnabled then
+        local musicManager = MusicManager()
+        musicManager:Enable()
+    end
+    stopAllSoundEffects(nil)
+end
+function ____exports.disableAllSound(self, key)
+    if not initialized then
+        local msg = getUpgradeErrorMsg(nil, FEATURE_NAME)
+        error(msg)
+    end
+    if v.run.disableSoundSet.size == 0 then
+        local musicManager = MusicManager()
+        musicWasEnabled = musicManager:IsEnabled()
+    end
+    v.run.disableSoundSet:add(key)
+    stopAllSoundEffects(nil)
+end
+return ____exports

package/dist/functions/utils.d.ts

@@ -48,6 +48,9 @@ export declare const ensureAllCases: (obj: never) => never;
  *
  * For a more in depth explanation, see:
  * https://isaacscript.github.io/docs/gotchas#iterating-over-enums
+ *
+ * You can also use this function for vanilla enums, which can make code easier to read than using
+ * `pairs` or `Object.values()`.
  */
 export declare function getEnumValues<T>(transpiledEnum: T): Array<T[keyof T]>;
 /**

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { forceNewLevelCallback, forceNewRoomCallback, } from "./callbacks/reorde
 export * from "./constants";
 export { deployJSONRoom, deployRandomJSONRoom, emptyRoom, } from "./features/deployJSONRoom";
 export { disableAllInputs, disableAllInputsExceptFor, disableMovementInputs, disableShootingInputs, enableAllInputs, enableAllInputsExceptFor, } from "./features/disableInputs";
+export { disableAllSound, enableAllSound } from "./features/disableSound";
 export { forgottenSwitch } from "./features/forgottenSwitch";
 export { getCollectibleItemPoolType } from "./features/getCollectibleItemPoolType";
 export * from "./features/isPonyActive";

package/dist/index.lua

@@ -39,6 +39,13 @@ do
     ____exports.enableAllInputs = enableAllInputs
     ____exports.enableAllInputsExceptFor = enableAllInputsExceptFor
 end
+do
+    local ____disableSound = require("features.disableSound")
+    local disableAllSound = ____disableSound.disableAllSound
+    local enableAllSound = ____disableSound.enableAllSound
+    ____exports.disableAllSound = disableAllSound
+    ____exports.enableAllSound = enableAllSound
+end
 do
     local ____forgottenSwitch = require("features.forgottenSwitch")
     local forgottenSwitch = ____forgottenSwitch.forgottenSwitch

package/dist/upgradeMod.lua

@@ -75,6 +75,8 @@ local ____deployJSONRoom = require("features.deployJSONRoom")
 local deployJSONRoomInit = ____deployJSONRoom.deployJSONRoomInit
 local ____disableInputs = require("features.disableInputs")
 local disableInputsInit = ____disableInputs.disableInputsInit
+local ____disableSound = require("features.disableSound")
+local disableSoundsInit = ____disableSound.disableSoundsInit
 local ____forgottenSwitch = require("features.forgottenSwitch")
 local forgottenSwitchInit = ____forgottenSwitch.forgottenSwitchInit
 local ____getCollectibleItemPoolType = require("features.getCollectibleItemPoolType")
@@ -134,6 +136,7 @@ end
 function initFeatures(self, mod)
     deployJSONRoomInit(nil, mod)
     disableInputsInit(nil, mod)
+    disableSoundsInit(nil, mod)
     forgottenSwitchInit(nil, mod)
     getCollectibleItemPoolTypeInit(nil, mod)
     preventCollectibleRotateInit(nil, mod)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.117",
+  "version": "1.2.120",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",