@itwin/core-common 4.0.0-dev.8 → 4.0.0-dev.80

package/lib/esm/EntityReference.d.ts

@@ -1,52 +1,52 @@
-/** @packageDocumentation
- * @module Schema
- */
-import { Id64String } from "@itwin/core-bentley";
-/**
- * Types of concrete entities. Used for storing strings in JavaScript reference-equality containers which encode
- * low-level entity information.
- * @note the values of this enum are unstable, do not depend upon their values between versions of iTwin.js
- *       (e.g. do not serialize them and load them in another version of iTwin.js and expect them to work)
- * CodeSpecs are excepted since their JavaScript representation does not derive from [Entity]($backend)
- * @note the string value of each variant is required/guaranteed to be 1 character
- * @see EntityReference
- * @alpha
- */
-export declare enum ConcreteEntityTypes {
-    Model = "m",
-    Element = "e",
-    ElementAspect = "a",
-    Relationship = "r"
-}
-/**
- * Adds some utilities to the [[ConcreteEntityTypes]] enum
- * @alpha
- */
-export declare namespace ConcreteEntityTypes {
-    /** used by the transformer to figure out where to check for the existence in a db of a concrete element id
-     * @internal
-     */
-    function toBisCoreRootClassFullName(type: ConcreteEntityTypes): string;
-}
-/**
- * This id format can be used for storing a unique key for an entity in containers like `Map`.
- * Elements and non-element entities have different id sequences, they can collide with each other, but not within themselves.
- * @note for utilities that require runtime backend classes, see [EntityReferences]($backend)
- * @alpha
- */
-export declare type EntityReference = `${ConcreteEntityTypes}${Id64String}`;
-/** A set of concrete entity ids, with additional functions to more literately add ids where you have the raw id and know what type it is
- * @alpha
- */
-export declare class EntityReferenceSet extends Set<EntityReference> {
-    addElement(id: Id64String): void;
-    addModel(id: Id64String): void;
-    addAspect(id: Id64String): void;
-    addRelationship(id: Id64String): void;
-}
-/** @internal entity reference type information of a relationship */
-export interface RelTypeInfo {
-    source: ConcreteEntityTypes;
-    target: ConcreteEntityTypes;
-}
+/** @packageDocumentation
+ * @module Schema
+ */
+import { Id64String } from "@itwin/core-bentley";
+/**
+ * Types of concrete entities. Used for storing strings in JavaScript reference-equality containers which encode
+ * low-level entity information.
+ * @note the values of this enum are unstable, do not depend upon their values between versions of iTwin.js
+ *       (e.g. do not serialize them and load them in another version of iTwin.js and expect them to work)
+ * CodeSpecs are excepted since their JavaScript representation does not derive from [Entity]($backend)
+ * @note the string value of each variant is required/guaranteed to be 1 character
+ * @see EntityReference
+ * @alpha
+ */
+export declare enum ConcreteEntityTypes {
+    Model = "m",
+    Element = "e",
+    ElementAspect = "a",
+    Relationship = "r"
+}
+/**
+ * Adds some utilities to the [[ConcreteEntityTypes]] enum
+ * @alpha
+ */
+export declare namespace ConcreteEntityTypes {
+    /** used by the transformer to figure out where to check for the existence in a db of a concrete element id
+     * @internal
+     */
+    function toBisCoreRootClassFullName(type: ConcreteEntityTypes): string;
+}
+/**
+ * This id format can be used for storing a unique key for an entity in containers like `Map`.
+ * Elements and non-element entities have different id sequences, they can collide with each other, but not within themselves.
+ * @note for utilities that require runtime backend classes, see [EntityReferences]($backend)
+ * @alpha
+ */
+export type EntityReference = `${ConcreteEntityTypes}${Id64String}`;
+/** A set of concrete entity ids, with additional functions to more literately add ids where you have the raw id and know what type it is
+ * @alpha
+ */
+export declare class EntityReferenceSet extends Set<EntityReference> {
+    addElement(id: Id64String): void;
+    addModel(id: Id64String): void;
+    addAspect(id: Id64String): void;
+    addRelationship(id: Id64String): void;
+}
+/** @internal entity reference type information of a relationship */
+export interface RelTypeInfo {
+    source: ConcreteEntityTypes;
+    target: ConcreteEntityTypes;
+}
 //# sourceMappingURL=EntityReference.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"EntityReference.d.ts","sourceRoot":"","sources":["../../src/EntityReference.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;;;;;;;;GASG;AACH,oBAAY,mBAAmB;IAC7B,KAAK,MAAM;IACX,OAAO,MAAM;IACb,aAAa,MAAM;IACnB,YAAY,MAAM;CACnB;AAED;;;GAGG;AACH,yBAAiB,mBAAmB,CAAC;IAQnC;;OAEG;IACH,SAAgB,0BAA0B,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAE5E;CACF;AAED;;;;;GAKG;AACH,oBAAY,eAAe,GAAG,GAAG,mBAAmB,GAAG,UAAU,EAAE,CAAC;AAEpE;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,GAAG,CAAC,eAAe,CAAC;IACnD,UAAU,CAAC,EAAE,EAAE,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,UAAU;IACvB,SAAS,CAAC,EAAE,EAAE,UAAU;IACxB,eAAe,CAAC,EAAE,EAAE,UAAU;CACtC;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,mBAAmB,CAAC;CAC7B"}
+{"version":3,"file":"EntityReference.d.ts","sourceRoot":"","sources":["../../src/EntityReference.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;;;;;;;;GASG;AACH,oBAAY,mBAAmB;IAC7B,KAAK,MAAM;IACX,OAAO,MAAM;IACb,aAAa,MAAM;IACnB,YAAY,MAAM;CACnB;AAED;;;GAGG;AACH,yBAAiB,mBAAmB,CAAC;IAQnC;;OAEG;IACH,SAAgB,0BAA0B,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAE5E;CACF;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,mBAAmB,GAAG,UAAU,EAAE,CAAC;AAEpE;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,GAAG,CAAC,eAAe,CAAC;IACnD,UAAU,CAAC,EAAE,EAAE,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,UAAU;IACvB,SAAS,CAAC,EAAE,EAAE,UAAU;IACxB,eAAe,CAAC,EAAE,EAAE,UAAU;CACtC;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,mBAAmB,CAAC;CAC7B"}

package/lib/esm/EntityReference.js

@@ -1,53 +1,53 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Schema
- */
-/**
- * Types of concrete entities. Used for storing strings in JavaScript reference-equality containers which encode
- * low-level entity information.
- * @note the values of this enum are unstable, do not depend upon their values between versions of iTwin.js
- *       (e.g. do not serialize them and load them in another version of iTwin.js and expect them to work)
- * CodeSpecs are excepted since their JavaScript representation does not derive from [Entity]($backend)
- * @note the string value of each variant is required/guaranteed to be 1 character
- * @see EntityReference
- * @alpha
- */
-export var ConcreteEntityTypes;
-(function (ConcreteEntityTypes) {
-    ConcreteEntityTypes["Model"] = "m";
-    ConcreteEntityTypes["Element"] = "e";
-    ConcreteEntityTypes["ElementAspect"] = "a";
-    ConcreteEntityTypes["Relationship"] = "r";
-})(ConcreteEntityTypes || (ConcreteEntityTypes = {}));
-/**
- * Adds some utilities to the [[ConcreteEntityTypes]] enum
- * @alpha
- */
-(function (ConcreteEntityTypes) {
-    const toBisCoreRootClassFullNameMap = {
-        [ConcreteEntityTypes.Model]: "BisCore:Model",
-        [ConcreteEntityTypes.Element]: "BisCore:Element",
-        [ConcreteEntityTypes.ElementAspect]: "BisCore:ElementAspect",
-        [ConcreteEntityTypes.Relationship]: "BisCore:Relationship",
-    };
-    /** used by the transformer to figure out where to check for the existence in a db of a concrete element id
-     * @internal
-     */
-    function toBisCoreRootClassFullName(type) {
-        return toBisCoreRootClassFullNameMap[type];
-    }
-    ConcreteEntityTypes.toBisCoreRootClassFullName = toBisCoreRootClassFullName;
-})(ConcreteEntityTypes || (ConcreteEntityTypes = {}));
-/** A set of concrete entity ids, with additional functions to more literately add ids where you have the raw id and know what type it is
- * @alpha
- */
-export class EntityReferenceSet extends Set {
-    addElement(id) { this.add(`e${id}`); }
-    addModel(id) { this.add(`m${id}`); }
-    addAspect(id) { this.add(`a${id}`); }
-    addRelationship(id) { this.add(`r${id}`); }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Schema
+ */
+/**
+ * Types of concrete entities. Used for storing strings in JavaScript reference-equality containers which encode
+ * low-level entity information.
+ * @note the values of this enum are unstable, do not depend upon their values between versions of iTwin.js
+ *       (e.g. do not serialize them and load them in another version of iTwin.js and expect them to work)
+ * CodeSpecs are excepted since their JavaScript representation does not derive from [Entity]($backend)
+ * @note the string value of each variant is required/guaranteed to be 1 character
+ * @see EntityReference
+ * @alpha
+ */
+export var ConcreteEntityTypes;
+(function (ConcreteEntityTypes) {
+    ConcreteEntityTypes["Model"] = "m";
+    ConcreteEntityTypes["Element"] = "e";
+    ConcreteEntityTypes["ElementAspect"] = "a";
+    ConcreteEntityTypes["Relationship"] = "r";
+})(ConcreteEntityTypes || (ConcreteEntityTypes = {}));
+/**
+ * Adds some utilities to the [[ConcreteEntityTypes]] enum
+ * @alpha
+ */
+(function (ConcreteEntityTypes) {
+    const toBisCoreRootClassFullNameMap = {
+        [ConcreteEntityTypes.Model]: "BisCore:Model",
+        [ConcreteEntityTypes.Element]: "BisCore:Element",
+        [ConcreteEntityTypes.ElementAspect]: "BisCore:ElementAspect",
+        [ConcreteEntityTypes.Relationship]: "BisCore:Relationship",
+    };
+    /** used by the transformer to figure out where to check for the existence in a db of a concrete element id
+     * @internal
+     */
+    function toBisCoreRootClassFullName(type) {
+        return toBisCoreRootClassFullNameMap[type];
+    }
+    ConcreteEntityTypes.toBisCoreRootClassFullName = toBisCoreRootClassFullName;
+})(ConcreteEntityTypes || (ConcreteEntityTypes = {}));
+/** A set of concrete entity ids, with additional functions to more literately add ids where you have the raw id and know what type it is
+ * @alpha
+ */
+export class EntityReferenceSet extends Set {
+    addElement(id) { this.add(`e${id}`); }
+    addModel(id) { this.add(`m${id}`); }
+    addAspect(id) { this.add(`a${id}`); }
+    addRelationship(id) { this.add(`r${id}`); }
+}
 //# sourceMappingURL=EntityReference.js.map

package/lib/esm/Environment.d.ts

@@ -1,62 +1,75 @@
-/** @packageDocumentation
- * @module DisplayStyles
- */
-import { NonFunctionPropertiesOf } from "@itwin/core-bentley";
-import { GroundPlane, GroundPlaneProps } from "./GroundPlane";
-import { SkyBox, SkyBoxProps } from "./SkyBox";
-/** JSON representation of an [[Environment]].
- * @see [[DisplayStyle3dSettingsProps.environment]].
- * @public
- * @extensions
- */
-export interface EnvironmentProps {
-    /** See [[Environment.ground]] and [[Environment.displayGround]]. */
-    ground?: GroundPlaneProps;
-    /** See [[Environment.sky]] and [[Environment.displaySky]]. */
-    sky?: SkyBoxProps;
-}
-/** A type containing all of the properties of [[Environment]] with none of the methods and with the `readonly` modifiers removed.
- * @see [[Environment.create]] and [[Environment.clone]].
- * @public
- */
-export declare type EnvironmentProperties = NonFunctionPropertiesOf<Environment>;
-/** As part of a [[DisplayStyle3dSettings]], controls the display of a [[SkyBox]] and [[GroundPlane]] to simulate the
- * outdoor environment.
- * @see [[DisplayStyle3dSettings.environment]].
- * @public
- */
-export declare class Environment {
-    /** If true, the sky box will be displayed.
-     * Default: false.
-     * @see [[withDisplay]] or [[DisplayStyle3dSettings.toggleSkyBox]] to change this.
-     */
-    readonly displaySky: boolean;
-    /** If true, the ground plane will be displayed.
-     * Default: false.
-     * @see [[withDisplay]] or [[DisplayStyle3dSettings.toggleGroundPlane]] to change this.
-     */
-    readonly displayGround: boolean;
-    /** Describes how the sky box should be drawn. */
-    readonly sky: SkyBox;
-    /** Describes how the ground plane should be drawn. */
-    readonly ground: GroundPlane;
-    protected constructor(props?: Partial<EnvironmentProperties>);
-    /** Default settings with neither ground plane nor sky box displayed. */
-    static readonly defaults: Environment;
-    /** Create a new Environment. Any properties not specified by `props` will be initialized to their default values. */
-    static create(props?: Partial<EnvironmentProperties>): Environment;
-    /** Create a copy of this environment, changing the `displayGround` and/or `displaySky` flags. */
-    withDisplay(display: {
-        sky?: boolean;
-        ground?: boolean;
-    }): Environment;
-    /** Convert to JSON representation. */
-    toJSON(): EnvironmentProps;
-    /** Create from JSON representation. */
-    static fromJSON(props?: EnvironmentProps): Environment;
-    /** Create a copy of this environment, identical except for any properties specified by `changedProps`.
-     * Any properties of `changedProps` explicitly set to `undefined` will be reset to their default values.
-     */
-    clone(changedProps?: Partial<EnvironmentProperties>): Environment;
-}
+/** @packageDocumentation
+ * @module DisplayStyles
+ */
+import { NonFunctionPropertiesOf } from "@itwin/core-bentley";
+import { Atmosphere } from "./Atmosphere";
+import { GroundPlane, GroundPlaneProps } from "./GroundPlane";
+import { SkyBox, SkyBoxProps } from "./SkyBox";
+/** JSON representation of an [[Environment]].
+ * @see [[DisplayStyle3dSettingsProps.environment]].
+ * @public
+ * @extensions
+ */
+export interface EnvironmentProps {
+    /** See [[Environment.ground]] and [[Environment.displayGround]]. */
+    ground?: GroundPlaneProps;
+    /** See [[Environment.sky]] and [[Environment.displaySky]]. */
+    sky?: SkyBoxProps;
+    /** @beta See [[Environment.atmosphere]] and [[Environment.displayAtmosphere]]. */
+    atmosphere?: Atmosphere.Props;
+}
+/** A type containing all of the properties of [[Environment]] with none of the methods and with the `readonly` modifiers removed.
+ * @see [[Environment.create]] and [[Environment.clone]].
+ * @public
+ */
+export type EnvironmentProperties = NonFunctionPropertiesOf<Environment>;
+/** As part of a [[DisplayStyle3dSettings]], controls the display of a [[SkyBox]] and [[GroundPlane]] to simulate the
+ * outdoor environment.
+ * @see [[DisplayStyle3dSettings.environment]].
+ * @public
+ */
+export declare class Environment {
+    /** If true, the sky box will be displayed.
+     * Default: false.
+     * @see [[withDisplay]] or [[DisplayStyle3dSettings.toggleSkyBox]] to change this.
+     */
+    readonly displaySky: boolean;
+    /** If true, the ground plane will be displayed.
+     * Default: false.
+     * @see [[withDisplay]] or [[DisplayStyle3dSettings.toggleGroundPlane]] to change this.
+     */
+    readonly displayGround: boolean;
+    /**
+     * @beta
+     * If true, the atmosphere will be displayed. Enabling this will override any color information provided to the sky box.
+     * Default: false.
+     * @see [[withDisplay]] or [[DisplayStyle3dSettings.toggleAtmosphere]] to change this.
+     */
+    readonly displayAtmosphere: boolean;
+    /** Describes how the sky box should be drawn. */
+    readonly sky: SkyBox;
+    /** Describes how the ground plane should be drawn. */
+    readonly ground: GroundPlane;
+    /** @beta Describes how the atmosphere should be drawn */
+    readonly atmosphere: Atmosphere.Settings;
+    protected constructor(props?: Partial<EnvironmentProperties>);
+    /** Default settings without a ground plane, sky box, or atmosphere displayed. */
+    static readonly defaults: Environment;
+    /** Create a new Environment. Any properties not specified by `props` will be initialized to their default values. */
+    static create(props?: Partial<EnvironmentProperties>): Environment;
+    /** Create a copy of this environment, changing the `displayGround`, `displaySky` and/or `displayAtmosphere` flags. */
+    withDisplay(display: {
+        sky?: boolean;
+        ground?: boolean;
+        atmosphere?: boolean;
+    }): Environment;
+    /** Convert to JSON representation. */
+    toJSON(): EnvironmentProps;
+    /** Create from JSON representation. */
+    static fromJSON(props?: EnvironmentProps): Environment;
+    /** Create a copy of this environment, identical except for any properties specified by `changedProps`.
+     * Any properties of `changedProps` explicitly set to `undefined` will be reset to their default values.
+     */
+    clone(changedProps?: Partial<EnvironmentProperties>): Environment;
+}
 //# sourceMappingURL=Environment.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Environment.d.ts","sourceRoot":"","sources":["../../src/Environment.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,8DAA8D;IAC9D,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AAED;;;GAGG;AACH,oBAAY,qBAAqB,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;AAEzE;;;;GAIG;AACH,qBAAa,WAAW;IACtB;;;OAGG;IACH,SAAgB,UAAU,EAAE,OAAO,CAAC;IACpC;;;OAGG;IACH,SAAgB,aAAa,EAAE,OAAO,CAAC;IACvC,iDAAiD;IACjD,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,SAAgB,MAAM,EAAE,WAAW,CAAC;IAEpC,SAAS,aAAa,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAO5D,wEAAwE;IACxE,gBAAuB,QAAQ,cAAqB;IAEpD,qHAAqH;WACvG,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,WAAW;IAIzE,iGAAiG;IAC1F,WAAW,CAAC,OAAO,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,WAAW;IAa7E,sCAAsC;IAC/B,MAAM,IAAI,gBAAgB;IAOjC,uCAAuC;WACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,WAAW;IAY7D;;OAEG;IACI,KAAK,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,WAAW;CAMzE"}
+{"version":3,"file":"Environment.d.ts","sourceRoot":"","sources":["../../src/Environment.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,8DAA8D;IAC9D,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,kFAAkF;IAClF,UAAU,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;AAEzE;;;;GAIG;AACH,qBAAa,WAAW;IACtB;;;OAGG;IACH,SAAgB,UAAU,EAAE,OAAO,CAAC;IACpC;;;OAGG;IACH,SAAgB,aAAa,EAAE,OAAO,CAAC;IACvC;;;;;OAKG;IACH,SAAgB,iBAAiB,EAAE,OAAO,CAAC;IAE3C,iDAAiD;IACjD,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,yDAAyD;IACzD,SAAgB,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC;IAEhD,SAAS,aAAa,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAS5D,iFAAiF;IACjF,gBAAuB,QAAQ,cAAqB;IAEpD,qHAAqH;WACvG,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,WAAW;IAIzE,sHAAsH;IAC/G,WAAW,CAAC,OAAO,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,WAAW;IAenG,sCAAsC;IAC/B,MAAM,IAAI,gBAAgB;IAQjC,uCAAuC;WACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,WAAW;IAc7D;;OAEG;IACI,KAAK,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,WAAW;CAMzE"}

package/lib/esm/Environment.js

@@ -1,70 +1,76 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module DisplayStyles
- */
-import { GroundPlane } from "./GroundPlane";
-import { SkyBox } from "./SkyBox";
-/** As part of a [[DisplayStyle3dSettings]], controls the display of a [[SkyBox]] and [[GroundPlane]] to simulate the
- * outdoor environment.
- * @see [[DisplayStyle3dSettings.environment]].
- * @public
- */
-export class Environment {
-    constructor(props) {
-        var _a, _b, _c, _d;
-        this.displaySky = (_a = props === null || props === void 0 ? void 0 : props.displaySky) !== null && _a !== void 0 ? _a : false;
-        this.displayGround = (_b = props === null || props === void 0 ? void 0 : props.displayGround) !== null && _b !== void 0 ? _b : false;
-        this.sky = (_c = props === null || props === void 0 ? void 0 : props.sky) !== null && _c !== void 0 ? _c : SkyBox.defaults;
-        this.ground = (_d = props === null || props === void 0 ? void 0 : props.ground) !== null && _d !== void 0 ? _d : GroundPlane.defaults;
-    }
-    /** Create a new Environment. Any properties not specified by `props` will be initialized to their default values. */
-    static create(props) {
-        return props ? new this(props) : this.defaults;
-    }
-    /** Create a copy of this environment, changing the `displayGround` and/or `displaySky` flags. */
-    withDisplay(display) {
-        var _a, _b;
-        const displaySky = (_a = display.sky) !== null && _a !== void 0 ? _a : this.displaySky;
-        const displayGround = (_b = display.ground) !== null && _b !== void 0 ? _b : this.displayGround;
-        if (displaySky === this.displaySky && displayGround === this.displayGround)
-            return this;
-        return Environment.create({
-            ...this,
-            displaySky: displaySky !== null && displaySky !== void 0 ? displaySky : this.displaySky,
-            displayGround: displayGround !== null && displayGround !== void 0 ? displayGround : this.displayGround,
-        });
-    }
-    /** Convert to JSON representation. */
-    toJSON() {
-        return {
-            sky: this.sky.toJSON(this.displaySky),
-            ground: this.ground.toJSON(this.displayGround),
-        };
-    }
-    /** Create from JSON representation. */
-    static fromJSON(props) {
-        var _a, _b;
-        if (!props)
-            return this.defaults;
-        return new this({
-            displaySky: (_a = props === null || props === void 0 ? void 0 : props.sky) === null || _a === void 0 ? void 0 : _a.display,
-            displayGround: (_b = props === null || props === void 0 ? void 0 : props.ground) === null || _b === void 0 ? void 0 : _b.display,
-            sky: (props === null || props === void 0 ? void 0 : props.sky) ? SkyBox.fromJSON(props.sky) : undefined,
-            ground: (props === null || props === void 0 ? void 0 : props.ground) ? GroundPlane.fromJSON(props.ground) : undefined,
-        });
-    }
-    /** Create a copy of this environment, identical except for any properties specified by `changedProps`.
-     * Any properties of `changedProps` explicitly set to `undefined` will be reset to their default values.
-     */
-    clone(changedProps) {
-        if (!changedProps)
-            return this;
-        return Environment.create({ ...this, ...changedProps });
-    }
-}
-/** Default settings with neither ground plane nor sky box displayed. */
-Environment.defaults = new Environment();
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module DisplayStyles
+ */
+import { Atmosphere } from "./Atmosphere";
+import { GroundPlane } from "./GroundPlane";
+import { SkyBox } from "./SkyBox";
+/** As part of a [[DisplayStyle3dSettings]], controls the display of a [[SkyBox]] and [[GroundPlane]] to simulate the
+ * outdoor environment.
+ * @see [[DisplayStyle3dSettings.environment]].
+ * @public
+ */
+class Environment {
+    constructor(props) {
+        this.displaySky = props?.displaySky ?? false;
+        this.displayGround = props?.displayGround ?? false;
+        this.displayAtmosphere = props?.displayAtmosphere ?? false;
+        this.sky = props?.sky ?? SkyBox.defaults;
+        this.ground = props?.ground ?? GroundPlane.defaults;
+        this.atmosphere = props?.atmosphere ?? Atmosphere.Settings.defaults;
+    }
+    /** Create a new Environment. Any properties not specified by `props` will be initialized to their default values. */
+    static create(props) {
+        return props ? new this(props) : this.defaults;
+    }
+    /** Create a copy of this environment, changing the `displayGround`, `displaySky` and/or `displayAtmosphere` flags. */
+    withDisplay(display) {
+        const displaySky = display.sky ?? this.displaySky;
+        const displayGround = display.ground ?? this.displayGround;
+        const displayAtmosphere = display.atmosphere ?? this.displayAtmosphere;
+        if (displaySky === this.displaySky && displayGround === this.displayGround && displayAtmosphere === this.displayAtmosphere)
+            return this;
+        return Environment.create({
+            ...this,
+            displaySky: displaySky ?? this.displaySky,
+            displayGround: displayGround ?? this.displayGround,
+            displayAtmosphere: displayAtmosphere ?? this.displayAtmosphere,
+        });
+    }
+    /** Convert to JSON representation. */
+    toJSON() {
+        return {
+            sky: this.sky.toJSON(this.displaySky),
+            ground: this.ground.toJSON(this.displayGround),
+            atmosphere: this.atmosphere.toJSON(this.displayAtmosphere),
+        };
+    }
+    /** Create from JSON representation. */
+    static fromJSON(props) {
+        if (!props)
+            return this.defaults;
+        return new this({
+            displaySky: props?.sky?.display,
+            displayGround: props?.ground?.display,
+            displayAtmosphere: props?.atmosphere?.display,
+            sky: props?.sky ? SkyBox.fromJSON(props.sky) : undefined,
+            ground: props?.ground ? GroundPlane.fromJSON(props.ground) : undefined,
+            atmosphere: props?.atmosphere ? Atmosphere.Settings.fromJSON(props.atmosphere) : undefined,
+        });
+    }
+    /** Create a copy of this environment, identical except for any properties specified by `changedProps`.
+     * Any properties of `changedProps` explicitly set to `undefined` will be reset to their default values.
+     */
+    clone(changedProps) {
+        if (!changedProps)
+            return this;
+        return Environment.create({ ...this, ...changedProps });
+    }
+}
+/** Default settings without a ground plane, sky box, or atmosphere displayed. */
+Environment.defaults = new Environment();
+export { Environment };
 //# sourceMappingURL=Environment.js.map

package/lib/esm/Environment.js.map

@@ -1 +1 @@
-{"version":3,"file":"Environment.js","sourceRoot":"","sources":["../../src/Environment.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 { NonFunctionPropertiesOf } from \"@itwin/core-bentley\";\r\nimport { GroundPlane, GroundPlaneProps } from \"./GroundPlane\";\r\nimport { SkyBox, SkyBoxProps } from \"./SkyBox\";\r\n\r\n/** JSON representation of an [[Environment]].\r\n * @see [[DisplayStyle3dSettingsProps.environment]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface EnvironmentProps {\r\n  /** See [[Environment.ground]] and [[Environment.displayGround]]. */\r\n  ground?: GroundPlaneProps;\r\n  /** See [[Environment.sky]] and [[Environment.displaySky]]. */\r\n  sky?: SkyBoxProps;\r\n}\r\n\r\n/** A type containing all of the properties of [[Environment]] with none of the methods and with the `readonly` modifiers removed.\r\n * @see [[Environment.create]] and [[Environment.clone]].\r\n * @public\r\n */\r\nexport type EnvironmentProperties = NonFunctionPropertiesOf<Environment>;\r\n\r\n/** As part of a [[DisplayStyle3dSettings]], controls the display of a [[SkyBox]] and [[GroundPlane]] to simulate the\r\n * outdoor environment.\r\n * @see [[DisplayStyle3dSettings.environment]].\r\n * @public\r\n */\r\nexport class Environment {\r\n  /** If true, the sky box will be displayed.\r\n   * Default: false.\r\n   * @see [[withDisplay]] or [[DisplayStyle3dSettings.toggleSkyBox]] to change this.\r\n   */\r\n  public readonly displaySky: boolean;\r\n  /** If true, the ground plane will be displayed.\r\n   * Default: false.\r\n   * @see [[withDisplay]] or [[DisplayStyle3dSettings.toggleGroundPlane]] to change this.\r\n   */\r\n  public readonly displayGround: boolean;\r\n  /** Describes how the sky box should be drawn. */\r\n  public readonly sky: SkyBox;\r\n  /** Describes how the ground plane should be drawn. */\r\n  public readonly ground: GroundPlane;\r\n\r\n  protected constructor(props?: Partial<EnvironmentProperties>) {\r\n    this.displaySky = props?.displaySky ?? false;\r\n    this.displayGround = props?.displayGround ?? false;\r\n    this.sky = props?.sky ?? SkyBox.defaults;\r\n    this.ground = props?.ground ?? GroundPlane.defaults;\r\n  }\r\n\r\n  /** Default settings with neither ground plane nor sky box displayed. */\r\n  public static readonly defaults = new Environment();\r\n\r\n  /** Create a new Environment. Any properties not specified by `props` will be initialized to their default values. */\r\n  public static create(props?: Partial<EnvironmentProperties>): Environment {\r\n    return props ? new this(props) : this.defaults;\r\n  }\r\n\r\n  /** Create a copy of this environment, changing the `displayGround` and/or `displaySky` flags. */\r\n  public withDisplay(display: { sky?: boolean, ground?: boolean }): Environment {\r\n    const displaySky = display.sky ?? this.displaySky;\r\n    const displayGround = display.ground ?? this.displayGround;\r\n    if (displaySky === this.displaySky && displayGround === this.displayGround)\r\n      return this;\r\n\r\n    return Environment.create({\r\n      ...this,\r\n      displaySky: displaySky ?? this.displaySky,\r\n      displayGround: displayGround ?? this.displayGround,\r\n    });\r\n  }\r\n\r\n  /** Convert to JSON representation. */\r\n  public toJSON(): EnvironmentProps {\r\n    return {\r\n      sky: this.sky.toJSON(this.displaySky),\r\n      ground: this.ground.toJSON(this.displayGround),\r\n    };\r\n  }\r\n\r\n  /** Create from JSON representation. */\r\n  public static fromJSON(props?: EnvironmentProps): Environment {\r\n    if (!props)\r\n      return this.defaults;\r\n\r\n    return new this({\r\n      displaySky: props?.sky?.display,\r\n      displayGround: props?.ground?.display,\r\n      sky: props?.sky ? SkyBox.fromJSON(props.sky) : undefined,\r\n      ground: props?.ground ? GroundPlane.fromJSON(props.ground) : undefined,\r\n    });\r\n  }\r\n\r\n  /** Create a copy of this environment, identical except for any properties specified by `changedProps`.\r\n   * Any properties of `changedProps` explicitly set to `undefined` will be reset to their default values.\r\n   */\r\n  public clone(changedProps?: Partial<EnvironmentProperties>): Environment {\r\n    if (!changedProps)\r\n      return this;\r\n\r\n    return Environment.create({ ...this, ...changedProps });\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Environment.js","sourceRoot":"","sources":["../../src/Environment.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 { NonFunctionPropertiesOf } from \"@itwin/core-bentley\";\r\nimport { Atmosphere } from \"./Atmosphere\";\r\nimport { GroundPlane, GroundPlaneProps } from \"./GroundPlane\";\r\nimport { SkyBox, SkyBoxProps } from \"./SkyBox\";\r\n\r\n/** JSON representation of an [[Environment]].\r\n * @see [[DisplayStyle3dSettingsProps.environment]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface EnvironmentProps {\r\n  /** See [[Environment.ground]] and [[Environment.displayGround]]. */\r\n  ground?: GroundPlaneProps;\r\n  /** See [[Environment.sky]] and [[Environment.displaySky]]. */\r\n  sky?: SkyBoxProps;\r\n  /** @beta See [[Environment.atmosphere]] and [[Environment.displayAtmosphere]]. */\r\n  atmosphere?: Atmosphere.Props;\r\n}\r\n\r\n/** A type containing all of the properties of [[Environment]] with none of the methods and with the `readonly` modifiers removed.\r\n * @see [[Environment.create]] and [[Environment.clone]].\r\n * @public\r\n */\r\nexport type EnvironmentProperties = NonFunctionPropertiesOf<Environment>;\r\n\r\n/** As part of a [[DisplayStyle3dSettings]], controls the display of a [[SkyBox]] and [[GroundPlane]] to simulate the\r\n * outdoor environment.\r\n * @see [[DisplayStyle3dSettings.environment]].\r\n * @public\r\n */\r\nexport class Environment {\r\n  /** If true, the sky box will be displayed.\r\n   * Default: false.\r\n   * @see [[withDisplay]] or [[DisplayStyle3dSettings.toggleSkyBox]] to change this.\r\n   */\r\n  public readonly displaySky: boolean;\r\n  /** If true, the ground plane will be displayed.\r\n   * Default: false.\r\n   * @see [[withDisplay]] or [[DisplayStyle3dSettings.toggleGroundPlane]] to change this.\r\n   */\r\n  public readonly displayGround: boolean;\r\n  /**\r\n   * @beta\r\n   * If true, the atmosphere will be displayed. Enabling this will override any color information provided to the sky box.\r\n   * Default: false.\r\n   * @see [[withDisplay]] or [[DisplayStyle3dSettings.toggleAtmosphere]] to change this.\r\n   */\r\n  public readonly displayAtmosphere: boolean;\r\n\r\n  /** Describes how the sky box should be drawn. */\r\n  public readonly sky: SkyBox;\r\n  /** Describes how the ground plane should be drawn. */\r\n  public readonly ground: GroundPlane;\r\n  /** @beta Describes how the atmosphere should be drawn */\r\n  public readonly atmosphere: Atmosphere.Settings;\r\n\r\n  protected constructor(props?: Partial<EnvironmentProperties>) {\r\n    this.displaySky = props?.displaySky ?? false;\r\n    this.displayGround = props?.displayGround ?? false;\r\n    this.displayAtmosphere = props?.displayAtmosphere ?? false;\r\n    this.sky = props?.sky ?? SkyBox.defaults;\r\n    this.ground = props?.ground ?? GroundPlane.defaults;\r\n    this.atmosphere = props?.atmosphere ?? Atmosphere.Settings.defaults;\r\n  }\r\n\r\n  /** Default settings without a ground plane, sky box, or atmosphere displayed. */\r\n  public static readonly defaults = new Environment();\r\n\r\n  /** Create a new Environment. Any properties not specified by `props` will be initialized to their default values. */\r\n  public static create(props?: Partial<EnvironmentProperties>): Environment {\r\n    return props ? new this(props) : this.defaults;\r\n  }\r\n\r\n  /** Create a copy of this environment, changing the `displayGround`, `displaySky` and/or `displayAtmosphere` flags. */\r\n  public withDisplay(display: { sky?: boolean, ground?: boolean, atmosphere?: boolean }): Environment {\r\n    const displaySky = display.sky ?? this.displaySky;\r\n    const displayGround = display.ground ?? this.displayGround;\r\n    const displayAtmosphere = display.atmosphere ?? this.displayAtmosphere;\r\n    if (displaySky === this.displaySky && displayGround === this.displayGround && displayAtmosphere === this.displayAtmosphere)\r\n      return this;\r\n\r\n    return Environment.create({\r\n      ...this,\r\n      displaySky: displaySky ?? this.displaySky,\r\n      displayGround: displayGround ?? this.displayGround,\r\n      displayAtmosphere: displayAtmosphere ?? this.displayAtmosphere,\r\n    });\r\n  }\r\n\r\n  /** Convert to JSON representation. */\r\n  public toJSON(): EnvironmentProps {\r\n    return {\r\n      sky: this.sky.toJSON(this.displaySky),\r\n      ground: this.ground.toJSON(this.displayGround),\r\n      atmosphere: this.atmosphere.toJSON(this.displayAtmosphere),\r\n    };\r\n  }\r\n\r\n  /** Create from JSON representation. */\r\n  public static fromJSON(props?: EnvironmentProps): Environment {\r\n    if (!props)\r\n      return this.defaults;\r\n\r\n    return new this({\r\n      displaySky: props?.sky?.display,\r\n      displayGround: props?.ground?.display,\r\n      displayAtmosphere: props?.atmosphere?.display,\r\n      sky: props?.sky ? SkyBox.fromJSON(props.sky) : undefined,\r\n      ground: props?.ground ? GroundPlane.fromJSON(props.ground) : undefined,\r\n      atmosphere: props?.atmosphere ? Atmosphere.Settings.fromJSON(props.atmosphere) : undefined,\r\n    });\r\n  }\r\n\r\n  /** Create a copy of this environment, identical except for any properties specified by `changedProps`.\r\n   * Any properties of `changedProps` explicitly set to `undefined` will be reset to their default values.\r\n   */\r\n  public clone(changedProps?: Partial<EnvironmentProperties>): Environment {\r\n    if (!changedProps)\r\n      return this;\r\n\r\n    return Environment.create({ ...this, ...changedProps });\r\n  }\r\n}\r\n"]}