@nrbx/topbar-components 1.0.2 → 1.0.4

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 = {}
@@ -19,16 +20,18 @@ local function sortByDock(children)
 		if child == nil then
 			return nil
 		end
-		local props = child.props
-		local _dock = props
-		if _dock ~= nil then
-			_dock = _dock.dock
+		local childObj = child
+		local props = childObj.props
+		local _dockValue = props
+		if _dockValue ~= nil then
+			_dockValue = _dockValue.dock
 		end
-		local dock = _dock
-		if dock == "Center" then
+		local dockValue = _dockValue
+		debugLog(`sortByDock child: hasProps={props ~= nil}`, `dock="{dockValue}"`, `→ {if dockValue == "Center" then "Center" elseif dockValue == "Right" then "Right" else "Left"}`)
+		if dockValue == "Center" then
 			center[ci + 1] = child
 			ci += 1
-		elseif dock == "Right" then
+		elseif dockValue == "Right" then
 			right[ri + 1] = child
 			ri += 1
 		else
@@ -36,6 +39,7 @@ local function sortByDock(children)
 			li += 1
 		end
 	end)
+	debugLog(`sortByDock totals: left={#left} center={#center} right={#right}`)
 	return { left, center, right }
 end
 local function TopbarProvider(_param)
@@ -51,7 +55,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 +133,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 +148,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 +162,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.4",
   "main": "out/init.lua",
   "scripts": {
     "build": "rbxtsc",