Skip to content

Improve Sätteri import comment - #3948

Merged
HiDeoo merged 3 commits into
withastro:mainfrom
HiDeoo:hd/satteri-import-comment
Jun 11, 2026
Merged

HiDeoo merged 3 commits into
withastro:mainfrom
HiDeoo:hd/satteri-import-comment

Conversation

@HiDeoo

@HiDeoo HiDeoo commented Jun 10, 2026

Copy link
Copy Markdown
Member

Description

Follow-up to #3923 (comment), this PR improves the comment describing how we import the Sätteri integration to workaround an Astro limitation.

The comment should be clear enough to explain the issue and the workaround. Regarding a potential fix in Astro for the underlying issue, I would definitelly need to think more about it. So far, the only idea I had is to have the Vite module runner used for loading the config to stay open instead of closing immediately, and return some kind of disposable. The disposable would be used to properly close it only when needed, e.g. after a build or when the dev server is closed, when the dev server is restarted, after a sync, etc. The getViteConfig() case would also need to be handled. On top of the extra cost of keeping the module runner open, it's also a lot of orchestration to pass around such disposable with the current architecture.

A workaround that I only briefly tested for fun is to by-pass Vite and rely on a native dynamic import to load @astrojs/markdown-satteri, e.g. using () => new Function('return import("@astrojs/markdown-satteri")') but that's definitely not something we want to do (even tho it seems to work) 😅

@github-actions github-actions Bot added the 🌟 core Changes to Starlight’s main package label Jun 10, 2026
@changeset-bot

changeset-bot Bot commented Jun 10, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: f859016

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

@netlify

netlify Bot commented Jun 10, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for astro-starlight ready!

Name Link
🔨 Latest commit 916efb7
🔍 Latest deploy log https://app.netlify.com/projects/astro-starlight/deploys/6a2ab28ff6ad640007a8617d
😎 Deploy Preview https://deploy-preview-3948--astro-starlight.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 99 (🔴 down 1 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
🤖 Make changes Run an agent on this branch

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

@delucis delucis left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Appreciate the investigation — would be nice to fix properly in Astro as I guess this could bite users and the error message is fairly cryptic. But more than happy that we understand this and document it properly — thank you!

@HiDeoo
HiDeoo merged commit 8deaf55 into withastro:main Jun 11, 2026
16 checks passed
HiDeoo added a commit to HiDeoo/starlight that referenced this pull request Jun 15, 2026
* main:
  Fix Markdown processing path matching (withastro#3953)
  Improve Sätteri import comment (withastro#3948)
  i18n(de): bring outdated pages up to date (withastro#3949)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🌟 core Changes to Starlight’s main package

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants