Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@ set(TREELAND_PROTOCOL_DDE_XML_FILES
dde/treeland-active-notify-unstable-v1.xml
dde/treeland-region-watch-unstable-v1.xml
dde/treeland-activation-token-unstable-v1.xml
dde/treeland-dock-unstable-v1.xml
)

# Internal protocol XML files (Treeland-specific, not for general app developers)
Expand Down
1 change: 1 addition & 0 deletions dde/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ For DDE desktop components. Installed via `TREELAND_PROTOCOL_DDE_XML_FILES`.
| `treeland-active-notify-unstable-v1.xml` | `treeland_active_notify_unstable_v1` | `treeland_active_notify_manager_v1`, `treeland_active_notify_v1` | Seat activity notification: observe pointer button/wheel enter/leave activity and drag/drop lifecycle events scoped to a seat |
| `treeland-region-watch-unstable-v1.xml` | `treeland_region_watch_unstable_v1` | `treeland_region_watch_manager_v1`, `treeland_region_watch_v1` | Edge-anchored region overlap watch: register an edge-anchored region on an output and observe enter/leave overlap events with xdg-shell toplevels |
| `treeland-activation-token-unstable-v1.xml` | `treeland_activation_token_unstable_v1` | `treeland_activation_token_manager_v1`, `treeland_activation_token_v1` | Privileged xdg-activation-v1 token source for the DDE application manager: mint an activation token for an application it is about to launch; the compositor only checks the caller identity |
| `treeland-dock-unstable-v1.xml` | `treeland_dock_unstable_v1` | `treeland_dock_manager_v1`, `treeland_dock_v1`, `treeland_dock_hold_v1` | Compositor-managed dock: report the user's visibility mode, which outputs arm the edge wake-up strip, per-interaction holds that block automatic hiding, and forced visibility for conditions the compositor cannot observe such as the launcher; receive the target visibility and the output whose edge the pointer woke. The compositor owns the show/hide animation, edge wake-up, the smart-hide overlap watch, the multitask-overview override, and the reserved area derived from the mode |
| `treeland-dde-shell-unstable-v2.xml` | `treeland_dde_shell_unstable_v2` | `treeland_dde_shell_manager_v2`, `treeland_dde_shell_surface_v2` | DDE shell surface role: turn a wl_surface into a shell surface rendered at the workspace overlay level (above normal toplevels, below layer-shell surfaces) or at the normal window layer, suggest an initial position relative to an output or the cursor, and declare switcher/dock-preview/multitask-view listing preferences via a skip bitfield |

## Breaking changes
Expand Down
1 change: 1 addition & 0 deletions dde/README.zh_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@
| `treeland-active-notify-unstable-v1.xml` | `treeland_active_notify_unstable_v1` | `treeland_active_notify_manager_v1`、`treeland_active_notify_v1` | Seat 活跃通知:订阅按 Seat 限定的指针按键/滚轮进入/离开活跃状态及拖拽/放下的生命周期事件 |
| `treeland-region-watch-unstable-v1.xml` | `treeland_region_watch_unstable_v1` | `treeland_region_watch_manager_v1`、`treeland_region_watch_v1` | 沿输出边缘的区域重叠监控:注册锚定输出边缘的区域并订阅与 xdg-shell 顶层窗口重叠/解除重叠的 enter/leave 事件 |
| `treeland-activation-token-unstable-v1.xml` | `treeland_activation_token_unstable_v1` | `treeland_activation_token_manager_v1`、`treeland_activation_token_v1` | 面向 DDE 应用管理器的特权 xdg-activation-v1 token 来源:为即将拉起的应用铸造 token,合成器只校验调用方身份 |
| `treeland-dock-unstable-v1.xml` | `treeland_dock_unstable_v1` | `treeland_dock_manager_v1`、`treeland_dock_v1`、`treeland_dock_hold_v1` | 由合成器接管 Dock 显隐:客户端上报用户显示模式、哪些输出装边缘唤出条带、阻止自动隐藏的交互 hold,以及合成器无法观测的强制显示条件(启动器);接收目标可见状态与指针触发唤出的输出。显隐动画、边缘唤出、智能隐藏重叠监控、多任务视图覆盖、以及按模式推导的预留区域均由合成器负责 |
| `treeland-dde-shell-unstable-v2.xml` | `treeland_dde_shell_unstable_v2` | `treeland_dde_shell_manager_v2`、`treeland_dde_shell_surface_v2` | DDE Shell surface 角色:将 wl_surface 转为在工作区 overlay 层(高于普通顶层窗口、低于 layer-shell surface)或普通窗口层渲染的 shell surface,建议相对输出或光标的初始位置,并通过 skip 位域声明任务切换器/dock 预览/多任务视图的列表偏好 |

## 破坏性变更
Expand Down
Loading
Loading