@hncode/hncode 0.3.6 → 0.4.1

package/src/clipboard.js

@@ -27,8 +27,11 @@ export function copyText(text) {
   if (!s) return false;
   if (win()) {
     // clip.exe takes UTF-16LE. (`cmd /c echo "…" | clip` mangled quotes, '%'
-    // and newlines; plain UTF-8 input turned non-ASCII into mojibake.)
-    cp.execSync('clip', { input: Buffer.from(s, 'utf16le'), windowsHide: true, timeout: 5000 });
+    // and newlines; plain UTF-8 input turned non-ASCII into mojibake.) Prefix the
+    // UTF-16 byte order mark (FF FE) so clip.exe is never left to guess the endian
+    // or treat input as ANSI — without it, non-ASCII on some Windows versions /
+    // code pages came out mojibake.
+    cp.execSync('clip', { input: Buffer.concat([Buffer.from([0xff, 0xfe]), Buffer.from(s, 'utf16le')]), windowsHide: true, timeout: 5000 });
     return true;
   }
   const cmd = process.platform === 'darwin' ? 'pbcopy' : 'xclip -selection clipboard';

package/src/colors.js

@@ -1,238 +1,242 @@
-// Cyan-blue visual theme for hncode. Adapts to the terminal's color depth:
-// uses true-color when available, 256/16-color fallbacks otherwise.
-
-function colorDepth() {
-  try { return process.stdout.getColorDepth?.() || 0; } catch { return 0; }
-}
-const DEPTH = colorDepth();
-export const TRUECOLOR = DEPTH >= 24 || process.env.COLORTERM === 'truecolor' || /^xterm.*-256color$|.*-truecolor$/.test(process.env.TERM || '');
-
-function rgb(r, g, b) { return TRUECOLOR ? `\x1b[38;2;${r};${g};${b}m` : `\x1b[38;5;${ansi256(r, g, b)}m`; }
-function brgb(r, g, b) { return TRUECOLOR ? `\x1b[48;2;${r};${g};${b}m` : `\x1b[48;5;${ansi256(r, g, b)}m`; }
-
-// Quantize a truecolor triple to the nearest 256-color xterm index.
-function ansi256(r, g, b) {
-  const ri = Math.round(r / 51), gi = Math.round(g / 51), bi = Math.round(b / 51);
-  if (ri === gi && gi === bi) {
-    if (ri === 0) return 16;
-    if (ri === 255 / 51) return 232 + ri;
-    return 232 + ri; // grayscale ramp
-  }
-  return 16 + 36 * ri + 6 * gi + bi;
-}
-
-// Brand: cyan-blue (青蓝色).
-export const TEAL = rgb(0, 184, 219);     // 青蓝
-export const CYAN = rgb(0, 215, 255);
-export const BLUE = rgb(66, 135, 245);
-export const FG = TEAL;                   // primary fg
-export const BG = rgb(0, 18, 26);
-export const BORDER = rgb(70, 130, 180);
-
-// Named accent colours per theme. `auto` keeps the brand cyan-blue and lets the
-// terminal's own palette show through for everything else; `dark`/`light` pick
-// accent triples that stay readable on that background.
-const THEMES = {
-  auto: { 
-    fg: [0, 184, 219], bg: [0, 18, 26], 
-    teal: [0, 184, 219], cyan: [0, 215, 255], blue: [66, 135, 245], border: [70, 130, 180], 
-    hover: [190, 245, 255], selBg: [0, 70, 84] 
-  },
-  dark: { 
-    fg: [255, 255, 255], bg: [0, 18, 26], // White foreground for normal text
-    teal: [0, 184, 219], cyan: [0, 215, 255], blue: [66, 135, 245], border: [70, 130, 180], 
-    hover: [190, 245, 255], selBg: [0, 70, 84] 
-  },
-  light: {
-    fg: [26, 26, 26], bg: [255, 255, 255],
-    teal: [0, 102, 128], cyan: [0, 122, 153], blue: [10, 77, 158], border: [138, 155, 176],
-    hover: [0, 78, 102], selBg: [200, 230, 239],
-    red: [179, 38, 30], green: [30, 122, 60], yellow: [160, 120, 0], orange: [178, 90, 0],
-    white: [26, 26, 26], gray: [85, 85, 85],
-  },
-};
-export const THEME_NAMES = Object.keys(THEMES);
-
-export const C = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-  // Italic (SGR 3). Used for the BODY of a reasoning block — the prose reads as
-  // an aside rather than as the answer. Must be closed with SGR 23 (`endItalic`),
-  // NOT with `reset`, because resetting also drops the surrounding dim/gray that
-  // the same row depends on. Terminals without italic fall back to normal text,
-  // so this is a decoration, never load-bearing.
-  italic: '\x1b[3m',
-  endItalic: '\x1b[23m',
-  muted: '\x1b[90m',
-  teal: TEAL,
-  cyan: CYAN,
-  blue: BLUE,
-  fg: FG,
-  bg: BG,
-  bgTeal: brgb(0, 184, 219),
-  bgDim: brgb(12, 24, 30),
-  bgPanel: TRUECOLOR ? '\x1b[48;5;236m' : '\x1b[48;5;236m',
-  border: BORDER,
-  red: '\x1b[91m',
-  green: '\x1b[92m',
-  yellow: '\x1b[93m',
-  magenta: '\x1b[95m',
-  gray: '\x1b[90m',
-  white: '\x1b[97m',
-  orange: TRUECOLOR ? rgb(255, 140, 0) : '\x1b[38;5;208m',
-  // Cyan pushed slightly toward green — used for the Swarm mode badge so it reads
-  // as its own mode next to Plan (pure cyan) and Focus (blue) while staying in the
-  // theme's blue-green family. 38;5;43 is rgb(0,215,175): red at zero and green
-  // only 40 above blue, i.e. still clearly cyan with a green cast. 38;5;85 was the
-  // first attempt and read as plain GREEN — its red channel is lifted to 95 and
-  // green pins at 255, which is a spring green, not a green-tinted cyan.
-  spring: TRUECOLOR ? rgb(0, 215, 175) : '\x1b[38;5;43m',
-  // Git branch in the status line: yellow pulled about half way toward white, so
-  // it stays clearly "yellow" (not cream/ivory) while reading brighter than the
-  // plain 93 yellow on a dark background. rgb(255,219,110) keeps red at max,
-  // green near it, and blue around 43% — that ratio is what keeps the hue
-  // yellow rather than dropping into orange.
-  branch: TRUECOLOR ? rgb(255, 219, 110) : '\x1b[38;5;222m',
-  // Shell-mode (`!`) accent — violet, matching kimi-code's shellMode token so the
-  // bash-mode editor border and the `!` read as "shell", distinct from the cyan
-  // prompt and the yellow git badge. #BD93F9 dark / #7C3AED light.
-  shellMode: TRUECOLOR ? rgb(189, 147, 249) : '\x1b[38;5;141m',
-  bgRed: '\x1b[41m',
-  bgGreen: '\x1b[42m',
-  // Selection highlight (mouse text selection) and the scrollbar gutter.
-  // Selection uses a dark teal background so white text stays readable.
-  selBg: TRUECOLOR ? brgb(0, 70, 84) : '\x1b[48;5;23m', // Original dark cyan background
-  scrollTrack: '\x1b[90m',          // dim gutter
-  scrollThumb: TRUECOLOR ? rgb(0, 184, 219) : '\x1b[38;5;37m', // brand cyan-blue
-  // Scrollbar interaction states:
-  //   hover  -> a touch whiter/brighter than the brand colour
-  //   active -> BOLD + the brand colour (pressed/dragging)
-  // The pressed state used to be a DARKER colour, which on a dark background
-  // read as "the thumb disappeared". Making it bold-and-bright means a press is
-  // always unmistakably visible. Idle swaps back to scrollThumb automatically.
-  scrollThumbHover: TRUECOLOR ? rgb(120, 226, 245) : '\x1b[38;5;123m',
-  scrollThumbActive: '\x1b[1m' + (TRUECOLOR ? rgb(0, 220, 255) : '\x1b[38;5;51m'),
-  // Hover highlight for clickable rows (menu items, picker options, form
-  // fields, composer rows). An explicit bright foreground + BOLD rather than a
-  // bare BOLD: BOLD only brightens the 16-colour palette (it does nothing to a
-  // true-color row), which is why hover used to be invisible on most rows.
-  // tintRange() re-applies this so the row's own SGR codes cannot cancel it.
-  hover: '\x1b[1m' + rgb(190, 245, 255),
-};
-
-export function style(text, ...codes) {
-  return codes.join('') + text + '\x1b[0m';
-}
-
-// Linearly interpolate between two RGB triples and return an ANSI colour string.
-// Used for the pulsing Working indicator (orange pulses to a brighter/darker
-// shade over a 2s cycle).
-export function lerpColor(r1, g1, b1, r2, g2, b2, t) {
-  const ti = Math.max(0, Math.min(1, t));
-  const r = Math.round(r1 + (r2 - r1) * ti);
-  const g = Math.round(g1 + (g2 - g1) * ti);
-  const b = Math.round(b1 + (b2 - b1) * ti);
-  return rgb(r, g, b);
-}
-
-// Apply a named theme IN PLACE. `C` is a module-level object and ESM imports are
-// live bindings, so mutating its properties here changes the colours everywhere
-// without re-importing. Returns true when the name was recognised.
-export function setTheme(name) {
-  const t = THEMES[name];
-  if (!t) return false;
-  
-  // Update foreground colors
-  C.teal = rgb(...t.teal);
-  C.fg = rgb(...t.fg);
-  C.cyan = rgb(...t.cyan);
-  C.blue = rgb(...t.blue);
-  C.border = rgb(...t.border);
-  
-  // Update background colors
-  C.bg = brgb(...t.bg);
-  C.bgTeal = brgb(...t.teal);
-  C.bgPanel = brgb(...t.bg);
-  C.selBg = brgb(...t.selBg);
-  
-  // Scrollbar colours. The active (pressed/dragging) thumb is BOLD + a brighter
-  // shade of the theme colour. It used to be a DARKER shade, which on a dark
-  // background read as "the thumb vanished" mid-drag.
-  C.scrollTrack = '\x1b[90m'; // dim gutter
-  C.scrollThumb = rgb(...t.teal);
-  C.scrollThumbHover = rgb(...t.hover);
-  C.scrollThumbActive = '\x1b[1m' + rgb(
-    Math.min(255, Math.round(t.teal[0] * 0.6 + 255 * 0.4)),
-    Math.min(255, Math.round(t.teal[1] * 0.6 + 255 * 0.4)),
-    Math.min(255, Math.round(t.teal[2] * 0.6 + 255 * 0.4)),
-  );
-
-  // Hover stays visible on this theme's background (bright on dark, dark on light).
-  C.hover = '\x1b[1m' + rgb(...(t.hover || [190, 245, 255]));
-
-  // Semantic colors — swap to deep versions on light backgrounds.
-  if (t.white)  C.white  = rgb(...t.white);
-  if (t.gray)   C.gray   = rgb(...t.gray);
-  if (t.red)    C.red    = rgb(...t.red);
-  if (t.green)  C.green  = rgb(...t.green);
-  if (t.yellow) C.yellow = rgb(...t.yellow);
-  if (t.orange) C.orange = rgb(...t.orange);
-  // The git branch colour is derived per theme: the pale yellow that reads well
-  // on the dark background is nearly invisible on white, so on a light theme it
-  // is darkened (keeping the same hue) instead of being left as-is.
-  if (t.bg && t.bg[0] > 128) {
-    C.branch = rgb(146, 106, 0);           // dark amber for light backgrounds
-  } else {
-    C.branch = TRUECOLOR ? rgb(255, 219, 110) : '\x1b[38;5;222m';
-  }
-
-  return true;
-}
-
-export function clearScreen() {
-  return '\x1b[3J\x1b[H\x1b[2J';
-}
-
-// Clear screen and set background color based on current theme
-export function clearAndSetBg() {
-  // Reset all attributes first
-  const reset = '\x1b[0m';
-  // Clear screen
-  const clear = '\x1b[3J\x1b[H\x1b[2J';
-  // Set background color using current C.bg value
-  const bg = C.bg || '\x1b[48;2;0;18;26m'; // Default dark background
-  return reset + clear + bg;
-}
-export function eraseLine() {
-  return '\x1b[2K';
-}
-export function eraseScreen() {
-  return '\x1b[2J';
-}
-export function moveTo(r, c) {
-  return `\x1b[${r + 1};${c + 1}H`;
-}
-export function cursorUp(n) { return `\x1b[${n}A`; }
-export function cursorDown(n) { return `\x1b[${n}B`; }
-export function cursorLeft(n) { return `\x1b[${n}D`; }
-export function cursorForward(n) { return `\x1b[${n}C`; }
-export function hideCursor() { return '\x1b[?25l'; }
-export function showCursor() { return '\x1b[?25h'; }
-// Cursor shape: terminals accept DECSCUSR — 2 = block, 4 = underline, 6 = bar(I-beam);
-// 1/3/5 = blinking variants. Force a solid block cursor so positioning is always exact
-// and unaffected by I-beam alignment.
-export function blockCursor() { return '\x1b[2 q'; }
-export function underlineCursor() { return '\x1b[4 q'; }
-export function barCursor() { return '\x1b[6 q'; }
-export function alternateScreen(on) { return on ? '\x1b[?1049h' : '\x1b[?1049l'; }
-export function setScrollRegion(top, bottom) {
-  if (process.platform === 'win32') return ''; // win TTY scroll regions are unreliable
-  return `\x1b[${top + 1};${bottom + 1}r`;
-}
-export function resetScrollRegion() {
-  return '\x1b[r';
-}
-export function setBracketed(on) {
-  return `\x1b[?2004h${on ? '' : ''}`; // placeholder; real impl toggles bracketed paste
-}
+// Cyan-blue visual theme for hncode. Adapts to the terminal's color depth:
+// uses true-color when available, 256/16-color fallbacks otherwise.
+
+function colorDepth() {
+  try { return process.stdout.getColorDepth?.() || 0; } catch { return 0; }
+}
+const DEPTH = colorDepth();
+export const TRUECOLOR = DEPTH >= 24 || process.env.COLORTERM === 'truecolor' || /^xterm.*-256color$|.*-truecolor$/.test(process.env.TERM || '');
+
+function rgb(r, g, b) { return TRUECOLOR ? `\x1b[38;2;${r};${g};${b}m` : `\x1b[38;5;${ansi256(r, g, b)}m`; }
+function brgb(r, g, b) { return TRUECOLOR ? `\x1b[48;2;${r};${g};${b}m` : `\x1b[48;5;${ansi256(r, g, b)}m`; }
+
+// Quantize a truecolor triple to the nearest 256-color xterm index.
+function ansi256(r, g, b) {
+  const ri = Math.round(r / 51), gi = Math.round(g / 51), bi = Math.round(b / 51);
+  if (ri === gi && gi === bi) {
+    if (ri === 0) return 16;
+    if (ri === 255 / 51) return 232 + ri;
+    return 232 + ri; // grayscale ramp
+  }
+  return 16 + 36 * ri + 6 * gi + bi;
+}
+
+// Brand accent: cyan-blue.
+export const TEAL = rgb(0, 184, 219);
+export const CYAN = rgb(0, 215, 255);
+export const BLUE = rgb(66, 135, 245);
+export const FG = TEAL;                   // primary fg
+export const BG = rgb(0, 18, 26);
+export const BORDER = rgb(70, 130, 180);
+
+// Named accent colours per theme. `auto` keeps the brand cyan-blue and lets the
+// terminal's own palette show through for everything else; `dark`/`light` pick
+// accent triples that stay readable on that background.
+const THEMES = {
+  auto: { 
+    fg: [0, 184, 219], bg: [0, 18, 26], 
+    teal: [0, 184, 219], cyan: [0, 215, 255], blue: [66, 135, 245], border: [70, 130, 180], 
+    hover: [190, 245, 255], selBg: [0, 70, 84] 
+  },
+  dark: {
+    fg: [255, 255, 255], bg: [0, 18, 26], // White foreground for normal text
+    teal: [0, 184, 219], cyan: [0, 215, 255], blue: [66, 135, 245], border: [70, 130, 180],
+    hover: [190, 245, 255], selBg: [0, 70, 84]
+  },
+  light: {
+    fg: [26, 26, 26], bg: [255, 255, 255],
+    teal: [0, 102, 128], cyan: [0, 122, 153], blue: [10, 77, 158], border: [138, 155, 176],
+    hover: [0, 78, 102], selBg: [200, 230, 239],
+    red: [179, 38, 30], green: [30, 122, 60], yellow: [160, 120, 0], orange: [178, 90, 0],
+    white: [26, 26, 26], gray: [85, 85, 85],
+  },
+};
+export const THEME_NAMES = Object.keys(THEMES);
+
+export const C = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  // Italic (SGR 3). Used for the BODY of a reasoning block — the prose reads as
+  // an aside rather than as the answer. Must be closed with SGR 23 (`endItalic`),
+  // NOT with `reset`, because resetting also drops the surrounding dim/gray that
+  // the same row depends on. Terminals without italic fall back to normal text,
+  // so this is a decoration, never load-bearing.
+  italic: '\x1b[3m',
+  endItalic: '\x1b[23m',
+  muted: '\x1b[90m',
+  teal: TEAL,
+  cyan: CYAN,
+  blue: BLUE,
+  fg: FG,
+  bg: BG,
+  bgTeal: brgb(0, 184, 219),
+  bgDim: brgb(12, 24, 30),
+  bgPanel: TRUECOLOR ? '\x1b[48;5;236m' : '\x1b[48;5;236m',
+  border: BORDER,
+  red: '\x1b[91m',
+  green: '\x1b[92m',
+  yellow: '\x1b[93m',
+  magenta: '\x1b[95m',
+  gray: '\x1b[90m',
+  white: '\x1b[97m',
+  orange: TRUECOLOR ? rgb(255, 140, 0) : '\x1b[38;5;208m',
+  // Cyan pushed slightly toward green — used for the Swarm mode badge so it reads
+  // as its own mode next to Plan (pure cyan) and Focus (blue) while staying in the
+  // theme's blue-green family. 38;5;43 is rgb(0,215,175): red at zero and green
+  // only 40 above blue, i.e. still clearly cyan with a green cast. 38;5;85 was the
+  // first attempt and read as plain GREEN — its red channel is lifted to 95 and
+  // green pins at 255, which is a spring green, not a green-tinted cyan.
+  spring: TRUECOLOR ? rgb(0, 215, 175) : '\x1b[38;5;43m',
+  // Git branch in the status line: yellow pulled about half way toward white, so
+  // it stays clearly "yellow" (not cream/ivory) while reading brighter than the
+  // plain 93 yellow on a dark background. rgb(255,219,110) keeps red at max,
+  // green near it, and blue around 43% — that ratio is what keeps the hue
+  // yellow rather than dropping into orange.
+  branch: TRUECOLOR ? rgb(255, 219, 110) : '\x1b[38;5;222m',
+  // Shell-mode (`!`) accent — violet, matching kimi-code's shellMode token so the
+  // bash-mode editor border and the `!` read as "shell", distinct from the cyan
+  // prompt and the yellow git badge. #BD93F9 dark / #7C3AED light.
+  shellMode: TRUECOLOR ? rgb(189, 147, 249) : '\x1b[38;5;141m',
+  bgRed: '\x1b[41m',
+  bgGreen: '\x1b[42m',
+  // Selection highlight (mouse text selection) and the scrollbar gutter.
+  // Selection uses a dark teal background so white text stays readable.
+  selBg: TRUECOLOR ? brgb(0, 70, 84) : '\x1b[48;5;23m', // Original dark cyan background
+  // Reset ONLY the background colour, keeping the current foreground. Used to end
+  // a selection highlight so text after it keeps its own colour (a bare ESC[0m
+  // would also reset the foreground, turning a cyan/white run grey).
+  bgReset: '\x1b[49m',
+  scrollTrack: '\x1b[90m',          // dim gutter
+  scrollThumb: TRUECOLOR ? rgb(0, 184, 219) : '\x1b[38;5;37m', // brand cyan-blue
+  // Scrollbar interaction states:
+  //   hover  -> a touch whiter/brighter than the brand colour
+  //   active -> BOLD + the brand colour (pressed/dragging)
+  // The pressed state used to be a DARKER colour, which on a dark background
+  // read as "the thumb disappeared". Making it bold-and-bright means a press is
+  // always unmistakably visible. Idle swaps back to scrollThumb automatically.
+  scrollThumbHover: TRUECOLOR ? rgb(120, 226, 245) : '\x1b[38;5;123m',
+  scrollThumbActive: '\x1b[1m' + (TRUECOLOR ? rgb(0, 220, 255) : '\x1b[38;5;51m'),
+  // Hover highlight for clickable rows (menu items, picker options, form
+  // fields, composer rows). An explicit bright foreground + BOLD rather than a
+  // bare BOLD: BOLD only brightens the 16-colour palette (it does nothing to a
+  // true-color row), which is why hover used to be invisible on most rows.
+  // tintRange() re-applies this so the row's own SGR codes cannot cancel it.
+  hover: '\x1b[1m' + rgb(190, 245, 255),
+};
+
+export function style(text, ...codes) {
+  return codes.join('') + text + '\x1b[0m';
+}
+
+// Linearly interpolate between two RGB triples and return an ANSI colour string.
+// Used for the pulsing Working indicator (orange pulses to a brighter/darker
+// shade over a 2s cycle).
+export function lerpColor(r1, g1, b1, r2, g2, b2, t) {
+  const ti = Math.max(0, Math.min(1, t));
+  const r = Math.round(r1 + (r2 - r1) * ti);
+  const g = Math.round(g1 + (g2 - g1) * ti);
+  const b = Math.round(b1 + (b2 - b1) * ti);
+  return rgb(r, g, b);
+}
+
+// Apply a named theme IN PLACE. `C` is a module-level object and ESM imports are
+// live bindings, so mutating its properties here changes the colours everywhere
+// without re-importing. Returns true when the name was recognised.
+export function setTheme(name) {
+  const t = THEMES[name];
+  if (!t) return false;
+  
+  // Update foreground colors
+  C.teal = rgb(...t.teal);
+  C.fg = rgb(...t.fg);
+  C.cyan = rgb(...t.cyan);
+  C.blue = rgb(...t.blue);
+  C.border = rgb(...t.border);
+  
+  // Update background colors
+  C.bg = brgb(...t.bg);
+  C.bgTeal = brgb(...t.teal);
+  C.bgPanel = brgb(...t.bg);
+  C.selBg = brgb(...t.selBg);
+  
+  // Scrollbar colours. The active (pressed/dragging) thumb is BOLD + a brighter
+  // shade of the theme colour. It used to be a DARKER shade, which on a dark
+  // background read as "the thumb vanished" mid-drag.
+  C.scrollTrack = '\x1b[90m'; // dim gutter
+  C.scrollThumb = rgb(...t.teal);
+  C.scrollThumbHover = rgb(...t.hover);
+  C.scrollThumbActive = '\x1b[1m' + rgb(
+    Math.min(255, Math.round(t.teal[0] * 0.6 + 255 * 0.4)),
+    Math.min(255, Math.round(t.teal[1] * 0.6 + 255 * 0.4)),
+    Math.min(255, Math.round(t.teal[2] * 0.6 + 255 * 0.4)),
+  );
+
+  // Hover stays visible on this theme's background (bright on dark, dark on light).
+  C.hover = '\x1b[1m' + rgb(...(t.hover || [190, 245, 255]));
+
+  // Semantic colors — swap to deep versions on light backgrounds.
+  if (t.white)  C.white  = rgb(...t.white);
+  if (t.gray)   C.gray   = rgb(...t.gray);
+  if (t.red)    C.red    = rgb(...t.red);
+  if (t.green)  C.green  = rgb(...t.green);
+  if (t.yellow) C.yellow = rgb(...t.yellow);
+  if (t.orange) C.orange = rgb(...t.orange);
+  // The git branch colour is derived per theme: the pale yellow that reads well
+  // on the dark background is nearly invisible on white, so on a light theme it
+  // is darkened (keeping the same hue) instead of being left as-is.
+  if (t.bg && t.bg[0] > 128) {
+    C.branch = rgb(146, 106, 0);           // dark amber for light backgrounds
+  } else {
+    C.branch = TRUECOLOR ? rgb(255, 219, 110) : '\x1b[38;5;222m';
+  }
+
+  return true;
+}
+
+export function clearScreen() {
+  return '\x1b[3J\x1b[H\x1b[2J';
+}
+
+// Clear screen and set background color based on current theme
+export function clearAndSetBg() {
+  // Reset all attributes first
+  const reset = '\x1b[0m';
+  // Clear screen
+  const clear = '\x1b[3J\x1b[H\x1b[2J';
+  // Set background color using current C.bg value
+  const bg = C.bg || '\x1b[48;2;0;18;26m'; // Default dark background
+  return reset + clear + bg;
+}
+export function eraseLine() {
+  return '\x1b[2K';
+}
+export function eraseScreen() {
+  return '\x1b[2J';
+}
+export function moveTo(r, c) {
+  return `\x1b[${r + 1};${c + 1}H`;
+}
+export function cursorUp(n) { return `\x1b[${n}A`; }
+export function cursorDown(n) { return `\x1b[${n}B`; }
+export function cursorLeft(n) { return `\x1b[${n}D`; }
+export function cursorForward(n) { return `\x1b[${n}C`; }
+export function hideCursor() { return '\x1b[?25l'; }
+export function showCursor() { return '\x1b[?25h'; }
+// Cursor shape: terminals accept DECSCUSR — 2 = block, 4 = underline, 6 = bar(I-beam);
+// 1/3/5 = blinking variants. Force a solid block cursor so positioning is always exact
+// and unaffected by I-beam alignment.
+export function blockCursor() { return '\x1b[2 q'; }
+export function underlineCursor() { return '\x1b[4 q'; }
+export function barCursor() { return '\x1b[6 q'; }
+export function alternateScreen(on) { return on ? '\x1b[?1049h' : '\x1b[?1049l'; }
+export function setScrollRegion(top, bottom) {
+  if (process.platform === 'win32') return ''; // win TTY scroll regions are unreliable
+  return `\x1b[${top + 1};${bottom + 1}r`;
+}
+export function resetScrollRegion() {
+  return '\x1b[r';
+}
+export function setBracketed(on) {
+  return `\x1b[?2004h${on ? '' : ''}`; // placeholder; real impl toggles bracketed paste
+}