@kya-os/cli 0.1.0-beta.1 → 0.1.0-beta.11

package/dist/effects/effect-runner.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Effect Runner
+ * Orchestrates terminal effects with proper management
+ */
+import { Effect, EffectConfig } from "./types.js";
+/**
+ * Options for running an effect
+ */
+export interface RunEffectOptions {
+    /** Effect instance to run */
+    effect: Effect;
+    /** Text to animate */
+    text: string;
+    /** Effect-specific configuration */
+    config?: Partial<EffectConfig>;
+    /** Callback when effect completes */
+    onComplete?: () => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Custom output stream */
+    outputStream?: NodeJS.WriteStream;
+    /** Skip the "Press any key to exit" prompt */
+    skipExitPrompt?: boolean;
+    /** Keep text visible after effect (no alternate screen buffer) */
+    persistent?: boolean;
+}
+/**
+ * Effect runner for executing terminal effects
+ */
+export declare class EffectRunner {
+    private terminalState;
+    private isRunning;
+    private currentEffect;
+    private animationHandle;
+    constructor();
+    /**
+     * Run an effect
+     */
+    run(options: RunEffectOptions): Promise<void>;
+    /**
+     * Stop the currently running effect
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if terminal supports effects
+     */
+    private supportsEffects;
+    /**
+     * Setup terminal for effect rendering
+     */
+    private setupTerminal;
+    /**
+     * Run the animation loop
+     */
+    private runAnimation;
+    /**
+     * Clean up terminal state
+     */
+    private cleanup;
+    /**
+     * Check if an effect is currently running
+     */
+    isEffectRunning(): boolean;
+    /**
+     * Get current effect info
+     */
+    getCurrentEffect(): Effect | null;
+}
+//# sourceMappingURL=effect-runner.d.ts.map

package/dist/effects/effect-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-runner.d.ts","sourceRoot":"","sources":["../../src/effects/effect-runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAsB,MAAM,YAAY,CAAC;AAMtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,wBAAwB;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAClC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAWD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,eAAe,CAA+B;;IAUtD;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEnD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;YACW,aAAa;IA2D3B;;OAEG;YACW,YAAY;IA+D1B;;OAEG;YACW,OAAO;IAmCrB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,gBAAgB,IAAI,MAAM,GAAG,IAAI;CAGlC"}

package/dist/effects/effect-runner.js

@@ -0,0 +1,255 @@
+/**
+ * Effect Runner
+ * Orchestrates terminal effects with proper management
+ */
+import { ANSI, getTerminalDimensions, calculateFrameDelay } from "./utils.js";
+import { getConfig } from "./config.js";
+import * as readline from "readline";
+import { stdout } from "process";
+/**
+ * Effect runner for executing terminal effects
+ */
+export class EffectRunner {
+    constructor() {
+        this.isRunning = false;
+        this.currentEffect = null;
+        this.animationHandle = null;
+        this.terminalState = {
+            cursorHidden: false,
+            originalDimensions: getTerminalDimensions(),
+            cleanupHandlers: [],
+        };
+    }
+    /**
+     * Run an effect
+     */
+    async run(options) {
+        if (this.isRunning) {
+            throw new Error("Another effect is already running");
+        }
+        const config = await getConfig();
+        const outputStream = options.outputStream || stdout;
+        // Check if effects are enabled or if terminal doesn't support effects
+        if (!config.enabled || !this.supportsEffects(outputStream)) {
+            // Use fallback
+            const fallbackLines = options.effect.renderFallback();
+            outputStream.write(fallbackLines.join("\n") + "\n");
+            options.onComplete?.();
+            return;
+        }
+        try {
+            this.isRunning = true;
+            this.currentEffect = options.effect;
+            // Setup terminal
+            await this.setupTerminal(outputStream, options.persistent);
+            // Initialize effect
+            const effectConfig = {
+                frameRate: 30 * config.speedMultiplier,
+                useXTermColors: false,
+                noColor: false,
+                canvas: this.terminalState.originalDimensions,
+                ...options.config,
+            };
+            options.effect.initialize(options.text, effectConfig);
+            // Execute with safety wrapper
+            // Since we're handling the animation loop ourselves, we bypass the executor's execute method
+            // and use the animation loop directly with try-catch for safety
+            try {
+                await this.runAnimation(options.effect, outputStream, effectConfig.frameRate, options.skipExitPrompt, options.persistent);
+            }
+            catch (animationError) {
+                // If animation fails, try fallback
+                const fallbackLines = options.effect.renderFallback();
+                outputStream.write(fallbackLines.join("\n") + "\n");
+                throw animationError;
+            }
+            // Clean up
+            await this.cleanup(outputStream, options.persistent);
+            options.onComplete?.();
+        }
+        catch (error) {
+            await this.cleanup(outputStream, options.persistent);
+            const err = error instanceof Error ? error : new Error(String(error));
+            options.onError?.(err);
+            throw err;
+        }
+        finally {
+            this.isRunning = false;
+            this.currentEffect = null;
+        }
+    }
+    /**
+     * Stop the currently running effect
+     */
+    async stop() {
+        if (!this.isRunning || !this.currentEffect) {
+            return;
+        }
+        // Cancel animation
+        if (this.animationHandle) {
+            clearTimeout(this.animationHandle);
+            this.animationHandle = null;
+        }
+        // Clean up effect
+        this.currentEffect.cleanup();
+        await this.cleanup(stdout, false);
+        this.isRunning = false;
+        this.currentEffect = null;
+    }
+    /**
+     * Check if terminal supports effects
+     */
+    supportsEffects(stream) {
+        // Check if we have a TTY and basic terminal capabilities
+        if (!stream.isTTY)
+            return false;
+        if (!process.env.TERM || process.env.TERM === 'dumb')
+            return false;
+        // Check for common CI environments that might not support effects well
+        if (process.env.CI || process.env.GITHUB_ACTIONS)
+            return false;
+        return true;
+    }
+    /**
+     * Setup terminal for effect rendering
+     */
+    async setupTerminal(stream, persistent) {
+        // Only use alternate screen buffer if not in persistent mode
+        if (!persistent) {
+            // Enter alternate screen buffer (prevents scrolling)
+            stream.write("\x1b[?1049h");
+        }
+        // Hide cursor
+        stream.write(ANSI.cursor.hide);
+        this.terminalState.cursorHidden = true;
+        // Clear screen
+        stream.write(ANSI.clear.screen);
+        stream.write(ANSI.cursor.home);
+        // Setup cleanup handlers
+        const handleExit = () => {
+            this.cleanup(stream, persistent).catch(() => { });
+        };
+        const handleResize = () => {
+            this.terminalState.originalDimensions = getTerminalDimensions();
+        };
+        process.on("exit", handleExit);
+        process.on("SIGINT", handleExit);
+        process.on("SIGTERM", handleExit);
+        process.stdout.on("resize", handleResize);
+        this.terminalState.cleanupHandlers.push(() => process.off("exit", handleExit), () => process.off("SIGINT", handleExit), () => process.off("SIGTERM", handleExit), () => process.stdout.off("resize", handleResize));
+        // Setup keyboard handling for cancellation
+        if (stream === stdout) {
+            readline.emitKeypressEvents(process.stdin);
+            if (process.stdin.isTTY) {
+                process.stdin.setRawMode(true);
+            }
+            const handleKeypress = async (_str, key) => {
+                if (key && (key.name === "escape" || (key.ctrl && key.name === "c") || key.name === "x" || key.name === "q")) {
+                    await this.stop();
+                    // Ensure we exit alternate screen
+                    stream.write("\x1b[?1049l");
+                    process.exit(0);
+                }
+            };
+            process.stdin.on("keypress", handleKeypress);
+            this.terminalState.cleanupHandlers.push(() => process.stdin.off("keypress", handleKeypress));
+        }
+    }
+    /**
+     * Run the animation loop
+     */
+    async runAnimation(effect, stream, frameRate, skipExitPrompt, persistent) {
+        const frameDelay = calculateFrameDelay(frameRate);
+        while (!effect.isComplete()) {
+            const startTime = Date.now();
+            // Render frame
+            const lines = await effect.render();
+            // Clear screen and render
+            stream.write(ANSI.cursor.home);
+            stream.write(lines.join("\n"));
+            stream.write(ANSI.clear.toEnd);
+            // Calculate actual delay needed
+            const renderTime = Date.now() - startTime;
+            const delay = Math.max(0, frameDelay - renderTime);
+            // Wait for next frame
+            if (delay > 0) {
+                await new Promise((resolve) => {
+                    this.animationHandle = setTimeout(resolve, delay);
+                });
+            }
+        }
+        // Only show exit prompt if not skipped and not in persistent mode
+        if (!skipExitPrompt && !persistent) {
+            // After animation completes, show exit message
+            stream.write("\n\n");
+            stream.write("\x1b[2m"); // Dim text
+            stream.write("Press any key to exit...");
+            stream.write("\x1b[0m"); // Reset
+            stream.write("\n");
+            // Wait for keypress - ensure we're in raw mode
+            if (process.stdin.isTTY && !process.stdin.isRaw) {
+                process.stdin.setRawMode(true);
+            }
+            await new Promise((resolve) => {
+                const handleKeypress = (_str, _key) => {
+                    process.stdin.off("keypress", handleKeypress);
+                    resolve();
+                };
+                process.stdin.on("keypress", handleKeypress);
+            });
+        }
+        else if (persistent) {
+            // In persistent mode, render the final frame one more time to ensure it's visible
+            const finalLines = await effect.render();
+            stream.write(ANSI.cursor.home);
+            stream.write(finalLines.join("\n"));
+            stream.write(ANSI.clear.toEnd);
+            stream.write("\n");
+        }
+    }
+    /**
+     * Clean up terminal state
+     */
+    async cleanup(stream, persistent) {
+        // Clear animation handle
+        if (this.animationHandle) {
+            clearTimeout(this.animationHandle);
+            this.animationHandle = null;
+        }
+        // Restore cursor
+        if (this.terminalState.cursorHidden) {
+            stream.write(ANSI.cursor.show);
+            this.terminalState.cursorHidden = false;
+        }
+        // Reset terminal
+        stream.write(ANSI.reset);
+        // Only exit alternate screen buffer if not in persistent mode
+        if (!persistent) {
+            // Exit alternate screen buffer
+            stream.write("\x1b[?1049l");
+        }
+        stream.write("\n");
+        // Remove event handlers
+        for (const handler of this.terminalState.cleanupHandlers) {
+            handler();
+        }
+        this.terminalState.cleanupHandlers = [];
+        // Restore stdin mode
+        if (process.stdin.isTTY && stream === stdout) {
+            process.stdin.setRawMode(false);
+        }
+    }
+    /**
+     * Check if an effect is currently running
+     */
+    isEffectRunning() {
+        return this.isRunning;
+    }
+    /**
+     * Get current effect info
+     */
+    getCurrentEffect() {
+        return this.currentEffect;
+    }
+}
+//# sourceMappingURL=effect-runner.js.map

package/dist/effects/effect-runner.js.map

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

package/dist/effects/gradient.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Gradient System for Terminal Effects
+ * Provides comprehensive gradient color mapping capabilities
+ */
+import { Coordinate, TerminalDimensions } from "./types.js";
+/**
+ * Gradient direction options
+ */
+export declare enum GradientDirection {
+    HORIZONTAL = "horizontal",
+    VERTICAL = "vertical",
+    DIAGONAL = "diagonal",
+    RADIAL = "radial",
+    DIAGONAL_REVERSE = "diagonal_reverse"
+}
+/**
+ * Gradient configuration
+ */
+export interface GradientConfig {
+    /** Array of color stops */
+    stops: string[];
+    /** Number of steps between each stop */
+    steps?: number;
+    /** Direction of the gradient */
+    direction?: GradientDirection;
+    /** Easing function for color interpolation */
+    easingFn?: (t: number) => number;
+}
+/**
+ * Gradient class for creating color transitions
+ */
+export declare class Gradient {
+    private colorStops;
+    private steps;
+    private direction;
+    private easingFn;
+    private spectrum;
+    constructor(config: GradientConfig);
+    /**
+     * Generate the full color spectrum
+     */
+    private generateSpectrum;
+    /**
+     * Interpolate between two colors
+     */
+    private interpolateColors;
+    /**
+     * Build coordinate-to-color mapping for a canvas area
+     */
+    buildCoordinateColorMapping(dimensions: TerminalDimensions, bounds?: {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    }): Map<string, string>;
+    /**
+     * Get color at a specific position based on gradient direction
+     */
+    private getColorAtPosition;
+    /**
+     * Get color for a specific coordinate
+     */
+    getColorForCoordinate(coord: Coordinate, dimensions: TerminalDimensions): string;
+    /**
+     * Get the generated color spectrum
+     */
+    getSpectrum(): string[];
+    /**
+     * Apply gradient to a string (character by character)
+     */
+    applyToString(text: string): Array<{
+        char: string;
+        color: string;
+    }>;
+}
+/**
+ * Predefined gradients
+ */
+export declare const GRADIENTS: {
+    FIRE: {
+        stops: string[];
+        steps: number;
+    };
+    OCEAN: {
+        stops: string[];
+        steps: number;
+    };
+    MATRIX: {
+        stops: string[];
+        steps: number;
+    };
+    SUNSET: {
+        stops: string[];
+        steps: number;
+    };
+    COOL: {
+        stops: string[];
+        steps: number;
+    };
+    MONOCHROME: {
+        stops: string[];
+        steps: number;
+    };
+    RAINBOW: {
+        stops: string[];
+        steps: number;
+    };
+};
+/**
+ * Easing functions for gradient interpolation
+ */
+export declare const EASING: {
+    linear: (t: number) => number;
+    inQuad: (t: number) => number;
+    outQuad: (t: number) => number;
+    inOutQuad: (t: number) => number;
+    inCubic: (t: number) => number;
+    outCubic: (t: number) => number;
+    inOutCubic: (t: number) => number;
+    inExpo: (t: number) => number;
+    outExpo: (t: number) => number;
+    inOutExpo: (t: number) => number;
+    inSine: (t: number) => number;
+    outSine: (t: number) => number;
+    inOutSine: (t: number) => number;
+};
+/**
+ * Helper function to create a gradient from preset
+ */
+export declare function createGradient(preset: keyof typeof GRADIENTS, direction?: GradientDirection, easingFn?: (t: number) => number): Gradient;
+//# sourceMappingURL=gradient.d.ts.map

package/dist/effects/gradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.d.ts","sourceRoot":"","sources":["../../src/effects/gradient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE5D;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,gBAAgB,qBAAqB;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,UAAU,CAAW;IAC7B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,MAAM,EAAE,cAAc;IAQlC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,2BAA2B,CACzB,UAAU,EAAE,kBAAkB,EAC9B,MAAM,CAAC,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GACA,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAuBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuC1B;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,kBAAkB,GAAG,MAAM;IAIhF;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAepE;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM;gBACL,MAAM;gBAEN,MAAM;iBACL,MAAM;mBACJ,MAAM;iBAER,MAAM;kBACL,MAAM;oBACJ,MAAM;gBAGV,MAAM;iBACL,MAAM;mBACJ,MAAM;gBAOT,MAAM;iBACL,MAAM;mBACJ,MAAM;CACtB,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,OAAO,SAAS,EAC9B,SAAS,CAAC,EAAE,iBAAiB,EAC7B,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAC/B,QAAQ,CAOV"}