@levu/snap 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.2] - 2026-02-26
+
+### Fixed
+- Added Ghostty macOS fallback handling for `Shift+Enter` escape sequence variants like `13~`, so multiline prompts insert newline instead of echoing sequence text.
+- Added regression coverage for the `13~` modified-enter sequence path.
+
+## [0.3.1] - 2026-02-26
+
+### Fixed
+- Multiline text prompt now submits on `Enter` in raw input mode, restoring submit behavior in macOS terminals like JetBrains and Ghostty.
+- Added `Shift+Enter` (and `Alt+Enter` fallback) support to insert newline in multiline prompt mode.
+- Restored terminal state reliably by disabling raw mode and detaching keypress listeners on prompt cleanup.
+- Added regression tests covering `Enter` submit and `Shift+Enter` newline behavior for multiline prompts.
+
 ## [0.2.0] - 2025-02-24
 
 ### Added

package/dist/tui/component-adapters/multiline-text.js

@@ -1,4 +1,4 @@
-import { createInterface } from 'node:readline';
+import { createInterface, emitKeypressEvents } from 'node:readline';
 import * as pc from 'picocolors';
 export const createMultilineTextPrompt = () => {
     return async (opts) => {
@@ -25,7 +25,18 @@ export const createMultilineTextPrompt = () => {
             });
             let value = initialValue;
             let cancelled = false;
+            let rawModeEnabled = false;
+            let keypressListener;
+            let ignoreNextLineEvent = false;
+            let expectingGhosttySequenceEcho = false;
             const cleanup = () => {
+                if (keypressListener) {
+                    input.off('keypress', keypressListener);
+                }
+                if (rawModeEnabled && input.setRawMode) {
+                    input.setRawMode(false);
+                    rawModeEnabled = false;
+                }
                 rl.close();
             };
             const submit = (val) => {
@@ -43,9 +54,39 @@ export const createMultilineTextPrompt = () => {
             if (allowPaste) {
                 output.write(pc.dim(`  Paste support: Ctrl+V to paste (macOS/Linux: Cmd+Shift+V)\n`));
             }
-            output.write(pc.dim(`  Press Enter twice or Alt+Enter to submit\n`));
+            output.write(pc.dim(`  Press Enter to submit; Shift+Enter for newline (Alt+Enter fallback)\n`));
             const lines = value.split('\n');
             let currentLine = lines.length > 0 ? lines.pop() : '';
+            const getLiveLine = () => {
+                const rlLine = typeof rl.line === 'string' ? rl.line : '';
+                if (rlLine.length > 0)
+                    return rlLine;
+                return currentLine;
+            };
+            const isGhosttyShiftEnter = (str, key) => {
+                const sequence = String(key?.sequence ?? '');
+                if (sequence.includes('[13;2u'))
+                    return true;
+                if (sequence.includes('[27;2;13~'))
+                    return true;
+                if (sequence.endsWith('13~'))
+                    return true;
+                if (sequence === '13~')
+                    return true;
+                if (str === '~13')
+                    return true;
+                if (str === '13~')
+                    return true;
+                if (str === '\u001b[13;2u')
+                    return true;
+                return false;
+            };
+            const insertNewline = () => {
+                lines.push(getLiveLine());
+                currentLine = '';
+                rl.line = '';
+                output.write(`\n${pc.dim('> ')}`);
+            };
             const showPrompt = () => {
                 output.write(`\n${pc.dim('> ')}${currentLine}`);
             };
@@ -89,10 +130,21 @@ export const createMultilineTextPrompt = () => {
             rl.on('line', (line) => {
                 if (cancelled)
                     return;
+                if (ignoreNextLineEvent) {
+                    ignoreNextLineEvent = false;
+                    return;
+                }
+                if (expectingGhosttySequenceEcho) {
+                    if (line === '13~' || line === '~13' || line === '[13;2u' || line === '\u001b[13;2u') {
+                        expectingGhosttySequenceEcho = false;
+                        return;
+                    }
+                    expectingGhosttySequenceEcho = false;
+                }
                 const now = Date.now();
                 // Check for double Enter to submit
                 if (line === '' && now - lastEnterTime < DOUBLE_ENTER_TIMEOUT) {
-                    submit(lines.join('\n') + currentLine);
+                    submit(lines.concat(getLiveLine()).join('\n'));
                     return;
                 }
                 lastEnterTime = now;
@@ -124,9 +176,11 @@ export const createMultilineTextPrompt = () => {
             }
             // Handle paste via keyboard shortcut
             if (allowPaste && input.setRawMode) {
+                emitKeypressEvents(input);
                 input.setRawMode(true);
+                rawModeEnabled = true;
                 input.resume();
-                input.on('keypress', async (str, key) => {
+                keypressListener = async (str, key) => {
                     if (cancelled)
                         return;
                     // Detect Ctrl+V or Cmd+V for paste
@@ -145,17 +199,28 @@ export const createMultilineTextPrompt = () => {
                                 // Single line paste
                                 currentLine += pasted;
                             }
+                            rl.line = currentLine;
                             output.write(`${pc.dim('> ')}${currentLine}`);
                         }
                     }
-                    else if (key.alt && key.name === 'enter') {
-                        // Alt+Enter to submit
-                        submit(lines.join('\n') + currentLine);
+                    else if (isGhosttyShiftEnter(str, key)) {
+                        expectingGhosttySequenceEcho = true;
+                        insertNewline();
+                    }
+                    else if (key.name === 'enter' || key.name === 'return') {
+                        ignoreNextLineEvent = true;
+                        if (key.shift || key.alt) {
+                            // Shift+Enter / Alt+Enter inserts a new line.
+                            insertNewline();
+                            return;
+                        }
+                        submit(lines.concat(getLiveLine()).join('\n'));
                     }
                     else if (key.name === 'escape') {
                         doCancel();
                     }
-                });
+                };
+                input.on('keypress', keypressListener);
             }
             // Handle non-interactive terminal
             if (!input.isTTY) {

package/docs/component-reference.md

@@ -56,9 +56,10 @@ When `paste` is enabled, users can paste from clipboard using:
 - macOS/Linux: `Cmd+V` or `Ctrl+V`
 - Windows: `Ctrl+V`
 
-Multi-line paste is automatically supported. Submit with:
-- `Alt+Enter` or `Cmd+Enter`
-- Double `Enter` (press Enter twice quickly)
+Multi-line paste is automatically supported. Keyboard behavior:
+- `Enter` submits input
+- `Shift+Enter` inserts a newline (including Ghostty sequence fallback variants)
+- `Alt+Enter` inserts a newline fallback
 
 ### confirm
 Yes/no confirmation prompt.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@levu/snap",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "bin": {
     "snap": "./dist/cli-entry.js"