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

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

@@ -0,0 +1,34 @@
+/** What the panel's checkout row says about the checkout the Session works in. */
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ForgePanelState } from '../types.ts';
+import type { NS } from './locales.ts';
+type Translate = PropsLocale<typeof NS>['t'];
+/** Facts the checkout row shows. */
+export interface CheckoutLabel {
+    /** Branch name, the abbreviated commit while HEAD is detached, or null when HEAD has no commit. */
+    readonly name: string | null;
+    /** Whether HEAD is detached. */
+    readonly detached: boolean;
+    /** Kind of directory: a worktree with its base, another worktree, the project directory, or a removed worktree. */
+    readonly kind: string;
+    /** The kind with the directory path, home abbreviated to `~`. */
+    readonly tooltip: string;
+    /** Whether the worktree the Session works in is gone. */
+    readonly missing: boolean;
+    /** Full path of the directory, home not abbreviated; a removed worktree keeps the path it was created at. */
+    readonly path: string;
+    /** Whether the directory is a worktree rather than the project directory. */
+    readonly worktree: boolean;
+}
+/**
+ * Describe the checkout of a Session. A worktree this panel created names its
+ * base; any other linked worktree is a worktree, and the main checkout is the
+ * project directory. A removed worktree keeps its branch name.
+ * @param state - panel state.
+ * @param home - Host account home, or undefined to show full paths.
+ * @param t - forge panel copy.
+ * @returns the label, or undefined before a successful inspection.
+ */
+export declare function checkoutLabel(state: ForgePanelState, home: string | undefined, t: Translate): CheckoutLabel | undefined;
+export {};
+//# sourceMappingURL=checkout.d.ts.map

package/lib/types/client/diff-rows.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Drawn rows of one file diff: numbered patch lines, their side-by-side
+ * pairing, and the unchanged lines between hunks, which stay collapsed until
+ * the file's new side supplies them.
+ */
+import type { ForgeDiffFile, ForgeDiffHunk } from '../types.ts';
+/** One drawn line with its number on each side that has it. */
+export type DiffRow = {
+    readonly kind: 'add';
+    readonly old: null;
+    readonly new: number;
+    readonly text: string;
+} | {
+    readonly kind: 'del';
+    readonly old: number;
+    readonly new: null;
+    readonly text: string;
+} | {
+    readonly kind: 'context';
+    readonly old: number;
+    readonly new: number;
+    readonly text: string;
+};
+/** One side of a side-by-side row. */
+export interface SplitCell {
+    readonly kind: DiffRow['kind'];
+    readonly no: number;
+    readonly text: string;
+}
+/** One side-by-side row; a side without a line is null. */
+export interface SplitRow {
+    readonly left: SplitCell | null;
+    readonly right: SplitCell | null;
+}
+/** A run of drawn rows, or unchanged lines drawn as one row that expands them. */
+export type DiffSegment = {
+    readonly kind: 'rows';
+    readonly rows: readonly DiffRow[];
+}
+/**
+ * `index` is the hunk the lines precede, or the hunk count for the lines after the last hunk;
+ * `count` is null while the length of the file is unknown.
+ */
+ | {
+    readonly kind: 'gap';
+    readonly index: number;
+    readonly count: number | null;
+};
+/**
+ * Number the lines of a hunk. Context lines count on both sides, deletions on
+ * the old side, and additions on the new side; a ``
+ * marker is not a line.
+ * @param hunk - one hunk.
+ * @returns the rows in patch order.
+ */
+export declare function hunkRows(hunk: ForgeDiffHunk): DiffRow[];
+/**
+ * Pair rows for the side-by-side view: each run of deletions sits beside the
+ * run of additions that follows it, row by row, and context rows fill both sides.
+ * @param rows - rows in patch order.
+ * @returns the paired rows.
+ */
+export declare function splitRows(rows: readonly DiffRow[]): SplitRow[];
+/**
+ * Split file text into lines as a patch numbers them; a final line ending ends the last line.
+ * @param text - the file text.
+ * @returns the lines with any carriage returns kept.
+ */
+export declare function textLines(text: string): string[];
+/**
+ * Whether file text is the new side the hunks describe: every context and
+ * added line sits at its number. A file changed after its diff was read fails.
+ * @param lines - the file's lines.
+ * @param hunks - hunks of the file's diff.
+ * @returns whether the lines match.
+ */
+export declare function matchesHunks(lines: readonly string[], hunks: readonly ForgeDiffHunk[]): boolean;
+/**
+ * Lay out one file as runs of rows separated by collapsed unchanged lines.
+ * Unchanged lines before a hunk, between hunks, and after the last hunk
+ * collapse into one gap each; an open gap draws its lines from `lines` once
+ * they are known. The lines after the last hunk are unknown until `lines`
+ * arrives, unless the file is new, deleted, or its last hunk reaches its end.
+ * @param file - one file of a diff.
+ * @param lines - the file's new side, which {@link matchesHunks} accepted, or undefined while it has not been read.
+ * @param open - indexes of the gaps the user expanded.
+ * @returns the segments in file order.
+ */
+export declare function segmentsOf(file: ForgeDiffFile, lines: readonly string[] | undefined, open: ReadonlySet<number>): DiffSegment[];
+/**
+ * Count the rows a file's hunks draw.
+ * @param file - one file of a diff.
+ * @returns the number of context, added, and deleted lines in its hunks.
+ */
+export declare function drawnLines(file: ForgeDiffFile): number;
+//# sourceMappingURL=diff-rows.d.ts.map

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

@@ -0,0 +1,21 @@
+/** Localized durations and relative times shown on change request cards. */
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { NS } from './locales.ts';
+type Translate = PropsLocale<typeof NS>['t'];
+/**
+ * Format an elapsed time as hours and minutes, minutes and seconds, or seconds.
+ * @param ms - elapsed milliseconds.
+ * @param t - forge panel copy.
+ * @returns the localized duration.
+ */
+export declare function formatDuration(ms: number, t: Translate): string;
+/**
+ * Format how long ago an ISO 8601 time was.
+ * @param iso - the time.
+ * @param now - current epoch milliseconds.
+ * @param t - forge panel copy.
+ * @returns the localized relative time, or undefined when `iso` does not parse.
+ */
+export declare function formatAgo(iso: string, now: number, t: Translate): string | undefined;
+export {};
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1,33 @@
+/** Lifecycle glyphs of change requests and outcome glyphs of their checks. */
+import type { ReactNode } from 'react';
+import type { CheckState } from '@deepseek-ai/dsh-experimental-forge/types';
+import type { ChangeRequestTone } from './status.ts';
+/**
+ * Draw a change request in its lifecycle shape: open, open with a cross for
+ * one that needs its author, draft, merged, closed, or the open shape for an
+ * unknown state.
+ * @param props.tone - lifecycle state that picks the shape and, when tinted, the color.
+ * @param props.tinted - whether the state picks the color; otherwise the glyph uses the current text color.
+ * @param props.size - width and height in pixels, 15 by default.
+ * @param props.label - accessible name; omit it for a decorative glyph.
+ * @returns the SVG glyph.
+ */
+export declare function ChangeRequestGlyph({ tone, tinted, size, label }: {
+    readonly tone: ChangeRequestTone;
+    readonly tinted?: boolean | undefined;
+    readonly size?: number | undefined;
+    readonly label?: string | undefined;
+}): ReactNode;
+/**
+ * Draw the decorative outcome of one check beside its text: a filled circle
+ * for success or failure, a half-filled ring while it runs, and an empty ring
+ * for neutral, skipped, and cancelled checks.
+ * @param props.state - check outcome.
+ * @param props.size - width and height in pixels, 16 by default.
+ * @returns the glyph.
+ */
+export declare function CheckGlyph({ state, size }: {
+    readonly state: CheckState;
+    readonly size?: number | undefined;
+}): ReactNode;
+//# sourceMappingURL=glyphs.d.ts.map

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

@@ -0,0 +1,25 @@
+/**
+ * Browser entry of the forge panel: the sidebar tab, the changes view, the
+ * header button, the worktree option and creation card, and their Remote.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export { inject } from './mount.ts';
+export type { ForgePanelKey } from './locales.ts';
+export type { ChangeRequestActions, ChangeRequestCardProps } from './ChangeRequestCard.tsx';
+export type { ChangesParams, ChangesSource, ChangesTarget } from './changes-address.ts';
+export type { ChangesTabInjected, ChangesTabProps } from './ChangesTab.tsx';
+export type { ChangesTabTitleProps } from './ChangesTabTitle.tsx';
+export type { DiffFileAction, DiffFileProps, DiffFileText } from './DiffFile.tsx';
+export type { LocalChangesCardProps } from './LocalChangesCard.tsx';
+export type { ForgeTabInjected, ForgeTabProps } from './ForgeTab.tsx';
+export type { HeaderButtonInjected, HeaderButtonProps } from './HeaderButton.tsx';
+export type { WorktreeProgressInjected, WorktreeProgressProps } from './WorktreeProgress.tsx';
+export type { WorktreeToggleInjected, WorktreeToggleProps } from './WorktreeToggle.tsx';
+export type { ActionNotice, NoticeOptions, PanelSnapshot } from './source.ts';
+/**
+ * Mount the forge panel Remote and its UI.
+ * @param ctx - browser plugin context.
+ * @returns the disposer that withdraws the UI, then the Remote.
+ */
+export declare function apply(ctx: Context): Promise<() => Promise<void>>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,228 @@
+/** 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 '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.failedUnlisted': "检查失败";
+    readonly 'change.checks.failed': "{count} 项失败";
+    readonly 'change.checks.running': "{count} 项进行中";
+    readonly 'change.checks.passed': "{count} 项通过";
+    readonly 'change.checks.other': "其他 {count} 项";
+    readonly 'change.checks.truncated': "只列出前 {count} 项";
+    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.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.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.not-git': "工作区不是 Git 仓库，无法使用工作树";
+    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 '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/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

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

@@ -0,0 +1,146 @@
+/**
+ * Host stream sources (per-Session panel states and the change request states
+ * of the Session list), the store behind action notices, and the tab visibility store.
+ */
+import type { HostObservable } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ForgeChangeRequestListState, ForgeChangeRequestStatesFrame, ForgePanelState } from '../types.ts';
+import type { ForgePanelKey } from './locales.ts';
+/** What a stream source publishes: the value its frames built, and whether the stream ended while read. */
+export interface StreamSnapshot<S> {
+    /** Value built from the frames so far. */
+    readonly state: S;
+    /** Whether the stream ended while surfaces still read it. */
+    readonly disconnected: boolean;
+}
+/** What the panel surfaces of one Session read; `state` is null before the first one arrives. */
+export type PanelSnapshot = StreamSnapshot<ForgePanelState | null>;
+/** One open Host stream. */
+export interface HostStream<F> extends AsyncIterable<F> {
+    /** Close the stream. */
+    dispose: () => void;
+}
+/** One open stream of panel states. */
+export type PanelStream = HostStream<ForgePanelState>;
+/** Stream opener and connection-reset subscription of a source. */
+export interface StreamSourceDeps<F> {
+    /**
+     * Open the Host stream.
+     * @param signal - aborts the stream.
+     * @returns the stream.
+     */
+    readonly open: (signal: AbortSignal) => HostStream<F>;
+    /**
+     * Subscribe to transport resets, after which an open stream no longer delivers.
+     * @param listener - called on each reset.
+     * @returns the unsubscribe function.
+     */
+    readonly subscribeReset: (listener: () => void) => () => void;
+}
+/** Stream opener and connection-reset subscription of one Session's panel source. */
+export type PanelSourceDeps = StreamSourceDeps<ForgePanelState>;
+/** A value built from a Host stream that runs only while a surface subscribes. */
+export interface StreamSource<S> {
+    /** Snapshot observable; the renderer binds it as a selector hook. */
+    readonly observable: HostObservable<StreamSnapshot<S>>;
+    /** Open the stream again after it ended; a no-op while it runs or nobody subscribes. */
+    readonly reconnect: () => void;
+    /** Close the stream and the reset subscription and drop every subscriber. */
+    readonly close: () => void;
+}
+/** Panel state of one Session, streamed only while a surface subscribes. */
+export interface PanelSource {
+    /** Snapshot observable; the renderer binds it as `usePanel`. */
+    readonly hooks: {
+        readonly panel: HostObservable<PanelSnapshot>;
+    };
+    /** Open the stream again after it ended; a no-op while it runs or nobody subscribes. */
+    readonly reconnect: () => void;
+    /** Close the stream and the reset subscription and drop every subscriber. */
+    readonly close: () => void;
+}
+/**
+ * Create a source that folds a Host stream into one value. The first
+ * subscriber opens the stream and the last one closes it; the value stays
+ * readable for the next subscriber. A stream that ends or fails while
+ * subscribed marks the snapshot disconnected until `reconnect` or a transport
+ * reset reopens it.
+ * @param deps - stream opener and reset subscription.
+ * @param initial - value before the first frame.
+ * @param fold - the value after one frame.
+ * @returns the source.
+ */
+export declare function createStreamSource<F, S>(deps: StreamSourceDeps<F>, initial: S, fold: (state: S, frame: F) => S): StreamSource<S>;
+/**
+ * Create the panel source of one Session: the latest state the Host streamed.
+ * @param deps - stream opener and reset subscription.
+ * @returns the source.
+ */
+export declare function createPanelSource(deps: PanelSourceDeps): PanelSource;
+/**
+ * The known change request states after one `changeRequestStates` frame: a
+ * baseline replaces them, and a change replaces the states it carries.
+ * @param states - states by URL before the frame.
+ * @param frame - the frame.
+ * @returns states by URL after the frame.
+ */
+export declare function foldStates(states: ReadonlyMap<string, ForgeChangeRequestListState>, frame: ForgeChangeRequestStatesFrame): ReadonlyMap<string, ForgeChangeRequestListState>;
+/** One action notice; `seq` keys the toast so a repeated notice restarts it. */
+export interface ActionNotice {
+    /** Dictionary key of the notice text. */
+    readonly key: ForgePanelKey;
+    /** Values interpolated into the text. */
+    readonly params: Readonly<Record<string, string | number>>;
+    /** `success` reports a completed action; `failure` a refused or failed one. */
+    readonly tone: 'success' | 'failure';
+    /** Reverts the reported action, or undefined when it cannot be undone. */
+    readonly undo: (() => void) | undefined;
+    /** Increasing report number. */
+    readonly seq: number;
+}
+/** Optional parts of a reported notice. */
+export interface NoticeOptions {
+    /** Values interpolated into the text. */
+    readonly params?: Readonly<Record<string, string | number>>;
+    /** Defaults to `failure`. */
+    readonly tone?: ActionNotice['tone'];
+    /** Reverts the reported action. */
+    readonly undo?: () => void;
+}
+/** Store that action wiring reports into and one `shell.overlay` entry reads. */
+export interface NoticeSource {
+    /** Current notice, or null while none shows; the renderer binds it as `useNotice`. */
+    readonly hooks: {
+        readonly notice: HostObservable<ActionNotice | null>;
+    };
+    /**
+     * Show one notice, replacing the shown one.
+     * @param key - dictionary key of the text.
+     * @param options - interpolated values, tone, and undo action.
+     */
+    readonly report: (key: ForgePanelKey, options?: NoticeOptions) => void;
+    /** Clear the shown notice. */
+    readonly dismiss: () => void;
+}
+/**
+ * Create the action notice store.
+ * @returns the store.
+ */
+export declare function createNoticeSource(): NoticeSource;
+/** Whether one Session's forge tab is visible; the header entry reads it for its pressed state. */
+export interface VisibilitySource {
+    /** Current visibility; the renderer binds it as `useVisible`. */
+    readonly hooks: {
+        readonly visible: HostObservable<boolean>;
+    };
+    /**
+     * Record the tab's visibility.
+     * @param visible - whether the tab is visible.
+     */
+    readonly set: (visible: boolean) => void;
+}
+/**
+ * Create the visibility store of one Session's forge tab, initially hidden.
+ * @returns the store.
+ */
+export declare function createVisibilitySource(): VisibilitySource;
+//# sourceMappingURL=source.d.ts.map