Wrote documentation for find subviews.

Author: austincondiff

Sources/CodeEditSourceEditor/Find/PanelView/FindControls.swift

@@ -7,6 +7,17 @@
 
 import SwiftUI
 
+/// A SwiftUI view that provides the navigation controls for the find panel.
+///
+/// The `FindControls` view is responsible for:
+/// - Displaying previous/next match navigation buttons
+/// - Showing a done button to dismiss the find panel
+/// - Adapting button appearance based on match count
+/// - Supporting both condensed and full layouts
+/// - Providing tooltips for button actions
+///
+/// The view is part of the find panel's control section and works in conjunction with
+/// the find text field to provide navigation through search results.
 struct FindControls: View {
     @ObservedObject var viewModel: FindPanelViewModel
     var condensed: Bool

Sources/CodeEditSourceEditor/Find/PanelView/FindModePicker.swift

@@ -7,6 +7,17 @@
 
 import SwiftUI
 
+/// A SwiftUI view that provides a mode picker for the find panel.
+///
+/// The `FindModePicker` view is responsible for:
+/// - Displaying a dropdown menu to switch between find and replace modes
+/// - Managing the wrap around option for search
+/// - Providing a visual indicator (magnifying glass icon) for the mode picker
+/// - Adapting its appearance based on the control's active state
+/// - Handling mode selection and wrap around toggling
+///
+/// The view works in conjunction with the find panel to manage the current search mode
+/// and wrap around settings.
 struct FindModePicker: NSViewRepresentable {
     @Binding var mode: FindPanelMode
     @Binding var wrapAround: Bool

Sources/CodeEditSourceEditor/Find/PanelView/FindPanelContent.swift

@@ -7,6 +7,16 @@
 
 import SwiftUI
 
+/// A SwiftUI view that provides the main content layout for the find and replace panel.
+///
+/// The `FindPanelContent` view is responsible for:
+/// - Arranging the find and replace text fields in a vertical stack
+/// - Arranging the control buttons in a vertical stack
+/// - Handling the layout differences between find and replace modes
+/// - Supporting both full and condensed layouts
+///
+/// The view is designed to be used within `FindPanelView` and adapts its layout based on the
+/// available space and current mode (find or replace).
 struct FindPanelContent: View {
     @ObservedObject var viewModel: FindPanelViewModel
     @FocusState.Binding var focus: FindPanelView.FindPanelFocus?

Sources/CodeEditSourceEditor/Find/PanelView/FindPanelHostingView.swift

@@ -9,7 +9,18 @@ import SwiftUI
 import AppKit
 import Combine
 
-/// A subclass of `NSHostingView` that hosts a `FindPanelView` in an AppKit context.
+/// A subclass of `NSHostingView` that hosts the SwiftUI `FindPanelView` in an 
+/// AppKit context.
+///
+/// The `FindPanelHostingView` class is responsible for:
+/// - Bridging between SwiftUI and AppKit by hosting the FindPanelView
+/// - Managing keyboard event monitoring for the escape key
+/// - Handling the dismissal of the find panel
+/// - Providing proper view lifecycle management
+/// - Ensuring proper cleanup of event monitors
+///
+/// This class is essential for integrating the SwiftUI-based find panel into the AppKit-based
+/// text editor.
 final class FindPanelHostingView: NSHostingView<FindPanelView> {
     private weak var viewModel: FindPanelViewModel?
 

Sources/CodeEditSourceEditor/Find/PanelView/FindPanelView.swift

@@ -9,9 +9,23 @@ import SwiftUI
 import AppKit
 import CodeEditSymbols
 
+/// A SwiftUI view that provides a find and replace interface for the text editor.
+///
+/// The `FindPanelView` is the main container view for the find and replace functionality. It manages:
+/// - The find/replace mode switching
+/// - Focus management between find and replace fields
+/// - Panel height adjustments based on mode
+/// - Search text changes and match highlighting
+/// - Case sensitivity and wrap-around settings
+///
+/// The view automatically adapts its layout based on available space using `ViewThatFits`, providing
+/// both a full and condensed layout option.
 struct FindPanelView: View {
+    /// Represents the current focus state of the find panel
     enum FindPanelFocus: Equatable {
+        /// The find text field is focused
         case find
+        /// The replace text field is focused
         case replace
     }
 
@@ -67,6 +81,7 @@ struct FindPanelView: View {
     }
 }
 
+/// A preference key used to track the width of the find mode picker
 private struct FindModePickerWidthPreferenceKey: PreferenceKey {
     static var defaultValue: CGFloat = 0
     static func reduce(value: inout CGFloat, nextValue: () -> CGFloat) {

Sources/CodeEditSourceEditor/Find/PanelView/FindSearchField.swift

@@ -7,6 +7,17 @@
 
 import SwiftUI
 
+/// A SwiftUI view that provides the search text field for the find panel.
+///
+/// The `FindSearchField` view is responsible for:
+/// - Displaying and managing the find text input field
+/// - Showing the find mode picker (find/replace) in both condensed and full layouts
+/// - Providing case sensitivity toggle
+/// - Displaying match count information
+/// - Handling keyboard navigation (Enter to find next)
+///
+/// The view adapts its layout based on the `condensed` parameter, providing a more compact
+/// interface when space is limited.
 struct FindSearchField: View {
     @ObservedObject var viewModel: FindPanelViewModel
     @FocusState.Binding var focus: FindPanelView.FindPanelFocus?

Sources/CodeEditSourceEditor/Find/PanelView/ReplaceControls.swift

@@ -7,6 +7,17 @@
 
 import SwiftUI
 
+/// A SwiftUI view that provides the replace controls for the find panel.
+///
+/// The `ReplaceControls` view is responsible for:
+/// - Displaying replace and replace all buttons
+/// - Managing button states based on find text and match count
+/// - Adapting button appearance between condensed and full layouts
+/// - Providing tooltips for button actions
+/// - Handling replace operations through the view model
+///
+/// The view is only shown when the find panel is in replace mode and works in conjunction
+/// with the replace text field to perform text replacements.
 struct ReplaceControls: View {
     @ObservedObject var viewModel: FindPanelViewModel
     var condensed: Bool

Sources/CodeEditSourceEditor/Find/PanelView/ReplaceSearchField.swift

@@ -7,6 +7,16 @@
 
 import SwiftUI
 
+/// A SwiftUI view that provides the replace text field for the find panel.
+///
+/// The `ReplaceSearchField` view is responsible for:
+/// - Displaying and managing the replace text input field
+/// - Showing a visual indicator (pencil icon) for the replace field
+/// - Adapting its layout between condensed and full modes
+/// - Maintaining focus state for keyboard navigation
+///
+/// The view is only shown when the find panel is in replace mode and adapts its layout
+/// based on the `condensed` parameter to match the find field's appearance.
 struct ReplaceSearchField: View {
     @ObservedObject var viewModel: FindPanelViewModel
     @FocusState.Binding var focus: FindPanelView.FindPanelFocus?