@itwin/frontend-tiles 4.8.0-dev.19 → 4.8.0-dev.20

package/lib/cjs/BatchedSpatialTileTreeRefs.d.ts

@@ -1,5 +1,5 @@
 import { SpatialTileTreeReferences, SpatialViewState } from "@itwin/core-frontend";
 import { ComputeSpatialTilesetBaseUrl } from "./FrontendTiles";
 /** @internal */
-export declare function createBatchedSpatialTileTreeReferences(view: SpatialViewState, computeBaseUrl: ComputeSpatialTilesetBaseUrl): SpatialTileTreeReferences;
+export declare function createBatchedSpatialTileTreeReferences(view: SpatialViewState, computeBaseUrl: ComputeSpatialTilesetBaseUrl, nopFallback?: boolean): SpatialTileTreeReferences;
 //# sourceMappingURL=BatchedSpatialTileTreeRefs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"BatchedSpatialTileTreeRefs.d.ts","sourceRoot":"","sources":["../../src/BatchedSpatialTileTreeRefs.ts"],"names":[],"mappings":"AAOA,OAAO,EAEoE,yBAAyB,EAAE,gBAAgB,EAErH,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AA0S/D,gBAAgB;AAChB,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,4BAA4B,GAAG,yBAAyB,CA0BtJ"}
+{"version":3,"file":"BatchedSpatialTileTreeRefs.d.ts","sourceRoot":"","sources":["../../src/BatchedSpatialTileTreeRefs.ts"],"names":[],"mappings":"AAOA,OAAO,EAEoE,yBAAyB,EAAE,gBAAgB,EAGrH,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAkU/D,gBAAgB;AAChB,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,4BAA4B,EAAE,WAAW,GAAE,OAAe,GAAG,yBAAyB,CA+BpL"}

package/lib/cjs/BatchedSpatialTileTreeRefs.js

@@ -179,17 +179,25 @@ class ProxyTileTreeReference extends core_frontend_1.TileTreeReference {
 // Serves as a placeholder while we asynchronously obtain the base URL for a pre-published tileset (or asynchronously determine
 // that no such tileset exists).
 class ProxySpatialTileTreeReferences {
-    constructor(view, getSpec) {
+    constructor(view, getSpec, nopFallback = false) {
         this._proxyRef = new ProxyTileTreeReference(view.iModel);
         getSpec.then((spec) => {
             if (spec) {
                 this.setTreeRefs(new BatchedSpatialTileTreeReferences(spec, view));
             }
+            else if (nopFallback) {
+                this.setTreeRefs(new EmptySpatialTileTreeReferences());
+            }
             else {
                 this.setTreeRefs((0, core_frontend_1.createSpatialTileTreeReferences)(view));
             }
         }).catch(() => {
-            this.setTreeRefs((0, core_frontend_1.createSpatialTileTreeReferences)(view));
+            if (nopFallback) {
+                this.setTreeRefs(new EmptySpatialTileTreeReferences());
+            }
+            else {
+                this.setTreeRefs((0, core_frontend_1.createSpatialTileTreeReferences)(view));
+            }
         });
     }
     setTreeRefs(refs) {
@@ -252,8 +260,20 @@ async function fetchTilesetSpec(iModel, computeBaseUrl) {
         return null;
     }
 }
+class EmptySpatialTileTreeReferences {
+    update() { }
+    setDeactivated(_modelIds, _deactivated, _refs) { }
+    attachToViewport(_args) { }
+    detachFromViewport() { }
+    collectMaskRefs(_modelIds, _maskTreeRefs) { }
+    ;
+    getModelsNotInMask(_maskModels, _useVisible) {
+        return undefined;
+    }
+    *[Symbol.iterator]() { }
+}
 /** @internal */
-function createBatchedSpatialTileTreeReferences(view, computeBaseUrl) {
+function createBatchedSpatialTileTreeReferences(view, computeBaseUrl, nopFallback = false) {
     const iModel = view.iModel;
     let entry = iModelToTilesetSpec.get(iModel);
     if (undefined === entry) {
@@ -269,11 +289,15 @@ function createBatchedSpatialTileTreeReferences(view, computeBaseUrl) {
         });
     }
     if (null === entry) {
+        // No tileset could be obtained for this iModel - use empty tile tree if requested.
+        if (nopFallback) {
+            return new EmptySpatialTileTreeReferences();
+        }
         // No tileset could be obtained for this iModel - use default tile generation instead.
         return (0, core_frontend_1.createSpatialTileTreeReferences)(view);
     }
     if (entry instanceof Promise)
-        return new ProxySpatialTileTreeReferences(view, entry);
+        return new ProxySpatialTileTreeReferences(view, entry, nopFallback);
     return new BatchedSpatialTileTreeReferences(entry, view);
 }
 exports.createBatchedSpatialTileTreeReferences = createBatchedSpatialTileTreeReferences;

package/lib/cjs/BatchedSpatialTileTreeRefs.js.map

@@ -1 +1 @@
-{"version":3,"file":"BatchedSpatialTileTreeRefs.js","sourceRoot":"","sources":["../../src/BatchedSpatialTileTreeRefs.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\nimport { Id64String, Logger, OrderedId64Iterable } from \"@itwin/core-bentley\";\nimport { RenderSchedule } from \"@itwin/core-common\";\nimport {\n  AnimationNodeId,\n  AttachToViewportArgs, createSpatialTileTreeReferences, IModelConnection, SpatialTileTreeReferences, SpatialViewState,\n  TileTreeLoadStatus, TileTreeOwner, TileTreeReference,\n} from \"@itwin/core-frontend\";\nimport {  BatchedTileTreeReference, BatchedTileTreeReferenceArgs  } from \"./BatchedTileTreeReference\";\nimport { getBatchedTileTreeOwner } from \"./BatchedTileTreeSupplier\";\nimport { BatchedModels } from \"./BatchedModels\";\nimport { ComputeSpatialTilesetBaseUrl } from \"./FrontendTiles\";\nimport { BatchedTilesetSpec } from \"./BatchedTilesetReader\";\nimport { loggerCategory } from \"./LoggerCategory\";\nimport { BatchedModelGroups } from \"./BatchedModelGroups\";\nimport { Range3d } from \"@itwin/core-geometry\";\n\n// Obtains tiles pre-published by mesh export service.\nclass BatchedSpatialTileTreeReferences implements SpatialTileTreeReferences {\n  private readonly _view: SpatialViewState;\n  private readonly _models: BatchedModels;\n  private readonly _groups: BatchedModelGroups;\n  private readonly _spec: BatchedTilesetSpec;\n  private _treeOwner: TileTreeOwner;\n  private _refs: BatchedTileTreeReference[] = [];\n  private _currentScript?: RenderSchedule.Script;\n  private _onModelSelectorChanged?: () => void;\n  /** Provides tile trees for models that are not included in the batched tile set. */\n  private readonly _excludedRefs: SpatialTileTreeReferences;\n  private _removeSceneInvalidationListener?: () => void;\n\n  public constructor(spec: BatchedTilesetSpec, view: SpatialViewState) {\n    this._view = view;\n    this._models = new BatchedModels(view, spec.models);\n    this._spec = spec;\n\n    const script = view.displayStyle.scheduleScript;\n    this._currentScript = script?.requiresBatching ? script : undefined;\n\n    const includedModels = new Set(spec.models.keys());\n    this._excludedRefs = createSpatialTileTreeReferences(view, includedModels);\n\n    this._groups = new BatchedModelGroups(view, this._currentScript, includedModels, spec.models);\n    this._treeOwner = this.getTreeOwner();\n    this.loadRefs();\n\n    this.listenForScriptChange();\n  }\n\n  private ensureLoaded(): void {\n    if (!this._groups.update())\n      return;\n\n    this._treeOwner = this.getTreeOwner();\n    this.loadRefs();\n  }\n\n  private getTreeOwner(): TileTreeOwner {\n    return getBatchedTileTreeOwner(this._view.iModel, {\n      spec: this._spec,\n      script: this._currentScript,\n      modelGroups: this._groups.guid,\n    });\n  }\n\n  private listenForScriptChange(): void {\n    const onScriptChanged = (newScript: RenderSchedule.Script | undefined) => {\n      if (!newScript?.requiresBatching)\n        newScript = undefined;\n\n      const currentScript = this._currentScript;\n      this._currentScript = newScript;\n\n      if (newScript !== currentScript)\n        if (!newScript || !currentScript || !newScript.equals(currentScript))\n          this._groups.setScript(newScript);\n    };\n\n    let rmListener = this._view.displayStyle.onScheduleScriptChanged.addListener((newScript) => onScriptChanged(newScript));\n    this._view.onDisplayStyleChanged.addListener((newStyle) => {\n      rmListener();\n      onScriptChanged(newStyle.scheduleScript);\n      rmListener = this._view.displayStyle.onScheduleScriptChanged.addListener((newScript) => onScriptChanged(newScript));\n    });\n  }\n\n  private loadRefs(): void {\n    this._refs.length = 0;\n    const groups = this._groups.groups;\n    const args: BatchedTileTreeReferenceArgs = {\n      models: this._models,\n      groups,\n      treeOwner: this._treeOwner,\n      getCurrentTimePoint: () => this._currentScript ? (this._view.displayStyle.settings.timePoint ?? this._currentScript.duration.low) : 0,\n    };\n\n    for (let i = 0; i < groups.length; i++) {\n      const timeline = groups[i].timeline;\n      this._refs.push(new BatchedTileTreeReference(args, i, timeline ? AnimationNodeId.Untransformed : undefined));\n      if (timeline) {\n        for (const nodeId of timeline.transformBatchIds)\n          this._refs.push(new BatchedTileTreeReference(args, i, nodeId));\n      }\n    }\n  }\n\n  public *[Symbol.iterator](): Iterator<TileTreeReference> {\n    this.ensureLoaded();\n    for (const ref of this._refs)\n      yield ref;\n\n    for (const ref of this._excludedRefs)\n      yield ref;\n  }\n\n  public update(): void {\n    this._excludedRefs.update();\n    this._models.setViewedModels(this._view.modelSelector.models);\n    if (this._onModelSelectorChanged)\n      this._onModelSelectorChanged();\n  }\n\n  public attachToViewport(args: AttachToViewportArgs): void {\n    this._onModelSelectorChanged = () => args.invalidateSymbologyOverrides();\n    this._excludedRefs.attachToViewport(args);\n    this._removeSceneInvalidationListener = args.onSceneInvalidated.addListener(() => this._groups.invalidateTransforms());\n  }\n\n  public detachFromViewport(): void {\n    this._onModelSelectorChanged = undefined;\n    this._excludedRefs.detachFromViewport();\n\n    if (this._removeSceneInvalidationListener) {\n      this._removeSceneInvalidationListener();\n      this._removeSceneInvalidationListener = undefined;\n    }\n  }\n\n  // Collects the TileTreeReferences for the models that need to be drawn to create the planar clip mask.\n  // For every model used by the mask (modelIds), extend the maskRange by that model's range.\n  public collectMaskRefs(modelIds: OrderedId64Iterable, maskTreeRefs: TileTreeReference[], maskRange: Range3d): void {\n    for (const ref of this._refs) {\n      // For each ref, check to see whether one of the models that are needed are in its group's list of models.\n      const refModelIds = ref.groupModelIds;\n      if (refModelIds) {\n        let haveRefModel = false;\n        for (const modelId of modelIds) {\n          if (refModelIds.has(modelId)) {\n            if (!haveRefModel) {\n              maskTreeRefs.push(ref);\n              haveRefModel = true;\n            }\n            const modelRange = this._models.getModelExtents(modelId);\n            if (modelRange)\n              maskRange.extendRange(modelRange);\n          }\n        }\n      }\n    }\n    // Also need to collect refs from other tile trees which are not in the batched tile tree refs.\n    this._excludedRefs.collectMaskRefs(modelIds, maskTreeRefs, maskRange);\n  }\n\n  // Returns a list of the models that are NOT in the planar clip mask.\n  public getModelsNotInMask(maskModels: OrderedId64Iterable | undefined, useVisible: boolean): Id64String[] | undefined {\n    const modelsNotInMask: Id64String[] = [];\n    const includedModels = this._spec.models.keys();\n    if (useVisible) {\n      // All viewed models are in the mask, so get a list of all models which are not viewed.\n      for (const modelId of includedModels) {\n        if (!this._models.views(modelId))\n          modelsNotInMask.push(modelId);\n      }\n    } else {\n      // Get a list of all model which are NOT in the maskModels list.\n      const maskModelSet = new Set(maskModels);\n      for (const modelId of includedModels) {\n        if (!maskModelSet.has(modelId))\n          modelsNotInMask.push(modelId);\n      }\n    }\n    return modelsNotInMask.length > 0 ? modelsNotInMask : undefined;\n  }\n\n  // _view.models\n  public setDeactivated(): void {\n    // Used for debugging. Unimplemented here.\n  }\n}\n\n// A placeholder used by [[ProxySpatialTileTreeReferences]] until asynchronous loading completes.\n// It provides a TileTreeOwner that never loads a tile tree.\n// This ensures that [ViewState.areAllTileTreesLoaded]($frontend) will not return `true` while we are loading.\nclass ProxyTileTreeReference extends TileTreeReference {\n  private readonly _treeOwner: TileTreeOwner;\n\n  public constructor(iModel: IModelConnection) {\n    super();\n    this._treeOwner = {\n      iModel,\n      tileTree: undefined,\n      loadStatus: TileTreeLoadStatus.NotLoaded,\n      load: () => undefined,\n      dispose: () => { },\n      loadTree: async () => Promise.resolve(undefined),\n    };\n  }\n\n  public override get treeOwner() {\n    return this._treeOwner;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  public override get _isLoadingComplete() {\n    return false;\n  }\n}\n\n// Serves as a placeholder while we asynchronously obtain the base URL for a pre-published tileset (or asynchronously determine\n// that no such tileset exists).\nclass ProxySpatialTileTreeReferences implements SpatialTileTreeReferences {\n  // Once async loading completes, all methods will be forwarded to this implementation.\n  private _impl?: SpatialTileTreeReferences;\n  private readonly _proxyRef: ProxyTileTreeReference;\n  // Retained if attachToViewport is called while we are still loading; and reset if detachFromViewport is called while loading.\n  private _attachArgs?: AttachToViewportArgs;\n\n  public constructor(view: SpatialViewState, getSpec: Promise<BatchedTilesetSpec | null>) {\n    this._proxyRef = new ProxyTileTreeReference(view.iModel);\n    getSpec.then((spec: BatchedTilesetSpec | null) => {\n      if (spec) {\n        this.setTreeRefs(new BatchedSpatialTileTreeReferences(spec, view));\n      } else {\n        this.setTreeRefs(createSpatialTileTreeReferences(view));\n      }\n    }).catch(() => {\n      this.setTreeRefs(createSpatialTileTreeReferences(view));\n    });\n  }\n\n  private setTreeRefs(refs: SpatialTileTreeReferences): void {\n    this._impl = refs;\n    if (this._attachArgs) {\n      this._impl.attachToViewport(this._attachArgs);\n      this._attachArgs.invalidateSymbologyOverrides();\n      this._attachArgs = undefined;\n    }\n  }\n\n  public update(): void {\n    this._impl?.update();\n  }\n\n  public attachToViewport(args: AttachToViewportArgs): void {\n    if (this._impl)\n      this._impl.attachToViewport(args);\n    else\n      this._attachArgs = args;\n  }\n\n  public detachFromViewport(): void {\n    if (this._impl)\n      this._impl.detachFromViewport();\n    else\n      this._attachArgs = undefined;\n  }\n\n  public setDeactivated(): void { }\n\n  public *[Symbol.iterator](): Iterator<TileTreeReference> {\n    if (this._impl) {\n      for (const ref of this._impl)\n        yield ref;\n    } else {\n      yield this._proxyRef;\n    }\n  }\n\n  public collectMaskRefs(modelIds: OrderedId64Iterable, maskTreeRefs: TileTreeReference[], maskRange: Range3d): void {\n    this._impl?.collectMaskRefs(modelIds, maskTreeRefs, maskRange);\n  }\n\n  public getModelsNotInMask(maskModels: OrderedId64Iterable | undefined, useVisible: boolean): Id64String[] | undefined {\n    if (this._impl)\n      return this._impl.getModelsNotInMask(maskModels, useVisible);\n    else\n      return undefined;\n  }\n}\n\nconst iModelToTilesetSpec = new Map<IModelConnection, BatchedTilesetSpec | null | Promise<BatchedTilesetSpec | null>>();\n\nasync function fetchTilesetSpec(iModel: IModelConnection, computeBaseUrl: ComputeSpatialTilesetBaseUrl): Promise<BatchedTilesetSpec | null> {\n  try {\n    const baseUrl = await computeBaseUrl(iModel);\n    if (undefined === baseUrl)\n      return null;\n\n    const url = new URL(\"tileset.json\", baseUrl);\n    url.search = baseUrl.search;\n    const response = await fetch(url.toString());\n    const json = await response.json();\n    return BatchedTilesetSpec.create(baseUrl, json);\n  } catch (err) {\n    Logger.logException(loggerCategory, err);\n    return null;\n  }\n}\n\n/** @internal */\nexport function createBatchedSpatialTileTreeReferences(view: SpatialViewState, computeBaseUrl: ComputeSpatialTilesetBaseUrl): SpatialTileTreeReferences {\n  const iModel = view.iModel;\n  let entry = iModelToTilesetSpec.get(iModel);\n  if (undefined === entry) {\n    const promise = entry = fetchTilesetSpec(iModel, computeBaseUrl);\n    iModelToTilesetSpec.set(iModel, entry);\n    iModel.onClose.addOnce(() => iModelToTilesetSpec.delete(iModel));\n\n    promise.then((spec: BatchedTilesetSpec | null) => {\n      if (iModelToTilesetSpec.has(iModel))\n        iModelToTilesetSpec.set(iModel, spec);\n    }).catch(() => {\n      if (iModelToTilesetSpec.has(iModel))\n        iModelToTilesetSpec.set(iModel, null);\n    });\n  }\n\n  if (null === entry) {\n    // No tileset could be obtained for this iModel - use default tile generation instead.\n    return createSpatialTileTreeReferences(view);\n  }\n\n  if (entry instanceof Promise)\n    return new ProxySpatialTileTreeReferences(view, entry);\n\n  return new BatchedSpatialTileTreeReferences(entry, view);\n}\n\n"]}
+{"version":3,"file":"BatchedSpatialTileTreeRefs.js","sourceRoot":"","sources":["../../src/BatchedSpatialTileTreeRefs.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAE/F,sDAA8E;AAE9E,wDAK8B;AAC9B,yEAAsG;AACtG,uEAAoE;AACpE,mDAAgD;AAEhD,iEAA4D;AAC5D,qDAAkD;AAClD,6DAA0D;AAG1D,sDAAsD;AACtD,MAAM,gCAAgC;IAapC,YAAmB,IAAwB,EAAE,IAAsB;QAP3D,UAAK,GAA+B,EAAE,CAAC;QAQ7C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,IAAI,6BAAa,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAElB,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC;QAChD,IAAI,CAAC,cAAc,GAAG,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAEpE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,aAAa,GAAG,IAAA,+CAA+B,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAE3E,IAAI,CAAC,OAAO,GAAG,IAAI,uCAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9F,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEhB,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC/B,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YACxB,OAAO;QAET,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAEO,YAAY;QAClB,OAAO,IAAA,iDAAuB,EAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAChD,IAAI,EAAE,IAAI,CAAC,KAAK;YAChB,MAAM,EAAE,IAAI,CAAC,cAAc;YAC3B,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;SAC/B,CAAC,CAAC;IACL,CAAC;IAEO,qBAAqB;QAC3B,MAAM,eAAe,GAAG,CAAC,SAA4C,EAAE,EAAE;YACvE,IAAI,CAAC,SAAS,EAAE,gBAAgB;gBAC9B,SAAS,GAAG,SAAS,CAAC;YAExB,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC;YAC1C,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;YAEhC,IAAI,SAAS,KAAK,aAAa;gBAC7B,IAAI,CAAC,SAAS,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC;oBAClE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC,CAAC;QAEF,IAAI,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;QACxH,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,EAAE;YACxD,UAAU,EAAE,CAAC;YACb,eAAe,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;YACzC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;QACtH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,QAAQ;QACd,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACnC,MAAM,IAAI,GAAiC;YACzC,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,mBAAmB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SACtI,CAAC;QAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,mDAAwB,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,+BAAe,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YAC7G,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,iBAAiB;oBAC7C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,mDAAwB,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAEM,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK;YAC1B,MAAM,GAAG,CAAC;QAEZ,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,aAAa;YAClC,MAAM,GAAG,CAAC;IACd,CAAC;IAEM,MAAM;QACX,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,uBAAuB;YAC9B,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACnC,CAAC;IAEM,gBAAgB,CAAC,IAA0B;QAChD,IAAI,CAAC,uBAAuB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,4BAA4B,EAAE,CAAC;QACzE,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,gCAAgC,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACzH,CAAC;IAEM,kBAAkB;QACvB,IAAI,CAAC,uBAAuB,GAAG,SAAS,CAAC;QACzC,IAAI,CAAC,aAAa,CAAC,kBAAkB,EAAE,CAAC;QAExC,IAAI,IAAI,CAAC,gCAAgC,EAAE,CAAC;YAC1C,IAAI,CAAC,gCAAgC,EAAE,CAAC;YACxC,IAAI,CAAC,gCAAgC,GAAG,SAAS,CAAC;QACpD,CAAC;IACH,CAAC;IAED,uGAAuG;IACvG,2FAA2F;IACpF,eAAe,CAAC,QAA6B,EAAE,YAAiC,EAAE,SAAkB;QACzG,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7B,0GAA0G;YAC1G,MAAM,WAAW,GAAG,GAAG,CAAC,aAAa,CAAC;YACtC,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,YAAY,GAAG,KAAK,CAAC;gBACzB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;oBAC/B,IAAI,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC7B,IAAI,CAAC,YAAY,EAAE,CAAC;4BAClB,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;4BACvB,YAAY,GAAG,IAAI,CAAC;wBACtB,CAAC;wBACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;wBACzD,IAAI,UAAU;4BACZ,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;oBACtC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,+FAA+F;QAC/F,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IACxE,CAAC;IAED,qEAAqE;IAC9D,kBAAkB,CAAC,UAA2C,EAAE,UAAmB;QACxF,MAAM,eAAe,GAAiB,EAAE,CAAC;QACzC,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAChD,IAAI,UAAU,EAAE,CAAC;YACf,uFAAuF;YACvF,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;oBAC9B,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,gEAAgE;YAChE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;YACzC,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;gBACrC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;oBAC5B,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,OAAO,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,CAAC;IAED,eAAe;IACR,cAAc;QACnB,0CAA0C;IAC5C,CAAC;CACF;AAED,iGAAiG;AACjG,4DAA4D;AAC5D,8GAA8G;AAC9G,MAAM,sBAAuB,SAAQ,iCAAiB;IAGpD,YAAmB,MAAwB;QACzC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,UAAU,GAAG;YAChB,MAAM;YACN,QAAQ,EAAE,SAAS;YACnB,UAAU,EAAE,kCAAkB,CAAC,SAAS;YACxC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;YACrB,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC;YAClB,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;SACjD,CAAC;IACJ,CAAC;IAED,IAAoB,SAAS;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,gEAAgE;IAChE,IAAoB,kBAAkB;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,+HAA+H;AAC/H,gCAAgC;AAChC,MAAM,8BAA8B;IAOlC,YAAmB,IAAsB,EAAE,OAA2C,EAAE,cAAuB,KAAK;QAClH,IAAI,CAAC,SAAS,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,IAA+B,EAAE,EAAE;YAC/C,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,WAAW,CAAC,IAAI,gCAAgC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACrE,CAAC;iBAAM,IAAG,WAAW,EAAE,CAAC;gBACtB,IAAI,CAAC,WAAW,CAAC,IAAI,8BAA8B,EAAE,CAAC,CAAC;YACzD,CAAC;iBAAK,CAAC;gBACL,IAAI,CAAC,WAAW,CAAC,IAAA,+CAA+B,EAAC,IAAI,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACZ,IAAG,WAAW,EAAE,CAAC;gBACf,IAAI,CAAC,WAAW,CAAC,IAAI,8BAA8B,EAAE,CAAC,CAAC;YACzD,CAAC;iBAAK,CAAC;gBACL,IAAI,CAAC,WAAW,CAAC,IAAA,+CAA+B,EAAC,IAAI,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,IAA+B;QACjD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,WAAW,CAAC,4BAA4B,EAAE,CAAC;YAChD,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;IAEM,MAAM;QACX,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACvB,CAAC;IAEM,gBAAgB,CAAC,IAA0B;QAChD,IAAI,IAAI,CAAC,KAAK;YACZ,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;;YAElC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAEM,kBAAkB;QACvB,IAAI,IAAI,CAAC,KAAK;YACZ,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;;YAEhC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;IACjC,CAAC;IAEM,cAAc,KAAW,CAAC;IAE1B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACvB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK;gBAC1B,MAAM,GAAG,CAAC;QACd,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,SAAS,CAAC;QACvB,CAAC;IACH,CAAC;IAEM,eAAe,CAAC,QAA6B,EAAE,YAAiC,EAAE,SAAkB;QACzG,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC;IAEM,kBAAkB,CAAC,UAA2C,EAAE,UAAmB;QACxF,IAAI,IAAI,CAAC,KAAK;YACZ,OAAO,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;;YAE7D,OAAO,SAAS,CAAC;IACrB,CAAC;CACF;AAED,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAoF,CAAC;AAExH,KAAK,UAAU,gBAAgB,CAAC,MAAwB,EAAE,cAA4C;IACpG,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,SAAS,KAAK,OAAO;YACvB,OAAO,IAAI,CAAC;QAEd,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC7C,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,yCAAkB,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,qBAAM,CAAC,YAAY,CAAC,+BAAc,EAAE,GAAG,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,8BAA8B;IAC3B,MAAM,KAAU,CAAC;IAEjB,cAAc,CAAC,SAAwC,EAAE,YAAiC,EAAE,KAA4D,IAAS,CAAC;IAElK,gBAAgB,CAAC,KAAe,IAAS,CAAC;IAE1C,kBAAkB,KAAU,CAAC;IAE7B,eAAe,CAAC,SAA8B,EAAE,aAAkC,IAAS,CAAC;IAAA,CAAC;IAE7F,kBAAkB,CAAC,WAA4C,EAAE,WAAoB;QAC1F,OAAO,SAAS,CAAC;IACnB,CAAC;IAEM,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAiC,CAAC;CAC5D;AAED,gBAAgB;AAChB,SAAgB,sCAAsC,CAAC,IAAsB,EAAE,cAA4C,EAAE,cAAuB,KAAK;IACvJ,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,GAAG,gBAAgB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACjE,mBAAmB,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAEjE,OAAO,CAAC,IAAI,CAAC,CAAC,IAA+B,EAAE,EAAE;YAC/C,IAAI,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC;gBACjC,mBAAmB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACZ,IAAI,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC;gBACjC,mBAAmB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,mFAAmF;QACnF,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,IAAI,8BAA8B,EAAE,CAAC;QAC9C,CAAC;QAED,sFAAsF;QACtF,OAAO,IAAA,+CAA+B,EAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,KAAK,YAAY,OAAO;QAC1B,OAAO,IAAI,8BAA8B,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAEtE,OAAO,IAAI,gCAAgC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC3D,CAAC;AA/BD,wFA+BC","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\nimport { Id64String, Logger, OrderedId64Iterable } from \"@itwin/core-bentley\";\nimport { RenderSchedule } from \"@itwin/core-common\";\nimport {\n  AnimationNodeId,\n  AttachToViewportArgs, createSpatialTileTreeReferences, IModelConnection, SpatialTileTreeReferences, SpatialViewState,\n  TileTreeLoadStatus, TileTreeOwner, TileTreeReference,\n  Viewport,\n} from \"@itwin/core-frontend\";\nimport {  BatchedTileTreeReference, BatchedTileTreeReferenceArgs  } from \"./BatchedTileTreeReference\";\nimport { getBatchedTileTreeOwner } from \"./BatchedTileTreeSupplier\";\nimport { BatchedModels } from \"./BatchedModels\";\nimport { ComputeSpatialTilesetBaseUrl } from \"./FrontendTiles\";\nimport { BatchedTilesetSpec } from \"./BatchedTilesetReader\";\nimport { loggerCategory } from \"./LoggerCategory\";\nimport { BatchedModelGroups } from \"./BatchedModelGroups\";\nimport { Range3d } from \"@itwin/core-geometry\";\n\n// Obtains tiles pre-published by mesh export service.\nclass BatchedSpatialTileTreeReferences implements SpatialTileTreeReferences {\n  private readonly _view: SpatialViewState;\n  private readonly _models: BatchedModels;\n  private readonly _groups: BatchedModelGroups;\n  private readonly _spec: BatchedTilesetSpec;\n  private _treeOwner: TileTreeOwner;\n  private _refs: BatchedTileTreeReference[] = [];\n  private _currentScript?: RenderSchedule.Script;\n  private _onModelSelectorChanged?: () => void;\n  /** Provides tile trees for models that are not included in the batched tile set. */\n  private readonly _excludedRefs: SpatialTileTreeReferences;\n  private _removeSceneInvalidationListener?: () => void;\n\n  public constructor(spec: BatchedTilesetSpec, view: SpatialViewState) {\n    this._view = view;\n    this._models = new BatchedModels(view, spec.models);\n    this._spec = spec;\n\n    const script = view.displayStyle.scheduleScript;\n    this._currentScript = script?.requiresBatching ? script : undefined;\n\n    const includedModels = new Set(spec.models.keys());\n    this._excludedRefs = createSpatialTileTreeReferences(view, includedModels);\n\n    this._groups = new BatchedModelGroups(view, this._currentScript, includedModels, spec.models);\n    this._treeOwner = this.getTreeOwner();\n    this.loadRefs();\n\n    this.listenForScriptChange();\n  }\n\n  private ensureLoaded(): void {\n    if (!this._groups.update())\n      return;\n\n    this._treeOwner = this.getTreeOwner();\n    this.loadRefs();\n  }\n\n  private getTreeOwner(): TileTreeOwner {\n    return getBatchedTileTreeOwner(this._view.iModel, {\n      spec: this._spec,\n      script: this._currentScript,\n      modelGroups: this._groups.guid,\n    });\n  }\n\n  private listenForScriptChange(): void {\n    const onScriptChanged = (newScript: RenderSchedule.Script | undefined) => {\n      if (!newScript?.requiresBatching)\n        newScript = undefined;\n\n      const currentScript = this._currentScript;\n      this._currentScript = newScript;\n\n      if (newScript !== currentScript)\n        if (!newScript || !currentScript || !newScript.equals(currentScript))\n          this._groups.setScript(newScript);\n    };\n\n    let rmListener = this._view.displayStyle.onScheduleScriptChanged.addListener((newScript) => onScriptChanged(newScript));\n    this._view.onDisplayStyleChanged.addListener((newStyle) => {\n      rmListener();\n      onScriptChanged(newStyle.scheduleScript);\n      rmListener = this._view.displayStyle.onScheduleScriptChanged.addListener((newScript) => onScriptChanged(newScript));\n    });\n  }\n\n  private loadRefs(): void {\n    this._refs.length = 0;\n    const groups = this._groups.groups;\n    const args: BatchedTileTreeReferenceArgs = {\n      models: this._models,\n      groups,\n      treeOwner: this._treeOwner,\n      getCurrentTimePoint: () => this._currentScript ? (this._view.displayStyle.settings.timePoint ?? this._currentScript.duration.low) : 0,\n    };\n\n    for (let i = 0; i < groups.length; i++) {\n      const timeline = groups[i].timeline;\n      this._refs.push(new BatchedTileTreeReference(args, i, timeline ? AnimationNodeId.Untransformed : undefined));\n      if (timeline) {\n        for (const nodeId of timeline.transformBatchIds)\n          this._refs.push(new BatchedTileTreeReference(args, i, nodeId));\n      }\n    }\n  }\n\n  public *[Symbol.iterator](): Iterator<TileTreeReference> {\n    this.ensureLoaded();\n    for (const ref of this._refs)\n      yield ref;\n\n    for (const ref of this._excludedRefs)\n      yield ref;\n  }\n\n  public update(): void {\n    this._excludedRefs.update();\n    this._models.setViewedModels(this._view.modelSelector.models);\n    if (this._onModelSelectorChanged)\n      this._onModelSelectorChanged();\n  }\n\n  public attachToViewport(args: AttachToViewportArgs): void {\n    this._onModelSelectorChanged = () => args.invalidateSymbologyOverrides();\n    this._excludedRefs.attachToViewport(args);\n    this._removeSceneInvalidationListener = args.onSceneInvalidated.addListener(() => this._groups.invalidateTransforms());\n  }\n\n  public detachFromViewport(): void {\n    this._onModelSelectorChanged = undefined;\n    this._excludedRefs.detachFromViewport();\n\n    if (this._removeSceneInvalidationListener) {\n      this._removeSceneInvalidationListener();\n      this._removeSceneInvalidationListener = undefined;\n    }\n  }\n\n  // Collects the TileTreeReferences for the models that need to be drawn to create the planar clip mask.\n  // For every model used by the mask (modelIds), extend the maskRange by that model's range.\n  public collectMaskRefs(modelIds: OrderedId64Iterable, maskTreeRefs: TileTreeReference[], maskRange: Range3d): void {\n    for (const ref of this._refs) {\n      // For each ref, check to see whether one of the models that are needed are in its group's list of models.\n      const refModelIds = ref.groupModelIds;\n      if (refModelIds) {\n        let haveRefModel = false;\n        for (const modelId of modelIds) {\n          if (refModelIds.has(modelId)) {\n            if (!haveRefModel) {\n              maskTreeRefs.push(ref);\n              haveRefModel = true;\n            }\n            const modelRange = this._models.getModelExtents(modelId);\n            if (modelRange)\n              maskRange.extendRange(modelRange);\n          }\n        }\n      }\n    }\n    // Also need to collect refs from other tile trees which are not in the batched tile tree refs.\n    this._excludedRefs.collectMaskRefs(modelIds, maskTreeRefs, maskRange);\n  }\n\n  // Returns a list of the models that are NOT in the planar clip mask.\n  public getModelsNotInMask(maskModels: OrderedId64Iterable | undefined, useVisible: boolean): Id64String[] | undefined {\n    const modelsNotInMask: Id64String[] = [];\n    const includedModels = this._spec.models.keys();\n    if (useVisible) {\n      // All viewed models are in the mask, so get a list of all models which are not viewed.\n      for (const modelId of includedModels) {\n        if (!this._models.views(modelId))\n          modelsNotInMask.push(modelId);\n      }\n    } else {\n      // Get a list of all model which are NOT in the maskModels list.\n      const maskModelSet = new Set(maskModels);\n      for (const modelId of includedModels) {\n        if (!maskModelSet.has(modelId))\n          modelsNotInMask.push(modelId);\n      }\n    }\n    return modelsNotInMask.length > 0 ? modelsNotInMask : undefined;\n  }\n\n  // _view.models\n  public setDeactivated(): void {\n    // Used for debugging. Unimplemented here.\n  }\n}\n\n// A placeholder used by [[ProxySpatialTileTreeReferences]] until asynchronous loading completes.\n// It provides a TileTreeOwner that never loads a tile tree.\n// This ensures that [ViewState.areAllTileTreesLoaded]($frontend) will not return `true` while we are loading.\nclass ProxyTileTreeReference extends TileTreeReference {\n  private readonly _treeOwner: TileTreeOwner;\n\n  public constructor(iModel: IModelConnection) {\n    super();\n    this._treeOwner = {\n      iModel,\n      tileTree: undefined,\n      loadStatus: TileTreeLoadStatus.NotLoaded,\n      load: () => undefined,\n      dispose: () => { },\n      loadTree: async () => Promise.resolve(undefined),\n    };\n  }\n\n  public override get treeOwner() {\n    return this._treeOwner;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  public override get _isLoadingComplete() {\n    return false;\n  }\n}\n\n// Serves as a placeholder while we asynchronously obtain the base URL for a pre-published tileset (or asynchronously determine\n// that no such tileset exists).\nclass ProxySpatialTileTreeReferences implements SpatialTileTreeReferences {\n  // Once async loading completes, all methods will be forwarded to this implementation.\n  private _impl?: SpatialTileTreeReferences;\n  private readonly _proxyRef: ProxyTileTreeReference;\n  // Retained if attachToViewport is called while we are still loading; and reset if detachFromViewport is called while loading.\n  private _attachArgs?: AttachToViewportArgs;\n\n  public constructor(view: SpatialViewState, getSpec: Promise<BatchedTilesetSpec | null>, nopFallback: boolean = false) {\n    this._proxyRef = new ProxyTileTreeReference(view.iModel);\n    getSpec.then((spec: BatchedTilesetSpec | null) => {\n      if (spec) {\n        this.setTreeRefs(new BatchedSpatialTileTreeReferences(spec, view));\n      } else if(nopFallback) {\n        this.setTreeRefs(new EmptySpatialTileTreeReferences());\n      }else {\n        this.setTreeRefs(createSpatialTileTreeReferences(view));\n      }\n    }).catch(() => {\n      if(nopFallback) {\n        this.setTreeRefs(new EmptySpatialTileTreeReferences());\n      }else {\n        this.setTreeRefs(createSpatialTileTreeReferences(view));\n      }\n    });\n  }\n\n  private setTreeRefs(refs: SpatialTileTreeReferences): void {\n    this._impl = refs;\n    if (this._attachArgs) {\n      this._impl.attachToViewport(this._attachArgs);\n      this._attachArgs.invalidateSymbologyOverrides();\n      this._attachArgs = undefined;\n    }\n  }\n\n  public update(): void {\n    this._impl?.update();\n  }\n\n  public attachToViewport(args: AttachToViewportArgs): void {\n    if (this._impl)\n      this._impl.attachToViewport(args);\n    else\n      this._attachArgs = args;\n  }\n\n  public detachFromViewport(): void {\n    if (this._impl)\n      this._impl.detachFromViewport();\n    else\n      this._attachArgs = undefined;\n  }\n\n  public setDeactivated(): void { }\n\n  public *[Symbol.iterator](): Iterator<TileTreeReference> {\n    if (this._impl) {\n      for (const ref of this._impl)\n        yield ref;\n    } else {\n      yield this._proxyRef;\n    }\n  }\n\n  public collectMaskRefs(modelIds: OrderedId64Iterable, maskTreeRefs: TileTreeReference[], maskRange: Range3d): void {\n    this._impl?.collectMaskRefs(modelIds, maskTreeRefs, maskRange);\n  }\n\n  public getModelsNotInMask(maskModels: OrderedId64Iterable | undefined, useVisible: boolean): Id64String[] | undefined {\n    if (this._impl)\n      return this._impl.getModelsNotInMask(maskModels, useVisible);\n    else\n      return undefined;\n  }\n}\n\nconst iModelToTilesetSpec = new Map<IModelConnection, BatchedTilesetSpec | null | Promise<BatchedTilesetSpec | null>>();\n\nasync function fetchTilesetSpec(iModel: IModelConnection, computeBaseUrl: ComputeSpatialTilesetBaseUrl): Promise<BatchedTilesetSpec | null> {\n  try {\n    const baseUrl = await computeBaseUrl(iModel);\n    if (undefined === baseUrl)\n      return null;\n\n    const url = new URL(\"tileset.json\", baseUrl);\n    url.search = baseUrl.search;\n    const response = await fetch(url.toString());\n    const json = await response.json();\n    return BatchedTilesetSpec.create(baseUrl, json);\n  } catch (err) {\n    Logger.logException(loggerCategory, err);\n    return null;\n  }\n}\n\nclass EmptySpatialTileTreeReferences implements SpatialTileTreeReferences {\n  public update(): void {}\n\n  public setDeactivated(_modelIds: string | string[] | undefined, _deactivated: boolean | undefined, _refs: \"all\" | \"animated\" | \"primary\" | \"section\" | number[]): void {}\n\n  public attachToViewport(_args: Viewport): void {}\n\n  public detachFromViewport(): void {}\n\n  public collectMaskRefs(_modelIds: OrderedId64Iterable, _maskTreeRefs: TileTreeReference[]): void {};\n\n  public getModelsNotInMask(_maskModels: OrderedId64Iterable | undefined, _useVisible: boolean): string[] | undefined {\n    return undefined;\n  }\n\n  public *[Symbol.iterator](): Iterator<TileTreeReference> {}\n}\n\n/** @internal */\nexport function createBatchedSpatialTileTreeReferences(view: SpatialViewState, computeBaseUrl: ComputeSpatialTilesetBaseUrl, nopFallback: boolean = false): SpatialTileTreeReferences {\n  const iModel = view.iModel;\n  let entry = iModelToTilesetSpec.get(iModel);\n  if (undefined === entry) {\n    const promise = entry = fetchTilesetSpec(iModel, computeBaseUrl);\n    iModelToTilesetSpec.set(iModel, entry);\n    iModel.onClose.addOnce(() => iModelToTilesetSpec.delete(iModel));\n\n    promise.then((spec: BatchedTilesetSpec | null) => {\n      if (iModelToTilesetSpec.has(iModel))\n        iModelToTilesetSpec.set(iModel, spec);\n    }).catch(() => {\n      if (iModelToTilesetSpec.has(iModel))\n        iModelToTilesetSpec.set(iModel, null);\n    });\n  }\n\n  if (null === entry) {\n    // No tileset could be obtained for this iModel - use empty tile tree if requested.\n    if (nopFallback) {\n      return new EmptySpatialTileTreeReferences();\n    }\n\n    // No tileset could be obtained for this iModel - use default tile generation instead.\n    return createSpatialTileTreeReferences(view);\n  }\n\n  if (entry instanceof Promise)\n    return new ProxySpatialTileTreeReferences(view, entry, nopFallback);\n\n  return new BatchedSpatialTileTreeReferences(entry, view);\n}\n\n"]}

package/lib/cjs/FrontendTiles.d.ts

@@ -110,6 +110,11 @@ export interface FrontendTilesOptions {
     * @internal
     */
     useIndexedDBCache?: boolean;
+    /** If true, an empty tile tree will be used as fallback if the tileset is not found or invalid.
+     * If false or not defined, the default tiles will be used as a fallback.
+     * @internal
+     */
+    nopFallback?: boolean;
 }
 /** Global configuration initialized by [[initializeFrontendTiles]].
  * @internal

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

@@ -1 +1 @@
-{"version":3,"file":"FrontendTiles.d.ts","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,gBAAgB,EAA+C,MAAM,sBAAsB,CAAC;AAGhH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAA0B,0BAA0B,EAAC,MAAM,qCAAqC,CAAC;AAExG;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAElG;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,GAAG,CAAC;QACrB,oBAAoB,EAAE,GAAG,CAAC;KAC3B,CAAC;IAGF,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IAGtB,MAAM,EAAE;QACN,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qIAAqI;IACrI,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAuB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAsCrG;AAED;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,0BAA0B,CAAC;AAExE;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAE/G;AACD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;IAC5D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;MAGE;IACF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;CAIhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAe3E"}
+{"version":3,"file":"FrontendTiles.d.ts","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,gBAAgB,EAA+C,MAAM,sBAAsB,CAAC;AAGhH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAA0B,0BAA0B,EAAC,MAAM,qCAAqC,CAAC;AAExG;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAElG;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,GAAG,CAAC;QACrB,oBAAoB,EAAE,GAAG,CAAC;KAC3B,CAAC;IAGF,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IAGtB,MAAM,EAAE;QACN,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qIAAqI;IACrI,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAuB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAsCrG;AAED;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,0BAA0B,CAAC;AAExE;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAE/G;AACD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;IAC5D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;MAGE;IACF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;CAIhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAe3E"}

package/lib/cjs/FrontendTiles.js

@@ -80,7 +80,7 @@ function initializeFrontendTiles(options) {
     if (options.useIndexedDBCache)
         exports.frontendTilesOptions.useIndexedDBCache = true;
     const computeUrl = options.computeSpatialTilesetBaseUrl ?? (async (iModel) => obtainMeshExportTilesetUrl({ iModel, accessToken: await core_frontend_1.IModelApp.getAccessToken(), enableCDN: options.enableCDN }));
-    core_frontend_1.SpatialTileTreeReferences.create = (view) => (0, BatchedSpatialTileTreeRefs_1.createBatchedSpatialTileTreeReferences)(view, computeUrl);
+    core_frontend_1.SpatialTileTreeReferences.create = (view) => (0, BatchedSpatialTileTreeRefs_1.createBatchedSpatialTileTreeReferences)(view, computeUrl, options.nopFallback ?? false);
 }
 exports.initializeFrontendTiles = initializeFrontendTiles;
 //# sourceMappingURL=FrontendTiles.js.map

package/lib/cjs/FrontendTiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrontendTiles.js","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAE/F,wDAAgH;AAChH,6EAAsF;AACtF,oGAA+F;AAE/F,0EAAwG;AAoExG;;;;GAIG;AACI,KAAK,SAAS,CAAC,CAAC,gBAAgB,CAAC,IAA0B;IAChE,MAAM,YAAY,GAAG;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,yBAAS,CAAC,SAAS;QAC9B,UAAU,EAAE;YACV,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,EAAE,EAAE,IAAI,CAAC,QAAQ;YACjB,QAAQ,EAAE,IAAI,CAAC,WAAW;YAC1B,IAAI,EAAE,QAAQ;SACf;QACD,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;IAEF,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAA,2DAA2B,EAAC,YAAY,CAAC,EAAC,CAAC;QAClE,MAAM,UAAU,GAAG;YACjB,EAAE,EAAE,IAAI,CAAC,gBAAgB;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE;gBAC5B,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE;gBAC3C,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;gBAChC,eAAe,EAAE,EAAE;gBACnB,oBAAoB,EAAE,EAAE;aACzB;YAED,mEAAmE;YACnE,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;iBACrB;aACF;SACF,CAAC;QAEF,MAAM,UAAU,CAAC;IACnB,CAAC;AACH,CAAC;AAtCD,4CAsCC;AAOD;;;;;GAKG;AACI,KAAK,UAAU,0BAA0B,CAAC,IAAoC;IACnF,OAAO,IAAA,yCAAsB,EAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAFD,gEAEC;AAqCD;;GAEG;AACU,QAAA,oBAAoB,GAAG;IAClC,eAAe,EAAE,CAAC;IAClB,WAAW,EAAE,KAAK;IAClB,iBAAiB,EAAE,KAAK;CACzB,CAAC;AAEF;;GAEG;AACH,SAAgB,uBAAuB,CAAC,OAA6B;IACnE,IAAI,SAAS,KAAK,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,eAAe,IAAI,CAAC;QACvE,4BAAoB,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAEjE,IAAI,OAAO,CAAC,WAAW;QACrB,4BAAoB,CAAC,WAAW,GAAG,IAAI,CAAC;IAE1C,IAAI,OAAO,CAAC,iBAAiB;QAC3B,4BAAoB,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAEhD,MAAM,UAAU,GAAG,OAAO,CAAC,4BAA4B,IAAI,CACzD,KAAK,EAAE,MAAwB,EAAE,EAAE,CAAC,0BAA0B,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,yBAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CACxJ,CAAC;IAEF,yCAAyB,CAAC,MAAM,GAAG,CAAC,IAAsB,EAAE,EAAE,CAAC,IAAA,mEAAsC,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAC1H,CAAC;AAfD,0DAeC","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\nimport { IModelApp, IModelConnection, SpatialTileTreeReferences, SpatialViewState } from \"@itwin/core-frontend\";\nimport { createBatchedSpatialTileTreeReferences } from \"./BatchedSpatialTileTreeRefs\";\nimport { queryGraphicRepresentations } from \"./GraphicsProvider/GraphicRepresentationProvider\";\nimport { AccessToken } from \"@itwin/core-bentley\";\nimport { obtainIModelTilesetUrl, ObtainIModelTilesetUrlArgs} from \"./GraphicsProvider/GraphicsProvider\";\n\n/** A function that can provide the base URL where a tileset representing all of the spatial models in a given iModel are stored.\n * The tileset is expected to reside at \"baseUrl/tileset.json\" and to have been produced by the [mesh export service](https://developer.bentley.com/apis/mesh-export/).\n * If no such tileset exists for the given iModel, return `undefined`.\n * @see [[FrontendTilesOptions.computeSpatialTilesetBaseUrl]].\n * @beta\n */\nexport type ComputeSpatialTilesetBaseUrl = (iModel: IModelConnection) => Promise<URL | undefined>;\n\n/** Represents the result of a [mesh export](https://developer.bentley.com/apis/mesh-export/operations/get-export/#export).\n * @see [[queryCompletedMeshExports]].\n * @beta\n */\nexport interface MeshExport {\n  id: string;\n  displayName: string;\n  status: string;\n  request: {\n    iModelId: string;\n    changesetId: string;\n    exportType: string;\n    geometryOptions: any;\n    viewDefinitionFilter: any;\n  };\n\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\n  _links: {\n    mesh: {\n      href: string;\n    };\n  };\n}\n\n/** Exposed strictly for tests.\n * @internal\n */\nexport interface MeshExports {\n  exports: MeshExport[];\n\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\n  _links: {\n    next?: {\n      href: string;\n    };\n  };\n}\n\n/** Arguments supplied to [[queryMeshExports]].\n * @beta\n */\nexport interface QueryMeshExportsArgs {\n  /** The token used to access the mesh export service. */\n  accessToken: AccessToken;\n  /** The iTwinId associated with the Mesh Export */\n  iTwinId: string;\n  /** The Id of the iModel for which to query exports. */\n  iModelId: string;\n  /** If defined, constrains the query to exports produced from the specified changeset. */\n  changesetId?: string;\n  /** Chiefly used in testing environments. */\n  urlPrefix?: string;\n  /** If true, exports whose status is not \"Complete\" (indicating the export successfully finished) will be included in the results. */\n  includeIncomplete?: boolean;\n  /** If true, enables a CDN (content delivery network) to access tiles faster. */\n  enableCDN?: boolean;\n}\n\n/** Query the [mesh export service](https://developer.bentley.com/apis/mesh-export/operations/get-exports/) for exports of type \"IMODEL\" matching\n * the specified criteria.\n * The exports are sorted from most-recently- to least-recently-produced.\n * @beta\n */\nexport async function* queryMeshExports(args: QueryMeshExportsArgs): AsyncIterableIterator<MeshExport> {\n  const graphicsArgs = {\n    accessToken: args.accessToken,\n    sessionId: IModelApp.sessionId,\n    dataSource: {\n      iTwinId: args.iTwinId,\n      id: args.iModelId,\n      changeId: args.changesetId,\n      type: \"IMODEL\",\n    },\n    format: \"IMDL\",\n    urlPrefix: args.urlPrefix,\n    enableCDN: args.enableCDN,\n  };\n\n  for await (const data of queryGraphicRepresentations(graphicsArgs)){\n    const meshExport = {\n      id: data.representationId,\n      displayName: data.displayName,\n      status: \"Complete\",\n      request: {\n        iModelId: data.dataSource.id,\n        changesetId: data.dataSource.changeId ?? \"\",\n        exportType: data.dataSource.type,\n        geometryOptions: {},\n        viewDefinitionFilter: {},\n      },\n\n      /* eslint-disable-next-line @typescript-eslint/naming-convention */\n      _links: {\n        mesh: {\n          href: data.url ?? \"\",\n        },\n      },\n    };\n\n    yield meshExport;\n  }\n}\n\n/** Arguments supplied  to [[obtainMeshExportTilesetUrl]].\n * @beta\n */\nexport type ObtainMeshExportTilesetUrlArgs = ObtainIModelTilesetUrlArgs;\n\n/** Obtains a URL pointing to a tileset appropriate for visualizing a specific iModel.\n * [[queryCompletedMeshExports]] is used to obtain a list of available exports. By default, the list is sorted from most to least recently-exported.\n * The first export matching the iModel's changeset is selected; or, if no such export exists, the first export in the list is selected.\n * @returns A URL from which the tileset can be loaded, or `undefined` if no appropriate URL could be obtained.\n * @beta\n */\nexport async function obtainMeshExportTilesetUrl(args: ObtainMeshExportTilesetUrlArgs): Promise<URL | undefined> {\n  return obtainIModelTilesetUrl(args);\n}\n/** Options supplied to [[initializeFrontendTiles]].\n * @beta\n */\nexport interface FrontendTilesOptions {\n  /** Provide the base URL for the pre-published tileset for a given iModel.\n   * If omitted, [[obtainMeshExportTilesetUrl]] will be invoked with default arguments, using the access token provided by [[IModelApp]].\n   */\n  computeSpatialTilesetBaseUrl?: ComputeSpatialTilesetBaseUrl;\n  /** The maximum number of levels in the tile tree to skip loading if they do not provide the desired level of detail for the current view.\n   * Default: 4.\n   * Reducing this value will load more intermediate tiles, which causes more gradual refinement: low-resolution tiles will display quickly, followed more gradually by\n   * successively higher-resolution ones.\n   * Increasing the value jumps more directly to tiles of the exact level of detail desired, which may load more, smaller tiles up-front, leaving some areas of the view\n   * vacant for longer; and when zooming out some newly-exposed areas of the view may remain vacant for longer because no lower-resolution tiles are initially available to\n   * fill them. However, tiles close to the viewer (and therefore likely of most interest to them) will refine to an appropriate level of detail more quickly.\n   */\n  maxLevelsToSkip?: number;\n  /** Specifies whether to permit the user to enable visible edges or wireframe mode for batched tiles.\n   * The currently-deployed mesh export service does not produce edges, so this currently defaults to `false` to avoid user confusion.\n   * Set it to `true` if you are loading tiles created with a version of the exporter that does produce edges.\n   * ###TODO delete this option once we deploy an edge-producing version of the exporter to production.\n   * @internal\n   */\n  enableEdges?: boolean;\n  /** Specifies whether to enable a CDN (content delivery network) to access tiles faster.\n   * This option is only used if computeSpatialTilesetBaseUrl is not defined.\n   * @beta\n   */\n  enableCDN?: boolean;\n  /** Specifies whether to enable an IndexedDB database for use as a local cache.\n  * Requested tiles will then first be search for in the database, and if not found, fetched as normal.\n  * @internal\n  */\n  useIndexedDBCache?: boolean;\n}\n\n/** Global configuration initialized by [[initializeFrontendTiles]].\n * @internal\n */\nexport const frontendTilesOptions = {\n  maxLevelsToSkip: 4,\n  enableEdges: false,\n  useIndexedDBCache: false,\n};\n\n/** Initialize the frontend-tiles package to obtain tiles for spatial views.\n * @beta\n */\nexport function initializeFrontendTiles(options: FrontendTilesOptions): void {\n  if (undefined !== options.maxLevelsToSkip && options.maxLevelsToSkip >= 0)\n    frontendTilesOptions.maxLevelsToSkip = options.maxLevelsToSkip;\n\n  if (options.enableEdges)\n    frontendTilesOptions.enableEdges = true;\n\n  if (options.useIndexedDBCache)\n    frontendTilesOptions.useIndexedDBCache = true;\n\n  const computeUrl = options.computeSpatialTilesetBaseUrl ?? (\n    async (iModel: IModelConnection) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken(), enableCDN: options.enableCDN })\n  );\n\n  SpatialTileTreeReferences.create = (view: SpatialViewState) => createBatchedSpatialTileTreeReferences(view, computeUrl);\n}\n"]}
+{"version":3,"file":"FrontendTiles.js","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAE/F,wDAAgH;AAChH,6EAAsF;AACtF,oGAA+F;AAE/F,0EAAwG;AAoExG;;;;GAIG;AACI,KAAK,SAAS,CAAC,CAAC,gBAAgB,CAAC,IAA0B;IAChE,MAAM,YAAY,GAAG;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,yBAAS,CAAC,SAAS;QAC9B,UAAU,EAAE;YACV,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,EAAE,EAAE,IAAI,CAAC,QAAQ;YACjB,QAAQ,EAAE,IAAI,CAAC,WAAW;YAC1B,IAAI,EAAE,QAAQ;SACf;QACD,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;IAEF,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAA,2DAA2B,EAAC,YAAY,CAAC,EAAC,CAAC;QAClE,MAAM,UAAU,GAAG;YACjB,EAAE,EAAE,IAAI,CAAC,gBAAgB;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE;gBAC5B,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE;gBAC3C,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;gBAChC,eAAe,EAAE,EAAE;gBACnB,oBAAoB,EAAE,EAAE;aACzB;YAED,mEAAmE;YACnE,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;iBACrB;aACF;SACF,CAAC;QAEF,MAAM,UAAU,CAAC;IACnB,CAAC;AACH,CAAC;AAtCD,4CAsCC;AAOD;;;;;GAKG;AACI,KAAK,UAAU,0BAA0B,CAAC,IAAoC;IACnF,OAAO,IAAA,yCAAsB,EAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAFD,gEAEC;AA2CD;;GAEG;AACU,QAAA,oBAAoB,GAAG;IAClC,eAAe,EAAE,CAAC;IAClB,WAAW,EAAE,KAAK;IAClB,iBAAiB,EAAE,KAAK;CACzB,CAAC;AAEF;;GAEG;AACH,SAAgB,uBAAuB,CAAC,OAA6B;IACnE,IAAI,SAAS,KAAK,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,eAAe,IAAI,CAAC;QACvE,4BAAoB,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAEjE,IAAI,OAAO,CAAC,WAAW;QACrB,4BAAoB,CAAC,WAAW,GAAG,IAAI,CAAC;IAE1C,IAAI,OAAO,CAAC,iBAAiB;QAC3B,4BAAoB,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAEhD,MAAM,UAAU,GAAG,OAAO,CAAC,4BAA4B,IAAI,CACzD,KAAK,EAAE,MAAwB,EAAE,EAAE,CAAC,0BAA0B,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,yBAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CACxJ,CAAC;IAEF,yCAAyB,CAAC,MAAM,GAAG,CAAC,IAAsB,EAAE,EAAE,CAAC,IAAA,mEAAsC,EAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC,CAAC;AACxJ,CAAC;AAfD,0DAeC","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\nimport { IModelApp, IModelConnection, SpatialTileTreeReferences, SpatialViewState } from \"@itwin/core-frontend\";\nimport { createBatchedSpatialTileTreeReferences } from \"./BatchedSpatialTileTreeRefs\";\nimport { queryGraphicRepresentations } from \"./GraphicsProvider/GraphicRepresentationProvider\";\nimport { AccessToken } from \"@itwin/core-bentley\";\nimport { obtainIModelTilesetUrl, ObtainIModelTilesetUrlArgs} from \"./GraphicsProvider/GraphicsProvider\";\n\n/** A function that can provide the base URL where a tileset representing all of the spatial models in a given iModel are stored.\n * The tileset is expected to reside at \"baseUrl/tileset.json\" and to have been produced by the [mesh export service](https://developer.bentley.com/apis/mesh-export/).\n * If no such tileset exists for the given iModel, return `undefined`.\n * @see [[FrontendTilesOptions.computeSpatialTilesetBaseUrl]].\n * @beta\n */\nexport type ComputeSpatialTilesetBaseUrl = (iModel: IModelConnection) => Promise<URL | undefined>;\n\n/** Represents the result of a [mesh export](https://developer.bentley.com/apis/mesh-export/operations/get-export/#export).\n * @see [[queryCompletedMeshExports]].\n * @beta\n */\nexport interface MeshExport {\n  id: string;\n  displayName: string;\n  status: string;\n  request: {\n    iModelId: string;\n    changesetId: string;\n    exportType: string;\n    geometryOptions: any;\n    viewDefinitionFilter: any;\n  };\n\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\n  _links: {\n    mesh: {\n      href: string;\n    };\n  };\n}\n\n/** Exposed strictly for tests.\n * @internal\n */\nexport interface MeshExports {\n  exports: MeshExport[];\n\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\n  _links: {\n    next?: {\n      href: string;\n    };\n  };\n}\n\n/** Arguments supplied to [[queryMeshExports]].\n * @beta\n */\nexport interface QueryMeshExportsArgs {\n  /** The token used to access the mesh export service. */\n  accessToken: AccessToken;\n  /** The iTwinId associated with the Mesh Export */\n  iTwinId: string;\n  /** The Id of the iModel for which to query exports. */\n  iModelId: string;\n  /** If defined, constrains the query to exports produced from the specified changeset. */\n  changesetId?: string;\n  /** Chiefly used in testing environments. */\n  urlPrefix?: string;\n  /** If true, exports whose status is not \"Complete\" (indicating the export successfully finished) will be included in the results. */\n  includeIncomplete?: boolean;\n  /** If true, enables a CDN (content delivery network) to access tiles faster. */\n  enableCDN?: boolean;\n}\n\n/** Query the [mesh export service](https://developer.bentley.com/apis/mesh-export/operations/get-exports/) for exports of type \"IMODEL\" matching\n * the specified criteria.\n * The exports are sorted from most-recently- to least-recently-produced.\n * @beta\n */\nexport async function* queryMeshExports(args: QueryMeshExportsArgs): AsyncIterableIterator<MeshExport> {\n  const graphicsArgs = {\n    accessToken: args.accessToken,\n    sessionId: IModelApp.sessionId,\n    dataSource: {\n      iTwinId: args.iTwinId,\n      id: args.iModelId,\n      changeId: args.changesetId,\n      type: \"IMODEL\",\n    },\n    format: \"IMDL\",\n    urlPrefix: args.urlPrefix,\n    enableCDN: args.enableCDN,\n  };\n\n  for await (const data of queryGraphicRepresentations(graphicsArgs)){\n    const meshExport = {\n      id: data.representationId,\n      displayName: data.displayName,\n      status: \"Complete\",\n      request: {\n        iModelId: data.dataSource.id,\n        changesetId: data.dataSource.changeId ?? \"\",\n        exportType: data.dataSource.type,\n        geometryOptions: {},\n        viewDefinitionFilter: {},\n      },\n\n      /* eslint-disable-next-line @typescript-eslint/naming-convention */\n      _links: {\n        mesh: {\n          href: data.url ?? \"\",\n        },\n      },\n    };\n\n    yield meshExport;\n  }\n}\n\n/** Arguments supplied  to [[obtainMeshExportTilesetUrl]].\n * @beta\n */\nexport type ObtainMeshExportTilesetUrlArgs = ObtainIModelTilesetUrlArgs;\n\n/** Obtains a URL pointing to a tileset appropriate for visualizing a specific iModel.\n * [[queryCompletedMeshExports]] is used to obtain a list of available exports. By default, the list is sorted from most to least recently-exported.\n * The first export matching the iModel's changeset is selected; or, if no such export exists, the first export in the list is selected.\n * @returns A URL from which the tileset can be loaded, or `undefined` if no appropriate URL could be obtained.\n * @beta\n */\nexport async function obtainMeshExportTilesetUrl(args: ObtainMeshExportTilesetUrlArgs): Promise<URL | undefined> {\n  return obtainIModelTilesetUrl(args);\n}\n/** Options supplied to [[initializeFrontendTiles]].\n * @beta\n */\nexport interface FrontendTilesOptions {\n  /** Provide the base URL for the pre-published tileset for a given iModel.\n   * If omitted, [[obtainMeshExportTilesetUrl]] will be invoked with default arguments, using the access token provided by [[IModelApp]].\n   */\n  computeSpatialTilesetBaseUrl?: ComputeSpatialTilesetBaseUrl;\n  /** The maximum number of levels in the tile tree to skip loading if they do not provide the desired level of detail for the current view.\n   * Default: 4.\n   * Reducing this value will load more intermediate tiles, which causes more gradual refinement: low-resolution tiles will display quickly, followed more gradually by\n   * successively higher-resolution ones.\n   * Increasing the value jumps more directly to tiles of the exact level of detail desired, which may load more, smaller tiles up-front, leaving some areas of the view\n   * vacant for longer; and when zooming out some newly-exposed areas of the view may remain vacant for longer because no lower-resolution tiles are initially available to\n   * fill them. However, tiles close to the viewer (and therefore likely of most interest to them) will refine to an appropriate level of detail more quickly.\n   */\n  maxLevelsToSkip?: number;\n  /** Specifies whether to permit the user to enable visible edges or wireframe mode for batched tiles.\n   * The currently-deployed mesh export service does not produce edges, so this currently defaults to `false` to avoid user confusion.\n   * Set it to `true` if you are loading tiles created with a version of the exporter that does produce edges.\n   * ###TODO delete this option once we deploy an edge-producing version of the exporter to production.\n   * @internal\n   */\n  enableEdges?: boolean;\n  /** Specifies whether to enable a CDN (content delivery network) to access tiles faster.\n   * This option is only used if computeSpatialTilesetBaseUrl is not defined.\n   * @beta\n   */\n  enableCDN?: boolean;\n  /** Specifies whether to enable an IndexedDB database for use as a local cache.\n  * Requested tiles will then first be search for in the database, and if not found, fetched as normal.\n  * @internal\n  */\n  useIndexedDBCache?: boolean;\n\n  /** If true, an empty tile tree will be used as fallback if the tileset is not found or invalid.\n   * If false or not defined, the default tiles will be used as a fallback.\n   * @internal\n   */\n  nopFallback?: boolean;\n}\n\n/** Global configuration initialized by [[initializeFrontendTiles]].\n * @internal\n */\nexport const frontendTilesOptions = {\n  maxLevelsToSkip: 4,\n  enableEdges: false,\n  useIndexedDBCache: false,\n};\n\n/** Initialize the frontend-tiles package to obtain tiles for spatial views.\n * @beta\n */\nexport function initializeFrontendTiles(options: FrontendTilesOptions): void {\n  if (undefined !== options.maxLevelsToSkip && options.maxLevelsToSkip >= 0)\n    frontendTilesOptions.maxLevelsToSkip = options.maxLevelsToSkip;\n\n  if (options.enableEdges)\n    frontendTilesOptions.enableEdges = true;\n\n  if (options.useIndexedDBCache)\n    frontendTilesOptions.useIndexedDBCache = true;\n\n  const computeUrl = options.computeSpatialTilesetBaseUrl ?? (\n    async (iModel: IModelConnection) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken(), enableCDN: options.enableCDN })\n  );\n\n  SpatialTileTreeReferences.create = (view: SpatialViewState) => createBatchedSpatialTileTreeReferences(view, computeUrl, options.nopFallback ?? false);\n}\n"]}

package/lib/esm/BatchedSpatialTileTreeRefs.d.ts

@@ -1,5 +1,5 @@
 import { SpatialTileTreeReferences, SpatialViewState } from "@itwin/core-frontend";
 import { ComputeSpatialTilesetBaseUrl } from "./FrontendTiles";
 /** @internal */
-export declare function createBatchedSpatialTileTreeReferences(view: SpatialViewState, computeBaseUrl: ComputeSpatialTilesetBaseUrl): SpatialTileTreeReferences;
+export declare function createBatchedSpatialTileTreeReferences(view: SpatialViewState, computeBaseUrl: ComputeSpatialTilesetBaseUrl, nopFallback?: boolean): SpatialTileTreeReferences;
 //# sourceMappingURL=BatchedSpatialTileTreeRefs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"BatchedSpatialTileTreeRefs.d.ts","sourceRoot":"","sources":["../../src/BatchedSpatialTileTreeRefs.ts"],"names":[],"mappings":"AAOA,OAAO,EAEoE,yBAAyB,EAAE,gBAAgB,EAErH,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AA0S/D,gBAAgB;AAChB,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,4BAA4B,GAAG,yBAAyB,CA0BtJ"}
+{"version":3,"file":"BatchedSpatialTileTreeRefs.d.ts","sourceRoot":"","sources":["../../src/BatchedSpatialTileTreeRefs.ts"],"names":[],"mappings":"AAOA,OAAO,EAEoE,yBAAyB,EAAE,gBAAgB,EAGrH,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAkU/D,gBAAgB;AAChB,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,4BAA4B,EAAE,WAAW,GAAE,OAAe,GAAG,yBAAyB,CA+BpL"}

package/lib/esm/BatchedSpatialTileTreeRefs.js

@@ -176,17 +176,25 @@ class ProxyTileTreeReference extends TileTreeReference {
 // Serves as a placeholder while we asynchronously obtain the base URL for a pre-published tileset (or asynchronously determine
 // that no such tileset exists).
 class ProxySpatialTileTreeReferences {
-    constructor(view, getSpec) {
+    constructor(view, getSpec, nopFallback = false) {
         this._proxyRef = new ProxyTileTreeReference(view.iModel);
         getSpec.then((spec) => {
             if (spec) {
                 this.setTreeRefs(new BatchedSpatialTileTreeReferences(spec, view));
             }
+            else if (nopFallback) {
+                this.setTreeRefs(new EmptySpatialTileTreeReferences());
+            }
             else {
                 this.setTreeRefs(createSpatialTileTreeReferences(view));
             }
         }).catch(() => {
-            this.setTreeRefs(createSpatialTileTreeReferences(view));
+            if (nopFallback) {
+                this.setTreeRefs(new EmptySpatialTileTreeReferences());
+            }
+            else {
+                this.setTreeRefs(createSpatialTileTreeReferences(view));
+            }
         });
     }
     setTreeRefs(refs) {
@@ -249,8 +257,20 @@ async function fetchTilesetSpec(iModel, computeBaseUrl) {
         return null;
     }
 }
+class EmptySpatialTileTreeReferences {
+    update() { }
+    setDeactivated(_modelIds, _deactivated, _refs) { }
+    attachToViewport(_args) { }
+    detachFromViewport() { }
+    collectMaskRefs(_modelIds, _maskTreeRefs) { }
+    ;
+    getModelsNotInMask(_maskModels, _useVisible) {
+        return undefined;
+    }
+    *[Symbol.iterator]() { }
+}
 /** @internal */
-export function createBatchedSpatialTileTreeReferences(view, computeBaseUrl) {
+export function createBatchedSpatialTileTreeReferences(view, computeBaseUrl, nopFallback = false) {
     const iModel = view.iModel;
     let entry = iModelToTilesetSpec.get(iModel);
     if (undefined === entry) {
@@ -266,11 +286,15 @@ export function createBatchedSpatialTileTreeReferences(view, computeBaseUrl) {
         });
     }
     if (null === entry) {
+        // No tileset could be obtained for this iModel - use empty tile tree if requested.
+        if (nopFallback) {
+            return new EmptySpatialTileTreeReferences();
+        }
         // No tileset could be obtained for this iModel - use default tile generation instead.
         return createSpatialTileTreeReferences(view);
     }
     if (entry instanceof Promise)
-        return new ProxySpatialTileTreeReferences(view, entry);
+        return new ProxySpatialTileTreeReferences(view, entry, nopFallback);
     return new BatchedSpatialTileTreeReferences(entry, view);
 }
 //# sourceMappingURL=BatchedSpatialTileTreeRefs.js.map

package/lib/esm/BatchedSpatialTileTreeRefs.js.map

@@ -1 +1 @@
-{"version":3,"file":"BatchedSpatialTileTreeRefs.js","sourceRoot":"","sources":["../../src/BatchedSpatialTileTreeRefs.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\nimport { Id64String, Logger, OrderedId64Iterable } from \"@itwin/core-bentley\";\nimport { RenderSchedule } from \"@itwin/core-common\";\nimport {\n  AnimationNodeId,\n  AttachToViewportArgs, createSpatialTileTreeReferences, IModelConnection, SpatialTileTreeReferences, SpatialViewState,\n  TileTreeLoadStatus, TileTreeOwner, TileTreeReference,\n} from \"@itwin/core-frontend\";\nimport {  BatchedTileTreeReference, BatchedTileTreeReferenceArgs  } from \"./BatchedTileTreeReference\";\nimport { getBatchedTileTreeOwner } from \"./BatchedTileTreeSupplier\";\nimport { BatchedModels } from \"./BatchedModels\";\nimport { ComputeSpatialTilesetBaseUrl } from \"./FrontendTiles\";\nimport { BatchedTilesetSpec } from \"./BatchedTilesetReader\";\nimport { loggerCategory } from \"./LoggerCategory\";\nimport { BatchedModelGroups } from \"./BatchedModelGroups\";\nimport { Range3d } from \"@itwin/core-geometry\";\n\n// Obtains tiles pre-published by mesh export service.\nclass BatchedSpatialTileTreeReferences implements SpatialTileTreeReferences {\n  private readonly _view: SpatialViewState;\n  private readonly _models: BatchedModels;\n  private readonly _groups: BatchedModelGroups;\n  private readonly _spec: BatchedTilesetSpec;\n  private _treeOwner: TileTreeOwner;\n  private _refs: BatchedTileTreeReference[] = [];\n  private _currentScript?: RenderSchedule.Script;\n  private _onModelSelectorChanged?: () => void;\n  /** Provides tile trees for models that are not included in the batched tile set. */\n  private readonly _excludedRefs: SpatialTileTreeReferences;\n  private _removeSceneInvalidationListener?: () => void;\n\n  public constructor(spec: BatchedTilesetSpec, view: SpatialViewState) {\n    this._view = view;\n    this._models = new BatchedModels(view, spec.models);\n    this._spec = spec;\n\n    const script = view.displayStyle.scheduleScript;\n    this._currentScript = script?.requiresBatching ? script : undefined;\n\n    const includedModels = new Set(spec.models.keys());\n    this._excludedRefs = createSpatialTileTreeReferences(view, includedModels);\n\n    this._groups = new BatchedModelGroups(view, this._currentScript, includedModels, spec.models);\n    this._treeOwner = this.getTreeOwner();\n    this.loadRefs();\n\n    this.listenForScriptChange();\n  }\n\n  private ensureLoaded(): void {\n    if (!this._groups.update())\n      return;\n\n    this._treeOwner = this.getTreeOwner();\n    this.loadRefs();\n  }\n\n  private getTreeOwner(): TileTreeOwner {\n    return getBatchedTileTreeOwner(this._view.iModel, {\n      spec: this._spec,\n      script: this._currentScript,\n      modelGroups: this._groups.guid,\n    });\n  }\n\n  private listenForScriptChange(): void {\n    const onScriptChanged = (newScript: RenderSchedule.Script | undefined) => {\n      if (!newScript?.requiresBatching)\n        newScript = undefined;\n\n      const currentScript = this._currentScript;\n      this._currentScript = newScript;\n\n      if (newScript !== currentScript)\n        if (!newScript || !currentScript || !newScript.equals(currentScript))\n          this._groups.setScript(newScript);\n    };\n\n    let rmListener = this._view.displayStyle.onScheduleScriptChanged.addListener((newScript) => onScriptChanged(newScript));\n    this._view.onDisplayStyleChanged.addListener((newStyle) => {\n      rmListener();\n      onScriptChanged(newStyle.scheduleScript);\n      rmListener = this._view.displayStyle.onScheduleScriptChanged.addListener((newScript) => onScriptChanged(newScript));\n    });\n  }\n\n  private loadRefs(): void {\n    this._refs.length = 0;\n    const groups = this._groups.groups;\n    const args: BatchedTileTreeReferenceArgs = {\n      models: this._models,\n      groups,\n      treeOwner: this._treeOwner,\n      getCurrentTimePoint: () => this._currentScript ? (this._view.displayStyle.settings.timePoint ?? this._currentScript.duration.low) : 0,\n    };\n\n    for (let i = 0; i < groups.length; i++) {\n      const timeline = groups[i].timeline;\n      this._refs.push(new BatchedTileTreeReference(args, i, timeline ? AnimationNodeId.Untransformed : undefined));\n      if (timeline) {\n        for (const nodeId of timeline.transformBatchIds)\n          this._refs.push(new BatchedTileTreeReference(args, i, nodeId));\n      }\n    }\n  }\n\n  public *[Symbol.iterator](): Iterator<TileTreeReference> {\n    this.ensureLoaded();\n    for (const ref of this._refs)\n      yield ref;\n\n    for (const ref of this._excludedRefs)\n      yield ref;\n  }\n\n  public update(): void {\n    this._excludedRefs.update();\n    this._models.setViewedModels(this._view.modelSelector.models);\n    if (this._onModelSelectorChanged)\n      this._onModelSelectorChanged();\n  }\n\n  public attachToViewport(args: AttachToViewportArgs): void {\n    this._onModelSelectorChanged = () => args.invalidateSymbologyOverrides();\n    this._excludedRefs.attachToViewport(args);\n    this._removeSceneInvalidationListener = args.onSceneInvalidated.addListener(() => this._groups.invalidateTransforms());\n  }\n\n  public detachFromViewport(): void {\n    this._onModelSelectorChanged = undefined;\n    this._excludedRefs.detachFromViewport();\n\n    if (this._removeSceneInvalidationListener) {\n      this._removeSceneInvalidationListener();\n      this._removeSceneInvalidationListener = undefined;\n    }\n  }\n\n  // Collects the TileTreeReferences for the models that need to be drawn to create the planar clip mask.\n  // For every model used by the mask (modelIds), extend the maskRange by that model's range.\n  public collectMaskRefs(modelIds: OrderedId64Iterable, maskTreeRefs: TileTreeReference[], maskRange: Range3d): void {\n    for (const ref of this._refs) {\n      // For each ref, check to see whether one of the models that are needed are in its group's list of models.\n      const refModelIds = ref.groupModelIds;\n      if (refModelIds) {\n        let haveRefModel = false;\n        for (const modelId of modelIds) {\n          if (refModelIds.has(modelId)) {\n            if (!haveRefModel) {\n              maskTreeRefs.push(ref);\n              haveRefModel = true;\n            }\n            const modelRange = this._models.getModelExtents(modelId);\n            if (modelRange)\n              maskRange.extendRange(modelRange);\n          }\n        }\n      }\n    }\n    // Also need to collect refs from other tile trees which are not in the batched tile tree refs.\n    this._excludedRefs.collectMaskRefs(modelIds, maskTreeRefs, maskRange);\n  }\n\n  // Returns a list of the models that are NOT in the planar clip mask.\n  public getModelsNotInMask(maskModels: OrderedId64Iterable | undefined, useVisible: boolean): Id64String[] | undefined {\n    const modelsNotInMask: Id64String[] = [];\n    const includedModels = this._spec.models.keys();\n    if (useVisible) {\n      // All viewed models are in the mask, so get a list of all models which are not viewed.\n      for (const modelId of includedModels) {\n        if (!this._models.views(modelId))\n          modelsNotInMask.push(modelId);\n      }\n    } else {\n      // Get a list of all model which are NOT in the maskModels list.\n      const maskModelSet = new Set(maskModels);\n      for (const modelId of includedModels) {\n        if (!maskModelSet.has(modelId))\n          modelsNotInMask.push(modelId);\n      }\n    }\n    return modelsNotInMask.length > 0 ? modelsNotInMask : undefined;\n  }\n\n  // _view.models\n  public setDeactivated(): void {\n    // Used for debugging. Unimplemented here.\n  }\n}\n\n// A placeholder used by [[ProxySpatialTileTreeReferences]] until asynchronous loading completes.\n// It provides a TileTreeOwner that never loads a tile tree.\n// This ensures that [ViewState.areAllTileTreesLoaded]($frontend) will not return `true` while we are loading.\nclass ProxyTileTreeReference extends TileTreeReference {\n  private readonly _treeOwner: TileTreeOwner;\n\n  public constructor(iModel: IModelConnection) {\n    super();\n    this._treeOwner = {\n      iModel,\n      tileTree: undefined,\n      loadStatus: TileTreeLoadStatus.NotLoaded,\n      load: () => undefined,\n      dispose: () => { },\n      loadTree: async () => Promise.resolve(undefined),\n    };\n  }\n\n  public override get treeOwner() {\n    return this._treeOwner;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  public override get _isLoadingComplete() {\n    return false;\n  }\n}\n\n// Serves as a placeholder while we asynchronously obtain the base URL for a pre-published tileset (or asynchronously determine\n// that no such tileset exists).\nclass ProxySpatialTileTreeReferences implements SpatialTileTreeReferences {\n  // Once async loading completes, all methods will be forwarded to this implementation.\n  private _impl?: SpatialTileTreeReferences;\n  private readonly _proxyRef: ProxyTileTreeReference;\n  // Retained if attachToViewport is called while we are still loading; and reset if detachFromViewport is called while loading.\n  private _attachArgs?: AttachToViewportArgs;\n\n  public constructor(view: SpatialViewState, getSpec: Promise<BatchedTilesetSpec | null>) {\n    this._proxyRef = new ProxyTileTreeReference(view.iModel);\n    getSpec.then((spec: BatchedTilesetSpec | null) => {\n      if (spec) {\n        this.setTreeRefs(new BatchedSpatialTileTreeReferences(spec, view));\n      } else {\n        this.setTreeRefs(createSpatialTileTreeReferences(view));\n      }\n    }).catch(() => {\n      this.setTreeRefs(createSpatialTileTreeReferences(view));\n    });\n  }\n\n  private setTreeRefs(refs: SpatialTileTreeReferences): void {\n    this._impl = refs;\n    if (this._attachArgs) {\n      this._impl.attachToViewport(this._attachArgs);\n      this._attachArgs.invalidateSymbologyOverrides();\n      this._attachArgs = undefined;\n    }\n  }\n\n  public update(): void {\n    this._impl?.update();\n  }\n\n  public attachToViewport(args: AttachToViewportArgs): void {\n    if (this._impl)\n      this._impl.attachToViewport(args);\n    else\n      this._attachArgs = args;\n  }\n\n  public detachFromViewport(): void {\n    if (this._impl)\n      this._impl.detachFromViewport();\n    else\n      this._attachArgs = undefined;\n  }\n\n  public setDeactivated(): void { }\n\n  public *[Symbol.iterator](): Iterator<TileTreeReference> {\n    if (this._impl) {\n      for (const ref of this._impl)\n        yield ref;\n    } else {\n      yield this._proxyRef;\n    }\n  }\n\n  public collectMaskRefs(modelIds: OrderedId64Iterable, maskTreeRefs: TileTreeReference[], maskRange: Range3d): void {\n    this._impl?.collectMaskRefs(modelIds, maskTreeRefs, maskRange);\n  }\n\n  public getModelsNotInMask(maskModels: OrderedId64Iterable | undefined, useVisible: boolean): Id64String[] | undefined {\n    if (this._impl)\n      return this._impl.getModelsNotInMask(maskModels, useVisible);\n    else\n      return undefined;\n  }\n}\n\nconst iModelToTilesetSpec = new Map<IModelConnection, BatchedTilesetSpec | null | Promise<BatchedTilesetSpec | null>>();\n\nasync function fetchTilesetSpec(iModel: IModelConnection, computeBaseUrl: ComputeSpatialTilesetBaseUrl): Promise<BatchedTilesetSpec | null> {\n  try {\n    const baseUrl = await computeBaseUrl(iModel);\n    if (undefined === baseUrl)\n      return null;\n\n    const url = new URL(\"tileset.json\", baseUrl);\n    url.search = baseUrl.search;\n    const response = await fetch(url.toString());\n    const json = await response.json();\n    return BatchedTilesetSpec.create(baseUrl, json);\n  } catch (err) {\n    Logger.logException(loggerCategory, err);\n    return null;\n  }\n}\n\n/** @internal */\nexport function createBatchedSpatialTileTreeReferences(view: SpatialViewState, computeBaseUrl: ComputeSpatialTilesetBaseUrl): SpatialTileTreeReferences {\n  const iModel = view.iModel;\n  let entry = iModelToTilesetSpec.get(iModel);\n  if (undefined === entry) {\n    const promise = entry = fetchTilesetSpec(iModel, computeBaseUrl);\n    iModelToTilesetSpec.set(iModel, entry);\n    iModel.onClose.addOnce(() => iModelToTilesetSpec.delete(iModel));\n\n    promise.then((spec: BatchedTilesetSpec | null) => {\n      if (iModelToTilesetSpec.has(iModel))\n        iModelToTilesetSpec.set(iModel, spec);\n    }).catch(() => {\n      if (iModelToTilesetSpec.has(iModel))\n        iModelToTilesetSpec.set(iModel, null);\n    });\n  }\n\n  if (null === entry) {\n    // No tileset could be obtained for this iModel - use default tile generation instead.\n    return createSpatialTileTreeReferences(view);\n  }\n\n  if (entry instanceof Promise)\n    return new ProxySpatialTileTreeReferences(view, entry);\n\n  return new BatchedSpatialTileTreeReferences(entry, view);\n}\n\n"]}
+{"version":3,"file":"BatchedSpatialTileTreeRefs.js","sourceRoot":"","sources":["../../src/BatchedSpatialTileTreeRefs.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\nimport { Id64String, Logger, OrderedId64Iterable } from \"@itwin/core-bentley\";\nimport { RenderSchedule } from \"@itwin/core-common\";\nimport {\n  AnimationNodeId,\n  AttachToViewportArgs, createSpatialTileTreeReferences, IModelConnection, SpatialTileTreeReferences, SpatialViewState,\n  TileTreeLoadStatus, TileTreeOwner, TileTreeReference,\n  Viewport,\n} from \"@itwin/core-frontend\";\nimport {  BatchedTileTreeReference, BatchedTileTreeReferenceArgs  } from \"./BatchedTileTreeReference\";\nimport { getBatchedTileTreeOwner } from \"./BatchedTileTreeSupplier\";\nimport { BatchedModels } from \"./BatchedModels\";\nimport { ComputeSpatialTilesetBaseUrl } from \"./FrontendTiles\";\nimport { BatchedTilesetSpec } from \"./BatchedTilesetReader\";\nimport { loggerCategory } from \"./LoggerCategory\";\nimport { BatchedModelGroups } from \"./BatchedModelGroups\";\nimport { Range3d } from \"@itwin/core-geometry\";\n\n// Obtains tiles pre-published by mesh export service.\nclass BatchedSpatialTileTreeReferences implements SpatialTileTreeReferences {\n  private readonly _view: SpatialViewState;\n  private readonly _models: BatchedModels;\n  private readonly _groups: BatchedModelGroups;\n  private readonly _spec: BatchedTilesetSpec;\n  private _treeOwner: TileTreeOwner;\n  private _refs: BatchedTileTreeReference[] = [];\n  private _currentScript?: RenderSchedule.Script;\n  private _onModelSelectorChanged?: () => void;\n  /** Provides tile trees for models that are not included in the batched tile set. */\n  private readonly _excludedRefs: SpatialTileTreeReferences;\n  private _removeSceneInvalidationListener?: () => void;\n\n  public constructor(spec: BatchedTilesetSpec, view: SpatialViewState) {\n    this._view = view;\n    this._models = new BatchedModels(view, spec.models);\n    this._spec = spec;\n\n    const script = view.displayStyle.scheduleScript;\n    this._currentScript = script?.requiresBatching ? script : undefined;\n\n    const includedModels = new Set(spec.models.keys());\n    this._excludedRefs = createSpatialTileTreeReferences(view, includedModels);\n\n    this._groups = new BatchedModelGroups(view, this._currentScript, includedModels, spec.models);\n    this._treeOwner = this.getTreeOwner();\n    this.loadRefs();\n\n    this.listenForScriptChange();\n  }\n\n  private ensureLoaded(): void {\n    if (!this._groups.update())\n      return;\n\n    this._treeOwner = this.getTreeOwner();\n    this.loadRefs();\n  }\n\n  private getTreeOwner(): TileTreeOwner {\n    return getBatchedTileTreeOwner(this._view.iModel, {\n      spec: this._spec,\n      script: this._currentScript,\n      modelGroups: this._groups.guid,\n    });\n  }\n\n  private listenForScriptChange(): void {\n    const onScriptChanged = (newScript: RenderSchedule.Script | undefined) => {\n      if (!newScript?.requiresBatching)\n        newScript = undefined;\n\n      const currentScript = this._currentScript;\n      this._currentScript = newScript;\n\n      if (newScript !== currentScript)\n        if (!newScript || !currentScript || !newScript.equals(currentScript))\n          this._groups.setScript(newScript);\n    };\n\n    let rmListener = this._view.displayStyle.onScheduleScriptChanged.addListener((newScript) => onScriptChanged(newScript));\n    this._view.onDisplayStyleChanged.addListener((newStyle) => {\n      rmListener();\n      onScriptChanged(newStyle.scheduleScript);\n      rmListener = this._view.displayStyle.onScheduleScriptChanged.addListener((newScript) => onScriptChanged(newScript));\n    });\n  }\n\n  private loadRefs(): void {\n    this._refs.length = 0;\n    const groups = this._groups.groups;\n    const args: BatchedTileTreeReferenceArgs = {\n      models: this._models,\n      groups,\n      treeOwner: this._treeOwner,\n      getCurrentTimePoint: () => this._currentScript ? (this._view.displayStyle.settings.timePoint ?? this._currentScript.duration.low) : 0,\n    };\n\n    for (let i = 0; i < groups.length; i++) {\n      const timeline = groups[i].timeline;\n      this._refs.push(new BatchedTileTreeReference(args, i, timeline ? AnimationNodeId.Untransformed : undefined));\n      if (timeline) {\n        for (const nodeId of timeline.transformBatchIds)\n          this._refs.push(new BatchedTileTreeReference(args, i, nodeId));\n      }\n    }\n  }\n\n  public *[Symbol.iterator](): Iterator<TileTreeReference> {\n    this.ensureLoaded();\n    for (const ref of this._refs)\n      yield ref;\n\n    for (const ref of this._excludedRefs)\n      yield ref;\n  }\n\n  public update(): void {\n    this._excludedRefs.update();\n    this._models.setViewedModels(this._view.modelSelector.models);\n    if (this._onModelSelectorChanged)\n      this._onModelSelectorChanged();\n  }\n\n  public attachToViewport(args: AttachToViewportArgs): void {\n    this._onModelSelectorChanged = () => args.invalidateSymbologyOverrides();\n    this._excludedRefs.attachToViewport(args);\n    this._removeSceneInvalidationListener = args.onSceneInvalidated.addListener(() => this._groups.invalidateTransforms());\n  }\n\n  public detachFromViewport(): void {\n    this._onModelSelectorChanged = undefined;\n    this._excludedRefs.detachFromViewport();\n\n    if (this._removeSceneInvalidationListener) {\n      this._removeSceneInvalidationListener();\n      this._removeSceneInvalidationListener = undefined;\n    }\n  }\n\n  // Collects the TileTreeReferences for the models that need to be drawn to create the planar clip mask.\n  // For every model used by the mask (modelIds), extend the maskRange by that model's range.\n  public collectMaskRefs(modelIds: OrderedId64Iterable, maskTreeRefs: TileTreeReference[], maskRange: Range3d): void {\n    for (const ref of this._refs) {\n      // For each ref, check to see whether one of the models that are needed are in its group's list of models.\n      const refModelIds = ref.groupModelIds;\n      if (refModelIds) {\n        let haveRefModel = false;\n        for (const modelId of modelIds) {\n          if (refModelIds.has(modelId)) {\n            if (!haveRefModel) {\n              maskTreeRefs.push(ref);\n              haveRefModel = true;\n            }\n            const modelRange = this._models.getModelExtents(modelId);\n            if (modelRange)\n              maskRange.extendRange(modelRange);\n          }\n        }\n      }\n    }\n    // Also need to collect refs from other tile trees which are not in the batched tile tree refs.\n    this._excludedRefs.collectMaskRefs(modelIds, maskTreeRefs, maskRange);\n  }\n\n  // Returns a list of the models that are NOT in the planar clip mask.\n  public getModelsNotInMask(maskModels: OrderedId64Iterable | undefined, useVisible: boolean): Id64String[] | undefined {\n    const modelsNotInMask: Id64String[] = [];\n    const includedModels = this._spec.models.keys();\n    if (useVisible) {\n      // All viewed models are in the mask, so get a list of all models which are not viewed.\n      for (const modelId of includedModels) {\n        if (!this._models.views(modelId))\n          modelsNotInMask.push(modelId);\n      }\n    } else {\n      // Get a list of all model which are NOT in the maskModels list.\n      const maskModelSet = new Set(maskModels);\n      for (const modelId of includedModels) {\n        if (!maskModelSet.has(modelId))\n          modelsNotInMask.push(modelId);\n      }\n    }\n    return modelsNotInMask.length > 0 ? modelsNotInMask : undefined;\n  }\n\n  // _view.models\n  public setDeactivated(): void {\n    // Used for debugging. Unimplemented here.\n  }\n}\n\n// A placeholder used by [[ProxySpatialTileTreeReferences]] until asynchronous loading completes.\n// It provides a TileTreeOwner that never loads a tile tree.\n// This ensures that [ViewState.areAllTileTreesLoaded]($frontend) will not return `true` while we are loading.\nclass ProxyTileTreeReference extends TileTreeReference {\n  private readonly _treeOwner: TileTreeOwner;\n\n  public constructor(iModel: IModelConnection) {\n    super();\n    this._treeOwner = {\n      iModel,\n      tileTree: undefined,\n      loadStatus: TileTreeLoadStatus.NotLoaded,\n      load: () => undefined,\n      dispose: () => { },\n      loadTree: async () => Promise.resolve(undefined),\n    };\n  }\n\n  public override get treeOwner() {\n    return this._treeOwner;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  public override get _isLoadingComplete() {\n    return false;\n  }\n}\n\n// Serves as a placeholder while we asynchronously obtain the base URL for a pre-published tileset (or asynchronously determine\n// that no such tileset exists).\nclass ProxySpatialTileTreeReferences implements SpatialTileTreeReferences {\n  // Once async loading completes, all methods will be forwarded to this implementation.\n  private _impl?: SpatialTileTreeReferences;\n  private readonly _proxyRef: ProxyTileTreeReference;\n  // Retained if attachToViewport is called while we are still loading; and reset if detachFromViewport is called while loading.\n  private _attachArgs?: AttachToViewportArgs;\n\n  public constructor(view: SpatialViewState, getSpec: Promise<BatchedTilesetSpec | null>, nopFallback: boolean = false) {\n    this._proxyRef = new ProxyTileTreeReference(view.iModel);\n    getSpec.then((spec: BatchedTilesetSpec | null) => {\n      if (spec) {\n        this.setTreeRefs(new BatchedSpatialTileTreeReferences(spec, view));\n      } else if(nopFallback) {\n        this.setTreeRefs(new EmptySpatialTileTreeReferences());\n      }else {\n        this.setTreeRefs(createSpatialTileTreeReferences(view));\n      }\n    }).catch(() => {\n      if(nopFallback) {\n        this.setTreeRefs(new EmptySpatialTileTreeReferences());\n      }else {\n        this.setTreeRefs(createSpatialTileTreeReferences(view));\n      }\n    });\n  }\n\n  private setTreeRefs(refs: SpatialTileTreeReferences): void {\n    this._impl = refs;\n    if (this._attachArgs) {\n      this._impl.attachToViewport(this._attachArgs);\n      this._attachArgs.invalidateSymbologyOverrides();\n      this._attachArgs = undefined;\n    }\n  }\n\n  public update(): void {\n    this._impl?.update();\n  }\n\n  public attachToViewport(args: AttachToViewportArgs): void {\n    if (this._impl)\n      this._impl.attachToViewport(args);\n    else\n      this._attachArgs = args;\n  }\n\n  public detachFromViewport(): void {\n    if (this._impl)\n      this._impl.detachFromViewport();\n    else\n      this._attachArgs = undefined;\n  }\n\n  public setDeactivated(): void { }\n\n  public *[Symbol.iterator](): Iterator<TileTreeReference> {\n    if (this._impl) {\n      for (const ref of this._impl)\n        yield ref;\n    } else {\n      yield this._proxyRef;\n    }\n  }\n\n  public collectMaskRefs(modelIds: OrderedId64Iterable, maskTreeRefs: TileTreeReference[], maskRange: Range3d): void {\n    this._impl?.collectMaskRefs(modelIds, maskTreeRefs, maskRange);\n  }\n\n  public getModelsNotInMask(maskModels: OrderedId64Iterable | undefined, useVisible: boolean): Id64String[] | undefined {\n    if (this._impl)\n      return this._impl.getModelsNotInMask(maskModels, useVisible);\n    else\n      return undefined;\n  }\n}\n\nconst iModelToTilesetSpec = new Map<IModelConnection, BatchedTilesetSpec | null | Promise<BatchedTilesetSpec | null>>();\n\nasync function fetchTilesetSpec(iModel: IModelConnection, computeBaseUrl: ComputeSpatialTilesetBaseUrl): Promise<BatchedTilesetSpec | null> {\n  try {\n    const baseUrl = await computeBaseUrl(iModel);\n    if (undefined === baseUrl)\n      return null;\n\n    const url = new URL(\"tileset.json\", baseUrl);\n    url.search = baseUrl.search;\n    const response = await fetch(url.toString());\n    const json = await response.json();\n    return BatchedTilesetSpec.create(baseUrl, json);\n  } catch (err) {\n    Logger.logException(loggerCategory, err);\n    return null;\n  }\n}\n\nclass EmptySpatialTileTreeReferences implements SpatialTileTreeReferences {\n  public update(): void {}\n\n  public setDeactivated(_modelIds: string | string[] | undefined, _deactivated: boolean | undefined, _refs: \"all\" | \"animated\" | \"primary\" | \"section\" | number[]): void {}\n\n  public attachToViewport(_args: Viewport): void {}\n\n  public detachFromViewport(): void {}\n\n  public collectMaskRefs(_modelIds: OrderedId64Iterable, _maskTreeRefs: TileTreeReference[]): void {};\n\n  public getModelsNotInMask(_maskModels: OrderedId64Iterable | undefined, _useVisible: boolean): string[] | undefined {\n    return undefined;\n  }\n\n  public *[Symbol.iterator](): Iterator<TileTreeReference> {}\n}\n\n/** @internal */\nexport function createBatchedSpatialTileTreeReferences(view: SpatialViewState, computeBaseUrl: ComputeSpatialTilesetBaseUrl, nopFallback: boolean = false): SpatialTileTreeReferences {\n  const iModel = view.iModel;\n  let entry = iModelToTilesetSpec.get(iModel);\n  if (undefined === entry) {\n    const promise = entry = fetchTilesetSpec(iModel, computeBaseUrl);\n    iModelToTilesetSpec.set(iModel, entry);\n    iModel.onClose.addOnce(() => iModelToTilesetSpec.delete(iModel));\n\n    promise.then((spec: BatchedTilesetSpec | null) => {\n      if (iModelToTilesetSpec.has(iModel))\n        iModelToTilesetSpec.set(iModel, spec);\n    }).catch(() => {\n      if (iModelToTilesetSpec.has(iModel))\n        iModelToTilesetSpec.set(iModel, null);\n    });\n  }\n\n  if (null === entry) {\n    // No tileset could be obtained for this iModel - use empty tile tree if requested.\n    if (nopFallback) {\n      return new EmptySpatialTileTreeReferences();\n    }\n\n    // No tileset could be obtained for this iModel - use default tile generation instead.\n    return createSpatialTileTreeReferences(view);\n  }\n\n  if (entry instanceof Promise)\n    return new ProxySpatialTileTreeReferences(view, entry, nopFallback);\n\n  return new BatchedSpatialTileTreeReferences(entry, view);\n}\n\n"]}

package/lib/esm/FrontendTiles.d.ts

@@ -110,6 +110,11 @@ export interface FrontendTilesOptions {
     * @internal
     */
     useIndexedDBCache?: boolean;
+    /** If true, an empty tile tree will be used as fallback if the tileset is not found or invalid.
+     * If false or not defined, the default tiles will be used as a fallback.
+     * @internal
+     */
+    nopFallback?: boolean;
 }
 /** Global configuration initialized by [[initializeFrontendTiles]].
  * @internal

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

@@ -1 +1 @@
-{"version":3,"file":"FrontendTiles.d.ts","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,gBAAgB,EAA+C,MAAM,sBAAsB,CAAC;AAGhH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAA0B,0BAA0B,EAAC,MAAM,qCAAqC,CAAC;AAExG;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAElG;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,GAAG,CAAC;QACrB,oBAAoB,EAAE,GAAG,CAAC;KAC3B,CAAC;IAGF,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IAGtB,MAAM,EAAE;QACN,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qIAAqI;IACrI,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAuB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAsCrG;AAED;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,0BAA0B,CAAC;AAExE;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAE/G;AACD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;IAC5D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;MAGE;IACF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;CAIhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAe3E"}
+{"version":3,"file":"FrontendTiles.d.ts","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,gBAAgB,EAA+C,MAAM,sBAAsB,CAAC;AAGhH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAA0B,0BAA0B,EAAC,MAAM,qCAAqC,CAAC;AAExG;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAElG;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,GAAG,CAAC;QACrB,oBAAoB,EAAE,GAAG,CAAC;KAC3B,CAAC;IAGF,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IAGtB,MAAM,EAAE;QACN,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qIAAqI;IACrI,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAuB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAsCrG;AAED;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,0BAA0B,CAAC;AAExE;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAE/G;AACD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;IAC5D;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;MAGE;IACF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;CAIhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAe3E"}

package/lib/esm/FrontendTiles.js

@@ -75,6 +75,6 @@ export function initializeFrontendTiles(options) {
     if (options.useIndexedDBCache)
         frontendTilesOptions.useIndexedDBCache = true;
     const computeUrl = options.computeSpatialTilesetBaseUrl ?? (async (iModel) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken(), enableCDN: options.enableCDN }));
-    SpatialTileTreeReferences.create = (view) => createBatchedSpatialTileTreeReferences(view, computeUrl);
+    SpatialTileTreeReferences.create = (view) => createBatchedSpatialTileTreeReferences(view, computeUrl, options.nopFallback ?? false);
 }
 //# sourceMappingURL=FrontendTiles.js.map

package/lib/esm/FrontendTiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrontendTiles.js","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,OAAO,EAAE,SAAS,EAAoB,yBAAyB,EAAoB,MAAM,sBAAsB,CAAC;AAChH,OAAO,EAAE,sCAAsC,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAE/F,OAAO,EAAE,sBAAsB,EAA6B,MAAM,qCAAqC,CAAC;AAoExG;;;;GAIG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,gBAAgB,CAAC,IAA0B;IAChE,MAAM,YAAY,GAAG;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,UAAU,EAAE;YACV,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,EAAE,EAAE,IAAI,CAAC,QAAQ;YACjB,QAAQ,EAAE,IAAI,CAAC,WAAW;YAC1B,IAAI,EAAE,QAAQ;SACf;QACD,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;IAEF,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,2BAA2B,CAAC,YAAY,CAAC,EAAC,CAAC;QAClE,MAAM,UAAU,GAAG;YACjB,EAAE,EAAE,IAAI,CAAC,gBAAgB;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE;gBAC5B,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE;gBAC3C,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;gBAChC,eAAe,EAAE,EAAE;gBACnB,oBAAoB,EAAE,EAAE;aACzB;YAED,mEAAmE;YACnE,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;iBACrB;aACF;SACF,CAAC;QAEF,MAAM,UAAU,CAAC;IACnB,CAAC;AACH,CAAC;AAOD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,IAAoC;IACnF,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAqCD;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,eAAe,EAAE,CAAC;IAClB,WAAW,EAAE,KAAK;IAClB,iBAAiB,EAAE,KAAK;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA6B;IACnE,IAAI,SAAS,KAAK,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,eAAe,IAAI,CAAC;QACvE,oBAAoB,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAEjE,IAAI,OAAO,CAAC,WAAW;QACrB,oBAAoB,CAAC,WAAW,GAAG,IAAI,CAAC;IAE1C,IAAI,OAAO,CAAC,iBAAiB;QAC3B,oBAAoB,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAEhD,MAAM,UAAU,GAAG,OAAO,CAAC,4BAA4B,IAAI,CACzD,KAAK,EAAE,MAAwB,EAAE,EAAE,CAAC,0BAA0B,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CACxJ,CAAC;IAEF,yBAAyB,CAAC,MAAM,GAAG,CAAC,IAAsB,EAAE,EAAE,CAAC,sCAAsC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAC1H,CAAC","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\nimport { IModelApp, IModelConnection, SpatialTileTreeReferences, SpatialViewState } from \"@itwin/core-frontend\";\nimport { createBatchedSpatialTileTreeReferences } from \"./BatchedSpatialTileTreeRefs\";\nimport { queryGraphicRepresentations } from \"./GraphicsProvider/GraphicRepresentationProvider\";\nimport { AccessToken } from \"@itwin/core-bentley\";\nimport { obtainIModelTilesetUrl, ObtainIModelTilesetUrlArgs} from \"./GraphicsProvider/GraphicsProvider\";\n\n/** A function that can provide the base URL where a tileset representing all of the spatial models in a given iModel are stored.\n * The tileset is expected to reside at \"baseUrl/tileset.json\" and to have been produced by the [mesh export service](https://developer.bentley.com/apis/mesh-export/).\n * If no such tileset exists for the given iModel, return `undefined`.\n * @see [[FrontendTilesOptions.computeSpatialTilesetBaseUrl]].\n * @beta\n */\nexport type ComputeSpatialTilesetBaseUrl = (iModel: IModelConnection) => Promise<URL | undefined>;\n\n/** Represents the result of a [mesh export](https://developer.bentley.com/apis/mesh-export/operations/get-export/#export).\n * @see [[queryCompletedMeshExports]].\n * @beta\n */\nexport interface MeshExport {\n  id: string;\n  displayName: string;\n  status: string;\n  request: {\n    iModelId: string;\n    changesetId: string;\n    exportType: string;\n    geometryOptions: any;\n    viewDefinitionFilter: any;\n  };\n\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\n  _links: {\n    mesh: {\n      href: string;\n    };\n  };\n}\n\n/** Exposed strictly for tests.\n * @internal\n */\nexport interface MeshExports {\n  exports: MeshExport[];\n\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\n  _links: {\n    next?: {\n      href: string;\n    };\n  };\n}\n\n/** Arguments supplied to [[queryMeshExports]].\n * @beta\n */\nexport interface QueryMeshExportsArgs {\n  /** The token used to access the mesh export service. */\n  accessToken: AccessToken;\n  /** The iTwinId associated with the Mesh Export */\n  iTwinId: string;\n  /** The Id of the iModel for which to query exports. */\n  iModelId: string;\n  /** If defined, constrains the query to exports produced from the specified changeset. */\n  changesetId?: string;\n  /** Chiefly used in testing environments. */\n  urlPrefix?: string;\n  /** If true, exports whose status is not \"Complete\" (indicating the export successfully finished) will be included in the results. */\n  includeIncomplete?: boolean;\n  /** If true, enables a CDN (content delivery network) to access tiles faster. */\n  enableCDN?: boolean;\n}\n\n/** Query the [mesh export service](https://developer.bentley.com/apis/mesh-export/operations/get-exports/) for exports of type \"IMODEL\" matching\n * the specified criteria.\n * The exports are sorted from most-recently- to least-recently-produced.\n * @beta\n */\nexport async function* queryMeshExports(args: QueryMeshExportsArgs): AsyncIterableIterator<MeshExport> {\n  const graphicsArgs = {\n    accessToken: args.accessToken,\n    sessionId: IModelApp.sessionId,\n    dataSource: {\n      iTwinId: args.iTwinId,\n      id: args.iModelId,\n      changeId: args.changesetId,\n      type: \"IMODEL\",\n    },\n    format: \"IMDL\",\n    urlPrefix: args.urlPrefix,\n    enableCDN: args.enableCDN,\n  };\n\n  for await (const data of queryGraphicRepresentations(graphicsArgs)){\n    const meshExport = {\n      id: data.representationId,\n      displayName: data.displayName,\n      status: \"Complete\",\n      request: {\n        iModelId: data.dataSource.id,\n        changesetId: data.dataSource.changeId ?? \"\",\n        exportType: data.dataSource.type,\n        geometryOptions: {},\n        viewDefinitionFilter: {},\n      },\n\n      /* eslint-disable-next-line @typescript-eslint/naming-convention */\n      _links: {\n        mesh: {\n          href: data.url ?? \"\",\n        },\n      },\n    };\n\n    yield meshExport;\n  }\n}\n\n/** Arguments supplied  to [[obtainMeshExportTilesetUrl]].\n * @beta\n */\nexport type ObtainMeshExportTilesetUrlArgs = ObtainIModelTilesetUrlArgs;\n\n/** Obtains a URL pointing to a tileset appropriate for visualizing a specific iModel.\n * [[queryCompletedMeshExports]] is used to obtain a list of available exports. By default, the list is sorted from most to least recently-exported.\n * The first export matching the iModel's changeset is selected; or, if no such export exists, the first export in the list is selected.\n * @returns A URL from which the tileset can be loaded, or `undefined` if no appropriate URL could be obtained.\n * @beta\n */\nexport async function obtainMeshExportTilesetUrl(args: ObtainMeshExportTilesetUrlArgs): Promise<URL | undefined> {\n  return obtainIModelTilesetUrl(args);\n}\n/** Options supplied to [[initializeFrontendTiles]].\n * @beta\n */\nexport interface FrontendTilesOptions {\n  /** Provide the base URL for the pre-published tileset for a given iModel.\n   * If omitted, [[obtainMeshExportTilesetUrl]] will be invoked with default arguments, using the access token provided by [[IModelApp]].\n   */\n  computeSpatialTilesetBaseUrl?: ComputeSpatialTilesetBaseUrl;\n  /** The maximum number of levels in the tile tree to skip loading if they do not provide the desired level of detail for the current view.\n   * Default: 4.\n   * Reducing this value will load more intermediate tiles, which causes more gradual refinement: low-resolution tiles will display quickly, followed more gradually by\n   * successively higher-resolution ones.\n   * Increasing the value jumps more directly to tiles of the exact level of detail desired, which may load more, smaller tiles up-front, leaving some areas of the view\n   * vacant for longer; and when zooming out some newly-exposed areas of the view may remain vacant for longer because no lower-resolution tiles are initially available to\n   * fill them. However, tiles close to the viewer (and therefore likely of most interest to them) will refine to an appropriate level of detail more quickly.\n   */\n  maxLevelsToSkip?: number;\n  /** Specifies whether to permit the user to enable visible edges or wireframe mode for batched tiles.\n   * The currently-deployed mesh export service does not produce edges, so this currently defaults to `false` to avoid user confusion.\n   * Set it to `true` if you are loading tiles created with a version of the exporter that does produce edges.\n   * ###TODO delete this option once we deploy an edge-producing version of the exporter to production.\n   * @internal\n   */\n  enableEdges?: boolean;\n  /** Specifies whether to enable a CDN (content delivery network) to access tiles faster.\n   * This option is only used if computeSpatialTilesetBaseUrl is not defined.\n   * @beta\n   */\n  enableCDN?: boolean;\n  /** Specifies whether to enable an IndexedDB database for use as a local cache.\n  * Requested tiles will then first be search for in the database, and if not found, fetched as normal.\n  * @internal\n  */\n  useIndexedDBCache?: boolean;\n}\n\n/** Global configuration initialized by [[initializeFrontendTiles]].\n * @internal\n */\nexport const frontendTilesOptions = {\n  maxLevelsToSkip: 4,\n  enableEdges: false,\n  useIndexedDBCache: false,\n};\n\n/** Initialize the frontend-tiles package to obtain tiles for spatial views.\n * @beta\n */\nexport function initializeFrontendTiles(options: FrontendTilesOptions): void {\n  if (undefined !== options.maxLevelsToSkip && options.maxLevelsToSkip >= 0)\n    frontendTilesOptions.maxLevelsToSkip = options.maxLevelsToSkip;\n\n  if (options.enableEdges)\n    frontendTilesOptions.enableEdges = true;\n\n  if (options.useIndexedDBCache)\n    frontendTilesOptions.useIndexedDBCache = true;\n\n  const computeUrl = options.computeSpatialTilesetBaseUrl ?? (\n    async (iModel: IModelConnection) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken(), enableCDN: options.enableCDN })\n  );\n\n  SpatialTileTreeReferences.create = (view: SpatialViewState) => createBatchedSpatialTileTreeReferences(view, computeUrl);\n}\n"]}
+{"version":3,"file":"FrontendTiles.js","sourceRoot":"","sources":["../../src/FrontendTiles.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,OAAO,EAAE,SAAS,EAAoB,yBAAyB,EAAoB,MAAM,sBAAsB,CAAC;AAChH,OAAO,EAAE,sCAAsC,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAE/F,OAAO,EAAE,sBAAsB,EAA6B,MAAM,qCAAqC,CAAC;AAoExG;;;;GAIG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,gBAAgB,CAAC,IAA0B;IAChE,MAAM,YAAY,GAAG;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,UAAU,EAAE;YACV,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,EAAE,EAAE,IAAI,CAAC,QAAQ;YACjB,QAAQ,EAAE,IAAI,CAAC,WAAW;YAC1B,IAAI,EAAE,QAAQ;SACf;QACD,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;IAEF,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,2BAA2B,CAAC,YAAY,CAAC,EAAC,CAAC;QAClE,MAAM,UAAU,GAAG;YACjB,EAAE,EAAE,IAAI,CAAC,gBAAgB;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE;gBAC5B,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE;gBAC3C,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;gBAChC,eAAe,EAAE,EAAE;gBACnB,oBAAoB,EAAE,EAAE;aACzB;YAED,mEAAmE;YACnE,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;iBACrB;aACF;SACF,CAAC;QAEF,MAAM,UAAU,CAAC;IACnB,CAAC;AACH,CAAC;AAOD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,IAAoC;IACnF,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AA2CD;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,eAAe,EAAE,CAAC;IAClB,WAAW,EAAE,KAAK;IAClB,iBAAiB,EAAE,KAAK;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA6B;IACnE,IAAI,SAAS,KAAK,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,eAAe,IAAI,CAAC;QACvE,oBAAoB,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAEjE,IAAI,OAAO,CAAC,WAAW;QACrB,oBAAoB,CAAC,WAAW,GAAG,IAAI,CAAC;IAE1C,IAAI,OAAO,CAAC,iBAAiB;QAC3B,oBAAoB,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAEhD,MAAM,UAAU,GAAG,OAAO,CAAC,4BAA4B,IAAI,CACzD,KAAK,EAAE,MAAwB,EAAE,EAAE,CAAC,0BAA0B,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CACxJ,CAAC;IAEF,yBAAyB,CAAC,MAAM,GAAG,CAAC,IAAsB,EAAE,EAAE,CAAC,sCAAsC,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC,CAAC;AACxJ,CAAC","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\nimport { IModelApp, IModelConnection, SpatialTileTreeReferences, SpatialViewState } from \"@itwin/core-frontend\";\nimport { createBatchedSpatialTileTreeReferences } from \"./BatchedSpatialTileTreeRefs\";\nimport { queryGraphicRepresentations } from \"./GraphicsProvider/GraphicRepresentationProvider\";\nimport { AccessToken } from \"@itwin/core-bentley\";\nimport { obtainIModelTilesetUrl, ObtainIModelTilesetUrlArgs} from \"./GraphicsProvider/GraphicsProvider\";\n\n/** A function that can provide the base URL where a tileset representing all of the spatial models in a given iModel are stored.\n * The tileset is expected to reside at \"baseUrl/tileset.json\" and to have been produced by the [mesh export service](https://developer.bentley.com/apis/mesh-export/).\n * If no such tileset exists for the given iModel, return `undefined`.\n * @see [[FrontendTilesOptions.computeSpatialTilesetBaseUrl]].\n * @beta\n */\nexport type ComputeSpatialTilesetBaseUrl = (iModel: IModelConnection) => Promise<URL | undefined>;\n\n/** Represents the result of a [mesh export](https://developer.bentley.com/apis/mesh-export/operations/get-export/#export).\n * @see [[queryCompletedMeshExports]].\n * @beta\n */\nexport interface MeshExport {\n  id: string;\n  displayName: string;\n  status: string;\n  request: {\n    iModelId: string;\n    changesetId: string;\n    exportType: string;\n    geometryOptions: any;\n    viewDefinitionFilter: any;\n  };\n\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\n  _links: {\n    mesh: {\n      href: string;\n    };\n  };\n}\n\n/** Exposed strictly for tests.\n * @internal\n */\nexport interface MeshExports {\n  exports: MeshExport[];\n\n  /* eslint-disable-next-line @typescript-eslint/naming-convention */\n  _links: {\n    next?: {\n      href: string;\n    };\n  };\n}\n\n/** Arguments supplied to [[queryMeshExports]].\n * @beta\n */\nexport interface QueryMeshExportsArgs {\n  /** The token used to access the mesh export service. */\n  accessToken: AccessToken;\n  /** The iTwinId associated with the Mesh Export */\n  iTwinId: string;\n  /** The Id of the iModel for which to query exports. */\n  iModelId: string;\n  /** If defined, constrains the query to exports produced from the specified changeset. */\n  changesetId?: string;\n  /** Chiefly used in testing environments. */\n  urlPrefix?: string;\n  /** If true, exports whose status is not \"Complete\" (indicating the export successfully finished) will be included in the results. */\n  includeIncomplete?: boolean;\n  /** If true, enables a CDN (content delivery network) to access tiles faster. */\n  enableCDN?: boolean;\n}\n\n/** Query the [mesh export service](https://developer.bentley.com/apis/mesh-export/operations/get-exports/) for exports of type \"IMODEL\" matching\n * the specified criteria.\n * The exports are sorted from most-recently- to least-recently-produced.\n * @beta\n */\nexport async function* queryMeshExports(args: QueryMeshExportsArgs): AsyncIterableIterator<MeshExport> {\n  const graphicsArgs = {\n    accessToken: args.accessToken,\n    sessionId: IModelApp.sessionId,\n    dataSource: {\n      iTwinId: args.iTwinId,\n      id: args.iModelId,\n      changeId: args.changesetId,\n      type: \"IMODEL\",\n    },\n    format: \"IMDL\",\n    urlPrefix: args.urlPrefix,\n    enableCDN: args.enableCDN,\n  };\n\n  for await (const data of queryGraphicRepresentations(graphicsArgs)){\n    const meshExport = {\n      id: data.representationId,\n      displayName: data.displayName,\n      status: \"Complete\",\n      request: {\n        iModelId: data.dataSource.id,\n        changesetId: data.dataSource.changeId ?? \"\",\n        exportType: data.dataSource.type,\n        geometryOptions: {},\n        viewDefinitionFilter: {},\n      },\n\n      /* eslint-disable-next-line @typescript-eslint/naming-convention */\n      _links: {\n        mesh: {\n          href: data.url ?? \"\",\n        },\n      },\n    };\n\n    yield meshExport;\n  }\n}\n\n/** Arguments supplied  to [[obtainMeshExportTilesetUrl]].\n * @beta\n */\nexport type ObtainMeshExportTilesetUrlArgs = ObtainIModelTilesetUrlArgs;\n\n/** Obtains a URL pointing to a tileset appropriate for visualizing a specific iModel.\n * [[queryCompletedMeshExports]] is used to obtain a list of available exports. By default, the list is sorted from most to least recently-exported.\n * The first export matching the iModel's changeset is selected; or, if no such export exists, the first export in the list is selected.\n * @returns A URL from which the tileset can be loaded, or `undefined` if no appropriate URL could be obtained.\n * @beta\n */\nexport async function obtainMeshExportTilesetUrl(args: ObtainMeshExportTilesetUrlArgs): Promise<URL | undefined> {\n  return obtainIModelTilesetUrl(args);\n}\n/** Options supplied to [[initializeFrontendTiles]].\n * @beta\n */\nexport interface FrontendTilesOptions {\n  /** Provide the base URL for the pre-published tileset for a given iModel.\n   * If omitted, [[obtainMeshExportTilesetUrl]] will be invoked with default arguments, using the access token provided by [[IModelApp]].\n   */\n  computeSpatialTilesetBaseUrl?: ComputeSpatialTilesetBaseUrl;\n  /** The maximum number of levels in the tile tree to skip loading if they do not provide the desired level of detail for the current view.\n   * Default: 4.\n   * Reducing this value will load more intermediate tiles, which causes more gradual refinement: low-resolution tiles will display quickly, followed more gradually by\n   * successively higher-resolution ones.\n   * Increasing the value jumps more directly to tiles of the exact level of detail desired, which may load more, smaller tiles up-front, leaving some areas of the view\n   * vacant for longer; and when zooming out some newly-exposed areas of the view may remain vacant for longer because no lower-resolution tiles are initially available to\n   * fill them. However, tiles close to the viewer (and therefore likely of most interest to them) will refine to an appropriate level of detail more quickly.\n   */\n  maxLevelsToSkip?: number;\n  /** Specifies whether to permit the user to enable visible edges or wireframe mode for batched tiles.\n   * The currently-deployed mesh export service does not produce edges, so this currently defaults to `false` to avoid user confusion.\n   * Set it to `true` if you are loading tiles created with a version of the exporter that does produce edges.\n   * ###TODO delete this option once we deploy an edge-producing version of the exporter to production.\n   * @internal\n   */\n  enableEdges?: boolean;\n  /** Specifies whether to enable a CDN (content delivery network) to access tiles faster.\n   * This option is only used if computeSpatialTilesetBaseUrl is not defined.\n   * @beta\n   */\n  enableCDN?: boolean;\n  /** Specifies whether to enable an IndexedDB database for use as a local cache.\n  * Requested tiles will then first be search for in the database, and if not found, fetched as normal.\n  * @internal\n  */\n  useIndexedDBCache?: boolean;\n\n  /** If true, an empty tile tree will be used as fallback if the tileset is not found or invalid.\n   * If false or not defined, the default tiles will be used as a fallback.\n   * @internal\n   */\n  nopFallback?: boolean;\n}\n\n/** Global configuration initialized by [[initializeFrontendTiles]].\n * @internal\n */\nexport const frontendTilesOptions = {\n  maxLevelsToSkip: 4,\n  enableEdges: false,\n  useIndexedDBCache: false,\n};\n\n/** Initialize the frontend-tiles package to obtain tiles for spatial views.\n * @beta\n */\nexport function initializeFrontendTiles(options: FrontendTilesOptions): void {\n  if (undefined !== options.maxLevelsToSkip && options.maxLevelsToSkip >= 0)\n    frontendTilesOptions.maxLevelsToSkip = options.maxLevelsToSkip;\n\n  if (options.enableEdges)\n    frontendTilesOptions.enableEdges = true;\n\n  if (options.useIndexedDBCache)\n    frontendTilesOptions.useIndexedDBCache = true;\n\n  const computeUrl = options.computeSpatialTilesetBaseUrl ?? (\n    async (iModel: IModelConnection) => obtainMeshExportTilesetUrl({ iModel, accessToken: await IModelApp.getAccessToken(), enableCDN: options.enableCDN })\n  );\n\n  SpatialTileTreeReferences.create = (view: SpatialViewState) => createBatchedSpatialTileTreeReferences(view, computeUrl, options.nopFallback ?? false);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/frontend-tiles",
-  "version": "4.8.0-dev.19",
+  "version": "4.8.0-dev.20",
   "description": "Experimental alternative technique for visualizing the contents of iModels",
   "main": "lib/cjs/frontend-tiles.js",
   "module": "lib/esm/frontend-tiles.js",
@@ -21,10 +21,10 @@
     "url": "http://www.bentley.com"
   },
   "peerDependencies": {
-    "@itwin/core-bentley": "4.8.0-dev.19",
-    "@itwin/core-common": "4.8.0-dev.19",
-    "@itwin/core-geometry": "4.8.0-dev.19",
-    "@itwin/core-frontend": "4.8.0-dev.19"
+    "@itwin/core-bentley": "4.8.0-dev.20",
+    "@itwin/core-common": "4.8.0-dev.20",
+    "@itwin/core-frontend": "4.8.0-dev.20",
+    "@itwin/core-geometry": "4.8.0-dev.20"
   },
   "devDependencies": {
     "@itwin/eslint-plugin": "^4.0.2",
@@ -45,12 +45,12 @@
     "source-map-loader": "^4.0.0",
     "typescript": "~5.3.3",
     "webpack": "^5.76.0",
-    "@itwin/build-tools": "4.8.0-dev.19",
-    "@itwin/core-bentley": "4.8.0-dev.19",
-    "@itwin/certa": "4.8.0-dev.19",
-    "@itwin/core-common": "4.8.0-dev.19",
-    "@itwin/core-frontend": "4.8.0-dev.19",
-    "@itwin/core-geometry": "4.8.0-dev.19"
+    "@itwin/build-tools": "4.8.0-dev.20",
+    "@itwin/core-common": "4.8.0-dev.20",
+    "@itwin/core-bentley": "4.8.0-dev.20",
+    "@itwin/certa": "4.8.0-dev.20",
+    "@itwin/core-frontend": "4.8.0-dev.20",
+    "@itwin/core-geometry": "4.8.0-dev.20"
   },
   "scripts": {
     "build": "npm run -s build:cjs && npm run -s build:esm",