Repository navigation
Conversation
…dance Add `installationCommandParts` and `skillsCommandParts`, which `installationCommand` and `skillsCommand` now join, so an interface can present each option on its own while the printed commands stay the same. Preset guidance names the sources each live preset plays, and media guidance keeps platform media on the platform's own adapter. Extension guidance names the media Google Cast can send, from the newly exported `GOOGLE_CAST_RENDERERS`.
Move the code frame's overflow measurement, expanded state, scroll restoration, and Show more or Show less control into `useOverflowCollapse` and `OverflowToggle`, so other tall content can collapse the same way. Code frames keep their height, slack, and look.
…ilding Replace the per-flag prompt builder with an intent-first form. Readers answer one optional question, what they are building, with suggestions that set up the player they describe; the goal, features, media, look, and agent wait under More options with a summary of their values. The prompt below is read-only Markdown in two numbered steps: install the Video.js skill, then run `agents init` stating only the look, media, and choices that differ from the defaults, and leave detection and guidance to the CLI. Feature requests become a list pointing at each installed guide. A tall prompt collapses like a code frame, Undo reverts a suggestion until the reader edits what it set, and Reset returns only the player picks the prompt shares with the guide. The copy menu can start Claude Code, Codex, or Cursor with the prompt, or open it in Cursor, Claude, or ChatGPT; the page's Copy page menu gains Open in Cursor.
The site type check only accepts a string or number for `toHaveTextContent`.
Refine the AI Quickstart suggestions to 15, common products first. Drop the DASH audio-language promise, keep thumbnail previews for Mux media, which provides storyboards, and keep a pasted URL when a suggestion names the same media. The setup line names the extensions installed. Add one Mux line under the request when Mux would help: a live preset needs an ingest point, a quality menu needs an adaptive stream, thumbnail previews need a storyboard, or the demo could be the reader's own upload. Upload links open the media dialog. HLS and DASH suggestions offer Host on Mux instead, Mux media offers Viewer analytics (Mux Data), and the prompt points the agent at the Mux MCP server. The upload success state says what Mux provides. Installation guides choose the media before the skin, and they and Build with AI describe Mux the same way.
The Media field is a menu of the preset's sources, grouped as the guide's picker groups them and marked with their logos, with Paste a media URL and Upload to Mux opening the media dialog. Switching to another kind of media goes back to its demo, since the new player can't play the reader's URL. Drop the Mux line about demo media and the suggestion's Undo, which Reset covers, and give More options a little more room.
The AI Quickstart form, its summary, and the setup line said Look where the rest of the docs say skin.
AI Quickstart read as the first of the installation steps. Put the steps from choosing a framework to running the app under a Manual installation heading, one level down, so the page and its table of contents show two ways to install, with Own the UI and what to do next after both. The headings the skin picker and media install components render move down with them.
…nts init Add --features, a comma-separated list of player features checked against the preset, and --from, the player an existing project migrates from. The plan points at each feature's guide in the installed package, opens a migration with its guide and the checks to make before changing code, and ends it with removing the old player. With Mux media, a local file passed as --source-url adds a first step that uploads it with the Mux CLI, and a live preset without a URL adds one that creates a Mux live stream. Demo Mux media gets an optional upload step. Each step asks the user to sign in and keeps credentials and stream keys out of the code.
…flags The AI Quickstart prompt passes --features and --from to agents init instead of listing feature guides itself, so the command's version-matched output carries them. A migration leaves the skin, media, and extensions to the existing player, and Vidstack joins the goals. Migration guides use the prompt builder with their migration selected, in place of the static prompt.
The builder replaces the static prompt, so it sends the same events: a copied prompt counts as copied code and an agent handoff, and copying a terminal command or opening another app counts as a handoff too. Opening the copy page in Cursor gets its own handoff method.
Explain what hosting gives the player: adaptive streams for a quality menu, storyboards for thumbnail previews, ingest for live streams, and analytics. Recommend Mux, with Cloudflare Stream, platform embeds, and your own files as alternatives, and link it from the pages that mention Mux hosting.
The hint for a quality menu, thumbnail previews, or a live stream that needs more than a file now links to choosing video hosting rather than to a Mux upload or Mux's docs. Mux links the prompt renders carry its attribution.
The skin guidance asks whether the project applies its brand to our design, which uses neutral, or builds its own, which uses none, and keeps default when either works. Once the skins include compat, it uses compat for a player that must work in older browsers.
Replace the Skin field with Design: apply my brand to yours for Neutral, build my own design for no skin, or either works for Default, with the skin previews a click away. A Browsers question for older browsers picks Compat once the installation package offers it.
With compat released, the Browsers question appears, and the skin icon and label include it.
The skin control labels each skin flag, and main added scaffold after the prompt builder was written. Name it Scaffold, beside its dashed-square glyph.
…jects Video-React is a React library, and its migration guide exists only for React. `agents init` rejects `--from video-react` for another framework, and the prompt's Goal select offers the migration only on React pages, where a goal picked under another framework gives way to the page's.
@videojs/cdn
@videojs/cli
@videojs/core
@videojs/element
@videojs/html
@videojs/media
@videojs/react
@videojs/spf
@videojs/store
@videojs/utils
@videojs/cloudflare-video
@videojs/dash-video
@videojs/hlsjs-video
@videojs/mux-audio
@videojs/mux-video
@videojs/native-hls-video
@videojs/playerjs-video
@videojs/shaka-video
@videojs/spotify-audio
@videojs/tiktok-video
@videojs/twitch-video
@videojs/vimeo-video
@videojs/wistia-video
@videojs/youtube-video
@videojs/google-cast
@videojs/mux-data
commit: |
Contributor
📦 Bundle Size Report🎨 @videojs/html — no changesPresets (7)
Media (19)
Players (5)
Skins (53)
UI Components (62)
⚛️ @videojs/react — no changesPresets (7)
Media (23)
Extensions (2)
Players (5)
Skins (34)
UI Components (39)
🧩 @videojs/core — no changesEntries (76)
🏷️ @videojs/element — no changesEntries (2)
📦 @videojs/store — no changesEntries (3)
🔧 @videojs/utils — no changesEntries (13)
📦 @videojs/cdn — no changes📦 @videojs/cloudflare-video — no changes📦 @videojs/dash-video — no changes📦 @videojs/google-cast — no changes📦 @videojs/hlsjs-video — no changes📦 @videojs/media — no changesEntries (3)
📦 @videojs/mux — no changes📦 @videojs/mux-audio — no changesEntries (2)
📦 @videojs/mux-data — no changes📦 @videojs/mux-video — no changesEntries (2)
📦 @videojs/native-hls-video — no changes📦 @videojs/playerjs-video — no changes📦 @videojs/shaka-video — no changes📦 @videojs/spf — no changesEntries (7)
📦 @videojs/spotify-audio — no changes📦 @videojs/tiktok-video — no changes📦 @videojs/twitch-video — no changes📦 @videojs/other — no changesEntries (3)
📦 @videojs/vimeo-video — no changes📦 @videojs/wistia-video — no changesEntries (2)
📦 @videojs/youtube-video — no changesℹ️ How to interpretEach entry is independently bundled, minified, and brotli-compressed. Initial size includes its static import graph; lazy dynamic chunks are reported separately. Entries are not additive because their dependency graphs overlap. Preset rows represent realistic combined bundles. Changes of 300 B or less across initial, lazy, and total size are collapsed, not discarded. Run |
✅ Deploy Preview for vjs10-site ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview for vjs-registry ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Moved from videojs/v10#3023.
Summary
The AI Quickstart prompt on the installation guides, Build with AI, and the migration guides asked readers to set every CLI flag themselves, which felt like a questionnaire. It now asks one optional question, what you're building, and the prompt works as is.
agents initdetects and guides the rest, and now plans features, migrations, and Mux uploads itself.Changes
agents initstating only the skin, the media URL (ordemo), the features, the migration, and choices that differ from the defaults. The prompt tells the agent what the command detects and what it explains, rather than asking the agent to decide. Copied, it's Markdown, and the page's text content equals the copied text, so selecting and copying by hand matches the Copy button.agents init's skin guidance asks the same question: neutral when the project applies its brand or wants a subtler look, none when it builds its own design, default when either works, and compat when the player must work in older browsers.agents initgains--features, checked against the preset, and--from, the player an existing project migrates from. The plan points at each feature's guide in the installed package, opens a migration with its guide and the checks to make before changing code, and ends by removing the old player. The prompt passes both flags instead of listing guides itself, and migration guides use the prompt builder with their migration selected in place of the static prompt.--source-urladds a first step that uploads it with the Mux CLI, and a live preset without a URL adds one that creates a Mux live stream. Demo Mux media gets an optional upload step. Each step asks the user to sign in and keeps credentials and stream keys out of the code.guides/video-hosting), explains what hosting gives the player: adaptive streams for a quality menu, storyboards for thumbnail previews, ingest for live streams, and analytics. It recommends Mux and covers Cloudflare Stream, platform embeds, and your own files. When a quality menu, thumbnail previews, or a live stream needs more than a file, the prompt's hosting hint links to that guide, as do the installation guides and Build with AI. HLS and DASH suggestions offer Host on Mux instead, Mux media offers Viewer analytics (Mux Data), and the prompt points the agent at the Mux MCP server.useOverflowCollapse,OverflowToggle).code_copiedand anagent_handoff(copy-agent-prompt). Copying a terminal command (copy-agent-command) and each Open in link, including the newopen-in-cursoron both the prompt and the Copy page menu, send anagent_handoff. Links in the prompt carry adestinationtag, and Mux links carry the prompt's attribution.@videojs/installation. AddsinstallationCommandPartsandskillsCommandParts; the printed commands are unchanged. Guidance names the sources each live preset plays and the media Google Cast can send.--fromand the Goal select. Its guide exists only for React, soagents initrejects--from video-reactfor another framework, and the Goal select offers it only on React pages. The Scaffold skin (feat(skin): add scaffold skin #9251) gets a label and a dashed-square icon in the skin control. The Design question has no answer that picks Scaffold yet, so a Scaffold pick from the skin previews reads as "Either works".Implementation details
agentPromptViewbuilds one structure for the prompt: steps, command options, and closing paragraph. The component renders it andagentPromptMarkdownserializes it, so the page and the copied text cannot drift apart. Hidden spans carry the separators and backticks the page draws with layout instead.AgentPromptPlayerPicks: preset, skin, media, extensions, and media URL.localStorage; everything else resets per visit. A goal picked under another framework, such as the React-only Video-React migration, gives way to the page's.Visual Evidence
Use this PR's deploy preview. Open an installation guide, such as
/docs/guides/installation/react, and go to AI Quickstart. Try a suggestion (for example Course lessons), open More options, change Media, Design, and Browsers, and use Show more and Reset. Also check a migration guide's AI Quickstart, such as/docs/framework/react/guides/migrate-from-video-react. Check at desktop width and at about 390px.Testing
pnpm -F @videojs/installation test: 316 passed.pnpm -F site test: 1166 passed in 103 files.pnpm -F site astro check: 0 errors, 0 warnings.pnpm typecheck: passed.pnpm build:site, thenpnpm -F site check:link-analytics: every off-site link carries its analytics tags.🤖 Generated with Claude Code