d72b014d6d
* Add markdown viewer panel with live file watching Introduce a new PanelType.markdown that renders .md files in a dedicated panel using MarkdownUI (SwiftUI), with live file watching via DispatchSource so content auto-updates when the file changes on disk. - New MarkdownPanel class with file system watcher (write/delete/rename/extend) - New MarkdownPanelView with custom cmux theme (headings, code blocks, tables, blockquotes, inline code, lists, horizontal rules, light/dark mode) - Full workspace integration: SurfaceKind, creation methods, tab subscription - Session persistence: snapshot/restore across app restarts - V2 socket command: markdown.open (validates path, resolves workspace, splits) - CLI command: cmux markdown open <path> with routing flags and help text - Agent skill: skills/cmux-markdown/ with SKILL.md, openai.yaml, and references - Cross-link from skills/cmux/SKILL.md to the new markdown skill - SPM dependency: gonzalezreal/swift-markdown-ui 2.4.1 * Fix unreachable guard in markdown subcommand dispatch Use looksLikePath() to distinguish subcommands from path arguments so the guard can catch unknown subcommands and future subcommands are parsed correctly. * Use .isoLatin1 fallback instead of .ascii for encoding recovery ASCII is a strict subset of UTF-8, so falling back to .ascii after UTF-8 fails is dead code. Use .isoLatin1 which accepts all 256 byte values and covers legacy encodings like Windows-1252. * Mark fileWatchSource as nonisolated(unsafe) for deinit safety deinit is not guaranteed to run on the main actor, so accessing @MainActor-isolated storage is a data race under strict concurrency. DispatchSource.cancel() is thread-safe, so nonisolated(unsafe) is sufficient with a documented invariant that writes only occur on main. * Fix file watcher reattach: retry loop with cancellation guard - Replace one-shot 500ms retry with up to 6 attempts (3s total window) so files that reappear after a slow atomic replace are picked up - Add isClosed flag checked before each retry to prevent restarting the watcher after close()/deinit * Harden path validation in markdown.open command Reject directories and non-absolute paths before panel creation to prevent ambiguous behavior and generic downstream failures. * Always reattach file watcher on delete/rename events After an atomic save (delete old + create new), the DispatchSource still points to the old inode. Previously we only reattached when the file was unreadable, so successful atomic saves left the watcher on a stale inode and live updates silently stopped. Now we always stop and reattach: immediately if the new file is readable, via retry loop if not. * Restore markdown panels even when file is missing at launch MarkdownPanel already handles unavailable files gracefully (shows 'file unavailable' UI and retries via the reattach loop). Dropping the panel on restore lost the user's layout for files that may reappear shortly after (network drives, build artifacts, etc.). * Harden markdown CLI parsing and startup reconnect behavior --------- Co-authored-by: Lawrence Chen <54008264+lawrencecchen@users.noreply.github.com>
81 lines
2.1 KiB
Swift
81 lines
2.1 KiB
Swift
import Foundation
|
|
import Combine
|
|
|
|
/// Type of panel content
|
|
public enum PanelType: String, Codable, Sendable {
|
|
case terminal
|
|
case browser
|
|
case markdown
|
|
}
|
|
|
|
enum FocusFlashCurve: Equatable {
|
|
case easeIn
|
|
case easeOut
|
|
}
|
|
|
|
struct FocusFlashSegment: Equatable {
|
|
let delay: TimeInterval
|
|
let duration: TimeInterval
|
|
let targetOpacity: Double
|
|
let curve: FocusFlashCurve
|
|
}
|
|
|
|
enum FocusFlashPattern {
|
|
static let values: [Double] = [0, 1, 0, 1, 0]
|
|
static let keyTimes: [Double] = [0, 0.25, 0.5, 0.75, 1]
|
|
static let duration: TimeInterval = 0.9
|
|
static let curves: [FocusFlashCurve] = [.easeOut, .easeIn, .easeOut, .easeIn]
|
|
static let ringInset: Double = 6
|
|
static let ringCornerRadius: Double = 10
|
|
|
|
static var segments: [FocusFlashSegment] {
|
|
let stepCount = min(curves.count, values.count - 1, keyTimes.count - 1)
|
|
return (0..<stepCount).map { index in
|
|
let startTime = keyTimes[index]
|
|
let endTime = keyTimes[index + 1]
|
|
return FocusFlashSegment(
|
|
delay: startTime * duration,
|
|
duration: (endTime - startTime) * duration,
|
|
targetOpacity: values[index + 1],
|
|
curve: curves[index]
|
|
)
|
|
}
|
|
}
|
|
}
|
|
|
|
/// Protocol for all panel types (terminal, browser, etc.)
|
|
@MainActor
|
|
public protocol Panel: AnyObject, Identifiable, ObservableObject where ID == UUID {
|
|
/// Unique identifier for this panel
|
|
var id: UUID { get }
|
|
|
|
/// The type of panel
|
|
var panelType: PanelType { get }
|
|
|
|
/// Display title shown in tab bar
|
|
var displayTitle: String { get }
|
|
|
|
/// Optional SF Symbol icon name for the tab
|
|
var displayIcon: String? { get }
|
|
|
|
/// Whether the panel has unsaved changes
|
|
var isDirty: Bool { get }
|
|
|
|
/// Close the panel and clean up resources
|
|
func close()
|
|
|
|
/// Focus the panel for input
|
|
func focus()
|
|
|
|
/// Unfocus the panel
|
|
func unfocus()
|
|
|
|
/// Trigger a focus flash animation for this panel.
|
|
func triggerFlash()
|
|
}
|
|
|
|
/// Extension providing default implementations
|
|
extension Panel {
|
|
public var displayIcon: String? { nil }
|
|
public var isDirty: Bool { false }
|
|
}
|