Releases: cosmiconfig/cosmiconfig
Releases · cosmiconfig/cosmiconfig
v9.0.0
- Added
searchStrategy
option:- The
none
value means that cosmiconfig does not traverse any directories upwards.- Breaking change: This is the default value if you don't pass a
stopDir
option, which means that cosmiconfig no longer traverses directories by default, and instead just looks in the current working directory.- If you want to achieve maximum backwards compatibility without adding an explicit
stopDir
, add thesearchStrategy: 'global'
option.
- If you want to achieve maximum backwards compatibility without adding an explicit
- Breaking change: This is the default value if you don't pass a
- The
project
value means that cosmiconfig traverses upwards until it finds apackage.json
(or.yaml
) file. - The
global
value means that cosmiconfig traverses upwards until the passedstopDir
, or your home directory if nostopDir
is given.
- The
- Breaking change: Meta config files (i.e.
config.js
and similar) are not looked for in the current working directory anymore. Instead, it looks in the.config
subfolder. - Breaking change: When defining
searchPlaces
in a meta config file, the tool-definedsearchPlaces
are merged into this. Users may specifymergeSearchPlaces: false
to disable this. - Added support for a special
$import
key which will import another configuration file- The imported file will act as a base file - all properties from that file will be applied to the configuration, but can be overridden by the importing file
- For more information, read the import section of the README
- Added searching in OS conventional folders (XDG compatible on Linux, %APPDATA% on Windows, Library/Preferences on macOS) for
searchStrategy: 'global'
- Fixed crash when trying to load a file that is not readable due to file system permissions
- Fixed wrong ERR_REQUIRE_ESM error being thrown when there is an issue loading an ESM file