Function loadConfiguration

snowpack/src/config.ts:789–872

(
  overrides: SnowpackUserConfig = {},
  configPath?: string,
)

}

export async function loadConfiguration(
  overrides: SnowpackUserConfig = {},
  configPath?: string,
): Promise<SnowpackConfig> {
  let result: Awaited<ReturnType<typeof loadConfigurationFile>> = null;
  // if user specified --config path, load that
  if (configPath) {
    result = await loadConfigurationFile(configPath, overrides);
    if (!result) {
      throw new Error(`Snowpack config file could not be found: ${configPath}`);
    }
  }

  const configs = [
    'snowpack.config.mjs',
    'snowpack.config.cjs',
    'snowpack.config.js',
    'snowpack.config.json',
  ];

  // If no config was found above, search for one.
  if (!result) {
    for (const potentialConfigurationFile of configs) {
      if (result) break;
      result = await loadConfigurationFile(potentialConfigurationFile, overrides);
    }
  }

  // Support package.json "snowpack" config
  if (!result) {
    const potentialPackageJsonConfig = await loadConfigurationFile('package.json', overrides);
    if (potentialPackageJsonConfig && (potentialPackageJsonConfig.config as any).snowpack) {
      result = {
        filepath: potentialPackageJsonConfig.filepath,
        config: (potentialPackageJsonConfig.config as any).snowpack,
      };
    }
  }

  if (!result) {
    logger.warn('Hint: run "snowpack init" to create a project config file. Using defaults...');
    result = {filepath: undefined, config: {}};
  }

  const {config, filepath} = result;
  const configBase = getConfigBasePath(filepath, config.root);
  valdiateDeprecatedConfig(config);
  valdiateDeprecatedConfig(overrides);
  resolveRelativeConfig(config, configBase);

  let extendConfig: SnowpackUserConfig = {} as SnowpackUserConfig;
  if (config.extends) {
    const extendConfigLoc = require.resolve(config.extends, {paths: [configBase]});
    const extendResult = await loadConfigurationFile(extendConfigLoc, {});
    if (!extendResult) {
      handleConfigError(`Could not locate "extends" config at ${extendConfigLoc}`);
      process.exit(1);
    }