@quenty/viewport 11.21.0 → 11.21.1

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [11.21.1](https://github.com/Quenty/NevermoreEngine/compare/@quenty/viewport@11.21.0...@quenty/viewport@11.21.1) (2025-04-05)
+
+
+### Bug Fixes
+
+* Add types to packages ([2374fb2](https://github.com/Quenty/NevermoreEngine/commit/2374fb2b043cfbe0e9b507b3316eec46a4e353a0))
+
+
+
+
+
 # [11.21.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/viewport@11.20.3...@quenty/viewport@11.21.0) (2025-04-02)
 
 **Note:** Version bump only for package @quenty/viewport

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/viewport",
-  "version": "11.21.0",
+  "version": "11.21.1",
   "description": "Rendering functionality for viewportFrames",
   "keywords": [
     "Roblox",
@@ -24,26 +24,26 @@
     "Quenty"
   ],
   "dependencies": {
-    "@quenty/adorneeutils": "^3.3.1",
-    "@quenty/baseobject": "^10.8.0",
-    "@quenty/basicpane": "^13.17.0",
-    "@quenty/blend": "^12.18.0",
-    "@quenty/camera": "^14.20.0",
-    "@quenty/geometryutils": "^6.8.1",
-    "@quenty/inputobjectutils": "^4.18.0",
-    "@quenty/loader": "^10.8.0",
-    "@quenty/maid": "^3.4.0",
-    "@quenty/math": "^2.7.1",
-    "@quenty/rx": "^13.17.0",
-    "@quenty/signal": "^7.10.0",
-    "@quenty/spring": "^10.8.1",
-    "@quenty/valueobject": "^13.17.0"
+    "@quenty/adorneeutils": "^3.3.2",
+    "@quenty/baseobject": "^10.8.1",
+    "@quenty/basicpane": "^13.17.1",
+    "@quenty/blend": "^12.18.1",
+    "@quenty/camera": "^14.20.1",
+    "@quenty/geometryutils": "^6.8.2",
+    "@quenty/inputobjectutils": "^4.18.1",
+    "@quenty/loader": "^10.8.1",
+    "@quenty/maid": "^3.4.1",
+    "@quenty/math": "^2.7.2",
+    "@quenty/rx": "^13.17.1",
+    "@quenty/signal": "^7.10.1",
+    "@quenty/spring": "^10.8.2",
+    "@quenty/valueobject": "^13.17.1"
   },
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
-    "@quenty/insertserviceutils": "^10.10.1"
+    "@quenty/insertserviceutils": "^10.10.2"
   },
-  "gitHead": "e8ea56930e65322fcffc05a1556d5df988068f0b"
+  "gitHead": "78c3ac0ab08dd18085b6e6e6e4f745e76ed99f68"
 }

package/src/Client/Viewport.lua

@@ -103,7 +103,7 @@ function Viewport.blend(props)
 	end)
 end
 
-function Viewport:ObserveTransparency()
+function Viewport:ObserveTransparency(): Observable.Observable<number>
 	return self._transparency:Observe()
 end
 
@@ -112,7 +112,7 @@ end
 
 	@param enabled boolean
 ]=]
-function Viewport:SetControlsEnabled(enabled)
+function Viewport:SetControlsEnabled(enabled: boolean)
 	assert(type(enabled) == "boolean", "Bad enabled")
 
 	self._controlsEnabled.Value = enabled
@@ -123,7 +123,7 @@ end
 
 	@param transparency number
 ]=]
-function Viewport:SetTransparency(transparency)
+function Viewport:SetTransparency(transparency: number)
 	return self._transparency:Mount(transparency or 0)
 end
 
@@ -132,7 +132,7 @@ end
 
 	@param fieldOfView number
 ]=]
-function Viewport:SetFieldOfView(fieldOfView)
+function Viewport:SetFieldOfView(fieldOfView: number)
 	return self._fieldOfView:Mount(fieldOfView or 20)
 end
 
@@ -148,7 +148,7 @@ end
 
 	@param instance Instance?
 ]=]
-function Viewport:SetInstance(instance)
+function Viewport:SetInstance(instance: Instance?): () -> ()
 	self._current:Mount(instance)
 
 	return function()
@@ -166,10 +166,11 @@ function Viewport:NotifyInstanceSizeChanged()
 	self._notifyInstanceSizeChanged:Fire()
 end
 
-function Viewport:SetYaw(yaw, doNotAnimate)
+function Viewport:SetYaw(yaw: number, doNotAnimate: boolean?)
 	yaw = yaw % TAU
 
-	self._rotationYawSpring.Position = CircleUtils.updatePositionToSmallestDistOnCircle(self._rotationYawSpring.Position, yaw, TAU)
+	self._rotationYawSpring.Position =
+		CircleUtils.updatePositionToSmallestDistOnCircle(self._rotationYawSpring.Position, yaw, TAU)
 	self._rotationYawSpring.Target = yaw
 
 	if doNotAnimate then
@@ -177,16 +178,16 @@ function Viewport:SetYaw(yaw, doNotAnimate)
 	end
 end
 
-function Viewport:SetPitch(pitch, doNotAnimate)
+function Viewport:SetPitch(pitch: number, doNotAnimate: boolean?)
 	self._rotationPitchSpring.Target = math.clamp(pitch, MIN_PITCH, MAX_PITCH)
 	if doNotAnimate then
 		self._rotationPitchSpring.Position = self._rotationPitchSpring.Target
 	end
 end
 
-function Viewport:RotateBy(deltaV2, doNotAnimate)
-	self:SetYaw(self._rotationYawSpring.Value + deltaV2.x, doNotAnimate)
-	self:SetPitch(self._rotationPitchSpring.Value + deltaV2.y, doNotAnimate)
+function Viewport:RotateBy(deltaV2: Vector2, doNotAnimate: boolean?)
+	self:SetYaw(self._rotationYawSpring.Value + deltaV2.X, doNotAnimate)
+	self:SetPitch(self._rotationPitchSpring.Value + deltaV2.Y, doNotAnimate)
 end
 
 --[=[
@@ -214,30 +215,32 @@ function Viewport:Render(props)
 	local currentCamera = ValueObject.new()
 	self._maid:GiveTask(currentCamera)
 
-	local lightDirectionCFrame = (CFrame.Angles(0, math.rad(180), 0)
-			* CFrame.Angles(math.rad(-45), 0, 0))
+	local lightDirectionCFrame = (CFrame.Angles(0, math.rad(180), 0) * CFrame.Angles(math.rad(-45), 0, 0))
 	local brightness = 1.25
 	local ambientBrightness = 0.75
 
-	return Blend.New "ViewportFrame" {
-		Parent = props.Parent;
-		Size = props.Size or UDim2.new(1, 0, 1, 0);
-		AnchorPoint = props.AnchorPoint;
-		Position = props.Position;
-		ImageColor3 = props.ImageColor3;
-		LayoutOrder = props.LayoutOrder;
-		BackgroundTransparency = 1;
-		BackgroundColor3 = props.BackgroundColor3;
-		CurrentCamera = currentCamera;
+	return Blend.New("ViewportFrame")({
+		Parent = props.Parent,
+		Size = props.Size or UDim2.new(1, 0, 1, 0),
+		AnchorPoint = props.AnchorPoint,
+		Position = props.Position,
+		ImageColor3 = props.ImageColor3,
+		LayoutOrder = props.LayoutOrder,
+		BackgroundTransparency = 1,
+		BackgroundColor3 = props.BackgroundColor3,
+		CurrentCamera = currentCamera,
 		-- selene:allow(roblox_incorrect_color3_new_bounds)
-		LightColor = props.LightColor or Color3.new(brightness, brightness, brightness + 0.15);
-		LightDirection = props.LightDirection or lightDirectionCFrame:vectorToWorldSpace(Vector3.new(0, 0, -1));
-		Ambient = props.Ambient or Color3.new(ambientBrightness, ambientBrightness, ambientBrightness + 0.15);
-		ImageTransparency = Blend.Computed(props.Transparency or 0, self._transparency,
+		LightColor = props.LightColor or Color3.new(brightness, brightness, brightness + 0.15),
+		LightDirection = props.LightDirection or lightDirectionCFrame:vectorToWorldSpace(Vector3.new(0, 0, -1)),
+		Ambient = props.Ambient or Color3.new(ambientBrightness, ambientBrightness, ambientBrightness + 0.15),
+		ImageTransparency = Blend.Computed(
+			props.Transparency or 0,
+			self._transparency,
 			function(propTransparency, selfTransparency)
 				return Math.map(propTransparency, 0, 1, selfTransparency, 1)
-			end);
-		[Blend.OnChange "AbsoluteSize"] = self._absoluteSize;
+			end
+		),
+		[Blend.OnChange("AbsoluteSize")] = self._absoluteSize,
 		[Blend.Attached(function(viewport)
 			local controlsMaid = Maid.new()
 
@@ -249,7 +252,7 @@ function Viewport:Render(props)
 			end))
 
 			return controlsMaid
-		end)] = true;
+		end)] = true,
 		[Blend.Attached(function(viewport)
 			-- custom parenting scheme to ensure we don't call destroy on children
 			local maid = Maid.new()
@@ -274,16 +277,16 @@ function Viewport:Render(props)
 			end)
 
 			return maid
-		end)] = true;
+		end)] = true,
 		[Blend.Children] = {
-			props[Blend.Children];
+			props[Blend.Children],
 
-			self._current;
+			self._current,
 
-			Blend.New "Camera" {
-				[Blend.Instance] = currentCamera;
-				Name = "CurrentCamera";
-				FieldOfView = self._fieldOfView;
+			Blend.New("Camera")({
+				[Blend.Instance] = currentCamera,
+				Name = "CurrentCamera",
+				FieldOfView = self._fieldOfView,
 				CFrame = Blend.Computed(
 					self._current,
 					self._absoluteSize,
@@ -291,25 +294,29 @@ function Viewport:Render(props)
 					self._rotationYawSpring:ObserveRenderStepped(),
 					self._rotationPitchSpring:ObserveRenderStepped(),
 					Rx.fromSignal(self._notifyInstanceSizeChanged):Pipe({
-						Rx.defaultsToNil;
+						Rx.defaultsToNil,
 					}),
 					function(inst, absSize, fov, rotationYaw, rotationPitch)
 						if typeof(inst) ~= "Instance" then
 							return CFrame.new()
 						end
 
-						local aspectRatio = absSize.x/absSize.y
+						local aspectRatio = absSize.x / absSize.y
 						local bbCFrame, bbSize = AdorneeUtils.getBoundingBox(inst)
 						if not bbCFrame then
 							return CFrame.new()
 						end
 
 						local fit = CameraUtils.fitBoundingBoxToCamera(bbSize, fov, aspectRatio)
-						return CFrame.new(bbCFrame.Position) * CFrame.Angles(0, rotationYaw, 0) * CFrame.Angles(rotationPitch, 0, 0) * CFrame.new(0, 0, fit)
-					end);
-			}
-		}
-	};
+						return CFrame.new(bbCFrame.Position)
+							* CFrame.Angles(0, rotationYaw, 0)
+							* CFrame.Angles(rotationPitch, 0, 0)
+							* CFrame.new(0, 0, fit)
+					end
+				),
+			}),
+		},
+	})
 end
 
 return Viewport

package/src/Client/ViewportControls.lua

@@ -22,17 +22,20 @@ ViewportControls.__index = ViewportControls
     @param viewportModel Viewport
     @return BaseObject
 ]=]
-function ViewportControls.new(viewport, viewportModel)
+function ViewportControls.new(viewport: ViewportFrame, viewportModel)
 	local self = setmetatable(BaseObject.new(viewport), ViewportControls)
 
 	self._viewportModel = assert(viewportModel, "No rotationYaw")
 	self._enabled = self._maid:Add(ValueObject.new(true, "boolean"))
 
 	self._maid:GiveTask(self._obj.InputBegan:Connect(function(inputObject)
-		if (inputObject.UserInputType == Enum.UserInputType.MouseButton1
-			or inputObject.UserInputType == Enum.UserInputType.MouseButton2
-			or inputObject.UserInputType == Enum.UserInputType.Touch)
-			and self._enabled.Value then
+		if
+			(
+				inputObject.UserInputType == Enum.UserInputType.MouseButton1
+				or inputObject.UserInputType == Enum.UserInputType.MouseButton2
+				or inputObject.UserInputType == Enum.UserInputType.Touch
+			) and self._enabled.Value
+		then
 			self:_startDrag(inputObject)
 		end
 	end))
@@ -45,13 +48,13 @@ end
 
 	@param enabled boolean
 ]=]
-function ViewportControls:SetEnabled(enabled)
+function ViewportControls:SetEnabled(enabled: boolean)
 	assert(type(enabled) == "boolean", "Bad enabled")
 
 	self._enabled.Value = enabled
 end
 
-function ViewportControls:_startDrag(startInputObject)
+function ViewportControls:_startDrag(startInputObject: InputObject)
 	if self._maid._dragging then
 		return
 	end