Skip to content

feat(Tour): add createTour and Tour compound - #178

Draft
johnleider wants to merge 5 commits into
devfrom
feat/tour
Draft

johnleider wants to merge 5 commits into
devfrom
feat/tour

Conversation

@johnleider

@johnleider johnleider commented Apr 3, 2026

Copy link
Copy Markdown
Member

Summary

Revives this draft onto current dev. The July useTour plugin diff was 360 commits behind and did not merge; the implementation that replaces it is createTour.

  • createTour — step sequencer on createStep, activator registry, form-gated next/jump, enter/leave/completed handlers. Steps are register/onboard, not an items option.
  • createTourContext / useTour — provide/inject for the compound. Not a plugin.
  • Tour compound — Root, Activator, Highlight, Content, Keyboard, Title, Description, Progress, Prev, Next, Skip.
  • Docs, examples, changeset, maturity (preview is not claimed here; entries stay at the level the commit sets).

feat/create-tour was the same tree with no PR. This branch is now the one implementation.

Test plan

  • vitest run --project v0:unitcreateTour, surface.test.ts, locale messages (24 tests)
  • vitest run --project v0:browserTour/index.browser.test.ts (7 tests)
  • pnpm typecheck
  • pnpm lint:fix
  • pnpm build:docs
  • Manual: tour example (start, next, prev, skip, highlight cutout, keyboard)

@pkg-pr-new

pkg-pr-new Bot commented Apr 3, 2026

Copy link
Copy Markdown

Open in StackBlitz

commit: 70afe48

@johnleider
johnleider marked this pull request as draft April 6, 2026 16:33
Headless guided tour plugin composing createStep, createRegistry,
and createForm. Includes 11 compound components (Root, Content,
Activator, Highlight, Keyboard, Title, Description, Progress,
Prev, Next, Skip), docs pages, examples, and tests.
# Conflicts:
#	apps/docs/src/pages/components/index.md
#	apps/docs/src/pages/composables/index.md
#	apps/docs/src/typed-router.d.ts
#	packages/0/README.md
#	packages/0/src/components/index.ts
#	packages/0/src/composables/index.ts
#	packages/0/src/maturity.json
@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Changeset found — this change will be included in the next release. Thanks!

@johnleider
johnleider changed the base branch from master to dev July 23, 2026 14:18
The July useTour draft does not carry onto current dev. Adopt the
createTour primitive and Tour compound so this branch is the one
implementation.
@johnleider johnleider changed the title feat(Tour): add Tour component and useTour composable feat(Tour): add createTour and Tour compound Sep 22, 2026
Content is not aria-modal. Escape dismisses it, focus returns to the
opener, and complete() runs the form gate. Bare steps center with a
full scrim. Promoted portals move back to the top of the stack when
a later overlay opens.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant