@videinfra/static-website-builder 1.13.4 → 1.15.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [1.15.0] - 2025-01-20
+### Added
+- Env file support
+
+## [1.14.0] - 2025-01-16
+### Added
+- Fail build process when TWIG task fails
+
 ## [1.13.4] - 2024-10-08
 ### Fixed
 - Fail gulp process when htmlmin task fails

package/init/test/.env

@@ -0,0 +1,2 @@
+HOST=https://test-global.tld
+FOO=foo-global

package/init/test/.env.local

@@ -0,0 +1,2 @@
+HOST=https://test-local.tld
+BAR=bar-local

package/init/test/config/config.js

@@ -33,6 +33,13 @@ exports.plugins = [
     require('../../../plugins/twig'),
 ];
 
+exports.env = {
+    map: {
+        'HOST': 'host',
+        'FOO': 'foo',
+        'BAR': 'bar',
+    },
+};
 
 /*
  * Path configuration
@@ -45,4 +52,5 @@ exports.plugins = [
 exports.paths = {
     src: './init/test/src',
     dest: './tests/build/public',
+    env: ['./init/test/.env', './init/test/.env.local'],
 };

package/init/test/src/html/env.twig

@@ -0,0 +1,6 @@
+{% from 'macros/icon.twig' import icon %}
+{% extends 'layouts/base.twig' %}
+
+{% block body %}
+    <p>HOST: {{ host }}</p>
+{% endblock %}

package/init/test/src/javascripts/main.js

@@ -1 +1,5 @@
+/* global process */
 console.log('Hello from main page!');
+console.log('env.host ==', process.env.host);
+console.log('env.foo ==', process.env.foo);
+console.log('env.bar ==', process.env.bar);

package/init/test/src/stylesheets/env-test.scss

@@ -0,0 +1,3 @@
+.env-test:before {
+    content: $env-host;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@videinfra/static-website-builder",
-  "version": "1.13.4",
+  "version": "1.15.0",
   "description": "Customizable static site project builder",
   "license": "MIT",
   "engines": {
@@ -36,6 +36,7 @@
     "cross-env": "^7.0.3",
     "cssnano": "^6.0.1",
     "del": "^6.0.0",
+    "dotenv": "^16.4.7",
     "gulp": "^4.0.2",
     "gulp-cached": "^1.1.1",
     "gulp-data": "^1.3.1",

package/plugins/sass-engine/preprocess-config.js

@@ -1,8 +1,10 @@
 const paths = require('./../../lib/get-path');
 const getConfig = require('./../../lib/get-config');
 const getPaths = require('./../../lib/get-path');
+const merge = require('./../../lib/merge');
+const getEnvData = require('./../../tasks/env/get-env');
 const assign = require('lodash/assign');
-const gulpSass = require('gulp-sass');
+const gulpSass = require('../../vendor/gulp-sass/index');
 
 
 /**
@@ -33,7 +35,10 @@ module.exports = function processSASSConfig (config, fullConfig) {
         // Engine is a function which returns a gulp pipe function
         config.engine = function getSASSEngine () {
             const sass = config.legacy ? gulpSass(require('node-sass')) : gulpSass(require('sass'));
-            return sass(getConfig.getTaskConfig('stylesheets', 'sass')).on('error', sass.logError)
+            const sassConfig = getConfig.getTaskConfig('stylesheets', 'sass');
+
+            sassConfig.data = merge(getEnvData().sass, sassConfig.data || {});
+            return sass(sassConfig).on('error', sass.logError)
         };
 
         // Main 'dependents' config is shared between all tasks

package/plugins/twig-engine/preprocess-config.js

@@ -27,6 +27,12 @@ module.exports = function preprocessHTMLConfig (config = {}, fullConfig) {
         if (config.twig.filters) {
             config.twig.filters = flattenDeep(config.twig.filters);
         }
+        if (Array.isArray(config.twig.extend)) {
+            const extendFnList = config.twig.extend;
+            config.twig.extend = function (Twig) {
+                extendFnList.forEach((fn) => fn(Twig));
+            };
+        }
 
         // Main 'dependents' config is shared between all tasks
         if (config.dependents) {

package/plugins/twig.js

@@ -33,6 +33,9 @@ exports.html = {
         // Disabled cache by default, it's enabled for production build only
         cache: false,
 
+        // Rethrow TWIG error so that process exists
+        rethrow: true,
+
         // Custom functions
         functions: [
             // require('../../plugins/twig/symfony-functions.js'),

package/tasks/data/get-data.js

@@ -8,7 +8,7 @@ const getConfig = require('../../lib/get-config');
 const logError = require('../../lib/log-error');
 const getFileNamesSync = require('../../lib/get-file-names');
 const camelizeFileName = require('../../lib/camelize-file-name');
-
+const getEnvData = require('../env/get-env');
 
 function getData () {
     const folders = getPaths.getSourcePaths('data');
@@ -61,7 +61,8 @@ function getData () {
         return data;
     }, {});
 
-    return data;
+    // Merge with env variables
+    return merge(data, getEnvData().twig);
 }
 
 

package/tasks/env/config.js

@@ -0,0 +1,23 @@
+/**
+ * Enviromental variable loading configuration
+ * Environment variables are loaded from .env files and remapped so that they can
+ * be used in TWIG, SASS and JavaScript:
+ *     in TWIG `host` is accessible as `host`
+ *     in SCSS `host` is accessible as `map-get($env, host)`
+ *     in JS `host` is accessible as `process.env.host`
+ */
+
+exports.env = {
+    // How env variable names should be remapped
+    // Example:
+    //     map: { 'HOST': 'host', 'RECAPTCHA3_PUBLIC_KEY': 'recaptcha3_site_key' }
+    map: {}
+};
+
+exports.paths = {
+    // Env files which to load relative to project folder
+    env: [
+        '../.env',
+        '../.env.local',
+    ],
+};

package/tasks/env/get-env.js

@@ -0,0 +1,51 @@
+const paths = require('../../lib/get-path');
+const dotenv = require('dotenv');
+const getConfig = require('../../lib/get-config');
+
+function escapeJSVariable (value) {
+    if (value === true || value === false || !isNaN(value)) {
+        return value;
+    } else {
+        // Convert to string
+        return "'" + value.replace(/\\/g, '\\\\').replace(/'/g, '\\\'').replace(/\n/g, '\\n') + "'";
+    }
+}
+
+function getEnvData () {
+    const envVariables = {};
+    const twigVariables = {};
+    const scssVariables = {};
+    const jsVariables = {};
+
+    const envFiles = paths.getPathConfig().env.map((path) => paths.getProjectPath(path));
+
+
+    dotenv.config({
+        // dotenv file order is reversed, values in first file overwrite all other
+        // file values
+        path: envFiles.reverse(),
+        processEnv: envVariables
+    });
+
+    // Remap property names
+    const map = getConfig.getTaskConfig('env', 'map');
+
+    Object.keys(map).forEach(key => {
+        if (key in envVariables) {
+            const value = envVariables[key];
+            const camelCase = map[key];
+            const kebabCase = map[key].replace(/([a-z])([A-Z])/g, '$1-$2').replace(/_([a-z])/ig, '-$1').toLowerCase();
+            twigVariables[camelCase] = value;
+            jsVariables[`process.env.${ camelCase }`] = escapeJSVariable(value);
+            scssVariables[`env-${ kebabCase }`] = value;
+        }
+    });
+
+    return {
+        twig: twigVariables,
+        sass: scssVariables,
+        js: jsVariables,
+    }
+}
+
+module.exports = getEnvData;

package/tasks/javascripts/preprocess-config.js

@@ -1,5 +1,6 @@
 const paths = require('../../lib/get-path');
 const merge = require('../../lib/merge');
+const getEnvData = require('../env/get-env');
 const get = require('lodash/get');
 const map = require('lodash/map');
 const cloneDeep = require('lodash/cloneDeep');
@@ -83,6 +84,11 @@ module.exports = function preprocessJavascriptsConfig (config, fullConfig) {
             .replace('[folder]/', entry.outpuSubFolder ? entry.outpuSubFolder + '/' : '')
             .replace('[folder]', entry.outpuSubFolder ? entry.outpuSubFolder : '');
 
+        // Use process.env... variables from .env files
+        const envVariables = merge(getEnvData().js, {
+            'process.env.NODE_ENV': JSON.stringify(global.production ? 'production' : 'development'),
+        });
+
         const buildConfig = merge(entryConfig, {
             webpack: {
                 mode: global.production ? 'production' : 'development',
@@ -96,9 +102,7 @@ module.exports = function preprocessJavascriptsConfig (config, fullConfig) {
 
                 // Plugins, add ENV variables
                 plugins: [
-                    new webpack.DefinePlugin({
-                        'process.env.NODE_ENV': JSON.stringify(global.production ? 'production' : 'development'),
-                    }),
+                    new webpack.DefinePlugin(envVariables),
                     new WatchExternalFilesPlugin.default({
                         verbose: false,
                         files: [

package/tests/build/build.test.js

@@ -93,6 +93,22 @@ test('alt/other.js file doesn\'t exist', async () => {
     expect(fsPromises.stat(path.resolve(publicPath, 'assets/javascripts/alt/other.js'))).rejects.toThrow();
 });
 
+test('.env and .env.local files loaded', () => {
+    return Promise.all([
+        fsPromises.readFile(path.resolve(publicPath, 'assets/javascripts/main.js'), {'encoding': 'utf8'}).then((js) => {
+            expect(js.indexOf('console.log("env.host ==","https://test-local.tld")')).not.toBe(-1);
+            expect(js.indexOf('console.log("env.foo ==","foo-global")')).not.toBe(-1);
+            expect(js.indexOf('console.log("env.bar ==","bar-local")')).not.toBe(-1);
+        }),
+        fsPromises.readFile(path.resolve(publicPath, 'env.html'), {'encoding': 'utf8'}).then((html) => {
+            expect(html.indexOf('<p>HOST: https://test-local.tld</p>')).not.toBe(-1);
+        }),
+        fsPromises.readFile(path.resolve(publicPath, 'assets/stylesheets/env-test.css'), {'encoding': 'utf8'}).then((css) => {
+            expect(css.indexOf('.env-test:before{content:"https://test-local.tld"}')).not.toBe(-1);
+        }),
+    ]);
+});
+
 test('icons generated', () => {
     return fsPromises.readFile(path.resolve(publicPath, 'assets/images/icons.svg'), {'encoding': 'utf8'}).then((svg) => {
         expect(svg.indexOf('<symbol id="example-arrow">')).not.toBe(-1);

package/vendor/gulp-sass/CHANGELOG.md

@@ -0,0 +1,168 @@
+# gulp-sass Changelog
+
+## v5.0.0
+
+**June 25, 2021**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v5.0.0>
+
+## v4.1.1
+
+**June 24, 2021**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v4.1.1>
+
+## v4.1.0
+
+**April 23, 2020**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v4.1.0>
+
+## v4.0.2
+
+**October 16, 2018**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v4.0.2>
+
+## v4.0.1
+
+**Apr 8, 2018**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v4.0.1>
+
+## v4.0.0
+
+**April 5, 2018**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v4.0.0>
+
+## v3.2.1
+
+**March 24, 2018**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v3.2.1>
+
+## v3.2.0
+
+**March 12, 2018**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v3.2.0>
+
+## v3.1.0
+
+**January 9, 2017**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v3.1.0>
+
+## v3.0.0
+
+**January 9, 2017**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v3.0.0>
+
+## v2.3.2
+
+**June 15, 2016**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v2.3.2>
+
+## v2.3.1
+
+**April 22, 2016**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v2.3.1>
+
+## v2.3.0
+
+**April 21, 2016**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v2.3.0>
+
+## v2.3.0-beta.1
+
+**February 4, 2016**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v2.3.0-beta.1>
+
+## v2.2.0
+
+**February 4, 2016**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v2.2.0>
+
+## v2.1.0
+
+**November 2, 2015**
+
+<https://github.com/dlmanning/gulp-sass/releases/tag/v2.1.0>
+
+## v2.1.0-beta
+
+**September 21, 2015**
+
+* **Change** Updated to `node-sass` 3.4.0-beta1
+
+## v2.0.4
+
+**July 15, 2015**
+
+* **Fix** Relative file path now uses `file.relative` instead of arcane `split('/').pop` magic. Resolves lots of issues with source map paths.
+* **Fix** Empty partials no longer copied to CSS folder
+
+## v2.0.3
+
+**June 27, 2015**
+
+* **Fix** Empty partials are no longer copied to CSS folder
+
+## v2.0.2
+
+**June 25, 2015**
+
+* **Fix** Error in watch stream preventing watch from continuing
+
+## v2.0.1
+
+**May 13, 2015**
+
+* **Fix** Source maps now work as expected with Autoprefixer
+* **Fix** Current file directory `unshift` onto includePaths stack so it's checked first
+* **Fix** Error message returned is unformatted so as to not break other error handling (*i.e.* `gulp-notify`)
+
+## v2.0.0
+
+**May 6, 2015**
+
+* **Change** Updated to `node-sass` 3.0.0
+
+## v2.0.0-alpha.1
+
+**March 26, 2015**
+
+* **New** Added `renderSync` option that can be used through `sass.sync()`
+
+### March 24, 2015
+
+* **Change** Updated to `node-sass` 3.0.0-alpha.1
+* **New** Added support for `gulp-sourcemaps` including tests
+* **New** Added `.editorconfig` for development consistency
+* **New** Added linting and test for said linting
+* **Change** Updated the README
+* **New** `logError` function to make streaming errors possible instead of breaking the stream
+
+### 1.3.3
+
+* updated to `node-sass` 2.0 (final)
+* should now work with Node.js 0.12 and io.js
+
+### 1.3.2
+
+* fixed `errLogToConsole`
+
+### 1.3.1
+
+* bug fix
+
+## Version 1.3.0
+
+* Supports `node-sass` 2.0 (thanks laurelnaiad!)

package/vendor/gulp-sass/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 David Manning
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/vendor/gulp-sass/README.md

@@ -0,0 +1,196 @@
+# gulp-sass ![npm package version](https://img.shields.io/npm/v/gulp-sass?label=npm%20version) [![Build Status](https://img.shields.io/github/workflow/status/dlmanning/gulp-sass/CI/master)](https://github.com/dlmanning/gulp-sass/actions?query=workflow%3ACI+branch%3Amaster) [![Join the chat at https://gitter.im/dlmanning/gulp-sass](https://img.shields.io/gitter/room/dlmanning/gulp-sass?color=%2346b091&label=chat&logo=gitter)](https://gitter.im/dlmanning/gulp-sass) ![Node.js support](https://img.shields.io/node/v/gulp-sass)
+
+Sass plugin for [Gulp](https://github.com/gulpjs/gulp).
+
+**_Before filing an issue, please make sure you have [updated to the latest version of `gulp-sass`](https://github.com/dlmanning/gulp-sass/wiki/Update-to-the-latest-Gulp-Sass) and have gone through our [Common Issues and Their Fixes](https://github.com/dlmanning/gulp-sass/wiki/Common-Issues-and-Their-Fixes) section._**
+
+**Migrating your existing project to version 5? Please read our (short!) [migration guide](#migrating-to-version-5).**
+
+## Support
+
+Only [Active LTS and Current releases](https://github.com/nodejs/Release#release-schedule) are supported.
+
+## Installation
+
+To use `gulp-sass`, you must install both `gulp-sass` itself *and* a Sass compiler. `gulp-sass` supports both [Dart Sass][] and [Node Sass][], although Node Sass is [deprecated](https://sass-lang.com/blog/libsass-is-deprecated). We recommend that you use Dart Sass for new projects, and migrate Node Sass projects to Dart Sass when possible.
+
+Whichever compiler you choose, it's best to install these as dev dependencies:
+
+```sh
+npm install sass gulp-sass --save-dev
+```
+
+### Importing it into your project
+
+`gulp-sass` must be imported into your gulpfile, where you provide it the compiler of your choice. To use `gulp-sass` in a CommonJS module (which is most Node.js environments), do something like this:
+
+```js
+const sass = require('gulp-sass')(require('sass'));
+```
+
+To use `gulp-sass` in an ECMAScript module (which is supported in newer Node.js 14 and later), do something like this:
+
+```js
+import dartSass from 'sass';
+import gulpSass from 'gulp-sass';
+const sass = gulpSass(dartSass);
+```
+
+## Usage
+
+**Note:** These examples are written for CommonJS modules and assume you're using Gulp 4. For examples that work with Gulp 3, [check the docs for an earlier version of `gulp-sass`](https://github.com/dlmanning/gulp-sass/tree/v4.1.1).
+
+`gulp-sass` must be used in a Gulp task. Your task can call `sass()` (to asynchronously render your CSS), or `sass.sync()` (to synchronously render your CSS). Then, export your task with the `export` keyword. We'll show some examples of how to do that.
+
+**⚠️ Note:** When using Dart Sass, **synchronous rendering is twice as fast as asynchronous rendering**. The Sass team is exploring ways to improve asynchronous rendering with Dart Sass, but for now, you will get the best performance from `sass.sync()`. If performance is critical, you can use `node-sass` instead, but bear in mind that `node-sass` may not support modern Sass features you rely on.
+
+### Render your CSS
+
+To render your CSS with a build task, then watch your files for changes, you might write something like this:
+
+```js
+'use strict';
+
+const gulp = require('gulp');
+const sass = require('gulp-sass')(require('sass'));
+
+function buildStyles() {
+  return gulp.src('./sass/**/*.scss')
+    .pipe(sass().on('error', sass.logError))
+    .pipe(gulp.dest('./css'));
+};
+
+exports.buildStyles = buildStyles;
+exports.watch = function () {
+  gulp.watch('./sass/**/*.scss', ['sass']);
+};
+```
+
+With synchronous rendering, that Gulp task looks like this:
+
+```js
+function buildStyles() {
+  return gulp.src('./sass/**/*.scss')
+    .pipe(sass.sync().on('error', sass.logError))
+    .pipe(gulp.dest('./css'));
+};
+```
+
+### Render with options
+
+To change the final output of your CSS, you can pass an options object to your renderer. `gulp-sass` supports [Node Sass's render options](https://github.com/sass/node-sass#options), with two unsupported exceptions:
+
+- The `data` option, which is used by `gulp-sass` internally.
+- The `file` option, which has undefined behavior that may change without notice.
+
+For example, to compress your CSS, you can call `sass({outputStyle: 'compressed'}`. In the context of a Gulp task, that looks like this:
+
+```js
+function buildStyles() {
+  return gulp.src('./sass/**/*.scss')
+    .pipe(sass({outputStyle: 'compressed'}).on('error', sass.logError))
+    .pipe(gulp.dest('./css'));
+};
+
+exports.buildStyles = buildStyles;
+```
+
+Or this for synchronous rendering:
+
+```js
+function buildStyles() {
+  return gulp.src('./sass/**/*.scss')
+    .pipe(sass.sync({outputStyle: 'compressed'}).on('error', sass.logError))
+    .pipe(gulp.dest('./css'));
+};
+
+exports.buildStyles = buildStyles;
+```
+
+### Include a source map
+
+`gulp-sass` can be used in tandem with [`gulp-sourcemaps`](https://github.com/gulp-sourcemaps/gulp-sourcemaps) to generate source maps for the Sass-to-CSS compilation. You will need to initialize `gulp-sourcemaps` _before_ running `gulp-sass`, and write the source maps after.
+
+```js
+const sourcemaps = require('gulp-sourcemaps');
+
+function buildStyles() {
+  return gulp.src('./sass/**/*.scss')
+    .pipe(sourcemaps.init())
+    .pipe(sass().on('error', sass.logError))
+    .pipe(sourcemaps.write())
+    .pipe(gulp.dest('./css'));
+}
+
+exports.buildStyles = buildStyles;
+```
+
+By default, `gulp-sourcemaps` writes the source maps inline, in the compiled CSS files. To write them to a separate file, specify a path relative to the `gulp.dest()` destination in the `sourcemaps.write()` function.
+
+```js
+const sourcemaps = require('gulp-sourcemaps');
+
+function buildStyles() {
+  return gulp.src('./sass/**/*.scss')
+    .pipe(sourcemaps.init())
+    .pipe(sass().on('error', sass.logError))
+    .pipe(sourcemaps.write('./maps'))
+    .pipe(gulp.dest('./css'));
+};
+
+exports.buildStyles = buildStyles;
+```
+
+<h2 id="migrating-to-version-5">Migrating to version 5</h2>
+
+`gulp-sass` version 5 requires Node.js 12 or later, and introduces some breaking changes. Additionally, changes in Node.js itself mean that Node fibers can no longer be used to speed up Dart Sass in Node.js 16.
+
+### Setting a Sass compiler
+
+As of version 5, `gulp-sass` _does not include a default Sass compiler_, so you must install one (either `node-sass` or `sass`) along with `gulp-sass`.
+
+```sh
+npm install sass gulp-sass --save-dev
+```
+
+Then, you must explicitly set that compiler in your gulpfille. Instead of setting a `compiler` prop on the `gulp-sass` instance, you pass the compiler into a function call when instantiating `gulp-sass`.
+
+These changes look something like this:
+
+```diff
+- const sass = require('gulp-sass'));
+- const compiler = require('sass');
+- sass.compiler = compiler;
++ const sass = require('gulp-sass')(require('sass'));
+```
+
+If you're migrating an ECMAScript module, that'll look something like this:
+
+```diff
+import dartSass from 'sass';
+- import sass from 'gulp-sass';
+- sass.compiler = dartSass;
+
+import dartSass from 'sass';
++ import gulpSass from 'gulp-sass';
++ const sass = gulpSass(dartSass);
+```
+
+### What about fibers?
+
+We used to recommend Node fibers as a way to speed up asynchronous rendering with Dart Sass. Unfortunately, [Node fibers are discontinued](https://sass-lang.com/blog/node-fibers-discontinued) and will not work in Node.js 16. The Sass team is exploring its options for future performance improvements, but for now, you will get the best performance from `sass.sync()`.
+
+## Issues
+
+`gulp-sass` is a light-weight wrapper around either [Dart Sass][] or [Node Sass][] (which in turn is a Node.js binding for [LibSass][]. Because of this, the issue you're having likely isn't a `gulp-sass` issue, but an issue with one those projects or with [Sass][] as a whole.
+
+If you have a feature request/question about how Sass works/concerns on how your Sass gets compiled/errors in your compiling, it's likely a Dart Sass or LibSass issue and you should file your issue with one of those projects.
+
+If you're having problems with the options you're passing in, it's likely a Dart Sass or Node Sass issue and you should file your issue with one of those projects.
+
+We may, in the course of resolving issues, direct you to one of these other projects. If we do so, please follow up by searching that project's issue queue (both open and closed) for your problem and, if it doesn't exist, filing an issue with them.
+
+[Dart Sass]: https://sass-lang.com/dart-sass
+[LibSass]: https://sass-lang.com/libsass
+[Node Sass]: https://github.com/sass/node-sass
+[Sass]: https://sass-lang.com

package/vendor/gulp-sass/index.js

@@ -0,0 +1,225 @@
+// 2025-01-20, Kaspars Zuks: added "options.data" support for variables
+'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));
+};
+
+/**
+ * Escape SCSS variable value for output in SCSS
+ * @param {any} value Value
+ * @returns {string} Escaped value
+ */
+const escapeSCSSVariable = (value) => {
+    if (value === true || value === false || !isNaN(value)) {
+        return value;
+    } else {
+        // Convert to string
+        return "'" + value.toString().replace(/\\/g, '\\\\').replace(/'/g, '\\\'').replace(/\n/g, '\\n') + "'";
+    }
+}
+
+/**
+ * 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();
+
+    // Stringiyfy variables
+    if (options.data) {
+        const scssVariables = [];
+
+        if (typeof options.data === 'string') {
+            // Assume it's valid SCSS
+            scssVariables.push(options.data);
+        } else {
+            for (let key in options.data) {
+                const value = escapeSCSSVariable(options.data[key]);
+                scssVariables.push(`$${key}: ${value};`);
+            }
+        }
+
+        opts.data = scssVariables.join('') + opts.data;
+    }
+
+    // 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;
+};

package/vendor/gulp-sass/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "gulp-sass",
+  "version": "5.1.0",
+  "description": "Gulp plugin for sass",
+  "main": "index.js",
+  "engines": {
+    "node": ">=12"
+  },
+  "scripts": {
+    "lint": "eslint --report-unused-disable-directives --ignore-path .gitignore .",
+    "fix": "npm run lint -- --fix",
+    "mocha": "mocha",
+    "test": "npm run test:node-sass && npm run test:dart-sass",
+    "test:node-sass": "mocha",
+    "test:dart-sass": "mocha -- --sass"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dlmanning/gulp-sass.git"
+  },
+  "keywords": [
+    "gulpplugin",
+    "sass",
+    "gulp"
+  ],
+  "author": "David Manning",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/dlmanning/gulp-sass/issues"
+  },
+  "homepage": "https://github.com/dlmanning/gulp-sass#readme",
+  "files": [
+    "index.js"
+  ],
+  "dependencies": {
+    "lodash.clonedeep": "^4.5.0",
+    "picocolors": "^1.0.0",
+    "plugin-error": "^1.0.1",
+    "replace-ext": "^2.0.0",
+    "strip-ansi": "^6.0.1",
+    "vinyl-sourcemaps-apply": "^0.2.1"
+  },
+  "devDependencies": {
+    "autoprefixer": "^10.4.0",
+    "eslint": "^8.5.0",
+    "eslint-config-airbnb-base": "^15.0.0",
+    "eslint-plugin-import": "^2.25.3",
+    "globule": "^1.3.3",
+    "gulp": "^4.0.2",
+    "gulp-postcss": "^9.0.1",
+    "gulp-sourcemaps": "^3.0.0",
+    "gulp-tap": "^2.0.0",
+    "mocha": "^9.1.3",
+    "node-sass": "^7.0.1",
+    "postcss": "^8.4.5",
+    "rimraf": "^3.0.2",
+    "sass": "^1.45.1",
+    "vinyl": "^2.2.1"
+  }
+}

package/vendor/gulp-twig/index.js

@@ -43,7 +43,7 @@ module.exports = function (options) {
             twig = Twig.twig,
             twigOpts = {
                 path: file.path,
-                async: false
+                async: false,
             },
             template;
 
@@ -59,6 +59,9 @@ module.exports = function (options) {
         if (options.namespaces !== undefined) {
             twigOpts.namespaces = options.namespaces;
         }
+        if (options.rethrow !== undefined) {
+            twigOpts.rethrow = options.rethrow;
+        }
         if (options.cache !== true) {
             Twig.cache(false);
         }