pulse-rb 1.3.2 → 1.4.1

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.2";
+    RB_VERSION = "1.4.1";
     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,54 @@ 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(
+            `do
+  local _rs=game:GetService("RunService")
+  local _lp_=game:GetService("Players").LocalPlayer
+  local _uis_=game:GetService("UserInputService")
+  _rs.Heartbeat:Connect(function(a,b) if _PulseRunHeartbeat then _PulseRunHeartbeat(a,b) end end)
+  _rs.RenderStepped:Connect(function(a,b) if _PulseRunRenderStepped then _PulseRunRenderStepped(a,b) end end)
+  _rs.Stepped:Connect(function(a,b) if _PulseRunStepped then _PulseRunStepped(a,b) end end)
+  _lp_.CharacterAdded:Connect(function(c) if _PulseRunCharAdded then _PulseRunCharAdded(c) end end)
+  _lp_.CharacterRemoving:Connect(function(c) if _PulseRunCharRemoving then _PulseRunCharRemoving(c) end end)
+  _uis_.InputBegan:Connect(function(i,g) if _PulseRunInputBegan then _PulseRunInputBegan(i,g) end end)
+  _uis_.InputEnded:Connect(function(i,g) if _PulseRunInputEnded then _PulseRunInputEnded(i,g) end end)
+end
+`
+          );
+          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 +1398,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 +1470,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 +1885,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 +2098,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 +2115,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 +2149,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`);
@@ -2925,25 +3007,18 @@ async function cmdPublish(_args) {
     }
   }
   bundleParts.push(
-    "return {signal=signal,computed=computed,defineComponent=defineComponent,on=on,toggle=toggle,slider=slider,dropdown=dropdown,multidropdown=multidropdown,button=button,keybind=keybind,label=label,separator=separator,groupbox=groupbox,definePage=definePage,Pulse=Pulse,Signal=Signal,Computed=Computed,Component=Component,Components=Components,Store=Store,PulseEvent=PulseEvent,_PulseGetChar=_PulseGetChar,_PulseGetHRP=_PulseGetHRP,_PulseGetHumanoid=_PulseGetHumanoid,_PulseGetAlive=_PulseGetAlive,_PulseRS=_PulseRS,_PulseUIS=_PulseUIS,_PulseDestroy=_PulseDestroy,_PULSE_DEFAULTS=_PULSE_DEFAULTS,_Pages=_Pages}"
+    "return {signal=signal,computed=computed,defineComponent=defineComponent,on=on,toggle=toggle,slider=slider,dropdown=dropdown,multidropdown=multidropdown,button=button,keybind=keybind,label=label,separator=separator,groupbox=groupbox,definePage=definePage,Pulse=Pulse,Signal=Signal,Computed=Computed,Component=Component,Components=Components,Store=Store,PulseEvent=PulseEvent,_PulseGetChar=_PulseGetChar,_PulseGetHRP=_PulseGetHRP,_PulseGetHumanoid=_PulseGetHumanoid,_PulseGetAlive=_PulseGetAlive,_PulseRS=_PulseRS,_PulseUIS=_PulseUIS,_PulseDestroy=_PulseDestroy,_PULSE_DEFAULTS=_PULSE_DEFAULTS,_Pages=_Pages,_PulseRunHeartbeat=_PulseRunHeartbeat,_PulseRunRenderStepped=_PulseRunRenderStepped,_PulseRunStepped=_PulseRunStepped,_PulseRunCharAdded=_PulseRunCharAdded,_PulseRunCharRemoving=_PulseRunCharRemoving,_PulseRunInputBegan=_PulseRunInputBegan,_PulseRunInputEnded=_PulseRunInputEnded}"
   );
   const bundleContent = Buffer.from(bundleParts.join("\n") + "\n", "utf8");
   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.2",
+  "version": "1.4.1",
   "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,7 @@
     "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",
@@ -40,8 +47,7 @@
     "tsup": "^8.3.0",
     "tsx": "^4.19.0",
     "typescript": "^5.8.3",
-    "vitest": "^2.1.0",
-    "@rb-pulse/core": "1.3.2"
+    "vitest": "^2.1.0"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -53,10 +59,5 @@
     "pulse",
     "script"
   ],
-  "license": "MIT",
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsx src/index.ts",
-    "test": "vitest"
-  }
-}
+  "license": "MIT"
+}

package/pulse/helpers/log.lua

@@ -73,7 +73,12 @@ do
         if #_buf > _bufMax then table.remove(_buf, 1) end
 
         if _console then
-            if n >= 3 then warn(line) else print(line) end
+            -- Defer print outside the caller's thread (e.g. Heartbeat) so the
+            -- output always reaches the developer console regardless of context.
+            local _ln, _nw = line, n >= 3
+            task.spawn(function()
+                if _nw then warn(_ln) else print(_ln) end
+            end)
         end
         for _, fn in ipairs(_subs) do pcall(fn, entry) end
         if _file then

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
 
@@ -415,36 +418,116 @@ local function _needComp(name)
     return _currentComponent
 end
 
-local function _uid() return tostring(math.random(100000,999999)) end
+-- ── Sandboxing-safe event runner ─────────────────────────────────────────────
+-- Executor loadstring() environments sandbox Roblox event :Connect() — calls
+-- from inside the bundle never fire. Fix: store callbacks in plain Lua tables
+-- here; the compiler emits user-scope Roblox connections that call _PulseRun*,
+-- routing events into these runners from the non-sandboxed user script.
+
+local _cbSeq = 0
+local function _nextId() _cbSeq = _cbSeq + 1; return _cbSeq end
+
+local _HbCbs  = {}   -- Heartbeat
+local _RsCbs  = {}   -- RenderStepped
+local _StCbs  = {}   -- Stepped
+local _CaCbs  = {}   -- CharacterAdded / respawn
+local _CrCbs  = {}   -- CharacterRemoving
+local _IbCbs  = {}   -- InputBegan
+local _IeCbs  = {}   -- InputEnded
+
+-- Mock RBXScriptConnection: removing from the list on :Disconnect().
+local function _mockConn(id, list)
+    return { Disconnect = function() list[id] = nil end }
+end
 
-local function _hbBind(svc, optsOrFn, fn)
+local function _runFrameCbs(list, a, b)
+    for _, e in pairs(list) do
+        if e and e.comp then
+            e.comp._rawHb  = (e.comp._rawHb  or 0) + 1
+            local pass = not e.when or e.when()
+            if pass and e.every then
+                local t   = type(e.every) == "table" and e.every() or e.every
+                local now = tick()
+                if (now - e.last) < t then pass = false else e.last = now end
+            end
+            if pass then
+                e.comp._condHb = (e.comp._condHb or 0) + 1
+                if Pulse and Pulse.Log then
+                    Pulse.Log.throttle(e.comp._name, 5, "debug", "tick (condition passed)")
+                end
+                local ok, err = pcall(e.cb, a, b)
+                if not ok then
+                    warn("[Pulse] "..tostring(e.comp._name).." error: "..tostring(err))
+                    if Pulse and Pulse.Log then
+                        Pulse.Log.error(e.comp._name, "event error: "..tostring(err))
+                    end
+                end
+            end
+        end
+    end
+end
+
+local function _runEventCbs(list, a, b)
+    for _, e in pairs(list) do
+        if e then pcall(e.cb, a, b) end
+    end
+end
+
+-- Public runners — called by compiler-generated user-scope connections.
+_PulseRunHeartbeat     = function(a,b) _runFrameCbs(_HbCbs, a,b) end
+_PulseRunRenderStepped = function(a,b) _runFrameCbs(_RsCbs, a,b) end
+_PulseRunStepped       = function(a,b) _runFrameCbs(_StCbs, a,b) end
+_PulseRunCharAdded     = function(c)   _runEventCbs(_CaCbs, c) end
+_PulseRunCharRemoving  = function(c)   _runEventCbs(_CrCbs, c) end
+_PulseRunInputBegan    = function(i,g) _runEventCbs(_IbCbs, i,g) end
+_PulseRunInputEnded    = function(i,g) _runEventCbs(_IeCbs, i,g) end
+
+local function _hbBind(list, optsOrFn, fn)
     local comp = _needComp("event")
     local opts, cb
     if type(optsOrFn) == "function" then cb=optsOrFn; opts={}
     else opts=optsOrFn; cb=fn end
-    local when=opts.when; local every=opts.every; local last=0
-    comp:bind("ev_".._uid(), svc:Connect(function(a,b)
-        if when and not when() then return end
-        if every then
-            local t=type(every)=="table" and every() or every
-            local now=tick(); if (now-last)<t then return end; last=now
-        end
-        local ok,err=pcall(cb,a,b)
-        if not ok then warn("[Pulse] "..comp._name.." event error: "..tostring(err)) end
-    end))
+    local id = _nextId()
+    comp._rawHb  = comp._rawHb  or 0
+    comp._condHb = comp._condHb or 0
+    list[id] = { comp=comp, when=opts.when, every=opts.every, last=0, cb=cb }
+    comp:bind("ev_"..id, _mockConn(id, list))
 end
 
 local _on = {}
-_on.heartbeat         = function(a,b) _hbBind(_PulseRS.Heartbeat,      a,b) end
-_on.renderStepped     = function(a,b) _hbBind(_PulseRS.RenderStepped,  a,b) end
-_on.stepped           = function(a,b) _hbBind(_PulseRS.Stepped,        a,b) end
-_on.inputBegan        = function(fn)  local c=_needComp("inputBegan");         c:bind("ib_".._uid(), _PulseUIS.InputBegan:Connect(fn)) end
-_on.inputEnded        = function(fn)  local c=_needComp("inputEnded");         c:bind("ie_".._uid(), _PulseUIS.InputEnded:Connect(fn)) end
-_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.after             = function(s,fn)   _needComp("after"):task(s,fn) end
+_on.heartbeat         = function(a,b) _hbBind(_HbCbs, a,b) end
+_on.renderStepped     = function(a,b) _hbBind(_RsCbs, a,b) end
+_on.stepped           = function(a,b) _hbBind(_StCbs, a,b) end
+_on.inputBegan        = function(fn)
+    local c=_needComp("inputBegan"); local id=_nextId()
+    _IbCbs[id]={cb=fn}; c:bind("ib_"..id, _mockConn(id,_IbCbs))
+end
+_on.inputEnded        = function(fn)
+    local c=_needComp("inputEnded"); local id=_nextId()
+    _IeCbs[id]={cb=fn}; c:bind("ie_"..id, _mockConn(id,_IeCbs))
+end
+_on.characterAdded    = function(fn)
+    local c=_needComp("characterAdded"); local id=_nextId()
+    _CaCbs[id]={cb=fn}; c:bind("ca_"..id, _mockConn(id,_CaCbs))
+end
+_on.characterRemoving = function(fn)
+    local c=_needComp("characterRemoving"); local id=_nextId()
+    _CrCbs[id]={cb=fn}; c:bind("cr_"..id, _mockConn(id,_CrCbs))
+end
+_on.respawn           = function(fn)
+    local c=_needComp("respawn"); local id=_nextId()
+    _CaCbs[id]={cb=fn}; c:bind("__respawn_"..c._name, _mockConn(id,_CaCbs))
+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)
     local comp = Component(name)
@@ -470,6 +553,7 @@ local function _groupbox(side, title, opts)
     return { type="groupbox", side=side, title=title,
         icon=(opts and opts.icon) or "",
         mount=(opts and opts.mount) or nil,
+        plain=(opts and opts.plain) or false,
         widgets=(opts and opts.widgets) or {} }
 end
 

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/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'  }),
 ])