Function getSassOptions

src/utils.js:184–330

* Derives the sass options from the loader context and normalizes its values with sane defaults. * @param {LoaderContext} loaderContext loader context * @param {LoaderOptions} loaderOptions loader options * @param {string} content content * @param {boolean} useSourceMap true when need to generat

(
  loaderContext,
  loaderOptions,
  content,
  useSourceMap,
)

 * @returns {Promise<Required<KnownSassOptions> & { data: string }>} sass options
 */
async function getSassOptions(
  loaderContext,
  loaderOptions,
  content,
  useSourceMap,
) {
  /** @type {SassOptions} */
  const options = loaderOptions.sassOptions
    ? typeof loaderOptions.sassOptions === "function"
      ? loaderOptions.sassOptions(loaderContext) || {}
      : loaderOptions.sassOptions
    : {};
  /** @type {KnownSassOptions & { data: string }} */
  const sassOptions = {
    ...options,
    data: loaderOptions.additionalData
      ? typeof loaderOptions.additionalData === "function"
        ? await loaderOptions.additionalData(content, loaderContext)
        : `${loaderOptions.additionalData}\n${content}`
      : content,
  };

  if (!sassOptions.logger) {
    const needEmitWarning = loaderOptions.warnRuleAsWarning !== false;
    const logger = loaderContext.getLogger("sass-loader");
    /**
     * @param {SourceSpan} span span
     * @returns {string} formatted span
     */
    const formatSpan = (span) =>
      `Warning on line ${span.start.line}, column ${span.start.column} of ${
        span.url || "-"
      }:${span.start.line}:${span.start.column}:\n`;
    /**
     * @param {SourceSpan} span span
     * @returns {string} formatted debug span
     */
    const formatDebugSpan = (span) =>
      `[debug:${span.start.line}:${span.start.column}] `;

    sassOptions.logger = {
      /**
       * @param {string} message message
       * @param {{ span: SourceSpan }} loggerOptions logger options
       * @returns {void}
       */
      debug(message, loggerOptions) {
        let builtMessage = "";

        if (loggerOptions.span) {
          builtMessage = formatDebugSpan(loggerOptions.span);
        }

        builtMessage += message;

        logger.debug(builtMessage);
      },
      /**