From 1dbc0e3c88ba271ba35bc3f82e7864c4f35e1236 Mon Sep 17 00:00:00 2001
From: Fabien Proriol <fabien.proriol@kazoe.org>
Date: Sun, 25 May 2025 12:13:31 +0200
Subject: Initial Commit

---
 api/org.freedesktop.Notifications.xml         | 37 +++++++++++++
 api/org.freedesktop.StatusNotifierItem.xml    | 79 +++++++++++++++++++++++++++
 api/org.freedesktop.StatusNotifierWatcher.xml | 42 ++++++++++++++
 3 files changed, 158 insertions(+)
 create mode 100644 api/org.freedesktop.Notifications.xml
 create mode 100644 api/org.freedesktop.StatusNotifierItem.xml
 create mode 100644 api/org.freedesktop.StatusNotifierWatcher.xml

(limited to 'api')

diff --git a/api/org.freedesktop.Notifications.xml b/api/org.freedesktop.Notifications.xml
new file mode 100644
index 0000000..62345f2
--- /dev/null
+++ b/api/org.freedesktop.Notifications.xml
@@ -0,0 +1,37 @@
+<!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN" "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
+<node>
+  <interface name="org.freedesktop.Notifications">
+    <signal name="NotificationClosed">
+      <arg name="id" type="u" direction="out"/>
+      <arg name="reason" type="u" direction="out"/>
+    </signal>
+    <signal name="ActionInvoked">
+      <arg name="id" type="u" direction="out"/>
+      <arg name="action_key" type="s" direction="out"/>
+    </signal>
+    <method name="Notify">
+      <annotation name="org.qtproject.QtDBus.QtTypeName.In6" value="QVariantMap"/>
+      <arg type="u" direction="out"/>
+      <arg name="app_name" type="s" direction="in"/>
+      <arg name="replaces_id" type="u" direction="in"/>
+      <arg name="app_icon" type="s" direction="in"/>
+      <arg name="summary" type="s" direction="in"/>
+      <arg name="body" type="s" direction="in"/>
+      <arg name="actions" type="as" direction="in"/>
+      <arg name="hints" type="a{sv}" direction="in"/>
+      <arg name="timeout" type="i" direction="in"/>
+    </method>
+    <method name="CloseNotification">
+      <arg name="id" type="u" direction="in"/>
+    </method>
+    <method name="GetCapabilities">
+      <arg type="as" name="caps" direction="out"/>
+    </method>
+    <method name="GetServerInformation">
+      <arg type="s" name="name" direction="out"/>
+      <arg type="s" name="vendor" direction="out"/>
+      <arg type="s" name="version" direction="out"/>
+      <arg type="s" name="spec_version" direction="out"/>
+    </method>
+  </interface>
+</node>
diff --git a/api/org.freedesktop.StatusNotifierItem.xml b/api/org.freedesktop.StatusNotifierItem.xml
new file mode 100644
index 0000000..c425af6
--- /dev/null
+++ b/api/org.freedesktop.StatusNotifierItem.xml
@@ -0,0 +1,79 @@
+<!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN" "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
+<node>
+
+  <interface name="org.kde.StatusNotifierItem">
+    <!-- Based on https://www.freedesktop.org/wiki/Specifications/StatusNotifierItem/StatusNotifierItem/ -->
+
+    <property name="Category" type="s" access="read"/>
+    <property name="Id" type="s" access="read"/>
+    <property name="Title" type="s" access="read"/>
+    <property name="Status" type="s" access="read"/>
+    <property name="WindowId" type="i" access="read"/>
+    <property name="IconName" type="s" access="read" />
+
+    <!-- TODO: API not supported yet
+    <property name="IconPixmap" type="(iiay)" access="read">
+        <annotation name="org.qtproject.QtDBus.QtTypeName" value="XdgDbusImageVector"/>
+    </property>
+    -->
+
+    <property name="OverlayIconName" type="s" access="read"/>
+
+    <!-- TODO: API not supported yet
+    <property name="OverlayIconPixmap" type="(iiay)" access="read">
+        <annotation name="org.qtproject.QtDBus.QtTypeName" value="XdgDbusImageVector"/>
+    </property>
+    -->
+
+    <property name="AttentionIconName" type="s" access="read"/>
+
+    <!-- TODO: API not supported yet
+    <property name="AttentionIconPixmap" type="(iiay)" access="read">
+        <annotation name="org.qtproject.QtDBus.QtTypeName" value="XdgDbusImageVector"/>
+    </property>
+    -->
+
+    <property name="AttentionMovieName" type="s" access="read"/>
+
+
+    <!-- TODO: API not supported yet
+    org.freedesktop.StatusNotifierItem.ToolTip
+    org.freedesktop.StatusNotifierItem.ItemIsMenu
+    org.freedesktop.StatusNotifierItem.Menu
+    -->
+
+    <!-- TODO: API not supported yet
+    <method name="ContextMenu">
+        <arg name="x" type="i" direction="in"/>
+        <arg name="y" type="i" direction="in"/>
+    </method>
+    -->
+
+    <method name="Activate"> <!-- click -->
+        <arg name="x" type="i" direction="in"/>
+        <arg name="y" type="i" direction="in"/>
+    </method>
+
+    <method name="SecondaryActivate"> <!-- long press -->
+        <arg name="x" type="i" direction="in"/>
+        <arg name="y" type="i" direction="in"/>
+    </method>
+
+    <!-- TODO: API not supported yet
+    <method name="Scroll">
+      <arg name="delta" type="i" direction="in"/>
+      <arg name="orientation" type="s" direction="in"/>
+    </method>
+    -->
+
+    <signal name="NewTitle" />
+    <signal name="NewIcon" />
+    <signal name="NewAttentionIcon" />
+    <signal name="NewOverlayIcon" />
+    <signal name="NewToolTip" />
+    <signal name="NewStatus">
+      <arg name="status" type="s"/>
+    </signal>
+
+  </interface>
+</node>
diff --git a/api/org.freedesktop.StatusNotifierWatcher.xml b/api/org.freedesktop.StatusNotifierWatcher.xml
new file mode 100644
index 0000000..855af94
--- /dev/null
+++ b/api/org.freedesktop.StatusNotifierWatcher.xml
@@ -0,0 +1,42 @@
+<!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN" "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
+<node>
+    <interface name="org.kde.StatusNotifierWatcher">
+
+    <!-- methods -->
+    <method name="RegisterStatusNotifierItem">
+       <arg name="service" type="s" direction="in"/>
+    </method>
+
+    <method name="RegisterStatusNotifierHost">
+       <arg name="service" type="s" direction="in"/>
+    </method>
+
+
+    <!-- properties -->
+
+    <property name="RegisteredStatusNotifierItems" type="as" access="read">
+       <annotation name="org.qtproject.QtDBus.QtTypeName.Out0" value="QStringList"/>
+    </property>
+
+    <property name="IsStatusNotifierHostRegistered" type="b" access="read"/>
+
+    <property name="ProtocolVersion" type="i" access="read"/>
+
+
+    <!-- signals -->
+
+    <signal name="StatusNotifierItemRegistered">
+        <arg type="s"/>
+    </signal>
+
+    <signal name="StatusNotifierItemUnregistered">
+        <arg type="s"/>
+    </signal>
+
+    <signal name="StatusNotifierHostRegistered">
+    </signal>
+
+    <signal name="StatusNotifierHostUnregistered">
+    </signal>
+  </interface>
+</node>
-- 
cgit v1.2.3