@internetarchive/bookreader 5.0.0-3 → 5.0.0-30-a

package/src/BookNavigator/book-navigator.js

@@ -0,0 +1,528 @@
+// eslint-disable-next-line no-unused-vars
+import { SharedResizeObserver } from '@internetarchive/shared-resize-observer';
+// eslint-disable-next-line no-unused-vars
+import { ModalManager } from '@internetarchive/modal-manager';
+import { css, html, LitElement } from 'lit-element';
+import SearchProvider from './search/search-provider.js';
+import DownloadProvider from './downloads/downloads-provider.js';
+import VisualAdjustmentProvider from './visual-adjustments/visual-adjustments-provider.js';
+import BookmarksProvider from './bookmarks/bookmarks-provider.js';
+import SharingProvider from './sharing.js';
+import VolumesProvider from './volumes/volumes-provider.js';
+import iaLogo from './assets/ia-logo.js';
+
+const events = {
+  menuUpdated: 'menuUpdated',
+  updateSideMenu: 'updateSideMenu',
+  PostInit: 'PostInit',
+  ViewportInFullScreen: 'ViewportInFullScreen',
+};
+export class BookNavigator extends LitElement {
+  static get properties() {
+    return {
+      itemMD: { type: Object },
+      bookReaderLoaded: { type: Boolean },
+      bookreader: { type: Object },
+      bookIsRestricted: { type: Boolean },
+      downloadableTypes: { type: Array },
+      isAdmin: { type: Boolean },
+      lendingInitialized: { type: Boolean },
+      lendingStatus: { type: Object },
+      menuProviders: { type: Object },
+      menuShortcuts: { type: Array },
+      signedIn: { type: Boolean },
+      loaded: { type: Boolean },
+      sharedObserver: { type: Object, attribute: false },
+      modal: { type: Object, attribute: false },
+      fullscreenBranding: { type: Object },
+    };
+  }
+
+  constructor() {
+    super();
+    this.itemMD = undefined;
+    this.loaded = false;
+    this.bookReaderCannotLoad = false;
+    this.bookReaderLoaded = false;
+    this.bookreader = null;
+    this.bookIsRestricted = false;
+    this.downloadableTypes = [];
+    this.isAdmin = false;
+    this.lendingInitialized = false;
+    this.lendingStatus = {};
+    this.menuProviders = {};
+    this.menuShortcuts = [];
+    this.signedIn = false;
+    /** @type {ModalManager} */
+    this.modal = undefined;
+    /** @type {SharedResizeObserver} */
+    this.sharedObserver = undefined;
+    this.fullscreenBranding = iaLogo;
+    // Untracked properties
+    this.sharedObserverHandler = undefined;
+    this.brWidth = 0;
+    this.brHeight = 0;
+    this.shortcutOrder = [
+      /**
+       * sets exit FS button (`this.fullscreenBranding1)
+       * when `br.options.enableFSLogoShortcut`
+       */
+      'fullscreen',
+      'volumes',
+      'search',
+      'bookmarks'
+    ];
+  }
+
+  disconnectedCallback() {
+    this.sharedObserver.removeObserver({
+      target: this.mainBRContainer,
+      handler: this.sharedObserverHandler
+    });
+  }
+
+  firstUpdated() {
+    this.bindEventListeners();
+    this.emitPostInit();
+    this.loaded = true;
+  }
+
+  updated(changed) {
+    if (!this.bookreader || !this.itemMD || !this.bookReaderLoaded) {
+      return;
+    }
+
+    const reload = changed.has('loaded') && this.loaded;
+    if (reload
+      || changed.has('itemMD')
+      || changed.has('bookreader')
+      || changed.has('signedIn')
+      || changed.has('isAdmin')
+      || changed.has('modal')) {
+      this.initializeBookSubmenus();
+    }
+
+    if (changed.has('sharedObserver') && this.bookreader) {
+      this.loadSharedObserver();
+    }
+  }
+
+  /**
+   * Global event emitter for when Book Navigator loads
+   */
+  emitPostInit() {
+    // emit global event when book nav has loaded with current bookreader selector
+    this.dispatchEvent(new CustomEvent(`BrBookNav:${events.PostInit}`, {
+      detail: { brSelector: this.bookreader?.el },
+      bubbles: true,
+      composed: true,
+    }));
+  }
+
+  /**
+   *  @typedef {{
+   *  baseHost: string,
+   *  modal: ModalManager,
+   *  sharedObserver: SharedResizeObserver,
+   *  bookreader: BookReader,
+   *  item: Item,
+   *  signedIn: boolean,
+   *  isAdmin: boolean,
+   *  onProviderChange: (BookReader, object) => void,
+   *  }} baseProviderConfig
+   *
+   * @return {baseProviderConfig}
+   */
+  get baseProviderConfig() {
+    return  {
+      baseHost: this.baseHost,
+      modal: this.modal,
+      sharedObserver: this.sharedObserver,
+      bookreader: this.bookreader,
+      item: this.itemMD,
+      signedIn: this.signedIn,
+      isAdmin: this.isAdmin,
+      onProviderChange: () => {}
+    };
+  }
+
+  /**
+   * Instantiates books submenus & their update callbacks
+   *
+   * NOTE: we are doing our best to scope bookreader's instance.
+   * If your submenu provider uses a bookreader instance to read, manually
+   * manipulate BookReader, please update the navigator's instance of it
+   * to keep it in sync.
+   */
+  initializeBookSubmenus() {
+    const providers = {
+      downloads: new DownloadProvider(this.baseProviderConfig),
+      share: new SharingProvider(this.baseProviderConfig),
+      visualAdjustments: new VisualAdjustmentProvider({
+        ...this.baseProviderConfig,
+        /** Update menu contents */
+        onProviderChange: () => {
+          this.updateMenuContents();
+        },
+      }),
+    };
+
+    if (this.bookreader.options.enableSearch) {
+      providers.search = new SearchProvider({
+        ...this.baseProviderConfig,
+        /**
+         * Search specific menu updates
+         * @param {BookReader} brInstance
+         * @param {{ searchCanceled: boolean }} searchUpdates
+         */
+        onProviderChange: (brInstance = null, searchUpdates = {}) => {
+          if (brInstance) {
+            /* refresh br instance reference */
+            this.bookreader = brInstance;
+          }
+          const wideEnoughToOpenMenu = this.brWidth >= 640;
+          if (wideEnoughToOpenMenu && !searchUpdates?.searchCanceled) {
+            /* open side search menu */
+            setTimeout(() => {
+              this.updateSideMenu('search', 'open');
+            }, 0);
+          }
+          this.updateMenuContents();
+        },
+      });
+    }
+
+    if (this.bookreader.options.enableBookmarks) {
+      providers.bookmarks = new BookmarksProvider({
+        ...this.baseProviderConfig,
+        onProviderChange: (bookmarks) => {
+          const method = Object.keys(bookmarks).length ? 'add' : 'remove';
+          this[`${method}MenuShortcut`]('bookmarks');
+          this.updateMenuContents();
+        }
+      });
+    }
+
+    // add shortcut for volumes if multipleBooksList exists
+    if (this.bookreader.options.enableMultipleBooks) {
+      providers.volumes = new VolumesProvider({
+        ...this.baseProviderConfig,
+        onProviderChange: (brInstance = null, volumesUpdates = {}) => {
+          if (brInstance) {
+            /* refresh br instance reference */
+            this.bookreader = brInstance;
+          }
+          this.updateMenuContents();
+          this.updateSideMenu('volumes', 'open');
+        }
+      });
+    }
+
+    this.menuProviders = providers;
+    this.addMenuShortcut('search');
+    this.addMenuShortcut('volumes');
+    this.updateMenuContents();
+  }
+
+  /** gets element that houses the bookreader in light dom */
+  get mainBRContainer() {
+    return document.querySelector(this.bookreader?.el);
+  }
+
+  /** Fullscreen Shortcut */
+  addFullscreenShortcut() {
+    const closeFS = {
+      icon: this.fullscreenShortcut,
+      id: 'fullscreen',
+    };
+    this.menuShortcuts.push(closeFS);
+    this.sortMenuShortcuts();
+    this.emitMenuShortcutsUpdated();
+  }
+
+  deleteFullscreenShortcut() {
+    const updatedShortcuts = this.menuShortcuts.filter(({ id }) => {
+      return id !== 'fullscreen';
+    });
+    this.menuShortcuts = updatedShortcuts;
+    this.sortMenuShortcuts();
+    this.emitMenuShortcutsUpdated();
+  }
+
+  closeFullscreen() {
+    this.bookreader.exitFullScreen();
+  }
+
+  get fullscreenShortcut() {
+    return html`
+      <button
+        @click=${() => this.closeFullscreen()}
+        title="Exit fullscreen view"
+      >${this.fullscreenBranding}</button>
+    `;
+  }
+  /** End Fullscreen Shortcut */
+
+  /**
+   * Open side menu
+   * @param {string} menuId
+   * @param {('open'|'close'|'toggle')} action
+   */
+  updateSideMenu(menuId = '', action = 'open') {
+    if (!menuId) {
+      return;
+    }
+    const event = new CustomEvent(
+      events.updateSideMenu, {
+        detail: { menuId, action },
+      },
+    );
+    this.dispatchEvent(event);
+  }
+
+  /**
+   * Sets order of menu and emits custom event when done
+   */
+  updateMenuContents() {
+    const {
+      search, downloads, visualAdjustments, share, bookmarks, volumes
+    } = this.menuProviders;
+    const availableMenus = [volumes, search, bookmarks, visualAdjustments, share].filter((menu) => !!menu);
+
+    if (this.shouldShowDownloadsMenu()) {
+      downloads?.update(this.downloadableTypes);
+      availableMenus.splice(1, 0, downloads);
+    }
+
+    const event = new CustomEvent(
+      events.menuUpdated, {
+        detail: availableMenus,
+      },
+    );
+    this.dispatchEvent(event);
+  }
+
+  /**
+   * Confirms if we should show the downloads menu
+   * @returns {bool}
+   */
+  shouldShowDownloadsMenu() {
+    if (this.bookIsRestricted === false) { return true; }
+    if (this.isAdmin) { return true; }
+    const { user_loan_record = {} } = this.lendingStatus;
+    const hasNoLoanRecord = Array.isArray(user_loan_record); /* (bc PHP assoc. arrays) */
+
+    if (hasNoLoanRecord) { return false; }
+
+    const hasValidLoan = user_loan_record.type && (user_loan_record.type !== 'SESSION_LOAN');
+    return hasValidLoan;
+  }
+
+  /**
+   * Adds a provider object to the menuShortcuts array property if it isn't
+   * already added. menuShortcuts are then sorted by shortcutOrder and
+   * a menuShortcutsUpdated event is emitted.
+   *
+   * @param {string} menuId - a string matching the id property of a provider
+   */
+  addMenuShortcut(menuId) {
+    if (this.menuShortcuts.find((m) => m.id === menuId)) {
+      // menu is already there
+      return;
+    }
+
+    if (!this.menuProviders[menuId]) {
+      // no provider for this menu
+      return;
+    }
+
+    this.menuShortcuts.push(this.menuProviders[menuId]);
+
+    this.sortMenuShortcuts();
+    this.emitMenuShortcutsUpdated();
+  }
+
+  /**
+   * Removes a provider object from the menuShortcuts array and emits a
+   * menuShortcutsUpdated event.
+   *
+   * @param {string} menuId - a string matching the id property of a provider
+   */
+  removeMenuShortcut(menuId) {
+    this.menuShortcuts = this.menuShortcuts.filter((m) => m.id !== menuId);
+    this.emitMenuShortcutsUpdated();
+  }
+
+  /**
+   * Sorts the menuShortcuts property by comparing each provider's id to
+   * the id in each iteration over the shortcutOrder array.
+   */
+  sortMenuShortcuts() {
+    this.menuShortcuts = this.shortcutOrder.reduce((shortcuts, id) => {
+      const menu = this.menuShortcuts.find((m) => m.id === id);
+      if (menu) { shortcuts.push(menu); }
+      return shortcuts;
+    }, []);
+  }
+
+  emitMenuShortcutsUpdated() {
+    const event = new CustomEvent('menuShortcutsUpdated', {
+      detail: this.menuShortcuts,
+    });
+    this.dispatchEvent(event);
+  }
+
+  emitLoadingStatusUpdate(loaded) {
+    const event = new CustomEvent('loadingStateUpdated', {
+      detail: { loaded },
+    });
+    this.dispatchEvent(event);
+  }
+
+  /**
+   * Core bookreader event handler registry
+   *
+   * NOTE: we are trying to keep bookreader's instance in scope
+   * Please update Book Navigator's instance reference of it to keep it current
+   */
+  bindEventListeners() {
+    window.addEventListener('BookReader:PostInit', (e) => {
+      this.bookreader = e.detail.props;
+      this.bookReaderLoaded = true;
+      this.bookReaderCannotLoad = false;
+      this.emitLoadingStatusUpdate(true);
+      this.loadSharedObserver();
+      setTimeout(() => {
+        this.bookreader.resize();
+      }, 0);
+    });
+    window.addEventListener('BookReader:fullscreenToggled', (event) => {
+      const { detail: { props: brInstance = null } } = event;
+      if (brInstance) {
+        this.bookreader = brInstance;
+      }
+      this.manageFullScreenBehavior();
+    }, { passive: true });
+    window.addEventListener('BookReader:ToggleSearchMenu', (event) => {
+      this.dispatchEvent(new CustomEvent(events.updateSideMenu, {
+        detail: { menuId: 'search', action: 'toggle' },
+      }));
+    });
+    window.addEventListener('LendingFlow:PostInit', ({ detail }) => {
+      const {
+        downloadTypesAvailable, lendingStatus, isAdmin, previewType,
+      } = detail;
+      this.lendingInitialized = true;
+      this.downloadableTypes = downloadTypesAvailable;
+      this.lendingStatus = lendingStatus;
+      this.isAdmin = isAdmin;
+      this.bookReaderCannotLoad = previewType === 'singlePagePreview';
+    });
+    window.addEventListener('BRJSIA:PostInit', ({ detail }) => {
+      const { isRestricted, downloadURLs } = detail;
+      this.bookReaderLoaded = true;
+      this.downloadableTypes = downloadURLs;
+      this.bookIsRestricted = isRestricted;
+    });
+  }
+
+  loadSharedObserver() {
+    this.sharedObserverHandler = { handleResize: this.handleResize.bind(this) };
+    this.sharedObserver?.addObserver({
+      target: this.mainBRContainer,
+      handler: this.sharedObserverHandler
+    });
+  }
+
+  /**
+   * Uses resize observer to fire BookReader's `resize` functionality
+   * We do not want to trigger resize IF:
+   *  - book animation is happening
+   *  - book is in fullscreen (fullscreen is handled separately)
+   *
+   * @param { target: HTMLElement, contentRect: DOMRectReadOnly } entry
+   */
+  handleResize({ contentRect, target }) {
+    const startBrWidth = this.brWidth;
+    const startBrHeight = this.brHeight;
+    const { animating } = this.bookreader;
+
+    if (target === this.mainBRContainer) {
+      this.brWidth = contentRect.width;
+      this.brHeight = contentRect.height;
+    }
+
+    const widthChange = startBrWidth !== this.brWidth;
+    const heightChange = startBrHeight !== this.brHeight;
+
+    if (!animating && (widthChange || heightChange)) {
+      this.bookreader.resize();
+    }
+  }
+
+  /**
+   * Manages Fullscreen behavior
+   * This makes sure that controls are _always_ in view
+   * We need this to accommodate LOAN BAR during fullscreen
+   */
+  manageFullScreenBehavior() {
+    this.emitFullScreenState();
+
+    if (!this.bookreader.options.enableFSLogoShortcut) {
+      return;
+    }
+
+    const isFullScreen = this.bookreader.isFullscreen();
+    if (isFullScreen) {
+      this.addFullscreenShortcut();
+    } else {
+      this.deleteFullscreenShortcut();
+    }
+  }
+
+  /**
+   * Relays fullscreen toggle events
+   */
+  emitFullScreenState() {
+    const isFullScreen = this.bookreader.isFullscreen();
+    const event = new CustomEvent('ViewportInFullScreen', {
+      detail: { isFullScreen },
+    });
+    this.dispatchEvent(event);
+  }
+
+  get loadingClass() {
+    return !this.bookReaderLoaded ? 'loading' : '';
+  }
+
+  get itemImage() {
+    const url = `https://${this.baseHost}/services/img/${this.item.metadata.identifier}`;
+    return html`<img class="cover-img" src=${url} alt="cover image for ${this.item.metadata.identifier}">`;
+  }
+
+  render() {
+    const placeholder = this.bookReaderCannotLoad ? this.itemImage : this.loader;
+    return html`<div id="book-navigator" class="${this.loadingClass}">
+      ${placeholder}
+      <slot name="theater-main"></slot>
+    </div>
+  `;
+  }
+
+  static get styles() {
+    return css`
+    :host,
+    #book-navigator,
+    slot,
+    slot > * {
+      display: block;
+      height: inherit;
+    }
+    .cover-img {
+      max-height: 300px;
+    }
+  `;
+  }
+}
+
+customElements.define('book-navigator', BookNavigator);

package/src/BookNavigator/bookmarks/bookmark-button.js

@@ -12,7 +12,7 @@ export default class BookmarkButton extends LitElement {
         height: 4rem;
         width: 4rem;
         background: transparent;
-        cursor: url('/images/bookreader/bookmark-add.png'), pointer;
+        cursor: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' height='24' viewBox='0 0 16 24' width='16'%3E%3Cg fill='%23333' fill-rule='evenodd'%3E%3Cpath d='m15 0c.5522847 0 1 .44771525 1 1v23l-8-5.4545455-8 5.4545455v-23c0-.55228475.44771525-1 1-1zm-2 2h-10c-.51283584 0-.93550716.38604019-.99327227.88337887l-.00672773.11662113v18l6-4.3181818 6 4.3181818v-18c0-.51283584-.3860402-.93550716-.8833789-.99327227z'/%3E%3Cpath d='m8.75 6v2.25h2.25v1.5h-2.25v2.25h-1.5v-2.25h-2.25v-1.5h2.25v-2.25z' fill-rule='nonzero'/%3E%3C/g%3E%3C/svg%3E"), pointer;
         position: relative;
       }
       button > * {
@@ -40,6 +40,7 @@ export default class BookmarkButton extends LitElement {
   constructor() {
     super();
     this.state = 'hollow';
+    this.side = undefined;
   }
 
   handleClick(e) {

package/src/BookNavigator/bookmarks/bookmark-edit.js

@@ -208,7 +208,8 @@ export class IABookmarkEdit extends LitElement {
       grid-gap: 0 1rem;
       justify-items: stretch;
     }
-    `
+    `;
     return [buttonCSS, bookmarkColorsCSS, bookmarkEditCSS];
   }
 }
+customElements.define('ia-bookmark-edit', IABookmarkEdit);

package/src/BookNavigator/bookmarks/bookmarks-list.js

@@ -282,3 +282,4 @@ export class IABookmarksList extends LitElement {
     return [main, bookmarkColorsCSS];
   }
 }
+customElements.define('ia-bookmarks-list', IABookmarksList);

package/src/BookNavigator/bookmarks/bookmarks-loginCTA.js

@@ -1,20 +1,15 @@
-import { LitElement, html, css } from 'lit-element';
+import { LitElement, html } from 'lit-element';
 import buttonStyles from '../assets/button-base.js';
 
 class BookmarksLogin extends LitElement {
   static get properties() {
     return {
       url: { type: String }
-    }
+    };
   }
 
   static get styles() {
-    const mainCss = css`
-      a {
-        text-decoration: none;
-      }
-    `;
-    return [buttonStyles, mainCss];
+    return buttonStyles;
   }
 
   constructor() {
@@ -25,7 +20,7 @@ class BookmarksLogin extends LitElement {
 
     return html`
       <p>A free account is required to save and access bookmarks.</p>
-      <a class="ia-button link primary" href=${this.url}>Log in</a>
+      <a class="ia-button link primary" href="${this.url}">Log in</a>
     `;
   }
 }

package/src/BookNavigator/bookmarks/bookmarks-provider.js

@@ -3,26 +3,39 @@ import '../delete-modal-actions.js';
 import './bookmark-button.js';
 import './ia-bookmarks.js';
 
-import { IABookmarkEdit } from './bookmark-edit.js';
-import { IABookmarksList } from './bookmarks-list.js';
+import './bookmark-edit.js';
+import './bookmarks-list.js';
 import { IAIconBookmark } from '@internetarchive/icon-bookmark';
 
-customElements.define('ia-bookmark-edit', IABookmarkEdit);
-customElements.define('ia-bookmarks-list', IABookmarksList);
 customElements.define('icon-bookmark', IAIconBookmark);
 
 export default class BookmarksProvider {
-  constructor(options, bookreader) {
-    const boundOptions = Object.assign(this, options);
+  constructor(options) {
+    const {
+      baseHost,
+      signedIn,
+      bookreader,
+      modal,
+      onProviderChange
+    } = options;
+
+    const referrerStr = `referer=${encodeURIComponent(location.href)}`;
+    const loginUrl = `https://${baseHost}/account/login?${referrerStr}`;
+
     this.component = document.createElement('ia-bookmarks');
     this.component.bookreader = bookreader;
-    this.component.options = boundOptions;
-
+    this.component.displayMode = signedIn ? 'bookmarks' : 'login';
+    this.component.modal = modal;
+    this.component.loginOptions = {
+      loginClicked: this.bookmarksLoginClicked,
+      loginUrl
+    };
     this.bindEvents();
 
     this.icon = html`<icon-bookmark state="hollow" style="--iconWidth: 16px; --iconHeight: 24px;"></icon-bookmark>`;
     this.label = 'Bookmarks';
     this.id = 'bookmarks';
+    this.onProviderChange = onProviderChange;
     this.component.setup();
     this.updateMenu(this.component.bookmarks.length);
   }
@@ -33,13 +46,21 @@ export default class BookmarksProvider {
 
   bindEvents() {
     this.component.addEventListener('bookmarksChanged', this.bookmarksChanged.bind(this));
-    this.component.addEventListener('showItemNavigatorModal', this.showItemNavigatorModal);
-    this.component.addEventListener('closeItemNavigatorModal', this.closeItemNavigatorModal);
   }
 
   bookmarksChanged({ detail }) {
     const bookmarksLength = Object.keys(detail.bookmarks).length;
     this.updateMenu(bookmarksLength);
-    this.onBookmarksChanged(detail.bookmarks);
+    this.onProviderChange(detail.bookmarks, detail.showSidePanel);
+  }
+
+  bookmarksLoginClicked() {
+    if (window.archive_analytics) {
+      window.archive_analytics?.send_event_no_sampling(
+        'BookReader',
+        `BookmarksLogin`,
+        window.location.path,
+      );
+    }
   }
 }