claude-face 0.1.0

package/dist/src/scroll.js

@@ -0,0 +1,56 @@
+/**
+ * ANSI scroll-region management.
+ *
+ * Uses DECSTBM (`ESC [ top ; bottom r`) to split the terminal into a
+ * fixed face region at the top and a scrollable content region below.
+ */
+/**
+ * Return current terminal dimensions split by face height.
+ */
+export function getScrollDimensions(faceHeight) {
+    const totalRows = process.stdout.rows ?? 24;
+    const totalCols = process.stdout.columns ?? 80;
+    const faceRows = faceHeight;
+    const contentRows = totalRows - faceHeight;
+    return { faceRows, contentRows, totalRows, totalCols };
+}
+/**
+ * Set the terminal scroll region so that the top `faceHeight` rows are
+ * fixed and only the rows below them scroll.
+ *
+ * Returns a cleanup function that resets the scroll region.
+ */
+export function setupScrollRegion(faceHeight) {
+    const { totalRows } = getScrollDimensions(faceHeight);
+    // DECSTBM: set scroll region from (faceHeight+1) to totalRows (1-indexed)
+    process.stdout.write(`\x1b[${faceHeight + 1};${totalRows}r`);
+    // Move cursor to the first row of the content area
+    process.stdout.write(`\x1b[${faceHeight + 1};1H`);
+    return teardownScrollRegion;
+}
+/**
+ * Reset scroll region to the full terminal and show cursor.
+ */
+export function teardownScrollRegion() {
+    // Reset scroll region
+    process.stdout.write('\x1b[r');
+    // Show cursor
+    process.stdout.write('\x1b[?25h');
+}
+/**
+ * Save cursor position and move to row 0, col 0 (top-left) for face
+ * rendering.  Uses 1-indexed ANSI coordinates.
+ */
+export function moveCursorToFace() {
+    // Save cursor position
+    process.stdout.write('\x1b7');
+    // Move to row 1, col 1 (top-left, 1-indexed)
+    process.stdout.write('\x1b[1;1H');
+}
+/**
+ * Restore the previously saved cursor position.
+ */
+export function restoreCursor() {
+    process.stdout.write('\x1b8');
+}
+//# sourceMappingURL=scroll.js.map

package/dist/src/scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.js","sourceRoot":"","sources":["../../src/scroll.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC;IAC5B,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IAE3C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,MAAM,EAAE,SAAS,EAAE,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAEtD,0EAA0E;IAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,UAAU,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC;IAE7D,mDAAmD;IACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,UAAU,GAAG,CAAC,KAAK,CAAC,CAAC;IAElD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,sBAAsB;IACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,cAAc;IACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,uBAAuB;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/state.d.ts

@@ -0,0 +1,35 @@
+import { FaceState, StateEvent } from './types.js';
+export declare class StateMachine {
+    private state;
+    private idleTimer;
+    private debounceTimer;
+    private feedTimer;
+    private listeningTimer;
+    private onStateChange;
+    private pendingData;
+    private hasPendingData;
+    private lastThinkingMatchTime;
+    constructor(onStateChange: (event: StateEvent) => void);
+    getState(): FaceState;
+    /**
+     * Called when the human presses a key. Transitions to 'listening'
+     * and resets the listening timeout. When the user stops typing for
+     * LISTENING_TIMEOUT_MS, transitions back to idle.
+     */
+    notifyHumanInput(): void;
+    /**
+     * Feed raw PTY data. Instead of processing every chunk synchronously
+     * (hundreds of regex ops + timer create/destroy per second during heavy
+     * output), we accumulate data and process it at a fixed sample rate.
+     * This adds up to 50ms of detection latency, which is imperceptible
+     * given the 100ms debounce on output.
+     */
+    feed(data: string): void;
+    destroy(): void;
+    /**
+     * Process accumulated data: strip ANSI once for the whole batch,
+     * run pattern matching once, check for typing once.
+     */
+    private processPendingData;
+    private transition;
+}

package/dist/src/state.js

@@ -0,0 +1,158 @@
+import { stripAnsi } from './utils.js';
+import { realtimePatterns } from './patterns.js';
+import { config } from './config.js';
+// ── Timeout constants ────────────────────────────────────────────────
+const { idleTimeoutMs: IDLE_TIMEOUT_MS, debounceMs: DEBOUNCE_MS, feedSampleIntervalMs: FEED_SAMPLE_INTERVAL_MS, minPrintableLen: MIN_PRINTABLE_LEN, thinkingCooldownMs: THINKING_COOLDOWN_MS, listeningTimeoutMs: LISTENING_TIMEOUT_MS, } = config;
+// ── Helper: match against a pattern list (first match wins) ─────────
+function matchPatterns(text, entries) {
+    for (const entry of entries) {
+        for (const re of entry.patterns) {
+            if (re.test(text)) {
+                return entry;
+            }
+        }
+    }
+    return null;
+}
+// ── State Machine ────────────────────────────────────────────────────
+export class StateMachine {
+    state = 'idle';
+    idleTimer = null;
+    debounceTimer = null;
+    feedTimer = null;
+    listeningTimer = null;
+    onStateChange;
+    // Accumulated PTY data between processing ticks
+    pendingData = '';
+    hasPendingData = false;
+    // Timestamp of last thinking pattern match — used to suppress
+    // typing transitions during the thinking cooldown window
+    lastThinkingMatchTime = 0;
+    constructor(onStateChange) {
+        this.onStateChange = onStateChange;
+    }
+    getState() {
+        return this.state;
+    }
+    /**
+     * Called when the human presses a key. Transitions to 'listening'
+     * and resets the listening timeout. When the user stops typing for
+     * LISTENING_TIMEOUT_MS, transitions back to idle.
+     */
+    notifyHumanInput() {
+        // Don't override thinking/typing — Claude is actively doing something
+        if (this.state === 'thinking' || this.state === 'typing')
+            return;
+        this.transition('listening');
+        // Reset listening timeout
+        if (this.listeningTimer !== null)
+            clearTimeout(this.listeningTimer);
+        this.listeningTimer = setTimeout(() => {
+            this.listeningTimer = null;
+            if (this.state === 'listening') {
+                this.transition('idle');
+            }
+        }, LISTENING_TIMEOUT_MS);
+    }
+    /**
+     * Feed raw PTY data. Instead of processing every chunk synchronously
+     * (hundreds of regex ops + timer create/destroy per second during heavy
+     * output), we accumulate data and process it at a fixed sample rate.
+     * This adds up to 50ms of detection latency, which is imperceptible
+     * given the 100ms debounce on output.
+     */
+    feed(data) {
+        if (data.length === 0)
+            return;
+        this.pendingData += data;
+        this.hasPendingData = true;
+        // Reset idle timer on every chunk (this is cheap — just a clear + set)
+        if (this.idleTimer !== null)
+            clearTimeout(this.idleTimer);
+        this.idleTimer = setTimeout(() => {
+            this.idleTimer = null;
+            this.transition('idle');
+        }, IDLE_TIMEOUT_MS);
+        // Schedule processing if not already pending
+        if (this.feedTimer === null) {
+            this.feedTimer = setTimeout(() => this.processPendingData(), FEED_SAMPLE_INTERVAL_MS);
+        }
+    }
+    // ── Cleanup ──────────────────────────────────────────────────────
+    destroy() {
+        if (this.idleTimer !== null) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = null;
+        }
+        if (this.debounceTimer !== null) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        if (this.feedTimer !== null) {
+            clearTimeout(this.feedTimer);
+            this.feedTimer = null;
+        }
+        if (this.listeningTimer !== null) {
+            clearTimeout(this.listeningTimer);
+            this.listeningTimer = null;
+        }
+        this.pendingData = '';
+        this.hasPendingData = false;
+    }
+    // ── Private helpers ──────────────────────────────────────────────
+    /**
+     * Process accumulated data: strip ANSI once for the whole batch,
+     * run pattern matching once, check for typing once.
+     */
+    processPendingData() {
+        this.feedTimer = null;
+        if (!this.hasPendingData)
+            return;
+        const raw = this.pendingData;
+        this.pendingData = '';
+        this.hasPendingData = false;
+        const clean = stripAnsi(raw);
+        // Realtime pattern matching (priority order)
+        const match = matchPatterns(clean, realtimePatterns);
+        if (match) {
+            if (match.state === 'thinking') {
+                this.lastThinkingMatchTime = Date.now();
+            }
+            // Cancel listening state — Claude is responding
+            if (this.listeningTimer !== null) {
+                clearTimeout(this.listeningTimer);
+                this.listeningTimer = null;
+            }
+            this.transition(match.state);
+            return;
+        }
+        // "typing" — non-trivial printable text from Claude (not human echo).
+        // If we're in listening state, PTY echo from human keystrokes will appear
+        // but it's short (1-2 chars per keystroke). MIN_PRINTABLE_LEN filters that.
+        // Suppress if we recently saw a thinking pattern.
+        if (this.state !== 'listening') {
+            const inThinkingCooldown = Date.now() - this.lastThinkingMatchTime < THINKING_COOLDOWN_MS;
+            if (inThinkingCooldown)
+                return;
+            const printable = clean.replace(/[\x00-\x1f\x7f]/g, '').trim();
+            if (printable.length >= MIN_PRINTABLE_LEN) {
+                this.transition('typing');
+            }
+        }
+    }
+    transition(next) {
+        if (next === this.state)
+            return;
+        const prev = this.state;
+        this.state = next;
+        // Debounce the callback — only fire after state is stable for DEBOUNCE_MS.
+        // Internal state updates immediately so getState() is always current.
+        if (this.debounceTimer !== null)
+            clearTimeout(this.debounceTimer);
+        this.debounceTimer = setTimeout(() => {
+            this.debounceTimer = null;
+            this.onStateChange({ prev, next: this.state, timestamp: Date.now() });
+        }, DEBOUNCE_MS);
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/src/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"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"}

package/dist/src/theme.d.ts

@@ -0,0 +1,15 @@
+import { ColorRole, ThemeMode, ThemeColors } from './types.js';
+/**
+ * Detect the terminal background color from the COLORFGBG environment variable.
+ * Falls back to 'dark' if not set or unrecognizable.
+ */
+export declare function detectTheme(): 'dark' | 'light';
+/**
+ * Return the ThemeColors for the given mode.
+ * Resolves 'auto' via detectTheme().
+ */
+export declare function getTheme(mode: ThemeMode): ThemeColors;
+/**
+ * Return the ANSI escape code for the given color role.
+ */
+export declare function colorForRole(theme: ThemeColors, role: ColorRole): string;

package/dist/src/theme.js

@@ -0,0 +1,51 @@
+// ── ANSI color codes ────────────────────────────────────────────────
+const DARK_THEME = {
+    outline: '\x1b[36m', // cyan
+    eye: '\x1b[97m', // bright white
+    mouth: '\x1b[33m', // yellow
+    highlight: '\x1b[95m', // bright magenta
+    cheek: '\x1b[91m', // bright red
+    bg: '', // default
+    reset: '\x1b[0m',
+};
+const LIGHT_THEME = {
+    outline: '\x1b[34m', // blue
+    eye: '\x1b[30m', // black
+    mouth: '\x1b[33m', // yellow
+    highlight: '\x1b[35m', // magenta
+    cheek: '\x1b[31m', // red
+    bg: '', // default
+    reset: '\x1b[0m',
+};
+/**
+ * Detect the terminal background color from the COLORFGBG environment variable.
+ * Falls back to 'dark' if not set or unrecognizable.
+ */
+export function detectTheme() {
+    const colorfgbg = process.env.COLORFGBG;
+    if (!colorfgbg) {
+        return 'dark';
+    }
+    // COLORFGBG is typically "fg;bg" where bg >= 8 means light background
+    const parts = colorfgbg.split(';');
+    const bg = parseInt(parts[parts.length - 1], 10);
+    if (isNaN(bg)) {
+        return 'dark';
+    }
+    return bg >= 8 ? 'light' : 'dark';
+}
+/**
+ * Return the ThemeColors for the given mode.
+ * Resolves 'auto' via detectTheme().
+ */
+export function getTheme(mode) {
+    const resolved = mode === 'auto' ? detectTheme() : mode;
+    return resolved === 'light' ? LIGHT_THEME : DARK_THEME;
+}
+/**
+ * Return the ANSI escape code for the given color role.
+ */
+export function colorForRole(theme, role) {
+    return theme[role];
+}
+//# sourceMappingURL=theme.js.map

package/dist/src/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/theme.ts"],"names":[],"mappings":"AAEA,uEAAuE;AAEvE,MAAM,UAAU,GAAgB;IAC9B,OAAO,EAAE,UAAU,EAAK,OAAO;IAC/B,GAAG,EAAE,UAAU,EAAS,eAAe;IACvC,KAAK,EAAE,UAAU,EAAO,SAAS;IACjC,SAAS,EAAE,UAAU,EAAG,iBAAiB;IACzC,KAAK,EAAE,UAAU,EAAO,aAAa;IACrC,EAAE,EAAE,EAAE,EAAkB,UAAU;IAClC,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF,MAAM,WAAW,GAAgB;IAC/B,OAAO,EAAE,UAAU,EAAK,OAAO;IAC/B,GAAG,EAAE,UAAU,EAAS,QAAQ;IAChC,KAAK,EAAE,UAAU,EAAO,SAAS;IACjC,SAAS,EAAE,UAAU,EAAG,UAAU;IAClC,KAAK,EAAE,UAAU,EAAO,MAAM;IAC9B,EAAE,EAAE,EAAE,EAAkB,UAAU;IAClC,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IACxC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,sEAAsE;IACtE,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QACd,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAe;IACtC,MAAM,QAAQ,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAkB,EAAE,IAAe;IAC9D,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,58 @@
+export type ColorRole = 'outline' | 'eye' | 'mouth' | 'highlight' | 'cheek' | 'bg';
+export interface ColorSpan {
+    row: number;
+    col: number;
+    len: number;
+    role: ColorRole;
+}
+export interface Frame {
+    art: string[];
+    colors?: ColorSpan[];
+}
+export interface AnimationConfig {
+    loopDuration: number;
+    reverse: boolean;
+    gap: number;
+    gapMin?: number;
+    gapMax?: number;
+}
+export interface Expression {
+    name: string;
+    frames: Frame[];
+    config: AnimationConfig;
+}
+export interface FaceDefinition {
+    name: string;
+    width: number;
+    height: number;
+    expressions: Record<string, Expression>;
+}
+export type FaceState = 'idle' | 'typing' | 'thinking' | 'listening';
+export interface StateEvent {
+    prev: FaceState;
+    next: FaceState;
+    timestamp: number;
+}
+export type ThemeMode = 'dark' | 'light' | 'auto';
+export interface ThemeColors {
+    outline: string;
+    eye: string;
+    mouth: string;
+    highlight: string;
+    cheek: string;
+    bg: string;
+    reset: string;
+}
+export interface IpcStateMessage {
+    state: FaceState;
+    ts: number;
+}
+export interface CliOptions {
+    facePath?: string;
+    theme: ThemeMode;
+    noFace: boolean;
+    faceOnly: boolean;
+    debug: boolean;
+    help: boolean;
+    version: boolean;
+}

package/dist/src/types.js

@@ -0,0 +1,3 @@
+// ── Color & Frame Types ──────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,wEAAwE"}

package/dist/src/utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Strip all ANSI escape sequences from a string.
+ *
+ * Handles:
+ * - CSI sequences  `ESC [ ... letter`
+ * - OSC sequences  `ESC ] ... BEL`
+ */
+export declare function stripAnsi(str: string): string;
+/**
+ * Center a string within a given width using space padding.
+ *
+ * If the text is longer than `width` it is returned unchanged.
+ */
+export declare function centerText(text: string, width: number): string;

package/dist/src/utils.js

@@ -0,0 +1,26 @@
+/**
+ * Strip all ANSI escape sequences from a string.
+ *
+ * Handles:
+ * - CSI sequences  `ESC [ ... letter`
+ * - OSC sequences  `ESC ] ... BEL`
+ */
+export function stripAnsi(str) {
+    return str
+        .replace(/\x1b\[[0-9;]*[A-Za-z]/g, '')
+        .replace(/\x1b\][^\x07]*\x07/g, '');
+}
+/**
+ * Center a string within a given width using space padding.
+ *
+ * If the text is longer than `width` it is returned unchanged.
+ */
+export function centerText(text, width) {
+    if (text.length >= width)
+        return text;
+    const totalPad = width - text.length;
+    const leftPad = Math.floor(totalPad / 2);
+    const rightPad = totalPad - leftPad;
+    return ' '.repeat(leftPad) + text + ' '.repeat(rightPad);
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,GAAG;SACP,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC;SACrC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAa;IACpD,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAEpC,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "claude-face",
+  "version": "0.1.0",
+  "description": "Animated ASCII face for Claude Code — reacts to AI state in real-time",
+  "type": "module",
+  "bin": {
+    "claude-face": "./dist/bin/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "postinstall": "chmod +x node_modules/node-pty/prebuilds/darwin-*/spawn-helper 2>/dev/null || true",
+    "prepublishOnly": "npm run build",
+    "build": "tsc",
+    "dev": "tsx bin/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "node-pty": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}