Merge branch 'main' into main

.eslintrc.json

@@ -20,8 +20,9 @@
     "prettier",
     "react-hooks",
     "import",
-    "vitest",
-    "eslint-plugin-react-compiler"
+    "@vitest",
+    "eslint-plugin-react-compiler",
+    "testing-library"
   ],
   "parser": "@typescript-eslint/parser",
   "parserOptions": {
@@ -50,10 +51,6 @@
     "@typescript-eslint/no-use-before-define": "off",
     "@typescript-eslint/no-empty-function": "off",
     "@typescript-eslint/no-explicit-any": "off",
-    "vitest/consistent-test-it": [
-      "error",
-      { "fn": "it", "withinDescribe": "it" }
-    ],
     "import/namespace": "off",
     "import/named": "off",
     "import/order": [
@@ -109,10 +106,19 @@
   },
   "overrides": [
     {
+      "extends": [
+        "plugin:testing-library/react",
+        "plugin:@vitest/legacy-recommended"
+      ],
       "files": ["tests/**/*.ts", "tests/**/*.tsx"],
       "rules": {
         "import/extensions": ["error", "never"],
-        "@typescript-eslint/no-unused-vars": "off"
+        "@typescript-eslint/no-unused-vars": "off",
+        "@vitest/expect-expect": "off",
+        "@vitest/consistent-test-it": [
+          "error",
+          { "fn": "it", "withinDescribe": "it" }
+        ]
       }
     },
     {

docs/extensions/immer.mdx

@@ -84,7 +84,7 @@ Check this example with withImmer:
 This hook takes an atom and replaces the atom's `writeFunction` with the new immer-like `writeFunction` like the previous helpers.
 
 ```jsx
-import { useAtom } from 'jotai'
+import { atom } from 'jotai'
 import { useImmerAtom } from 'jotai-immer'
 
 const primitiveAtom = atom({ value: 0 })

docs/extensions/location.mdx

@@ -23,6 +23,9 @@ atomWithLocation(options): PrimitiveAtom
 
 `atomWithLocation` creates a new atom that links to `window.location`.
 
+Typically, you should only instantiate `atomWithLocation` once per application. This is because changes made to one instance might not be reflected in others.
+As this atom is designed to synchronize with the `window.location` object, using multiple instances can lead to unpredictable behavior.
+
 ### Parameters
 
 **options** (optional): an object of options to customize the behavior of the atom

package.json

@@ -138,6 +138,7 @@
     "@typescript-eslint/eslint-plugin": "^8.9.0",
     "@typescript-eslint/parser": "^8.9.0",
     "@vitest/coverage-v8": "^2.1.3",
+    "@vitest/eslint-plugin": "^1.1.7",
     "@vitest/ui": "^2.1.3",
     "benny": "^3.7.1",
     "downlevel-dts": "^0.11.0",
@@ -150,7 +151,7 @@
     "eslint-plugin-react": "^7.37.1",
     "eslint-plugin-react-compiler": "0.0.0-experimental-fa06e2c-20241014",
     "eslint-plugin-react-hooks": "^5.0.0",
-    "eslint-plugin-vitest": "^0.5.4",
+    "eslint-plugin-testing-library": "^6.4.0",
     "jest-leak-detector": "^29.7.0",
     "jsdom": "^25.0.1",
     "json": "^11.0.0",