@nkzw/codiff-core 1.8.1

package/dist/app/components/walkthrough/useNarrativeNavigation.d.ts

@@ -0,0 +1,34 @@
+import type { ChangedFile, NarrativeWalkthrough } from '../../../types.ts';
+export type NarrativeViewMode = 'stop' | 'support' | 'commit';
+export type NarrativeNavigation = ReturnType<typeof useNarrativeNavigation>;
+/**
+ * Shared navigation state for the narrative walkthrough, owned by App and passed
+ * to both the sidebar table-of-contents and the main hybrid view.
+ */
+export declare const useNarrativeNavigation: (walkthrough: NarrativeWalkthrough | null, files: ReadonlyArray<ChangedFile>, resetKey?: string) => {
+    commitBody: string;
+    commitSelected: ReadonlySet<string>;
+    commitSubject: string;
+    enterCommit: () => void;
+    goNext: () => void;
+    goPrev: () => void;
+    goStop: (target: number) => void;
+    index: number;
+    mode: NarrativeViewMode;
+    openSupport: () => void;
+    releaseStopScrollLock: () => void;
+    scrollTarget: {
+        index: number;
+        nonce: number;
+    };
+    setCommitBody: (value: string) => void;
+    setCommitSubject: (value: string) => void;
+    supportScrollRequest: number;
+    supportVisited: boolean;
+    syncIndexFromScroll: (target: number) => void;
+    syncSupportFromScroll: () => void;
+    toggleCommitFile: (path: string) => void;
+    toggleCommitGroup: (paths: ReadonlyArray<string>) => void;
+    visited: ReadonlySet<string>;
+    walkthroughView: import("../../../lib/narrative-walkthrough.ts").WalkthroughView | null;
+};

package/dist/app/hooks/useAppCommands.d.ts

@@ -0,0 +1,22 @@
+import { type RefObject } from 'react';
+import type { ReviewComment, ReviewIdentity, SidebarMode } from '../../lib/app-types.ts';
+import { type Command } from '../../lib/command-registry.ts';
+import type { ReviewCommandTarget } from '../../lib/review-command-target.ts';
+import type { ChangedFile, CodiffPreferences, RepositoryState } from '../../types.ts';
+type UseAppCommandsOptions = {
+    changeSidebarMode: (mode: SidebarMode) => void;
+    focusFileFilter: () => void;
+    getReviewCommandTarget: () => ReviewCommandTarget | null;
+    onOpenDiffSearch: () => void;
+    onOpenSelectedFile: () => void;
+    onRefreshRepository: () => void;
+    onToggleSidebar: () => void;
+    onToggleViewed: (file: ChangedFile, isViewed: boolean, reviewIdentity: ReviewIdentity) => void;
+    onToggleWordWrap: () => void;
+    preferencesRef: RefObject<CodiffPreferences>;
+    reviewCommentsRef: RefObject<ReadonlyArray<ReviewComment>>;
+    stateRef: RefObject<RepositoryState | null>;
+    viewedRef: RefObject<Record<string, string>>;
+};
+export declare function useAppCommands({ changeSidebarMode, focusFileFilter, getReviewCommandTarget, onOpenDiffSearch, onOpenSelectedFile, onRefreshRepository, onToggleSidebar, onToggleViewed, onToggleWordWrap, preferencesRef, reviewCommentsRef, stateRef, viewedRef, }: UseAppCommandsOptions): readonly Command[];
+export {};

package/dist/app/hooks/useAppKeyboardShortcuts.d.ts

@@ -0,0 +1,18 @@
+import type { CodiffKeymap } from '../../config/types.ts';
+type UseAppKeyboardShortcutsOptions = {
+    keymap: CodiffKeymap;
+    navigateHunks: (direction: 1 | -1) => void;
+    onFocusFileFilter: () => void;
+    onOpenDiffSearch: () => void;
+    onOpenSelectedFile: () => void;
+    onToggleSidebar: () => void;
+    onToggleWordWrap: () => void;
+    shouldDeferHunkNavigation: () => boolean;
+    sidebarCollapsed: boolean;
+};
+export declare function useAppKeyboardShortcuts({ keymap, navigateHunks, onFocusFileFilter, onOpenDiffSearch, onOpenSelectedFile, onToggleSidebar, onToggleWordWrap, shouldDeferHunkNavigation, sidebarCollapsed, }: UseAppKeyboardShortcutsOptions): {
+    closeCommandBar: () => void;
+    commandBarVisible: boolean;
+    shortcutsHelpVisible: boolean;
+};
+export {};

package/dist/app/hooks/useAppReviewComments.d.ts

@@ -0,0 +1,38 @@
+import { type RefObject } from 'react';
+import type { ReviewComment } from '../../lib/app-types.ts';
+import type { PullRequestReviewEvent, PullRequestReviewStatus, RepositoryState } from '../../types.ts';
+type UseAppReviewCommentsOptions = {
+    isReviewActionDisabled: (reviewStatus: PullRequestReviewStatus | undefined, event: PullRequestReviewEvent) => boolean;
+    onCommentFileChange: (filePath: string) => void;
+    stateRef: RefObject<RepositoryState | null>;
+};
+export declare function useAppReviewComments({ isReviewActionDisabled, onCommentFileChange, stateRef, }: UseAppReviewCommentsOptions): {
+    activeReviewCommentDraftRef: RefObject<{
+        body: string;
+        id: string;
+    } | null>;
+    activeReviewCommentDraftState: {
+        body: string;
+        id: string;
+    } | null;
+    clearCommentFocus: (commentId: string) => void;
+    createComment: (comment: Omit<ReviewComment, 'body' | 'id'>) => void;
+    deleteComment: (commentId: string) => void;
+    focusCommentId: string | null;
+    focusCommentRequest: number;
+    resetCommentFocus: () => void;
+    reviewCommentsRef: RefObject<readonly ReviewComment[]>;
+    updateActiveReviewCommentDraft: (comment: {
+        body: string;
+        id: string;
+    } | null) => void;
+    updateComment: (commentId: string, body: string) => void;
+    askCodex: (commentId: string) => void;
+    hasPendingReviewComments: boolean;
+    pullRequestReviewSubmitting: PullRequestReviewEvent | null;
+    reviewComments: readonly ReviewComment[];
+    setReviewComments: import("react").Dispatch<import("react").SetStateAction<readonly ReviewComment[]>>;
+    submitPullRequestComment: (commentId: string) => void;
+    submitPullRequestReview: (event: PullRequestReviewEvent, body?: string) => Promise<void> | undefined;
+};
+export {};

package/dist/app/hooks/useAppWalkthrough.d.ts

@@ -0,0 +1,96 @@
+import { type RefObject } from 'react';
+import type { SidebarMode } from '../../lib/app-types.ts';
+import { type ReviewCommandTarget } from '../../lib/review-command-target.ts';
+import type { CodiffPreferences, NarrativeWalkthrough, RepositoryState, WalkthroughCommitMessageRequest, WalkthroughCommitRequest, WalkthroughProgressEvent } from '../../types.ts';
+import type { WalkthroughReviewTarget } from '../components/walkthrough/NarrativeWalkthroughView.tsx';
+import type { WalkthroughFileError } from '../components/WalkthroughFileError.tsx';
+type MainMode = 'commit' | 'review';
+type UseAppWalkthroughOptions = {
+    preferencesRef: RefObject<CodiffPreferences>;
+    state: RepositoryState | null;
+    stateGenerationRef: RefObject<number>;
+    stateRef: RefObject<RepositoryState | null>;
+};
+export declare function useAppWalkthrough({ preferencesRef, state, stateGenerationRef, stateRef, }: UseAppWalkthroughOptions): {
+    activeReviewCommandTargetRef: RefObject<ReviewCommandTarget | null>;
+    changeSidebarMode: (mode: SidebarMode) => void;
+    closeCommitView: () => void;
+    commitWalkthrough: (request: WalkthroughCommitRequest) => Promise<import("../../types.ts").WalkthroughCommitResult>;
+    enabledShareWalkthrough: (() => void) | undefined;
+    mainModeRef: RefObject<MainMode>;
+    narrativeNavigation: {
+        commitBody: string;
+        commitSelected: ReadonlySet<string>;
+        commitSubject: string;
+        enterCommit: () => void;
+        goNext: () => void;
+        goPrev: () => void;
+        goStop: (target: number) => void;
+        index: number;
+        mode: import("../components/walkthrough/useNarrativeNavigation.ts").NarrativeViewMode;
+        openSupport: () => void;
+        releaseStopScrollLock: () => void;
+        scrollTarget: {
+            index: number;
+            nonce: number;
+        };
+        setCommitBody: (value: string) => void;
+        setCommitSubject: (value: string) => void;
+        supportScrollRequest: number;
+        supportVisited: boolean;
+        syncIndexFromScroll: (target: number) => void;
+        syncSupportFromScroll: () => void;
+        toggleCommitFile: (path: string) => void;
+        toggleCommitGroup: (paths: ReadonlyArray<string>) => void;
+        visited: ReadonlySet<string>;
+        walkthroughView: import("../../lib/narrative-walkthrough.ts").WalkthroughView | null;
+    };
+    narrativeWalkthrough: NarrativeWalkthrough | null;
+    narrativeWalkthroughRef: RefObject<NarrativeWalkthrough | null>;
+    openCommitView: () => void;
+    plainCommitModel: import("../../lib/narrative-walkthrough.ts").CommitModel;
+    regenerateWalkthrough: () => void;
+    setMainMode: import("react").Dispatch<import("react").SetStateAction<MainMode>>;
+    setNarrativeWalkthrough: import("react").Dispatch<import("react").SetStateAction<NarrativeWalkthrough | null>>;
+    setShareWalkthroughEnabled: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setSidebarMode: import("react").Dispatch<import("react").SetStateAction<SidebarMode>>;
+    setWalkthroughError: import("react").Dispatch<import("react").SetStateAction<{
+        code?: 'CODEX_NOT_FOUND' | 'CLAUDE_NOT_FOUND' | 'OPENCODE_NOT_FOUND' | 'PI_NOT_FOUND';
+        reason: string;
+        status: 'unavailable';
+    } | null>>;
+    setWalkthroughFileError: import("react").Dispatch<import("react").SetStateAction<WalkthroughFileError | null>>;
+    setWalkthroughLoading: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setWalkthroughOutdatedPaths: import("react").Dispatch<import("react").SetStateAction<ReadonlySet<string>>>;
+    setWalkthroughUnread: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    showNarrativeWalkthrough: boolean;
+    showPlainCommitView: boolean;
+    sidebarMode: SidebarMode;
+    sidebarModeRef: RefObject<SidebarMode>;
+    startWalkthroughLoading: () => void;
+    subscribeToCommitOutput: (callback: (chunk: string) => void) => () => void;
+    updateActiveWalkthroughReviewTarget: (target: WalkthroughReviewTarget | null) => void;
+    updateWalkthroughCommitMessage: (request: WalkthroughCommitMessageRequest) => Promise<import("../../types.ts").WalkthroughCommitMessageResult>;
+    walkthroughError: {
+        code?: 'CODEX_NOT_FOUND' | 'CLAUDE_NOT_FOUND' | 'OPENCODE_NOT_FOUND' | 'PI_NOT_FOUND';
+        reason: string;
+        status: 'unavailable';
+    } | null;
+    walkthroughErrorRef: RefObject<{
+        code?: 'CODEX_NOT_FOUND' | 'CLAUDE_NOT_FOUND' | 'OPENCODE_NOT_FOUND' | 'PI_NOT_FOUND';
+        reason: string;
+        status: 'unavailable';
+    } | null>;
+    walkthroughFileError: WalkthroughFileError | null;
+    walkthroughLoading: boolean;
+    walkthroughOutdatedPaths: ReadonlySet<string>;
+    walkthroughOutdatedPathsRef: RefObject<ReadonlySet<string>>;
+    walkthroughProgress: {
+        phase: WalkthroughProgressEvent['phase'] | null;
+        responseLabelIndex: number;
+        stageRevision: number;
+    };
+    walkthroughSharing: boolean;
+    walkthroughUnread: boolean;
+};
+export {};

package/dist/app/hooks/useDiffSearch.d.ts

@@ -0,0 +1,24 @@
+import type { ChangedFile } from '../../types.ts';
+type UseDiffSearchOptions = {
+    files: ReadonlyArray<ChangedFile>;
+    fileSearchQuery: string;
+    showWhitespace: boolean;
+};
+export declare function useDiffSearch({ files, fileSearchQuery, showWhitespace }: UseDiffSearchOptions): {
+    activeMatch: import("../../lib/app-types.ts").DiffSearchMatch;
+    activeMatchIndex: number;
+    closeSearch: () => void;
+    fileFilteredFiles: ChangedFile[];
+    focusRequest: number;
+    hasQuery: boolean;
+    matches: import("../../lib/app-types.ts").DiffSearchMatch[];
+    matchPathSet: Set<string>;
+    moveMatch: (direction: 1 | -1) => void;
+    openSearch: () => void;
+    query: string;
+    resetSearch: () => void;
+    updateQuery: (nextQuery: string) => void;
+    visible: boolean;
+    visibleFiles: ChangedFile[];
+};
+export {};

package/dist/app/hooks/useDocumentAppearance.d.ts

@@ -0,0 +1,10 @@
+import type { CodiffPreferences } from '../../types.ts';
+export declare const CODE_FONT_SIZE_DEFAULT = 13;
+export declare const normalizeCodeFontSizePreference: (size: number) => number;
+export declare const getCodeFontLineHeight: (size: number) => number;
+type UseDocumentAppearanceOptions = Pick<CodiffPreferences, 'codeFontFamily' | 'codeFontSize' | 'theme'> & {
+    cleanupCodeFontProperties?: boolean;
+    clearEmptyCodeFontFamily?: boolean;
+};
+export declare function useDocumentAppearance({ cleanupCodeFontProperties, clearEmptyCodeFontFamily, codeFontFamily, codeFontSize, theme, }: UseDocumentAppearanceOptions): void;
+export {};

package/dist/app/hooks/useResizableSidebar.d.ts

@@ -0,0 +1,12 @@
+import { type PointerEvent as ReactPointerEvent } from 'react';
+type UseResizableSidebarOptions = {
+    collapseThreshold?: number;
+    onCollapse?: () => void;
+    onWidthCommit: (width: number) => void;
+    readWidth: () => number;
+};
+export declare function useResizableSidebar({ collapseThreshold, onCollapse, onWidthCommit, readWidth, }: UseResizableSidebarOptions): {
+    resizeSidebar: (event: ReactPointerEvent<HTMLDivElement>) => void;
+    sidebarWidth: number;
+};
+export {};

package/dist/app/hooks/useReviewCommentDrafts.d.ts

@@ -0,0 +1,23 @@
+import { type Dispatch, type SetStateAction } from 'react';
+import type { ReviewComment } from '../../lib/app-types.ts';
+type ReviewCommentDraft = Pick<ReviewComment, 'body' | 'id'>;
+type UseReviewCommentDraftsOptions = {
+    canCreateComment?: boolean;
+    comments: ReadonlyArray<ReviewComment>;
+    onCommentFileChange: (filePath: string) => void;
+    setComments: Dispatch<SetStateAction<ReadonlyArray<ReviewComment>>>;
+};
+export declare function useReviewCommentDrafts({ canCreateComment, comments, onCommentFileChange, setComments, }: UseReviewCommentDraftsOptions): {
+    activeReviewCommentDraftRef: import("react").RefObject<ReviewCommentDraft | null>;
+    activeReviewCommentDraftState: ReviewCommentDraft | null;
+    clearCommentFocus: (commentId: string) => void;
+    createComment: (comment: Omit<ReviewComment, 'body' | 'id'>) => void;
+    deleteComment: (commentId: string) => void;
+    focusCommentId: string | null;
+    focusCommentRequest: number;
+    resetCommentFocus: () => void;
+    reviewCommentsRef: import("react").RefObject<readonly ReviewComment[]>;
+    updateActiveReviewCommentDraft: (comment: ReviewCommentDraft | null) => void;
+    updateComment: (commentId: string, body: string) => void;
+};
+export {};

package/dist/app/hooks/useReviewState.d.ts

@@ -0,0 +1,22 @@
+import type { ReviewIdentity } from '../../lib/app-types.ts';
+import type { ChangedFile } from '../../types.ts';
+type UseReviewFileStateOptions = {
+    initialSelectedPath?: string | null;
+    onViewedChange?: (viewed: Record<string, string>) => void;
+};
+export declare function useReviewFileState({ initialSelectedPath, onViewedChange, }?: UseReviewFileStateOptions): {
+    bumpItemVersion: (key: string) => void;
+    collapsed: Set<string>;
+    expandedGenerated: Set<string>;
+    itemVersionByKey: Record<string, number>;
+    selectedPath: string | null;
+    setCollapsed: import("react").Dispatch<import("react").SetStateAction<Set<string>>>;
+    setExpandedGenerated: import("react").Dispatch<import("react").SetStateAction<Set<string>>>;
+    setItemVersionByKey: import("react").Dispatch<import("react").SetStateAction<Record<string, number>>>;
+    setSelectedPath: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    setViewed: import("react").Dispatch<import("react").SetStateAction<Record<string, string>>>;
+    toggleCollapsed: (file: ChangedFile, isCollapsed: boolean, reviewKey?: string) => void;
+    toggleViewed: (file: ChangedFile, isViewed: boolean, reviewIdentity?: ReviewIdentity) => void;
+    viewed: Record<string, string>;
+};
+export {};

package/dist/config/defaults.d.ts

@@ -0,0 +1,4 @@
+import type { CodiffConfig, CodiffKeymap, CodiffSettings } from './types.ts';
+export declare const createDefaultConfig: () => CodiffConfig;
+export declare const defaultKeymap: Readonly<CodiffKeymap>;
+export declare const defaultSettings: Readonly<CodiffSettings>;

package/dist/config/keymap.d.ts

@@ -0,0 +1,3 @@
+import type { CodiffKeymap } from './types.ts';
+export declare const matchesShortcut: (event: Pick<KeyboardEvent, 'altKey' | 'ctrlKey' | 'key' | 'metaKey' | 'shiftKey'>, keymap: CodiffKeymap, action: keyof CodiffKeymap) => boolean;
+export declare const getShortcutLabel: (keymap: CodiffKeymap, action: keyof CodiffKeymap) => string;

package/dist/config/types.d.ts

@@ -0,0 +1,44 @@
+export type CodiffDiffStyle = 'split' | 'unified';
+export type CodiffTheme = 'system' | 'light' | 'dark';
+export type CodiffAgentBackend = 'codex' | 'claude' | 'opencode' | 'pi';
+export type CodiffSettings = {
+    agentBackend: CodiffAgentBackend;
+    claudeModel: string;
+    codeFontFamily: string;
+    codeFontSize: number;
+    copyCommentsOnClose: boolean;
+    diffStyle: CodiffDiffStyle;
+    editorCommand: string;
+    lastRepositoryPath: string;
+    openAIModel: string;
+    opencodeModel: string;
+    piModel: string;
+    reviewCommentsPrefix: string;
+    showOutdated: boolean;
+    showWhitespace: boolean;
+    theme: CodiffTheme;
+    walkthroughPrompt: string;
+    wordWrap: boolean;
+};
+export type KeyCombo = string;
+export type KeyComboBinding = KeyCombo | ReadonlyArray<KeyCombo>;
+export type CodiffKeymap = {
+    closeSearch: KeyCombo;
+    commandBar: KeyCombo;
+    diffSearch: KeyCombo;
+    discardComment: KeyCombo;
+    fileFilter: KeyCombo;
+    nextHunk: KeyComboBinding;
+    nextSearchMatch: KeyCombo;
+    openFile: KeyCombo;
+    prevHunk: KeyComboBinding;
+    prevSearchMatch: KeyCombo;
+    shortcutsHelp: KeyCombo;
+    submitComment: KeyCombo;
+    toggleSidebar: KeyCombo;
+    toggleWordWrap: KeyCombo;
+};
+export type CodiffConfig = {
+    keymap: CodiffKeymap;
+    settings: CodiffSettings;
+};

package/dist/defaults.d.ts

@@ -0,0 +1,2 @@
+import type { ReviewPreferences } from './types.ts';
+export declare const defaultReviewPreferences: Readonly<ReviewPreferences>;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { defaultReviewPreferences } from './defaults.ts';
+export { parsePlanShareManifest, parsePlanShareUpload, type PlanShareManifestV1, type ShareUploader, } from './share.ts';
+export type { ChangedFile, CodiffFeatureFlags, CodiffPreferences, DiffSection, GitIdentity, NarrativeWalkthrough, PlanCommentThread, PullRequestCodeQualityFinding, PullRequestGeneralComment, PullRequestGeneralCommentThread, PullRequestExistingReviewComment, PullRequestMergeOptions, PullRequestMergeState, PullRequestReviewComment, PullRequestReviewEvent, PullRequestReviewStatus, PullRequestReviewer, ReviewPreferences, RepositoryState, ReviewSource, SharePlanResult, ShareWalkthroughResult, SharedPlanSnapshot, SharedWalkthroughSnapshot, WalkthroughShareManifestV1, WalkthroughHunk, } from './types.ts';

package/dist/index.mjs

@@ -0,0 +1,12 @@
+import { parsePlanShareManifest, parsePlanShareUpload } from "./share.mjs";
+//#region defaults.ts
+const defaultReviewPreferences = Object.freeze({
+	codeFontFamily: "Fira Code",
+	codeFontSize: 13,
+	diffStyle: "split",
+	showWhitespace: false,
+	theme: "system",
+	wordWrap: false
+});
+//#endregion
+export { defaultReviewPreferences, parsePlanShareManifest, parsePlanShareUpload };

package/dist/lib/app-constants.d.ts

@@ -0,0 +1,7 @@
+import type { CodiffAgentBackend } from '../config/types.ts';
+import type { AgentSkillStatus, CodiffLaunchOptions, TerminalHelperStatus } from '../types.ts';
+export declare const HISTORY_PAGE_SIZE = 30;
+export declare const defaultLaunchOptions: CodiffLaunchOptions;
+export declare const defaultAgentSkillStatus: AgentSkillStatus;
+export declare const getAgentLabel: (backend: CodiffAgentBackend) => string;
+export declare const defaultTerminalHelperStatus: TerminalHelperStatus;

package/dist/lib/app-types.d.ts

@@ -0,0 +1,137 @@
+import type { CodeViewHandle } from '@pierre/diffs/react';
+import type { ReactNode } from 'react';
+import type { ChangedFile, DiffSection, NarrativeWalkthrough, NarrativeWalkthroughResult, PullRequestCodeQualityFinding, PullRequestExistingReviewComment, ReviewSource } from '../types.ts';
+export type WalkthroughError = Extract<NarrativeWalkthroughResult, {
+    status: 'unavailable';
+}>;
+export type ReviewCommentAnnotationMetadata = {
+    commentIds: ReadonlyArray<string>;
+    type: 'review-comment';
+};
+export type CodeQualityAnnotationMetadata = {
+    finding: PullRequestCodeQualityFinding;
+    type: 'code-quality';
+};
+type MarkdownPreviewAnnotationMetadata = {
+    addedLines: ReadonlySet<number>;
+    contents: string;
+    editable: boolean;
+    layoutKey: string;
+    path: string;
+    sectionId: string;
+    type: 'markdown-preview';
+};
+type ImagePreviewAnnotationMetadata = {
+    path: string;
+    sectionId: string;
+    type: 'image-preview';
+};
+type WalkthroughHeaderAnnotationMetadata = {
+    header: ReactNode;
+    type: 'walkthrough-header';
+};
+export type ReviewAnnotationMetadata = CodeQualityAnnotationMetadata | ImagePreviewAnnotationMetadata | MarkdownPreviewAnnotationMetadata | ReviewCommentAnnotationMetadata | WalkthroughHeaderAnnotationMetadata;
+export type CodeViewInstance = NonNullable<ReturnType<CodeViewHandle<ReviewAnnotationMetadata>['getInstance']>>;
+export type DiffSearchMatch = {
+    filePath: string;
+    itemId: string;
+    lineNumber?: number;
+    side?: 'additions' | 'deletions';
+};
+export type DiffSearchResult = {
+    file: ChangedFile;
+    matchCount: number;
+    matches: ReadonlyArray<DiffSearchMatch>;
+};
+export type ReviewScrollBehavior = 'instant' | 'smooth';
+export type ReviewScrollTarget = {
+    behavior?: ReviewScrollBehavior;
+    blockId?: string;
+    path?: string;
+    request: number;
+};
+export type ReviewIdentity = {
+    fingerprint: string;
+    key: string;
+};
+export type DiffLineCount = {
+    additions: number;
+    countable: boolean;
+    deletions: number;
+};
+export type ReviewComment = {
+    anchor?: 'file' | 'line';
+    author?: PullRequestExistingReviewComment['author'];
+    body: string;
+    canDelete?: boolean;
+    canEdit?: boolean;
+    canReplyThread?: boolean;
+    canResolveThread?: boolean;
+    codexReply?: {
+        body?: string;
+        error?: string;
+        status: 'error' | 'loading' | 'ready';
+    };
+    filePath: string;
+    id: string;
+    isOutdated?: boolean;
+    isReadOnly?: boolean;
+    isThreadResolved?: boolean;
+    lineNumber?: number;
+    remoteSubmit?: {
+        error?: string;
+        status: 'error' | 'submitting';
+    };
+    sectionId: string;
+    side?: 'additions' | 'deletions';
+    startLineNumber?: number;
+    startSide?: 'additions' | 'deletions';
+    submittedAt?: string;
+    threadId?: string;
+    url?: string;
+};
+export type SidebarMode = 'tree' | 'walkthrough' | 'history';
+export type PullRequestSource = Extract<ReviewSource, {
+    type: 'pull-request';
+}>;
+export type WalkthroughNote = {
+    action: 'review' | 'scan' | 'skim';
+    context: string;
+    groupReason: string;
+    groupTitle: string;
+    impact: 'wide' | 'contained' | 'mechanical';
+    order: number;
+    reason: string;
+};
+export type SourceSession = {
+    collapsed: Set<string>;
+    expandedGenerated: Set<string>;
+    /** Populated by a generated or pre-authored narrative walkthrough document. */
+    narrativeWalkthrough?: NarrativeWalkthrough | null;
+    reviewComments: ReadonlyArray<ReviewComment>;
+    selectedPath: string | null;
+    viewed: Record<string, string>;
+    walkthroughError: WalkthroughError | null;
+    walkthroughOutdatedPaths: ReadonlySet<string>;
+};
+export type RepositoryLoadError = {
+    kind: 'generic' | 'not-a-repository';
+    message: string;
+};
+export type CodeViewItemMetadata = {
+    blockId: string;
+    canEditMarkdown: boolean;
+    canRenderMarkdown: boolean;
+    comments: ReadonlyArray<ReviewComment>;
+    file: ChangedFile;
+    isCollapsed: boolean;
+    isMarkdownPreview: boolean;
+    isSelected: boolean;
+    isViewed: boolean;
+    lineCount: DiffLineCount;
+    reviewIdentity: ReviewIdentity;
+    section: DiffSection;
+    sectionCount: number;
+    walkthroughNote?: WalkthroughNote;
+};
+export {};

package/dist/lib/code-view-options.d.ts

@@ -0,0 +1,26 @@
+import type { DiffSection, GitFileStatus } from '../types.ts';
+export declare const statusLabel: Record<GitFileStatus, string>;
+export declare const sectionLabel: Record<DiffSection['kind'], string>;
+export declare const DEFAULT_PADDING = 11;
+export declare const codeViewLayout: {
+    gap: number;
+    paddingBottom: number;
+    paddingTop: number;
+};
+export declare const codeViewItemMetrics: {
+    diffHeaderHeight: number;
+};
+export declare const DIFF_LINE_HEIGHT = 20;
+export declare const diffContextExpansionLineCount = 100;
+export declare const diffCollapsedContextThreshold = 12;
+export declare const workerHighlighterOptions: {
+    maxLineDiffLength: number;
+    theme: {
+        dark: string;
+        light: string;
+    };
+    tokenizeMaxLineLength: number;
+    useTokenTransformer: boolean;
+};
+export declare const maxWorkerThreads = 3;
+export declare const codeViewUnsafeCSS = "\n  :host {\n    border-radius: var(--codiff-diff-radius, 28px);\n    corner-shape: squircle;\n    --diffs-font-family: var(--font-diff-mono, var(--font-mono));\n    --diffs-header-font-family: var(--font-sans);\n    --diffs-font-size: var(--font-diff-size, 13px);\n    --diffs-line-height: var(--font-diff-line-height, 20px);\n    --diffs-light-bg: var(--code-bg);\n    --diffs-dark-bg: var(--code-bg);\n    --diffs-bg-selection-override: rgb(61 135 245 / 0.34);\n    --diffs-bg-selection-number-override: rgb(61 135 245 / 0.46);\n  }\n\n  [data-diff-type=\"split\"][data-overflow=\"scroll\"] {\n    grid-template-columns: minmax(0, 42fr) minmax(0, 58fr);\n  }\n\n  [data-diffs-header=\"custom\"][data-sticky] {\n    background-color: transparent;\n    border-radius: 0;\n  }\n\n  :host(.codiff-walkthrough-header-item) {\n    background: var(--app-bg);\n    border-radius: 0;\n    box-shadow: none;\n    corner-shape: initial;\n    overflow: visible;\n  }\n\n  :host(.codiff-walkthrough-header-item) [data-file],\n  :host(.codiff-walkthrough-header-item) pre,\n  :host(.codiff-walkthrough-header-item) code,\n  :host(.codiff-walkthrough-header-item) [data-code],\n  :host(.codiff-walkthrough-header-item) [data-line-annotation] {\n    background: var(--app-bg);\n    border-radius: 0;\n    box-shadow: none;\n    overflow: visible;\n  }\n\n  :host(.codiff-walkthrough-header-item) [data-column-number],\n  :host(.codiff-walkthrough-header-item) [data-line-number],\n  :host(.codiff-walkthrough-header-item) [data-gutter],\n  :host(.codiff-walkthrough-header-item) [data-gutter-buffer],\n  :host(.codiff-walkthrough-header-item) [data-content] > [data-line] {\n    display: none;\n  }\n\n  .review-comment-thread {\n    padding: 8px 0 8px 16px;\n  }\n\n  /* Align scrollbar with number column */\n  [data-code]::-webkit-scrollbar-track {\n    margin-left: var(--diffs-column-number-width);\n  }\n\n  /* Ensure right edge of scrollbar never gets cropped by rounded corners */\n  [data-file] [data-code]::-webkit-scrollbar-track,\n  [data-diff-type=\"single\"] [data-code]::-webkit-scrollbar-track,\n  [data-diff-type=\"split\"] [data-code][data-additions]::-webkit-scrollbar-track {\n    margin-right: 14px;\n  }\n\n  :host(.codiff-markdown-preview-item) [data-file] [data-code] {\n    grid-column: 1 / -1;\n  }\n\n  :host(.codiff-markdown-preview-item) [data-file] [data-line=\"1\"][data-line-index=\"0\"][data-line-type=\"context\"],\n  :host(.codiff-markdown-preview-item) [data-file] [data-column-number=\"1\"][data-line-index=\"0\"][data-line-type=\"context\"],\n  :host(.codiff-markdown-preview-item) [data-gutter] > [data-gutter-utility-slot] {\n    display: none;\n    pointer-events: none;\n  }\n\n  :host(.codiff-image-preview-item) [data-file] {\n    --diffs-code-grid: 1fr;\n  }\n\n  :host(.codiff-image-preview-item) [data-file] [data-code] {\n    grid-column: 1 / -1;\n    padding-block: 0;\n  }\n\n  :host(.codiff-image-preview-item) [data-file] [data-content] {\n    grid-column: 1;\n  }\n\n  :host(.codiff-image-preview-item) [data-file] [data-gutter],\n  :host(.codiff-image-preview-item) [data-file] [data-line=\"1\"][data-line-index=\"0\"][data-line-type=\"context\"] {\n    display: none;\n    pointer-events: none;\n  }\n\n  :host(.codiff-loadable-summary-item) [data-file] [data-line],\n  :host(.codiff-loadable-summary-item) [data-file] [data-column-number] {\n    cursor: pointer;\n  }\n\n  :host(.codiff-loading-summary-item) [data-file] [data-line],\n  :host(.codiff-loading-summary-item) [data-file] [data-column-number] {\n    cursor: progress;\n  }\n\n  .codiff-search-mark {\n    background: var(--diffs-find-highlight-bg, rgb(255 216 92 / 0.65));\n    border-radius: 3px;\n    color: inherit;\n    padding: 0 1px;\n  }\n\n  .codiff-search-mark.active {\n    background: var(--diffs-find-active-bg, rgb(255 176 46 / 0.96));\n    box-shadow: 0 0 0 1px rgb(255 142 36 / 0.4);\n  }\n\n  [data-utility-button] {\n    background: color-mix(in srgb, var(--diffs-bg) 88%, var(--diffs-modified-base));\n    border: 1px solid color-mix(in srgb, var(--diffs-modified-base) 34%, transparent);\n    border-radius: 3px;\n    box-shadow: 0 7px 18px -14px rgb(0 0 0 / 0.72);\n    color: var(--diffs-modified-base);\n    height: calc(1lh - 4px);\n    transform: translate(-4px, 2px);\n    width: calc(1lh - 4px);\n  }\n\n  [data-selected-line] [data-gutter-utility-slot] {\n    display: none;\n  }\n";

package/dist/lib/command-registry.d.ts

@@ -0,0 +1,14 @@
+import type { CodiffKeymap } from '../config/types.ts';
+export type Command = {
+    description?: () => string | null;
+    execute: () => void;
+    id: string;
+    keymapAction?: keyof CodiffKeymap;
+    title: string;
+};
+export type CommandRegistry = {
+    commands: ReadonlyArray<Command>;
+    register: (command: Command) => () => void;
+};
+export declare const createCommandRegistry: () => CommandRegistry;
+export declare const filterCommands: (commands: ReadonlyArray<Command>, query: string) => ReadonlyArray<Command>;

package/dist/lib/diff-search.d.ts

@@ -0,0 +1,3 @@
+import type { ChangedFile } from '../types.ts';
+import type { DiffSearchResult } from './app-types.ts';
+export declare const getDiffSearchResult: (file: ChangedFile, showWhitespace: boolean, query: string) => DiffSearchResult | null;

package/dist/lib/diff.d.ts

@@ -0,0 +1,35 @@
+import { type FileDiffLoadedFiles, type FileDiffMetadata } from '@pierre/diffs';
+import type { ChangedFile, DiffSection } from '../types.ts';
+import type { DiffLineCount } from './app-types.ts';
+export declare const getItemId: (section: DiffSection) => string;
+export declare const isMarkdownFilePath: (path: string) => boolean;
+export declare const canRenderImagePreview: (path: string, section: DiffSection) => boolean;
+export declare const isPatchOnlyDiffSection: (section: DiffSection) => boolean;
+export declare const shouldLoadDiffSectionContents: (section: DiffSection) => boolean;
+export declare const shouldPreloadSectionContentsForSearch: (section: DiffSection) => boolean;
+export declare const getSectionForFileDiff: (fileDiff: FileDiffMetadata) => {
+    file: ChangedFile;
+    section: DiffSection;
+} | undefined;
+export declare const loadSectionContents: (file: ChangedFile, section: DiffSection, load: (file: ChangedFile, section: DiffSection) => Promise<FileDiffLoadedFiles>) => Promise<FileDiffLoadedFiles>;
+export type MarkdownPreviewContents = {
+    addedLines: ReadonlySet<number>;
+    contents: string;
+};
+export declare const getMarkdownPreviewContents: (file: ChangedFile, section: DiffSection, fileDiff: FileDiffMetadata) => MarkdownPreviewContents | null;
+export declare const getDiffLineCountFromVisibleSections: (sections: ReadonlyArray<{
+    fileDiff: FileDiffMetadata;
+    section: DiffSection;
+}>) => DiffLineCount;
+export declare const getDiffLineCount: (file: ChangedFile, showWhitespace: boolean) => DiffLineCount;
+export declare const getTotalDiffLineCount: (lineCounts: Iterable<DiffLineCount>) => DiffLineCount;
+export declare const formatLineCountNumber: (value: number) => string;
+export declare const formatTreeLineCount: ({ additions, deletions }: DiffLineCount) => string;
+export declare const getDiffLineCountTitle: ({ additions, deletions }: DiffLineCount) => string;
+export declare const parseSectionDiffWithOptions: (file: ChangedFile, section: DiffSection, showWhitespace: boolean) => FileDiffMetadata;
+export declare const getVisibleDiffSections: (file: ChangedFile, showWhitespace: boolean) => {
+    fileDiff: FileDiffMetadata;
+    section: DiffSection;
+}[];
+export declare const fileHasVisibleDiff: (file: ChangedFile, showWhitespace: boolean) => boolean;
+export declare const getFirstVisibleSection: (file: ChangedFile, showWhitespace: boolean) => DiffSection;

package/dist/lib/files.d.ts

@@ -0,0 +1,14 @@
+import type { ChangedFile, GitFileStatus } from '../types.ts';
+export declare const statusForTree: Record<GitFileStatus, 'added' | 'deleted' | 'modified' | 'renamed' | 'untracked'>;
+export declare const fileTreeSort: (left: {
+    isDirectory: boolean;
+    path: string;
+    segments?: ReadonlyArray<string>;
+}, right: {
+    isDirectory: boolean;
+    path: string;
+    segments?: ReadonlyArray<string>;
+}) => number;
+export declare const compactPath: (path: string) => string;
+export declare const sortFiles: (files: ReadonlyArray<ChangedFile>) => ChangedFile[];
+export declare const fuzzyMatches: (path: string, query: string) => boolean;