@aparte/core 0.16.9 → 0.16.11

package/dist/index.css

@@ -332,6 +332,9 @@
      `display: none` under `(pointer: coarse)`, so 2.5.8's 24px is the bar here and not
      2.5.5's 44px. */
   --aparte-scroll-rail-hit-size: 24px;
+  /* The share of the transcript's height the rail may take: a list of ticks, not a
+     minimap, so it is the height of its list up to this, centred, and scrolls past it. */
+  --aparte-scroll-rail-share: .6;
 
   /* Context gauge, ring variant — a diameter, and a stroke in the ring's own 36-unit
      box. Literals like the rail's: a 22px ring is a toolbar's measure, not a spacing step. */
@@ -7265,10 +7268,10 @@ aparte-context[data-level="danger"] .aparte-context__value {
  * One of the sheets src/index.ts imports in cascade order; check:derived-vars reads
  * them concatenated in that same order, the way a browser does.
  *
- * The rail floats on the transcript's end edge, vertically centred, as a child of the
- * chat host. `:has()` gives the host its containing block only while a rail is inside
- * it — a bare `position: relative` on every chat would have moved any absolutely
- * positioned child a consumer already placed there.
+ * The rail floats on the transcript's end edge as a child of the chat host. `:has()`
+ * gives the host its containing block only while a rail is inside it — a bare
+ * `position: relative` on every chat would have moved any absolutely positioned child
+ * a consumer already placed there.
  *
  * The three shell shapes shell.css already lays out, because an absolute element lands
  * in the nearest POSITIONED ancestor and a shape missing from this list is a rail that
@@ -7284,27 +7287,57 @@ aparte-chat:has(> aparte-scroll-rail),
   position: relative;
 }
 
-/* The block padding is the room the END zones need, and it is not decoration.
-   The rail clips (`overflow: hidden`, which cuts at the PADDING box) and the list has
-   none of its own, so with no padding here the first tick's top edge sits exactly on the
-   clip line. A zone grows symmetrically — half of `hit − thickness` above and below the
-   line — so the first tick would lose its upper half and the last tick its lower half,
-   to paint AND to hit-testing: 13px of the 24px, on the two ticks a reader aims at most
-   ("jump to the first message", "jump to the latest"). Padding by exactly that half puts
-   the clip line outside every zone instead of through the two end ones. `box-sizing`
-   keeps `max-height` measuring the same box it measured before. */
+/* Where the rail sits is measured, not assumed. The element publishes three lengths on
+   itself (aparte-scroll-rail.ts, `_layout`): `--aparte-scroll-rail-bar`, the width of
+   the transcript's scrollbar when it is a classic one — 0 for an overlay bar — so the
+   ticks never sit on the bar under Windows or Linux Chrome; and the two block insets,
+   the transcript's distance from the host's top and bottom edges, so the rail centres
+   on the messages and not on the composer under them. Without a measurement (jsdom, a
+   rail with no transcript yet) the fallbacks centre it on the host, where it used to be.
+
+   It is a LIST of ticks, not a minimap: it takes the height of its list, capped at a
+   share of the transcript (`--aparte-scroll-rail-share`, .6), and sits centred on the
+   transcript's span — its top is the middle of that span, pulled back by half its own
+   height. Measured on the market: every per-turn rail that ships as a list caps itself
+   (LobeChat at 50vh), and every full-height strip is a proportional minimap with a
+   viewport window, a different component; a list stretched to the full transcript read
+   as the second while behaving as the first.
+
+   The block padding is the room the END zones need, and it is not decoration.
+   The rail clips the list at its padding box, and the list has no padding of its own,
+   so with no padding here the first tick's top edge sits exactly on the clip line. A
+   zone grows symmetrically — half of `hit − thickness` above and below the line — so
+   the first tick would lose its upper half and the last tick its lower half, to paint
+   AND to hit-testing: 13px of the 24px, on the two ticks a reader aims at most ("jump
+   to the first message", "jump to the latest"). Padding by exactly that half puts the
+   clip line outside every zone instead of through the two end ones. `box-sizing` keeps
+   `max-height` measuring the same box it measured before.
+
+   When more ticks exist than 24px targets fit in the cap, the element tightens the
+   pitch by setting `--aparte-scroll-rail-hit-size` on itself (never under 6px), and
+   gap, padding and zone follow it here as they would a consumer's value. Past that
+   floor the list still overflows, and the rail scrolls — the element keeps the current
+   tick in its window, the arrows walk every tick, a wheel over the rail slides it —
+   with no bar of its own: a 24px column showing a scrollbar would be all bar. */
 aparte-scroll-rail {
   position: absolute;
-  inset-inline-end: var(--aparte-space-2);
-  top: 50%;
+  inset-inline-end: calc(var(--aparte-space-2) + var(--aparte-scroll-rail-bar, 0px));
+  top: calc(var(--aparte-scroll-rail-block-start, 0px) + (100% - var(--aparte-scroll-rail-block-start, 0px) - var(--aparte-scroll-rail-block-end, 0px)) / 2);
   transform: translateY(-50%);
   z-index: var(--aparte-z-floating);
-  display: block;
+  display: flex;
+  flex-direction: column;
   box-sizing: border-box;
   width: var(--aparte-scroll-rail-width);
   padding-block: calc((var(--aparte-scroll-rail-hit-size) - var(--aparte-scroll-rail-tick-thickness)) / 2);
-  max-height: calc(100% - 2 * var(--aparte-space-8));
-  overflow: hidden;
+  max-height: calc((100% - var(--aparte-scroll-rail-block-start, 0px) - var(--aparte-scroll-rail-block-end, 0px)) * var(--aparte-scroll-rail-share));
+  overflow-x: hidden;
+  overflow-y: auto;
+  scrollbar-width: none;
+}
+
+aparte-scroll-rail::-webkit-scrollbar {
+  display: none;
 }
 
 aparte-scroll-rail[hidden],
@@ -7319,6 +7352,7 @@ aparte-scroll-rail[data-empty] {
   display: flex;
   flex-direction: column;
   align-items: flex-end;
+  flex-shrink: 0;
   gap: var(--aparte-scroll-rail-gap);
 }
 
@@ -7350,10 +7384,10 @@ aparte-scroll-rail[data-empty] {
    Block: grow symmetrically to the hit size. The gap is `hit − thickness`, so the pitch
    is exactly the hit size and two zones meet without overlapping — and the rail pads its
    block axis by the same half-growth, so the clip does not eat the first and last zone.
-   Inline: grow INWARD only. The rail clips (`overflow: hidden`) and ticks are
-   end-aligned, so a centred zone would hang past the end edge and come back cut to
-   19px; anchored to the tick's end edge it stays whole, and the rail's width carries
-   the hit size as its floor so the column has room for it. */
+   Inline: grow INWARD only. The rail clips and ticks are end-aligned, so a centred zone
+   would hang past the end edge and come back cut to 19px; anchored to the tick's end
+   edge it stays whole, and the rail's width carries the hit size as its floor so the
+   column has room for it. */
 .aparte-scroll-rail__tick::before {
   content: "";
   position: absolute;

package/dist/index.d.ts

@@ -84,7 +84,7 @@ export { AparteConversationList } from './components/index.js';
 export type { AparteConversationListItem, AparteConversationSelectDetail, AparteConversationDeleteDetail, AparteConversationArchiveDetail, AparteConversationPinDetail, AparteConversationRenameDetail } from './components/index.js';
 export type { AparteConversation, AparteConversationMeta, AparteStorageAdapter, AparteAttachmentRow, } from './conversations/index.js';
 export { APARTE_CONVERSATION_SCHEMA_VERSION } from './conversations/index.js';
-export { AparteConversationManager, type ConversationManagerOptions } from './conversations/index.js';
+export { AparteConversationManager, type ConversationManagerOptions, type AparteConversationTitleProvider, } from './conversations/index.js';
 export { AparteConversationController, type AparteChatBinding, type AparteConversationControllerOptions, } from './conversations/index.js';
 export { AparteChatHost, type AparteChatHostBinding, type AparteChatHostOptions, } from './host/index.js';
 export { AparteStreamParser, parseMarkdownToSegments } from './parsers/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,5 +1,5 @@
-import { $ as resolveConfig, a4 as subscribeConfigChange, a1 as runWithConfig, o as AparteElicitationAbortError, w as buildApprovalPanel, x as buildElicitationPanel, J as escapeAttr, F as cssEscape, a7 as mergeSegmentUpdate, K as escapeHtml, a8 as writeStreamedMarkdown, C as copyText, N as getSegmentRenderer, O as installDefaultRenderersOnce, r as AparteMessageRepository, a9 as stampSegmentActivity, aa as stampSegmentOnInsert, ab as stampSegmentOnUpdate, ac as renumberSegments, ad as openSegmentIds, ae as isTerminalStatus, af as adoptMessageSegments, Q as isAwaitingReply, W as populateBubbleFromMessage, a6 as uuid, a0 as revokeAttachmentUrls, e as APARTE_DEFAULT_LOCALE, P as installDialogTriggersOnce } from "./dialog-triggers-CApC7K1I.js";
-import { A, a, b, c, d, f, g, h, i, j, k, l, m, n, p, q, s, t, u, v, y, z, B, D, E, G, H, I, L, M, R, S, T, U, V, X, Y, Z, _, a2, a3, a5 } from "./dialog-triggers-CApC7K1I.js";
+import { $ as resolveConfig, a4 as subscribeConfigChange, a1 as runWithConfig, o as AparteElicitationAbortError, w as buildApprovalPanel, x as buildElicitationPanel, J as escapeAttr, F as cssEscape, a7 as mergeSegmentUpdate, K as escapeHtml, a8 as writeStreamedMarkdown, C as copyText, N as getSegmentRenderer, O as installDefaultRenderersOnce, r as AparteMessageRepository, a9 as stampSegmentActivity, aa as stampSegmentOnInsert, ab as stampSegmentOnUpdate, ac as renumberSegments, ad as openSegmentIds, ae as isTerminalStatus, af as adoptMessageSegments, Q as isAwaitingReply, W as populateBubbleFromMessage, a6 as uuid, a0 as revokeAttachmentUrls, e as APARTE_DEFAULT_LOCALE, P as installDialogTriggersOnce } from "./dialog-triggers-cYGTlfZf.js";
+import { A, a, b, c, d, f, g, h, i, j, k, l, m, n, p, q, s, t, u, v, y, z, B, D, E, G, H, I, L, M, R, S, T, U, V, X, Y, Z, _, a2, a3, a5 } from "./dialog-triggers-cYGTlfZf.js";
 function presenceOn(value) {
   return value === "" ? true : Boolean(value);
 }
@@ -3470,11 +3470,18 @@ class AparteChatViewport extends HTMLElement {
       });
     }
   }
-  /** The overlay shell's element children that are not this viewport — the floating bottom stack. */
+  /**
+   * The overlay shell's element children that are the floating bottom stack: not this
+   * viewport, and not the scroll rail, which floats over the transcript by design —
+   * shell.css names it the same way (`:not(aparte-chat-viewport, aparte-scroll-rail)`).
+   * Counted, a rail centred on the transcript set the inset to the distance from its
+   * own top edge (398px on the vanilla example) and held it there while the composer
+   * grew under a draft.
+   */
   _overlayStack() {
     if (!this._overlayRoot) return [];
     return Array.from(this._overlayRoot.children).filter(
-      (el2) => el2 instanceof HTMLElement && el2 !== this
+      (el2) => el2 instanceof HTMLElement && el2 !== this && el2.tagName.toLowerCase() !== "aparte-scroll-rail"
     );
   }
   /**
@@ -5882,18 +5889,40 @@ if (!customElements.get("aparte-context")) {
   customElements.define("aparte-context", AparteContext);
 }
 const EXCERPT_LENGTH = 60;
+const MIN_PITCH = 6;
+const SETTLE_MS = 150;
+const MAX_ALIGN_PASSES = 4;
+const ALIGN_TOLERANCE = 1;
 class AparteScrollRail extends HTMLElement {
   static get observedAttributes() {
     return ["target", "every"];
   }
   _host = null;
   _mutations = null;
+  _resizes = null;
   _intersections = null;
+  /** The bubbles the intersection observer watches — compared by identity, so a re-rendered bubble is re-observed. */
+  _observedBubbles = [];
+  /** The scroll surface the observer is rooted on, and whose bottom edge is read. */
+  _observedSurface = null;
   _rebuildQueued = false;
+  _pickQueued = false;
   _currentId = null;
-  /** Visible ratio per message id, from the intersection observer. */
+  /** Visible ratio per message id in the reading band, from the intersection observer. */
   _visible = /* @__PURE__ */ new Map();
+  /** The bubbles on screen at all, from the second observer; only the last one is read. */
+  _onScreen = /* @__PURE__ */ new Set();
+  _onScreenObserver = null;
+  /** The mark a jump asked for, held until the transcript has stopped moving. */
+  _held = null;
+  _settleTimer = null;
+  _settleSurface = null;
+  /** Re-alignments done for the jump in flight. */
+  _alignPasses = 0;
+  /** The custom properties written on this element, so each is written only when it changes. */
+  _written = /* @__PURE__ */ new Map();
   _onConfigChange = () => this._rebuild();
+  _onSurfaceScroll = () => this._bumpSettle();
   /** The id of the message the rail currently marks, or `null`. */
   get currentMessageId() {
     return this._currentId;
@@ -5937,17 +5966,26 @@ class AparteScrollRail extends HTMLElement {
       return;
     }
     if (typeof MutationObserver !== "undefined") {
-      this._mutations = new MutationObserver(() => this._queueRebuild());
+      this._mutations = new MutationObserver((records) => {
+        if (records.some((record) => !this.contains(record.target))) this._queueRebuild();
+      });
       this._mutations.observe(this._host, { childList: true, subtree: true, characterData: true });
     }
+    if (typeof ResizeObserver !== "undefined") {
+      this._resizes = new ResizeObserver(() => this._layout());
+      this._resizes.observe(this._host);
+      const viewport = this._viewport();
+      if (viewport) this._resizes.observe(viewport);
+    }
     this._rebuild();
   }
   _detach() {
     this._mutations?.disconnect();
     this._mutations = null;
-    this._intersections?.disconnect();
-    this._intersections = null;
-    this._visible.clear();
+    this._resizes?.disconnect();
+    this._resizes = null;
+    this._unobserve();
+    this._release();
     this._host = null;
   }
   /** Coalesce a burst of mutations (a streaming reply is one per token) into one rebuild. */
@@ -5988,6 +6026,15 @@ class AparteScrollRail extends HTMLElement {
     const excerpt = this._excerpt(bubble);
     return excerpt ? `${role}: ${excerpt}` : role;
   }
+  _list() {
+    return this.querySelector(":scope > .aparte-scroll-rail__list");
+  }
+  /**
+   * Reconcile the ticks with the bubbles, by message id. A tick that already exists is
+   * kept — the same node, so the focus on it, its hover and its tooltip survive a turn
+   * being appended or a reply streaming beside it — moved only when its order changed,
+   * and dropped when its bubble left.
+   */
   _rebuild() {
     const bubbles = this._bubbles();
     const locale = resolveConfig(this).getLocale();
@@ -5995,45 +6042,71 @@ class AparteScrollRail extends HTMLElement {
     if (bubbles.length < 2) {
       this.setAttribute("data-empty", "");
       this.replaceChildren();
-      this._intersections?.disconnect();
-      this._intersections = null;
-      this._visible.clear();
+      this._unobserve();
       this._currentId = null;
+      this._write("--aparte-scroll-rail-hit-size", "");
       return;
     }
     this.removeAttribute("data-empty");
-    const list = document.createElement("ol");
-    list.className = "aparte-scroll-rail__list";
+    let list = this._list();
+    if (!list) {
+      list = document.createElement("ol");
+      list.className = "aparte-scroll-rail__list";
+      this.replaceChildren(list);
+    }
+    const existing = /* @__PURE__ */ new Map();
+    for (const item of Array.from(list.children)) {
+      const id = item.firstElementChild instanceof HTMLElement ? item.firstElementChild.dataset["messageId"] : void 0;
+      if (id) existing.set(id, item);
+    }
     const known = /* @__PURE__ */ new Set();
+    let index = 0;
     for (const bubble of bubbles) {
       const id = bubble.getAttribute("message-id");
       known.add(id);
-      const item = document.createElement("li");
-      const tick = document.createElement("button");
-      tick.type = "button";
-      tick.className = "aparte-scroll-rail__tick";
-      tick.dataset["messageId"] = id;
+      let item = existing.get(id);
+      if (item) {
+        existing.delete(id);
+      } else {
+        item = document.createElement("li");
+        const tick2 = document.createElement("button");
+        tick2.type = "button";
+        tick2.className = "aparte-scroll-rail__tick";
+        tick2.dataset["messageId"] = id;
+        item.appendChild(tick2);
+      }
+      const tick = item.firstElementChild;
       const label = this._tickLabel(bubble);
-      tick.setAttribute("aria-label", label);
-      tick.title = label;
+      if (tick.getAttribute("aria-label") !== label) {
+        tick.setAttribute("aria-label", label);
+        tick.title = label;
+      }
       if (id === this._currentId) tick.setAttribute("aria-current", "true");
-      item.appendChild(tick);
-      list.appendChild(item);
+      else tick.removeAttribute("aria-current");
+      const at = list.children[index] ?? null;
+      if (at !== item) list.insertBefore(item, at);
+      index++;
     }
-    this.replaceChildren(list);
+    for (const stale of existing.values()) stale.remove();
     if (this._currentId && !known.has(this._currentId)) this._currentId = null;
-    this._observe(bubbles);
+    if (!sameElements(this._observedBubbles, bubbles)) this._observe(bubbles);
+    this._layout();
   }
   /**
-   * Which tick is current is read, not computed: the scroll surface is the root, and
-   * the bubble with the largest visible share of a reading band near the top wins.
-   * Scroll arithmetic was the alternative, and every scroll-position rule in the
-   * viewport carries a regression note — this one has none to carry.
+   * Which tick is current is read, not computed: the scroll surface is the root and an
+   * intersection observer reports which bubbles reach a reading band — the top 30% of
+   * the surface, from its very top so that the bubble a jump aligned there counts. The
+   * rule is a scrollspy's: the LAST question that has reached the band is the one the
+   * reader is under. "The largest visible share" was the rule before, and at the bottom
+   * of a thread of short turns, where three questions sit in the band, it named the
+   * first of them. Scroll arithmetic was the alternative, and every scroll-position
+   * rule in the viewport carries a regression note; the one read here is the bottom,
+   * because at the bottom the reader is under the latest question whatever the band
+   * holds, and the observer has nothing to report on the last few pixels.
    */
   _observe(bubbles) {
-    this._intersections?.disconnect();
-    this._intersections = null;
-    this._visible.clear();
+    this._unobserve();
+    this._observedBubbles = bubbles;
     if (typeof IntersectionObserver === "undefined") return;
     const root = this._scrollSurface();
     if (!root) return;
@@ -6042,30 +6115,142 @@ class AparteScrollRail extends HTMLElement {
         const id = entry.target.getAttribute("message-id");
         if (id) this._visible.set(id, entry.isIntersecting ? entry.intersectionRatio : 0);
       }
-      this._pickCurrent(bubbles);
-    }, { root, rootMargin: "-15% 0px -55% 0px", threshold: [0, 0.1, 0.25, 0.5, 0.75, 1] });
-    for (const bubble of bubbles) this._intersections.observe(bubble);
+      this._pickCurrent();
+    }, { root, rootMargin: "0px 0px -70% 0px", threshold: [0, 0.1, 0.25, 0.5, 0.75, 1] });
+    this._onScreenObserver = new IntersectionObserver((entries) => {
+      for (const entry of entries) {
+        const id = entry.target.getAttribute("message-id");
+        if (!id) continue;
+        if (entry.isIntersecting) this._onScreen.add(id);
+        else this._onScreen.delete(id);
+      }
+      this._pickCurrent();
+    }, { root, threshold: [0] });
+    for (const bubble of bubbles) {
+      this._intersections.observe(bubble);
+      this._onScreenObserver.observe(bubble);
+    }
+    this._observedSurface = root;
+    root.addEventListener("scroll", this._onRootScroll, { passive: true });
   }
-  _pickCurrent(bubbles) {
-    let best = null;
-    let bestRatio = 0;
+  _unobserve() {
+    this._intersections?.disconnect();
+    this._intersections = null;
+    this._onScreenObserver?.disconnect();
+    this._onScreenObserver = null;
+    this._observedSurface?.removeEventListener("scroll", this._onRootScroll);
+    this._observedSurface = null;
+    this._observedBubbles = [];
+    this._visible.clear();
+    this._onScreen.clear();
+  }
+  /** A scroll only matters at the bottom edge, where the observer is silent: one pick per frame. */
+  _onRootScroll = () => {
+    if (this._pickQueued) return;
+    this._pickQueued = true;
+    requestAnimationFrame(() => {
+      this._pickQueued = false;
+      this._pickCurrent();
+    });
+  };
+  /** At the bottom edge of a surface that scrolls; a surface with nothing to scroll has no bottom to be at. */
+  _atBottom() {
+    const surface = this._observedSurface;
+    if (!surface) return false;
+    const max = surface.scrollHeight - surface.clientHeight;
+    return max > 0 && max - surface.scrollTop <= 2;
+  }
+  _pickCurrent() {
+    if (this._held) return;
+    const bubbles = this._observedBubbles;
+    if (bubbles.length === 0) return;
+    const lastId = bubbles[bubbles.length - 1].getAttribute("message-id");
+    if (this._atBottom() || this._onScreen.has(lastId)) {
+      this._setCurrent(lastId);
+      return;
+    }
+    let last = null;
     for (const bubble of bubbles) {
       const id = bubble.getAttribute("message-id");
-      const ratio = this._visible.get(id) ?? 0;
-      if (ratio > bestRatio) {
-        bestRatio = ratio;
-        best = id;
-      }
+      if ((this._visible.get(id) ?? 0) > 0) last = id;
     }
-    if (best !== null) this._setCurrent(best);
+    if (last !== null) this._setCurrent(last);
   }
   _setCurrent(id) {
     if (this._currentId === id) return;
     this._currentId = id;
     for (const tick of this.querySelectorAll(".aparte-scroll-rail__tick")) {
-      if (tick.dataset["messageId"] === id) tick.setAttribute("aria-current", "true");
-      else tick.removeAttribute("aria-current");
+      if (tick.dataset["messageId"] === id) {
+        tick.setAttribute("aria-current", "true");
+        this._reveal(tick);
+      } else {
+        tick.removeAttribute("aria-current");
+      }
+    }
+  }
+  /** Past the floor the rail scrolls itself: the current tick is kept inside its window. */
+  _reveal(tick) {
+    const room = this.clientHeight;
+    if (!room) return;
+    const top = tick.offsetTop;
+    const bottom = top + tick.offsetHeight;
+    if (top < this.scrollTop) this.scrollTop = top;
+    else if (bottom > this.scrollTop + room) this.scrollTop = bottom - room;
+  }
+  // ─── Geometry ─────────────────────────────────────────────────────────
+  /** Write a custom property on this element only when its value changed; '' removes it. */
+  _write(name, value) {
+    if (this._written.get(name) === value) return;
+    this._written.set(name, value);
+    if (value) this.style.setProperty(name, value);
+    else this.style.removeProperty(name);
+  }
+  /**
+   * The three measurements the stylesheet positions the rail by, and the pitch.
+   *
+   * The scrollbar: `offsetWidth − clientWidth` of the scroll surface is the width of a
+   * classic bar and 0 for an overlay one, so the rail sits clear of the bar exactly
+   * where there is one. The extent: the transcript's box within the host, so the rail
+   * spans the messages and not the composer under them. The pitch: the stylesheet's
+   * 24px targets whenever `count × 24` fits the rail; otherwise the pitch that does,
+   * never under `MIN_PITCH` — the rail sets `--aparte-scroll-rail-hit-size` on itself
+   * and the gap, the padding and the zone all follow it, as they do for a consumer's
+   * value. Past the floor the rail scrolls (`_reveal`), and the arrows still walk it.
+   */
+  _layout() {
+    const host = this._host;
+    const viewport = this._viewport();
+    const surface = this._scrollSurface();
+    if (host && surface) {
+      this._write("--aparte-scroll-rail-bar", `${Math.max(0, surface.offsetWidth - surface.clientWidth)}px`);
+    }
+    if (host && viewport) {
+      const v2 = viewport.getBoundingClientRect();
+      const h2 = host.getBoundingClientRect();
+      if (v2.height > 0 && h2.height > 0) {
+        this._write("--aparte-scroll-rail-block-start", `${Math.max(0, Math.round(v2.top - h2.top))}px`);
+        this._write("--aparte-scroll-rail-block-end", `${Math.max(0, Math.round(h2.bottom - v2.bottom))}px`);
+      }
+    }
+    const count = this._list()?.children.length ?? 0;
+    const height = this.clientHeight;
+    if (!count || !height) {
+      this._write("--aparte-scroll-rail-hit-size", "");
+      this._write("--aparte-scroll-rail-gap", "");
+      return;
+    }
+    const above = host ?? document.documentElement;
+    const aboveStyle = getComputedStyle(above);
+    const hit = parseFloat(aboveStyle.getPropertyValue("--aparte-scroll-rail-hit-size")) || 24;
+    const thickness = parseFloat(aboveStyle.getPropertyValue("--aparte-scroll-rail-tick-thickness")) || 2;
+    if (count * hit <= height) {
+      this._write("--aparte-scroll-rail-hit-size", "");
+      this._write("--aparte-scroll-rail-gap", "");
+      return;
     }
+    const pitch = Math.max(MIN_PITCH, Math.floor(height / count));
+    this._write("--aparte-scroll-rail-hit-size", `${pitch}px`);
+    this._write("--aparte-scroll-rail-gap", `${Math.max(0, pitch - thickness)}px`);
   }
   // ─── Interaction ──────────────────────────────────────────────────────
   _onClick = (e) => {
@@ -6088,6 +6273,16 @@ class AparteScrollRail extends HTMLElement {
   /**
    * Scroll the transcript to a message. Announced first, cancelable; then a
    * `scrollIntoView` on the bubble, smooth unless the reader prefers reduced motion.
+   * The clicked tick is the mark until the transcript has stopped moving: while a
+   * smooth scroll crosses other questions the band would name each in turn, and it
+   * ended on the wrong one two times in three before this hold.
+   *
+   * Where the scroll lands is checked once it has settled, and corrected. The bubbles
+   * carry `content-visibility: auto`, so a bubble far from the reader has an estimated
+   * height until it is rendered: the scroll aims at an estimate, the bubbles above it
+   * take their real size on the way, and the message ends up above or below the top —
+   * measured from 36px to 1,213px off, in all three engines, the further the worse.
+   * A second `scrollIntoView` from a rendered neighbourhood lands; a few are allowed.
    */
   jumpTo(messageId) {
     const announced = this.dispatchEvent(new CustomEvent("aparte-scroll-rail-jump", {
@@ -6097,13 +6292,61 @@ class AparteScrollRail extends HTMLElement {
       cancelable: true
     }));
     if (!announced) return;
-    const viewport = this._viewport();
-    const bubble = viewport?.querySelector(`aparte-chat-bubble[message-id="${cssEscape(messageId)}"]`);
+    const bubble = this._bubbleOf(messageId);
     if (!bubble) return;
+    this._scrollTo(bubble);
+    this._setCurrent(messageId);
+    this._hold(messageId);
+  }
+  _bubbleOf(messageId) {
+    return this._viewport()?.querySelector(`aparte-chat-bubble[message-id="${cssEscape(messageId)}"]`) ?? null;
+  }
+  _scrollTo(bubble) {
     const reduced = typeof matchMedia === "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
     bubble.scrollIntoView({ block: "start", behavior: reduced ? "auto" : "smooth" });
-    this._setCurrent(messageId);
   }
+  /** Keep `id` as the mark until the scroll surface has been still for `SETTLE_MS`. */
+  _hold(id) {
+    this._release();
+    this._held = id;
+    this._alignPasses = 0;
+    this._settleSurface = this._scrollSurface();
+    this._settleSurface?.addEventListener("scroll", this._onSurfaceScroll);
+    this._bumpSettle();
+  }
+  _bumpSettle() {
+    if (this._settleTimer !== null) clearTimeout(this._settleTimer);
+    this._settleTimer = setTimeout(() => this._settle(), SETTLE_MS);
+  }
+  /** The transcript is still: land on the message if the scroll did not, else release the hold. */
+  _settle() {
+    const id = this._held;
+    const surface = this._settleSurface;
+    const bubble = id ? this._bubbleOf(id) : null;
+    if (id && bubble && surface && this._alignPasses < MAX_ALIGN_PASSES) {
+      const off = bubble.getBoundingClientRect().top - surface.getBoundingClientRect().top;
+      if (Math.abs(off) > ALIGN_TOLERANCE) {
+        this._alignPasses++;
+        this._scrollTo(bubble);
+        this._bumpSettle();
+        return;
+      }
+    }
+    this._release();
+    if (id) this._setCurrent(id);
+  }
+  _release() {
+    if (this._settleTimer !== null) clearTimeout(this._settleTimer);
+    this._settleTimer = null;
+    this._settleSurface?.removeEventListener("scroll", this._onSurfaceScroll);
+    this._settleSurface = null;
+    this._held = null;
+  }
+}
+function sameElements(a4, b2) {
+  if (a4.length !== b2.length) return false;
+  for (let i2 = 0; i2 < a4.length; i2++) if (a4[i2] !== b2[i2]) return false;
+  return true;
 }
 if (!customElements.get("aparte-scroll-rail")) {
   customElements.define("aparte-scroll-rail", AparteScrollRail);