typebulb 0.58.0 → 0.58.2

package/README.md

@@ -192,13 +192,13 @@ everywhere.
 |-----|--------------|:-----------:|
 | `tb.data(n)` / `tb.json(n)` | Read data chunk `n` from the `data.txt` block — raw string, or parsed JSON | |
 | `tb.insight()` | Read the `insight.json` block as JSON | |
-| `tb.setData(chunks)` / `tb.setInsight(v)` | Replace this run's data / insight and get back a link carrying it; the file is untouched | |
+| `tb.setData(chunks)` / `tb.setInsight(v)` | Replace this run's data / insight; the URL fragment follows, the file is untouched | |
 | `tb.theme` | Get/set the light/dark override; `undefined` follows the OS | |
 | `tb.mode` | Runtime mode — `'local'` (CLI) or `'inline'` (sandboxed iframe); `'ide'`/`'published'` on typebulb.com | |
 | `tb.proxy(url)` | Rewrite a CDN URL to load through the host origin (Web Worker / WASM) | |
 | `tb.dump(...)` | Log values (incl. lazy / device-backed tensors) to the browser console | |
 | `tb.copy(text)` | Copy text to the clipboard | |
-| `tb.url()` | Get the bulb URL (the served localhost URL, locally) | |
+| `tb.url()` | Get the bulb's canonical URL, `#tb=` fragment included (the served localhost URL, locally) | |
 | `tb.models()` | List available AI models (for dynamic model selectors); the `.env` default is flagged (`default: true`); returns `[]` when inline (no host AI) | |
 | `tb.aiAccess()` | What backs `tb.ai` — `'own' \| 'courtesy' \| 'none'` | |
 | `tb.log(...)` | Print to the CLI's stdout (read back with `typebulb logs`); falls back to the browser console when no CLI serves the page | |
@@ -511,17 +511,18 @@ the whole file; `put` replaces it blind, knowing neither its size, its format, n
 ## Runtime data (`tb.setData`)
 
 A bulb that computes its own results (a scrape, a batch score, a simulation, a tournament) can swap
-them in as the data it's running on, and get back a link that carries them:
+them in as the data it's running on, and the page URL then carries them:
 
 ```ts
-const url = await tb.setData(JSON.stringify(results))
-if (url) tb.copy(url)
+await tb.setData(JSON.stringify(results))
+tb.copy(await tb.url())
 ```
 
 - `tb.data()` / `tb.json()` return the new chunks for the rest of the page, and the URL's `#tb=` fragment holds them, so reloading or opening that link restores the run. `tb.setInsight(value)` is the same for `tb.insight()`.
+- **The write is the URL update.** Awaiting a setter means the address bar holds the run. Nothing comes back: `tb.url()` is how you read the link. On typebulb.com the fragment lands in fullscreen, exactly as `tb.infer()` does; an inline bulb has no URL of its own, so there the swap happens and nothing else does.
 - **Runtime only, never the file.** A reload without the fragment is back on the bulb's own `data.txt`. Two gestures promote a run to source, and no `tb.*` call does: `typebulb put` from the terminal, or `tb.infer()` to raise the modal and press **Save to bulb**, which files whatever the page holds — an LLM call is not needed and the size ceiling does not apply (needs `--trust`).
-- **The link has a size ceiling; the file doesn't.** Around 60KB encoded, so pass what a share needs rather than everything. `undefined` back means it didn't fit (also what an inline bulb gets — no address bar).
-- **Set only what you changed.** An unset slot stays out of the link and falls through to the bulb's own block, so a data-only run doesn't drag a copy of `insight.json` along. Both in one tick is one encode and one link: `tb.setData(d); const url = await tb.setInsight(i)`.
+- **The link has a size ceiling; the file doesn't.** Around 60KB encoded, so pass what a share needs rather than everything. Over it the run still swaps, but the fragment clears and there is no link.
+- **Set only what you changed.** An unset slot stays out of the link and falls through to the bulb's own block, so a data-only run doesn't drag a copy of `insight.json` along. Both in one tick is one encode: `tb.setData(d); await tb.setInsight(i)`.
 
 ## Charts
 

package/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: typebulb
 description: "Author and run Typebulb bulbs — single-file markdown apps (TypeScript/TSX) that run locally via `npx typebulb` (full power: filesystem, database, `server.ts`, `tb.ai`) or render live inline in your coding agent's session through Typebulb's agent mirror (sandboxed, client-only). A bulb can be a visual widget (chart, simulation, diagram, calculator, UI), a full-stack tool with a Node backend, or an AI app that calls models at runtime. Covers the bulb format, the `tb.*` API, trust, and the local run/inline workflow. Use when the user wants a bulb, a quick local tool (visual, backend-backed, or AI-powered), or something visual rendered inline in the conversation."
-version: 0.58.0
+version: 0.58.2
 ---
 
-> Generated from typebulb v0.58.0. `npx typebulb agent` prints the running version alongside the path to its packaged SKILL.md: if that version is newer than this one, replace this file with that one.
+> Generated from typebulb v0.58.2. `npx typebulb agent` prints the running version alongside the path to its packaged SKILL.md: if that version is newer than this one, replace this file with that one.
 
 # typebulb
 
@@ -200,13 +200,13 @@ everywhere.
 |-----|--------------|:-----------:|
 | `tb.data(n)` / `tb.json(n)` | Read data chunk `n` from the `data.txt` block — raw string, or parsed JSON | |
 | `tb.insight()` | Read the `insight.json` block as JSON | |
-| `tb.setData(chunks)` / `tb.setInsight(v)` | Replace this run's data / insight and get back a link carrying it; the file is untouched | |
+| `tb.setData(chunks)` / `tb.setInsight(v)` | Replace this run's data / insight; the URL fragment follows, the file is untouched | |
 | `tb.theme` | Get/set the light/dark override; `undefined` follows the OS | |
 | `tb.mode` | Runtime mode — `'local'` (CLI) or `'inline'` (sandboxed iframe); `'ide'`/`'published'` on typebulb.com | |
 | `tb.proxy(url)` | Rewrite a CDN URL to load through the host origin (Web Worker / WASM) | |
 | `tb.dump(...)` | Log values (incl. lazy / device-backed tensors) to the browser console | |
 | `tb.copy(text)` | Copy text to the clipboard | |
-| `tb.url()` | Get the bulb URL (the served localhost URL, locally) | |
+| `tb.url()` | Get the bulb's canonical URL, `#tb=` fragment included (the served localhost URL, locally) | |
 | `tb.models()` | List available AI models (for dynamic model selectors); the `.env` default is flagged (`default: true`); returns `[]` when inline (no host AI) | |
 | `tb.aiAccess()` | What backs `tb.ai` — `'own' \| 'courtesy' \| 'none'` | |
 | `tb.log(...)` | Print to the CLI's stdout (read back with `typebulb logs`); falls back to the browser console when no CLI serves the page | |
@@ -519,17 +519,18 @@ the whole file; `put` replaces it blind, knowing neither its size, its format, n
 ## Runtime data (`tb.setData`)
 
 A bulb that computes its own results (a scrape, a batch score, a simulation, a tournament) can swap
-them in as the data it's running on, and get back a link that carries them:
+them in as the data it's running on, and the page URL then carries them:
 
 ```ts
-const url = await tb.setData(JSON.stringify(results))
-if (url) tb.copy(url)
+await tb.setData(JSON.stringify(results))
+tb.copy(await tb.url())
 ```
 
 - `tb.data()` / `tb.json()` return the new chunks for the rest of the page, and the URL's `#tb=` fragment holds them, so reloading or opening that link restores the run. `tb.setInsight(value)` is the same for `tb.insight()`.
+- **The write is the URL update.** Awaiting a setter means the address bar holds the run. Nothing comes back: `tb.url()` is how you read the link. On typebulb.com the fragment lands in fullscreen, exactly as `tb.infer()` does; an inline bulb has no URL of its own, so there the swap happens and nothing else does.
 - **Runtime only, never the file.** A reload without the fragment is back on the bulb's own `data.txt`. Two gestures promote a run to source, and no `tb.*` call does: `typebulb put` from the terminal, or `tb.infer()` to raise the modal and press **Save to bulb**, which files whatever the page holds — an LLM call is not needed and the size ceiling does not apply (needs `--trust`).
-- **The link has a size ceiling; the file doesn't.** Around 60KB encoded, so pass what a share needs rather than everything. `undefined` back means it didn't fit (also what an inline bulb gets — no address bar).
-- **Set only what you changed.** An unset slot stays out of the link and falls through to the bulb's own block, so a data-only run doesn't drag a copy of `insight.json` along. Both in one tick is one encode and one link: `tb.setData(d); const url = await tb.setInsight(i)`.
+- **The link has a size ceiling; the file doesn't.** Around 60KB encoded, so pass what a share needs rather than everything. Over it the run still swaps, but the fragment clears and there is no link.
+- **Set only what you changed.** An unset slot stays out of the link and falls through to the bulb's own block, so a data-only run doesn't drag a copy of `insight.json` along. Both in one tick is one encode: `tb.setData(d); await tb.setInsight(i)`.
 
 ## Charts
 

package/dist/agents/claude/client.js

@@ -1109,8 +1109,8 @@ ${V9t}
   // tb.setData / tb.setInsight (TB-State.md), on the engine both hosts share. The globals and the
   // transport are all this host owns: encoding round-trips to the server because the page carries
   // no fflate on purpose, and the fragment write is the address bar the setters exist to fill.
-  // Resolves the shareable URL, or undefined when there is no address bar to put it in (inline) or
-  // the state is too large to encode \u2014 the one failure an author must handle.
+  // Resolves once that write has landed, and hands back nothing: the link is then tb.url() like
+  // any other. An inline bulb has no address bar, so its swap is page-local and never encodes.
   window.__tbState.init({
     applyData: (chunks) => { window.__TB_DATA__ = chunks; },
     applyInsight: (json) => { window.__TB_INSIGHT__ = json; },
@@ -1128,7 +1128,6 @@ ${V9t}
           // earlier fragment, or the address bar keeps addressing a run the page is no longer
           // showing \u2014 and a reload would silently revert to it.
           history.replaceState(null, '', location.pathname + location.search + hash);
-          return hash ? location.href : undefined;
         });
     }
   });
@@ -1325,8 +1324,8 @@ ${V9t}
     if (inferRunning) return Promise.reject(new Error('Inference already in progress'));
     inferRunning = true;
     // Data to preview: the explicit arg, else undefined \u2014 the modal then seeds from the SOURCE
-    // chunks (/__infer-info), the local Data tab, exactly as .com's IDE modal reseeds from the
-    // Data tab rather than post-run runtime state.
+    // chunks the page currently holds, else the SOURCE chunks from /__infer-info \u2014 the same
+    // precedence .com's modal seeds by (TB-Inference.md, "Data seed").
     let data = opts.data;
     if (data !== undefined && !Array.isArray(data)) data = [data];
     return new Promise((resolve, reject) => {

package/dist/agents/codex/client.js

@@ -1109,8 +1109,8 @@ ${q9t}
   // tb.setData / tb.setInsight (TB-State.md), on the engine both hosts share. The globals and the
   // transport are all this host owns: encoding round-trips to the server because the page carries
   // no fflate on purpose, and the fragment write is the address bar the setters exist to fill.
-  // Resolves the shareable URL, or undefined when there is no address bar to put it in (inline) or
-  // the state is too large to encode \u2014 the one failure an author must handle.
+  // Resolves once that write has landed, and hands back nothing: the link is then tb.url() like
+  // any other. An inline bulb has no address bar, so its swap is page-local and never encodes.
   window.__tbState.init({
     applyData: (chunks) => { window.__TB_DATA__ = chunks; },
     applyInsight: (json) => { window.__TB_INSIGHT__ = json; },
@@ -1128,7 +1128,6 @@ ${q9t}
           // earlier fragment, or the address bar keeps addressing a run the page is no longer
           // showing \u2014 and a reload would silently revert to it.
           history.replaceState(null, '', location.pathname + location.search + hash);
-          return hash ? location.href : undefined;
         });
     }
   });
@@ -1325,8 +1324,8 @@ ${q9t}
     if (inferRunning) return Promise.reject(new Error('Inference already in progress'));
     inferRunning = true;
     // Data to preview: the explicit arg, else undefined \u2014 the modal then seeds from the SOURCE
-    // chunks (/__infer-info), the local Data tab, exactly as .com's IDE modal reseeds from the
-    // Data tab rather than post-run runtime state.
+    // chunks the page currently holds, else the SOURCE chunks from /__infer-info \u2014 the same
+    // precedence .com's modal seeds by (TB-Inference.md, "Data seed").
     let data = opts.data;
     if (data !== undefined && !Array.isArray(data)) data = [data];
     return new Promise((resolve, reject) => {

package/dist/agents/pi/client.js

@@ -1109,8 +1109,8 @@ ${W9t}
   // tb.setData / tb.setInsight (TB-State.md), on the engine both hosts share. The globals and the
   // transport are all this host owns: encoding round-trips to the server because the page carries
   // no fflate on purpose, and the fragment write is the address bar the setters exist to fill.
-  // Resolves the shareable URL, or undefined when there is no address bar to put it in (inline) or
-  // the state is too large to encode \u2014 the one failure an author must handle.
+  // Resolves once that write has landed, and hands back nothing: the link is then tb.url() like
+  // any other. An inline bulb has no address bar, so its swap is page-local and never encodes.
   window.__tbState.init({
     applyData: (chunks) => { window.__TB_DATA__ = chunks; },
     applyInsight: (json) => { window.__TB_INSIGHT__ = json; },
@@ -1128,7 +1128,6 @@ ${W9t}
           // earlier fragment, or the address bar keeps addressing a run the page is no longer
           // showing \u2014 and a reload would silently revert to it.
           history.replaceState(null, '', location.pathname + location.search + hash);
-          return hash ? location.href : undefined;
         });
     }
   });
@@ -1325,8 +1324,8 @@ ${W9t}
     if (inferRunning) return Promise.reject(new Error('Inference already in progress'));
     inferRunning = true;
     // Data to preview: the explicit arg, else undefined \u2014 the modal then seeds from the SOURCE
-    // chunks (/__infer-info), the local Data tab, exactly as .com's IDE modal reseeds from the
-    // Data tab rather than post-run runtime state.
+    // chunks the page currently holds, else the SOURCE chunks from /__infer-info \u2014 the same
+    // precedence .com's modal seeds by (TB-Inference.md, "Data seed").
     let data = opts.data;
     if (data !== undefined && !Array.isArray(data)) data = [data];
     return new Promise((resolve, reject) => {

package/dist/dts/tbTypings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tbTypings.d.ts","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA6SH,kEAAkE;AAClE,eAAO,MAAM,eAAe,QAO3B,CAAA;AASD;;;wDAGwD;AACxD,eAAO,MAAM,eAAe,QAO3B,CAAA"}
+{"version":3,"file":"tbTypings.d.ts","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgTH,kEAAkE;AAClE,eAAO,MAAM,eAAe,QAO3B,CAAA;AASD;;;wDAGwD;AACxD,eAAO,MAAM,eAAe,QAO3B,CAAA"}