var pkgDeps = require( '@stdlib/_tools/modules/pkg-deps' );

Asynchronously lists package dependencies.

pkgDeps( __filename, clbk );

function clbk( error, results ) {
    if ( error ) {
        throw error;
    }
    console.dir( results );
}

The first argument may be either a file path string (either relative or absolute) or an array of file paths. If provided a relative file path, the path is resolved relative to the current working directory.

pkgDeps( [ __filename, __filename ], clbk );

function clbk( error, results ) {
    if ( error ) {
        throw error;
    }
    console.dir( results );
}

Each file is represented by an object having the following fields:

• file: file name.
• deps: an array of package dependencies.

The function accepts the following options:

• builtins: boolean indicating whether to include built-in package dependencies. Default: true.
• walk: boolean indicating whether to walk relative module dependencies. Default: true.
• aliases: object mapping relative module dependency identifiers to other module identifiers (e.g., mapping non-browser-compatible modules to browser-compatible modules). When a module identifier resolves to the same path as an object key, the associated object value is substituted for the original identifier, and the function walks the substituted module in place of the original module. Relative module identifiers are resolved relative to the provided file paths.

By default, the function walks relative module dependencies to resolve both primary and secondary package dependencies. To only resolve a file's direct package dependencies, set the walk option to false.

var opts = {
    'walk': false
};

pkgDeps( __filename, opts, clbk );

function clbk( error, results ) {
    if ( error ) {
        throw error;
    }
    console.dir( results );
}

Synchronously lists package dependencies.

var results = pkgDeps.sync( __filename );
// returns [...]

The function accepts the same options as pkgDeps() above.