@linxin666/dsh-remote-web-ui 0.3.23 → 0.4.0

package/lib/types/client/locales.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqKmB,CAAA;AAElC,sCAAsC;AACtC,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,EAAE,CAAA;AAEvC,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,SAAS,CAAA;AAEvC,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqKsB,CAAA"}
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoKmB,CAAA;AAElC,sCAAsC;AACtC,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,EAAE,CAAA;AAEvC,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,SAAS,CAAA;AAEvC,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoKsB,CAAA"}

package/lib/types/client/locales.js

@@ -30,9 +30,9 @@ export const zh = {
     'pair.linkLabel': '配对链接',
     'pair.tokenLabel': '配对令牌',
     'pair.dockerHint': 'Docker 或反向代理环境下，可直接复制此令牌并在目标设备配对页面输入。',
-    'pair.oneTimeHint': '链接含一次性令牌；任一设备配对成功后立即失效，配对下一台设备请刷新二维码。',
+    'pair.oneTimeHint': '链接含限时令牌；在令牌过期或刷新二维码之前，同一链接可为多台设备完成配对（每次配对各自生成独立设备会话）。',
     'pair.failed.title': '配对失败',
-    'pair.failed.detail': '链接无效或已使用，请回到电脑端刷新二维码后重新扫码。',
+    'pair.failed.detail': '链接无效或已过期，请回到电脑端刷新二维码后重新扫码。',
     'fence.unpaired.title': '此设备未配对，无法访问工作区数据',
     'fence.unpaired.eyebrow': '需要设备配对',
     'fence.unpaired.hint': '为保护工作区、会话与插件数据，远程电脑必须先通过主电脑授权。',
@@ -44,7 +44,6 @@ export const zh = {
     'fence.unpaired.pairAction': '立即配对',
     'fence.unpaired.pairing': '配对中…',
     'fence.unpaired.tokenInvalid': '配对链接或 Token 无效已过期',
-    'fence.unpaired.tokenUsed': '该配对链接已被使用',
     'fence.unpaired.tokenFailed': '配对失败，请检查网络或重新获取链接',
     'fence.unpaired.footnote': '请勿使用他人提供的配对链接；管理员可随时取消此设备的授权。',
     'posture.exposed': '/api 通道对未配对设备敞开',
@@ -71,7 +70,7 @@ export const zh = {
     'relay.registering': '正在把临时隧道同步到固定域名（<id>.dsh-market.com）…',
     'relay.failed': '固定域名同步失败：{error}。正在自动重试，期间二维码可能使用临时地址。',
     'close.label': '关闭远程访问面板',
-    // 插件设置卡片（settings.plugin.item 席位）。
+    // 插件设置卡片（家族 list 席位，或官方 plugins.bundle.config 席位）。
     'settings.title': '远程访问设置',
     'settings.description': '配对安全与设备限额。',
     'settings.enabled': '启用远程访问',
@@ -197,9 +196,9 @@ export const en = {
     'pair.linkLabel': 'Pairing link',
     'pair.tokenLabel': 'Pairing token',
     'pair.dockerHint': 'In Docker or reverse proxy environments, copy this token to pair directly on the target device.',
-    'pair.oneTimeHint': 'The link carries one single-use token; it dies as soon as any device pairs. Refresh the QR to pair the next device.',
+    'pair.oneTimeHint': 'The link carries a time-limited token: until it expires or the QR is refreshed, the same link can pair several devices, each with its own device session.',
     'pair.failed.title': 'Pairing failed',
-    'pair.failed.detail': 'The link is invalid or was already used. Refresh the QR code on your computer and scan again.',
+    'pair.failed.detail': 'The link is invalid or has expired. Refresh the QR code on your computer and scan again.',
     'fence.unpaired.title': 'This device is not paired and cannot reach workspace data',
     'fence.unpaired.eyebrow': 'Device pairing required',
     'fence.unpaired.hint': 'To protect workspace, session, and plugin data, a remote computer must first be authorized by the primary computer.',
@@ -211,7 +210,6 @@ export const en = {
     'fence.unpaired.pairAction': 'Pair Now',
     'fence.unpaired.pairing': 'Pairing…',
     'fence.unpaired.tokenInvalid': 'Pairing link or token is invalid or expired',
-    'fence.unpaired.tokenUsed': 'This pairing link has already been used',
     'fence.unpaired.tokenFailed': 'Pairing failed, please check network or issue a new link',
     'fence.unpaired.footnote': 'Do not use pairing links from people you do not trust. An administrator can revoke this device at any time.',
     'posture.exposed': 'The /api channel is open to unpaired devices',
@@ -238,7 +236,7 @@ export const en = {
     'relay.registering': 'Syncing the ephemeral tunnel to the stable hostname (<id>.dsh-market.com)…',
     'relay.failed': 'Stable-hostname sync failed: {error}. Retrying automatically; the QR may use the ephemeral address meanwhile.',
     'close.label': 'Close remote access panel',
-    // Plugin settings card (the `settings.plugin.item` seat).
+    // Plugin settings card (the family list seat, or the official bundle-config seat).
     'settings.title': 'Remote access settings',
     'settings.description': 'Pairing security and device limits.',
     'settings.enabled': 'Enable remote access',

package/lib/types/client/mobile-adapt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mobile-adapt.d.ts","sourceRoot":"","sources":["../../../src/client/mobile-adapt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,yDAAyD;IACzD,aAAa,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;IAClC,yDAAyD;IACzD,YAAY,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;IACjC;;;;;;OAMG;IACH,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,KAAK,MAAM,CAAC,GAAG,IAAI,CAAA;IAC9C,wEAAwE;IACxE,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7B,4GAA4G;IAC5G,iBAAiB,IAAI,IAAI,CAAA;CAC1B;AA+PD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CA0zBvC"}
+{"version":3,"file":"mobile-adapt.d.ts","sourceRoot":"","sources":["../../../src/client/mobile-adapt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,yDAAyD;IACzD,aAAa,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;IAClC,yDAAyD;IACzD,YAAY,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;IACjC;;;;;;OAMG;IACH,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,KAAK,MAAM,CAAC,GAAG,IAAI,CAAA;IAC9C,wEAAwE;IACxE,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7B,4GAA4G;IAC5G,iBAAiB,IAAI,IAAI,CAAA;CAC1B;AAmRD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAq5BvC"}

package/lib/types/client/mobile-adapt.js

@@ -40,6 +40,12 @@ const EFFORT_BTN_ID = 'dshRemoteEffortPick';
 const COMPACT_CLASS = 'dsh-remote-compact-picker';
 /** Body class while the header actions are seated in the tabs row. */
 const HEADER_SEATED_CLASS = 'dsh-remote-header-seated';
+/**
+ * Width the seated header actions paint over the tabs row, as a CSS variable
+ * on <html>. The row caps its own width with it (see the v80 rules) instead of
+ * reserving the space with padding.
+ */
+const HEADER_RESERVE_VAR = '--dsh-remote-header-actions-reserve';
 /** Locale-dependent fast path for the official picker cells (zh/en). */
 const PICKER_CELL_PATTERN = {
     model: /模型|Model/, // i18n-allow: matches official picker cell text, not plugin copy
@@ -228,6 +234,20 @@ const ADAPT_CSS = [
     // [class$="_tab"] misses the active tab (its class ends in "_tabActive")
     // — containment so BOTH tabs match.
     '[class$="_header"] [class$="_tabs"] [class*="_tab"]{font-size:12px;white-space:nowrap}',
+    // v80: the tabs row must give the painted actions their width up on its own.
+    // The v67 padding reservation could not do it: the row is a nowrap flex
+    // container, and once the tab labels plus their gaps overflow the reduced
+    // content box the flex items spill over the padding box, so the trailing
+    // tabs render underneath the actions (reported on a phone: a long agent
+    // preset label covered the last tabs). Cap the row against the reserve and
+    // let the labels scroll instead. The value rides a CSS variable on <html>
+    // because the update lands before React re-creates the row node, and an
+    // inline reservation on that node is dropped until the next sync tick.
+    // The 2px bottom padding keeps the active-tab underline inside the clipping
+    // box; the matching negative margin keeps the header height official.
+    `body.${HEADER_SEATED_CLASS} [class$="_header"] [class$="_tabs"]{max-width:max(0px,calc(100% - var(${HEADER_RESERVE_VAR},0px)));overflow-x:auto;overflow-y:hidden;scrollbar-width:none;-webkit-overflow-scrolling:touch;padding-bottom:2px;margin-bottom:-2px}`,
+    `body.${HEADER_SEATED_CLASS} [class$="_header"] [class$="_tabs"]::-webkit-scrollbar{display:none}`,
+    `body.${HEADER_SEATED_CLASS} [class$="_header"] [class$="_tabs"] > [class*="_tab"]{flex:0 0 auto}`,
     // Mobile scope: hide the plugin surfaces that do not fit a phone — the
     // right-hand details column and every desktop-oriented tool surface. The
     // list keys on the L2 semantic roots (data-dsh-plugin, ownership stays
@@ -320,7 +340,7 @@ export function startMobileAdapt() {
      * rail compaction) while the body class stays.
      */
     function ensureAdaptStyle() {
-        if (document.querySelector(`style[data-plugin-css="${ADAPT_CSS_ID}"]`) !== null)
+        if (nodeOf(`style[data-plugin-css="${ADAPT_CSS_ID}"]`) !== null)
             return;
         const tag = document.createElement('style');
         tag.dataset.plugin = 'remote-web-ui';
@@ -376,6 +396,9 @@ export function startMobileAdapt() {
         }
         if (whaleEl !== null)
             whaleEl.style.display = 'none';
+        // The next apply() is a hidden-to-shown transition again: without this the
+        // whale would keep its pre-revert position state and skip the clamp.
+        whaleShown = false;
         setWhaleTimer(false);
         if (whaleObserver !== null) {
             whaleObserver.disconnect();
@@ -447,7 +470,7 @@ export function startMobileAdapt() {
     function syncCompactPicker() {
         if (!active)
             return;
-        const tools = document.querySelector('[class$="_composerSeat"] [class$="_tools"]');
+        const tools = nodeOf('[class$="_composerSeat"] [class$="_tools"]');
         const trigger = tools?.parentElement?.querySelector('[class$="_triggerEffort"]')?.parentElement;
         if (tools === null || trigger === null) {
             removeCompactPicker();
@@ -626,22 +649,28 @@ export function startMobileAdapt() {
         whaleEl = whale;
         document.body.appendChild(whale);
     }
+    /**
+     * Write one row's recorded official draggable state back onto it.
+     * @param row - the tracked row element.
+     * @param original - the recorded attribute value, or null when it was absent.
+     */
+    function restoreRowDragState(row, original) {
+        if (original === null)
+            row.removeAttribute('draggable');
+        else
+            row.setAttribute('draggable', original);
+    }
     /**
      * Restore the official draggable state this layer overrode while active.
      * Rows are React-owned and may have been re-created meanwhile, so only the
-     * tracked elements are touched; a detached element is skipped.
+     * tracked elements are touched; a detached element is written back too
+     * (harmless, and it keeps the entry prunable at every tick).
      */
     function restoreRowDrag() {
         if (dragOverridden.size === 0)
             return;
-        for (const [row, original] of dragOverridden) {
-            if (!row.isConnected)
-                continue;
-            if (original === null)
-                row.removeAttribute('draggable');
-            else
-                row.setAttribute('draggable', original);
-        }
+        for (const [row, original] of dragOverridden)
+            restoreRowDragState(row, original);
         dragOverridden.clear();
     }
     /** Restore a dragged position when the whale becomes visible again. */
@@ -680,6 +709,44 @@ export function startMobileAdapt() {
                 row.setAttribute('draggable', 'false');
             }
         }
+        // React replaces rows as the session list re-renders; a detached row can
+        // never be restored by a later revert, so keeping it here would retain the
+        // whole detached subtree (and its children) for the page lifetime. Its
+        // official state goes back on the node itself and the entry is dropped:
+        // a node React re-attaches is recorded again on the next tick.
+        if (dragOverridden.size === 0)
+            return;
+        for (const [row, original] of dragOverridden) {
+            if (row.isConnected)
+                continue;
+            restoreRowDragState(row, original);
+            dragOverridden.delete(row);
+        }
+    }
+    /**
+     * Official nodes resolved through the document and cached while they stay
+     * connected. The sync tick runs every 600ms for the page lifetime, and these
+     * selectors (suffix class matches, :has()) cannot use Blink's fast paths, so
+     * every miss walks the whole mounted DOM — the official chat keeps the whole
+     * conversation mounted, i.e. tens of thousands of elements. React replaces a
+     * node on a major re-render, which the isConnected guard detects.
+     */
+    const nodeCache = new Map();
+    function nodeOf(selector) {
+        const cached = nodeCache.get(selector);
+        if (cached !== undefined && cached.isConnected)
+            return cached;
+        const found = document.querySelector(selector);
+        if (found === null)
+            nodeCache.delete(selector);
+        else
+            nodeCache.set(selector, found);
+        return found;
+    }
+    /** The official application frame, through the same cached lookup. */
+    function frameEl() {
+        const frame = nodeOf(APP_FRAME_SELECTOR);
+        return frame instanceof HTMLElement ? frame : null;
     }
     function syncWhale() {
         // Keep the stylesheet present while the layer is active (the tick runs
@@ -692,8 +759,8 @@ export function startMobileAdapt() {
             whaleEl.style.display = 'none';
             return;
         }
-        const collapsed = appFrame()?.hasAttribute('data-sidebar-collapsed') === true;
-        const overlayUp = document.querySelector('[class$="_overlay"]') !== null;
+        const collapsed = frameEl()?.hasAttribute('data-sidebar-collapsed') === true;
+        const overlayUp = nodeOf('[class$="_overlay"]') !== null;
         const show = collapsed && !overlayUp;
         // Restore on every hidden-to-shown transition — including the very
         // first show on a fresh page load, where the inline display is still
@@ -723,7 +790,7 @@ export function startMobileAdapt() {
     function seatHeaderActions() {
         if (!active)
             return;
-        const header = document.querySelector('[class$="_header"]');
+        const header = nodeOf('[class$="_header"]');
         const tabs = header !== null ? header.querySelector('[class$="_tabs"]') : null;
         const actions = header !== null ? header.querySelector('[class$="_titleCluster"] [class$="_headerActions"]') : null;
         // The actions node is NOT moved: it is a React-owned host node whose badge
@@ -745,7 +812,7 @@ export function startMobileAdapt() {
     function alignActionsText() {
         if (!active)
             return;
-        const header = document.querySelector('[class$="_header"]');
+        const header = nodeOf('[class$="_header"]');
         if (header === null)
             return;
         const tabs = header.querySelector('[class$="_tabs"]');
@@ -775,9 +842,14 @@ export function startMobileAdapt() {
         let dx = translate !== null ? parseFloat(translate[1] ?? '0') : 0;
         let dy = translate !== null ? parseFloat(translate[2] ?? '0') : 0;
         const actionsRect = actions.getBoundingClientRect();
-        const tabsRect = tabs.getBoundingClientRect();
-        // Horizontal: the actions' right edge lands on the tabs row's right edge.
-        const rightDiff = tabsRect.right - actionsRect.right;
+        // Horizontal: the actions' right edge lands on the header's content edge,
+        // NOT on the tabs row's right edge. The row caps its own width against the
+        // reserve below (v80), so anchoring to the row would let the pair walk
+        // leftwards on every measurement.
+        const headerRect = header.getBoundingClientRect();
+        const headerStyle = getComputedStyle(header);
+        const contentRight = headerRect.right - (parseFloat(headerStyle.paddingRight) || 0) - (parseFloat(headerStyle.borderRightWidth) || 0);
+        const rightDiff = contentRight - actionsRect.right;
         if (Math.abs(rightDiff) >= 0.5)
             dx = Math.round((dx + rightDiff) * 10) / 10;
         // Vertical: the actions' text bottom lands on the tab text bottom.
@@ -798,18 +870,27 @@ export function startMobileAdapt() {
         const next = `translate(${dx}px, ${dy}px)`;
         if (actions.style.transform !== next)
             actions.style.transform = next;
-        // Reserve the painted width so the tab labels never slide under it.
+        // Reserve the painted width on the row itself, so the tab labels never
+        // slide under it. The value rides a CSS variable on <html>: React
+        // recreates the row node on re-render, which would drop an inline
+        // reservation until the next sync tick, and until then the labels render
+        // underneath the painted actions.
         const reserve = `${Math.ceil(actionsRect.width) + 8}px`;
-        if (tabs.style.paddingRight !== reserve)
-            tabs.style.paddingRight = reserve;
+        const rootStyle = document.documentElement.style;
+        if (rootStyle.getPropertyValue(HEADER_RESERVE_VAR) !== reserve)
+            rootStyle.setProperty(HEADER_RESERVE_VAR, reserve);
     }
     function unseatHeaderActions() {
         document.body.classList.remove(HEADER_SEATED_CLASS);
+        document.documentElement.style.removeProperty(HEADER_RESERVE_VAR);
         const header = document.querySelector('[class$="_header"]');
         const tabs = header !== null ? header.querySelector('[class$="_tabs"]') : null;
         const actions = header !== null ? header.querySelector('[class$="_titleCluster"] [class$="_headerActions"]') : null;
         if (actions instanceof HTMLElement)
             actions.style.transform = '';
+        // The v67 padding reservation is gone with the v80 cap; clearing it keeps a
+        // profile that hot-updated from an older build from keeping a stale inline
+        // width on the row.
         if (tabs instanceof HTMLElement)
             tabs.style.paddingRight = '';
         if (headerObserver !== null) {
@@ -856,6 +937,12 @@ export function startMobileAdapt() {
         if (isMobilePortrait()) {
             apply();
             ensureWhaleObserver();
+            // A viewport shrink (split-screen, foldable, rotation) can leave the
+            // whale — the only portrait sidebar entry — parked beyond the new right
+            // edge while it stays visible; re-clamp it here. Skipped mid-drag so a
+            // resize cannot yank the button away from the finger.
+            if (active && drag === null)
+                applyWhalePos();
         }
         else {
             revert();
@@ -967,14 +1054,18 @@ export function startMobileAdapt() {
         }
         const t = e.target;
         const editable = t instanceof HTMLElement && t.isContentEditable;
-        if (t instanceof Element && (t.tagName === 'TEXTAREA' || t.tagName === 'INPUT' || editable || t.closest(`#${WHALE_ID}`) !== null || insideHScrollable(t) || t.closest('table, [class$="_table"], [class$="_tablePane"]') !== null)) {
+        if (t instanceof Element && (t.tagName === 'TEXTAREA' || t.tagName === 'INPUT' || editable || t.closest(`#${WHALE_ID}`) !== null || t.closest('table, [class$="_table"], [class$="_tablePane"]') !== null)) {
             swipeTouch = null;
             return;
         }
         const ct = e.changedTouches[0];
         if (ct === undefined)
             return;
-        swipeTouch = { x: ct.clientX, y: ct.clientY, id: ct.identifier };
+        // The horizontally-scrollable veto is judged at release (see touchend):
+        // evaluating it here forced a style recalc plus a synchronous layout on
+        // every tap and scroll-start while the page was dirty, for a gesture that
+        // mostly never becomes a swipe.
+        swipeTouch = { x: ct.clientX, y: ct.clientY, id: ct.identifier, el: t instanceof Element ? t : null };
     }, { capture: true, passive: true });
     document.addEventListener('touchend', (e) => {
         if (swipeTouch === null)
@@ -987,15 +1078,21 @@ export function startMobileAdapt() {
             return;
         const dx = ct.clientX - swipeTouch.x;
         const dy = ct.clientY - swipeTouch.y;
+        const start = swipeTouch;
         swipeTouch = null;
         if (!active)
             return;
         if (Math.abs(dx) < 60 || Math.abs(dx) < Math.abs(dy) * 1.5)
             return;
-        const frame = appFrame();
+        // A gesture that started inside a horizontally scrollable container belongs
+        // to that container, not to the sidebar. Judged now, only for a gesture
+        // that already qualified as a swipe.
+        if (start.el !== null && insideHScrollable(start.el))
+            return;
+        const frame = frameEl();
         if (frame === null)
             return;
-        if (document.querySelector('[class$="_overlay"], [class$="_dialog"], [class$="_menu"], [class*="_portal"]') !== null)
+        if (nodeOf('[class$="_overlay"], [class$="_dialog"], [class$="_menu"], [class*="_portal"]') !== null)
             return;
         const collapsed = frame.hasAttribute('data-sidebar-collapsed');
         if (dx < 0 && !collapsed)
@@ -1156,11 +1253,25 @@ export function startMobileAdapt() {
         return isComposerField(el) ? el : null;
     };
     const lanOrigFocus = HTMLElement.prototype.focus;
-    HTMLElement.prototype.focus = function (options) {
+    const patchedFocus = function (options) {
         if (active && isComposerField(this) && Date.now() - lastComposerTap >= 800)
             return;
         lanOrigFocus.call(this, options);
     };
+    /** (Re-)install the composer-focus guard (see setEnabled). */
+    const installFocusPatch = () => {
+        HTMLElement.prototype.focus = patchedFocus;
+    };
+    /**
+     * Remove the guard when the layer is disabled. A patch another plugin
+     * installed after ours is left alone (identity check), so disabling this
+     * layer never removes someone else's behavior.
+     */
+    const restoreFocusPatch = () => {
+        if (HTMLElement.prototype.focus === patchedFocus)
+            HTMLElement.prototype.focus = lanOrigFocus;
+    };
+    installFocusPatch();
     document.addEventListener('pointerdown', (e) => {
         if (!active)
             return;
@@ -1177,10 +1288,14 @@ export function startMobileAdapt() {
         translate: null,
         setEnabled(on) {
             adaptEnabled = on;
-            if (on)
+            if (on) {
+                installFocusPatch();
                 evaluate();
-            else
+            }
+            else {
                 revert();
+                restoreFocusPatch();
+            }
         },
         flushCloseDetails() {
             // The first apply() ran before any wiring existed, so its

package/lib/types/client/pair-api.d.ts

@@ -39,7 +39,7 @@ export declare function readPairGatePolicy(): Promise<PairGatePolicy>;
 /** accept() refusal codes. */
 export type AcceptFailure = {
     ok: false;
-    code: 'invalid' | 'used' | 'forbidden';
+    code: 'invalid' | 'forbidden';
 };
 /** One auto-tunnel status frame (absent while the feature is off). */
 export interface TunnelStatusFrame {
@@ -116,8 +116,20 @@ export declare function stopPair(): Promise<void>;
  * @param deviceId - the session id of the row to drop.
  */
 export declare function revokePair(deviceId: string): Promise<void>;
-/** Presence heartbeat from a paired phone (unpaired heartbeats 401 harmlessly). */
-export declare function sendHeartbeat(): Promise<void>;
+/**
+ * Presence heartbeat from a paired phone.
+ * @returns the response status, so the caller can stop polling once the server
+ *   proves this page is not paired (see {@link shouldStopHeartbeat}).
+ */
+export declare function sendHeartbeat(): Promise<number>;
+/**
+ * Whether a heartbeat answer means "this page can never be accepted again" and
+ * the 10 s wake source should stop: 401 (unpaired, or the device was revoked)
+ * and 403 (the fence refused it) are permanent for this page, while a network
+ * error or a 5xx is transient and keeps the cadence.
+ * @param status - the heartbeat response status.
+ */
+export declare function shouldStopHeartbeat(status: number): boolean;
 /** Whether the current page URL carries a pairing token. */
 export declare function readPairParams(search: string): {
     pair?: string;
@@ -148,8 +160,25 @@ export interface LanBindFrame {
     /** true when the running bind has not caught up with the toggle yet. */
     pendingRestart?: boolean;
 }
+/** A failed LAN-bind read, carrying the HTTP status when the server answered. */
+export declare class LanBindStatusError extends Error {
+    readonly status: number | undefined;
+    /**
+     * @param status - the response status, or undefined when the request failed
+     *   before a response (network error).
+     * @param message - the diagnostic message.
+     */
+    constructor(status: number | undefined, message: string);
+}
 /** Read the LAN-bind facts (loopback-only endpoint). */
 export declare function readLanBindStatus(): Promise<LanBindFrame>;
+/**
+ * Whether a LAN-bind status failure means this origin can never read the
+ * endpoint (401/403 from the loopback-only fence), so a poll should stop
+ * instead of retrying a known refusal; a transient error keeps the cadence.
+ * @param status - the response status, or undefined for a network failure.
+ */
+export declare function shouldStopLanBindPoll(status: number | undefined): boolean;
 /** Human-readable expiry clock, e.g. "10:35". */
 export declare function formatClock(epochMs: number): string;
 /** Calendar + clock for last-seen timestamps, e.g. "2026-08-19 10:35". */

package/lib/types/client/pair-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pair-api.d.ts","sourceRoot":"","sources":["../../../src/client/pair-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pair-api.d.ts","sourceRoot":"","sources":["../../../src/client/pair-api.ts"],"names":[],"mappings":"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"}

package/lib/types/client/pair-api.js

@@ -57,10 +57,10 @@ export async function acceptPair(token) {
     });
     if (response.ok)
         return { ok: true };
-    if (response.status === 404)
+    // 409 is the legacy "already used" answer a pre-bearer-token host could send;
+    // it means the same thing to the caller as a 404.
+    if (response.status === 404 || response.status === 409)
         return { ok: false, code: 'invalid' };
-    if (response.status === 409)
-        return { ok: false, code: 'used' };
     return { ok: false, code: 'forbidden' };
 }
 /** Revoke mobile access (paired devices + the current token). */
@@ -84,9 +84,24 @@ export async function revokePair(deviceId) {
     if (!response.ok)
         throw new Error(`remote-web-ui: revoke failed with ${String(response.status)}`);
 }
-/** Presence heartbeat from a paired phone (unpaired heartbeats 401 harmlessly). */
+/**
+ * Presence heartbeat from a paired phone.
+ * @returns the response status, so the caller can stop polling once the server
+ *   proves this page is not paired (see {@link shouldStopHeartbeat}).
+ */
 export async function sendHeartbeat() {
-    await fetch('/api/pair/heartbeat', { method: 'POST' });
+    const response = await fetch('/api/pair/heartbeat', { method: 'POST' });
+    return response.status;
+}
+/**
+ * Whether a heartbeat answer means "this page can never be accepted again" and
+ * the 10 s wake source should stop: 401 (unpaired, or the device was revoked)
+ * and 403 (the fence refused it) are permanent for this page, while a network
+ * error or a 5xx is transient and keeps the cadence.
+ * @param status - the heartbeat response status.
+ */
+export function shouldStopHeartbeat(status) {
+    return status === 401 || status === 403;
 }
 /** Whether the current page URL carries a pairing token. */
 export function readPairParams(search) {
@@ -104,13 +119,36 @@ export function stripParam(name) {
     url.searchParams.delete(name);
     return url.search;
 }
+/** A failed LAN-bind read, carrying the HTTP status when the server answered. */
+export class LanBindStatusError extends Error {
+    status;
+    /**
+     * @param status - the response status, or undefined when the request failed
+     *   before a response (network error).
+     * @param message - the diagnostic message.
+     */
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'LanBindStatusError';
+    }
+}
 /** Read the LAN-bind facts (loopback-only endpoint). */
 export async function readLanBindStatus() {
     const response = await fetch('/api/pair/lan-bind');
     if (!response.ok)
-        throw new Error(`remote-web-ui: lan-bind status failed with ${String(response.status)}`);
+        throw new LanBindStatusError(response.status, `remote-web-ui: lan-bind status failed with ${String(response.status)}`);
     return await response.json();
 }
+/**
+ * Whether a LAN-bind status failure means this origin can never read the
+ * endpoint (401/403 from the loopback-only fence), so a poll should stop
+ * instead of retrying a known refusal; a transient error keeps the cadence.
+ * @param status - the response status, or undefined for a network failure.
+ */
+export function shouldStopLanBindPoll(status) {
+    return status === 401 || status === 403;
+}
 /** Human-readable expiry clock, e.g. "10:35". */
 export function formatClock(epochMs) {
     const date = new Date(epochMs);