CodeEditApp / CodeEditApp/CodeEditSourceEditor

✨ Line Annotations

Đang mở
#297 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
Ngôn ngữ chính
Swift
Star
719
Fork
160
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Mô tả

### Description

Implement the visual display system for Line Annotations in the source editor. These annotations should appear directly beneath relevant lines of code and visually communicate messages such as errors, warnings, or informational notes.

### Requirements

- Add support for displaying annotations below lines in the source editor
- An annotation should include:
- A severity icon (error, warning, info)
- A short descriptive message
- Multiple annotations should be stackable if they occur on the same line
- Styling should reflect severity (e.g., color, icon)
- Annotations should update cleanly when the underlying data model changes (insert, remove, update)
- Annotations should avoid disrupting layout:
- Automatically shrink if needed to preserve line spacing.
- If the message is truncated, allow users to click the annotation to reveal a popover with the full message.
- This popover should scroll with the editor and remain positioned relative to its line.
- If the line scrolls out of view and the annotation is expanded, the popover should remain visible—docked to the top or bottom edge of the editor—until dismissed.

### Implementation Details

- The expanded popover view (when multiple annotations exist or a message is truncated) may be called AnnotationAggregatedDropdownView, similar to what is used in other macOS editors.
- The source editor (`CodeEditSourceEditor`) will accept a new property:
```swift
annotations: Set
```
- LineAnnotation is a lightweight data model that represents a message to display beneath a specific line:
```swift
struct LineAnnotation: Hashable, Identifiable {
let id: UUID = UUID()
let line: Int
let column: Int
let severity: Severity
let text: String
}

enum Severity {
case error, warning, info, live
}
```
- The editor should group annotations by line internally and render them accordingly.

### Additional Context

This is the foundational work for visual feedback in the editor. Future issues will introduce the system for feeding issues into the annotations (e.g., from builds, linters, or language servers) via an issue manager.

This feature is a key part of improving the editing experience by surfacing issues contextually, and sets the stage for deeper diagnostic and development tooling integration.

### Related Issues

- https://github.com/CodeEditApp/CodeEdit/issues/354

### Screenshots

Warning
image

Warning Expanded
image

Error
image

Multiple Errors
image

Multiple Errors Expanded
image

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Đánh giá

Issue này chưa được đánh giá.

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.