@quenty/humanoidutils 2.2.3 → 2.3.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [2.3.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/humanoidutils@2.2.3...@quenty/humanoidutils@2.3.0) (2025-10-01)
+
+
+### Features
+
+* Add RxHumanoidUtils ([#593](https://github.com/Quenty/NevermoreEngine/issues/593)) ([23580a9](https://github.com/Quenty/NevermoreEngine/commit/23580a979936eb13dd850b097b7c050e54373d37))
+
+
+
+
+
 ## [2.2.3](https://github.com/Quenty/NevermoreEngine/compare/@quenty/humanoidutils@2.2.1...@quenty/humanoidutils@2.2.3) (2025-04-07)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/humanoidutils",
-  "version": "2.2.3",
+  "version": "2.3.0",
   "description": "General humanoid utility code.",
   "keywords": [
     "Roblox",
@@ -27,5 +27,10 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "64def70499ec067077ee39f279936b620b217847"
+  "dependencies": {
+    "@quenty/loader": "^10.9.0",
+    "@quenty/maid": "^3.5.0",
+    "@quenty/rx": "^13.20.0"
+  },
+  "gitHead": "a5d81d29cf2bc0176b36ae27694c76c9246c583a"
 }

package/src/Shared/RxHumanoidUtils.lua

@@ -0,0 +1,64 @@
+--[=[
+	@class RxHumanoidUtils
+]=]
+
+local require = require(script.Parent.loader).load(script)
+
+local Maid = require("Maid")
+local Observable = require("Observable")
+
+local RxHumanoidUtils = {}
+
+--[=[
+	Observes the running speed of a humanoid
+
+	:::tip
+	When using :MoveTo this is the only way to know if the humanoid is walking at any speed
+	:::
+
+	@return Observable<number>
+]=]
+function RxHumanoidUtils.observeRunningSpeed(humanoid: Humanoid): Observable.Observable<number>
+	assert(typeof(humanoid) == "Instance" and humanoid:IsA("Humanoid"), "No humanoid")
+
+	return Observable.new(function(sub)
+		local maid = Maid.new()
+
+		local lastRunningSpeed = nil
+
+		local function emitRunningSpeed(speed: number)
+			if lastRunningSpeed ~= speed then
+				lastRunningSpeed = speed
+				sub:Fire(speed)
+			end
+		end
+
+		maid:GiveTask(humanoid.Running:Connect(function(speed)
+			emitRunningSpeed(speed)
+		end))
+
+		maid:GiveTask(humanoid.Swimming:Connect(function()
+			emitRunningSpeed(0)
+		end))
+
+		maid:GiveTask(humanoid.Jumping:Connect(function()
+			emitRunningSpeed(0)
+		end))
+
+		maid:GiveTask(humanoid.FreeFalling:Connect(function()
+			emitRunningSpeed(0)
+		end))
+
+		maid:GiveTask(humanoid.Seated:Connect(function()
+			emitRunningSpeed(0)
+		end))
+
+		if not lastRunningSpeed then
+			emitRunningSpeed(0)
+		end
+
+		return maid
+	end)
+end
+
+return RxHumanoidUtils

package/src/node_modules.project.json

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