typebulb 0.55.1 → 0.55.3

package/dist/agents/pi/styles.css

@@ -337,6 +337,81 @@ html:not([data-theme="dark"]) .turn-view > .shimmer-text {
    rides a whole buffering window). */
 .pill-busy { border-color: var(--accent); --shimmer-base: var(--panel); --shimmer-mix: 25%; }
 
+/* ── Tooltip — the styled stand-in for native `title`, and only on FIXED EXPLANATORY copy: text
+   that teaches what a control does. Dynamic identifiers (a path, a model id, an mcp tool's full
+   name) keep the native attribute, which is better at them: they run long, they want to wrap, and
+   `title` is the reliable "show me the whole string" affordance a bounded box is worse at. One
+   attribute opts a control in, no wrapper component and no JS, and it shows on :focus-visible,
+   which native `title` never does for a keyboard user. `data-tip` is not an accessible name, so a
+   glyph-only control still needs its own ariaLabel.
+   Three non-obvious bits. :where() zeroes the position rule's specificity, so a control that is
+   ALREADY positioned (the filter's inset × and 🔬) keeps its own and is its own containing block
+   anyway. display:none at rest rather than opacity:0, because an absolutely positioned box still
+   counts toward a scroll container's scrollable overflow and .messages' stuck-to-bottom test is
+   measured in pixels. The open delay therefore rides an animation (fill-mode both holds the
+   from-state through the delay), since a display switch cannot transition. ── */
+:where([data-tip]) { position: relative; }
+[data-tip]::after {
+  content: attr(data-tip);
+  display: none;
+  position: absolute;
+  z-index: 40;
+  top: calc(100% + 7px);
+  left: 50%;
+  transform: translateX(-50%);
+  width: max-content;
+  max-width: min(22rem, 60vw);
+  padding: .3rem .55rem;
+  background: var(--panel);
+  color: var(--fg);
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  box-shadow: 0 8px 30px rgba(0, 0, 0, .45);
+  /* Its own typography, never the host's (a stub label is italic, a pill is not) — but the same
+     SIZE as the chrome it explains, .8rem, which is both the statusbar's and the tab row's. A tip
+     set larger than the control it belongs to reads as shouting. Full --fg carries it instead. */
+  font-size: .8rem;
+  font-style: normal;
+  font-weight: 400;
+  line-height: 1.4;
+  /* Centred and balanced, because the box CANNOT hug wrapped text: `width: max-content` capped by
+     max-width means any tip too long for one line sits at exactly max-width, whatever it wraps to.
+     Left-aligned, the leftover on the last line then reads as dead space (the model pill's tip, the
+     only one long enough to wrap). Balancing evens the lines and centring splits what's left to both
+     sides, so a two-line tip reads as a block instead of a full line plus a stub. */
+  text-align: center;
+  text-wrap: balance;
+  /* pre-line, not normal: a tip built from two lines (the session pill's cwd over its id) keeps the
+     break native `title` gave it, and everything else still wraps at the max-width. */
+  white-space: pre-line;
+  pointer-events: none;
+}
+[data-tip]:hover::after,
+[data-tip]:focus-visible::after { display: block; animation: tip-in .12s ease .4s both; }
+@keyframes tip-in { from { opacity: 0; } to { opacity: 1; } }
+/* One tip nested in another (the diff pill's × sits inside the pill body): hovering the inner one
+   hovers the outer too, so both boxes would open. Only the innermost shows, which is how native
+   `title` resolves it. */
+[data-tip]:has([data-tip]:hover)::after { display: none; }
+/* Pressed: tooltips are dismissed until the pointer reaches a different one (ui.ts
+   armTooltipDismiss). Out-specifies the :hover rule on its own, no !important needed. */
+body.tips-off [data-tip]::after { display: none; }
+/* Bottom-anchored surfaces open upward, like their own menus: under the statusbar and under the
+   composer's action row there is no room to drop into. */
+:is(.statusbar, .composer) [data-tip]::after { top: auto; bottom: calc(100% + 7px); }
+/* ...and grow LEFT from the control's right edge, which is the "end" alignment the statusbar menus
+   already take by default (.pop-center / .pop-start above are their opt-outs). Every one of these
+   clusters is right-aligned, so a centred box runs past the viewport — the bulbs pill's tip was
+   clipped — and inside a menu it is also the direction that stays within its overflow:hidden for a
+   control inset at the right edge. The transcript's own tips stay centred: they sit mid-column. */
+:is(.statusbar, .composer, .picker, .servers-pop) [data-tip]::after { left: auto; right: 0; transform: none; }
+/* ...except where the pill's WRAP already names an alignment for its menu. A tip and the menu it
+   belongs to must open the same way, so both read off the same tag (.pop-center / .pop-start above)
+   and neither can be set on its own. Direct child, like the menu rules: a control nested inside a
+   pill (the diff pill's ×) keeps the cluster's end alignment, which is right at a pill's far edge. */
+.pop-center > [data-tip]::after { right: auto; left: 50%; transform: translateX(-50%); }
+.pop-start > [data-tip]::after { right: auto; left: 0; transform: none; }
+
 /* ── The composer (TB-Agent-Composer.md): the prompt panel under the transcript. In flow (not
    overlaid like the statusbar) — it owns real height and must never cover content. ── */
 .composer { position: relative; flex: none; background: var(--bg); padding-inline: 1.75rem; }

package/dist/format/index.d.ts

@@ -7,5 +7,6 @@ export * from './chunks.js';
 export * from './slug.js';
 export * from './mode.js';
 export * from './pageShell.js';
+export * from './scrollRestore.js';
 export { escapeYamlString, unescapeYamlString } from './yaml.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/format/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}

package/dist/format/index.js

@@ -7,5 +7,6 @@ export * from './chunks.js';
 export * from './slug.js';
 export * from './mode.js';
 export * from './pageShell.js';
+export * from './scrollRestore.js';
 export { escapeYamlString, unescapeYamlString } from './yaml.js';
 //# sourceMappingURL=index.js.map

package/dist/format/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}

package/dist/format/scrollRestore.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The scroll-restoration engine a rendered bulb document ships (specs/Scroll-Restoration.md).
+ * ONE copy, beside pageShell.ts and on its argument: both hosts must emit the same behavior or a
+ * bulb restores differently local vs published. A script string for the page <head>; the host's
+ * own snippet then calls `window.__tbScroll.init({ initialY, save })` to say where the offset
+ * comes from and where reports go (the CLI: the page's sessionStorage; the sandbox: a postMessage
+ * to the parent).
+ *
+ *   init({ initialY, save }) -> arm the re-apply loop at initialY (0: nothing to do); save(y) is
+ *                                the throttled reporter's sink
+ *   restore(y)               -> re-arm at y (a traversal landed); undefined or 0 scrolls to top
+ *   top()                    -> a page-shaped move landed: disarm, scroll to 0, report 0
+ *   flush()                  -> report the pending offset now (before a route change goes out)
+ *
+ * While armed, every frame writes `y` once the document is tall enough, and the loop stands down
+ * on the first scroll it did not author (input, the browser's scroll anchoring, a bulb scrolling
+ * itself) or TAIL_MS after `load`. A clamp (the document shrank under us) is exempt. Native
+ * restoration gives up at `load`; this covers the tail a bulb that renders after load needs.
+ */
+export declare const scrollRestoreEngine = "(function () {\n  var W = window, D = document;\n  var TAIL_MS = 1500, TOL = 2, THROTTLE_MS = 200;\n  var SCROLL_KEYS = { ' ': 1, ArrowUp: 1, ArrowDown: 1, PageUp: 1, PageDown: 1, Home: 1, End: 1 };\n  var save = null;\n  var target = 0, armed = false, applied = false, lastWritten = -1, raf = 0, deadline = 0;\n  var pending, timer = 0;\n\n  var maxY = function () { var d = D.documentElement; return Math.max(0, d.scrollHeight - d.clientHeight); };\n  var write = function (y) {\n    lastWritten = y;\n    try { W.scrollTo({ top: y, left: 0, behavior: 'instant' }); } catch (e) { W.scrollTo(0, y); }\n  };\n  var disarm = function () {\n    armed = false;\n    if (raf) { cancelAnimationFrame(raf); raf = 0; }\n    if (deadline) { clearTimeout(deadline); deadline = 0; }\n  };\n  var tick = function () {\n    if (!armed) return;\n    if (target <= maxY()) { applied = true; if (Math.abs(W.scrollY - target) > TOL) write(target); }\n    raf = requestAnimationFrame(tick);\n  };\n  var expire = function () {\n    if (!armed) return;\n    if (!applied) { var y = Math.min(target, maxY()); if (y > 0) write(y); }\n    disarm();\n  };\n  var arm = function (y) {\n    disarm();\n    target = y; applied = false;\n    if (!(y > 0)) return;\n    armed = true;\n    raf = requestAnimationFrame(tick);\n    var start = function () { if (armed && !deadline) deadline = setTimeout(expire, TAIL_MS); };\n    if (D.readyState === 'complete') start(); else W.addEventListener('load', start, { once: true });\n  };\n\n  var report = function (y) { if (save) { try { save(y); } catch (e) {} } };\n  var flush = function () {\n    if (timer) { clearTimeout(timer); timer = 0; }\n    if (pending !== undefined) { var y = pending; pending = undefined; report(y); }\n  };\n\n  W.addEventListener('scroll', function () {\n    var y = W.scrollY;\n    pending = y;\n    if (!timer) timer = setTimeout(flush, THROTTLE_MS);\n    if (!armed || Math.abs(y - lastWritten) <= TOL) return;\n    if (y < target && Math.abs(y - maxY()) <= TOL) return;\n    disarm();\n  }, { passive: true });\n  W.addEventListener('wheel', disarm, { capture: true, passive: true });\n  W.addEventListener('touchstart', disarm, { capture: true, passive: true });\n  W.addEventListener('keydown', function (e) { if (SCROLL_KEYS[e.key]) disarm(); }, { capture: true });\n\n  W.__tbScroll = {\n    init: function (o) {\n      save = o && typeof o.save === 'function' ? o.save : null;\n      arm(o ? Number(o.initialY) : 0);\n    },\n    restore: function (y) {\n      y = Number(y);\n      if (y > 0 && isFinite(y)) arm(y); else { disarm(); write(0); }\n    },\n    top: function () { disarm(); write(0); report(0); },\n    flush: flush\n  };\n})();";
+//# sourceMappingURL=scrollRestore.d.ts.map

package/dist/format/scrollRestore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollRestore.d.ts","sourceRoot":"","sources":["../../format/src/scrollRestore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,kpFAoE1B,CAAA"}

package/dist/format/scrollRestore.js

@@ -0,0 +1,89 @@
+/**
+ * The scroll-restoration engine a rendered bulb document ships (specs/Scroll-Restoration.md).
+ * ONE copy, beside pageShell.ts and on its argument: both hosts must emit the same behavior or a
+ * bulb restores differently local vs published. A script string for the page <head>; the host's
+ * own snippet then calls `window.__tbScroll.init({ initialY, save })` to say where the offset
+ * comes from and where reports go (the CLI: the page's sessionStorage; the sandbox: a postMessage
+ * to the parent).
+ *
+ *   init({ initialY, save }) -> arm the re-apply loop at initialY (0: nothing to do); save(y) is
+ *                                the throttled reporter's sink
+ *   restore(y)               -> re-arm at y (a traversal landed); undefined or 0 scrolls to top
+ *   top()                    -> a page-shaped move landed: disarm, scroll to 0, report 0
+ *   flush()                  -> report the pending offset now (before a route change goes out)
+ *
+ * While armed, every frame writes `y` once the document is tall enough, and the loop stands down
+ * on the first scroll it did not author (input, the browser's scroll anchoring, a bulb scrolling
+ * itself) or TAIL_MS after `load`. A clamp (the document shrank under us) is exempt. Native
+ * restoration gives up at `load`; this covers the tail a bulb that renders after load needs.
+ */
+export const scrollRestoreEngine = `(function () {
+  var W = window, D = document;
+  var TAIL_MS = 1500, TOL = 2, THROTTLE_MS = 200;
+  var SCROLL_KEYS = { ' ': 1, ArrowUp: 1, ArrowDown: 1, PageUp: 1, PageDown: 1, Home: 1, End: 1 };
+  var save = null;
+  var target = 0, armed = false, applied = false, lastWritten = -1, raf = 0, deadline = 0;
+  var pending, timer = 0;
+
+  var maxY = function () { var d = D.documentElement; return Math.max(0, d.scrollHeight - d.clientHeight); };
+  var write = function (y) {
+    lastWritten = y;
+    try { W.scrollTo({ top: y, left: 0, behavior: 'instant' }); } catch (e) { W.scrollTo(0, y); }
+  };
+  var disarm = function () {
+    armed = false;
+    if (raf) { cancelAnimationFrame(raf); raf = 0; }
+    if (deadline) { clearTimeout(deadline); deadline = 0; }
+  };
+  var tick = function () {
+    if (!armed) return;
+    if (target <= maxY()) { applied = true; if (Math.abs(W.scrollY - target) > TOL) write(target); }
+    raf = requestAnimationFrame(tick);
+  };
+  var expire = function () {
+    if (!armed) return;
+    if (!applied) { var y = Math.min(target, maxY()); if (y > 0) write(y); }
+    disarm();
+  };
+  var arm = function (y) {
+    disarm();
+    target = y; applied = false;
+    if (!(y > 0)) return;
+    armed = true;
+    raf = requestAnimationFrame(tick);
+    var start = function () { if (armed && !deadline) deadline = setTimeout(expire, TAIL_MS); };
+    if (D.readyState === 'complete') start(); else W.addEventListener('load', start, { once: true });
+  };
+
+  var report = function (y) { if (save) { try { save(y); } catch (e) {} } };
+  var flush = function () {
+    if (timer) { clearTimeout(timer); timer = 0; }
+    if (pending !== undefined) { var y = pending; pending = undefined; report(y); }
+  };
+
+  W.addEventListener('scroll', function () {
+    var y = W.scrollY;
+    pending = y;
+    if (!timer) timer = setTimeout(flush, THROTTLE_MS);
+    if (!armed || Math.abs(y - lastWritten) <= TOL) return;
+    if (y < target && Math.abs(y - maxY()) <= TOL) return;
+    disarm();
+  }, { passive: true });
+  W.addEventListener('wheel', disarm, { capture: true, passive: true });
+  W.addEventListener('touchstart', disarm, { capture: true, passive: true });
+  W.addEventListener('keydown', function (e) { if (SCROLL_KEYS[e.key]) disarm(); }, { capture: true });
+
+  W.__tbScroll = {
+    init: function (o) {
+      save = o && typeof o.save === 'function' ? o.save : null;
+      arm(o ? Number(o.initialY) : 0);
+    },
+    restore: function (y) {
+      y = Number(y);
+      if (y > 0 && isFinite(y)) arm(y); else { disarm(); write(0); }
+    },
+    top: function () { disarm(); write(0); report(0); },
+    flush: flush
+  };
+})();`;
+//# sourceMappingURL=scrollRestore.js.map

package/dist/format/scrollRestore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollRestore.js","sourceRoot":"","sources":["../../format/src/scrollRestore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAoE7B,CAAA"}