' + '

Was this page helpful?

' + '

Your feedback helps us improve the docs.

' + '

' + '' + '' + '

' + '' + '

' + ''; document.body.appendChild(el); overlay.addEventListener('click', function () { close(false); }); el.querySelector('#idf-fb-close').addEventListener('click', function () { close(false); }); el.querySelector('#idf-submit').addEventListener('click', function () { this.disabled = true; close(true); }); document.addEventListener('keydown', function onKey(e) { if (e.key === 'Escape') { close(false); document.removeEventListener('keydown', onKey); } }); el.querySelector('#idf-add-note').addEventListener('click', function () { el.querySelector('#idf-fb-extra').classList.add('idf-open'); this.style.display = 'none'; el.querySelector('#idf-fb-textarea').focus(); }); function renderChips(rating) { var list = el.querySelector('#idf-chip-list'); list.innerHTML = ''; CHIPS[rating].forEach(function (chip) { var btn = document.createElement('button'); btn.className = 'idf-chip'; btn.setAttribute('data-slug', chip.slug); btn.textContent = chip.label; btn.addEventListener('click', function () { btn.classList.toggle('idf-selected'); }); list.appendChild(btn); }); } function selectRating(value) { currentRating = value; el.querySelector('#idf-yes').classList.toggle('idf-selected', value === 'positive'); el.querySelector('#idf-no').classList.toggle('idf-selected', value === 'negative'); el.querySelector('#idf-fb-comment').style.display = 'block'; renderChips(value); el.querySelector('#idf-fb-textarea').placeholder = value === 'positive' ? 'What was most helpful?' : 'What could be improved?'; } el.querySelector('#idf-yes').addEventListener('click', function () { selectRating('positive'); }); el.querySelector('#idf-no').addEventListener('click', function () { selectRating('negative'); }); } // ── Show ─────────────────────────────────────────────────────────────────── function showWidget() { if (triggered) return; if (!targetOk) return; if (!shouldShow()) return; var tOnPage = Math.round((Date.now() - pageLoadTime) / 1000); if (calcPreShowConfidence(tOnPage, maxScrollDepth, avgVelocity(), decelDetected()) < 3) return; triggered = true; widgetShownAt = Date.now(); localStorage.setItem(SHOWN_KEY, String(Date.now())); buildWidget(); requestAnimationFrame(function () { requestAnimationFrame(function () { var el = document.getElementById('idf-fb'); var ov = document.getElementById('idf-overlay'); if (el) el.classList.add('idf-visible'); if (ov) ov.classList.add('idf-visible'); }); }); } // ── Triggers ─────────────────────────────────────────────────────────────── function armFallbackTimer() { if (fallbackTimer) clearTimeout(fallbackTimer); fallbackTimer = setTimeout(function () { if (!triggered && Date.now() - lastActivity < 120000) { currentTrigger = 'time_on_page'; showWidget(); } }, 90000); } function initTriggers() { // Read live so SPA navigations counted after load are reflected function multiPage() { return parseInt(sessionStorage.getItem(PAGES_KEY) || '1', 10) > 1; } window.addEventListener('scroll', function onScroll() { if (triggered) { window.removeEventListener('scroll', onScroll); return; } recordScroll(); if (!targetOk) return; // keep sampling, but don't evaluate triggers on excluded pages var timeOnPage = Date.now() - pageLoadTime; var pct = scrollSamples.length ? scrollSamples[scrollSamples.length - 1].d : 0; // Deceleration: fast skim → slow down signals engaged reading. // Multi-page sessions get a slightly lower bar (user is familiar with the docs). var minDecelTime = multiPage() ? 75000 : 90000; if (decelDetected() && timeOnPage >= minDecelTime) { window.removeEventListener('scroll', onScroll); currentTrigger = 'decel'; showWidget(); return; } // Scroll to 85%+, not fast-skimming. // Single-page visitors need more time before being prompted. var minScrollTime = multiPage() ? 30000 : 60000; if (pct >= 0.85 && timeOnPage >= minScrollTime && avgVelocity() < 0.04) { window.removeEventListener('scroll', onScroll); currentTrigger = 'scroll'; showWidget(); } }, { passive: true }); // Track user activity so we don't fire on abandoned tabs ['mousemove', 'keydown', 'click'].forEach(function (evt) { document.addEventListener(evt, function () { lastActivity = Date.now(); }, { passive: true }); }); // Guaranteed fallback: show after 90 s, but only if user was active in the last 2 min armFallbackTimer(); // Exit intent: mouse leaves toward browser chrome after ≥60 s in session document.addEventListener('mouseleave', function (e) { if (triggered) return; if (e.clientY < 10 && sessionDuration() >= 60000) { currentTrigger = 'exit_intent'; showWidget(); } }); // Tab hide: user switches away; require more engagement for single-page sessions. document.addEventListener('visibilitychange', function () { if (triggered) return; var minVisTime = multiPage() ? 45000 : 60000; if (document.hidden && Date.now() - pageLoadTime >= minVisTime) { currentTrigger = 'visibility_hidden'; showWidget(); } }); // Copy: user copied text. Require 60 s on page — short-session copiers ("grab and go") // almost always dismiss immediately, producing noise without signal. document.addEventListener('copy', function () { if (triggered) return; if (!window.getSelection || !window.getSelection().toString().trim()) return; if (Date.now() - pageLoadTime < 60000) return; currentTrigger = 'copy'; showWidget(); }); } // ── SPA navigation ───────────────────────────────────────────────────────── // Mintlify navigates client-side; the script loads once per hard load. Track // route changes so page targeting, per-page metrics, and the session page // counter stay correct on pages the user navigates to. function onRouteChange() { initSession(); if (triggered) return; pageLoadTime = Date.now(); scrollSamples = []; maxScrollDepth = 0; targetOk = shouldTarget(); armFallbackTimer(); } function initSpaTracking() { var lastPath = location.pathname; function check() { if (location.pathname !== lastPath) { lastPath = location.pathname; onRouteChange(); } } ['pushState', 'replaceState'].forEach(function (m) { var orig = history[m]; history[m] = function () { var result = orig.apply(this, arguments); check(); return result; }; }); window.addEventListener('popstate', check); } // ── Native Mintlify feedback ─────────────────────────────────────────────── // A click on Mintlify's own thumbs up/down counts as feedback given: suppress // our widget for the same 30-day window as a submission, silently (the native // interaction is collected separately via Mintlify's API). function initNativeThumbsListener() { document.addEventListener('click', function (e) { if (!e.target || !e.target.closest) return; if (e.target.closest('#feedback-thumbs-up, #feedback-thumbs-down')) { localStorage.setItem(SUBMITTED_KEY, String(Date.now())); triggered = true; closed = true; hide(); } }, true); } // ── Init ─────────────────────────────────────────────────────────────────── function init() { initNativeThumbsListener(); if (!shouldShow()) return; // Don't bail on non-targeted landing pages: the user may navigate to a // targeted page client-side. showWidget() gates on targetOk instead. targetOk = shouldTarget(); fetch('https://ipapi.co/country/') .then(function (r) { return r.ok ? r.text() : null; }) .then(function (c) { if (c) geoCountry = c.trim(); }) .catch(function () {}); initSession(); initSpaTracking(); // If another tab shows or submits the widget, stand down in this one window.addEventListener('storage', function (e) { if ((e.key === SHOWN_KEY || e.key === SUBMITTED_KEY) && !triggered) triggered = true; }); if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', initTriggers); } else { initTriggers(); } } init(); })();

​Added

Added