pi-diff-widget 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.3] - 2026-10-12
+
+### Added
+
+- `pi.image` gallery preview: a screenshot of the live edits widget, shown on the
+  pi.dev package page and in the README.
+
 ## [0.1.2] - 2026-10-12
 
 ### Changed

package/README.md

@@ -2,6 +2,8 @@
 
 Interactive diff viewer and live edits widget for [pi](https://pi.dev).
 
+![Live edits widget showing 4 files, +17 -2](https://cdn.jsdelivr.net/gh/omgzsa/pi-diff-widget@v0.1.3/docs/widget.png)
+
 ## Install
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pi-diff-widget",
-    "version": "0.1.2",
+    "version": "0.1.3",
     "description": "Interactive diff viewer for pi: uncommitted changes and per-turn diffs",
     "keywords": [
         "pi-package",
@@ -26,6 +26,7 @@
         "LICENSE"
     ],
     "pi": {
+        "image": "https://cdn.jsdelivr.net/gh/omgzsa/pi-diff-widget@v0.1.3/docs/widget.png",
         "extensions": [
             "./src/index.ts"
         ]

package/src/baseline.ts

@@ -38,7 +38,11 @@ export async function readBaseline(
     return { content, existed: true };
 }
 
-/** Content only, for callers that do not care whether the file existed. */
+/**
+ * Content only, for callers that do not care whether the file existed. A missing
+ * path returns an empty string, not undefined, so callers that must tell a
+ * vanished file apart from an empty one use readBaseline or locationGone.
+ */
 export async function readFileCapped(
     path: string,
     maxBytes = MAX_BASELINE_BYTES,

package/src/git.ts

@@ -19,6 +19,8 @@ export interface DiffFile {
     diff: string;
 }
 
+// Files larger than this are reported as too-large instead of read into memory,
+// and diffs are cut off at the line cap so one huge file cannot stall the view.
 const MAX_TEXT_BYTES = 512 * 1024;
 const MAX_DIFF_LINES = 4000;
 

package/src/ui.ts

@@ -76,7 +76,9 @@ export class DiffViewer implements Component {
             const label = this.turns[this.turnIndex]?.label ?? '';
             return `${this.title} · turns  ${this.theme.fg('dim', `${counter} ${label}`)}`;
         }
-        return `${this.title} · uncommitted  ${this.theme.fg('dim', `[${this.uncommitted.length} files]`)}`;
+        const count = this.uncommitted.length;
+        const label = count === 1 ? '1 file' : `${count} files`;
+        return `${this.title} · uncommitted  ${this.theme.fg('dim', `[${label}]`)}`;
     }
 
     private footerHint(): string {