pulse-rb 1.3.2 → 1.4.1

package/adapters/windui.lua

@@ -5,13 +5,20 @@
 
 -- Executor loadstring() environments are sandboxed — each chunk has its OWN environment
 -- table, separate from _G. Global reads in this chunk go through getfenv(1), not _G.
--- The compiler passes the bundle table (_P) as an argument; we write every key into
--- this chunk's own environment so names like "Pulse" resolve correctly below.
-local _P = ...
+-- The compiler passes (_P, _PULSE_LAYOUT) as arguments.
+local _P, _PULSE_LAYOUT = ...
 if type(_P) == "table" then
     local _env = (getfenv and getfenv(1)) or _ENV or _G
     for _k, _v in pairs(_P) do _env[_k] = _v end
 end
+_PULSE_LAYOUT = _PULSE_LAYOUT or {}
+
+-- Capture bundle table references as upvalues immediately so the startup block
+-- can access them without global lookups (which are environment-table-dependent
+-- in executor sandboxes and may fail in task.spawn callbacks).
+local _BundleComponents = type(_P) == "table" and _P.Components  or {}
+local _BundlePages      = type(_P) == "table" and _P._Pages      or {}
+local _BundlePulse      = type(_P) == "table" and _P.Pulse       or Pulse
 
 local _WINDUI_URL  = "https://github.com/Footagesus/WindUI/releases/download/1.6.64-fix/main.lua"
 local _PULSE_LOGO  = "https://pulse-rb.vercel.app/img/logo.svg"
@@ -177,6 +184,9 @@ function _UIAdapter:CreateWindow(title, w, h, opts)
         local tabProxy = { _wind = windTab }
         function tabProxy:AddLeftGroupbox(title, gbIcon)  return _mkSection(leftCol,  title, gbIcon) end
         function tabProxy:AddRightGroupbox(title, gbIcon) return _mkSection(rightCol, title, gbIcon) end
+        -- Raw column access — no Section wrapper (used by plain=true groupboxes)
+        function tabProxy:GetLeftColumn()  return { _container = leftCol  } end
+        function tabProxy:GetRightColumn() return { _container = rightCol } end
         return tabProxy
     end
 
@@ -210,7 +220,12 @@ function _UIAdapter:addToggle(gb, id, opts)
         Desc     = opts.tip or nil,
         Value    = opts.signal(),
         Flag     = id,
-        Callback = function(v) opts.signal(v) end,
+        Callback = function(v)
+            if _BundlePulse and _BundlePulse.Log then
+                _BundlePulse.Log.debug("ui", "toggle "..tostring(id).." → "..tostring(v))
+            end
+            opts.signal(v)
+        end,
     })
     _widgets[id] = elem
     _G.Toggles = _G.Toggles or {}
@@ -240,7 +255,12 @@ function _UIAdapter:addSlider(gb, id, opts)
         Step     = step,
         Value    = { Min = min, Max = max, Default = def },
         Flag     = id,
-        Callback = function(v) opts.signal(v) end,
+        Callback = function(v)
+            if _BundlePulse and _BundlePulse.Log then
+                _BundlePulse.Log.debug("ui", "slider "..tostring(id).." → "..tostring(v))
+            end
+            opts.signal(v)
+        end,
     })
     _widgets[id] = elem
     _G.Options = _G.Options or {}
@@ -357,7 +377,7 @@ function _UIAdapter:mount(component, gb)
     if not ui then return end
     for _, w in ipairs(ui) do
         local t   = w.type
-        local sig = component[w.signal]
+        local sig = w.signal   -- PulseSignal stored directly by .bind(sig) in TS widget builders
         if t == "toggle" then
             self:addToggle(gb, w.id, { label = w.label, signal = sig, tip = w.tip })
         elseif t == "slider" then
@@ -509,3 +529,688 @@ function Pulse.UI.section(container, title, icon, opened)
     function proxy:section(...)   return Pulse.UI.section(self, ...) end
     return proxy
 end
+
+-- ── Startup — create window, render pages, build Settings tab ─────────────────
+-- Runs after user code has registered all components and pages (task.spawn defers
+-- execution to the next frame, by which point all top-level TS calls have run).
+
+task.spawn(function()
+    task.wait(0)  -- yield one frame so definePage/defineComponent calls finish
+
+    local L = _PULSE_LAYOUT
+
+    -- Resolve toggle key
+    local _tkName = (L.toggleKey and L.toggleKey ~= "") and L.toggleKey or "RightControl"
+    local _tk = pcall(function() return Enum.KeyCode[_tkName] end) and Enum.KeyCode[_tkName]
+    _PULSE_TOGGLE_KEY  = _tk
+    _PULSE_DEFAULT_THEME = L.theme or "Dark"
+
+    -- Create the Wind UI window
+    local _win = _UIAdapter:CreateWindow(
+        L.title or "Hub",
+        L.sizeW or 950,
+        L.sizeH or 600,
+        {
+            icon                 = (L.icon and L.icon ~= "") and L.icon or nil,
+            author               = L.author or nil,
+            theme                = L.theme or "Dark",
+            folder               = (L.folder and L.folder ~= "") and L.folder or "Hub",
+            acrylic              = L.acrylic or false,
+            transparency         = L.transparency or 0.8,
+            toggleKey            = _tk,
+            openButtonMobileOnly = L.openButtonMobileOnly or false,
+            openButtonIcon       = (L.openButtonIcon and L.openButtonIcon ~= "") and L.openButtonIcon or nil,
+        }
+    )
+    _UIAdapter:SetToggleKey(_tk)
+
+    -- ── Home tab ──────────────────────────────────────────────────────────────
+    -- Always the first tab: player welcome, script info, executor/game context.
+
+    -- Player info
+    local _PS2     = game:GetService("Players")
+    local _LP2     = _PS2.LocalPlayer
+    local _dspName = (_LP2 and _LP2.DisplayName) or "Player"
+    local _usrName = (_LP2 and _LP2.Name)        or ""
+
+    -- Avatar thumbnail (GetUserThumbnailAsync yields — fine inside task.spawn)
+    local _avatarUrl = ""
+    pcall(function()
+        if _LP2 then
+            _avatarUrl = _PS2:GetUserThumbnailAsync(
+                _LP2.UserId,
+                Enum.ThumbnailType.HeadShot,
+                Enum.ThumbnailSize.Size100x100
+            )
+        end
+    end)
+
+    -- Executor detection
+    local _execName = "Unknown"
+    local _execVer  = ""
+    pcall(function()
+        if type(rawget(_G, "identifyexecutor")) == "function" then
+            local ok, n, v = pcall(identifyexecutor)
+            if ok then _execName = tostring(n or "Unknown"); _execVer = tostring(v or "") end
+        end
+        if _execName == "Unknown" and type(rawget(_G, "getexecutorname")) == "function" then
+            local ok, n = pcall(getexecutorname)
+            if ok and n then _execName = tostring(n) end
+        end
+        if _execName == "Unknown" then
+            if rawget(_G, "syn") or rawget(_G, "Synapse")   then _execName = "Synapse X"
+            elseif rawget(_G, "KRNL_LOADED")                then _execName = "Krnl"
+            elseif rawget(_G, "DELTA_KEY")                  then _execName = "Delta"
+            elseif rawget(_G, "WAVE_LOADED")                then _execName = "Wave"
+            elseif rawget(_G, "SOLARA_LOADED")              then _execName = "Solara"
+            elseif rawget(_G, "XENO_LOADED")                then _execName = "Xeno"
+            elseif rawget(_G, "Seliware") or rawget(_G, "seliware") then _execName = "Seliware"
+            elseif rawget(_G, "Celery")   or rawget(_G, "celery")   then _execName = "Celery"
+            elseif rawget(_G, "is_sirhurt_closure")         then _execName = "Sirhurt"
+            elseif rawget(_G, "EXECUTOR_NAME")              then _execName = tostring(rawget(_G, "EXECUTOR_NAME"))
+            end
+        end
+    end)
+
+    -- Game name (GetProductInfo yields)
+    local _gameName = "PlaceId " .. tostring(game.PlaceId)
+    pcall(function()
+        local info = game:GetService("MarketplaceService"):GetProductInfo(game.PlaceId)
+        if info and info.Name then _gameName = info.Name end
+    end)
+
+    -- Home tab — raw columns, no Section wrappers for a clean look.
+    -- Create the tab directly so we can get the raw VStack columns from _mkColumns.
+    local _homeWindTab
+    pcall(function() _homeWindTab = _windWindow:Tab({ Title = "Home", Icon = "house" }) end)
+    if not _UIAdapter._firstTab then _UIAdapter._firstTab = _homeWindTab end
+    local _homeLeft, _homeRight = _mkColumns(_homeWindTab)
+
+    -- Left: player info + description + discord (no Section box)
+    if _homeLeft then
+        -- Capture the returned paragraph element so we can try avatar injection via its Frame
+        local _paraRef = nil
+        pcall(function()
+            _paraRef = _homeLeft:Paragraph({
+                Title = "Welcome, " .. _dspName,
+                Desc  = "@" .. _usrName,
+            })
+        end)
+
+        -- Avatar injection: WindUI paragraph elements wrap a Roblox Frame internally.
+        -- Grab that Frame's parent (the list container) and add an ImageLabel there.
+        if _avatarUrl ~= "" and _paraRef then
+            task.delay(0.3, function()
+                pcall(function()
+                    local paraFrame = nil
+                    for _, k in ipairs({"Frame","Object","Instance","Container","Label","Content"}) do
+                        local ok, v = pcall(function() return _paraRef[k] end)
+                        if ok and type(v) == "userdata" then
+                            local _, isGui = pcall(function() return v:IsA("GuiObject") end)
+                            if isGui then paraFrame = v; break end
+                        end
+                    end
+                    local contentFrame = paraFrame and paraFrame.Parent
+                    if not (contentFrame and type(contentFrame) == "userdata") then return end
+                    if contentFrame:FindFirstChild("_PulseAvatar") then return end
+                    local img = Instance.new("ImageLabel")
+                    img.Name = "_PulseAvatar"; img.Image = _avatarUrl
+                    img.Size = UDim2.fromOffset(64, 64); img.BackgroundTransparency = 1
+                    img.ScaleType = Enum.ScaleType.Crop; img.LayoutOrder = -999
+                    Instance.new("UICorner", img).CornerRadius = UDim.new(1, 0)
+                    img.Parent = contentFrame
+                end)
+            end)
+        end
+
+        if L.description and L.description ~= "" then
+            pcall(function() _homeLeft:Divider() end)
+            pcall(function() _homeLeft:Paragraph({ Title = "About", Desc = L.description }) end)
+        end
+        if L.discord and L.discord ~= "" then
+            pcall(function() _homeLeft:Divider() end)
+            pcall(function()
+                _homeLeft:Button({
+                    Title    = "Join Discord",
+                    Desc     = "Tap to copy the invite link",
+                    Callback = function()
+                        local ok = false
+                        if not ok then pcall(function() setclipboard(L.discord);   ok=true end) end
+                        if not ok then pcall(function() toclipboard(L.discord);    ok=true end) end
+                        if not ok then pcall(function() writeclipboard(L.discord); ok=true end) end
+                        _PulseNotify(ok and "Discord link copied!" or "No clipboard API", 3)
+                    end,
+                })
+            end)
+        end
+    end
+
+    -- Right: script info + executor + game (no Section box)
+    if _homeRight then
+        local _verStr  = (L.version and L.version ~= "") and ("v" .. L.version) or ""
+        local _authStr = (L.author  and L.author  ~= "") and ("by " .. L.author) or ""
+        local _metaParts = {}
+        if _verStr  ~= "" then _metaParts[#_metaParts+1] = _verStr  end
+        if _authStr ~= "" then _metaParts[#_metaParts+1] = _authStr end
+        pcall(function()
+            _homeRight:Paragraph({
+                Title = L.title or "Hub",
+                Desc  = #_metaParts > 0 and table.concat(_metaParts, "  ·  ") or "—",
+            })
+        end)
+        pcall(function() _homeRight:Divider() end)
+        local _execStr = _execName .. (_execVer ~= "" and ("  " .. _execVer) or "")
+        pcall(function() _homeRight:Paragraph({ Title = "Executor", Desc = _execStr }) end)
+        pcall(function() _homeRight:Paragraph({ Title = "Game", Desc = _gameName }) end)
+        pcall(function() _homeRight:Divider() end)
+        -- Server info: live player count + rejoin
+        local _playerCount = 0
+        pcall(function() _playerCount = #game:GetService("Players"):GetPlayers() end)
+        pcall(function()
+            _homeRight:Paragraph({
+                Title = "Server",
+                Desc  = tostring(_playerCount) .. " player" .. (_playerCount == 1 and "" or "s") .. "  ·  " .. tostring(game.PlaceId),
+            })
+        end)
+        pcall(function()
+            _homeRight:Button({
+                Title    = "Rejoin Server",
+                Desc     = "Leave and rejoin the current place",
+                Callback = function()
+                    pcall(function()
+                        game:GetService("TeleportService"):TeleportToPlaceInstance(
+                            game.PlaceId, game.JobId,
+                            game:GetService("Players").LocalPlayer
+                        )
+                    end)
+                end,
+            })
+        end)
+        if L.unsupported and L.unsupported ~= "" then
+            local _unsupList = {}
+            if type(L.unsupported) == "table" then
+                for _, v in ipairs(L.unsupported) do _unsupList[#_unsupList+1] = tostring(v) end
+            elseif type(L.unsupported) == "string" then
+                for part in L.unsupported:gmatch("[^,]+") do
+                    _unsupList[#_unsupList+1] = part:match("^%s*(.-)%s*$")
+                end
+            end
+            if #_unsupList > 0 then
+                pcall(function() _homeRight:Divider() end)
+                pcall(function()
+                    _homeRight:Paragraph({
+                        Title = "Not compatible with:",
+                        Desc  = table.concat(_unsupList, ", "),
+                    })
+                end)
+            end
+        end
+    end
+
+    -- Render user pages (upvalue _BundlePages — avoids global lookup in executor sandbox)
+    for _, page in ipairs(_BundlePages) do
+        local tab = _win:AddTab(page.title, page.icon)
+        for _, gb in ipairs(page.layout or {}) do
+            local container
+            if gb.plain then
+                -- No Section wrapper — widgets go directly onto the column VStack
+                if gb.side == "left" then
+                    if tab.GetLeftColumn then container = tab:GetLeftColumn() end
+                else
+                    if tab.GetRightColumn then container = tab:GetRightColumn() end
+                end
+            elseif gb.side == "left" then
+                container = tab:AddLeftGroupbox(gb.title, gb.icon)
+            else
+                container = tab:AddRightGroupbox(gb.title, gb.icon)
+            end
+            if gb.mount then
+                local comp = _BundleComponents[gb.mount]
+                if comp then
+                    local ok, err = pcall(function() _UIAdapter:mount(comp, container) end)
+                    if not ok then
+                        warn("[Pulse] mount '" .. gb.mount .. "' error: " .. tostring(err))
+                        if _BundlePulse and _BundlePulse.Log then
+                            _BundlePulse.Log.error("ui", "mount '"..gb.mount.."' failed: "..tostring(err))
+                        end
+                    else
+                        if _BundlePulse and _BundlePulse.Log then
+                            local nw = comp._ui and #comp._ui or 0
+                            _BundlePulse.Log.debug("ui", "mounted '"..gb.mount.."' ("..nw.." widgets)")
+                        end
+                    end
+                else
+                    warn("[Pulse] component '" .. gb.mount .. "' not found in registry")
+                    if _BundlePulse and _BundlePulse.Log then
+                        _BundlePulse.Log.error("ui", "component '"..gb.mount.."' not in registry")
+                    end
+                end
+            else
+                for _, w in ipairs(gb.widgets or {}) do
+                    pcall(function() _UIAdapter:mount({ _ui = {w}, _name = gb.title }, container) end)
+                end
+            end
+        end
+    end
+
+    -- ── Settings tab ──────────────────────────────────────────────────────────
+    local _settingsTab = _win:AddTab("Settings", "settings")
+
+    -- Appearance groupbox
+    local gb_appear = _settingsTab:AddLeftGroupbox("Appearance")
+    local _themeValues = _UIAdapter:GetThemeNames()
+        or { "Amber","CottonCandy","Crimson","Dark","Emerald","Indigo","Light",
+             "Mellowsi","Midnight","MonokaiPro","Plant","Rainbow","Red","Rose","Sky","Violet" }
+    gb_appear._container:Dropdown({
+        Title    = "Theme",
+        Values   = _themeValues,
+        Value    = _PULSE_DEFAULT_THEME,
+        Flag     = "Settings_theme",
+        Callback = function(v) _UIAdapter:SetTheme(v) end,
+    })
+
+    -- Config groupbox
+    local gb_cfg = _settingsTab:AddLeftGroupbox("Configuration")
+    _UIAdapter:addParagraph(gb_cfg,
+        "Config is stored in your executor's filesystem.",
+        "Save writes the current state. Load restores the last saved state."
+    )
+    gb_cfg._container:Button({
+        Title    = "Save Config",
+        Icon     = "save",
+        Callback = function()
+            if _UIAdapter.Config then
+                local ok, err = pcall(function() _UIAdapter.Config:Save() end)
+                _PulseNotify(ok and "Config saved." or ("Save failed: " .. tostring(err)), 3)
+            else
+                _PulseNotify("Config manager unavailable.", 3)
+            end
+        end,
+    })
+    gb_cfg._container:Button({
+        Title    = "Load Config",
+        Icon     = "folder-open",
+        Callback = function()
+            if _UIAdapter.Config then
+                local ok, err = pcall(function() _UIAdapter.Config:Load() end)
+                _PulseNotify(ok and "Config loaded." or ("Load failed: " .. tostring(err)), 3)
+            else
+                _PulseNotify("Config manager unavailable.", 3)
+            end
+        end,
+    })
+
+    -- Menu settings groupbox
+    local gb_menu = _settingsTab:AddRightGroupbox("Menu Settings")
+    _UIAdapter:addButton(gb_menu, {
+        label  = "Destroy UI",
+        action = function() _PulseDestroy() end,
+        tip    = "Unloads the script and removes all UI",
+    })
+    _UIAdapter:addKeybind(gb_menu, "Settings_MenuKeybind", {
+        label  = "Menu Toggle",
+        key    = _PULSE_TOGGLE_KEY,
+        action = function() _UIAdapter:ToggleWindow() end,
+    })
+    gb_menu._container:Button({
+        Title    = "Rejoin",
+        Icon     = "refresh-cw",
+        Desc     = "Leave and rejoin the current place",
+        Callback = function()
+            pcall(function()
+                game:GetService("TeleportService"):TeleportToPlaceInstance(
+                    game.PlaceId, game.JobId,
+                    game:GetService("Players").LocalPlayer
+                )
+            end)
+        end,
+    })
+
+    -- Auto-load saved config on startup
+    task.spawn(function()
+        task.wait(1.5)
+        if _UIAdapter.Config then
+            local ok = pcall(function() _UIAdapter.Config:Load() end)
+            if ok and _BundlePulse and _BundlePulse.Log then _BundlePulse.Log.info("settings", "config auto-loaded") end
+        end
+    end)
+
+    -- ── Dev tab (--dev builds only) ───────────────────────────────────────────
+    if L.dev then
+        local _devTab
+        pcall(function() _devTab = _windWindow:Tab({ Title = "Dev", Icon = "bug" }) end)
+        if _devTab then
+            local _devLeft, _devRight
+            pcall(function()
+                local _devHs = _devTab:HStack({ AutoSpace = true })
+                _devLeft  = _devHs:VStack({})
+                _devRight = _devHs:VStack({})
+            end)
+            _devLeft  = _devLeft  or _devTab
+            _devRight = _devRight or _devTab
+
+            -- Tools section (left)
+            local _toolSect
+            pcall(function()
+                _toolSect = _devLeft:Section({ Title="Tools", Icon="wrench", Box=true, BoxBorder=true, Opened=true })
+            end)
+
+            local _TOOLS = {
+                { name="Hydroxide",      desc="Remote spy with web interface",       url=nil,
+                  load=function()
+                    local function webImport(f)
+                        loadstring(game:HttpGetAsync(("https://raw.githubusercontent.com/Upbolt/Hydroxide/revision/%s.lua"):format(f)), f..".lua")()
+                    end
+                    webImport("init"); webImport("ui/main")
+                  end },
+                { name="Infinite Yield", desc="Admin / exploit command panel",       url="https://raw.githubusercontent.com/DarkNetworks/Infinite-Yield/main/latest.lua" },
+                { name="Dex Explorer",   desc="Browse and inspect the live game tree",url="https://raw.githubusercontent.com/infyiff/backup/main/dex.lua" },
+            }
+
+            if _toolSect then
+                for _, tool in ipairs(_TOOLS) do
+                    local _launched = false
+                    local _btn
+                    pcall(function()
+                        _btn = _toolSect:Button({
+                            Title    = tool.name,
+                            Desc     = tool.desc,
+                            Callback = function()
+                                if _launched then _PulseNotify("Already running: "..tool.name, 2); return end
+                                pcall(function() _btn:SetTitle(tool.name.."  ·  loading…") end)
+                                task.spawn(function()
+                                    local ok, err = pcall(function()
+                                        if tool.load then
+                                            tool.load()
+                                        else
+                                            local src = game:HttpGet(tool.url)
+                                            local fn, ce = loadstring(src)
+                                            if not fn then error(ce) end
+                                            fn()
+                                        end
+                                    end)
+                                    if ok then
+                                        _launched = true
+                                        pcall(function() _btn:SetTitle("✓  "..tool.name) end)
+                                        _PulseNotify(tool.name.." launched", 3)
+                                    else
+                                        pcall(function() _btn:SetTitle(tool.name.."  ·  failed") end)
+                                        _PulseNotify(tool.name.." failed: "..tostring(err):sub(1,60), 4)
+                                        task.delay(3, function()
+                                            if not _launched then pcall(function() _btn:SetTitle(tool.name) end) end
+                                        end)
+                                    end
+                                end)
+                            end,
+                        })
+                    end)
+                end
+            end
+
+            -- Scanner section
+            local _scanSect
+            pcall(function()
+                _scanSect = _devRight:Section({ Title="Scanner", Icon="scan", Box=true, BoxBorder=true, Opened=true })
+            end)
+
+            if _scanSect then
+                local _lastScan = ""
+                local _statusPara
+                pcall(function()
+                    _statusPara = _scanSect:Paragraph({
+                        Title = "Game Scanner",
+                        Desc  = "Auto-scan runs on inject. Results copied to clipboard.",
+                    })
+                end)
+
+                local function _devCopy(text)
+                    local ok = false
+                    if not ok then pcall(function() setclipboard(text);   ok=true end) end
+                    if not ok then pcall(function() toclipboard(text);    ok=true end) end
+                    if not ok then pcall(function() writeclipboard(text); ok=true end) end
+                    return ok
+                end
+
+                local _ALIASES = {
+                    { "Players.LocalPlayer.PlayerGui.", "PG." },
+                    { "Players.LocalPlayer.",           "LP." },
+                    { "ReplicatedStorage.",             "RS." },
+                    { "ReplicatedFirst.",               "RF." },
+                    { "workspace.",                     "WS." },
+                }
+                local function _compress(obj)
+                    local parts = {}; local cur = obj
+                    while cur and cur ~= game do table.insert(parts, 1, cur.Name); cur = cur.Parent end
+                    local s = table.concat(parts, ".")
+                    for _, pair in ipairs(_ALIASES) do
+                        if s:sub(1, #pair[1]) == pair[1] then return pair[2]..s:sub(#pair[1]+1) end
+                    end
+                    return s
+                end
+
+                local function _doScan()
+                    pcall(function() _statusPara:SetDesc("Scanning…") end)
+                    task.spawn(function()
+                        local out = {}
+                        local RS = game:GetService("ReplicatedStorage")
+                        local gameName = "?"
+                        pcall(function()
+                            gameName = game:GetService("MarketplaceService"):GetProductInfo(game.PlaceId).Name
+                        end)
+                        table.insert(out, ("[%s]  pid:%d"):format(gameName, game.PlaceId))
+
+                        local remotes = {}
+                        local function _scanRemotes(inst, depth)
+                            if depth > 8 then return end
+                            local ok, ch = pcall(function() return inst:GetChildren() end)
+                            if not ok then return end
+                            for _, c in ipairs(ch) do
+                                local cls = c.ClassName
+                                if cls == "RemoteEvent" or cls == "RemoteFunction" then
+                                    table.insert(remotes, { p=_compress(c), t=cls=="RemoteEvent" and "RE" or "RF" })
+                                end
+                                if c:IsA("Folder") or c:IsA("Configuration") or c:IsA("Model") then
+                                    _scanRemotes(c, depth+1)
+                                end
+                            end
+                        end
+                        pcall(_scanRemotes, RS, 0)
+                        table.sort(remotes, function(a,b) return a.p < b.p end)
+                        table.insert(out, ("REMOTES (%d)"):format(#remotes))
+                        for i, r in ipairs(remotes) do
+                            if i > 50 then table.insert(out, ("  ...+%d more"):format(#remotes-50)); break end
+                            table.insert(out, ("  %-52s %s"):format(r.p, r.t))
+                        end
+
+                        local txt = table.concat(out, "\n")
+                        _lastScan = txt
+                        local copied = _devCopy(txt)
+                        local summary = ("%d remotes%s"):format(#remotes, copied and " · copied" or "")
+                        pcall(function()
+                            _statusPara:SetTitle("Scan  "..os.date("%H:%M:%S"))
+                            _statusPara:SetDesc(summary)
+                        end)
+                        if copied then _PulseNotify("Scan complete · "..summary, 4) end
+                    end)
+                end
+
+                pcall(function()
+                    _scanSect:Button({
+                        Title="Scan Now", Desc="Scan remotes and copy to clipboard",
+                        Callback = _doScan,
+                    })
+                end)
+                pcall(function()
+                    _scanSect:Button({
+                        Title="Copy Last Results", Desc="Re-copy most recent scan",
+                        Callback = function()
+                            if _lastScan == "" then _PulseNotify("No scan yet", 2); return end
+                            local ok = _devCopy(_lastScan)
+                            _PulseNotify(ok and "Copied" or "No clipboard function", 2)
+                        end,
+                    })
+                end)
+
+                -- Auto-scan on inject
+                task.spawn(function()
+                    if not game:IsLoaded() then game.Loaded:Wait() end
+                    task.wait(2)
+                    _doScan()
+                end)
+            end
+
+            -- Info section — framework version + signal counts for debugging
+            local _infoSect
+            pcall(function()
+                _infoSect = _devLeft:Section({ Title="Pulse Info", Icon="info", Box=true, BoxBorder=true, Opened=true })
+            end)
+            if _infoSect then
+                local nPages = #_BundlePages
+                local nComps = 0
+                for _ in pairs(_BundleComponents) do nComps = nComps + 1 end
+                pcall(function()
+                    _infoSect:Paragraph({
+                        Title = "Framework",
+                        Desc  = ("pages=%d  components=%d  theme=%s"):format(nPages, nComps, L.theme or "?"),
+                    })
+                end)
+                for cname, comp in pairs(_BundleComponents) do
+                    if type(comp) == "table" and comp._ui then
+                        pcall(function()
+                            _infoSect:Paragraph({
+                                Title = cname,
+                                Desc  = ("%d widget(s)"):format(#comp._ui),
+                            })
+                        end)
+                    end
+                end
+            end
+
+            -- Heartbeat Monitor section — tick counts per component (left)
+            -- Uses Pulse.Monitor which is independent of the log system.
+            local _monSect
+            pcall(function()
+                _monSect = _devLeft:Section({ Title="Heartbeat Monitor", Icon="activity", Box=true, BoxBorder=true, Opened=true })
+            end)
+            if _monSect then
+                local _monPara
+                pcall(function()
+                    _monPara = _monSect:Paragraph({
+                        Title = "raw / cond  (updates 2s)",
+                        Desc  = "raw = every HB fire · cond = when() passed",
+                    })
+                end)
+                -- Reads _rawHb/_condHb plain-Lua counters set in runtime._hbBind.
+                -- No dependency on Pulse.Monitor — works regardless of log system state.
+                task.spawn(function()
+                    while _windWindow do
+                        task.wait(2)
+                        pcall(function()
+                            local lines = {}
+                            for cname, comp in pairs(_BundleComponents) do
+                                if type(comp) == "table" and comp._rawHb ~= nil then
+                                    lines[#lines+1] = cname
+                                        .. "  raw=" .. tostring(comp._rawHb)
+                                        .. "  cond=" .. tostring(comp._condHb)
+                                end
+                            end
+                            if _monPara then
+                                if #lines == 0 then
+                                    _monPara:SetDesc("No heartbeat components registered")
+                                else
+                                    table.sort(lines)
+                                    _monPara:SetDesc(table.concat(lines, "\n"))
+                                end
+                            end
+                        end)
+                    end
+                end)
+            end
+
+            -- Console section — controls for the Roblox developer console (F9).
+            -- "Clear" wipes the output so only your next prints are visible.
+            -- "Print Logs" re-dumps all buffered Pulse.Log entries so you can read
+            -- them cleanly after a clear without any engine noise in the way.
+            -- "Copy Logs" copies the full log buffer to clipboard.
+            local _consoleSect
+            pcall(function()
+                _consoleSect = _devRight:Section({ Title="Console  (F9)", Icon="terminal", Box=true, BoxBorder=true, Opened=true })
+            end)
+            if _consoleSect and _BundlePulse and _BundlePulse.Log then
+                local _Log = _BundlePulse.Log
+
+                -- Clear console: try executor functions, fall back to blank lines separator.
+                local function _clearConsole()
+                    local cleared = false
+                    if not cleared then pcall(function() consoleclear();    cleared=true end) end
+                    if not cleared then pcall(function() clearoutput();     cleared=true end) end
+                    if not cleared then pcall(function()
+                        game:GetService("LogService"):ClearOutput(); cleared=true
+                    end) end
+                    if not cleared then
+                        -- visual separator when no clear API is available
+                        print(("\n"):rep(40))
+                        print("──────────── console cleared ────────────")
+                    end
+                end
+
+                local function _copyLogs()
+                    local txt = _Log.dump()
+                    local ok = false
+                    if not ok then pcall(function() setclipboard(txt);   ok=true end) end
+                    if not ok then pcall(function() toclipboard(txt);    ok=true end) end
+                    if not ok then pcall(function() writeclipboard(txt); ok=true end) end
+                    _PulseNotify(ok and "Logs copied to clipboard" or "No clipboard API available", 3)
+                end
+
+                local function _printLogs()
+                    local entries = _Log.getNewEntries(0)
+                    print("──────────── Pulse Logs (" .. #entries .. ") ────────────")
+                    for _, e in ipairs(entries) do
+                        if e.n >= 3 then warn(e.line) else print(e.line) end
+                    end
+                    print("─────────────────────────────────────────")
+                end
+
+                pcall(function()
+                    _consoleSect:Button({
+                        Title    = "Clear Console",
+                        Desc     = "Wipe F9 output — then use Print Logs to see only yours",
+                        Callback = _clearConsole,
+                    })
+                end)
+                pcall(function()
+                    _consoleSect:Button({
+                        Title    = "Print Logs",
+                        Desc     = "Re-print all Pulse.Log entries to F9 console",
+                        Callback = _printLogs,
+                    })
+                end)
+                pcall(function()
+                    _consoleSect:Button({
+                        Title    = "Copy Logs",
+                        Desc     = "Copy full log buffer to clipboard",
+                        Callback = _copyLogs,
+                    })
+                end)
+                pcall(function()
+                    _consoleSect:Button({
+                        Title    = "Clear Log Buffer",
+                        Desc     = "Reset the in-memory Pulse.Log buffer",
+                        Callback = function()
+                            _Log.clear()
+                            _PulseNotify("Log buffer cleared", 2)
+                        end,
+                    })
+                end)
+            end
+        end
+    end
+
+    -- Re-select first tab (Home) — Settings is last so Wind UI leaves it active
+    task.defer(function()
+        if _UIAdapter._firstTab then
+            pcall(function() _UIAdapter._firstTab:Select() end)
+        end
+    end)
+end)