/** * Anchoring for the Compact sidebar entry. * * The host shell exposes no slot at the end of the account row (only * `sidebar.settings` and `sidebar.footer.action`), so the Compact entry is * portalled into the settings row DOM. Native DSH renders that row as * ui-settings-general's `triggerRow`. DS-Bot 0.3.2+ disables that shell and * replaces it with its own `.bt-settings-row`, so anchoring has to accept both. * Rows that are not laid out are skipped, and a missing anchor is reported once * instead of leaving the saved style looking applied while it silently fell * back to the Standard entry. */ const NATIVE_ROW_SELECTOR = '[class*="settingsArea"] [class*="triggerRow"]' const DS_BOT_ROW_SELECTOR = '[class*="settingsArea"] .bt-settings-row' /** Anchor candidates in preference order: native DSH row, then DS-Bot's. */ export const accountRowSelectors = [NATIVE_ROW_SELECTOR, DS_BOT_ROW_SELECTOR] as const /** Retry cadence while the sidebar footer is still mounting. */ export const accountRowRetry = { intervalMs: 50, attempts: 40 } as const const MISSING_ANCHOR_WARNING = 'ds-harness-remote: Compact sidebar entry found no account row ' + '([class*="settingsArea"] [class*="triggerRow"] or [class*="settingsArea"] .bt-settings-row). ' + 'This host/DS-Bot combination exposes no Compact slot; the Standard entry stays in the sidebar footer.' const warned = new Set() function reportMissingAnchor(): void { if (warned.has(MISSING_ANCHOR_WARNING)) return warned.add(MISSING_ANCHOR_WARNING) console.warn(MISSING_ANCHOR_WARNING) } /** A hidden row (collapsed sidebar, closed settings shell) is not an anchor. */ function isLaidOut(row: Element): boolean { return typeof row.getClientRects !== 'function' || row.getClientRects().length > 0 } /** First laid-out account row under `root`, preferring the native DSH row. */ export function findAccountRow(root: ParentNode): HTMLElement | null { for (const selector of accountRowSelectors) { for (const row of Array.from(root.querySelectorAll(selector))) { if (isLaidOut(row)) return row as HTMLElement } } return null } /** * Keeps one host node at the end of the account row and reports where it lives. * The host and DS-Bot re-render their rows without React knowing about this * node, and a full remount replaces the row, so every DOM change re-resolves the * anchor and moves the same node instead of adding another. `attach` receives * the node once it is in the document and `null` whenever no row is available, * so the caller can keep the Standard entry as a working fallback. */ export function mountAccountEntry(attach: (container: HTMLElement | null) => void): () => void { let attempt = 0 let timer: number | undefined let host: HTMLElement | undefined let attached = false let observer: MutationObserver | undefined const sync = (): void => { if (timer !== undefined) { window.clearTimeout(timer) timer = undefined } const row = findAccountRow(document) if (row === null) { // A portal into a detached node would leave no visible entry at all, so // hand the slot back to the Standard entry while the row is gone. if (attached) { attached = false attach(null) } // The row mounts with the footer area; give the host a moment before // settling for the Standard entry. if (attempt < accountRowRetry.attempts) { attempt += 1 timer = window.setTimeout(sync, accountRowRetry.intervalMs) } else { reportMissingAnchor() } return } attempt = 0 if (host === undefined) host = document.createElement('span') // Re-append only when the node is actually missing: an unconditional append // would duplicate the entry on every unrelated re-render of the row. if (host.parentElement !== row || !host.isConnected) row.append(host) if (!attached) { attached = true attach(host) } if (observer === undefined && document.body !== null) { // Skip the lookup for the common case: a re-render somewhere else in the // app while the entry is still in a live account row. observer = new MutationObserver(() => { if (!attached || host?.isConnected !== true) sync() }) observer.observe(document.body, { childList: true, subtree: true }) } } sync() return () => { if (timer !== undefined) window.clearTimeout(timer) observer?.disconnect() host?.remove() } }