@levu/snap 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -5,6 +5,12 @@ 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

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

@@ -28,6 +28,7 @@ export const createMultilineTextPrompt = () => {
             let rawModeEnabled = false;
             let keypressListener;
             let ignoreNextLineEvent = false;
+            let expectingGhosttySequenceEcho = false;
             const cleanup = () => {
                 if (keypressListener) {
                     input.off('keypress', keypressListener);
@@ -62,6 +63,30 @@ export const createMultilineTextPrompt = () => {
                     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}`);
             };
@@ -109,6 +134,13 @@ export const createMultilineTextPrompt = () => {
                     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) {
@@ -171,14 +203,15 @@ export const createMultilineTextPrompt = () => {
                             output.write(`${pc.dim('> ')}${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.
-                            lines.push(getLiveLine());
-                            currentLine = '';
-                            rl.line = '';
-                            output.write(`\n${pc.dim('> ')}`);
+                            insertNewline();
                             return;
                         }
                         submit(lines.concat(getLiveLine()).join('\n'));

package/docs/component-reference.md

@@ -58,7 +58,7 @@ When `paste` is enabled, users can paste from clipboard using:
 
 Multi-line paste is automatically supported. Keyboard behavior:
 - `Enter` submits input
-- `Shift+Enter` inserts a newline (when your terminal reports Shift modifiers)
+- `Shift+Enter` inserts a newline (including Ghostty sequence fallback variants)
 - `Alt+Enter` inserts a newline fallback
 
 ### confirm

package/package.json

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