"use client"; // Handle theme const theme = getCookie("pinecone_theme_mode"); if (theme === "system") { window.matchMedia("(prefers-color-scheme: dark)").matches ? document.documentElement.classList.add("dark") : document.documentElement.classList.remove("dark"); } else if (theme === "dark") { setTimeout(() => { document.documentElement.classList.add("dark"); }, 0); } else { document.documentElement.classList.remove("dark"); } let currentTheme = theme; console.log("Initial theme:", currentTheme); // Add visibility change listener to detect theme changes when tab becomes active document.addEventListener("visibilitychange", () => { // Only check when tab becomes visible again if (document.visibilityState === "visible") { console.log("Tab became visible, checking theme"); const newTheme = getCookie("pinecone_theme_mode"); console.log("Current theme:", currentTheme, "New theme:", newTheme); // Only update if the theme actually changed if (newTheme !== currentTheme) { currentTheme = newTheme; // First remove dark class regardless of the new theme document.documentElement.classList.remove("dark"); if (newTheme === "dark") { document.documentElement.classList.add("dark"); } else if (newTheme === "system") { // Apply system preference const systemPreference = window.matchMedia( "(prefers-color-scheme: dark)" ).matches; if (systemPreference) { document.documentElement.classList.add("dark"); } } // If theme is light, we already removed the dark class above } // No theme change detected, no action needed } }); // Mintlify's theme menu doesn't know about the pinecone_theme_mode cookie that // embedded pinecone.io iframes read, so mirror theme changes into it function resolveTheme(mode) { if (mode === "system") { return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light"; } return mode === "dark" ? "dark" : "light"; } function setThemeCookie(mode) { if (mode === currentTheme) return; currentTheme = mode; document.cookie = `pinecone_theme_mode=${mode}; path=/; max-age=31536000; SameSite=lax; domain=.pinecone.io;`; reloadThemedIframes(); } // Only a menu selection writes the cookie, so Mintlify reapplying its own // stored theme on load can't overwrite a theme chosen on another pinecone.io site function handleThemeMenuSelection(event) { const item = event.target.closest('[role="menuitem"][data-theme-preference]'); if (!item) return; const mode = item.dataset.themePreference; if (!["light", "dark", "system"].includes(mode)) return; setThemeCookie(mode); // When the cookie set the class on load, Mintlify may treat this option as // already active and skip applying it setTimeout(() => { document.documentElement.classList.toggle( "dark", resolveTheme(mode) === "dark" ); }, 0); } // Mintlify re-executes this file on client-side navigation. if (!window.__pcThemeMenuSync) { window.__pcThemeMenuSync = true; document.addEventListener("click", handleThemeMenuSelection); document.addEventListener("keydown", (event) => { if (event.key === "Enter" || event.key === " ") { handleThemeMenuSelection(event); } }); } function reloadThemedIframes() { const currentPath = window.location.pathname; if (currentPath.includes("/models/")) { const iframe = document.querySelector("#model-search-iframe"); if (iframe) { iframe.src = iframe.src; } } if (currentPath.includes("/quickstart") || currentPath.includes("/reference/api/authentication")) { const iframe = document.querySelector("#pinecone-connect-widget iframe"); if (iframe) { iframe.src = iframe.src; } } if (currentPath.includes("/sample-apps")) { const iframes = document.querySelectorAll("#sample-app-iframe, #pinecone-connect-widget iframe"); if (iframes.length > 0) { iframes.forEach((iframe) => { iframe.src = iframe.src; }); } } } function getCookie(name) { const cookieName = name + "="; const cookies = document.cookie.split(";"); for (let i = 0; i < cookies.length; i++) { let cookie = cookies[i].trim(); if (cookie.indexOf(cookieName) === 0) { return cookie.substring(cookieName.length, cookie.length); } } return null; } // Handle anchor links after dynamic content loads const anchorObserver = new MutationObserver((mutations) => { if (window.location.hash) { const target = document.querySelector(window.location.hash); if (target) { // Disconnect observer once we find our target anchorObserver.disconnect(); // Small delay to ensure final layout is settled setTimeout(() => { target.scrollIntoView(); window.scrollBy(0, -120); // Adjust for fixed header }, 100); } } }); // Start observing document for content changes anchorObserver.observe(document.body, { childList: true, subtree: true, }); // Insert skeleton loader immediately const pineconeConnectWidget = document.getElementById( "pinecone-connect-widget" ); if (pineconeConnectWidget) { pineconeConnectWidget.innerHTML = ` `; } window.onload = function () { }; const pineconeConnectWidgetScript = document.createElement("script"); document.body.appendChild(pineconeConnectWidgetScript); function debounce(func, delay) { let timerId; return function (...args) { clearTimeout(timerId); timerId = setTimeout(() => { func.apply(this, args); }, delay); }; } // Find instances of {{YOUR_API_KEY}} in code blocks and replace them with a span const prepareApiKeys = () => { const codeElements = document.querySelectorAll( "code:not(.inline-flex.gap-2.items-center)" ); codeElements.forEach((el) => { el.innerHTML = el.innerHTML.replace( /{{YOUR_API_KEY}}/g, `YOUR_API_KEY` ); // Handle cases where the curly braces are in a different span const tokens = el.querySelectorAll("span span"); const apiKeyTokens = Array.from(tokens).filter((token) => token.innerHTML.includes("YOUR_API_KEY") ); apiKeyTokens.forEach((token) => { if ( token.previousElementSibling && token.previousElementSibling.textContent === "{{" && token.nextElementSibling && token.nextElementSibling.textContent === "}}" ) { token.previousElementSibling.remove(); token.nextElementSibling.remove(); token.innerHTML = `YOUR_API_KEY`; } }); }); }; // Set api keys inside codeblocks const setApiKeys = () => { prepareApiKeys(); const apiKey = sessionStorage.getItem("apiKey"); const codeBlocks = document.querySelectorAll("div.mt-5.mb-8.not-prose"); // Replace the copy function in each code block so that it works with the added API keys codeBlocks.forEach((codeBlock) => { const copyButton = codeBlock.querySelector( 'button[data-testid="copy-code-button"]' ); const clonedElement = copyButton.cloneNode(true); copyButton.parentNode.replaceChild(clonedElement, copyButton); clonedElement.addEventListener("click", () => { const codeElement = codeBlock.querySelector("code"); navigator.clipboard.writeText(codeElement.textContent); const statusElement = clonedElement.nextElementSibling; statusElement.textContent = "Copied!"; clonedElement.innerHTML = ``; setTimeout(() => { statusElement.textContent = "Copy"; clonedElement.innerHTML = ``; }, 2000); }); }); if (apiKey) { const apiKeys = document.querySelectorAll(".api-key"); apiKeys.forEach((el) => { el.innerHTML = apiKey; el.classList.add("set"); }); // Add remove api key button // Remove previous button to prevent duplicates const removeButton = document.querySelector(".remove-api-key"); if (removeButton) { removeButton.remove(); } const widgetContainer = document.getElementById("pinecone-connect-widget"); const div = document.createElement("div"); div.classList.add("remove-api-key"); const button = document.createElement("button"); button.textContent = "Remove API Key from guide"; button.addEventListener("click", () => { sessionStorage.removeItem("apiKey"); widgetContainer.innerHTML = ""; div.remove(); loadConnectWidget(); const setApiKeyElements = document.querySelectorAll(".api-key.set"); setApiKeyElements.forEach((el) => { el.innerHTML = "YOUR_API_KEY"; el.classList.remove("set"); }); }); div.appendChild(button); widgetContainer.insertAdjacentElement("afterend", div); } }; const debouncedSetApiKeys = debounce(() => { setApiKeys(); }, 1000); // Function to re-set the API keys after codeblock language changes const refreshApiKeys = () => { try { prepareApiKeys(); const apiKey = sessionStorage.getItem("apiKey"); if (!apiKey) return; const apiKeys = document.querySelectorAll(".api-key:not(.set)"); if (apiKeys.length > 0) { apiKeys.forEach((el) => { el.innerHTML = apiKey; el.classList.add("set"); }); } } catch (error) { console.error("Error refreshing API keys:", error); } }; const debouncedRefreshApiKeys = debounce(() => { refreshApiKeys(); }, 1000); const loadConnectWidget = () => { const apiKey = sessionStorage.getItem("apiKey"); const widgetContainer = document.getElementById("pinecone-connect-widget"); if (!apiKey) { import("https://connect.pinecone.io/embed.js") .then(() => { try { console.log("Trying to initialize connectToPinecone"); // Clear the skeleton loader before initializing the widget widgetContainer.innerHTML = ""; let integrationId = "docs"; // default const currentPath = window.location.pathname; if (currentPath === "/guides/get-started/quickstart") { integrationId = "db-quickstart"; } else if (currentPath.startsWith("/guides/assistant/quickstart/")) { integrationId = "assistant-quickstart"; } window.connectToPinecone( (apiKey) => { console.log(apiKey); sessionStorage.setItem("apiKey", apiKey); setApiKeys(); }, { integrationId, container: widgetContainer, } ); } catch (error) { console.error("Error initializing Pinecone widget:", error); } }) .catch((error) => { console.error("Error importing embed.js:", error); }); } else { widgetContainer.innerHTML = `

You're all set! An API key has been generated and provided to Pinecone Docs.

You can manage your API keys in the Pinecone console.

`; } }; const debouncedLoadConnectWidget = debounce(() => { try { loadConnectWidget(); } catch (error) { console.error("Error loading connect widget:", error); } }, 1000); function addRelatedArticles(titles, links) { const existing = document.querySelector("#related-articles"); if (existing) return; const sidebar = document.querySelector("#table-of-contents"); const relatedArticles = document.createElement("div"); relatedArticles.id = "related-articles"; const title = document.createElement("h2"); title.textContent = "Related Articles"; relatedArticles.appendChild(title); titles.forEach((title, index) => { const relatedArticle = document.createElement("a"); relatedArticle.href = links[index]; relatedArticle.textContent = title; relatedArticle.insertAdjacentHTML( "beforeend", '' ); relatedArticles.appendChild(relatedArticle); }); sidebar.appendChild(relatedArticles); } const relatedArticles = { airbyte: { titles: [ "Data Sync and Search: Pinecone and Airbyte", "Introduction to Airbyte and the Pinecone connector", "Postgres to Pinecone Syncing", ], links: [ "https://www.pinecone.io/learn/series/airbyte/", "https://www.pinecone.io/learn/series/airbyte/airbyte-and-pinecone-intro/", "https://www.pinecone.io/learn/series/airbyte/airbyte-postgres-to-pinecone/", ], }, bedrock: { titles: ["Pinecone as a Knowledge Base for Amazon Bedrock"], links: ["https://www.pinecone.io/blog/amazon-bedrock-integration/"], }, sagemaker: { titles: [ "Mitigate hallucinations through Retrieval Augmented Generation using Pinecone vector database & Llama-2 from Amazon SageMaker JumpStart", ], links: [ "https://aws.amazon.com/blogs/machine-learning/mitigate-hallucinations-through-retrieval-augmented-generation-using-pinecone-vector-database-llama-2-from-amazon-sagemaker-jumpstart/", ], }, langchain: { titles: ["LangChain AI Handbook"], links: ["https://www.pinecone.io/learn/series/langchain/"], }, openai: { titles: [ "Generative Question-Answering with Long-Term Memory", "OpenAI's Text Embeddings v3", ], links: [ "https://www.pinecone.io/learn/openai-gen-qa/", "https://www.pinecone.io/learn/openai-embeddings-v3/", ], }, }; let isScrollListenerAdded = false; let scrollListener = null; // Mutation observer to handle page changes const observer = new MutationObserver(function (mutations) { mutations.forEach(function (mutation) { if (mutation.type === "childList") { try { // Pinecone connect widget const pineconeConnectWidget = document.querySelector( "#pinecone-connect-widget" ); if ( pineconeConnectWidget && !pineconeConnectWidget.classList.contains("loaded") ) { debouncedLoadConnectWidget(); pineconeConnectWidget.classList.add("loaded"); } // console.log("mutation") if ( pineconeConnectWidget && !pineconeConnectWidget.classList.contains("apiKeysSet") ) { debouncedSetApiKeys(); pineconeConnectWidget.classList.add("apiKeysSet"); } const [path, page, page2] = window.location.pathname .split("/") .slice(1); var contentContainer = document.querySelector("#content-container"); var contentArea = document.querySelector("#content-area"); //** Model Gallery **/ if (path !== "models") { const sidebar = document.querySelector("#sidebar"); if (sidebar) sidebar.style.display = ""; if (contentContainer) contentContainer.style.paddingLeft = ""; } else { const sidebar = document.querySelector("#sidebar"); if (sidebar) sidebar.style.display = "none"; const rightSidebar = document.querySelector("#content-side-layout"); if (rightSidebar) rightSidebar.style.display = "none"; if (contentContainer) contentContainer.style.paddingLeft = "0px"; if (contentArea) contentArea.style.paddingLeft = "0px"; if (contentArea) contentArea.style.marginLeft = "12px"; const header = document.querySelector("#header"); if (header) header.remove(); const tableOfContents = document.querySelector("#table-of-contents"); if (tableOfContents) tableOfContents.remove(); } //** References **/ // Hide toc items with class 'toc-item relevant' and data-depth="2" on /guides/manage-cost/understanding-cost page if ( path === "guides" && page === "manage-cost" && page2 === "understanding-cost" ) { document.querySelectorAll('li.toc-item[data-depth="2"]').forEach((li) => { li.style.display = "none"; }); } //** Integrations **/ if (path === "integrations" && page === "overview") { const toc = document.querySelector("#table-of-contents"); if (toc) toc.style.display = "none"; const sidebar = document.querySelector("#content-side-layout"); if (sidebar) sidebar.style.display = "none"; } else { // Set sample apps side nav link to active for all sample apps if (page === "sample-apps") { const aElement = document.querySelector( 'a[href="/examples/sample-apps"]' ); if (aElement) { aElement.className = "group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 rounded-lg focus:outline-primary dark:focus:outline-primary-light bg-primary/10 text-primary font-semibold dark:text-primary-light dark:bg-primary-light/10"; } } else if (page === "notebooks") { const aElement = document.querySelector( 'li > a[href="/examples/sample-apps"]' ); if (aElement) { aElement.className = "group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 rounded-lg focus:outline-primary dark:focus:outline-primary-light 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"; } } if (path === "integrations" && page !== "overview") { // Insert back button const backButton = document.querySelector("#back-button"); if (!backButton) { const link = document.createElement("a"); link.id = "back-button"; link.href = "/integrations/overview"; link.textContent = "Back to Integrations"; link.insertAdjacentHTML( "afterbegin", '' ); const header = document.querySelector("#header"); header.insertAdjacentElement("afterbegin", link); } // Add related articles switch ( page /* Hide related articles for now case "airbyte": addRelatedArticles( relatedArticles.airbyte.titles, relatedArticles.airbyte.links ); break; airbyte; case "amazon-bedrock": addRelatedArticles( relatedArticles.bedrock.titles, relatedArticles.bedrock.links ); break; case "amazon-sagemaker": addRelatedArticles( relatedArticles.sagemaker.titles, relatedArticles.sagemaker.links ); break; case "langchain": addRelatedArticles( relatedArticles.langchain.titles, relatedArticles.langchain.links ); break; case "openai": addRelatedArticles( relatedArticles.openai.titles, relatedArticles.openai.links ); break; case "snowflake": addRelatedArticles(relatedArticles.snowflake.titles, relatedArticles.snowflake.links) break; */ ) { default: break; } } // Sample apps if (page === "sample-apps" && !!page2) { const header = document.querySelector("#header"); if (header) header.style.display = "none"; const toc = document.querySelector("#table-of-contents"); if (toc) toc.style.display = "none"; const contentArea = document.querySelector( "#content-area > div.mt-8" ); contentArea.style.marginTop = "0"; // Create toc document.querySelectorAll(".sample-app-split").forEach((div) => { const toc = div.querySelector(".toc"); // Mintlify renders the class as mint-content on some pages const content = div.querySelector(".content, .mint-content"); const existing = div.querySelector(".toc-list"); if (toc && content && !existing) { const tocList = document.createElement("div"); tocList.className = "toc-list"; const headers = content.querySelectorAll( "h2, h3, .connect-with-pinecone" ); headers.forEach((header) => { // If connect btn, clone it and append if (header.classList.contains("connect-with-pinecone")) { const cloned = header.cloneNode(true); tocList.appendChild(cloned); return; } // Slugify heading text and create id const slugify = (text) => text .toLowerCase() .replace(/[^a-z0-9]+/g, "-") .replace(/^-|-$/g, ""); const id = slugify(header.textContent); header.id = id; // Set ID on the header using the slugified text // Create an anchor link and append it to the TOC const anchor = document.createElement("a"); anchor.href = `#${id}`; anchor.textContent = header.textContent; anchor.className = header.tagName === "H2" ? "bold" : ""; tocList.appendChild(anchor); }); toc.appendChild(tocList); const initialTopOffset = tocList.getBoundingClientRect().top + window.scrollY - 148; const stickySidebar = () => { if (window.innerWidth > 1280) { if (window.scrollY >= initialTopOffset) { tocList.style.position = "fixed"; tocList.style.top = "148px"; } else { tocList.style.position = "relative"; tocList.style.top = ""; } } else { tocList.style.position = "relative"; tocList.style.top = ""; } }; stickySidebar(); window.addEventListener("scroll", stickySidebar); window.addEventListener("resize", stickySidebar); } }); } // Notebooks if ( path === "examples" && (page === "notebooks" || page === "sample-apps" || page == "reference-architectures") ) { const toc = document.querySelector("#table-of-contents"); if (toc) toc.style.display = "none"; const sidebar = document.querySelector("#content-side-layout"); if (sidebar) sidebar.style.display = "none"; const heading = document.querySelector("#header h1"); if (heading) heading.style.fontSize = "1.5rem"; } } // Detect when codeblock languages change and rerun the function to replace API keys if (mutation.target.dataset.componentPart === "code-block-root") { debouncedRefreshApiKeys(); } } catch (error) { console.error("Error handling mutation:", error); } } }); }); observer.observe(document.body, { childList: true, subtree: true }); // Replace the header cta button since replacing the svg via css ::after is not working window.addEventListener("load", () => { const ctaButton = document.querySelector("#topbar-cta-button"); if (ctaButton) { ctaButton.innerHTML = ""; const a = document.createElement("a"); a.href = "https://app.pinecone.io/?sessionType=signup"; a.target = "_blank"; a.textContent = "Sign up free"; const svg = ''; a.insertAdjacentHTML("beforeend", svg); ctaButton.appendChild(a); } localStorage.setItem("isDarkMode", "false"); const [path, page, page2] = window.location.pathname.split("/").slice(1); if (path !== "reference") { // Remove version picker from home page on load const versionToggle = document.getElementById( "headlessui-menu-button-:r0:" ); if (versionToggle) { versionToggle.style.visibility = "hidden"; } } }); // Model Carousel document.addEventListener("DOMContentLoaded", () => { const carousel = document.getElementById("modelCarousel"); const prevButton = document.getElementById("prevButton"); const nextButton = document.getElementById("nextButton"); if (!carousel || !prevButton || !nextButton) return; const handleScroll = (direction) => { const cardWidth = carousel.offsetWidth / 3; carousel.scrollBy({ left: direction * cardWidth, behavior: "smooth", }); }; prevButton.addEventListener("click", (e) => { e.preventDefault(); handleScroll(-1); }); nextButton.addEventListener("click", (e) => { e.preventDefault(); handleScroll(1); }); }); // Fix for Radix popper content wrapper used in page context menu const fixRadixPoppers = () => { // Handle page context menu popper elements that appear in the DOM new MutationObserver((mutations) => { document .querySelectorAll("[data-radix-popper-content-wrapper]") .forEach((el) => { // Check if this is the page context menu by looking for specific identifiers const menuContent = el.querySelector("[data-radix-menu-content]"); // Only target the specific page context menu with the copy/markdown/ChatGPT/Claude options if ( menuContent && (menuContent.textContent.includes("Copy page") || menuContent.textContent.includes("View as Markdown") || menuContent.textContent.includes("Open in ChatGPT") || menuContent.textContent.includes("Open in Claude")) ) { // Unset the min-width style for the page context menu el.style.minWidth = ""; el.style.zIndex = "10"; } }); }).observe(document, { childList: true, subtree: true }); // Also check for existing page context menu elements document .querySelectorAll("[data-radix-popper-content-wrapper]") .forEach((el) => { const menuContent = el.querySelector("[data-radix-menu-content]"); // Only target the specific page context menu with the copy/markdown/ChatGPT/Claude options if ( menuContent && (menuContent.textContent.includes("Copy page") || menuContent.textContent.includes("View as Markdown") || menuContent.textContent.includes("Open in ChatGPT") || menuContent.textContent.includes("Open in Claude")) ) { el.style.minWidth = ""; el.style.zIndex = "10"; } }); }; // End of Selection // Changelog filtering (`/release-notes/*`). // // The changelog lives in its own nav dropdown, so it keeps the site's navbar // and sidebar while staying out of any one product's context. Mintlify renders // its own tag panel in the right rail, but that rail is `hidden xl:flex`, so // the filters vanish below 1280px. `mode: "wide"` drops the rail entirely and // this rebuilds the controls in the left sidebar under the year list, which // also gets us a search box and a result count. // // Filters are custom dropdowns rather than ' + dropdown( "All products", tags.filter(function (t) { return PRODUCTS.indexOf(t) !== -1; }) ) + dropdown( "All updates", tags.filter(function (t) { return PRODUCTS.indexOf(t) === -1; }) ) + '' + '

'; host.appendChild(panel); // Sits in the content column, not the panel. At zero matches the column // would otherwise be empty, and on mobile the panel's count is hidden // inside the nav drawer, so there'd be nothing on screen explaining why. var empty = document.createElement("p"); empty.className = "pc-cl-empty"; empty.hidden = true; empty.textContent = "No releases match these filters."; updates[0].parentNode.insertBefore(empty, updates[0]); emptyNote = empty; var dds = Array.prototype.slice.call(panel.querySelectorAll(".pc-cl-dd")); var search = panel.querySelector(".pc-cl-search"); var clear = panel.querySelector(".pc-cl-clear"); var count = panel.querySelector(".pc-cl-count"); function apply() { var vals = dds.map(function (dd) { return dd.getAttribute("data-value"); }); var q = search.value.trim().toLowerCase(); var shown = 0; updates.forEach(function (u) { var t = tagsOf(u); var ok = vals.every(function (v) { return !v || t.indexOf(v) !== -1; }) && (!q || u.textContent.toLowerCase().indexOf(q) !== -1); u.style.display = ok ? "" : "none"; if (ok) shown++; }); // The count stays in the DOM rather than being toggled with `hidden`: a // live region has to be in the accessibility tree before its text changes // for the change to be announced, so unhiding and filling it in the same // task loses the first announcement. `role="status"` implies // `aria-live="polite"`. var filtering = !!q || vals.some(Boolean); clear.hidden = !filtering; empty.hidden = shown !== 0; count.textContent = !filtering ? "" : shown === 0 ? "No matching releases" : shown === 1 ? "1 release" : shown + " releases"; } dds.forEach(function (dd) { var toggle = dd.querySelector(".pc-cl-dd-toggle"); var menu = dd.querySelector(".pc-cl-dd-menu"); var label = dd.querySelector(".pc-cl-dd-label"); var placeholder = label.textContent; toggle.addEventListener("click", function (e) { e.stopPropagation(); var willOpen = menu.hidden; closeMenus(dd); if (willOpen) { placeMenu(dd); toggle.setAttribute("aria-expanded", "true"); } else { menu.hidden = true; toggle.setAttribute("aria-expanded", "false"); } }); menu.addEventListener("click", function (e) { var btn = e.target.closest("button[data-value]"); if (!btn) return; var v = btn.getAttribute("data-value"); dd.setAttribute("data-value", v); label.textContent = v || placeholder; dd.classList.toggle("is-active", !!v); menu.hidden = true; toggle.setAttribute("aria-expanded", "false"); apply(); }); }); search.addEventListener("input", apply); clear.addEventListener("click", function () { search.value = ""; dds.forEach(function (dd) { dd.setAttribute("data-value", ""); dd.classList.remove("is-active"); dd.querySelector(".pc-cl-dd-label").textContent = dd.querySelector("button[data-value='']").textContent; }); apply(); }); // The entries can outlive the panel: React discards the panel when it // re-renders the nav without necessarily re-rendering the content column, so // they can still carry the last panel's `display: none`. Reconcile them with // this panel, which starts with nothing selected. Only touches `style`, and // the observer watches `childList`, so this can't re-trigger a build. // // Gated on an entry actually being hidden. A fresh panel already renders as // unfiltered, so calling this unconditionally only added an inline style to // every entry on every rebuild. var carriesStaleFilter = updates.some(function (u) { return u.style.display === "none"; }); if (carriesStaleFilter) apply(); } build(); // Mintlify is a single-page app, so rebuild when the content changes. new MutationObserver(build).observe(document, { childList: true, subtree: true, }); // Registered once, deliberately. React re-renders the sidebar on every SPA // navigation, so build() runs several times per page; registering these inside // it added a pair each time and kept every past panel alive in the closures. document.addEventListener("click", function () { closeMenus(); }); document.addEventListener("keydown", function (e) { if (e.key === "Escape") closeMenus(null, true); }); // Menus are fixed to the viewport, so scrolling or resizing would leave one // floating away from its control. Capture is needed to see scrolls from any // element, which also means this fires for a menu's own overflow scroll, so // skip those: closing the menu you're scrolling is the case the fixed // positioning was for. A document-level scroll targets `document`, which has // no `closest`. window.addEventListener("scroll", function (e) { if (e.target && e.target.closest && e.target.closest(".pc-cl-dd-menu")) return; closeMenus(); }, true); window.addEventListener("resize", function () { closeMenus(); }); })(); // Sidebar collapse button, like Stripe's docs. Mintlify has no built-in // toggle, so this adds a button next to the sidebar's product dropdown. // Collapsing hides the sidebar and moves the button into the left gutter, and // the choice is remembered in localStorage. // // Styling lives in styles.css under `#pc-sidebar-toggle`. (function () { // Mintlify re-executes this file on client-side navigation. if (window.__pcSidebarToggle) return; window.__pcSidebarToggle = true; var KEY = "pc-sidebar-collapsed"; var root = document.documentElement; // Lucide's arrow-left-to-line and arrow-right-from-line, the same "hide to // the edge" and "pull out from the edge" arrows Stripe uses. var ICON_OPEN = ''; var ICON_CLOSED = ''; function readSaved() { try { return localStorage.getItem(KEY) === "true"; } catch (e) { return false; } } var button = document.createElement("button"); button.id = "pc-sidebar-toggle"; button.type = "button"; // The label says what the button will do, so it doesn't also carry // aria-expanded (that would announce the state twice). function render(collapsed) { root.classList.toggle("pc-sidebar-collapsed", collapsed); button.innerHTML = collapsed ? ICON_CLOSED : ICON_OPEN; button.setAttribute("aria-label", collapsed ? "Show sidebar" : "Hide sidebar"); button.setAttribute("title", collapsed ? "Show sidebar" : "Hide sidebar"); } button.addEventListener("click", function () { var collapsed = !root.classList.contains("pc-sidebar-collapsed"); render(collapsed); // mount() moves the button in the DOM, which drops keyboard focus. mount(); button.focus({ preventScroll: true }); try { localStorage.setItem(KEY, String(collapsed)); } catch (e) {} }); // While the sidebar is open, the button lives inside it next to the product // dropdown so it scrolls with the nav. While collapsed, it moves to the // start of (so it's the first tab stop, outside React's tree) and // sits fixed in the rail, level with the dropdown row. function mount() { var sidebar = document.getElementById("sidebar"); var nav = sidebar && sidebar.querySelector("#navigation-items"); // The model pages hide the sidebar (see the Model Gallery block above), // so they get no button. Same path test as that block. var isModels = location.pathname.split("/")[1] === "models"; button.hidden = !nav || isModels; if (button.hidden) { if (!button.isConnected) document.body.appendChild(button); return; } if (root.classList.contains("pc-sidebar-collapsed")) { if (document.body.firstChild !== button) { document.body.insertBefore(button, document.body.firstChild); } // 41px: the dropdown row's offset below the navbar (2rem of sidebar // padding plus centering the 28px button on the 46px dropdown). var navbar = document.getElementById("navbar"); var top = navbar ? navbar.getBoundingClientRect().bottom : 0; var px = Math.round(top + 41) + "px"; if (button.style.top !== px) button.style.top = px; } else if (button.parentNode !== nav) { if (button.style.top) button.style.top = ""; nav.insertBefore(button, nav.firstChild); } } render(readSaved()); // Start once the document is parsed. Waiting for `load` instead would leave // a collapsed rail with no button until every image and iframe finishes. var ready = false; function update() { if (ready) mount(); } function start() { ready = true; mount(); } if (document.readyState === "loading") { document.addEventListener("DOMContentLoaded", start); } else { start(); } // Mintlify is a single-page app and re-renders the body on navigation. The // observer delivers each batch of changes in one call, and mount() only // moves the button when it's in the wrong place. new MutationObserver(update).observe(document, { childList: true, subtree: true }); // The navbar's height can change on resize (wrapping nav tabs), which moves // the collapsed button's row. window.addEventListener("resize", update); })();