cosmiconfig.node.txt

                                  ┏━━━━━━━━━━━━━━━━━┓
                                  ┃   COSMICONFIG   ┃
                                  ┗━━━━━━━━━━━━━━━━━┛

ALTERNATIVES ==>                  #  - rc:
                                  #     - supports JSON|INI files
                                  #     - looks in --OPT, ENVVAR, --config, .NAMErc, $HOME/.config/NAME, /etc/NAMErc
                                  #     - merge between each found
                                  #     - sync
                                  #  - cosmiconfig (prefered except if need ENVVAR support):
                                  #     - supports JavaScript|JSON|YAML files
                                  #     - looks in --config, package.json, .NAMErc, NAME.config.js
                                  #     - stops at first found
                                  #     - a little more maintained
                                  #     - async

VERSION ==>                       #2.2.2

COSMICONFIG('NAME'[, OPTS])->EXPL #Finds config CONF:
EXPL.load(DIR or null, ARG_FILE)  #  - among, in order:
 ->PROMISE_CCONF                  #     - ARG_FILE
                                  #     - OPTS.configPath JSON|YAML|JS_FILE
                                  #     - --config JSON|YAML|JS_FILE
                                  #     - ./[../.../]package.json NAME CONF
                                  #     - ./[../.../].NAMErc JSON|YAML_FILE
                                  #     - ./[../.../].NAMErc.json|y[a]ml|js JSON|YAML|JS_FILE
                                  #     - ./[../.../]NAME.config.js JS_FILE
                                  #  - ../... stops at $HOME
                                  #  - can specify DIR instead of $PWD
                                  #  - uses the first file found only
                                  #Result:
                                  #  - CCONF is { config CONF, filepath STR }
                                  #  - returns PROMISE_null if nothing is found.
                                  #  - reject PROMISE if CONF is malformed.
                                  #OPTS:
                                  #  - argv|packageProp|rc|js STR|BOOL:
                                  #     - change the NAME searched in --config, package.json, .NAMErc[*] or NAME.config.js
                                  #     - BOOL false disables
                                  #  - rcExtensions BOOL (def: false): enables .NAMErc.json|y[a]ml|js
                                  #  - stopDir STR: used instead of $HOME
                                  #  - sync BOOL (def: false)
                                  #  - cache BOOL (def: true):
                                  #     - each EXPL has its own cache
                                  #     - can also manipulate it with EXPL.clearCaches|FileCache|DirectoryCache()
                                  #       (for ARG_FILE, DIR or both)
                                  #  - rcStrictJson BOOL (def: false): use JSON.parse() instead of js-yaml,
                                  #    i.e. no YAML allowed, and JSON is less permissive
                                  #  - transform(CCONF)->PROMISE_CONF:
                                  #     - applied to final CONF
                                  #     - reason to use this instead of just modifying return value is to use cosmiconfig
                                  #       caching
                                  #YAML uses js-yaml with DEFAULT_SAFE_SCHEMA