feat: Implement multi-cursor support and virtual removed blocks

- Added functionality for multi-cursor editing, allowing users to add and manage multiple cursors.
- Implemented methods for inserting and deleting text at all cursor positions.
- Introduced VirtualRemovedBlock class to display removed lines in the editor, enhancing git diff visualization.
- Updated styling and decorations to accommodate virtual removed lines.
- Bumped version to 9.0.0 and updated Dart SDK constraint to ^3.11.0.

Author: heckmon

CHANGELOG.md

@@ -334,4 +334,20 @@ This release establishes **CodeForge** as a powerful, production-ready code edit
   - FIX: [#41](https://github.com/heckmon/code_forge/issues/41)
 
 ## 8.5.1
-  - FEATURE: Enhanced Mac keyboard support
+  - FEATURE: Enhanced Mac keyboard support
+
+## 9.0.0
+  - #### FEATURE: Multi-cursor
+      - Alt + Click to add multiple cursors in the editor.
+      - APIs:
+      ```dart
+      // Multi-cursor operations
+      controller.addMultiCursor(int line, int character);
+      controller.clearMultiCursor();
+      controller.backspaceAtAllCursors();
+      controller.insertAtAllCursors(String textToInsert);
+
+      ```
+  - #### FIX: [#43](https://github.com/heckmon/code_forge/issues/43)
+  - #### ENHANCEMENT: Virtual lines for git diff removed ranges.
+  - #### Added `customCodeSnippets` parameter on the editor to add external code snippets on the suggestions as requested in [#46](https://github.com/heckmon/code_forge/issues/46)

README.md

@@ -38,10 +38,12 @@
 > 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 8.5.1
-  - FIX: [#47](https://github.com/heckmon/code_forge/issues/47)
-  - FIX: [#41](https://github.com/heckmon/code_forge/issues/41)
-  - FEATURE: Enhanced mac keyboard support.
+### What's new in 9.0.0
+  - #### FEATURE: Multi-cursor
+      - Alt + Click to add multiple cursors in the editor.
+  - #### FIX: [#43](https://github.com/heckmon/code_forge/issues/43)
+  - #### ENHANCEMENT: Virtual lines for git diff removed ranges.
+  - #### Added `customCodeSnippets` parameter on the editor to add external code snippets on the suggestions as requested in [#46](https://github.com/heckmon/code_forge/issues/46)
 
 ## Why CodeForge?
 **Feature demos:** [CodeForge Features Showcase](https://heckmon.github.io/code_forge_demo/)
@@ -116,7 +118,7 @@ Add CodeForge to your `pubspec.yaml`:
 
 ```yaml
 dependencies:
-  code_forge: ^8.5.1
+  code_forge: ^9.0.0
 ```
 
 Then run:
@@ -469,6 +471,7 @@ CodeForge(
 | `enableSuggestions` | `bool` | Enable autocomplete suggestions |
 | `enableKeyboardSuggestions` | `bool` | Show auto completions in OS virtual keyboard |
 | `keyboardType` | `TextInputType` | Type of virtual keyboard |
+| `customSnippets` | `CustomSnippets` | Add custom code snippets to the suggestions |
 | `deleteFoldRangeOnDeletingFirstLine` | `bool` | When true, deleting the first line of a folded block removes the entire block |
 | `finderBuilder` | `PreferredSizeWidget Function(FindController findController)?` | Builder for custom Finder widget |
 
@@ -572,6 +575,12 @@ controller.pressDocumentEndKey(isShiftPressed: false);
 controller.pressWordLeftArrowKey(isShiftPressed: false);
 controller.pressWordRightArrowKey(isShiftPressed: false);
 
+// Multi-cursor operations
+controller.addMultiCursor(int line, int character);
+controller.clearMultiCursor();
+controller.backspaceAtAllCursors();
+controller.insertAtAllCursors(String textToInsert);
+
 ```
 There are more methods available in the CodeForgeController API. You can see the complete list [here](https://pub.dev/documentation/code_forge/latest/code_forge_controller/CodeForgeController-class.html#instance-methods)
 
@@ -684,6 +693,7 @@ CodeForge supports a variety of keyboard shortcuts for efficient editing:
 - **Ctrl+Y** — Redo last action.
 - **Ctrl+Backspace** — Delete word backward.
 - **Ctrl+Delete** — Delete word forward.
+- **Alt + Click** — Multi-cursor.
 
 ### Navigation
 - **Ctrl+Arrow Left** — Move cursor to previous word.

assets/icons/snippet.ttf

@@ -47,9 +47,15 @@ class _MyAppState extends State<MyApp> {
           onPressed: () {
             codeController?.setGitDiffDecorations(
               addedRanges: [(1, 5), (10, 25)],
-              removedRanges: [(30, 37)],
+              removedRanges: [
+                (
+                  afterLine: 29,
+                  content:
+                      'final x = 10;\nfinal y = 20;\nprint("removed line");',
+                ),
+              ],
             );
-            codeController?.scrollToLine(100);
+            codeController?.scrollToLine(30);
           },
         ),
         body: SafeArea(
@@ -87,6 +93,12 @@ class _MyAppState extends State<MyApp> {
                 ),
                 finderBuilder: (c, controller) =>
                     FindPanelView(controller: controller),
+                customCodeSnippets: CustomCodeSnippets(
+                  snippets: {
+                    "if": "if(condition){\n\n}",
+                    "if-else": "if(condition){\n\n} else {\n\n}",
+                  },
+                ),
               );
             },
           ),

example/lib/main.dart

@@ -1088,7 +1088,7 @@ Map<CompletionItemType, Icon> completionItemIcons = {
   CompletionItemType.value_: Icon(Icons.numbers, color: Colors.grey),
   CompletionItemType.enum_: Icon(Icons.notes, color: const Color(0xffee9d28)),
   CompletionItemType.keyword: Icon(Icons.wysiwyg_rounded, color: Colors.grey),
-  CompletionItemType.snippet: Icon(CustomIcons.snippet, color: Colors.grey),
+  CompletionItemType.snippet: Icon(Icons.rounded_corner, color: Colors.grey),
   CompletionItemType.color: Icon(Icons.color_lens, color: Colors.grey),
   CompletionItemType.file: Icon(Icons.insert_drive_file, color: Colors.grey),
   CompletionItemType.reference: Icon(CustomIcons.reference, color: Colors.grey),
@@ -1125,7 +1125,6 @@ class CustomIcons {
   static const IconData event = IconData(0x900, fontFamily: 'Event');
   static const IconData operator = IconData(0x900, fontFamily: 'Operator');
   static const IconData parameter = IconData(0x900, fontFamily: 'Parameter');
-  static const IconData snippet = IconData(0x900, fontFamily: 'Snippet');
   static const IconData interface = IconData(0x900, fontFamily: 'Interface');
   static const IconData field = IconData(0x900, fontFamily: 'Field');
 
@@ -1141,7 +1140,6 @@ class CustomIcons {
       'Event': 'assets/icons/event.ttf',
       'Operator': 'assets/icons/operator.ttf',
       'Parameter': 'assets/icons/parameter.ttf',
-      'Snippet': 'assets/icons/snippet.ttf',
       'Interface': 'assets/icons/interface.ttf',
       'Field': 'assets/icons/field.ttf',
     };
@@ -1495,3 +1493,57 @@ Map<String, List<String>> getSemanticMapping(String languageId) {
 
   return baseMap;
 }
+
+/// Represents a custom code snippet configuration for a specific language.
+///
+/// This class encapsulates a collection of code snippets associated with a particular
+/// file extension. It provides a way to define reusable code templates for languages
+/// used in the code editor.
+///
+/// and [snippets] is a map where keys are snippet names and values are the snippet code.
+///
+/// Example usage with [fromJson]:
+/// ```dart
+/// const String jsonString = '''{
+///   "snippets": {
+///     "class": "class MyClass {\\n \\n}",
+///     "function": "void myFunction() {\\n \\n}",
+///     "main": "void main() {\\n  print('Hello, World!');\\n}"
+///   }
+/// }''';
+///
+/// final snippet = CustomCodeSnippets.fromJson(jsonString);
+/// if (snippet != null) {
+///   print(snippet.fileExtension); // Output: .dart
+///   print(snippet.snippets['class']); // Output: class MyClass { ... }
+/// }
+/// ```
+///
+/// Required JSON fields:
+/// - **snippets** (Map&lt;String, String&gt;): A map of snippet names to their code content
+class CustomCodeSnippets {
+  /// A map of snippet names to their code content.
+  ///
+  /// Keys are user-friendly snippet identifiers (e.g., "class", "function"),
+  /// and values are the corresponding code templates with proper formatting.
+  ///
+  /// Example:
+  /// ```dart
+  /// {
+  ///   "class": "class MyClass {\n  \n}",
+  ///   "function": "void myFunction() {\n  \n}",
+  ///   "main": "void main() {\n  print('Hello, World!');\n}"
+  /// }
+  /// ```
+  final Map<String, String> snippets;
+
+  CustomCodeSnippets({required this.snippets});
+
+  static CustomCodeSnippets? fromJson(String json) {
+    final Map<String, Map<String, String>>? decoded = jsonDecode(json);
+    if (decoded == null || decoded.isEmpty) return null;
+    if (!(decoded.containsKey("snippets"))) return null;
+
+    return CustomCodeSnippets(snippets: decoded["snippets"] ?? {});
+  }
+}