@hotwired/turbo 8.0.19 → 8.0.21

package/dist/turbo.es2017-esm.js

@@ -1,104 +1,7 @@
 /*!
-Turbo 8.0.18
-Copyright © 2025 37signals LLC
+Turbo 8.0.21
+Copyright © 2026 37signals LLC
  */
-/**
- * The MIT License (MIT)
- *
- * Copyright (c) 2019 Javan Makhmali
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-(function (prototype) {
-  if (typeof prototype.requestSubmit == "function") return
-
-  prototype.requestSubmit = function (submitter) {
-    if (submitter) {
-      validateSubmitter(submitter, this);
-      submitter.click();
-    } else {
-      submitter = document.createElement("input");
-      submitter.type = "submit";
-      submitter.hidden = true;
-      this.appendChild(submitter);
-      submitter.click();
-      this.removeChild(submitter);
-    }
-  };
-
-  function validateSubmitter(submitter, form) {
-    submitter instanceof HTMLElement || raise(TypeError, "parameter 1 is not of type 'HTMLElement'");
-    submitter.type == "submit" || raise(TypeError, "The specified element is not a submit button");
-    submitter.form == form ||
-      raise(DOMException, "The specified element is not owned by this form element", "NotFoundError");
-  }
-
-  function raise(errorConstructor, message, name) {
-    throw new errorConstructor("Failed to execute 'requestSubmit' on 'HTMLFormElement': " + message + ".", name)
-  }
-})(HTMLFormElement.prototype);
-
-const submittersByForm = new WeakMap();
-
-function findSubmitterFromClickTarget(target) {
-  const element = target instanceof Element ? target : target instanceof Node ? target.parentElement : null;
-  const candidate = element ? element.closest("input, button") : null;
-  return candidate?.type == "submit" ? candidate : null
-}
-
-function clickCaptured(event) {
-  const submitter = findSubmitterFromClickTarget(event.target);
-
-  if (submitter && submitter.form) {
-    submittersByForm.set(submitter.form, submitter);
-  }
-}
-
-(function () {
-  if ("submitter" in Event.prototype) return
-
-  let prototype = window.Event.prototype;
-  // Certain versions of Safari 15 have a bug where they won't
-  // populate the submitter. This hurts TurboDrive's enable/disable detection.
-  // See https://bugs.webkit.org/show_bug.cgi?id=229660
-  if ("SubmitEvent" in window) {
-    const prototypeOfSubmitEvent = window.SubmitEvent.prototype;
-
-    if (/Apple Computer/.test(navigator.vendor) && !("submitter" in prototypeOfSubmitEvent)) {
-      prototype = prototypeOfSubmitEvent;
-    } else {
-      return // polyfill not needed
-    }
-  }
-
-  addEventListener("click", clickCaptured, true);
-
-  Object.defineProperty(prototype, "submitter", {
-    get() {
-      if (this.type == "submit" && this.target instanceof HTMLFormElement) {
-        return submittersByForm.get(this.target)
-      }
-    }
-  });
-})();
-
 const FrameLoadingStyle = {
   eager: "eager",
   lazy: "lazy"
@@ -374,10 +277,6 @@ function nextEventLoopTick() {
   return new Promise((resolve) => setTimeout(() => resolve(), 0))
 }
 
-function nextMicrotask() {
-  return Promise.resolve()
-}
-
 function parseHTMLDocument(html = "") {
   return new DOMParser().parseFromString(html, "text/html")
 }
@@ -406,7 +305,7 @@ function uuid() {
       } else if (i == 19) {
         return (Math.floor(Math.random() * 4) + 8).toString(16)
       } else {
-        return Math.floor(Math.random() * 15).toString(16)
+        return Math.floor(Math.random() * 16).toString(16)
       }
     })
     .join("")
@@ -558,14 +457,13 @@ function findLinkFromClickTarget(target) {
   const link = findClosestRecursively(target, "a[href], a[xlink\\:href]");
 
   if (!link) return null
+  if (link.href.startsWith("#")) return null
   if (link.hasAttribute("download")) return null
-  if (link.hasAttribute("target") && link.target !== "_self") return null
 
-  return link
-}
+  const linkTarget = link.getAttribute("target");
+  if (linkTarget && linkTarget !== "_self") return null
 
-function getLocationForLink(link) {
-  return expandURL(link.getAttribute("href") || "")
+  return link
 }
 
 function debounce(fn, delay) {
@@ -656,6 +554,10 @@ function locationIsVisitable(location, rootLocation) {
   return isPrefixedBy(location, rootLocation) && !config.drive.unvisitableExtensions.has(getExtension(location))
 }
 
+function getLocationForLink(link) {
+  return expandURL(link.getAttribute("href") || "")
+}
+
 function getRequestURL(url) {
   const anchor = getAnchor(url);
   return anchor != null ? url.href.slice(0, -(anchor.length + 1)) : url.href
@@ -1071,35 +973,113 @@ function importStreamElements(fragment) {
   return fragment
 }
 
-const PREFETCH_DELAY = 100;
+const identity = key => key;
 
-class PrefetchCache {
-  #prefetchTimeout = null
-  #prefetched = null
+class LRUCache {
+  keys = []
+  entries = {}
+  #toCacheKey
+
+  constructor(size, toCacheKey = identity) {
+    this.size = size;
+    this.#toCacheKey = toCacheKey;
+  }
+
+  has(key) {
+    return this.#toCacheKey(key) in this.entries
+  }
+
+  get(key) {
+    if (this.has(key)) {
+      const entry = this.read(key);
+      this.touch(key);
+      return entry
+    }
+  }
+
+  put(key, entry) {
+    this.write(key, entry);
+    this.touch(key);
+    return entry
+  }
+
+  clear() {
+    for (const key of Object.keys(this.entries)) {
+      this.evict(key);
+    }
+  }
+
+  // Private
+
+  read(key) {
+    return this.entries[this.#toCacheKey(key)]
+  }
+
+  write(key, entry) {
+    this.entries[this.#toCacheKey(key)] = entry;
+  }
 
-  get(url) {
-    if (this.#prefetched && this.#prefetched.url === url && this.#prefetched.expire > Date.now()) {
-      return this.#prefetched.request
+  touch(key) {
+    key = this.#toCacheKey(key);
+    const index = this.keys.indexOf(key);
+    if (index > -1) this.keys.splice(index, 1);
+    this.keys.unshift(key);
+    this.trim();
+  }
+
+  trim() {
+    for (const key of this.keys.splice(this.size)) {
+      this.evict(key);
     }
   }
 
-  setLater(url, request, ttl) {
-    this.clear();
+  evict(key) {
+    delete this.entries[key];
+  }
+}
+
+const PREFETCH_DELAY = 100;
 
+class PrefetchCache extends LRUCache {
+  #prefetchTimeout = null
+  #maxAges = {}
+
+  constructor(size = 1, prefetchDelay = PREFETCH_DELAY) {
+    super(size, toCacheKey);
+    this.prefetchDelay = prefetchDelay;
+  }
+
+  putLater(url, request, ttl) {
     this.#prefetchTimeout = setTimeout(() => {
       request.perform();
-      this.set(url, request, ttl);
+      this.put(url, request, ttl);
       this.#prefetchTimeout = null;
-    }, PREFETCH_DELAY);
+    }, this.prefetchDelay);
   }
 
-  set(url, request, ttl) {
-    this.#prefetched = { url, request, expire: new Date(new Date().getTime() + ttl) };
+  put(url, request, ttl = cacheTtl) {
+    super.put(url, request);
+    this.#maxAges[toCacheKey(url)] = new Date(new Date().getTime() + ttl);
   }
 
   clear() {
+    super.clear();
     if (this.#prefetchTimeout) clearTimeout(this.#prefetchTimeout);
-    this.#prefetched = null;
+  }
+
+  evict(key) {
+    super.evict(key);
+    delete this.#maxAges[key];
+  }
+
+  has(key) {
+    if (super.has(key)) {
+      const maxAge = this.#maxAges[toCacheKey(key)];
+
+      return maxAge && maxAge > Date.now()
+    } else {
+      return false
+    }
   }
 }
 
@@ -2139,6 +2119,7 @@ var Idiomorph = (function () {
    * @property {ConfigInternal['callbacks']} callbacks
    * @property {ConfigInternal['head']} head
    * @property {HTMLDivElement} pantry
+   * @property {Element[]} activeElementAndParents
    */
 
   //=============================================================================
@@ -2214,14 +2195,6 @@ var Idiomorph = (function () {
    */
   function morphOuterHTML(ctx, oldNode, newNode) {
     const oldParent = normalizeParent(oldNode);
-
-    // basis for calulating which nodes were morphed
-    // since there may be unmorphed sibling nodes
-    let childNodes = Array.from(oldParent.childNodes);
-    const index = childNodes.indexOf(oldNode);
-    // how many elements are to the right of the oldNode
-    const rightMargin = childNodes.length - (index + 1);
-
     morphChildren(
       ctx,
       oldParent,
@@ -2230,10 +2203,8 @@ var Idiomorph = (function () {
       oldNode, // start point for iteration
       oldNode.nextSibling, // end point for iteration
     );
-
-    // return just the morphed nodes
-    childNodes = Array.from(oldParent.childNodes);
-    return childNodes.slice(index, childNodes.length - rightMargin);
+    // this is safe even with siblings, because normalizeParent returns a SlicedParentNode if needed.
+    return Array.from(oldParent.childNodes);
   }
 
   /**
@@ -2262,8 +2233,11 @@ var Idiomorph = (function () {
 
     const results = fn();
 
-    if (activeElementId && activeElementId !== document.activeElement?.id) {
-      activeElement = ctx.target.querySelector(`#${activeElementId}`);
+    if (
+      activeElementId &&
+      activeElementId !== document.activeElement?.getAttribute("id")
+    ) {
+      activeElement = ctx.target.querySelector(`[id="${activeElementId}"]`);
       activeElement?.focus();
     }
     if (activeElement && !activeElement.selectionEnd && selectionEnd) {
@@ -2341,17 +2315,23 @@ var Idiomorph = (function () {
         }
 
         // if the matching node is elsewhere in the original content
-        if (newChild instanceof Element && ctx.persistentIds.has(newChild.id)) {
-          // move it and all its children here and morph
-          const movedChild = moveBeforeById(
-            oldParent,
-            newChild.id,
-            insertionPoint,
-            ctx,
+        if (newChild instanceof Element) {
+          // we can pretend the id is non-null because the next `.has` line will reject it if not
+          const newChildId = /** @type {String} */ (
+            newChild.getAttribute("id")
           );
-          morphNode(movedChild, newChild, ctx);
-          insertionPoint = movedChild.nextSibling;
-          continue;
+          if (ctx.persistentIds.has(newChildId)) {
+            // move it and all its children here and morph
+            const movedChild = moveBeforeById(
+              oldParent,
+              newChildId,
+              insertionPoint,
+              ctx,
+            );
+            morphNode(movedChild, newChild, ctx);
+            insertionPoint = movedChild.nextSibling;
+            continue;
+          }
         }
 
         // last resort: insert the new node from scratch
@@ -2461,7 +2441,8 @@ var Idiomorph = (function () {
 
           // if the current node contains active element, stop looking for better future matches,
           // because if one is found, this node will be moved to the pantry, reparenting it and thus losing focus
-          if (cursor.contains(document.activeElement)) break;
+          // @ts-ignore pretend cursor is Element rather than Node, we're just testing for array inclusion
+          if (ctx.activeElementAndParents.includes(cursor)) break;
 
           cursor = cursor.nextSibling;
         }
@@ -2511,7 +2492,9 @@ var Idiomorph = (function () {
           // If oldElt has an `id` with possible state and it doesn't match newElt.id then avoid morphing.
           // We'll still match an anonymous node with an IDed newElt, though, because if it got this far,
           // its not persistent, and new nodes can't have any hidden state.
-          (!oldElt.id || oldElt.id === newElt.id)
+          // We can't use .id because of form input shadowing, and we can't count on .getAttribute's presence because it could be a document-fragment
+          (!oldElt.getAttribute?.("id") ||
+            oldElt.getAttribute?.("id") === newElt.getAttribute?.("id"))
         );
       }
 
@@ -2575,8 +2558,11 @@ var Idiomorph = (function () {
       const target =
         /** @type {Element} - will always be found */
         (
-          ctx.target.querySelector(`#${id}`) ||
-            ctx.pantry.querySelector(`#${id}`)
+          // ctx.target.id unsafe because of form input shadowing
+          // ctx.target could be a document fragment which doesn't have `getAttribute`
+          (ctx.target.getAttribute?.("id") === id && ctx.target) ||
+            ctx.target.querySelector(`[id="${id}"]`) ||
+            ctx.pantry.querySelector(`[id="${id}"]`)
         );
       removeElementFromAncestorsIdMaps(target, ctx);
       moveBefore(parentNode, target, after);
@@ -2592,7 +2578,8 @@ var Idiomorph = (function () {
      * @param {MorphContext} ctx
      */
     function removeElementFromAncestorsIdMaps(element, ctx) {
-      const id = element.id;
+      // we know id is non-null String, because this function is only called on elements with ids
+      const id = /** @type {String} */ (element.getAttribute("id"));
       /** @ts-ignore - safe to loop in this way **/
       while ((element = element.parentNode)) {
         let idSet = ctx.idMap.get(element);
@@ -3030,6 +3017,7 @@ var Idiomorph = (function () {
         idMap: idMap,
         persistentIds: persistentIds,
         pantry: createPantry(),
+        activeElementAndParents: createActiveElementAndParents(oldNode),
         callbacks: mergedConfig.callbacks,
         head: mergedConfig.head,
       };
@@ -3070,6 +3058,24 @@ var Idiomorph = (function () {
       return pantry;
     }
 
+    /**
+     * @param {Element} oldNode
+     * @returns {Element[]}
+     */
+    function createActiveElementAndParents(oldNode) {
+      /** @type {Element[]} */
+      let activeElementAndParents = [];
+      let elt = document.activeElement;
+      if (elt?.tagName !== "BODY" && oldNode.contains(elt)) {
+        while (elt) {
+          activeElementAndParents.push(elt);
+          if (elt === oldNode) break;
+          elt = elt.parentElement;
+        }
+      }
+      return activeElementAndParents;
+    }
+
     /**
      * Returns all elements with an ID contained within the root element and its descendants
      *
@@ -3078,7 +3084,8 @@ var Idiomorph = (function () {
      */
     function findIdElements(root) {
       let elements = Array.from(root.querySelectorAll("[id]"));
-      if (root.id) {
+      // root could be a document fragment which doesn't have `getAttribute`
+      if (root.getAttribute?.("id")) {
         elements.push(root);
       }
       return elements;
@@ -3097,7 +3104,9 @@ var Idiomorph = (function () {
      */
     function populateIdMapWithTree(idMap, persistentIds, root, elements) {
       for (const elt of elements) {
-        if (persistentIds.has(elt.id)) {
+        // we can pretend id is non-null String, because the .has line will reject it immediately if not
+        const id = /** @type {String} */ (elt.getAttribute("id"));
+        if (persistentIds.has(id)) {
           /** @type {Element|null} */
           let current = elt;
           // walk up the parent hierarchy of that element, adding the id
@@ -3109,7 +3118,7 @@ var Idiomorph = (function () {
               idSet = new Set();
               idMap.set(current, idSet);
             }
-            idSet.add(elt.id);
+            idSet.add(id);
 
             if (current === root) break;
             current = current.parentElement;
@@ -3223,8 +3232,9 @@ var Idiomorph = (function () {
         if (newContent.parentNode) {
           // we can't use the parent directly because newContent may have siblings
           // that we don't want in the morph, and reparenting might be expensive (TODO is it?),
-          // so we create a duck-typed parent node instead.
-          return createDuckTypedParent(newContent);
+          // so instead we create a fake parent node that only sees a slice of its children.
+          /** @type {Element} */
+          return /** @type {any} */ (new SlicedParentNode(newContent));
         } else {
           // a single node is added as a child to a dummy parent
           const dummyParent = document.createElement("div");
@@ -3243,33 +3253,78 @@ var Idiomorph = (function () {
     }
 
     /**
-     * Creates a fake duck-typed parent element to wrap a single node, without actually reparenting it.
+     * A fake duck-typed parent element to wrap a single node, without actually reparenting it.
+     * This is useful because the node may have siblings that we don't want in the morph, and it may also be moved
+     * or replaced with one or more elements during the morph. This class effectively allows us a window into
+     * a slice of a node's children.
      * "If it walks like a duck, and quacks like a duck, then it must be a duck!" -- James Whitcomb Riley (1849–1916)
-     *
-     * @param {Node} newContent
-     * @returns {Element}
      */
-    function createDuckTypedParent(newContent) {
-      return /** @type {Element} */ (
-        /** @type {unknown} */ ({
-          childNodes: [newContent],
-          /** @ts-ignore - cover your eyes for a minute, tsc */
-          querySelectorAll: (s) => {
-            /** @ts-ignore */
-            const elements = newContent.querySelectorAll(s);
-            /** @ts-ignore */
-            return newContent.matches(s) ? [newContent, ...elements] : elements;
-          },
-          /** @ts-ignore */
-          insertBefore: (n, r) => newContent.parentNode.insertBefore(n, r),
-          /** @ts-ignore */
-          moveBefore: (n, r) => newContent.parentNode.moveBefore(n, r),
-          // for later use with populateIdMapWithTree to halt upwards iteration
-          get __idiomorphRoot() {
-            return newContent;
-          },
-        })
-      );
+    class SlicedParentNode {
+      /** @param {Node} node */
+      constructor(node) {
+        this.originalNode = node;
+        this.realParentNode = /** @type {Element} */ (node.parentNode);
+        this.previousSibling = node.previousSibling;
+        this.nextSibling = node.nextSibling;
+      }
+
+      /** @returns {Node[]} */
+      get childNodes() {
+        // return slice of realParent's current childNodes, based on previousSibling and nextSibling
+        const nodes = [];
+        let cursor = this.previousSibling
+          ? this.previousSibling.nextSibling
+          : this.realParentNode.firstChild;
+        while (cursor && cursor != this.nextSibling) {
+          nodes.push(cursor);
+          cursor = cursor.nextSibling;
+        }
+        return nodes;
+      }
+
+      /**
+       * @param {string} selector
+       * @returns {Element[]}
+       */
+      querySelectorAll(selector) {
+        return this.childNodes.reduce((results, node) => {
+          if (node instanceof Element) {
+            if (node.matches(selector)) results.push(node);
+            const nodeList = node.querySelectorAll(selector);
+            for (let i = 0; i < nodeList.length; i++) {
+              results.push(nodeList[i]);
+            }
+          }
+          return results;
+        }, /** @type {Element[]} */ ([]));
+      }
+
+      /**
+       * @param {Node} node
+       * @param {Node} referenceNode
+       * @returns {Node}
+       */
+      insertBefore(node, referenceNode) {
+        return this.realParentNode.insertBefore(node, referenceNode);
+      }
+
+      /**
+       * @param {Node} node
+       * @param {Node} referenceNode
+       * @returns {Node}
+       */
+      moveBefore(node, referenceNode) {
+        // @ts-ignore - use new moveBefore feature
+        return this.realParentNode.moveBefore(node, referenceNode);
+      }
+
+      /**
+       * for later use with populateIdMapWithTree to halt upwards iteration
+       * @returns {Node}
+       */
+      get __idiomorphRoot() {
+        return this.originalNode;
+      }
     }
 
     /**
@@ -3364,16 +3419,18 @@ function morphChildren(currentElement, newElement, options = {}) {
 
 function shouldRefreshFrameWithMorphing(currentFrame, newFrame) {
   return currentFrame instanceof FrameElement &&
-    // newFrame cannot yet be an instance of FrameElement because custom
-    // elements don't get initialized until they're attached to the DOM, so
-    // test its Element#nodeName instead
-    newFrame instanceof Element && newFrame.nodeName === "TURBO-FRAME" &&
-    currentFrame.shouldReloadWithMorph &&
-    currentFrame.id === newFrame.id &&
-    (!newFrame.getAttribute("src") || urlsAreEqual(currentFrame.src, newFrame.getAttribute("src"))) &&
+    currentFrame.shouldReloadWithMorph && (!newFrame || areFramesCompatibleForRefreshing(currentFrame, newFrame)) &&
     !currentFrame.closest("[data-turbo-permanent]")
 }
 
+function areFramesCompatibleForRefreshing(currentFrame, newFrame) {
+  // newFrame cannot yet be an instance of FrameElement because custom
+  // elements don't get initialized until they're attached to the DOM, so
+  // test its Element#nodeName instead
+  return newFrame instanceof Element && newFrame.nodeName === "TURBO-FRAME" && currentFrame.id === newFrame.id &&
+  (!newFrame.getAttribute("src") || urlsAreEqual(currentFrame.src, newFrame.getAttribute("src")))
+}
+
 function closestFrameReloadableWithMorphing(node) {
   return node.parentElement.closest("turbo-frame[src][refresh=morph]")
 }
@@ -3725,6 +3782,10 @@ class PageSnapshot extends Snapshot {
       clonedPasswordInput.value = "";
     }
 
+    for (const clonedNoscriptElement of clonedElement.querySelectorAll("noscript")) {
+      clonedNoscriptElement.remove();
+    }
+
     return new PageSnapshot(this.documentElement, clonedElement, this.headSnapshot)
   }
 
@@ -3732,6 +3793,10 @@ class PageSnapshot extends Snapshot {
     return this.documentElement.getAttribute("lang")
   }
 
+  get dir() {
+    return this.documentElement.getAttribute("dir")
+  }
+
   get headElement() {
     return this.headSnapshot.element
   }
@@ -3762,12 +3827,12 @@ class PageSnapshot extends Snapshot {
     return viewTransitionEnabled && !window.matchMedia("(prefers-reduced-motion: reduce)").matches
   }
 
-  get shouldMorphPage() {
-    return this.getSetting("refresh-method") === "morph"
+  get refreshMethod() {
+    return this.getSetting("refresh-method")
   }
 
-  get shouldPreserveScrollPosition() {
-    return this.getSetting("refresh-scroll") === "preserve"
+  get refreshScroll() {
+    return this.getSetting("refresh-scroll")
   }
 
   // Private
@@ -3806,7 +3871,8 @@ const defaultOptions = {
   willRender: true,
   updateHistory: true,
   shouldCacheSnapshot: true,
-  acceptsStreamResponse: false
+  acceptsStreamResponse: false,
+  refresh: {}
 };
 
 const TimingMetric = {
@@ -3866,7 +3932,8 @@ class Visit {
       updateHistory,
       shouldCacheSnapshot,
       acceptsStreamResponse,
-      direction
+      direction,
+      refresh
     } = {
       ...defaultOptions,
       ...options
@@ -3877,7 +3944,6 @@ class Visit {
     this.snapshot = snapshot;
     this.snapshotHTML = snapshotHTML;
     this.response = response;
-    this.isSamePage = this.delegate.locationWithActionIsSamePage(this.location, this.action);
     this.isPageRefresh = this.view.isPageRefresh(this);
     this.visitCachedSnapshot = visitCachedSnapshot;
     this.willRender = willRender;
@@ -3886,6 +3952,7 @@ class Visit {
     this.shouldCacheSnapshot = shouldCacheSnapshot;
     this.acceptsStreamResponse = acceptsStreamResponse;
     this.direction = direction || Direction[action];
+    this.refresh = refresh;
   }
 
   get adapter() {
@@ -3904,10 +3971,6 @@ class Visit {
     return this.history.getRestorationDataForIdentifier(this.restorationIdentifier)
   }
 
-  get silent() {
-    return this.isSamePage
-  }
-
   start() {
     if (this.state == VisitState.initialized) {
       this.recordTimingMetric(TimingMetric.visitStart);
@@ -4044,7 +4107,7 @@ class Visit {
       const isPreview = this.shouldIssueRequest();
       this.render(async () => {
         this.cacheSnapshot();
-        if (this.isSamePage || this.isPageRefresh) {
+        if (this.isPageRefresh) {
           this.adapter.visitRendered(this);
         } else {
           if (this.view.renderPromise) await this.view.renderPromise;
@@ -4072,17 +4135,6 @@ class Visit {
     }
   }
 
-  goToSamePageAnchor() {
-    if (this.isSamePage) {
-      this.render(async () => {
-        this.cacheSnapshot();
-        this.performScroll();
-        this.changeHistory();
-        this.adapter.visitRendered(this);
-      });
-    }
-  }
-
   // Fetch request delegate
 
   prepareRequest(request) {
@@ -4144,9 +4196,6 @@ class Visit {
       } else {
         this.scrollToAnchor() || this.view.scrollToTop();
       }
-      if (this.isSamePage) {
-        this.delegate.visitScrolledToSamePageLocation(this.view.lastRenderedLocation, this.location);
-      }
 
       this.scrolled = true;
     }
@@ -4185,9 +4234,7 @@ class Visit {
   }
 
   shouldIssueRequest() {
-    if (this.isSamePage) {
-      return false
-    } else if (this.action == "restore") {
+    if (this.action == "restore") {
       return !this.hasCachedSnapshot()
     } else {
       return this.willRender
@@ -4251,7 +4298,6 @@ class BrowserAdapter {
 
     visit.loadCachedSnapshot();
     visit.issueRequest();
-    visit.goToSamePageAnchor();
   }
 
   visitRequestStarted(visit) {
@@ -4368,7 +4414,6 @@ class BrowserAdapter {
 
 class CacheObserver {
   selector = "[data-turbo-temporary]"
-  deprecatedSelector = "[data-turbo-cache=false]"
 
   started = false
 
@@ -4393,19 +4438,7 @@ class CacheObserver {
   }
 
   get temporaryElements() {
-    return [...document.querySelectorAll(this.selector), ...this.temporaryElementsWithDeprecation]
-  }
-
-  get temporaryElementsWithDeprecation() {
-    const elements = document.querySelectorAll(this.deprecatedSelector);
-
-    if (elements.length) {
-      console.warn(
-        `The ${this.deprecatedSelector} selector is deprecated and will be removed in a future version. Use ${this.selector} instead.`
-      );
-    }
-
-    return [...elements]
+    return [...document.querySelectorAll(this.selector)]
   }
 }
 
@@ -4495,7 +4528,6 @@ class History {
   restorationIdentifier = uuid()
   restorationData = {}
   started = false
-  pageLoaded = false
   currentIndex = 0
 
   constructor(delegate) {
@@ -4505,7 +4537,6 @@ class History {
   start() {
     if (!this.started) {
       addEventListener("popstate", this.onPopState, false);
-      addEventListener("load", this.onPageLoad, false);
       this.currentIndex = history.state?.turbo?.restorationIndex || 0;
       this.started = true;
       this.replace(new URL(window.location.href));
@@ -4515,7 +4546,6 @@ class History {
   stop() {
     if (this.started) {
       removeEventListener("popstate", this.onPopState, false);
-      removeEventListener("load", this.onPageLoad, false);
       this.started = false;
     }
   }
@@ -4571,34 +4601,20 @@ class History {
   // Event handlers
 
   onPopState = (event) => {
-    if (this.shouldHandlePopState()) {
-      const { turbo } = event.state || {};
-      if (turbo) {
-        this.location = new URL(window.location.href);
-        const { restorationIdentifier, restorationIndex } = turbo;
-        this.restorationIdentifier = restorationIdentifier;
-        const direction = restorationIndex > this.currentIndex ? "forward" : "back";
-        this.delegate.historyPoppedToLocationWithRestorationIdentifierAndDirection(this.location, restorationIdentifier, direction);
-        this.currentIndex = restorationIndex;
-      }
+    const { turbo } = event.state || {};
+    this.location = new URL(window.location.href);
+
+    if (turbo) {
+      const { restorationIdentifier, restorationIndex } = turbo;
+      this.restorationIdentifier = restorationIdentifier;
+      const direction = restorationIndex > this.currentIndex ? "forward" : "back";
+      this.delegate.historyPoppedToLocationWithRestorationIdentifierAndDirection(this.location, restorationIdentifier, direction);
+      this.currentIndex = restorationIndex;
+    } else {
+      this.currentIndex++;
+      this.delegate.historyPoppedWithEmptyState(this.location);
     }
   }
-
-  onPageLoad = async (_event) => {
-    await nextMicrotask();
-    this.pageLoaded = true;
-  }
-
-  // Private
-
-  shouldHandlePopState() {
-    // Safari dispatches a popstate event after window's load event, ignore it
-    return this.pageIsLoaded()
-  }
-
-  pageIsLoaded() {
-    return this.pageLoaded || document.readyState == "complete"
-  }
 }
 
 class LinkPrefetchObserver {
@@ -4673,7 +4689,7 @@ class LinkPrefetchObserver {
 
         fetchRequest.fetchOptions.priority = "low";
 
-        prefetchCache.setLater(location.toString(), fetchRequest, this.#cacheTtl);
+        prefetchCache.putLater(location, fetchRequest, this.#cacheTtl);
       }
     }
   }
@@ -4689,7 +4705,7 @@ class LinkPrefetchObserver {
 
   #tryToUsePrefetchedRequest = (event) => {
     if (event.target.tagName !== "FORM" && event.detail.fetchOptions.method === "GET") {
-      const cached = prefetchCache.get(event.detail.url.toString());
+      const cached = prefetchCache.get(event.detail.url);
 
       if (cached) {
         // User clicked link, use cache response
@@ -4879,7 +4895,7 @@ class Navigator {
       } else {
         await this.view.renderPage(snapshot, false, true, this.currentVisit);
       }
-      if(!snapshot.shouldPreserveScrollPosition) {
+      if (snapshot.refreshScroll !== "preserve") {
         this.view.scrollToTop();
       }
       this.view.clearSnapshotCache();
@@ -4919,20 +4935,10 @@ class Navigator {
     delete this.currentVisit;
   }
 
+  // Same-page links are no longer handled with a Visit.
+  // This method is still needed for Turbo Native adapters.
   locationWithActionIsSamePage(location, action) {
-    const anchor = getAnchor(location);
-    const currentAnchor = getAnchor(this.view.lastRenderedLocation);
-    const isRestorationToTop = action === "restore" && typeof anchor === "undefined";
-
-    return (
-      action !== "replace" &&
-      getRequestURL(location) === getRequestURL(this.view.lastRenderedLocation) &&
-      (isRestorationToTop || (anchor != null && anchor !== currentAnchor))
-    )
-  }
-
-  visitScrolledToSamePageLocation(oldURL, newURL) {
-    this.delegate.visitScrolledToSamePageLocation(oldURL, newURL);
+    return false
   }
 
   // Visits
@@ -5325,13 +5331,18 @@ class PageRenderer extends Renderer {
 
   #setLanguage() {
     const { documentElement } = this.currentSnapshot;
-    const { lang } = this.newSnapshot;
+    const { dir, lang } = this.newSnapshot;
 
     if (lang) {
       documentElement.setAttribute("lang", lang);
     } else {
       documentElement.removeAttribute("lang");
     }
+    if (dir) {
+      documentElement.setAttribute("dir", dir);
+    } else {
+      documentElement.removeAttribute("dir");
+    }
   }
 
   async mergeHead() {
@@ -5433,9 +5444,16 @@ class PageRenderer extends Renderer {
 
   activateNewBody() {
     document.adoptNode(this.newElement);
+    this.removeNoscriptElements();
     this.activateNewBodyScriptElements();
   }
 
+  removeNoscriptElements() {
+    for (const noscriptElement of this.newElement.querySelectorAll("noscript")) {
+      noscriptElement.remove();
+    }
+  }
+
   activateNewBodyScriptElements() {
     for (const inertScriptElement of this.newBodyScriptElements) {
       const activatedScriptElement = activateScriptElement(inertScriptElement);
@@ -5511,58 +5529,13 @@ class MorphingPageRenderer extends PageRenderer {
   }
 }
 
-class SnapshotCache {
-  keys = []
-  snapshots = {}
-
+class SnapshotCache extends LRUCache {
   constructor(size) {
-    this.size = size;
+    super(size, toCacheKey);
   }
 
-  has(location) {
-    return toCacheKey(location) in this.snapshots
-  }
-
-  get(location) {
-    if (this.has(location)) {
-      const snapshot = this.read(location);
-      this.touch(location);
-      return snapshot
-    }
-  }
-
-  put(location, snapshot) {
-    this.write(location, snapshot);
-    this.touch(location);
-    return snapshot
-  }
-
-  clear() {
-    this.snapshots = {};
-  }
-
-  // Private
-
-  read(location) {
-    return this.snapshots[toCacheKey(location)]
-  }
-
-  write(location, snapshot) {
-    this.snapshots[toCacheKey(location)] = snapshot;
-  }
-
-  touch(location) {
-    const key = toCacheKey(location);
-    const index = this.keys.indexOf(key);
-    if (index > -1) this.keys.splice(index, 1);
-    this.keys.unshift(key);
-    this.trim();
-  }
-
-  trim() {
-    for (const key of this.keys.splice(this.size)) {
-      delete this.snapshots[key];
-    }
+  get snapshots() {
+    return this.entries
   }
 }
 
@@ -5576,7 +5549,7 @@ class PageView extends View {
   }
 
   renderPage(snapshot, isPreview = false, willRender = true, visit) {
-    const shouldMorphPage = this.isPageRefresh(visit) && this.snapshot.shouldMorphPage;
+    const shouldMorphPage = this.isPageRefresh(visit) && (visit?.refresh?.method || this.snapshot.refreshMethod) === "morph";
     const rendererClass = shouldMorphPage ? MorphingPageRenderer : PageRenderer;
 
     const renderer = new rendererClass(this.snapshot, snapshot, isPreview, willRender);
@@ -5620,7 +5593,7 @@ class PageView extends View {
   }
 
   shouldPreserveScrollPosition(visit) {
-    return this.isPageRefresh(visit) && this.snapshot.shouldPreserveScrollPosition
+    return this.isPageRefresh(visit) && (visit?.refresh?.scroll || this.snapshot.refreshScroll) === "preserve"
   }
 
   get snapshot() {
@@ -5810,11 +5783,14 @@ class Session {
     }
   }
 
-  refresh(url, requestId) {
+  refresh(url, options = {}) {
+    options = typeof options === "string" ? { requestId: options } : options;
+
+    const { method, requestId, scroll } = options;
     const isRecentRequest = requestId && this.recentRequests.has(requestId);
     const isCurrentUrl = url === document.baseURI;
     if (!isRecentRequest && !this.navigator.currentVisit && isCurrentUrl) {
-      this.visit(url, { action: "replace", shouldCacheSnapshot: false });
+      this.visit(url, { action: "replace", shouldCacheSnapshot: false, refresh: { method, scroll } });
     }
   }
 
@@ -5918,6 +5894,12 @@ class Session {
     }
   }
 
+  historyPoppedWithEmptyState(location) {
+    this.history.replace(location);
+    this.view.lastRenderedLocation = location;
+    this.view.cacheSnapshot();
+  }
+
   // Scroll observer delegate
 
   scrollPositionChanged(position) {
@@ -5962,7 +5944,7 @@ class Session {
   // Navigator delegate
 
   allowsVisitingLocationWithAction(location, action) {
-    return this.locationWithActionIsSamePage(location, action) || this.applicationAllowsVisitingLocation(location)
+    return this.applicationAllowsVisitingLocation(location)
   }
 
   visitProposedToLocation(location, options) {
@@ -5978,9 +5960,7 @@ class Session {
       this.view.markVisitDirection(visit.direction);
     }
     extendURLWithDeprecatedProperties(visit.location);
-    if (!visit.silent) {
-      this.notifyApplicationAfterVisitingLocation(visit.location, visit.action);
-    }
+    this.notifyApplicationAfterVisitingLocation(visit.location, visit.action);
   }
 
   visitCompleted(visit) {
@@ -5989,14 +5969,6 @@ class Session {
     this.notifyApplicationAfterPageLoad(visit.getTimingMetrics());
   }
 
-  locationWithActionIsSamePage(location, action) {
-    return this.navigator.locationWithActionIsSamePage(location, action)
-  }
-
-  visitScrolledToSamePageLocation(oldURL, newURL) {
-    this.notifyApplicationAfterVisitingSamePageLocation(oldURL, newURL);
-  }
-
   // Form submit observer delegate
 
   willSubmitForm(form, submitter) {
@@ -6036,9 +6008,7 @@ class Session {
   // Page view delegate
 
   viewWillCacheSnapshot() {
-    if (!this.navigator.currentVisit?.silent) {
-      this.notifyApplicationBeforeCachingSnapshot();
-    }
+    this.notifyApplicationBeforeCachingSnapshot();
   }
 
   allowsImmediateRender({ element }, options) {
@@ -6130,15 +6100,6 @@ class Session {
     })
   }
 
-  notifyApplicationAfterVisitingSamePageLocation(oldURL, newURL) {
-    dispatchEvent(
-      new HashChangeEvent("hashchange", {
-        oldURL: oldURL.toString(),
-        newURL: newURL.toString()
-      })
-    );
-  }
-
   notifyApplicationAfterFrameLoad(frame) {
     return dispatch("turbo:frame-load", { target: frame })
   }
@@ -6224,7 +6185,7 @@ const deprecatedLocationPropertyDescriptors = {
 };
 
 const session = new Session(recentRequests);
-const { cache, navigator: navigator$1 } = session;
+const { cache, navigator } = session;
 
 /**
  * Starts the main session.
@@ -6290,19 +6251,6 @@ function renderStreamMessage(message) {
   session.renderStreamMessage(message);
 }
 
-/**
- * Removes all entries from the Turbo Drive page cache.
- * Call this when state has changed on the server that may affect cached pages.
- *
- * @deprecated since version 7.2.0 in favor of `Turbo.cache.clear()`
- */
-function clearCache() {
-  console.warn(
-    "Please replace `Turbo.clearCache()` with `Turbo.cache.clear()`. The top-level function is deprecated and will be removed in a future version of Turbo.`"
-  );
-  session.clearCache();
-}
-
 /**
  * Sets the delay after which the progress bar will appear during navigation.
  *
@@ -6362,7 +6310,7 @@ function morphTurboFrameElements(currentFrame, newFrame) {
 
 var Turbo = /*#__PURE__*/Object.freeze({
   __proto__: null,
-  navigator: navigator$1,
+  navigator: navigator,
   session: session,
   cache: cache,
   PageRenderer: PageRenderer,
@@ -6376,7 +6324,6 @@ var Turbo = /*#__PURE__*/Object.freeze({
   connectStreamSource: connectStreamSource,
   disconnectStreamSource: disconnectStreamSource,
   renderStreamMessage: renderStreamMessage,
-  clearCache: clearCache,
   setProgressBarDelay: setProgressBarDelay,
   setConfirmMethod: setConfirmMethod,
   setFormMode: setFormMode,
@@ -6431,11 +6378,17 @@ class FrameController {
       this.formLinkClickObserver.stop();
       this.linkInterceptor.stop();
       this.formSubmitObserver.stop();
+
+      if (!this.element.hasAttribute("recurse")) {
+        this.#currentFetchRequest?.cancel();
+      }
     }
   }
 
   disabledChanged() {
-    if (this.loadingStyle == FrameLoadingStyle.eager) {
+    if (this.disabled) {
+      this.#currentFetchRequest?.cancel();
+    } else if (this.loadingStyle == FrameLoadingStyle.eager) {
       this.#loadSourceURL();
     }
   }
@@ -6443,6 +6396,10 @@ class FrameController {
   sourceURLChanged() {
     if (this.#isIgnoringChangesTo("src")) return
 
+    if (!this.sourceURL) {
+      this.#currentFetchRequest?.cancel();
+    }
+
     if (this.element.isConnected) {
       this.complete = false;
     }
@@ -6544,15 +6501,18 @@ class FrameController {
     }
 
     this.formSubmission = new FormSubmission(this, element, submitter);
+
     const { fetchRequest } = this.formSubmission;
-    this.prepareRequest(fetchRequest);
+    const frame = this.#findFrameElement(element, submitter);
+
+    this.prepareRequest(fetchRequest, frame);
     this.formSubmission.start();
   }
 
   // Fetch request delegate
 
-  prepareRequest(request) {
-    request.headers["Turbo-Frame"] = this.id;
+  prepareRequest(request, frame = this) {
+    request.headers["Turbo-Frame"] = frame.id;
 
     if (this.currentNavigationElement?.hasAttribute("data-turbo-stream")) {
       request.acceptResponseType(StreamMessage.contentType);
@@ -6794,7 +6754,9 @@ class FrameController {
 
   #findFrameElement(element, submitter) {
     const id = getAttribute("data-turbo-frame", submitter, element) || this.element.getAttribute("target");
-    return getFrameElementById(id) ?? this.element
+    const target = this.#getFrameElementById(id);
+
+    return target instanceof FrameElement ? target : this.element
   }
 
   async extractForeignFrameElement(container) {
@@ -6838,9 +6800,11 @@ class FrameController {
     }
 
     if (id) {
-      const frameElement = getFrameElementById(id);
+      const frameElement = this.#getFrameElementById(id);
       if (frameElement) {
         return !frameElement.disabled
+      } else if (id == "_parent") {
+        return false
       }
     }
 
@@ -6861,8 +6825,12 @@ class FrameController {
     return this.element.id
   }
 
+  get disabled() {
+    return this.element.disabled
+  }
+
   get enabled() {
-    return !this.element.disabled
+    return !this.disabled
   }
 
   get sourceURL() {
@@ -6922,13 +6890,15 @@ class FrameController {
     callback();
     delete this.currentNavigationElement;
   }
-}
 
-function getFrameElementById(id) {
-  if (id != null) {
-    const element = document.getElementById(id);
-    if (element instanceof FrameElement) {
-      return element
+  #getFrameElementById(id) {
+    if (id != null) {
+      const element = id === "_parent" ?
+        this.element.parentElement.closest("turbo-frame") :
+        document.getElementById(id);
+      if (element instanceof FrameElement) {
+        return element
+      }
     }
   }
 }
@@ -6953,6 +6923,7 @@ function activateElement(element, currentURL) {
 
 const StreamActions = {
   after() {
+    this.removeDuplicateTargetSiblings();
     this.targetElements.forEach((e) => e.parentElement?.insertBefore(this.templateContent, e.nextSibling));
   },
 
@@ -6962,6 +6933,7 @@ const StreamActions = {
   },
 
   before() {
+    this.removeDuplicateTargetSiblings();
     this.targetElements.forEach((e) => e.parentElement?.insertBefore(this.templateContent, e));
   },
 
@@ -7000,7 +6972,11 @@ const StreamActions = {
   },
 
   refresh() {
-    session.refresh(this.baseURI, this.requestId);
+    const method = this.getAttribute("method");
+    const requestId = this.requestId;
+    const scroll = this.getAttribute("scroll");
+
+    session.refresh(this.baseURI, { method, requestId, scroll });
   }
 };
 
@@ -7078,6 +7054,23 @@ class StreamElement extends HTMLElement {
     return existingChildren.filter((c) => newChildrenIds.includes(c.getAttribute("id")))
   }
 
+  /**
+  * Removes duplicate siblings (by ID)
+  */
+  removeDuplicateTargetSiblings() {
+    this.duplicateSiblings.forEach((c) => c.remove());
+  }
+
+  /**
+  * Gets the list of duplicate siblings (i.e. those with the same ID)
+  */
+  get duplicateSiblings() {
+    const existingChildren = this.targetElements.flatMap((e) => [...e.parentElement.children]).filter((c) => !!c.id);
+    const newChildrenIds = [...(this.templateContent?.children || [])].filter((c) => !!c.id).map((c) => c.id);
+
+    return existingChildren.filter((c) => newChildrenIds.includes(c.id))
+  }
+
   /**
    * Gets the action function to be performed.
    */
@@ -7229,11 +7222,11 @@ if (customElements.get("turbo-stream-source") === undefined) {
 }
 
 (() => {
-  let element = document.currentScript;
-  if (!element) return
-  if (element.hasAttribute("data-turbo-suppress-warning")) return
+  const scriptElement = document.currentScript;
+  if (!scriptElement) return
+  if (scriptElement.hasAttribute("data-turbo-suppress-warning")) return
 
-  element = element.parentElement;
+  let element = scriptElement.parentElement;
   while (element) {
     if (element == document.body) {
       return console.warn(
@@ -7247,7 +7240,7 @@ if (customElements.get("turbo-stream-source") === undefined) {
         ——
         Suppress this warning by adding a "data-turbo-suppress-warning" attribute to: %s
       `,
-        element.outerHTML
+        scriptElement.outerHTML
       )
     }
 
@@ -7258,4 +7251,4 @@ if (customElements.get("turbo-stream-source") === undefined) {
 window.Turbo = { ...Turbo, StreamActions };
 start();
 
-export { FetchEnctype, FetchMethod, FetchRequest, FetchResponse, FrameElement, FrameLoadingStyle, FrameRenderer, PageRenderer, PageSnapshot, StreamActions, StreamElement, StreamSourceElement, cache, clearCache, config, connectStreamSource, disconnectStreamSource, fetchWithTurboHeaders as fetch, fetchEnctypeFromString, fetchMethodFromString, isSafe, morphBodyElements, morphChildren, morphElements, morphTurboFrameElements, navigator$1 as navigator, registerAdapter, renderStreamMessage, session, setConfirmMethod, setFormMode, setProgressBarDelay, start, visit };
+export { FetchEnctype, FetchMethod, FetchRequest, FetchResponse, FrameElement, FrameLoadingStyle, FrameRenderer, PageRenderer, PageSnapshot, StreamActions, StreamElement, StreamSourceElement, cache, config, connectStreamSource, disconnectStreamSource, fetchWithTurboHeaders as fetch, fetchEnctypeFromString, fetchMethodFromString, isSafe, morphBodyElements, morphChildren, morphElements, morphTurboFrameElements, navigator, registerAdapter, renderStreamMessage, session, setConfirmMethod, setFormMode, setProgressBarDelay, start, visit };