Method commitAppend

modules/core/EditSystem.js:457–479

* commitAppend * This is like `commit`, but instead of adding `staging` after stable, * it replaces `stable` with `staging` and does not advance the history. * (It's somewhat like what `git commit --append` does.) * - Set annotation, sources, and other edit metadata properties * -

(options = {})

   * @throws  Will throw if you try to append to the `base` edit
   */
  commitAppend(options = {}) {
    d3_select(document).interrupt('editTransition');    // complete any transition already in progress

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

    if (this._index === 0) {
      throw new Error(`Can not commitAppend to the base edit!`);
    }

    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 replace `stable` with `staging`.
    this._history.splice(this._index, Infinity, staging);
    // (At this point `stable` === `staging`)

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


  /**