@boba-cli/progress 0.1.0-alpha.2

package/README.md

@@ -0,0 +1,59 @@
+# @boba-cli/progress
+
+Animated progress bar for Boba terminal UIs. Port of Charmbracelet Bubbles progress.
+
+<img src="../../examples/progress-demo.gif" width="950" alt="Progress component demo" />
+
+## Install
+
+```bash
+pnpm add @boba-cli/progress
+```
+
+## Quickstart
+
+```ts
+import { ProgressModel, FrameMsg } from '@boba-cli/progress'
+import type { Cmd, Msg } from '@boba-cli/tea'
+
+let progress = ProgressModel.withDefaultGradient({ width: 30 })
+
+function init(): Cmd<Msg> {
+  // Start at 40%
+  const [next, cmd] = progress.setPercent(0.4)
+  progress = next
+  return cmd
+}
+
+function update(msg: Msg): [unknown, Cmd<Msg>] {
+  const [next, cmd] = progress.update(msg)
+  progress = next
+  return [{ progress }, cmd]
+}
+
+function view(): string {
+  return progress.view()
+}
+```
+
+## API
+
+- `ProgressModel.new(options?)` create with defaults
+- `ProgressModel.withDefaultGradient()` convenience gradient
+- `ProgressModel.withGradient(colorA, colorB, scale?)`
+- `ProgressModel.withSolidFill(color)`
+- `setPercent(percent)` set target percent (0-1) and start animation
+- `incrPercent(delta)` adjust target percent
+- `update(msg)` handle `FrameMsg` animation ticks
+- `view()` render bar; `percent()` exposes animated percent
+
+## Scripts
+
+- `pnpm -C packages/progress build`
+- `pnpm -C packages/progress test`
+- `pnpm -C packages/progress lint`
+- `pnpm -C packages/progress generate:api-report`
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,368 @@
+'use strict';
+
+var tea = require('@boba-cli/tea');
+var chapstick = require('@boba-cli/chapstick');
+
+// src/model.ts
+
+// src/messages.ts
+var FrameMsg = class {
+  constructor(id, tag, time) {
+    this.id = id;
+    this.tag = tag;
+    this.time = time;
+  }
+  _tag = "progress:frame";
+};
+
+// src/spring.ts
+var Spring = class _Spring {
+  frequency;
+  damping;
+  #angular;
+  #pos;
+  #vel;
+  constructor(config = {}) {
+    this.frequency = config.frequency ?? 18;
+    this.damping = config.damping ?? 1;
+    this.#angular = this.frequency;
+    this.#pos = config.position ?? 0;
+    this.#vel = config.velocity ?? 0;
+  }
+  /** Current position. */
+  position() {
+    return this.#pos;
+  }
+  /** Current velocity. */
+  velocity() {
+    return this.#vel;
+  }
+  /** Return a copy with new spring options, keeping state. */
+  withOptions(frequency, damping) {
+    return new _Spring({
+      frequency,
+      damping,
+      position: this.#pos,
+      velocity: this.#vel
+    });
+  }
+  /**
+   * Integrate toward target over the provided timestep (ms).
+   * Returns the new position and velocity.
+   */
+  update(target, deltaMs) {
+    const dt = Math.min(0.05, Math.max(0, deltaMs / 1e3));
+    const displacement = this.#pos - target;
+    const springForce = -this.#angular * this.#angular * displacement;
+    const dampingForce = -2 * this.damping * this.#angular * this.#vel;
+    const acceleration = springForce + dampingForce;
+    const velocity = this.#vel + acceleration * dt;
+    const position = this.#pos + velocity * dt;
+    return new _Spring({
+      frequency: this.frequency,
+      damping: this.damping,
+      position,
+      velocity
+    });
+  }
+};
+
+// src/gradient.ts
+function clamp01(value) {
+  return Math.min(1, Math.max(0, value));
+}
+function hexToRgb(hex) {
+  const normalized = hex.startsWith("#") ? hex.slice(1) : hex;
+  if (normalized.length !== 6) return null;
+  const int = Number.parseInt(normalized, 16);
+  if (Number.isNaN(int)) return null;
+  return {
+    r: int >> 16 & 255,
+    g: int >> 8 & 255,
+    b: int & 255
+  };
+}
+function rgbToHex({ r, g, b }) {
+  const toHex = (v) => v.toString(16).padStart(2, "0");
+  return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+function interpolateColor(colorA, colorB, t) {
+  const a = hexToRgb(colorA);
+  const b = hexToRgb(colorB);
+  if (!a || !b) return colorA;
+  const tClamped = clamp01(t);
+  const mix = (start, end) => Math.round(start + (end - start) * tClamped);
+  return rgbToHex({
+    r: mix(a.r, b.r),
+    g: mix(a.g, b.g),
+    b: mix(a.b, b.b)
+  });
+}
+
+// src/model.ts
+var FPS = 60;
+var FRAME_MS = Math.round(1e3 / FPS);
+var DEFAULT_ENV = chapstick.createDefaultContext().env;
+var DEFAULT_WIDTH = 40;
+var DEFAULT_FULL = "\u2588";
+var DEFAULT_EMPTY = "\u2591";
+var DEFAULT_FULL_COLOR = "#7571F9";
+var DEFAULT_EMPTY_COLOR = "#606060";
+var DEFAULT_PERCENT_FORMAT = " %3.0f%%";
+var DEFAULT_GRADIENT_START = "#5A56E0";
+var DEFAULT_GRADIENT_END = "#EE6FF8";
+var SETTLE_DISTANCE = 2e-3;
+var SETTLE_VELOCITY = 0.01;
+var lastId = 0;
+function nextId() {
+  return ++lastId;
+}
+function clamp012(value) {
+  if (Number.isNaN(value)) return 0;
+  return Math.max(0, Math.min(1, value));
+}
+function ensureChar(input, fallback) {
+  if (!input) return fallback;
+  return input.slice(0, 1);
+}
+function formatPercent(value, fmt) {
+  const percentValue = clamp012(value) * 100;
+  const match = fmt.match(/%(\d+)?(?:\.(\d+))?f/);
+  if (!match) {
+    return `${percentValue.toFixed(0)}%`;
+  }
+  const precision = match[2] ? Number.parseInt(match[2], 10) : 0;
+  const replacement = percentValue.toFixed(precision);
+  return fmt.replace(/%(\d+)?(?:\.(\d+))?f/, replacement).replace(/%%/g, "%");
+}
+function settle(percent, target, velocity) {
+  const dist = Math.abs(percent - target);
+  return dist < SETTLE_DISTANCE && Math.abs(velocity) < SETTLE_VELOCITY;
+}
+function resolvedColor(color, fallback) {
+  return chapstick.resolveColor(color, DEFAULT_ENV) ?? fallback;
+}
+function defaultState() {
+  return {
+    percent: 0,
+    target: 0,
+    velocity: 0,
+    id: nextId(),
+    tag: 0,
+    spring: new Spring(),
+    lastFrameTime: null
+  };
+}
+var ProgressModel = class _ProgressModel {
+  width;
+  full;
+  empty;
+  fullColor;
+  emptyColor;
+  showPercentage;
+  percentFormat;
+  gradientStart;
+  gradientEnd;
+  scaleGradient;
+  useGradient;
+  percentageStyle;
+  #percent;
+  #target;
+  #velocity;
+  #id;
+  #tag;
+  #spring;
+  #lastFrameTime;
+  constructor(options = {}, state = {}) {
+    this.width = options.width ?? DEFAULT_WIDTH;
+    this.full = ensureChar(options.full, DEFAULT_FULL);
+    this.empty = ensureChar(options.empty, DEFAULT_EMPTY);
+    this.fullColor = resolvedColor(options.fullColor, DEFAULT_FULL_COLOR);
+    this.emptyColor = resolvedColor(options.emptyColor, DEFAULT_EMPTY_COLOR);
+    this.showPercentage = options.showPercentage ?? true;
+    this.percentFormat = options.percentFormat ?? DEFAULT_PERCENT_FORMAT;
+    this.percentageStyle = options.percentageStyle ?? new chapstick.Style();
+    const start = options.gradientStart ? chapstick.resolveColor(options.gradientStart, DEFAULT_ENV) : void 0;
+    const end = options.gradientEnd ? chapstick.resolveColor(options.gradientEnd, DEFAULT_ENV) : void 0;
+    this.gradientStart = start;
+    this.gradientEnd = end;
+    this.scaleGradient = options.scaleGradient ?? false;
+    this.useGradient = Boolean(start && end);
+    const frequency = options.springFrequency ?? state.spring?.frequency ?? 18;
+    const damping = options.springDamping ?? state.spring?.damping ?? 1;
+    const baseState = { ...defaultState(), ...state };
+    const spring = state.spring ?? new Spring({ frequency, damping });
+    this.#spring = spring.withOptions(frequency, damping);
+    this.#percent = clamp012(baseState.percent);
+    this.#target = clamp012(baseState.target);
+    this.#velocity = baseState.velocity;
+    this.#id = baseState.id;
+    this.#tag = baseState.tag;
+    this.#lastFrameTime = baseState.lastFrameTime;
+  }
+  /** Create a new progress bar with defaults. */
+  static new(options = {}) {
+    return new _ProgressModel(options);
+  }
+  /** Convenience constructor with default gradient. */
+  static withDefaultGradient(options = {}) {
+    return new _ProgressModel({
+      ...options,
+      gradientStart: options.gradientStart ?? DEFAULT_GRADIENT_START,
+      gradientEnd: options.gradientEnd ?? DEFAULT_GRADIENT_END
+    });
+  }
+  /** Convenience constructor with a custom gradient. */
+  static withGradient(colorA, colorB, options = {}) {
+    return new _ProgressModel({
+      ...options,
+      gradientStart: colorA,
+      gradientEnd: colorB
+    });
+  }
+  /** Convenience constructor with solid fill. */
+  static withSolidFill(color, options = {}) {
+    return new _ProgressModel({
+      ...options,
+      fullColor: color,
+      gradientStart: void 0,
+      gradientEnd: void 0
+    });
+  }
+  /** Unique ID for message routing. */
+  id() {
+    return this.#id;
+  }
+  /** Current animated percent (0-1). */
+  percent() {
+    return clamp012(this.#percent);
+  }
+  /** Target percent (0-1). */
+  targetPercent() {
+    return clamp012(this.#target);
+  }
+  /** Tea init hook (no-op). */
+  init() {
+    return null;
+  }
+  /** Handle messages; consumes FrameMsg for animation. */
+  update(msg) {
+    if (!(msg instanceof FrameMsg)) {
+      return [this, null];
+    }
+    if (msg.id !== this.#id || msg.tag !== this.#tag) {
+      return [this, null];
+    }
+    const dt = this.#lastFrameTime === null ? FRAME_MS : Math.max(1, msg.time.getTime() - this.#lastFrameTime.getTime());
+    const spring = this.#spring.update(this.#target, dt);
+    const nextPercent = clamp012(spring.position());
+    const nextVelocity = spring.velocity();
+    const next = this.withState({
+      percent: nextPercent,
+      velocity: nextVelocity,
+      tag: this.#tag,
+      spring,
+      lastFrameTime: msg.time
+    });
+    if (settle(nextPercent, this.#target, nextVelocity)) {
+      return [next, null];
+    }
+    return [next, next.nextFrame()];
+  }
+  /** Set a new target percent and start animation. */
+  setPercent(percent) {
+    const clamped = clamp012(percent);
+    const next = this.withState({
+      target: clamped,
+      tag: this.#tag + 1,
+      lastFrameTime: null
+    });
+    return [next, next.nextFrame()];
+  }
+  /** Increment the target percent. */
+  incrPercent(delta) {
+    return this.setPercent(this.#target + delta);
+  }
+  /** Update the spring configuration (keeps current state). */
+  setSpringOptions(frequency, damping) {
+    const spring = this.#spring.withOptions(frequency, damping);
+    return this.withState({ spring });
+  }
+  /** Render the animated progress bar. */
+  view() {
+    return this.viewAs(this.percent());
+  }
+  /** Render the bar at an explicit percent (0-1). */
+  viewAs(percent) {
+    const pct = clamp012(percent);
+    const percentText = this.showPercentage ? this.percentageStyle.render(formatPercent(pct, this.percentFormat)) : "";
+    const percentWidth = this.showPercentage ? chapstick.width(percentText) : 0;
+    const totalBarWidth = Math.max(0, this.width - percentWidth);
+    const filledWidth = Math.max(0, Math.round(totalBarWidth * pct));
+    const emptyWidth = Math.max(0, totalBarWidth - filledWidth);
+    const bar = `${this.useGradient ? this.renderGradient(filledWidth, totalBarWidth) : this.renderSolid(filledWidth)}${this.renderEmpty(emptyWidth)}`;
+    return `${bar}${percentText}`;
+  }
+  renderGradient(filledWidth, totalWidth) {
+    if (!this.useGradient || filledWidth <= 0 || !this.gradientStart || !this.gradientEnd) {
+      return "";
+    }
+    const parts = [];
+    const denominator = this.scaleGradient ? Math.max(1, filledWidth - 1) : Math.max(1, totalWidth - 1);
+    for (let i = 0; i < filledWidth; i++) {
+      const t = filledWidth === 1 ? 0.5 : i / denominator;
+      const color = interpolateColor(this.gradientStart, this.gradientEnd, t);
+      parts.push(new chapstick.Style().foreground(color).render(this.full));
+    }
+    return parts.join("");
+  }
+  renderSolid(filledWidth) {
+    if (filledWidth <= 0) return "";
+    const styled = new chapstick.Style().foreground(this.fullColor).render(this.full);
+    return styled.repeat(filledWidth);
+  }
+  renderEmpty(emptyWidth) {
+    if (emptyWidth <= 0) return "";
+    const styled = new chapstick.Style().foreground(this.emptyColor).render(this.empty);
+    return styled.repeat(emptyWidth);
+  }
+  nextFrame() {
+    const id = this.#id;
+    const tag = this.#tag;
+    return tea.tick(FRAME_MS, (time) => new FrameMsg(id, tag, time));
+  }
+  withState(state) {
+    return new _ProgressModel(
+      {
+        width: this.width,
+        full: this.full,
+        empty: this.empty,
+        fullColor: this.fullColor,
+        emptyColor: this.emptyColor,
+        showPercentage: this.showPercentage,
+        percentFormat: this.percentFormat,
+        gradientStart: this.gradientStart,
+        gradientEnd: this.gradientEnd,
+        scaleGradient: this.scaleGradient,
+        springFrequency: this.#spring.frequency,
+        springDamping: this.#spring.damping,
+        percentageStyle: this.percentageStyle
+      },
+      {
+        percent: this.#percent,
+        target: this.#target,
+        velocity: this.#velocity,
+        id: this.#id,
+        tag: this.#tag,
+        spring: this.#spring,
+        lastFrameTime: this.#lastFrameTime,
+        ...state
+      }
+    );
+  }
+};
+
+exports.FrameMsg = FrameMsg;
+exports.ProgressModel = ProgressModel;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/messages.ts","../src/spring.ts","../src/gradient.ts","../src/model.ts"],"names":["createDefaultContext","clamp01","resolveColor","Style","textWidth","tick"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Message indicating a progress animation frame should be rendered.\n * @public\n */\nexport class FrameMsg {\n  readonly _tag = 'progress:frame'\n\n  constructor(\n    /** Unique progress ID for routing */\n    public readonly id: number,\n    /** Internal tag to prevent duplicate ticks */\n    public readonly tag: number,\n    /** Timestamp when the frame was scheduled */\n    public readonly time: Date,\n  ) {}\n}\n","interface SpringConfig {\n  /** Oscillation speed (Hz). */\n  frequency?: number\n  /** Damping factor (1.0 = critical-ish). */\n  damping?: number\n  /** Starting position (0-1). */\n  position?: number\n  /** Starting velocity. */\n  velocity?: number\n}\n\n/**\n * Minimal damped spring integrator (ported from harmonica).\n * Stores its own position/velocity and integrates using a simple\n * damped harmonic oscillator step.\n */\nexport class Spring {\n  readonly frequency: number\n  readonly damping: number\n  readonly #angular: number\n  readonly #pos: number\n  readonly #vel: number\n\n  constructor(config: SpringConfig = {}) {\n    this.frequency = config.frequency ?? 18\n    this.damping = config.damping ?? 1\n    // Note: using the provided frequency directly (not 2π) keeps the\n    // explicit Euler step stable at ~60 FPS for our use case.\n    this.#angular = this.frequency\n    this.#pos = config.position ?? 0\n    this.#vel = config.velocity ?? 0\n  }\n\n  /** Current position. */\n  position(): number {\n    return this.#pos\n  }\n\n  /** Current velocity. */\n  velocity(): number {\n    return this.#vel\n  }\n\n  /** Return a copy with new spring options, keeping state. */\n  withOptions(frequency: number, damping: number): Spring {\n    return new Spring({\n      frequency,\n      damping,\n      position: this.#pos,\n      velocity: this.#vel,\n    })\n  }\n\n  /**\n   * Integrate toward target over the provided timestep (ms).\n   * Returns the new position and velocity.\n   */\n  update(target: number, deltaMs: number): Spring {\n    // Clamp dt to avoid instability on slow frames.\n    const dt = Math.min(0.05, Math.max(0, deltaMs / 1000))\n    const displacement = this.#pos - target\n\n    const springForce = -this.#angular * this.#angular * displacement\n    const dampingForce = -2 * this.damping * this.#angular * this.#vel\n    const acceleration = springForce + dampingForce\n\n    const velocity = this.#vel + acceleration * dt\n    const position = this.#pos + velocity * dt\n\n    return new Spring({\n      frequency: this.frequency,\n      damping: this.damping,\n      position,\n      velocity,\n    })\n  }\n}\n","interface RGB {\n  r: number\n  g: number\n  b: number\n}\n\nfunction clamp01(value: number): number {\n  return Math.min(1, Math.max(0, value))\n}\n\nfunction hexToRgb(hex: string): RGB | null {\n  const normalized = hex.startsWith('#') ? hex.slice(1) : hex\n  if (normalized.length !== 6) return null\n  const int = Number.parseInt(normalized, 16)\n  if (Number.isNaN(int)) return null\n  return {\n    r: (int >> 16) & 0xff,\n    g: (int >> 8) & 0xff,\n    b: int & 0xff,\n  }\n}\n\nfunction rgbToHex({ r, g, b }: RGB): string {\n  const toHex = (v: number) => v.toString(16).padStart(2, '0')\n  return `#${toHex(r)}${toHex(g)}${toHex(b)}`\n}\n\n/**\n * Linearly interpolate between two hex colors in RGB space.\n * Returns the first color if parsing fails.\n */\nexport function interpolateColor(\n  colorA: string,\n  colorB: string,\n  t: number,\n): string {\n  const a = hexToRgb(colorA)\n  const b = hexToRgb(colorB)\n  if (!a || !b) return colorA\n\n  const tClamped = clamp01(t)\n  const mix = (start: number, end: number) =>\n    Math.round(start + (end - start) * tClamped)\n\n  return rgbToHex({\n    r: mix(a.r, b.r),\n    g: mix(a.g, b.g),\n    b: mix(a.b, b.b),\n  })\n}\n","import { tick, type Cmd, type Msg } from '@boba-cli/tea'\nimport {\n  Style,\n  createDefaultContext,\n  resolveColor,\n  width as textWidth,\n  type ColorInput,\n} from '@boba-cli/chapstick'\nimport { FrameMsg } from './messages.js'\nimport { Spring } from './spring.js'\nimport { interpolateColor } from './gradient.js'\n\nconst FPS = 60\nconst FRAME_MS = Math.round(1000 / FPS)\nconst DEFAULT_ENV = createDefaultContext().env\nconst DEFAULT_WIDTH = 40\nconst DEFAULT_FULL = '█'\nconst DEFAULT_EMPTY = '░'\nconst DEFAULT_FULL_COLOR = '#7571F9'\nconst DEFAULT_EMPTY_COLOR = '#606060'\nconst DEFAULT_PERCENT_FORMAT = ' %3.0f%%'\nconst DEFAULT_GRADIENT_START = '#5A56E0'\nconst DEFAULT_GRADIENT_END = '#EE6FF8'\nconst SETTLE_DISTANCE = 0.002\nconst SETTLE_VELOCITY = 0.01\n\n// Module-level ID counter for message routing\nlet lastId = 0\nfunction nextId(): number {\n  return ++lastId\n}\n\nfunction clamp01(value: number): number {\n  if (Number.isNaN(value)) return 0\n  return Math.max(0, Math.min(1, value))\n}\n\nfunction ensureChar(input: string | undefined, fallback: string): string {\n  if (!input) return fallback\n  // Use the first Unicode grapheme; for simplicity take first code unit\n  return input.slice(0, 1)\n}\n\nfunction formatPercent(value: number, fmt: string): string {\n  const percentValue = clamp01(value) * 100\n  const match = fmt.match(/%(\\d+)?(?:\\.(\\d+))?f/)\n  if (!match) {\n    return `${percentValue.toFixed(0)}%`\n  }\n  const precision = match[2] ? Number.parseInt(match[2], 10) : 0\n  const replacement = percentValue.toFixed(precision)\n  return fmt.replace(/%(\\d+)?(?:\\.(\\d+))?f/, replacement).replace(/%%/g, '%')\n}\n\nfunction settle(percent: number, target: number, velocity: number): boolean {\n  const dist = Math.abs(percent - target)\n  return dist < SETTLE_DISTANCE && Math.abs(velocity) < SETTLE_VELOCITY\n}\n\nfunction resolvedColor(\n  color: ColorInput | undefined,\n  fallback: string,\n): string {\n  return resolveColor(color, DEFAULT_ENV) ?? fallback\n}\n\n/**\n * Options for the progress bar model.\n * @public\n */\nexport interface ProgressOptions {\n  width?: number\n  full?: string\n  empty?: string\n  fullColor?: ColorInput\n  emptyColor?: ColorInput\n  showPercentage?: boolean\n  percentFormat?: string\n  gradientStart?: ColorInput\n  gradientEnd?: ColorInput\n  scaleGradient?: boolean\n  springFrequency?: number\n  springDamping?: number\n  percentageStyle?: Style\n}\n\ninterface ProgressState {\n  percent: number\n  target: number\n  velocity: number\n  id: number\n  tag: number\n  spring: Spring\n  lastFrameTime: Date | null\n}\n\ntype ProgressInit = Partial<ProgressState>\n\nfunction defaultState(): ProgressState {\n  return {\n    percent: 0,\n    target: 0,\n    velocity: 0,\n    id: nextId(),\n    tag: 0,\n    spring: new Spring(),\n    lastFrameTime: null,\n  }\n}\n\n/**\n * Animated progress bar model with spring-based easing.\n * @public\n */\nexport class ProgressModel {\n  readonly width: number\n  readonly full: string\n  readonly empty: string\n  readonly fullColor: string\n  readonly emptyColor: string\n  readonly showPercentage: boolean\n  readonly percentFormat: string\n  readonly gradientStart?: string\n  readonly gradientEnd?: string\n  readonly scaleGradient: boolean\n  readonly useGradient: boolean\n  readonly percentageStyle: Style\n\n  readonly #percent: number\n  readonly #target: number\n  readonly #velocity: number\n  readonly #id: number\n  readonly #tag: number\n  readonly #spring: Spring\n  readonly #lastFrameTime: Date | null\n\n  constructor(options: ProgressOptions = {}, state: ProgressInit = {}) {\n    this.width = options.width ?? DEFAULT_WIDTH\n    this.full = ensureChar(options.full, DEFAULT_FULL)\n    this.empty = ensureChar(options.empty, DEFAULT_EMPTY)\n    this.fullColor = resolvedColor(options.fullColor, DEFAULT_FULL_COLOR)\n    this.emptyColor = resolvedColor(options.emptyColor, DEFAULT_EMPTY_COLOR)\n    this.showPercentage = options.showPercentage ?? true\n    this.percentFormat = options.percentFormat ?? DEFAULT_PERCENT_FORMAT\n    this.percentageStyle = options.percentageStyle ?? new Style()\n\n    const start = options.gradientStart\n      ? resolveColor(options.gradientStart, DEFAULT_ENV)\n      : undefined\n    const end = options.gradientEnd\n      ? resolveColor(options.gradientEnd, DEFAULT_ENV)\n      : undefined\n    this.gradientStart = start\n    this.gradientEnd = end\n    this.scaleGradient = options.scaleGradient ?? false\n    this.useGradient = Boolean(start && end)\n\n    const frequency = options.springFrequency ?? state.spring?.frequency ?? 18\n    const damping = options.springDamping ?? state.spring?.damping ?? 1\n    const baseState = { ...defaultState(), ...state }\n    const spring = state.spring ?? new Spring({ frequency, damping })\n    this.#spring = spring.withOptions(frequency, damping)\n\n    this.#percent = clamp01(baseState.percent)\n    this.#target = clamp01(baseState.target)\n    this.#velocity = baseState.velocity\n    this.#id = baseState.id\n    this.#tag = baseState.tag\n    this.#lastFrameTime = baseState.lastFrameTime\n  }\n\n  /** Create a new progress bar with defaults. */\n  static new(options: ProgressOptions = {}): ProgressModel {\n    return new ProgressModel(options)\n  }\n\n  /** Convenience constructor with default gradient. */\n  static withDefaultGradient(options: ProgressOptions = {}): ProgressModel {\n    return new ProgressModel({\n      ...options,\n      gradientStart: options.gradientStart ?? DEFAULT_GRADIENT_START,\n      gradientEnd: options.gradientEnd ?? DEFAULT_GRADIENT_END,\n    })\n  }\n\n  /** Convenience constructor with a custom gradient. */\n  static withGradient(\n    colorA: ColorInput,\n    colorB: ColorInput,\n    options: ProgressOptions = {},\n  ): ProgressModel {\n    return new ProgressModel({\n      ...options,\n      gradientStart: colorA,\n      gradientEnd: colorB,\n    })\n  }\n\n  /** Convenience constructor with solid fill. */\n  static withSolidFill(\n    color: ColorInput,\n    options: ProgressOptions = {},\n  ): ProgressModel {\n    return new ProgressModel({\n      ...options,\n      fullColor: color,\n      gradientStart: undefined,\n      gradientEnd: undefined,\n    })\n  }\n\n  /** Unique ID for message routing. */\n  id(): number {\n    return this.#id\n  }\n\n  /** Current animated percent (0-1). */\n  percent(): number {\n    return clamp01(this.#percent)\n  }\n\n  /** Target percent (0-1). */\n  targetPercent(): number {\n    return clamp01(this.#target)\n  }\n\n  /** Tea init hook (no-op). */\n  init(): Cmd<Msg> {\n    return null\n  }\n\n  /** Handle messages; consumes FrameMsg for animation. */\n  update(msg: Msg): [ProgressModel, Cmd<Msg>] {\n    if (!(msg instanceof FrameMsg)) {\n      return [this, null]\n    }\n    if (msg.id !== this.#id || msg.tag !== this.#tag) {\n      return [this, null]\n    }\n\n    const dt =\n      this.#lastFrameTime === null\n        ? FRAME_MS\n        : Math.max(1, msg.time.getTime() - this.#lastFrameTime.getTime())\n\n    const spring = this.#spring.update(this.#target, dt)\n    const nextPercent = clamp01(spring.position())\n    const nextVelocity = spring.velocity()\n\n    const next = this.withState({\n      percent: nextPercent,\n      velocity: nextVelocity,\n      tag: this.#tag,\n      spring,\n      lastFrameTime: msg.time,\n    })\n\n    if (settle(nextPercent, this.#target, nextVelocity)) {\n      return [next, null]\n    }\n\n    return [next, next.nextFrame()]\n  }\n\n  /** Set a new target percent and start animation. */\n  setPercent(percent: number): [ProgressModel, Cmd<Msg>] {\n    const clamped = clamp01(percent)\n    const next = this.withState({\n      target: clamped,\n      tag: this.#tag + 1,\n      lastFrameTime: null,\n    })\n    return [next, next.nextFrame()]\n  }\n\n  /** Increment the target percent. */\n  incrPercent(delta: number): [ProgressModel, Cmd<Msg>] {\n    return this.setPercent(this.#target + delta)\n  }\n\n  /** Update the spring configuration (keeps current state). */\n  setSpringOptions(frequency: number, damping: number): ProgressModel {\n    const spring = this.#spring.withOptions(frequency, damping)\n    return this.withState({ spring })\n  }\n\n  /** Render the animated progress bar. */\n  view(): string {\n    return this.viewAs(this.percent())\n  }\n\n  /** Render the bar at an explicit percent (0-1). */\n  viewAs(percent: number): string {\n    const pct = clamp01(percent)\n    const percentText = this.showPercentage\n      ? this.percentageStyle.render(formatPercent(pct, this.percentFormat))\n      : ''\n\n    const percentWidth = this.showPercentage ? textWidth(percentText) : 0\n    const totalBarWidth = Math.max(0, this.width - percentWidth)\n    const filledWidth = Math.max(0, Math.round(totalBarWidth * pct))\n    const emptyWidth = Math.max(0, totalBarWidth - filledWidth)\n\n    const bar = `${this.useGradient ? this.renderGradient(filledWidth, totalBarWidth) : this.renderSolid(filledWidth)}${this.renderEmpty(emptyWidth)}`\n\n    return `${bar}${percentText}`\n  }\n\n  private renderGradient(filledWidth: number, totalWidth: number): string {\n    if (\n      !this.useGradient ||\n      filledWidth <= 0 ||\n      !this.gradientStart ||\n      !this.gradientEnd\n    ) {\n      return ''\n    }\n\n    const parts: string[] = []\n    const denominator = this.scaleGradient\n      ? Math.max(1, filledWidth - 1)\n      : Math.max(1, totalWidth - 1)\n\n    for (let i = 0; i < filledWidth; i++) {\n      const t = filledWidth === 1 ? 0.5 : i / denominator\n      const color = interpolateColor(this.gradientStart, this.gradientEnd, t)\n      parts.push(new Style().foreground(color).render(this.full))\n    }\n\n    return parts.join('')\n  }\n\n  private renderSolid(filledWidth: number): string {\n    if (filledWidth <= 0) return ''\n    const styled = new Style().foreground(this.fullColor).render(this.full)\n    return styled.repeat(filledWidth)\n  }\n\n  private renderEmpty(emptyWidth: number): string {\n    if (emptyWidth <= 0) return ''\n    const styled = new Style().foreground(this.emptyColor).render(this.empty)\n    return styled.repeat(emptyWidth)\n  }\n\n  private nextFrame(): Cmd<FrameMsg> {\n    const id = this.#id\n    const tag = this.#tag\n    return tick(FRAME_MS, (time) => new FrameMsg(id, tag, time))\n  }\n\n  private withState(state: ProgressInit): ProgressModel {\n    return new ProgressModel(\n      {\n        width: this.width,\n        full: this.full,\n        empty: this.empty,\n        fullColor: this.fullColor,\n        emptyColor: this.emptyColor,\n        showPercentage: this.showPercentage,\n        percentFormat: this.percentFormat,\n        gradientStart: this.gradientStart,\n        gradientEnd: this.gradientEnd,\n        scaleGradient: this.scaleGradient,\n        springFrequency: this.#spring.frequency,\n        springDamping: this.#spring.damping,\n        percentageStyle: this.percentageStyle,\n      },\n      {\n        percent: this.#percent,\n        target: this.#target,\n        velocity: this.#velocity,\n        id: this.#id,\n        tag: this.#tag,\n        spring: this.#spring,\n        lastFrameTime: this.#lastFrameTime,\n        ...state,\n      },\n    )\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,141 @@
+import { Cmd, Msg } from '@boba-cli/tea';
+import { Style, ColorInput } from '@boba-cli/chapstick';
+
+interface SpringConfig {
+    /** Oscillation speed (Hz). */
+    frequency?: number;
+    /** Damping factor (1.0 = critical-ish). */
+    damping?: number;
+    /** Starting position (0-1). */
+    position?: number;
+    /** Starting velocity. */
+    velocity?: number;
+}
+/**
+ * Minimal damped spring integrator (ported from harmonica).
+ * Stores its own position/velocity and integrates using a simple
+ * damped harmonic oscillator step.
+ */
+declare class Spring {
+    #private;
+    readonly frequency: number;
+    readonly damping: number;
+    constructor(config?: SpringConfig);
+    /** Current position. */
+    position(): number;
+    /** Current velocity. */
+    velocity(): number;
+    /** Return a copy with new spring options, keeping state. */
+    withOptions(frequency: number, damping: number): Spring;
+    /**
+     * Integrate toward target over the provided timestep (ms).
+     * Returns the new position and velocity.
+     */
+    update(target: number, deltaMs: number): Spring;
+}
+
+/**
+ * Options for the progress bar model.
+ * @public
+ */
+interface ProgressOptions {
+    width?: number;
+    full?: string;
+    empty?: string;
+    fullColor?: ColorInput;
+    emptyColor?: ColorInput;
+    showPercentage?: boolean;
+    percentFormat?: string;
+    gradientStart?: ColorInput;
+    gradientEnd?: ColorInput;
+    scaleGradient?: boolean;
+    springFrequency?: number;
+    springDamping?: number;
+    percentageStyle?: Style;
+}
+interface ProgressState {
+    percent: number;
+    target: number;
+    velocity: number;
+    id: number;
+    tag: number;
+    spring: Spring;
+    lastFrameTime: Date | null;
+}
+type ProgressInit = Partial<ProgressState>;
+/**
+ * Animated progress bar model with spring-based easing.
+ * @public
+ */
+declare class ProgressModel {
+    #private;
+    readonly width: number;
+    readonly full: string;
+    readonly empty: string;
+    readonly fullColor: string;
+    readonly emptyColor: string;
+    readonly showPercentage: boolean;
+    readonly percentFormat: string;
+    readonly gradientStart?: string;
+    readonly gradientEnd?: string;
+    readonly scaleGradient: boolean;
+    readonly useGradient: boolean;
+    readonly percentageStyle: Style;
+    constructor(options?: ProgressOptions, state?: ProgressInit);
+    /** Create a new progress bar with defaults. */
+    static new(options?: ProgressOptions): ProgressModel;
+    /** Convenience constructor with default gradient. */
+    static withDefaultGradient(options?: ProgressOptions): ProgressModel;
+    /** Convenience constructor with a custom gradient. */
+    static withGradient(colorA: ColorInput, colorB: ColorInput, options?: ProgressOptions): ProgressModel;
+    /** Convenience constructor with solid fill. */
+    static withSolidFill(color: ColorInput, options?: ProgressOptions): ProgressModel;
+    /** Unique ID for message routing. */
+    id(): number;
+    /** Current animated percent (0-1). */
+    percent(): number;
+    /** Target percent (0-1). */
+    targetPercent(): number;
+    /** Tea init hook (no-op). */
+    init(): Cmd<Msg>;
+    /** Handle messages; consumes FrameMsg for animation. */
+    update(msg: Msg): [ProgressModel, Cmd<Msg>];
+    /** Set a new target percent and start animation. */
+    setPercent(percent: number): [ProgressModel, Cmd<Msg>];
+    /** Increment the target percent. */
+    incrPercent(delta: number): [ProgressModel, Cmd<Msg>];
+    /** Update the spring configuration (keeps current state). */
+    setSpringOptions(frequency: number, damping: number): ProgressModel;
+    /** Render the animated progress bar. */
+    view(): string;
+    /** Render the bar at an explicit percent (0-1). */
+    viewAs(percent: number): string;
+    private renderGradient;
+    private renderSolid;
+    private renderEmpty;
+    private nextFrame;
+    private withState;
+}
+
+/**
+ * Message indicating a progress animation frame should be rendered.
+ * @public
+ */
+declare class FrameMsg {
+    /** Unique progress ID for routing */
+    readonly id: number;
+    /** Internal tag to prevent duplicate ticks */
+    readonly tag: number;
+    /** Timestamp when the frame was scheduled */
+    readonly time: Date;
+    readonly _tag = "progress:frame";
+    constructor(
+    /** Unique progress ID for routing */
+    id: number, 
+    /** Internal tag to prevent duplicate ticks */
+    tag: number, 
+    /** Timestamp when the frame was scheduled */
+    time: Date);
+}
+
+export { FrameMsg, ProgressModel, type ProgressOptions };

package/dist/index.d.ts

@@ -0,0 +1,141 @@
+import { Cmd, Msg } from '@boba-cli/tea';
+import { Style, ColorInput } from '@boba-cli/chapstick';
+
+interface SpringConfig {
+    /** Oscillation speed (Hz). */
+    frequency?: number;
+    /** Damping factor (1.0 = critical-ish). */
+    damping?: number;
+    /** Starting position (0-1). */
+    position?: number;
+    /** Starting velocity. */
+    velocity?: number;
+}
+/**
+ * Minimal damped spring integrator (ported from harmonica).
+ * Stores its own position/velocity and integrates using a simple
+ * damped harmonic oscillator step.
+ */
+declare class Spring {
+    #private;
+    readonly frequency: number;
+    readonly damping: number;
+    constructor(config?: SpringConfig);
+    /** Current position. */
+    position(): number;
+    /** Current velocity. */
+    velocity(): number;
+    /** Return a copy with new spring options, keeping state. */
+    withOptions(frequency: number, damping: number): Spring;
+    /**
+     * Integrate toward target over the provided timestep (ms).
+     * Returns the new position and velocity.
+     */
+    update(target: number, deltaMs: number): Spring;
+}
+
+/**
+ * Options for the progress bar model.
+ * @public
+ */
+interface ProgressOptions {
+    width?: number;
+    full?: string;
+    empty?: string;
+    fullColor?: ColorInput;
+    emptyColor?: ColorInput;
+    showPercentage?: boolean;
+    percentFormat?: string;
+    gradientStart?: ColorInput;
+    gradientEnd?: ColorInput;
+    scaleGradient?: boolean;
+    springFrequency?: number;
+    springDamping?: number;
+    percentageStyle?: Style;
+}
+interface ProgressState {
+    percent: number;
+    target: number;
+    velocity: number;
+    id: number;
+    tag: number;
+    spring: Spring;
+    lastFrameTime: Date | null;
+}
+type ProgressInit = Partial<ProgressState>;
+/**
+ * Animated progress bar model with spring-based easing.
+ * @public
+ */
+declare class ProgressModel {
+    #private;
+    readonly width: number;
+    readonly full: string;
+    readonly empty: string;
+    readonly fullColor: string;
+    readonly emptyColor: string;
+    readonly showPercentage: boolean;
+    readonly percentFormat: string;
+    readonly gradientStart?: string;
+    readonly gradientEnd?: string;
+    readonly scaleGradient: boolean;
+    readonly useGradient: boolean;
+    readonly percentageStyle: Style;
+    constructor(options?: ProgressOptions, state?: ProgressInit);
+    /** Create a new progress bar with defaults. */
+    static new(options?: ProgressOptions): ProgressModel;
+    /** Convenience constructor with default gradient. */
+    static withDefaultGradient(options?: ProgressOptions): ProgressModel;
+    /** Convenience constructor with a custom gradient. */
+    static withGradient(colorA: ColorInput, colorB: ColorInput, options?: ProgressOptions): ProgressModel;
+    /** Convenience constructor with solid fill. */
+    static withSolidFill(color: ColorInput, options?: ProgressOptions): ProgressModel;
+    /** Unique ID for message routing. */
+    id(): number;
+    /** Current animated percent (0-1). */
+    percent(): number;
+    /** Target percent (0-1). */
+    targetPercent(): number;
+    /** Tea init hook (no-op). */
+    init(): Cmd<Msg>;
+    /** Handle messages; consumes FrameMsg for animation. */
+    update(msg: Msg): [ProgressModel, Cmd<Msg>];
+    /** Set a new target percent and start animation. */
+    setPercent(percent: number): [ProgressModel, Cmd<Msg>];
+    /** Increment the target percent. */
+    incrPercent(delta: number): [ProgressModel, Cmd<Msg>];
+    /** Update the spring configuration (keeps current state). */
+    setSpringOptions(frequency: number, damping: number): ProgressModel;
+    /** Render the animated progress bar. */
+    view(): string;
+    /** Render the bar at an explicit percent (0-1). */
+    viewAs(percent: number): string;
+    private renderGradient;
+    private renderSolid;
+    private renderEmpty;
+    private nextFrame;
+    private withState;
+}
+
+/**
+ * Message indicating a progress animation frame should be rendered.
+ * @public
+ */
+declare class FrameMsg {
+    /** Unique progress ID for routing */
+    readonly id: number;
+    /** Internal tag to prevent duplicate ticks */
+    readonly tag: number;
+    /** Timestamp when the frame was scheduled */
+    readonly time: Date;
+    readonly _tag = "progress:frame";
+    constructor(
+    /** Unique progress ID for routing */
+    id: number, 
+    /** Internal tag to prevent duplicate ticks */
+    tag: number, 
+    /** Timestamp when the frame was scheduled */
+    time: Date);
+}
+
+export { FrameMsg, ProgressModel, type ProgressOptions };

package/dist/index.js

@@ -0,0 +1,365 @@
+import { tick } from '@boba-cli/tea';
+import { createDefaultContext, Style, resolveColor, width } from '@boba-cli/chapstick';
+
+// src/model.ts
+
+// src/messages.ts
+var FrameMsg = class {
+  constructor(id, tag, time) {
+    this.id = id;
+    this.tag = tag;
+    this.time = time;
+  }
+  _tag = "progress:frame";
+};
+
+// src/spring.ts
+var Spring = class _Spring {
+  frequency;
+  damping;
+  #angular;
+  #pos;
+  #vel;
+  constructor(config = {}) {
+    this.frequency = config.frequency ?? 18;
+    this.damping = config.damping ?? 1;
+    this.#angular = this.frequency;
+    this.#pos = config.position ?? 0;
+    this.#vel = config.velocity ?? 0;
+  }
+  /** Current position. */
+  position() {
+    return this.#pos;
+  }
+  /** Current velocity. */
+  velocity() {
+    return this.#vel;
+  }
+  /** Return a copy with new spring options, keeping state. */
+  withOptions(frequency, damping) {
+    return new _Spring({
+      frequency,
+      damping,
+      position: this.#pos,
+      velocity: this.#vel
+    });
+  }
+  /**
+   * Integrate toward target over the provided timestep (ms).
+   * Returns the new position and velocity.
+   */
+  update(target, deltaMs) {
+    const dt = Math.min(0.05, Math.max(0, deltaMs / 1e3));
+    const displacement = this.#pos - target;
+    const springForce = -this.#angular * this.#angular * displacement;
+    const dampingForce = -2 * this.damping * this.#angular * this.#vel;
+    const acceleration = springForce + dampingForce;
+    const velocity = this.#vel + acceleration * dt;
+    const position = this.#pos + velocity * dt;
+    return new _Spring({
+      frequency: this.frequency,
+      damping: this.damping,
+      position,
+      velocity
+    });
+  }
+};
+
+// src/gradient.ts
+function clamp01(value) {
+  return Math.min(1, Math.max(0, value));
+}
+function hexToRgb(hex) {
+  const normalized = hex.startsWith("#") ? hex.slice(1) : hex;
+  if (normalized.length !== 6) return null;
+  const int = Number.parseInt(normalized, 16);
+  if (Number.isNaN(int)) return null;
+  return {
+    r: int >> 16 & 255,
+    g: int >> 8 & 255,
+    b: int & 255
+  };
+}
+function rgbToHex({ r, g, b }) {
+  const toHex = (v) => v.toString(16).padStart(2, "0");
+  return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+function interpolateColor(colorA, colorB, t) {
+  const a = hexToRgb(colorA);
+  const b = hexToRgb(colorB);
+  if (!a || !b) return colorA;
+  const tClamped = clamp01(t);
+  const mix = (start, end) => Math.round(start + (end - start) * tClamped);
+  return rgbToHex({
+    r: mix(a.r, b.r),
+    g: mix(a.g, b.g),
+    b: mix(a.b, b.b)
+  });
+}
+
+// src/model.ts
+var FPS = 60;
+var FRAME_MS = Math.round(1e3 / FPS);
+var DEFAULT_ENV = createDefaultContext().env;
+var DEFAULT_WIDTH = 40;
+var DEFAULT_FULL = "\u2588";
+var DEFAULT_EMPTY = "\u2591";
+var DEFAULT_FULL_COLOR = "#7571F9";
+var DEFAULT_EMPTY_COLOR = "#606060";
+var DEFAULT_PERCENT_FORMAT = " %3.0f%%";
+var DEFAULT_GRADIENT_START = "#5A56E0";
+var DEFAULT_GRADIENT_END = "#EE6FF8";
+var SETTLE_DISTANCE = 2e-3;
+var SETTLE_VELOCITY = 0.01;
+var lastId = 0;
+function nextId() {
+  return ++lastId;
+}
+function clamp012(value) {
+  if (Number.isNaN(value)) return 0;
+  return Math.max(0, Math.min(1, value));
+}
+function ensureChar(input, fallback) {
+  if (!input) return fallback;
+  return input.slice(0, 1);
+}
+function formatPercent(value, fmt) {
+  const percentValue = clamp012(value) * 100;
+  const match = fmt.match(/%(\d+)?(?:\.(\d+))?f/);
+  if (!match) {
+    return `${percentValue.toFixed(0)}%`;
+  }
+  const precision = match[2] ? Number.parseInt(match[2], 10) : 0;
+  const replacement = percentValue.toFixed(precision);
+  return fmt.replace(/%(\d+)?(?:\.(\d+))?f/, replacement).replace(/%%/g, "%");
+}
+function settle(percent, target, velocity) {
+  const dist = Math.abs(percent - target);
+  return dist < SETTLE_DISTANCE && Math.abs(velocity) < SETTLE_VELOCITY;
+}
+function resolvedColor(color, fallback) {
+  return resolveColor(color, DEFAULT_ENV) ?? fallback;
+}
+function defaultState() {
+  return {
+    percent: 0,
+    target: 0,
+    velocity: 0,
+    id: nextId(),
+    tag: 0,
+    spring: new Spring(),
+    lastFrameTime: null
+  };
+}
+var ProgressModel = class _ProgressModel {
+  width;
+  full;
+  empty;
+  fullColor;
+  emptyColor;
+  showPercentage;
+  percentFormat;
+  gradientStart;
+  gradientEnd;
+  scaleGradient;
+  useGradient;
+  percentageStyle;
+  #percent;
+  #target;
+  #velocity;
+  #id;
+  #tag;
+  #spring;
+  #lastFrameTime;
+  constructor(options = {}, state = {}) {
+    this.width = options.width ?? DEFAULT_WIDTH;
+    this.full = ensureChar(options.full, DEFAULT_FULL);
+    this.empty = ensureChar(options.empty, DEFAULT_EMPTY);
+    this.fullColor = resolvedColor(options.fullColor, DEFAULT_FULL_COLOR);
+    this.emptyColor = resolvedColor(options.emptyColor, DEFAULT_EMPTY_COLOR);
+    this.showPercentage = options.showPercentage ?? true;
+    this.percentFormat = options.percentFormat ?? DEFAULT_PERCENT_FORMAT;
+    this.percentageStyle = options.percentageStyle ?? new Style();
+    const start = options.gradientStart ? resolveColor(options.gradientStart, DEFAULT_ENV) : void 0;
+    const end = options.gradientEnd ? resolveColor(options.gradientEnd, DEFAULT_ENV) : void 0;
+    this.gradientStart = start;
+    this.gradientEnd = end;
+    this.scaleGradient = options.scaleGradient ?? false;
+    this.useGradient = Boolean(start && end);
+    const frequency = options.springFrequency ?? state.spring?.frequency ?? 18;
+    const damping = options.springDamping ?? state.spring?.damping ?? 1;
+    const baseState = { ...defaultState(), ...state };
+    const spring = state.spring ?? new Spring({ frequency, damping });
+    this.#spring = spring.withOptions(frequency, damping);
+    this.#percent = clamp012(baseState.percent);
+    this.#target = clamp012(baseState.target);
+    this.#velocity = baseState.velocity;
+    this.#id = baseState.id;
+    this.#tag = baseState.tag;
+    this.#lastFrameTime = baseState.lastFrameTime;
+  }
+  /** Create a new progress bar with defaults. */
+  static new(options = {}) {
+    return new _ProgressModel(options);
+  }
+  /** Convenience constructor with default gradient. */
+  static withDefaultGradient(options = {}) {
+    return new _ProgressModel({
+      ...options,
+      gradientStart: options.gradientStart ?? DEFAULT_GRADIENT_START,
+      gradientEnd: options.gradientEnd ?? DEFAULT_GRADIENT_END
+    });
+  }
+  /** Convenience constructor with a custom gradient. */
+  static withGradient(colorA, colorB, options = {}) {
+    return new _ProgressModel({
+      ...options,
+      gradientStart: colorA,
+      gradientEnd: colorB
+    });
+  }
+  /** Convenience constructor with solid fill. */
+  static withSolidFill(color, options = {}) {
+    return new _ProgressModel({
+      ...options,
+      fullColor: color,
+      gradientStart: void 0,
+      gradientEnd: void 0
+    });
+  }
+  /** Unique ID for message routing. */
+  id() {
+    return this.#id;
+  }
+  /** Current animated percent (0-1). */
+  percent() {
+    return clamp012(this.#percent);
+  }
+  /** Target percent (0-1). */
+  targetPercent() {
+    return clamp012(this.#target);
+  }
+  /** Tea init hook (no-op). */
+  init() {
+    return null;
+  }
+  /** Handle messages; consumes FrameMsg for animation. */
+  update(msg) {
+    if (!(msg instanceof FrameMsg)) {
+      return [this, null];
+    }
+    if (msg.id !== this.#id || msg.tag !== this.#tag) {
+      return [this, null];
+    }
+    const dt = this.#lastFrameTime === null ? FRAME_MS : Math.max(1, msg.time.getTime() - this.#lastFrameTime.getTime());
+    const spring = this.#spring.update(this.#target, dt);
+    const nextPercent = clamp012(spring.position());
+    const nextVelocity = spring.velocity();
+    const next = this.withState({
+      percent: nextPercent,
+      velocity: nextVelocity,
+      tag: this.#tag,
+      spring,
+      lastFrameTime: msg.time
+    });
+    if (settle(nextPercent, this.#target, nextVelocity)) {
+      return [next, null];
+    }
+    return [next, next.nextFrame()];
+  }
+  /** Set a new target percent and start animation. */
+  setPercent(percent) {
+    const clamped = clamp012(percent);
+    const next = this.withState({
+      target: clamped,
+      tag: this.#tag + 1,
+      lastFrameTime: null
+    });
+    return [next, next.nextFrame()];
+  }
+  /** Increment the target percent. */
+  incrPercent(delta) {
+    return this.setPercent(this.#target + delta);
+  }
+  /** Update the spring configuration (keeps current state). */
+  setSpringOptions(frequency, damping) {
+    const spring = this.#spring.withOptions(frequency, damping);
+    return this.withState({ spring });
+  }
+  /** Render the animated progress bar. */
+  view() {
+    return this.viewAs(this.percent());
+  }
+  /** Render the bar at an explicit percent (0-1). */
+  viewAs(percent) {
+    const pct = clamp012(percent);
+    const percentText = this.showPercentage ? this.percentageStyle.render(formatPercent(pct, this.percentFormat)) : "";
+    const percentWidth = this.showPercentage ? width(percentText) : 0;
+    const totalBarWidth = Math.max(0, this.width - percentWidth);
+    const filledWidth = Math.max(0, Math.round(totalBarWidth * pct));
+    const emptyWidth = Math.max(0, totalBarWidth - filledWidth);
+    const bar = `${this.useGradient ? this.renderGradient(filledWidth, totalBarWidth) : this.renderSolid(filledWidth)}${this.renderEmpty(emptyWidth)}`;
+    return `${bar}${percentText}`;
+  }
+  renderGradient(filledWidth, totalWidth) {
+    if (!this.useGradient || filledWidth <= 0 || !this.gradientStart || !this.gradientEnd) {
+      return "";
+    }
+    const parts = [];
+    const denominator = this.scaleGradient ? Math.max(1, filledWidth - 1) : Math.max(1, totalWidth - 1);
+    for (let i = 0; i < filledWidth; i++) {
+      const t = filledWidth === 1 ? 0.5 : i / denominator;
+      const color = interpolateColor(this.gradientStart, this.gradientEnd, t);
+      parts.push(new Style().foreground(color).render(this.full));
+    }
+    return parts.join("");
+  }
+  renderSolid(filledWidth) {
+    if (filledWidth <= 0) return "";
+    const styled = new Style().foreground(this.fullColor).render(this.full);
+    return styled.repeat(filledWidth);
+  }
+  renderEmpty(emptyWidth) {
+    if (emptyWidth <= 0) return "";
+    const styled = new Style().foreground(this.emptyColor).render(this.empty);
+    return styled.repeat(emptyWidth);
+  }
+  nextFrame() {
+    const id = this.#id;
+    const tag = this.#tag;
+    return tick(FRAME_MS, (time) => new FrameMsg(id, tag, time));
+  }
+  withState(state) {
+    return new _ProgressModel(
+      {
+        width: this.width,
+        full: this.full,
+        empty: this.empty,
+        fullColor: this.fullColor,
+        emptyColor: this.emptyColor,
+        showPercentage: this.showPercentage,
+        percentFormat: this.percentFormat,
+        gradientStart: this.gradientStart,
+        gradientEnd: this.gradientEnd,
+        scaleGradient: this.scaleGradient,
+        springFrequency: this.#spring.frequency,
+        springDamping: this.#spring.damping,
+        percentageStyle: this.percentageStyle
+      },
+      {
+        percent: this.#percent,
+        target: this.#target,
+        velocity: this.#velocity,
+        id: this.#id,
+        tag: this.#tag,
+        spring: this.#spring,
+        lastFrameTime: this.#lastFrameTime,
+        ...state
+      }
+    );
+  }
+};
+
+export { FrameMsg, ProgressModel };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/messages.ts","../src/spring.ts","../src/gradient.ts","../src/model.ts"],"names":["clamp01","textWidth"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Message indicating a progress animation frame should be rendered.\n * @public\n */\nexport class FrameMsg {\n  readonly _tag = 'progress:frame'\n\n  constructor(\n    /** Unique progress ID for routing */\n    public readonly id: number,\n    /** Internal tag to prevent duplicate ticks */\n    public readonly tag: number,\n    /** Timestamp when the frame was scheduled */\n    public readonly time: Date,\n  ) {}\n}\n","interface SpringConfig {\n  /** Oscillation speed (Hz). */\n  frequency?: number\n  /** Damping factor (1.0 = critical-ish). */\n  damping?: number\n  /** Starting position (0-1). */\n  position?: number\n  /** Starting velocity. */\n  velocity?: number\n}\n\n/**\n * Minimal damped spring integrator (ported from harmonica).\n * Stores its own position/velocity and integrates using a simple\n * damped harmonic oscillator step.\n */\nexport class Spring {\n  readonly frequency: number\n  readonly damping: number\n  readonly #angular: number\n  readonly #pos: number\n  readonly #vel: number\n\n  constructor(config: SpringConfig = {}) {\n    this.frequency = config.frequency ?? 18\n    this.damping = config.damping ?? 1\n    // Note: using the provided frequency directly (not 2π) keeps the\n    // explicit Euler step stable at ~60 FPS for our use case.\n    this.#angular = this.frequency\n    this.#pos = config.position ?? 0\n    this.#vel = config.velocity ?? 0\n  }\n\n  /** Current position. */\n  position(): number {\n    return this.#pos\n  }\n\n  /** Current velocity. */\n  velocity(): number {\n    return this.#vel\n  }\n\n  /** Return a copy with new spring options, keeping state. */\n  withOptions(frequency: number, damping: number): Spring {\n    return new Spring({\n      frequency,\n      damping,\n      position: this.#pos,\n      velocity: this.#vel,\n    })\n  }\n\n  /**\n   * Integrate toward target over the provided timestep (ms).\n   * Returns the new position and velocity.\n   */\n  update(target: number, deltaMs: number): Spring {\n    // Clamp dt to avoid instability on slow frames.\n    const dt = Math.min(0.05, Math.max(0, deltaMs / 1000))\n    const displacement = this.#pos - target\n\n    const springForce = -this.#angular * this.#angular * displacement\n    const dampingForce = -2 * this.damping * this.#angular * this.#vel\n    const acceleration = springForce + dampingForce\n\n    const velocity = this.#vel + acceleration * dt\n    const position = this.#pos + velocity * dt\n\n    return new Spring({\n      frequency: this.frequency,\n      damping: this.damping,\n      position,\n      velocity,\n    })\n  }\n}\n","interface RGB {\n  r: number\n  g: number\n  b: number\n}\n\nfunction clamp01(value: number): number {\n  return Math.min(1, Math.max(0, value))\n}\n\nfunction hexToRgb(hex: string): RGB | null {\n  const normalized = hex.startsWith('#') ? hex.slice(1) : hex\n  if (normalized.length !== 6) return null\n  const int = Number.parseInt(normalized, 16)\n  if (Number.isNaN(int)) return null\n  return {\n    r: (int >> 16) & 0xff,\n    g: (int >> 8) & 0xff,\n    b: int & 0xff,\n  }\n}\n\nfunction rgbToHex({ r, g, b }: RGB): string {\n  const toHex = (v: number) => v.toString(16).padStart(2, '0')\n  return `#${toHex(r)}${toHex(g)}${toHex(b)}`\n}\n\n/**\n * Linearly interpolate between two hex colors in RGB space.\n * Returns the first color if parsing fails.\n */\nexport function interpolateColor(\n  colorA: string,\n  colorB: string,\n  t: number,\n): string {\n  const a = hexToRgb(colorA)\n  const b = hexToRgb(colorB)\n  if (!a || !b) return colorA\n\n  const tClamped = clamp01(t)\n  const mix = (start: number, end: number) =>\n    Math.round(start + (end - start) * tClamped)\n\n  return rgbToHex({\n    r: mix(a.r, b.r),\n    g: mix(a.g, b.g),\n    b: mix(a.b, b.b),\n  })\n}\n","import { tick, type Cmd, type Msg } from '@boba-cli/tea'\nimport {\n  Style,\n  createDefaultContext,\n  resolveColor,\n  width as textWidth,\n  type ColorInput,\n} from '@boba-cli/chapstick'\nimport { FrameMsg } from './messages.js'\nimport { Spring } from './spring.js'\nimport { interpolateColor } from './gradient.js'\n\nconst FPS = 60\nconst FRAME_MS = Math.round(1000 / FPS)\nconst DEFAULT_ENV = createDefaultContext().env\nconst DEFAULT_WIDTH = 40\nconst DEFAULT_FULL = '█'\nconst DEFAULT_EMPTY = '░'\nconst DEFAULT_FULL_COLOR = '#7571F9'\nconst DEFAULT_EMPTY_COLOR = '#606060'\nconst DEFAULT_PERCENT_FORMAT = ' %3.0f%%'\nconst DEFAULT_GRADIENT_START = '#5A56E0'\nconst DEFAULT_GRADIENT_END = '#EE6FF8'\nconst SETTLE_DISTANCE = 0.002\nconst SETTLE_VELOCITY = 0.01\n\n// Module-level ID counter for message routing\nlet lastId = 0\nfunction nextId(): number {\n  return ++lastId\n}\n\nfunction clamp01(value: number): number {\n  if (Number.isNaN(value)) return 0\n  return Math.max(0, Math.min(1, value))\n}\n\nfunction ensureChar(input: string | undefined, fallback: string): string {\n  if (!input) return fallback\n  // Use the first Unicode grapheme; for simplicity take first code unit\n  return input.slice(0, 1)\n}\n\nfunction formatPercent(value: number, fmt: string): string {\n  const percentValue = clamp01(value) * 100\n  const match = fmt.match(/%(\\d+)?(?:\\.(\\d+))?f/)\n  if (!match) {\n    return `${percentValue.toFixed(0)}%`\n  }\n  const precision = match[2] ? Number.parseInt(match[2], 10) : 0\n  const replacement = percentValue.toFixed(precision)\n  return fmt.replace(/%(\\d+)?(?:\\.(\\d+))?f/, replacement).replace(/%%/g, '%')\n}\n\nfunction settle(percent: number, target: number, velocity: number): boolean {\n  const dist = Math.abs(percent - target)\n  return dist < SETTLE_DISTANCE && Math.abs(velocity) < SETTLE_VELOCITY\n}\n\nfunction resolvedColor(\n  color: ColorInput | undefined,\n  fallback: string,\n): string {\n  return resolveColor(color, DEFAULT_ENV) ?? fallback\n}\n\n/**\n * Options for the progress bar model.\n * @public\n */\nexport interface ProgressOptions {\n  width?: number\n  full?: string\n  empty?: string\n  fullColor?: ColorInput\n  emptyColor?: ColorInput\n  showPercentage?: boolean\n  percentFormat?: string\n  gradientStart?: ColorInput\n  gradientEnd?: ColorInput\n  scaleGradient?: boolean\n  springFrequency?: number\n  springDamping?: number\n  percentageStyle?: Style\n}\n\ninterface ProgressState {\n  percent: number\n  target: number\n  velocity: number\n  id: number\n  tag: number\n  spring: Spring\n  lastFrameTime: Date | null\n}\n\ntype ProgressInit = Partial<ProgressState>\n\nfunction defaultState(): ProgressState {\n  return {\n    percent: 0,\n    target: 0,\n    velocity: 0,\n    id: nextId(),\n    tag: 0,\n    spring: new Spring(),\n    lastFrameTime: null,\n  }\n}\n\n/**\n * Animated progress bar model with spring-based easing.\n * @public\n */\nexport class ProgressModel {\n  readonly width: number\n  readonly full: string\n  readonly empty: string\n  readonly fullColor: string\n  readonly emptyColor: string\n  readonly showPercentage: boolean\n  readonly percentFormat: string\n  readonly gradientStart?: string\n  readonly gradientEnd?: string\n  readonly scaleGradient: boolean\n  readonly useGradient: boolean\n  readonly percentageStyle: Style\n\n  readonly #percent: number\n  readonly #target: number\n  readonly #velocity: number\n  readonly #id: number\n  readonly #tag: number\n  readonly #spring: Spring\n  readonly #lastFrameTime: Date | null\n\n  constructor(options: ProgressOptions = {}, state: ProgressInit = {}) {\n    this.width = options.width ?? DEFAULT_WIDTH\n    this.full = ensureChar(options.full, DEFAULT_FULL)\n    this.empty = ensureChar(options.empty, DEFAULT_EMPTY)\n    this.fullColor = resolvedColor(options.fullColor, DEFAULT_FULL_COLOR)\n    this.emptyColor = resolvedColor(options.emptyColor, DEFAULT_EMPTY_COLOR)\n    this.showPercentage = options.showPercentage ?? true\n    this.percentFormat = options.percentFormat ?? DEFAULT_PERCENT_FORMAT\n    this.percentageStyle = options.percentageStyle ?? new Style()\n\n    const start = options.gradientStart\n      ? resolveColor(options.gradientStart, DEFAULT_ENV)\n      : undefined\n    const end = options.gradientEnd\n      ? resolveColor(options.gradientEnd, DEFAULT_ENV)\n      : undefined\n    this.gradientStart = start\n    this.gradientEnd = end\n    this.scaleGradient = options.scaleGradient ?? false\n    this.useGradient = Boolean(start && end)\n\n    const frequency = options.springFrequency ?? state.spring?.frequency ?? 18\n    const damping = options.springDamping ?? state.spring?.damping ?? 1\n    const baseState = { ...defaultState(), ...state }\n    const spring = state.spring ?? new Spring({ frequency, damping })\n    this.#spring = spring.withOptions(frequency, damping)\n\n    this.#percent = clamp01(baseState.percent)\n    this.#target = clamp01(baseState.target)\n    this.#velocity = baseState.velocity\n    this.#id = baseState.id\n    this.#tag = baseState.tag\n    this.#lastFrameTime = baseState.lastFrameTime\n  }\n\n  /** Create a new progress bar with defaults. */\n  static new(options: ProgressOptions = {}): ProgressModel {\n    return new ProgressModel(options)\n  }\n\n  /** Convenience constructor with default gradient. */\n  static withDefaultGradient(options: ProgressOptions = {}): ProgressModel {\n    return new ProgressModel({\n      ...options,\n      gradientStart: options.gradientStart ?? DEFAULT_GRADIENT_START,\n      gradientEnd: options.gradientEnd ?? DEFAULT_GRADIENT_END,\n    })\n  }\n\n  /** Convenience constructor with a custom gradient. */\n  static withGradient(\n    colorA: ColorInput,\n    colorB: ColorInput,\n    options: ProgressOptions = {},\n  ): ProgressModel {\n    return new ProgressModel({\n      ...options,\n      gradientStart: colorA,\n      gradientEnd: colorB,\n    })\n  }\n\n  /** Convenience constructor with solid fill. */\n  static withSolidFill(\n    color: ColorInput,\n    options: ProgressOptions = {},\n  ): ProgressModel {\n    return new ProgressModel({\n      ...options,\n      fullColor: color,\n      gradientStart: undefined,\n      gradientEnd: undefined,\n    })\n  }\n\n  /** Unique ID for message routing. */\n  id(): number {\n    return this.#id\n  }\n\n  /** Current animated percent (0-1). */\n  percent(): number {\n    return clamp01(this.#percent)\n  }\n\n  /** Target percent (0-1). */\n  targetPercent(): number {\n    return clamp01(this.#target)\n  }\n\n  /** Tea init hook (no-op). */\n  init(): Cmd<Msg> {\n    return null\n  }\n\n  /** Handle messages; consumes FrameMsg for animation. */\n  update(msg: Msg): [ProgressModel, Cmd<Msg>] {\n    if (!(msg instanceof FrameMsg)) {\n      return [this, null]\n    }\n    if (msg.id !== this.#id || msg.tag !== this.#tag) {\n      return [this, null]\n    }\n\n    const dt =\n      this.#lastFrameTime === null\n        ? FRAME_MS\n        : Math.max(1, msg.time.getTime() - this.#lastFrameTime.getTime())\n\n    const spring = this.#spring.update(this.#target, dt)\n    const nextPercent = clamp01(spring.position())\n    const nextVelocity = spring.velocity()\n\n    const next = this.withState({\n      percent: nextPercent,\n      velocity: nextVelocity,\n      tag: this.#tag,\n      spring,\n      lastFrameTime: msg.time,\n    })\n\n    if (settle(nextPercent, this.#target, nextVelocity)) {\n      return [next, null]\n    }\n\n    return [next, next.nextFrame()]\n  }\n\n  /** Set a new target percent and start animation. */\n  setPercent(percent: number): [ProgressModel, Cmd<Msg>] {\n    const clamped = clamp01(percent)\n    const next = this.withState({\n      target: clamped,\n      tag: this.#tag + 1,\n      lastFrameTime: null,\n    })\n    return [next, next.nextFrame()]\n  }\n\n  /** Increment the target percent. */\n  incrPercent(delta: number): [ProgressModel, Cmd<Msg>] {\n    return this.setPercent(this.#target + delta)\n  }\n\n  /** Update the spring configuration (keeps current state). */\n  setSpringOptions(frequency: number, damping: number): ProgressModel {\n    const spring = this.#spring.withOptions(frequency, damping)\n    return this.withState({ spring })\n  }\n\n  /** Render the animated progress bar. */\n  view(): string {\n    return this.viewAs(this.percent())\n  }\n\n  /** Render the bar at an explicit percent (0-1). */\n  viewAs(percent: number): string {\n    const pct = clamp01(percent)\n    const percentText = this.showPercentage\n      ? this.percentageStyle.render(formatPercent(pct, this.percentFormat))\n      : ''\n\n    const percentWidth = this.showPercentage ? textWidth(percentText) : 0\n    const totalBarWidth = Math.max(0, this.width - percentWidth)\n    const filledWidth = Math.max(0, Math.round(totalBarWidth * pct))\n    const emptyWidth = Math.max(0, totalBarWidth - filledWidth)\n\n    const bar = `${this.useGradient ? this.renderGradient(filledWidth, totalBarWidth) : this.renderSolid(filledWidth)}${this.renderEmpty(emptyWidth)}`\n\n    return `${bar}${percentText}`\n  }\n\n  private renderGradient(filledWidth: number, totalWidth: number): string {\n    if (\n      !this.useGradient ||\n      filledWidth <= 0 ||\n      !this.gradientStart ||\n      !this.gradientEnd\n    ) {\n      return ''\n    }\n\n    const parts: string[] = []\n    const denominator = this.scaleGradient\n      ? Math.max(1, filledWidth - 1)\n      : Math.max(1, totalWidth - 1)\n\n    for (let i = 0; i < filledWidth; i++) {\n      const t = filledWidth === 1 ? 0.5 : i / denominator\n      const color = interpolateColor(this.gradientStart, this.gradientEnd, t)\n      parts.push(new Style().foreground(color).render(this.full))\n    }\n\n    return parts.join('')\n  }\n\n  private renderSolid(filledWidth: number): string {\n    if (filledWidth <= 0) return ''\n    const styled = new Style().foreground(this.fullColor).render(this.full)\n    return styled.repeat(filledWidth)\n  }\n\n  private renderEmpty(emptyWidth: number): string {\n    if (emptyWidth <= 0) return ''\n    const styled = new Style().foreground(this.emptyColor).render(this.empty)\n    return styled.repeat(emptyWidth)\n  }\n\n  private nextFrame(): Cmd<FrameMsg> {\n    const id = this.#id\n    const tag = this.#tag\n    return tick(FRAME_MS, (time) => new FrameMsg(id, tag, time))\n  }\n\n  private withState(state: ProgressInit): ProgressModel {\n    return new ProgressModel(\n      {\n        width: this.width,\n        full: this.full,\n        empty: this.empty,\n        fullColor: this.fullColor,\n        emptyColor: this.emptyColor,\n        showPercentage: this.showPercentage,\n        percentFormat: this.percentFormat,\n        gradientStart: this.gradientStart,\n        gradientEnd: this.gradientEnd,\n        scaleGradient: this.scaleGradient,\n        springFrequency: this.#spring.frequency,\n        springDamping: this.#spring.damping,\n        percentageStyle: this.percentageStyle,\n      },\n      {\n        percent: this.#percent,\n        target: this.#target,\n        velocity: this.#velocity,\n        id: this.#id,\n        tag: this.#tag,\n        spring: this.#spring,\n        lastFrameTime: this.#lastFrameTime,\n        ...state,\n      },\n    )\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@boba-cli/progress",
+  "description": "Animated progress bar for Boba terminal UIs",
+  "version": "0.1.0-alpha.2",
+  "dependencies": {
+    "@boba-cli/chapstick": "0.1.0-alpha.2",
+    "@boba-cli/tea": "0.1.0-alpha.1"
+  },
+  "devDependencies": {
+    "typescript": "5.8.2",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "check:api-report": "pnpm run generate:api-report",
+    "check:eslint": "pnpm run lint",
+    "generate:api-report": "api-extractor run --local",
+    "lint": "eslint \"{src,test}/**/*.{ts,tsx}\"",
+    "test": "vitest run"
+  }
+}