pi-startup-redraw-fix 0.1.10 → 0.1.12

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [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
+- Widened peer dependency ranges to `^0.74.0 || ^0.75.0`
+
 ## [0.1.10] - 2026-05-22
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-startup-redraw-fix",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Pi extension that patches terminal full-clear ordering to avoid startup redraw glitches.",
   "type": "module",
   "main": "./index.ts",
@@ -58,7 +58,7 @@
     ]
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.75.4",
-    "@earendil-works/pi-tui": "^0.75.4"
+    "@earendil-works/pi-coding-agent": "^0.74.0 || ^0.75.0 || ^0.77.0 || ^0.78.0",
+    "@earendil-works/pi-tui": "^0.74.0 || ^0.75.0 || ^0.77.0 || ^0.78.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

@@ -1,18 +1,23 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-
-import { applyTerminalClearSequencePatch } from "./terminal-clear-patch.js";
-
-export default function startupRedrawFixExtension(pi: ExtensionAPI): void {
-  const patchResult = applyTerminalClearSequencePatch();
-
-  pi.on("session_start", async (_event, ctx) => {
-    if (!ctx.hasUI) {
-      return;
-    }
-
-    if (!patchResult.patched && !patchResult.alreadyPatched) {
-      const reason = patchResult.error ?? "unknown error";
-      ctx.ui.notify(`startup-redraw-fix: failed to patch terminal clear sequence (${reason})`, "warning");
-    }
-  });
-}
+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) => {
+    if (!ctx.hasUI) {
+      return;
+    }
+
+    if (!patchResult.patched && !patchResult.alreadyPatched) {
+      const reason = patchResult.error ?? "unknown error";
+      ctx.ui.notify(`startup-redraw-fix: failed to patch terminal clear sequence (${reason})`, "warning");
+    }
+  });
+}

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,44 +1,53 @@
-import { ProcessTerminal } from "@earendil-works/pi-tui";
-
-import { normalizeTerminalClearSequence } from "./normalize-clear-sequence.js";
-
-const PATCH_FLAG_KEY = "__piStartupRedrawFixPatched__" as const;
-
-type ProcessTerminalPrototype = typeof ProcessTerminal.prototype & {
-  [PATCH_FLAG_KEY]?: boolean;
-};
-
-export interface PatchResult {
-  patched: boolean;
-  alreadyPatched: boolean;
-  error?: string;
-}
-
-export function applyTerminalClearSequencePatch(): PatchResult {
-  const prototype = ProcessTerminal.prototype as ProcessTerminalPrototype;
-
-  if (prototype[PATCH_FLAG_KEY]) {
-    return { patched: false, alreadyPatched: true };
-  }
-
-  const originalWrite = prototype.write;
-  if (typeof originalWrite !== "function") {
-    return {
-      patched: false,
-      alreadyPatched: false,
-      error: "ProcessTerminal.write is unavailable",
-    };
-  }
-
-  prototype.write = function patchedProcessTerminalWrite(data: string): void {
-    const normalized = typeof data === "string"
-      ? normalizeTerminalClearSequence(data)
-      : data;
-
-    originalWrite.call(this, normalized);
-  };
-
-  prototype[PATCH_FLAG_KEY] = true;
-
-  return { patched: true, alreadyPatched: false };
-}
+import { ProcessTerminal } from "@earendil-works/pi-tui";
+
+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;
+
+type ProcessTerminalPrototype = typeof ProcessTerminal.prototype & {
+  [PATCH_FLAG_KEY]?: boolean;
+};
+
+export interface PatchResult {
+  patched: boolean;
+  alreadyPatched: boolean;
+  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);
+}
+
+export function applyTerminalClearSequencePatch(): PatchResult {
+  const prototype = ProcessTerminal.prototype as ProcessTerminalPrototype;
+
+  if (prototype[PATCH_FLAG_KEY]) {
+    return { patched: false, alreadyPatched: true };
+  }
+
+  const originalWrite = prototype.write;
+  if (typeof originalWrite !== "function") {
+    return {
+      patched: false,
+      alreadyPatched: false,
+      error: "ProcessTerminal.write is unavailable",
+    };
+  }
+
+  prototype.write = function patchedProcessTerminalWrite(data: string): void {
+    const normalized = typeof data === "string"
+      ? normalizeTerminalClearSequence(data)
+      : data;
+
+    originalWrite.call(this, normalized);
+  };
+
+  prototype[PATCH_FLAG_KEY] = true;
+
+  return { patched: true, alreadyPatched: false };
+}