@heinrichb/console-toolkit 1.0.5 → 1.0.6

package/dist/progress.js

@@ -1,43 +0,0 @@
-/**
- * Creates a StyledLine representing a progress bar.
- */
-export function createProgressBar(options) {
-    const { progress, width = 20, style, bracketStyle, startStyle, endStyle, barStyle, fillStyle, emptyStyle, percentageStyle, startChar = "[", endChar = "]", fillChar = "█", emptyChar = "░", showPercentage = true, formatPercentage } = options;
-    // Clamp progress
-    const p = Math.max(0, Math.min(1, progress));
-    // Calculate filled width
-    const filledWidth = Math.round(p * width);
-    const emptyWidth = width - filledWidth;
-    // Resolve styles
-    const baseStyle = style ?? [];
-    const resolvedBracketStyle = bracketStyle ?? baseStyle;
-    const resolvedStartStyle = startStyle ?? resolvedBracketStyle;
-    const resolvedEndStyle = endStyle ?? resolvedBracketStyle;
-    const resolvedBarStyle = barStyle ?? baseStyle;
-    const resolvedFillStyle = fillStyle ?? resolvedBarStyle;
-    const resolvedEmptyStyle = emptyStyle ?? resolvedBarStyle;
-    const resolvedPercentageStyle = percentageStyle ?? baseStyle;
-    const segments = [];
-    // Start Bracket
-    if (startChar) {
-        segments.push({ text: startChar, style: resolvedStartStyle });
-    }
-    // Filled Part
-    if (filledWidth > 0) {
-        segments.push({ text: fillChar.repeat(filledWidth), style: resolvedFillStyle });
-    }
-    // Empty Part
-    if (emptyWidth > 0) {
-        segments.push({ text: emptyChar.repeat(emptyWidth), style: resolvedEmptyStyle });
-    }
-    // End Bracket
-    if (endChar) {
-        segments.push({ text: endChar, style: resolvedEndStyle });
-    }
-    // Percentage
-    if (showPercentage) {
-        const percentageText = formatPercentage ? formatPercentage(p) : ` ${Math.round(p * 100)}%`;
-        segments.push({ text: percentageText, style: resolvedPercentageStyle });
-    }
-    return { segments };
-}

package/dist/progress.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/progress.test.js

@@ -1,101 +0,0 @@
-import { expect, test, describe } from "bun:test";
-import { createProgressBar } from "./progress";
-function getText(line) {
-    return line.segments.map((s) => s.text).join("");
-}
-describe("createProgressBar", () => {
-    test("generates a default progress bar at 0%", () => {
-        const line = createProgressBar({ progress: 0 });
-        const text = getText(line);
-        expect(text).toContain("[");
-        expect(text).toContain("]");
-        expect(text).toContain("0%");
-        expect(text).toContain("░");
-    });
-    test("generates a default progress bar at 50%", () => {
-        const line = createProgressBar({ progress: 0.5 });
-        const text = getText(line);
-        expect(text).toContain("50%");
-        expect(text).toContain("█");
-        expect(text).toContain("░");
-    });
-    test("generates a default progress bar at 100%", () => {
-        const line = createProgressBar({ progress: 1.0 });
-        const text = getText(line);
-        expect(text).toContain("100%");
-        expect(text).not.toContain("░");
-    });
-    test("allows custom width", () => {
-        const width = 10;
-        const line = createProgressBar({ progress: 0.5, width });
-        const segments = line.segments;
-        const filled = segments.find((s) => s.text.includes("█"));
-        const empty = segments.find((s) => s.text.includes("░"));
-        expect(filled?.text.length).toBe(5);
-        expect(empty?.text.length).toBe(5);
-    });
-    test("applies styles correctly", () => {
-        const line = createProgressBar({
-            progress: 0.5,
-            style: "blue",
-            bracketStyle: "red",
-            barStyle: "green",
-            percentageStyle: "yellow"
-        });
-        const start = line.segments.find((s) => s.text === "[");
-        const filled = line.segments.find((s) => s.text.includes("█"));
-        const end = line.segments.find((s) => s.text === "]");
-        const percentage = line.segments.find((s) => s.text.includes("%"));
-        expect(start?.style).toBe("red");
-        expect(filled?.style).toBe("green");
-        expect(end?.style).toBe("red");
-        expect(percentage?.style).toBe("yellow");
-    });
-    test("cascades styles (general style -> specific)", () => {
-        const line = createProgressBar({
-            progress: 0.5,
-            style: "blue"
-        });
-        line.segments.forEach((s) => {
-            if (s.text.trim().length > 0) {
-                expect(s.style).toBe("blue");
-            }
-        });
-    });
-    test("allows custom characters", () => {
-        const line = createProgressBar({
-            progress: 0.5,
-            startChar: "<",
-            endChar: ">",
-            fillChar: "=",
-            emptyChar: "-"
-        });
-        const text = getText(line);
-        expect(text).toContain("<");
-        expect(text).toContain(">");
-        expect(text).toContain("=");
-        expect(text).toContain("-");
-    });
-    test("hides percentage", () => {
-        const line = createProgressBar({
-            progress: 0.5,
-            showPercentage: false
-        });
-        const text = getText(line);
-        expect(text).not.toContain("%");
-    });
-    test("formats percentage custom", () => {
-        const line = createProgressBar({
-            progress: 0.5,
-            formatPercentage: (p) => `${p * 10}/10`
-        });
-        const text = getText(line);
-        expect(text).toContain("5/10");
-    });
-    test("clamping progress", () => {
-        const lineLow = createProgressBar({ progress: -0.1 });
-        expect(getText(lineLow)).toContain("0%");
-        const lineHigh = createProgressBar({ progress: 1.1 });
-        expect(getText(lineHigh)).toContain("100%");
-    });
-});

package/dist/spinner.d.ts

@@ -1,36 +0,0 @@
-export type SpinnerFrames = string[];
-export interface SpinnerOptions {
-    /**
-     * The array of frames to cycle through.
-     */
-    frames: SpinnerFrames;
-    /**
-     * The interval in milliseconds between frames.
-     * Defaults to 80ms.
-     */
-    interval?: number;
-}
-/**
- * Common spinner frame presets.
- */
-export declare const SPINNERS: {
-    dots: string[];
-    lines: string[];
-    arrows: string[];
-    circle: string[];
-    square: string[];
-};
-/**
- * A stateful spinner that calculates the current frame based on elapsed time.
- * Designed to be used within a render loop (e.g. Printer.print loop).
- */
-export declare class Spinner {
-    private frames;
-    private interval;
-    private startTime;
-    constructor(options: SpinnerOptions);
-    /**
-     * Returns the current frame based on the elapsed time.
-     */
-    getFrame(): string;
-}

package/dist/spinner.js

@@ -1,33 +0,0 @@
-/**
- * Common spinner frame presets.
- */
-export const SPINNERS = {
-    dots: ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"],
-    lines: ["-", "\\", "|", "/"],
-    arrows: ["←", "↖", "↑", "↗", "→", "↘", "↓", "↙"],
-    circle: ["◐", "◓", "◑", "◒"],
-    square: ["▖", "▘", "▝", "▗"]
-};
-/**
- * A stateful spinner that calculates the current frame based on elapsed time.
- * Designed to be used within a render loop (e.g. Printer.print loop).
- */
-export class Spinner {
-    frames;
-    interval;
-    startTime;
-    constructor(options) {
-        this.frames = options.frames;
-        this.interval = options.interval ?? 80;
-        this.startTime = Date.now();
-    }
-    /**
-     * Returns the current frame based on the elapsed time.
-     */
-    getFrame() {
-        const now = Date.now();
-        const elapsed = now - this.startTime;
-        const index = Math.floor(elapsed / this.interval) % this.frames.length;
-        return this.frames[index];
-    }
-}

package/dist/spinner.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/spinner.test.js

@@ -1,53 +0,0 @@
-import { expect, test, describe, spyOn, afterEach, beforeEach } from "bun:test";
-import { Spinner, SPINNERS } from "./spinner";
-describe("Spinner Class", () => {
-    let now = 1000;
-    // Mock Date.now() to control time
-    const dateSpy = spyOn(Date, "now").mockImplementation(() => now);
-    beforeEach(() => {
-        now = 1000;
-        dateSpy.mockClear();
-        dateSpy.mockImplementation(() => now);
-    });
-    afterEach(() => {
-        dateSpy.mockClear();
-    });
-    test("initializes with correct defaults", () => {
-        const spinner = new Spinner({ frames: ["a", "b"] });
-        expect(spinner.getFrame()).toBe("a");
-    });
-    test("advances frames over time", () => {
-        const spinner = new Spinner({ frames: ["a", "b", "c"], interval: 100 });
-        // t=0 (1000)
-        expect(spinner.getFrame()).toBe("a");
-        // t=50 (1050) -> still frame 0
-        now = 1050;
-        expect(spinner.getFrame()).toBe("a");
-        // t=100 (1100) -> frame 1
-        now = 1100;
-        expect(spinner.getFrame()).toBe("b");
-        // t=200 (1200) -> frame 2
-        now = 1200;
-        expect(spinner.getFrame()).toBe("c");
-        // t=300 (1300) -> frame 0 (loop)
-        now = 1300;
-        expect(spinner.getFrame()).toBe("a");
-    });
-    test("uses custom interval", () => {
-        const spinner = new Spinner({ frames: ["a", "b"], interval: 50 });
-        // t=0
-        expect(spinner.getFrame()).toBe("a");
-        // t=50 -> frame 1
-        now = 1050;
-        expect(spinner.getFrame()).toBe("b");
-    });
-});
-describe("Spinner Presets", () => {
-    test("dots preset exists and has frames", () => {
-        expect(SPINNERS.dots).toBeDefined();
-        expect(SPINNERS.dots.length).toBeGreaterThan(0);
-    });
-    test("lines preset exists", () => {
-        expect(SPINNERS.lines).toBeDefined();
-    });
-});