stimeo-ui 0.15.0 → 0.16.0

package/dist/controllers/overflow_indicator_controller.js

@@ -57,6 +57,36 @@ var BlurDeferral = class {
   }
 };
 
+// src/utils/frame_coalescer.ts
+var FrameCoalescer = class {
+  #frame = null;
+  /**
+   * Runs `run` on the next frame, unless a frame is already pending — the first
+   * request of a burst wins and the rest are dropped. The pending frame is
+   * released before `run`, so `run` may request the next one.
+   */
+  schedule(run) {
+    if (this.#frame !== null) return;
+    this.#frame = requestAnimationFrame(() => {
+      this.#frame = null;
+      run();
+    });
+  }
+  /**
+   * Drops the pending frame, and reaches the platform only when there is one.
+   *
+   * There is no handle value that stands for "nothing pending":
+   * `cancelAnimationFrame` takes an `unsigned long`, so a negative placeholder
+   * arrives as a large positive number that the same allocator can hand out, and
+   * an idle cancel would then drop a frame belonging to someone else.
+   */
+  cancel() {
+    if (this.#frame === null) return;
+    cancelAnimationFrame(this.#frame);
+    this.#frame = null;
+  }
+};
+
 // src/utils/layout_observer.ts
 var LayoutObserver = class {
   #callback;
@@ -139,6 +169,30 @@ var LayoutObserver = class {
   }
 };
 
+// src/utils/listener_set.ts
+var ListenerSet = class {
+  /** The generation every `add` joins until the next `dispose()`. */
+  #abort = new AbortController();
+  /**
+   * Attaches `handler` to the open generation, exactly as the caller spelled it.
+   *
+   * The set supplies the signal, so `options` carries everything else the DOM
+   * accepts — `capture` included, which has to match at release time and no
+   * longer has a second place to drift from.
+   */
+  add(target, type, handler, options) {
+    target.addEventListener(type, handler, { ...options, signal: this.#abort.signal });
+  }
+  /**
+   * Releases every listener of the open generation, synchronously, and opens the
+   * next one. Idempotent, and safe before anything has been added.
+   */
+  dispose() {
+    this.#abort.abort();
+    this.#abort = new AbortController();
+  }
+};
+
 // src/utils/logical_scroll.ts
 function isRtl(element) {
   return window.getComputedStyle(element).direction === "rtl";
@@ -162,18 +216,31 @@ function prefersReducedMotion() {
 }
 
 // src/controllers/overflow_indicator_controller.ts
-var DIRECTION_BUTTON_SELECTOR = "[data-stimeo--overflow-indicator-direction-param]";
+var DIRECTION_PARAM = "direction-param";
 var OverflowIndicatorController = class extends Controller {
+  /** The direction param above, in the namespace this controller is registered under. */
+  get #directionParam() {
+    return `data-${this.identifier}-${DIRECTION_PARAM}`;
+  }
+  /** Selects every button carrying that param. */
+  get #directionButtonSelector() {
+    return `[${this.#directionParam}]`;
+  }
   static targets = ["viewport"];
   static values = {
     orientation: { type: String, default: "horizontal" },
     threshold: { type: Number, default: 1 }
   };
-  static actions = ["scrollByPage", "update"];
+  static actions = ["scrollByPage"];
   static events = ["change"];
   #layout = new LayoutObserver(() => {
-    if (this.#connected) this.update();
+    if (this.#connected) this.#refresh();
   });
+  /** Folds a burst of scrolls into one measurement per frame. */
+  #frames = new FrameCoalescer();
+  /** Holds the viewport's scroll listener for exactly as long as that viewport. */
+  #viewportListeners = new ListenerSet();
+  #onScroll = () => this.#frames.schedule(() => this.#refresh());
   #connected = false;
   #observedViewport = null;
   #observedContent = /* @__PURE__ */ new Set();
@@ -209,16 +276,17 @@ var OverflowIndicatorController = class extends Controller {
     this.#syncViewport();
   }
   orientationValueChanged() {
-    if (this.#connected) this.update();
+    if (this.#connected) this.#refresh();
   }
   thresholdValueChanged() {
-    if (this.#connected) this.update();
+    if (this.#connected) this.#refresh();
   }
   /**
    * Re-measures remaining scroll room and reflects the state hooks.
-   * Public so it can be wired to the viewport's `scroll`.
+   *
+   * @stimeoRenderRoot
    */
-  update() {
+  #refresh() {
     if (!this.hasViewportTarget) return;
     const vp = this.viewportTarget;
     const horizontal = this.orientationValue !== "vertical";
@@ -255,16 +323,16 @@ var OverflowIndicatorController = class extends Controller {
   /** Mirrors remaining room onto any direction buttons by toggling `disabled`. */
   #syncButtons(start, end) {
     for (const button of this.#pendingButtonDisables.elements) {
-      if (!button.isConnected || button.closest("[data-controller~='stimeo--overflow-indicator']") !== this.element) {
+      if (!button.isConnected || button.closest(`[data-controller~='${this.identifier}']`) !== this.element) {
         this.#cancelPendingButtonDisable(button);
       }
     }
-    const buttons = this.element.querySelectorAll(DIRECTION_BUTTON_SELECTOR);
+    const buttons = this.element.querySelectorAll(this.#directionButtonSelector);
     for (const button of buttons) {
-      if (button.closest("[data-controller~='stimeo--overflow-indicator']") !== this.element) {
+      if (button.closest(`[data-controller~='${this.identifier}']`) !== this.element) {
         continue;
       }
-      const direction = button.getAttribute("data-stimeo--overflow-indicator-direction-param");
+      const direction = button.getAttribute(this.#directionParam);
       if (direction === "start") this.#toggleButton(button, start);
       else if (direction === "end") this.#toggleButton(button, end);
     }
@@ -348,6 +416,7 @@ var OverflowIndicatorController = class extends Controller {
     this.#stopObservingViewport();
     if (!next) return;
     this.#observedViewport = next;
+    this.#viewportListeners.add(next, "scroll", this.#onScroll, { passive: true });
     this.#layout.observe(next);
     this.#layout.observeViewport();
     this.#layout.observeDescendantLoads(next);
@@ -356,7 +425,7 @@ var OverflowIndicatorController = class extends Controller {
       this.#mutationObserver = new MutationObserver(() => {
         if (!this.#connected || this.#observedViewport !== next) return;
         this.#syncContentObservation();
-        this.update();
+        this.#refresh();
       });
       this.#mutationObserver.observe(this.element, {
         childList: true,
@@ -367,7 +436,7 @@ var OverflowIndicatorController = class extends Controller {
       });
     }
     this.#state = null;
-    this.update();
+    this.#refresh();
   }
   /** Observes direct content boxes whose resize can change the viewport's scroll extent. */
   #syncContentObservation() {
@@ -386,6 +455,8 @@ var OverflowIndicatorController = class extends Controller {
     }
   }
   #stopObservingViewport() {
+    this.#frames.cancel();
+    this.#viewportListeners.dispose();
     this.#mutationObserver?.disconnect();
     this.#mutationObserver = null;
     this.#layout.unobserveDescendantLoads();

package/dist/controllers/overflow_indicator_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/blur_deferral.ts","../../src/utils/layout_observer.ts","../../src/utils/logical_scroll.ts","../../src/utils/reduced_motion.ts","../../src/controllers/overflow_indicator_controller.ts"],"names":[],"mappings":"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","file":"overflow_indicator_controller.js","sourcesContent":["/**\n * Shared bookkeeping for updates that must wait until an element loses focus.\n *\n * A control that becomes redundant while the user is standing on it cannot be\n * removed from the page immediately: hiding a focused element (or turning it\n * into a native `disabled` one) drops focus to `<body>`, stranding a keyboard\n * user mid-widget. The fix every affected controller reached for is the same —\n * keep the element reachable, hold the destructive update, listen for `blur`,\n * and apply it then.\n *\n * {@link BlurDeferral} owns *only* the registry part of that: which elements are\n * currently holding an update back, attaching and detaching the `blur` listener,\n * and guaranteeing teardown. It is deliberately **policy-free** — what the\n * interim state looks like (`aria-disabled`, an ownership marker, nothing at\n * all), and what the deferred update actually is, stay in the controller, which\n * receives the element back through its release callback.\n *\n * Three contracts are worth stating up front, because each one is a hazard the\n * consumers would otherwise hit:\n *\n * - **The release callback fires only on a real `blur`.** `release()` /\n *   `releaseAll()` *cancel* a deferral; they do not complete it. Conflating the\n *   two makes `overflow-indicator` disable a button that just left the boundary.\n * - **`elements` is a snapshot.** Iterating the live key set while releasing\n *   inside the loop is the failure this registry exists to prevent.\n * - **The entry is detached before the callback runs**, so a controller that\n *   decides the update is still unsafe can simply defer again.\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 contracts belong on the members.\n *\n * @example\n * ```ts\n * readonly #deferred = new BlurDeferral<HTMLElement>((trigger) => {\n *   if (this.#connected) this.#evaluate();\n * });\n *\n * #hide(trigger: HTMLElement) {\n *   if (document.activeElement === trigger) {\n *     this.#deferred.deferOnly(trigger); // stays visible until blur\n *     return;\n *   }\n *   this.#deferred.releaseAll();\n *   trigger.hidden = true;\n * }\n *\n * disconnect() {\n *   this.#deferred.releaseAll();\n * }\n * ```\n */\nexport class BlurDeferral<T extends HTMLElement = HTMLElement> {\n  /** Elements currently holding an update back, mapped to their `blur` listener. */\n  readonly #pending = new Map<T, () => void>();\n  /** Called after a pending element blurs and has been detached. */\n  readonly #onRelease: (element: T) => void;\n\n  /** @param onRelease - Invoked once `element` actually blurs; never on `release`. */\n  constructor(onRelease: (element: T) => void) {\n    this.#onRelease = onRelease;\n  }\n\n  /** Number of elements currently holding an update back. */\n  get size(): number {\n    return this.#pending.size;\n  }\n\n  /** Snapshot of the pending elements, safe to iterate while releasing them. */\n  get elements(): T[] {\n    return [...this.#pending.keys()];\n  }\n\n  /** Whether `element` is currently holding an update back. */\n  has(element: T): boolean {\n    return this.#pending.has(element);\n  }\n\n  /** Holds an update back until `element` blurs. Idempotent (no stacked listeners). */\n  defer(element: T): void {\n    if (this.#pending.has(element)) return;\n    const onBlur = (): void => {\n      this.#detach(element);\n      this.#onRelease(element);\n    };\n    this.#pending.set(element, onBlur);\n    element.addEventListener(\"blur\", onBlur);\n  }\n\n  /** Defers `element` as the only pending entry, cancelling any others. */\n  deferOnly(element: T): void {\n    for (const pending of this.elements) {\n      if (pending !== element) this.#detach(pending);\n    }\n    this.defer(element);\n  }\n\n  /** Cancels `element`'s deferral without completing it; no-ops when not pending. */\n  release(element: T): void {\n    this.#detach(element);\n  }\n\n  /** Cancels every deferral without completing any of them. */\n  releaseAll(): void {\n    for (const element of this.elements) this.#detach(element);\n  }\n\n  /** Removes the `blur` listener for `element` and forgets it. */\n  #detach(element: T): void {\n    const onBlur = this.#pending.get(element);\n    if (onBlur) element.removeEventListener(\"blur\", onBlur);\n    this.#pending.delete(element);\n  }\n}\n","/**\n * Unified layout observation for Stimeo controllers.\n *\n * Widgets whose output is measured — an overflow boundary, a masonry column count,\n * an autosized textarea — have three sources that move the layout under them: their\n * *own* box changing — via {@link ResizeObserver} — the *viewport* changing — via the\n * `window` `resize` event — and a descendant *resource settling*, because an image or\n * a frame reports a height of zero until it has loaded. Wiring those three by hand in\n * every controller risks leaked listeners on `disconnect()`. {@link LayoutObserver}\n * owns all three 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 *   this.#layout.observeDescendantLoads(this.panelTarget);\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  #loadContainer: Element | null = null;\n\n  /** Stable bound handler so add/removeEventListener target the same reference. */\n  readonly #handleViewportResize = (): void => {\n    this.#callback();\n  };\n\n  /** Stable bound handler for the capture-phase `load`; see {@link observeDescendantLoads}. */\n  readonly #handleDescendantLoad = (): 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   * Starts reporting a `load` from anywhere inside `container` — an image or a\n   * frame settling changes the box it sits in, and it measures as zero high until\n   * then. `load` does not bubble, so the subscription is a capture-phase listener\n   * on the container itself and nothing the caller spells.\n   *\n   * **One container at a time.** A further call moves the observation, so a widget\n   * whose content element is swapped at runtime releases the element it let go by\n   * naming the new one — there is no second place for the release to drift from.\n   */\n  observeDescendantLoads(container: Element): void {\n    this.unobserveDescendantLoads();\n    this.#loadContainer = container;\n    container.addEventListener(\"load\", this.#handleDescendantLoad, true);\n  }\n\n  /** Stops reporting descendant loads without affecting element or viewport observation. */\n  unobserveDescendantLoads(): void {\n    this.#loadContainer?.removeEventListener(\"load\", this.#handleDescendantLoad, true);\n    this.#loadContainer = null;\n  }\n\n  /**\n   * Releases every observation: disconnects the {@link ResizeObserver} and removes\n   * the viewport and descendant-load listeners. Safe to call multiple times. Call\n   * this from a controller's `disconnect()`.\n   */\n  disconnect(): void {\n    this.#resizeObserver?.disconnect();\n    this.#resizeObserver = null;\n    this.unobserveViewport();\n    this.unobserveDescendantLoads();\n  }\n}\n","/** Normalized scroll position and maximum distance on one logical axis. */\nexport interface LogicalScrollMetrics {\n  position: number;\n  max: number;\n}\n\n/**\n * Whether horizontal scrolling on `element` follows right-to-left inline flow.\n *\n * Resolved from the **computed** `direction`, so the authoring contract is the\n * usual `dir=\"rtl\"` (or a stylesheet) on the element or any ancestor.\n *\n * Scope: horizontal writing modes. A vertical writing mode (`writing-mode:\n * vertical-rl`) also inverts the horizontal axis, which this check does not\n * model — vertical writing modes are out of scope for the scroll utilities\n * (their consumers describe axes as horizontal/vertical, not inline/block).\n */\nexport function isRtl(element: Element): boolean {\n  return window.getComputedStyle(element).direction === \"rtl\";\n}\n\n/**\n * Returns scroll distance from the logical start edge.\n *\n * CSSOM View exposes standards-mode RTL horizontal offsets as `0` at the inline\n * start (right) and increasingly negative values toward the inline end (left).\n * The normalized position is always clamped to `[0, max]`, which also absorbs\n * Safari's elastic overscroll values.\n */\nexport function logicalScrollMetrics(\n  element: HTMLElement,\n  horizontal: boolean,\n): LogicalScrollMetrics {\n  const max = Math.max(\n    0,\n    horizontal\n      ? element.scrollWidth - element.clientWidth\n      : element.scrollHeight - element.clientHeight,\n  );\n  const raw = horizontal ? element.scrollLeft : element.scrollTop;\n  const position = horizontal && isRtl(element) ? -raw : raw;\n  return { position: Math.min(max, Math.max(0, position)), max };\n}\n\n/**\n * Converts a logical start/end delta to the physical value accepted by\n * `Element.scrollBy`.\n */\nexport function physicalScrollDelta(\n  element: HTMLElement,\n  horizontal: boolean,\n  logicalDelta: number,\n): number {\n  return horizontal && isRtl(element) ? -logicalDelta : logicalDelta;\n}\n","/**\n * Shared `prefers-reduced-motion` lookup for the motion-aware controllers.\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 { BlurDeferral } from \"../utils/blur_deferral\";\nimport { LayoutObserver } from \"../utils/layout_observer\";\nimport { logicalScrollMetrics, physicalScrollDelta } from \"../utils/logical_scroll\";\nimport { prefersReducedMotion } from \"../utils/reduced_motion\";\n\nconst DIRECTION_BUTTON_SELECTOR = \"[data-stimeo--overflow-indicator-direction-param]\";\n\n/**\n * Headless **Overflow Indicator**: detects whether a scroll container can still\n * scroll toward its start and/or end and publishes it as `data-overflow-start` /\n * `data-overflow-end`. No APG widget — a state-detection utility. Consumers draw\n * edge shadows or arrows in CSS to signal \"more content this way\".\n *\n * Markup contract (identifier: `stimeo--overflow-indicator`):\n *   <div data-controller=\"stimeo--overflow-indicator\"\n *        data-stimeo--overflow-indicator-orientation-value=\"horizontal\">\n *     <button type=\"button\" aria-label=\"Prev\"\n *             data-stimeo--overflow-indicator-direction-param=\"start\"\n *             data-action=\"click->stimeo--overflow-indicator#scrollByPage\">‹</button>\n *     <div data-stimeo--overflow-indicator-target=\"viewport\"\n *          data-action=\"scroll->stimeo--overflow-indicator#update\"\n *          tabindex=\"0\" role=\"region\" aria-label=\"Products\"\n *          style=\"overflow-x: auto;\"><!-- items --></div>\n *     <button type=\"button\" aria-label=\"Next\"\n *             data-stimeo--overflow-indicator-direction-param=\"end\"\n *             data-action=\"click->stimeo--overflow-indicator#scrollByPage\">›</button>\n *   </div>\n *\n * The viewport's scroll position and size are watched (via the wired `scroll`\n * action, plus `LayoutObserver` for viewport/content resize, a\n * {@link MutationObserver}, and descendant load events). Optional page buttons\n * scroll one logical viewport page at a time (including RTL) and have their\n * disabled state synced to the matching direction's remaining room.\n *\n * `change` dispatches `{ start: boolean, end: boolean }`.\n *\n * @remarks\n * Behavior only — shadows, arrows, and gradients are the consumer's CSS;\n * `data-overflow-*` carry no ARIA semantics. All observers/listeners are released\n * on `disconnect()` (Turbo navigation included). `scrollByPage` scrolls smoothly\n * by default and forces an instant jump under `prefers-reduced-motion`, regardless\n * of the consumer's CSS `scroll-behavior`.\n */\nexport class OverflowIndicatorController extends Controller<HTMLElement> {\n  static override targets = [\"viewport\"];\n  static override values = {\n    orientation: { type: String, default: \"horizontal\" },\n    threshold: { type: Number, default: 1 },\n  };\n  static actions = [\"scrollByPage\", \"update\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly viewportTarget: HTMLElement;\n  declare readonly hasViewportTarget: boolean;\n\n  declare orientationValue: string;\n  declare thresholdValue: number;\n\n  readonly #layout = new LayoutObserver(() => {\n    if (this.#connected) this.update();\n  });\n  #connected = false;\n  #observedViewport: HTMLElement | null = null;\n  readonly #observedContent = new Set<Element>();\n  #mutationObserver: MutationObserver | null = null;\n  /**\n   * Boundary buttons whose native `disabled` is held back while they hold focus.\n   *\n   * Completing the deferral is what actually disables the button, so the release\n   * callback — unlike {@link #cancelPendingButtonDisable} — applies it.\n   */\n  readonly #pendingButtonDisables = new BlurDeferral<HTMLButtonElement>((button) => {\n    this.#restorePendingMarkers(button);\n    // If the author disabled it while focus was pending, do not claim ownership.\n    if (!button.disabled) this.#disableButton(button);\n  });\n  /** Last reported room, so `change` fires only on transitions. */\n  #state: { start: boolean; end: boolean } | null = null;\n\n  override connect(): void {\n    this.#connected = true;\n    this.#syncViewport();\n  }\n\n  override disconnect(): void {\n    this.#connected = false;\n    this.#stopObservingViewport();\n    this.#layout.disconnect();\n    this.#clearPendingButtonDisables();\n    this.#state = null;\n  }\n\n  viewportTargetConnected(): void {\n    this.#syncViewport();\n  }\n\n  viewportTargetDisconnected(viewport: HTMLElement): void {\n    if (this.#observedViewport === viewport) this.#stopObservingViewport();\n    this.#syncViewport();\n  }\n\n  orientationValueChanged(): void {\n    if (this.#connected) this.update();\n  }\n\n  thresholdValueChanged(): void {\n    if (this.#connected) this.update();\n  }\n\n  /**\n   * Re-measures remaining scroll room and reflects the state hooks.\n   * Public so it can be wired to the viewport's `scroll`.\n   */\n  update(): void {\n    if (!this.hasViewportTarget) return;\n    const vp = this.viewportTarget;\n    const horizontal = this.orientationValue !== \"vertical\";\n    const t = this.#threshold;\n    const { position: scrollPos, max: maxScroll } = logicalScrollMetrics(vp, horizontal);\n\n    const start = scrollPos > t;\n    const end = scrollPos < maxScroll - t;\n\n    vp.setAttribute(\"data-overflow-start\", start ? \"true\" : \"false\");\n    vp.setAttribute(\"data-overflow-end\", end ? \"true\" : \"false\");\n    this.#syncButtons(start, end);\n\n    if (!this.#state || this.#state.start !== start || this.#state.end !== end) {\n      this.#state = { start, end };\n      this.dispatch(\"change\", { detail: { start, end } });\n    }\n  }\n\n  /** Scrolls one viewport page toward the `direction` param (`start`/`end`). */\n  scrollByPage(event: Event): void {\n    if (!this.hasViewportTarget) return;\n    const direction = this.#directionFromEvent(event);\n    if (!direction) return;\n    if (this.#state && !this.#state[direction]) return;\n\n    const vp = this.viewportTarget;\n    const horizontal = this.orientationValue !== \"vertical\";\n    const page = horizontal ? vp.clientWidth : vp.clientHeight;\n    const logicalDelta = direction === \"start\" ? -page : page;\n    const delta = physicalScrollDelta(vp, horizontal, logicalDelta);\n    const behavior: ScrollBehavior = prefersReducedMotion() ? \"instant\" : \"smooth\";\n\n    if (horizontal) {\n      vp.scrollBy({ left: delta, behavior });\n    } else {\n      vp.scrollBy({ top: delta, behavior });\n    }\n  }\n\n  /** Mirrors remaining room onto any direction buttons by toggling `disabled`. */\n  #syncButtons(start: boolean, end: boolean): void {\n    for (const button of this.#pendingButtonDisables.elements) {\n      if (\n        !button.isConnected ||\n        button.closest(\"[data-controller~='stimeo--overflow-indicator']\") !== this.element\n      ) {\n        this.#cancelPendingButtonDisable(button);\n      }\n    }\n    const buttons = this.element.querySelectorAll<HTMLButtonElement>(DIRECTION_BUTTON_SELECTOR);\n    for (const button of buttons) {\n      if (button.closest(\"[data-controller~='stimeo--overflow-indicator']\") !== this.element) {\n        continue;\n      }\n      const direction = button.getAttribute(\"data-stimeo--overflow-indicator-direction-param\");\n      if (direction === \"start\") this.#toggleButton(button, start);\n      else if (direction === \"end\") this.#toggleButton(button, end);\n    }\n  }\n\n  /**\n   * Reflects the remaining room onto a page button's `disabled`, owning only the\n   * `disabled` it sets itself via a marker (`data-overflow-indicator-disabled`,\n   * like `number-input`/`conditional-fields`). An author-disabled button (e.g. the\n   * whole control disabled) is therefore never blindly re-enabled.\n   */\n  #toggleButton(button: HTMLButtonElement, hasRoom: boolean): void {\n    // A restored Turbo snapshot can carry pending markers from the previous visit\n    // that this instance never created; release them from the DOM record before\n    // deciding, or the displaced `aria-disabled` would never be given back.\n    if (\n      !this.#pendingButtonDisables.has(button) &&\n      button.hasAttribute(\"data-overflow-indicator-pending-disabled\")\n    ) {\n      this.#cancelPendingButtonDisable(button);\n    }\n    if (hasRoom) {\n      this.#cancelPendingButtonDisable(button);\n      if (button.hasAttribute(\"data-overflow-indicator-disabled\")) {\n        button.disabled = false;\n        button.removeAttribute(\"data-overflow-indicator-disabled\");\n      }\n      return;\n    }\n    if (button.disabled) return; // already disabled (possibly by the author) — leave it\n    if (document.activeElement === button) {\n      this.#deferButtonDisable(button);\n    } else {\n      this.#disableButton(button);\n    }\n  }\n\n  /**\n   * Keeps a boundary button focusable until native blur, exposing its temporary\n   * inoperability with `aria-disabled` and making its action a no-op meanwhile.\n   */\n  #deferButtonDisable(button: HTMLButtonElement): void {\n    if (this.#pendingButtonDisables.has(button)) return;\n    button.setAttribute(\"data-overflow-indicator-pending-disabled\", \"\");\n    // The ownership marker carries the value we displace, so the DOM alone is\n    // enough to undo it. A Turbo snapshot is cloned before `disconnect()` runs,\n    // so a restored page arrives with these markers while the new instance has\n    // no in-memory record of them — an empty marker means \"there was none\".\n    button.setAttribute(\n      \"data-overflow-indicator-aria-disabled\",\n      button.getAttribute(\"aria-disabled\") ?? \"\",\n    );\n    button.setAttribute(\"aria-disabled\", \"true\");\n    this.#pendingButtonDisables.defer(button);\n  }\n\n  #disableButton(button: HTMLButtonElement): void {\n    button.disabled = true;\n    button.setAttribute(\"data-overflow-indicator-disabled\", \"\");\n  }\n\n  /** Cancels a pending disable without applying it, restoring the displaced state. */\n  #cancelPendingButtonDisable(button: HTMLButtonElement): void {\n    this.#pendingButtonDisables.release(button);\n    this.#restorePendingMarkers(button);\n  }\n\n  /**\n   * Drops the pending marker and gives back the `aria-disabled` it displaced.\n   *\n   * Reads the displaced value from the DOM rather than memory: a Turbo snapshot is\n   * cloned before `disconnect()` runs, so a restored page can arrive with markers\n   * this instance never wrote.\n   */\n  #restorePendingMarkers(button: HTMLButtonElement): void {\n    button.removeAttribute(\"data-overflow-indicator-pending-disabled\");\n    const displaced = button.getAttribute(\"data-overflow-indicator-aria-disabled\");\n    if (displaced !== null) {\n      button.removeAttribute(\"data-overflow-indicator-aria-disabled\");\n      if (button.getAttribute(\"aria-disabled\") === \"true\") {\n        if (displaced === \"\") button.removeAttribute(\"aria-disabled\");\n        else button.setAttribute(\"aria-disabled\", displaced);\n      }\n    }\n  }\n\n  #clearPendingButtonDisables(): void {\n    for (const button of this.#pendingButtonDisables.elements) {\n      this.#cancelPendingButtonDisable(button);\n    }\n  }\n\n  /** Moves resize/mutation/load observation to the current viewport target. */\n  #syncViewport(): void {\n    if (!this.#connected) return;\n    const next = this.hasViewportTarget ? this.viewportTarget : null;\n    if (next === this.#observedViewport) return;\n    this.#stopObservingViewport();\n    if (!next) return;\n\n    this.#observedViewport = next;\n    this.#layout.observe(next);\n    this.#layout.observeViewport();\n    this.#layout.observeDescendantLoads(next);\n    this.#syncContentObservation();\n\n    if (typeof MutationObserver !== \"undefined\") {\n      this.#mutationObserver = new MutationObserver(() => {\n        if (!this.#connected || this.#observedViewport !== next) return;\n        this.#syncContentObservation();\n        this.update();\n      });\n      this.#mutationObserver.observe(this.element, {\n        childList: true,\n        subtree: true,\n        characterData: true,\n        attributes: true,\n        attributeFilter: [\"class\", \"style\", \"hidden\"],\n      });\n    }\n    this.#state = null;\n    this.update();\n  }\n\n  /** Observes direct content boxes whose resize can change the viewport's scroll extent. */\n  #syncContentObservation(): void {\n    const next = new Set<Element>(this.#observedViewport?.children ?? []);\n    for (const content of this.#observedContent) {\n      if (!next.has(content)) {\n        this.#layout.unobserve(content);\n        this.#observedContent.delete(content);\n      }\n    }\n    for (const content of next) {\n      if (!this.#observedContent.has(content)) {\n        this.#observedContent.add(content);\n        this.#layout.observe(content);\n      }\n    }\n  }\n\n  #stopObservingViewport(): void {\n    this.#mutationObserver?.disconnect();\n    this.#mutationObserver = null;\n    this.#layout.unobserveDescendantLoads();\n    if (this.#observedViewport) this.#layout.unobserve(this.#observedViewport);\n    for (const content of this.#observedContent) this.#layout.unobserve(content);\n    this.#observedContent.clear();\n    this.#observedViewport = null;\n    this.#layout.unobserveViewport();\n  }\n\n  get #threshold(): number {\n    const value = this.thresholdValue;\n    return Number.isFinite(value) ? Math.max(0, value) : 1;\n  }\n\n  #directionFromEvent(event: Event): \"start\" | \"end\" | null {\n    const params = (event as Event & { params?: { direction?: unknown } }).params;\n    const direction = params?.direction;\n    return direction === \"start\" || direction === \"end\" ? direction : null;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/blur_deferral.ts","../../src/utils/frame_coalescer.ts","../../src/utils/layout_observer.ts","../../src/utils/listener_set.ts","../../src/utils/logical_scroll.ts","../../src/utils/reduced_motion.ts","../../src/controllers/overflow_indicator_controller.ts"],"names":[],"mappings":"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","file":"overflow_indicator_controller.js","sourcesContent":["/**\n * Shared bookkeeping for updates that must wait until an element loses focus.\n *\n * A control that becomes redundant while the user is standing on it cannot be\n * removed from the page immediately: hiding a focused element (or turning it\n * into a native `disabled` one) drops focus to `<body>`, stranding a keyboard\n * user mid-widget. The fix every affected controller reached for is the same —\n * keep the element reachable, hold the destructive update, listen for `blur`,\n * and apply it then.\n *\n * {@link BlurDeferral} owns *only* the registry part of that: which elements are\n * currently holding an update back, attaching and detaching the `blur` listener,\n * and guaranteeing teardown. It is deliberately **policy-free** — what the\n * interim state looks like (`aria-disabled`, an ownership marker, nothing at\n * all), and what the deferred update actually is, stay in the controller, which\n * receives the element back through its release callback.\n *\n * Three contracts are worth stating up front, because each one is a hazard the\n * consumers would otherwise hit:\n *\n * - **The release callback fires only on a real `blur`.** `release()` /\n *   `releaseAll()` *cancel* a deferral; they do not complete it. Conflating the\n *   two makes `overflow-indicator` disable a button that just left the boundary.\n * - **`elements` is a snapshot.** Iterating the live key set while releasing\n *   inside the loop is the failure this registry exists to prevent.\n * - **The entry is detached before the callback runs**, so a controller that\n *   decides the update is still unsafe can simply defer again.\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 contracts belong on the members.\n *\n * @example\n * ```ts\n * readonly #deferred = new BlurDeferral<HTMLElement>((trigger) => {\n *   if (this.#connected) this.#evaluate();\n * });\n *\n * #hide(trigger: HTMLElement) {\n *   if (document.activeElement === trigger) {\n *     this.#deferred.deferOnly(trigger); // stays visible until blur\n *     return;\n *   }\n *   this.#deferred.releaseAll();\n *   trigger.hidden = true;\n * }\n *\n * disconnect() {\n *   this.#deferred.releaseAll();\n * }\n * ```\n */\nexport class BlurDeferral<T extends HTMLElement = HTMLElement> {\n  /** Elements currently holding an update back, mapped to their `blur` listener. */\n  readonly #pending = new Map<T, () => void>();\n  /** Called after a pending element blurs and has been detached. */\n  readonly #onRelease: (element: T) => void;\n\n  /** @param onRelease - Invoked once `element` actually blurs; never on `release`. */\n  constructor(onRelease: (element: T) => void) {\n    this.#onRelease = onRelease;\n  }\n\n  /** Number of elements currently holding an update back. */\n  get size(): number {\n    return this.#pending.size;\n  }\n\n  /** Snapshot of the pending elements, safe to iterate while releasing them. */\n  get elements(): T[] {\n    return [...this.#pending.keys()];\n  }\n\n  /** Whether `element` is currently holding an update back. */\n  has(element: T): boolean {\n    return this.#pending.has(element);\n  }\n\n  /** Holds an update back until `element` blurs. Idempotent (no stacked listeners). */\n  defer(element: T): void {\n    if (this.#pending.has(element)) return;\n    const onBlur = (): void => {\n      this.#detach(element);\n      this.#onRelease(element);\n    };\n    this.#pending.set(element, onBlur);\n    element.addEventListener(\"blur\", onBlur);\n  }\n\n  /** Defers `element` as the only pending entry, cancelling any others. */\n  deferOnly(element: T): void {\n    for (const pending of this.elements) {\n      if (pending !== element) this.#detach(pending);\n    }\n    this.defer(element);\n  }\n\n  /** Cancels `element`'s deferral without completing it; no-ops when not pending. */\n  release(element: T): void {\n    this.#detach(element);\n  }\n\n  /** Cancels every deferral without completing any of them. */\n  releaseAll(): void {\n    for (const element of this.elements) this.#detach(element);\n  }\n\n  /** Removes the `blur` listener for `element` and forgets it. */\n  #detach(element: T): void {\n    const onBlur = this.#pending.get(element);\n    if (onBlur) element.removeEventListener(\"blur\", onBlur);\n    this.#pending.delete(element);\n  }\n}\n","/**\n * Runs one piece of scroll-driven work per animation frame.\n *\n * A `scroll` listener fires many times between two paints, and each firing would\n * measure the same layout. Requesting a frame on the first firing and ignoring\n * the rest until it runs keeps the reads to one per frame; running on the frame\n * — rather than on a timer — keeps the measurement in step with what the reader\n * sees.\n *\n * **The first request of a burst wins.** Work handed in while a frame is already\n * pending is dropped, so a caller that queues a special first pass and then\n * receives scrolls gets that first pass, not the last scroll's.\n *\n * Cancelling drops the pending frame outright, and does nothing at all when none\n * is pending. A frame really is cancelled, so nothing needs a generation to tell\n * a stale callback from a fresh one, and nothing has to be refused before the\n * caller starts listening.\n *\n * Scope is the scheduling only. What to measure stays with the caller.\n *\n * @example\n * ```ts\n * readonly #frames = new FrameCoalescer();\n *\n * readonly #onScroll = (): void => this.#frames.schedule(() => this.#measure());\n *\n * disconnect(): void {\n *   this.#frames.cancel();\n * }\n * ```\n */\nexport class FrameCoalescer {\n  #frame: number | null = null;\n\n  /**\n   * Runs `run` on the next frame, unless a frame is already pending — the first\n   * request of a burst wins and the rest are dropped. The pending frame is\n   * released before `run`, so `run` may request the next one.\n   */\n  schedule(run: () => void): void {\n    if (this.#frame !== null) return;\n    this.#frame = requestAnimationFrame(() => {\n      this.#frame = null;\n      run();\n    });\n  }\n\n  /**\n   * Drops the pending frame, and reaches the platform only when there is one.\n   *\n   * There is no handle value that stands for \"nothing pending\":\n   * `cancelAnimationFrame` takes an `unsigned long`, so a negative placeholder\n   * arrives as a large positive number that the same allocator can hand out, and\n   * an idle cancel would then drop a frame belonging to someone else.\n   */\n  cancel(): void {\n    if (this.#frame === null) return;\n    cancelAnimationFrame(this.#frame);\n    this.#frame = null;\n  }\n}\n","/**\n * Unified layout observation for Stimeo controllers.\n *\n * Widgets whose output is measured — an overflow boundary, a masonry column count,\n * an autosized textarea — have three sources that move the layout under them: their\n * *own* box changing — via {@link ResizeObserver} — the *viewport* changing — via the\n * `window` `resize` event — and a descendant *resource settling*, because an image or\n * a frame reports a height of zero until it has loaded. Wiring those three by hand in\n * every controller risks leaked listeners on `disconnect()`. {@link LayoutObserver}\n * owns all three 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 *   this.#layout.observeDescendantLoads(this.panelTarget);\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  #loadContainer: Element | null = null;\n\n  /** Stable bound handler so add/removeEventListener target the same reference. */\n  readonly #handleViewportResize = (): void => {\n    this.#callback();\n  };\n\n  /** Stable bound handler for the capture-phase `load`; see {@link observeDescendantLoads}. */\n  readonly #handleDescendantLoad = (): 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   * Starts reporting a `load` from anywhere inside `container` — an image or a\n   * frame settling changes the box it sits in, and it measures as zero high until\n   * then. `load` does not bubble, so the subscription is a capture-phase listener\n   * on the container itself and nothing the caller spells.\n   *\n   * **One container at a time.** A further call moves the observation, so a widget\n   * whose content element is swapped at runtime releases the element it let go by\n   * naming the new one — there is no second place for the release to drift from.\n   */\n  observeDescendantLoads(container: Element): void {\n    this.unobserveDescendantLoads();\n    this.#loadContainer = container;\n    container.addEventListener(\"load\", this.#handleDescendantLoad, true);\n  }\n\n  /** Stops reporting descendant loads without affecting element or viewport observation. */\n  unobserveDescendantLoads(): void {\n    this.#loadContainer?.removeEventListener(\"load\", this.#handleDescendantLoad, true);\n    this.#loadContainer = null;\n  }\n\n  /**\n   * Releases every observation: disconnects the {@link ResizeObserver} and removes\n   * the viewport and descendant-load listeners. Safe to call multiple times. Call\n   * this from a controller's `disconnect()`.\n   */\n  disconnect(): void {\n    this.#resizeObserver?.disconnect();\n    this.#resizeObserver = null;\n    this.unobserveViewport();\n    this.unobserveDescendantLoads();\n  }\n}\n","/**\n * Owns every listener a controller attaches for one connected lifetime and\n * releases them together, so an event name is spelled once and the release\n * cannot drift from the registration.\n *\n * Detaching by hand repeats three things at the release site — the type, the\n * handler reference and the capture flag — and any one of them drifting leaves\n * a listener alive on an element the controller no longer drives. Aborting the\n * signal a registration was created with releases it whatever it was made of,\n * so the release site names nothing.\n *\n * One set per lifetime, held as a field and never rebuilt. {@link\n * ListenerSet.dispose} is the only thing that closes a generation, and it opens\n * the next one in the same step, so the lifecycle hooks can call `add` and\n * `dispose` in any order any number of times, and no `add` ever meets an\n * already aborted signal — a DOM that registers a listener on such a signal\n * would keep it forever. Rebuilding the set instead would leak:\n * `addEventListener` matches an existing registration on target, type, callback\n * and capture alone, so re-adding the same handler while the first registration\n * is live is discarded, and that live registration keeps the signal it was\n * attached with — a set built by a second `connect()` can never release what it\n * appears to own.\n *\n * Scope is the registration only. Timers, observers, leases and the order they\n * are unwound in stay with the controller, so `dispose()` belongs exactly where\n * the `removeEventListener` block stood. A receiver that changes at runtime (a\n * swapped target) is rebound by calling `dispose()` and then `add()` again from\n * the rebind, not by a second set.\n *\n * The set must own every registration of a tuple it holds: a listener the same\n * target already carries for the same type, callback and capture flag keeps the\n * right to remove it, and this set's `add` for that tuple is discarded. A\n * subscription shared between instances behind a participant count, or one that\n * lives for less than the connection, keeps its own pair of calls.\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 #listeners = new ListenerSet();\n *\n * connect(): void {\n *   this.#listeners.add(this.element, \"submit\", this.#onNativeSubmit, { capture: true });\n *   this.#listeners.add(this.element, \"turbo:submit-start\", this.#onSubmitStart);\n *   this.#listeners.add(this.element, \"turbo:submit-end\", this.#onSubmitEnd);\n * }\n *\n * disconnect(): void {\n *   this.#listeners.dispose();\n * }\n * ```\n */\nexport class ListenerSet {\n  /** The generation every `add` joins until the next `dispose()`. */\n  #abort = new AbortController();\n\n  /**\n   * Attaches `handler` to the open generation, exactly as the caller spelled it.\n   *\n   * The set supplies the signal, so `options` carries everything else the DOM\n   * accepts — `capture` included, which has to match at release time and no\n   * longer has a second place to drift from.\n   */\n  add(\n    target: EventTarget,\n    type: string,\n    handler: EventListener,\n    options?: Omit<AddEventListenerOptions, \"signal\">,\n  ): void {\n    target.addEventListener(type, handler, { ...options, signal: this.#abort.signal });\n  }\n\n  /**\n   * Releases every listener of the open generation, synchronously, and opens the\n   * next one. Idempotent, and safe before anything has been added.\n   */\n  dispose(): void {\n    this.#abort.abort();\n    this.#abort = new AbortController();\n  }\n}\n","/** Normalized scroll position and maximum distance on one logical axis. */\nexport interface LogicalScrollMetrics {\n  position: number;\n  max: number;\n}\n\n/**\n * Whether horizontal scrolling on `element` follows right-to-left inline flow.\n *\n * Resolved from the **computed** `direction`, so the authoring contract is the\n * usual `dir=\"rtl\"` (or a stylesheet) on the element or any ancestor.\n *\n * Scope: horizontal writing modes. A vertical writing mode (`writing-mode:\n * vertical-rl`) also inverts the horizontal axis, which this check does not\n * model — vertical writing modes are out of scope for the scroll utilities\n * (their consumers describe axes as horizontal/vertical, not inline/block).\n */\nexport function isRtl(element: Element): boolean {\n  return window.getComputedStyle(element).direction === \"rtl\";\n}\n\n/**\n * Returns scroll distance from the logical start edge.\n *\n * CSSOM View exposes standards-mode RTL horizontal offsets as `0` at the inline\n * start (right) and increasingly negative values toward the inline end (left).\n * The normalized position is always clamped to `[0, max]`, which also absorbs\n * Safari's elastic overscroll values.\n */\nexport function logicalScrollMetrics(\n  element: HTMLElement,\n  horizontal: boolean,\n): LogicalScrollMetrics {\n  const max = Math.max(\n    0,\n    horizontal\n      ? element.scrollWidth - element.clientWidth\n      : element.scrollHeight - element.clientHeight,\n  );\n  const raw = horizontal ? element.scrollLeft : element.scrollTop;\n  const position = horizontal && isRtl(element) ? -raw : raw;\n  return { position: Math.min(max, Math.max(0, position)), max };\n}\n\n/**\n * Converts a logical start/end delta to the physical value accepted by\n * `Element.scrollBy`.\n */\nexport function physicalScrollDelta(\n  element: HTMLElement,\n  horizontal: boolean,\n  logicalDelta: number,\n): number {\n  return horizontal && isRtl(element) ? -logicalDelta : logicalDelta;\n}\n","/**\n * Shared `prefers-reduced-motion` lookup for the motion-aware controllers.\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 { BlurDeferral } from \"../utils/blur_deferral\";\nimport { FrameCoalescer } from \"../utils/frame_coalescer\";\nimport { LayoutObserver } from \"../utils/layout_observer\";\nimport { ListenerSet } from \"../utils/listener_set\";\nimport { logicalScrollMetrics, physicalScrollDelta } from \"../utils/logical_scroll\";\nimport { prefersReducedMotion } from \"../utils/reduced_motion\";\n\nconst DIRECTION_PARAM = \"direction-param\";\n\n/**\n * Headless **Overflow Indicator**: detects whether a scroll container can still\n * scroll toward its start and/or end and publishes it as `data-overflow-start` /\n * `data-overflow-end`. No APG widget — a state-detection utility. Consumers draw\n * edge shadows or arrows in CSS to signal \"more content this way\".\n *\n * Markup contract (identifier: `stimeo--overflow-indicator`):\n *   <div data-controller=\"stimeo--overflow-indicator\"\n *        data-stimeo--overflow-indicator-orientation-value=\"horizontal\">\n *     <button type=\"button\" aria-label=\"Prev\"\n *             data-stimeo--overflow-indicator-direction-param=\"start\"\n *             data-action=\"click->stimeo--overflow-indicator#scrollByPage\">‹</button>\n *     <div data-stimeo--overflow-indicator-target=\"viewport\"\n *          tabindex=\"0\" role=\"region\" aria-label=\"Products\"\n *          style=\"overflow-x: auto;\"><!-- items --></div>\n *     <button type=\"button\" aria-label=\"Next\"\n *             data-stimeo--overflow-indicator-direction-param=\"end\"\n *             data-action=\"click->stimeo--overflow-indicator#scrollByPage\">›</button>\n *   </div>\n *\n * The viewport's scroll position and size are watched by the controller itself:\n * a passive `scroll` listener on the viewport, coalesced to one measurement per\n * animation frame, plus `LayoutObserver` for viewport/content resize, a\n * {@link MutationObserver}, and descendant load events. Nothing about the\n * measurement is the consumer's to wire. Optional page buttons scroll one logical\n * viewport page at a time (including RTL) and have their disabled state synced to\n * the matching direction's remaining room.\n *\n * `change` dispatches `{ start: boolean, end: boolean }`.\n *\n * @remarks\n * Behavior only — shadows, arrows, and gradients are the consumer's CSS;\n * `data-overflow-*` carry no ARIA semantics. All observers/listeners are released\n * on `disconnect()` (Turbo navigation included). `scrollByPage` scrolls smoothly\n * by default and forces an instant jump under `prefers-reduced-motion`, regardless\n * of the consumer's CSS `scroll-behavior`.\n */\nexport class OverflowIndicatorController extends Controller<HTMLElement> {\n  /** The direction param above, in the namespace this controller is registered under. */\n  get #directionParam(): string {\n    return `data-${this.identifier}-${DIRECTION_PARAM}`;\n  }\n\n  /** Selects every button carrying that param. */\n  get #directionButtonSelector(): string {\n    return `[${this.#directionParam}]`;\n  }\n\n  static override targets = [\"viewport\"];\n  static override values = {\n    orientation: { type: String, default: \"horizontal\" },\n    threshold: { type: Number, default: 1 },\n  };\n  static actions = [\"scrollByPage\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly viewportTarget: HTMLElement;\n  declare readonly hasViewportTarget: boolean;\n\n  declare orientationValue: string;\n  declare thresholdValue: number;\n\n  readonly #layout = new LayoutObserver(() => {\n    if (this.#connected) this.#refresh();\n  });\n  /** Folds a burst of scrolls into one measurement per frame. */\n  readonly #frames = new FrameCoalescer();\n  /** Holds the viewport's scroll listener for exactly as long as that viewport. */\n  readonly #viewportListeners = new ListenerSet();\n  readonly #onScroll = (): void => this.#frames.schedule(() => this.#refresh());\n  #connected = false;\n  #observedViewport: HTMLElement | null = null;\n  readonly #observedContent = new Set<Element>();\n  #mutationObserver: MutationObserver | null = null;\n  /**\n   * Boundary buttons whose native `disabled` is held back while they hold focus.\n   *\n   * Completing the deferral is what actually disables the button, so the release\n   * callback — unlike {@link #cancelPendingButtonDisable} — applies it.\n   */\n  readonly #pendingButtonDisables = new BlurDeferral<HTMLButtonElement>((button) => {\n    this.#restorePendingMarkers(button);\n    // If the author disabled it while focus was pending, do not claim ownership.\n    if (!button.disabled) this.#disableButton(button);\n  });\n  /** Last reported room, so `change` fires only on transitions. */\n  #state: { start: boolean; end: boolean } | null = null;\n\n  override connect(): void {\n    this.#connected = true;\n    this.#syncViewport();\n  }\n\n  override disconnect(): void {\n    this.#connected = false;\n    this.#stopObservingViewport();\n    this.#layout.disconnect();\n    this.#clearPendingButtonDisables();\n    this.#state = null;\n  }\n\n  viewportTargetConnected(): void {\n    this.#syncViewport();\n  }\n\n  viewportTargetDisconnected(viewport: HTMLElement): void {\n    if (this.#observedViewport === viewport) this.#stopObservingViewport();\n    this.#syncViewport();\n  }\n\n  orientationValueChanged(): void {\n    if (this.#connected) this.#refresh();\n  }\n\n  thresholdValueChanged(): void {\n    if (this.#connected) this.#refresh();\n  }\n\n  /**\n   * Re-measures remaining scroll room and reflects the state hooks.\n   *\n   * @stimeoRenderRoot\n   */\n  #refresh(): void {\n    if (!this.hasViewportTarget) return;\n    const vp = this.viewportTarget;\n    const horizontal = this.orientationValue !== \"vertical\";\n    const t = this.#threshold;\n    const { position: scrollPos, max: maxScroll } = logicalScrollMetrics(vp, horizontal);\n\n    const start = scrollPos > t;\n    const end = scrollPos < maxScroll - t;\n\n    vp.setAttribute(\"data-overflow-start\", start ? \"true\" : \"false\");\n    vp.setAttribute(\"data-overflow-end\", end ? \"true\" : \"false\");\n    this.#syncButtons(start, end);\n\n    if (!this.#state || this.#state.start !== start || this.#state.end !== end) {\n      this.#state = { start, end };\n      this.dispatch(\"change\", { detail: { start, end } });\n    }\n  }\n\n  /** Scrolls one viewport page toward the `direction` param (`start`/`end`). */\n  scrollByPage(event: Event): void {\n    if (!this.hasViewportTarget) return;\n    const direction = this.#directionFromEvent(event);\n    if (!direction) return;\n    if (this.#state && !this.#state[direction]) return;\n\n    const vp = this.viewportTarget;\n    const horizontal = this.orientationValue !== \"vertical\";\n    const page = horizontal ? vp.clientWidth : vp.clientHeight;\n    const logicalDelta = direction === \"start\" ? -page : page;\n    const delta = physicalScrollDelta(vp, horizontal, logicalDelta);\n    const behavior: ScrollBehavior = prefersReducedMotion() ? \"instant\" : \"smooth\";\n\n    if (horizontal) {\n      vp.scrollBy({ left: delta, behavior });\n    } else {\n      vp.scrollBy({ top: delta, behavior });\n    }\n  }\n\n  /** Mirrors remaining room onto any direction buttons by toggling `disabled`. */\n  #syncButtons(start: boolean, end: boolean): void {\n    for (const button of this.#pendingButtonDisables.elements) {\n      if (\n        !button.isConnected ||\n        button.closest(`[data-controller~='${this.identifier}']`) !== this.element\n      ) {\n        this.#cancelPendingButtonDisable(button);\n      }\n    }\n    const buttons = this.element.querySelectorAll<HTMLButtonElement>(this.#directionButtonSelector);\n    for (const button of buttons) {\n      if (button.closest(`[data-controller~='${this.identifier}']`) !== this.element) {\n        continue;\n      }\n      const direction = button.getAttribute(this.#directionParam);\n      if (direction === \"start\") this.#toggleButton(button, start);\n      else if (direction === \"end\") this.#toggleButton(button, end);\n    }\n  }\n\n  /**\n   * Reflects the remaining room onto a page button's `disabled`, owning only the\n   * `disabled` it sets itself via a marker (`data-overflow-indicator-disabled`,\n   * like `number-input`/`conditional-fields`). An author-disabled button (e.g. the\n   * whole control disabled) is therefore never blindly re-enabled.\n   */\n  #toggleButton(button: HTMLButtonElement, hasRoom: boolean): void {\n    // A restored Turbo snapshot can carry pending markers from the previous visit\n    // that this instance never created; release them from the DOM record before\n    // deciding, or the displaced `aria-disabled` would never be given back.\n    if (\n      !this.#pendingButtonDisables.has(button) &&\n      button.hasAttribute(\"data-overflow-indicator-pending-disabled\")\n    ) {\n      this.#cancelPendingButtonDisable(button);\n    }\n    if (hasRoom) {\n      this.#cancelPendingButtonDisable(button);\n      if (button.hasAttribute(\"data-overflow-indicator-disabled\")) {\n        button.disabled = false;\n        button.removeAttribute(\"data-overflow-indicator-disabled\");\n      }\n      return;\n    }\n    if (button.disabled) return; // already disabled (possibly by the author) — leave it\n    if (document.activeElement === button) {\n      this.#deferButtonDisable(button);\n    } else {\n      this.#disableButton(button);\n    }\n  }\n\n  /**\n   * Keeps a boundary button focusable until native blur, exposing its temporary\n   * inoperability with `aria-disabled` and making its action a no-op meanwhile.\n   */\n  #deferButtonDisable(button: HTMLButtonElement): void {\n    if (this.#pendingButtonDisables.has(button)) return;\n    button.setAttribute(\"data-overflow-indicator-pending-disabled\", \"\");\n    // The ownership marker carries the value we displace, so the DOM alone is\n    // enough to undo it. A Turbo snapshot is cloned before `disconnect()` runs,\n    // so a restored page arrives with these markers while the new instance has\n    // no in-memory record of them — an empty marker means \"there was none\".\n    button.setAttribute(\n      \"data-overflow-indicator-aria-disabled\",\n      button.getAttribute(\"aria-disabled\") ?? \"\",\n    );\n    button.setAttribute(\"aria-disabled\", \"true\");\n    this.#pendingButtonDisables.defer(button);\n  }\n\n  #disableButton(button: HTMLButtonElement): void {\n    button.disabled = true;\n    button.setAttribute(\"data-overflow-indicator-disabled\", \"\");\n  }\n\n  /** Cancels a pending disable without applying it, restoring the displaced state. */\n  #cancelPendingButtonDisable(button: HTMLButtonElement): void {\n    this.#pendingButtonDisables.release(button);\n    this.#restorePendingMarkers(button);\n  }\n\n  /**\n   * Drops the pending marker and gives back the `aria-disabled` it displaced.\n   *\n   * Reads the displaced value from the DOM rather than memory: a Turbo snapshot is\n   * cloned before `disconnect()` runs, so a restored page can arrive with markers\n   * this instance never wrote.\n   */\n  #restorePendingMarkers(button: HTMLButtonElement): void {\n    button.removeAttribute(\"data-overflow-indicator-pending-disabled\");\n    const displaced = button.getAttribute(\"data-overflow-indicator-aria-disabled\");\n    if (displaced !== null) {\n      button.removeAttribute(\"data-overflow-indicator-aria-disabled\");\n      if (button.getAttribute(\"aria-disabled\") === \"true\") {\n        if (displaced === \"\") button.removeAttribute(\"aria-disabled\");\n        else button.setAttribute(\"aria-disabled\", displaced);\n      }\n    }\n  }\n\n  #clearPendingButtonDisables(): void {\n    for (const button of this.#pendingButtonDisables.elements) {\n      this.#cancelPendingButtonDisable(button);\n    }\n  }\n\n  /** Moves resize/mutation/load observation to the current viewport target. */\n  #syncViewport(): void {\n    if (!this.#connected) return;\n    const next = this.hasViewportTarget ? this.viewportTarget : null;\n    if (next === this.#observedViewport) return;\n    this.#stopObservingViewport();\n    if (!next) return;\n\n    this.#observedViewport = next;\n    this.#viewportListeners.add(next, \"scroll\", this.#onScroll, { passive: true });\n    this.#layout.observe(next);\n    this.#layout.observeViewport();\n    this.#layout.observeDescendantLoads(next);\n    this.#syncContentObservation();\n\n    if (typeof MutationObserver !== \"undefined\") {\n      this.#mutationObserver = new MutationObserver(() => {\n        if (!this.#connected || this.#observedViewport !== next) return;\n        this.#syncContentObservation();\n        this.#refresh();\n      });\n      this.#mutationObserver.observe(this.element, {\n        childList: true,\n        subtree: true,\n        characterData: true,\n        attributes: true,\n        attributeFilter: [\"class\", \"style\", \"hidden\"],\n      });\n    }\n    this.#state = null;\n    this.#refresh();\n  }\n\n  /** Observes direct content boxes whose resize can change the viewport's scroll extent. */\n  #syncContentObservation(): void {\n    const next = new Set<Element>(this.#observedViewport?.children ?? []);\n    for (const content of this.#observedContent) {\n      if (!next.has(content)) {\n        this.#layout.unobserve(content);\n        this.#observedContent.delete(content);\n      }\n    }\n    for (const content of next) {\n      if (!this.#observedContent.has(content)) {\n        this.#observedContent.add(content);\n        this.#layout.observe(content);\n      }\n    }\n  }\n\n  #stopObservingViewport(): void {\n    this.#frames.cancel();\n    this.#viewportListeners.dispose();\n    this.#mutationObserver?.disconnect();\n    this.#mutationObserver = null;\n    this.#layout.unobserveDescendantLoads();\n    if (this.#observedViewport) this.#layout.unobserve(this.#observedViewport);\n    for (const content of this.#observedContent) this.#layout.unobserve(content);\n    this.#observedContent.clear();\n    this.#observedViewport = null;\n    this.#layout.unobserveViewport();\n  }\n\n  get #threshold(): number {\n    const value = this.thresholdValue;\n    return Number.isFinite(value) ? Math.max(0, value) : 1;\n  }\n\n  #directionFromEvent(event: Event): \"start\" | \"end\" | null {\n    const params = (event as Event & { params?: { direction?: unknown } }).params;\n    const direction = params?.direction;\n    return direction === \"start\" || direction === \"end\" ? direction : null;\n  }\n}\n"]}

package/dist/controllers/overflow_menu_controller.d.ts

@@ -20,7 +20,7 @@ import { Controller } from '@hotwired/stimulus';
  *       <div role="menu" aria-labelledby="more-trigger"
  *            data-stimeo--menu-target="menu" hidden></div>
  *     </div>
- *   </div>
+ *   </nav>
  *
  * This controller does not own the root's role. It ships none: a navigation bar is
  * a named `<nav>` whose items stay in the normal Tab order. A consumer may add
@@ -40,6 +40,18 @@ import { Controller } from '@hotwired/stimulus';
  * element, so a control that only becomes a menu item at runtime is operable the
  * moment it lands.
  *
+ * A bare More trigger — no text, no element child, no `aria-label` or
+ * `aria-labelledby` — gets `moreLabel` as its text on every pass, before the pass
+ * measures it, marked with `data-<identifier>-owns-label` whose value is that
+ * label. The trigger stays this controller's only while it holds that label and
+ * nothing else — the text still matches the marker, and it has no element child,
+ * `aria-label` or `aria-labelledby` — and only then does a `moreLabel` swapped at
+ * runtime rewrite it, or an empty one hand it back bare. Any other trigger content
+ * is the author's and is never written: a trigger the consumer has rewritten, or
+ * added an element child or a name to, is neither rewritten nor emptied, and its
+ * marker stays where it is. Once it holds the label alone again, it is this
+ * controller's again.
+ *
  * On connect (and every debounced resize) it measures the items against the container's
  * content width and, when they overflow, banks the lowest-priority ones into the More
  * menu — giving each `role="menuitem"` / `tabindex="-1"` and the menu's `item` target so
@@ -48,7 +60,7 @@ import { Controller } from '@hotwired/stimulus';
  * `data-overflowing` / `data-overflow-count`, and a `change` event fires on connect and
  * on every later transition.
  *
- * `change` dispatches `{ visible, hidden }`.
+ * `change` dispatches `{ overflowCount, total }`.
  *
  * @remarks
  * **Measuring.** The container's width must not be derived from its content (give the bar
@@ -89,10 +101,12 @@ import { Controller } from '@hotwired/stimulus';
  * a morph, a clone, server-rendered overflow) re-adopts them instead of orphaning them
  * inside a wrapper it would then hide. Symmetrically, `disconnect()` and
  * `turbo:before-cache` return every item to the bar, collapse the composed menu (so it
- * releases its dismissal-stack membership rather than being snapshotted mid-gesture), and
- * strip this controller's bookkeeping attributes, so a cached snapshot is always the
- * pristine authored DOM. The `ResizeObserver` and debounce timer are released on
- * `disconnect()` too.
+ * releases its dismissal-stack membership rather than being snapshotted mid-gesture),
+ * take back the More label the trigger still holds alone, and strip the items'
+ * bookkeeping attributes, so a cached snapshot is the authored DOM. A trigger the
+ * consumer added to after the label was written keeps the label and its marker:
+ * taking either off would write to content that belongs to the consumer. The
+ * `ResizeObserver` and debounce timer are released on `disconnect()` too.
  *
  * Behavior only — no styling.
  */
@@ -119,6 +133,12 @@ declare class OverflowMenuController extends Controller<HTMLElement> {
     debounceValue: number;
     connect(): void;
     disconnect(): void;
+    /**
+     * Follows a More label swapped in place by a morph, on a trigger that still holds
+     * the label this controller wrote and nothing else. Render only: nothing is
+     * measured and `change` is not dispatched here; the next pass measures the bar.
+     */
+    moreLabelValueChanged(): void;
     /** Re-measures and rebalances items between the bar and the More menu. */
     update(): void;
 }