GitHub - AndrewMason7/PandyEditor: A professional iOS code editor featuring smooth syntax highlighting, line numbers, and minimap. Built with safety and performance first.

🐼 Pandy Editor

A professional-grade, high-performance code editor component for iOS
Engineered to Strict FiveKit Compliance

📖 Overview

Pandy Editor is not just a UITextView wrapper. It is a fully engineered code editing environment built on the FiveKit architecture.

Why "Pandy"?

🐼 Gentle - Won't crash, even with malformed input
🐼 Calm - Smooth 120Hz scrolling, no UI stutter
🐼 Cuddly - Friendly, easy to integrate

Core Principles

Principle	Implementation
Lag Prevention	View Diffing + Viewport Optimization
Crash Prevention	Safety Quadruple (4-layer guards)
Thread Safety	Main thread UI, background computation
Expressive Code	FiveKit syntax (`.negated`, `text[i]`)

✨ Key Features

⚡️ FiveKit Engineered

ProMotion Optimized: Uses "View Diffing" to minimize layer updates during typing and scrolling, ensuring buttery smooth performance on 120Hz devices.
Safety Quadruple: All UI operations are protected by four layers of safety guards (Feature Flag, Window Check, Thread Safety, Layout Validity).
FoundationPlus: Built using expressive, safe syntax (.negated, String.empty, text[i]) provided via FiveKit export.
Branch Dependency: FiveKit uses branch: "main"

🚀 Performance Optimizations

Viewport-Based Highlighting: Syntax colors are only applied to the visible range + 50% buffer. A 10,000-line file only highlights ~50 lines at a time.
Bracket Matching Cache: Cursor position is cached to avoid O(n) re-scans when the cursor hasn't moved.
Atomic Text Versioning: Rapid keystrokes invalidate stale background work, preventing race conditions.
Regex Caching: Patterns are compiled once per language, reused forever.
Large File Protection: Files >150K characters gracefully degrade to plain text.

🛠 Editor Capabilities

Syntax Highlighting: Real-time highlighting for 11 languages (Swift, Python, JS, TS, Go, Rust, SQL, HTML, CSS, JSON, Plain Text).
Line Numbers: Integrated, synchronized gutter with O(log n) binary search.
Minimap: Scaled, clickable code overview with background rendering.
Bracket Matching: Rainbow brackets with intelligent matching.
Current Line Highlight: Subtle background highlight for better orientation.
Keyboard Toolbar: Language-specific quick keys with cursor glide.
Rich Theming: 9 professionally tuned themes (5 Dark + 4 Light).

📦 Installation

Add the following to your Package.swift dependencies:

dependencies: [
    .package(url: "https://github.com/AndrewMason7/PandyEditor.git", branch: "main"),
]

🚀 Usage

SwiftUI (Recommended)

Use the PandyEditor wrapper for a seamless SwiftUI experience:

import PandyEditor

struct ContentView: View {
    @State private var code = "func hello() {}"
    
    var body: some View {
        PandyEditor(text: $code, language: .swift, theme: .oneDarkPro)
            .showLineNumbers(true)
            .showMinimap(true)
            .edgesIgnoringSafeArea(.all)
    }
}

UIKit (Advanced)

The EditorView manages its own subcomponents (Line Numbers, Highlight Views). Just instantiate and configure:

import PandyEditor

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()

        // 1. Create the editor
        let editor = EditorView()
        editor.frame = view.bounds
        editor.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        
        // 2. Configure Syntax & Theme
        editor.setLanguage(.swift)
        editor.setTheme(.oneDarkPro)
        
        // 3. Enable Features
        editor.showLineNumbers = true
        editor.showMinimap = true
        editor.showCurrentLineHighlight = true
        editor.showBracketMatching = true
        
        // 4. Set Content
        editor.text = """
        func greet() {
            print("Hello, Pandy Editor! 🐼")
        }
        """
        
        view.addSubview(editor)
    }
}

🎨 Available Themes

Dark Themes:

Theme	Style
`.oneDarkPro`	VS Code inspired (Default)
`.modernDark`	Premium Blue/Slate
`.githubDark`	GitHub style
`.dracula`	Classic purple/pink
`.catppuccinMocha`	Pastel dark

Light Themes:

Theme	Style
`.githubLight`	GitHub style
`.xcodeLight`	Apple classic
`.atomOneLight`	Atom-inspired
`.solarizedLight`	Low contrast

💻 Supported Languages

Language	Extensions	Quick Keys
Plain Text	`.txt`, `.md`	Generic punctuation
Swift	`.swift`	`func`, `guard`, `let`, `->`
JavaScript	`.js`, `.jsx`, `.mjs`	`const`, `=>`, `function`
TypeScript	`.ts`, `.tsx`	`interface`, `type`, `async`
Python	`.py`, `.pyw`	`def`, `class`, `self`
Go	`.go`	`func`, `:=`, `chan`, `defer`
Rust	`.rs`	`fn`, `mut`, `impl`, `match`
SQL	`.sql`	`SELECT`, `FROM`, `WHERE`
HTML	`.html`, `.htm`	`<`, `>`, `div`, `class`
CSS	`.css`, `.scss`	`px`, `rem`, `!important`
JSON	`.json`	`true`, `false`, `null`

🏗 Architecture

The project follows the FiveKit Modular Pattern:

PandyEditor/
├── Sources/PandyEditor/
│   ├── Editor/                     # Core Components
│   │   ├── PandyEditor.swift           # SwiftUI Wrapper ("Harmony File")
│   │   ├── EditorView.swift            # Main Class Definition
│   │   ├── EditorView+API.swift        # Public API & User Controls
│   │   ├── EditorView+Bracket.swift    # Bracket Matching
│   │   ├── EditorView+Keyboard.swift   # Keyboard & Toolbar Delegation
│   │   ├── EditorView+Layout.swift     # Layout & Rendering
│   │   ├── EditorView+Setup.swift      # Initialization
│   │   ├── LineNumberView.swift        # Gutter (O(log n) lookup)
│   │   ├── MinimapView.swift           # Code Overview
│   │   ├── KeyboardToolbarView.swift   # Quick Keys & Cursor Glide
│   │   ├── Syntax/                     # Highlighting Engine
│   │   │   ├── EditorView+Syntax.swift     # Text Change Handling
│   │   │   ├── SyntaxHighlighter.swift     # Two-Phase Optimizer
│   │   │   └── SyntaxLanguages.swift       # 11 Language Definitions
│   │   └── UI/
│   │       └── ToolbarKeyCell.swift    # Keyboard Quick Key Cell
│   ├── Theme/                      # Visual System
│   │   ├── CodeEditorTheme.swift       # Registry & Core
│   │   ├── CodeEditorTheme+Dark.swift  # 5 Dark Themes
│   │   └── CodeEditorTheme+Light.swift # 4 Light Themes
│   ├── Utilities/                  # Safety & Extensions
│   │   ├── CrashGuard.swift            # Safety Quadruple Utilities
│   │   ├── Validator.swift             # Input Validation
│   │   └── Extensions/                 # Safe Type Extensions
│   │       ├── Array+Safe.swift            # Safe subscripting [safe:]
│   │       ├── String+Safe.swift           # Safe character access
│   │       ├── Data+Safe.swift
│   │       ├── URL+Safe.swift
│   │       └── FileManager+Safe.swift
│   └── Resources/
│       └── icon.jpg                    # Bundled Asset
└── Tests/PandyEditorTests/
    └── PandyEditorTests.swift          # Unit Tests

🔄 Highlighting Pipeline

┌─────────────────────────────────────────────────────────────┐
│                 PANDY EDITOR SYNTAX ENGINE                  │
├─────────────────────────────────────────────────────────────┤
│  PHASE 1: Global Context Scan (Full Document)               │
│  ├── Find all Strings  ───────────────────────► [ranges]    │
│  ├── Find all Comments ───────────────────────► [ranges]    │
│  └── Resolve Overlaps (First match wins)                    │
├─────────────────────────────────────────────────────────────┤
│  PHASE 2: Viewport Optimization                              │
│  ├── Calculate Visible Range + 50% Buffer                   │
│  └── Skip attribute application for off-screen ranges       │
├─────────────────────────────────────────────────────────────┤
│  PHASE 3: Keyword Scan (Visible Code Gaps Only)             │
│  ├── Find Keywords  ──────────────────────────► [color]     │
│  ├── Find Numbers   ──────────────────────────► [color]     │
│  └── Find Functions ──────────────────────────► [color]     │
└─────────────────────────────────────────────────────────────┘

🐑 Thank You

Special thanks to FiveSheep Co. for creating and maintaining:

FiveKit - The foundation this editor is built upon
FoundationPlus - Expressive Swift extensions that make code readable
SwiftUIElements - SwiftUI utilities

Their work on developer tooling has made this project possible.

Check out the their extraordinary Mister Keyboard on the App Store — The infinitely customizable keyboard.

🐼 Credits

Built with ❤️

"Gentle. Calm. Cuddly."