@itwin/core-frontend 5.0.0-dev.57 → 5.0.0-dev.59

package/lib/esm/internal/tile/IModelTileRequestChannels.js

@@ -0,0 +1,153 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Tiles
+ */
+import { assert, compareStrings, SortedArray } from "@itwin/core-bentley";
+import { IModelApp } from "../../IModelApp";
+import { IpcApp } from "../../IpcApp";
+import { IModelTile, TileRequestChannel } from "../../tile/internal";
+/** Handles requests to the cloud storage tile cache, if one is configured. If a tile's content is not found in the cache, subsequent requests for the same tile will
+ * use the IModelTileChannel instead.
+ */
+class CloudStorageCacheChannel extends TileRequestChannel {
+    async requestContent(tile) {
+        assert(tile instanceof IModelTile);
+        return IModelApp.tileAdmin.requestCachedTileContent(tile);
+    }
+    onNoContent(request) {
+        assert(request.tile instanceof IModelTile);
+        request.tile.requestChannel = IModelApp.tileAdmin.channels.iModelChannels.rpc;
+        ++this._statistics.totalCacheMisses;
+        return true;
+    }
+}
+/** For an [[IpcApp]], allows backend tile generation requests in progress to be canceled. */
+class IModelTileChannel extends TileRequestChannel {
+    _canceled = new Map();
+    onActiveRequestCanceled(request) {
+        const tree = request.tile.tree;
+        let entry = this._canceled.get(tree.iModel);
+        if (!entry)
+            this._canceled.set(tree.iModel, entry = new Map());
+        let ids = entry.get(tree.id);
+        if (!ids)
+            entry.set(tree.id, ids = new Set());
+        ids.add(request.tile.contentId);
+    }
+    processCancellations() {
+        for (const [imodel, entries] of this._canceled) {
+            const treeContentIds = [];
+            for (const [treeId, tileIds] of entries) {
+                const contentIds = Array.from(tileIds);
+                treeContentIds.push({ treeId, contentIds });
+                this._statistics.totalAbortedRequests += contentIds.length;
+            }
+            // eslint-disable-next-line @typescript-eslint/no-floating-promises
+            IpcApp.appFunctionIpc.cancelTileContentRequests(imodel.getRpcProps(), treeContentIds);
+        }
+        this._canceled.clear();
+    }
+    onIModelClosed(imodel) {
+        this._canceled.delete(imodel);
+    }
+}
+/** If TileAdmin.Props.cacheTileMetadata is true, then this is the first channel through which we request content for an IModelTile.
+ * It serves a niche purpose: a tile pre-generation agent that wants to ensure that every tile selected during interaction with the application
+ * has its tile generated and cached in cloud storage. This agent might request thousands of tiles in sequence, causing a given tile to be discarded
+ * and reloaded many times. To avoid pointlessly reloading tiles whose contents have already been generated, this channel caches the metadata for each tile;
+ * on subsequent requests for the same tile, it produces the metadata and an empty RenderGraphic.
+ */
+class IModelTileMetadataCacheChannel extends TileRequestChannel {
+    _cacheByIModel = new Map();
+    constructor() {
+        super("itwinjs-imodel-metadata-cache", 100);
+    }
+    onNoContent(request) {
+        assert(request.tile instanceof IModelTile);
+        const channels = IModelApp.tileAdmin.channels.iModelChannels;
+        request.tile.requestChannel = channels.cloudStorage ?? channels.rpc;
+        return true;
+    }
+    async requestContent(tile) {
+        assert(tile instanceof IModelTile);
+        const content = this.getCachedContent(tile);
+        return content ? { content } : undefined;
+    }
+    getCachedContent(tile) {
+        const cached = this._cacheByIModel.get(tile.iModel)?.get(tile.tree)?.findEquivalent((x) => compareStrings(x.contentId, tile.contentId));
+        if (!cached)
+            return undefined;
+        const content = {
+            ...cached,
+            graphic: cached.hasGraphic ? IModelApp.renderSystem.createGraphicList([]) : undefined,
+            contentRange: cached.contentRange?.clone(),
+        };
+        return content;
+    }
+    onIModelClosed(imodel) {
+        this._cacheByIModel.delete(imodel);
+    }
+    registerChannel(channel) {
+        channel.contentCallback = (tile, content) => this.cache(tile, content);
+    }
+    cache(tile, content) {
+        assert(tile instanceof IModelTile);
+        let trees = this._cacheByIModel.get(tile.iModel);
+        if (!trees)
+            this._cacheByIModel.set(tile.iModel, trees = new Map());
+        let list = trees.get(tile.tree);
+        if (!list)
+            trees.set(tile.tree, list = new SortedArray((lhs, rhs) => compareStrings(lhs.contentId, rhs.contentId)));
+        assert(undefined === list.findEquivalent((x) => compareStrings(x.contentId, tile.contentId)));
+        list.insert({
+            contentId: tile.contentId,
+            hasGraphic: undefined !== content.graphic,
+            contentRange: content.contentRange?.clone(),
+            isLeaf: content.isLeaf,
+            sizeMultiplier: content.sizeMultiplier,
+            emptySubRangeMask: content.emptySubRangeMask,
+        });
+    }
+}
+/** TileRequestChannels used for requesting content for IModelTiles.
+ */
+export class IModelTileRequestChannels {
+    _cloudStorage;
+    _contentCache;
+    rpc;
+    constructor(args) {
+        const channelName = "itwinjs-tile-rpc";
+        this.rpc = args.usesHttp ? new TileRequestChannel(channelName, args.concurrency) : new IModelTileChannel(channelName, args.concurrency);
+        if (args.cacheMetadata) {
+            this._contentCache = new IModelTileMetadataCacheChannel();
+            this._contentCache.registerChannel(this.rpc);
+        }
+        this._cloudStorage = new CloudStorageCacheChannel("itwinjs-cloud-cache", args.cacheConcurrency);
+        this._contentCache?.registerChannel(this._cloudStorage);
+    }
+    get cloudStorage() {
+        return this._cloudStorage;
+    }
+    [Symbol.iterator]() {
+        const channels = [this.rpc];
+        if (this._cloudStorage)
+            channels.push(this._cloudStorage);
+        if (this._contentCache)
+            channels.push(this._contentCache);
+        return channels[Symbol.iterator]();
+    }
+    setRpcConcurrency(concurrency) {
+        this.rpc.concurrency = concurrency;
+    }
+    getChannelForTile(tile) {
+        return tile.requestChannel || this._contentCache || this._cloudStorage || this.rpc;
+    }
+    /** Strictly for tests. */
+    getCachedContent(tile) {
+        return this._contentCache?.getCachedContent(tile);
+    }
+}
+//# sourceMappingURL=IModelTileRequestChannels.js.map

package/lib/esm/internal/tile/IModelTileRequestChannels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IModelTileRequestChannels.js","sourceRoot":"","sources":["../../../../src/internal/tile/IModelTileRequestChannels.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Tiles\n */\n\nimport { assert, compareStrings, SortedArray } from \"@itwin/core-bentley\";\nimport { TileTreeContentIds } from \"@itwin/core-common\";\nimport { IModelApp } from \"../../IModelApp\";\nimport { IpcApp } from \"../../IpcApp\";\nimport { IModelConnection } from \"../../IModelConnection\";\nimport { IModelTile, IModelTileContent, Tile, TileRequest, TileRequestChannel, TileTree } from \"../../tile/internal\";\n\n/** Handles requests to the cloud storage tile cache, if one is configured. If a tile's content is not found in the cache, subsequent requests for the same tile will\n * use the IModelTileChannel instead.\n */\nclass CloudStorageCacheChannel extends TileRequestChannel {\n  public override async requestContent(tile: Tile): Promise<TileRequest.Response> {\n    assert(tile instanceof IModelTile);\n    return IModelApp.tileAdmin.requestCachedTileContent(tile);\n  }\n\n  public override onNoContent(request: TileRequest): boolean {\n    assert(request.tile instanceof IModelTile);\n    request.tile.requestChannel = IModelApp.tileAdmin.channels.iModelChannels.rpc;\n    ++this._statistics.totalCacheMisses;\n    return true;\n  }\n}\n\n/** For an [[IpcApp]], allows backend tile generation requests in progress to be canceled. */\nclass IModelTileChannel extends TileRequestChannel {\n  private readonly _canceled = new Map<IModelConnection, Map<string, Set<string>>>();\n\n  public override onActiveRequestCanceled(request: TileRequest): void {\n    const tree = request.tile.tree;\n    let entry = this._canceled.get(tree.iModel);\n    if (!entry)\n      this._canceled.set(tree.iModel, entry = new Map<string, Set<string>>());\n\n    let ids = entry.get(tree.id);\n    if (!ids)\n      entry.set(tree.id, ids = new Set<string>());\n\n    ids.add(request.tile.contentId);\n  }\n\n  public override processCancellations(): void {\n    for (const [imodel, entries] of this._canceled) {\n      const treeContentIds: TileTreeContentIds[] = [];\n      for (const [treeId, tileIds] of entries) {\n        const contentIds = Array.from(tileIds);\n        treeContentIds.push({ treeId, contentIds });\n        this._statistics.totalAbortedRequests += contentIds.length;\n      }\n\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      IpcApp.appFunctionIpc.cancelTileContentRequests(imodel.getRpcProps(), treeContentIds);\n    }\n\n    this._canceled.clear();\n  }\n\n  public override onIModelClosed(imodel: IModelConnection): void {\n    this._canceled.delete(imodel);\n  }\n}\n\ninterface CachedContent extends Omit<IModelTileContent, \"graphic\"> {\n  contentId: string;\n  hasGraphic: boolean;\n}\n\n/** If TileAdmin.Props.cacheTileMetadata is true, then this is the first channel through which we request content for an IModelTile.\n * It serves a niche purpose: a tile pre-generation agent that wants to ensure that every tile selected during interaction with the application\n * has its tile generated and cached in cloud storage. This agent might request thousands of tiles in sequence, causing a given tile to be discarded\n * and reloaded many times. To avoid pointlessly reloading tiles whose contents have already been generated, this channel caches the metadata for each tile;\n * on subsequent requests for the same tile, it produces the metadata and an empty RenderGraphic.\n */\nclass IModelTileMetadataCacheChannel extends TileRequestChannel {\n  private readonly _cacheByIModel = new Map<IModelConnection, Map<TileTree, SortedArray<CachedContent>>>();\n\n  public constructor() {\n    super(\"itwinjs-imodel-metadata-cache\", 100);\n  }\n\n  public override onNoContent(request: TileRequest): boolean {\n    assert(request.tile instanceof IModelTile);\n    const channels = IModelApp.tileAdmin.channels.iModelChannels;\n    request.tile.requestChannel = channels.cloudStorage ?? channels.rpc;\n    return true;\n  }\n\n  public override async requestContent(tile: Tile): Promise<TileRequest.Response> {\n    assert(tile instanceof IModelTile);\n    const content = this.getCachedContent(tile);\n    return content ? { content } : undefined;\n  }\n\n  public getCachedContent(tile: IModelTile): IModelTileContent | undefined {\n    const cached = this._cacheByIModel.get(tile.iModel)?.get(tile.tree)?.findEquivalent((x) => compareStrings(x.contentId, tile.contentId));\n    if (!cached)\n      return undefined;\n\n    const content: IModelTileContent = {\n      ...cached,\n      graphic: cached.hasGraphic ? IModelApp.renderSystem.createGraphicList([]) : undefined,\n      contentRange: cached.contentRange?.clone(),\n    };\n\n    return content;\n  }\n\n  public override onIModelClosed(imodel: IModelConnection): void {\n    this._cacheByIModel.delete(imodel);\n  }\n\n  public registerChannel(channel: TileRequestChannel): void {\n    channel.contentCallback = (tile, content) => this.cache(tile, content);\n  }\n\n  private cache(tile: Tile, content: IModelTileContent): void {\n    assert(tile instanceof IModelTile);\n    let trees = this._cacheByIModel.get(tile.iModel);\n    if (!trees)\n      this._cacheByIModel.set(tile.iModel, trees = new Map<TileTree, SortedArray<CachedContent>>());\n\n    let list = trees.get(tile.tree);\n    if (!list)\n      trees.set(tile.tree, list = new SortedArray<CachedContent>((lhs, rhs) => compareStrings(lhs.contentId, rhs.contentId)));\n\n    assert(undefined === list.findEquivalent((x) => compareStrings(x.contentId, tile.contentId)));\n    list.insert({\n      contentId: tile.contentId,\n      hasGraphic: undefined !== content.graphic,\n      contentRange: content.contentRange?.clone(),\n      isLeaf: content.isLeaf,\n      sizeMultiplier: content.sizeMultiplier,\n      emptySubRangeMask: content.emptySubRangeMask,\n    });\n  }\n}\n\n/** TileRequestChannels used for requesting content for IModelTiles.\n */\nexport class IModelTileRequestChannels {\n  private _cloudStorage: TileRequestChannel;\n  private readonly _contentCache?: IModelTileMetadataCacheChannel;\n  public readonly rpc: TileRequestChannel;\n\n  public constructor(args: {\n    concurrency: number;\n    usesHttp: boolean;\n    cacheMetadata: boolean;\n    cacheConcurrency: number;\n  }) {\n    const channelName = \"itwinjs-tile-rpc\";\n    this.rpc = args.usesHttp ? new TileRequestChannel(channelName, args.concurrency) : new IModelTileChannel(channelName, args.concurrency);\n\n    if (args.cacheMetadata) {\n      this._contentCache = new IModelTileMetadataCacheChannel();\n      this._contentCache.registerChannel(this.rpc);\n    }\n\n    this._cloudStorage = new CloudStorageCacheChannel(\"itwinjs-cloud-cache\", args.cacheConcurrency);\n    this._contentCache?.registerChannel(this._cloudStorage);\n  }\n\n  public get cloudStorage(): TileRequestChannel {\n    return this._cloudStorage;\n  }\n\n  public [Symbol.iterator](): Iterator<TileRequestChannel> {\n    const channels = [this.rpc];\n    if (this._cloudStorage)\n      channels.push(this._cloudStorage);\n\n    if (this._contentCache)\n      channels.push(this._contentCache);\n\n    return channels[Symbol.iterator]();\n  }\n\n  public setRpcConcurrency(concurrency: number): void {\n    this.rpc.concurrency = concurrency;\n  }\n\n  public getChannelForTile(tile: IModelTile): TileRequestChannel {\n    return tile.requestChannel || this._contentCache || this._cloudStorage || this.rpc;\n  }\n\n  /** Strictly for tests. */\n  public getCachedContent(tile: IModelTile): IModelTileContent | undefined {\n    return this._contentCache?.getCachedContent(tile);\n  }\n}\n"]}

package/lib/esm/internal/tile/IModelTileTree.d.ts

@@ -0,0 +1,80 @@
+/** @packageDocumentation
+ * @module Tiles
+ */
+import { GuidString, Id64Array, Id64String } from "@itwin/core-bentley";
+import { Range3d } from "@itwin/core-geometry";
+import { BatchType, ContentIdProvider, EdgeOptions, IModelTileTreeId, IModelTileTreeProps, RenderSchedule, TileProps } from "@itwin/core-common";
+import { IModelConnection } from "../../IModelConnection";
+import { ImdlDecoder, IModelTile, Tile, TileDrawArgs, TileLoadPriority, TileTree, TileTreeParams } from "../../tile/internal";
+export interface IModelTileTreeOptions {
+    readonly allowInstancing: boolean;
+    readonly edges: EdgeOptions | false;
+    readonly batchType: BatchType;
+    readonly is3d: boolean;
+    readonly timeline: RenderSchedule.ModelTimeline | undefined;
+}
+/** Parameters used to construct an [[IModelTileTree]]
+ */
+export interface IModelTileTreeParams extends TileTreeParams {
+    rootTile: TileProps;
+    contentIdQualifier?: string;
+    geometryGuid?: GuidString;
+    maxInitialTilesToSkip?: number;
+    formatVersion?: number;
+    tileScreenSize: number;
+    options: IModelTileTreeOptions;
+    transformNodeRanges?: Map<number, Range3d>;
+}
+export declare function iModelTileTreeParamsFromJSON(props: IModelTileTreeProps, iModel: IModelConnection, modelId: Id64String, options: IModelTileTreeOptions): IModelTileTreeParams;
+/** The root tile for an [[IModelTileTree]].
+ */
+export type RootIModelTile = Tile & {
+    tileScreenSize: number;
+    updateDynamicRange: (childTile: Tile) => void;
+};
+/** A TileTree whose contents are derived from geometry stored in a Model in an IModelDb.
+ */
+export declare class IModelTileTree extends TileTree {
+    readonly decoder: ImdlDecoder;
+    private readonly _rootTile;
+    private readonly _options;
+    private readonly _transformNodeRanges?;
+    readonly contentIdQualifier?: string;
+    readonly geometryGuid?: string;
+    readonly maxTilesToSkip: number;
+    readonly maxInitialTilesToSkip: number;
+    readonly contentIdProvider: ContentIdProvider;
+    readonly stringifiedSectionClip?: string;
+    readonly tileScreenSize: number;
+    readonly iModelTileTreeId: IModelTileTreeId;
+    /** Strictly for debugging/testing - forces tile selection to halt at the specified depth. */
+    debugMaxDepth?: number;
+    /** A little hacky...we must not override selectTiles(), but draw() needs to distinguish between static and dynamic tiles.
+     * So _selectTiles() puts the static tiles first in the Tile[] array, and records the number of static tiles selected, to be
+     * used by draw().
+     */
+    private _numStaticTilesSelected;
+    constructor(params: IModelTileTreeParams, treeId: IModelTileTreeId);
+    [Symbol.dispose](): void;
+    get maxDepth(): number;
+    get rootTile(): Tile;
+    /** Exposed chiefly for tests. */
+    get staticBranch(): IModelTile;
+    get is3d(): boolean;
+    get isContentUnbounded(): boolean;
+    get viewFlagOverrides(): {};
+    get batchType(): BatchType;
+    get edgeOptions(): EdgeOptions | false;
+    get timeline(): RenderSchedule.ModelTimeline | undefined;
+    get loadPriority(): TileLoadPriority;
+    protected _selectTiles(args: TileDrawArgs): Tile[];
+    draw(args: TileDrawArgs): void;
+    prune(): void;
+    /** Exposed strictly for tests. */
+    get tileState(): "static" | "dynamic" | "interactive" | "disposed";
+    /** Exposed strictly for tests. */
+    get hiddenElements(): Id64Array;
+    getTransformNodeRange(nodeId: number): Range3d | undefined;
+    get containsTransformNodes(): boolean;
+}
+//# sourceMappingURL=IModelTileTree.d.ts.map

package/lib/esm/internal/tile/IModelTileTree.d.ts.map

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

package/lib/esm/internal/tile/IModelTileTree.js

@@ -0,0 +1,342 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Tiles
+ */
+import { assert, BeTimePoint } from "@itwin/core-bentley";
+import { Range3d, Transform } from "@itwin/core-geometry";
+import { BatchType, ContentIdProvider, FeatureAppearanceProvider, } from "@itwin/core-common";
+import { IModelApp } from "../../IModelApp";
+import { GraphicalEditingScope } from "../../GraphicalEditingScope";
+import { GraphicBranch } from "../../render/GraphicBranch";
+import { acquireImdlDecoder, DynamicIModelTile, IModelTile, iModelTileParamsFromJSON, Tile, TileLoadPriority, TileTree, } from "../../tile/internal";
+// Overrides nothing.
+const viewFlagOverrides = {};
+export function iModelTileTreeParamsFromJSON(props, iModel, modelId, options) {
+    const location = Transform.fromJSON(props.location);
+    const { formatVersion, id, rootTile, contentIdQualifier, maxInitialTilesToSkip, geometryGuid } = props;
+    const tileScreenSize = props.tileScreenSize ?? 512;
+    let contentRange;
+    if (undefined !== props.contentRange)
+        contentRange = Range3d.fromJSON(props.contentRange);
+    let transformNodeRanges;
+    if (props.transformNodeRanges) {
+        transformNodeRanges = new Map();
+        for (const entry of props.transformNodeRanges)
+            transformNodeRanges.set(entry.id, Range3d.fromJSON(entry));
+    }
+    const priority = BatchType.Primary === options.batchType ? TileLoadPriority.Primary : TileLoadPriority.Classifier;
+    return {
+        formatVersion,
+        id,
+        rootTile,
+        iModel,
+        location,
+        modelId,
+        contentRange,
+        geometryGuid,
+        contentIdQualifier,
+        maxInitialTilesToSkip,
+        priority,
+        options,
+        tileScreenSize,
+        transformNodeRanges,
+    };
+}
+function findElementChangesForModel(changes, modelId) {
+    for (const change of changes)
+        if (change.id === modelId)
+            return change.elements;
+    return undefined;
+}
+/** No graphical editing scope is currently active. */
+class StaticState {
+    type = "static";
+    [Symbol.dispose];
+    constructor(root) {
+        this[Symbol.dispose] = GraphicalEditingScope.onEnter.addOnce((scope) => {
+            root.transition(new InteractiveState(scope, root));
+        });
+    }
+}
+/** A graphical editing scope is currently active, but no elements in the tile tree's model have been modified. */
+class InteractiveState {
+    type = "interactive";
+    [Symbol.dispose];
+    constructor(scope, root) {
+        const removeEndingListener = scope.onExiting.addOnce((_) => {
+            root.transition(new StaticState(root));
+        });
+        const removeGeomListener = scope.onGeometryChanges.addListener((changes, _scope) => {
+            assert(scope === _scope);
+            const elemChanges = findElementChangesForModel(changes, root.tree.modelId);
+            if (elemChanges)
+                root.transition(new DynamicState(root, elemChanges, scope));
+        });
+        this[Symbol.dispose] = () => {
+            removeEndingListener();
+            removeGeomListener();
+        };
+    }
+}
+/** Elements in the tile tree's model have been modified during the current editing scope. */
+class DynamicState {
+    type = "dynamic";
+    rootTile;
+    _dispose;
+    [Symbol.dispose]() {
+        this._dispose();
+        this.rootTile[Symbol.dispose]();
+    }
+    constructor(root, elemChanges, scope) {
+        this.rootTile = DynamicIModelTile.create(root, elemChanges);
+        const removeEndingListener = scope.onExiting.addOnce((_) => {
+            root.transition(new StaticState(root));
+        });
+        const removeGeomListener = scope.onGeometryChanges.addListener((changes, _scope) => {
+            assert(scope === _scope);
+            const elems = findElementChangesForModel(changes, root.tree.modelId);
+            if (elems)
+                this.rootTile.handleGeometryChanges(elems);
+        });
+        this._dispose = () => {
+            removeEndingListener();
+            removeGeomListener();
+        };
+    }
+}
+/** The tile tree has been disposed. */
+class DisposedState {
+    type = "disposed";
+    [Symbol.dispose]() { }
+}
+const disposedState = new DisposedState();
+/** Represents the root [[Tile]] of an [[IModelTileTree]]. The root tile has one or two direct child tiles which represent different branches of the tree:
+ *  - The static branch, containing tiles that represent the state of the model's geometry as of the beginning of the current [[GraphicalEditingScope]].
+ *  - The dynamic branch, containing tiles representing the geometry of elements that have been modified during the current [[GraphicalEditingScope]].
+ * If no editing scope is currently active, the dynamic branch does not exist, and the static branch represents the current state of all elements in the model.
+ */
+class RootTile extends Tile {
+    staticBranch;
+    _tileState;
+    _staticTreeContentRange;
+    get tileState() {
+        return this._tileState;
+    }
+    constructor(params, tree) {
+        const rootParams = {
+            ...params,
+            range: params.range.clone(),
+            contentRange: params.contentRange?.clone(),
+            isLeaf: false,
+            contentId: "",
+        };
+        super(rootParams, tree);
+        this.staticBranch = new IModelTile(params, tree);
+        this._staticTreeContentRange = tree.contentRange?.clone();
+        if (!this._contentRange)
+            this._contentRange = this.staticBranch.contentRange.clone();
+        // Determine initial state.
+        const scope = tree.iModel.isBriefcaseConnection() ? tree.iModel.editingScope : undefined;
+        if (undefined === scope) {
+            this._tileState = new StaticState(this);
+        }
+        else {
+            const changes = scope.getGeometryChangesForModel(tree.modelId);
+            this._tileState = changes ? new DynamicState(this, changes, scope) : new InteractiveState(scope, this);
+        }
+        // Load the children immediately.
+        this.setIsReady();
+        this.loadChildren();
+    }
+    [Symbol.dispose]() {
+        this.transition(disposedState);
+        super[Symbol.dispose]();
+    }
+    _loadChildren(resolve, _reject) {
+        const children = [this.staticBranch];
+        if (this._tileState.type === "dynamic")
+            children.push(this._tileState.rootTile);
+        resolve(children);
+    }
+    get channel() {
+        throw new Error("Root iModel tile has no content");
+    }
+    async requestContent(_isCanceled) {
+        assert(false, "Root iModel tile has no content");
+        return undefined;
+    }
+    async readContent(_data, _system, _isCanceled) {
+        throw new Error("Root iModel tile has no content");
+    }
+    draw(args, tiles, numStaticTiles) {
+        assert(numStaticTiles >= 0 && numStaticTiles <= tiles.length);
+        // Draw the static tiles.
+        for (let i = 0; i < numStaticTiles; i++)
+            tiles[i].drawGraphics(args);
+        if ("dynamic" !== this._tileState.type || numStaticTiles === tiles.length) {
+            if ("dynamic" === this._tileState.type)
+                args.addAppearanceProvider(this._tileState.rootTile.appearanceProvider);
+            args.drawGraphics();
+            return;
+        }
+        // We need to hide any modified elements in the static tiles. Pull their graphics into a separate branch.
+        if (!args.graphics.isEmpty) {
+            const staticBranch = new GraphicBranch();
+            for (const staticGraphic of args.graphics.entries)
+                staticBranch.add(staticGraphic);
+            let appearanceProvider = this._tileState.rootTile.appearanceProvider;
+            if (args.appearanceProvider)
+                appearanceProvider = FeatureAppearanceProvider.chain(args.appearanceProvider, appearanceProvider);
+            args.graphics.clear();
+            args.graphics.add(args.context.createGraphicBranch(staticBranch, Transform.createIdentity(), { appearanceProvider }));
+        }
+        // Draw the dynamic tiles.
+        for (let i = numStaticTiles; i < tiles.length; i++)
+            tiles[i].drawGraphics(args);
+        args.drawGraphics();
+    }
+    prune(olderThan) {
+        this.staticBranch.pruneChildren(olderThan);
+        if ("dynamic" === this._tileState.type)
+            this._tileState.rootTile.pruneChildren(olderThan);
+    }
+    transition(newState) {
+        assert(newState.type !== this._tileState.type);
+        const resetRange = "dynamic" === this._tileState.type;
+        assert(undefined !== this.children);
+        if ("dynamic" === this._tileState.type) {
+            assert(2 === this.children.length);
+            this.children.pop();
+        }
+        else if ("dynamic" === newState.type) {
+            assert(1 === this.children.length);
+            this.children.push(newState.rootTile);
+        }
+        this._tileState[Symbol.dispose]();
+        this._tileState = newState;
+        if (resetRange)
+            this.resetRange();
+    }
+    resetRange() {
+        this.staticBranch.range.clone(this.range);
+        this.staticBranch.contentRange.clone(this._contentRange);
+        if (this._staticTreeContentRange && this.tree.contentRange)
+            this._staticTreeContentRange.clone(this.tree.contentRange);
+    }
+    get tileScreenSize() {
+        return this.staticBranch.iModelTree.tileScreenSize;
+    }
+    updateDynamicRange(tile) {
+        this.resetRange();
+        if (this._staticTreeContentRange && this.tree.contentRange && !tile.contentRange.isNull)
+            this.tree.contentRange.extendRange(tile.contentRange);
+        if (!tile.range.isNull)
+            this.range.extendRange(tile.range);
+        assert(undefined !== this._contentRange);
+        if (!tile.contentRange.isNull)
+            this._contentRange.extendRange(tile.contentRange);
+    }
+}
+/** A TileTree whose contents are derived from geometry stored in a Model in an IModelDb.
+ */
+export class IModelTileTree extends TileTree {
+    decoder;
+    _rootTile;
+    _options;
+    _transformNodeRanges;
+    contentIdQualifier;
+    geometryGuid;
+    maxTilesToSkip;
+    maxInitialTilesToSkip;
+    contentIdProvider;
+    stringifiedSectionClip;
+    tileScreenSize;
+    iModelTileTreeId;
+    /** Strictly for debugging/testing - forces tile selection to halt at the specified depth. */
+    debugMaxDepth;
+    /** A little hacky...we must not override selectTiles(), but draw() needs to distinguish between static and dynamic tiles.
+     * So _selectTiles() puts the static tiles first in the Tile[] array, and records the number of static tiles selected, to be
+     * used by draw().
+     */
+    _numStaticTilesSelected = 0;
+    constructor(params, treeId) {
+        super(params);
+        this.iModelTileTreeId = treeId;
+        this.contentIdQualifier = params.contentIdQualifier;
+        this.geometryGuid = params.geometryGuid;
+        this.tileScreenSize = params.tileScreenSize;
+        if (BatchType.Primary === treeId.type)
+            this.stringifiedSectionClip = treeId.sectionCut;
+        this.maxInitialTilesToSkip = params.maxInitialTilesToSkip ?? 0;
+        this.maxTilesToSkip = IModelApp.tileAdmin.maximumLevelsToSkip;
+        this._options = params.options;
+        this._transformNodeRanges = params.transformNodeRanges;
+        this.contentIdProvider = ContentIdProvider.create(params.options.allowInstancing, IModelApp.tileAdmin, params.formatVersion);
+        params.rootTile.contentId = this.contentIdProvider.rootContentId;
+        this._rootTile = new RootTile(iModelTileParamsFromJSON(params.rootTile, undefined), this);
+        this.decoder = acquireImdlDecoder({
+            type: this.batchType,
+            omitEdges: false === this.edgeOptions,
+            timeline: this.timeline,
+            iModel: this.iModel,
+            batchModelId: this.modelId,
+            is3d: this.is3d,
+            containsTransformNodes: this.containsTransformNodes,
+            noWorker: !IModelApp.tileAdmin.decodeImdlInWorker,
+        });
+    }
+    [Symbol.dispose]() {
+        this.decoder.release();
+        super[Symbol.dispose]();
+    }
+    get maxDepth() { return 32; }
+    get rootTile() { return this._rootTile; }
+    /** Exposed chiefly for tests. */
+    get staticBranch() { return this._rootTile.staticBranch; }
+    get is3d() { return this._options.is3d; }
+    get isContentUnbounded() { return false; }
+    get viewFlagOverrides() { return viewFlagOverrides; }
+    get batchType() { return this._options.batchType; }
+    get edgeOptions() { return this._options.edges; }
+    get timeline() { return this._options.timeline; }
+    get loadPriority() {
+        // If the model has been modified, we want to prioritize keeping its graphics up to date.
+        return this.tileState === "dynamic" ? TileLoadPriority.Dynamic : super.loadPriority;
+    }
+    _selectTiles(args) {
+        args.markUsed(this._rootTile);
+        const tiles = [];
+        this._rootTile.staticBranch.selectTiles(tiles, args, 0);
+        this._numStaticTilesSelected = tiles.length;
+        if (this._rootTile.tileState.type === "dynamic")
+            this._rootTile.tileState.rootTile.selectTiles(tiles, args);
+        return tiles;
+    }
+    draw(args) {
+        const tiles = this.selectTiles(args);
+        this._rootTile.draw(args, tiles, this._numStaticTilesSelected);
+    }
+    prune() {
+        const olderThan = BeTimePoint.now().minus(this.expirationTime);
+        this._rootTile.prune(olderThan);
+    }
+    /** Exposed strictly for tests. */
+    get tileState() {
+        return this._rootTile.tileState.type;
+    }
+    /** Exposed strictly for tests. */
+    get hiddenElements() {
+        const state = this._rootTile.tileState;
+        return "dynamic" === state.type ? state.rootTile.hiddenElements : [];
+    }
+    getTransformNodeRange(nodeId) {
+        return this._transformNodeRanges?.get(nodeId);
+    }
+    get containsTransformNodes() {
+        return undefined !== this._transformNodeRanges;
+    }
+}
+//# sourceMappingURL=IModelTileTree.js.map