@quenty/numbersequenceutils 8.9.0 → 8.9.1

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.9.1](https://github.com/Quenty/NevermoreEngine/compare/@quenty/numbersequenceutils@8.9.0...@quenty/numbersequenceutils@8.9.1) (2025-03-21)
+
+**Note:** Version bump only for package @quenty/numbersequenceutils
+
+
+
+
+
 # [8.9.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/numbersequenceutils@8.8.0...@quenty/numbersequenceutils@8.9.0) (2025-02-18)
 
 **Note:** Version bump only for package @quenty/numbersequenceutils

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/numbersequenceutils",
-  "version": "8.9.0",
+  "version": "8.9.1",
   "description": "Utility functions involving NumberSequences on Roblox",
   "keywords": [
     "Roblox",
@@ -29,7 +29,7 @@
   },
   "dependencies": {
     "@quenty/loader": "^10.8.0",
-    "@quenty/math": "^2.7.0"
+    "@quenty/math": "^2.7.1"
   },
-  "gitHead": "184a407d8d7366c39009444c3c9a7023cb176471"
+  "gitHead": "6b7c3e15e60cdb185986207b574e2b5591261e7a"
 }

package/src/Shared/NumberSequenceUtils.lua

@@ -1,3 +1,4 @@
+--!strict
 --[=[
 	Utility functions involving NumberSequences on Roblox
 	@class NumberSequenceUtils
@@ -17,7 +18,7 @@ local EPSILON = 1e-3
 	@param numberSequence NumberSequence
 	@return (number) -> number
 ]=]
-function NumberSequenceUtils.getValueGenerator(numberSequence: NumberSequence): number
+function NumberSequenceUtils.getValueGenerator(numberSequence: NumberSequence): (number) -> number
 	assert(typeof(numberSequence) == "NumberSequence", "Bad numberSequence")
 
 	-- TODO: Binary search
@@ -34,7 +35,7 @@ function NumberSequenceUtils.getValueGenerator(numberSequence: NumberSequence):
 			return function(t)
 				assert(type(t) == "number", "Bad t")
 
-				return keypoint.Value + (math.random()-0.5)*keypoint.Envelope
+				return keypoint.Value + (math.random() - 0.5) * keypoint.Envelope
 			end
 		end
 	elseif #keypoints == 2 then
@@ -48,8 +49,8 @@ function NumberSequenceUtils.getValueGenerator(numberSequence: NumberSequence):
 				return first.Value
 			end
 		else
-			local firstValue = first.Value + (math.random() - 0.5)*first.Envelope
-			local secondValue = second.Value + (math.random() - 0.5)*second.Envelope
+			local firstValue = first.Value + (math.random() - 0.5) * first.Envelope
+			local secondValue = second.Value + (math.random() - 0.5) * second.Envelope
 			return function(t)
 				assert(type(t) == "number", "Bad t")
 				local scale = math.clamp(Math.map(t, first.Time, second.Time, 0, 1), 0, 1)
@@ -59,9 +60,9 @@ function NumberSequenceUtils.getValueGenerator(numberSequence: NumberSequence):
 	else
 		-- pregenerate
 		local values = {}
-		for i=1, #keypoints do
+		for i = 1, #keypoints do
 			local point = keypoints[i]
-			values[i] = point.Value + (math.random()-0.5)*point.Envelope
+			values[i] = point.Value + (math.random() - 0.5) * point.Envelope
 		end
 
 		return function(t)
@@ -72,15 +73,15 @@ function NumberSequenceUtils.getValueGenerator(numberSequence: NumberSequence):
 			end
 
 			-- TODO: Binary search
-			for i=2, #keypoints do
+			for i = 2, #keypoints do
 				local point = keypoints[i]
 				if point.Time < t then
 					continue
 				end
 
-				local prevPoint = keypoints[i-1]
+				local prevPoint = keypoints[i - 1]
 				local scale = math.clamp(Math.map(t, prevPoint.Time, point.Time, 0, 1), 0, 1)
-				return Math.lerp(values[i-1], values[i], scale)
+				return Math.lerp(values[i - 1], values[i], scale)
 			end
 
 			return values[#keypoints]
@@ -94,7 +95,7 @@ end
 	@param callback function
 	@return NumberSequence
 ]=]
-function NumberSequenceUtils.forEachValue(sequence, callback)
+function NumberSequenceUtils.forEachValue(sequence: NumberSequence, callback: (number) -> number): NumberSequence
 	assert(type(callback) == "function", "Bad callback")
 
 	local waypoints = {}
@@ -113,12 +114,15 @@ end
 	@param scale number
 	@return NumberSequence
 ]=]
-function NumberSequenceUtils.scale(sequence, scale)
+function NumberSequenceUtils.scale(sequence: NumberSequence, scale: number): NumberSequence
 	local waypoints = {}
 
 	local keypoints = sequence.Keypoints
 	for _, keypoint in pairs(keypoints) do
-		table.insert(waypoints, NumberSequenceKeypoint.new(keypoint.Time, keypoint.Value*scale, keypoint.Envelope*scale))
+		table.insert(
+			waypoints,
+			NumberSequenceKeypoint.new(keypoint.Time, keypoint.Value * scale, keypoint.Envelope * scale)
+		)
 	end
 
 	return NumberSequence.new(waypoints)
@@ -131,15 +135,19 @@ end
 	@param scale number
 	@return NumberSequence
 ]=]
-function NumberSequenceUtils.scaleTransparency(sequence, scale)
+function NumberSequenceUtils.scaleTransparency(sequence: NumberSequence, scale: number): NumberSequence
 	local waypoints = {}
 
 	local keypoints = sequence.Keypoints
 	for _, keypoint in pairs(keypoints) do
-		table.insert(waypoints, NumberSequenceKeypoint.new(
-			keypoint.Time,
-			Math.map(keypoint.Value, 0, 1, scale, 1),
-			keypoint.Envelope*scale))
+		table.insert(
+			waypoints,
+			NumberSequenceKeypoint.new(
+				keypoint.Time,
+				Math.map(keypoint.Value, 0, 1, scale, 1),
+				keypoint.Envelope * scale
+			)
+		)
 	end
 
 	return NumberSequence.new(waypoints)
@@ -156,8 +164,12 @@ end
 	@return NumberSequence
 ]=]
 function NumberSequenceUtils.stripe(
-	stripes, backgroundTransparency, stripeTransparency, percentStripeThickness, percentOffset)
-
+	stripes: number,
+	backgroundTransparency: number,
+	stripeTransparency: number,
+	percentStripeThickness: number,
+	percentOffset: number
+): NumberSequence
 	percentOffset = percentOffset or 0
 	percentStripeThickness = math.clamp(percentStripeThickness or 0.5, 0, 1)
 
@@ -167,16 +179,16 @@ function NumberSequenceUtils.stripe(
 		return NumberSequence.new(stripeTransparency)
 	end
 
-	local timeWidth = 1/stripes
-	local timeOffset = percentOffset*timeWidth
-	timeOffset = timeOffset + percentStripeThickness*timeWidth*0.5 -- We add thickness to center
+	local timeWidth = 1 / stripes
+	local timeOffset = percentOffset * timeWidth
+	timeOffset = timeOffset + percentStripeThickness * timeWidth * 0.5 -- We add thickness to center
 	timeOffset = timeOffset % timeWidth
 
 	-- Generate initialial points
 	local waypoints = {}
-	for i=0, stripes-1 do
-		local timestampStart = (i/stripes + timeOffset) % 1
-		local timeStampMiddle = (timestampStart + timeWidth*(1 - percentStripeThickness)) % 1
+	for i = 0, stripes - 1 do
+		local timestampStart = (i / stripes + timeOffset) % 1
+		local timeStampMiddle = (timestampStart + timeWidth * (1 - percentStripeThickness)) % 1
 
 		table.insert(waypoints, NumberSequenceKeypoint.new(timestampStart, backgroundTransparency))
 		table.insert(waypoints, NumberSequenceKeypoint.new(timeStampMiddle, stripeTransparency))
@@ -191,8 +203,8 @@ function NumberSequenceUtils.stripe(
 	-- Handle first!
 	table.insert(fullWaypoints, waypoints[1])
 
-	for i=2, #waypoints do
-		local previous = waypoints[i-1]
+	for i = 2, #waypoints do
+		local previous = waypoints[i - 1]
 		local current = waypoints[i]
 
 		if current.Time - EPSILON > previous.Time then
@@ -234,4 +246,4 @@ function NumberSequenceUtils.stripe(
 	return NumberSequence.new(fullWaypoints)
 end
 
-return NumberSequenceUtils
+return NumberSequenceUtils