commandkit 1.0.0-dev.20250620125211 → 1.0.0-dev.20250620150332

package/dist/CompilerPluginRuntime-OliJW0v-.js

@@ -1,171 +0,0 @@
-const require_chunk = require('./chunk-nOFOJqeH.js');
-const node_async_hooks = require_chunk.__toESM(require("node:async_hooks"));
-
-//#region src/plugins/plugin-runtime/CompilerPluginRuntime.ts
-/**
-* Enum representing the execution mode of a plugin.
-* It can be either 'activate' or 'deactivate'.
-* @private
-*/
-var PluginExecutionMode = /* @__PURE__ */ function(PluginExecutionMode$1) {
-	PluginExecutionMode$1["Activate"] = "activate";
-	PluginExecutionMode$1["Deactivate"] = "deactivate";
-	return PluginExecutionMode$1;
-}(PluginExecutionMode || {});
-/**
-* CompilerPluginRuntime is a runtime for managing compiler plugins in CommandKit.
-*/
-var CompilerPluginRuntime = class {
-	name = "CompilerPluginRuntime";
-	initialized = false;
-	templates = /* @__PURE__ */ new Map();
-	#pluginContext = new node_async_hooks.AsyncLocalStorage();
-	/**
-	* Creates a new instance of CompilerPluginRuntime.
-	* @param plugins An array of compiler plugins to be managed by this runtime.
-	*/
-	constructor(plugins) {
-		this.plugins = plugins;
-	}
-	/**
-	* Returns the plugins managed by this runtime.
-	*/
-	getPlugins() {
-		return this.plugins;
-	}
-	/**
-	* Checks if there are no plugins registered in this runtime.
-	*/
-	isEmpty() {
-		return !this.plugins.length;
-	}
-	/**
-	* Registers a template handler for a given name.
-	* This method must be called inside the activate() method of a plugin.
-	* @param name - The name of the template to register.
-	* @param handler - The handler function for the template.
-	*/
-	registerTemplate(name, handler) {
-		const ctx = this.#pluginContext.getStore();
-		if (!ctx || ctx.mode !== PluginExecutionMode.Activate) throw new Error("registerTemplate() must be called inside activate() method");
-		if (this.templates.has(name)) throw new Error(`Template "${name}" already exists`);
-		this.templates.set(name, {
-			handler,
-			plugin: ctx.plugin
-		});
-	}
-	/**
-	* Unregisters a template handler for a given name.
-	* This method must be called inside the deactivate() method of a plugin.
-	* @param name - The name of the template to unregister.
-	*/
-	unregisterTemplate(name) {
-		const ctx = this.#pluginContext.getStore();
-		if (!ctx || ctx.mode !== PluginExecutionMode.Deactivate) throw new Error("unregisterTemplate() must be called inside deactivate() method");
-		const template = this.templates.get(name);
-		if (!template) throw new Error(`Template "${name}" does not exist`);
-		if (template.plugin !== ctx.plugin) throw new Error(`Template "${name}" is owned by plugin "${template.plugin.name}" and cannot be unregistered by "${ctx.plugin.name}"`);
-		this.templates.delete(name);
-	}
-	/**
-	* Retrieves a template handler by its name.
-	* @param name - The name of the template to retrieve.
-	* @returns The template handler if found, otherwise undefined.
-	*/
-	getTemplate(name) {
-		var _this$templates$get;
-		return (_this$templates$get = this.templates.get(name)) === null || _this$templates$get === void 0 ? void 0 : _this$templates$get.handler;
-	}
-	/**
-	* Returns a map of all registered templates with their handlers.
-	* The keys are the template names and the values are the template handlers.
-	*/
-	getTemplates() {
-		return new Map(Array.from(this.templates.entries()).map(([name, entry]) => [name, entry.handler]));
-	}
-	/**
-	* Transforms the given code using all registered plugins.
-	* Each plugin's transform method is called in sequence, allowing them to modify the code.
-	* @param code - The code to be transformed.
-	* @param id - The identifier for the code being transformed (e.g., filename).
-	* @returns An object containing the transformed code and an optional source map.
-	*/
-	async transform(code, id) {
-		let map = null;
-		for (const plugin of this.plugins) try {
-			var _plugin$transform;
-			const res = await ((_plugin$transform = plugin.transform) === null || _plugin$transform === void 0 ? void 0 : _plugin$transform.call(plugin, {
-				code,
-				id
-			}));
-			if (!res) continue;
-			if (res.code) code = res.code;
-			if (res.map) map = res.map;
-		} catch (e) {
-			const err = e instanceof Error ? e : new Error(e);
-			throw new Error(`Plugin ${plugin.name} failed to transform: ${err.message}`);
-		}
-		return {
-			code,
-			map
-		};
-	}
-	/**
-	* Initializes the plugin runtime by activating all registered plugins.
-	* This method should be called once to set up the plugins.
-	*/
-	async init() {
-		if (this.initialized) return;
-		for (const plugin of this.plugins) try {
-			await this.#pluginContext.run({
-				plugin,
-				mode: PluginExecutionMode.Activate
-			}, async () => {
-				var _plugin$activate;
-				await ((_plugin$activate = plugin.activate) === null || _plugin$activate === void 0 ? void 0 : _plugin$activate.call(plugin, this));
-			});
-		} catch (e) {
-			console.error(`Plugin ${plugin.name} failed to activate with ${(e === null || e === void 0 ? void 0 : e.stack) || e}`);
-		}
-		this.initialized = true;
-	}
-	/**
-	* Destroys the plugin runtime by deactivating all registered plugins.
-	* This method should be called when the runtime is no longer needed.
-	*/
-	async destroy() {
-		if (!this.initialized) return;
-		for (const plugin of this.plugins) try {
-			await this.#pluginContext.run({
-				plugin,
-				mode: PluginExecutionMode.Deactivate
-			}, async () => {
-				var _plugin$deactivate;
-				await ((_plugin$deactivate = plugin.deactivate) === null || _plugin$deactivate === void 0 ? void 0 : _plugin$deactivate.call(plugin, this));
-			});
-		} catch (e) {
-			console.error(`Plugin ${plugin.name} failed to deactivate with ${(e === null || e === void 0 ? void 0 : e.stack) || e}`);
-		}
-		this.initialized = false;
-	}
-	/**
-	* Converts the plugin runtime to a JSON representation.
-	* This is useful for serialization or debugging purposes.
-	* @returns An object containing the name of the runtime and the transform method.
-	*/
-	toJSON() {
-		return {
-			name: this.name,
-			transform: this.transform.bind(this)
-		};
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'CompilerPluginRuntime', {
-  enumerable: true,
-  get: function () {
-    return CompilerPluginRuntime;
-  }
-});
-//# sourceMappingURL=CompilerPluginRuntime-OliJW0v-.js.map

package/dist/CompilerPluginRuntime-OliJW0v-.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CompilerPluginRuntime-OliJW0v-.js","names":[],"sources":["../src/plugins/plugin-runtime/CompilerPluginRuntime.ts"],"sourcesContent":["import {\n  CompilerPlugin,\n  MaybeFalsey,\n  TransformedResult,\n  TemplateHandler,\n} from '..';\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\n/**\n * Interface representing a template entry in the plugin runtime.\n * It contains a handler function for the template and the plugin that owns it.\n * @private\n */\ninterface TemplateEntry {\n  handler: TemplateHandler;\n  plugin: CompilerPlugin;\n}\n\n/**\n * Enum representing the execution mode of a plugin.\n * It can be either 'activate' or 'deactivate'.\n * @private\n */\nenum PluginExecutionMode {\n  Activate = 'activate',\n  Deactivate = 'deactivate',\n}\n\n/**\n * Context for the plugin execution, containing the plugin and its execution mode.\n * This is used to manage the state of the plugin during activation and deactivation.\n * @private\n */\ntype PluginContext = {\n  plugin: CompilerPlugin;\n  mode: PluginExecutionMode;\n};\n\n/**\n * CompilerPluginRuntime is a runtime for managing compiler plugins in CommandKit.\n */\nexport class CompilerPluginRuntime {\n  public readonly name = 'CompilerPluginRuntime';\n  private initialized = false;\n  private templates = new Map<string, TemplateEntry>();\n  #pluginContext = new AsyncLocalStorage<PluginContext>();\n\n  /**\n   * Creates a new instance of CompilerPluginRuntime.\n   * @param plugins An array of compiler plugins to be managed by this runtime.\n   */\n  public constructor(private readonly plugins: CompilerPlugin[]) {}\n\n  /**\n   * Returns the plugins managed by this runtime.\n   */\n  public getPlugins() {\n    return this.plugins;\n  }\n\n  /**\n   * Checks if there are no plugins registered in this runtime.\n   */\n  public isEmpty() {\n    return !this.plugins.length;\n  }\n\n  /**\n   * Registers a template handler for a given name.\n   * This method must be called inside the activate() method of a plugin.\n   * @param name - The name of the template to register.\n   * @param handler - The handler function for the template.\n   */\n  public registerTemplate(name: string, handler: TemplateHandler) {\n    const ctx = this.#pluginContext.getStore();\n\n    if (!ctx || ctx.mode !== PluginExecutionMode.Activate) {\n      throw new Error(\n        'registerTemplate() must be called inside activate() method',\n      );\n    }\n\n    if (this.templates.has(name)) {\n      throw new Error(`Template \"${name}\" already exists`);\n    }\n\n    this.templates.set(name, { handler, plugin: ctx.plugin });\n  }\n\n  /**\n   * Unregisters a template handler for a given name.\n   * This method must be called inside the deactivate() method of a plugin.\n   * @param name - The name of the template to unregister.\n   */\n  public unregisterTemplate(name: string) {\n    const ctx = this.#pluginContext.getStore();\n\n    if (!ctx || ctx.mode !== PluginExecutionMode.Deactivate) {\n      throw new Error(\n        'unregisterTemplate() must be called inside deactivate() method',\n      );\n    }\n\n    const template = this.templates.get(name);\n    if (!template) {\n      throw new Error(`Template \"${name}\" does not exist`);\n    }\n\n    if (template.plugin !== ctx.plugin) {\n      throw new Error(\n        `Template \"${name}\" is owned by plugin \"${template.plugin.name}\" and cannot be unregistered by \"${ctx.plugin.name}\"`,\n      );\n    }\n\n    this.templates.delete(name);\n  }\n\n  /**\n   * Retrieves a template handler by its name.\n   * @param name - The name of the template to retrieve.\n   * @returns The template handler if found, otherwise undefined.\n   */\n  public getTemplate(name: string): TemplateHandler | undefined {\n    return this.templates.get(name)?.handler;\n  }\n\n  /**\n   * Returns a map of all registered templates with their handlers.\n   * The keys are the template names and the values are the template handlers.\n   */\n  public getTemplates(): Map<string, TemplateHandler> {\n    return new Map(\n      Array.from(this.templates.entries()).map(([name, entry]) => [\n        name,\n        entry.handler,\n      ]),\n    );\n  }\n\n  /**\n   * Transforms the given code using all registered plugins.\n   * Each plugin's transform method is called in sequence, allowing them to modify the code.\n   * @param code - The code to be transformed.\n   * @param id - The identifier for the code being transformed (e.g., filename).\n   * @returns An object containing the transformed code and an optional source map.\n   */\n  public async transform(\n    code: string,\n    id: string,\n  ): Promise<{ code: string; map: string | null }> {\n    let map: string | null = null;\n    for (const plugin of this.plugins) {\n      try {\n        const res: MaybeFalsey<TransformedResult> = await plugin.transform?.({\n          code,\n          id,\n        });\n\n        if (!res) continue;\n\n        if (res.code) {\n          code = res.code;\n        }\n\n        if (res.map) {\n          map = res.map;\n        }\n      } catch (e: any) {\n        const err = e instanceof Error ? e : new Error(e);\n        throw new Error(\n          `Plugin ${plugin.name} failed to transform: ${err.message}`,\n        );\n      }\n    }\n\n    return {\n      code,\n      map,\n    };\n  }\n\n  /**\n   * Initializes the plugin runtime by activating all registered plugins.\n   * This method should be called once to set up the plugins.\n   */\n  public async init() {\n    if (this.initialized) return;\n\n    for (const plugin of this.plugins) {\n      try {\n        await this.#pluginContext.run(\n          {\n            plugin,\n            mode: PluginExecutionMode.Activate,\n          },\n          async () => {\n            await plugin.activate?.(this);\n          },\n        );\n      } catch (e: any) {\n        console.error(\n          `Plugin ${plugin.name} failed to activate with ${e?.stack || e}`,\n        );\n      }\n    }\n\n    this.initialized = true;\n  }\n\n  /**\n   * Destroys the plugin runtime by deactivating all registered plugins.\n   * This method should be called when the runtime is no longer needed.\n   */\n  public async destroy() {\n    if (!this.initialized) return;\n\n    for (const plugin of this.plugins) {\n      try {\n        await this.#pluginContext.run(\n          {\n            plugin,\n            mode: PluginExecutionMode.Deactivate,\n          },\n          async () => {\n            await plugin.deactivate?.(this);\n          },\n        );\n      } catch (e: any) {\n        console.error(\n          `Plugin ${plugin.name} failed to deactivate with ${e?.stack || e}`,\n        );\n      }\n    }\n\n    this.initialized = false;\n  }\n\n  /**\n   * Converts the plugin runtime to a JSON representation.\n   * This is useful for serialization or debugging purposes.\n   * @returns An object containing the name of the runtime and the transform method.\n   */\n  public toJSON() {\n    return {\n      name: this.name,\n      transform: this.transform.bind(this),\n    };\n  }\n}\n"],"mappings":"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"}