Add ToolUtils package (#532)

Add ToolUtils package

Author: Quenty

src/characterutils/src/Shared/RxRootPartUtils.lua

@@ -29,9 +29,7 @@ end
 	@return Brio<BasePart>
 ]=]
 function RxRootPartUtils.observeHumanoidRootPartBrioFromHumanoid(humanoid)
-	return RxInstanceUtils.observePropertyBrio(humanoid, "Parent", function(character)
-		return character ~= nil
-	end):Pipe({
+	return RxInstanceUtils.observeParentBrio(humanoid):Pipe({
 		RxBrioUtils.switchMapBrio(function(character)
 			return RxRootPartUtils.observeHumanoidRootPartBrio(character)
 		end)

src/toolutils/README.md

@@ -0,0 +1,23 @@
+## ToolUtils
+
+<div align="center">
+  <a href="http://quenty.github.io/NevermoreEngine/">
+    <img src="https://github.com/Quenty/NevermoreEngine/actions/workflows/docs.yml/badge.svg" alt="Documentation status" />
+  </a>
+  <a href="https://discord.gg/mhtGUS8">
+    <img src="https://img.shields.io/discord/385151591524597761?color=5865F2&label=discord&logo=discord&logoColor=white" alt="Discord" />
+  </a>
+  <a href="https://github.com/Quenty/NevermoreEngine/actions">
+    <img src="https://github.com/Quenty/NevermoreEngine/actions/workflows/build.yml/badge.svg" alt="Build and release status" />
+  </a>
+</div>
+
+Utility methods for tools
+
+<div align="center"><a href="https://quenty.github.io/NevermoreEngine/api/RxToolUtils">View docs →</a></div>
+
+## Installation
+
+```
+npm install @quenty/toolutils --save
+```

src/toolutils/default.project.json

@@ -0,0 +1,7 @@
+{
+  "name": "toolutils",
+  "globIgnorePaths": [ "**/.package-lock.json" ],
+  "tree": {
+    "$path": "src"
+  }
+}

src/toolutils/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@quenty/toolutils",
+  "version": "1.0.0",
+  "description": "Utility methods for tools",
+  "keywords": [
+    "Roblox",
+    "Nevermore",
+    "Lua",
+    "toolutils"
+  ],
+  "bugs": {
+    "url": "https://github.com/Quenty/NevermoreEngine/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Quenty/NevermoreEngine.git",
+    "directory": "src/toolutils/"
+  },
+  "funding": {
+    "type": "patreon",
+    "url": "https://www.patreon.com/quenty"
+  },
+  "license": "MIT",
+  "contributors": [
+    "Quenty"
+  ],
+  "dependencies": {
+    "@quenty/brio": "file:../brio",
+    "@quenty/instanceutils": "file:../instanceutils",
+    "@quenty/loader": "file:../loader",
+    "@quenty/rx": "file:../rx"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

src/toolutils/src/Shared/RxToolUtils.lua

@@ -0,0 +1,30 @@
+--[=[
+	@class RxToolUtils
+]=]
+
+local require = require(script.Parent.loader).load(script)
+
+local RxInstanceUtils = require("RxInstanceUtils")
+local RxBrioUtils = require("RxBrioUtils")
+
+local RxToolUtils = {}
+
+--[=[
+	Observes the equipped humanoid of a given tool
+
+	@param tool Instance
+	@return Observable<Brio<Humanoid>>
+]=]
+function RxToolUtils.observeEquippedHumanoidBrio(tool)
+	assert(typeof(tool) == "Instance", "Bad tool")
+
+	return RxInstanceUtils.observePropertyBrio(tool, "Parent", function(parent)
+		return parent and parent:IsA("Model")
+	end):Pipe({
+		RxBrioUtils.switchMapBrio(function(parent)
+			return RxInstanceUtils.observeChildrenOfClassBrio(parent, "Humanoid")
+		end);
+	})
+end
+
+return RxToolUtils

src/toolutils/src/Shared/ToolUtils.lua

@@ -0,0 +1,44 @@
+--[=[
+	@class ToolUtils
+]=]
+
+local require = require(script.Parent.loader).load(script)
+
+local CharacterUtils = require("CharacterUtils")
+
+local ToolUtils = {}
+
+--[=[
+	Gets the equipped humanoid for a given tool
+]=]
+function ToolUtils.getEquippedHumanoid(tool: Tool): Humanoid?
+	assert(typeof(tool) == "Instance", "Bad tool")
+
+	local character = tool.Parent
+	if not (character and character:IsA("Model")) then
+		return nil
+	end
+
+	local humanoid = character:FindFirstChildWhichIsA("Humanoid")
+	if not humanoid then
+		return nil
+	end
+
+	return humanoid
+end
+
+--[=[
+	Gets the equipped player for a given tool
+]=]
+function ToolUtils.getEquippedPlayer(tool: Tool): Player?
+	assert(typeof(tool) == "Instance", "Bad tool")
+
+	local humanoid = ToolUtils.getEquippedHumanoid(tool)
+	if not humanoid then
+		return nil
+	end
+
+	return CharacterUtils.getPlayerFromCharacter(humanoid)
+end
+
+return ToolUtils

src/toolutils/src/node_modules.project.json

@@ -0,0 +1,7 @@
+{
+  "name": "node_modules",
+  "globIgnorePaths": [ "**/.package-lock.json" ],
+  "tree": {
+    "$path": { "optional": "../node_modules" }
+  }
+}

src/toolutils/test/default.project.json

@@ -0,0 +1,12 @@
+{
+  "name": "ToolUtilsTest",
+  "globIgnorePaths": [ "**/.package-lock.json" ],
+  "tree": {
+    "$className": "DataModel",
+    "ServerScriptService": {
+      "toolutils": {
+        "$path": ".."
+      }
+    }
+  }
+}