@itwin/presentation-frontend 4.5.0-dev.8 → 4.5.0

package/lib/cjs/presentation-frontend/selection/SelectionHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionHandler.js","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionHandler.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module UnifiedSelection\n */\n\nimport { DisposableList, IDisposable } from \"@itwin/core-bentley\";\nimport { IModelConnection } from \"@itwin/core-frontend\";\nimport { Keys, KeySet } from \"@itwin/presentation-common\";\nimport { ISelectionProvider } from \"./ISelectionProvider\";\nimport { SelectionChangeEventArgs, SelectionChangesListener } from \"./SelectionChangeEvent\";\nimport { SelectionManager } from \"./SelectionManager\";\n\n/**\n * Properties for creating a `SelectionHandler` instance.\n * @public\n */\nexport interface SelectionHandlerProps {\n  /** SelectionManager used to store overall selection. */\n  manager: SelectionManager;\n  /** iModel connection the selection changes will be associated with. */\n  imodel: IModelConnection;\n  /**\n   * Name of the selection handler. This is an identifier of what caused the\n   * selection to change, set as `SelectionChangeEventArgs.source` when firing\n   * selection change events. `SelectionHandler.shouldHandle` uses `name` to filter\n   * events that it doesn't need to handle.\n   */\n  name: string;\n  /**\n   * ID of presentation ruleset used by the component using this handler. The ID is set as\n   * `SelectionChangeEventArgs.rulesetId` when making selection changes and event\n   * listeners can use or ignore this information.\n   */\n  rulesetId?: string;\n  /** Callback function called when selection changes. */\n  onSelect?: SelectionChangesListener;\n}\n\n/**\n * A class that handles selection changes and helps to change\n * internal the selection state.\n *\n * @public\n */\nexport class SelectionHandler implements IDisposable {\n  private _inSelect: boolean;\n  private _disposables: DisposableList;\n\n  /** Selection manager used by this handler to manage selection */\n  public readonly manager: SelectionManager;\n  /** Name that's used as `SelectionChangeEventArgs.source` when making selection changes */\n  public name: string;\n  /** iModel whose selection is being handled */\n  public imodel: IModelConnection;\n  /**\n   * Id of a ruleset selection changes will be associated with.\n   * @see `SelectionHandlerProps.rulesetId`\n   */\n  public rulesetId?: string;\n  /** Callback function called when selection changes */\n  public onSelect?: SelectionChangesListener;\n\n  /**\n   * Constructor.\n   */\n  constructor(props: SelectionHandlerProps) {\n    this._inSelect = false;\n    this.manager = props.manager;\n    this._disposables = new DisposableList();\n    this.name = props.name;\n    this.rulesetId = props.rulesetId;\n    this.imodel = props.imodel;\n    this.onSelect = props.onSelect;\n    this._disposables.add(this.manager.selectionChange.addListener(this.onSelectionChanged));\n  }\n\n  /**\n   * Destructor. Must be called before disposing this object to make sure it cleans\n   * up correctly.\n   */\n  public dispose(): void {\n    this._disposables.dispose();\n  }\n\n  /**\n   * Called when the selection changes. Handles this callback by first checking whether\n   * the event should be handled at all (using the `shouldHandle` method) and then calling `onSelect`\n   */\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  protected onSelectionChanged = (evt: SelectionChangeEventArgs, provider: ISelectionProvider): void => {\n    if (!this.onSelect || !this.shouldHandle(evt))\n      return;\n\n    this._inSelect = true;\n    this.onSelect(evt, provider);\n    this._inSelect = false;\n  };\n\n  /** Called to check whether the event should be handled by this handler */\n  protected shouldHandle(evt: SelectionChangeEventArgs): boolean {\n    if (this.name === evt.source)\n      return false;\n    return true;\n  }\n\n  /** Get selection levels for the imodel managed by this handler */\n  public getSelectionLevels(): number[] {\n    return this.manager.getSelectionLevels(this.imodel);\n  }\n\n  /**\n   * Get selection for the imodel managed by this handler.\n   * @param level Level of the selection to get. Defaults to 0.\n   */\n  public getSelection(level?: number): Readonly<KeySet> {\n    return this.manager.getSelection(this.imodel, level);\n  }\n\n  /**\n   * Add to selection.\n   * @param keys The keys to add to selection.\n   * @param level Level of the selection.\n   */\n  public addToSelection(keys: Keys, level: number = 0): void {\n    if (this._inSelect)\n      return;\n\n    return this.manager.addToSelection(this.name, this.imodel, keys, level, this.rulesetId);\n  }\n\n  /**\n   * Remove from selection.\n   * @param keys The keys to remove from selection.\n   * @param level Level of the selection.\n   */\n  public removeFromSelection(keys: Keys, level: number = 0): void {\n    if (this._inSelect)\n      return;\n\n    return this.manager.removeFromSelection(this.name, this.imodel, keys, level, this.rulesetId);\n  }\n\n  /**\n   * Change selection.\n   * @param keys The keys indicating the new selection.\n   * @param level Level of the selection.\n   */\n  public replaceSelection(keys: Keys, level: number = 0): void {\n    if (this._inSelect)\n      return;\n\n    return this.manager.replaceSelection(this.name, this.imodel, keys, level, this.rulesetId);\n  }\n\n  /**\n   * Clear selection.\n   * @param level Level of the selection.\n   */\n  public clearSelection(level: number = 0): void {\n    if (this._inSelect)\n      return;\n\n    return this.manager.clearSelection(this.name, this.imodel, level, this.rulesetId);\n  }\n}\n"]}
+{"version":3,"file":"SelectionHandler.js","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionHandler.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n * See LICENSE.md in the project root for license terms and full copyright notice.\r\n *--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module UnifiedSelection\r\n */\r\n\r\nimport { DisposableList, IDisposable } from \"@itwin/core-bentley\";\r\nimport { IModelConnection } from \"@itwin/core-frontend\";\r\nimport { Keys, KeySet } from \"@itwin/presentation-common\";\r\nimport { ISelectionProvider } from \"./ISelectionProvider\";\r\nimport { SelectionChangeEventArgs, SelectionChangesListener } from \"./SelectionChangeEvent\";\r\nimport { SelectionManager } from \"./SelectionManager\";\r\n\r\n/**\r\n * Properties for creating a `SelectionHandler` instance.\r\n * @public\r\n */\r\nexport interface SelectionHandlerProps {\r\n  /** SelectionManager used to store overall selection. */\r\n  manager: SelectionManager;\r\n  /** iModel connection the selection changes will be associated with. */\r\n  imodel: IModelConnection;\r\n  /**\r\n   * Name of the selection handler. This is an identifier of what caused the\r\n   * selection to change, set as `SelectionChangeEventArgs.source` when firing\r\n   * selection change events. `SelectionHandler.shouldHandle` uses `name` to filter\r\n   * events that it doesn't need to handle.\r\n   */\r\n  name: string;\r\n  /**\r\n   * ID of presentation ruleset used by the component using this handler. The ID is set as\r\n   * `SelectionChangeEventArgs.rulesetId` when making selection changes and event\r\n   * listeners can use or ignore this information.\r\n   */\r\n  rulesetId?: string;\r\n  /** Callback function called when selection changes. */\r\n  onSelect?: SelectionChangesListener;\r\n}\r\n\r\n/**\r\n * A class that handles selection changes and helps to change\r\n * internal the selection state.\r\n *\r\n * @public\r\n */\r\nexport class SelectionHandler implements IDisposable {\r\n  private _inSelect: boolean;\r\n  private _disposables: DisposableList;\r\n\r\n  /** Selection manager used by this handler to manage selection */\r\n  public readonly manager: SelectionManager;\r\n  /** Name that's used as `SelectionChangeEventArgs.source` when making selection changes */\r\n  public name: string;\r\n  /** iModel whose selection is being handled */\r\n  public imodel: IModelConnection;\r\n  /**\r\n   * Id of a ruleset selection changes will be associated with.\r\n   * @see `SelectionHandlerProps.rulesetId`\r\n   */\r\n  public rulesetId?: string;\r\n  /** Callback function called when selection changes */\r\n  public onSelect?: SelectionChangesListener;\r\n\r\n  /**\r\n   * Constructor.\r\n   */\r\n  constructor(props: SelectionHandlerProps) {\r\n    this._inSelect = false;\r\n    this.manager = props.manager;\r\n    this._disposables = new DisposableList();\r\n    this.name = props.name;\r\n    this.rulesetId = props.rulesetId;\r\n    this.imodel = props.imodel;\r\n    this.onSelect = props.onSelect;\r\n    this._disposables.add(this.manager.selectionChange.addListener(this.onSelectionChanged));\r\n  }\r\n\r\n  /**\r\n   * Destructor. Must be called before disposing this object to make sure it cleans\r\n   * up correctly.\r\n   */\r\n  public dispose(): void {\r\n    this._disposables.dispose();\r\n  }\r\n\r\n  /**\r\n   * Called when the selection changes. Handles this callback by first checking whether\r\n   * the event should be handled at all (using the `shouldHandle` method) and then calling `onSelect`\r\n   */\r\n  // eslint-disable-next-line @typescript-eslint/naming-convention\r\n  protected onSelectionChanged = (evt: SelectionChangeEventArgs, provider: ISelectionProvider): void => {\r\n    if (!this.onSelect || !this.shouldHandle(evt)) {\r\n      return;\r\n    }\r\n\r\n    this._inSelect = true;\r\n    this.onSelect(evt, provider);\r\n    this._inSelect = false;\r\n  };\r\n\r\n  /** Called to check whether the event should be handled by this handler */\r\n  protected shouldHandle(evt: SelectionChangeEventArgs): boolean {\r\n    if (this.name === evt.source) {\r\n      return false;\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /** Get selection levels for the imodel managed by this handler */\r\n  public getSelectionLevels(): number[] {\r\n    return this.manager.getSelectionLevels(this.imodel);\r\n  }\r\n\r\n  /**\r\n   * Get selection for the imodel managed by this handler.\r\n   * @param level Level of the selection to get. Defaults to 0.\r\n   */\r\n  public getSelection(level?: number): Readonly<KeySet> {\r\n    return this.manager.getSelection(this.imodel, level);\r\n  }\r\n\r\n  /**\r\n   * Add to selection.\r\n   * @param keys The keys to add to selection.\r\n   * @param level Level of the selection.\r\n   */\r\n  public addToSelection(keys: Keys, level: number = 0): void {\r\n    if (this._inSelect) {\r\n      return;\r\n    }\r\n\r\n    return this.manager.addToSelection(this.name, this.imodel, keys, level, this.rulesetId);\r\n  }\r\n\r\n  /**\r\n   * Remove from selection.\r\n   * @param keys The keys to remove from selection.\r\n   * @param level Level of the selection.\r\n   */\r\n  public removeFromSelection(keys: Keys, level: number = 0): void {\r\n    if (this._inSelect) {\r\n      return;\r\n    }\r\n\r\n    return this.manager.removeFromSelection(this.name, this.imodel, keys, level, this.rulesetId);\r\n  }\r\n\r\n  /**\r\n   * Change selection.\r\n   * @param keys The keys indicating the new selection.\r\n   * @param level Level of the selection.\r\n   */\r\n  public replaceSelection(keys: Keys, level: number = 0): void {\r\n    if (this._inSelect) {\r\n      return;\r\n    }\r\n\r\n    return this.manager.replaceSelection(this.name, this.imodel, keys, level, this.rulesetId);\r\n  }\r\n\r\n  /**\r\n   * Clear selection.\r\n   * @param level Level of the selection.\r\n   */\r\n  public clearSelection(level: number = 0): void {\r\n    if (this._inSelect) {\r\n      return;\r\n    }\r\n\r\n    return this.manager.clearSelection(this.name, this.imodel, level, this.rulesetId);\r\n  }\r\n}\r\n"]}

package/lib/cjs/presentation-frontend/selection/SelectionHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionHelper.d.ts","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionHelper.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAW,MAAM,4BAA4B,CAAC;AAEhE;;;GAGG;AACH,qBAAa,eAAe;IAG1B,OAAO;IAEP;;;;OAIG;WACW,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE;CAe/D"}
+{"version":3,"file":"SelectionHelper.d.ts","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionHelper.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAW,MAAM,4BAA4B,CAAC;AAEhE;;;GAGG;AACH,qBAAa,eAAe;IAE1B,OAAO;IAEP;;;;OAIG;WACW,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE;CAe/D"}

package/lib/cjs/presentation-frontend/selection/SelectionHelper.js

@@ -1,8 +1,8 @@
 "use strict";
 /*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
 /** @packageDocumentation
  * @module UnifiedSelection
  */
@@ -25,10 +25,12 @@ class SelectionHelper {
         const result = new Array();
         keys.forEach((key) => {
             if (presentation_common_1.Key.isNodeKey(key)) {
-                if (presentation_common_1.NodeKey.isInstancesNodeKey(key))
+                if (presentation_common_1.NodeKey.isInstancesNodeKey(key)) {
                     result.push(...key.instanceKeys);
-                else
+                }
+                else {
                     result.push(key);
+                }
             }
             else {
                 result.push(key);

package/lib/cjs/presentation-frontend/selection/SelectionHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionHelper.js","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionHelper.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,oEAAgE;AAEhE;;;GAGG;AACH,MAAa,eAAe;IAE1B,uBAAuB;IACvB,gBAAwB,CAAC;IAEzB;;;;OAIG;IACI,MAAM,CAAC,mBAAmB,CAAC,IAAoB;QACpD,MAAM,MAAM,GAAG,IAAI,KAAK,EAAO,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAQ,EAAE,EAAE;YACxB,IAAI,yBAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE;gBACtB,IAAI,6BAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC;oBACjC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;;oBAEjC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aACpB;iBAAM;gBACL,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aAClB;QACH,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;CAEF;AAzBD,0CAyBC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module UnifiedSelection\n */\n\nimport { Key, Keys, NodeKey } from \"@itwin/presentation-common\";\n\n/**\n * Helper class for working with selection.\n * @public\n */\nexport class SelectionHelper {\n\n  // istanbul ignore next\n  private constructor() { }\n\n  /**\n   * Re-map the given keyset for selection. This means all instance node keys get converted\n   * to instance keys, because in that case we want to select instances instead of nodes. All\n   * other types of keys ar left as is.\n   */\n  public static getKeysForSelection(keys: Readonly<Keys>): Key[] {\n    const result = new Array<Key>();\n    keys.forEach((key: Key) => {\n      if (Key.isNodeKey(key)) {\n        if (NodeKey.isInstancesNodeKey(key))\n          result.push(...key.instanceKeys);\n        else\n          result.push(key);\n      } else {\n        result.push(key);\n      }\n    });\n    return result;\n  }\n\n}\n"]}
+{"version":3,"file":"SelectionHelper.js","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionHelper.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;AAChG;;GAEG;;;AAEH,oEAAgE;AAEhE;;;GAGG;AACH,MAAa,eAAe;IAC1B,uBAAuB;IACvB,gBAAuB,CAAC;IAExB;;;;OAIG;IACI,MAAM,CAAC,mBAAmB,CAAC,IAAoB;QACpD,MAAM,MAAM,GAAG,IAAI,KAAK,EAAO,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAQ,EAAE,EAAE;YACxB,IAAI,yBAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE;gBACtB,IAAI,6BAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE;oBACnC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;iBAClC;qBAAM;oBACL,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;iBAClB;aACF;iBAAM;gBACL,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aAClB;QACH,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAxBD,0CAwBC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n * See LICENSE.md in the project root for license terms and full copyright notice.\r\n *--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module UnifiedSelection\r\n */\r\n\r\nimport { Key, Keys, NodeKey } from \"@itwin/presentation-common\";\r\n\r\n/**\r\n * Helper class for working with selection.\r\n * @public\r\n */\r\nexport class SelectionHelper {\r\n  // istanbul ignore next\r\n  private constructor() {}\r\n\r\n  /**\r\n   * Re-map the given keyset for selection. This means all instance node keys get converted\r\n   * to instance keys, because in that case we want to select instances instead of nodes. All\r\n   * other types of keys ar left as is.\r\n   */\r\n  public static getKeysForSelection(keys: Readonly<Keys>): Key[] {\r\n    const result = new Array<Key>();\r\n    keys.forEach((key: Key) => {\r\n      if (Key.isNodeKey(key)) {\r\n        if (NodeKey.isInstancesNodeKey(key)) {\r\n          result.push(...key.instanceKeys);\r\n        } else {\r\n          result.push(key);\r\n        }\r\n      } else {\r\n        result.push(key);\r\n      }\r\n    });\r\n    return result;\r\n  }\r\n}\r\n"]}

package/lib/cjs/presentation-frontend/selection/SelectionManager.d.ts

@@ -4,6 +4,7 @@
 import { Id64Arg, IDisposable } from "@itwin/core-bentley";
 import { IModelConnection } from "@itwin/core-frontend";
 import { Keys, KeySet, SelectionScope, SelectionScopeProps } from "@itwin/presentation-common";
+import { SelectionStorage } from "@itwin/unified-selection";
 import { HiliteSet } from "./HiliteSetProvider";
 import { ISelectionProvider } from "./ISelectionProvider";
 import { SelectionChangeEvent } from "./SelectionChangeEvent";
@@ -15,15 +16,26 @@ import { SelectionScopesManager } from "./SelectionScopesManager";
 export interface SelectionManagerProps {
     /** A manager for [selection scopes]($docs/presentation/unified-selection/index#selection-scopes) */
     scopes: SelectionScopesManager;
+    /**
+     * Custom unified selection storage to be used by [[SelectionManager]]. If not provided [[SelectionManager]] creates
+     * and maintains storage.
+     */
+    selectionStorage?: SelectionStorage;
 }
 /**
  * The selection manager which stores the overall selection.
  * @public
  */
 export declare class SelectionManager implements ISelectionProvider {
-    private _selectionContainerMap;
+    private _selectionStorage;
     private _imodelToolSelectionSyncHandlers;
     private _hiliteSetProviders;
+    private _ownsStorage;
+    private _knownIModels;
+    private _currentSelection;
+    private _selectionChanges;
+    private _selectionEventsSubscription;
+    private _listeners;
     /** An event which gets broadcasted on selection changes */
     readonly selectionChange: SelectionChangeEvent;
     /** Manager for [selection scopes]($docs/presentation/unified-selection/index#selection-scopes) */
@@ -32,8 +44,8 @@ export declare class SelectionManager implements ISelectionProvider {
      * Creates an instance of SelectionManager.
      */
     constructor(props: SelectionManagerProps);
+    dispose(): void;
     private onConnectionClose;
-    private getContainer;
     /** @internal */
     getToolSelectionSyncHandler(imodel: IModelConnection): ToolSelectionSyncHandler | undefined;
     /**
@@ -47,7 +59,13 @@ export declare class SelectionManager implements ISelectionProvider {
     suspendIModelToolSelectionSync(imodel: IModelConnection): IDisposable;
     /** Get the selection levels currently stored in this manager for the specified imodel */
     getSelectionLevels(imodel: IModelConnection): number[];
-    /** Get the selection currently stored in this manager */
+    /**
+     * Get the selection currently stored in this manager
+     *
+     * @note Calling immediately after `add*`|`replace*`|`remove*`|`clear*` method call does not guarantee
+     * that returned `KeySet` will include latest changes. Listen for `selectionChange` event to get the
+     * latest selection after changes.
+     */
     getSelection(imodel: IModelConnection, level?: number): Readonly<KeySet>;
     private handleEvent;
     /**
@@ -126,6 +144,7 @@ export declare class SelectionManager implements ISelectionProvider {
      */
     getHiliteSetIterator(imodel: IModelConnection): AsyncIterableIterator<HiliteSet>;
     private getHiliteSetProvider;
+    private streamSelectionEvents;
 }
 /** @internal */
 export declare const TRANSIENT_ELEMENT_CLASSNAME = "/TRANSIENT";

package/lib/cjs/presentation-frontend/selection/SelectionManager.d.ts.map

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