@flyingrobots/bijou 7.2.0 → 8.0.0-rc.1

package/dist/core/components/progress.js

@@ -1,206 +1,4 @@
-import { lerp3 } from '../theme/gradient.js';
-import { mix } from '../theme/color.js';
-import { resolveClock } from '../clock.js';
-import { sanitizeNonNegativeInt, sanitizePositiveInt } from '../numeric.js';
-import { resolveCtx } from '../resolve-ctx.js';
-import { renderByMode } from '../mode-render.js';
-import { cursorGuard } from './cursor-guard.js';
-import { CLEAR_LINE_RETURN } from '../ansi.js';
-/**
- * Render a progress bar string for the given percentage.
- *
- * Output adapts to the current output mode:
- * - `interactive` / `static` — visual bar using filled and empty characters,
- *   optionally colored with a gradient.
- * - `pipe` — plain text like `Progress: 42%`.
- * - `accessible` — screen-reader-friendly phrase like `42 percent complete.`.
- *
- * The percentage is clamped to the 0–100 range.
- *
- * @param percent - Completion percentage (0–100).
- * @param options - Progress bar configuration.
- * @returns The rendered progress bar string.
- */
-export function progressBar(percent, options = {}) {
-    const ctx = resolveCtx(options.ctx);
-    const pct = Math.max(0, Math.min(100, percent));
-    const percentLabel = String(Math.round(pct));
-    return renderByMode(ctx.mode, {
-        pipe: () => `Progress: ${percentLabel}%`,
-        accessible: () => `${percentLabel} percent complete.`,
-        interactive: () => {
-            const width = sanitizeNonNegativeInt(options.width, 20);
-            const filledChar = options.filled ?? '\u2588';
-            const emptyChar = options.empty ?? '\u2810';
-            const showPercent = options.showPercent ?? true;
-            const filledCount = Math.min(width, Math.max(0, Math.round((pct / 100) * width)));
-            const noColor = ctx.theme.noColor;
-            const stops = options.gradient;
-            const filledToken = options.filledToken ?? ctx.semantic('info');
-            const filledEndToken = options.filledEndToken ?? ctx.semantic('accent');
-            const emptyToken = options.emptyToken ?? ctx.ui('trackEmpty');
-            const labelToken = options.labelToken ?? ctx.semantic('primary');
-            let bar = '';
-            if (noColor) {
-                bar = filledChar.repeat(filledCount) + emptyChar.repeat(width - filledCount);
-            }
-            else if (stops != null && stops.length > 0) {
-                for (let i = 0; i < filledCount; i++) {
-                    const t_val = filledCount <= 1 ? 0 : i / (filledCount - 1);
-                    const [r, g, b] = lerp3(stops, t_val * (pct / 100));
-                    bar += ctx.style.rgb(r, g, b, filledChar);
-                }
-                bar += ctx.style.styled(emptyToken, emptyChar.repeat(width - filledCount));
-            }
-            else {
-                for (let i = 0; i < filledCount; i++) {
-                    const t_val = filledCount <= 1 ? 0 : i / (filledCount - 1);
-                    const token = mix(filledToken, filledEndToken, t_val);
-                    bar += ctx.style.styled(token, filledChar);
-                }
-                bar += ctx.style.styled(emptyToken, emptyChar.repeat(width - filledCount));
-            }
-            const label = showPercent ? `${percentLabel}%` : '';
-            return label
-                ? `${noColor ? label.padStart(4) : ctx.style.styled(labelToken, label.padStart(4))} ${bar}`
-                : bar;
-        },
-    }, options);
-}
-/**
- * Create a live progress bar that the caller updates by pushing new values.
- *
- * In interactive mode, each call to {@link ProgressBarController.update}
- * overwrites the current line. Non-interactive modes emit a new line per update.
- *
- * @param options - Progress bar configuration.
- * @returns A {@link ProgressBarController} for starting, updating, and stopping the bar.
- */
-export function createProgressBar(options = {}) {
-    const ctx = resolveCtx(options.ctx);
-    const mode = ctx.mode;
-    let cursorHandle = null;
-    return {
-        start() {
-            if (mode !== 'interactive') {
-                ctx.io.write(progressBar(0, { ...options, ctx }) + '\n');
-                return;
-            }
-            cursorHandle?.dispose();
-            cursorHandle = cursorGuard(ctx.io).hide();
-            ctx.io.write(progressBar(0, { ...options, ctx }));
-        },
-        update(pct) {
-            if (mode !== 'interactive') {
-                ctx.io.write(progressBar(pct, { ...options, ctx }) + '\n');
-                return;
-            }
-            ctx.io.write(`${CLEAR_LINE_RETURN}${progressBar(pct, { ...options, ctx })}`);
-        },
-        stop(finalMessage) {
-            if (mode !== 'interactive') {
-                if (finalMessage !== undefined) {
-                    ctx.io.write(finalMessage + '\n');
-                }
-                return;
-            }
-            ctx.io.write(CLEAR_LINE_RETURN);
-            if (cursorHandle !== null) {
-                cursorHandle.dispose();
-                cursorHandle = null;
-            }
-            if (finalMessage !== undefined) {
-                ctx.io.write(finalMessage + '\n');
-            }
-        },
-    };
-}
-/**
- * Create an animated progress bar that smoothly interpolates between values.
- *
- * When {@link ProgressBarController.update} is called, the bar animates from
- * its current percentage to the target over the configured duration using a
- * fixed-step timer. Non-interactive modes skip animation entirely.
- *
- * @param options - Animated progress bar configuration.
- * @returns A {@link ProgressBarController} for starting, updating, and stopping the bar.
- */
-export function createAnimatedProgressBar(options = {}) {
-    const ctx = resolveCtx(options.ctx);
-    const clock = resolveClock(ctx);
-    const mode = ctx.mode;
-    const fps = sanitizePositiveInt(options.fps, 30);
-    const duration = sanitizePositiveInt(options.duration, 300);
-    let currentPct = 0;
-    let targetPct = 0;
-    let timer = null;
-    let cursorHandle = null;
-    const frameMs = Math.round(1000 / fps);
-    const stepPerFrame = 100 / (duration / frameMs); // max pct change per frame
-    /** Write the current percentage bar to the terminal, overwriting the current line. */
-    function render() {
-        ctx.io.write(`${CLEAR_LINE_RETURN}${progressBar(currentPct, { ...options, ctx })}`);
-    }
-    /** Start the interpolation timer if it is not already running. */
-    function startAnimation() {
-        if (timer !== null)
-            return;
-        timer = clock.setInterval(() => {
-            if (Math.abs(targetPct - currentPct) < 0.1) {
-                currentPct = targetPct;
-                render();
-                if (timer !== null) {
-                    timer.dispose();
-                    timer = null;
-                }
-                return;
-            }
-            const direction = targetPct > currentPct ? 1 : -1;
-            currentPct += direction * Math.min(stepPerFrame, Math.abs(targetPct - currentPct));
-            render();
-        }, frameMs);
-    }
-    return {
-        start() {
-            if (mode !== 'interactive') {
-                ctx.io.write(progressBar(0, { ...options, ctx }) + '\n');
-                return;
-            }
-            cursorHandle?.dispose();
-            cursorHandle = cursorGuard(ctx.io).hide();
-            render();
-        },
-        update(pct) {
-            targetPct = Math.max(0, Math.min(100, pct));
-            if (mode !== 'interactive') {
-                currentPct = targetPct;
-                ctx.io.write(progressBar(currentPct, { ...options, ctx }) + '\n');
-                return;
-            }
-            startAnimation();
-        },
-        stop(finalMessage) {
-            if (timer !== null) {
-                timer.dispose();
-                timer = null;
-            }
-            currentPct = targetPct;
-            if (mode !== 'interactive') {
-                if (finalMessage !== undefined) {
-                    ctx.io.write(finalMessage + '\n');
-                }
-                return;
-            }
-            render();
-            ctx.io.write(CLEAR_LINE_RETURN);
-            if (cursorHandle !== null) {
-                cursorHandle.dispose();
-                cursorHandle = null;
-            }
-            if (finalMessage !== undefined) {
-                ctx.io.write(finalMessage + '\n');
-            }
-        },
-    };
-}
+export { progressBar } from './progress.part01.js';
+export { createProgressBar } from './progress.part02.js';
+export { createAnimatedProgressBar } from './progress.part03.js';
 //# sourceMappingURL=progress.js.map

package/dist/core/components/progress.js.map

@@ -1 +1 @@
-{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../src/core/components/progress.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../src/core/components/progress.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAKnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/core/components/progress.part01.d.ts

@@ -0,0 +1,57 @@
+import type { BijouContext } from '../../ports/context.js';
+import type { GradientStop, TokenValue } from '../theme/tokens.js';
+/** Configuration for rendering a progress bar. */
+export interface ProgressBarOptions {
+    /** Character-width of the bar (defaults to 20). */
+    width?: number;
+    /** Character used for filled segments (defaults to `\u2588` full block). */
+    filled?: string;
+    /** Character used for empty segments (defaults to `\u2810` braille dot). */
+    empty?: string;
+    /** Gradient color stops applied across filled segments. */
+    gradient?: GradientStop[];
+    /** Theme token for the leading edge of the filled range. Defaults to `semantic.info`. */
+    filledToken?: TokenValue;
+    /** Theme token for the trailing edge of the filled range. Defaults to `semantic.accent`. */
+    filledEndToken?: TokenValue;
+    /** Theme token applied to the empty range. Defaults to `ui.trackEmpty`. */
+    emptyToken?: TokenValue;
+    /** Theme token applied to the percentage label. Defaults to `semantic.primary`. */
+    labelToken?: TokenValue;
+    /** Whether to prepend a percentage label (defaults to `true`). */
+    showPercent?: boolean;
+    /** Bijou context for I/O, styling, and mode detection. */
+    ctx?: BijouContext;
+}
+/**
+ * Render a progress bar string for the given percentage.
+ *
+ * Output adapts to the current output mode:
+ * - `interactive` / `static` — visual bar using filled and empty characters,
+ *   optionally colored with a gradient.
+ * - `pipe` — plain text like `Progress: 42%`.
+ * - `accessible` — screen-reader-friendly phrase like `42 percent complete.`.
+ *
+ * The percentage is clamped to the 0–100 range.
+ *
+ * @param percent - Completion percentage (0–100).
+ * @param options - Progress bar configuration.
+ * @returns The rendered progress bar string.
+ */
+export declare function progressBar(percent: number, options?: ProgressBarOptions): string;
+/** Controller for managing a live or animated progress bar. */
+export interface ProgressBarController {
+    /** Begin rendering the progress bar (hides cursor in interactive mode). */
+    start(): void;
+    /**
+     * Set the progress bar to a new percentage.
+     * @param pct - New completion percentage (0–100).
+     */
+    update(pct: number): void;
+    /**
+     * Stop the progress bar, restore the cursor, and optionally print a final message.
+     * @param finalMessage - Text written after stopping (followed by a newline).
+     */
+    stop(finalMessage?: string): void;
+}
+//# sourceMappingURL=progress.part01.d.ts.map

package/dist/core/components/progress.part01.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.part01.d.ts","sourceRoot":"","sources":["../../../src/core/components/progress.part01.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOnE,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,yFAAyF;IACzF,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,4FAA4F;IAC5F,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,mFAAmF;IACnF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,YAAY,CAAC;CACpB;AACD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CA8DR;AAKD,+DAA+D;AAC/D,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC"}

package/dist/core/components/progress.part01.js

@@ -0,0 +1,69 @@
+import { lerp3 } from '../theme/gradient.js';
+import { mix } from '../theme/color.js';
+import { sanitizeNonNegativeInt } from '../numeric.js';
+import { resolveCtx } from '../resolve-ctx.js';
+import { renderByMode } from '../mode-render.js';
+/**
+ * Render a progress bar string for the given percentage.
+ *
+ * Output adapts to the current output mode:
+ * - `interactive` / `static` — visual bar using filled and empty characters,
+ *   optionally colored with a gradient.
+ * - `pipe` — plain text like `Progress: 42%`.
+ * - `accessible` — screen-reader-friendly phrase like `42 percent complete.`.
+ *
+ * The percentage is clamped to the 0–100 range.
+ *
+ * @param percent - Completion percentage (0–100).
+ * @param options - Progress bar configuration.
+ * @returns The rendered progress bar string.
+ */
+export function progressBar(percent, options = {}) {
+    const ctx = resolveCtx(options.ctx);
+    const pct = Math.max(0, Math.min(100, percent));
+    const percentLabel = String(Math.round(pct));
+    return renderByMode(ctx.mode, {
+        pipe: () => `Progress: ${percentLabel}%`,
+        accessible: () => `${percentLabel} percent complete.`,
+        interactive: () => {
+            const width = sanitizeNonNegativeInt(options.width, 20);
+            const filledChar = options.filled ?? '\u2588';
+            const emptyChar = options.empty ?? '\u2810';
+            const showPercent = options.showPercent ?? true;
+            const filledCount = Math.min(width, Math.max(0, Math.round((pct / 100) * width)));
+            const noColor = ctx.theme.noColor;
+            const stops = options.gradient;
+            const filledToken = options.filledToken ?? ctx.semantic('info');
+            const filledEndToken = options.filledEndToken ?? ctx.semantic('accent');
+            const emptyToken = options.emptyToken ?? ctx.ui('trackEmpty');
+            const labelToken = options.labelToken ?? ctx.semantic('primary');
+            let bar = '';
+            if (noColor) {
+                bar =
+                    filledChar.repeat(filledCount) +
+                        emptyChar.repeat(width - filledCount);
+            }
+            else if (stops != null && stops.length > 0) {
+                for (let i = 0; i < filledCount; i++) {
+                    const t_val = filledCount <= 1 ? 0 : i / (filledCount - 1);
+                    const [r, g, b] = lerp3(stops, t_val * (pct / 100));
+                    bar += ctx.style.rgb(r, g, b, filledChar);
+                }
+                bar += ctx.style.styled(emptyToken, emptyChar.repeat(width - filledCount));
+            }
+            else {
+                for (let i = 0; i < filledCount; i++) {
+                    const t_val = filledCount <= 1 ? 0 : i / (filledCount - 1);
+                    const token = mix(filledToken, filledEndToken, t_val);
+                    bar += ctx.style.styled(token, filledChar);
+                }
+                bar += ctx.style.styled(emptyToken, emptyChar.repeat(width - filledCount));
+            }
+            const label = showPercent ? `${percentLabel}%` : '';
+            return label
+                ? `${noColor ? label.padStart(4) : ctx.style.styled(labelToken, label.padStart(4))} ${bar}`
+                : bar;
+        },
+    }, options);
+}
+//# sourceMappingURL=progress.part01.js.map

package/dist/core/components/progress.part01.js.map

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

package/dist/core/components/progress.part02.d.ts

@@ -0,0 +1,21 @@
+import { type ProgressBarController, type ProgressBarOptions } from './progress.part01.js';
+/** Options for {@link createProgressBar}. Currently identical to {@link ProgressBarOptions}. */
+export type LiveProgressBarOptions = ProgressBarOptions;
+/**
+ * Create a live progress bar that the caller updates by pushing new values.
+ *
+ * In interactive mode, each call to {@link ProgressBarController.update}
+ * overwrites the current line. Non-interactive modes emit a new line per update.
+ *
+ * @param options - Progress bar configuration.
+ * @returns A {@link ProgressBarController} for starting, updating, and stopping the bar.
+ */
+export declare function createProgressBar(options?: LiveProgressBarOptions): ProgressBarController;
+/** Options for {@link createAnimatedProgressBar}. */
+export interface AnimatedProgressBarOptions extends ProgressBarOptions {
+    /** Target frames per second for the interpolation animation (defaults to 30). */
+    fps?: number;
+    /** Duration in milliseconds to interpolate from current to target value (defaults to 300). */
+    duration?: number;
+}
+//# sourceMappingURL=progress.part02.d.ts.map

package/dist/core/components/progress.part02.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.part02.d.ts","sourceRoot":"","sources":["../../../src/core/components/progress.part02.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EAExB,MAAM,sBAAsB,CAAC;AAE9B,gGAAgG;AAChG,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AACxD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CA2CvB;AAKD,qDAAqD;AACrD,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/core/components/progress.part02.js

@@ -0,0 +1,53 @@
+import { resolveCtx } from '../resolve-ctx.js';
+import { cursorGuard } from './cursor-guard.js';
+import { CLEAR_LINE_RETURN } from '../ansi.js';
+import { progressBar, } from './progress.part01.js';
+/**
+ * Create a live progress bar that the caller updates by pushing new values.
+ *
+ * In interactive mode, each call to {@link ProgressBarController.update}
+ * overwrites the current line. Non-interactive modes emit a new line per update.
+ *
+ * @param options - Progress bar configuration.
+ * @returns A {@link ProgressBarController} for starting, updating, and stopping the bar.
+ */
+export function createProgressBar(options = {}) {
+    const ctx = resolveCtx(options.ctx);
+    const mode = ctx.mode;
+    let cursorHandle = null;
+    return {
+        start() {
+            if (mode !== 'interactive') {
+                ctx.io.write(progressBar(0, { ...options, ctx }) + '\n');
+                return;
+            }
+            cursorHandle?.dispose();
+            cursorHandle = cursorGuard(ctx.io).hide();
+            ctx.io.write(progressBar(0, { ...options, ctx }));
+        },
+        update(pct) {
+            if (mode !== 'interactive') {
+                ctx.io.write(progressBar(pct, { ...options, ctx }) + '\n');
+                return;
+            }
+            ctx.io.write(`${CLEAR_LINE_RETURN}${progressBar(pct, { ...options, ctx })}`);
+        },
+        stop(finalMessage) {
+            if (mode !== 'interactive') {
+                if (finalMessage !== undefined) {
+                    ctx.io.write(finalMessage + '\n');
+                }
+                return;
+            }
+            ctx.io.write(CLEAR_LINE_RETURN);
+            if (cursorHandle !== null) {
+                cursorHandle.dispose();
+                cursorHandle = null;
+            }
+            if (finalMessage !== undefined) {
+                ctx.io.write(finalMessage + '\n');
+            }
+        },
+    };
+}
+//# sourceMappingURL=progress.part02.js.map

package/dist/core/components/progress.part02.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.part02.js","sourceRoot":"","sources":["../../../src/core/components/progress.part02.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAyB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAGL,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAI9B;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkC,EAAE;IAEpC,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,IAAI,YAAY,GAA4B,IAAI,CAAC;IAEjD,OAAO;QACL,KAAK;YACH,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC3B,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;gBACzD,OAAO;YACT,CAAC;YACD,YAAY,EAAE,OAAO,EAAE,CAAC;YACxB,YAAY,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1C,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,CAAC,GAAW;YAChB,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC3B,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC3D,OAAO;YACT,CAAC;YACD,GAAG,CAAC,EAAE,CAAC,KAAK,CACV,GAAG,iBAAiB,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAC/D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,YAAqB;YACxB,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC3B,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;oBAC/B,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;gBACpC,CAAC;gBACD,OAAO;YACT,CAAC;YACD,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAChC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC1B,YAAY,CAAC,OAAO,EAAE,CAAC;gBACvB,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC;YACD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gBAC/B,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/components/progress.part03.d.ts

@@ -0,0 +1,14 @@
+import { type ProgressBarController } from './progress.part01.js';
+import { type AnimatedProgressBarOptions } from './progress.part02.js';
+/**
+ * Create an animated progress bar that smoothly interpolates between values.
+ *
+ * When {@link ProgressBarController.update} is called, the bar animates from
+ * its current percentage to the target over the configured duration using a
+ * fixed-step timer. Non-interactive modes skip animation entirely.
+ *
+ * @param options - Animated progress bar configuration.
+ * @returns A {@link ProgressBarController} for starting, updating, and stopping the bar.
+ */
+export declare function createAnimatedProgressBar(options?: AnimatedProgressBarOptions): ProgressBarController;
+//# sourceMappingURL=progress.part03.d.ts.map

package/dist/core/components/progress.part03.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.part03.d.ts","sourceRoot":"","sources":["../../../src/core/components/progress.part03.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,qBAAqB,EAAe,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvE;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,qBAAqB,CAsFvB"}

package/dist/core/components/progress.part03.js

@@ -0,0 +1,96 @@
+import { resolveClock } from '../clock.js';
+import { sanitizePositiveInt } from '../numeric.js';
+import { resolveCtx } from '../resolve-ctx.js';
+import { cursorGuard } from './cursor-guard.js';
+import { CLEAR_LINE_RETURN } from '../ansi.js';
+import { progressBar } from './progress.part01.js';
+/**
+ * Create an animated progress bar that smoothly interpolates between values.
+ *
+ * When {@link ProgressBarController.update} is called, the bar animates from
+ * its current percentage to the target over the configured duration using a
+ * fixed-step timer. Non-interactive modes skip animation entirely.
+ *
+ * @param options - Animated progress bar configuration.
+ * @returns A {@link ProgressBarController} for starting, updating, and stopping the bar.
+ */
+export function createAnimatedProgressBar(options = {}) {
+    const ctx = resolveCtx(options.ctx);
+    const clock = resolveClock(ctx);
+    const mode = ctx.mode;
+    const fps = sanitizePositiveInt(options.fps, 30);
+    const duration = sanitizePositiveInt(options.duration, 300);
+    let currentPct = 0;
+    let targetPct = 0;
+    let timer = null;
+    let cursorHandle = null;
+    const frameMs = Math.round(1000 / fps);
+    const stepPerFrame = 100 / (duration / frameMs); // max pct change per frame
+    /** Write the current percentage bar to the terminal, overwriting the current line. */
+    function render() {
+        ctx.io.write(`${CLEAR_LINE_RETURN}${progressBar(currentPct, { ...options, ctx })}`);
+    }
+    /** Start the interpolation timer if it is not already running. */
+    function startAnimation() {
+        if (timer !== null)
+            return;
+        timer = clock.setInterval(() => {
+            if (Math.abs(targetPct - currentPct) < 0.1) {
+                currentPct = targetPct;
+                render();
+                if (timer !== null) {
+                    timer.dispose();
+                    timer = null;
+                }
+                return;
+            }
+            const direction = targetPct > currentPct ? 1 : -1;
+            currentPct +=
+                direction * Math.min(stepPerFrame, Math.abs(targetPct - currentPct));
+            render();
+        }, frameMs);
+    }
+    return {
+        start() {
+            if (mode !== 'interactive') {
+                ctx.io.write(progressBar(0, { ...options, ctx }) + '\n');
+                return;
+            }
+            cursorHandle?.dispose();
+            cursorHandle = cursorGuard(ctx.io).hide();
+            render();
+        },
+        update(pct) {
+            targetPct = Math.max(0, Math.min(100, pct));
+            if (mode !== 'interactive') {
+                currentPct = targetPct;
+                ctx.io.write(progressBar(currentPct, { ...options, ctx }) + '\n');
+                return;
+            }
+            startAnimation();
+        },
+        stop(finalMessage) {
+            if (timer !== null) {
+                timer.dispose();
+                timer = null;
+            }
+            currentPct = targetPct;
+            if (mode !== 'interactive') {
+                if (finalMessage !== undefined) {
+                    ctx.io.write(finalMessage + '\n');
+                }
+                return;
+            }
+            render();
+            ctx.io.write(CLEAR_LINE_RETURN);
+            if (cursorHandle !== null) {
+                cursorHandle.dispose();
+                cursorHandle = null;
+            }
+            if (finalMessage !== undefined) {
+                ctx.io.write(finalMessage + '\n');
+            }
+        },
+    };
+}
+//# sourceMappingURL=progress.part03.js.map

package/dist/core/components/progress.part03.js.map

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

package/dist/core/components/surface-text-layout.d.ts

@@ -0,0 +1,5 @@
+import { type Surface } from '../../ports/surface.js';
+import type { CellTextStyle } from './surface-text-style.js';
+export declare function padSurface(surface: Surface, width: number, height: number, fill?: CellTextStyle): Surface;
+export declare function wrapSurfaceToWidth(surface: Surface, width: number): Surface;
+//# sourceMappingURL=surface-text-layout.d.ts.map

package/dist/core/components/surface-text-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-text-layout.d.ts","sourceRoot":"","sources":["../../../src/core/components/surface-text-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,wBAAgB,UAAU,CACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAWT;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAkC3E"}

package/dist/core/components/surface-text-layout.js

@@ -0,0 +1,47 @@
+import { createSurface } from '../../ports/surface.js';
+export function padSurface(surface, width, height, fill) {
+    const result = fill == null
+        ? createSurface(width, height)
+        : createSurface(width, height, {
+            char: ' ',
+            ...fill,
+            empty: false,
+        });
+    result.blit(surface, 0, 0);
+    return result;
+}
+export function wrapSurfaceToWidth(surface, width) {
+    if (width <= 0)
+        return createSurface(0, Math.max(1, surface.height));
+    if (surface.width <= width)
+        return surface;
+    const rows = [];
+    for (let y = 0; y < surface.height; y++) {
+        let effectiveWidth = 0;
+        for (let x = surface.width - 1; x >= 0; x--) {
+            if (!surface.get(x, y).empty) {
+                effectiveWidth = x + 1;
+                break;
+            }
+        }
+        if (effectiveWidth === 0) {
+            rows.push([]);
+            continue;
+        }
+        const cells = [];
+        for (let x = 0; x < effectiveWidth; x++) {
+            cells.push({ ...surface.get(x, y) });
+        }
+        for (let offset = 0; offset < cells.length; offset += width) {
+            rows.push(cells.slice(offset, offset + width));
+        }
+    }
+    const result = createSurface(width, Math.max(1, rows.length));
+    rows.forEach((row, y) => {
+        row.forEach((cell, x) => {
+            result.set(x, y, cell);
+        });
+    });
+    return result;
+}
+//# sourceMappingURL=surface-text-layout.js.map

package/dist/core/components/surface-text-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-text-layout.js","sourceRoot":"","sources":["../../../src/core/components/surface-text-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA2B,MAAM,wBAAwB,CAAC;AAGhF,MAAM,UAAU,UAAU,CACxB,OAAgB,EAChB,KAAa,EACb,MAAc,EACd,IAAoB;IAEpB,MAAM,MAAM,GACV,IAAI,IAAI,IAAI;QACV,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;QAC9B,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE;YAC3B,IAAI,EAAE,GAAG;YACT,GAAG,IAAI;YACP,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACT,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,KAAa;IAChE,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,KAAK,IAAI,KAAK;QAAE,OAAO,OAAO,CAAC;IAE3C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;gBAC7B,cAAc,GAAG,CAAC,GAAG,CAAC,CAAC;gBACvB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACd,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAW,EAAE,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC;YAC5D,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACtB,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACtB,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}