@quenty/adorneeutils 3.5.0 → 3.6.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.6.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/adorneeutils@3.5.0...@quenty/adorneeutils@3.6.0) (2026-09-02)
+
+### Features
+
+- **adorneeutils:** Add AdorneeUtils.setBoundingBoxCFrame ([d4b0fe8](https://github.com/Quenty/NevermoreEngine/commit/d4b0fe8f04b9e5ce26de76c47e387e6031ad87ec))
+
 # [3.5.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/adorneeutils@3.4.0...@quenty/adorneeutils@3.5.0) (2026-08-28)
 
 **Note:** Version bump only for package @quenty/adorneeutils

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/adorneeutils",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "AdorneeUtils - Generic adornee functions to make attaching to objects in Roblox easier.",
   "keywords": [
     "Roblox",
@@ -37,5 +37,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "346201e192e467cb71160f43029863853be855b5"
+  "gitHead": "278f4ca25486a8ba0601704b27a11da8c77499c9"
 }

package/src/Shared/AdorneeUtils.lua

@@ -69,6 +69,38 @@ function AdorneeUtils.getBoundingBox(adornee: Instance): (CFrame?, Vector3?)
 	end
 end
 
+--[=[
+	Moves the adornee so its bounding box sits at the given cframe, keeping every part where it
+	sits relative to the others.
+
+	This is the counterpart to [AdorneeUtils.getBoundingBox], and is not the same as `PivotTo`,
+	which moves the adornee by its pivot rather than by the center of its bounds.
+
+	@param adornee Instance
+	@param cframe CFrame -- New bounding box cframe
+	@return boolean -- False when the adornee has no bounding box to move
+]=]
+function AdorneeUtils.setBoundingBoxCFrame(adornee: Instance, cframe: CFrame): boolean
+	assert(typeof(adornee) == "Instance", "Adornee must by of type 'Instance'")
+	assert(typeof(cframe) == "CFrame", "Bad cframe")
+
+	local bbCFrame = AdorneeUtils.getBoundingBox(adornee)
+	if not bbCFrame then
+		return false
+	end
+
+	local relativeCFrames: { [BasePart]: CFrame } = {}
+	for _, part in AdorneeUtils.getParts(adornee) do
+		relativeCFrames[part] = bbCFrame:ToObjectSpace(part.CFrame)
+	end
+
+	for part, relativeCFrame in relativeCFrames do
+		part.CFrame = cframe:ToWorldSpace(relativeCFrame)
+	end
+
+	return true
+end
+
 --[=[
 	Returns whether a part is a part of an adornee
 	@param adornee Instance

package/src/Shared/AdorneeUtils.spec.lua

@@ -439,6 +439,57 @@ describe("AdorneeUtils.getBoundingBox", function()
 	end)
 end)
 
+describe("AdorneeUtils.setBoundingBoxCFrame", function()
+	it("puts the bounding box where it was asked to go", function()
+		local controller = setup()
+		local model = controller.newModel()
+
+		local target = CFrame.new(20, 8, -4)
+		local moved = AdorneeUtils.setBoundingBoxCFrame(model, target)
+
+		local cframe = AdorneeUtils.getBoundingBox(model)
+
+		expect(moved).toBe(true)
+		expect(cframe).toEqual(target)
+
+		controller:Destroy()
+	end)
+
+	it("keeps parts where they sit relative to each other", function()
+		local controller = setup()
+		local model, first, second = controller.newModel()
+
+		local offset = first.CFrame:ToObjectSpace(second.CFrame)
+
+		AdorneeUtils.setBoundingBoxCFrame(model, CFrame.Angles(0, math.pi / 2, 0) + Vector3.new(20, 8, -4))
+
+		expect(first.CFrame:ToObjectSpace(second.CFrame)).toEqual(offset)
+
+		controller:Destroy()
+	end)
+
+	it("moves a lone part", function()
+		local controller = setup()
+		local part = controller.newPart(Vector3.new(4, 1, 2), CFrame.new(1, 2, 3))
+
+		local moved = AdorneeUtils.setBoundingBoxCFrame(part, CFrame.new(7, 7, 7))
+
+		expect(moved).toBe(true)
+		expect(part.CFrame).toEqual(CFrame.new(7, 7, 7))
+
+		controller:Destroy()
+	end)
+
+	it("reports nothing moved when the adornee has no parts", function()
+		local controller = setup()
+		local folder = controller.newFolder()
+
+		expect(AdorneeUtils.setBoundingBoxCFrame(folder, CFrame.new(1, 2, 3))).toBe(false)
+
+		controller:Destroy()
+	end)
+end)
+
 describe("AdorneeUtils.isPartOfAdornee", function()
 	it("returns true when the part is the adornee", function()
 		local controller = setup()