Function loadPlugin

@commitlint/load/src/utils/load-plugin.ts:51–186

(
	plugins: PluginRecords,
	pluginName: string,
	options: LoadPluginOptions | boolean = {},
)

}

export default async function loadPlugin(
	plugins: PluginRecords,
	pluginName: string,
	options: LoadPluginOptions | boolean = {},
): Promise<PluginRecords> {
	const normalized = normalizeOptions(options);
	const { debug = false, searchPaths = [] } = normalized;

	for (const searchPath of searchPaths) {
		if (typeof searchPath !== "string" || !path.isAbsolute(searchPath)) {
			throw new Error(`Invalid searchPath "${searchPath}": must be an absolute path`);
		}
		if (!fs.existsSync(searchPath)) {
			throw new Error(`Invalid searchPath "${searchPath}": directory does not exist`);
		}
		if (!fs.statSync(searchPath).isDirectory()) {
			throw new Error(`Invalid searchPath "${searchPath}": must be a directory, not a file`);
		}
	}

	const longName = normalizePackageName(pluginName);
	const shortName = getShorthandName(longName);

	if (pluginName.match(/\s+/u)) {
		throw new WhitespacePluginError(pluginName, {
			pluginName: longName,
		});
	}

	const pluginKey = longName === pluginName ? shortName : pluginName;

	if (!plugins[pluginKey]) {
		let plugin: Plugin | undefined;
		let resolvedPath: string | undefined;

		// Try to load from npx cache directories using require.resolve
		const npxResolvedPath = resolveFromNpxCache(longName);
		if (npxResolvedPath) {
			try {
				plugin = await dynamicImport<Plugin>(npxResolvedPath);
				resolvedPath = npxResolvedPath;
			} catch (err) {
				if (debug) {
					console.debug(
						`Failed to load plugin ${longName} from npx cache: ${(err as Error).message}`,
					);
				}
			}
		}

		// Try to load from additional search paths (extended config's node_modules)
		if (!plugin) {
			for (const searchPath of searchPaths) {
				try {
					resolvedPath = require.resolve(longName, { paths: [searchPath] });
					plugin = await dynamicImport<Plugin>(resolvedPath);
					break;
				} catch (err) {