Skip to content
This repository was archived by the owner on Oct 21, 2026. It is now read-only.

docs(site): add reference pages for presets, useMedia, UIElement, and icons - #3067

Merged
decepulis merged 36 commits into
claude/keen-mccarthy-7ams8m-docsfrom
claude/keen-mccarthy-7ams8m-pages
Oct 1, 2026
Merged

decepulis merged 36 commits into
claude/keen-mccarthy-7ams8m-docsfrom
claude/keen-mccarthy-7ams8m-pages

Conversation

@decepulis

@decepulis decepulis commented Sep 29, 2026 •

Copy link
Copy Markdown
Collaborator

Part 4 of the API stability stack: #3073 → #3063 → #3066 → this PR → #3082 → #3068 → #3083.

Summary

With the checker's rule, an export is stable only if a reference page documents it. This PR adds pages for the public APIs the docs already rely on, and makes existing pages document the APIs they only implied.

New pages

  • Presets tab (new top-level sidebar section): Video, Audio, Live video, Live audio, and Background. Each page covers the preset's player and props, its HTML element, its feature bundle and bundle type, and its skins, media, and exports.
    • A new PresetFeatures component builds each feature table from the generated preset reference, so the list can't drift from the code.
  • useMedia (React): the standalone and createPlayer forms, and what Media is. It reuses the existing use-media demo, which now re-renders once the media can play.
  • Media capability guards: the 15 isMedia*Capable and hasMetadata guards that @videojs/react and @videojs/html re-export. For each guard, the page shows what it checks, what it narrows to, and a React and HTML example.
  • UIElement (HTML): the base class that every custom-element example extends, with a demo.
    • player-controller now explains the shared playerContext.
  • Icons (new Components group): all three icon sets (default, neutral, and the compat set from main's feat(skin): add compat skin #3026), in both frameworks, with an IconTable generated from the public icon exports.

Existing pages. Where the prose only implied an API, a sentence was added to document it: the i18n types, the option item types of the use-*-options hooks, HotkeyShortcutDetails, the time slider's chapter state, renderElement's types, and the Google Cast and Mux Data element classes. register-i18n gains a "Built-in locale packs" section.

What the check reads. The check in #3063 reads each guard's code heading and each preset's Exports table, and a documented export's types make the types it names stable. So apis frontmatter is left only where nothing else names an export:

  • I18nContext, i18nContext, playerContext, shallowEqual
  • the locale-pack default exports
  • the Google Cast and Mux Data extension classes
  • the six icon entry points

Preview pages

New pages (please read these in both frameworks):

Changed pages:

  • Presets guide (links to the new pages): React · HTML
  • PlayerController (playerContext): HTML
  • registerI18n (built-in locale packs): React · HTML
  • Pages with a sentence or two added:

Reviewer notes

  • Please render and read these pages in both frameworks. Sub-agents drafted them; I checked every page renders (HTTP 200) and screenshotted the Presets section.
  • New visual components: PresetFeatures and IconTable use the shared Table at the reading column's width, like Markdown tables. IconTable now has a Compat preview column. The UIElement demo has its own scoped CSS.
  • Presets are a top-level tab, not a Components group. Putting reference/presets/* under Components changed the directory that tab's llms files share, from reference/components to reference. llms-markdown.test.ts caught this.
  • Matching is by name, not by package. Covering I18nContextValue for HTML also covers React's version, which has more fields. Covering I18nContext for React also covers the HTML type.
  • HTML path to the media. The capability-guard page uses document.querySelector('video-player')?.store.target?.media, the only public path I found. Its examples also need an import from @videojs/html/video for video-player's element typing, because @videojs/html/video/player's .d.ts is export {}. That's a typing gap in the package.
  • Package bug found along the way. Passing a selector to PlayerController from @videojs/html/video fails type-checking, because presets/video/player.d.ts references a VideoPlayerStore that the bundled namespace doesn't contain. This is not fixed here.
  • Hand-written tables. The preset pages' player props and attributes tables are written by hand, so they'll need updating if a feature adds player inputs.

Testing

  • pnpm -F site astro check: 0 errors, 0 warnings.
  • pnpm -F site test: all pass except markdown-negotiation, which needs URLPattern. That's available from Node 24, which the repo pins in .nvmrc; the sandbox runs Node 22, and nothing in this stack touches that test.
  • pnpm -F site check:api-stability on chore(store): check and tag store's public exports #3083's branch, which contains this one: all 1,966 checked exports are documented, referenced or tagged.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH

useMedia had a demo but no page, and the capability guards are the only
type-safe way to use what it returns. The useMedia demo now re-renders
once media can play, so it shows the loaded source and dimensions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH
Adds `apis` frontmatter, plus a sentence where a page only implied it,
for the i18n types (Translations, Translator, Locale, I18nContext,
i18nContext, I18nContextValue), locale pack default exports,
UnknownStore, the option item types of the use-*-options hooks,
HotkeyShortcutDetails, and the Google Cast and Mux Data element classes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH
A new Presets sidebar group documents the video, audio, live video, live
audio, and background presets: each preset's player, feature bundle and
its type, skins, media, and exports. PresetFeatures renders one preset's
features from the generated preset reference so the list can't drift.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH
UIElement is the base class every custom-element example extends, and
the icon sets are public for building your own controls (and for the
shadcn registry). The PlayerController page now explains the shared
playerContext it takes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH
Under the Components tab, the preset pages moved the directory that tab's
llms files share from reference/components to reference. A Presets tab
keeps each tab's pages in one directory.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH
@vercel

vercel Bot commented Sep 29, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
v10-sandbox Ready Ready Preview Oct 1, 2026 9:16pm UTC

Request Review

The page documents it as useSelector's default comparator and passes it
in its example.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH
@pkg-pr-new

pkg-pr-new Bot commented Sep 29, 2026 •

Copy link
Copy Markdown
@videojs/cdn

pnpm add https://pkg.pr.new/@videojs/cdn@3067

@videojs/cli

pnpm add https://pkg.pr.new/@videojs/cli@3067

@videojs/core

pnpm add https://pkg.pr.new/@videojs/core@3067

@videojs/element

pnpm add https://pkg.pr.new/@videojs/element@3067

@videojs/html

pnpm add https://pkg.pr.new/@videojs/html@3067

@videojs/media

pnpm add https://pkg.pr.new/@videojs/media@3067

@videojs/react

pnpm add https://pkg.pr.new/@videojs/react@3067

@videojs/spf

pnpm add https://pkg.pr.new/@videojs/spf@3067

@videojs/store

pnpm add https://pkg.pr.new/@videojs/store@3067

@videojs/utils

pnpm add https://pkg.pr.new/@videojs/utils@3067

@videojs/cloudflare-video

pnpm add https://pkg.pr.new/@videojs/cloudflare-video@3067

@videojs/dash-video

pnpm add https://pkg.pr.new/@videojs/dash-video@3067

@videojs/hlsjs-video

pnpm add https://pkg.pr.new/@videojs/hlsjs-video@3067

@videojs/mux-audio

pnpm add https://pkg.pr.new/@videojs/mux-audio@3067

@videojs/mux-video

pnpm add https://pkg.pr.new/@videojs/mux-video@3067

@videojs/native-hls-video

pnpm add https://pkg.pr.new/@videojs/native-hls-video@3067

@videojs/shaka-video

pnpm add https://pkg.pr.new/@videojs/shaka-video@3067

@videojs/spotify-audio

pnpm add https://pkg.pr.new/@videojs/spotify-audio@3067

@videojs/tiktok-video

pnpm add https://pkg.pr.new/@videojs/tiktok-video@3067

@videojs/twitch-video

pnpm add https://pkg.pr.new/@videojs/twitch-video@3067

@videojs/vimeo-video

pnpm add https://pkg.pr.new/@videojs/vimeo-video@3067

@videojs/wistia-video

pnpm add https://pkg.pr.new/@videojs/wistia-video@3067

@videojs/youtube-video

pnpm add https://pkg.pr.new/@videojs/youtube-video@3067

@videojs/google-cast

pnpm add https://pkg.pr.new/@videojs/google-cast@3067

@videojs/mux-data

pnpm add https://pkg.pr.new/@videojs/mux-data@3067

commit: 1365f65

@github-actions

github-actions Bot commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

📦 Bundle Size Report

🎨 @videojs/html — no changes
Presets (7)
Entry Initial Lazy
/video (default) 65.26 kB 56.03 kB
/video (default + hls) 67.12 kB 56.03 kB
/video (neutral) 65.75 kB 56.03 kB
/video (neutral + hls) 67.52 kB 56.03 kB
/audio (default) 49.09 kB 56.03 kB
/audio (neutral) 49.45 kB 56.03 kB
/background 12.76 kB 56.03 kB
Media (18)
Entry Initial
/media/mux-video 3.03 kB
/media/mux-audio 2.71 kB
/media/background-video 1.17 kB
/media/cloudflare-video 2.91 kB
/media/dash-video 2.63 kB
/media/hls-audio 23.54 kB
/media/hls-background-video 17.56 kB
/media/hls-video 33.95 kB
/media/hlsjs-video 2.64 kB
/media/mux-background-video 17.58 kB
/media/native-hls-video 7.54 kB
/media/shaka-video 2.64 kB
/media/spotify-audio 3.03 kB
/media/tiktok-video 3.14 kB
/media/twitch-video 2.94 kB
/media/vimeo-video 2.92 kB
/media/wistia-video 615 B
/media/youtube-video 2.91 kB
Players (5)
Entry Initial Lazy
/video/player 10.85 kB 56.03 kB
/audio/player 7.05 kB 56.03 kB
/background/player 5.34 kB 56.03 kB
/live-video/player 10.23 kB 56.03 kB
/live-audio/player 7.06 kB 56.03 kB
Skins (41)
Entry Type Initial Lazy
/video/compat-skin.css css 7.48 kB —
/video/neutral-skin.css css 8.33 kB —
/video/skin.css css 8.05 kB —
/video/compat-skin js 62.40 kB 56.03 kB
/video/compat-skin2 js 7.45 kB —
/video/neutral-skin js 63.28 kB 56.03 kB
/video/neutral-skin2 js 8.32 kB —
/video/skin js 62.92 kB 56.03 kB
/video/skin2 js 8.02 kB —
/audio/compat-skin.css css 6.13 kB —
/audio/neutral-skin.css css 6.07 kB —
/audio/skin.css css 5.80 kB —
/audio/compat-skin js 53.92 kB 56.03 kB
/audio/compat-skin2 js 6.13 kB —
/audio/neutral-skin js 47.06 kB 56.03 kB
/audio/neutral-skin2 js 6.05 kB —
/audio/skin js 46.78 kB 56.03 kB
/audio/skin2 js 5.78 kB —
/background/skin.css css 141 B —
/background/skin js 10.18 kB 56.03 kB
/background/skin2 js 159 B —
/live-video/compat-skin.css css 6.92 kB —
/live-video/neutral-skin.css css 6.82 kB —
/live-video/skin.css css 6.72 kB —
/live-video/compat-skin js 53.70 kB 56.03 kB
/live-video/compat-skin2 js 6.91 kB —
/live-video/neutral-skin js 50.90 kB 56.03 kB
/live-video/neutral-skin2 js 6.82 kB —
/live-video/skin js 50.90 kB 56.03 kB
/live-video/skin2 js 6.72 kB —
/live-audio/compat-skin.css css 5.63 kB —
/live-audio/neutral-skin.css css 4.77 kB —
/live-audio/skin.css css 4.67 kB —
/live-audio/compat-skin js 40.87 kB 56.03 kB
/live-audio/compat-skin2 js 5.64 kB —
/live-audio/neutral-skin js 36.28 kB 56.03 kB
/live-audio/neutral-skin2 js 4.77 kB —
/live-audio/skin js 36.21 kB 56.03 kB
/live-audio/skin2 js 4.66 kB —
/global.css css 239 B —
/shadow.css css 78 B —
UI Components (62)
Entry Initial Lazy
/ui/airplay-button 11.57 kB 56.03 kB
/ui/alert-dialog 8.99 kB 56.03 kB
/ui/audio-track-radio-group 11.68 kB 56.03 kB
/ui/buffering-indicator 8.91 kB 56.03 kB
/ui/captions-button 11.83 kB 56.03 kB
/ui/captions-radio-group 11.73 kB 56.03 kB
/ui/cast-button 11.56 kB 56.03 kB
/ui/container 9.79 kB 56.03 kB
/ui/controls 9.10 kB 56.03 kB
/ui/controls-backdrop 1.69 kB 56.03 kB
/ui/controls-content 1.67 kB 56.03 kB
/ui/dialog 8.92 kB 56.03 kB
/ui/dialog-backdrop 1.70 kB 56.03 kB
/ui/dialog-close 2.06 kB 56.03 kB
/ui/dialog-description 1.69 kB 56.03 kB
/ui/dialog-popup 1.90 kB 56.03 kB
/ui/dialog-title 1.69 kB 56.03 kB
/ui/error-dialog 12.69 kB 56.03 kB
/ui/fullscreen-button 11.57 kB 56.03 kB
/ui/gesture 10.01 kB 56.03 kB
/ui/hotkey 10.40 kB 56.03 kB
/ui/live-button 10.09 kB 56.03 kB
/ui/menu 19.25 kB 56.03 kB
/ui/menu-checkbox-item 1.97 kB 56.03 kB
/ui/menu-content 7.65 kB 56.03 kB
/ui/menu-group 2.09 kB 56.03 kB
/ui/menu-group-label 1.64 kB —
/ui/menu-item 2.29 kB 56.03 kB
/ui/menu-item-indicator 1.38 kB 56.03 kB
/ui/menu-radio-group 3.03 kB 56.03 kB
/ui/menu-radio-item 2.14 kB 56.03 kB
/ui/menu-separator 1.30 kB 56.03 kB
/ui/mute-button 11.59 kB 56.03 kB
/ui/pip-button 11.54 kB 56.03 kB
/ui/play-button 11.53 kB 56.03 kB
/ui/playback-rate-button 11.63 kB 56.03 kB
/ui/playback-rate-radio-group 11.69 kB 56.03 kB
/ui/popover 8.77 kB 56.03 kB
/ui/poster 9.21 kB 56.03 kB
/ui/quality-radio-group 12.18 kB 56.03 kB
/ui/seek-button 11.58 kB 56.03 kB
/ui/seek-indicator 13.39 kB 56.03 kB
/ui/seek-indicator-value 1.10 kB —
/ui/slider 11.94 kB 56.03 kB
/ui/slider-preview 2.01 kB 56.03 kB
/ui/status-announcer 10.94 kB 56.03 kB
/ui/status-indicator 13.34 kB 56.03 kB
/ui/status-indicator-value 1.10 kB —
/ui/thumbnail 10.64 kB 56.03 kB
/ui/time 11.36 kB 56.03 kB
/ui/time-slider 13.44 kB 56.03 kB
/ui/time-slider-chapter-title 9.10 kB 56.03 kB
/ui/time-slider-chapters 9.92 kB 56.03 kB
/ui/title 8.48 kB 56.03 kB
/ui/tooltip 10.15 kB 56.03 kB
/ui/tooltip-label 1.21 kB —
/ui/tooltip-shortcut 1.18 kB —
/ui/volume-indicator 13.31 kB 56.03 kB
/ui/volume-indicator-fill 1.11 kB —
/ui/volume-indicator-value 1.10 kB —
/ui/volume-popover 15.21 kB 56.03 kB
/ui/volume-slider 12.65 kB 56.03 kB
⚛️ @videojs/react — no changes
Presets (7)
Entry Initial Lazy
/video (default) 58.75 kB 56.03 kB
/video (default + hls) 59.36 kB 56.03 kB
/video (neutral) 58.80 kB 56.03 kB
/video (neutral + hls) 59.38 kB 56.03 kB
/audio (default) 45.78 kB 56.03 kB
/audio (neutral) 45.67 kB 56.03 kB
/background 921 B 56.03 kB
Media (22)
Entry Initial
/media/mux-video/hls-js 1.47 kB
/media/mux-video/spf 1.47 kB
/media/mux-audio/hls-js 1.15 kB
/media/mux-audio/spf 1.14 kB
/media/background-video 532 B
/media/cloudflare-video 1.88 kB
/media/dash-video 1.13 kB
/media/hls-audio 22.20 kB
/media/hls-background-video 17.60 kB
/media/hls-video 32.64 kB
/media/hlsjs-video 1.13 kB
/media/mux-audio 1.13 kB
/media/mux-background-video 17.63 kB
/media/mux-video 1.46 kB
/media/native-hls-video 6.19 kB
/media/shaka-video 1.13 kB
/media/spotify-audio 1.94 kB
/media/tiktok-video 1.88 kB
/media/twitch-video 1.89 kB
/media/vimeo-video 1.85 kB
/media/wistia-video 1.42 kB
/media/youtube-video 1.86 kB
Extensions (2)
Entry Initial
/extensions/google-cast 613 B
/extensions/mux-data 665 B
Players (5)
Entry Initial Lazy
/video/player 8.68 kB 56.03 kB
/audio/player 4.90 kB 56.03 kB
/background/player 3.16 kB 56.03 kB
/live-video/player 8.07 kB 56.03 kB
/live-audio/player 4.91 kB 56.03 kB
Skins (26)
Entry Type Initial Lazy
/video/compat-skin.css css 7.35 kB —
/video/neutral-skin.css css 8.16 kB —
/video/skin.css css 7.86 kB —
/video/compat-skin js 59.66 kB 56.03 kB
/video/neutral-skin js 58.66 kB 56.03 kB
/video/skin js 58.72 kB 56.03 kB
/audio/compat-skin.css css 5.97 kB —
/audio/neutral-skin.css css 5.89 kB —
/audio/skin.css css 5.60 kB —
/audio/compat-skin js 50.66 kB 56.03 kB
/audio/neutral-skin js 45.57 kB 56.03 kB
/audio/skin js 45.58 kB 56.03 kB
/background/skin.css css 97 B —
/background/skin js 516 B —
/live-video/compat-skin.css css 6.81 kB —
/live-video/neutral-skin.css css 6.65 kB —
/live-video/skin.css css 6.55 kB —
/live-video/compat-skin js 55.54 kB 56.03 kB
/live-video/neutral-skin js 48.55 kB 56.03 kB
/live-video/skin js 48.59 kB 56.03 kB
/live-audio/compat-skin.css css 5.48 kB —
/live-audio/neutral-skin.css css 4.58 kB —
/live-audio/skin.css css 4.47 kB —
/live-audio/compat-skin js 41.85 kB 56.03 kB
/live-audio/neutral-skin js 33.86 kB 56.03 kB
/live-audio/skin js 33.86 kB 56.03 kB
UI Components (39)
Entry Initial Lazy
/ui/airplay-button 11.28 kB 56.03 kB
/ui/alert-dialog 5.21 kB 56.03 kB
/ui/audio-track 8.40 kB 56.03 kB
/ui/audio-track-radio-group 10.74 kB 56.03 kB
/ui/buffering-indicator 8.45 kB 56.03 kB
/ui/captions-button 11.26 kB 56.03 kB
/ui/captions-radio-group 10.81 kB 56.03 kB
/ui/cast-button 11.27 kB 56.03 kB
/ui/controls 8.34 kB 56.03 kB
/ui/dialog 5.20 kB 56.03 kB
/ui/error-dialog 12.66 kB 56.03 kB
/ui/fullscreen-button 11.24 kB 56.03 kB
/ui/gesture 8.61 kB 56.03 kB
/ui/hotkey 9.03 kB 56.03 kB
/ui/live-button 9.58 kB 56.03 kB
/ui/menu 22.05 kB 56.03 kB
/ui/mute-button 11.28 kB 56.03 kB
/ui/pip-button 11.24 kB 56.03 kB
/ui/play-button 11.20 kB 56.03 kB
/ui/playback-rate 8.45 kB 56.03 kB
/ui/playback-rate-button 11.20 kB 56.03 kB
/ui/playback-rate-radio-group 10.81 kB 56.03 kB
/ui/popover 9.12 kB 56.03 kB
/ui/poster 8.65 kB 56.03 kB
/ui/quality 8.82 kB 56.03 kB
/ui/quality-radio-group 11.15 kB 56.03 kB
/ui/seek-button 11.24 kB 56.03 kB
/ui/seek-indicator 13.12 kB 56.03 kB
/ui/slider 14.43 kB 56.03 kB
/ui/status-announcer 10.86 kB 56.03 kB
/ui/status-indicator 13.40 kB 56.03 kB
/ui/thumbnail 9.82 kB 56.03 kB
/ui/time 10.66 kB 56.03 kB
/ui/time-slider 16.18 kB 56.03 kB
/ui/title 7.93 kB 56.03 kB
/ui/tooltip 9.98 kB 56.03 kB
/ui/volume-indicator 13.43 kB 56.03 kB
/ui/volume-popover 15.58 kB 56.03 kB
/ui/volume-slider 13.02 kB 56.03 kB
🧩 @videojs/core — no changes
Entries (76)
Entry Initial Lazy
. 13.48 kB —
/dom 23.92 kB 56.03 kB
/vjsc 1.90 kB —
/i18n 3.21 kB 56.03 kB
/i18n/locales/all 33.91 kB —
/i18n/locales/ar 1.16 kB —
/i18n/locales/az 1.08 kB —
/i18n/locales/bg 1.29 kB —
/i18n/locales/bn 1.25 kB —
/i18n/locales/bs 1.02 kB —
/i18n/locales/ca 1.04 kB —
/i18n/locales/cs 1.10 kB —
/i18n/locales/cy 1.02 kB —
/i18n/locales/da 984 B —
/i18n/locales/de 1.06 kB —
/i18n/locales/el 1.42 kB —
/i18n/locales/en 801 B —
/i18n/locales/es 999 B —
/i18n/locales/et 1.02 kB —
/i18n/locales/eu 1.04 kB —
/i18n/locales/fa 1.21 kB —
/i18n/locales/fi 1.05 kB —
/i18n/locales/fr 1.01 kB —
/i18n/locales/gd 1.09 kB —
/i18n/locales/gl 1017 B —
/i18n/locales/he 1.10 kB —
/i18n/locales/hi 1.25 kB —
/i18n/locales/hr 1.05 kB —
/i18n/locales/hu 1.10 kB —
/i18n/locales/id 953 B —
/i18n/locales/it 1.01 kB —
/i18n/locales/ja 1.16 kB —
/i18n/locales/ko 1.08 kB —
/i18n/locales/lt 1.04 kB —
/i18n/locales/lv 1.09 kB —
/i18n/locales/mr 1.23 kB —
/i18n/locales/nb 990 B —
/i18n/locales/ne 1.23 kB —
/i18n/locales/nl 1.01 kB —
/i18n/locales/nn 983 B —
/i18n/locales/oc 1.05 kB —
/i18n/locales/pl 1.11 kB —
/i18n/locales/pt 1.02 kB —
/i18n/locales/pt-BR 1.02 kB —
/i18n/locales/pt-PT 1.02 kB —
/i18n/locales/ro 1.04 kB —
/i18n/locales/ru 1.36 kB —
/i18n/locales/sk 1.10 kB —
/i18n/locales/sl 1.04 kB —
/i18n/locales/sr 1.05 kB —
/i18n/locales/sv 1.01 kB —
/i18n/locales/te 1.29 kB —
/i18n/locales/th 1.20 kB —
/i18n/locales/tr 1.00 kB —
/i18n/locales/uk 1.37 kB —
/i18n/locales/vi 1.10 kB —
/i18n/locales/zh 1.01 kB —
/i18n/locales/zh-CN 1.01 kB —
/i18n/locales/zh-TW 1.02 kB —
/i18n/text/airplay 101 B —
/i18n/text/buttons 137 B —
/i18n/text/captions 93 B —
/i18n/text/cast 114 B —
/i18n/text/common 90 B —
/i18n/text/container 75 B —
/i18n/text/errors 285 B —
/i18n/text/fullscreen 98 B —
/i18n/text/live 126 B —
/i18n/text/menu 249 B —
/i18n/text/pip 101 B —
/i18n/text/playback 80 B —
/i18n/text/seek 105 B —
/i18n/text/slider 65 B —
/i18n/text/status 222 B —
/i18n/text/time 322 B —
/i18n/text/volume 133 B —
🏷️ @videojs/element — no changes
Entries (2)
Entry Initial
. 1.05 kB
/context 1.15 kB
📦 @videojs/store — no changes
Entries (3)
Entry Initial
. 1.85 kB
/html 703 B
/react 511 B
🔧 @videojs/utils — no changes
Entries (13)
Entry Initial
/array 271 B
/dom 5.25 kB
/events 320 B
/function 414 B
/i18n 249 B
/jwt 176 B
/object 535 B
/predicate 297 B
/percent 281 B
/string 239 B
/style 212 B
/time 1018 B
/number 199 B
📦 @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 changes
Entries (3)
Entry Initial
. 3.22 kB
/dom 4.00 kB
/media-tracks 2.05 kB
📦 @videojs/mux — no changes
📦 @videojs/mux-audio — no changes
Entries (2)
Entry Initial
. 136.01 kB
/spf 22.76 kB
📦 @videojs/mux-data — no changes
📦 @videojs/mux-video — no changes
Entries (2)
Entry Initial
. 135.92 kB
/spf 32.99 kB
📦 @videojs/native-hls-video — no changes
📦 @videojs/shaka-video — no changes
📦 @videojs/spf — no changes
Entries (7)
Entry Initial
. 4.56 kB
/dom 7.85 kB
/hls 28.40 kB
/media-tracks 507 B
/hls-background-video 16.60 kB
/hls-audio 21.28 kB
/hls-video 31.73 kB
📦 @videojs/spotify-audio — no changes
📦 @videojs/tiktok-video — no changes
📦 @videojs/twitch-video — no changes
📦 @videojs/other — no changes
Entries (3)
Entry Initial Lazy
video.js 74.33 kB 56.03 kB
video.js/package.json 608 B —
video.js/errors 1.03 kB —
📦 @videojs/vimeo-video — no changes
📦 @videojs/wistia-video — no changes
Entries (2)
Entry Initial
. 1.91 kB
/helpers 1.76 kB
📦 @videojs/youtube-video — no changes

ℹ️ How to interpret

Each 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 pnpm size locally to check current initial sizes.

@netlify

netlify Bot commented Sep 29, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for vjs-registry ready!

Name Link
🔨 Latest commit 760605b
🔍 Latest deploy log https://app.netlify.com/projects/vjs-registry/deploys/6abecd088e643c0008fc1100
😎 Deploy Preview https://deploy-preview-3067--vjs-registry.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

@netlify

netlify Bot commented Sep 29, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for vjs10-site ready!

Name Link
🔨 Latest commit 760605b
🔍 Latest deploy log https://app.netlify.com/projects/vjs10-site/deploys/6abecd0899640c000846f532
😎 Deploy Preview https://deploy-preview-3067--vjs10-site.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

Drop the top-level Presets tab. The five preset pages now sit in a
Presets group in the API tab, after Player. They move to
reference/api/preset-*.mdx so the API tab's pages still share
reference/api, where its llms files are written. The Presets guide links
to each page.

Also correct two preset details: null clears your title or poster so the
media's value shows, and the background player has no player-input
attributes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH
- PlayerController: without a selector, value is the base player store
  with no feature state or actions.
- PropertyDeclaration.attribute defaults to the property name as-is.
- IconTable: drop the decorative preview columns from llms output, give
  screen readers the icon name and set, and size previews with size-4.5.
- PresetFeatures: mute the empty-description dash.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH
- UIElement: explain its relation to Lit's ReactiveElement and document
  ReactiveController and ReactiveControllerHost.
- renderElement: add a Types section for UIComponentProps, RenderProp,
  RenderFunction, and HTMLProps.
- TimeSlider: describe TimeSliderChapterState where renderChapter is
  documented.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH
The reference-writing guide and the write-api-reference skill now
describe the current sidebar tabs and groups, preset pages at
reference/api/preset-*.mdx, and the Icons page. They also note that each
tab's pages must share a directory.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH

Copy link
Copy Markdown
Collaborator Author

compatibility (BrowserStack) is red, and not because of this PR.

  • First run: BrowserStack couldn't connect to chrome-111 and edge-111 ("BrowserStack could not connect … Check its availability and credentials"), so those tests never ran. The other 27 passed.
  • Re-run (once): chrome-111 and edge-111 passed this time. webkit-16.4 (/pages/react-video-mp4.html) and ios-safari-17 (/pages/html-video-minimal-mp4.html) failed instead, timing out while waiting for the play button to attach. The other 28 passed.

Different browsers failed on each run. This PR's only package change is a JSDoc comment in packages/element/src/types.ts; everything else is site docs. The same check is green on the base PR, #3066. No fix exists to port, since nothing in this diff affects runtime. I won't re-run it again.


Generated by Claude Code

Copy link
Copy Markdown
Collaborator Author

The Website Tests test failure here comes from main, not from this PR. See #3066 (comment). Three analytics tests from #3087 expect installation_skin: "minimal-video" but get "video". The same failure shows up on #3073, and nothing in this stack touches the installation code. There's no fix yet; I'll merge one up the stack once it lands on main.


Generated by Claude Code

Copy link
Copy Markdown
Collaborator Author

The astro-check failure here says IconTable.astro can't find the module @videojs/html/icons/minimal. I don't think the PR's changes cause it:

  • The source exists: packages/html/src/icons/minimal/index.ts is tracked. A local CI=1 pnpm build:packages on this exact commit emits dist/dev/icons/minimal, and astro check --minimumSeverity warning passes with 0 errors and 0 warnings.
  • This PR doesn't touch packages/html. Its diff from main is site content plus the radio-group shim deletions.
  • The CI build skipped work: it had 32 of 33 tasks hit the Vite Task cache. So my best guess is that the cache restored an @videojs/html build that predates the icons/minimal entry. I haven't confirmed that.

I'll compare against the other PRs' astro-check runs. Every PR above this one in the stack ships the same page, so they show whether this reproduces. If it comes from the cache, the fix belongs in the build-cache inputs on main, not in this PR.


Generated by Claude Code

@mihar-22 mihar-22 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.

Stack review (Claude, cross-checked with Codex gpt-6.1-sol). I checked the new pages against package source, and the remaining claims hold up. Two items below.

claude added 2 commits October 1, 2026 18:56
Main's #3092 renamed the minimal skins, their icon set, CDN bundles,
and UI entry points to neutral. The preset pages, the icons page, and
`IconTable` were written before that, so they now use the new names.

Also stops the `UIElement` page's `ClockController` example from
leaking its interval when the element is destroyed while connected.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH

Copy link
Copy Markdown
Collaborator Author

E2E (chromium) failed on 4a585c4. The failing test is keyboard.spec.ts:183, "React Audio MP4 › navigates the playback rate menu and restores focus". The playback rate changed, but the chosen item's aria-checked never became true before the menu closed. It failed on the first try and the retry.

I don't think this PR caused it:

I've re-run the failed job once. If it fails again, I'll treat it as a real failure and investigate.


Generated by Claude Code

claude added 2 commits October 1, 2026 21:08
#3026 added @videojs/{react,html}/icons/compat beside the default and neutral
sets. List it on the Icons page and show its previews in the icon table.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WLkDiofiR86hzNgRopBotH
@decepulis
decepulis merged commit 3cb8ee5 into main Oct 1, 2026
15 of 16 checks passed
@decepulis
decepulis deleted the claude/keen-mccarthy-7ams8m-pages branch October 1, 2026 21:17

This branch was successfully deployed

1 active deployment
Preview — 760605b2 Deployed Oct 1, 2026 by vercel[bot]
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants