cc-face 0.1.10

package/dist/src/generator.js

@@ -0,0 +1,122 @@
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import sharp from 'sharp';
+// ASCII gradient matching ascii_convert.py (dark → light)
+const ASCII_CHARS = '@%#*+=-:. ';
+const ASPECT_RATIO_FACTOR = 0.55;
+let decodedExpressions = null;
+/**
+ * Decode all JPEGs from faces/{name}/img/ into grayscale pixel buffers.
+ * Called once at startup. Caches results in memory.
+ */
+export async function decodeAllFrames(facesDir, expressionNames) {
+    decodedExpressions = new Map();
+    for (const name of expressionNames) {
+        const imgDir = join(facesDir, name, 'img');
+        const configPath = join(facesDir, name, 'config.json');
+        if (!existsSync(imgDir))
+            continue;
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        // Sort JPEG files numerically
+        const files = readdirSync(imgDir)
+            .filter(f => /\.jpe?g$/i.test(f))
+            .sort((a, b) => {
+            const na = parseInt(a);
+            const nb = parseInt(b);
+            return na - nb;
+        });
+        if (files.length === 0)
+            continue;
+        const decoded = [];
+        for (const file of files) {
+            const imgPath = join(imgDir, file);
+            const { data, info } = await sharp(imgPath)
+                .grayscale()
+                .negate() // invert: white→black (same as PIL ImageOps.invert)
+                .raw()
+                .toBuffer({ resolveWithObject: true });
+            decoded.push({
+                pixels: data,
+                srcWidth: info.width,
+                srcHeight: info.height,
+            });
+        }
+        decodedExpressions.set(name, { name, frames: decoded, config });
+    }
+}
+/**
+ * Generate ASCII frames for an expression at the given terminal width.
+ * Uses cached decoded pixel data — no disk I/O.
+ * @param maxRows - optional cap on art height (e.g. visible rows in terminal)
+ */
+export function generateAsciiFrames(expressionName, targetWidth, maxRows) {
+    if (!decodedExpressions)
+        return null;
+    const decoded = decodedExpressions.get(expressionName);
+    if (!decoded)
+        return null;
+    const frames = decoded.frames.map(df => {
+        return rasterizeFrame(df, targetWidth, maxRows);
+    });
+    return {
+        name: expressionName,
+        frames,
+        config: decoded.config,
+    };
+}
+/**
+ * Check if decoded frames are available (sharp loaded + JPEGs decoded).
+ */
+export function hasDecodedFrames() {
+    return decodedExpressions !== null && decodedExpressions.size > 0;
+}
+// Quantization level boundaries — precomputed for the ASCII gradient length
+const NUM_LEVELS = ASCII_CHARS.length; // 10
+const LEVEL_STEP = 255 / (NUM_LEVELS - 1); // ~28.33
+// ── Internal ───────────────────────────────────────────────────────
+function rasterizeFrame(df, targetWidth, maxRows) {
+    const { pixels, srcWidth, srcHeight } = df;
+    const aspectRatio = srcHeight / srcWidth;
+    let targetHeight = Math.max(1, Math.floor(targetWidth * aspectRatio * ASPECT_RATIO_FACTOR));
+    // Clamp to maxRows — avoids rasterizing rows that will be clipped by the terminal
+    if (maxRows !== undefined && maxRows > 0) {
+        targetHeight = Math.min(targetHeight, maxRows);
+    }
+    // Downsample source pixels into a float buffer at target resolution,
+    // then apply Floyd-Steinberg dithering in-place before quantizing.
+    const buf = new Float32Array(targetWidth * targetHeight);
+    for (let y = 0; y < targetHeight; y++) {
+        for (let x = 0; x < targetWidth; x++) {
+            const srcX = Math.min(Math.floor(x * srcWidth / targetWidth), srcWidth - 1);
+            const srcY = Math.min(Math.floor(y * srcHeight / targetHeight), srcHeight - 1);
+            buf[y * targetWidth + x] = pixels[srcY * srcWidth + srcX];
+        }
+    }
+    // Floyd-Steinberg dithering: distribute quantization error to neighbors
+    const art = [];
+    const rowBuf = new Array(targetWidth);
+    for (let y = 0; y < targetHeight; y++) {
+        for (let x = 0; x < targetWidth; x++) {
+            const idx = y * targetWidth + x;
+            const oldVal = buf[idx];
+            // Quantize to nearest ASCII level
+            const charIndex = Math.max(0, Math.min(NUM_LEVELS - 1, Math.round(oldVal / LEVEL_STEP)));
+            const newVal = charIndex * LEVEL_STEP;
+            const error = oldVal - newVal;
+            // Distribute error to unvisited neighbors
+            if (x + 1 < targetWidth)
+                buf[idx + 1] += error * 7 / 16;
+            if (y + 1 < targetHeight) {
+                if (x - 1 >= 0)
+                    buf[idx + targetWidth - 1] += error * 3 / 16;
+                buf[idx + targetWidth] += error * 5 / 16;
+                if (x + 1 < targetWidth)
+                    buf[idx + targetWidth + 1] += error * 1 / 16;
+            }
+            rowBuf[x] = ASCII_CHARS[charIndex];
+        }
+        art.push(rowBuf.join(''));
+    }
+    return { art, colors: [] };
+}
+//# sourceMappingURL=generator.js.map

package/dist/src/generator.js.map

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

package/dist/src/ipc.d.ts

@@ -0,0 +1,34 @@
+import { FaceState } from './types.js';
+export declare function getSocketPath(): string;
+export declare function writeDiscovery(socketPath: string): void;
+export declare function readDiscovery(): string | null;
+export declare function clearDiscovery(socketPath: string): void;
+export declare class StateServer {
+    private server;
+    private clients;
+    private socketPath;
+    constructor(socketPath: string);
+    broadcast(state: FaceState): void;
+    broadcastShutdown(): void;
+    private sendToAll;
+    close(): void;
+}
+export declare class StateClient {
+    private socket;
+    private resolveSocketPath;
+    private onState;
+    private onDisconnect?;
+    private onConnect?;
+    private onShutdown?;
+    private buffer;
+    private retryTimer;
+    private closed;
+    constructor(socketPath: string | (() => string | null), onState: (state: FaceState) => void, opts?: {
+        onDisconnect?: () => void;
+        onConnect?: () => void;
+        onShutdown?: () => void;
+    });
+    private connect;
+    private scheduleRetry;
+    close(): void;
+}

package/dist/src/ipc.js

@@ -0,0 +1,203 @@
+import * as net from 'node:net';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import { config } from './config.js';
+// ── Socket path ─────────────────────────────────────────────────────
+export function getSocketPath() {
+    const tmpdir = os.tmpdir();
+    return `${tmpdir}/cc-face-${process.pid}.sock`;
+}
+// ── Discovery file ──────────────────────────────────────────────────
+// A well-known file that the CC wrapper writes its socket path to,
+// so the face terminal can find it without needing --sock.
+const DISCOVERY_PATH = `${os.tmpdir()}/cc-face.active`;
+export function writeDiscovery(socketPath) {
+    fs.writeFileSync(DISCOVERY_PATH, socketPath);
+}
+export function readDiscovery() {
+    try {
+        const socketPath = fs.readFileSync(DISCOVERY_PATH, 'utf-8').trim();
+        if (!socketPath)
+            return null;
+        // Extract PID from socket path (cc-face-<pid>.sock) and check if alive
+        const match = socketPath.match(/cc-face-(\d+)\.sock$/);
+        if (match) {
+            const pid = Number(match[1]);
+            try {
+                process.kill(pid, 0);
+            }
+            catch {
+                // PID is dead — clean up stale files
+                try {
+                    fs.unlinkSync(DISCOVERY_PATH);
+                }
+                catch { /* ignore */ }
+                try {
+                    fs.unlinkSync(socketPath);
+                }
+                catch { /* ignore */ }
+                return null;
+            }
+        }
+        return socketPath;
+    }
+    catch {
+        return null;
+    }
+}
+export function clearDiscovery(socketPath) {
+    try {
+        const current = fs.readFileSync(DISCOVERY_PATH, 'utf-8').trim();
+        if (current === socketPath) {
+            fs.unlinkSync(DISCOVERY_PATH);
+        }
+    }
+    catch {
+        // ignore — file may not exist or already cleared
+    }
+}
+// ── Server (wrapper process — terminal 1) ───────────────────────────
+export class StateServer {
+    server;
+    clients = new Set();
+    socketPath;
+    constructor(socketPath) {
+        this.socketPath = socketPath;
+        // Remove stale socket file if it exists
+        try {
+            fs.unlinkSync(socketPath);
+        }
+        catch {
+            // doesn't exist — fine
+        }
+        this.server = net.createServer((socket) => {
+            this.clients.add(socket);
+            socket.on('close', () => this.clients.delete(socket));
+            socket.on('error', () => this.clients.delete(socket));
+        });
+        this.server.listen(socketPath);
+    }
+    broadcast(state) {
+        this.sendToAll({ state, ts: Date.now() });
+    }
+    broadcastShutdown() {
+        this.sendToAll({ state: 'idle', ts: Date.now(), shutdown: true });
+    }
+    sendToAll(msg) {
+        const line = JSON.stringify(msg) + '\n';
+        for (const socket of this.clients) {
+            try {
+                socket.write(line);
+            }
+            catch {
+                this.clients.delete(socket);
+            }
+        }
+    }
+    close() {
+        for (const socket of this.clients) {
+            try {
+                socket.destroy();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.clients.clear();
+        this.server.close();
+        try {
+            fs.unlinkSync(this.socketPath);
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+// ── Client (face renderer — terminal 2) ─────────────────────────────
+export class StateClient {
+    socket = null;
+    resolveSocketPath;
+    onState;
+    onDisconnect;
+    onConnect;
+    onShutdown;
+    buffer = '';
+    retryTimer = null;
+    closed = false;
+    constructor(socketPath, onState, opts) {
+        this.resolveSocketPath = typeof socketPath === 'string'
+            ? () => socketPath
+            : socketPath;
+        this.onState = onState;
+        this.onDisconnect = opts?.onDisconnect;
+        this.onConnect = opts?.onConnect;
+        this.onShutdown = opts?.onShutdown;
+        this.connect();
+    }
+    connect() {
+        if (this.closed)
+            return;
+        const resolved = this.resolveSocketPath();
+        if (!resolved) {
+            this.scheduleRetry();
+            return;
+        }
+        this.socket = net.createConnection(resolved);
+        this.socket.on('connect', () => {
+            this.buffer = '';
+            this.onConnect?.();
+        });
+        this.socket.on('data', (data) => {
+            this.buffer += data.toString();
+            const lines = this.buffer.split('\n');
+            // Keep the incomplete last chunk in the buffer
+            this.buffer = lines.pop();
+            for (const line of lines) {
+                if (!line)
+                    continue;
+                try {
+                    const msg = JSON.parse(line);
+                    if (msg.shutdown) {
+                        this.onShutdown?.();
+                        return;
+                    }
+                    this.onState(msg.state);
+                }
+                catch {
+                    // malformed JSON — skip
+                }
+            }
+        });
+        this.socket.on('close', () => {
+            if (this.closed)
+                return;
+            this.onDisconnect?.();
+            this.scheduleRetry();
+        });
+        this.socket.on('error', () => {
+            if (this.closed)
+                return;
+            // Will trigger 'close' which handles reconnection
+        });
+    }
+    scheduleRetry() {
+        if (this.closed)
+            return;
+        this.retryTimer = setTimeout(() => {
+            this.retryTimer = null;
+            this.connect();
+        }, config.ipcRetryMs);
+    }
+    close() {
+        this.closed = true;
+        if (this.retryTimer !== null) {
+            clearTimeout(this.retryTimer);
+            this.retryTimer = null;
+        }
+        if (this.socket) {
+            this.socket.destroy();
+            this.socket = null;
+        }
+    }
+}
+//# sourceMappingURL=ipc.js.map

package/dist/src/ipc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.js","sourceRoot":"","sources":["../../src/ipc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,uEAAuE;AAEvE,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;IAC3B,OAAO,GAAG,MAAM,YAAY,OAAO,CAAC,GAAG,OAAO,CAAC;AACjD,CAAC;AAED,uEAAuE;AACvE,mEAAmE;AACnE,2DAA2D;AAE3D,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC;AAEvD,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACnE,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAE7B,uEAAuE;QACvE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACvD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7B,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,qCAAqC;gBACrC,IAAI,CAAC;oBAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBAC7D,IAAI,CAAC;oBAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBACzD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;YAC3B,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC;AAED,uEAAuE;AAEvE,MAAM,OAAO,WAAW;IACd,MAAM,CAAa;IACnB,OAAO,GAAG,IAAI,GAAG,EAAc,CAAC;IAChC,UAAU,CAAS;IAE3B,YAAY,UAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,wCAAwC;QACxC,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;YACxC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACzB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,KAAgB;QACxB,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,iBAAiB;QACf,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IAEO,SAAS,CAAC,GAAoB;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACxC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK;QACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;CACF;AAED,uEAAuE;AAEvE,MAAM,OAAO,WAAW;IACd,MAAM,GAAsB,IAAI,CAAC;IACjC,iBAAiB,CAAsB;IACvC,OAAO,CAA6B;IACpC,YAAY,CAAc;IAC1B,SAAS,CAAc;IACvB,UAAU,CAAc;IACxB,MAAM,GAAG,EAAE,CAAC;IACZ,UAAU,GAAyC,IAAI,CAAC;IACxD,MAAM,GAAG,KAAK,CAAC;IAEvB,YACE,UAA0C,EAC1C,OAAmC,EACnC,IAAqF;QAErF,IAAI,CAAC,iBAAiB,GAAG,OAAO,UAAU,KAAK,QAAQ;YACrD,CAAC,CAAC,GAAG,EAAE,CAAC,UAAU;YAClB,CAAC,CAAC,UAAU,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,IAAI,EAAE,YAAY,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,SAAS,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEO,OAAO;QACb,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAE7C,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YAC7B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9B,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACtC,+CAA+C;YAC/C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;YAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI;oBAAE,SAAS;gBACpB,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;oBAChD,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;wBACjB,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;wBACpB,OAAO;oBACT,CAAC;oBACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAC3B,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO;YACxB,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAC3B,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO;YACxB,kDAAkD;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACxB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC7B,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}

package/dist/src/loader.d.ts

@@ -0,0 +1,12 @@
+import { FaceDefinition } from './types.js';
+import { hasDecodedFrames } from './generator.js';
+export { hasDecodedFrames };
+/**
+ * Decode all JPEGs at startup. Call once before buildFace().
+ */
+export declare function initGenerator(): Promise<void>;
+/**
+ * Build a FaceDefinition at the given terminal dimensions.
+ * Generates ASCII art dynamically from decoded JPEG pixel data.
+ */
+export declare function buildFace(terminalWidth: number, terminalRows?: number): FaceDefinition;

package/dist/src/loader.js

@@ -0,0 +1,63 @@
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { decodeAllFrames, generateAsciiFrames, hasDecodedFrames } from './generator.js';
+export { hasDecodedFrames };
+// ── Locate faces/ directory ──────────────────────────────────────────
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function findProjectRoot() {
+    let dir = __dirname;
+    while (dir !== dirname(dir)) {
+        if (existsSync(join(dir, 'package.json')))
+            return dir;
+        dir = dirname(dir);
+    }
+    throw new Error('Could not find project root (no package.json found)');
+}
+const FACES_DIR = join(findProjectRoot(), 'faces');
+// ── Expression names ─────────────────────────────────────────────────
+const ALL_EXPRESSIONS = ['idle', 'typing', 'thinking', 'listening'];
+// ── Generator init ──────────────────────────────────────────────────
+/**
+ * Decode all JPEGs at startup. Call once before buildFace().
+ */
+export async function initGenerator() {
+    await decodeAllFrames(FACES_DIR, ALL_EXPRESSIONS);
+}
+/**
+ * Terminal chars are ~2× taller than wide. Source images are square (960×960).
+ * ASCII height = width * ASPECT_RATIO_FACTOR (0.55). To make the face fill
+ * available height: maxWidth = availableRows / ASPECT_RATIO_FACTOR.
+ */
+const ASPECT_RATIO_FACTOR = 0.55;
+/**
+ * Build a FaceDefinition at the given terminal dimensions.
+ * Generates ASCII art dynamically from decoded JPEG pixel data.
+ */
+export function buildFace(terminalWidth, terminalRows) {
+    // Reserve 2 rows for status line + padding
+    const availableRows = terminalRows ? Math.max(1, terminalRows - 2) : undefined;
+    // Derive width from height so the face appears square, then clamp to terminal width
+    let effectiveWidth;
+    if (availableRows !== undefined) {
+        const widthFromHeight = Math.floor(availableRows / ASPECT_RATIO_FACTOR);
+        effectiveWidth = Math.min(terminalWidth, widthFromHeight);
+    }
+    else {
+        effectiveWidth = terminalWidth;
+    }
+    const expressions = {};
+    for (const name of ALL_EXPRESSIONS) {
+        const expr = generateAsciiFrames(name, effectiveWidth, availableRows);
+        if (!expr) {
+            throw new Error(`Failed to generate frames for expression "${name}"`);
+        }
+        expressions[name] = expr;
+    }
+    const idleFrame = expressions['idle'].frames[0];
+    const height = idleFrame.art.length;
+    const width = idleFrame.art[0].length;
+    return { name: 'default', width, height, expressions };
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,wEAAwE;AAExE,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,eAAe;IACtB,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,OAAO,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QACtD,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,EAAE,OAAO,CAAC,CAAC;AAEnD,wEAAwE;AAExE,MAAM,eAAe,GAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AAEjF,uEAAuE;AAEvE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,eAAe,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,aAAqB,EAAE,YAAqB;IACpE,2CAA2C;IAC3C,MAAM,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/E,oFAAoF;IACpF,IAAI,cAAsB,CAAC;IAC3B,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,mBAAmB,CAAC,CAAC;QACxE,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,cAAc,GAAG,aAAa,CAAC;IACjC,CAAC;IAED,MAAM,WAAW,GAA+B,EAAE,CAAC;IAEnD,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,6CAA6C,IAAI,GAAG,CAAC,CAAC;QACxE,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;IACpC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEtC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACzD,CAAC"}

package/dist/src/main.d.ts

@@ -0,0 +1,2 @@
+import { CliOptions } from './types.js';
+export declare function run(options: CliOptions): Promise<void>;