feat: remove react-router-dom dependency via RouterProvider + UIKitProvider

[misama-ct]

Caution

This PR was created to try out the freshly added AI Agent tooling. Do not merge without thorough review and CI validation.

Summary

• Remove react-router-dom as a peer dependency from all published ui-kit packages
• Introduce @commercetools-uikit/router-provider — provides a RouterProvider context with a navigate function, useNavigate hook, shouldNavigate modifier-key guard, TLocationDescriptor types, and locationDescriptorToString utility
• Introduce @commercetools-uikit/ui-kit-provider — consumer-facing UIKitProvider that composes RouterProvider (and future providers) via a router prop
• Migrate 5 components (link, link-button, secondary-button, card, tag) from rendering react-router's <Link> to rendering <a> tags with navigate() on click
• Update test infrastructure, stories, visual-testing-app, and preset re-exports

Consumer impact (merchant-center)

1. Add UIKitProvider at app root (one-time setup):

   import { UIKitProvider } from '@commercetools-uikit/ui-kit-provider';
   import { useHistory } from 'react-router-dom';
   
   const history = useHistory();
   <UIKitProvider router={{ navigate: history.push }}>
     <App />
   </UIKitProvider>

2. No component prop changes — to still accepts string | { pathname, search, hash, state }
3. react-router-dom is no longer a peer dep of any ui-kit package
4. as={Link} pattern on buttons (e.g. <SecondaryButton as={Link} to="/foo" />) can be simplified to <SecondaryButton to="/foo" /> — but as is still respected when explicitly provided

Architecture

@commercetools-uikit/router-provider    (standalone)
├── RouterProvider — context with { navigate } config
├── useNavigate() — hook consumed by components
├── shouldNavigate() — modifier-key guard (Ctrl/Cmd/Shift/Alt)
├── TLocationDescriptor — type (replaces history's LocationDescriptor)
└── locationDescriptorToString() — fallback href builder

@commercetools-uikit/ui-kit-provider    (standalone, depends on router-provider)
└── UIKitProvider — consumer-facing, wraps RouterProvider via router prop

Components (link, link-button, secondary-button, card, tag)
└── depend on router-provider for useNavigate + shouldNavigate + types
└── render <a href="..."> tags, intercept clicks via navigate()
└── modifier keys (Ctrl/Cmd+click, Shift+click, Alt+click) fall through
    to default browser behavior

Commit review order

#	Commit	What to review
1	feat: add router-provider and ui-kit-provider packages	New packages in isolation — types, context, provider, utils
2	refactor: migrate components from react-router-dom to router-provider	Component source + package.json changes
3	chore: update tests, stories, presets, and remove react-router-dom peer deps	Supporting infrastructure
4	test: remove BrowserRouter wrapper from card.spec.tsx	One test file (split out due to pre-existing tsc-files hook issue)
5	fix: add modifier-key guard and respect as prop on SecondaryButton	shouldNavigate() guard in all 5 components + as prop fix

Test plan

• yarn typecheck — 0 errors
• yarn test — 125 suites, 1402 tests pass
• yarn build — builds successfully
• Verify storybook renders link/card/tag stories correctly
• Verify visual-testing-app works
• Verify no react-router-dom imports in published package source

🤖 Generated with Claude Code

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
ui-kit	Ready	Preview, Comment	Apr 2, 2026 7:13am

[changeset-bot]

⚠️ No Changeset found

Latest commit: 7f122ad

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR