perf: lazy load Bluesky video player

[TheAlexLichter]

🔗 Linked issue

None (but perf is always good!)

📚 Description

This PR lazy-loads the Bluesky video player so non-video Bluesky embeds no longer pull in the full HLS player chunk if they dont need it.

Optionally, a media-hint="video" preload hint for known video posts can be set, which starts loading the video player earlier while still rendering only when post.embed?.playlist is present. This is optional but recommended when we know the content.

During tests, HLS split into its own (now optional) chunk at about 152.2 KB gzip, with the Bluesky embed chunk staying small at about 2.1 KB gzip.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
npmx.dev	Ready	Preview, Comment	Jun 24, 2026 9:35pm

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
docs.npmx.dev	Ignored		Jun 24, 2026 9:35pm
npmx-lunaria	Ignored		Jun 24, 2026 9:35pm

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 68231713-6a29-4989-8fd2-bcce76ef2190

📥 Commits

Reviewing files that changed from the base of the PR and between a93b547 and 736c5e1.

📒 Files selected for processing (2)

• app/components/global/BlueskyPostEmbed.client.vue
• app/pages/blog/release/crystal-chronicle.md

---

📝 Walkthrough

Summary by CodeRabbit

• New Features

  • Video embeds in Bluesky posts now load more smoothly, with playback resources fetched only when needed.
  • Affected blog post embeds now display video content more reliably in the relevant sections.

• Bug Fixes

  • Improved handling of embedded videos so they are less likely to stall or load unnecessarily when viewing posts.

Walkthrough

Bluesky post embeds now accept an optional media-hint="video" prop that lazy-loads the video player for matching embeds. Two release-note embeds were updated to pass that hint.

Changes

Bluesky video embed loading

Layer / File(s)	Summary
Embed video lazy-load app/components/global/BlueskyPostEmbed.client.vue	mediaHint is added to the embed props, VideoPlayer.vue is imported only for video hints, and the embedded video section renders LazyVideoPlayer.
Release note embed hints app/pages/blog/release/crystal-chronicle.md	Two BlueskyPostEmbed instances add media-hint="video" in the Timeline tab and Scatter with selectable axis sections.

Possibly related PRs

• npmx-dev/npmx.dev#2794: Also changes BlueskyPostEmbed.client.vue video handling and lazy-loading behaviour around VideoPlayer.

Suggested reviewers

• ghostdevv

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely describes the main change: lazy-loading the Bluesky video player.
Description check	✅ Passed	The description is directly related to the PR and accurately explains the lazy-loading and optional media hint changes.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch perf/lazy-bluesky-video-player

---

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.}

[TheAlexLichter]

didnt use preloadComponent because this only works with globally registered components.

[codecov]

Codecov Report

❌ Patch coverage is 50.00000% with 1 line in your changes missing coverage. Please review.
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
app/components/global/BlueskyPostEmbed.client.vue	50.00%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!

[alexdln]

Ah, looks great, thank you 🤍🚀