@abelfubu/dv 0.1.0 → 1.0.0

package/README.md

@@ -0,0 +1,111 @@
+# `dv` — Diffview
+
+A fast, keyboard-driven diff viewer for the terminal. Pipe any `git diff` into it and navigate changes with a TUI, copy selections, switch themes, and more.
+
+![license](https://img.shields.io/npm/l/@abelfubu/dv)
+
+## Install
+
+```bash
+bun install -g @abelfubu/dv
+```
+
+Requires [Bun](https://bun.sh/).
+
+## Usage
+
+```bash
+# Pipe git diff output
+git diff | dv
+
+# Diff specific refs
+git diff main...feature | dv
+
+# Show working tree changes (default when stdin is empty)
+dv
+
+# Scrollback mode for non-TTY output
+git diff | dv --scrollback
+
+# Transparent background
+dv --transparent
+
+# Watch for changes
+dv --watch
+```
+
+## Features
+
+- **Interactive TUI** built with [`@opentuah/react`](https://github.com/opentuah/opentuah)
+- **Unified and split view** modes (auto-switches based on terminal width)
+- **Directory tree** sidebar for jumping between files
+- **Keyboard selection** and **clipboard copy** of diff text
+- **Syntax highlighting** via Tree-sitter parsers
+- **Themes** — switch at runtime
+- **Transparent background** mode
+- **Scrollback output** when stdout isn't a TTY
+- **Watch mode** for live diff updates
+- **Submodule support** — dirty submodules shown inline
+- **Untracked files** displayed via synthetic diffs
+
+## Keybindings
+
+| Key | Action |
+| --- | --- |
+| `↑` / `↓` or `k` / `j` | Move cursor |
+| `←` / `→` or `h` / `l` | Switch focus (tree / diff) |
+| `Enter` | Jump to file under cursor |
+| `Tab` | Toggle focus between tree and diff |
+| `u` | Toggle unified / split view |
+| `v` | Set selection anchor |
+| `y` | Copy selected diff content |
+| `t` | Cycle themes |
+| `T` | Toggle transparent background |
+| `c` | Change context lines |
+| `r` | Refresh diff |
+| `q` / `Esc` | Quit |
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run in development
+bun run cli
+
+# Watch mode
+bun run cli:watch
+
+# Build
+cd /Users/abelfubu/dev/diffview && bun run build
+
+# Run tests
+bun test
+```
+
+## Project Structure
+
+```
+.
+├── src/
+│   ├── cli.tsx              # CLI entrypoint
+│   ├── components/          # React/TUI components
+│   ├── diff-*.ts            # Diff parsing, cursor, copy utilities
+│   ├── themes.ts            # Theme definitions
+│   ├── store.ts             # Persistent state
+│   └── parsers/             # Tree-sitter syntax parsers
+├── docs/                    # ADRs and feature docs
+├── dist/                    # Compiled output
+└── package.json
+```
+
+## Docs
+
+- [`docs/adr-cursor-selection.md`](docs/adr-cursor-selection.md)
+- [`docs/transparent-background.md`](docs/transparent-background.md)
+- [`CONTEXT.md`](CONTEXT.md) — domain glossary
+
+## License
+
+MIT

package/dist/cli-copy-notification.test.js

@@ -43,7 +43,7 @@ describe("App copy notification", () => {
     });
     it("shows a transient success notification after copying selected lines", async () => {
         const parsedFiles = [createParsedFile("a.ts")];
-        testSetup = await testRender(_jsx(App, { parsedFiles: parsedFiles }), {
+        testSetup = await testRender(_jsx(App, { parsedFiles: parsedFiles, copyNotificationDuration: 100 }), {
             width: 120,
             height: 16,
         });
@@ -61,15 +61,19 @@ describe("App copy notification", () => {
             testSetup.mockInput.pressKey("j");
             await testSetup.renderOnce();
         });
+        testSetup.mockInput.pressKey("y");
+        // The toast registers a post-render callback from an effect, and on the
+        // single-threaded Linux test renderer the state update isn't flushed in
+        // time for the next renderOnce(). Yield briefly before rendering.
+        await new Promise((resolve) => setTimeout(resolve, 50));
         await act(async () => {
-            testSetup.mockInput.pressKey("y");
             await testSetup.renderOnce();
         });
         const frame = testSetup.captureCharFrame();
         expect(frame).toContain("Copied 2 lines");
         expect(frame).toContain("✓");
         // Wait for the auto-hide timeout to clear the notification.
-        await new Promise((resolve) => setTimeout(resolve, 2500));
+        await new Promise((resolve) => setTimeout(resolve, 150));
         await act(async () => {
             await testSetup.renderOnce();
         });

package/dist/cli.d.ts

@@ -4,6 +4,8 @@ import * as React from "react";
 import { type ParsedFile } from "./diff-utils.js";
 export interface AppProps {
     parsedFiles: ParsedFile[];
+    /** Duration (ms) the copy notification toast stays visible. Defaults to 2000. */
+    copyNotificationDuration?: number;
 }
-export declare function App({ parsedFiles }: AppProps): React.ReactNode;
+export declare function App({ parsedFiles, copyNotificationDuration }: AppProps): React.ReactNode;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.tsx"],"names":[],"mappings":";AAOA,OAAO,gCAAgC,CAAC;AAoBxC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAgB/B,OAAO,EAoBN,KAAK,UAAU,EACf,MAAM,iBAAiB,CAAC;AAuIzB,MAAM,WAAW,QAAQ;IACxB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC1B;AAKD,wBAAgB,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE,QAAQ,GAAG,KAAK,CAAC,SAAS,CAuzB9D"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.tsx"],"names":[],"mappings":";AAOA,OAAO,gCAAgC,CAAC;AAoBxC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAgB/B,OAAO,EAoBN,KAAK,UAAU,EACf,MAAM,iBAAiB,CAAC;AAuIzB,MAAM,WAAW,QAAQ;IACxB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,iFAAiF;IACjF,wBAAwB,CAAC,EAAE,MAAM,CAAC;CAClC;AAKD,wBAAgB,GAAG,CAAC,EAAE,WAAW,EAAE,wBAA+B,EAAE,EAAE,QAAQ,GAAG,KAAK,CAAC,SAAS,CAuzB/F"}

package/dist/cli.js

@@ -110,7 +110,7 @@ class ScrollAcceleration {
 }
 const SIDEBAR_GAP = 2;
 const APP_HORIZONTAL_PADDING = 2;
-export function App({ parsedFiles }) {
+export function App({ parsedFiles, copyNotificationDuration = 2000 }) {
     const { width: initialWidth, height: initialHeight } = useTerminalDimensions();
     const [width, setWidth] = React.useState(initialWidth);
     const [_terminalHeight, setTerminalHeight] = React.useState(initialHeight);
@@ -231,7 +231,7 @@ export function App({ parsedFiles }) {
         copyNotificationTimeoutRef.current = setTimeout(() => {
             setCopyNotification(null);
             copyNotificationTimeoutRef.current = null;
-        }, 2000);
+        }, copyNotificationDuration);
         return () => {
             if (copyNotificationTimeoutRef.current) {
                 clearTimeout(copyNotificationTimeoutRef.current);

package/dist/components/toast.js

@@ -10,7 +10,7 @@ import {} from "../themes.js";
  */
 export function Toast({ message, type, title, theme, transparentBackground }) {
     const renderer = useRenderer();
-    React.useEffect(() => {
+    React.useLayoutEffect(() => {
         const borderColor = RGBA.fromHex(type === "success" ? "#2d8a47" : "#c53b53");
         const bgColor = transparentBackground ? RGBA.fromInts(0, 0, 0, 0) : theme.background;
         const fgColor = theme.text;

package/package.json

@@ -1,9 +1,11 @@
 {
 	"name": "@abelfubu/dv",
 	"type": "module",
-	"version": "0.1.0",
+	"version": "1.0.0",
 	"license": "MIT",
-	"bin": "./dist/cli.js",
+	"bin": {
+		"dv": "./dist/cli.js"
+	},
 	"publishConfig": {
 		"access": "public"
 	},
@@ -17,8 +19,13 @@
 		"build": "rm -rf dist && tsc",
 		"prepublishOnly": "bun run build"
 	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/abelfubu/diffview.git"
+	},
 	"devDependencies": {
 		"@types/bun": "1.3.5",
+		"semantic-release": "^24.2.3",
 		"tuistory": "^0.0.13",
 		"typescript": "^5.9.3"
 	},