@quenty/colorsequenceutils 7.10.0 → 7.10.1-canary.684.24818543952.0

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.
 
+## [7.10.1-canary.684.24818543952.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/colorsequenceutils@7.10.0...@quenty/colorsequenceutils@7.10.1-canary.684.24818543952.0) (2026-04-23)
+
+
+### Features
+
+* Additional improvments ([44896ef](https://github.com/Quenty/NevermoreEngine/commit/44896efe8dd9506ad6002bc41f816b9b2b482ebc))
+* Upgrade dependent libraries with new functionality ([22e8c9e](https://github.com/Quenty/NevermoreEngine/commit/22e8c9e3c3dd7288dd264f00c98852653b40a402))
+
+
+
+
+
 # [7.10.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/colorsequenceutils@7.9.3...@quenty/colorsequenceutils@7.10.0) (2026-02-17)
 
 **Note:** Version bump only for package @quenty/colorsequenceutils

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/colorsequenceutils",
-  "version": "7.10.0",
+  "version": "7.10.1-canary.684.24818543952.0",
   "description": "Utility functions for Color sequences in Roblox.",
   "keywords": [
     "Roblox",
@@ -31,8 +31,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@quenty/loader": "10.10.0",
+    "@quenty/loader": "10.10.1-canary.684.24818543952.0",
     "@quenty/math": "2.7.5"
   },
-  "gitHead": "ea9856e1b1ab2c3c1a9c3ed8a07f21a633f59f29"
+  "gitHead": "67b6385a1ead1ab1b137158b3e0c179e5f5b19ac"
 }

package/src/Shared/ColorSequenceUtils.lua

@@ -44,6 +44,70 @@ function ColorSequenceUtils.getColor(colorSequence: ColorSequence, t: number): C
 	return keypoints[#keypoints].Value
 end
 
+function ColorSequenceUtils.fromUnscaledTimesAndColors(times: { number }, colors: { Color3 }): ColorSequence
+	assert(#times == #colors, "Mismatched times and colors")
+	local min = math.huge
+	local max = -math.huge
+	local previous = -math.huge
+	for i = 1, #times do
+		assert(type(times[i]) == "number", "Bad time")
+		assert(typeof(colors[i]) == "Color3", "Bad color")
+		assert(times[i] >= previous, "Times must be in ascending order")
+		previous = times[i]
+
+		min = math.min(min, times[i])
+		max = math.max(max, times[i])
+	end
+
+	local keypoints: { ColorSequenceKeypoint } = {}
+	for i = 1, #times do
+		local scaledTime = math.map(times[i], min, max, 0, 1)
+		table.insert(keypoints, ColorSequenceKeypoint.new(scaledTime, colors[i]))
+	end
+
+	return ColorSequence.new(keypoints)
+end
+
+function ColorSequenceUtils.getSingleColorInSequence(colorSequence: ColorSequence): Color3?
+	assert(typeof(colorSequence) == "ColorSequence", "Bad colorSequence")
+
+	local keypoints = colorSequence.Keypoints
+	local firstColor = keypoints[1].Value
+	for i = 2, #keypoints do
+		if keypoints[i].Value ~= firstColor then
+			return nil
+		end
+	end
+
+	return firstColor
+end
+
+function ColorSequenceUtils.getAverageColor(colorSequence: ColorSequence): Color3
+	assert(typeof(colorSequence) == "ColorSequence", "Bad colorSequence")
+	local keypoints = colorSequence.Keypoints
+	assert(#keypoints > 0, "Color sequence must have at least one keypoint")
+
+	if #keypoints == 1 then
+		return keypoints[1].Value
+	end
+
+	local totalR = 0
+	local totalG = 0
+	local totalB = 0
+
+	for i = 2, #keypoints do
+		local prev = keypoints[i - 1]
+		local curr = keypoints[i]
+		local dt = curr.Time - prev.Time
+
+		totalR = totalR + (prev.Value.R + curr.Value.R) * 0.5 * dt
+		totalG = totalG + (prev.Value.G + curr.Value.G) * 0.5 * dt
+		totalB = totalB + (prev.Value.B + curr.Value.B) * 0.5 * dt
+	end
+
+	return Color3.new(totalR, totalG, totalB)
+end
+
 --[=[
 	Makes stripes for color sequences.