@askdkc/dsh-cli 0.11.3

package/lib/types/components/MigratePicker.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+import type { MigratePickerRow } from '../dsh-adapter/migrate/picker.js';
+/**
+ * `/migrate` source picker (multi-select, PRD revision): each row shows a
+ * checkbox, the scannable file count, and a recent-activity badge. Keys
+ * (Chat owns the logic): space toggles the focused source, `a` selects
+ * all/none, Enter proceeds to the confirmation layer with the checked set
+ * (the focused row when nothing is checked), Esc closes. While the rows are
+ * still being collected it says so — the scan takes a moment on real stores
+ * and "no sources available" would be a lie in that window.
+ */
+export declare function MigratePicker({ rows, focusIndex, checked, loading, onPick, }: {
+    rows: readonly MigratePickerRow[];
+    focusIndex: number;
+    /** Checked agent ids (multi-select state lives in Chat). */
+    checked: ReadonlySet<string>;
+    /** Rows still loading: render the scanning line, not the empty state. */
+    loading?: boolean;
+    /** Mouse pick (fullscreen): toggle the clicked row's checked state. */
+    onPick?: (index: number) => void;
+}): React.ReactNode;
+/**
+ * The second confirmation layer (PRD #2): one line per checked source with
+ * its scannable count and the repeat-safe note. Keys (Chat): Enter imports,
+ * `d` dry-runs, Esc returns to the picker with the checked set preserved.
+ */
+export declare function MigrateConfirm({ rows, }: {
+    rows: readonly MigratePickerRow[];
+}): React.ReactNode;
+//# sourceMappingURL=MigratePicker.d.ts.map

package/lib/types/components/MigratePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigratePicker.d.ts","sourceRoot":"","sources":["../../../src/components/MigratePicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAQzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAExE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,UAAU,EACV,OAAO,EACP,OAAe,EACf,MAAM,GACP,EAAE;IACD,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAA;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC5B,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uEAAuE;IACvE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,GAAG,KAAK,CAAC,SAAS,CA+ClB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,GACL,EAAE;IACD,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAClC,GAAG,KAAK,CAAC,SAAS,CAyBlB"}

package/lib/types/components/MigratePicker.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { t } from '../i18n.js';
+import { Box, Text } from '../ui.js';
+import { Pane } from './design-system/Pane.js';
+import { ListItem } from './design-system/ListItem.js';
+import { HintLine } from './design-system/HintLine.js';
+import { listWindow } from './listWindow.js';
+import { useOverlayListRows } from './OverlayAbove.js';
+/**
+ * `/migrate` source picker (multi-select, PRD revision): each row shows a
+ * checkbox, the scannable file count, and a recent-activity badge. Keys
+ * (Chat owns the logic): space toggles the focused source, `a` selects
+ * all/none, Enter proceeds to the confirmation layer with the checked set
+ * (the focused row when nothing is checked), Esc closes. While the rows are
+ * still being collected it says so — the scan takes a moment on real stores
+ * and "no sources available" would be a lie in that window.
+ */
+export function MigratePicker({ rows, focusIndex, checked, loading = false, onPick, }) {
+    // 每项恒占 2 行（主行 + 描述行），预算同 SkillsPicker（OverlayAbove 高度
+    // 减 Pane 2 + 标题 2 + 页脚 1 + marginTop 1 = 6）。
+    const listRows = useOverlayListRows(6);
+    const { start, end } = listWindow(rows.map(() => 2), focusIndex, listRows);
+    return (_jsxs(Pane, { color: "permission", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: t('picker-title-migrate') }) }), loading ? (_jsx(Text, { dimColor: true, children: t('migrate-picker-scanning') })) : rows.length === 0 ? (_jsx(Text, { dimColor: true, children: t('migrate-picker-empty') })) : (rows.slice(start, end).map((row, index) => {
+                        const absoluteIndex = start + index;
+                        const description = row.minutesAgo !== undefined
+                            ? t('migrate-picker-recent', { minutes: row.minutesAgo })
+                            : t('migrate-picker-cold');
+                        return (_jsx(ListItem, { isFocused: absoluteIndex === focusIndex, description: description, showScrollUp: absoluteIndex === start && start > 0, showScrollDown: absoluteIndex === end - 1 && end < rows.length, onClick: onPick ? () => onPick(absoluteIndex) : undefined, children: `${checked.has(row.agentId) ? '[x]' : '[ ]'} ${row.label} · ${t('migrate-picker-count', { n: row.count })}` }, row.agentId));
+                    }))] }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('migrate-picker-hint') }) })] }));
+}
+/**
+ * The second confirmation layer (PRD #2): one line per checked source with
+ * its scannable count and the repeat-safe note. Keys (Chat): Enter imports,
+ * `d` dry-runs, Esc returns to the picker with the checked set preserved.
+ */
+export function MigrateConfirm({ rows, }) {
+    return (_jsxs(Pane, { color: "permission", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: t('migrate-confirm-title') }) }), rows.map(row => (_jsx(Box, { paddingLeft: 1, children: _jsx(Text, { children: t('migrate-confirm-line', { label: row.label, n: row.count }) }) }, row.agentId))), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: t('migrate-confirm-note') }) })] }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('migrate-confirm-actions') }) })] }));
+}

package/lib/types/components/ModelPicker.d.ts

@@ -0,0 +1,42 @@
+import React from 'react';
+import type { LlmModelInfo } from '../adapter/ports/channel-view.js';
+import type { ModelGroupRow } from '../modelGroups.js';
+/**
+ * Model picker: a permission-colored Pane with
+ * the rows as Select entries (❯ focus pointer, ✓ on the active row,
+ * descriptions), plus the Enter/Esc hint line. The DSH agent's model is
+ * fixed at creation time, so a selection notifies "restart to apply".
+ *
+ * Two levels: the top level lists **provider groups** (registry display
+ * name + model count, ✓ on the current provider's row) and drills in with
+ * Enter; the second level lists that group's models and switches with
+ * Enter — the same live-fork path the flat picker always had. A
+ * single-group catalog skips the top level entirely (showBack=false, plain
+ * confirm/exit hint), so single-provider setups keep the pre-grouping UX.
+ *
+ * 长列表按焦点窗口化（Select 同款）：picker 经 OverlayAbove 浮层挂载后有
+ * maxHeight 裁剪，全量渲染会让焦点行被裁掉（看不到焦点按 Enter）。
+ */
+export declare function ModelPicker(props: {
+    /** Top level: provider groups; Enter/click drills into one. */
+    groups: readonly ModelGroupRow[];
+    focusIndex: number;
+    /** Current route key — its group row carries the ✓ marker. */
+    currentProvider: string;
+    onPick?: (index: number) => void;
+} | {
+    /** Second level (or single-group fast path): one provider's models —
+     *  or the mixed-provider recents list (`showProviderPrefix`). */
+    models: readonly LlmModelInfo[];
+    /** The group's display label as this pane's title (default: "Model"). */
+    groupLabel?: string;
+    /** Multi-group catalogs show the back hint; the fast path keeps the plain one. */
+    showBack: boolean;
+    /** Prefix each row with its provider (the recents group mixes providers). */
+    showProviderPrefix?: boolean;
+    focusIndex: number;
+    /** `provider/model` of the current model — its row carries the ✓ marker. */
+    currentModel: string;
+    onPick?: (index: number) => void;
+}): React.ReactNode;
+//# sourceMappingURL=ModelPicker.d.ts.map

package/lib/types/components/ModelPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelPicker.d.ts","sourceRoot":"","sources":["../../../src/components/ModelPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAQtD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAC7B;IACA,+DAA+D;IAC/D,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,GACC;IACA;qEACiE;IACjE,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;IAC/B,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,GAAG,KAAK,CAAC,SAAS,CA+DpB"}

package/lib/types/components/ModelPicker.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { t } from '../i18n.js';
+import { Box, Text } from '../ui.js';
+import { RECENTS_GROUP_PROVIDER, RECENTS_LABEL_PLACEHOLDER } from '../modelGroups.js';
+import { Pane } from './design-system/Pane.js';
+import { ListItem } from './design-system/ListItem.js';
+import { HintLine } from './design-system/HintLine.js';
+import { listWindow } from './listWindow.js';
+import { useOverlayListRows } from './OverlayAbove.js';
+/**
+ * Model picker: a permission-colored Pane with
+ * the rows as Select entries (❯ focus pointer, ✓ on the active row,
+ * descriptions), plus the Enter/Esc hint line. The DSH agent's model is
+ * fixed at creation time, so a selection notifies "restart to apply".
+ *
+ * Two levels: the top level lists **provider groups** (registry display
+ * name + model count, ✓ on the current provider's row) and drills in with
+ * Enter; the second level lists that group's models and switches with
+ * Enter — the same live-fork path the flat picker always had. A
+ * single-group catalog skips the top level entirely (showBack=false, plain
+ * confirm/exit hint), so single-provider setups keep the pre-grouping UX.
+ *
+ * 长列表按焦点窗口化（Select 同款）：picker 经 OverlayAbove 浮层挂载后有
+ * maxHeight 裁剪，全量渲染会让焦点行被裁掉（看不到焦点按 Enter）。
+ */
+export function ModelPicker(props) {
+    const inGroups = 'groups' in props;
+    // Captured before the map: union narrowing does not survive into closures.
+    const onPick = props.onPick;
+    // 焦点窗口化按行预算：ListItem 带 description 时占 2 行（正文+描述，均
+    // truncate 成单行），只数项数会把焦点裁出浮层（二次审查实证）。
+    // 预算来自最近一层 OverlayAbove 的有效高度（已钳到输入簇上方的真实空间——
+    // 按 terminalRows 预算在短会话 + 高终端下窗口高过浮层、顶部整行被裁、
+    // 焦点行不可见，#493/#698），减去本面板框架行：Pane 2 + 标题 2 + 页脚 1
+    // + 挂载包裹 marginTop 1 = 6。
+    const rowHeights = inGroups
+        ? props.groups.map(() => 2)
+        : props.models.map(m => (m.description ? 2 : 1));
+    const rows = inGroups ? props.groups : props.models;
+    const listRows = useOverlayListRows(6);
+    const { start, end } = listWindow(rowHeights, props.focusIndex, listRows);
+    const hint = inGroups
+        ? t('hint-model-groups')
+        : props.showBack ? t('hint-model-back') : t('hint-confirm-exit');
+    return (_jsxs(Pane, { color: "permission", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: inGroups || props.groupLabel === undefined ? t('picker-title-model') : props.groupLabel }) }), rows.slice(start, end).map((row, index) => {
+                        const absoluteIndex = start + index;
+                        return inGroups ? (_jsx(ListItem, { isFocused: absoluteIndex === props.focusIndex, isSelected: row.provider === props.currentProvider, description: t('picker-group-count', { count: row.count }), showScrollUp: absoluteIndex === start && start > 0, showScrollDown: absoluteIndex === end - 1 && end < rows.length, onClick: onPick ? () => onPick(absoluteIndex) : undefined, children: row.label === RECENTS_LABEL_PLACEHOLDER && row.provider === RECENTS_GROUP_PROVIDER
+                                ? t('picker-group-recent')
+                                : row.label }, row.provider)) : (_jsx(ListItem, { isFocused: absoluteIndex === props.focusIndex, isSelected: `${row.provider}/${row.id}` === props.currentModel, description: row.description, showScrollUp: absoluteIndex === start && start > 0, showScrollDown: absoluteIndex === end - 1 && end < rows.length, onClick: onPick ? () => onPick(absoluteIndex) : undefined, children: props.showProviderPrefix === true ? `${row.provider} / ${row.name}` : row.name }, `${row.provider}/${row.id}`));
+                    })] }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: hint }) })] }));
+}

package/lib/types/components/OverlayAbove.d.ts

@@ -0,0 +1,48 @@
+import React from 'react';
+/**
+ * 浮层内列表可用的行数：最近一层 OverlayAbove 的有效高度减去面板自身的
+ * 框架行（Pane 边框、标题、页脚、挂载包裹的 margin）。
+ *
+ * 以前各 picker 按 `terminalRows - N` 预算，假设锚点上方有整屏空间；短会话
+ * + 高终端下浮层被锚点上方的空间钳住，窗口却仍按整屏切，焦点行落在被裁
+ * 区（#493/#698）。预算从浮层拿，窗口永远装得进浮层。
+ *
+ * @param frameRows - 面板框架占用的行数（不含列表项）。
+ * @returns 列表区可用行数（≥2，listWindow 至少放得下焦点项及一个邻居）。
+ */
+export declare function useOverlayListRows(frameRows: number): number;
+/**
+ * 瞬态面板的浮层容器：absolute 定位 + bottom:'100%' 把面板底边钉在锚点
+ * （父元素）顶边，向上覆盖转录尾部行，自身**不占布局高度**。
+ *
+ * 为什么必须这样：inline 模式下整帧是内容高度。瞬态面板（picker/补全/
+ * 对话框）若以 in-flow 方式挂载，帧高随之增长——终端滚动把帧顶行（splash、
+ * 历史）推进 scrollback；面板关闭时的收缩重绘又把这些行重新写回视口，同一
+ * 行在 scrollback 和视口各存一份（"每切一次 /model 多一份启动画"的真机报
+ * 告）。浮层只改写既有行的单元格内容（帧高不变、零滚动、零沉积），关闭时
+ * 原样写回，全程无重复。
+ *
+ * 先例：PromptInput 通知行（position=absolute marginTop={-1}）。
+ *
+ * 高度契约：渲染器对探出帧顶（y<0）的行只裁不移（render-node-to-output.ts
+ * 刻意不把浮层下移压住 composer），所以本容器负责把 maxHeight 钳到锚点
+ * 上方真正可画的行数：每次 commit 后沿祖先累加 yoga computedTop 得到锚点
+ * 在帧内的绝对 top（inline 溢出时再减掉滚进 scrollback 的帧顶），与声明的
+ * maxHeight 取小。量到的是上一帧的布局——浮层零高度不改变锚点位置，转录
+ * 涨落至多晚一帧收敛；layout effect 里的 setState 在推迟到 microtask 的
+ * onRender 之前落地，不多画一帧。有效高度经 useOverlayListRows 交给面板做
+ * 焦点窗口化，窗口永远装得进浮层。
+ *
+ * 锚点纪律（防止浮层漂到 todo 上方的回归）：底部 chrome 里，凡是瞬态面板
+ * 必须挂载在「输入簇」内——Chat 输入簇（可替换输入行链 + StatusLine +
+ * 本浮层，见 Chat.tsx 底部 chrome），或 PromptInput 自身的输入行容器。绝不
+ * 直接把 OverlayAbove 挂到包含 GoalTodoPanel 的外层 chrome Box 上：那里的
+ * bottom:'100%' 会把面板顶到 todo 之上，远离输入框。in-flow 面板（问卷/
+ * 对话框/提示等）走输入簇的替换链，天然落在输入行位置，同样不会越过 todo。
+ */
+export declare function OverlayAbove({ children, maxHeight, }: {
+    children: React.ReactNode;
+    /** 调用方声明的上限；实际还会被钳到锚点上方的可画行数。 */
+    maxHeight?: number | undefined;
+}): React.ReactNode;
+//# sourceMappingURL=OverlayAbove.d.ts.map

package/lib/types/components/OverlayAbove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayAbove.d.ts","sourceRoot":"","sources":["../../../src/components/OverlayAbove.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAezB;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B,GAAG,KAAK,CAAC,SAAS,CA2DlB"}

package/lib/types/components/OverlayAbove.js

@@ -0,0 +1,98 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { Box, useApp, useTerminalSize } from '../ui.js';
+import { clampOverlayHeight, overlaySpaceAbove } from './overlayBudget.js';
+/** 最近一层 OverlayAbove 的有效 maxHeight（已钳到锚点上方的真实空间）。 */
+const OverlayBudgetContext = React.createContext(undefined);
+/**
+ * Chat 输入簇浮层为 prompt/statusline 预留的行数（Chat.tsx 传入的
+ * `terminalRows - 8`）——组件不在任何 OverlayAbove 内（裸挂载的回归脚本）
+ * 时的兜底基数，保持与旧的 `terminalRows - 14` 一类算式同值。
+ */
+const OVERLAY_RESERVED_ROWS = 8;
+/**
+ * 浮层内列表可用的行数：最近一层 OverlayAbove 的有效高度减去面板自身的
+ * 框架行（Pane 边框、标题、页脚、挂载包裹的 margin）。
+ *
+ * 以前各 picker 按 `terminalRows - N` 预算，假设锚点上方有整屏空间；短会话
+ * + 高终端下浮层被锚点上方的空间钳住，窗口却仍按整屏切，焦点行落在被裁
+ * 区（#493/#698）。预算从浮层拿，窗口永远装得进浮层。
+ *
+ * @param frameRows - 面板框架占用的行数（不含列表项）。
+ * @returns 列表区可用行数（≥2，listWindow 至少放得下焦点项及一个邻居）。
+ */
+export function useOverlayListRows(frameRows) {
+    const budget = React.useContext(OverlayBudgetContext);
+    const { rows } = useTerminalSize();
+    const base = budget ?? rows - OVERLAY_RESERVED_ROWS;
+    return Math.max(base - frameRows, 2);
+}
+/**
+ * 瞬态面板的浮层容器：absolute 定位 + bottom:'100%' 把面板底边钉在锚点
+ * （父元素）顶边，向上覆盖转录尾部行，自身**不占布局高度**。
+ *
+ * 为什么必须这样：inline 模式下整帧是内容高度。瞬态面板（picker/补全/
+ * 对话框）若以 in-flow 方式挂载，帧高随之增长——终端滚动把帧顶行（splash、
+ * 历史）推进 scrollback；面板关闭时的收缩重绘又把这些行重新写回视口，同一
+ * 行在 scrollback 和视口各存一份（"每切一次 /model 多一份启动画"的真机报
+ * 告）。浮层只改写既有行的单元格内容（帧高不变、零滚动、零沉积），关闭时
+ * 原样写回，全程无重复。
+ *
+ * 先例：PromptInput 通知行（position=absolute marginTop={-1}）。
+ *
+ * 高度契约：渲染器对探出帧顶（y<0）的行只裁不移（render-node-to-output.ts
+ * 刻意不把浮层下移压住 composer），所以本容器负责把 maxHeight 钳到锚点
+ * 上方真正可画的行数：每次 commit 后沿祖先累加 yoga computedTop 得到锚点
+ * 在帧内的绝对 top（inline 溢出时再减掉滚进 scrollback 的帧顶），与声明的
+ * maxHeight 取小。量到的是上一帧的布局——浮层零高度不改变锚点位置，转录
+ * 涨落至多晚一帧收敛；layout effect 里的 setState 在推迟到 microtask 的
+ * onRender 之前落地，不多画一帧。有效高度经 useOverlayListRows 交给面板做
+ * 焦点窗口化，窗口永远装得进浮层。
+ *
+ * 锚点纪律（防止浮层漂到 todo 上方的回归）：底部 chrome 里，凡是瞬态面板
+ * 必须挂载在「输入簇」内——Chat 输入簇（可替换输入行链 + StatusLine +
+ * 本浮层，见 Chat.tsx 底部 chrome），或 PromptInput 自身的输入行容器。绝不
+ * 直接把 OverlayAbove 挂到包含 GoalTodoPanel 的外层 chrome Box 上：那里的
+ * bottom:'100%' 会把面板顶到 todo 之上，远离输入框。in-flow 面板（问卷/
+ * 对话框/提示等）走输入簇的替换链，天然落在输入行位置，同样不会越过 todo。
+ */
+export function OverlayAbove({ children, maxHeight, }) {
+    const ref = React.useRef(null);
+    const terminal = useTerminalSize();
+    const { stdout } = useApp();
+    const [spaceAbove, setSpaceAbove] = React.useState(undefined);
+    // 每次 commit 重量：锚点位置随转录涨落、底部 chrome 行增减而变，不只是
+    // resize。等值 setState 是 no-op，自然收敛。
+    React.useLayoutEffect(() => {
+        const anchor = ref.current?.parentNode;
+        if (!anchor)
+            return;
+        let anchorTop = 0;
+        let rootHeight = 0;
+        for (let ancestor = anchor; ancestor; ancestor = ancestor.parentNode) {
+            anchorTop += ancestor.yogaNode?.getComputedTop() ?? 0;
+            rootHeight = ancestor.yogaNode?.getComputedHeight() ?? rootHeight;
+        }
+        // 还没有过一次布局（整树首帧）：沿用声明上限，下一次 commit 再量。
+        if (rootHeight <= 0)
+            return;
+        const next = overlaySpaceAbove({
+            anchorTop,
+            rootHeight,
+            terminalRows: stdout.rows ?? terminal.rows,
+        });
+        setSpaceAbove(previous => (previous === next ? previous : next));
+    });
+    const effectiveMaxHeight = clampOverlayHeight(maxHeight, spaceAbove);
+    return (_jsx(Box, { ref: ref, position: "absolute", bottom: "100%", left: 0, right: 0, flexDirection: "column", justifyContent: "flex-end", overflow: "hidden", 
+        // Kitty graphics below text still show through terminal-default
+        // background cells, and a real surface color is the only way to make
+        // the negative-z placement obey this overlay's visual bounds without
+        // deleting it. But a PERMANENT surface paints every transient panel
+        // (/ menu、picker、对话框) a bright full-width block that reads as a
+        // spurious highlight (a regression introduced by 49f7166).
+        // occlusionColor keeps the overlay terminal-transparent in the
+        // common frame and only paints the surface while an image actually
+        // sits behind this rect — see Styles.occlusionColor.
+        occlusionColor: "toolCardBackground", opaque: true, ...(effectiveMaxHeight === undefined ? {} : { maxHeight: effectiveMaxHeight }), children: _jsx(Box, { flexDirection: "column", flexShrink: 0, children: _jsx(OverlayBudgetContext.Provider, { value: effectiveMaxHeight, children: children }) }) }));
+}

package/lib/types/components/PageMargin.d.ts

@@ -0,0 +1,58 @@
+import React from 'react';
+/**
+ * 整页边距（页边距 / page margin）：有些终端（Windows Terminal 的
+ * PowerShell 等 profile 默认 8px padding、GUI 终端）自带内缩，另一些
+ * （裸 WSL、tmux、SSH、部分嵌入宿主）完全没有——文字直接贴着屏幕四边，
+ * 观感压抑。TUI 无法读取终端的 padding，所以在根布局自备一层小"页边距"。
+ * 设置（`dsh-tui.pageMargin`）可以是预设名 none / slim / normal（默认，
+ * 左右 2 列、上下 1 行）/ roomy，或自定义 `NxM`（左右各 N 列 × 上下各 M
+ * 行，如 3x1）——解析与几何见 tuiDisplayPrefs。
+ *
+ * 实现策略（三层）：
+ *
+ * 1. 布局层：`PageMargin` 渲染一个 `paddingX/Y` 的根盒，所有屏幕
+ *    （Chat 及其中所有 early-return 屏幕）自动内缩；
+ * 2. 尺寸层：嵌套覆盖 `TerminalSizeContext`，向内报告的 columns/rows
+ *    已扣除边距，因此所有用 `useTerminalSize()` 做内容宽度/高度数学的
+ *    组件（换行宽度、虚拟化、输入区预算、表格布局……）无需各自知道
+ *    边距存在——它们拿到的就是内容区尺寸；
+ * 3. 坐标层：`PageInsetContext` 报告内容区相对屏幕原点的偏移，供少数
+ *    以「屏幕坐标」做 absolute 定位的浮层（Tooltip、会话列表
+ *    右键菜单）补偿——它们的锚点来自指针事件（屏幕坐标），而 absolute
+ *    盒子相对的是内缩后的内容区原点。
+ *
+ * 模式来源是 tuiDisplayPrefs 的模块级 store（applyPageMargin），不是
+ * props：`.PageMargin` 位于 Chat 之上，/settings 的更改如果只走 channel
+ * 的版本 bump 无法驱动它（那只重渲染 Chat 以下）。store 由 plugin 的
+ * applyDisplay 镜像写入，模式变化时本组件重渲染并重布局。
+ *
+ * 注意：`PageMargin` 必须在「所有以屏幕原点为参照的组件之外」读取
+ * TerminalSizeContext（它读到的就是真实终端尺寸）；AlternateScreen 等
+ * 需要真实 rows 的组件放在它的外侧。verify 脚本直接挂载
+ * `<AlternateScreen><Chat/></AlternateScreen>`（不经 plugin.ts 的树），
+ * 因此测试默认无页边距——组件契约仍是「全宽可用」。
+ */
+/** 内容区相对屏幕原点的偏移（屏幕坐标 → 内容坐标的换算量）。 */
+export type PageInset = {
+    readonly x: number;
+    readonly y: number;
+};
+/** 嵌套安全的 inset（若未来出现嵌套 PageMargin 会累加）。 */
+export declare const PageInsetContext: React.Context<PageInset>;
+/**
+ * 内容区相对屏幕原点的偏移。供"出血"（full-bleed）chrome 使用：页面级
+ * 分割线、右侧滚动轨这类结构性元素直通终端边缘，而内容（文本、卡片）
+ * 保持页边距内缩——常规排版设计的做法（内容列留边距、横线/滚动轨出血
+ * 到版面边缘）。无 PageMargin 时恒为 {x:0, y:0}。
+ */
+export declare function usePageInset(): PageInset;
+/**
+ * 根级页边距容器：给整棵 UI 加一圈可配置的小边距，并把「终端尺寸」收敛
+ * 成「内容区尺寸」下传（见文件头三层策略）。flexGrow={1} 让它撑满
+ * AlternateScreen 的定高盒（inline 无定高父级时为内容自然高，与现状
+ * 一致）。
+ */
+export declare function PageMargin({ children, }: {
+    children: React.ReactNode;
+}): React.ReactNode;
+//# sourceMappingURL=PageMargin.d.ts.map

package/lib/types/components/PageMargin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageMargin.d.ts","sourceRoot":"","sources":["../../../src/components/PageMargin.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAczB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,qCAAqC;AACrC,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAElE,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,0BAAiD,CAAA;AAE9E;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,GAAG,KAAK,CAAC,SAAS,CAqClB"}

package/lib/types/components/PageMargin.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { Box } from '../ui.js';
+import { TerminalSizeContext, } from '../ink/components/TerminalSizeContext.js';
+import { useTerminalSize } from '../ink/hooks/use-terminal-size.js';
+import { getPageMarginSetting, resolvePageMargin, subscribePageMargin, } from '../tuiDisplayPrefs.js';
+/** 嵌套安全的 inset（若未来出现嵌套 PageMargin 会累加）。 */
+export const PageInsetContext = React.createContext({ x: 0, y: 0 });
+/**
+ * 内容区相对屏幕原点的偏移。供"出血"（full-bleed）chrome 使用：页面级
+ * 分割线、右侧滚动轨这类结构性元素直通终端边缘，而内容（文本、卡片）
+ * 保持页边距内缩——常规排版设计的做法（内容列留边距、横线/滚动轨出血
+ * 到版面边缘）。无 PageMargin 时恒为 {x:0, y:0}。
+ */
+export function usePageInset() {
+    return React.useContext(PageInsetContext);
+}
+/**
+ * 根级页边距容器：给整棵 UI 加一圈可配置的小边距，并把「终端尺寸」收敛
+ * 成「内容区尺寸」下传（见文件头三层策略）。flexGrow={1} 让它撑满
+ * AlternateScreen 的定高盒（inline 无定高父级时为内容自然高，与现状
+ * 一致）。
+ */
+export function PageMargin({ children, }) {
+    const setting = React.useSyncExternalStore(subscribePageMargin, getPageMarginSetting);
+    const { x, y } = resolvePageMargin(setting);
+    const size = useTerminalSize();
+    const parentInset = React.useContext(PageInsetContext);
+    const inner = {
+        columns: Math.max(1, size.columns - 2 * x),
+        rows: Math.max(1, size.rows - 2 * y),
+    };
+    const inset = {
+        x: parentInset.x + x,
+        y: parentInset.y + y,
+    };
+    return (_jsx(PageInsetContext.Provider, { value: inset, children: _jsx(TerminalSizeContext.Provider, { value: inner, children: _jsx(Box, { flexDirection: "column", flexGrow: 1, width: "100%", paddingX: x, paddingY: y, children: _jsx(Box, { flexDirection: "column", flexGrow: 1, width: inner.columns, children: children }) }) }) }));
+}

package/lib/types/components/PermissionsPicker.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { PermissionPresetOption } from '../dsh-adapter/channel.js';
+/**
+ * `/permission` sandbox-preset picker. The command itself is registered by
+ * the harness side (dsh-sandbox-policy / dsh-base permission-presets row);
+ * bare `/permission` opens this picker and Enter dispatches
+ * `/permission <preset>` through the same external-command path a hand-typed
+ * argument takes. The roster comes from the adapter snapshot so host plugins
+ * can contribute additional preset identities without UI changes.
+ */
+export declare function PermissionsPicker({ options, focusIndex, currentValue, cwd, onPick, }: {
+    options: readonly PermissionPresetOption[];
+    focusIndex: number;
+    currentValue: string | undefined;
+    cwd: string;
+    /** Mouse pick (fullscreen): clicked row's absolute index (Chat applies
+     *  the same code path as the keyboard Enter). */
+    onPick?: (index: number) => void;
+}): React.ReactNode;
+//# sourceMappingURL=PermissionsPicker.d.ts.map

package/lib/types/components/PermissionsPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionsPicker.d.ts","sourceRoot":"","sources":["../../../src/components/PermissionsPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAEvE;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,UAAU,EACV,YAAY,EACZ,GAAG,EACH,MAAM,GACP,EAAE;IACD,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAA;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,GAAG,EAAE,MAAM,CAAA;IACX;qDACiD;IACjD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,GAAG,KAAK,CAAC,SAAS,CAwClB"}

package/lib/types/components/PermissionsPicker.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { t } from '../i18n.js';
+import { Box, Text } from '../ui.js';
+import { Pane } from './design-system/Pane.js';
+import { Select } from './Select.js';
+import { HintLine } from './design-system/HintLine.js';
+/**
+ * `/permission` sandbox-preset picker. The command itself is registered by
+ * the harness side (dsh-sandbox-policy / dsh-base permission-presets row);
+ * bare `/permission` opens this picker and Enter dispatches
+ * `/permission <preset>` through the same external-command path a hand-typed
+ * argument takes. The roster comes from the adapter snapshot so host plugins
+ * can contribute additional preset identities without UI changes.
+ */
+export function PermissionsPicker({ options, focusIndex, currentValue, cwd, onPick, }) {
+    return (_jsx(Pane, { color: "permission", children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: t('permission-picker-title') }) }), _jsx(Select, { options: options.map(option => ({
+                        value: option.value,
+                        label: option.value === 'read-only'
+                            ? t('permission-preset-readonly')
+                            : option.value === 'workspace-write'
+                                ? t('permission-preset-workspace-write')
+                                : option.value === 'danger-full-access'
+                                    ? t('permission-preset-full-access')
+                                    : option.name,
+                        description: option.value === 'read-only'
+                            ? t('permission-preset-readonly-desc')
+                            : option.value === 'workspace-write'
+                                ? t('permission-preset-workspace-write-desc')
+                                : option.value === 'danger-full-access'
+                                    ? t('permission-preset-full-access-desc')
+                                    : option.description ?? option.name,
+                    })), focusIndex: focusIndex, selectedValue: currentValue, onPick: onPick ? index => onPick(index) : undefined }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('hint-confirm-exit') }) }), _jsx(Text, { dimColor: true, children: t('permission-root-hint', { cwd }) })] }) }));
+}

package/lib/types/components/PlanPicker.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+/**
+ * `/plan` on/off picker. The command itself is registered by dsh-plan-mode
+ * on the harness side; bare `/plan` opens this picker (with the current
+ * state marked) and Enter dispatches `/plan` or `/plan off` through the
+ * same external-command path a hand-typed argument takes.
+ */
+export declare function PlanPicker({ focusIndex, currentOn, onPick, }: {
+    focusIndex: number;
+    currentOn: boolean;
+    /** Mouse pick (fullscreen): clicked row's absolute index (Chat applies
+     *  the same code path as the keyboard Enter). */
+    onPick?: (index: number) => void;
+}): React.ReactNode;
+//# sourceMappingURL=PlanPicker.d.ts.map

package/lib/types/components/PlanPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanPicker.d.ts","sourceRoot":"","sources":["../../../src/components/PlanPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,UAAU,EACV,SAAS,EACT,MAAM,GACP,EAAE;IACD,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB;qDACiD;IACjD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,GAAG,KAAK,CAAC,SAAS,CAwBlB"}

package/lib/types/components/PlanPicker.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { t } from '../i18n.js';
+import { Box, Text } from '../ui.js';
+import { Pane } from './design-system/Pane.js';
+import { Select } from './Select.js';
+import { HintLine } from './design-system/HintLine.js';
+/**
+ * `/plan` on/off picker. The command itself is registered by dsh-plan-mode
+ * on the harness side; bare `/plan` opens this picker (with the current
+ * state marked) and Enter dispatches `/plan` or `/plan off` through the
+ * same external-command path a hand-typed argument takes.
+ */
+export function PlanPicker({ focusIndex, currentOn, onPick, }) {
+    return (_jsx(Pane, { color: "permission", children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: t('plan-picker-title') }) }), _jsx(Select, { options: [
+                        { value: 'on', label: t('plan-mode-on'), description: t('plan-mode-on-desc') },
+                        { value: 'off', label: t('plan-mode-off'), description: t('plan-mode-off-desc') },
+                    ], focusIndex: focusIndex, selectedValue: currentOn ? 'on' : 'off', onPick: onPick ? index => onPick(index) : undefined }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('hint-confirm-exit') }) })] }) }));
+}

package/lib/types/components/PluginSceneBoundary.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Error boundary for plugin scenes (dsh-tui-scenes). A scene component is
+ * third-party code rendered inside Chat's tree: without a boundary a render
+ * error propagates to ink's app-level boundary (src/ink/components/App.tsx)
+ * and takes the whole TUI down with it. Catching here collapses the blast
+ * radius to the scene itself — the host reports the error to the transcript
+ * and closes the scene, landing the user back on the conversation.
+ *
+ * Boundaries catch render/lifecycle errors only; errors thrown from async
+ * handlers and effects remain the scene's own responsibility (see the
+ * 场景红线 section in dsh-ecosystem-spec 的插件准入与开发指南).
+ */
+import React from 'react';
+type PluginSceneBoundaryProps = {
+    /** Scene id, echoed into the error report. */
+    readonly id: string;
+    /** Called once per caught error; the host reports it and closes the scene. */
+    readonly onError: (id: string, error: Error) => void;
+    readonly children: React.ReactNode;
+};
+type PluginSceneBoundaryState = {
+    readonly crashed: boolean;
+};
+export declare class PluginSceneBoundary extends React.Component<PluginSceneBoundaryProps, PluginSceneBoundaryState> {
+    state: PluginSceneBoundaryState;
+    static getDerivedStateFromError(): PluginSceneBoundaryState;
+    componentDidCatch(error: Error): void;
+    render(): React.ReactNode;
+}
+export {};
+//# sourceMappingURL=PluginSceneBoundary.d.ts.map

package/lib/types/components/PluginSceneBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSceneBoundary.d.ts","sourceRoot":"","sources":["../../../src/components/PluginSceneBoundary.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,KAAK,wBAAwB,GAAG;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IACpD,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CACnC,CAAA;AAED,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,qBAAa,mBAAoB,SAAQ,KAAK,CAAC,SAAS,CACtD,wBAAwB,EACxB,wBAAwB,CACzB;IACU,KAAK,EAAE,wBAAwB,CAAqB;IAE7D,MAAM,CAAC,wBAAwB,IAAI,wBAAwB;IAQlD,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIrC,MAAM,IAAI,KAAK,CAAC,SAAS;CAGnC"}

package/lib/types/components/PluginSceneBoundary.js

@@ -0,0 +1,29 @@
+/**
+ * Error boundary for plugin scenes (dsh-tui-scenes). A scene component is
+ * third-party code rendered inside Chat's tree: without a boundary a render
+ * error propagates to ink's app-level boundary (src/ink/components/App.tsx)
+ * and takes the whole TUI down with it. Catching here collapses the blast
+ * radius to the scene itself — the host reports the error to the transcript
+ * and closes the scene, landing the user back on the conversation.
+ *
+ * Boundaries catch render/lifecycle errors only; errors thrown from async
+ * handlers and effects remain the scene's own responsibility (see the
+ * 场景红线 section in dsh-ecosystem-spec 的插件准入与开发指南).
+ */
+import React from 'react';
+export class PluginSceneBoundary extends React.Component {
+    state = { crashed: false };
+    static getDerivedStateFromError() {
+        // Suppress the scene's next render. The host's onError closes the scene
+        // in the same commit turn, so this null fallback normally never paints;
+        // it exists only to keep a closed-nowhere crash from remounting the
+        // throwing component in a loop.
+        return { crashed: true };
+    }
+    componentDidCatch(error) {
+        this.props.onError(this.props.id, error);
+    }
+    render() {
+        return this.state.crashed ? null : this.props.children;
+    }
+}

package/lib/types/components/PluginStatusViewBoundary.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Error boundary for rich `tuiStatus` views. These components are trusted
+ * in-process plugin code, but one broken render must collapse only its own
+ * compact view instead of reaching Ink's app-level boundary and taking down
+ * the conversation.
+ *
+ * As with plugin scenes, async callback/effect failures remain the plugin's
+ * responsibility; React boundaries cover render and lifecycle failures.
+ */
+import React from 'react';
+type PluginStatusViewBoundaryProps = {
+    readonly viewKey: string;
+    readonly onError: (key: string, error: Error) => void;
+    readonly children: React.ReactNode;
+};
+type PluginStatusViewBoundaryState = {
+    readonly crashed: boolean;
+};
+export declare class PluginStatusViewBoundary extends React.Component<PluginStatusViewBoundaryProps, PluginStatusViewBoundaryState> {
+    state: PluginStatusViewBoundaryState;
+    static getDerivedStateFromError(): PluginStatusViewBoundaryState;
+    componentDidCatch(error: Error): void;
+    render(): React.ReactNode;
+}
+export {};
+//# sourceMappingURL=PluginStatusViewBoundary.d.ts.map

package/lib/types/components/PluginStatusViewBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginStatusViewBoundary.d.ts","sourceRoot":"","sources":["../../../src/components/PluginStatusViewBoundary.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,KAAK,6BAA6B,GAAG;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IACrD,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CACnC,CAAA;AAED,KAAK,6BAA6B,GAAG;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,qBAAa,wBAAyB,SAAQ,KAAK,CAAC,SAAS,CAC3D,6BAA6B,EAC7B,6BAA6B,CAC9B;IACU,KAAK,EAAE,6BAA6B,CAAqB;IAElE,MAAM,CAAC,wBAAwB,IAAI,6BAA6B;IAIvD,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIrC,MAAM,IAAI,KAAK,CAAC,SAAS;CAGnC"}