Skip to content

Feature: Outline #24

@mkh-user

Description

@mkh-user

Feature Summary

Introduce an Outline panel that displays a structured view of the current file’s headings, sections, or symbols. This feature helps users navigate large documents or code files quickly and efficiently.

Motivation

In large files—whether code, Markdown, or configuration—scrolling manually to find a specific section is slow and error-prone. An Outline provides a high-level overview and enables fast navigation, improving productivity and reducing cognitive load.

Proposed Design

  • Parse the current file and extract structural elements by modes (e.g., headings, functions, classes, sections).
  • Display a tree in Outline panel with a hierarchical view of these elements.
  • Allow users to click on items to jump to the corresponding line.
  • Support dynamic updates as the file changes.
  • Optionally highlight the current section based on cursor position.

Acceptance Criteria

  • Outline displays relevant structural elements for supported file types.
  • Users can navigate to sections by clicking items in the Outline.
  • Outline updates in real-time as the file is edited.
  • Show "Outline is not available" as fallback.
  • Does not interfere with editor performance or layout.

Related Issues / Discussions

Nothing

Implementation Notes (Optional)

  • Use modes for structure detection.
  • Consider caching parsed structure for performance.
  • Allow customization of which elements appear in the Outline (e.g., hide private functions).

Localization & Accessibility

  • Ensure Outline panel is keyboard-navigable.

Community Feedback (Optional)

Nothing

Metadata

Metadata

Assignees

Labels

action scriptsOfficial action scripts or action scripts featuresfeature: NavigationImproves movement across UI sections, files, or project structure

Projects

Status

Completed

Relationships

None yet

Development

No branches or pull requests

Issue actions