@mudah-cli/animation 0.1.0

package/dist/frames.d.ts

@@ -0,0 +1,8 @@
+export interface SpinnerStyle {
+    /** One frame per entry, cycled in order. */
+    readonly frames: readonly string[];
+    /** Milliseconds per frame. */
+    readonly interval: number;
+}
+export declare const spinnerStyles: Record<string, SpinnerStyle>;
+export declare const defaultSpinner: SpinnerStyle;

package/dist/frames.js

@@ -0,0 +1,24 @@
+export const spinnerStyles = {
+    /** Braille dots — the classic busy indicator. */
+    dots: {
+        frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
+        interval: 80,
+    },
+    /** A slim vertical meter. */
+    meter: {
+        frames: ['▏', '▎', '▍', '▌', '▋', '▊', '▉', '█'],
+        interval: 80,
+    },
+    /** Three-dot pulse. */
+    pulse: {
+        frames: ['·', '•', '●', '•'],
+        interval: 120,
+    },
+    /** ASCII fallback for terminals without unicode. */
+    ascii: {
+        frames: ['|', '/', '-', '\\'],
+        interval: 120,
+    },
+};
+export const defaultSpinner = spinnerStyles['dots'] ?? { frames: ['·'], interval: 100 };
+//# sourceMappingURL=frames.js.map

package/dist/frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.js","sourceRoot":"","sources":["../src/frames.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,aAAa,GAAiC;IACzD,iDAAiD;IACjD,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;QAC1D,QAAQ,EAAE,EAAE;KACb;IACD,6BAA6B;IAC7B,KAAK,EAAE;QACL,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;QAChD,QAAQ,EAAE,EAAE;KACb;IACD,uBAAuB;IACvB,KAAK,EAAE;QACL,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;QAC5B,QAAQ,EAAE,GAAG;KACd;IACD,oDAAoD;IACpD,KAAK,EAAE;QACL,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC;QAC7B,QAAQ,EAAE,GAAG;KACd;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAiB,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { defaultSpinner, spinnerStyles, type SpinnerStyle } from './frames.js';
+export { ProgressBar, type ProgressBarOptions } from './progress.js';
+export { Spinner, type SpinnerOptions } from './spinner.js';
+export { TaskRunner, type TaskRunnerOptions, type TaskSpec } from './tasks.js';

package/dist/index.js

@@ -0,0 +1,5 @@
+export { defaultSpinner, spinnerStyles } from './frames.js';
+export { ProgressBar } from './progress.js';
+export { Spinner } from './spinner.js';
+export { TaskRunner } from './tasks.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,WAAW,EAA2B,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,OAAO,EAAuB,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAyC,MAAM,YAAY,CAAC"}

package/dist/progress.d.ts

@@ -0,0 +1,42 @@
+export interface ProgressBarOptions {
+    total: number;
+    /** Bar width in cells. Default 30. */
+    width?: number;
+    stream?: {
+        write(data: string): unknown;
+        isTTY?: boolean;
+    };
+    unicode?: boolean;
+    label?: string;
+    showEta?: boolean;
+    style?: (text: string) => string;
+    /** Master switch — pass false for silent operation. */
+    enabled?: boolean;
+}
+/**
+ * A single-line progress bar. `render()` is pure and stream-free so the UI
+ * layer (and tests) can compose it however they like.
+ */
+export declare class ProgressBar {
+    value: number;
+    private readonly total;
+    private readonly width;
+    private readonly stream?;
+    private readonly unicode;
+    private readonly label?;
+    private readonly showEta;
+    private readonly style?;
+    private readonly enabled;
+    private readonly eta;
+    constructor(options: ProgressBarOptions);
+    /** Pure rendering of the current state. */
+    render(): string;
+    /** Advance to an absolute value and repaint. */
+    set(value: number): void;
+    /** Advance by a delta and repaint. */
+    inc(by?: number): void;
+    /** Finish: paint 100% and move to a new line. */
+    complete(): void;
+    private paint;
+    private etaText;
+}

package/dist/progress.js

@@ -0,0 +1,80 @@
+/**
+ * A single-line progress bar. `render()` is pure and stream-free so the UI
+ * layer (and tests) can compose it however they like.
+ */
+export class ProgressBar {
+    value = 0;
+    total;
+    width;
+    stream;
+    unicode;
+    label;
+    showEta;
+    style;
+    enabled;
+    eta;
+    constructor(options) {
+        this.total = Math.max(1, options.total);
+        this.width = options.width ?? 30;
+        this.stream = options.stream;
+        this.unicode = options.unicode ?? true;
+        this.label = options.label;
+        this.showEta = options.showEta ?? false;
+        this.style = options.style;
+        this.enabled = options.enabled ?? this.stream?.isTTY === true;
+        this.eta = { startedAt: performance.now() };
+    }
+    /** Pure rendering of the current state. */
+    render() {
+        const clamped = Math.min(this.value, this.total);
+        const fraction = clamped / this.total;
+        const filled = Math.round(this.width * fraction);
+        const filledChar = this.unicode ? '█' : '#';
+        const emptyChar = this.unicode ? '░' : '-';
+        const bar = this.style ? this.style(filledChar.repeat(filled)) + emptyChar.repeat(this.width - filled) : `${filledChar.repeat(filled)}${emptyChar.repeat(this.width - filled)}`;
+        const parts = [`[${bar}]`, `${Math.round(fraction * 100)}%`, `${clamped}/${this.total}`];
+        if (this.label)
+            parts.push(this.label);
+        if (this.showEta) {
+            const etaText = this.etaText();
+            if (etaText)
+                parts.push(etaText);
+        }
+        return parts.join(' ');
+    }
+    /** Advance to an absolute value and repaint. */
+    set(value) {
+        this.value = Math.max(0, Math.min(value, this.total));
+        this.paint();
+    }
+    /** Advance by a delta and repaint. */
+    inc(by = 1) {
+        this.set(this.value + by);
+    }
+    /** Finish: paint 100% and move to a new line. */
+    complete() {
+        this.set(this.total);
+        if (this.enabled && this.stream) {
+            this.stream.write('\n');
+        }
+    }
+    paint() {
+        if (this.enabled && this.stream) {
+            this.stream.write('\r\x1b[2K');
+            this.stream.write(this.render());
+        }
+    }
+    etaText() {
+        if (this.value <= 0)
+            return '';
+        const elapsed = performance.now() - this.eta.startedAt;
+        if (elapsed < 250)
+            return '';
+        const perItem = elapsed / this.value;
+        const remaining = (this.total - this.value) * perItem;
+        if (remaining < 1000)
+            return `eta <1s`;
+        return `eta ${Math.ceil(remaining / 1000)}s`;
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

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

package/dist/spinner.d.ts

@@ -0,0 +1,45 @@
+export interface SpinnerOptions {
+    /** Where output goes. Defaults to `process.stderr`. */
+    stream?: {
+        write(data: string): unknown;
+    };
+    /** Optional styling applied to the frame glyph (e.g. theme accent color). */
+    style?: (text: string) => string;
+    /** Frame name from `spinnerStyles`, or explicit frames. */
+    styleName?: string;
+    frames?: readonly string[];
+    /** Milliseconds per frame (overrides the named style's interval). */
+    interval?: number;
+    /** Render a static glyph instead of animating. */
+    reducedMotion?: boolean;
+    /** Master switch — pass false to disable all output. */
+    enabled?: boolean;
+}
+/**
+ * An animated spinner bound to a stream.
+ *
+ * - TTY + motion: animated frames, redrawn with `\r` + line clear.
+ * - Reduced motion or non-TTY: a single static line, no animation.
+ * - `with()` wraps async work: start → run → stop, error-safe.
+ */
+export declare class Spinner {
+    private readonly stream;
+    private readonly style?;
+    private readonly frames;
+    private readonly interval;
+    private readonly reducedMotion;
+    private readonly enabled;
+    private label;
+    private frame;
+    private timer;
+    private staticWritten;
+    constructor(options?: SpinnerOptions);
+    start(label: string): void;
+    /** Update the label while running (re-renders immediately). */
+    setLabel(label: string): void;
+    stop(finalLabel?: string): void;
+    /** Run `fn` under a spinner; always stops, even on error. */
+    with<T>(label: string, fn: () => Promise<T> | T): Promise<T>;
+    private renderFrame;
+    private writeLine;
+}

package/dist/spinner.js

@@ -0,0 +1,90 @@
+import { defaultSpinner, spinnerStyles } from './frames.js';
+/**
+ * An animated spinner bound to a stream.
+ *
+ * - TTY + motion: animated frames, redrawn with `\r` + line clear.
+ * - Reduced motion or non-TTY: a single static line, no animation.
+ * - `with()` wraps async work: start → run → stop, error-safe.
+ */
+export class Spinner {
+    stream;
+    style;
+    frames;
+    interval;
+    reducedMotion;
+    enabled;
+    label = '';
+    frame = 0;
+    timer = null;
+    staticWritten = false;
+    constructor(options = {}) {
+        const named = options.styleName ? spinnerStyles[options.styleName] : undefined;
+        this.stream = options.stream ?? process.stderr;
+        this.style = options.style;
+        this.frames = options.frames ?? named?.frames ?? defaultSpinner.frames;
+        this.interval = options.interval ?? named?.interval ?? defaultSpinner.interval;
+        this.reducedMotion = options.reducedMotion ?? false;
+        this.enabled = options.enabled ?? this.stream.isTTY === true;
+    }
+    start(label) {
+        this.label = label;
+        this.frame = 0;
+        if (!this.enabled)
+            return;
+        if (this.reducedMotion) {
+            this.writeLine(this.renderFrame());
+            this.staticWritten = true;
+            return;
+        }
+        this.writeLine(this.renderFrame());
+        this.timer = setInterval(() => {
+            this.frame = (this.frame + 1) % this.frames.length;
+            this.stream.write('\r\x1b[2K');
+            this.writeLine(this.renderFrame());
+        }, this.interval);
+    }
+    /** Update the label while running (re-renders immediately). */
+    setLabel(label) {
+        this.label = label;
+        if (this.timer) {
+            this.stream.write('\r\x1b[2K');
+            this.writeLine(this.renderFrame());
+        }
+        else if (this.enabled && this.staticWritten) {
+            this.stream.write('\r\x1b[2K');
+            this.writeLine(this.renderFrame());
+        }
+    }
+    stop(finalLabel) {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (!this.enabled)
+            return;
+        this.stream.write('\r\x1b[2K');
+        if (finalLabel) {
+            this.stream.write(finalLabel + '\n');
+        }
+        this.staticWritten = false;
+    }
+    /** Run `fn` under a spinner; always stops, even on error. */
+    async with(label, fn) {
+        this.start(label);
+        try {
+            return await fn();
+        }
+        finally {
+            this.stop();
+        }
+    }
+    renderFrame() {
+        const glyph = this.reducedMotion ? '·' : this.frames[this.frame % this.frames.length] ?? '·';
+        const frame = this.style ? this.style(glyph) : glyph;
+        return `${frame} ${this.label}`;
+    }
+    writeLine(line) {
+        this.stream.write(line);
+    }
+}
+//# sourceMappingURL=spinner.js.map

package/dist/spinner.js.map

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

package/dist/tasks.d.ts

@@ -0,0 +1,41 @@
+export interface TaskSpec {
+    label: string;
+    fn: () => Promise<void> | void;
+}
+export interface TaskRunnerOptions {
+    stream?: {
+        write(data: string): unknown;
+        isTTY?: boolean;
+    };
+    unicode?: boolean;
+    reducedMotion?: boolean;
+    /** Cap on concurrent tasks. Default: run them all. */
+    concurrency?: number;
+    style?: (text: string) => string;
+}
+/**
+ * Runs independent tasks concurrently with a live status line per task:
+ *
+ * ```
+ *   • Building frontend
+ *   ✓ Building backend      312ms
+ *   ✗ Deploying staging     (ECONNREFUSED)
+ * ```
+ *
+ * Mirrors the cargo/just-style parallel output. Non-TTY output degrades to
+ * one line per completed task.
+ */
+export declare class TaskRunner {
+    private readonly stream;
+    private readonly unicode;
+    private readonly style?;
+    private readonly live;
+    private readonly concurrency;
+    private lines;
+    private renderedCount;
+    constructor(options?: TaskRunnerOptions);
+    /** Run all tasks (optionally capped), updating status lines live. Returns the failure count. */
+    run(tasks: TaskSpec[]): Promise<number>;
+    private repaint;
+    private renderLine;
+}

package/dist/tasks.js

@@ -0,0 +1,89 @@
+/**
+ * Runs independent tasks concurrently with a live status line per task:
+ *
+ * ```
+ *   • Building frontend
+ *   ✓ Building backend      312ms
+ *   ✗ Deploying staging     (ECONNREFUSED)
+ * ```
+ *
+ * Mirrors the cargo/just-style parallel output. Non-TTY output degrades to
+ * one line per completed task.
+ */
+export class TaskRunner {
+    stream;
+    unicode;
+    style;
+    live;
+    concurrency;
+    lines = [];
+    renderedCount = 0;
+    constructor(options = {}) {
+        this.stream = options.stream ?? process.stderr;
+        this.unicode = options.unicode ?? true;
+        this.style = options.style;
+        this.live = this.stream.isTTY === true && (options.reducedMotion ?? false) === false;
+        this.concurrency = options.concurrency ?? Number.POSITIVE_INFINITY;
+    }
+    /** Run all tasks (optionally capped), updating status lines live. Returns the failure count. */
+    async run(tasks) {
+        const limit = Math.min(this.concurrency, tasks.length);
+        let failures = 0;
+        let index = 0;
+        const launch = async () => {
+            while (index < tasks.length) {
+                const current = index++;
+                const spec = tasks[current];
+                const lineIndex = this.lines.length;
+                this.lines.push({ label: spec.label, state: 'running' });
+                this.repaint();
+                const taskIndex = lineIndex;
+                const startedAt = performance.now();
+                try {
+                    await spec.fn();
+                    this.lines[taskIndex].state = 'ok';
+                    this.lines[taskIndex].ms = Math.max(1, Math.round(performance.now() - startedAt));
+                }
+                catch (error) {
+                    this.lines[taskIndex].state = 'failed';
+                    this.lines[taskIndex].ms = Math.max(1, Math.round(performance.now() - startedAt));
+                    this.lines[taskIndex].error = error instanceof Error ? error.message : String(error);
+                    failures++;
+                }
+                this.repaint();
+            }
+        };
+        await Promise.all(Array.from({ length: Math.max(1, limit) }, () => launch()));
+        return failures;
+    }
+    repaint() {
+        if (!this.live) {
+            // Non-tty: emit each line as it completes (order may be out of sequence).
+            for (const line of this.lines) {
+                if (!line.emitted && line.state !== 'running') {
+                    line.emitted = true;
+                    this.stream.write(this.renderLine(line) + '\n');
+                }
+            }
+            return;
+        }
+        if (this.renderedCount > 0) {
+            this.stream.write(`\x1b[${this.renderedCount}A\x1b[J`);
+        }
+        for (const line of this.lines) {
+            this.stream.write(this.renderLine(line) + '\n');
+        }
+        this.renderedCount = this.lines.length;
+    }
+    renderLine(line) {
+        const mark = line.state === 'running' ? (this.unicode ? '•' : '*') : line.state === 'ok' ? (this.unicode ? '✓' : 'v') : this.unicode ? '✗' : 'x';
+        const glyph = this.style ? this.style(mark) : mark;
+        const parts = [`  ${glyph} ${line.label}`];
+        if (line.state !== 'running' && line.ms !== undefined)
+            parts.push(`${line.ms}ms`);
+        if (line.state === 'failed' && line.error)
+            parts.push(`(${line.error})`);
+        return parts.join('  ');
+    }
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tasks.js.map

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

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@mudah-cli/animation",
+  "version": "0.1.0",
+  "description": "60fps terminal animation engine: ticker, spinners, progress bars, task trees, and transitions.",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=26"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@mudah-cli/terminal": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}