feat: PresenceController - Added an optional name value which if prov…

…ided will be included in the presence event name so that other controllers can react to specific presence events if there are multiple in a given scope.

docs/docs/controllers/presence_controller.mdx

@@ -29,15 +29,16 @@ A utility controller to wire up other stimulus actions when an element comes int
 
 ## [Values](https://stimulus.hotwire.dev/reference/values)
 
-
-<NoValues/>
+| Value | Type | Description | Default |
+| --- | --- | --- | --- |
+| `name` (Optional) | String | If provided, the `presence` events will be prefixed with the given name i.e. `foo:presence:added`, to allow you to wire up other controllers based on specifically named presence events | - |
 
 ## Events
 
 | Event | When | Dispatched on | `event.detail` |
 | --- | --- | --- |--- |
-|`presence:added` | When the element enters the DOM | the controller root element | - |
-|`presence:removed` | When the element leaves the DOM | the controller root element | - |
+|`presence:added` / `${nameValue}:presence:added` | When the element enters the DOM | the controller root element | - |
+|`presence:removed` / `${nameValue}:presence:removed` | When the element leaves the DOM | the controller root element | - |
 
 ## Side Effects
 

src/controllers/utility/presence_controller.ts

@@ -2,12 +2,21 @@ import {BaseController} from "../../utilities/base_controller";
 
 export class PresenceController extends BaseController {
 
+  static values = {name: String};
+
+  declare nameValue: string;
+  declare readonly hasNameValue: boolean;
+
+  get name(): string {
+    return this.hasNameValue ? `${this.nameValue}:` : ``;
+  }
+
   connect() {
-    this.dispatch(this.el, "presence:added");
+    this.dispatch(this.el, `${this.nameValue}presence:added`);
   }
 
   disconnect() {
-    this.dispatch(this.el, "presence:removed");
+    this.dispatch(this.el, `${this.nameValue}presence:removed`);
   }
 
 }