feat: update docs

Author: ducksoupdev

package-lock.json

@@ -29,12 +29,12 @@
   "author": "Matt Levy",
   "license": "MIT",
   "devDependencies": {
-    "cypress": "6.8.0",
+    "cypress": "7.1.0",
     "http-server": "0.12.3",
     "npm-run-all": "4.1.5",
     "open-cli": "6.0.1",
     "replace-in-file": "6.2.0",
-    "rollup": "2.44.0",
+    "rollup": "2.45.2",
     "rollup-plugin-terser": "7.0.2",
     "standard": "16.0.3",
     "start-server-and-test": "1.12.1"

package.json

@@ -0,0 +1,83 @@
+const syntaxHighlight = require("@11ty/eleventy-plugin-syntaxhighlight")
+const CleanCSS = require("clean-css")
+const htmlMinifier = require("html-minifier")
+const markdownIt = require('markdown-it')
+const slugify = require("slugify")
+const pluginTOC = require('eleventy-plugin-nesting-toc')
+const markdownItAnchor = require('markdown-it-anchor')
+const markdownItToc = require('markdown-it-table-of-contents')
+const markdownItEmoji = require('markdown-it-emoji')
+
+module.exports = function(eleventyConfig) {
+  eleventyConfig.addTransform("htmlmin", function(content, outputPath) {
+    // Eleventy 1.0+: use this.inputPath and this.outputPath instead
+    if (outputPath.endsWith(".html")) {
+      let minified = htmlMinifier.minify(content, {
+        useShortDoctype: true,
+        removeComments: true,
+        collapseWhitespace: true
+      })
+      return minified
+    }
+    return content
+  })
+
+  eleventyConfig.addFilter("cssmin", function(code) {
+    return new CleanCSS({}).minify(code).styles
+  })
+
+  eleventyConfig.addShortcode("serviceWorker", function () {
+    if (process.env.NODE_ENV === 'production') {
+      return `<script>window.onload=function(){"serviceWorker"in navigator&&navigator.serviceWorker.register('/sw.js')};</script>`
+    }
+    return ''
+  })
+
+  eleventyConfig.addPlugin(syntaxHighlight)
+
+  function removeExtraText(s) {
+    let newStr = String(s).replace(/New\ in\ v\d+\.\d+\.\d+/, "")
+    newStr = newStr.replace(/Coming\ soon\ in\ v\d+\.\d+\.\d+/, "")
+    newStr = newStr.replace(/⚠️/g, "")
+    newStr = newStr.replace(/[?!]/g, "")
+    newStr = newStr.replace(/<[^>]*>/g, "")
+    return newStr;
+  }
+
+  function markdownItSlugify(s) {
+    return slugify(removeExtraText(s), { lower: true, remove: /[:’'`,]/g })
+  }
+
+  let mdIt = markdownIt({
+    html: true,
+    breaks: true
+  })
+    .use(markdownItAnchor, {
+      permalink: true,
+      slugify: markdownItSlugify,
+      permalinkBefore: false,
+      permalinkClass: "direct-link",
+      permalinkSymbol: "",
+      level: [1,2,3,4,5]
+    })
+    .use(markdownItToc, {
+      includeLevel: [2, 3, 4, 5],
+      slugify: markdownItSlugify,
+      format: function(heading) {
+        return removeExtraText(heading)
+      },
+      transformLink: function(link) {
+        // remove backticks from markdown code
+        return link.replace(/\%60/g, "")
+      }
+    })
+    .use(markdownItEmoji);
+
+  eleventyConfig.setLibrary("md", mdIt)
+
+  eleventyConfig.addPlugin(pluginTOC, {
+    tags: ['h2', 'h3', 'h4', 'h5'],
+    wrapperClass: 'toc__nav',
+    ul: true
+  })
+}