Import packages/plugin/src/client/account-entry.ts
This commit is contained in:
parent
e9a887b389
commit
eaf43c6397
|
|
@ -0,0 +1,109 @@
|
|||
/**
|
||||
* 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<string>()
|
||||
|
||||
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()
|
||||
}
|
||||
}
|
||||
Loading…
Reference in New Issue