7 //      http://www.apache.org/licenses/LICENSE-2.0
26   Plugin,
50 // Every plugin gets its own PluginContext. This is how we keep track
51 // what each plugin is doing and how we can blame issues on particular
53 // The PluginContext exists for the whole duration a plugin is active.
86   // eslint-disable-next-line @typescript-eslint/no-explicit-any
99 // This PluginContextTrace implementation provides the plugin access to trace
101 // The PluginContextTrace exists for the whole duration a plugin is active AND a
143   // eslint-disable-next-line @typescript-eslint/no-explicit-any
379   plugin: Plugin;  property
385 function makePlugin(info: PluginDescriptor): Plugin {
386   const {plugin} = info;  constant
389   if (typeof plugin === 'function') {
390     const PluginClass = plugin;
393     return plugin;
414     // Shuffle the order of plugins to weed out any implicit inter-plugin
418       .sort((a, b) => a.sort - b.sort);
422       const name = `Plugin: ${pluginId}`;
426         description: `Overrides '${pluginId}' plugin.`,
437    * Enable plugin flag - i.e. configure a plugin to start on boot.
438    * @param id The ID of the plugin.
439    * @param now Optional: If true, also activate the plugin now.
450    * Disable plugin flag - i.e. configure a plugin not to start on boot.
451    * @param id The ID of the plugin.
452    * @param now Optional: If true, also deactivate the plugin now.
463    * Start a plugin just for this session. This setting is not persisted.
464    * @param id The ID of the plugin to start.
472     const plugin = makePlugin(pluginInfo);  constant
476     plugin.onActivate?.(context);
479       plugin,
483     // If a trace is already loaded when plugin is activated, make sure to
495    * Stop a plugin just for this session. This setting is not persisted.
496    * @param id The ID of the plugin to stop.
503     const {context, plugin} = pluginDetails;  constant
507     plugin.onDeactivate && plugin.onDeactivate(context);
521     for (const plugin of pluginRegistry.values()) {  constant
522       const pluginId = plugin.pluginId;
527           await this.activatePlugin(plugin.pluginId);
529           await this.deactivatePlugin(plugin.pluginId);
553     // Shuffle the order of plugins to weed out any implicit inter-plugin
556       .map(([id, plugin]) => ({id, plugin, sort: Math.random()}))
557       .sort((a, b) => a.sort - b.sort);
564     for (const {id, plugin} of pluginsShuffled) {  constant
566       await doPluginTraceLoad(plugin, engine);
579       const tracePlugin = ctx.plugin;
593   const {plugin, context} = pluginDetails;  constant
599   const result = await Promise.resolve(plugin.onTraceLoad?.(traceCtx));
600   const loadTime = performance.now() - startTime;
611   const {traceContext, plugin} = pluginDetails;  constant
614     plugin.onTraceUnload && (await plugin.onTraceUnload(traceContext));