feat: Update version to 9.5.0, enhance CHANGELOG and README, and improve code performance and functionality

Author: heckmon

CHANGELOG.md

@@ -367,4 +367,9 @@ This release establishes **CodeForge** as a powerful, production-ready code edit
 ## 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`
+  - FIX: Anchored gutter for `controller.setGitDiffDecorations`
+
+## 9.5.0
+  - FIX: [#57](https://github.com/heckmon/code_forge/issues/57)
+  - FIX: [#58](https://github.com/heckmon/code_forge/issues/58)
+  

README.md

@@ -38,10 +38,9 @@
 > 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.4.0
+### What's new in 9.5.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/)
@@ -116,7 +115,7 @@ Add CodeForge to your `pubspec.yaml`:
 
 ```yaml
 dependencies:
-  code_forge: ^9.4.0
+  code_forge: ^9.5.0
 ```
 
 Then run:

example/pubspec.lock

@@ -47,7 +47,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "9.2.0"
+    version: "9.5.0"
   collection:
     dependency: transitive
     description:
@@ -501,5 +501,5 @@ packages:
     source: hosted
     version: "1.1.0"
 sdks:
-  dart: ">=3.11.3 <4.0.0"
+  dart: ">=3.11.4 <4.0.0"
   flutter: ">=3.35.0"

example/pubspec.yaml

@@ -5,7 +5,7 @@ publish_to: 'none'
 version: 1.0.0+1
 
 environment:
-  sdk: ^3.11.3
+  sdk: ^3.11.4
 
 dependencies:
   flutter:

lib/code_forge/code_area.dart

@@ -3918,6 +3918,7 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
   bool _draggingStartHandle = false, _draggingEndHandle = false;
   bool _showBubble = false, _draggingCHandle = false, _readOnly;
   bool _isDeferringLayout = false, _hasCachedHeight = false;
+  bool _isCachedHeightExact = false;
   TextDirection _textDirection;
   Map<int, FoldRange>? _lastLspFoldRanges;
   Rect? _startHandleRect, _endHandleRect, _normalHandle;
@@ -4708,6 +4709,7 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
     if (_hasCachedHeight) {
       final lineDelta = _cachedLineCount - _previousLineCount;
       _cachedTotalHeight += lineDelta * _lineHeight;
+      _isCachedHeightExact = false;
     }
     _previousLineCount = _cachedLineCount;
 
@@ -6247,25 +6249,18 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
           visibleHeight += _getWrappedLineHeight(i);
         }
       } else {
-        const int exactWrapHeightThreshold = 512;
-        if (lineCount <= exactWrapHeightThreshold) {
+        final canReuseExactWrappedHeight =
+            _hasCachedHeight &&
+            _isCachedHeightExact &&
+            _previousLineCount == lineCount &&
+            _lineHeightCache.length >= lineCount;
+
+        if (canReuseExactWrappedHeight) {
+          visibleHeight = _cachedTotalHeight;
+        } else {
           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);
         }
       }
     } else {
@@ -6312,6 +6307,7 @@ class _CodeFieldRenderer extends RenderBox implements MouseTrackerAnnotation {
     _longLineWidth = maxLineWidth;
     _cachedTotalHeight = visibleHeight;
     _hasCachedHeight = true;
+    _isCachedHeightExact = true;
     _previousLineCount = lineCount;
 
     final contentHeight =

lib/code_forge/controller.dart

@@ -813,18 +813,11 @@ class CodeForgeController implements DeltaTextInputClient {
     if (suggestions == null || suggestions.isEmpty) return;
 
     final isMobile = Platform.isAndroid || Platform.isIOS;
-    final selected = isMobile
-        ? suggestions[currentlySelectedSuggestion!]
-        : suggestions[selectedIndex];
-    String insertText = '';
-
-    if (selected is LspCompletion) {
-      insertText = selected.label;
-    } else if (selected is Map) {
-      insertText = selected['insertText'] ?? selected['label'] ?? '';
-    } else if (selected is String) {
-      insertText = selected;
-    }
+    final safeSelectedIndex = isMobile
+        ? (currentlySelectedSuggestion ?? 0).clamp(0, suggestions.length - 1)
+        : selectedIndex.clamp(0, suggestions.length - 1);
+    final selected = suggestions[safeSelectedIndex];
+    final insertText = _extractSuggestionText(selected);
 
     if (insertText.isNotEmpty) {
       insertAtCurrentCursor(insertText, replaceTypedChar: true);
@@ -834,6 +827,37 @@ class CodeForgeController implements DeltaTextInputClient {
     currentlySelectedSuggestion = 0;
   }
 
+  String _extractSuggestionText(dynamic suggestion) {
+    if (suggestion is LspCompletion) {
+      return suggestion.label;
+    }
+    if (suggestion is Map) {
+      final dynamic insertText =
+          suggestion['insertText'] ??
+          suggestion['value'] ??
+          suggestion['label'];
+      return insertText is String ? insertText : '';
+    }
+    if (suggestion is String) {
+      return suggestion;
+    }
+
+    final dynamic dynamicSuggestion = suggestion;
+    try {
+      final dynamic insertText = dynamicSuggestion.insertText;
+      if (insertText is String && insertText.isNotEmpty) return insertText;
+    } catch (_) {}
+    try {
+      final dynamic value = dynamicSuggestion.value;
+      if (value is String && value.isNotEmpty) return value;
+    } catch (_) {}
+    try {
+      final dynamic label = dynamicSuggestion.label;
+      if (label is String) return label;
+    } catch (_) {}
+    return '';
+  }
+
   /// Adds a line decoration to the editor.
   ///
   /// Line decorations can highlight code ranges with background colors,
@@ -2075,7 +2099,7 @@ class CodeForgeController implements DeltaTextInputClient {
             _isMobile &&
             currentlySelectedSuggestion != null) {
           final sugg = suggestionsNotifier.value![currentlySelectedSuggestion!];
-          final text = sugg is LspCompletion ? sugg.label : sugg as String;
+          final text = _extractSuggestionText(sugg);
           insertAtCurrentCursor(text, replaceTypedChar: true);
           suggestionsNotifier.value = null;
           currentlySelectedSuggestion = null;

lib/code_forge/find_controller.dart

@@ -291,12 +291,20 @@ class FindController extends ChangeNotifier {
   void _scrollToCurrentMatch() {
     if (_currentMatchIndex >= 0 && _currentMatchIndex < _matches.length) {
       final match = _matches[_currentMatchIndex];
+      final matchLine = _codeController.getLineAtOffset(match.start);
       _codeController.setSelectionSilently(
         TextSelection(baseOffset: match.start, extentOffset: match.end),
       );
       _codeController.selectionOnly = true;
       _codeController.notifyListeners();
 
+      // Ensure find navigation keeps the active result centered in view.
+      try {
+        _codeController.scrollToLine(matchLine);
+      } on StateError {
+        // Ignore when editor is not attached yet.
+      }
+
       // removes selection
       _codeController.setSelectionSilently(TextSelection.collapsed(offset: 0));
     }

pubspec.yaml

@@ -1,10 +1,10 @@
 name: code_forge
 description: "A sophisticated code editor package with AI completion, LSP support, syntax highlighting, and advanced editing capabilities."
-version: 9.4.0
+version: 9.5.0
 homepage: https://github.com/heckmon/code_forge
 
 environment:
-  sdk: ^3.11.3
+  sdk: ^3.11.4
   flutter: ">=1.17.0"
 
 dependencies:
@@ -14,7 +14,7 @@ dependencies:
   re_highlight: ^0.0.3
   web_socket_channel: ^3.0.3
   flutter_colorpicker: ^1.1.0
-  vector_math: ^2.1.4
+  vector_math: ^2.2.0
 
 dev_dependencies:
   flutter_test: