Panama/config/dot/quickshell/modules/dock/DockBody.qml

// The visible dock bar: the rounded translucent pill, its items, and the
// tooltip that floats above it.
//
// Kept separate from Dock.qml so it can be dropped straight into a
// FloatingWindow for testing — PanelWindow cannot map without layer shell.

import Quickshell
import Quickshell.Hyprland
import QtQuick
import qs.config
import qs.widgets

Rectangle {
    id: root

    // ── Model ───────────────────────────────────────────────────────────────
    // One pass over the live toplevel list produces the whole dock: pinned
    // apps first in Settings order, then anything else that is running.
    // Entries are plain JS objects: { entry, windows, appId }.
    readonly property var items: {
        // DesktopEntries is scanned asynchronously at startup, and byId() is a
        // plain method call that creates no binding dependency. Reading the
        // model here is what makes the dock fill in once the scan lands.
        if (DesktopEntries.applications.values.length === 0)
            return [];

        const groups = {};   // appId -> [HyprlandToplevel]
        const order = [];    // appIds in first-seen order

        const toplevels = Hyprland.toplevels.values;
        for (let i = 0; i < toplevels.length; i++) {
            const t = toplevels[i];
            // `wayland` is null until Hyprland reports the address, and it is
            // the only live source of an app id — there is no `class` property.
            const appId = t.wayland ? t.wayland.appId : "";
            if (!appId)
                continue;
            if (!groups[appId]) {
                groups[appId] = [];
                order.push(appId);
            }
            groups[appId].push(t);
        }

        const out = [];
        const claimed = {};

        const pinned = Settings.dockPinned;
        for (let i = 0; i < pinned.length; i++) {
            const entry = DesktopEntries.byId(pinned[i]);
            // A pin that no longer resolves is dropped rather than drawn as a
            // broken icon.
            if (!entry)
                continue;

            let windows = [];
            for (let j = 0; j < order.length; j++) {
                if (!claimed[order[j]] && root.matches(order[j], entry, pinned[i])) {
                    claimed[order[j]] = true;
                    windows = windows.concat(groups[order[j]]);
                }
            }
            out.push({
                entry: entry,
                windows: windows,
                appId: pinned[i]
            });
        }

        for (let i = 0; i < order.length; i++) {
            const appId = order[i];
            if (claimed[appId])
                continue;
            out.push({
                entry: DesktopEntries.heuristicLookup(appId),
                windows: groups[appId],
                appId: appId
            });
        }

        return out;
    }

    // Wayland app ids and desktop entry ids agree often but not always
    // (`org.gnome.Nautilus` vs `nautilus`, `Steam` vs `steam`), so compare the
    // usual candidates case-insensitively and fall back to the last
    // reverse-DNS segment.
    function matches(appId: string, entry: var, pinId: string): bool {
        const a = appId.toLowerCase();
        if (a === pinId.toLowerCase())
            return true;
        if (entry.id && a === entry.id.toLowerCase())
            return true;
        if (entry.startupClass && a === entry.startupClass.toLowerCase())
            return true;

        const tail = a.split(".").pop();
        return tail === pinId.toLowerCase().split(".").pop();
    }

    // ── Appearance ──────────────────────────────────────────────────────────
    radius: Theme.dockRadius
    color: Theme.alpha(Theme.bgPanel, Theme.dockAlpha)
    border.width: 0 // QTBUG-137166: rounded translucent rects lose their corners

    // The prism edge — see widgets/PrismEdge.qml.
    PrismEdge {
        anchors.top: parent.top
        anchors.left: parent.left
        anchors.right: parent.right
        inset: parent.radius
    }

    implicitWidth: strip.implicitWidth + Theme.dockPadding * 2
    implicitHeight: strip.implicitHeight + Theme.dockPadding * 2

    // The item the tooltip is currently describing, or null.
    property Item hoveredItem: null

    // Set by the Dock. A side dock runs the same strip down the screen instead
    // of across it.
    property bool vertical: false

    // Which way a tooltip points on a side dock: away from the screen edge, so
    // it never opens off-screen.
    property bool leftSide: true

    // Explicit rather than left to Grid's wrapping. This is always one line, so
    // saying how many cells it holds is both simpler to read and immune to
    // Grid's default column count quietly wrapping a long dock.
    readonly property int cellCount: 2 + (root.items ? root.items.length : 0)

    // A Grid rather than a Row so one declaration serves both orientations.
    // Row and Column would each need their own children, and the cross-axis
    // anchors that centre items in a Row (verticalCenter) are the wrong axis in
    // a Column -- Grid centres through its own alignment properties instead,
    // which is the same result without the anchors positioners disallow.
    Grid {
        id: strip
        anchors.centerIn: parent
        spacing: Theme.dockGap
        rows: root.vertical ? root.cellCount : 1
        columns: root.vertical ? 1 : root.cellCount
        horizontalItemAlignment: Grid.AlignHCenter
        verticalItemAlignment: Grid.AlignVCenter

        ShowAppsButton {
            id: showApps
            onEntered: root.hoveredItem = showApps
            onExited: if (root.hoveredItem === showApps)
                root.hoveredItem = null
        }

        // Separator between the launcher and the apps, as in GNOME's dash. It
        // turns with the dock: a hairline across a column, down a row.
        Rectangle {
            width: root.vertical ? Theme.dockIconSize * 0.7 : 1
            height: root.vertical ? 1 : Theme.dockIconSize * 0.7
            border.width: 0
            color: Theme.alpha(Theme.fg, 0.14)
        }

        Repeater {
            model: root.items

            DockItem {
                id: dockItem
                required property var modelData
                app: modelData
                onEntered: root.hoveredItem = dockItem
                onExited: if (root.hoveredItem === dockItem)
                    root.hoveredItem = null
            }
        }
    }

    // ── Tooltip ─────────────────────────────────────────────────────────────
    // Styled like widgets/Popover.qml. Deliberately outside the dock's bounds
    // (negative y): it renders fine there, and the dock's input mask does not
    // cover it, so it can never swallow a click.
    Rectangle {
        id: tooltip

        readonly property string text: root.hoveredItem ? root.hoveredItem.label : ""

        visible: opacity > 0
        opacity: root.hoveredItem && tipLabel.text ? 1 : 0

        Behavior on opacity {
            NumberAnimation {
                duration: Theme.durFast
            }
        }

        // Centred on the hovered item along the dock's own axis, and placed just
        // outside the edge it lives on. Reads the item's position directly
        // (rather than mapToItem) so the binding re-evaluates when the strip
        // reflows.
        x: {
            if (!root.hoveredItem)
                return 0;
            if (root.vertical)
                return root.leftSide ? root.width + 8 : -width - 8;
            const centre = strip.x + root.hoveredItem.x + root.hoveredItem.width / 2;
            return Math.max(4, Math.min(root.width - width - 4, centre - width / 2));
        }
        y: {
            if (!root.hoveredItem)
                return -height - 8;
            if (!root.vertical)
                return -height - 8;
            const centre = strip.y + root.hoveredItem.y + root.hoveredItem.height / 2;
            return Math.max(4, Math.min(root.height - height - 4, centre - height / 2));
        }

        width: tipLabel.implicitWidth + Theme.popoverPadding * 2
        height: tipLabel.implicitHeight + 8

        radius: Theme.popoverRadius
        color: Theme.alpha(Theme.bgPopover, Theme.popoverAlpha)
        border.width: 1
        border.color: Theme.alpha(Theme.fg, 0.08)

        Text {
            id: tipLabel
            anchors.centerIn: parent
            text: tooltip.text
            color: Theme.fg
            font.family: Theme.fontFamily
            font.pixelSize: Theme.fontSize
        }
    }
}