Merge branch 'source' into governance-tooling

Author: sarahxsanders

.eslintrc.cjs

@@ -5,7 +5,15 @@ const MARKDOWN_EXT = "md,mdx"
 
 module.exports = {
   root: true,
-  plugins: ["@graphql-eslint", "mdx", "@typescript-eslint", "tailwindcss"],
+  plugins: [
+    "@graphql-eslint",
+    "mdx",
+    "@typescript-eslint",
+    "tailwindcss",
+    "react",
+    "@next/next",
+    "react-hooks",
+  ],
   overrides: [
     {
       files: [`**/*.{${CODE_EXT}}`],
@@ -14,33 +22,67 @@ module.exports = {
         "plugin:@typescript-eslint/recommended",
         "plugin:tailwindcss/recommended",
         "prettier",
+        "plugin:@next/next/recommended",
+        "plugin:react-hooks/recommended-legacy",
+        "plugin:react/recommended",
       ],
       rules: {
-        "tailwindcss/classnames-order": "off",
-        "@typescript-eslint/no-restricted-imports": [
-          "error",
+        "react/react-in-jsx-scope": "off", // TS checks this
+        "react/prop-types": "off", // and this
+        "no-undef": "off", // and this too
+        // This is type checking for projects without `@types/react`. Disabled due to false positives.
+        "react/no-unknown-property": "off",
+
+        "react/no-unescaped-entities": [
+          "warn", // quotes and apostrophes are okay
           {
-            paths: [
+            forbid: [
               {
-                name: "next/image",
-                message: "Please use `next-image-export-optimizer` instead",
-                allowTypeImports: true,
+                char: "<",
+                alternatives: ["&lt;"],
+              },
+              {
+                char: ">",
+                alternatives: ["&gt;"],
+              },
+              {
+                char: "{",
+                alternatives: ["&#123;"],
+              },
+              {
+                char: "}",
+                alternatives: ["&#125;"],
               },
             ],
           },
         ],
+        "@next/next/no-img-element": "off", // straight up upsell, small `img`s actually don't need optimization
+
+        "tailwindcss/classnames-order": "off",
         "prefer-const": ["error", { destructuring: "all" }],
         "prefer-rest-params": "off",
         "@typescript-eslint/no-explicit-any": "off",
         "@typescript-eslint/no-unused-vars": "off",
         "@typescript-eslint/ban-ts-comment": "off",
         "@typescript-eslint/no-var-requires": "off",
         "@typescript-eslint/ban-types": "off",
+        "no-restricted-syntax": [
+          "error",
+          {
+            selector:
+              "JSXElement[openingElement.name.name=/^(Image|NextImage)$/]:not(:has(JSXAttribute[name.name='placeholder']))",
+            message:
+              "Pass `placeholder: 'empty' | 'blur'` when calling <Image> or <NextImage>.",
+          },
+        ],
       },
       settings: {
         tailwindcss: {
           whitelist: ["roboto-mono"],
         },
+        react: {
+          version: "detect",
+        },
       },
     },
     {
@@ -63,6 +105,8 @@ module.exports = {
       },
       rules: {
         "mdx/remark": "error",
+        "no-unused-expressions": "off",
+        "react/jsx-no-undef": "off",
       },
     },
     {
@@ -90,7 +134,9 @@ module.exports = {
     {
       files: [
         `src/pages/blog/**/*.{${MARKDOWN_EXT}}`,
+        `src/pages/graphql-js/running-an-express-graphql-server.mdx`,
         `src/code/**/*.{${MARKDOWN_EXT}}`,
+        `src/app/conf/**/*.{${MARKDOWN_EXT}}`,
       ],
       rules: {
         // Disable `remark-lint-first-heading-level` since in blogs we don't want to enforce the first heading to be an `h1`

.github/workflows/check.yml

@@ -0,0 +1,80 @@
+name: lint & test
+
+on: pull_request
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: the-guild-org/shared-config/setup@main
+        name: setup env
+        with:
+          packageManager: pnpm
+          workingDirectory: ./
+
+      - name: Install Dependencies
+        run: pnpm i
+
+      - name: Run ESLint
+        run: pnpm lint --quiet
+
+      - name: Run Prettier Check
+        run: pnpm format:check
+
+      - name: Validate code snippets
+        run: pnpm validate:snippets
+
+  unit-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: the-guild-org/shared-config/setup@main
+        name: setup env
+        with:
+          packageManager: pnpm
+          workingDirectory: ./
+
+      - name: Install Dependencies
+        run: pnpm i
+
+      - name: Run unit tests
+        run: pnpm test:unit
+
+  playwright:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: the-guild-org/shared-config/setup@main
+        name: setup env
+        with:
+          packageManager: pnpm
+          workingDirectory: ./
+
+      - name: Install Dependencies
+        run: pnpm i
+
+        # per the docs: "caching browser binaries is not recommended,
+        # since the amount of time it takes to restore the cache is
+        # comparable to the time it takes to download the binaries"
+      - name: Install Playwright Browsers
+        run: ./node_modules/.bin/playwright install --with-deps
+
+      - name: Build the website
+        run: pnpm build
+
+      - name: Run end-to-end tests
+        run: ./node_modules/.bin/playwright test
+
+      - uses: actions/upload-artifact@v4
+        if: ${{ !cancelled() }}
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 30
+
+      # - uses: valeriangalliat/action-sshd-cloudflared@v1
+      #   if: failure()

.github/workflows/conference-sync.yml

@@ -0,0 +1,26 @@
+# Sched's API rate limits are very limited, so we sync non-critical part of the data on a cron.
+on:
+  workflow_dispatch:
+  # schedule:
+  # - cron: "*/10 * * * *" # every ten minutes
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Sync conference data from Sched
+        run: |
+          tsx scripts/sync-sched/sync.ts --year 2025
+        env:
+          SCHED_ACCESS_TOKEN_2025: ${{ secrets.SCHED_ACCESS_TOKEN_2025 }}
+
+      - name: Commit changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          file_pattern: "scripts/sync-sched/*.json"
+          commit_message: "Sync conference data from Sched"

.github/workflows/docs-validation.yml

@@ -61,3 +61,9 @@ src/__generated__/
 .next/
 public/sitemap.xml
 out/
+
+tsconfig.tsbuildinfo
+
+playwright-report/
+
+.pnpm-store/

.github/workflows/prettier.yml

@@ -1 +1 @@
-22.12.0
+22.21.1

.gitignore

@@ -4,4 +4,9 @@ pnpm-lock.yaml
 !src/pages/blog/2024-04-11-announcing-new-graphql-website/index.mdx
 !src/pages/blog/2024-08-15-graphql-local-initiative.mdx
 !src/pages/community/foundation/community-grant.mdx
+!src/pages/blog/2025-05-31-graphiql-4/index.mdx
+!src/pages/blog/2025-06-10-graphiql-5/index.mdx
+!src/pages/blog/2025-06-19-multioption-inputs-with-oneof/index.mdx
 *.jpg
+
+scripts/**/*.json

.node-version

@@ -9,5 +9,14 @@
   "[typescript]": {
     "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
-  "tailwindCSS.classFunctions": ["clsx"]
+  "tailwindCSS.classFunctions": ["clsx"],
+  "files.associations": {
+    "*.css": "tailwindcss"
+  },
+  "editor.quickSuggestions": {
+    "strings": "on"
+  },
+  "typescript.preferences.autoImportFileExcludePatterns": [
+    "**/node_modules/lucide-react"
+  ]
 }