feat: Remove support for global assertFunctionNames

BREAKING CHANGE: `assertFunctionNames` is now only available at the rule level

Author: mskelton

README.md

@@ -91,45 +91,19 @@ export default [
 }
 ```
 
-## Global Settings
+### Aliased Playwright Globals
 
-The plugin reads global settings from your ESLint configuration's shared data
-under the `playwright` key. It supports the following settings:
-
-- `additionalAssertFunctionNames`: an array of function names to treat as
-  assertion functions for the case of rules like `expect-expect`, which enforces
-  the presence of at least one assertion per test case. This allows such rules
-  to recognise custom assertion functions as valid assertions. The global
-  setting applies to all modules. The
-  [`expect-expect` rule accepts an option by the same name](https://github.com/playwright-community/eslint-plugin-playwright/tree/main/docs/rules/expect-expect.md#additionalassertfunctionnames)
-  to enable per-module configuration (.e.g, for module-specific custom assert
-  functions).
-
-You can configure these settings like so:
-
-[Flat config](https://eslint.org/docs/latest/use/configure/configuration-files-new)
-(**eslint.config.js**)
-
-```javascript
-export default [
-  {
-    settings: {
-      playwright: {
-        additionalAssertFunctionNames: ['assertCustomCondition'],
-      },
-    },
-  },
-];
-```
-
-[Legacy config](https://eslint.org/docs/latest/use/configure/configuration-files)
-(**.eslintrc**)
+If you import Playwright globals (e.g. `test`, `expect`) with a custom name, you
+can configure this plugin to be aware of these additional names.
 
 ```json
 {
   "settings": {
     "playwright": {
-      "additionalAssertFunctionNames": ["assertCustomCondition"]
+      "globalAliases": {
+        "test": ["myTest"],
+        "expect": ["myExpect"]
+      }
     }
   }
 }

docs/rules/expect-expect.md

@@ -35,38 +35,25 @@ test('should work with callbacks/async', async () => {
   "playwright/expect-expect": [
     "error",
     {
-      "additionalAssertFunctionNames": ["assertCustomCondition"]
+      "assertFunctionNames": ["assertCustomCondition"]
     }
   ]
 }
 ```
 
-### `additionalAssertFunctionNames`
+### `assertFunctionNames`
 
-An array of function names to treat as assertion functions. Only standalone
-functions are supported. Configure globally acceptable assert function names
-using [the global setting](../global-settings.md). You can also customize assert
-function names per-file. For example:
+This array option specifies the names of functions that should be considered to
+be asserting functions.
 
 ```ts
-/* eslint playwright/expect-expect: ["error", { "additionalAssertFunctionNames": ["assertScrolledToBottom"] }] */
+/* eslint playwright/expect-expect: ["error", { "assertFunctionNames": ["assertScrolledToBottom"] }] */
 
 function assertScrolledToBottom(page) {
   // ...
 }
 
-describe('scrolling', () => {
-  test('button click', async ({ page }) => {
-    // ...
-    await assertScrolledToBottom(page);
-  });
-
-  test('another way to scroll', async ({ page }) => {
-    // ...
-    await assertScrolledToBottom(page);
-  });
+test('should scroll', async ({ page }) => {
+  await assertScrolledToBottom(page);
 });
 ```
-
-The rule option and the global setting are merged. On a file level, both are
-considered.