hunkdiff 0.11.1 → 0.12.0-beta.1

package/dist/npm/opentui/model.d.ts

@@ -0,0 +1,16 @@
+import { type FileDiffMetadata } from "@pierre/diffs";
+import type { DiffFile } from "../core/types";
+import type { HunkDiffFile, HunkDiffFileInput } from "./types";
+/** Count visible additions and deletions from Pierre metadata. */
+export declare function countHunkDiffStats(metadata: FileDiffMetadata): {
+    additions: number;
+    deletions: number;
+};
+/** Build Hunk's public OpenTUI file model with normalized paths and default stats. */
+export declare function createHunkDiffFile(input: HunkDiffFileInput): HunkDiffFile;
+/** Adapt the public OpenTUI file shape into Hunk's internal review file model. */
+export declare function toInternalDiffFile(diff: HunkDiffFileInput): DiffFile;
+/** Parse unified diff text into Hunk's public OpenTUI file model. */
+export declare function createHunkDiffFilesFromPatch(patchText: string, sourceId?: string): HunkDiffFile[];
+/** Adapt a list of public OpenTUI files into Hunk's internal review file model. */
+export declare function toInternalDiffFiles(files: HunkDiffFileInput[]): DiffFile[];

package/dist/npm/opentui/themes.d.ts

@@ -0,0 +1,2 @@
+export declare const HUNK_DIFF_THEME_NAMES: readonly ["graphite", "midnight", "paper", "ember"];
+export type HunkDiffThemeName = (typeof HUNK_DIFF_THEME_NAMES)[number];

package/dist/npm/opentui/types.d.ts

@@ -0,0 +1,76 @@
+import type { FileDiffMetadata } from "@pierre/diffs";
+import type { HunkDiffThemeName } from "./themes";
+export type HunkDiffLayout = "split" | "stack";
+/** Line stats shown by public Hunk OpenTUI primitives. */
+export interface HunkDiffStats {
+    additions: number;
+    deletions: number;
+}
+/** Input accepted by public OpenTUI components before defaults are normalized. */
+export interface HunkDiffFileInput {
+    id: string;
+    metadata: FileDiffMetadata;
+    language?: string;
+    path?: string;
+    previousPath?: string;
+    patch?: string;
+    stats?: HunkDiffStats;
+    isBinary?: boolean;
+    isTooLarge?: boolean;
+    isUntracked?: boolean;
+    statsTruncated?: boolean;
+}
+/** Normalized diff file returned by createHunkDiffFile and patch helpers. */
+export interface HunkDiffFile extends Omit<HunkDiffFileInput, "stats"> {
+    stats: HunkDiffStats;
+}
+export interface HunkDiffSelection {
+    fileId: string;
+    hunkIndex: number;
+}
+/** Public props shared by single-file diff body and view components. */
+export interface HunkDiffBodyProps {
+    file?: HunkDiffFileInput;
+    layout?: HunkDiffLayout;
+    width: number;
+    theme?: HunkDiffThemeName;
+    showLineNumbers?: boolean;
+    showHunkHeaders?: boolean;
+    wrapLines?: boolean;
+    horizontalOffset?: number;
+    highlight?: boolean;
+    selectedHunkIndex?: number;
+}
+/** Public props for the reusable OpenTUI diff convenience component. */
+export interface HunkDiffViewProps extends Omit<HunkDiffBodyProps, "file"> {
+    diff?: HunkDiffFileInput;
+    scrollable?: boolean;
+}
+export interface HunkDiffFileHeaderProps {
+    file: HunkDiffFileInput;
+    width: number;
+    theme?: HunkDiffThemeName;
+    onSelect?: () => void;
+}
+export interface HunkReviewStreamProps {
+    files: HunkDiffFileInput[];
+    layout?: HunkDiffLayout;
+    width: number;
+    theme?: HunkDiffThemeName;
+    selection?: HunkDiffSelection;
+    showFileHeaders?: boolean;
+    showFileSeparators?: boolean;
+    showLineNumbers?: boolean;
+    showHunkHeaders?: boolean;
+    wrapLines?: boolean;
+    horizontalOffset?: number;
+    highlight?: boolean;
+    onSelectionChange?: (selection: HunkDiffSelection) => void;
+}
+export interface HunkFileNavProps {
+    files: HunkDiffFileInput[];
+    selectedFileId?: string;
+    width: number;
+    theme?: HunkDiffThemeName;
+    onSelectFile?: (fileId: string) => void;
+}

package/package.json

@@ -1,16 +1,25 @@
 {
   "name": "hunkdiff",
-  "version": "0.11.1",
+  "version": "0.12.0-beta.1",
   "description": "Desktop-inspired terminal diff viewer for understanding agent-authored changesets.",
   "bin": {
     "hunk": "./bin/hunk.cjs"
   },
   "files": [
     "bin",
+    "dist/npm",
     "skills",
     "README.md",
     "LICENSE"
   ],
+  "type": "module",
+  "exports": {
+    "./opentui": {
+      "types": "./dist/npm/opentui/index.d.ts",
+      "import": "./dist/npm/opentui/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "keywords": [
     "ai",
     "code-review",
@@ -30,11 +39,23 @@
   "engines": {
     "node": ">=18"
   },
+  "dependencies": {
+    "@pierre/diffs": "^1.1.19",
+    "bun": "^1.3.10",
+    "commander": "^14.0.3",
+    "diff": "^8.0.3",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "@opentui/core": "^0.1.88",
+    "@opentui/react": "^0.1.88",
+    "react": "^19.2.4"
+  },
   "optionalDependencies": {
-    "hunkdiff-darwin-arm64": "0.11.1",
-    "hunkdiff-darwin-x64": "0.11.1",
-    "hunkdiff-linux-arm64": "0.11.1",
-    "hunkdiff-linux-x64": "0.11.1"
+    "hunkdiff-darwin-arm64": "0.12.0-beta.1",
+    "hunkdiff-darwin-x64": "0.12.0-beta.1",
+    "hunkdiff-linux-arm64": "0.12.0-beta.1",
+    "hunkdiff-linux-x64": "0.12.0-beta.1"
   },
   "license": "MIT",
   "publishConfig": {

package/skills/hunk-review/SKILL.md

@@ -145,7 +145,7 @@ Guidelines:
 ## Common errors
 
 - **"No visible diff file matches ..."** -- the file is not in the loaded review. Check `context`, then `reload` if needed.
-- **"No active Hunk sessions"** -- ask the user to open Hunk in their terminal.
+- **"No active Hunk sessions"** -- if Hunk is visibly running, localhost may be blocked by the agent sandbox; retry with network/sandbox escalation. Otherwise ask the user to open Hunk.
 - **"Multiple active sessions match"** -- pass `<session-id>` explicitly.
 - **"No active Hunk session matches session path ..."** -- for advanced split-path reloads, verify the live window `Path` via `hunk session get` or `list`, then use `--session-path`.
 - **"Pass the replacement Hunk command after `--`"** -- include `--` before the nested `diff` / `show` command.