protocols/swm-toplevel-v1.xml 1.6 KiB raw
1
<?xml version="1.0" encoding="UTF-8"?>
2
<protocol name="swm_toplevel_v1">
3
  <copyright>
4
    Copyright (C) 2026 swm contributors
5
6
    Permission to use, copy, modify, distribute, and sell this software and its
7
    documentation for any purpose is hereby granted without fee, provided that
8
    the above copyright notice and this permission notice appear in all copies.
9
10
    THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
11
    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
12
    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
13
    AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
14
    ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
15
    WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
16
  </copyright>
17
18
  <interface name="swm_toplevel_manager_v1" version="1">
19
    <description summary="activate swm toplevels">
20
      This interface activates mapped toplevels by the stable identifier from
21
      ext-foreign-toplevel-list-v1.
22
    </description>
23
24
    <enum name="error">
25
      <entry name="invalid_identifier" value="1" summary="the toplevel identifier does not exist"/>
26
    </enum>
27
28
    <request name="activate">
29
      <description summary="show and focus a toplevel">
30
        Show the toplevel's workspace on the selected output and focus it.
31
      </description>
32
      <arg name="identifier" type="string" summary="ext-foreign-toplevel-list identifier"/>
33
    </request>
34
35
    <request name="destroy" type="destructor">
36
      <description summary="destroy the manager object"/>
37
    </request>
38
  </interface>
39
</protocol>