pulse-rb 1.3.1 → 1.4.0

package/adapters/windui.lua

@@ -3,13 +3,22 @@
 -- Docs:       footagesus.github.io/treehub-web/docs/windui
 -- Version:    1.6.64-fix (pinned)
 
--- Executor loadstring() environments are sandboxed — _G is NOT shared between chunks.
--- The compiler passes the bundle table (_P) as an argument so we can propagate all
--- runtime globals into this chunk's own environment before any adapter code runs.
-local _P = ...
+-- 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 (_P, _PULSE_LAYOUT) as arguments.
+local _P, _PULSE_LAYOUT = ...
 if type(_P) == "table" then
-    for _k, _v in pairs(_P) do _G[_k] = _v end
+    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"
@@ -208,7 +217,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 {}
@@ -238,7 +252,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 {}
@@ -355,7 +374,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
@@ -507,3 +526,564 @@ 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 n, v = identifyexecutor()
+            _execName = tostring(n or "Unknown")
+            _execVer  = tostring(v or "")
+        elseif rawget(_G, "syn")                then _execName = "Synapse X"
+        elseif rawget(_G, "KRNL_LOADED")        then _execName = "Krnl"
+        elseif rawget(_G, "Delta")              then _execName = "Delta"
+        elseif rawget(_G, "is_sirhurt_closure") then _execName = "Sirhurt"
+        elseif rawget(_G, "EXECUTOR_NAME")      then _execName = tostring(rawget(_G, "EXECUTOR_NAME"))
+        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)
+
+    local _homeTab = _win:AddTab("Home", "house")
+
+    -- Left column ──────────────────────────────────────────────────────────────
+
+    -- Welcome / player section
+    local _welcomeGb = _homeTab:AddLeftGroupbox("Welcome", "person")
+    if _avatarUrl ~= "" then
+        -- WindUI Image element — silently skipped if unsupported
+        pcall(function()
+            _welcomeGb._container:Image({
+                Source = _avatarUrl,
+                Size   = UDim2.fromOffset(96, 96),
+            })
+        end)
+    end
+    _welcomeGb._container:Paragraph({
+        Title = _dspName,
+        Desc  = "@" .. _usrName,
+    })
+
+    if L.description and L.description ~= "" then
+        _welcomeGb._container:Divider()
+        _welcomeGb._container:Paragraph({ Title = "", Desc = L.description })
+    end
+
+    if L.discord and L.discord ~= "" then
+        local _discGb = _homeTab:AddLeftGroupbox("Community", "message-circle")
+        _discGb._container: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 available", 3)
+            end,
+        })
+    end
+
+    -- Right column ─────────────────────────────────────────────────────────────
+
+    -- Script metadata
+    local _scriptGb = _homeTab:AddRightGroupbox("Script", "code-2")
+    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
+    _scriptGb._container:Paragraph({
+        Title = L.title or "Hub",
+        Desc  = #_metaParts > 0 and table.concat(_metaParts, "  ·  ") or "—",
+    })
+
+    -- System info
+    local _sysGb = _homeTab:AddRightGroupbox("System", "monitor")
+    _sysGb._container:Paragraph({
+        Title = "Executor",
+        Desc  = _execName .. (_execVer ~= "" and ("  " .. _execVer) or ""),
+    })
+    _sysGb._container:Paragraph({ Title = "Game", Desc = _gameName })
+
+    -- Unsupported executors (optional — set L.unsupported in layout config)
+    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
+            local _unsupGb = _homeTab:AddRightGroupbox("Not Supported", "alert-triangle")
+            _unsupGb._container:Paragraph({
+                Title = "Not compatible with:",
+                Desc  = table.concat(_unsupList, ", "),
+            })
+        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.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,
+    })
+
+    -- 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 _devCol
+            pcall(function() _devCol = _devTab:VStack({}) end)
+            _devCol = _devCol or _devTab
+
+            -- Tools section
+            local _toolSect
+            pcall(function()
+                _toolSect = _devCol: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 = _devCol: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 = _devCol: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
+
+            -- 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 = _devCol: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)

package/dist/index.js

@@ -56,7 +56,7 @@ var RB_VERSION, RB_HOME, IRONBREW2_DIR, IRONBREW2_REPO, ALWAYS_EXCLUDE, VALID_UI
 var init_constants = __esm({
   "src/constants.ts"() {
     init_cjs_shims();
-    RB_VERSION = "1.3.1";
+    RB_VERSION = "1.4.0";
     RB_HOME = path.join(os.homedir(), ".rb");
     path.join(RB_HOME, "bin");
     IRONBREW2_DIR = path.join(RB_HOME, "ironbrew2");
@@ -1193,6 +1193,59 @@ end)
         }
         return "windui";
       }
+      readLayoutConfig() {
+        const layoutTs = path.join(this.srcDir, "layout.ts");
+        const cfg = {
+          title: "Script Hub",
+          author: "",
+          toggleKey: "RightControl",
+          sizeW: 950,
+          sizeH: 600,
+          theme: "Dark",
+          icon: "",
+          folder: "Hub",
+          acrylic: false,
+          transparency: 0.8,
+          openButtonMobileOnly: false,
+          openButtonIcon: "",
+          description: "",
+          discord: "",
+          version: ""
+        };
+        if (!fs.existsSync(layoutTs)) return cfg;
+        const src = fs.readFileSync(layoutTs, "utf8");
+        const str = (key) => {
+          const m = src.match(new RegExp(key + `\\s*:\\s*['"]([^'"]+)['"]`));
+          if (m) cfg[key] = m[1];
+        };
+        const bool = (key) => {
+          const m = src.match(new RegExp(key + `\\s*:\\s*(true|false)`));
+          if (m) cfg[key] = m[1] === "true";
+        };
+        const num = (key) => {
+          const m = src.match(new RegExp(key + `\\s*:\\s*([\\d.]+)`));
+          if (m) cfg[key] = parseFloat(m[1]);
+        };
+        str("title");
+        str("author");
+        str("toggleKey");
+        str("theme");
+        str("icon");
+        str("folder");
+        str("openButtonIcon");
+        str("description");
+        str("discord");
+        str("version");
+        bool("acrylic");
+        bool("openButtonMobileOnly");
+        num("transparency");
+        const sz = src.match(/size\s*:\s*\[(\d+)\s*,\s*(\d+)\]/);
+        if (sz) {
+          cfg["sizeW"] = parseInt(sz[1]);
+          cfg["sizeH"] = parseInt(sz[2]);
+        }
+        return cfg;
+      }
       resolveUi(ui) {
         if (!ui) ui = this.getUiLibrary();
         if (!VALID_UI_LIBS.has(ui)) throw new Error(`Unknown UI library '${ui}'. Valid: ${[...VALID_UI_LIBS].sort().join(", ")}`);
@@ -1247,7 +1300,7 @@ end)
           if (path.relative(src, f).split(/[/\\]/).length === 1) continue;
           middle.push(f);
         }
-        if (opts.dev) {
+        if (opts.dev && !opts.cdn) {
           const fwDevUi = path.join(PULSE_DEV_DIR, "ui");
           if (fs.existsSync(fwDevUi)) {
             for (const f of rglob(fwDevUi, [".lua", ".rblua", ".ts"]).sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()))) {
@@ -1288,13 +1341,39 @@ end)
         parts.push("\n");
         if (hasTs) {
           const base = `${CDN_BASE_URL}/v${RB_VERSION}`;
+          const lc = this.readLayoutConfig();
+          const luaBool = (v) => v ? "true" : "false";
           parts.push(`-- Pulse v${RB_VERSION}
+`);
+          parts.push(`local _PULSE_LAYOUT={`);
+          parts.push(`title=${JSON.stringify(lc["title"])},`);
+          parts.push(`author=${JSON.stringify(lc["author"])},`);
+          parts.push(`toggleKey=${JSON.stringify(lc["toggleKey"])},`);
+          parts.push(`sizeW=${lc["sizeW"]},sizeH=${lc["sizeH"]},`);
+          parts.push(`theme=${JSON.stringify(lc["theme"])},`);
+          parts.push(`icon=${JSON.stringify(lc["icon"])},`);
+          parts.push(`folder=${JSON.stringify(lc["folder"])},`);
+          parts.push(`acrylic=${luaBool(lc["acrylic"])},`);
+          parts.push(`transparency=${lc["transparency"]},`);
+          parts.push(`openButtonMobileOnly=${luaBool(lc["openButtonMobileOnly"])},`);
+          parts.push(`openButtonIcon=${JSON.stringify(lc["openButtonIcon"])}`);
+          if (lc["description"]) parts.push(`,description=${JSON.stringify(lc["description"])}`);
+          if (lc["discord"]) parts.push(`,discord=${JSON.stringify(lc["discord"])}`);
+          if (lc["version"]) parts.push(`,version=${JSON.stringify(lc["version"])}`);
+          if (opts.dev) parts.push(`,dev=true`);
+          parts.push(`}
 `);
           parts.push(`local _P=loadstring(game:HttpGet("${base}/bundle.lua"))()
 `);
+          if (opts.dev) {
+            parts.push(`_PULSE_DEV = true
+`);
+            parts.push(`if _P.Pulse and _P.Pulse.Log then _P.Pulse.Log.enable() end
+`);
+          }
           parts.push(`for _k,_v in pairs(_P) do _G[_k]=_v end
 `);
-          parts.push(`local _A=loadstring(game:HttpGet("${base}/adapters/${ui}.lua"))(_P)
+          parts.push(`local _A=loadstring(game:HttpGet("${base}/adapters/${ui}.lua"))(_P,_PULSE_LAYOUT)
 `);
           parts.push(`local signal,computed,defineComponent,on=_P.signal,_P.computed,_P.defineComponent,_P.on
 `);
@@ -1304,17 +1383,6 @@ end)
 `);
           parts.push("\n");
         }
-        if (opts.dev && fs.existsSync(PULSE_DEV_DIR)) {
-          const rbRoot = path.join(__dirname, "..", "..");
-          for (const f of fs.readdirSync(PULSE_DEV_DIR).filter((n) => n.endsWith(".lua")).sort()) {
-            const full = path.join(PULSE_DEV_DIR, f);
-            const rel = path.relative(rbRoot, full).replace(/\\/g, "/");
-            parts.push(`-- [${rel}]
-`);
-            parts.push(fs.readFileSync(full, "utf8"));
-            parts.push("\n");
-          }
-        }
         const label = (p) => {
           try {
             return path.relative(this.root, p).replace(/\\/g, "/");
@@ -1387,6 +1455,11 @@ end)
           parts.push(DEFAULTS_RUNNER);
           parts.push("\n");
         }
+        if (opts.dev) {
+          parts.push(
+            '-- [dev: log config]\nif Pulse and Pulse.Log then\n    Pulse.Log.configure({ level = "debug", console = true })\n    Pulse.Log.info("dev", "dev build active")\nend\n\n'
+          );
+        }
         parts.push("-- [generated: destroy registration]\n");
         parts.push(DESTROY_REGISTRATION);
         parts.push("\n");
@@ -1797,25 +1870,20 @@ function makeClaudeMd(name) {
 function makeAgentsMd(name) {
   return read("AGENTS.md").replace(/{NAME}/g, name);
 }
-var DIR, TEMPLATE_GLOBALS, TEMPLATE_REMOTES, TEMPLATE_GITIGNORE, TEMPLATE_DEPLOY_EXAMPLE, MODULE_BOILERPLATE, MODULE_RBLUA_BOILERPLATE, REMOTE_BOILERPLATE, TEMPLATE_LAYOUT_TS, TEMPLATE_PAGE_HOME_TS, TEMPLATE_EX_SPEED_TS, TEMPLATE_EX_FOV_TS, TEMPLATE_EX_ESP_TS;
+var DIR, TEMPLATE_GLOBALS, TEMPLATE_REMOTES, MODULE_BOILERPLATE, REMOTE_BOILERPLATE, TEMPLATE_GITIGNORE, TEMPLATE_DEPLOY_EXAMPLE, TEMPLATE_LAYOUT_TS, TEMPLATE_PAGE_HOME_TS, TEMPLATE_COMPONENT_TS, TEMPLATE_EX_SPEED_TS, TEMPLATE_EX_FOV_TS, TEMPLATE_EX_ESP_TS;
 var init_templates = __esm({
   "src/templates.ts"() {
     init_cjs_shims();
     DIR = path.join(__dirname, "..", "templates");
     TEMPLATE_GLOBALS = read("globals.lua");
     TEMPLATE_REMOTES = read("remotes.lua");
-    TEMPLATE_GITIGNORE = read("gitignore");
-    read("layout.rblua");
-    read("page_home.rblua");
-    read("example_speed.rblua");
-    read("example_fov.rblua");
-    read("example_esp.rblua");
-    TEMPLATE_DEPLOY_EXAMPLE = read("deploy_config.example");
     MODULE_BOILERPLATE = read("module.lua");
-    MODULE_RBLUA_BOILERPLATE = read("module.rblua");
     REMOTE_BOILERPLATE = read("remote.lua");
+    TEMPLATE_GITIGNORE = read("gitignore");
+    TEMPLATE_DEPLOY_EXAMPLE = read("deploy_config.example");
     TEMPLATE_LAYOUT_TS = read("layout.ts");
     TEMPLATE_PAGE_HOME_TS = read("page_home.ts");
+    TEMPLATE_COMPONENT_TS = read("component.ts");
     TEMPLATE_EX_SPEED_TS = read("component_speed.ts");
     TEMPLATE_EX_FOV_TS = read("component_fov.ts");
     TEMPLATE_EX_ESP_TS = read("component_esp.ts");
@@ -2015,9 +2083,8 @@ function toCamel(name) {
 function cmdNew(args) {
   const root = requireProjectRoot();
   if (args.type === "module") {
-    const plain = args.plain ?? false;
     let relPath = args.path;
-    if (plain) {
+    if (args.plain) {
       if (!relPath.endsWith(".lua")) relPath += ".lua";
       const dest = pathe.join(root, "src", relPath);
       const camel = toCamel(relPath);
@@ -2033,23 +2100,23 @@ function cmdNew(args) {
       pOk(`src/${relPath}`);
       console.log();
       pKv("File", `src/${relPath}`);
-      pKv("Tip", "add to func for shared helpers; keep private state local");
+      pKv("Tip", "add helpers onto func; keep state local");
     } else {
-      if (!relPath.endsWith(".rblua")) relPath += ".rblua";
+      if (!relPath.endsWith(".ts")) relPath += ".ts";
       const dest = pathe.join(root, "src", relPath);
       const camel = toCamel(relPath);
+      const content = TEMPLATE_COMPONENT_TS.replace(/{Camel}/g, camel);
       if (fs.existsSync(dest)) {
         pFail(`src/${relPath} already exists`);
         process.exit(1);
       }
       fs.mkdirSync(pathe.join(dest, ".."), { recursive: true });
-      fs.writeFileSync(dest, MODULE_RBLUA_BOILERPLATE, "utf8");
+      fs.writeFileSync(dest, content, "utf8");
       pOk(`src/${relPath}`);
       console.log();
       pKv("Component", camel);
-      pKv("Enabled", `Components.${camel}.enabled(true)`);
-      pKv("Toggle", `Components.${camel}.Toggle()`);
-      pKv("Listen", `Components.${camel}.onEnable:connect(...)`);
+      pKv("Mount", `groupbox('left', '${camel}', { mount: '${camel}' })`);
+      pKv("Tip", "add to a page groupbox in src/pages/*.ts to render it");
     }
     console.log();
   } else if (args.type === "remote") {
@@ -2067,14 +2134,14 @@ function cmdNew(args) {
     pOk(`func.Remote_${remoteName}(...)  ${gray("\u2192 remotes.lua")}`);
     console.log();
   } else {
-    pFail(`Unknown type '${args.type}'`, "use: rb new module | rb new remote");
+    pFail(`Unknown type '${args.type}'`, "use: rb new module | rb new module --plain | rb new remote");
     process.exit(1);
   }
 }
 async function cmdRemove(args) {
   const root = requireProjectRoot();
   let relPath = args.path;
-  if (!relPath.endsWith(".lua") && !relPath.endsWith(".rblua")) relPath += ".lua";
+  if (!relPath.endsWith(".lua") && !relPath.endsWith(".ts")) relPath += ".ts";
   const target = pathe.join(root, "src", relPath);
   if (!fs.existsSync(target)) {
     pFail(`src/${relPath} not found`);
@@ -2931,19 +2998,12 @@ async function cmdPublish(_args) {
   const uploads = [
     { remote: `${VERSION_PATH}/bundle.lua`, content: bundleContent }
   ];
-  const pulseUiDir = pathe.join(PULSE_DIR2, "ui");
   for (const adapter of ["windui"]) {
     const p = pathe.join(ADAPTERS, `${adapter}.lua`);
     if (!fs.existsSync(p)) continue;
-    const parts = [fs.readFileSync(p, "utf8").trimEnd()];
-    const settings = pathe.join(pulseUiDir, `${adapter}_settings.lua`);
-    if (fs.existsSync(settings)) {
-      parts.push(`-- ${adapter}_settings`);
-      parts.push(fs.readFileSync(settings, "utf8").trimEnd());
-    }
     uploads.push({
       remote: `${VERSION_PATH}/adapters/${adapter}.lua`,
-      content: Buffer.from(parts.join("\n") + "\n", "utf8")
+      content: Buffer.from(fs.readFileSync(p, "utf8"), "utf8")
     });
   }
   pSection(`Uploading to R2  ${gray("(v" + RB_VERSION + " \xB7 " + uploads.length + " files)")}`);

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "pulse-rb",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "rb CLI — Pulse framework build tool for Roblox script projects",
   "bin": {
     "rb": "./bin/rb.js"
   },
   "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/index.ts",
+    "test": "vitest",
+    "prepublishOnly": "pnpm run build"
+  },
   "files": [
     "dist",
     "bin",
@@ -33,6 +39,8 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@rb-pulse/core": "workspace:*",
+    "@rbxts/types": "^1.0.924",
     "@types/fs-extra": "^11.0.4",
     "@types/luaparse": "^0.2.9",
     "@types/node": "^22.0.0",
@@ -51,10 +59,5 @@
     "pulse",
     "script"
   ],
-  "license": "MIT",
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsx src/index.ts",
-    "test": "vitest"
-  }
-}
+  "license": "MIT"
+}

package/pulse/runtime.lua

@@ -364,13 +364,16 @@ end
 local function _computed(fn) return Computed(fn) end
 
 local function _widgetBase(t)
-    function t:bind(sig)
-        self.signal = sig
-        self.id     = sig and (sig._id or "?") or nil
-        return self
+    -- TSTL compiles TypeScript `.bind(sig)` as Lua dot-call: `t.bind(sig)`.
+    -- Colon-style methods receive the wrong args (sig becomes self, actual sig is nil).
+    -- Close over t so the function works correctly regardless of call style.
+    t.bind = function(sig)
+        t.signal = sig
+        t.id     = sig and (sig._id or "?") or nil
+        return t
     end
-    function t:withTip(text) self.tip = text; return self end
-    function t:withDefault(v) self.default = v; return self end
+    t.withTip     = function(text) t.tip = text; return t end
+    t.withDefault = function(v)    t.default = v; return t end
     return t
 end
 
@@ -429,8 +432,17 @@ local function _hbBind(svc, optsOrFn, fn)
             local t=type(every)=="table" and every() or every
             local now=tick(); if (now-last)<t then return end; last=now
         end
+        -- Throttled trace: confirms heartbeat is running when condition passes.
+        if Pulse and Pulse.Log then
+            Pulse.Log.throttle(comp._name, 5, "debug", "tick (condition passed)")
+        end
         local ok,err=pcall(cb,a,b)
-        if not ok then warn("[Pulse] "..comp._name.." event error: "..tostring(err)) end
+        if not ok then
+            warn("[Pulse] "..comp._name.." event error: "..tostring(err))
+            if Pulse and Pulse.Log then
+                Pulse.Log.error(comp._name, "tick error: "..tostring(err))
+            end
+        end
     end))
 end
 
@@ -443,7 +455,15 @@ _on.inputEnded        = function(fn)  local c=_needComp("inputEnded");         c
 _on.characterAdded    = function(fn)  local c=_needComp("characterAdded");     c:bind("ca_".._uid(), _LocalPlayer.CharacterAdded:Connect(fn)) end
 _on.characterRemoving = function(fn)  local c=_needComp("characterRemoving");  c:bind("cr_".._uid(), _LocalPlayer.CharacterRemoving:Connect(fn)) end
 _on.respawn           = function(fn)  _needComp("respawn"):onRespawn(fn) end
-_on.signal            = function(sig,fn) _needComp("signal"):watch(sig,fn) end
+_on.signal            = function(sig,fn)
+    local comp = _needComp("signal")
+    comp:watch(sig, function(v)
+        if Pulse and Pulse.Log then
+            Pulse.Log.debug(comp._name, "signal "..tostring(sig._id or "?").." → "..tostring(v))
+        end
+        fn(v)
+    end)
+end
 _on.after             = function(s,fn)   _needComp("after"):task(s,fn) end
 
 local function _defineComponent(name, setup)

package/templates/component.ts

@@ -0,0 +1,11 @@
+defineComponent('{Camel}', (): WidgetDef[] => {
+  const enabled = signal<boolean>(false)
+
+  on.heartbeat({ when: enabled }, (): void => {
+    // add your per-frame logic here
+  })
+
+  return [
+    toggle('{Camel}').bind(enabled),
+  ]
+})

package/templates/globals.lua

@@ -1,34 +1,26 @@
 -- ── Script Config ─────────────────────────────────────────────────────────────
--- Edit these values. SCRIPT_NAME is used as the UI window title and notify_title.
+-- Edit these values. SCRIPT_NAME is used as the UI window title.
 
 local SCRIPT_NAME    = "{NAME}"
 local SCRIPT_VERSION = "1.0.0"
 local SCRIPT_AUTHOR  = "you"
-local SCRIPT_DISCORD = ""   -- optional: discord invite link (shown in UI if set)
+local SCRIPT_DISCORD = ""   -- optional: discord invite link
 
 -- ── Shared helpers ─────────────────────────────────────────────────────────────
--- Add your game-specific helpers here. Generic helpers (Pulse.*) are injected
--- automatically by the compiler — no need to define them here.
+-- Add game-specific shared helpers here. Pulse runtime helpers (_PulseGet*)
+-- and all TypeScript component globals are injected automatically.
 
 local func = {}
 
 -- ── Players ────────────────────────────────────────────────────────────────────
--- Event-driven cache: updates instantly when players join or leave.
+-- Event-driven player cache — stays up to date as players join/leave.
 local _playerSet = {}
 local _PS = game:GetService("Players")
 local _LP = _PS.LocalPlayer
 
 for _, p in ipairs(_PS:GetPlayers()) do _playerSet[p] = true end
-_PS.PlayerAdded:Connect(function(p)
-    _playerSet[p] = true
-    local n = 0; for _ in pairs(_playerSet) do n = n + 1 end
-    Pulse.Monitor.set("players", n)
-end)
-_PS.PlayerRemoving:Connect(function(p)
-    _playerSet[p] = nil
-    local n = 0; for _ in pairs(_playerSet) do n = n + 1 end
-    Pulse.Monitor.set("players", n)
-end)
+_PS.PlayerAdded:Connect(function(p)   _playerSet[p] = true end)
+_PS.PlayerRemoving:Connect(function(p) _playerSet[p] = nil  end)
 
 func.GetCachedPlayers = function()
     local t = {}
@@ -36,24 +28,16 @@ func.GetCachedPlayers = function()
     return t
 end
 
--- ── Team monitor ──────────────────────────────────────────────────────────────
--- Tracks the local player's team in the dev overlay.
-Pulse.Monitor.set("team", _LP.Team and _LP.Team.Name or "none")
-_LP:GetPropertyChangedSignal("Team"):Connect(function()
-    Pulse.Monitor.set("team", _LP.Team and _LP.Team.Name or "none")
-end)
-
 -- ── Entity folder watcher ──────────────────────────────────────────────────────
--- Use _watchFolder to keep a set live as entities spawn/despawn.
--- Add your game-specific entity caches below.
+-- Use _watchFolder to keep a set live as instances spawn/despawn.
+-- Uncomment and adapt to your game's folder structure.
 local function _watchFolder(folder, set)
     for _, child in ipairs(folder:GetChildren()) do set[child] = true end
     folder.ChildAdded:Connect(function(c)   set[c] = true end)
     folder.ChildRemoved:Connect(function(c) set[c] = nil  end)
 end
 
--- Example — uncomment and adapt to your game's entity folder:
---
+-- Example:
 -- local _enemySet = {}
 -- task.spawn(function()
 --     local folder = workspace:WaitForChild("Enemies", 30)

package/templates/layout.ts

@@ -1,13 +1,12 @@
 // Pulse layout — configures the script window.
 // Based on Next.js root layout convention.
-// uiLibrary: 'windui' | 'linoria'
 
 export default {
   title:               '{NAME}',
   author:              '',
   toggleKey:           'RightControl',
   size:                [850, 560] as [number, number],
-  uiLibrary:           'windui' as 'windui' | 'linoria',
+  uiLibrary:           'windui' as const,
   theme:               'Indigo',
   icon:                'code-2',
   folder:              '{NAME}',

package/templates/page_home.ts

@@ -1,8 +1,5 @@
-// Home page tab — Next.js-style file-based routing.
-// Filename prefix (1_) determines tab order.
-
 definePage('Home', { icon: 'house' }, () => [
-  groupbox('left',  'Player',  { icon: 'person',    mount: 'SpeedHack'  }),
-  groupbox('left',  'Player',  { icon: 'person',    mount: 'FOVChanger' }),
-  groupbox('right', 'Visuals', { icon: 'eye',       mount: 'PlayerESP'  }),
+  groupbox('left',  'Player',  { icon: 'person', mount: 'SpeedHack'  }),
+  groupbox('left',  'Player',  { icon: 'person', mount: 'FOVChanger' }),
+  groupbox('right', 'Visuals', { icon: 'eye',    mount: 'PlayerESP'  }),
 ])

package/templates/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "target": "ESNext",
+    "moduleResolution": "bundler",
+    "types": ["@rb-pulse/core"]
+  },
+  "include": ["*.ts"]
+}