stimeo-ui 0.11.0 → 0.12.0

package/dist/controllers/reading_progress_controller.js

@@ -1,12 +1,158 @@
 import { Controller } from '@hotwired/stimulus';
 
+// src/controllers/reading_progress_controller.ts
+
+// src/utils/before_cache_reset.ts
+var BeforeCacheReset = class _BeforeCacheReset {
+  /** Every subscribed instance, iterated by the one shared document listener. */
+  static #subscribers = /* @__PURE__ */ new Set();
+  /** The shared listener; installed while at least one instance is subscribed. */
+  static #onBeforeCache = () => {
+    for (const subscriber of _BeforeCacheReset.#subscribers) subscriber.#rewind();
+  };
+  #rewind;
+  /** @param rewind - the pass that returns this controller's state to its initial form. */
+  constructor(rewind) {
+    this.#rewind = rewind;
+  }
+  /** Subscribes to `turbo:before-cache`; call from `connect()`. Idempotent. */
+  activate() {
+    const first = _BeforeCacheReset.#subscribers.size === 0;
+    _BeforeCacheReset.#subscribers.add(this);
+    if (first) {
+      document.addEventListener("turbo:before-cache", _BeforeCacheReset.#onBeforeCache);
+    }
+  }
+  /** Unsubscribes; call from `disconnect()`. Safe when never subscribed. */
+  deactivate() {
+    _BeforeCacheReset.#subscribers.delete(this);
+    if (_BeforeCacheReset.#subscribers.size > 0) return;
+    document.removeEventListener("turbo:before-cache", _BeforeCacheReset.#onBeforeCache);
+  }
+};
+
+// src/utils/layout_observer.ts
+var LayoutObserver = class {
+  #callback;
+  #resizeObserverFactory;
+  #resizeObserver = null;
+  #observingViewport = false;
+  /** Stable bound handler so add/removeEventListener target the same reference. */
+  #handleViewportResize = () => {
+    this.#callback();
+  };
+  constructor(callback, options = {}) {
+    this.#callback = callback;
+    this.#resizeObserverFactory = options.resizeObserverFactory ?? (typeof ResizeObserver === "undefined" ? null : (cb) => new ResizeObserver(cb));
+  }
+  /**
+   * Starts observing an element's size. Repeated calls observe additional
+   * elements through the same shared observer. No-ops when no
+   * `ResizeObserver` implementation is available.
+   */
+  observe(element) {
+    if (!this.#resizeObserverFactory) return;
+    if (!this.#resizeObserver) {
+      this.#resizeObserver = this.#resizeObserverFactory(() => {
+        this.#callback();
+      });
+    }
+    this.#resizeObserver.observe(element);
+  }
+  /** Stops observing a single element while leaving any others in place. */
+  unobserve(element) {
+    this.#resizeObserver?.unobserve(element);
+  }
+  /** Starts observing viewport resizes. Idempotent: the listener is added once. */
+  observeViewport() {
+    if (this.#observingViewport) return;
+    this.#observingViewport = true;
+    window.addEventListener("resize", this.#handleViewportResize);
+  }
+  /** Stops observing viewport resizes without affecting element observation. */
+  unobserveViewport() {
+    if (!this.#observingViewport) return;
+    this.#observingViewport = false;
+    window.removeEventListener("resize", this.#handleViewportResize);
+  }
+  /**
+   * Releases every observation: disconnects the {@link ResizeObserver} and
+   * removes the viewport listener. Safe to call multiple times. Call this from a
+   * controller's `disconnect()`.
+   */
+  disconnect() {
+    this.#resizeObserver?.disconnect();
+    this.#resizeObserver = null;
+    this.unobserveViewport();
+  }
+};
+
+// src/utils/style_property_lease.ts
+var StylePropertyLease = class {
+  #property;
+  #records = /* @__PURE__ */ new Map();
+  /** @param property - The CSS property whose temporary values this lease owns. */
+  constructor(property) {
+    this.#property = property;
+  }
+  /** Writes or removes the leased declaration while preserving its authored value. */
+  write(element, value, priority = "") {
+    const existing = this.#records.get(element);
+    if (existing) {
+      existing.writtenValue = value;
+      existing.writtenPriority = value === null ? "" : priority;
+    } else {
+      this.#records.set(element, {
+        originalValue: element.style.getPropertyValue(this.#property),
+        originalPriority: element.style.getPropertyPriority(this.#property),
+        writtenValue: value,
+        writtenPriority: value === null ? "" : priority
+      });
+    }
+    this.#reflect(element, value, priority);
+  }
+  /** Returns one lease without overwriting a later consumer declaration. */
+  return(element) {
+    const record = this.#records.get(element);
+    if (!record) return;
+    this.#records.delete(element);
+    const style = element.style;
+    const stillOwned = style.getPropertyValue(this.#property) === (record.writtenValue ?? "") && style.getPropertyPriority(this.#property) === record.writtenPriority;
+    if (stillOwned) {
+      this.#reflect(element, record.originalValue, record.originalPriority);
+    }
+  }
+  /** Returns every outstanding declaration lease. */
+  returnAll() {
+    for (const element of Array.from(this.#records.keys())) this.return(element);
+  }
+  /** Reflects only a real declaration transition. */
+  #reflect(element, value, priority) {
+    const style = element.style;
+    const nextValue = value ?? "";
+    const nextPriority = value === null ? "" : priority;
+    if (style.getPropertyValue(this.#property) === nextValue && style.getPropertyPriority(this.#property) === nextPriority) {
+      return;
+    }
+    if (value === null) style.removeProperty(this.#property);
+    else style.setProperty(this.#property, value, priority);
+  }
+};
+
 // src/controllers/reading_progress_controller.ts
 var PROGRESS_PROPERTY = "--stimeo--reading-progress";
 var ReadingProgressController = class extends Controller {
   static events = ["change", "complete"];
+  /** Owns both faces of the published property so teardown can hand them back. */
+  #lease = new StylePropertyLease(PROGRESS_PROPERTY);
+  /** The article's own box and the viewport: either changes the span. */
+  #layout = new LayoutObserver(() => this.#onScroll());
+  #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());
   #frame = null;
   /** Last published progress, so `change`/`complete` fire only on movement. */
   #progress = -1;
+  /** False until the connect frame has run: `complete` needs real reading. */
+  #baselined = false;
   #onScroll = () => {
     if (this.#frame !== null) return;
     this.#frame = requestAnimationFrame(() => {
@@ -16,20 +162,45 @@ var ReadingProgressController = class extends Controller {
   };
   connect() {
     this.#progress = -1;
+    this.#baselined = false;
     window.addEventListener("scroll", this.#onScroll, { passive: true, capture: true });
-    window.addEventListener("resize", this.#onScroll, { passive: true });
+    this.#layout.observe(this.element);
+    this.#layout.observeViewport();
+    this.#beforeCache.activate();
     this.#measure();
+    this.#frame = requestAnimationFrame(() => {
+      this.#frame = null;
+      this.#measure();
+      this.#baselined = true;
+    });
   }
   disconnect() {
     window.removeEventListener("scroll", this.#onScroll, { capture: true });
-    window.removeEventListener("resize", this.#onScroll);
+    this.#layout.disconnect();
+    this.#beforeCache.deactivate();
+    this.#cancelFrame();
+    this.#lease.returnAll();
+  }
+  /**
+   * Hands both declarations back before the page is snapshotted, so a restored
+   * page starts from the authored DOM rather than from someone else's progress.
+   * The baseline goes back with them: a cancelled visit leaves this page on
+   * screen, and the next measurement has to publish afresh rather than match a
+   * value that has already been handed back.
+   */
+  #rewindForCache() {
+    this.#cancelFrame();
+    this.#lease.returnAll();
+    this.#progress = -1;
+  }
+  #cancelFrame() {
     if (this.#frame !== null) cancelAnimationFrame(this.#frame);
     this.#frame = null;
-    document.documentElement.style.removeProperty(PROGRESS_PROPERTY);
   }
   /** Computes and publishes the progress; emits on movement only. */
   #measure() {
     const rect = this.element.getBoundingClientRect();
+    if (rect.width === 0 && rect.height === 0) return;
     const span = rect.height - window.innerHeight;
     const raw = span > 0 ? -rect.top / span : rect.top <= 0 ? 1 : 0;
     const progress = Math.min(1, Math.max(0, raw));
@@ -37,10 +208,10 @@ var ReadingProgressController = class extends Controller {
     const previous = this.#progress;
     this.#progress = progress;
     const value = String(progress);
-    this.element.style.setProperty(PROGRESS_PROPERTY, value);
-    document.documentElement.style.setProperty(PROGRESS_PROPERTY, value);
+    this.#lease.write(this.element, value);
+    this.#lease.write(document.documentElement, value);
     this.dispatch("change", { detail: { progress } });
-    if (progress === 1 && previous !== -1) this.dispatch("complete");
+    if (progress === 1 && previous !== -1 && this.#baselined) this.dispatch("complete");
   }
 };
 

package/dist/controllers/reading_progress_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/reading_progress_controller.ts"],"names":[],"mappings":";;;AAGA,IAAM,iBAAA,GAAoB,4BAAA;AAoCnB,IAAM,yBAAA,GAAN,cAAwC,UAAA,CAAwB;AAAA,EACrE,OAAO,MAAA,GAAS,CAAC,QAAA,EAAU,UAAU,CAAA;AAAA,EAErC,MAAA,GAAwB,IAAA;AAAA;AAAA,EAExB,SAAA,GAAY,EAAA;AAAA,EAEH,YAAY,MAAY;AAC/B,IAAA,IAAI,IAAA,CAAK,WAAW,IAAA,EAAM;AAC1B,IAAA,IAAA,CAAK,MAAA,GAAS,sBAAsB,MAAM;AACxC,MAAA,IAAA,CAAK,MAAA,GAAS,IAAA;AACd,MAAA,IAAA,CAAK,QAAA,EAAS;AAAA,IAChB,CAAC,CAAA;AAAA,EACH,CAAA;AAAA,EAES,OAAA,GAAgB;AACvB,IAAA,IAAA,CAAK,SAAA,GAAY,EAAA;AAIjB,IAAA,MAAA,CAAO,gBAAA,CAAiB,UAAU,IAAA,CAAK,SAAA,EAAW,EAAE,OAAA,EAAS,IAAA,EAAM,OAAA,EAAS,IAAA,EAAM,CAAA;AAClF,IAAA,MAAA,CAAO,iBAAiB,QAAA,EAAU,IAAA,CAAK,WAAW,EAAE,OAAA,EAAS,MAAM,CAAA;AACnE,IAAA,IAAA,CAAK,QAAA,EAAS;AAAA,EAChB;AAAA,EAES,UAAA,GAAmB;AAC1B,IAAA,MAAA,CAAO,oBAAoB,QAAA,EAAU,IAAA,CAAK,WAAW,EAAE,OAAA,EAAS,MAAM,CAAA;AACtE,IAAA,MAAA,CAAO,mBAAA,CAAoB,QAAA,EAAU,IAAA,CAAK,SAAS,CAAA;AACnD,IAAA,IAAI,IAAA,CAAK,MAAA,KAAW,IAAA,EAAM,oBAAA,CAAqB,KAAK,MAAM,CAAA;AAC1D,IAAA,IAAA,CAAK,MAAA,GAAS,IAAA;AACd,IAAA,QAAA,CAAS,eAAA,CAAgB,KAAA,CAAM,cAAA,CAAe,iBAAiB,CAAA;AAAA,EACjE;AAAA;AAAA,EAGA,QAAA,GAAiB;AACf,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,OAAA,CAAQ,qBAAA,EAAsB;AAChD,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,MAAA,GAAS,MAAA,CAAO,WAAA;AAElC,IAAA,MAAM,GAAA,GAAM,IAAA,GAAO,CAAA,GAAI,CAAC,IAAA,CAAK,MAAM,IAAA,GAAO,IAAA,CAAK,GAAA,IAAO,CAAA,GAAI,CAAA,GAAI,CAAA;AAC9D,IAAA,MAAM,QAAA,GAAW,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,GAAA,CAAI,CAAA,EAAG,GAAG,CAAC,CAAA;AAC7C,IAAA,IAAI,QAAA,KAAa,KAAK,SAAA,EAAW;AAEjC,IAAA,MAAM,WAAW,IAAA,CAAK,SAAA;AACtB,IAAA,IAAA,CAAK,SAAA,GAAY,QAAA;AACjB,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAQ,CAAA;AAC7B,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,WAAA,CAAY,iBAAA,EAAmB,KAAK,CAAA;AACvD,IAAA,QAAA,CAAS,eAAA,CAAgB,KAAA,CAAM,WAAA,CAAY,iBAAA,EAAmB,KAAK,CAAA;AACnE,IAAA,IAAA,CAAK,SAAS,QAAA,EAAU,EAAE,QAAQ,EAAE,QAAA,IAAY,CAAA;AAChD,IAAA,IAAI,aAAa,CAAA,IAAK,QAAA,KAAa,EAAA,EAAI,IAAA,CAAK,SAAS,UAAU,CAAA;AAAA,EACjE;AACF","file":"reading_progress_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/** Name of the CSS custom property exposing the reading progress (0..1). */\nconst PROGRESS_PROPERTY = \"--stimeo--reading-progress\";\n\n/**\n * Headless **reading progress**: how far the reader has scrolled *through* this\n * element (an article), published as a CSS custom property and a `change`\n * event stream — the classic top-of-page progress bar.\n * `IntersectionObserver` alone cannot express this (the ratio is constant\n * while a tall article scrolls through the viewport), so this controller owns\n * the scroll math; compose with `stimeo--intersection` when you also need\n * enter/exit triggers. Core (zero dependencies).\n *\n * Markup contract (identifier: `stimeo--reading-progress`):\n *   <article data-controller=\"stimeo--reading-progress\">…</article>\n *   <div class=\"progress-bar\" aria-hidden=\"true\"></div>\n *   <!-- .progress-bar { width: calc(var(--stimeo--reading-progress, 0) * 100%); } -->\n *\n * Progress is `0` before the article's top reaches the viewport top and `1`\n * once its bottom fits the viewport: `-top / (height - viewportHeight)`,\n * clamped. The property is written on the controller element **and** on\n * `document.documentElement`, so a fixed bar anywhere in the page can consume\n * it without being a descendant. The `:root` copy makes this a\n * one-instance-per-page contract (two articles would fight last-writer-wins);\n * `complete` fires on *reaching* 1 — a connect-time measurement that is\n * already 1 (e.g. a Turbo restore at the bottom) only establishes the\n * baseline and does not fire it.\n *\n * `change` dispatches `{ progress }`.\n *\n * @remarks\n * Behavior only — the bar itself (and hiding it, e.g. before any scroll) is\n * the consumer's CSS; the progress value carries no ARIA (a decorative\n * indicator — mark the bar `aria-hidden`; a *semantic* progress belongs to\n * `stimeo--progress`). Scroll/resize work is rAF-throttled; the listeners and\n * any pending frame are released and the root custom property removed on\n * `disconnect()` (Turbo navigation included).\n */\nexport class ReadingProgressController extends Controller<HTMLElement> {\n  static events = [\"change\", \"complete\"] as const;\n\n  #frame: number | null = null;\n  /** Last published progress, so `change`/`complete` fire only on movement. */\n  #progress = -1;\n\n  readonly #onScroll = (): void => {\n    if (this.#frame !== null) return;\n    this.#frame = requestAnimationFrame(() => {\n      this.#frame = null;\n      this.#measure();\n    });\n  };\n\n  override connect(): void {\n    this.#progress = -1;\n    // Capture phase: element scrolls do not bubble, but they ARE observable at\n    // the window in capture — so an article inside an overflow container still\n    // drives the progress.\n    window.addEventListener(\"scroll\", this.#onScroll, { passive: true, capture: true });\n    window.addEventListener(\"resize\", this.#onScroll, { passive: true });\n    this.#measure();\n  }\n\n  override disconnect(): void {\n    window.removeEventListener(\"scroll\", this.#onScroll, { capture: true });\n    window.removeEventListener(\"resize\", this.#onScroll);\n    if (this.#frame !== null) cancelAnimationFrame(this.#frame);\n    this.#frame = null;\n    document.documentElement.style.removeProperty(PROGRESS_PROPERTY);\n  }\n\n  /** Computes and publishes the progress; emits on movement only. */\n  #measure(): void {\n    const rect = this.element.getBoundingClientRect();\n    const span = rect.height - window.innerHeight;\n    // Shorter than the viewport: reading it is binary (reached or not).\n    const raw = span > 0 ? -rect.top / span : rect.top <= 0 ? 1 : 0;\n    const progress = Math.min(1, Math.max(0, raw));\n    if (progress === this.#progress) return;\n\n    const previous = this.#progress;\n    this.#progress = progress;\n    const value = String(progress);\n    this.element.style.setProperty(PROGRESS_PROPERTY, value);\n    document.documentElement.style.setProperty(PROGRESS_PROPERTY, value);\n    this.dispatch(\"change\", { detail: { progress } });\n    if (progress === 1 && previous !== -1) this.dispatch(\"complete\");\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/before_cache_reset.ts","../../src/utils/layout_observer.ts","../../src/utils/style_property_lease.ts","../../src/controllers/reading_progress_controller.ts"],"names":[],"mappings":";;;;;AA2CO,IAAM,gBAAA,GAAN,MAAM,iBAAA,CAAiB;AAAA;AAAA,EAE5B,OAAgB,YAAA,mBAAe,IAAI,GAAA,EAAsB;AAAA;AAAA,EAGzD,OAAgB,iBAAiB,MAAY;AAC3C,IAAA,KAAA,MAAW,UAAA,IAAc,iBAAA,CAAiB,YAAA,EAAc,UAAA,CAAW,OAAA,EAAQ;AAAA,EAC7E,CAAA;AAAA,EAES,OAAA;AAAA;AAAA,EAGT,YAAY,MAAA,EAAoB;AAC9B,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AAAA,EACjB;AAAA;AAAA,EAGA,QAAA,GAAiB;AACf,IAAA,MAAM,KAAA,GAAQ,iBAAA,CAAiB,YAAA,CAAa,IAAA,KAAS,CAAA;AACrD,IAAA,iBAAA,CAAiB,YAAA,CAAa,IAAI,IAAI,CAAA;AACtC,IAAA,IAAI,KAAA,EAAO;AACT,MAAA,QAAA,CAAS,gBAAA,CAAiB,oBAAA,EAAsB,iBAAA,CAAiB,cAAc,CAAA;AAAA,IACjF;AAAA,EACF;AAAA;AAAA,EAGA,UAAA,GAAmB;AACjB,IAAA,iBAAA,CAAiB,YAAA,CAAa,OAAO,IAAI,CAAA;AACzC,IAAA,IAAI,iBAAA,CAAiB,YAAA,CAAa,IAAA,GAAO,CAAA,EAAG;AAC5C,IAAA,QAAA,CAAS,mBAAA,CAAoB,oBAAA,EAAsB,iBAAA,CAAiB,cAAc,CAAA;AAAA,EACpF;AACF,CAAA;;;AC1BO,IAAM,iBAAN,MAAqB;AAAA,EACjB,SAAA;AAAA,EACA,sBAAA;AAAA,EACT,eAAA,GAAyC,IAAA;AAAA,EACzC,kBAAA,GAAqB,KAAA;AAAA;AAAA,EAGZ,wBAAwB,MAAY;AAC3C,IAAA,IAAA,CAAK,SAAA,EAAU;AAAA,EACjB,CAAA;AAAA,EAEA,WAAA,CAAY,QAAA,EAA0B,OAAA,GAAiC,EAAC,EAAG;AACzE,IAAA,IAAA,CAAK,SAAA,GAAY,QAAA;AACjB,IAAA,IAAA,CAAK,sBAAA,GACH,OAAA,CAAQ,qBAAA,KACP,OAAO,cAAA,KAAmB,WAAA,GAAc,IAAA,GAAO,CAAC,EAAA,KAAO,IAAI,cAAA,CAAe,EAAE,CAAA,CAAA;AAAA,EACjF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAQ,OAAA,EAAwB;AAC9B,IAAA,IAAI,CAAC,KAAK,sBAAA,EAAwB;AAClC,IAAA,IAAI,CAAC,KAAK,eAAA,EAAiB;AACzB,MAAA,IAAA,CAAK,eAAA,GAAkB,IAAA,CAAK,sBAAA,CAAuB,MAAM;AACvD,QAAA,IAAA,CAAK,SAAA,EAAU;AAAA,MACjB,CAAC,CAAA;AAAA,IACH;AACA,IAAA,IAAA,CAAK,eAAA,CAAgB,QAAQ,OAAO,CAAA;AAAA,EACtC;AAAA;AAAA,EAGA,UAAU,OAAA,EAAwB;AAChC,IAAA,IAAA,CAAK,eAAA,EAAiB,UAAU,OAAO,CAAA;AAAA,EACzC;AAAA;AAAA,EAGA,eAAA,GAAwB;AACtB,IAAA,IAAI,KAAK,kBAAA,EAAoB;AAC7B,IAAA,IAAA,CAAK,kBAAA,GAAqB,IAAA;AAC1B,IAAA,MAAA,CAAO,gBAAA,CAAiB,QAAA,EAAU,IAAA,CAAK,qBAAqB,CAAA;AAAA,EAC9D;AAAA;AAAA,EAGA,iBAAA,GAA0B;AACxB,IAAA,IAAI,CAAC,KAAK,kBAAA,EAAoB;AAC9B,IAAA,IAAA,CAAK,kBAAA,GAAqB,KAAA;AAC1B,IAAA,MAAA,CAAO,mBAAA,CAAoB,QAAA,EAAU,IAAA,CAAK,qBAAqB,CAAA;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,UAAA,GAAmB;AACjB,IAAA,IAAA,CAAK,iBAAiB,UAAA,EAAW;AACjC,IAAA,IAAA,CAAK,eAAA,GAAkB,IAAA;AACvB,IAAA,IAAA,CAAK,iBAAA,EAAkB;AAAA,EACzB;AACF,CAAA;;;AC7FO,IAAM,qBAAN,MAA8D;AAAA,EAC1D,SAAA;AAAA,EACA,QAAA,uBAAe,GAAA,EAAiC;AAAA;AAAA,EAGzD,YAAY,QAAA,EAAkB;AAC5B,IAAA,IAAA,CAAK,SAAA,GAAY,QAAA;AAAA,EACnB;AAAA;AAAA,EAGA,KAAA,CAAM,OAAA,EAAY,KAAA,EAAsB,QAAA,GAAW,EAAA,EAAU;AAC3D,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,OAAO,CAAA;AAC1C,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,QAAA,CAAS,YAAA,GAAe,KAAA;AACxB,MAAA,QAAA,CAAS,eAAA,GAAkB,KAAA,KAAU,IAAA,GAAO,EAAA,GAAK,QAAA;AAAA,IACnD,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,QAAA,CAAS,IAAI,OAAA,EAAS;AAAA,QACzB,aAAA,EAAe,OAAA,CAAQ,KAAA,CAAM,gBAAA,CAAiB,KAAK,SAAS,CAAA;AAAA,QAC5D,gBAAA,EAAkB,OAAA,CAAQ,KAAA,CAAM,mBAAA,CAAoB,KAAK,SAAS,CAAA;AAAA,QAClE,YAAA,EAAc,KAAA;AAAA,QACd,eAAA,EAAiB,KAAA,KAAU,IAAA,GAAO,EAAA,GAAK;AAAA,OACxC,CAAA;AAAA,IACH;AAEA,IAAA,IAAA,CAAK,QAAA,CAAS,OAAA,EAAS,KAAA,EAAO,QAAQ,CAAA;AAAA,EACxC;AAAA;AAAA,EAGA,OAAO,OAAA,EAAkB;AACvB,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,OAAO,CAAA;AACxC,IAAA,IAAI,CAAC,MAAA,EAAQ;AACb,IAAA,IAAA,CAAK,QAAA,CAAS,OAAO,OAAO,CAAA;AAE5B,IAAA,MAAM,QAAQ,OAAA,CAAQ,KAAA;AACtB,IAAA,MAAM,UAAA,GACJ,KAAA,CAAM,gBAAA,CAAiB,IAAA,CAAK,SAAS,CAAA,MAAO,MAAA,CAAO,YAAA,IAAgB,EAAA,CAAA,IACnE,KAAA,CAAM,mBAAA,CAAoB,IAAA,CAAK,SAAS,MAAM,MAAA,CAAO,eAAA;AACvD,IAAA,IAAI,UAAA,EAAY;AACd,MAAA,IAAA,CAAK,QAAA,CAAS,OAAA,EAAS,MAAA,CAAO,aAAA,EAAe,OAAO,gBAAgB,CAAA;AAAA,IACtE;AAAA,EACF;AAAA;AAAA,EAGA,SAAA,GAAkB;AAChB,IAAA,KAAA,MAAW,OAAA,IAAW,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,QAAA,CAAS,MAAM,CAAA,EAAG,IAAA,CAAK,MAAA,CAAO,OAAO,CAAA;AAAA,EAC7E;AAAA;AAAA,EAGA,QAAA,CAAS,OAAA,EAAY,KAAA,EAAsB,QAAA,EAAwB;AACjE,IAAA,MAAM,QAAQ,OAAA,CAAQ,KAAA;AACtB,IAAA,MAAM,YAAY,KAAA,IAAS,EAAA;AAC3B,IAAA,MAAM,YAAA,GAAe,KAAA,KAAU,IAAA,GAAO,EAAA,GAAK,QAAA;AAC3C,IAAA,IACE,KAAA,CAAM,gBAAA,CAAiB,IAAA,CAAK,SAAS,CAAA,KAAM,SAAA,IAC3C,KAAA,CAAM,mBAAA,CAAoB,IAAA,CAAK,SAAS,CAAA,KAAM,YAAA,EAC9C;AACA,MAAA;AAAA,IACF;AACA,IAAA,IAAI,KAAA,KAAU,IAAA,EAAM,KAAA,CAAM,cAAA,CAAe,KAAK,SAAS,CAAA;AAAA,SAClD,KAAA,CAAM,WAAA,CAAY,IAAA,CAAK,SAAA,EAAW,OAAO,QAAQ,CAAA;AAAA,EACxD;AACF,CAAA;;;ACxEA,IAAM,iBAAA,GAAoB,4BAAA;AA6CnB,IAAM,yBAAA,GAAN,cAAwC,UAAA,CAAwB;AAAA,EACrE,OAAO,MAAA,GAAS,CAAC,QAAA,EAAU,UAAU,CAAA;AAAA;AAAA,EAG5B,MAAA,GAAS,IAAI,kBAAA,CAAmB,iBAAiB,CAAA;AAAA;AAAA,EAEjD,UAAU,IAAI,cAAA,CAAe,MAAM,IAAA,CAAK,WAAW,CAAA;AAAA,EACnD,eAAe,IAAI,gBAAA,CAAiB,MAAM,IAAA,CAAK,iBAAiB,CAAA;AAAA,EACzE,MAAA,GAAwB,IAAA;AAAA;AAAA,EAExB,SAAA,GAAY,EAAA;AAAA;AAAA,EAEZ,UAAA,GAAa,KAAA;AAAA,EAEJ,YAAY,MAAY;AAC/B,IAAA,IAAI,IAAA,CAAK,WAAW,IAAA,EAAM;AAC1B,IAAA,IAAA,CAAK,MAAA,GAAS,sBAAsB,MAAM;AACxC,MAAA,IAAA,CAAK,MAAA,GAAS,IAAA;AACd,MAAA,IAAA,CAAK,QAAA,EAAS;AAAA,IAChB,CAAC,CAAA;AAAA,EACH,CAAA;AAAA,EAES,OAAA,GAAgB;AACvB,IAAA,IAAA,CAAK,SAAA,GAAY,EAAA;AACjB,IAAA,IAAA,CAAK,UAAA,GAAa,KAAA;AAIlB,IAAA,MAAA,CAAO,gBAAA,CAAiB,UAAU,IAAA,CAAK,SAAA,EAAW,EAAE,OAAA,EAAS,IAAA,EAAM,OAAA,EAAS,IAAA,EAAM,CAAA;AAClF,IAAA,IAAA,CAAK,OAAA,CAAQ,OAAA,CAAQ,IAAA,CAAK,OAAO,CAAA;AACjC,IAAA,IAAA,CAAK,QAAQ,eAAA,EAAgB;AAC7B,IAAA,IAAA,CAAK,aAAa,QAAA,EAAS;AAC3B,IAAA,IAAA,CAAK,QAAA,EAAS;AAKd,IAAA,IAAA,CAAK,MAAA,GAAS,sBAAsB,MAAM;AACxC,MAAA,IAAA,CAAK,MAAA,GAAS,IAAA;AACd,MAAA,IAAA,CAAK,QAAA,EAAS;AACd,MAAA,IAAA,CAAK,UAAA,GAAa,IAAA;AAAA,IACpB,CAAC,CAAA;AAAA,EACH;AAAA,EAES,UAAA,GAAmB;AAC1B,IAAA,MAAA,CAAO,oBAAoB,QAAA,EAAU,IAAA,CAAK,WAAW,EAAE,OAAA,EAAS,MAAM,CAAA;AACtE,IAAA,IAAA,CAAK,QAAQ,UAAA,EAAW;AACxB,IAAA,IAAA,CAAK,aAAa,UAAA,EAAW;AAC7B,IAAA,IAAA,CAAK,YAAA,EAAa;AAClB,IAAA,IAAA,CAAK,OAAO,SAAA,EAAU;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,eAAA,GAAwB;AACtB,IAAA,IAAA,CAAK,YAAA,EAAa;AAClB,IAAA,IAAA,CAAK,OAAO,SAAA,EAAU;AACtB,IAAA,IAAA,CAAK,SAAA,GAAY,EAAA;AAAA,EACnB;AAAA,EAEA,YAAA,GAAqB;AACnB,IAAA,IAAI,IAAA,CAAK,MAAA,KAAW,IAAA,EAAM,oBAAA,CAAqB,KAAK,MAAM,CAAA;AAC1D,IAAA,IAAA,CAAK,MAAA,GAAS,IAAA;AAAA,EAChB;AAAA;AAAA,EAGA,QAAA,GAAiB;AACf,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,OAAA,CAAQ,qBAAA,EAAsB;AAMhD,IAAA,IAAI,IAAA,CAAK,KAAA,KAAU,CAAA,IAAK,IAAA,CAAK,WAAW,CAAA,EAAG;AAE3C,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,MAAA,GAAS,MAAA,CAAO,WAAA;AAElC,IAAA,MAAM,GAAA,GAAM,IAAA,GAAO,CAAA,GAAI,CAAC,IAAA,CAAK,MAAM,IAAA,GAAO,IAAA,CAAK,GAAA,IAAO,CAAA,GAAI,CAAA,GAAI,CAAA;AAC9D,IAAA,MAAM,QAAA,GAAW,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,GAAA,CAAI,CAAA,EAAG,GAAG,CAAC,CAAA;AAC7C,IAAA,IAAI,QAAA,KAAa,KAAK,SAAA,EAAW;AAEjC,IAAA,MAAM,WAAW,IAAA,CAAK,SAAA;AACtB,IAAA,IAAA,CAAK,SAAA,GAAY,QAAA;AACjB,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAQ,CAAA;AAC7B,IAAA,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,IAAA,CAAK,OAAA,EAAS,KAAK,CAAA;AACrC,IAAA,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,QAAA,CAAS,eAAA,EAAiB,KAAK,CAAA;AACjD,IAAA,IAAA,CAAK,SAAS,QAAA,EAAU,EAAE,QAAQ,EAAE,QAAA,IAAY,CAAA;AAChD,IAAA,IAAI,QAAA,KAAa,KAAK,QAAA,KAAa,EAAA,IAAM,KAAK,UAAA,EAAY,IAAA,CAAK,SAAS,UAAU,CAAA;AAAA,EACpF;AACF","file":"reading_progress_controller.js","sourcesContent":["/**\n * Runs a controller's \"return to the initial state\" pass just before Turbo\n * caches the page.\n *\n * **`disconnect()` cannot do this job, for two independent reasons.** Turbo\n * queues the clone from this event rather than taking it here, and the body swap\n * that runs the controller's `disconnect()` is queued separately — so which of\n * the two lands first is not something a controller can rely on, and a rewind\n * written in `disconnect()` may reach only the DOM being thrown away. In the\n * other direction, `disconnect()` also fires on an in-page move (Stimulus tears\n * down and reconnects the same element), where rewinding would wipe a\n * legitimately in-progress interaction — a spinner mid-load would vanish. One\n * timing is unreliable, the other is too eager; `turbo:before-cache` is the only\n * point that is exactly \"the page is about to be frozen\".\n *\n * Scope is the subscription only: registering on `activate()`, unregistering on\n * `deactivate()`, and one shared document listener no matter how many instances\n * are live. *What* to return to its initial state — which `data-state`, which\n * `hidden`, which `aria-busy` — stays in the controller, because no two\n * consumers answer it the same way.\n *\n * **Rewind state, not appearance.** The pass writes attributes the controller\n * itself owns; the visual result of those attributes is the consumer's CSS, and\n * a library that reached for style or class names would be guessing at markup\n * it does not own.\n *\n * Both entry points are idempotent, so the lifecycle hooks can call them\n * unconditionally: a second `activate()` does not double-subscribe and does not\n * make the callback run twice, and `deactivate()` on an instance that never\n * subscribed is a no-op.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n *\n * @example\n * ```ts\n * readonly #beforeCache = new BeforeCacheReset(() => this.#rewind());\n *\n * connect()    { this.#beforeCache.activate(); }\n * disconnect() { this.#beforeCache.deactivate(); }\n * ```\n */\nexport class BeforeCacheReset {\n  /** Every subscribed instance, iterated by the one shared document listener. */\n  static readonly #subscribers = new Set<BeforeCacheReset>();\n\n  /** The shared listener; installed while at least one instance is subscribed. */\n  static readonly #onBeforeCache = (): void => {\n    for (const subscriber of BeforeCacheReset.#subscribers) subscriber.#rewind();\n  };\n\n  readonly #rewind: () => void;\n\n  /** @param rewind - the pass that returns this controller's state to its initial form. */\n  constructor(rewind: () => void) {\n    this.#rewind = rewind;\n  }\n\n  /** Subscribes to `turbo:before-cache`; call from `connect()`. Idempotent. */\n  activate(): void {\n    const first = BeforeCacheReset.#subscribers.size === 0;\n    BeforeCacheReset.#subscribers.add(this);\n    if (first) {\n      document.addEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n    }\n  }\n\n  /** Unsubscribes; call from `disconnect()`. Safe when never subscribed. */\n  deactivate(): void {\n    BeforeCacheReset.#subscribers.delete(this);\n    if (BeforeCacheReset.#subscribers.size > 0) return;\n    document.removeEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n  }\n}\n","/**\n * Unified element-size and viewport observation for Stimeo controllers.\n *\n * Widgets whose output is measured — an overflow boundary, a masonry column count,\n * an autosized textarea — need to react both to their *own* box changing — via {@link ResizeObserver} —\n * and to the *viewport* changing — via the `window` `resize` event. Wiring those\n * two sources by hand in every controller risks leaked listeners on\n * `disconnect()`. {@link LayoutObserver} owns both behind one callback and one\n * {@link LayoutObserver.disconnect | disconnect()} that releases everything.\n *\n * Behavior only: the helper reports *that* layout changed; it never reads or\n * writes styles. Consumers decide what to recompute.\n */\n\n/** Invoked whenever an observed element or the viewport changes size. */\nexport type LayoutCallback = () => void;\n\n/** Constructs a {@link ResizeObserver}; injectable so tests stay deterministic. */\nexport type ResizeObserverFactory = (callback: ResizeObserverCallback) => ResizeObserver;\n\n/** Options for {@link LayoutObserver}. */\nexport interface LayoutObserverOptions {\n  /**\n   * Factory for the {@link ResizeObserver} used by {@link LayoutObserver.observe}.\n   * Defaults to the global constructor; override it in tests, or to no-op in\n   * environments where `ResizeObserver` is unavailable.\n   */\n  resizeObserverFactory?: ResizeObserverFactory;\n}\n\n/**\n * Observes element resizes and/or viewport resizes through a single callback,\n * with guaranteed teardown.\n *\n * @example\n * ```ts\n * #layout = new LayoutObserver(() => this.#reposition());\n *\n * connect() {\n *   this.#layout.observe(this.panelTarget);\n *   this.#layout.observeViewport();\n * }\n *\n * disconnect() {\n *   this.#layout.disconnect();\n * }\n * ```\n */\nexport class LayoutObserver {\n  readonly #callback: LayoutCallback;\n  readonly #resizeObserverFactory: ResizeObserverFactory | null;\n  #resizeObserver: ResizeObserver | null = null;\n  #observingViewport = false;\n\n  /** Stable bound handler so add/removeEventListener target the same reference. */\n  readonly #handleViewportResize = (): void => {\n    this.#callback();\n  };\n\n  constructor(callback: LayoutCallback, options: LayoutObserverOptions = {}) {\n    this.#callback = callback;\n    this.#resizeObserverFactory =\n      options.resizeObserverFactory ??\n      (typeof ResizeObserver === \"undefined\" ? null : (cb) => new ResizeObserver(cb));\n  }\n\n  /**\n   * Starts observing an element's size. Repeated calls observe additional\n   * elements through the same shared observer. No-ops when no\n   * `ResizeObserver` implementation is available.\n   */\n  observe(element: Element): void {\n    if (!this.#resizeObserverFactory) return;\n    if (!this.#resizeObserver) {\n      this.#resizeObserver = this.#resizeObserverFactory(() => {\n        this.#callback();\n      });\n    }\n    this.#resizeObserver.observe(element);\n  }\n\n  /** Stops observing a single element while leaving any others in place. */\n  unobserve(element: Element): void {\n    this.#resizeObserver?.unobserve(element);\n  }\n\n  /** Starts observing viewport resizes. Idempotent: the listener is added once. */\n  observeViewport(): void {\n    if (this.#observingViewport) return;\n    this.#observingViewport = true;\n    window.addEventListener(\"resize\", this.#handleViewportResize);\n  }\n\n  /** Stops observing viewport resizes without affecting element observation. */\n  unobserveViewport(): void {\n    if (!this.#observingViewport) return;\n    this.#observingViewport = false;\n    window.removeEventListener(\"resize\", this.#handleViewportResize);\n  }\n\n  /**\n   * Releases every observation: disconnects the {@link ResizeObserver} and\n   * removes the viewport listener. Safe to call multiple times. Call this from a\n   * controller's `disconnect()`.\n   */\n  disconnect(): void {\n    this.#resizeObserver?.disconnect();\n    this.#resizeObserver = null;\n    this.unobserveViewport();\n  }\n}\n","/** One temporarily controlled style property and the authored declaration it displaced. */\ninterface StylePropertyLeaseRecord {\n  readonly originalValue: string;\n  readonly originalPriority: string;\n  writtenValue: string | null;\n  writtenPriority: string;\n}\n\n/**\n * Temporarily controls one inline CSS property across a changing set of elements.\n *\n * Authored value and priority are restored only while the declaration still matches\n * the last leased write. A later consumer write therefore wins.\n *\n * The lease has no lifecycle of its own, so it never subscribes to document events:\n * a consumer returns its leases from its own `turbo:before-cache` rewind.\n */\nexport class StylePropertyLease<T extends HTMLElement = HTMLElement> {\n  readonly #property: string;\n  readonly #records = new Map<T, StylePropertyLeaseRecord>();\n\n  /** @param property - The CSS property whose temporary values this lease owns. */\n  constructor(property: string) {\n    this.#property = property;\n  }\n\n  /** Writes or removes the leased declaration while preserving its authored value. */\n  write(element: T, value: string | null, priority = \"\"): void {\n    const existing = this.#records.get(element);\n    if (existing) {\n      existing.writtenValue = value;\n      existing.writtenPriority = value === null ? \"\" : priority;\n    } else {\n      this.#records.set(element, {\n        originalValue: element.style.getPropertyValue(this.#property),\n        originalPriority: element.style.getPropertyPriority(this.#property),\n        writtenValue: value,\n        writtenPriority: value === null ? \"\" : priority,\n      });\n    }\n\n    this.#reflect(element, value, priority);\n  }\n\n  /** Returns one lease without overwriting a later consumer declaration. */\n  return(element: T): void {\n    const record = this.#records.get(element);\n    if (!record) return;\n    this.#records.delete(element);\n\n    const style = element.style;\n    const stillOwned =\n      style.getPropertyValue(this.#property) === (record.writtenValue ?? \"\") &&\n      style.getPropertyPriority(this.#property) === record.writtenPriority;\n    if (stillOwned) {\n      this.#reflect(element, record.originalValue, record.originalPriority);\n    }\n  }\n\n  /** Returns every outstanding declaration lease. */\n  returnAll(): void {\n    for (const element of Array.from(this.#records.keys())) this.return(element);\n  }\n\n  /** Reflects only a real declaration transition. */\n  #reflect(element: T, value: string | null, priority: string): void {\n    const style = element.style;\n    const nextValue = value ?? \"\";\n    const nextPriority = value === null ? \"\" : priority;\n    if (\n      style.getPropertyValue(this.#property) === nextValue &&\n      style.getPropertyPriority(this.#property) === nextPriority\n    ) {\n      return;\n    }\n    if (value === null) style.removeProperty(this.#property);\n    else style.setProperty(this.#property, value, priority);\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { BeforeCacheReset } from \"../utils/before_cache_reset\";\nimport { LayoutObserver } from \"../utils/layout_observer\";\nimport { StylePropertyLease } from \"../utils/style_property_lease\";\n\n/** Name of the CSS custom property exposing the reading progress (0..1). */\nconst PROGRESS_PROPERTY = \"--stimeo--reading-progress\";\n\n/**\n * Headless **reading progress**: how far the reader has scrolled *through* this\n * element (an article), published as a CSS custom property and a `change`\n * event stream — the classic top-of-page progress bar.\n * `IntersectionObserver` alone cannot express this (the ratio is constant\n * while a tall article scrolls through the viewport), so this controller owns\n * the scroll math; compose with `stimeo--intersection` when you also need\n * enter/exit triggers. Core (zero dependencies).\n *\n * Markup contract (identifier: `stimeo--reading-progress`):\n *   <article data-controller=\"stimeo--reading-progress\">…</article>\n *   <div class=\"progress-bar\" aria-hidden=\"true\"></div>\n *   <!-- .progress-bar { width: calc(var(--stimeo--reading-progress, 0) * 100%); } -->\n *\n * Progress is `0` before the article's top reaches the viewport top and `1`\n * once its bottom fits the viewport: `-top / (height - viewportHeight)`,\n * clamped. An article no taller than the viewport has no such span, so reading\n * it is binary: `1` from the moment its top reaches the viewport top. An\n * article with no layout box at all — a `display: none` ancestor, a collapsed\n * `<details>`, an inactive tab panel — is not measured: an empty rect sits at\n * the document origin and carries no reading position, so publishing anything\n * for it would report a place the reader never reached.\n *\n * The property is written on the controller element **and** on\n * `document.documentElement`, so a fixed bar anywhere in the page can consume\n * it without being a descendant. Both are written through a lease, so an\n * authored declaration comes back on teardown and a later writer is left alone.\n * `complete` fires on *reaching* 1, and never during the baseline: the frame in\n * which the controller connects belongs to establishing where the reader\n * already is (a restored scroll position lands there), not to reading.\n *\n * `change` dispatches `{ progress }`.\n *\n * @remarks\n * Behavior only — the bar itself (and hiding it, e.g. before any scroll) is\n * the consumer's CSS; the progress value carries no ARIA (a decorative\n * indicator — mark the bar `aria-hidden`; a *semantic* progress belongs to\n * `stimeo--progress`). The article's own box is watched as well as the\n * viewport, so content that settles late (images, fonts) re-measures instead of\n * leaving a stale span. Scroll and layout work is rAF-throttled; the listeners,\n * the observers, any pending frame and both leased declarations are released on\n * `disconnect()` and returned again for a `turbo:before-cache` snapshot.\n */\nexport class ReadingProgressController extends Controller<HTMLElement> {\n  static events = [\"change\", \"complete\"] as const;\n\n  /** Owns both faces of the published property so teardown can hand them back. */\n  readonly #lease = new StylePropertyLease(PROGRESS_PROPERTY);\n  /** The article's own box and the viewport: either changes the span. */\n  readonly #layout = new LayoutObserver(() => this.#onScroll());\n  readonly #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());\n  #frame: number | null = null;\n  /** Last published progress, so `change`/`complete` fire only on movement. */\n  #progress = -1;\n  /** False until the connect frame has run: `complete` needs real reading. */\n  #baselined = false;\n\n  readonly #onScroll = (): void => {\n    if (this.#frame !== null) return;\n    this.#frame = requestAnimationFrame(() => {\n      this.#frame = null;\n      this.#measure();\n    });\n  };\n\n  override connect(): void {\n    this.#progress = -1;\n    this.#baselined = false;\n    // Capture phase: element scrolls do not bubble, but they ARE observable at\n    // the window in capture — so an article inside an overflow container still\n    // drives the progress.\n    window.addEventListener(\"scroll\", this.#onScroll, { passive: true, capture: true });\n    this.#layout.observe(this.element);\n    this.#layout.observeViewport();\n    this.#beforeCache.activate();\n    this.#measure();\n    // The page's scroll position is restored *after* the controller connects,\n    // so that jump arrives as a move the reader never made. Everything up to\n    // the end of this frame is still the baseline — a restored scroll coalesces\n    // into the frame below, and no reader can cross an article inside one.\n    this.#frame = requestAnimationFrame(() => {\n      this.#frame = null;\n      this.#measure();\n      this.#baselined = true;\n    });\n  }\n\n  override disconnect(): void {\n    window.removeEventListener(\"scroll\", this.#onScroll, { capture: true });\n    this.#layout.disconnect();\n    this.#beforeCache.deactivate();\n    this.#cancelFrame();\n    this.#lease.returnAll();\n  }\n\n  /**\n   * Hands both declarations back before the page is snapshotted, so a restored\n   * page starts from the authored DOM rather than from someone else's progress.\n   * The baseline goes back with them: a cancelled visit leaves this page on\n   * screen, and the next measurement has to publish afresh rather than match a\n   * value that has already been handed back.\n   */\n  #rewindForCache(): void {\n    this.#cancelFrame();\n    this.#lease.returnAll();\n    this.#progress = -1;\n  }\n\n  #cancelFrame(): void {\n    if (this.#frame !== null) cancelAnimationFrame(this.#frame);\n    this.#frame = null;\n  }\n\n  /** Computes and publishes the progress; emits on movement only. */\n  #measure(): void {\n    const rect = this.element.getBoundingClientRect();\n    // No layout box (a `display: none` ancestor, a collapsed `<details>`): the\n    // empty rect sits at the document origin, where the binary branch below\n    // would read its `top` of 0 as \"the reader reached it\". There is no reading\n    // position to publish, so the last one stands until the article is laid out\n    // again — which the box observer reports.\n    if (rect.width === 0 && rect.height === 0) return;\n\n    const span = rect.height - window.innerHeight;\n    // Shorter than the viewport: reading it is binary (reached or not).\n    const raw = span > 0 ? -rect.top / span : rect.top <= 0 ? 1 : 0;\n    const progress = Math.min(1, Math.max(0, raw));\n    if (progress === this.#progress) return;\n\n    const previous = this.#progress;\n    this.#progress = progress;\n    const value = String(progress);\n    this.#lease.write(this.element, value);\n    this.#lease.write(document.documentElement, value);\n    this.dispatch(\"change\", { detail: { progress } });\n    if (progress === 1 && previous !== -1 && this.#baselined) this.dispatch(\"complete\");\n  }\n}\n"]}

package/dist/controllers/scrollspy_controller.js

@@ -3,6 +3,14 @@ import { Controller } from '@hotwired/stimulus';
 // src/controllers/scrollspy_controller.ts
 
 // src/utils/intersection_watcher.ts
+function queryRoot(selector) {
+  if (!selector) return null;
+  try {
+    return document.querySelector(selector);
+  } catch {
+  }
+  return null;
+}
 var IntersectionWatcher = class {
   #onEntries;
   #observer = null;
@@ -24,7 +32,10 @@ var IntersectionWatcher = class {
    * the watcher inert — without `IntersectionObserver` support (very old
    * browsers; the caller's no-JS fallback stays in charge) or with no targets.
    * If initial construction with the configured options fails, the watcher
-   * warns and retries once with the same root and platform defaults.
+   * warns and retries once with the same root and platform defaults. A
+   * `rootSelector` that does not parse resolves to the viewport (see
+   * {@link IntersectionWatchOptions.rootSelector}), so a typo never fails the
+   * call.
    *
    * @throws The fallback constructor error if both construction attempts fail,
    *   or whatever the platform throws from `observe()`. The exception is passed
@@ -37,7 +48,7 @@ var IntersectionWatcher = class {
     if (typeof IntersectionObserver === "undefined") return false;
     const list = Array.isArray(targets) ? targets : [targets];
     if (list.length === 0) return false;
-    const root = "root" in options ? options.root ?? null : options.rootSelector ? document.querySelector(options.rootSelector) : null;
+    const root = "root" in options ? options.root ?? null : queryRoot(options.rootSelector);
     let observer = null;
     try {
       const onEntries = (entries) => {

package/dist/controllers/scrollspy_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/intersection_watcher.ts","../../src/utils/reduced_motion.ts","../../src/controllers/scrollspy_controller.ts"],"names":[],"mappings":"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","file":"scrollspy_controller.js","sourcesContent":["/**\n * Shared `IntersectionObserver` plumbing for Stimeo's scroll-triggered\n * controllers (`intersection`, `scrollspy`, `sticky-observer`, `lazy-frame`).\n *\n * It centralizes the `IntersectionObserver` support guard, root resolution from\n * a selector, observer creation/teardown, the **active guard** (the browser may\n * flush a final queued callback batch right after `disconnect()`, and a\n * detached controller must not mutate possibly-cached DOM), and the\n * unobserve→observe **re-arm** that re-delivers the current state even when the\n * target never leaves the viewport.\n *\n * Like {@link RovingTabindex} and `FocusTrap`, this is a policy-free internal\n * util: what an intersection *means* (a spied link, a stuck header, a lazy\n * load) stays in each controller. The public `stimeo--intersection` controller\n * is its thin declarative face.\n */\n/**\n * Whether `entry`'s target sits entirely before the root's **start (top)** edge —\n * the \"scrolled past the top\" half of a non-intersecting entry, as opposed to\n * \"not reached yet\" below the root.\n *\n * A target with no layout box (`display: none`, a `hidden` ancestor, a collapsed\n * `<details>`) is reported with an **empty rect**, whose `bottom` of `0` would\n * otherwise satisfy `bottom <= rootTop` for a viewport root and read as \"passed\"\n * even though the target was never scrolled anywhere. An empty rect carries no\n * position at all, so it is deliberately never \"before the edge\"; what a caller\n * publishes for that case is its own policy (both consumers treat it as the\n * neutral \"not passed\"/\"not stuck\", and the real rect that arrives once the\n * target is laid out re-establishes the true state).\n */\nexport function isBeforeRootStart(entry: IntersectionObserverEntry): boolean {\n  const rect = entry.boundingClientRect;\n  if (rect.width === 0 && rect.height === 0) return false;\n  // rootBounds is null for a cross-origin/removed root; fall back to the\n  // viewport origin.\n  const rootTop = entry.rootBounds?.top ?? 0;\n  return rect.bottom <= rootTop;\n}\n\nexport interface IntersectionWatchOptions {\n  /**\n   * The observation root. Pass an element (or `null` for the viewport) when\n   * the caller already resolved it; omit to resolve from `rootSelector`.\n   */\n  root?: Element | null;\n  /** Selector for the observation root; empty/omitted = viewport. */\n  rootSelector?: string;\n  rootMargin?: string;\n  threshold?: number | number[];\n}\n\nexport class IntersectionWatcher {\n  readonly #onEntries: (entries: IntersectionObserverEntry[]) => void;\n  #observer: IntersectionObserver | null = null;\n  #active = false;\n  #usingPlatformDefaults = false;\n\n  constructor(onEntries: (entries: IntersectionObserverEntry[]) => void) {\n    this.#onEntries = onEntries;\n  }\n\n  /** Whether an observer is live (started, `IntersectionObserver` supported). */\n  get active(): boolean {\n    return this.#active;\n  }\n\n  /** Whether the live observer discarded configured options after construction failed. */\n  get usingPlatformDefaults(): boolean {\n    return this.#usingPlatformDefaults;\n  }\n\n  /**\n   * (Re)creates the observer and observes `targets`. Returns `false` — leaving\n   * the watcher inert — without `IntersectionObserver` support (very old\n   * browsers; the caller's no-JS fallback stays in charge) or with no targets.\n   * If initial construction with the configured options fails, the watcher\n   * warns and retries once with the same root and platform defaults.\n   *\n   * @throws The fallback constructor error if both construction attempts fail,\n   *   or whatever the platform throws from `observe()`. The exception is passed\n   *   through unchanged, but the watcher rolls back first: every target observed\n   *   so far is released and `active` stays `false`, so a caller that retries\n   *   starts from a clean slate.\n   */\n  start(targets: Element | readonly Element[], options: IntersectionWatchOptions = {}): boolean {\n    this.stop();\n    if (typeof IntersectionObserver === \"undefined\") return false;\n    const list = Array.isArray(targets) ? (targets as readonly Element[]) : [targets as Element];\n    if (list.length === 0) return false;\n\n    const root =\n      \"root\" in options\n        ? (options.root ?? null)\n        : options.rootSelector\n          ? document.querySelector(options.rootSelector)\n          : null;\n\n    let observer: IntersectionObserver | null = null;\n    try {\n      const onEntries = (entries: IntersectionObserverEntry[]): void => {\n        // Identity matters across an immediate restart: the old observer can\n        // flush a queued batch after the new observer has made `active` true.\n        if (this.#active && this.#observer === observer) this.#onEntries(entries);\n      };\n      try {\n        observer = new IntersectionObserver(onEntries, {\n          root,\n          rootMargin: options.rootMargin,\n          threshold: options.threshold,\n        });\n      } catch (error) {\n        console.warn(\n          \"Stimeo UI: IntersectionObserver could not be constructed with the configured options; retrying with platform defaults.\",\n          error,\n        );\n        observer = new IntersectionObserver(onEntries, { root });\n        this.#usingPlatformDefaults = true;\n      }\n      for (const target of list) observer.observe(target);\n      this.#observer = observer;\n      this.#active = true;\n      return true;\n    } catch (error) {\n      // A constructor or partial observe failure must not leave earlier targets\n      // observed or report an active watcher. Preserve the platform exception.\n      observer?.disconnect();\n      this.#observer = null;\n      this.#active = false;\n      this.#usingPlatformDefaults = false;\n      throw error;\n    }\n  }\n\n  /**\n   * Re-delivers `target`'s CURRENT intersection state: `IntersectionObserver`\n   * only reports *changes*, but `observe()` always reports the present state,\n   * so unobserve→observe turns \"still intersecting\" into a fresh callback.\n   *\n   * @throws Whatever `unobserve()`/`observe()` throws. The watcher is stopped\n   *   first, so it never stays live with a half-rearmed target.\n   */\n  rearm(target: Element): void {\n    if (!this.#observer) return;\n    try {\n      this.#observer.unobserve(target);\n      this.#observer.observe(target);\n    } catch (error) {\n      this.stop();\n      throw error;\n    }\n  }\n\n  /** Severs the observer; late queued callbacks become no-ops via the guard. */\n  stop(): void {\n    this.#active = false;\n    this.#observer?.disconnect();\n    this.#observer = null;\n    this.#usingPlatformDefaults = false;\n  }\n}\n","/**\n * Shared `prefers-reduced-motion` lookup for the motion-aware controllers\n *.\n *\n * This one-liner keeps the media query string and the environment guard\n * single-sourced across them. The preference is intentionally re-read on every\n * call — the controllers check it at each animation/scroll start (WCAG 2.2\n * **2.3.3**), so flipping the OS setting takes effect immediately without any\n * listener or cache bookkeeping here.\n */\n\n/**\n * Whether the user currently requests reduced motion.\n *\n * @returns `true` when `(prefers-reduced-motion: reduce)` matches; `false`\n * otherwise, including environments without `window.matchMedia` (treated as\n * \"no preference\").\n */\nexport function prefersReducedMotion(): boolean {\n  return (\n    typeof window.matchMedia === \"function\" &&\n    window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches\n  );\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { IntersectionWatcher } from \"../utils/intersection_watcher\";\nimport { prefersReducedMotion } from \"../utils/reduced_motion\";\n\n/**\n * The attributes a link may anchor its section with, and therefore the only\n * ones whose rewrite has to re-sync the observation set. `aria-current` — the\n * attribute this controller writes itself — is deliberately absent, so\n * publishing the current location cannot feed back into a rebuild.\n */\nconst ANCHOR_ATTRIBUTES = [\"href\", \"data-href\"];\n\n/**\n * Headless, accessible **Scrollspy**: keeps a table of contents in sync with the\n * section the reader is currently in, published as `aria-current=\"location\"`.\n * There is no dedicated APG widget; it follows the `aria-current`\n * current-location practice inside a `<nav>` landmark.\n *\n * Markup contract (identifier: `stimeo--scrollspy`):\n *   <nav data-controller=\"stimeo--scrollspy\"\n *        data-stimeo--scrollspy-offset-value=\"80\"\n *        data-stimeo--scrollspy-root-selector-value=\".content\"\n *        aria-label=\"Table of contents\">\n *     <a href=\"#intro\" data-stimeo--scrollspy-target=\"link\"\n *        data-action=\"click->stimeo--scrollspy#scrollTo\">Intro</a>\n *     <a href=\"#usage\" data-stimeo--scrollspy-target=\"link\"\n *        data-action=\"click->stimeo--scrollspy#scrollTo\">Usage</a>\n *   </nav>\n *   <div class=\"content\">\n *     <section id=\"intro\">…</section>\n *     <section id=\"usage\">…</section>\n *   </div>\n *\n * The active section is the one whose top edge sits closest to the **trigger\n * line**: `offset` px below the top of the *scroll root* — the `rootSelector`\n * container, or the viewport when that value is empty. It is not the viewport\n * top whenever a nested container is spied on. Intersecting sections win; when\n * none intersects (between two sections, scrolled past the last one) the\n * closest tracked section keeps the highlight, so a table of contents never\n * goes blank.\n *\n * `data-action` on the links is optional and opts into {@link scrollTo}, which\n * scrolls the nested container instead of bouncing the whole window.\n *\n * `change` dispatches `{ id: string, link: HTMLElement }`.\n *\n * @remarks\n * Behavior only — how a current link looks is the consumer's CSS\n * (`[aria-current=\"location\"] { … }`). `connect()` reads the current location\n * back from the DOM so a Turbo cache restore re-establishes it without a\n * redundant `change`, and `disconnect()` severs every resource acquired here:\n * the observers, the scroll listener, and any pending frame or queued rebuild.\n *\n * **What is followed automatically**, and what is not (the boundary a consumer\n * has to know, because everything outside it needs a re-`connect()`):\n *\n * - `link` targets added or removed — Stimulus's target callbacks.\n * - a `link` target's `href` / `data-href` rewritten in place — a Turbo 8 morph\n *   keeps the element *and* its target marker, so no target callback fires;\n *   {@link ANCHOR_ATTRIBUTES} is watched for exactly this case.\n * - the reader's scroll position, including inside a stretch where no section\n *   crosses an observation threshold.\n *\n * Not followed: a *split* lifecycle in which the nav survives while the scroll\n * root or the sections are replaced underneath it. `rootSelector` is resolved\n * against the whole document and re-resolved once the cached container leaves\n * it, but section elements are looked up only while the observation set is\n * (re)built — swap those alone and nothing tells this controller to look again.\n */\nexport class ScrollspyController extends Controller<HTMLElement> {\n  static override targets = [\"link\"];\n  static override values = {\n    offset: { type: Number, default: 0 },\n    rootMargin: { type: String, default: \"\" },\n    rootSelector: { type: String, default: \"\" },\n    focusSection: { type: Boolean, default: false },\n  };\n  static actions = [\"scrollTo\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly linkTargets: HTMLElement[];\n\n  declare offsetValue: number;\n  declare rootMarginValue: string;\n  declare rootSelectorValue: string;\n  declare focusSectionValue: boolean;\n\n  /**\n   * The one offset shared by observation, active-section selection, and\n   * scrolling. Stimulus parses a malformed Number Value as `NaN`; degrading it\n   * to the declared default keeps every path aligned instead of only repairing\n   * the observer margin while selection and scrolling still receive `NaN`.\n   */\n  get #offset(): number {\n    return Number.isFinite(this.offsetValue) ? this.offsetValue : 0;\n  }\n\n  /** Shared IO plumbing (support guard, active guard, teardown). */\n  readonly #watcher = new IntersectionWatcher((entries) => this.#onIntersection(entries));\n  #isConnected = false;\n\n  /**\n   * Sections currently tracked, by id. Only the *latest reported* intersection\n   * flag is stored — never a coordinate. Positions are re-measured when the\n   * active section is evaluated, so a section observed several batches ago is\n   * never compared against a trigger line computed now.\n   */\n  #intersectionStates = new Map<string, { element: Element; isIntersecting: boolean }>();\n\n  /** Current active section ID; comparing it suppresses duplicate `change` events. */\n  #activeSectionId = \"\";\n\n  /**\n   * Scroll root resolved when the observer was (re)built; `null` = viewport.\n   * Cached so a click and every intersection batch reuse the element the\n   * observer is actually watching instead of re-querying the document.\n   */\n  #rootElement: HTMLElement | null = null;\n\n  /**\n   * The source the `scroll` listener is currently attached to — the resolved\n   * root, or the window while the viewport is spied. `null` means \"nothing\n   * attached\", so teardown always detaches from the source it attached to\n   * rather than from whatever the selector resolves to now.\n   */\n  #scrollSource: HTMLElement | Window | null = null;\n\n  /** Pending re-evaluation frame; coalesces a scroll burst into one measurement. */\n  #frame: number | null = null;\n\n  /** Watches the link targets' anchor attributes for an in-place morph rewrite. */\n  #anchorObserver: MutationObserver | null = null;\n\n  /** True while a coalesced observation rebuild is queued; see {@link #scheduleResync}. */\n  #resyncQueued = false;\n\n  override connect(): void {\n    this.#isConnected = true;\n    this.#observeAnchorAttributes();\n    this.#initializeObserver();\n  }\n\n  override disconnect(): void {\n    this.#isConnected = false;\n    // Dropping the flag is what discards a rebuild queued moments ago: the\n    // drain reads it, so the queued microtask becomes a no-op.\n    this.#resyncQueued = false;\n    this.#watcher.stop();\n    this.#anchorObserver?.disconnect();\n    this.#anchorObserver = null;\n    this.#detachScrollListener();\n    if (this.#frame !== null) {\n      cancelAnimationFrame(this.#frame);\n      this.#frame = null;\n    }\n    this.#intersectionStates.clear();\n    this.#activeSectionId = \"\";\n    this.#rootElement = null;\n  }\n\n  /**\n   * Re-initializes the observer if the offset or rootMargin values change dynamically.\n   */\n  offsetValueChanged(): void {\n    if (!this.#isConnected) return;\n    this.#initializeObserver();\n  }\n\n  rootMarginValueChanged(): void {\n    if (!this.#isConnected) return;\n    this.#initializeObserver();\n  }\n\n  rootSelectorValueChanged(): void {\n    if (!this.#isConnected) return;\n    this.#initializeObserver();\n  }\n\n  /**\n   * Re-syncs the observation set when a Turbo Stream/morph swaps the table of\n   * contents. Stimulus fires these before `connect()` for the links already in\n   * the markup, hence the guard: the initial observer is built exactly once, by\n   * `connect()`.\n   */\n  linkTargetConnected(): void {\n    if (this.#isConnected) this.#scheduleResync();\n  }\n\n  linkTargetDisconnected(): void {\n    if (this.#isConnected) this.#scheduleResync();\n  }\n\n  /**\n   * Queues **one** observation rebuild for the current mutation batch.\n   *\n   * A single Turbo morph can append one link, drop another, and rewrite a\n   * third's `href`, and those arrive through two independent channels —\n   * Stimulus's target callbacks and {@link #anchorObserver}. Each channel just\n   * raises the flag and queues a drain; the first drain to run does the work and\n   * clears it, so every later drain in the same batch finds nothing to do and\n   * the set is rebuilt once instead of three times. `disconnect()` clears the\n   * same flag, which is how a queued rebuild is dropped rather than run against\n   * a detached controller.\n   */\n  #scheduleResync(): void {\n    this.#resyncQueued = true;\n    queueMicrotask(this.#drainResync);\n  }\n\n  readonly #drainResync = (): void => {\n    if (!this.#resyncQueued) return;\n    this.#resyncQueued = false;\n    this.#initializeObserver();\n  };\n\n  /**\n   * Watches the link targets' anchor attributes so an in-place rewrite re-syncs.\n   *\n   * A Turbo 8 morph keeps the element **and** its `data-*-target` marker and\n   * only rewrites attributes, so Stimulus fires no target callback: without\n   * this, a link re-pointed from `#intro` to `#faq` would keep the controller\n   * observing `#intro` for the rest of the page's life. The filter is exactly\n   * {@link ANCHOR_ATTRIBUTES}; guarding on `MutationObserver` keeps the\n   * controller usable where the API is absent, matching `IntersectionWatcher`'s\n   * own support guard.\n   */\n  #observeAnchorAttributes(): void {\n    if (typeof MutationObserver !== \"undefined\") {\n      this.#anchorObserver = new MutationObserver(this.#onAnchorMutation);\n      this.#anchorObserver.observe(this.element, {\n        subtree: true,\n        attributes: true,\n        attributeFilter: ANCHOR_ATTRIBUTES,\n      });\n    }\n  }\n\n  /**\n   * Rebuilds only for a rewrite on a *current* link target. The observer is\n   * scoped to this controller's element, but that subtree also holds links the\n   * author never marked as targets (a \"back to top\" anchor, a nested nav), and\n   * those anchor nothing here.\n   */\n  readonly #onAnchorMutation = (records: MutationRecord[]): void => {\n    const links = this.linkTargets;\n    for (const record of records) {\n      if (!links.includes(record.target as HTMLElement)) continue;\n      this.#scheduleResync();\n      return;\n    }\n  };\n\n  /**\n   * Scrolls to the section the clicked link anchors, honoring `offset` and any\n   * nested scroll container (a plain fragment jump would scroll the window).\n   *\n   * Honors `prefers-reduced-motion` (WCAG 2.2 **2.3.3**) by forcing an instant\n   * jump independently of the consumer's CSS `scroll-behavior`. With\n   * `focusSection` enabled it also moves the sequential focus starting point\n   * into the destination; the URL fragment is deliberately not touched.\n   */\n  scrollTo(event: Event): void {\n    const link = event.currentTarget as HTMLElement;\n    const id = this.#getAnchorId(link);\n    if (!id) return;\n\n    event.preventDefault();\n\n    const targetElement = document.getElementById(id);\n    if (!targetElement) return;\n\n    const behavior: ScrollBehavior = prefersReducedMotion() ? \"instant\" : \"smooth\";\n    const rootElement = this.#scrollRoot();\n    const targetRect = targetElement.getBoundingClientRect();\n    const offset = this.#offset;\n\n    if (rootElement) {\n      const containerRect = rootElement.getBoundingClientRect();\n      const scrollPosition = rootElement.scrollTop + (targetRect.top - containerRect.top) - offset;\n\n      rootElement.scrollTo({ top: scrollPosition, behavior });\n    } else {\n      const scrollPosition = window.scrollY + targetRect.top - offset;\n\n      window.scrollTo({ top: scrollPosition, behavior });\n    }\n\n    if (this.focusSectionValue) this.#focusSection(targetElement);\n  }\n\n  /**\n   * Moves the sequential focus starting point into the section `scrollTo` just\n   * jumped to, so the next Tab continues *inside* the destination instead of\n   * resuming in the table of contents (`preventDefault()` alone would leave the\n   * starting point on the link). Opt-in through `focusSection`, because moving\n   * focus is a decision only the consuming page can make.\n   *\n   * `tabindex=\"-1\"` is established only when the section is not already\n   * focusable and is never removed, so an author-owned tabindex is left alone.\n   * `preventScroll` keeps the focus call from cancelling the smooth scroll\n   * started just above.\n   */\n  #focusSection(section: HTMLElement): void {\n    if (!section.hasAttribute(\"tabindex\")) section.setAttribute(\"tabindex\", \"-1\");\n    section.focus({ preventScroll: true });\n  }\n\n  /**\n   * The cached scroll root, re-resolved when the cached element has left the\n   * document (a Turbo morph replaced the container) so `scrollTo` never\n   * scrolls a detached node.\n   */\n  #scrollRoot(): HTMLElement | null {\n    if (this.#rootElement && !this.#rootElement.isConnected) {\n      this.#rootElement = this.#queryRootElement();\n    }\n    return this.#rootElement;\n  }\n\n  /**\n   * Resolves `rootSelector` to a scrollable element.\n   *\n   * @returns The container, or `null` meaning \"spy the viewport\" when the value\n   * is empty, matches nothing, matches a non-HTML element (an SVG node is not a\n   * scroll container), or is not a valid selector — a typo in a data attribute\n   * must degrade to viewport spying, not leave the controller inert.\n   */\n  #queryRootElement(): HTMLElement | null {\n    if (!this.rootSelectorValue) return null;\n    try {\n      const root = document.querySelector(this.rootSelectorValue);\n      return root instanceof HTMLElement ? root : null;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Re-evaluates once per frame while the reader scrolls.\n   *\n   * `IntersectionObserver` reports **threshold crossings**, not positions, so a\n   * reader moving inside one long section — or across a gap wider than the\n   * observation band — produces no batch at all and the highlight would stay\n   * frozen at whatever the last crossing decided. That would make the current\n   * location depend on the *route* to a position instead of the position: a\n   * stepwise scroll crosses thresholds an instant jump to the same offset never\n   * does. Listening to the scroll source closes the gap, and because both paths\n   * end in {@link #evaluateActiveSection} — which measures section rects and the\n   * root's top edge at that instant — they converge on the same answer.\n   */\n  readonly #onScroll = (): void => {\n    if (this.#frame !== null) return;\n    this.#frame = requestAnimationFrame(() => {\n      this.#frame = null;\n      this.#evaluateActiveSection();\n    });\n  };\n\n  /**\n   * Points the `scroll` listener at whatever the reader actually scrolls: the\n   * resolved root, or the window when the viewport is spied.\n   *\n   * The detach is unconditional, so rebuilding the observation set (a Value\n   * change, a morph) **moves** the listener rather than stacking a second one on\n   * a container the reader has stopped scrolling.\n   */\n  #syncScrollListener(): void {\n    this.#detachScrollListener();\n    this.#scrollSource = this.#rootElement ?? window;\n    this.#scrollSource.addEventListener(\"scroll\", this.#onScroll, { passive: true });\n  }\n\n  #detachScrollListener(): void {\n    this.#scrollSource?.removeEventListener(\"scroll\", this.#onScroll);\n    this.#scrollSource = null;\n  }\n\n  #initializeObserver(): void {\n    this.#watcher.stop();\n    this.#intersectionStates.clear();\n    // The DOM is the source of truth for the current location **only when this\n    // controller has none of its own** — a fresh `connect()`, which is also the\n    // Turbo cache-restore case, where the links still carry `aria-current` from\n    // the snapshot. Adopting it there makes the observer's first batch a silent\n    // confirmation instead of a duplicate `change`.\n    //\n    // On a *live* rebuild the memory wins, because the DOM has stopped meaning\n    // what this controller wrote: an anchor rewritten underneath us leaves\n    // `aria-current` on a link that now points somewhere else, so reading it\n    // back would hand the current location to a section the reader never\n    // scrolled to — and then announce the correction as a `change`, as if they\n    // had travelled there and back.\n    this.#activeSectionId = this.#activeSectionId || this.#activeIdFromDom();\n    this.#rootElement = this.#queryRootElement();\n    this.#syncScrollListener();\n\n    if (this.linkTargets.length === 0) return;\n\n    // Negate the numeric value so a valid negative offset becomes a positive margin.\n    const margin = this.rootMarginValue || `${-this.#offset}px 0px -80% 0px`;\n\n    // Observe each target section mapped by the href anchors.\n    const sections: Element[] = [];\n    for (const link of this.linkTargets) {\n      const id = this.#getAnchorId(link);\n      if (!id) continue;\n      const section = document.getElementById(id);\n      if (section && !sections.includes(section)) sections.push(section);\n    }\n\n    this.#watcher.start(sections, {\n      root: this.#rootElement,\n      rootMargin: margin,\n      threshold: [0, 0.2, 0.4, 0.6, 0.8, 1], // Multiple thresholds handle large sections safely\n    });\n\n    // Republish the adopted location over the *current* link set. Evaluation\n    // writes attributes only when the winning section changes, so a link added\n    // — or re-anchored — while the reader stays put would otherwise never be\n    // marked: a mobile table of contents rendered after the sidebar one would\n    // stay blank until the reader happened to cross into another section.\n    //\n    // Unconditional, including when the adopted location is empty: a link whose\n    // anchor was rewritten to something that resolves nowhere cannot be the\n    // reader's location, and this controller is the one that published the\n    // attribute saying it was, so it is the one that has to take it back.\n    this.#syncActiveStates(false);\n  }\n\n  readonly #onIntersection = (entries: IntersectionObserverEntry[]): void => {\n    // Defense in depth. `IntersectionWatcher` already drops a batch the browser\n    // flushes after `stop()` (its active/identity guard), so this flag is the\n    // second line that keeps a detached controller from mutating `aria-current`\n    // on (possibly cached) links.\n    const isDetached = !this.#isConnected;\n    if (isDetached) return;\n\n    for (const entry of entries) {\n      const sectionId = entry.target.id;\n      if (!sectionId) continue;\n\n      this.#intersectionStates.set(sectionId, {\n        element: entry.target,\n        isIntersecting: entry.isIntersecting,\n      });\n    }\n\n    this.#evaluateActiveSection();\n  };\n\n  /**\n   * Picks the section closest to the trigger line and publishes it.\n   *\n   * Every coordinate is read **now**: the section rects *and* the root's top\n   * edge share one measurement instant. Comparing an entry's recorded\n   * `boundingClientRect.top` (captured whenever that section last crossed a\n   * threshold) against a freshly computed trigger line mixes two moments in\n   * time, which would make the result depend on how the reader arrived at a\n   * position — a smooth scroll and an instant jump to the same offset disagree.\n   */\n  #evaluateActiveSection(): void {\n    // The trigger line is `offset` px below the top of the scroll root. When a\n    // nested `rootSelector` container is used it is not at the viewport top, so\n    // the line must be measured from the container's current top — comparing the\n    // viewport-based rect top against a bare `offset` would otherwise pick the\n    // section nearest the viewport top, not the container's.\n    const rootEl = this.#scrollRoot();\n    const triggerLine = (rootEl ? rootEl.getBoundingClientRect().top : 0) + this.#offset;\n\n    let intersectingId = \"\";\n    let intersectingDistance = Number.POSITIVE_INFINITY;\n    let trackedId = \"\";\n    let trackedDistance = Number.POSITIVE_INFINITY;\n\n    for (const [id, state] of this.#intersectionStates) {\n      const rect = state.element.getBoundingClientRect();\n      // A section with no layout box (`display: none`, a collapsed `<details>`,\n      // an undisplayed Turbo Frame) is reported with an empty rect whose `top`\n      // of 0 carries no position at all. Letting it compete would hand it the\n      // fallback below; it re-enters the race once it is actually laid out.\n      if (rect.width === 0 && rect.height === 0) continue;\n\n      const distance = Math.abs(rect.top - triggerLine);\n      if (distance < trackedDistance) {\n        trackedDistance = distance;\n        trackedId = id;\n      }\n      if (state.isIntersecting && distance < intersectingDistance) {\n        intersectingDistance = distance;\n        intersectingId = id;\n      }\n    }\n\n    // Fallback: when no section currently intersects (e.g. scrolled past the\n    // bottom, or between sections), keep the tracked section whose top is\n    // closest to the trigger line so something stays highlighted.\n    const bestId = intersectingId || trackedId;\n\n    if (bestId && bestId !== this.#activeSectionId) {\n      this.#activeSectionId = bestId;\n      this.#syncActiveStates(true);\n    }\n  }\n\n  /**\n   * Writes `aria-current` across the current link set, optionally announcing.\n   *\n   * The two halves are separate because they answer different questions.\n   * *Attributes* must be idempotently re-established whenever the link set\n   * changes, even though the reader has not moved — otherwise a link that\n   * appears (or is re-anchored) while its section is already current never gets\n   * marked. *The `change` event* announces that the reader moved, so it fires\n   * only from the evaluation path; re-publishing over a new link set is not\n   * news, and dispatching there would make a rebuild look like navigation.\n   *\n   * @param announce Whether this sync represents a change of current section.\n   */\n  #syncActiveStates(announce: boolean): void {\n    // Every link anchoring the active section is marked, not just the first:\n    // a page may render the same table of contents twice (a sidebar and a\n    // collapsed mobile menu) and both must show the current location.\n    const activeLinks = this.linkTargets.filter(\n      (link) => this.#getAnchorId(link) === this.#activeSectionId,\n    );\n\n    for (const link of this.linkTargets) {\n      if (activeLinks.includes(link)) {\n        link.setAttribute(\"aria-current\", \"location\");\n      } else if (link.getAttribute(\"aria-current\") === \"location\") {\n        // Reclaim only the value this controller publishes, so an author-owned\n        // `aria-current=\"page\"` on a table-of-contents link survives.\n        link.removeAttribute(\"aria-current\");\n      }\n    }\n\n    if (!announce) return;\n\n    const primaryLink = activeLinks[0];\n    if (primaryLink) {\n      this.dispatch(\"change\", { detail: { id: this.#activeSectionId, link: primaryLink } });\n    }\n  }\n\n  /**\n   * The current location already encoded in the DOM, i.e. the section anchored\n   * by the first link carrying this controller's `aria-current=\"location\"`.\n   * Empty when no link claims it (a genuinely fresh render).\n   */\n  #activeIdFromDom(): string {\n    for (const link of this.linkTargets) {\n      if (link.getAttribute(\"aria-current\") !== \"location\") continue;\n      const id = this.#getAnchorId(link);\n      if (id) return id;\n    }\n    return \"\";\n  }\n\n  /**\n   * The section id a link anchors, resolved in a fixed order:\n   *\n   * 1. `href`, when it is a non-empty same-document fragment — the contract.\n   * 2. otherwise `data-href`'s fragment — the fallback for a link whose `href`\n   *    must stay a real URL (a server-rendered permalink) or that is not an\n   *    `<a>` at all.\n   * 3. otherwise `null`: the link anchors nothing here and is not observed.\n   *\n   * Step 2 is reached whenever `href` yields nothing usable — absent, `\"#\"`, or\n   * a real URL — which is the whole point of the fallback: `href=\"/guide/usage\"`\n   * with `data-href=\"#usage\"` is a permalink that also spies, and picking the\n   * first *present* attribute instead of the first *usable* one would silently\n   * exclude exactly that markup. When both are valid fragments `href` wins.\n   */\n  #getAnchorId(link: HTMLElement): string | null {\n    return (\n      this.#fragmentId(link.getAttribute(\"href\")) ??\n      this.#fragmentId(link.getAttribute(\"data-href\"))\n    );\n  }\n\n  /** The id in a `#fragment` value; `null` for absent, empty, or non-fragment. */\n  #fragmentId(value: string | null): string | null {\n    if (!value?.startsWith(\"#\")) return null;\n    return value.substring(1) || null;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/intersection_watcher.ts","../../src/utils/reduced_motion.ts","../../src/controllers/scrollspy_controller.ts"],"names":[],"mappings":"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","file":"scrollspy_controller.js","sourcesContent":["/**\n * Shared `IntersectionObserver` plumbing for Stimeo's scroll-triggered\n * controllers (`intersection`, `scrollspy`, `sticky-observer`, `lazy-frame`).\n *\n * It centralizes the `IntersectionObserver` support guard, root resolution from\n * a selector (degrading to the viewport rather than failing), observer\n * creation/teardown, the **active guard** (the browser may\n * flush a final queued callback batch right after `disconnect()`, and a\n * detached controller must not mutate possibly-cached DOM), and the\n * unobserve→observe **re-arm** that re-delivers the current state even when the\n * target never leaves the viewport.\n *\n * Like {@link RovingTabindex} and `FocusTrap`, this is a policy-free internal\n * util: what an intersection *means* (a spied link, a stuck header, a lazy\n * load) stays in each controller. The public `stimeo--intersection` controller\n * is its thin declarative face.\n */\n/**\n * Whether `entry`'s target sits entirely before the root's **start (top)** edge —\n * the \"scrolled past the top\" half of a non-intersecting entry, as opposed to\n * \"not reached yet\" below the root.\n *\n * A target with no layout box (`display: none`, a `hidden` ancestor, a collapsed\n * `<details>`) is reported with an **empty rect**, whose `bottom` of `0` would\n * otherwise satisfy `bottom <= rootTop` for a viewport root and read as \"passed\"\n * even though the target was never scrolled anywhere. An empty rect carries no\n * position at all, so it is deliberately never \"before the edge\"; what a caller\n * publishes for that case is its own policy (both consumers treat it as the\n * neutral \"not passed\"/\"not stuck\", and the real rect that arrives once the\n * target is laid out re-establishes the true state).\n */\nexport function isBeforeRootStart(entry: IntersectionObserverEntry): boolean {\n  const rect = entry.boundingClientRect;\n  if (rect.width === 0 && rect.height === 0) return false;\n  // rootBounds is null for a cross-origin/removed root; fall back to the\n  // viewport origin.\n  const rootTop = entry.rootBounds?.top ?? 0;\n  return rect.bottom <= rootTop;\n}\n\n/**\n * Resolves an observation root from a selector. Every reading of \"no root\" ends\n * at the same place — absent, matching nothing, or not parsing at all (a typo in\n * a data attribute) — so the observation falls back to the viewport instead of\n * leaving the caller inert with no state hooks published at all.\n */\nfunction queryRoot(selector: string | undefined): Element | null {\n  if (!selector) return null;\n  try {\n    return document.querySelector(selector);\n  } catch {\n    // Unparsable selector: fall through to the viewport below.\n  }\n  return null;\n}\n\nexport interface IntersectionWatchOptions {\n  /**\n   * The observation root. Pass an element (or `null` for the viewport) when\n   * the caller already resolved it; omit to resolve from `rootSelector`.\n   */\n  root?: Element | null;\n  /**\n   * Selector for the observation root; empty/omitted = viewport. A selector\n   * that matches nothing or does not parse also means the viewport.\n   */\n  rootSelector?: string;\n  rootMargin?: string;\n  threshold?: number | number[];\n}\n\nexport class IntersectionWatcher {\n  readonly #onEntries: (entries: IntersectionObserverEntry[]) => void;\n  #observer: IntersectionObserver | null = null;\n  #active = false;\n  #usingPlatformDefaults = false;\n\n  constructor(onEntries: (entries: IntersectionObserverEntry[]) => void) {\n    this.#onEntries = onEntries;\n  }\n\n  /** Whether an observer is live (started, `IntersectionObserver` supported). */\n  get active(): boolean {\n    return this.#active;\n  }\n\n  /** Whether the live observer discarded configured options after construction failed. */\n  get usingPlatformDefaults(): boolean {\n    return this.#usingPlatformDefaults;\n  }\n\n  /**\n   * (Re)creates the observer and observes `targets`. Returns `false` — leaving\n   * the watcher inert — without `IntersectionObserver` support (very old\n   * browsers; the caller's no-JS fallback stays in charge) or with no targets.\n   * If initial construction with the configured options fails, the watcher\n   * warns and retries once with the same root and platform defaults. A\n   * `rootSelector` that does not parse resolves to the viewport (see\n   * {@link IntersectionWatchOptions.rootSelector}), so a typo never fails the\n   * call.\n   *\n   * @throws The fallback constructor error if both construction attempts fail,\n   *   or whatever the platform throws from `observe()`. The exception is passed\n   *   through unchanged, but the watcher rolls back first: every target observed\n   *   so far is released and `active` stays `false`, so a caller that retries\n   *   starts from a clean slate.\n   */\n  start(targets: Element | readonly Element[], options: IntersectionWatchOptions = {}): boolean {\n    this.stop();\n    if (typeof IntersectionObserver === \"undefined\") return false;\n    const list = Array.isArray(targets) ? (targets as readonly Element[]) : [targets as Element];\n    if (list.length === 0) return false;\n\n    const root = \"root\" in options ? (options.root ?? null) : queryRoot(options.rootSelector);\n\n    let observer: IntersectionObserver | null = null;\n    try {\n      const onEntries = (entries: IntersectionObserverEntry[]): void => {\n        // Identity matters across an immediate restart: the old observer can\n        // flush a queued batch after the new observer has made `active` true.\n        if (this.#active && this.#observer === observer) this.#onEntries(entries);\n      };\n      try {\n        observer = new IntersectionObserver(onEntries, {\n          root,\n          rootMargin: options.rootMargin,\n          threshold: options.threshold,\n        });\n      } catch (error) {\n        console.warn(\n          \"Stimeo UI: IntersectionObserver could not be constructed with the configured options; retrying with platform defaults.\",\n          error,\n        );\n        observer = new IntersectionObserver(onEntries, { root });\n        this.#usingPlatformDefaults = true;\n      }\n      for (const target of list) observer.observe(target);\n      this.#observer = observer;\n      this.#active = true;\n      return true;\n    } catch (error) {\n      // A constructor or partial observe failure must not leave earlier targets\n      // observed or report an active watcher. Preserve the platform exception.\n      observer?.disconnect();\n      this.#observer = null;\n      this.#active = false;\n      this.#usingPlatformDefaults = false;\n      throw error;\n    }\n  }\n\n  /**\n   * Re-delivers `target`'s CURRENT intersection state: `IntersectionObserver`\n   * only reports *changes*, but `observe()` always reports the present state,\n   * so unobserve→observe turns \"still intersecting\" into a fresh callback.\n   *\n   * @throws Whatever `unobserve()`/`observe()` throws. The watcher is stopped\n   *   first, so it never stays live with a half-rearmed target.\n   */\n  rearm(target: Element): void {\n    if (!this.#observer) return;\n    try {\n      this.#observer.unobserve(target);\n      this.#observer.observe(target);\n    } catch (error) {\n      this.stop();\n      throw error;\n    }\n  }\n\n  /** Severs the observer; late queued callbacks become no-ops via the guard. */\n  stop(): void {\n    this.#active = false;\n    this.#observer?.disconnect();\n    this.#observer = null;\n    this.#usingPlatformDefaults = false;\n  }\n}\n","/**\n * Shared `prefers-reduced-motion` lookup for the motion-aware controllers\n *.\n *\n * This one-liner keeps the media query string and the environment guard\n * single-sourced across them. The preference is intentionally re-read on every\n * call — the controllers check it at each animation/scroll start (WCAG 2.2\n * **2.3.3**), so flipping the OS setting takes effect immediately without any\n * listener or cache bookkeeping here.\n */\n\n/**\n * Whether the user currently requests reduced motion.\n *\n * @returns `true` when `(prefers-reduced-motion: reduce)` matches; `false`\n * otherwise, including environments without `window.matchMedia` (treated as\n * \"no preference\").\n */\nexport function prefersReducedMotion(): boolean {\n  return (\n    typeof window.matchMedia === \"function\" &&\n    window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches\n  );\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { IntersectionWatcher } from \"../utils/intersection_watcher\";\nimport { prefersReducedMotion } from \"../utils/reduced_motion\";\n\n/**\n * The attributes a link may anchor its section with, and therefore the only\n * ones whose rewrite has to re-sync the observation set. `aria-current` — the\n * attribute this controller writes itself — is deliberately absent, so\n * publishing the current location cannot feed back into a rebuild.\n */\nconst ANCHOR_ATTRIBUTES = [\"href\", \"data-href\"];\n\n/**\n * Headless, accessible **Scrollspy**: keeps a table of contents in sync with the\n * section the reader is currently in, published as `aria-current=\"location\"`.\n * There is no dedicated APG widget; it follows the `aria-current`\n * current-location practice inside a `<nav>` landmark.\n *\n * Markup contract (identifier: `stimeo--scrollspy`):\n *   <nav data-controller=\"stimeo--scrollspy\"\n *        data-stimeo--scrollspy-offset-value=\"80\"\n *        data-stimeo--scrollspy-root-selector-value=\".content\"\n *        aria-label=\"Table of contents\">\n *     <a href=\"#intro\" data-stimeo--scrollspy-target=\"link\"\n *        data-action=\"click->stimeo--scrollspy#scrollTo\">Intro</a>\n *     <a href=\"#usage\" data-stimeo--scrollspy-target=\"link\"\n *        data-action=\"click->stimeo--scrollspy#scrollTo\">Usage</a>\n *   </nav>\n *   <div class=\"content\">\n *     <section id=\"intro\">…</section>\n *     <section id=\"usage\">…</section>\n *   </div>\n *\n * The active section is the one whose top edge sits closest to the **trigger\n * line**: `offset` px below the top of the *scroll root* — the `rootSelector`\n * container, or the viewport when that value is empty. It is not the viewport\n * top whenever a nested container is spied on. Intersecting sections win; when\n * none intersects (between two sections, scrolled past the last one) the\n * closest tracked section keeps the highlight, so a table of contents never\n * goes blank.\n *\n * `data-action` on the links is optional and opts into {@link scrollTo}, which\n * scrolls the nested container instead of bouncing the whole window.\n *\n * `change` dispatches `{ id: string, link: HTMLElement }`.\n *\n * @remarks\n * Behavior only — how a current link looks is the consumer's CSS\n * (`[aria-current=\"location\"] { … }`). `connect()` reads the current location\n * back from the DOM so a Turbo cache restore re-establishes it without a\n * redundant `change`, and `disconnect()` severs every resource acquired here:\n * the observers, the scroll listener, and any pending frame or queued rebuild.\n *\n * **What is followed automatically**, and what is not (the boundary a consumer\n * has to know, because everything outside it needs a re-`connect()`):\n *\n * - `link` targets added or removed — Stimulus's target callbacks.\n * - a `link` target's `href` / `data-href` rewritten in place — a Turbo 8 morph\n *   keeps the element *and* its target marker, so no target callback fires;\n *   {@link ANCHOR_ATTRIBUTES} is watched for exactly this case.\n * - the reader's scroll position, including inside a stretch where no section\n *   crosses an observation threshold.\n *\n * Not followed: a *split* lifecycle in which the nav survives while the scroll\n * root or the sections are replaced underneath it. `rootSelector` is resolved\n * against the whole document and re-resolved once the cached container leaves\n * it, but section elements are looked up only while the observation set is\n * (re)built — swap those alone and nothing tells this controller to look again.\n */\nexport class ScrollspyController extends Controller<HTMLElement> {\n  static override targets = [\"link\"];\n  static override values = {\n    offset: { type: Number, default: 0 },\n    rootMargin: { type: String, default: \"\" },\n    rootSelector: { type: String, default: \"\" },\n    focusSection: { type: Boolean, default: false },\n  };\n  static actions = [\"scrollTo\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly linkTargets: HTMLElement[];\n\n  declare offsetValue: number;\n  declare rootMarginValue: string;\n  declare rootSelectorValue: string;\n  declare focusSectionValue: boolean;\n\n  /**\n   * The one offset shared by observation, active-section selection, and\n   * scrolling. Stimulus parses a malformed Number Value as `NaN`; degrading it\n   * to the declared default keeps every path aligned instead of only repairing\n   * the observer margin while selection and scrolling still receive `NaN`.\n   */\n  get #offset(): number {\n    return Number.isFinite(this.offsetValue) ? this.offsetValue : 0;\n  }\n\n  /** Shared IO plumbing (support guard, active guard, teardown). */\n  readonly #watcher = new IntersectionWatcher((entries) => this.#onIntersection(entries));\n  #isConnected = false;\n\n  /**\n   * Sections currently tracked, by id. Only the *latest reported* intersection\n   * flag is stored — never a coordinate. Positions are re-measured when the\n   * active section is evaluated, so a section observed several batches ago is\n   * never compared against a trigger line computed now.\n   */\n  #intersectionStates = new Map<string, { element: Element; isIntersecting: boolean }>();\n\n  /** Current active section ID; comparing it suppresses duplicate `change` events. */\n  #activeSectionId = \"\";\n\n  /**\n   * Scroll root resolved when the observer was (re)built; `null` = viewport.\n   * Cached so a click and every intersection batch reuse the element the\n   * observer is actually watching instead of re-querying the document.\n   */\n  #rootElement: HTMLElement | null = null;\n\n  /**\n   * The source the `scroll` listener is currently attached to — the resolved\n   * root, or the window while the viewport is spied. `null` means \"nothing\n   * attached\", so teardown always detaches from the source it attached to\n   * rather than from whatever the selector resolves to now.\n   */\n  #scrollSource: HTMLElement | Window | null = null;\n\n  /** Pending re-evaluation frame; coalesces a scroll burst into one measurement. */\n  #frame: number | null = null;\n\n  /** Watches the link targets' anchor attributes for an in-place morph rewrite. */\n  #anchorObserver: MutationObserver | null = null;\n\n  /** True while a coalesced observation rebuild is queued; see {@link #scheduleResync}. */\n  #resyncQueued = false;\n\n  override connect(): void {\n    this.#isConnected = true;\n    this.#observeAnchorAttributes();\n    this.#initializeObserver();\n  }\n\n  override disconnect(): void {\n    this.#isConnected = false;\n    // Dropping the flag is what discards a rebuild queued moments ago: the\n    // drain reads it, so the queued microtask becomes a no-op.\n    this.#resyncQueued = false;\n    this.#watcher.stop();\n    this.#anchorObserver?.disconnect();\n    this.#anchorObserver = null;\n    this.#detachScrollListener();\n    if (this.#frame !== null) {\n      cancelAnimationFrame(this.#frame);\n      this.#frame = null;\n    }\n    this.#intersectionStates.clear();\n    this.#activeSectionId = \"\";\n    this.#rootElement = null;\n  }\n\n  /**\n   * Re-initializes the observer if the offset or rootMargin values change dynamically.\n   */\n  offsetValueChanged(): void {\n    if (!this.#isConnected) return;\n    this.#initializeObserver();\n  }\n\n  rootMarginValueChanged(): void {\n    if (!this.#isConnected) return;\n    this.#initializeObserver();\n  }\n\n  rootSelectorValueChanged(): void {\n    if (!this.#isConnected) return;\n    this.#initializeObserver();\n  }\n\n  /**\n   * Re-syncs the observation set when a Turbo Stream/morph swaps the table of\n   * contents. Stimulus fires these before `connect()` for the links already in\n   * the markup, hence the guard: the initial observer is built exactly once, by\n   * `connect()`.\n   */\n  linkTargetConnected(): void {\n    if (this.#isConnected) this.#scheduleResync();\n  }\n\n  linkTargetDisconnected(): void {\n    if (this.#isConnected) this.#scheduleResync();\n  }\n\n  /**\n   * Queues **one** observation rebuild for the current mutation batch.\n   *\n   * A single Turbo morph can append one link, drop another, and rewrite a\n   * third's `href`, and those arrive through two independent channels —\n   * Stimulus's target callbacks and {@link #anchorObserver}. Each channel just\n   * raises the flag and queues a drain; the first drain to run does the work and\n   * clears it, so every later drain in the same batch finds nothing to do and\n   * the set is rebuilt once instead of three times. `disconnect()` clears the\n   * same flag, which is how a queued rebuild is dropped rather than run against\n   * a detached controller.\n   */\n  #scheduleResync(): void {\n    this.#resyncQueued = true;\n    queueMicrotask(this.#drainResync);\n  }\n\n  readonly #drainResync = (): void => {\n    if (!this.#resyncQueued) return;\n    this.#resyncQueued = false;\n    this.#initializeObserver();\n  };\n\n  /**\n   * Watches the link targets' anchor attributes so an in-place rewrite re-syncs.\n   *\n   * A Turbo 8 morph keeps the element **and** its `data-*-target` marker and\n   * only rewrites attributes, so Stimulus fires no target callback: without\n   * this, a link re-pointed from `#intro` to `#faq` would keep the controller\n   * observing `#intro` for the rest of the page's life. The filter is exactly\n   * {@link ANCHOR_ATTRIBUTES}; guarding on `MutationObserver` keeps the\n   * controller usable where the API is absent, matching `IntersectionWatcher`'s\n   * own support guard.\n   */\n  #observeAnchorAttributes(): void {\n    if (typeof MutationObserver !== \"undefined\") {\n      this.#anchorObserver = new MutationObserver(this.#onAnchorMutation);\n      this.#anchorObserver.observe(this.element, {\n        subtree: true,\n        attributes: true,\n        attributeFilter: ANCHOR_ATTRIBUTES,\n      });\n    }\n  }\n\n  /**\n   * Rebuilds only for a rewrite on a *current* link target. The observer is\n   * scoped to this controller's element, but that subtree also holds links the\n   * author never marked as targets (a \"back to top\" anchor, a nested nav), and\n   * those anchor nothing here.\n   */\n  readonly #onAnchorMutation = (records: MutationRecord[]): void => {\n    const links = this.linkTargets;\n    for (const record of records) {\n      if (!links.includes(record.target as HTMLElement)) continue;\n      this.#scheduleResync();\n      return;\n    }\n  };\n\n  /**\n   * Scrolls to the section the clicked link anchors, honoring `offset` and any\n   * nested scroll container (a plain fragment jump would scroll the window).\n   *\n   * Honors `prefers-reduced-motion` (WCAG 2.2 **2.3.3**) by forcing an instant\n   * jump independently of the consumer's CSS `scroll-behavior`. With\n   * `focusSection` enabled it also moves the sequential focus starting point\n   * into the destination; the URL fragment is deliberately not touched.\n   */\n  scrollTo(event: Event): void {\n    const link = event.currentTarget as HTMLElement;\n    const id = this.#getAnchorId(link);\n    if (!id) return;\n\n    event.preventDefault();\n\n    const targetElement = document.getElementById(id);\n    if (!targetElement) return;\n\n    const behavior: ScrollBehavior = prefersReducedMotion() ? \"instant\" : \"smooth\";\n    const rootElement = this.#scrollRoot();\n    const targetRect = targetElement.getBoundingClientRect();\n    const offset = this.#offset;\n\n    if (rootElement) {\n      const containerRect = rootElement.getBoundingClientRect();\n      const scrollPosition = rootElement.scrollTop + (targetRect.top - containerRect.top) - offset;\n\n      rootElement.scrollTo({ top: scrollPosition, behavior });\n    } else {\n      const scrollPosition = window.scrollY + targetRect.top - offset;\n\n      window.scrollTo({ top: scrollPosition, behavior });\n    }\n\n    if (this.focusSectionValue) this.#focusSection(targetElement);\n  }\n\n  /**\n   * Moves the sequential focus starting point into the section `scrollTo` just\n   * jumped to, so the next Tab continues *inside* the destination instead of\n   * resuming in the table of contents (`preventDefault()` alone would leave the\n   * starting point on the link). Opt-in through `focusSection`, because moving\n   * focus is a decision only the consuming page can make.\n   *\n   * `tabindex=\"-1\"` is established only when the section is not already\n   * focusable and is never removed, so an author-owned tabindex is left alone.\n   * `preventScroll` keeps the focus call from cancelling the smooth scroll\n   * started just above.\n   */\n  #focusSection(section: HTMLElement): void {\n    if (!section.hasAttribute(\"tabindex\")) section.setAttribute(\"tabindex\", \"-1\");\n    section.focus({ preventScroll: true });\n  }\n\n  /**\n   * The cached scroll root, re-resolved when the cached element has left the\n   * document (a Turbo morph replaced the container) so `scrollTo` never\n   * scrolls a detached node.\n   */\n  #scrollRoot(): HTMLElement | null {\n    if (this.#rootElement && !this.#rootElement.isConnected) {\n      this.#rootElement = this.#queryRootElement();\n    }\n    return this.#rootElement;\n  }\n\n  /**\n   * Resolves `rootSelector` to a scrollable element.\n   *\n   * @returns The container, or `null` meaning \"spy the viewport\" when the value\n   * is empty, matches nothing, matches a non-HTML element (an SVG node is not a\n   * scroll container), or is not a valid selector — a typo in a data attribute\n   * must degrade to viewport spying, not leave the controller inert.\n   */\n  #queryRootElement(): HTMLElement | null {\n    if (!this.rootSelectorValue) return null;\n    try {\n      const root = document.querySelector(this.rootSelectorValue);\n      return root instanceof HTMLElement ? root : null;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Re-evaluates once per frame while the reader scrolls.\n   *\n   * `IntersectionObserver` reports **threshold crossings**, not positions, so a\n   * reader moving inside one long section — or across a gap wider than the\n   * observation band — produces no batch at all and the highlight would stay\n   * frozen at whatever the last crossing decided. That would make the current\n   * location depend on the *route* to a position instead of the position: a\n   * stepwise scroll crosses thresholds an instant jump to the same offset never\n   * does. Listening to the scroll source closes the gap, and because both paths\n   * end in {@link #evaluateActiveSection} — which measures section rects and the\n   * root's top edge at that instant — they converge on the same answer.\n   */\n  readonly #onScroll = (): void => {\n    if (this.#frame !== null) return;\n    this.#frame = requestAnimationFrame(() => {\n      this.#frame = null;\n      this.#evaluateActiveSection();\n    });\n  };\n\n  /**\n   * Points the `scroll` listener at whatever the reader actually scrolls: the\n   * resolved root, or the window when the viewport is spied.\n   *\n   * The detach is unconditional, so rebuilding the observation set (a Value\n   * change, a morph) **moves** the listener rather than stacking a second one on\n   * a container the reader has stopped scrolling.\n   */\n  #syncScrollListener(): void {\n    this.#detachScrollListener();\n    this.#scrollSource = this.#rootElement ?? window;\n    this.#scrollSource.addEventListener(\"scroll\", this.#onScroll, { passive: true });\n  }\n\n  #detachScrollListener(): void {\n    this.#scrollSource?.removeEventListener(\"scroll\", this.#onScroll);\n    this.#scrollSource = null;\n  }\n\n  #initializeObserver(): void {\n    this.#watcher.stop();\n    this.#intersectionStates.clear();\n    // The DOM is the source of truth for the current location **only when this\n    // controller has none of its own** — a fresh `connect()`, which is also the\n    // Turbo cache-restore case, where the links still carry `aria-current` from\n    // the snapshot. Adopting it there makes the observer's first batch a silent\n    // confirmation instead of a duplicate `change`.\n    //\n    // On a *live* rebuild the memory wins, because the DOM has stopped meaning\n    // what this controller wrote: an anchor rewritten underneath us leaves\n    // `aria-current` on a link that now points somewhere else, so reading it\n    // back would hand the current location to a section the reader never\n    // scrolled to — and then announce the correction as a `change`, as if they\n    // had travelled there and back.\n    this.#activeSectionId = this.#activeSectionId || this.#activeIdFromDom();\n    this.#rootElement = this.#queryRootElement();\n    this.#syncScrollListener();\n\n    if (this.linkTargets.length === 0) return;\n\n    // Negate the numeric value so a valid negative offset becomes a positive margin.\n    const margin = this.rootMarginValue || `${-this.#offset}px 0px -80% 0px`;\n\n    // Observe each target section mapped by the href anchors.\n    const sections: Element[] = [];\n    for (const link of this.linkTargets) {\n      const id = this.#getAnchorId(link);\n      if (!id) continue;\n      const section = document.getElementById(id);\n      if (section && !sections.includes(section)) sections.push(section);\n    }\n\n    this.#watcher.start(sections, {\n      root: this.#rootElement,\n      rootMargin: margin,\n      threshold: [0, 0.2, 0.4, 0.6, 0.8, 1], // Multiple thresholds handle large sections safely\n    });\n\n    // Republish the adopted location over the *current* link set. Evaluation\n    // writes attributes only when the winning section changes, so a link added\n    // — or re-anchored — while the reader stays put would otherwise never be\n    // marked: a mobile table of contents rendered after the sidebar one would\n    // stay blank until the reader happened to cross into another section.\n    //\n    // Unconditional, including when the adopted location is empty: a link whose\n    // anchor was rewritten to something that resolves nowhere cannot be the\n    // reader's location, and this controller is the one that published the\n    // attribute saying it was, so it is the one that has to take it back.\n    this.#syncActiveStates(false);\n  }\n\n  readonly #onIntersection = (entries: IntersectionObserverEntry[]): void => {\n    // Defense in depth. `IntersectionWatcher` already drops a batch the browser\n    // flushes after `stop()` (its active/identity guard), so this flag is the\n    // second line that keeps a detached controller from mutating `aria-current`\n    // on (possibly cached) links.\n    const isDetached = !this.#isConnected;\n    if (isDetached) return;\n\n    for (const entry of entries) {\n      const sectionId = entry.target.id;\n      if (!sectionId) continue;\n\n      this.#intersectionStates.set(sectionId, {\n        element: entry.target,\n        isIntersecting: entry.isIntersecting,\n      });\n    }\n\n    this.#evaluateActiveSection();\n  };\n\n  /**\n   * Picks the section closest to the trigger line and publishes it.\n   *\n   * Every coordinate is read **now**: the section rects *and* the root's top\n   * edge share one measurement instant. Comparing an entry's recorded\n   * `boundingClientRect.top` (captured whenever that section last crossed a\n   * threshold) against a freshly computed trigger line mixes two moments in\n   * time, which would make the result depend on how the reader arrived at a\n   * position — a smooth scroll and an instant jump to the same offset disagree.\n   */\n  #evaluateActiveSection(): void {\n    // The trigger line is `offset` px below the top of the scroll root. When a\n    // nested `rootSelector` container is used it is not at the viewport top, so\n    // the line must be measured from the container's current top — comparing the\n    // viewport-based rect top against a bare `offset` would otherwise pick the\n    // section nearest the viewport top, not the container's.\n    const rootEl = this.#scrollRoot();\n    const triggerLine = (rootEl ? rootEl.getBoundingClientRect().top : 0) + this.#offset;\n\n    let intersectingId = \"\";\n    let intersectingDistance = Number.POSITIVE_INFINITY;\n    let trackedId = \"\";\n    let trackedDistance = Number.POSITIVE_INFINITY;\n\n    for (const [id, state] of this.#intersectionStates) {\n      const rect = state.element.getBoundingClientRect();\n      // A section with no layout box (`display: none`, a collapsed `<details>`,\n      // an undisplayed Turbo Frame) is reported with an empty rect whose `top`\n      // of 0 carries no position at all. Letting it compete would hand it the\n      // fallback below; it re-enters the race once it is actually laid out.\n      if (rect.width === 0 && rect.height === 0) continue;\n\n      const distance = Math.abs(rect.top - triggerLine);\n      if (distance < trackedDistance) {\n        trackedDistance = distance;\n        trackedId = id;\n      }\n      if (state.isIntersecting && distance < intersectingDistance) {\n        intersectingDistance = distance;\n        intersectingId = id;\n      }\n    }\n\n    // Fallback: when no section currently intersects (e.g. scrolled past the\n    // bottom, or between sections), keep the tracked section whose top is\n    // closest to the trigger line so something stays highlighted.\n    const bestId = intersectingId || trackedId;\n\n    if (bestId && bestId !== this.#activeSectionId) {\n      this.#activeSectionId = bestId;\n      this.#syncActiveStates(true);\n    }\n  }\n\n  /**\n   * Writes `aria-current` across the current link set, optionally announcing.\n   *\n   * The two halves are separate because they answer different questions.\n   * *Attributes* must be idempotently re-established whenever the link set\n   * changes, even though the reader has not moved — otherwise a link that\n   * appears (or is re-anchored) while its section is already current never gets\n   * marked. *The `change` event* announces that the reader moved, so it fires\n   * only from the evaluation path; re-publishing over a new link set is not\n   * news, and dispatching there would make a rebuild look like navigation.\n   *\n   * @param announce Whether this sync represents a change of current section.\n   */\n  #syncActiveStates(announce: boolean): void {\n    // Every link anchoring the active section is marked, not just the first:\n    // a page may render the same table of contents twice (a sidebar and a\n    // collapsed mobile menu) and both must show the current location.\n    const activeLinks = this.linkTargets.filter(\n      (link) => this.#getAnchorId(link) === this.#activeSectionId,\n    );\n\n    for (const link of this.linkTargets) {\n      if (activeLinks.includes(link)) {\n        link.setAttribute(\"aria-current\", \"location\");\n      } else if (link.getAttribute(\"aria-current\") === \"location\") {\n        // Reclaim only the value this controller publishes, so an author-owned\n        // `aria-current=\"page\"` on a table-of-contents link survives.\n        link.removeAttribute(\"aria-current\");\n      }\n    }\n\n    if (!announce) return;\n\n    const primaryLink = activeLinks[0];\n    if (primaryLink) {\n      this.dispatch(\"change\", { detail: { id: this.#activeSectionId, link: primaryLink } });\n    }\n  }\n\n  /**\n   * The current location already encoded in the DOM, i.e. the section anchored\n   * by the first link carrying this controller's `aria-current=\"location\"`.\n   * Empty when no link claims it (a genuinely fresh render).\n   */\n  #activeIdFromDom(): string {\n    for (const link of this.linkTargets) {\n      if (link.getAttribute(\"aria-current\") !== \"location\") continue;\n      const id = this.#getAnchorId(link);\n      if (id) return id;\n    }\n    return \"\";\n  }\n\n  /**\n   * The section id a link anchors, resolved in a fixed order:\n   *\n   * 1. `href`, when it is a non-empty same-document fragment — the contract.\n   * 2. otherwise `data-href`'s fragment — the fallback for a link whose `href`\n   *    must stay a real URL (a server-rendered permalink) or that is not an\n   *    `<a>` at all.\n   * 3. otherwise `null`: the link anchors nothing here and is not observed.\n   *\n   * Step 2 is reached whenever `href` yields nothing usable — absent, `\"#\"`, or\n   * a real URL — which is the whole point of the fallback: `href=\"/guide/usage\"`\n   * with `data-href=\"#usage\"` is a permalink that also spies, and picking the\n   * first *present* attribute instead of the first *usable* one would silently\n   * exclude exactly that markup. When both are valid fragments `href` wins.\n   */\n  #getAnchorId(link: HTMLElement): string | null {\n    return (\n      this.#fragmentId(link.getAttribute(\"href\")) ??\n      this.#fragmentId(link.getAttribute(\"data-href\"))\n    );\n  }\n\n  /** The id in a `#fragment` value; `null` for absent, empty, or non-fragment. */\n  #fragmentId(value: string | null): string | null {\n    if (!value?.startsWith(\"#\")) return null;\n    return value.substring(1) || null;\n  }\n}\n"]}

package/dist/controllers/smart_sticky_header_controller.d.ts

@@ -11,17 +11,22 @@ import { Controller } from '@hotwired/stimulus';
  *           style="position: sticky; top: 0;">…</header>
  *
  * The scroll source is the window by default; inside an overflow container,
- * point `containerSelector` at it (the header usually sits inside it too).
+ * point `containerSelector` at it (the header usually sits inside it too). A
+ * declaration that cannot be parsed as a selector reads as the window, so a
+ * typo costs the container binding rather than the whole header.
  *   <!-- [data-header-hidden="true"] { transform: translateY(-100%); } -->
  *
- * Scrolling down past `offset` px sets `data-header-hidden="true"`; any
- * scroll-up (beyond the `tolerance` jitter guard) or returning above `offset`
- * reveals it again. Focus reaching the header always reveals it, and while
- * focus stays inside the header a scroll-down never hides it — a keyboard
- * user must be able to see where focus went AND keep seeing the element that
- * owns it (WCAG 2.4.7 / 2.4.11).
+ * Scrolling down past `offset` px sets `data-header-hidden="true"`, and a
+ * scroll-up beyond the `tolerance` jitter guard reveals it again. Within the
+ * `offset` zone the header is always revealed, decided ahead of that jitter
+ * guard: a header stranded off-screen near the top cannot be scrolled back
+ * into view. Focus reaching the header always reveals it, and while focus
+ * stays inside the header a scroll-down never hides it — a keyboard user must
+ * be able to see where focus went AND keep seeing the element that owns it
+ * (WCAG 2.4.7 / 2.4.11).
  *
- * `change` dispatches `{ hidden }`.
+ * `change` dispatches `{ hidden }` on transitions only: the reflection
+ * `connect()` performs is the current state rather than a change.
  *
  * @remarks
  * Behavior only — `position: sticky`, the translate animation, and
@@ -51,6 +56,10 @@ declare class SmartStickyHeaderController extends Controller<HTMLElement> {
     containerSelectorValue: string;
     offsetValue: number;
     toleranceValue: number;
+    /** Validates `containerSelector` once so connect never parses a selector that throws. */
+    containerSelectorValueChanged(): void;
+    /** Re-decides when application code (or a Turbo morph) changes `offset` at runtime. */
+    offsetValueChanged(): void;
     connect(): void;
     disconnect(): void;
 }