@itwin/core-common 3.2.0-dev.7 → 3.2.0-dev.70

package/lib/esm/BackgroundMapProvider.js

@@ -7,6 +7,7 @@
  */
 /** Enumerates the types of map imagery that can be supplied by a [[BackgroundMapProvider]].
  * @public
+ * @extensions
  */
 export var BackgroundMapType;
 (function (BackgroundMapType) {
@@ -51,5 +52,14 @@ export class BackgroundMapProvider {
     equals(other) {
         return this.name === other.name && this.type === other.type;
     }
+    /** Produce a copy of this provider with identical properties except for those explicitly specified by `changedProps`.
+     * Any properties explicitly set to `undefined` in `changedProps` will be reset to their default values.
+     */
+    clone(changedProps) {
+        return BackgroundMapProvider.fromJSON({
+            ...this.toJSON(),
+            ...changedProps,
+        });
+    }
 }
 //# sourceMappingURL=BackgroundMapProvider.js.map

package/lib/esm/BackgroundMapProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"BackgroundMapProvider.js","sourceRoot":"","sources":["../../src/BackgroundMapProvider.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAIH;;GAEG;AACH,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,6DAAU,CAAA;IACV,6DAAU,CAAA;IACV,6DAAU,CAAA;AACZ,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B;AAmBD;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAMhC,YAAoB,IAA+B,EAAE,IAAuB;QAC1E,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,sDAAsD;IAC/C,MAAM,CAAC,QAAQ,CAAC,KAAiC;QACtD,MAAM,IAAI,GAA8B,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC;QACtG,IAAI,IAAI,CAAC;QACT,QAAQ,KAAK,CAAC,IAAI,EAAE;YAClB,KAAK,iBAAiB,CAAC,MAAM,CAAC;YAC9B,KAAK,iBAAiB,CAAC,MAAM;gBAC3B,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;gBAClB,MAAM;YACR;gBACE,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC;gBAChC,MAAM;SACT;QAED,OAAO,IAAI,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,wDAAwD;IACjD,MAAM;QACX,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,sBAAsB,CAAC,KAAmC;;QACtE,mDAAmD;QACnD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,YAAyC,EAAE,IAAI,EAAE,MAAA,KAAK,CAAC,YAAY,0CAAE,OAAO,EAAE,CAAC,CAAC;IACrH,CAAC;IAED,6DAA6D;IACtD,MAAM,CAAC,KAA4B;QACxC,OAAO,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC;IAC9D,CAAC;CACF","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 DisplayStyles\r\n */\r\n\r\nimport { DeprecatedBackgroundMapProps } from \"./BackgroundMapSettings\";\r\n\r\n/** Enumerates the types of map imagery that can be supplied by a [[BackgroundMapProvider]].\r\n * @public\r\n */\r\nexport enum BackgroundMapType {\r\n  Street = 1,\r\n  Aerial = 2,\r\n  Hybrid = 3,\r\n}\r\n\r\n/** Enumerates a set of supported [[BackgroundMapProvider]]s that can provide map imagery.\r\n * @note To access imagery from such a provider, an API key must be supplied via [IModelAppOptions.mapLayerOptions]($frontend).\r\n * @public\r\n */\r\nexport type BackgroundMapProviderName = \"BingProvider\" | \"MapBoxProvider\";\r\n\r\n/** JSON representation of a [[BackgroundMapProvider]].\r\n * @see [[BaseMapLayerProps.provider]].\r\n * @beta\r\n */\r\nexport interface BackgroundMapProviderProps {\r\n  /** The name of the provider. Default: \"BingProvider\" */\r\n  name?: BackgroundMapProviderName;\r\n  /** The type of imagery to display. Default: Hybrid. */\r\n  type?: BackgroundMapType;\r\n}\r\n\r\n/** Describes one of a small set of standard, known suppliers of background map imagery as part of a [[BaseMapLayerSettings]].\r\n * @beta\r\n */\r\nexport class BackgroundMapProvider {\r\n  /** The name of the provider. */\r\n  public readonly name: BackgroundMapProviderName;\r\n  /** The type of map imagery provided. */\r\n  public readonly type: BackgroundMapType;\r\n\r\n  private constructor(name: BackgroundMapProviderName, type: BackgroundMapType) {\r\n    this.name = name;\r\n    this.type = type;\r\n  }\r\n\r\n  /** Create a provider from its JSON representation. */\r\n  public static fromJSON(props: BackgroundMapProviderProps): BackgroundMapProvider {\r\n    const name: BackgroundMapProviderName = props.name === \"MapBoxProvider\" ? props.name : \"BingProvider\";\r\n    let type;\r\n    switch (props.type) {\r\n      case BackgroundMapType.Street:\r\n      case BackgroundMapType.Aerial:\r\n        type = props.type;\r\n        break;\r\n      default:\r\n        type = BackgroundMapType.Hybrid;\r\n        break;\r\n    }\r\n\r\n    return new BackgroundMapProvider(name, type);\r\n  }\r\n\r\n  /** Convert this provider to its JSON representation. */\r\n  public toJSON(): BackgroundMapProviderProps {\r\n    return { name: this.name, type: this.type };\r\n  }\r\n\r\n  /** @internal */\r\n  public static fromBackgroundMapProps(props: DeprecatedBackgroundMapProps): BackgroundMapProvider {\r\n    // eslint-disable-next-line deprecation/deprecation\r\n    return this.fromJSON({ name: props.providerName as BackgroundMapProviderName, type: props.providerData?.mapType });\r\n  }\r\n\r\n  /** Return true if this provider is equivalent to `other`. */\r\n  public equals(other: BackgroundMapProvider): boolean {\r\n    return this.name === other.name && this.type === other.type;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"BackgroundMapProvider.js","sourceRoot":"","sources":["../../src/BackgroundMapProvider.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAIH;;;GAGG;AACH,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,6DAAU,CAAA;IACV,6DAAU,CAAA;IACV,6DAAU,CAAA;AACZ,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B;AAoBD;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAMhC,YAAoB,IAA+B,EAAE,IAAuB;QAC1E,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,sDAAsD;IAC/C,MAAM,CAAC,QAAQ,CAAC,KAAiC;QACtD,MAAM,IAAI,GAA8B,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC;QACtG,IAAI,IAAI,CAAC;QACT,QAAQ,KAAK,CAAC,IAAI,EAAE;YAClB,KAAK,iBAAiB,CAAC,MAAM,CAAC;YAC9B,KAAK,iBAAiB,CAAC,MAAM;gBAC3B,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;gBAClB,MAAM;YACR;gBACE,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC;gBAChC,MAAM;SACT;QAED,OAAO,IAAI,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,wDAAwD;IACjD,MAAM;QACX,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,sBAAsB,CAAC,KAAmC;;QACtE,mDAAmD;QACnD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,YAAyC,EAAE,IAAI,EAAE,MAAA,KAAK,CAAC,YAAY,0CAAE,OAAO,EAAE,CAAC,CAAC;IACrH,CAAC;IAED,6DAA6D;IACtD,MAAM,CAAC,KAA4B;QACxC,OAAO,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC;IAC9D,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAwC;QACnD,OAAO,qBAAqB,CAAC,QAAQ,CAAC;YACpC,GAAG,IAAI,CAAC,MAAM,EAAE;YAChB,GAAG,YAAY;SAChB,CAAC,CAAC;IACL,CAAC;CACF","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 DisplayStyles\r\n */\r\n\r\nimport { DeprecatedBackgroundMapProps } from \"./BackgroundMapSettings\";\r\n\r\n/** Enumerates the types of map imagery that can be supplied by a [[BackgroundMapProvider]].\r\n * @public\r\n * @extensions\r\n */\r\nexport enum BackgroundMapType {\r\n  Street = 1,\r\n  Aerial = 2,\r\n  Hybrid = 3,\r\n}\r\n\r\n/** Enumerates a set of supported [[BackgroundMapProvider]]s that can provide map imagery.\r\n * @note To access imagery from such a provider, an API key must be supplied via [IModelAppOptions.mapLayerOptions]($frontend).\r\n * @public\r\n * @extensions\r\n */\r\nexport type BackgroundMapProviderName = \"BingProvider\" | \"MapBoxProvider\";\r\n\r\n/** JSON representation of a [[BackgroundMapProvider]].\r\n * @see [[BaseMapLayerProps.provider]].\r\n * @beta\r\n */\r\nexport interface BackgroundMapProviderProps {\r\n  /** The name of the provider. Default: \"BingProvider\" */\r\n  name?: BackgroundMapProviderName;\r\n  /** The type of imagery to display. Default: Hybrid. */\r\n  type?: BackgroundMapType;\r\n}\r\n\r\n/** Describes one of a small set of standard, known suppliers of background map imagery as part of a [[BaseMapLayerSettings]].\r\n * @beta\r\n */\r\nexport class BackgroundMapProvider {\r\n  /** The name of the provider. */\r\n  public readonly name: BackgroundMapProviderName;\r\n  /** The type of map imagery provided. */\r\n  public readonly type: BackgroundMapType;\r\n\r\n  private constructor(name: BackgroundMapProviderName, type: BackgroundMapType) {\r\n    this.name = name;\r\n    this.type = type;\r\n  }\r\n\r\n  /** Create a provider from its JSON representation. */\r\n  public static fromJSON(props: BackgroundMapProviderProps): BackgroundMapProvider {\r\n    const name: BackgroundMapProviderName = props.name === \"MapBoxProvider\" ? props.name : \"BingProvider\";\r\n    let type;\r\n    switch (props.type) {\r\n      case BackgroundMapType.Street:\r\n      case BackgroundMapType.Aerial:\r\n        type = props.type;\r\n        break;\r\n      default:\r\n        type = BackgroundMapType.Hybrid;\r\n        break;\r\n    }\r\n\r\n    return new BackgroundMapProvider(name, type);\r\n  }\r\n\r\n  /** Convert this provider to its JSON representation. */\r\n  public toJSON(): BackgroundMapProviderProps {\r\n    return { name: this.name, type: this.type };\r\n  }\r\n\r\n  /** @internal */\r\n  public static fromBackgroundMapProps(props: DeprecatedBackgroundMapProps): BackgroundMapProvider {\r\n    // eslint-disable-next-line deprecation/deprecation\r\n    return this.fromJSON({ name: props.providerName as BackgroundMapProviderName, type: props.providerData?.mapType });\r\n  }\r\n\r\n  /** Return true if this provider is equivalent to `other`. */\r\n  public equals(other: BackgroundMapProvider): boolean {\r\n    return this.name === other.name && this.type === other.type;\r\n  }\r\n\r\n  /** Produce a copy of this provider with identical properties except for those explicitly specified by `changedProps`.\r\n   * Any properties explicitly set to `undefined` in `changedProps` will be reset to their default values.\r\n   */\r\n  public clone(changedProps: BackgroundMapProviderProps): BackgroundMapProvider {\r\n    return BackgroundMapProvider.fromJSON({\r\n      ...this.toJSON(),\r\n      ...changedProps,\r\n    });\r\n  }\r\n}\r\n"]}

package/lib/esm/BackgroundMapSettings.d.ts

@@ -8,6 +8,7 @@ import { TerrainProps, TerrainSettings } from "./TerrainSettings";
  * @see [[BackgroundMapProps]]
  * @see [[DisplayStyleSettingsProps]]
  * @public
+ * @extensions
  */
 export declare enum GlobeMode {
     /** Display Earth as 3d ellipsoid */
@@ -18,6 +19,7 @@ export declare enum GlobeMode {
 /** In-memory JSON representation of a [[BackgroundMapSettings]].
  * @see [[PersistentBackgroundMapProps]] for the persistent JSON representation.
  * @public
+ * @extensions
  */
 export interface BackgroundMapProps {
     /** The elevation of the map in meters relative the WGS84 ellipsoid. Default value: 0. */
@@ -51,6 +53,7 @@ export interface BackgroundMapProps {
  * These properties are omitted from [[BackgroundMapProps]] as they are no longer part of the API, but are included in
  * [[PersistentBackgroundMapProps]] because they remain part of the persistence format.
  * @public
+ * @extensions
  */
 export interface DeprecatedBackgroundMapProps {
     /** Identifies the source of the map tiles. Currently supported providers are "BingProvider" and "MapBoxProvider".
@@ -68,6 +71,7 @@ export interface DeprecatedBackgroundMapProps {
 }
 /** Persistent JSON representation of a [[BackgroundMapSettings]].
  * @public
+ * @extensions
  */
 export declare type PersistentBackgroundMapProps = Omit<BackgroundMapProps, keyof DeprecatedBackgroundMapProps> & DeprecatedBackgroundMapProps;
 /** As part of a [[DisplayStyleSettings]], controls aspects of how the background map is displayed.

package/lib/esm/BackgroundMapSettings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BackgroundMapSettings.d.ts","sourceRoot":"","sources":["../../src/BackgroundMapSettings.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAyB,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAElE;;;;GAIG;AACH,oBAAY,SAAS;IACnB,oCAAoC;IACpC,SAAS,IAAI;IACb,8BAA8B;IAC9B,KAAK,IAAI;CACV;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,+LAA+L;IAC/L,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0GAA0G;IAC1G,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,qDAAqD;IACrD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAErC,0DAA0D;IAC1D,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,KAAK,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE;QACb,oFAAoF;QACpF,OAAO,CAAC,EAAE,iBAAiB,CAAC;KAC7B,CAAC;CACH;AAED;;GAEG;AACH,oBAAY,4BAA4B,GAAG,IAAI,CAAC,kBAAkB,EAAE,MAAM,4BAA4B,CAAC,GAAG,4BAA4B,CAAC;AAavI;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAElD,yDAAyD;IACzD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,2MAA2M;IAC3M,SAAgB,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7C,+LAA+L;IAC/L,SAAgB,cAAc,EAAE,OAAO,CAAC;IACxC,0GAA0G;IAC1G,SAAgB,YAAY,EAAE,OAAO,CAAC;IACtC,gDAAgD;IAChD,SAAgB,eAAe,EAAE,eAAe,CAAC;IACjD,0BAA0B;IAC1B,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC;;OAEG;IACH,SAAgB,cAAc,EAAE,sBAAsB,CAAC;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC;;OAEG;IACH,IAAW,SAAS,IAAI,OAAO,CAQ9B;IAED,sFAAsF;IACtF,IAAW,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAAwE;IAE7H,OAAO;IAYP;;OAEG;WACW,kBAAkB,CAAC,IAAI,CAAC,EAAE,4BAA4B,GAAG,qBAAqB;IAI5F;;OAEG;WACW,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,qBAAqB;IAIxE;;OAEG;IACI,MAAM,IAAI,kBAAkB;IA6BnC;;OAEG;IACI,gBAAgB,IAAI,4BAA4B;IAYvD,mFAAmF;IAC5E,UAAU,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO;IAIrD,+FAA+F;IACxF,oBAAoB,CAAC,IAAI,CAAC,EAAE,4BAA4B,GAAG,OAAO;IAIzE,gEAAgE;IACzD,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO;IAOpD;;;OAGG;IACI,KAAK,CAAC,YAAY,CAAC,EAAE,kBAAkB,GAAG,qBAAqB;CAmBvE"}
+{"version":3,"file":"BackgroundMapSettings.d.ts","sourceRoot":"","sources":["../../src/BackgroundMapSettings.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAyB,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAElE;;;;;GAKG;AACH,oBAAY,SAAS;IACnB,oCAAoC;IACpC,SAAS,IAAI;IACb,8BAA8B;IAC9B,KAAK,IAAI;CACV;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,+LAA+L;IAC/L,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0GAA0G;IAC1G,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,qDAAqD;IACrD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAErC,0DAA0D;IAC1D,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,KAAK,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE;QACb,oFAAoF;QACpF,OAAO,CAAC,EAAE,iBAAiB,CAAC;KAC7B,CAAC;CACH;AAED;;;GAGG;AACH,oBAAY,4BAA4B,GAAG,IAAI,CAAC,kBAAkB,EAAE,MAAM,4BAA4B,CAAC,GAAG,4BAA4B,CAAC;AAavI;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAElD,yDAAyD;IACzD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,2MAA2M;IAC3M,SAAgB,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7C,+LAA+L;IAC/L,SAAgB,cAAc,EAAE,OAAO,CAAC;IACxC,0GAA0G;IAC1G,SAAgB,YAAY,EAAE,OAAO,CAAC;IACtC,gDAAgD;IAChD,SAAgB,eAAe,EAAE,eAAe,CAAC;IACjD,0BAA0B;IAC1B,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC;;OAEG;IACH,SAAgB,cAAc,EAAE,sBAAsB,CAAC;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC;;OAEG;IACH,IAAW,SAAS,IAAI,OAAO,CAQ9B;IAED,sFAAsF;IACtF,IAAW,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAAwE;IAE7H,OAAO;IAYP;;OAEG;WACW,kBAAkB,CAAC,IAAI,CAAC,EAAE,4BAA4B,GAAG,qBAAqB;IAI5F;;OAEG;WACW,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,qBAAqB;IAIxE;;OAEG;IACI,MAAM,IAAI,kBAAkB;IA6BnC;;OAEG;IACI,gBAAgB,IAAI,4BAA4B;IAYvD,mFAAmF;IAC5E,UAAU,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO;IAIrD,+FAA+F;IACxF,oBAAoB,CAAC,IAAI,CAAC,EAAE,4BAA4B,GAAG,OAAO;IAIzE,gEAAgE;IACzD,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO;IAOpD;;;OAGG;IACI,KAAK,CAAC,YAAY,CAAC,EAAE,kBAAkB,GAAG,qBAAqB;CAmBvE"}

package/lib/esm/BackgroundMapSettings.js

@@ -12,6 +12,7 @@ import { TerrainSettings } from "./TerrainSettings";
  * @see [[BackgroundMapProps]]
  * @see [[DisplayStyleSettingsProps]]
  * @public
+ * @extensions
  */
 export var GlobeMode;
 (function (GlobeMode) {

package/lib/esm/BackgroundMapSettings.js.map

@@ -1 +1 @@
-{"version":3,"file":"BackgroundMapSettings.js","sourceRoot":"","sources":["../../src/BackgroundMapSettings.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 DisplayStyles\r\n */\r\n\r\nimport { BackgroundMapProvider, BackgroundMapType } from \"./BackgroundMapProvider\";\r\nimport { PlanarClipMaskProps, PlanarClipMaskSettings } from \"./PlanarClipMask\";\r\nimport { TerrainProps, TerrainSettings } from \"./TerrainSettings\";\r\n\r\n/** Describes the projection of the background map\r\n * @see [[BackgroundMapProps]]\r\n * @see [[DisplayStyleSettingsProps]]\r\n * @public\r\n */\r\nexport enum GlobeMode {\r\n  /** Display Earth as 3d ellipsoid */\r\n  Ellipsoid = 0,\r\n  /** Display Earth as plane. */\r\n  Plane = 1,\r\n}\r\n\r\n/** In-memory JSON representation of a [[BackgroundMapSettings]].\r\n * @see [[PersistentBackgroundMapProps]] for the persistent JSON representation.\r\n * @public\r\n */\r\nexport interface BackgroundMapProps {\r\n  /** The elevation of the map in meters relative the WGS84 ellipsoid. Default value: 0. */\r\n  groundBias?: number;\r\n  /** A transparency value from 0.0 (fully opaque) to 1.0 (fully transparent) to apply to map graphics when drawing, or false to indicate the transparency should not be overridden.\r\n   * Default value: false.\r\n   */\r\n  transparency?: number | false;\r\n  /** If set to true, the map tiles will be rendered with depth, allowing them to obscure other geometry. Otherwise, they are always rendered behind all other geometry. Default value: false. */\r\n  useDepthBuffer?: boolean;\r\n  /** If true, terrain heights will be applied to the map; otherwise the map will be rendered as a plane. */\r\n  applyTerrain?: boolean;\r\n  /** Properties associated with terrain display. */\r\n  terrainSettings?: TerrainProps;\r\n  /** Globe Mode. Default value: GlobeMode.Ellipsoid */\r\n  globeMode?: GlobeMode;\r\n  /** If true, the map will be treated as non-locatable - i.e., tools will not interact with it. This is particularly useful when the map is transparent - it\r\n   * allows the user to select elements that are behind the map.\r\n   */\r\n  nonLocatable?: boolean;\r\n  /** A planar mask applied to the map geometry\r\n   * @beta\r\n   */\r\n  planarClipMask?: PlanarClipMaskProps;\r\n\r\n  /** @see [[DeprecatedBackgroundMapProps.providerName]]. */\r\n  providerName?: never;\r\n  /** @see [[DeprecatedBackgroundMapProps.providerData]]. */\r\n  providerData?: never;\r\n}\r\n\r\n/** Properties of [[PersistentBackgroundMapProps]] that have been deprecated, but are retained for backwards compatibility.\r\n * These properties are omitted from [[BackgroundMapProps]] as they are no longer part of the API, but are included in\r\n * [[PersistentBackgroundMapProps]] because they remain part of the persistence format.\r\n * @public\r\n */\r\nexport interface DeprecatedBackgroundMapProps {\r\n  /** Identifies the source of the map tiles. Currently supported providers are \"BingProvider\" and \"MapBoxProvider\".\r\n   * Default value: \"BingProvider\"\r\n   * @deprecated use MapImageryProps.backgroundBase.\r\n   */\r\n  providerName?: string;\r\n  /** Options for customizing the tiles supplied by the provider. If undefined, default values of all members are used.\r\n   * @deprecated use MapImageryProps.backgroundBase\r\n   */\r\n  providerData?: {\r\n    /** The type of map graphics to request. Default value: BackgroundMapType.Hybrid. */\r\n    mapType?: BackgroundMapType;\r\n  };\r\n}\r\n\r\n/** Persistent JSON representation of a [[BackgroundMapSettings]].\r\n * @public\r\n */\r\nexport type PersistentBackgroundMapProps = Omit<BackgroundMapProps, keyof DeprecatedBackgroundMapProps> & DeprecatedBackgroundMapProps;\r\n\r\nfunction normalizeGlobeMode(mode?: GlobeMode): GlobeMode {\r\n  return GlobeMode.Plane === mode ? mode : GlobeMode.Ellipsoid;\r\n}\r\n\r\nfunction normalizeTransparency(trans?: number | false): number | false {\r\n  if (\"number\" === typeof trans)\r\n    return Math.min(1, Math.max(0, trans));\r\n\r\n  return false;\r\n}\r\n\r\n/** As part of a [[DisplayStyleSettings]], controls aspects of how the background map is displayed.\r\n * @see [[DisplayStyleSettings.backgroundMap]] to query or change these settings for a display style.\r\n * @see [[MapImagerySettings]] to control the type of imagery applied to the background map.\r\n * @public\r\n */\r\nexport class BackgroundMapSettings {\r\n  /** Retained strictly for persistence. */\r\n  private readonly _provider: BackgroundMapProvider;\r\n\r\n  /** Elevation in meters, relative to WGS84 Ellipsoid.. */\r\n  public readonly groundBias: number;\r\n  /** A transparency value from 0.0 (fully opaque) to 1.0 (fully transparent) to apply to map graphics when drawing, or false to indicate the transparency should not be overridden. Default value: false. */\r\n  public readonly transparency: number | false;\r\n  /** If set to true, the map tiles will be rendered with depth, allowing them to obscure other geometry. Otherwise, they are always rendered behind all other geometry. Default value: false. */\r\n  public readonly useDepthBuffer: boolean;\r\n  /** If true, terrain heights will be applied to the map; otherwise the map will be rendered as a plane. */\r\n  public readonly applyTerrain: boolean;\r\n  /** Settings associated with terrain display. */\r\n  public readonly terrainSettings: TerrainSettings;\r\n  /** Globe display mode. */\r\n  public readonly globeMode: GlobeMode;\r\n  /** Planar Mask - used to mask the background map to avoid overlapping with other geometry\r\n   * @beta\r\n   */\r\n  public readonly planarClipMask: PlanarClipMaskSettings;\r\n  private readonly _locatable: boolean;\r\n  /** If false, the map will be treated as non-locatable - i.e., tools will not interact with it. This is particularly useful when the map is transparent - it\r\n   * allows the user to select elements that are behind the map.\r\n   */\r\n  public get locatable(): boolean {\r\n    // Handle legacy TerrainProps.nonLocatable:\r\n    // - If TerrainProps.nonLocatable=true and terrain is on, terrain is not locatable.\r\n    // - Otherwise, use BackgroundMapProps.nonLocatable.\r\n    if (this.applyTerrain && this.terrainSettings.nonLocatable)\r\n      return false;\r\n\r\n    return this._locatable;\r\n  }\r\n\r\n  /** If transparency is overridden, the transparency to apply; otherwise, undefined. */\r\n  public get transparencyOverride(): number | undefined { return false !== this.transparency ? this.transparency : undefined; }\r\n\r\n  private constructor(props: BackgroundMapProps | PersistentBackgroundMapProps) {\r\n    this.groundBias = props.groundBias ?? 0;\r\n    this.transparency = normalizeTransparency(props.transparency);\r\n    this.useDepthBuffer = props.useDepthBuffer ?? false;\r\n    this.applyTerrain = props.applyTerrain ?? false;\r\n    this.terrainSettings = TerrainSettings.fromJSON(props.terrainSettings);\r\n    this.globeMode = normalizeGlobeMode(props.globeMode);\r\n    this._locatable = true !== props.nonLocatable;\r\n    this.planarClipMask = PlanarClipMaskSettings.fromJSON(props.planarClipMask);\r\n    this._provider = BackgroundMapProvider.fromBackgroundMapProps(props);\r\n  }\r\n\r\n  /** Create settings from their persistent representation. In general, this method should only be used when reading the settings directly from\r\n   * the iModel - otherwise, prefer [[fromJSON]].\r\n   */\r\n  public static fromPersistentJSON(json?: PersistentBackgroundMapProps): BackgroundMapSettings {\r\n    return new this(json ?? {});\r\n  }\r\n\r\n  /** Construct from JSON, performing validation and applying default values for undefined fields.\r\n   * @see [[fromPersistentJSON]] if you are reading the settings directly from the iModel.\r\n   */\r\n  public static fromJSON(json?: BackgroundMapProps): BackgroundMapSettings {\r\n    return new BackgroundMapSettings(json ?? {});\r\n  }\r\n\r\n  /** Convert these settings to their in-memory JSON representation.\r\n   * @see [[toPersistentJSON]] if you intend to write the JSON directly to an iModel.\r\n   */\r\n  public toJSON(): BackgroundMapProps {\r\n    const props: BackgroundMapProps = {};\r\n    if (0 !== this.groundBias)\r\n      props.groundBias = this.groundBias;\r\n    if (this.applyTerrain)\r\n      props.applyTerrain = true;\r\n    if (false !== this.transparency)\r\n      props.transparency = this.transparency;\r\n    if (GlobeMode.Ellipsoid !== this.globeMode)\r\n      props.globeMode = this.globeMode;\r\n    if (this.useDepthBuffer)\r\n      props.useDepthBuffer = true;\r\n    if (!this._locatable)\r\n      props.nonLocatable = true;\r\n\r\n    const terrainSettings = this.terrainSettings.toJSON();\r\n    for (const prop of Object.values(terrainSettings)) {\r\n      if (undefined !== prop) {\r\n        props.terrainSettings = terrainSettings;\r\n        break;\r\n      }\r\n    }\r\n\r\n    if (this.planarClipMask.isValid)\r\n      props.planarClipMask = this.planarClipMask.toJSON();\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Convert these settings to their persistent representation. In general, this method should only be used when writing the settings directly to\r\n   * the iModel - otherwise, prefer [[toJSON]].\r\n   */\r\n  public toPersistentJSON(): PersistentBackgroundMapProps {\r\n    const props = this.toJSON() as PersistentBackgroundMapProps;\r\n\r\n    // Preserve deprecated imagery provider properties.\r\n    if (\"BingProvider\" !== this._provider.name)\r\n      props.providerName = this._provider.name; // eslint-disable-line deprecation/deprecation\r\n    if (BackgroundMapType.Hybrid !== this._provider.type)\r\n      props.providerData = { mapType: this._provider.type }; // eslint-disable-line deprecation/deprecation\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Returns true if these settings are equivalent to the supplied JSON settings. */\r\n  public equalsJSON(json?: BackgroundMapProps): boolean {\r\n    return this.equals(BackgroundMapSettings.fromJSON(json));\r\n  }\r\n\r\n  /** Returns true if the persistent representation of these settings is equivalent to `json`. */\r\n  public equalsPersistentJSON(json?: PersistentBackgroundMapProps): boolean {\r\n    return this.equals(BackgroundMapSettings.fromPersistentJSON(json));\r\n  }\r\n\r\n  /** Returns true if these settings are equivalent to `other`. */\r\n  public equals(other: BackgroundMapSettings): boolean {\r\n    return this.groundBias === other.groundBias && this.useDepthBuffer === other.useDepthBuffer && this.transparency === other.transparency\r\n      && this.globeMode === other.globeMode && this._locatable === other._locatable && this.applyTerrain === other.applyTerrain\r\n      && this.terrainSettings.equals(other.terrainSettings) && this.planarClipMask.equals(other.planarClipMask)\r\n      && this._provider.name === other._provider.name && this._provider.type === other._provider.type;\r\n  }\r\n\r\n  /** Create a copy of this BackgroundMapSettings, optionally modifying some of its properties.\r\n   * @param changedProps JSON representation of the properties to change.\r\n   * @returns A BackgroundMapSettings with all of its properties set to match those of `this`, except those explicitly defined in `changedProps`.\r\n   */\r\n  public clone(changedProps?: BackgroundMapProps): BackgroundMapSettings {\r\n    if (undefined === changedProps)\r\n      return this;\r\n\r\n    const props = {\r\n      groundBias: changedProps.groundBias ?? this.groundBias,\r\n      transparency: changedProps.transparency ?? this.transparency,\r\n      useDepthBuffer: changedProps.useDepthBuffer ?? this.useDepthBuffer,\r\n      globeMode: changedProps.globeMode ?? this.globeMode,\r\n      nonLocatable: changedProps.nonLocatable ?? !this._locatable,\r\n      applyTerrain: changedProps.applyTerrain ?? this.applyTerrain,\r\n      terrainSettings: changedProps.terrainSettings ? this.terrainSettings.clone(changedProps.terrainSettings).toJSON() : this.terrainSettings.toJSON(),\r\n      planarClipMask: changedProps.planarClipMask ? this.planarClipMask.clone(changedProps.planarClipMask).toJSON() : this.planarClipMask.toJSON(),\r\n      providerName: this._provider.name,\r\n      providerData: { mapType: this._provider.type },\r\n    };\r\n\r\n    return BackgroundMapSettings.fromPersistentJSON(props);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"BackgroundMapSettings.js","sourceRoot":"","sources":["../../src/BackgroundMapSettings.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 DisplayStyles\r\n */\r\n\r\nimport { BackgroundMapProvider, BackgroundMapType } from \"./BackgroundMapProvider\";\r\nimport { PlanarClipMaskProps, PlanarClipMaskSettings } from \"./PlanarClipMask\";\r\nimport { TerrainProps, TerrainSettings } from \"./TerrainSettings\";\r\n\r\n/** Describes the projection of the background map\r\n * @see [[BackgroundMapProps]]\r\n * @see [[DisplayStyleSettingsProps]]\r\n * @public\r\n * @extensions\r\n */\r\nexport enum GlobeMode {\r\n  /** Display Earth as 3d ellipsoid */\r\n  Ellipsoid = 0,\r\n  /** Display Earth as plane. */\r\n  Plane = 1,\r\n}\r\n\r\n/** In-memory JSON representation of a [[BackgroundMapSettings]].\r\n * @see [[PersistentBackgroundMapProps]] for the persistent JSON representation.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface BackgroundMapProps {\r\n  /** The elevation of the map in meters relative the WGS84 ellipsoid. Default value: 0. */\r\n  groundBias?: number;\r\n  /** A transparency value from 0.0 (fully opaque) to 1.0 (fully transparent) to apply to map graphics when drawing, or false to indicate the transparency should not be overridden.\r\n   * Default value: false.\r\n   */\r\n  transparency?: number | false;\r\n  /** If set to true, the map tiles will be rendered with depth, allowing them to obscure other geometry. Otherwise, they are always rendered behind all other geometry. Default value: false. */\r\n  useDepthBuffer?: boolean;\r\n  /** If true, terrain heights will be applied to the map; otherwise the map will be rendered as a plane. */\r\n  applyTerrain?: boolean;\r\n  /** Properties associated with terrain display. */\r\n  terrainSettings?: TerrainProps;\r\n  /** Globe Mode. Default value: GlobeMode.Ellipsoid */\r\n  globeMode?: GlobeMode;\r\n  /** If true, the map will be treated as non-locatable - i.e., tools will not interact with it. This is particularly useful when the map is transparent - it\r\n   * allows the user to select elements that are behind the map.\r\n   */\r\n  nonLocatable?: boolean;\r\n  /** A planar mask applied to the map geometry\r\n   * @beta\r\n   */\r\n  planarClipMask?: PlanarClipMaskProps;\r\n\r\n  /** @see [[DeprecatedBackgroundMapProps.providerName]]. */\r\n  providerName?: never;\r\n  /** @see [[DeprecatedBackgroundMapProps.providerData]]. */\r\n  providerData?: never;\r\n}\r\n\r\n/** Properties of [[PersistentBackgroundMapProps]] that have been deprecated, but are retained for backwards compatibility.\r\n * These properties are omitted from [[BackgroundMapProps]] as they are no longer part of the API, but are included in\r\n * [[PersistentBackgroundMapProps]] because they remain part of the persistence format.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface DeprecatedBackgroundMapProps {\r\n  /** Identifies the source of the map tiles. Currently supported providers are \"BingProvider\" and \"MapBoxProvider\".\r\n   * Default value: \"BingProvider\"\r\n   * @deprecated use MapImageryProps.backgroundBase.\r\n   */\r\n  providerName?: string;\r\n  /** Options for customizing the tiles supplied by the provider. If undefined, default values of all members are used.\r\n   * @deprecated use MapImageryProps.backgroundBase\r\n   */\r\n  providerData?: {\r\n    /** The type of map graphics to request. Default value: BackgroundMapType.Hybrid. */\r\n    mapType?: BackgroundMapType;\r\n  };\r\n}\r\n\r\n/** Persistent JSON representation of a [[BackgroundMapSettings]].\r\n * @public\r\n * @extensions\r\n */\r\nexport type PersistentBackgroundMapProps = Omit<BackgroundMapProps, keyof DeprecatedBackgroundMapProps> & DeprecatedBackgroundMapProps;\r\n\r\nfunction normalizeGlobeMode(mode?: GlobeMode): GlobeMode {\r\n  return GlobeMode.Plane === mode ? mode : GlobeMode.Ellipsoid;\r\n}\r\n\r\nfunction normalizeTransparency(trans?: number | false): number | false {\r\n  if (\"number\" === typeof trans)\r\n    return Math.min(1, Math.max(0, trans));\r\n\r\n  return false;\r\n}\r\n\r\n/** As part of a [[DisplayStyleSettings]], controls aspects of how the background map is displayed.\r\n * @see [[DisplayStyleSettings.backgroundMap]] to query or change these settings for a display style.\r\n * @see [[MapImagerySettings]] to control the type of imagery applied to the background map.\r\n * @public\r\n */\r\nexport class BackgroundMapSettings {\r\n  /** Retained strictly for persistence. */\r\n  private readonly _provider: BackgroundMapProvider;\r\n\r\n  /** Elevation in meters, relative to WGS84 Ellipsoid.. */\r\n  public readonly groundBias: number;\r\n  /** A transparency value from 0.0 (fully opaque) to 1.0 (fully transparent) to apply to map graphics when drawing, or false to indicate the transparency should not be overridden. Default value: false. */\r\n  public readonly transparency: number | false;\r\n  /** If set to true, the map tiles will be rendered with depth, allowing them to obscure other geometry. Otherwise, they are always rendered behind all other geometry. Default value: false. */\r\n  public readonly useDepthBuffer: boolean;\r\n  /** If true, terrain heights will be applied to the map; otherwise the map will be rendered as a plane. */\r\n  public readonly applyTerrain: boolean;\r\n  /** Settings associated with terrain display. */\r\n  public readonly terrainSettings: TerrainSettings;\r\n  /** Globe display mode. */\r\n  public readonly globeMode: GlobeMode;\r\n  /** Planar Mask - used to mask the background map to avoid overlapping with other geometry\r\n   * @beta\r\n   */\r\n  public readonly planarClipMask: PlanarClipMaskSettings;\r\n  private readonly _locatable: boolean;\r\n  /** If false, the map will be treated as non-locatable - i.e., tools will not interact with it. This is particularly useful when the map is transparent - it\r\n   * allows the user to select elements that are behind the map.\r\n   */\r\n  public get locatable(): boolean {\r\n    // Handle legacy TerrainProps.nonLocatable:\r\n    // - If TerrainProps.nonLocatable=true and terrain is on, terrain is not locatable.\r\n    // - Otherwise, use BackgroundMapProps.nonLocatable.\r\n    if (this.applyTerrain && this.terrainSettings.nonLocatable)\r\n      return false;\r\n\r\n    return this._locatable;\r\n  }\r\n\r\n  /** If transparency is overridden, the transparency to apply; otherwise, undefined. */\r\n  public get transparencyOverride(): number | undefined { return false !== this.transparency ? this.transparency : undefined; }\r\n\r\n  private constructor(props: BackgroundMapProps | PersistentBackgroundMapProps) {\r\n    this.groundBias = props.groundBias ?? 0;\r\n    this.transparency = normalizeTransparency(props.transparency);\r\n    this.useDepthBuffer = props.useDepthBuffer ?? false;\r\n    this.applyTerrain = props.applyTerrain ?? false;\r\n    this.terrainSettings = TerrainSettings.fromJSON(props.terrainSettings);\r\n    this.globeMode = normalizeGlobeMode(props.globeMode);\r\n    this._locatable = true !== props.nonLocatable;\r\n    this.planarClipMask = PlanarClipMaskSettings.fromJSON(props.planarClipMask);\r\n    this._provider = BackgroundMapProvider.fromBackgroundMapProps(props);\r\n  }\r\n\r\n  /** Create settings from their persistent representation. In general, this method should only be used when reading the settings directly from\r\n   * the iModel - otherwise, prefer [[fromJSON]].\r\n   */\r\n  public static fromPersistentJSON(json?: PersistentBackgroundMapProps): BackgroundMapSettings {\r\n    return new this(json ?? {});\r\n  }\r\n\r\n  /** Construct from JSON, performing validation and applying default values for undefined fields.\r\n   * @see [[fromPersistentJSON]] if you are reading the settings directly from the iModel.\r\n   */\r\n  public static fromJSON(json?: BackgroundMapProps): BackgroundMapSettings {\r\n    return new BackgroundMapSettings(json ?? {});\r\n  }\r\n\r\n  /** Convert these settings to their in-memory JSON representation.\r\n   * @see [[toPersistentJSON]] if you intend to write the JSON directly to an iModel.\r\n   */\r\n  public toJSON(): BackgroundMapProps {\r\n    const props: BackgroundMapProps = {};\r\n    if (0 !== this.groundBias)\r\n      props.groundBias = this.groundBias;\r\n    if (this.applyTerrain)\r\n      props.applyTerrain = true;\r\n    if (false !== this.transparency)\r\n      props.transparency = this.transparency;\r\n    if (GlobeMode.Ellipsoid !== this.globeMode)\r\n      props.globeMode = this.globeMode;\r\n    if (this.useDepthBuffer)\r\n      props.useDepthBuffer = true;\r\n    if (!this._locatable)\r\n      props.nonLocatable = true;\r\n\r\n    const terrainSettings = this.terrainSettings.toJSON();\r\n    for (const prop of Object.values(terrainSettings)) {\r\n      if (undefined !== prop) {\r\n        props.terrainSettings = terrainSettings;\r\n        break;\r\n      }\r\n    }\r\n\r\n    if (this.planarClipMask.isValid)\r\n      props.planarClipMask = this.planarClipMask.toJSON();\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Convert these settings to their persistent representation. In general, this method should only be used when writing the settings directly to\r\n   * the iModel - otherwise, prefer [[toJSON]].\r\n   */\r\n  public toPersistentJSON(): PersistentBackgroundMapProps {\r\n    const props = this.toJSON() as PersistentBackgroundMapProps;\r\n\r\n    // Preserve deprecated imagery provider properties.\r\n    if (\"BingProvider\" !== this._provider.name)\r\n      props.providerName = this._provider.name; // eslint-disable-line deprecation/deprecation\r\n    if (BackgroundMapType.Hybrid !== this._provider.type)\r\n      props.providerData = { mapType: this._provider.type }; // eslint-disable-line deprecation/deprecation\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Returns true if these settings are equivalent to the supplied JSON settings. */\r\n  public equalsJSON(json?: BackgroundMapProps): boolean {\r\n    return this.equals(BackgroundMapSettings.fromJSON(json));\r\n  }\r\n\r\n  /** Returns true if the persistent representation of these settings is equivalent to `json`. */\r\n  public equalsPersistentJSON(json?: PersistentBackgroundMapProps): boolean {\r\n    return this.equals(BackgroundMapSettings.fromPersistentJSON(json));\r\n  }\r\n\r\n  /** Returns true if these settings are equivalent to `other`. */\r\n  public equals(other: BackgroundMapSettings): boolean {\r\n    return this.groundBias === other.groundBias && this.useDepthBuffer === other.useDepthBuffer && this.transparency === other.transparency\r\n      && this.globeMode === other.globeMode && this._locatable === other._locatable && this.applyTerrain === other.applyTerrain\r\n      && this.terrainSettings.equals(other.terrainSettings) && this.planarClipMask.equals(other.planarClipMask)\r\n      && this._provider.name === other._provider.name && this._provider.type === other._provider.type;\r\n  }\r\n\r\n  /** Create a copy of this BackgroundMapSettings, optionally modifying some of its properties.\r\n   * @param changedProps JSON representation of the properties to change.\r\n   * @returns A BackgroundMapSettings with all of its properties set to match those of `this`, except those explicitly defined in `changedProps`.\r\n   */\r\n  public clone(changedProps?: BackgroundMapProps): BackgroundMapSettings {\r\n    if (undefined === changedProps)\r\n      return this;\r\n\r\n    const props = {\r\n      groundBias: changedProps.groundBias ?? this.groundBias,\r\n      transparency: changedProps.transparency ?? this.transparency,\r\n      useDepthBuffer: changedProps.useDepthBuffer ?? this.useDepthBuffer,\r\n      globeMode: changedProps.globeMode ?? this.globeMode,\r\n      nonLocatable: changedProps.nonLocatable ?? !this._locatable,\r\n      applyTerrain: changedProps.applyTerrain ?? this.applyTerrain,\r\n      terrainSettings: changedProps.terrainSettings ? this.terrainSettings.clone(changedProps.terrainSettings).toJSON() : this.terrainSettings.toJSON(),\r\n      planarClipMask: changedProps.planarClipMask ? this.planarClipMask.clone(changedProps.planarClipMask).toJSON() : this.planarClipMask.toJSON(),\r\n      providerName: this._provider.name,\r\n      providerData: { mapType: this._provider.type },\r\n    };\r\n\r\n    return BackgroundMapSettings.fromPersistentJSON(props);\r\n  }\r\n}\r\n"]}

package/lib/esm/Base64EncodedString.d.ts

@@ -4,6 +4,7 @@
 /** Represents an array of bytes encoded in base-64 with a prefix indicating the encoding, as required when converting EC properties of `binary` type to and from JSON.
  * @see [[TextureProps.data]] and [[BRepEntity.DataProps.data]] for examples of properties of this type.
  * @public
+ * @extensions
  */
 export declare type Base64EncodedString = string;
 /** Represents an array of bytes encoded in base-64 with a prefix indicating the encoding, as persisted in an [ECDb]($backend) for properties of `binary` type.

package/lib/esm/Base64EncodedString.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Base64EncodedString.d.ts","sourceRoot":"","sources":["../../src/Base64EncodedString.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH;;;GAGG;AACH,oBAAY,mBAAmB,GAAG,MAAM,CAAC;AAEzC;;GAEG;AACH,yBAAiB,mBAAmB,CAAC;IACnC,4EAA4E;IACrE,MAAM,MAAM,qBAAqB,CAAC;IAEzC,2DAA2D;IAC3D,SAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,CAErE;IAED,2DAA2D;IAC3D,SAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,UAAU,CAEpE;IAED,+HAA+H;IAC/H,SAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;IAED,6FAA6F;IAC7F,SAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAEhE;IAED,4EAA4E;IAC5E,SAAgB,WAAW,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAE/D;IAED,uGAAuG;IAChG,MAAM,OAAO,UAAW,MAAM,SAAS,GAAG,KAAG,GAKnD,CAAC;IAEF,4GAA4G;IACrG,MAAM,QAAQ,UAAW,MAAM,SAAS,GAAG,KAAG,GAKpD,CAAC;CACH"}
+{"version":3,"file":"Base64EncodedString.d.ts","sourceRoot":"","sources":["../../src/Base64EncodedString.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH;;;;GAIG;AACH,oBAAY,mBAAmB,GAAG,MAAM,CAAC;AAEzC;;GAEG;AACH,yBAAiB,mBAAmB,CAAC;IACnC,4EAA4E;IACrE,MAAM,MAAM,qBAAqB,CAAC;IAEzC,2DAA2D;IAC3D,SAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,CAErE;IAED,2DAA2D;IAC3D,SAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,UAAU,CAEpE;IAED,+HAA+H;IAC/H,SAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;IAED,6FAA6F;IAC7F,SAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAEhE;IAED,4EAA4E;IAC5E,SAAgB,WAAW,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAE/D;IAED,uGAAuG;IAChG,MAAM,OAAO,UAAW,MAAM,SAAS,GAAG,KAAG,GAKnD,CAAC;IAEF,4GAA4G;IACrG,MAAM,QAAQ,UAAW,MAAM,SAAS,GAAG,KAAG,GAKpD,CAAC;CACH"}

package/lib/esm/Base64EncodedString.js.map

@@ -1 +1 @@
-{"version":3,"file":"Base64EncodedString.js","sourceRoot":"","sources":["../../src/Base64EncodedString.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAQnC;;GAEG;AACH,MAAM,KAAW,mBAAmB,CA4CnC;AA5CD,WAAiB,mBAAmB;IAClC,4EAA4E;IAC/D,0BAAM,GAAG,kBAAkB,CAAC;IAEzC,2DAA2D;IAC3D,SAAgB,cAAc,CAAC,KAAiB;QAC9C,OAAO,GAAG,oBAAA,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;IACpD,CAAC;IAFe,kCAAc,iBAE7B,CAAA;IAED,2DAA2D;IAC3D,SAAgB,YAAY,CAAC,MAA2B;QACtD,OAAO,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAFe,gCAAY,eAE3B,CAAA;IAED,+HAA+H;IAC/H,SAAgB,SAAS,CAAC,GAAW;QACnC,OAAO,GAAG,CAAC,UAAU,CAAC,oBAAA,MAAM,CAAC,CAAC;IAChC,CAAC;IAFe,6BAAS,YAExB,CAAA;IAED,6FAA6F;IAC7F,SAAgB,YAAY,CAAC,MAAc;QACzC,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,oBAAA,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3D,CAAC;IAFe,gCAAY,eAE3B,CAAA;IAED,4EAA4E;IAC5E,SAAgB,WAAW,CAAC,MAA2B;QACrD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAA,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,CAAC;IAFe,+BAAW,cAE1B,CAAA;IAED,uGAAuG;IAC1F,2BAAO,GAAG,CAAC,KAAa,EAAE,KAAU,EAAO,EAAE;QACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC;YAC/C,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAE9B,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,4GAA4G;IAC/F,4BAAQ,GAAG,CAAC,KAAa,EAAE,KAAU,EAAO,EAAE;QACzD,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,KAAK,UAAU;YAC3C,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAEhC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC,EA5CgB,mBAAmB,KAAnB,mBAAmB,QA4CnC","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 Entities\r\n */\r\n\r\nimport { Base64 } from \"js-base64\";\r\n\r\n/** Represents an array of bytes encoded in base-64 with a prefix indicating the encoding, as required when converting EC properties of `binary` type to and from JSON.\r\n * @see [[TextureProps.data]] and [[BRepEntity.DataProps.data]] for examples of properties of this type.\r\n * @public\r\n */\r\nexport type Base64EncodedString = string;\r\n\r\n/** Represents an array of bytes encoded in base-64 with a prefix indicating the encoding, as persisted in an [ECDb]($backend) for properties of `binary` type.\r\n * @public\r\n */\r\nexport namespace Base64EncodedString { // eslint-disable-line @typescript-eslint/no-redeclare\r\n  /** The prefix prepended to the string identifying it as base-64-encoded. */\r\n  export const prefix = \"encoding=base64;\";\r\n\r\n  /** Encode an array of bytes into a Base64EncodedString. */\r\n  export function fromUint8Array(bytes: Uint8Array): Base64EncodedString {\r\n    return `${prefix}${Base64.fromUint8Array(bytes)}`;\r\n  }\r\n\r\n  /** Decode a Base64EncodedString into an array of bytes. */\r\n  export function toUint8Array(base64: Base64EncodedString): Uint8Array {\r\n    return Base64.toUint8Array(stripPrefix(base64));\r\n  }\r\n\r\n  /** Returns true if the input starts with [[Base64EncodedString.prefix]] indicating it is a well-formed Base64EncodedString. */\r\n  export function hasPrefix(str: string): boolean {\r\n    return str.startsWith(prefix);\r\n  }\r\n\r\n  /** Ensure that the base-64-encoded string starts with the [[Base64EncodedString.prefix]]. */\r\n  export function ensurePrefix(base64: string): Base64EncodedString {\r\n    return hasPrefix(base64) ? base64 : `${prefix}${base64}`;\r\n  }\r\n\r\n  /** Remove the [[Base64EncodedString.prefix]] from the string if present. */\r\n  export function stripPrefix(base64: Base64EncodedString): string {\r\n    return hasPrefix(base64) ? base64.substr(prefix.length) : base64;\r\n  }\r\n\r\n  /** A function suitable for use with `JSON.parse` to revive a Base64EncodedString into a Uint8Array. */\r\n  export const reviver = (_name: string, value: any): any => {\r\n    if (typeof value === \"string\" && hasPrefix(value))\r\n      value = toUint8Array(value);\r\n\r\n    return value;\r\n  };\r\n\r\n  /** A function suitable for use with `JSON.stringify` to serialize a Uint8Array as a Base64EncodedString. */\r\n  export const replacer = (_name: string, value: any): any => {\r\n    if (value && value.constructor === Uint8Array)\r\n      value = fromUint8Array(value);\r\n\r\n    return value;\r\n  };\r\n}\r\n"]}
+{"version":3,"file":"Base64EncodedString.js","sourceRoot":"","sources":["../../src/Base64EncodedString.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AASnC;;GAEG;AACH,MAAM,KAAW,mBAAmB,CA4CnC;AA5CD,WAAiB,mBAAmB;IAClC,4EAA4E;IAC/D,0BAAM,GAAG,kBAAkB,CAAC;IAEzC,2DAA2D;IAC3D,SAAgB,cAAc,CAAC,KAAiB;QAC9C,OAAO,GAAG,oBAAA,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;IACpD,CAAC;IAFe,kCAAc,iBAE7B,CAAA;IAED,2DAA2D;IAC3D,SAAgB,YAAY,CAAC,MAA2B;QACtD,OAAO,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAFe,gCAAY,eAE3B,CAAA;IAED,+HAA+H;IAC/H,SAAgB,SAAS,CAAC,GAAW;QACnC,OAAO,GAAG,CAAC,UAAU,CAAC,oBAAA,MAAM,CAAC,CAAC;IAChC,CAAC;IAFe,6BAAS,YAExB,CAAA;IAED,6FAA6F;IAC7F,SAAgB,YAAY,CAAC,MAAc;QACzC,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,oBAAA,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3D,CAAC;IAFe,gCAAY,eAE3B,CAAA;IAED,4EAA4E;IAC5E,SAAgB,WAAW,CAAC,MAA2B;QACrD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAA,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,CAAC;IAFe,+BAAW,cAE1B,CAAA;IAED,uGAAuG;IAC1F,2BAAO,GAAG,CAAC,KAAa,EAAE,KAAU,EAAO,EAAE;QACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC;YAC/C,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAE9B,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,4GAA4G;IAC/F,4BAAQ,GAAG,CAAC,KAAa,EAAE,KAAU,EAAO,EAAE;QACzD,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,KAAK,UAAU;YAC3C,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAEhC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC,EA5CgB,mBAAmB,KAAnB,mBAAmB,QA4CnC","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 Entities\r\n */\r\n\r\nimport { Base64 } from \"js-base64\";\r\n\r\n/** Represents an array of bytes encoded in base-64 with a prefix indicating the encoding, as required when converting EC properties of `binary` type to and from JSON.\r\n * @see [[TextureProps.data]] and [[BRepEntity.DataProps.data]] for examples of properties of this type.\r\n * @public\r\n * @extensions\r\n */\r\nexport type Base64EncodedString = string;\r\n\r\n/** Represents an array of bytes encoded in base-64 with a prefix indicating the encoding, as persisted in an [ECDb]($backend) for properties of `binary` type.\r\n * @public\r\n */\r\nexport namespace Base64EncodedString { // eslint-disable-line @typescript-eslint/no-redeclare\r\n  /** The prefix prepended to the string identifying it as base-64-encoded. */\r\n  export const prefix = \"encoding=base64;\";\r\n\r\n  /** Encode an array of bytes into a Base64EncodedString. */\r\n  export function fromUint8Array(bytes: Uint8Array): Base64EncodedString {\r\n    return `${prefix}${Base64.fromUint8Array(bytes)}`;\r\n  }\r\n\r\n  /** Decode a Base64EncodedString into an array of bytes. */\r\n  export function toUint8Array(base64: Base64EncodedString): Uint8Array {\r\n    return Base64.toUint8Array(stripPrefix(base64));\r\n  }\r\n\r\n  /** Returns true if the input starts with [[Base64EncodedString.prefix]] indicating it is a well-formed Base64EncodedString. */\r\n  export function hasPrefix(str: string): boolean {\r\n    return str.startsWith(prefix);\r\n  }\r\n\r\n  /** Ensure that the base-64-encoded string starts with the [[Base64EncodedString.prefix]]. */\r\n  export function ensurePrefix(base64: string): Base64EncodedString {\r\n    return hasPrefix(base64) ? base64 : `${prefix}${base64}`;\r\n  }\r\n\r\n  /** Remove the [[Base64EncodedString.prefix]] from the string if present. */\r\n  export function stripPrefix(base64: Base64EncodedString): string {\r\n    return hasPrefix(base64) ? base64.substr(prefix.length) : base64;\r\n  }\r\n\r\n  /** A function suitable for use with `JSON.parse` to revive a Base64EncodedString into a Uint8Array. */\r\n  export const reviver = (_name: string, value: any): any => {\r\n    if (typeof value === \"string\" && hasPrefix(value))\r\n      value = toUint8Array(value);\r\n\r\n    return value;\r\n  };\r\n\r\n  /** A function suitable for use with `JSON.stringify` to serialize a Uint8Array as a Base64EncodedString. */\r\n  export const replacer = (_name: string, value: any): any => {\r\n    if (value && value.constructor === Uint8Array)\r\n      value = fromUint8Array(value);\r\n\r\n    return value;\r\n  };\r\n}\r\n"]}

package/lib/esm/BriefcaseTypes.d.ts

@@ -7,10 +7,12 @@ import { IModelEncryptionProps, OpenDbKey } from "./IModel";
 import { IModelVersionProps } from "./IModelVersion";
 /** The Id assigned to a briefcase by iModelHub, or [[BriefcaseIdValue.Unassigned]] .
  * @public
+ * @extensions
  */
 export declare type BriefcaseId = number;
 /** Values of [[BriefcaseId]] that have special meaning.
  * @public
+ * @extensions
  */
 export declare enum BriefcaseIdValue {
     /** Indicates an invalid/illegal BriefcaseId */
@@ -36,6 +38,7 @@ export declare enum BriefcaseIdValue {
 }
 /** Whether a briefcase is editable or may only accept incoming changesets from iModelHub
  * @public
+ * @extensions
  */
 export declare enum SyncMode {
     /** Use a fixed version (i.e. a checkpoint). See [CheckpointManager]($backend) for preferred approach to using checkpoint files. */
@@ -75,6 +78,7 @@ export interface OpenBriefcaseProps extends IModelEncryptionProps, OpenDbKey {
 }
 /** Properties of a local briefcase file, returned by [BriefcaseManager.getCachedBriefcases]($backend) and [BriefcaseManager.downloadBriefcase]($backend)
  * @public
+ * @extensions
  */
 export interface LocalBriefcaseProps {
     /** Full path of local file. */
@@ -94,6 +98,7 @@ export interface LocalBriefcaseProps {
 }
 /** Properties for downloading a briefcase to a local file, from iModelHub.
  * @public
+ * @extensions
  */
 export interface RequestNewBriefcaseProps {
     /** iTwin that the iModel belongs to. */

package/lib/esm/BriefcaseTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BriefcaseTypes.d.ts","sourceRoot":"","sources":["../../src/BriefcaseTypes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BriefcaseTypes.d.ts","sourceRoot":"","sources":["../../src/BriefcaseTypes.ts"],"names":[],"mappings":"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"}

package/lib/esm/BriefcaseTypes.js

@@ -7,6 +7,7 @@
  */
 /** Values of [[BriefcaseId]] that have special meaning.
  * @public
+ * @extensions
  */
 export var BriefcaseIdValue;
 (function (BriefcaseIdValue) {
@@ -33,6 +34,7 @@ export var BriefcaseIdValue;
 })(BriefcaseIdValue || (BriefcaseIdValue = {}));
 /** Whether a briefcase is editable or may only accept incoming changesets from iModelHub
  * @public
+ * @extensions
  */
 export var SyncMode;
 (function (SyncMode) {

package/lib/esm/BriefcaseTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"BriefcaseTypes.js","sourceRoot":"","sources":["../../src/BriefcaseTypes.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAYH;;GAEG;AACH,MAAM,CAAN,IAAY,gBAyBX;AAzBD,WAAY,gBAAgB;IAC1B,+CAA+C;IAC/C,sEAAoB,CAAA;IAEpB,gDAAgD;IAChD,4DAAa,CAAA;IAEb,gFAAgF;IAChF,mEAAc,CAAA;IAEd,+EAA+E;IAC/E,wEAAqC,CAAA;IAErC;;;;;;;;;;OAUG;IACH,mEAAc,CAAA;AAChB,CAAC,EAzBW,gBAAgB,KAAhB,gBAAgB,QAyB3B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,mIAAmI;IACnI,uDAAgB,CAAA;IAChB,0FAA0F;IAC1F,qDAAe,CAAA;IACf,qJAAqJ;IACrJ,+CAAY,CAAA;AACd,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AA2GD;;GAEG;AACH,MAAM,CAAN,IAAY,aAYX;AAZD,WAAY,aAAa;IACvB,qJAAqJ;IACrJ,mFAAyB,CAAA;IAEzB,iKAAiK;IACjK,yFAA4B,CAAA;IAE5B,sMAAsM;IACtM,uDAAW,CAAA;IAEX,qFAAqF;IACrF,2DAAa,CAAA;AACf,CAAC,EAZW,aAAa,KAAb,aAAa,QAYxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,0GAA0G;IAC1G,mDAAQ,CAAA;IAER,qDAAqD;IACrD,yDAAW,CAAA;AACb,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB;AAaD;;;;GAIG;AACH,MAAM,CAAN,IAAY,WAkBX;AAlBD,WAAY,WAAW;IACrB,sIAAsI;IACtI,qDAAQ,CAAA;IAER;;;OAGG;IACH,mEAAe,CAAA;IAEf,4IAA4I;IAC5I,yEAAkB,CAAA;IAElB,oIAAoI;IACpI,iDAAM,CAAA;IAEN,4FAA4F;IAC5F,iDAAM,CAAA;AACR,CAAC,EAlBW,WAAW,KAAX,WAAW,QAkBtB","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 iModels\r\n */\r\n\r\nimport { GuidString } from \"@itwin/core-bentley\";\r\nimport { ChangesetIdWithIndex, LocalFileName } from \"./ChangesetProps\";\r\nimport { IModelEncryptionProps, OpenDbKey } from \"./IModel\";\r\nimport { IModelVersionProps } from \"./IModelVersion\";\r\n\r\n/** The Id assigned to a briefcase by iModelHub, or [[BriefcaseIdValue.Unassigned]] .\r\n * @public\r\n */\r\nexport type BriefcaseId = number;\r\n\r\n/** Values of [[BriefcaseId]] that have special meaning.\r\n * @public\r\n */\r\nexport enum BriefcaseIdValue {\r\n  /** Indicates an invalid/illegal BriefcaseId */\r\n  Illegal = 0xffffffff,\r\n\r\n  /** BriefcaseIds must be less than this value */\r\n  Max = 1 << 24,\r\n\r\n  /** All valid iModelHub issued BriefcaseIds will be equal or higher than this */\r\n  FirstValid = 2,\r\n\r\n  /** All valid iModelHub issued BriefcaseIds will be equal or lower than this */\r\n  LastValid = BriefcaseIdValue.Max - 11,\r\n\r\n  /**\r\n   * The briefcase has not been assigned a unique Id by iModelHub. Only briefcases that have been assigned a unique BriefcaseId may create changesets,\r\n   * because BriefcaseId is used to create unique ElementIds for new elements.\r\n   *\r\n   * The `Unassigned` briefcaseId is used for several purposes:\r\n   *  - **Snapshots**. Snapshot files are immutable copies of an iModel for archival or data exchange purposes. They can neither generate nor accept new changesets.\r\n   *  - **Checkpoints**. Checkpoints are Snapshots that represent a specific version on an iModel's timeline.\r\n   *  - **PullOnly**. A local briefcase file that may be used to \"slide\" along a timeline by applying incoming changesets.\r\n   * They are always opened readonly except to apply changesets.\r\n   *  - **Standalone**. Standalone iModels are local files that are not connected to iModelHub, and therefore cannot accept or create changesets.\r\n   */\r\n  Unassigned = 0,\r\n}\r\n\r\n/** Whether a briefcase is editable or may only accept incoming changesets from iModelHub\r\n * @public\r\n */\r\nexport enum SyncMode {\r\n  /** Use a fixed version (i.e. a checkpoint). See [CheckpointManager]($backend) for preferred approach to using checkpoint files. */\r\n  FixedVersion = 1,\r\n  /** A briefcase that can be edited. A unique briefcaseId must be assigned by iModelHub. */\r\n  PullAndPush = 2,\r\n  /** use [BriefcaseIdValue.Unassigned](%backend). This makes a briefcase that can accept changesets from iModelHub but can never create changesets. */\r\n  PullOnly = 3,\r\n}\r\n\r\n/**\r\n * Options to open a previously downloaded briefcase\r\n * @public\r\n */\r\nexport interface OpenBriefcaseOptions {\r\n  /** open briefcase Readonly */\r\n  readonly openAsReadOnly?: boolean;\r\n}\r\n\r\n/**\r\n * Properties that specify a briefcase within the local briefcase cache.\r\n * @see BriefcaseManager.getFileName\r\n * @public\r\n */\r\nexport interface BriefcaseProps {\r\n  /** Id of the iModel */\r\n  readonly iModelId: GuidString;\r\n\r\n  /** BriefcaseId of the briefcase */\r\n  readonly briefcaseId: BriefcaseId;\r\n}\r\n\r\n/** Properties for opening a local briefcase file via [BriefcaseDb.open]($backend)\r\n * @public\r\n */\r\nexport interface OpenBriefcaseProps extends IModelEncryptionProps, OpenDbKey {\r\n  /** the full path to the briefcase file  */\r\n  readonly fileName: LocalFileName;\r\n  /** If true, open the briefcase readonly */\r\n  readonly readonly?: boolean;\r\n}\r\n\r\n/** Properties of a local briefcase file, returned by [BriefcaseManager.getCachedBriefcases]($backend) and [BriefcaseManager.downloadBriefcase]($backend)\r\n * @public\r\n */\r\nexport interface LocalBriefcaseProps {\r\n  /** Full path of local file. */\r\n  readonly fileName: LocalFileName;\r\n\r\n  /** The iTwin containing the iModel. */\r\n  readonly iTwinId: GuidString;\r\n\r\n  /** The iModelId. */\r\n  readonly iModelId: GuidString;\r\n\r\n  /** The briefcaseId. */\r\n  readonly briefcaseId: BriefcaseId;\r\n\r\n  /** The current changesetId.\r\n   * @note ChangeSet Ids are string hash values based on the ChangeSet's content and parent.\r\n   */\r\n  readonly changeset: ChangesetIdWithIndex;\r\n\r\n  /** Size of the briefcase file in bytes  */\r\n  readonly fileSize: number;\r\n}\r\n\r\n/** Properties for downloading a briefcase to a local file, from iModelHub.\r\n * @public\r\n */\r\nexport interface RequestNewBriefcaseProps {\r\n  /** iTwin that the iModel belongs to. */\r\n  readonly iTwinId: GuidString;\r\n\r\n  /** The iModelId for the new briefcase. */\r\n  readonly iModelId: GuidString;\r\n\r\n  /** Full path of local file to store the briefcase. If undefined, a file will be created in the briefcase cache, and this member will be filled with the full path to the file.\r\n   * Callers can use this to open the briefcase after the download completes.\r\n   * @note this member is both an input and an output.\r\n   */\r\n  readonly fileName?: LocalFileName;\r\n\r\n  /**\r\n   * The BriefcaseId for the new briefcase. If undefined, a new BriefcaseId will be acquired from iModelHub before the download, and is returned in this member.\r\n   * @note To download a briefcase that can accept but not create new changesets (sometimes referred to as \"pull only\" briefcases), set this value to [[BriefcaseIdValue.Unassigned]].\r\n   * After downloading, you can merely delete unassigned briefcase files when they are no longer needed. Assigned BriefcaseIds should be released (via [BriefcaseManager.releaseBriefcase]($backend) )\r\n   * when you are done with them.\r\n   * @note this member is both an input and an output.\r\n   *\r\n   */\r\n  briefcaseId?: BriefcaseId;\r\n\r\n  /** Id of the change set of the new briefcase. If undefined, use latest. */\r\n  asOf?: IModelVersionProps;\r\n}\r\n\r\n/**\r\n * Manages the download of a briefcase\r\n * @public\r\n */\r\nexport interface BriefcaseDownloader {\r\n  /** Id of the briefcase being downloaded */\r\n  readonly briefcaseId: BriefcaseId;\r\n\r\n  /** the name of the local file for the briefcase */\r\n  readonly fileName: LocalFileName;\r\n\r\n  /** Promise that resolves when the download completes. await this to complete the download */\r\n  readonly downloadPromise: Promise<void>;\r\n\r\n  /** Request cancellation of the download */\r\n  readonly requestCancel: () => Promise<boolean>;\r\n}\r\n\r\n/** Option to control the validation and upgrade of domain schemas in the Db\r\n * @beta\r\n */\r\nexport enum DomainOptions {\r\n  /** Domain schemas will be validated for any required upgrades. Any errors will be reported back, and cause the application to fail opening the Db */\r\n  CheckRequiredUpgrades = 0,\r\n\r\n  /** Domain schemas will be validated for any required or optional upgrades. Any errors will be reported back, and cause the application to fail opening the Db */\r\n  CheckRecommendedUpgrades = 1,\r\n\r\n  /** Domain schemas will be upgraded if necessary. However, only compatible schema upgrades will be allowed - these are typically additions of classes, properties, and changes to custom attributes */\r\n  Upgrade = 2,\r\n\r\n  /** Domain schemas will neither be validated nor be upgraded. Used only internally */\r\n  SkipCheck = 3,\r\n}\r\n\r\n/** Options that control whether a profile upgrade should be performed when opening a Db\r\n * @beta\r\n */\r\nexport enum ProfileOptions {\r\n  /** No profile upgrade will be performed. If a profile upgrade was required, opening the file will fail */\r\n  None = 0,\r\n\r\n  /** Profile upgrade will be performed if necessary */\r\n  Upgrade = 1,\r\n}\r\n\r\n/** Arguments to validate and update the profile and domain schemas when opening a Db\r\n * @beta\r\n */\r\nexport interface UpgradeOptions {\r\n  /** Option to control the validation and upgrade of domain schemas in the Db */\r\n  readonly domain?: DomainOptions;\r\n\r\n  /** Options that control whether a profile upgrade should be performed when opening a file */\r\n  readonly profile?: ProfileOptions;\r\n}\r\n\r\n/**\r\n * The state of the schemas in the Db compared with what the current version of the software expects\r\n * Note: The state may vary depending on whether the Db is to be opened ReadOnly or ReadWrite.\r\n * @beta\r\n */\r\nexport enum SchemaState {\r\n  /** The schemas in the Db are up-to-date, and do not need to be upgraded before opening it with the current version of the software */\r\n  UpToDate,\r\n\r\n  /** It's required that the schemas in the Db be upgraded before it can be opened with the current version of the software.\r\n   * This may happen in read-write scenarios where the application requires a newer version of the schemas to be in place before\r\n   * it can write data based on that new schema.\r\n   */\r\n  UpgradeRequired,\r\n\r\n  /** It's recommended, but not necessary that the schemas in the Db be upgraded before opening it with the current version of the software */\r\n  UpgradeRecommended,\r\n\r\n  /** The schemas in the Db are too old to be opened by the current version of the software. Upgrade using the API is not possible. */\r\n  TooOld,\r\n\r\n  /** The schemas in the Db are too new to be opened by the current version of the software */\r\n  TooNew,\r\n}\r\n"]}
+{"version":3,"file":"BriefcaseTypes.js","sourceRoot":"","sources":["../../src/BriefcaseTypes.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAaH;;;GAGG;AACH,MAAM,CAAN,IAAY,gBAyBX;AAzBD,WAAY,gBAAgB;IAC1B,+CAA+C;IAC/C,sEAAoB,CAAA;IAEpB,gDAAgD;IAChD,4DAAa,CAAA;IAEb,gFAAgF;IAChF,mEAAc,CAAA;IAEd,+EAA+E;IAC/E,wEAAqC,CAAA;IAErC;;;;;;;;;;OAUG;IACH,mEAAc,CAAA;AAChB,CAAC,EAzBW,gBAAgB,KAAhB,gBAAgB,QAyB3B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,mIAAmI;IACnI,uDAAgB,CAAA;IAChB,0FAA0F;IAC1F,qDAAe,CAAA;IACf,qJAAqJ;IACrJ,+CAAY,CAAA;AACd,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AA6GD;;GAEG;AACH,MAAM,CAAN,IAAY,aAYX;AAZD,WAAY,aAAa;IACvB,qJAAqJ;IACrJ,mFAAyB,CAAA;IAEzB,iKAAiK;IACjK,yFAA4B,CAAA;IAE5B,sMAAsM;IACtM,uDAAW,CAAA;IAEX,qFAAqF;IACrF,2DAAa,CAAA;AACf,CAAC,EAZW,aAAa,KAAb,aAAa,QAYxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,0GAA0G;IAC1G,mDAAQ,CAAA;IAER,qDAAqD;IACrD,yDAAW,CAAA;AACb,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB;AAaD;;;;GAIG;AACH,MAAM,CAAN,IAAY,WAkBX;AAlBD,WAAY,WAAW;IACrB,sIAAsI;IACtI,qDAAQ,CAAA;IAER;;;OAGG;IACH,mEAAe,CAAA;IAEf,4IAA4I;IAC5I,yEAAkB,CAAA;IAElB,oIAAoI;IACpI,iDAAM,CAAA;IAEN,4FAA4F;IAC5F,iDAAM,CAAA;AACR,CAAC,EAlBW,WAAW,KAAX,WAAW,QAkBtB","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 iModels\r\n */\r\n\r\nimport { GuidString } from \"@itwin/core-bentley\";\r\nimport { ChangesetIdWithIndex, LocalFileName } from \"./ChangesetProps\";\r\nimport { IModelEncryptionProps, OpenDbKey } from \"./IModel\";\r\nimport { IModelVersionProps } from \"./IModelVersion\";\r\n\r\n/** The Id assigned to a briefcase by iModelHub, or [[BriefcaseIdValue.Unassigned]] .\r\n * @public\r\n * @extensions\r\n */\r\nexport type BriefcaseId = number;\r\n\r\n/** Values of [[BriefcaseId]] that have special meaning.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum BriefcaseIdValue {\r\n  /** Indicates an invalid/illegal BriefcaseId */\r\n  Illegal = 0xffffffff,\r\n\r\n  /** BriefcaseIds must be less than this value */\r\n  Max = 1 << 24,\r\n\r\n  /** All valid iModelHub issued BriefcaseIds will be equal or higher than this */\r\n  FirstValid = 2,\r\n\r\n  /** All valid iModelHub issued BriefcaseIds will be equal or lower than this */\r\n  LastValid = BriefcaseIdValue.Max - 11,\r\n\r\n  /**\r\n   * The briefcase has not been assigned a unique Id by iModelHub. Only briefcases that have been assigned a unique BriefcaseId may create changesets,\r\n   * because BriefcaseId is used to create unique ElementIds for new elements.\r\n   *\r\n   * The `Unassigned` briefcaseId is used for several purposes:\r\n   *  - **Snapshots**. Snapshot files are immutable copies of an iModel for archival or data exchange purposes. They can neither generate nor accept new changesets.\r\n   *  - **Checkpoints**. Checkpoints are Snapshots that represent a specific version on an iModel's timeline.\r\n   *  - **PullOnly**. A local briefcase file that may be used to \"slide\" along a timeline by applying incoming changesets.\r\n   * They are always opened readonly except to apply changesets.\r\n   *  - **Standalone**. Standalone iModels are local files that are not connected to iModelHub, and therefore cannot accept or create changesets.\r\n   */\r\n  Unassigned = 0,\r\n}\r\n\r\n/** Whether a briefcase is editable or may only accept incoming changesets from iModelHub\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SyncMode {\r\n  /** Use a fixed version (i.e. a checkpoint). See [CheckpointManager]($backend) for preferred approach to using checkpoint files. */\r\n  FixedVersion = 1,\r\n  /** A briefcase that can be edited. A unique briefcaseId must be assigned by iModelHub. */\r\n  PullAndPush = 2,\r\n  /** use [BriefcaseIdValue.Unassigned](%backend). This makes a briefcase that can accept changesets from iModelHub but can never create changesets. */\r\n  PullOnly = 3,\r\n}\r\n\r\n/**\r\n * Options to open a previously downloaded briefcase\r\n * @public\r\n */\r\nexport interface OpenBriefcaseOptions {\r\n  /** open briefcase Readonly */\r\n  readonly openAsReadOnly?: boolean;\r\n}\r\n\r\n/**\r\n * Properties that specify a briefcase within the local briefcase cache.\r\n * @see BriefcaseManager.getFileName\r\n * @public\r\n */\r\nexport interface BriefcaseProps {\r\n  /** Id of the iModel */\r\n  readonly iModelId: GuidString;\r\n\r\n  /** BriefcaseId of the briefcase */\r\n  readonly briefcaseId: BriefcaseId;\r\n}\r\n\r\n/** Properties for opening a local briefcase file via [BriefcaseDb.open]($backend)\r\n * @public\r\n */\r\nexport interface OpenBriefcaseProps extends IModelEncryptionProps, OpenDbKey {\r\n  /** the full path to the briefcase file  */\r\n  readonly fileName: LocalFileName;\r\n  /** If true, open the briefcase readonly */\r\n  readonly readonly?: boolean;\r\n}\r\n\r\n/** Properties of a local briefcase file, returned by [BriefcaseManager.getCachedBriefcases]($backend) and [BriefcaseManager.downloadBriefcase]($backend)\r\n * @public\r\n * @extensions\r\n */\r\nexport interface LocalBriefcaseProps {\r\n  /** Full path of local file. */\r\n  readonly fileName: LocalFileName;\r\n\r\n  /** The iTwin containing the iModel. */\r\n  readonly iTwinId: GuidString;\r\n\r\n  /** The iModelId. */\r\n  readonly iModelId: GuidString;\r\n\r\n  /** The briefcaseId. */\r\n  readonly briefcaseId: BriefcaseId;\r\n\r\n  /** The current changesetId.\r\n   * @note ChangeSet Ids are string hash values based on the ChangeSet's content and parent.\r\n   */\r\n  readonly changeset: ChangesetIdWithIndex;\r\n\r\n  /** Size of the briefcase file in bytes  */\r\n  readonly fileSize: number;\r\n}\r\n\r\n/** Properties for downloading a briefcase to a local file, from iModelHub.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface RequestNewBriefcaseProps {\r\n  /** iTwin that the iModel belongs to. */\r\n  readonly iTwinId: GuidString;\r\n\r\n  /** The iModelId for the new briefcase. */\r\n  readonly iModelId: GuidString;\r\n\r\n  /** Full path of local file to store the briefcase. If undefined, a file will be created in the briefcase cache, and this member will be filled with the full path to the file.\r\n   * Callers can use this to open the briefcase after the download completes.\r\n   * @note this member is both an input and an output.\r\n   */\r\n  readonly fileName?: LocalFileName;\r\n\r\n  /**\r\n   * The BriefcaseId for the new briefcase. If undefined, a new BriefcaseId will be acquired from iModelHub before the download, and is returned in this member.\r\n   * @note To download a briefcase that can accept but not create new changesets (sometimes referred to as \"pull only\" briefcases), set this value to [[BriefcaseIdValue.Unassigned]].\r\n   * After downloading, you can merely delete unassigned briefcase files when they are no longer needed. Assigned BriefcaseIds should be released (via [BriefcaseManager.releaseBriefcase]($backend) )\r\n   * when you are done with them.\r\n   * @note this member is both an input and an output.\r\n   *\r\n   */\r\n  briefcaseId?: BriefcaseId;\r\n\r\n  /** Id of the change set of the new briefcase. If undefined, use latest. */\r\n  asOf?: IModelVersionProps;\r\n}\r\n\r\n/**\r\n * Manages the download of a briefcase\r\n * @public\r\n */\r\nexport interface BriefcaseDownloader {\r\n  /** Id of the briefcase being downloaded */\r\n  readonly briefcaseId: BriefcaseId;\r\n\r\n  /** the name of the local file for the briefcase */\r\n  readonly fileName: LocalFileName;\r\n\r\n  /** Promise that resolves when the download completes. await this to complete the download */\r\n  readonly downloadPromise: Promise<void>;\r\n\r\n  /** Request cancellation of the download */\r\n  readonly requestCancel: () => Promise<boolean>;\r\n}\r\n\r\n/** Option to control the validation and upgrade of domain schemas in the Db\r\n * @beta\r\n */\r\nexport enum DomainOptions {\r\n  /** Domain schemas will be validated for any required upgrades. Any errors will be reported back, and cause the application to fail opening the Db */\r\n  CheckRequiredUpgrades = 0,\r\n\r\n  /** Domain schemas will be validated for any required or optional upgrades. Any errors will be reported back, and cause the application to fail opening the Db */\r\n  CheckRecommendedUpgrades = 1,\r\n\r\n  /** Domain schemas will be upgraded if necessary. However, only compatible schema upgrades will be allowed - these are typically additions of classes, properties, and changes to custom attributes */\r\n  Upgrade = 2,\r\n\r\n  /** Domain schemas will neither be validated nor be upgraded. Used only internally */\r\n  SkipCheck = 3,\r\n}\r\n\r\n/** Options that control whether a profile upgrade should be performed when opening a Db\r\n * @beta\r\n */\r\nexport enum ProfileOptions {\r\n  /** No profile upgrade will be performed. If a profile upgrade was required, opening the file will fail */\r\n  None = 0,\r\n\r\n  /** Profile upgrade will be performed if necessary */\r\n  Upgrade = 1,\r\n}\r\n\r\n/** Arguments to validate and update the profile and domain schemas when opening a Db\r\n * @beta\r\n */\r\nexport interface UpgradeOptions {\r\n  /** Option to control the validation and upgrade of domain schemas in the Db */\r\n  readonly domain?: DomainOptions;\r\n\r\n  /** Options that control whether a profile upgrade should be performed when opening a file */\r\n  readonly profile?: ProfileOptions;\r\n}\r\n\r\n/**\r\n * The state of the schemas in the Db compared with what the current version of the software expects\r\n * Note: The state may vary depending on whether the Db is to be opened ReadOnly or ReadWrite.\r\n * @beta\r\n */\r\nexport enum SchemaState {\r\n  /** The schemas in the Db are up-to-date, and do not need to be upgraded before opening it with the current version of the software */\r\n  UpToDate,\r\n\r\n  /** It's required that the schemas in the Db be upgraded before it can be opened with the current version of the software.\r\n   * This may happen in read-write scenarios where the application requires a newer version of the schemas to be in place before\r\n   * it can write data based on that new schema.\r\n   */\r\n  UpgradeRequired,\r\n\r\n  /** It's recommended, but not necessary that the schemas in the Db be upgraded before opening it with the current version of the software */\r\n  UpgradeRecommended,\r\n\r\n  /** The schemas in the Db are too old to be opened by the current version of the software. Upgrade using the API is not possible. */\r\n  TooOld,\r\n\r\n  /** The schemas in the Db are too new to be opened by the current version of the software */\r\n  TooNew,\r\n}\r\n"]}

package/lib/esm/Camera.d.ts

@@ -4,6 +4,7 @@
 import { Angle, AngleProps, Point3d, XYAndZ, XYZProps } from "@itwin/core-geometry";
 /** JSON representation of a [[Camera]].
  * @public
+ * @extensions
  */
 export interface CameraProps {
     lens: AngleProps;

package/lib/esm/Camera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Camera.d.ts","sourceRoot":"","sources":["../../src/Camera.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,QAAQ,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,MAAO,YAAW,WAAW;IACxC,SAAgB,IAAI,EAAE,KAAK,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IACzB,SAAgB,GAAG,EAAE,OAAO,CAAC;WAEf,gBAAgB,CAAC,GAAG,EAAE,KAAK;WAC3B,iBAAiB,CAAC,GAAG,EAAE,KAAK;IACnC,eAAe;IACtB,IAAW,YAAY,YAA8D;IAC9E,gBAAgB;IAChB,gBAAgB,CAAC,IAAI,EAAE,MAAM;IACpC,IAAW,WAAW,YAAiD;IAChE,YAAY;IACZ,YAAY;IACZ,YAAY,CAAC,KAAK,EAAE,KAAK;IACzB,WAAW;IACX,WAAW,CAAC,EAAE,EAAE,MAAM;IAC7B,IAAW,OAAO,YAAoD;IAC/D,MAAM,CAAC,KAAK,EAAE,MAAM;IAKpB,KAAK;IACL,OAAO,CAAC,GAAG,EAAE,MAAM;IAM1B;;OAEG;gBACgB,KAAK,CAAC,EAAE,WAAW;CAWvC"}
+{"version":3,"file":"Camera.d.ts","sourceRoot":"","sources":["../../src/Camera.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEpF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,QAAQ,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,MAAO,YAAW,WAAW;IACxC,SAAgB,IAAI,EAAE,KAAK,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IACzB,SAAgB,GAAG,EAAE,OAAO,CAAC;WAEf,gBAAgB,CAAC,GAAG,EAAE,KAAK;WAC3B,iBAAiB,CAAC,GAAG,EAAE,KAAK;IACnC,eAAe;IACtB,IAAW,YAAY,YAA8D;IAC9E,gBAAgB;IAChB,gBAAgB,CAAC,IAAI,EAAE,MAAM;IACpC,IAAW,WAAW,YAAiD;IAChE,YAAY;IACZ,YAAY;IACZ,YAAY,CAAC,KAAK,EAAE,KAAK;IACzB,WAAW;IACX,WAAW,CAAC,EAAE,EAAE,MAAM;IAC7B,IAAW,OAAO,YAAoD;IAC/D,MAAM,CAAC,KAAK,EAAE,MAAM;IAKpB,KAAK;IACL,OAAO,CAAC,GAAG,EAAE,MAAM;IAM1B;;OAEG;gBACgB,KAAK,CAAC,EAAE,WAAW;CAWvC"}

package/lib/esm/Camera.js.map

@@ -1 +1 @@
-{"version":3,"file":"Camera.js","sourceRoot":"","sources":["../../src/Camera.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 { JsonUtils } from \"@itwin/core-bentley\";\r\nimport { Angle, AngleProps, Point3d, XYAndZ, XYZProps } from \"@itwin/core-geometry\";\r\n\r\n/** JSON representation of a [[Camera]].\r\n * @public\r\n */\r\nexport interface CameraProps {\r\n  lens: AngleProps;\r\n  focusDist: number; // NOTE: this is abbreviated, do not change!\r\n  eye: XYZProps;\r\n}\r\n\r\n/** The current position (eyepoint), lens angle, and focus distance of a camera.\r\n * @see [Views]($docs/learning/frontend/Views.md)\r\n * @public\r\n */\r\nexport class Camera implements CameraProps {\r\n  public readonly lens: Angle;\r\n  public focusDist: number;\r\n  public readonly eye: Point3d;\r\n\r\n  public static isValidLensAngle(val: Angle) { return val.radians > (Math.PI / 8.0) && val.radians < Math.PI; }\r\n  public static validateLensAngle(val: Angle) { if (!this.isValidLensAngle(val)) val.setRadians(Math.PI / 2.0); }\r\n  public invalidateFocus() { this.focusDist = 0.0; }\r\n  public get isFocusValid() { return this.focusDist > 0.0 && this.focusDist < 1.0e14; }\r\n  public getFocusDistance() { return this.focusDist; }\r\n  public setFocusDistance(dist: number) { this.focusDist = dist; }\r\n  public get isLensValid() { return Camera.isValidLensAngle(this.lens); }\r\n  public validateLens() { Camera.validateLensAngle(this.lens); }\r\n  public getLensAngle() { return this.lens; }\r\n  public setLensAngle(angle: Angle) { this.lens.setFrom(angle); }\r\n  public getEyePoint() { return this.eye; }\r\n  public setEyePoint(pt: XYAndZ) { this.eye.setFrom(pt); }\r\n  public get isValid() { return this.isLensValid && this.isFocusValid; }\r\n  public equals(other: Camera) {\r\n    return Math.abs(this.lens.radians - other.lens.radians) < .01 &&\r\n      Math.abs(this.focusDist - other.focusDist) < .1 &&\r\n      this.eye.isAlmostEqual(other.eye);\r\n  }\r\n  public clone() { return new Camera(this); }\r\n  public setFrom(rhs: Camera) {\r\n    this.lens.setFrom(rhs.lens);\r\n    this.focusDist = rhs.focusDist;\r\n    this.eye.setFrom(rhs.eye);\r\n  }\r\n\r\n  /** Construct a Camera\r\n   * @param props The properties of the new camera. If undefined, create a camera with eye at {0,0,0}, 90 degree lens, 1 meter focus distance.\r\n   */\r\n  public constructor(props?: CameraProps) {\r\n    if (props !== undefined) {\r\n      this.lens = Angle.fromJSON(props.lens);\r\n      this.focusDist = JsonUtils.asDouble(props.focusDist);\r\n      this.eye = Point3d.fromJSON(props.eye);\r\n      return;\r\n    }\r\n    this.lens = Angle.createRadians(Math.PI / 2.0);\r\n    this.focusDist = 1;\r\n    this.eye = new Point3d();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Camera.js","sourceRoot":"","sources":["../../src/Camera.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 { JsonUtils } from \"@itwin/core-bentley\";\r\nimport { Angle, AngleProps, Point3d, XYAndZ, XYZProps } from \"@itwin/core-geometry\";\r\n\r\n/** JSON representation of a [[Camera]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface CameraProps {\r\n  lens: AngleProps;\r\n  focusDist: number; // NOTE: this is abbreviated, do not change!\r\n  eye: XYZProps;\r\n}\r\n\r\n/** The current position (eyepoint), lens angle, and focus distance of a camera.\r\n * @see [Views]($docs/learning/frontend/Views.md)\r\n * @public\r\n */\r\nexport class Camera implements CameraProps {\r\n  public readonly lens: Angle;\r\n  public focusDist: number;\r\n  public readonly eye: Point3d;\r\n\r\n  public static isValidLensAngle(val: Angle) { return val.radians > (Math.PI / 8.0) && val.radians < Math.PI; }\r\n  public static validateLensAngle(val: Angle) { if (!this.isValidLensAngle(val)) val.setRadians(Math.PI / 2.0); }\r\n  public invalidateFocus() { this.focusDist = 0.0; }\r\n  public get isFocusValid() { return this.focusDist > 0.0 && this.focusDist < 1.0e14; }\r\n  public getFocusDistance() { return this.focusDist; }\r\n  public setFocusDistance(dist: number) { this.focusDist = dist; }\r\n  public get isLensValid() { return Camera.isValidLensAngle(this.lens); }\r\n  public validateLens() { Camera.validateLensAngle(this.lens); }\r\n  public getLensAngle() { return this.lens; }\r\n  public setLensAngle(angle: Angle) { this.lens.setFrom(angle); }\r\n  public getEyePoint() { return this.eye; }\r\n  public setEyePoint(pt: XYAndZ) { this.eye.setFrom(pt); }\r\n  public get isValid() { return this.isLensValid && this.isFocusValid; }\r\n  public equals(other: Camera) {\r\n    return Math.abs(this.lens.radians - other.lens.radians) < .01 &&\r\n      Math.abs(this.focusDist - other.focusDist) < .1 &&\r\n      this.eye.isAlmostEqual(other.eye);\r\n  }\r\n  public clone() { return new Camera(this); }\r\n  public setFrom(rhs: Camera) {\r\n    this.lens.setFrom(rhs.lens);\r\n    this.focusDist = rhs.focusDist;\r\n    this.eye.setFrom(rhs.eye);\r\n  }\r\n\r\n  /** Construct a Camera\r\n   * @param props The properties of the new camera. If undefined, create a camera with eye at {0,0,0}, 90 degree lens, 1 meter focus distance.\r\n   */\r\n  public constructor(props?: CameraProps) {\r\n    if (props !== undefined) {\r\n      this.lens = Angle.fromJSON(props.lens);\r\n      this.focusDist = JsonUtils.asDouble(props.focusDist);\r\n      this.eye = Point3d.fromJSON(props.eye);\r\n      return;\r\n    }\r\n    this.lens = Angle.createRadians(Math.PI / 2.0);\r\n    this.focusDist = 1;\r\n    this.eye = new Point3d();\r\n  }\r\n}\r\n"]}

package/lib/esm/ChangedElements.d.ts

@@ -6,6 +6,7 @@ import { DbOpcode, Id64String } from "@itwin/core-bentley";
 import { AxisAlignedBox3dProps } from "./geometry/Placement";
 /** Bitflags describing which aspects of an [Element]($backend) changed as part of a [[ChangedElements]].
  * @public
+ * @extensions
  */
 export declare enum TypeOfChange {
     /** A property in the element changed */
@@ -24,6 +25,7 @@ export declare enum TypeOfChange {
  * Each index for those arrays refer to the same element, e.g. to get the class Id of
  * the element given by element Id changedElements.elements[index], you can use changedElements.classIds[index].
  * @public
+ * @extensions
  */
 export interface ChangedElements {
     /** Ids of elements that changed */

package/lib/esm/ChangedElements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChangedElements.d.ts","sourceRoot":"","sources":["../../src/ChangedElements.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAI7D;;GAEG;AACH,oBAAY,YAAY;IACtB,wCAAwC;IACxC,QAAQ,IAAM;IACd,oEAAoE;IACpE,QAAQ,IAAO;IACf,kEAAkE;IAClE,SAAS,IAAQ;IACjB,qEAAqE;IACrE,QAAQ,IAAS;IACjB,+CAA+C;IAC/C,MAAM,KAAU;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB;;OAEG;IACH,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,oDAAoD;IACpD,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB;;MAEE;IACF,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;IACzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC;CAC/B;AAED,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAED,gBAAgB;AAChB,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;CAC9B"}
+{"version":3,"file":"ChangedElements.d.ts","sourceRoot":"","sources":["../../src/ChangedElements.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAI7D;;;GAGG;AACH,oBAAY,YAAY;IACtB,wCAAwC;IACxC,QAAQ,IAAM;IACd,oEAAoE;IACpE,QAAQ,IAAO;IACf,kEAAkE;IAClE,SAAS,IAAQ;IACjB,qEAAqE;IACrE,QAAQ,IAAS;IACjB,+CAA+C;IAC/C,MAAM,KAAU;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB;;OAEG;IACH,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,oDAAoD;IACpD,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB;;MAEE;IACF,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;IACzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC;CAC/B;AAED,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAED,gBAAgB;AAChB,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;CAC9B"}

package/lib/esm/ChangedElements.js

@@ -1,6 +1,7 @@
 // cspell:ignore bboxes
 /** Bitflags describing which aspects of an [Element]($backend) changed as part of a [[ChangedElements]].
  * @public
+ * @extensions
  */
 export var TypeOfChange;
 (function (TypeOfChange) {

package/lib/esm/ChangedElements.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChangedElements.js","sourceRoot":"","sources":["../../src/ChangedElements.ts"],"names":[],"mappings":"AAWA,uBAAuB;AAEvB;;GAEG;AACH,MAAM,CAAN,IAAY,YAWX;AAXD,WAAY,YAAY;IACtB,wCAAwC;IACxC,uDAAc,CAAA;IACd,oEAAoE;IACpE,uDAAe,CAAA;IACf,kEAAkE;IAClE,yDAAiB,CAAA;IACjB,qEAAqE;IACrE,uDAAiB,CAAA;IACjB,+CAA+C;IAC/C,oDAAgB,CAAA;AAClB,CAAC,EAXW,YAAY,KAAZ,YAAY,QAWvB","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/**\r\n * @packageDocumentation\r\n * @module Entities\r\n */\r\nimport { DbOpcode, Id64String } from \"@itwin/core-bentley\";\r\nimport { AxisAlignedBox3dProps } from \"./geometry/Placement\";\r\n\r\n// cspell:ignore bboxes\r\n\r\n/** Bitflags describing which aspects of an [Element]($backend) changed as part of a [[ChangedElements]].\r\n * @public\r\n */\r\nexport enum TypeOfChange {\r\n  /** A property in the element changed */\r\n  Property = 0b1,\r\n  /** The geometry stream of a [GeometricElement]($backend) changed */\r\n  Geometry = 0b10,\r\n  /** The [[Placement]] of a [GeometricElement]($backend) changed */\r\n  Placement = 0b100,\r\n  /** Indirect change occurred to this element by a related instance */\r\n  Indirect = 0b1000,\r\n  /** Hidden properties of the element changed */\r\n  Hidden = 0b10000,\r\n}\r\n\r\n/** Changed elements found in a changeset or between a range of changesets.\r\n * All arrays in this object will have the same number of items.\r\n * Each index for those arrays refer to the same element, e.g. to get the class Id of\r\n * the element given by element Id changedElements.elements[index], you can use changedElements.classIds[index].\r\n * @public\r\n */\r\nexport interface ChangedElements {\r\n  /** Ids of elements that changed */\r\n  elements: Id64String[];\r\n  /** ECClass Ids of elements that changed */\r\n  classIds: Id64String[];\r\n  /** Operation that occurred on the element. Whether the element was inserted, updated or deleted.\r\n   * See [DbOpcode]($core-bentley)\r\n   */\r\n  opcodes: DbOpcode[];\r\n  /** Type of change bitflags, see [[TypeOfChange]] */\r\n  type: TypeOfChange[];\r\n  /** Model Ids of the changed elements\r\n   * This may be undefined if the agent that did the processing job did not export model Ids\r\n   */\r\n  modelIds?: Id64String[];\r\n  /** Property accessor strings of properties that changed, if any, for each changed element\r\n   * This may be undefined if the agent that did the processing job did not export properties\r\n  */\r\n  properties?: string[][];\r\n  /** Before state checksums of the property value\r\n   * Useful to determine if property values have changed\r\n   * between the versions being inspected\r\n   * This may be undefined if the agent that did the processing job did not export checksums\r\n   */\r\n  oldChecksums?: number[][];\r\n  /** After state checksums of the property value\r\n   * Useful to determine if property values have changed\r\n   * between the versions being inspected\r\n   * This may be undefined if the agent that did the processing job did not export checksums\r\n   */\r\n  newChecksums?: number[][];\r\n  /**\r\n   * Parent ids of the changed elements\r\n   * Will be \"0\" if the element has no parent\r\n   * This may be undefined if the agent that did the processing job did not export parent information\r\n   */\r\n  parentIds?: Id64String[];\r\n  /**\r\n   * Parent ECClass Ids of the changed elements\r\n   * Will be \"0\" if the element has no parent\r\n   * This may be undefined if the agent that did the processing job did not export parent information\r\n   */\r\n  parentClassIds?: Id64String[];\r\n}\r\n\r\n/** @internal */\r\nexport interface ChangedModels {\r\n  modelIds: Id64String[];\r\n  bboxes: AxisAlignedBox3dProps[];\r\n}\r\n\r\n/** @internal */\r\nexport interface ChangeData {\r\n  changedElements: ChangedElements;\r\n  changedModels: ChangedModels;\r\n}\r\n"]}
+{"version":3,"file":"ChangedElements.js","sourceRoot":"","sources":["../../src/ChangedElements.ts"],"names":[],"mappings":"AAWA,uBAAuB;AAEvB;;;GAGG;AACH,MAAM,CAAN,IAAY,YAWX;AAXD,WAAY,YAAY;IACtB,wCAAwC;IACxC,uDAAc,CAAA;IACd,oEAAoE;IACpE,uDAAe,CAAA;IACf,kEAAkE;IAClE,yDAAiB,CAAA;IACjB,qEAAqE;IACrE,uDAAiB,CAAA;IACjB,+CAA+C;IAC/C,oDAAgB,CAAA;AAClB,CAAC,EAXW,YAAY,KAAZ,YAAY,QAWvB","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/**\r\n * @packageDocumentation\r\n * @module Entities\r\n */\r\nimport { DbOpcode, Id64String } from \"@itwin/core-bentley\";\r\nimport { AxisAlignedBox3dProps } from \"./geometry/Placement\";\r\n\r\n// cspell:ignore bboxes\r\n\r\n/** Bitflags describing which aspects of an [Element]($backend) changed as part of a [[ChangedElements]].\r\n * @public\r\n * @extensions\r\n */\r\nexport enum TypeOfChange {\r\n  /** A property in the element changed */\r\n  Property = 0b1,\r\n  /** The geometry stream of a [GeometricElement]($backend) changed */\r\n  Geometry = 0b10,\r\n  /** The [[Placement]] of a [GeometricElement]($backend) changed */\r\n  Placement = 0b100,\r\n  /** Indirect change occurred to this element by a related instance */\r\n  Indirect = 0b1000,\r\n  /** Hidden properties of the element changed */\r\n  Hidden = 0b10000,\r\n}\r\n\r\n/** Changed elements found in a changeset or between a range of changesets.\r\n * All arrays in this object will have the same number of items.\r\n * Each index for those arrays refer to the same element, e.g. to get the class Id of\r\n * the element given by element Id changedElements.elements[index], you can use changedElements.classIds[index].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ChangedElements {\r\n  /** Ids of elements that changed */\r\n  elements: Id64String[];\r\n  /** ECClass Ids of elements that changed */\r\n  classIds: Id64String[];\r\n  /** Operation that occurred on the element. Whether the element was inserted, updated or deleted.\r\n   * See [DbOpcode]($core-bentley)\r\n   */\r\n  opcodes: DbOpcode[];\r\n  /** Type of change bitflags, see [[TypeOfChange]] */\r\n  type: TypeOfChange[];\r\n  /** Model Ids of the changed elements\r\n   * This may be undefined if the agent that did the processing job did not export model Ids\r\n   */\r\n  modelIds?: Id64String[];\r\n  /** Property accessor strings of properties that changed, if any, for each changed element\r\n   * This may be undefined if the agent that did the processing job did not export properties\r\n  */\r\n  properties?: string[][];\r\n  /** Before state checksums of the property value\r\n   * Useful to determine if property values have changed\r\n   * between the versions being inspected\r\n   * This may be undefined if the agent that did the processing job did not export checksums\r\n   */\r\n  oldChecksums?: number[][];\r\n  /** After state checksums of the property value\r\n   * Useful to determine if property values have changed\r\n   * between the versions being inspected\r\n   * This may be undefined if the agent that did the processing job did not export checksums\r\n   */\r\n  newChecksums?: number[][];\r\n  /**\r\n   * Parent ids of the changed elements\r\n   * Will be \"0\" if the element has no parent\r\n   * This may be undefined if the agent that did the processing job did not export parent information\r\n   */\r\n  parentIds?: Id64String[];\r\n  /**\r\n   * Parent ECClass Ids of the changed elements\r\n   * Will be \"0\" if the element has no parent\r\n   * This may be undefined if the agent that did the processing job did not export parent information\r\n   */\r\n  parentClassIds?: Id64String[];\r\n}\r\n\r\n/** @internal */\r\nexport interface ChangedModels {\r\n  modelIds: Id64String[];\r\n  bboxes: AxisAlignedBox3dProps[];\r\n}\r\n\r\n/** @internal */\r\nexport interface ChangeData {\r\n  changedElements: ChangedElements;\r\n  changedModels: ChangedModels;\r\n}\r\n"]}

package/lib/esm/ChangedEntities.d.ts

@@ -4,6 +4,7 @@
 import { CompressedId64Set, Id64String } from "@itwin/core-bentley";
 /** Describes an [Entity]($backend) and its [ECClass]($docs/bis/intro/glossary/#ecclass) by Id.
  * @public
+ * @extensions
  */
 export interface EntityIdAndClassId {
     /** The entity's Id. */
@@ -15,6 +16,7 @@ export interface EntityIdAndClassId {
  * @see [TxnManager.onElementsChanged]($backend) and [TxnManager.onModelsChanged]($backend).
  * @see [BriefcaseTxns.onElementsChanged]($frontend) and [BriefcaseTxns.onModelsChanged]($frontend).
  * @public
+ * @extensions
  */
 export interface ChangedEntities {
     /** The ids of entities that were inserted during the Txn. */
@@ -38,6 +40,7 @@ export interface ChangedEntities {
  *  }
  * ```
  * @public
+ * @extensions
  */
 export declare type EntityIdAndClassIdIterable = Iterable<Readonly<EntityIdAndClassId>>;
 //# sourceMappingURL=ChangedEntities.d.ts.map

package/lib/esm/ChangedEntities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChangedEntities.d.ts","sourceRoot":"","sources":["../../src/ChangedEntities.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,EAAE,EAAE,UAAU,CAAC;IACf,sCAAsC;IACtC,OAAO,EAAE,UAAU,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,+JAA+J;IAC/J,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,oBAAY,0BAA0B,GAAG,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"ChangedEntities.d.ts","sourceRoot":"","sources":["../../src/ChangedEntities.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,EAAE,EAAE,UAAU,CAAC;IACf,sCAAsC;IACtC,OAAO,EAAE,UAAU,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,+JAA+J;IAC/J,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,0BAA0B,GAAG,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC"}

package/lib/esm/ChangedEntities.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChangedEntities.js","sourceRoot":"","sources":["../../src/ChangedEntities.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG","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 NativeApp\r\n */\r\n\r\nimport { CompressedId64Set, Id64String } from \"@itwin/core-bentley\";\r\n\r\n/** Describes an [Entity]($backend) and its [ECClass]($docs/bis/intro/glossary/#ecclass) by Id.\r\n * @public\r\n */\r\nexport interface EntityIdAndClassId {\r\n  /** The entity's Id. */\r\n  id: Id64String;\r\n  /** The Id of the entity's ECClass. */\r\n  classId: Id64String;\r\n}\r\n\r\n/** JSON representation of the set of [Element]($backend)s or [Model]($backend)s that were changed by a [Txn]($docs/learning/InteractiveEditing.md).\r\n * @see [TxnManager.onElementsChanged]($backend) and [TxnManager.onModelsChanged]($backend).\r\n * @see [BriefcaseTxns.onElementsChanged]($frontend) and [BriefcaseTxns.onModelsChanged]($frontend).\r\n * @public\r\n */\r\nexport interface ChangedEntities {\r\n  /** The ids of entities that were inserted during the Txn. */\r\n  inserted?: CompressedId64Set;\r\n  /** The ids of entities that were deleted during the Txn. */\r\n  deleted?: CompressedId64Set;\r\n  /** The ids of entities that were modified during the Txn, including any [Element]($backend)s for which one of their [ElementAspect]($backend)s was changed. */\r\n  updated?: CompressedId64Set;\r\n}\r\n\r\n/** A collection of [[EntityIdAndClassId]]s, as used by [TxnChangedEntities]($backend).\r\n * For efficiency, the iterator supplied by this iterable returns **the same `EntityIdAndClassId` object** on each iteration. Therefore the objects must be copied if you\r\n * intend to store references to them. For example, to populate an array from the iterable:\r\n * ```ts\r\n *  function arrayFromIterable(entities: EntityIdAndClassIdIterable): EntityIdAndClassId[] {\r\n *    // NO! return Array.from(entities);\r\n *    const array = [];\r\n *    for (const entity of entities)\r\n *      array.push({...entity});\r\n *\r\n *    return array;\r\n *  }\r\n * ```\r\n * @public\r\n */\r\nexport type EntityIdAndClassIdIterable = Iterable<Readonly<EntityIdAndClassId>>;\r\n"]}
+{"version":3,"file":"ChangedEntities.js","sourceRoot":"","sources":["../../src/ChangedEntities.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG","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 NativeApp\r\n */\r\n\r\nimport { CompressedId64Set, Id64String } from \"@itwin/core-bentley\";\r\n\r\n/** Describes an [Entity]($backend) and its [ECClass]($docs/bis/intro/glossary/#ecclass) by Id.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface EntityIdAndClassId {\r\n  /** The entity's Id. */\r\n  id: Id64String;\r\n  /** The Id of the entity's ECClass. */\r\n  classId: Id64String;\r\n}\r\n\r\n/** JSON representation of the set of [Element]($backend)s or [Model]($backend)s that were changed by a [Txn]($docs/learning/InteractiveEditing.md).\r\n * @see [TxnManager.onElementsChanged]($backend) and [TxnManager.onModelsChanged]($backend).\r\n * @see [BriefcaseTxns.onElementsChanged]($frontend) and [BriefcaseTxns.onModelsChanged]($frontend).\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ChangedEntities {\r\n  /** The ids of entities that were inserted during the Txn. */\r\n  inserted?: CompressedId64Set;\r\n  /** The ids of entities that were deleted during the Txn. */\r\n  deleted?: CompressedId64Set;\r\n  /** The ids of entities that were modified during the Txn, including any [Element]($backend)s for which one of their [ElementAspect]($backend)s was changed. */\r\n  updated?: CompressedId64Set;\r\n}\r\n\r\n/** A collection of [[EntityIdAndClassId]]s, as used by [TxnChangedEntities]($backend).\r\n * For efficiency, the iterator supplied by this iterable returns **the same `EntityIdAndClassId` object** on each iteration. Therefore the objects must be copied if you\r\n * intend to store references to them. For example, to populate an array from the iterable:\r\n * ```ts\r\n *  function arrayFromIterable(entities: EntityIdAndClassIdIterable): EntityIdAndClassId[] {\r\n *    // NO! return Array.from(entities);\r\n *    const array = [];\r\n *    for (const entity of entities)\r\n *      array.push({...entity});\r\n *\r\n *    return array;\r\n *  }\r\n * ```\r\n * @public\r\n * @extensions\r\n */\r\nexport type EntityIdAndClassIdIterable = Iterable<Readonly<EntityIdAndClassId>>;\r\n"]}

package/lib/esm/ChangesetProps.d.ts

@@ -9,15 +9,18 @@ export declare type LocalDirName = string;
 /** A string that identifies a changeset.
  * @note this string is *not* a Guid. It is generated internally based on the content of the changeset.
  * @public
+ * @extensions
  */
 export declare type ChangesetId = string;
 /** The index of a changeset, assigned by iModelHub.
  * @note 0 means "before the first changeset." Values less than 0 are invalid.
  * @public
+ * @extensions
  */
 export declare type ChangesetIndex = number;
 /** Both the index and Id of a changeset
  * @public
+ * @extensions
  */
 export interface ChangesetIndexAndId {
     readonly index: ChangesetIndex;
@@ -25,6 +28,7 @@ export interface ChangesetIndexAndId {
 }
 /** The Id and optionally the index of a changeset
  * @public
+ * @extensions
  */
 export interface ChangesetIdWithIndex {
     readonly index?: ChangesetIndex;
@@ -32,6 +36,7 @@ export interface ChangesetIdWithIndex {
 }
 /** either changeset index, id, or both
 * @public
+ * @extensions
 */
 export declare type ChangesetIndexOrId = ChangesetIndexAndId | {
     readonly index: ChangesetIndex;
@@ -41,7 +46,9 @@ export declare type ChangesetIndexOrId = ChangesetIndexAndId | {
     readonly index?: never;
 };
 /** Value to indicate whether a changeset contains schema changes or not
- * @public */
+ * @public
+ * @extensions
+ */
 export declare enum ChangesetType {
     /** changeset does *not* contain schema changes. */
     Regular = 0,
@@ -81,6 +88,7 @@ export interface ChangesetFileProps extends ChangesetProps {
 /**
  * A range of changesets
  * @public
+ * @extensions
  */
 export interface ChangesetRange {
     /** index of the first changeset */

package/lib/esm/ChangesetProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChangesetProps.d.ts","sourceRoot":"","sources":["../../src/ChangesetProps.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH,cAAc;AACd,oBAAY,aAAa,GAAG,MAAM,CAAC;AACnC,cAAc;AACd,oBAAY,YAAY,GAAG,MAAM,CAAC;AAElC;;;GAGG;AACH,oBAAY,WAAW,GAAG,MAAM,CAAC;AAEjC;;;GAGG;AACH,oBAAY,cAAc,GAAG,MAAM,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAAG,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAA;CAAE;AAEjG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAA;CAAE;AAEnG;;EAEE;AACF,oBAAY,kBAAkB,GAAG,mBAAmB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEtK;aACa;AACb,oBAAY,aAAa;IACvB,mDAAmD;IACnD,OAAO,IAAI;IACX,+CAA+C;IAC/C,MAAM,IAAI;CACX;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4GAA4G;IAC5G,KAAK,EAAE,cAAc,CAAC;IACtB,sBAAsB;IACtB,EAAE,EAAE,WAAW,CAAC;IAChB,gEAAgE;IAChE,QAAQ,EAAE,WAAW,CAAC;IACtB,4BAA4B;IAC5B,WAAW,EAAE,aAAa,CAAC;IAC3B,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,kEAAkE;IAClE,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,KAAK,EAAE,cAAc,CAAC;IACtB,sFAAsF;IACtF,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB"}
+{"version":3,"file":"ChangesetProps.d.ts","sourceRoot":"","sources":["../../src/ChangesetProps.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH,cAAc;AACd,oBAAY,aAAa,GAAG,MAAM,CAAC;AACnC,cAAc;AACd,oBAAY,YAAY,GAAG,MAAM,CAAC;AAElC;;;;GAIG;AACH,oBAAY,WAAW,GAAG,MAAM,CAAC;AAEjC;;;;GAIG;AACH,oBAAY,cAAc,GAAG,MAAM,CAAC;AAEpC;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAAG,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAA;CAAE;AAEjG;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAA;CAAE;AAEnG;;;EAGE;AACF,oBAAY,kBAAkB,GAAG,mBAAmB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEtK;;;GAGG;AACH,oBAAY,aAAa;IACvB,mDAAmD;IACnD,OAAO,IAAI;IACX,+CAA+C;IAC/C,MAAM,IAAI;CACX;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4GAA4G;IAC5G,KAAK,EAAE,cAAc,CAAC;IACtB,sBAAsB;IACtB,EAAE,EAAE,WAAW,CAAC;IAChB,gEAAgE;IAChE,QAAQ,EAAE,WAAW,CAAC;IACtB,4BAA4B;IAC5B,WAAW,EAAE,aAAa,CAAC;IAC3B,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,kEAAkE;IAClE,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,KAAK,EAAE,cAAc,CAAC;IACtB,sFAAsF;IACtF,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB"}

package/lib/esm/ChangesetProps.js

@@ -7,7 +7,9 @@
  * @module iModels
  */
 /** Value to indicate whether a changeset contains schema changes or not
- * @public */
+ * @public
+ * @extensions
+ */
 export var ChangesetType;
 (function (ChangesetType) {
     /** changeset does *not* contain schema changes. */