SourceCodeView.h

Go to the documentation of this file.

/*$!{
* Aurora Clang AST Viewer (ACAV)
* 
* Copyright (c) 2026 Min Liu
* Copyright (c) 2026 Michael David Adams
* 
* SPDX-License-Identifier: GPL-2.0-or-later
* 
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
* 
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
* GNU General Public License for more details.
* 
* You should have received a copy of the GNU General Public License along
* with this program; if not, see <https://www.gnu.org/licenses/>.
}$!*/

#pragma once
 
#include "common/FileManager.h"
#include "core/SourceLocation.h"
#include <QPlainTextEdit>
#include <QPoint>
#include <QString>
#include <QSyntaxHighlighter>
#include <QTextCursor>
#include <QTextDocument>
 
namespace acav {
 
class LineNumberArea;  // Forward declaration

class SourceCodeView : public QPlainTextEdit {
  Q_OBJECT
 
public:
  explicit SourceCodeView(QWidget *parent = nullptr);
  ~SourceCodeView() override = default;

  bool loadFile(const QString &filePath);

  void clearView();

  void applyFontSize(int pointSize);

  QString currentFilePath() const { return currentFilePath_; }

  FileID currentFileId() const { return currentFileId_; }

  void setCurrentFileId(FileID fileId) { currentFileId_ = fileId; }

  void highlightRange(const SourceRange &range, bool moveCursor = true);

  void clearHighlight();

  bool findNext(const QString &term,
                QTextDocument::FindFlags flags = QTextDocument::FindFlags());

  bool findPrevious(
      const QString &term,
      QTextDocument::FindFlags flags = QTextDocument::FindFlags());

  void clearSearchHighlight();

  int lineNumberAreaWidth() const;

  void lineNumberAreaPaintEvent(QPaintEvent *event);
 
signals:
  void fileLoaded(const QString &filePath);

  void fileLoadError(const QString &errorMessage);

  void sourcePositionClicked(FileID fileId, unsigned line, unsigned column);

  void sourceRangeSelected(FileID fileId, unsigned startLine,
                           unsigned startColumn, unsigned endLine,
                           unsigned endColumn);
 
protected:
  void resizeEvent(QResizeEvent *event) override;

  void mousePressEvent(QMouseEvent *event) override;

  void mouseReleaseEvent(QMouseEvent *event) override;

  void keyPressEvent(QKeyEvent *event) override;
 
private slots:
  void updateLineNumberAreaWidth(int newBlockCount);

  void updateLineNumberArea(const QRect &rect, int dy);

  void highlightCurrentLine();
 
private:
  QString currentFilePath_;
  FileID currentFileId_ = FileManager::InvalidFileID;
  LineNumberArea *lineNumberArea_;  // Owned via Qt parent-child
  QSyntaxHighlighter *keywordHighlighter_ = nullptr; // Owned by document
  QTextEdit::ExtraSelection navigationHighlight_;  // Stores AST navigation highlight
  QTextEdit::ExtraSelection searchHighlight_; // Stores search match highlight
  QTextCursor searchCursor_;
  QString lastSearchTerm_;
  bool suppressCursorSignal_ = false;
  bool mouseSelectionActive_ = false;
 
  void setupEditor();
  void updateHighlights();  // Update all highlights (navigation, etc.)
  bool performFind(const QString &term, QTextDocument::FindFlags flags);
  void setSearchHighlight(const QTextCursor &cursor);
  void emitCursorPosition();
  void emitSelectionRange();
 
  int pressSelectionStart_ = 0;
  int pressSelectionEnd_ = 0;
  QPoint pressMousePos_;
};
 
} // namespace acav