@internetarchive/bookreader 5.0.0-38 → 5.0.0-39

package/stat/BookReader/Mode2Up.js

@@ -1,1372 +0,0 @@
-// @ts-check
-// effect.js gives acces to extra easing function (e.g. easeInSine)
-import 'jquery-ui/ui/effect.js';
-import { clamp } from './utils.js';
-import { EVENTS } from './events.js';
-import { ModeSmoothZoom } from "./ModeSmoothZoom.js";
-import { HTMLDimensionsCacher } from './utils/HTMLDimensionsCacher.js';
-import { DragScrollable } from './DragScrollable.js';
-
-/** @typedef {import('../BookReader.js').default} BookReader */
-/** @typedef {import('./BookModel.js').BookModel} BookModel */
-/** @typedef {import('./BookModel.js').PageIndex} PageIndex */
-/** @typedef {import('./options.js').BookReaderOptions} BookReaderOptions */
-/** @typedef {import('./PageContainer.js').PageContainer} PageContainer */
-/** @typedef {import('./ModeSmoothZoom').SmoothZoomable} SmoothZoomable */
-
-/** @implements {SmoothZoomable} */
-export class Mode2Up {
-  /**
-   * @param {BookReader} br
-   * @param {BookModel} bookModel
-   */
-  constructor(br, bookModel) {
-    this.br = br;
-    this.book = bookModel;
-
-    /** @type {HTMLDivElement} */
-    this.leafEdgeL = null;
-    /** @type {HTMLDivElement} */
-    this.leafEdgeR = null;
-
-    /** @type {{ [index: number]: PageContainer }} */
-    this.pageContainers = {};
-
-    /** @type {ModeSmoothZoom} */
-    this.smoothZoomer = null;
-    this._scale = 1;
-    this.scaleCenter = { x: 0.5, y: 0.5 };
-  }
-
-  get $container() {
-    return this.br.refs.$brContainer[0];
-  }
-  get $visibleWorld() {
-    return this.br.refs.$brTwoPageView?.[0];
-  }
-
-  get scale() { return this._scale; }
-  set scale(newVal) {
-    this.$visibleWorld.style.transform = `scale(${newVal})`;
-    this.updateViewportOnZoom(newVal, this._scale);
-    this._scale = newVal;
-  }
-
-  /**
-   * @param {PageIndex} index
-   */
-  jumpToIndex(index) {
-    // By checking against min/max we do nothing if requested index
-    // is current
-    if (index < Math.min(this.br.twoPage.currentIndexL, this.br.twoPage.currentIndexR)) {
-      this.flipBackToIndex(index);
-    } else if (index > Math.max(this.br.twoPage.currentIndexL, this.br.twoPage.currentIndexR)) {
-      this.flipFwdToIndex(index);
-    }
-  }
-
-  /**
-   * Draws book spread,
-   * sets event handlers,
-   * sets: `this.br.displayedIndices`
-   * updates toolbar zoom
-   * Important: `this.br.refs.$brTwoPageView` parent container must be emptied before calling
-   */
-  drawLeafs() {
-    const $twoPageViewEl = this.br.refs.$brTwoPageView;
-    const indexL = this.br.twoPage.currentIndexL;
-    const indexR = this.br.twoPage.currentIndexR;
-
-    this.createPageContainer(indexL).$container
-      .css(this.leftLeafCss)
-      .appendTo($twoPageViewEl);
-    this.createPageContainer(indexR).$container
-      .css(this.rightLeafCss)
-      .appendTo($twoPageViewEl);
-
-    this.displayedIndices = [this.br.twoPage.currentIndexL, this.br.twoPage.currentIndexR];
-    this.br.displayedIndices = this.displayedIndices;
-    this.br.updateToolbarZoom(this.br.reduce);
-    this.br.trigger('pageChanged');
-  }
-
-  /**
-   * @param {1} direction
-   */
-  zoom(direction) {
-    this.br.stopFlipAnimations();
-
-    // Recalculate autofit factors
-    this.calculateReductionFactors();
-
-    // Get new zoom state
-    const reductionFactor = this.br.nextReduce(this.br.reduce, direction, this.br.twoPage.reductionFactors);
-    if ((this.br.reduce == reductionFactor.reduce) && (this.br.twoPage.autofit == reductionFactor.autofit)) {
-      // Same zoom
-      return;
-    }
-    this.br.twoPage.autofit = reductionFactor.autofit;
-    this.br.reduce = reductionFactor.reduce;
-    this.br.pageScale = this.br.reduce; // preserve current reduce
-
-    // Preserve view center position
-    const oldCenter = this.getViewCenter();
-
-    // Prepare view with new center to minimize visual glitches
-    const drawNewSpread = true;
-    this.prepareTwoPageView(oldCenter.percentageX, oldCenter.percentageY, drawNewSpread);
-  }
-
-  /**
-   * Resize spread containers, does not prefetch
-   * uses `this.br.twoPage` properties
-   */
-  resizeSpread() {
-    this.br.resizeBRcontainer(false); // no animation
-    this.calculateSpreadSize();
-
-    this.br.refs?.$brTwoPageView.css(this.mainContainerCss);
-    this.centerView(); // let function self adjust
-
-    $(this.br.twoPage.coverDiv).css(this.spreadCoverCss); // click sheath is memoized somehow
-    const $spreadLayers = this.br.refs.$brTwoPageView;
-
-    $spreadLayers.find('.BRleafEdgeR')?.css(this.leafEdgeRCss);
-    $spreadLayers.find('.BRleafEdgeL')?.css(this.leafEdgeLCss);
-    $spreadLayers.find('.BRgutter')?.css(this.spineCss);
-
-    const indexL = this.br.twoPage.currentIndexL;
-    const indexR = this.br.twoPage.currentIndexR;
-    this.pageContainers[indexL].$container.css(this.leftLeafCss);
-    this.pageContainers[indexR].$container.css(this.rightLeafCss);
-  }
-
-  /**
-   * @param {number} centerPercentageX
-   * @param {number} centerPercentageY
-   * @param {Boolean} drawNewSpread
-   */
-  prepareTwoPageView(centerPercentageX, centerPercentageY, drawNewSpread = false) {
-    // Some decisions about two page view:
-    //
-    // Both pages will be displayed at the same height, even if they were different physical/scanned
-    // sizes.  This simplifies the animation (from a design as well as technical standpoint).  We
-    // examine the page aspect ratios (in calculateSpreadSize) and use the page with the most "normal"
-    // aspect ratio to determine the height.
-    //
-    // The two page view div is resized to keep the middle of the book in the middle of the div
-    // even as the page sizes change.  To e.g. keep the middle of the book in the middle of the BRcontent
-    // div requires adjusting the offset of BRtwpageview and/or scrolling in BRcontent.
-    const startingReduce = this.br.reduce;
-    const startingIndices = this.br.displayedIndices;
-
-    this.br.refs.$brContainer.empty();
-    this.br.refs.$brContainer.css('overflow', 'auto');
-
-    // We want to display two facing pages.  We may be missing
-    // one side of the spread because it is the first/last leaf,
-    // foldouts, missing pages, etc
-
-    const targetLeaf = clamp(this.br.firstIndex, this.br.firstDisplayableIndex(), this.br.lastDisplayableIndex());
-    const currentSpreadIndices = this.book.getSpreadIndices(targetLeaf);
-    this.br.twoPage.currentIndexL = currentSpreadIndices[0];
-    this.br.twoPage.currentIndexR = currentSpreadIndices[1];
-
-    this.calculateSpreadSize(); //sets this.br.reduce, twoPage.width, twoPage.height and others
-
-    /* check if calculations have changed that warrant a new book draw */
-    const sameReducer = startingReduce == this.br.reduce;
-    const sameStart = startingIndices == this.br.displayedIndices;
-    const hasNewDisplayPagesOrDimensions = !sameStart || (sameStart && !sameReducer);
-
-    if (drawNewSpread || hasNewDisplayPagesOrDimensions) {
-      this.prunePageContainers();
-      this.prefetch();
-    }
-
-    // Add the two page view
-    // $$$ Can we get everything set up and then append?
-    this.br.refs.$brTwoPageView = this.br.refs.$brTwoPageView || $('<div class="BRtwopageview"></div>');
-    const $twoPageViewEl = this.br.refs.$brTwoPageView;
-    $twoPageViewEl.empty();
-    $twoPageViewEl[0].style.transformOrigin = '0 0';
-    this.br.refs.$brContainer.append($twoPageViewEl);
-
-    // Attaches to first child, so must come after we add the page view
-    this.dragScrollable = this.dragScrollable || new DragScrollable(this.br.refs.$brContainer[0], {
-      preventDefault: true,
-      // Only handle mouse events; let browser/HammerJS handle touch
-      dragstart: 'mousedown',
-      dragcontinue: 'mousemove',
-      dragend: 'mouseup',
-    });
-
-    this.attachMouseHandlers();
-
-    // $$$ calculate container size first
-    this.br.refs?.$brTwoPageView.css(this.mainContainerCss);
-
-    // This will trump the incoming coordinates
-    // in order to center book when zooming out
-    if (this.br.twoPage.totalWidth < this.br.refs.$brContainer.prop('clientWidth')) {
-      centerPercentageX = 0.5;
-    }
-    if (this.br.twoPage.totalHeight < this.br.refs.$brContainer.prop('clientHeight')) {
-      centerPercentageY = 0.5;
-    }
-
-    this.centerView(centerPercentageX, centerPercentageY);
-
-    // then set
-    this.br.twoPage.coverDiv = document.createElement('div');
-    $(this.br.twoPage.coverDiv).attr('class', 'BRbookcover').css(this.spreadCoverCss).appendTo(this.br.refs.$brTwoPageView);
-
-    this.leafEdgeR = document.createElement('div');
-    this.leafEdgeR.className = 'BRleafEdgeR';
-    $(this.leafEdgeR).css(this.leafEdgeRCss).appendTo(this.br.refs.$brTwoPageView);
-
-    this.leafEdgeL = document.createElement('div');
-    this.leafEdgeL.className = 'BRleafEdgeL';
-    $(this.leafEdgeL).css(this.leafEdgeLCss).appendTo(this.br.refs.$brTwoPageView);
-
-    const div = document.createElement('div');
-    $(div).attr('class', 'BRgutter').css(this.spineCss).appendTo(this.br.refs.$brTwoPageView);
-
-    this.preparePopUp();
-
-    this.br.displayedIndices = [];
-
-    this.drawLeafs();
-    this.br.updateToolbarZoom(this.br.reduce);
-    this.br.updateBrClasses();
-
-    this.smoothZoomer = this.smoothZoomer || new ModeSmoothZoom(this);
-    this.smoothZoomer.attach();
-
-    this.htmlDimensionsCacher = this.htmlDimensionsCacher || new HTMLDimensionsCacher(this.$container);
-  }
-
-  unprepare() {
-    // Mode2Up attaches these listeners to the main BR container, so we need to
-    // detach these or it will cause issues for the other modes.
-    this.smoothZoomer.detach();
-  }
-
-  /**
-   * @param {number} newScale
-   * @param {number} oldScale
-   */
-  updateViewportOnZoom(newScale, oldScale) {
-    const container = this.br.refs.$brContainer[0];
-    const { scrollTop: T, scrollLeft: L } = container;
-    const W = this.htmlDimensionsCacher.clientWidth;
-    const H = this.htmlDimensionsCacher.clientHeight;
-
-    // Scale factor change
-    const F = newScale / oldScale;
-
-    // Where in the viewport the zoom is centered on
-    const XPOS = this.scaleCenter.x;
-    const YPOS = this.scaleCenter.y;
-    const oldCenter = {
-      x: L + XPOS * W,
-      y: T + YPOS * H,
-    };
-    const newCenter = {
-      x: F * oldCenter.x,
-      y: F * oldCenter.y,
-    };
-    container.scrollTop = newCenter.y - YPOS * H;
-    container.scrollLeft = newCenter.x - XPOS * W;
-
-    // Also update the visible page containers to load in highres if necessary
-    this.pageContainers[this.br.twoPage.currentIndexL]?.update({ reduce: this.br.reduce / newScale });
-    this.pageContainers[this.br.twoPage.currentIndexR]?.update({ reduce: this.br.reduce / newScale });
-  }
-
-  prunePageContainers() {
-    for (const index in this.pageContainers) {
-      if ((index != this.br.twoPage.currentIndexL) && (index != this.br.twoPage.currentIndexR)) {
-        $(this.pageContainers[index].$container).remove();
-      }
-      if ((index < this.br.twoPage.currentIndexL - 4) || (index > this.br.twoPage.currentIndexR + 4)) {
-        delete this.pageContainers[index];
-      }
-    }
-  }
-
-  /**
-   * This function prepares the "View Page n" popup that shows while the mouse is
-   * over the left/right "stack of sheets" edges.  It also binds the mouse
-   * events for these divs.
-   */
-  preparePopUp() {
-    this.br.twoPagePopUp = document.createElement('div');
-    this.br.twoPagePopUp.className = 'BRtwoPagePopUp';
-    $(this.br.twoPagePopUp).css({
-      zIndex: '1000'
-    }).appendTo(this.br.refs.$brContainer);
-    $(this.br.twoPagePopUp).hide();
-
-    const leafEdges = [
-      {
-        $leafEdge: $(this.leafEdgeL),
-        /** @type {function(number): PageIndex} */
-        jumpIndexForPageX: this.jumpIndexForLeftEdgePageX.bind(this),
-        leftOffset: () => -$(this.br.twoPagePopUp).width() + 120,
-      },
-      {
-        $leafEdge: $(this.leafEdgeR),
-        /** @type {function(number): PageIndex} */
-        jumpIndexForPageX: this.jumpIndexForRightEdgePageX.bind(this),
-        leftOffset: () => -120,
-      },
-    ];
-
-    for (const { $leafEdge, jumpIndexForPageX, leftOffset } of leafEdges) {
-      $leafEdge.on('mouseenter', () => $(this.br.twoPagePopUp).show());
-      $leafEdge.on('mouseleave', () => $(this.br.twoPagePopUp).hide());
-
-      $leafEdge.on('click', e => {
-        this.br.trigger(EVENTS.stop);
-        this.br.jumpToIndex(jumpIndexForPageX(e.pageX));
-      });
-
-      $leafEdge.on('mousemove', e => {
-        const jumpIndex = clamp(jumpIndexForPageX(e.pageX), 0, this.book.getNumLeafs() - 1);
-        $(this.br.twoPagePopUp).text(`View ${this.book.getPageName(jumpIndex)}`);
-
-        // $$$ TODO: Make sure popup is positioned so that it is in view
-        // (https://bugs.edge.launchpad.net/gnubook/+bug/327456)
-        $(this.br.twoPagePopUp).css({
-          left: `${e.pageX - this.br.refs.$brContainer.offset().left + this.br.refs.$brContainer.scrollLeft() + leftOffset()}px`,
-          top: `${e.pageY - this.br.refs.$brContainer.offset().top + this.br.refs.$brContainer.scrollTop()}px`
-        });
-      });
-    }
-  }
-
-  setSpreadIndices() {
-    const targetLeaf = clamp(this.br.firstIndex, this.br.firstDisplayableIndex(), this.br.lastDisplayableIndex());
-    const currentSpreadIndices = this.book.getSpreadIndices(targetLeaf);
-    this.br.twoPage.currentIndexL = currentSpreadIndices[0];
-    this.br.twoPage.currentIndexR = currentSpreadIndices[1];
-  }
-
-  /**
-   * Calculates 2-page spread dimensions based on this.br.twoPage.currentIndexL and
-   * this.br.twoPage.currentIndexR
-   * This function sets this.br.twoPage.height, twoPage.width
-   */
-  calculateSpreadSize() {
-    const firstIndex  = this.br.twoPage.currentIndexL;
-    const secondIndex = this.br.twoPage.currentIndexR;
-
-    // Calculate page sizes and total leaf width
-    let spreadSize;
-    if ( this.br.twoPage.autofit) {
-      spreadSize = this.getIdealSpreadSize(firstIndex, secondIndex);
-    } else {
-      // set based on reduction factor
-      spreadSize = this.getSpreadSizeFromReduce(firstIndex, secondIndex, this.br.reduce);
-    }
-    // Both pages together
-    this.br.twoPage.height = spreadSize.height || 0;
-    this.br.twoPage.width = spreadSize.width || 0;
-
-    // Individual pages
-    this.br.twoPage.scaledWL = this.getPageWidth(firstIndex) || 0;
-    this.br.twoPage.scaledWR = this.getPageWidth(secondIndex) || 0;
-
-    // Leaf edges
-    this.br.twoPage.edgeWidth = spreadSize.totalLeafEdgeWidth; // The combined width of both edges
-    this.br.twoPage.leafEdgeWidthL = this.br.leafEdgeWidth(this.br.twoPage.currentIndexL);
-    this.br.twoPage.leafEdgeWidthR = this.br.twoPage.edgeWidth - this.br.twoPage.leafEdgeWidthL;
-
-
-    // Book cover
-    // The width of the book cover div.  The combined width of both pages, twice the width
-    // of the book cover internal padding (2*10) and the page edges
-    this.br.twoPage.bookCoverDivWidth = this.coverWidth(this.br.twoPage.scaledWL + this.br.twoPage.scaledWR);
-    // The height of the book cover div
-    this.br.twoPage.bookCoverDivHeight = this.br.twoPage.height + 2 * this.br.twoPage.coverInternalPadding;
-
-
-    // We calculate the total width and height for the div so that we can make the book
-    // spine centered
-    const leftGutterOffset = this.gutterOffsetForIndex(firstIndex);
-    const leftWidthFromCenter = this.br.twoPage.scaledWL - leftGutterOffset + this.br.twoPage.leafEdgeWidthL;
-    const rightWidthFromCenter = this.br.twoPage.scaledWR + leftGutterOffset + this.br.twoPage.leafEdgeWidthR;
-    const largestWidthFromCenter = Math.max( leftWidthFromCenter, rightWidthFromCenter );
-    this.br.twoPage.totalWidth = 2 * (largestWidthFromCenter + this.br.twoPage.coverInternalPadding + this.br.twoPage.coverExternalPadding);
-    this.br.twoPage.totalHeight = this.br.twoPage.height + 2 * (this.br.twoPage.coverInternalPadding + this.br.twoPage.coverExternalPadding);
-
-    // We want to minimize the unused space in two-up mode (maximize the amount of page
-    // shown).  We give width to the leaf edges and these widths change (though the sum
-    // of the two remains constant) as we flip through the book.  With the book
-    // cover centered and fixed in the BRcontainer div the page images will meet
-    // at the "gutter" which is generally offset from the center.
-    this.br.twoPage.middle = this.br.twoPage.totalWidth >> 1;
-    this.br.twoPage.gutter = this.br.twoPage.middle + this.gutterOffsetForIndex(firstIndex);
-
-    // The left edge of the book cover moves depending on the width of the pages
-    // $$$ change to getter
-    this.br.twoPage.bookCoverDivLeft = this.br.twoPage.gutter - this.br.twoPage.scaledWL - this.br.twoPage.leafEdgeWidthL - this.br.twoPage.coverInternalPadding;
-    // The top edge of the book cover stays a fixed distance from the top
-    this.br.twoPage.bookCoverDivTop = this.br.twoPage.coverExternalPadding;
-
-    // Book spine
-    this.br.twoPage.bookSpineDivHeight = this.br.twoPage.height + 2 * this.br.twoPage.coverInternalPadding;
-    this.br.twoPage.bookSpineDivLeft = this.br.twoPage.middle - (this.br.twoPage.bookSpineDivWidth >> 1);
-    this.br.twoPage.bookSpineDivTop = this.br.twoPage.bookCoverDivTop;
-
-    this.br.reduce = spreadSize.reduce < 0 ? this.br.reduce : spreadSize.reduce; // $$$ really set this here?
-  }
-
-  /**
-   *
-   * @param {number} firstIndex
-   * @param {number} secondIndex
-   * @return {{ width: number, height: number, totalLeafEdgeWidth: number, reduce: number}}
-   */
-  getIdealSpreadSize(firstIndex, secondIndex) {
-    const ideal = {};
-
-    // We check which page is closest to a "normal" page and use that to set the height
-    // for both pages.  This means that foldouts and other odd size pages will be displayed
-    // smaller than the nominal zoom amount.
-    const canon5Dratio = 1.5;
-
-    const first = {
-      height: this.book._getPageHeight(firstIndex),
-      width: this.book._getPageWidth(firstIndex)
-    };
-
-    const second = {
-      height: this.book._getPageHeight(secondIndex),
-      width: this.book._getPageWidth(secondIndex)
-    };
-
-    const firstIndexRatio  = first.height / first.width;
-    const secondIndexRatio = second.height / second.width;
-
-    let ratio;
-    if (Math.abs(firstIndexRatio - canon5Dratio) < Math.abs(secondIndexRatio - canon5Dratio)) {
-      ratio = firstIndexRatio;
-    } else {
-      ratio = secondIndexRatio;
-    }
-
-    const totalLeafEdgeWidth = Math.floor(this.book.getNumLeafs() * 0.1);
-    const maxLeafEdgeWidth = Math.floor(this.br.refs.$brContainer.prop('clientWidth') * 0.1);
-    ideal.totalLeafEdgeWidth = Math.min(totalLeafEdgeWidth, maxLeafEdgeWidth);
-
-    const widthOutsidePages = 2 * (this.br.twoPage.coverInternalPadding + this.br.twoPage.coverExternalPadding) + ideal.totalLeafEdgeWidth;
-    const heightOutsidePages = 2 * (this.br.twoPage.coverInternalPadding + this.br.twoPage.coverExternalPadding);
-
-    ideal.width = (this.br.refs.$brContainer.width() - widthOutsidePages) >> 1;
-    ideal.width = ideal.width > 10 ? ideal.width - 10 : 1; // $$$ fudge factor
-
-    ideal.height = this.br.refs.$brContainer.height() - heightOutsidePages;
-    ideal.height = ideal.height > 15 ? ideal.height - 15 : 1; // $$$ fudge factor
-
-    if (ideal.height / ratio <= ideal.width) {
-      //use height
-      ideal.width = Math.floor(ideal.height / ratio) || 1;
-    } else {
-      //use width
-      ideal.height = Math.floor(ideal.width * ratio) || 1;
-    }
-
-    // $$$ check this logic with large spreads
-    ideal.reduce = Math.round(((first.height + second.height) / 2) / ideal.height);
-
-    return ideal;
-  }
-
-  /**
-   * Returns the spread size calculated from the reduction factor for the given pages
-   * @param {number} firstIndex
-   * @param {number} secondIndex
-   * @return {Object}
-   */
-  getSpreadSizeFromReduce(firstIndex, secondIndex, reduce) {
-    const spreadSize = {};
-    // $$$ Scale this based on reduce?
-    const totalLeafEdgeWidth = Math.floor(this.book.getNumLeafs() * 0.1);
-    // $$$ Assumes leaf edge width constant at all zoom levels
-    const maxLeafEdgeWidth = Math.floor(this.br.refs.$brContainer.prop('clientWidth') * 0.1);
-    spreadSize.totalLeafEdgeWidth = Math.min(totalLeafEdgeWidth, maxLeafEdgeWidth);
-
-    // $$$ Possibly incorrect -- we should make height "dominant"
-    const nativeWidth = this.book._getPageWidth(firstIndex) + this.book._getPageWidth(secondIndex);
-    const nativeHeight = this.book._getPageHeight(firstIndex) + this.book._getPageHeight(secondIndex);
-    spreadSize.height = Math.floor( (nativeHeight / 2) / this.br.reduce );
-    spreadSize.width = Math.floor( (nativeWidth / 2) / this.br.reduce );
-    spreadSize.reduce = reduce;
-
-    return spreadSize;
-  }
-
-  /**
-   * Returns the current ideal reduction factor
-   * @return {number}
-   */
-  getAutofitReduce() {
-    const spreadSize = this.getIdealSpreadSize(this.br.twoPage.currentIndexL, this.br.twoPage.currentIndexR);
-    return spreadSize.reduce;
-  }
-
-  /**
-   * Returns true if the pages extend past the edge of the view
-   * @deprecated slated for deprecation by v5.0.0
-   * @return {boolean}
-   */
-  isZoomedIn() {
-    let isZoomedIn = false;
-    if (this.br.twoPage.autofit != 'auto') {
-      if (this.br.reduce < this.getAutofitReduce()) {
-        isZoomedIn = true;
-      }
-    }
-    return isZoomedIn;
-  }
-
-  calculateReductionFactors() {
-    this.br.twoPage.reductionFactors = this.br.reductionFactors.concat([
-      {
-        reduce: this.getIdealSpreadSize( this.br.twoPage.currentIndexL, this.br.twoPage.currentIndexR ).reduce,
-        autofit: 'auto'
-      }
-    ]);
-    this.br.twoPage.reductionFactors.sort(this.br._reduceSort);
-  }
-
-  /**
-   * Set the cursor for two page view
-   * @deprecated Since version 4.3.3. Will be deleted in version 5.0
-   */
-  setCursor() {
-    console.warn('Call to deprecated method, Mode2Up.setCursor. No-op.');
-  }
-
-  /**
-   * @param {Number|null} index to flip back one spread, pass index=null
-   */
-  flipBackToIndex(index) {
-    if (this.br.constMode1up == this.br.mode) return;
-    if (this.br.animating) return;
-
-    if (null != this.br.leafEdgeTmp) {
-      alert('error: leafEdgeTmp should be null!');
-      return;
-    }
-
-    if (null == index) {
-      const {currentIndexL, currentIndexR} = this.br.twoPage;
-      const minDisplayedIndex = Math.min(currentIndexL, currentIndexR);
-      const prev = this.book.getPage(minDisplayedIndex).findPrev({ combineConsecutiveUnviewables: true });
-      if (!prev) return;
-      index = prev.index;
-      // Can only flip to a left page
-      // (downstream code handles index = -1, so this is ok I guess)
-      if (prev.pageSide == 'R') index--;
-    }
-
-    this.br.updateNavIndexThrottled(index);
-
-    const previousIndices = this.book.getSpreadIndices(index);
-
-    if (previousIndices[0] < this.br.firstDisplayableIndex() || previousIndices[1] < this.br.firstDisplayableIndex()) {
-      return;
-    }
-
-    this.br.animating = true;
-
-    if ('rl' != this.br.pageProgression) {
-      // Assume LTR and we are going backward
-      this.prepareFlipLeftToRight(previousIndices[0], previousIndices[1]);
-      this.flipLeftToRight(previousIndices[0], previousIndices[1]);
-    } else {
-      // RTL and going backward
-      this.prepareFlipRightToLeft(previousIndices[0], previousIndices[1]);
-      this.flipRightToLeft(previousIndices[0], previousIndices[1]);
-    }
-  }
-
-  /**
-   * Flips the page on the left towards the page on the right
-   * @param {number} newIndexL
-   * @param {number} newIndexR
-   */
-  flipLeftToRight(newIndexL, newIndexR) {
-    this.br.refs.$brContainer.addClass("BRpageFlipping");
-    const leftLeaf = this.br.twoPage.currentIndexL;
-
-    const oldLeafEdgeWidthL = this.br.leafEdgeWidth(this.br.twoPage.currentIndexL);
-    const newLeafEdgeWidthL = this.br.leafEdgeWidth(newIndexL);
-    const leafEdgeTmpW = oldLeafEdgeWidthL - newLeafEdgeWidthL;
-
-    const currWidthL   = this.getPageWidth(leftLeaf);
-    const newWidthL    = this.getPageWidth(newIndexL);
-    const newWidthR    = this.getPageWidth(newIndexR);
-
-    const top  = this.top();
-    const gutter = this.br.twoPage.middle + this.gutterOffsetForIndex(newIndexL);
-
-    //animation strategy:
-    // 0. remove search highlight, if any.
-    // 1. create a new div, called leafEdgeTmp to represent the leaf edge between the leftmost edge
-    //    of the left leaf and where the user clicked in the leaf edge.
-    //    Note that if this function was triggered by left() and not a
-    //    mouse click, the width of leafEdgeTmp is very small (zero px).
-    // 2. animate both leafEdgeTmp to the gutter (without changing its width) and animate
-    //    leftLeaf to width=0.
-    // 3. When step 2 is finished, animate leafEdgeTmp to right-hand side of new right leaf
-    //    (left=gutter+newWidthR) while also animating the new right leaf from width=0 to
-    //    its new full width.
-    // 4. After step 3 is finished, do the following:
-    //      - remove leafEdgeTmp from the dom.
-    //      - resize and move the right leaf edge (leafEdgeR) to left=gutter+newWidthR
-    //          and width=twoPage.edgeWidth-newLeafEdgeWidthL.
-    //      - resize and move the left leaf edge (leafEdgeL) to left=gutter-newWidthL-newLeafEdgeWidthL
-    //          and width=newLeafEdgeWidthL.
-    //      - resize the back cover (twoPage.coverDiv) to left=gutter-newWidthL-newLeafEdgeWidthL-10
-    //          and width=newWidthL+newWidthR+twoPage.edgeWidth+20
-    //      - move new left leaf (newIndexL) forward to zindex=2 so it can receive clicks.
-    //      - remove old left and right leafs from the dom [prunePageContainers()].
-    //      - prefetch new adjacent leafs.
-    //      - set up click handlers for both new left and right leafs.
-    //      - redraw the search highlight.
-    //      - update the pagenum box and the url.
-
-    const $twoPageViewEl = this.br.refs.$brTwoPageView;
-    const leftEdgeTmpLeft = gutter - currWidthL - leafEdgeTmpW;
-
-    this.br.leafEdgeTmp = document.createElement('div');
-    this.br.leafEdgeTmp.className = 'BRleafEdgeTmp';
-    $(this.br.leafEdgeTmp).css({
-      width: `${leafEdgeTmpW}px`,
-      height: `${this.br.twoPage.height}px`,
-      left: `${leftEdgeTmpLeft}px`,
-      top: `${top}px`,
-      zIndex: 1000,
-    }).appendTo($twoPageViewEl);
-
-    $(this.leafEdgeL).css({
-      width: `${newLeafEdgeWidthL}px`,
-      left: `${gutter - currWidthL - newLeafEdgeWidthL}px`
-    });
-
-    // Left gets the offset of the current left leaf from the document
-    const left = this.pageContainers[leftLeaf].$container.offset().left;
-    // $$$ This seems very similar to the gutter.  May be able to consolidate the logic.
-    const right = `${$twoPageViewEl.prop('clientWidth') - left - this.pageContainers[leftLeaf].$container.width() + $twoPageViewEl.offset().left - 2}px`;
-
-    // We change the left leaf to right positioning
-    // $$$ This causes animation glitches during resize.  See https://bugs.edge.launchpad.net/gnubook/+bug/328327
-    this.pageContainers[leftLeaf].$container.css({
-      right,
-      left: ''
-    });
-
-    $(this.br.leafEdgeTmp).animate({left: gutter}, this.br.flipSpeed, 'easeInSine');
-
-    this.pageContainers[leftLeaf].$container.animate({width: '0px'}, this.br.flipSpeed, 'easeInSine', () => {
-
-      $(this.br.leafEdgeTmp).animate({left: `${gutter + newWidthR}px`}, this.br.flipSpeed, 'easeOutSine');
-
-      this.br.$('.BRgutter').css({left: `${gutter - this.br.twoPage.bookSpineDivWidth * 0.5}px`});
-
-      this.pageContainers[newIndexR].$container.animate({width: `${newWidthR}px`}, this.br.flipSpeed, 'easeOutSine', () => {
-        this.pageContainers[newIndexL].$container.css('zIndex', 2);
-
-        $(this.leafEdgeR).css({
-          // Moves the right leaf edge
-          width: `${this.br.twoPage.edgeWidth - newLeafEdgeWidthL}px`,
-          left:  `${gutter + newWidthR}px`
-        });
-
-        $(this.leafEdgeL).css({
-          // Moves and resizes the left leaf edge
-          width: `${newLeafEdgeWidthL}px`,
-          left:  `${gutter - newWidthL - newLeafEdgeWidthL}px`
-        });
-
-        // Resizes the brown border div
-        $(this.br.twoPage.coverDiv).css({
-          width: `${this.coverWidth(newWidthL + newWidthR)}px`,
-          left: `${gutter - newWidthL - newLeafEdgeWidthL - this.br.twoPage.coverInternalPadding}px`
-        });
-
-        $(this.br.leafEdgeTmp).remove();
-        this.br.leafEdgeTmp = null;
-
-        // $$$ TODO refactor with opposite direction flip
-
-        this.br.twoPage.currentIndexL = newIndexL;
-        this.br.twoPage.currentIndexR = newIndexR;
-        this.br.twoPage.scaledWL = newWidthL;
-        this.br.twoPage.scaledWR = newWidthR;
-        this.br.twoPage.gutter = gutter;
-
-        this.br.updateFirstIndex(this.br.twoPage.currentIndexL);
-        this.br.displayedIndices = [newIndexL, newIndexR];
-        this.prunePageContainers();
-        this.br.animating = false;
-
-        this.resizeSpread();
-
-        if (this.br.animationFinishedCallback) {
-          this.br.animationFinishedCallback();
-          this.br.animationFinishedCallback = null;
-        }
-
-        this.br.refs.$brContainer.removeClass("BRpageFlipping");
-        this.br.textSelectionPlugin?.stopPageFlip(this.br.refs.$brContainer);
-        this.centerView();
-        this.br.trigger('pageChanged');
-
-        // get next previous batch immediately
-        this.prunePageContainers();
-        this.createPageContainer(newIndexL - 2);
-        this.createPageContainer(newIndexR - 2);
-        this.createPageContainer(newIndexL - 3);
-        this.createPageContainer(newIndexR - 3);
-      });
-    });
-  }
-
-  /**
-   * @param {PageIndex} index
-   */
-  createPageContainer(index) {
-    if (!this.pageContainers[index]) {
-      this.pageContainers[index] = this.br._createPageContainer(index);
-    }
-    this.pageContainers[index].update({ reduce: this.br.reduce / this.scale });
-    return this.pageContainers[index];
-  }
-
-  /**
-   * Whether we flip left or right is dependent on the page progression
-   * to flip forward one spread, pass index=null
-   * @param {number} index
-   */
-  flipFwdToIndex(index) {
-    if (this.br.animating) return;
-
-    if (null != this.br.leafEdgeTmp) {
-      alert('error: leafEdgeTmp should be null!');
-      return;
-    }
-
-    if (null == index) {
-      // Need to use the max here, since it could be a right to left book
-      const {currentIndexL, currentIndexR} = this.br.twoPage;
-      const maxDisplayedIndex = Math.max(currentIndexL, currentIndexR);
-      const nextPage = this.book.getPage(maxDisplayedIndex).findNext({ combineConsecutiveUnviewables: true });
-      if (!nextPage) return;
-      index = nextPage.index;
-    }
-    if (index > this.br.lastDisplayableIndex()) return;
-
-    this.br.updateNavIndexThrottled(index);
-
-    this.br.animating = true;
-
-    const nextIndices = this.book.getSpreadIndices(index);
-
-    if ('rl' != this.br.pageProgression) {
-      // We did not specify RTL
-      this.prepareFlipRightToLeft(nextIndices[0], nextIndices[1]);
-      this.flipRightToLeft(nextIndices[0], nextIndices[1]);
-    } else {
-      // RTL
-      this.prepareFlipLeftToRight(nextIndices[0], nextIndices[1]);
-      this.flipLeftToRight(nextIndices[0], nextIndices[1]);
-    }
-  }
-
-  /**
-   * Flip from left to right and show the nextL and nextR indices on those sides
-   * $$$ better not to have to pass gutter in
-   * @param {number} newIndexL
-   * @param {number} newIndexR
-   */
-  flipRightToLeft(newIndexL, newIndexR) {
-    this.br.refs.$brContainer.addClass("BRpageFlipping");
-
-    const oldLeafEdgeWidthL = this.br.leafEdgeWidth(this.br.twoPage.currentIndexL);
-    const oldLeafEdgeWidthR = this.br.twoPage.edgeWidth - oldLeafEdgeWidthL;
-    const newLeafEdgeWidthL = this.br.leafEdgeWidth(newIndexL);
-    const newLeafEdgeWidthR = this.br.twoPage.edgeWidth - newLeafEdgeWidthL;
-
-    const leafEdgeTmpW = oldLeafEdgeWidthR - newLeafEdgeWidthR;
-
-    const top = this.top();
-    const scaledW = this.getPageWidth(this.br.twoPage.currentIndexR);
-
-    const middle = this.br.twoPage.middle;
-    const gutter = middle + this.gutterOffsetForIndex(newIndexL);
-
-    const $twoPageViewEl = this.br.refs.$brTwoPageView;
-
-    this.br.leafEdgeTmp = document.createElement('div');
-    this.br.leafEdgeTmp.className = 'BRleafEdgeTmp';
-    $(this.br.leafEdgeTmp).css({
-      width: `${leafEdgeTmpW}px`,
-      height: `${this.br.twoPage.height}px`,
-      left: `${gutter + scaledW}px`,
-      top: `${top}px`,
-      zIndex:1000
-    }).appendTo($twoPageViewEl);
-
-    const newWidthL = this.getPageWidth(newIndexL);
-    const newWidthR = this.getPageWidth(newIndexR);
-
-    $(this.leafEdgeR).css({width: `${newLeafEdgeWidthR}px`, left: `${gutter + newWidthR}px` });
-    const speed = this.br.flipSpeed;
-
-    $(this.br.leafEdgeTmp).animate({left: gutter}, speed, 'easeInSine');
-    this.pageContainers[this.br.twoPage.currentIndexR].$container.animate({width: '0px'}, speed, 'easeInSine', () => {
-      this.br.$('BRgutter').css({left: `${gutter - this.br.twoPage.bookSpineDivWidth * 0.5}px`});
-      $(this.br.leafEdgeTmp).animate({left: `${gutter - newWidthL - leafEdgeTmpW}px`}, speed, 'easeOutSine');
-      this.pageContainers[newIndexL].$container.animate({width: `${newWidthL}px`}, speed, 'easeOutSine', () => {
-        this.pageContainers[newIndexR].$container.css('zIndex', 2);
-
-        $(this.leafEdgeL).css({
-          width: `${newLeafEdgeWidthL}px`,
-          left: `${gutter - newWidthL - newLeafEdgeWidthL}px`
-        });
-
-        // Resizes the book cover
-        $(this.br.twoPage.coverDiv).css({
-          width: `${this.coverWidth(newWidthL + newWidthR)}px`,
-          left: `${gutter - newWidthL - newLeafEdgeWidthL - this.br.twoPage.coverInternalPadding}px`
-        });
-
-        $(this.br.leafEdgeTmp).remove();
-        this.br.leafEdgeTmp = null;
-
-        this.br.twoPage.currentIndexL = newIndexL;
-        this.br.twoPage.currentIndexR = newIndexR;
-        this.br.twoPage.scaledWL = newWidthL;
-        this.br.twoPage.scaledWR = newWidthR;
-        this.br.twoPage.gutter = gutter;
-
-        this.br.updateFirstIndex(this.br.twoPage.currentIndexL);
-        this.br.displayedIndices = [newIndexL, newIndexR];
-        this.prunePageContainers();
-        this.br.animating = false;
-
-        this.resizeSpread();
-
-        if (this.br.animationFinishedCallback) {
-          this.br.animationFinishedCallback();
-          this.br.animationFinishedCallback = null;
-        }
-
-        this.br.refs.$brContainer.removeClass("BRpageFlipping");
-        this.br.textSelectionPlugin?.stopPageFlip(this.br.refs.$brContainer);
-        this.centerView();
-        this.br.trigger('pageChanged');
-
-        this.prunePageContainers();
-        this.createPageContainer(newIndexL + 2);
-        this.createPageContainer(newIndexR + 2);
-        this.createPageContainer(newIndexL + 3);
-        this.createPageContainer(newIndexR + 3);
-      });
-    });
-  }
-
-  attachMouseHandlers() {
-    this.br.refs.$brTwoPageView
-      .off('mouseup').on('mouseup', ev => {
-        if (ev.which == 3) {
-          // right click
-          return !this.br.protected;
-        }
-
-        const $page = $(ev.target).closest('.BRpagecontainer');
-        if ($page.data('side') == 'L') this.br.left();
-        else if ($page.data('side') == 'R') this.br.right();
-      });
-  }
-
-  /**
-   * Prepare to flip the left page towards the right.  This corresponds to moving
-   * backward when the page progression is left to right.
-   * @param {number} prevL
-   * @param {number} prevR
-   */
-  prepareFlipLeftToRight(prevL, prevR) {
-    this.createPageContainer(prevL, true);
-    this.createPageContainer(prevR, true);
-
-    const $twoPageViewEl = this.br.refs.$brTwoPageView;
-    const height  = this.book._getPageHeight(prevL);
-    const width   = this.book._getPageWidth(prevL);
-    const middle = this.br.twoPage.middle;
-    const top  = this.top();
-    const scaledW = this.br.twoPage.height * width / height; // $$$ assumes height of page is dominant
-
-    // The gutter is the dividing line between the left and right pages.
-    // It is offset from the middle to create the illusion of thickness to the pages
-    const gutter = middle + this.gutterOffsetForIndex(prevL);
-
-    const leftCSS = {
-      left: `${gutter - scaledW}px`,
-      right: '', // clear right property
-      top:    `${top}px`,
-      height: this.br.twoPage.height,
-      width:  `${scaledW}px`,
-      zIndex: 1
-    };
-
-    this.pageContainers[prevL].$container
-      .css(leftCSS)
-      .appendTo($twoPageViewEl);
-
-    const rightCSS = {
-      left:   `${gutter}px`,
-      right: '',
-      top:    `${top}px`,
-      height: this.br.twoPage.height,
-      width:  '0',
-      zIndex: 2
-    };
-
-    this.pageContainers[prevR].$container
-      .css(rightCSS)
-      .appendTo($twoPageViewEl);
-  }
-
-  /**
-   * // $$$ mang we're adding an extra pixel in the middle.  See https://bugs.edge.launchpad.net/gnubook/+bug/411667
-   */
-  prepareFlipRightToLeft(nextL, nextR) {
-    this.createPageContainer(nextL, true);
-    this.createPageContainer(nextR, true);
-
-    const $twoPageViewEl = this.br.refs.$brTwoPageView;
-    let height = this.book._getPageHeight(nextR);
-    let width = this.book._getPageWidth(nextR);
-    const middle = this.br.twoPage.middle;
-    const top = this.top();
-    let scaledW = this.br.twoPage.height * width / height;
-
-    const gutter = middle + this.gutterOffsetForIndex(nextL);
-
-    $(this.pageContainers[nextR].$container).css({
-      left:   `${gutter}px`,
-      top:    `${top}px`,
-      height: this.br.twoPage.height,
-      width:  `${scaledW}px`,
-      zIndex: 1,
-    })
-      .appendTo($twoPageViewEl);
-
-    height = this.book._getPageHeight(nextL);
-    width = this.book._getPageWidth(nextL);
-    scaledW = this.br.twoPage.height * width / height;
-
-    $(this.pageContainers[nextL].$container).css({
-      right: `${$twoPageViewEl.prop('clientWidth') - gutter}px`,
-      top: `${top}px`,
-      height: this.br.twoPage.height,
-      width: '0px', // Start at 0 width, then grow to the left
-      zIndex: 2,
-    })
-      .appendTo($twoPageViewEl);
-  }
-
-  getPageWidth(index) {
-    // We return the width based on the dominant height
-    const height = this.book._getPageHeight(index);
-    const width = this.book._getPageWidth(index);
-    // $$$ we assume width is relative to current spread
-    return Math.floor(this.br.twoPage.height * width / height);
-  }
-
-  /**
-   * Returns the position of the gutter (line between the page images)
-   */
-  gutter() {
-    return this.br.twoPage.middle + this.gutterOffsetForIndex(this.br.twoPage.currentIndexL);
-  }
-
-  /**
-   * Returns the offset for the top of the page images
-   */
-  top() {
-    return this.br.twoPage.coverExternalPadding + this.br.twoPage.coverInternalPadding; // $$$ + border?
-  }
-
-  /**
-  * Returns the width of the cover div given the total page width
-  * @param {number} totalPageWidth
-  * @return {number}
-  */
-  coverWidth(totalPageWidth) {
-    return totalPageWidth + this.br.twoPage.edgeWidth + 2 * this.br.twoPage.coverInternalPadding;
-  }
-
-  /**
-   * Returns the percentage offset into twopageview div at the center of container div
-   */
-  getViewCenter() {
-    const { $brContainer, $brTwoPageView } = this.br.refs;
-    const center = {};
-
-    const containerOffset = $brContainer.offset();
-    const viewOffset = $brTwoPageView.offset();
-    center.percentageX = (containerOffset.left - viewOffset.left + ($brContainer.prop('clientWidth') >> 1)) / this.br.twoPage.totalWidth;
-    center.percentageY = (containerOffset.top - viewOffset.top + ($brContainer.prop('clientHeight') >> 1)) / this.br.twoPage.totalHeight;
-
-    return center;
-  }
-
-  /**
-   * Centers the point given by percentage from left,top of twopageview
-   * @param {number} [percentageX=0.5]
-   * @param {number} [percentageY=0.5]
- */
-  centerView(percentageX, percentageY) {
-
-    if ('undefined' == typeof(percentageX)) {
-      percentageX = 0.5;
-    }
-    if ('undefined' == typeof(percentageY)) {
-      percentageY = 0.5;
-    }
-
-    const viewWidth = this.br.refs.$brTwoPageView.width();
-    const containerClientWidth = this.br.refs.$brContainer.prop('clientWidth');
-    const intoViewX = percentageX * viewWidth;
-
-    const viewHeight = this.br.refs.$brTwoPageView.height();
-    const containerClientHeight = this.br.refs.$brContainer.prop('clientHeight');
-    const intoViewY = percentageY * viewHeight;
-
-    if (viewWidth < containerClientWidth) {
-      // Can fit width without scrollbars - center by adjusting offset
-      this.br.refs.$brTwoPageView.css('left', `${(containerClientWidth >> 1) - intoViewX}px`);
-    } else {
-      // Need to scroll to center
-      this.br.refs.$brTwoPageView.css('left', 0);
-      this.br.refs.$brContainer.scrollLeft(intoViewX - (containerClientWidth >> 1));
-    }
-
-    if (viewHeight < containerClientHeight) {
-      // Fits with scrollbars - add offset
-      this.br.refs.$brTwoPageView.css('top', `${(containerClientHeight >> 1) - intoViewY}px`);
-    } else {
-      this.br.refs.$brTwoPageView.css('top', 0);
-      this.br.refs.$brContainer.scrollTop(intoViewY - (containerClientHeight >> 1));
-    }
-  }
-
-  /**
-   * Returns the integer height of the click-to-flip areas at the edges of the book
-   * @return {number}
-   */
-  flipAreaHeight() {
-    return Math.floor(this.br.twoPage.height);
-  }
-
-  /**
-   * Returns the the integer width of the flip areas
-   * @return {number}
-   */
-  flipAreaWidth() {
-    const max = 100; // $$$ TODO base on view width?
-    const min = 10;
-
-    const width = this.br.twoPage.width * 0.15;
-    return Math.floor(clamp(width, min, max));
-  }
-
-  /**
-   * Returns integer top offset for flip areas
-   * @return {number}
-   */
-  flipAreaTop() {
-    return Math.floor(this.br.twoPage.bookCoverDivTop + this.br.twoPage.coverInternalPadding);
-  }
-
-  /**
-   * Left offset for left flip area
-   * @return {number}
-   */
-  leftFlipAreaLeft() {
-    return Math.floor(this.br.twoPage.gutter - this.br.twoPage.scaledWL);
-  }
-
-  /**
-   * Left offset for right flip area
-   * @return {number}
-   */
-  rightFlipAreaLeft() {
-    return Math.floor(this.br.twoPage.gutter + this.br.twoPage.scaledWR - this.flipAreaWidth());
-  }
-
-  /**
-   * Position calculation shared between search and text-to-speech functions
-   */
-  setHilightCss(div, index, left, right, top, bottom) {
-    // We calculate the reduction factor for the specific page because it can be different
-    // for each page in the spread
-    const height = this.book._getPageHeight(index);
-    const width  = this.book._getPageWidth(index);
-    const reduce = this.br.twoPage.height / height;
-    const scaledW = Math.floor(width * reduce);
-
-    const gutter = this.gutter();
-    let pageL;
-    if ('L' == this.book.getPageSide(index)) {
-      pageL = gutter - scaledW;
-    } else {
-      pageL = gutter;
-    }
-    const pageT = this.top();
-
-    $(div).css({
-      width:  `${(right - left) * reduce}px`,
-      height: `${(bottom - top) * reduce}px`,
-      left:   `${pageL + left * reduce}px`,
-      top:    `${pageT + top * reduce}px`
-    });
-  }
-
-  /**
-   * Returns the gutter offset for the spread containing the given index.
-   * This function supports RTL
-   * @param {number} pindex
-   * @return {number}
-   */
-  gutterOffsetForIndex(pindex) {
-    // To find the offset of the gutter from the middle we calculate our percentage distance
-    // through the book (0..1), remap to (-0.5..0.5) and multiply by the total page edge width
-    let offset = Math.floor(((pindex / this.book.getNumLeafs()) - 0.5) * this.br.twoPage.edgeWidth);
-
-    // But then again for RTL it's the opposite
-    if ('rl' == this.br.pageProgression) {
-      offset *= -1;
-    }
-
-    return offset;
-  }
-
-  /**
-   * Returns the width of the leaf edge div for the page with index given
-   * @param {number} pindex
-   * @return {number}
-   */
-  leafEdgeWidth(pindex) {
-    // $$$ could there be single pixel rounding errors for L vs R?
-    if ((this.book.getPageSide(pindex) == 'L') && (this.br.pageProgression != 'rl')) {
-      return Math.floor( (pindex / this.book.getNumLeafs()) * this.br.twoPage.edgeWidth + 0.5);
-    } else {
-      return Math.floor( (1 - pindex / this.book.getNumLeafs()) * this.br.twoPage.edgeWidth + 0.5);
-    }
-  }
-
-  /**
-   * Returns the target jump leaf given a page coordinate (inside the left page edge div)
-   * @param {number} pageX
-   * @return {PageIndex}
-   */
-  jumpIndexForLeftEdgePageX(pageX) {
-    let jumpIndex;
-    if ('rl' != this.br.pageProgression) {
-      // LTR - flipping backward
-      jumpIndex = this.br.twoPage.currentIndexL - ($(this.leafEdgeL).offset().left + $(this.leafEdgeL).width() - pageX) * 10;
-
-      // browser may have resized the div due to font size change -- see https://bugs.launchpad.net/gnubook/+bug/333570
-      jumpIndex = clamp(Math.round(jumpIndex), this.br.firstDisplayableIndex(), this.br.twoPage.currentIndexL - 2);
-      return jumpIndex;
-
-    } else {
-      jumpIndex = this.br.twoPage.currentIndexL + ($(this.leafEdgeL).offset().left + $(this.leafEdgeL).width() - pageX) * 10;
-      jumpIndex = clamp(Math.round(jumpIndex), this.br.twoPage.currentIndexL + 2, this.br.lastDisplayableIndex());
-      return jumpIndex;
-    }
-  }
-
-  /**
-   * Returns the target jump leaf given a page coordinate (inside the right page edge div)
-   * @param {number} pageX
-   * @return {PageIndex}
-   */
-  jumpIndexForRightEdgePageX(pageX) {
-    let jumpIndex;
-    if ('rl' != this.br.pageProgression) {
-      // LTR
-      jumpIndex = this.br.twoPage.currentIndexL + (pageX - $(this.leafEdgeR).offset().left) * 10;
-      jumpIndex = clamp(Math.round(jumpIndex), this.br.twoPage.currentIndexL + 2, this.br.lastDisplayableIndex());
-      return jumpIndex;
-    } else {
-      jumpIndex = this.br.twoPage.currentIndexL - (pageX - $(this.leafEdgeR).offset().left) * 10;
-      jumpIndex = clamp(Math.round(jumpIndex), this.br.firstDisplayableIndex(), this.br.twoPage.currentIndexL - 2);
-      return jumpIndex;
-    }
-  }
-
-  /**
-   * Fetches the currently displayed images (if not already fetching)
-   * as wells as any nearby pages.
-   */
-  prefetch() {
-    // $$$ We should check here if the current indices have finished
-    //     loading (with some timeout) before loading more page images
-    //     See https://bugs.edge.launchpad.net/bookreader/+bug/511391
-    const { max, min } = Math;
-    const { book } = this;
-    const { currentIndexL, currentIndexR } = this.br.twoPage;
-    const ADJACENT_PAGES_TO_LOAD = 2;
-    // currentIndexL can be -1; getPage returns the last page of the book
-    // when given -1, so need to prevent that.
-    let lowPage = book.getPage(max(0, min(currentIndexL, currentIndexR)));
-    let highPage = book.getPage(max(currentIndexL, currentIndexR));
-
-    for (let i = 0; i < ADJACENT_PAGES_TO_LOAD + 2; i++) {
-      if (lowPage) {
-        this.createPageContainer(lowPage.index);
-        lowPage = lowPage.findPrev({ combineConsecutiveUnviewables: true });
-      }
-
-      if (highPage) {
-        this.createPageContainer(highPage.index);
-        highPage = highPage.findNext({ combineConsecutiveUnviewables: true });
-      }
-    }
-  }
-
-  /* 2up Container Sizes */
-
-  /** main positions for inner containers */
-  get baseLeafCss() {
-    return {
-      position: 'absolute',
-      right: '',
-      top: `${this.top()}px`,
-      zIndex: 2,
-    };
-  }
-
-  /** main height for inner containers */
-  get heightCss() {
-    return {
-      height: `${this.br.twoPage.height}px`, // $$$ height forced the same for both pages
-    };
-  }
-
-  /** Left Page sizing */
-  get leftLeafCss() {
-    return {
-      ...this.baseLeafCss,
-      ...this.heightCss,
-      left: `${this.br.twoPage.gutter - this.br.twoPage.scaledWL}px`,
-      width: `${this.br.twoPage.scaledWL}px`,
-    };
-  }
-
-  /** Left side book thickness */
-  get leafEdgeLCss() {
-    return {
-      ...this.heightCss,
-      width: `${this.br.twoPage.leafEdgeWidthL}px`,
-      left: `${this.br.twoPage.bookCoverDivLeft + this.br.twoPage.coverInternalPadding}px`,
-      top: `${this.br.twoPage.bookCoverDivTop + this.br.twoPage.coverInternalPadding}px`,
-      border: this.br.twoPage.leafEdgeWidthL === 0 ? 'none' : null
-    };
-  }
-
-  /** Right Page sizing */
-  get rightLeafCss() {
-    return {
-      ...this.baseLeafCss,
-      ...this.heightCss,
-      left: `${this.br.twoPage.gutter}px`,
-      width: `${this.br.twoPage.scaledWR}px`,
-    };
-  }
-
-  /** Right side book thickness */
-  get leafEdgeRCss() {
-    return {
-      ...this.heightCss,
-      width: `${this.br.twoPage.leafEdgeWidthR}px`,
-      left: `${this.br.twoPage.scaledWL + this.br.twoPage.scaledWR + this.br.twoPage.leafEdgeWidthL}px`,
-      top: `${this.br.twoPage.bookCoverDivTop + this.br.twoPage.coverInternalPadding}px`,
-      border: this.br.twoPage.leafEdgeWidthR === 0 ? 'none' : null
-    };
-  }
-
-  /** main container sizing */
-  get mainContainerCss() {
-    return {
-      height: `${this.br.twoPage.totalHeight}px`,
-      width: `${this.br.twoPage.totalWidth}px`,
-      position: 'absolute'
-    };
-  }
-
-  /** book cover sizing */
-  get spreadCoverCss() {
-    return {
-      width: `${this.br.twoPage.bookCoverDivWidth}px`,
-      height: `${this.br.twoPage.bookCoverDivHeight}px`,
-      visibility: 'visible'
-    };
-  }
-
-  /** book spine sizing */
-  get spineCss() {
-    return {
-      width: `${this.br.twoPage.bookSpineDivWidth}px`,
-      height: `${this.br.twoPage.bookSpineDivHeight}px`,
-      left: `${this.br.twoPage.gutter - (this.br.twoPage.bookSpineDivWidth / 2)}px`,
-      top: `${this.br.twoPage.bookSpineDivTop}px`
-    };
-  }
-  /** end CSS */
-}
-
-/**
- * @implements {BookReaderOptions["twoPage"]}
- * @typedef {object} TwoPageState
- * @property {number} coverInternalPadding
- * @property {number} coverExternalPadding
- *
- * @property {import('./options.js').AutoFitValues} autofit
- * @property {number} width
- * @property {number} height
- * @property {number} currentIndexL
- * @property {number} currentIndexR
- * @property {number} scaledWL
- * @property {number} scaledWR
- * @property {number} gutter
- * @property {Array<{reduce: number, autofit: import('./options.js').AutoFitValues}>} reductionFactors
- * @property {number} totalHeight
- * @property {number} totalWidth
- *
- * @property {HTMLDivElement} coverDiv
- * @property {number} bookCoverDivTop
- * @property {number} bookCoverDivLeft
- * @property {number} bookCoverDivWidth
- * @property {number} bookCoverDivHeight
- *
- * @property {number} leafEdgeWidthL
- * @property {number} leafEdgeWidthR
- *
- * @property {number} bookSpineDivTop
- * @property {number} bookSpineDivLeft
- * @property {number} bookSpineDivWidth
- * @property {number} bookSpineDivHeight
- *
- * @property {number} edgeWidth
- * @property {number} middle
- */