Fix reusable content cross-space page reference resolution

[emmerich]

Summary

• Fixed broken links to pages in the parent space of reusable content when used across different sites
• Added parentSpaceContext to GitBookSpaceContext type for tracking parent space information
• Enhanced resolveContentRef to check parent space when page resolution fails in current space
• Added comprehensive unit tests for the new functionality

Background

When reusable content contains links to pages in its parent space, these links were broken when the reusable content was used in a different space/site. This happened because the pages array was set to [] for cross-space reusable content to prevent unwanted cross-site linking.

Solution

The fix introduces a parentSpaceContext field in GitBookSpaceContext that preserves information about the parent space (where the reusable content originates). When page resolution fails in the current space, the system now checks the parent space and uses the existing resolveContentRefInSpace function to generate proper absolute URLs.

Changes

• GitBookSpaceContext type: Added optional parentSpaceContext field
• ReusableContent component: Now includes parent space context when rendering cross-space content
• resolveContentRef function: Added fallback logic to check parent space for page resolution
• Unit tests: Comprehensive test coverage for the new functionality

Test plan

• Unit tests pass for all new functionality
• Existing functionality remains intact (tests pass)
• Cross-space links resolve to absolute URLs for security
• Same-space reusable content behavior unchanged
• Manual testing with actual reusable content across different sites

🤖 Generated with Claude Code

[changeset-bot]

⚠️ No Changeset found

Latest commit: fac5fcf

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

[github-actions]

Summary of the deployments:

Version 1

Version	URL	Status
Latest commit	https://d3d2e923.gitbook-open.pages.dev	✅
PR	https://pr3321.gitbook-open.pages.dev	✅

Version 2

Version	URL	Status
Vercel	https://gitbook-v2-3m2qzjv73-gitbook.vercel.app	✅
Cloudflare	https://6a2b355f-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	v1	2v	2c
GitBook	https://d3d2e923.gitbook-open.pages.dev/gitbook.com/docs	https://gitbook-v2-3m2qzjv73-gitbook.vercel.app/url/gitbook.com/docs	https://6a2b355f-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://d3d2e923.gitbook-open.pages.dev/gitbook.gitbook.io/test-gitbook-open	https://gitbook-v2-3m2qzjv73-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://6a2b355f-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.gitbook.io/test-gitbook-open

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
customers-v1 (Inspect)	✅ No changes detected	-	Jun 14, 2025, 1:01 PM
customers-v2 (Inspect)	⚠️ Changes detected (Review)	77 changed	Jun 14, 2025, 1:03 PM
default (Inspect)	⚠️ Changes detected (Review)	5 changed	Jun 14, 2025, 1:03 PM
v2-cloudflare (Inspect)	✅ No changes detected	-	Jun 14, 2025, 1:05 PM
v2-vercel (Inspect)	✅ No changes detected	-	Jun 14, 2025, 1:05 PM