feat(link)!: require URL resolver injection

[ENvironmentSet]

Summary

• Make Link consume the resolver supplied through LinkUrlResolverProvider.
• Keep URL generation aligned with the routing plugin's route selection, encoding, and URL pattern options.
• Remove Link's direct dependency on @stackflow/plugin-history-sync, allowing history-sync or another routing implementation to provide the resolver.

Resolves FEP-2677.

[changeset-bot]

🦋 Changeset detected

Latest commit: 5b41f8b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@stackflow/link	Major
@stackflow/demo	Patch

Not sure what this means? Click here to learn what changesets are.

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

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 0a432068-eb7b-431b-8bd5-725d0bca5b60

📥 Commits

Reviewing files that changed from the base of the PR and between 6cbc7a2 and 5b41f8b.

⛔ Files ignored due to path filters (1)

• yarn.lock is excluded by !**/yarn.lock, !**/*.lock

📒 Files selected for processing (7)

• .changeset/fep-2677-link-url-resolver.md
• .pnp.cjs
• extensions/link/README.md
• extensions/link/package.json
• extensions/link/src/Link.tsx
• extensions/link/src/LinkUrlResolverContext.tsx
• extensions/link/src/index.ts

Disabled knowledge base sources:

• Jira integration is disabled
• Linear integration is disabled

You can enable these sources in your CodeRabbit configuration.

---

📝 Walkthrough

Summary by CodeRabbit

• New Features

  • Added configurable URL resolution for links through LinkUrlResolverProvider.
  • Links can now use URL resolvers from history synchronization or other routing integrations.
  • Added a hook and public API for accessing the configured URL resolver.

• Documentation

  • Updated setup instructions and examples for configuring link URL resolution.

• Breaking Changes

  • Link integrations must now provide a URL resolver through the provider.

Walkthrough

The Link package now uses a public LinkUrlResolverProvider API for activity URL generation. It removes its direct history-sync dependency, updates documentation and release metadata, and regenerates Plug'n'Play dependency metadata.

Changes

Link URL resolver API

Layer / File(s)	Summary
Resolver contract and provider extensions/link/src/LinkUrlResolverContext.tsx, extensions/link/src/index.ts	Adds the LinkUrlResolver contract, provider, consuming hook, and public exports.
Link integration and package contract extensions/link/src/Link.tsx, extensions/link/README.md, extensions/link/package.json, .changeset/...	Link uses makeActivityUrl from context. Documentation shows provider usage. History-sync dependencies are removed, and the major-release changeset records the new requirement.
Generated workspace dependency metadata .pnp.cjs	Removes obsolete history-sync workspace references and refreshes affected virtual package metadata.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

• daangn/stackflow#705: Exposes history-sync URL resolution that this change consumes.
• daangn/stackflow#743: Adds the history-sync URL resolver used with the new provider.
• daangn/stackflow#750: Integrates the exposed history-sync resolver with the new provider API.

Suggested reviewers: tonyfromundefined

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/fep-2677-link-resolver

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	stackflow-docs	5b41f8b	Commit Preview URL	Aug 10 2026, 05:41 AM

[cloudflare-workers-and-pages]

Deploying stackflow-demo with    Cloudflare Pages

Latest commit:	c622af5
Status:	✅  Deploy successful!
Preview URL:	https://e384d496.stackflow-demo.pages.dev
Branch Preview URL:	https://feature-fep-2677-link-resolv.stackflow-demo.pages.dev

View logs

[pkg-pr-new]

• @stackflow/demo

  yarn add https://pkg.pr.new/@stackflow/link@751.tgz
  

commit: 5b41f8b