Initial commit: 11ty website with Fire/Frost branding

node_modules/@11ty/eleventy-dev-server/README.md

@@ -0,0 +1,60 @@
+<p align="center"><img src="https://www.11ty.dev/img/logo-github.svg" width="200" height="200" alt="11ty Logo"></p>
+
+# eleventy-dev-server 🕚⚡️🎈🐀
+
+A minimal, modern, generic, hot-reloading local web server to help web developers.
+
+## ➡ [Documentation](https://www.11ty.dev/docs/watch-serve/#eleventy-dev-server)
+
+- Please star [Eleventy on GitHub](https://github.com/11ty/eleventy/)!
+- Follow us on Twitter [@eleven_ty](https://twitter.com/eleven_ty)
+- Support [11ty on Open Collective](https://opencollective.com/11ty)
+- [11ty on npm](https://www.npmjs.com/org/11ty)
+- [11ty on GitHub](https://github.com/11ty)
+
+[![npm Version](https://img.shields.io/npm/v/@11ty/eleventy-dev-server.svg?style=for-the-badge)](https://www.npmjs.com/package/@11ty/eleventy-dev-server)
+
+## Installation
+
+This is bundled with `@11ty/eleventy` (and you do not need to install it separately) in Eleventy v2.0.
+
+## CLI
+
+Eleventy Dev Server now also includes a CLI. The CLI is for **standalone** (non-Eleventy) use only: separate installation is unnecessary if you’re using this server with `@11ty/eleventy`.
+
+```sh
+npm install -g @11ty/eleventy-dev-server
+
+# Alternatively, install locally into your project
+npm install @11ty/eleventy-dev-server
+```
+
+This package requires Node 18 or newer.
+
+### CLI Usage
+
+```sh
+# Serve the current directory
+npx @11ty/eleventy-dev-server
+
+# Serve a different subdirectory (also aliased as --input)
+npx @11ty/eleventy-dev-server --dir=_site
+
+# Disable the `domdiff` feature
+npx @11ty/eleventy-dev-server --domdiff=false
+
+# Full command list in the Help
+npx @11ty/eleventy-dev-server --help
+```
+
+## Tests
+
+```
+npm run test
+```
+
+- We use the [ava JavaScript test runner](https://github.com/avajs/ava) ([Assertions documentation](https://github.com/avajs/ava/blob/master/docs/03-assertions.md))
+
+## Changelog
+
+* `v2.0.0` bumps Node.js minimum to 18.

node_modules/@11ty/eleventy-dev-server/cli.js

@@ -0,0 +1,89 @@
+const pkg = require("./package.json");
+const EleventyDevServer = require("./server.js");
+
+const Logger = {
+  info: function(...args) {
+    console.log( "[11ty/eleventy-dev-server]", ...args );
+  },
+  error: function(...args) {
+    console.error( "[11ty/eleventy-dev-server]", ...args );
+  },
+  fatal: function(...args) {
+    Logger.error(...args);
+    process.exitCode = 1;
+  }
+};
+
+Logger.log = Logger.info;
+
+class Cli {
+  static getVersion() {
+    return pkg.version;
+  }
+
+  static getHelp() {
+    return `Usage:
+
+       eleventy-dev-server
+       eleventy-dev-server --dir=_site
+       eleventy-dev-server --port=3000
+
+Arguments:
+
+     --version
+
+     --dir=.
+       Directory to serve (default: \`.\`)
+
+     --input (alias for --dir)
+
+     --port=8080
+       Run the web server on this port (default: \`8080\`)
+       Will autoincrement if already in use.
+
+     --domdiff          (enabled, default)
+     --domdiff=false    (disabled)
+       Apply HTML changes without a full page reload.
+
+     --help`;
+  }
+
+  static getDefaultOptions() {
+    return {
+      port: "8080",
+      input: ".",
+      domDiff: true,
+    }
+  }
+
+  async serve(options = {}) {
+    this.options = Object.assign(Cli.getDefaultOptions(), options);
+
+    this.server = EleventyDevServer.getServer("eleventy-dev-server-cli", this.options.input, {
+      // TODO allow server configuration extensions
+      showVersion: true,
+      logger: Logger,
+      domDiff: this.options.domDiff,
+
+      // CLI watches all files in the folder by default
+      // this is different from Eleventy usage!
+      watch: [ this.options.input ],
+    });
+
+    this.server.serve(this.options.port);
+
+    // TODO? send any errors here to the server too
+    // with server.sendError({ error });
+  }
+
+  close() {
+    if(this.server) {
+      return this.server.close();
+    }
+  }
+}
+
+module.exports = {
+  Logger,
+  Cli
+}

node_modules/@11ty/eleventy-dev-server/client/reload-client.js

@@ -0,0 +1,336 @@
+class Util {
+  static pad(num, digits = 2) {
+    let zeroes = new Array(digits + 1).join(0);
+    return `${zeroes}${num}`.slice(-1 * digits);
+  }
+
+  static log(message) {
+    Util.output("log", message);
+  }
+  static error(message, error) {
+    Util.output("error", message, error);
+  }
+  static output(type, ...messages) {
+    let now = new Date();
+    let date = `${Util.pad(now.getUTCHours())}:${Util.pad(
+      now.getUTCMinutes()
+    )}:${Util.pad(now.getUTCSeconds())}.${Util.pad(
+      now.getUTCMilliseconds(),
+      3
+    )}`;
+    console[type](`[11ty][${date} UTC]`, ...messages);
+  }
+
+  static capitalize(word) {
+    return word.substr(0, 1).toUpperCase() + word.substr(1);
+  }
+
+  static matchRootAttributes(htmlContent) {
+    // Workaround for morphdom bug with attributes on <html> https://github.com/11ty/eleventy-dev-server/issues/6
+    // Note also `childrenOnly: true` above
+    const parser = new DOMParser();
+    let parsed = parser.parseFromString(htmlContent, "text/html");
+    let parsedDoc = parsed.documentElement;
+    let newAttrs = parsedDoc.getAttributeNames();
+
+    let docEl = document.documentElement;
+    // Remove old
+    let removedAttrs = docEl.getAttributeNames().filter(name => !newAttrs.includes(name));
+    for(let attr of removedAttrs) {
+      docEl.removeAttribute(attr);
+    }
+
+    // Add new
+    for(let attr of newAttrs) {
+      docEl.setAttribute(attr, parsedDoc.getAttribute(attr));
+    }
+  }
+
+  static isEleventyLinkNodeMatch(from, to) {
+    // Issue #18 https://github.com/11ty/eleventy-dev-server/issues/18
+    // Don’t update a <link> if the _11ty searchParam is the only thing that’s different
+    if(from.tagName !== "LINK" || to.tagName !== "LINK") {
+      return false;
+    }
+
+    let oldWithoutHref = from.cloneNode();
+    let newWithoutHref = to.cloneNode();
+
+    oldWithoutHref.removeAttribute("href");
+    newWithoutHref.removeAttribute("href");
+
+    // if all other attributes besides href match
+    if(!oldWithoutHref.isEqualNode(newWithoutHref)) {
+      return false;
+    }
+
+    let oldUrl = new URL(from.href);
+    let newUrl = new URL(to.href);
+
+    // morphdom wants to force href="style.css?_11ty" => href="style.css"
+    let paramName = EleventyReload.QUERY_PARAM;
+    let isErasing = oldUrl.searchParams.has(paramName) && !newUrl.searchParams.has(paramName);
+    if(!isErasing) {
+      // not a match if _11ty has a new value (not being erased)
+      return false;
+    }
+
+    oldUrl.searchParams.set(paramName, "");
+    newUrl.searchParams.set(paramName, "");
+
+    // is a match if erasing and the rest of the href matches too
+    return oldUrl.toString() === newUrl.toString();
+  }
+
+  // https://github.com/patrick-steele-idem/morphdom/issues/178#issuecomment-652562769
+  static runScript(source, target) {
+    let script = document.createElement('script');
+
+    // copy over the attributes
+    for(let attr of [...source.attributes]) {
+      script.setAttribute(attr.nodeName ,attr.nodeValue);
+    }
+
+    script.innerHTML = source.innerHTML;
+    (target || source).replaceWith(script);
+  }
+
+  static fullPageReload() {
+    Util.log(`Page reload initiated.`);
+    window.location.reload();
+  }
+}
+
+class EleventyReload {
+  static QUERY_PARAM = "_11ty";
+
+  static reloadTypes = {
+    css: (files, build = {}) => {
+      // Initiate a full page refresh if a CSS change is made but does match any stylesheet url
+      // `build.stylesheets` available in Eleventy v3.0.1-alpha.5+
+      if(Array.isArray(build.stylesheets)) {
+        let match = false;
+        for (let link of document.querySelectorAll(`link[rel="stylesheet"]`)) {
+          if (link.href) {
+            let url = new URL(link.href);
+            if(build.stylesheets.includes(url.pathname)) {
+              match = true;
+            }
+          }
+        }
+
+        if(!match) {
+          Util.fullPageReload();
+          return;
+        }
+      }
+
+      for (let link of document.querySelectorAll(`link[rel="stylesheet"]`)) {
+        if (link.href) {
+          let url = new URL(link.href);
+          url.searchParams.set(this.QUERY_PARAM, Date.now());
+          link.href = url.toString();
+        }
+      }
+
+      Util.log(`CSS updated without page reload.`);
+    },
+    default: async (files, build = {}) => {
+      let morphed = false;
+      let domdiffTemplates = (build?.templates || []).filter(({url, inputPath}) => {
+        return url === document.location.pathname && (files || []).includes(inputPath);
+      });
+
+      if(domdiffTemplates.length === 0) {
+        Util.fullPageReload();
+        return;
+      }
+
+      try {
+        // Important: using `./` allows the `.11ty` folder name to be changed
+        const { default: morphdom } = await import(`./morphdom.js`);
+
+        for (let {url, inputPath, content} of domdiffTemplates) {
+          // Notable limitation: this won’t re-run script elements or JavaScript page lifecycle events (load/DOMContentLoaded)
+          morphed = true;
+
+          morphdom(document.documentElement, content, {
+            childrenOnly: true,
+            onBeforeElUpdated: function (fromEl, toEl) {
+              if (fromEl.nodeName === "SCRIPT" && toEl.nodeName === "SCRIPT") {
+                if(toEl.innerHTML !== fromEl.innerHTML) {
+                  Util.log(`JavaScript modified, reload initiated.`);
+                  window.location.reload();
+                }
+
+                return false;
+              }
+
+              // Speed-up trick from morphdom docs
+              // https://dom.spec.whatwg.org/#concept-node-equals
+              if (fromEl.isEqualNode(toEl)) {
+                return false;
+              }
+
+              if(Util.isEleventyLinkNodeMatch(fromEl, toEl)) {
+                return false;
+              }
+
+              return true;
+            },
+            addChild: function(parent, child) {
+              // Declarative Shadow DOM https://github.com/11ty/eleventy-dev-server/issues/90
+              if(child.nodeName === "TEMPLATE" && child.hasAttribute("shadowrootmode")) {
+                let root = parent.shadowRoot;
+                if(root) {
+                  // remove all shadow root children
+                  while(root.firstChild) {
+                    root.removeChild(root.firstChild);
+                  }
+                }
+                for(let newChild of child.content.childNodes) {
+                  root.appendChild(newChild);
+                }
+              } else {
+                parent.appendChild(child);
+              }
+            },
+            onNodeAdded: function (node) {
+              if (node.nodeName === 'SCRIPT') {
+                Util.log(`JavaScript added, reload initiated.`);
+                window.location.reload();
+              }
+            },
+            onElUpdated: function(node) {
+              // Re-attach custom elements
+              if(customElements.get(node.tagName.toLowerCase())) {
+                let placeholder = document.createElement("div");
+                node.replaceWith(placeholder);
+                requestAnimationFrame(() => {
+                  placeholder.replaceWith(node);
+                  placeholder = undefined;
+                });
+              }
+            }
+          });
+
+          Util.matchRootAttributes(content);
+          Util.log(`HTML delta applied without page reload.`);
+        }
+      } catch(e) {
+        Util.error( "Morphdom error", e );
+      }
+
+      if (!morphed) {
+        Util.fullPageReload();
+      }
+    }
+  }
+
+  constructor() {
+    this.connectionMessageShown = false;
+    this.reconnectEventCallback = this.reconnect.bind(this);
+  }
+
+  init(options = {}) {
+    if (!("WebSocket" in window)) {
+      return;
+    }
+
+    let documentUrl = new URL(document.location.href);
+
+    let reloadPort = new URL(import.meta.url).searchParams.get("reloadPort");
+    if(reloadPort) {
+      documentUrl.port = reloadPort;
+    }
+
+    let { protocol, host } = documentUrl;
+
+    // works with http (ws) and https (wss)
+    let websocketProtocol = protocol.replace("http", "ws");
+
+    let socket = new WebSocket(`${websocketProtocol}//${host}`);
+
+    socket.addEventListener("message", async (event) => {
+      try {
+        let data = JSON.parse(event.data);
+        // Util.log( JSON.stringify(data, null, 2) );
+
+        let { type } = data;
+
+        if (type === "eleventy.reload") {
+          await this.onreload(data);
+        } else if (type === "eleventy.msg") {
+          Util.log(`${data.message}`);
+        } else if (type === "eleventy.error") {
+          // Log Eleventy build errors
+          // Extra parsing for Node Error objects
+          let e = JSON.parse(data.error);
+          Util.error(`Build error: ${e.message}`, e);
+        } else if (type === "eleventy.status") {
+          // Full page reload on initial reconnect
+          if (data.status === "connected" && options.mode === "reconnect") {
+            window.location.reload();
+          }
+
+          if(data.status === "connected") {
+            // With multiple windows, only show one connection message
+            if(!this.isConnected) {
+              Util.log(Util.capitalize(data.status));
+            }
+
+            this.connectionMessageShown = true;
+          } else {
+            if(data.status === "disconnected") {
+              this.addReconnectListeners();
+            }
+
+            Util.log(Util.capitalize(data.status));
+          }
+        } else {
+          Util.log("Unknown event type", data);
+        }
+      } catch (e) {
+        Util.error(`Error parsing ${event.data}: ${e.message}`, e);
+      }
+    });
+
+    socket.addEventListener("open", () => {
+      // no reconnection when the connect is already open
+      this.removeReconnectListeners();
+    });
+
+    socket.addEventListener("close", () => {
+      this.connectionMessageShown = false;
+      this.addReconnectListeners();
+    });
+  }
+
+  reconnect() {
+    Util.log( "Reconnecting…" );
+    this.init({ mode: "reconnect" });
+  }
+
+  async onreload({ subtype, files, build }) {
+    if(!EleventyReload.reloadTypes[subtype]) {
+      subtype = "default";
+    }
+
+    await EleventyReload.reloadTypes[subtype](files, build);
+  }
+
+  addReconnectListeners() {
+    this.removeReconnectListeners();
+
+    window.addEventListener("focus", this.reconnectEventCallback);
+    window.addEventListener("visibilitychange", this.reconnectEventCallback);
+  }
+
+  removeReconnectListeners() {
+    window.removeEventListener("focus", this.reconnectEventCallback);
+    window.removeEventListener("visibilitychange", this.reconnectEventCallback);
+  }
+}
+
+let reloader = new EleventyReload();
+reloader.init();

node_modules/@11ty/eleventy-dev-server/cmd.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+
+const pkg = require("./package.json");
+
+// Node check
+require("please-upgrade-node")(pkg, {
+  message: function (requiredVersion) {
+    return (
+      "eleventy-dev-server requires Node " +
+      requiredVersion +
+      ". You will need to upgrade Node!"
+    );
+  },
+});
+
+const { Logger, Cli } = require("./cli.js");
+
+const debug = require("debug")("Eleventy:DevServer");
+
+try {
+  const defaults = Cli.getDefaultOptions();
+  for(let key in defaults) {
+    if(key.toLowerCase() !== key) {
+      defaults[key.toLowerCase()] = defaults[key];
+      delete defaults[key];
+    }
+  }
+
+  const argv = require("minimist")(process.argv.slice(2), {
+    string: [
+      "dir",
+      "input", // alias for dir
+      "port",
+    ],
+    boolean: [
+      "version",
+      "help",
+      "domdiff",
+    ],
+    default: defaults,
+    unknown: function (unknownArgument) {
+      throw new Error(
+        `We don’t know what '${unknownArgument}' is. Use --help to see the list of supported commands.`
+      );
+    },
+  });
+
+  debug("command: eleventy-dev-server %o", argv);
+
+  process.on("unhandledRejection", (error, promise) => {
+    Logger.fatal("Unhandled rejection in promise:", promise, error);
+  });
+  process.on("uncaughtException", (error) => {
+    Logger.fatal("Uncaught exception:", error);
+  });
+
+  if (argv.version) {
+    console.log(Cli.getVersion());
+  } else if (argv.help) {
+    console.log(Cli.getHelp());
+  } else {
+    let cli = new Cli();
+
+    cli.serve({
+      input: argv.dir || argv.input,
+      port: argv.port,
+      domDiff: argv.domdiff,
+    });
+
+    process.on("SIGINT", async () => {
+      await cli.close();
+      process.exitCode = 0;
+    });
+  }
+} catch (e) {
+  Logger.fatal("Fatal Error:", e)
+}

node_modules/@11ty/eleventy-dev-server/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@11ty/eleventy-dev-server",
+  "version": "2.0.8",
+  "description": "A minimal, modern, generic, hot-reloading local web server to help web developers.",
+  "main": "server.js",
+  "scripts": {
+    "test": "npx ava --verbose",
+    "sample": "node cmd.js --input=test/stubs"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/11ty"
+  },
+  "bin": {
+    "eleventy-dev-server": "./cmd.js"
+  },
+  "keywords": [
+    "eleventy",
+    "server",
+    "cli"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": {
+    "name": "Zach Leatherman",
+    "email": "zachleatherman@gmail.com",
+    "url": "https://zachleat.com/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/11ty/eleventy-dev-server.git"
+  },
+  "bugs": "https://github.com/11ty/eleventy-dev-server/issues",
+  "homepage": "https://github.com/11ty/eleventy-dev-server/",
+  "dependencies": {
+    "@11ty/eleventy-utils": "^2.0.1",
+    "chokidar": "^3.6.0",
+    "debug": "^4.4.0",
+    "finalhandler": "^1.3.1",
+    "mime": "^3.0.0",
+    "minimist": "^1.2.8",
+    "morphdom": "^2.7.4",
+    "please-upgrade-node": "^3.2.0",
+    "send": "^1.1.0",
+    "ssri": "^11.0.0",
+    "urlpattern-polyfill": "^10.0.0",
+    "ws": "^8.18.1"
+  },
+  "devDependencies": {
+    "ava": "^6.2.0"
+  }
+}

node_modules/@11ty/eleventy-dev-server/server/ipAddress.js

@@ -0,0 +1,9 @@
+const os = require("node:os");
+
+const INTERFACE_FAMILIES = ["IPv4"];
+
+module.exports = function() {
+    return Object.values(os.networkInterfaces()).flat().filter(interface => {
+        return interface.internal === false && INTERFACE_FAMILIES.includes(interface.family);
+    }).map(interface => interface.address);
+};

node_modules/@11ty/eleventy-dev-server/server/wrapResponse.js

@@ -0,0 +1,130 @@
+function getContentType(headers) {
+  if(!headers) {
+    return;
+  }
+
+  for(let key in headers) {
+    if(key.toLowerCase() === "content-type") {
+      return headers[key];
+    }
+  }
+}
+
+// Inspired by `resp-modifier` https://github.com/shakyShane/resp-modifier/blob/4a000203c9db630bcfc3b6bb8ea2abc090ae0139/index.js
+function wrapResponse(resp, transformHtml) {
+  resp._wrappedOriginalWrite = resp.write;
+  resp._wrappedOriginalWriteHead = resp.writeHead;
+  resp._wrappedOriginalEnd = resp.end;
+
+  resp._wrappedHeaders = [];
+  resp._wrappedTransformHtml = transformHtml;
+  resp._hasEnded = false;
+  resp._shouldForceEnd = false;
+
+  // Compatibility with web standards Response()
+  Object.defineProperty(resp, "body", {
+    // Returns write cache
+    get: function() {
+      if(typeof this._writeCache === "string") {
+        return this._writeCache;
+      }
+    },
+    // Usage:
+    // res.body = ""; // overwrite existing content
+    // res.body += ""; // append to existing content, can also res.write("") to append
+    set: function(data) {
+      if(typeof data === "string") {
+        this._writeCache = data;
+      }
+    }
+  });
+
+  // Compatibility with web standards Response()
+  Object.defineProperty(resp, "bodyUsed", {
+    get: function() {
+      return this._hasEnded;
+    }
+  })
+
+  // Original signature writeHead(statusCode[, statusMessage][, headers])
+  resp.writeHead = function(statusCode, ...args) {
+    let headers = args[args.length - 1];
+    // statusMessage is a string
+    if(typeof headers !== "string") {
+      this._contentType = getContentType(headers);
+    }
+
+    if((this._contentType || "").startsWith("text/html")) {
+      this._wrappedHeaders.push([statusCode, ...args]);
+    } else {
+      return this._wrappedOriginalWriteHead(statusCode, ...args);
+    }
+    return this;
+  }
+
+  // data can be a String or Buffer
+  resp.write = function(data, ...args) {
+    if(typeof data === "string") {
+      if(!this._writeCache) {
+        this._writeCache = "";
+      }
+
+      // TODO encoding and callback args
+      this._writeCache += data;
+    } else {
+      // Buffers
+      return this._wrappedOriginalWrite(data, ...args);
+    }
+    return this;
+  }
+
+  // data can be a String or Buffer
+  resp.end = function(data, encoding, callback) {
+    resp._hasEnded = true;
+
+    if(typeof this._writeCache === "string" || typeof data === "string") {
+      // Strings
+      if(!this._writeCache) {
+        this._writeCache = "";
+      }
+      if(typeof data === "string") {
+        this._writeCache += data;
+      }
+
+      let result = this._writeCache;
+
+      // Only transform HTML
+      // Note the “setHeader versus writeHead” note on https://nodejs.org/api/http.html#responsewriteheadstatuscode-statusmessage-headers
+      let contentType = this._contentType || getContentType(this.getHeaders());
+      if(contentType?.startsWith("text/html")) {
+        if(this._wrappedTransformHtml && typeof this._wrappedTransformHtml === "function") {
+          result = this._wrappedTransformHtml(result);
+          // uncompressed size: https://github.com/w3c/ServiceWorker/issues/339
+          this.setHeader("Content-Length", Buffer.byteLength(result));
+        }
+      }
+
+      for(let headers of this._wrappedHeaders) {
+        this._wrappedOriginalWriteHead(...headers);
+      }
+
+      this._writeCache = [];
+      this._wrappedOriginalWrite(result, encoding)
+      return this._wrappedOriginalEnd(callback);
+    } else {
+      // Buffer or Uint8Array
+      for(let headers of this._wrappedHeaders) {
+        this._wrappedOriginalWriteHead(...headers);
+      }
+
+      if(data) {
+        this._wrappedOriginalWrite(data, encoding);
+      }
+      return this._wrappedOriginalEnd(callback);
+    }
+  }
+
+  return resp;
+}
+
+module.exports = wrapResponse;