@powerlines/core 0.15.0 → 0.15.2

package/dist/lib/typescript/tsconfig.mjs

@@ -0,0 +1,240 @@
+import { existsSync } from "@stryke/fs/exists";
+import { readJsonFile, readJsonFileSync } from "@stryke/fs/json";
+import { appendPath } from "@stryke/path/append";
+import { findFileName, findFilePath, relativePath } from "@stryke/path/file-path-fns";
+import { joinPaths } from "@stryke/path/join-paths";
+import defu from "defu";
+import { titleCase } from "@stryke/string-format/title-case";
+import chalk from "chalk";
+import { isPackageExists } from "@stryke/fs/package-fns";
+import { getObjectDiff } from "@donedeal0/superdiff";
+import { StormJSON } from "@stryke/json/storm-json";
+import ts from "typescript";
+
+//#region src/lib/typescript/tsconfig.ts
+function getTsconfigDtsPath(context) {
+	return joinPaths(relativePath(joinPaths(context.config.cwd, context.config.root), findFilePath(context.typesPath)), findFileName(context.typesPath));
+}
+async function resolveTsconfigChanges(context) {
+	const tsconfig = getParsedTypeScriptConfig(context.config.cwd, context.config.root, context.config.tsconfig, context.config.tsconfigRaw);
+	const tsconfigJson = await readJsonFile(getTsconfigFilePath(context.config.cwd, context.config.root, context.config.tsconfig));
+	tsconfigJson.compilerOptions ??= {};
+	if (context.config.output.dts !== false) {
+		const dtsRelativePath = getTsconfigDtsPath(context);
+		if (!tsconfigJson.include?.some((filePattern) => isIncludeMatchFound(filePattern, [context.typesPath, dtsRelativePath]))) {
+			tsconfigJson.include ??= [];
+			tsconfigJson.include.push(dtsRelativePath.startsWith("./") ? dtsRelativePath.slice(2) : dtsRelativePath);
+		}
+	}
+	if (!tsconfig.options.lib?.some((lib) => [
+		"lib.esnext.d.ts",
+		"lib.es2021.d.ts",
+		"lib.es2022.d.ts",
+		"lib.es2023.d.ts"
+	].includes(lib.toLowerCase()))) {
+		tsconfigJson.compilerOptions.lib ??= [];
+		tsconfigJson.compilerOptions.lib.push("esnext");
+	}
+	if (tsconfig.options.esModuleInterop !== true) tsconfigJson.compilerOptions.esModuleInterop = true;
+	if (tsconfig.options.isolatedModules !== true) tsconfigJson.compilerOptions.isolatedModules = true;
+	if (context.config.platform === "node") {
+		if (!tsconfig.options.types?.some((type) => type.toLowerCase() === "node" || type.toLowerCase() === "@types/node")) {
+			tsconfigJson.compilerOptions.types ??= [];
+			tsconfigJson.compilerOptions.types.push("node");
+		}
+	}
+	return tsconfigJson;
+}
+async function initializeTsconfig(context) {
+	context.debug("Initializing TypeScript configuration (tsconfig.json) for the Powerlines project.");
+	if (!isPackageExists("typescript")) throw new Error("The TypeScript package is not installed. Please install the package using the command: \"npm install typescript --save-dev\"");
+	const tsconfigFilePath = getTsconfigFilePath(context.config.cwd, context.config.root, context.config.tsconfig);
+	context.tsconfig.originalTsconfigJson = await readJsonFile(tsconfigFilePath);
+	context.tsconfig.tsconfigJson = await resolveTsconfigChanges(context);
+	context.debug("Writing updated TypeScript configuration (tsconfig.json) file to disk.");
+	await context.fs.write(tsconfigFilePath, StormJSON.stringify(context.tsconfig.tsconfigJson));
+	context.tsconfig = getParsedTypeScriptConfig(context.config.cwd, context.config.root, context.config.tsconfig, context.config.tsconfigRaw, context.tsconfig.originalTsconfigJson);
+}
+async function resolveTsconfig(context) {
+	const updateTsconfigJson = await readJsonFile(context.tsconfig.tsconfigFilePath);
+	if (updateTsconfigJson?.compilerOptions?.types && Array.isArray(updateTsconfigJson.compilerOptions.types) && !updateTsconfigJson.compilerOptions.types.length) delete updateTsconfigJson.compilerOptions.types;
+	const result = getObjectDiff(context.tsconfig.originalTsconfigJson, updateTsconfigJson, {
+		ignoreArrayOrder: true,
+		showOnly: {
+			statuses: [
+				"added",
+				"deleted",
+				"updated"
+			],
+			granularity: "deep"
+		}
+	});
+	const changes = [];
+	const getChanges = (difference, property) => {
+		if (difference.status === "added" || difference.status === "deleted" || difference.status === "updated") if (difference.diff) for (const diff of difference.diff) getChanges(diff, property ? `${property}.${difference.property}` : difference.property);
+		else changes.push({
+			field: property ? `${property}.${difference.property}` : difference.property,
+			status: difference.status,
+			previous: difference.status === "added" ? "---" : StormJSON.stringify(difference.previousValue),
+			current: difference.status === "deleted" ? "---" : StormJSON.stringify(difference.currentValue)
+		});
+	};
+	for (const diff of result.diff) getChanges(diff);
+	if (changes.length > 0) context.warn(`Updating the following configuration values in "${context.tsconfig.tsconfigFilePath}" file:
+
+    ${changes.map((change, i) => `${chalk.bold.whiteBright(`${i + 1}. ${titleCase(change.status)} the ${change.field} field: `)}
+    ${chalk.red(` - Previous: ${change.previous} `)}
+    ${chalk.green(` - Updated: ${change.current} `)}
+  `).join("\n")}
+    `);
+	await context.fs.write(context.tsconfig.tsconfigFilePath, StormJSON.stringify(updateTsconfigJson));
+	context.tsconfig = getParsedTypeScriptConfig(context.config.cwd, context.config.root, context.config.tsconfig);
+	if (!context.tsconfig) throw new Error("Failed to parse the TypeScript configuration file.");
+}
+/**
+* Get the path to the tsconfig.json file.
+*
+* @param cwd - The root directory of the workspace.
+* @param root - The root directory of the project.
+* @param tsconfig - The path to the tsconfig.json file.
+* @returns The absolute path to the tsconfig.json file.
+* @throws If the tsconfig.json file does not exist.
+*/
+function getTsconfigFilePath(cwd, root, tsconfig) {
+	let tsconfigFilePath;
+	if (tsconfig) tsconfigFilePath = tryTsconfigFilePath(cwd, root, tsconfig);
+	else {
+		tsconfigFilePath = tryTsconfigFilePath(cwd, root, "tsconfig.app.json");
+		if (!tsconfigFilePath) {
+			tsconfigFilePath = tryTsconfigFilePath(cwd, root, "tsconfig.lib.json");
+			if (!tsconfigFilePath) tsconfigFilePath = tryTsconfigFilePath(cwd, root, "tsconfig.json");
+		}
+	}
+	if (!tsconfigFilePath) throw new Error(`Cannot find the \`tsconfig.json\` configuration file for the project at ${root}.`);
+	return tsconfigFilePath;
+}
+/**
+* Get the path to the tsconfig.json file.
+*
+* @param cwd - The root directory of the workspace.
+* @param root - The root directory of the project.
+* @param tsconfig - The path to the tsconfig.json file.
+* @returns The absolute path to the tsconfig.json file.
+* @throws If the tsconfig.json file does not exist.
+*/
+function tryTsconfigFilePath(cwd, root, tsconfig) {
+	let tsconfigFilePath = tsconfig;
+	if (!existsSync(tsconfigFilePath)) {
+		tsconfigFilePath = appendPath(tsconfig, root);
+		if (!existsSync(tsconfigFilePath)) {
+			tsconfigFilePath = appendPath(tsconfig, appendPath(root, cwd));
+			if (!existsSync(tsconfigFilePath)) return;
+		}
+	}
+	return tsconfigFilePath;
+}
+/**
+* Check if the TypeScript configuration type matches any of the provided types.
+*
+* @param tsconfigType - The type from the TypeScript configuration.
+* @param types - An array of type names to check against.
+* @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+*/
+function findMatch(tsconfigType, types, extensions = [
+	".ts",
+	".tsx",
+	".d.ts"
+]) {
+	return types.find((type) => tsconfigType?.toString().toLowerCase() === type?.toString().toLowerCase() || tsconfigType?.toString().toLowerCase() === `./${type?.toString().toLowerCase()}` || `./${tsconfigType?.toString().toLowerCase()}` === type?.toString().toLowerCase() || extensions.some((ext) => `${tsconfigType?.toString().toLowerCase()}${ext}` === type?.toString().toLowerCase() || `${tsconfigType?.toString().toLowerCase()}${ext}` === `./${type?.toString().toLowerCase()}` || `${type?.toString().toLowerCase()}${ext}` === `./${tsconfigType?.toString().toLowerCase()}` || tsconfigType?.toString().toLowerCase() === `${type?.toString().toLowerCase()}${ext}` || tsconfigType?.toString().toLowerCase() === `./${type?.toString().toLowerCase()}${ext}` || type?.toString().toLowerCase() === `./${tsconfigType?.toString().toLowerCase()}${ext}`));
+}
+/**
+* Check if the TypeScript configuration type matches any of the provided types.
+*
+* @param tsconfigType - The type from the TypeScript configuration.
+* @param types - An array of type names to check against.
+* @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+*/
+function findIncludeMatch(tsconfigType, types) {
+	return findMatch(tsconfigType, types, [
+		".ts",
+		".tsx",
+		".d.ts",
+		".js",
+		".jsx",
+		".mjs",
+		".cjs",
+		".mts",
+		".cts",
+		"/*.ts",
+		"/*.tsx",
+		"/*.d.ts",
+		"/*.js",
+		"/*.jsx",
+		"/*.mjs",
+		"/*.cjs",
+		"/*.mts",
+		"/*.cts",
+		"/**/*.ts",
+		"/**/*.tsx",
+		"/**/*.d.ts",
+		"/**/*.js",
+		"/**/*.jsx",
+		"/**/*.mjs",
+		"/**/*.cjs",
+		"/**/*.mts",
+		"/**/*.cts"
+	]);
+}
+/**
+* Check if the TypeScript configuration type matches any of the provided types.
+*
+* @param tsconfigType - The type from the TypeScript configuration.
+* @param types - An array of type names to check against.
+* @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+*/
+function isMatchFound(tsconfigType, types) {
+	return findMatch(tsconfigType, types) !== void 0;
+}
+/**
+* Check if the TypeScript configuration type matches any of the provided types.
+*
+* @param tsconfigType - The type from the TypeScript configuration.
+* @param types - An array of type names to check against.
+* @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+*/
+function isIncludeMatchFound(tsconfigType, types) {
+	return findIncludeMatch(tsconfigType, types) !== void 0;
+}
+/**
+* Get the parsed TypeScript configuration.
+*
+* @param workspaceRoot - The root directory of the workspace.
+* @param projectRoot - The root directory of the project.
+* @param tsconfig - The path to the tsconfig.json file.
+* @param tsconfigRaw - The raw tsconfig.json content.
+* @param originalTsconfigJson - The original tsconfig.json content.
+* @param host - The TypeScript parse config host.
+* @returns The resolved TypeScript configuration.
+*/
+function getParsedTypeScriptConfig(workspaceRoot, projectRoot, tsconfig, tsconfigRaw = {}, originalTsconfigJson, host = ts.sys) {
+	const tsconfigFilePath = getTsconfigFilePath(workspaceRoot, projectRoot, tsconfig);
+	const tsconfigJson = readJsonFileSync(tsconfigFilePath);
+	if (!tsconfigJson) throw new Error(`Cannot find the \`tsconfig.json\` configuration file at ${joinPaths(projectRoot, tsconfig ?? "tsconfig.json")}`);
+	const parsedCommandLine = ts.parseJsonConfigFileContent(defu(tsconfigRaw ?? {}, tsconfigJson), host, appendPath(projectRoot, workspaceRoot));
+	if (parsedCommandLine.errors.length > 0) {
+		const errorMessage = `Cannot parse the TypeScript compiler options. Please investigate the following issues:
+${parsedCommandLine.errors.map((error) => `- ${(error.category !== void 0 && error.code ? `[${error.category}-${error.code}]: ` : "") + error.messageText.toString()}`).join("\n")}
+      `;
+		throw new Error(errorMessage);
+	}
+	return {
+		...parsedCommandLine,
+		originalTsconfigJson: originalTsconfigJson ?? tsconfigJson,
+		tsconfigJson,
+		tsconfigFilePath
+	};
+}
+
+//#endregion
+export { findIncludeMatch, findMatch, getParsedTypeScriptConfig, getTsconfigDtsPath, getTsconfigFilePath, initializeTsconfig, isIncludeMatchFound, isMatchFound, resolveTsconfig, tryTsconfigFilePath };
+//# sourceMappingURL=tsconfig.mjs.map

package/dist/lib/typescript/tsconfig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig.mjs","names":[],"sources":["../../../src/lib/typescript/tsconfig.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Diff, ObjectData } from \"@donedeal0/superdiff\";\nimport { getObjectDiff } from \"@donedeal0/superdiff\";\nimport { existsSync } from \"@stryke/fs/exists\";\nimport { readJsonFile, readJsonFileSync } from \"@stryke/fs/json\";\nimport { isPackageExists } from \"@stryke/fs/package-fns\";\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport { appendPath } from \"@stryke/path/append\";\nimport {\n  findFileName,\n  findFilePath,\n  relativePath\n} from \"@stryke/path/file-path-fns\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { FilterPattern } from \"@stryke/types/file\";\nimport { TsConfigJson } from \"@stryke/types/tsconfig\";\nimport chalk from \"chalk\";\nimport defu from \"defu\";\nimport ts from \"typescript\";\nimport { ResolvedConfig } from \"../../types/config\";\nimport { EnvironmentContext } from \"../../types/context\";\nimport type { ParsedTypeScriptConfig, TSConfig } from \"../../types/tsconfig\";\n\nexport function getTsconfigDtsPath<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig,\n  TSystemContext = unknown\n>(context: EnvironmentContext<TResolvedConfig, TSystemContext>): string {\n  const dtsRelativePath = joinPaths(\n    relativePath(\n      joinPaths(context.config.cwd, context.config.root),\n      findFilePath(context.typesPath)\n    ),\n    findFileName(context.typesPath)\n  );\n\n  return dtsRelativePath;\n}\n\nasync function resolveTsconfigChanges<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig,\n  TSystemContext = unknown\n>(\n  context: EnvironmentContext<TResolvedConfig, TSystemContext>\n): Promise<TsConfigJson> {\n  const tsconfig = getParsedTypeScriptConfig(\n    context.config.cwd,\n    context.config.root,\n    context.config.tsconfig,\n    context.config.tsconfigRaw\n  );\n\n  const tsconfigFilePath = getTsconfigFilePath(\n    context.config.cwd,\n    context.config.root,\n    context.config.tsconfig\n  );\n\n  const tsconfigJson = await readJsonFile<TsConfigJson>(tsconfigFilePath);\n  tsconfigJson.compilerOptions ??= {};\n\n  if (context.config.output.dts !== false) {\n    const dtsRelativePath = getTsconfigDtsPath(context);\n\n    if (\n      !tsconfigJson.include?.some(filePattern =>\n        isIncludeMatchFound(filePattern, [context.typesPath, dtsRelativePath])\n      )\n    ) {\n      tsconfigJson.include ??= [];\n      tsconfigJson.include.push(\n        dtsRelativePath.startsWith(\"./\")\n          ? dtsRelativePath.slice(2)\n          : dtsRelativePath\n      );\n    }\n  }\n\n  if (\n    !tsconfig.options.lib?.some(lib =>\n      [\n        \"lib.esnext.d.ts\",\n        \"lib.es2021.d.ts\",\n        \"lib.es2022.d.ts\",\n        \"lib.es2023.d.ts\"\n      ].includes(lib.toLowerCase())\n    )\n  ) {\n    tsconfigJson.compilerOptions.lib ??= [];\n    tsconfigJson.compilerOptions.lib.push(\"esnext\");\n  }\n\n  // if (tsconfig.options.module !== ts.ModuleKind.ESNext) {\n  //   tsconfigJson.compilerOptions.module = \"ESNext\";\n  // }\n\n  // if (\n  //   !tsconfig.options.target ||\n  //   ![\n  //     ts.ScriptTarget.ESNext,\n  //     ts.ScriptTarget.ES2024,\n  //     ts.ScriptTarget.ES2023,\n  //     ts.ScriptTarget.ES2022,\n  //     ts.ScriptTarget.ES2021\n  //   ].includes(tsconfig.options.target)\n  // ) {\n  //   tsconfigJson.compilerOptions.target = \"ESNext\";\n  // }\n\n  // if (tsconfig.options.moduleResolution !== ts.ModuleResolutionKind.Bundler) {\n  //   tsconfigJson.compilerOptions.moduleResolution = \"Bundler\";\n  // }\n\n  // if (tsconfig.options.moduleDetection !== ts.ModuleDetectionKind.Force) {\n  //   tsconfigJson.compilerOptions.moduleDetection = \"force\";\n  // }\n\n  // if (tsconfig.options.allowSyntheticDefaultImports !== true) {\n  //   tsconfigJson.compilerOptions.allowSyntheticDefaultImports = true;\n  // }\n\n  // if (tsconfig.options.noImplicitOverride !== true) {\n  //   tsconfigJson.compilerOptions.noImplicitOverride = true;\n  // }\n\n  // if (tsconfig.options.noUncheckedIndexedAccess !== true) {\n  //   tsconfigJson.compilerOptions.noUncheckedIndexedAccess = true;\n  // }\n\n  // if (tsconfig.options.skipLibCheck !== true) {\n  //   tsconfigJson.compilerOptions.skipLibCheck = true;\n  // }\n\n  // if (tsconfig.options.resolveJsonModule !== true) {\n  //   tsconfigJson.compilerOptions.resolveJsonModule = true;\n  // }\n\n  // if (tsconfig.options.verbatimModuleSyntax !== false) {\n  //   tsconfigJson.compilerOptions.verbatimModuleSyntax = false;\n  // }\n\n  // if (tsconfig.options.allowJs !== true) {\n  //   tsconfigJson.compilerOptions.allowJs = true;\n  // }\n\n  // if (tsconfig.options.declaration !== true) {\n  //   tsconfigJson.compilerOptions.declaration = true;\n  // }\n\n  if (tsconfig.options.esModuleInterop !== true) {\n    tsconfigJson.compilerOptions.esModuleInterop = true;\n  }\n\n  if (tsconfig.options.isolatedModules !== true) {\n    tsconfigJson.compilerOptions.isolatedModules = true;\n  }\n\n  if (context.config.platform === \"node\") {\n    if (\n      !tsconfig.options.types?.some(\n        type =>\n          type.toLowerCase() === \"node\" || type.toLowerCase() === \"@types/node\"\n      )\n    ) {\n      tsconfigJson.compilerOptions.types ??= [];\n      tsconfigJson.compilerOptions.types.push(\"node\");\n    }\n  }\n\n  return tsconfigJson;\n}\n\nexport async function initializeTsconfig<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig,\n  TSystemContext = unknown,\n  TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> =\n    EnvironmentContext<TResolvedConfig, TSystemContext>\n>(context: TContext): Promise<void> {\n  context.debug(\n    \"Initializing TypeScript configuration (tsconfig.json) for the Powerlines project.\"\n  );\n\n  if (!isPackageExists(\"typescript\")) {\n    throw new Error(\n      'The TypeScript package is not installed. Please install the package using the command: \"npm install typescript --save-dev\"'\n    );\n  }\n\n  const tsconfigFilePath = getTsconfigFilePath(\n    context.config.cwd,\n    context.config.root,\n    context.config.tsconfig\n  );\n\n  context.tsconfig.originalTsconfigJson =\n    await readJsonFile<TsConfigJson>(tsconfigFilePath);\n\n  context.tsconfig.tsconfigJson = await resolveTsconfigChanges<\n    TResolvedConfig,\n    TSystemContext\n  >(context);\n\n  context.debug(\n    \"Writing updated TypeScript configuration (tsconfig.json) file to disk.\"\n  );\n\n  await context.fs.write(\n    tsconfigFilePath,\n    StormJSON.stringify(context.tsconfig.tsconfigJson)\n  );\n\n  context.tsconfig = getParsedTypeScriptConfig(\n    context.config.cwd,\n    context.config.root,\n    context.config.tsconfig,\n    context.config.tsconfigRaw,\n    context.tsconfig.originalTsconfigJson\n  );\n}\n\nexport async function resolveTsconfig<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig,\n  TSystemContext = unknown,\n  TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> =\n    EnvironmentContext<TResolvedConfig, TSystemContext>\n>(context: TContext): Promise<void> {\n  const updateTsconfigJson = await readJsonFile<TsConfigJson>(\n    context.tsconfig.tsconfigFilePath\n  );\n  if (\n    updateTsconfigJson?.compilerOptions?.types &&\n    Array.isArray(updateTsconfigJson.compilerOptions.types) &&\n    !updateTsconfigJson.compilerOptions.types.length\n  ) {\n    // If the types array is empty, we can safely remove it\n    delete updateTsconfigJson.compilerOptions.types;\n  }\n\n  const result = getObjectDiff(\n    context.tsconfig.originalTsconfigJson as NonNullable<ObjectData>,\n    updateTsconfigJson as ObjectData,\n    {\n      ignoreArrayOrder: true,\n      showOnly: {\n        statuses: [\"added\", \"deleted\", \"updated\"],\n        granularity: \"deep\"\n      }\n    }\n  );\n\n  const changes = [] as {\n    field: string;\n    status: \"added\" | \"deleted\" | \"updated\";\n    previous: string;\n    current: string;\n  }[];\n  const getChanges = (difference: Diff, property?: string) => {\n    if (\n      difference.status === \"added\" ||\n      difference.status === \"deleted\" ||\n      difference.status === \"updated\"\n    ) {\n      if (difference.diff) {\n        for (const diff of difference.diff) {\n          getChanges(\n            diff,\n            property\n              ? `${property}.${difference.property}`\n              : difference.property\n          );\n        }\n      } else {\n        changes.push({\n          field: property\n            ? `${property}.${difference.property}`\n            : difference.property,\n          status: difference.status,\n          previous:\n            difference.status === \"added\"\n              ? \"---\"\n              : StormJSON.stringify(difference.previousValue),\n          current:\n            difference.status === \"deleted\"\n              ? \"---\"\n              : StormJSON.stringify(difference.currentValue)\n        });\n      }\n    }\n  };\n\n  for (const diff of result.diff) {\n    getChanges(diff);\n  }\n\n  if (changes.length > 0) {\n    context.warn(\n      `Updating the following configuration values in \"${context.tsconfig.tsconfigFilePath}\" file:\n\n    ${changes\n      .map(\n        (change, i) => `${chalk.bold.whiteBright(\n          `${i + 1}. ${titleCase(change.status)} the ${change.field} field: `\n        )}\n    ${chalk.red(` - Previous: ${change.previous} `)}\n    ${chalk.green(` - Updated: ${change.current} `)}\n  `\n      )\n      .join(\"\\n\")}\n    `\n    );\n  }\n\n  await context.fs.write(\n    context.tsconfig.tsconfigFilePath,\n    StormJSON.stringify(updateTsconfigJson)\n  );\n\n  context.tsconfig = getParsedTypeScriptConfig(\n    context.config.cwd,\n    context.config.root,\n    context.config.tsconfig\n  );\n  if (!context.tsconfig) {\n    throw new Error(\"Failed to parse the TypeScript configuration file.\");\n  }\n}\n\n/**\n * Get the path to the tsconfig.json file.\n *\n * @param cwd - The root directory of the workspace.\n * @param root - The root directory of the project.\n * @param tsconfig - The path to the tsconfig.json file.\n * @returns The absolute path to the tsconfig.json file.\n * @throws If the tsconfig.json file does not exist.\n */\nexport function getTsconfigFilePath(\n  cwd: string,\n  root: string,\n  tsconfig?: string\n): string {\n  let tsconfigFilePath: string | undefined;\n  if (tsconfig) {\n    tsconfigFilePath = tryTsconfigFilePath(cwd, root, tsconfig);\n  } else {\n    tsconfigFilePath = tryTsconfigFilePath(cwd, root, \"tsconfig.app.json\");\n    if (!tsconfigFilePath) {\n      tsconfigFilePath = tryTsconfigFilePath(cwd, root, \"tsconfig.lib.json\");\n      if (!tsconfigFilePath) {\n        tsconfigFilePath = tryTsconfigFilePath(cwd, root, \"tsconfig.json\");\n      }\n    }\n  }\n\n  if (!tsconfigFilePath) {\n    throw new Error(\n      `Cannot find the \\`tsconfig.json\\` configuration file for the project at ${\n        root\n      }.`\n    );\n  }\n\n  return tsconfigFilePath;\n}\n\n/**\n * Get the path to the tsconfig.json file.\n *\n * @param cwd - The root directory of the workspace.\n * @param root - The root directory of the project.\n * @param tsconfig - The path to the tsconfig.json file.\n * @returns The absolute path to the tsconfig.json file.\n * @throws If the tsconfig.json file does not exist.\n */\nexport function tryTsconfigFilePath(\n  cwd: string,\n  root: string,\n  tsconfig: string\n): string | undefined {\n  let tsconfigFilePath = tsconfig;\n  if (!existsSync(tsconfigFilePath)) {\n    tsconfigFilePath = appendPath(tsconfig, root);\n    if (!existsSync(tsconfigFilePath)) {\n      tsconfigFilePath = appendPath(tsconfig, appendPath(root, cwd));\n      if (!existsSync(tsconfigFilePath)) {\n        return undefined;\n      }\n    }\n  }\n\n  return tsconfigFilePath;\n}\n\n/**\n * Check if the TypeScript configuration type matches any of the provided types.\n *\n * @param tsconfigType - The type from the TypeScript configuration.\n * @param types - An array of type names to check against.\n * @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.\n */\nexport function findMatch(\n  tsconfigType: string | RegExp | null,\n  types: (string | RegExp | null)[],\n  extensions: string[] = [\".ts\", \".tsx\", \".d.ts\"]\n): string | RegExp | null | undefined {\n  return types.find(\n    type =>\n      tsconfigType?.toString().toLowerCase() ===\n        type?.toString().toLowerCase() ||\n      tsconfigType?.toString().toLowerCase() ===\n        `./${type?.toString().toLowerCase()}` ||\n      `./${tsconfigType?.toString().toLowerCase()}` ===\n        type?.toString().toLowerCase() ||\n      extensions.some(\n        ext =>\n          `${tsconfigType?.toString().toLowerCase()}${ext}` ===\n            type?.toString().toLowerCase() ||\n          `${tsconfigType?.toString().toLowerCase()}${ext}` ===\n            `./${type?.toString().toLowerCase()}` ||\n          `${type?.toString().toLowerCase()}${ext}` ===\n            `./${tsconfigType?.toString().toLowerCase()}` ||\n          tsconfigType?.toString().toLowerCase() ===\n            `${type?.toString().toLowerCase()}${ext}` ||\n          tsconfigType?.toString().toLowerCase() ===\n            `./${type?.toString().toLowerCase()}${ext}` ||\n          type?.toString().toLowerCase() ===\n            `./${tsconfigType?.toString().toLowerCase()}${ext}`\n      )\n  );\n}\n\n/**\n * Check if the TypeScript configuration type matches any of the provided types.\n *\n * @param tsconfigType - The type from the TypeScript configuration.\n * @param types - An array of type names to check against.\n * @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.\n */\nexport function findIncludeMatch(\n  tsconfigType: string | RegExp | null,\n  types: (string | RegExp | null)[]\n): string | RegExp | null | undefined {\n  return findMatch(tsconfigType, types, [\n    \".ts\",\n    \".tsx\",\n    \".d.ts\",\n    \".js\",\n    \".jsx\",\n    \".mjs\",\n    \".cjs\",\n    \".mts\",\n    \".cts\",\n    \"/*.ts\",\n    \"/*.tsx\",\n    \"/*.d.ts\",\n    \"/*.js\",\n    \"/*.jsx\",\n    \"/*.mjs\",\n    \"/*.cjs\",\n    \"/*.mts\",\n    \"/*.cts\",\n    \"/**/*.ts\",\n    \"/**/*.tsx\",\n    \"/**/*.d.ts\",\n    \"/**/*.js\",\n    \"/**/*.jsx\",\n    \"/**/*.mjs\",\n    \"/**/*.cjs\",\n    \"/**/*.mts\",\n    \"/**/*.cts\"\n  ]);\n}\n\n/**\n * Check if the TypeScript configuration type matches any of the provided types.\n *\n * @param tsconfigType - The type from the TypeScript configuration.\n * @param types - An array of type names to check against.\n * @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.\n */\nexport function isMatchFound(\n  tsconfigType: string | RegExp | null,\n  types: (string | RegExp | null)[]\n): boolean {\n  return findMatch(tsconfigType, types) !== undefined;\n}\n\n/**\n * Check if the TypeScript configuration type matches any of the provided types.\n *\n * @param tsconfigType - The type from the TypeScript configuration.\n * @param types - An array of type names to check against.\n * @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.\n */\nexport function isIncludeMatchFound(\n  tsconfigType: FilterPattern,\n  types: FilterPattern[]\n): boolean {\n  return (\n    findIncludeMatch(\n      tsconfigType as string | RegExp | null,\n      types as (string | RegExp | null)[]\n    ) !== undefined\n  );\n}\n\n/**\n * Get the parsed TypeScript configuration.\n *\n * @param workspaceRoot - The root directory of the workspace.\n * @param projectRoot - The root directory of the project.\n * @param tsconfig - The path to the tsconfig.json file.\n * @param tsconfigRaw - The raw tsconfig.json content.\n * @param originalTsconfigJson - The original tsconfig.json content.\n * @param host - The TypeScript parse config host.\n * @returns The resolved TypeScript configuration.\n */\nexport function getParsedTypeScriptConfig(\n  workspaceRoot: string,\n  projectRoot: string,\n  tsconfig?: string,\n  tsconfigRaw: TSConfig = {},\n  originalTsconfigJson?: TSConfig,\n  host: ts.ParseConfigHost = ts.sys\n): ParsedTypeScriptConfig {\n  const tsconfigFilePath = getTsconfigFilePath(\n    workspaceRoot,\n    projectRoot,\n    tsconfig\n  );\n  const tsconfigJson = readJsonFileSync<TSConfig>(tsconfigFilePath);\n  if (!tsconfigJson) {\n    throw new Error(\n      `Cannot find the \\`tsconfig.json\\` configuration file at ${joinPaths(\n        projectRoot,\n        tsconfig ?? \"tsconfig.json\"\n      )}`\n    );\n  }\n\n  const parsedCommandLine = ts.parseJsonConfigFileContent(\n    defu(tsconfigRaw ?? {}, tsconfigJson),\n    host,\n    appendPath(projectRoot, workspaceRoot)\n  );\n  if (parsedCommandLine.errors.length > 0) {\n    const errorMessage = `Cannot parse the TypeScript compiler options. Please investigate the following issues:\n${parsedCommandLine.errors\n  .map(\n    error =>\n      `- ${\n        (error.category !== undefined && error.code\n          ? `[${error.category}-${error.code}]: `\n          : \"\") + error.messageText.toString()\n      }`\n  )\n  .join(\"\\n\")}\n      `;\n\n    throw new Error(errorMessage);\n  }\n\n  return {\n    ...parsedCommandLine,\n    originalTsconfigJson: (originalTsconfigJson ??\n      tsconfigJson) as TsConfigJson,\n    tsconfigJson,\n    tsconfigFilePath\n  };\n}\n"],"mappings":"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"}

package/dist/lib/unplugin/helpers.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
-const require_plugin = require('../../constants/plugin.cjs');
+const require_constants_plugin = require('../../constants/plugin.cjs');
 let defu = require("defu");
 let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 
@@ -22,7 +22,7 @@ function combineContexts(contextA, contextB) {
 * @returns True if the value is a UnpluginBuilderVariant, false otherwise.
 */
 function isUnpluginBuilderVariant(str) {
-	return (0, _stryke_type_checks_is_set_string.isSetString)(str) && require_plugin.UNPLUGIN_BUILDER_VARIANTS.includes(str);
+	return (0, _stryke_type_checks_is_set_string.isSetString)(str) && require_constants_plugin.UNPLUGIN_BUILDER_VARIANTS.includes(str);
 }
 
 //#endregion

package/dist/lib/unplugin/module-resolution.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
-const require_virtual_modules = require('../../constants/virtual-modules.cjs');
+const require_plugin_utils_virtual = require('../../plugin-utils/virtual.cjs');
+require('../../plugin-utils/index.cjs');
 let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 let defu = require("defu");
 defu = require_runtime.__toESM(defu, 1);
@@ -21,12 +22,11 @@ let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-stri
 * @returns The module resolution hooks (`resolveId` and `load`).
 */
 function createUnpluginModuleResolutionFunctions(context, options = {}) {
-	const ctx = context;
 	return {
 		async resolveId(id, importer, opts = { isEntry: false }) {
-			const normalizedId = id.replace(require_virtual_modules.VIRTUAL_MODULE_PREFIX_REGEX, "");
-			const normalizedImporter = importer ? importer.replace(require_virtual_modules.VIRTUAL_MODULE_PREFIX_REGEX, "") : void 0;
-			let result = await ctx.$$internal.callHook("resolveId", {
+			const normalizedId = require_plugin_utils_virtual.removeVirtualPrefix(id);
+			const normalizedImporter = importer ? require_plugin_utils_virtual.removeVirtualPrefix(importer) : void 0;
+			let result = await context.callHook("resolveId", {
 				sequential: true,
 				result: "first",
 				order: "pre"
@@ -34,9 +34,9 @@ function createUnpluginModuleResolutionFunctions(context, options = {}) {
 			if ((0, _stryke_type_checks_is_set_string.isSetString)(result)) return result;
 			else if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) return {
 				...result,
-				id: result.virtual && options.prefix !== false ? `${require_virtual_modules.VIRTUAL_MODULE_PREFIX}${result.id}` : result.id
+				id: result.virtual && options.prefix !== false ? require_plugin_utils_virtual.addVirtualPrefix(result.id) : result.id
 			};
-			result = await ctx.$$internal.callHook("resolveId", {
+			result = await context.callHook("resolveId", {
 				sequential: true,
 				result: "first",
 				order: "normal"
@@ -44,17 +44,17 @@ function createUnpluginModuleResolutionFunctions(context, options = {}) {
 			if ((0, _stryke_type_checks_is_set_string.isSetString)(result)) return result;
 			else if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) return {
 				...result,
-				id: result.virtual && options.prefix !== false ? `${require_virtual_modules.VIRTUAL_MODULE_PREFIX}${result.id}` : result.id
+				id: result.virtual && options.prefix !== false ? require_plugin_utils_virtual.addVirtualPrefix(result.id) : result.id
 			};
-			result = await ctx.resolve(normalizedId, normalizedImporter, (0, defu.default)(options.overrides ?? {}, {
+			result = await context.resolve(normalizedId, normalizedImporter, (0, defu.default)(options.overrides ?? {}, {
 				isFile: true,
 				...opts
 			}));
 			if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) return {
 				...result,
-				id: result.virtual && options.prefix !== false ? `${require_virtual_modules.VIRTUAL_MODULE_PREFIX}${result.id}` : result.id
+				id: result.virtual && options.prefix !== false ? require_plugin_utils_virtual.addVirtualPrefix(result.id) : result.id
 			};
-			result = await ctx.$$internal.callHook("resolveId", {
+			result = await context.callHook("resolveId", {
 				sequential: true,
 				result: "first",
 				order: "post"
@@ -62,29 +62,29 @@ function createUnpluginModuleResolutionFunctions(context, options = {}) {
 			if ((0, _stryke_type_checks_is_set_string.isSetString)(result)) return result;
 			else if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) return {
 				...result,
-				id: result.virtual && options.prefix !== false ? `${require_virtual_modules.VIRTUAL_MODULE_PREFIX}${result.id}` : result.id
+				id: result.virtual && options.prefix !== false ? require_plugin_utils_virtual.addVirtualPrefix(result.id) : result.id
 			};
 			return null;
 		},
 		load: {
-			filter: options.prefix !== false ? { id: { include: [require_virtual_modules.VIRTUAL_MODULE_PREFIX_REGEX] } } : void 0,
+			filter: options.prefix !== false ? { id: require_plugin_utils_virtual.VIRTUAL_MODULE_PREFIX_REGEX } : void 0,
 			async handler(id) {
-				const normalizedId = id.replace(require_virtual_modules.VIRTUAL_MODULE_PREFIX_REGEX, "");
-				let result = await ctx.$$internal.callHook("load", {
+				const normalizedId = require_plugin_utils_virtual.removeVirtualPrefix(id);
+				let result = await context.callHook("load", {
 					sequential: true,
 					result: "first",
 					order: "pre"
 				}, normalizedId);
 				if (result) return result;
-				result = await ctx.$$internal.callHook("load", {
+				result = await context.callHook("load", {
 					sequential: true,
 					result: "first",
 					order: "normal"
 				}, normalizedId);
 				if (result) return result;
-				result = await ctx.load(normalizedId);
+				result = await context.load(normalizedId);
 				if (result) return result;
-				return ctx.$$internal.callHook("load", {
+				return context.callHook("load", {
 					sequential: true,
 					result: "first",
 					order: "post"

package/dist/lib/unplugin/module-resolution.d.cts

@@ -1,5 +1,5 @@
 import { ResolveOptions } from "../../types/fs.cjs";
-import { PluginContext } from "../../types/context.cjs";
+import { UnresolvedContext } from "../../types/context.cjs";
 import { UnpluginOptions } from "unplugin";
 
 //#region src/lib/unplugin/module-resolution.d.ts
@@ -35,7 +35,7 @@ interface CreateUnpluginModuleResolutionFunctionsOptions {
  * @param options - Options for creating the module resolution functions.
  * @returns The module resolution hooks (`resolveId` and `load`).
  */
-declare function createUnpluginModuleResolutionFunctions<TContext extends PluginContext = PluginContext>(context: TContext, options?: CreateUnpluginModuleResolutionFunctionsOptions): Pick<UnpluginOptions, "resolveId" | "load">;
+declare function createUnpluginModuleResolutionFunctions<TContext extends UnresolvedContext>(context: TContext, options?: CreateUnpluginModuleResolutionFunctionsOptions): Pick<UnpluginOptions, "resolveId" | "load">;
 declare type __ΩCreateUnpluginModuleResolutionFunctionsOptions = any[];
 //#endregion
 export { CreateUnpluginModuleResolutionFunctionsOptions, __ΩCreateUnpluginModuleResolutionFunctionsOptions, createUnpluginModuleResolutionFunctions };

package/dist/lib/unplugin/module-resolution.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"module-resolution.d.cts","names":[],"sources":["../../../src/lib/unplugin/module-resolution.ts"],"mappings":";;;;;UAmCiB,8CAAA;;AAAjB;;;;;;;;EAUE,MAAA;EAQkC;AAgBpC;;;;;EAhBE,SAAA,GAAY,OAAA,CAAQ,cAAA;AAAA;;;;;;;;;;;;;;iBAgBN,uCAAA,kBACG,aAAA,GAAgB,aAAA,CAAA,CAEjC,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,8CAAA,GACR,IAAA,CAAK,eAAA;AAAA"}
+{"version":3,"file":"module-resolution.d.cts","names":[],"sources":["../../../src/lib/unplugin/module-resolution.ts"],"mappings":";;;;;UAmCiB,8CAAA;;AAAjB;;;;;;;;EAUE,MAAA;EAQkC;AAgBpC;;;;;EAhBE,SAAA,GAAY,OAAA,CAAQ,cAAA;AAAA;;;;;;;;;;;;;;iBAgBN,uCAAA,kBACG,iBAAA,CAAA,CAEjB,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,8CAAA,GACR,IAAA,CAAK,eAAA;AAAA"}

package/dist/lib/unplugin/module-resolution.d.mts

@@ -1,5 +1,5 @@
 import { ResolveOptions } from "../../types/fs.mjs";
-import { PluginContext } from "../../types/context.mjs";
+import { UnresolvedContext } from "../../types/context.mjs";
 import { UnpluginOptions } from "unplugin";
 
 //#region src/lib/unplugin/module-resolution.d.ts
@@ -35,7 +35,7 @@ interface CreateUnpluginModuleResolutionFunctionsOptions {
  * @param options - Options for creating the module resolution functions.
  * @returns The module resolution hooks (`resolveId` and `load`).
  */
-declare function createUnpluginModuleResolutionFunctions<TContext extends PluginContext = PluginContext>(context: TContext, options?: CreateUnpluginModuleResolutionFunctionsOptions): Pick<UnpluginOptions, "resolveId" | "load">;
+declare function createUnpluginModuleResolutionFunctions<TContext extends UnresolvedContext>(context: TContext, options?: CreateUnpluginModuleResolutionFunctionsOptions): Pick<UnpluginOptions, "resolveId" | "load">;
 declare type __ΩCreateUnpluginModuleResolutionFunctionsOptions = any[];
 //#endregion
 export { CreateUnpluginModuleResolutionFunctionsOptions, __ΩCreateUnpluginModuleResolutionFunctionsOptions, createUnpluginModuleResolutionFunctions };

package/dist/lib/unplugin/module-resolution.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"module-resolution.d.mts","names":[],"sources":["../../../src/lib/unplugin/module-resolution.ts"],"mappings":";;;;;UAmCiB,8CAAA;;AAAjB;;;;;;;;EAUE,MAAA;EAQkC;AAgBpC;;;;;EAhBE,SAAA,GAAY,OAAA,CAAQ,cAAA;AAAA;;;;;;;;;;;;;;iBAgBN,uCAAA,kBACG,aAAA,GAAgB,aAAA,CAAA,CAEjC,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,8CAAA,GACR,IAAA,CAAK,eAAA;AAAA"}
+{"version":3,"file":"module-resolution.d.mts","names":[],"sources":["../../../src/lib/unplugin/module-resolution.ts"],"mappings":";;;;;UAmCiB,8CAAA;;AAAjB;;;;;;;;EAUE,MAAA;EAQkC;AAgBpC;;;;;EAhBE,SAAA,GAAY,OAAA,CAAQ,cAAA;AAAA;;;;;;;;;;;;;;iBAgBN,uCAAA,kBACG,iBAAA,CAAA,CAEjB,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,8CAAA,GACR,IAAA,CAAK,eAAA;AAAA"}

package/dist/lib/unplugin/module-resolution.mjs

@@ -1,4 +1,5 @@
-import { VIRTUAL_MODULE_PREFIX, VIRTUAL_MODULE_PREFIX_REGEX } from "../../constants/virtual-modules.mjs";
+import { VIRTUAL_MODULE_PREFIX_REGEX, addVirtualPrefix, removeVirtualPrefix } from "../../plugin-utils/virtual.mjs";
+import "../../plugin-utils/index.mjs";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
 import defu from "defu";
 import { isSetString } from "@stryke/type-checks/is-set-string";
@@ -18,12 +19,11 @@ import { isSetString } from "@stryke/type-checks/is-set-string";
 * @returns The module resolution hooks (`resolveId` and `load`).
 */
 function createUnpluginModuleResolutionFunctions(context, options = {}) {
-	const ctx = context;
 	return {
 		async resolveId(id, importer, opts = { isEntry: false }) {
-			const normalizedId = id.replace(VIRTUAL_MODULE_PREFIX_REGEX, "");
-			const normalizedImporter = importer ? importer.replace(VIRTUAL_MODULE_PREFIX_REGEX, "") : void 0;
-			let result = await ctx.$$internal.callHook("resolveId", {
+			const normalizedId = removeVirtualPrefix(id);
+			const normalizedImporter = importer ? removeVirtualPrefix(importer) : void 0;
+			let result = await context.callHook("resolveId", {
 				sequential: true,
 				result: "first",
 				order: "pre"
@@ -31,9 +31,9 @@ function createUnpluginModuleResolutionFunctions(context, options = {}) {
 			if (isSetString(result)) return result;
 			else if (isSetObject(result)) return {
 				...result,
-				id: result.virtual && options.prefix !== false ? `${VIRTUAL_MODULE_PREFIX}${result.id}` : result.id
+				id: result.virtual && options.prefix !== false ? addVirtualPrefix(result.id) : result.id
 			};
-			result = await ctx.$$internal.callHook("resolveId", {
+			result = await context.callHook("resolveId", {
 				sequential: true,
 				result: "first",
 				order: "normal"
@@ -41,17 +41,17 @@ function createUnpluginModuleResolutionFunctions(context, options = {}) {
 			if (isSetString(result)) return result;
 			else if (isSetObject(result)) return {
 				...result,
-				id: result.virtual && options.prefix !== false ? `${VIRTUAL_MODULE_PREFIX}${result.id}` : result.id
+				id: result.virtual && options.prefix !== false ? addVirtualPrefix(result.id) : result.id
 			};
-			result = await ctx.resolve(normalizedId, normalizedImporter, defu(options.overrides ?? {}, {
+			result = await context.resolve(normalizedId, normalizedImporter, defu(options.overrides ?? {}, {
 				isFile: true,
 				...opts
 			}));
 			if (isSetObject(result)) return {
 				...result,
-				id: result.virtual && options.prefix !== false ? `${VIRTUAL_MODULE_PREFIX}${result.id}` : result.id
+				id: result.virtual && options.prefix !== false ? addVirtualPrefix(result.id) : result.id
 			};
-			result = await ctx.$$internal.callHook("resolveId", {
+			result = await context.callHook("resolveId", {
 				sequential: true,
 				result: "first",
 				order: "post"
@@ -59,29 +59,29 @@ function createUnpluginModuleResolutionFunctions(context, options = {}) {
 			if (isSetString(result)) return result;
 			else if (isSetObject(result)) return {
 				...result,
-				id: result.virtual && options.prefix !== false ? `${VIRTUAL_MODULE_PREFIX}${result.id}` : result.id
+				id: result.virtual && options.prefix !== false ? addVirtualPrefix(result.id) : result.id
 			};
 			return null;
 		},
 		load: {
-			filter: options.prefix !== false ? { id: { include: [VIRTUAL_MODULE_PREFIX_REGEX] } } : void 0,
+			filter: options.prefix !== false ? { id: VIRTUAL_MODULE_PREFIX_REGEX } : void 0,
 			async handler(id) {
-				const normalizedId = id.replace(VIRTUAL_MODULE_PREFIX_REGEX, "");
-				let result = await ctx.$$internal.callHook("load", {
+				const normalizedId = removeVirtualPrefix(id);
+				let result = await context.callHook("load", {
 					sequential: true,
 					result: "first",
 					order: "pre"
 				}, normalizedId);
 				if (result) return result;
-				result = await ctx.$$internal.callHook("load", {
+				result = await context.callHook("load", {
 					sequential: true,
 					result: "first",
 					order: "normal"
 				}, normalizedId);
 				if (result) return result;
-				result = await ctx.load(normalizedId);
+				result = await context.load(normalizedId);
 				if (result) return result;
-				return ctx.$$internal.callHook("load", {
+				return context.callHook("load", {
 					sequential: true,
 					result: "first",
 					order: "post"

package/dist/lib/unplugin/module-resolution.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"module-resolution.mjs","names":[],"sources":["../../../src/lib/unplugin/module-resolution.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport defu from \"defu\";\nimport { LoadResult } from \"rollup\";\nimport type {\n  UnpluginBuildContext,\n  UnpluginContext,\n  UnpluginOptions\n} from \"unplugin\";\nimport {\n  VIRTUAL_MODULE_PREFIX,\n  VIRTUAL_MODULE_PREFIX_REGEX\n} from \"../../constants/virtual-modules\";\nimport { Unstable_PluginContext } from \"../../types/_internal\";\nimport { PluginContext, ResolveResult } from \"../../types/context\";\nimport { ResolveOptions } from \"../../types/fs\";\n\nexport interface CreateUnpluginModuleResolutionFunctionsOptions {\n  /**\n   * An indicator of whether to prefix virtual module IDs with a specific string. This is useful for ensuring that virtual modules are only processed by the plugin and not by other plugins or the bundler itself.\n   *\n   * @remarks\n   * - If set to `true`, virtual module IDs will be prefixed with the string `__powerlines-virtual:`.\n   * - If set to `false`, no prefix will be added to virtual module IDs.\n   *\n   * @defaultValue true\n   */\n  prefix?: boolean;\n\n  /**\n   * Optional overrides for the module resolution configuration.\n   *\n   * @remarks\n   * This allows you to customize the behavior of the module resolution hooks by providing specific configuration options.\n   */\n  overrides?: Partial<ResolveOptions>;\n}\n\n/**\n * Creates the module resolution hook functions for a Powerlines unplugin plugin instance.\n *\n * @remarks\n * This includes the `resolveId` and `load` hooks.\n *\n * @see https://rollupjs.org/plugin-development/#resolveid\n * @see https://rollupjs.org/plugin-development/#load\n *\n * @param context - The plugin context.\n * @param options - Options for creating the module resolution functions.\n * @returns The module resolution hooks (`resolveId` and `load`).\n */\nexport function createUnpluginModuleResolutionFunctions<\n  TContext extends PluginContext = PluginContext\n>(\n  context: TContext,\n  options: CreateUnpluginModuleResolutionFunctionsOptions = {}\n): Pick<UnpluginOptions, \"resolveId\" | \"load\"> {\n  const ctx = context as unknown as Unstable_PluginContext;\n\n  return {\n    async resolveId(\n      this: UnpluginBuildContext & UnpluginContext,\n      id: string,\n      importer?: string,\n      opts: {\n        isEntry: boolean;\n      } = { isEntry: false }\n    ): Promise<string | ResolveResult | null | undefined> {\n      const normalizedId = id.replace(VIRTUAL_MODULE_PREFIX_REGEX, \"\");\n      const normalizedImporter = importer\n        ? importer.replace(VIRTUAL_MODULE_PREFIX_REGEX, \"\")\n        : undefined;\n\n      let result = await ctx.$$internal.callHook(\n        \"resolveId\",\n        {\n          sequential: true,\n          result: \"first\",\n          order: \"pre\"\n        },\n        normalizedId,\n        normalizedImporter,\n        opts\n      );\n      if (isSetString(result)) {\n        return result;\n      } else if (isSetObject(result)) {\n        return {\n          ...result,\n          id:\n            result.virtual && options.prefix !== false\n              ? `${VIRTUAL_MODULE_PREFIX}${result.id}`\n              : result.id\n        };\n      }\n\n      result = await ctx.$$internal.callHook(\n        \"resolveId\",\n        {\n          sequential: true,\n          result: \"first\",\n          order: \"normal\"\n        },\n        normalizedId,\n        normalizedImporter,\n        opts\n      );\n      if (isSetString(result)) {\n        return result;\n      } else if (isSetObject(result)) {\n        return {\n          ...result,\n          id:\n            result.virtual && options.prefix !== false\n              ? `${VIRTUAL_MODULE_PREFIX}${result.id}`\n              : result.id\n        };\n      }\n\n      result = await ctx.resolve(\n        normalizedId,\n        normalizedImporter,\n        defu(options.overrides ?? {}, {\n          isFile: true,\n          ...opts\n        })\n      );\n      if (isSetObject(result)) {\n        return {\n          ...result,\n          id:\n            result.virtual && options.prefix !== false\n              ? `${VIRTUAL_MODULE_PREFIX}${result.id}`\n              : result.id\n        };\n      }\n\n      result = await ctx.$$internal.callHook(\n        \"resolveId\",\n        {\n          sequential: true,\n          result: \"first\",\n          order: \"post\"\n        },\n        normalizedId,\n        normalizedImporter,\n        opts\n      );\n      if (isSetString(result)) {\n        return result;\n      } else if (isSetObject(result)) {\n        return {\n          ...result,\n          id:\n            result.virtual && options.prefix !== false\n              ? `${VIRTUAL_MODULE_PREFIX}${result.id}`\n              : result.id\n        };\n      }\n\n      return null;\n    },\n    load: {\n      filter:\n        options.prefix !== false\n          ? {\n              id: {\n                include: [VIRTUAL_MODULE_PREFIX_REGEX]\n              }\n            }\n          : undefined,\n      async handler(\n        this: UnpluginBuildContext & UnpluginContext,\n        id: string\n      ): Promise<LoadResult | null | undefined> {\n        const normalizedId = id.replace(VIRTUAL_MODULE_PREFIX_REGEX, \"\");\n\n        let result = await ctx.$$internal.callHook(\n          \"load\",\n          {\n            sequential: true,\n            result: \"first\",\n            order: \"pre\"\n          },\n          normalizedId\n        );\n        if (result) {\n          return result;\n        }\n\n        result = await ctx.$$internal.callHook(\n          \"load\",\n          {\n            sequential: true,\n            result: \"first\",\n            order: \"normal\"\n          },\n          normalizedId\n        );\n        if (result) {\n          return result;\n        }\n\n        result = await ctx.load(normalizedId);\n        if (result) {\n          return result;\n        }\n\n        return ctx.$$internal.callHook(\n          \"load\",\n          {\n            sequential: true,\n            result: \"first\",\n            order: \"post\"\n          },\n          normalizedId\n        );\n      }\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqEA,SAAgB,wCAGd,SACA,UAA0D,EAAE,EACf;CAC7C,MAAM,MAAM;AAEZ,QAAO;EACL,MAAM,UAEJ,IACA,UACA,OAEI,EAAE,SAAS,OAAO,EAC8B;GACpD,MAAM,eAAe,GAAG,QAAQ,6BAA6B,GAAG;GAChE,MAAM,qBAAqB,WACvB,SAAS,QAAQ,6BAA6B,GAAG,GACjD;GAEJ,IAAI,SAAS,MAAM,IAAI,WAAW,SAChC,aACA;IACE,YAAY;IACZ,QAAQ;IACR,OAAO;IACR,EACD,cACA,oBACA,KACD;AACD,OAAI,YAAY,OAAO,CACrB,QAAO;YACE,YAAY,OAAO,CAC5B,QAAO;IACL,GAAG;IACH,IACE,OAAO,WAAW,QAAQ,WAAW,QACjC,GAAG,wBAAwB,OAAO,OAClC,OAAO;IACd;AAGH,YAAS,MAAM,IAAI,WAAW,SAC5B,aACA;IACE,YAAY;IACZ,QAAQ;IACR,OAAO;IACR,EACD,cACA,oBACA,KACD;AACD,OAAI,YAAY,OAAO,CACrB,QAAO;YACE,YAAY,OAAO,CAC5B,QAAO;IACL,GAAG;IACH,IACE,OAAO,WAAW,QAAQ,WAAW,QACjC,GAAG,wBAAwB,OAAO,OAClC,OAAO;IACd;AAGH,YAAS,MAAM,IAAI,QACjB,cACA,oBACA,KAAK,QAAQ,aAAa,EAAE,EAAE;IAC5B,QAAQ;IACR,GAAG;IACJ,CAAC,CACH;AACD,OAAI,YAAY,OAAO,CACrB,QAAO;IACL,GAAG;IACH,IACE,OAAO,WAAW,QAAQ,WAAW,QACjC,GAAG,wBAAwB,OAAO,OAClC,OAAO;IACd;AAGH,YAAS,MAAM,IAAI,WAAW,SAC5B,aACA;IACE,YAAY;IACZ,QAAQ;IACR,OAAO;IACR,EACD,cACA,oBACA,KACD;AACD,OAAI,YAAY,OAAO,CACrB,QAAO;YACE,YAAY,OAAO,CAC5B,QAAO;IACL,GAAG;IACH,IACE,OAAO,WAAW,QAAQ,WAAW,QACjC,GAAG,wBAAwB,OAAO,OAClC,OAAO;IACd;AAGH,UAAO;;EAET,MAAM;GACJ,QACE,QAAQ,WAAW,QACf,EACE,IAAI,EACF,SAAS,CAAC,4BAA4B,EACvC,EACF,GACD;GACN,MAAM,QAEJ,IACwC;IACxC,MAAM,eAAe,GAAG,QAAQ,6BAA6B,GAAG;IAEhE,IAAI,SAAS,MAAM,IAAI,WAAW,SAChC,QACA;KACE,YAAY;KACZ,QAAQ;KACR,OAAO;KACR,EACD,aACD;AACD,QAAI,OACF,QAAO;AAGT,aAAS,MAAM,IAAI,WAAW,SAC5B,QACA;KACE,YAAY;KACZ,QAAQ;KACR,OAAO;KACR,EACD,aACD;AACD,QAAI,OACF,QAAO;AAGT,aAAS,MAAM,IAAI,KAAK,aAAa;AACrC,QAAI,OACF,QAAO;AAGT,WAAO,IAAI,WAAW,SACpB,QACA;KACE,YAAY;KACZ,QAAQ;KACR,OAAO;KACR,EACD,aACD;;GAEJ;EACF"}
+{"version":3,"file":"module-resolution.mjs","names":[],"sources":["../../../src/lib/unplugin/module-resolution.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport defu from \"defu\";\nimport { LoadResult } from \"rollup\";\nimport type {\n  UnpluginBuildContext,\n  UnpluginContext,\n  UnpluginOptions\n} from \"unplugin\";\nimport {\n  addVirtualPrefix,\n  removeVirtualPrefix,\n  VIRTUAL_MODULE_PREFIX_REGEX\n} from \"../../plugin-utils\";\nimport { ResolveResult, UnresolvedContext } from \"../../types/context\";\nimport { ResolveOptions } from \"../../types/fs\";\n\nexport interface CreateUnpluginModuleResolutionFunctionsOptions {\n  /**\n   * An indicator of whether to prefix virtual module IDs with a specific string. This is useful for ensuring that virtual modules are only processed by the plugin and not by other plugins or the bundler itself.\n   *\n   * @remarks\n   * - If set to `true`, virtual module IDs will be prefixed with the string `__powerlines-virtual:`.\n   * - If set to `false`, no prefix will be added to virtual module IDs.\n   *\n   * @defaultValue true\n   */\n  prefix?: boolean;\n\n  /**\n   * Optional overrides for the module resolution configuration.\n   *\n   * @remarks\n   * This allows you to customize the behavior of the module resolution hooks by providing specific configuration options.\n   */\n  overrides?: Partial<ResolveOptions>;\n}\n\n/**\n * Creates the module resolution hook functions for a Powerlines unplugin plugin instance.\n *\n * @remarks\n * This includes the `resolveId` and `load` hooks.\n *\n * @see https://rollupjs.org/plugin-development/#resolveid\n * @see https://rollupjs.org/plugin-development/#load\n *\n * @param context - The plugin context.\n * @param options - Options for creating the module resolution functions.\n * @returns The module resolution hooks (`resolveId` and `load`).\n */\nexport function createUnpluginModuleResolutionFunctions<\n  TContext extends UnresolvedContext\n>(\n  context: TContext,\n  options: CreateUnpluginModuleResolutionFunctionsOptions = {}\n): Pick<UnpluginOptions, \"resolveId\" | \"load\"> {\n  return {\n    async resolveId(\n      this: UnpluginBuildContext & UnpluginContext,\n      id: string,\n      importer?: string,\n      opts: {\n        isEntry: boolean;\n      } = { isEntry: false }\n    ): Promise<string | ResolveResult | null | undefined> {\n      const normalizedId = removeVirtualPrefix(id);\n      const normalizedImporter = importer\n        ? removeVirtualPrefix(importer)\n        : undefined;\n\n      let result = await context.callHook(\n        \"resolveId\",\n        {\n          sequential: true,\n          result: \"first\",\n          order: \"pre\"\n        },\n        normalizedId,\n        normalizedImporter,\n        opts\n      );\n      if (isSetString(result)) {\n        return result;\n      } else if (isSetObject(result)) {\n        return {\n          ...result,\n          id:\n            result.virtual && options.prefix !== false\n              ? addVirtualPrefix(result.id)\n              : result.id\n        };\n      }\n\n      result = await context.callHook(\n        \"resolveId\",\n        {\n          sequential: true,\n          result: \"first\",\n          order: \"normal\"\n        },\n        normalizedId,\n        normalizedImporter,\n        opts\n      );\n      if (isSetString(result)) {\n        return result;\n      } else if (isSetObject(result)) {\n        return {\n          ...result,\n          id:\n            result.virtual && options.prefix !== false\n              ? addVirtualPrefix(result.id)\n              : result.id\n        };\n      }\n\n      result = await context.resolve(\n        normalizedId,\n        normalizedImporter,\n        defu(options.overrides ?? {}, {\n          isFile: true,\n          ...opts\n        })\n      );\n      if (isSetObject(result)) {\n        return {\n          ...result,\n          id:\n            result.virtual && options.prefix !== false\n              ? addVirtualPrefix(result.id)\n              : result.id\n        };\n      }\n\n      result = await context.callHook(\n        \"resolveId\",\n        {\n          sequential: true,\n          result: \"first\",\n          order: \"post\"\n        },\n        normalizedId,\n        normalizedImporter,\n        opts\n      );\n      if (isSetString(result)) {\n        return result;\n      } else if (isSetObject(result)) {\n        return {\n          ...result,\n          id:\n            result.virtual && options.prefix !== false\n              ? addVirtualPrefix(result.id)\n              : result.id\n        };\n      }\n\n      return null;\n    },\n    load: {\n      filter:\n        options.prefix !== false\n          ? {\n              id: VIRTUAL_MODULE_PREFIX_REGEX\n            }\n          : undefined,\n      async handler(\n        this: UnpluginBuildContext & UnpluginContext,\n        id: string\n      ): Promise<LoadResult | null | undefined> {\n        const normalizedId = removeVirtualPrefix(id);\n\n        let result = await context.callHook(\n          \"load\",\n          {\n            sequential: true,\n            result: \"first\",\n            order: \"pre\"\n          },\n          normalizedId\n        );\n        if (result) {\n          return result;\n        }\n\n        result = await context.callHook(\n          \"load\",\n          {\n            sequential: true,\n            result: \"first\",\n            order: \"normal\"\n          },\n          normalizedId\n        );\n        if (result) {\n          return result;\n        }\n\n        result = await context.load(normalizedId);\n        if (result) {\n          return result;\n        }\n\n        return context.callHook(\n          \"load\",\n          {\n            sequential: true,\n            result: \"first\",\n            order: \"post\"\n          },\n          normalizedId\n        );\n      }\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAqEA,SAAgB,wCAGd,SACA,UAA0D,EAAE,EACf;AAC7C,QAAO;EACL,MAAM,UAEJ,IACA,UACA,OAEI,EAAE,SAAS,OAAO,EAC8B;GACpD,MAAM,eAAe,oBAAoB,GAAG;GAC5C,MAAM,qBAAqB,WACvB,oBAAoB,SAAS,GAC7B;GAEJ,IAAI,SAAS,MAAM,QAAQ,SACzB,aACA;IACE,YAAY;IACZ,QAAQ;IACR,OAAO;IACR,EACD,cACA,oBACA,KACD;AACD,OAAI,YAAY,OAAO,CACrB,QAAO;YACE,YAAY,OAAO,CAC5B,QAAO;IACL,GAAG;IACH,IACE,OAAO,WAAW,QAAQ,WAAW,QACjC,iBAAiB,OAAO,GAAG,GAC3B,OAAO;IACd;AAGH,YAAS,MAAM,QAAQ,SACrB,aACA;IACE,YAAY;IACZ,QAAQ;IACR,OAAO;IACR,EACD,cACA,oBACA,KACD;AACD,OAAI,YAAY,OAAO,CACrB,QAAO;YACE,YAAY,OAAO,CAC5B,QAAO;IACL,GAAG;IACH,IACE,OAAO,WAAW,QAAQ,WAAW,QACjC,iBAAiB,OAAO,GAAG,GAC3B,OAAO;IACd;AAGH,YAAS,MAAM,QAAQ,QACrB,cACA,oBACA,KAAK,QAAQ,aAAa,EAAE,EAAE;IAC5B,QAAQ;IACR,GAAG;IACJ,CAAC,CACH;AACD,OAAI,YAAY,OAAO,CACrB,QAAO;IACL,GAAG;IACH,IACE,OAAO,WAAW,QAAQ,WAAW,QACjC,iBAAiB,OAAO,GAAG,GAC3B,OAAO;IACd;AAGH,YAAS,MAAM,QAAQ,SACrB,aACA;IACE,YAAY;IACZ,QAAQ;IACR,OAAO;IACR,EACD,cACA,oBACA,KACD;AACD,OAAI,YAAY,OAAO,CACrB,QAAO;YACE,YAAY,OAAO,CAC5B,QAAO;IACL,GAAG;IACH,IACE,OAAO,WAAW,QAAQ,WAAW,QACjC,iBAAiB,OAAO,GAAG,GAC3B,OAAO;IACd;AAGH,UAAO;;EAET,MAAM;GACJ,QACE,QAAQ,WAAW,QACf,EACE,IAAI,6BACL,GACD;GACN,MAAM,QAEJ,IACwC;IACxC,MAAM,eAAe,oBAAoB,GAAG;IAE5C,IAAI,SAAS,MAAM,QAAQ,SACzB,QACA;KACE,YAAY;KACZ,QAAQ;KACR,OAAO;KACR,EACD,aACD;AACD,QAAI,OACF,QAAO;AAGT,aAAS,MAAM,QAAQ,SACrB,QACA;KACE,YAAY;KACZ,QAAQ;KACR,OAAO;KACR,EACD,aACD;AACD,QAAI,OACF,QAAO;AAGT,aAAS,MAAM,QAAQ,KAAK,aAAa;AACzC,QAAI,OACF,QAAO;AAGT,WAAO,QAAQ,SACb,QACA;KACE,YAAY;KACZ,QAAQ;KACR,OAAO;KACR,EACD,aACD;;GAEJ;EACF"}