@absolutejs/absolute 0.20.0-beta.57 → 0.20.0-beta.59

package/dist/mobile/shellBootstrap.js

@@ -1,5 +1,264 @@
+// src/mobile/uiPrimitives.ts
+var STYLE_ID = "absolute-mobile-ui-primitives";
+var NAVIGATION_EVENT = "absolute:navigation-change";
+var SHEET_EVENT = "absolute:sheet-change";
+var BACK_EVENT = "absolute:back-request";
+var ACTIVE_SHEET_SELECTOR = "dialog[data-absolute-sheet][open]";
+var TAB_LINK_SELECTOR = "[data-absolute-tab-bar] a[href]";
+var UI_STYLE = `
+[data-absolute-app-shell] {
+	display: grid;
+	grid-template-rows: auto minmax(0, 1fr) auto;
+	box-sizing: border-box;
+	min-height: var(--absolute-available-height, 100dvh);
+	padding-inline: var(--absolute-safe-area-inset-left, 0px) var(--absolute-safe-area-inset-right, 0px);
+}
+[data-absolute-app-header] {
+	padding-top: var(--absolute-safe-area-inset-top, 0px);
+}
+[data-absolute-app-main], [data-absolute-navigation-stack] {
+	min-width: 0;
+	min-height: 0;
+}
+[data-absolute-app-main] {
+	overflow: auto;
+	overscroll-behavior-y: contain;
+}
+[data-absolute-navigation-stack] {
+	view-transition-name: absolute-mobile-stack;
+}
+[data-absolute-tab-bar] {
+	display: flex;
+	align-items: stretch;
+	justify-content: space-around;
+	box-sizing: border-box;
+	padding-bottom: var(--absolute-safe-area-inset-bottom, 0px);
+	background: Canvas;
+	color: CanvasText;
+}
+[data-absolute-tab-bar] > a {
+	display: grid;
+	flex: 1 1 0;
+	min-width: 0;
+	min-height: 2.75rem;
+	place-items: center;
+	padding: 0.375rem 0.5rem;
+	color: inherit;
+	text-align: center;
+	text-decoration: none;
+	touch-action: manipulation;
+}
+[data-absolute-tab-bar] > a[aria-current="page"] {
+	font-weight: 700;
+}
+dialog[data-absolute-sheet] {
+	box-sizing: border-box;
+	width: min(100%, var(--absolute-sheet-max-width, 42rem));
+	max-height: min(90dvh, var(--absolute-available-height, 90dvh));
+	margin: auto auto 0;
+	padding: 1rem max(1rem, var(--absolute-safe-area-inset-right, 0px)) max(1rem, var(--absolute-safe-area-inset-bottom, 0px)) max(1rem, var(--absolute-safe-area-inset-left, 0px));
+	overflow: auto;
+	border: 1px solid color-mix(in srgb, CanvasText 18%, transparent);
+	border-radius: 1rem 1rem 0 0;
+	background: Canvas;
+	color: CanvasText;
+	box-shadow: 0 -0.5rem 2rem color-mix(in srgb, CanvasText 18%, transparent);
+}
+dialog[data-absolute-sheet]::backdrop {
+	background: color-mix(in srgb, CanvasText 38%, transparent);
+}
+@keyframes absolute-mobile-forward-old { to { opacity: 0; transform: translateX(-12%); } }
+@keyframes absolute-mobile-forward-new { from { opacity: 0; transform: translateX(12%); } }
+@keyframes absolute-mobile-back-old { to { opacity: 0; transform: translateX(12%); } }
+@keyframes absolute-mobile-back-new { from { opacity: 0; transform: translateX(-12%); } }
+html[data-absolute-navigation-direction="forward"]::view-transition-old(absolute-mobile-stack) { animation: 180ms ease both absolute-mobile-forward-old; }
+html[data-absolute-navigation-direction="forward"]::view-transition-new(absolute-mobile-stack) { animation: 180ms ease both absolute-mobile-forward-new; }
+html[data-absolute-navigation-direction="back"]::view-transition-old(absolute-mobile-stack) { animation: 180ms ease both absolute-mobile-back-old; }
+html[data-absolute-navigation-direction="back"]::view-transition-new(absolute-mobile-stack) { animation: 180ms ease both absolute-mobile-back-new; }
+html[data-absolute-reduced-motion="reduce"]::view-transition-old(absolute-mobile-stack),
+html[data-absolute-reduced-motion="reduce"]::view-transition-new(absolute-mobile-stack) { animation: none; }
+`;
+var currentPath = () => `${location.pathname}${location.search}${location.hash}`;
+var ensureStyle = () => {
+  let style = document.getElementById(STYLE_ID);
+  if (!(style instanceof HTMLStyleElement)) {
+    style = document.createElement("style");
+    style.id = STYLE_ID;
+    style.textContent = UI_STYLE;
+    document.head.append(style);
+  }
+};
+var sheetById = (id) => {
+  const target = document.getElementById(id);
+  return target instanceof HTMLDialogElement && target.dataset.absoluteSheet !== undefined ? target : undefined;
+};
+var dispatchSheet = (sheet, open) => dispatchEvent(new CustomEvent(SHEET_EVENT, {
+  detail: { id: sheet.id, open }
+}));
+var focusSheet = (sheet) => {
+  const target = sheet.querySelector('[autofocus], button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])');
+  (target ?? sheet).focus();
+};
+var sheetOpeners = new WeakMap;
+var closeAbsoluteMobileSheet = (target) => {
+  const sheet = typeof target === "string" ? sheetById(target) : target;
+  if (!sheet || !sheet.open)
+    return false;
+  if (typeof sheet.close === "function")
+    sheet.close();
+  else
+    sheet.removeAttribute("open");
+  sheet.removeAttribute("aria-modal");
+  sheetOpeners.get(sheet)?.focus();
+  sheetOpeners.delete(sheet);
+  dispatchSheet(sheet, false);
+  return true;
+};
+var openAbsoluteMobileSheet = (target, opener) => {
+  const sheet = typeof target === "string" ? sheetById(target) : target;
+  if (!sheet || sheet.dataset.absoluteSheet === undefined)
+    return false;
+  const active = document.querySelector(ACTIVE_SHEET_SELECTOR);
+  if (active && active !== sheet)
+    closeAbsoluteMobileSheet(active);
+  if (opener)
+    sheetOpeners.set(sheet, opener);
+  if (!sheet.open) {
+    if (typeof sheet.showModal === "function")
+      sheet.showModal();
+    else
+      sheet.setAttribute("open", "");
+  }
+  sheet.setAttribute("aria-modal", "true");
+  focusSheet(sheet);
+  dispatchSheet(sheet, true);
+  return true;
+};
+var readAbsoluteMobileLinkIntent = (anchor) => {
+  const mode = anchor.dataset.absoluteLink;
+  if (mode === "back")
+    return { kind: "back" };
+  if (mode === "external")
+    return { kind: "external" };
+  return { kind: "navigate", replace: mode === "replace" };
+};
+var requestAbsoluteMobileBack = () => {
+  const event = new CustomEvent(BACK_EVENT, { cancelable: true });
+  return !dispatchEvent(event);
+};
+var normalizePathname = (value) => {
+  try {
+    return new URL(value, location.href).pathname.replace(/\/$/u, "") || "/";
+  } catch {
+    return;
+  }
+};
+var syncTabLinks = (path) => {
+  const activePath = normalizePathname(path);
+  if (!activePath)
+    return;
+  document.querySelectorAll(TAB_LINK_SELECTOR).forEach((anchor) => {
+    const candidate = normalizePathname(anchor.href);
+    const prefix = anchor.dataset.absoluteTabMatch === "prefix";
+    const active = candidate !== undefined && (prefix ? activePath === candidate || candidate !== "/" && activePath.startsWith(`${candidate}/`) : activePath === candidate);
+    if (active)
+      anchor.setAttribute("aria-current", "page");
+    else
+      anchor.removeAttribute("aria-current");
+  });
+};
+var installAbsoluteMobileUiPrimitives = () => {
+  let disposed = false;
+  let scheduled = false;
+  let path = currentPath();
+  const refreshDocument = (nextPath = path) => {
+    if (disposed || !document.head || !document.body)
+      return;
+    path = nextPath;
+    ensureStyle();
+    syncTabLinks(path);
+  };
+  const scheduleRefresh = () => {
+    if (scheduled || disposed)
+      return;
+    scheduled = true;
+    queueMicrotask(() => {
+      scheduled = false;
+      refreshDocument();
+    });
+  };
+  const handleClick = (event) => {
+    if (!(event.target instanceof Element))
+      return;
+    const opener = event.target.closest("[data-absolute-sheet-open]");
+    if (opener?.dataset.absoluteSheetOpen) {
+      if (openAbsoluteMobileSheet(opener.dataset.absoluteSheetOpen, opener))
+        event.preventDefault();
+      return;
+    }
+    const closer = event.target.closest("[data-absolute-sheet-close]");
+    const sheet = closer?.closest("dialog[data-absolute-sheet]");
+    if (sheet && closeAbsoluteMobileSheet(sheet)) {
+      event.preventDefault();
+      return;
+    }
+    if (event.target instanceof HTMLDialogElement && event.target.dataset.absoluteSheet !== undefined) {
+      const rect = event.target.getBoundingClientRect();
+      const outside = event.clientX < rect.left || event.clientX > rect.right || event.clientY < rect.top || event.clientY > rect.bottom;
+      if (outside && closeAbsoluteMobileSheet(event.target))
+        event.preventDefault();
+    }
+  };
+  const handleCancel = (event) => {
+    if (!(event.target instanceof HTMLDialogElement))
+      return;
+    if (event.target.dataset.absoluteSheet === undefined)
+      return;
+    event.preventDefault();
+    closeAbsoluteMobileSheet(event.target);
+  };
+  const handleBack = (event) => {
+    const active = document.querySelector(ACTIVE_SHEET_SELECTOR);
+    if (!active)
+      return;
+    event.preventDefault();
+    closeAbsoluteMobileSheet(active);
+  };
+  const observer = new MutationObserver(scheduleRefresh);
+  observer.observe(document.documentElement, {
+    childList: true,
+    subtree: true
+  });
+  addEventListener("click", handleClick);
+  addEventListener("cancel", handleCancel, true);
+  addEventListener(BACK_EVENT, handleBack);
+  refreshDocument();
+  return {
+    refreshDocument,
+    requestBack: requestAbsoluteMobileBack,
+    dispose: () => {
+      if (disposed)
+        return;
+      disposed = true;
+      observer.disconnect();
+      removeEventListener("click", handleClick);
+      removeEventListener("cancel", handleCancel, true);
+      removeEventListener(BACK_EVENT, handleBack);
+    },
+    navigate: (detail) => {
+      path = detail.to;
+      document.documentElement.dataset.absoluteNavigationDirection = detail.direction;
+      refreshDocument(path);
+      dispatchEvent(new CustomEvent(NAVIGATION_EVENT, {
+        detail
+      }));
+    }
+  };
+};
+
 // src/mobile/shellBootstrap.ts
 import { App } from "@capacitor/app";
+import { Browser } from "@capacitor/browser";
 
 // src/mobile/producerContextState.ts
 var ABSOLUTE_MOBILE_PRODUCER_STORAGE_KEY = Symbol.for("absolutejs.mobileProducerAsyncLocalStorage");
@@ -199,7 +458,11 @@ var createAbsoluteMobilePageRequest = (manifest, path, options = {}) => {
   headers.set(MOBILE_PAGE_REQUEST_HEADERS.pageId, page.pageId);
   headers.set(MOBILE_PAGE_REQUEST_HEADERS.protocol, String(ABSOLUTE_MOBILE_PAGE_PROTOCOL_VERSION));
   headers.set(MOBILE_PAGE_REQUEST_HEADERS.runtime, manifest.runtime);
-  return new Request(url, { headers, method: "GET" });
+  return new Request(url, {
+    headers,
+    method: "GET",
+    ...options.signal ? { signal: options.signal } : {}
+  });
 };
 var fetchAbsoluteMobilePage = async (manifest, path, options = {}) => {
   const request = createAbsoluteMobilePageRequest(manifest, path, options);
@@ -643,7 +906,7 @@ import {
   platform,
   systemBars
 } from "@absolutejs/devices";
-var STYLE_ID = "absolute-mobile-adaptive-shell";
+var STYLE_ID2 = "absolute-mobile-adaptive-shell";
 var ANNOUNCER_ID = "absolute-mobile-announcer";
 var HOST_METRICS_EVENT = "absolute:native-host-metrics";
 var STATUS_STYLE = `
@@ -691,11 +954,11 @@ var viewportSize = () => ({
   width: finitePixels(globalThis.visualViewport?.width ?? innerWidth)
 });
 var setPixels = (name, value) => document.documentElement.style.setProperty(name, `${finitePixels(value)}px`);
-var ensureStyle = () => {
-  let style = document.getElementById(STYLE_ID);
+var ensureStyle2 = () => {
+  let style = document.getElementById(STYLE_ID2);
   if (!(style instanceof HTMLStyleElement)) {
     style = document.createElement("style");
-    style.id = STYLE_ID;
+    style.id = STYLE_ID2;
     style.textContent = STATUS_STYLE;
     document.head.append(style);
   }
@@ -773,7 +1036,7 @@ var installAbsoluteMobileAdaptiveShell = async (devices = defaultDevices) => {
     if (disposed || !document.head || !document.body)
       return;
     ensureViewport();
-    ensureStyle();
+    ensureStyle2();
     const root = document.documentElement;
     const current = state();
     root.dataset.absoluteMobile = "";
@@ -884,9 +1147,268 @@ var installAbsoluteMobileAdaptiveShell = async (devices = defaultDevices) => {
   };
 };
 
+// src/mobile/navigationLifecycle.ts
+var isAbortError = (error) => error instanceof DOMException ? error.name === "AbortError" : error instanceof Error && error.name === "AbortError";
+var cancelledResult = { kind: "cancelled" };
+var committedResult = { kind: "committed" };
+var failedResult = (error, phase) => ({ error, kind: "failed", phase });
+var createAbsoluteMobileNavigationCoordinator = (options) => {
+  let activeLoad;
+  let commitQueue = Promise.resolve();
+  let disposed = false;
+  let generation = 0;
+  let lifecyclePhase = "idle";
+  const navigate = async (request) => {
+    if (disposed)
+      return cancelledResult;
+    const ownGeneration = generation += 1;
+    activeLoad?.abort();
+    const controller = new AbortController;
+    activeLoad = controller;
+    lifecyclePhase = "loading";
+    options.onStart?.(request);
+    let payload;
+    try {
+      payload = await options.load(request, controller.signal);
+    } catch (error) {
+      if (controller.signal.aborted || isAbortError(error) || ownGeneration !== generation || disposed) {
+        if (ownGeneration === generation)
+          lifecyclePhase = "idle";
+        return cancelledResult;
+      }
+      lifecyclePhase = "idle";
+      options.onFailure?.(error, "load", request);
+      return failedResult(error, "load");
+    }
+    if (ownGeneration !== generation || disposed)
+      return cancelledResult;
+    if (activeLoad === controller)
+      activeLoad = undefined;
+    lifecyclePhase = "queued";
+    const execute = async () => {
+      if (ownGeneration !== generation || disposed) {
+        if (ownGeneration === generation)
+          lifecyclePhase = "idle";
+        return cancelledResult;
+      }
+      lifecyclePhase = "committing";
+      try {
+        await options.commit(payload, request);
+        options.onCommit?.(request);
+      } catch (error) {
+        if (ownGeneration === generation) {
+          lifecyclePhase = "idle";
+          options.onFailure?.(error, "commit", request);
+        }
+        return failedResult(error, "commit");
+      }
+      if (ownGeneration !== generation || disposed) {
+        return cancelledResult;
+      }
+      lifecyclePhase = "idle";
+      options.onSuccess?.(request);
+      return committedResult;
+    };
+    const result = commitQueue.then(execute, execute);
+    commitQueue = result.then(() => {
+      return;
+    }, () => {
+      return;
+    });
+    return result;
+  };
+  return {
+    cancelPending: () => {
+      if (disposed || lifecyclePhase !== "loading" && lifecyclePhase !== "queued")
+        return false;
+      generation += 1;
+      activeLoad?.abort();
+      activeLoad = undefined;
+      lifecyclePhase = "idle";
+      return true;
+    },
+    dispose: () => {
+      if (disposed)
+        return;
+      disposed = true;
+      generation += 1;
+      activeLoad?.abort();
+      activeLoad = undefined;
+      lifecyclePhase = "idle";
+    },
+    navigate: (request) => navigate(request),
+    phase: () => lifecyclePhase
+  };
+};
+
+// src/mobile/navigationState.ts
+var CONTROL_SELECTOR = 'input, textarea, select, details, [contenteditable="true"]';
+var FOCUS_SELECTOR = '[data-absolute-navigation-focus], button, a[href], input, textarea, select, [tabindex]:not([tabindex="-1"])';
+var SCROLL_SELECTOR = "[data-absolute-app-main], [data-absolute-scroll-restoration]";
+var SENSITIVE_AUTOCOMPLETE = new Set([
+  "cc-csc",
+  "cc-number",
+  "current-password",
+  "new-password",
+  "one-time-code"
+]);
+var locatorFor = (element, elements) => {
+  if (element.id)
+    return { kind: "id", value: element.id };
+  const name = element.getAttribute("name");
+  if (name) {
+    const matching = elements.filter((candidate) => candidate.getAttribute("name") === name);
+    return { index: matching.indexOf(element), kind: "name", value: name };
+  }
+  return { index: elements.indexOf(element), kind: "index" };
+};
+var resolveLocator = (locator, selector) => {
+  if (locator.kind === "id") {
+    return document.getElementById(locator.value) ?? undefined;
+  }
+  if (locator.kind === "name") {
+    return [...document.querySelectorAll(selector)].filter((element) => element.getAttribute("name") === locator.value)[locator.index];
+  }
+  return document.querySelectorAll(selector)[locator.index];
+};
+var shouldCaptureControl = (element) => {
+  if (element.closest('[data-absolute-navigation-preserve="off"]'))
+    return false;
+  if (!(element instanceof HTMLInputElement))
+    return true;
+  if (element.type === "file" || element.type === "hidden" || element.type === "password")
+    return false;
+  return !SENSITIVE_AUTOCOMPLETE.has(element.autocomplete.toLowerCase());
+};
+var captureControl = (element, locator) => {
+  const snapshot = {
+    locator,
+    tag: element.tagName.toLowerCase()
+  };
+  if (element instanceof HTMLInputElement) {
+    if (element.type === "checkbox" || element.type === "radio") {
+      snapshot.checked = element.checked;
+    } else {
+      snapshot.value = element.value;
+      if (element.selectionStart !== null)
+        snapshot.selectionStart = element.selectionStart;
+      if (element.selectionEnd !== null)
+        snapshot.selectionEnd = element.selectionEnd;
+    }
+  } else if (element instanceof HTMLTextAreaElement) {
+    snapshot.value = element.value;
+    snapshot.selectionStart = element.selectionStart;
+    snapshot.selectionEnd = element.selectionEnd;
+  } else if (element instanceof HTMLSelectElement) {
+    snapshot.values = [...element.selectedOptions].map(({ value }) => value);
+  } else if (element instanceof HTMLDetailsElement) {
+    snapshot.open = element.open;
+  } else if (element.getAttribute("contenteditable") === "true") {
+    snapshot.value = element.textContent ?? "";
+  }
+  return snapshot;
+};
+var restoreControl = (snapshot) => {
+  const element = resolveLocator(snapshot.locator, CONTROL_SELECTOR);
+  if (!element || element.tagName.toLowerCase() !== snapshot.tag)
+    return;
+  if (element instanceof HTMLInputElement) {
+    if (snapshot.checked !== undefined)
+      element.checked = snapshot.checked;
+    else if (snapshot.value !== undefined)
+      element.value = snapshot.value;
+    if (snapshot.selectionStart !== undefined && snapshot.selectionEnd !== undefined) {
+      try {
+        element.setSelectionRange(snapshot.selectionStart, snapshot.selectionEnd);
+      } catch {}
+    }
+  } else if (element instanceof HTMLTextAreaElement) {
+    if (snapshot.value !== undefined)
+      element.value = snapshot.value;
+    if (snapshot.selectionStart !== undefined && snapshot.selectionEnd !== undefined)
+      element.setSelectionRange(snapshot.selectionStart, snapshot.selectionEnd);
+  } else if (element instanceof HTMLSelectElement && snapshot.values) {
+    for (const option of element.options) {
+      option.selected = snapshot.values.includes(option.value);
+    }
+  } else if (element instanceof HTMLDetailsElement && snapshot.open !== undefined) {
+    element.open = snapshot.open;
+  } else if (element.getAttribute("contenteditable") === "true" && snapshot.value !== undefined) {
+    element.textContent = snapshot.value;
+  }
+};
+var focusElement = (element) => {
+  if (!(element instanceof HTMLElement))
+    return false;
+  if (!element.matches(FOCUS_SELECTOR))
+    element.tabIndex = -1;
+  element.focus({ preventScroll: true });
+  return document.activeElement === element;
+};
+var createAbsoluteMobileHistoryEntry = (path, index, entryId = crypto.randomUUID()) => ({
+  absoluteMobile: true,
+  entryId,
+  index,
+  path
+});
+var readAbsoluteMobileHistoryEntry = (value) => {
+  if (typeof value !== "object" || value === null)
+    return;
+  if (Reflect.get(value, "absoluteMobile") !== true || typeof Reflect.get(value, "entryId") !== "string" || !Number.isSafeInteger(Reflect.get(value, "index")) || typeof Reflect.get(value, "path") !== "string")
+    return;
+  return {
+    absoluteMobile: true,
+    entryId: Reflect.get(value, "entryId"),
+    index: Reflect.get(value, "index"),
+    path: Reflect.get(value, "path")
+  };
+};
+var captureAbsoluteMobileDocumentState = () => {
+  const controls = [
+    ...document.querySelectorAll(CONTROL_SELECTOR)
+  ].filter(shouldCaptureControl);
+  const focusable = [...document.querySelectorAll(FOCUS_SELECTOR)];
+  const scrollable = [...document.querySelectorAll(SCROLL_SELECTOR)];
+  const active = document.activeElement;
+  return {
+    controls: controls.map((element) => captureControl(element, locatorFor(element, controls))),
+    ...active instanceof Element && focusable.includes(active) ? { focus: locatorFor(active, focusable) } : {},
+    scroll: scrollable.map((element) => ({
+      left: element.scrollLeft,
+      locator: locatorFor(element, scrollable),
+      top: element.scrollTop
+    })),
+    window: { x: window.scrollX, y: window.scrollY }
+  };
+};
+var restoreAbsoluteMobileDocumentState = (snapshot) => {
+  for (const control of snapshot.controls)
+    restoreControl(control);
+  const focus = snapshot.focus ? resolveLocator(snapshot.focus, FOCUS_SELECTOR) : undefined;
+  focusElement(focus);
+  for (const scroll of snapshot.scroll) {
+    const element = resolveLocator(scroll.locator, SCROLL_SELECTOR);
+    if (element)
+      element.scrollTo(scroll.left, scroll.top);
+  }
+  window.scrollTo(snapshot.window.x, snapshot.window.y);
+};
+var resetAbsoluteMobileDocumentState = () => {
+  for (const element of document.querySelectorAll(SCROLL_SELECTOR)) {
+    element.scrollTo(0, 0);
+  }
+  window.scrollTo(0, 0);
+  const autofocus = document.querySelector("[autofocus]");
+  if (autofocus && focusElement(autofocus))
+    return;
+  const target = ["[data-absolute-navigation-focus]", "main h1", "h1", "main"].map((selector) => document.querySelector(selector)).find((element) => element !== null);
+  focusElement(target ?? undefined);
+};
+
 // src/mobile/shellBootstrap.ts
 var MANIFEST_PATH = "./absolute-mobile-manifest.json";
 var STATUS_ID = "absolute-mobile-status";
+var NAVIGATION_ERROR_ID = "absolute-mobile-navigation-error";
 var initialNavigationPath = (entry) => {
   const expoPath = new URLSearchParams(location.search).get("absolutePath");
   if (expoPath?.startsWith("/") && !expoPath.startsWith("//"))
@@ -898,20 +1420,19 @@ var currentNavigationPath = () => {
   const expoPath = new URLSearchParams(location.search).get("absolutePath");
   return expoPath?.startsWith("/") && !expoPath.startsWith("//") ? expoPath : `${location.pathname}${location.search}${location.hash}`;
 };
-var pushNavigationHistory = (path) => {
+var historyUrl = (path) => {
   if (!Reflect.get(globalThis, "__absoluteExpoBridge")) {
-    history.pushState({ absoluteMobile: true }, "", path);
-    return;
+    return path;
   }
   const url = new URL(location.href);
   url.search = "";
   url.hash = "";
   url.searchParams.set("absolutePath", path);
-  history.pushState({ absoluteMobile: true }, "", url.href);
-  const bridge = Reflect.get(globalThis, "__absoluteExpoBridge");
-  if (typeof bridge === "object" && bridge !== null && typeof Reflect.get(bridge, "setPath") === "function") {
-    Reflect.get(bridge, "setPath").call(bridge, path);
-  }
+  return url.href;
+};
+var writeNavigationHistory = (entry, mode) => {
+  history[mode === "push" ? "pushState" : "replaceState"](entry, "", historyUrl(entry.path));
+  notifyExpoNavigationPath(entry.path);
 };
 var notifyExpoNavigationPath = (path) => {
   const bridge = Reflect.get(globalThis, "__absoluteExpoBridge");
@@ -921,6 +1442,7 @@ var notifyExpoNavigationPath = (path) => {
 };
 var navigationGeneration = 0;
 var adaptiveShell;
+var uiPrimitives;
 var notifyCapacitorSystemBarsDomReady = () => {
   const provider = Reflect.get(globalThis, "CapacitorSystemBarsAndroidInterface");
   if (typeof provider !== "object" || provider === null)
@@ -949,6 +1471,34 @@ var renderStatus = (message, kind = "loading") => {
     status.textContent = message;
   adaptiveShell?.refreshDocument();
 };
+var clearNavigationFailure = () => {
+  document.getElementById(NAVIGATION_ERROR_ID)?.remove();
+};
+var renderNavigationFailure = (message, retry) => {
+  clearNavigationFailure();
+  const error = document.createElement("aside");
+  error.id = NAVIGATION_ERROR_ID;
+  error.dataset.absoluteMobileNavigationError = "";
+  error.setAttribute("role", "alert");
+  error.style.cssText = "position:fixed;z-index:2147483646;inset:auto max(1rem,var(--absolute-safe-area-inset-right,0px)) max(1rem,var(--absolute-safe-area-inset-bottom,0px)) max(1rem,var(--absolute-safe-area-inset-left,0px));display:flex;align-items:center;justify-content:space-between;gap:1rem;box-sizing:border-box;padding:.75rem 1rem;border:1px solid color-mix(in srgb,CanvasText 24%,transparent);border-radius:.75rem;background:Canvas;color:CanvasText;box-shadow:0 .5rem 2rem color-mix(in srgb,CanvasText 20%,transparent)";
+  const text = document.createElement("span");
+  text.textContent = message;
+  const button = document.createElement("button");
+  button.type = "button";
+  button.textContent = "Retry";
+  button.addEventListener("click", retry, { once: true });
+  error.append(text, button);
+  document.body.append(error);
+};
+var markNavigationPending = (pending) => {
+  if (pending) {
+    document.body.dataset.absoluteMobileNavigationPending = "";
+    document.body.setAttribute("aria-busy", "true");
+  } else {
+    delete document.body.dataset.absoluteMobileNavigationPending;
+    document.body.removeAttribute("aria-busy");
+  }
+};
 var renderPageTarget = () => {
   document.title = "AbsoluteJS";
   document.head.innerHTML = '<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover">';
@@ -974,47 +1524,89 @@ var installLocalPageStyle = (manifest, pageId, contract) => {
   link.dataset.absoluteMobilePageStyle = page.bundleHash;
   document.head.appendChild(link);
 };
-var navigate = async (manifest, path, pushHistory, fetchImpl) => {
-  await disposeAbsoluteMobilePage();
-  renderStatus("Loading…");
-  const envelope = await fetchAbsoluteMobilePage(manifest, path, {
-    ...fetchImpl ? { fetch: fetchImpl } : {}
-  });
-  const activation = await activateAbsoluteMobilePage(envelope, {
-    loadPage: ({ contract, pageId }) => {
-      const page = manifest.pages.find((candidate) => candidate.pageId === pageId && candidate.contract === contract);
-      if (!page) {
-        throw new TypeError(`The embedded app does not contain ${pageId} contract ${contract}.`);
-      }
-      if (page.framework === "html" || page.framework === "htmx") {
-        return installAbsoluteMobileStaticDocument(manifest, page, localBundleUrl(manifest, pageId, contract));
+var waitForDocumentPaint = () => new Promise((resolve) => {
+  if (typeof requestAnimationFrame !== "function") {
+    setTimeout(resolve, 0);
+    return;
+  }
+  requestAnimationFrame(() => requestAnimationFrame(() => resolve()));
+});
+var commitNavigation = async (manifest, envelope, hadActivePage) => {
+  if (!hadActivePage)
+    renderStatus("Loading…");
+  let activation;
+  const commit = async () => {
+    await disposeAbsoluteMobilePage();
+    activation = await activateAbsoluteMobilePage(envelope, {
+      loadPage: ({ contract, pageId }) => {
+        const page = manifest.pages.find((candidate) => candidate.pageId === pageId && candidate.contract === contract);
+        if (!page) {
+          throw new TypeError(`The embedded app does not contain ${pageId} contract ${contract}.`);
+        }
+        if (page.framework === "html" || page.framework === "htmx") {
+          return installAbsoluteMobileStaticDocument(manifest, page, localBundleUrl(manifest, pageId, contract));
+        }
+        renderPageTarget();
+        installLocalPageStyle(manifest, pageId, contract);
+        return import(localBundleUrl(manifest, pageId, contract));
       }
-      renderPageTarget();
-      installLocalPageStyle(manifest, pageId, contract);
-      return import(localBundleUrl(manifest, pageId, contract));
-    }
-  });
+    });
+  };
+  const transitionDocument = document;
+  if (hadActivePage && document.documentElement.dataset.absoluteReducedMotion !== "reduce" && transitionDocument.startViewTransition) {
+    const transition = transitionDocument.startViewTransition(commit);
+    await transition.updateCallbackDone;
+    await transition.finished.catch(() => {
+      return;
+    });
+  } else
+    await commit();
+  if (!activation)
+    throw new TypeError("The mobile page did not produce an activation.");
   if (activation.kind === "upgrade-required") {
     renderStatus("This app version must be updated to continue.", "update");
-    return;
+    return false;
   }
+  await waitForDocumentPaint();
+  document.body.dataset.absoluteMobilePageActive = "";
   adaptiveShell?.refreshDocument();
-  if (pushHistory)
-    pushNavigationHistory(path);
+  return true;
 };
-var installAnchorNavigation = (manifest, onNavigate) => {
+var openExternalLink = (anchor, event) => {
+  if (Reflect.get(globalThis, "__absoluteExpoBridge"))
+    return;
+  try {
+    const url = new URL(anchor.href);
+    if (url.username || url.password || url.protocol !== "http:" && url.protocol !== "https:")
+      return;
+    event.preventDefault();
+    Browser.open({ url: url.href }).catch(() => location.assign(url.href));
+  } catch {}
+};
+var installAnchorNavigation = (manifest, onNavigate, onBack) => {
   const handleClick = (event) => {
     if (!(event.target instanceof Element))
       return;
     const anchor = event.target.closest("a[href]");
     if (!(anchor instanceof HTMLAnchorElement) || anchor.target)
       return;
+    const intent = readAbsoluteMobileLinkIntent(anchor);
+    if (intent.kind === "back") {
+      event.preventDefault();
+      if (!uiPrimitives?.requestBack() && !onBack())
+        history.back();
+      return;
+    }
+    if (intent.kind === "external") {
+      openExternalLink(anchor, event);
+      return;
+    }
     try {
       const path = resolveAbsoluteMobileNavigation(manifest, anchor.href, location.origin);
       if (!path)
         return;
       event.preventDefault();
-      onNavigate(path);
+      onNavigate(path, intent.kind === "navigate" && intent.replace ? "replace" : "forward", intent.kind === "navigate" && intent.replace);
     } catch {}
   };
   addEventListener("click", handleClick);
@@ -1041,21 +1633,19 @@ var installDeepLinks = async (manifest, onNavigate, authRedirectUri) => {
   } catch {}
   return listener;
 };
-var navigateWithFailureState = async (manifest, path, pushHistory, reinstallBrowserNavigation, fetchImpl) => {
-  try {
-    await navigate(manifest, path, pushHistory, fetchImpl);
-  } catch (error) {
-    console.error("[Absolute Mobile] Navigation failed:", error);
-    renderStatus(document.documentElement.dataset.absoluteNetwork === "offline" ? "You are offline. Reconnect to load this page." : "Unable to load this page. Check your connection and retry.", "error");
-  } finally {
-    reinstallBrowserNavigation();
-  }
-};
 var startAbsoluteMobileShell = async (options = {}) => {
   notifyCapacitorSystemBarsDomReady();
   await adaptiveShell?.dispose();
+  uiPrimitives?.dispose();
   adaptiveShell = await installAbsoluteMobileAdaptiveShell();
+  uiPrimitives = installAbsoluteMobileUiPrimitives();
   const manifest = await readManifest();
+  let activePath = initialNavigationPath(manifest.entry);
+  let activeEntry = readAbsoluteMobileHistoryEntry(history.state) ?? createAbsoluteMobileHistoryEntry(activePath, 0);
+  if (activeEntry.path !== activePath) {
+    activeEntry = createAbsoluteMobileHistoryEntry(activePath, 0);
+  }
+  writeNavigationHistory(activeEntry, "replace");
   const auth = manifest.auth && options.createAuth ? await options.createAuth(manifest.auth, {
     beforeSignOut: options.beforeSignOut
   }) : undefined;
@@ -1065,25 +1655,144 @@ var startAbsoluteMobileShell = async (options = {}) => {
     options.connectPush?.(auth);
   if (auth && manifest.sync?.socketTickets)
     options.installSync?.(auth, manifest.sync);
+  const snapshots = new Map;
+  const targetEntries = new WeakMap;
+  let suppressNextPop = false;
+  let hasActivePage = false;
   let removeAnchorNavigation = () => {
     return;
   };
-  const handlePopState = () => {
+  const coordinator = createAbsoluteMobileNavigationCoordinator({
+    commit: async (envelope, request) => {
+      if (hasActivePage) {
+        snapshots.set(activeEntry.entryId, captureAbsoluteMobileDocumentState());
+      }
+      document.documentElement.dataset.absoluteNavigationDirection = request.direction;
+      try {
+        const previouslyActive = hasActivePage;
+        hasActivePage = false;
+        hasActivePage = await commitNavigation(manifest, envelope, previouslyActive);
+      } finally {
+        reinstallBrowserNavigation();
+      }
+    },
+    load: (request, signal) => fetchAbsoluteMobilePage(manifest, request.path, {
+      fetch: applicationFetch,
+      signal
+    }),
+    onFailure: (error, phase, request) => {
+      console.error("[Absolute Mobile] Navigation failed:", error);
+      markNavigationPending(false);
+      const targetEntry = targetEntries.get(request);
+      if (targetEntry && targetEntry.index !== activeEntry.index) {
+        suppressNextPop = true;
+        history.go(activeEntry.index - targetEntry.index);
+      }
+      const message = document.documentElement.dataset.absoluteNetwork === "offline" ? "You are offline. Reconnect to load this page." : "Unable to load this page. Check your connection and retry.";
+      if (phase === "load" && hasActivePage) {
+        renderNavigationFailure(message, () => {
+          if (targetEntry) {
+            history.go(targetEntry.index - activeEntry.index);
+          } else
+            coordinator.navigate(request);
+        });
+      } else
+        renderStatus(message, "error");
+    },
+    onStart: () => {
+      clearNavigationFailure();
+      markNavigationPending(true);
+    },
+    onSuccess: (request) => {
+      let nextEntry = targetEntries.get(request);
+      if (request.historyMode === "push") {
+        nextEntry = createAbsoluteMobileHistoryEntry(request.path, activeEntry.index + 1);
+        writeNavigationHistory(nextEntry, "push");
+      } else if (request.historyMode === "replace") {
+        nextEntry = createAbsoluteMobileHistoryEntry(request.path, activeEntry.index);
+        writeNavigationHistory(nextEntry, "replace");
+      }
+      nextEntry ??= activeEntry;
+      activeEntry = nextEntry;
+      activePath = request.path;
+      markNavigationPending(false);
+      clearNavigationFailure();
+      const snapshot = snapshots.get(activeEntry.entryId);
+      if (snapshot)
+        restoreAbsoluteMobileDocumentState(snapshot);
+      else if (request.historyMode !== "none")
+        resetAbsoluteMobileDocumentState();
+      uiPrimitives?.navigate({
+        direction: request.direction,
+        from: request.from,
+        to: request.path
+      });
+    }
+  });
+  const cancelPendingNavigation = () => {
+    if (!coordinator.cancelPending())
+      return false;
+    markNavigationPending(false);
+    clearNavigationFailure();
+    return true;
+  };
+  const handlePopState = (event) => {
     const path = currentNavigationPath();
+    if (suppressNextPop) {
+      suppressNextPop = false;
+      notifyExpoNavigationPath(activePath);
+      return;
+    }
+    const targetEntry = readAbsoluteMobileHistoryEntry(event.state) ?? createAbsoluteMobileHistoryEntry(path, activeEntry.index - 1);
     notifyExpoNavigationPath(path);
-    navigateWithFailureState(manifest, path, false, reinstallBrowserNavigation, applicationFetch);
+    const request = {
+      direction: targetEntry.index > activeEntry.index ? "forward" : "back",
+      from: activePath,
+      historyMode: "none",
+      path
+    };
+    targetEntries.set(request, targetEntry);
+    coordinator.navigate(request);
   };
   const reinstallBrowserNavigation = () => {
     removeAnchorNavigation();
     removeEventListener("popstate", handlePopState);
-    removeAnchorNavigation = installAnchorNavigation(manifest, onNavigate);
+    uiPrimitives?.dispose();
+    uiPrimitives = installAbsoluteMobileUiPrimitives();
+    uiPrimitives.refreshDocument(activePath);
+    removeAnchorNavigation = installAnchorNavigation(manifest, onNavigate, cancelPendingNavigation);
     addEventListener("popstate", handlePopState);
   };
-  const onNavigate = (path) => {
-    navigateWithFailureState(manifest, path, true, reinstallBrowserNavigation, applicationFetch);
+  const onNavigate = (path, direction = "forward", replace = false) => {
+    if (path === activePath && !replace && hasActivePage)
+      return;
+    coordinator.navigate({
+      direction,
+      from: activePath,
+      historyMode: replace ? "replace" : "push",
+      path
+    });
   };
-  await navigateWithFailureState(manifest, initialNavigationPath(manifest.entry), false, reinstallBrowserNavigation, applicationFetch);
+  reinstallBrowserNavigation();
+  await coordinator.navigate({
+    direction: "replace",
+    from: activePath,
+    historyMode: "none",
+    path: activePath
+  });
   await installDeepLinks(manifest, onNavigate, auth?.redirectUri);
+  try {
+    await App.addListener("backButton", ({ canGoBack }) => {
+      if (uiPrimitives?.requestBack())
+        return;
+      if (cancelPendingNavigation())
+        return;
+      if (canGoBack)
+        history.back();
+      else
+        App.exitApp();
+    });
+  } catch {}
 };
 export {
   startAbsoluteMobileShell