Skip to content

Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠

Point first-time visitors to the rest of the install page

Clauded6edb467233b
diff --git a/src/chrome/src/ui/install-motion.js b/src/chrome/src/ui/install-motion.js
index 7e66fef0a..ef05e296b 100644
--- a/src/chrome/src/ui/install-motion.js
+++ b/src/chrome/src/ui/install-motion.js
@@ -139,3 +139,60 @@ export function initializeShowcaseAutoplay({
}
return stop;
}
+
+/**
+ * The hero looks complete in a laptop-sized window, so nothing says the page
+ * continues. A floating pill points down until the visitor finds the rest on
+ * their own: it never appears if the next section is already in view, and it
+ * goes for good once they scroll or click it. Returns a function that retires
+ * it early.
+ */
+export function initializeScrollCue({
+ documentLike = globalThis.document,
+ windowLike = globalThis.window,
+ delayMs = 1400,
+ scrolledPx = 120,
+} = {}) {
+ const cue = documentLike?.querySelector?.('[data-scroll-cue]');
+ const target = documentLike?.querySelector?.('.more-head');
+ const Observer = windowLike?.IntersectionObserver;
+ // Without the observer there is no way to tell when the cue stops being useful,
+ // so leave it hidden rather than let it sit over the content.
+ if (!cue || !target || typeof Observer !== 'function') return () => {};
+
+ let finished = false;
+ let revealTimer = null;
+ const nextFrame = windowLike.requestAnimationFrame?.bind(windowLike) || ((fn) => fn());
+
+ const observer = new Observer((entries) => {
+ if (entries.some((entry) => entry.isIntersecting)) dismiss();
+ }, { rootMargin: '0px 0px -12% 0px' });
+
+ function dismiss() {
+ if (finished) return;
+ finished = true;
+ windowLike.clearTimeout?.(revealTimer);
+ observer.disconnect();
+ windowLike.removeEventListener?.('scroll', onScroll);
+ cue.removeEventListener?.('click', dismiss);
+ cue.classList.remove('is-visible');
+ // Leave the layout and the tab order once the fade has finished.
+ windowLike.setTimeout(() => { cue.hidden = true; }, 400);
+ }
+ function onScroll() {
+ if ((windowLike.scrollY || 0) > scrolledPx) dismiss();
+ }
+
+ windowLike.addEventListener?.('scroll', onScroll, { passive: true });
+ cue.addEventListener('click', dismiss);
+ observer.observe(target);
+ revealTimer = windowLike.setTimeout(() => {
+ if (finished) return;
+ // A reload can restore a scroll position that is already past the hero.
+ if ((windowLike.scrollY || 0) > scrolledPx) { dismiss(); return; }
+ cue.hidden = false;
+ // Next frame, so the fade-in transition actually runs.
+ nextFrame(() => { if (!finished) cue.classList.add('is-visible'); });
+ }, delayMs);
+ return dismiss;
+}
diff --git a/src/chrome/src/ui/install-scenes.css b/src/chrome/src/ui/install-scenes.css
index 858d068dc..d16020511 100644
--- a/src/chrome/src/ui/install-scenes.css
+++ b/src/chrome/src/ui/install-scenes.css
@@ -1407,6 +1407,121 @@
translate: 0 0;
}
+/* ───────────────────────── scroll cue ───────────────────────── */
+
+/* The hero looks complete on a laptop-sized window, so a floating pill says the
+ page continues. install-motion.js shows it after a beat and retires it for
+ good once the visitor scrolls or clicks. */
+
+html {
+ scroll-padding-top: 16px;
+}
+
+@media (prefers-reduced-motion: no-preference) {
+ html {
+ scroll-behavior: smooth;
+ }
+}
+
+.scroll-cue {
+ position: fixed;
+ z-index: 30;
+ bottom: max(20px, env(safe-area-inset-bottom));
+ left: 50%;
+ display: inline-flex;
+ align-items: center;
+ gap: 10px;
+ padding: 8px 9px 8px 20px;
+ border: 1px solid color-mix(in srgb, var(--accent) 48%, var(--line));
+ border-radius: 999px;
+ background: color-mix(in srgb, var(--surface-strong) 84%, transparent);
+ -webkit-backdrop-filter: blur(16px) saturate(1.4);
+ backdrop-filter: blur(16px) saturate(1.4);
+ box-shadow:
+ 0 12px 36px color-mix(in srgb, var(--accent) 32%, transparent),
+ 0 2px 8px color-mix(in srgb, #0a0d1f 24%, transparent);
+ color: var(--text);
+ font-size: 14px;
+ font-weight: 650;
+ letter-spacing: -0.005em;
+ text-decoration: none;
+ white-space: nowrap;
+ opacity: 0;
+ translate: -50% 14px;
+ pointer-events: none;
+ transition:
+ opacity 360ms ease,
+ translate 360ms cubic-bezier(0.2, 0.8, 0.2, 1),
+ border-color 160ms ease,
+ background-color 160ms ease;
+}
+
+.scroll-cue[hidden] {
+ display: none;
+}
+
+.scroll-cue.is-visible {
+ opacity: 1;
+ translate: -50% 0;
+ pointer-events: auto;
+}
+
+.scroll-cue:hover {
+ border-color: var(--accent);
+ background: color-mix(in srgb, var(--surface-strong) 94%, transparent);
+}
+
+.scroll-cue:focus-visible {
+ outline: 2px solid var(--accent);
+ outline-offset: 3px;
+}
+
+.scroll-cue-arrow {
+ display: inline-grid;
+ flex: none;
+ place-items: center;
+ width: 28px;
+ height: 28px;
+ border-radius: 50%;
+ background: color-mix(in srgb, var(--accent) 24%, transparent);
+ color: var(--accent);
+}
+
+.scroll-cue-arrow svg {
+ width: 17px;
+ height: 17px;
+ fill: none;
+ stroke: currentColor;
+ stroke-width: 2.4;
+ stroke-linecap: round;
+ stroke-linejoin: round;
+}
+
+.scroll-cue.is-visible .scroll-cue-arrow svg {
+ animation: cue-bob 1.6s ease-in-out 600ms infinite;
+}
+
+@keyframes cue-bob {
+ 0%,
+ 100% {
+ translate: 0 -2px;
+ }
+
+ 50% {
+ translate: 0 3px;
+ }
+}
+
+@media (prefers-reduced-motion: reduce) {
+ .scroll-cue {
+ transition: none;
+ }
+
+ .scroll-cue.is-visible .scroll-cue-arrow svg {
+ animation: none;
+ }
+}
+
/* ───────────────────────── responsive ───────────────────────── */
@media (max-width: 1080px) {
diff --git a/src/chrome/src/ui/install.css b/src/chrome/src/ui/install.css
index ac7dc077d..7bdcdd6ee 100644
--- a/src/chrome/src/ui/install.css
+++ b/src/chrome/src/ui/install.css
@@ -138,6 +138,7 @@ kbd {
.install-hero {
flex: 1;
+ min-height: calc(100svh - 89px);
padding: clamp(54px, 8vh, 92px) 0 70px;
display: grid;
grid-template-columns: minmax(280px, 0.72fr) minmax(540px, 1.45fr);
diff --git a/src/chrome/src/ui/install.html b/src/chrome/src/ui/install.html
index 6e5e946f5..ec910d624 100644
--- a/src/chrome/src/ui/install.html
+++ b/src/chrome/src/ui/install.html
@@ -70,7 +70,7 @@
</aside>
</section>
- <section class="more" aria-labelledby="more-title">
+ <section class="more" id="more" aria-labelledby="more-title">
<div class="more-head" data-reveal>
<p class="eyebrow" data-i18n="install.more.eyebrow">Also built in</p>
<h2 id="more-title" class="more-title" data-i18n="install.more.title">Plenty more under the hood.</h2>
@@ -318,6 +318,13 @@
</section>
</main>
+ <a class="scroll-cue" href="#more" data-scroll-cue hidden>
+ <span data-i18n="install.scroll_hint">More features below</span>
+ <span class="scroll-cue-arrow" aria-hidden="true">
+ <svg viewBox="0 0 24 24"><path d="M6 9.5l6 6 6-6"/></svg>
+ </span>
+ </a>
+
<script type="module" src="install.js"></script>
</body>
</html>
diff --git a/src/chrome/src/ui/install.js b/src/chrome/src/ui/install.js
index a782be531..46660ca4a 100644
--- a/src/chrome/src/ui/install.js
+++ b/src/chrome/src/ui/install.js
@@ -2,6 +2,7 @@ import { applyDOMTranslations, t } from './i18n.js';
import {
initializeCardSpotlight,
initializeScenePlayback,
+ initializeScrollCue,
initializeShowcaseAutoplay,
startRecordingClock,
} from './install-motion.js';
@@ -143,6 +144,7 @@ function initializeMotion() {
try {
initializeShowcaseAutoplay({ select: (feature) => selectInstallFeature(feature) });
initializeScenePlayback();
+ initializeScrollCue();
initializeCardSpotlight();
startRecordingClock();
} catch (error) {
diff --git a/src/chrome/src/ui/locales/ar.js b/src/chrome/src/ui/locales/ar.js
index 19d047266..d40d9be76 100644
--- a/src/chrome/src/ui/locales/ar.js
+++ b/src/chrome/src/ui/locales/ar.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'علامة تبويب',
'install.mock.screen': 'الشاشة',
'install.cta.title': 'جاهز متى كنت جاهزًا.',
+ 'install.scroll_hint': 'المزيد من الميزات أدناه',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} من {total}',
diff --git a/src/chrome/src/ui/locales/bn.js b/src/chrome/src/ui/locales/bn.js
index 7a7eb97f2..2909edf9a 100644
--- a/src/chrome/src/ui/locales/bn.js
+++ b/src/chrome/src/ui/locales/bn.js
@@ -108,6 +108,7 @@ export default {
'install.mock.tab': 'ট্যাব',
'install.mock.screen': 'স্ক্রিন',
'install.cta.title': 'আপনি তৈরি হলেই শুরু করুন।',
+ 'install.scroll_hint': 'নিচে আরও ফিচার',
// --- Sidepanel ---------------------------------------------------------
'sp.status.disconnected': "সংযোগ বিচ্ছিন্ন",
diff --git a/src/chrome/src/ui/locales/de.js b/src/chrome/src/ui/locales/de.js
index 068b63315..0f67fccfc 100644
--- a/src/chrome/src/ui/locales/de.js
+++ b/src/chrome/src/ui/locales/de.js
@@ -110,6 +110,7 @@ export default {
'install.mock.tab': 'Tab',
'install.mock.screen': 'Bildschirm',
'install.cta.title': 'Bereit, wenn Sie es sind.',
+ 'install.scroll_hint': 'Weitere Funktionen unten',
'sp.status.disconnected': 'Getrennt',
'sp.status.connected': 'Verbunden ({model})',
'sp.status.error': 'Fehler: {msg}',
diff --git a/src/chrome/src/ui/locales/en.js b/src/chrome/src/ui/locales/en.js
index 77090bc9d..3a3995b41 100644
--- a/src/chrome/src/ui/locales/en.js
+++ b/src/chrome/src/ui/locales/en.js
@@ -108,6 +108,7 @@ export default {
'install.mock.tab': 'Tab',
'install.mock.screen': 'Screen',
'install.cta.title': 'Ready when you are.',
+ 'install.scroll_hint': 'More features below',
// --- Sidepanel ---------------------------------------------------------
'sp.status.disconnected': 'Disconnected',
diff --git a/src/chrome/src/ui/locales/es.js b/src/chrome/src/ui/locales/es.js
index 3146ae9ec..53fb1b54e 100644
--- a/src/chrome/src/ui/locales/es.js
+++ b/src/chrome/src/ui/locales/es.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Pestaña',
'install.mock.screen': 'Pantalla',
'install.cta.title': 'Cuando quieras.',
+ 'install.scroll_hint': 'Más funciones abajo',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} de {total}',
diff --git a/src/chrome/src/ui/locales/fa.js b/src/chrome/src/ui/locales/fa.js
index f6e819c11..1b62b9bbc 100644
--- a/src/chrome/src/ui/locales/fa.js
+++ b/src/chrome/src/ui/locales/fa.js
@@ -108,6 +108,7 @@ export default {
'install.mock.tab': 'زبانه',
'install.mock.screen': 'صفحه‌نمایش',
'install.cta.title': 'هر وقت آماده بودید.',
+ 'install.scroll_hint': 'امکانات بیشتر در پایین',
// --- Sidepanel ---------------------------------------------------------
'sp.status.disconnected': "قطع شد",
diff --git a/src/chrome/src/ui/locales/fr.js b/src/chrome/src/ui/locales/fr.js
index 7734fa8f5..991d5b6df 100644
--- a/src/chrome/src/ui/locales/fr.js
+++ b/src/chrome/src/ui/locales/fr.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Onglet',
'install.mock.screen': 'Écran',
'install.cta.title': 'Prêt quand vous l’êtes.',
+ 'install.scroll_hint': 'Plus de fonctionnalités ci-dessous',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} sur {total}',
diff --git a/src/chrome/src/ui/locales/he.js b/src/chrome/src/ui/locales/he.js
index e639e17ca..6561fc19c 100644
--- a/src/chrome/src/ui/locales/he.js
+++ b/src/chrome/src/ui/locales/he.js
@@ -124,6 +124,7 @@ export default {
'install.mock.tab': 'לשונית',
'install.mock.screen': 'מסך',
'install.cta.title': 'מוכנים כשתהיו מוכנים.',
+ 'install.scroll_hint': 'עוד תכונות למטה',
"sp.status.disconnected": "לא מחובר",
"sp.status.connected": "מחובר ({model})",
"sp.status.error": "שגיאה: {msg}",
diff --git a/src/chrome/src/ui/locales/hi.js b/src/chrome/src/ui/locales/hi.js
index 7fd7da4a2..f87d55599 100644
--- a/src/chrome/src/ui/locales/hi.js
+++ b/src/chrome/src/ui/locales/hi.js
@@ -108,6 +108,7 @@ export default {
'install.mock.tab': 'टैब',
'install.mock.screen': 'स्क्रीन',
'install.cta.title': 'जब आप तैयार हों।',
+ 'install.scroll_hint': 'नीचे और सुविधाएँ',
// --- Sidepanel ---------------------------------------------------------
'sp.status.disconnected': "विच्छेदित",
diff --git a/src/chrome/src/ui/locales/id.js b/src/chrome/src/ui/locales/id.js
index fa77c82cd..932dcc113 100644
--- a/src/chrome/src/ui/locales/id.js
+++ b/src/chrome/src/ui/locales/id.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Tab',
'install.mock.screen': 'Layar',
'install.cta.title': 'Siap saat Anda siap.',
+ 'install.scroll_hint': 'Fitur lainnya di bawah',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} dari {total}',
diff --git a/src/chrome/src/ui/locales/ja.js b/src/chrome/src/ui/locales/ja.js
index 17b481785..7cd1bc1ae 100644
--- a/src/chrome/src/ui/locales/ja.js
+++ b/src/chrome/src/ui/locales/ja.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'タブ',
'install.mock.screen': '画面',
'install.cta.title': '準備ができたら、どうぞ。',
+ 'install.scroll_hint': '下にさらに機能があります',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} / {total}',
diff --git a/src/chrome/src/ui/locales/ko.js b/src/chrome/src/ui/locales/ko.js
index 8cf210172..8672a0e4c 100644
--- a/src/chrome/src/ui/locales/ko.js
+++ b/src/chrome/src/ui/locales/ko.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': '탭',
'install.mock.screen': '화면',
'install.cta.title': '준비되면 시작하세요.',
+ 'install.scroll_hint': '아래에 더 많은 기능',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} / {total}',
diff --git a/src/chrome/src/ui/locales/ms.js b/src/chrome/src/ui/locales/ms.js
index 2a709250e..e3fab22f9 100644
--- a/src/chrome/src/ui/locales/ms.js
+++ b/src/chrome/src/ui/locales/ms.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Tab',
'install.mock.screen': 'Skrin',
'install.cta.title': 'Sedia apabila anda sedia.',
+ 'install.scroll_hint': 'Lebih banyak ciri di bawah',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} daripada {total}',
diff --git a/src/chrome/src/ui/locales/nl.js b/src/chrome/src/ui/locales/nl.js
index e8050c47b..9e1442a57 100644
--- a/src/chrome/src/ui/locales/nl.js
+++ b/src/chrome/src/ui/locales/nl.js
@@ -110,6 +110,7 @@ export default {
'install.mock.tab': 'Tabblad',
'install.mock.screen': 'Scherm',
'install.cta.title': 'Klaar wanneer jij dat bent.',
+ 'install.scroll_hint': 'Meer functies hieronder',
'sp.status.disconnected': 'Niet verbonden',
'sp.status.connected': 'Verbonden ({model})',
'sp.status.error': 'Fout: {msg}',
diff --git a/src/chrome/src/ui/locales/pl.js b/src/chrome/src/ui/locales/pl.js
index 226cf2c6f..63477cd3b 100644
--- a/src/chrome/src/ui/locales/pl.js
+++ b/src/chrome/src/ui/locales/pl.js
@@ -110,6 +110,7 @@ export default {
'install.mock.tab': 'Karta',
'install.mock.screen': 'Ekran',
'install.cta.title': 'Gotowe, kiedy ty.',
+ 'install.scroll_hint': 'Więcej funkcji poniżej',
'sp.status.disconnected': 'Rozłączono',
'sp.status.connected': 'Połączono ({model})',
'sp.status.error': 'Błąd: {msg}',
diff --git a/src/chrome/src/ui/locales/pt.js b/src/chrome/src/ui/locales/pt.js
index 61c86e2e1..e5983f839 100644
--- a/src/chrome/src/ui/locales/pt.js
+++ b/src/chrome/src/ui/locales/pt.js
@@ -108,6 +108,7 @@ export default {
'install.mock.tab': 'Aba',
'install.mock.screen': 'Tela',
'install.cta.title': 'Pronto quando você estiver.',
+ 'install.scroll_hint': 'Mais recursos abaixo',
// --- Sidepanel ---------------------------------------------------------
'sp.status.disconnected': "Desconectado",
diff --git a/src/chrome/src/ui/locales/ru.js b/src/chrome/src/ui/locales/ru.js
index fc8f99e2c..61b225d48 100644
--- a/src/chrome/src/ui/locales/ru.js
+++ b/src/chrome/src/ui/locales/ru.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Вкладка',
'install.mock.screen': 'Экран',
'install.cta.title': 'Начнём, когда будете готовы.',
+ 'install.scroll_hint': 'Больше возможностей ниже',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} из {total}',
diff --git a/src/chrome/src/ui/locales/th.js b/src/chrome/src/ui/locales/th.js
index a9ed9b48b..d7c7773c8 100644
--- a/src/chrome/src/ui/locales/th.js
+++ b/src/chrome/src/ui/locales/th.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'แท็บ',
'install.mock.screen': 'หน้าจอ',
'install.cta.title': 'พร้อมเมื่อคุณพร้อม',
+ 'install.scroll_hint': 'ฟีเจอร์เพิ่มเติมด้านล่าง',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} จาก {total}',
diff --git a/src/chrome/src/ui/locales/tl.js b/src/chrome/src/ui/locales/tl.js
index 2e842c4d1..93c8ca6ff 100644
--- a/src/chrome/src/ui/locales/tl.js
+++ b/src/chrome/src/ui/locales/tl.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Tab',
'install.mock.screen': 'Screen',
'install.cta.title': 'Handa kapag handa ka na.',
+ 'install.scroll_hint': 'Mas maraming feature sa ibaba',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} sa {total}',
diff --git a/src/chrome/src/ui/locales/tr.js b/src/chrome/src/ui/locales/tr.js
index ccd99613b..8ca0c360c 100644
--- a/src/chrome/src/ui/locales/tr.js
+++ b/src/chrome/src/ui/locales/tr.js
@@ -200,6 +200,7 @@ export default {
'install.mock.tab': 'Sekme',
'install.mock.screen': 'Ekran',
'install.cta.title': 'Hazır olduğunda başla.',
+ 'install.scroll_hint': 'Aşağıda daha fazla özellik',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} / {total}',
diff --git a/src/chrome/src/ui/locales/uk.js b/src/chrome/src/ui/locales/uk.js
index 755cf8d2d..e49a02c99 100644
--- a/src/chrome/src/ui/locales/uk.js
+++ b/src/chrome/src/ui/locales/uk.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Вкладка',
'install.mock.screen': 'Екран',
'install.cta.title': 'Починаймо, коли будете готові.',
+ 'install.scroll_hint': 'Більше можливостей нижче',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} з {total}',
diff --git a/src/chrome/src/ui/locales/vi.js b/src/chrome/src/ui/locales/vi.js
index 925092bf2..60a7a0fa5 100644
--- a/src/chrome/src/ui/locales/vi.js
+++ b/src/chrome/src/ui/locales/vi.js
@@ -108,6 +108,7 @@ export default {
'install.mock.tab': 'Tab',
'install.mock.screen': 'Màn hình',
'install.cta.title': 'Sẵn sàng khi bạn sẵn sàng.',
+ 'install.scroll_hint': 'Thêm tính năng bên dưới',
// --- Sidepanel ---------------------------------------------------------
'sp.status.disconnected': "Đã ngắt kết nối",
diff --git a/src/chrome/src/ui/locales/zh.js b/src/chrome/src/ui/locales/zh.js
index 267fe19a7..ff8c70693 100644
--- a/src/chrome/src/ui/locales/zh.js
+++ b/src/chrome/src/ui/locales/zh.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': '标签页',
'install.mock.screen': '屏幕',
'install.cta.title': '准备好就开始。',
+ 'install.scroll_hint': '下方还有更多功能',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} / {total}',
diff --git a/src/firefox/src/ui/install-motion.js b/src/firefox/src/ui/install-motion.js
index 7e66fef0a..ef05e296b 100644
--- a/src/firefox/src/ui/install-motion.js
+++ b/src/firefox/src/ui/install-motion.js
@@ -139,3 +139,60 @@ export function initializeShowcaseAutoplay({
}
return stop;
}
+
+/**
+ * The hero looks complete in a laptop-sized window, so nothing says the page
+ * continues. A floating pill points down until the visitor finds the rest on
+ * their own: it never appears if the next section is already in view, and it
+ * goes for good once they scroll or click it. Returns a function that retires
+ * it early.
+ */
+export function initializeScrollCue({
+ documentLike = globalThis.document,
+ windowLike = globalThis.window,
+ delayMs = 1400,
+ scrolledPx = 120,
+} = {}) {
+ const cue = documentLike?.querySelector?.('[data-scroll-cue]');
+ const target = documentLike?.querySelector?.('.more-head');
+ const Observer = windowLike?.IntersectionObserver;
+ // Without the observer there is no way to tell when the cue stops being useful,
+ // so leave it hidden rather than let it sit over the content.
+ if (!cue || !target || typeof Observer !== 'function') return () => {};
+
+ let finished = false;
+ let revealTimer = null;
+ const nextFrame = windowLike.requestAnimationFrame?.bind(windowLike) || ((fn) => fn());
+
+ const observer = new Observer((entries) => {
+ if (entries.some((entry) => entry.isIntersecting)) dismiss();
+ }, { rootMargin: '0px 0px -12% 0px' });
+
+ function dismiss() {
+ if (finished) return;
+ finished = true;
+ windowLike.clearTimeout?.(revealTimer);
+ observer.disconnect();
+ windowLike.removeEventListener?.('scroll', onScroll);
+ cue.removeEventListener?.('click', dismiss);
+ cue.classList.remove('is-visible');
+ // Leave the layout and the tab order once the fade has finished.
+ windowLike.setTimeout(() => { cue.hidden = true; }, 400);
+ }
+ function onScroll() {
+ if ((windowLike.scrollY || 0) > scrolledPx) dismiss();
+ }
+
+ windowLike.addEventListener?.('scroll', onScroll, { passive: true });
+ cue.addEventListener('click', dismiss);
+ observer.observe(target);
+ revealTimer = windowLike.setTimeout(() => {
+ if (finished) return;
+ // A reload can restore a scroll position that is already past the hero.
+ if ((windowLike.scrollY || 0) > scrolledPx) { dismiss(); return; }
+ cue.hidden = false;
+ // Next frame, so the fade-in transition actually runs.
+ nextFrame(() => { if (!finished) cue.classList.add('is-visible'); });
+ }, delayMs);
+ return dismiss;
+}
diff --git a/src/firefox/src/ui/install-scenes.css b/src/firefox/src/ui/install-scenes.css
index 858d068dc..d16020511 100644
--- a/src/firefox/src/ui/install-scenes.css
+++ b/src/firefox/src/ui/install-scenes.css
@@ -1407,6 +1407,121 @@
translate: 0 0;
}
+/* ───────────────────────── scroll cue ───────────────────────── */
+
+/* The hero looks complete on a laptop-sized window, so a floating pill says the
+ page continues. install-motion.js shows it after a beat and retires it for
+ good once the visitor scrolls or clicks. */
+
+html {
+ scroll-padding-top: 16px;
+}
+
+@media (prefers-reduced-motion: no-preference) {
+ html {
+ scroll-behavior: smooth;
+ }
+}
+
+.scroll-cue {
+ position: fixed;
+ z-index: 30;
+ bottom: max(20px, env(safe-area-inset-bottom));
+ left: 50%;
+ display: inline-flex;
+ align-items: center;
+ gap: 10px;
+ padding: 8px 9px 8px 20px;
+ border: 1px solid color-mix(in srgb, var(--accent) 48%, var(--line));
+ border-radius: 999px;
+ background: color-mix(in srgb, var(--surface-strong) 84%, transparent);
+ -webkit-backdrop-filter: blur(16px) saturate(1.4);
+ backdrop-filter: blur(16px) saturate(1.4);
+ box-shadow:
+ 0 12px 36px color-mix(in srgb, var(--accent) 32%, transparent),
+ 0 2px 8px color-mix(in srgb, #0a0d1f 24%, transparent);
+ color: var(--text);
+ font-size: 14px;
+ font-weight: 650;
+ letter-spacing: -0.005em;
+ text-decoration: none;
+ white-space: nowrap;
+ opacity: 0;
+ translate: -50% 14px;
+ pointer-events: none;
+ transition:
+ opacity 360ms ease,
+ translate 360ms cubic-bezier(0.2, 0.8, 0.2, 1),
+ border-color 160ms ease,
+ background-color 160ms ease;
+}
+
+.scroll-cue[hidden] {
+ display: none;
+}
+
+.scroll-cue.is-visible {
+ opacity: 1;
+ translate: -50% 0;
+ pointer-events: auto;
+}
+
+.scroll-cue:hover {
+ border-color: var(--accent);
+ background: color-mix(in srgb, var(--surface-strong) 94%, transparent);
+}
+
+.scroll-cue:focus-visible {
+ outline: 2px solid var(--accent);
+ outline-offset: 3px;
+}
+
+.scroll-cue-arrow {
+ display: inline-grid;
+ flex: none;
+ place-items: center;
+ width: 28px;
+ height: 28px;
+ border-radius: 50%;
+ background: color-mix(in srgb, var(--accent) 24%, transparent);
+ color: var(--accent);
+}
+
+.scroll-cue-arrow svg {
+ width: 17px;
+ height: 17px;
+ fill: none;
+ stroke: currentColor;
+ stroke-width: 2.4;
+ stroke-linecap: round;
+ stroke-linejoin: round;
+}
+
+.scroll-cue.is-visible .scroll-cue-arrow svg {
+ animation: cue-bob 1.6s ease-in-out 600ms infinite;
+}
+
+@keyframes cue-bob {
+ 0%,
+ 100% {
+ translate: 0 -2px;
+ }
+
+ 50% {
+ translate: 0 3px;
+ }
+}
+
+@media (prefers-reduced-motion: reduce) {
+ .scroll-cue {
+ transition: none;
+ }
+
+ .scroll-cue.is-visible .scroll-cue-arrow svg {
+ animation: none;
+ }
+}
+
/* ───────────────────────── responsive ───────────────────────── */
@media (max-width: 1080px) {
diff --git a/src/firefox/src/ui/install.css b/src/firefox/src/ui/install.css
index ac7dc077d..7bdcdd6ee 100644
--- a/src/firefox/src/ui/install.css
+++ b/src/firefox/src/ui/install.css
@@ -138,6 +138,7 @@ kbd {
.install-hero {
flex: 1;
+ min-height: calc(100svh - 89px);
padding: clamp(54px, 8vh, 92px) 0 70px;
display: grid;
grid-template-columns: minmax(280px, 0.72fr) minmax(540px, 1.45fr);
diff --git a/src/firefox/src/ui/install.html b/src/firefox/src/ui/install.html
index 1771d5ef0..ac3f589ef 100644
--- a/src/firefox/src/ui/install.html
+++ b/src/firefox/src/ui/install.html
@@ -69,7 +69,7 @@
</aside>
</section>
- <section class="more" aria-labelledby="more-title">
+ <section class="more" id="more" aria-labelledby="more-title">
<div class="more-head" data-reveal>
<p class="eyebrow" data-i18n="install.more.eyebrow">Also built in</p>
<h2 id="more-title" class="more-title" data-i18n="install.more.title">Plenty more under the hood.</h2>
@@ -281,6 +281,13 @@
</section>
</main>
+ <a class="scroll-cue" href="#more" data-scroll-cue hidden>
+ <span data-i18n="install.scroll_hint">More features below</span>
+ <span class="scroll-cue-arrow" aria-hidden="true">
+ <svg viewBox="0 0 24 24"><path d="M6 9.5l6 6 6-6"/></svg>
+ </span>
+ </a>
+
<script type="module" src="install.js"></script>
</body>
</html>
diff --git a/src/firefox/src/ui/install.js b/src/firefox/src/ui/install.js
index a782be531..46660ca4a 100644
--- a/src/firefox/src/ui/install.js
+++ b/src/firefox/src/ui/install.js
@@ -2,6 +2,7 @@ import { applyDOMTranslations, t } from './i18n.js';
import {
initializeCardSpotlight,
initializeScenePlayback,
+ initializeScrollCue,
initializeShowcaseAutoplay,
startRecordingClock,
} from './install-motion.js';
@@ -143,6 +144,7 @@ function initializeMotion() {
try {
initializeShowcaseAutoplay({ select: (feature) => selectInstallFeature(feature) });
initializeScenePlayback();
+ initializeScrollCue();
initializeCardSpotlight();
startRecordingClock();
} catch (error) {
diff --git a/src/firefox/src/ui/locales/ar.js b/src/firefox/src/ui/locales/ar.js
index 23420337b..9cda8e595 100644
--- a/src/firefox/src/ui/locales/ar.js
+++ b/src/firefox/src/ui/locales/ar.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'علامة تبويب',
'install.mock.screen': 'الشاشة',
'install.cta.title': 'جاهز متى كنت جاهزًا.',
+ 'install.scroll_hint': 'المزيد من الميزات أدناه',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} من {total}',
diff --git a/src/firefox/src/ui/locales/bn.js b/src/firefox/src/ui/locales/bn.js
index 63594411d..f0cce196e 100644
--- a/src/firefox/src/ui/locales/bn.js
+++ b/src/firefox/src/ui/locales/bn.js
@@ -108,6 +108,7 @@ export default {
'install.mock.tab': 'ট্যাব',
'install.mock.screen': 'স্ক্রিন',
'install.cta.title': 'আপনি তৈরি হলেই শুরু করুন।',
+ 'install.scroll_hint': 'নিচে আরও ফিচার',
// --- Sidepanel ---------------------------------------------------------
'sp.status.disconnected': "সংযোগ বিচ্ছিন্ন",
diff --git a/src/firefox/src/ui/locales/de.js b/src/firefox/src/ui/locales/de.js
index 1aa3c7c54..e98adca6a 100644
--- a/src/firefox/src/ui/locales/de.js
+++ b/src/firefox/src/ui/locales/de.js
@@ -110,6 +110,7 @@ export default {
'install.mock.tab': 'Tab',
'install.mock.screen': 'Bildschirm',
'install.cta.title': 'Bereit, wenn Sie es sind.',
+ 'install.scroll_hint': 'Weitere Funktionen unten',
'sp.status.disconnected': 'Getrennt',
'sp.status.connected': 'Verbunden ({model})',
'sp.status.error': 'Fehler: {msg}',
diff --git a/src/firefox/src/ui/locales/en.js b/src/firefox/src/ui/locales/en.js
index 2ba99c17c..f06190f9c 100644
--- a/src/firefox/src/ui/locales/en.js
+++ b/src/firefox/src/ui/locales/en.js
@@ -108,6 +108,7 @@ export default {
'install.mock.tab': 'Tab',
'install.mock.screen': 'Screen',
'install.cta.title': 'Ready when you are.',
+ 'install.scroll_hint': 'More features below',
// --- Sidepanel ---------------------------------------------------------
'sp.status.disconnected': 'Disconnected',
diff --git a/src/firefox/src/ui/locales/es.js b/src/firefox/src/ui/locales/es.js
index e75848e4f..1a4b71883 100644
--- a/src/firefox/src/ui/locales/es.js
+++ b/src/firefox/src/ui/locales/es.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Pestaña',
'install.mock.screen': 'Pantalla',
'install.cta.title': 'Cuando quieras.',
+ 'install.scroll_hint': 'Más funciones abajo',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} de {total}',
diff --git a/src/firefox/src/ui/locales/fa.js b/src/firefox/src/ui/locales/fa.js
index e59c1462b..57ef4b3c4 100644
--- a/src/firefox/src/ui/locales/fa.js
+++ b/src/firefox/src/ui/locales/fa.js
@@ -108,6 +108,7 @@ export default {
'install.mock.tab': 'زبانه',
'install.mock.screen': 'صفحه‌نمایش',
'install.cta.title': 'هر وقت آماده بودید.',
+ 'install.scroll_hint': 'امکانات بیشتر در پایین',
// --- Sidepanel ---------------------------------------------------------
'sp.status.disconnected': "قطع شد",
diff --git a/src/firefox/src/ui/locales/fr.js b/src/firefox/src/ui/locales/fr.js
index f28fff881..94d74517c 100644
--- a/src/firefox/src/ui/locales/fr.js
+++ b/src/firefox/src/ui/locales/fr.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Onglet',
'install.mock.screen': 'Écran',
'install.cta.title': 'Prêt quand vous l’êtes.',
+ 'install.scroll_hint': 'Plus de fonctionnalités ci-dessous',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} sur {total}',
diff --git a/src/firefox/src/ui/locales/he.js b/src/firefox/src/ui/locales/he.js
index 477477f0c..d8ee784c4 100644
--- a/src/firefox/src/ui/locales/he.js
+++ b/src/firefox/src/ui/locales/he.js
@@ -124,6 +124,7 @@ export default {
'install.mock.tab': 'לשונית',
'install.mock.screen': 'מסך',
'install.cta.title': 'מוכנים כשתהיו מוכנים.',
+ 'install.scroll_hint': 'עוד תכונות למטה',
"sp.status.disconnected": "לא מחובר",
"sp.status.connected": "מחובר ({model})",
"sp.status.error": "שגיאה: {msg}",
diff --git a/src/firefox/src/ui/locales/hi.js b/src/firefox/src/ui/locales/hi.js
index f3e4d3bed..a15e717e6 100644
--- a/src/firefox/src/ui/locales/hi.js
+++ b/src/firefox/src/ui/locales/hi.js
@@ -108,6 +108,7 @@ export default {
'install.mock.tab': 'टैब',
'install.mock.screen': 'स्क्रीन',
'install.cta.title': 'जब आप तैयार हों।',
+ 'install.scroll_hint': 'नीचे और सुविधाएँ',
// --- Sidepanel ---------------------------------------------------------
'sp.status.disconnected': "विच्छेदित",
diff --git a/src/firefox/src/ui/locales/id.js b/src/firefox/src/ui/locales/id.js
index cae52e59e..03eeaf6d0 100644
--- a/src/firefox/src/ui/locales/id.js
+++ b/src/firefox/src/ui/locales/id.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Tab',
'install.mock.screen': 'Layar',
'install.cta.title': 'Siap saat Anda siap.',
+ 'install.scroll_hint': 'Fitur lainnya di bawah',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} dari {total}',
diff --git a/src/firefox/src/ui/locales/ja.js b/src/firefox/src/ui/locales/ja.js
index 4fb426636..43e12b42d 100644
--- a/src/firefox/src/ui/locales/ja.js
+++ b/src/firefox/src/ui/locales/ja.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'タブ',
'install.mock.screen': '画面',
'install.cta.title': '準備ができたら、どうぞ。',
+ 'install.scroll_hint': '下にさらに機能があります',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} / {total}',
diff --git a/src/firefox/src/ui/locales/ko.js b/src/firefox/src/ui/locales/ko.js
index df9b35993..117e08399 100644
--- a/src/firefox/src/ui/locales/ko.js
+++ b/src/firefox/src/ui/locales/ko.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': '탭',
'install.mock.screen': '화면',
'install.cta.title': '준비되면 시작하세요.',
+ 'install.scroll_hint': '아래에 더 많은 기능',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} / {total}',
diff --git a/src/firefox/src/ui/locales/ms.js b/src/firefox/src/ui/locales/ms.js
index 6bc8d3b33..6db658b49 100644
--- a/src/firefox/src/ui/locales/ms.js
+++ b/src/firefox/src/ui/locales/ms.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Tab',
'install.mock.screen': 'Skrin',
'install.cta.title': 'Sedia apabila anda sedia.',
+ 'install.scroll_hint': 'Lebih banyak ciri di bawah',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} daripada {total}',
diff --git a/src/firefox/src/ui/locales/nl.js b/src/firefox/src/ui/locales/nl.js
index b7c88cac8..619577923 100644
--- a/src/firefox/src/ui/locales/nl.js
+++ b/src/firefox/src/ui/locales/nl.js
@@ -110,6 +110,7 @@ export default {
'install.mock.tab': 'Tabblad',
'install.mock.screen': 'Scherm',
'install.cta.title': 'Klaar wanneer jij dat bent.',
+ 'install.scroll_hint': 'Meer functies hieronder',
'sp.status.disconnected': 'Niet verbonden',
'sp.status.connected': 'Verbonden ({model})',
'sp.status.error': 'Fout: {msg}',
diff --git a/src/firefox/src/ui/locales/pl.js b/src/firefox/src/ui/locales/pl.js
index b9d2322d2..cbde46dae 100644
--- a/src/firefox/src/ui/locales/pl.js
+++ b/src/firefox/src/ui/locales/pl.js
@@ -110,6 +110,7 @@ export default {
'install.mock.tab': 'Karta',
'install.mock.screen': 'Ekran',
'install.cta.title': 'Gotowe, kiedy ty.',
+ 'install.scroll_hint': 'Więcej funkcji poniżej',
'sp.status.disconnected': 'Rozłączono',
'sp.status.connected': 'Połączono ({model})',
'sp.status.error': 'Błąd: {msg}',
diff --git a/src/firefox/src/ui/locales/pt.js b/src/firefox/src/ui/locales/pt.js
index 4d40f049a..71f517c75 100644
--- a/src/firefox/src/ui/locales/pt.js
+++ b/src/firefox/src/ui/locales/pt.js
@@ -108,6 +108,7 @@ export default {
'install.mock.tab': 'Aba',
'install.mock.screen': 'Tela',
'install.cta.title': 'Pronto quando você estiver.',
+ 'install.scroll_hint': 'Mais recursos abaixo',
// --- Sidepanel ---------------------------------------------------------
'sp.status.disconnected': "Desconectado",
diff --git a/src/firefox/src/ui/locales/ru.js b/src/firefox/src/ui/locales/ru.js
index cfd11d205..731d90a41 100644
--- a/src/firefox/src/ui/locales/ru.js
+++ b/src/firefox/src/ui/locales/ru.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Вкладка',
'install.mock.screen': 'Экран',
'install.cta.title': 'Начнём, когда будете готовы.',
+ 'install.scroll_hint': 'Больше возможностей ниже',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} из {total}',
diff --git a/src/firefox/src/ui/locales/th.js b/src/firefox/src/ui/locales/th.js
index 35d64fb28..33864405e 100644
--- a/src/firefox/src/ui/locales/th.js
+++ b/src/firefox/src/ui/locales/th.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'แท็บ',
'install.mock.screen': 'หน้าจอ',
'install.cta.title': 'พร้อมเมื่อคุณพร้อม',
+ 'install.scroll_hint': 'ฟีเจอร์เพิ่มเติมด้านล่าง',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} จาก {total}',
diff --git a/src/firefox/src/ui/locales/tl.js b/src/firefox/src/ui/locales/tl.js
index 299165183..984e8f802 100644
--- a/src/firefox/src/ui/locales/tl.js
+++ b/src/firefox/src/ui/locales/tl.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Tab',
'install.mock.screen': 'Screen',
'install.cta.title': 'Handa kapag handa ka na.',
+ 'install.scroll_hint': 'Mas maraming feature sa ibaba',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} sa {total}',
diff --git a/src/firefox/src/ui/locales/tr.js b/src/firefox/src/ui/locales/tr.js
index c5ba1a98a..e465bbc9b 100644
--- a/src/firefox/src/ui/locales/tr.js
+++ b/src/firefox/src/ui/locales/tr.js
@@ -200,6 +200,7 @@ export default {
'install.mock.tab': 'Sekme',
'install.mock.screen': 'Ekran',
'install.cta.title': 'Hazır olduğunda başla.',
+ 'install.scroll_hint': 'Aşağıda daha fazla özellik',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} / {total}',
diff --git a/src/firefox/src/ui/locales/uk.js b/src/firefox/src/ui/locales/uk.js
index 8c0dbd145..54af501a0 100644
--- a/src/firefox/src/ui/locales/uk.js
+++ b/src/firefox/src/ui/locales/uk.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': 'Вкладка',
'install.mock.screen': 'Екран',
'install.cta.title': 'Починаймо, коли будете готові.',
+ 'install.scroll_hint': 'Більше можливостей нижче',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} з {total}',
diff --git a/src/firefox/src/ui/locales/vi.js b/src/firefox/src/ui/locales/vi.js
index 7b0ad7968..ffbd369f0 100644
--- a/src/firefox/src/ui/locales/vi.js
+++ b/src/firefox/src/ui/locales/vi.js
@@ -108,6 +108,7 @@ export default {
'install.mock.tab': 'Tab',
'install.mock.screen': 'Màn hình',
'install.cta.title': 'Sẵn sàng khi bạn sẵn sàng.',
+ 'install.scroll_hint': 'Thêm tính năng bên dưới',
// --- Sidepanel ---------------------------------------------------------
'sp.status.disconnected': "Đã ngắt kết nối",
diff --git a/src/firefox/src/ui/locales/zh.js b/src/firefox/src/ui/locales/zh.js
index 35456ae53..6330b8924 100644
--- a/src/firefox/src/ui/locales/zh.js
+++ b/src/firefox/src/ui/locales/zh.js
@@ -164,6 +164,7 @@ export default {
'install.mock.tab': '标签页',
'install.mock.screen': '屏幕',
'install.cta.title': '准备好就开始。',
+ 'install.scroll_hint': '下方还有更多功能',
// --- Onboarding --------------------------------------------------------
'ob.step': '{current} / {total}',
diff --git a/test/run.js b/test/run.js
index fea01b056..3eb86bc03 100644
--- a/test/run.js
+++ b/test/run.js
@@ -44149,6 +44149,13 @@ test('first install opens a browser-aware panel launcher without fake toolbar co
assert.match(html, /\/screenshot --full-page|data-i18n-html="install\.shot\.body_html"/, `${label}: the screenshot card should show its command`);
assert.match(html, /<button class="open-panel-button" type="button" data-open-panel-mirror disabled>/, `${label}: closing call-to-action should start disabled like the primary one`);
assert.equal((html.match(/id="open-panel-button"/g) || []).length, 1, `${label}: only one primary panel-open button should exist`);
+ // The hero looks complete in a laptop-sized window, so a floating cue says the page continues.
+ assert.match(html, /<section class="more" id="more"/, `${label}: the cue needs a section to scroll to`);
+ assert.match(html, /<a class="scroll-cue" href="#more" data-scroll-cue hidden>[\s\S]*?data-i18n="install\.scroll_hint"[\s\S]*?<\/a>/, `${label}: scroll cue should start hidden, link to the next section and be localized`);
+ assert.match(css, /\.install-hero \{[^}]*min-height: calc\(100svh - 89px\);/, `${label}: the hero should fill the first screen so the next section starts at the fold`);
+ assert.match(sceneCss, /\.scroll-cue \{[\s\S]*?position: fixed;/, `${label}: scroll cue should float above the page`);
+ assert.match(sceneCss, /@media \(prefers-reduced-motion: no-preference\) \{\s*html \{\s*scroll-behavior: smooth;/, `${label}: smooth scrolling should only apply when motion is allowed`);
+ assert.match(sceneCss, /@media \(prefers-reduced-motion: reduce\) \{\s*\.scroll-cue \{\s*transition: none;/, `${label}: scroll cue should not animate for reduced-motion visitors`);
assert.match(installJs, /mirror\.addEventListener\('click', \(\) => openButton\.click\(\)\)/, `${label}: closing call-to-action should forward to the primary open action`);
assert.doesNotMatch(motionJs, /\b(?:fetch|XMLHttpRequest|chrome\.|browser\.)/, `${label}: install motion helpers should stay purely presentational`);
const installEnglish = (await import(pathToFileURL(path.join(ROOT, prefix, 'src/ui/locales/en.js')).href)).default;
@@ -44205,6 +44212,72 @@ test('first install opens a browser-aware panel launcher without fake toolbar co
select() {},
});
assert.equal(reducedClasses.size, 0, `${label}: reduced-motion visitors should not get auto-rotating tabs`);
+
+ const cueHarness = ({ scrollY = 0, observer = true } = {}) => {
+ const timers = [];
+ const windowListeners = new Map();
+ const cueListeners = new Map();
+ const cueClasses = new Set();
+ let intersect = null;
+ const cue = {
+ hidden: true,
+ classList: { add: (name) => cueClasses.add(name), remove: (name) => cueClasses.delete(name) },
+ addEventListener: (type, fn) => cueListeners.set(type, fn),
+ removeEventListener: (type) => cueListeners.delete(type),
+ };
+ const win = {
+ scrollY,
+ IntersectionObserver: observer ? class { constructor(callback) { intersect = callback; } observe() {} disconnect() {} } : undefined,
+ setTimeout: (fn, ms) => { timers.push({ fn, ms }); return timers.length; },
+ clearTimeout: (id) => { if (timers[id - 1]) timers[id - 1].fn = () => {}; },
+ requestAnimationFrame: (fn) => fn(),
+ addEventListener: (type, fn) => windowListeners.set(type, fn),
+ removeEventListener: (type) => windowListeners.delete(type),
+ };
+ const doc = { querySelector: (selector) => (selector === '[data-scroll-cue]' ? cue : {}) };
+ return { cue, cueClasses, cueListeners, win, doc, timers, windowListeners, inView: (value) => intersect([{ isIntersecting: value }]) };
+ };
+ {
+ const h = cueHarness();
+ motion.initializeScrollCue({ documentLike: h.doc, windowLike: h.win, delayMs: 1400 });
+ assert.equal(h.timers[0].ms, 1400, `${label}: the cue should wait a beat so the hero entrance finishes first`);
+ assert.equal(h.cue.hidden, true, `${label}: the cue should stay hidden until its delay has passed`);
+ h.timers[0].fn();
+ assert.equal(h.cue.hidden, false, `${label}: the cue should appear after the delay`);
+ assert.ok(h.cueClasses.has('is-visible'), `${label}: the cue should fade in`);
+ h.win.scrollY = 300;
+ h.windowListeners.get('scroll')();
+ assert.equal(h.cueClasses.has('is-visible'), false, `${label}: scrolling should retire the cue`);
+ h.timers.at(-1).fn();
+ assert.equal(h.cue.hidden, true, `${label}: a retired cue should leave the layout and the tab order`);
+ assert.equal(h.windowListeners.has('scroll'), false, `${label}: a retired cue should release its scroll listener`);
+ }
+ {
+ const h = cueHarness();
+ motion.initializeScrollCue({ documentLike: h.doc, windowLike: h.win });
+ h.inView(true);
+ h.timers[0].fn();
+ assert.equal(h.cueClasses.has('is-visible'), false, `${label}: the cue should never show when the next section is already on screen`);
+ }
+ {
+ const h = cueHarness({ scrollY: 900 });
+ motion.initializeScrollCue({ documentLike: h.doc, windowLike: h.win });
+ h.timers[0].fn();
+ assert.equal(h.cueClasses.has('is-visible'), false, `${label}: a restored scroll position past the hero should not summon the cue`);
+ }
+ {
+ const h = cueHarness();
+ motion.initializeScrollCue({ documentLike: h.doc, windowLike: h.win });
+ h.timers[0].fn();
+ h.cueListeners.get('click')();
+ assert.equal(h.cueClasses.has('is-visible'), false, `${label}: clicking the cue should retire it`);
+ }
+ {
+ const h = cueHarness({ observer: false });
+ motion.initializeScrollCue({ documentLike: h.doc, windowLike: h.win });
+ assert.equal(h.timers.length, 0, `${label}: without IntersectionObserver the cue should stay out of the way`);
+ assert.equal(h.cue.hidden, true, `${label}: without IntersectionObserver the cue should stay hidden`);
+ }
for (const asset of [
'02-tell-the-browser.png',
'03-ask-any-page.png',
@@ -44434,14 +44507,14 @@ test('first install opens a browser-aware panel launcher without fake toolbar co
const chromeLocale = (await import(pathToFileURL(path.join(ROOT, 'src/chrome/src/ui/locales', filename)).href)).default;
const firefoxLocale = (await import(pathToFileURL(path.join(ROOT, 'src/firefox/src/ui/locales', filename)).href)).default;
const installKeys = Object.keys(chromeLocale).filter((key) => key.startsWith('install.'));
- assert.equal(installKeys.length, 60, `${filename}: install guide should translate every user-facing string`);
+ assert.equal(installKeys.length, 61, `${filename}: install guide should translate every user-facing string`);
assert.ok(chromeLocale['install.showcase.ask.title'], `${filename}: Ask showcase headline should be translated`);
assert.ok(chromeLocale['install.showcase.apocalypse.body'], `${filename}: Apocalypse showcase body should be translated`);
for (const key of [
'install.more.eyebrow', 'install.more.title', 'install.more.body',
'install.shot.title', 'install.shot.body_html', 'install.dl.title', 'install.dl.body',
'install.captcha.title', 'install.captcha.body', 'install.safesocial.title', 'install.safesocial.body',
- 'install.record.title', 'install.record.body_html', 'install.cta.title',
+ 'install.record.title', 'install.record.body_html', 'install.cta.title', 'install.scroll_hint',
'install.mock.files', 'install.mock.offline', 'install.mock.not_robot', 'install.mock.captcha_blocked',
'install.mock.captcha_sent', 'install.mock.captcha_waiting', 'install.mock.captcha_note',
'install.mock.show_image', 'install.mock.safesocial_note', 'install.mock.tab', 'install.mock.screen',