@quenty/inputobjectutils 4.29.0-canary.678.24427877603.0 → 4.29.0

package/CHANGELOG.md

@@ -3,9 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-# [4.29.0-canary.678.24427877603.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/inputobjectutils@4.28.0...@quenty/inputobjectutils@4.29.0-canary.678.24427877603.0) (2026-04-14)
+# [4.29.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/inputobjectutils@4.28.0...@quenty/inputobjectutils@4.29.0) (2026-04-23)
 
-**Note:** Version bump only for package @quenty/inputobjectutils
+
+### Bug Fixes
+
+* Fix dependencies list ([776b270](https://github.com/Quenty/NevermoreEngine/commit/776b2700b97d877b70c487d2f47092bacc373e7a))
+
+
+### Features
+
+* Additional improvments ([44896ef](https://github.com/Quenty/NevermoreEngine/commit/44896efe8dd9506ad6002bc41f816b9b2b482ebc))
 
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/inputobjectutils",
-  "version": "4.29.0-canary.678.24427877603.0",
+  "version": "4.29.0",
   "description": "Provides utility functions involving input objects",
   "keywords": [
     "Roblox",
@@ -31,11 +31,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@quenty/baseobject": "10.12.0",
-    "@quenty/loader": "10.10.0",
-    "@quenty/maid": "3.8.0",
-    "@quenty/rx": "13.28.0-canary.678.24427877603.0",
-    "@quenty/rxsignal": "7.28.0-canary.678.24427877603.0"
+    "@quenty/baseobject": "10.13.0",
+    "@quenty/loader": "10.11.0",
+    "@quenty/maid": "3.9.0",
+    "@quenty/rx": "13.28.0",
+    "@quenty/rxsignal": "7.28.0",
+    "@quenty/uiobjectutils": "6.28.0"
   },
-  "gitHead": "ac87c7f47e9a5801392a70d586ed449463a725b8"
+  "gitHead": "9413391da8b6f9026762285b601fd1d37d385a54"
 }

package/src/Client/InputObjectTracker.lua

@@ -31,12 +31,12 @@
 
 local require = require(script.Parent.loader).load(script)
 
-local UserInputService = game:GetService("UserInputService")
 local Workspace = game:GetService("Workspace")
 
 local BaseObject = require("BaseObject")
 local InputObjectRayUtils = require("InputObjectRayUtils")
 local InputObjectUtils = require("InputObjectUtils")
+local MousePositionUtils = require("MousePositionUtils")
 local Observable = require("Observable")
 local RxInputObjectUtils = require("RxInputObjectUtils")
 local RxSignal = require("RxSignal")
@@ -60,10 +60,6 @@ export type InputObjectTracker =
 	))
 	& BaseObject.BaseObject
 
-local function toVector2(vector3: Vector3): Vector2
-	return Vector2.new(vector3.X, vector3.Y)
-end
-
 function InputObjectTracker.new(initialInputObject: InputObject): InputObjectTracker
 	assert(typeof(initialInputObject) == "Instance" and initialInputObject:IsA("InputObject"), "Bad initialInputObject")
 
@@ -83,27 +79,15 @@ function InputObjectTracker.new(initialInputObject: InputObject): InputObjectTra
 end
 
 function InputObjectTracker._setupMouse(self: InputObjectTracker): ()
-	self._lastMousePosition = toVector2(self._initialInputObject.Position)
+	self._lastMousePosition = MousePositionUtils.mouseUserInputObjectToMousePosition(self._initialInputObject)
+		or error("Failed to retrieve position")
 	self._isMouse = true
 
-	self._maid:GiveTask(UserInputService.InputBegan:Connect(function(inputObject)
-		if InputObjectUtils.isMouseUserInputType(inputObject.UserInputType) then
-			self._lastMousePosition = toVector2(inputObject.Position)
-		end
-	end))
-
-	self._maid:GiveTask(UserInputService.InputChanged:Connect(function(inputObject)
-		if InputObjectUtils.isMouseUserInputType(inputObject.UserInputType) then
-			self._lastMousePosition = toVector2(inputObject.Position)
-		end
-	end))
-
-	self._maid:GiveTask(UserInputService.InputEnded:Connect(function(inputObject)
-		if InputObjectUtils.isMouseUserInputType(inputObject.UserInputType) then
-			self._lastMousePosition = toVector2(inputObject.Position)
-		end
+	self._maid:GiveTask(MousePositionUtils.observeMousePosition(self._initialInputObject):Subscribe(function(position)
+		self._lastMousePosition = position
 	end))
 end
+
 --[=[
 	Observes when the input is ended
 

package/src/Client/MouseIconTypeUtils.lua

@@ -0,0 +1,50 @@
+--!strict
+--[=[
+    @class MouseIconTypeUtils
+]=]
+
+local require = require(script.Parent.loader).load(script)
+
+local PlayerGuiUtils = require("PlayerGuiUtils")
+
+local MouseIconTypeUtils = {}
+
+export type IconType = "arrow" | "openhand" | "ibeam" | "closedhand"
+
+function MouseIconTypeUtils.getIconUnderPosition(position: Vector2): IconType
+	local playerGui = PlayerGuiUtils.getPlayerGui()
+	if not playerGui then
+		return "arrow"
+	end
+
+	local guiObjects = playerGui:GetGuiObjectsAtPosition(position.X, position.Y)
+	for _, guiObject in guiObjects do
+		if guiObject:IsA("TextBox") then
+			if guiObject.GuiState == Enum.GuiState.Hover or guiObject.GuiState == Enum.GuiState.Press then
+				return "ibeam"
+			end
+		elseif guiObject:IsA("ImageButton") or guiObject:IsA("TextButton") then
+			if guiObject.GuiState == Enum.GuiState.Hover or guiObject.GuiState == Enum.GuiState.Press then
+				return "openhand"
+			end
+		end
+	end
+
+	return "arrow"
+end
+
+function MouseIconTypeUtils.getDefaultIconAssetForType(iconType: IconType): string
+	if iconType == "arrow" then
+		return "rbxasset://textures/Cursors/KeyboardMouse/ArrowFarCursor.png"
+	elseif iconType == "openhand" then
+		return "rbxasset://textures/Cursors/KeyboardMouse/ArrowCursor.png"
+	elseif iconType == "closedhand" then
+		return "rbxasset://textures/Cursors/DragDetector/ActivatedCursor.png"
+	elseif iconType == "ibeam" then
+		return "rbxasset://textures/Cursors/KeyboardMouse/IBeamCursor.png"
+	else
+		error("Unknown icon type: " .. tostring(iconType))
+	end
+end
+
+return MouseIconTypeUtils

package/src/Client/MousePositionUtils.lua

@@ -0,0 +1,107 @@
+--!strict
+--[=[
+    @class MousePositionUtils
+]=]
+
+local require = require(script.Parent.loader).load(script)
+
+local GuiService = game:GetService("GuiService")
+local Players = game:GetService("Players")
+local UserInputService = game:GetService("UserInputService")
+
+local InputObjectUtils = require("InputObjectUtils")
+local Maid = require("Maid")
+local Observable = require("Observable")
+
+local MousePositionUtils = {}
+
+local function toVector2(vector3: Vector3): Vector2
+	return Vector2.new(vector3.X, vector3.Y)
+end
+
+--[=[
+    Converts an InputObject to a mouse position if it's a mouse input, otherwise returns nil.
+]=]
+function MousePositionUtils.mouseUserInputObjectToMousePosition(inputObject: InputObject): Vector2?
+	if InputObjectUtils.isMouseUserInputType(inputObject.UserInputType) then
+		return toVector2(inputObject.Position)
+	else
+		return nil
+	end
+end
+
+--[=[
+    Observes the mouse position based on UserInputService events. Optionally takes an initial InputObject to seed the position.
+]=]
+function MousePositionUtils.observeMousePosition(initialInputObject: InputObject?): Observable.Observable<Vector2>
+	return Observable.new(function(sub)
+		local maid = Maid.new()
+		local lastMousePosition: Vector2? = nil
+
+		local function setMousePosition(position: Vector2)
+			if lastMousePosition ~= position then
+				lastMousePosition = position
+				sub:Fire(position)
+			end
+		end
+
+		maid:GiveTask(UserInputService.InputBegan:Connect(function(inputObject)
+			local position = MousePositionUtils.mouseUserInputObjectToMousePosition(inputObject)
+			if position then
+				setMousePosition(position)
+			end
+		end))
+
+		maid:GiveTask(UserInputService.InputChanged:Connect(function(inputObject)
+			local position = MousePositionUtils.mouseUserInputObjectToMousePosition(inputObject)
+			if position then
+				setMousePosition(position)
+			end
+		end))
+
+		maid:GiveTask(UserInputService.InputEnded:Connect(function(inputObject)
+			local position = MousePositionUtils.mouseUserInputObjectToMousePosition(inputObject)
+			if position then
+				setMousePosition(position)
+			end
+		end))
+
+		local initial = if initialInputObject
+			then MousePositionUtils.mouseUserInputObjectToMousePosition(initialInputObject)
+			else nil
+		if initial then
+			setMousePosition(initial)
+		else
+			setMousePosition(MousePositionUtils.queryMousePositionFromUserInputService())
+		end
+
+		return function()
+			maid:DoCleaning()
+		end
+	end) :: any
+end
+
+--[=[
+    Gets the same mouse position as we'd get from :GetMouse() call, with the gui insets accounted for
+]=]
+function MousePositionUtils.queryMousePositionFromUserInputService(): Vector2
+	local guiInsetTopLeft = GuiService:GetGuiInset()
+	local location = UserInputService:GetMouseLocation()
+	return Vector2.new(location.X + guiInsetTopLeft.x, location.Y + guiInsetTopLeft.y)
+end
+
+function MousePositionUtils._queryMousePositionFromLocalPlayer(): Vector2?
+	local localPlayer = Players.LocalPlayer
+	if not localPlayer then
+		return nil
+	end
+
+	local mouse = localPlayer:GetMouse()
+	if not mouse then
+		return nil
+	end
+
+	return Vector2.new(mouse.X, mouse.Y)
+end
+
+return MousePositionUtils