Rename filterKey to globalFilter (#672)

* Rename

* rename types

* Throw an exception instead of aborting for invalid

* Add SharpLinkTo::withGlobalFilterValues() + test + doc

---------

Co-authored-by: antoine <[email protected]>

Author: dvlpp

docs/guide/link-to.md

@@ -118,6 +118,10 @@ Set a filter and its value; for the filter, you can either pass its custom key o
 
 Set a default sort.
 
+### `withGlobalFilterValues(array|string $globalFilterValues)`
+
+Set a global filter value(s). Ex: `LinkToShowPage::make(...)->withGlobalFilterValues($tenant->id)->renderAsUrl()`.
+
 ### `setFullQuerystring(array $querystring)`
 
 `LinkToEntityList` only

docs/guide/testing-with-sharp.md

@@ -118,9 +118,9 @@ it('allows the user to display a leaf form', function () {
 });
 ```
 
-#### `withSharpGlobalFilterKeys(array|string $filterKeys): self`
+#### `withSharpGlobalFilterValues(array|string $filterValues): self`
 
-You can specify the global filter keys to use in the Sharp context.
+You can specify the global filter values to use in the Sharp context.
 
 ```php
 it('allows the user to display a leaf form', function () {
@@ -129,7 +129,7 @@ it('allows the user to display a leaf form', function () {
 
     $this
         ->loginAsSharpUser($user)
-        ->withSharpGlobalFilterKeys($tenant->key)
+        ->withSharpGlobalFilterValues($tenant->id)
         ->getSharpForm(LeafEntity::class, 16)
         ->assertOk();
 });