@quenty/snackbar 11.21.2 → 11.21.3

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.
 
+## [11.21.3](https://github.com/Quenty/NevermoreEngine/compare/@quenty/snackbar@11.21.2...@quenty/snackbar@11.21.3) (2025-04-10)
+
+**Note:** Version bump only for package @quenty/snackbar
+
+
+
+
+
 ## [11.21.2](https://github.com/Quenty/NevermoreEngine/compare/@quenty/snackbar@11.21.0...@quenty/snackbar@11.21.2) (2025-04-07)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/snackbar",
-  "version": "11.21.2",
+  "version": "11.21.3",
   "description": "Snackbars provide lightweight feedback on an operation at the base of the screen. They automatically disappear after a timeout or user interaction. There can only be one on the screen at a time.",
   "keywords": [
     "Roblox",
@@ -25,33 +25,33 @@
     "Quenty"
   ],
   "dependencies": {
-    "@quenty/baseobject": "^10.8.2",
-    "@quenty/basicpane": "^13.17.2",
-    "@quenty/blend": "^12.18.2",
-    "@quenty/buttondragmodel": "^1.15.2",
-    "@quenty/buttonhighlightmodel": "^14.18.2",
-    "@quenty/ducktype": "^5.8.3",
-    "@quenty/genericscreenguiprovider": "^13.20.2",
-    "@quenty/inputobjectutils": "^4.18.2",
-    "@quenty/lipsum": "^14.18.2",
-    "@quenty/loader": "^10.8.2",
-    "@quenty/maid": "^3.4.2",
+    "@quenty/baseobject": "^10.8.3",
+    "@quenty/basicpane": "^13.17.3",
+    "@quenty/blend": "^12.18.3",
+    "@quenty/buttondragmodel": "^1.15.3",
+    "@quenty/buttonhighlightmodel": "^14.18.3",
+    "@quenty/ducktype": "^5.8.4",
+    "@quenty/genericscreenguiprovider": "^13.20.3",
+    "@quenty/inputobjectutils": "^4.18.3",
+    "@quenty/lipsum": "^14.18.3",
+    "@quenty/loader": "^10.8.3",
+    "@quenty/maid": "^3.4.3",
     "@quenty/math": "^2.7.3",
-    "@quenty/promise": "^10.10.3",
-    "@quenty/promisemaid": "^5.10.3",
-    "@quenty/promptqueue": "^1.18.2",
-    "@quenty/qgui": "^2.3.3",
-    "@quenty/rx": "^13.17.2",
-    "@quenty/servicebag": "^11.11.3",
-    "@quenty/table": "^3.7.3",
-    "@quenty/textserviceutils": "^13.18.2",
-    "@quenty/transitionmodel": "^7.19.2",
+    "@quenty/promise": "^10.10.4",
+    "@quenty/promisemaid": "^5.10.4",
+    "@quenty/promptqueue": "^1.18.3",
+    "@quenty/qgui": "^2.3.4",
+    "@quenty/rx": "^13.17.3",
+    "@quenty/servicebag": "^11.11.4",
+    "@quenty/table": "^3.7.4",
+    "@quenty/textserviceutils": "^13.18.3",
+    "@quenty/transitionmodel": "^7.19.3",
     "@quenty/utf8": "^2.3.3",
-    "@quenty/valueobject": "^13.17.2",
+    "@quenty/valueobject": "^13.17.3",
     "@quentystudios/t": "^3.0.0"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "64def70499ec067077ee39f279936b620b217847"
+  "gitHead": "b06c070ae91d5dab7bd8de6e290ad2caabb15d8f"
 }

package/src/Client/Gui/Snackbar.lua

@@ -1,3 +1,4 @@
+--!strict
 --[=[
 	Snackbars provide lightweight feedback on an operation
 	at the base of the screen. They automatically disappear
@@ -24,6 +25,7 @@ local ValueObject = require("ValueObject")
 local SpringObject = require("SpringObject")
 local Table = require("Table")
 local _Promise = require("Promise")
+local _Observable = require("Observable")
 
 local SHADOW_RADIUS = 2
 local CORNER_RADIUS = 2
@@ -47,13 +49,29 @@ local Snackbar = setmetatable({}, TransitionModel)
 Snackbar.ClassName = "Snackbar"
 Snackbar.__index = Snackbar
 
-export type Snackbar = typeof(setmetatable({} :: {}, Snackbar)) & TransitionModel.TransitionModel
+export type Snackbar = typeof(setmetatable(
+	{} :: {
+		Gui: GuiObject,
+
+		_text: ValueObject.ValueObject<string>,
+		_backgroundColor: ValueObject.ValueObject<Color3>,
+		_percentVisibleModel: SpringTransitionModel.SpringTransitionModel<number>,
+		_dragSpring: SpringObject.SpringObject<Vector2>,
+		_positionSpringModel: SpringTransitionModel.SpringTransitionModel<UDim2>,
+		_dragModel: ButtonDragModel.ButtonDragModel,
+		_computedTransparency: _Observable.Observable<number>,
+		_mainButton: GuiButton?,
+		_callToActionContainer: GuiObject?,
+		_textLabel: TextLabel?,
+	},
+	{} :: typeof({ __index = Snackbar })
+)) & TransitionModel.TransitionModel
 
 function Snackbar.new(text: string, options: SnackbarOptionUtils.SnackbarOptions?): Snackbar
 	assert(SnackbarOptionUtils.isSnackbarOptions(options) or options == nil, "Bad options")
 	options = options or SnackbarOptionUtils.createSnackbarOptions({})
 
-	local self = setmetatable(TransitionModel.new(), Snackbar)
+	local self: Snackbar = setmetatable(TransitionModel.new() :: any, Snackbar)
 
 	self._text = self._maid:Add(ValueObject.new(text, "string"))
 	self._backgroundColor = self._maid:Add(ValueObject.new(Color3.new(0.196, 0.196, 0.196), "Color3"))
@@ -98,7 +116,7 @@ function Snackbar.isSnackbar(value: any): boolean
 	return DuckTypeUtils.isImplementation(Snackbar, value)
 end
 
-function Snackbar:PromiseSustain(): _Promise.Promise<()>
+function Snackbar.PromiseSustain(self: Snackbar): _Promise.Promise<()>
 	local promise = PromiseUtils.delayed(DURATION)
 
 	PromiseMaidUtils.whilePromise(promise, function(maid)
@@ -112,7 +130,7 @@ function Snackbar:PromiseSustain(): _Promise.Promise<()>
 	return promise
 end
 
-function Snackbar:_setupDragging()
+function Snackbar._setupDragging(self: Snackbar)
 	self._maid:GiveTask(self._dragSpring:ObserveTarget():Subscribe(function()
 		self:_updateHideFromDragTarget()
 	end))
@@ -134,27 +152,27 @@ function Snackbar:_setupDragging()
 				return
 			end
 
-			if delta.magnitude == 0 then
+			if delta.Magnitude == 0 then
 				return
 			end
 
 			if dragDirection == SnackbarDragDirections.VERTICAL then
-				self._dragSpring:SetTarget(Vector2.new(0, delta.y), true)
+				self._dragSpring:SetTarget(Vector2.new(0, delta.Y), true)
 			elseif dragDirection == SnackbarDragDirections.HORIZONTAL then
-				self._dragSpring:SetTarget(Vector2.new(delta.x, 0), true)
+				self._dragSpring:SetTarget(Vector2.new(delta.X, 0), true)
 			else
-				if math.abs(delta.x) > math.abs(delta.y) then
+				if math.abs(delta.X) > math.abs(delta.Y) then
 					dragDirection = SnackbarDragDirections.HORIZONTAL
-					self._dragSpring:SetTarget(Vector2.new(delta.x, 0), true)
+					self._dragSpring:SetTarget(Vector2.new(delta.X, 0), true)
 				else
 					dragDirection = SnackbarDragDirections.VERTICAL
-					self._dragSpring:SetTarget(Vector2.new(0, delta.y), true)
+					self._dragSpring:SetTarget(Vector2.new(0, delta.Y), true)
 				end
 			end
 		end))
 
 		maid:GiveTask(function()
-			if self._dragSpring.Target.magnitude > 0.5*DRAG_DISTANCE_TO_HIDE then
+			if self._dragSpring.Target.Magnitude > 0.5 * DRAG_DISTANCE_TO_HIDE then
 				self:Hide()
 			else
 				self._dragSpring:SetTarget(Vector2.zero)
@@ -165,19 +183,19 @@ function Snackbar:_setupDragging()
 	self:_updateHideFromDragTarget()
 end
 
-function Snackbar:_updateHideFromDragTarget(doNotAnimate)
+function Snackbar._updateHideFromDragTarget(self: Snackbar, doNotAnimate: boolean?)
 	local target = self._dragSpring.Target
 	local guiSize = self.Gui.AbsoluteSize
 	local hideTarget
-	if target.y > 0 then
+	if target.Y > 0 then
 		-- Down
 		hideTarget = SHOW_POSITION + UDim2.new(0, 0, 0, guiSize.Y)
-	elseif target.y < 0 then
+	elseif target.Y < 0 then
 		-- Up
 		hideTarget = SHOW_POSITION + UDim2.new(0, 0, 0, -guiSize.Y)
-	elseif target.x < 0 then
+	elseif target.X < 0 then
 		hideTarget = SHOW_POSITION + UDim2.new(0, -guiSize.X, 0, 0)
-	elseif target.x > 0 then
+	elseif target.X > 0 then
 		hideTarget = SHOW_POSITION + UDim2.new(0, guiSize.X, 0, 0)
 	else
 		hideTarget = SHOW_POSITION + UDim2.new(0, 0, 0, guiSize.Y)
@@ -186,144 +204,149 @@ function Snackbar:_updateHideFromDragTarget(doNotAnimate)
 	self._positionSpringModel:SetHideTarget(hideTarget, doNotAnimate)
 end
 
-
-function Snackbar:_render()
+function Snackbar._render(self: Snackbar)
 	local percentDragHidden = Blend.Computed(self._dragSpring:Observe(), function(value)
 		return math.clamp(Math.map(value.magnitude, 0, DRAG_DISTANCE_TO_HIDE, 0, 1), 0, 1)
 	end)
-	self._computedTransparency = Blend.Computed(self._percentVisibleModel:Observe(), percentDragHidden, function(visible, dragHidden)
-		return Math.map(visible, 0, 1, 1, dragHidden)
-	end)
-
-	return Blend.New "Frame" {
-		ZIndex = 1;
-		Name = "Snackbar";
-		Size = UDim2.new(0, 0, 0, 0);
-		AutomaticSize = Enum.AutomaticSize.XY;
-		Position = Blend.Computed(self._positionSpringModel:Observe(), self._dragSpring:Observe(), function(position, dragPosition)
-			return position + UDim2.fromOffset(dragPosition.x, dragPosition.y)
-		end);
-		AnchorPoint = Vector2.new(1, 1);
-		BackgroundTransparency = 1;
-
-		Blend.New "UIPadding" {
-			PaddingTop = UDim.new(0, PADDING_FROM_BOTTOM);
-			PaddingBottom = UDim.new(0, PADDING_FROM_BOTTOM);
-			PaddingLeft = UDim.new(0, PADDING_FROM_BOTTOM);
-			PaddingRight = UDim.new(0, PADDING_FROM_BOTTOM);
-		};
-
-		Blend.New "UIListLayout" {
-			FillDirection = Enum.FillDirection.Horizontal;
-		};
-
-		Blend.New "ImageButton" {
-			Size = UDim2.new(0, 0, 0, 0);
-			AnchorPoint = Vector2.new(1, 1);
-			AutomaticSize = Enum.AutomaticSize.XY;
-			BackgroundTransparency = 1;
-			AutoButtonColor = false;
-
-			[Blend.Instance] = function(gui)
+	self._computedTransparency = Blend.Computed(
+		self._percentVisibleModel:Observe(),
+		percentDragHidden,
+		function(visible, dragHidden)
+			return Math.map(visible, 0, 1, 1, dragHidden)
+		end
+	)
+
+	return Blend.New("Frame")({
+		ZIndex = 1,
+		Name = "Snackbar",
+		Size = UDim2.new(0, 0, 0, 0),
+		AutomaticSize = Enum.AutomaticSize.XY,
+		Position = Blend.Computed(
+			self._positionSpringModel:Observe(),
+			self._dragSpring:Observe(),
+			function(position: UDim2, dragPosition: Vector2)
+				return position + UDim2.fromOffset(dragPosition.X, dragPosition.Y)
+			end
+		),
+		AnchorPoint = Vector2.new(1, 1),
+		BackgroundTransparency = 1,
+
+		Blend.New("UIPadding")({
+			PaddingTop = UDim.new(0, PADDING_FROM_BOTTOM),
+			PaddingBottom = UDim.new(0, PADDING_FROM_BOTTOM),
+			PaddingLeft = UDim.new(0, PADDING_FROM_BOTTOM),
+			PaddingRight = UDim.new(0, PADDING_FROM_BOTTOM),
+		}),
+
+		Blend.New("UIListLayout")({
+			FillDirection = Enum.FillDirection.Horizontal,
+		}),
+
+		Blend.New("ImageButton")({
+			Size = UDim2.new(0, 0, 0, 0),
+			AnchorPoint = Vector2.new(1, 1),
+			AutomaticSize = Enum.AutomaticSize.XY,
+			BackgroundTransparency = 1,
+			AutoButtonColor = false,
+
+			[Blend.Instance :: any] = function(gui: GuiButton)
 				self._mainButton = gui
 				self._dragModel:SetButton(gui)
-			end;
-
-			Blend.New "UICorner" {
-				CornerRadius = UDim.new(0, CORNER_RADIUS);
-			};
-
-			Blend.New "UIListLayout" {
-				FillDirection = Enum.FillDirection.Horizontal;
-			};
-
-
-			Blend.New "Folder" {
-				Name = "BackingFolder";
-
-				Blend.New "ImageLabel" {
-					Name = "Shadow";
-					ZIndex = 1;
-					Image = "rbxassetid://191838004";
-					AnchorPoint = Vector2.new(0.5, 0.5);
-					Position = UDim2.fromScale(0.5, 0.5);
-					ImageRectSize = Vector2.new(150, 150);
-					ScaleType = Enum.ScaleType.Slice;
-					SliceCenter = Rect.new(50, 50, 100, 100);
-					SliceScale = (2*SHADOW_RADIUS + CORNER_RADIUS)/50;
-					BackgroundTransparency = 1;
-					Size = UDim2.new(1, 2*SHADOW_RADIUS, 1, 2*SHADOW_RADIUS);
+			end,
+
+			Blend.New("UICorner")({
+				CornerRadius = UDim.new(0, CORNER_RADIUS),
+			}),
+
+			Blend.New("UIListLayout")({
+				FillDirection = Enum.FillDirection.Horizontal,
+			}),
+
+			Blend.New("Folder")({
+				Name = "BackingFolder",
+
+				Blend.New("ImageLabel")({
+					Name = "Shadow",
+					ZIndex = 1,
+					Image = "rbxassetid://191838004",
+					AnchorPoint = Vector2.new(0.5, 0.5),
+					Position = UDim2.fromScale(0.5, 0.5),
+					ImageRectSize = Vector2.new(150, 150),
+					ScaleType = Enum.ScaleType.Slice,
+					SliceCenter = Rect.new(50, 50, 100, 100),
+					SliceScale = (2 * SHADOW_RADIUS + CORNER_RADIUS) / 50,
+					BackgroundTransparency = 1,
+					Size = UDim2.new(1, 2 * SHADOW_RADIUS, 1, 2 * SHADOW_RADIUS),
 					ImageTransparency = Blend.Computed(self._computedTransparency, function(value)
 						return Math.map(value, 0, 1, 0.75, 1)
-					end);
-				};
-			};
-
-			Blend.New "Frame" {
-				Name = "InnerSnackbarContainer";
-				AutomaticSize = Enum.AutomaticSize.XY;
-				Size = UDim2.new(0, 0, 0, 0);
-				ZIndex = 2;
-				BackgroundColor3 = self._backgroundColor:Observe();
-				BackgroundTransparency = self._computedTransparency;
-
-				Blend.New "UISizeConstraint" {
-					MaxSize = Vector2.new(700, 48*2);
-					MinSize = Vector2.new(100, 0);
-				};
-
-				[Blend.Instance] = function(gui)
+					end),
+				}),
+			}),
+
+			Blend.New("Frame")({
+				Name = "InnerSnackbarContainer",
+				AutomaticSize = Enum.AutomaticSize.XY,
+				Size = UDim2.new(0, 0, 0, 0),
+				ZIndex = 2,
+				BackgroundColor3 = self._backgroundColor:Observe(),
+				BackgroundTransparency = self._computedTransparency,
+
+				Blend.New("UISizeConstraint")({
+					MaxSize = Vector2.new(700, 48 * 2),
+					MinSize = Vector2.new(100, 0),
+				}),
+
+				[Blend.Instance :: any] = function(gui)
 					self._callToActionContainer = gui
-				end;
-
-				Blend.New "UICorner" {
-					CornerRadius = UDim.new(0, CORNER_RADIUS);
-				};
-
-				Blend.New "UIListLayout" {
-					FillDirection = Enum.FillDirection.Horizontal;
-					HorizontalAlignment = Enum.HorizontalAlignment.Left;
-					VerticalAlignment = Enum.VerticalAlignment.Center;
-					Padding = UDim.new(0, PADDING_X);
-				};
-
-				Blend.New "UIPadding" {
-					PaddingTop = UDim.new(0, 15);
-					PaddingBottom = UDim.new(0, 15);
-					PaddingLeft = UDim.new(0, PADDING_X);
-					PaddingRight = UDim.new(0, PADDING_X);
-				};
-
-
-				Blend.New "TextLabel" {
-					Name = "SnackbarLabel";
-					LayoutOrder = 1;
-					BackgroundTransparency = 1;
-					AutomaticSize = Enum.AutomaticSize.XY;
-					TextColor3 = Color3.new(1, 1, 1);
-					Size = UDim2.new(0, 0, 0, 0);
-					Position = UDim2.new(0, 0, 0, 18);
-					TextXAlignment = Enum.TextXAlignment.Left;
-					TextYAlignment = Enum.TextYAlignment.Center;
-					BorderSizePixel = 0;
-					Font = Enum.Font.SourceSans;
-					Text = self._text:Observe();
-					TextWrapped = false;
+				end,
+
+				Blend.New("UICorner")({
+					CornerRadius = UDim.new(0, CORNER_RADIUS),
+				}),
+
+				Blend.New("UIListLayout")({
+					FillDirection = Enum.FillDirection.Horizontal,
+					HorizontalAlignment = Enum.HorizontalAlignment.Left,
+					VerticalAlignment = Enum.VerticalAlignment.Center,
+					Padding = UDim.new(0, PADDING_X),
+				}),
+
+				Blend.New("UIPadding")({
+					PaddingTop = UDim.new(0, 15),
+					PaddingBottom = UDim.new(0, 15),
+					PaddingLeft = UDim.new(0, PADDING_X),
+					PaddingRight = UDim.new(0, PADDING_X),
+				}),
+
+				Blend.New("TextLabel")({
+					Name = "SnackbarLabel",
+					LayoutOrder = 1,
+					BackgroundTransparency = 1,
+					AutomaticSize = Enum.AutomaticSize.XY,
+					TextColor3 = Color3.new(1, 1, 1),
+					Size = UDim2.new(0, 0, 0, 0),
+					Position = UDim2.new(0, 0, 0, 18),
+					TextXAlignment = Enum.TextXAlignment.Left,
+					TextYAlignment = Enum.TextYAlignment.Center,
+					BorderSizePixel = 0,
+					Font = Enum.Font.SourceSans,
+					Text = self._text:Observe(),
+					TextWrapped = false,
 					TextTransparency = Blend.Computed(self._computedTransparency, function(value)
 						return Math.map(value, 0, 1, 0.13, 1)
-					end);
-					TextSize = 18;
+					end),
+					TextSize = 18,
 
-					[Blend.Instance] = function(gui)
+					[Blend.Instance] = function(gui: TextLabel)
 						self._textLabel = gui
-					end;
-				};
-			};
-		}
-	}
+					end,
+				}),
+			}),
+		}),
+	})
 end
 
-function Snackbar:_renderCallToAction(callToAction)
+function Snackbar._renderCallToAction(self: Snackbar, callToAction)
 	local callToActionText = ""
 	local onClick = nil
 	if type(callToAction) == "string" then
@@ -345,7 +368,7 @@ function Snackbar:_renderCallToAction(callToAction)
 		Size = UDim2.new(0, 0, 0, 18);
 		Text = UTF8.upper(callToActionText);
 		Font = Enum.Font.SourceSans;
-		FontSize = self._textLabel.FontSize;
+		TextSize = assert(self._textLabel, "Must have textLabel").TextSize;
 		TextXAlignment = Enum.TextXAlignment.Right;
 		TextColor3 = Blend.Computed(buttonModel:ObservePercentHighlighted(), function(percent)
 			local scale = Math.map(percent, 0, 1, 0, 0.2)

package/src/Shared/SnackbarOptionUtils.lua

@@ -9,11 +9,13 @@ local t = require("t")
 
 local SnackbarOptionUtils = {}
 
+export type CallToActionOptions = {
+	Text: string,
+	OnClick: ((any) -> any) | nil,
+}
+
 export type SnackbarOptions = {
-	CallToAction: string | {
-		Text: string,
-		OnClick: ((any) -> any) | nil,
-	} | nil,
+	CallToAction: string | CallToActionOptions?,
 }
 
 function SnackbarOptionUtils.createSnackbarOptions(options: SnackbarOptions): SnackbarOptions