@selesai/code 0.13.15 → 0.13.18

package/dist/modes/interactive/theme/theme-json.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Theme JSON validation, kept out of `theme.ts` on purpose.
+ *
+ * Validating user-authored theme files needs typebox, which costs ~17 MB of module graph to import.
+ * Palette lookup does not, so a presentation that only uses built-in themes should never pay for it.
+ * `interactive-mode.ts` installs this validator; anything that does not simply skips validation, as
+ * built-in themes already do.
+ */
+import { type Static, Type } from "typebox";
+declare const ColorValueSchema: Type.TUnion<[Type.TString, Type.TInteger]>;
+declare const ThemeJsonSchema: Type.TObject<{
+    $schema: Type.TOptional<Type.TString>;
+    name: Type.TString;
+    vars: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TString, Type.TInteger]>>>;
+    colors: Type.TObject<{
+        accent: Type.TUnion<[Type.TString, Type.TInteger]>;
+        border: Type.TUnion<[Type.TString, Type.TInteger]>;
+        borderAccent: Type.TUnion<[Type.TString, Type.TInteger]>;
+        borderMuted: Type.TUnion<[Type.TString, Type.TInteger]>;
+        success: Type.TUnion<[Type.TString, Type.TInteger]>;
+        error: Type.TUnion<[Type.TString, Type.TInteger]>;
+        warning: Type.TUnion<[Type.TString, Type.TInteger]>;
+        muted: Type.TUnion<[Type.TString, Type.TInteger]>;
+        dim: Type.TUnion<[Type.TString, Type.TInteger]>;
+        text: Type.TUnion<[Type.TString, Type.TInteger]>;
+        thinkingText: Type.TUnion<[Type.TString, Type.TInteger]>;
+        scrollbarTrack: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
+        scrollbarThumb: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
+        selectedBg: Type.TUnion<[Type.TString, Type.TInteger]>;
+        searchMatchBg: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
+        searchMatchText: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
+        userMessageBg: Type.TUnion<[Type.TString, Type.TInteger]>;
+        userMessageText: Type.TUnion<[Type.TString, Type.TInteger]>;
+        customMessageBg: Type.TUnion<[Type.TString, Type.TInteger]>;
+        customMessageText: Type.TUnion<[Type.TString, Type.TInteger]>;
+        customMessageLabel: Type.TUnion<[Type.TString, Type.TInteger]>;
+        toolPendingBg: Type.TUnion<[Type.TString, Type.TInteger]>;
+        toolSuccessBg: Type.TUnion<[Type.TString, Type.TInteger]>;
+        toolErrorBg: Type.TUnion<[Type.TString, Type.TInteger]>;
+        toolTitle: Type.TUnion<[Type.TString, Type.TInteger]>;
+        toolOutput: Type.TUnion<[Type.TString, Type.TInteger]>;
+        mdHeading: Type.TUnion<[Type.TString, Type.TInteger]>;
+        mdLink: Type.TUnion<[Type.TString, Type.TInteger]>;
+        mdLinkUrl: Type.TUnion<[Type.TString, Type.TInteger]>;
+        mdCode: Type.TUnion<[Type.TString, Type.TInteger]>;
+        mdCodeBlock: Type.TUnion<[Type.TString, Type.TInteger]>;
+        mdCodeBlockBorder: Type.TUnion<[Type.TString, Type.TInteger]>;
+        mdQuote: Type.TUnion<[Type.TString, Type.TInteger]>;
+        mdQuoteBorder: Type.TUnion<[Type.TString, Type.TInteger]>;
+        mdHr: Type.TUnion<[Type.TString, Type.TInteger]>;
+        mdListBullet: Type.TUnion<[Type.TString, Type.TInteger]>;
+        toolDiffAdded: Type.TUnion<[Type.TString, Type.TInteger]>;
+        toolDiffRemoved: Type.TUnion<[Type.TString, Type.TInteger]>;
+        toolDiffContext: Type.TUnion<[Type.TString, Type.TInteger]>;
+        syntaxComment: Type.TUnion<[Type.TString, Type.TInteger]>;
+        syntaxKeyword: Type.TUnion<[Type.TString, Type.TInteger]>;
+        syntaxFunction: Type.TUnion<[Type.TString, Type.TInteger]>;
+        syntaxVariable: Type.TUnion<[Type.TString, Type.TInteger]>;
+        syntaxString: Type.TUnion<[Type.TString, Type.TInteger]>;
+        syntaxNumber: Type.TUnion<[Type.TString, Type.TInteger]>;
+        syntaxType: Type.TUnion<[Type.TString, Type.TInteger]>;
+        syntaxOperator: Type.TUnion<[Type.TString, Type.TInteger]>;
+        syntaxPunctuation: Type.TUnion<[Type.TString, Type.TInteger]>;
+        thinkingOff: Type.TUnion<[Type.TString, Type.TInteger]>;
+        thinkingMinimal: Type.TUnion<[Type.TString, Type.TInteger]>;
+        thinkingLow: Type.TUnion<[Type.TString, Type.TInteger]>;
+        thinkingMedium: Type.TUnion<[Type.TString, Type.TInteger]>;
+        thinkingHigh: Type.TUnion<[Type.TString, Type.TInteger]>;
+        thinkingXhigh: Type.TUnion<[Type.TString, Type.TInteger]>;
+        thinkingMax: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
+        bashMode: Type.TUnion<[Type.TString, Type.TInteger]>;
+    }>;
+    export: Type.TOptional<Type.TObject<{
+        pageBg: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
+        cardBg: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
+        infoBg: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
+    }>>;
+}>;
+export type ThemeColorValue = Static<typeof ColorValueSchema>;
+export type ValidatedThemeJson = Static<typeof ThemeJsonSchema>;
+/** Validate one theme document, throwing a message that names the offending tokens. */
+export declare function validateThemeJson(label: string, json: unknown): ValidatedThemeJson;
+export {};

package/dist/modes/interactive/theme/theme-json.js

@@ -0,0 +1,129 @@
+/**
+ * Theme JSON validation, kept out of `theme.ts` on purpose.
+ *
+ * Validating user-authored theme files needs typebox, which costs ~17 MB of module graph to import.
+ * Palette lookup does not, so a presentation that only uses built-in themes should never pay for it.
+ * `interactive-mode.ts` installs this validator; anything that does not simply skips validation, as
+ * built-in themes already do.
+ */
+import { Type } from "typebox";
+import { Compile } from "typebox/compile";
+const ColorValueSchema = Type.Union([
+    Type.String(), // hex "#ff0000", var ref "primary", or empty ""
+    Type.Integer({ minimum: 0, maximum: 255 }), // 256-color index
+]);
+const ThemeJsonSchema = Type.Object({
+    $schema: Type.Optional(Type.String()),
+    name: Type.String(),
+    vars: Type.Optional(Type.Record(Type.String(), ColorValueSchema)),
+    colors: Type.Object({
+        // Core UI (11 colors)
+        accent: ColorValueSchema,
+        border: ColorValueSchema,
+        borderAccent: ColorValueSchema,
+        borderMuted: ColorValueSchema,
+        success: ColorValueSchema,
+        error: ColorValueSchema,
+        warning: ColorValueSchema,
+        muted: ColorValueSchema,
+        dim: ColorValueSchema,
+        text: ColorValueSchema,
+        thinkingText: ColorValueSchema,
+        // Scrollbar (2 optional colors)
+        scrollbarTrack: Type.Optional(ColorValueSchema),
+        scrollbarThumb: Type.Optional(ColorValueSchema),
+        // Backgrounds & Content Text (11 required, 2 optional)
+        selectedBg: ColorValueSchema,
+        searchMatchBg: Type.Optional(ColorValueSchema),
+        searchMatchText: Type.Optional(ColorValueSchema),
+        userMessageBg: ColorValueSchema,
+        userMessageText: ColorValueSchema,
+        customMessageBg: ColorValueSchema,
+        customMessageText: ColorValueSchema,
+        customMessageLabel: ColorValueSchema,
+        toolPendingBg: ColorValueSchema,
+        toolSuccessBg: ColorValueSchema,
+        toolErrorBg: ColorValueSchema,
+        toolTitle: ColorValueSchema,
+        toolOutput: ColorValueSchema,
+        // Markdown (10 colors)
+        mdHeading: ColorValueSchema,
+        mdLink: ColorValueSchema,
+        mdLinkUrl: ColorValueSchema,
+        mdCode: ColorValueSchema,
+        mdCodeBlock: ColorValueSchema,
+        mdCodeBlockBorder: ColorValueSchema,
+        mdQuote: ColorValueSchema,
+        mdQuoteBorder: ColorValueSchema,
+        mdHr: ColorValueSchema,
+        mdListBullet: ColorValueSchema,
+        // Tool Diffs (3 colors)
+        toolDiffAdded: ColorValueSchema,
+        toolDiffRemoved: ColorValueSchema,
+        toolDiffContext: ColorValueSchema,
+        // Syntax Highlighting (9 colors)
+        syntaxComment: ColorValueSchema,
+        syntaxKeyword: ColorValueSchema,
+        syntaxFunction: ColorValueSchema,
+        syntaxVariable: ColorValueSchema,
+        syntaxString: ColorValueSchema,
+        syntaxNumber: ColorValueSchema,
+        syntaxType: ColorValueSchema,
+        syntaxOperator: ColorValueSchema,
+        syntaxPunctuation: ColorValueSchema,
+        // Thinking Level Borders (6 colors)
+        thinkingOff: ColorValueSchema,
+        thinkingMinimal: ColorValueSchema,
+        thinkingLow: ColorValueSchema,
+        thinkingMedium: ColorValueSchema,
+        thinkingHigh: ColorValueSchema,
+        thinkingXhigh: ColorValueSchema,
+        thinkingMax: Type.Optional(ColorValueSchema),
+        // Bash Mode (1 color)
+        bashMode: ColorValueSchema,
+    }),
+    export: Type.Optional(Type.Object({
+        pageBg: Type.Optional(ColorValueSchema),
+        cardBg: Type.Optional(ColorValueSchema),
+        infoBg: Type.Optional(ColorValueSchema),
+    })),
+});
+const compiledThemeSchema = Compile(ThemeJsonSchema);
+/** Validate one theme document, throwing a message that names the offending tokens. */
+export function validateThemeJson(label, json) {
+    if (!compiledThemeSchema.Check(json)) {
+        const errors = Array.from(compiledThemeSchema.Errors(json));
+        const missingColors = new Set();
+        const otherErrors = [];
+        for (const error of errors) {
+            if (error.keyword === "required" && error.instancePath === "/colors") {
+                const requiredProperties = error.params.requiredProperties;
+                for (const requiredProperty of requiredProperties ?? []) {
+                    missingColors.add(requiredProperty);
+                }
+                continue;
+            }
+            const path = error.instancePath || "/";
+            otherErrors.push(`  - ${path}: ${error.message}`);
+        }
+        let errorMessage = `Invalid theme "${label}":\n`;
+        if (missingColors.size > 0) {
+            errorMessage += "\nMissing required color tokens:\n";
+            errorMessage += Array.from(missingColors)
+                .sort()
+                .map((color) => `  - ${color}`)
+                .join("\n");
+            errorMessage += '\n\nPlease add these colors to your theme\'s "colors" object.';
+            errorMessage += "\nSee the built-in themes (dark.json, light.json) for reference values.";
+        }
+        if (otherErrors.length > 0) {
+            errorMessage += `\n\nOther errors:\n${otherErrors.join("\n")}`;
+        }
+        throw new Error(errorMessage);
+    }
+    const themeJson = json;
+    if (themeJson.name.includes("/")) {
+        throw new Error(`Invalid theme name "${themeJson.name}": theme names cannot contain "/" because it is reserved for automatic light/dark theme settings.`);
+    }
+    return themeJson;
+}

package/dist/modes/interactive/theme/theme-schema.json

@@ -34,7 +34,7 @@
 		},
 		"colors": {
 			"type": "object",
-			"description": "Theme color definitions (thinkingMax and scrollbarThumb are optional and use compatible fallbacks)",
+			"description": "Theme color definitions (scrollbar, thinkingMax, and search highlight colors are optional and use compatible fallbacks)",
 			"required": [
 				"accent",
 				"border",
@@ -137,6 +137,14 @@
 					"$ref": "#/$defs/colorValue",
 					"description": "Selected item background"
 				},
+				"scrollbarTrack": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Fullscreen scrollbar track foreground (falls back to muted when omitted)"
+				},
+				"scrollbarThumb": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Fullscreen scrollbar thumb foreground (falls back to text when omitted)"
+				},
 				"searchMatchBg": {
 					"$ref": "#/$defs/colorValue",
 					"description": "Transcript search match background and current-match text (falls back to selectedBg when omitted)"

package/dist/modes/interactive/theme/theme.d.ts

@@ -1,10 +1,20 @@
 import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
 import { type EditorTheme, type MarkdownTheme, type RgbColor, type SelectListTheme, type SettingsListTheme } from "@earendil-works/pi-tui";
 import type { SourceInfo } from "../../../core/source-info.ts";
-export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "thinkingMax" | "searchMatchText" | "bashMode";
-export type ThemeBg = "selectedBg" | "scrollbarThumb" | "searchMatchBg" | "userMessageBg" | "customMessageBg" | "toolPendingBg" | "toolSuccessBg" | "toolErrorBg";
-type OptionalThemeColor = "thinkingMax" | "searchMatchText";
-type OptionalThemeBg = "scrollbarThumb" | "searchMatchBg";
+/** The schema that validates this shape lives in `theme-json.ts`; importing the type is free. */
+import type { ValidatedThemeJson as ThemeJson } from "./theme-json.ts";
+export type { ValidatedThemeJson as ThemeJson } from "./theme-json.ts";
+export type ThemeJsonValidator = (label: string, json: unknown) => ThemeJson;
+/**
+ * Install full theme validation. Without it, documents are accepted as-is, which is what built-in
+ * themes already do: validating user-authored JSON needs typebox, and a presentation that only uses
+ * built-in themes should not pay ~17 MB of module graph for it.
+ */
+export declare function setThemeJsonValidator(validator: ThemeJsonValidator): void;
+export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "scrollbarTrack" | "scrollbarThumb" | "searchMatchText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "thinkingMax" | "searchMatchText" | "bashMode";
+export type ThemeBg = "selectedBg" | "searchMatchBg" | "userMessageBg" | "customMessageBg" | "toolPendingBg" | "toolSuccessBg" | "toolErrorBg";
+type OptionalThemeColor = "scrollbarTrack" | "scrollbarThumb" | "thinkingMax" | "searchMatchText";
+type OptionalThemeBg = "searchMatchBg";
 type ColorMode = "truecolor" | "256color";
 export declare class Theme {
     readonly name?: string;
@@ -118,4 +128,3 @@ export declare function getMarkdownTheme(): MarkdownTheme;
 export declare function getSelectListTheme(): SelectListTheme;
 export declare function getEditorTheme(): EditorTheme;
 export declare function getSettingsListTheme(): SettingsListTheme;
-export {};

package/dist/modes/interactive/theme/theme.js

@@ -2,93 +2,18 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import { getCapabilities, } from "@earendil-works/pi-tui";
 import chalk from "chalk";
-import { Type } from "typebox";
-import { Compile } from "typebox/compile";
 import { getCustomThemesDir, getThemesDir } from "../../../config.js";
 import { closeWatcher, watchWithErrorHandler } from "../../../utils/fs-watch.js";
 import { highlight, supportsLanguage } from "../../../utils/syntax-highlight.js";
-// ============================================================================
-// Types & Schema
-// ============================================================================
-const ColorValueSchema = Type.Union([
-    Type.String(), // hex "#ff0000", var ref "primary", or empty ""
-    Type.Integer({ minimum: 0, maximum: 255 }), // 256-color index
-]);
-const ThemeJsonSchema = Type.Object({
-    $schema: Type.Optional(Type.String()),
-    name: Type.String(),
-    vars: Type.Optional(Type.Record(Type.String(), ColorValueSchema)),
-    colors: Type.Object({
-        // Core UI (10 colors)
-        accent: ColorValueSchema,
-        border: ColorValueSchema,
-        borderAccent: ColorValueSchema,
-        borderMuted: ColorValueSchema,
-        success: ColorValueSchema,
-        error: ColorValueSchema,
-        warning: ColorValueSchema,
-        muted: ColorValueSchema,
-        dim: ColorValueSchema,
-        text: ColorValueSchema,
-        thinkingText: ColorValueSchema,
-        // Backgrounds & Content Text (11 required, 3 optional)
-        selectedBg: ColorValueSchema,
-        scrollbarThumb: Type.Optional(ColorValueSchema),
-        searchMatchBg: Type.Optional(ColorValueSchema),
-        searchMatchText: Type.Optional(ColorValueSchema),
-        userMessageBg: ColorValueSchema,
-        userMessageText: ColorValueSchema,
-        customMessageBg: ColorValueSchema,
-        customMessageText: ColorValueSchema,
-        customMessageLabel: ColorValueSchema,
-        toolPendingBg: ColorValueSchema,
-        toolSuccessBg: ColorValueSchema,
-        toolErrorBg: ColorValueSchema,
-        toolTitle: ColorValueSchema,
-        toolOutput: ColorValueSchema,
-        // Markdown (10 colors)
-        mdHeading: ColorValueSchema,
-        mdLink: ColorValueSchema,
-        mdLinkUrl: ColorValueSchema,
-        mdCode: ColorValueSchema,
-        mdCodeBlock: ColorValueSchema,
-        mdCodeBlockBorder: ColorValueSchema,
-        mdQuote: ColorValueSchema,
-        mdQuoteBorder: ColorValueSchema,
-        mdHr: ColorValueSchema,
-        mdListBullet: ColorValueSchema,
-        // Tool Diffs (3 colors)
-        toolDiffAdded: ColorValueSchema,
-        toolDiffRemoved: ColorValueSchema,
-        toolDiffContext: ColorValueSchema,
-        // Syntax Highlighting (9 colors)
-        syntaxComment: ColorValueSchema,
-        syntaxKeyword: ColorValueSchema,
-        syntaxFunction: ColorValueSchema,
-        syntaxVariable: ColorValueSchema,
-        syntaxString: ColorValueSchema,
-        syntaxNumber: ColorValueSchema,
-        syntaxType: ColorValueSchema,
-        syntaxOperator: ColorValueSchema,
-        syntaxPunctuation: ColorValueSchema,
-        // Thinking Level Borders (6 colors)
-        thinkingOff: ColorValueSchema,
-        thinkingMinimal: ColorValueSchema,
-        thinkingLow: ColorValueSchema,
-        thinkingMedium: ColorValueSchema,
-        thinkingHigh: ColorValueSchema,
-        thinkingXhigh: ColorValueSchema,
-        thinkingMax: Type.Optional(ColorValueSchema),
-        // Bash Mode (1 color)
-        bashMode: ColorValueSchema,
-    }),
-    export: Type.Optional(Type.Object({
-        pageBg: Type.Optional(ColorValueSchema),
-        cardBg: Type.Optional(ColorValueSchema),
-        infoBg: Type.Optional(ColorValueSchema),
-    })),
-});
-const validateThemeJson = Compile(ThemeJsonSchema);
+let themeJsonValidator;
+/**
+ * Install full theme validation. Without it, documents are accepted as-is, which is what built-in
+ * themes already do: validating user-authored JSON needs typebox, and a presentation that only uses
+ * built-in themes should not pay ~17 MB of module graph for it.
+ */
+export function setThemeJsonValidator(validator) {
+    themeJsonValidator = validator;
+}
 // ============================================================================
 // Color Utilities
 // ============================================================================
@@ -229,8 +154,9 @@ function resolveThemeColors(colors, vars = {}) {
 function withThemeColorFallbacks(colors) {
     return {
         ...colors,
+        scrollbarTrack: colors.scrollbarTrack ?? colors.muted,
+        scrollbarThumb: colors.scrollbarThumb ?? colors.text,
         thinkingMax: colors.thinkingMax ?? colors.thinkingXhigh,
-        scrollbarThumb: colors.scrollbarThumb ?? colors.selectedBg,
         searchMatchBg: colors.searchMatchBg ?? colors.selectedBg,
         searchMatchText: colors.searchMatchText ?? colors.text,
     };
@@ -253,6 +179,8 @@ export class Theme {
         this.fgColors = new Map();
         const colors = {
             ...fgColors,
+            scrollbarTrack: fgColors.scrollbarTrack ?? fgColors.muted,
+            scrollbarThumb: fgColors.scrollbarThumb ?? fgColors.text,
             thinkingMax: fgColors.thinkingMax ?? fgColors.thinkingXhigh,
             searchMatchText: fgColors.searchMatchText ?? fgColors.text,
         };
@@ -262,7 +190,6 @@ export class Theme {
         this.bgColors = new Map();
         const backgrounds = {
             ...bgColors,
-            scrollbarThumb: bgColors.scrollbarThumb ?? bgColors.selectedBg,
             searchMatchBg: bgColors.searchMatchBg ?? bgColors.selectedBg,
         };
         for (const [key, value] of Object.entries(backgrounds)) {
@@ -409,39 +336,12 @@ function assertThemeNameIsValid(name) {
     }
 }
 function parseThemeJson(label, json) {
-    if (!validateThemeJson.Check(json)) {
-        const errors = Array.from(validateThemeJson.Errors(json));
-        const missingColors = new Set();
-        const otherErrors = [];
-        for (const error of errors) {
-            if (error.keyword === "required" && error.instancePath === "/colors") {
-                const requiredProperties = error.params.requiredProperties;
-                for (const requiredProperty of requiredProperties ?? []) {
-                    missingColors.add(requiredProperty);
-                }
-                continue;
-            }
-            const path = error.instancePath || "/";
-            otherErrors.push(`  - ${path}: ${error.message}`);
-        }
-        let errorMessage = `Invalid theme "${label}":\n`;
-        if (missingColors.size > 0) {
-            errorMessage += "\nMissing required color tokens:\n";
-            errorMessage += Array.from(missingColors)
-                .sort()
-                .map((color) => `  - ${color}`)
-                .join("\n");
-            errorMessage += '\n\nPlease add these colors to your theme\'s "colors" object.';
-            errorMessage += "\nSee the built-in themes (dark.json, light.json) for reference values.";
-        }
-        if (otherErrors.length > 0) {
-            errorMessage += `\n\nOther errors:\n${otherErrors.join("\n")}`;
-        }
-        throw new Error(errorMessage);
+    if (themeJsonValidator)
+        return themeJsonValidator(label, json);
+    if (typeof json !== "object" || json === null || !("colors" in json)) {
+        throw new Error(`Invalid theme "${label}": expected an object with a "colors" map.`);
     }
-    const themeJson = json;
-    assertThemeNameIsValid(themeJson.name);
-    return themeJson;
+    return json;
 }
 function parseThemeJsonContent(label, content) {
     let json;
@@ -481,7 +381,6 @@ function createTheme(themeJson, mode, sourcePath) {
     const bgColors = {};
     const bgColorKeys = new Set([
         "selectedBg",
-        "scrollbarThumb",
         "searchMatchBg",
         "userMessageBg",
         "customMessageBg",

package/dist/modes/interactive/tui-renderer.d.ts

@@ -0,0 +1,20 @@
+import type { Terminal } from "@earendil-works/pi-tui";
+import { type TUI, TuiAltScreen, TuiMainScreen } from "@earendil-works/pi-tui";
+export interface InteractiveTuiOptions {
+    readonly tuiMode: "regular" | "fullscreen";
+    readonly showHardwareCursor: boolean;
+    readonly logDirectory: string;
+    readonly terminal?: Terminal;
+    readonly onRightClickPaste?: () => void;
+    readonly fullscreenCopyOnSelect?: boolean;
+}
+/** Composition root shared by coding-agent presentations. */
+export declare function createInteractiveTui(options: InteractiveTuiOptions & {
+    readonly tuiMode: "fullscreen";
+}): TuiAltScreen;
+export declare function createInteractiveTui(options: InteractiveTuiOptions & {
+    readonly tuiMode: "regular";
+}): TuiMainScreen;
+export declare function createInteractiveTui(options: InteractiveTuiOptions): TuiMainScreen | TuiAltScreen;
+/** Stable reference for components while InteractiveMode replaces the active renderer. */
+export declare function createInteractiveTuiReference(getTui: () => TUI): TUI;

package/dist/modes/interactive/tui-renderer.js

@@ -0,0 +1,65 @@
+import { ProcessTerminal, TuiAltScreen, TuiMainScreen } from "@earendil-works/pi-tui";
+import { copyToClipboard } from "../../utils/clipboard.js";
+import { openBrowser } from "../../utils/open-browser.js";
+import { keyDisplayText } from "./components/keybinding-hints.js";
+import { theme } from "./theme/theme.js";
+export function createInteractiveTui(options) {
+    const terminal = options.terminal ?? new ProcessTerminal();
+    if (options.tuiMode === "fullscreen") {
+        const styleSearchMatch = (text) => theme.bg("searchMatchBg", theme.fg("searchMatchText", text));
+        return new TuiAltScreen(terminal, options.showHardwareCursor, options.logDirectory, {
+            searchMatchStyle: (text) => theme.underline(styleSearchMatch(text)),
+            searchCurrentMatchStyle: (text) => theme.bold(theme.inverse(styleSearchMatch(text))),
+            searchNavigationButtonStyle: (text, hovered) => (hovered ? theme.underline(text) : text),
+            scrollToEndIndicator: () => {
+                const shortcut = keyDisplayText("tui.altScreen.bottom");
+                const label = ` ↓ Jump to latest message${shortcut ? ` · ${shortcut}` : ""} `;
+                return theme.bg("selectedBg", theme.fg("text", label));
+            },
+            openUrl: openBrowser,
+            onRightClickPaste: options.onRightClickPaste,
+            copyOnSelect: options.fullscreenCopyOnSelect,
+            copySelection: async (text) => {
+                try {
+                    await copyToClipboard(text);
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            },
+        });
+    }
+    return new TuiMainScreen(terminal, options.showHardwareCursor, options.logDirectory);
+}
+/** Stable reference for components while InteractiveMode replaces the active renderer. */
+export function createInteractiveTuiReference(getTui) {
+    return new Proxy({}, {
+        get: (_target, property) => {
+            const tui = getTui();
+            const value = Reflect.get(tui, property, tui);
+            if (typeof value !== "function")
+                return value;
+            let methodTui = tui;
+            let method = value;
+            return (...args) => {
+                const currentTui = getTui();
+                if (currentTui !== methodTui) {
+                    const currentMethod = Reflect.get(currentTui, property, currentTui);
+                    if (typeof currentMethod !== "function") {
+                        throw new TypeError(`TUI property ${String(property)} is not callable`);
+                    }
+                    methodTui = currentTui;
+                    method = currentMethod;
+                }
+                return Reflect.apply(method, methodTui, args);
+            };
+        },
+        set: (_target, property, value) => {
+            const tui = getTui();
+            return Reflect.set(tui, property, value, tui);
+        },
+        has: (_target, property) => Reflect.has(getTui(), property),
+        getPrototypeOf: () => Reflect.getPrototypeOf(getTui()),
+    });
+}

package/dist/utils/exif-orientation.js

@@ -45,9 +45,8 @@ function findJpegTiffOffset(bytes) {
             const segmentStart = offset + 4;
             if (segmentStart + 6 > bytes.length)
                 return -1;
-            if (!hasExifHeader(bytes, segmentStart))
-                return -1;
-            return segmentStart + 6;
+            if (hasExifHeader(bytes, segmentStart))
+                return segmentStart + 6;
         }
         if (offset + 4 > bytes.length)
             return -1;

package/dist/utils/management-http.d.ts

@@ -0,0 +1,24 @@
+type FetchInput = Parameters<typeof fetch>[0];
+export interface FetchRetryOptions {
+    /** Number of additional attempts after the initial request. Defaults to two. */
+    maxRetries?: number;
+    /** Retry transient HTTP responses as well as transport failures. Defaults to true. */
+    retryOnStatus?: boolean;
+    /** Overall time budget shared by all attempts. */
+    timeoutMs?: number;
+    /** Per-attempt timeout. A new timeout is created for every attempt. */
+    attemptTimeoutMs?: number;
+}
+/**
+ * Fetch a management HTTP resource with a bounded immediate retry.
+ *
+ * This is intentionally a transport-level helper for idempotent management
+ * requests (version checks, catalogs, and downloads). It must not be used for
+ * agent/model operations: those can fail after the HTTP request starts and are
+ * retried by their semantic caller instead.
+ *
+ * Caller cancellation and timeoutMs are terminal. attemptTimeoutMs aborts
+ * only the current attempt so a hung connection can be retried.
+ */
+export declare function fetchWithRetry(input: FetchInput, init?: RequestInit | undefined, options?: FetchRetryOptions): Promise<Response>;
+export {};

package/dist/utils/management-http.js

@@ -0,0 +1,53 @@
+const RETRYABLE_STATUS_CODES = new Set([408, 425, 429, 500, 502, 503, 504]);
+/**
+ * Fetch a management HTTP resource with a bounded immediate retry.
+ *
+ * This is intentionally a transport-level helper for idempotent management
+ * requests (version checks, catalogs, and downloads). It must not be used for
+ * agent/model operations: those can fail after the HTTP request starts and are
+ * retried by their semantic caller instead.
+ *
+ * Caller cancellation and timeoutMs are terminal. attemptTimeoutMs aborts
+ * only the current attempt so a hung connection can be retried.
+ */
+export async function fetchWithRetry(input, init = undefined, options = {}) {
+    const maxRetries = options.maxRetries === undefined || !Number.isFinite(options.maxRetries)
+        ? 2
+        : Math.max(0, Math.floor(options.maxRetries));
+    const retryOnStatus = options.retryOnStatus ?? true;
+    const parentSignal = init?.signal ?? undefined;
+    const timeoutSignal = options.timeoutMs !== undefined && options.timeoutMs > 0 ? AbortSignal.timeout(options.timeoutMs) : undefined;
+    const attemptTimeoutMs = options.attemptTimeoutMs !== undefined && options.attemptTimeoutMs > 0 ? options.attemptTimeoutMs : undefined;
+    for (let attempt = 0;; attempt++) {
+        parentSignal?.throwIfAborted();
+        timeoutSignal?.throwIfAborted();
+        const attemptTimeoutSignal = attemptTimeoutMs ? AbortSignal.timeout(attemptTimeoutMs) : undefined;
+        const signals = [parentSignal, timeoutSignal, attemptTimeoutSignal].filter((signal) => signal !== undefined);
+        const signal = signals.length > 1 ? AbortSignal.any(signals) : signals[0];
+        try {
+            const response = await fetch(input, signal ? { ...init, signal } : init);
+            const shouldRetry = retryOnStatus && RETRYABLE_STATUS_CODES.has(response.status) && attempt < maxRetries;
+            if (!shouldRetry)
+                return response;
+            try {
+                await response.body?.cancel();
+            }
+            catch {
+                // The response is being discarded before a retry. There is nothing useful to
+                // do if cancelling its body also fails.
+            }
+        }
+        catch (error) {
+            const attemptTimedOut = attemptTimeoutSignal?.aborted === true && !parentSignal?.aborted && !timeoutSignal?.aborted;
+            if (parentSignal?.aborted ||
+                timeoutSignal?.aborted ||
+                (error instanceof Error &&
+                    error.name === "AbortError" &&
+                    !attemptTimedOut &&
+                    timeoutSignal === undefined) ||
+                attempt >= maxRetries) {
+                throw error;
+            }
+        }
+    }
+}

package/dist/utils/text.d.ts

@@ -0,0 +1,7 @@
+/** Split a leading UTF-8 byte order mark from decoded text. */
+export declare function splitBom(content: string): {
+    bom: string;
+    text: string;
+};
+/** Remove a leading UTF-8 byte order mark from decoded text. */
+export declare function stripBom(content: string): string;

package/dist/utils/text.js

@@ -0,0 +1,8 @@
+/** Split a leading UTF-8 byte order mark from decoded text. */
+export function splitBom(content) {
+    return content.startsWith("\uFEFF") ? { bom: "\uFEFF", text: content.slice(1) } : { bom: "", text: content };
+}
+/** Remove a leading UTF-8 byte order mark from decoded text. */
+export function stripBom(content) {
+    return splitBom(content).text;
+}