Files
Netcatty/components/terminal/runtime/shiftEnterText.ts
T
陈大猫 b18f2bc447 feat: support Shift+Enter terminal newlines (#2005)
* feat: support Shift+Enter terminal newlines

* fix: harden Shift+Enter terminal handling

* fix: echo serial Shift+Enter newlines
2026-07-07 22:32:30 +08:00

94 lines
2.2 KiB
TypeScript

import type { TerminalSettings } from "../../../domain/models";
export const DEFAULT_SHIFT_ENTER_TEXT = "\\n";
type ShiftEnterEvent = Pick<
KeyboardEvent,
"altKey" | "ctrlKey" | "key" | "metaKey" | "shiftKey" | "type"
> & {
isComposing?: boolean;
};
export function decodeTerminalTextEscapes(text: string): string {
let decoded = "";
for (let index = 0; index < text.length; index += 1) {
const char = text[index];
if (char !== "\\" || index >= text.length - 1) {
decoded += char;
continue;
}
const next = text[index + 1];
switch (next) {
case "n":
decoded += "\n";
index += 1;
break;
case "r":
decoded += "\r";
index += 1;
break;
case "t":
decoded += "\t";
index += 1;
break;
case "\\":
decoded += "\\";
index += 1;
break;
default:
decoded += char;
break;
}
}
return decoded;
}
export function shouldSendShiftEnterText(
event: ShiftEnterEvent,
settings?: Pick<TerminalSettings, "shiftEnterNewlineEnabled">,
): boolean {
return (
settings?.shiftEnterNewlineEnabled !== false &&
event.type === "keydown" &&
event.key === "Enter" &&
event.shiftKey &&
!event.altKey &&
!event.ctrlKey &&
!event.metaKey &&
!event.isComposing
);
}
export function resolveShiftEnterText(
settings?: Pick<TerminalSettings, "shiftEnterNewlineText">,
): string {
const configured = settings?.shiftEnterNewlineText;
return decodeTerminalTextEscapes(
typeof configured === "string" ? configured : DEFAULT_SHIFT_ENTER_TEXT,
);
}
export function isShiftEnterLineContinuationText(text: string): boolean {
return /\\(?:\r\n|\r|\n)$/.test(text);
}
export type ShiftEnterSubmittedInput = {
text: string;
lineEnding: "\r\n" | "\r" | "\n";
};
export function getShiftEnterSubmittedInput(
text: string,
): ShiftEnterSubmittedInput | null {
if (isShiftEnterLineContinuationText(text)) return null;
const match = text.match(/^([^\r\n]*)(\r\n|\r|\n)$/);
if (!match) return null;
return {
text: match[1],
lineEnding: match[2] as ShiftEnterSubmittedInput["lineEnding"],
};
}