/** * Initialises the statics root from the directory of the package entry point. * Must be called before any test fixture helpers are invoked. * * The package entry points (index.ts for ESM, index.cts for CJS) call this * with their own `path.dirname(fileURLToPath(import.meta.url))` or `__dirname` * respectively, so this module contains no module-system-specific syntax and * compiles correctly under both `module: NodeNext` and `module: CommonJS`. * * Design note — eager-init vs lazy resolution: * An alternative would be to resolve the statics path lazily inside * getStaticFilePath() on first call (eliminating _initStaticsRoot and the * entry-point coupling entirely). Eager-init was chosen instead because lazy * resolution cannot safely use import.meta.url in a CommonJS build, and * __dirname is not available in an ESM build. The entry-point side-effect * approach lets this module stay free of module-system-specific syntax while * still capturing the correct anchor directory at load time. * @internal */ export declare function _initStaticsRoot(dir: string): void; /** * Resolve a path relative to the test-utils statics directory. * @param paths - Path segments to join after the statics root. * @returns The absolute path to the static fixture. */ export declare function getStaticFilePath(...paths: string[]): string;