tryno10/app/code/node_modules/laravel-mix/src/components/Preprocessor.js

const Assert = require('../Assert');
const path = require('path');
const File = require('../File');
const CssWebpackConfig = require('./CssWebpackConfig');
const PostCssPluginsFactory = require('../PostCssPluginsFactory');
const Entry = require('../builder/Entry');

/**
 * @typedef {object} Detail
 * @property {string} type
 * @property {File} src
 * @property {File} output
 * @property {any} pluginOptions
 * @property {any[]} postCssPlugins
 * @property {boolean} [processUrls]
 */

const { Component } = require('./Component');

module.exports = class Preprocessor extends Component {
    /** @type {Detail[]} */
    details = [];

    /**
     * Assets to append to the webpack entry.
     *
     * @param {Entry} entry
     */
    webpackEntry(entry) {
        this.details.forEach(detail => {
            entry.add(entry.keys()[0], detail.src.path());
        });
    }

    /**
     * webpack rules to be appended to the master config.
     */
    webpackRules() {
        return this.details.map(preprocessor => ({
            test: preprocessor.src.path(),
            use: this.webpackLoaders(preprocessor)
        }));
    }

    /**
     * Fetch all necessary webpack loaders.
     *
     * @param {Detail} preprocessor
     */
    webpackLoaders(preprocessor) {
        let processUrls = this.shouldProcessUrls(preprocessor);

        /** @type {import('webpack').RuleSetRule[]} */
        let loaders = [
            ...CssWebpackConfig.afterLoaders({
                context: this.context,
                method: 'extract',
                location: 'per-file'
            }),
            {
                loader: this.context.resolve('css-loader'),
                options: {
                    /**
                     *
                     * @param {string} url
                     */
                    url: url => {
                        if (url.startsWith('/')) {
                            return false;
                        }

                        return processUrls;
                    },
                    sourceMap: this.context.isUsing('sourcemaps'),
                    importLoaders: 1
                }
            },
            {
                loader: this.context.resolve('postcss-loader'),
                options: this.postCssLoaderOptions(preprocessor)
            }
        ];

        if (preprocessor.type === 'sass' && processUrls) {
            loaders.push({
                loader: this.context.resolve('resolve-url-loader'),
                options: {
                    sourceMap: true
                }
            });
        }

        if (preprocessor.type !== 'postCss') {
            loaders.push({
                loader: `${preprocessor.type}-loader`,
                options: this.loaderOptions(preprocessor, processUrls)
            });
        }

        loaders.push(
            ...CssWebpackConfig.beforeLoaders({
                context: this.context,
                type: preprocessor.type,
                injectGlobalStyles: false
            })
        );

        return loaders;
    }

    /**
     * Prepare the preprocessor plugin options.
     *
     * @param {Detail} preprocessor
     * @param {Boolean} processUrls
     */
    loaderOptions(preprocessor, processUrls) {
        return Object.assign(preprocessor.pluginOptions, {
            sourceMap:
                preprocessor.type === 'sass' && processUrls
                    ? true
                    : this.context.isUsing('sourcemaps')
        });
    }

    /**
     * Generate the options object for the PostCSS Loader.
     *
     * @param {Detail} preprocessor
     */
    postCssLoaderOptions(preprocessor) {
        return {
            sourceMap: this.context.isUsing('sourcemaps'),
            postcssOptions: {
                plugins: new PostCssPluginsFactory(this.context).load(
                    preprocessor.postCssPlugins
                ),
                hideNothingWarning: true
            }
        };
    }

    /**
     * Register a generic CSS preprocessor.
     *
     * @param {string} type
     * @param {string} src
     * @param {string} output
     * @param {object} pluginOptions
     * @param {import('postcss').AcceptedPlugin[]} postCssPlugins
     */
    preprocess(type, src, output, pluginOptions = {}, postCssPlugins = []) {
        Assert.preprocessor(type, src, output);

        const srcFile = new File(src);

        const outputFile = this.normalizeOutput(
            new File(output),
            srcFile.nameWithoutExtension() + '.css'
        );

        this.details.push({
            type: this.constructor.name.toLowerCase(),
            src: srcFile,
            output: outputFile,
            pluginOptions,
            postCssPlugins
        });

        this._addChunks(
            `styles-${outputFile.relativePathWithoutExtension()}`,
            srcFile,
            outputFile
        );

        return this;
    }

    /**
     * Determine whether to apply url preprocessing.
     *
     * @param {Detail} preprocessor
     * @returns {boolean}
     */
    shouldProcessUrls(preprocessor) {
        const processUrls =
            preprocessor.pluginOptions.processUrls !== undefined
                ? preprocessor.pluginOptions.processUrls
                : this.context.config.processCssUrls;

        delete preprocessor.pluginOptions.processUrls;

        return processUrls;
    }

    /**
     * Generate a full output path, using a fallback
     * file name, if a directory is provided.
     *
     * @param {File} output
     * @param {string} fallbackName
     */
    normalizeOutput(output, fallbackName) {
        if (output.isDirectory()) {
            output = new File(path.join(output.filePath, fallbackName));
        }

        return output;
    }

    chunkRegex() {
        return /\.p?css$/;
    }

    /**
     * Add the necessary chunks for this preprocessor
     *
     * This method is for internal use only for now.
     *
     * @internal
     *
     * @param {string} name
     * @param {File} src
     * @param {File} output
     */
    _addChunks(name, src, output) {
        const tests = [
            // 1. Ensure the file is a CSS file
            this.chunkRegex(),

            // 2. Ensure that just this file is included in this chunk
            // _or any dependencies_
            src.path()
        ];

        const attrs = {
            chunks: 'all',
            enforce: true,
            type: 'css/mini-extract'
        };

        this.context.chunks.add(name, output.normalizedOutputPath(), tests, attrs);
    }
};