Function getLessOptions

src/utils.js:300–356

* Get the `less` options from the loader context and normalizes its values * @param {LoaderContext} loaderContext loader context * @param {LoaderOptions} loaderOptions loader options * @param {Less} implementation implementation * @returns {{ lessOptions: LessOptions, pendingDependencyTasks: Pro

(loaderContext, loaderOptions, implementation)

 * @returns {{ lessOptions: LessOptions, pendingDependencyTasks: Promise<void>[] }} implementation and pending tasks
 */
function getLessOptions(loaderContext, loaderOptions, implementation) {
  const options =
    typeof loaderOptions.lessOptions === "function"
      ? loaderOptions.lessOptions(loaderContext) || {}
      : loaderOptions.lessOptions || {};

  /** @type {LessOptions} */
  const lessOptions = {
    // @ts-expect-error bad types
    relativeUrls: true,
    // We need to set the filename because otherwise our WebpackFileManager will receive an undefined path for the entry
    filename: loaderContext.resourcePath,
    ...options,
  };

  // Collects async dependency-resolution promises kicked off from
  // synchronous Less file loads (e.g. `data-uri()`, `@plugin`). The loader
  // awaits these before completing so webpack's dependency snapshot is
  // accurate.
  /** @type {Promise<void>[]} */
  const pendingDependencyTasks = [];

  /** @type {LessPlugin[]} */
  const plugins = [...(lessOptions.plugins || [])];
  const shouldUseWebpackImporter =
    typeof loaderOptions.webpackImporter === "boolean" ||
    loaderOptions.webpackImporter === "only"
      ? loaderOptions.webpackImporter
      : true;

  if (shouldUseWebpackImporter) {
    plugins.unshift(
      createWebpackLessPlugin(
        loaderContext,
        implementation,
        pendingDependencyTasks,
      ),
    );
  }

  plugins.unshift({
    /**
     * @param {Less} less less
     * @param {PluginManager} pluginManager plugin manager
     */
    install(less, pluginManager) {
      // @ts-expect-error to provide loader context into plugin
      pluginManager.webpackLoaderContext = loaderContext;
      // @ts-expect-error to reset it after execution
      lessOptions.pluginManager = pluginManager;
    },
  });

  lessOptions.plugins = plugins;

  return { lessOptions, pendingDependencyTasks };
}