pi-diff-widget 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -4,6 +4,21 @@ 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
+
+- README: document the `/diff-widget` actions (`on`, `off`, `accept`, `reject`)
+  as a table, link them from the `/diff` usage section, and correct the
+  local-checkout path in the install block.
+
 ## [0.1.1] - 2026-09-25
 
 ### Fixed

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
@@ -9,7 +11,7 @@ pi install npm:pi-diff-widget
 # straight from the repo, no npm required
 pi install git:github.com/omgzsa/pi-diff-widget
 # or from a local checkout
-pi install /absolute/path/to/pi-diff
+pi install /absolute/path/to/pi-diff-widget
 ```
 
 ## Usage
@@ -38,6 +40,9 @@ Keys:
 - `g` / `G`: jump to top / bottom
 - `q` / `Esc`: close
 
+See [Live edits widget](#live-edits-widget) for the `/diff-widget` actions
+(`on`, `off`, `accept`, `reject`).
+
 ## Live edits widget
 
 Above the editor, pi-diff shows the net effect of the agent's edits this
@@ -55,14 +60,34 @@ touch and diffs it against the current content. Reverted files drop out and the
 counts are net, so it shows what the agent has actually changed, not cumulative
 churn. Committing a file drops it from the panel automatically, so what remains
 is the agent's work that is not yet committed. Paths are shown relative to the
-working directory. Baselines live in the session, capped at 256 KB per file.
-
-It hides itself when nothing differs. `/diff-widget` toggles it. `/diff-widget
-accept` (alias `keep`) makes the current state the new baseline, the equivalent of
-Zed's Keep All. `/diff-widget reject` restores every tracked file to its
-pre-agent content, deleting files the agent created and recreating ones it
-deleted. It asks for confirmation first, and cannot be undone. Unknown actions
-report a warning rather than toggling the widget.
+working directory. Baselines live in the session, capped at 256 KB per file. A
+baseline whose parent directory no longer exists is dropped, so a checkout you
+move or delete stops counting as a whole-file deletion.
+
+It hides itself when nothing differs.
+
+### `/diff-widget` actions
+
+| Command | Effect |
+|---|---|
+| `/diff-widget` | Toggle the panel. With no argument it shows a hidden panel and hides a visible one |
+| `/diff-widget on` | Show it |
+| `/diff-widget off` | Hide it |
+| `/diff-widget accept` | Keep the agent's edits: the current content becomes the baseline and the panel clears. Alias: `keep` |
+| `/diff-widget reject` | Undo the agent's edits: restore every tracked file to its pre-agent content, delete the files the agent created, and recreate the ones it deleted |
+
+`accept` is Zed's Keep All. `reject` asks for confirmation first, naming up to
+five affected paths, and cannot be undone. Whole files only: there is no
+hunk-level accept or reject. With nothing to reject it reports `Nothing to
+reject`, and any unrecognized argument warns instead of toggling the panel, so a
+typo never hides the widget by accident.
+
+```
+/diff-widget
+/diff-widget on
+/diff-widget accept
+/diff-widget reject
+```
 
 ## Status
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pi-diff-widget",
-    "version": "0.1.1",
+    "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 {