@groeponline/pi-wishcraft 1.4.0 → 1.4.5

package/src/studio/state.ts

@@ -0,0 +1,100 @@
+/**
+ * Pure studio state machine (U5). No TUI imports: tests drive this directly;
+ * component.ts maps raw input bytes onto StudioKeyEvent and re-renders.
+ */
+
+import type { StudioKeyEvent, StudioPaneId, StudioState } from "./types.ts";
+
+export const STUDIO_PANES: readonly StudioPaneId[] = [
+  "list",
+  "detail",
+  "actions",
+  "advice",
+];
+
+export function createStudioState(): StudioState {
+  return {
+    mode: "normal",
+    focus: "list",
+    selectedIndex: 0,
+    filterQuery: "",
+    confirmText: null,
+    exitRequested: false,
+  };
+}
+
+export function handleStudioKey(
+  state: StudioState,
+  event: StudioKeyEvent,
+): StudioState {
+  switch (state.mode) {
+    case "help":
+      return handleHelpKey(state, event);
+    case "filter":
+      return handleFilterKey(state, event);
+    case "confirm":
+      return handleConfirmKey(state, event);
+    case "normal":
+      return handleNormalKey(state, event);
+  }
+}
+
+function handleHelpKey(state: StudioState, event: StudioKeyEvent): StudioState {
+  if (
+    event.key === "printable" && event.char === "q" ||
+    event.key === "escape" ||
+    event.key === "return"
+  ) {
+    return { ...state, mode: "normal" };
+  }
+  return state;
+}
+
+function handleFilterKey(state: StudioState, event: StudioKeyEvent): StudioState {
+  if (event.key === "escape") {
+    return { ...state, mode: "normal", filterQuery: "" };
+  }
+  if (event.key === "return") {
+    return { ...state, mode: "normal" };
+  }
+  if (event.key === "backspace") {
+    return { ...state, filterQuery: state.filterQuery.slice(0, -1) };
+  }
+  if (event.key === "printable" && event.char) {
+    return { ...state, filterQuery: state.filterQuery + event.char };
+  }
+  return state;
+}
+
+function handleConfirmKey(state: StudioState, event: StudioKeyEvent): StudioState {
+  // Confirmation resolution semantics arrive with the U7 action layer; for
+  // now any escape/return leaves confirm mode without changing selection.
+  if (event.key === "escape" || event.key === "return") {
+    return { ...state, mode: "normal", confirmText: null };
+  }
+  return state;
+}
+
+function handleNormalKey(state: StudioState, event: StudioKeyEvent): StudioState {
+  if (event.key === "escape" || (event.key === "printable" && event.char === "q")) {
+    return { ...state, exitRequested: true };
+  }
+  if (event.key === "printable" && event.char === "/") {
+    return { ...state, mode: "filter" };
+  }
+  if (event.key === "printable" && event.char === "?") {
+    return { ...state, mode: "help" };
+  }
+  if (event.key === "tab") {
+    const idx = STUDIO_PANES.indexOf(state.focus);
+    const next = STUDIO_PANES[(idx + 1) % STUDIO_PANES.length]!;
+    return { ...state, focus: next };
+  }
+  if (event.key === "down" || (event.key === "printable" && event.char === "j")) {
+    return { ...state, selectedIndex: state.selectedIndex + 1 };
+  }
+  if (event.key === "up" || (event.key === "printable" && event.char === "k")) {
+    return { ...state, selectedIndex: Math.max(0, state.selectedIndex - 1) };
+  }
+  return state;
+}

package/src/studio/types.ts

@@ -0,0 +1,30 @@
+/** Studio domain types (U5). Kept UI-free; state.ts is the pure reducer. */
+
+export type StudioPaneId = "list" | "detail" | "actions" | "advice";
+
+export type StudioMode = "normal" | "filter" | "confirm" | "help";
+
+export interface StudioState {
+  mode: StudioMode;
+  focus: StudioPaneId;
+  selectedIndex: number;
+  filterQuery: string;
+  /** Pending destructive confirmation text (set by U7 actions). */
+  confirmText: string | null;
+  exitRequested: boolean;
+}
+
+export type StudioKeyKind =
+  | "escape"
+  | "return"
+  | "tab"
+  | "up"
+  | "down"
+  | "backspace"
+  | "printable"
+  | "other";
+
+export interface StudioKeyEvent {
+  key: StudioKeyKind;
+  char?: string;
+}

package/src/welcome/banner.ts

@@ -2,6 +2,7 @@ import type { Component } from "@earendil-works/pi-tui";
 import { dim, renderWelcomeBox } from "./renderer.ts";
 import type { WelcomeData } from "./types.ts";
 import type { LoadedCounts, RecentSession } from "./types.ts";
+import type { WelcomeArtTheme } from "./welcome-art.ts";
 
 /**
  * Welcome header - same layout as overlay but persistent (no countdown).
@@ -39,6 +40,11 @@ export class WelcomeHeader implements Component {
     };
   }
 
+  setArt(art: WelcomeArtTheme, animate: boolean): void {
+    this.data.art = art;
+    this.data.animateArt = animate;
+  }
+
   invalidate(): void {}
 
   render(termWidth: number): string[] {

package/src/welcome/index.ts

@@ -5,3 +5,10 @@ export { discoverLoadedCounts } from "./discover.ts";
 export { getRecentSessions } from "./sessions.ts";
 export { WhatsNewWidget } from "./widgets/whats-new-widget.ts";
 export { discoverWhatsNew, parseChangelogDelta } from "./whats-new.ts";
+export {
+  DEFAULT_WELCOME_ART,
+  WELCOME_ART_THEMES,
+  normalizeWelcomeArt,
+  renderWelcomeArt,
+  type WelcomeArtTheme,
+} from "./welcome-art.ts";

package/src/welcome/overlay.ts

@@ -3,6 +3,7 @@ import { visibleWidth } from "@earendil-works/pi-tui";
 import { dim, renderWelcomeBox } from "./renderer.ts";
 import type { WelcomeData } from "./types.ts";
 import type { LoadedCounts, RecentSession } from "./types.ts";
+import type { WelcomeArtTheme } from "./welcome-art.ts";
 
 // ═══════════════════════════════════════════════════════════════════════════
 // Welcome Components
@@ -49,6 +50,11 @@ export class WelcomeComponent implements Component {
     this.countdown = seconds;
   }
 
+  setArt(art: WelcomeArtTheme, animate: boolean): void {
+    this.data.art = art;
+    this.data.animateArt = animate;
+  }
+
   invalidate(): void {}
 
   render(termWidth: number): string[] {

package/src/welcome/renderer.ts

@@ -2,6 +2,7 @@ import { visibleWidth } from "@earendil-works/pi-tui";
 import { ansi, colorEnabled, fgOnly, getFgAnsiCode } from "../theme/colors.ts";
 import { centerText, fitToWidth, getBoxLayout } from "./layout.ts";
 import type { WelcomeData, WelcomeWidget, WidgetRenderContext } from "./types.ts";
+import { DEFAULT_WELCOME_ART, renderWelcomeArt } from "./welcome-art.ts";
 
 import { QueueWidget } from "./widgets/queue-widget.ts";
 import { SessionsWidget } from "./widgets/sessions-widget.ts";
@@ -9,24 +10,6 @@ import { ShortcutsWidget } from "./widgets/shortcuts-widget.ts";
 import { SystemWidget } from "./widgets/system-widget.ts";
 import { WhatsNewWidget } from "./widgets/whats-new-widget.ts";
 
-const PI_LOGO = [
-  "     . *      ",
-  "   * ╭───╮ .  ",
-  "  .  │   │  * ",
-  "     │   │    ",
-  "   * ╰─┬─╯ .  ",
-  "  .    ┴      ",
-];
-
-const GRADIENT_COLORS = [
-  "\x1b[38;5;199m",
-  "\x1b[38;5;171m",
-  "\x1b[38;5;135m",
-  "\x1b[38;5;99m",
-  "\x1b[38;5;75m",
-  "\x1b[38;5;51m",
-];
-
 function bold(text: string): string {
   return `\x1b[1m${text}\x1b[22m`;
 }
@@ -35,31 +18,15 @@ export function dim(text: string): string {
   return getFgAnsiCode("sep") + text + (colorEnabled() ? ansi.reset : "");
 }
 
-function gradientLine(line: string): string {
-  const reset = ansi.reset;
-  let result = "";
-  let colorIdx = 0;
-  const step = Math.max(1, Math.floor(line.length / GRADIENT_COLORS.length));
-
-  for (let i = 0; i < line.length; i++) {
-    if (i > 0 && i % step === 0 && colorIdx < GRADIENT_COLORS.length - 1)
-      colorIdx++;
-    const char = line[i];
-    if (char !== " ") {
-      result += GRADIENT_COLORS[colorIdx] + char + reset;
-    } else {
-      result += char;
-    }
-  }
-  return result;
-}
-
 function buildLeftColumn(ctx: WidgetRenderContext): string[] {
-  const logoColored = PI_LOGO.map((line) => gradientLine(line));
+  const art = renderWelcomeArt(ctx.data.art ?? DEFAULT_WELCOME_ART, ctx.width, {
+    now: Date.now(),
+    animate: ctx.data.animateArt,
+  });
 
   return [
     "",
-    ...logoColored.map((l) => centerText(l, ctx.width)),
+    ...art,
     "",
     centerText(fgOnly("model", ctx.data.modelName), ctx.width),
     centerText(dim(ctx.data.providerName), ctx.width),

package/src/welcome/types.ts

@@ -1,3 +1,5 @@
+import type { WelcomeArtTheme } from "./welcome-art.ts";
+
 export interface LoadedCounts {
   contextFiles: number;
   extensions: number;
@@ -20,6 +22,10 @@ export interface WelcomeData {
   hasStash?: boolean;
   nextIdeaText?: string;
   whatsNew?: string[];
+  /** Left-column art theme (lantern / balloon / normal). */
+  art?: WelcomeArtTheme;
+  /** Animate the lantern flame. */
+  animateArt?: boolean;
 }
 
 export interface WelcomeWidget {

package/src/welcome/welcome-art.ts

@@ -0,0 +1,148 @@
+/**
+ * welcome-art.ts
+ * ---------------------------------------------------------------------------
+ * The welcome overlay's left-column art, as selectable themes:
+ *
+ *   - "lantern" — a Kongming wish-lantern (wenslantaarn): the detailed
+ *     truecolor pixel art from lantern-art.ts, rendered with half-blocks.
+ *   - "balloon" — a wish-balloon (wensballon): a hand-drawn hot-air balloon.
+ *   - "normal"  — the classic pi mark.
+ *
+ * `renderWelcomeArt` returns coloured, centred lines ready to drop into the
+ * welcome box. The lantern can flicker when `animate` is on.
+ * ---------------------------------------------------------------------------
+ */
+
+import { ansi } from "../theme/colors.ts";
+import { centerText } from "./layout.ts";
+import { renderLantern, LANTERN_WIDTH } from "./lantern.ts";
+
+export type WelcomeArtTheme = "lantern" | "balloon" | "normal";
+
+export const WELCOME_ART_THEMES: readonly WelcomeArtTheme[] = [
+  "lantern",
+  "balloon",
+  "normal",
+];
+
+export const DEFAULT_WELCOME_ART: WelcomeArtTheme = "lantern";
+
+/** Coerce a settings value to a known theme, falling back to the default. */
+export function normalizeWelcomeArt(value: unknown): WelcomeArtTheme {
+  return WELCOME_ART_THEMES.includes(value as WelcomeArtTheme)
+    ? (value as WelcomeArtTheme)
+    : DEFAULT_WELCOME_ART;
+}
+
+export interface WelcomeArtOptions {
+  /** Time source for the lantern flicker; Date.now() is fine. */
+  now?: number;
+  /** Animate the lantern flame (lantern theme only). */
+  animate?: boolean;
+}
+
+// --- Normal: the classic pi mark, warm→cool horizontal gradient -------------
+
+const PI_LOGO = [
+  "     . *      ",
+  "   * ╭───╮ .  ",
+  "  .  │ π │  * ",
+  "     │   │    ",
+  "   * ╰─┬─╯ .  ",
+  "  .    ┴      ",
+];
+
+const PI_GRADIENT = [
+  "\x1b[38;5;199m",
+  "\x1b[38;5;171m",
+  "\x1b[38;5;135m",
+  "\x1b[38;5;99m",
+  "\x1b[38;5;75m",
+  "\x1b[38;5;51m",
+];
+
+// --- Balloon: a wish-balloon (wensballon), warm→gold vertical gradient ------
+
+const BALLOON_ART = [
+  "    ╭───╮    ",
+  "   ╱ ✦ ✦ ╲   ",
+  "  ╱ ✦ ♥ ✦ ╲  ",
+  " │ ✦ ♥ ♥ ✦ │ ",
+  " │  ✦ ♥ ✦  │ ",
+  "  ╲ ✦ ✦ ✦ ╱  ",
+  "   ╲__ __╱   ",
+  "    │╲ ╱│    ",
+  "    │ ⌂ │    ",
+  "    ╰───╯    ",
+];
+
+const BALLOON_GRADIENT = [
+  "\x1b[38;5;213m",
+  "\x1b[38;5;212m",
+  "\x1b[38;5;205m",
+  "\x1b[38;5;204m",
+  "\x1b[38;5;209m",
+  "\x1b[38;5;215m",
+  "\x1b[38;5;221m",
+  "\x1b[38;5;179m",
+  "\x1b[38;5;137m",
+  "\x1b[38;5;95m",
+];
+
+/** Colour a line left-to-right across a palette (non-space cells only). */
+function horizontalGradient(line: string, palette: readonly string[]): string {
+  let result = "";
+  let colorIdx = 0;
+  const step = Math.max(1, Math.floor(line.length / palette.length));
+  for (let i = 0; i < line.length; i++) {
+    if (i > 0 && i % step === 0 && colorIdx < palette.length - 1) colorIdx++;
+    const char = line[i]!;
+    result += char !== " " ? palette[colorIdx] + char + ansi.reset : char;
+  }
+  return result;
+}
+
+/** Colour a whole row with the palette entry for that row index. */
+function rowColor(
+  line: string,
+  rowIndex: number,
+  palette: readonly string[],
+): string {
+  const color = palette[Math.min(rowIndex, palette.length - 1)]!;
+  let result = "";
+  for (const char of line) {
+    result += char !== " " ? color + char + ansi.reset : char;
+  }
+  return result;
+}
+
+/**
+ * Render the chosen art as centred, coloured lines of the given width.
+ * Falls back to the pi mark when a themed art cannot fit the column.
+ */
+export function renderWelcomeArt(
+  theme: WelcomeArtTheme,
+  width: number,
+  opts: WelcomeArtOptions = {},
+): string[] {
+  if (theme === "lantern") {
+    const lantern = renderLantern(
+      { now: opts.now ?? 0, still: !opts.animate },
+      width,
+    );
+    if (lantern.length > 0 && LANTERN_WIDTH <= width) {
+      return lantern.map((line) => centerText(line, width));
+    }
+    // too narrow for the pixel art: fall through to the pi mark
+  }
+
+  if (theme === "balloon") {
+    return BALLOON_ART.map((line, i) =>
+      centerText(rowColor(line, i, BALLOON_GRADIENT), width),
+    );
+  }
+
+  return PI_LOGO.map((line) =>
+    centerText(horizontalGradient(line, PI_GRADIENT), width),
+  );
+}

package/src/working-vibes/frames.ts

@@ -0,0 +1,25 @@
+/** Pure working-indicator frames shared by status renderers and tests. */
+
+export type WorkingIndicatorStyle = "dots" | "pulse" | "bar" | "ascii";
+
+const FRAMES: Record<WorkingIndicatorStyle, readonly string[]> = {
+  dots: ["·  ", "·· ", "···", " ··", "  ·", " ··"],
+  pulse: ["○", "◌", "●", "◌"],
+  bar: ["[=  ]", "[== ]", "[===]", "[ ==]", "[  =]"],
+  ascii: ["-", "\\", "|", "/"],
+};
+
+export function workingIndicatorFrame(
+  style: WorkingIndicatorStyle = "dots",
+  tick = 0,
+  motion: "full" | "reduced" | "functional" | "off" = "full",
+): string {
+  const frames = FRAMES[style] ?? FRAMES.dots;
+  if (motion === "off" || motion === "reduced") return frames[0]!;
+  if (motion === "functional") return frames[tick % 2 === 0 ? 0 : Math.min(1, frames.length - 1)]!;
+  return frames[Math.abs(Math.floor(tick)) % frames.length]!;
+}
+
+export function workingIndicatorStyles(): WorkingIndicatorStyle[] {
+  return Object.keys(FRAMES) as WorkingIndicatorStyle[];
+}

package/src/working-vibes/index.ts

@@ -19,6 +19,8 @@ export {
 } from "./manager.ts";
 
 export type { VibeMode } from "./storage.ts";
+export type { WorkingIndicatorStyle } from "./frames.ts";
+export { workingIndicatorFrame, workingIndicatorStyles } from "./frames.ts";
 
 export type {
   GenerateVibesResult,

package/src/working-vibes/storage.ts

@@ -9,6 +9,7 @@ import { join, dirname } from "node:path";
 import { getAgentPath } from "../paths/agent-dirs.ts";
 
 export type VibeMode = "generate" | "file";
+export type WorkingIndicatorStyle = "dots" | "pulse" | "bar" | "ascii";
 
 // ═══════════════════════════════════════════════════════════════════════════
 // Constants
@@ -51,6 +52,7 @@ export interface VibeConfig {
   refreshInterval: number; // default: 30000ms (30s)
   promptTemplate: string; // template with {theme}, {task}, {exclude} placeholders
   maxLength: number; // default: 65 chars
+  workingIndicatorStyle: WorkingIndicatorStyle;
 }
 
 // ═══════════════════════════════════════════════════════════════════════════
@@ -180,6 +182,14 @@ export function loadConfig(): VibeConfig {
       ? Math.max(0, settings.workingVibeRefreshInterval)
       : 30;
 
+  const rawIndicator = settings.wishcraft && isRecord(settings.wishcraft)
+    ? settings.wishcraft.workingIndicatorStyle
+    : settings.workingIndicatorStyle;
+  const workingIndicatorStyle: WorkingIndicatorStyle =
+    rawIndicator === "pulse" || rawIndicator === "bar" || rawIndicator === "ascii"
+      ? rawIndicator
+      : "dots";
+
   const maxLength =
     typeof settings.workingVibeMaxLength === "number" &&
     Number.isFinite(settings.workingVibeMaxLength)
@@ -204,6 +214,7 @@ export function loadConfig(): VibeConfig {
         ? settings.workingVibePrompt
         : DEFAULT_PROMPT,
     maxLength,
+    workingIndicatorStyle,
   };
 }