"use client"; import { useEffect } from 'react'; import { useConfig } from '@/hooks/use-config'; import { useIsFocusedProTab, usePaneId } from '@/hooks/use-pane-context'; import { useAccountStore } from '@/stores/account-store'; import { formatTabTitle } from '@/lib/tab-title'; // The surface that set the title last owns it. One that is still mounted // (during a route transition) stops re-applying, so two titles never fight. let owner: symbol | null = null; /** * Sets the browser-tab title for a surface: " - - " * (see formatTabTitle). Pass a context that is already localized, or nothing * for a surface that has nothing to add. * * Next renders the root layout's metadata again on every client-side * navigation, after the new surface has mounted, which puts the bare app name * back. So the title is re-applied whenever <head> changes and it is not ours. */ export function useDocumentTitle(context?: string | null): void { const { appName } = useConfig(); // The account actually in view, so two windows on two accounts stay apart. const account = useAccountStore( (s) => s.accounts.find((a) => a.id === s.activeAccountId)?.email || null, ); const title = formatTabTitle(context, account, appName); // The Pro shell keeps every opened tab mounted (hidden), so only the // focused tab may claim the title; outside Pro every surface is in view. const paneId = usePaneId(); const focusedProTab = useIsFocusedProTab(); const inView = paneId === null || focusedProTab; useEffect(() => { if (!inView) return; const self = Symbol('document-title'); owner = self; // Setting the title is itself a <head> mutation. The browser reads it // back with its whitespace stripped and collapsed (HTML's "strip and // collapse ASCII whitespace"), so a subject with two spaces in a row // never reads back as written. Comparing with what it read back after // our own write ends the round; without that, every write set off the // observer again, an endless loop that froze the tab. let readBack: string | null = null; const apply = () => { if (owner !== self) return; const current = document.title; if (current === title || current === readBack) return; document.title = title; readBack = document.title; }; apply(); const observer = new MutationObserver(apply); observer.observe(document.head, { childList: true, subtree: true, characterData: true }); return () => { observer.disconnect(); if (owner === self) owner = null; }; }, [title, inView]); }