first commit

.vscode/extensions.json

@@ -0,0 +1,29 @@
+{
+  "recommendations": [
+    // Linting / Formatting
+    "rust-lang.rust-analyzer",
+    "esbenp.prettier-vscode",
+    "dbaeumer.vscode-eslint",
+    "usernamehw.errorlens",
+    "ast-grep.ast-grep-vscode",
+    "tekumara.typos-vscode",
+
+    // Testing
+    "orta.vscode-jest",
+
+    // PR management / Reviewing
+    "github.vscode-pull-request-github",
+
+    // Showing todo comments
+    "gruntfuggly.todo-tree",
+
+    // Collaborating
+    "ms-vsliveshare.vsliveshare",
+
+    // Debugging
+    "ms-vscode.vscode-js-profile-flame",
+
+    // MDX Authoring
+    "unifiedjs.vscode-mdx"
+  ]
+}

.vscode/launch.json

@@ -0,0 +1,150 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "inputs": [
+    {
+      "id": "appDirname",
+      "type": "promptString",
+      "description": "Enter an app dirname from examples or test/e2e",
+      "default": "examples/hello-world"
+    },
+    {
+      "id": "nextCommand",
+      "type": "pickString",
+      "description": "Select the next command",
+      "options": ["dev", "build", "start"],
+      "default": "dev"
+    },
+    {
+      "id": "nextTestMode",
+      "type": "pickString",
+      "description": "Select the next test mode",
+      "options": ["dev", "start"],
+      "default": "dev"
+    }
+  ],
+  "configurations": [
+    {
+      "name": "Launch app",
+      "type": "node",
+      "request": "launch",
+      "cwd": "${workspaceFolder}",
+      "runtimeExecutable": "node",
+      "runtimeArgs": [
+        "packages/next/dist/bin/next",
+        "${input:nextCommand}",
+        "${input:appDirname}"
+      ],
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"],
+      "sourceMapPathOverrides": {
+        "webpack:///./*": "${workspaceFolder}/${input:appDirname}/*",
+        "webpack://_N_E/[.]/(app|pages)/(.*)": "${workspaceFolder}/${input:appDirname}/$1/$2",
+        "webpack://_N_E/[.]/(.*)": "${workspaceFolder}/${input:appDirname}/.next/server/$1",
+        "webpack-internal:///(ssr)/./*": "${workspaceFolder}/${input:appDirname}/*",
+        "webpack://(?:_N_E)?/(?:../)*src/(.*)": "${workspaceFolder}/packages/next/src/$1",
+        "webpack://next/./dist/src/*": "${workspaceFolder}/packages/next/src/*",
+        "webpack://next/./dist/compiled/*": "${workspaceFolder}/packages/next/src/compiled/*",
+        "webpack:///(?:../)*packages/next/dist/compiled/(.*)": "${workspaceFolder}/packages/next/src/compiled/$1",
+        "webpack://next/./src/*": "${workspaceFolder}/packages/next/src/*",
+        "webpack-internal:///\\(rsc\\)/(?:../)*packages/next/dist/(.*)": "${workspaceFolder}/packages/next/src/$1",
+        "webpack-internal:///(react-server)/./dist/compiled/*": "${workspaceFolder}/packages/next/src/compiled/*",
+        "turbopack:///[project]/*": "${workspaceFolder}/*"
+      },
+      "env": {
+        // Enable the following environment variables to use turbopack instead of webpack:
+        // "IS_TURBOPACK_TEST": "1",
+        "NEXT_PRIVATE_LOCAL_WEBPACK": "1",
+        "NEXT_PRIVATE_SKIP_CANARY_CHECK": "1",
+        "NEXT_TELEMETRY_DISABLED": "1"
+      }
+    },
+    {
+      "name": "Launch current directory",
+      "type": "node",
+      "request": "launch",
+      "cwd": "${workspaceFolder}",
+      "runtimeExecutable": "node",
+      "runtimeArgs": [
+        "packages/next/dist/bin/next",
+        "${input:nextCommand}",
+        "${fileDirname}"
+      ],
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"],
+      "sourceMapPathOverrides": {
+        "webpack:///./*": "${workspaceFolder}/${fileDirname}/*",
+        "webpack://_N_E/[.]/(app|pages)/(.*)": "${workspaceFolder}/${fileDirname}/$1/$2",
+        "webpack://_N_E/[.]/(.*)": "${workspaceFolder}/${fileDirname}/.next/server/$1",
+        "webpack-internal:///(ssr)/./*": "${workspaceFolder}/${fileDirname}/*",
+        "webpack://(?:_N_E)?/(?:../)*src/(.*)": "${workspaceFolder}/packages/next/src/$1",
+        "webpack://next/./dist/src/*": "${workspaceFolder}/packages/next/src/*",
+        "webpack://next/./dist/compiled/*": "${workspaceFolder}/packages/next/src/compiled/*",
+        "webpack:///(?:../)*packages/next/dist/compiled/(.*)": "${workspaceFolder}/packages/next/src/compiled/$1",
+        "webpack://next/./src/*": "${workspaceFolder}/packages/next/src/*",
+        "webpack-internal:///\\(rsc\\)/(?:../)*packages/next/dist/(.*)": "${workspaceFolder}/packages/next/src/$1",
+        "webpack-internal:///(react-server)/./dist/compiled/*": "${workspaceFolder}/packages/next/src/compiled/*",
+        "turbopack:///[project]/*": "${workspaceFolder}/*"
+      },
+      "env": {
+        "NEXT_PRIVATE_LOCAL_WEBPACK": "1",
+        "NEXT_PRIVATE_SKIP_CANARY_CHECK": "1",
+        "NEXT_TELEMETRY_DISABLED": "1"
+      }
+    },
+    {
+      "name": "Run e2e test",
+      "type": "node",
+      "request": "launch",
+      "cwd": "${workspaceFolder}",
+      "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/jest",
+      "runtimeArgs": ["--runInBand", "--verbose", "${file}"],
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"],
+      "sourceMapPathOverrides": {
+        "webpack:///./*": "${workspaceFolder}/${fileDirname}/*",
+        "webpack://_N_E/[.]/(app|pages)/(.*)": "${workspaceFolder}/${fileDirname}/$1/$2",
+        "webpack://_N_E/[.]/(.*)": "${workspaceFolder}/${fileDirname}/.next/server/$1",
+        "webpack-internal:///(ssr)/./*": "${workspaceFolder}/${fileDirname}/*",
+        "webpack://(?:_N_E)?/(?:../)*src/(.*)": "${workspaceFolder}/packages/next/src/$1",
+        "webpack://next/./dist/src/*": "${workspaceFolder}/packages/next/src/*",
+        "webpack://next/./dist/compiled/*": "${workspaceFolder}/packages/next/src/compiled/*",
+        "webpack:///(?:../)*packages/next/dist/compiled/(.*)": "${workspaceFolder}/packages/next/src/compiled/$1",
+        "webpack://next/./src/*": "${workspaceFolder}/packages/next/src/*",
+        "webpack-internal:///\\(rsc\\)/(?:../)*packages/next/dist/(.*)": "${workspaceFolder}/packages/next/src/$1",
+        "webpack-internal:///(react-server)/./dist/compiled/*": "${workspaceFolder}/packages/next/src/compiled/*",
+        "turbopack:///[project]/*": "${workspaceFolder}/*"
+      },
+      "env": {
+        "HEADLESS": "true",
+        "NEXT_E2E_TEST_TIMEOUT": "1000000",
+        "NEXT_SKIP_ISOLATE": "1",
+        "NEXT_TEST_MODE": "${input:nextTestMode}"
+      }
+    },
+    {
+      "name": "Launch app build trace jaeger",
+      "type": "node",
+      "request": "launch",
+      "cwd": "${workspaceFolder}",
+      "runtimeExecutable": "pnpm",
+      "runtimeArgs": ["clean-trace-jaeger"],
+      "skipFiles": ["<node_internals>/**"],
+      "env": {
+        "NEXT_PRIVATE_LOCAL_WEBPACK": "1"
+      }
+    },
+    {
+      "type": "node",
+      "request": "attach",
+      "name": "Attach to existing debugger",
+      "port": 9229,
+      "skipFiles": ["<node_internals>/**"],
+      "env": {
+        "NEXT_PRIVATE_LOCAL_WEBPACK": "1"
+      }
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,123 @@
+{
+  // Formatting using Prettier by default for all languages
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  // Formatting using Prettier for JavaScript, overrides VSCode default.
+  "[javascript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  // Formatting using Rust-Analyzer for Rust.
+  "[rust]": {
+    "editor.defaultFormatter": "rust-lang.rust-analyzer"
+  },
+  // Linting using ESLint.
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact"
+  ],
+  "eslint.useFlatConfig": true,
+  // Set Jest runMode to on-demand as otherwise it will start running all tests the first time.
+  // Equivalent to deprecated option "jest.autoRun": "off"
+  "jest.runMode": "on-demand",
+  // Debugging.
+  "debug.javascript.unmapMissingSources": true,
+  "files.exclude": {
+    "*[!test]**/node_modules": true
+  },
+  // Ensure enough terminal history is preserved when running tests.
+  "terminal.integrated.scrollback": 10000,
+  // Configure todo-tree to exclude node_modules, dist, and compiled.
+  "todo-tree.filtering.excludeGlobs": [
+    "**/node_modules",
+    "**/dist",
+    "**/compiled"
+  ],
+  // Match TODO-APP in addition to other TODOs.
+  "todo-tree.general.tags": [
+    "BUG",
+    "HACK",
+    "FIXME",
+    "TODO",
+    "XXX",
+    "[ ]",
+    "[x]",
+    "TODO-APP"
+  ],
+  "typescript.preferences.autoImportFileExcludePatterns": [
+    // templates reexport many things (see e.g. entry-base.ts), so they clutter import suggestions
+    "packages/next/src/build/templates/app-page.ts",
+    "packages/next/src/build/templates/app-route.ts",
+    "packages/next/src/build/templates/edge-app-route.ts",
+    "packages/next/src/build/templates/edge-ssr-app.ts",
+    "packages/next/src/build/templates/edge-ssr.ts",
+    "packages/next/src/build/templates/middleware.ts",
+    "packages/next/src/build/templates/pages-api.ts",
+    "packages/next/src/build/templates/pages-edge-api.ts",
+    "packages/next/src/build/templates/pages.ts",
+    "packages/next/src/server/app-render/entry-base.ts",
+    // singleton modules should always use "*.external" instead of "*-instance"
+    "packages/next/src/server/app-render/action-async-storage-instance.ts",
+    "packages/next/src/server/app-render/after-task-async-storage-instance.ts",
+    "packages/next/src/server/app-render/dynamic-access-async-storage-instance.ts",
+    "packages/next/src/server/app-render/work-async-storage-instance.ts",
+    "packages/next/src/server/app-render/work-unit-async-storage-instance.ts",
+    "packages/next/src/server/app-render/console-async-storage-instance.ts",
+    "packages/next/src/client/components/segment-cache-impl/*"
+  ],
+  // Disable TypeScript surveys.
+  "typescript.surveys.enabled": false,
+  // Enable file nesting for unit test files.
+  "explorer.fileNesting.enabled": true,
+  "explorer.fileNesting.patterns": {
+    "*.ts": "$(capture).test.ts, $(capture).test.tsx, $(capture).stories.tsx",
+    "*.tsx": "$(capture).test.ts, $(capture).test.tsx, $(capture).stories.tsx"
+  },
+  // Compile rust-analyzer in a separate directory to avoid conflicts with the main project.
+  "rust-analyzer.cargo.targetDir": true,
+  "rust-analyzer.server.extraEnv": {
+    "RUST_BACKTRACE": "0"
+  },
+  "cSpell.words": [
+    "codemod",
+    "codemods",
+    "Destructuring",
+    "buildtime",
+    "callsites",
+    "codemod",
+    "datastream",
+    "deduped",
+    "draftmode",
+    "Entrypoints",
+    "jscodeshift",
+    "napi",
+    "navigations",
+    "nextjs",
+    "opentelemetry",
+    "Preinit",
+    "prerendered",
+    "prerendering",
+    "proxied",
+    "renderable",
+    "revalidates",
+    "subresource",
+    "thenables",
+    "Threadsafe",
+    "Turbopack",
+    "unproxied",
+    "zipkin"
+  ],
+  "grammarly.selectors": [
+    {
+      "language": "markdown",
+      "scheme": "file"
+    }
+  ],
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "gitlens.advanced.blame.customArguments": [
+    "--ignore-revs-file",
+    "${workspaceRoot}/.git-blame-ignore-revs"
+  ],
+  "astGrep.serverPath": "node_modules/@ast-grep/cli/ast-grep",
+  "rust-analyzer.imports.prefix": "crate"
+}

.vscode/tasks.json

@@ -0,0 +1,31 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "types",
+      "command": "pnpm",
+      "args": ["typescript", "--watch"],
+      "isBackground": true,
+      "group": {
+        "kind": "build"
+      },
+      "problemMatcher": ["$tsc-watch"]
+    },
+    {
+      "label": "types-next",
+      "command": "pnpm",
+      "args": ["types", "--watch"],
+      "options": {
+        "cwd": "${workspaceFolder}/packages/next"
+      },
+      "isBackground": true,
+      "group": {
+        "kind": "build"
+      },
+      "problemMatcher": {
+        "base": "$tsc-watch",
+        "fileLocation": ["relative", "${workspaceFolder}/packages/next"]
+      }
+    }
+  ]
+}