@hotwired/turbo 8.0.21 → 8.0.22

package/README.md

@@ -15,4 +15,4 @@ Read more on [turbo.hotwired.dev](https://turbo.hotwired.dev).
 
 Please read [CONTRIBUTING.md](./CONTRIBUTING.md).
 
-© 2024 37signals LLC.
+© 2026 37signals LLC.

package/dist/turbo.es2017-esm.js

@@ -2119,7 +2119,6 @@ var Idiomorph = (function () {
    * @property {ConfigInternal['callbacks']} callbacks
    * @property {ConfigInternal['head']} head
    * @property {HTMLDivElement} pantry
-   * @property {Element[]} activeElementAndParents
    */
 
   //=============================================================================
@@ -2195,6 +2194,14 @@ 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,
@@ -2203,8 +2210,10 @@ var Idiomorph = (function () {
       oldNode, // start point for iteration
       oldNode.nextSibling, // end point for iteration
     );
-    // this is safe even with siblings, because normalizeParent returns a SlicedParentNode if needed.
-    return Array.from(oldParent.childNodes);
+
+    // return just the morphed nodes
+    childNodes = Array.from(oldParent.childNodes);
+    return childNodes.slice(index, childNodes.length - rightMargin);
   }
 
   /**
@@ -2233,11 +2242,8 @@ var Idiomorph = (function () {
 
     const results = fn();
 
-    if (
-      activeElementId &&
-      activeElementId !== document.activeElement?.getAttribute("id")
-    ) {
-      activeElement = ctx.target.querySelector(`[id="${activeElementId}"]`);
+    if (activeElementId && activeElementId !== document.activeElement?.id) {
+      activeElement = ctx.target.querySelector(`#${activeElementId}`);
       activeElement?.focus();
     }
     if (activeElement && !activeElement.selectionEnd && selectionEnd) {
@@ -2315,23 +2321,17 @@ var Idiomorph = (function () {
         }
 
         // if the matching node is elsewhere in the original content
-        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")
+        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 (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;
-          }
+          morphNode(movedChild, newChild, ctx);
+          insertionPoint = movedChild.nextSibling;
+          continue;
         }
 
         // last resort: insert the new node from scratch
@@ -2441,8 +2441,7 @@ 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
-          // @ts-ignore pretend cursor is Element rather than Node, we're just testing for array inclusion
-          if (ctx.activeElementAndParents.includes(cursor)) break;
+          if (cursor.contains(document.activeElement)) break;
 
           cursor = cursor.nextSibling;
         }
@@ -2492,9 +2491,7 @@ 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.
-          // 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"))
+          (!oldElt.id || oldElt.id === newElt.id)
         );
       }
 
@@ -2558,11 +2555,8 @@ var Idiomorph = (function () {
       const target =
         /** @type {Element} - will always be found */
         (
-          // 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}"]`)
+          ctx.target.querySelector(`#${id}`) ||
+            ctx.pantry.querySelector(`#${id}`)
         );
       removeElementFromAncestorsIdMaps(target, ctx);
       moveBefore(parentNode, target, after);
@@ -2578,8 +2572,7 @@ var Idiomorph = (function () {
      * @param {MorphContext} ctx
      */
     function removeElementFromAncestorsIdMaps(element, ctx) {
-      // we know id is non-null String, because this function is only called on elements with ids
-      const id = /** @type {String} */ (element.getAttribute("id"));
+      const id = element.id;
       /** @ts-ignore - safe to loop in this way **/
       while ((element = element.parentNode)) {
         let idSet = ctx.idMap.get(element);
@@ -3017,7 +3010,6 @@ var Idiomorph = (function () {
         idMap: idMap,
         persistentIds: persistentIds,
         pantry: createPantry(),
-        activeElementAndParents: createActiveElementAndParents(oldNode),
         callbacks: mergedConfig.callbacks,
         head: mergedConfig.head,
       };
@@ -3058,24 +3050,6 @@ 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
      *
@@ -3084,8 +3058,7 @@ var Idiomorph = (function () {
      */
     function findIdElements(root) {
       let elements = Array.from(root.querySelectorAll("[id]"));
-      // root could be a document fragment which doesn't have `getAttribute`
-      if (root.getAttribute?.("id")) {
+      if (root.id) {
         elements.push(root);
       }
       return elements;
@@ -3104,9 +3077,7 @@ var Idiomorph = (function () {
      */
     function populateIdMapWithTree(idMap, persistentIds, root, elements) {
       for (const elt of elements) {
-        // 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)) {
+        if (persistentIds.has(elt.id)) {
           /** @type {Element|null} */
           let current = elt;
           // walk up the parent hierarchy of that element, adding the id
@@ -3118,7 +3089,7 @@ var Idiomorph = (function () {
               idSet = new Set();
               idMap.set(current, idSet);
             }
-            idSet.add(id);
+            idSet.add(elt.id);
 
             if (current === root) break;
             current = current.parentElement;
@@ -3232,9 +3203,8 @@ 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 instead we create a fake parent node that only sees a slice of its children.
-          /** @type {Element} */
-          return /** @type {any} */ (new SlicedParentNode(newContent));
+          // so we create a duck-typed parent node instead.
+          return createDuckTypedParent(newContent);
         } else {
           // a single node is added as a child to a dummy parent
           const dummyParent = document.createElement("div");
@@ -3253,78 +3223,33 @@ var Idiomorph = (function () {
     }
 
     /**
-     * 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.
+     * Creates a fake duck-typed parent element to wrap a single node, without actually reparenting it.
      * "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}
      */
-    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;
-      }
+    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;
+          },
+        })
+      );
     }
 
     /**
@@ -6185,7 +6110,9 @@ const deprecatedLocationPropertyDescriptors = {
 };
 
 const session = new Session(recentRequests);
-const { cache, navigator } = session;
+
+// Rename `navigator` to avoid shadowing `window.navigator`
+const { cache, navigator: sessionNavigator } = session;
 
 /**
  * Starts the main session.
@@ -6310,14 +6237,14 @@ function morphTurboFrameElements(currentFrame, newFrame) {
 
 var Turbo = /*#__PURE__*/Object.freeze({
   __proto__: null,
-  navigator: navigator,
-  session: session,
-  cache: cache,
   PageRenderer: PageRenderer,
   PageSnapshot: PageSnapshot,
   FrameRenderer: FrameRenderer,
   fetch: fetchWithTurboHeaders,
   config: config,
+  session: session,
+  cache: cache,
+  navigator: sessionNavigator,
   start: start,
   registerAdapter: registerAdapter,
   visit: visit,
@@ -7251,4 +7178,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, config, connectStreamSource, disconnectStreamSource, fetchWithTurboHeaders as fetch, fetchEnctypeFromString, fetchMethodFromString, isSafe, morphBodyElements, morphChildren, morphElements, morphTurboFrameElements, 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, sessionNavigator as navigator, registerAdapter, renderStreamMessage, session, setConfirmMethod, setFormMode, setProgressBarDelay, start, visit };

package/dist/turbo.es2017-umd.js

@@ -2125,7 +2125,6 @@ Copyright © 2026 37signals LLC
      * @property {ConfigInternal['callbacks']} callbacks
      * @property {ConfigInternal['head']} head
      * @property {HTMLDivElement} pantry
-     * @property {Element[]} activeElementAndParents
      */
 
     //=============================================================================
@@ -2201,6 +2200,14 @@ Copyright © 2026 37signals LLC
      */
     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,
@@ -2209,8 +2216,10 @@ Copyright © 2026 37signals LLC
         oldNode, // start point for iteration
         oldNode.nextSibling, // end point for iteration
       );
-      // this is safe even with siblings, because normalizeParent returns a SlicedParentNode if needed.
-      return Array.from(oldParent.childNodes);
+
+      // return just the morphed nodes
+      childNodes = Array.from(oldParent.childNodes);
+      return childNodes.slice(index, childNodes.length - rightMargin);
     }
 
     /**
@@ -2239,11 +2248,8 @@ Copyright © 2026 37signals LLC
 
       const results = fn();
 
-      if (
-        activeElementId &&
-        activeElementId !== document.activeElement?.getAttribute("id")
-      ) {
-        activeElement = ctx.target.querySelector(`[id="${activeElementId}"]`);
+      if (activeElementId && activeElementId !== document.activeElement?.id) {
+        activeElement = ctx.target.querySelector(`#${activeElementId}`);
         activeElement?.focus();
       }
       if (activeElement && !activeElement.selectionEnd && selectionEnd) {
@@ -2321,23 +2327,17 @@ Copyright © 2026 37signals LLC
           }
 
           // if the matching node is elsewhere in the original content
-          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")
+          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 (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;
-            }
+            morphNode(movedChild, newChild, ctx);
+            insertionPoint = movedChild.nextSibling;
+            continue;
           }
 
           // last resort: insert the new node from scratch
@@ -2447,8 +2447,7 @@ Copyright © 2026 37signals LLC
 
             // 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
-            // @ts-ignore pretend cursor is Element rather than Node, we're just testing for array inclusion
-            if (ctx.activeElementAndParents.includes(cursor)) break;
+            if (cursor.contains(document.activeElement)) break;
 
             cursor = cursor.nextSibling;
           }
@@ -2498,9 +2497,7 @@ Copyright © 2026 37signals LLC
             // 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.
-            // 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"))
+            (!oldElt.id || oldElt.id === newElt.id)
           );
         }
 
@@ -2564,11 +2561,8 @@ Copyright © 2026 37signals LLC
         const target =
           /** @type {Element} - will always be found */
           (
-            // 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}"]`)
+            ctx.target.querySelector(`#${id}`) ||
+              ctx.pantry.querySelector(`#${id}`)
           );
         removeElementFromAncestorsIdMaps(target, ctx);
         moveBefore(parentNode, target, after);
@@ -2584,8 +2578,7 @@ Copyright © 2026 37signals LLC
        * @param {MorphContext} ctx
        */
       function removeElementFromAncestorsIdMaps(element, ctx) {
-        // we know id is non-null String, because this function is only called on elements with ids
-        const id = /** @type {String} */ (element.getAttribute("id"));
+        const id = element.id;
         /** @ts-ignore - safe to loop in this way **/
         while ((element = element.parentNode)) {
           let idSet = ctx.idMap.get(element);
@@ -3023,7 +3016,6 @@ Copyright © 2026 37signals LLC
           idMap: idMap,
           persistentIds: persistentIds,
           pantry: createPantry(),
-          activeElementAndParents: createActiveElementAndParents(oldNode),
           callbacks: mergedConfig.callbacks,
           head: mergedConfig.head,
         };
@@ -3064,24 +3056,6 @@ Copyright © 2026 37signals LLC
         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
        *
@@ -3090,8 +3064,7 @@ Copyright © 2026 37signals LLC
        */
       function findIdElements(root) {
         let elements = Array.from(root.querySelectorAll("[id]"));
-        // root could be a document fragment which doesn't have `getAttribute`
-        if (root.getAttribute?.("id")) {
+        if (root.id) {
           elements.push(root);
         }
         return elements;
@@ -3110,9 +3083,7 @@ Copyright © 2026 37signals LLC
        */
       function populateIdMapWithTree(idMap, persistentIds, root, elements) {
         for (const elt of elements) {
-          // 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)) {
+          if (persistentIds.has(elt.id)) {
             /** @type {Element|null} */
             let current = elt;
             // walk up the parent hierarchy of that element, adding the id
@@ -3124,7 +3095,7 @@ Copyright © 2026 37signals LLC
                 idSet = new Set();
                 idMap.set(current, idSet);
               }
-              idSet.add(id);
+              idSet.add(elt.id);
 
               if (current === root) break;
               current = current.parentElement;
@@ -3238,9 +3209,8 @@ Copyright © 2026 37signals LLC
           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 instead we create a fake parent node that only sees a slice of its children.
-            /** @type {Element} */
-            return /** @type {any} */ (new SlicedParentNode(newContent));
+            // so we create a duck-typed parent node instead.
+            return createDuckTypedParent(newContent);
           } else {
             // a single node is added as a child to a dummy parent
             const dummyParent = document.createElement("div");
@@ -3259,78 +3229,33 @@ Copyright © 2026 37signals LLC
       }
 
       /**
-       * 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.
+       * Creates a fake duck-typed parent element to wrap a single node, without actually reparenting it.
        * "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}
        */
-      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;
-        }
+      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;
+            },
+          })
+        );
       }
 
       /**
@@ -6191,7 +6116,9 @@ Copyright © 2026 37signals LLC
   };
 
   const session = new Session(recentRequests);
-  const { cache, navigator } = session;
+
+  // Rename `navigator` to avoid shadowing `window.navigator`
+  const { cache, navigator: sessionNavigator } = session;
 
   /**
    * Starts the main session.
@@ -6316,14 +6243,14 @@ Copyright © 2026 37signals LLC
 
   var Turbo = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    navigator: navigator,
-    session: session,
-    cache: cache,
     PageRenderer: PageRenderer,
     PageSnapshot: PageSnapshot,
     FrameRenderer: FrameRenderer,
     fetch: fetchWithTurboHeaders,
     config: config,
+    session: session,
+    cache: cache,
+    navigator: sessionNavigator,
     start: start,
     registerAdapter: registerAdapter,
     visit: visit,
@@ -7281,7 +7208,7 @@ Copyright © 2026 37signals LLC
   exports.morphChildren = morphChildren;
   exports.morphElements = morphElements;
   exports.morphTurboFrameElements = morphTurboFrameElements;
-  exports.navigator = navigator;
+  exports.navigator = sessionNavigator;
   exports.registerAdapter = registerAdapter;
   exports.renderStreamMessage = renderStreamMessage;
   exports.session = session;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hotwired/turbo",
-  "version": "8.0.21",
+  "version": "8.0.22",
   "description": "The speed of a single-page web application without having to write any JavaScript",
   "module": "dist/turbo.es2017-esm.js",
   "main": "dist/turbo.es2017-umd.js",