@tian.zuo/pi-beautify-style 0.0.0-stage → 0.2.0

package/ATTRIBUTION.md

@@ -0,0 +1,49 @@
+# Attribution
+
+`pi-beautify-style` is a fork. Most of the code under `extensions/` is vendored
+verbatim from upstream projects and then adapted to this monorepo.
+
+## pi-cc-extensions
+
+The Claude Code-style TUI — tool cards, compact mode, rich diffs, footer chips,
+`/context`, session/subagent references, mouse interaction, and the bundled
+Rendering approach — comes from
+[minuque/pi-cc-extensions](https://github.com/minuque/pi-cc-extensions)
+(commit `4b93074`), Copyright (c) 2026 minuque, used under the MIT License.
+
+Local changes are marked with comments in the affected files. They are:
+
+- `ask_user` (from `@tian.zuo/pi-ask-user`) reuses the `ask_user_question`
+  card, including its `choice: { label, wasCustom }` answer shape.
+- `terminal_wait`, `terminal_stop`, and `terminal_log_read` (from
+  `@tian.zuo/pi-background-terminals`) reuse the shell card and timing path.
+- The footer treats `setStatus("usage")` — the key used by
+  `@tian.zuo/pi-usage` — as the usage chip.
+
+## pi-tool-display
+
+The rich diff renderer under `extensions/renderer/tool/diff/` is adapted from
+[MasuRii/pi-tool-display](https://github.com/MasuRii/pi-tool-display) at commit
+`91cef7580078371f8dc49a8607222807ad6a424d`, Copyright (c) MasuRii and
+pi-tool-display contributors, used under the MIT License. The upstream notice
+is reproduced in `extensions/renderer/tool/diff/ATTRIBUTION.md`.
+
+## MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/CHANGELOG.md

@@ -0,0 +1,144 @@
+# @tian.zuo/pi-beautify-style
+
+## 0.2.0
+
+### Minor Changes
+
+- [#176](https://github.com/TianZuo555/pi-extensions/pull/176) [`69f9f0e`](https://github.com/TianZuo555/pi-extensions/commit/69f9f0eba56e00d7b29ca28d6f757da5018ac542) Thanks [@TianZuo555](https://github.com/TianZuo555)! - First published release.
+  
+  `@tian.zuo/pi-beautify-style` replaces `@tian.zuo/pi-compact-output` with a vendored Claude Code-style TUI: tool cards, rich diffs, a status footer, `/context`, `@session` and `@subagent` references, and integrations for this repository's `ask_user`, background-terminal, and usage extensions.
+  
+  The rendering stack comes from `minuque/pi-cc-extensions` (MIT, see `ATTRIBUTION.md`), so this repository owns it. Install this package instead of `npm:pi-cc-extensions` — both patch `ToolExecutionComponent` and must not run together.
+  
+  There is no runtime configuration. Render mode, diff layout, footer chips, and the reasoning preview length are source constants in `extensions/config/config.ts`. The package ships no theme files; every color comes from the active Pi theme.
+
+- [#171](https://github.com/TianZuo555/pi-extensions/pull/171) [`8aad15a`](https://github.com/TianZuo555/pi-extensions/commit/8aad15a5d566564b39f6b8dd0e3c79e8aafdc46d) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Remove runtime configuration.
+  
+  The package no longer has a settings surface. Gone:
+  
+  - the `/ccstyle` command (`on` / `compact` / `off` / `status` / `panel`)
+  - the six-tab settings panel (`extensions/config/panel.ts`)
+  - `~/.pi/agent/pi-beautify-style.json`, including the migration from
+    `pi-cc-extensions.json` and `claude-code-style.json`
+  
+  Every knob — render mode, diff layout, footer chips, reasoning preview length,
+  `@` reference features — is now a source constant in
+  `extensions/config/config.ts`. Edit that file and restart Pi to change
+  behavior. Any existing `pi-beautify-style.json` is ignored and can be deleted.
+  
+  Render mode is fixed to `"on"` (Claude Code tool cards with rich diffs).
+
+- [#171](https://github.com/TianZuo555/pi-extensions/pull/171) [`8aad15a`](https://github.com/TianZuo555/pi-extensions/commit/8aad15a5d566564b39f6b8dd0e3c79e8aafdc46d) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Remove the custom startup header.
+  
+  The package no longer paints its own banner over Pi's built-in header, and the `showStartupHeader` option is gone from the config file, the `/ccstyle panel`, and `/ccstyle status`. Any local `showStartupHeader` value is ignored on load.
+  
+  This frees the `ctx.ui.setHeader()` slot for whichever extension the user actually wants there — this repo's `welcome` extension, for example — instead of competing with it.
+
+- [#171](https://github.com/TianZuo555/pi-extensions/pull/171) [`8aad15a`](https://github.com/TianZuo555/pi-extensions/commit/8aad15a5d566564b39f6b8dd0e3c79e8aafdc46d) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Remove the bundled `cc-dark` and `cc-light` themes.
+  
+  The package now renders entirely through the active Pi theme. Every color —
+  tool cards, diffs, reasoning, footer chips — comes from the theme's slots
+  (`toolSuccessBg`, `toolErrorBg`, `dim`, `accent`, …), so whichever theme you run
+  applies as-is.
+  
+  `package.json` no longer declares `pi.themes` or ships a `themes/` directory.
+  If you selected `cc-dark` or `cc-light` from this package, switch to another
+  theme; those two names will not resolve after upgrading.
+
+### Patch Changes
+
+- [#171](https://github.com/TianZuo555/pi-extensions/pull/171) [`8aad15a`](https://github.com/TianZuo555/pi-extensions/commit/8aad15a5d566564b39f6b8dd0e3c79e8aafdc46d) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Address three review findings.
+  
+  **Narrow terminals.** The footer prepended its editor-alignment indent before clamping the payload, so a width smaller than the indent still emitted at least one payload column plus the full indent — `render(1)` produced three columns. `indentFooterLine` now clamps the indent to the width first and gives the payload whatever remains, down to zero.
+  
+  **Prompt separation.** The `@session:[...]` header, including the instruction that referenced sessions are untrusted context, was inlined in `extensions/feature/reference/session.ts`. It moved to `lib/prompt.ts` as `SESSION_REFERENCE_HEADER`, next to the subagent delegation text, so all model-facing wording lives in one auditable place.
+  
+  **Main-screen patch cleanup.** `installMainScreenDoRenderPatch` patched `TuiMainScreen.prototype.applyLineResets` but returned nothing, so unloading the extension left the stale-scrollback behavior active until the process restarted. It now returns an ownership-guarded disposer, called from `session_shutdown`, that restores the original method only when the slot still holds this installation.
+
+- [#193](https://github.com/TianZuo555/pi-extensions/pull/193) [`b49c918`](https://github.com/TianZuo555/pi-extensions/commit/b49c9184ecc729eb60fe69800b8086af19cecb06) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Keep the input box in place when a block collapses.
+  
+  In regular TUI mode the whole frame is one line buffer: transcript, then the input dock (status line, editor, footer). When a block inside the viewport got shorter — the reasoning window shrinking from five rows to the `Thought for …` row, or a tool card collapsing — the renderer moved the whole tail up, so the input box jumped a few rows and left blank rows at the bottom.
+  
+  The regular-mode patch now adds the lost rows as blank filler just above the input dock, and moves the hardware cursor by the same offset. The dock keeps its screen rows; the gap appears at the end of the transcript and new output fills it again. Sessions with a transcript shorter than the terminal no longer jump at the end of every reasoning pass.
+  
+  The patch finds the dock by the editor block that the editor rendered in the same frame. Multi-line input that contains a pasted shell prompt (`  ❯ npm test`) no longer splits the input box.
+
+- [#177](https://github.com/TianZuo555/pi-extensions/pull/177) [`33fd5ae`](https://github.com/TianZuo555/pi-extensions/commit/33fd5ae9fea337ca9e2d8c44d271b5ec9a7fdc9a) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Clip the long session and branch names in the footer.
+  
+  `footerLabelClip` (default 16) limits the session name and the branch name. A longer name keeps its head and ends with `…`, so `fix/beautify-style-review` shows as `fix/beautify-sty…`. The change stats after the branch name do not move. Set it to `0` to show the full names.
+
+- [#177](https://github.com/TianZuo555/pi-extensions/pull/177) [`33fd5ae`](https://github.com/TianZuo555/pi-extensions/commit/33fd5ae9fea337ca9e2d8c44d271b5ec9a7fdc9a) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Lay the footer out in three fixed rows so plugin chips never crowd the location
+  line.
+  
+  Row 1 keeps the builtin statistics (model, context, cache, rate, cost). Row 2
+  keeps the location (cwd, session name, branch) plus the MCP server count, which
+  this package draws itself. Row 3 collects every other extension's `setStatus()`
+  text, including `pi-usage`.
+  
+  Before this change, plugin chips were appended to row 2 next to the cwd and
+  branch, and any `usage`/`quota`/`balance` key went to row 1. The footer grew
+  sideways as extensions registered status text. Now the first two rows stay
+  stable and row 3 is the only one that flexes. Row 3 stays hidden while no plugin
+  publishes text, so the footer still shrinks to two rows when quiet.
+  
+  Remove the line-assignment helpers (`moveFooterKeyToLine`, `shiftFooterKeyLine`,
+  `reorderFooterKey`, `toggleFooterKeyHidden`, `resolveFooterChipLayout`,
+  `normalizeFooterChipLayout`, `defaultFooterLine`) and the `footerLine1Keys` /
+  `footerLine2Keys` / `footerLine3Keys` config fields. They existed for a settings
+  panel this package no longer has, and the rows are no longer user-assigned.
+  `footerHiddenKeys` stays: it still hides a plugin chip on row 3.
+  
+  The MCP chip no longer enters the plugin channel. It is location information,
+  so it sits on row 2 next to the branch, and a third-party `mcp` status still
+  suppresses the builtin one to avoid a duplicate chip.
+
+- [#177](https://github.com/TianZuo555/pi-extensions/pull/177) [`33fd5ae`](https://github.com/TianZuo555/pi-extensions/commit/33fd5ae9fea337ca9e2d8c44d271b5ec9a7fdc9a) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Stream reasoning in a five-row window, hide it when the run ends, and open it
+  with `ctrl+t`.
+  
+  While a thinking run streams, the card shows at most `liveThinkingLines`
+  (default `5`) rows. Newer reasoning pushes older rows up out of the window, so
+  the block stays a stable height instead of growing down the transcript.
+  
+  When the run finishes (text or a tool call follows), the body is hidden
+  completely. Only one row remains: `Thought for 8s · ctrl+t to expand`, or
+  `Thought for 8s · click to show more` in fullscreen.
+  
+  `ctrl+t` (`app.thinking.toggle`) expands every finished thinking card to its
+  full text and keeps new cards expanded, the same way Pi's own toggle works.
+  Press it again to hide the bodies. Clicking one card while the toggle is on
+  collapses only that card. Selector and dialog screens keep their own `ctrl+t`
+  (for example the `/tree` filter).
+  
+  `previewLines` is renamed to `liveThinkingLines` because it now sizes the live
+  window, not a finished preview. This package also always owns the reasoning
+  block now; Pi's own renderer used to stay in place whenever `hideThinkingBlock`
+  was off, which made the setting silently inert.
+
+- [#171](https://github.com/TianZuo555/pi-extensions/pull/171) [`8aad15a`](https://github.com/TianZuo555/pi-extensions/commit/8aad15a5d566564b39f6b8dd0e3c79e8aafdc46d) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Restore the docked-bash prototype patch when an interactive session shuts down, and keep headless sessions from installing it. Clear disposed main-screen patch registry entries even when another extension wraps the method.
+
+- [#171](https://github.com/TianZuo555/pi-extensions/pull/171) [`8aad15a`](https://github.com/TianZuo555/pi-extensions/commit/8aad15a5d566564b39f6b8dd0e3c79e8aafdc46d) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Render reasoning text with the theme's `thinkingText` slot instead of `dim`.
+  
+  `thinkingText` is Pi's dedicated "Thinking block text color" — Pi's own thinking renderer uses it — so reasoning now follows whatever the active theme sets for it. The `Thought for 6s` heading and the `N more lines` hint stay on `dim`, which keeps them reading as metadata rather than content.
+
+- [#177](https://github.com/TianZuo555/pi-extensions/pull/177) [`33fd5ae`](https://github.com/TianZuo555/pi-extensions/commit/33fd5ae9fea337ca9e2d8c44d271b5ec9a7fdc9a) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Fix review findings.
+  
+  - Every tool uses the beautify card, including the `bash` and `terminal_*` tools from `@tian.zuo/pi-background-terminals`. Only `Agent` keeps its own renderer.
+  - A settled tool title no longer gets wider than the terminal when it renders again. On a narrow terminal the extra width made Pi stop with "Rendered line exceeds terminal width".
+  - The `write` override is installed only in TUI sessions. Print and headless sessions keep the `write` tool that is already registered.
+  - Session shutdown always removes this installation's patches, and the next session installs them again. A newer installation's sticky-prompt patches are no longer removed by an older shutdown.
+  - `setStatus("token-speed")` from `@tian.zuo/pi-token-speed` fills the footer rate chip instead of adding a second rate chip.
+  - `setStatus("usage")` from `@tian.zuo/pi-usage` fills the usage chip and is shown once.
+  - The `@subagent:[name]` delegation instruction is sent only when an `Agent` tool exists. An unreadable entry in `~/.pi/agent/agents` is skipped instead of failing the handler.
+  - Syntax highlighting does not try again on every repaint for a language that failed.
+  - The `/clear` and `/exit` aliases are removed.
+  - The unused `lib/our-tools.ts` helpers and their exports are removed.
+
+- [#171](https://github.com/TianZuo555/pi-extensions/pull/171) [`8aad15a`](https://github.com/TianZuo555/pi-extensions/commit/8aad15a5d566564b39f6b8dd0e3c79e8aafdc46d) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Tighten the git and rate chips.
+  
+  The git chip dropped its parentheses: `(+12 −4)` is now ` +12/−4`, which reads as one token instead of a nested group. The rate chip replaced the `avg` prefix with the same md-flash glyph the rest of the footer uses, so `avg 211 tok/s` is now `󰉁 211 tok/s`. `live` keeps its word, since that mode has to stay distinguishable from the average.
+
+- [#193](https://github.com/TianZuo555/pi-extensions/pull/193) [`b49c918`](https://github.com/TianZuo555/pi-extensions/commit/b49c9184ecc729eb60fe69800b8086af19cecb06) Thanks [@TianZuo555](https://github.com/TianZuo555)! - Keep wrapped output readable and group headers clickable.
+  
+  - Wrapped tool output keeps the source indentation on every row. Indented `stdout`, JSON dumps, and nested lists used to fall back to the card edge after a line break, which made the continuation look like a separate line. Deep indents are clamped to half the width so text stays readable.
+  - A narrow tool-group header truncates the title and counts, never the expand hint. In fullscreen mode the hint is the click target, so cutting it made the whole card unclickable.
+  - `terminal_log_read` is removed from the background-terminal summary table. `@tian.zuo/pi-background-terminals` no longer registers that tool.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tian Zuo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,128 @@
-# Temporary Holding Version
+# @tian.zuo/pi-beautify-style
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Release notes: [changelog](https://github.com/TianZuo555/pi-extensions/blob/main/packages/pi-beautify-style/CHANGELOG.md) · [GitHub releases](https://github.com/TianZuo555/pi-extensions/releases)
+
+A Claude Code-style TUI for the [pi coding agent](https://pi.dev): tool cards,
+rich diffs, a status footer, and `/context`. It also knows about this
+repository's `ask_user`, background-terminal, and usage extensions.
+
+This package is a maintained fork of
+[minuque/pi-cc-extensions](https://github.com/minuque/pi-cc-extensions) (MIT).
+See [ATTRIBUTION.md](./ATTRIBUTION.md). Install **one or the other**, not both.
+
+## Install
+
+```bash
+pi install npm:@tian.zuo/pi-beautify-style
+```
+
+If `pi-cc-extensions` is installed, remove it first — both extensions patch the
+same `ToolExecutionComponent` and would fight over every tool card:
+
+```bash
+pi remove npm:pi-cc-extensions
+```
+
+Try from a checkout without installing:
+
+```bash
+pi -e ./packages/pi-beautify-style
+```
+
+## What it does
+
+- **Tool cards** in three modes — `on`, `compact`, `off` — with collapsed
+  summaries, click-to-expand, and a spinner plus elapsed time while a tool runs.
+- **Rich diffs** for `edit` and `write`, with split/unified layout, Shiki
+  highlighting, and configurable collapse limits.
+- **Compact mode**: one summary line per assistant message, with per-round tool
+  counts.
+- **Footer** in three fixed rows: builtin statistics (model, context, cache,
+  rate, cost), then location (cwd, session name, git), then every other
+  extension's `setStatus` chip, including `pi-usage` and the MCP count. Plugin
+  chips never crowd the first two rows.
+- **Fixed input box**: in regular TUI mode the input box keeps its screen row
+  when a block above it collapses — the reasoning window shrinking to
+  `Thought for …`, or a tool card closing. The freed rows become blank space at
+  the end of the transcript, and new output fills it again.
+- **`/context`** to inspect context usage and preview the system prompt, memory,
+  skills, and tool definitions.
+- **`@` references** to pull context from an earlier session or a running
+  subagent.
+- **Fullscreen extras**: click-to-expand cards, hover highlighting, sticky user
+  message, and a back-to-bottom button (`--tui-mode fullscreen`).
+
+## Integration with this repo
+
+The fork adapts upstream's renderers to the sibling packages:
+
+| Package | What changes |
+| --- | --- |
+| `@tian.zuo/pi-ask-user` | The `ask_user` card uses the same answer tree as upstream's `ask_user_question`, including `choice: { label, wasCustom }` answers, the question-count suffix, and custom ("Other") text. |
+| `@tian.zuo/pi-background-terminals` | Its `bash` and `terminal_wait`/`terminal_stop` tools use the same beautify card as every other tool: a live elapsed timer, and the terminal id in the title of the `terminal_*` cards. |
+| `@tian.zuo/pi-usage` | The footer treats `setStatus("usage")` as the usage chip on row 3. Upstream only recognized `pi-usage`/`localUsage`, so this package's chip used to stay empty. |
+
+`@tian.zuo/pi-token-speed` needs no integration either: its
+`setStatus("token-speed")` text fills the footer's built-in rate chip instead of
+adding a second one.
+
+`@tian.zuo/pi-compact-output` is superseded by this package — its compact tool
+blocks and reasoning boxes are what this package renders. Do not run both.
+
+## Configuration
+
+There is none. This package ships no `/ccstyle` command, no settings panel, and
+no JSON file. Every knob — render mode, diff layout, footer chips, reasoning
+window height — is a source constant in
+[`extensions/config/config.ts`](./extensions/config/config.ts). Edit that file
+and restart Pi to change behavior.
+
+> [!TIP]
+> In fullscreen mode, click `click to show more` to expand a tool card, a
+> reasoning block, or a compact summary. Expanded cards show the full diff;
+> Input/Output past their line limit open a full preview.
+>
+> Reasoning streams in a five-row window and hides completely once the run
+> ends (`Thought for 8s · ctrl+t to expand`). Press `ctrl+t` to open every
+> finished reasoning block; press it again to hide them.
+>
+> When the reasoning leads with a heading — `## Plan`, `**Plan**`, or an OpenAI
+> summary title — that heading becomes the card title while it streams, and stays
+> on the finished card (`Plan · Thought for 8s`). A heading copied out of tool
+> output mid-reasoning is ignored.
+
+> [!NOTE]
+> For Mermaid diagrams, set `markdown.mermaid` to `final` in
+> `~/.pi/agent/settings.json`. The default `streaming` mode repaints on every
+> frame and is less stable.
+
+## Compatibility
+
+- Node.js `>=22.19.0`, Pi `^1.2.0`.
+- Patches `ToolExecutionComponent`, `AssistantMessageComponent`, and
+  `Container.addChild`. If a future Pi drops one of them, the extension installs
+  without patching and Pi's native rendering stays in place.
+
+## Development
+
+```bash
+pnpm install
+pnpm --filter @tian.zuo/pi-beautify-style test
+```
+
+Tests under `test/` come from upstream and run unmodified except where the fork
+intentionally changes behavior (see the `usage` key assertions in
+`test/footer.test.ts`). Two upstream tests are not carried over because they
+load extension modules through `jiti`, which this repo does not depend on.
+
+## Attribution
+
+- Rendering stack and most of `extensions/`: `minuque/pi-cc-extensions`
+  (MIT).
+- Rich diff renderer: `MasuRii/pi-tool-display` (MIT).
+
+Full text in [ATTRIBUTION.md](./ATTRIBUTION.md).
+
+## License
+
+[MIT](./LICENSE) © Tian Zuo, and the upstream authors listed above.

package/extensions/config/config.ts

@@ -0,0 +1,200 @@
+import type { CompactThinkingConfig } from "../feature/compact-thinking.ts";
+
+export type CompactStyleMode = "on" | "compact" | "off";
+
+export type DiffViewMode = "auto" | "split" | "unified";
+export type DiffIndicatorMode = "bars" | "classic" | "none";
+export type FooterGitStatsMode = "working" | "branch";
+export type FooterTokenRateMode = "average" | "live";
+export type ScrollButtonMode = "dock" | "native";
+
+export interface ToolDisplayConfig {
+	diffViewMode: DiffViewMode;
+	diffIndicatorMode: DiffIndicatorMode;
+	diffSplitMinWidth: number;
+	/** Edit-only collapsed body lines. 0 = change counts and an expand hint. */
+	editDiffCollapsedLines: number;
+	/** Write-only collapsed body lines. 0 = `↳ created · click to show more`. */
+	writeDiffCollapsedLines: number;
+	diffWordWrap: boolean;
+	expandedPreviewMaxLines: number;
+}
+
+export const DEFAULT_TOOL_DISPLAY_CONFIG: ToolDisplayConfig = {
+	diffViewMode: "auto",
+	diffIndicatorMode: "bars",
+	diffSplitMinWidth: 120,
+	/** Collapsed edit/diff body: ~half a typical terminal after chrome. */
+	editDiffCollapsedLines: 24,
+	/**
+	 * Write create/overwrite collapsed body.
+	 * 0 = `↳ created · click to show more` (stats stay on the title).
+	 */
+	writeDiffCollapsedLines: 0,
+	diffWordWrap: true,
+	/**
+	 * Expanded TaskList body cap. Tool Input/Output and diffs use their own settings;
+	 * an expanded diff always renders every line.
+	 */
+	expandedPreviewMaxLines: 40,
+};
+
+export type Config = {
+	mode: CompactStyleMode;
+	excludeRenderers: string[];
+	diffViewMode: DiffViewMode;
+	diffIndicatorMode: DiffIndicatorMode;
+	diffSplitMinWidth: number;
+	editDiffCollapsedLines: number;
+	writeDiffCollapsedLines: number;
+	diffWordWrap: boolean;
+	expandedPreviewMaxLines: number;
+	expandedInputMaxLines: number;
+	expandedOutputMaxLines: number;
+	toolLabelClip: number;
+	/**
+	 * Title the reasoning card from a heading the reasoning leads with: an OpenAI
+	 * Responses summary heading, or a leading `# Heading` / `**Bold**` line. Other
+	 * providers get no title because their reasoning carries no reliable heading.
+	 * The title stays on the finished card (`Plan · Thought for 8s`).
+	 */
+	useSummaryTitlesAsThinkingTitle: boolean;
+	/**
+	 * Max reasoning rows shown **while** a run streams; longer text scrolls inside the
+	 * window and the newest row stays at the bottom. A finished run hides the body
+	 * entirely (heading only) until `app.thinking.toggle` (ctrl+t) expands it.
+	 */
+	liveThinkingLines: number;
+	animationIntervalMs: number;
+	/** fullscreen：userMessage 正文首行滚出视口上沿后钉住，直到下一条指令接手。 */
+	stickyUserMessage: boolean;
+	/** fullscreen 回到底部按钮：扩展 dock 行，或 Pi 原生浮层；两者文案相同。 */
+	scrollButtonMode: ScrollButtonMode;
+	enableSessionReference: boolean;
+	enableSubagentAutocomplete: boolean;
+	enableContextCommand: boolean;
+	enableAgentSummary: boolean;
+	enableWorkingMessage: boolean;
+	/** markdown 转换：Mermaid 方言渲染、圈数字转半角括号。关掉让位给其他扩展。 */
+	enableMarkdownEnhance: boolean;
+	/** 输入框 `❯ ` 前缀（占左侧 2 列，颜色随 thinking/bash mode 联动）。 */
+	enableEditorPrefix: boolean;
+	enableCustomFooter: boolean;
+	/** footer 输出速率芯片。关则不显示。 */
+	footerTokenRate: boolean;
+	/** average：整段指令墙钟平均；live：最近 1 秒瞬时速率，空档回退平均。 */
+	footerTokenRateMode: FooterTokenRateMode;
+	/** 速率芯片是否带 TTFT。关则只显示速率。 */
+	footerTokenRateTtft: boolean;
+	/** ISO 4217 显示币种。USD 时不换算。 */
+	footerCurrency: string;
+	/** 1 单位费用对应的显示币种数量。null 只换符号、不乘倍率。 */
+	footerCurrencyRate: number | null;
+	footerNerdIcons: boolean;
+	/** Session name and branch name cap, in characters. 0 = no cap. */
+	footerLabelClip: number;
+	footerGitStatsMode: FooterGitStatsMode;
+	/** 第三行的插件芯片里要隐藏的 `setStatus()` key。 */
+	footerHiddenKeys: string[];
+};
+
+export const DIFF_VIEW_MODES: DiffViewMode[] = ["auto", "split", "unified"];
+export const DIFF_INDICATOR_MODES: DiffIndicatorMode[] = ["bars", "classic", "none"];
+export const FOOTER_GIT_STATS_MODES: FooterGitStatsMode[] = ["working", "branch"];
+export const FOOTER_TOKEN_RATE_MODES: FooterTokenRateMode[] = ["average", "live"];
+export const SCROLL_BUTTON_MODES: ScrollButtonMode[] = ["dock", "native"];
+export const DIFF_SPLIT_MIN_WIDTH_VALUES = ["80", "100", "120", "140", "160", "180"];
+export const DIFF_COLLAPSED_LINES_VALUES = ["0", "12", "24", "36", "48", "80", "120"];
+/** Write collapsed presets. 0 = stats only (`+N -0` + expand hint). */
+export const WRITE_DIFF_COLLAPSED_LINES_VALUES = ["0", "4", "8", "12", "24", "36"];
+/** Presets for expanded body height — keep low options first so cycling stays TUI-friendly. */
+export const EXPANDED_PREVIEW_MAX_LINES_VALUES = ["40", "60", "80", "120", "200", "500", "2000"];
+/** 展开工具卡 Input 可见行数预设。 */
+export const EXPANDED_INPUT_MAX_LINES_VALUES = ["5", "10", "20", "40", "80"];
+/** 展开工具卡 Output 可见行数预设。 */
+export const EXPANDED_OUTPUT_MAX_LINES_VALUES = ["10", "20", "40", "80", "120"];
+/** 工具摘要里 path/command 等输入的折叠字符数；0 = 只按可用宽度截断。 */
+export const TOOL_LABEL_CLIP_VALUES = ["0", "40", "60", "80", "100", "120", "160"];
+export const THINKING_LIVE_LINES_VALUES = ["1", "3", "5", "8", "10"];
+export const THINKING_ANIMATION_INTERVAL_VALUES = ["40", "60", "90", "120", "180"];
+/** Tools commonly excluded from ccstyle rendering. */
+export const EXCLUDE_RENDERER_CANDIDATES = [
+	"bash",
+	"powershell",
+	"read",
+	"edit",
+	"write",
+	"grep",
+	"find",
+	"ls",
+	"webfetch",
+	"wait",
+];
+
+export const DEFAULT_CONFIG: Config = {
+	mode: "on",
+	excludeRenderers: [],
+	diffViewMode: DEFAULT_TOOL_DISPLAY_CONFIG.diffViewMode,
+	diffIndicatorMode: DEFAULT_TOOL_DISPLAY_CONFIG.diffIndicatorMode,
+	diffSplitMinWidth: DEFAULT_TOOL_DISPLAY_CONFIG.diffSplitMinWidth,
+	editDiffCollapsedLines: DEFAULT_TOOL_DISPLAY_CONFIG.editDiffCollapsedLines,
+	writeDiffCollapsedLines: DEFAULT_TOOL_DISPLAY_CONFIG.writeDiffCollapsedLines,
+	diffWordWrap: DEFAULT_TOOL_DISPLAY_CONFIG.diffWordWrap,
+	expandedPreviewMaxLines: DEFAULT_TOOL_DISPLAY_CONFIG.expandedPreviewMaxLines,
+	expandedInputMaxLines: 5,
+	expandedOutputMaxLines: 10,
+	toolLabelClip: 0,
+	useSummaryTitlesAsThinkingTitle: true,
+	liveThinkingLines: 5,
+	animationIntervalMs: 90,
+	stickyUserMessage: true,
+	scrollButtonMode: "dock",
+	enableSessionReference: true,
+	enableSubagentAutocomplete: true,
+	enableContextCommand: true,
+	enableAgentSummary: true,
+	enableWorkingMessage: true,
+	enableMarkdownEnhance: true,
+	enableEditorPrefix: true,
+	enableCustomFooter: true,
+	footerTokenRate: true,
+	footerTokenRateMode: "average",
+	footerTokenRateTtft: true,
+	footerCurrency: "USD",
+	footerCurrencyRate: null,
+	footerNerdIcons: true,
+	footerLabelClip: 16,
+	footerGitStatsMode: "working",
+	footerHiddenKeys: [],
+};
+
+/**
+ * Source constants for the render and feature switches.
+ *
+ * This package has no runtime configuration surface: no `/ccstyle` command, no
+ * settings panel, no JSON file. The object is mutable only so tests can
+ * override fields; production code must treat it as read-only. Edit
+ * `DEFAULT_CONFIG` and restart Pi to change behavior.
+ */
+export const config: Config = { ...DEFAULT_CONFIG };
+
+export function getCompactThinkingConfig(source: Config = config): CompactThinkingConfig {
+	return {
+		useSummaryTitlesAsThinkingTitle: source.useSummaryTitlesAsThinkingTitle,
+		liveThinkingLines: source.liveThinkingLines,
+		animationIntervalMs: source.animationIntervalMs,
+	};
+}
+
+export function getToolDisplayConfig(source: Config = config): ToolDisplayConfig {
+	return {
+		diffViewMode: source.diffViewMode,
+		diffIndicatorMode: source.diffIndicatorMode,
+		diffSplitMinWidth: source.diffSplitMinWidth,
+		editDiffCollapsedLines: source.editDiffCollapsedLines,
+		writeDiffCollapsedLines: source.writeDiffCollapsedLines,
+		diffWordWrap: source.diffWordWrap,
+		expandedPreviewMaxLines: source.expandedPreviewMaxLines,
+	};
+}
+