shaka-player 4.12.9 → 4.13.0

package/lib/text/vtt_text_parser.js

@@ -95,7 +95,7 @@ shaka.text.VttTextParser = class {
     }
 
     // Parse VTT regions.
-    /* !Array.<!shaka.text.CueRegion> */
+    /* !Array<!shaka.text.CueRegion> */
     const regions = [];
     for (const line of blocks[0].split('\n')) {
       if (/^Region:/.test(line)) {
@@ -104,7 +104,7 @@ shaka.text.VttTextParser = class {
       }
     }
 
-    /** @type {!Map.<string, !shaka.text.Cue>} */
+    /** @type {!Map<string, !shaka.text.Cue>} */
     const styles = new Map();
     shaka.text.Cue.addDefaultTextColor(styles);
 
@@ -207,8 +207,8 @@ shaka.text.VttTextParser = class {
   /**
    * Parses a style block into a Cue object.
    *
-   * @param {!Array.<string>} text
-   * @param {!Map.<string, !shaka.text.Cue>} styles
+   * @param {!Array<string>} text
+   * @param {!Map<string, !shaka.text.Cue>} styles
    * @private
    */
   static parseStyle_(text, styles) {
@@ -227,7 +227,7 @@ shaka.text.VttTextParser = class {
       return;
     }
 
-    /** @type {!Array.<!Array.<string>>} */
+    /** @type {!Array<!Array<string>>} */
     const styleBlocks = [];
     let lastBlockIndex = -1;
     for (let i = 1; i < text.length; i++) {
@@ -352,10 +352,10 @@ shaka.text.VttTextParser = class {
   /**
    * Parses a text block into a Cue object.
    *
-   * @param {!Array.<string>} text
+   * @param {!Array<string>} text
    * @param {number} timeOffset
-   * @param {!Array.<!shaka.text.CueRegion>} regions
-   * @param {!Map.<string, !shaka.text.Cue>} styles
+   * @param {!Array<!shaka.text.CueRegion>} regions
+   * @param {!Map<string, !shaka.text.Cue>} styles
    * @return {shaka.text.Cue}
    * @private
    */
@@ -437,7 +437,7 @@ shaka.text.VttTextParser = class {
    *
    * @param {!shaka.text.Cue} cue
    * @param {string} word
-   * @param {!Array.<!shaka.text.CueRegion>} regions
+   * @param {!Array<!shaka.text.CueRegion>} regions
    * @return {boolean} True on success.
    */
   static parseCueSetting(cue, word, regions) {
@@ -471,7 +471,7 @@ shaka.text.VttTextParser = class {
 
   /**
    *
-   * @param {!Array.<!shaka.text.CueRegion>} regions
+   * @param {!Array<!shaka.text.CueRegion>} regions
    * @param {string} id
    * @return {?shaka.text.CueRegion}
    * @private

package/lib/text/web_vtt_generator.js

@@ -16,8 +16,8 @@ goog.require('shaka.text.Utils');
  */
 shaka.text.WebVttGenerator = class {
   /**
-   * @param {!Array.<!shaka.text.Cue>} cues
-   * @param {!Array.<!shaka.extern.AdCuePoint>} adCuePoints
+   * @param {!Array<!shaka.text.Cue>} cues
+   * @param {!Array<!shaka.extern.AdCuePoint>} adCuePoints
    * @return {string}
    */
   static convert(cues, adCuePoints) {

package/lib/transmuxer/aac_transmuxer.js

@@ -33,7 +33,7 @@ shaka.transmuxer.AacTransmuxer = class {
     /** @private {number} */
     this.frameIndex_ = 0;
 
-    /** @private {!Map.<string, !Uint8Array>} */
+    /** @private {!Map<string, !Uint8Array>} */
     this.initSegments = new Map();
 
     /** @private {?Uint8Array} */
@@ -150,7 +150,7 @@ shaka.transmuxer.AacTransmuxer = class {
     stream.audioSamplingRate = info.sampleRate;
     stream.channelsCount = info.channelCount;
 
-    /** @type {!Array.<shaka.util.Mp4Generator.Mp4Sample>} */
+    /** @type {!Array<shaka.util.Mp4Generator.Mp4Sample>} */
     const samples = [];
 
     while (offset < uint8ArrayData.length) {

package/lib/transmuxer/ac3_transmuxer.js

@@ -32,7 +32,7 @@ shaka.transmuxer.Ac3Transmuxer = class {
     /** @private {number} */
     this.frameIndex_ = 0;
 
-    /** @private {!Map.<string, !Uint8Array>} */
+    /** @private {!Map<string, !Uint8Array>} */
     this.initSegments = new Map();
 
     /** @private {?Uint8Array} */
@@ -138,7 +138,7 @@ shaka.transmuxer.Ac3Transmuxer = class {
     /** @type {!Uint8Array} */
     let audioConfig = new Uint8Array([]);
 
-    /** @type {!Array.<shaka.util.Mp4Generator.Mp4Sample>} */
+    /** @type {!Array<shaka.util.Mp4Generator.Mp4Sample>} */
     const samples = [];
 
     while (offset < uint8ArrayData.length) {

package/lib/transmuxer/adts.js

@@ -4,6 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+// cspell:ignore lavfi aevalsrc libfdk hexdump
+
 goog.provide('shaka.transmuxer.ADTS');
 
 

package/lib/transmuxer/ec3.js

@@ -87,9 +87,9 @@ shaka.transmuxer.Ec3 = class {
    * @return {boolean}
    */
   static probe(data, offset) {
-    // search 16-bit 0x0B77 syncword
-    const syncword = (data[offset] << 8) | (data[offset + 1] << 0);
-    if (syncword === 0x0B77) {
+    // search 16-bit 0x0B77 sync word
+    const syncWord = (data[offset] << 8) | (data[offset + 1] << 0);
+    if (syncWord === 0x0B77) {
       return true;
     } else {
       return false;

package/lib/transmuxer/ec3_transmuxer.js

@@ -32,7 +32,7 @@ shaka.transmuxer.Ec3Transmuxer = class {
     /** @private {number} */
     this.frameIndex_ = 0;
 
-    /** @private {!Map.<string, !Uint8Array>} */
+    /** @private {!Map<string, !Uint8Array>} */
     this.initSegments = new Map();
 
     /** @private {?Uint8Array} */
@@ -138,7 +138,7 @@ shaka.transmuxer.Ec3Transmuxer = class {
     /** @type {!Uint8Array} */
     let audioConfig = new Uint8Array([]);
 
-    /** @type {!Array.<shaka.util.Mp4Generator.Mp4Sample>} */
+    /** @type {!Array<shaka.util.Mp4Generator.Mp4Sample>} */
     const samples = [];
 
     while (offset < uint8ArrayData.length) {

package/lib/transmuxer/h264.js

@@ -19,7 +19,7 @@ shaka.transmuxer.H264 = class {
    * properties. A sequence parameter set is the H264 metadata that
    * describes the properties of upcoming video frames.
    *
-   * @param {!Array.<shaka.extern.VideoNalu>} nalus
+   * @param {!Array<shaka.extern.VideoNalu>} nalus
    * @return {?{height: number, width: number, videoConfig: !Uint8Array,
    *            hSpacing: number, vSpacing: number}}
    */
@@ -196,13 +196,13 @@ shaka.transmuxer.H264 = class {
   }
 
   /**
-   * @param {!Array.<shaka.extern.MPEG_PES>} videoData
-   * @return {!Array.<shaka.extern.VideoSample>}
+   * @param {!Array<shaka.extern.MPEG_PES>} videoData
+   * @return {!Array<shaka.extern.VideoSample>}
    */
   static getVideoSamples(videoData) {
     const H264 = shaka.transmuxer.H264;
 
-    /** @type {!Array.<shaka.extern.VideoSample>} */
+    /** @type {!Array<shaka.extern.VideoSample>} */
     const videoSamples = [];
     /** @type {?shaka.extern.VideoSample} */
     let lastVideoSample = null;
@@ -418,7 +418,7 @@ shaka.transmuxer.H264.NALU_TYPE_FILLER_DATA_ = 0x0c;
  * see Recommendation ITU-T H.264 (4/2013)
  * 7.3.2.1.1 Sequence parameter set data syntax
  *
- * @const {!Array.<number>}
+ * @const {!Array<number>}
  * @private
  */
 shaka.transmuxer.H264.PROFILES_WITH_OPTIONAL_SPS_DATA_ =

package/lib/transmuxer/h265.js

@@ -19,7 +19,7 @@ shaka.transmuxer.H265 = class {
    * properties. A sequence parameter set is the H265 metadata that
    * describes the properties of upcoming video frames.
    *
-   * @param {!Array.<shaka.extern.VideoNalu>} nalus
+   * @param {!Array<shaka.extern.VideoNalu>} nalus
    * @return {?{height: number, width: number, videoConfig: !Uint8Array,
    *            hSpacing: number, vSpacing: number}}
    */
@@ -139,7 +139,7 @@ shaka.transmuxer.H265 = class {
     let bottomOffset = 0;
 
     // SPS
-    gb.readBits(4); // video_paramter_set_id
+    gb.readBits(4); // video_parameter_set_id
     const maxSubLayersMinus1 = gb.readBits(3);
     gb.readBoolean(); // temporal_id_nesting_flag
 
@@ -600,7 +600,7 @@ shaka.transmuxer.H265 = class {
   }
 
   /**
-   * @param {!Array.<shaka.extern.VideoNalu>} nalus
+   * @param {!Array<shaka.extern.VideoNalu>} nalus
    * @return {?{data: !Uint8Array, isKeyframe: boolean}}
    */
   static parseFrame(nalus) {

package/lib/transmuxer/mp3_transmuxer.js

@@ -32,7 +32,7 @@ shaka.transmuxer.Mp3Transmuxer = class {
     /** @private {number} */
     this.frameIndex_ = 0;
 
-    /** @private {!Map.<string, !Uint8Array>} */
+    /** @private {!Map<string, !Uint8Array>} */
     this.initSegments = new Map();
 
     /** @private {?Uint8Array} */
@@ -122,7 +122,7 @@ shaka.transmuxer.Mp3Transmuxer = class {
     const timescale = 90000;
     let firstHeader;
 
-    /** @type {!Array.<shaka.util.Mp4Generator.Mp4Sample>} */
+    /** @type {!Array<shaka.util.Mp4Generator.Mp4Sample>} */
     const samples = [];
 
     while (offset < uint8ArrayData.length) {

package/lib/transmuxer/mpeg_audio.js

@@ -40,7 +40,7 @@ shaka.transmuxer.MpegAudio = class {
           columnInBitrates * 14 + bitRateIndex - 1] * 1000;
       const columnInSampleRates =
         mpegVersion === 3 ? 0 : mpegVersion === 2 ? 1 : 2;
-      const sampleRate = MpegAudio.SAMPLINGRATE_MAP_[
+      const sampleRate = MpegAudio.SAMPLING_RATE_MAP_[
           columnInSampleRates * 3 + sampleRateIndex];
       // If bits of channel mode are `11` then it is a single channel (Mono)
       const channelCount = channelMode === 3 ? 1 : 2;
@@ -128,7 +128,7 @@ shaka.transmuxer.MpegAudio = class {
 
 
 /**
- * @private {!Array.<number>}
+ * @private {!Array<number>}
  */
 shaka.transmuxer.MpegAudio.BITRATES_MAP_ = [
   32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384, 416, 448, 32, 48, 56,
@@ -139,14 +139,14 @@ shaka.transmuxer.MpegAudio.BITRATES_MAP_ = [
 ];
 
 /**
- * @private {!Array.<number>}
+ * @private {!Array<number>}
  */
-shaka.transmuxer.MpegAudio.SAMPLINGRATE_MAP_ = [
+shaka.transmuxer.MpegAudio.SAMPLING_RATE_MAP_ = [
   44100, 48000, 32000, 22050, 24000, 16000, 11025, 12000, 8000,
 ];
 
 /**
- * @private {!Array.<!Array.<number>>}
+ * @private {!Array<!Array<number>>}
  */
 shaka.transmuxer.MpegAudio.SAMPLES_COEFFICIENTS_ = [
   // MPEG 2.5
@@ -181,7 +181,7 @@ shaka.transmuxer.MpegAudio.SAMPLES_COEFFICIENTS_ = [
 
 
 /**
- * @private {!Array.<number>}
+ * @private {!Array<number>}
  */
 shaka.transmuxer.MpegAudio.BYTES_IN_SLOT_ = [
   0, // Reserved

package/lib/transmuxer/mss_transmuxer.js

@@ -30,6 +30,8 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+// cspell:words crypted usertype
+
 goog.provide('shaka.transmuxer.MssTransmuxer');
 
 goog.require('shaka.media.Capabilities');

package/lib/transmuxer/transmuxer_engine.js

@@ -139,7 +139,7 @@ shaka.transmuxer.TransmuxerEngine.PluginObject;
 
 
 /**
- * @private {!Object.<string, !shaka.transmuxer.TransmuxerEngine.PluginObject>}
+ * @private {!Object<string, !shaka.transmuxer.TransmuxerEngine.PluginObject>}
  */
 shaka.transmuxer.TransmuxerEngine.transmuxerMap_ = {};
 

package/lib/transmuxer/ts_transmuxer.js

@@ -44,7 +44,7 @@ shaka.transmuxer.TsTransmuxer = class {
     /** @private {number} */
     this.frameIndex_ = 0;
 
-    /** @private {!Map.<string, !Uint8Array>} */
+    /** @private {!Map<string, !Uint8Array>} */
     this.initSegments = new Map();
 
     /** @private {?shaka.util.TsParser} */
@@ -322,7 +322,7 @@ shaka.transmuxer.TsTransmuxer = class {
     const timescale = shaka.util.TsParser.Timescale;
     const Uint8ArrayUtils = shaka.util.Uint8ArrayUtils;
 
-    /** @type {!Array.<shaka.util.Mp4Generator.Mp4Sample>} */
+    /** @type {!Array<shaka.util.Mp4Generator.Mp4Sample>} */
     const samples = [];
 
     let info;
@@ -509,7 +509,7 @@ shaka.transmuxer.TsTransmuxer = class {
     const Ac3 = shaka.transmuxer.Ac3;
     const timescale = shaka.util.TsParser.Timescale;
 
-    /** @type {!Array.<shaka.util.Mp4Generator.Mp4Sample>} */
+    /** @type {!Array<shaka.util.Mp4Generator.Mp4Sample>} */
     const samples = [];
 
     /** @type {number} */
@@ -604,7 +604,7 @@ shaka.transmuxer.TsTransmuxer = class {
     const Ec3 = shaka.transmuxer.Ec3;
     const timescale = shaka.util.TsParser.Timescale;
 
-    /** @type {!Array.<shaka.util.Mp4Generator.Mp4Sample>} */
+    /** @type {!Array<shaka.util.Mp4Generator.Mp4Sample>} */
     const samples = [];
 
     /** @type {number} */
@@ -699,7 +699,7 @@ shaka.transmuxer.TsTransmuxer = class {
     const MpegAudio = shaka.transmuxer.MpegAudio;
     const timescale = shaka.util.TsParser.Timescale;
 
-    /** @type {!Array.<shaka.util.Mp4Generator.Mp4Sample>} */
+    /** @type {!Array<shaka.util.Mp4Generator.Mp4Sample>} */
     const samples = [];
 
     let firstHeader;
@@ -789,7 +789,7 @@ shaka.transmuxer.TsTransmuxer = class {
     const Opus = shaka.transmuxer.Opus;
     const timescale = shaka.util.TsParser.Timescale;
 
-    /** @type {!Array.<shaka.util.Mp4Generator.Mp4Sample>} */
+    /** @type {!Array<shaka.util.Mp4Generator.Mp4Sample>} */
     const samples = [];
 
     let firstPts = null;
@@ -901,7 +901,7 @@ shaka.transmuxer.TsTransmuxer = class {
     const H264 = shaka.transmuxer.H264;
     const timescale = shaka.util.TsParser.Timescale;
 
-    /** @type {!Array.<shaka.util.Mp4Generator.Mp4Sample>} */
+    /** @type {!Array<shaka.util.Mp4Generator.Mp4Sample>} */
     const samples = [];
 
     /** @type {?number} */
@@ -995,7 +995,7 @@ shaka.transmuxer.TsTransmuxer = class {
     const H265 = shaka.transmuxer.H265;
     const timescale = shaka.util.TsParser.Timescale;
 
-    /** @type {!Array.<shaka.util.Mp4Generator.Mp4Sample>} */
+    /** @type {!Array<shaka.util.Mp4Generator.Mp4Sample>} */
     const samples = [];
 
     /** @type {?number} */
@@ -1083,7 +1083,7 @@ shaka.transmuxer.TsTransmuxer = class {
  * Supported audio codecs.
  *
  * @private
- * @const {!Array.<string>}
+ * @const {!Array<string>}
  */
 shaka.transmuxer.TsTransmuxer.SUPPORTED_AUDIO_CODECS_ = [
   'aac',
@@ -1097,7 +1097,7 @@ shaka.transmuxer.TsTransmuxer.SUPPORTED_AUDIO_CODECS_ = [
  * Supported audio codecs.
  *
  * @private
- * @const {!Array.<string>}
+ * @const {!Array<string>}
  */
 shaka.transmuxer.TsTransmuxer.SUPPORTED_VIDEO_CODECS_ = [
   'avc',

package/lib/util/abortable_operation.js

@@ -11,29 +11,29 @@ goog.require('shaka.util.PublicPromise');
 
 /**
  * A utility to wrap abortable operations.  Note that these are not cancelable.
- * Cancelation implies undoing what has been done so far, whereas aborting only
+ * Cancellation implies undoing what has been done so far, whereas aborting only
  * means that further work is stopped.
  *
- * @implements {shaka.extern.IAbortableOperation.<T>}
+ * @implements {shaka.extern.IAbortableOperation<T>}
  * @template T
  * @export
  */
 shaka.util.AbortableOperation = class {
   /**
-   * @param {!Promise.<T>} promise
+   * @param {!Promise<T>} promise
    *   A Promise which represents the underlying operation.  It is resolved when
    *   the operation is complete, and rejected if the operation fails or is
    *   aborted.  Aborted operations should be rejected with a shaka.util.Error
    *   object using the error code OPERATION_ABORTED.
    * @param {function():!Promise} onAbort
    *   Will be called by this object to abort the underlying operation.
-   *   This is not cancelation, and will not necessarily result in any work
+   *   This is not cancellation, and will not necessarily result in any work
    *   being undone.  abort() should return a Promise which is resolved when the
    *   underlying operation has been aborted.  The returned Promise should never
    *   be rejected.
    */
   constructor(promise, onAbort) {
-    /** @const {!Promise.<T>} */
+    /** @const {!Promise<T>} */
     this.promise = promise;
 
     /** @private {function():!Promise} */
@@ -98,7 +98,7 @@ shaka.util.AbortableOperation = class {
   }
 
   /**
-   * @param {!Promise.<U>} promise
+   * @param {!Promise<U>} promise
    * @return {!shaka.util.AbortableOperation.<U>} An operation which cannot be
    *   aborted.  It will be completed when the given Promise is resolved, or
    *   will be failed when the given Promise is rejected.
@@ -125,7 +125,7 @@ shaka.util.AbortableOperation = class {
   }
 
   /**
-   * @param {!Array.<!shaka.util.AbortableOperation>} operations
+   * @param {!Array<!shaka.util.AbortableOperation>} operations
    * @return {!shaka.util.AbortableOperation} An operation which is resolved
    *   when all operations are successful and fails when any operation fails.
    *   For this operation, abort() aborts all given operations.
@@ -149,7 +149,7 @@ shaka.util.AbortableOperation = class {
   /**
    * @param {(undefined|
    *          function(T):U|
-   *          function(T):!Promise.<U>|
+   *          function(T):!Promise<U>|
    *          function(T):!shaka.util.AbortableOperation.<U>)} onSuccess
    *   A callback to be invoked after this operation is complete, to chain to
    *   another operation.  The callback can return a plain value, a Promise to
@@ -212,7 +212,7 @@ shaka.util.AbortableOperation = class {
 
   /**
    * @param {(function(T):U|
-   *          function(T):!Promise.<U>|
+   *          function(T):!Promise<U>|
    *          function(T):!shaka.util.AbortableOperation.<U>|
    *          function(*))} callback
    *   A callback to be invoked with the given value.
@@ -254,7 +254,7 @@ shaka.util.AbortableOperation = class {
 };
 
 /**
- * @const {!Promise.<T>}
+ * @const {!Promise<T>}
  * @exportInterface
  */
 // eslint-disable-next-line no-restricted-syntax

package/lib/util/array_utils.js

@@ -34,7 +34,7 @@ shaka.util.ArrayUtils = class {
 
   /**
    * Remove given element from array (assumes no duplicates).
-   * @param {!Array.<T>} array
+   * @param {!Array<T>} array
    * @param {T} element
    * @template T
    */
@@ -48,7 +48,7 @@ shaka.util.ArrayUtils = class {
 
   /**
    * Count the number of items in the list that pass the check function.
-   * @param {!Array.<T>} array
+   * @param {!Array<T>} array
    * @param {function(T):boolean} check
    * @return {number}
    * @template T
@@ -67,8 +67,8 @@ shaka.util.ArrayUtils = class {
   /**
    * Determines if the given arrays contain equal elements in any order.
    *
-   * @param {!Array.<T>} a
-   * @param {!Array.<T>} b
+   * @param {!Array<T>} a
+   * @param {!Array<T>} b
    * @param {function(T, T):boolean=} compareFn
    * @return {boolean}
    * @template T
@@ -100,8 +100,8 @@ shaka.util.ArrayUtils = class {
   /**
    * Determines if the given arrays contain equal elements in the same order.
    *
-   * @param {!Array.<T>} a
-   * @param {!Array.<T>} b
+   * @param {!Array<T>} a
+   * @param {!Array<T>} b
    * @param {function(T, T):boolean=} compareFn
    * @return {boolean}
    * @template T