refactor(notification): move bubble overlay logic to QML delegate

1. Remove level property and overlay count tracking from BubbleItem and BubbleModel
2. Introduce BubbleDelegate.qml with visual folding effects (scale, y-offset, opacity) based on index
3. Simplify BubbleModel to use m_maxKeep limit instead of separate display/overlay counts
4. Add remove and removeDisplaced transitions for smooth disappearance animations
5. Consolidate NormalBubble.qml and OverlayBubble.qml into single Bubble.qml component
6. Add delayed hide (500ms) in BubblePanel to allow QML animations to complete

Log: Refactor notification bubble system to handle overlay visual effects in QML instead of C++ model

refactor(notification): 将气泡折叠逻辑移至 QML 代理组件

1. 移除 BubbleItem 和 BubbleModel 中的 level 属性及折叠计数追踪
2. 新增 BubbleDelegate.qml，根据索引实现视觉折叠效果（缩放、Y 偏移、透明度）
3. 简化 BubbleModel，使用 m_maxKeep 限制替代分离的显示/折叠计数
4. 添加 remove 和 removeDisplaced 过渡动画实现平滑消失效果
5. 合并 NormalBubble.qml 和 OverlayBubble.qml 为单一 Bubble.qml 组件
6. BubblePanel 添加 500ms 延迟隐藏，确保 QML 动画播放完成

Log: 重构通知气泡系统，将折叠视觉效果从 C++ 模型移至 QML 处理

PMS: BUG-355029

Author: mhduiy

frame/CMakeLists.txt

@@ -118,7 +118,7 @@ target_link_directories(dde-shell-frame INTERFACE
 
 if (BUILD_WITH_X11)
     target_compile_definitions(dde-shell-frame PRIVATE BUILD_WITH_X11)
-    pkg_check_modules(XCB REQUIRED IMPORTED_TARGET xcb-ewmh xcb-icccm xtst x11)
+    pkg_check_modules(XCB REQUIRED IMPORTED_TARGET xcb-ewmh xcb-icccm xtst xcb-shape x11)
     target_sources(dde-shell-frame PRIVATE layershell/x11dlayershellemulation.h layershell/x11dlayershellemulation.cpp)
     target_link_libraries(dde-shell-frame PRIVATE PkgConfig::XCB)
 endif(BUILD_WITH_X11)

frame/layershell/dlayershellwindow.cpp

@@ -43,6 +43,7 @@ class DLayerShellWindowPrivate
     int preferredWidth = -1;
     int preferredHeight = -1;
     bool closeOnDismissed = true;
+    QRegion inputRegion;
 };
 
 void DLayerShellWindow::setAnchors(DLayerShellWindow::Anchors anchors)
@@ -192,6 +193,29 @@ int DLayerShellWindow::preferredHeight() const
     return d->preferredHeight; 
 }
 
+void DLayerShellWindow::setInputRegion(const QRegion &region)
+{
+    if (d->inputRegion != region) {
+        d->inputRegion = region;
+        Q_EMIT inputRegionChanged();
+    }
+}
+
+void DLayerShellWindow::resetInputRegion()
+{
+    setInputRegion(QRegion());
+}
+
+QRegion DLayerShellWindow::inputRegion() const
+{
+    return d->inputRegion;
+}
+
+void DLayerShellWindow::setInputRegionRect(int x, int y, int width, int height)
+{
+    setInputRegion(QRegion(x, y, width, height));
+}
+
 bool DLayerShellWindow::closeOnDismissed() const
 {
     return d->closeOnDismissed;

frame/layershell/dlayershellwindow.h

@@ -30,6 +30,7 @@ class DS_SHARE DLayerShellWindow : public QObject
     Q_PROPERTY(ScreenConfiguration screenConfiguration READ screenConfiguration WRITE setScreenConfiguration)
     Q_PROPERTY(int preferredWidth READ preferredWidth WRITE setPreferredWidth RESET resetPreferredWidth NOTIFY geometryHintsChanged)
     Q_PROPERTY(int preferredHeight READ preferredHeight WRITE setPreferredHeight RESET resetPreferredHeight NOTIFY geometryHintsChanged)
+    Q_PROPERTY(QRegion inputRegion READ inputRegion WRITE setInputRegion RESET resetInputRegion NOTIFY inputRegionChanged)
 
     Q_PROPERTY(bool closeOnDismissed READ closeOnDismissed WRITE setCloseOnDismissed)
 
@@ -121,6 +122,12 @@ class DS_SHARE DLayerShellWindow : public QObject
     void resetPreferredHeight();
     int preferredHeight() const;
 
+    void setInputRegion(const QRegion &region);
+    void resetInputRegion();
+    QRegion inputRegion() const;
+    
+    Q_INVOKABLE void setInputRegionRect(int x, int y, int width, int height);
+
     /**
      * Sets a string based identifier for this window.
      * This may be used by a compositor to determine stacking
@@ -156,6 +163,7 @@ class DS_SHARE DLayerShellWindow : public QObject
     void layerChanged();
     void scopeChanged();
     void geometryHintsChanged();
+    void inputRegionChanged();
 
 private:
     DLayerShellWindow(QWindow* window);

frame/layershell/qwaylandlayershellsurface.cpp

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2023 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2023 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 
@@ -75,6 +75,13 @@ QWaylandLayerShellSurface::QWaylandLayerShellSurface(QtWayland::zwlr_layer_shell
         window->waylandSurface()->commit();
     });
 
+    auto applyInputRegion = [this, window]() {
+        window->window()->setMask(m_dlayerShellWindow->inputRegion());
+        window->waylandSurface()->commit();
+    };
+
+    connect(m_dlayerShellWindow, &DLayerShellWindow::inputRegionChanged, this, applyInputRegion);
+
     calcAndSetRequestSize(window->surfaceSize());
 
     if (m_requestSize.isValid()) {

frame/layershell/x11dlayershellemulation.cpp

@@ -17,6 +17,7 @@
 #include <xcb/xcb.h>
 #include <xcb/xcb_ewmh.h>
 #include <xcb/xcb_icccm.h>
+#include <xcb/shape.h>
 
 DS_BEGIN_NAMESPACE
 
@@ -71,6 +72,9 @@ LayerShellEmulation::LayerShellEmulation(QWindow* window, QObject *parent)
     onScopeChanged();
     connect(m_dlayerShellWindow, &DLayerShellWindow::scopeChanged, this, &LayerShellEmulation::onScopeChanged);
 
+    onInputRegionChanged();
+    connect(m_dlayerShellWindow, &DLayerShellWindow::inputRegionChanged, this, &LayerShellEmulation::onInputRegionChanged);
+
     // connect(m_dlayerShellWindow, &DS_NAMESPACE::DLayerShellWindow::keyboardInteractivityChanged, this, &LayerShellEmulation::onKeyboardInteractivityChanged);
 }
 
@@ -321,6 +325,41 @@ void LayerShellEmulation::onScopeChanged()
     qCDebug(layershell) << "Set WM_CLASS for window" << m_window->winId() << " wm_class:" << wmClassData;
 }
 
+void LayerShellEmulation::onInputRegionChanged()
+{
+    auto *x11Application = qGuiApp->nativeInterface<QNativeInterface::QX11Application>();
+    if (!x11Application || !m_window->winId() || !m_dlayerShellWindow) {
+        return;
+    }
+
+    if (m_dlayerShellWindow->inputRegion().isNull()) {
+        // Reset input region (no shape constraint)
+        xcb_shape_mask(x11Application->connection(), XCB_SHAPE_SO_SET, XCB_SHAPE_SK_INPUT, m_window->winId(), 0, 0, XCB_NONE);
+        xcb_flush(x11Application->connection());
+        return;
+    }
+
+    QRegion region = m_dlayerShellWindow->inputRegion();
+    qreal scaleFactor = qGuiApp->devicePixelRatio();
+
+    QVector<xcb_rectangle_t> rects;
+    for (const QRect &r : region) {
+        xcb_rectangle_t rect;
+        rect.x = r.x() * scaleFactor;
+        rect.y = r.y() * scaleFactor;
+        rect.width = r.width() * scaleFactor;
+        rect.height = r.height() * scaleFactor;
+        rects.append(rect);
+    }
+
+    // Set the input shape via XCB
+    // If rects vector is empty, the window will become completely transparent to input clicks (unclickable)
+    xcb_shape_rectangles(x11Application->connection(), XCB_SHAPE_SO_SET, XCB_SHAPE_SK_INPUT,
+                         XCB_CLIP_ORDERING_UNSORTED, m_window->winId(), 0, 0,
+                         rects.size(), rects.data());
+    xcb_flush(x11Application->connection());
+}
+
 // void X11Emulation::onKeyboardInteractivityChanged()
 // {
 //     // kwin no implentation on wayland

frame/layershell/x11dlayershellemulation.h

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2023 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2023 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 
@@ -28,6 +28,7 @@ private slots:
     void onPositionChanged();
     void onExclusionZoneChanged();
     void onScopeChanged();
+    void onInputRegionChanged();
     // void onKeyboardInteractivityChanged();
 
 private:

panels/notification/bubble/bubbleitem.cpp

@@ -282,19 +282,6 @@ void BubbleItem::updateActions()
     m_actions = array;
 }
 
-int BubbleItem::level() const
-{
-    return m_level;
-}
-
-void BubbleItem::setLevel(int level)
-{
-    if (m_level == level)
-        return;
-
-    m_level = level;
-    emit levelChanged();
-}
 
 QString BubbleItem::timeTip() const
 {

panels/notification/bubble/bubbleitem.h

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2024 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2024 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 
@@ -39,8 +39,6 @@ class BubbleItem : public QObject
     QVariantList actions() const;
     void updateActions();
 
-    int level() const;
-    void setLevel(int level);
 
     QString timeTip() const;
     void setTimeTip(const QString &timeTip);
@@ -51,15 +49,13 @@ class BubbleItem : public QObject
     bool isValid() const;
 
 signals:
-    void levelChanged();
     void timeTipChanged();
 
 private:
     QString displayText() const;
 
 private:
     NotifyEntity m_entity;
-    int m_level = 0;
     int m_urgency = NotifyEntity::Normal;
     QString m_timeTip;
     bool m_enablePreview = true;