Merge pull request #464 from hildjj/deprecate-old-browsers

Deprecate old browsers

docs/documentation.html

@@ -19,6 +19,9 @@ <h2 id="table-of-contents">Table of Contents</h2>
       <li><a href="#installation-browser">Browser</a></li>
     </ul>
   </li>
+  <li>
+    <a href="#supported-runtimes">Supported Runtimes</a>
+  </li>
   <li>
     <a href="#generating-a-parser">Generating a Parser</a>
     <ul>
@@ -104,6 +107,18 @@ <h3 id="installation-browser">Browser</h3>
 
 <p>When your document is done loading, there will be a global <code>peggy</code> object.</p>
 
+<h2 id="supported-runtimes">Supported Runtimes</h2>
+<p>Browsers and JS runtimes that pass the following
+  <a href="https://github.com/browserslist/browserslist#readme">Browserslist</a>
+  query at the time of release are supported:</p>
+  <pre><code>defaults, maintained node versions, not op_mini all</code></pre>
+
+  <p>Opera Mini can't be bothered to implement <code>URL</code> of all things,
+    so it's not worth our time to support.</p>
+  <p>Deno issues will be fixed if possible, but we are not currently testing on Deno.</p>
+  <p>All versions of Internet Explorer are <em>EXPLICITLY</em> unsupported,
+    for both generating and running generated parsers.</p>
+
 <h2 id="generating-a-parser">Generating a Parser</h2>
 
 <p>Peggy generates a parser from a grammar that describes the expected input

docs/package.json

@@ -14,6 +14,9 @@
   "devDependencies": {
     "@11ty/eleventy": "^2.0.1"
   },
+  "browserslist": [
+    "defaults, maintained node versions, not op_mini all"
+  ],
   "engines": {
     "node": ">=14"
   }

eslint.config.js

@@ -0,0 +1,60 @@
+"use strict";
+
+module.exports = [
+  {
+    ignores: [
+      "benchmark/**",
+      "build/**",
+      "docs/**",
+      "examples/*.js", // Testing examples
+      "node_modules/**",
+      "test/cli/fixtures/bad.js", // Intentionally-invalid
+      "test/cli/fixtures/imports_peggy.js", // Generated
+      "test/cli/fixtures/lib.js", // Generated
+      "test/vendor/**",
+    ],
+  },
+  {
+    ...require("@peggyjs/eslint-config/flat/js"),
+    ignores: [
+      "**/*.min.js",
+      "lib/parser.js", // Generated
+    ],
+  },
+  require("@peggyjs/eslint-config/flat/mjs"),
+  require("@peggyjs/eslint-config/flat/mocha"),
+  require("@peggyjs/eslint-config/flat/ts"),
+  {
+    ...require("@peggyjs/eslint-config/flat/modern"),
+    // All of these can use modern JS and node constructs
+    files: ["bin/*.js", "tools/**", "web-test/**"],
+  },
+  {
+    files: ["lib/peg.d.ts"],
+    rules: {
+      // Easier than fixing the hand-generated peg.d.ts
+      "no-unused-vars": "off",
+      "one-var": "off",
+      "no-use-before-define": "off",
+      "init-declarations": "off",
+      "@typescript-eslint/no-unused-vars": "off",
+      "@typescript-eslint/init-declarations": "off",
+      "@typescript-eslint/no-empty-interface": "off",
+      "@typescript-eslint/no-shadow": "off",
+      "@typescript-eslint/prefer-function-type": "off",
+    },
+  },
+  {
+    // Check these files for broad browser compatibility.
+    files: [
+      "**/*.min.js",
+      "lib/parser.js",
+    ],
+    plugins: {
+      compat: require("eslint-plugin-compat"),
+    },
+    rules: {
+      "compat/compat": "error",
+    },
+  },
+];