stimeo-ui 0.16.0 → 0.17.0

data/dist/controllers/scroll_restore_controller.js

@@ -1,15 +1,7 @@
 import { Controller } from '@hotwired/stimulus';
 
-// src/controllers/scroll_restore_controller.ts
-
-// 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(() => {
@@ -17,14 +9,6 @@ var FrameCoalescer = class {
       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);
@@ -32,7 +16,6 @@ var FrameCoalescer = class {
   }
 };
 
-// src/controllers/scroll_restore_controller.ts
 function parseStored(raw) {
   if (raw === null) return null;
   try {
@@ -49,32 +32,15 @@ var ScrollRestoreController = class extends Controller {
     key: { type: String, default: "" },
     axis: { type: String, default: "vertical" }
   };
-  /** Coalesces scroll bursts into one save per frame. */
   #frames = new FrameCoalescer();
-  /** Resolved storage key; empty disables persistence (no key and no id). */
   #storageKey = "";
-  /** Last offset captured while the element was live; persisted as-is on teardown. */
   #lastTop = 0;
   #lastLeft = 0;
-  /**
-   * The offsets this controller's own restore produced, awaiting the `scroll`
-   * the engine fires for them. A restore the layout cannot reach yet lands short,
-   * so treating that echo as the reader's position would cut the saved offset
-   * down to whatever the unfinished layout allowed.
-   */
   #echoTop = null;
   #echoLeft = null;
-  /** Offsets stored for an axis that is not tracked, carried through saves. */
   #carried = {};
-  /**
-   * Whether each axis holds an offset worth saving — one this namespace restored
-   * or the reader moved. A save writes only the axes that are marked, so an
-   * offset taken under a different key or axis is never re-published as if the
-   * reader had left it there.
-   */
   #capturedTop = false;
   #capturedLeft = false;
-  /** Whether the controller is connected; Value callbacks outside that window do not resync. */
   #connected = false;
   #onScroll = () => {
     this.#capture();
@@ -92,15 +58,12 @@ var ScrollRestoreController = class extends Controller {
     this.#frames.cancel();
     this.#persist();
   }
-  /** Re-derives the namespace when application code or a Turbo morph moves `key`. */
   keyValueChanged() {
     this.#resync();
   }
-  /** Re-derives the tracked axes when application code or a Turbo morph moves `axis`. */
   axisValueChanged() {
     this.#resync();
   }
-  /** Rebuilds the persistence state around the Values as they now read. */
   #resync() {
     if (!this.#connected) return;
     this.#frames.cancel();
@@ -112,15 +75,6 @@ var ScrollRestoreController = class extends Controller {
     this.#capturedLeft = false;
     if (this.#storageKey) this.#restore();
   }
-  /**
-   * Records the live scroll offset for the configured axis.
-   *
-   * An axis holds its echo until that axis actually moves. A scroll event names
-   * no axis, so consuming both on the first one to arrive would leave the other
-   * unguarded: on `both`, moving one axis would take the clamped reading of the
-   * untouched axis as the reader's own position and save it, cutting the stored
-   * offset down to whatever the layout could reach at restore time.
-   */
   #capture() {
     if (this.#tracksVertical) {
       const top = this.element.scrollTop;
@@ -139,10 +93,6 @@ var ScrollRestoreController = class extends Controller {
       }
     }
   }
-  /**
-   * Writes the marked axes, carrying through any offset held for an untracked one.
-   * Without a key, or with neither axis marked, it writes nothing.
-   */
   #persist() {
     if (!this.#storageKey || !(this.#capturedTop || this.#capturedLeft)) return;
     const data = { ...this.#carried };
@@ -153,7 +103,6 @@ var ScrollRestoreController = class extends Controller {
     } catch {
     }
   }
-  /** Applies the persisted scroll offset, if any, without moving focus. */
   #restore() {
     let raw;
     try {
@@ -196,7 +145,6 @@ var ScrollRestoreController = class extends Controller {
     if (this.element.scrollTop !== beforeTop) this.#echoTop = this.element.scrollTop;
     if (this.element.scrollLeft !== beforeLeft) this.#echoLeft = this.element.scrollLeft;
   }
-  /** The `sessionStorage` key: explicit `key`, else the element `id`, else none. */
   #resolveKey() {
     const base = this.keyValue || this.element.id;
     return base ? `stimeo--scroll-restore:${base}` : "";
@@ -210,5 +158,4 @@ var ScrollRestoreController = class extends Controller {
 };
 
 export { ScrollRestoreController };
-//# sourceMappingURL=scroll_restore_controller.js.map
 //# sourceMappingURL=scroll_restore_controller.js.map