Skip to content

Commit 11df164

Browse files
tsitsi
authored
feat!: deliver lazy bundle by default (#1032)
1 parent 244950e commit 11df164

127 files changed

Lines changed: 717 additions & 495 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎CHANGELOG.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,27 @@
1+
2+
3+
---
4+
5+
# v3 to v4 Changes - Lazy player by default
6+
7+
This release should be backwards-compatible for most player usages -
8+
typical `cloudinary.videoPlayer(...)` / `cloudinary.player(...)` calls
9+
keep working as-is, and existing CDN `<script>` tags pointing at
10+
`dist/cld-video-player.min.js` will load the same full player.
11+
12+
- Default UMD bundle is now `dist/player.min.js` (~4 KB lazy shell); the full
13+
~140 KB player loads on demand. `dist/cld-video-player.min.js` is kept as
14+
an alias of `dist/player-full.min.js`, so existing CDN `<script>` tags keep
15+
working unchanged.
16+
- `cloudinary.videoPlayer(...)` still returns synchronously, but the return
17+
value is now a thenable proxy that buffers calls until the real player
18+
loads. To keep the v3 sync contract (immediate `VideoPlayer` instance,
19+
sync `ready`), opt into the full bundle: `import 'cloudinary-video-player/full'`
20+
on NPM, or `dist/player-full.min.js` (or the existing
21+
`dist/cld-video-player.min.js` alias) on the CDN.
22+
23+
---
24+
125
## [3.14.1](https://github.com/cloudinary/cloudinary-video-player/compare/v3.14.0...v3.14.1) (2026-04-26)
226

327

‎README.md‎

Lines changed: 3 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -16,27 +16,17 @@ This README includes basic information for installation and getting started. Vie
1616

1717
```js
1818
import cloudinary from 'cloudinary-video-player';
19-
import 'cloudinary-video-player/cld-video-player.min.css';
20-
// import required plugins like that:
21-
// import 'cloudinary-video-player/chapters';
22-
// import 'cloudinary-video-player/playlist';
23-
```
24-
25-
* Note - import `/all` to get all available plugins in a single import:
26-
27-
```js
28-
import cloudinary from 'cloudinary-video-player/all';
29-
import 'cloudinary-video-player/cld-video-player.min.css';
19+
import 'cloudinary-video-player/player.min.css';
3020
```
3121

3222
### CDN
3323

3424
Cloudinary Video Player can also be included directly from the [jsDelivr CDN](https://www.jsdelivr.com/), optional plugins will be lazy-loaded on demand:
3525

3626
```html
37-
<link href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.css" rel="stylesheet">
27+
<link href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.css" rel="stylesheet">
3828

39-
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.js" type="text/javascript"></script>
29+
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.js" type="text/javascript"></script>
4030
```
4131

4232

‎docs/360.html‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,19 @@
44
<meta charset="utf-8">
55
<title>Cloudinary Video Player</title>
66
<link href="https://res.cloudinary.com/cloudinary-marketing/image/upload/f_auto,q_auto/c_scale,w_32/v1597183771/creative_staging/cloudinary_internal/Website/Brand%20Updates/Favicon/cloudinary_web_favicon_192x192.png" rel="icon" type="image/png">
7-
<script type="text/javascript" src="./scripts.js"></script>
7+
<script type="text/javascript" src="./scripts.js?full"></script>
88

99
<!--
1010
We're loading scripts & style dynamically for development/testing.
1111
Real-world usage would look like this:
1212
13-
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.css">
14-
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.js"></script>
13+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.css">
14+
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.js"></script>
1515
1616
-->
1717

1818
<script>
19-
// Delayed, load after cld-video-player.js
19+
// Delayed, load after player.js
2020
loadScript('https://unpkg.com/videojs-vr@2.0.0/dist/videojs-vr.js');
2121
</script>
2222

‎docs/_template.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@
1717
We're loading scripts & style dynamically for development/testing.
1818
Real-world usage would look like this:
1919
20-
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.css">
21-
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.js"></script>
20+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.css">
21+
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.js"></script>
2222
2323
-->
2424

‎docs/adaptive-streaming.html‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,11 @@
1919
We're loading scripts & style dynamically for development/testing.
2020
Real-world usage would look like this:
2121
22-
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.css">
23-
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.js"></script>
22+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.css">
23+
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.js"></script>
2424
-->
2525

26-
<script type="text/javascript" src="./scripts.js"></script>
26+
<script type="text/javascript" src="./scripts.js?full"></script>
2727
<script src="https://cdn.jsdelivr.net/npm/ua-parser-js@0.7.20/src/ua-parser.min.js"></script>
2828

2929
<script>

‎docs/analytics.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@
1717
We're loading scripts & style dynamically for development/testing.
1818
Real-world usage would look like this:
1919
20-
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.css">
21-
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.js"></script>
20+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.css">
21+
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.js"></script>
2222
-->
2323

2424
<script type="text/javascript" src="./scripts.js"></script>

‎docs/api.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@
1717
We're loading scripts & style dynamically for development/testing.
1818
Real-world usage would look like this:
1919
20-
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.css">
21-
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.js"></script>
20+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.css">
21+
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.js"></script>
2222
2323
-->
2424

‎docs/audio.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@
1717
We're loading scripts & style dynamically for development/testing.
1818
Real-world usage would look like this:
1919
20-
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.css">
21-
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.js"></script>
20+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.css">
21+
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.js"></script>
2222
-->
2323

2424
<script type="text/javascript" src="./scripts.js"></script>

‎docs/autoplay-on-scroll.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@
1717
We're loading scripts & style dynamically for development/testing.
1818
Real-world usage would look like this:
1919
20-
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.css">
21-
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.js"></script>
20+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.css">
21+
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.js"></script>
2222
2323
-->
2424

‎docs/breakpoints.html‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,12 +17,12 @@
1717
We're loading scripts & style dynamically for development/testing.
1818
Real-world usage would look like this:
1919
20-
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.css">
21-
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.js"></script>
20+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.css">
21+
<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/player.min.js"></script>
2222
2323
-->
2424

25-
<script type="text/javascript" src="./scripts.js"></script>
25+
<script type="text/javascript" src="./scripts.js?full"></script>
2626

2727
<style>
2828
.video-url {

0 commit comments

Comments
 (0)