@videojs/html 10.0.0 → 10.1.0

package/docs/reference/components/video-scaffold-skin.md

@@ -0,0 +1,51 @@
+# video-scaffold-skin
+
+A video skin with minimal styling for custom skins
+
+The Scaffold skin of the video preset provides functional controls with minimal styling and no transitions. It is a starting point for a custom skin, intended to be restyled before use. Its time slider supports chapter segments and thumbnail previews. See [Customize skins](../../guides/customize-skins.md) to install and edit its source.
+
+## Import
+
+```ts
+import '@videojs/html/video/scaffold-skin';
+```
+
+The import registers the skin and every UI element it composes. The [CDN](../../guides/cdn.md) player bundle registers this skin together with its player:
+
+```html
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.1.0/video-scaffold.js"></script>
+```
+
+## Usage
+
+The skin goes between the player and the media element. It renders its controls around the media.
+
+```html
+<video-player>
+  <video-scaffold-skin>
+    <video src="video.mp4"></video>
+  </video-scaffold-skin>
+</video-player>
+```
+
+## Poster
+
+The skin renders a poster image before playback starts. An element with `slot="poster"` replaces it.
+
+See [Add a poster and loading placeholder](../../guides/poster.md) for complete examples.
+
+## Thumbnail
+
+The skin renders a storyboard preview image while scrubbing the time slider. An `<img slot="thumbnail">` replaces it, so image attributes such as `crossorigin`, `loading`, and `fetchpriority` go on it.
+
+See [Show timeline thumbnail previews](../../guides/thumbnails.md) for complete examples.
+
+## Styling
+
+Packaged skins style themselves and expose a small set of public CSS custom properties. Everything else inside the skin is private and may change between releases. [Customize skins](../../guides/customize-skins.md#style-a-packaged-skin) documents the properties. For deeper changes, the Video.js registry provides the skin files.
+
+## Own the UI
+
+Packaged skins keep their controls and layout inside Video.js. When you need to add, remove, rearrange, or deeply restyle controls, use Shadcn to add the skin source to your project. Its components, layout, styles, and interactions become local files you can change.
+
+- [Install Video.js with Shadcn](../../guides/installation-shadcn.md#choose-how-to-install): Add editable skin source and build a working React or HTML player

package/docs/reference/components/video-skin.md

@@ -13,17 +13,17 @@ import '@videojs/html/video/skin';
 The import registers the skin and every UI element it composes. The [CDN](../../guides/cdn.md) player bundle registers this skin together with its player:
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.0.0/video.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.1.0/video.js"></script>
 ```
 
-## Usage
+## Anatomy
 
-The skin goes between the player and the media element. It renders its controls around the media.
+The skin goes between the player and the media component. It renders its controls around the media.
 
 ```html
 <video-player>
   <video-skin>
-    <video src="video.mp4"></video>
+    <video></video>
   </video-skin>
 </video-player>
 ```
@@ -44,6 +44,39 @@ See [Show timeline thumbnail previews](../../guides/thumbnails.md) for complete
 
 Packaged skins style themselves and expose a small set of public CSS custom properties. Everything else inside the skin is private and may change between releases. [Customize skins](../../guides/customize-skins.md#style-a-packaged-skin) documents the properties. For deeper changes, the Video.js registry provides the skin files.
 
+## Examples
+
+### Basic Usage
+
+**index.html**
+
+```html
+<video-player poster="https://image.mux.com/BV3YZtogl89mg9VcNBhhnHm02Y34zI1nlMuMQfAbl3dM/thumbnail.jpg">
+  <video-skin class="html-video-skin-basic">
+    <video src="https://stream.mux.com/BV3YZtogl89mg9VcNBhhnHm02Y34zI1nlMuMQfAbl3dM/highest.mp4" playsinline crossorigin="anonymous">
+      <track kind="metadata" label="thumbnails" src="https://image.mux.com/BV3YZtogl89mg9VcNBhhnHm02Y34zI1nlMuMQfAbl3dM/storyboard.vtt" default />
+    </video>
+  </video-skin>
+</video-player>
+```
+
+**index.css**
+
+```css
+.html-video-skin-basic {
+  display: block;
+  width: 100%;
+  aspect-ratio: 16 / 9;
+}
+```
+
+**index.ts**
+
+```ts
+import '@videojs/html/video/player';
+import '@videojs/html/video/skin';
+```
+
 ## Own the UI
 
 Packaged skins keep their controls and layout inside Video.js. When you need to add, remove, rearrange, or deeply restyle controls, use Shadcn to add the skin source to your project. Its components, layout, styles, and interactions become local files you can change.

package/docs/reference/components/video.md

@@ -4,7 +4,7 @@ Native video playback that can provide media to a Video.js player
 
 ## Import
 
-The media element is the browser’s native `<video>`. Import the video player registration when it should provide media to Video.js:
+The media component is the browser’s native `<video>`. Import the video player registration when it should provide media to Video.js:
 
 ```ts
 import '@videojs/html/video/player';

package/docs/reference/components/vimeo-video.md

@@ -17,7 +17,7 @@ import '@videojs/html/media/vimeo-video';
 Or load it from the [CDN](../../guides/cdn.md):
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.0.0/media/vimeo-video.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.1.0/media/vimeo-video.js"></script>
 ```
 
 ## Load a source

package/docs/reference/components/wistia-video.md

@@ -4,6 +4,10 @@ Video component that plays Wistia-hosted videos through Wistia's web component
 
 `<wistia-video>` adapts Wistia’s own `<wistia-player>` web component to the Video.js media contract. Wistia’s chrome stays hidden by default so a Video.js player skin can control playback; set `controls` to use Wistia’s UI.
 
+> **Caution: Wistia loads Sentry when playback fails**
+>
+> Wistia’s player loads the Sentry error-reporting SDK from `browser.sentry-cdn.com` the first time playback errors, then sends the error to a Wistia-owned Sentry project. Video.js has no setting that changes this. Wistia’s [consent API](https://docs.wistia.com/docs/player-privacy-mode) turns it off.
+
 ## Import
 
 ```bash
@@ -17,7 +21,7 @@ import '@videojs/html/media/wistia-video';
 Or load it from the [CDN](../../guides/cdn.md):
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.0.0/media/wistia-video.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.1.0/media/wistia-video.js"></script>
 ```
 
 ## Load a source

package/docs/reference/components/youtube-video.md

@@ -17,7 +17,7 @@ import '@videojs/html/media/youtube-video';
 Or load it from the [CDN](../../guides/cdn.md):
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.0.0/media/youtube-video.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.1.0/media/youtube-video.js"></script>
 ```
 
 ## Load a source
@@ -107,7 +107,7 @@ These attributes configure the embedded media adapter:
 | `seeking` | `boolean` | — | Read-only. |
 | `source` | `{ src?: string; engine?: YouTubeSourceEngineConfig } \| null` | `null` | YouTube URL or id in `src`, plus player parameters under `engine.youtube`. Replacing it re-derives `src`. |
 | `src` | `string` | `''` | |
-| `textTracks` | `TextTrackListLike` | — | Read-only. |
+| `textTracks` | `{ addEventListener(type: K, listener: ((event: Events[K]) => void), options?: { signal?: AbortSignal }): void; removeEventListener(type: K, listener: ((event: Events[K]) => void)): void; dispatchEvent(event: EventLike): boolean; length: number; readonly [index: number]: TextTrackLike; getTrackById?(id: string): TextTrackLike \| null }` | — | Read-only. |
 | `volume` | `number` | — | |
 
 ### Engine options

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@videojs/html",
-  "version": "10.0.0",
+  "version": "10.1.0",
   "description": "Video.js 10 for HTML, Vue, and Svelte: player custom elements and skins for video and audio",
   "keywords": [
     "audio",
@@ -22,7 +22,7 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/videojs/v10",
+    "url": "https://github.com/videojs/video.js",
     "directory": "packages/html"
   },
   "files": [
@@ -164,51 +164,51 @@
     "access": "public"
   },
   "dependencies": {
-    "@videojs/core": "10.0.0",
-    "@videojs/element": "10.0.0",
-    "@videojs/media": "10.0.0",
-    "@videojs/native-hls-video": "10.0.0",
-    "@videojs/spf": "10.0.0",
-    "@videojs/store": "10.0.0",
-    "@videojs/utils": "10.0.0"
+    "@videojs/core": "10.1.0",
+    "@videojs/element": "10.1.0",
+    "@videojs/media": "10.1.0",
+    "@videojs/native-hls-video": "10.1.0",
+    "@videojs/spf": "10.1.0",
+    "@videojs/store": "10.1.0",
+    "@videojs/utils": "10.1.0"
   },
   "devDependencies": {
-    "@testing-library/dom": "^10.4.1",
-    "@videojs/cloudflare-video": "10.0.0",
-    "@videojs/dash-video": "10.0.0",
-    "@videojs/google-cast": "10.0.0",
-    "@videojs/hlsjs-video": "10.0.0",
-    "@videojs/icons": "10.0.0",
-    "@videojs/mux-audio": "10.0.0",
-    "@videojs/mux-data": "10.0.0",
-    "@videojs/mux-video": "10.0.0",
-    "@videojs/shaka-video": "10.0.0",
-    "@videojs/skins": "10.0.0",
-    "@videojs/spotify-audio": "10.0.0",
-    "@videojs/tiktok-video": "10.0.0",
-    "@videojs/twitch-video": "10.0.0",
-    "@videojs/vimeo-video": "10.0.0",
-    "@videojs/wistia-video": "10.0.0",
-    "@videojs/youtube-video": "10.0.0",
+    "@videojs/cloudflare-video": "10.1.0",
+    "@videojs/dash-video": "10.1.0",
+    "@videojs/google-cast": "10.1.0",
+    "@videojs/hlsjs-video": "10.1.0",
+    "@videojs/icons": "10.1.0",
+    "@videojs/mux-audio": "10.1.0",
+    "@videojs/mux-data": "10.1.0",
+    "@videojs/mux-video": "10.1.0",
+    "@videojs/playerjs-video": "10.1.0",
+    "@videojs/shaka-video": "10.1.0",
+    "@videojs/skins": "10.1.0",
+    "@videojs/spotify-audio": "10.1.0",
+    "@videojs/tiktok-video": "10.1.0",
+    "@videojs/twitch-video": "10.1.0",
+    "@videojs/vimeo-video": "10.1.0",
+    "@videojs/wistia-video": "10.1.0",
+    "@videojs/youtube-video": "10.1.0",
     "happy-dom": "^20.11.1",
-    "typescript": "^6.0.2",
     "vite-plus": "1.0.0"
   },
   "peerDependencies": {
-    "@videojs/cloudflare-video": "10.0.0",
-    "@videojs/dash-video": "10.0.0",
-    "@videojs/google-cast": "10.0.0",
-    "@videojs/hlsjs-video": "10.0.0",
-    "@videojs/mux-audio": "10.0.0",
-    "@videojs/mux-data": "10.0.0",
-    "@videojs/mux-video": "10.0.0",
-    "@videojs/shaka-video": "10.0.0",
-    "@videojs/spotify-audio": "10.0.0",
-    "@videojs/tiktok-video": "10.0.0",
-    "@videojs/twitch-video": "10.0.0",
-    "@videojs/vimeo-video": "10.0.0",
-    "@videojs/wistia-video": "10.0.0",
-    "@videojs/youtube-video": "10.0.0"
+    "@videojs/cloudflare-video": "10.1.0",
+    "@videojs/dash-video": "10.1.0",
+    "@videojs/google-cast": "10.1.0",
+    "@videojs/hlsjs-video": "10.1.0",
+    "@videojs/mux-audio": "10.1.0",
+    "@videojs/mux-data": "10.1.0",
+    "@videojs/mux-video": "10.1.0",
+    "@videojs/playerjs-video": "10.1.0",
+    "@videojs/shaka-video": "10.1.0",
+    "@videojs/spotify-audio": "10.1.0",
+    "@videojs/tiktok-video": "10.1.0",
+    "@videojs/twitch-video": "10.1.0",
+    "@videojs/vimeo-video": "10.1.0",
+    "@videojs/wistia-video": "10.1.0",
+    "@videojs/youtube-video": "10.1.0"
   },
   "peerDependenciesMeta": {
     "@videojs/cloudflare-video": {
@@ -232,6 +232,9 @@
     "@videojs/mux-video": {
       "optional": true
     },
+    "@videojs/playerjs-video": {
+      "optional": true
+    },
     "@videojs/shaka-video": {
       "optional": true
     },