@rbxts/sound-manager 1.0.0 → 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lukas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,17 +1,26 @@
-# Sound Manager
-
-A Roblox sound management library built with Roblox-TS
-
-## Getting Started
-To use the Sound Manager library in your Roblox-TS project install it via npm:
-```bash
-   npm install @rbxts/sound-manager
-   ```
-
-Example usage:
-```typescript
-import { Sounds } from "@rbxts/sound-manager";
-
-Sounds.load("TestSound", "rbxassetid://4714389545", { volume: 1, loop: false });     
-Sounds.play("TestSound")
-```
+# Sound Manager
+
+A Roblox sound management library built with Roblox-TS
+
+## Getting Started
+To use the Sound Manager library in your Roblox-TS project, install it via npm:
+```bash
+npm install @rbxts/sound-manager
+```
+
+Example usage:
+```typescript
+import { createSoundRegistry } from "@rbxts/sound-manager";
+
+const Sounds = createSoundRegistry({
+    SCP096: {
+        id: "rbxassetid://4714389545",
+        volume: 1,
+        loop: false,
+    } 
+});
+
+Sounds.preloadAll();
+
+Sounds.play("SCP096");
+```

package/out/core/createSoundRegistry.d.ts

@@ -0,0 +1,12 @@
+import { SoundOptions } from "./options";
+/**
+ *
+ * @param definitions Define the Sounds
+ * @returns
+ */
+export declare function createSoundRegistry<T extends Record<string, SoundOptions>>(definitions: T): {
+    play: (name: keyof T) => void;
+    stop: (name: keyof T) => void;
+    preloadAll: () => void;
+    load: (name: keyof T) => void;
+};

package/out/core/createSoundRegistry.luau

@@ -0,0 +1,90 @@
+-- Compiled with roblox-ts v3.0.0
+--[[
+	*
+	 * 
+	 * @param definitions Define the Sounds
+	 * @returns 
+	 
+]]
+local function createSoundRegistry(definitions)
+	local ReplicatedStorage = game:GetService("ReplicatedStorage")
+	local folder = ReplicatedStorage:FindFirstChild("Sounds")
+	if not folder then
+		folder = Instance.new("Folder")
+		folder.Name = "Sounds"
+		folder.Parent = ReplicatedStorage
+	end
+	--[[
+		*
+		     * 
+		     * @param name Define which Sound should be loaded
+		     * @returns 
+		     
+	]]
+	local function load(name)
+		if folder:FindFirstChild(name) then
+			return nil
+		end
+		local config = definitions[name]
+		local sound = Instance.new("Sound")
+		sound.Name = name
+		sound.SoundId = config.id
+		local _condition = config.volume
+		if _condition == nil then
+			_condition = 1
+		end
+		sound.Volume = _condition
+		local _condition_1 = config.loop
+		if _condition_1 == nil then
+			_condition_1 = false
+		end
+		sound.Looped = _condition_1
+		sound.Parent = folder
+	end
+	--[[
+		*
+		     * 
+		     * @param name Define which Sound should be played
+		     
+	]]
+	local function play(name)
+		load(name)
+		local sound = folder:FindFirstChild(name)
+		local _result = sound
+		if _result ~= nil then
+			_result:Play()
+		end
+	end
+	--[[
+		*
+		     * 
+		     * @param name Define which Sound should be stopped
+		     
+	]]
+	local function stop(name)
+		local sound = folder:FindFirstChild(name)
+		local _result = sound
+		if _result ~= nil then
+			_result:Stop()
+		end
+	end
+	--[[
+		*
+		     * Loads every Sound
+		     
+	]]
+	local function preloadAll()
+		for name in pairs(definitions) do
+			load(name)
+		end
+	end
+	return {
+		play = play,
+		stop = stop,
+		preloadAll = preloadAll,
+		load = load,
+	}
+end
+return {
+	createSoundRegistry = createSoundRegistry,
+}

package/out/core/options.d.ts

@@ -1,4 +1,5 @@
 export interface SoundOptions {
     volume?: number;
     loop?: boolean;
+    id: string;
 }

package/out/core/test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/core/test.luau

@@ -0,0 +1,11 @@
+-- Compiled with roblox-ts v3.0.0
+local TS = _G[script]
+local createSoundRegistry = TS.import(script, script.Parent, "createSoundRegistry").createSoundRegistry
+local Sounds = createSoundRegistry({
+	Exlposion = {
+		id = "rbxassetid://1",
+		volume = 0.5,
+		loop = false,
+	},
+})
+return nil

package/out/index.d.ts

@@ -1,7 +1 @@
-import { SoundOptions } from "./core/options";
-export declare namespace Sounds {
-    /** * * @param sound Define the Sound to play */
-    function play(soundName: string): void;
-    /** * * @param soundname Define the name of the Sound * @param soundid Define the SoundID of the Sound * @param options Define the options for the Sound (e.g. volume) */
-    function load(soundName: string, soundId: string, options?: SoundOptions): void;
-}
+export * from "./core/createSoundRegistry";

package/out/init.luau

@@ -1,55 +1,7 @@
 -- Compiled with roblox-ts v3.0.0
-local Sounds = {}
-do
-	local _container = Sounds
-	--* * * @param sound Define the Sound to play 
-	local function play(soundName)
-		local soundFolder = game:GetService("ReplicatedStorage"):FindFirstChild("Sounds")
-		if not soundFolder then
-			warn("Sound folder not found in ReplicatedStorage.")
-			return nil
-		end
-		local _sound = soundFolder:FindFirstChild(soundName)
-		if _sound then
-			_sound:Play()
-		else
-			warn(`Sound: {soundName} not found! Make sure to load it first.`)
-		end
-	end
-	_container.play = play
-	--* * * @param soundname Define the name of the Sound * @param soundid Define the SoundID of the Sound * @param options Define the options for the Sound (e.g. volume) 
-	local function load(soundName, soundId, options)
-		local soundFolder = game:GetService("ReplicatedStorage"):FindFirstChild("Sounds")
-		if not soundFolder then
-			soundFolder = Instance.new("Folder")
-			soundFolder.Name = "Sounds"
-			soundFolder.Parent = game:GetService("ReplicatedStorage")
-		end
-		if soundFolder:FindFirstChild(soundName) then
-			warn(`Sound: {soundName} already exists.`)
-			return nil
-		end
-		local newSound = Instance.new("Sound")
-		newSound.Name = soundName
-		newSound.SoundId = soundId
-		newSound.Parent = soundFolder
-		local _result = options
-		if _result ~= nil then
-			_result = _result.volume
-		end
-		if _result ~= nil then
-			newSound.Volume = options.volume
-		end
-		local _result_1 = options
-		if _result_1 ~= nil then
-			_result_1 = _result_1.loop
-		end
-		if _result_1 ~= nil then
-			newSound.Looped = options.loop
-		end
-	end
-	_container.load = load
+local TS = _G[script]
+local exports = {}
+for _k, _v in TS.import(script, script, "core", "createSoundRegistry") or {} do
+	exports[_k] = _v
 end
-return {
-	Sounds = Sounds,
-}
+return exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rbxts/sound-manager",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "A sound manager for Roblox-Typescript projects.",
   "main": "out/init.lua",
   "scripts": {
@@ -34,6 +34,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
+    "@rbxts/sound-manager": "file:rbxts-sound-manager-1.2.0.tgz",
     "@rbxts/testez": "^0.4.2-ts.0"
   }
 }