@kya-os/cli 0.1.0-beta.5 → 0.1.0-beta.7

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

@@ -0,0 +1,97 @@
+/**
+ * Effect Template
+ * Base template for creating new terminal effects
+ *
+ * To create a new effect:
+ * 1. Copy this file and rename it to your effect name
+ * 2. Update the class name and description
+ * 3. Define your effect-specific options interface
+ * 4. Implement the effect logic in onInitialize and render
+ * 5. Register your effect in src/effects/index.ts
+ */
+import { BaseEffect } from "../types.js";
+/**
+ * Configuration options for the Template effect
+ * Define all customizable parameters here
+ */
+export interface TemplateEffectOptions {
+    /** Duration in milliseconds */
+    duration?: number;
+    /** Primary color for the effect */
+    primaryColor?: string;
+    /** Secondary color for the effect */
+    secondaryColor?: string;
+    /** Speed multiplier for animations */
+    speed?: number;
+}
+/**
+ * Template Effect implementation
+ * Replace "Template" with your effect name throughout
+ */
+export declare class TemplateEffect extends BaseEffect {
+    readonly name = "Template";
+    readonly description = "Description of what this effect does";
+    private options;
+    private animationFrameCount;
+    private totalFrames;
+    private _isEffectComplete;
+    private effectState;
+    constructor(options?: TemplateEffectOptions);
+    /**
+     * Initialize the effect
+     * Called when the effect starts
+     */
+    protected onInitialize(): void;
+    /**
+     * Render the next frame
+     * This is called for each frame of the animation
+     */
+    render(): Promise<string[]>;
+    /**
+     * Update the effect state for the current frame
+     * Implement your animation logic here
+     */
+    private updateEffectState;
+    /**
+     * Determine how to render a specific character
+     * This is where the visual effect is applied
+     */
+    private getCharacterRender;
+    /**
+     * Interpolate between two colors
+     * Utility method for color transitions
+     */
+    private interpolateColor;
+    /**
+     * Get ANSI color code for a color
+     * Converts color to terminal escape sequence
+     */
+    private getColorCode;
+    /**
+     * Render fallback for when effects are disabled
+     * Simply returns the original text
+     */
+    renderFallback(): string[];
+    /**
+     * Check if effect is complete
+     * Return true when the animation should end
+     */
+    isComplete(): boolean;
+    /**
+     * Reset the effect
+     * Called when the effect needs to restart
+     */
+    protected onReset(): void;
+}
+/**
+ * Example usage in src/effects/index.ts:
+ *
+ * import { TemplateEffect } from "./implementations/template.js";
+ *
+ * registerEffect({
+ *   name: "template",
+ *   description: "Description of what this effect does",
+ *   factory: () => new TemplateEffect(),
+ * });
+ */ 
+//# sourceMappingURL=effect-template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"effect-template.d.ts","sourceRoot":"","sources":["../../../src/effects/template/effect-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAS,MAAM,aAAa,CAAC;AAGhD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAGhB;AAYD;;;GAGG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAE5C,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,0CAA0C;IAG9D,OAAO,CAAC,OAAO,CAAkC;IAGjD,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,WAAW,CAAc;gBAErB,OAAO,GAAE,qBAA0B;IAmB/C;;;OAGG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAuB9B;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAwCjC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAkBpB;;;OAGG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;;OAGG;IACH,UAAU,IAAI,OAAO;IAIrB;;;OAGG;IACH,SAAS,CAAC,OAAO,IAAI,IAAI;CAQ1B;AAED;;;;;;;;;;GAUG"}

package/dist/effects/template/effect-template.js

@@ -0,0 +1,208 @@
+/**
+ * Effect Template
+ * Base template for creating new terminal effects
+ *
+ * To create a new effect:
+ * 1. Copy this file and rename it to your effect name
+ * 2. Update the class name and description
+ * 3. Define your effect-specific options interface
+ * 4. Implement the effect logic in onInitialize and render
+ * 5. Register your effect in src/effects/index.ts
+ */
+import { BaseEffect } from "../types.js";
+import { ANSI, easeInOutSine } from "../utils.js";
+/**
+ * Template Effect implementation
+ * Replace "Template" with your effect name throughout
+ */
+export class TemplateEffect extends BaseEffect {
+    constructor(options = {}) {
+        super();
+        // Effect metadata
+        this.name = "Template"; // Change this to your effect name
+        this.description = "Description of what this effect does"; // Update description
+        // Internal state
+        this.animationFrameCount = 0;
+        this.totalFrames = 0;
+        this._isEffectComplete = false;
+        // Merge provided options with defaults
+        this.options = {
+            duration: 3000,
+            primaryColor: "00ff00",
+            secondaryColor: "ffffff",
+            speed: 1.0,
+            // Set default values for all options
+            ...options,
+        };
+        // Initialize state
+        this.effectState = {
+            exampleProperty: 0,
+        };
+    }
+    /**
+     * Initialize the effect
+     * Called when the effect starts
+     */
+    onInitialize() {
+        // Calculate total frames based on duration and frame rate
+        this.totalFrames = Math.floor((this.options.duration / 1000) * this.config.frameRate);
+        // Reset counters
+        this.animationFrameCount = 0;
+        this._isEffectComplete = false;
+        // Initialize character states
+        // Example: Hide all characters initially
+        for (const char of this.characters) {
+            char.visual.symbol = " ";
+            char.visual.colors.fg = this.options.primaryColor;
+        }
+        // Set up any initial state needed for the effect
+        this.effectState = {
+            exampleProperty: 0,
+        };
+    }
+    /**
+     * Render the next frame
+     * This is called for each frame of the animation
+     */
+    async render() {
+        if (!this.isInitialized) {
+            throw new Error("Effect not initialized");
+        }
+        // Update effect state for this frame
+        this.updateEffectState();
+        // Render text line by line
+        const lines = this.text.split("\n");
+        const renderedLines = [];
+        for (let y = 0; y < lines.length; y++) {
+            let line = "";
+            const chars = [...lines[y]];
+            for (let x = 0; x < chars.length; x++) {
+                const char = chars[x];
+                // Apply effect logic to determine how to render this character
+                const { symbol, color } = this.getCharacterRender(char, x, y);
+                if (color) {
+                    const colorCode = this.getColorCode(color);
+                    const resetCode = ANSI.reset;
+                    line += colorCode + symbol + resetCode;
+                }
+                else {
+                    line += symbol;
+                }
+            }
+            renderedLines.push(line);
+        }
+        // Increment frame counter
+        this.animationFrameCount++;
+        return renderedLines;
+    }
+    /**
+     * Update the effect state for the current frame
+     * Implement your animation logic here
+     */
+    updateEffectState() {
+        // Calculate animation progress (0 to 1)
+        const progress = this.animationFrameCount / this.totalFrames;
+        // Apply easing for smooth animation
+        const easedProgress = easeInOutSine(progress);
+        // Update state based on progress
+        this.effectState.exampleProperty = easedProgress;
+        // Example: Check if effect should complete
+        if (progress >= 1.0) {
+            this._isEffectComplete = true;
+        }
+        // Add your effect-specific state updates here
+    }
+    /**
+     * Determine how to render a specific character
+     * This is where the visual effect is applied
+     */
+    getCharacterRender(char, _x, _y) {
+        // Example: Simple fade-in effect
+        const progress = this.effectState.exampleProperty;
+        if (progress < 0.5) {
+            // First half: show nothing
+            return { symbol: " ", color: null };
+        }
+        else {
+            // Second half: fade in the character
+            const fadeProgress = (progress - 0.5) * 2;
+            const color = this.interpolateColor("000000", this.options.primaryColor, fadeProgress);
+            return { symbol: char, color };
+        }
+        // Implement your effect-specific rendering logic here
+    }
+    /**
+     * Interpolate between two colors
+     * Utility method for color transitions
+     */
+    interpolateColor(color1, color2, factor) {
+        const r1 = parseInt(color1.substring(0, 2), 16);
+        const g1 = parseInt(color1.substring(2, 4), 16);
+        const b1 = parseInt(color1.substring(4, 6), 16);
+        const r2 = parseInt(color2.substring(0, 2), 16);
+        const g2 = parseInt(color2.substring(2, 4), 16);
+        const b2 = parseInt(color2.substring(4, 6), 16);
+        const r = Math.round(r1 + (r2 - r1) * factor);
+        const g = Math.round(g1 + (g2 - g1) * factor);
+        const b = Math.round(b1 + (b2 - b1) * factor);
+        return [r, g, b]
+            .map((c) => Math.max(0, Math.min(255, c)).toString(16).padStart(2, "0"))
+            .join("");
+    }
+    /**
+     * Get ANSI color code for a color
+     * Converts color to terminal escape sequence
+     */
+    getColorCode(color) {
+        if (!color || this.config.noColor) {
+            return "";
+        }
+        // For RGB colors, convert to ANSI 24-bit color
+        if (typeof color === "string") {
+            const r = parseInt(color.substring(0, 2), 16);
+            const g = parseInt(color.substring(2, 4), 16);
+            const b = parseInt(color.substring(4, 6), 16);
+            return `\x1b[38;2;${r};${g};${b}m`;
+        }
+        // For XTerm colors
+        return `\x1b[38;5;${color}m`;
+    }
+    /**
+     * Render fallback for when effects are disabled
+     * Simply returns the original text
+     */
+    renderFallback() {
+        return this.text.split("\n");
+    }
+    /**
+     * Check if effect is complete
+     * Return true when the animation should end
+     */
+    isComplete() {
+        return this._isEffectComplete;
+    }
+    /**
+     * Reset the effect
+     * Called when the effect needs to restart
+     */
+    onReset() {
+        this.animationFrameCount = 0;
+        this._isEffectComplete = false;
+        this.effectState = {
+            exampleProperty: 0,
+        };
+        this.onInitialize();
+    }
+}
+/**
+ * Example usage in src/effects/index.ts:
+ *
+ * import { TemplateEffect } from "./implementations/template.js";
+ *
+ * registerEffect({
+ *   name: "template",
+ *   description: "Description of what this effect does",
+ *   factory: () => new TemplateEffect(),
+ * });
+ */ 
+//# sourceMappingURL=effect-template.js.map

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

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

package/dist/effects/types.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Core types and interfaces for the Terminal Effects Engine
+ * Based on TerminalTextEffects Python library architecture
+ */
+/**
+ * RGB color string in hex format (without #)
+ */
+export type RGBColor = string;
+/**
+ * XTerm 256 color code
+ */
+export type XTermColor = number;
+/**
+ * Color can be RGB hex or XTerm-256
+ */
+export type Color = RGBColor | XTermColor | null;
+/**
+ * Color pair for foreground and background
+ */
+export interface ColorPair {
+    fg: Color;
+    bg: Color;
+}
+/**
+ * Character visual state at a point in time
+ */
+export interface CharacterVisual {
+    symbol: string;
+    colors: ColorPair;
+}
+/**
+ * Single frame of animation
+ */
+export interface Frame {
+    characters: CharacterVisual[];
+    duration?: number;
+}
+/**
+ * Terminal dimensions
+ */
+export interface TerminalDimensions {
+    width: number;
+    height: number;
+}
+/**
+ * Coordinate in 2D space
+ */
+export interface Coordinate {
+    x: number;
+    y: number;
+}
+/**
+ * Animation easing function
+ */
+export type EasingFunction = (t: number) => number;
+/**
+ * Effect configuration options
+ */
+export interface EffectConfig {
+    /** Target frame rate (fps) */
+    frameRate: number;
+    /** Use XTerm colors instead of RGB */
+    useXTermColors: boolean;
+    /** Disable all colors */
+    noColor: boolean;
+    /** Canvas dimensions */
+    canvas?: TerminalDimensions;
+    /** Custom parameters for specific effects */
+    [key: string]: any;
+}
+/**
+ * Base interface for all effects
+ */
+export interface Effect {
+    /** Effect name for identification */
+    readonly name: string;
+    /** Effect description */
+    readonly description: string;
+    /** Initialize the effect with text and config */
+    initialize(text: string, config: Partial<EffectConfig>): void;
+    /** Render the next frame of the effect */
+    render(): Promise<string[]>;
+    /** Render fallback plain text version */
+    renderFallback(): string[];
+    /** Check if the effect is complete */
+    isComplete(): boolean;
+    /** Reset the effect to initial state */
+    reset(): void;
+    /** Cleanup any resources */
+    cleanup(): void;
+}
+/**
+ * Scene represents a sequence of visual changes
+ */
+export interface Scene {
+    id: string;
+    frames: Frame[];
+    isLooping: boolean;
+    currentFrame: number;
+}
+/**
+ * Motion path for character movement
+ */
+export interface Path {
+    waypoints: Coordinate[];
+    currentPosition: number;
+    easing?: EasingFunction;
+}
+/**
+ * Character state including position and animation
+ */
+export interface EffectCharacter {
+    id: string;
+    originalSymbol: string;
+    originalPosition: Coordinate;
+    currentPosition: Coordinate;
+    visual: CharacterVisual;
+    motion?: Path;
+    scene?: Scene;
+}
+/**
+ * Effect execution result
+ */
+export interface EffectResult {
+    success: boolean;
+    frames?: string[];
+    error?: Error;
+    duration?: number;
+}
+/**
+ * Terminal capability detection result
+ */
+export interface TerminalCapabilities {
+    supportsColor: boolean;
+    supports256Color: boolean;
+    supportsTrueColor: boolean;
+    dimensions: TerminalDimensions;
+    isInteractive: boolean;
+}
+/**
+ * Effect registry entry
+ */
+export interface EffectRegistryEntry {
+    name: string;
+    description: string;
+    factory: () => Effect;
+}
+/**
+ * Safety configuration for effects
+ */
+export interface SafetyConfig {
+    /** Maximum execution time in milliseconds */
+    maxExecutionTime: number;
+    /** Maximum memory usage in MB */
+    maxMemoryUsage: number;
+    /** Enable performance monitoring */
+    enableMonitoring: boolean;
+    /** Force fallback mode */
+    forceFallback: boolean;
+}
+/**
+ * Performance metrics for monitoring
+ */
+export interface PerformanceMetrics {
+    frameCount: number;
+    totalDuration: number;
+    averageFrameTime: number;
+    maxFrameTime: number;
+    memoryUsage: number;
+}
+/**
+ * Abstract base class for effects
+ */
+export declare abstract class BaseEffect implements Effect {
+    abstract readonly name: string;
+    abstract readonly description: string;
+    protected text: string;
+    protected config: EffectConfig;
+    protected characters: EffectCharacter[];
+    protected frameCount: number;
+    protected isInitialized: boolean;
+    initialize(text: string, config: Partial<EffectConfig>): void;
+    abstract render(): Promise<string[]>;
+    abstract renderFallback(): string[];
+    abstract isComplete(): boolean;
+    reset(): void;
+    cleanup(): void;
+    protected abstract onInitialize(): void;
+    protected abstract onReset(): void;
+    protected onCleanup(): void;
+    protected createCharacters(text: string): EffectCharacter[];
+    protected getCanvasDimensions(): TerminalDimensions;
+}
+/**
+ * Type guard for Color types
+ */
+export declare function isRGBColor(color: Color): color is RGBColor;
+export declare function isXTermColor(color: Color): color is XTermColor;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/effects/types.js

@@ -0,0 +1,80 @@
+/**
+ * Core types and interfaces for the Terminal Effects Engine
+ * Based on TerminalTextEffects Python library architecture
+ */
+/**
+ * Abstract base class for effects
+ */
+export class BaseEffect {
+    constructor() {
+        this.text = "";
+        this.config = {
+            frameRate: 30,
+            useXTermColors: false,
+            noColor: false,
+        };
+        this.characters = [];
+        this.frameCount = 0;
+        this.isInitialized = false;
+    }
+    initialize(text, config) {
+        this.text = text;
+        this.config = { ...this.config, ...config };
+        this.characters = this.createCharacters(text);
+        this.isInitialized = true;
+        this.onInitialize();
+    }
+    reset() {
+        this.frameCount = 0;
+        this.characters = this.createCharacters(this.text);
+        this.onReset();
+    }
+    cleanup() {
+        this.characters = [];
+        this.onCleanup();
+    }
+    onCleanup() {
+        // Optional cleanup hook
+    }
+    createCharacters(text) {
+        const lines = text.split("\n");
+        const characters = [];
+        lines.forEach((line, y) => {
+            [...line].forEach((char, x) => {
+                if (char !== " ") {
+                    characters.push({
+                        id: `${x}-${y}`,
+                        originalSymbol: char,
+                        originalPosition: { x, y },
+                        currentPosition: { x, y },
+                        visual: {
+                            symbol: char,
+                            colors: { fg: null, bg: null },
+                        },
+                    });
+                }
+            });
+        });
+        return characters;
+    }
+    getCanvasDimensions() {
+        if (this.config.canvas) {
+            return this.config.canvas;
+        }
+        // Calculate from text if no canvas specified
+        const lines = this.text.split("\n");
+        const height = lines.length;
+        const width = Math.max(...lines.map((line) => line.length));
+        return { width, height };
+    }
+}
+/**
+ * Type guard for Color types
+ */
+export function isRGBColor(color) {
+    return typeof color === "string" && /^[0-9a-fA-F]{6}$/.test(color);
+}
+export function isXTermColor(color) {
+    return typeof color === "number" && color >= 0 && color <= 255;
+}
+//# sourceMappingURL=types.js.map

package/dist/effects/types.js.map

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