马宇豪
2024-07-16 f591c27b57e2418c9495bc02ae8cfff84d35bc18
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
/*
    MIT License http://www.opensource.org/licenses/mit-license.php
    Author Tobias Koppers @sokra
*/
 
"use strict";
 
const DescriptionFileUtils = require("./DescriptionFileUtils");
 
/** @typedef {import("./Resolver")} Resolver */
/** @typedef {import("./Resolver").ResolveRequest} ResolveRequest */
/** @typedef {import("./Resolver").ResolveStepHook} ResolveStepHook */
 
module.exports = class DescriptionFilePlugin {
    /**
     * @param {string | ResolveStepHook} source source
     * @param {string[]} filenames filenames
     * @param {boolean} pathIsFile pathIsFile
     * @param {string | ResolveStepHook} target target
     */
    constructor(source, filenames, pathIsFile, target) {
        this.source = source;
        this.filenames = filenames;
        this.pathIsFile = pathIsFile;
        this.target = target;
    }
 
    /**
     * @param {Resolver} resolver the resolver
     * @returns {void}
     */
    apply(resolver) {
        const target = resolver.ensureHook(this.target);
        resolver
            .getHook(this.source)
            .tapAsync(
                "DescriptionFilePlugin",
                (request, resolveContext, callback) => {
                    const path = request.path;
                    if (!path) return callback();
                    const directory = this.pathIsFile
                        ? DescriptionFileUtils.cdUp(path)
                        : path;
                    if (!directory) return callback();
                    DescriptionFileUtils.loadDescriptionFile(
                        resolver,
                        directory,
                        this.filenames,
                        request.descriptionFilePath
                            ? {
                                    path: request.descriptionFilePath,
                                    content: request.descriptionFileData,
                                    directory: /** @type {string} */ (request.descriptionFileRoot)
                              }
                            : undefined,
                        resolveContext,
                        (err, result) => {
                            if (err) return callback(err);
                            if (!result) {
                                if (resolveContext.log)
                                    resolveContext.log(
                                        `No description file found in ${directory} or above`
                                    );
                                return callback();
                            }
                            const relativePath =
                                "." + path.slice(result.directory.length).replace(/\\/g, "/");
                            /** @type {ResolveRequest} */
                            const obj = {
                                ...request,
                                descriptionFilePath: result.path,
                                descriptionFileData: result.content,
                                descriptionFileRoot: result.directory,
                                relativePath: relativePath
                            };
                            resolver.doResolve(
                                target,
                                obj,
                                "using description file: " +
                                    result.path +
                                    " (relative path: " +
                                    relativePath +
                                    ")",
                                resolveContext,
                                (err, result) => {
                                    if (err) return callback(err);
 
                                    // Don't allow other processing
                                    if (result === undefined) return callback(null, null);
                                    callback(null, result);
                                }
                            );
                        }
                    );
                }
            );
    }
};