@askdkc/dsh-cli 0.11.3

package/lib/types/components/CommandSuggestions.js

@@ -0,0 +1,61 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Text } from '../ui.js';
+import { stringWidth } from '../ink/stringWidth.js';
+import { truncateToWidth } from '../ink/truncateToWidth.js';
+import { localizedDescription } from '../commands.js';
+import { t } from '../i18n.js';
+import { POINTER } from '../terminal-utils/figures.js';
+import { SuggestionCard, cardContentWidth, splitQueryMatch } from './SuggestionCard.js';
+/**
+ * The slash-command suggestion overlay, using the shared rounded
+ * `SuggestionCard` for the command list:
+ *
+ *   ╭─ 命令 · 共 12 项 ──────────────────────╮
+ *   │ ❯ compact  Summarize earlier turns…  │   ← 选中：❯ + 加粗 + suggestion 色
+ *   │   compare  Compare selected messages … │   ← 名字里命中输入的段提亮
+ *   │ ↑2 · ↓3                                 │   ← 仅当列表被窗口裁剪
+ *   ╰─────────────────────────────────────────╯
+ *
+ * 未选中行整体 dim，唯独名字里匹配当前查询 token 的前缀以正常亮度提亮
+ * （bold 与 dim 在终端互斥，故提亮用非 dim 而非加粗）；选中行整行
+ * suggestion 色、名字加粗、前置 ❯ 指针。
+ */
+export function CommandSuggestions({ commands, selectedIndex, columns, query = '', accent, onPick, onWheelStep, }) {
+    if (commands.length === 0)
+        return null;
+    // Cap the command name column at 40% of the card's content width to ensure
+    // the description has enough space.
+    const usable = cardContentWidth(columns);
+    const maxNameWidth = Math.floor(usable * 0.4);
+    const nameWidth = Math.min(Math.max(...commands.map(c => stringWidth(c.name))) + 5, maxNameWidth);
+    const maxVisible = 5;
+    const startIndex = Math.max(0, Math.min(selectedIndex - Math.floor(maxVisible / 2), commands.length - maxVisible));
+    const visible = commands.slice(startIndex, startIndex + maxVisible);
+    const above = startIndex;
+    const below = commands.length - (startIndex + visible.length);
+    // 前缀高亮取查询的最后一段 token（`/plan of` 高亮 `of` 命中的段）。
+    const queryToken = query.replace(/^\//, '').match(/[^ \t]*$/)?.[0] ?? '';
+    const title = `${t('sugg-commands-title')} · ${t('sugg-count', { n: commands.length })}`;
+    const footer = above > 0 || below > 0
+        ? [
+            above > 0 ? t('sugg-more-above', { n: above }) : null,
+            below > 0 ? t('sugg-more-below', { n: below }) : null,
+        ]
+            .filter((part) => part !== null)
+            .join(' · ')
+        : null;
+    return (_jsx(SuggestionCard, { title: title, columns: columns, accent: accent, footer: footer, onRowPick: onPick ? index => onPick(startIndex + index) : undefined, onWheelStep: onWheelStep, rows: visible.map(command => {
+            const isSelected = command.name === commands[selectedIndex]?.name;
+            const tagText = command.tag ? `[${command.tag}] ` : '';
+            const tagWidth = stringWidth(tagText);
+            // 行预算：内容宽 − 前导空格 1 − 指针列 2。
+            const descriptionWidth = Math.max(0, usable - 3 - nameWidth - tagWidth);
+            const rawDescription = localizedDescription(command);
+            const description = stringWidth(rawDescription) > descriptionWidth
+                ? truncateToWidth(rawDescription, descriptionWidth - 1) + '…'
+                : rawDescription;
+            const parts = splitQueryMatch(command.name, queryToken);
+            const padAfter = Math.max(0, nameWidth - stringWidth(command.name));
+            return (_jsxs(Text, { wrap: "truncate", children: [' ', isSelected ? (_jsx(Text, { color: "suggestion", bold: true, children: `${POINTER} ${command.name}${' '.repeat(padAfter)}` })) : parts ? (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: `  ${parts.before}` }), _jsx(Text, { children: parts.match }), _jsx(Text, { dimColor: true, children: `${parts.after}${' '.repeat(padAfter)}` })] })) : (_jsx(Text, { dimColor: true, children: `  ${command.name}${' '.repeat(padAfter)}` })), tagText ? _jsx(Text, { dimColor: true, children: tagText }) : null, _jsx(Text, { color: isSelected ? 'suggestion' : undefined, dimColor: !isSelected, children: description })] }, command.name));
+        }) }));
+}

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

@@ -0,0 +1,41 @@
+import React from 'react';
+import type { Color } from '../ink/styles.js';
+import { type ContextSegments } from '../screens/StatusMetrics.js';
+/**
+ * The hoverable JSX twin of `renderContextBar`: the same segmented context
+ * bar (same largest-remainder column split, same free-segment readout),
+ * rendered as one Box per segment so the bar can react to the pointer.
+ *
+ * A used segment is its fill color and nothing else — no label (community
+ * feedback on the old `s`/`p`/`t` letters: they read as noise on a row that is
+ * already decorative, and they never fit the narrow segments anyway). The only
+ * text left is the free segment's right-aligned usage readout.
+ *
+ * ONE hover target for the whole bar rather than one per segment. The colors
+ * are named where there is room for words: hovering anywhere on the bar parks
+ * the full per-content-type breakdown on the footer's supplemental row. A
+ * per-segment target also made every crossing of the five fills an
+ * enter+leave pair, hence a footer re-render per crossing.
+ *
+ * The component path follows the ANSI path's geometry: this exists so the bar
+ * can react to the pointer, not to restyle it.
+ */
+export declare function ContextBarView({ segments, usedTokens, contextWindow, width, colors, onHover, }: {
+    /** Used tokens per content type. */
+    segments: ContextSegments;
+    /** Total used tokens, driving the usage readout. */
+    usedTokens: number;
+    /** The context window size in tokens. */
+    contextWindow: number;
+    /** Total bar width in terminal columns. */
+    width: number;
+    /** Theme overrides for the free segment (light theme passes its own). */
+    colors?: {
+        freeFill: Color;
+        freeText: Color;
+    };
+    /** Hover signal: true while the pointer is anywhere on the bar, false on
+     *  leave. Absent handlers render a static bar (tests, headless embeds). */
+    onHover?: (hovered: boolean) => void;
+}): React.ReactNode;
+//# sourceMappingURL=ContextBarView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextBarView.d.ts","sourceRoot":"","sources":["../../../src/components/ContextBarView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAQL,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAA;AAEpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,UAAU,EACV,aAAa,EACb,KAAK,EACL,MAAM,EACN,OAAO,GACR,EAAE;IACD,oCAAoC;IACpC,QAAQ,EAAE,eAAe,CAAA;IACzB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAA;IAClB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,KAAK,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAA;KAAE,CAAA;IAC7C;+EAC2E;IAC3E,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CACrC,GAAG,KAAK,CAAC,SAAS,CA2DlB"}

package/lib/types/components/ContextBarView.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from '../ui.js';
+import { FREE_SEGMENT_FILL, FREE_SEGMENT_TEXT, USED_SEGMENTS, allocateBarColumns, contextBarReadout, contextPressureStep, rightAlignBarText, } from '../screens/StatusMetrics.js';
+/**
+ * The hoverable JSX twin of `renderContextBar`: the same segmented context
+ * bar (same largest-remainder column split, same free-segment readout),
+ * rendered as one Box per segment so the bar can react to the pointer.
+ *
+ * A used segment is its fill color and nothing else — no label (community
+ * feedback on the old `s`/`p`/`t` letters: they read as noise on a row that is
+ * already decorative, and they never fit the narrow segments anyway). The only
+ * text left is the free segment's right-aligned usage readout.
+ *
+ * ONE hover target for the whole bar rather than one per segment. The colors
+ * are named where there is room for words: hovering anywhere on the bar parks
+ * the full per-content-type breakdown on the footer's supplemental row. A
+ * per-segment target also made every crossing of the five fills an
+ * enter+leave pair, hence a footer re-render per crossing.
+ *
+ * The component path follows the ANSI path's geometry: this exists so the bar
+ * can react to the pointer, not to restyle it.
+ */
+export function ContextBarView({ segments, usedTokens, contextWindow, width, colors, onHover, }) {
+    if (width <= 0 || contextWindow <= 0)
+        return null;
+    const freeTokens = Math.max(0, contextWindow - usedTokens);
+    const values = [...USED_SEGMENTS.map(segment => segments[segment.key]), freeTokens];
+    const columns = allocateBarColumns(values, width);
+    // The readout is the bar's only text, and its one pressure signal: amber
+    // from 80% occupancy, red from 95% (the footer's shared thresholds). The
+    // theme key wins over the free-text color, which stays for comfortable
+    // occupancy.
+    const readout = contextBarReadout(usedTokens, contextWindow);
+    const pressure = contextPressureStep((usedTokens / contextWindow) * 100);
+    const nodes = [];
+    for (const [index, segment] of USED_SEGMENTS.entries()) {
+        const segmentWidth = columns[index] ?? 0;
+        if (segmentWidth <= 0)
+            continue;
+        // Childless on purpose: the renderer fills a node's own rect with its
+        // backgroundColor, so the segment is a pure colored block (render-node-to-
+        // output's ownBackgroundColor fill).
+        nodes.push(_jsx(Box, { width: segmentWidth, height: 1, flexShrink: 0, backgroundColor: segment.color }, segment.key));
+    }
+    const freeWidth = columns[USED_SEGMENTS.length] ?? 0;
+    if (freeWidth > 0) {
+        nodes.push(_jsx(Box, { width: freeWidth, height: 1, flexShrink: 0, backgroundColor: colors?.freeFill ?? FREE_SEGMENT_FILL, children: _jsx(Text, { color: pressure ?? colors?.freeText ?? FREE_SEGMENT_TEXT, wrap: "truncate", children: rightAlignBarText(readout, freeWidth) }) }, "free"));
+    }
+    return (_jsx(Box, { flexDirection: "row", flexShrink: 0, width: width, onMouseEnter: onHover === undefined ? undefined : () => onHover(true), onMouseLeave: onHover === undefined ? undefined : () => onHover(false), children: nodes }));
+}

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

@@ -0,0 +1,26 @@
+/**
+ * EffortChargeGlyph — 输入提示前缀 `❯ ` 的最高档强调与充能。
+ *
+ * 思考强度处于当前路线最高档期间，前缀换为点火强调色（加粗，与点焰波
+ * 共用 hues[0]——同一瞬间前缀与波是同一种橙）；切到最高档的瞬间做一次
+ * 150ms「充能」渐变（accentRamp 的暗端 → 全值）。冷启动已在最高档时
+ * 不充能（充能只属于切换瞬间），离开最高档恢复原样的 dim 行为。
+ *
+ * 触发判定在渲染期做（React 官方的「props 变化即调整 state」模式，
+ * 与 EffortInputBorder 同一模式）——放 effect 会晚一帧，effort 变化
+ * 的首帧以全亮闪现、下一帧才跌回暗端重来。充能只动颜色，glyph 恒为
+ * `❯ `，SGR-only 规则天然成立。
+ *
+ * 时钟复用 Ink core 共享时钟，且只在充能未满的那 150ms 内订阅；稳态
+ * 零定时器、零重渲染，前缀色取记忆化常量。
+ */
+import React from 'react';
+export declare function EffortChargeGlyph({ effort, levels, working, }: {
+    /** 当前思考强度档 id；`undefined` 表示路线未声明。 */
+    effort: string | undefined;
+    /** 当前路线的档位表（低→高，末位为最高档）。 */
+    levels: readonly string[] | undefined;
+    /** 模型工作中时前缀照旧压暗（既有语义）。 */
+    working: boolean;
+}): React.ReactNode;
+//# sourceMappingURL=EffortChargeGlyph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EffortChargeGlyph.d.ts","sourceRoot":"","sources":["../../../src/components/EffortChargeGlyph.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAsD,MAAM,OAAO,CAAA;AAW1E,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,MAAM,EACN,OAAO,GACR,EAAE;IACD,sCAAsC;IACtC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,4BAA4B;IAC5B,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACrC,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAA;CACjB,GAAG,KAAK,CAAC,SAAS,CAuDlB"}

package/lib/types/components/EffortChargeGlyph.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * EffortChargeGlyph — 输入提示前缀 `❯ ` 的最高档强调与充能。
+ *
+ * 思考强度处于当前路线最高档期间，前缀换为点火强调色（加粗，与点焰波
+ * 共用 hues[0]——同一瞬间前缀与波是同一种橙）；切到最高档的瞬间做一次
+ * 150ms「充能」渐变（accentRamp 的暗端 → 全值）。冷启动已在最高档时
+ * 不充能（充能只属于切换瞬间），离开最高档恢复原样的 dim 行为。
+ *
+ * 触发判定在渲染期做（React 官方的「props 变化即调整 state」模式，
+ * 与 EffortInputBorder 同一模式）——放 effect 会晚一帧，effort 变化
+ * 的首帧以全亮闪现、下一帧才跌回暗端重来。充能只动颜色，glyph 恒为
+ * `❯ `，SGR-only 规则天然成立。
+ *
+ * 时钟复用 Ink core 共享时钟，且只在充能未满的那 150ms 内订阅；稳态
+ * 零定时器、零重渲染，前缀色取记忆化常量。
+ */
+import { useContext, useEffect, useReducer, useState } from 'react';
+import { Text, useTheme } from '../ui.js';
+import { ClockContext } from '../ink/components/ClockContext.js';
+import { accentRamp } from '../trajectory/effortIgnition.js';
+import { rgbString } from '../trajectory/motion.js';
+import { interpolateColor } from './Spinner/spinnerUtils.js';
+import { isLightThemeActive } from '../theme.js';
+/** 充能时长（ms）。 */
+const CHARGE_MS = 150;
+export function EffortChargeGlyph({ effort, levels, working, }) {
+    const clock = useContext(ClockContext);
+    const [themeName] = useTheme();
+    const [chargeStartedAt, setChargeStartedAt] = useState(null);
+    const [prevEffort, setPrevEffort] = useState(effort);
+    const [, forceRender] = useReducer((tick) => tick + 1, 0);
+    const topActive = effort !== undefined && levels !== undefined && levels.length > 1 && effort === levels[levels.length - 1];
+    // Render-phase trigger (same pattern as EffortInputBorder): switching from
+    // an existing tier onto the top tier starts the charge NOW, not one effect
+    // later — the first frame of the new effort must not flash fully lit.
+    // Cold mounts enter the steady state directly; without a shared clock
+    // (headless embeds) there is no charge either — no frames would ever arrive.
+    if (effort !== prevEffort) {
+        setPrevEffort(effort);
+        if (topActive && clock !== null) {
+            setChargeStartedAt(clock.now());
+        }
+    }
+    // Only the 150ms charge window subscribes to the shared clock; steady
+    // state has zero timers and zero re-renders.
+    const chargeElapsed = chargeStartedAt === null
+        ? Infinity
+        : // Clamp at zero: the shared clock can hand back a stale tickTime for
+            // one frame after waking from pause.
+            Math.max(0, (clock?.now() ?? Date.now()) - chargeStartedAt);
+    const charging = chargeElapsed < CHARGE_MS;
+    useEffect(() => {
+        if (!charging || clock === null)
+            return;
+        return clock.subscribe(() => forceRender(), /* keepAlive */ true);
+    }, [charging, clock]);
+    if (!topActive)
+        return _jsx(Text, { dimColor: working, children: "\u276F " });
+    const ramp = accentRamp(isLightThemeActive(themeName));
+    if (!charging) {
+        // Steady state re-derives on every render (two allocations + one blend
+        // per keystroke — negligible) instead of caching: a cached colour would
+        // go stale across a light/dark theme flip while the tier stays active.
+        const color = rgbString(ramp.full);
+        return (_jsxs(Text, { bold: true, color: color, dimColor: working, children: ["\u276F", ' '] }));
+    }
+    const charge = Math.min(1, chargeElapsed / CHARGE_MS);
+    return (_jsxs(Text, { bold: true, color: rgbString(interpolateColor(ramp.dim, ramp.full, charge)), dimColor: working, children: ["\u276F", ' '] }));
+}

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

@@ -0,0 +1,47 @@
+/**
+ * EffortInputBorder — 输入框层上的三幕点焰叠加（对齐 Codex 的完整
+ * 语义：光扫过、档位字样浮现、整体渐隐）。
+ *
+ * 输入框只有顶/底两条横边框（round、无左右）——本组件自绘这两行，
+ * **同步**承载动画；档位字样由输入行尾的 EffortTierBadge 短暂显示
+ * （见 PromptInput），动画全程行数恒定。切到最高思考强度档时：
+ *
+ *   1. 扫光 [0, 1s)——一段高亮彩色光带沿顶/底边框同步自左向右扫过
+ *      （wave 波形逐列变色），期间输入框完全正常可用；
+ *   2. 档位字样 [600ms, ~1.1s)——光带行至中段时，输入行居中浮现
+ *      档名大写（由暗渐亮加粗、间距聚拢，见 EffortTierBadge）；
+ *   3. 渐隐 [1.5s, 2s)——字样连同光色一起向主题色淡出，末帧归零：
+ *      静止时顶/底边框就是原主题色，内容区无任何附加物。
+ *
+ * glyph 变化仅限字样行的出现/让位（一次性）；其余帧间变化全部是既
+ * 有 `─` 的前景色。触发判定在渲染期做（props-变化-调整模式）；从
+ * 「已有档位」切到档位表末位最高档才触发，冷启动恢复偏好/单档表/
+ * 无档位表/无共享时钟均不触发。时钟复用 Ink core 共享时钟，仅动画
+ * 窗口订阅（keepAlive），播完回到零开销静止边框。
+ */
+import React from 'react';
+import type { Color } from '../ink/styles.js';
+import type { Theme } from '../theme.js';
+/** A static chip on the top border row used for the session label. */
+export interface InputBorderLabel {
+    /** Visible text (already width-truncated by the caller). */
+    text: string;
+    /** Chip background (theme token or raw color). */
+    color: keyof Theme | Color;
+    /** Chip foreground (theme token or raw color). */
+    ink: keyof Theme | Color;
+}
+export declare function EffortInputBorder({ effort, levels, columns, onLight, idleColor, topRightLabel, children, }: {
+    /** 当前思考强度档 id；`undefined` 表示路线未声明。 */
+    effort: string | undefined;
+    /** 当前路线的档位表（低→高，末位为最高档）；未知时传 `undefined`。 */
+    levels: readonly string[] | undefined;
+    columns: number;
+    onLight: boolean;
+    /** 静止边框色（主题 token 名，如 'promptBorder' / 'planMode'）。 */
+    idleColor: keyof Theme | Color;
+    /** 顶边框右侧的静态标签 chip（会话名标签）；undefined = 不显示。 */
+    topRightLabel?: InputBorderLabel;
+    children: React.ReactNode;
+}): React.ReactNode;
+//# sourceMappingURL=EffortInputBorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EffortInputBorder.d.ts","sourceRoot":"","sources":["../../../src/components/EffortInputBorder.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAA8D,MAAM,OAAO,CAAA;AAGlF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAKxC,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,KAAK,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;IAC1B,kDAAkD;IAClD,GAAG,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;CACzB;AAiDD,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EACP,SAAS,EACT,aAAa,EACb,QAAQ,GACT,EAAE;IACD,sCAAsC;IACtC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,6CAA6C;IAC7C,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,uDAAuD;IACvD,SAAS,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;IAC9B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,gBAAgB,CAAA;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,GAAG,KAAK,CAAC,SAAS,CA0DlB"}

package/lib/types/components/EffortInputBorder.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * EffortInputBorder — 输入框层上的三幕点焰叠加（对齐 Codex 的完整
+ * 语义：光扫过、档位字样浮现、整体渐隐）。
+ *
+ * 输入框只有顶/底两条横边框（round、无左右）——本组件自绘这两行，
+ * **同步**承载动画；档位字样由输入行尾的 EffortTierBadge 短暂显示
+ * （见 PromptInput），动画全程行数恒定。切到最高思考强度档时：
+ *
+ *   1. 扫光 [0, 1s)——一段高亮彩色光带沿顶/底边框同步自左向右扫过
+ *      （wave 波形逐列变色），期间输入框完全正常可用；
+ *   2. 档位字样 [600ms, ~1.1s)——光带行至中段时，输入行居中浮现
+ *      档名大写（由暗渐亮加粗、间距聚拢，见 EffortTierBadge）；
+ *   3. 渐隐 [1.5s, 2s)——字样连同光色一起向主题色淡出，末帧归零：
+ *      静止时顶/底边框就是原主题色，内容区无任何附加物。
+ *
+ * glyph 变化仅限字样行的出现/让位（一次性）；其余帧间变化全部是既
+ * 有 `─` 的前景色。触发判定在渲染期做（props-变化-调整模式）；从
+ * 「已有档位」切到档位表末位最高档才触发，冷启动恢复偏好/单档表/
+ * 无档位表/无共享时钟均不触发。时钟复用 Ink core 共享时钟，仅动画
+ * 窗口订阅（keepAlive），播完回到零开销静止边框。
+ */
+import { useContext, useEffect, useReducer, useState } from 'react';
+import { Box, Text } from '../ui.js';
+import { ClockContext } from '../ink/components/ClockContext.js';
+import { stringWidth } from '../ink/stringWidth.js';
+import { IGNITION_TIMELINE, ignitionLineColors } from '../trajectory/effortIgnition.js';
+/** 边框行（顶/底共用同一色段序列——同步变色）。顶行可在右圆角前插入
+ *  一个静态标签 chip（会话名），占用的列数从色段序列里扣掉，行宽不变。 */
+function BorderRow({ left, right, runs, idleColor, label, }) {
+    const labelWidth = label === undefined ? 0 : stringWidth(` ${label.text} `);
+    // chip 与右圆角之间的留白（边框线格数）：视觉上不让标签贴死 ╮。
+    const labelGap = label === undefined ? 0 : 2;
+    // 裁剪色段序列到剩余列数（label 行与底行的列数一致，总宽不变）。
+    // 色段保留左侧部分，右侧让位给 chip + 留白（右上角布局）。
+    let budget = Math.max(0, runs.reduce((sum, run) => sum + run.glyph.length, 0) - labelWidth - labelGap);
+    const clipped = [];
+    for (const run of runs) {
+        if (budget <= 0)
+            break;
+        const take = Math.min(run.glyph.length, budget);
+        if (take > 0)
+            clipped.push({ glyph: run.glyph.slice(0, take), color: run.color });
+        budget -= take;
+    }
+    return (_jsx(Box, { width: "100%", height: 1, flexShrink: 0, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: idleColor, children: left }), clipped.map((run, i) => (_jsx(Text, { color: run.color, children: run.glyph }, i))), label !== undefined && (_jsx(Text, { backgroundColor: label.color, color: label.ink, children: ` ${label.text} ` })), label !== undefined && _jsx(Text, { color: idleColor, children: '─'.repeat(labelGap) }), _jsx(Text, { color: idleColor, children: right })] }) }));
+}
+export function EffortInputBorder({ effort, levels, columns, onLight, idleColor, topRightLabel, children, }) {
+    const clock = useContext(ClockContext);
+    const [overlay, setOverlay] = useState(null);
+    const [prevEffort, setPrevEffort] = useState(effort);
+    const [, forceRender] = useReducer((tick) => tick + 1, 0);
+    // 渲染期触发：effort 变化的首帧就以新状态渲染（effect 会晚一帧）。
+    if (effort !== prevEffort) {
+        setPrevEffort(effort);
+        if (clock !== null &&
+            effort !== undefined &&
+            levels !== undefined &&
+            levels.length > 1 &&
+            effort === levels[levels.length - 1]) {
+            setOverlay({ label: effort.toUpperCase(), startedAtMs: clock.now() });
+        }
+    }
+    // 仅动画窗口订阅共享时钟；静止边框零定时器零重渲染。
+    const elapsedMs = overlay === null ? Infinity : Math.max(0, (clock?.now() ?? Date.now()) - overlay.startedAtMs);
+    useEffect(() => {
+        if (overlay === null || clock === null)
+            return;
+        return clock.subscribe(() => forceRender(), /* keepAlive */ true);
+    }, [overlay, clock]);
+    useEffect(() => {
+        if (overlay !== null && elapsedMs >= IGNITION_TIMELINE.fadeEndMs)
+            setOverlay(null);
+    }, [overlay, elapsedMs]);
+    const midWidth = Math.max(0, columns - 2);
+    const sweepColors = overlay !== null && elapsedMs < IGNITION_TIMELINE.sweepMs && midWidth > 0
+        ? ignitionLineColors({ elapsedMs, width: midWidth, onLight })
+        : [];
+    // 顶/底共用的色段序列（同步）：扫光列取波形色，其余列回主题色。
+    const runs = [];
+    for (let index = 0; index < midWidth; index++) {
+        const color = sweepColors[index] ?? idleColor;
+        const last = runs[runs.length - 1];
+        if (last !== undefined && last.color === color)
+            last.glyph += '─';
+        else
+            runs.push({ glyph: '─', color });
+    }
+    return (_jsxs(Box, { flexDirection: "column", alignItems: "flex-start", justifyContent: "flex-start", width: "100%", flexShrink: 0, children: [_jsx(BorderRow, { left: "\u256D", right: "\u256E", runs: runs, idleColor: idleColor, label: topRightLabel }), _jsx(Box, { flexShrink: 0, children: children }), _jsx(BorderRow, { left: "\u2570", right: "\u256F", runs: runs, idleColor: idleColor })] }));
+}

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

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { EffortOption } from '../dsh-adapter/channel.js';
+/**
+ * Reasoning-effort slider (`/effort`): a rheostat row of the live route's
+ * adapter-owned levels in adapter order, ←/→ moving focus (each move applies
+ * immediately through `channel.setEffort` — the slider IS the control; Enter
+ * or Esc just closes it). The current level carries `✓`; the focused level's
+ * description renders below the row.
+ */
+export declare function EffortSlider({ options, focusIndex, currentId, onPick, }: {
+    options: readonly EffortOption[];
+    focusIndex: number;
+    currentId: string | undefined;
+    /** Mouse pick (fullscreen): click a tier = move there and live-apply —
+     *  the same semantics as the ←/→ keys (the slider IS the control). */
+    onPick?: (index: number) => void;
+}): React.ReactNode;
+//# sourceMappingURL=EffortSlider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EffortSlider.d.ts","sourceRoot":"","sources":["../../../src/components/EffortSlider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAE7D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,UAAU,EACV,SAAS,EACT,MAAM,GACP,EAAE;IACD,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B;0EACsE;IACtE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,GAAG,KAAK,CAAC,SAAS,CA4ClB"}

package/lib/types/components/EffortSlider.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { t } from '../i18n.js';
+import { Box, Text } from '../ui.js';
+import { Pane } from './design-system/Pane.js';
+import { HintLine } from './design-system/HintLine.js';
+/**
+ * Reasoning-effort slider (`/effort`): a rheostat row of the live route's
+ * adapter-owned levels in adapter order, ←/→ moving focus (each move applies
+ * immediately through `channel.setEffort` — the slider IS the control; Enter
+ * or Esc just closes it). The current level carries `✓`; the focused level's
+ * description renders below the row.
+ */
+export function EffortSlider({ options, focusIndex, currentId, onPick, }) {
+    const focused = options[focusIndex];
+    return (_jsx(Pane, { color: "permission", children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: t('picker-title-effort') }) }), _jsx(Box, { flexDirection: "row", children: options.map((option, index) => (_jsxs(React.Fragment, { children: [index > 0 ? (_jsx(Text, { dimColor: true, children: " \u2500\u2500 " })) : null, _jsx(Box, { onClick: onPick ? () => onPick(index) : undefined, backgroundColor: onPick !== undefined && index !== focusIndex
+                                    ? 'userMessageBackgroundHover'
+                                    : undefined, children: _jsx(Text, { inverse: index === focusIndex, bold: index === focusIndex, children: option.name }) }), option.id === currentId ? _jsx(Text, { color: "remember", children: "\u2713" }) : null] }, option.id))) }), focused?.description !== undefined ? (_jsx(Text, { dimColor: true, children: focused.description })) : null, _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('hint-adjust-done') }) })] }) }));
+}

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

@@ -0,0 +1,26 @@
+/**
+ * EffortTierBadge — 输入行尾的档位字样徽标：三幕点焰的第二幕载体
+ * （与 EffortInputBorder 的双框扫光同一时间轴、同一触发），切到最高
+ * 思考强度档时光带行至中段，输入行居中浮现档名（当前档名大写，字母间距从
+ * 10 个空格减速聚拢到 1 个——连续位置逐字母取整保证帧帧有移动，
+ * 明亮蓝加粗，由暗渐亮），随后随图层整体渐隐让位——行数恒定，静
+ * 止时完全不渲染；输入行有文字时不显示（绝不遮挡内容）。
+ *
+ * 触发判定在渲染期做（props-变化-调整模式，与边框/充能组件同模
+ * 式）；冷启动恢复偏好/单档表/无档位表/无共享时钟均不触发。时钟
+ * 复用 Ink core 共享时钟，仅动画窗口订阅（keepAlive），播完归零。
+ */
+import React from 'react';
+export declare function EffortTierBadge({ effort, levels, onLight, columns, leadingColumns, }: {
+    /** 当前思考强度档 id；`undefined` 表示路线未声明。 */
+    effort: string | undefined;
+    /** 当前路线的档位表（低→高，末位为最高档）；未知时传 `undefined`。 */
+    levels: readonly string[] | undefined;
+    onLight: boolean;
+    /** 终端列数——居中锚点按终端几何中心计算（纯文本流，不引入嵌套 Box）。 */
+    columns: number;
+    /** badge 文本流之前该行已被占据的列数（❯ 与块光标等）——居中换算成
+     *  badge 流内列时要扣掉，否则整体偏右一个前缀宽。 */
+    leadingColumns: number;
+}): React.ReactNode;
+//# sourceMappingURL=EffortTierBadge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EffortTierBadge.d.ts","sourceRoot":"","sources":["../../../src/components/EffortTierBadge.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAsD,MAAM,OAAO,CAAA;AAc1E,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EACP,cAAc,GACf,EAAE;IACD,sCAAsC;IACtC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,6CAA6C;IAC7C,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf;qCACiC;IACjC,cAAc,EAAE,MAAM,CAAA;CACvB,GAAG,KAAK,CAAC,SAAS,CAkFlB"}

package/lib/types/components/EffortTierBadge.js

@@ -0,0 +1,97 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * EffortTierBadge — 输入行尾的档位字样徽标：三幕点焰的第二幕载体
+ * （与 EffortInputBorder 的双框扫光同一时间轴、同一触发），切到最高
+ * 思考强度档时光带行至中段，输入行居中浮现档名（当前档名大写，字母间距从
+ * 10 个空格减速聚拢到 1 个——连续位置逐字母取整保证帧帧有移动，
+ * 明亮蓝加粗，由暗渐亮），随后随图层整体渐隐让位——行数恒定，静
+ * 止时完全不渲染；输入行有文字时不显示（绝不遮挡内容）。
+ *
+ * 触发判定在渲染期做（props-变化-调整模式，与边框/充能组件同模
+ * 式）；冷启动恢复偏好/单档表/无档位表/无共享时钟均不触发。时钟
+ * 复用 Ink core 共享时钟，仅动画窗口订阅（keepAlive），播完归零。
+ */
+import { useContext, useEffect, useReducer, useState } from 'react';
+import { Text } from '../ui.js';
+import { ClockContext } from '../ink/components/ClockContext.js';
+import { rgbString } from '../trajectory/motion.js';
+import { IGNITION_TIMELINE, ignitionHues } from '../trajectory/effortIgnition.js';
+/** 字母间距聚拢：从 10 个空格减速收敛到 1 个（ease-out，快收慢停）。 */
+const GAP_START = 10;
+const GAP_END = 1;
+const CONVERGE_MS = 500;
+export function EffortTierBadge({ effort, levels, onLight, columns, leadingColumns, }) {
+    const clock = useContext(ClockContext);
+    const [overlay, setOverlay] = useState(null);
+    const [prevEffort, setPrevEffort] = useState(effort);
+    const [, forceRender] = useReducer((tick) => tick + 1, 0);
+    // 渲染期触发（与边框/充能同模式）：effort 变化的首帧就以新状态渲染。
+    if (effort !== prevEffort) {
+        setPrevEffort(effort);
+        if (clock !== null &&
+            effort !== undefined &&
+            levels !== undefined &&
+            levels.length > 1 &&
+            effort === levels[levels.length - 1]) {
+            setOverlay({ label: effort.toUpperCase(), startedAtMs: clock.now() });
+        }
+    }
+    const elapsedMs = overlay === null ? Infinity : Math.max(0, (clock?.now() ?? Date.now()) - overlay.startedAtMs);
+    useEffect(() => {
+        if (overlay === null || clock === null)
+            return;
+        return clock.subscribe(() => forceRender(), /* keepAlive */ true);
+    }, [overlay, clock]);
+    useEffect(() => {
+        if (overlay !== null && elapsedMs >= IGNITION_TIMELINE.fadeEndMs)
+            setOverlay(null);
+    }, [overlay, elapsedMs]);
+    if (overlay === null || elapsedMs < IGNITION_TIMELINE.labelStartMs)
+        return null;
+    const brighten = Math.min(1, (elapsedMs - IGNITION_TIMELINE.labelStartMs) / IGNITION_TIMELINE.labelBrightenMs);
+    const fade = elapsedMs < IGNITION_TIMELINE.fadeStartMs
+        ? 1
+        : Math.max(0, 1 - (elapsedMs - IGNITION_TIMELINE.fadeStartMs) / (IGNITION_TIMELINE.fadeEndMs - IGNITION_TIMELINE.fadeStartMs));
+    const alpha = brighten * fade;
+    if (alpha <= 0)
+        return null;
+    const band = onLight ? { r: 240, g: 240, b: 242 } : { r: 27, g: 30, b: 40 };
+    // 明亮蓝：accent 混白 35% 提亮（用户拍板的高亮观感）。
+    const hue = ignitionHues(onLight)[0];
+    const whiten = (x) => Math.round(x + (255 - x) * 0.35);
+    const bright = { r: whiten(hue.r), g: whiten(hue.g), b: whiten(hue.b) };
+    const mix = (x, y) => Math.round(x + (y - x) * alpha);
+    const color = rgbString({ r: mix(band.r, bright.r), g: mix(band.g, bright.g), b: mix(band.b, bright.b) });
+    // 字母间距聚拢（Codex 的 converge 语义）：间距是连续浮点，字母位置
+    // 以**行中心为锚**对称收缩——pos_i = center + (i-(n-1)/2)·(1+gap)，
+    // 左右字母各向中心移动一半（奇数档名的居中字母原位不动），两侧速
+    // 度天然均衡；每字母独立按连续位置取整落列，不同字母在不同帧跨
+    // 格，每帧至少一个在动（把间距整体取整会让 ease-out 慢末段上百毫
+    // 秒才跨一格，看起来就是卡顿）。曲线混入 15% 线性做末段保底速度。
+    const progress = Math.min(1, Math.max(0, (elapsedMs - IGNITION_TIMELINE.labelStartMs) / CONVERGE_MS));
+    // 跳变间隔均匀化：离散格子上「减速」若靠曲线导数趋零实现，末段会
+    // 出现几十帧不动一格的长停顿再突跳（卡感来源）。改为 90% 线性 +
+    // 10% easeOutQuad 的轻缓收尾——跳变间隔全程近似恒定（约 55ms/格），
+    // 仅末端轻微放慢，终端上的观感是均匀顺滑的聚拢。
+    const eased = 1 - progress;
+    const easedWithFloor = 0.9 * eased + 0.1 * (1 - progress * progress);
+    const gapF = GAP_END + (GAP_START - GAP_END) * easedWithFloor;
+    const letterCount = overlay.label.length;
+    // 锚点是**终端几何中心**（不是 ❯/光标之后可用区的中心——那会整体
+    // 偏右约 1.5 格；可用区起点在左，其"中点"不含左部占位）。左右字母
+    // 严格镜像——Math.round 对 .5 恒向上，正负方向舍入不对称会让跨格
+    // 时刻错开；左字母的落列由右字母的舍入结果镜像得出（2C − col），
+    // M/X 每次同帧反向同跳，全程对称于终端中心。
+    const C = Math.round((columns - 1) / 2) - leadingColumns;
+    let spaced = '';
+    let column = 0;
+    for (let i = 0; i < letterCount; i++) {
+        const off = (i - (letterCount - 1) / 2) * (1 + gapF);
+        const at = off >= 0
+            ? Math.round(C + off)
+            : 2 * C - Math.round(C - off);
+        spaced += ' '.repeat(Math.max(0, at - column)) + overlay.label[i];
+        column = at + 1;
+    }
+    return (_jsx(Text, { bold: true, color: color, wrap: "truncate-end", children: spaced }));
+}

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

@@ -0,0 +1,40 @@
+/**
+ * The managed plugin dialog (`ctx.tuiDialogs`) — one panel rendering the
+ * store's current snapshot in the chat chrome (the slot approval/question
+ * panels occupy). Three kinds share one component:
+ *
+ * - `select`  — focus list (↑/↓, windowed), Enter settles the option id
+ * - `confirm` — two rows (confirm/cancel), Enter settles the boolean
+ * - `input`   — single-line text edit, Enter settles the text
+ *
+ * Esc (and Ctrl+C) always cancels — the plugin's promise resolves with the
+ * cancelled value. The panel owns the keyboard through its own useInput,
+ * the same contract as ApprovalPanel/AskUserQuestionPanel: Chat's global
+ * handler early-returns while a snapshot is pending.
+ *
+ * Two input-pipeline rules shape every handler below:
+ *
+ * - BATCHED KEYS: a terminal delivers one stdin chunk as several key events
+ *   inside a single React batch (Down+Enter arrives together), so state
+ *   queued by the first event is NOT visible to the second. Every piece of
+ *   editing state the handlers act on (focus, value, cursor) therefore
+ *   lives in a ref mutated SYNCHRONOUSLY per event; the useState mirror
+ *   only exists to re-render.
+ * - CODE POINTS: cursor movement and deletion step over whole code points
+ *   (`[...s]` iteration, same contract as the transcript search box), so an
+ *   emoji can never be split into a lone surrogate.
+ *
+ * All text arrives pre-sanitized from TuiDialogRuntime (control chars
+ * stripped, cell-width capped); the panel still renders everything through
+ * ListItem's single-line truncation.
+ */
+import React from 'react';
+import { type TuiDialogAnswer, type TuiDialogSnapshot } from '../dsh-adapter/dialogs.js';
+export type ExtensionDialogProps = {
+    /** The pending dialog (TuiDialogStore snapshot; `key` remounts per dialog). */
+    readonly dialog: TuiDialogSnapshot;
+    readonly onDecide: (value: TuiDialogAnswer) => void;
+    readonly onCancel: () => void;
+};
+export declare function ExtensionDialog({ dialog, onDecide, onCancel }: ExtensionDialogProps): React.ReactNode;
+//# sourceMappingURL=ExtensionDialog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionDialog.d.ts","sourceRoot":"","sources":["../../../src/components/ExtensionDialog.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAWzB,OAAO,EAAe,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAGrG,MAAM,MAAM,oBAAoB,GAAG;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;CAC9B,CAAA;AAED,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,oBAAoB,GAAG,KAAK,CAAC,SAAS,CASrG"}