Pagefind CLI → Pagefind API

[HiDeoo]

Description

• Closes Pagefind forces the use of npx to run which may not be available #3503

This PR refactors how Pagefind is run after the build process. Instead of using the CLI via npx, it now uses the Pagefind API directly.

Feature-wise, there should be no changes but one aspect which will differ is logging.

Before	After

We are now directly using a fork of the Starlight ingration logger. I didn't spend too much time on tweaking the logging output so far, but one huge difference is that we don't have access to the same informations when using the API vs CLI which access them using some internal Rust code and that data is not exposed via the API.

Personally, I never found the logging output of the CLI very useful, so I think this is an overall improvement but definitely something worth mentioning and discussing if needed.

Todo

• Add a changeset. (Chris added a temporary one to test preview releases, but we may want to revisit the wording.)

[changeset-bot]

🦋 Changeset detected

Latest commit: 2b95224

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

This PR includes changesets to release 1 package

Name	Type
@astrojs/starlight	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

[netlify]

✅ Deploy Preview for astro-starlight ready!

Name	Link
🔨 Latest commit	2b95224
🔍 Latest deploy log	https://app.netlify.com/projects/astro-starlight/deploys/69692b5508cdce000817529a
😎 Deploy Preview	https://deploy-preview-3534--astro-starlight.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	1 paths audited Performance: 100 (no change from production) Accessibility: 100 (no change from production) Best Practices: 100 (no change from production) SEO: 100 (no change from production) PWA: - View the detailed breakdown and full score reports

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[pkg-pr-new]

pnpm add https://pkg.pr.new/@astrojs/starlight@3534

commit: 7b632ba

[Mikescops]

Hello, thanks a lot for the PR, is there a chance this goes into the next version? 😄

[delucis]

is there a chance this goes into the next version?

Yes, planned for v0.38!

[Mikescops]

Nice, thanks a lot!

[delucis]

Thanks @HiDeoo! Left a few small comments, but this looks great!

[delucis]

Ah, and I missed the failing coverage check. Looks like we should add some testing maybe? The new integrations/pagefind.ts file is showing many lines uncovered in tests.