mobux 0.26.3

// external-link.js — open a URL outside the app shell, not inside it.
//
// In a TWA (Trusted Web Activity, package id `io.github.mvhenten.mobux`),
// a link to another origin would otherwise open inside the installed app
// shell (or a Chrome Custom Tab that looks like it). External links should
// leave the shell and open in the user's system default browser (Firefox,
// Chrome, whatever they configured). Android's intent:// URL scheme with
// action=VIEW and no package= attribute forces the system to resolve
// through the default browser.
//
// TWA detection: document.referrer starts with 'android-app://' when
// running inside the TWA shell.
//
// On desktop / regular browsers, this uses the standard anchor-click
// new-tab behavior.
//
// One external-open path for the whole app, across both frontends: the
// classic terminal (tapped URLs in the buffer, mic-overlay's report link,
// xterm's own link clicks) and the Preact SPA (any rendered anchor to
// another origin). `installExternalLinkHandler` wires a single delegated
// click handler so every SPA anchor to a non-mobux origin escapes the
// shell without each call site having to opt in.

// Helper for navigation - exposed for test stubbing via
// window.__mobuxNavigateToUrl (see terminal.js).
export function navigateToUrl(url) {
  window.location.assign(url);
}

// True when `url` resolves to an origin other than the page's own — i.e. a
// link that should leave the app shell. Relative and same-origin URLs
// (in-app navigation, `/settings`, download links under `/install/…`) stay
// in-shell. Only http(s) is treated as external here; mailto:/tel:/intent:
// and other schemes are left to the platform's own handling.
export function isExternalUrl(url) {
  try {
    const u = new URL(url, window.location.href);
    if (u.protocol !== 'http:' && u.protocol !== 'https:') return false;
    return u.origin !== window.location.origin;
  } catch (_) {
    return false;
  }
}

export function openExternal(url) {
  const isTWA = document.referrer.startsWith('android-app://');

  if (isTWA && /^https?:\/\//.test(url)) {
    // Build an intent:// URL that opens the link in the system default
    // browser. Format:
    // intent://<url>#Intent;action=android.intent.action.VIEW;scheme=<scheme>;S.browser_fallback_url=<url>;end;
    const urlObj = new URL(url);
    const intentUrl = `intent://${urlObj.host}${urlObj.pathname}${urlObj.search}${urlObj.hash}#Intent;action=android.intent.action.VIEW;scheme=${urlObj.protocol.replace(':', '')};S.browser_fallback_url=${encodeURIComponent(url)};end;`;
    // window.__mobuxNavigateToUrl is the test stub seam; fall back to the
    // real navigate so this module works standalone in the SPA too.
    const navigate = window.__mobuxNavigateToUrl || navigateToUrl;
    navigate(intentUrl);
    return;
  }

  // Non-TWA or non-http(s) URLs: use anchor-click fallback. Tagged so
  // `installExternalLinkHandler`'s delegated capture listener recognizes
  // this as its OWN synthetic anchor and lets the click through, instead of
  // treating it as a fresh external link to intercept. Without the tag,
  // that listener would preventDefault() this click and call openExternal()
  // again on the anchor it just made — which creates another untagged
  // anchor, which the listener intercepts again, forever: unbounded
  // recursion until the call stack overflows. Reachable from any external
  // anchor click anywhere in the app, since the delegated listener runs in
  // the capture phase, ahead of the anchor's own listeners — which is also
  // why a target/bubble-phase click handler on a real external anchor
  // (e.g. one that calls openExternal itself, wanting the TWA-safe path)
  // is redundant: the delegated listener has already called openExternal
  // once by the time that handler runs, and a second independent call
  // double-opens the link. Callers should let the delegated listener do
  // the routing rather than wiring their own.
  const a = document.createElement('a');
  a.href = url;
  a.target = '_blank';
  a.rel = 'noopener noreferrer';
  a.style.display = 'none';
  a.dataset.mobuxExternal = '1';
  document.body.appendChild(a);
  a.click();
  a.remove();
}

// Delegated, capture-phase click handler: any left-click on an anchor whose
// href points to another origin is routed through openExternal (system
// browser in the TWA, new tab elsewhere) instead of navigating the shell.
// Idempotent across both frontends via a window flag — the classic engine
// and the SPA both call it, but only the first install takes effect.
export function installExternalLinkHandler(target) {
  if (window.__mobuxExternalLinkHandlerInstalled) return;
  window.__mobuxExternalLinkHandlerInstalled = true;

  (target || document).addEventListener(
    'click',
    (e) => {
      // Modified clicks (new tab/window) and downloads keep the browser's
      // own default behavior. `e.defaultPrevented` here can only reflect a
      // listener that already ran earlier in the *capture* phase (e.g. on
      // `window`, or another document-level capture listener registered
      // before this one) — a listener on the anchor itself fires later
      // (deeper in capture, or during bubble), so this isn't a general
      // "handled elsewhere" guard.
      if (
        e.defaultPrevented ||
        e.button !== 0 ||
        e.metaKey ||
        e.ctrlKey ||
        e.shiftKey ||
        e.altKey
      )
        return;
      const anchor = e.target.closest && e.target.closest('a[href]');
      if (!anchor) return;
      // openExternal's own synthetic anchor, clicking itself — let it
      // through untouched. Re-intercepting it (this handler runs in the
      // capture phase, ahead of the anchor's own click-to-navigate) would
      // call openExternal() again on the anchor it just made, recursing
      // without bound.
      if (anchor.dataset.mobuxExternal) return;
      if (anchor.hasAttribute('download')) return;
      const href = anchor.getAttribute('href');
      if (!href || !isExternalUrl(href)) return;
      e.preventDefault();
      openExternal(anchor.href);
    },
    true,
  );
}