Chore/kill yalc with fire (#629)

* init * more shifting * Move @babel dependencies up to workspace root * Begin updating dependent libraries to use sync'd webpack builds w/ watches * Commit changes before a long weekend * Split packages into platform and extensions * Consolidate how/where we specify file/module type entrypoints * Make it possible to pass in extensions as App props * Resolve viewer's modules * Target for UMD bundle * Add Webpack Stylus loader * Provide WebPack build options for microscopy, vtk, and ui * Better entrypoint for extensions * Push changes up to switch PCs * Fix ESM symlink build for Viewers * Shift docs to root * Specify additional lerna config props * Begin providing basic readme info * Rename example extension folder * Shift links to bottom of doc * First attempt at a netlify deploy preview * Attempt to fix deploy preview build * push workspace enabled to initial command; remove second yarn install; use npx to call gitbook cli commands * Try to use global gitbook-cli * Export node_modules path * More agressive with modifying PATH * Follow deploy log output advice * try again to set bin path * Try swapping bash with a new shell * Try bash -l instead of exec bash * Annd let's try again * and again * We may have figured it out johnny, boy * We need to pull cornerstone-wado-image-loader files from hoisted node_modules * Attempt to fix ticks/escapes * Change copy syntax; try running tests on viewers from root for circleci * Lower version to match circleci image * Try alternative jest-canvas-mock location and version file syntax * Run version command instead of calling node directly * Try alternative jest transform * Set path and enable workspaces * Add codecov flags * Use cpx so our copying finishes? * Get all platform unit tests to run * Run and report individually and in parallel * Try once relying on codecov yaml to split w/ flags * Add projects to split by flags * Generate separate reports * Trigger codecov after everything has finished running; these may not support flags * Use recommended flags from issue comments for codecov * Fix typo * Remove clear flag * Shift back to calling codecov from root * Generate example for codecov issue * Try fixing paths * Simplify * Try using codecov orb * Bump circleci version * Upload core and viewer * Use full string paths * Remove individual codecov calls * Fix dir * Combine files before upload * Escape anchors * tryfix syntax * Escape string literal * Combine lines to reduce path * long paths * Use home alias * Fix filename * Try to see the contents of our cat'd file * Also upload `core` * Try running with aliased folder * Fix path; split PR and Merge unit tests into separate jobs * Set default threshold * Fix typo * Changing to scoped package names * Adding note * Catch more updates * chore(release): publish %s [skip ci] - @ohif/extension-cornerstone@0.0.39-alpha.0 - @ohif/extension-dicom-html@0.0.4-alpha.0 - @ohif/extension-dicom-microscopy@0.0.9-alpha.0 - @ohif/extension-dicom-pdf@0.0.8-alpha.0 - @ohif/extension-vtk@0.1.4-alpha.0 - @ohif/core@0.11.1-alpha.0 - @ohif/i18n@0.2.3-alpha.0 - @ohif/ui@0.2.18-alpha.0 - @ohif/viewer@0.0.22-alpha.0 * Clean up primary readme * Support for dev and dev:* commands * Shift build command; satisfy default PWA build * Remove old scripts * Clean up UI to set webpack scripts * Tidy up project links * Clean duplicate code in UI project * Update UI project's docs * Clean up ui and i18n config * Reduce duplicate code in `@ohif/core` * Fix @ohif/ui versions * bump @ohif/core versions * Redux testkit dep * Remove unused/duplicate config files for projects/packages * ohif-core --> @ohif/core * Safer publish command * chore(release): publish %s [skip ci] - @ohif/extension-cornerstone@0.0.39-alpha.1 - @ohif/extension-dicom-html@0.0.4-alpha.1 - @ohif/extension-dicom-microscopy@0.0.9-alpha.1 - @ohif/extension-dicom-pdf@0.0.8-alpha.1 - @ohif/extension-vtk@0.1.4-alpha.1 - @ohif/core@0.11.1-alpha.1 - @ohif/i18n@0.2.3-alpha.1 - @ohif/ui@0.2.18-alpha.1 - @ohif/viewer@0.0.22-alpha.1 * test version bump * Add global prettier config * chore(release): publish %s [skip ci] - @ohif/viewer@0.0.22-alpha.2 * test lerna publish * Update package.jsons * Fix build scripts * catch changes * chore(release): publish %s [skip ci] - @ohif/extension-cornerstone@0.0.39-alpha.2 - @ohif/extension-dicom-html@0.0.4-alpha.2 - @ohif/extension-dicom-microscopy@0.0.9-alpha.2 - @ohif/extension-dicom-pdf@0.0.8-alpha.2 - @ohif/extension-vtk@0.1.4-alpha.2 - @ohif/core@0.11.1-alpha.2 - @ohif/i18n@0.2.3-alpha.2 - @ohif/ui@0.2.18-alpha.2 - @ohif/viewer@0.0.22-alpha.3 * fix eslint issues caused by eslint 6 and our react-app config * Publish with canary tag * chore(release): publish %s [skip ci] - @ohif/extension-cornerstone@0.0.39-alpha.3 - @ohif/extension-dicom-html@0.0.4-alpha.3 - @ohif/extension-dicom-microscopy@0.0.9-alpha.3 - @ohif/extension-dicom-pdf@0.0.8-alpha.3 - @ohif/extension-vtk@0.1.4-alpha.3 - @ohif/core@0.11.1-alpha.3 - @ohif/i18n@0.2.3-alpha.3 - @ohif/ui@0.2.18-alpha.3 - @ohif/viewer@0.0.22-alpha.4 * chore(release): publish %s [skip ci] - @ohif/extension-cornerstone@0.0.39-alpha.4 - @ohif/extension-dicom-html@0.0.4-alpha.4 - @ohif/extension-dicom-microscopy@0.0.9-alpha.4 - @ohif/extension-dicom-pdf@0.0.8-alpha.4 - @ohif/extension-vtk@0.1.4-alpha.4 - @ohif/core@0.11.1-alpha.4 - @ohif/i18n@0.2.3-alpha.4 - @ohif/ui@0.2.18-alpha.4 - @ohif/viewer@0.0.22-alpha.5 * Simplify build * chore(release): publish %s [skip ci] - @ohif/extension-cornerstone@0.0.39-alpha.5 - @ohif/extension-dicom-html@0.0.4-alpha.5 - @ohif/extension-dicom-microscopy@0.0.9-alpha.5 - @ohif/extension-dicom-pdf@0.0.8-alpha.5 - @ohif/extension-vtk@0.1.4-alpha.5 - @ohif/core@0.11.1-alpha.5 - @ohif/i18n@0.2.3-alpha.5 - @ohif/ui@0.2.18-alpha.5 - @ohif/viewer@0.0.22-alpha.6 * chore(release): publish %s [skip ci] - @ohif/extension-cornerstone@0.0.39-alpha.6 - @ohif/extension-dicom-html@0.0.4-alpha.6 - @ohif/extension-dicom-microscopy@0.0.9-alpha.6 - @ohif/extension-dicom-pdf@0.0.8-alpha.6 - @ohif/extension-vtk@0.1.4-alpha.6 - @ohif/core@0.11.1-alpha.6 - @ohif/i18n@0.2.3-alpha.6 - @ohif/ui@0.2.18-alpha.6 - @ohif/viewer@0.0.22-alpha.7 * Split version and publish * chore(release): publish %s [skip ci] - @ohif/extension-cornerstone@0.0.39-alpha.7 - @ohif/extension-dicom-html@0.0.4-alpha.7 - @ohif/extension-dicom-microscopy@0.0.9-alpha.7 - @ohif/extension-dicom-pdf@0.0.8-alpha.7 - @ohif/extension-vtk@0.1.4-alpha.7 - @ohif/core@0.11.1-alpha.7 - @ohif/i18n@0.2.3-alpha.7 - @ohif/ui@0.2.18-alpha.7 - @ohif/viewer@0.0.22-alpha.8 * Try simplify netlify build * react-viewerbase --> @ohif/ui * add test for stylus loader * Try new way to specify publish path * Use an output folder that won't be ignored * Try move command * fiddle with paths * Dig for some information * Make sure we're in root for our commands * Remove discovery * Setup script-tag example * Fix typo * Move config folder * Update cornerstone extension to use shared/root webpack configs * capture changes * Update extension webpack configs * Don't check in docz output * Fix babel runtime resolution issue * Simplify ui build steps * Push in progress * Shift directories * Get viewer dev path to work * Fix viewer commonjs build * Fix build pwa config for viewers * Make sure our package specific command can be called from root * Update notes * Fix imports and misc. merge notes * Bump wado-image-loader version * Switch up commands to remove webworkers copy * Fix CI config * Fix more broken package references * Add react-dropzone * Persist so e2e test can use * Fix lockfile * Use cypress orb to simplify CI * Fix config * Try again * Install yarn latest for orb * Install yarn a different way * Wait on correct port * Run tests in viewer project * Fix cypress config * Make Cypress happier - use default location * Simplify e2e testing * Capture UI changes since fork * Catch core up * Grab latest deps after merge * Fix broken import * Make sure cornerstone-wado-image-loader resolves to 3+ * Note regarding orbs * Fix refresh on 404 routes * Fix odd error for cornerstone-wado-image-loader * Different target for UMD * Simplify dev script * Try to get fancy with netlify output * Let's do it again * Try to fix measurementTools issue * See if we can get our lerna magic to work on merge to monorepo branch
2019-08-13 15:36:46 -04:00
1 parent cac911f08e
commit 08ff214ea6
@@ -0,0 +1,21 @@
+/**
+ * Get the offset for the given element
+ *
+ * @param {Object} element DOM element which will have the offser calculated
+ * @returns {Object} Object containing the top and left offset
+ */
+export default function getOffset(element) {
+  let top = 0;
+  let left = 0;
+  if (element.offsetParent) {
+    do {
+      left += element.offsetLeft;
+      top += element.offsetTop;
+    } while ((element = element.offsetParent));
+  }
+
+  return {
+    left,
+    top,
+  };
+}
@@ -0,0 +1,41 @@
+/**
+ * Get the vertical and horizontal scrollbar sizes
+ * Got from https://stackoverflow.com/questions/986937/how-can-i-get-the-browsers-scrollbar-sizes
+ *
+ * @returns {Array} Array containing the scrollbar horizontal and vertical sizes
+ */
+export default function getScrollbarSize() {
+  const inner = document.createElement('p');
+  inner.style.width = '100%';
+  inner.style.height = '100%';
+
+  const outer = document.createElement('div');
+  outer.style.position = 'absolute';
+  outer.style.top = '0px';
+  outer.style.left = '0px';
+  outer.style.visibility = 'hidden';
+  outer.style.width = '100px';
+  outer.style.height = '100px';
+  outer.style.overflow = 'hidden';
+  outer.appendChild(inner);
+
+  document.body.appendChild(outer);
+
+  const w1 = inner.offsetWidth;
+  const h1 = inner.offsetHeight;
+  outer.style.overflow = 'scroll';
+  let w2 = inner.offsetWidth;
+  let h2 = inner.offsetHeight;
+
+  if (w1 === w2) {
+    w2 = outer.clientWidth;
+  }
+
+  if (h1 === h2) {
+    h2 = outer.clientHeight;
+  }
+
+  document.body.removeChild(outer);
+
+  return [w1 - w2, h1 - h2];
+}
@@ -0,0 +1,33 @@
+import log from '../log.js';
+
+export default function handleError(error) {
+  let { title, message } = error;
+
+  if (!title) {
+    if (error instanceof Error) {
+      title = error.name;
+    }
+  }
+
+  if (!message) {
+    if (error instanceof Error) {
+      message = error.message;
+    }
+  }
+
+  const data = Object.assign(
+    {
+      title,
+      message,
+      class: 'themed',
+      hideConfirm: true,
+      cancelLabel: 'Dismiss',
+      cancelClass: 'btn-secondary',
+    },
+    error || {}
+  );
+
+  log.error(error);
+  // TODO: Find a better way to handle errors instead of displaying a dialog for all of them.
+  // OHIF.ui.showDialog('dialogForm', data);
+}
@@ -0,0 +1,14 @@
+import unsavedChanges from './unsavedChanges.js';
+import handleError from './handleError.js';
+import isCharacterKeyPress from './isCharacterKeyPress.js';
+import getOffset from './getOffset.js';
+import getScrollbarSize from './getScrollbarSize.js';
+
+const ui = {
+  getScrollbarSize,
+  getOffset,
+  isCharacterKeyPress,
+  handleError,
+};
+
+export default ui;
@@ -0,0 +1,21 @@
+/**
+ * Check if the pressed key combination will result in a character input
+ * Got from https://stackoverflow.com/questions/4179708/how-to-detect-if-the-pressed-key-will-produce-a-character-inside-an-input-text
+ *
+ * @returns {Boolean} Whether the pressed key combination will input a character or not
+ */
+export default function isCharacterKeyPress(event) {
+  if (typeof event.which === 'undefined') {
+    // This is IE, which only fires keypress events for printable keys
+    return true;
+  } else if (typeof event.which === 'number' && event.which > 0) {
+    // In other browsers except old versions of WebKit, event.which is
+    // only greater than zero if the keypress is a printable key.
+    // We need to filter out backspace and ctrl/alt/meta key combinations
+    return (
+      !event.ctrlKey && !event.metaKey && !event.altKey && event.which !== 8
+    );
+  }
+
+  return false;
+}
@@ -0,0 +1,536 @@
+const FUNCTION = 'function';
+const STRING = 'string';
+const UNDEFINED = 'undefined';
+const WILDCARD = '*'; // "*" is a special name which means "all children".
+const SEPARATOR = '.';
+
+/**
+ * Main Namespace Component Class
+ */
+
+class Node {
+  constructor() {
+    this.value = 0;
+    this.children = {};
+    this.handlers = {};
+  }
+
+  getPathComponents(path) {
+    return typeof path === STRING ? path.split(SEPARATOR) : null;
+  }
+
+  getNodeUpToIndex(path, index) {
+    let node = this;
+
+    for (let i = 0; i < index; ++i) {
+      let item = path[i];
+      if (node.children.hasOwnProperty(item)) {
+        node = node.children[item];
+      } else {
+        node = null;
+        break;
+      }
+    }
+
+    return node;
+  }
+
+  append(name, value) {
+    const children = this.children;
+    let node = null;
+
+    if (children.hasOwnProperty(name)) {
+      node = children[name];
+    } else if (typeof name === STRING && name !== WILDCARD) {
+      node = new Node();
+      children[name] = node;
+    }
+
+    if (node !== null) {
+      node.value += value > 0 ? parseInt(value) : 0;
+    }
+
+    return node;
+  }
+
+  probe(recursively) {
+    let value = this.value;
+
+    // Calculate entire tree value recursively?
+    if (recursively === true) {
+      const children = this.children;
+      for (let item in children) {
+        if (children.hasOwnProperty(item)) {
+          value += children[item].probe(recursively);
+        }
+      }
+    }
+
+    return value;
+  }
+
+  clear(recursively) {
+    this.value = 0;
+
+    // Clear entire tree recursively?
+    if (recursively === true) {
+      const children = this.children;
+      for (let item in children) {
+        if (children.hasOwnProperty(item)) {
+          children[item].clear(recursively);
+        }
+      }
+    }
+  }
+
+  appendPath(path, value) {
+    path = this.getPathComponents(path);
+
+    if (path !== null) {
+      const last = path.length - 1;
+      let node = this;
+      for (let i = 0; i < last; ++i) {
+        node = node.append(path[i], 0);
+        if (node === null) {
+          return false;
+        }
+      }
+
+      return node.append(path[last], value) !== null;
+    }
+
+    return false;
+  }
+
+  clearPath(path, recursively) {
+    path = this.getPathComponents(path);
+
+    if (path !== null) {
+      const last = path.length - 1;
+      let node = this.getNodeUpToIndex(path, last);
+      if (node !== null) {
+        let item = path[last];
+        if (item !== WILDCARD) {
+          if (node.children.hasOwnProperty(item)) {
+            node.children[item].clear(recursively);
+            return true;
+          }
+        } else {
+          const children = node.children;
+          for (item in children) {
+            if (children.hasOwnProperty(item)) {
+              children[item].clear(recursively);
+            }
+          }
+
+          return true;
+        }
+      }
+    }
+
+    return false;
+  }
+
+  probePath(path, recursively) {
+    path = this.getPathComponents(path);
+
+    if (path !== null) {
+      const last = path.length - 1;
+      let node = this.getNodeUpToIndex(path, last);
+      if (node !== null) {
+        let item = path[last];
+        if (item !== WILDCARD) {
+          if (node.children.hasOwnProperty(item)) {
+            return node.children[item].probe(recursively);
+          }
+        } else {
+          const children = node.children;
+          let value = 0;
+          for (item in children) {
+            if (children.hasOwnProperty(item)) {
+              value += children[item].probe(recursively);
+            }
+          }
+
+          return value;
+        }
+      }
+    }
+
+    return 0;
+  }
+
+  attachHandler(type, handler) {
+    let result = false;
+
+    if (typeof type === STRING && typeof handler === FUNCTION) {
+      const handlers = this.handlers;
+      const list = handlers.hasOwnProperty(type)
+        ? handlers[type]
+        : (handlers[type] = []);
+      const length = list.length;
+
+      let notFound = true;
+
+      for (let i = 0; i < length; ++i) {
+        if (handler === list[i]) {
+          notFound = false;
+          break;
+        }
+      }
+
+      if (notFound) {
+        list[length] = handler;
+        result = true;
+      }
+    }
+
+    return result;
+  }
+
+  removeHandler(type, handler) {
+    let result = false;
+
+    if (typeof type === STRING && typeof handler === FUNCTION) {
+      const handlers = this.handlers;
+      if (handlers.hasOwnProperty(type)) {
+        const list = handlers[type];
+        const length = list.length;
+        for (let i = 0; i < length; ++i) {
+          if (handler === list[i]) {
+            list.splice(i, 1);
+            result = true;
+            break;
+          }
+        }
+      }
+    }
+
+    return result;
+  }
+
+  trigger(type, nonRecursively) {
+    if (typeof type === STRING) {
+      const handlers = this.handlers;
+
+      if (handlers.hasOwnProperty(type)) {
+        const list = handlers[type];
+        const length = list.length;
+        for (let i = 0; i < length; ++i) {
+          list[i].call(null);
+        }
+      }
+
+      if (nonRecursively !== true) {
+        const children = this.children;
+        for (let item in children) {
+          if (children.hasOwnProperty(item)) {
+            children[item].trigger(type);
+          }
+        }
+      }
+    }
+  }
+
+  attachHandlerForPath(path, type, handler) {
+    path = this.getPathComponents(path);
+
+    if (path !== null) {
+      let node = this.getNodeUpToIndex(path, path.length);
+      if (node !== null) {
+        return node.attachHandler(type, handler);
+      }
+    }
+
+    return false;
+  }
+
+  removeHandlerForPath(path, type, handler) {
+    path = this.getPathComponents(path);
+
+    if (path !== null) {
+      let node = this.getNodeUpToIndex(path, path.length);
+      if (node !== null) {
+        return node.removeHandler(type, handler);
+      }
+    }
+
+    return false;
+  }
+
+  triggerHandlersForPath(path, type, nonRecursively) {
+    path = this.getPathComponents(path);
+
+    if (path !== null) {
+      let node = this.getNodeUpToIndex(path, path.length);
+      if (node !== null) {
+        node.trigger(type, nonRecursively);
+      }
+    }
+  }
+}
+
+/**
+ * Root Namespace Node and API
+ */
+
+const rootNode = new Node();
+
+export const unsavedChanges = {
+  rootNode: rootNode,
+
+  observer: null, //new Tracker.Dependency(),
+
+  hooks: new Map(),
+
+  /**
+   * Register a reactive dependency on every change any path suffers
+   */
+  depend: function() {
+    return; // this.observer.depend();
+  },
+
+  /**
+   * Signal an unsaved change for a given namespace.
+   * @param {String} path A string (e.g., "viewer.studyViewer.measurements.targets") that identifies the namespace of the signaled changes.
+   * @return {Boolean} Returns false if the signal could not be saved or the supplied namespace is invalid. Otherwise, true is returned.
+   */
+  set: function(path) {
+    const result = rootNode.appendPath(path, 1);
+    //this.observer.changed();
+    return result;
+  },
+
+  /**
+   * Clear all signaled unsaved changes for a given namespace. If the supplied namespace is a wildcard, all signals below that namespace
+   * are cleared.
+   * @param {String} path A string that identifies the namespace of the signaled changes (e.g., "viewer.studyViewer.measurements.targets"
+   *  for clearing the "targets" item of the "viewer.studyViewer.measurements" namespace or "viewer.studyViewer.*" to specify all signaled
+   *  changes for the "viewer.studyViewer" namespace).
+   * @param {Boolean} recursively Clear node and all its children recursively. If not specified defaults to true.
+   * @return {Boolean} Returns false if the signal could not be removed or the supplied namespace is invalid. Otherwise, true is returned.
+   */
+  clear: function(path, recursively) {
+    const result = rootNode.clearPath(
+      path,
+      typeof recursively === UNDEFINED ? true : recursively
+    );
+    //this.observer.changed();
+    return result;
+  },
+
+  /**
+   * Count the amount of signaled unsaved changes for a given namespace. If the supplied namespace is a wildcard, all signals below that
+   * namespace will also be accounted.
+   * @param {String} path A string that identifies the namespace of the signaled changes (e.g., "viewer.studyViewer.measurements.targets"
+   *  for counting the amount of signals for the "targets" item of the "viewer.studyViewer.measurements" namespace or "viewer.studyViewer.*"
+   *  to count all signaled changes for the "viewer.studyViewer" namespace).
+   * @param {Boolean} recursively Probe node and all its children recursively. If not specified defaults to true.
+   * @return {Number} Returns the amount of signaled changes for a given namespace. If the supplied namespace is a wildcard, the sum of all
+   *  changes for that namespace are returned.
+   */
+  probe: function(path, recursively) {
+    return rootNode.probePath(
+      path,
+      typeof recursively === UNDEFINED ? true : recursively
+    );
+  },
+
+  /**
+   * Attach an event handler to the specified namespace.
+   * @param {String} name A string that identifies the namespace to which the event handler will be attached (e.g.,
+   *  "viewer.studyViewer.measurements" to attach an event handler for that namespace).
+   * @param {String} type A string that identifies the event type to which the event handler will be attached.
+   * @param {Function} handler The handler that will be executed when the specifed event is triggered.
+   * @return {Boolean} Returns true on success and false on failure.
+   */
+  attachHandler: function(path, type, handler) {
+    return (
+      rootNode.appendPath(path, 0) &&
+      rootNode.attachHandlerForPath(path, type, handler)
+    );
+  },
+
+  /**
+   * Detach an event handler from the specified namespace.
+   * @param {String} name A string that identifies the namespace from which the event handler will be detached (e.g.,
+   *  "viewer.studyViewer.measurements" to remove an event handler from that namespace).
+   * @param {String} type A string that identifies the event type to which the event handler was attached.
+   * @param {Function} handler The handler that will be removed from execution list.
+   * @return {Boolean} Returns true on success and false on failure.
+   */
+  removeHandler: function(path, type, handler) {
+    return rootNode.removeHandlerForPath(path, type, handler);
+  },
+
+  /**
+   * Trigger all event handlers for the specified namespace and type.
+   * @param {String} name A string that identifies the namespace from which the event handler will be detached (e.g.,
+   *  "viewer.studyViewer.measurements" to remove an event handler from that namespace).
+   * @param {String} type A string that identifies the event type which will be triggered.
+   * @param {Boolean} nonRecursively If set to true, prevents triggering event handlers from descending tree.
+   * @return {Void} No value is returned.
+   */
+  trigger: function(path, type, nonRecursively) {
+    rootNode.triggerHandlersForPath(path, type, nonRecursively);
+  },
+
+  /**
+   * UI utility that presents a confirmation dialog to the user if any unsaved changes where signaled for the given namespace.
+   * @param {String} path A string that identifies the namespace of the signaled changes (e.g., "viewer.studyViewer.measurements.targets"
+   *  for considering only the signals for the "targets" item of the "viewer.studyViewer.measurements" namespace or "viewer.studyViewer.*"
+   *  to consider all signaled changes for the "viewer.studyViewer" namespace).
+   * @param {Function} callback A callback function (e.g, function(shouldProceed, hasChanges) { ... }) that will be executed after assessment.
+   *  Upon execution, the callback will receive two boolean arguments (shouldProceed and hasChanges) indicating if the action can be performed
+   *  or not and if changes that need to be cleared exist.
+   * @param {Object} options (Optional) An object with UI presentation options.
+   * @param {String} options.title The string that will be used as a title for confirmation dialog.
+   * @param {String} options.message The string that will be used as a message for confirmation dialog.
+   * @return {void} No value is returned.
+   */
+  checkBeforeAction: function(path, callback, options) {
+    let probe, hasChanges, shouldProceed;
+
+    if (typeof callback !== 'function') {
+      // nothing to do if no callback function is supplied...
+      return;
+    }
+
+    probe = this.probe(path);
+    if (probe > 0) {
+      // Unsaved changes exist...
+      hasChanges = true;
+      let dialogOptions = Object.assign(
+        {
+          title: 'You have unsaved changes!',
+          message:
+            "Your changes will be lost if you don't save them before leaving the current page... Are you sure you want to proceed?",
+        },
+        options
+      );
+      OHIF.ui.showDialog('dialogConfirm', dialogOptions).then(
+        function() {
+          // Unsaved changes exist but user confirms action...
+          shouldProceed = true;
+          callback.call(null, shouldProceed, hasChanges);
+        },
+        function() {
+          // Unsaved changes exist and user does NOT confirm action...
+          shouldProceed = false;
+          callback.call(null, shouldProceed, hasChanges);
+        }
+      );
+    } else {
+      // No unsaved changes, action can be performed...
+      hasChanges = false;
+      shouldProceed = true;
+      callback.call(null, shouldProceed, hasChanges);
+    }
+  },
+
+  /**
+   * UI utility that presents a "proactive" dialog (with three options: stay, abandon-changes, save-changes) to the user if any unsaved changes where signaled for the given namespace.
+   * @param {String} path A string that identifies the namespace of the signaled changes (e.g., "viewer.studyViewer.measurements.targets"
+   *  for considering only the signals for the "targets" item of the "viewer.studyViewer.measurements" namespace or "viewer.studyViewer.*"
+   *  to consider all signaled changes for the "viewer.studyViewer" namespace).
+   * @param {Function} callback A callback function (e.g, function(hasChanges, userChoice) { ... }) that will be executed after assessment.
+   *  Upon execution, the callback will receive two arguments: one boolean (hasChanges) indicating that unsaved changes exist and one string with the ID of the
+   *  option picked by the user on the dialog ('abort-action', 'abandon-changes' and 'save-changes'). If no unsaved changes exist, the second argument is null.
+   * @param {Object} options (Optional) An object with UI presentation options.
+   * @param {Object} options.position An object with optimal position (e.g., { x: ..., y: ... }) for the dialog.
+   * @return {void} No value is returned.
+   */
+  presentProactiveDialog: function(path, callback, options) {
+    let probe, hasChanges;
+
+    if (typeof callback !== 'function') {
+      // nothing to do if no callback function is supplied...
+      return;
+    }
+
+    probe = this.probe(path, true);
+    if (probe > 0) {
+      // Unsaved changes exist...
+      hasChanges = true;
+      OHIF.ui.unsavedChangesDialog(function(choice) {
+        callback.call(null, hasChanges, choice);
+      }, options);
+    } else {
+      // No unsaved changes, action can be performed...
+      hasChanges = false;
+      callback.call(null, hasChanges, null);
+    }
+  },
+
+  addHook(saveCallback, options = {}) {
+    if (!options.path) {
+      options.path = '*';
+    }
+
+    if (!options.message) {
+      options.message = 'There are unsaved changes';
+    }
+
+    this.hooks.set(saveCallback, options);
+  },
+
+  removeHook(saveCallback) {
+    this.hooks.delete(saveCallback);
+  },
+
+  confirmNavigation(navigateCallback, event) {
+    let dialogPresented = false;
+    Array.from(this.hooks.keys()).every(saveCallback => {
+      const options = this.hooks.get(saveCallback);
+      const probe = this.probe(options.path, true);
+      if (!probe) return true;
+
+      const dialogOptions = Object.assign({ class: 'themed' }, options);
+      if (event) {
+        dialogOptions.position = {
+          x: event.clientX + 15,
+          y: event.clientY + 15,
+        };
+      }
+
+      OHIF.ui.unsavedChanges.presentProactiveDialog(
+        options.path,
+        (hasChanges, userChoice) => {
+          if (!hasChanges) return;
+
+          const clear = () => this.clear(options.path, true);
+          switch (userChoice) {
+            case 'abort-action':
+              return;
+            case 'save-changes':
+              const result = saveCallback();
+              if (result instanceof Promise) {
+                return result.then(() => {
+                  clear();
+                  this.confirmNavigation(navigateCallback, event);
+                });
+              }
+
+              clear();
+              return this.confirmNavigation(navigateCallback, event);
+            case 'abandon-changes':
+              clear();
+              break;
+          }
+
+          navigateCallback();
+        },
+        dialogOptions
+      );
+
+      dialogPresented = true;
+      return false;
+    });
+
+    if (!dialogPresented) {
+      navigateCallback();
+    }
+  },
+};
+
+export default unsavedChanges;