pi-startup-redraw-fix 0.1.11 → 0.1.13

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [Unreleased]
+
+## [0.1.13] - 2026-06-16
+
+### Fixed
+- Buffered trailing broken clear-sequence prefixes across multiple `write` calls so split escape sequences that arrive in separate chunks are correctly normalized instead of being silently discarded.
+
+## [0.1.12] - 2026-06-01
+
+### Changed
+- Consolidated clear-sequence constants and normalization into the terminal clear patch while preserving synchronous startup patching.
+- Widened peer dependency ranges to `^0.74.0 || ^0.75.0 || ^0.77.0 || ^0.78.0`.
+
 ## [0.1.11] - 2026-05-26
 
 ### Changed

package/package.json

@@ -1,64 +1,64 @@
-{
-  "name": "pi-startup-redraw-fix",
-  "version": "0.1.11",
-  "description": "Pi extension that patches terminal full-clear ordering to avoid startup redraw glitches.",
-  "type": "module",
-  "main": "./index.ts",
-  "exports": {
-    ".": "./index.ts"
-  },
-  "files": [
-    "index.ts",
-    "src",
-    "asset",
-    "config/config.example.json",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "npx --yes -p typescript@5.7.3 tsc -p tsconfig.json --noCheck",
-    "lint": "npm run build",
-    "test": "npx --yes tsx --test normalize-clear-sequence.test.mjs",
-    "check": "npm run lint && npm run test"
-  },
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "pi-coding-agent",
-    "pi-tui",
-    "coding-agent",
-    "terminal",
-    "terminal-emulator",
-    "startup",
-    "startup-fix",
-    "redraw",
-    "bugfix"
-  ],
-  "author": "MasuRii",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MasuRii/pi-startup-redraw-fix.git"
-  },
-  "bugs": {
-    "url": "https://github.com/MasuRii/pi-startup-redraw-fix/issues"
-  },
-  "homepage": "https://github.com/MasuRii/pi-startup-redraw-fix#readme",
-  "engines": {
-    "node": ">=20"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "pi": {
-    "extensions": [
-      "./index.ts"
-    ]
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.74.0 || ^0.75.0",
-    "@earendil-works/pi-tui": "^0.74.0 || ^0.75.0"
-  }
-}
+{
+  "name": "pi-startup-redraw-fix",
+  "version": "0.1.13",
+  "description": "Pi extension that patches terminal full-clear ordering to avoid startup redraw glitches.",
+  "type": "module",
+  "main": "./index.ts",
+  "exports": {
+    ".": "./index.ts"
+  },
+  "files": [
+    "index.ts",
+    "src",
+    "asset",
+    "config/config.example.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npx --yes -p typescript@5.7.3 tsc -p tsconfig.json --noCheck",
+    "lint": "npm run build",
+    "test": "npx --yes tsx --test normalize-clear-sequence.test.mjs",
+    "check": "npm run lint && npm run test"
+  },
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "pi-coding-agent",
+    "pi-tui",
+    "coding-agent",
+    "terminal",
+    "terminal-emulator",
+    "startup",
+    "startup-fix",
+    "redraw",
+    "bugfix"
+  ],
+  "author": "MasuRii",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MasuRii/pi-startup-redraw-fix.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MasuRii/pi-startup-redraw-fix/issues"
+  },
+  "homepage": "https://github.com/MasuRii/pi-startup-redraw-fix#readme",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.74.0 || ^0.75.0 || ^0.77.0 || ^0.78.0 || ^0.79.0",
+    "@earendil-works/pi-tui": "^0.74.0 || ^0.75.0 || ^0.77.0 || ^0.78.0 || ^0.79.0"
+  }
+}

package/src/constants.ts

@@ -1,2 +1 @@
-export const BROKEN_FULL_CLEAR_SEQUENCE = "\x1b[3J\x1b[2J\x1b[H";
-export const FIXED_FULL_CLEAR_SEQUENCE = "\x1b[H\x1b[2J\x1b[3J";
+export { BROKEN_FULL_CLEAR_SEQUENCE, FIXED_FULL_CLEAR_SEQUENCE } from "./terminal-clear-patch.js";

package/src/index.ts

@@ -3,6 +3,11 @@ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { applyTerminalClearSequencePatch } from "./terminal-clear-patch.js";
 
 export default function startupRedrawFixExtension(pi: ExtensionAPI): void {
+  // The terminal clear-sequence patch must be installed before the first
+  // full-clear write at startup, so it is applied synchronously at registration
+  // rather than deferred. The local import graph is tiny (a few dozen lines) and
+  // the only package dependency, pi-tui, is already loaded by Pi core, so there
+  // is no meaningful startup transpile cost to defer here.
   const patchResult = applyTerminalClearSequencePatch();
 
   pi.on("session_start", async (_event, ctx) => {

package/src/normalize-clear-sequence.ts

@@ -1,9 +1 @@
-import { BROKEN_FULL_CLEAR_SEQUENCE, FIXED_FULL_CLEAR_SEQUENCE } from "./constants.js";
-
-export function normalizeTerminalClearSequence(data: string): string {
-  if (!data.includes(BROKEN_FULL_CLEAR_SEQUENCE)) {
-    return data;
-  }
-
-  return data.split(BROKEN_FULL_CLEAR_SEQUENCE).join(FIXED_FULL_CLEAR_SEQUENCE);
-}
+export { normalizeTerminalClearSequence } from "./terminal-clear-patch.js";

package/src/terminal-clear-patch.ts

@@ -1,6 +1,7 @@
 import { ProcessTerminal } from "@earendil-works/pi-tui";
 
-import { normalizeTerminalClearSequence } from "./normalize-clear-sequence.js";
+export const BROKEN_FULL_CLEAR_SEQUENCE = "\x1b[3J\x1b[2J\x1b[H";
+export const FIXED_FULL_CLEAR_SEQUENCE = "\x1b[H\x1b[2J\x1b[3J";
 
 const PATCH_FLAG_KEY = "__piStartupRedrawFixPatched__" as const;
 
@@ -14,6 +15,31 @@ export interface PatchResult {
   error?: string;
 }
 
+export function normalizeTerminalClearSequence(data: string): string {
+  if (!data.includes(BROKEN_FULL_CLEAR_SEQUENCE)) {
+    return data;
+  }
+
+  return data.split(BROKEN_FULL_CLEAR_SEQUENCE).join(FIXED_FULL_CLEAR_SEQUENCE);
+}
+
+function splitTrailingBrokenClearPrefix(data: string): { ready: string; pending: string } {
+  const maxPrefixLength = BROKEN_FULL_CLEAR_SEQUENCE.length - 1;
+  const maxCandidateLength = Math.min(maxPrefixLength, data.length);
+
+  for (let length = maxCandidateLength; length > 0; length -= 1) {
+    const suffix = data.slice(-length);
+    if (BROKEN_FULL_CLEAR_SEQUENCE.startsWith(suffix)) {
+      return {
+        ready: data.slice(0, -length),
+        pending: suffix,
+      };
+    }
+  }
+
+  return { ready: data, pending: "" };
+}
+
 export function applyTerminalClearSequencePatch(): PatchResult {
   const prototype = ProcessTerminal.prototype as ProcessTerminalPrototype;
 
@@ -30,12 +56,25 @@ export function applyTerminalClearSequencePatch(): PatchResult {
     };
   }
 
+  let pendingClearPrefix = "";
+
   prototype.write = function patchedProcessTerminalWrite(data: string): void {
-    const normalized = typeof data === "string"
-      ? normalizeTerminalClearSequence(data)
-      : data;
+    if (typeof data !== "string") {
+      if (pendingClearPrefix.length > 0) {
+        originalWrite.call(this, pendingClearPrefix);
+        pendingClearPrefix = "";
+      }
+      originalWrite.call(this, data);
+      return;
+    }
+
+    const combined = `${pendingClearPrefix}${data}`;
+    const { ready, pending } = splitTrailingBrokenClearPrefix(combined);
+    pendingClearPrefix = pending;
 
-    originalWrite.call(this, normalized);
+    if (ready.length > 0) {
+      originalWrite.call(this, normalizeTerminalClearSequence(ready));
+    }
   };
 
   prototype[PATCH_FLAG_KEY] = true;