feat(apollo-vertex): multi-step form wizard and stepper [AGVSOL-4703]

[frankkluijtmans]

⚠️ Important: Please check the component page on the preview deployment for more details. This is PR #1 in a 2 PR series. The second will expand a bit on using it in headless mode for more customizability.

Adds multi-step wizard forms to Apollo Vertex, built on TanStack Form's composition model. Values are nested per step, and each step is a withForm component that validates its own slice through a FormGroup on advance; the full-form schema passed to useFormWizard is only the final-submit backstop (onDynamic). The wizard supports conditional steps (hidden from navigation and the stepper) and optional localStorage persistence (via useLocalStorage from @mantine/hooks) that hydrates and clears automatically. A new composable, shadcn-native Stepper primitive backs the progress indicator and is independently installable. Includes a demo, docs page, nav entry, and i18n keys, with typecheck, lint, format, and registry build all passing.

👨 Generated with Kluijt 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	Jul 20, 2026, 01:25:51 AM
apollo-docs	🟢 Ready	Preview, Logs	Jul 20, 2026, 01:25:51 AM
apollo-landing	🟢 Ready	Preview, Logs	Jul 20, 2026, 01:25:51 AM
apollo-vertex	🟢 Ready	Preview, Logs	Jul 20, 2026, 01:25:51 AM

[github-actions]

📊 Coverage + size by package

Per-package bundle size on this PR (no JS/TS source changes detected under packages/* or web-packages/*).

Package	Coverage	New-line coverage	Packed (gzip)	Unpacked	vs main
@uipath/apollo-core	9.0%	—	43.82 MB	57.31 MB	±0
@uipath/apollo-react	37.3%	—	7.38 MB	28.15 MB	±0
@uipath/apollo-wind	41.0%	—	397.5 KB	2.58 MB	−16 B
@uipath/ap-chat	85.8%	—	43.43 MB	55.92 MB	±0

_{"Coverage" is each package's own coverage.include scope (e.g. apollo-core instruments only scripts/). "Packed"/"Unpacked" come from npm pack --dry-run and only cover built packages — "—" means not measured this run (package not affected / not built). "vs main" is the packed (gzipped) delta against the last successful main build (the package-sizes artifact from the Release workflow); "—" there means no main baseline was available this run. The baseline is main's latest build, not this PR's exact merge-base, so it includes any drift since the branch diverged. Packages with no vitest config are omitted.}

[Copilot]

Pull request overview

Adds a new multi-step form wizard feature to Apollo Vertex (the Vertex docs/demo app), building on the existing TanStack Form + Zod patterns and introducing a reusable Stepper primitive for progress indication.

Changes:

• Introduces a composable Stepper UI primitive and registers it for installation.
• Adds FormWizard components + useFormWizard hook with conditional steps, per-step schema picking, and optional local/session persistence.
• Adds demo + docs page + navigation metadata + i18n keys, and wires required dependencies.

Reviewed changes

Copilot reviewed 13 out of 14 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
pnpm-lock.yaml	Updates lockfile for new deps and re-resolution; currently includes GitHub Packages tarball URLs for @uipath/*.
apps/apollo-vertex/tsconfig.json	Adds path aliases for the new form-wizard and stepper components.
apps/apollo-vertex/registry/stepper/stepper.tsx	New Stepper primitive (orientation + states + composed subparts).
apps/apollo-vertex/registry/form-wizard/wizard-schema.ts	Step definition types + visible-step filtering + per-step schema picking helpers.
apps/apollo-vertex/registry/form-wizard/use-form-wizard.ts	New wizard hook: navigation, per-step validation, conditional visibility, persistence.
apps/apollo-vertex/registry/form-wizard/index.ts	Public exports for the form-wizard package.
apps/apollo-vertex/registry/form-wizard/form-wizard.tsx	Wizard container + Stepper-backed steps rendering + step slot component.
apps/apollo-vertex/registry/form-wizard/form-wizard-nav.tsx	Back/Next/Submit navigation controls with i18n labels.
apps/apollo-vertex/registry.json	Registers stepper and form-wizard for the registry installer.
apps/apollo-vertex/package.json	Adds @tanstack/react-store dependency.
apps/apollo-vertex/locales/en.json	Adds wizard demo + navigation i18n strings.
apps/apollo-vertex/app/components/form-wizard/page.mdx	New docs page describing installation and usage.
apps/apollo-vertex/app/components/form-wizard/form-wizard-demo.tsx	New demo showing conditional step + session persistence + translated validation keys.
apps/apollo-vertex/app/components/_meta.ts	Adds docs nav entry for the new Form Wizard page.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file

[Copilot]

Pull request overview

Copilot reviewed 13 out of 14 changed files in this pull request and generated 3 comments.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file

[Copilot]

Pull request overview

Copilot reviewed 13 out of 14 changed files in this pull request and generated 5 comments.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file

[github-actions]

Dependency License Review

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

License distribution

License	Packages
MIT	1720
ISC	89
Apache-2.0	55
BSD-3-Clause	27
BSD-2-Clause	23
BlueOak-1.0.0	8
MPL-2.0	4
MIT-0	3
CC0-1.0	3
MIT OR Apache-2.0	2
(MIT OR Apache-2.0)	2
Unlicense	2
LGPL-3.0-or-later	1
Python-2.0	1
CC-BY-4.0	1
(MPL-2.0 OR Apache-2.0)	1
Unknown	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
khroma	2.1.0	Unknown	MIT per GitHub repo, missing license field in package.json

[Copilot]

Pull request overview

Copilot reviewed 13 out of 14 changed files in this pull request and generated 2 comments.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file

[Copilot]

Pull request overview

Copilot reviewed 20 out of 21 changed files in this pull request and generated 3 comments.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file

[Copilot]

Pull request overview

Copilot reviewed 20 out of 21 changed files in this pull request and generated 5 comments.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file

[Copilot]

Pull request overview

Copilot reviewed 20 out of 21 changed files in this pull request and generated 4 comments.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file

[Copilot]

Pull request overview

Copilot reviewed 20 out of 21 changed files in this pull request and generated 5 comments.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file

[Copilot]

Pull request overview

Copilot reviewed 20 out of 21 changed files in this pull request and generated 1 comment.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file