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

package/dist/effects/implementations/waves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waves.d.ts","sourceRoot":"","sources":["../../../src/effects/implementations/waves.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,UAAU,EAIX,MAAM,aAAa,CAAC;AAIrB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uBAAuB;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,SAAS,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,CAAC;IACnD,mCAAmC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAeD;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,WAAW,uDAAuD;IAE3E,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,CAAW;gBAEhB,OAAO,GAAE,kBAAuB;IAe5C;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAuD9B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAkDjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA4D5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6C7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,SAAS,CAAC,OAAO,IAAI,IAAI;CAO1B"}

package/dist/effects/implementations/waves.js

@@ -0,0 +1,278 @@
+/**
+ * Waves Effect
+ * Creates wave patterns that travel across the text
+ */
+import { BaseEffect, } from "../types.js";
+import { ANSI } from "../utils.js";
+import { Gradient, GradientDirection, EASING } from "../gradient.js";
+/**
+ * Waves effect implementation
+ */
+export class WavesEffect extends BaseEffect {
+    constructor(options = {}) {
+        super();
+        this.name = "Waves";
+        this.description = "Creates wave patterns that travel across the text";
+        this.characterStates = new Map();
+        this.animationFrameCount = 0;
+        this.totalFrames = 0;
+        this.wavePosition = 0;
+        this._isEffectComplete = false;
+        this.options = {
+            duration: 4000,
+            waveColors: ["0080ff", "00a0ff", "00c0ff", "00e0ff", "00ffff", "80ffff", "ffffff"],
+            finalColor: "ffffff",
+            waveSpeed: 0.15,
+            waveFrequency: 2,
+            waveAmplitude: 3,
+            direction: "horizontal",
+            useGradient: true,
+            ...options,
+        };
+    }
+    /**
+     * Initialize the effect
+     */
+    onInitialize() {
+        this.totalFrames = Math.floor((this.options.duration / 1000) * this.config.frameRate);
+        // Create gradient if enabled
+        if (this.options.useGradient) {
+            this.gradient = new Gradient({
+                stops: this.options.waveColors,
+                steps: 10,
+                direction: this.options.direction === "vertical"
+                    ? GradientDirection.HORIZONTAL
+                    : GradientDirection.VERTICAL,
+                easingFn: EASING.inOutSine,
+            });
+        }
+        // Initialize character states
+        this.characterStates.clear();
+        const dimensions = this.getCanvasDimensions();
+        for (const char of this.characters) {
+            const key = `${char.originalPosition.x},${char.originalPosition.y}`;
+            // Calculate wave offset based on position and direction
+            let waveOffset = 0;
+            switch (this.options.direction) {
+                case "horizontal":
+                    waveOffset = char.originalPosition.x / dimensions.width;
+                    break;
+                case "vertical":
+                    waveOffset = char.originalPosition.y / dimensions.height;
+                    break;
+                case "diagonal":
+                    waveOffset = (char.originalPosition.x + char.originalPosition.y) /
+                        (dimensions.width + dimensions.height);
+                    break;
+            }
+            this.characterStates.set(key, {
+                phase: "waiting",
+                waveOffset,
+                waveIntensity: 0,
+                originalY: char.originalPosition.y,
+                currentWaveY: char.originalPosition.y,
+                colorIndex: 0,
+                settleProgress: 0,
+            });
+        }
+        this.wavePosition = -0.5; // Start wave off-screen
+        this.animationFrameCount = 0;
+        this._isEffectComplete = false;
+    }
+    /**
+     * Render the next frame
+     */
+    async render() {
+        if (!this.isInitialized) {
+            throw new Error("Effect not initialized");
+        }
+        // Update animation state
+        this.updateAnimationState();
+        // Create the frame
+        const dimensions = this.getCanvasDimensions();
+        const frame = Array(dimensions.height)
+            .fill("")
+            .map(() => Array(dimensions.width).fill(" "));
+        // Render characters
+        for (const char of this.characters) {
+            const key = `${char.originalPosition.x},${char.originalPosition.y}`;
+            const state = this.characterStates.get(key);
+            if (state) {
+                const visual = this.createCharacterVisual(char, state);
+                char.visual = visual;
+                // Use wave-displaced position for horizontal/diagonal waves
+                let x = char.originalPosition.x;
+                let y = char.originalPosition.y;
+                if (this.options.direction !== "vertical" && state.phase === "waving") {
+                    y = Math.round(state.currentWaveY);
+                }
+                else if (this.options.direction === "vertical" && state.phase === "waving") {
+                    // For vertical waves, displace horizontally
+                    x = Math.round(char.originalPosition.x +
+                        Math.sin(state.currentWaveY * Math.PI * this.options.waveFrequency) *
+                            this.options.waveAmplitude);
+                }
+                if (y >= 0 && y < dimensions.height && x >= 0 && x < dimensions.width) {
+                    const colorCode = this.getColorCode(visual.colors.fg);
+                    const resetCode = ANSI.reset;
+                    frame[y][x] = colorCode + visual.symbol + resetCode;
+                }
+            }
+        }
+        this.animationFrameCount++;
+        // Convert frame to strings
+        return frame.map((row) => row.join(""));
+    }
+    /**
+     * Update animation state for all characters
+     */
+    updateAnimationState() {
+        const progress = this.animationFrameCount / this.totalFrames;
+        // Update wave position
+        this.wavePosition += this.options.waveSpeed;
+        // Update character states
+        for (const [key, state] of this.characterStates) {
+            const [_x, _y] = key.split(",").map(Number);
+            // Calculate wave influence
+            const waveDistance = Math.abs(this.wavePosition - state.waveOffset);
+            const waveInfluence = Math.max(0, 1 - waveDistance * 2);
+            if (waveInfluence > 0 && state.phase !== "complete") {
+                state.phase = "waving";
+                state.waveIntensity = waveInfluence;
+                // Calculate wave displacement
+                const wavePhase = (state.waveOffset + this.wavePosition) *
+                    Math.PI * 2 * this.options.waveFrequency;
+                const waveHeight = Math.sin(wavePhase) * this.options.waveAmplitude * waveInfluence;
+                if (this.options.direction !== "vertical") {
+                    state.currentWaveY = state.originalY + waveHeight;
+                }
+                else {
+                    // For vertical waves, we'll use this for horizontal displacement
+                    state.currentWaveY = wavePhase;
+                }
+                // Update color based on wave position
+                if (this.gradient) {
+                    const spectrum = this.gradient.getSpectrum();
+                    state.colorIndex = Math.floor(waveInfluence * (spectrum.length - 1));
+                }
+                else {
+                    state.colorIndex = Math.floor(waveInfluence * (this.options.waveColors.length - 1));
+                }
+            }
+            else if (state.phase === "waving" && waveInfluence === 0) {
+                // Start settling
+                state.phase = "settling";
+            }
+            // Handle settling phase
+            if (state.phase === "settling") {
+                state.settleProgress += 0.05;
+                state.currentWaveY = state.originalY +
+                    (state.currentWaveY - state.originalY) * (1 - state.settleProgress);
+                if (state.settleProgress >= 1) {
+                    state.phase = "complete";
+                    state.currentWaveY = state.originalY;
+                }
+            }
+        }
+        // Check if effect is complete
+        this._isEffectComplete = progress >= 1 ||
+            Array.from(this.characterStates.values()).every(s => s.phase === "complete");
+    }
+    /**
+     * Create visual representation of a character
+     */
+    createCharacterVisual(char, state) {
+        let color = this.options.finalColor;
+        switch (state.phase) {
+            case "waiting":
+                // Use dimmed color while waiting
+                color = "404040";
+                break;
+            case "waving":
+                // Use wave color based on intensity
+                if (this.gradient) {
+                    const spectrum = this.gradient.getSpectrum();
+                    color = spectrum[state.colorIndex] || spectrum[spectrum.length - 1];
+                }
+                else {
+                    color = this.options.waveColors[state.colorIndex] ||
+                        this.options.waveColors[this.options.waveColors.length - 1];
+                }
+                break;
+            case "settling":
+                // Interpolate from wave color to final color
+                const waveColor = this.gradient
+                    ? this.gradient.getSpectrum()[0]
+                    : this.options.waveColors[0];
+                color = this.interpolateColor(waveColor, this.options.finalColor, state.settleProgress);
+                break;
+            case "complete":
+                color = this.options.finalColor;
+                break;
+        }
+        return {
+            symbol: char.originalSymbol,
+            colors: {
+                fg: color,
+                bg: null,
+            },
+        };
+    }
+    /**
+     * Get ANSI color code for a color
+     */
+    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`;
+    }
+    /**
+     * Interpolate between two colors
+     */
+    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("");
+    }
+    /**
+     * Render fallback for when effects are disabled
+     */
+    renderFallback() {
+        return this.text.split("\n");
+    }
+    /**
+     * Check if effect is complete
+     */
+    isComplete() {
+        return this._isEffectComplete;
+    }
+    /**
+     * Reset the effect
+     */
+    onReset() {
+        this.characterStates.clear();
+        this.wavePosition = -0.5;
+        this.animationFrameCount = 0;
+        this._isEffectComplete = false;
+        this.onInitialize();
+    }
+}
+//# sourceMappingURL=waves.js.map

package/dist/effects/implementations/waves.js.map

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

package/dist/effects/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Effect Registry and Exports
+ */
+import { Effect, EffectRegistryEntry } from "./types.js";
+/**
+ * Registry of all available effects
+ */
+export declare const effectRegistry: Map<string, EffectRegistryEntry>;
+/**
+ * Register an effect
+ */
+export declare function registerEffect(entry: EffectRegistryEntry): void;
+/**
+ * Get an effect by name
+ */
+export declare function getEffect(name: string): Effect | null;
+/**
+ * Get all available effects
+ */
+export declare function getAllEffects(): EffectRegistryEntry[];
+export { BurnEffect } from "./implementations/burn.js";
+export { BeamsEffect } from "./implementations/beams.js";
+export { DecryptEffect } from "./implementations/decrypt.js";
+export { BlackholeEffect } from "./implementations/blackhole.js";
+export { WavesEffect } from "./implementations/waves.js";
+export * from "./types.js";
+export * from "./utils.js";
+export * from "./config.js";
+export * from "./safe-executor.js";
+export * from "./effect-runner.js";
+export * from "./cli-integration.js";
+export { Gradient, GradientDirection, GRADIENTS, EASING } from "./gradient.js";
+export { SyncMetric, AnimationEvent, CharacterAnimation, AnimatedCharacter, } from "./animation-engine.js";
+export type { AnimationFrame, AnimationEventHandler, } from "./animation-engine.js";
+export { MotionEvent, CharacterMotion } from "./motion-engine.js";
+export type { Waypoint, Segment, MotionEventHandler } from "./motion-engine.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/effects/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAOzD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAa,CAAC;AAE1E;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGrD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,EAAE,CAErD;AAqCD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGzD,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG/E,OAAO,EACL,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,cAAc,EACd,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGlE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/effects/index.js

@@ -0,0 +1,79 @@
+/**
+ * Effect Registry and Exports
+ */
+import { BurnEffect } from "./implementations/burn.js";
+import { BeamsEffect } from "./implementations/beams.js";
+import { DecryptEffect } from "./implementations/decrypt.js";
+import { BlackholeEffect } from "./implementations/blackhole.js";
+import { WavesEffect } from "./implementations/waves.js";
+/**
+ * Registry of all available effects
+ */
+export const effectRegistry = new Map();
+/**
+ * Register an effect
+ */
+export function registerEffect(entry) {
+    effectRegistry.set(entry.name.toLowerCase(), entry);
+}
+/**
+ * Get an effect by name
+ */
+export function getEffect(name) {
+    const entry = effectRegistry.get(name.toLowerCase());
+    return entry ? entry.factory() : null;
+}
+/**
+ * Get all available effects
+ */
+export function getAllEffects() {
+    return Array.from(effectRegistry.values());
+}
+// Register built-in effects
+registerEffect({
+    name: "burn",
+    description: "Characters are ignited and burn up the screen",
+    factory: () => new BurnEffect(),
+});
+registerEffect({
+    name: "beams",
+    description: "Creates beams which travel over the canvas illuminating the characters",
+    factory: () => new BeamsEffect(),
+});
+// Binary Path effect removed - was causing issues and blocking demo
+registerEffect({
+    name: "decrypt",
+    description: "Movie-style text decryption effect with typing animation",
+    factory: () => new DecryptEffect(),
+});
+registerEffect({
+    name: "blackhole",
+    description: "Characters are consumed by a black hole and explode outwards",
+    factory: () => new BlackholeEffect(),
+});
+registerEffect({
+    name: "waves",
+    description: "Creates wave patterns that travel across the text",
+    factory: () => new WavesEffect(),
+});
+// Export individual effects
+export { BurnEffect } from "./implementations/burn.js";
+export { BeamsEffect } from "./implementations/beams.js";
+// BinaryPathEffect removed - was causing issues
+export { DecryptEffect } from "./implementations/decrypt.js";
+export { BlackholeEffect } from "./implementations/blackhole.js";
+export { WavesEffect } from "./implementations/waves.js";
+// Export types
+export * from "./types.js";
+export * from "./utils.js";
+export * from "./config.js";
+export * from "./safe-executor.js";
+export * from "./effect-runner.js";
+export * from "./cli-integration.js";
+// Export gradient system (has createGradient which conflicts with utils)
+export { Gradient, GradientDirection, GRADIENTS, EASING } from "./gradient.js";
+// Export animation engine (has Scene which conflicts with types)
+export { SyncMetric, AnimationEvent, CharacterAnimation, AnimatedCharacter, } from "./animation-engine.js";
+// Export motion engine (has Path which conflicts with types)
+export { MotionEvent, CharacterMotion } from "./motion-engine.js";
+//# sourceMappingURL=index.js.map

package/dist/effects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/effects/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAqC,IAAI,GAAG,EAAE,CAAC;AAE1E;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,4BAA4B;AAC5B,cAAc,CAAC;IACb,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,+CAA+C;IAC5D,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,UAAU,EAAE;CAChC,CAAC,CAAC;AAEH,cAAc,CAAC;IACb,IAAI,EAAE,OAAO;IACb,WAAW,EACT,wEAAwE;IAC1E,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,WAAW,EAAE;CACjC,CAAC,CAAC;AAEH,oEAAoE;AAEpE,cAAc,CAAC;IACb,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,0DAA0D;IACvE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;CACnC,CAAC,CAAC;AAEH,cAAc,CAAC;IACb,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,8DAA8D;IAC3E,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE;CACrC,CAAC,CAAC;AAEH,cAAc,CAAC;IACb,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,mDAAmD;IAChE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,WAAW,EAAE;CACjC,CAAC,CAAC;AAEH,4BAA4B;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,gDAAgD;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,eAAe;AACf,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AAErC,yEAAyE;AACzE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE/E,iEAAiE;AACjE,OAAO,EACL,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAQ/B,6DAA6D;AAC7D,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/effects/motion-engine.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Motion Path Engine for Terminal Effects
+ * Provides sophisticated character movement with paths, waypoints, and bezier curves
+ */
+import { Coordinate, EasingFunction } from "./types.js";
+/**
+ * Waypoint in a motion path
+ */
+export interface Waypoint {
+    id: string;
+    coordinate: Coordinate;
+    /** Optional bezier control point for curved paths */
+    bezierControl?: Coordinate;
+    /** Hold time at this waypoint (ms) */
+    holdTime?: number;
+}
+/**
+ * Motion segment between two waypoints
+ */
+export interface Segment {
+    start: Waypoint;
+    end: Waypoint;
+    distance: number;
+    /** Bezier curve points if applicable */
+    curvePoints?: Coordinate[];
+}
+/**
+ * Motion path for character movement
+ */
+export declare class Path {
+    readonly id: string;
+    private waypoints;
+    private segments;
+    private _isLooping;
+    private _speed;
+    private _easingFn?;
+    /** Current position along the path (0-1) */
+    private progress;
+    /** Current segment index */
+    private currentSegmentIndex;
+    /** Time spent at current waypoint (for holds) */
+    private holdTimeElapsed;
+    /** Total path distance */
+    private totalDistance;
+    constructor(id: string, speed?: number, easingFn?: EasingFunction);
+    /**
+     * Add a waypoint to the path
+     */
+    newWaypoint(coord: Coordinate, waypointId?: string, bezierControl?: Coordinate, holdTime?: number): Waypoint;
+    /**
+     * Recalculate segments when waypoints change
+     */
+    private recalculateSegments;
+    /**
+     * Calculate bezier curve points
+     */
+    private calculateBezierPoints;
+    /**
+     * Calculate distance between two coordinates
+     */
+    private calculateDistance;
+    /**
+     * Calculate total distance along a path of points
+     */
+    private calculatePathDistance;
+    /**
+     * Set looping behavior
+     */
+    setLooping(isLooping: boolean): void;
+    /**
+     * Set speed
+     */
+    setSpeed(speed: number): void;
+    /**
+     * Get position at current progress
+     */
+    getCurrentPosition(): Coordinate;
+    /**
+     * Get progress within current segment (0-1)
+     */
+    private getSegmentProgress;
+    /**
+     * Update motion progress
+     */
+    update(deltaTime: number): void;
+    /**
+     * Reset the path
+     */
+    reset(): void;
+    /**
+     * Check if path is complete
+     */
+    isComplete(): boolean;
+    /**
+     * Get waypoint count
+     */
+    getWaypointCount(): number;
+    /**
+     * Get total path distance
+     */
+    getTotalDistance(): number;
+}
+/**
+ * Motion event types
+ */
+export declare enum MotionEvent {
+    PATH_COMPLETE = "path_complete",
+    PATH_ACTIVATED = "path_activated",
+    WAYPOINT_REACHED = "waypoint_reached",
+    SEGMENT_ENTERED = "segment_entered"
+}
+/**
+ * Motion event handler
+ */
+export interface MotionEventHandler {
+    event: MotionEvent;
+    pathId?: string;
+    waypointId?: string;
+    callback: () => void;
+}
+/**
+ * Character motion manager
+ */
+export declare class CharacterMotion {
+    private paths;
+    private activePath;
+    private lastUpdateTime;
+    private eventHandlers;
+    private currentPosition;
+    constructor(initialPosition: Coordinate);
+    /**
+     * Create a new path
+     */
+    newPath(pathId: string, speed?: number, easingFn?: EasingFunction): Path;
+    /**
+     * Get a path by ID
+     */
+    queryPath(pathId: string): Path | undefined;
+    /**
+     * Activate a path
+     */
+    activatePath(path: Path): void;
+    /**
+     * Set position directly
+     */
+    setCoordinate(coord: Coordinate): void;
+    /**
+     * Update motion and get current position
+     */
+    update(): Coordinate;
+    /**
+     * Register an event handler
+     */
+    registerEvent(event: MotionEvent, pathId: string, callback: () => void, waypointId?: string): void;
+    /**
+     * Trigger an event
+     */
+    private triggerEvent;
+    /**
+     * Reset all paths
+     */
+    reset(): void;
+    /**
+     * Get current position
+     */
+    getCurrentPosition(): Coordinate;
+}
+//# sourceMappingURL=motion-engine.d.ts.map

package/dist/effects/motion-engine.d.ts.map

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