waybetter 0.1.0

package/dist/runtime/netHub.js

@@ -0,0 +1,268 @@
+// One shared fetch/XHR hook per window for everything a site runtime does with the site's own
+// requests: URL rewrites, gates (e.g. serializing racing mutations) and passive JSON taps. Each
+// feature registers a stage instead of stacking its own wrapper. A request whose URL contains none
+// of the site's API marks (images, video, WASM, scripts, telemetry) takes one substring check and
+// goes straight to the wrapped fetch, and a tapped response is cloned, read and JSON-parsed once for
+// all taps. Semantics are unchanged: the page gets the very promise (and Response) the inner fetch
+// returned unless a gate answers a request itself, rejections and aborts pass through, and nothing
+// here ever issues a request of its own.
+const config = { apiMarks: [], xhrMarks: [] };
+const hubs = new WeakMap();
+/** Set once by the site adapter, before stages register. */
+export function configureNetHub(next) {
+    if (next.apiMarks)
+        config.apiMarks = [...next.apiMarks];
+    if (next.xhrMarks)
+        config.xhrMarks = [...next.xhrMarks];
+}
+const hasMark = (url, marks) => {
+    for (const mark of marks)
+        if (url.includes(mark))
+            return true;
+    return false;
+};
+/** Whether `url` is one of the site's API calls (plain substring checks, no URL parsing). */
+export function isApiUrl(url) {
+    return hasMark(url, config.apiMarks);
+}
+/** The request URL as given (string, URL or Request), without parsing it. */
+export function rawUrl(input) {
+    try {
+        if (typeof input === 'string')
+            return input;
+        if (input instanceof URL)
+            return input.href;
+        if (input && typeof input.url === 'string')
+            return input.url;
+    }
+    catch { /* ignore */ }
+    return '';
+}
+function hubFor(target) {
+    const existing = hubs.get(target);
+    if (existing)
+        return existing;
+    let inner = null;
+    let wrapper = null;
+    const proto = target.XMLHttpRequest?.prototype;
+    let originalOpen;
+    let openWrapper;
+    let originalSend;
+    let sendWrapper;
+    const opened = new WeakMap();
+    const later = (run) => {
+        // Parsing a large body is the expensive part; keep it out of the page's own response handling.
+        const idle = target.requestIdleCallback;
+        if (typeof idle === 'function') {
+            try {
+                idle.call(target, run, { timeout: 200 });
+                return;
+            }
+            catch { /* fall through */ }
+        }
+        run();
+    };
+    const deliver = (taps, text) => {
+        const live = taps.filter(tap => hub.taps.includes(tap) && text.length <= tap.maxBytes);
+        if (!live.length)
+            return;
+        later(() => {
+            let body;
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                return;
+            }
+            for (const tap of live) {
+                if (!hub.taps.includes(tap))
+                    continue;
+                try {
+                    tap.onJson(body);
+                }
+                catch { /* A consumer failure never reaches the page. */ }
+            }
+        });
+    };
+    const matchingTaps = (url) => hub.taps.length ? hub.taps.filter(tap => { try {
+        return tap.match(url);
+    }
+    catch {
+        return false;
+    } }) : [];
+    const fetchWrapper = function (...args) {
+        const url = rawUrl(args[0]);
+        if (!hasMark(url, config.apiMarks))
+            return Reflect.apply(inner, this, args);
+        let [input, init] = args;
+        for (const rewrite of hub.rewrites) {
+            const next = rewrite(input, init);
+            if (next != null)
+                input = next;
+        }
+        const call = input === args[0] ? args : [input, init];
+        const send = () => Reflect.apply(inner, this, call);
+        let result = null;
+        for (const gate of hub.gates) {
+            result = gate(input, init, send);
+            if (result)
+                break;
+        }
+        result ??= send();
+        const taps = matchingTaps(rawUrl(input));
+        if (taps.length) {
+            result.then(response => {
+                if (!response.ok)
+                    return;
+                const length = Number(response.headers.get('content-length') ?? 0);
+                if (!taps.some(tap => hub.taps.includes(tap) && length <= tap.maxBytes))
+                    return;
+                return response.clone().text().then(text => deliver(taps, text));
+            }).catch(() => { });
+        }
+        return result;
+    };
+    const onLoad = function (taps) {
+        try {
+            if (this.status < 200 || this.status >= 300)
+                return;
+            if (this.responseType === '' || this.responseType === 'text')
+                deliver(taps, this.responseText);
+            else if (this.responseType === 'json' && this.response) {
+                const body = this.response;
+                for (const tap of taps)
+                    if (hub.taps.includes(tap)) {
+                        try {
+                            tap.onJson(body);
+                        }
+                        catch { /* ignore */ }
+                    }
+            }
+        }
+        catch { /* ignore */ }
+    };
+    const install = () => {
+        if (!wrapper && (hub.rewrites.length || hub.gates.length || hub.taps.length)) {
+            inner = target.fetch;
+            try {
+                target.fetch = fetchWrapper;
+                wrapper = fetchWrapper;
+            }
+            catch { /* Readonly runtime. */ }
+        }
+        if (!proto)
+            return;
+        if (!openWrapper && (hub.taps.length || hub.xhrGates.length)) {
+            const open = originalOpen = proto.open;
+            const candidate = function (...args) {
+                try {
+                    let url = String(args[1]);
+                    if (hub.xhrGates.length) {
+                        const method = String(args[0]).toUpperCase();
+                        for (const gate of hub.xhrGates) {
+                            const next = gate.open?.(this, { method, url });
+                            if (typeof next === 'string') {
+                                url = next;
+                                args = [args[0], next, ...args.slice(2)];
+                            }
+                        }
+                        opened.set(this, { method, url });
+                    }
+                    else
+                        opened.delete(this);
+                    if (hasMark(url, config.apiMarks)) {
+                        const taps = matchingTaps(url);
+                        if (taps.length)
+                            this.addEventListener('load', function () { onLoad.call(this, taps); }, { once: true });
+                    }
+                }
+                catch { /* ignore */ }
+                return Reflect.apply(open, this, args);
+            };
+            try {
+                proto.open = candidate;
+                openWrapper = candidate;
+            }
+            catch { /* ignore */ }
+        }
+        if (!sendWrapper && hub.xhrGates.length) {
+            const send = originalSend = proto.send;
+            const candidate = function (...args) {
+                const request = opened.get(this);
+                if (request && (hasMark(request.url, config.apiMarks) || hasMark(request.url, config.xhrMarks))) {
+                    const sendNative = (...body) => { Reflect.apply(send, this, body.length ? body : args); };
+                    for (const gate of hub.xhrGates)
+                        if (gate.send(this, request, args[0], sendNative))
+                            return;
+                }
+                return Reflect.apply(send, this, args);
+            };
+            try {
+                proto.send = candidate;
+                sendWrapper = candidate;
+            }
+            catch { /* ignore */ }
+        }
+    };
+    const uninstall = () => {
+        // Anyone still holding a wrapper (another script wrapped on top) gets plain pass-through.
+        if (proto && openWrapper && !hub.taps.length && !hub.xhrGates.length && proto.open === openWrapper) {
+            proto.open = originalOpen;
+            openWrapper = undefined;
+        }
+        if (proto && sendWrapper && !hub.xhrGates.length && proto.send === sendWrapper) {
+            proto.send = originalSend;
+            sendWrapper = undefined;
+        }
+        if (!hub.rewrites.length && !hub.gates.length && !hub.taps.length && wrapper) {
+            if (target.fetch === wrapper) {
+                target.fetch = inner;
+                wrapper = null;
+            }
+        }
+    };
+    const hub = {
+        rewrites: [],
+        gates: [],
+        taps: [],
+        xhrGates: [],
+        hooked: () => wrapper !== null && target.fetch === wrapper,
+        add(list, item) {
+            list.push(item);
+            install();
+            let removed = false;
+            return () => {
+                if (removed)
+                    return;
+                removed = true;
+                const index = list.indexOf(item);
+                if (index >= 0)
+                    list.splice(index, 1);
+                uninstall();
+            };
+        },
+    };
+    hubs.set(target, hub);
+    return hub;
+}
+/** Whether the shared hook is installed as `target.fetch` (for callers that report `installed`). */
+export function fetchHooked(target) {
+    return hubs.get(target)?.hooked() ?? false;
+}
+export function addRewrite(target, rewrite) {
+    const hub = hubFor(target);
+    return hub.add(hub.rewrites, rewrite);
+}
+export function addGate(target, gate) {
+    const hub = hubFor(target);
+    return hub.add(hub.gates, gate);
+}
+export function addTap(target, tap) {
+    const hub = hubFor(target);
+    return hub.add(hub.taps, tap);
+}
+export function addXhrGate(target, gate) {
+    const hub = hubFor(target);
+    return hub.add(hub.xhrGates, gate);
+}
+//# sourceMappingURL=netHub.js.map

package/dist/runtime/netHub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"netHub.js","sourceRoot":"","sources":["../../../runtime/src/netHub.ts"],"names":[],"mappings":"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","sourcesContent":["// One shared fetch/XHR hook per window for everything a site runtime does with the site's own\n// requests: URL rewrites, gates (e.g. serializing racing mutations) and passive JSON taps. Each\n// feature registers a stage instead of stacking its own wrapper. A request whose URL contains none\n// of the site's API marks (images, video, WASM, scripts, telemetry) takes one substring check and\n// goes straight to the wrapped fetch, and a tapped response is cloned, read and JSON-parsed once for\n// all taps. Semantics are unchanged: the page gets the very promise (and Response) the inner fetch\n// returned unless a gate answers a request itself, rejections and aborts pass through, and nothing\n// here ever issues a request of its own.\n\n/** `input`/`init` are fetch's arguments; returns the rewritten URL, or null to leave the request alone. */\nexport type Rewrite = (input: unknown, init: RequestInit | undefined) => string | null;\n/** Returns null when the request is not the gate's; otherwise the promise the page gets instead of `send()`. */\nexport type Gate = (input: unknown, init: RequestInit | undefined, send: () => Promise<Response>) => Promise<Response> | null;\nexport type Tap = { match(url: string): boolean; maxBytes: number; onJson(body: unknown): void };\n/** XHR counterpart of `Gate` (many web clients still send their API calls with XMLHttpRequest). */\nexport type XhrGate = {\n  /**\n   * The page (re)opens this XHR object; called before the native `open`. Returning a string opens\n   * that URL instead (a request rewrite, like `Rewrite` for fetch).\n   */\n  open?(xhr: XMLHttpRequest, request: { method: string; url: string }): string | void;\n  /**\n   * The page calls `send(body)` on an API (or XHR-mark) request. Returns true when the gate took it\n   * over: it then calls `sendNative()` itself (now or later; `sendNative(body)` sends that body\n   * instead of the page's) or completes the XHR on its own.\n   */\n  send(xhr: XMLHttpRequest, request: { method: string; url: string }, body: unknown, sendNative: (...body: [] | [unknown]) => void): boolean;\n};\n\nexport type NetHubConfig = {\n  /** URL substrings of the site's API calls; only these reach rewrites, gates and taps. */\n  apiMarks: string[];\n  /** Extra URL substrings that reach XHR gates only (e.g. a chunked media upload endpoint). */\n  xhrMarks: string[];\n};\n\ntype HubWindow = {\n  fetch: typeof fetch;\n  XMLHttpRequest?: typeof XMLHttpRequest;\n  requestIdleCallback?: (callback: () => void, options?: { timeout: number }) => number;\n};\n\ntype Hub = {\n  rewrites: Rewrite[];\n  gates: Gate[];\n  taps: Tap[];\n  xhrGates: XhrGate[];\n  hooked(): boolean;\n  add<T>(list: T[], item: T): () => void;\n};\n\nconst config: NetHubConfig = { apiMarks: [], xhrMarks: [] };\nconst hubs = new WeakMap<object, Hub>();\n\n/** Set once by the site adapter, before stages register. */\nexport function configureNetHub(next: Partial<NetHubConfig>): void {\n  if (next.apiMarks) config.apiMarks = [...next.apiMarks];\n  if (next.xhrMarks) config.xhrMarks = [...next.xhrMarks];\n}\n\nconst hasMark = (url: string, marks: string[]) => {\n  for (const mark of marks) if (url.includes(mark)) return true;\n  return false;\n};\n\n/** Whether `url` is one of the site's API calls (plain substring checks, no URL parsing). */\nexport function isApiUrl(url: string): boolean {\n  return hasMark(url, config.apiMarks);\n}\n\n/** The request URL as given (string, URL or Request), without parsing it. */\nexport function rawUrl(input: unknown): string {\n  try {\n    if (typeof input === 'string') return input;\n    if (input instanceof URL) return input.href;\n    if (input && typeof (input as Request).url === 'string') return (input as Request).url;\n  } catch { /* ignore */ }\n  return '';\n}\n\nfunction hubFor(target: HubWindow): Hub {\n  const existing = hubs.get(target);\n  if (existing) return existing;\n\n  let inner: typeof fetch | null = null;\n  let wrapper: typeof fetch | null = null;\n  const proto: XMLHttpRequest | undefined = target.XMLHttpRequest?.prototype;\n  let originalOpen: XMLHttpRequest['open'] | undefined;\n  let openWrapper: XMLHttpRequest['open'] | undefined;\n  let originalSend: XMLHttpRequest['send'] | undefined;\n  let sendWrapper: XMLHttpRequest['send'] | undefined;\n  const opened = new WeakMap<XMLHttpRequest, { method: string; url: string }>();\n\n  const later = (run: () => void) => {\n    // Parsing a large body is the expensive part; keep it out of the page's own response handling.\n    const idle = target.requestIdleCallback;\n    if (typeof idle === 'function') { try { idle.call(target, run, { timeout: 200 }); return; } catch { /* fall through */ } }\n    run();\n  };\n  const deliver = (taps: Tap[], text: string) => {\n    const live = taps.filter(tap => hub.taps.includes(tap) && text.length <= tap.maxBytes);\n    if (!live.length) return;\n    later(() => {\n      let body: unknown;\n      try { body = JSON.parse(text); } catch { return; }\n      for (const tap of live) {\n        if (!hub.taps.includes(tap)) continue;\n        try { tap.onJson(body); } catch { /* A consumer failure never reaches the page. */ }\n      }\n    });\n  };\n  const matchingTaps = (url: string) => hub.taps.length ? hub.taps.filter(tap => { try { return tap.match(url); } catch { return false; } }) : [];\n\n  const fetchWrapper = function (this: unknown, ...args: Parameters<typeof fetch>): Promise<Response> {\n    const url = rawUrl(args[0]);\n    if (!hasMark(url, config.apiMarks)) return Reflect.apply(inner!, this, args) as Promise<Response>;\n    let [input, init] = args;\n    for (const rewrite of hub.rewrites) {\n      const next = rewrite(input, init);\n      if (next != null) input = next;\n    }\n    const call = input === args[0] ? args : [input, init] as Parameters<typeof fetch>;\n    const send = () => Reflect.apply(inner!, this, call) as Promise<Response>;\n    let result: Promise<Response> | null = null;\n    for (const gate of hub.gates) {\n      result = gate(input, init, send);\n      if (result) break;\n    }\n    result ??= send();\n    const taps = matchingTaps(rawUrl(input));\n    if (taps.length) {\n      result.then(response => {\n        if (!response.ok) return;\n        const length = Number(response.headers.get('content-length') ?? 0);\n        if (!taps.some(tap => hub.taps.includes(tap) && length <= tap.maxBytes)) return;\n        return response.clone().text().then(text => deliver(taps, text));\n      }).catch(() => {});\n    }\n    return result;\n  };\n\n  const onLoad = function (this: XMLHttpRequest, taps: Tap[]) {\n    try {\n      if (this.status < 200 || this.status >= 300) return;\n      if (this.responseType === '' || this.responseType === 'text') deliver(taps, this.responseText);\n      else if (this.responseType === 'json' && this.response) {\n        const body = this.response;\n        for (const tap of taps) if (hub.taps.includes(tap)) { try { tap.onJson(body); } catch { /* ignore */ } }\n      }\n    } catch { /* ignore */ }\n  };\n\n  const install = () => {\n    if (!wrapper && (hub.rewrites.length || hub.gates.length || hub.taps.length)) {\n      inner = target.fetch;\n      try { target.fetch = fetchWrapper; wrapper = fetchWrapper; } catch { /* Readonly runtime. */ }\n    }\n    if (!proto) return;\n    if (!openWrapper && (hub.taps.length || hub.xhrGates.length)) {\n      const open = originalOpen = proto.open;\n      const candidate = function (this: XMLHttpRequest, ...args: unknown[]) {\n        try {\n          let url = String(args[1]);\n          if (hub.xhrGates.length) {\n            const method = String(args[0]).toUpperCase();\n            for (const gate of hub.xhrGates) {\n              const next = gate.open?.(this, { method, url });\n              if (typeof next === 'string') { url = next; args = [args[0], next, ...args.slice(2)]; }\n            }\n            opened.set(this, { method, url });\n          } else opened.delete(this);\n          if (hasMark(url, config.apiMarks)) {\n            const taps = matchingTaps(url);\n            if (taps.length) this.addEventListener('load', function (this: XMLHttpRequest) { onLoad.call(this, taps); }, { once: true });\n          }\n        } catch { /* ignore */ }\n        return Reflect.apply(open, this, args);\n      } as XMLHttpRequest['open'];\n      try { proto.open = candidate; openWrapper = candidate; } catch { /* ignore */ }\n    }\n    if (!sendWrapper && hub.xhrGates.length) {\n      const send = originalSend = proto.send;\n      const candidate: XMLHttpRequest['send'] = function (this: XMLHttpRequest, ...args) {\n        const request = opened.get(this);\n        if (request && (hasMark(request.url, config.apiMarks) || hasMark(request.url, config.xhrMarks))) {\n          const sendNative = (...body: [] | [unknown]) => { Reflect.apply(send, this, body.length ? body : args); };\n          for (const gate of hub.xhrGates) if (gate.send(this, request, args[0], sendNative)) return;\n        }\n        return Reflect.apply(send, this, args);\n      };\n      try { proto.send = candidate; sendWrapper = candidate; } catch { /* ignore */ }\n    }\n  };\n  const uninstall = () => {\n    // Anyone still holding a wrapper (another script wrapped on top) gets plain pass-through.\n    if (proto && openWrapper && !hub.taps.length && !hub.xhrGates.length && proto.open === openWrapper) {\n      proto.open = originalOpen!;\n      openWrapper = undefined;\n    }\n    if (proto && sendWrapper && !hub.xhrGates.length && proto.send === sendWrapper) {\n      proto.send = originalSend!;\n      sendWrapper = undefined;\n    }\n    if (!hub.rewrites.length && !hub.gates.length && !hub.taps.length && wrapper) {\n      if (target.fetch === wrapper) { target.fetch = inner!; wrapper = null; }\n    }\n  };\n\n  const hub: Hub = {\n    rewrites: [],\n    gates: [],\n    taps: [],\n    xhrGates: [],\n    hooked: () => wrapper !== null && target.fetch === wrapper,\n    add(list, item) {\n      list.push(item);\n      install();\n      let removed = false;\n      return () => {\n        if (removed) return;\n        removed = true;\n        const index = list.indexOf(item);\n        if (index >= 0) list.splice(index, 1);\n        uninstall();\n      };\n    },\n  };\n  hubs.set(target, hub);\n  return hub;\n}\n\n/** Whether the shared hook is installed as `target.fetch` (for callers that report `installed`). */\nexport function fetchHooked(target: HubWindow): boolean {\n  return hubs.get(target)?.hooked() ?? false;\n}\n\nexport function addRewrite(target: HubWindow, rewrite: Rewrite): () => void {\n  const hub = hubFor(target);\n  return hub.add(hub.rewrites, rewrite);\n}\nexport function addGate(target: HubWindow, gate: Gate): () => void {\n  const hub = hubFor(target);\n  return hub.add(hub.gates, gate);\n}\nexport function addTap(target: HubWindow, tap: Tap): () => void {\n  const hub = hubFor(target);\n  return hub.add(hub.taps, tap);\n}\nexport function addXhrGate(target: HubWindow, gate: XhrGate): () => void {\n  const hub = hubFor(target);\n  return hub.add(hub.xhrGates, gate);\n}\n"]}

package/dist/runtime/paneNav.d.ts

@@ -0,0 +1,35 @@
+export type PaneNavHandle = {
+    set(state: unknown): void;
+    setEnabled(enabled: boolean): void;
+    dispose(): void;
+};
+export type RailPaint = {
+    width: number;
+    background: string;
+    line: string;
+    accent: string;
+    rtl: boolean;
+};
+export type RailSite = {
+    /** Prefix of the ids/attributes this module owns (`<prefix>-pane-nav`, `data-<prefix>-pane-nav`, ...). */
+    prefix: string;
+    /** The site's classic rail element. */
+    rail: string;
+    /** A link inside the rail, used to find it when the classic rail element is absent. */
+    anchor: string;
+    /** The content column that re-centers once the rail is parked. */
+    main: string;
+    /** An element whose background is the site accent (for the edge handle), if any. */
+    accentSource?: string;
+    /** Open while a modal sheet is up: the rail never slides in over it. */
+    modalOpen: string;
+    /** One of the site's menus (portalled out of the rail) is open. */
+    menuOpen: string;
+    /** Paint before the page has been read. */
+    paint: RailPaint;
+};
+/** Pure: the stylesheet for a pane whose rail is parked. RTL pages keep the rail on the right. */
+export declare function buildPaneNavCss(site: RailSite, paint?: RailPaint): string;
+/** `rgb(r, g, b)` / `rgba(...)` at a new alpha; anything else falls back to a neutral line. */
+export declare function withAlpha(color: string, alpha: number): string;
+export declare function installPaneNav(win: Window, site: RailSite): PaneNavHandle;

package/dist/runtime/paneNav.js

@@ -0,0 +1,311 @@
+// Split view: site panes of one account side by side each draw the site's whole navigation rail.
+// Native code tells every site pane whether another pane already shows it (`redundantNav`, the
+// leftmost pane of that account wins). With the feature on, such a pane lifts the rail out of the
+// layout (the content re-centers in the freed width), parks it off-screen, and slides it back in
+// over the page while the pointer rests on the pane's left edge. Which element is the rail is the
+// site adapter's `RailSite`.
+import { watchDom } from "./domHub.js";
+/** Resting on the edge this long slides the rail in; crossing it on the way to the divider does not. */
+const PEEK_DELAY = 140;
+/** The rail stays this long after the pointer leaves it (and while one of its menus is open). */
+const LEAVE_DELAY = 280;
+const names = (site) => ({
+    style: `${site.prefix}-pane-nav`,
+    edge: `${site.prefix}-rail-edge`,
+    /** On <html>: "hidden" (rail parked off-screen) or "peek" (rail slid in over the page). */
+    state: `data-${site.prefix}-pane-nav`,
+    /** Marks the rail when the site draws it as something other than its classic rail element. */
+    rail: `data-${site.prefix}-rail`,
+});
+/** Pure: the stylesheet for a pane whose rail is parked. RTL pages keep the rail on the right. */
+export function buildPaneNavCss(site, paint = site.paint) {
+    const { edge, state, rail } = names(site);
+    const RAIL = `:is(${site.rail}, [${rail}])`;
+    const ease = 'cubic-bezier(.2, .8, .2, 1)';
+    const [side, other, sign] = paint.rtl ? ['right', 'left', 1] : ['left', 'right', -1];
+    return `
+html[${state}] ${RAIL} {
+  position: fixed !important; top: 0 !important; bottom: 0 !important; ${side}: 0 !important; ${other}: auto !important;
+  width: ${paint.width}px !important; min-width: 0 !important; max-width: none !important; height: 100vh !important;
+  flex: none !important; margin: 0 !important; overflow: visible !important; z-index: 40 !important;
+  background-color: ${paint.background} !important;
+  transform: translateX(${sign * 100}%); visibility: hidden;
+  transition: transform .2s ${ease}, box-shadow .2s ease, visibility 0s linear .2s;
+}
+html[${state}="peek"] ${RAIL} {
+  transform: translateX(0); visibility: visible;
+  box-shadow: ${-sign}px 0 0 ${paint.line}, ${-sign * 16}px 0 40px rgba(0, 0, 0, .3);
+  transition: transform .2s ${ease}, box-shadow .2s ease;
+}
+html[${state}] ${RAIL} ~ ${site.main} { align-items: center !important; }
+#${edge} { position: fixed; ${side}: 0; top: 0; bottom: 0; width: 10px; z-index: 41; }
+#${edge}::after {
+  content: ""; position: absolute; ${side}: 0; top: 50%; width: 3px; height: 56px; margin-top: -28px;
+  border-radius: ${paint.rtl ? '3px 0 0 3px' : '0 3px 3px 0'}; background: ${paint.accent}; opacity: 0; transform: scaleY(.5);
+  transition: opacity .15s ease, transform .15s ease;
+}
+#${edge}:hover::after { opacity: .9; transform: scaleY(1); }
+html[${state}="peek"] #${edge} { pointer-events: none; }
+@media (prefers-reduced-motion: reduce) {
+  html[${state}] ${RAIL}, #${edge}::after { transition: none !important; }
+}`.trim();
+}
+const TRANSPARENT = /^(transparent|rgba\([^)]*,\s*0\))$/;
+const isTransparent = (color) => !color || TRANSPARENT.test(color.replace(/\s+/g, ' ').trim());
+/** `rgb(r, g, b)` / `rgba(...)` at a new alpha; anything else falls back to a neutral line. */
+export function withAlpha(color, alpha) {
+    const parts = color.match(/\d+(?:\.\d+)?/g);
+    return parts && parts.length >= 3 ? `rgba(${parts[0]}, ${parts[1]}, ${parts[2]}, ${alpha})` : `rgba(128, 128, 128, ${alpha})`;
+}
+export function installPaneNav(win, site) {
+    const doc = win.document;
+    const ids = names(site);
+    // Installed at document start, before the parser has created <html>: never cache it.
+    const root = () => doc.documentElement;
+    let redundant = false;
+    let enabled = true;
+    let active = false;
+    let disposed = false;
+    let rail = null;
+    let edge = null;
+    let watch = null;
+    let paint = { ...site.paint };
+    let peekTimer = 0;
+    let leaveTimer = 0;
+    let resizeFrame = 0;
+    /** A press inside the rail may have opened one of its menus (portalled elsewhere). */
+    let railMenu = false;
+    const isRtl = () => root()?.getAttribute('dir') === 'rtl';
+    const ensureStyle = () => {
+        let style = doc.getElementById(ids.style);
+        if (!style) {
+            const parent = doc.head || root();
+            if (!parent)
+                return;
+            style = doc.createElement('style');
+            style.id = ids.style;
+            parent.appendChild(style);
+        }
+        const css = buildPaneNavCss(site, paint);
+        if (style.textContent !== css)
+            style.textContent = css;
+    };
+    /** The site's rail: its classic element, else the sibling of <main> holding the anchor link. */
+    const findRail = () => {
+        const classic = doc.querySelector(site.rail);
+        if (classic)
+            return classic;
+        if (rail?.isConnected)
+            return rail;
+        const main = doc.querySelector('main');
+        const anchor = doc.querySelector(site.anchor);
+        if (!main || !anchor)
+            return null;
+        for (let el = anchor.parentElement; el && el !== doc.body; el = el.parentElement) {
+            const parent = el.parentElement;
+            if (!parent?.contains(main) || el.contains(main))
+                continue;
+            // Only a tall column at the start edge: never a bottom tab bar or a page-wide wrapper.
+            const box = el.getBoundingClientRect();
+            const tall = box.height >= win.innerHeight * 0.5;
+            const atStart = isRtl() ? box.right >= win.innerWidth - 8 : box.left <= 8;
+            return tall && atStart && box.width <= win.innerWidth * 0.45 ? el : null;
+        }
+        return null;
+    };
+    const railWidth = (el) => {
+        const column = el.firstElementChild?.getBoundingClientRect().width ?? 0;
+        const nav = el.querySelector('nav')?.getBoundingClientRect().width ?? 0;
+        const width = Math.round(Math.max(column, nav));
+        return width >= 48 && width <= 400 ? width : paint.width;
+    };
+    /** Reads the page colors for the slid-in rail (layout reads: only on state changes, never per mutation). */
+    const repaint = () => {
+        try {
+            const body = doc.body ? win.getComputedStyle(doc.body) : null;
+            const html = root() ? win.getComputedStyle(root()) : null;
+            let background = body?.backgroundColor ?? '';
+            if (isTransparent(background))
+                background = html?.backgroundColor ?? '';
+            if (isTransparent(background))
+                background = /dark/.test(html?.colorScheme ?? '') ? 'rgb(0, 0, 0)' : 'rgb(255, 255, 255)';
+            const button = site.accentSource ? doc.querySelector(site.accentSource) : null;
+            const fill = button ? win.getComputedStyle(button).backgroundColor : '';
+            paint = {
+                width: rail ? railWidth(rail) : paint.width,
+                background,
+                line: withAlpha(body?.color ?? '', 0.16),
+                accent: isTransparent(fill) ? site.paint.accent : fill,
+                rtl: isRtl(),
+            };
+        }
+        catch { /* keep the last paint */ }
+        ensureStyle();
+    };
+    const state = () => root()?.getAttribute(ids.state) ?? null;
+    const setState = (value) => { if (state() !== value)
+        root()?.setAttribute(ids.state, value); };
+    const menuOpen = () => !!doc.querySelector(site.menuOpen);
+    const unpeek = () => {
+        win.clearTimeout(peekTimer);
+        win.clearTimeout(leaveTimer);
+        railMenu = false;
+        if (active)
+            setState('hidden');
+    };
+    const tryLeave = () => {
+        if (state() !== 'peek')
+            return;
+        // Only the rail's own menus hold it out; sites portal them like every other menu, so "open" is
+        // judged only after a press inside the rail and ends when that menu closes.
+        const holding = railMenu && menuOpen();
+        if (!holding)
+            railMenu = false;
+        if (rail?.matches(':hover') || holding) {
+            leaveTimer = win.setTimeout(tryLeave, LEAVE_DELAY);
+            return;
+        }
+        unpeek();
+    };
+    const peek = () => {
+        win.clearTimeout(peekTimer);
+        // Never over one of the site's modal sheets: the rail would sit above them.
+        if (!active || !rail || doc.querySelector(site.modalOpen))
+            return;
+        repaint();
+        setState('peek');
+        win.clearTimeout(leaveTimer);
+        leaveTimer = win.setTimeout(tryLeave, LEAVE_DELAY * 4);
+    };
+    const onEdgeEnter = () => { win.clearTimeout(peekTimer); peekTimer = win.setTimeout(peek, PEEK_DELAY); };
+    const onEdgeLeave = () => { if (state() !== 'peek')
+        win.clearTimeout(peekTimer); };
+    const onRailEnter = () => win.clearTimeout(leaveTimer);
+    const onRailPress = () => { railMenu = true; };
+    const onRailLeave = () => { win.clearTimeout(leaveTimer); leaveTimer = win.setTimeout(tryLeave, LEAVE_DELAY); };
+    // A nav link navigates or opens a sheet: get out of the way.
+    const onRailClick = (event) => {
+        if (event.target?.closest?.('a[href]'))
+            win.setTimeout(unpeek, 0);
+    };
+    const onKey = (event) => { if (event.key === 'Escape' && state() === 'peek')
+        unpeek(); };
+    const onResize = () => {
+        if (resizeFrame)
+            return;
+        resizeFrame = win.requestAnimationFrame(() => {
+            resizeFrame = 0;
+            if (active && rail) {
+                paint = { ...paint, width: railWidth(rail) };
+                ensureStyle();
+            }
+        });
+    };
+    const bindRail = (next) => {
+        if (next === rail)
+            return;
+        if (rail) {
+            rail.removeAttribute(ids.rail);
+            rail.removeEventListener('pointerenter', onRailEnter);
+            rail.removeEventListener('pointerleave', onRailLeave);
+            rail.removeEventListener('pointerdown', onRailPress, true);
+            rail.removeEventListener('click', onRailClick, true);
+        }
+        rail = next;
+        if (!rail)
+            return;
+        if (!rail.matches(site.rail))
+            rail.setAttribute(ids.rail, '');
+        rail.addEventListener('pointerenter', onRailEnter);
+        rail.addEventListener('pointerleave', onRailLeave);
+        rail.addEventListener('pointerdown', onRailPress, true);
+        rail.addEventListener('click', onRailClick, true);
+        paint = { ...paint, width: railWidth(rail), rtl: isRtl() };
+        ensureStyle();
+    };
+    const syncEdge = () => {
+        if (!doc.body)
+            return;
+        if (edge?.isConnected)
+            return;
+        edge = doc.createElement('div');
+        edge.id = ids.edge;
+        edge.setAttribute('aria-hidden', 'true');
+        edge.addEventListener('pointerenter', onEdgeEnter);
+        edge.addEventListener('pointerleave', onEdgeLeave);
+        edge.addEventListener('click', peek);
+        doc.body.appendChild(edge);
+    };
+    // Sites re-render their layout on route and breakpoint changes: keep the rail marked and the edge in place.
+    const sync = () => {
+        if (!active || disposed)
+            return;
+        // The first run after <html> exists parks the rail (activation may predate the document).
+        ensureStyle();
+        if (state() !== 'peek')
+            setState('hidden');
+        bindRail(findRail());
+        syncEdge();
+        // The page direction can switch with the display language, without a reload.
+        if (paint.rtl !== isRtl()) {
+            paint = { ...paint, rtl: isRtl() };
+            ensureStyle();
+        }
+    };
+    const activate = () => {
+        // The rail's width is measured while it is still in the layout, before it is parked.
+        if (doc.body)
+            bindRail(findRail());
+        ensureStyle();
+        setState('hidden');
+        win.addEventListener('keydown', onKey, true);
+        win.addEventListener('resize', onResize);
+        watch = watchDom(win, sync);
+        watch.schedule();
+    };
+    const deactivate = () => {
+        win.clearTimeout(peekTimer);
+        win.clearTimeout(leaveTimer);
+        railMenu = false;
+        if (resizeFrame)
+            win.cancelAnimationFrame(resizeFrame);
+        resizeFrame = 0;
+        watch?.dispose();
+        watch = null;
+        win.removeEventListener('keydown', onKey, true);
+        win.removeEventListener('resize', onResize);
+        root()?.removeAttribute(ids.state);
+        bindRail(null);
+        edge?.remove();
+        edge = null;
+        doc.getElementById(ids.style)?.remove();
+    };
+    const apply = () => {
+        const next = enabled && redundant && !disposed;
+        if (next === active)
+            return;
+        active = next;
+        if (active)
+            activate();
+        else
+            deactivate();
+    };
+    return {
+        set(value) {
+            const next = value?.redundantNav;
+            if (typeof next !== 'boolean')
+                return;
+            redundant = next;
+            apply();
+        },
+        setEnabled(value) {
+            enabled = value;
+            apply();
+        },
+        dispose() {
+            disposed = true;
+            apply();
+        },
+    };
+}
+//# sourceMappingURL=paneNav.js.map