@quenty/animations 8.18.0-canary.ae8d76d.0 → 8.18.1-canary.bc9c542.0

package/CHANGELOG.md

@@ -3,7 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-# [8.18.0-canary.ae8d76d.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/animations@8.17.3...@quenty/animations@8.18.0-canary.ae8d76d.0) (2025-05-10)
+## [8.18.1-canary.bc9c542.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/animations@8.18.0...@quenty/animations@8.18.1-canary.bc9c542.0) (2025-07-11)
+
+
+### Features
+
+* **AnimationSlotPlayer:** promise animation Stopped ([674b3af](https://github.com/Quenty/NevermoreEngine/commit/674b3afe54848bddd18faebace0f075e1b541a12))
+
+
+
+
+
+# [8.18.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/animations@8.17.3...@quenty/animations@8.18.0) (2025-05-10)
 
 
 ### Bug Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/animations",
-  "version": "8.18.0-canary.ae8d76d.0",
+  "version": "8.18.1-canary.bc9c542.0",
   "description": "Utility methods for playing back animations on Roblox",
   "keywords": [
     "Roblox",
@@ -25,20 +25,20 @@
     "Quenty"
   ],
   "dependencies": {
-    "@quenty/baseobject": "10.8.3",
+    "@quenty/baseobject": "10.9.0",
     "@quenty/enumutils": "3.4.2",
-    "@quenty/humanoidanimatorutils": "3.1.2",
-    "@quenty/loader": "10.8.3",
-    "@quenty/maid": "3.4.3",
-    "@quenty/promise": "10.11.0-canary.ae8d76d.0",
-    "@quenty/promisemaid": "5.11.0-canary.ae8d76d.0",
-    "@quenty/rbxasset": "5.8.3",
-    "@quenty/rx": "13.18.0-canary.ae8d76d.0",
-    "@quenty/signal": "7.10.3",
-    "@quenty/valueobject": "13.18.0-canary.ae8d76d.0"
+    "@quenty/humanoidanimatorutils": "3.2.0",
+    "@quenty/loader": "10.9.0",
+    "@quenty/maid": "3.5.0",
+    "@quenty/promise": "10.11.0",
+    "@quenty/promisemaid": "5.11.0",
+    "@quenty/rbxasset": "5.9.0",
+    "@quenty/rx": "13.18.0",
+    "@quenty/signal": "7.11.0",
+    "@quenty/valueobject": "13.18.0"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "ae8d76d996594e017ac4bfa19f3c064ebe307cd8"
+  "gitHead": "bc9c54214ba5ef245787085e26626eaaf9fb0e9e"
 }

package/src/Shared/AnimationPromiseUtils.lua

@@ -100,7 +100,10 @@ end
 	@param keyframeName string
 	@return Promise
 ]=]
-function AnimationPromiseUtils.promiseKeyframeReached(animationTrack: AnimationTrack, keyframeName: string): Promise.Promise<()>
+function AnimationPromiseUtils.promiseKeyframeReached(
+	animationTrack: AnimationTrack,
+	keyframeName: string
+): Promise.Promise<()>
 	assert(typeof(animationTrack) == "Instance", "Bad animationTrack")
 	assert(type(keyframeName) == "string", "Bad endMarkerName")
 
@@ -127,5 +130,4 @@ function AnimationPromiseUtils.promiseKeyframeReached(animationTrack: AnimationT
 	return promise
 end
 
-
-return AnimationPromiseUtils
+return AnimationPromiseUtils

package/src/Shared/AnimationSlotPlayer.lua

@@ -12,6 +12,8 @@ local AnimationUtils = require("AnimationUtils")
 local BaseObject = require("BaseObject")
 local EnumUtils = require("EnumUtils")
 local Maid = require("Maid")
+local Promise = require("Promise")
+local PromiseMaidUtils = require("PromiseMaidUtils")
 local RbxAssetUtils = require("RbxAssetUtils")
 local ValueObject = require("ValueObject")
 
@@ -93,6 +95,44 @@ type AnimationData = {
 	originalPriority: Enum.AnimationPriority?,
 }
 
+--[=[
+	Promises that the animation has stopped playing
+]=]
+function AnimationSlotPlayer.PromiseStopped(self: AnimationSlotPlayer): Promise.Promise<boolean>
+	local promise = Promise.new()
+
+	PromiseMaidUtils.whilePromise(promise, function(topMaid)
+		topMaid:GiveTask(self._currentAnimationTrackData
+			:ObserveBrio(function(data: AnimationData?)
+				return data ~= nil
+			end)
+			:Subscribe(function(brio)
+				if brio:IsDead() then
+					return
+				end
+
+				local data: AnimationData = brio:GetValue()
+				if not data.track.IsPlaying then
+					promise:Resolve(true)
+					return
+				end
+
+				local maid = brio:ToMaid()
+				maid:GiveTask(data.track.Stopped:Connect(function()
+					promise:Resolve()
+				end))
+			end))
+
+		topMaid:GiveTask(function()
+			self._maid[promise] = nil
+		end)
+	end)
+
+	self._maid[promise] = promise
+
+	return promise
+end
+
 --[=[
 	Adjusts the speed of the animation playing in the slot
 

package/src/Shared/AnimationTrackPlayer.lua

@@ -7,11 +7,11 @@
 
 local require = require(script.Parent.loader).load(script)
 
+local AnimationUtils = require("AnimationUtils")
 local BaseObject = require("BaseObject")
-local ValueObject = require("ValueObject")
 local Rx = require("Rx")
-local AnimationUtils = require("AnimationUtils")
 local Signal = require("Signal")
+local ValueObject = require("ValueObject")
 
 local AnimationTrackPlayer = setmetatable({}, BaseObject)
 AnimationTrackPlayer.ClassName = "AnimationTrackPlayer"
@@ -215,16 +215,18 @@ function AnimationTrackPlayer:IsPlaying(): boolean
 end
 
 function AnimationTrackPlayer:_onEachTrack(callback)
-	return self._currentTrack:ObserveBrio(function(track)
-		return track ~= nil
-	end):Subscribe(function(brio)
-		if brio:IsDead() then
-			return
-		end
+	return self._currentTrack
+		:ObserveBrio(function(track)
+			return track ~= nil
+		end)
+		:Subscribe(function(brio)
+			if brio:IsDead() then
+				return
+			end
 
-		local track = brio:GetValue()
-		callback(brio:ToMaid(), track)
-	end)
+			local track = brio:GetValue()
+			callback(brio:ToMaid(), track)
+		end)
 end
 
-return AnimationTrackPlayer
+return AnimationTrackPlayer

package/src/Shared/AnimationUtils.lua

@@ -5,9 +5,9 @@
 
 local require = require(script.Parent.loader).load(script)
 
-local RbxAssetUtils = require("RbxAssetUtils")
-local HumanoidAnimatorUtils = require("HumanoidAnimatorUtils")
 local EnumUtils = require("EnumUtils")
+local HumanoidAnimatorUtils = require("HumanoidAnimatorUtils")
+local RbxAssetUtils = require("RbxAssetUtils")
 
 local AnimationUtils = {}
 
@@ -173,7 +173,9 @@ end
 --[=[
 	Finds an animator for the current instance
 ]=]
-function AnimationUtils.getOrCreateAnimator(target: Animator | Player | Model | Humanoid | AnimationController): Animator?
+function AnimationUtils.getOrCreateAnimator(
+	target: Animator | Player | Model | Humanoid | AnimationController
+): Animator?
 	assert(typeof(target) == "Instance", "Bad target")
 
 	if target:IsA("Animator") then

package/src/Shared/Testing/StudioRigAnimator.lua

@@ -13,8 +13,8 @@ local require = require(script.Parent.loader).load(script)
 
 local RunService = game:GetService("RunService")
 
-local BaseObject = require("BaseObject")
 local AnimationUtils = require("AnimationUtils")
+local BaseObject = require("BaseObject")
 
 local StudioRigAnimator = setmetatable({}, BaseObject)
 StudioRigAnimator.ClassName = "StudioRigAnimator"