feat(cz-commit): enable multi-line body input in interactive prompt

Add multiline support to the commit body question using prompt_toolkit's native multiline mode. Enter skips on empty input and inserts a newline otherwise.

Author: axkoro

commitizen/cz/conventional_commits/conventional_commits.py

@@ -5,7 +5,11 @@
 
 from commitizen import defaults
 from commitizen.cz.base import BaseCommitizen
-from commitizen.cz.utils import multiple_line_breaker, required_validator
+from commitizen.cz.utils import (
+    get_multiline_key_bindings,
+    multiple_line_breaker,
+    required_validator,
+)
 
 if TYPE_CHECKING:
     from commitizen.question import CzQuestion
@@ -133,6 +137,8 @@ def questions(self) -> list[CzQuestion]:
                     "Provide additional contextual information about the code changes: (press [enter] to skip)\n"
                 ),
                 "filter": multiple_line_breaker,
+                "multiline": True,
+                "key_bindings": get_multiline_key_bindings(),
             },
             {
                 "type": "confirm",

commitizen/cz/utils.py

@@ -1,14 +1,32 @@
 import os
 import re
 import tempfile
+from functools import lru_cache
 from pathlib import Path
 
+from prompt_toolkit.key_binding import KeyBindings, KeyPressEvent
+
 from commitizen import git
 from commitizen.cz import exceptions
 
 _RE_LOCAL_VERSION = re.compile(r"\+.+")
 
 
+@lru_cache(maxsize=1)
+def get_multiline_key_bindings() -> KeyBindings:
+    kb = KeyBindings()
+
+    @kb.add("enter")
+    def handle_enter(event: KeyPressEvent) -> None:
+        buff = event.app.current_buffer
+        if buff.text == "":
+            buff.validate_and_handle()
+        else:
+            buff.insert_text("\n")
+
+    return kb
+
+
 def required_validator(answer: str, msg: object = None) -> str:
     if not answer:
         raise exceptions.AnswerRequiredError(msg)

commitizen/question.py

@@ -1,6 +1,8 @@
 from collections.abc import Callable
 from typing import Literal, TypedDict
 
+from prompt_toolkit.key_binding import KeyBindings
+
 
 class Choice(TypedDict, total=False):
     value: str
@@ -21,6 +23,8 @@ class InputQuestion(TypedDict, total=False):
     name: str
     message: str
     filter: Callable[[str], str]
+    multiline: bool
+    key_bindings: KeyBindings
 
 
 class ConfirmQuestion(TypedDict):