typebulb 0.10.6 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -122,7 +122,6 @@ typebulb agent Start here — how to show a bulb inline or build
122
122
  (prints the viewer URL when one is up); always exits 0
123
123
  typebulb skill Print this README as an Agent Skill on stdout
124
124
  typebulb check [file.bulb.md] Type-check a bulb without running it
125
- typebulb check - Type-check a bulb piped on stdin (validate before embedding)
126
125
  typebulb predict [file] Report the capability a bulb probably needs, without running it
127
126
  typebulb models List AI models for tb.ai, filtered by your .env API keys
128
127
  typebulb logs [file|pid] Print a running bulb's captured console (no arg: list running servers; -f follow, -n N tail)
@@ -249,8 +248,6 @@ To render a bulb live inline, wrap the **entire** bulb — frontmatter and all b
249
248
 
250
249
  The agent viewer turns that block into a live, sandboxed app, with a *breakout ↗* control that saves it as a `.bulb.md` in the `typebulbs/` folder — editable with hot reload, and sandboxed unless you trust it. Embedded bulbs are client-only — no `server.ts`, no `tb.fs`/`tb.ai`, no storage.
251
250
 
252
- **Validate before you emit.** An embed is inline text with no file to point `check` at, so type errors otherwise reach the user as a broken embed with no signal to you. Pipe the whole bulb body — frontmatter and all blocks — through `npx typebulb check -`: it type-checks stdin and exits non-zero on errors, giving an embedded bulb the same pre-flight a local `.bulb.md` gets from `typebulb check <file>`.
253
-
254
251
  **Sizing is the viewer's job, not yours.** The agent viewer renders each embed *inline* by default — fit to the conversation column, with height capped so a tall bulb doesn't run away — plus a per-embed toggle to *spread* it to the full transcript width and height. Don't fight the layout from inside the bulb: no need to set a width, reserve height, or guess how much room you'll get.
255
252
 
256
253
  **One layout rule the bulb must get right: vertical space on the root is `padding`, not `margin`.** The embed auto-sizes by reporting `document.body.scrollHeight`, and a vertical margin on the root element *collapses* (a body's first/last child margin escapes through to the viewport) so it isn't captured in that measurement — the host then sizes the frame a margin short and you get a stray scrollbar. The page-style `margin: 32px auto` common on a standalone wrapper is exactly this trap. Keep the horizontal `auto` for centering, but move the vertical part to padding: