@deepseek-ai/dsh-experimental-client-ui-forge 0.0.0-stage → 0.2.2-alpha.3

package/lib/types/client/locales.d.ts

@@ -0,0 +1,282 @@
+/** Forge panel copy owned by the locale dictionaries. */
+/** Locale namespace of the forge panel. */
+export declare const NS = "forgePanel";
+/** Chinese copy; its keys define {@link ForgePanelKey}. */
+export declare const zh: {
+    readonly 'review.startReview': "开始评审";
+    readonly 'review.githubActions': "GitHub 评论选项";
+    readonly 'review.publishing': "发布中…";
+    readonly 'review.submitting': "提交中…";
+    readonly 'review.close': "关闭";
+    readonly 'review.pending': "待提交";
+    readonly 'review.quoted': "已添加到输入框";
+    readonly 'review.yourComment': "你的评论";
+    readonly 'review.outdated': "代码已更新";
+    readonly 'review.done': "完成";
+    readonly 'review.addComment': "添加评论";
+    readonly 'diff.resizeFileTree': "调整文件树宽度";
+    readonly 'diff.fileTree': "文件树";
+    readonly 'diff.showFileTreeLeft': "在左侧显示文件树";
+    readonly 'diff.moveFileTreeRight': "将文件树移到右侧";
+    readonly 'guide.title': "代码审查和变更";
+    readonly 'guide.description': "查看代码变更与本会话的变更请求";
+    readonly 'diff.hideFileTree': "隐藏文件树";
+    readonly 'review.range': "评论 {range}";
+    readonly 'review.comment': "留下评论…";
+    readonly 'review.cancel': "取消";
+    readonly 'review.addToInput': "添加到输入框";
+    readonly 'review.publish': "发布单条评论";
+    readonly 'review.queue': "加入评审";
+    readonly 'review.selectLine': "选择第 {line} 行";
+    readonly 'review.inputFailed': "输入框暂时无法添加引用，请稍后重试";
+    readonly 'review.saveFailed': "无法保存评审草稿，请检查浏览器存储后重试";
+    readonly 'review.unknown': "无法确认提交结果。请先在 GitHub 核对，避免重复发布";
+    readonly 'review.submit': "提交评审";
+    readonly 'review.summary': "评审总结…";
+    readonly 'review.approve': "批准";
+    readonly 'review.requestChanges': "请求更改";
+    readonly 'review.summaryRequired': "请求更改时，请填写评审总结";
+    readonly 'review.commentOnly': "评论";
+    readonly 'review.drafts': "待提交评论（{count}）";
+    readonly 'review.edit': "编辑";
+    readonly 'review.remove': "删除";
+    readonly 'review.stale': "PR 已有新提交，请刷新并重新选择评论行";
+    readonly 'review.published': "已发布到 GitHub";
+    readonly 'review.submitted': "已提交评审";
+    readonly 'review.failed': "提交失败：{message}";
+    readonly 'review.unsupported': "此代码托管服务不支持提交评审";
+    readonly 'review.loadFailed': "无法读取评审草稿，请检查浏览器存储";
+    readonly 'review.recheck': "在 GitHub 查看";
+    readonly 'review.confirmRetry': "已核对，允许重新提交";
+    readonly 'tab.title': "变更请求";
+    readonly 'header.label': "本会话的变更请求";
+    readonly 'header.attention': "本会话的变更请求需要处理";
+    readonly 'checkout.worktree': "工作树";
+    readonly 'checkout.worktreeFrom': "工作树 · 基于 {base}";
+    readonly 'checkout.project': "项目目录";
+    readonly 'checkout.detached': "未在分支上";
+    readonly 'checkout.restore': "恢复";
+    readonly 'checkout.copyWorktreePath': "复制工作树路径";
+    readonly 'checkout.copyProjectPath': "复制项目目录路径";
+    readonly 'checkout.none': "当前目录不是 Git 仓库";
+    readonly 'checkout.failed': "无法读取 Git 信息";
+    readonly 'changes.title': "本会话的变更请求 · {count}";
+    readonly 'changes.empty': "本会话还没有变更请求";
+    readonly 'changes.emptyHint': "本会话关联的变更请求（创建、查看、编辑或检出的，以及所在分支或推送分支上的）会显示在这里";
+    readonly 'changes.local.title': "本地变更";
+    readonly 'changes.local.refs': "{head} → {base}";
+    readonly 'changes.local.files': "{count} 个文件";
+    readonly 'changes.local.viewAria': "查看本会话的变更：{count} 个文件，新增 {added} 行，删除 {deleted} 行";
+    readonly 'changes.local.create': "创建变更请求";
+    readonly 'changes.local.prompt': "为本会话的变更创建变更请求";
+    readonly 'signin.title': "登录 {host} 后才能显示变更请求状态";
+    readonly 'signin.copy': "复制登录命令";
+    readonly 'signin.unavailable': "无法读取 {host} 上的变更请求：{message}";
+    readonly refresh: "刷新状态";
+    readonly retry: "重试";
+    readonly 'stream.failed': "无法加载变更请求面板";
+    readonly 'change.number': "#{number}";
+    readonly 'change.stateAria': "变更请求状态：{state}";
+    readonly 'change.state.open': "打开";
+    readonly 'change.state.blocked': "需要处理";
+    readonly 'change.state.draft': "草稿";
+    readonly 'change.state.merged': "已合并";
+    readonly 'change.state.closed': "已关闭";
+    readonly 'change.state.unknown': "未知";
+    readonly 'list.worktree': "在自己的工作树中";
+    readonly 'list.stateChecks': "{state} · {checks}";
+    readonly 'list.more': "还有 {count} 个变更请求";
+    readonly 'change.expand': "展开 {name}";
+    readonly 'change.collapse': "收起 {name}";
+    readonly 'change.ci.none': "没有检查";
+    readonly 'change.ci.running': "检查中";
+    readonly 'change.ci.passed': "检查通过";
+    readonly 'change.ci.failed': "{count} 项检查失败";
+    readonly 'change.ci.cancelled': "已取消 {count} 项检查";
+    readonly 'change.ci.failedUnlisted': "检查失败";
+    readonly 'change.checks.failed': "{count} 项失败";
+    readonly 'change.checks.running': "{count} 项进行中";
+    readonly 'change.checks.passed': "{count} 项通过";
+    readonly 'change.checks.cancelled': "{count} 项已取消";
+    readonly 'change.checks.other': "其他 {count} 项";
+    readonly 'change.checks.truncated': "已加载 {count} 项检查，仍有更多";
+    readonly 'change.checks.loading': "正在加载更多检查";
+    readonly 'change.checks.loadFailed': "更多检查加载失败：{message}";
+    readonly 'change.checks.retry': "重试加载检查";
+    readonly 'change.check.running': "进行中";
+    readonly 'change.check.queued': "排队中";
+    readonly 'change.flag.changesRequested': "要求修改";
+    readonly 'change.flag.conflicting': "有冲突";
+    readonly 'change.flag.draft': "草稿";
+    readonly 'change.failure.unavailable': "无法读取变更请求状态";
+    readonly 'change.failure.notFound': "变更请求不存在或没有访问权限";
+    readonly 'change.failure.unauthenticated': "登录后才能读取状态";
+    readonly 'change.unserved': "暂不支持读取该平台的变更请求状态";
+    readonly 'change.view': "在浏览器中打开";
+    readonly 'change.copy': "复制变更请求链接";
+    readonly 'change.viewChangesAria': "查看 {name} 的变更：新增 {added} 行，删除 {deleted} 行";
+    readonly 'change.remove': "从本会话移除";
+    readonly 'change.removeAria': "从本会话移除 {name}";
+    readonly 'change.row.checks': "检查";
+    readonly 'change.row.review': "评审";
+    readonly 'change.row.merge': "合并";
+    readonly 'change.row.changes': "变更";
+    readonly 'change.review.approved': "已批准";
+    readonly 'change.review.changesRequested': "要求修改";
+    readonly 'change.review.required': "等待评审";
+    readonly 'change.review.none': "尚未请求评审";
+    readonly 'change.review.threads': "{review} · {count} 条未解决讨论";
+    readonly 'change.merge.mergeable': "无冲突";
+    readonly 'change.merge.conflicting': "与 {base} 有冲突";
+    readonly 'change.merge.unknown': "正在检查冲突";
+    readonly 'change.mergedTo': "已合并到 {base}";
+    readonly 'change.markReady': "标记为可评审";
+    readonly 'change.merge': "合并";
+    readonly 'change.mergeTitle': "将 {name} 合并到 {base}";
+    readonly 'change.mergeMethod.squash': "压缩合并";
+    readonly 'change.mergeMethod.merge': "创建合并提交";
+    readonly 'change.mergeMethod.rebase': "变基合并";
+    readonly 'change.mergeNote.squash': "把全部提交压缩成一个提交";
+    readonly 'change.mergeNote.merge': "保留全部提交，并新增一个合并提交";
+    readonly 'change.mergeNote.rebase': "把提交逐个变基到 {base}";
+    readonly 'change.mergeConfirm': "确认合并";
+    readonly 'change.mergeChanged': "提交已更新，请重新检查后再打开合并菜单";
+    readonly 'diff.tab': "变更";
+    readonly 'diff.tabNumbered': "#{number} 的变更";
+    readonly 'diff.scope.branch': "分支";
+    readonly 'diff.scope.uncommitted': "未提交";
+    readonly 'diff.scope.unstaged': "未暂存";
+    readonly 'diff.scope.staged': "已暂存";
+    readonly 'diff.scopeNote.branch': "与 {base} 比较，包含未提交的修改";
+    readonly 'diff.scopeNote.uncommitted': "与 HEAD 比较，包含未跟踪的文件";
+    readonly 'diff.scopeNote.unstaged': "与暂存区比较，包含未跟踪的文件";
+    readonly 'diff.scopeNote.staged': "暂存区与 HEAD 比较";
+    readonly 'diff.allFiles': "全部 {count} 个文件";
+    readonly 'diff.filterFiles': "筛选文件…";
+    readonly 'diff.noMatchingFiles': "没有匹配的文件";
+    readonly 'diff.refresh': "刷新变更";
+    readonly 'diff.expandAll': "全部展开";
+    readonly 'diff.collapseAll': "全部折叠";
+    readonly 'diff.split': "切换为左右对比";
+    readonly 'diff.unified': "切换为单栏对比";
+    readonly 'diff.splitAria': "左右对比";
+    readonly 'diff.wrap': "开启自动换行";
+    readonly 'diff.nowrap': "关闭自动换行";
+    readonly 'diff.wrapAria': "自动换行";
+    readonly 'diff.unchanged': "{count} 行未变更";
+    readonly 'diff.unchangedRest': "其余未变更的行";
+    readonly 'diff.newFile': "新文件";
+    readonly 'diff.deletedFile': "已删除";
+    readonly 'diff.renamed': "由 {from} 重命名";
+    readonly 'diff.renamedPath': "{from} → {path}";
+    readonly 'diff.badgeUncommitted': "未提交";
+    readonly 'diff.binary': "二进制文件，无法显示变更";
+    readonly 'diff.binaryLabel': "二进制";
+    readonly 'diff.largeCollapsed': "文件较大，{count} 行变更已收起";
+    readonly 'diff.fileTooLarge': "文件太大，无法显示变更";
+    readonly 'diff.error': "无法读取变更";
+    readonly 'diff.tooLarge': "变更太大，无法在这里显示";
+    readonly 'diff.filterConfigFailed': "无法完整读取 Git 过滤器配置，尚未执行比较。请检查 Git 配置和读取上限后重试";
+    readonly 'diff.viewInBrowser': "在浏览器中查看";
+    readonly 'diff.noForkPoint': "找不到本分支的分叉点，请选择其他范围";
+    readonly 'diff.empty': "没有变更";
+    readonly 'diff.omitted': "另有 {count} 个未跟踪的文件没有列出";
+    readonly 'diff.stale': "本地有 {count} 个提交尚未推送，这里显示的是变更请求上的变更";
+    readonly 'diff.moreActions': "{name} 的更多操作";
+    readonly 'diff.copyPath': "复制路径";
+    readonly 'diff.openFileInBrowser': "在浏览器中查看文件";
+    readonly 'diff.openFileInSidebar': "在侧边栏打开整个文件";
+    readonly 'time.now': "刚刚";
+    readonly 'time.minutes': "{n} 分钟前";
+    readonly 'time.hours': "{n} 小时前";
+    readonly 'time.days': "{n} 天前";
+    readonly 'time.months': "{n} 个月前";
+    readonly 'time.years': "{n} 年前";
+    readonly 'time.finished': "{state} · {time}";
+    readonly 'duration.seconds': "{seconds} 秒";
+    readonly 'duration.minutes': "{minutes} 分 {seconds} 秒";
+    readonly 'duration.hours': "{hours} 小时 {minutes} 分";
+    readonly 'worktree.label': "新建工作树";
+    readonly 'worktree.hint': "在独立的工作树中运行本会话：发送后基于所选分支新建分支，修改和提交不影响项目目录";
+    readonly 'worktree.blocked.outside-writable-root': "这个工作区的 Git 数据不在可写目录中（例如工作区本身就是工作树），暂不支持使用工作树";
+    readonly 'worktree.blocked.read-only': "只读模式下无法使用工作树";
+    readonly 'worktree.base': "基于 {branch}";
+    readonly 'worktree.baseHead': "基于当前 HEAD";
+    readonly 'worktree.baseMenu': "选择基准分支";
+    readonly 'worktree.currentBranch': "当前分支";
+    readonly 'worktree.currentBranchTip': "当前分支：{branch}";
+    readonly 'worktree.detachedTip': "未在分支上 · {commit}";
+    readonly 'creation.title': "正在创建工作树";
+    readonly 'creation.failed': "创建工作树失败";
+    readonly 'creation.prepare': "创建分支";
+    readonly 'creation.checkout': "检出文件";
+    readonly 'creation.details': "更多详情";
+    readonly 'creation.branch': "分支";
+    readonly 'creation.base': "基于";
+    readonly 'creation.head': "当前 HEAD";
+    readonly 'creation.error': "原因";
+    readonly 'creation.skip': "不使用工作树";
+    readonly 'creation.cancel': "取消";
+    readonly 'creation.stopped': "已停止创建工作树";
+    readonly 'creation.retry': "重试";
+    readonly 'creation.waiting': "消息会在工作树建好后发送";
+    readonly 'missing.title': "工作树不可用";
+    readonly 'missing.unknown': "工作树恢复尚未完成，暂时无法确认分支 {branch} 的状态。请排除恢复错误后重试，或在项目目录继续";
+    readonly 'missing.kept': "可以在原位置恢复分支 {branch} 的工作树。删除前未提交的修改无法恢复";
+    readonly 'missing.recreated': "分支 {branch} 也已删除。恢复时会从创建时的提交重建分支，之后的提交和未提交的修改无法恢复";
+    readonly 'missing.restore': "恢复工作树";
+    readonly 'missing.leave': "在项目目录继续";
+    readonly 'missing.waiting': "恢复工作树或在项目目录继续后，消息会接着发送";
+    readonly 'restoration.title': "正在恢复工作树";
+    readonly 'restoration.prepare': "准备工作树";
+    readonly 'branch.worktree': "工作树（基于 {base}）：{path}";
+    readonly 'branch.linked': "工作树：{path}";
+    readonly 'branch.project': "项目目录：{path}";
+    readonly 'branch.missing': "工作树不可用：{path}";
+    readonly 'toast.removed': "已从本会话移除 {name}";
+    readonly 'toast.undo': "撤销";
+    readonly 'toast.undoFailed': "撤销失败";
+    readonly 'toast.removeFailed': "移除失败";
+    readonly 'toast.refreshFailed': "刷新失败";
+    readonly 'toast.copied': "已复制链接";
+    readonly 'toast.copyFailed': "复制失败";
+    readonly 'toast.branchesFailed': "无法读取分支";
+    readonly 'toast.worktreeFailed': "无法更改工作树选项";
+    readonly 'toast.worktreeStarted': "会话已开始，无法再改用工作树";
+    readonly 'toast.restored': "工作树已恢复";
+    readonly 'toast.restoreFailed': "无法恢复工作树：{message}";
+    readonly 'toast.leaveFailed': "无法切换到项目目录，请稍后重试";
+    readonly 'toast.markedReady': "已将 {name} 标记为可评审";
+    readonly 'toast.markReadyFailed': "标记失败：{message}";
+    readonly 'toast.merged': "已合并 {name}";
+    readonly 'toast.mergeFailed': "合并失败：{message}";
+    readonly 'toast.mergeStale': "{name} 有新的提交，确认后再合并";
+    readonly 'toast.pathCopied': "已复制路径";
+    readonly 'toast.expandFailed': "无法显示未变更的行：{message}";
+    readonly 'toast.expandStale': "文件在读取变更后又有修改，刷新后再展开";
+    readonly 'toast.prompted': "已发送：{text}";
+    readonly 'toast.promptFailed': "无法发送消息";
+};
+/** Key of the forge panel dictionaries. */
+export type ForgePanelKey = keyof typeof zh;
+/** English copy with the same keys. */
+export declare const en: Record<ForgePanelKey, string>;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Forge panel tab, changes view, header button, worktree option and creation card, and action notices. */
+        forgePanel: ForgePanelKey;
+    }
+}
+/** Japanese copy with the same keys. */
+export declare const ja: Record<ForgePanelKey, string>;
+/** Spanish copy with the same keys. */
+export declare const es: Record<ForgePanelKey, string>;
+/** French copy with the same keys. */
+export declare const fr: Record<ForgePanelKey, string>;
+/** German copy with the same keys. */
+export declare const de: Record<ForgePanelKey, string>;
+/** Russian copy with the same keys. */
+export declare const ru: Record<ForgePanelKey, string>;
+/** Portuguese copy with the same keys. */
+export declare const pt: Record<ForgePanelKey, string>;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/mount.d.ts

@@ -0,0 +1,17 @@
+/** Remote contribution and slot registrations of the forge panel. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
+/** Services required before the Remote contribution mounts. */
+export declare const inject: string[];
+/** Registry id of the forge tab type, also its slot key. */
+export declare const TAB_ID = "@deepseek-ai/dsh-experimental-client-ui-forge";
+/** Kind of the forge tab. */
+export declare const TAB_KIND = "forge-panel";
+/**
+ * Mount the forge panel Remote, then the UI that calls it; the UI is withdrawn before the Remote.
+ * @param ctx - client plugin lifetime.
+ * @param contribution - generated forge panel Remote definitions.
+ * @returns the disposer that removes both contributions.
+ */
+export declare function mountForgePanel(ctx: Context, contribution: TypertRemoteContribution): Promise<() => Promise<void>>;
+//# sourceMappingURL=mount.d.ts.map

package/lib/types/client/review-queue.d.ts

@@ -0,0 +1,136 @@
+/** Browser-persisted review drafts and the write whose outcome still needs confirmation. */
+import type { ForgeReviewRequest } from '@deepseek-ai/dsh-experimental-forge/types';
+import type { ReviewSelection, ReviewSource } from './review.ts';
+/** A comment retained after adding its reference or receiving a publication receipt. */
+export type ReviewRecord = {
+    readonly kind: 'agent';
+    readonly selection: ReviewSelection;
+} | {
+    readonly kind: 'published';
+    readonly selection: ReviewSelection;
+    readonly url: string;
+};
+/** One inline record; its numeric key belongs only to the retained browser store. */
+export type ReviewThread = {
+    readonly key: number;
+} & (ReviewRecord | {
+    readonly kind: 'pending';
+    readonly selection: ReviewSelection;
+});
+/** File-scoped snapshot that does not change while unrelated comments or the summary are edited. */
+export interface FileReviewState {
+    readonly threads: readonly ReviewThread[];
+    readonly locked: boolean;
+    readonly error: ReviewQueueState['error'];
+}
+/** Stable snapshot for a file without a comment store. */
+export declare const EMPTY_FILE_REVIEW: FileReviewState;
+/** Immutable queue snapshot; errors leave the original stored bytes untouched. */
+export interface ReviewQueueState {
+    readonly comments: readonly ReviewSelection[];
+    readonly records: readonly ReviewRecord[];
+    readonly body: string;
+    readonly event: 'comment' | 'approve' | 'request-changes';
+    readonly uncertain: ForgeReviewRequest | null;
+    readonly error: 'load' | 'save' | null;
+}
+/** Initial state of a newly opened review tab. */
+export declare const EMPTY_REVIEW: ReviewQueueState;
+/** One review tab's drafts and records, retained until its occurrence closes. */
+export declare class ReviewQueue {
+    private readonly key;
+    private closed;
+    private state;
+    private readonly listeners;
+    private readonly keys;
+    private nextKey;
+    private readonly files;
+    /** @param key - browser storage key including Session and tab identity. */
+    constructor(key: string);
+    /** Current queue snapshot, stable between edits and storage failures. */
+    readonly getSnapshot: () => ReviewQueueState;
+    /**
+     * Clear this tab's records and refuse later completions from its outgoing requests.
+     * @returns whether its browser storage was cleared; the in-memory state always closes.
+     */
+    close(): boolean;
+    /** Summary subscribed by the surrounding diff; editing draft text does not invalidate its file rows. */
+    readonly getStatus: () => string;
+    /**
+     * Read stable inline records for one path and review source.
+     * @param path - repository-relative file path.
+     * @param source - PR or local scope; older head commits remain available as outdated comments.
+     * @returns records and edit availability, reusing the snapshot when these values are unchanged.
+     */
+    fileComments(path: string, source: ReviewSource): FileReviewState;
+    /**
+     * Retain an Agent reference at its original code location.
+     * @param selection - reference already accepted by the main composer.
+     * @returns whether the record was saved.
+     */
+    recordAgent(selection: ReviewSelection): boolean;
+    /**
+     * Retain a published comment and settle its outgoing write atomically in browser storage.
+     * @param selection - published comment's frozen code location.
+     * @param url - confirmed publication URL.
+     * @returns whether the receipt and comment were saved.
+     */
+    published(selection: ReviewSelection, url: string): boolean;
+    /**
+     * Observe queue edits and storage failures.
+     * @param listener - snapshot invalidation.
+     * @returns unsubscribe.
+     */
+    readonly subscribe: (listener: () => void) => (() => void);
+    /**
+     * Save a frozen PR comment unless a write needs reconciliation.
+     * @param selection - frozen PR comment.
+     * @returns whether it was saved.
+     */
+    add(selection: ReviewSelection): boolean;
+    /**
+     * Edit or remove a pending comment without changing its captured lines.
+     * @param index - comment position.
+     * @param body - replacement text, or null to remove.
+     * @returns whether saved.
+     */
+    edit(index: number, body: string | null): boolean;
+    /**
+     * Edit the currently pending occurrence addressed by an inline record.
+     * @param key - browser-store identity from fileComments.
+     * @param body - replacement text, or null to remove.
+     * @returns whether the occurrence still exists and the edit was saved.
+     */
+    editThread(key: number, body: string | null): boolean;
+    /**
+     * Save the summary and decision for the pending review.
+     * @param body - review summary.
+     * @param event - review decision.
+     * @returns whether saved.
+     */
+    summarize(body: string, event: ReviewQueueState['event']): boolean;
+    /**
+     * Persist the outgoing request before network dispatch.
+     * @param request - exact write.
+     * @returns whether dispatch may start.
+     */
+    begin(request: ForgeReviewRequest): boolean;
+    /**
+     * Clear the write after a known result or explicit reconciliation.
+     * @param submitted - whether a batch review was published.
+     * @param url - confirmed publication URL when retaining submitted comments.
+     * @returns whether saved.
+     */
+    finish(submitted: boolean, url?: string): boolean;
+    private keyOf;
+    private save;
+    private emit;
+}
+/**
+ * Compare review identity while allowing records from an older PR head to remain visible.
+ * @param left - recorded source.
+ * @param right - displayed source.
+ * @returns whether the sources name the same PR or local scope.
+ */
+export declare function sameReviewSource(left: ReviewSource, right: ReviewSource): boolean;
+//# sourceMappingURL=review-queue.d.ts.map

package/lib/types/client/review.d.ts

@@ -0,0 +1,56 @@
+/** Frozen line selections shared by the diff UI, composer references, and review submission. */
+import type { ForgeDiffFile } from '../types.ts';
+/** A comment on consecutive lines of one side of one displayed hunk. */
+export interface ReviewComment {
+    /** Repository-relative destination path, including for renamed files. */
+    readonly path: string;
+    /** Old or new side of the displayed diff. */
+    readonly side: 'L' | 'R';
+    /** First selected line, inclusive. */
+    readonly startLine: number;
+    /** Last selected line, inclusive. */
+    readonly endLine: number;
+    /** Complete displayed hunk captured before subsequent file changes. */
+    readonly hunk: string;
+    /** User's plain-text comment. */
+    readonly body: string;
+}
+/** The immutable source from which a comment was selected. */
+export type ReviewSource = {
+    readonly kind: 'local';
+    readonly scope: string;
+} | {
+    readonly kind: 'change';
+    readonly url: string;
+    readonly headSha: string;
+};
+/** One selected range and the source the user saw. */
+export interface ReviewSelection {
+    readonly source: ReviewSource;
+    readonly comment: ReviewComment;
+}
+/**
+ * Capture a range only when both endpoints belong to the same displayed hunk.
+ * @param file - loaded diff file.
+ * @param side - selected side.
+ * @param from - first gesture endpoint.
+ * @param to - current gesture endpoint.
+ * @returns a frozen selection, or undefined for unchanged gaps or cross-hunk ranges.
+ */
+export declare function selectReviewLines(file: ForgeDiffFile, side: 'L' | 'R', from: number, to: number): ReviewComment | undefined;
+/**
+ * Format a frozen reference for the ordinary, logged user message.
+ * @param selection - source, range, displayed patch, and user comment.
+ * @param index - one-based reference number in the composer.
+ * @returns Markdown content for an atomic composer quote.
+ */
+export declare function formatReviewComment(selection: ReviewSelection, index: number): string;
+/**
+ * Check whether the current diff still contains the captured range and hunk.
+ * @param selection - saved comment source and patch.
+ * @param source - currently displayed review source.
+ * @param file - current diff file.
+ * @returns whether an inline record can retain its original line placement.
+ */
+export declare function reviewMatches(selection: ReviewSelection, source: ReviewSource, file: ForgeDiffFile): boolean;
+//# sourceMappingURL=review.d.ts.map

package/lib/types/client/session-list.d.ts

@@ -0,0 +1,46 @@
+/** The forge facts a Session row shows, from the Session list and the change request states every row shares. */
+import type { HostObservable, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { UseSessions } from '@deepseek-ai/dsh-client-ui-session/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { SessionProjectionSummaryValues } from '@deepseek-ai/dsh-session-projection/types';
+import type { ForgeChangeRequestListState, ForgeSessionWorktree } from '../types.ts';
+import type { StreamSnapshot } from './source.ts';
+import { type ChangeRequestTone } from './status.ts';
+/** Change request states by URL as the Host streams them. */
+export type ChangeRequestStates = StreamSnapshot<ReadonlyMap<string, ForgeChangeRequestListState>>;
+/** Business face of the Session row entries: the change request states every row shares. */
+export interface SessionListInjected {
+    readonly hooks: {
+        /** States by URL; the renderer binds it as `useStates`. */
+        readonly states: HostObservable<ChangeRequestStates>;
+    };
+}
+/** One visible change request of a Session with its last polled state, when known. */
+export interface SessionListChangeRequest {
+    readonly url: string;
+    readonly state: ForgeChangeRequestListState | undefined;
+    readonly tone: ChangeRequestTone;
+}
+/** What a Session row and its hover card show. */
+export interface SessionForgeFacts {
+    /** The worktree the panel created for the Session, while the Session works in it. */
+    readonly worktree: ForgeSessionWorktree | null;
+    /** Visible change requests, most urgent first; equally urgent ones keep their binding order. */
+    readonly changeRequests: readonly SessionListChangeRequest[];
+}
+/**
+ * Derive a Session's facts from its listed projection values.
+ * @param values - the Session's projection values in the Session list, undefined before it is listed.
+ * @param states - change request states by URL.
+ * @returns the facts; a Session without a worktree or change requests shares one empty value.
+ */
+export declare function sessionForgeFacts(values: Readonly<Partial<SessionProjectionSummaryValues>> | undefined, states: ReadonlyMap<string, ForgeChangeRequestListState>): SessionForgeFacts;
+/**
+ * Read one Session's facts, recomputed only when its listed values or the shared states change.
+ * @param useSessions - selector hook over the Session list.
+ * @param useStates - selector hook over the change request states.
+ * @param sessionId - the row's Session.
+ * @returns the facts.
+ */
+export declare function useSessionForgeFacts(useSessions: UseSessions, useStates: SnapshotSelectorHook<ChangeRequestStates>, sessionId: SessionId): SessionForgeFacts;
+//# sourceMappingURL=session-list.d.ts.map