@dsh-cove/dsh-web-all 0.0.0-stage → 0.4.3

package/lib/types/client/sidebar/git-workbench.js

@@ -0,0 +1,480 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/** The source-control panel: staged vs unstaged sections with per-file
+ *  stage/unstage and discard actions, a branch switcher with create-branch,
+ *  a commit box (Ctrl/Cmd+Enter, gated on staged changes), and a
+ *  VSCode-like history — rows carry ref badges, author and relative time.
+ *  Right-click a file or history row for the advanced operations menu
+ *  (open in editor, discard, revert, cherry-pick, copy paths/hashes);
+ *  destructive actions land in a confirm modal first. Refresh is manual +
+ *  on mount + SSE/poll (KISS, no file watcher). */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { IconBranchOutline16, IconCloseOutline16, IconCodeOutline16, IconCopyOutline16, IconPlusOutline16, IconRefreshOutline16, IconTrashOutline16 } from "../ui-icons.js";
+import { Button, Input, Menu, Modal, writeClipboard } from '@deepseek-ai/dsh-client-ui-primitives';
+import { DiffView } from "./diff-view.js";
+import { rightPaneEn } from "./right-pane-i18n.js";
+import css from './sidebar.module.css';
+/** Resolve one copy key with interpolation, falling back to the en dictionary. */
+function dict(t, key, params) {
+    const text = t?.(key, params) ?? rightPaneEn[key] ?? key;
+    if (params === undefined)
+        return text;
+    return text.replace(/\{([a-zA-Z0-9_]+)\}/gu, (_match, name) => String(params[name] ?? ''));
+}
+/** One /git/* call. A denied request (403 from the host access fence) or any
+ *  pre-flight failure answers without the envelope, so the HTTP status becomes
+ *  the message instead of an empty string. */
+async function git(route, body) {
+    const response = await fetch(`/git/${route}`, {
+        method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body),
+    });
+    const envelope = await response.json().catch(() => null);
+    const ok = envelope?.ok;
+    if (envelope === null || typeof envelope !== 'object' || Array.isArray(envelope) || typeof ok !== 'boolean') {
+        const message = `${response.status} ${response.statusText}`.trim();
+        throw Object.assign(new Error(message), { gitError: { code: 'internal', message } });
+    }
+    if (!envelope.ok)
+        throw Object.assign(new Error(gitErrorMessage(envelope.error)), { gitError: envelope.error });
+    return envelope.value;
+}
+/** Localized operation-failure copy, one label per GitError code. Accepts any
+ *  shape because a proxy or a non-envelope answer can produce one, and never
+ *  yields an empty message. */
+export function gitErrorMessage(error, t) {
+    const s = (key, params) => dict(t, key, params);
+    const record = (typeof error === 'object' && error !== null ? error : {});
+    const code = typeof record.code === 'string' ? record.code : undefined;
+    const message = typeof record.message === 'string' && record.message.trim() !== '' ? record.message.trim() : undefined;
+    const labels = {
+        'conflicts-present': s('git.error.conflictsPresent'),
+        'operation-in-progress': s('git.error.operationInProgress'),
+        'dirty-worktree': s('git.error.dirtyWorktree'),
+        'apply-conflict': s('git.error.applyConflict'),
+        'nothing-to-apply': s('git.error.nothingToApply'),
+        'commit-not-found': s('git.error.commitNotFound'),
+        'file-not-tracked': s('git.error.fileNotTracked'),
+        'invalid-file-path': s('git.error.invalidFilePath'),
+        'workspace-unknown': s('git.error.workspaceUnknown'),
+    };
+    const label = code === undefined ? undefined : labels[code];
+    if (label !== undefined)
+        return label;
+    return s('git.error.internal', { message: message ?? s('git.error.unknown') });
+}
+/** Localized text for a rejection thrown by `git()`: the structured /git error
+ *  when the response carried one, else the plain message. */
+export function gitFailureText(reason, t) {
+    const gitError = reason?.gitError;
+    if (typeof gitError === 'object' && gitError !== null)
+        return gitErrorMessage(gitError, t);
+    const message = reason instanceof Error ? reason.message : String(reason);
+    return message.trim() !== '' ? message : dict(t, 'git.error.unknown');
+}
+/** The XY status letters a row badge shows (X = index, Y = worktree). */
+export function badgeOf(entry) {
+    const index = entry.xy[0];
+    const worktree = entry.xy[1];
+    if (index !== undefined && index !== ' ' && index !== '?')
+        return index;
+    if (worktree !== undefined && worktree !== ' ' && worktree !== '?')
+        return worktree;
+    return '?';
+}
+/** Whether the entry carries STAGED (index) changes — the X letter is set. */
+export function isStagedEntry(entry) {
+    const index = entry.xy[0];
+    return index !== undefined && index !== ' ' && index !== '?';
+}
+/** Whether the entry carries UNSTAGED (worktree) changes — the Y letter is set
+ *  (untracked `??` counts as unstaged: it is a worktree-only change). A file
+ *  with both letters set ('MM') lands in BOTH sections. */
+export function isUnstagedEntry(entry) {
+    if (entry.xy === '??')
+        return true;
+    const worktree = entry.xy[1];
+    return worktree !== undefined && worktree !== ' ' && worktree !== '?';
+}
+/** Whether the entry is untracked (`??`): git diff never includes it. */
+export function isUntracked(entry) {
+    return badgeOf(entry) === '?';
+}
+/** Split the porcelain entries into the two VSCode-style sections. */
+export function splitEntries(entries) {
+    return { staged: entries.filter(isStagedEntry), unstaged: entries.filter(isUnstagedEntry) };
+}
+export function shortOid(oid) { return oid.slice(0, 8); }
+/** The last path segment (diff title for a file). */
+function baseName(path) {
+    const at = Math.max(path.lastIndexOf('/'), path.lastIndexOf('\\'));
+    return at === -1 ? path : path.slice(at + 1);
+}
+/** Compact relative history time ("now" / "5m ago" / "3h ago" / "2d ago"…). */
+export function relativeText(epochMs, now, t) {
+    const s = (key, params) => dict(t, key, params);
+    const diff = Math.max(0, now - epochMs);
+    const MIN = 6e4;
+    const HOUR = 36e5;
+    const DAY = 864e5;
+    if (diff < MIN)
+        return s('git.ago.now');
+    if (diff < HOUR)
+        return s('git.ago.minutes', { n: Math.floor(diff / MIN) });
+    if (diff < DAY)
+        return s('git.ago.hours', { n: Math.floor(diff / HOUR) });
+    if (diff < 30 * DAY)
+        return s('git.ago.days', { n: Math.floor(diff / DAY) });
+    if (diff < 365 * DAY)
+        return s('git.ago.months', { n: Math.floor(diff / (30 * DAY)) });
+    return s('git.ago.years', { n: Math.floor(diff / (365 * DAY)) });
+}
+function commitLabel(commit) { return `${shortOid(commit.oid)} ${commit.subject}`; }
+/** History batch size: the log loads lazily in pages so a long history never
+ *  floods the panel at once (the end of the log is reached by paging). */
+const LOG_BATCH = 30;
+export function GitWorkbench(props) {
+    const { scope, t, onOpenFile } = props;
+    /** Translate through a ref: the panel receives a fresh `t` on every parent
+     *  render, and an unstable translator would change `reload`'s identity and
+     *  re-fire its mount effect (an endless refresh loop). */
+    const tRef = useRef(t);
+    tRef.current = t;
+    const s = useCallback((key, params) => dict(tRef.current, key, params), []);
+    const cwd = scope.cwd;
+    const [status, setStatus] = useState();
+    const [entries, setEntries] = useState([]);
+    const [branches, setBranches] = useState([]);
+    const [commits, setCommits] = useState([]);
+    const [cursor, setCursor] = useState();
+    const [hasMore, setHasMore] = useState(false);
+    const [message, setMessage] = useState('');
+    const [error, setError] = useState('');
+    const [busy, setBusy] = useState(false);
+    /** The inline diff shown below the sections (VSCode-style, no page swap);
+     *  null = nothing open. The body is loaded lazily on first open. */
+    const [inlineDiff, setInlineDiff] = useState(null);
+    /** The open file-row context menu (cursor position for the portaled Menu). */
+    const [fileMenu, setFileMenu] = useState(null);
+    /** The open history-row context menu. */
+    const [historyMenu, setHistoryMenu] = useState(null);
+    /** The pending destructive action awaiting confirmation. */
+    const [confirm, setConfirm] = useState(null);
+    /** Create-branch modal state. */
+    const [createOpen, setCreateOpen] = useState(false);
+    const [branchName, setBranchName] = useState('');
+    const reload = useCallback(async () => {
+        if (!cwd)
+            return;
+        try {
+            const [value, graph, branchView, raw] = await Promise.all([
+                git('status', { path: cwd }),
+                git('graph', { path: cwd, limit: LOG_BATCH }),
+                git('branches', { path: cwd }).then(view => (view?.branches ?? []).map(row => row.name)).catch(() => []),
+                fetch(`/api/workbench/git-status?path=${encodeURIComponent(cwd)}`).then(response => response.ok ? response.json() : null).catch(() => null),
+            ]);
+            setStatus(value);
+            setCommits(graph?.commits ?? []);
+            setCursor(graph?.nextCursor);
+            setHasMore(graph?.hasMore ?? false);
+            setBranches(branchView);
+            setEntries(raw?.entries ?? []);
+            setError('');
+        }
+        catch (reason) {
+            setError(gitFailureText(reason, s));
+            setStatus(null);
+        }
+    }, [cwd, s]);
+    useEffect(() => { void reload(); }, [reload]);
+    // Live sync: the host /git/events stream fires when root/branch/head
+    // change (external commits and switches); a slow poll covers file churn
+    // while the page is visible. KISS — no file watcher.
+    const reloadRef = useRef(reload);
+    reloadRef.current = reload;
+    useEffect(() => {
+        if (!cwd)
+            return;
+        if (typeof EventSource === 'function') {
+            const source = new EventSource(`/git/events?path=${encodeURIComponent(cwd)}`);
+            source.addEventListener('change', () => { void reloadRef.current(); });
+            return () => { source.close(); };
+        }
+        return undefined;
+    }, [cwd]);
+    useEffect(() => {
+        if (!cwd)
+            return;
+        const timer = setInterval(() => { if (!document.hidden)
+            void reloadRef.current(); }, 15_000);
+        return () => { clearInterval(timer); };
+    }, [cwd]);
+    const loadMore = async () => {
+        if (!cwd || !cursor)
+            return;
+        try {
+            const graph = await git('graph', { path: cwd, limit: LOG_BATCH, cursor });
+            setCommits(current => [...current, ...graph.commits]);
+            setCursor(graph.nextCursor);
+            setHasMore(graph.hasMore);
+        }
+        catch (reason) {
+            setError(gitFailureText(reason, s));
+        }
+    };
+    const showWorkingDiff = async (entry, staged) => {
+        if (!cwd)
+            return;
+        if (isUntracked(entry)) {
+            onOpenFile(entry.path);
+            return;
+        }
+        try {
+            const next = (await git('diff', { path: cwd, file: entry.path, staged })).diff;
+            const kind = staged ? s('git.diff.staged') : s('git.diff.worktree');
+            setInlineDiff({ text: next, title: `${kind} · ${baseName(entry.path)}` });
+            setError('');
+        }
+        catch (reason) {
+            setError(gitFailureText(reason, s));
+        }
+    };
+    const showCommitDiff = async (commit) => {
+        if (!cwd)
+            return;
+        try {
+            const next = (await git('commit-diff', { path: cwd, oid: commit.oid })).diff;
+            setInlineDiff({ text: next, title: `${s('git.diff.commit')} ${shortOid(commit.oid)} ${commit.subject}` });
+            setError('');
+        }
+        catch (reason) {
+            setError(gitFailureText(reason, s));
+        }
+    };
+    const stageEntry = async (entry, staged) => {
+        setBusy(true);
+        try {
+            await git(staged ? 'unstage' : 'stage', { path: cwd, file: entry.path });
+            await reload();
+        }
+        catch (reason) {
+            setError(gitFailureText(reason, s));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const stageAll = async (staged) => {
+        setBusy(true);
+        try {
+            await git(staged ? 'unstage' : 'stage', { path: cwd });
+            await reload();
+        }
+        catch (reason) {
+            setError(gitFailureText(reason, s));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const commit = async () => {
+        const text = message.trim();
+        if (!cwd || text === '' || busy)
+            return;
+        setBusy(true);
+        setError('');
+        try {
+            await git('commit', { path: cwd, message: text });
+            setMessage('');
+            await reload();
+        }
+        catch (reason) {
+            setError(gitFailureText(reason, s));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const checkout = async (branch) => {
+        if (!cwd || branch === status?.branch || busy)
+            return;
+        setBusy(true);
+        setError('');
+        try {
+            await git('switch', { path: cwd, branch });
+            await reload();
+        }
+        catch (reason) {
+            setError(gitFailureText(reason, s));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const createBranch = async () => {
+        const name = branchName.trim();
+        if (!cwd || name === '' || busy)
+            return;
+        setBusy(true);
+        setError('');
+        try {
+            await git('create-branch', { path: cwd, name });
+            setBranchName('');
+            setCreateOpen(false);
+            await reload();
+        }
+        catch (reason) {
+            setError(gitFailureText(reason, s));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    /** Run one destructive operation after the confirm modal, then refresh. */
+    const runConfirmed = (state) => {
+        setConfirm({ ...state, onConfirm: async () => {
+                setBusy(true);
+                setError('');
+                try {
+                    await state.onConfirm();
+                    await reload();
+                }
+                catch (reason) {
+                    setError(gitFailureText(reason, s));
+                }
+                finally {
+                    setBusy(false);
+                }
+            } });
+    };
+    const copy = (text) => { void writeClipboard(text); };
+    const openFileMenu = (event, entry, staged) => {
+        event.preventDefault();
+        event.stopPropagation();
+        setFileMenu({ entry, staged, x: event.clientX, y: event.clientY });
+    };
+    const openHistoryMenu = (event, entry) => {
+        event.preventDefault();
+        event.stopPropagation();
+        setHistoryMenu({ entry, x: event.clientX, y: event.clientY });
+    };
+    const { staged: stagedEntries, unstaged: unstagedEntries } = splitEntries(entries);
+    const renderEntry = (entry, staged) => {
+        const untracked = isUntracked(entry);
+        return (_jsxs("div", { className: css.gitRow, children: [_jsxs("button", { type: "button", className: css.gitRowMain, title: entry.path, onClick: () => { void showWorkingDiff(entry, staged); }, onContextMenu: (event) => { openFileMenu(event, entry, staged); }, children: [_jsx("span", { className: css.gitBadge, "data-kind": untracked ? 'U' : badgeOf(entry), children: badgeOf(entry) }), _jsx("span", { className: css.gitName, children: entry.path })] }), _jsxs("span", { className: css.gitRowActions, children: [_jsx("button", { type: "button", className: css.iconButton, "aria-label": staged ? s('git.unstage') : s('git.stage'), title: staged ? s('git.unstage') : s('git.stage'), disabled: busy, onClick: () => { void stageEntry(entry, staged); }, children: staged ? _jsx(IconTrashOutline16, {}) : _jsx(IconBranchOutline16, {}) }), !untracked && (_jsx("button", { type: "button", className: css.iconButton, "aria-label": s('git.discard'), title: s('git.discard'), disabled: busy, onClick: () => {
+                                runConfirmed({
+                                    title: s('git.discardTitle'),
+                                    description: s('git.discardDesc', { path: entry.path }),
+                                    confirmLabel: s('git.discard'),
+                                    onConfirm: () => git('discard', { path: cwd, file: entry.path }),
+                                });
+                            }, children: _jsx(IconTrashOutline16, {}) }))] })] }, `${staged ? 's' : 'u'}:${entry.path}`));
+    };
+    const noStaged = stagedEntries.length === 0;
+    const currentBranch = status?.branch ?? '';
+    return (_jsxs("section", { className: css.git, "data-dsh-plugin": "web-all", "data-dsh-part": "workbench-git", children: [_jsxs("div", { className: css.gitHeader, children: [_jsxs("select", { className: css.gitBranchSelect, value: currentBranch, onChange: (event) => { void checkout(event.target.value); }, disabled: busy || status === null, "aria-label": s('git.title'), children: [currentBranch !== '' && _jsx("option", { value: currentBranch, children: currentBranch }), branches.filter(name => name !== currentBranch).map(name => _jsx("option", { value: name, children: name }, name))] }), _jsx("button", { type: "button", className: css.iconButton, "aria-label": s('git.createBranch'), title: s('git.createBranch'), disabled: busy || status === null, onClick: () => { setBranchName(''); setCreateOpen(true); }, children: _jsx(IconPlusOutline16, {}) }), _jsx("button", { type: "button", className: css.iconButton, "aria-label": s('git.refresh'), title: s('git.refresh'), disabled: busy, onClick: () => { void reload(); }, children: _jsx(IconRefreshOutline16, {}) })] }), error !== '' && _jsx("div", { className: css.gitError, role: "alert", children: error }), status === undefined && _jsx("div", { className: css.gitPlaceholder, children: s('git.loading') }), status === null && error === '' && (_jsxs("div", { className: css.gitNotRepo, children: [_jsx("div", { className: css.gitNotRepoTitle, children: s('git.notRepo') }), _jsx("div", { className: css.gitNotRepoHint, children: s('git.notRepoHint') })] })), status !== undefined && status !== null && (_jsxs(_Fragment, { children: [status.conflicts > 0 && _jsx("div", { className: css.gitBanner, "data-kind": "danger", children: s('git.conflictBanner') }), status.operationInProgress && _jsx("div", { className: css.gitBanner, children: s('git.opBanner') }), _jsxs("div", { className: css.gitSection, children: [_jsxs("div", { className: css.gitSectionHeader, children: [_jsxs("span", { children: [s('git.staged'), " (", stagedEntries.length, ")"] }), stagedEntries.length > 0 && (_jsx("button", { type: "button", className: css.gitLink, disabled: busy, onClick: () => { void stageAll(true); }, children: s('git.unstageAll') }))] }), stagedEntries.length === 0 && _jsx("div", { className: css.gitEmpty, children: s('git.stagedEmpty') }), stagedEntries.map(entry => renderEntry(entry, true))] }), _jsxs("div", { className: css.gitSection, children: [_jsxs("div", { className: css.gitSectionHeader, children: [_jsxs("span", { children: [s('git.changes'), " (", unstagedEntries.length, ")"] }), unstagedEntries.length > 0 && (_jsx("button", { type: "button", className: css.gitLink, disabled: busy, onClick: () => { void stageAll(false); }, children: s('git.stageAll') }))] }), unstagedEntries.length === 0 && _jsx("div", { className: css.gitEmpty, children: s('git.changesEmpty') }), unstagedEntries.map(entry => renderEntry(entry, false))] }), _jsxs("div", { className: css.gitCommit, children: [_jsx(Input, { className: css.gitCommitInput, placeholder: s('git.commitPlaceholder'), value: message, disabled: busy, onChange: (event) => { setMessage(event.target.value); setError(''); }, onKeyDown: (event) => {
+                                    if ((event.ctrlKey || event.metaKey) && event.key === 'Enter')
+                                        void commit();
+                                } }), _jsx("button", { type: "button", className: css.gitCommitButton, disabled: busy || message.trim() === '' || noStaged, onClick: () => { void commit(); }, children: s('git.commit') })] }), noStaged && message.trim() !== '' && _jsx("div", { className: css.gitHint, children: s('git.commitHint') }), inlineDiff !== null && (_jsxs("div", { className: css.gitInlineDiff, children: [_jsxs("div", { className: css.gitInlineDiffHeader, children: [_jsx("span", { className: css.gitInlineDiffTitle, children: inlineDiff.title }), _jsx("button", { type: "button", className: css.iconButton, "aria-label": s('git.closeDiff'), title: s('git.closeDiff'), onClick: () => { setInlineDiff(null); }, children: _jsx(IconCloseOutline16, {}) })] }), _jsx(DiffView, { text: inlineDiff.text, title: inlineDiff.title, t: t })] })), _jsxs("div", { className: css.gitSection, children: [_jsx("div", { className: css.gitSectionHeader, children: _jsx("span", { children: s('git.history') }) }), commits.map(commit => (_jsxs("div", { role: "button", tabIndex: 0, className: css.gitLogRow, title: `${commit.author}\n${commit.oid}`, onClick: () => { void showCommitDiff(commit); }, onKeyDown: (event) => {
+                                    if (event.key === 'Enter' || event.key === ' ') {
+                                        event.preventDefault();
+                                        void showCommitDiff(commit);
+                                    }
+                                }, onContextMenu: (event) => { openHistoryMenu(event, commit); }, children: [_jsxs("span", { className: css.gitLogLine1, children: [_jsx("span", { className: css.gitLogHash, children: shortOid(commit.oid) }), _jsx("span", { className: css.gitLogSubject, children: commit.subject })] }), _jsxs("span", { className: css.gitLogLine2, children: [commit.refs.map(ref => _jsx("span", { className: css.gitLogRef, children: ref }, ref)), _jsxs("span", { className: css.gitLogMeta, children: [commit.author, " \u00B7 ", relativeText(commit.authorTime * 1000, Date.now(), t)] })] })] }, commit.oid))), hasMore && (_jsx("button", { type: "button", className: css.gitLogMore, disabled: busy, onClick: () => { void loadMore(); }, children: s('git.loadMore') }))] })] })), _jsx(Menu, { open: fileMenu !== null, onClose: () => { setFileMenu(null); }, items: [
+                    { id: 'open', label: s('git.openEditor'), icon: _jsx(IconCodeOutline16, { size: 14 }) },
+                    fileMenu?.staged === true
+                        ? { id: 'stage', label: s('git.unstage'), icon: _jsx(IconTrashOutline16, { size: 14 }) }
+                        : { id: 'stage', label: s('git.stage'), icon: _jsx(IconBranchOutline16, { size: 14 }) },
+                    ...(fileMenu !== null && !isUntracked(fileMenu.entry)
+                        ? [{ id: 'discard', label: s('git.discard'), icon: _jsx(IconTrashOutline16, { size: 14 }), danger: true }]
+                        : []),
+                    { type: 'separator', id: 'sep1' },
+                    { id: 'relative', label: s('git.copyRelative'), icon: _jsx(IconCopyOutline16, { size: 14 }) },
+                    { id: 'absolute', label: s('git.copyAbsolute'), icon: _jsx(IconCopyOutline16, { size: 14 }) },
+                ], onSelect: (id) => {
+                    const target = fileMenu;
+                    if (target === null)
+                        return;
+                    setFileMenu(null);
+                    if (id === 'open') {
+                        onOpenFile(target.entry.path);
+                        return;
+                    }
+                    if (id === 'stage') {
+                        void stageEntry(target.entry, target.staged);
+                        return;
+                    }
+                    if (id === 'discard') {
+                        runConfirmed({
+                            title: s('git.discardTitle'),
+                            description: s('git.discardDesc', { path: target.entry.path }),
+                            confirmLabel: s('git.discard'),
+                            onConfirm: () => git('discard', { path: cwd, file: target.entry.path }),
+                        });
+                        return;
+                    }
+                    if (id === 'relative') {
+                        copy(workspaceRelativePath(cwd, target.entry.path));
+                        return;
+                    }
+                    if (id === 'absolute')
+                        copy(target.entry.path);
+                }, portal: true, align: "start", getAnchorRect: () => (fileMenu === null ? null : new DOMRect(fileMenu.x, fileMenu.y, 0, 0)), anchor: _jsx("span", {}) }), _jsx(Menu, { open: historyMenu !== null, onClose: () => { setHistoryMenu(null); }, items: [
+                    { id: 'view', label: s('git.viewDiff'), icon: _jsx(IconCodeOutline16, { size: 14 }) },
+                    { id: 'copyShort', label: s('git.copyShortHash'), icon: _jsx(IconCopyOutline16, { size: 14 }) },
+                    { id: 'copyFull', label: s('git.copyFullHash'), icon: _jsx(IconCopyOutline16, { size: 14 }) },
+                    { id: 'copySubject', label: s('git.copySubject'), icon: _jsx(IconCopyOutline16, { size: 14 }) },
+                    { type: 'separator', id: 'sep2' },
+                    { id: 'revert', label: s('git.revert'), danger: true },
+                    { id: 'cherryPick', label: s('git.cherryPick'), danger: true },
+                ], onSelect: (id) => {
+                    const target = historyMenu;
+                    if (target === null)
+                        return;
+                    setHistoryMenu(null);
+                    if (id === 'view') {
+                        void showCommitDiff(target.entry);
+                        return;
+                    }
+                    if (id === 'copyShort') {
+                        copy(shortOid(target.entry.oid));
+                        return;
+                    }
+                    if (id === 'copyFull') {
+                        copy(target.entry.oid);
+                        return;
+                    }
+                    if (id === 'copySubject') {
+                        copy(target.entry.subject);
+                        return;
+                    }
+                    if (id === 'revert') {
+                        runConfirmed({
+                            title: s('git.revertTitle'),
+                            description: s('git.revertDesc', { subject: commitLabel(target.entry) }),
+                            confirmLabel: s('git.revert'),
+                            onConfirm: () => git('revert', { path: cwd, oid: target.entry.oid }),
+                        });
+                        return;
+                    }
+                    if (id === 'cherryPick') {
+                        runConfirmed({
+                            title: s('git.cherryPickTitle'),
+                            description: s('git.cherryPickDesc', { subject: commitLabel(target.entry) }),
+                            confirmLabel: s('git.cherryPick'),
+                            onConfirm: () => git('cherry-pick', { path: cwd, oid: target.entry.oid }),
+                        });
+                    }
+                }, portal: true, align: "start", getAnchorRect: () => (historyMenu === null ? null : new DOMRect(historyMenu.x, historyMenu.y, 0, 0)), anchor: _jsx("span", {}) }), _jsx(Modal, { open: confirm !== null, onClose: () => { setConfirm(null); }, title: confirm?.title ?? '', closeLabel: s('git.close'), footer: (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "outline", onClick: () => { setConfirm(null); }, children: s('git.cancel') }), _jsx(Button, { variant: "primary", disabled: busy, onClick: () => {
+                                const pending = confirm;
+                                if (pending === null)
+                                    return;
+                                setConfirm(null);
+                                void pending.onConfirm();
+                            }, children: confirm?.confirmLabel ?? '' })] })), children: _jsx("p", { className: css.gitConfirmDesc, children: confirm?.description }) }), _jsx(Modal, { open: createOpen, onClose: () => { setCreateOpen(false); }, title: s('git.createBranchTitle'), closeLabel: s('git.close'), footer: (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "outline", onClick: () => { setCreateOpen(false); }, children: s('git.cancel') }), _jsx(Button, { variant: "primary", disabled: busy || branchName.trim() === '', onClick: () => { void createBranch(); }, children: s('git.confirm') })] })), children: _jsxs("label", { className: css.gitCreateLabel, children: [s('git.branchName'), _jsx(Input, { value: branchName, placeholder: s('git.branchPlaceholder'), disabled: busy, onChange: (event) => { setBranchName(event.target.value); setError(''); }, onKeyDown: (event) => { if (event.key === 'Enter')
+                                void createBranch(); } })] }) })] }));
+}
+/** Strip a workspace root from an absolute path (copy-relative convenience). */
+export function workspaceRelativePath(cwd, path) {
+    const normalized = path.replaceAll('\\', '/');
+    const root = cwd?.replaceAll('\\', '/').replace(/\/+$/u, '');
+    return root !== undefined && normalized.startsWith(`${root}/`) ? normalized.slice(root.length + 1) : normalized;
+}

package/lib/types/client/sidebar/icons.d.ts

@@ -0,0 +1,9 @@
+/** Guide-entry icons for the right-pane additions (git, browser, agent browser). */
+import type { ComponentType } from 'react';
+import type { IconProps } from '@deepseek-ai/dsh-client-ui-primitives';
+/** Browser glyph: a globe with meridians (matches the primitives' outline style). */
+export declare const IconGlobeOutline16: ComponentType<IconProps>;
+/** Agent-browser glyph: a monitor with a playing cursor, mirroring the live
+ *  screencast surface (matches the outline style). */
+export declare const IconAgentBrowser16: ComponentType<IconProps>;
+//# sourceMappingURL=icons.d.ts.map

package/lib/types/client/sidebar/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../../src/client/sidebar/icons.tsx"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAA;AAEtE,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,SAAS,CAMvD,CAAA;AAED;sDACsD;AACtD,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,SAAS,CAOvD,CAAA"}

package/lib/types/client/sidebar/icons.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** Browser glyph: a globe with meridians (matches the primitives' outline style). */
+export const IconGlobeOutline16 = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: [_jsx("circle", { cx: "8", cy: "8", r: "6.5", stroke: "currentColor", strokeWidth: "1.5" }), _jsx("ellipse", { cx: "8", cy: "8", rx: "2.8", ry: "6.5", stroke: "currentColor", strokeWidth: "1.5" }), _jsx("path", { d: "M1.5 8h13M8 1.5c-2.4 1.8-2.4 11.2 0 13M8 1.5c2.4 1.8 2.4 11.2 0 13", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round" })] }));
+/** Agent-browser glyph: a monitor with a playing cursor, mirroring the live
+ *  screencast surface (matches the outline style). */
+export const IconAgentBrowser16 = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: [_jsx("rect", { x: "1.5", y: "2.5", width: "13", height: "9.5", rx: "1.5", stroke: "currentColor", strokeWidth: "1.5" }), _jsx("path", { d: "M5.5 15h5", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round" }), _jsx("path", { d: "M8 12v3", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round" }), _jsx("path", { d: "M6 6.2 10 8l-4 1.8z", fill: "currentColor", stroke: "currentColor", strokeWidth: "1", strokeLinejoin: "round" })] }));

package/lib/types/client/sidebar/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 位置模块：侧栏（sidebar）— 唯一负责侧栏注入的位置模块。
+ *
+ * SSH / 记忆都是 0.2 原生面板（`sidebar.panellist` 行 + `main` 主栏 body），
+ * 与官方 Plugins 页同一套外观、选中语义与页面版心；右栏（right-pane）由本
+ * 模块装载（Git 管理 / Agent 浏览器页签，见 right-pane.tsx）。
+ *
+ * Git Worktree 不是侧栏页面：分支在新建对话时由输入框选择器选定，其生命周期
+ * 挂在会话顶部的 lane chip 上（见 conversation 位置模块）。
+ *
+ * 侧栏标题行是官方 DOM，本模块只做样式编排（不注册官方槽位、不改官方节点）：
+ * 品牌位不出现、标题行收掉、折叠按钮搬到页脚与「设置」行并列，规则与取舍见
+ * sidebar-header.module.css。
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import './sidebar-header.module.css';
+/** 装配侧栏位置模块：原生面板 + 右栏。 */
+export declare function mountSidebar(ctx: ClientContext): () => void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/sidebar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/sidebar/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAInE,OAAO,6BAA6B,CAAA;AAEpC,0BAA0B;AAC1B,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,IAAI,CAM3D"}

package/lib/types/client/sidebar/index.js

@@ -0,0 +1,12 @@
+import { registerNativePanels } from "./native-panels.js";
+import { mountRightPane } from "./right-pane.js";
+import './sidebar-header.module.css';
+/** 装配侧栏位置模块：原生面板 + 右栏。 */
+export function mountSidebar(ctx) {
+    const disposers = [
+        registerNativePanels(ctx),
+        mountRightPane(ctx),
+    ];
+    return () => { for (const dispose of disposers)
+        dispose(); };
+}

package/lib/types/client/sidebar/native-panels.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 原生主面板注册（DSH 0.2）：SSH / 记忆两个家族页面统一用官方
+ * `sidebar.panellist` 行 + `main` 主栏面板渲染 —— 行外观、选中态、折叠行为与
+ * 官方「Plugins」页一致，页面版心与加载态复用 page-shell.tsx（同一套官方插件
+ * 页度量）。旧的「DOM 注入中栏 + html 属性显隐 + footer 动作」接管方式已全部
+ * 移除。
+ *
+ * Git Worktree 不在其中：它没有页面。分支在新建对话时由输入框选择器选定，该
+ * worktree 的状态与收尾动作都在会话顶部的 lane chip 上。
+ *
+ * 飞书不占侧栏：它的连接与配置都在设置页（见 client/settings/lark-inbox.tsx）。
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+/** 主栏面板 id（同时也是 sidebar.panellist 行的 id）。 */
+export declare const SSH_PANEL_ID = "web-all-ssh";
+export declare const MEMOIR_PANEL_ID = "web-all-memoir";
+/** 挂载 SSH / 记忆两个原生面板；返回统一 disposer。 */
+export declare function registerNativePanels(ctx: ClientContext): () => void;
+//# sourceMappingURL=native-panels.d.ts.map

package/lib/types/client/sidebar/native-panels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-panels.d.ts","sourceRoot":"","sources":["../../../../src/client/sidebar/native-panels.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAqBnE,6CAA6C;AAC7C,eAAO,MAAM,YAAY,gBAAgB,CAAA;AACzC,eAAO,MAAM,eAAe,mBAAmB,CAAA;AAgE/C,uCAAuC;AACvC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,IAAI,CAgDnE"}