@itwin/core-backend 4.0.0-dev.24 → 4.0.0-dev.30

package/lib/cjs/SQLiteDb.js

@@ -65,11 +65,10 @@ class SQLiteDb {
      * @return value from operation
      */
     withOpenDb(args, operation) {
-        var _a;
         if (this.isOpen)
             throw new Error("database is already open");
         const save = () => this.closeDb(true), abandon = () => this.closeDb(false);
-        this.openDb(args.dbName, (_a = args.openMode) !== null && _a !== void 0 ? _a : core_bentley_1.OpenMode.Readonly, args.container);
+        this.openDb(args.dbName, args.openMode ?? core_bentley_1.OpenMode.Readonly, args.container);
         try {
             const result = operation();
             result instanceof Promise ? result.then(save, abandon) : save();
@@ -121,8 +120,7 @@ class SQLiteDb {
      * @returns the value returned by `callback`.
      */
     withPreparedSqliteStatement(sql, callback) {
-        var _a;
-        const stmt = (_a = this._sqliteStatementCache.findAndRemove(sql)) !== null && _a !== void 0 ? _a : this.prepareSqliteStatement(sql);
+        const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql);
         const release = () => this._sqliteStatementCache.addOrDispose(stmt);
         try {
             const val = callback(stmt);

package/lib/cjs/SQLiteDb.js.map

@@ -1 +1 @@
-{"version":3,"file":"SQLiteDb.js","sourceRoot":"","sources":["../../src/SQLiteDb.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 SQLiteDb\r\n */\r\n\r\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { DbResult, IDisposable, OpenMode } from \"@itwin/core-bentley\";\r\nimport { LocalFileName } from \"@itwin/core-common\";\r\nimport { CloudSqlite } from \"./CloudSqlite\";\r\nimport { IModelHost } from \"./IModelHost\";\r\nimport { SqliteStatement, StatementCache } from \"./SqliteStatement\";\r\n\r\n// cspell:ignore savepoint\r\n/* eslint-disable @typescript-eslint/unified-signatures */\r\n\r\n/** A SQLiteDb file\r\n * @public\r\n */\r\nexport class SQLiteDb implements IDisposable {\r\n  /** @internal */\r\n  public readonly nativeDb = new IModelHost.platform.SQLiteDb();\r\n  private _sqliteStatementCache = new StatementCache<SqliteStatement>();\r\n\r\n  /** @internal */\r\n  public static createBlobIO(): SQLiteDb.BlobIO {\r\n    return new IModelHost.platform.BlobIO();\r\n  }\r\n\r\n  /** alias for closeDb. */\r\n  public dispose(): void {\r\n    this.closeDb();\r\n  }\r\n\r\n  /** Create a SQLiteDb\r\n   * @param dbName The path to the SQLiteDb file to create.\r\n   */\r\n  public createDb(dbName: string): void;\r\n  /** @beta */\r\n  public createDb(dbName: string, container?: CloudSqlite.CloudContainer, params?: SQLiteDb.CreateParams): void;\r\n  /** @internal */\r\n  public createDb(dbName: string, container?: CloudSqlite.CloudContainer, params?: SQLiteDb.CreateParams): void {\r\n    this.nativeDb.createDb(dbName, container, params);\r\n  }\r\n\r\n  /** Open a SQLiteDb.\r\n   * @param dbName The path to the SQLiteDb file to open\r\n   */\r\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams): void;\r\n  /**\r\n   * @param container optional CloudContainer holding database\r\n   * @beta\r\n   */\r\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: CloudSqlite.CloudContainer): void;\r\n\r\n  /** @internal */\r\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: CloudSqlite.CloudContainer): void {\r\n    this.nativeDb.openDb(dbName, openMode, container);\r\n  }\r\n\r\n  /** Close SQLiteDb.\r\n   * @param saveChanges if true, call `saveChanges` before closing db. Otherwise unsaved changes are abandoned.\r\n   */\r\n  public closeDb(saveChanges?: boolean): void {\r\n    if (saveChanges && this.isOpen)\r\n      this.saveChanges();\r\n    this._sqliteStatementCache.clear();\r\n    this.nativeDb.closeDb();\r\n  }\r\n\r\n  /** Returns true if this SQLiteDb is open */\r\n  public get isOpen(): boolean { return this.nativeDb.isOpen(); }\r\n\r\n  /** Returns true if this SQLiteDb is open readonly */\r\n  public get isReadonly(): boolean { return this.nativeDb.isReadonly(); }\r\n\r\n  /**\r\n   * Open a database, perform an operation, then close the database.\r\n   *\r\n   * Details:\r\n   * - if database is open, throw an error\r\n   * - open a database\r\n   * - call a function with the database opened. If it is async, await its return.\r\n   * - if function throws, abandon all changes, close database, and rethrow\r\n   * - save all changes\r\n   * - close the database\r\n   * @return value from operation\r\n   */\r\n  public withOpenDb<T>(args: SQLiteDb.WithOpenDbArgs, operation: () => T): T {\r\n    if (this.isOpen)\r\n      throw new Error(\"database is already open\");\r\n\r\n    const save = () => this.closeDb(true), abandon = () => this.closeDb(false);\r\n    this.openDb(args.dbName, args.openMode ?? OpenMode.Readonly, args.container);\r\n    try {\r\n      const result = operation();\r\n      result instanceof Promise ? result.then(save, abandon) : save();\r\n      return result;\r\n    } catch (e) {\r\n      abandon();\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Perform an operation on a database in a CloudContainer with the write lock held.\r\n   *\r\n   * Details:\r\n   * - acquire the write lock on a CloudContainer\r\n   * - call `withOpenDb` with openMode `ReadWrite`\r\n   * - upload changes\r\n   * - release the write lock\r\n   * @param args arguments to lock the container and open the database\r\n   * @param operation an operation performed on the database with the write lock held.\r\n   * @return value from operation\r\n   * @internal\r\n   */\r\n  public async withLockedContainer<T>(args: CloudSqlite.LockAndOpenArgs, operation: () => T) {\r\n    return CloudSqlite.withWriteLock(args.user, args.container, () => this.withOpenDb({ ...args, openMode: OpenMode.ReadWrite }, operation), args.busyHandler);\r\n  }\r\n\r\n  /** vacuum this database\r\n   * @see https://www.sqlite.org/lang_vacuum.html\r\n   */\r\n  public vacuum(args?: SQLiteDb.VacuumDbArgs) {\r\n    this.nativeDb.vacuum(args);\r\n  }\r\n\r\n  /** Commit the outermost transaction, writing changes to the file. Then, restart the transaction. */\r\n  public saveChanges(): void {\r\n    this.nativeDb.saveChanges();\r\n  }\r\n\r\n  /** Abandon (cancel) the outermost transaction, discarding all changes since last save. Then, restart the transaction. */\r\n  public abandonChanges(): void {\r\n    this.nativeDb.abandonChanges();\r\n  }\r\n\r\n  /**\r\n   * Use a prepared SQL statement, potentially from the statement cache. If the requested statement doesn't exist\r\n   * in the statement cache, a new statement is prepared. After the callback completes, the statement is reset and saved\r\n   * in the statement cache so it can be reused in the future. Use this method for SQL statements that will be\r\n   * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding\r\n   * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withSqliteStatement]].\r\n   * @param sql The SQLite SQL statement to execute\r\n   * @param callback the callback to invoke on the prepared statement\r\n   * @returns the value returned by `callback`.\r\n   */\r\n  public withPreparedSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\r\n    const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql);\r\n    const release = () => this._sqliteStatementCache.addOrDispose(stmt);\r\n    try {\r\n      const val = callback(stmt);\r\n      val instanceof Promise ? val.then(release, release) : release();\r\n      return val;\r\n    } catch (err) {\r\n      release();\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Prepared and execute a callback on a SQL statement. After the callback completes the statement is disposed.\r\n   * Use this method for SQL statements are either not expected to be reused, or are not expensive to prepare.\r\n   * For statements that will be reused often, instead use [[withPreparedSqliteStatement]].\r\n   * @param sql The SQLite SQL statement to execute\r\n   * @param callback the callback to invoke on the prepared statement\r\n   * @returns the value returned by `callback`.\r\n   */\r\n  public withSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\r\n    const stmt = this.prepareSqliteStatement(sql);\r\n    const release = () => stmt.dispose();\r\n    try {\r\n      const val = callback(stmt);\r\n      val instanceof Promise ? val.then(release, release) : release();\r\n      return val;\r\n    } catch (err) {\r\n      release();\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Perform an operation on this database within a [savepoint](https://www.sqlite.org/lang_savepoint.html). If the operation completes successfully, the\r\n   * changes remain in the current transaction. If the operation throws an exception, the savepoint is rolled back\r\n   * and all changes to the database from this method are reversed, leaving the transaction exactly as it was before this method.\r\n   */\r\n  public withSavePoint(savePointName: string, operation: () => void) {\r\n    if (this.isReadonly)\r\n      throw new Error(\"database is readonly\");\r\n\r\n    this.executeSQL(`SAVEPOINT ${savePointName}`);\r\n    try {\r\n      operation();\r\n      this.executeSQL(`RELEASE ${savePointName}`);\r\n    } catch (e) {\r\n      this.executeSQL(`ROLLBACK TO ${savePointName}`);\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  /** Prepare an SQL statement.\r\n     * @param sql The SQLite SQL statement to prepare\r\n     * @param logErrors Determine if errors are logged or not\r\n     * @internal\r\n     */\r\n  public prepareSqliteStatement(sql: string, logErrors = true): SqliteStatement {\r\n    const stmt = new SqliteStatement(sql);\r\n    stmt.prepare(this.nativeDb, logErrors);\r\n    return stmt;\r\n  }\r\n\r\n  /** execute an SQL statement */\r\n  public executeSQL(sql: string): DbResult {\r\n    const stmt = this.prepareSqliteStatement(sql);\r\n    try {\r\n      return stmt.step();\r\n    } finally {\r\n      stmt.dispose();\r\n    }\r\n  }\r\n}\r\n\r\n/** @public */\r\nexport namespace SQLiteDb {\r\n  /** interface for reading and writing to a blob in a SQLiteDb\r\n   * @internal\r\n   */\r\n  export interface BlobIO {\r\n    /** Close this BlobIO if it is opened.\r\n       * @note this BlobIO *may* be reused after this call by calling `open` again.\r\n      */\r\n    close(): void;\r\n    /** get the total number of bytes in the blob */\r\n    getNumBytes(): number;\r\n    /** @return true if this BlobIO was successfully opened and may be use to read or write the blob */\r\n    isValid(): boolean;\r\n    /** Open this BlobIO against a table/row/column in a Db */\r\n    open(\r\n      /** The database for the blob */\r\n      db: IModelJsNative.AnyDb,\r\n      args: {\r\n        /** the name of the table for the blob*/\r\n        tableName: string;\r\n        /** the name of the column for the blob */\r\n        columnName: string;\r\n        /** The rowId of the blob */\r\n        row: number;\r\n        /** If true, open this BlobIO for write access */\r\n        writeable?: boolean;\r\n      }): void;\r\n    /** Read from a blob\r\n       * @returns the contents of the requested byte range\r\n       */\r\n    read(args: {\r\n      /** The number of bytes to read */\r\n      numBytes: number;\r\n      /** starting offset within the blob to read */\r\n      offset: number;\r\n      /** If present and of sufficient size, use this ArrayBuffer for the value. */\r\n      blob?: ArrayBuffer;\r\n    }): Uint8Array;\r\n    /** Reposition this BlobIO to a new rowId\r\n       * @note this BlobIO must be valid when this methods is called.\r\n       */\r\n    changeRow(row: number): void;\r\n    /** Write to a blob */\r\n    write(args: {\r\n      /** The number of bytes to write  */\r\n      numBytes: number;\r\n      /** starting offset within the blob to write */\r\n      offset: number;\r\n      /** the value to write */\r\n      blob: ArrayBuffer;\r\n    }): void;\r\n  }\r\n\r\n  /** Default transaction mode for SQLiteDbs.\r\n   * @see https://www.sqlite.org/lang_transaction.html\r\n   */\r\n  export enum DefaultTxnMode {\r\n    /** no default transaction is started. You must use BEGIN/COMMIT or SQLite will use implicit transactions */\r\n    None = 0,\r\n    /** A deferred transaction is started when the file is first opened. This is the default. */\r\n    Deferred = 1,\r\n    /** An immediate transaction is started when the file is first opened. */\r\n    Immediate = 2,\r\n    /** An exclusive transaction is started when the file is first opened. */\r\n    Exclusive = 3\r\n  }\r\n\r\n  /** parameters common to opening or creating a new SQLiteDb */\r\n  export interface OpenOrCreateParams {\r\n    /** If true, do not require that the `be_Prop` table exist */\r\n    rawSQLite?: boolean;\r\n    /** @see immutable option at https://www.sqlite.org/c3ref/open.html */\r\n    immutable?: boolean;\r\n    /** Do not attempt to verify that the file is a valid sQLite file before opening. */\r\n    skipFileCheck?: boolean;\r\n    /** the default transaction mode\r\n   * @see [[SQLiteDb.DefaultTxnMode]]\r\n  */\r\n    defaultTxn?: 0 | 1 | 2 | 3;\r\n    /** see query parameters from 'URI Filenames' in  https://www.sqlite.org/c3ref/open.html */\r\n    queryParam?: string;\r\n  }\r\n\r\n  /** Parameters for opening an existing SQLiteDb */\r\n  export interface OpenParams extends OpenOrCreateParams {\r\n    /** use OpenMode.ReadWrite to open the file with write access */\r\n    openMode: OpenMode;\r\n  }\r\n\r\n  /** Size of a SQLiteDb page in bytes */\r\n  export interface PageSize {\r\n    /** see https://www.sqlite.org/pragma.html#pragma_page_size */\r\n    pageSize?: number;\r\n  }\r\n\r\n  /** Parameters for creating a new SQLiteDb */\r\n  export type CreateParams = OpenOrCreateParams & PageSize;\r\n\r\n  /** Arguments for `SqliteDb.withOpenDb` */\r\n  export interface WithOpenDbArgs {\r\n    /** The name of the database to open */\r\n    dbName: string;\r\n    /** either an object with the open parameters or just OpenMode value. */\r\n    openMode?: OpenMode | SQLiteDb.OpenParams;\r\n    /** @internal */\r\n    container?: CloudSqlite.CloudContainer;\r\n  }\r\n\r\n  /** Arguments for `SQLiteDb.vacuum` */\r\n  export interface VacuumDbArgs extends PageSize {\r\n    /** if present, name of new file to [vacuum into](https://www.sqlite.org/lang_vacuum.html) */\r\n    into?: LocalFileName;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SQLiteDb.js","sourceRoot":"","sources":["../../src/SQLiteDb.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 SQLiteDb\r\n */\r\n\r\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { DbResult, IDisposable, OpenMode } from \"@itwin/core-bentley\";\r\nimport { LocalFileName } from \"@itwin/core-common\";\r\nimport { CloudSqlite } from \"./CloudSqlite\";\r\nimport { IModelHost } from \"./IModelHost\";\r\nimport { SqliteStatement, StatementCache } from \"./SqliteStatement\";\r\n\r\n// cspell:ignore savepoint\r\n/* eslint-disable @typescript-eslint/unified-signatures */\r\n\r\n/** A SQLiteDb file\r\n * @public\r\n */\r\nexport class SQLiteDb implements IDisposable {\r\n  /** @internal */\r\n  public readonly nativeDb = new IModelHost.platform.SQLiteDb();\r\n  private _sqliteStatementCache = new StatementCache<SqliteStatement>();\r\n\r\n  /** @internal */\r\n  public static createBlobIO(): SQLiteDb.BlobIO {\r\n    return new IModelHost.platform.BlobIO();\r\n  }\r\n\r\n  /** alias for closeDb. */\r\n  public dispose(): void {\r\n    this.closeDb();\r\n  }\r\n\r\n  /** Create a SQLiteDb\r\n   * @param dbName The path to the SQLiteDb file to create.\r\n   */\r\n  public createDb(dbName: string): void;\r\n  /** @beta */\r\n  public createDb(dbName: string, container?: CloudSqlite.CloudContainer, params?: SQLiteDb.CreateParams): void;\r\n  /** @internal */\r\n  public createDb(dbName: string, container?: CloudSqlite.CloudContainer, params?: SQLiteDb.CreateParams): void {\r\n    this.nativeDb.createDb(dbName, container, params);\r\n  }\r\n\r\n  /** Open a SQLiteDb.\r\n   * @param dbName The path to the SQLiteDb file to open\r\n   */\r\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams): void;\r\n  /**\r\n   * @param container optional CloudContainer holding database\r\n   * @beta\r\n   */\r\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: CloudSqlite.CloudContainer): void;\r\n\r\n  /** @internal */\r\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: CloudSqlite.CloudContainer): void {\r\n    this.nativeDb.openDb(dbName, openMode, container);\r\n  }\r\n\r\n  /** Close SQLiteDb.\r\n   * @param saveChanges if true, call `saveChanges` before closing db. Otherwise unsaved changes are abandoned.\r\n   */\r\n  public closeDb(saveChanges?: boolean): void {\r\n    if (saveChanges && this.isOpen)\r\n      this.saveChanges();\r\n    this._sqliteStatementCache.clear();\r\n    this.nativeDb.closeDb();\r\n  }\r\n\r\n  /** Returns true if this SQLiteDb is open */\r\n  public get isOpen(): boolean { return this.nativeDb.isOpen(); }\r\n\r\n  /** Returns true if this SQLiteDb is open readonly */\r\n  public get isReadonly(): boolean { return this.nativeDb.isReadonly(); }\r\n\r\n  /**\r\n   * Open a database, perform an operation, then close the database.\r\n   *\r\n   * Details:\r\n   * - if database is open, throw an error\r\n   * - open a database\r\n   * - call a function with the database opened. If it is async, await its return.\r\n   * - if function throws, abandon all changes, close database, and rethrow\r\n   * - save all changes\r\n   * - close the database\r\n   * @return value from operation\r\n   */\r\n  public withOpenDb<T>(args: SQLiteDb.WithOpenDbArgs, operation: () => T): T {\r\n    if (this.isOpen)\r\n      throw new Error(\"database is already open\");\r\n\r\n    const save = () => this.closeDb(true), abandon = () => this.closeDb(false);\r\n    this.openDb(args.dbName, args.openMode ?? OpenMode.Readonly, args.container);\r\n    try {\r\n      const result = operation();\r\n      result instanceof Promise ? result.then(save, abandon) : save();\r\n      return result;\r\n    } catch (e) {\r\n      abandon();\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Perform an operation on a database in a CloudContainer with the write lock held.\r\n   *\r\n   * Details:\r\n   * - acquire the write lock on a CloudContainer\r\n   * - call `withOpenDb` with openMode `ReadWrite`\r\n   * - upload changes\r\n   * - release the write lock\r\n   * @param args arguments to lock the container and open the database\r\n   * @param operation an operation performed on the database with the write lock held.\r\n   * @return value from operation\r\n   * @internal\r\n   */\r\n  public async withLockedContainer<T>(args: CloudSqlite.LockAndOpenArgs, operation: () => T) {\r\n    return CloudSqlite.withWriteLock(args.user, args.container, () => this.withOpenDb({ ...args, openMode: OpenMode.ReadWrite }, operation), args.busyHandler);\r\n  }\r\n\r\n  /** vacuum this database\r\n   * @see https://www.sqlite.org/lang_vacuum.html\r\n   */\r\n  public vacuum(args?: SQLiteDb.VacuumDbArgs) {\r\n    this.nativeDb.vacuum(args);\r\n  }\r\n\r\n  /** Commit the outermost transaction, writing changes to the file. Then, restart the transaction. */\r\n  public saveChanges(): void {\r\n    this.nativeDb.saveChanges();\r\n  }\r\n\r\n  /** Abandon (cancel) the outermost transaction, discarding all changes since last save. Then, restart the transaction. */\r\n  public abandonChanges(): void {\r\n    this.nativeDb.abandonChanges();\r\n  }\r\n\r\n  /**\r\n   * Use a prepared SQL statement, potentially from the statement cache. If the requested statement doesn't exist\r\n   * in the statement cache, a new statement is prepared. After the callback completes, the statement is reset and saved\r\n   * in the statement cache so it can be reused in the future. Use this method for SQL statements that will be\r\n   * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding\r\n   * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withSqliteStatement]].\r\n   * @param sql The SQLite SQL statement to execute\r\n   * @param callback the callback to invoke on the prepared statement\r\n   * @returns the value returned by `callback`.\r\n   */\r\n  public withPreparedSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\r\n    const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql);\r\n    const release = () => this._sqliteStatementCache.addOrDispose(stmt);\r\n    try {\r\n      const val = callback(stmt);\r\n      val instanceof Promise ? val.then(release, release) : release();\r\n      return val;\r\n    } catch (err) {\r\n      release();\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Prepared and execute a callback on a SQL statement. After the callback completes the statement is disposed.\r\n   * Use this method for SQL statements are either not expected to be reused, or are not expensive to prepare.\r\n   * For statements that will be reused often, instead use [[withPreparedSqliteStatement]].\r\n   * @param sql The SQLite SQL statement to execute\r\n   * @param callback the callback to invoke on the prepared statement\r\n   * @returns the value returned by `callback`.\r\n   */\r\n  public withSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\r\n    const stmt = this.prepareSqliteStatement(sql);\r\n    const release = () => stmt.dispose();\r\n    try {\r\n      const val = callback(stmt);\r\n      val instanceof Promise ? val.then(release, release) : release();\r\n      return val;\r\n    } catch (err) {\r\n      release();\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Perform an operation on this database within a [savepoint](https://www.sqlite.org/lang_savepoint.html). If the operation completes successfully, the\r\n   * changes remain in the current transaction. If the operation throws an exception, the savepoint is rolled back\r\n   * and all changes to the database from this method are reversed, leaving the transaction exactly as it was before this method.\r\n   */\r\n  public withSavePoint(savePointName: string, operation: () => void) {\r\n    if (this.isReadonly)\r\n      throw new Error(\"database is readonly\");\r\n\r\n    this.executeSQL(`SAVEPOINT ${savePointName}`);\r\n    try {\r\n      operation();\r\n      this.executeSQL(`RELEASE ${savePointName}`);\r\n    } catch (e) {\r\n      this.executeSQL(`ROLLBACK TO ${savePointName}`);\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  /** Prepare an SQL statement.\r\n     * @param sql The SQLite SQL statement to prepare\r\n     * @param logErrors Determine if errors are logged or not\r\n     * @internal\r\n     */\r\n  public prepareSqliteStatement(sql: string, logErrors = true): SqliteStatement {\r\n    const stmt = new SqliteStatement(sql);\r\n    stmt.prepare(this.nativeDb, logErrors);\r\n    return stmt;\r\n  }\r\n\r\n  /** execute an SQL statement */\r\n  public executeSQL(sql: string): DbResult {\r\n    const stmt = this.prepareSqliteStatement(sql);\r\n    try {\r\n      return stmt.step();\r\n    } finally {\r\n      stmt.dispose();\r\n    }\r\n  }\r\n}\r\n\r\n/** @public */\r\nexport namespace SQLiteDb {\r\n  /** interface for reading and writing to a blob in a SQLiteDb\r\n   * @internal\r\n   */\r\n  export interface BlobIO {\r\n    /** Close this BlobIO if it is opened.\r\n       * @note this BlobIO *may* be reused after this call by calling `open` again.\r\n      */\r\n    close(): void;\r\n    /** get the total number of bytes in the blob */\r\n    getNumBytes(): number;\r\n    /** @return true if this BlobIO was successfully opened and may be use to read or write the blob */\r\n    isValid(): boolean;\r\n    /** Open this BlobIO against a table/row/column in a Db */\r\n    open(\r\n      /** The database for the blob */\r\n      db: IModelJsNative.AnyDb,\r\n      args: {\r\n        /** the name of the table for the blob*/\r\n        tableName: string;\r\n        /** the name of the column for the blob */\r\n        columnName: string;\r\n        /** The rowId of the blob */\r\n        row: number;\r\n        /** If true, open this BlobIO for write access */\r\n        writeable?: boolean;\r\n      }): void;\r\n    /** Read from a blob\r\n       * @returns the contents of the requested byte range\r\n       */\r\n    read(args: {\r\n      /** The number of bytes to read */\r\n      numBytes: number;\r\n      /** starting offset within the blob to read */\r\n      offset: number;\r\n      /** If present and of sufficient size, use this ArrayBuffer for the value. */\r\n      blob?: ArrayBuffer;\r\n    }): Uint8Array;\r\n    /** Reposition this BlobIO to a new rowId\r\n       * @note this BlobIO must be valid when this methods is called.\r\n       */\r\n    changeRow(row: number): void;\r\n    /** Write to a blob */\r\n    write(args: {\r\n      /** The number of bytes to write  */\r\n      numBytes: number;\r\n      /** starting offset within the blob to write */\r\n      offset: number;\r\n      /** the value to write */\r\n      blob: ArrayBuffer;\r\n    }): void;\r\n  }\r\n\r\n  /** Default transaction mode for SQLiteDbs.\r\n   * @see https://www.sqlite.org/lang_transaction.html\r\n   */\r\n  export enum DefaultTxnMode {\r\n    /** no default transaction is started. You must use BEGIN/COMMIT or SQLite will use implicit transactions */\r\n    None = 0,\r\n    /** A deferred transaction is started when the file is first opened. This is the default. */\r\n    Deferred = 1,\r\n    /** An immediate transaction is started when the file is first opened. */\r\n    Immediate = 2,\r\n    /** An exclusive transaction is started when the file is first opened. */\r\n    Exclusive = 3\r\n  }\r\n\r\n  /** parameters common to opening or creating a new SQLiteDb */\r\n  export interface OpenOrCreateParams {\r\n    /** If true, do not require that the `be_Prop` table exist */\r\n    rawSQLite?: boolean;\r\n    /** @see immutable option at https://www.sqlite.org/c3ref/open.html */\r\n    immutable?: boolean;\r\n    /** Do not attempt to verify that the file is a valid sQLite file before opening. */\r\n    skipFileCheck?: boolean;\r\n    /** the default transaction mode\r\n   * @see [[SQLiteDb.DefaultTxnMode]]\r\n  */\r\n    defaultTxn?: 0 | 1 | 2 | 3;\r\n    /** see query parameters from 'URI Filenames' in  https://www.sqlite.org/c3ref/open.html */\r\n    queryParam?: string;\r\n  }\r\n\r\n  /** Parameters for opening an existing SQLiteDb */\r\n  export interface OpenParams extends OpenOrCreateParams {\r\n    /** use OpenMode.ReadWrite to open the file with write access */\r\n    openMode: OpenMode;\r\n  }\r\n\r\n  /** Size of a SQLiteDb page in bytes */\r\n  export interface PageSize {\r\n    /** see https://www.sqlite.org/pragma.html#pragma_page_size */\r\n    pageSize?: number;\r\n  }\r\n\r\n  /** Parameters for creating a new SQLiteDb */\r\n  export type CreateParams = OpenOrCreateParams & PageSize;\r\n\r\n  /** Arguments for `SqliteDb.withOpenDb` */\r\n  export interface WithOpenDbArgs {\r\n    /** The name of the database to open */\r\n    dbName: string;\r\n    /** either an object with the open parameters or just OpenMode value. */\r\n    openMode?: OpenMode | SQLiteDb.OpenParams;\r\n    /** @internal */\r\n    container?: CloudSqlite.CloudContainer;\r\n  }\r\n\r\n  /** Arguments for `SQLiteDb.vacuum` */\r\n  export interface VacuumDbArgs extends PageSize {\r\n    /** if present, name of new file to [vacuum into](https://www.sqlite.org/lang_vacuum.html) */\r\n    into?: LocalFileName;\r\n  }\r\n}\r\n"]}

package/lib/cjs/TileStorage.js

@@ -55,13 +55,10 @@ class TileStorage {
     }
     async getCachedTiles(iModelId, _prefix) {
         return (await this.storage.listObjects({ baseDirectory: iModelId }))
-            .map((objectReference) => {
-            var _a, _b;
-            return ({
-                parts: (_b = (_a = objectReference.relativeDirectory) === null || _a === void 0 ? void 0 : _a.split("/")) !== null && _b !== void 0 ? _b : [""],
-                objectName: objectReference.objectName,
-            });
-        })
+            .map((objectReference) => ({
+            parts: objectReference.relativeDirectory?.split("/") ?? [""],
+            objectName: objectReference.objectName,
+        }))
             .filter(({ parts, objectName }) => {
             if (parts[0] !== "tiles")
                 return false;

package/lib/cjs/TileStorage.js.map

@@ -1 +1 @@
-{"version":3,"file":"TileStorage.js","sourceRoot":"","sources":["../../src/TileStorage.ts"],"names":[],"mappings":";;;AAAA;;;+FAG+F;AAC/F,+BAAoC;AACpC,+BAAiC;AAEjC,oDAA4D;AAC5D,sDAA6C;AAC7C,mEAAgE;AAChE,6CAA0C;AAE1C,YAAY;AACZ,MAAa,WAAW;IACtB,YAAmC,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;QAEjD,wBAAmB,GAAgB,IAAI,GAAG,EAAE,CAAC;IAFQ,CAAC;IAIvD,KAAK,CAAC,UAAU,CAAC,QAAgB;QACtC,IAAI,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC;YACxC,OAAO;QACT,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE;YAC1E,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC;SACrE;QACD,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAEM,KAAK,CAAC,iBAAiB,CAAC,QAAgB,EAAE,gBAAyB;QACxE,IAAI;YACF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,gBAAgB,CAAC,CAAC;SAC5F;QAAC,OAAO,GAAG,EAAE;YACZ,IAAI,CAAC,YAAY,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;YACxD,MAAM,GAAG,CAAC;SACX;IACH,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,WAAmB,EAAE,MAAc,EAAE,SAAiB,EAAE,OAAmB,EAAE,IAAa,EAAE,QAAmB;QACvJ,IAAI;YACF,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CACvB,IAAA,oCAAsB,EAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,EACtE,MAAM,CAAC,IAAI,CAAC,uBAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,IAAA,gBAAS,EAAC,WAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EACpG,QAAQ,EACR,uBAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CACzE,CAAC;SACH;QAAC,OAAO,GAAG,EAAE;YACZ,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;YAChD,MAAM,GAAG,CAAC;SACX;IACH,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,WAAmB,EAAE,MAAc,EAAE,SAAiB,EAAE,IAAa;QAC/G,IAAI;YACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CACxC,IAAA,oCAAsB,EAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,EACtE,QAAQ,CACT,CAAC;YACF,OAAO,uBAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,IAAA,gBAAS,EAAC,aAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;SAClF;QAAC,OAAO,GAAG,EAAE;YACZ,IAAI,CAAC,YAAY,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;YAClD,MAAM,GAAG,CAAC;SACX;IACH,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,OAAe;QAC3D,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC;aACjE,GAAG,CAAC,CAAC,eAAe,EAAE,EAAE;;YAAC,OAAA,CAAC;gBACzB,KAAK,EAAE,MAAA,MAAA,eAAe,CAAC,iBAAiB,0CAAE,KAAK,CAAC,GAAG,CAAC,mCAAI,CAAC,EAAE,CAAC;gBAC5D,UAAU,EAAE,eAAe,CAAC,UAAU;aACvC,CAAC,CAAA;SAAA,CAAC;aACF,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE;YAChC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO;gBACtB,OAAO,KAAK,CAAC;YACf,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;gBACtB,qBAAM,CAAC,UAAU,CAAC,6CAAqB,CAAC,iBAAiB,EAAE,iDAAiD,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC5J,OAAO,KAAK,CAAC;aACd;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE;YAC/B,4CAA4C;YAC5C,2BAA2B;YAC3B,OAAO;gBACL,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;gBAChB,SAAS,EAAE,UAAU;gBACrB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;aACf,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,WAAmB,EAAE,MAAc,EAAE,SAAiB,EAAE,IAAa;QAC/G,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAA,oCAAsB,EAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3G,CAAC;IAEO,YAAY,CAAC,OAAe,EAAE,GAAY;QAChD,qBAAM,CAAC,YAAY,CACjB,6CAAqB,CAAC,iBAAiB,EACvC,GAAG,EACH,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,CAAC,qBAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,OAAO,kBAAkB,EAAE,EAAE,GAAG,aAAa,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CACnI,CAAC;IACJ,CAAC;CACF;AAtFD,kCAsFC","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\nimport { gunzip, gzip } from \"zlib\";\r\nimport { promisify } from \"util\";\r\nimport { Metadata, ServerStorage, TransferConfig } from \"@itwin/object-storage-core\";\r\nimport { getTileObjectReference } from \"@itwin/core-common\";\r\nimport { Logger } from \"@itwin/core-bentley\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\nimport { IModelHost } from \"./IModelHost\";\r\n\r\n/** @beta */\r\nexport class TileStorage {\r\n  public constructor(public readonly storage: ServerStorage) { }\r\n\r\n  private _initializedIModels: Set<string> = new Set();\r\n\r\n  public async initialize(iModelId: string): Promise<void> {\r\n    if (this._initializedIModels.has(iModelId))\r\n      return;\r\n    if (!(await this.storage.baseDirectoryExists({ baseDirectory: iModelId }))) {\r\n      await this.storage.createBaseDirectory({ baseDirectory: iModelId });\r\n    }\r\n    this._initializedIModels.add(iModelId);\r\n  }\r\n\r\n  public async getDownloadConfig(iModelId: string, expiresInSeconds?: number): Promise<TransferConfig> {\r\n    try {\r\n      return await this.storage.getDownloadConfig({ baseDirectory: iModelId }, expiresInSeconds);\r\n    } catch (err) {\r\n      this.logException(\"Failed to get download config\", err);\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  public async uploadTile(iModelId: string, changesetId: string, treeId: string, contentId: string, content: Uint8Array, guid?: string, metadata?: Metadata): Promise<void> {\r\n    try {\r\n      await this.storage.upload(\r\n        getTileObjectReference(iModelId, changesetId, treeId, contentId, guid),\r\n        Buffer.from(IModelHost.compressCachedTiles ? await promisify(gzip)(content.buffer) : content.buffer),\r\n        metadata,\r\n        IModelHost.compressCachedTiles ? { contentEncoding: \"gzip\" } : undefined,\r\n      );\r\n    } catch (err) {\r\n      this.logException(\"Failed to upload tile\", err);\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  public async downloadTile(iModelId: string, changesetId: string, treeId: string, contentId: string, guid?: string): Promise<Uint8Array> {\r\n    try {\r\n      const buffer = await this.storage.download(\r\n        getTileObjectReference(iModelId, changesetId, treeId, contentId, guid),\r\n        \"buffer\"\r\n      );\r\n      return IModelHost.compressCachedTiles ? await promisify(gunzip)(buffer) : buffer;\r\n    } catch (err) {\r\n      this.logException(\"Failed to download tile\", err);\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  public async getCachedTiles(iModelId: string, _prefix: string): Promise<{ treeId: string, contentId: string, guid?: string }[]> {\r\n    return (await this.storage.listObjects({ baseDirectory: iModelId }))\r\n      .map((objectReference) => ({\r\n        parts: objectReference.relativeDirectory?.split(\"/\") ?? [\"\"],\r\n        objectName: objectReference.objectName,\r\n      }))\r\n      .filter(({ parts, objectName }) => {\r\n        if (parts[0] !== \"tiles\")\r\n          return false;\r\n        if (parts.length !== 3) {\r\n          Logger.logWarning(BackendLoggerCategory.IModelTileStorage, \"Malformed tile id found in tile cache: {tileId}\", { tileId: [...parts, objectName].join(\"/\") });\r\n          return false;\r\n        }\r\n        return true;\r\n      }).map(({ parts, objectName }) => {\r\n        // relativeDirectory = tiles/<treeId>/<guid>\r\n        // objectName = <contentId>\r\n        return {\r\n          treeId: parts[1],\r\n          contentId: objectName,\r\n          guid: parts[2],\r\n        };\r\n      });\r\n  }\r\n\r\n  public async isTileCached(iModelId: string, changesetId: string, treeId: string, contentId: string, guid?: string): Promise<boolean> {\r\n    return this.storage.objectExists(getTileObjectReference(iModelId, changesetId, treeId, contentId, guid));\r\n  }\r\n\r\n  private logException(message: string, err: unknown): void {\r\n    Logger.logException(\r\n      BackendLoggerCategory.IModelTileStorage,\r\n      err,\r\n      (category, msg, errorMetadata) => Logger.logError(category, `${message}: {errorMessage}`, { ...errorMetadata, errorMessage: msg })\r\n    );\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"TileStorage.js","sourceRoot":"","sources":["../../src/TileStorage.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\nimport { gunzip, gzip } from \"zlib\";\r\nimport { promisify } from \"util\";\r\nimport { Metadata, ServerStorage, TransferConfig } from \"@itwin/object-storage-core\";\r\nimport { getTileObjectReference } from \"@itwin/core-common\";\r\nimport { Logger } from \"@itwin/core-bentley\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\nimport { IModelHost } from \"./IModelHost\";\r\n\r\n/** @beta */\r\nexport class TileStorage {\r\n  public constructor(public readonly storage: ServerStorage) { }\r\n\r\n  private _initializedIModels: Set<string> = new Set();\r\n\r\n  public async initialize(iModelId: string): Promise<void> {\r\n    if (this._initializedIModels.has(iModelId))\r\n      return;\r\n    if (!(await this.storage.baseDirectoryExists({ baseDirectory: iModelId }))) {\r\n      await this.storage.createBaseDirectory({ baseDirectory: iModelId });\r\n    }\r\n    this._initializedIModels.add(iModelId);\r\n  }\r\n\r\n  public async getDownloadConfig(iModelId: string, expiresInSeconds?: number): Promise<TransferConfig> {\r\n    try {\r\n      return await this.storage.getDownloadConfig({ baseDirectory: iModelId }, expiresInSeconds);\r\n    } catch (err) {\r\n      this.logException(\"Failed to get download config\", err);\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  public async uploadTile(iModelId: string, changesetId: string, treeId: string, contentId: string, content: Uint8Array, guid?: string, metadata?: Metadata): Promise<void> {\r\n    try {\r\n      await this.storage.upload(\r\n        getTileObjectReference(iModelId, changesetId, treeId, contentId, guid),\r\n        Buffer.from(IModelHost.compressCachedTiles ? await promisify(gzip)(content.buffer) : content.buffer),\r\n        metadata,\r\n        IModelHost.compressCachedTiles ? { contentEncoding: \"gzip\" } : undefined,\r\n      );\r\n    } catch (err) {\r\n      this.logException(\"Failed to upload tile\", err);\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  public async downloadTile(iModelId: string, changesetId: string, treeId: string, contentId: string, guid?: string): Promise<Uint8Array> {\r\n    try {\r\n      const buffer = await this.storage.download(\r\n        getTileObjectReference(iModelId, changesetId, treeId, contentId, guid),\r\n        \"buffer\"\r\n      );\r\n      return IModelHost.compressCachedTiles ? await promisify(gunzip)(buffer) : buffer;\r\n    } catch (err) {\r\n      this.logException(\"Failed to download tile\", err);\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  public async getCachedTiles(iModelId: string, _prefix: string): Promise<{ treeId: string, contentId: string, guid?: string }[]> {\r\n    return (await this.storage.listObjects({ baseDirectory: iModelId }))\r\n      .map((objectReference) => ({\r\n        parts: objectReference.relativeDirectory?.split(\"/\") ?? [\"\"],\r\n        objectName: objectReference.objectName,\r\n      }))\r\n      .filter(({ parts, objectName }) => {\r\n        if (parts[0] !== \"tiles\")\r\n          return false;\r\n        if (parts.length !== 3) {\r\n          Logger.logWarning(BackendLoggerCategory.IModelTileStorage, \"Malformed tile id found in tile cache: {tileId}\", { tileId: [...parts, objectName].join(\"/\") });\r\n          return false;\r\n        }\r\n        return true;\r\n      }).map(({ parts, objectName }) => {\r\n        // relativeDirectory = tiles/<treeId>/<guid>\r\n        // objectName = <contentId>\r\n        return {\r\n          treeId: parts[1],\r\n          contentId: objectName,\r\n          guid: parts[2],\r\n        };\r\n      });\r\n  }\r\n\r\n  public async isTileCached(iModelId: string, changesetId: string, treeId: string, contentId: string, guid?: string): Promise<boolean> {\r\n    return this.storage.objectExists(getTileObjectReference(iModelId, changesetId, treeId, contentId, guid));\r\n  }\r\n\r\n  private logException(message: string, err: unknown): void {\r\n    Logger.logException(\r\n      BackendLoggerCategory.IModelTileStorage,\r\n      err,\r\n      (category, msg, errorMetadata) => Logger.logError(category, `${message}: {errorMessage}`, { ...errorMetadata, errorMessage: msg })\r\n    );\r\n  }\r\n}\r\n"]}

package/lib/cjs/ViewDefinition.d.ts

@@ -199,7 +199,9 @@ export declare class SpatialViewDefinition extends ViewDefinition3d {
     modelSelectorId: Id64String;
     /** @internal */
     constructor(props: SpatialViewDefinitionProps, iModel: IModelDb);
-    /** @internal */
+    /** Construct a SpatialViewDefinition from its JSON representation. */
+    static fromJSON(props: Omit<SpatialViewDefinitionProps, "classFullName">, iModel: IModelDb): SpatialViewDefinition;
+    /** Convert this view to its JSON representation. */
     toJSON(): SpatialViewDefinitionProps;
     /** @internal */
     protected collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void;
@@ -210,7 +212,7 @@ export declare class SpatialViewDefinition extends ViewDefinition3d {
     /** Load this view's ModelSelector from the IModelDb. */
     loadModelSelector(): ModelSelector;
     /**
-     * Create an SpatialViewDefinition with camera.
+     * Create a SpatialViewDefinition with the camera turned on.
      * @param iModelDb The iModel
      * @param definitionModelId The [[DefinitionModel]]
      * @param name The name/CodeValue of the view
@@ -220,22 +222,14 @@ export declare class SpatialViewDefinition extends ViewDefinition3d {
      * @param range Defines the view origin and extents
      * @param standardView Optionally defines the view's rotation
      * @param cameraAngle Camera angle in radians.
-     * @returns The newly constructed OrthographicViewDefinition element
+     * @returns The newly constructed SpatialViewDefinition element
      * @throws [[IModelError]] if there is a problem creating the view
      */
     static createWithCamera(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView?: StandardViewIndex, cameraAngle?: number): SpatialViewDefinition;
     /**
-     * Insert an SpatialViewDefinition with camera On
-     * @param iModelDb Insert into this iModel
-     * @param definitionModelId Insert the new OrthographicViewDefinition into this DefinitionModel
-     * @param name The name/CodeValue of the view
-     * @param modelSelectorId The [[ModelSelector]] that this view should use
-     * @param categorySelectorId The [[CategorySelector]] that this view should use
-     * @param displayStyleId The [[DisplayStyle3d]] that this view should use
-     * @param range Defines the view origin and extents
-     * @param standardView Optionally defines the view's rotation
-     * @param cameraAngle Camera angle in radians.
-     * @returns The Id of the newly inserted OrthographicViewDefinition element
+     * Insert an SpatialViewDefinition with the camera turned on.
+     * @see [[createWithCamera]] for details.
+     * @returns The Id of the newly inserted SpatialViewDefinition element
      * @throws [[IModelError]] if there is an insert problem.
      */
     static insertWithCamera(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView?: StandardViewIndex, cameraAngle?: number): Id64String;

package/lib/cjs/ViewDefinition.d.ts.map

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

package/lib/cjs/ViewDefinition.js

@@ -297,7 +297,11 @@ class SpatialViewDefinition extends (_d = ViewDefinition3d) {
     }
     /** @internal */
     static get className() { return "SpatialViewDefinition"; }
-    /** @internal */
+    /** Construct a SpatialViewDefinition from its JSON representation. */
+    static fromJSON(props, iModel) {
+        return new SpatialViewDefinition({ ...props, classFullName: this.classFullName }, iModel);
+    }
+    /** Convert this view to its JSON representation. */
     toJSON() {
         const json = super.toJSON();
         json.modelSelectorId = this.modelSelectorId;
@@ -311,7 +315,7 @@ class SpatialViewDefinition extends (_d = ViewDefinition3d) {
     /** Load this view's ModelSelector from the IModelDb. */
     loadModelSelector() { return this.iModel.elements.getElement(this.modelSelectorId); }
     /**
-     * Create an SpatialViewDefinition with camera.
+     * Create a SpatialViewDefinition with the camera turned on.
      * @param iModelDb The iModel
      * @param definitionModelId The [[DefinitionModel]]
      * @param name The name/CodeValue of the view
@@ -321,7 +325,7 @@ class SpatialViewDefinition extends (_d = ViewDefinition3d) {
      * @param range Defines the view origin and extents
      * @param standardView Optionally defines the view's rotation
      * @param cameraAngle Camera angle in radians.
-     * @returns The newly constructed OrthographicViewDefinition element
+     * @returns The newly constructed SpatialViewDefinition element
      * @throws [[IModelError]] if there is a problem creating the view
      */
     static createWithCamera(iModelDb, definitionModelId, name, modelSelectorId, categorySelectorId, displayStyleId, range, standardView = core_geometry_1.StandardViewIndex.Iso, cameraAngle = core_geometry_1.Angle.piOver2Radians) {
@@ -349,17 +353,9 @@ class SpatialViewDefinition extends (_d = ViewDefinition3d) {
         return new SpatialViewDefinition(viewDefinitionProps, iModelDb);
     }
     /**
-     * Insert an SpatialViewDefinition with camera On
-     * @param iModelDb Insert into this iModel
-     * @param definitionModelId Insert the new OrthographicViewDefinition into this DefinitionModel
-     * @param name The name/CodeValue of the view
-     * @param modelSelectorId The [[ModelSelector]] that this view should use
-     * @param categorySelectorId The [[CategorySelector]] that this view should use
-     * @param displayStyleId The [[DisplayStyle3d]] that this view should use
-     * @param range Defines the view origin and extents
-     * @param standardView Optionally defines the view's rotation
-     * @param cameraAngle Camera angle in radians.
-     * @returns The Id of the newly inserted OrthographicViewDefinition element
+     * Insert an SpatialViewDefinition with the camera turned on.
+     * @see [[createWithCamera]] for details.
+     * @returns The Id of the newly inserted SpatialViewDefinition element
      * @throws [[IModelError]] if there is an insert problem.
      */
     static insertWithCamera(iModelDb, definitionModelId, name, modelSelectorId, categorySelectorId, displayStyleId, range, standardView = core_geometry_1.StandardViewIndex.Iso, cameraAngle = core_geometry_1.Angle.piOver2Radians) {

package/lib/cjs/ViewDefinition.js.map

@@ -1 +1 @@
-{"version":3,"file":"ViewDefinition.js","sourceRoot":"","sources":["../../src/ViewDefinition.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;;AAEH,sDAA2F;AAC3F,wDAE8B;AAC9B,oDAK4B;AAC5B,uCAA0F;AAK1F;;;;GAIG;AACH,MAAa,aAAc,SAAQ,2BAAiB;IAMlD,gBAAgB;IAChB,YAAY,KAAyB,EAAE,MAAgB;QACrD,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IATD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,eAAe,CAAC,CAAC,CAAC;IAU1E,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAAwB,CAAC;QACjD,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,gBAAgB;IACG,2BAA2B,CAAC,YAAgC;QAC7E,KAAK,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAmB,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/E,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,SAAiB;QACxF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,aAAa,CAAC,CAAC;QACjF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,MAAiB;QACrG,MAAM,kBAAkB,GAAuB;YAC7C,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,KAAK,EAAE,iBAAiB;YACxB,MAAM;YACN,SAAS,EAAE,KAAK;SACjB,CAAC;QACF,OAAO,IAAI,aAAa,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC;IACD;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,MAAiB;QACrG,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7E,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;CACF;AAnED,sCAmEC;AAED;;;;GAIG;AACH,MAAa,gBAAiB,SAAQ,2BAAiB;IAKrD,gBAAgB;IAChB,YAAY,KAA4B,EAAE,MAAgB;QACxD,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACrC,CAAC;IARD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAS7E,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAA2B,CAAC;QACpD,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACjC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,gBAAgB;IACG,2BAA2B,CAAC,YAAgC;QAC7E,KAAK,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,UAAsB,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,SAAiB;QACxF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,gBAAgB,CAAC,CAAC;QACpF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,UAAqB;QACzG,MAAM,qBAAqB,GAA0B;YACnD,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,KAAK,EAAE,iBAAiB;YACxB,UAAU;YACV,SAAS,EAAE,KAAK;SACjB,CAAC;QACF,OAAO,IAAI,gBAAgB,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,UAAqB;QACzG,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACpF,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;CACF;AAnED,4CAmEC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAsB,cAAe,SAAQ,MAAA,2BAAiB,CAAA;IAQ5D,gBAAgB;IAChB,YAAsB,KAA0B,EAAE,MAAgB;QAChE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAErB,IAAI,CAAC,kBAAkB,GAAG,mBAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAClE,IAAI,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC;YACxC,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,MAAM,EAAE,+BAA+B,CAAC,CAAC;QAE9E,IAAI,CAAC,cAAc,GAAG,mBAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC1D,IAAI,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC;YACpC,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IAC5E,CAAC;IAlBD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,gBAAgB,CAAC,CAAC,CAAC;IAmB3E,gBAAgB;IACA,MAAM;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAyB,CAAC;QACnD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC;QAClD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gBAAgB;IACG,2BAA2B,CAAC,YAAgC;QAC7E,KAAK,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAChD,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjD,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAe,IAAI,CAAC,8BAA8B,EAAE,CAAC;QAChE,IAAI,mBAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;YAC3B,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;SAChC;IACH,CAAC;IAWD,gBAAgB;IACN,MAAM,CAAU,QAAQ,CAAC,OAAkC,EAAE,kBAAuC,EAAE,kBAAuC;QACrJ,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QAChE,IAAI,OAAO,CAAC,gBAAgB,IAAI,kBAAkB,CAAC,cAAc,IAAI,kBAAkB,CAAC,cAAc,CAAC,WAAW,EAAE;YAClH,MAAM,KAAK,GAAe,mBAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC3F,IAAI,mBAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;gBAC3B,kBAAkB,CAAC,cAAc,CAAC,WAAW,CAAC,GAAG,GAAG,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;aACxF;SACF;IACH,CAAC;IAED,oDAAoD;IAC7C,QAAQ,KAA+B,OAAO,IAAI,YAAY,gBAAgB,CAAC,CAAC,CAAC;IACxF,mDAAmD;IAC5C,QAAQ,KAA+B,OAAO,IAAI,YAAY,gBAAgB,CAAC,CAAC,CAAC;IACxF,wDAAwD;IACjD,aAAa,KAAoC,OAAO,IAAI,YAAY,qBAAqB,CAAC,CAAC,CAAC;IACvG,wDAAwD;IACjD,aAAa,KAAoC,OAAO,IAAI,YAAY,qBAAqB,CAAC,CAAC,CAAC;IAEvG,uDAAuD;IAChD,gBAAgB,KAAmB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAe,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAEtH,2DAA2D;IACpD,oBAAoB,KAAuB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAmB,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAKtI,8GAA8G;IACvG,8BAA8B;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC;IAClD,CAAC;IAED;;OAEG;IACI,8BAA8B,CAAC,KAAiB;QACrD,IAAI,CAAC,OAAO,CAAC,2BAA2B,GAAG,KAAK,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,SAAiB;QACxF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,cAAc,CAAC,CAAC;QAClF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;;AAlGH,wCAmGC;;AA3DC,YAAY;AACoB,oCAAqB,GAA0B,CAAC,GAAG,4CAA2B,EAAE,oBAAoB,EAAE,gBAAgB,CAAE,CAAA;AACxJ,aAAa;AACmB,0CAA2B,GAAwC;IACjG,GAAG,kDAAiC;IACpC,kBAAkB,EAAE,iCAAmB,CAAC,OAAO;IAC/C,cAAc,EAAE,iCAAmB,CAAC,OAAO;CAC3C,CAAA;AAsDJ;;GAEG;AACH,MAAsB,gBAAiB,SAAQ,cAAc;IAe3D,gBAAgB;IAChB,YAAmB,KAA4B,EAAE,MAAgB;QAC/D,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,wBAAS,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,uBAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,wBAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,kCAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,IAAI,oBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,2BAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzD,CAAC;IAtBD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAuB7E,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAA2B,CAAC;QACpD,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC7B,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3B,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,iEAAiE;IACjE,IAAW,OAAO,KAAoB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE7D,yDAAyD;IAClD,kBAAkB,KAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAiB,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;CAC7H;AA1CD,4CA0CC;AAED;;;;;;;;;;;GAWG;AACH,MAAa,qBAAsB,SAAQ,MAAA,gBAAgB,CAAA;IAMzD,gBAAgB;IAChB,YAAY,KAAiC,EAAE,MAAgB;QAC7D,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,eAAe,GAAG,mBAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC5D,IAAI,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC;YACrC,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IAC7E,CAAC;IAXD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,uBAAuB,CAAC,CAAC,CAAC;IAYlF,gBAAgB;IACA,MAAM;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAgC,CAAC;QAC1D,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gBAAgB;IACG,2BAA2B,CAAC,YAAgC;QAC7E,KAAK,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAChD,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC;IAUD,wDAAwD;IACjD,iBAAiB,KAAoB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAgB,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC1H;;;;;;;;;;;;;OAaG;IACI,MAAM,CAAC,gBAAgB,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,eAA2B,EAAE,kBAA8B,EAAE,cAA0B,EAAE,KAAc,EAAE,YAAY,GAAG,iCAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,qBAAK,CAAC,cAAc;QAC/Q,MAAM,QAAQ,GAAG,wBAAQ,CAAC,yBAAyB,CAAC,YAAY,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,kCAAkB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC/D,MAAM,iBAAiB,GAAG,yBAAS,CAAC,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/E,MAAM,YAAY,GAAG,iBAAiB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;QACvG,MAAM,cAAc,GAAG,YAAY,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC,CAAI,mBAAmB;QACvF,cAAc,CAAC,CAAC,IAAI,cAAc,CAAC,CAAiC,8BAA8B;QAClG,QAAQ,CAAC,8BAA8B,CAAC,cAAc,CAAC,CAAC;QAExD,MAAM,mBAAmB,GAA+B;YACtD,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,eAAe;YACf,kBAAkB;YAClB,cAAc;YACd,MAAM,EAAE,QAAQ,CAAC,oBAAoB,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;YACjG,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE;YAChC,MAAM;YACN,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,EAAE;SAC3F,CAAC;QACF,OAAO,IAAI,qBAAqB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;IACD;;;;;;;;;;;;;OAaG;IACI,MAAM,CAAC,gBAAgB,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,eAA2B,EAAE,kBAA8B,EAAE,cAA0B,EAAE,KAAc,EAAE,YAAY,GAAG,iCAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,qBAAK,CAAC,cAAc;QAC/Q,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QACvK,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;;AA7FH,sDA8FC;;AAnEC,YAAY;AACoB,2CAAqB,GAA0B,CAAC,GAAG,4CAA2B,EAAE,iBAAiB,CAAE,CAAA;AACnI,aAAa;AACmB,iDAA2B,GAAwC;IACjG,GAAG,kDAAiC;IACpC,eAAe,EAAE,iCAAmB,CAAC,OAAO;CAC5C,CAAA;AA+DJ;;;GAGG;AACH,MAAa,0BAA2B,SAAQ,qBAAqB;IACnE,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,4BAA4B,CAAC,CAAC,CAAC;IACvF,YAAY,KAAiC,EAAE,MAAgB,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1F;;;;;;;;;;;;OAYG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,eAA2B,EAAE,kBAA8B,EAAE,cAA0B,EAAE,KAAc,EAAE,YAAY,GAAG,iCAAiB,CAAC,GAAG;QACjO,MAAM,QAAQ,GAAG,wBAAQ,CAAC,yBAAyB,CAAC,YAAY,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,kCAAkB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC/D,MAAM,iBAAiB,GAAG,yBAAS,CAAC,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/E,MAAM,YAAY,GAAG,iBAAiB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,mBAAmB,GAA+B;YACtD,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,eAAe;YACf,kBAAkB;YAClB,cAAc;YACd,MAAM,EAAE,QAAQ,CAAC,oBAAoB,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;YACjG,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE;YAChC,MAAM;YACN,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,IAAI,oBAAM,EAAE,EAAE,mCAAmC;SAC1D,CAAC;QACF,OAAO,IAAI,0BAA0B,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IACvE,CAAC;IACD;;;;;;;;;;;;OAYG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,eAA2B,EAAE,kBAA8B,EAAE,cAA0B,EAAE,KAAc,EAAE,YAAY,GAAG,iCAAiB,CAAC,GAAG;QACjO,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QAChJ,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,oFAAoF;IAC7E,QAAQ,CAAC,KAAc;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,iBAAiB,GAAG,yBAAS,CAAC,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/E,MAAM,YAAY,GAAG,iBAAiB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,uBAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,oBAAoB,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5H,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;CACF;AA9DD,gEA8DC;AAED;;GAEG;AACH,MAAa,gBAAiB,SAAQ,cAAc;IAclD,gBAAgB;IAChB,YAAmB,KAA4B,EAAE,MAAgB;QAC/D,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,mBAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,GAAG,uBAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,uBAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,qBAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,IAAI,yBAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvD,CAAC;IAnBD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAoB7E,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAA2B,CAAC;QACpD,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACnC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,gBAAgB;IACG,2BAA2B,CAAC,YAAgC;QAC7E,KAAK,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAChD,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;IAED,iEAAiE;IACjE,IAAW,OAAO,KAAkB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3D,yDAAyD;IAClD,kBAAkB,KAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAiB,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;CAC7H;AA7CD,4CA6CC;AAED;;GAEG;AACH,MAAa,qBAAsB,SAAQ,gBAAgB;IACzD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,uBAAuB,CAAC,CAAC,CAAC;IAClF,gBAAgB;IAChB,YAAmB,KAA4B,EAAE,MAAgB;QAC/D,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,WAAuB,EAAE,kBAA8B,EAAE,cAA0B,EAAE,KAAc;QACvL,MAAM,mBAAmB,GAA0B;YACjD,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,WAAW;YACX,kBAAkB;YAClB,cAAc;YACd,MAAM,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE;YAC1C,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;YACvB,KAAK,EAAE,CAAC;SACT,CAAC;QACF,OAAO,IAAI,qBAAqB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,WAAuB,EAAE,kBAA8B,EAAE,cAA0B,EAAE,KAAc;QACvL,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;QAC9H,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;CACF;AA/CD,sDA+CC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,gBAAgB;IACvD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,qBAAqB,CAAC,CAAC,CAAC;CACjF;AAHD,kDAGC;AAED;;GAEG;AACH,MAAa,wBAAyB,SAAQ,gBAAgB;IAC5D,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,0BAA0B,CAAC,CAAC,CAAC;CACtF;AAHD,4DAGC;AAED;;GAEG;AACH,MAAa,wBAAyB,SAAQ,gBAAgB;IAC5D,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,0BAA0B,CAAC,CAAC,CAAC;CACtF;AAHD,4DAGC;AAED;;;GAGG;AACH,MAAsB,cAAe,SAAQ,2BAAiB;IAK5D,YAAmB,KAA0B,EAAE,MAAgB,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAJ1F,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,gBAAgB,CAAC,CAAC,CAAC;CAI5E;AAND,wCAMC;AAED;;GAEG;AACH,MAAa,gBAAiB,SAAQ,cAAc;IAKlD,YAAmB,KAA4B,EAAE,MAAgB,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAJ5F,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAK7E;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,SAAiB;QACxF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,gBAAgB,CAAC,CAAC;QACpF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;CACF;AAhBD,4CAgBC;AAED;;GAEG;AACH,MAAa,gBAAiB,SAAQ,cAAc;IAOlD,YAAmB,KAA4B,EAAE,MAAgB,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAN5F,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAO7E;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,SAAiB;QACxF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,gBAAgB,CAAC,CAAC;QACpF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;CACF;AAlBD,4CAkBC;AAED;;GAEG;AACH,MAAa,qBAAsB,SAAQ,gBAAgB;IACzD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,uBAAuB,CAAC,CAAC,CAAC;IAClF;;;;OAIG;IACI,MAAM,CAAU,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,SAAiB;QACjG,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,qBAAqB,CAAC,CAAC;QACzF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;CACF;AAZD,sDAYC;AAED;;GAEG;AACH,MAAa,cAAe,SAAQ,4BAAkB;IAIpD,YAAmB,KAA0B,EAAE,MAAgB;QAC7D,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,4BAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,0GAA0G;IAC5G,CAAC;IAPD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,gBAAgB,CAAC,CAAC,CAAC;IAO3E,gBAAgB;IACG,2BAA2B,CAAC,YAAgC;QAC7E,KAAK,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAChD,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;CACF;AAdD,wCAcC;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,gCAAsB;IAKvD,gBAAgB;IAChB,YAAY,KAAyB,EAAE,MAAgB,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IALlF,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,eAAe,CAAC,CAAC,CAAC;CAK3E;AAPD,sCAOC","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 ViewDefinitions\r\n */\r\n\r\nimport { Id64, Id64Array, Id64String, IModelStatus, JsonUtils } from \"@itwin/core-bentley\";\r\nimport {\r\n  Angle, Matrix3d, Point2d, Point3d, Range2d, Range3d, StandardViewIndex, Transform, Vector3d, YawPitchRollAngles,\r\n} from \"@itwin/core-geometry\";\r\nimport {\r\n  AuxCoordSystem2dProps, AuxCoordSystem3dProps, AuxCoordSystemProps, BisCodeSpec, Camera, CategorySelectorProps, Code, CodeScopeProps,\r\n  CodeSpec, ConcreteEntityTypes, EntityReferenceSet, IModelError, LightLocationProps, ModelSelectorProps, RelatedElement,\r\n  SpatialViewDefinitionProps, ViewAttachmentProps, ViewDefinition2dProps, ViewDefinition3dProps, ViewDefinitionProps, ViewDetails,\r\n  ViewDetails3d,\r\n} from \"@itwin/core-common\";\r\nimport { DefinitionElement, GraphicalElement2d, SpatialLocationElement } from \"./Element\";\r\nimport { IModelDb } from \"./IModelDb\";\r\nimport { DisplayStyle, DisplayStyle2d, DisplayStyle3d } from \"./DisplayStyle\";\r\nimport { IModelElementCloneContext } from \"./IModelElementCloneContext\";\r\n\r\n/** Holds the list of Ids of GeometricModels displayed by a [[SpatialViewDefinition]]. Multiple SpatialViewDefinitions may point to the same ModelSelector.\r\n * @see [ModelSelectorState]($frontend)\r\n * See [how to create a ModelSelector]$(docs/learning/backend/CreateElements.md#ModelSelector).\r\n * @public\r\n */\r\nexport class ModelSelector extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ModelSelector\"; }\r\n\r\n  /** The array of modelIds of the GeometricModels displayed by this ModelSelector */\r\n  public models: Id64String[];\r\n  /** @internal */\r\n  constructor(props: ModelSelectorProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.models = props.models;\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ModelSelectorProps {\r\n    const val = super.toJSON() as ModelSelectorProps;\r\n    val.models = this.models;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    this.models.forEach((modelId: Id64String) => referenceIds.addModel(modelId));\r\n  }\r\n\r\n  /** Create a Code for a ModelSelector given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the ModelSelector and provides the scope for its name.\r\n   * @param codeValue The ModelSelector name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.modelSelector);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /**\r\n   * Create a ModelSelector to select which Models are displayed by a ViewDefinition.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the ModelSelector\r\n   * @param models Array of models to select for display\r\n   * @returns The newly constructed ModelSelector element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, models: Id64Array): ModelSelector {\r\n    const modelSelectorProps: ModelSelectorProps = {\r\n      classFullName: this.classFullName,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      model: definitionModelId,\r\n      models,\r\n      isPrivate: false,\r\n    };\r\n    return new ModelSelector(modelSelectorProps, iModelDb);\r\n  }\r\n  /**\r\n   * Insert a ModelSelector to select which Models are displayed by a ViewDefinition.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new ModelSelector into this DefinitionModel\r\n   * @param name The name/CodeValue of the ModelSelector\r\n   * @param models Array of models to select for display\r\n   * @returns The Id of the newly inserted ModelSelector element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, models: Id64Array): Id64String {\r\n    const modelSelector = this.create(iModelDb, definitionModelId, name, models);\r\n    return iModelDb.elements.insertElement(modelSelector.toJSON());\r\n  }\r\n}\r\n\r\n/** Holds a list of Ids of Categories to be displayed in a view.\r\n * @see [CategorySelectorState]($frontend)\r\n * See [how to create a CategorySelector]$(docs/learning/backend/CreateElements.md#CategorySelector).\r\n * @public\r\n */\r\nexport class CategorySelector extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"CategorySelector\"; }\r\n  /** The array of element Ids of the Categories selected by this CategorySelector */\r\n  public categories: Id64String[];\r\n  /** @internal */\r\n  constructor(props: CategorySelectorProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.categories = props.categories;\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): CategorySelectorProps {\r\n    const val = super.toJSON() as CategorySelectorProps;\r\n    val.categories = this.categories;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    this.categories.forEach((categoryId: Id64String) => referenceIds.addElement(categoryId));\r\n  }\r\n\r\n  /** Create a Code for a CategorySelector given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the CategorySelector and provides the scope for its name.\r\n   * @param codeValue The CategorySelector name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.categorySelector);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /**\r\n   * Create a CategorySelector to select which categories are displayed by a ViewDefinition.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name of the CategorySelector\r\n   * @param categories Array of categories to select for display\r\n   * @returns The newly constructed CategorySelector element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, categories: Id64Array): CategorySelector {\r\n    const categorySelectorProps: CategorySelectorProps = {\r\n      classFullName: this.classFullName,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      model: definitionModelId,\r\n      categories,\r\n      isPrivate: false,\r\n    };\r\n    return new CategorySelector(categorySelectorProps, iModelDb);\r\n  }\r\n\r\n  /**\r\n   * Insert a CategorySelector to select which categories are displayed by a ViewDefinition.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new CategorySelector into this DefinitionModel\r\n   * @param name The name of the CategorySelector\r\n   * @param categories Array of categories to select for display\r\n   * @returns The Id of the newly inserted CategorySelector element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, categories: Id64Array): Id64String {\r\n    const categorySelector = this.create(iModelDb, definitionModelId, name, categories);\r\n    return iModelDb.elements.insertElement(categorySelector.toJSON());\r\n  }\r\n}\r\n\r\n/**\r\n * The definition element for a view. ViewDefinitions specify the area/volume that is viewed, the Ids of a DisplayStyle and a CategorySelector,\r\n * plus additional view-specific parameters in their [[Element.jsonProperties]].\r\n *\r\n * Subclasses of ViewDefinition determine which model(s) are viewed.\r\n *\r\n * **Example: Obtaining the background color for a view**\r\n * ``` ts\r\n * [[include:ViewDefinition.getBackgroundColor]]\r\n * ```\r\n *\r\n * @note ViewDefinition is only available in the backend. See [ViewState]($frontend) for usage in the frontend.\r\n * @public\r\n */\r\nexport abstract class ViewDefinition extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewDefinition\"; }\r\n  /** The element Id of the [[CategorySelector]] for this ViewDefinition */\r\n  public categorySelectorId: Id64String;\r\n  /** The element Id of the [[DisplayStyle]] for this ViewDefinition */\r\n  public displayStyleId: Id64String;\r\n\r\n  /** @internal */\r\n  protected constructor(props: ViewDefinitionProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n\r\n    this.categorySelectorId = Id64.fromJSON(props.categorySelectorId);\r\n    if (!Id64.isValid(this.categorySelectorId))\r\n      throw new IModelError(IModelStatus.BadArg, `categorySelectorId is invalid`);\r\n\r\n    this.displayStyleId = Id64.fromJSON(props.displayStyleId);\r\n    if (!Id64.isValid(this.displayStyleId))\r\n      throw new IModelError(IModelStatus.BadArg, `displayStyleId is invalid`);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ViewDefinitionProps {\r\n    const json = super.toJSON() as ViewDefinitionProps;\r\n    json.categorySelectorId = this.categorySelectorId;\r\n    json.displayStyleId = this.displayStyleId;\r\n    return json;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.categorySelectorId);\r\n    referenceIds.addElement(this.displayStyleId);\r\n    const acsId: Id64String = this.getAuxiliaryCoordinateSystemId();\r\n    if (Id64.isValidId64(acsId)) {\r\n      referenceIds.addElement(acsId);\r\n    }\r\n  }\r\n\r\n  /** @beta */\r\n  public static override readonly requiredReferenceKeys: ReadonlyArray<string> = [...super.requiredReferenceKeys, \"categorySelectorId\", \"displayStyleId\"];\r\n  /** @alpha */\r\n  public static override readonly requiredReferenceKeyTypeMap: Record<string, ConcreteEntityTypes> = {\r\n    ...super.requiredReferenceKeyTypeMap,\r\n    categorySelectorId: ConcreteEntityTypes.Element,\r\n    displayStyleId: ConcreteEntityTypes.Element,\r\n  };\r\n\r\n  /** @internal */\r\n  protected static override onCloned(context: IModelElementCloneContext, sourceElementProps: ViewDefinitionProps, targetElementProps: ViewDefinitionProps): void {\r\n    super.onCloned(context, sourceElementProps, targetElementProps);\r\n    if (context.isBetweenIModels && targetElementProps.jsonProperties && targetElementProps.jsonProperties.viewDetails) {\r\n      const acsId: Id64String = Id64.fromJSON(targetElementProps.jsonProperties.viewDetails.acs);\r\n      if (Id64.isValidId64(acsId)) {\r\n        targetElementProps.jsonProperties.viewDetails.acs = context.findTargetElementId(acsId);\r\n      }\r\n    }\r\n  }\r\n\r\n  /** Type guard for `instanceof ViewDefinition3d`  */\r\n  public isView3d(): this is ViewDefinition3d { return this instanceof ViewDefinition3d; }\r\n  /** Type guard for 'instanceof ViewDefinition2d` */\r\n  public isView2d(): this is ViewDefinition2d { return this instanceof ViewDefinition2d; }\r\n  /** Type guard for `instanceof SpatialViewDefinition` */\r\n  public isSpatialView(): this is SpatialViewDefinition { return this instanceof SpatialViewDefinition; }\r\n  /** Type guard for 'instanceof DrawingViewDefinition' */\r\n  public isDrawingView(): this is DrawingViewDefinition { return this instanceof DrawingViewDefinition; }\r\n\r\n  /** Load this view's DisplayStyle from the IModelDb. */\r\n  public loadDisplayStyle(): DisplayStyle { return this.iModel.elements.getElement<DisplayStyle>(this.displayStyleId); }\r\n\r\n  /** Load this view's CategorySelector from the IModelDb. */\r\n  public loadCategorySelector(): CategorySelector { return this.iModel.elements.getElement<CategorySelector>(this.categorySelectorId); }\r\n\r\n  /** Provides access to optional detail settings for this view. */\r\n  public abstract get details(): ViewDetails;\r\n\r\n  /** The Id of the AuxiliaryCoordinateSystem for this ViewDefinition, or an invalid Id if no ACS is defined. */\r\n  public getAuxiliaryCoordinateSystemId(): Id64String {\r\n    return this.details.auxiliaryCoordinateSystemId;\r\n  }\r\n\r\n  /** Set or clear the AuxiliaryCoordinateSystem for this ViewDefinition.\r\n   * @param acsId The Id of the new AuxiliaryCoordinateSystem. If `Id64.invalid` is passed, then no AuxiliaryCoordinateSystem will be used.\r\n   */\r\n  public setAuxiliaryCoordinateSystemId(acsId: Id64String) {\r\n    this.details.auxiliaryCoordinateSystemId = acsId;\r\n  }\r\n\r\n  /** Create a Code for a ViewDefinition given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel to contain the ViewDefinition and provides the scope for its name.\r\n   * @param codeValue The ViewDefinition name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.viewDefinition);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** Defines a view of one or more 3d models.\r\n * @public\r\n */\r\nexport abstract class ViewDefinition3d extends ViewDefinition {\r\n  private readonly _details: ViewDetails3d;\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewDefinition3d\"; }\r\n  /** If true, camera is used. Otherwise, use an orthographic projection. */\r\n  public cameraOn: boolean;\r\n  /** The lower left back corner of the view frustum. */\r\n  public origin: Point3d;\r\n  /** The extent (size) of the view frustum, in meters, along its x,y,z axes. */\r\n  public extents: Vector3d;\r\n  /** Rotation from world coordinates to view coordinates. */\r\n  public angles: YawPitchRollAngles;\r\n  /** The camera used for this view, if `cameraOn` is true. */\r\n  public camera: Camera;\r\n\r\n  /** @internal */\r\n  public constructor(props: ViewDefinition3dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.cameraOn = JsonUtils.asBool(props.cameraOn);\r\n    this.origin = Point3d.fromJSON(props.origin);\r\n    this.extents = Vector3d.fromJSON(props.extents);\r\n    this.angles = YawPitchRollAngles.fromJSON(props.angles);\r\n    this.camera = new Camera(props.camera);\r\n    this._details = new ViewDetails3d(this.jsonProperties);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ViewDefinition3dProps {\r\n    const val = super.toJSON() as ViewDefinition3dProps;\r\n    val.cameraOn = this.cameraOn;\r\n    val.origin = this.origin;\r\n    val.extents = this.extents;\r\n    val.angles = this.angles;\r\n    val.camera = this.camera;\r\n    return val;\r\n  }\r\n\r\n  /** Provides access to optional detail settings for this view. */\r\n  public get details(): ViewDetails3d { return this._details; }\r\n\r\n  /** Load this view's DisplayStyle3d from the IModelDb. */\r\n  public loadDisplayStyle3d(): DisplayStyle3d { return this.iModel.elements.getElement<DisplayStyle3d>(this.displayStyleId); }\r\n}\r\n\r\n/** Defines a view of one or more SpatialModels.\r\n * The list of viewed models is stored by the ModelSelector.\r\n *\r\n * This is how a SpatialViewDefinition selects the elements to display:\r\n *\r\n *  SpatialViewDefinition\r\n *    * ModelSelector\r\n *        * ModelIds  -------> SpatialModels    <----------GeometricElement3d.Model\r\n *    * CategorySelector\r\n *        * CategoryIds -----> SpatialCategories <----------GeometricElement3d.Category\r\n * @public\r\n */\r\nexport class SpatialViewDefinition extends ViewDefinition3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SpatialViewDefinition\"; }\r\n  /** The Id of the [[ModelSelector]] for this SpatialViewDefinition. */\r\n  public modelSelectorId: Id64String;\r\n\r\n  /** @internal */\r\n  constructor(props: SpatialViewDefinitionProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.modelSelectorId = Id64.fromJSON(props.modelSelectorId);\r\n    if (!Id64.isValid(this.modelSelectorId))\r\n      throw new IModelError(IModelStatus.BadArg, `modelSelectorId is invalid`);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): SpatialViewDefinitionProps {\r\n    const json = super.toJSON() as SpatialViewDefinitionProps;\r\n    json.modelSelectorId = this.modelSelectorId;\r\n    return json;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.modelSelectorId);\r\n  }\r\n\r\n  /** @beta */\r\n  public static override readonly requiredReferenceKeys: ReadonlyArray<string> = [...super.requiredReferenceKeys, \"modelSelectorId\"];\r\n  /** @alpha */\r\n  public static override readonly requiredReferenceKeyTypeMap: Record<string, ConcreteEntityTypes> = {\r\n    ...super.requiredReferenceKeyTypeMap,\r\n    modelSelectorId: ConcreteEntityTypes.Element,\r\n  };\r\n\r\n  /** Load this view's ModelSelector from the IModelDb. */\r\n  public loadModelSelector(): ModelSelector { return this.iModel.elements.getElement<ModelSelector>(this.modelSelectorId); }\r\n  /**\r\n   * Create an SpatialViewDefinition with camera.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @param cameraAngle Camera angle in radians.\r\n   * @returns The newly constructed OrthographicViewDefinition element\r\n   * @throws [[IModelError]] if there is a problem creating the view\r\n   */\r\n  public static createWithCamera(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso, cameraAngle = Angle.piOver2Radians): SpatialViewDefinition {\r\n    const rotation = Matrix3d.createStandardWorldToView(standardView);\r\n    const angles = YawPitchRollAngles.createFromMatrix3d(rotation);\r\n    const rotationTransform = Transform.createOriginAndMatrix(undefined, rotation);\r\n    const rotatedRange = rotationTransform.multiplyRange(range);\r\n    const cameraDistance = 2 * (rotatedRange.diagonal().magnitudeXY() / 2.0) / Math.tan(cameraAngle / 2.0);\r\n    const cameraLocation = rotatedRange.diagonalFractionToPoint(.5);    // Start at center.\r\n    cameraLocation.z += cameraDistance;                                 // Back up by camera distance.\r\n    rotation.multiplyTransposeVectorInPlace(cameraLocation);\r\n\r\n    const viewDefinitionProps: SpatialViewDefinitionProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      modelSelectorId,\r\n      categorySelectorId,\r\n      displayStyleId,\r\n      origin: rotation.multiplyTransposeXYZ(rotatedRange.low.x, rotatedRange.low.y, rotatedRange.low.z),\r\n      extents: rotatedRange.diagonal(),\r\n      angles,\r\n      cameraOn: true,\r\n      camera: { lens: { radians: cameraAngle }, focusDist: cameraDistance, eye: cameraLocation },\r\n    };\r\n    return new SpatialViewDefinition(viewDefinitionProps, iModelDb);\r\n  }\r\n  /**\r\n   * Insert an SpatialViewDefinition with camera On\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new OrthographicViewDefinition into this DefinitionModel\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @param cameraAngle Camera angle in radians.\r\n   * @returns The Id of the newly inserted OrthographicViewDefinition element\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insertWithCamera(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso, cameraAngle = Angle.piOver2Radians): Id64String {\r\n    const viewDefinition = this.createWithCamera(iModelDb, definitionModelId, name, modelSelectorId, categorySelectorId, displayStyleId, range, standardView, cameraAngle);\r\n    return iModelDb.elements.insertElement(viewDefinition.toJSON());\r\n  }\r\n}\r\n\r\n/** Defines a spatial view that displays geometry on the image plane using a parallel orthographic projection.\r\n * See [how to create a OrthographicViewDefinition]$(docs/learning/backend/CreateElements.md#OrthographicViewDefinition).\r\n * @public\r\n */\r\nexport class OrthographicViewDefinition extends SpatialViewDefinition {\r\n  /** @internal */\r\n  public static override get className(): string { return \"OrthographicViewDefinition\"; }\r\n  constructor(props: SpatialViewDefinitionProps, iModel: IModelDb) { super(props, iModel); }\r\n  /**\r\n   * Create an OrthographicViewDefinition\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @returns The newly constructed OrthographicViewDefinition element\r\n   * @throws [[IModelError]] if there is a problem creating the view\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso): OrthographicViewDefinition {\r\n    const rotation = Matrix3d.createStandardWorldToView(standardView);\r\n    const angles = YawPitchRollAngles.createFromMatrix3d(rotation);\r\n    const rotationTransform = Transform.createOriginAndMatrix(undefined, rotation);\r\n    const rotatedRange = rotationTransform.multiplyRange(range);\r\n    const viewDefinitionProps: SpatialViewDefinitionProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      modelSelectorId,\r\n      categorySelectorId,\r\n      displayStyleId,\r\n      origin: rotation.multiplyTransposeXYZ(rotatedRange.low.x, rotatedRange.low.y, rotatedRange.low.z),\r\n      extents: rotatedRange.diagonal(),\r\n      angles,\r\n      cameraOn: false,\r\n      camera: new Camera(), // not used when cameraOn === false\r\n    };\r\n    return new OrthographicViewDefinition(viewDefinitionProps, iModelDb);\r\n  }\r\n  /**\r\n   * Insert an OrthographicViewDefinition\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new OrthographicViewDefinition into this DefinitionModel\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @returns The Id of the newly inserted OrthographicViewDefinition element\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso): Id64String {\r\n    const viewDefinition = this.create(iModelDb, definitionModelId, name, modelSelectorId, categorySelectorId, displayStyleId, range, standardView);\r\n    return iModelDb.elements.insertElement(viewDefinition.toJSON());\r\n  }\r\n  /** Set a new viewed range without changing the rotation or any other properties. */\r\n  public setRange(range: Range3d): void {\r\n    const rotation = this.angles.toMatrix3d();\r\n    const rotationTransform = Transform.createOriginAndMatrix(undefined, rotation);\r\n    const rotatedRange = rotationTransform.multiplyRange(range);\r\n    this.origin = Point3d.createFrom(rotation.multiplyTransposeXYZ(rotatedRange.low.x, rotatedRange.low.y, rotatedRange.low.z));\r\n    this.extents = rotatedRange.diagonal();\r\n  }\r\n}\r\n\r\n/** Defines a view of a single 2d model. Each 2d model has its own coordinate system, so only one may appear per view.\r\n * @public\r\n */\r\nexport class ViewDefinition2d extends ViewDefinition {\r\n  private readonly _details: ViewDetails;\r\n\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewDefinition2d\"; }\r\n  /** The Id of the Model displayed by this view. */\r\n  public baseModelId: Id64String;\r\n  /** The lower-left corner of this view in Model coordinates. */\r\n  public origin: Point2d;\r\n  /** The delta (size) of this view, in meters, aligned with view x,y. */\r\n  public delta: Point2d;\r\n  /** The rotation of this view. */\r\n  public angle: Angle;\r\n\r\n  /** @internal */\r\n  public constructor(props: ViewDefinition2dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.baseModelId = Id64.fromJSON(props.baseModelId);\r\n    this.origin = Point2d.fromJSON(props.origin);\r\n    this.delta = Point2d.fromJSON(props.delta);\r\n    this.angle = Angle.fromJSON(props.angle);\r\n    this._details = new ViewDetails(this.jsonProperties);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ViewDefinition2dProps {\r\n    const val = super.toJSON() as ViewDefinition2dProps;\r\n    val.baseModelId = this.baseModelId;\r\n    val.origin = this.origin;\r\n    val.delta = this.delta;\r\n    val.angle = this.angle;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.baseModelId);\r\n  }\r\n\r\n  /** Provides access to optional detail settings for this view. */\r\n  public get details(): ViewDetails { return this._details; }\r\n\r\n  /** Load this view's DisplayStyle2d from the IModelDb. */\r\n  public loadDisplayStyle2d(): DisplayStyle2d { return this.iModel.elements.getElement<DisplayStyle2d>(this.displayStyleId); }\r\n}\r\n\r\n/** Defines a view of a [[DrawingModel]].\r\n * @public\r\n */\r\nexport class DrawingViewDefinition extends ViewDefinition2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"DrawingViewDefinition\"; }\r\n  /** @internal */\r\n  public constructor(props: ViewDefinition2dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n  }\r\n\r\n  /** Create a DrawingViewDefinition\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param baseModelId The base [[DrawingModel]]\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle2d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @throws [[IModelError]] if there is a problem creating the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, baseModelId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range2d): DrawingViewDefinition {\r\n    const viewDefinitionProps: ViewDefinition2dProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      baseModelId,\r\n      categorySelectorId,\r\n      displayStyleId,\r\n      origin: { x: range.low.x, y: range.low.y },\r\n      delta: range.diagonal(),\r\n      angle: 0,\r\n    };\r\n    return new DrawingViewDefinition(viewDefinitionProps, iModelDb);\r\n  }\r\n\r\n  /** Insert a DrawingViewDefinition\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new DrawingViewDefinition into this [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param baseModelId The base [[DrawingModel]]\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle2d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, baseModelId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range2d): Id64String {\r\n    const viewDefinition = this.create(iModelDb, definitionModelId, name, baseModelId, categorySelectorId, displayStyleId, range);\r\n    return iModelDb.elements.insertElement(viewDefinition.toJSON());\r\n  }\r\n}\r\n\r\n/** Defines a view of a [[SheetModel]].\r\n * @public\r\n */\r\nexport class SheetViewDefinition extends ViewDefinition2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SheetViewDefinition\"; }\r\n}\r\n\r\n/** A ViewDefinition used to display a 2d template model.\r\n * @internal\r\n */\r\nexport class TemplateViewDefinition2d extends ViewDefinition2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"TemplateViewDefinition2d\"; }\r\n}\r\n\r\n/** A ViewDefinition used to display a 3d template model.\r\n * @internal\r\n */\r\nexport class TemplateViewDefinition3d extends ViewDefinition3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"TemplateViewDefinition3d\"; }\r\n}\r\n\r\n/** An auxiliary coordinate system element. Auxiliary coordinate systems can be used by views to show\r\n * coordinate information in different units and/or orientations.\r\n * @public\r\n */\r\nexport abstract class AuxCoordSystem extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystem\"; }\r\n  public type!: number;\r\n  public description?: string;\r\n  public constructor(props: AuxCoordSystemProps, iModel: IModelDb) { super(props, iModel); }\r\n}\r\n\r\n/** A 2d auxiliary coordinate system.\r\n * @public\r\n */\r\nexport class AuxCoordSystem2d extends AuxCoordSystem {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystem2d\"; }\r\n  public origin?: Point2d;\r\n  public angle!: number;\r\n  public constructor(props: AuxCoordSystem2dProps, iModel: IModelDb) { super(props, iModel); }\r\n\r\n  /** Create a Code for a AuxCoordSystem2d element given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the AuxCoordSystem2d element and provides the scope for its name.\r\n   * @param codeValue The AuxCoordSystem2d name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.auxCoordSystem2d);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** A 3d auxiliary coordinate system.\r\n * @public\r\n */\r\nexport class AuxCoordSystem3d extends AuxCoordSystem {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystem3d\"; }\r\n  public origin?: Point3d;\r\n  public yaw!: number;\r\n  public pitch!: number;\r\n  public roll!: number;\r\n  public constructor(props: AuxCoordSystem3dProps, iModel: IModelDb) { super(props, iModel); }\r\n\r\n  /** Create a Code for a AuxCoordSystem3d element given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the AuxCoordSystem3d element and provides the scope for its name.\r\n   * @param codeValue The AuxCoordSystem3d name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.auxCoordSystem3d);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** A spatial auxiliary coordinate system.\r\n * @public\r\n */\r\nexport class AuxCoordSystemSpatial extends AuxCoordSystem3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystemSpatial\"; }\r\n  /** Create a Code for a AuxCoordSystemSpatial element given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the AuxCoordSystemSpatial element and provides the scope for its name.\r\n   * @param codeValue The AuxCoordSystemSpatial name\r\n   */\r\n  public static override createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.auxCoordSystemSpatial);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** Represents an *attachment* of a [[ViewDefinition]] to a [[Sheet]].\r\n * @public\r\n */\r\nexport class ViewAttachment extends GraphicalElement2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewAttachment\"; }\r\n  public view: RelatedElement;\r\n  public constructor(props: ViewAttachmentProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.view = new RelatedElement(props.view);\r\n    // ###NOTE: scale, displayPriority, and clipping vectors are stored in ViewAttachmentProps.jsonProperties.\r\n  }\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.view.id);\r\n  }\r\n}\r\n\r\n/** The position in space of a Light.\r\n * @internal\r\n */\r\nexport class LightLocation extends SpatialLocationElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"LightLocation\"; }\r\n  /** Whether this light is currently turned on. */\r\n  public enabled!: boolean;\r\n  /** @internal */\r\n  constructor(props: LightLocationProps, iModel: IModelDb) { super(props, iModel); }\r\n}\r\n"]}
+{"version":3,"file":"ViewDefinition.js","sourceRoot":"","sources":["../../src/ViewDefinition.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;;AAEH,sDAA2F;AAC3F,wDAE8B;AAC9B,oDAK4B;AAC5B,uCAA0F;AAK1F;;;;GAIG;AACH,MAAa,aAAc,SAAQ,2BAAiB;IAMlD,gBAAgB;IAChB,YAAY,KAAyB,EAAE,MAAgB;QACrD,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IATD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,eAAe,CAAC,CAAC,CAAC;IAU1E,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAAwB,CAAC;QACjD,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,gBAAgB;IACG,2BAA2B,CAAC,YAAgC;QAC7E,KAAK,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAmB,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/E,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,SAAiB;QACxF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,aAAa,CAAC,CAAC;QACjF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,MAAiB;QACrG,MAAM,kBAAkB,GAAuB;YAC7C,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,KAAK,EAAE,iBAAiB;YACxB,MAAM;YACN,SAAS,EAAE,KAAK;SACjB,CAAC;QACF,OAAO,IAAI,aAAa,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC;IACD;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,MAAiB;QACrG,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7E,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;CACF;AAnED,sCAmEC;AAED;;;;GAIG;AACH,MAAa,gBAAiB,SAAQ,2BAAiB;IAKrD,gBAAgB;IAChB,YAAY,KAA4B,EAAE,MAAgB;QACxD,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACrC,CAAC;IARD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAS7E,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAA2B,CAAC;QACpD,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACjC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,gBAAgB;IACG,2BAA2B,CAAC,YAAgC;QAC7E,KAAK,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,UAAsB,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,SAAiB;QACxF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,gBAAgB,CAAC,CAAC;QACpF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,UAAqB;QACzG,MAAM,qBAAqB,GAA0B;YACnD,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,KAAK,EAAE,iBAAiB;YACxB,UAAU;YACV,SAAS,EAAE,KAAK;SACjB,CAAC;QACF,OAAO,IAAI,gBAAgB,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,UAAqB;QACzG,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACpF,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;CACF;AAnED,4CAmEC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAsB,cAAe,SAAQ,MAAA,2BAAiB,CAAA;IAQ5D,gBAAgB;IAChB,YAAsB,KAA0B,EAAE,MAAgB;QAChE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAErB,IAAI,CAAC,kBAAkB,GAAG,mBAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAClE,IAAI,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC;YACxC,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,MAAM,EAAE,+BAA+B,CAAC,CAAC;QAE9E,IAAI,CAAC,cAAc,GAAG,mBAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC1D,IAAI,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC;YACpC,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IAC5E,CAAC;IAlBD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,gBAAgB,CAAC,CAAC,CAAC;IAmB3E,gBAAgB;IACA,MAAM;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAyB,CAAC;QACnD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC;QAClD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gBAAgB;IACG,2BAA2B,CAAC,YAAgC;QAC7E,KAAK,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAChD,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjD,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAe,IAAI,CAAC,8BAA8B,EAAE,CAAC;QAChE,IAAI,mBAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;YAC3B,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;SAChC;IACH,CAAC;IAWD,gBAAgB;IACN,MAAM,CAAU,QAAQ,CAAC,OAAkC,EAAE,kBAAuC,EAAE,kBAAuC;QACrJ,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QAChE,IAAI,OAAO,CAAC,gBAAgB,IAAI,kBAAkB,CAAC,cAAc,IAAI,kBAAkB,CAAC,cAAc,CAAC,WAAW,EAAE;YAClH,MAAM,KAAK,GAAe,mBAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC3F,IAAI,mBAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;gBAC3B,kBAAkB,CAAC,cAAc,CAAC,WAAW,CAAC,GAAG,GAAG,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;aACxF;SACF;IACH,CAAC;IAED,oDAAoD;IAC7C,QAAQ,KAA+B,OAAO,IAAI,YAAY,gBAAgB,CAAC,CAAC,CAAC;IACxF,mDAAmD;IAC5C,QAAQ,KAA+B,OAAO,IAAI,YAAY,gBAAgB,CAAC,CAAC,CAAC;IACxF,wDAAwD;IACjD,aAAa,KAAoC,OAAO,IAAI,YAAY,qBAAqB,CAAC,CAAC,CAAC;IACvG,wDAAwD;IACjD,aAAa,KAAoC,OAAO,IAAI,YAAY,qBAAqB,CAAC,CAAC,CAAC;IAEvG,uDAAuD;IAChD,gBAAgB,KAAmB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAe,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAEtH,2DAA2D;IACpD,oBAAoB,KAAuB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAmB,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAKtI,8GAA8G;IACvG,8BAA8B;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC;IAClD,CAAC;IAED;;OAEG;IACI,8BAA8B,CAAC,KAAiB;QACrD,IAAI,CAAC,OAAO,CAAC,2BAA2B,GAAG,KAAK,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,SAAiB;QACxF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,cAAc,CAAC,CAAC;QAClF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;;AAlGH,wCAmGC;;AA3DC,YAAY;AACoB,oCAAqB,GAA0B,CAAC,GAAG,4CAA2B,EAAE,oBAAoB,EAAE,gBAAgB,CAAE,CAAA;AACxJ,aAAa;AACmB,0CAA2B,GAAwC;IACjG,GAAG,kDAAiC;IACpC,kBAAkB,EAAE,iCAAmB,CAAC,OAAO;IAC/C,cAAc,EAAE,iCAAmB,CAAC,OAAO;CAC3C,CAAA;AAsDJ;;GAEG;AACH,MAAsB,gBAAiB,SAAQ,cAAc;IAe3D,gBAAgB;IAChB,YAAmB,KAA4B,EAAE,MAAgB;QAC/D,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,wBAAS,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,uBAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,wBAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,kCAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,IAAI,oBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,2BAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzD,CAAC;IAtBD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAuB7E,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAA2B,CAAC;QACpD,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC7B,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3B,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,iEAAiE;IACjE,IAAW,OAAO,KAAoB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE7D,yDAAyD;IAClD,kBAAkB,KAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAiB,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;CAC7H;AA1CD,4CA0CC;AAED;;;;;;;;;;;GAWG;AACH,MAAa,qBAAsB,SAAQ,MAAA,gBAAgB,CAAA;IAMzD,gBAAgB;IAChB,YAAmB,KAAiC,EAAE,MAAgB;QACpE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,eAAe,GAAG,mBAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC5D,IAAI,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC;YACrC,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IAC7E,CAAC;IAXD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,uBAAuB,CAAC,CAAC,CAAC;IAYlF,sEAAsE;IAC/D,MAAM,CAAC,QAAQ,CAAC,KAAwD,EAAE,MAAgB;QAC/F,OAAO,IAAI,qBAAqB,CAAC,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,CAAC;IAC5F,CAAC;IAED,oDAAoD;IACpC,MAAM;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAgC,CAAC;QAC1D,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gBAAgB;IACG,2BAA2B,CAAC,YAAgC;QAC7E,KAAK,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAChD,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC;IAWD,wDAAwD;IACjD,iBAAiB,KAAoB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAgB,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC1H;;;;;;;;;;;;;OAaG;IACI,MAAM,CAAC,gBAAgB,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,eAA2B,EAAE,kBAA8B,EAAE,cAA0B,EAAE,KAAc,EAAE,YAAY,GAAG,iCAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,qBAAK,CAAC,cAAc;QAC/Q,MAAM,QAAQ,GAAG,wBAAQ,CAAC,yBAAyB,CAAC,YAAY,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,kCAAkB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC/D,MAAM,iBAAiB,GAAG,yBAAS,CAAC,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/E,MAAM,YAAY,GAAG,iBAAiB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;QACvG,MAAM,cAAc,GAAG,YAAY,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC,CAAI,mBAAmB;QACvF,cAAc,CAAC,CAAC,IAAI,cAAc,CAAC,CAAiC,8BAA8B;QAClG,QAAQ,CAAC,8BAA8B,CAAC,cAAc,CAAC,CAAC;QAExD,MAAM,mBAAmB,GAA+B;YACtD,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,eAAe;YACf,kBAAkB;YAClB,cAAc;YACd,MAAM,EAAE,QAAQ,CAAC,oBAAoB,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;YACjG,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE;YAChC,MAAM;YACN,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,EAAE;SAC3F,CAAC;QAEF,OAAO,IAAI,qBAAqB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,gBAAgB,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,eAA2B,EAAE,kBAA8B,EAAE,cAA0B,EAAE,KAAc,EAAE,YAAY,GAAG,iCAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,qBAAK,CAAC,cAAc;QAC/Q,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QACvK,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;;AA5FH,sDA6FC;;AA7DC,YAAY;AACoB,2CAAqB,GAA0B,CAAC,GAAG,4CAA2B,EAAE,iBAAiB,CAAE,CAAA;AAEnI,aAAa;AACmB,iDAA2B,GAAwC;IACjG,GAAG,kDAAiC;IACpC,eAAe,EAAE,iCAAmB,CAAC,OAAO;CAC5C,CAAA;AAwDJ;;;GAGG;AACH,MAAa,0BAA2B,SAAQ,qBAAqB;IACnE,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,4BAA4B,CAAC,CAAC,CAAC;IACvF,YAAY,KAAiC,EAAE,MAAgB,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1F;;;;;;;;;;;;OAYG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,eAA2B,EAAE,kBAA8B,EAAE,cAA0B,EAAE,KAAc,EAAE,YAAY,GAAG,iCAAiB,CAAC,GAAG;QACjO,MAAM,QAAQ,GAAG,wBAAQ,CAAC,yBAAyB,CAAC,YAAY,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,kCAAkB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC/D,MAAM,iBAAiB,GAAG,yBAAS,CAAC,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/E,MAAM,YAAY,GAAG,iBAAiB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,mBAAmB,GAA+B;YACtD,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,eAAe;YACf,kBAAkB;YAClB,cAAc;YACd,MAAM,EAAE,QAAQ,CAAC,oBAAoB,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;YACjG,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE;YAChC,MAAM;YACN,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,IAAI,oBAAM,EAAE,EAAE,mCAAmC;SAC1D,CAAC;QACF,OAAO,IAAI,0BAA0B,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,eAA2B,EAAE,kBAA8B,EAAE,cAA0B,EAAE,KAAc,EAAE,YAAY,GAAG,iCAAiB,CAAC,GAAG;QACjO,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QAChJ,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,oFAAoF;IAC7E,QAAQ,CAAC,KAAc;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,iBAAiB,GAAG,yBAAS,CAAC,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/E,MAAM,YAAY,GAAG,iBAAiB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,uBAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,oBAAoB,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5H,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;CACF;AAhED,gEAgEC;AAED;;GAEG;AACH,MAAa,gBAAiB,SAAQ,cAAc;IAclD,gBAAgB;IAChB,YAAmB,KAA4B,EAAE,MAAgB;QAC/D,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,mBAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,GAAG,uBAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,uBAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,qBAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,IAAI,yBAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvD,CAAC;IAnBD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAoB7E,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAA2B,CAAC;QACpD,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACnC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,gBAAgB;IACG,2BAA2B,CAAC,YAAgC;QAC7E,KAAK,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAChD,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;IAED,iEAAiE;IACjE,IAAW,OAAO,KAAkB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3D,yDAAyD;IAClD,kBAAkB,KAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAiB,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;CAC7H;AA7CD,4CA6CC;AAED;;GAEG;AACH,MAAa,qBAAsB,SAAQ,gBAAgB;IACzD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,uBAAuB,CAAC,CAAC,CAAC;IAClF,gBAAgB;IAChB,YAAmB,KAA4B,EAAE,MAAgB;QAC/D,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,WAAuB,EAAE,kBAA8B,EAAE,cAA0B,EAAE,KAAc;QACvL,MAAM,mBAAmB,GAA0B;YACjD,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,WAAW;YACX,kBAAkB;YAClB,cAAc;YACd,MAAM,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE;YAC1C,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;YACvB,KAAK,EAAE,CAAC;SACT,CAAC;QACF,OAAO,IAAI,qBAAqB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,WAAuB,EAAE,kBAA8B,EAAE,cAA0B,EAAE,KAAc;QACvL,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;QAC9H,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;CACF;AA/CD,sDA+CC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,gBAAgB;IACvD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,qBAAqB,CAAC,CAAC,CAAC;CACjF;AAHD,kDAGC;AAED;;GAEG;AACH,MAAa,wBAAyB,SAAQ,gBAAgB;IAC5D,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,0BAA0B,CAAC,CAAC,CAAC;CACtF;AAHD,4DAGC;AAED;;GAEG;AACH,MAAa,wBAAyB,SAAQ,gBAAgB;IAC5D,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,0BAA0B,CAAC,CAAC,CAAC;CACtF;AAHD,4DAGC;AAED;;;GAGG;AACH,MAAsB,cAAe,SAAQ,2BAAiB;IAK5D,YAAmB,KAA0B,EAAE,MAAgB,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAJ1F,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,gBAAgB,CAAC,CAAC,CAAC;CAI5E;AAND,wCAMC;AAED;;GAEG;AACH,MAAa,gBAAiB,SAAQ,cAAc;IAKlD,YAAmB,KAA4B,EAAE,MAAgB,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAJ5F,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAK7E;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,SAAiB;QACxF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,gBAAgB,CAAC,CAAC;QACpF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;CACF;AAhBD,4CAgBC;AAED;;GAEG;AACH,MAAa,gBAAiB,SAAQ,cAAc;IAOlD,YAAmB,KAA4B,EAAE,MAAgB,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAN5F,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAO7E;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,SAAiB;QACxF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,gBAAgB,CAAC,CAAC;QACpF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;CACF;AAlBD,4CAkBC;AAED;;GAEG;AACH,MAAa,qBAAsB,SAAQ,gBAAgB;IACzD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,uBAAuB,CAAC,CAAC,CAAC;IAClF;;;;OAIG;IACI,MAAM,CAAU,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,SAAiB;QACjG,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,qBAAqB,CAAC,CAAC;QACzF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;CACF;AAZD,sDAYC;AAED;;GAEG;AACH,MAAa,cAAe,SAAQ,4BAAkB;IAIpD,YAAmB,KAA0B,EAAE,MAAgB;QAC7D,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,4BAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,0GAA0G;IAC5G,CAAC;IAPD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,gBAAgB,CAAC,CAAC,CAAC;IAO3E,gBAAgB;IACG,2BAA2B,CAAC,YAAgC;QAC7E,KAAK,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAChD,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;CACF;AAdD,wCAcC;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,gCAAsB;IAKvD,gBAAgB;IAChB,YAAY,KAAyB,EAAE,MAAgB,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IALlF,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,eAAe,CAAC,CAAC,CAAC;CAK3E;AAPD,sCAOC","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 ViewDefinitions\r\n */\r\n\r\nimport { Id64, Id64Array, Id64String, IModelStatus, JsonUtils } from \"@itwin/core-bentley\";\r\nimport {\r\n  Angle, Matrix3d, Point2d, Point3d, Range2d, Range3d, StandardViewIndex, Transform, Vector3d, YawPitchRollAngles,\r\n} from \"@itwin/core-geometry\";\r\nimport {\r\n  AuxCoordSystem2dProps, AuxCoordSystem3dProps, AuxCoordSystemProps, BisCodeSpec, Camera, CategorySelectorProps, Code, CodeScopeProps,\r\n  CodeSpec, ConcreteEntityTypes, EntityReferenceSet, IModelError, LightLocationProps, ModelSelectorProps, RelatedElement,\r\n  SpatialViewDefinitionProps, ViewAttachmentProps, ViewDefinition2dProps, ViewDefinition3dProps, ViewDefinitionProps, ViewDetails,\r\n  ViewDetails3d,\r\n} from \"@itwin/core-common\";\r\nimport { DefinitionElement, GraphicalElement2d, SpatialLocationElement } from \"./Element\";\r\nimport { IModelDb } from \"./IModelDb\";\r\nimport { DisplayStyle, DisplayStyle2d, DisplayStyle3d } from \"./DisplayStyle\";\r\nimport { IModelElementCloneContext } from \"./IModelElementCloneContext\";\r\n\r\n/** Holds the list of Ids of GeometricModels displayed by a [[SpatialViewDefinition]]. Multiple SpatialViewDefinitions may point to the same ModelSelector.\r\n * @see [ModelSelectorState]($frontend)\r\n * See [how to create a ModelSelector]$(docs/learning/backend/CreateElements.md#ModelSelector).\r\n * @public\r\n */\r\nexport class ModelSelector extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ModelSelector\"; }\r\n\r\n  /** The array of modelIds of the GeometricModels displayed by this ModelSelector */\r\n  public models: Id64String[];\r\n  /** @internal */\r\n  constructor(props: ModelSelectorProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.models = props.models;\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ModelSelectorProps {\r\n    const val = super.toJSON() as ModelSelectorProps;\r\n    val.models = this.models;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    this.models.forEach((modelId: Id64String) => referenceIds.addModel(modelId));\r\n  }\r\n\r\n  /** Create a Code for a ModelSelector given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the ModelSelector and provides the scope for its name.\r\n   * @param codeValue The ModelSelector name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.modelSelector);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /**\r\n   * Create a ModelSelector to select which Models are displayed by a ViewDefinition.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the ModelSelector\r\n   * @param models Array of models to select for display\r\n   * @returns The newly constructed ModelSelector element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, models: Id64Array): ModelSelector {\r\n    const modelSelectorProps: ModelSelectorProps = {\r\n      classFullName: this.classFullName,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      model: definitionModelId,\r\n      models,\r\n      isPrivate: false,\r\n    };\r\n    return new ModelSelector(modelSelectorProps, iModelDb);\r\n  }\r\n  /**\r\n   * Insert a ModelSelector to select which Models are displayed by a ViewDefinition.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new ModelSelector into this DefinitionModel\r\n   * @param name The name/CodeValue of the ModelSelector\r\n   * @param models Array of models to select for display\r\n   * @returns The Id of the newly inserted ModelSelector element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, models: Id64Array): Id64String {\r\n    const modelSelector = this.create(iModelDb, definitionModelId, name, models);\r\n    return iModelDb.elements.insertElement(modelSelector.toJSON());\r\n  }\r\n}\r\n\r\n/** Holds a list of Ids of Categories to be displayed in a view.\r\n * @see [CategorySelectorState]($frontend)\r\n * See [how to create a CategorySelector]$(docs/learning/backend/CreateElements.md#CategorySelector).\r\n * @public\r\n */\r\nexport class CategorySelector extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"CategorySelector\"; }\r\n  /** The array of element Ids of the Categories selected by this CategorySelector */\r\n  public categories: Id64String[];\r\n  /** @internal */\r\n  constructor(props: CategorySelectorProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.categories = props.categories;\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): CategorySelectorProps {\r\n    const val = super.toJSON() as CategorySelectorProps;\r\n    val.categories = this.categories;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    this.categories.forEach((categoryId: Id64String) => referenceIds.addElement(categoryId));\r\n  }\r\n\r\n  /** Create a Code for a CategorySelector given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the CategorySelector and provides the scope for its name.\r\n   * @param codeValue The CategorySelector name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.categorySelector);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /**\r\n   * Create a CategorySelector to select which categories are displayed by a ViewDefinition.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name of the CategorySelector\r\n   * @param categories Array of categories to select for display\r\n   * @returns The newly constructed CategorySelector element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, categories: Id64Array): CategorySelector {\r\n    const categorySelectorProps: CategorySelectorProps = {\r\n      classFullName: this.classFullName,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      model: definitionModelId,\r\n      categories,\r\n      isPrivate: false,\r\n    };\r\n    return new CategorySelector(categorySelectorProps, iModelDb);\r\n  }\r\n\r\n  /**\r\n   * Insert a CategorySelector to select which categories are displayed by a ViewDefinition.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new CategorySelector into this DefinitionModel\r\n   * @param name The name of the CategorySelector\r\n   * @param categories Array of categories to select for display\r\n   * @returns The Id of the newly inserted CategorySelector element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, categories: Id64Array): Id64String {\r\n    const categorySelector = this.create(iModelDb, definitionModelId, name, categories);\r\n    return iModelDb.elements.insertElement(categorySelector.toJSON());\r\n  }\r\n}\r\n\r\n/**\r\n * The definition element for a view. ViewDefinitions specify the area/volume that is viewed, the Ids of a DisplayStyle and a CategorySelector,\r\n * plus additional view-specific parameters in their [[Element.jsonProperties]].\r\n *\r\n * Subclasses of ViewDefinition determine which model(s) are viewed.\r\n *\r\n * **Example: Obtaining the background color for a view**\r\n * ``` ts\r\n * [[include:ViewDefinition.getBackgroundColor]]\r\n * ```\r\n *\r\n * @note ViewDefinition is only available in the backend. See [ViewState]($frontend) for usage in the frontend.\r\n * @public\r\n */\r\nexport abstract class ViewDefinition extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewDefinition\"; }\r\n  /** The element Id of the [[CategorySelector]] for this ViewDefinition */\r\n  public categorySelectorId: Id64String;\r\n  /** The element Id of the [[DisplayStyle]] for this ViewDefinition */\r\n  public displayStyleId: Id64String;\r\n\r\n  /** @internal */\r\n  protected constructor(props: ViewDefinitionProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n\r\n    this.categorySelectorId = Id64.fromJSON(props.categorySelectorId);\r\n    if (!Id64.isValid(this.categorySelectorId))\r\n      throw new IModelError(IModelStatus.BadArg, `categorySelectorId is invalid`);\r\n\r\n    this.displayStyleId = Id64.fromJSON(props.displayStyleId);\r\n    if (!Id64.isValid(this.displayStyleId))\r\n      throw new IModelError(IModelStatus.BadArg, `displayStyleId is invalid`);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ViewDefinitionProps {\r\n    const json = super.toJSON() as ViewDefinitionProps;\r\n    json.categorySelectorId = this.categorySelectorId;\r\n    json.displayStyleId = this.displayStyleId;\r\n    return json;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.categorySelectorId);\r\n    referenceIds.addElement(this.displayStyleId);\r\n    const acsId: Id64String = this.getAuxiliaryCoordinateSystemId();\r\n    if (Id64.isValidId64(acsId)) {\r\n      referenceIds.addElement(acsId);\r\n    }\r\n  }\r\n\r\n  /** @beta */\r\n  public static override readonly requiredReferenceKeys: ReadonlyArray<string> = [...super.requiredReferenceKeys, \"categorySelectorId\", \"displayStyleId\"];\r\n  /** @alpha */\r\n  public static override readonly requiredReferenceKeyTypeMap: Record<string, ConcreteEntityTypes> = {\r\n    ...super.requiredReferenceKeyTypeMap,\r\n    categorySelectorId: ConcreteEntityTypes.Element,\r\n    displayStyleId: ConcreteEntityTypes.Element,\r\n  };\r\n\r\n  /** @internal */\r\n  protected static override onCloned(context: IModelElementCloneContext, sourceElementProps: ViewDefinitionProps, targetElementProps: ViewDefinitionProps): void {\r\n    super.onCloned(context, sourceElementProps, targetElementProps);\r\n    if (context.isBetweenIModels && targetElementProps.jsonProperties && targetElementProps.jsonProperties.viewDetails) {\r\n      const acsId: Id64String = Id64.fromJSON(targetElementProps.jsonProperties.viewDetails.acs);\r\n      if (Id64.isValidId64(acsId)) {\r\n        targetElementProps.jsonProperties.viewDetails.acs = context.findTargetElementId(acsId);\r\n      }\r\n    }\r\n  }\r\n\r\n  /** Type guard for `instanceof ViewDefinition3d`  */\r\n  public isView3d(): this is ViewDefinition3d { return this instanceof ViewDefinition3d; }\r\n  /** Type guard for 'instanceof ViewDefinition2d` */\r\n  public isView2d(): this is ViewDefinition2d { return this instanceof ViewDefinition2d; }\r\n  /** Type guard for `instanceof SpatialViewDefinition` */\r\n  public isSpatialView(): this is SpatialViewDefinition { return this instanceof SpatialViewDefinition; }\r\n  /** Type guard for 'instanceof DrawingViewDefinition' */\r\n  public isDrawingView(): this is DrawingViewDefinition { return this instanceof DrawingViewDefinition; }\r\n\r\n  /** Load this view's DisplayStyle from the IModelDb. */\r\n  public loadDisplayStyle(): DisplayStyle { return this.iModel.elements.getElement<DisplayStyle>(this.displayStyleId); }\r\n\r\n  /** Load this view's CategorySelector from the IModelDb. */\r\n  public loadCategorySelector(): CategorySelector { return this.iModel.elements.getElement<CategorySelector>(this.categorySelectorId); }\r\n\r\n  /** Provides access to optional detail settings for this view. */\r\n  public abstract get details(): ViewDetails;\r\n\r\n  /** The Id of the AuxiliaryCoordinateSystem for this ViewDefinition, or an invalid Id if no ACS is defined. */\r\n  public getAuxiliaryCoordinateSystemId(): Id64String {\r\n    return this.details.auxiliaryCoordinateSystemId;\r\n  }\r\n\r\n  /** Set or clear the AuxiliaryCoordinateSystem for this ViewDefinition.\r\n   * @param acsId The Id of the new AuxiliaryCoordinateSystem. If `Id64.invalid` is passed, then no AuxiliaryCoordinateSystem will be used.\r\n   */\r\n  public setAuxiliaryCoordinateSystemId(acsId: Id64String) {\r\n    this.details.auxiliaryCoordinateSystemId = acsId;\r\n  }\r\n\r\n  /** Create a Code for a ViewDefinition given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel to contain the ViewDefinition and provides the scope for its name.\r\n   * @param codeValue The ViewDefinition name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.viewDefinition);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** Defines a view of one or more 3d models.\r\n * @public\r\n */\r\nexport abstract class ViewDefinition3d extends ViewDefinition {\r\n  private readonly _details: ViewDetails3d;\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewDefinition3d\"; }\r\n  /** If true, camera is used. Otherwise, use an orthographic projection. */\r\n  public cameraOn: boolean;\r\n  /** The lower left back corner of the view frustum. */\r\n  public origin: Point3d;\r\n  /** The extent (size) of the view frustum, in meters, along its x,y,z axes. */\r\n  public extents: Vector3d;\r\n  /** Rotation from world coordinates to view coordinates. */\r\n  public angles: YawPitchRollAngles;\r\n  /** The camera used for this view, if `cameraOn` is true. */\r\n  public camera: Camera;\r\n\r\n  /** @internal */\r\n  public constructor(props: ViewDefinition3dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.cameraOn = JsonUtils.asBool(props.cameraOn);\r\n    this.origin = Point3d.fromJSON(props.origin);\r\n    this.extents = Vector3d.fromJSON(props.extents);\r\n    this.angles = YawPitchRollAngles.fromJSON(props.angles);\r\n    this.camera = new Camera(props.camera);\r\n    this._details = new ViewDetails3d(this.jsonProperties);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ViewDefinition3dProps {\r\n    const val = super.toJSON() as ViewDefinition3dProps;\r\n    val.cameraOn = this.cameraOn;\r\n    val.origin = this.origin;\r\n    val.extents = this.extents;\r\n    val.angles = this.angles;\r\n    val.camera = this.camera;\r\n    return val;\r\n  }\r\n\r\n  /** Provides access to optional detail settings for this view. */\r\n  public get details(): ViewDetails3d { return this._details; }\r\n\r\n  /** Load this view's DisplayStyle3d from the IModelDb. */\r\n  public loadDisplayStyle3d(): DisplayStyle3d { return this.iModel.elements.getElement<DisplayStyle3d>(this.displayStyleId); }\r\n}\r\n\r\n/** Defines a view of one or more SpatialModels.\r\n * The list of viewed models is stored by the ModelSelector.\r\n *\r\n * This is how a SpatialViewDefinition selects the elements to display:\r\n *\r\n *  SpatialViewDefinition\r\n *    * ModelSelector\r\n *        * ModelIds  -------> SpatialModels    <----------GeometricElement3d.Model\r\n *    * CategorySelector\r\n *        * CategoryIds -----> SpatialCategories <----------GeometricElement3d.Category\r\n * @public\r\n */\r\nexport class SpatialViewDefinition extends ViewDefinition3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SpatialViewDefinition\"; }\r\n  /** The Id of the [[ModelSelector]] for this SpatialViewDefinition. */\r\n  public modelSelectorId: Id64String;\r\n\r\n  /** @internal */\r\n  public constructor(props: SpatialViewDefinitionProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.modelSelectorId = Id64.fromJSON(props.modelSelectorId);\r\n    if (!Id64.isValid(this.modelSelectorId))\r\n      throw new IModelError(IModelStatus.BadArg, `modelSelectorId is invalid`);\r\n  }\r\n\r\n  /** Construct a SpatialViewDefinition from its JSON representation. */\r\n  public static fromJSON(props: Omit<SpatialViewDefinitionProps, \"classFullName\">, iModel: IModelDb) {\r\n    return new SpatialViewDefinition({ ...props, classFullName: this.classFullName }, iModel);\r\n  }\r\n\r\n  /** Convert this view to its JSON representation. */\r\n  public override toJSON(): SpatialViewDefinitionProps {\r\n    const json = super.toJSON() as SpatialViewDefinitionProps;\r\n    json.modelSelectorId = this.modelSelectorId;\r\n    return json;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.modelSelectorId);\r\n  }\r\n\r\n  /** @beta */\r\n  public static override readonly requiredReferenceKeys: ReadonlyArray<string> = [...super.requiredReferenceKeys, \"modelSelectorId\"];\r\n\r\n  /** @alpha */\r\n  public static override readonly requiredReferenceKeyTypeMap: Record<string, ConcreteEntityTypes> = {\r\n    ...super.requiredReferenceKeyTypeMap,\r\n    modelSelectorId: ConcreteEntityTypes.Element,\r\n  };\r\n\r\n  /** Load this view's ModelSelector from the IModelDb. */\r\n  public loadModelSelector(): ModelSelector { return this.iModel.elements.getElement<ModelSelector>(this.modelSelectorId); }\r\n  /**\r\n   * Create a SpatialViewDefinition with the camera turned on.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @param cameraAngle Camera angle in radians.\r\n   * @returns The newly constructed SpatialViewDefinition element\r\n   * @throws [[IModelError]] if there is a problem creating the view\r\n   */\r\n  public static createWithCamera(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso, cameraAngle = Angle.piOver2Radians): SpatialViewDefinition {\r\n    const rotation = Matrix3d.createStandardWorldToView(standardView);\r\n    const angles = YawPitchRollAngles.createFromMatrix3d(rotation);\r\n    const rotationTransform = Transform.createOriginAndMatrix(undefined, rotation);\r\n    const rotatedRange = rotationTransform.multiplyRange(range);\r\n    const cameraDistance = 2 * (rotatedRange.diagonal().magnitudeXY() / 2.0) / Math.tan(cameraAngle / 2.0);\r\n    const cameraLocation = rotatedRange.diagonalFractionToPoint(.5);    // Start at center.\r\n    cameraLocation.z += cameraDistance;                                 // Back up by camera distance.\r\n    rotation.multiplyTransposeVectorInPlace(cameraLocation);\r\n\r\n    const viewDefinitionProps: SpatialViewDefinitionProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      modelSelectorId,\r\n      categorySelectorId,\r\n      displayStyleId,\r\n      origin: rotation.multiplyTransposeXYZ(rotatedRange.low.x, rotatedRange.low.y, rotatedRange.low.z),\r\n      extents: rotatedRange.diagonal(),\r\n      angles,\r\n      cameraOn: true,\r\n      camera: { lens: { radians: cameraAngle }, focusDist: cameraDistance, eye: cameraLocation },\r\n    };\r\n\r\n    return new SpatialViewDefinition(viewDefinitionProps, iModelDb);\r\n  }\r\n  /**\r\n   * Insert an SpatialViewDefinition with the camera turned on.\r\n   * @see [[createWithCamera]] for details.\r\n   * @returns The Id of the newly inserted SpatialViewDefinition element\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insertWithCamera(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso, cameraAngle = Angle.piOver2Radians): Id64String {\r\n    const viewDefinition = this.createWithCamera(iModelDb, definitionModelId, name, modelSelectorId, categorySelectorId, displayStyleId, range, standardView, cameraAngle);\r\n    return iModelDb.elements.insertElement(viewDefinition.toJSON());\r\n  }\r\n}\r\n\r\n/** Defines a spatial view that displays geometry on the image plane using a parallel orthographic projection.\r\n * See [how to create a OrthographicViewDefinition]$(docs/learning/backend/CreateElements.md#OrthographicViewDefinition).\r\n * @public\r\n */\r\nexport class OrthographicViewDefinition extends SpatialViewDefinition {\r\n  /** @internal */\r\n  public static override get className(): string { return \"OrthographicViewDefinition\"; }\r\n  constructor(props: SpatialViewDefinitionProps, iModel: IModelDb) { super(props, iModel); }\r\n  /**\r\n   * Create an OrthographicViewDefinition\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @returns The newly constructed OrthographicViewDefinition element\r\n   * @throws [[IModelError]] if there is a problem creating the view\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso): OrthographicViewDefinition {\r\n    const rotation = Matrix3d.createStandardWorldToView(standardView);\r\n    const angles = YawPitchRollAngles.createFromMatrix3d(rotation);\r\n    const rotationTransform = Transform.createOriginAndMatrix(undefined, rotation);\r\n    const rotatedRange = rotationTransform.multiplyRange(range);\r\n    const viewDefinitionProps: SpatialViewDefinitionProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      modelSelectorId,\r\n      categorySelectorId,\r\n      displayStyleId,\r\n      origin: rotation.multiplyTransposeXYZ(rotatedRange.low.x, rotatedRange.low.y, rotatedRange.low.z),\r\n      extents: rotatedRange.diagonal(),\r\n      angles,\r\n      cameraOn: false,\r\n      camera: new Camera(), // not used when cameraOn === false\r\n    };\r\n    return new OrthographicViewDefinition(viewDefinitionProps, iModelDb);\r\n  }\r\n\r\n  /**\r\n   * Insert an OrthographicViewDefinition\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new OrthographicViewDefinition into this DefinitionModel\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @returns The Id of the newly inserted OrthographicViewDefinition element\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso): Id64String {\r\n    const viewDefinition = this.create(iModelDb, definitionModelId, name, modelSelectorId, categorySelectorId, displayStyleId, range, standardView);\r\n    return iModelDb.elements.insertElement(viewDefinition.toJSON());\r\n  }\r\n\r\n  /** Set a new viewed range without changing the rotation or any other properties. */\r\n  public setRange(range: Range3d): void {\r\n    const rotation = this.angles.toMatrix3d();\r\n    const rotationTransform = Transform.createOriginAndMatrix(undefined, rotation);\r\n    const rotatedRange = rotationTransform.multiplyRange(range);\r\n    this.origin = Point3d.createFrom(rotation.multiplyTransposeXYZ(rotatedRange.low.x, rotatedRange.low.y, rotatedRange.low.z));\r\n    this.extents = rotatedRange.diagonal();\r\n  }\r\n}\r\n\r\n/** Defines a view of a single 2d model. Each 2d model has its own coordinate system, so only one may appear per view.\r\n * @public\r\n */\r\nexport class ViewDefinition2d extends ViewDefinition {\r\n  private readonly _details: ViewDetails;\r\n\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewDefinition2d\"; }\r\n  /** The Id of the Model displayed by this view. */\r\n  public baseModelId: Id64String;\r\n  /** The lower-left corner of this view in Model coordinates. */\r\n  public origin: Point2d;\r\n  /** The delta (size) of this view, in meters, aligned with view x,y. */\r\n  public delta: Point2d;\r\n  /** The rotation of this view. */\r\n  public angle: Angle;\r\n\r\n  /** @internal */\r\n  public constructor(props: ViewDefinition2dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.baseModelId = Id64.fromJSON(props.baseModelId);\r\n    this.origin = Point2d.fromJSON(props.origin);\r\n    this.delta = Point2d.fromJSON(props.delta);\r\n    this.angle = Angle.fromJSON(props.angle);\r\n    this._details = new ViewDetails(this.jsonProperties);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ViewDefinition2dProps {\r\n    const val = super.toJSON() as ViewDefinition2dProps;\r\n    val.baseModelId = this.baseModelId;\r\n    val.origin = this.origin;\r\n    val.delta = this.delta;\r\n    val.angle = this.angle;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.baseModelId);\r\n  }\r\n\r\n  /** Provides access to optional detail settings for this view. */\r\n  public get details(): ViewDetails { return this._details; }\r\n\r\n  /** Load this view's DisplayStyle2d from the IModelDb. */\r\n  public loadDisplayStyle2d(): DisplayStyle2d { return this.iModel.elements.getElement<DisplayStyle2d>(this.displayStyleId); }\r\n}\r\n\r\n/** Defines a view of a [[DrawingModel]].\r\n * @public\r\n */\r\nexport class DrawingViewDefinition extends ViewDefinition2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"DrawingViewDefinition\"; }\r\n  /** @internal */\r\n  public constructor(props: ViewDefinition2dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n  }\r\n\r\n  /** Create a DrawingViewDefinition\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param baseModelId The base [[DrawingModel]]\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle2d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @throws [[IModelError]] if there is a problem creating the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, baseModelId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range2d): DrawingViewDefinition {\r\n    const viewDefinitionProps: ViewDefinition2dProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      baseModelId,\r\n      categorySelectorId,\r\n      displayStyleId,\r\n      origin: { x: range.low.x, y: range.low.y },\r\n      delta: range.diagonal(),\r\n      angle: 0,\r\n    };\r\n    return new DrawingViewDefinition(viewDefinitionProps, iModelDb);\r\n  }\r\n\r\n  /** Insert a DrawingViewDefinition\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new DrawingViewDefinition into this [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param baseModelId The base [[DrawingModel]]\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle2d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, baseModelId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range2d): Id64String {\r\n    const viewDefinition = this.create(iModelDb, definitionModelId, name, baseModelId, categorySelectorId, displayStyleId, range);\r\n    return iModelDb.elements.insertElement(viewDefinition.toJSON());\r\n  }\r\n}\r\n\r\n/** Defines a view of a [[SheetModel]].\r\n * @public\r\n */\r\nexport class SheetViewDefinition extends ViewDefinition2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SheetViewDefinition\"; }\r\n}\r\n\r\n/** A ViewDefinition used to display a 2d template model.\r\n * @internal\r\n */\r\nexport class TemplateViewDefinition2d extends ViewDefinition2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"TemplateViewDefinition2d\"; }\r\n}\r\n\r\n/** A ViewDefinition used to display a 3d template model.\r\n * @internal\r\n */\r\nexport class TemplateViewDefinition3d extends ViewDefinition3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"TemplateViewDefinition3d\"; }\r\n}\r\n\r\n/** An auxiliary coordinate system element. Auxiliary coordinate systems can be used by views to show\r\n * coordinate information in different units and/or orientations.\r\n * @public\r\n */\r\nexport abstract class AuxCoordSystem extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystem\"; }\r\n  public type!: number;\r\n  public description?: string;\r\n  public constructor(props: AuxCoordSystemProps, iModel: IModelDb) { super(props, iModel); }\r\n}\r\n\r\n/** A 2d auxiliary coordinate system.\r\n * @public\r\n */\r\nexport class AuxCoordSystem2d extends AuxCoordSystem {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystem2d\"; }\r\n  public origin?: Point2d;\r\n  public angle!: number;\r\n  public constructor(props: AuxCoordSystem2dProps, iModel: IModelDb) { super(props, iModel); }\r\n\r\n  /** Create a Code for a AuxCoordSystem2d element given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the AuxCoordSystem2d element and provides the scope for its name.\r\n   * @param codeValue The AuxCoordSystem2d name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.auxCoordSystem2d);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** A 3d auxiliary coordinate system.\r\n * @public\r\n */\r\nexport class AuxCoordSystem3d extends AuxCoordSystem {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystem3d\"; }\r\n  public origin?: Point3d;\r\n  public yaw!: number;\r\n  public pitch!: number;\r\n  public roll!: number;\r\n  public constructor(props: AuxCoordSystem3dProps, iModel: IModelDb) { super(props, iModel); }\r\n\r\n  /** Create a Code for a AuxCoordSystem3d element given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the AuxCoordSystem3d element and provides the scope for its name.\r\n   * @param codeValue The AuxCoordSystem3d name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.auxCoordSystem3d);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** A spatial auxiliary coordinate system.\r\n * @public\r\n */\r\nexport class AuxCoordSystemSpatial extends AuxCoordSystem3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystemSpatial\"; }\r\n  /** Create a Code for a AuxCoordSystemSpatial element given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the AuxCoordSystemSpatial element and provides the scope for its name.\r\n   * @param codeValue The AuxCoordSystemSpatial name\r\n   */\r\n  public static override createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.auxCoordSystemSpatial);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** Represents an *attachment* of a [[ViewDefinition]] to a [[Sheet]].\r\n * @public\r\n */\r\nexport class ViewAttachment extends GraphicalElement2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewAttachment\"; }\r\n  public view: RelatedElement;\r\n  public constructor(props: ViewAttachmentProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.view = new RelatedElement(props.view);\r\n    // ###NOTE: scale, displayPriority, and clipping vectors are stored in ViewAttachmentProps.jsonProperties.\r\n  }\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.view.id);\r\n  }\r\n}\r\n\r\n/** The position in space of a Light.\r\n * @internal\r\n */\r\nexport class LightLocation extends SpatialLocationElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"LightLocation\"; }\r\n  /** Whether this light is currently turned on. */\r\n  public enabled!: boolean;\r\n  /** @internal */\r\n  constructor(props: LightLocationProps, iModel: IModelDb) { super(props, iModel); }\r\n}\r\n"]}

package/lib/cjs/rpc/tracing.js

@@ -42,8 +42,7 @@ class RpcTrace {
     }
     /** Start the processing of an RpcActivity inside an OpenTelemetry span */
     static async runWithSpan(activity, fn) {
-        var _a;
-        return core_bentley_1.Tracing.withSpan((_a = activity.rpcMethod) !== null && _a !== void 0 ? _a : "unknown RPC method", async () => RpcTrace.run(activity, fn), {
+        return core_bentley_1.Tracing.withSpan(activity.rpcMethod ?? "unknown RPC method", async () => RpcTrace.run(activity, fn), {
             attributes: { ...core_common_1.RpcInvocation.sanitizeForLog(activity) },
             kind: core_bentley_1.SpanKind.SERVER,
         });