local-operator-ui 0.39.4 → 0.39.5

package/out/main/index.js

@@ -28839,6 +28839,7 @@ const ADDRESS_LIST_ROWS_MAX = 5;
 const ADDRESS_LIST_MAX_HEIGHT_DIP = 212;
 const ADDRESS_LIST_NOTICE_HEIGHT_DIP = 104;
 const ADDRESS_LIST_ANCHOR_GAP_MAX = 24;
+const ADDRESS_LIST_MIN_WIDTH_DIP = 240;
 const ADDRESS_LIST_MAX_PAYLOAD_BYTES = 16 * 1024;
 const ADDRESS_LIST_MAX_TEXT = 512;
 const ADDRESS_LIST_MAX_TITLE = 256;
@@ -28853,7 +28854,7 @@ const NOTICE_KINDS = [
 ];
 const HOSTILE_STRING = /[\p{Cc}\u2028\u2029\u202A-\u202E\u2066-\u2069]/gu;
 const COLOR = /^(#[0-9a-f]{6}|rgb\(\d{1,3}, ?\d{1,3}, ?\d{1,3}\))$/i;
-const PROJECTION_KEYS = /* @__PURE__ */ new Set([
+const PROJECTION_KEYS_V1 = /* @__PURE__ */ new Set([
   "v",
   "seq",
   "tabId",
@@ -28867,6 +28868,20 @@ const PROJECTION_KEYS = /* @__PURE__ */ new Set([
   "dir",
   "theme"
 ]);
+const PROJECTION_KEYS_V2 = /* @__PURE__ */ new Set([
+  "v",
+  "seq",
+  "tabId",
+  "visible",
+  "pageRect",
+  "anchor",
+  "active",
+  "view",
+  "label",
+  "dir",
+  "theme"
+]);
+const ANCHOR_KEYS = ["x", "width"];
 const RECT_KEYS = ["x", "y", "width", "height"];
 const THEME_KEYS = [
   "elevated",
@@ -28947,10 +28962,10 @@ function sanitizeProjection(raw) {
     return { ok: false, reason: "payload_too_large" };
   }
   if (!isRecord$1(raw)) return { ok: false, reason: "not_an_object" };
-  if (!hasOnlyKeys(raw, PROJECTION_KEYS)) {
-    return { ok: false, reason: "unknown_key" };
-  }
-  if (raw.v !== 1) return { ok: false, reason: "bad_version" };
+  if (raw.v !== 1 && raw.v !== 2) return { ok: false, reason: "bad_version" };
+  const version = raw.v;
+  const keys = version === 2 ? PROJECTION_KEYS_V2 : PROJECTION_KEYS_V1;
+  if (!hasOnlyKeys(raw, keys)) return { ok: false, reason: "unknown_key" };
   if (!Number.isInteger(raw.seq) || raw.seq < 1) {
     return { ok: false, reason: "bad_seq" };
   }
@@ -28959,15 +28974,29 @@ function sanitizeProjection(raw) {
     return { ok: false, reason: "bad_visible" };
   }
   if (!raw.visible) {
+    const empty = { x: 0, y: 0, width: 0, height: 0 };
     return {
       ok: true,
-      projection: {
+      projection: version === 2 ? {
+        v: 2,
+        seq: raw.seq,
+        tabId: raw.tabId,
+        visible: false,
+        pageRect: empty,
+        anchor: { x: 0, width: 0 },
+        active: -1,
+        view: { kind: "notice", notice: "empty", text: "" },
+        label: "",
+        dir: "ltr",
+        theme: null,
+        themeFact: "absent"
+      } : {
         v: 1,
         seq: raw.seq,
         tabId: raw.tabId,
         visible: false,
-        pageRect: { x: 0, y: 0, width: 0, height: 0 },
-        field: { x: 0, y: 0, width: 0, height: 0 },
+        pageRect: empty,
+        field: empty,
         listTop: 0,
         active: -1,
         view: { kind: "notice", notice: "empty", text: "" },
@@ -28979,14 +29008,30 @@ function sanitizeProjection(raw) {
     };
   }
   const pageRect = rect(raw.pageRect);
-  const field = rect(raw.field);
-  if (pageRect === null || field === null) {
-    return { ok: false, reason: "bad_rect" };
-  }
-  const listTop = finite(raw.listTop);
-  if (listTop === null) return { ok: false, reason: "bad_list_top" };
-  if (field.width <= 0 || field.height <= 0) {
-    return { ok: false, reason: "bad_field" };
+  if (pageRect === null) return { ok: false, reason: "bad_rect" };
+  let field = null;
+  let listTop = 0;
+  let anchor = null;
+  if (version === 2) {
+    if (!isRecord$1(raw.anchor) || !hasOnlyKeys(raw.anchor, ANCHOR_KEYS)) {
+      return { ok: false, reason: "bad_anchor" };
+    }
+    const x = finite(raw.anchor.x);
+    const width = finite(raw.anchor.width);
+    if (x === null || width === null) {
+      return { ok: false, reason: "bad_anchor" };
+    }
+    if (width <= 0) return { ok: false, reason: "bad_anchor" };
+    anchor = { x, width };
+  } else {
+    field = rect(raw.field);
+    if (field === null) return { ok: false, reason: "bad_rect" };
+    const top = finite(raw.listTop);
+    if (top === null) return { ok: false, reason: "bad_list_top" };
+    listTop = top;
+    if (field.width <= 0 || field.height <= 0) {
+      return { ok: false, reason: "bad_field" };
+    }
   }
   if (!Number.isInteger(raw.active)) return { ok: false, reason: "bad_active" };
   const active = raw.active;
@@ -29026,6 +29071,27 @@ function sanitizeProjection(raw) {
     return { ok: false, reason: "bad_dir" };
   }
   const { theme, fact } = sanitizeTheme(raw.theme);
+  if (version === 2) {
+    if (anchor === null) return { ok: false, reason: "bad_anchor" };
+    return {
+      ok: true,
+      projection: {
+        v: 2,
+        seq: raw.seq,
+        tabId: raw.tabId,
+        visible: true,
+        pageRect,
+        anchor,
+        active,
+        view,
+        label,
+        dir: raw.dir,
+        theme,
+        themeFact: fact
+      }
+    };
+  }
+  if (field === null) return { ok: false, reason: "bad_rect" };
   return {
     ok: true,
     projection: {
@@ -29079,6 +29145,26 @@ function addressListBoundsFor(field, listTop, view, owner) {
   if (bottom - top !== height) return null;
   return { x: left, y: top, width: right - left, height };
 }
+function addressListBoundsV2For(anchor, pageRect, view, owner) {
+  const ax = int32$1(anchor.x);
+  const aw = int32$1(anchor.width);
+  const px = int32$1(pageRect.x);
+  const pw = int32$1(pageRect.width);
+  const py = int32$1(pageRect.y);
+  const ownerWidth = int32$1(owner.width);
+  const ownerHeight = int32$1(owner.height);
+  if (ax === null || aw === null || px === null || pw === null || py === null || ownerWidth === null || ownerHeight === null) {
+    return null;
+  }
+  if (aw <= 0 || pw <= 0 || ownerWidth <= 0 || ownerHeight <= 0) return null;
+  const left = Math.max(0, Math.max(ax, px));
+  const right = Math.min(ownerWidth, Math.min(ax + aw, px + pw));
+  if (right - left < ADDRESS_LIST_MIN_WIDTH_DIP) return null;
+  const height = addressListHeightFor(view);
+  if (height > ADDRESS_LIST_MAX_HEIGHT_DIP) return null;
+  if (py < 0 || py + height > ownerHeight) return null;
+  return { x: left, y: py, width: right - left, height };
+}
 function addressListRowIndexAt(view, offsetY) {
   if (view.kind !== "rows") return null;
   if (!Number.isFinite(offsetY)) return null;
@@ -29391,6 +29477,10 @@ function layoutKeyOf(snapshot2) {
   const rect2 = snapshot2.contentRect;
   return `${snapshot2.activeTabId}:${snapshot2.presented ? 1 : 0}:${rect2 ? `${rect2.x},${rect2.y},${rect2.width},${rect2.height}` : "null"}`;
 }
+function layoutContentKeyOf(snapshot2) {
+  const rect2 = snapshot2.contentRect;
+  return `${snapshot2.activeTabId}:${rect2 ? `${rect2.x},${rect2.y},${rect2.width},${rect2.height}` : "null"}`;
+}
 function sameRect(a, b) {
   if (b === null) return false;
   return a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height;
@@ -29437,6 +29527,7 @@ class AddressOverlayController {
   createView;
   javascript;
   onEvent;
+  onHealthChange;
   readinessTimeoutMs;
   log;
   now;
@@ -29452,6 +29543,9 @@ class AddressOverlayController {
   lastShow;
   layout;
   layoutKey;
+  /** The layout's content identity (tab + rect), the fact a product dismissal
+   * is allowed to rest on; see `layoutContentKeyOf`. */
+  layoutContentKey;
   boundTabId;
   domReady;
   finished;
@@ -29492,14 +29586,25 @@ class AddressOverlayController {
   /** The launch gate's `visible` fact, copied in so `facts()` can report it
    * without re-deriving the gate (which it must never do: one pure decision). */
   visibleMode;
+  product;
+  warmScheduled;
   lastRejected;
   projectQueue;
+  /** The native page is hidden for a reason that says nothing about the popout
+   * (the page menu suppresses it while its panel is open). The row stays
+   * raised, so the child's paint stops and its "shown" state does not. */
+  presentationSuspended;
+  /** A projection that arrived while the page was suppressed. Applied on
+   * resume rather than refused: a refusal would make the mirror re-project
+   * every frame until the menu closed. */
+  deferredProjection;
   constructor(deps) {
     this.window = deps.window;
     this.documentUrl = deps.documentUrl;
     this.createView = deps.createView ?? (() => createHardenedView({ javascript: deps.javascript === true }));
     this.javascript = deps.javascript === true;
     this.onEvent = deps.onEvent ?? null;
+    this.onHealthChange = deps.onHealthChange ?? null;
     this.readinessTimeoutMs = deps.readinessTimeoutMs ?? ADDRESS_OVERLAY_READY_TIMEOUT_MS;
     this.log = deps.log ?? (() => {
     });
@@ -29521,6 +29626,7 @@ class AddressOverlayController {
       revision: 0
     };
     this.layoutKey = "none";
+    this.layoutContentKey = "none";
     this.boundTabId = null;
     this.domReady = false;
     this.finished = false;
@@ -29552,8 +29658,12 @@ class AddressOverlayController {
     this.childFocusEvents = 0;
     this.childBlurEvents = 0;
     this.visibleMode = deps.visible === true;
+    this.product = deps.product === true;
+    this.warmScheduled = false;
     this.lastRejected = null;
     this.projectQueue = Promise.resolve();
+    this.presentationSuspended = false;
+    this.deferredProjection = null;
     this.attachOwnerListeners();
   }
   // ---- observer hooks ------------------------------------------------------
@@ -29561,25 +29671,41 @@ class AddressOverlayController {
    * The registry's post-layout hook. Called after every page layout pass,
    * including null and suppressed ones.
    *
-   * A changed key (tab, presentation or rectangle) hides and invalidates first:
-   * a moved page must never keep a stale rectangle floating over it, and a
-   * resized window invalidates old geometry until a fresh renderer rect
-   * arrives. An unchanged key is the background-page-creation case: the layout
-   * pass may have added a page above the child, so the child is re-added last
-   * and given the same rectangle. It never re-opens by itself; showing again is
-   * always an explicit probe call.
+   * A changed key (tab, presentation or rectangle) is handled by ONE of two
+   * rules, and the split is load-bearing (agent review round 1, MAJOR-1):
+   * a CONTENT change (tab or rectangle) hides and invalidates, while a
+   * PRESENTATION-only change is a suppression that belongs to someone else —
+   * the page menu, which paints into the content rect — so it only stops the
+   * child's paint and keeps the shown state. Collapsing the two made opening
+   * the menu dismiss the popout it was opened from. An unchanged key is the
+   * background-page-creation case: the layout pass may have added a page above
+   * the child, so the child is re-added last and given the same rectangle. It
+   * never re-opens by itself; showing again is always an explicit probe call.
    */
   onLayout(snapshot2) {
     if (this.disposed) return;
     const next = copyLayout(snapshot2);
     const nextKey = layoutKeyOf(next);
     const previousKey = this.layoutKey;
+    const nextContentKey = layoutContentKeyOf(next);
+    const previousContentKey = this.layoutContentKey;
     this.layout = next;
     this.layoutKey = nextKey;
+    this.layoutContentKey = nextContentKey;
     if (previousKey !== nextKey) {
+      const contentChanged = previousContentKey !== nextContentKey;
+      if (!contentChanged) {
+        if (next.presented) this.resumePresentation();
+        else this.suspendPresentation();
+        return;
+      }
       this.hide("layout");
+      if (this.product && previousKey !== "none") this.emitDismiss("layout");
       return;
     }
+    if (this.product && next.presented && next.contentRect !== null) {
+      this.ensureChild();
+    }
     if (this.state !== "shown") return;
     const view = this.view;
     if (!view || this.viewUsable(view) === false) return;
@@ -29596,6 +29722,40 @@ class AddressOverlayController {
       this.log(`[browser] address overlay layout failed: ${String(error)}`);
     }
   }
+  /** Hide the child's paint without dropping the popout's state; see `onLayout`. */
+  suspendPresentation() {
+    this.presentationSuspended = true;
+    const view = this.view;
+    if (!view || this.viewUsable(view) === false) return;
+    try {
+      view.setVisible(false);
+    } catch {
+    }
+  }
+  /** The page is back. Re-present the child from the bounds last applied, or
+   * apply the projection that arrived while the page was hidden. */
+  resumePresentation() {
+    if (!this.presentationSuspended) return;
+    this.presentationSuspended = false;
+    const deferred = this.deferredProjection;
+    this.deferredProjection = null;
+    if (deferred !== null) {
+      void this.project(deferred);
+      return;
+    }
+    if (this.state !== "shown") return;
+    const bounds = this.lastAppliedBounds ?? overlayBoundsFor(this.layout.contentRect, this.ownerSize());
+    if (bounds === null) return;
+    const view = this.view;
+    if (!view || this.viewUsable(view) === false) return;
+    try {
+      view.setBounds(bounds);
+      this.raiseChild(view);
+      view.setVisible(true);
+    } catch {
+      this.releaseChild("layout_error");
+    }
+  }
   /** The bound page is going away. Dispose the child before the page release. */
   onTabReleased(tabId) {
     if (this.disposed) return;
@@ -29610,6 +29770,63 @@ class AddressOverlayController {
     if (this.boundTabId !== tabId) return;
     this.releaseChild("page-crash");
   }
+  /**
+   * The popout's current health, in the one shape the renderer reads.
+   *
+   * `suspend` is sticky for the app run: the child is either latched failed or
+   * gone, and the restart that would clear it is a new process. A conditional
+   * refusal (`zoomed`, `anchor_too_narrow`, `stale_*`) is NOT reported here —
+   * those clear themselves, and the projection answer names them while they
+   * last.
+   */
+  mode() {
+    if (this.disposed) return { mode: "suspend", reason: "disposed" };
+    if (this.failedReason)
+      return { mode: "suspend", reason: this.failedReason };
+    return { mode: "popout", reason: null };
+  }
+  /**
+   * A main-decided dismissal (the page took focus, the bound tab's main frame
+   * navigated, the tab went away). Idempotent: a second reason for a popout that
+   * is already hidden sends nothing.
+   */
+  dismiss(reason) {
+    if (this.disposed) return;
+    this.hide(reason);
+    if (this.product) this.emitDismiss(reason);
+  }
+  /** The page `tabId` took focus. Only the bound tab can dismiss its own list;
+   * a background tab's focus event is not this popout's business. */
+  dismissForTab(tabId, reason) {
+    if (this.disposed) return;
+    if (this.boundTabId !== null && this.boundTabId !== tabId) return;
+    if (this.layout.activeTabId !== null && this.layout.activeTabId !== tabId)
+      return;
+    this.dismiss(reason);
+  }
+  /**
+   * Warm the list child once the page has a presented layout, so the first
+   * raise finds a loaded document instead of paying the load after Cmd+L. The
+   * child is created hidden and stays hidden until a projection shows it.
+   */
+  ensureChild() {
+    if (!this.product || this.view || this.failedReason || this.warmScheduled)
+      return;
+    const bounds = overlayBoundsFor(this.layout.contentRect, this.ownerSize());
+    if (bounds === null || !this.layout.presented) return;
+    this.warmScheduled = true;
+    setTimeout(() => {
+      this.warmScheduled = false;
+      if (this.disposed || this.view || this.failedReason) return;
+      if (!this.layout.presented) return;
+      const rect2 = overlayBoundsFor(this.layout.contentRect, this.ownerSize());
+      if (rect2 === null) return;
+      if (this.createChild(rect2)) this.state = "loading";
+    }, 0);
+  }
+  emitDismiss(reason) {
+    this.onEvent?.({ type: "dismiss", reason });
+  }
   // ---- probe surface ------------------------------------------------------
   async showOverlay() {
     if (this.showInFlight) return this.showInFlight;
@@ -29627,6 +29844,8 @@ class AddressOverlayController {
   }
   hide(reason = "hide") {
     if (this.disposed) return;
+    this.presentationSuspended = false;
+    this.deferredProjection = null;
     this.generation += 1;
     this.settleReady(false);
     this.hiddenReason = reason;
@@ -29793,6 +30012,15 @@ class AddressOverlayController {
    * controller, so a burst between frames costs one apply each in arrival order.
    */
   project(raw) {
+    if (this.presentationSuspended) {
+      this.deferredProjection = raw;
+      return Promise.resolve({
+        accepted: true,
+        shown: false,
+        reason: null,
+        bounds: null
+      });
+    }
     const run = () => this.projectOnce(raw);
     const next = this.projectQueue.then(run, run);
     this.projectQueue = next.then(
@@ -29855,13 +30083,23 @@ class AddressOverlayController {
     if (!layout.presented || !sameRect(projection.pageRect, layout.contentRect)) {
       return this.refuseProjection("stale_layout");
     }
-    const bounds = addressListBoundsFor(
+    const bounds = projection.v === 2 ? projection.anchor.width < ADDRESS_LIST_MIN_WIDTH_DIP ? null : addressListBoundsV2For(
+      projection.anchor,
+      projection.pageRect,
+      projection.view,
+      this.ownerSize()
+    ) : addressListBoundsFor(
       projection.field,
       projection.listTop,
       projection.view,
       this.ownerSize()
     );
-    if (bounds === null) return this.refuseProjection("anchor_inconsistent");
+    if (bounds === null) {
+      const tooNarrow = projection.v === 2 && projection.anchor.width < ADDRESS_LIST_MIN_WIDTH_DIP;
+      return this.refuseProjection(
+        tooNarrow ? "anchor_too_narrow" : "anchor_inconsistent"
+      );
+    }
     this.generation += 1;
     const generation = this.generation;
     this.boundTabId = projection.tabId;
@@ -30307,6 +30545,7 @@ class AddressOverlayController {
     this.settleReady(false);
     this.destroyChild();
     this.log(`[browser] address overlay failed: ${reason}`);
+    this.onHealthChange?.();
   }
   /** Recoverable: the child goes, a later explicit show may lazily recreate one. */
   releaseChild(reason) {
@@ -30319,6 +30558,7 @@ class AddressOverlayController {
     this.finished = false;
     this.loadStartedAt = null;
     this.log(`[browser] address overlay child released: ${reason}`);
+    this.onHealthChange?.();
   }
   destroyChild() {
     const view = this.view;
@@ -35135,6 +35375,7 @@ const enUiBrowser = {
   "ui.browser.browser_url_bar.home_destination": "Home — go to the start page (blank)",
   "ui.browser.browser_url_bar.latest_download": "Open downloads folder — {name} was saved there",
   "ui.browser.browser_url_bar.newest_download": "Open downloads folder — {name} was the newest saved there ({count, plural, other {{count, number, ::group-off} this session}})",
+  "ui.browser.browser_url_bar.page_menu": "Page options",
   "ui.browser.browser_url_bar.page_zoom_reset": "Page zoom {zoom, number, ::group-off}%, reset to 100%",
   "ui.browser.browser_url_bar.print_page": "Print page",
   "ui.browser.browser_url_bar.reload": "Reload",
@@ -38842,6 +39083,7 @@ const esUiBrowser = {
   "ui.browser.browser_url_bar.print_page": "Imprimir página",
   "ui.browser.browser_url_bar.forward": "Adelante",
   "ui.browser.browser_url_bar.reset_page_zoom_shortcut": "Restablecer zoom de la página ({shortcut})",
+  "ui.browser.browser_url_bar.page_menu": "Opciones de página",
   "ui.browser.browser_url_bar.page_zoom_reset": "Zoom de la página al {zoom, number, ::group-off}%, restablecer al 100%",
   "ui.browser.browser_url_bar.stop_loading": "Detener carga",
   "ui.browser.browser_url_bar.reload": "Recargar",
@@ -42418,6 +42660,7 @@ const frUiBrowser = {
   "ui.browser.browser_url_bar.print_page": "Imprimer la page",
   "ui.browser.browser_url_bar.forward": "Avancer",
   "ui.browser.browser_url_bar.reset_page_zoom_shortcut": "Réinitialiser le zoom de la page ({shortcut})",
+  "ui.browser.browser_url_bar.page_menu": "Options de la page",
   "ui.browser.browser_url_bar.page_zoom_reset": "Zoom de la page {zoom, number, ::group-off} %, réinitialiser à 100 %",
   "ui.browser.browser_url_bar.stop_loading": "Arrêter le chargement",
   "ui.browser.browser_url_bar.reload": "Recharger",
@@ -46015,6 +46258,7 @@ const hiUiBrowser = {
   "ui.browser.browser_url_bar.home_destination": "होम — शुरुआती पेज पर जाएँ (खाली)",
   "ui.browser.browser_url_bar.latest_download": "डाउनलोड फ़ोल्डर खोलें — {name} वहाँ सहेजी गई थी",
   "ui.browser.browser_url_bar.newest_download": "डाउनलोड फ़ोल्डर खोलें — {name} वहाँ सबसे हाल में सहेजी गई थी ({count, plural, other {इस सत्र में {count, number, ::group-off}}})",
+  "ui.browser.browser_url_bar.page_menu": "पेज विकल्प",
   "ui.browser.browser_url_bar.page_zoom_reset": "पेज ज़ूम {zoom, number, ::group-off}%, 100% पर रीसेट करें",
   "ui.browser.browser_url_bar.print_page": "पेज प्रिंट करें",
   "ui.browser.browser_url_bar.reload": "फिर लोड करें",
@@ -49368,6 +49612,7 @@ const ruUiBrowser = {
   "ui.browser.browser_url_bar.home_destination": "Домой — перейти на стартовую страницу (пустую)",
   "ui.browser.browser_url_bar.latest_download": "Открыть папку загрузок — {name} сохранён туда",
   "ui.browser.browser_url_bar.newest_download": "Открыть папку загрузок — {name} сохранён туда последним ({count, plural, one {{count, number, ::group-off} за эту сессию} few {{count, number, ::group-off} за эту сессию} many {{count, number, ::group-off} за эту сессию} other {{count, number, ::group-off} за эту сессию}})",
+  "ui.browser.browser_url_bar.page_menu": "Параметры страницы",
   "ui.browser.browser_url_bar.page_zoom_reset": "Масштаб страницы {zoom, number, ::group-off}%, сбросить до 100%",
   "ui.browser.browser_url_bar.print_page": "Печать страницы",
   "ui.browser.browser_url_bar.reload": "Перезагрузить",
@@ -52827,6 +53072,7 @@ const urUiBrowser = {
   "ui.browser.browser_url_bar.home_destination": "ابتدائی صفحہ — آغاز کے خالی صفحے پر جائیں",
   "ui.browser.browser_url_bar.latest_download": "ڈاؤن لوڈ فولڈر کھولیں — {name} وہاں محفوظ ہوئی",
   "ui.browser.browser_url_bar.newest_download": "ڈاؤن لوڈ فولڈر کھولیں — وہاں سب سے حال میں {name} محفوظ ہوئی ({count, plural, other {اس سیشن میں {count, number, ::group-off}}})",
+  "ui.browser.browser_url_bar.page_menu": "صفحے کے اختیارات",
   "ui.browser.browser_url_bar.page_zoom_reset": "صفحے کا زوم {zoom, number, ::group-off}%، 100% پر ری سیٹ کریں",
   "ui.browser.browser_url_bar.print_page": "صفحہ پرنٹ کریں",
   "ui.browser.browser_url_bar.reload": "دوبارہ لوڈ کریں",
@@ -56200,6 +56446,7 @@ const viUiBrowser = {
   "ui.browser.browser_url_bar.home_destination": "Trang chủ — đến trang bắt đầu (trống)",
   "ui.browser.browser_url_bar.latest_download": "Mở thư mục tải xuống — {name} đã được lưu ở đó",
   "ui.browser.browser_url_bar.newest_download": "Mở thư mục tải xuống — {name} là tệp mới nhất được lưu ở đó ({count, plural, other {{count, number, ::group-off} trong phiên này}})",
+  "ui.browser.browser_url_bar.page_menu": "Tùy chọn trang",
   "ui.browser.browser_url_bar.page_zoom_reset": "Thu phóng trang {zoom, number, ::group-off}%, đặt lại về 100%",
   "ui.browser.browser_url_bar.print_page": "In trang",
   "ui.browser.browser_url_bar.reload": "Tải lại",
@@ -59468,6 +59715,7 @@ const zhCNUiBrowser = {
   "ui.browser.browser_url_bar.home_destination": "主页——前往起始页（空白页）",
   "ui.browser.browser_url_bar.latest_download": "打开下载文件夹——{name}已保存于此",
   "ui.browser.browser_url_bar.newest_download": "打开下载文件夹——最新保存的文件为{name}（本次会话共{count, plural, other {{count, number, ::group-off}个}}）",
+  "ui.browser.browser_url_bar.page_menu": "页面选项",
   "ui.browser.browser_url_bar.page_zoom_reset": "页面缩放{zoom, number, ::group-off}%，重置为100%",
   "ui.browser.browser_url_bar.print_page": "打印页面",
   "ui.browser.browser_url_bar.reload": "重新加载",
@@ -66259,6 +66507,11 @@ class BrowserHost {
   facts;
   /** The session's per-origin storage clear, injected (see `BrowserHostOptions`). */
   forgetSiteData;
+  /** S4b's popout health, read from the controller (or the launch's platform
+   * answer when no controller exists). The strip reads this from the same
+   * projection as the tabs, so the renderer has one source for "child or
+   * fallback" and never guesses from a failed IPC call. */
+  addressOverlayMode;
   /**
    * The last main-frame load failure per tab, cleared by the next load.
    *
@@ -66284,6 +66537,7 @@ class BrowserHost {
     this.tabAudio = new TabAudioTracker(() => this.onChanged());
     this.facts = options.facts;
     this.forgetSiteData = options.forgetSiteData;
+    this.addressOverlayMode = options.addressOverlayMode ?? (() => ({ mode: "suspend", reason: "unavailable" }));
   }
   /** Answer one wire request. The only place a method name becomes an action. */
   async dispatch(method, params, requestId2) {
@@ -66564,6 +66818,7 @@ class BrowserHost {
       new Set(this.registry.snapshot().map((entry) => entry.tabId))
     );
     return {
+      addressOverlay: this.addressOverlayMode(),
       pageControls: this.pageControls.state(active),
       tabs: this.chromeTabOrder.project(this.registry.snapshot()).map((entry, displayOrder) => ({
         ...this.chromeTabOrder.hasCustomOrder ? { displayOrder } : {},
@@ -68278,6 +68533,7 @@ function tabIdOrThrow(value, name) {
   return id2;
 }
 const CONTROL_CHARS = /[\p{Cc}]/u;
+const PRODUCT_ADDRESS_OVERLAY_EVENT = "browser-address-overlay-event";
 const BROWSER_IPC_CHANNELS = [
   "browser-state",
   "browser-set-chord-focus",
@@ -68291,6 +68547,7 @@ const BROWSER_IPC_CHANNELS = [
   "browser-close-tabs",
   "browser-activate-tab",
   "browser-address-history",
+  "browser-address-overlay-project",
   "browser-navigate",
   "browser-home",
   "browser-reload",
@@ -68591,6 +68848,21 @@ function registerBrowserIpc(options) {
       }
     );
   }
+  if (options.addressOverlayProduct) {
+    electron.ipcMain.handle(
+      "browser-address-overlay-project",
+      (event, payload) => {
+        authorizeSender(event);
+        const project = options.addressOverlayProduct;
+        if (!project) {
+          throw new Error(
+            "address_overlay_unavailable: the overlay projection is not running."
+          );
+        }
+        return project(payload);
+      }
+    );
+  }
   if (options.addressOverlayProject) {
     electron.ipcMain.handle(
       DEV_DRIVER_ADDRESS_OVERLAY_PROJECT,
@@ -70588,6 +70860,17 @@ function startBrowserHost(options) {
      * then it reads the current attempt's callback through `bindings` (a retry
      * replaces it) rather than capturing a controller here.
      */
+    ...options.addressOverlay?.product === true ? {
+      addressOverlayProduct: (payload) => {
+        const project = bindings.addressOverlayProject;
+        if (!project) {
+          throw new Error(
+            "address_overlay_unavailable: the overlay controller is not running."
+          );
+        }
+        return project(payload);
+      }
+    } : {},
     ...options.addressOverlay?.enabled ? {
       addressOverlayProbe: (action, argument) => {
         const probe = bindings.addressOverlayProbe;
@@ -70678,8 +70961,18 @@ async function initializeBrowserHost(options, bindings) {
       return view;
     }, wireView = function(view, tabId) {
       const contents = view.webContents;
-      contents.on("focus", () => host.setPageFocused(tabId, true));
+      contents.on("focus", () => {
+        host.setPageFocused(tabId, true);
+        addressOverlay?.dismissForTab(tabId, "page_focus");
+      });
       contents.on("blur", () => host.setPageFocused(tabId, false));
+      contents.on(
+        "did-start-navigation",
+        (_event, _url, isInPlace, isMainFrame) => {
+          if (isMainFrame && !isInPlace)
+            addressOverlay?.dismissForTab(tabId, "navigation");
+        }
+      );
       const popupChildren = /* @__PURE__ */ new Set();
       contents.setWindowOpenHandler((details) => {
         const decision = decidePopup(
@@ -70999,21 +71292,26 @@ async function initializeBrowserHost(options, bindings) {
     const views = /* @__PURE__ */ new Map();
     const releases = /* @__PURE__ */ new Set();
     let stateWriter = null;
+    let notifyAddressOverlayHealth = () => {
+    };
     const addressOverlay = options.addressOverlay?.enabled === true ? new AddressOverlayController({
       window: options.window,
       documentUrl: options.addressOverlay.documentUrl,
       javascript: options.addressOverlay.list === true,
       visible: options.addressOverlay.visible === true,
+      product: options.addressOverlay.product === true,
       // The only consumer of a validated row click: the owner window's own
       // renderer. Guarded because a stop can race a queued mouse event.
       onEvent: (event) => {
-        if (!options.window.isDestroyed()) {
-          options.window.webContents.send(
-            DEV_DRIVER_ADDRESS_OVERLAY_EVENT,
-            event
-          );
-        }
+        if (options.window.isDestroyed()) return;
+        options.window.webContents.send(
+          options.addressOverlay?.product === true ? PRODUCT_ADDRESS_OVERLAY_EVENT : DEV_DRIVER_ADDRESS_OVERLAY_EVENT,
+          event
+        );
       },
+      // The renderer reads Tier 1 out of the projection, so a child that
+      // fails while the field is already raised must push one.
+      onHealthChange: () => notifyAddressOverlayHealth(),
       log: log2,
       appMetrics: () => electron.app.getAppMetrics().map((metric) => ({
         pid: metric.pid,
@@ -71065,6 +71363,7 @@ async function initializeBrowserHost(options, bindings) {
       }
       captureSession();
     };
+    notifyAddressOverlayHealth = notifyChanged;
     const registry = new TabRegistry(
       (_createOptions, tabId) => {
         const view = buildView(options.window);
@@ -71135,7 +71434,11 @@ async function initializeBrowserHost(options, bindings) {
       log: log2,
       onChanged: notifyChanged,
       facts: () => facts,
-      forgetSiteData: (origin) => clearOriginData(browserSession, origin)
+      forgetSiteData: (origin) => clearOriginData(browserSession, origin),
+      addressOverlayMode: () => addressOverlay ? addressOverlay.mode() : {
+        mode: "suspend",
+        reason: options.addressOverlay?.product === true ? "unavailable" : "platform"
+      }
     });
     const ownsChrome = () => browserChromeOwnsChord({
       logicalFocus: host.chordFocus,
@@ -82715,6 +83018,12 @@ const addressOverlayGate = resolveAddressOverlayGate({
   windowMode: windowLaunch.mode,
   packaged: electron.app.isPackaged
 });
+const addressOverlayProduct = process.platform === "darwin" && !addressOverlayGate.enabled;
+if (addressOverlayProduct) {
+  console.log(
+    "[address-overlay] product chrome armed (darwin): popout field over the tab strip, native list child"
+  );
+}
 if (addressOverlayGate.asked) {
   console.log(
     addressOverlayGate.enabled ? addressOverlayGate.visible ? "[address-overlay] ARMED (S3 VISIBLE probe, inactive window, 120 s cap, no product path)" : `[address-overlay] ARMED (S${addressOverlayGate.list ? "2 probe: mirror list" : "1 probe: native child"}, no product path)` : `[address-overlay] not armed: ${addressOverlayGate.reason}`
@@ -83137,7 +83446,7 @@ electron.app.whenReady().then(async () => {
   });
   const rendererUrl = rendererDocumentUrl();
   const consoleCaptureUrl = consoleCaptureUrlFor(rendererUrl);
-  const addressOverlayDocumentUrl = addressOverlayGate.list ? addressListDocumentUrlFor(rendererUrl) : addressOverlayDocumentUrlFor(rendererUrl);
+  const addressOverlayDocumentUrl = addressOverlayGate.list || addressOverlayProduct ? addressListDocumentUrlFor(rendererUrl) : addressOverlayDocumentUrlFor(rendererUrl);
   backendService.observeDesktopFeed(
     (frame) => {
       if (frame.type === "notification") {
@@ -83948,11 +84257,12 @@ electron.app.whenReady().then(async () => {
         consoleCaptureUrl,
         // S1: only a gated headless probe arm gets this option at all. The
         // URL is this app's own packaged document, not a caller's string.
-        ...addressOverlayGate.enabled ? {
+        ...addressOverlayGate.enabled || addressOverlayProduct ? {
           addressOverlay: {
             enabled: true,
-            list: addressOverlayGate.list,
+            list: addressOverlayGate.list || addressOverlayProduct,
             visible: addressOverlayGate.visible,
+            product: addressOverlayProduct,
             documentUrl: addressOverlayDocumentUrl
           }
         } : {},