@nrbx/topbar-components 1.0.2 → 1.0.3

package/out/components/provider.luau

@@ -8,6 +8,7 @@ local LocationContext = _context.LocationContext
 local useStylesheet = _context.useStylesheet
 local useGuiInset = TS.import(script, script.Parent.Parent, "hooks", "use-gui-inset").useGuiInset
 local useVoicechatEnabled = TS.import(script, script.Parent.Parent, "hooks", "use-voicechat-enabled").useVoicechatEnabled
+local debugLog = TS.import(script, script.Parent.Parent, "utilities", "debug").debugLog
 local function sortByDock(children)
 	local left = {}
 	local center = {}
@@ -51,7 +52,9 @@ local function TopbarProvider(_param)
 	local stylesheet = useStylesheet().provider
 	local hasBetaLabel = gameVoiceChatEnabled and voiceChatEnabled
 	local leftPadding = if hasBetaLabel then stylesheet.paddingLeft + 16 else stylesheet.paddingLeft
-	local frameHeight = inset.Height - stylesheet.insetHeightOffset
+	local rawHeight = inset.Height - stylesheet.insetHeightOffset
+	local frameHeight = if stylesheet.forceFrameHeight ~= nil then stylesheet.forceFrameHeight else rawHeight
+	debugLog(`TopbarProvider frame: inset.Height={inset.Height}, inset.Width={inset.Width}`, `insetHeightOffset={stylesheet.insetHeightOffset}`, `rawHeight={rawHeight}`, `forceFrameHeight={stylesheet.forceFrameHeight}`, `finalHeight={frameHeight}`, `sizeScale=({stylesheet.sizeScale.X}, {stylesheet.sizeScale.Y})`)
 	local _binding = sortByDock(children)
 	local leftChildren = _binding[1]
 	local centerChildren = _binding[2]
@@ -127,6 +130,7 @@ local function TopbarProvider(_param)
 		FillDirection = Enum.FillDirection.Horizontal,
 		SortOrder = Enum.SortOrder.LayoutOrder,
 		Padding = UDim.new(0, stylesheet.iconSpacing),
+		VerticalAlignment = Enum.VerticalAlignment.Center,
 	}), leftChildren), hasCenter and (React.createElement("frame", {
 		key = "CenterDock",
 		BackgroundTransparency = 1,
@@ -141,6 +145,7 @@ local function TopbarProvider(_param)
 		FillDirection = Enum.FillDirection.Horizontal,
 		SortOrder = Enum.SortOrder.LayoutOrder,
 		Padding = UDim.new(0, stylesheet.iconSpacing),
+		VerticalAlignment = Enum.VerticalAlignment.Center,
 	}), centerChildren)), hasRight and (React.createElement("frame", {
 		key = "RightDock",
 		BackgroundTransparency = 1,
@@ -154,6 +159,7 @@ local function TopbarProvider(_param)
 		FillDirection = Enum.FillDirection.Horizontal,
 		SortOrder = Enum.SortOrder.LayoutOrder,
 		Padding = UDim.new(0, stylesheet.iconSpacing),
+		VerticalAlignment = Enum.VerticalAlignment.Center,
 	}), rightChildren))))
 end
 return {

package/out/style.d.ts

@@ -23,6 +23,11 @@ export interface Stylesheet {
         insetHeightOffset: number;
         /** Extra gap between left, center, and right icon groups (default 0) */
         iconGroupSpacing: number;
+        /**
+         * Explicit override for the provider frame Y size (in pixels).
+         * When set, this replaces the automatic `(inset.Height - insetHeightOffset) * sizeScale.Y` calculation.
+         */
+        forceFrameHeight: number | undefined;
     };
     /**
      * Fine-grained sizing & layout overrides for icon internals.

package/out/style.luau

@@ -89,6 +89,7 @@ local DefaultStylesheet = {
 		sizeScale = Vector2.new(1, 1),
 		insetHeightOffset = 0,
 		iconGroupSpacing = 0,
+		forceFrameHeight = nil,
 	},
 	sizing = {
 		iconHeight = nil,

package/out/utilities/debug.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Logs a debug message to the console only when `_G.__DEBUG__` is truthy.
+ * No-op in production — stripped at the call site when debug is off.
+ */
+export declare function debugLog(...messages: unknown[]): void;

package/out/utilities/debug.luau

@@ -0,0 +1,17 @@
+-- Compiled with roblox-ts v3.0.0
+--[[
+	*
+	 * Logs a debug message to the console only when `_G.__DEBUG__` is truthy.
+	 * No-op in production — stripped at the call site when debug is off.
+	 
+]]
+local function debugLog(...)
+	local messages = { ... }
+	local _value = _G.__DEBUG__
+	if _value ~= 0 and _value == _value and _value ~= "" and _value then
+		print(`[DEBUG]`, unpack(messages))
+	end
+end
+return {
+	debugLog = debugLog,
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nrbx/topbar-components",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "main": "out/init.lua",
   "scripts": {
     "build": "rbxtsc",