Puranjay Savar Mattas
6e1ffb96fd
Convert from git submodule to plain vendored copy. No push access to upstream nodes-app/swift-markdown-engine meant our local fix commit (05c1720) was stranded and unreachable from any remote on fresh clones/CI. Vendoring as plain files folds it into normal repo history instead.
118 lines
4.4 KiB
Swift
118 lines
4.4 KiB
Swift
//
|
|
// MarkdownEditorTheme.swift
|
|
// MarkdownEngine
|
|
//
|
|
// Created by Luca Chen on 16.03.26.
|
|
//
|
|
// Color palette for the Markdown editor engine.
|
|
//
|
|
// All user-visible colors used by the engine are routed through this
|
|
// struct. Defaults map to system colors so the editor adapts to light/
|
|
// dark mode automatically. Embedders that want a custom palette (for
|
|
// example, a sepia or high-contrast preset) can replace any subset of
|
|
// the colors without touching engine source files.
|
|
//
|
|
|
|
import AppKit
|
|
import Foundation
|
|
|
|
// MARK: - Theme
|
|
|
|
/// Color palette consumed by the Markdown editor engine.
|
|
///
|
|
/// Every color the engine puts on screen is read from this struct, so a
|
|
/// single override is enough to retheme the entire editor. The defaults
|
|
/// reproduce a system-native macOS look using `NSColor` dynamic system
|
|
/// colors, so light/dark-mode switching keeps working without extra code.
|
|
public struct MarkdownEditorTheme: Sendable {
|
|
|
|
// MARK: Text colors
|
|
|
|
/// Foreground color for plain body text and the typing caret.
|
|
public var bodyText: NSColor
|
|
/// Foreground color for de-emphasized text and most syntax markers.
|
|
/// Defaults to `secondaryLabelColor` so it tracks the system style.
|
|
public var mutedText: NSColor
|
|
/// Foreground color for content the engine wants to deemphasize further
|
|
/// than `mutedText` — for example, broken wiki-links.
|
|
public var disabledText: NSColor
|
|
/// Foreground color for heading marker glyphs (`#`, `##`, …).
|
|
public var headingMarker: NSColor
|
|
|
|
// MARK: Links
|
|
|
|
/// Foreground color for hyperlinks that resolve to an URL.
|
|
public var link: NSColor
|
|
/// Foreground color for incomplete `[text]` patterns (no URL yet).
|
|
public var incompleteLink: NSColor
|
|
|
|
// MARK: Find / search highlights
|
|
|
|
/// Background color used to highlight all matches when the user is
|
|
/// running an in-document search.
|
|
///
|
|
/// The default is `.systemYellow` so embedders that don't customize
|
|
/// this still get a sensible result. Apps with their own brand color
|
|
/// (for example, the Nodes app uses its custom yellow) should override
|
|
/// this to match their palette.
|
|
public var findMatchHighlight: NSColor
|
|
/// Background color used to highlight the currently-focused match
|
|
/// during in-document search. Typically a stronger version of
|
|
/// ``findMatchHighlight``.
|
|
public var findCurrentMatchHighlight: NSColor
|
|
|
|
// MARK: LaTeX rendering
|
|
|
|
/// Foreground color used when rendering LaTeX formulas in light mode.
|
|
public var latexLightModeText: NSColor
|
|
/// Foreground color used when rendering LaTeX formulas in dark mode.
|
|
public var latexDarkModeText: NSColor
|
|
|
|
// MARK: Strikethrough / decoration
|
|
|
|
/// Stroke color used for strikethrough decorations
|
|
/// (e.g. completed task list items, horizontal rules).
|
|
public var strikethroughColor: NSColor
|
|
|
|
// MARK: Highlight
|
|
|
|
/// Background color used for `==highlight==` inline markup.
|
|
public var highlightColor: NSColor
|
|
|
|
// MARK: Init
|
|
|
|
public init(
|
|
bodyText: NSColor = .labelColor,
|
|
mutedText: NSColor = .secondaryLabelColor,
|
|
disabledText: NSColor = .tertiaryLabelColor,
|
|
headingMarker: NSColor = .gray,
|
|
link: NSColor = .linkColor,
|
|
incompleteLink: NSColor = .systemBlue,
|
|
findMatchHighlight: NSColor = .systemYellow,
|
|
findCurrentMatchHighlight: NSColor = .systemYellow,
|
|
latexLightModeText: NSColor = .black,
|
|
latexDarkModeText: NSColor = .white,
|
|
strikethroughColor: NSColor = .labelColor,
|
|
highlightColor: NSColor = .systemOrange.withAlphaComponent(0.4)
|
|
) {
|
|
self.bodyText = bodyText
|
|
self.mutedText = mutedText
|
|
self.disabledText = disabledText
|
|
self.headingMarker = headingMarker
|
|
self.link = link
|
|
self.incompleteLink = incompleteLink
|
|
self.findMatchHighlight = findMatchHighlight
|
|
self.findCurrentMatchHighlight = findCurrentMatchHighlight
|
|
self.latexLightModeText = latexLightModeText
|
|
self.latexDarkModeText = latexDarkModeText
|
|
self.strikethroughColor = strikethroughColor
|
|
self.highlightColor = highlightColor
|
|
}
|
|
|
|
/// System-native palette built from `NSColor` dynamic system colors.
|
|
///
|
|
/// Use this if you want the engine to look like a stock macOS
|
|
/// `NSTextView`. It's also the default when no theme is supplied.
|
|
public static let `default` = MarkdownEditorTheme()
|
|
}
|