Added full JSX support to build pipeline

lib/tasks/.eslintrc

@@ -0,0 +1,5 @@
+{
+  "rules": {
+    "no-invalid-this": 0
+  }
+}

lib/tasks/assets/images/build/ico.js

@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import changed from "gulp-changed"
+
+/* ----------------------------------------------------------------------------
+ * Task: clean images generated by build
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config) => {
+  return () => {
+    return gulp.src(`${config.assets.src}/images/**/*.ico`)
+      .pipe(changed(`${config.assets.build}/images`))
+      .pipe(gulp.dest(`${config.assets.build}/images`))
+  }
+}

lib/tasks/assets/images/build/svg.js

@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import changed from "gulp-changed"
+import gulpif from "gulp-if"
+import minsvg from "gulp-svgmin"
+import rev from "gulp-rev"
+import version from "gulp-rev-replace"
+
+/* ----------------------------------------------------------------------------
+ * Task: clean images generated by build
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config, args) => {
+  return () => {
+    return gulp.src(`${config.assets.src}/images/**/*.svg`)
+      .pipe(changed(`${config.assets.build}/images`))
+      .pipe(gulpif(args.optimize, minsvg()))
+      .pipe(gulpif(args.revision, rev()))
+      .pipe(gulpif(args.revision,
+        version({ manifest: gulp.src("manifest.json") })))
+      .pipe(gulp.dest(`${config.assets.build}/images`))
+      .pipe(gulpif(args.revision,
+        rev.manifest("manifest.json", {
+          base: config.assets.build,
+          merge: true
+        })))
+      .pipe(gulpif(args.revision, gulp.dest(config.assets.build)))
+  }
+}

lib/tasks/assets/images/clean.js

@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import clean from "del"
+import vinyl from "vinyl-paths"
+
+/* ----------------------------------------------------------------------------
+ * Task: clean images generated by build
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config) => {
+  return () => {
+    return gulp.src(`${config.assets.build}/images/*`)
+      .pipe(vinyl(clean))
+  }
+}

lib/tasks/assets/javascripts/build/application.js

@@ -0,0 +1,110 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import gulpif from "gulp-if"
+import path from "path"
+import rev from "gulp-rev"
+import stream from "webpack-stream"
+import version from "gulp-rev-replace"
+import webpack from "webpack"
+
+/* ----------------------------------------------------------------------------
+ * Task: build application logic
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config, args) => {
+  return () => {
+    return gulp.src(`${config.assets.src}/javascripts/**/*.js`)
+
+      /* Build with webpack */
+      .pipe(
+        stream({
+          entry: "application.js",
+          output: {
+            filename: "application.js",
+            library: "Application"
+          },
+          module: {
+
+            /* Transpile ES6 to ES5 with Babel */
+            loaders: [
+              {
+                loader: "babel-loader",
+                test: /\.jsx?$/
+              }
+            ]
+          },
+          plugins: [
+
+            /* Don't emit assets that include errors */
+            new webpack.NoErrorsPlugin(),
+
+            /* Provide JSX helper */
+            new webpack.ProvidePlugin({
+              JSX: path.join(process.cwd(), `${config.lib}/providers/jsx.js`)
+            })
+          ].concat(
+
+            /* Minify sources */
+            args.optimize ? [
+              new webpack.optimize.UglifyJsPlugin({
+                compress: {
+                  warnings: false
+                }
+              })
+            ] : []),
+
+          /* Module resolver */
+          resolve: {
+            modulesDirectories: [
+              "src/assets/javascripts",
+              "node_modules"
+            ],
+            extensions: [
+              "",
+              ".js",
+              ".jsx"
+            ]
+          },
+
+          /* Webpack commandline output */
+          stats: {
+            colors: true
+          },
+
+          /* Sourcemap support */
+          devtool: args.sourcemaps ? "source-map" : ""
+        }))
+
+      /* Revisioning */
+      .pipe(gulpif(args.revision, rev()))
+      .pipe(gulpif(args.revision,
+        version({ manifest: gulp.src("manifest.json") })))
+      .pipe(gulp.dest(`${config.assets.build}/javascripts`))
+      .pipe(gulpif(args.revision,
+        rev.manifest("manifest.json", {
+          base: config.assets.build,
+          merge: true
+        })))
+      .pipe(gulpif(args.revision, gulp.dest(config.assets.build)))
+  }
+}

lib/tasks/assets/javascripts/build/modernizr.js

@@ -0,0 +1,63 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import concat from "gulp-concat"
+import gulpif from "gulp-if"
+import modernizr from "gulp-modernizr"
+import uglify from "gulp-uglify"
+import rev from "gulp-rev"
+import version from "gulp-rev-replace"
+
+/* ----------------------------------------------------------------------------
+ * Task: build custom modernizr
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config, args) => {
+  return () => {
+    return gulp.src(`${config.assets.build}/stylesheets/*.css`)
+
+      /* Build custom modernizr */
+      .pipe(
+        modernizr({
+          options: [
+            "addTest",                 /* Add custom tests */
+            "setClasses"               /* Add CSS classes to root tag */
+          ]
+        }))
+      .pipe(concat("modernizr.js"))
+
+      /* Minify sources */
+      .pipe(gulpif(args.optimize, uglify()))
+
+      /* Revisioning */
+      .pipe(gulpif(args.revision, rev()))
+      .pipe(gulpif(args.revision,
+        version({ manifest: gulp.src("manifest.json") })))
+      .pipe(gulp.dest(`${config.assets.build}/javascripts`))
+      .pipe(gulpif(args.revision,
+        rev.manifest("manifest.json", {
+          base: config.assets.build,
+          merge: true
+        })))
+      .pipe(gulpif(args.revision, gulp.dest(config.assets.build)))
+  }
+}

lib/tasks/assets/javascripts/clean.js

@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import clean from "del"
+import vinyl from "vinyl-paths"
+
+/* ----------------------------------------------------------------------------
+ * Task: clean javascripts generated by build
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config) => {
+  return () => {
+    return gulp.src(`${config.assets.build}/javascripts/*`)
+      .pipe(vinyl(clean))
+  }
+}

lib/tasks/assets/javascripts/lint.js

@@ -0,0 +1,107 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import path from "path"
+import through from "through2"
+import util from "gulp-util"
+import { CLIEngine } from "eslint"
+
+/* ----------------------------------------------------------------------------
+ * Locals
+ * ------------------------------------------------------------------------- */
+
+const eslint = new CLIEngine
+const format = eslint.getFormatter()
+
+/* ----------------------------------------------------------------------------
+ * Task: lint SASS sources
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config) => {
+  return () => {
+    return gulp.src(`${config.assets.src}/javascripts/**/*.js`)
+
+      /* Linting */
+      .pipe(
+        through.obj(function(file, enc, cb) {
+          if (file.isNull() || file.isStream())
+            return cb()
+
+          /* Lint file using .eslintrc */
+          file.eslint = eslint.executeOnText(
+            file.contents.toString())
+
+          /* Correct file path */
+          file.eslint.results[0].filePath =
+            path.relative(process.cwd(), file.path)
+
+          /* Push file to next stage */
+          this.push(file)
+          cb()
+        }))
+
+      /* Print errors */
+      .pipe(
+        through.obj(function(file, enc, cb) {
+          if (file.eslint.errorCount || file.eslint.warningCount) {
+            // eslint-disable-next-line no-console
+            console.log(format(file.eslint.results))
+          }
+
+          /* Push file to next stage */
+          this.push(file)
+          cb()
+        }))
+
+      /* Terminate on error */
+      .pipe(
+        (() => {
+          const errors = []
+
+          /* Gather errors */
+          return through.obj(function(file, enc, cb) {
+            const results = file.eslint
+
+            /* Consider warnings as errors */
+            if (results.errorCount || results.warningCount)
+              errors.push(file)
+
+            /* Push file to next stage */
+            this.push(file)
+            cb()
+
+          /* Format errors and terminate */
+          }, function(cb) {
+            if (errors.length > 0) {
+              const message = errors.map(file => {
+                return file.relative
+              }).join(", ")
+
+              /* Emit error */
+              this.emit("error", new util.PluginError("eslint",
+                `Terminated with errors in files: ${message}`))
+            }
+            cb()
+          })
+        })())
+  }
+}

lib/tasks/assets/stylesheets/build.js

@@ -0,0 +1,75 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import autoprefixer from "autoprefixer"
+import gulpif from "gulp-if"
+import mincss from "gulp-cssnano"
+import mqpacker from "css-mqpacker"
+import postcss from "gulp-postcss"
+import rev from "gulp-rev"
+import sass from "gulp-sass"
+import sourcemaps from "gulp-sourcemaps"
+import version from "gulp-rev-replace"
+
+/* ----------------------------------------------------------------------------
+ * Task: build stylesheets from SASS source
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config, args) => {
+  return () => {
+    return gulp.src(`${config.assets.src}/stylesheets/*.scss`)
+      .pipe(gulpif(args.sourcemaps, sourcemaps.init()))
+
+      /* Compile SASS sources */
+      .pipe(
+        sass({
+          includePaths: [
+            "node_modules/modularscale-sass/stylesheets",
+            "node_modules/material-design-color",
+            "node_modules/material-shadows"
+          ]
+        }))
+
+      /* Apply PostCSS plugins */
+      .pipe(
+        postcss([
+          autoprefixer(),
+          mqpacker
+        ]))
+
+      /* Minify sources */
+      .pipe(gulpif(args.optimize, mincss()))
+
+      /* Revisioning */
+      .pipe(gulpif(args.revision, rev()))
+      .pipe(gulpif(args.revision,
+        version({ manifest: gulp.src("manifest.json") })))
+      .pipe(gulpif(args.sourcemaps, sourcemaps.write(".")))
+      .pipe(gulp.dest(`${config.assets.build}/stylesheets`))
+      .pipe(gulpif(args.revision,
+        rev.manifest("manifest.json", {
+          base: config.assets.build,
+          merge: true
+        })))
+      .pipe(gulpif(args.revision, gulp.dest(config.assets.build)))
+  }
+}

lib/tasks/assets/stylesheets/clean.js

@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import clean from "del"
+import vinyl from "vinyl-paths"
+
+/* ----------------------------------------------------------------------------
+ * Task: clean stylesheets generated by build
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config) => {
+  return () => {
+    return gulp.src(`${config.assets.build}/stylesheets/*`)
+      .pipe(vinyl(clean))
+  }
+}

lib/tasks/assets/stylesheets/lint.js

@@ -0,0 +1,96 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import path from "path"
+import sasslint from "sass-lint"
+import through from "through2"
+import util from "gulp-util"
+
+/* ----------------------------------------------------------------------------
+ * Task: lint SASS sources
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config) => {
+  return () => {
+    return gulp.src(`${config.assets.src}/stylesheets/**/*.scss`)
+
+      /* Linting */
+      .pipe(
+        through.obj(function(file, enc, cb) {
+          if (file.isNull() || file.isStream())
+            return cb()
+
+          /* Lint file using .sass-lint.yml */
+          file.sasslint = sasslint.lintFileText({
+            text: file.contents,
+            format: path.extname(file.path).replace(".", ""),
+            filename: path.relative(process.cwd(), file.path)
+          })
+
+          /* Push file to next stage */
+          this.push(file)
+          cb()
+        }))
+
+      /* Print errors */
+      .pipe(
+        through.obj(function(file, enc, cb) {
+          sasslint.outputResults([file.sasslint])
+
+          /* Push file to next stage */
+          this.push(file)
+          cb()
+        }))
+
+      /* Terminate on error */
+      .pipe(
+        (() => {
+          const errors = []
+
+          /* Gather errors */
+          return through.obj(function(file, enc, cb) {
+            const results = file.sasslint
+
+            /* Consider warnings as errors during clean compilation */
+            if (results.errorCount || results.warningCount)
+              errors.push(file)
+
+            /* Push file to next stage */
+            this.push(file)
+            cb()
+
+          /* Format errors and terminate */
+          }, function(cb) {
+            if (errors.length > 0) {
+              const message = errors.map(file => {
+                return file.relative
+              }).join(", ")
+
+              /* Emit error */
+              this.emit("error", new util.PluginError("eslint",
+                `Terminated with errors in files: ${message}`))
+            }
+            cb()
+          })
+        })())
+  }
+}

lib/tasks/mkdocs/build.js

@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import child from "child_process"
+
+/* ----------------------------------------------------------------------------
+ * Task: build documentation
+ * ------------------------------------------------------------------------- */
+
+export default () => {
+  return () => {
+    return child.spawnSync("mkdocs", ["build"])
+  }
+}

lib/tasks/mkdocs/clean.js

@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import clean from "del"
+import vinyl from "vinyl-paths"
+
+/* ----------------------------------------------------------------------------
+ * Task: clean documentation build
+ * ------------------------------------------------------------------------- */
+
+export default gulp => {
+  return () => {
+    return gulp.src("site")
+      .pipe(vinyl(clean))
+  }
+}

lib/tasks/mkdocs/serve.js

@@ -0,0 +1,58 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import child from "child_process"
+import util from "gulp-util"
+
+/* ----------------------------------------------------------------------------
+ * Locals
+ * ------------------------------------------------------------------------- */
+
+/* MkDocs server */
+let server = null
+
+/* ----------------------------------------------------------------------------
+ * Task: serve documentation
+ * ------------------------------------------------------------------------- */
+
+export default () => {
+  return () => {
+    if (server)
+      server.kill()
+
+    /* Spawn MkDocs server */
+    server = child.spawn("mkdocs", ["serve", "-a", "0.0.0.0:8000"])
+
+    /* Pretty print server log output */
+    server.stdout.on("data", data => {
+      const lines = data.toString().split("\n")
+      for (const l in lines)
+        if (lines[l].length)
+          util.log(lines[l])
+    })
+
+    /* Print errors to stdout */
+    server.stderr.on("data", data => {
+      process.stdout.write(data.toString())
+    })
+  }
+}

lib/tasks/tests/unit.js

@@ -0,0 +1,36 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import path from "path"
+import { Server } from "karma"
+
+/* ----------------------------------------------------------------------------
+ * Task: start karma test runner
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config) => {
+  return cb => {
+    new Server({
+      configFile: path.join(process.cwd(), config.tests.unit)
+    }, cb).start()
+  }
+}

lib/tasks/tests/unit/watch.js

@@ -0,0 +1,36 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import path from "path"
+import { Server } from "karma"
+
+/* ----------------------------------------------------------------------------
+ * Task: start karma test runner
+ * ------------------------------------------------------------------------- */
+
+export default () => {
+  return cb => {
+    new Server({
+      configFile: path.join(process.cwd(), "tests/karma.conf.js")
+    }, cb).start()
+  }
+}

lib/tasks/views/build.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import changed from "gulp-changed"
+import compact from "gulp-remove-empty-lines"
+import gulpif from "gulp-if"
+import minhtml from "gulp-htmlmin"
+import path from "path"
+import replace from "gulp-replace"
+import version from "gulp-rev-replace"
+
+/* ----------------------------------------------------------------------------
+ * Task: minify views
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config, args) => {
+  return () => {
+    const metadata = require(path.join(process.cwd(), "./package.json"))
+    return gulp.src(`${config.views.src}/**/*.html`)
+      .pipe(changed(config.views.build))
+      .pipe(
+        minhtml({
+          collapseBooleanAttributes: true,
+          removeComments: true,
+          removeScriptTypeAttributes: true,
+          removeStyleLinkTypeAttributes: true,
+          customAttrCollapse: /(content)/
+        }))
+      .pipe(replace("$theme-name$", metadata.name))
+      .pipe(replace("$theme-version$", metadata.version))
+      .pipe(compact())
+      .pipe(gulpif(args.revision,
+        version({ manifest: gulp.src("manifest.json") })))
+      .pipe(gulp.dest(config.views.build))
+  }
+}

lib/tasks/views/clean.js

@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2016 Martin Donath <martin.donath@squidfunk.com>
+ *
+ * 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 NON-INFRINGEMENT. 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.
+ */
+
+import clean from "del"
+import vinyl from "vinyl-paths"
+
+/* ----------------------------------------------------------------------------
+ * Task: clean views
+ * ------------------------------------------------------------------------- */
+
+export default (gulp, config) => {
+  return () => {
+    return gulp.src(`${config.views.build}/**/*.html`)
+      .pipe(vinyl(clean))
+  }
+}