// Relabel the page-context-menu CTA from "Copy page" to "Copy". // Mintlify hardcodes the label, so we rewrite the text nodes and keep the // "Copying..." / "Copied" feedback states untouched. The button also contains // an invisible width-reserving span with the same text, so we rewrite both. (() => { const FROM = "Copy page"; const TO = "Copy"; const relabel = () => { const button = document.querySelector("#page-context-menu-button"); if (!button) return; for (const span of button.querySelectorAll("span")) { const node = span.firstChild; // Edit the text node in place so React's re-renders ("Copying...", // "Copied") still target the node it owns. if (node?.nodeType === Node.TEXT_NODE && node.nodeValue.trim() === FROM) { node.nodeValue = TO; } } }; const observer = new MutationObserver(relabel); observer.observe(document.body, { childList: true, subtree: true, characterData: true }); relabel(); })(); // Fire once per client navigation without observing the whole document. (() => { if (window.__changelogNavPatched) return; window.__changelogNavPatched = true; const syncRouteClasses = () => { const currentPath = location.pathname.replace(/\/+$/, "") || "/"; const onChangelog = currentPath === "/changelog" || currentPath.startsWith("/changelog/"); const isIndex = currentPath === "/changelog" || currentPath === "/changelog/index"; document.documentElement.classList.toggle("on-changelog", onChangelog); document.documentElement.classList.toggle("changelog-index-page", onChangelog && isIndex); document.documentElement.classList.toggle("changelog-article-page", onChangelog && !isIndex); }; const notify = () => { syncRouteClasses(); window.dispatchEvent(new Event("changelog:nav")); }; const wrap = (key) => { const orig = history[key].bind(history); history[key] = (...args) => { const ret = orig(...args); notify(); return ret; }; }; wrap("pushState"); wrap("replaceState"); window.addEventListener("popstate", notify); syncRouteClasses(); })(); // Changelog months: Mintlify's nested groups navigate to the first page on // expand. Intercept month toggles and open/close locally so the current page // (index or article) never changes. (() => { // Mintlify re-injects scripts.js on client navigations. Version + abort so // updated soft-nav logic replaces the previous capture listener. const PATCH = 4; if (window.__changelogMonthTogglePatched === PATCH) return; window.__changelogMonthAbort?.abort(); window.__changelogMonthAbort = new AbortController(); const { signal } = window.__changelogMonthAbort; window.__changelogMonthTogglePatched = PATCH; const MONTH_NAMES = [ "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December", ]; const MONTHS = new Set(MONTH_NAMES); const norm = (p) => (p || "/").replace(/\/+$/, "") || "/"; const onChangelog = () => { const p = norm(location.pathname); return p === "/changelog" || p.startsWith("/changelog/"); }; const monthLabel = (btn) => (btn.querySelector("span")?.textContent || btn.textContent || "").trim(); const monthButtons = () => [...document.querySelectorAll("#navigation-items button[aria-expanded]")].filter((btn) => MONTHS.has(monthLabel(btn)), ); const readCatalog = () => { const el = document.getElementById("changelog-catalog"); if (!el) return []; try { return JSON.parse(el.textContent); } catch { return []; } }; const yearForButton = (btn) => { const headers = [ ...document.querySelectorAll("#navigation-items .sidebar-group-header .sidebar-title"), ]; let latestYear = ""; for (const header of headers) { const text = header.textContent.trim(); if (/^\d{4}$/.test(text)) latestYear = text; const section = header.closest("[class*='sidebar-group']") || header.parentElement?.parentElement?.parentElement || header.parentElement?.parentElement; if (latestYear && section?.contains(btn)) return latestYear; } // Document-order fallback: last year header before this button. let year = ""; for (const header of headers) { const text = header.textContent.trim(); if (!/^\d{4}$/.test(text)) continue; if (header.compareDocumentPosition(btn) & Node.DOCUMENT_POSITION_FOLLOWING) { year = text; } } return year; }; const entriesForButton = (btn) => { const month = monthLabel(btn); const year = yearForButton(btn); const monthIndex = MONTH_NAMES.indexOf(month) + 1; if (!year || monthIndex < 1) return []; const prefix = `${year}-${String(monthIndex).padStart(2, "0")}`; return readCatalog().filter((entry) => entry.date.startsWith(prefix)); }; const sampleLink = () => document.querySelector( '#navigation-items a[href^="/changelog/"]:not([data-changelog-built])', ) || document.querySelector('#navigation-items a[href^="/changelog/"]'); const syncChevron = (btn, open) => { const svg = btn.querySelector("svg"); if (!svg) return; svg.classList.toggle("duration-75", open); svg.classList.toggle("rotate-90", open); svg.classList.remove("-rotate-90", "rotate-180"); }; const ACTIVE_LINK_CLASSES = [ "bg-primary/10", "text-primary", "[text-shadow:-0.2px_0_0_currentColor,0.2px_0_0_currentColor]", "dark:text-primary-light", "dark:bg-primary-light/10", ]; const INACTIVE_LINK_CLASSES = [ "hover:bg-gray-600/5", "dark:hover:bg-gray-200/5", "text-gray-700", "hover:text-gray-900", "dark:text-gray-400", "dark:hover:text-gray-300", ]; const softNavigate = (href) => { const target = norm(href); if (!target || norm(location.pathname) === target) return; prefetchPath(target); try { if (window.next?.router?.push) { window.next.router.push(target); return; } } catch { /* fall through */ } location.assign(target); }; const prefetchPath = (href) => { try { window.next?.router?.prefetch?.(norm(href)); } catch { /* ignore */ } }; const markLinkActive = (a, active) => { a.classList.remove(...ACTIVE_LINK_CLASSES, ...INACTIVE_LINK_CLASSES); const stale = []; for (const c of a.classList) { if (c.includes("bg-primary") || c === "text-primary" || c.startsWith("[text-shadow")) { stale.push(c); } } if (stale.length) a.classList.remove(...stale); if (active) { a.setAttribute("aria-current", "page"); a.dataset.active = "true"; a.classList.add(...ACTIVE_LINK_CLASSES); } else { a.removeAttribute("aria-current"); delete a.dataset.active; a.classList.add(...INACTIVE_LINK_CLASSES); } }; const syncActiveInPanel = (ul) => { const current = norm(location.pathname); for (const a of ul.querySelectorAll('a[href^="/changelog/"]')) { const active = norm(a.getAttribute("href")) === current; // Only rewrite classes on anchors we created. Mintlify owns the rest — // class thrashing there remounts the rail and flashes white. if (a.dataset.changelogBuilt) { markLinkActive(a, active); continue; } if (active) { a.setAttribute("aria-current", "page"); a.dataset.active = "true"; } else { a.removeAttribute("aria-current"); delete a.dataset.active; } } }; const panelForButton = (btn) => { const li = btn.parentElement; if (!li) return null; return ( li.querySelector(":scope > ul") || [...li.children].find((child) => child.tagName === "UL") || null ); }; const buildLink = (entry, proto) => { const current = norm(location.pathname); const href = `/changelog/${entry.slug}`; const isActive = current === href; let a; if (proto) { a = proto.cloneNode(true); a.href = href; a.removeAttribute("aria-current"); delete a.dataset.active; a.className = proto.className .split(/\s+/) .filter( (c) => c && !c.includes("bg-primary") && !ACTIVE_LINK_CLASSES.includes(c) && !INACTIVE_LINK_CLASSES.includes(c), ) .join(" "); a.style.paddingLeft = proto.style.paddingLeft || "1.75rem"; const titleSpan = [...a.querySelectorAll("span")].at(-1); if (titleSpan) titleSpan.textContent = entry.title; else a.textContent = entry.title; } else { a = document.createElement("a"); a.href = href; a.className = "group flex items-start pr-3 py-1.5 cursor-pointer gap-x-3 text-left focus-visible:-outline-offset-2 rounded-xl w-full outline-offset-[-1px]"; a.style.paddingLeft = "1.75rem"; a.innerHTML = '

' + '

' + "

"; a.querySelector("span").textContent = entry.title; } a.dataset.changelogBuilt = "true"; a.classList.add("changelog-month-link"); markLinkActive(a, isActive); return a; }; const buildList = (btn, entries) => { const ul = document.createElement("ul"); ul.className = "space-y-px"; ul.dataset.changelogMonthPanel = "true"; const proto = sampleLink(); for (const entry of entries) { const li = document.createElement("li"); li.appendChild(buildLink(entry, proto)); ul.appendChild(li); prefetchPath(`/changelog/${entry.slug}`); } return ul; }; const setExpanded = (btn, open) => { const wasOpen = btn.getAttribute("aria-expanded") === "true"; btn.setAttribute("aria-expanded", open ? "true" : "false"); syncChevron(btn, open); const li = btn.parentElement; if (!li) return; const existing = panelForButton(btn); if (!open) { existing?.remove(); return; } // Already open with links: keep the DOM (avoids white flash / React remount). if (wasOpen && existing?.querySelector('a[href^="/changelog/"]')) { syncActiveInPanel(existing); return; } // Reuse Mintlify's native list when present; only sync selection. if (existing?.querySelector('a[href^="/changelog/"]')) { existing.dataset.changelogMonthPanel = "true"; syncActiveInPanel(existing); for (const a of existing.querySelectorAll('a[href^="/changelog/"]')) { prefetchPath(a.getAttribute("href")); } return; } const entries = entriesForButton(btn); if (entries.length === 0) return; const panel = buildList(btn, entries); if (existing) existing.replaceWith(panel); else li.appendChild(panel); }; const toggleMonth = (btn) => { const open = btn.getAttribute("aria-expanded") === "true"; setExpanded(btn, !open); }; document.addEventListener( "click", (event) => { if (!onChangelog()) return; if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return; if (typeof event.button === "number" && event.button !== 0) return; const btn = event.target.closest?.("#navigation-items button"); if (btn && MONTHS.has(monthLabel(btn))) { event.preventDefault(); event.stopImmediatePropagation(); toggleMonth(btn); return; } // Soft-nav changelog links so we never full-document reload (white flash). const link = event.target.closest?.( [ "a[data-changelog-built]", "a.changelog-month-link", "a.changelog-pager__link", "a.changelog-crumb__link", "a.changelog-crumb__current", ".changelog-index a[href^='/changelog/']", "#navigation-items a[href^='/changelog/']", ].join(", "), ); if (!link) return; const href = link.getAttribute("href"); if (!href || !href.startsWith("/changelog")) return; event.preventDefault(); event.stopImmediatePropagation(); softNavigate(href); }, { capture: true, signal }, ); // Index: all months collapsed. Detail: open only the month for the current entry. let appliedForPath = null; const currentSlug = () => { const p = norm(location.pathname); const match = p.match(/^\/changelog\/([^/]+)$/); if (!match || match[1] === "index") return null; return match[1]; }; const applySidebarState = () => { if (!onChangelog()) return false; const buttons = monthButtons(); if (buttons.length === 0) return false; const slug = currentSlug(); if (!slug) { buttons.forEach((btn) => { if (btn.getAttribute("aria-expanded") === "true") setExpanded(btn, false); }); return true; } // Wait for the catalog so we know which month owns this entry. if (readCatalog().length === 0) return false; buttons.forEach((btn) => { const owns = entriesForButton(btn).some((entry) => entry.slug === slug); const isOpen = btn.getAttribute("aria-expanded") === "true"; if (owns) { setExpanded(btn, true); for (const entry of entriesForButton(btn)) { prefetchPath(`/changelog/${entry.slug}`); } } else if (isOpen) { setExpanded(btn, false); } }); return true; }; const prefetchCatalog = () => { for (const entry of readCatalog()) { if (entry?.slug) prefetchPath(`/changelog/${entry.slug}`); } }; const scheduleSidebarState = () => { const p = norm(location.pathname); if (appliedForPath === p) return; const run = () => { if (appliedForPath === norm(location.pathname)) return; if (applySidebarState()) { appliedForPath = norm(location.pathname); prefetchCatalog(); } }; requestAnimationFrame(() => { run(); window.setTimeout(run, 50); window.setTimeout(run, 200); window.setTimeout(run, 500); }); }; window.addEventListener( "changelog:nav", () => { if (appliedForPath !== norm(location.pathname)) appliedForPath = null; scheduleSidebarState(); }, { signal }, ); scheduleSidebarState(); })(); // Changelog: native Mintlify sidebar (no React DOM rewrites). Overlay eyebrow. (() => { const PATCH = 12; if (window.__changelogOverlayPatched === PATCH) return; window.__changelogOverlayAbort?.abort(); window.__changelogOverlayAbort = new AbortController(); const { signal } = window.__changelogOverlayAbort; window.__changelogOverlayPatched = PATCH; const OVERLAY_ID = "changelog-crumb-overlay"; const dateFormatter = new Intl.DateTimeFormat("en-US", { day: "numeric", month: "long", timeZone: "UTC", year: "numeric", }); let pendingArticleCrumb = null; let overlayElement = document.getElementById(OVERLAY_ID); const path = () => location.pathname.replace(/\/+$/, "") || "/"; const onChangelogPage = () => { const p = path(); return p === "/changelog" || p.startsWith("/changelog/"); }; const onIndexPage = () => { const p = path(); return p === "/changelog" || p === "/changelog/index"; }; const catalogEntries = () => { const el = document.getElementById("changelog-catalog"); if (!el) return []; try { return JSON.parse(el.textContent); } catch { return []; } }; const catalogCrumb = (pathname) => { const slug = pathname.match(/^\/changelog\/([^/]+)$/)?.[1]; if (!slug) return null; const entry = catalogEntries().find((candidate) => candidate.slug === slug); if (!entry?.date) return null; const parsedDate = new Date(`${entry.date}T00:00:00Z`); if (Number.isNaN(parsedDate.getTime())) return null; return { pathname, date: entry.date, dateText: dateFormatter.format(parsedDate), indexHref: `/changelog#${entry.slug}`, }; }; const articleRail = (pathname) => document.querySelector(`.changelog-rail[data-path="${CSS.escape(pathname)}"]`); const overlay = () => overlayElement; const ensureOverlay = () => { let el = overlay(); if (el) return el; el = document.createElement("div"); el.id = OVERLAY_ID; el.hidden = true; document.body.appendChild(el); overlayElement = el; return el; }; const attachOverlay = (el) => { const header = document.querySelector("#header"); if (header && el.parentElement !== header) header.appendChild(el); }; const positionOverlay = () => { const el = overlay(); const header = document.querySelector("#header"); const eyebrow = document.querySelector("#header .eyebrow"); if (!el || el.hidden || !header || !eyebrow) return; attachOverlay(el); const headerRect = header.getBoundingClientRect(); const eyebrowRect = eyebrow.getBoundingClientRect(); el.style.left = `${eyebrowRect.left - headerRect.left}px`; el.style.top = `${eyebrowRect.top - headerRect.top}px`; el.style.height = `${eyebrowRect.height}px`; }; const setArticleCrumb = (el, dateText, indexHref) => { if (!indexHref) return; const current = el.querySelector(".changelog-crumb__current"); if ( current && current.textContent === dateText && current.getAttribute("href") === indexHref && el.querySelector(".changelog-crumb__link") ) { return; } el.className = "changelog-crumb"; el.replaceChildren(); const nav = document.createElement("nav"); nav.setAttribute("aria-label", "Breadcrumb"); const link = document.createElement("a"); link.className = "changelog-crumb__link"; link.href = "/changelog"; link.textContent = "Changelog"; const sep = document.createElement("span"); sep.className = "changelog-crumb__sep"; sep.setAttribute("aria-hidden", "true"); sep.textContent = " / "; const currentEl = document.createElement("a"); currentEl.className = "changelog-crumb__current"; currentEl.href = indexHref; currentEl.textContent = dateText; nav.append(link, sep, currentEl); el.appendChild(nav); }; const hideDuplicateIntro = () => { const desc = document.querySelector("#header .prose p")?.textContent?.trim(); if (!desc) return; for (const node of document.querySelectorAll( ".mdx-content > :not(.changelog-rail):not(.hero-image):not(h2):not(figure)", )) { if (node.textContent.trim() === desc) { node.hidden = true; break; } } }; const attachIndexElements = () => { const index = document.querySelector(".changelog-index"); const el = document.getElementById("changelog-catalog"); if (!index || !el) return false; // Month dividers are authored in MDX so first paint is stable. Only // backfill if a future edit omitted the class. if (index.querySelector(".flush__day--month-start")) return true; let entries = []; try { entries = JSON.parse(el.textContent); } catch { return false; } if (entries.length === 0) return false; entries.sort((a, b) => (a.date < b.date ? 1 : a.date > b.date ? -1 : 0)); let prevMonth = ""; let prevDate = ""; const seenDays = new Set(); for (const entry of entries) { const day = document.querySelector( `.changelog-index .flush__day[data-date="${CSS.escape(entry.date)}"]`, ) || document.getElementById(entry.slug) || document.querySelector(`.changelog-index .flush__day#${CSS.escape(entry.slug)}`); if (!day || seenDays.has(day)) continue; seenDays.add(day); const monthKey = entry.date.slice(0, 7); day.classList.toggle("flush__day--month-start", Boolean(prevMonth) && monthKey !== prevMonth); prevMonth = monthKey; const dateEl = day.querySelector(".flush__date"); const dayId = `day-${entry.date}`; if (dateEl) { if (entry.date !== prevDate) dateEl.id = dayId; else if (dateEl.id === dayId) dateEl.removeAttribute("id"); } prevDate = entry.date; } return seenDays.size > 0; }; const mountDividers = () => { if (location.hostname !== "localhost" && location.hostname !== "127.0.0.1") { document.querySelector(".changelog-divider-toggle")?.remove(); return false; } const DIV_KEY = "changelog-dividers"; const DIV_CLASS = "changelog-index-no-dividers"; const index = document.querySelector(".changelog-index"); if (!index) return false; // Hover is locked to the text-hover defaults; drop old toggle rows / sticky prefs. localStorage.removeItem("changelog-text-hover"); localStorage.removeItem("changelog-h1-hover"); document.body.classList.remove("changelog-index-no-text-hover", "changelog-index-no-h1-hover"); let panel = document.querySelector(".changelog-divider-toggle"); if ( panel && panel.querySelector('input[data-toggle="text-hover"], input[data-toggle="h1-hover"]') ) { panel.remove(); panel = null; } if (!panel) { panel = document.createElement("div"); panel.className = "changelog-divider-toggle"; document.body.appendChild(panel); panel.addEventListener("change", (event) => { const input = event.target; if (!(input instanceof HTMLInputElement)) return; if (input.dataset.toggle !== "dividers") return; const on = input.checked; localStorage.setItem(DIV_KEY, on ? "on" : "off"); document.body.classList.toggle(DIV_CLASS, !on); }); } let divInput = panel.querySelector('input[data-toggle="dividers"]'); if (!divInput) { const row = document.createElement("label"); row.className = "changelog-divider-toggle__row"; row.innerHTML = 'Dividers' + ''; panel.appendChild(row); divInput = row.querySelector("input"); } const dividersOn = localStorage.getItem(DIV_KEY) !== "off"; document.body.classList.toggle(DIV_CLASS, !dividersOn); if (divInput) divInput.checked = dividersOn; return true; }; const setupIndex = () => { if (!onIndexPage()) return true; const days = document.querySelectorAll(".changelog-index .flush__day"); if (!document.querySelector(".changelog-index") || days.length === 0) { return false; } const attached = attachIndexElements(); mountDividers(); return attached; }; let indexSetupTimer = null; const scheduleIndexSetup = () => { if (indexSetupTimer) { window.clearTimeout(indexSetupTimer); indexSetupTimer = null; } if (!onIndexPage()) return; let attempts = 0; const run = () => { attempts += 1; if (setupIndex() || attempts >= 40) { indexSetupTimer = null; return; } indexSetupTimer = window.setTimeout(run, attempts < 10 ? 50 : 150); }; requestAnimationFrame(run); }; // React can replace the feed after our first pass — re-apply markers when it does. if (!window.__changelogIndexObs) { let debounce = null; window.__changelogIndexObs = new MutationObserver(() => { if (!onIndexPage()) return; if (debounce) window.clearTimeout(debounce); debounce = window.setTimeout(() => { if (onIndexPage()) setupIndex(); }, 60); }); window.__changelogIndexObs.observe(document.body, { childList: true, subtree: true, }); } const place = () => { const currentPath = path(); const onChangelog = onChangelogPage(); const isIndexPath = onIndexPage(); const isArticlePath = onChangelog && !isIndexPath; const rail = isArticlePath && articleRail(currentPath); const el = ensureOverlay(); document.documentElement.classList.toggle("on-changelog", onChangelog); document.documentElement.classList.toggle("changelog-index-page", isIndexPath); document.documentElement.classList.toggle("changelog-article-page", isArticlePath); if (!onChangelog) { pendingArticleCrumb = null; el.hidden = true; el.replaceChildren(); document.querySelector(".changelog-divider-toggle")?.remove(); document.body.classList.remove("changelog-index-no-dividers"); if (indexSetupTimer) { window.clearTimeout(indexSetupTimer); indexSetupTimer = null; } return; } attachOverlay(el); if (isIndexPath) { pendingArticleCrumb = null; el.hidden = true; scheduleIndexSetup(); return; } if (indexSetupTimer) { window.clearTimeout(indexSetupTimer); indexSetupTimer = null; } document.querySelector(".changelog-divider-toggle")?.remove(); if (rail) { const crumb = catalogCrumb(currentPath); if (!crumb) return; pendingArticleCrumb = null; el.hidden = false; setArticleCrumb(el, rail.textContent.trim(), crumb.indexHref); hideDuplicateIntro(); positionOverlay(); return; } el.hidden = false; if (pendingArticleCrumb?.pathname === currentPath) { setArticleCrumb(el, pendingArticleCrumb.dateText, pendingArticleCrumb.indexHref); positionOverlay(); } // SPA gap: keep the destination breadcrumb until the article rail exists. }; const onNav = () => { pendingArticleCrumb = catalogCrumb(path()); requestAnimationFrame(() => { place(); requestAnimationFrame(place); }); }; window.__changelogOverlayObserver?.disconnect(); let overlaySyncScheduled = false; window.__changelogOverlayObserver = new MutationObserver(() => { if (!onChangelogPage() || onIndexPage() || overlaySyncScheduled) return; overlaySyncScheduled = true; requestAnimationFrame(() => { overlaySyncScheduled = false; place(); }); }); window.__changelogOverlayObserver.observe(document.body, { childList: true, subtree: true, }); window.addEventListener("changelog:nav", onNav, { signal }); window.addEventListener("resize", positionOverlay, { signal }); document.addEventListener( "click", (event) => { const link = event.target.closest?.("a[href^='/changelog']"); if (!link) return; const targetPath = new URL(link.href, location.href).pathname.replace(/\/+$/, "") || "/"; pendingArticleCrumb = catalogCrumb(targetPath); document.documentElement.classList.add("on-changelog"); if ( link.getAttribute("href") === "/changelog" || link.getAttribute("href") === "/changelog/" ) { document.documentElement.classList.add("changelog-index-page"); } }, { capture: true, signal }, ); place(); window.setTimeout(place, 0); window.setTimeout(place, 200); })();

​API Reference

API Reference