Refactor: deprecate HTML escaping for console-only skit tool

- Mark HTML escaping functions as @available(*, unavailable) to preserve compatibility
- Update TokenVisitor to output plain text instead of HTML entities
- Remove HTML markup generation from trivia processing
- Simplify data structures to store raw Swift code text
- Clean JSON output now preserves special characters (&, <, >) as-is
- Improves skit command-line tool usability for console consumption

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: leogdion

Sources/SyntaxParser/String.swift

@@ -57,6 +57,7 @@ extension String {
   private static let whitespace = "whitespace"
   private static let newlineClass = "newline"
 
+  @available(*, unavailable, message: "HTML escaping is not needed for console output")
   internal func escapeHTML() -> String {
     var string = self
     let specialCharacters = [
@@ -77,6 +78,7 @@ extension String {
     return string
   }
 
+  @available(*, unavailable, message: "HTML formatting is not needed for console output")
   internal func replaceInvisiblesWithHTML() -> String {
     self
       .replacingOccurrences(of: Self.space, with: Self.nonBreakingSpace)
@@ -89,6 +91,7 @@ extension String {
       .replacingOccurrences(of: Self.newline, with: Self.newlineSymbol)
   }
 
+  @available(*, unavailable, message: "HTML formatting is not needed for console output")
   internal func replaceHTMLWhitespacesWithSymbols() -> String {
     self
       .replacingOccurrences(
@@ -103,6 +106,7 @@ extension String {
       )
   }
 
+  @available(*, unavailable, message: "HTML formatting is not needed for console output")
   internal func replaceHTMLWhitespacesToSymbols() -> String {
     self
       .replacingOccurrences(

Sources/SyntaxParser/StructureProperty.swift

@@ -35,8 +35,8 @@ internal struct StructureProperty: Codable, Equatable {
   internal let ref: String?
 
   internal init(name: String, value: StructureValue? = nil, ref: String? = nil) {
-    self.name = name.escapeHTML()
+    self.name = name
     self.value = value
-    self.ref = ref?.escapeHTML()
+    self.ref = ref
   }
 }

Sources/SyntaxParser/StructureValue.swift

@@ -34,7 +34,7 @@ internal struct StructureValue: Codable, Equatable {
   internal let kind: String?
 
   internal init(text: String, kind: String? = nil) {
-    self.text = text.escapeHTML().replaceHTMLWhitespacesToSymbols()
-    self.kind = kind?.escapeHTML()
+    self.text = text
+    self.kind = kind
   }
 }

Sources/SyntaxParser/Token.swift

@@ -33,10 +33,4 @@ internal struct Token: Codable, Equatable {
   internal let kind: String
   internal var leadingTrivia: String
   internal var trailingTrivia: String
-
-  internal init(kind: String, leadingTrivia: String, trailingTrivia: String) {
-    self.kind = kind.escapeHTML()
-    self.leadingTrivia = leadingTrivia
-    self.trailingTrivia = trailingTrivia
-  }
 }

Sources/SyntaxParser/TokenVisitor+Helpers.swift

@@ -61,43 +61,32 @@ extension TokenVisitor {
       kind = Self.keywordNormalized
     }
 
-    let sourceRange = token.sourceRange(converter: locationConverter)
-    let start = sourceRange.start
-    let end = sourceRange.end
-    let text =
-      token.presence == .present || showMissingTokens ? token.text : TokenVisitor.emptyString
+    // No longer needed for plain text output
+    _ = token.sourceRange(converter: locationConverter)
+    _ = token.presence == .present || showMissingTokens ? token.text : TokenVisitor.emptyString
   }
 
   internal func processTriviaPiece(_ piece: TriviaPiece) -> String {
-    func wrapWithSpanTag(class className: String, text: String) -> String {
-      "\(Self.spanClass)\(className.escapeHTML())' "
-        + "\(Self.dataTitle)\("\(piece)".escapeHTML().replaceInvisiblesWithSymbols())' "
-        + "\(Self.dataContent)\(className.escapeHTML().replaceInvisiblesWithHTML())' "
-        + "\(Self.dataType)\(Self.trivia)'>\(text.escapeHTML().replaceInvisiblesWithHTML())\(Self.spanEnd)"
-    }
-
     var trivia = TokenVisitor.emptyString
     switch piece {
     case .spaces(let count):
-      trivia += String(repeating: Self.nonBreakingSpace, count: count)
+      trivia += String(repeating: " ", count: count)
     case .tabs(let count):
-      trivia += String(
-        repeating: Self.nonBreakingSpace,
-        count: count * Self.whitespaceSpacer)
+      trivia += String(repeating: "\t", count: count)
     case .verticalTabs, .formfeeds:
       break
     case .newlines(let count), .carriageReturns(let count), .carriageReturnLineFeeds(let count):
-      trivia += String(repeating: Self.lineBreak, count: count)
+      trivia += String(repeating: "\n", count: count)
     case .lineComment(let text):
-      trivia += wrapWithSpanTag(class: Self.lineComment, text: text)
+      trivia += text
     case .blockComment(let text):
-      trivia += wrapWithSpanTag(class: Self.blockComment, text: text)
+      trivia += text
     case .docLineComment(let text):
-      trivia += wrapWithSpanTag(class: Self.docLineComment, text: text)
+      trivia += text
     case .docBlockComment(let text):
-      trivia += wrapWithSpanTag(class: Self.docBlockComment, text: text)
+      trivia += text
     case .unexpectedText(let text):
-      trivia += wrapWithSpanTag(class: Self.unexpectedText, text: text)
+      trivia += text
     case .backslashes(let count):
       trivia += String(repeating: Self.backslash, count: count)
     case .pounds(let count):

Sources/SyntaxParser/TokenVisitor.swift

@@ -183,24 +183,20 @@ internal final class TokenVisitor: SyntaxRewriter {
   }
 
   override internal func visit(_ token: TokenSyntax) -> TokenSyntax {
-    current.text = token
-      .text
-      .escapeHTML()
-      .replaceInvisiblesWithHTML()
-      .replaceHTMLWhitespacesWithSymbols()
+    current.text = token.text
 
     current.token = Token(
       kind: "\(token.tokenKind)", leadingTrivia: Self.emptyString,
       trailingTrivia: Self.emptyString)
 
     for piece in token.leadingTrivia {
       let trivia = processTriviaPiece(piece)
-      current.token?.leadingTrivia += trivia.replaceHTMLWhitespacesWithSymbols()
+      current.token?.leadingTrivia += trivia
     }
     processToken(token)
     for piece in token.trailingTrivia {
       let trivia = processTriviaPiece(piece)
-      current.token?.trailingTrivia += trivia.replaceHTMLWhitespacesWithSymbols()
+      current.token?.trailingTrivia += trivia
     }
 
     return token

Sources/SyntaxParser/TreeNode.swift

@@ -46,7 +46,7 @@ internal final class TreeNode: Codable {
 
   internal init(id: Int, text: String, range: SourceRange, type: SyntaxType) {
     self.id = id
-    self.text = text.escapeHTML()
+    self.text = text
     self.range = range
     self.type = type
   }