CodeEditApp / CodeEditApp/CodeEditSourceEditor

✨ Code Folding

Open
#43 8 comments 7 reactions 1 assignee Claimed by @thecoolwinter View on GitHub
editor enhancement UI
Dominant language
Swift
Stars
719
Forks
160
PR merge metrics
No merged PRs in 30d

Description

### Description

Code folding allows developers to collapse and expand sections of code (such as functions, classes, conditionals, and comments) to reduce visual clutter and focus on the parts they’re working on. This feature is particularly useful when navigating large files or deeply nested structures.

### Proposed Behavior

- Enable folding for code blocks such as:
- Functions and methods
- Classes and structs
- Loops and conditionals
- Multi-line comments and regions
- Display a vertical folding ribbon in the gutter next to line numbers, where users can click to collapse or expand blocks.
- Collapsed blocks should show an inline indicator with an expand toggle.
- Optionally, include editor commands for fold all / unfold all.

### Implementation Notes

- Can be powered by the existing Tree-sitter syntax trees to determine foldable ranges based on code structure.
- Should maintain fold state across file/tab switches and ideally across sessions.
- Folding ribbon interactions should be smooth and intuitive, with hover states and visual cues.
- Should add animation for folding and unfolding to make transitions feel natural and responsive.

### Benefits

- Reduces visual noise and helps maintain focus while editing.
- Makes it easier to navigate and manage large files.
- Provides a cleaner overview of structural code layout.

### Additional Context

The folding ribbon provides a familiar and discoverable UI for interacting with folded sections and complements keyboard or menu-based folding commands.

### Screenshots

https://user-images.githubusercontent.com/47652746/164981601-56c531e4-9420-4d46-96d7-f9d8456e5821.mov

Additional Screenshots

Screen Shot 2022-04-24 at 8 30 03 AM

Hover:
Screen Shot 2022-04-24 at 8 31 04 AM

Clicked (folded code):
Screen Shot 2022-04-24 at 8 31 40 AM

dark and light mode:
imgonline-com-ua-twotoone-0btV6nX2OfPxYH

### In Progress TODOs

- [x] Fold Ribbon
- [x] Draw nested folds
- [x] Draw adjacent folds with a horizontal line (instead of overlapping rounded edges)
- [x] Draw folded ranges
- [x] Fold Model
- [x] Generate folds from a provider for a document
- [x] Update folds as a document is edited
- [ ] Fold Providers
- [x] Line indent provider
- [ ] TreeSitter provider
- [ ] Perform Folding
- [x] Draw text attachment for fold range
- [ ] Animate folded text

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.