@pi-archimedes/ui 2.9.0

package/src/config.test.ts

@@ -0,0 +1,199 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+
+vi.mock("@pi-archimedes/core/settings-io", () => ({
+  loadConfig: vi.fn(),
+  saveConfig: vi.fn(),
+}));
+
+import {
+  loadUIConfig,
+  saveUIConfig,
+  DEFAULT_UI_CONFIG,
+  ANIMATION_STYLES,
+  THINKING_STYLE_VALUES,
+  TOOL_STYLE_VALUES,
+  SPINNER_STYLES,
+  normalizeThinkingStyle,
+  normalizeToolStyle,
+  SPIN_SPEED_MULT,
+} from "./config.js";
+import { loadConfig, saveConfig } from "@pi-archimedes/core/settings-io";
+
+describe("loadUIConfig", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("uses correct namespace archimedes.ui", () => {
+    vi.mocked(loadConfig).mockReturnValue(DEFAULT_UI_CONFIG);
+    loadUIConfig();
+    expect(loadConfig).toHaveBeenCalledWith("archimedes.ui", DEFAULT_UI_CONFIG);
+  });
+
+  it("returns default config when no settings exist", () => {
+    vi.mocked(loadConfig).mockReturnValue(DEFAULT_UI_CONFIG);
+    const result = loadUIConfig();
+    expect(result).toEqual({
+      bashToolStyling: true,
+      codemodeToolStyling: true,
+      mutedTheme: false,
+      autoCollapseThinking: false,
+      thinkingStyle: "Full",
+      toolStyle: "Minimal",
+      codeUnindent: true,
+      labelText: "Thinking...",
+      labelColor: "255,215,0",
+      animationStyle: "vertical-up",
+      editorSpinBorder: true,
+      editorSpinSpeed: "normal",
+      editorSpinLabel: "Working",
+      editorSpinStyle: "pendulum",
+    });
+  });
+
+  it("passes through merged config from settings-io", () => {
+    const merged = { ...DEFAULT_UI_CONFIG, bashToolStyling: false };
+    vi.mocked(loadConfig).mockReturnValue(merged);
+    const result = loadUIConfig();
+    expect(result).toEqual(merged);
+  });
+});
+
+describe("saveUIConfig", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("saves with correct namespace archimedes.ui", () => {
+    saveUIConfig(DEFAULT_UI_CONFIG);
+    expect(saveConfig).toHaveBeenCalledWith("archimedes.ui", DEFAULT_UI_CONFIG);
+  });
+
+  it("passes config through unchanged", () => {
+    const config = { ...DEFAULT_UI_CONFIG, bashToolStyling: false };
+    saveUIConfig(config);
+    expect(saveConfig).toHaveBeenCalledWith("archimedes.ui", config);
+  });
+});
+
+describe("DEFAULT_UI_CONFIG", () => {
+  it("has bashToolStyling and codemodeToolStyling enabled by default along with core defaults", () => {
+    expect(DEFAULT_UI_CONFIG).toEqual({
+      bashToolStyling: true,
+      codemodeToolStyling: true,
+      mutedTheme: false,
+      autoCollapseThinking: false,
+      thinkingStyle: "Full",
+      toolStyle: "Minimal",
+      codeUnindent: true,
+      labelText: "Thinking...",
+      labelColor: "255,215,0",
+      animationStyle: "vertical-up",
+      editorSpinBorder: true,
+      editorSpinSpeed: "normal",
+      editorSpinLabel: "Working",
+      editorSpinStyle: "pendulum",
+    });
+  });
+
+  it("exposes a speed→multiplier map (slow/normal/fast = 1.5/1/0.6)", () => {
+    expect(SPIN_SPEED_MULT).toEqual({ slow: 1.5, normal: 1, fast: 0.6 });
+  });
+});
+
+describe("ANIMATION_STYLES", () => {
+  it("contains all expected styles", () => {
+    expect(ANIMATION_STYLES).toEqual([
+      "diagonal",
+      "top-right",
+      "bottom-left",
+      "bottom-right",
+      "center-out",
+      "wave",
+      "horizontal",
+      "vertical",
+      "vertical-up",
+    ]);
+  });
+});
+
+describe("DEFAULT_UI_CONFIG styles", () => {
+  it("defaults thinkingStyle to Full and toolStyle to Minimal", () => {
+    expect(DEFAULT_UI_CONFIG.thinkingStyle).toBe("Full");
+    expect(DEFAULT_UI_CONFIG.toolStyle).toBe("Minimal");
+  });
+});
+
+describe("style value lists", () => {
+  it("exports the thinking and tool style values", () => {
+    expect(THINKING_STYLE_VALUES).toEqual(["Full", "Compact"]);
+    expect(TOOL_STYLE_VALUES).toEqual(["Native", "Minimal"]);
+  });
+});
+
+describe("SPINNER_STYLES", () => {
+  it("contains the 10 editorSpinStyle values in order", () => {
+    expect(SPINNER_STYLES).toEqual([
+      "typing",
+      "pulse",
+      "rain",
+      "cascade",
+      "columns",
+      "wave-rows",
+      "diagonal-swipe",
+      "sparkle",
+      "pendulum",
+      "marquee",
+    ]);
+  });
+});
+
+describe("normalizeThinkingStyle", () => {
+  it("normalizes current values as-is", () => {
+    expect(normalizeThinkingStyle("Full")).toBe("Full");
+    expect(normalizeThinkingStyle("Compact")).toBe("Compact");
+  });
+
+  it("maps legacy Off to Full", () => {
+    expect(normalizeThinkingStyle("Off")).toBe("Full");
+  });
+
+  it("maps legacy N-lines values to Compact", () => {
+    expect(normalizeThinkingStyle("1 line")).toBe("Compact");
+    expect(normalizeThinkingStyle("3 lines")).toBe("Compact");
+    expect(normalizeThinkingStyle("5 lines")).toBe("Compact");
+  });
+
+  it("normalizes invalid / unknown / non-string values to Full", () => {
+    expect(normalizeThinkingStyle(undefined)).toBe("Full");
+    expect(normalizeThinkingStyle(null)).toBe("Full");
+    expect(normalizeThinkingStyle("")).toBe("Full");
+    expect(normalizeThinkingStyle(123)).toBe("Full");
+    expect(normalizeThinkingStyle(true)).toBe("Full");
+    expect(normalizeThinkingStyle("off")).toBe("Full");
+    expect(normalizeThinkingStyle("2 lines")).toBe("Full");
+  });
+});
+
+describe("normalizeToolStyle", () => {
+  it("normalizes current values as-is", () => {
+    expect(normalizeToolStyle("Native")).toBe("Native");
+    expect(normalizeToolStyle("Minimal")).toBe("Minimal");
+  });
+
+  it("maps legacy Full (dropped auto-expand) to Minimal", () => {
+    expect(normalizeToolStyle("Full")).toBe("Minimal");
+  });
+
+  it("maps legacy Compact to Minimal (the upgrade keeps styling)", () => {
+    expect(normalizeToolStyle("Compact")).toBe("Minimal");
+  });
+
+  it("normalizes invalid / unknown / non-string values to Minimal", () => {
+    expect(normalizeToolStyle(undefined)).toBe("Minimal");
+    expect(normalizeToolStyle(null)).toBe("Minimal");
+    expect(normalizeToolStyle("")).toBe("Minimal");
+    expect(normalizeToolStyle(123)).toBe("Minimal");
+    expect(normalizeToolStyle(true)).toBe("Minimal");
+  });
+});

package/src/config.ts

@@ -0,0 +1,129 @@
+import { loadConfig, saveConfig } from "@pi-archimedes/core/settings-io";
+
+export const ANIMATION_STYLES = [
+  "diagonal",
+  "top-right",
+  "bottom-left",
+  "bottom-right",
+  "center-out",
+  "wave",
+  "horizontal",
+  "vertical",
+  "vertical-up",
+] as const;
+export type AnimationStyle = (typeof ANIMATION_STYLES)[number];
+
+export type ThinkingStyle = "Full" | "Compact";
+export const THINKING_STYLE_VALUES: readonly ThinkingStyle[] = [
+  "Full",
+  "Compact",
+] as const;
+
+/**
+ * How tool rendering is handled. `Minimal` = the archimedes-styled tools
+ * (bash/codemode overrides, minimal collapsed view); `Native` = no archimedes
+ * styling at all — the overrides are not registered, so pi's native tool
+ * rendering stands (and no built-in-takeover startup notice).
+ */
+export type ToolStyle = "Native" | "Minimal";
+export const TOOL_STYLE_VALUES: readonly ToolStyle[] = [
+  "Native",
+  "Minimal",
+] as const;
+
+export const SPINNER_STYLES: readonly SpinnerStyle[] = [
+  "typing",
+  "pulse",
+  "rain",
+  "cascade",
+  "columns",
+  "wave-rows",
+  "diagonal-swipe",
+  "sparkle",
+  "pendulum",
+  "marquee",
+];
+
+export function normalizeThinkingStyle(value: unknown): ThinkingStyle {
+  if (value === "Full" || value === "Compact") return value;
+  if (value === "Off") return "Full";
+  if (value === "1 line" || value === "3 lines" || value === "5 lines") return "Compact";
+  return "Full";
+}
+
+/**
+ * Legacy mappings: `Full` (auto-expand, dropped) → `Minimal` (the user opted
+ * into archimedes styling, which is preserved); `Compact` (styled tools,
+ * native-collapsed presentation) → `Minimal` (styled tools — the upgrade
+ * must not silently strip styling from existing users).
+ */
+export function normalizeToolStyle(value: unknown): ToolStyle {
+  if (value === "Native" || value === "Minimal") return value;
+  if (value === "Full") return "Minimal";
+  if (value === "Compact") return "Minimal";
+  return "Minimal";
+}
+
+export type SpinnerStyle =
+  | "typing"
+  | "pulse"
+  | "rain"
+  | "cascade"
+  | "columns"
+  | "wave-rows"
+  | "diagonal-swipe"
+  | "sparkle"
+  | "pendulum"
+  | "marquee";
+
+export interface UIConfig {
+  bashToolStyling: boolean;
+  codemodeToolStyling: boolean;
+  mutedTheme: boolean;
+  autoCollapseThinking: boolean;
+  thinkingStyle: ThinkingStyle;
+  toolStyle: ToolStyle;
+  codeUnindent: boolean;
+  labelText: string;
+  labelColor: string;
+  animationStyle: AnimationStyle;
+  editorSpinBorder: boolean;
+  editorSpinSpeed: "slow" | "normal" | "fast";
+  editorSpinLabel: string;
+  editorSpinStyle: SpinnerStyle;
+}
+
+export type CoreConfig = UIConfig;
+
+export const DEFAULT_UI_CONFIG: UIConfig = {
+  bashToolStyling: true,
+  codemodeToolStyling: true,
+  mutedTheme: false,
+  autoCollapseThinking: false,
+  thinkingStyle: "Full",
+  toolStyle: "Minimal",
+  codeUnindent: true,
+  labelText: "Thinking...",
+  labelColor: "255,215,0",
+  animationStyle: "vertical-up",
+  editorSpinBorder: true,
+  editorSpinSpeed: "normal",
+  editorSpinLabel: "Working",
+  editorSpinStyle: "pendulum",
+};
+
+export const SPIN_SPEED_MULT: Record<UIConfig["editorSpinSpeed"], number> = {
+  slow: 1.5,
+  normal: 1,
+  fast: 0.6,
+};
+
+const NAMESPACE = "archimedes.ui";
+
+export function loadUIConfig(): UIConfig {
+  return loadConfig(NAMESPACE, DEFAULT_UI_CONFIG);
+}
+
+export function saveUIConfig(config: UIConfig): void {
+  saveConfig(NAMESPACE, config);
+}