You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
194 lines
5.2 KiB
194 lines
5.2 KiB
2 years ago
|
'use strict';
|
||
|
|
||
|
const path = require('path');
|
||
|
const { Transform } = require('stream');
|
||
|
const picocolors = require('picocolors');
|
||
|
const PluginError = require('plugin-error');
|
||
|
const replaceExtension = require('replace-ext');
|
||
|
const stripAnsi = require('strip-ansi');
|
||
|
const clonedeep = require('lodash.clonedeep');
|
||
|
const applySourceMap = require('vinyl-sourcemaps-apply');
|
||
|
|
||
|
const PLUGIN_NAME = 'gulp-sass';
|
||
|
|
||
|
const MISSING_COMPILER_MESSAGE = `
|
||
|
gulp-sass no longer has a default Sass compiler; please set one yourself.
|
||
|
Both the "sass" and "node-sass" packages are permitted.
|
||
|
For example, in your gulpfile:
|
||
|
|
||
|
const sass = require('gulp-sass')(require('sass'));
|
||
|
`;
|
||
|
|
||
|
const transfob = (transform) => new Transform({ transform, objectMode: true });
|
||
|
|
||
|
/**
|
||
|
* Handles returning the file to the stream
|
||
|
*/
|
||
|
const filePush = (file, sassObject, callback) => {
|
||
|
// Build Source Maps!
|
||
|
if (sassObject.map) {
|
||
|
// Transform map into JSON
|
||
|
const sassMap = JSON.parse(sassObject.map.toString());
|
||
|
// Grab the stdout and transform it into stdin
|
||
|
const sassMapFile = sassMap.file.replace(/^stdout$/, 'stdin');
|
||
|
// Grab the base filename that's being worked on
|
||
|
const sassFileSrc = file.relative;
|
||
|
// Grab the path portion of the file that's being worked on
|
||
|
const sassFileSrcPath = path.dirname(sassFileSrc);
|
||
|
|
||
|
if (sassFileSrcPath) {
|
||
|
const sourceFileIndex = sassMap.sources.indexOf(sassMapFile);
|
||
|
// Prepend the path to all files in the sources array except the file that's being worked on
|
||
|
sassMap.sources = sassMap.sources.map((source, index) => (
|
||
|
index === sourceFileIndex
|
||
|
? source
|
||
|
: path.join(sassFileSrcPath, source)
|
||
|
));
|
||
|
}
|
||
|
|
||
|
// Remove 'stdin' from souces and replace with filenames!
|
||
|
sassMap.sources = sassMap.sources.filter((src) => src !== 'stdin' && src);
|
||
|
|
||
|
// Replace the map file with the original filename (but new extension)
|
||
|
sassMap.file = replaceExtension(sassFileSrc, '.css');
|
||
|
// Apply the map
|
||
|
applySourceMap(file, sassMap);
|
||
|
}
|
||
|
|
||
|
file.contents = sassObject.css;
|
||
|
file.path = replaceExtension(file.path, '.css');
|
||
|
|
||
|
if (file.stat) {
|
||
|
file.stat.atime = file.stat.mtime = file.stat.ctime = new Date();
|
||
|
}
|
||
|
|
||
|
callback(null, file);
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* Handles error message
|
||
|
*/
|
||
|
const handleError = (error, file, callback) => {
|
||
|
const filePath = (error.file === 'stdin' ? file.path : error.file) || file.path;
|
||
|
const relativePath = path.relative(process.cwd(), filePath);
|
||
|
const message = `${picocolors.underline(relativePath)}\n${error.formatted}`;
|
||
|
|
||
|
error.messageFormatted = message;
|
||
|
error.messageOriginal = error.message;
|
||
|
error.message = stripAnsi(message);
|
||
|
error.relativePath = relativePath;
|
||
|
|
||
|
return callback(new PluginError(PLUGIN_NAME, error));
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* Main Gulp Sass function
|
||
|
*/
|
||
|
|
||
|
// eslint-disable-next-line arrow-body-style
|
||
|
const gulpSass = (options, sync) => {
|
||
|
return transfob((file, encoding, callback) => {
|
||
|
if (file.isNull()) {
|
||
|
callback(null, file);
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
if (file.isStream()) {
|
||
|
callback(new PluginError(PLUGIN_NAME, 'Streaming not supported'));
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
if (path.basename(file.path).startsWith('_')) {
|
||
|
callback();
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
if (!file.contents.length) {
|
||
|
file.path = replaceExtension(file.path, '.css');
|
||
|
callback(null, file);
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
const opts = clonedeep(options || {});
|
||
|
opts.data = file.contents.toString();
|
||
|
|
||
|
// We set the file path here so that libsass can correctly resolve import paths
|
||
|
opts.file = file.path;
|
||
|
|
||
|
// Ensure `indentedSyntax` is true if a `.sass` file
|
||
|
if (path.extname(file.path) === '.sass') {
|
||
|
opts.indentedSyntax = true;
|
||
|
}
|
||
|
|
||
|
// Ensure file's parent directory in the include path
|
||
|
if (opts.includePaths) {
|
||
|
if (typeof opts.includePaths === 'string') {
|
||
|
opts.includePaths = [opts.includePaths];
|
||
|
}
|
||
|
} else {
|
||
|
opts.includePaths = [];
|
||
|
}
|
||
|
|
||
|
opts.includePaths.unshift(path.dirname(file.path));
|
||
|
|
||
|
// Generate Source Maps if the source-map plugin is present
|
||
|
if (file.sourceMap) {
|
||
|
opts.sourceMap = file.path;
|
||
|
opts.omitSourceMapUrl = true;
|
||
|
opts.sourceMapContents = true;
|
||
|
}
|
||
|
|
||
|
if (sync !== true) {
|
||
|
/**
|
||
|
* Async Sass render
|
||
|
*/
|
||
|
gulpSass.compiler.render(opts, (error, obj) => {
|
||
|
if (error) {
|
||
|
handleError(error, file, callback);
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
filePush(file, obj, callback);
|
||
|
});
|
||
|
} else {
|
||
|
/**
|
||
|
* Sync Sass render
|
||
|
*/
|
||
|
try {
|
||
|
filePush(file, gulpSass.compiler.renderSync(opts), callback);
|
||
|
} catch (error) {
|
||
|
handleError(error, file, callback);
|
||
|
}
|
||
|
}
|
||
|
});
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* Sync Sass render
|
||
|
*/
|
||
|
gulpSass.sync = (options) => gulpSass(options, true);
|
||
|
|
||
|
/**
|
||
|
* Log errors nicely
|
||
|
*/
|
||
|
gulpSass.logError = function logError(error) {
|
||
|
const message = new PluginError('sass', error.messageFormatted).toString();
|
||
|
process.stderr.write(`${message}\n`);
|
||
|
this.emit('end');
|
||
|
};
|
||
|
|
||
|
module.exports = (compiler) => {
|
||
|
if (!compiler || !compiler.render) {
|
||
|
const message = new PluginError(
|
||
|
PLUGIN_NAME,
|
||
|
MISSING_COMPILER_MESSAGE,
|
||
|
{ showProperties: false },
|
||
|
).toString();
|
||
|
process.stderr.write(`${message}\n`);
|
||
|
process.exit(1);
|
||
|
}
|
||
|
|
||
|
gulpSass.compiler = compiler;
|
||
|
return gulpSass;
|
||
|
};
|