pi-one-ui 0.6.1 → 0.7.1

package/CHANGELOG.md

@@ -6,6 +6,44 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.7.1] - 2026-09-21
+
+### Changed
+
+- Centralize component composition, settings application, and session lifecycle management in app, with settings and Context Inspector views owned by Overlay Layout.
+- Apply presets with one canonical configuration write and update every affected Layout. Component settings, including Header visibility, apply through their owning Layout; Feature registration switches still require `/reload`.
+- Report corrupt or unreadable configuration files during loading, and distinguish a failed save from a saved configuration that could not be applied to the UI.
+- Coalesce shared Layout redraw requests while preserving forced redraws and session ownership.
+
+### Fixed
+
+- Close managed overlays and input listeners during session replacement, and prevent Context Inspector from reopening a preview's parent window in an ended session.
+
+### Migration
+
+- No configuration migration is required. Existing canonical v1 files and command names remain supported.
+- For an unpinned npm installation, run `pi update npm:pi-one-ui`; for an existing version pin, run `pi install npm:pi-one-ui@0.7.1`. Fully exit and restart Pi after updating the package.
+
+## [0.7.0] - 2026-09-13
+
+### Added
+
+- Added `components.editor.styles.minimalist.showCwd` to independently show or hide the Editor's working-directory label, including the `/oneui` preview. It defaults to `true`, so existing configurations need no migration. Setting it to `false` preserves `pathDisplay` and leaves Git metadata and Footer directory settings unchanged; edit the JSON configuration and run `/reload` to apply it.
+
+### Fixed
+
+- Restore keyboard focus to the visible Editor after `/oneui` replaces an editor while changing its settings, including native-to-custom transitions, third-party wrappers, and replacement rollback. Closing the panel no longer sends subsequent typing to the detached previous editor in regular or fullscreen mode; existing overlays and later editor owners retain focus.
+
+### Migration
+
+- No configuration migration is required. Existing configurations keep showing the Editor directory; set `components.editor.styles.minimalist.showCwd` to `false` only if you want to hide it. Footer directory settings remain independent.
+- For an unpinned npm installation, run `pi update npm:pi-one-ui`; for an existing version pin, run `pi install npm:pi-one-ui@0.7.0`. Fully exit and restart Pi after updating the package. Subsequent JSON configuration edits can be applied with `/reload`.
+
+### Release verification
+
+- Release source: [`10ac3de`](https://github.com/kerolt/pi-one-ui/commit/10ac3dea3f0ac804fef94cbeea937c6f1ae0d347). [CI](https://github.com/kerolt/pi-one-ui/actions/runs/34740987283) and [Publish](https://github.com/kerolt/pi-one-ui/actions/runs/34741047850) completed successfully; `npm run verify` passed 1,165 tests and `npm run pack:check` confirmed 121 package files.
+- At publication, npm `latest` resolved to `0.7.0` with the matching release `gitHead` and [provenance metadata](https://registry.npmjs.org/-/npm/v1/attestations/pi-one-ui@0.7.0). The provenance statement was published at [Sigstore log index 2814335389](https://search.sigstore.dev/?logIndex=2814335389).
+
 ## [0.6.1] - 2026-09-06
 
 ### Added
@@ -115,7 +153,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 - Reduced rendering lag when expanding settled tool groups by reusing cached child output.
 
-[Unreleased]: https://github.com/kerolt/pi-one-ui/compare/v0.6.1...HEAD
+[Unreleased]: https://github.com/kerolt/pi-one-ui/compare/v0.7.1...HEAD
+[0.7.1]: https://github.com/kerolt/pi-one-ui/compare/v0.7.0...v0.7.1
+[0.7.0]: https://github.com/kerolt/pi-one-ui/compare/v0.6.1...v0.7.0
 [0.6.1]: https://github.com/kerolt/pi-one-ui/compare/v0.6.0...v0.6.1
 [0.6.0]: https://github.com/kerolt/pi-one-ui/compare/v0.5.1...v0.6.0
 [0.5.1]: https://github.com/kerolt/pi-one-ui/compare/v0.5.0...v0.5.1

package/README.en.md

@@ -76,6 +76,20 @@ Then open the unified settings panel:
 /oneui
 ```
 
+### Upgrading to 0.7.1
+
+This release centralizes component composition, settings application, and session lifecycle management. Each preset saves and applies all related component settings in one update, Header settings apply immediately, and session replacement cleans up overlays and input listeners.
+
+Existing canonical v1 configurations and commands remain compatible; no migration is required. Corrupt or unreadable configuration files now produce an explicit error.
+
+For an unpinned npm installation, run:
+
+```bash
+pi update npm:pi-one-ui
+```
+
+If your installation pins a version, run `pi install npm:pi-one-ui@0.7.1` to update the pin. Fully exit and restart Pi after updating the package.
+
 ## Configuration
 
 ### Configuration methods
@@ -88,9 +102,11 @@ Then open the unified settings panel:
 
 You can configure the extension in two ways:
 
-1. **Interactive settings panel (recommended)**: Run `/oneui` in Pi to adjust common component toggles, styles, and border modes via a visual menu. Changes take effect immediately and are persisted automatically.
+1. **Interactive settings panel (recommended)**: Run `/oneui` in Pi to adjust component toggles, styles, and border modes. Component settings apply after saving; Features switches apply after `/reload`. Each preset saves all related settings in one update and applies them to the corresponding components.
 2. **Direct JSON editing**: Advanced users can edit the JSON configuration file directly for finer-grained control. After saving edits, run `/reload` in Pi to apply changes. When the file does not exist, safe runtime defaults are used in memory.
 
+Corrupt or unreadable configuration files produce an error. Failed saves retain the current settings; if saving succeeds but a component cannot apply the change, the panel reports the application failure explicitly.
+
 ### Basic configuration example
 
 Below is a typical v1 configuration structure:
@@ -132,7 +148,7 @@ Below is a typical v1 configuration structure:
 To keep the configuration section clean and focused, in-depth options, template variables, and color references are organized in dedicated documentation:
 
 - **Component options & layout customization**: see [Editor & Footer Configuration Guide (docs/configuration.md)](./docs/configuration.md)
-  - **Editor**: Configure `style` (`on` for Minimalist decoration / `off` for Pi native), `borderColorMode` (`static` or `adaptive` to thinking effort), `modelLabel`, and granular Minimalist displays (directory path format, session name, timer, cost, Git status, etc.).
+  - **Editor**: Configure `style` (`on` for Minimalist decoration / `off` for Pi native), `borderColorMode` (`static` or `adaptive` to thinking effort), `modelLabel`, and granular Minimalist displays (directory visibility and format, session name, timer, cost, Git status, etc.). `components.editor.styles.minimalist.showCwd` (since 0.7.0, default `true`) can hide the directory independently of the Footer; `pathDisplay` continues to select its format.
   - **Footer**: Starship-style layout powered by format templates (`$cwd`, `$git_branch`, `$tokens`, `$cost`, etc.), individual `segments` toggles, customizable separators, and context-usage indicators (gauge or text).
   - **WorkingLine**: Built-in live output throughput tracking (appends e.g. `⚡12 tok/s` when a model response runs for at least 500ms, reset per turn).
 - **Settings panel (`/oneui`) customization**: the optional top-level `panel` section controls the overlay placement and size (all fields default to the values shown in the example above).
@@ -216,6 +232,17 @@ npm run verify
 npm run pack:check
 ```
 
+### Source responsibilities
+
+- `extensions/app/runtime/`: composition, shared events, session lifecycle, render scheduling, and patch management.
+- `extensions/app/config/`: configuration types, normalization, and shared storage.
+- `extensions/app/settings/`: settings operations, presets, and the `/oneui` opening flow.
+- `extensions/app/overlay/`: overlay lifecycle, focus coordination, and input routing.
+- `extensions/layouts/`: component behavior and rendering; settings, Context Inspector, and Selector views live in `layouts/overlay/`.
+- `extensions/features/` and `extensions/services/`: features and shared data, composed by app.
+
+See [ARCHITECTURE.md](./ARCHITECTURE.md) for module rules and real Pi TUI verification commands.
+
 ### Test organization
 
 All tests run through Vitest and are organized into domain directories:

package/README.md

@@ -76,6 +76,20 @@ pi install git:github.com/kerolt/pi-one-ui
 /oneui
 ```
 
+### 升级到 0.7.1
+
+本次集中管理组件装配、设置应用与会话生命周期。Preset 会一次保存并应用所有相关组件配置，Header 设置即时生效；会话切换时会清理 Overlay 与输入监听。
+
+现有 canonical v1 配置和命令保持兼容，无需迁移。配置文件损坏或无法读取时会明确报告错误。
+
+未固定版本的 npm 安装可执行：
+
+```bash
+pi update npm:pi-one-ui
+```
+
+若安装时固定了版本，执行 `pi install npm:pi-one-ui@0.7.1` 更新版本指定。更新安装包后，完整退出并重启 Pi。
+
 ## 配置
 
 ### 配置方式
@@ -88,9 +102,11 @@ pi install git:github.com/kerolt/pi-one-ui
 
 提供两种配置途径：
 
-1. **交互式设置面板（推荐）**：在 Pi 会话中运行 `/oneui`，即可在可视化面板中即时调整常用组件开关、样式和边框模式。修改即刻生效并自动持久化。
+1. **交互式设置面板（推荐）**：在 Pi 会话中运行 `/oneui`，即可调整常用组件开关、样式和边框模式。组件设置保存后即时应用；Features 开关在 `/reload` 后应用。Preset 一次保存全部相关设置并更新对应组件。
 2. **手动编辑配置文件**：高级用户可直接编辑 JSON 配置文件以启用更多细粒度选项。修改保存后，在 Pi 中执行 `/reload` 即可生效。文件不存在时将直接使用内置默认值。
 
+配置文件损坏或无法读取时会报告错误。保存失败时保持当前设置；保存成功但组件应用失败时，面板会明确提示应用失败。
+
 ### 基础配置示例
 
 以下为一个典型的 v1 配置文件结构：
@@ -132,7 +148,7 @@ pi install git:github.com/kerolt/pi-one-ui
 各项组件开关、模板变量与颜色字段的完整规范拆分收录于独立文档中，便于按需查阅：
 
 - **组件开关与排版定制**：详见 [Editor 与 Footer 配置指南 (docs/configuration.md)](./docs/configuration.md)
-  - **Editor**：支持 `style`（`on` 极简装饰 / `off` 原生）、`borderColorMode`（固定色 / 思考档位自适应）、`modelLabel` 及 Minimalist 装饰细节（目录层级、会话名、耗时、费用、Git 状态等）。
+  - **Editor**：支持 `style`（`on` 极简装饰 / `off` 原生）、`borderColorMode`（固定色 / 思考档位自适应）、`modelLabel` 及 Minimalist 装饰细节（目录显示与格式、会话名、耗时、费用、Git 状态等）。`components.editor.styles.minimalist.showCwd`（0.7.0 起，默认 `true`）可单独隐藏工作目录，不影响 Footer；`pathDisplay` 继续控制目录格式。
   - **Footer**：支持 Starship 风格排版，提供丰富的模板变量（`$cwd`、`$git_branch`、`$tokens`、`$cost` 等），支持通过 `format` 自定义或通过 `segments` 控制各段开关，并可自由配置上下文占用率的展示形式（gauge / text）。
   - **WorkingLine**：内置实时输出速率检测（单次响应持续 >=500ms 自动追加如 `⚡12 tok/s`，按回合独立重置）。
 - **设置面板（`/oneui`）定制**：通过顶层 `panel` 字段控制浮层位置与尺寸，全部字段可省略（缺省值见上文示例）。
@@ -216,6 +232,17 @@ npm run verify
 npm run pack:check
 ```
 
+### 源码职责
+
+- `extensions/app/runtime/`：装配、共享事件、session 生命周期、渲染调度和 patch 管理。
+- `extensions/app/config/`：配置类型、规范化和统一存储。
+- `extensions/app/settings/`：设置操作、Preset 与 `/oneui` 打开流程。
+- `extensions/app/overlay/`：Overlay 生命周期、焦点协作和输入路由。
+- `extensions/layouts/`：组件行为与渲染；设置面板、Context Inspector 和 Selector 视图位于 `layouts/overlay/`。
+- `extensions/features/`、`extensions/services/`：功能实现与共享数据，由 app 统一组织。
+
+模块约束和真实 Pi TUI 验证命令见 [ARCHITECTURE.md](./ARCHITECTURE.md)。
+
 ### 测试组织
 
 所有测试统一由 Vitest 执行，并按照功能领域组织在子目录中：

package/extensions/app/config/context.ts

@@ -0,0 +1,42 @@
+import { booleanValue, recordValue } from "./values.ts";
+
+export type UserMessageStyle =
+  | "framed"
+  | "framed-copy-friendly"
+  | "compact"
+  | "labeled";
+export type FramedUserMessageStyleConfig = Record<string, never>;
+export type FramedCopyFriendlyUserMessageStyleConfig = Record<string, never>;
+export type CompactUserMessageStyleConfig = Record<string, never>;
+export type LabeledUserMessageStyleConfig = Record<string, never>;
+export type UserMessagesComponentConfig = {
+  enabled: boolean;
+  style: UserMessageStyle;
+  styles: {
+    framed: FramedUserMessageStyleConfig;
+    "framed-copy-friendly": FramedCopyFriendlyUserMessageStyleConfig;
+    compact: CompactUserMessageStyleConfig;
+    labeled: LabeledUserMessageStyleConfig;
+  };
+};
+
+export function normalizeUserMessages(
+  value: unknown,
+): UserMessagesComponentConfig {
+  const source = recordValue(value);
+  return {
+    enabled: booleanValue(source.enabled, true),
+    style:
+      source.style === "framed-copy-friendly" ||
+      source.style === "compact" ||
+      source.style === "labeled"
+        ? source.style
+        : "framed",
+    styles: {
+      framed: {},
+      "framed-copy-friendly": {},
+      compact: {},
+      labeled: {},
+    },
+  };
+}

package/extensions/app/config/editor.ts

@@ -0,0 +1,80 @@
+import { booleanValue, recordValue } from "./values.ts";
+
+export type ModelLabelSource = "id" | "name";
+export type EditorStyle = "on" | "off";
+export type EditorBorderColorMode = "static" | "adaptive";
+export type MinimalistPathDisplayMode = "compact" | "project" | "full";
+export type MinimalistEditorStyleConfig = {
+  pathDisplay: MinimalistPathDisplayMode;
+  showCwd: boolean;
+  showSessionName: boolean;
+  showTimer: boolean;
+  showCost: boolean;
+  showGit: boolean;
+};
+export type MinimalistConfig = MinimalistEditorStyleConfig;
+export type EditorStylesConfig = { minimalist: MinimalistEditorStyleConfig };
+export type EditorComponentConfig = {
+  style: EditorStyle;
+  borderColorMode: EditorBorderColorMode;
+  modelLabel: ModelLabelSource;
+  viewportIndicators: boolean;
+  styles: EditorStylesConfig;
+};
+
+export const DEFAULT_EDITOR_METADATA_FORMAT = "$model  $provider(  $thinking)";
+export const defaultMinimalistStyle: MinimalistEditorStyleConfig = {
+  pathDisplay: "compact",
+  showCwd: true,
+  showSessionName: true,
+  showTimer: true,
+  showCost: true,
+  showGit: true,
+};
+export const defaultEditor: EditorComponentConfig = {
+  style: "on",
+  borderColorMode: "static",
+  modelLabel: "id",
+  viewportIndicators: true,
+  styles: { minimalist: defaultMinimalistStyle },
+};
+
+export function parseEditorModelLabel(value: unknown): ModelLabelSource {
+  return value === "name" ? "name" : "id";
+}
+
+export function parseEditorStyle(value: unknown): EditorStyle {
+  return value === "off" ? "off" : "on";
+}
+
+export function parseEditorBorderColorMode(
+  value: unknown,
+): EditorBorderColorMode {
+  return value === "adaptive" ? "adaptive" : "static";
+}
+
+/** 配置规范化仅生成 canonical 字段。 */
+export function normalizeEditor(value: unknown): EditorComponentConfig {
+  const editor = recordValue(value);
+  const minimalist = recordValue(recordValue(editor.styles).minimalist);
+  return {
+    style: editor.enabled === false ? "off" : parseEditorStyle(editor.style),
+    borderColorMode: parseEditorBorderColorMode(editor.borderColorMode),
+    modelLabel: parseEditorModelLabel(editor.modelLabel),
+    viewportIndicators: booleanValue(editor.viewportIndicators, true),
+    styles: {
+      minimalist: {
+        pathDisplay:
+          minimalist.pathDisplay === "project" ||
+          minimalist.pathDisplay === "full"
+            ? minimalist.pathDisplay
+            : "compact",
+        showCwd: booleanValue(minimalist.showCwd, true),
+        showSessionName: booleanValue(minimalist.showSessionName, true),
+        showTimer: booleanValue(minimalist.showTimer, true),
+        showCost: booleanValue(minimalist.showCost, true),
+        showGit: booleanValue(minimalist.showGit, true),
+      },
+    },
+  };
+}

package/extensions/app/config/footer.ts

@@ -0,0 +1,291 @@
+import { type ModelLabelSource, parseEditorModelLabel } from "./editor.ts";
+import { booleanValue, recordValue } from "./values.ts";
+
+export type ContextStyle = "text" | "gauge" | "text+gauge";
+export type SeparatorStyle = "pipe" | "dot" | "chevron" | "none";
+export type FooterStyle = "native" | "starship" | "hidden";
+export type CompactFooterMaxLines = 1 | 2 | 3 | "unlimited";
+export type ContextThresholds = { warning: number; error: number };
+export type PathDisplayMode = "basename" | "full";
+export type PathDisplayConfig = { mode: PathDisplayMode; depth: number };
+export type GitBranchMaxLength = "full" | number;
+export type GitBranchConfig = { maxLength: GitBranchMaxLength };
+export type GitCommitConfig = {
+  hashLength: number;
+  onlyDetached: boolean;
+  showTag: boolean;
+};
+export type GitMetricsConfig = {
+  onlyNonzero: boolean;
+  ignoreSubmodules: boolean;
+};
+export type ExtensionStatusPlacement = "off" | "left" | "middle" | "right";
+export type ExtensionStatusColorMode = "zentui" | "original";
+export type ExtensionStatusesConfig = {
+  defaultPlacement: ExtensionStatusPlacement;
+  placements: Record<string, ExtensionStatusPlacement>;
+  colorModes: Record<string, ExtensionStatusColorMode>;
+};
+export type FooterSegmentsConfig = {
+  cwd: boolean;
+  sessionName: boolean;
+  gitBranch: boolean;
+  gitStatus: boolean;
+  gitCounts: boolean;
+  gitCommit: boolean;
+  gitMetrics: boolean;
+  runtime: boolean;
+  modelInfo: boolean;
+  context: boolean;
+  tokens: boolean;
+  cost: boolean;
+  sessionDuration: boolean;
+  username: boolean;
+  time: boolean;
+  os: boolean;
+  packageVersion: boolean;
+};
+export type StarshipFooterStyleConfig = {
+  format: string;
+  responsive: boolean;
+  compactFormat: string;
+  compactMaxLines: CompactFooterMaxLines;
+  separator: SeparatorStyle;
+  contextStyle: ContextStyle;
+  contextThresholds: ContextThresholds;
+  pathDisplay: PathDisplayConfig;
+  segments: FooterSegmentsConfig;
+  gitBranch: GitBranchConfig;
+  gitCommit: GitCommitConfig;
+  gitMetrics: GitMetricsConfig;
+  extensionStatuses: ExtensionStatusesConfig;
+};
+export type FooterComponentConfig = {
+  style: FooterStyle;
+  modelLabel: ModelLabelSource;
+  styles: { starship: StarshipFooterStyleConfig };
+};
+
+export const DEFAULT_COMPACT_FOOTER_FORMAT =
+  "$cwd$wrap(in $session_name)$wrap(on $git_branch) $git_status$wrap$context$wrap_sep$tokens";
+export const FOOTER_FORMAT_VARIABLES = [
+  "cwd",
+  "session_name",
+  "git_branch",
+  "git_status",
+  "git_state",
+  "runtime",
+  "model",
+  "provider",
+  "session_duration",
+  "username",
+  "os",
+  "time",
+  "context",
+  "tokens",
+  "cache_read",
+  "cache_write",
+  "cost",
+  "subscription",
+  "auto_compaction",
+  "package",
+  "package_version",
+  "git_commit",
+  "git_tag",
+  "git_metrics",
+  "git_added",
+  "git_deleted",
+  "sep",
+] as const;
+export const FOOTER_FORMAT_ALIASES: Record<string, string> = {
+  directory: "cwd",
+  branch: "git_branch",
+  status: "git_status",
+  state: "git_state",
+  commit: "git_commit",
+  tag: "git_tag",
+  duration: "session_duration",
+  separator: "sep",
+};
+export const defaultFooterSegments: FooterSegmentsConfig = {
+  cwd: true,
+  sessionName: true,
+  gitBranch: true,
+  gitStatus: true,
+  gitCounts: false,
+  gitCommit: false,
+  gitMetrics: false,
+  runtime: true,
+  modelInfo: false,
+  context: true,
+  tokens: true,
+  cost: true,
+  sessionDuration: false,
+  username: false,
+  time: false,
+  os: false,
+  packageVersion: false,
+};
+export const defaultStarshipStyle: StarshipFooterStyleConfig = {
+  format: "",
+  responsive: true,
+  compactFormat: DEFAULT_COMPACT_FOOTER_FORMAT,
+  compactMaxLines: 2,
+  separator: "pipe",
+  contextStyle: "text",
+  contextThresholds: { warning: 70, error: 90 },
+  pathDisplay: { mode: "basename", depth: 0 },
+  segments: defaultFooterSegments,
+  gitBranch: { maxLength: "full" },
+  gitCommit: { hashLength: 7, onlyDetached: true, showTag: true },
+  gitMetrics: { onlyNonzero: true, ignoreSubmodules: false },
+  extensionStatuses: {
+    defaultPlacement: "right",
+    placements: {},
+    colorModes: {},
+  },
+};
+export const defaultFooter: FooterComponentConfig = {
+  style: "starship",
+  modelLabel: "id",
+  styles: { starship: defaultStarshipStyle },
+};
+
+export function isSeparatorStyle(value: unknown): value is SeparatorStyle {
+  return (
+    value === "pipe" ||
+    value === "dot" ||
+    value === "chevron" ||
+    value === "none"
+  );
+}
+export function parseSeparatorStyle(value: unknown): SeparatorStyle {
+  return isSeparatorStyle(value) ? value : "pipe";
+}
+export function parseContextStyle(value: unknown): ContextStyle {
+  return value === "gauge" || value === "text+gauge" ? value : "text";
+}
+export function parseCompactFooterMaxLines(
+  value: unknown,
+): CompactFooterMaxLines {
+  return value === 1 || value === 2 || value === 3 || value === "unlimited"
+    ? value
+    : 2;
+}
+export function isExtensionStatusPlacement(
+  value: unknown,
+): value is ExtensionStatusPlacement {
+  return (
+    value === "off" ||
+    value === "left" ||
+    value === "middle" ||
+    value === "right"
+  );
+}
+export function isExtensionStatusColorMode(
+  value: unknown,
+): value is ExtensionStatusColorMode {
+  return value === "zentui" || value === "original";
+}
+
+function thresholds(value: unknown): ContextThresholds {
+  const source = recordValue(value);
+  const percent = (input: unknown, defaultValue: number) =>
+    typeof input === "number" && Number.isFinite(input)
+      ? Math.max(0, Math.min(100, Math.round(input)))
+      : defaultValue;
+  const warning = percent(source.warning, 70);
+  const error = percent(source.error, 90);
+  return { warning: Math.min(warning, error), error: Math.max(warning, error) };
+}
+
+/** 每个 Footer 字段独立规范化，返回完整的 canonical 配置。 */
+export function normalizeFooter(value: unknown): FooterComponentConfig {
+  const footer = recordValue(value);
+  const source = recordValue(recordValue(footer.styles).starship);
+  const path = recordValue(source.pathDisplay);
+  const branch = recordValue(source.gitBranch);
+  const commit = recordValue(source.gitCommit);
+  const metrics = recordValue(source.gitMetrics);
+  const statuses = recordValue(source.extensionStatuses);
+  const segments = recordValue(source.segments);
+  const hashLength =
+    typeof commit.hashLength === "number"
+      ? commit.hashLength
+      : Number(commit.hashLength);
+  return {
+    style:
+      footer.style === "native" || footer.style === "hidden"
+        ? footer.style
+        : "starship",
+    modelLabel: parseEditorModelLabel(footer.modelLabel),
+    styles: {
+      starship: {
+        format: typeof source.format === "string" ? source.format : "",
+        responsive: booleanValue(source.responsive, true),
+        compactFormat:
+          typeof source.compactFormat === "string" &&
+          source.compactFormat.length > 0
+            ? source.compactFormat
+            : DEFAULT_COMPACT_FOOTER_FORMAT,
+        compactMaxLines: parseCompactFooterMaxLines(source.compactMaxLines),
+        separator: parseSeparatorStyle(source.separator),
+        contextStyle: parseContextStyle(source.contextStyle),
+        contextThresholds: thresholds(source.contextThresholds),
+        pathDisplay: {
+          mode: path.mode === "full" ? "full" : "basename",
+          depth:
+            typeof path.depth === "number" &&
+            Number.isFinite(path.depth) &&
+            path.depth >= 0
+              ? Math.min(5, Math.floor(path.depth))
+              : 0,
+        },
+        segments: Object.fromEntries(
+          Object.entries(defaultFooterSegments).map(([key, enabled]) => [
+            key,
+            booleanValue(segments[key], enabled),
+          ]),
+        ) as FooterSegmentsConfig,
+        gitBranch: {
+          maxLength:
+            typeof branch.maxLength === "number" &&
+            Number.isInteger(branch.maxLength) &&
+            branch.maxLength > 0
+              ? branch.maxLength
+              : "full",
+        },
+        gitCommit: {
+          hashLength: Number.isFinite(hashLength)
+            ? Math.min(40, Math.max(4, Math.round(hashLength)))
+            : 7,
+          onlyDetached: booleanValue(commit.onlyDetached, true),
+          showTag: booleanValue(commit.showTag, true),
+        },
+        gitMetrics: {
+          onlyNonzero: booleanValue(metrics.onlyNonzero, true),
+          ignoreSubmodules: booleanValue(metrics.ignoreSubmodules, false),
+        },
+        extensionStatuses: {
+          defaultPlacement: isExtensionStatusPlacement(
+            statuses.defaultPlacement,
+          )
+            ? statuses.defaultPlacement
+            : "right",
+          placements: Object.fromEntries(
+            Object.entries(recordValue(statuses.placements)).filter(
+              (entry): entry is [string, ExtensionStatusPlacement] =>
+                isExtensionStatusPlacement(entry[1]),
+            ),
+          ),
+          colorModes: Object.fromEntries(
+            Object.entries(recordValue(statuses.colorModes)).filter(
+              (entry): entry is [string, ExtensionStatusColorMode] =>
+                isExtensionStatusColorMode(entry[1]),
+            ),
+          ),
+        },
+      },
+    },
+  };
+}

package/extensions/app/config/panel.ts

@@ -109,9 +109,5 @@ export function normalizePanelOverlay(input: unknown): PanelOverlayConfig {
  * every /oneui open so JSON edits apply without `/reload`.
  */
 export function loadPanelOverlayConfig(): PanelOverlayConfig {
-  try {
-    return normalizePanelOverlay(configStore.read().panel);
-  } catch {
-    return normalizePanelOverlay(undefined);
-  }
+  return normalizePanelOverlay(configStore.read().panel);
 }

package/extensions/app/config/renderer.ts

@@ -364,12 +364,7 @@ export const config: Config = loadConfig();
  * Loads and normalizes the renderer projection from the shared store.
  */
 function loadConfig(): Config {
-  try {
-    return normalizeConfig(rendererConfigFrom(configStore.read()));
-  } catch {
-    // Ignore bad config and fall back to defaults.
-  }
-  return { ...DEFAULT_CONFIG };
+  return normalizeConfig(rendererConfigFrom(configStore.read()));
 }
 
 /**