@itwin/core-frontend 3.0.0-dev.97 → 3.0.0-extension.0

package/lib/cjs/extension/Extension.js

@@ -0,0 +1,39 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Extensions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/** Represents an Extension that we are attempting to load.
+  * @beta
+  */
+// export class PendingExtension {
+//   public resolve: ResolveFunc | undefined = undefined;
+//   public reject: RejectFunc | undefined = undefined;
+//   public promise: Promise<LocalExtensionProps>;
+//   public constructor(private _tarFileUrl: string, public loader: ExtensionLoader, public args?: string[]) {
+//     this.promise = new Promise(this.executor.bind(this));
+//   }
+//   public executor(resolve: ResolveFunc, reject: RejectFunc) {
+//     this.resolve = resolve;
+//     this.reject = reject;
+//     const head = document.getElementsByTagName("head")[0];
+//     if (!head)
+//       reject(new Error("no head element found"));
+//     // create the script element. We handle onerror and resolve a ExtensionLoadResult failure in the onerror handler,
+//     // but we don't resolve success until the loaded extension calls "register" (see Extension.register)
+//     const scriptElement = document.createElement("script");
+//     scriptElement.onerror = this.cantLoad.bind(this);
+//     scriptElement.async = true;
+//     scriptElement.src = this._tarFileUrl;
+//     head.insertBefore(scriptElement, head.lastChild);
+//   }
+//   // called when we can't load the URL
+//   private cantLoad(_ev: string | Event) {
+//     this.resolve!(IModelApp.i18n.translate("iModelJs:ExtensionErrors.CantFind", { extensionUrl: this._tarFileUrl }));
+//   }
+// }
+//# sourceMappingURL=Extension.js.map

package/lib/cjs/extension/Extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Extension.js","sourceRoot":"","sources":["../../../src/extension/Extension.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;AA0CH;;IAEI;AACJ,kCAAkC;AAClC,yDAAyD;AACzD,uDAAuD;AACvD,kDAAkD;AAElD,8GAA8G;AAC9G,4DAA4D;AAC5D,MAAM;AAEN,gEAAgE;AAChE,8BAA8B;AAC9B,4BAA4B;AAE5B,6DAA6D;AAC7D,iBAAiB;AACjB,oDAAoD;AAEpD,wHAAwH;AACxH,2GAA2G;AAC3G,8DAA8D;AAE9D,wDAAwD;AAExD,kCAAkC;AAClC,4CAA4C;AAC5C,wDAAwD;AACxD,MAAM;AAEN,yCAAyC;AACzC,4CAA4C;AAC5C,wHAAwH;AACxH,MAAM;AACN,IAAI","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 Extensions\r\n */\r\n\r\ntype ResolveFunc = (() => Promise<any>);\r\n\r\n/** Defines the format of an Extension manifest  */\r\nexport interface ExtensionManifest {\r\n  readonly name: string;\r\n  readonly displayName?: string;\r\n  readonly version: string;\r\n  readonly description?: string;\r\n  /** The main module file to load. This should be a path to the javascript file\r\n   * e.g \"./lib/main.js\"\r\n   */\r\n  readonly main?: string;\r\n  /** The version of iTwin.js Core. */\r\n  readonly engines?: { itwinjs: string };\r\n  /** List of activation events this Extension supports. */\r\n  readonly activationEvents?: string[];\r\n  readonly enableProposedApi?: boolean;\r\n}\r\n\r\nexport interface BuildExtensionManifest extends ExtensionManifest {\r\n  /** Only valid when the Extension is loaded at build-time.\r\n   *\r\n   * Defines how to load the Extension manifest and\r\n   */\r\n  readonly module?: string;\r\n}\r\n\r\n/** Describes an Extension that has already been downloaded and has a location files can be easily executed. */\r\nexport interface LocalExtensionProps {\r\n  readonly manifest: ExtensionManifest;\r\n  readonly mainFunc?: ResolveFunc;\r\n  /** Identifies a location of the Extension that it can be loaded.\r\n   *\r\n   * WIP:\r\n   *  - Could be a URL to the location of the Extension\r\n   *  - Could be a file path to an installed location locally.\r\n   */\r\n  // readonly location: string;\r\n}\r\n\r\n/** Represents an Extension that we are attempting to load.\r\n  * @beta\r\n  */\r\n// export class PendingExtension {\r\n//   public resolve: ResolveFunc | undefined = undefined;\r\n//   public reject: RejectFunc | undefined = undefined;\r\n//   public promise: Promise<LocalExtensionProps>;\r\n\r\n//   public constructor(private _tarFileUrl: string, public loader: ExtensionLoader, public args?: string[]) {\r\n//     this.promise = new Promise(this.executor.bind(this));\r\n//   }\r\n\r\n//   public executor(resolve: ResolveFunc, reject: RejectFunc) {\r\n//     this.resolve = resolve;\r\n//     this.reject = reject;\r\n\r\n//     const head = document.getElementsByTagName(\"head\")[0];\r\n//     if (!head)\r\n//       reject(new Error(\"no head element found\"));\r\n\r\n//     // create the script element. We handle onerror and resolve a ExtensionLoadResult failure in the onerror handler,\r\n//     // but we don't resolve success until the loaded extension calls \"register\" (see Extension.register)\r\n//     const scriptElement = document.createElement(\"script\");\r\n\r\n//     scriptElement.onerror = this.cantLoad.bind(this);\r\n\r\n//     scriptElement.async = true;\r\n//     scriptElement.src = this._tarFileUrl;\r\n//     head.insertBefore(scriptElement, head.lastChild);\r\n//   }\r\n\r\n//   // called when we can't load the URL\r\n//   private cantLoad(_ev: string | Event) {\r\n//     this.resolve!(IModelApp.i18n.translate(\"iModelJs:ExtensionErrors.CantFind\", { extensionUrl: this._tarFileUrl }));\r\n//   }\r\n// }\r\n"]}

package/lib/cjs/extension/ExtensionAdmin.d.ts

@@ -0,0 +1,70 @@
+/** @packageDocumentation
+ * @module Extensions
+ */
+import { ExtensionLoader } from "./ExtensionLoader";
+/** The Extensions loading system has 3 goals:
+ *   1. Only fetch what is needed when it is required
+ *      1. Load a manifest file
+ *      2. Load the the main module when necessary
+ *   2. Download the needed files from
+ *
+ * 3 ways to load an Extension into the system:
+ *
+ *  1. At build-time provide the function to load both the Extension Manifest and import the main module of the extension.
+ *     The main module must contain the activate() function.
+ *  2. A minimum set of ExtensionLoaderProps that provide enough information to get the manifest
+ *
+ * An Extension can be in 3 different states:
+ *   - Known
+ *      - The Extension Admin has the minimal information needed to fetch the manifest for the Extension.
+ *        knows the Extension exists but has not yet loaded the manifest
+ *   - Installed
+ *      - The Extension has the full manifest loaded and can be executed on the activation events
+ *   - Disabled
+ *      - The Extension has the full manifest but is not currently enabled and will not be executed based on the
+ *        activation events.
+ */
+declare type ResolveFunc = (() => Promise<any>);
+/** The Extension Admin controls the list of currently known, loaded and executing an Extension.
+ * Handles the loading of Extensions and maintains a list of the currently loaded Extensions.
+ *
+ * On application startup, an initial list of Extensions is gathered by searching in known locations for
+ *
+ * @alpha
+ */
+export declare class ExtensionAdmin {
+    /** The list of places to download an Extension.  */
+    private _extensionLoaders;
+    /** Defines the set of extensions that are currently known and can be invoked during activation events.  */
+    private _installedExtensions;
+    /**
+      * Fired when an Extension has been added or removed.
+      */
+    onStartup: () => Promise<void>;
+    constructor();
+    /** Adds an ExtensionLoader to the front of the list of extension loaders in use. Extension loaders will be invoked front to back.
+     * By default, the list consists of public Extension Service context, unless disabled via props.
+     * @param extensionLoader Extension loader to add
+     */
+    addExtensionLoaderFront(extensionLoader: ExtensionLoader): void;
+    /** Adds an ExtensionLoader to the list of extension loaders in use.
+      * By default, the list consists of public Extension Service context, unless disabled via props.
+      * @param extensionLoader Extension loader to add
+      */
+    addExtensionLoader(extensionLoader: ExtensionLoader): void;
+    /** Add an Extension to be bundled during compilation.
+     * @param manifestLoader A function that loads the manifest file.
+     * @param mainFunc The main function to be executed upon
+     */
+    addBuildExtension(manifestPromise: Promise<any>, mainFunc?: ResolveFunc): Promise<void>;
+    /** Loops over all enabled Extensions and triggers each one if the provided event is defined. */
+    private activateExtensionEvents;
+    /** Resolves an import function provided for build-time Extensions that should return a valid
+     * Extension Manifest.
+     */
+    private getManifest;
+    private parseManifest;
+    private execute;
+}
+export {};
+//# sourceMappingURL=ExtensionAdmin.d.ts.map

package/lib/cjs/extension/ExtensionAdmin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionAdmin.d.ts","sourceRoot":"","sources":["../../../src/extension/ExtensionAdmin.ts"],"names":[],"mappings":"AAIA;;GAEG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,aAAK,WAAW,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAOxC;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,oDAAoD;IACpD,OAAO,CAAC,iBAAiB,CAAyB;IAElD,2GAA2G;IAC3G,OAAO,CAAC,oBAAoB,CAA4E;IAExG;;QAEI;IAGG,SAAS,sBAEd;;IAMF;;;OAGG;IACI,uBAAuB,CAAC,eAAe,EAAE,eAAe;IAI/D;;;QAGI;IACG,kBAAkB,CAAC,eAAe,EAAE,eAAe;IAI1D;;;OAGG;IACU,iBAAiB,CAAC,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpG,gGAAgG;YAClF,uBAAuB;IAYrC;;OAEG;YACW,WAAW;YAMX,aAAa;YAiBb,OAAO;CAKtB"}

package/lib/cjs/extension/ExtensionAdmin.js

@@ -0,0 +1,105 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Extensions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtensionAdmin = void 0;
+// import { Extension, ExtensionLoader, ExtensionManifest, LocalExtensionProps, PendingExtension } from "./Extension";
+const IModelApp_1 = require("../IModelApp");
+// type RejectFunc = ((arg: Error) => void);
+var ActivationEvents;
+(function (ActivationEvents) {
+    ActivationEvents["onStartupApp"] = "onStartupApp";
+})(ActivationEvents || (ActivationEvents = {}));
+/** The Extension Admin controls the list of currently known, loaded and executing an Extension.
+ * Handles the loading of Extensions and maintains a list of the currently loaded Extensions.
+ *
+ * On application startup, an initial list of Extensions is gathered by searching in known locations for
+ *
+ * @alpha
+ */
+class ExtensionAdmin {
+    constructor() {
+        /** The list of places to download an Extension.  */
+        this._extensionLoaders = [];
+        /** Defines the set of extensions that are currently known and can be invoked during activation events.  */
+        this._installedExtensions = new Map();
+        /**
+          * Fired when an Extension has been added or removed.
+          */
+        // public readonly onInstallExtension = new BeEvent<(added: readonly ExtensionProps[], removed: readonly ExtensionProps[]) => void>();
+        this.onStartup = async () => {
+            await this.activateExtensionEvents(ActivationEvents.onStartupApp);
+        };
+        IModelApp_1.IModelApp.onBeforeStartup.addListener(this.onStartup);
+    }
+    /** Adds an ExtensionLoader to the front of the list of extension loaders in use. Extension loaders will be invoked front to back.
+     * By default, the list consists of public Extension Service context, unless disabled via props.
+     * @param extensionLoader Extension loader to add
+     */
+    addExtensionLoaderFront(extensionLoader) {
+        this._extensionLoaders.unshift(extensionLoader);
+    }
+    /** Adds an ExtensionLoader to the list of extension loaders in use.
+      * By default, the list consists of public Extension Service context, unless disabled via props.
+      * @param extensionLoader Extension loader to add
+      */
+    addExtensionLoader(extensionLoader) {
+        this._extensionLoaders.push(extensionLoader);
+    }
+    /** Add an Extension to be bundled during compilation.
+     * @param manifestLoader A function that loads the manifest file.
+     * @param mainFunc The main function to be executed upon
+     */
+    async addBuildExtension(manifestPromise, mainFunc) {
+        const manifest = await this.getManifest(manifestPromise);
+        this._installedExtensions.set(manifest.name, { manifest, mainFunc });
+    }
+    /** Loops over all enabled Extensions and triggers each one if the provided event is defined. */
+    async activateExtensionEvents(event) {
+        for (const extension of this._installedExtensions.values()) {
+            if (!extension.manifest.activationEvents)
+                continue;
+            for (const activationEvent of extension.manifest.activationEvents) {
+                if (activationEvent === event) {
+                    this.execute(extension); // eslint-disable-line @typescript-eslint/no-floating-promises
+                }
+            }
+        }
+    }
+    /** Resolves an import function provided for build-time Extensions that should return a valid
+     * Extension Manifest.
+     */
+    async getManifest(loader) {
+        const raw = await loader;
+        const manifest = this.parseManifest(raw);
+        return manifest;
+    }
+    async parseManifest(raw) {
+        try {
+            if ("object" === typeof (raw))
+                return raw;
+            if ("string" === typeof (raw))
+                return JSON.parse(raw);
+        }
+        catch (err) { }
+        throw new Error("Extension is invalid: package.json is not JSON.");
+    }
+    // Important: The Function constructor is used here to isolate the context in which the Extension javascript has access.
+    // By using the Function constructor to create and then execute the extension it will only have access to two scopes:
+    //  1. It's own function scope
+    //  2. The global scope
+    //
+    // The global scope is important for an Extension as that is where the reference to the Extension Implementation is supplied
+    // from the application side.
+    async execute(extension) {
+        if (extension.mainFunc)
+            return extension.mainFunc();
+    }
+}
+exports.ExtensionAdmin = ExtensionAdmin;
+//# sourceMappingURL=ExtensionAdmin.js.map

package/lib/cjs/extension/ExtensionAdmin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionAdmin.js","sourceRoot":"","sources":["../../../src/extension/ExtensionAdmin.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sHAAsH;AACtH,4CAAyC;AA4BzC,4CAA4C;AAE5C,IAAK,gBAEJ;AAFD,WAAK,gBAAgB;IACnB,iDAA6B,CAAA;AAC/B,CAAC,EAFI,gBAAgB,KAAhB,gBAAgB,QAEpB;AAED;;;;;;GAMG;AACH,MAAa,cAAc;IAgBzB;QAfA,oDAAoD;QAC5C,sBAAiB,GAAsB,EAAE,CAAC;QAElD,2GAA2G;QACnG,yBAAoB,GAAqC,IAAI,GAAG,EAA+B,CAAC;QAExG;;YAEI;QACJ,sIAAsI;QAE/H,cAAS,GAAG,KAAK,IAAI,EAAE;YAC5B,MAAM,IAAI,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QACpE,CAAC,CAAC;QAGA,qBAAS,CAAC,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACI,uBAAuB,CAAC,eAAgC;QAC7D,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAClD,CAAC;IAED;;;QAGI;IACG,kBAAkB,CAAC,eAAgC;QACxD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,iBAAiB,CAAC,eAA6B,EAAE,QAAsB;QAClF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QACzD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,gGAAgG;IACxF,KAAK,CAAC,uBAAuB,CAAC,KAAa;QACjD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,EAAE;YAC1D,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,gBAAgB;gBACtC,SAAS;YACX,KAAK,MAAM,eAAe,IAAI,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE;gBACjE,IAAI,eAAe,KAAK,KAAK,EAAE;oBAC7B,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,8DAA8D;iBACxF;aACF;SACF;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,MAAoB;QAC5C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,GAAY;QACtC,IAAI;YACF,IAAI,QAAQ,KAAK,OAAO,CAAC,GAAG,CAAC;gBAC3B,OAAO,GAAwB,CAAC;YAClC,IAAI,QAAQ,KAAK,OAAO,CAAC,GAAG,CAAC;gBAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;SAC/C;QAAC,OAAO,GAAQ,EAAE,GAAG;QACtB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,wHAAwH;IACxH,qHAAqH;IACrH,8BAA8B;IAC9B,uBAAuB;IACvB,EAAE;IACF,4HAA4H;IAC5H,6BAA6B;IACrB,KAAK,CAAC,OAAO,CAAC,SAA8B;QAClD,IAAI,SAAS,CAAC,QAAQ;YACpB,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;CAEF;AAzFD,wCAyFC","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 Extensions\r\n */\r\n\r\n// import { Extension, ExtensionLoader, ExtensionManifest, LocalExtensionProps, PendingExtension } from \"./Extension\";\r\nimport { IModelApp } from \"../IModelApp\";\r\nimport { ExtensionManifest, LocalExtensionProps } from \"./Extension\";\r\nimport { ExtensionLoader } from \"./ExtensionLoader\";\r\n\r\n/** The Extensions loading system has 3 goals:\r\n *   1. Only fetch what is needed when it is required\r\n *      1. Load a manifest file\r\n *      2. Load the the main module when necessary\r\n *   2. Download the needed files from\r\n *\r\n * 3 ways to load an Extension into the system:\r\n *\r\n *  1. At build-time provide the function to load both the Extension Manifest and import the main module of the extension.\r\n *     The main module must contain the activate() function.\r\n *  2. A minimum set of ExtensionLoaderProps that provide enough information to get the manifest\r\n *\r\n * An Extension can be in 3 different states:\r\n *   - Known\r\n *      - The Extension Admin has the minimal information needed to fetch the manifest for the Extension.\r\n *        knows the Extension exists but has not yet loaded the manifest\r\n *   - Installed\r\n *      - The Extension has the full manifest loaded and can be executed on the activation events\r\n *   - Disabled\r\n *      - The Extension has the full manifest but is not currently enabled and will not be executed based on the\r\n *        activation events.\r\n */\r\n\r\ntype ResolveFunc = (() => Promise<any>);\r\n// type RejectFunc = ((arg: Error) => void);\r\n\r\nenum ActivationEvents {\r\n  onStartupApp = \"onStartupApp\",\r\n}\r\n\r\n/** The Extension Admin controls the list of currently known, loaded and executing an Extension.\r\n * Handles the loading of Extensions and maintains a list of the currently loaded Extensions.\r\n *\r\n * On application startup, an initial list of Extensions is gathered by searching in known locations for\r\n *\r\n * @alpha\r\n */\r\nexport class ExtensionAdmin {\r\n  /** The list of places to download an Extension.  */\r\n  private _extensionLoaders: ExtensionLoader[] = [];\r\n\r\n  /** Defines the set of extensions that are currently known and can be invoked during activation events.  */\r\n  private _installedExtensions: Map<string, LocalExtensionProps> = new Map<string, LocalExtensionProps>();\r\n\r\n  /**\r\n    * Fired when an Extension has been added or removed.\r\n    */\r\n  // public readonly onInstallExtension = new BeEvent<(added: readonly ExtensionProps[], removed: readonly ExtensionProps[]) => void>();\r\n\r\n  public onStartup = async () => {\r\n    await this.activateExtensionEvents(ActivationEvents.onStartupApp);\r\n  };\r\n\r\n  public constructor() {\r\n    IModelApp.onBeforeStartup.addListener(this.onStartup);\r\n  }\r\n\r\n  /** Adds an ExtensionLoader to the front of the list of extension loaders in use. Extension loaders will be invoked front to back.\r\n   * By default, the list consists of public Extension Service context, unless disabled via props.\r\n   * @param extensionLoader Extension loader to add\r\n   */\r\n  public addExtensionLoaderFront(extensionLoader: ExtensionLoader) {\r\n    this._extensionLoaders.unshift(extensionLoader);\r\n  }\r\n\r\n  /** Adds an ExtensionLoader to the list of extension loaders in use.\r\n    * By default, the list consists of public Extension Service context, unless disabled via props.\r\n    * @param extensionLoader Extension loader to add\r\n    */\r\n  public addExtensionLoader(extensionLoader: ExtensionLoader) {\r\n    this._extensionLoaders.push(extensionLoader);\r\n  }\r\n\r\n  /** Add an Extension to be bundled during compilation.\r\n   * @param manifestLoader A function that loads the manifest file.\r\n   * @param mainFunc The main function to be executed upon\r\n   */\r\n  public async addBuildExtension(manifestPromise: Promise<any>, mainFunc?: ResolveFunc): Promise<void> {\r\n    const manifest = await this.getManifest(manifestPromise);\r\n    this._installedExtensions.set(manifest.name, { manifest, mainFunc });\r\n  }\r\n\r\n  /** Loops over all enabled Extensions and triggers each one if the provided event is defined. */\r\n  private async activateExtensionEvents(event: string) {\r\n    for (const extension of this._installedExtensions.values()) {\r\n      if (!extension.manifest.activationEvents)\r\n        continue;\r\n      for (const activationEvent of extension.manifest.activationEvents) {\r\n        if (activationEvent === event) {\r\n          this.execute(extension); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n        }\r\n      }\r\n    }\r\n  }\r\n\r\n  /** Resolves an import function provided for build-time Extensions that should return a valid\r\n   * Extension Manifest.\r\n   */\r\n  private async getManifest(loader: Promise<any>): Promise<ExtensionManifest> {\r\n    const raw = await loader;\r\n    const manifest = this.parseManifest(raw);\r\n    return manifest;\r\n  }\r\n\r\n  private async parseManifest(raw: unknown): Promise<ExtensionManifest> {\r\n    try {\r\n      if (\"object\" === typeof (raw))\r\n        return raw as ExtensionManifest;\r\n      if (\"string\" === typeof (raw))\r\n        return JSON.parse(raw) as ExtensionManifest;\r\n    } catch (err: any) { }\r\n    throw new Error(\"Extension is invalid: package.json is not JSON.\");\r\n  }\r\n\r\n  // Important: The Function constructor is used here to isolate the context in which the Extension javascript has access.\r\n  // By using the Function constructor to create and then execute the extension it will only have access to two scopes:\r\n  //  1. It's own function scope\r\n  //  2. The global scope\r\n  //\r\n  // The global scope is important for an Extension as that is where the reference to the Extension Implementation is supplied\r\n  // from the application side.\r\n  private async execute(extension: LocalExtensionProps): Promise<void> {\r\n    if (extension.mainFunc)\r\n      return extension.mainFunc();\r\n  }\r\n\r\n}\r\n"]}

package/lib/cjs/extension/ExtensionHost.d.ts

@@ -0,0 +1,20 @@
+import type { ToolAdmin } from "../tools/ToolAdmin";
+import type { AccuSnap } from "../AccuSnap";
+import type { NotificationManager } from "../NotificationManager";
+import type { ViewManager } from "../ViewManager";
+import type { ElementLocateManager } from "../ElementLocateManager";
+import type { Localization } from "@itwin/core-common";
+/**
+ * Subset of IModelApp exposed to Extensions
+ * @beta
+ */
+export declare class ExtensionHost {
+    protected constructor();
+    static get toolAdmin(): ToolAdmin;
+    static get notifications(): NotificationManager;
+    static get viewManager(): ViewManager;
+    static get locateManager(): ElementLocateManager;
+    static get accuSnap(): AccuSnap;
+    static get localization(): Localization;
+}
+//# sourceMappingURL=ExtensionHost.d.ts.map

package/lib/cjs/extension/ExtensionHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionHost.d.ts","sourceRoot":"","sources":["../../../src/extension/ExtensionHost.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;GAGG;AACH,qBAAa,aAAa;IACxB,SAAS;IAET,WAAkB,SAAS,IAAI,SAAS,CAAgC;IACxE,WAAkB,aAAa,IAAI,mBAAmB,CAAoC;IAC1F,WAAkB,WAAW,IAAI,WAAW,CAAkC;IAC9E,WAAkB,aAAa,IAAI,oBAAoB,CAAoC;IAC3F,WAAkB,QAAQ,IAAI,QAAQ,CAA+B;IACrE,WAAkB,YAAY,IAAI,YAAY,CAAmC;CAClF"}

package/lib/cjs/extension/ExtensionHost.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtensionHost = void 0;
+const IModelApp_1 = require("../IModelApp");
+/**
+ * Subset of IModelApp exposed to Extensions
+ * @beta
+ */
+class ExtensionHost {
+    constructor() { }
+    static get toolAdmin() { return IModelApp_1.IModelApp.toolAdmin; }
+    static get notifications() { return IModelApp_1.IModelApp.notifications; }
+    static get viewManager() { return IModelApp_1.IModelApp.viewManager; }
+    static get locateManager() { return IModelApp_1.IModelApp.locateManager; } // internal ?
+    static get accuSnap() { return IModelApp_1.IModelApp.accuSnap; }
+    static get localization() { return IModelApp_1.IModelApp.localization; } // re think this, should be contribution point
+}
+exports.ExtensionHost = ExtensionHost;
+//# sourceMappingURL=ExtensionHost.js.map

package/lib/cjs/extension/ExtensionHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionHost.js","sourceRoot":"","sources":["../../../src/extension/ExtensionHost.ts"],"names":[],"mappings":";;;AAAA,4CAAyC;AAQzC;;;GAGG;AACH,MAAa,aAAa;IACxB,gBAA0B,CAAC;IAEpB,MAAM,KAAK,SAAS,KAAgB,OAAO,qBAAS,CAAC,SAAS,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,aAAa,KAA0B,OAAO,qBAAS,CAAC,aAAa,CAAC,CAAC,CAAC;IACnF,MAAM,KAAK,WAAW,KAAkB,OAAO,qBAAS,CAAC,WAAW,CAAC,CAAC,CAAC;IACvE,MAAM,KAAK,aAAa,KAA2B,OAAO,qBAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa;IAClG,MAAM,KAAK,QAAQ,KAAe,OAAO,qBAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,YAAY,KAAmB,OAAO,qBAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,8CAA8C;CACjI;AATD,sCASC","sourcesContent":["import { IModelApp } from \"../IModelApp\";\r\nimport type { ToolAdmin } from \"../tools/ToolAdmin\";\r\nimport type { AccuSnap } from \"../AccuSnap\";\r\nimport type { NotificationManager } from \"../NotificationManager\";\r\nimport type { ViewManager } from \"../ViewManager\";\r\nimport type { ElementLocateManager } from \"../ElementLocateManager\";\r\nimport type { Localization } from \"@itwin/core-common\";\r\n\r\n/**\r\n * Subset of IModelApp exposed to Extensions\r\n * @beta\r\n */\r\nexport class ExtensionHost {\r\n  protected constructor() { }\r\n\r\n  public static get toolAdmin(): ToolAdmin { return IModelApp.toolAdmin; }\r\n  public static get notifications(): NotificationManager { return IModelApp.notifications; }\r\n  public static get viewManager(): ViewManager { return IModelApp.viewManager; }\r\n  public static get locateManager(): ElementLocateManager { return IModelApp.locateManager; } // internal ?\r\n  public static get accuSnap(): AccuSnap { return IModelApp.accuSnap; }\r\n  public static get localization(): Localization { return IModelApp.localization; } // re think this, should be contribution point\r\n}\r\n"]}

package/lib/cjs/extension/ExtensionImpl.d.ts

@@ -0,0 +1,16 @@
+import { ToolType } from "../tools/Tool";
+import { CommonToolbarItem, ToolbarOrientation, ToolbarUsage, UiItemsProvider } from "@itwin/appui-abstract";
+export declare class ToolProvider implements UiItemsProvider {
+    readonly id: string;
+    private _toolId;
+    private _toolIcon;
+    private _toolLabel;
+    constructor(tool: ToolType);
+    provideToolbarButtonItems(_stageId: string, stageUsage: string, toolbarUsage: ToolbarUsage, toolbarOrientation: ToolbarOrientation): CommonToolbarItem[];
+}
+export declare class ExtensionImpl {
+    private _id;
+    constructor(_id: string);
+    registerTool(tool: ToolType, onRegistered?: () => any): Promise<void>;
+}
+//# sourceMappingURL=ExtensionImpl.d.ts.map

package/lib/cjs/extension/ExtensionImpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionImpl.d.ts","sourceRoot":"","sources":["../../../src/extension/ExtensionImpl.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAoC,kBAAkB,EAAE,YAAY,EAAkB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/J,qBAAa,YAAa,YAAW,eAAe;IAClD,SAAgB,EAAE,SAAC;IACnB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,SAAS,CAAC;IAClB,OAAO,CAAC,UAAU,CAAC;gBAEA,IAAI,EAAE,QAAQ;IAO1B,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,GAAG,iBAAiB,EAAE;CAIhK;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,MAAM;IAElB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CASnF"}

package/lib/cjs/extension/ExtensionImpl.js

@@ -0,0 +1,40 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtensionImpl = exports.ToolProvider = void 0;
+const IModelApp_1 = require("../IModelApp");
+const appui_abstract_1 = require("@itwin/appui-abstract");
+class ToolProvider {
+    constructor(tool) {
+        this._toolId = "";
+        this.id = `ToolProvider:${tool.toolId}`;
+        this._toolId = tool.toolId;
+        this._toolIcon = tool.iconSpec;
+        this._toolLabel = tool.description;
+    }
+    provideToolbarButtonItems(_stageId, stageUsage, toolbarUsage, toolbarOrientation) {
+        const toolbarItem = appui_abstract_1.ToolbarItemUtilities.createActionButton(this._toolId, 0, this._toolIcon, this._toolLabel, async () => { await IModelApp_1.IModelApp.tools.run(this._toolId); });
+        return stageUsage === appui_abstract_1.StageUsage.General && toolbarUsage === appui_abstract_1.ToolbarUsage.ContentManipulation && toolbarOrientation === appui_abstract_1.ToolbarOrientation.Horizontal ? [toolbarItem] : [];
+    }
+}
+exports.ToolProvider = ToolProvider;
+class ExtensionImpl {
+    constructor(_id) {
+        this._id = _id;
+    }
+    async registerTool(tool, onRegistered) {
+        try {
+            IModelApp_1.IModelApp.tools.register(tool);
+            appui_abstract_1.UiItemsManager.register(new ToolProvider(tool));
+            onRegistered === null || onRegistered === void 0 ? void 0 : onRegistered();
+        }
+        catch (e) {
+            console.log(`Error registering tool: ${e}`); // eslint-disable-line
+        }
+    }
+}
+exports.ExtensionImpl = ExtensionImpl;
+//# sourceMappingURL=ExtensionImpl.js.map

package/lib/cjs/extension/ExtensionImpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionImpl.js","sourceRoot":"","sources":["../../../src/extension/ExtensionImpl.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAG/F,4CAAyC;AACzC,0DAA+J;AAE/J,MAAa,YAAY;IAMvB,YAAmB,IAAc;QAJzB,YAAO,GAAG,EAAE,CAAC;QAKnB,IAAI,CAAC,EAAE,GAAG,gBAAgB,IAAI,CAAC,MAAM,EAAE,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;IACrC,CAAC;IAEM,yBAAyB,CAAC,QAAgB,EAAE,UAAkB,EAAE,YAA0B,EAAE,kBAAsC;QACvI,MAAM,WAAW,GAAG,qCAAoB,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,qBAAS,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxK,OAAO,UAAU,KAAK,2BAAU,CAAC,OAAO,IAAI,YAAY,KAAK,6BAAY,CAAC,mBAAmB,IAAI,kBAAkB,KAAK,mCAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7K,CAAC;CACF;AAjBD,oCAiBC;AAED,MAAa,aAAa;IACxB,YAAoB,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAI,CAAC;IAE7B,KAAK,CAAC,YAAY,CAAC,IAAc,EAAE,YAAwB;QAChE,IAAI;YACF,qBAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/B,+BAAc,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;YAChD,YAAY,aAAZ,YAAY,uBAAZ,YAAY,EAAI,CAAC;SAClB;QAAC,OAAO,CAAM,EAAE;YACf,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC,CAAC,sBAAsB;SACpE;IACH,CAAC;CACF;AAZD,sCAYC","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\r\nimport { ToolType } from \"../tools/Tool\";\r\nimport { IModelApp } from \"../IModelApp\";\r\nimport { CommonToolbarItem, StageUsage, ToolbarItemUtilities, ToolbarOrientation, ToolbarUsage, UiItemsManager, UiItemsProvider } from \"@itwin/appui-abstract\";\r\n\r\nexport class ToolProvider implements UiItemsProvider {\r\n  public readonly id;\r\n  private _toolId = \"\";\r\n  private _toolIcon;\r\n  private _toolLabel;\r\n\r\n  public constructor(tool: ToolType) {\r\n    this.id = `ToolProvider:${tool.toolId}`;\r\n    this._toolId = tool.toolId;\r\n    this._toolIcon = tool.iconSpec;\r\n    this._toolLabel = tool.description;\r\n  }\r\n\r\n  public provideToolbarButtonItems(_stageId: string, stageUsage: string, toolbarUsage: ToolbarUsage, toolbarOrientation: ToolbarOrientation): CommonToolbarItem[] {\r\n    const toolbarItem = ToolbarItemUtilities.createActionButton(this._toolId, 0, this._toolIcon, this._toolLabel, async () => { await IModelApp.tools.run(this._toolId); });\r\n    return stageUsage === StageUsage.General && toolbarUsage === ToolbarUsage.ContentManipulation && toolbarOrientation === ToolbarOrientation.Horizontal ? [toolbarItem] : [];\r\n  }\r\n}\r\n\r\nexport class ExtensionImpl {\r\n  constructor(private _id: string) { }\r\n\r\n  public async registerTool(tool: ToolType, onRegistered?: () => any): Promise<void> {\r\n    try {\r\n      IModelApp.tools.register(tool);\r\n      UiItemsManager.register(new ToolProvider(tool));\r\n      onRegistered?.();\r\n    } catch (e: any) {\r\n      console.log(`Error registering tool: ${e}`); // eslint-disable-line\r\n    }\r\n  }\r\n}\r\n"]}

package/lib/cjs/extension/ExtensionLoader.d.ts

@@ -0,0 +1,20 @@
+import { ExtensionManifest, LocalExtensionProps } from "./Extension";
+/** THe minimum information required to download an Extension */
+export interface ExtensionLoaderProps {
+    name: string;
+    version: string;
+}
+export interface BuiltInExtensionLoaderProps {
+    manifest: Promise<any>;
+    loader: (() => Promise<any>);
+}
+/** Describes what is needed in order to write an Extension Loader.
+ * @alpha
+ */
+export interface ExtensionLoader {
+    /** Retrieves an Extension manifest for the provided Extension identifier */
+    getManifest(arg: ExtensionLoaderProps): Promise<ExtensionManifest>;
+    /** Downloads an Extension provided the name of the Extension */
+    downloadExtension(arg: ExtensionLoaderProps): Promise<LocalExtensionProps>;
+}
+//# sourceMappingURL=ExtensionLoader.d.ts.map

package/lib/cjs/extension/ExtensionLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionLoader.d.ts","sourceRoot":"","sources":["../../../src/extension/ExtensionLoader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAErE,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,WAAW,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnE,gEAAgE;IAChE,iBAAiB,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC5E"}

package/lib/cjs/extension/ExtensionLoader.js

@@ -0,0 +1,11 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+// export class BuiltInExtensionLoader {
+//   public async getManifest(name: string): Promise<ExtensionManifest> {
+//   }
+// }
+//# sourceMappingURL=ExtensionLoader.js.map

package/lib/cjs/extension/ExtensionLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionLoader.js","sourceRoot":"","sources":["../../../src/extension/ExtensionLoader.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;AAyB/F,wCAAwC;AACxC,yEAAyE;AAEzE,MAAM;AACN,IAAI","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\r\nimport { ExtensionManifest, LocalExtensionProps } from \"./Extension\";\r\n\r\n/** THe minimum information required to download an Extension */\r\nexport interface ExtensionLoaderProps {\r\n  name: string;\r\n  version: string;\r\n}\r\n\r\nexport interface BuiltInExtensionLoaderProps {\r\n  manifest: Promise<any>;\r\n  loader: (() => Promise<any>);\r\n}\r\n\r\n/** Describes what is needed in order to write an Extension Loader.\r\n * @alpha\r\n */\r\nexport interface ExtensionLoader {\r\n  /** Retrieves an Extension manifest for the provided Extension identifier */\r\n  getManifest(arg: ExtensionLoaderProps): Promise<ExtensionManifest>;\r\n  /** Downloads an Extension provided the name of the Extension */\r\n  downloadExtension(arg: ExtensionLoaderProps): Promise<LocalExtensionProps>;\r\n}\r\n\r\n// export class BuiltInExtensionLoader {\r\n//   public async getManifest(name: string): Promise<ExtensionManifest> {\r\n\r\n//   }\r\n// }\r\n"]}

package/lib/cjs/extension/ExtensionRuntime.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ExtensionRuntime.d.ts.map

package/lib/cjs/extension/ExtensionRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionRuntime.d.ts","sourceRoot":"","sources":["../../../src/extension/ExtensionRuntime.ts"],"names":[],"mappings":""}

package/lib/cjs/extension/ExtensionRuntime.js

@@ -0,0 +1,60 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable @typescript-eslint/naming-convention */
+const AccuDraw_1 = require("../AccuDraw");
+const AuxCoordSys_1 = require("../AuxCoordSys");
+const CoordSystem_1 = require("../CoordSystem");
+const ElementLocateManager_1 = require("../ElementLocateManager");
+const FlashSettings_1 = require("../FlashSettings");
+const FrontendLoggerCategory_1 = require("../FrontendLoggerCategory");
+const HitDetail_1 = require("../HitDetail");
+const NotificationManager_1 = require("../NotificationManager");
+const SelectionSet_1 = require("../SelectionSet");
+const StandardView_1 = require("../StandardView");
+const ViewRect_1 = require("../ViewRect");
+const ViewStatus_1 = require("../ViewStatus");
+const Viewport_1 = require("../Viewport");
+const GraphicBuilder_1 = require("../render/GraphicBuilder");
+const Pixel_1 = require("../render/Pixel");
+const RenderTexture_1 = require("../render/RenderTexture");
+const ScreenSpaceEffectBuilder_1 = require("../render/ScreenSpaceEffectBuilder");
+const internal_1 = require("../tile/internal");
+const ClipViewTool_1 = require("../tools/ClipViewTool");
+const PrimitiveTool_1 = require("../tools/PrimitiveTool");
+const SelectTool_1 = require("../tools/SelectTool");
+const Tool_1 = require("../tools/Tool");
+const ToolAdmin_1 = require("../tools/ToolAdmin");
+const ToolAssistance_1 = require("../tools/ToolAssistance");
+const ViewTool_1 = require("../tools/ViewTool");
+const core_common_1 = require("@itwin/core-common");
+const ExtensionImpl_1 = require("./ExtensionImpl");
+const ExtensionHost_1 = require("./ExtensionHost");
+const globalSymbol = Symbol.for("itwin.core.frontend.globals");
+if (globalThis[globalSymbol])
+    throw new Error("Multiple @itwin/core-frontend imports detected!");
+const getExtensionApi = (id) => {
+    return {
+        exports: {
+            InteractiveTool: Tool_1.InteractiveTool, PrimitiveTool: PrimitiveTool_1.PrimitiveTool, ViewTool: ViewTool_1.ViewTool, Tool: Tool_1.Tool,
+            ToolAssistance: ToolAssistance_1.ToolAssistance, BeButtonEvent: Tool_1.BeButtonEvent, ViewRect: ViewRect_1.ViewRect, Pixel: Pixel_1.Pixel, LocateResponse: ElementLocateManager_1.LocateResponse,
+            ColorDef: core_common_1.ColorDef,
+            ExtensionHost: ExtensionHost_1.ExtensionHost,
+            ACSDisplayOptions: AuxCoordSys_1.ACSDisplayOptions, ACSType: AuxCoordSys_1.ACSType, ActivityMessageEndReason: NotificationManager_1.ActivityMessageEndReason, BeButton: Tool_1.BeButton, BeModifierKeys: Tool_1.BeModifierKeys, ClipEventType: ClipViewTool_1.ClipEventType, ContextRotationId: AccuDraw_1.ContextRotationId, CoordinateLockOverrides: Tool_1.CoordinateLockOverrides,
+            CoordSource: Tool_1.CoordSource, CoordSystem: CoordSystem_1.CoordSystem, DepthPointSource: Viewport_1.DepthPointSource, EventHandled: Tool_1.EventHandled, FlashMode: FlashSettings_1.FlashMode, FrontendLoggerCategory: FrontendLoggerCategory_1.FrontendLoggerCategory, GraphicType: GraphicBuilder_1.GraphicType, HitDetailType: HitDetail_1.HitDetailType, HitGeomType: HitDetail_1.HitGeomType,
+            HitParentGeomType: HitDetail_1.HitParentGeomType, HitPriority: HitDetail_1.HitPriority, HitSource: HitDetail_1.HitSource, InputSource: Tool_1.InputSource, KeyinParseError: Tool_1.KeyinParseError, LocateAction: ElementLocateManager_1.LocateAction, LocateFilterStatus: ElementLocateManager_1.LocateFilterStatus, ManipulatorToolEvent: ToolAdmin_1.ManipulatorToolEvent,
+            MessageBoxIconType: NotificationManager_1.MessageBoxIconType, MessageBoxType: NotificationManager_1.MessageBoxType, MessageBoxValue: NotificationManager_1.MessageBoxValue, OutputMessageAlert: NotificationManager_1.OutputMessageAlert, OutputMessagePriority: NotificationManager_1.OutputMessagePriority, OutputMessageType: NotificationManager_1.OutputMessageType, ParseAndRunResult: Tool_1.ParseAndRunResult,
+            SelectionMethod: SelectTool_1.SelectionMethod, SelectionMode: SelectTool_1.SelectionMode, SelectionProcessing: SelectTool_1.SelectionProcessing, SelectionSetEventType: SelectionSet_1.SelectionSetEventType, SnapHeat: HitDetail_1.SnapHeat, SnapMode: HitDetail_1.SnapMode, SnapStatus: ElementLocateManager_1.SnapStatus, StandardViewId: StandardView_1.StandardViewId, StartOrResume: ToolAdmin_1.StartOrResume,
+            TextureTransparency: RenderTexture_1.TextureTransparency, TileBoundingBoxes: internal_1.TileBoundingBoxes, TileGraphicType: internal_1.TileGraphicType, TileLoadPriority: internal_1.TileLoadPriority, TileLoadStatus: internal_1.TileLoadStatus, TileTreeLoadStatus: internal_1.TileTreeLoadStatus, TileVisibility: internal_1.TileVisibility,
+            ToolAssistanceImage: ToolAssistance_1.ToolAssistanceImage, ToolAssistanceInputMethod: ToolAssistance_1.ToolAssistanceInputMethod, UniformType: ScreenSpaceEffectBuilder_1.UniformType, VaryingType: ScreenSpaceEffectBuilder_1.VaryingType, ViewStatus: ViewStatus_1.ViewStatus, ViewUndoEvent: Viewport_1.ViewUndoEvent,
+        },
+        api: new ExtensionImpl_1.ExtensionImpl(id),
+    };
+};
+globalThis[globalSymbol] = {
+    getExtensionApi,
+};
+//# sourceMappingURL=ExtensionRuntime.js.map

package/lib/cjs/extension/ExtensionRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionRuntime.js","sourceRoot":"","sources":["../../../src/extension/ExtensionRuntime.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;AAE/F,yDAAyD;AAEzD,0CAAgD;AAChD,gDAA4D;AAC5D,gDAA6C;AAC7C,kEAAuG;AACvG,oDAA6C;AAC7C,sEAAmE;AACnE,4CAAyH;AACzH,gEAAqL;AACrL,kDAAwD;AACxD,kDAAiD;AACjD,0CAAuC;AACvC,8CAA2C;AAC3C,0CAA8D;AAC9D,6DAAuD;AACvD,2CAAwC;AACxC,2DAA8D;AAC9D,iFAA8E;AAC9E,+CAA4I;AAC5I,wDAAsD;AACtD,0DAAuD;AACvD,oDAA0F;AAC1F,wCAAoM;AACpM,kDAAyE;AACzE,4DAAyG;AACzG,gDAA6C;AAE7C,oDAA8C;AAC9C,mDAAgD;AAChD,mDAAgD;AAEhD,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAC/D,IAAK,UAAkB,CAAC,YAAY,CAAC;IACnC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;AAErE,MAAM,eAAe,GAAG,CAAC,EAAU,EAAE,EAAE;IACrC,OAAO;QACL,OAAO,EAAE;YACP,eAAe,EAAf,sBAAe,EAAE,aAAa,EAAb,6BAAa,EAAE,QAAQ,EAAR,mBAAQ,EAAE,IAAI,EAAJ,WAAI;YAE9C,cAAc,EAAd,+BAAc,EAAE,aAAa,EAAb,oBAAa,EAAE,QAAQ,EAAR,mBAAQ,EAAE,KAAK,EAAL,aAAK,EAAE,cAAc,EAAd,qCAAc;YAE9D,QAAQ,EAAR,sBAAQ;YAER,aAAa,EAAb,6BAAa;YAEb,iBAAiB,EAAjB,+BAAiB,EAAE,OAAO,EAAP,qBAAO,EAAE,wBAAwB,EAAxB,8CAAwB,EAAE,QAAQ,EAAR,eAAQ,EAAE,cAAc,EAAd,qBAAc,EAAE,aAAa,EAAb,4BAAa,EAAE,iBAAiB,EAAjB,4BAAiB,EAAE,uBAAuB,EAAvB,8BAAuB;YACzI,WAAW,EAAX,kBAAW,EAAE,WAAW,EAAX,yBAAW,EAAE,gBAAgB,EAAhB,2BAAgB,EAAE,YAAY,EAAZ,mBAAY,EAAE,SAAS,EAAT,yBAAS,EAAE,sBAAsB,EAAtB,+CAAsB,EAAE,WAAW,EAAX,4BAAW,EAAE,aAAa,EAAb,yBAAa,EAAE,WAAW,EAAX,uBAAW;YACpI,iBAAiB,EAAjB,6BAAiB,EAAE,WAAW,EAAX,uBAAW,EAAE,SAAS,EAAT,qBAAS,EAAE,WAAW,EAAX,kBAAW,EAAE,eAAe,EAAf,sBAAe,EAAE,YAAY,EAAZ,mCAAY,EAAE,kBAAkB,EAAlB,yCAAkB,EAAE,oBAAoB,EAApB,gCAAoB;YAC/H,kBAAkB,EAAlB,wCAAkB,EAAE,cAAc,EAAd,oCAAc,EAAE,eAAe,EAAf,qCAAe,EAAE,kBAAkB,EAAlB,wCAAkB,EAAE,qBAAqB,EAArB,2CAAqB,EAAE,iBAAiB,EAAjB,uCAAiB,EAAE,iBAAiB,EAAjB,wBAAiB;YACpI,eAAe,EAAf,4BAAe,EAAE,aAAa,EAAb,0BAAa,EAAE,mBAAmB,EAAnB,gCAAmB,EAAE,qBAAqB,EAArB,oCAAqB,EAAE,QAAQ,EAAR,oBAAQ,EAAE,QAAQ,EAAR,oBAAQ,EAAE,UAAU,EAAV,iCAAU,EAAE,cAAc,EAAd,6BAAc,EAAE,aAAa,EAAb,yBAAa;YACzI,mBAAmB,EAAnB,mCAAmB,EAAE,iBAAiB,EAAjB,4BAAiB,EAAE,eAAe,EAAf,0BAAe,EAAE,gBAAgB,EAAhB,2BAAgB,EAAE,cAAc,EAAd,yBAAc,EAAE,kBAAkB,EAAlB,6BAAkB,EAAE,cAAc,EAAd,yBAAc;YAC7H,mBAAmB,EAAnB,oCAAmB,EAAE,yBAAyB,EAAzB,0CAAyB,EAAE,WAAW,EAAX,sCAAW,EAAE,WAAW,EAAX,sCAAW,EAAE,UAAU,EAAV,uBAAU,EAAE,aAAa,EAAb,wBAAa;SACpG;QACD,GAAG,EAAE,IAAI,6BAAa,CAAC,EAAE,CAAC;KAC3B,CAAC;AACJ,CAAC,CAAC;AAED,UAAkB,CAAC,YAAY,CAAC,GAAG;IAClC,eAAe;CAChB,CAAC","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\r\n/* eslint-disable @typescript-eslint/naming-convention */\r\n\r\nimport { ContextRotationId } from \"../AccuDraw\";\r\nimport { ACSDisplayOptions, ACSType } from \"../AuxCoordSys\";\r\nimport { CoordSystem } from \"../CoordSystem\";\r\nimport { LocateAction, LocateFilterStatus, LocateResponse, SnapStatus } from \"../ElementLocateManager\";\r\nimport { FlashMode } from \"../FlashSettings\";\r\nimport { FrontendLoggerCategory } from \"../FrontendLoggerCategory\";\r\nimport { HitDetailType, HitGeomType, HitParentGeomType, HitPriority, HitSource, SnapHeat, SnapMode } from \"../HitDetail\";\r\nimport { ActivityMessageEndReason, MessageBoxIconType, MessageBoxType, MessageBoxValue, OutputMessageAlert, OutputMessagePriority, OutputMessageType } from \"../NotificationManager\";\r\nimport { SelectionSetEventType } from \"../SelectionSet\";\r\nimport { StandardViewId } from \"../StandardView\";\r\nimport { ViewRect } from \"../ViewRect\";\r\nimport { ViewStatus } from \"../ViewStatus\";\r\nimport { DepthPointSource, ViewUndoEvent } from \"../Viewport\";\r\nimport { GraphicType } from \"../render/GraphicBuilder\";\r\nimport { Pixel } from \"../render/Pixel\";\r\nimport { TextureTransparency } from \"../render/RenderTexture\";\r\nimport { UniformType, VaryingType } from \"../render/ScreenSpaceEffectBuilder\";\r\nimport { TileBoundingBoxes, TileGraphicType, TileLoadPriority, TileLoadStatus, TileTreeLoadStatus, TileVisibility } from \"../tile/internal\";\r\nimport { ClipEventType } from \"../tools/ClipViewTool\";\r\nimport { PrimitiveTool } from \"../tools/PrimitiveTool\";\r\nimport { SelectionMethod, SelectionMode, SelectionProcessing } from \"../tools/SelectTool\";\r\nimport { BeButton, BeButtonEvent, BeModifierKeys, CoordinateLockOverrides, CoordSource, EventHandled, InputSource, InteractiveTool, KeyinParseError, ParseAndRunResult, Tool } from \"../tools/Tool\";\r\nimport { ManipulatorToolEvent, StartOrResume } from \"../tools/ToolAdmin\";\r\nimport { ToolAssistance, ToolAssistanceImage, ToolAssistanceInputMethod } from \"../tools/ToolAssistance\";\r\nimport { ViewTool } from \"../tools/ViewTool\";\r\n\r\nimport { ColorDef } from \"@itwin/core-common\";\r\nimport { ExtensionImpl } from \"./ExtensionImpl\";\r\nimport { ExtensionHost } from \"./ExtensionHost\";\r\n\r\nconst globalSymbol = Symbol.for(\"itwin.core.frontend.globals\");\r\nif ((globalThis as any)[globalSymbol])\r\n  throw new Error(\"Multiple @itwin/core-frontend imports detected!\");\r\n\r\nconst getExtensionApi = (id: string) => {\r\n  return {\r\n    exports: {\r\n      InteractiveTool, PrimitiveTool, ViewTool, Tool,\r\n\r\n      ToolAssistance, BeButtonEvent, ViewRect, Pixel, LocateResponse,\r\n\r\n      ColorDef,\r\n\r\n      ExtensionHost,\r\n\r\n      ACSDisplayOptions, ACSType, ActivityMessageEndReason, BeButton, BeModifierKeys, ClipEventType, ContextRotationId, CoordinateLockOverrides,\r\n      CoordSource, CoordSystem, DepthPointSource, EventHandled, FlashMode, FrontendLoggerCategory, GraphicType, HitDetailType, HitGeomType,\r\n      HitParentGeomType, HitPriority, HitSource, InputSource, KeyinParseError, LocateAction, LocateFilterStatus, ManipulatorToolEvent,\r\n      MessageBoxIconType, MessageBoxType, MessageBoxValue, OutputMessageAlert, OutputMessagePriority, OutputMessageType, ParseAndRunResult,\r\n      SelectionMethod, SelectionMode, SelectionProcessing, SelectionSetEventType, SnapHeat, SnapMode, SnapStatus, StandardViewId, StartOrResume,\r\n      TextureTransparency, TileBoundingBoxes, TileGraphicType, TileLoadPriority, TileLoadStatus, TileTreeLoadStatus, TileVisibility,\r\n      ToolAssistanceImage, ToolAssistanceInputMethod, UniformType, VaryingType, ViewStatus, ViewUndoEvent,\r\n    },\r\n    api: new ExtensionImpl(id),\r\n  };\r\n};\r\n\r\n(globalThis as any)[globalSymbol] = {\r\n  getExtensionApi,\r\n};\r\n"]}

package/lib/cjs/extension/extensions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The Extension framework is made up of multiple pieces:
+ *
+ * - Extension Impl
+ * - Extension API
+ *    - The Extension API defines all of the types and API that can be used by an Extension.
+ * - Extension Admin loading
+ *    - Handles the
+ * - Extension Hooks
+ *    - Defines the
+ */
+export * from "./Extension";
+export * from "./ExtensionAdmin";
+export * from "./ExtensionImpl";
+export * from "./ExtensionLoader";
+export * from "./ExtensionHost";
+import "./ExtensionRuntime";
+//# sourceMappingURL=extensions.d.ts.map

package/lib/cjs/extension/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/extension/extensions.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,OAAO,oBAAoB,CAAC"}

package/lib/cjs/extension/extensions.js

@@ -0,0 +1,35 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Barrel file for all extension related files.
+/**
+ * The Extension framework is made up of multiple pieces:
+ *
+ * - Extension Impl
+ * - Extension API
+ *    - The Extension API defines all of the types and API that can be used by an Extension.
+ * - Extension Admin loading
+ *    - Handles the
+ * - Extension Hooks
+ *    - Defines the
+ */
+__exportStar(require("./Extension"), exports);
+__exportStar(require("./ExtensionAdmin"), exports);
+__exportStar(require("./ExtensionImpl"), exports);
+__exportStar(require("./ExtensionLoader"), exports);
+__exportStar(require("./ExtensionHost"), exports);
+require("./ExtensionRuntime");
+//# sourceMappingURL=extensions.js.map

package/lib/cjs/extension/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../../src/extension/extensions.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;AAE/F,+CAA+C;AAE/C;;;;;;;;;;GAUG;AAEH,8CAA4B;AAC5B,mDAAiC;AACjC,kDAAgC;AAChC,oDAAkC;AAClC,kDAAgC;AAChC,8BAA4B","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\r\n// Barrel file for all extension related files.\r\n\r\n/**\r\n * The Extension framework is made up of multiple pieces:\r\n *\r\n * - Extension Impl\r\n * - Extension API\r\n *    - The Extension API defines all of the types and API that can be used by an Extension.\r\n * - Extension Admin loading\r\n *    - Handles the\r\n * - Extension Hooks\r\n *    - Defines the\r\n */\r\n\r\nexport * from \"./Extension\";\r\nexport * from \"./ExtensionAdmin\";\r\nexport * from \"./ExtensionImpl\";\r\nexport * from \"./ExtensionLoader\";\r\nexport * from \"./ExtensionHost\";\r\nimport \"./ExtensionRuntime\";\r\n"]}

package/lib/esm/IModelApp.d.ts

@@ -9,6 +9,7 @@ import { AuthorizationClient, Localization, RpcInterfaceDefinition } from "@itwi
 import { WebGLRenderCompatibilityInfo } from "@itwin/webgl-compatibility";
 import { AccuDraw } from "./AccuDraw";
 import { AccuSnap } from "./AccuSnap";
+import { ExtensionAdmin } from "./extension/ExtensionAdmin";
 import { ElementLocateManager } from "./ElementLocateManager";
 import { EntityState } from "./EntityState";
 import { FrontendHubAccess } from "./FrontendHubAccess";
@@ -146,6 +147,10 @@ export declare class IModelApp {
     protected constructor();
     /** Event raised just before the frontend IModelApp is to be shut down */
     static readonly onBeforeShutdown: BeEvent<() => void>;
+    /** Event raised after IModelApp is finished starting up.
+     * @internal
+     */
+    static readonly onBeforeStartup: BeEvent<() => void>;
     /** Provides authorization information for various frontend APIs */
     static authorizationClient?: AuthorizationClient;
     /** The [[ToolRegistry]] for this session. */
@@ -176,7 +181,6 @@ export declare class IModelApp {
     static get accuDraw(): AccuDraw;
     /** The [[AccuSnap]] for this session. */
     static get accuSnap(): AccuSnap;
-    /** @internal */
     static get locateManager(): ElementLocateManager;
     /** @internal */
     static get tentativePoint(): TentativePoint;
@@ -208,6 +212,8 @@ export declare class IModelApp {
      * @internal
      */
     static readonly telemetry: TelemetryManager;
+    /** */
+    static readonly extensionAdmin: ExtensionAdmin;
     /** Map of classFullName to EntityState class */
     private static _entityClasses;
     /** Register all of the subclasses of EntityState from a module.