@aymanbagabas/drift 0.0.8 → 0.0.10

package/README.md

@@ -104,6 +104,31 @@ the `drift` binary on your `PATH`.
 
 Every method installs a `drift` binary.
 
+### Shell completions
+
+drift completes its flags and option values, paths after `--`, and git
+revisions: refs, commit hashes, `HEAD~2` ancestors, `HEAD@{1}` reflog entries,
+`@{upstream}`, `HEAD:src/` paths, and both ends of a range like
+`main..feature`.
+
+The Homebrew, deb, rpm, apk, AUR, and Nix packages set this up for bash, zsh,
+and fish. Otherwise, add the line for your shell to its startup file:
+
+```sh
+eval "$(drift --completions bash)"   # bash: ~/.bashrc
+source <(drift --completions zsh)    # zsh: ~/.zshrc, after compinit
+drift --completions fish | source    # fish: ~/.config/fish/completions/drift.fish
+```
+
+For PowerShell, add `drift --completions powershell | Out-String | Invoke-Expression`
+to `$PROFILE`. For Elvish, add `eval (drift --completions elvish | slurp)` to
+`rc.elv`.
+
+zsh and fish treat an unmatched `{` as brace expansion, and PowerShell treats
+it as the start of a script block. To complete a reflog entry in these shells,
+quote the word (`'HEAD@{`). In zsh and fish, you can also escape the brace
+(`HEAD@\{`).
+
 ## Use it
 
 ```sh
@@ -117,7 +142,7 @@ git diff | drift          # pager mode: read a diff from stdin
 ```
 
 > [!TIP]
-> Pair it with an AI agent. Leave `drift -w` open in a split while an agent (Copilot, Claude, etc.) works, every edit lands on screen instantly. Press <kbd>w</kbd> to freeze the view when you want to read, and again to resume.
+> Pair it with an AI agent. Leave `drift -w` open in a split while an agent (Copilot, Claude, etc.) works, every edit lands on screen instantly. Press <kbd>F</kbd> to freeze the view when you want to read, and again to resume.
 
 Make it your default git diff pager:
 
@@ -141,6 +166,8 @@ Some flags worth knowing:
 | `-C`, `--directory DIR` | Run as if started in `DIR` (worktrees, bare repos) |
 | `-c`, `--config FILE` | Use a specific config file |
 | `--no-syntax` | Turn off syntax highlighting for this run |
+| `--no-commit-meta` | Collapse the commit metadata to just the commit line |
+| `--wrap` / `--no-wrap` | Wrap long lines instead of scrolling horizontally |
 | `-U`, `--context N` | Lines of context around each change |
 | `--ignore-whitespace` | Ignore whitespace-only changes |
 | `--diff-algorithm ALGO` | `myers`, `minimal`, `patience`, or `histogram` |
@@ -155,7 +182,7 @@ Some flags worth knowing:
 | `0` `$` | Scroll to line start / end |
 | `d` `u` / `^d` `^u` | Half page down / up |
 | `space` `f` `^f` / `b` `^b` | Full page down / up |
-| `^e` `^y` | Scroll one line down / up |
+| `e` `y` / `^e` `^y` | Scroll one line down / up |
 | `g` `G` | Top / bottom |
 | `H` `M` `L` | Cursor to screen top / middle / bottom |
 | `{` `}` | Previous / next hunk |
@@ -163,14 +190,16 @@ Some flags worth knowing:
 | `/` | Search the current file (regex, smart-case) |
 | `n` `N` | Next / previous match |
 | `s` | Toggle split view |
-| `F` | File list modal |
+| `w` | Toggle line wrapping (long lines wrap instead of scrolling horizontally) |
+| `S` | File stats modal |
 | `B` | Toggle the file sidebar |
-| `w` | Toggle watch mode |
+| `F` | Toggle watch mode (follow changes, like `less`) |
+| `a` | Toggle untracked files (worktree view) |
 | `V` | Start / cancel a line selection; any motion key extends it |
-| `y` | Copy the selection, or the cursor line when nothing is selected |
-| `Y` | Copy the whole current file |
-| `enter` | Expand folded context, or open the file at the cursor |
-| `v` | Open the current file in `$EDITOR` |
+| `c` | Copy the selection, or the cursor line when nothing is selected |
+| `C` | Copy the whole current file |
+| `enter` | On a hunk header, expand folded context; on the commit line, expand / collapse the commit metadata |
+| `o` | Open the current file in `$EDITOR` |
 | `r` | Refresh |
 | `?` | Toggle the help footer |
 | `q` | Quit |
@@ -185,6 +214,8 @@ drift is fully mouse-driven too:
 - Drag the sidebar's divider to resize it, live.
 - In split view, drag the divider between the two panes to rebalance them.
 - Click the `? help` badge in the status bar to toggle the help footer.
+- Double-click the commit line to expand or collapse the commit metadata; on a
+  hunk header, double-click expands the folded context.
 - Drag across the diff to select text; it lands on your system clipboard (over
   SSH too, via OSC 52). In split view the selection stays within one pane, so
   you copy just the old or just the new side.
@@ -241,6 +272,12 @@ theme         = "onedark"   # any built-in or syntect theme name
 syntax        = true        # highlight diff content
 intraline     = true        # word-level change emphasis
 line-numbers  = true        # old/new line-number gutter
+commit-meta   = true        # expand author/date/message; the commit line always shows for a single commit
+wrap          = false       # wrap long lines instead of scrolling horizontally (toggle with w)
+wrap-symbol   = "↪"         # symbol shown at the start of each wrapped continuation line
+expand-symbol = "›"         # gutter symbol on the collapsed commit line (expand to show metadata)
+collapse-symbol = "⌄"       # gutter symbol on the expanded commit line (collapse to hide metadata)
+context-symbol = "⋯"        # gutter symbol on a hunk header (reveal more context)
 tab-width     = 4
 editor        = ""          # falls back to $VISUAL, then $EDITOR, then vi
 sidebar       = "auto"      # "auto" (opens at width >= 150), "always", or "never"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aymanbagabas/drift",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "A standalone git diff pager for the terminal.",
   "bin": {
     "drift": "bin/drift.js"