mulmoterminal 1.7.2 → 1.9.0

package/README.md

@@ -410,13 +410,16 @@ The Settings modal (⚙) persists per-user UI choices to `~/.mulmoterminal/confi
 | `pushEnabled` | `true` to send a **Web Push** to your registered devices when a background task finishes. Off by default; only sends while the **RemoteHost** channel is connected (see below). |
 | `worklogEnabled` | `true` to run the built-in **dev worklog** batch (see below). Off by default (each run spawns an LLM session, so it costs tokens). |
 | `worklogIntervalHours` | Worklog cadence in hours (default `6`, clamped to `1`–`168`). |
+| `terminalSubmit` | Which bytes Claude reads as **submit** vs **newline**: `"cr"` (default — Enter submits, Shift+Enter makes a newline) or `"esc-cr"` (for a Claude Code rebound the other way). Applies to the keyboard **and** the phone remote-view submit, for **Claude sessions only** (shell/codex keep plain Enter). See the [Configuration guide](https://receptron.github.io/mulmoterminal/guide/en/config.html#terminal-submit). |
 
 #### Header buttons
 
 Each terminal header shows configurable **action buttons**. Omitting `buttons` (globally or per-dir)
-keeps the built-in defaults — a **file-path picker** (📎) and an **OS file-manager reveal** (📂).
-Setting `buttons` (at either level) **replaces** the defaults with your list, so you can drop, reorder,
-or swap them — e.g. add the in-app **📁 file explorer** with `"open": { "files": "${dir}" }`.
+keeps the built-in **starter set**: a file-path picker (📎), an OS file-manager reveal (📂), an in-app
+file explorer (📁), a new terminal here (🖥), this branch's PR (🔗, git repos, only when a PR exists),
+and open-on-GitHub (🌐, git repos). Setting `buttons` (at either level) **replaces the whole default
+set** with your list (it is not merged on top), so listing your own — even a **shorter** one — is how
+you drop, reorder, or swap them.
 A button has an `id`, `label`, and a `run` of `"shell"` (run a command), `"input"` (send text to the
 agent), or `"open"`. An `open` button targets one of `url` / `reveal` (OS file manager) / `files`
 (in-app explorer) / `view` (a built-in overlay) / `terminal` (a dir → a new cell running `$SHELL`,
@@ -793,7 +796,9 @@ Favorited collections get their own toolbar buttons.
 - **Themes** — four terminal palettes (midnight / nord / daylight / solarized), your pick
   remembered; a project's `.mulmoterminal.json` can override per directory.
 - **Editing niceties** — **Shift+Enter** inserts a newline in the prompt, and on macOS
-  **Option** is treated as Meta so Claude's Alt-key bindings work.
+  **Option** is treated as Meta so Claude's Alt-key bindings work. If your Claude Code is
+  rebound so Enter and Shift+Enter behave backwards, flip them with
+  [`terminalSubmit`](https://receptron.github.io/mulmoterminal/guide/en/config.html#terminal-submit).
 
 ---
 

package/common/terminalSubmit.ts

@@ -0,0 +1,70 @@
+// How the host's Claude Code / TUI maps received bytes to "submit this prompt" vs
+// "insert a newline". The TUI decides from the bytes, and that mapping is environment-
+// dependent (Claude Code lets a user rebind it), so the SAME fact has to reach two
+// unrelated places: the browser's xterm key handler and the phone remote-view's submit.
+// One value, consumed by both, keeps them from drifting apart.
+//
+//   "cr"      — the standard binding: CR (\r) submits, ESC+CR (\x1b\r, = Alt/Meta+Enter)
+//               makes a newline. This is MulmoTerminal's default and unchanged behaviour.
+//   "esc-cr"  — the reversed binding some users configure: ESC+CR submits, CR makes a
+//               newline.
+export const TERMINAL_SUBMIT_MODES = ["cr", "esc-cr"] as const;
+export type TerminalSubmitMode = (typeof TERMINAL_SUBMIT_MODES)[number];
+export const DEFAULT_TERMINAL_SUBMIT_MODE: TerminalSubmitMode = "cr";
+
+export const isTerminalSubmitMode = (value: unknown): value is TerminalSubmitMode =>
+  typeof value === "string" && (TERMINAL_SUBMIT_MODES as readonly string[]).includes(value);
+
+// CR on its own. ESC+CR is what a terminal emits for Alt/Meta+Enter.
+const CR = "\r";
+const ESC_CR = "\x1b\r";
+
+// The byte(s) the host reads as "submit this prompt" in the given mode.
+export const submitSequence = (mode: TerminalSubmitMode): string => (mode === "esc-cr" ? ESC_CR : CR);
+// The byte(s) it reads as "insert a newline" — the other one.
+export const newlineSequence = (mode: TerminalSubmitMode): string => (mode === "esc-cr" ? CR : ESC_CR);
+
+// The submit byte(s) for a specific session. `terminalSubmit` describes the user's CLAUDE
+// binding, so it applies ONLY to Claude sessions; every other agent (shell, codex, a
+// one-shot command) keeps plain CR — a reversed setting must never rewrite a shell's Enter,
+// where ESC+CR is Alt+Enter, not submit.
+export const submitSequenceForAgent = (agent: string | undefined, mode: TerminalSubmitMode): string => (agent === "claude" ? submitSequence(mode) : CR);
+
+// The structural shape of a keydown the override needs. A real DOM KeyboardEvent satisfies
+// it, and so does a plain test object — no DOM dependency, so this stays testable and shared.
+export interface EnterKeyEvent {
+  type: string;
+  key: string;
+  shiftKey: boolean;
+  altKey: boolean;
+  ctrlKey: boolean;
+  metaKey: boolean;
+  isComposing?: boolean;
+}
+
+// The bytes to emit for an Enter-family keydown (the caller then suppresses xterm's own
+// \r and sends these instead), or null to let xterm handle the key natively.
+//
+// The SEMANTICS are the same in both modes — a bare Enter SUBMITS, Shift/Alt(Option)+Enter
+// make a NEWLINE — only which bytes carry each meaning differs, because that is the
+// environment fact `mode` encodes.
+//
+// In "cr" mode only Shift+Enter is overridden, exactly as before the setting existed: a
+// bare Enter falls through to xterm's native \r (submit) and Option+Enter to
+// macOptionIsMeta's ESC+CR (newline). Leaving the bare-Enter path native keeps IME
+// candidate-confirm and the hottest key untouched in the default configuration.
+export const enterKeyOverride = (mode: TerminalSubmitMode, e: EnterKeyEvent): string | null => {
+  if (e.type !== "keydown" || e.key !== "Enter") return null;
+  // IME composition (Japanese and other CJK input): this Enter confirms a candidate — it
+  // is never the user's submit/newline, so never intercept it.
+  if (e.isComposing) return null;
+  const bare = !e.shiftKey && !e.altKey && !e.ctrlKey && !e.metaKey;
+  const shiftOnly = e.shiftKey && !e.altKey && !e.ctrlKey && !e.metaKey;
+  const altHeld = e.altKey && !e.ctrlKey && !e.metaKey; // Option/Alt (with or without Shift)
+  if (mode === "cr") return shiftOnly ? newlineSequence(mode) : null;
+  // "esc-cr": a bare Enter must emit the ESC+CR that submits here; Shift/Alt+Enter must
+  // emit the CR that makes a newline (the Alt case also overrides macOptionIsMeta's ESC+CR).
+  if (bare) return submitSequence(mode);
+  if (shiftOnly || altHeld) return newlineSequence(mode);
+  return null;
+};

package/dist/assets/{abnfDiagram-VRR7QNED-RjiYivmv-CCLjG9E9.js → abnfDiagram-VRR7QNED-RjiYivmv-DU_K6qFi.js}

@@ -1 +1 @@
-import{n as e}from"./chunk-Y2CYZVJY-Bdt8pFDJ-DsF7k-Jl.js";import{f as t}from"./src-Brzfja-q-ch1VcTiG.js";import{_ as n,g as r}from"./mermaid-parser.core-DxEa8E3F-kLn0LOBf.js";import"./chunk-WYO6CB5R-BlzOfotS-Cg8JP_k-.js";import"./chunk-VAUOI2AC-CS9QJ4yz-rBHFym4n.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CMZRaeqt-CfjRj6ge.js";import{t as s}from"./chunk-JWPE2WC7-BQ3zXr2k-DSd3Ct95.js";var c=r().RailroadAbnf.parser.LangiumParser,l=e(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=e(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=e(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=e(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=e(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=e(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=e(e=>{s(e,a),e.title&&a.setTitle(e.title),e.rules.map(e=>a.addRule(m(e)))},`populateDb`),g={parser:{parse:e(e=>{a.clear(),t.debug(`[ABNF Parser] Starting Langium parse`);let r=c.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new n(r);let i=r.value;t.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),t.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:a}},db:a,renderer:o,styles:i};export{g as diagram};
+import{n as e}from"./chunk-Y2CYZVJY-Bdt8pFDJ-DsF7k-Jl.js";import{f as t}from"./src-Brzfja-q-ch1VcTiG.js";import{_ as n,g as r}from"./mermaid-parser.core-DxEa8E3F-kNPP09h0.js";import"./chunk-WYO6CB5R-BlzOfotS-BthT9wbR.js";import"./chunk-VAUOI2AC-CS9QJ4yz-DtSCvKnv.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CMZRaeqt-D-0XUMWR.js";import{t as s}from"./chunk-JWPE2WC7-BQ3zXr2k-DSd3Ct95.js";var c=r().RailroadAbnf.parser.LangiumParser,l=e(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=e(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=e(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=e(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=e(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=e(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=e(e=>{s(e,a),e.title&&a.setTitle(e.title),e.rules.map(e=>a.addRule(m(e)))},`populateDb`),g={parser:{parse:e(e=>{a.clear(),t.debug(`[ABNF Parser] Starting Langium parse`);let r=c.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new n(r);let i=r.value;t.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),t.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:a}},db:a,renderer:o,styles:i};export{g as diagram};

package/dist/assets/architecture-TIHT7OUA-0NsD2xW1-4wf6mIEw.js

@@ -0,0 +1 @@
+import{f as e}from"./mermaid-parser.core-DxEa8E3F-kNPP09h0.js";export{e as createArchitectureServices};