pulse-rb 1.4.3 → 1.4.4

package/adapters/windui.lua

@@ -59,6 +59,7 @@ local _toggleKeyName   = "RightControl"
 local _windowVisible   = true
 
 local _isMobile = _UIS.TouchEnabled and not _UIS.KeyboardEnabled
+local _PULSE_PREMIUM = false  -- set true during key validation if key grants premium
 
 -- ── Adapter ───────────────────────────────────────────────────────────────────
 
@@ -140,7 +141,7 @@ function _UIAdapter:CreateWindow(title, w, h, opts)
     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({
+    local _winCfg = {
         Title                       = title,
         Icon                        = icon,
         Author                      = author,
@@ -151,7 +152,6 @@ function _UIAdapter:CreateWindow(title, w, h, opts)
         Transparent                 = acrylic or (transparency > 0),
         BackgroundImageTransparency = acrylic and 0 or transparency,
         Acrylic                     = acrylic,
-
         OpenButton = {
             Enabled         = true,
             Draggable       = true,
@@ -161,7 +161,62 @@ function _UIAdapter:CreateWindow(title, w, h, opts)
             CornerRadius    = UDim.new(1, 0),
             StrokeThickness = 3,
         },
-    })
+    }
+
+    -- Key system — configured via layout.keySystem
+    local _ks = _PULSE_LAYOUT.keySystem
+    if _ks then
+        local function _checkPremium(key)
+            local _pr = _PULSE_LAYOUT.premium
+            if not _pr then return end
+            if _pr.keys then
+                for _, k in ipairs(_pr.keys) do
+                    if k == key then _PULSE_PREMIUM = true; return end
+                end
+            end
+            if _pr.validatorUrl and _pr.validatorUrl ~= "" then
+                local ok, resp = pcall(function() return game:HttpGet(_pr.validatorUrl .. key) end)
+                if ok and resp and resp:lower():match("^true") then _PULSE_PREMIUM = true end
+            end
+        end
+        local _ksCfg = {
+            Title    = _ks.title or "Key Required",
+            Note     = (_ks.note and _ks.note ~= "") and _ks.note or nil,
+            SaveKey  = _ks.saveKey == true,
+            URL      = (_ks.getKeyUrl and _ks.getKeyUrl ~= "") and _ks.getKeyUrl or nil,
+            KeyValidator = function(key)
+                local passed = false
+                -- Check against static keys list
+                if _ks.keys then
+                    for _, k in ipairs(_ks.keys) do
+                        if k == key then passed = true; break end
+                    end
+                end
+                -- HTTP validation (server-side) when no static list or key not found
+                if not passed and _ks.validatorUrl and _ks.validatorUrl ~= "" then
+                    local ok, resp = pcall(function() return game:HttpGet(_ks.validatorUrl .. key) end)
+                    if ok and resp and resp:lower():match("^true") then passed = true end
+                end
+                -- No validation configured → any non-empty key passes (dev mode)
+                if not passed and (not _ks.keys or #_ks.keys == 0)
+                   and (not _ks.validatorUrl or _ks.validatorUrl == "") then
+                    passed = key ~= nil and key ~= ""
+                end
+                _checkPremium(key)
+                return passed or _PULSE_PREMIUM  -- premium key also grants basic access
+            end,
+        }
+        if _ks.thumbnail then
+            _ksCfg.Thumbnail = {
+                Image = _ks.thumbnail.image or "",
+                Title = _ks.thumbnail.title or "",
+                Width = _ks.thumbnail.width or 100,
+            }
+        end
+        _winCfg.KeySystem = _ksCfg
+    end
+
+    _windWindow = WindUI:CreateWindow(_winCfg)
 
     pcall(function()
         _windConfig = _windWindow.ConfigManager:Config(_folder)
@@ -552,6 +607,28 @@ task.spawn(function()
 
     local L = _PULSE_LAYOUT
 
+    -- Premium dynamic unlock system
+    -- Each entry is a function that destroys the locked UI and mounts the real component.
+    local _premiumPendingUnlocks = {}
+    local _premiumStatusPara     = nil
+
+    local function _activatePremium()
+        _PULSE_PREMIUM = true
+        -- Update settings status paragraph if it exists
+        pcall(function()
+            if _premiumStatusPara then
+                _premiumStatusPara:SetTitle("Premium Active")
+                _premiumStatusPara:SetDesc("All premium features are now unlocked.")
+            end
+        end)
+        -- Swap locked UI → real components for every registered premium groupbox
+        for _, fn in ipairs(_premiumPendingUnlocks) do
+            task.spawn(function() pcall(fn) end)
+        end
+        _premiumPendingUnlocks = {}
+        pcall(function() _PulseNotify("Premium unlocked!", 3) end)
+    end
+
     -- 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]
@@ -778,7 +855,107 @@ task.spawn(function()
             end
             if gb.mount then
                 local comp = _BundleComponents[gb.mount]
-                if comp then
+                -- Premium gate: show inline key-entry UI; dynamically replaced on unlock
+                if gb.premium and not _PULSE_PREMIUM then
+                    local _mountComp = comp
+                    local _mountCont = container
+                    local _destroyFns = {}
+
+                    pcall(function()
+                        local _keyValue = ""
+                        local _statusPara
+
+                        local function _setStatus(msg)
+                            pcall(function() if _statusPara then _statusPara:SetDesc(msg) end end)
+                        end
+
+                        -- Header
+                        local _header = _mountCont._container:Paragraph({
+                            Title = "Premium Feature",
+                            Desc  = "Enter your key below to unlock this feature.",
+                        })
+                        table.insert(_destroyFns, function() pcall(function() _header:Destroy() end) end)
+
+                        -- Key input (wrapped in pcall — Input may not exist on all Section types)
+                        local _inputElem
+                        pcall(function()
+                            _inputElem = _mountCont._container:Input({
+                                Title       = "Premium Key",
+                                Placeholder = "Paste your key here…",
+                                Flag        = (gb.mount or "prem") .. "_premKey",
+                                Callback    = function(v) _keyValue = v end,
+                            })
+                            table.insert(_destroyFns, function() pcall(function() _inputElem:Destroy() end) end)
+                        end)
+
+                        -- Validate + unlock
+                        local function _doCheck()
+                            local key = (_keyValue or ""):match("^%s*(.-)%s*$")
+                            if key == "" then _setStatus("Enter a key first."); return end
+                            local valid = false
+                            local _pr = _PULSE_LAYOUT.premium
+                            if _pr then
+                                if _pr.keys then
+                                    for _, k in ipairs(_pr.keys) do
+                                        if k == key then valid = true; break end
+                                    end
+                                end
+                                if not valid and _pr.validatorUrl and _pr.validatorUrl ~= "" then
+                                    _setStatus("Checking…")
+                                    local ok, resp = pcall(function()
+                                        return game:HttpGet(_pr.validatorUrl .. key)
+                                    end)
+                                    if ok and resp and resp:lower():match("^true") then valid = true end
+                                end
+                            end
+                            if valid then
+                                _setStatus("Valid! Unlocking…")
+                                task.delay(0.4, _activatePremium)
+                            else
+                                _setStatus("Invalid key.")
+                            end
+                        end
+
+                        -- "Copy Link" button
+                        local _pKeyUrl = (_PULSE_LAYOUT.premium and _PULSE_LAYOUT.premium.getKeyUrl)
+                                      or (_PULSE_LAYOUT.keySystem and _PULSE_LAYOUT.keySystem.getKeyUrl) or ""
+                        local _copyBtn = _mountCont._container:Button({
+                            Title    = "Copy Link",
+                            Desc     = "Get your premium key",
+                            Callback = function()
+                                if _pKeyUrl == "" then _setStatus("No link configured."); return end
+                                local ok = false
+                                pcall(function() setclipboard(_pKeyUrl); ok = true end)
+                                pcall(function() if not ok then toclipboard(_pKeyUrl); ok = true end end)
+                                _setStatus(ok and "Link copied!" or "No clipboard API.")
+                            end,
+                        })
+                        table.insert(_destroyFns, function() pcall(function() _copyBtn:Destroy() end) end)
+
+                        -- "Check Key" button
+                        local _checkBtn = _mountCont._container:Button({
+                            Title    = "Check Key",
+                            Callback = _doCheck,
+                        })
+                        table.insert(_destroyFns, function() pcall(function() _checkBtn:Destroy() end) end)
+
+                        -- Status line
+                        _statusPara = _mountCont._container:Paragraph({
+                            Title = "Status",
+                            Desc  = "—",
+                        })
+                        table.insert(_destroyFns, function() pcall(function() _statusPara:Destroy() end) end)
+                    end)
+
+                    -- Register: when premium activates, destroy locked UI and mount real component
+                    table.insert(_premiumPendingUnlocks, function()
+                        for _, fn in ipairs(_destroyFns) do fn() end
+                        task.wait(0.05)
+                        if _mountComp then
+                            pcall(function() _UIAdapter:mount(_mountComp, _mountCont) end)
+                        end
+                    end)
+                elseif comp then
                     local ok, err = pcall(function() _UIAdapter:mount(comp, container) end)
                     if not ok then
                         warn("[Pulse] mount '" .. gb.mount .. "' error: " .. tostring(err))
@@ -852,6 +1029,43 @@ task.spawn(function()
         end,
     })
 
+    -- Premium status groupbox — shown only when premium tier is configured
+    if _PULSE_LAYOUT.premium then
+        local gb_prem = _settingsTab:AddRightGroupbox("Premium")
+        if _PULSE_PREMIUM then
+            pcall(function()
+                gb_prem._container:Paragraph({
+                    Title = "Premium Active",
+                    Desc  = "All premium features are unlocked.",
+                })
+            end)
+        else
+            pcall(function()
+                -- Store reference so _activatePremium can update it live
+                _premiumStatusPara = gb_prem._container:Paragraph({
+                    Title = "Premium Locked",
+                    Desc  = "Enter a key in any locked feature to unlock.",
+                })
+            end)
+            local _pKeyUrl = (_PULSE_LAYOUT.premium and _PULSE_LAYOUT.premium.getKeyUrl)
+                          or (_PULSE_LAYOUT.keySystem and _PULSE_LAYOUT.keySystem.getKeyUrl)
+            if _pKeyUrl and _pKeyUrl ~= "" then
+                pcall(function()
+                    gb_prem._container:Button({
+                        Title    = "Get Premium Key",
+                        Desc     = "Copy the link to your key page",
+                        Callback = function()
+                            local ok = false
+                            pcall(function() setclipboard(_pKeyUrl); ok = true end)
+                            pcall(function() if not ok then toclipboard(_pKeyUrl); ok = true end end)
+                            _PulseNotify(ok and "Link copied!" or _pKeyUrl, 4)
+                        end,
+                    })
+                end)
+            end
+        end
+    end
+
     -- Menu settings groupbox
     local gb_menu = _settingsTab:AddRightGroupbox("Menu Settings")
     _UIAdapter:addButton(gb_menu, {

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.4.3";
+    RB_VERSION = "1.4.4";
     RB_HOME = path.join(os.homedir(), ".rb");
     path.join(RB_HOME, "bin");
     IRONBREW2_DIR = path.join(RB_HOME, "ironbrew2");
@@ -1156,6 +1156,52 @@ _G.__AOT_R_DESTROY = _PulseDestroy
         }
         return "windui";
       }
+      // Extract content between matching braces for a named TS field.
+      // Returns null if field is absent or commented out.
+      extractLayoutBlock(src, field) {
+        const rx = new RegExp(`\\b${field}\\s*:\\s*\\{`);
+        const m = src.match(rx);
+        if (!m || m.index === void 0) return null;
+        const before = src.slice(0, m.index);
+        const lineStart = before.lastIndexOf("\n") + 1;
+        if (before.slice(lineStart).trimStart().startsWith("//")) return null;
+        let depth = 0, i = m.index + m[0].length - 1;
+        const start = i + 1;
+        for (; i < src.length; i++) {
+          if (src[i] === "{") depth++;
+          else if (src[i] === "}") {
+            depth--;
+            if (depth === 0) break;
+          }
+        }
+        return src.slice(start, i);
+      }
+      // Convert an extracted TS block body to a Lua table literal string.
+      blockToLuaTable(block) {
+        const str = (k) => block.match(new RegExp(`\\b${k}\\s*:\\s*['"]([^'"]+)['"]`))?.at(1) ?? null;
+        const bool = (k) => {
+          const m = block.match(new RegExp(`\\b${k}\\s*:\\s*(true|false)\\b`));
+          return m ? m[1] === "true" : null;
+        };
+        const arr = (k) => {
+          const m = block.match(new RegExp(`\\b${k}\\s*:\\s*\\[([^\\]]*)\\]`));
+          return m ? [...m[1].matchAll(/['"]([^'"]+)['"]/g)].map((x) => x[1]) : null;
+        };
+        const parts = [];
+        const title = str("title");
+        if (title !== null) parts.push(`title=${JSON.stringify(title)}`);
+        const note = str("note");
+        if (note !== null) parts.push(`note=${JSON.stringify(note)}`);
+        const save = bool("saveKey");
+        if (save !== null) parts.push(`saveKey=${save}`);
+        const gkUrl = str("getKeyUrl");
+        if (gkUrl !== null) parts.push(`getKeyUrl=${JSON.stringify(gkUrl)}`);
+        const valUrl = str("validatorUrl");
+        if (valUrl !== null) parts.push(`validatorUrl=${JSON.stringify(valUrl)}`);
+        const keys = arr("keys");
+        if (keys && keys.length) parts.push(`keys={${keys.map((k) => JSON.stringify(k)).join(",")}}`);
+        return parts.length ? `{${parts.join(",")}}` : null;
+      }
       readLayoutConfig() {
         const layoutTs = path.join(this.srcDir, "layout.ts");
         const cfg = {
@@ -1324,6 +1370,17 @@ _G.__AOT_R_DESTROY = _PulseDestroy
           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`);
+          const layoutSrc = fs.existsSync(path.join(this.srcDir, "layout.ts")) ? fs.readFileSync(path.join(this.srcDir, "layout.ts"), "utf8") : "";
+          const ksBlock = this.extractLayoutBlock(layoutSrc, "keySystem");
+          const prBlock = this.extractLayoutBlock(layoutSrc, "premium");
+          if (ksBlock) {
+            const lua = this.blockToLuaTable(ksBlock);
+            if (lua) parts.push(`,keySystem=${lua}`);
+          }
+          if (prBlock) {
+            const lua = this.blockToLuaTable(prBlock);
+            if (lua) parts.push(`,premium=${lua}`);
+          }
           parts.push(`}
 `);
           parts.push(`local _P=loadstring(game:HttpGet("${base}/pulse.lua"))(_PULSE_LAYOUT)
@@ -1835,7 +1892,7 @@ function makeClaudeMd(name) {
 function makeAgentsMd(name) {
   return read("AGENTS.md").replace(/{NAME}/g, name);
 }
-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 DIR, TEMPLATE_GLOBALS, TEMPLATE_REMOTES, MODULE_BOILERPLATE, REMOTE_BOILERPLATE, TEMPLATE_GITIGNORE, TEMPLATE_DEPLOY_EXAMPLE, TEMPLATE_LAYOUT_TS, TEMPLATE_PAGE_COMBAT_TS, TEMPLATE_COMPONENT_TS, TEMPLATE_EX_SPEED_TS, TEMPLATE_EX_FOV_TS, TEMPLATE_EX_ESP_TS, TEMPLATE_EX_AIMBOT_TS;
 var init_templates = __esm({
   "src/templates.ts"() {
     init_cjs_shims();
@@ -1847,11 +1904,13 @@ var init_templates = __esm({
     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");
+    read("page_home.ts");
+    TEMPLATE_PAGE_COMBAT_TS = read("page_combat.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");
+    TEMPLATE_EX_AIMBOT_TS = read("component_aimbot.ts");
   }
 });
 
@@ -1940,9 +1999,10 @@ async function cmdInit(args) {
     ["src/misc/globals.lua", TEMPLATE_GLOBALS.replace(/{NAME}/g, name)],
     ["src/misc/remotes.lua", TEMPLATE_REMOTES],
     ["src/layout.ts", TEMPLATE_LAYOUT_TS.replace(/{NAME}/g, name)],
-    ["src/pages/1_Home.ts", TEMPLATE_PAGE_HOME_TS],
+    ["src/pages/1_Combat.ts", TEMPLATE_PAGE_COMBAT_TS],
     ["src/combat/SpeedHack.ts", TEMPLATE_EX_SPEED_TS],
     ["src/combat/FOVChanger.ts", TEMPLATE_EX_FOV_TS],
+    ["src/combat/Aimbot.ts", TEMPLATE_EX_AIMBOT_TS],
     ["src/visuals/PlayerESP.ts", TEMPLATE_EX_ESP_TS],
     ["tsconfig.json", TSCONFIG],
     [".rb-deploy.example", TEMPLATE_DEPLOY_EXAMPLE],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulse-rb",
-  "version": "1.4.3",
+  "version": "1.4.4",
   "description": "rb CLI — Pulse framework build tool for Roblox script projects",
   "bin": {
     "rb": "./bin/rb.js"

package/pulse/runtime.lua

@@ -544,6 +544,7 @@ local function _groupbox(side, title, opts)
         icon=(opts and opts.icon) or "",
         mount=(opts and opts.mount) or nil,
         plain=(opts and opts.plain) or false,
+        premium=(opts and opts.premium) or false,
         widgets=(opts and opts.widgets) or {} }
 end
 

package/templates/component_aimbot.ts

@@ -0,0 +1,18 @@
+// Example premium component — mark the groupbox as { premium: true } in your page.
+// Users see an inline key-entry form until they unlock with a valid premium key.
+defineComponent('Aimbot', (): WidgetDef[] => {
+  const enabled   = signal<boolean>(false)
+  const fovRadius = signal<number>(90)
+  const smoothing = signal<number>(0.15)
+
+  on.heartbeat({ when: enabled, every: 0.016 }, (): void => {
+    // Aimbot logic — find nearest enemy and aim toward them.
+    // Use Pulse.World helpers and _PulseGetHRP() for the local root part.
+  })
+
+  return [
+    toggle('Aimbot').bind(enabled),
+    slider('FOV Radius', { min: 10, max: 360, suffix: '°' }).bind(fovRadius),
+    slider('Smoothing',  { min: 0,  max: 1                }).bind(smoothing),
+  ]
+})

package/templates/layout.ts

@@ -1,9 +1,12 @@
-// Pulse layout — configures the script window.
-// Based on Next.js root layout convention.
+// Pulse layout — configures the script window and optional key/premium systems.
+// This file is never compiled into the output; the rb CLI reads it at build time.
 
 export default {
   title:               '{NAME}',
   author:              '',
+  version:             '1.0.0',
+  description:         'A powerful script for {NAME}. Enable features from the tabs above.',
+  discord:             '',              // shown as "Join Discord" button in Home tab
   toggleKey:           'RightControl',
   size:                [850, 560] as [number, number],
   uiLibrary:           'windui' as const,
@@ -16,4 +19,34 @@ export default {
   openButtonIcon:       'code-2',
   themes:              [] as LayoutConfig['themes'],
   compatExclude:       [] as string[],
+
+  // ── Key system (optional) ────────────────────────────────────────────────────
+  // Blocks the UI until the user enters a valid key.
+  // Remove this block entirely to let anyone use the script without a key.
+  //
+  // keySystem: {
+  //   title:     'Key Required',
+  //   note:      'Get your free key from our Discord',
+  //   saveKey:   true,                        // persist key to executor filesystem
+  //   getKeyUrl: 'https://discord.gg/example',
+  //
+  //   // Option A — static list (client-side):
+  //   keys: ['FREE_KEY_1', 'FREE_KEY_2'],
+  //
+  //   // Option B — server-side validator (more secure, any string "true" = valid):
+  //   // validatorUrl: 'https://yoursite.com/validate?key=',
+  // },
+
+  // ── Premium tier (optional) ──────────────────────────────────────────────────
+  // A second key layer on top of the free tier.
+  // Mark groupboxes with { premium: true } in your pages to lock them.
+  // Users see an inline key-entry UI in each locked groupbox; entering a valid
+  // premium key unlocks all of them live — no re-injection needed.
+  // Premium keys also grant basic (keySystem) access automatically.
+  //
+  // premium: {
+  //   keys:      ['PREMIUM_KEY_1'],
+  //   // OR: validatorUrl: 'https://yoursite.com/premium?key=',
+  //   getKeyUrl: 'https://yoursite.com/premium', // shown in "Copy Link" / "Get Premium Key" buttons
+  // },
 } satisfies LayoutConfig

package/templates/page_combat.ts

@@ -0,0 +1,9 @@
+// Page names must not clash with the built-in "Home" and "Settings" tabs.
+// Rename this page and add more pages as needed.
+definePage('Combat', { icon: 'swords' }, () => [
+  groupbox('left',  'Movement', { icon: 'person',    mount: 'SpeedHack'  }),
+  groupbox('left',  'Camera',   { icon: 'eye',       mount: 'FOVChanger' }),
+  groupbox('right', 'Visuals',  { icon: 'scan-eye',  mount: 'PlayerESP'  }),
+  // premium: true — shows inline key-entry form until the user unlocks with a premium key.
+  groupbox('right', 'Aimbot',   { icon: 'crosshair', mount: 'Aimbot', premium: true }),
+])