noctalia-shell/Modules/MainScreen/SmartPanel.qml

import QtQuick
import Quickshell
import qs.Commons
import qs.Services.UI


/**
 * SmartPanel - Wrapper that creates placeholder + content window
 *
 * This component is a thin wrapper that maintains backward compatibility
 * while splitting panel rendering into:
 * 1. PanelPlaceholder (in MainScreen, for background rendering)
 * 2. SmartPanelWindow (separate window, for content)
 */
Item {
  id: root

  // PUBLIC API - unchanged for backward compatibility

  // Screen property provided by MainScreen
  property ShellScreen screen: null

  // Panel content: Text, icons, etc...
  property Component panelContent: null

  // Panel size properties
  property real preferredWidth: 700
  property real preferredHeight: 900
  property real preferredWidthRatio
  property real preferredHeightRatio
  property color panelBackgroundColor: Color.mSurface
  property color panelBorderColor: Color.mOutline
  property var buttonItem: null
  property bool forceAttachToBar: false

  // Anchoring properties
  property bool panelAnchorHorizontalCenter: false
  property bool panelAnchorVerticalCenter: false
  property bool panelAnchorTop: false
  property bool panelAnchorBottom: false
  property bool panelAnchorLeft: false
  property bool panelAnchorRight: false

  // Track if window has been created (for lazy loading)
  property bool windowCreated: false

  // Expose panel state (from content window)
  readonly property bool isPanelOpen: windowLoader.item ? windowLoader.item.isPanelOpen : false
  readonly property bool isPanelVisible: windowLoader.item ? windowLoader.item.isPanelVisible : false

  // Expose panelRegion for backward compatibility (MainScreen mask)
  readonly property var panelRegion: panelPlaceholder ? panelPlaceholder.panelItem : null

  // Signals
  signal opened
  signal closed

  // Keyboard event handlers - these can be overridden by panel implementations
  function onEscapePressed() {
    if (windowLoader.item)
      windowLoader.item.handleEscapePressed()
  }
  function onTabPressed() {
    if (windowLoader.item)
      windowLoader.item.handleTabPressed()
  }
  function onShiftTabPressed() {
    if (windowLoader.item)
      windowLoader.item.handleShiftTabPressed()
  }
  function onUpPressed() {
    if (windowLoader.item)
      windowLoader.item.handleUpPressed()
  }
  function onDownPressed() {
    if (windowLoader.item)
      windowLoader.item.handleDownPressed()
  }
  function onLeftPressed() {
    if (windowLoader.item)
      windowLoader.item.handleLeftPressed()
  }
  function onRightPressed() {
    if (windowLoader.item)
      windowLoader.item.handleRightPressed()
  }
  function onReturnPressed() {
    if (windowLoader.item)
      windowLoader.item.handleReturnPressed()
  }
  function onHomePressed() {
    if (windowLoader.item)
      windowLoader.item.handleHomePressed()
  }
  function onEndPressed() {
    if (windowLoader.item)
      windowLoader.item.handleEndPressed()
  }
  function onPageUpPressed() {
    if (windowLoader.item)
      windowLoader.item.handlePageUpPressed()
  }
  function onPageDownPressed() {
    if (windowLoader.item)
      windowLoader.item.handlePageDownPressed()
  }
  function onCtrlJPressed() {
    if (windowLoader.item)
      windowLoader.item.handleCtrlJPressed()
  }
  function onCtrlKPressed() {
    if (windowLoader.item)
      windowLoader.item.handleCtrlKPressed()
  }

  // Public control functions
  function toggle(buttonItem, buttonName) {
    // Ensure window is created before toggling
    if (!windowCreated) {
      windowCreated = true
      Qt.callLater(function () {
        if (windowLoader.item) {
          windowLoader.item.toggle(buttonItem, buttonName)
        }
      })
    } else if (windowLoader.item) {
      windowLoader.item.toggle(buttonItem, buttonName)
    }
  }

  function open(buttonItem, buttonName) {
    // Ensure window is created before opening
    if (!windowCreated) {
      windowCreated = true
      Qt.callLater(function () {
        if (windowLoader.item) {
          windowLoader.item.open(buttonItem, buttonName)
        }
      })
    } else if (windowLoader.item) {
      windowLoader.item.open(buttonItem, buttonName)
    }
  }

  function close() {
    if (windowLoader.item) {
      windowLoader.item.close()
    }
  }

  // Expose setPosition for panels that need to recalculate on settings changes
  function setPosition() {
    if (panelPlaceholder) {
      panelPlaceholder.setPosition()
    }
  }

  // INTERNAL IMPLEMENTATION

  // Create the panel placeholder (stays in MainScreen for background rendering)
  readonly property var panelPlaceholder: PanelPlaceholder {
    id: placeholder
    screen: root.screen
    panelName: root.objectName || "unnamed-panel"

    // Forward configuration properties
    preferredWidth: root.preferredWidth
    preferredHeight: root.preferredHeight
    preferredWidthRatio: root.preferredWidthRatio
    preferredHeightRatio: root.preferredHeightRatio
    forceAttachToBar: root.forceAttachToBar

    // Forward anchoring properties
    panelAnchorHorizontalCenter: root.panelAnchorHorizontalCenter
    panelAnchorVerticalCenter: root.panelAnchorVerticalCenter
    panelAnchorTop: root.panelAnchorTop
    panelAnchorBottom: root.panelAnchorBottom
    panelAnchorLeft: root.panelAnchorLeft
    panelAnchorRight: root.panelAnchorRight

    // Parent to MainScreen root
    parent: root.parent
  }

  // Lazy-load the content window (only created on first open)
  Loader {
    id: windowLoader
    active: root.windowCreated
    sourceComponent: SmartPanelWindow {
      placeholder: panelPlaceholder
      panelContent: root.panelContent
      panelWrapper: root // Pass reference to SmartPanel for keyboard handlers
      panelBackgroundColor: root.panelBackgroundColor
      panelBorderColor: root.panelBorderColor

      // Forward signals
      onPanelOpened: root.opened()
      onPanelClosed: root.closed()
    }
  }

  // Register with PanelService (backward compatibility)
  // Note: Registration happens in MainScreen after objectName is set
  Component.onCompleted: {
    // Use Qt.callLater to ensure objectName is set by parent before registering
    Qt.callLater(function () {
      if (!objectName) {
        Logger.w("SmartPanel", "Panel created without objectName - PanelService registration may fail")
      }
      PanelService.registerPanel(root)
    })
  }
}