@itwin/core-frontend 4.10.0-dev.8 → 5.0.0-dev.0

package/lib/cjs/ViewportSync.js

@@ -7,7 +7,12 @@
  * @module Views
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TwoWayViewportFrustumSync = exports.TwoWayViewportSync = exports.connectViewportViews = exports.connectViewportFrusta = exports.synchronizeViewportFrusta = exports.synchronizeViewportViews = exports.connectViewports = void 0;
+exports.TwoWayViewportFrustumSync = exports.TwoWayViewportSync = void 0;
+exports.connectViewports = connectViewports;
+exports.synchronizeViewportViews = synchronizeViewportViews;
+exports.synchronizeViewportFrusta = synchronizeViewportFrusta;
+exports.connectViewportFrusta = connectViewportFrusta;
+exports.connectViewportViews = connectViewportViews;
 /** Forms a connection between two or more [[Viewport]]s such that a change in any one of the viewports is reflected in all of the others.
  * When the connection is first formed, all of the viewports are synchronized to the current state of the **first** viewport in `viewports`.
  * Thereafter, an event listener registered with each viewport's [[Viewport.onViewChanged]] event is invoked when anything about that viewport's state changes.
@@ -69,7 +74,6 @@ function connectViewports(viewports, sync) {
         disconnect.length = 0;
     };
 }
-exports.connectViewports = connectViewports;
 /** A function that returns a [[SynchronizeViewports]] function that synchronizes every aspect of the viewports' states, including
  * display style, model and category selectors, [Frustum]($common), etc.
  * @see [[connectViewportViews]] to establish a connection between viewports using this synchronization strategy.
@@ -79,7 +83,6 @@ exports.connectViewports = connectViewports;
 function synchronizeViewportViews(source) {
     return (_source, target) => target.applyViewState(source.view.clone(target.iModel));
 }
-exports.synchronizeViewportViews = synchronizeViewportViews;
 /** A function that returns a [[SynchronizeViewports]] function that synchronizes the viewed volumes of each viewport.
  * @see [[connectViewportFrusta]] to establish a connection between viewports using this synchronization strategy.
  * @public
@@ -92,7 +95,6 @@ function synchronizeViewportFrusta(source) {
         target.applyViewState(view);
     };
 }
-exports.synchronizeViewportFrusta = synchronizeViewportFrusta;
 /** Form a connection between two or more [[Viewport]]s such that they all view the same volume. For example, zooming out in one viewport
  * will zoom out by the same distance in all of the other viewports.
  * @see [[connectViewports]] to customize how the viewports are synchronized.
@@ -102,7 +104,6 @@ exports.synchronizeViewportFrusta = synchronizeViewportFrusta;
 function connectViewportFrusta(viewports) {
     return connectViewports(viewports, (source) => synchronizeViewportFrusta(source));
 }
-exports.connectViewportFrusta = connectViewportFrusta;
 /** Form a connection between two or more [[Viewport]]s such that every aspect of the viewports are kept in sync. For example, if the set of models
  * or categories visible in one viewport is changed, the same set of models and categories will be visible in the other viewports.
  * @see [[connectViewportFrusta]] to synchronize only the [Frustum]($common) of each viewport.
@@ -113,7 +114,6 @@ exports.connectViewportFrusta = connectViewportFrusta;
 function connectViewportViews(viewports) {
     return connectViewports(viewports, (source) => synchronizeViewportViews(source));
 }
-exports.connectViewportViews = connectViewportViews;
 /** Forms a bidirectional connection between two [[Viewport]]s such that the [[ViewState]]s of each are synchronized with one another.
  * For example, panning in one viewport will cause the other viewport to pan by the same distance, and changing the [RenderMode]($common) of one viewport
  * will change it in the other viewport.

package/lib/cjs/ViewportSync.js.map

@@ -1 +1 @@
-{"version":3,"file":"ViewportSync.js","sourceRoot":"","sources":["../../src/ViewportSync.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Views\r\n */\r\n\r\nimport { Viewport } from \"./Viewport\";\r\n\r\n/** A function used by [[connectViewports]] that can synchronize the state of a target [[Viewport]] with\r\n * changes in the state of a source Viewport.\r\n * The source viewport is the viewport in the connection whose state has changed.\r\n * The function will be invoked once for each target viewport in the connection.\r\n * @public\r\n * @extensions\r\n */\r\nexport type SynchronizeViewports = (source: Viewport, target: Viewport) => void;\r\n\r\n/** Forms a connection between two or more [[Viewport]]s such that a change in any one of the viewports is reflected in all of the others.\r\n * When the connection is first formed, all of the viewports are synchronized to the current state of the **first** viewport in `viewports`.\r\n * Thereafter, an event listener registered with each viewport's [[Viewport.onViewChanged]] event is invoked when anything about that viewport's state changes.\r\n * Each time such an event occurs, the initating (\"source\") viewport is passed to `sync` to obtain a function that can be invoked to synchronize each of the other\r\n * (\"target\") viewports with the source viewport's new state. The function returned by `sync` can choose to synchronize any or all aspects of the viewports' states, such as\r\n * the viewed volume, display style, viewed categories or models, or anything else.\r\n *\r\n * To sever the connection, invoke the function returned by this function. For example:\r\n * ```ts\r\n *  // set up the connection.\r\n *  const disconnect = connectViewports([viewport0, viewport1, viewport2], (changedViewport) => synchronizeViewportFrusta(changedViewport));\r\n *  // some time later, sever the connection.\r\n *  disconnect();\r\n * ```\r\n *\r\n * @note [[Viewport.onViewChanged]] can be invoked **very** frequently - sometimes multiple times per frame. Try to avoid performing excessive computations within your synchronization functions.\r\n *\r\n * @param viewports The viewports to be connected. It should contain at least two viewports and no duplicate viewports. The initial state of each viewport will be synchronized with\r\n * the state of the first viewport in this iterable.\r\n * @param sync A function to be invoked whenever the state of any viewport in `viewports` changes, returning a function that can be used to synchronize the\r\n * state of each viewport.\r\n * @returns a function that can be invoked to sever the connection between the viewports.\r\n * @see [[connectViewportFrusta]] to synchronize the [Frustum]($common) of each viewport.\r\n * @see [[connectViewportViews]] to synchronize every aspect of the viewports.\r\n * @see [[TwoWayViewportSync]] to synchronize the state of exactly two viewports.\r\n * @see [Multiple Viewport Sample](https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=multi-viewport-sample&imodel=Metrostation+Sample)\r\n * @public\r\n * @extensions\r\n */\r\nexport function connectViewports(viewports: Iterable<Viewport>, sync: (changedViewport: Viewport) => SynchronizeViewports): () => void {\r\n  const disconnect: VoidFunction[] = [];\r\n\r\n  let echo = false;\r\n  const synchronize = (source: Viewport) => {\r\n    if (echo)\r\n      return;\r\n\r\n    // Ignore onViewChanged events resulting from synchronization.\r\n    echo = true;\r\n    try {\r\n      const doSync = sync(source);\r\n      for (const vp of viewports)\r\n        if (vp !== source)\r\n          doSync(source, vp);\r\n    } finally {\r\n      echo = false;\r\n    }\r\n  };\r\n\r\n  let firstViewport: Viewport | undefined;\r\n  for (const vp of viewports) {\r\n    if (!firstViewport)\r\n      firstViewport = vp;\r\n\r\n    disconnect.push(vp.onViewChanged.addListener(() => synchronize(vp)));\r\n  }\r\n\r\n  if (firstViewport)\r\n    synchronize(firstViewport);\r\n\r\n  return () => {\r\n    for (const f of disconnect)\r\n      f();\r\n\r\n    disconnect.length = 0;\r\n  };\r\n}\r\n\r\n/** A function that returns a [[SynchronizeViewports]] function that synchronizes every aspect of the viewports' states, including\r\n * display style, model and category selectors, [Frustum]($common), etc.\r\n * @see [[connectViewportViews]] to establish a connection between viewports using this synchronization strategy.\r\n * @public\r\n * @extensions\r\n */\r\nexport function synchronizeViewportViews(source: Viewport): SynchronizeViewports {\r\n  return (_source, target) => target.applyViewState(source.view.clone(target.iModel));\r\n}\r\n\r\n/** A function that returns a [[SynchronizeViewports]] function that synchronizes the viewed volumes of each viewport.\r\n * @see [[connectViewportFrusta]] to establish a connection between viewports using this synchronization strategy.\r\n * @public\r\n * @extensions\r\n */\r\nexport function synchronizeViewportFrusta(source: Viewport): SynchronizeViewports {\r\n  const pose = source.view.savePose();\r\n  return (_source, target) => {\r\n    const view = target.view.applyPose(pose);\r\n    target.applyViewState(view);\r\n  };\r\n}\r\n\r\n/** Form a connection between two or more [[Viewport]]s such that they all view the same volume. For example, zooming out in one viewport\r\n * will zoom out by the same distance in all of the other viewports.\r\n * @see [[connectViewports]] to customize how the viewports are synchronized.\r\n * @public\r\n * @extensions\r\n */\r\nexport function connectViewportFrusta(viewports: Iterable<Viewport>): () => void {\r\n  return connectViewports(viewports, (source) => synchronizeViewportFrusta(source));\r\n}\r\n\r\n/** Form a connection between two or more [[Viewport]]s such that every aspect of the viewports are kept in sync. For example, if the set of models\r\n * or categories visible in one viewport is changed, the same set of models and categories will be visible in the other viewports.\r\n * @see [[connectViewportFrusta]] to synchronize only the [Frustum]($common) of each viewport.\r\n * @see [[connectViewports]] to customize how the viewports are synchronized.\r\n * @public\r\n * @extensions\r\n */\r\nexport function connectViewportViews(viewports: Iterable<Viewport>): () => void {\r\n  return connectViewports(viewports, (source) => synchronizeViewportViews(source));\r\n}\r\n\r\n/** Forms a bidirectional connection between two [[Viewport]]s such that the [[ViewState]]s of each are synchronized with one another.\r\n * For example, panning in one viewport will cause the other viewport to pan by the same distance, and changing the [RenderMode]($common) of one viewport\r\n * will change it in the other viewport.\r\n * By default, all aspects of the views - display style, category and model selectors, frustum, etc - are synchronized, but this can be customized by\r\n * subclassing and overriding the [[syncViewports]] and [[connectViewports]] methods.\r\n * @see [Multiple Viewport Sample](https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=multi-viewport-sample&imodel=Metrostation+Sample)\r\n * for an interactive demonstration.\r\n * @see [[TwoWayViewportFrustumSync]] to synchronize only the frusta of the viewports.\r\n * @see [[connectViewportViews]] to synchronize the state of more than two viewports.\r\n * @public\r\n * @extensions\r\n */\r\nexport class TwoWayViewportSync {\r\n  protected readonly _disconnect: VoidFunction[] = [];\r\n\r\n  /** Invoked from [[connect]] to set up the initial synchronization between the two viewports.\r\n   * `target` should be modified to match `source`.\r\n   * The default implementation applies a clone of `source`'s [[ViewState]] to `target`.\r\n   * @see [[syncViewports]] to customize subsequent synchronization.\r\n   */\r\n  protected connectViewports(source: Viewport, target: Viewport): void {\r\n    const viewState = source.view.clone(target.iModel);\r\n    target.applyViewState(viewState);\r\n  }\r\n\r\n  /** Invoked each time `source` changes to update `target` to match.\r\n   * The default implementation applies a clone of `source`'s [[ViewState]] to `target`.\r\n   * @param source The viewport that changed\r\n   * @param target The viewport that should be updated to match `source`\r\n   * @see [[connectViewports]] to set up the initial synchronization between the two viewports.\r\n   */\r\n  protected syncViewports(source: Viewport, target: Viewport): void {\r\n    target.applyViewState(source.view.clone(target.iModel));\r\n  }\r\n\r\n  /** Establish the connection between two Viewports. When this method is called, `viewport2` is initialized with the state of `viewport1` via [[connectViewports]].\r\n   * Thereafter, any change to the frustum of either viewport will be reflected in the frustum of the other viewport via [[syncViewports]].\r\n   */\r\n  public connect(viewport1: Viewport, viewport2: Viewport) {\r\n    this.disconnect();\r\n\r\n    this.connectViewports(viewport1, viewport2);\r\n\r\n    this._disconnect.push(connectViewports([viewport1, viewport2], () => (source, target) => this.syncViewports(source, target)));\r\n  }\r\n\r\n  /** Remove the connection between the two views. */\r\n  public disconnect() {\r\n    this._disconnect.forEach((f) => f());\r\n    this._disconnect.length = 0;\r\n  }\r\n}\r\n\r\n/** Forms a bidirectional connection between two [[Viewport]]s such that the [Frustum]($common)s of each are synchronized with one another.\r\n * For example, zooming out in one viewport will zoom out by the same distance in the other viewport.\r\n * No other aspects of the viewports are synchronized - they may have entirely different display styles, category/model selectors, etc.\r\n * @see [[TwoWayViewportSync]] to synchronize all aspects of the viewports.\r\n * @see [[connectViewportFrusta]] to synchronize the frusta of more than two viewports.\r\n * @public\r\n * @extensions\r\n */\r\nexport class TwoWayViewportFrustumSync extends TwoWayViewportSync {\r\n  /** Synchronizes the two viewports by applying `source`'s frustum to `target`. */\r\n  protected override syncViewports(source: Viewport, target: Viewport): void {\r\n    const pose = source.view.savePose();\r\n    const view = target.view.applyPose(pose);\r\n    target.applyViewState(view);\r\n  }\r\n\r\n  /** Sets up the initial connection between two viewports by applying `source`'s frustum to `target`. */\r\n  protected override connectViewports(source: Viewport, target: Viewport): void {\r\n    this.syncViewports(source, target);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ViewportSync.js","sourceRoot":"","sources":["../../src/ViewportSync.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Views\r\n */\r\n\r\nimport { Viewport } from \"./Viewport\";\r\n\r\n/** A function used by [[connectViewports]] that can synchronize the state of a target [[Viewport]] with\r\n * changes in the state of a source Viewport.\r\n * The source viewport is the viewport in the connection whose state has changed.\r\n * The function will be invoked once for each target viewport in the connection.\r\n * @public\r\n * @extensions\r\n */\r\nexport type SynchronizeViewports = (source: Viewport, target: Viewport) => void;\r\n\r\n/** Forms a connection between two or more [[Viewport]]s such that a change in any one of the viewports is reflected in all of the others.\r\n * When the connection is first formed, all of the viewports are synchronized to the current state of the **first** viewport in `viewports`.\r\n * Thereafter, an event listener registered with each viewport's [[Viewport.onViewChanged]] event is invoked when anything about that viewport's state changes.\r\n * Each time such an event occurs, the initating (\"source\") viewport is passed to `sync` to obtain a function that can be invoked to synchronize each of the other\r\n * (\"target\") viewports with the source viewport's new state. The function returned by `sync` can choose to synchronize any or all aspects of the viewports' states, such as\r\n * the viewed volume, display style, viewed categories or models, or anything else.\r\n *\r\n * To sever the connection, invoke the function returned by this function. For example:\r\n * ```ts\r\n *  // set up the connection.\r\n *  const disconnect = connectViewports([viewport0, viewport1, viewport2], (changedViewport) => synchronizeViewportFrusta(changedViewport));\r\n *  // some time later, sever the connection.\r\n *  disconnect();\r\n * ```\r\n *\r\n * @note [[Viewport.onViewChanged]] can be invoked **very** frequently - sometimes multiple times per frame. Try to avoid performing excessive computations within your synchronization functions.\r\n *\r\n * @param viewports The viewports to be connected. It should contain at least two viewports and no duplicate viewports. The initial state of each viewport will be synchronized with\r\n * the state of the first viewport in this iterable.\r\n * @param sync A function to be invoked whenever the state of any viewport in `viewports` changes, returning a function that can be used to synchronize the\r\n * state of each viewport.\r\n * @returns a function that can be invoked to sever the connection between the viewports.\r\n * @see [[connectViewportFrusta]] to synchronize the [Frustum]($common) of each viewport.\r\n * @see [[connectViewportViews]] to synchronize every aspect of the viewports.\r\n * @see [[TwoWayViewportSync]] to synchronize the state of exactly two viewports.\r\n * @see [Multiple Viewport Sample](https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=multi-viewport-sample&imodel=Metrostation+Sample)\r\n * @public\r\n * @extensions\r\n */\r\nexport function connectViewports(viewports: Iterable<Viewport>, sync: (changedViewport: Viewport) => SynchronizeViewports): () => void {\r\n  const disconnect: VoidFunction[] = [];\r\n\r\n  let echo = false;\r\n  const synchronize = (source: Viewport) => {\r\n    if (echo)\r\n      return;\r\n\r\n    // Ignore onViewChanged events resulting from synchronization.\r\n    echo = true;\r\n    try {\r\n      const doSync = sync(source);\r\n      for (const vp of viewports)\r\n        if (vp !== source)\r\n          doSync(source, vp);\r\n    } finally {\r\n      echo = false;\r\n    }\r\n  };\r\n\r\n  let firstViewport: Viewport | undefined;\r\n  for (const vp of viewports) {\r\n    if (!firstViewport)\r\n      firstViewport = vp;\r\n\r\n    disconnect.push(vp.onViewChanged.addListener(() => synchronize(vp)));\r\n  }\r\n\r\n  if (firstViewport)\r\n    synchronize(firstViewport);\r\n\r\n  return () => {\r\n    for (const f of disconnect)\r\n      f();\r\n\r\n    disconnect.length = 0;\r\n  };\r\n}\r\n\r\n/** A function that returns a [[SynchronizeViewports]] function that synchronizes every aspect of the viewports' states, including\r\n * display style, model and category selectors, [Frustum]($common), etc.\r\n * @see [[connectViewportViews]] to establish a connection between viewports using this synchronization strategy.\r\n * @public\r\n * @extensions\r\n */\r\nexport function synchronizeViewportViews(source: Viewport): SynchronizeViewports {\r\n  return (_source, target) => target.applyViewState(source.view.clone(target.iModel));\r\n}\r\n\r\n/** A function that returns a [[SynchronizeViewports]] function that synchronizes the viewed volumes of each viewport.\r\n * @see [[connectViewportFrusta]] to establish a connection between viewports using this synchronization strategy.\r\n * @public\r\n * @extensions\r\n */\r\nexport function synchronizeViewportFrusta(source: Viewport): SynchronizeViewports {\r\n  const pose = source.view.savePose();\r\n  return (_source, target) => {\r\n    const view = target.view.applyPose(pose);\r\n    target.applyViewState(view);\r\n  };\r\n}\r\n\r\n/** Form a connection between two or more [[Viewport]]s such that they all view the same volume. For example, zooming out in one viewport\r\n * will zoom out by the same distance in all of the other viewports.\r\n * @see [[connectViewports]] to customize how the viewports are synchronized.\r\n * @public\r\n * @extensions\r\n */\r\nexport function connectViewportFrusta(viewports: Iterable<Viewport>): () => void {\r\n  return connectViewports(viewports, (source) => synchronizeViewportFrusta(source));\r\n}\r\n\r\n/** Form a connection between two or more [[Viewport]]s such that every aspect of the viewports are kept in sync. For example, if the set of models\r\n * or categories visible in one viewport is changed, the same set of models and categories will be visible in the other viewports.\r\n * @see [[connectViewportFrusta]] to synchronize only the [Frustum]($common) of each viewport.\r\n * @see [[connectViewports]] to customize how the viewports are synchronized.\r\n * @public\r\n * @extensions\r\n */\r\nexport function connectViewportViews(viewports: Iterable<Viewport>): () => void {\r\n  return connectViewports(viewports, (source) => synchronizeViewportViews(source));\r\n}\r\n\r\n/** Forms a bidirectional connection between two [[Viewport]]s such that the [[ViewState]]s of each are synchronized with one another.\r\n * For example, panning in one viewport will cause the other viewport to pan by the same distance, and changing the [RenderMode]($common) of one viewport\r\n * will change it in the other viewport.\r\n * By default, all aspects of the views - display style, category and model selectors, frustum, etc - are synchronized, but this can be customized by\r\n * subclassing and overriding the [[syncViewports]] and [[connectViewports]] methods.\r\n * @see [Multiple Viewport Sample](https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=multi-viewport-sample&imodel=Metrostation+Sample)\r\n * for an interactive demonstration.\r\n * @see [[TwoWayViewportFrustumSync]] to synchronize only the frusta of the viewports.\r\n * @see [[connectViewportViews]] to synchronize the state of more than two viewports.\r\n * @public\r\n * @extensions\r\n */\r\nexport class TwoWayViewportSync {\r\n  protected readonly _disconnect: VoidFunction[] = [];\r\n\r\n  /** Invoked from [[connect]] to set up the initial synchronization between the two viewports.\r\n   * `target` should be modified to match `source`.\r\n   * The default implementation applies a clone of `source`'s [[ViewState]] to `target`.\r\n   * @see [[syncViewports]] to customize subsequent synchronization.\r\n   */\r\n  protected connectViewports(source: Viewport, target: Viewport): void {\r\n    const viewState = source.view.clone(target.iModel);\r\n    target.applyViewState(viewState);\r\n  }\r\n\r\n  /** Invoked each time `source` changes to update `target` to match.\r\n   * The default implementation applies a clone of `source`'s [[ViewState]] to `target`.\r\n   * @param source The viewport that changed\r\n   * @param target The viewport that should be updated to match `source`\r\n   * @see [[connectViewports]] to set up the initial synchronization between the two viewports.\r\n   */\r\n  protected syncViewports(source: Viewport, target: Viewport): void {\r\n    target.applyViewState(source.view.clone(target.iModel));\r\n  }\r\n\r\n  /** Establish the connection between two Viewports. When this method is called, `viewport2` is initialized with the state of `viewport1` via [[connectViewports]].\r\n   * Thereafter, any change to the frustum of either viewport will be reflected in the frustum of the other viewport via [[syncViewports]].\r\n   */\r\n  public connect(viewport1: Viewport, viewport2: Viewport) {\r\n    this.disconnect();\r\n\r\n    this.connectViewports(viewport1, viewport2);\r\n\r\n    this._disconnect.push(connectViewports([viewport1, viewport2], () => (source, target) => this.syncViewports(source, target)));\r\n  }\r\n\r\n  /** Remove the connection between the two views. */\r\n  public disconnect() {\r\n    this._disconnect.forEach((f) => f());\r\n    this._disconnect.length = 0;\r\n  }\r\n}\r\n\r\n/** Forms a bidirectional connection between two [[Viewport]]s such that the [Frustum]($common)s of each are synchronized with one another.\r\n * For example, zooming out in one viewport will zoom out by the same distance in the other viewport.\r\n * No other aspects of the viewports are synchronized - they may have entirely different display styles, category/model selectors, etc.\r\n * @see [[TwoWayViewportSync]] to synchronize all aspects of the viewports.\r\n * @see [[connectViewportFrusta]] to synchronize the frusta of more than two viewports.\r\n * @public\r\n * @extensions\r\n */\r\nexport class TwoWayViewportFrustumSync extends TwoWayViewportSync {\r\n  /** Synchronizes the two viewports by applying `source`'s frustum to `target`. */\r\n  protected override syncViewports(source: Viewport, target: Viewport): void {\r\n    const pose = source.view.savePose();\r\n    const view = target.view.applyPose(pose);\r\n    target.applyViewState(view);\r\n  }\r\n\r\n  /** Sets up the initial connection between two viewports by applying `source`'s frustum to `target`. */\r\n  protected override connectViewports(source: Viewport, target: Viewport): void {\r\n    this.syncViewports(source, target);\r\n  }\r\n}\r\n"]}

package/lib/cjs/common/ImageUtil.js

@@ -7,7 +7,21 @@
  * @module Rendering
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCompressedJpegFromCanvas = exports.getCenteredViewRect = exports.openImageDataUrlInNewWindow = exports.imageBufferToBase64EncodedPng = exports.imageBufferToPngDataUrl = exports.extractImageSourceDimensions = exports.tryImageElementFromUrl = exports.imageElementFromUrl = exports.imageBitmapFromImageSource = exports.imageElementFromImageSource = exports.getImageSourceFormatForMimeType = exports.getImageSourceMimeType = exports.canvasToImageBuffer = exports.imageBufferToCanvas = exports.canvasToResizedCanvasWithBars = void 0;
+exports.canvasToResizedCanvasWithBars = canvasToResizedCanvasWithBars;
+exports.imageBufferToCanvas = imageBufferToCanvas;
+exports.canvasToImageBuffer = canvasToImageBuffer;
+exports.getImageSourceMimeType = getImageSourceMimeType;
+exports.getImageSourceFormatForMimeType = getImageSourceFormatForMimeType;
+exports.imageElementFromImageSource = imageElementFromImageSource;
+exports.imageBitmapFromImageSource = imageBitmapFromImageSource;
+exports.imageElementFromUrl = imageElementFromUrl;
+exports.tryImageElementFromUrl = tryImageElementFromUrl;
+exports.extractImageSourceDimensions = extractImageSourceDimensions;
+exports.imageBufferToPngDataUrl = imageBufferToPngDataUrl;
+exports.imageBufferToBase64EncodedPng = imageBufferToBase64EncodedPng;
+exports.openImageDataUrlInNewWindow = openImageDataUrlInNewWindow;
+exports.getCenteredViewRect = getCenteredViewRect;
+exports.getCompressedJpegFromCanvas = getCompressedJpegFromCanvas;
 const core_geometry_1 = require("@itwin/core-geometry");
 const core_common_1 = require("@itwin/core-common");
 const ViewRect_1 = require("./ViewRect");
@@ -55,7 +69,6 @@ function canvasToResizedCanvasWithBars(canvasIn, targetSize, barSize = new core_
     context.drawImage(canvasIn, adjustImageX, adjustImageY, targetSize.x, targetSize.y);
     return canvasOut;
 }
-exports.canvasToResizedCanvasWithBars = canvasToResizedCanvasWithBars;
 /** Create a canvas element with the same dimensions and contents as an image buffer.
  * @param buffer the source [[ImageBuffer]] object from which the [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement) object will be constructed.
  * @param preserveAlpha If false, the alpha channel will be set to 255 (fully opaque). This is recommended when converting an already-blended image (e.g., one obtained from [[Viewport.readImageBuffer]]).
@@ -89,7 +102,6 @@ function imageBufferToCanvas(buffer, preserveAlpha = true) {
     context.putImageData(imageData, 0, 0);
     return canvas;
 }
-exports.imageBufferToCanvas = imageBufferToCanvas;
 /** Create an ImageBuffer in the specified format with the same dimensions and contents as a canvas.
  * @param canvas the source [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement) object from which the [[ImageBuffer]] object will be constructed.
  * @param format the desired format of the created ImageBuffer; defaults to [[ImageBufferFormat.Rgba]].
@@ -138,7 +150,6 @@ function canvasToImageBuffer(canvas, format = core_common_1.ImageBufferFormat.Rg
     }
     return core_common_1.ImageBuffer.create(imageBufferData, format, canvas.width);
 }
-exports.canvasToImageBuffer = canvasToImageBuffer;
 /** Get a string describing the mime type associated with an ImageSource format.
  * @public
  * @extensions
@@ -154,7 +165,6 @@ function getImageSourceMimeType(format) {
     }
     return "";
 }
-exports.getImageSourceMimeType = getImageSourceMimeType;
 /** Get the ImageSourceFormat corresponding to the mime type string, or undefined if the string does not identify a supported ImageSourceFormat.
  * @public
  * @extensions
@@ -169,7 +179,6 @@ function getImageSourceFormatForMimeType(mimeType) {
         default: return undefined;
     }
 }
-exports.getImageSourceFormatForMimeType = getImageSourceFormatForMimeType;
 /** Extract an html Image element from a binary jpeg or png.
  * @param source The ImageSource containing the binary jpeg or png data.
  * @returns a Promise which resolves to an HTMLImageElement containing the uncompressed bitmap image in RGBA format.
@@ -180,7 +189,6 @@ async function imageElementFromImageSource(source) {
     const blob = new Blob([source.data], { type: getImageSourceMimeType(source.format) });
     return imageElementFromUrl(URL.createObjectURL(blob));
 }
-exports.imageElementFromImageSource = imageElementFromImageSource;
 /** Extract a bitmap from a binary jpeg or png.
  * @param source The ImageSource containing the binary jpeg or png data.
  * @returns a Promise which resolves to an ImageBitmap containing the uncompressed bitmap image in RGBA format.
@@ -193,7 +201,6 @@ async function imageBitmapFromImageSource(source) {
         colorSpaceConversion: "none",
     });
 }
-exports.imageBitmapFromImageSource = imageBitmapFromImageSource;
 /** Create an html Image element from a URL.
  * @param url The URL pointing to the image data.
  * @param skipCrossOriginCheck Set this to true to allow an image from a different origin than the web app to load. Default is false.
@@ -216,7 +223,6 @@ async function imageElementFromUrl(url, skipCrossOriginCheck = false) {
         image.src = url;
     });
 }
-exports.imageElementFromUrl = imageElementFromUrl;
 /** Try to create an html Image element from a URL.
  * @param url The URL pointing to the image data.
  * @param skipCrossOriginCheck Set this to true to allow an image from a different origin than the web app to load. Default is false.
@@ -232,7 +238,6 @@ async function tryImageElementFromUrl(url, skipCrossOriginCheck = false) {
         return undefined;
     }
 }
-exports.tryImageElementFromUrl = tryImageElementFromUrl;
 /**
  * Extract the dimensions of the jpeg or png data encoded in an ImageSource.
  * @param source The ImageSource containing the binary jpeg or png data.
@@ -244,7 +249,6 @@ async function extractImageSourceDimensions(source) {
     const image = await imageElementFromImageSource(source);
     return new core_geometry_1.Point2d(image.naturalWidth, image.naturalHeight);
 }
-exports.extractImageSourceDimensions = extractImageSourceDimensions;
 /**
  * Produces a data url in "image/png" format from the contents of an ImageBuffer.
  * @param buffer The ImageBuffer, of any format.
@@ -258,7 +262,6 @@ function imageBufferToPngDataUrl(buffer, preserveAlpha = true) {
     const canvas = imageBufferToCanvas(buffer, preserveAlpha);
     return undefined !== canvas ? canvas.toDataURL() : undefined;
 }
-exports.imageBufferToPngDataUrl = imageBufferToPngDataUrl;
 /**
  * Converts the contents of an ImageBuffer to PNG format.
  * @param buffer The ImageBuffer, of any format.
@@ -274,7 +277,6 @@ function imageBufferToBase64EncodedPng(buffer, preserveAlpha = true) {
         return undefined;
     return url.substring(urlPrefix.length);
 }
-exports.imageBufferToBase64EncodedPng = imageBufferToBase64EncodedPng;
 /** Open an image specified as a data URL in a new window or tab. Works around differences between browsers and Electron.
  * @param url The base64-encoded image URL.
  * @param title An optional title to apply to the new window.
@@ -290,7 +292,6 @@ function openImageDataUrlInNewWindow(url, title) {
     if (undefined !== title)
         win.document.title = title;
 }
-exports.openImageDataUrlInNewWindow = openImageDataUrlInNewWindow;
 /** Determine the maximum [[ViewRect]] that can be fitted and centered in specified ViewRect given a required aspect ratio.
  * @param viewRect The rectangle in which the returned rectangle is to be centered and fitted.
  * @param aspectRatio Ratio of width to height.
@@ -308,7 +309,6 @@ function getCenteredViewRect(viewRect, aspectRatio = 1.4) {
     const bottom = top + finalHeight;
     return new ViewRect_1.ViewRect(left, top, right, bottom);
 }
-exports.getCenteredViewRect = getCenteredViewRect;
 /** Produce a jpeg compressed to no more than specified bytes and of no less than specified quality.
  * @param canvas Canvas containing the image to be compressed.
  * @param maxBytes Maximum size of output jpeg in bytes.
@@ -330,5 +330,4 @@ function getCompressedJpegFromCanvas(canvas, maxBytes = 60000, minCompressionQua
     }
     return undefined;
 }
-exports.getCompressedJpegFromCanvas = getCompressedJpegFromCanvas;
 //# sourceMappingURL=ImageUtil.js.map

package/lib/cjs/common/ImageUtil.js.map

@@ -1 +1 @@
-{"version":3,"file":"ImageUtil.js","sourceRoot":"","sources":["../../../src/common/ImageUtil.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { Point2d } from \"@itwin/core-geometry\";\r\nimport { ImageBuffer, ImageBufferFormat, ImageSource, ImageSourceFormat } from \"@itwin/core-common\";\r\nimport { ViewRect } from \"./ViewRect\";\r\n\r\ninterface Rgba {\r\n  r: number;\r\n  g: number;\r\n  b: number;\r\n  a: number;\r\n}\r\n\r\nconst scratchRgba = { r: 0, g: 0, b: 0, a: 0 };\r\n\r\nfunction rgbaFromAlpha(rgba: Rgba, src: Uint8Array, idx: number): number {\r\n  rgba.r = rgba.g = rgba.b = rgba.a = src[idx];\r\n  return idx + 1;\r\n}\r\n\r\nfunction rgbaFromRgb(rgba: Rgba, src: Uint8Array, idx: number): number {\r\n  rgba.r = src[idx + 0];\r\n  rgba.g = src[idx + 1];\r\n  rgba.b = src[idx + 2];\r\n  rgba.a = 255;\r\n  return idx + 3;\r\n}\r\n\r\nfunction rgbaFromRgba(rgba: Rgba, src: Uint8Array, idx: number): number {\r\n  rgbaFromRgb(rgba, src, idx);\r\n  rgba.a = src[idx + 3];\r\n  return idx + 4;\r\n}\r\n\r\n/** Resize a canvas to a desired size.  The final size will be targetSize plus barSize.  The original canvas is left untouched and a new, resized canvas with potential side bars is returned.\r\n * @param canvasIn the source [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement) to resize.\r\n * @param targetSize the desired new size for the canvas image.\r\n * @param barSize total size of side bars to add to the image in width and height; defaults to (0, 0).  For example, if you specify (2, 0), a 1 pixel side bar will be added to the left and right sides of the resized image.  If an odd dimension is specified, the left or upper side of the image will be one pixel larger than the opposite side.  For example, if you specify (1, 0), a 1 pixel side bar will be added to the left side of the image and a 0 pixel side bar will be added to the right side of the image.\r\n * @param barStyle CSS style string to apply to any side bars; defaults to \"#C0C0C0\", which is silver.\r\n * @returns an [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement) object containing the resized image and any requested side bars.\r\n * @public\r\n * @extensions\r\n */\r\nexport function canvasToResizedCanvasWithBars(canvasIn: HTMLCanvasElement, targetSize: Point2d, barSize = new Point2d(0, 0), barStyle = \"#C0C0C0\"): HTMLCanvasElement {\r\n  const canvasOut = document.createElement(\"canvas\");\r\n  canvasOut.width = targetSize.x + barSize.x;\r\n  canvasOut.height = targetSize.y + barSize.y;\r\n\r\n  let adjustImageX = barSize.x / 2;\r\n  let adjustImageY = barSize.y / 2;\r\n\r\n  if (1 === barSize.x % 2) {\r\n    adjustImageX += 0.5;\r\n  }\r\n  if (1 === barSize.y % 2) {\r\n    adjustImageY += 0.5;\r\n  }\r\n\r\n  const context = canvasOut.getContext(\"2d\")!;\r\n  context.fillStyle = barStyle;\r\n  context.fillRect(0, 0, canvasOut.width, canvasOut.height);\r\n  context.drawImage(canvasIn, adjustImageX, adjustImageY, targetSize.x, targetSize.y);\r\n  return canvasOut;\r\n}\r\n\r\n/** Create a canvas element with the same dimensions and contents as an image buffer.\r\n * @param buffer the source [[ImageBuffer]] object from which the [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement) object will be constructed.\r\n * @param preserveAlpha If false, the alpha channel will be set to 255 (fully opaque). This is recommended when converting an already-blended image (e.g., one obtained from [[Viewport.readImageBuffer]]).\r\n * @returns an [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement) object containing the contents of the source image buffer, or undefined if the conversion fails.\r\n * @public\r\n * @extensions\r\n */\r\nexport function imageBufferToCanvas(buffer: ImageBuffer, preserveAlpha: boolean = true): HTMLCanvasElement | undefined {\r\n  const canvas = document.createElement(\"canvas\");\r\n  if (null === canvas)\r\n    return undefined;\r\n\r\n  canvas.width = buffer.width;\r\n  canvas.height = buffer.height;\r\n\r\n  const context = canvas.getContext(\"2d\");\r\n  if (null === context)\r\n    return undefined;\r\n\r\n  const imageData = context.createImageData(buffer.width, buffer.height);\r\n  const extractRgba = ImageBufferFormat.Alpha === buffer.format ? rgbaFromAlpha : (ImageBufferFormat.Rgb === buffer.format ? rgbaFromRgb : rgbaFromRgba);\r\n\r\n  const bufferData = buffer.data;\r\n  let i = 0;\r\n  let j = 0;\r\n  const rgba = scratchRgba;\r\n  while (i < bufferData.length) {\r\n    i = extractRgba(rgba, bufferData, i);\r\n    imageData.data[j + 0] = rgba.r;\r\n    imageData.data[j + 1] = rgba.g;\r\n    imageData.data[j + 2] = rgba.b;\r\n    imageData.data[j + 3] = preserveAlpha ? rgba.a : 0xff;\r\n    j += 4;\r\n  }\r\n\r\n  context.putImageData(imageData, 0, 0);\r\n  return canvas;\r\n}\r\n\r\n/** Create an ImageBuffer in the specified format with the same dimensions and contents as a canvas.\r\n * @param canvas the source [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement) object from which the [[ImageBuffer]] object will be constructed.\r\n * @param format the desired format of the created ImageBuffer; defaults to [[ImageBufferFormat.Rgba]].\r\n * @returns an [[ImageBuffer]] object containing the contents of the source canvas, or undefined if the conversion fails.\r\n * @public\r\n * @extensions\r\n */\r\nexport function canvasToImageBuffer(canvas: HTMLCanvasElement, format = ImageBufferFormat.Rgba): ImageBuffer | undefined {\r\n  const context = canvas.getContext(\"2d\");\r\n  if (null === context)\r\n    return undefined;\r\n\r\n  const imageData = context.getImageData(0, 0, canvas.width, canvas.height);\r\n\r\n  let imageBufferData: Uint8Array | undefined;\r\n\r\n  if (ImageBufferFormat.Rgba === format) {\r\n    imageBufferData = new Uint8Array(imageData.data.length);\r\n  } else if (ImageBufferFormat.Rgb === format) {\r\n    imageBufferData = new Uint8Array((imageData.data.length / 4) * 3);\r\n  } else if (ImageBufferFormat.Alpha === format) {\r\n    imageBufferData = new Uint8Array(imageData.data.length / 4);\r\n  }\r\n\r\n  if (undefined === imageBufferData)\r\n    return undefined;\r\n\r\n  let i = 0;\r\n  let j = 0;\r\n  while (i < imageData.data.length) {\r\n    if (ImageBufferFormat.Rgba === format) {\r\n      imageBufferData[j + 0] = imageData.data[i + 0];\r\n      imageBufferData[j + 1] = imageData.data[i + 1];\r\n      imageBufferData[j + 2] = imageData.data[i + 2];\r\n      imageBufferData[j + 3] = imageData.data[i + 3];\r\n      j += 4;\r\n    } else if (ImageBufferFormat.Rgb === format) {\r\n      imageBufferData[j + 0] = imageData.data[i + 0];\r\n      imageBufferData[j + 1] = imageData.data[i + 1];\r\n      imageBufferData[j + 2] = imageData.data[i + 2];\r\n      j += 3;\r\n    } else if (ImageBufferFormat.Alpha === format) {\r\n      imageBufferData[j] = imageData.data[i + 3];\r\n      j++;\r\n    }\r\n    i += 4;\r\n  }\r\n\r\n  return ImageBuffer.create(imageBufferData, format, canvas.width);\r\n}\r\n\r\n/** Get a string describing the mime type associated with an ImageSource format.\r\n * @public\r\n * @extensions\r\n */\r\nexport function getImageSourceMimeType(format: ImageSourceFormat): string {\r\n\r\n  switch (format) {\r\n    case ImageSourceFormat.Jpeg:\r\n      return \"image/jpeg\";\r\n    case ImageSourceFormat.Png:\r\n      return \"image/png\";\r\n    case ImageSourceFormat.Svg:\r\n      return \"image/svg+xml;charset=utf-8\";\r\n  }\r\n  return \"\";\r\n}\r\n\r\n/** Get the ImageSourceFormat corresponding to the mime type string, or undefined if the string does not identify a supported ImageSourceFormat.\r\n * @public\r\n * @extensions\r\n */\r\nexport function getImageSourceFormatForMimeType(mimeType: string): ImageSourceFormat | undefined {\r\n  switch (mimeType) {\r\n    case \"image/jpeg\": return ImageSourceFormat.Jpeg;\r\n    // not standard, but people accidentally use it anyway.\r\n    case \"image/jpg\": return ImageSourceFormat.Jpeg;\r\n    case \"image/png\": return ImageSourceFormat.Png;\r\n    case \"image/svg+xml;charset=utf-8\": return ImageSourceFormat.Svg;\r\n    default: return undefined;\r\n  }\r\n}\r\n\r\n/** Extract an html Image element from a binary jpeg or png.\r\n * @param source The ImageSource containing the binary jpeg or png data.\r\n * @returns a Promise which resolves to an HTMLImageElement containing the uncompressed bitmap image in RGBA format.\r\n * @public\r\n * @extensions\r\n */\r\nexport async function imageElementFromImageSource(source: ImageSource): Promise<HTMLImageElement> {\r\n  const blob = new Blob([source.data], { type: getImageSourceMimeType(source.format) });\r\n  return imageElementFromUrl(URL.createObjectURL(blob));\r\n}\r\n\r\n/** Extract a bitmap from a binary jpeg or png.\r\n * @param source The ImageSource containing the binary jpeg or png data.\r\n * @returns a Promise which resolves to an ImageBitmap containing the uncompressed bitmap image in RGBA format.\r\n * @public\r\n */\r\nexport async function imageBitmapFromImageSource(source: ImageSource): Promise<ImageBitmap> {\r\n  const blob = new Blob([source.data], { type: getImageSourceMimeType(source.format) });\r\n  return createImageBitmap(blob, {\r\n    premultiplyAlpha: \"none\",\r\n    colorSpaceConversion: \"none\",\r\n  });\r\n}\r\n\r\n/** Create an html Image element from a URL.\r\n * @param url The URL pointing to the image data.\r\n * @param skipCrossOriginCheck Set this to true to allow an image from a different origin than the web app to load. Default is false.\r\n * @returns A Promise resolving to an HTMLImageElement when the image data has been loaded from the URL.\r\n * @see tryImageElementFromUrl.\r\n * @public\r\n * @extensions\r\n */\r\nexport async function imageElementFromUrl(url: string, skipCrossOriginCheck = false): Promise<HTMLImageElement> {\r\n  // We must set crossorigin property so that images loaded from same origin can be used with texImage2d.\r\n  // We must do that outside of the promise constructor or it won't work, for reasons.\r\n  const image = new Image();\r\n  if (!skipCrossOriginCheck) {\r\n    image.crossOrigin = \"anonymous\";\r\n  }\r\n  return new Promise((resolve: (image: HTMLImageElement) => void, reject) => {\r\n    image.onload = () => resolve(image);\r\n\r\n    // The \"error\" produced by Image is not an Error. It looks like an Event, but isn't one.\r\n    image.onerror = () => reject(new Error(\"Failed to create image from url\"));\r\n    image.src = url;\r\n  });\r\n}\r\n\r\n/** Try to create an html Image element from a URL.\r\n * @param url The URL pointing to the image data.\r\n * @param skipCrossOriginCheck Set this to true to allow an image from a different origin than the web app to load. Default is false.\r\n * @returns A Promise resolving to an HTMLImageElement when the image data has been loaded from the URL, or to `undefined` if an exception occurred.\r\n * @see imageElementFromUrl\r\n * @public\r\n */\r\nexport async function tryImageElementFromUrl(url: string, skipCrossOriginCheck = false): Promise<HTMLImageElement | undefined> {\r\n  try {\r\n    return await imageElementFromUrl(url, skipCrossOriginCheck);\r\n  } catch {\r\n    return undefined;\r\n  }\r\n}\r\n/**\r\n * Extract the dimensions of the jpeg or png data encoded in an ImageSource.\r\n * @param source The ImageSource containing the binary jpeg or png data.\r\n * @returns a Promise resolving to a Point2d of which x corresponds to the integer width of the uncompressed bitmap and y to the height.\r\n * @public\r\n * @extensions\r\n */\r\nexport async function extractImageSourceDimensions(source: ImageSource): Promise<Point2d> {\r\n  const image = await imageElementFromImageSource(source);\r\n  return new Point2d(image.naturalWidth, image.naturalHeight);\r\n}\r\n\r\n/**\r\n * Produces a data url in \"image/png\" format from the contents of an ImageBuffer.\r\n * @param buffer The ImageBuffer, of any format.\r\n * @param preserveAlpha If false, the alpha channel will be set to 255 (fully opaque). This is recommended when converting an already-blended image (e.g., one obtained from [[Viewport.readImageBuffer]]).\r\n * @returns a data url as a string suitable for setting as the `src` property of an HTMLImageElement, or undefined if the url could not be created.\r\n * @public\r\n * @extensions\r\n */\r\nexport function imageBufferToPngDataUrl(buffer: ImageBuffer, preserveAlpha = true): string | undefined {\r\n  // The default format (and the only format required to be supported) for toDataUrl() is \"image/png\".\r\n  const canvas = imageBufferToCanvas(buffer, preserveAlpha);\r\n  return undefined !== canvas ? canvas.toDataURL() : undefined;\r\n}\r\n\r\n/**\r\n * Converts the contents of an ImageBuffer to PNG format.\r\n * @param buffer The ImageBuffer, of any format.\r\n * @param preserveAlpha If false, the alpha channel will be set to 255 (fully opaque). This is recommended when converting an already-blended image (e.g., one obtained from [[Viewport.readImageBuffer]]).\r\n * @returns a base64-encoded string representing the image as a PNG, or undefined if the conversion failed.\r\n * @public\r\n * @extensions\r\n */\r\nexport function imageBufferToBase64EncodedPng(buffer: ImageBuffer, preserveAlpha = true): string | undefined {\r\n  const urlPrefix = \"data:image/png;base64,\";\r\n  const url = imageBufferToPngDataUrl(buffer, preserveAlpha);\r\n  if (undefined === url || !url.startsWith(urlPrefix))\r\n    return undefined;\r\n\r\n  return url.substring(urlPrefix.length);\r\n}\r\n\r\n/** Open an image specified as a data URL in a new window or tab. Works around differences between browsers and Electron.\r\n * @param url The base64-encoded image URL.\r\n * @param title An optional title to apply to the new window.\r\n * @beta\r\n */\r\nexport function openImageDataUrlInNewWindow(url: string, title?: string): void {\r\n  const win = window.open();\r\n  if (null === win)\r\n    return;\r\n\r\n  const div = win.document.createElement(\"div\");\r\n  div.innerHTML = `<img src='${url}'/>`;\r\n  win.document.body.append(div);\r\n  if (undefined !== title)\r\n    win.document.title = title;\r\n}\r\n\r\n/** Determine the maximum [[ViewRect]] that can be fitted and centered in specified ViewRect given a required aspect ratio.\r\n * @param viewRect The rectangle in which the returned rectangle is to be centered and fitted.\r\n * @param aspectRatio Ratio of width to height.\r\n * @returns A ViewRect centered in the input rectangle.\r\n * @public\r\n */\r\nexport function getCenteredViewRect(viewRect: ViewRect, aspectRatio = 1.4): ViewRect {\r\n  // Determine scale that ensures ability to return an image with the prescribed aspectRatio\r\n  const scale = Math.min(viewRect.width / aspectRatio, viewRect.height);\r\n  const finalWidth = scale * aspectRatio;\r\n  const finalHeight = scale;\r\n  const left = (viewRect.width - finalWidth) / 2.0;\r\n  const right = left + finalWidth;\r\n  const top = (viewRect.height - finalHeight) / 2.0;\r\n  const bottom = top + finalHeight;\r\n  return new ViewRect(left, top, right, bottom);\r\n}\r\n\r\n/** Produce a jpeg compressed to no more than specified bytes and of no less than specified quality.\r\n * @param canvas Canvas containing the image to be compressed.\r\n * @param maxBytes Maximum size of output jpeg in bytes.\r\n * @param minCompressionQuality The minimum acceptable image quality as a number between 0 (lowest quality) and 1 (highest quality).\r\n * @returns A [data URL](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs) for the image, or `undefined` if the compression and size constraints could not be met.\r\n * @public\r\n * @extensions\r\n */\r\nexport function getCompressedJpegFromCanvas(canvas: HTMLCanvasElement, maxBytes = 60000, minCompressionQuality = 0.1): string | undefined {\r\n  const decrements = 0.1; // Decrements of quality\r\n  const bytesPerCharacter = 2; // Assume 16-bit per character\r\n  let quality = 1.0; // JPEG Compression quality\r\n\r\n  while (quality > minCompressionQuality) {\r\n    const data = canvas.toDataURL(\"image/jpeg\", quality);\r\n    // If we are less than 60 Kb, we are good\r\n    if (data.length * bytesPerCharacter < maxBytes)\r\n      return data;\r\n\r\n    quality -= decrements;\r\n  }\r\n\r\n  return undefined;\r\n}\r\n"]}
+{"version":3,"file":"ImageUtil.js","sourceRoot":"","sources":["../../../src/common/ImageUtil.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { Point2d } from \"@itwin/core-geometry\";\r\nimport { ImageBuffer, ImageBufferFormat, ImageSource, ImageSourceFormat } from \"@itwin/core-common\";\r\nimport { ViewRect } from \"./ViewRect\";\r\n\r\ninterface Rgba {\r\n  r: number;\r\n  g: number;\r\n  b: number;\r\n  a: number;\r\n}\r\n\r\nconst scratchRgba = { r: 0, g: 0, b: 0, a: 0 };\r\n\r\nfunction rgbaFromAlpha(rgba: Rgba, src: Uint8Array, idx: number): number {\r\n  rgba.r = rgba.g = rgba.b = rgba.a = src[idx];\r\n  return idx + 1;\r\n}\r\n\r\nfunction rgbaFromRgb(rgba: Rgba, src: Uint8Array, idx: number): number {\r\n  rgba.r = src[idx + 0];\r\n  rgba.g = src[idx + 1];\r\n  rgba.b = src[idx + 2];\r\n  rgba.a = 255;\r\n  return idx + 3;\r\n}\r\n\r\nfunction rgbaFromRgba(rgba: Rgba, src: Uint8Array, idx: number): number {\r\n  rgbaFromRgb(rgba, src, idx);\r\n  rgba.a = src[idx + 3];\r\n  return idx + 4;\r\n}\r\n\r\n/** Resize a canvas to a desired size.  The final size will be targetSize plus barSize.  The original canvas is left untouched and a new, resized canvas with potential side bars is returned.\r\n * @param canvasIn the source [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement) to resize.\r\n * @param targetSize the desired new size for the canvas image.\r\n * @param barSize total size of side bars to add to the image in width and height; defaults to (0, 0).  For example, if you specify (2, 0), a 1 pixel side bar will be added to the left and right sides of the resized image.  If an odd dimension is specified, the left or upper side of the image will be one pixel larger than the opposite side.  For example, if you specify (1, 0), a 1 pixel side bar will be added to the left side of the image and a 0 pixel side bar will be added to the right side of the image.\r\n * @param barStyle CSS style string to apply to any side bars; defaults to \"#C0C0C0\", which is silver.\r\n * @returns an [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement) object containing the resized image and any requested side bars.\r\n * @public\r\n * @extensions\r\n */\r\nexport function canvasToResizedCanvasWithBars(canvasIn: HTMLCanvasElement, targetSize: Point2d, barSize = new Point2d(0, 0), barStyle = \"#C0C0C0\"): HTMLCanvasElement {\r\n  const canvasOut = document.createElement(\"canvas\");\r\n  canvasOut.width = targetSize.x + barSize.x;\r\n  canvasOut.height = targetSize.y + barSize.y;\r\n\r\n  let adjustImageX = barSize.x / 2;\r\n  let adjustImageY = barSize.y / 2;\r\n\r\n  if (1 === barSize.x % 2) {\r\n    adjustImageX += 0.5;\r\n  }\r\n  if (1 === barSize.y % 2) {\r\n    adjustImageY += 0.5;\r\n  }\r\n\r\n  const context = canvasOut.getContext(\"2d\")!;\r\n  context.fillStyle = barStyle;\r\n  context.fillRect(0, 0, canvasOut.width, canvasOut.height);\r\n  context.drawImage(canvasIn, adjustImageX, adjustImageY, targetSize.x, targetSize.y);\r\n  return canvasOut;\r\n}\r\n\r\n/** Create a canvas element with the same dimensions and contents as an image buffer.\r\n * @param buffer the source [[ImageBuffer]] object from which the [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement) object will be constructed.\r\n * @param preserveAlpha If false, the alpha channel will be set to 255 (fully opaque). This is recommended when converting an already-blended image (e.g., one obtained from [[Viewport.readImageBuffer]]).\r\n * @returns an [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement) object containing the contents of the source image buffer, or undefined if the conversion fails.\r\n * @public\r\n * @extensions\r\n */\r\nexport function imageBufferToCanvas(buffer: ImageBuffer, preserveAlpha: boolean = true): HTMLCanvasElement | undefined {\r\n  const canvas = document.createElement(\"canvas\");\r\n  if (null === canvas)\r\n    return undefined;\r\n\r\n  canvas.width = buffer.width;\r\n  canvas.height = buffer.height;\r\n\r\n  const context = canvas.getContext(\"2d\");\r\n  if (null === context)\r\n    return undefined;\r\n\r\n  const imageData = context.createImageData(buffer.width, buffer.height);\r\n  const extractRgba = ImageBufferFormat.Alpha === buffer.format ? rgbaFromAlpha : (ImageBufferFormat.Rgb === buffer.format ? rgbaFromRgb : rgbaFromRgba);\r\n\r\n  const bufferData = buffer.data;\r\n  let i = 0;\r\n  let j = 0;\r\n  const rgba = scratchRgba;\r\n  while (i < bufferData.length) {\r\n    i = extractRgba(rgba, bufferData, i);\r\n    imageData.data[j + 0] = rgba.r;\r\n    imageData.data[j + 1] = rgba.g;\r\n    imageData.data[j + 2] = rgba.b;\r\n    imageData.data[j + 3] = preserveAlpha ? rgba.a : 0xff;\r\n    j += 4;\r\n  }\r\n\r\n  context.putImageData(imageData, 0, 0);\r\n  return canvas;\r\n}\r\n\r\n/** Create an ImageBuffer in the specified format with the same dimensions and contents as a canvas.\r\n * @param canvas the source [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement) object from which the [[ImageBuffer]] object will be constructed.\r\n * @param format the desired format of the created ImageBuffer; defaults to [[ImageBufferFormat.Rgba]].\r\n * @returns an [[ImageBuffer]] object containing the contents of the source canvas, or undefined if the conversion fails.\r\n * @public\r\n * @extensions\r\n */\r\nexport function canvasToImageBuffer(canvas: HTMLCanvasElement, format = ImageBufferFormat.Rgba): ImageBuffer | undefined {\r\n  const context = canvas.getContext(\"2d\");\r\n  if (null === context)\r\n    return undefined;\r\n\r\n  const imageData = context.getImageData(0, 0, canvas.width, canvas.height);\r\n\r\n  let imageBufferData: Uint8Array | undefined;\r\n\r\n  if (ImageBufferFormat.Rgba === format) {\r\n    imageBufferData = new Uint8Array(imageData.data.length);\r\n  } else if (ImageBufferFormat.Rgb === format) {\r\n    imageBufferData = new Uint8Array((imageData.data.length / 4) * 3);\r\n  } else if (ImageBufferFormat.Alpha === format) {\r\n    imageBufferData = new Uint8Array(imageData.data.length / 4);\r\n  }\r\n\r\n  if (undefined === imageBufferData)\r\n    return undefined;\r\n\r\n  let i = 0;\r\n  let j = 0;\r\n  while (i < imageData.data.length) {\r\n    if (ImageBufferFormat.Rgba === format) {\r\n      imageBufferData[j + 0] = imageData.data[i + 0];\r\n      imageBufferData[j + 1] = imageData.data[i + 1];\r\n      imageBufferData[j + 2] = imageData.data[i + 2];\r\n      imageBufferData[j + 3] = imageData.data[i + 3];\r\n      j += 4;\r\n    } else if (ImageBufferFormat.Rgb === format) {\r\n      imageBufferData[j + 0] = imageData.data[i + 0];\r\n      imageBufferData[j + 1] = imageData.data[i + 1];\r\n      imageBufferData[j + 2] = imageData.data[i + 2];\r\n      j += 3;\r\n    } else if (ImageBufferFormat.Alpha === format) {\r\n      imageBufferData[j] = imageData.data[i + 3];\r\n      j++;\r\n    }\r\n    i += 4;\r\n  }\r\n\r\n  return ImageBuffer.create(imageBufferData, format, canvas.width);\r\n}\r\n\r\n/** Get a string describing the mime type associated with an ImageSource format.\r\n * @public\r\n * @extensions\r\n */\r\nexport function getImageSourceMimeType(format: ImageSourceFormat): string {\r\n\r\n  switch (format) {\r\n    case ImageSourceFormat.Jpeg:\r\n      return \"image/jpeg\";\r\n    case ImageSourceFormat.Png:\r\n      return \"image/png\";\r\n    case ImageSourceFormat.Svg:\r\n      return \"image/svg+xml;charset=utf-8\";\r\n  }\r\n  return \"\";\r\n}\r\n\r\n/** Get the ImageSourceFormat corresponding to the mime type string, or undefined if the string does not identify a supported ImageSourceFormat.\r\n * @public\r\n * @extensions\r\n */\r\nexport function getImageSourceFormatForMimeType(mimeType: string): ImageSourceFormat | undefined {\r\n  switch (mimeType) {\r\n    case \"image/jpeg\": return ImageSourceFormat.Jpeg;\r\n    // not standard, but people accidentally use it anyway.\r\n    case \"image/jpg\": return ImageSourceFormat.Jpeg;\r\n    case \"image/png\": return ImageSourceFormat.Png;\r\n    case \"image/svg+xml;charset=utf-8\": return ImageSourceFormat.Svg;\r\n    default: return undefined;\r\n  }\r\n}\r\n\r\n/** Extract an html Image element from a binary jpeg or png.\r\n * @param source The ImageSource containing the binary jpeg or png data.\r\n * @returns a Promise which resolves to an HTMLImageElement containing the uncompressed bitmap image in RGBA format.\r\n * @public\r\n * @extensions\r\n */\r\nexport async function imageElementFromImageSource(source: ImageSource): Promise<HTMLImageElement> {\r\n  const blob = new Blob([source.data], { type: getImageSourceMimeType(source.format) });\r\n  return imageElementFromUrl(URL.createObjectURL(blob));\r\n}\r\n\r\n/** Extract a bitmap from a binary jpeg or png.\r\n * @param source The ImageSource containing the binary jpeg or png data.\r\n * @returns a Promise which resolves to an ImageBitmap containing the uncompressed bitmap image in RGBA format.\r\n * @public\r\n */\r\nexport async function imageBitmapFromImageSource(source: ImageSource): Promise<ImageBitmap> {\r\n  const blob = new Blob([source.data], { type: getImageSourceMimeType(source.format) });\r\n  return createImageBitmap(blob, {\r\n    premultiplyAlpha: \"none\",\r\n    colorSpaceConversion: \"none\",\r\n  });\r\n}\r\n\r\n/** Create an html Image element from a URL.\r\n * @param url The URL pointing to the image data.\r\n * @param skipCrossOriginCheck Set this to true to allow an image from a different origin than the web app to load. Default is false.\r\n * @returns A Promise resolving to an HTMLImageElement when the image data has been loaded from the URL.\r\n * @see tryImageElementFromUrl.\r\n * @public\r\n * @extensions\r\n */\r\nexport async function imageElementFromUrl(url: string, skipCrossOriginCheck = false): Promise<HTMLImageElement> {\r\n  // We must set crossorigin property so that images loaded from same origin can be used with texImage2d.\r\n  // We must do that outside of the promise constructor or it won't work, for reasons.\r\n  const image = new Image();\r\n  if (!skipCrossOriginCheck) {\r\n    image.crossOrigin = \"anonymous\";\r\n  }\r\n  return new Promise((resolve: (image: HTMLImageElement) => void, reject) => {\r\n    image.onload = () => resolve(image);\r\n\r\n    // The \"error\" produced by Image is not an Error. It looks like an Event, but isn't one.\r\n    image.onerror = () => reject(new Error(\"Failed to create image from url\"));\r\n    image.src = url;\r\n  });\r\n}\r\n\r\n/** Try to create an html Image element from a URL.\r\n * @param url The URL pointing to the image data.\r\n * @param skipCrossOriginCheck Set this to true to allow an image from a different origin than the web app to load. Default is false.\r\n * @returns A Promise resolving to an HTMLImageElement when the image data has been loaded from the URL, or to `undefined` if an exception occurred.\r\n * @see imageElementFromUrl\r\n * @public\r\n */\r\nexport async function tryImageElementFromUrl(url: string, skipCrossOriginCheck = false): Promise<HTMLImageElement | undefined> {\r\n  try {\r\n    return await imageElementFromUrl(url, skipCrossOriginCheck);\r\n  } catch {\r\n    return undefined;\r\n  }\r\n}\r\n/**\r\n * Extract the dimensions of the jpeg or png data encoded in an ImageSource.\r\n * @param source The ImageSource containing the binary jpeg or png data.\r\n * @returns a Promise resolving to a Point2d of which x corresponds to the integer width of the uncompressed bitmap and y to the height.\r\n * @public\r\n * @extensions\r\n */\r\nexport async function extractImageSourceDimensions(source: ImageSource): Promise<Point2d> {\r\n  const image = await imageElementFromImageSource(source);\r\n  return new Point2d(image.naturalWidth, image.naturalHeight);\r\n}\r\n\r\n/**\r\n * Produces a data url in \"image/png\" format from the contents of an ImageBuffer.\r\n * @param buffer The ImageBuffer, of any format.\r\n * @param preserveAlpha If false, the alpha channel will be set to 255 (fully opaque). This is recommended when converting an already-blended image (e.g., one obtained from [[Viewport.readImageBuffer]]).\r\n * @returns a data url as a string suitable for setting as the `src` property of an HTMLImageElement, or undefined if the url could not be created.\r\n * @public\r\n * @extensions\r\n */\r\nexport function imageBufferToPngDataUrl(buffer: ImageBuffer, preserveAlpha = true): string | undefined {\r\n  // The default format (and the only format required to be supported) for toDataUrl() is \"image/png\".\r\n  const canvas = imageBufferToCanvas(buffer, preserveAlpha);\r\n  return undefined !== canvas ? canvas.toDataURL() : undefined;\r\n}\r\n\r\n/**\r\n * Converts the contents of an ImageBuffer to PNG format.\r\n * @param buffer The ImageBuffer, of any format.\r\n * @param preserveAlpha If false, the alpha channel will be set to 255 (fully opaque). This is recommended when converting an already-blended image (e.g., one obtained from [[Viewport.readImageBuffer]]).\r\n * @returns a base64-encoded string representing the image as a PNG, or undefined if the conversion failed.\r\n * @public\r\n * @extensions\r\n */\r\nexport function imageBufferToBase64EncodedPng(buffer: ImageBuffer, preserveAlpha = true): string | undefined {\r\n  const urlPrefix = \"data:image/png;base64,\";\r\n  const url = imageBufferToPngDataUrl(buffer, preserveAlpha);\r\n  if (undefined === url || !url.startsWith(urlPrefix))\r\n    return undefined;\r\n\r\n  return url.substring(urlPrefix.length);\r\n}\r\n\r\n/** Open an image specified as a data URL in a new window or tab. Works around differences between browsers and Electron.\r\n * @param url The base64-encoded image URL.\r\n * @param title An optional title to apply to the new window.\r\n * @beta\r\n */\r\nexport function openImageDataUrlInNewWindow(url: string, title?: string): void {\r\n  const win = window.open();\r\n  if (null === win)\r\n    return;\r\n\r\n  const div = win.document.createElement(\"div\");\r\n  div.innerHTML = `<img src='${url}'/>`;\r\n  win.document.body.append(div);\r\n  if (undefined !== title)\r\n    win.document.title = title;\r\n}\r\n\r\n/** Determine the maximum [[ViewRect]] that can be fitted and centered in specified ViewRect given a required aspect ratio.\r\n * @param viewRect The rectangle in which the returned rectangle is to be centered and fitted.\r\n * @param aspectRatio Ratio of width to height.\r\n * @returns A ViewRect centered in the input rectangle.\r\n * @public\r\n */\r\nexport function getCenteredViewRect(viewRect: ViewRect, aspectRatio = 1.4): ViewRect {\r\n  // Determine scale that ensures ability to return an image with the prescribed aspectRatio\r\n  const scale = Math.min(viewRect.width / aspectRatio, viewRect.height);\r\n  const finalWidth = scale * aspectRatio;\r\n  const finalHeight = scale;\r\n  const left = (viewRect.width - finalWidth) / 2.0;\r\n  const right = left + finalWidth;\r\n  const top = (viewRect.height - finalHeight) / 2.0;\r\n  const bottom = top + finalHeight;\r\n  return new ViewRect(left, top, right, bottom);\r\n}\r\n\r\n/** Produce a jpeg compressed to no more than specified bytes and of no less than specified quality.\r\n * @param canvas Canvas containing the image to be compressed.\r\n * @param maxBytes Maximum size of output jpeg in bytes.\r\n * @param minCompressionQuality The minimum acceptable image quality as a number between 0 (lowest quality) and 1 (highest quality).\r\n * @returns A [data URL](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs) for the image, or `undefined` if the compression and size constraints could not be met.\r\n * @public\r\n * @extensions\r\n */\r\nexport function getCompressedJpegFromCanvas(canvas: HTMLCanvasElement, maxBytes = 60000, minCompressionQuality = 0.1): string | undefined {\r\n  const decrements = 0.1; // Decrements of quality\r\n  const bytesPerCharacter = 2; // Assume 16-bit per character\r\n  let quality = 1.0; // JPEG Compression quality\r\n\r\n  while (quality > minCompressionQuality) {\r\n    const data = canvas.toDataURL(\"image/jpeg\", quality);\r\n    // If we are less than 60 Kb, we are good\r\n    if (data.length * bytesPerCharacter < maxBytes)\r\n      return data;\r\n\r\n    quality -= decrements;\r\n  }\r\n\r\n  return undefined;\r\n}\r\n"]}

package/lib/cjs/common/WorkerProxy.d.ts

@@ -1,3 +1,7 @@
+/** @packageDocumentation
+ * @module Utils
+ */
+import { MaybePromise } from "@itwin/core-bentley";
 /** Given an interface T that defines the operations provided by a worker, produce an interface that can be used to asynchronously invoke those operations
  * from the main thread, optionally passing an array of values to be transferred from the main thread to the worker.
  *  - Every return type is converted to a `Promise` (i.e., every function becomes `async`)>.
@@ -12,14 +16,14 @@ export type WorkerInterface<T> = {
     [P in keyof T]: T[P] extends () => any ? () => Promise<ReturnType<T[P]>> : (T[P] extends (arg: any) => any ? (arg: Parameters<T[P]>[0], transfer?: Transferable[]) => Promise<ReturnType<T[P]>> : (T[P] extends (...args: any) => any ? (args: Parameters<T[P]>, transfer?: Transferable[]) => Promise<ReturnType<T[P]>> : never));
 };
 /** Augments each method of `T` with the ability to specify values to be transferred from the worker thread to the main thread.
- * Each return type `R` is replaced with `R | { result: R; transfer: Transferable[]; }`.
+ * Each return type `R` is replaced with `R | { result: R; transfer: Transferable[]; }`, or a promise that resolves to such a type.
  * @see [[WorkerImplementation]].
  * @beta
  */
-export type WorkerReturnType<T extends (...args: any) => any> = ReturnType<T> | {
-    result: ReturnType<T>;
+export type WorkerReturnType<T extends (...args: any) => any> = MaybePromise<ReturnType<T> | {
+    result: Awaited<ReturnType<T>>;
     transfer: Transferable[];
-};
+}>;
 /** Given an interface T that defines the operations provided by a worker, produce an interface to which the implementation of those operations must conform.
  * The return type of each function is enhanced to permit supplying a list of values to be transferred from the worker to the main thread.
  * Multi-argument functions are converted to functions accepting a single tuple of arguments.

package/lib/cjs/common/WorkerProxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerProxy.d.ts","sourceRoot":"","sources":["../../../src/common/WorkerProxy.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;KAC9B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACtE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClH,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAChI;CACJ,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC;AAEpI;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;KACnC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACnE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACpF,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAClG;CACJ,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG;IAChD,4BAA4B;IAC5B,SAAS,IAAI,IAAI,CAAC;IAClB,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CA+CzE"}
+{"version":3,"file":"WorkerProxy.d.ts","sourceRoot":"","sources":["../../../src/common/WorkerProxy.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAU,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAyB3D;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;KAC9B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACtE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClH,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAChI;CACJ,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CAAC;AAE3J;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;KACnC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACnE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACpF,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAClG;CACJ,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG;IAChD,4BAA4B;IAC5B,SAAS,IAAI,IAAI,CAAC;IAClB,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CA+CzE"}

package/lib/cjs/common/WorkerProxy.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createWorkerProxy = void 0;
+exports.createWorkerProxy = createWorkerProxy;
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -60,5 +60,4 @@ function createWorkerProxy(workerJsPath) {
         },
     });
 }
-exports.createWorkerProxy = createWorkerProxy;
 //# sourceMappingURL=WorkerProxy.js.map

package/lib/cjs/common/WorkerProxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerProxy.js","sourceRoot":"","sources":["../../../src/common/WorkerProxy.ts"],"names":[],"mappings":";;;AAAA;;;+FAG+F;AAC/F;;GAEG;AACH,sDAA6C;AAiF7C;;;GAGG;AACH,SAAgB,iBAAiB,CAAI,YAAoB;IACvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IACtC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,IAAI,MAAc,CAAC;IACnB,MAAM,UAAU,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC;IAC7F,IAAI,UAAU,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,CAAC,kBAAkB,YAAY,KAAK,CAAC,CAAC,CAAC;QACnE,MAAM,aAAa,GAAG,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,SAAS,GAAG,CAAC,CAAe,EAAE,EAAE;QACrC,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAsB,CAAC;QAC1C,IAAA,qBAAM,EAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACrC,IAAA,qBAAM,EAAC,QAAQ,IAAI,QAAQ,IAAI,OAAO,IAAI,QAAQ,CAAC,CAAC;QAEpD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,QAAQ,CAAC,KAAK;gBAChB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;;gBAE5B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,IAAI,KAAK,CAAC,EAAoB,EAAE;QACrC,GAAG,CAAC,OAAO,EAAE,SAAiB;YAC5B,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;gBAC9B,IAAA,qBAAM,EAAC,CAAC,UAAU,CAAC,CAAC;gBACpB,UAAU,GAAG,IAAI,CAAC;gBAClB,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAClC,CAAC;iBAAM,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;gBACxC,OAAO,UAAU,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,OAAO,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;oBAC/D,MAAM,KAAK,GAAG,EAAE,QAAQ,CAAC;oBACzB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;oBACtC,MAAM,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC5E,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AA/CD,8CA+CC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Utils\r\n */\r\nimport { assert } from \"@itwin/core-bentley\";\r\n\r\n/** Holds callbacks for a Promise produced for a particular call to postMessage. */\r\ninterface Task {\r\n  reject: (result: any) => void;\r\n  resolve: (error: Error) => void;\r\n}\r\n\r\n/** The successful result of a worker operation, correlated with the id of the caller to resolve with the result. */\r\ninterface WorkerResult {\r\n  msgId: number;\r\n  result: any;\r\n  error?: never;\r\n}\r\n\r\n/** An error resulting from a worker operation, correlated with the id of the caller to reject with the error. */\r\ninterface WorkerError {\r\n  msgId: number;\r\n  error: Error;\r\n  result?: never;\r\n}\r\n\r\n/** Response to `postMessage` produced by a worker operation. */\r\ntype WorkerResponse = WorkerResult | WorkerError;\r\n\r\n/** Given an interface T that defines the operations provided by a worker, produce an interface that can be used to asynchronously invoke those operations\r\n * from the main thread, optionally passing an array of values to be transferred from the main thread to the worker.\r\n *  - Every return type is converted to a `Promise` (i.e., every function becomes `async`)>.\r\n *  - `zeroArgFunc(): R` becomes `async zeroArgFunc(): Promise<R>`.\r\n *  - `oneArgFunc(arg: U): R` becomes `async oneArgFunc(arg: U, transfer?: Transferable[]): Promise<R>`.\r\n *  - `multiArgFunc(arg1: U, arg2: V): R` becomes `async multiArgFunc(args: [U, V], transfer?: Transferable[]): Promise<R>`.\r\n * @note All parameters of all methods of `T` must support [structured cloning](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm) -\r\n * attempts to pass functions, instances of classes, DOM nodes, WebGL resources, and other non-cloneable types will compile but fail at run-time.\r\n * @beta\r\n */\r\nexport type WorkerInterface<T> = {\r\n  [P in keyof T]: T[P] extends () => any ? () => Promise<ReturnType<T[P]>> :\r\n    (T[P] extends (arg: any) => any ? (arg: Parameters<T[P]>[0], transfer?: Transferable[]) => Promise<ReturnType<T[P]>> :\r\n      (T[P] extends (...args: any) => any ? (args: Parameters<T[P]>, transfer?: Transferable[]) => Promise<ReturnType<T[P]>> : never)\r\n    )\r\n};\r\n\r\n/** Augments each method of `T` with the ability to specify values to be transferred from the worker thread to the main thread.\r\n * Each return type `R` is replaced with `R | { result: R; transfer: Transferable[]; }`.\r\n * @see [[WorkerImplementation]].\r\n * @beta\r\n */\r\nexport type WorkerReturnType<T extends (...args: any) => any> = ReturnType<T> | { result: ReturnType<T>, transfer: Transferable[] };\r\n\r\n/** Given an interface T that defines the operations provided by a worker, produce an interface to which the implementation of those operations must conform.\r\n * The return type of each function is enhanced to permit supplying a list of values to be transferred from the worker to the main thread.\r\n * Multi-argument functions are converted to functions accepting a single tuple of arguments.\r\n *  - Every return type `R` is converted to `WorkerReturnType<R>`.\r\n *  - `zeroArgFunc(): R` becomes `zeroArgFunc(): R | { result: R; transfer: Transferable[]; }`.\r\n *  - `oneArgFunc(arg: U): R` becomes `oneArgFunc(arg: U): R | { result: R; transfer: Transferable[]; }`.\r\n *  - `multiArgFunc(arg1: U, arg2: V): R` becomes `multiArgFunc([U, V]): R | { result: R; transfer: Transferable[]; }`.\r\n * @note All parameters of all methods of `T` must support [structured cloning](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm) -\r\n * attempts to pass functions, instances of classes, DOM nodes, WebGL resources, and other non-cloneable types will compile but fail at run-time.\r\n * @beta\r\n */\r\nexport type WorkerImplementation<T> = {\r\n  [P in keyof T]: T[P] extends () => any ? () => WorkerReturnType<T[P]> :\r\n    (T[P] extends (arg: any) => any ? (arg: Parameters<T[P]>[0]) => WorkerReturnType<T[P]> :\r\n      (T[P] extends (...args: any) => any ? (args: Parameters<T[P]>) => WorkerReturnType<T[P]> : never)\r\n    )\r\n};\r\n\r\n/** A proxy for a [web worker](https://developer.mozilla.org/en-US/docs/Web/API/Worker) that provides the operations specified by\r\n * the methods of `T`.\r\n * To use a worker proxy, define a worker script that provides [[registerWorker]] with an implementation of `T`, and obtain a proxy\r\n * via [[createWorkerProxy]] on the main thread. The proxy can then be used to asynchronously invoke methods of `T` on the worker.\r\n * See [this article]($docs/learning/frontend/WorkerProxy.md) for more details and examples.\r\n * @beta\r\n */\r\nexport type WorkerProxy<T> = WorkerInterface<T> & {\r\n  /** Terminate the worker. */\r\n  terminate(): void;\r\n  /** Returns true if [[terminate]] has been called. */\r\n  readonly isTerminated: boolean;\r\n};\r\n\r\n/** Create a [[WorkerProxy]] implementing the methods of `T` using the specified worker script.\r\n * See [this article]($docs/learning/frontend/WorkerProxy.md) for more details and examples.\r\n * @beta\r\n */\r\nexport function createWorkerProxy<T>(workerJsPath: string): WorkerProxy<T> {\r\n  const tasks = new Map<number, Task>();\r\n  let curMsgId = 0;\r\n  let terminated = false;\r\n\r\n  let worker: Worker;\r\n  const sameOrigin = workerJsPath.substring(0, globalThis.origin.length) === globalThis.origin;\r\n  if (sameOrigin || !workerJsPath.startsWith(\"http\")) {\r\n    worker = new Worker(workerJsPath);\r\n  } else {\r\n    const workerBlob = new Blob([`importScripts(\"${workerJsPath}\");`]);\r\n    const workerBlobUrl = URL.createObjectURL(workerBlob);\r\n    worker = new Worker(workerBlobUrl);\r\n  }\r\n\r\n  worker.onmessage = (e: MessageEvent) => {\r\n    const response = e.data as WorkerResponse;\r\n    assert(typeof response === \"object\");\r\n    assert(\"result\" in response || \"error\" in response);\r\n\r\n    const task = tasks.get(response.msgId);\r\n    if (task) {\r\n      tasks.delete(response.msgId);\r\n      if (response.error)\r\n        task.reject(response.error);\r\n      else\r\n        task.resolve(response.result);\r\n    }\r\n  };\r\n\r\n  return new Proxy({} as WorkerProxy<T>, {\r\n    get(_target, operation: string) {\r\n      if (operation === \"terminate\") {\r\n        assert(!terminated);\r\n        terminated = true;\r\n        return () => worker.terminate();\r\n      } else if (operation === \"isTerminated\") {\r\n        return terminated;\r\n      } else {\r\n        return async (...args: any[]) => new Promise((resolve, reject) => {\r\n          const msgId = ++curMsgId;\r\n          tasks.set(msgId, { resolve, reject });\r\n          worker.postMessage({ operation, payload: args[0], msgId }, args[1] ?? []);\r\n        });\r\n      }\r\n    },\r\n  });\r\n}\r\n"]}
+{"version":3,"file":"WorkerProxy.js","sourceRoot":"","sources":["../../../src/common/WorkerProxy.ts"],"names":[],"mappings":";;AA4FA,8CA+CC;AA3ID;;;+FAG+F;AAC/F;;GAEG;AACH,sDAA2D;AAiF3D;;;GAGG;AACH,SAAgB,iBAAiB,CAAI,YAAoB;IACvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IACtC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,IAAI,MAAc,CAAC;IACnB,MAAM,UAAU,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC;IAC7F,IAAI,UAAU,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,CAAC,kBAAkB,YAAY,KAAK,CAAC,CAAC,CAAC;QACnE,MAAM,aAAa,GAAG,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,SAAS,GAAG,CAAC,CAAe,EAAE,EAAE;QACrC,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAsB,CAAC;QAC1C,IAAA,qBAAM,EAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACrC,IAAA,qBAAM,EAAC,QAAQ,IAAI,QAAQ,IAAI,OAAO,IAAI,QAAQ,CAAC,CAAC;QAEpD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,QAAQ,CAAC,KAAK;gBAChB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;;gBAE5B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,IAAI,KAAK,CAAC,EAAoB,EAAE;QACrC,GAAG,CAAC,OAAO,EAAE,SAAiB;YAC5B,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;gBAC9B,IAAA,qBAAM,EAAC,CAAC,UAAU,CAAC,CAAC;gBACpB,UAAU,GAAG,IAAI,CAAC;gBAClB,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAClC,CAAC;iBAAM,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;gBACxC,OAAO,UAAU,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,OAAO,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;oBAC/D,MAAM,KAAK,GAAG,EAAE,QAAQ,CAAC;oBACzB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;oBACtC,MAAM,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC5E,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Utils\r\n */\r\nimport { assert, MaybePromise } from \"@itwin/core-bentley\";\r\n\r\n/** Holds callbacks for a Promise produced for a particular call to postMessage. */\r\ninterface Task {\r\n  reject: (result: any) => void;\r\n  resolve: (error: Error) => void;\r\n}\r\n\r\n/** The successful result of a worker operation, correlated with the id of the caller to resolve with the result. */\r\ninterface WorkerResult {\r\n  msgId: number;\r\n  result: any;\r\n  error?: never;\r\n}\r\n\r\n/** An error resulting from a worker operation, correlated with the id of the caller to reject with the error. */\r\ninterface WorkerError {\r\n  msgId: number;\r\n  error: Error;\r\n  result?: never;\r\n}\r\n\r\n/** Response to `postMessage` produced by a worker operation. */\r\ntype WorkerResponse = WorkerResult | WorkerError;\r\n\r\n/** Given an interface T that defines the operations provided by a worker, produce an interface that can be used to asynchronously invoke those operations\r\n * from the main thread, optionally passing an array of values to be transferred from the main thread to the worker.\r\n *  - Every return type is converted to a `Promise` (i.e., every function becomes `async`)>.\r\n *  - `zeroArgFunc(): R` becomes `async zeroArgFunc(): Promise<R>`.\r\n *  - `oneArgFunc(arg: U): R` becomes `async oneArgFunc(arg: U, transfer?: Transferable[]): Promise<R>`.\r\n *  - `multiArgFunc(arg1: U, arg2: V): R` becomes `async multiArgFunc(args: [U, V], transfer?: Transferable[]): Promise<R>`.\r\n * @note All parameters of all methods of `T` must support [structured cloning](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm) -\r\n * attempts to pass functions, instances of classes, DOM nodes, WebGL resources, and other non-cloneable types will compile but fail at run-time.\r\n * @beta\r\n */\r\nexport type WorkerInterface<T> = {\r\n  [P in keyof T]: T[P] extends () => any ? () => Promise<ReturnType<T[P]>> :\r\n    (T[P] extends (arg: any) => any ? (arg: Parameters<T[P]>[0], transfer?: Transferable[]) => Promise<ReturnType<T[P]>> :\r\n      (T[P] extends (...args: any) => any ? (args: Parameters<T[P]>, transfer?: Transferable[]) => Promise<ReturnType<T[P]>> : never)\r\n    )\r\n};\r\n\r\n/** Augments each method of `T` with the ability to specify values to be transferred from the worker thread to the main thread.\r\n * Each return type `R` is replaced with `R | { result: R; transfer: Transferable[]; }`, or a promise that resolves to such a type.\r\n * @see [[WorkerImplementation]].\r\n * @beta\r\n */\r\nexport type WorkerReturnType<T extends (...args: any) => any> = MaybePromise<ReturnType<T> | { result: Awaited<ReturnType<T>>, transfer: Transferable[] }>;\r\n\r\n/** Given an interface T that defines the operations provided by a worker, produce an interface to which the implementation of those operations must conform.\r\n * The return type of each function is enhanced to permit supplying a list of values to be transferred from the worker to the main thread.\r\n * Multi-argument functions are converted to functions accepting a single tuple of arguments.\r\n *  - Every return type `R` is converted to `WorkerReturnType<R>`.\r\n *  - `zeroArgFunc(): R` becomes `zeroArgFunc(): R | { result: R; transfer: Transferable[]; }`.\r\n *  - `oneArgFunc(arg: U): R` becomes `oneArgFunc(arg: U): R | { result: R; transfer: Transferable[]; }`.\r\n *  - `multiArgFunc(arg1: U, arg2: V): R` becomes `multiArgFunc([U, V]): R | { result: R; transfer: Transferable[]; }`.\r\n * @note All parameters of all methods of `T` must support [structured cloning](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm) -\r\n * attempts to pass functions, instances of classes, DOM nodes, WebGL resources, and other non-cloneable types will compile but fail at run-time.\r\n * @beta\r\n */\r\nexport type WorkerImplementation<T> = {\r\n  [P in keyof T]: T[P] extends () => any ? () => WorkerReturnType<T[P]> :\r\n    (T[P] extends (arg: any) => any ? (arg: Parameters<T[P]>[0]) => WorkerReturnType<T[P]> :\r\n      (T[P] extends (...args: any) => any ? (args: Parameters<T[P]>) => WorkerReturnType<T[P]> : never)\r\n    )\r\n};\r\n\r\n/** A proxy for a [web worker](https://developer.mozilla.org/en-US/docs/Web/API/Worker) that provides the operations specified by\r\n * the methods of `T`.\r\n * To use a worker proxy, define a worker script that provides [[registerWorker]] with an implementation of `T`, and obtain a proxy\r\n * via [[createWorkerProxy]] on the main thread. The proxy can then be used to asynchronously invoke methods of `T` on the worker.\r\n * See [this article]($docs/learning/frontend/WorkerProxy.md) for more details and examples.\r\n * @beta\r\n */\r\nexport type WorkerProxy<T> = WorkerInterface<T> & {\r\n  /** Terminate the worker. */\r\n  terminate(): void;\r\n  /** Returns true if [[terminate]] has been called. */\r\n  readonly isTerminated: boolean;\r\n};\r\n\r\n/** Create a [[WorkerProxy]] implementing the methods of `T` using the specified worker script.\r\n * See [this article]($docs/learning/frontend/WorkerProxy.md) for more details and examples.\r\n * @beta\r\n */\r\nexport function createWorkerProxy<T>(workerJsPath: string): WorkerProxy<T> {\r\n  const tasks = new Map<number, Task>();\r\n  let curMsgId = 0;\r\n  let terminated = false;\r\n\r\n  let worker: Worker;\r\n  const sameOrigin = workerJsPath.substring(0, globalThis.origin.length) === globalThis.origin;\r\n  if (sameOrigin || !workerJsPath.startsWith(\"http\")) {\r\n    worker = new Worker(workerJsPath);\r\n  } else {\r\n    const workerBlob = new Blob([`importScripts(\"${workerJsPath}\");`]);\r\n    const workerBlobUrl = URL.createObjectURL(workerBlob);\r\n    worker = new Worker(workerBlobUrl);\r\n  }\r\n\r\n  worker.onmessage = (e: MessageEvent) => {\r\n    const response = e.data as WorkerResponse;\r\n    assert(typeof response === \"object\");\r\n    assert(\"result\" in response || \"error\" in response);\r\n\r\n    const task = tasks.get(response.msgId);\r\n    if (task) {\r\n      tasks.delete(response.msgId);\r\n      if (response.error)\r\n        task.reject(response.error);\r\n      else\r\n        task.resolve(response.result);\r\n    }\r\n  };\r\n\r\n  return new Proxy({} as WorkerProxy<T>, {\r\n    get(_target, operation: string) {\r\n      if (operation === \"terminate\") {\r\n        assert(!terminated);\r\n        terminated = true;\r\n        return () => worker.terminate();\r\n      } else if (operation === \"isTerminated\") {\r\n        return terminated;\r\n      } else {\r\n        return async (...args: any[]) => new Promise((resolve, reject) => {\r\n          const msgId = ++curMsgId;\r\n          tasks.set(msgId, { resolve, reject });\r\n          worker.postMessage({ operation, payload: args[0], msgId }, args[1] ?? []);\r\n        });\r\n      }\r\n    },\r\n  });\r\n}\r\n"]}

package/lib/cjs/common/gltf/GltfParser.js

@@ -30,7 +30,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseGltf = void 0;
+exports.parseGltf = parseGltf;
 const core_bentley_1 = require("@itwin/core-bentley");
 const core_geometry_1 = require("@itwin/core-geometry");
 const core_common_1 = require("@itwin/core-common");
@@ -57,7 +57,7 @@ async function parseGltf(args) {
                 json = JSON.parse(utf8Json);
                 version = 2;
             }
-            catch (_) {
+            catch {
                 return undefined;
             }
         }
@@ -76,7 +76,7 @@ async function parseGltf(args) {
                     return undefined;
                 json = JSON.parse(jsonStr);
             }
-            catch (_) {
+            catch {
                 return undefined;
             }
         }
@@ -130,7 +130,6 @@ async function parseGltf(args) {
     });
     return parser.parse();
 }
-exports.parseGltf = parseGltf;
 class GltfParser {
     constructor(options) {
         this._dracoMeshes = new Map();
@@ -282,7 +281,7 @@ class GltfParser {
                     promises.push(this.resolveImage(image));
             await Promise.all(promises);
         }
-        catch (_) {
+        catch {
             // ###TODO_GLTF log
         }
     }
@@ -290,7 +289,7 @@ class GltfParser {
         try {
             return new URL(uri, this._baseUrl).toString();
         }
-        catch (_) {
+        catch {
             return undefined;
         }
     }
@@ -308,7 +307,7 @@ class GltfParser {
             if (data)
                 buffer.resolvedBuffer = { data: new Uint8Array(data) };
         }
-        catch (_) {
+        catch {
             //
         }
     }
@@ -330,7 +329,7 @@ class GltfParser {
                 const imageSource = new core_common_1.ImageSource(bytes, format);
                 image.resolvedImage = await this._imageFromImageSource(imageSource);
             }
-            catch (_) {
+            catch {
                 //
             }
             return;