feat(apollo-vertex): onboarding tour — provider and welcome modal

[petervachon]

Summary

Second in a 3-part stack. Adds the behavioral layer that makes the tour
actually run — the provider that manages tour state and step sequencing,
and the welcome modal that greets users before the first spotlight step.

Stacked on #674.

What's included

• OnboardingTourProvider — orchestrates the full tour lifecycle:
  starting a tour, advancing through steps, handling back navigation,
  conditional step gating via waitFor, and marking tours complete
• OnboardingTourJoyrideWelcomeModal — full-screen modal for the
  first step of a tour, rendered outside Joyride while the spotlight
  is paused
• Reactive dark mode — overlay color updates immediately when the
  user switches themes, including mid-tour

What's next

• PR 3 (draft): docs page with live demo and installation guide

Test plan

• pnpm --filter apollo-vertex build passes
• Tour starts, advances, and completes correctly
• Back navigation works
• waitFor gating pauses and resumes correctly
• Overlay color updates correctly when switching dark/light mode mid-tour

🤖 Generated with Claude Code

[github-actions]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (PT)
apollo-design	🟢 Ready	Preview, Logs	May 11, 2026, 07:47:51 AM
apollo-docs	🟢 Ready	Preview, Logs	May 11, 2026, 07:48:31 AM
apollo-landing	🟢 Ready	Preview, Logs	May 11, 2026, 07:47:33 AM
apollo-ui-react	🟢 Ready	Preview, Logs	May 11, 2026, 07:47:45 AM
apollo-vertex	🟢 Ready	Preview, Logs	May 11, 2026, 07:49:10 AM

[github-actions]

Dependency License Review

• ✅ 2114 package(s) scanned
• ✅ No license issues found
• ⚠️ 15 package(s) excluded (see details below)

License distribution

License	Packages
MIT	1834
ISC	105
Apache-2.0	69
BSD-3-Clause	30
BSD-2-Clause	24
Copyright 2022, UiPath, all rights reserved	9
BlueOak-1.0.0	8
MPL-2.0	5
MIT OR Apache-2.0	3
MIT-0	3
Unknown	3
Unlicense	3
CC0-1.0	3
LGPL-3.0-or-later	2
(MIT OR Apache-2.0)	2
Python-2.0	1
CC-BY-4.0	1
(MPL-2.0 OR Apache-2.0)	1
BSD	1
Artistic-2.0	1
(WTFPL OR MIT)	1
(BSD-2-Clause OR MIT OR Apache-2.0)	1
CC-BY-3.0	1
0BSD	1
(MIT OR CC0-1.0)	1
MIT AND ISC	1

Excluded packages

Package	Version	License	Reason
@img/sharp-libvips-linux-x64	1.2.4	LGPL-3.0-or-later	LGPL pre-built binary, not linked
@img/sharp-libvips-linuxmusl-x64	1.2.4	LGPL-3.0-or-later	LGPL pre-built binary, not linked
@uipath/apollo-angular-elements	5.89.0	Copyright 2022, UiPath, all rights reserved	UiPath first-party package
@uipath/apollo-core	4.35.0, 4.35.1, 4.35.2	Copyright 2022, UiPath, all rights reserved	UiPath first-party package
@uipath/apollo-fonts	1.25.8	Copyright 2022, UiPath, all rights reserved	UiPath first-party package
@uipath/apollo-icons	1.33.7	Copyright 2022, UiPath, all rights reserved	UiPath first-party package
@uipath/apollo-mui5	2.31.26, 2.31.27	Copyright 2022, UiPath, all rights reserved	UiPath first-party package
@uipath/portal-shell	3.351.4	Copyright 2022, UiPath, all rights reserved	UiPath first-party package
@uipath/portal-shell-react	3.149.36	Copyright 2022, UiPath, all rights reserved	UiPath first-party package
@uipath/portal-shell-types	3.326.0	Copyright 2022, UiPath, all rights reserved	UiPath first-party package
@uipath/portal-shell-util	1.114.0	Copyright 2022, UiPath, all rights reserved	UiPath first-party package
@uipath/apollo-lab	25.12.0	Unknown	UiPath first-party package
@uipath/telemetry-client-web	5.1.0	Unknown	UiPath first-party package
khroma	2.1.0	Unknown	MIT per GitHub repo, missing license field in package.json
hyperx	2.5.4	BSD	BSD-2-Clause per LICENSE file, non-SPDX "BSD" in package.json