pulse-rb 1.2.24

package/adapters/windui.lua

@@ -0,0 +1,505 @@
+-- [adapters/windui.lua]
+-- Wind UI adapter for Pulse components.
+-- Injected by the compiler when ui_library = "windui" in layout.rblua.
+-- Provides _UIAdapter, _PulseNotify, and Pulse.UI (dynamic element builder).
+--
+-- Activation: set ui_library = "windui" in src/ui/layout.rblua
+-- Docs:       footagesus.github.io/treehub-web/docs/windui
+-- Version:    1.6.64-fix (pinned)
+
+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"
+
+local _ok, _src = pcall(game.HttpGet, game, _WINDUI_URL)
+if not _ok then error("[Pulse/WindUI] HTTP failed: " .. tostring(_src)) end
+if type(_src) ~= "string" or #_src < 100 then
+    error("[Pulse/WindUI] Empty response from WindUI CDN")
+end
+local _loadFn, _loadErr = loadstring(_src)
+if not _loadFn then error("[Pulse/WindUI] Compile error: " .. tostring(_loadErr)) end
+local _ok2, WindUI = pcall(_loadFn)
+if not _ok2 then error("[Pulse/WindUI] Init failed: " .. tostring(WindUI)) end
+
+-- ── Shared state ──────────────────────────────────────────────────────────────
+
+local _UIS             = game:GetService("UserInputService")
+local _widgets         = {}     -- [id] → wind element, for programmatic signal sync
+local _mountedGbs      = {}     -- [component table ref] → groupbox proxy
+local _windWindow      = nil    -- set in CreateWindow
+local _windConfig      = nil    -- set in CreateWindow (ConfigManager handle)
+local _folder          = "Hub"  -- overwritten in CreateWindow from layout opts
+local _notifyTitle     = "Hub"  -- overwritten in CreateWindow from layout opts
+local _toggleKeyName   = "RightControl"
+local _windowVisible   = true
+
+local _isMobile = _UIS.TouchEnabled and not _UIS.KeyboardEnabled
+
+-- ── Adapter ───────────────────────────────────────────────────────────────────
+
+local _UIAdapter = {}
+
+function _UIAdapter:RegisterTheme(t)
+    pcall(function()
+        WindUI:AddTheme({
+            Name        = t.name,
+            Accent      = Color3.fromHex(t.accent      or "#ffffff"),
+            Background  = Color3.fromHex(t.background  or "#1a1a2e"),
+            Outline     = Color3.fromHex(t.outline     or "#2a2a3e"),
+            Text        = Color3.fromHex(t.text        or "#ffffff"),
+            Placeholder = Color3.fromHex(t.placeholder or "#888888"),
+            Button      = Color3.fromHex(t.button      or "#2a2a3e"),
+            Icon        = Color3.fromHex(t.icon        or "#ffffff"),
+        })
+    end)
+end
+
+function _UIAdapter:GetThemeNames()
+    local names = {}
+    pcall(function()
+        for name, _ in pairs(WindUI:GetThemes()) do
+            table.insert(names, name)
+        end
+        table.sort(names)
+    end)
+    return next(names) ~= nil and names or nil
+end
+
+-- ── Helpers ───────────────────────────────────────────────────────────────────
+
+local function _getViewportWidth()
+    local ok, vp = pcall(function() return workspace.CurrentCamera.ViewportSize.X end)
+    return (ok and type(vp) == "number") and vp or 1920
+end
+
+local function _mkColumns(windTab)
+    local leftCol, rightCol
+    local vw = _getViewportWidth()
+
+    if not _isMobile and vw >= 960 then
+        pcall(function()
+            local hs = windTab:HStack({ AutoSpace = true })
+            local lv = hs:VStack({})
+            local rv = hs:VStack({})
+            if lv and rv then
+                leftCol  = lv
+                rightCol = rv
+            end
+        end)
+    else
+        pcall(function()
+            local col = windTab:VStack({})
+            if col then
+                leftCol  = col
+                rightCol = col
+            end
+        end)
+    end
+
+    leftCol  = leftCol  or windTab
+    rightCol = rightCol or windTab
+    return leftCol, rightCol
+end
+
+-- ── Window proxy ──────────────────────────────────────────────────────────────
+
+function _UIAdapter:CreateWindow(title, w, h, opts)
+    opts         = opts or {}
+    _folder      = opts.folder       or _folder
+    _notifyTitle = opts.notify_title or _notifyTitle
+
+    local icon              = (opts.icon and opts.icon ~= "") and opts.icon or _PULSE_LOGO
+    local author            = (opts.author and opts.author ~= "") and opts.author or nil
+    local transparency      = opts.transparency or 0
+    local acrylic           = opts.acrylic == true
+    local openBtnMobileOnly = opts.open_btn_mobile_only ~= false
+    local openBtnIcon       = (opts.open_btn_icon and opts.open_btn_icon ~= "") and opts.open_btn_icon or nil
+
+    _windWindow = WindUI:CreateWindow({
+        Title                       = title,
+        Icon                        = icon,
+        Author                      = author,
+        Folder                      = _folder,
+        Theme                       = opts.theme or "Dark",
+        Resizable                   = true,
+        Size                        = UDim2.fromOffset(w or 950, h or 600),
+        Transparent                 = acrylic or (transparency > 0),
+        BackgroundImageTransparency = acrylic and 0 or transparency,
+        Acrylic                     = acrylic,
+
+        OpenButton = {
+            Enabled         = true,
+            Draggable       = true,
+            OnlyMobile      = openBtnMobileOnly,
+            Icon            = openBtnIcon,
+            Scale           = 0.5,
+            CornerRadius    = UDim.new(1, 0),
+            StrokeThickness = 3,
+        },
+    })
+
+    pcall(function()
+        _windConfig = _windWindow.ConfigManager:Config(_folder)
+    end)
+
+    _UIAdapter.Window = _windWindow
+    _UIAdapter.Config = _windConfig
+
+    local winProxy = { _wind = _windWindow }
+
+    function winProxy:AddTab(name, icon)
+        local windTab = _windWindow:Tab({
+            Title = name,
+            Icon  = (icon and icon ~= "") and icon or nil,
+        })
+        if not _UIAdapter._firstTab then
+            _UIAdapter._firstTab = windTab
+        end
+
+        local leftCol, rightCol = _mkColumns(windTab)
+
+        local function _mkSection(col, gbTitle, gbIcon)
+            local sect = col:Section({
+                Title     = gbTitle,
+                Icon      = (gbIcon and gbIcon ~= "") and gbIcon or nil,
+                Box       = true,
+                BoxBorder = true,
+                Opened    = true,
+            })
+            return { _container = sect }
+        end
+
+        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
+        return tabProxy
+    end
+
+    return winProxy
+end
+
+function _UIAdapter:ToggleWindow()
+    if not _windWindow then return end
+    if _windowVisible then
+        pcall(_PulseNotify, "Press " .. _toggleKeyName .. " to open", 4)
+    end
+    pcall(function() _windWindow:Toggle() end)
+    _windowVisible = not _windowVisible
+end
+
+function _UIAdapter:SetToggleKey(keyCode)
+    if keyCode then
+        pcall(function() _toggleKeyName = keyCode.Name end)
+    end
+end
+
+function _UIAdapter:SetTheme(name)
+    pcall(function() WindUI:SetTheme(name) end)
+end
+
+-- ── Widget helpers ────────────────────────────────────────────────────────────
+
+function _UIAdapter:addToggle(gb, id, opts)
+    local elem = gb._container:Toggle({
+        Title    = opts.label,
+        Desc     = opts.tip or nil,
+        Value    = opts.signal(),
+        Flag     = id,
+        Callback = function(v) opts.signal(v) end,
+    })
+    _widgets[id] = elem
+    _G.Toggles = _G.Toggles or {}
+    _G.Toggles[id] = { Value = opts.signal(), SetValue = function(_, v) opts.signal(v) end }
+    opts.signal:onChange(function(v)
+        local w = _widgets[id]
+        if w then pcall(function() w:Set(v) end) end
+        if _G.Toggles and _G.Toggles[id] then _G.Toggles[id].Value = v end
+    end)
+end
+
+function _UIAdapter:addSlider(gb, id, opts)
+    local min = opts.min or 0
+    local max = opts.max or 100
+    local def = opts.signal()
+    local step
+    if opts.rounding and opts.rounding > 0 then
+        step = 1 / (10 ^ opts.rounding)
+    else
+        local isFloat = (min % 1 ~= 0) or (max % 1 ~= 0)
+                     or (type(def) == "number" and def % 1 ~= 0)
+        step = isFloat and 0.01 or 1
+    end
+    local elem = gb._container:Slider({
+        Title    = opts.label,
+        Desc     = opts.tip or nil,
+        Step     = step,
+        Value    = { Min = min, Max = max, Default = def },
+        Flag     = id,
+        Callback = function(v) opts.signal(v) end,
+    })
+    _widgets[id] = elem
+    _G.Options = _G.Options or {}
+    _G.Options[id] = { Value = opts.signal(), SetValue = function(_, v) opts.signal(v) end }
+    opts.signal:onChange(function(v)
+        local w = _widgets[id]
+        if w then pcall(function() w:Set(v) end) end
+        if _G.Options and _G.Options[id] then _G.Options[id].Value = v end
+    end)
+end
+
+function _UIAdapter:addDropdown(gb, id, opts)
+    local elem = gb._container:Dropdown({
+        Title    = opts.label,
+        Desc     = opts.tip or nil,
+        Values   = opts.options,
+        Value    = opts.signal(),
+        Flag     = id,
+        Callback = function(v) opts.signal(v) end,
+    })
+    _widgets[id] = elem
+    _G.Options = _G.Options or {}
+    _G.Options[id] = { Value = opts.signal(), SetValue = function(_, v) opts.signal(v) end }
+    opts.signal:onChange(function(v)
+        local w = _widgets[id]
+        if w then pcall(function() w:Select(v) end) end
+        if _G.Options and _G.Options[id] then _G.Options[id].Value = v end
+    end)
+end
+
+function _UIAdapter:addMultiDropdown(gb, id, opts)
+    local current = opts.signal()
+    local elem = gb._container:Dropdown({
+        Title     = opts.label,
+        Desc      = opts.tip or nil,
+        Values    = opts.options,
+        Value     = (type(current) == "table" and next(current) ~= nil) and current or nil,
+        Multi     = true,
+        AllowNone = true,
+        Flag      = id,
+        Callback  = function(v) opts.signal(v) end,
+    })
+    _widgets[id] = elem
+    opts.signal:onChange(function(v)
+        local w = _widgets[id]
+        if w then pcall(function() w:Select(v) end) end
+    end)
+end
+
+function _UIAdapter:addButton(gb, opts)
+    gb._container:Button({
+        Title    = opts.label,
+        Desc     = opts.tip or nil,
+        Callback = opts.action,
+    })
+end
+
+function _UIAdapter:addKeybind(gb, id, opts)
+    local elem = gb._container:Keybind({
+        Title    = opts.label,
+        Value    = opts.key,
+        Flag     = id,
+        Callback = function(_v)
+            if _UIS:GetFocusedTextBox() then return end
+            opts.action()
+        end,
+    })
+    _widgets[id] = elem
+end
+
+function _UIAdapter:addLabel(gb, text)
+    if text == "" or text:match("^%s*$") then
+        gb._container:Space({ Columns = 1 })
+    else
+        gb._container:Paragraph({ Title = text, Desc = "" })
+    end
+end
+
+function _UIAdapter:addParagraph(gb, title, desc)
+    gb._container:Paragraph({ Title = title or "", Desc = desc or "" })
+end
+
+function _UIAdapter:addSeparator(gb)
+    gb._container:Divider()
+end
+
+-- ── Notify ────────────────────────────────────────────────────────────────────
+
+_PulseNotify = function(msg, duration)
+    pcall(function()
+        WindUI:Notify({
+            Title    = _notifyTitle,
+            Content  = msg,
+            Duration = duration or 5,
+        })
+    end)
+end
+
+-- ── Destroy ───────────────────────────────────────────────────────────────────
+
+_PulseOnDestroy(function()
+    pcall(function()
+        if _windWindow then _windWindow:Destroy() end
+    end)
+end)
+
+-- ── Mount ─────────────────────────────────────────────────────────────────────
+
+function _UIAdapter:mount(component, gb)
+    if not component then return end
+    -- Store groupbox so Pulse.UI.gb(component) works in after {} blocks
+    _mountedGbs[component] = gb
+    local ui = component._ui
+    if not ui then return end
+    for _, w in ipairs(ui) do
+        local t   = w.type
+        local sig = component[w.signal]
+        if t == "toggle" then
+            self:addToggle(gb, w.id, { label = w.label, signal = sig, tip = w.tip })
+        elseif t == "slider" then
+            self:addSlider(gb, w.id, { label = w.label, signal = sig,
+                                       min = w.min, max = w.max, tip = w.tip,
+                                       rounding = w.rounding })
+        elseif t == "dropdown" then
+            self:addDropdown(gb, w.id, { label = w.label, signal = sig,
+                                          options = w.options, tip = w.tip })
+        elseif t == "multidropdown" then
+            self:addMultiDropdown(gb, w.id, { label = w.label, signal = sig,
+                                               options = w.options, tip = w.tip })
+        elseif t == "button" then
+            self:addButton(gb, { label = w.label, action = w.action, tip = w.tip })
+        elseif t == "keybind" then
+            self:addKeybind(gb, w.id, { label = w.label, key = w.key, action = w.action })
+        elseif t == "label" then
+            self:addLabel(gb, w.label)
+        elseif t == "paragraph" then
+            self:addParagraph(gb, w.title, w.desc)
+        elseif t == "separator" then
+            self:addSeparator(gb)
+        end
+    end
+end
+
+-- ── Pulse.UI — imperative dynamic UI builder ──────────────────────────────────
+-- Use in after {} blocks (runs after mount, so groupbox is available).
+-- All functions return a handle with :set / :setTitle / :setDesc / :refresh /
+-- :destroy methods. All mutations are nil-safe (pcall-wrapped).
+--
+-- Quick reference:
+--   local gb  = Pulse.UI.gb(MyComponent)
+--   local par = Pulse.UI.paragraph(gb, "Title", "desc")    par:setDesc("new")
+--   local btn = Pulse.UI.button(gb, "Label", "desc", fn)
+--   local tog = Pulse.UI.toggle(gb, "id", "Label", "desc", false, fn)
+--   local sli = Pulse.UI.slider(gb, "id", "Label", 0, 100, 50, fn)
+--   local drp = Pulse.UI.dropdown(gb, "id", "Label", {"A"}, nil, false, fn)
+--               drp:refresh({"A","B"})  drp:set("B")
+--   local sec = Pulse.UI.section(gb, "Title", "icon-name")
+--               sec:paragraph(...)  sec:button(...)  etc.
+
+Pulse.UI = {}
+
+function Pulse.UI.gb(component)
+    return _mountedGbs[component]
+end
+
+function Pulse.UI.paragraph(container, title, desc)
+    local elem
+    pcall(function()
+        elem = container._container:Paragraph({ Title = title or "", Desc = desc or "" })
+    end)
+    local h = {}
+    function h:set(t, d)
+        pcall(function()
+            if t ~= nil then elem:SetTitle(t) end
+            if d ~= nil then elem:SetDesc(d) end
+        end)
+    end
+    function h:setTitle(v) pcall(function() elem:SetTitle(v) end) end
+    function h:setDesc(v)  pcall(function() elem:SetDesc(v) end) end
+    function h:destroy()   pcall(function() elem:Destroy() end) end
+    return h
+end
+
+function Pulse.UI.button(container, label, desc, fn)
+    local elem
+    pcall(function()
+        elem = container._container:Button({ Title = label, Desc = desc, Callback = fn })
+    end)
+    local h = {}
+    function h:setTitle(v) pcall(function() elem:SetTitle(v) end) end
+    function h:setDesc(v)  pcall(function() elem:SetDesc(v) end) end
+    function h:destroy()   pcall(function() elem:Destroy() end) end
+    return h
+end
+
+function Pulse.UI.toggle(container, id, label, desc, default, fn)
+    local elem
+    pcall(function()
+        elem = container._container:Toggle({
+            Title = label, Desc = desc, Value = default or false,
+            Flag = id, Callback = fn,
+        })
+    end)
+    local h = {}
+    function h:set(v)      pcall(function() elem:Set(v) end) end
+    function h:setDesc(v)  pcall(function() elem:SetDesc(v) end) end
+    function h:destroy()   pcall(function() elem:Destroy() end) end
+    return h
+end
+
+function Pulse.UI.slider(container, id, label, min, max, default, fn)
+    local elem
+    pcall(function()
+        local mn, mx = min or 0, max or 100
+        elem = container._container:Slider({
+            Title = label, Step = 1,
+            Value = { Min = mn, Max = mx, Default = default or mn },
+            Flag = id, Callback = fn,
+        })
+    end)
+    local h = {}
+    function h:set(v)      pcall(function() elem:Set(v) end) end
+    function h:setDesc(v)  pcall(function() elem:SetDesc(v) end) end
+    function h:destroy()   pcall(function() elem:Destroy() end) end
+    return h
+end
+
+function Pulse.UI.dropdown(container, id, label, values, default, multi, fn)
+    local elem
+    pcall(function()
+        elem = container._container:Dropdown({
+            Title = label, Values = values or {}, Value = default,
+            Multi = multi or false, AllowNone = multi or false,
+            Flag = id, Callback = fn,
+        })
+    end)
+    local h = {}
+    function h:set(v)      pcall(function() elem:Select(v) end) end
+    function h:refresh(vs) pcall(function() elem:Refresh(vs) end) end
+    function h:setDesc(v)  pcall(function() elem:SetDesc(v) end) end
+    function h:destroy()   pcall(function() elem:Destroy() end) end
+    return h
+end
+
+function Pulse.UI.divider(container)
+    pcall(function() container._container:Divider() end)
+end
+
+-- Creates a nested section inside a groupbox. Returns a proxy with the same
+-- methods as a groupbox so you can chain: sec:paragraph(), sec:button(), etc.
+function Pulse.UI.section(container, title, icon, opened)
+    local sect
+    pcall(function()
+        sect = container._container:Section({
+            Title = title or "", Icon = (icon and icon ~= "") and icon or nil,
+            Box = true, BoxBorder = true, Opened = opened ~= false,
+        })
+    end)
+    local proxy = { _container = sect }
+    function proxy:paragraph(...) return Pulse.UI.paragraph(self, ...) end
+    function proxy:button(...)    return Pulse.UI.button(self, ...) end
+    function proxy:toggle(...)    return Pulse.UI.toggle(self, ...) end
+    function proxy:slider(...)    return Pulse.UI.slider(self, ...) end
+    function proxy:dropdown(...)  return Pulse.UI.dropdown(self, ...) end
+    function proxy:divider()      Pulse.UI.divider(self) end
+    function proxy:section(...)   return Pulse.UI.section(self, ...) end
+    return proxy
+end

package/bin/rb.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/index.js')