feat: Update version to 9.4.0, enhance CHANGELOG and README, and refactor code for improved performance

Author: heckmon

CHANGELOG.md

@@ -362,4 +362,9 @@ This release establishes **CodeForge** as a powerful, production-ready code edit
 
 ## 9.3.0
   - FIX: [#54](https://github.com/heckmon/code_forge/issues/54)
-  - FEATURE: Multiple highlight grammars for a single editor instance.
+  - FEATURE: Multiple highlight grammars for a single editor instance.
+
+## 9.4.0
+  - FIX: [#57](https://github.com/heckmon/code_forge/issues/57)
+  - FIX: [#58](https://github.com/heckmon/code_forge/issues/58)
+  - FIX: Anchored gutter for `controller.setGitDiffDecorations`

README.md

@@ -38,9 +38,10 @@
 > code_forge does **not** support Flutter web, as it relies on `dart:io` for core functionality. Use [code_forge_web](https://pub.dev/packages/code_forge_web) for web support.
 
 
-### What's new in 9.3.0
-  - FIX: [#54](https://github.com/heckmon/code_forge/issues/54)
-  - FEATURE: Multiple highlight grammars for a single editor instance.
+### What's new in 9.4.0
+  - FIX: [#57](https://github.com/heckmon/code_forge/issues/57)
+  - FIX: [#58](https://github.com/heckmon/code_forge/issues/58)
+  - FIX: Anchored gutter for `controller.setGitDiffDecorations`
 
 ## Why CodeForge?
 **Feature demos:** [CodeForge Features Showcase](https://heckmon.github.io/code_forge_demo/)
@@ -115,7 +116,7 @@ Add CodeForge to your `pubspec.yaml`:
 
 ```yaml
 dependencies:
-  code_forge: ^9.3.0
+  code_forge: ^9.4.0
 ```
 
 Then run:

example/lib/main.dart

@@ -34,11 +34,6 @@ class _MyAppState extends State<MyApp> {
     return data;
   }
 
-  @override
-  void initState() {
-    super.initState();
-  }
-
   @override
   Widget build(BuildContext context) {
     return MaterialApp(

lib/code_forge/code_area.dart

@@ -3983,7 +3983,6 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
     _hasActiveFoldsCache = false;
 
     final lineCount = controller.lineCount;
-    // Build sorted list directly from fold ranges instead of per-line Set
     final sortedLines = <int>[];
     for (final fold in _foldRanges.values) {
       if (fold != null && fold.isFolded) {
@@ -6248,19 +6247,26 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
           visibleHeight += _getWrappedLineHeight(i);
         }
       } else {
-        double cachedHeight = 0;
-        int cachedCount = 0;
-        for (final entry in _lineHeightCache.entries) {
-          if (entry.key < lineCount) {
-            cachedHeight += entry.value;
-            cachedCount++;
+        const int exactWrapHeightThreshold = 512;
+        if (lineCount <= exactWrapHeightThreshold) {
+          for (int i = 0; i < lineCount; i++) {
+            visibleHeight += _getWrappedLineHeight(i);
           }
+        } else {
+          double cachedHeight = 0;
+          int cachedCount = 0;
+          for (final entry in _lineHeightCache.entries) {
+            if (entry.key < lineCount) {
+              cachedHeight += entry.value;
+              cachedCount++;
+            }
+          }
+          final uncachedCount = lineCount - cachedCount;
+          final avgHeight = cachedCount > 0
+              ? cachedHeight / cachedCount
+              : _lineHeight;
+          visibleHeight = cachedHeight + (uncachedCount * avgHeight);
         }
-        final uncachedCount = lineCount - cachedCount;
-        final avgHeight = cachedCount > 0
-            ? cachedHeight / cachedCount
-            : _lineHeight;
-        visibleHeight = cachedHeight + (uncachedCount * avgHeight);
       }
     } else {
       _wrapWidth = double.infinity;
@@ -7224,38 +7230,10 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
     final errorColor = gutterStyle.errorLineNumberColor;
     final warningColor = gutterStyle.warningLineNumberColor;
 
-    int firstVisibleLine;
-    double firstVisibleLineY;
-
-    if (!lineWrap && !hasActiveFolds && _virtualRemovedTotalLineCount == 0) {
-      firstVisibleLine = (viewTop / _lineHeight).floor().clamp(
-        0,
-        lineCount - 1,
-      );
-      firstVisibleLineY = firstVisibleLine * _lineHeight;
-    } else {
-      double currentY = 0;
-      firstVisibleLine = 0;
-      firstVisibleLineY = 0;
-      final blocks = controller.virtualRemovedBlocks;
-      int blockIdx = 0;
-
-      for (int i = 0; i < lineCount; i++) {
-        if (hasActiveFolds && _isLineFolded(i)) continue;
-        while (blockIdx < blocks.length &&
-            blocks[blockIdx].afterLine == i - 1) {
-          currentY += blocks[blockIdx].lineCount * _lineHeight;
-          blockIdx++;
-        }
-        final lineHeight = lineWrap ? _getWrappedLineHeight(i) : _lineHeight;
-        if (currentY + lineHeight > viewTop) {
-          firstVisibleLine = i;
-          firstVisibleLineY = currentY;
-          break;
-        }
-        currentY += lineHeight;
-      }
-    }
+    final firstVisibleLine = _findVisibleLineByYPosition(
+      viewTop,
+    ).clamp(0, lineCount - 1);
+    final firstVisibleLineY = _getLineYOffset(firstVisibleLine, hasActiveFolds);
 
     _actionBulbRects.clear();
 
@@ -8280,6 +8258,7 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
       }
 
       final lineY = _getLineYOffset(lineIndex, hasActiveFolds);
+      final visualYOffset = _getTotalVirtualOffset(lineIndex);
 
       final colorBoxOffsetStart = _getColorBoxOffsetForLine(
         lineIndex,
@@ -8311,6 +8290,7 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
               offset.dy +
               (innerPadding?.top ?? 0) +
               lineY +
+              visualYOffset +
               box.top -
               vscrollController.offset;
 
@@ -8332,6 +8312,7 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
             offset.dy +
             (innerPadding?.top ?? 0) +
             lineY -
+            visualYOffset -
             vscrollController.offset;
 
         canvas.drawRect(
@@ -8479,6 +8460,7 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
     final startCol = start - startLineOffset;
 
     final startY = _getLineYOffset(startLine, hasActiveFolds);
+    final startVisualYOffset = _getTotalVirtualOffset(startLine);
 
     double startX;
     double startYInLine = 0;
@@ -8511,6 +8493,7 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
         offset.dy +
         (innerPadding?.top ?? 0) +
         startY +
+        startVisualYOffset +
         startYInLine -
         vscrollController.offset;
 
@@ -8531,6 +8514,7 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
     final endCol = end - endLineOffset;
 
     final endY = _getLineYOffset(endLine, hasActiveFolds);
+    final endVisualYOffset = _getTotalVirtualOffset(endLine);
 
     double endX;
     double endYInLine = 0;
@@ -8563,6 +8547,7 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
         offset.dy +
         (innerPadding?.top ?? 0) +
         endY +
+        endVisualYOffset +
         endYInLine -
         vscrollController.offset;
 

lib/code_forge/syntax_highlighter.dart

@@ -372,7 +372,6 @@ class SyntaxHighlighter {
     final rootStyle = baseTextStyle ?? _resolvedTheme['root'];
     final rootColor = rootStyle?.color;
 
-    // Preserve grammar styling when it clearly differs from root text style.
     if (style.color != null && rootColor != null && style.color != rootColor) {
       return true;
     }
@@ -683,8 +682,6 @@ class SyntaxHighlighter {
   Map<String, TextStyle> _buildResolvedTheme(Map<String, TextStyle> theme) {
     final resolved = Map<String, TextStyle>.from(theme);
 
-    // XML/HTML grammars commonly emit `tag`; many highlight themes only define
-    // `selector-tag` or `name`.
     if (!resolved.containsKey('tag')) {
       final fallbackTagStyle = resolved['selector-tag'] ?? resolved['name'];
       if (fallbackTagStyle != null) {
@@ -761,8 +758,6 @@ void _registerLanguageWithAliases(Highlight highlight, Mode language) {
   final normalizedName = language.name!.toLowerCase().trim();
   highlight.registerLanguage(normalizedName, language);
 
-  // Some grammars expose composite names like "HTML, XML" but subLanguage
-  // lookups request a single token (for example, "xml").
   for (final token in normalizedName.split(RegExp(r'[^a-z0-9_+#-]+'))) {
     if (token.isNotEmpty) {
       highlight.registerLanguage(token, language);

pubspec.yaml

@@ -1,6 +1,6 @@
 name: code_forge
 description: "A sophisticated code editor package with AI completion, LSP support, syntax highlighting, and advanced editing capabilities."
-version: 9.3.0
+version: 9.4.0
 homepage: https://github.com/heckmon/code_forge
 
 environment: