@internetarchive/bookreader 5.0.0-88-alpha.8 → 5.0.0-88-alpha.10

package/dist/esm/BookReader/utils.js

@@ -0,0 +1,315 @@
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+/**
+ * Bind mouse handlers
+ * Disable mouse click to avoid selected/highlighted page images
+ * @param {JQuery} jObject
+ */
+export function disableSelect(jObject) {
+  // $$$ check here for right-click and don't disable.  Also use jQuery style
+  //     for stopping propagation. See https://bugs.edge.launchpad.net/gnubook/+bug/362626
+  jObject.bind('mousedown', () => false);
+  // Special hack for IE7
+  jObject[0].onselectstart = () => false;
+}
+
+/**
+ * @param {number} value
+ * @param {number} min
+ * @param {number} max
+ * @return {number}
+ */
+export function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+
+/**
+ * Given value and maximum, calculate a percentage suitable for CSS
+ * @param {number} value
+ * @param {number} max
+ * @return {string}
+ */
+export function cssPercentage(value, max) {
+  return value / max * 100 + '%';
+}
+
+/**
+ * @param {*} value
+ * @param {Array} array
+ * @return {boolean}
+ */
+export function notInArray(value, array) {
+  return !array.includes(value);
+}
+
+/**
+ * Determines the active element, going into shadow doms.
+ * @return {Element}
+ */
+export function getActiveElement() {
+  var doc = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : document;
+  var recurseShadowDom = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+  var activeElement = doc.activeElement;
+  if (recurseShadowDom && activeElement !== null && activeElement !== void 0 && activeElement.shadowRoot) {
+    return getActiveElement(activeElement.shadowRoot, true);
+  }
+  return activeElement;
+}
+
+/** Check if an input field/textarea is active. Also checks shadow DOMs. */
+export function isInputActive() {
+  var doc = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : document;
+  var activeEl = getActiveElement(doc);
+  return (activeEl === null || activeEl === void 0 ? void 0 : activeEl.tagName) == "INPUT" || (activeEl === null || activeEl === void 0 ? void 0 : activeEl.tagName) == "TEXTAREA";
+}
+
+/**
+ * @param {HTMLIFrameElement} iframe
+ * @return {Document}
+ */
+export function getIFrameDocument(iframe) {
+  // Adapted from http://xkr.us/articles/dom/iframe-document/
+  var outer = iframe.contentWindow || iframe.contentDocument;
+  return outer.document || outer;
+}
+
+/**
+ * @param {string} str
+ * @return {string}
+ */
+export function escapeHTML(str) {
+  return str.replace(/&/g, '&amp;').replace(/>/g, '&gt;').replace(/</g, '&lt;').replace(/"/g, '&quot;');
+}
+
+/**
+ * Decodes a URI component and converts '+' to ' '
+ * @param {string} value
+ * @return {string}
+ */
+export function decodeURIComponentPlus(value) {
+  return decodeURIComponent(value).replace(/\+/g, ' ');
+}
+
+/**
+ * Encodes a URI component and converts ' ' to '+'
+ * @param {string|number|boolean} value
+ * @return {string};
+ */
+export function encodeURIComponentPlus(value) {
+  return encodeURIComponent(value).replace(/%20/g, '+');
+}
+
+/**
+ * @template {Function} T
+ * Returns a function, that, as long as it continues to be invoked, will not
+ * be triggered. The function will be called after it stops being called for
+ * N milliseconds. If `immediate` is passed, trigger the function on the
+ * leading edge, instead of the trailing.
+ * @see https://davidwalsh.name/javascript-debounce-function
+ *
+ * @param {T} func
+ * @param {number} wait
+ * @param {boolean} immediate
+ * @return {T}
+ */
+export function debounce(func, wait, immediate) {
+  var timeout;
+  return function () {
+    var context = this;
+    var args = arguments;
+    var later = () => {
+      timeout = null;
+      if (!immediate) func.apply(context, args);
+    };
+    var callNow = immediate && !timeout;
+    clearTimeout(timeout);
+    timeout = setTimeout(later, wait);
+    if (callNow) func.apply(context, args);
+  };
+}
+
+/**
+ * @template T
+ * Throttle function
+ * @see https://remysharp.com/2010/07/21/throttling-function-calls
+ * @param {T} fn
+ * @param {number} threshold
+ * @param {boolean} delay
+ * @return {T}
+ */
+export function throttle(fn, threshold, delay) {
+  threshold || (threshold = 250);
+  var last;
+  var deferTimer;
+  if (delay) last = +new Date();
+  return function () {
+    var context = this;
+    var now = +new Date();
+    var args = arguments;
+    if (last && now < last + threshold) {
+      // hold on to it
+      clearTimeout(deferTimer);
+      deferTimer = setTimeout(() => {
+        last = now;
+        fn.apply(context, args);
+      }, threshold);
+    } else {
+      last = now;
+      fn.apply(context, args);
+    }
+  };
+}
+
+/**
+ * FIXME we need a better way to do this :/ This is not automatically poly-filled by
+ * core-js https://github.com/zloirock/core-js/issues/354
+ * @param {Window} window
+ */
+export function polyfillCustomEvent(window) {
+  if (typeof window.CustomEvent === "function") return false;
+  window.CustomEvent = PolyfilledCustomEvent;
+}
+
+/**
+ * https://caniuse.com/customevent has issues on older browsers where it can't be
+ * called as a constructor, so we have to use older methods.
+ * @param {String} eventName
+ * @return {CustomEvent}
+ */
+export function PolyfilledCustomEvent(eventName) {
+  var {
+    bubbles = false,
+    cancelable = false,
+    detail = null
+  } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var event = document.createEvent('CustomEvent');
+  event.initCustomEvent(eventName, bubbles, cancelable, detail);
+  return event;
+}
+
+/*
+ * Returns the number pixels something should be rendered at to be ~1n on the users
+ * screen when measured with a ruler.
+ */
+export function calcScreenDPI() {
+  var el = document.createElement('div');
+  el.style.width = '1in';
+  document.body.appendChild(el);
+  var dpi = el.offsetWidth;
+  document.body.removeChild(el);
+
+  // Do you believe in magic... numbers? We tested on some devices, and the displayed
+  // size of `width: 1in` was less than desired. On @pezvi's mac, it was ~75% ; on
+  // @cdrini's laptop it was ~85%. Since we want to avoid things appearing too small,
+  // let's just use a multiplier of 1.25
+  var screenDPI = dpi * 1.25;
+  // This will return 0 in testing; never want it to be 0!
+  return screenDPI == 0 ? 100 : screenDPI;
+}
+
+/**
+ * @param {number[]} nums
+ * @returns {number}
+ */
+export function sum(nums) {
+  return nums.reduce((cur, acc) => cur + acc, 0);
+}
+
+/**
+ * @template T
+ * @param {Generator<T>} gen
+ * @returns {T[]}
+ */
+export function genToArray(gen) {
+  var result = [];
+  for (var item of gen) {
+    result.push(item);
+  }
+  return result;
+}
+
+/**
+ * Check if arrays contain the same elements. Does reference comparison.
+ * @param {Array} arr1
+ * @param {Array} arr2
+ */
+export function arrEquals(arr1, arr2) {
+  return arr1.length == arr2.length && arr1.every((x, i) => x == arr2[i]);
+}
+
+/**
+ * Check if array has changed; namely to be used with lit's property.hasChanged
+ * @param {Array} [arr1]
+ * @param {Array} [arr2]
+ */
+export function arrChanged(arr1, arr2) {
+  return arr1 && arr2 && !arrEquals(arr1, arr2);
+}
+
+/**
+ * Waits the provided number of ms and then resolves with a promise
+ * @param {number} ms
+ **/
+export function sleep(_x) {
+  return _sleep2.apply(this, arguments);
+}
+
+/**
+ * @template T
+ * @param {function(): T} fn
+ * @param {Object} options
+ * @param {function(T): boolean} [options.until]
+ * @return {T | undefined}
+ */
+function _sleep2() {
+  _sleep2 = _asyncToGenerator(function* (ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+  });
+  return _sleep2.apply(this, arguments);
+}
+export function poll(_x2) {
+  return _poll.apply(this, arguments);
+}
+
+/**
+ * Convert a EventTarget style event into a promise
+ * @param {EventTarget} target
+ * @param {string} eventType
+ * @return {Promise<Event>}
+ */
+function _poll() {
+  _poll = _asyncToGenerator(function* (fn) {
+    var {
+      step = 50,
+      timeout = 500,
+      until = val => Boolean(val),
+      _sleep = sleep
+    } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    var startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+      var result = fn();
+      if (until(result)) return result;
+      yield _sleep(step);
+    }
+  });
+  return _poll.apply(this, arguments);
+}
+export function promisifyEvent(target, eventType) {
+  return new Promise(res => {
+    var resolver = ev => {
+      target.removeEventListener(eventType, resolver);
+      res(ev);
+    };
+    target.addEventListener(eventType, resolver);
+  });
+}
+
+/**
+ * Escapes regex special characters in a string. Allows for safe usage in regexes.
+ * Src: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_expressions
+ * @param {string} string
+ * @returns {string}
+ */
+export function escapeRegExp(string) {
+  return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"); // $& means the whole matched string
+}