@checksub_team/peaks_timeline 1.16.0-alpha.2 → 2.0.0-alpha.0

package/src/{source.js → models/source.js}

@@ -1,1269 +1,1262 @@
-/**
- * @file
- *
- * Defines the {@link source} class.
- *
- * @module source
- */
-
-define([
-  './utils'
-], function(Utils) {
-  'use strict';
-
-  function validateSource(peaks, options, context) {
-    if (!Utils.isValidTime(options.startTime)) {
-      throw new TypeError('peaks.sources.' + context + ': startTime should be a valid number');
-    }
-
-    if (!Utils.isValidTime(options.endTime)) {
-      throw new TypeError('peaks.sources.' + context + ': endTime should be a valid number');
-    }
-
-    if (!Utils.isValidTime(options.duration) || options.duration <= 0) {
-      options.duration = 0;
-    }
-    else if (options.duration < peaks.options.minSourceSize) {
-      options.duration = peaks.options.minSourceSize;
-    }
-
-    options.duration = Utils.roundTime(options.duration);
-
-    if (options.startTime < 0) {
-      throw new RangeError('peaks.sources.' + context + ': startTime should be positive');
-    }
-
-    if (options.endTime < 0) {
-      throw new RangeError('peaks.sources.' + context + ': endTime should be positive');
-    }
-
-    if (options.endTime <= options.startTime) {
-      throw new RangeError(
-        'peaks.sources.' + context + ': endTime should be greater than startTime'
-      );
-    }
-
-    if (options.endTime - options.startTime < peaks.options.minSourceSize) {
-      options.endTime = options.startTime + peaks.options.minSourceSize;
-    }
-
-    if (!Utils.isValidTime(options.mediaStartTime) || options.mediaStartTime < 0) {
-      options.mediaStartTime = 0;
-    }
-
-    if (!Utils.isValidTime(options.mediaEndTime)
-      || (options.mediaEndTime < options.mediaStartTime)
-      || (options.mediaEndTime - options.mediaStartTime !== options.endTime - options.startTime)) {
-      options.mediaEndTime = options.mediaStartTime + (options.endTime - options.startTime);
-    }
-
-    if (options.duration && options.mediaEndTime > options.duration) {
-      var timeWidth = options.mediaEndTime - options.mediaStartTime;
-
-      options.mediaEndTime = options.duration;
-      if (options.duration > timeWidth) {
-        options.mediaStartTime = options.mediaEndTime - timeWidth;
-        options.endTime = options.startTime + timeWidth;
-      }
-      else {
-        options.mediaStartTime = 0;
-        options.endTime = options.startTime + options.duration;
-      }
-    }
-
-    options.startTime = Utils.roundTime(options.startTime);
-    options.endTime = Utils.roundTime(options.endTime);
-    options.mediaStartTime = Utils.roundTime(options.mediaStartTime);
-    options.mediaEndTime = Utils.roundTime(options.mediaEndTime);
-
-    if (Utils.isNullOrUndefined(options.title)) {
-      options.title = '';
-    }
-    else if (!Utils.isString(options.title)) {
-      throw new TypeError('peaks.sources.' + context + ': title must be a string');
-    }
-
-    if (Utils.isNullOrUndefined(options.titleAlignments)) {
-      options.titleAlignments = [];
-    }
-    else if (!Array.isArray(options.titleAlignments)) {
-      throw new TypeError('peaks.sources.' + context + ': titleAlignments must be an array');
-    }
-
-    if (Utils.isNullOrUndefined(options.url)) {
-      options.url = '';
-    }
-    else if (!Utils.isString(options.url)) {
-      throw new TypeError('peaks.sources.' + context + ': url must be a string');
-    }
-
-    if (Utils.isNullOrUndefined(options.previewUrl)) {
-      options.previewUrl = '';
-    }
-    else if (!Utils.isString(options.previewUrl)) {
-      throw new TypeError('peaks.sources.' + context + ': previewUrl must be a string');
-    }
-
-    if (Utils.isNullOrUndefined(options.binaryUrl)) {
-      options.binaryUrl = '';
-    }
-    else if (!Utils.isString(options.binaryUrl)) {
-      throw new TypeError('peaks.sources.' + context + ': binaryUrl must be a string');
-    }
-
-    if (!Utils.isValidColor(options.color)) {
-      options.color = peaks.options.zoomWaveformColor;
-    }
-
-    if (!Utils.isValidColor(options.backgroundColor)) {
-      throw new TypeError(
-        'peaks.sources.' + context + ': backgroundColor should be a valid CSS color'
-      );
-    }
-
-    if (!Utils.isValidColor(options.borderColor)) {
-      options.borderColor = options.color;
-    }
-
-    if (Utils.isNullOrUndefined(options.selectedColor)) {
-      options.selectedColor = null;
-    }
-    else if (!Utils.isValidColor(options.selectedColor)) {
-      throw new TypeError(
-        'peaks.sources.' + context + ': selectedColor should be a valid CSS color'
-      );
-    }
-
-    if (Utils.isNullOrUndefined(options.warningColor)) {
-      options.warningColor = null;
-    }
-    else if (!Utils.isValidColor(options.warningColor)) {
-      throw new TypeError(
-        'peaks.sources.' + context + ': warningColor should be a valid CSS color'
-      );
-    }
-
-    if (Utils.isNullOrUndefined(options.warningWidth)) {
-      options.warningWidth = 10;
-    }
-    else if (!Utils.isNumber(options.warningWidth)) {
-      throw new TypeError('peaks.sources.' + context + ': warningWidth should be a number');
-    }
-
-    if (Utils.isNullOrUndefined(options.volumeSliderColor)) {
-      options.volumeSliderColor = '#000000';
-    }
-    else if (!Utils.isValidColor(options.volumeSliderColor)) {
-      throw new TypeError(
-        'peaks.sources.' + context + ': volumeSliderColor should be a valid CSS color'
-      );
-    }
-
-    if (Utils.isNullOrUndefined(options.volumeSliderWidth)) {
-      options.volumeSliderWidth = 2;
-    }
-    else if (!Utils.isNumber(options.volumeSliderWidth)) {
-      throw new TypeError('peaks.sources.' + context + ': volumeSliderWidth should be a number');
-    }
-
-    if (Utils.isNullOrUndefined(options.volumeSliderDraggingWidth)) {
-      options.volumeSliderDraggingWidth = options.volumeSliderWidth;
-    }
-    else if (!Utils.isNumber(options.volumeSliderDraggingWidth)) {
-      throw new TypeError(
-        'peaks.sources.' + context + ': volumeSliderDraggingWidth should be a number'
-      );
-    }
-
-    if (Utils.isNullOrUndefined(options.textFont)) {
-      options.textFont = 'Arial';
-    }
-
-    if (Utils.isNullOrUndefined(options.textFontSize)) {
-      options.textFontSize = 12;
-    }
-
-    if (Utils.isNullOrUndefined(options.textColor)) {
-      options.textColor = '#000000';
-    }
-    else if (!Utils.isValidColor(options.textColor)) {
-      throw new TypeError('peaks.sources.' + context + ': textColor should be a valid CSS color');
-    }
-
-    if (!Utils.isNullOrUndefined(options.textBackgroundColor)
-      && !Utils.isValidColor(options.textBackgroundColor)) {
-      throw new TypeError(
-        'peaks.sources.' + context + ': textBackgroundColor should be a valid CSS color'
-      );
-    }
-
-    if (Utils.isNullOrUndefined(options.textPosition)) {
-      options.textPosition = 'bottom';
-    }
-    else if (!Utils.isString(options.textPosition)) {
-      throw new TypeError('peaks.sources.' + context + ': textPosition must be a string');
-    }
-
-    if (Utils.isNullOrUndefined(options.textAutoScroll)) {
-      options.textAutoScroll = false;
-    }
-
-    if (Utils.isNullOrUndefined(options.borderWidth)) {
-      options.borderWidth = 0;
-    }
-
-    if (Utils.isNullOrUndefined(options.wrapped)) {
-      options.wrapped = false;
-    }
-    else if (!Utils.isBoolean(options.wrapped)) {
-      throw new TypeError('peaks.sources.' + context + ': wrapped must be a boolean');
-    }
-
-    if (!Utils.isInteger(options.position)) {
-      throw new TypeError('peaks.sources.' + context + ': position must be an integer');
-    }
-
-    if (Utils.isNullOrUndefined(options.draggable)) {
-      options.draggable = true;
-    }
-    else if (!Utils.isBoolean(options.draggable)) {
-      throw new TypeError('peaks.sources.' + context + ': draggable must be a boolean');
-    }
-
-    if (Utils.isNullOrUndefined(options.orderable)) {
-      options.orderable = true;
-    }
-    else if (!Utils.isBoolean(options.orderable)) {
-      throw new TypeError('peaks.sources.' + context + ': orderable must be a boolean');
-    }
-
-    if (Utils.isNullOrUndefined(options.resizable)) {
-      options.resizable = true;
-    }
-    else if (!Utils.isBoolean(options.resizable)) {
-      throw new TypeError('peaks.sources.' + context + ': resizable must be a boolean');
-    }
-
-    if (Utils.isNullOrUndefined(options.cuttable)) {
-      options.cuttable = true;
-    }
-    else if (!Utils.isBoolean(options.cuttable)) {
-      throw new TypeError('peaks.sources.' + context + ': cuttable must be a boolean');
-    }
-
-    if (Utils.isNullOrUndefined(options.deletable)) {
-      options.deletable = true;
-    }
-    else if (!Utils.isBoolean(options.deletable)) {
-      throw new TypeError('peaks.sources.' + context + ': deletable must be a boolean');
-    }
-
-    if (Utils.isNullOrUndefined(options.wrapping)) {
-      options.wrapping = 'both';
-    }
-    else if (!Utils.isString(options.wrapping)) {
-      throw new TypeError('peaks.sources.' + context + ': wrapping must be a string');
-    }
-
-    if (Utils.isNullOrUndefined(options.previewHeight)) {
-      options.previewHeight = 0;
-    }
-    else if (!Utils.isNumber(options.previewHeight)) {
-      throw new TypeError('peaks.sources.' + context + ': previewHeight must be a number');
-    }
-
-    if (Utils.isNullOrUndefined(options.binaryHeight)) {
-      options.binaryHeight = 0;
-    }
-    else if (!Utils.isNumber(options.binaryHeight)) {
-      throw new TypeError('peaks.sources.' + context + ': binaryHeight must be a number');
-    }
-
-    if (options.previewUrl && !options.previewHeight) {
-      if (options.binaryHeight) {
-        options.previewHeight = Math.max(peaks.options.lineHeight - options.binaryHeight, 0);
-      }
-      else {
-        options.previewHeight = peaks.options.lineHeight / 2;
-      }
-    }
-
-    if (options.binaryUrl && !options.binaryHeight) {
-      options.binaryHeight = Math.max(peaks.options.lineHeight - options.previewHeight, 0);
-    }
-
-    if (options.wrapping === 'reduced') {
-      options.wrapped = true;
-    }
-    else if (options.wrapping === 'complete') {
-      options.wrapped = false;
-    }
-
-    if (Utils.isNullOrUndefined(options.indicators)) {
-      options.indicators = [];
-    }
-
-    if (Utils.isNullOrUndefined(options.markers)) {
-      options.markers = [];
-    }
-
-    if (Utils.isNullOrUndefined(options.buttons)) {
-      options.buttons = [];
-    }
-    else if (!Array.isArray(options.buttons)) {
-      throw new TypeError('peaks.sources.' + context + ': buttons must be an array');
-    }
-
-    if (Utils.isNullOrUndefined(options.markerColor)
-      || !Utils.isValidColor(options.markerColor)) {
-      options.markerColor = options.color;
-    }
-
-    if (Utils.isNullOrUndefined(options.markerWidth)) {
-      options.markerWidth = 2;
-    }
-
-    if (!Utils.isNullOrUndefined(options.volumeRange)) {
-      if (!Array.isArray(options.volumeRange)
-        || options.volumeRange.length !== 2
-        || !options.volumeRange.every(Utils.isNumber)) {
-        throw new TypeError('peaks.sources.' + context + ': volumeRange must be an array of two numbers');
-      }
-      else if (options.volumeRange[0] > options.volumeRange[1]) {
-        throw new RangeError('peaks.sources.' + context + ': volumeRange[0] should be less than volumeRange[1]');
-      }
-    }
-
-    if (!Utils.isNullOrUndefined(options.volume)) {
-      if (!Utils.isNumber(options.volume)) {
-        throw new TypeError('peaks.sources.' + context + ': volume must be a number');
-      }
-      else {
-        options.volume = Utils.clamp(options.volume, options.volumeRange[0], options.volumeRange[1]);
-      }
-    }
-
-    if (Utils.isNullOrUndefined(options.loading)) {
-      options.loading = false;
-    }
-    else if (!Utils.isBoolean(options.loading)) {
-      throw new TypeError('peaks.sources.' + context + ': loading must be a boolean');
-    }
-  }
-
-  /**
-   * A source is an external media resource, represented on the timeline.
-   *
-   * @class
-   * @alias Source
-   *
-   * @param {Peaks} peaks A reference to the Peaks instance.
-   * @param {String} id A unique identifier for the source.
-   * @param {String} originId The original identifier of the source before any cuts.
-   * @param {String} elementId The HTML element identifier associated with this source.
-   * @param {String} title Name of the source.
-   * @param {Array<Object>} titleAlignments Array of objects with structure:
-   *                        [{text: String, start: Number, end: Number}, ...]
-   * @param {String} url Reference to the media element this source is representing.
-   * @param {String} previewUrl URL for preview media content.
-   * @param {String} binaryUrl URL for binary data associated with the source.
-   * @param {String} kind Type/category of the source.
-   * @param {String} subkind Sub-category of the source.
-   * @param {Number} duration Total duration of the source media, in seconds.
-   * @param {Number} startTime Source start time on the timeline, in seconds.
-   * @param {Number} endTime Source end time on the timeline, in seconds.
-   * @param {Number} mediaStartTime Start time within the source media, in seconds.
-   * @param {Number} mediaEndTime End time within the source media, in seconds.
-   * @param {String} color Primary color of the source representation.
-   * @param {String} backgroundColor Background color of the source.
-   * @param {String} borderColor Border color of the source.
-   * @param {String} selectedColor Color when the source is selected.
-   * @param {String} warningColor Color used for warning states.
-   * @param {String} volumeSliderColor Color of the volume slider.
-   * @param {Number} volumeSliderWidth Width of the volume slider.
-   * @param {Number} volumeSliderDraggingWidth Width of the volume slider when dragging.
-   * @param {String} textFont Font family for text display.
-   * @param {Number} textFontSize Font size for text display.
-   * @param {String} textColor Color of the text.
-   * @param {String} textBackgroundColor Background color of the text.
-   * @param {String} textPosition Position of text relative to the source.
-   * @param {Boolean} textAutoScroll If <code>true</code> text will auto-scroll.
-   * @param {Number} borderWidth Width of the source border.
-   * @param {Number} borderRadius Radius for rounded corners.
-   * @param {Boolean} wrapped If <code>true</code> the source representation will be smaller.
-   * @param {Number} position Position of the source on the timeline. Corresponds to the index of the line.
-   * @param {Boolean} draggable If <code>true</code> the source can be dragged.
-   * @param {Boolean} orderable If <code>true</code> the source can be reordered.
-   * @param {Boolean} resizable If <code>true</code> the source can be resized.
-   * @param {Boolean} cuttable If <code>true</code> the source can be cut.
-   * @param {Boolean} deletable If <code>true</code> the source can be deleted.
-   * @param {String} wrapping Wrapping mode for the source display.
-   * @param {Number} previewHeight Height of the preview area.
-   * @param {Number} binaryHeight Height of the binary data visualization.
-   * @param {Array} indicators Array containing indicator data for the source.
-   * @param {Array} markers Array containing marker data for the source.
-   * @param {Array} buttons Array containing button data for the source.
-   * @param {String} markerColor Color of the markers.
-   * @param {Number} markerWidth Width of the markers.
-   * @param {Number} volume Current volume level of the source.
-   * @param {Array<Number>} volumeRange Array containing min and max volume values.
-   * @param {Boolean} loading If <code>true</code> the source is currently loading.
-   */
-
-  function Source(peaks, id, originId, elementId, title, titleAlignments, url, previewUrl, binaryUrl, kind,
-    subkind, duration, startTime, endTime, mediaStartTime, mediaEndTime, color, backgroundColor,
-    borderColor, selectedColor, warningColor, warningWidth, volumeSliderColor, volumeSliderWidth,
-    volumeSliderDraggingWidth, textFont, textFontSize, textColor, textBackgroundColor, textPosition,
-    textAutoScroll, borderWidth, borderRadius, wrapped, position, draggable, orderable, resizable,
-    cuttable, deletable, wrapping, previewHeight, binaryHeight, indicators, markers, buttons, markerColor,
-    markerWidth, volume, volumeRange, loading, ...customParams) {
-    var opts = {
-      title: title,
-      titleAlignments: titleAlignments,
-      url: url,
-      previewUrl: previewUrl,
-      binaryUrl: binaryUrl,
-      kind: kind,
-      subkind: subkind,
-      duration: duration,
-      startTime: startTime,
-      endTime: endTime,
-      mediaStartTime: mediaStartTime,
-      mediaEndTime: mediaEndTime,
-      color: color,
-      backgroundColor: backgroundColor,
-      borderColor: borderColor,
-      selectedColor: selectedColor,
-      warningColor: warningColor,
-      warningWidth: warningWidth,
-      textFont: textFont,
-      textFontSize: textFontSize,
-      textColor: textColor,
-      textBackgroundColor: textBackgroundColor,
-      volumeSliderColor: volumeSliderColor,
-      volumeSliderWidth: volumeSliderWidth,
-      volumeSliderDraggingWidth: volumeSliderDraggingWidth,
-      textPosition: textPosition,
-      textAutoScroll: textAutoScroll,
-      borderWidth: borderWidth,
-      borderRadius: borderRadius,
-      wrapped: wrapped,
-      position: position,
-      draggable: draggable,
-      orderable: orderable,
-      resizable: resizable,
-      cuttable: cuttable,
-      deletable: deletable,
-      wrapping: wrapping,
-      previewHeight: previewHeight,
-      binaryHeight: binaryHeight,
-      indicators: indicators,
-      markers: markers,
-      buttons: buttons,
-      markerColor: markerColor,
-      markerWidth: markerWidth,
-      volume: volume,
-      volumeRange: volumeRange,
-      loading: loading
-    };
-
-    validateSource(peaks, opts, 'add()');
-
-    this._peaks = peaks;
-    this._id = id;
-    this._originId = originId || id;
-    this._elementId = elementId;
-    this._title = opts.title;
-    this._titleAlignments = opts.titleAlignments;
-    this._url = opts.url;
-    this._previewUrl = opts.previewUrl;
-    this._binaryUrl = opts.binaryUrl;
-    this._kind = opts.kind;
-    this._subkind = opts.subkind;
-    this._duration = opts.duration;
-    this._startTime = opts.startTime;
-    this._endTime = opts.endTime;
-    this._mediaStartTime = opts.mediaStartTime;
-    this._mediaEndTime = opts.mediaEndTime;
-    this._color = opts.color;
-    this._backgroundColor = opts.backgroundColor;
-    this._borderColor = opts.borderColor;
-    this._selectedColor = opts.selectedColor || Utils.shadeColor(opts.backgroundColor, 30);
-    this._warningColor = opts.warningColor;
-    this._warningWidth = opts.warningWidth;
-    this._volumeSliderColor = opts.volumeSliderColor;
-    this._volumeSliderWidth = opts.volumeSliderWidth;
-    this._volumeSliderDraggingWidth = opts.volumeSliderDraggingWidth;
-    this._textFont = opts.textFont;
-    this._textFontSize = opts.textFontSize;
-    this._textColor = opts.textColor;
-    this._textBackgroundColor = opts.textBackgroundColor;
-    this._textPosition = opts.textPosition;
-    this._textAutoScroll = opts.textAutoScroll;
-    this._borderWidth = opts.borderWidth;
-    this._borderRadius = opts.borderRadius;
-    this._wrapped = opts.wrapped;
-    this._position = opts.position;
-    this._draggable = opts.draggable;
-    this._orderable = opts.orderable;
-    this._resizable = opts.resizable;
-    this._cuttable = opts.cuttable;
-    this._deletable = opts.deletable;
-    this._wrapping = opts.wrapping;
-    this._previewHeight = opts.previewHeight;
-    this._binaryHeight = opts.binaryHeight;
-    this._indicators = opts.indicators;
-    this._markers = opts.markers;
-    this._buttons = opts.buttons;
-    this._markerColor = opts.markerColor;
-    this._markerWidth = opts.markerWidth;
-    this._volume = opts.volume;
-    this._volumeRange = opts.volumeRange;
-    this._loading = opts.loading;
-    this._minSize = peaks.options.minSourceSize;
-    this._selected = false;
-
-    for (var i = 0; i < customParams.length; i += 2) {
-      var key = customParams[i];
-      var value = customParams[i + 1];
-
-      if (key && key.startsWith('custom_')) {
-        this[key] = value;
-      }
-    }
-  }
-
-  Object.defineProperties(Source.prototype, {
-    id: {
-      enumerable: true,
-      get: function() {
-        return this._id;
-      }
-    },
-    originId: {
-      enumerable: true,
-      get: function() {
-        return this._originId;
-      }
-    },
-    elementId: {
-      enumerable: true,
-      get: function() {
-        return this._elementId;
-      }
-    },
-    title: {
-      enumerable: true,
-      get: function() {
-        return this._title;
-      },
-
-      set: function(title) {
-        this._title = title;
-      }
-    },
-    titleAlignments: {
-      enumerable: true,
-      get: function() {
-        return this._titleAlignments;
-      }
-    },
-    url: {
-      enumerable: true,
-      get: function() {
-        return this._url;
-      }
-    },
-    previewUrl: {
-      enumerable: true,
-      get: function() {
-        return this._previewUrl;
-      }
-    },
-    binaryUrl: {
-      enumerable: true,
-      get: function() {
-        return this._binaryUrl;
-      }
-    },
-    kind: {
-      enumerable: true,
-      get: function() {
-        return this._kind;
-      },
-
-      set: function(kind) {
-        this._kind = kind;
-      }
-    },
-    subkind: {
-      enumerable: true,
-      get: function() {
-        return this._subkind;
-      },
-
-      set: function(subkind) {
-        this._subkind = subkind;
-      }
-    },
-    duration: {
-      enumerable: true,
-      get: function() {
-        return this._duration;
-      }
-    },
-    startTime: {
-      enumerable: true,
-      get: function() {
-        return this._startTime;
-      }
-    },
-    endTime: {
-      enumerable: true,
-      get: function() {
-        return this._endTime;
-      }
-    },
-    mediaStartTime: {
-      enumerable: true,
-      get: function() {
-        return this._mediaStartTime;
-      },
-
-      set: function(mediaStartTime) {
-        this._mediaStartTime = mediaStartTime;
-      }
-    },
-    mediaEndTime: {
-      enumerable: true,
-      get: function() {
-        return this._mediaEndTime;
-      },
-
-      set: function(mediaEndTime) {
-        this._mediaEndTime = mediaEndTime;
-      }
-    },
-    color: {
-      enumerable: true,
-      get: function() {
-        return this._color;
-      },
-
-      set: function(color) {
-        this._color = color;
-      }
-    },
-    backgroundColor: {
-      enumerable: true,
-      get: function() {
-        return this._backgroundColor;
-      },
-
-      set: function(backgroundColor) {
-        this._backgroundColor = backgroundColor;
-      }
-    },
-    borderColor: {
-      enumerable: true,
-      get: function() {
-        return this._borderColor;
-      },
-
-      set: function(borderColor) {
-        this._borderColor = borderColor;
-      }
-    },
-    selectedColor: {
-      enumerable: true,
-      get: function() {
-        return this._selectedColor;
-      },
-
-      set: function(selectedColor) {
-        this._selectedColor = selectedColor;
-      }
-    },
-    warningColor: {
-      enumerable: true,
-      get: function() {
-        return this._warningColor;
-      },
-
-      set: function(warningColor) {
-        this._warningColor = warningColor;
-      }
-    },
-    warningWidth: {
-      enumerable: true,
-      get: function() {
-        return this._warningWidth;
-      },
-
-      set: function(warningWidth) {
-        this._warningWidth = warningWidth;
-      }
-    },
-    volumeSliderColor: {
-      enumerable: true,
-      get: function() {
-        return this._volumeSliderColor;
-      }
-    },
-    volumeSliderWidth: {
-      enumerable: true,
-      get: function() {
-        return this._volumeSliderWidth;
-      }
-    },
-    volumeSliderDraggingWidth: {
-      enumerable: true,
-      get: function() {
-        return this._volumeSliderDraggingWidth;
-      }
-    },
-    textFont: {
-      enumerable: true,
-      get: function() {
-        return this._textFont;
-      },
-
-      set: function(textFont) {
-        this._textFont = textFont;
-      }
-    },
-    textFontSize: {
-      enumerable: true,
-      get: function() {
-        return this._textFontSize;
-      },
-
-      set: function(textFontSize) {
-        this._textFontSize = textFontSize;
-      }
-    },
-    textColor: {
-      enumerable: true,
-      get: function() {
-        return this._textColor;
-      },
-
-      set: function(textColor) {
-        this._textColor = textColor;
-      }
-    },
-    textBackgroundColor: {
-      enumerable: true,
-      get: function() {
-        return this._textBackgroundColor;
-      },
-
-      set: function(textBackgroundColor) {
-        this._textBackgroundColor = textBackgroundColor;
-      }
-    },
-    textPosition: {
-      enumerable: true,
-      get: function() {
-        return this._textPosition;
-      },
-
-      set: function(textPosition) {
-        this._textPosition = textPosition;
-      }
-    },
-    textAutoScroll: {
-      enumerable: true,
-      get: function() {
-        return this._textAutoScroll;
-      },
-
-      set: function(textAutoScroll) {
-        this._textAutoScroll = textAutoScroll;
-      }
-    },
-    borderWidth: {
-      enumerable: true,
-      get: function() {
-        return this._borderWidth;
-      },
-
-      set: function(borderWidth) {
-        this._borderWidth = borderWidth;
-      }
-    },
-    borderRadius: {
-      enumerable: true,
-      get: function() {
-        return this._borderRadius;
-      },
-
-      set: function(borderRadius) {
-        this._borderRadius = borderRadius;
-      }
-    },
-    wrapped: {
-      enumerable: true,
-      get: function() {
-        return this._wrapped;
-      },
-
-      set: function(wrapped) {
-        this._wrapped = wrapped;
-      }
-    },
-    position: {
-      enumerable: true,
-      get: function() {
-        return this._position;
-      },
-
-      set: function(position) {
-        this._position = position;
-      }
-    },
-    segments: {
-      enumerable: true,
-      get: function() {
-        return this._segments;
-      }
-    },
-    draggable: {
-      enumerable: true,
-      get: function() {
-        return this._draggable;
-      }
-    },
-    orderable: {
-      enumerable: true,
-      get: function() {
-        return this._orderable;
-      }
-    },
-    resizable: {
-      enumerable: true,
-      get: function() {
-        return this._resizable;
-      }
-    },
-    cuttable: {
-      enumerable: true,
-      get: function() {
-        return this._cuttable;
-      }
-    },
-    deletable: {
-      enumerable: true,
-      get: function() {
-        return this._deletable;
-      }
-    },
-    wrapping: {
-      enumerable: true,
-      get: function() {
-        return this._wrapping;
-      },
-
-      set: function(wrapping) {
-        this._wrapping = wrapping;
-      }
-    },
-    previewHeight: {
-      enumerable: true,
-      get: function() {
-        return this._previewHeight;
-      },
-
-      set: function(previewHeight) {
-        this._previewHeight = previewHeight;
-      }
-    },
-    binaryHeight: {
-      enumerable: true,
-      get: function() {
-        return this._binaryHeight;
-      },
-
-      set: function(binaryHeight) {
-        this._binaryHeight = binaryHeight;
-      }
-    },
-    indicators: {
-      enumerable: true,
-      get: function() {
-        return this._indicators;
-      }
-    },
-    markers: {
-      enumerable: true,
-      get: function() {
-        return this._markers;
-      }
-    },
-    buttons: {
-      enumerable: true,
-      get: function() {
-        return this._buttons;
-      }
-    },
-    markerColor: {
-      enumerable: true,
-      get: function() {
-        return this._markerColor;
-      }
-    },
-    markerWidth: {
-      enumerable: true,
-      get: function() {
-        return this._markerWidth;
-      }
-    },
-    volume: {
-      enumerable: true,
-      get: function() {
-        return this._volume;
-      },
-
-      set: function(volume) {
-        this._volume = volume;
-      }
-    },
-    volumeRange: {
-      enumerable: true,
-      get: function() {
-        return this._volumeRange;
-      }
-    },
-    loading: {
-      enumerable: true,
-      get: function() {
-        return this._loading;
-      }
-    },
-    minSize: {
-      enumerable: true,
-      get: function() {
-        return this._minSize;
-      }
-    },
-    selected: {
-      enumerable: true,
-      get: function() {
-        return this._selected;
-      },
-
-      set: function(selected) {
-        this._selected = selected;
-      }
-    }
-  });
-
-  Source.prototype.updateTimes = function(newStartTime, newEndTime) {
-    if (newStartTime !== null) {
-      if (this._duration && newEndTime === null) {
-        newStartTime = Utils.roundTime(Math.max(this._endTime - this._duration, newStartTime));
-      }
-      else {
-        newStartTime = Utils.roundTime(newStartTime);
-      }
-    }
-
-    if (newEndTime !== null) {
-      if (this._duration && newStartTime === null) {
-        newEndTime = Utils.roundTime(Math.min(this._startTime + this._duration, newEndTime));
-      }
-      else {
-        newEndTime = Utils.roundTime(newEndTime);
-      }
-    }
-
-    if ((newStartTime === null && newEndTime !== null)
-        || (newStartTime !== null && newEndTime === null)) {
-      this._updateMediaRange(this._startTime, newStartTime, this._endTime, newEndTime);
-    }
-
-    if (newStartTime !== null) {
-      this._startTime = newStartTime;
-    }
-    if (newEndTime !== null) {
-      this._endTime = newEndTime;
-    }
-  };
-
-  Source.prototype._updateMediaRange = function(oldStartTime, newStartTime, oldEndTime,
-    newEndTime) {
-    var startDiff = 0;
-    var endDiff = 0;
-    var upperLimit;
-
-    if (this._duration) {
-      upperLimit = this._duration;
-    }
-    else {
-      upperLimit = Number.POSITIVE_INFINITY;
-    }
-
-    if (newStartTime !== null && oldStartTime !== null) {
-      startDiff = newStartTime - oldStartTime;
-    }
-    if (newEndTime !== null && oldEndTime !== null) {
-      endDiff = newEndTime - oldEndTime;
-    }
-
-    var newMediaStartTime = this._mediaStartTime;
-    var newMediaEndTime = this._mediaEndTime;
-
-    if (startDiff) {
-      if (startDiff < 0) {
-        // Try reducing mediaStartTime
-        if (newMediaStartTime > 0) {
-          var minStartTime = newMediaStartTime + startDiff;
-
-          newMediaStartTime = Math.max(0, minStartTime);
-          if (minStartTime < 0) {
-            // Try increasing mediaEndTime
-            newMediaEndTime = Math.min(upperLimit, newMediaEndTime - minStartTime);
-          }
-        }
-        else {
-          // Try increasing mediaEndTime
-          newMediaEndTime = Math.min(upperLimit, newMediaEndTime - startDiff);
-        }
-      }
-      else {
-        // Try increasing mediaStartTime
-        if (newMediaStartTime < upperLimit) {
-          newMediaStartTime = Math.min(upperLimit, newMediaStartTime + startDiff);
-        }
-      }
-    }
-
-    if (endDiff) {
-      if (endDiff > 0) {
-        // Try increasing mediaEndTime
-        if (newMediaEndTime < upperLimit) {
-          var maxEndTime = newMediaEndTime + endDiff;
-
-          newMediaEndTime = Math.min(upperLimit, maxEndTime);
-          if (maxEndTime > upperLimit) {
-            // Try reducing mediaStartTime
-            newMediaStartTime = Math.max(0, newMediaStartTime - (maxEndTime - upperLimit));
-          }
-        }
-        else {
-          // Try reducing mediaStartTime
-          newMediaStartTime = Math.max(0, newMediaStartTime - endDiff);
-        }
-      }
-      else {
-        if (newEndTime - oldStartTime < upperLimit) {
-          if (oldEndTime - oldStartTime > upperLimit) {
-            endDiff += (oldEndTime - oldStartTime) - upperLimit;
-          }
-
-          // Try reducing mediaEndTime
-          if (newMediaEndTime > 0) {
-            newMediaEndTime = Math.max(0, newMediaEndTime + endDiff);
-          }
-        }
-      }
-    }
-
-    this._mediaStartTime = Utils.roundTime(newMediaStartTime);
-    this._mediaEndTime = Utils.roundTime(newMediaEndTime);
-  };
-
-  Source.prototype.update = function(options) {
-    var opts = {
-      title: this.title,
-      titleAlignments: this.titleAlignments,
-      url: this.url,
-      previewUrl: this.previewUrl,
-      binaryUrl: this.binaryUrl,
-      kind: this.kind,
-      subkind: this.subkind,
-      duration: this.duration,
-      startTime: this.startTime,
-      endTime: this.endTime,
-      mediaStartTime: this.mediaStartTime,
-      mediaEndTime: this.mediaEndTime,
-      color: this.color,
-      backgroundColor: this.backgroundColor,
-      borderColor: this.borderColor,
-      selectedColor: this.selectedColor,
-      warningColor: this.warningColor,
-      warningWidth: this.warningWidth,
-      volumeSliderColor: this.volumeSliderColor,
-      volumeSliderWidth: this.volumeSliderWidth,
-      volumeSliderDraggingWidth: this.volumeSliderDraggingWidth,
-      textFont: this.textFont,
-      textFontSize: this.textFontSize,
-      textColor: this.textColor,
-      textBackgroundColor: this.textBackgroundColor,
-      textPosition: this.textPosition,
-      textAutoScroll: this.textAutoScroll,
-      borderWidth: this.borderWidth,
-      borderRadius: this.borderRadius,
-      wrapped: this.wrapped,
-      position: this.position,
-      draggable: this.draggable,
-      orderable: this.orderable,
-      resizable: this.resizable,
-      cuttable: this.cuttable,
-      deletable: this.deletable,
-      wrapping: this.wrapping,
-      previewHeight: this.previewHeight,
-      binaryHeight: this.binaryHeight,
-      indicators: this.indicators,
-      markers: this.markers,
-      buttons: this.buttons,
-      markerColor: this.markerColor,
-      markerWidth: this.markerWidth,
-      volume: this.volume,
-      volumeRange: this.volumeRange,
-      loading: this.loading
-    };
-
-    Utils.extend(opts, options);
-
-    validateSource(this._peaks, opts, 'update()');
-
-    this._title = opts.title;
-    this._titleAlignments = opts.titleAlignments;
-    this._url = opts.url;
-    this._previewUrl = opts.previewUrl;
-    this._binaryUrl = opts.binaryUrl;
-    this._kind = opts.kind;
-    this._subkind = opts.subkind;
-    this._duration = opts.duration;
-    this._startTime = opts.startTime;
-    this._endTime = opts.endTime;
-    this._mediaStartTime = opts.mediaStartTime;
-    this._mediaEndTime = opts.mediaEndTime;
-    this._color = opts.color;
-    this._backgroundColor = opts.backgroundColor;
-    this._borderColor = opts.borderColor;
-    this._selectedColor = opts.selectedColor || Utils.shadeColor(opts.backgroundColor, 30);
-    this._warningColor = opts.warningColor;
-    this._warningWidth = opts.warningWidth;
-    this._volumeSliderColor = opts.volumeSliderColor;
-    this._volumeSliderWidth = opts.volumeSliderWidth;
-    this._volumeSliderDraggingWidth = opts.volumeSliderDraggingWidth;
-    this._textFont = opts.textFont;
-    this._textFontSize = opts.textFontSize;
-    this._textColor = opts.textColor;
-    this._textBackgroundColor = opts.textBackgroundColor;
-    this._textPosition = opts.textPosition;
-    this._textAutoScroll = opts.textAutoScroll;
-    this._borderWidth = opts.borderWidth;
-    this._borderRadius = opts.borderRadius;
-    this._wrapped = opts.wrapped;
-    this._position = opts.position;
-    this._draggable = opts.draggable;
-    this._orderable = opts.orderable;
-    this._resizable = opts.resizable;
-    this._cuttable = opts.cuttable;
-    this._deletable = opts.deletable;
-    this._wrapping = opts.wrapping;
-    this._previewHeight = opts.previewHeight;
-    this._binaryHeight = opts.binaryHeight;
-    this._indicators = opts.indicators;
-    this._markers = opts.markers;
-    this._buttons = opts.buttons;
-    this._markerColor = opts.markerColor;
-    this._markerWidth = opts.markerWidth;
-    this._volume = opts.volume;
-    this._volumeRange = opts.volumeRange;
-    this._loading = opts.loading;
-
-    if (options && typeof options === 'object') {
-      for (var key in options) {
-        if (Object.prototype.hasOwnProperty.call(options, key) && key.startsWith('custom_')) {
-          this[key] = options[key];
-        }
-      }
-    }
-
-    this._peaks.emit('source.update', this);
-  };
-
-  /**
-   * Returns <code>true</code> if the source overlaps a given time region.
-   *
-   * @param {Number} startTime The start of the time region, in seconds.
-   * @param {Number} endTime The end of the time region, in seconds.
-   * @returns {Boolean}
-   *
-   * @see http://wiki.c2.com/?TestIfDateRangesOverlap
-   */
-  Source.prototype.isVisible = function(startTime, endTime) {
-    return this._startTime < endTime && startTime < this._endTime;
-  };
-
-  /**
-   * Update the indicators of this source.
-   *
-   * @param {Array<String>} newIndicators The new indicators.
-   */
-
-  Source.prototype.setIndicators = function(newIndicators) {
-    this._indicators = newIndicators;
-    this._peaks.emit('source.setIndicators', this);
-  };
-
-  /**
-   * Returns <code>true</code> if a warning should be shown
-   */
-
-  Source.prototype.shouldShowWarning = function() {
-    return this._warningColor && this._duration > Utils.roundTime(this._endTime - this._startTime);
-  };
-
-  Source.prototype.getVisibleTitle = function() {
-    if (this._titleAlignments.length === 0) {
-      return this._title;
-    }
-
-    return this._titleAlignments.reduce(function(visibleTitle, alignment) {
-      if (this._mediaStartTime < alignment.end && alignment.start < this._mediaEndTime) {
-        visibleTitle.push(alignment.text);
-      }
-      return visibleTitle;
-    }.bind(this), []).join(' ');
-  };
-
-  /**
-   * Returns a serializable object containing only the properties defined with Object.defineProperties.
-   * This includes all enumerable properties that can be safely serialized.
-   *
-   * @returns {Object} A plain object containing the serializable properties of the source.
-   */
-  Source.prototype.toSerializable = function() {
-    var serializable = {};
-
-    // Get all custom properties
-    for (var key in this) {
-      if (Object.prototype.hasOwnProperty.call(this, key) && key.startsWith('custom_')) {
-        serializable[key] = this[key];
-      }
-    }
-
-    // Add all the enumerable properties from the prototype
-    var proto = Object.getPrototypeOf(this);
-    var descriptors = Object.getOwnPropertyDescriptors(proto);
-
-    for (var prop in descriptors) {
-      if (Object.prototype.hasOwnProperty.call(descriptors, prop)) {
-        var descriptor = descriptors[prop];
-
-        if (descriptor.enumerable && descriptor.get && typeof descriptor.get === 'function') {
-          serializable[prop] = this[prop];
-        }
-      }
-    }
-
-    return serializable;
-  };
-
-  return Source;
-});
+/**
+ * @file
+ *
+ * Defines the {@link source} class.
+ *
+ * @module source
+ */
+
+define([
+  '../utils'
+], function(Utils) {
+  'use strict';
+
+  function validateSource(peaks, options, context) {
+    if (!Utils.isValidTime(options.startTime)) {
+      throw new TypeError('peaks.sources.' + context + ': startTime should be a valid number');
+    }
+
+    if (!Utils.isValidTime(options.endTime)) {
+      throw new TypeError('peaks.sources.' + context + ': endTime should be a valid number');
+    }
+
+    if (!Utils.isValidTime(options.duration) || options.duration <= 0) {
+      options.duration = 0;
+    }
+    else if (options.duration < peaks.options.minSourceSize) {
+      options.duration = peaks.options.minSourceSize;
+    }
+
+    options.duration = Utils.roundTime(options.duration);
+
+    if (options.startTime < 0) {
+      throw new RangeError('peaks.sources.' + context + ': startTime should be positive');
+    }
+
+    if (options.endTime < 0) {
+      throw new RangeError('peaks.sources.' + context + ': endTime should be positive');
+    }
+
+    if (options.endTime <= options.startTime) {
+      throw new RangeError(
+        'peaks.sources.' + context + ': endTime should be greater than startTime'
+      );
+    }
+
+    if (options.endTime - options.startTime < peaks.options.minSourceSize) {
+      options.endTime = options.startTime + peaks.options.minSourceSize;
+    }
+
+    if (!Utils.isValidTime(options.mediaStartTime) || options.mediaStartTime < 0) {
+      options.mediaStartTime = 0;
+    }
+
+    if (!Utils.isValidTime(options.mediaEndTime)
+      || (options.mediaEndTime < options.mediaStartTime)
+      || (options.mediaEndTime - options.mediaStartTime !== options.endTime - options.startTime)) {
+      options.mediaEndTime = options.mediaStartTime + (options.endTime - options.startTime);
+    }
+
+    if (options.duration && options.mediaEndTime > options.duration) {
+      var timeWidth = options.mediaEndTime - options.mediaStartTime;
+
+      options.mediaEndTime = options.duration;
+      if (options.duration > timeWidth) {
+        options.mediaStartTime = options.mediaEndTime - timeWidth;
+        options.endTime = options.startTime + timeWidth;
+      }
+      else {
+        options.mediaStartTime = 0;
+        options.endTime = options.startTime + options.duration;
+      }
+    }
+
+    options.startTime = Utils.roundTime(options.startTime);
+    options.endTime = Utils.roundTime(options.endTime);
+    options.mediaStartTime = Utils.roundTime(options.mediaStartTime);
+    options.mediaEndTime = Utils.roundTime(options.mediaEndTime);
+
+    if (Utils.isNullOrUndefined(options.title)) {
+      options.title = '';
+    }
+    else if (!Utils.isString(options.title)) {
+      throw new TypeError('peaks.sources.' + context + ': title must be a string');
+    }
+
+    if (Utils.isNullOrUndefined(options.titleAlignments)) {
+      options.titleAlignments = [];
+    }
+    else if (!Array.isArray(options.titleAlignments)) {
+      throw new TypeError('peaks.sources.' + context + ': titleAlignments must be an array');
+    }
+
+    if (Utils.isNullOrUndefined(options.url)) {
+      options.url = '';
+    }
+    else if (!Utils.isString(options.url)) {
+      throw new TypeError('peaks.sources.' + context + ': url must be a string');
+    }
+
+    if (Utils.isNullOrUndefined(options.previewUrl)) {
+      options.previewUrl = '';
+    }
+    else if (!Utils.isString(options.previewUrl)) {
+      throw new TypeError('peaks.sources.' + context + ': previewUrl must be a string');
+    }
+
+    if (Utils.isNullOrUndefined(options.binaryUrl)) {
+      options.binaryUrl = '';
+    }
+    else if (!Utils.isString(options.binaryUrl)) {
+      throw new TypeError('peaks.sources.' + context + ': binaryUrl must be a string');
+    }
+
+    if (!Utils.isValidColor(options.color)) {
+      options.color = peaks.options.zoomWaveformColor;
+    }
+
+    if (!Utils.isValidColor(options.backgroundColor)) {
+      throw new TypeError(
+        'peaks.sources.' + context + ': backgroundColor should be a valid CSS color'
+      );
+    }
+
+    if (!Utils.isValidColor(options.borderColor)) {
+      options.borderColor = options.color;
+    }
+
+    if (Utils.isNullOrUndefined(options.selectedColor)) {
+      options.selectedColor = null;
+    }
+    else if (!Utils.isValidColor(options.selectedColor)) {
+      throw new TypeError(
+        'peaks.sources.' + context + ': selectedColor should be a valid CSS color'
+      );
+    }
+
+    if (Utils.isNullOrUndefined(options.warningColor)) {
+      options.warningColor = null;
+    }
+    else if (!Utils.isValidColor(options.warningColor)) {
+      throw new TypeError(
+        'peaks.sources.' + context + ': warningColor should be a valid CSS color'
+      );
+    }
+
+    if (Utils.isNullOrUndefined(options.warningWidth)) {
+      options.warningWidth = 10;
+    }
+    else if (!Utils.isNumber(options.warningWidth)) {
+      throw new TypeError('peaks.sources.' + context + ': warningWidth should be a number');
+    }
+
+    if (Utils.isNullOrUndefined(options.volumeSliderColor)) {
+      options.volumeSliderColor = '#000000';
+    }
+    else if (!Utils.isValidColor(options.volumeSliderColor)) {
+      throw new TypeError(
+        'peaks.sources.' + context + ': volumeSliderColor should be a valid CSS color'
+      );
+    }
+
+    if (Utils.isNullOrUndefined(options.volumeSliderWidth)) {
+      options.volumeSliderWidth = 2;
+    }
+    else if (!Utils.isNumber(options.volumeSliderWidth)) {
+      throw new TypeError('peaks.sources.' + context + ': volumeSliderWidth should be a number');
+    }
+
+    if (Utils.isNullOrUndefined(options.volumeSliderDraggingWidth)) {
+      options.volumeSliderDraggingWidth = options.volumeSliderWidth;
+    }
+    else if (!Utils.isNumber(options.volumeSliderDraggingWidth)) {
+      throw new TypeError(
+        'peaks.sources.' + context + ': volumeSliderDraggingWidth should be a number'
+      );
+    }
+
+    if (Utils.isNullOrUndefined(options.textFont)) {
+      options.textFont = 'Arial';
+    }
+
+    if (Utils.isNullOrUndefined(options.textFontSize)) {
+      options.textFontSize = 12;
+    }
+
+    if (Utils.isNullOrUndefined(options.textColor)) {
+      options.textColor = '#000000';
+    }
+    else if (!Utils.isValidColor(options.textColor)) {
+      throw new TypeError('peaks.sources.' + context + ': textColor should be a valid CSS color');
+    }
+
+    if (!Utils.isNullOrUndefined(options.textBackgroundColor)
+      && !Utils.isValidColor(options.textBackgroundColor)) {
+      throw new TypeError(
+        'peaks.sources.' + context + ': textBackgroundColor should be a valid CSS color'
+      );
+    }
+
+    if (Utils.isNullOrUndefined(options.textPosition)) {
+      options.textPosition = 'bottom';
+    }
+    else if (!Utils.isString(options.textPosition)) {
+      throw new TypeError('peaks.sources.' + context + ': textPosition must be a string');
+    }
+
+    if (Utils.isNullOrUndefined(options.textAutoScroll)) {
+      options.textAutoScroll = false;
+    }
+
+    if (Utils.isNullOrUndefined(options.borderWidth)) {
+      options.borderWidth = 0;
+    }
+
+    if (Utils.isNullOrUndefined(options.wrapped)) {
+      options.wrapped = false;
+    }
+    else if (!Utils.isBoolean(options.wrapped)) {
+      throw new TypeError('peaks.sources.' + context + ': wrapped must be a boolean');
+    }
+
+    if (Utils.isNullOrUndefined(options.draggable)) {
+      options.draggable = true;
+    }
+    else if (!Utils.isBoolean(options.draggable)) {
+      throw new TypeError('peaks.sources.' + context + ': draggable must be a boolean');
+    }
+
+    if (Utils.isNullOrUndefined(options.orderable)) {
+      options.orderable = true;
+    }
+    else if (!Utils.isBoolean(options.orderable)) {
+      throw new TypeError('peaks.sources.' + context + ': orderable must be a boolean');
+    }
+
+    if (Utils.isNullOrUndefined(options.resizable)) {
+      options.resizable = true;
+    }
+    else if (!Utils.isBoolean(options.resizable)) {
+      throw new TypeError('peaks.sources.' + context + ': resizable must be a boolean');
+    }
+
+    if (Utils.isNullOrUndefined(options.cuttable)) {
+      options.cuttable = true;
+    }
+    else if (!Utils.isBoolean(options.cuttable)) {
+      throw new TypeError('peaks.sources.' + context + ': cuttable must be a boolean');
+    }
+
+    if (Utils.isNullOrUndefined(options.deletable)) {
+      options.deletable = true;
+    }
+    else if (!Utils.isBoolean(options.deletable)) {
+      throw new TypeError('peaks.sources.' + context + ': deletable must be a boolean');
+    }
+
+    if (Utils.isNullOrUndefined(options.wrapping)) {
+      options.wrapping = 'both';
+    }
+    else if (!Utils.isString(options.wrapping)) {
+      throw new TypeError('peaks.sources.' + context + ': wrapping must be a string');
+    }
+
+    if (Utils.isNullOrUndefined(options.previewHeight)) {
+      options.previewHeight = 0;
+    }
+    else if (!Utils.isNumber(options.previewHeight)) {
+      throw new TypeError('peaks.sources.' + context + ': previewHeight must be a number');
+    }
+
+    if (Utils.isNullOrUndefined(options.binaryHeight)) {
+      options.binaryHeight = 0;
+    }
+    else if (!Utils.isNumber(options.binaryHeight)) {
+      throw new TypeError('peaks.sources.' + context + ': binaryHeight must be a number');
+    }
+
+    if (options.previewUrl && !options.previewHeight) {
+      if (options.binaryHeight) {
+        options.previewHeight = Math.max(peaks.options.lineHeight - options.binaryHeight, 0);
+      }
+      else {
+        options.previewHeight = peaks.options.lineHeight / 2;
+      }
+    }
+
+    if (options.binaryUrl && !options.binaryHeight) {
+      options.binaryHeight = Math.max(peaks.options.lineHeight - options.previewHeight, 0);
+    }
+
+    if (options.wrapping === 'reduced') {
+      options.wrapped = true;
+    }
+    else if (options.wrapping === 'complete') {
+      options.wrapped = false;
+    }
+
+    if (Utils.isNullOrUndefined(options.indicators)) {
+      options.indicators = [];
+    }
+
+    if (Utils.isNullOrUndefined(options.markers)) {
+      options.markers = [];
+    }
+
+    if (Utils.isNullOrUndefined(options.buttons)) {
+      options.buttons = [];
+    }
+    else if (!Array.isArray(options.buttons)) {
+      throw new TypeError('peaks.sources.' + context + ': buttons must be an array');
+    }
+
+    if (Utils.isNullOrUndefined(options.markerColor)
+      || !Utils.isValidColor(options.markerColor)) {
+      options.markerColor = options.color;
+    }
+
+    if (Utils.isNullOrUndefined(options.markerWidth)) {
+      options.markerWidth = 2;
+    }
+
+    if (!Utils.isNullOrUndefined(options.volumeRange)) {
+      if (!Array.isArray(options.volumeRange)
+        || options.volumeRange.length !== 2
+        || !options.volumeRange.every(Utils.isNumber)) {
+        throw new TypeError('peaks.sources.' + context + ': volumeRange must be an array of two numbers');
+      }
+      else if (options.volumeRange[0] > options.volumeRange[1]) {
+        throw new RangeError('peaks.sources.' + context + ': volumeRange[0] should be less than volumeRange[1]');
+      }
+    }
+
+    if (!Utils.isNullOrUndefined(options.volume)) {
+      if (!Utils.isNumber(options.volume)) {
+        throw new TypeError('peaks.sources.' + context + ': volume must be a number');
+      }
+      else {
+        options.volume = Utils.clamp(options.volume, options.volumeRange[0], options.volumeRange[1]);
+      }
+    }
+
+    if (Utils.isNullOrUndefined(options.loading)) {
+      options.loading = false;
+    }
+    else if (!Utils.isBoolean(options.loading)) {
+      throw new TypeError('peaks.sources.' + context + ': loading must be a boolean');
+    }
+  }
+
+  /**
+   * A source is an external media resource, represented on the timeline.
+   *
+   * @class
+   * @alias Source
+   *
+   * @param {Peaks} peaks A reference to the Peaks instance.
+   * @param {String} id A unique identifier for the source.
+   * @param {String} lineId The identifier of the line this source belongs to.
+   * @param {String} originId The original identifier of the source before any cuts.
+   * @param {String} elementId The HTML element identifier associated with this source.
+   * @param {String} title Name of the source.
+   * @param {Array<Object>} titleAlignments Array of objects with structure:
+   *                        [{text: String, start: Number, end: Number}, ...]
+   * @param {String} url Reference to the media element this source is representing.
+   * @param {String} previewUrl URL for preview media content.
+   * @param {String} binaryUrl URL for binary data associated with the source.
+   * @param {String} kind Type/category of the source.
+   * @param {String} subkind Sub-category of the source.
+   * @param {Number} duration Total duration of the source media, in seconds.
+   * @param {Number} startTime Source start time on the timeline, in seconds.
+   * @param {Number} endTime Source end time on the timeline, in seconds.
+   * @param {Number} mediaStartTime Start time within the source media, in seconds.
+   * @param {Number} mediaEndTime End time within the source media, in seconds.
+   * @param {String} color Primary color of the source representation.
+   * @param {String} backgroundColor Background color of the source.
+   * @param {String} borderColor Border color of the source.
+   * @param {String} selectedColor Color when the source is selected.
+   * @param {String} warningColor Color used for warning states.
+   * @param {String} volumeSliderColor Color of the volume slider.
+   * @param {Number} volumeSliderWidth Width of the volume slider.
+   * @param {Number} volumeSliderDraggingWidth Width of the volume slider when dragging.
+   * @param {String} textFont Font family for text display.
+   * @param {Number} textFontSize Font size for text display.
+   * @param {String} textColor Color of the text.
+   * @param {String} textBackgroundColor Background color of the text.
+   * @param {String} textPosition Position of text relative to the source.
+   * @param {Boolean} textAutoScroll If <code>true</code> text will auto-scroll.
+   * @param {Number} borderWidth Width of the source border.
+   * @param {Number} borderRadius Radius for rounded corners.
+   * @param {Boolean} wrapped If <code>true</code> the source representation will be smaller.
+   * @param {Boolean} draggable If <code>true</code> the source can be dragged.
+   * @param {Boolean} orderable If <code>true</code> the source can be reordered.
+   * @param {Boolean} resizable If <code>true</code> the source can be resized.
+   * @param {Boolean} cuttable If <code>true</code> the source can be cut.
+   * @param {Boolean} deletable If <code>true</code> the source can be deleted.
+   * @param {String} wrapping Wrapping mode for the source display.
+   * @param {Number} previewHeight Height of the preview area.
+   * @param {Number} binaryHeight Height of the binary data visualization.
+   * @param {Array} indicators Array containing indicator data for the source.
+   * @param {Array} markers Array containing marker data for the source.
+   * @param {Array} buttons Array containing button data for the source.
+   * @param {String} markerColor Color of the markers.
+   * @param {Number} markerWidth Width of the markers.
+   * @param {Number} volume Current volume level of the source.
+   * @param {Array<Number>} volumeRange Array containing min and max volume values.
+   * @param {Boolean} loading If <code>true</code> the source is currently loading.
+   */
+
+  function Source(peaks, id, lineId, originId, elementId, title, titleAlignments, url, previewUrl, binaryUrl, kind,
+    subkind, duration, startTime, endTime, mediaStartTime, mediaEndTime, color, backgroundColor,
+    borderColor, selectedColor, warningColor, warningWidth, volumeSliderColor, volumeSliderWidth,
+    volumeSliderDraggingWidth, textFont, textFontSize, textColor, textBackgroundColor, textPosition,
+    textAutoScroll, borderWidth, borderRadius, wrapped, draggable, orderable, resizable,
+    cuttable, deletable, wrapping, previewHeight, binaryHeight, indicators, markers, buttons, markerColor,
+    markerWidth, volume, volumeRange, loading, ...customParams) {
+    var opts = {
+      title: title,
+      titleAlignments: titleAlignments,
+      url: url,
+      previewUrl: previewUrl,
+      binaryUrl: binaryUrl,
+      kind: kind,
+      subkind: subkind,
+      duration: duration,
+      startTime: startTime,
+      endTime: endTime,
+      mediaStartTime: mediaStartTime,
+      mediaEndTime: mediaEndTime,
+      color: color,
+      backgroundColor: backgroundColor,
+      borderColor: borderColor,
+      selectedColor: selectedColor,
+      warningColor: warningColor,
+      warningWidth: warningWidth,
+      textFont: textFont,
+      textFontSize: textFontSize,
+      textColor: textColor,
+      textBackgroundColor: textBackgroundColor,
+      volumeSliderColor: volumeSliderColor,
+      volumeSliderWidth: volumeSliderWidth,
+      volumeSliderDraggingWidth: volumeSliderDraggingWidth,
+      textPosition: textPosition,
+      textAutoScroll: textAutoScroll,
+      borderWidth: borderWidth,
+      borderRadius: borderRadius,
+      wrapped: wrapped,
+      draggable: draggable,
+      orderable: orderable,
+      resizable: resizable,
+      cuttable: cuttable,
+      deletable: deletable,
+      wrapping: wrapping,
+      previewHeight: previewHeight,
+      binaryHeight: binaryHeight,
+      indicators: indicators,
+      markers: markers,
+      buttons: buttons,
+      markerColor: markerColor,
+      markerWidth: markerWidth,
+      volume: volume,
+      volumeRange: volumeRange,
+      loading: loading
+    };
+
+    validateSource(peaks, opts, 'add()');
+
+    this._peaks = peaks;
+    this._id = id;
+    this._lineId = lineId;
+    this._originId = originId || id;
+    this._elementId = elementId;
+    this._title = opts.title;
+    this._titleAlignments = opts.titleAlignments;
+    this._url = opts.url;
+    this._previewUrl = opts.previewUrl;
+    this._binaryUrl = opts.binaryUrl;
+    this._kind = opts.kind;
+    this._subkind = opts.subkind;
+    this._duration = opts.duration;
+    this._startTime = opts.startTime;
+    this._endTime = opts.endTime;
+    this._mediaStartTime = opts.mediaStartTime;
+    this._mediaEndTime = opts.mediaEndTime;
+    this._color = opts.color;
+    this._backgroundColor = opts.backgroundColor;
+    this._borderColor = opts.borderColor;
+    this._selectedColor = opts.selectedColor || Utils.shadeColor(opts.backgroundColor, 30);
+    this._warningColor = opts.warningColor;
+    this._warningWidth = opts.warningWidth;
+    this._volumeSliderColor = opts.volumeSliderColor;
+    this._volumeSliderWidth = opts.volumeSliderWidth;
+    this._volumeSliderDraggingWidth = opts.volumeSliderDraggingWidth;
+    this._textFont = opts.textFont;
+    this._textFontSize = opts.textFontSize;
+    this._textColor = opts.textColor;
+    this._textBackgroundColor = opts.textBackgroundColor;
+    this._textPosition = opts.textPosition;
+    this._textAutoScroll = opts.textAutoScroll;
+    this._borderWidth = opts.borderWidth;
+    this._borderRadius = opts.borderRadius;
+    this._wrapped = opts.wrapped;
+    this._draggable = opts.draggable;
+    this._orderable = opts.orderable;
+    this._resizable = opts.resizable;
+    this._cuttable = opts.cuttable;
+    this._deletable = opts.deletable;
+    this._wrapping = opts.wrapping;
+    this._previewHeight = opts.previewHeight;
+    this._binaryHeight = opts.binaryHeight;
+    this._indicators = opts.indicators;
+    this._markers = opts.markers;
+    this._buttons = opts.buttons;
+    this._markerColor = opts.markerColor;
+    this._markerWidth = opts.markerWidth;
+    this._volume = opts.volume;
+    this._volumeRange = opts.volumeRange;
+    this._loading = opts.loading;
+    this._minSize = peaks.options.minSourceSize;
+    this._selected = false;
+
+    for (var i = 0; i < customParams.length; i += 2) {
+      var key = customParams[i];
+      var value = customParams[i + 1];
+
+      if (key && key.startsWith('custom_')) {
+        this[key] = value;
+      }
+    }
+  }
+
+  Object.defineProperties(Source.prototype, {
+    id: {
+      enumerable: true,
+      get: function() {
+        return this._id;
+      }
+    },
+    lineId: {
+      enumerable: true,
+      get: function() {
+        return this._lineId;
+      },
+
+      set: function(lineId) {
+        this._lineId = lineId;
+      }
+    },
+    originId: {
+      enumerable: true,
+      get: function() {
+        return this._originId;
+      }
+    },
+    elementId: {
+      enumerable: true,
+      get: function() {
+        return this._elementId;
+      }
+    },
+    title: {
+      enumerable: true,
+      get: function() {
+        return this._title;
+      },
+
+      set: function(title) {
+        this._title = title;
+      }
+    },
+    titleAlignments: {
+      enumerable: true,
+      get: function() {
+        return this._titleAlignments;
+      }
+    },
+    url: {
+      enumerable: true,
+      get: function() {
+        return this._url;
+      }
+    },
+    previewUrl: {
+      enumerable: true,
+      get: function() {
+        return this._previewUrl;
+      }
+    },
+    binaryUrl: {
+      enumerable: true,
+      get: function() {
+        return this._binaryUrl;
+      }
+    },
+    kind: {
+      enumerable: true,
+      get: function() {
+        return this._kind;
+      },
+
+      set: function(kind) {
+        this._kind = kind;
+      }
+    },
+    subkind: {
+      enumerable: true,
+      get: function() {
+        return this._subkind;
+      },
+
+      set: function(subkind) {
+        this._subkind = subkind;
+      }
+    },
+    duration: {
+      enumerable: true,
+      get: function() {
+        return this._duration;
+      }
+    },
+    startTime: {
+      enumerable: true,
+      get: function() {
+        return this._startTime;
+      }
+    },
+    endTime: {
+      enumerable: true,
+      get: function() {
+        return this._endTime;
+      }
+    },
+    mediaStartTime: {
+      enumerable: true,
+      get: function() {
+        return this._mediaStartTime;
+      },
+
+      set: function(mediaStartTime) {
+        this._mediaStartTime = mediaStartTime;
+      }
+    },
+    mediaEndTime: {
+      enumerable: true,
+      get: function() {
+        return this._mediaEndTime;
+      },
+
+      set: function(mediaEndTime) {
+        this._mediaEndTime = mediaEndTime;
+      }
+    },
+    color: {
+      enumerable: true,
+      get: function() {
+        return this._color;
+      },
+
+      set: function(color) {
+        this._color = color;
+      }
+    },
+    backgroundColor: {
+      enumerable: true,
+      get: function() {
+        return this._backgroundColor;
+      },
+
+      set: function(backgroundColor) {
+        this._backgroundColor = backgroundColor;
+      }
+    },
+    borderColor: {
+      enumerable: true,
+      get: function() {
+        return this._borderColor;
+      },
+
+      set: function(borderColor) {
+        this._borderColor = borderColor;
+      }
+    },
+    selectedColor: {
+      enumerable: true,
+      get: function() {
+        return this._selectedColor;
+      },
+
+      set: function(selectedColor) {
+        this._selectedColor = selectedColor;
+      }
+    },
+    warningColor: {
+      enumerable: true,
+      get: function() {
+        return this._warningColor;
+      },
+
+      set: function(warningColor) {
+        this._warningColor = warningColor;
+      }
+    },
+    warningWidth: {
+      enumerable: true,
+      get: function() {
+        return this._warningWidth;
+      },
+
+      set: function(warningWidth) {
+        this._warningWidth = warningWidth;
+      }
+    },
+    volumeSliderColor: {
+      enumerable: true,
+      get: function() {
+        return this._volumeSliderColor;
+      }
+    },
+    volumeSliderWidth: {
+      enumerable: true,
+      get: function() {
+        return this._volumeSliderWidth;
+      }
+    },
+    volumeSliderDraggingWidth: {
+      enumerable: true,
+      get: function() {
+        return this._volumeSliderDraggingWidth;
+      }
+    },
+    textFont: {
+      enumerable: true,
+      get: function() {
+        return this._textFont;
+      },
+
+      set: function(textFont) {
+        this._textFont = textFont;
+      }
+    },
+    textFontSize: {
+      enumerable: true,
+      get: function() {
+        return this._textFontSize;
+      },
+
+      set: function(textFontSize) {
+        this._textFontSize = textFontSize;
+      }
+    },
+    textColor: {
+      enumerable: true,
+      get: function() {
+        return this._textColor;
+      },
+
+      set: function(textColor) {
+        this._textColor = textColor;
+      }
+    },
+    textBackgroundColor: {
+      enumerable: true,
+      get: function() {
+        return this._textBackgroundColor;
+      },
+
+      set: function(textBackgroundColor) {
+        this._textBackgroundColor = textBackgroundColor;
+      }
+    },
+    textPosition: {
+      enumerable: true,
+      get: function() {
+        return this._textPosition;
+      },
+
+      set: function(textPosition) {
+        this._textPosition = textPosition;
+      }
+    },
+    textAutoScroll: {
+      enumerable: true,
+      get: function() {
+        return this._textAutoScroll;
+      },
+
+      set: function(textAutoScroll) {
+        this._textAutoScroll = textAutoScroll;
+      }
+    },
+    borderWidth: {
+      enumerable: true,
+      get: function() {
+        return this._borderWidth;
+      },
+
+      set: function(borderWidth) {
+        this._borderWidth = borderWidth;
+      }
+    },
+    borderRadius: {
+      enumerable: true,
+      get: function() {
+        return this._borderRadius;
+      },
+
+      set: function(borderRadius) {
+        this._borderRadius = borderRadius;
+      }
+    },
+    wrapped: {
+      enumerable: true,
+      get: function() {
+        return this._wrapped;
+      },
+
+      set: function(wrapped) {
+        this._wrapped = wrapped;
+      }
+    },
+    segments: {
+      enumerable: true,
+      get: function() {
+        return this._segments;
+      }
+    },
+    draggable: {
+      enumerable: true,
+      get: function() {
+        return this._draggable;
+      }
+    },
+    orderable: {
+      enumerable: true,
+      get: function() {
+        return this._orderable;
+      }
+    },
+    resizable: {
+      enumerable: true,
+      get: function() {
+        return this._resizable;
+      }
+    },
+    cuttable: {
+      enumerable: true,
+      get: function() {
+        return this._cuttable;
+      }
+    },
+    deletable: {
+      enumerable: true,
+      get: function() {
+        return this._deletable;
+      }
+    },
+    wrapping: {
+      enumerable: true,
+      get: function() {
+        return this._wrapping;
+      },
+
+      set: function(wrapping) {
+        this._wrapping = wrapping;
+      }
+    },
+    previewHeight: {
+      enumerable: true,
+      get: function() {
+        return this._previewHeight;
+      },
+
+      set: function(previewHeight) {
+        this._previewHeight = previewHeight;
+      }
+    },
+    binaryHeight: {
+      enumerable: true,
+      get: function() {
+        return this._binaryHeight;
+      },
+
+      set: function(binaryHeight) {
+        this._binaryHeight = binaryHeight;
+      }
+    },
+    indicators: {
+      enumerable: true,
+      get: function() {
+        return this._indicators;
+      }
+    },
+    markers: {
+      enumerable: true,
+      get: function() {
+        return this._markers;
+      }
+    },
+    buttons: {
+      enumerable: true,
+      get: function() {
+        return this._buttons;
+      }
+    },
+    markerColor: {
+      enumerable: true,
+      get: function() {
+        return this._markerColor;
+      }
+    },
+    markerWidth: {
+      enumerable: true,
+      get: function() {
+        return this._markerWidth;
+      }
+    },
+    volume: {
+      enumerable: true,
+      get: function() {
+        return this._volume;
+      },
+
+      set: function(volume) {
+        this._volume = volume;
+      }
+    },
+    volumeRange: {
+      enumerable: true,
+      get: function() {
+        return this._volumeRange;
+      }
+    },
+    loading: {
+      enumerable: true,
+      get: function() {
+        return this._loading;
+      }
+    },
+    minSize: {
+      enumerable: true,
+      get: function() {
+        return this._minSize;
+      }
+    },
+    selected: {
+      enumerable: true,
+      get: function() {
+        return this._selected;
+      },
+
+      set: function(selected) {
+        this._selected = selected;
+      }
+    }
+  });
+
+  Source.prototype.updateTimes = function(newStartTime, newEndTime) {
+    if (!Utils.isNullOrUndefined(newStartTime)) {
+      if (this._duration && Utils.isNullOrUndefined(newEndTime)) {
+        newStartTime = Utils.roundTime(Math.max(this._endTime - this._duration, newStartTime));
+      }
+      else {
+        newStartTime = Utils.roundTime(newStartTime);
+      }
+    }
+
+    if (!Utils.isNullOrUndefined(newEndTime)) {
+      if (this._duration && Utils.isNullOrUndefined(newStartTime)) {
+        newEndTime = Utils.roundTime(Math.min(this._startTime + this._duration, newEndTime));
+      }
+      else {
+        newEndTime = Utils.roundTime(newEndTime);
+      }
+    }
+
+    if ((Utils.isNullOrUndefined(newStartTime) && !Utils.isNullOrUndefined(newEndTime))
+        || (!Utils.isNullOrUndefined(newStartTime) && Utils.isNullOrUndefined(newEndTime))) {
+      this._updateMediaRange(this._startTime, newStartTime, this._endTime, newEndTime);
+    }
+
+    if (!Utils.isNullOrUndefined(newStartTime)) {
+      this._startTime = newStartTime;
+    }
+    if (!Utils.isNullOrUndefined(newEndTime)) {
+      this._endTime = newEndTime;
+    }
+  };
+
+  Source.prototype._updateMediaRange = function(oldStartTime, newStartTime, oldEndTime,
+    newEndTime) {
+    var startDiff = 0;
+    var endDiff = 0;
+    var upperLimit;
+
+    if (this._duration) {
+      upperLimit = this._duration;
+    }
+    else {
+      upperLimit = Number.POSITIVE_INFINITY;
+    }
+
+    if (!Utils.isNullOrUndefined(newStartTime) && !Utils.isNullOrUndefined(oldStartTime)) {
+      startDiff = newStartTime - oldStartTime;
+    }
+    if (!Utils.isNullOrUndefined(newEndTime) && !Utils.isNullOrUndefined(oldEndTime)) {
+      endDiff = newEndTime - oldEndTime;
+    }
+
+    var newMediaStartTime = this._mediaStartTime;
+    var newMediaEndTime = this._mediaEndTime;
+
+    if (startDiff) {
+      if (startDiff < 0) {
+        // Try reducing mediaStartTime
+        if (newMediaStartTime > 0) {
+          var minStartTime = newMediaStartTime + startDiff;
+
+          newMediaStartTime = Math.max(0, minStartTime);
+          if (minStartTime < 0) {
+            // Try increasing mediaEndTime
+            newMediaEndTime = Math.min(upperLimit, newMediaEndTime - minStartTime);
+          }
+        }
+        else {
+          // Try increasing mediaEndTime
+          newMediaEndTime = Math.min(upperLimit, newMediaEndTime - startDiff);
+        }
+      }
+      else {
+        // Try increasing mediaStartTime
+        if (newMediaStartTime < upperLimit) {
+          newMediaStartTime = Math.min(upperLimit, newMediaStartTime + startDiff);
+        }
+      }
+    }
+
+    if (endDiff) {
+      if (endDiff > 0) {
+        // Try increasing mediaEndTime
+        if (newMediaEndTime < upperLimit) {
+          var maxEndTime = newMediaEndTime + endDiff;
+
+          newMediaEndTime = Math.min(upperLimit, maxEndTime);
+          if (maxEndTime > upperLimit) {
+            // Try reducing mediaStartTime
+            newMediaStartTime = Math.max(0, newMediaStartTime - (maxEndTime - upperLimit));
+          }
+        }
+        else {
+          // Try reducing mediaStartTime
+          newMediaStartTime = Math.max(0, newMediaStartTime - endDiff);
+        }
+      }
+      else {
+        if (newEndTime - oldStartTime < upperLimit) {
+          if (oldEndTime - oldStartTime > upperLimit) {
+            endDiff += (oldEndTime - oldStartTime) - upperLimit;
+          }
+
+          // Try reducing mediaEndTime
+          if (newMediaEndTime > 0) {
+            newMediaEndTime = Math.max(0, newMediaEndTime + endDiff);
+          }
+        }
+      }
+    }
+
+    this._mediaStartTime = Utils.roundTime(newMediaStartTime);
+    this._mediaEndTime = Utils.roundTime(newMediaEndTime);
+  };
+
+  Source.prototype.update = function(options) {
+    var opts = {
+      title: this.title,
+      titleAlignments: this.titleAlignments,
+      url: this.url,
+      previewUrl: this.previewUrl,
+      binaryUrl: this.binaryUrl,
+      kind: this.kind,
+      subkind: this.subkind,
+      duration: this.duration,
+      startTime: this.startTime,
+      endTime: this.endTime,
+      mediaStartTime: this.mediaStartTime,
+      mediaEndTime: this.mediaEndTime,
+      color: this.color,
+      backgroundColor: this.backgroundColor,
+      borderColor: this.borderColor,
+      selectedColor: this.selectedColor,
+      warningColor: this.warningColor,
+      warningWidth: this.warningWidth,
+      volumeSliderColor: this.volumeSliderColor,
+      volumeSliderWidth: this.volumeSliderWidth,
+      volumeSliderDraggingWidth: this.volumeSliderDraggingWidth,
+      textFont: this.textFont,
+      textFontSize: this.textFontSize,
+      textColor: this.textColor,
+      textBackgroundColor: this.textBackgroundColor,
+      textPosition: this.textPosition,
+      textAutoScroll: this.textAutoScroll,
+      borderWidth: this.borderWidth,
+      borderRadius: this.borderRadius,
+      wrapped: this.wrapped,
+      draggable: this.draggable,
+      orderable: this.orderable,
+      resizable: this.resizable,
+      cuttable: this.cuttable,
+      deletable: this.deletable,
+      wrapping: this.wrapping,
+      previewHeight: this.previewHeight,
+      binaryHeight: this.binaryHeight,
+      indicators: this.indicators,
+      markers: this.markers,
+      buttons: this.buttons,
+      markerColor: this.markerColor,
+      markerWidth: this.markerWidth,
+      volume: this.volume,
+      volumeRange: this.volumeRange,
+      loading: this.loading
+    };
+
+    Utils.extend(opts, options);
+
+    validateSource(this._peaks, opts, 'update()');
+
+    this._title = opts.title;
+    this._titleAlignments = opts.titleAlignments;
+    this._url = opts.url;
+    this._previewUrl = opts.previewUrl;
+    this._binaryUrl = opts.binaryUrl;
+    this._kind = opts.kind;
+    this._subkind = opts.subkind;
+    this._duration = opts.duration;
+    this._startTime = opts.startTime;
+    this._endTime = opts.endTime;
+    this._mediaStartTime = opts.mediaStartTime;
+    this._mediaEndTime = opts.mediaEndTime;
+    this._color = opts.color;
+    this._backgroundColor = opts.backgroundColor;
+    this._borderColor = opts.borderColor;
+    this._selectedColor = opts.selectedColor || Utils.shadeColor(opts.backgroundColor, 30);
+    this._warningColor = opts.warningColor;
+    this._warningWidth = opts.warningWidth;
+    this._volumeSliderColor = opts.volumeSliderColor;
+    this._volumeSliderWidth = opts.volumeSliderWidth;
+    this._volumeSliderDraggingWidth = opts.volumeSliderDraggingWidth;
+    this._textFont = opts.textFont;
+    this._textFontSize = opts.textFontSize;
+    this._textColor = opts.textColor;
+    this._textBackgroundColor = opts.textBackgroundColor;
+    this._textPosition = opts.textPosition;
+    this._textAutoScroll = opts.textAutoScroll;
+    this._borderWidth = opts.borderWidth;
+    this._borderRadius = opts.borderRadius;
+    this._wrapped = opts.wrapped;
+    this._draggable = opts.draggable;
+    this._orderable = opts.orderable;
+    this._resizable = opts.resizable;
+    this._cuttable = opts.cuttable;
+    this._deletable = opts.deletable;
+    this._wrapping = opts.wrapping;
+    this._previewHeight = opts.previewHeight;
+    this._binaryHeight = opts.binaryHeight;
+    this._indicators = opts.indicators;
+    this._markers = opts.markers;
+    this._buttons = opts.buttons;
+    this._markerColor = opts.markerColor;
+    this._markerWidth = opts.markerWidth;
+    this._volume = opts.volume;
+    this._volumeRange = opts.volumeRange;
+    this._loading = opts.loading;
+
+    if (options && typeof options === 'object') {
+      for (var key in options) {
+        if (Object.prototype.hasOwnProperty.call(options, key) && key.startsWith('custom_')) {
+          this[key] = options[key];
+        }
+      }
+    }
+
+    this._peaks.emit('model.source.update', this);
+  };
+
+  /**
+   * Returns <code>true</code> if the source overlaps a given time region.
+   *
+   * @param {Number} startTime The start of the time region, in seconds.
+   * @param {Number} endTime The end of the time region, in seconds.
+   * @returns {Boolean}
+   *
+   * @see http://wiki.c2.com/?TestIfDateRangesOverlap
+   */
+  Source.prototype.isVisible = function(startTime, endTime) {
+    return this._startTime < endTime && startTime < this._endTime;
+  };
+
+  /**
+   * Update the indicators of this source.
+   *
+   * @param {Array<String>} newIndicators The new indicators.
+   */
+
+  Source.prototype.setIndicators = function(newIndicators) {
+    this._indicators = newIndicators;
+    this._peaks.emit('model.source.setIndicators', this);
+  };
+
+  /**
+   * Returns <code>true</code> if a warning should be shown
+   */
+
+  Source.prototype.shouldShowWarning = function() {
+    return this._warningColor && this._duration > Utils.roundTime(this._endTime - this._startTime);
+  };
+
+  Source.prototype.getVisibleTitle = function() {
+    if (this._titleAlignments.length === 0) {
+      return this._title;
+    }
+
+    return this._titleAlignments.reduce(function(visibleTitle, alignment) {
+      if (this._mediaStartTime < alignment.end && alignment.start < this._mediaEndTime) {
+        visibleTitle.push(alignment.text);
+      }
+      return visibleTitle;
+    }.bind(this), []).join(' ');
+  };
+
+  /**
+   * Returns a serializable object containing only the properties defined with Object.defineProperties.
+   * This includes all enumerable properties that can be safely serialized.
+   *
+   * @returns {Object} A plain object containing the serializable properties of the source.
+   */
+  Source.prototype.toSerializable = function() {
+    var serializable = {};
+
+    // Get all custom properties
+    for (var key in this) {
+      if (Object.prototype.hasOwnProperty.call(this, key) && key.startsWith('custom_')) {
+        serializable[key] = this[key];
+      }
+    }
+
+    // Add all the enumerable properties from the prototype
+    var proto = Object.getPrototypeOf(this);
+    var descriptors = Object.getOwnPropertyDescriptors(proto);
+
+    for (var prop in descriptors) {
+      if (Object.prototype.hasOwnProperty.call(descriptors, prop)) {
+        var descriptor = descriptors[prop];
+
+        if (descriptor.enumerable && descriptor.get && typeof descriptor.get === 'function') {
+          serializable[prop] = this[prop];
+        }
+      }
+    }
+
+    return serializable;
+  };
+
+  return Source;
+});