From d31186a325dd1e1506385009bb04e3b7994b7297 Mon Sep 17 00:00:00 2001
From: Simon Ser <contact@emersion.fr>
Date: Thu, 5 Jun 2025 17:58:07 +0200
Subject: [PATCH] output-management: add port_path and device_tag

See:

- https://gitlab.freedesktop.org/emersion/libdisplay-info/-/merge_requests/188
- https://gitlab.freedesktop.org/wlroots/wlroots/-/merge_requests/3979
---
 .../wlr-output-management-unstable-v1.xml     | 54 +++++++++++++++++--
 1 file changed, 49 insertions(+), 5 deletions(-)

diff --git a/unstable/wlr-output-management-unstable-v1.xml b/unstable/wlr-output-management-unstable-v1.xml
index a8f4718..d314fe1 100644
--- a/unstable/wlr-output-management-unstable-v1.xml
+++ b/unstable/wlr-output-management-unstable-v1.xml
@@ -39,7 +39,7 @@
     interface version number is reset.
   </description>
 
-  <interface name="zwlr_output_manager_v1" version="4">
+  <interface name="zwlr_output_manager_v1" version="5">
     <description summary="output device configuration manager">
       This interface is a manager that allows reading and writing the current
       output device configuration.
@@ -125,7 +125,7 @@
     </event>
   </interface>
 
-  <interface name="zwlr_output_head_v1" version="4">
+  <interface name="zwlr_output_head_v1" version="5">
     <description summary="output device">
       A head is an output device. The difference between a wl_output object and
       a head is that heads are advertised even if they are turned off. A head
@@ -370,9 +370,53 @@
       </description>
       <arg name="state" type="uint" enum="adaptive_sync_state"/>
     </event>
+
+    <!-- Version 5 additions -->
+
+    <event name="port_path">
+      <description summary="port path">
+        This event describes a stable port path for the head.
+
+        The port is an arbitrary string identifying the port of the head, ie.
+        the physical connector the head is connected to. The port must be
+        stable across reboots and software upgrades, thus must not contain
+        runtime-allocated numbers (such as KMS connector names). The port must
+        be globally unique for the Wayland connection.
+
+        This event is optional and might not be sent, e.g. if the head is
+        virtual or if the compositor doesn't have enough information to provide
+        a stable port path for this head.
+
+        If sent, the make event is sent after a wlr_output_head object is
+        created and only sent once per object. The port path does not change
+        over the lifetime of the wlr_output_head object.
+      </description>
+      <arg name="port_path" type="string"/>
+    </event>
+
+    <event name="device_tag">
+      <description summary="device tag">
+        This event describes a stable device tag for the head.
+
+        The device tag is an arbitrary string identifying the device the head
+        represents. The device tag must be stable across reboots and software
+        upgrades, thus must not contain e.g. data coming from manufacturer code
+        databases. The device tag is not unique: two heads may share the same
+        device tag. Compositors should do their best to avoid collisions as
+        much as possible.
+
+        This event is optional and might not be sent, e.g. if the head is
+        virtual or if the compositor doesn't have enough information to provide
+        a stable device tag for this head.
+
+        If sent, the make event is sent after a wlr_output_head object is
+        created and only sent once per object. The device tag does not change
+        over the lifetime of the wlr_output_head object.
+      </description>
+    </event>
   </interface>
 
-  <interface name="zwlr_output_mode_v1" version="3">
+  <interface name="zwlr_output_mode_v1" version="5">
     <description summary="output mode">
       This object describes an output mode.
 
@@ -427,7 +471,7 @@
     </request>
   </interface>
 
-  <interface name="zwlr_output_configuration_v1" version="4">
+  <interface name="zwlr_output_configuration_v1" version="5">
     <description summary="output configuration">
       This object is used by the client to describe a full output configuration.
 
@@ -545,7 +589,7 @@
     </request>
   </interface>
 
-  <interface name="zwlr_output_configuration_head_v1" version="4">
+  <interface name="zwlr_output_configuration_head_v1" version="5">
     <description summary="head configuration">
       This object is used by the client to update a single head's configuration.