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

package/lib/types/trajectory/effortIgnition.d.ts

@@ -7,7 +7,10 @@ export declare const IGNITION_TIMELINE: {
     readonly fadeEndMs: 2000;
 };
 /**
- * Effort ignition motion math — pure functions, zero dependencies.
+ * Effort ignition motion math — the keepers of the waveform (crest, easings,
+ * sampling, blending) are pure and dependency-free; only {@link ignitionColors}
+ * touches the palette, turning the `ignition` / `ignitionDim` theme keys into
+ * the RGB pair the math consumes.
  *
  * Waveform semantics ported from Codex CLI's effort_ignition(_styles).rs
  * (openai/codex PR #34365) and revalidated in a dsh-TUI integration: a
@@ -20,14 +23,29 @@ export declare const IGNITION_TIMELINE: {
  * the fullscreen log-update pipeline, while foreground is the channel every
  * live element already rides.
  */
-import type { RGBColor } from '../components/Spinner/spinnerUtils.js';
+import { type RGBColor } from '../components/Spinner/spinnerUtils.js';
+import { type ThemeName } from '../theme.js';
 /** 扫光全长（ms），仅用于把墙钟时间折算成动画秒数，不创建任何定时器。 */
 export declare const SWEEP_TOTAL_MS = 1000;
-export declare function ignitionHues(onLight: boolean): readonly [RGBColor, RGBColor, RGBColor];
+/** The ignition colour pair the wave, `❯` prefix and tier badge share. */
+export type IgnitionColors = {
+    /** Crest colour: the wave at full strength. */
+    ignition: RGBColor;
+    /** Resting end the wave fades into (formerly the hardcoded band colour). */
+    ignitionDim: RGBColor;
+};
+/**
+ * The active palette's ignition pair. A palette without the keys keeps the
+ * pre-theme pair for its background lightness, so light/dark still differ.
+ * 品牌在档时品牌对直接接管（与 `usedSegmentColor` 同一口径：切后端整屏换色，
+ * 与当前主题声明了什么无关）。
+ * @param themeName - Theme to resolve (built-in, `auto`, or user theme name).
+ */
+export declare function ignitionColors(themeName: ThemeName): IgnitionColors;
 /**
- * 充能色对（前缀强调用）：从带底色调暗端到全值，与波共用 hues[0]。
+ * 充能色对（前缀强调用）：从带底色调暗端到全值，与波共用 ignition。
  */
-export declare function accentRamp(onLight: boolean): {
+export declare function accentRamp(colors: IgnitionColors): {
     dim: RGBColor;
     full: RGBColor;
 };
@@ -46,14 +64,14 @@ export declare function blend(a: RGBColor, b: RGBColor, t: number): RGBColor;
  * @param options.elapsedMs - 距触发的时间；达到 {@link SWEEP_TOTAL_MS}
  *   后整行返回空数组（无波，行恢复本底）。
  * @param options.width - 行列数（终端宽）。
- * @param options.onLight - 浅色主题时用浅底色板与浅带底色。
+ * @param options.colors - 主题点火色对（{@link ignitionColors}）。
  * @returns 逐列颜色（`rgb(r,g,b)` 字符串）；无波的列为 `undefined`，
  *   渲染层应输出本底色，保持行宽恒定。
  */
 export declare function ignitionLineColors(options: {
     elapsedMs: number;
     width: number;
-    onLight: boolean;
+    colors: IgnitionColors;
 }): ReadonlyArray<string | undefined>;
 /**
  * 顶档切入判定：从「已有档位」变为「另一档位」且新档位是档位表末位

package/lib/types/trajectory/effortIgnition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effortIgnition.d.ts","sourceRoot":"","sources":["../../../src/trajectory/effortIgnition.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAA;AAEV;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAGrE,yCAAyC;AACzC,eAAO,MAAM,cAAc,OAAO,CAAA;AA8BlC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAEtF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAG9E;AAED;0CAC0C;AAC1C,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKvD;AAaD,qCAAqC;AACrC,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,CAMnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CACjB,GAAG,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,CA0BpC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACpC,OAAO,CAST;AAED,4CAA4C;AAC5C,eAAO,MAAM,SAAS,MAAM,CAAA;AAE5B,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxD"}
+{"version":3,"file":"effortIgnition.d.ts","sourceRoot":"","sources":["../../../src/trajectory/effortIgnition.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAA;AAEV;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAC/E,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AAI1E,yCAAyC;AACzC,eAAO,MAAM,cAAc,OAAO,CAAA;AAQlC,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG;IAC3B,+CAA+C;IAC/C,QAAQ,EAAE,QAAQ,CAAA;IAClB,4EAA4E;IAC5E,WAAW,EAAE,QAAQ,CAAA;CACtB,CAAA;AAwDD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,CASnE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAEpF;AAED;0CAC0C;AAC1C,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKvD;AAaD,qCAAqC;AACrC,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,CAMnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,cAAc,CAAA;CACvB,GAAG,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,CA2BpC;AAOD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACpC,OAAO,CAST;AAED,4CAA4C;AAC5C,eAAO,MAAM,SAAS,MAAM,CAAA;AAE5B,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxD"}

package/lib/types/trajectory/effortIgnition.js

@@ -6,7 +6,27 @@ export const IGNITION_TIMELINE = {
     fadeStartMs: 1500,
     fadeEndMs: 2000,
 };
+/**
+ * Effort ignition motion math — the keepers of the waveform (crest, easings,
+ * sampling, blending) are pure and dependency-free; only {@link ignitionColors}
+ * touches the palette, turning the `ignition` / `ignitionDim` theme keys into
+ * the RGB pair the math consumes.
+ *
+ * Waveform semantics ported from Codex CLI's effort_ignition(_styles).rs
+ * (openai/codex PR #34365) and revalidated in a dsh-TUI integration: a
+ * cosine-bell travelling wave produces per-column colours only — a renderer
+ * that keeps glyphs constant and changes colours per frame stays SGR-only
+ * by construction.
+ *
+ * Consumers ride the FOREGROUND channel (a constant block glyph under a
+ * varying fg colour): pure-background cells never reached the terminal in
+ * the fullscreen log-update pipeline, while foreground is the channel every
+ * live element already rides.
+ */
+import { parseRGB } from '../components/Spinner/spinnerUtils.js';
+import { getTheme, isLightThemeActive } from '../theme.js';
 import { rgbString } from './motion.js';
+import { getActiveBrand } from '../branding.js';
 /** 扫光全长（ms），仅用于把墙钟时间折算成动画秒数，不创建任何定时器。 */
 export const SWEEP_TOTAL_MS = 1000;
 /** 波形宽度参数（列）。 */
@@ -14,34 +34,81 @@ const WAVE_HALF_WIDTH = 14;
 /** 波形参数：`[launch, travel]`（秒）——扫光在何时启动、多久行至右缘。 */
 const BAND = [0.1, 0.75];
 /**
- * 高亮彩色色板：亮蓝/亮青/亮紫三 hue（浅色背景用加深变体——浅底上
- * 亮色没有对比度）。波只点亮 hues[0]，前两个 hue 留给未来的多带风格。
+ * Pre-theme pair, kept as the fallback for palettes that predate the keys
+ * (community themes): bright blue over the terminal's own substrate, with a
+ * deepened variant for light backgrounds — bright hues have no contrast there.
  */
-const HUES_DARK = [
-    { r: 130, g: 185, b: 255 },
-    { r: 140, g: 252, b: 248 },
-    { r: 195, g: 172, b: 255 },
-];
-const HUES_LIGHT = [
-    { r: 30, g: 95, b: 235 },
-    { r: 10, g: 160, b: 200 },
-    { r: 120, g: 80, b: 235 },
-];
+const FALLBACK_DARK = {
+    ignition: { r: 130, g: 185, b: 255 },
+    ignitionDim: { r: 27, g: 30, b: 40 },
+};
+const FALLBACK_LIGHT = {
+    ignition: { r: 30, g: 95, b: 235 },
+    ignitionDim: { r: 240, g: 240, b: 242 },
+};
 /**
- * 带底色（波向终端本底淡入的目标色）。近似值：取主题深/浅背景的典
- * 型值而非逐主题读取——波只存活一秒，色差在低 alpha 下不可辨。
+ * claude 品牌（cc 内核 / cc-bridge 调校）的兜底对：暖橙系，浅底取更深的橙
+ * ——亮橙在浅底上没有对比度；暗底带色取暖褐。品牌在档时接管点火取色
+ * （见 {@link ignitionColors}），与 `usedSegmentColor` 同一口径。
  */
-const BAND_DARK = { r: 27, g: 30, b: 40 };
-const BAND_LIGHT = { r: 240, g: 240, b: 242 };
-export function ignitionHues(onLight) {
-    return onLight ? HUES_LIGHT : HUES_DARK;
+const FALLBACK_DARK_CLAUDE = {
+    ignition: { r: 232, g: 145, b: 63 },
+    ignitionDim: { r: 38, g: 30, b: 22 },
+};
+const FALLBACK_LIGHT_CLAUDE = {
+    ignition: { r: 196, g: 96, b: 20 },
+    ignitionDim: { r: 240, g: 240, b: 242 },
+};
+/** 匹配 `#rgb` / `#rrggbb` / `#rrggbbaa`（`customTheme` 的 `HEX_RE` 接受的全部 hex 形式）。 */
+const HEX_COLOR = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+/**
+ * Resolve a theme colour to RGB for the gradient math. Only the forms that
+ * carry fixed channels resolve (`rgb()`, hex); `ansi:*` / `ansi256()` depend
+ * on the terminal's palette, so they take the caller's fallback — the wave
+ * emits per-column truecolor SGR either way.
+ *
+ * The 8-digit hex form is accepted because the theme-file validator accepts it
+ * (`customTheme.ts`'s `HEX_RE`); the alpha byte is dropped rather than falling
+ * back silently — the wave blends per column and has no channel for it.
+ */
+function parseThemeColor(color) {
+    if (color === undefined)
+        return null;
+    const parsed = parseRGB(color);
+    if (parsed !== null)
+        return parsed;
+    const match = HEX_COLOR.exec(color);
+    if (match === null)
+        return null;
+    const digits = match[1];
+    const opaque = digits.length === 8 ? digits.slice(0, 6) : digits;
+    const expanded = opaque.length === 3 ? opaque.replace(/./g, digit => digit + digit) : opaque;
+    const value = Number.parseInt(expanded, 16);
+    return { r: (value >> 16) & 0xff, g: (value >> 8) & 0xff, b: value & 0xff };
+}
+/**
+ * The active palette's ignition pair. A palette without the keys keeps the
+ * pre-theme pair for its background lightness, so light/dark still differ.
+ * 品牌在档时品牌对直接接管（与 `usedSegmentColor` 同一口径：切后端整屏换色，
+ * 与当前主题声明了什么无关）。
+ * @param themeName - Theme to resolve (built-in, `auto`, or user theme name).
+ */
+export function ignitionColors(themeName) {
+    const onLight = isLightThemeActive(themeName);
+    if (getActiveBrand() === 'claude')
+        return onLight ? FALLBACK_LIGHT_CLAUDE : FALLBACK_DARK_CLAUDE;
+    const theme = getTheme(themeName);
+    const fallback = onLight ? FALLBACK_LIGHT : FALLBACK_DARK;
+    return {
+        ignition: parseThemeColor(theme.ignition) ?? fallback.ignition,
+        ignitionDim: parseThemeColor(theme.ignitionDim) ?? fallback.ignitionDim,
+    };
 }
 /**
- * 充能色对（前缀强调用）：从带底色调暗端到全值，与波共用 hues[0]。
+ * 充能色对（前缀强调用）：从带底色调暗端到全值，与波共用 ignition。
  */
-export function accentRamp(onLight) {
-    const band = onLight ? BAND_LIGHT : BAND_DARK;
-    return { dim: blend(band, ignitionHues(onLight)[0], 0.45), full: ignitionHues(onLight)[0] };
+export function accentRamp(colors) {
+    return { dim: blend(colors.ignitionDim, colors.ignition, 0.45), full: colors.ignition };
 }
 /** 余弦钟形：`crest(0)=1`、`crest(±1)=0`、之外为 0（负距离同样静默——
  * 现有调用方都传 `Math.abs`，这里兜底防未来调用方拿到全强度）。 */
@@ -89,37 +156,42 @@ export function blend(a, b, t) {
  * @param options.elapsedMs - 距触发的时间；达到 {@link SWEEP_TOTAL_MS}
  *   后整行返回空数组（无波，行恢复本底）。
  * @param options.width - 行列数（终端宽）。
- * @param options.onLight - 浅色主题时用浅底色板与浅带底色。
+ * @param options.colors - 主题点火色对（{@link ignitionColors}）。
  * @returns 逐列颜色（`rgb(r,g,b)` 字符串）；无波的列为 `undefined`，
  *   渲染层应输出本底色，保持行宽恒定。
  */
 export function ignitionLineColors(options) {
-    const { elapsedMs, width, onLight } = options;
+    const { elapsedMs, width, colors } = options;
     const elapsed = elapsedMs / 1000;
     const total = SWEEP_TOTAL_MS / 1000;
     if (width <= 0 || !Number.isFinite(elapsed) || elapsed <= 0 || elapsed >= total)
         return [];
-    const hue = ignitionHues(onLight)[0];
-    const band = onLight ? BAND_LIGHT : BAND_DARK;
-    const colors = new Array(width);
+    const hue = colors.ignition;
+    const band = colors.ignitionDim;
+    const line = new Array(width);
     for (let column = 0; column < width; column++) {
         const weight = sampleColumn(elapsed, column, width)[0];
         if (weight <= 0.01) {
-            colors[column] = undefined;
+            line[column] = undefined;
             continue;
         }
         // 波按强度淡入带底色：alpha=1 是纯 hue，alpha→0 收敛回本底；高亮
         // 度档满强度纯 hue 直出。输出前通道量化到 8 步长——渐变列因此能
         // 合并成长段（渲染层 RLE 段数降一个数量级），8/256 的色差在终端
-        // cell 分辨率下不可辨。
+        // cell 分辨率下不可辨。上限 255：主题可以给纯白/纯亮色，量化不得
+        // 溢出成 256。
         const tinted = blend(band, hue, Math.min(weight, 1));
-        colors[column] = rgbString({
-            r: Math.round(tinted.r / 8) * 8,
-            g: Math.round(tinted.g / 8) * 8,
-            b: Math.round(tinted.b / 8) * 8,
+        line[column] = rgbString({
+            r: quantize(tinted.r),
+            g: quantize(tinted.g),
+            b: quantize(tinted.b),
         });
     }
-    return colors;
+    return line;
+}
+/** 通道量化到 8 步长，clamp 到 255（255 → 256 是非法 SGR 分量）。 */
+function quantize(channel) {
+    return Math.min(255, Math.round(channel / 8) * 8);
 }
 /**
  * 顶档切入判定：从「已有档位」变为「另一档位」且新档位是档位表末位

package/lib/types/trajectory/window.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Ledger windowing shared by the fullscreen scene and the side panel: both
+ * paint exactly one viewport's worth of rows and keep the focused row
+ * visible, so a ten-thousand-row session costs the same frame as a ten-row
+ * one. Properties (verify-trajectory-xl):
+ *
+ * - the window is rows tall (or as tall as the list allows);
+ * - the focused row sits inside it, centered while room allows;
+ * - it never starts before 0 nor past the last full page;
+ * - an empty list windows to (0, rows) and paints nothing.
+ */
+/**
+ * The cursor-centered ledger window.
+ *
+ * @param count - Length of the (possibly filtered) row list.
+ * @param cursor - Focused row index (clamped here; callers may hold a
+ *   stale cursor for one frame after a filter narrows the list).
+ * @param rows - Viewport row budget (>= 1).
+ * @returns start = first painted row index, end = one past the last
+ *   (may exceed count; slicing on end is always safe).
+ */
+export declare function ledgerWindow(count: number, cursor: number, rows: number): {
+    start: number;
+    end: number;
+};
+//# sourceMappingURL=window.d.ts.map

package/lib/types/trajectory/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../../src/trajectory/window.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAKxG"}

package/lib/types/trajectory/window.js

@@ -0,0 +1,27 @@
+/**
+ * Ledger windowing shared by the fullscreen scene and the side panel: both
+ * paint exactly one viewport's worth of rows and keep the focused row
+ * visible, so a ten-thousand-row session costs the same frame as a ten-row
+ * one. Properties (verify-trajectory-xl):
+ *
+ * - the window is rows tall (or as tall as the list allows);
+ * - the focused row sits inside it, centered while room allows;
+ * - it never starts before 0 nor past the last full page;
+ * - an empty list windows to (0, rows) and paints nothing.
+ */
+/**
+ * The cursor-centered ledger window.
+ *
+ * @param count - Length of the (possibly filtered) row list.
+ * @param cursor - Focused row index (clamped here; callers may hold a
+ *   stale cursor for one frame after a filter narrows the list).
+ * @param rows - Viewport row budget (>= 1).
+ * @returns start = first painted row index, end = one past the last
+ *   (may exceed count; slicing on end is always safe).
+ */
+export function ledgerWindow(count, cursor, rows) {
+    const height = Math.max(1, rows);
+    const clamped = count === 0 ? 0 : Math.max(0, Math.min(cursor, count - 1));
+    const start = Math.max(0, Math.min(clamped - Math.floor(height / 2), Math.max(0, count - height)));
+    return { start, end: start + height };
+}

package/lib/types/tuiDisplayPrefs.d.ts

@@ -1,9 +1,11 @@
-import type { ToolBackground, ScrollGutterMode, PageMarginSetting, PageMarginMode, PageMarginSpec, StatusBarConfig } from './adapter/ports/channel-display.js';
-export type { ToolBackground, ScrollGutterMode, PageMarginSetting, PageMarginMode, PageMarginSpec, StatusBarConfig } from './adapter/ports/channel-display.js';
+import type { ToolBackground, ScrollGutterMode, PageMarginSetting, PageMarginMode, PageMarginSpec, StatusBarConfig, JobGroupFoldMode } from './adapter/ports/channel-display.js';
+export type { ToolBackground, ScrollGutterMode, PageMarginSetting, PageMarginMode, PageMarginSpec, StatusBarConfig, JobGroupFoldMode } from './adapter/ports/channel-display.js';
 /** Defaults keep the essential route/context information visible. */
 export declare const DEFAULT_STATUS_BAR: Readonly<StatusBarConfig>;
 /** Normalize untrusted/config-layer values without mutating the input. */
 export declare function normalizeToolBackground(value: unknown): ToolBackground;
+/** Same normalize contract as toolBackground; `auto` is the default. */
+export declare function normalizeJobGroupFold(value: unknown): JobGroupFoldMode;
 /** Same normalize contract as toolBackground; `timeline` is the default. */
 export declare function normalizeScrollGutter(value: unknown): ScrollGutterMode;
 /** Merge a partial settings value over the stable status-bar defaults. */
@@ -46,6 +48,20 @@ export declare const applyPageMargin: (value: unknown) => PageMarginSetting;
 export declare const subscribeMermaidDiagrams: (listener: () => void) => () => void;
 export declare const getMermaidDiagrams: () => boolean;
 export declare const applyMermaidDiagrams: (value: unknown) => boolean;
+/**
+ * How fenced code blocks frame themselves (settings
+ *  `dsh-tui.codeFrameStyle`): `light` (default) is the open rail frame
+ * — corner + language label on top, a left rail with one padding
+ * column, no right wall or bottom edge; `full` closes the box with a
+ * right wall (continuous across wrapped rows, it rides the layout
+ * border) and a bottom edge. The narrow-terminal fallback (net body
+ * width < 8) always stays the plain ANSI fence, whatever this says.
+ */
+export type CodeFrameStyle = 'light' | 'full';
+export declare function normalizeCodeFrameStyle(value: unknown): CodeFrameStyle;
+export declare const subscribeCodeFrameStyle: (listener: () => void) => () => void;
+export declare const getCodeFrameStyle: () => CodeFrameStyle;
+export declare const applyCodeFrameStyle: (value: unknown) => CodeFrameStyle;
 /**
  * How LaTeX math in replies renders (settings `dsh-tui.mathRendering`):
  * `auto` picks the best available backend (today the Unicode renderer),
@@ -113,4 +129,65 @@ export declare function normalizeImageBacking(value: unknown): ImageBacking;
 export declare const subscribeImageBacking: (listener: () => void) => () => void;
 export declare const getImageBacking: () => ImageBacking;
 export declare const applyImageBacking: (value: unknown) => ImageBacking;
+/** Panel id grammar (plugins register under a `plugin:sub` namespace). */
+export declare const SIDE_PANEL_ID_PATTERN: RegExp;
+export declare const DEFAULT_SIDE_PANEL_IDS = "todo,jobs,agents,info,trajectory,workspace,btw,companion";
+/** Chat fraction of the content width; junk collapses to the default and
+ *  the value is sanity-clamped (geometry clamps further per width). */
+export declare function normalizeSidePanelRatio(value: unknown): number;
+/** Comma-separated enabled-panel ids: tokens that fail the id grammar are
+ *  dropped (a typo must never wedge the layout); unknown-but-well-formed
+ *  ids survive — a plugin may register them later in the session. */
+export declare function normalizeSidePanelPanels(value: unknown): string;
+/** Enabled panel ids in PanelBar order. */
+export declare function parseSidePanelIds(value: string): readonly string[];
+export declare const subscribeSidePanelSplitEnabled: (listener: () => void) => () => void;
+export declare const getSidePanelSplitEnabled: () => boolean;
+export declare const applySidePanelSplitEnabled: (value: unknown) => boolean;
+export declare const subscribeSidePanelOpen: (listener: () => void) => () => void;
+export declare const getSidePanelOpen: () => boolean;
+export declare const applySidePanelOpen: (value: unknown) => boolean;
+export declare const subscribeSidePanelRatio: (listener: () => void) => () => void;
+export declare const getSidePanelRatio: () => number;
+export declare const applySidePanelRatio: (value: unknown) => number;
+export declare const subscribeSidePanelPanels: (listener: () => void) => () => void;
+export declare const getSidePanelPanels: () => string;
+export declare const applySidePanelPanels: (value: unknown) => string;
+/**
+ * btw 线程上下文设置（设置 `dsh-tui.btw.*`）：追问携带的最近完成轮数
+ * 与总字符预算。clamp 规则与线程 store 的防御性钳制（sidePanel/btw/
+ * threads.ts 的 normalizeRecentTurnsLimit / selectContextTurns）一致——
+ * 两道闸门同规则，先到者生效；这里管 /settings 与 cordis.yml 的入口，
+ * store 侧兜住不经设置的直接调用。
+ */
+export declare const BTW_CONTEXT_TURNS_MIN = 1;
+export declare const BTW_CONTEXT_TURNS_MAX = 8;
+export declare const BTW_CONTEXT_TURNS_DEFAULT = 4;
+/** 总预算下限护住单答派生（perAnswer = min(8k, budget/2)）：再小就只剩
+ *  当前问句本身，上下文功能名存实亡。 */
+export declare const BTW_CONTEXT_BUDGET_MIN = 1000;
+export declare const BTW_CONTEXT_BUDGET_MAX = 200000;
+export declare const BTW_CONTEXT_BUDGET_DEFAULT = 24000;
+export declare function normalizeBtwContextTurns(value: unknown): number;
+export declare function normalizeBtwContextBudget(value: unknown): number;
+export declare const subscribeBtwContextTurns: (listener: () => void) => () => void;
+export declare const getBtwContextTurns: () => number;
+export declare const applyBtwContextTurns: (value: unknown) => number;
+export declare const subscribeBtwContextBudget: (listener: () => void) => () => void;
+export declare const getBtwContextBudget: () => number;
+export declare const applyBtwContextBudget: (value: unknown) => number;
+/**
+ * Companion 皮肤（设置 `dsh-tui.companion.skin`）：内置 'deepy'（默认，
+ * assets/deepy 素材包）、'whaleGirl'（用户提供的鲸娘素材包，assets/
+ * whaleGirl）与 'whale'（开屏像素鲸鱼同款分层动画）；插件
+ * 皮肤 id（'plugin:sub' 命名空间）随 Phase 7 开放注册后同样可写——
+ * 未注册/未知的 id 一律回退 deepy，不阻断启动。
+ */
+export type CompanionSkinSetting = string;
+export declare const COMPANION_SKIN_IDS: readonly ["deepy", "whaleGirl", "whale"];
+export declare const DEFAULT_COMPANION_SKIN: CompanionSkinSetting;
+export declare function normalizeCompanionSkin(value: unknown): CompanionSkinSetting;
+export declare const subscribeCompanionSkin: (listener: () => void) => () => void;
+export declare const getCompanionSkin: () => string;
+export declare const applyCompanionSkin: (value: unknown) => string;
 //# sourceMappingURL=tuiDisplayPrefs.d.ts.map

package/lib/types/tuiDisplayPrefs.d.ts.map

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

package/lib/types/tuiDisplayPrefs.js

@@ -24,6 +24,7 @@ export const DEFAULT_STATUS_BAR = Object.freeze({
     shortcutHint: false,
 });
 const TOOL_BACKGROUNDS = new Set(['none', 'subtle', 'strong']);
+const JOB_GROUP_FOLDS = new Set(['auto', 'always', 'never']);
 const SCROLL_GUTTERS = new Set(['timeline', 'scrollbar', 'hidden']);
 const STATUS_BAR_KEYS = Object.keys(DEFAULT_STATUS_BAR);
 /** Normalize untrusted/config-layer values without mutating the input. */
@@ -32,6 +33,12 @@ export function normalizeToolBackground(value) {
         ? value
         : 'none';
 }
+/** Same normalize contract as toolBackground; `auto` is the default. */
+export function normalizeJobGroupFold(value) {
+    return typeof value === 'string' && JOB_GROUP_FOLDS.has(value)
+        ? value
+        : 'auto';
+}
 /** Same normalize contract as toolBackground; `timeline` is the default. */
 export function normalizeScrollGutter(value) {
     return typeof value === 'string' && SCROLL_GUTTERS.has(value)
@@ -166,6 +173,17 @@ const mermaidDiagramsStore = createLiveSetting(true, value => value !== false);
 export const subscribeMermaidDiagrams = mermaidDiagramsStore.subscribe;
 export const getMermaidDiagrams = mermaidDiagramsStore.get;
 export const applyMermaidDiagrams = mermaidDiagramsStore.apply;
+const CODE_FRAME_STYLES = new Set(['light', 'full']);
+export function normalizeCodeFrameStyle(value) {
+    return typeof value === 'string' && CODE_FRAME_STYLES.has(value)
+        ? value
+        : 'light';
+}
+/** Read at render time, so settled code blocks re-render on change. */
+const codeFrameStyleStore = createLiveSetting('light', normalizeCodeFrameStyle);
+export const subscribeCodeFrameStyle = codeFrameStyleStore.subscribe;
+export const getCodeFrameStyle = codeFrameStyleStore.get;
+export const applyCodeFrameStyle = codeFrameStyleStore.apply;
 const MATH_RENDERING_MODES = new Set(['auto', 'image', 'unicode', 'source']);
 export function normalizeMathRendering(value) {
     return typeof value === 'string' && MATH_RENDERING_MODES.has(value)
@@ -225,3 +243,103 @@ const imageBackingStore = createLiveSetting('transparent', normalizeImageBacking
 export const subscribeImageBacking = imageBackingStore.subscribe;
 export const getImageBacking = imageBackingStore.get;
 export const applyImageBacking = imageBackingStore.apply;
+// ── Side panel (侧栏) ────────────────────────────────────────────────
+// Settings `dsh-tui.sidePanel.*`. These are module-level live stores (not
+// channel state): the layout needs them above the channel's version bump —
+// a Ctrl+B toggle must re-render Chat even though nothing about the
+// session changed — and /settings + cordis.yml write through the same
+// apply* functions (plugin's applyDisplay mirrors them here, exactly like
+// pageMargin). Key toggles are session-level: they move the live store but
+// never write the user settings layer, so a restart returns to the
+// configured default.
+/** Panel id grammar (plugins register under a `plugin:sub` namespace). */
+export const SIDE_PANEL_ID_PATTERN = /^[a-z][a-z0-9_-]*(:[a-z][a-z0-9_-]*)*$/;
+export const DEFAULT_SIDE_PANEL_IDS = 'todo,jobs,agents,info,trajectory,workspace,btw,companion';
+function normalizeBoolean(value, fallback) {
+    return typeof value === 'boolean' ? value : fallback;
+}
+/** Chat fraction of the content width; junk collapses to the default and
+ *  the value is sanity-clamped (geometry clamps further per width). */
+export function normalizeSidePanelRatio(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return 0.68;
+    return Math.min(0.95, Math.max(0.1, value));
+}
+/** Comma-separated enabled-panel ids: tokens that fail the id grammar are
+ *  dropped (a typo must never wedge the layout); unknown-but-well-formed
+ *  ids survive — a plugin may register them later in the session. */
+export function normalizeSidePanelPanels(value) {
+    if (typeof value !== 'string')
+        return DEFAULT_SIDE_PANEL_IDS;
+    const seen = new Set();
+    for (const token of value.split(',')) {
+        const id = token.trim().toLowerCase();
+        if (id !== '' && SIDE_PANEL_ID_PATTERN.test(id))
+            seen.add(id);
+    }
+    return seen.size > 0 ? [...seen].join(',') : DEFAULT_SIDE_PANEL_IDS;
+}
+/** Enabled panel ids in PanelBar order. */
+export function parseSidePanelIds(value) {
+    return normalizeSidePanelPanels(value).split(',');
+}
+const sidePanelSplitEnabledStore = createLiveSetting(true, value => normalizeBoolean(value, true));
+export const subscribeSidePanelSplitEnabled = sidePanelSplitEnabledStore.subscribe;
+export const getSidePanelSplitEnabled = sidePanelSplitEnabledStore.get;
+export const applySidePanelSplitEnabled = sidePanelSplitEnabledStore.apply;
+const sidePanelOpenStore = createLiveSetting(false, value => normalizeBoolean(value, false));
+export const subscribeSidePanelOpen = sidePanelOpenStore.subscribe;
+export const getSidePanelOpen = sidePanelOpenStore.get;
+export const applySidePanelOpen = sidePanelOpenStore.apply;
+const sidePanelRatioStore = createLiveSetting(0.68, normalizeSidePanelRatio);
+export const subscribeSidePanelRatio = sidePanelRatioStore.subscribe;
+export const getSidePanelRatio = sidePanelRatioStore.get;
+export const applySidePanelRatio = sidePanelRatioStore.apply;
+const sidePanelPanelsStore = createLiveSetting(DEFAULT_SIDE_PANEL_IDS, normalizeSidePanelPanels);
+export const subscribeSidePanelPanels = sidePanelPanelsStore.subscribe;
+export const getSidePanelPanels = sidePanelPanelsStore.get;
+export const applySidePanelPanels = sidePanelPanelsStore.apply;
+/**
+ * btw 线程上下文设置（设置 `dsh-tui.btw.*`）：追问携带的最近完成轮数
+ * 与总字符预算。clamp 规则与线程 store 的防御性钳制（sidePanel/btw/
+ * threads.ts 的 normalizeRecentTurnsLimit / selectContextTurns）一致——
+ * 两道闸门同规则，先到者生效；这里管 /settings 与 cordis.yml 的入口，
+ * store 侧兜住不经设置的直接调用。
+ */
+export const BTW_CONTEXT_TURNS_MIN = 1;
+export const BTW_CONTEXT_TURNS_MAX = 8;
+export const BTW_CONTEXT_TURNS_DEFAULT = 4;
+/** 总预算下限护住单答派生（perAnswer = min(8k, budget/2)）：再小就只剩
+ *  当前问句本身，上下文功能名存实亡。 */
+export const BTW_CONTEXT_BUDGET_MIN = 1_000;
+export const BTW_CONTEXT_BUDGET_MAX = 200_000;
+export const BTW_CONTEXT_BUDGET_DEFAULT = 24_000;
+export function normalizeBtwContextTurns(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return BTW_CONTEXT_TURNS_DEFAULT;
+    return Math.min(BTW_CONTEXT_TURNS_MAX, Math.max(BTW_CONTEXT_TURNS_MIN, Math.round(value)));
+}
+export function normalizeBtwContextBudget(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return BTW_CONTEXT_BUDGET_DEFAULT;
+    return Math.min(BTW_CONTEXT_BUDGET_MAX, Math.max(BTW_CONTEXT_BUDGET_MIN, Math.round(value)));
+}
+const btwContextTurnsStore = createLiveSetting(BTW_CONTEXT_TURNS_DEFAULT, normalizeBtwContextTurns);
+export const subscribeBtwContextTurns = btwContextTurnsStore.subscribe;
+export const getBtwContextTurns = btwContextTurnsStore.get;
+export const applyBtwContextTurns = btwContextTurnsStore.apply;
+const btwContextBudgetStore = createLiveSetting(BTW_CONTEXT_BUDGET_DEFAULT, normalizeBtwContextBudget);
+export const subscribeBtwContextBudget = btwContextBudgetStore.subscribe;
+export const getBtwContextBudget = btwContextBudgetStore.get;
+export const applyBtwContextBudget = btwContextBudgetStore.apply;
+export const COMPANION_SKIN_IDS = ['deepy', 'whaleGirl', 'whale'];
+export const DEFAULT_COMPANION_SKIN = 'deepy';
+export function normalizeCompanionSkin(value) {
+    if (typeof value === 'string' && COMPANION_SKIN_IDS.includes(value))
+        return value;
+    return DEFAULT_COMPANION_SKIN;
+}
+const companionSkinStore = createLiveSetting(DEFAULT_COMPANION_SKIN, normalizeCompanionSkin);
+export const subscribeCompanionSkin = companionSkinStore.subscribe;
+export const getCompanionSkin = companionSkinStore.get;
+export const applyCompanionSkin = companionSkinStore.apply;