@cerbur/clutch-dsh-worktree 0.1.10 → 0.1.13

package/lib/client/dashboard/git/git-state-cache.js

@@ -0,0 +1,80 @@
+import { WORKTREE_GIT_WORKING_TREE, isWorktreeGitCommit, } from '../../../contract/index.js';
+export const MAX_FILE_CACHE = 8;
+export const MAX_DIFF_CACHE = 24;
+/** The summary selection for one working-tree inclusion mode. */
+export function summarySelection(includeWorkingTree) {
+    return includeWorkingTree ? { kind: 'summary', includeWorkingTree: true } : { kind: 'summary' };
+}
+function targetKey(target) {
+    if (target.kind === 'commit')
+        return 'commit\u0000' + target.commit;
+    if (target.selection.kind === 'summary') {
+        return target.selection.includeWorkingTree === true ? 'summary\u0000working-tree' : 'summary';
+    }
+    return 'commits\u0000' + target.selection.commits.join('\u0000');
+}
+function historyProjectionKey(history) {
+    if (history.status !== 'ready')
+        return 'unknown';
+    return (history.value.baseline?.commit ?? 'unknown') + '\u0000' + (history.value.headCommit ?? 'unknown');
+}
+/** True when the target reads the live working tree and must not be cached. */
+export function isLiveTarget(target) {
+    return target.kind === 'commit'
+        ? target.commit === WORKTREE_GIT_WORKING_TREE
+        : target.selection.kind === 'summary' && target.selection.includeWorkingTree === true;
+}
+/**
+ * Live-result markers complete a cache key. Matching on the marker rather than
+ * on a hand-written substring keeps key construction and invalidation aligned.
+ */
+const LIVE_KEY_MARKERS = [
+    '\u0000' + targetKey({ kind: 'commit', commit: WORKTREE_GIT_WORKING_TREE }),
+    '\u0000' + targetKey({ kind: 'selection', selection: summarySelection(true) }),
+];
+/** True when a file or diff cache key belongs to a live working-tree read. */
+export function isLiveCacheKey(key) {
+    return LIVE_KEY_MARKERS.some((marker) => key.includes(marker));
+}
+/**
+ * Key token for a read that names no baseline branch and therefore asks the
+ * Manager to resolve the Worktree's captured acquisition commit. The leading NUL
+ * cannot appear in a local branch name, so the token can never collide with one.
+ */
+const CAPTURED_BASELINE_KEY = '\u0000captured';
+function baselineKey(baseBranch) {
+    return baseBranch ?? CAPTURED_BASELINE_KEY;
+}
+export function gitCacheKey(baseBranch, history, target) {
+    return baselineKey(baseBranch) + '\u0000' + historyProjectionKey(history) + '\u0000' + targetKey(target);
+}
+export function diffCacheKey(baseBranch, history, target, filePath) {
+    return gitCacheKey(baseBranch, history, target) + '\u0000' + filePath;
+}
+/** Compare two targets by projection identity rather than object identity. */
+export function sameTarget(left, right) {
+    return targetKey(left) === targetKey(right);
+}
+/** Drop the oldest entries until the cache respects its bound. */
+export function trimCache(cache, maxSize) {
+    while (cache.size > maxSize) {
+        const oldest = cache.keys().next().value;
+        if (oldest === undefined)
+            return;
+        cache.delete(oldest);
+    }
+}
+/** Find the changed-file row for a new or previous path. */
+export function fileForPath(files, selectedPath) {
+    return files.files.find((file) => file.path === selectedPath || file.oldPath === selectedPath);
+}
+/** Keep only SHAs that are still part of the current history projection. */
+export function canonicalizeCommits(history, commits) {
+    if (history === undefined)
+        return [];
+    const requested = new Set(commits.filter((commit) => isWorktreeGitCommit(commit)));
+    return history.commits
+        .filter((commit) => commit.sha !== WORKTREE_GIT_WORKING_TREE && requested.has(commit.sha))
+        .map((commit) => commit.sha);
+}
+//# sourceMappingURL=git-state-cache.js.map

package/lib/client/dashboard/git/git-state-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-state-cache.js","sourceRoot":"","sources":["../../../../src/client/dashboard/git/git-state-cache.ts"],"names":[],"mappings":"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"}

package/lib/client/dashboard/git/useGitPaneSplit.d.ts

@@ -0,0 +1,33 @@
+import type { KeyboardEvent as ReactKeyboardEvent, MutableRefObject, PointerEvent as ReactPointerEvent } from 'react';
+export type GitSplitOrientation = 'horizontal' | 'vertical';
+export interface GitPaneSplitOptions {
+    /** The grid that holds both panes and the divider. */
+    readonly containerRef: MutableRefObject<HTMLDivElement | null>;
+    /** `horizontal` splits rows by height, `vertical` splits columns by width. */
+    readonly orientation: GitSplitOrientation;
+    /** CSS custom property on the container that carries the leading-pane share. */
+    readonly property: string;
+    /** Smallest pane size along the axis, in CSS pixels. */
+    readonly minimum: number;
+    /** Default share used before the first drag. */
+    readonly fallback: number;
+}
+export interface GitPaneSplit {
+    /** Attach to the draggable divider between both panes. */
+    readonly splitterRef: MutableRefObject<HTMLDivElement | null>;
+    /** Leading-pane share along this axis, in percent. */
+    readonly percent: number;
+    readonly dragging: boolean;
+    readonly startDrag: (event: ReactPointerEvent<HTMLDivElement>) => void;
+    readonly drag: (event: ReactPointerEvent<HTMLDivElement>) => void;
+    readonly endDrag: (event: ReactPointerEvent<HTMLDivElement>) => void;
+    readonly onKeyDown: (event: ReactKeyboardEvent<HTMLDivElement>) => void;
+    readonly reset: () => void;
+}
+/**
+ * Resize one grid axis with a pointer or the keyboard. The dragging frame writes
+ * straight to the DOM custom property, so heavy commit and file lists never
+ * re-render per pointer move; React state commits once per gesture.
+ */
+export declare function useGitPaneSplit(options: GitPaneSplitOptions): GitPaneSplit;
+//# sourceMappingURL=useGitPaneSplit.d.ts.map

package/lib/client/dashboard/git/useGitPaneSplit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGitPaneSplit.d.ts","sourceRoot":"","sources":["../../../../src/client/dashboard/git/useGitPaneSplit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,IAAI,kBAAkB,EACnC,gBAAgB,EAChB,YAAY,IAAI,iBAAiB,EAClC,MAAM,OAAO,CAAC;AAUf,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,UAAU,CAAC;AAQ5D,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC/D,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC9D,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IACvE,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IAClE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAyH1E"}

package/lib/client/dashboard/git/useGitPaneSplit.js

@@ -0,0 +1,119 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { GIT_SPLIT_KEY_STEP, clampGitSplitPercent, gitSplitPercentFromPointer } from './git-column-split.js';
+/**
+ * Remembers every divider position for the rest of the browser session, so
+ * closing and reopening the Git tab keeps the split the user dragged to.
+ */
+const rememberedPercents = new Map();
+/** Arrow keys that move a leading pane forward or backward along one axis. */
+const KEY_DIRECTIONS = {
+    horizontal: { ArrowUp: -1, ArrowDown: 1 },
+    vertical: { ArrowLeft: -1, ArrowRight: 1 },
+};
+/**
+ * Resize one grid axis with a pointer or the keyboard. The dragging frame writes
+ * straight to the DOM custom property, so heavy commit and file lists never
+ * re-render per pointer move; React state commits once per gesture.
+ */
+export function useGitPaneSplit(options) {
+    const { containerRef, orientation, property, minimum, fallback } = options;
+    const splitterRef = useRef(null);
+    const [percent, setPercent] = useState(() => rememberedPercents.get(property) ?? fallback);
+    const [dragging, setDragging] = useState(false);
+    const percentRef = useRef(percent);
+    const geometryRef = useRef(undefined);
+    const draggingRef = useRef(false);
+    const applyPercent = useCallback((next) => {
+        percentRef.current = next;
+        containerRef.current?.style.setProperty(property, next + '%');
+        splitterRef.current?.setAttribute('aria-valuenow', String(Math.round(next)));
+    }, [containerRef, property]);
+    const commitPercent = useCallback((next) => {
+        applyPercent(next);
+        rememberedPercents.set(property, next);
+        setPercent(next);
+    }, [applyPercent, property]);
+    useEffect(() => {
+        applyPercent(percent);
+        rememberedPercents.set(property, percent);
+    }, [applyPercent, percent, property]);
+    useEffect(() => {
+        if (!dragging)
+            return undefined;
+        // Keep the resize cursor and suppress selection while the pointer is captured.
+        const previousCursor = document.body.style.cursor;
+        const previousUserSelect = document.body.style.userSelect;
+        document.body.style.cursor = orientation === 'horizontal' ? 'row-resize' : 'col-resize';
+        document.body.style.userSelect = 'none';
+        return () => {
+            document.body.style.cursor = previousCursor;
+            document.body.style.userSelect = previousUserSelect;
+        };
+    }, [dragging, orientation]);
+    const measure = useCallback(() => {
+        const container = containerRef.current;
+        const splitter = splitterRef.current;
+        if (container === null || splitter === null)
+            return undefined;
+        const containerRect = container.getBoundingClientRect();
+        const splitterRect = splitter.getBoundingClientRect();
+        return orientation === 'horizontal'
+            ? { start: containerRect.top, size: containerRect.height, divider: splitterRect.height, minimum }
+            : { start: containerRect.left, size: containerRect.width, divider: splitterRect.width, minimum };
+    }, [containerRef, minimum, orientation]);
+    const startDrag = useCallback((event) => {
+        if (event.button !== 0)
+            return;
+        const geometry = measure();
+        if (geometry === undefined)
+            return;
+        geometryRef.current = geometry;
+        draggingRef.current = true;
+        setDragging(true);
+        event.currentTarget.setPointerCapture(event.pointerId);
+        event.preventDefault();
+        // preventDefault suppresses the default focus; keep the divider keyboard-reachable.
+        event.currentTarget.focus({ preventScroll: true });
+    }, [measure]);
+    const drag = useCallback((event) => {
+        const geometry = geometryRef.current;
+        if (!draggingRef.current || geometry === undefined)
+            return;
+        const pointer = orientation === 'horizontal' ? event.clientY : event.clientX;
+        const next = gitSplitPercentFromPointer(pointer, geometry);
+        if (next !== undefined)
+            applyPercent(next);
+    }, [applyPercent, orientation]);
+    const endDrag = useCallback((event) => {
+        if (!draggingRef.current)
+            return;
+        draggingRef.current = false;
+        geometryRef.current = undefined;
+        setDragging(false);
+        if (event.currentTarget.hasPointerCapture(event.pointerId)) {
+            event.currentTarget.releasePointerCapture(event.pointerId);
+        }
+        const geometry = measure();
+        commitPercent(geometry === undefined
+            ? percentRef.current
+            : clampGitSplitPercent(percentRef.current, geometry) ?? percentRef.current);
+    }, [commitPercent, measure]);
+    const onKeyDown = useCallback((event) => {
+        const direction = KEY_DIRECTIONS[orientation][event.key];
+        if (direction === undefined)
+            return;
+        const geometry = measure();
+        if (geometry === undefined)
+            return;
+        event.preventDefault();
+        const step = GIT_SPLIT_KEY_STEP * (event.shiftKey ? 4 : 1);
+        const next = clampGitSplitPercent(percentRef.current + direction * step, geometry);
+        if (next !== undefined)
+            commitPercent(next);
+    }, [commitPercent, measure, orientation]);
+    const reset = useCallback(() => {
+        commitPercent(fallback);
+    }, [commitPercent, fallback]);
+    return { splitterRef, percent, dragging, startDrag, drag, endDrag, onKeyDown, reset };
+}
+//# sourceMappingURL=useGitPaneSplit.js.map

package/lib/client/dashboard/git/useGitPaneSplit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGitPaneSplit.js","sourceRoot":"","sources":["../../../../src/client/dashboard/git/useGitPaneSplit.ts"],"names":[],"mappings":"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"}

package/lib/client/dashboard/git/useWorktreeGitState.d.ts

@@ -0,0 +1,60 @@
+import type { BranchRecord, WorktreeGitCommitFiles, WorktreeGitFileDiff, WorktreeGitHistory, WorktreeManager } from '../../../contract/index.js';
+import type { GitLoadable } from './git-state-cache.js';
+export type { GitLoadable } from './git-state-cache.js';
+export type WorktreeGitView = 'commits' | 'summary';
+export interface WorktreeGitState {
+    readonly branches: GitLoadable<readonly BranchRecord[]>;
+    /** The currently selected local branch; undefined keeps the Git tab unselected. */
+    readonly baselineBranch?: string;
+    readonly history: GitLoadable<WorktreeGitHistory>;
+    readonly view: WorktreeGitView;
+    /** Whether the summary target includes the live working tree. */
+    readonly includeWorkingTree: boolean;
+    /** The focused/primary commit; aggregate selections are in selectedCommits. */
+    readonly selectedCommit?: string;
+    /** Selected committed SHAs; the live working tree is intentionally excluded. */
+    readonly selectedCommits: readonly string[];
+    /** Whether picking a commit adds to the selection instead of replacing it. */
+    readonly commitMultiSelect: boolean;
+    readonly files: GitLoadable<WorktreeGitCommitFiles>;
+    readonly selectedPath?: string;
+    readonly diff: GitLoadable<WorktreeGitFileDiff>;
+}
+export interface WorktreeGitStateController {
+    readonly getSnapshot: () => WorktreeGitState;
+    readonly subscribe: (listener: () => void) => () => void;
+    readonly loadBranches: () => Promise<void>;
+    readonly loadHistory: () => Promise<void>;
+    readonly refresh: () => Promise<void>;
+    readonly selectBaselineBranch: (branch: string | undefined) => void;
+    readonly selectView: (view: WorktreeGitView) => void;
+    readonly selectSummary: () => void;
+    readonly setIncludeWorkingTree: (include: boolean) => void;
+    readonly selectCommit: (commit: string) => void;
+    readonly toggleCommit: (commit: string) => void;
+    readonly setCommitMultiSelect: (enabled: boolean) => void;
+    readonly clearCommitSelection: () => void;
+    readonly selectPath: (path: string) => void;
+    readonly dispose: () => void;
+}
+interface ControllerInput {
+    readonly manager?: Pick<WorktreeManager, 'listBranches' | 'listWorktreeCommits' | 'listWorktreeCommitFiles' | 'getWorktreeCommitFileDiff'>;
+    readonly workspaceId: string;
+    readonly worktreeId: string;
+    readonly defaultBaselineBranch?: string;
+    /**
+     * True when the Worktree record carries a captured acquisition commit the
+     * Manager resolves as the implicit baseline. It lets the Git tab read the
+     * captured baseline instead of staying blank until a branch is picked.
+     */
+    readonly capturedBaseline?: boolean;
+}
+/**
+ * Create the browser-safe Git Dashboard state machine. Construction is inert;
+ * the caller explicitly starts history loading on first Git-tab activation.
+ */
+export declare function createWorktreeGitStateController(input: ControllerInput): WorktreeGitStateController;
+export type UseWorktreeGitStateInput = ControllerInput;
+/** React adapter; the first Git history request starts in the mount effect. */
+export declare function useWorktreeGitState(input: UseWorktreeGitStateInput): WorktreeGitState & Omit<WorktreeGitStateController, 'getSnapshot' | 'subscribe'>;
+//# sourceMappingURL=useWorktreeGitState.d.ts.map

package/lib/client/dashboard/git/useWorktreeGitState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorktreeGitState.d.ts","sourceRoot":"","sources":["../../../../src/client/dashboard/git/useWorktreeGitState.ts"],"names":[],"mappings":"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"}