docs: document plugin metadata utilities

This commit is contained in:
Peter Steinberger
2026-06-04 04:57:24 -04:00
parent 72bb5cd692
commit f4d2748ca5
20 changed files with 30 additions and 0 deletions

View File

@@ -1,3 +1,4 @@
/** Caches plugin module loaders and native-load stats for runtime/source module imports. */
import { createRequire } from "node:module";
import path from "node:path";
import { pathToFileURL } from "node:url";
@@ -13,6 +14,7 @@ import {
type PluginSdkResolutionPreference,
} from "./sdk-alias.js";
/** Jiti-based module loader used for plugin source/runtime imports. */
export type PluginModuleLoader = ReturnType<typeof createJiti>;
export type PluginModuleLoaderFactory = typeof createJiti;
export type PluginModuleLoaderCache = Pick<
@@ -80,6 +82,7 @@ function recordSourceTransformTarget(target: string): void {
}
}
/** Returns process-local plugin module loader stats for diagnostics and tests. */
export function getPluginModuleLoaderStats(): PluginModuleLoaderStatsSnapshot {
return {
calls: pluginModuleLoaderStats.calls,