@quenty/ik 15.34.3 → 15.34.4

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [15.34.4](https://github.com/Quenty/NevermoreEngine/compare/@quenty/ik@15.34.3...@quenty/ik@15.34.4) (2025-12-28)
+
+
+### Bug Fixes
+
+* Retrieve priority ([ade11b6](https://github.com/Quenty/NevermoreEngine/commit/ade11b6743f9d9dc7ad2324bcbb31d58669f048e))
+* Typecheck some more things ([41eaaa6](https://github.com/Quenty/NevermoreEngine/commit/41eaaa6d053c469f7548810da72d05dfbf997b26))
+
+
+
+
+
 ## [15.34.3](https://github.com/Quenty/NevermoreEngine/compare/@quenty/ik@15.34.2...@quenty/ik@15.34.3) (2025-12-13)
 
 **Note:** Version bump only for package @quenty/ik

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/ik",
-  "version": "15.34.3",
+  "version": "15.34.4",
   "description": "Inverse Kinematics for characters on Roblox",
   "keywords": [
     "Roblox",
@@ -28,28 +28,28 @@
   "dependencies": {
     "@quenty/acceltween": "^2.5.3",
     "@quenty/baseobject": "^10.9.0",
-    "@quenty/binder": "^14.25.2",
+    "@quenty/binder": "^14.25.3",
     "@quenty/brio": "^14.20.1",
-    "@quenty/camera": "^14.26.2",
+    "@quenty/camera": "^14.26.3",
     "@quenty/characterutils": "^12.22.2",
-    "@quenty/humanoidtracker": "^13.21.2",
+    "@quenty/humanoidtracker": "^13.21.3",
     "@quenty/instanceutils": "^13.20.2",
     "@quenty/loader": "^10.9.0",
     "@quenty/maid": "^3.5.0",
     "@quenty/math": "^2.7.3",
-    "@quenty/motor6d": "^7.28.2",
+    "@quenty/motor6d": "^7.28.3",
     "@quenty/optional": "^11.9.0",
     "@quenty/promise": "^10.12.0",
     "@quenty/qframe": "^10.12.1",
     "@quenty/r15utils": "^13.21.2",
-    "@quenty/ragdoll": "^15.33.2",
+    "@quenty/ragdoll": "^15.33.3",
     "@quenty/remoting": "^12.21.2",
     "@quenty/rx": "^13.20.0",
-    "@quenty/servicebag": "^11.13.1",
+    "@quenty/servicebag": "^11.13.2",
     "@quenty/signal": "^7.11.1",
     "@quenty/table": "^3.8.0",
-    "@quenty/tie": "^10.26.2",
-    "@quenty/valueobject": "^13.21.2"
+    "@quenty/tie": "^10.26.3",
+    "@quenty/valueobject": "^13.21.3"
   },
   "devDependencies": {
     "@quenty/rigbuilderutils": "^10.22.3"
@@ -57,5 +57,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "08c1d0559af2bbcece6d586897c91a630dfb3f51"
+  "gitHead": "821c9336020dfbcf5cd2f67f2dfe61624233ee06"
 }

package/src/Shared/Arm/ArmIKBase.lua

@@ -1,3 +1,4 @@
+--!nonstrict
 --[=[
 	Provides IK for a given arm
 	@class ArmIKBase

package/src/Shared/Arm/ArmIKUtils.lua

@@ -1,3 +1,4 @@
+--!strict
 --[=[
 	@class ArmIKUtils
 ]=]
@@ -10,7 +11,9 @@ local RxR15Utils = require("RxR15Utils")
 
 local ArmIKUtils = {}
 
-function ArmIKUtils.ensureMotorAnimated(character: Model, armName)
+export type ArmName = "Left" | "Right"
+
+function ArmIKUtils.ensureMotorAnimated(character: Model, armName: ArmName): Maid.Maid
 	local topMaid = Maid.new()
 
 	local function disable(brio)

package/src/Shared/Grip/IKGripBase.lua

@@ -1,3 +1,4 @@
+--!strict
 --[=[
 	Meant to be used with a binder
 	@class IKGripBase
@@ -16,11 +17,23 @@ local IKGripBase = setmetatable({}, BaseObject)
 IKGripBase.ClassName = "IKGripBase"
 IKGripBase.__index = IKGripBase
 
-function IKGripBase.new(objectValue: ObjectValue, serviceBag: ServiceBag.ServiceBag)
-	local self = setmetatable(BaseObject.new(objectValue), IKGripBase)
+export type IKGripBase =
+	typeof(setmetatable(
+		{} :: {
+			_obj: Instance,
+			_serviceBag: ServiceBag.ServiceBag,
+			_attachment: Attachment,
+			_ikRigPromise: Promise.Promise<any>,
+		},
+		{} :: typeof({ __index = IKGripBase })
+	))
+	& BaseObject.BaseObject
+
+function IKGripBase.new(objectValue: ObjectValue, serviceBag: ServiceBag.ServiceBag): IKGripBase
+	local self: IKGripBase = setmetatable(BaseObject.new(objectValue) :: any, IKGripBase)
 
 	self._serviceBag = assert(serviceBag, "No serviceBag")
-	self._attachment = self._obj.Parent
+	self._attachment = self._obj.Parent :: any
 
 	assert(self._obj:IsA("ObjectValue"), "Not an object value")
 	assert(self._attachment:IsA("Attachment"), "Not parented to an attachment")
@@ -28,15 +41,15 @@ function IKGripBase.new(objectValue: ObjectValue, serviceBag: ServiceBag.Service
 	return self
 end
 
-function IKGripBase:GetPriority(): number
+function IKGripBase.GetPriority(_self: IKGripBase): number
 	return 1
 end
 
-function IKGripBase:GetAttachment(): Attachment?
-	return self._obj.Parent
+function IKGripBase.GetAttachment(self: IKGripBase): Attachment?
+	return self._attachment
 end
 
-function IKGripBase:PromiseIKRig()
+function IKGripBase.PromiseIKRig(self: IKGripBase): Promise.Promise<any>
 	if self._ikRigPromise then
 		return self._ikRigPromise
 	end
@@ -48,10 +61,7 @@ function IKGripBase:PromiseIKRig()
 		ikService = self._serviceBag:GetService((require :: any)("IKServiceClient"))
 	end
 
-	local promise = promisePropertyValue(self._obj, "Value")
-	self._maid:GiveTask(promise)
-
-	self._ikRigPromise = promise:Then(function(humanoid)
+	self._ikRigPromise = self._maid:Add(promisePropertyValue(self._obj, "Value")):Then(function(humanoid)
 		if not humanoid:IsA("Humanoid") then
 			warn("[IKGripBase.PromiseIKRig] - Humanoid in link is not a humanoid")
 			return Promise.rejected()
@@ -60,7 +70,7 @@ function IKGripBase:PromiseIKRig()
 		return self._maid:GivePromise(ikService:PromiseRig(humanoid))
 	end)
 
-	return self._ikRigPromise
+	return self._ikRigPromise :: any
 end
 
 return IKGripBase

package/src/Shared/IKDataService.lua

@@ -1,3 +1,4 @@
+--!strict
 --[=[
 	@class IKDataService
 ]=]

package/src/Shared/IKUtils.lua

@@ -6,6 +6,14 @@
 
 local IKUtils = {}
 
+--[=[
+	Returns a function that dampens angles approaching maxAngle.
+
+	@param maxAngle number -- The maximum angle allowed
+	@param dampenAreaAngle number -- The area over which to dampen
+	@param dampenAreaFactor number? -- The factor to use for dampening. Defaults to dampenAreaAngle.
+	@return (number) -> number -- A function that takes an angle and returns a dampened angle
+]=]
 function IKUtils.getDampenedAngleClamp(
 	maxAngle: number,
 	dampenAreaAngle: number,

package/src/Shared/Resources/IKResource.lua

@@ -1,3 +1,4 @@
+--!strict
 --[=[
 	@class IKResource
 ]=]
@@ -5,29 +6,46 @@
 local require = require(script.Parent.loader).load(script)
 
 local BaseObject = require("BaseObject")
+local IKResourceUtils = require("IKResourceUtils")
 local Maid = require("Maid")
+local Signal = require("Signal")
 local ValueObject = require("ValueObject")
 
 local IKResource = setmetatable({}, BaseObject)
 IKResource.ClassName = "IKResource"
 IKResource.__index = IKResource
 
-function IKResource.new(data)
-	local self = setmetatable(BaseObject.new(), IKResource)
+export type IKResource =
+	typeof(setmetatable(
+		{} :: {
+			_data: IKResourceUtils.IKResourceData,
+			_instance: Instance?,
+			_childResourceMap: { [string]: IKResource },
+			_descendantLookupMap: { [string]: IKResource },
+			_ready: ValueObject.ValueObject<boolean>,
+
+			ReadyChanged: Signal.Signal<boolean>,
+		},
+		{} :: typeof({ __index = IKResource })
+	))
+	& BaseObject.BaseObject
+
+function IKResource.new(data: IKResourceUtils.IKResourceData): IKResource
+	local self: IKResource = setmetatable(BaseObject.new() :: any, IKResource)
 
 	self._data = assert(data, "Bad data")
 	assert(data.name, "Bad data.name")
 	assert(data.robloxName, "Bad data.robloxName")
 
 	self._instance = nil
-	self._childResourceMap = {} -- [robloxName] = { data = data; ikResource = ikResource }
+	self._childResourceMap = {} -- [robloxName] = IKResource
 	self._descendantLookupMap = {
 		[data.name] = self,
 	}
 
 	self._ready = self._maid:Add(ValueObject.new(false, "boolean"))
 
-	self.ReadyChanged = self._ready.Changed
+	self.ReadyChanged = self._ready.Changed :: any
 
 	if self._data.children then
 		for _, childData in self._data.children do
@@ -38,15 +56,15 @@ function IKResource.new(data)
 	return self
 end
 
-function IKResource:GetData()
+function IKResource.GetData(self: IKResource): IKResourceUtils.IKResourceData
 	return self._data
 end
 
-function IKResource:IsReady(): boolean
+function IKResource.IsReady(self: IKResource): boolean
 	return self._ready.Value
 end
 
-function IKResource:Get(descendantName: string)
+function IKResource.Get(self: IKResource, descendantName: string)
 	local resource = self._descendantLookupMap[descendantName]
 	if not resource then
 		error(string.format("[IKResource.Get] - Resource %q does not exist", tostring(descendantName)))
@@ -60,9 +78,9 @@ function IKResource:Get(descendantName: string)
 	return result
 end
 
-function IKResource:GetInstance(): Instance?
+function IKResource.GetInstance(self: IKResource): Instance?
 	if self._data.isLink then
-		if self._instance then
+		if self._instance and self._instance:IsA("ObjectValue") then
 			return self._instance.Value
 		else
 			return nil
@@ -72,7 +90,7 @@ function IKResource:GetInstance(): Instance?
 	return self._instance
 end
 
-function IKResource:SetInstance(instance: Instance?)
+function IKResource.SetInstance(self: IKResource, instance: Instance?)
 	if self._instance == instance then
 		return
 	end
@@ -91,7 +109,7 @@ function IKResource:SetInstance(instance: Instance?)
 	end
 
 	if instance and self._data.isLink then
-		assert(instance:IsA("ObjectValue"))
+		assert(instance:IsA("ObjectValue"), "Bad instance for link IKResource")
 
 		self._maid:GiveTask(instance.Changed:Connect(function()
 			self:_updateReady()
@@ -102,11 +120,11 @@ function IKResource:SetInstance(instance: Instance?)
 	self:_updateReady()
 end
 
-function IKResource:GetLookupTable()
+function IKResource.GetLookupTable(self: IKResource)
 	return self._descendantLookupMap
 end
 
-function IKResource:_startListening(maid, instance)
+function IKResource._startListening(self: IKResource, maid, instance)
 	for _, child in instance:GetChildren() do
 		self:_handleChildAdded(child)
 	end
@@ -119,7 +137,7 @@ function IKResource:_startListening(maid, instance)
 	end))
 end
 
-function IKResource:_addResource(ikResource)
+function IKResource._addResource(self: IKResource, ikResource: IKResource)
 	local data = ikResource:GetData()
 	assert(data.name, "Bad data.name")
 	assert(data.robloxName, "Bad data.robloxName")
@@ -144,7 +162,7 @@ function IKResource:_addResource(ikResource)
 	end
 end
 
-function IKResource:_handleChildAdded(child)
+function IKResource._handleChildAdded(self: IKResource, child)
 	local resource = self._childResourceMap[child.Name]
 	if not resource then
 		return
@@ -153,7 +171,7 @@ function IKResource:_handleChildAdded(child)
 	resource:SetInstance(child)
 end
 
-function IKResource:_handleChildRemoved(child)
+function IKResource._handleChildRemoved(self: IKResource, child)
 	local resource = self._childResourceMap[child.Name]
 	if not resource then
 		return
@@ -164,28 +182,28 @@ function IKResource:_handleChildRemoved(child)
 	end
 end
 
-function IKResource:_clearChildren()
-	for _, child in self._childResourceMap do
+function IKResource._clearChildren(self: IKResource)
+	for _, child: any in self._childResourceMap do
 		child:SetInstance(nil)
 	end
 end
 
-function IKResource:_updateReady()
+function IKResource._updateReady(self: IKResource)
 	self._ready.Value = self:_calculateIsReady()
 end
 
-function IKResource:_calculateIsReady()
+function IKResource._calculateIsReady(self: IKResource)
 	if not self._instance then
 		return false
 	end
 
 	if self._data.isLink then
-		if not self._instance.Value then
+		if self._instance and self._instance:IsA("ObjectValue") and not self._instance.Value then
 			return false
 		end
 	end
 
-	for _, child in self._childResourceMap do
+	for _, child: any in self._childResourceMap do
 		if not child:IsReady() then
 			return false
 		end

package/src/Shared/Resources/IKResourceUtils.lua

@@ -1,10 +1,18 @@
+--!strict
 --[=[
 	@class IKResourceUtils
 ]=]
 
 local IKResourceUtils = {}
 
-function IKResourceUtils.createResource(data)
+export type IKResourceData = {
+	name: string,
+	isLink: boolean?,
+	robloxName: string,
+	children: { IKResourceData }?,
+}
+
+function IKResourceUtils.createResource(data: IKResourceData): IKResourceData
 	assert(type(data) == "table", "Bad data")
 	assert(data.name, "Bad data.name")
 	assert(data.robloxName, "Bad data.robloxName")

package/src/Shared/Torso/TorsoIKBase.lua

@@ -16,8 +16,38 @@ local TorsoIKBase = setmetatable({}, BaseObject)
 TorsoIKBase.__index = TorsoIKBase
 TorsoIKBase.ClassName = "TorsoIKBase"
 
+export type TorsoIKBase =
+	typeof(setmetatable(
+		{} :: {
+			_humanoid: Humanoid,
+			_resources: IKResource.IKResource,
+			_waistY: AccelTween.AccelTween,
+			_waistZ: AccelTween.AccelTween,
+			_headY: AccelTween.AccelTween,
+			_headZ: AccelTween.AccelTween,
+			_relWaistTransform: CFrame?,
+			_relNeckTransform: CFrame?,
+			_lastValidWaistTransform: CFrame,
+			_lastWaistTransform: CFrame,
+			_lastValidNeckTransform: CFrame,
+			_lastNeckTransform: CFrame,
+			_target: Vector3?,
+
+			Pointed: Signal.Signal<Vector3?>,
+
+			Update: (self: TorsoIKBase) -> (),
+			UpdateTransformOnly: (self: TorsoIKBase) -> (),
+			Point: (self: TorsoIKBase, position: Vector3?) -> (),
+			GetAimPosition: (self: TorsoIKBase) -> Vector3?,
+			GetTargetUpperTorsoCFrame: (self: TorsoIKBase) -> CFrame?,
+			GetUpperTorsoCFrame: (self: TorsoIKBase) -> CFrame?,
+		},
+		{} :: typeof({ __index = TorsoIKBase })
+	))
+	& BaseObject.BaseObject
+
 function TorsoIKBase.new(humanoid: Humanoid)
-	local self = setmetatable(BaseObject.new(), TorsoIKBase)
+	local self: TorsoIKBase = setmetatable(BaseObject.new() :: any, TorsoIKBase)
 
 	self._humanoid = humanoid or error("No humanoid")
 
@@ -25,7 +55,8 @@ function TorsoIKBase.new(humanoid: Humanoid)
 
 	self._resources = IKResource.new(IKResourceUtils.createResource({
 		name = "Character",
-		robloxName = self._humanoid.Parent.Name,
+		-- TODO: Fix this potentail error
+		robloxName = (self._humanoid :: any).Parent.Name,
 		children = {
 			IKResourceUtils.createResource({
 				name = "RootPart",