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

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;AAmRD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAw0BvC"}
+{"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

@@ -340,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';
@@ -396,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();
@@ -467,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();
@@ -646,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. */
@@ -700,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
@@ -712,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
@@ -743,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
@@ -765,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"]');
@@ -890,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();
@@ -1001,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)
@@ -1021,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)
@@ -1190,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;
@@ -1211,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);

package/lib/types/client/plugin-card-seat.d.ts

@@ -6,22 +6,24 @@
  *
  * - `web-ui.plugin.item` — the list seat declared by the dsh-web-settings
  *   group section (this family's own first-level "Web UI plugins" section);
- * - `settings.plugin.item` — the official keyed seat of the harness's
- *   `ui-settings-plugins` tab, keyed by the settings namespace the card edits.
+ * - `plugins.bundle.config` — the official keyed seat of the harness's plugin
+ *   manager page, keyed by the bundle's package name and rendered on that
+ *   bundle's page. alpha.2 removed the `settings.plugin.item` keyed seat of the
+ *   `ui-settings-plugins` tab that this helper used before, so a card keyed by
+ *   its settings namespace has no seat to land in any more.
  *
- * SEAT SELECTION IS NOT A DECLARATION PROBE. The official `ui-settings-plugins`
- * row belongs to the harness bundle and its `configurable` tab always declares
- * `settings.plugin.item` before any external plugin's `apply()` runs, so
- * "is the official seat declared?" answers yes even in the deployment whose
- * whole point is the family group. Choosing on that probe sends every family
- * card to the official Plugins tab and leaves the group's own section
- * permanently empty — the family of reports where the section renders its
- * heading and zero cards.
+ * SEAT SELECTION IS NOT A DECLARATION PROBE. The official plugin surface
+ * belongs to the harness bundle and declares its seats before any external
+ * plugin's `apply()` runs, so "is the official seat declared?" answers yes even
+ * in the deployment whose whole point is the family group. Choosing on that
+ * probe sends every family card to the official page and leaves the group's own
+ * section permanently empty — the family of reports where the section renders
+ * its heading and zero cards.
  *
  * The signal that actually distinguishes the two deployments is whether
  * dsh-web-settings is loaded: it is the package that owns the group section and
  * it publishes the `webUiSettings` service during `apply()`, which every
- * family plugin already reads for its settings scope. Group loaded -> the family
+ * family plugin already reads for its settings form. Group loaded -> the family
  * seat; group absent -> the official seat.
  *
  * The decision is re-evaluated on every `slots/changed` because the group may
@@ -37,8 +39,8 @@
  */
 /** The family list seat key. */
 export declare const FAMILY_PLUGIN_CARD_SEAT = "web-ui.plugin.item";
-/** The official keyed plugin-card seat key. */
-export declare const OFFICIAL_PLUGIN_CARD_SEAT = "settings.plugin.item";
+/** The official keyed plugin-card seat key (the alpha.2 bundle-configuration seat). */
+export declare const OFFICIAL_PLUGIN_CARD_SEAT = "plugins.bundle.config";
 /** The service dsh-web-settings publishes while it is loaded. */
 export declare const FAMILY_GROUP_SERVICE = "webUiSettings";
 /** The slot-registry member this helper uses (structurally satisfied by ctx.slots). */
@@ -54,15 +56,20 @@ export interface PluginCardContext {
     /** Event subscription seat; absent on an event-less test double. */
     on?(event: string, listener: (...args: never[]) => void): unknown;
 }
-/** Owner share of a plugin card (both seats supply nothing). */
+/** Owner share of a family list-seat card (that seat supplies nothing). */
 export interface SettingsPluginItemOwnerProps {
     /** Marker field: card owner props are intentionally empty. */
     children?: never;
 }
 /** One family plugin's card contribution. */
 export interface PluginCardSeat {
-    /** Settings namespace the card edits (the official seat's dispatch key). */
-    namespace: string;
+    /**
+     * Npm package name of the bundle this card configures; the official keyed
+     * seat dispatches on it. Every family package ships its own bundle patch, so
+     * a standalone install lists that package as the bundle whose page renders
+     * this card.
+     */
+    bundle: string;
     /** Family list-seat entry id. */
     id: string;
     /** Family list-seat sort order. */

package/lib/types/client/plugin-card-seat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-card-seat.d.ts","sourceRoot":"","sources":["../../../src/client/plugin-card-seat.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,gCAAgC;AAChC,eAAO,MAAM,uBAAuB,uBAAuB,CAAA;AAE3D,+CAA+C;AAC/C,eAAO,MAAM,yBAAyB,yBAAyB,CAAA;AAE/D,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,kBAAkB,CAAA;AAEnD,uFAAuF;AACvF,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,GAAG,OAAO,CAAA;CACpD;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,CAAA;IACtB,6EAA6E;IAC7E,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3B,oEAAoE;IACpE,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,OAAO,CAAA;CAClE;AAED,gEAAgE;AAChE,MAAM,WAAW,4BAA4B;IAC3C,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,KAAK,CAAA;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;IACpB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;IACrB;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAUjE;AAWD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CA4DpF"}
+{"version":3,"file":"plugin-card-seat.d.ts","sourceRoot":"","sources":["../../../src/client/plugin-card-seat.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,gCAAgC;AAChC,eAAO,MAAM,uBAAuB,uBAAuB,CAAA;AAE3D,uFAAuF;AACvF,eAAO,MAAM,yBAAyB,0BAA0B,CAAA;AAEhE,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,kBAAkB,CAAA;AAEnD,uFAAuF;AACvF,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,GAAG,OAAO,CAAA;CACpD;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,CAAA;IACtB,6EAA6E;IAC7E,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3B,oEAAoE;IACpE,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,OAAO,CAAA;CAClE;AAED,2EAA2E;AAC3E,MAAM,WAAW,4BAA4B;IAC3C,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,KAAK,CAAA;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;IACpB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;IACrB;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAUjE;AAWD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CA4DpF"}

package/lib/types/client/plugin-card-seat.js

@@ -7,22 +7,24 @@
  *
  * - `web-ui.plugin.item` — the list seat declared by the dsh-web-settings
  *   group section (this family's own first-level "Web UI plugins" section);
- * - `settings.plugin.item` — the official keyed seat of the harness's
- *   `ui-settings-plugins` tab, keyed by the settings namespace the card edits.
+ * - `plugins.bundle.config` — the official keyed seat of the harness's plugin
+ *   manager page, keyed by the bundle's package name and rendered on that
+ *   bundle's page. alpha.2 removed the `settings.plugin.item` keyed seat of the
+ *   `ui-settings-plugins` tab that this helper used before, so a card keyed by
+ *   its settings namespace has no seat to land in any more.
  *
- * SEAT SELECTION IS NOT A DECLARATION PROBE. The official `ui-settings-plugins`
- * row belongs to the harness bundle and its `configurable` tab always declares
- * `settings.plugin.item` before any external plugin's `apply()` runs, so
- * "is the official seat declared?" answers yes even in the deployment whose
- * whole point is the family group. Choosing on that probe sends every family
- * card to the official Plugins tab and leaves the group's own section
- * permanently empty — the family of reports where the section renders its
- * heading and zero cards.
+ * SEAT SELECTION IS NOT A DECLARATION PROBE. The official plugin surface
+ * belongs to the harness bundle and declares its seats before any external
+ * plugin's `apply()` runs, so "is the official seat declared?" answers yes even
+ * in the deployment whose whole point is the family group. Choosing on that
+ * probe sends every family card to the official page and leaves the group's own
+ * section permanently empty — the family of reports where the section renders
+ * its heading and zero cards.
  *
  * The signal that actually distinguishes the two deployments is whether
  * dsh-web-settings is loaded: it is the package that owns the group section and
  * it publishes the `webUiSettings` service during `apply()`, which every
- * family plugin already reads for its settings scope. Group loaded -> the family
+ * family plugin already reads for its settings form. Group loaded -> the family
  * seat; group absent -> the official seat.
  *
  * The decision is re-evaluated on every `slots/changed` because the group may
@@ -38,8 +40,8 @@
  */
 /** The family list seat key. */
 export const FAMILY_PLUGIN_CARD_SEAT = 'web-ui.plugin.item';
-/** The official keyed plugin-card seat key. */
-export const OFFICIAL_PLUGIN_CARD_SEAT = 'settings.plugin.item';
+/** The official keyed plugin-card seat key (the alpha.2 bundle-configuration seat). */
+export const OFFICIAL_PLUGIN_CARD_SEAT = 'plugins.bundle.config';
 /** The service dsh-web-settings publishes while it is loaded. */
 export const FAMILY_GROUP_SERVICE = 'webUiSettings';
 /**
@@ -113,7 +115,7 @@ export function installPluginCard(ctx, seat) {
                 }
                 : {
                     name: OFFICIAL_PLUGIN_CARD_SEAT,
-                    key: seat.namespace,
+                    key: seat.bundle,
                     locale: seat.locale,
                     ...(seat.inject === undefined ? {} : { inject }),
                 }), component);

package/lib/types/client/remote-channel.d.ts.map

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