Method commit

modules/core/EditSystem.js:403–422

* commit * This finalizes the `staging` work-in-progress edit. * (It's somewhat like what `git commit` does.) * - Set annotation, sources, and other edit metadata properties * - Add the `staging` edit to the end of the history (at this point `staging` becomes `stable`) * - Finally,

(options = {})

   * @param  {Array}          options.selectedIDs - Array of selectedIDs
   */
  commit(options = {}) {
    d3_select(document).interrupt('editTransition');    // complete any transition already in progress

    const context = this.context;
    const staging = this.staging;

    const annotation = options.annotation ?? '';
    staging.annotation  = annotation;
    staging.selectedIDs = options.selectedIDs ?? [];
    staging.sources     = this._gatherSources(annotation);
    staging.transform   = context.viewport.transform.props;

    // Discard forward/redo history if any, and add `staging` after `stable`
    this._history.splice(this._index + 1, Infinity, staging);
    this._index++;
    // (At this point `stable` === `staging`)

    this._replaceStaging();
    this._updateChanges();
  }


  /**