@deepseek-harness-tui/dsh-tui 0.12.0 → 0.13.0

package/lib/types/screens/Launchpad.d.ts

@@ -0,0 +1,194 @@
+import React from 'react';
+import { type LaunchpadAction } from '../components/launchpadActions.js';
+import { type ClipboardRead } from '../utils/clipboard.js';
+/** 动作入口的类型与状态驱动纯函数在 `launchpadActions.ts`（第四版拆出，表驱动回归在那边）。 */
+export type { LaunchpadAction } from '../components/launchpadActions.js';
+/**
+ * 参数行的四段身份（第五版：四段各自可点，点开 Chat 既有的选择器 overlay；
+ * 第六版设计 1：`mode` 段换成 `preset`——用户说的"模式"是 Standard/PTC/极简
+ * 那套 agent preset（channel.agentPreset + /preset 名册），不是 plan/act）。
+ */
+export type LaunchpadParamSegment = 'model' | 'effort' | 'preset' | 'permission';
+/**
+ * Launchpad —— 每次启动的第一屏（取代旧的"只有鲸鱼标题的空白会话"）。
+ *
+ * 它**不是一个新页面**：整块视觉核心仍然是 `LogoV2`（像素鲸鱼 / 女仆娘立绘、
+ * 块体 `DEEPSEEK`/`HARNESS` 大字、节日换词、求 star 彩蛋——一套代码），但走
+ * `LogoV2` 的 chrome="minimal" 极简形态并 align="center"：只有立绘与大字，
+ * 版号/模型/工作目录/启动提示/欢迎语一概不画（用户实测要求 opencode 式
+ * 留白；欢迎语曾经和落地页自己的一行重复，两处一起删）。
+ *
+ * 版面（2026-10 第三版改版）：**头部 + 输入框 + 框下成组三行**整块水平垂直
+ * 双居中，不再把提示行钉到屏幕底部、中间不留大空档：
+ *
+ *   - 输入框（圆角边框）里**只有输入那一行**；
+ *   - 紧贴框下方一行**参数行**（左对齐输入框）：`模型 · 思考深度 · 模式 · 权限`，
+ *     四段缺哪段省哪段、全空整行不画；模型段**只显示模型名**（不带 provider/
+ *     前缀）且带浅紫主题色（autoAccept）；第五版起四段**各自可点**，点开 Chat
+ *     既有的选择器（overlayPanel 盖在本屏之上，选中值就地更新这一行）；
+ *   - 隔一行呼吸留白（矮屏阶梯可撤，见 launchpadLayout）再一行**键帽按钮**
+ *     （整行右对齐，与输入框右缘对齐）；
+ *   - 再下一行 **`● Tips：`**（居中，圆点橙色 warning）。
+ *
+ * 屏幕最底的双角铭牌（左 `cwd:branch`、右版本号）保留。
+ *
+ * **输入框在这一屏是唯一有状态的部件**：用户敲进去的东西必须原样带进聊天页，
+ * 否则"第一屏输入的字"就被这一屏吞了。第六版起行首 `/` 会弹出**命令补全面板**
+ * （`commands`/`onCommandPick` 两缝，数据与组件都与聊天页 composer 同源），
+ * 面板选中直接执行命令；面板没收掉时整行仍原样交给 `onSubmit`，由 `Chat`
+ * 走它既有的命令表判定（合并命令表，含 registry 命令）再决定 runCommand 或
+ * 发送。本地只读一点：行首是不是 `/`，用来把输入框左边的提示符从 `❯` 换成
+ * `⌘`。
+ *
+ * 光标闪烁：只在输入框有焦点（`focusIndex < 0`）且终端持有焦点时跑，
+ * 约 550ms 一个相位；**相位只切换样式**（inverse ↔ inverse+dim，见
+ * `SearchBox` 的 `caretBlink` 契约），不增删任何字符——无头回归读的是
+ * 视口纯文本，闪烁对它不可见，断言不随相位抖动。
+ *
+ * 居中与降级：宽度走 `resolveSplashLayout` 那一套（与开屏同源，阈值不会漂），
+ * 高度走 `resolveLaunchpadLayout`（整块撤：Tips → 键帽行 → 立绘 → 只留输入框）。
+ *
+ * 鼠标：`onClick`/`onMouseEnter` 只在 `<AlternateScreen>` 里触发，内联模式
+ * 天然没有它们，所以每个可点目标都必须有一条键盘路径（这里全部有：焦点 +
+ * Enter）。
+ */
+export declare function Launchpad({ query, cursorOffset, focusIndex, isTerminalFocused, whale, whaleIdle, whaleGirl, fontId, starred, onStarClick, firstRun, actions, overlayPanel, inputPaused, onParamPick, model, effort, preset, permission, commands, onCommandPick, clipboardReader, 
+/** Tips 自动轮换间隔（第七版；测试缝：无头回归注入短间隔确定性驱动相位）。 */
+tipRotateMs, 
+/** 左下角工作目录铭牌被点击/回车时交给 Chat（开既有的 /workspace 工作区菜单）。 */
+onOpenWorkspace, 
+/** 内核（dsh）版本——右下角与 TUI 版本并列显示；读不到就不画内核段。 */
+kernelVersion, cwd, branch, tuiVersion, onFocusChange, onAction, onQueryChange, onSubmit, onEscape, onBlankClick, }: {
+    /** 输入框里的原文（由 Chat 持有——这一屏卸载后它还要活到聊天页）。 */
+    query: string;
+    /** 光标在 `query` 里的 UTF-16 偏移（`SearchBox` 的 `cursorOffset`）。 */
+    cursorOffset?: number;
+    /** 快捷入口的焦点行下标；`-1` 表示焦点在输入框。 */
+    focusIndex: number;
+    isTerminalFocused: boolean;
+    whale: boolean;
+    whaleIdle: boolean;
+    whaleGirl: boolean;
+    fontId?: string | undefined;
+    starred: boolean;
+    onStarClick?: () => void;
+    /** 引导还没跑过：Tips 换成首启那一句（动作表本身已由 resolveLaunchpadActions 状态驱动）。 */
+    firstRun: boolean;
+    /**
+     * 状态驱动的动作表（第四版）：`Chat` 用真实状态快照解出
+     * `resolveLaunchpadActions(state)` 再传进来——这一屏只负责画与交互，
+     * 不自己猜"下一步是什么"。恒 ≤4 条；`theme`/`lang`/`settings` 永不在表里。
+     */
+    actions: readonly LaunchpadAction[];
+    /**
+     * 盖在落地页之上的选择器面板（第五版）：Chat 把它既有的 picker overlay
+     * （/model · /effort · /plan · /permission 那套）原样传进来，本屏只负责
+     * 挂载位置——OverlayAbove 锚在输入框卡片顶边、向上展开，选择器吃键盘
+     *（见 `inputPaused`），Esc 关掉它回到落地页，选中的值就地更新参数行。
+     * 不传 = 没有选择器在开（正常落地页形态）。
+     */
+    overlayPanel?: React.ReactNode;
+    /**
+     * 选择器盖在落地页之上时为 true：本屏的 useInput 整块让位（选择器的按键
+     * 由 Chat 的 overlay 分支处理；未消费的键不许漏进草稿）。
+     */
+    inputPaused?: boolean;
+    /**
+     * 参数行四段被点击/回车时交给 Chat 的段身份（第五版）。Chat 把它映射到
+     * 既有命令（model→/model、effort→/effort、preset→/preset、permission→
+     * /permission），打开的就是聊天页同款选择器——本屏不自己造选择器。
+     */
+    onParamPick?: ((segment: LaunchpadParamSegment) => void) | undefined;
+    /**
+     * 框下参数行的四段（第三版：参数行移出输入框、紧贴框下方，左对齐输入框）：
+     * 模型（**只显示模型名**，不带 provider/ 前缀——第五版用户要求「两个都放
+     * 太长了」）、思考深度（effort）、模式（第六版设计 1：agent preset 的
+     * 显示名，如 Standard/PTC/极简——`Chat` 读 `channel.agentPreset` 那套）、
+     * 权限（permission preset 当前身份）。任一段拿不到就省掉那一段，全拿不到
+     * 就整行不画（成组行矮一行，见 `resolveLaunchpadLayout` 的 `params`）。
+     */
+    model?: string | undefined;
+    effort?: string | undefined;
+    /** 当前 agent preset 的显示名（Standard/PTC/极简…）；缺省不画那一段。 */
+    preset?: string | undefined;
+    /** 当前权限预设名（`Chat` 读 `channel.permissionPresets()` 的当前身份）；缺省不画。 */
+    permission?: string | undefined;
+    /**
+     * 命令补全面板的数据源（第六版 BUG 1）：行首 / 时 Chat 传
+     * `channel.commandCompletions(query)` 的结果进来——与聊天页 composer 的
+     * 补全**同一个来源、同一个组件**（CommandSuggestions），本屏不另造一套。
+     * 不传（或空数组）= 不画面板（孤立回归夹具的默认形态）。
+     */
+    commands?: readonly (import('../commands.js').LocalCommand & {
+        descriptionKey?: string;
+        commandLine?: string;
+    })[] | undefined;
+    /**
+     * 补全面板选中一条（Enter/Tab/点击）时交给 Chat 的**完整命令行**
+     * （如 /setup 加尾随空格）。Chat 走 runCommand 执行——与聊天页选中命令
+     * 同一条路径，绝不是 submit。
+     */
+    onCommandPick?: ((commandLine: string) => void) | undefined;
+    /**
+     * 剪贴板读取缝（测试打桩用；生产走 `utils/clipboard` 的 `readClipboard`，
+     * Chat 不传这一项）。签名与 `readClipboard` 一致。
+     */
+    clipboardReader?: () => Promise<ClipboardRead>;
+    /** Tips 自动轮换间隔（第七版；测试缝，生产用默认 10s）。 */
+    tipRotateMs?: number;
+    /** 左下角工作目录铭牌被点击/焦点环 Enter 时交给 Chat（开 /workspace 菜单）。 */
+    onOpenWorkspace?: (() => void) | undefined;
+    /** 内核（dsh）版本（contract.installedKernelVersion 的真实读数）；缺省只画 TUI 段。 */
+    kernelVersion?: string | undefined;
+    /** 双角铭牌：左下角的工作路径与分支。 */
+    cwd?: string | undefined;
+    branch?: string | undefined;
+    /** 双角铭牌：右下角的 TUI 版本号。 */
+    tuiVersion?: string | undefined;
+    onFocusChange: (index: number) => void;
+    onAction: (action: LaunchpadAction) => void;
+    /** 输入框内容变化（含光标位置）。 */
+    onQueryChange: (text: string, cursor: number) => void;
+    /** 提交：整行原文交给 Chat，由它走命令表/模型两条既有的路。 */
+    onSubmit: (text: string) => void;
+    /** 空输入时按 Esc / `Ctrl+C`：`sessions` 去看会话，`exit` 走双击退出漏斗。 */
+    onEscape: (intent: 'sessions' | 'exit') => void;
+    /** 点空白处：把焦点收回输入框（不是提交、不是关闭）。 */
+    onBlankClick: () => void;
+}): React.ReactNode;
+/** 快捷入口之间的间隔列数（与动作行 `gap={2}` 一致，预算必须同源）。 */
+export declare const CHIP_GAP = 2;
+/**
+ * 一行装得下哪几个快捷入口（第四版：纯文字标签）。
+ *
+ * @param labels - 全部标签（宽度按 `stringWidth` 算，CJK 是双宽）。
+ * @param columns - 内容区列数。
+ * @returns 保留下来的 `{ index, label }`；装不下就到此为止（绝不切半个）。
+ */
+export declare function fitChips(labels: readonly string[], columns: number): readonly {
+    index: number;
+    label: string;
+}[];
+/**
+ * 光标左移一个**码位**（不是 UTF-16 单元）。
+ *
+ * `Array.from` 迭代码位，所以退格/左移不会把一个 emoji 或代理对劈成两半
+ * ——`SearchBox` 的窗口化在同一条假设上工作（它的 `windowQuery` 专门有
+ * 一段"中途代理对回退到起点"的代码），两边必须一致，否则光标会落在半
+ * 个字符里，然后下一次按键就画出一个碎 emoji。
+ *
+ * @param text - 全文。
+ * @param at - 当前 UTF-16 偏移。
+ * @returns 左侧一个码位的偏移（已在 0 时返回 0）。
+ */
+export declare function prevBoundary(text: string, at: number): number;
+/**
+ * 光标右移一个码位。见 {@link prevBoundary}。
+ * @param text - 全文。
+ * @param at - 当前 UTF-16 偏移。
+ * @returns 右侧一个码位的偏移（到末尾时返回末长）。
+ */
+export declare function nextBoundary(text: string, at: number): number;
+/** 最小模式这一屏整体不存在（与 `LogoHeader` 同规则）：直接进会话。 */
+export declare function launchpadVisible(): boolean;
+//# sourceMappingURL=Launchpad.d.ts.map

package/lib/types/screens/Launchpad.d.ts.map

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