feat(web): add web generator

Author: avivkeller

.prettierignore

@@ -1,3 +1,9 @@
 # Tests files
 src/generators/api-links/__tests__/fixtures/
 *.snapshot
+
+# Templates
+src/generators/web/template.html
+
+# Output
+out/

codecov.yml

@@ -16,3 +16,7 @@ coverage:
 ignore:
   - 'eslint.config.mjs'
   - '**/fixtures/'
+  # These are browser-specific implementations
+  - 'src/generators/legacy-html/assets'
+  # These components have been tested in `nodejs/nodejs.org`
+  - 'src/generators/web/client'

eslint.config.mjs

@@ -1,17 +1,34 @@
 import pluginJs from '@eslint/js';
+import { defineConfig } from 'eslint/config';
 import importX from 'eslint-plugin-import-x';
 import jsdoc from 'eslint-plugin-jsdoc';
+import react from 'eslint-plugin-react';
 import globals from 'globals';
 
-export default [
+export default defineConfig([
   pluginJs.configs.recommended,
   importX.flatConfigs.recommended,
   {
     ignores: ['out/', 'src/generators/api-links/__tests__/fixtures/'],
   },
   {
-    files: ['**/*.mjs'],
+    files: ['**/*.{mjs,jsx}'],
+    plugins: {
+      jsdoc,
+      react,
+    },
+    languageOptions: {
+      ecmaVersion: 'latest',
+      parserOptions: {
+        ecmaFeatures: {
+          jsx: true,
+        },
+      },
+      globals: { ...globals.nodeBuiltin },
+    },
     rules: {
+      'react/jsx-uses-react': 'error',
+      'react/jsx-uses-vars': 'error',
       'import-x/namespace': 'off',
       'import-x/no-named-as-default': 'off',
       'import-x/no-named-as-default-member': 'off',
@@ -34,18 +51,6 @@ export default [
           },
         },
       ],
-    },
-  },
-  {
-    files: ['src/**/*.mjs', 'bin/**/*.mjs'],
-    plugins: {
-      jsdoc: jsdoc,
-    },
-    languageOptions: {
-      ecmaVersion: 'latest',
-      globals: { ...globals.nodeBuiltin },
-    },
-    rules: {
       'jsdoc/check-alignment': 'error',
       'jsdoc/check-indentation': 'error',
       'jsdoc/require-jsdoc': [
@@ -74,7 +79,18 @@ export default [
     },
   },
   {
-    files: ['src/generators/legacy-html/assets/*.js'],
-    languageOptions: { globals: { ...globals.browser } },
+    files: [
+      'src/generators/legacy-html/assets/*.js',
+      'src/generators/web/client/**/*',
+    ],
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        // SERVER and CLIENT denote server-only and client-only
+        // codepaths in our web generator
+        CLIENT: 'readonly',
+        SERVER: 'readonly',
+      },
+    },
   },
-];
+]);