@boba-cli/stopwatch 0.1.0-alpha.1

package/README.md

@@ -0,0 +1,69 @@
+# @boba-cli/stopwatch
+
+Stopwatch component for Boba terminal UIs. Port of Charmbracelet Bubbles stopwatch.
+
+<img src="../../examples/stopwatch-demo.gif" width="950" alt="Stopwatch component demo" />
+
+## Install
+
+```bash
+pnpm add @boba-cli/stopwatch
+```
+
+## Quickstart
+
+```ts
+import { StopwatchModel, TickMsg } from '@boba-cli/stopwatch'
+import type { Cmd, Msg, Model } from '@boba-cli/tea'
+
+const stopwatch = StopwatchModel.new()
+
+function init(): Cmd<Msg> {
+  return stopwatch.init()
+}
+
+function update(msg: Msg): [Model, Cmd<Msg>] {
+  if (msg instanceof TickMsg) {
+    const [next, cmd] = stopwatch.update(msg)
+    return [{ ...model, stopwatch: next }, cmd]
+  }
+  return [model, null]
+}
+
+function view(): string {
+  return `Elapsed ${stopwatch.view()}`
+}
+```
+
+## API
+
+| Export             | Description                         |
+| ------------------ | ----------------------------------- |
+| `StopwatchModel`   | Stopwatch model                     |
+| `StopwatchOptions` | Options for creating a stopwatch    |
+| `TickMsg`          | Tick message carrying ID/tag        |
+| `StartStopMsg`     | Message to start/stop the stopwatch |
+| `ResetMsg`         | Message to reset elapsed time       |
+
+### StopwatchModel methods
+
+| Method                            | Description                             |
+| --------------------------------- | --------------------------------------- |
+| `id()`                            | Unique ID for message routing           |
+| `running()`                       | Whether the stopwatch is active         |
+| `elapsed()`                       | Milliseconds elapsed                    |
+| `init()`                          | Start ticking on init                   |
+| `update(msg)`                     | Handle messages, returns `[model, cmd]` |
+| `view()`                          | Render elapsed time                     |
+| `start()/stop()/toggle()/reset()` | Control commands                        |
+
+## Scripts
+
+- `pnpm -C packages/stopwatch build`
+- `pnpm -C packages/stopwatch test`
+- `pnpm -C packages/stopwatch lint`
+- `pnpm -C packages/stopwatch generate:api-report`
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,160 @@
+'use strict';
+
+var tea = require('@boba-cli/tea');
+
+// src/messages.ts
+var TickMsg = class {
+  constructor(id, tag) {
+    this.id = id;
+    this.tag = tag;
+  }
+  _tag = "stopwatch-tick";
+};
+var StartStopMsg = class {
+  constructor(id, running) {
+    this.id = id;
+    this.running = running;
+  }
+  _tag = "stopwatch-start-stop";
+};
+var ResetMsg = class {
+  constructor(id) {
+    this.id = id;
+  }
+  _tag = "stopwatch-reset";
+};
+var lastId = 0;
+function nextId() {
+  return ++lastId;
+}
+var StopwatchModel = class _StopwatchModel {
+  interval;
+  #elapsed;
+  #id;
+  #tag;
+  #running;
+  constructor(options) {
+    this.interval = options.interval;
+    this.#elapsed = options.elapsed;
+    this.#running = options.running;
+    this.#id = options.id;
+    this.#tag = options.tag;
+  }
+  /** Create a new stopwatch. */
+  static new(options = {}) {
+    const interval = options.interval ?? 1e3;
+    return new _StopwatchModel({
+      elapsed: 0,
+      interval,
+      running: false,
+      id: nextId(),
+      tag: 0
+    });
+  }
+  /** Create a new stopwatch with explicit interval. */
+  static withInterval(interval) {
+    return _StopwatchModel.new({ interval });
+  }
+  /** Unique ID for message routing. */
+  id() {
+    return this.#id;
+  }
+  /** Whether the stopwatch is running. */
+  running() {
+    return this.#running;
+  }
+  /** Milliseconds elapsed. */
+  elapsed() {
+    return this.#elapsed;
+  }
+  /** Start the stopwatch on init. */
+  init() {
+    return this.start();
+  }
+  /** Update the stopwatch in response to a message. */
+  update(msg) {
+    if (msg instanceof StartStopMsg) {
+      if (msg.id !== this.#id) {
+        return [this, null];
+      }
+      const next = new _StopwatchModel({
+        elapsed: this.#elapsed,
+        interval: this.interval,
+        running: msg.running,
+        id: this.#id,
+        tag: this.#tag
+      });
+      return [next, null];
+    }
+    if (msg instanceof ResetMsg) {
+      if (msg.id !== this.#id) {
+        return [this, null];
+      }
+      const next = new _StopwatchModel({
+        elapsed: 0,
+        interval: this.interval,
+        running: this.#running,
+        id: this.#id,
+        tag: this.#tag
+      });
+      return [next, null];
+    }
+    if (msg instanceof TickMsg) {
+      if (!this.running() || msg.id !== this.#id) {
+        return [this, null];
+      }
+      if (msg.tag !== this.#tag) {
+        return [this, null];
+      }
+      const next = new _StopwatchModel({
+        elapsed: this.#elapsed + this.interval,
+        interval: this.interval,
+        running: this.#running,
+        id: this.#id,
+        tag: this.#tag + 1
+      });
+      return [next, next.tick()];
+    }
+    return [this, null];
+  }
+  /** Render elapsed time as a human-readable string. */
+  view() {
+    return formatDuration(this.#elapsed);
+  }
+  /** Command to start the stopwatch. */
+  start() {
+    return tea.sequence(tea.msg(new StartStopMsg(this.#id, true)), this.tick());
+  }
+  /** Command to stop the stopwatch. */
+  stop() {
+    return tea.msg(new StartStopMsg(this.#id, false));
+  }
+  /** Command to toggle running state. */
+  toggle() {
+    return this.running() ? this.stop() : this.start();
+  }
+  /** Command to reset elapsed time. */
+  reset() {
+    return tea.msg(new ResetMsg(this.#id));
+  }
+  tick() {
+    const id = this.#id;
+    const tag = this.#tag;
+    return tea.tick(this.interval, () => new TickMsg(id, tag));
+  }
+};
+function formatDuration(ms) {
+  const seconds = Math.floor(ms / 1e3) % 60;
+  const minutes = Math.floor(ms / 6e4) % 60;
+  const hours = Math.floor(ms / 36e5);
+  if (hours > 0) return `${hours}h${minutes}m${seconds}s`;
+  if (minutes > 0) return `${minutes}m${seconds}s`;
+  return `${seconds}s`;
+}
+
+exports.ResetMsg = ResetMsg;
+exports.StartStopMsg = StartStopMsg;
+exports.StopwatchModel = StopwatchModel;
+exports.TickMsg = TickMsg;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/messages.ts","../src/model.ts"],"names":["sequence","lift","tick"],"mappings":"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","file":"index.cjs","sourcesContent":["/** Tick message for stopwatch increments. @public */\nexport class TickMsg {\n  readonly _tag = 'stopwatch-tick'\n\n  constructor(\n    /** Unique stopwatch ID */\n    public readonly id: number,\n    /** Internal tag for deduplication */\n    public readonly tag: number,\n  ) {}\n}\n\n/** Message that starts or stops the stopwatch. @public */\nexport class StartStopMsg {\n  readonly _tag = 'stopwatch-start-stop'\n\n  constructor(\n    public readonly id: number,\n    public readonly running: boolean,\n  ) {}\n}\n\n/** Message that resets the stopwatch. @public */\nexport class ResetMsg {\n  readonly _tag = 'stopwatch-reset'\n\n  constructor(public readonly id: number) {}\n}\n","import {\n  msg as lift,\n  sequence,\n  tick,\n  type Cmd,\n  type Msg as TeaMsg,\n  type Model as TeaModel,\n} from '@boba-cli/tea'\nimport { ResetMsg, StartStopMsg, TickMsg } from './messages.js'\n\n// Module-level ID counter for unique stopwatches\nlet lastId = 0\nfunction nextId(): number {\n  return ++lastId\n}\n\n/** Options for creating a stopwatch. @public */\nexport interface StopwatchOptions {\n  /** Tick interval in milliseconds (default: 1000). */\n  interval?: number\n}\n\n/** Stopwatch messages. @public */\nexport type StopwatchMsg = TickMsg | StartStopMsg | ResetMsg\n\n/** Stopwatch model. @public */\nexport class StopwatchModel implements TeaModel<StopwatchMsg, StopwatchModel> {\n  readonly interval: number\n  readonly #elapsed: number\n  readonly #id: number\n  readonly #tag: number\n  readonly #running: boolean\n\n  private constructor(options: {\n    elapsed: number\n    interval: number\n    running: boolean\n    id: number\n    tag: number\n  }) {\n    this.interval = options.interval\n    this.#elapsed = options.elapsed\n    this.#running = options.running\n    this.#id = options.id\n    this.#tag = options.tag\n  }\n\n  /** Create a new stopwatch. */\n  static new(options: StopwatchOptions = {}): StopwatchModel {\n    const interval = options.interval ?? 1000\n    return new StopwatchModel({\n      elapsed: 0,\n      interval,\n      running: false,\n      id: nextId(),\n      tag: 0,\n    })\n  }\n\n  /** Create a new stopwatch with explicit interval. */\n  static withInterval(interval: number): StopwatchModel {\n    return StopwatchModel.new({ interval })\n  }\n\n  /** Unique ID for message routing. */\n  id(): number {\n    return this.#id\n  }\n\n  /** Whether the stopwatch is running. */\n  running(): boolean {\n    return this.#running\n  }\n\n  /** Milliseconds elapsed. */\n  elapsed(): number {\n    return this.#elapsed\n  }\n\n  /** Start the stopwatch on init. */\n  init(): Cmd<StopwatchMsg> {\n    return this.start()\n  }\n\n  /** Update the stopwatch in response to a message. */\n  update(msg: TeaMsg): [StopwatchModel, Cmd<StopwatchMsg>] {\n    if (msg instanceof StartStopMsg) {\n      if (msg.id !== this.#id) {\n        return [this, null]\n      }\n      const next = new StopwatchModel({\n        elapsed: this.#elapsed,\n        interval: this.interval,\n        running: msg.running,\n        id: this.#id,\n        tag: this.#tag,\n      })\n      return [next, null]\n    }\n\n    if (msg instanceof ResetMsg) {\n      if (msg.id !== this.#id) {\n        return [this, null]\n      }\n      const next = new StopwatchModel({\n        elapsed: 0,\n        interval: this.interval,\n        running: this.#running,\n        id: this.#id,\n        tag: this.#tag,\n      })\n      return [next, null]\n    }\n\n    if (msg instanceof TickMsg) {\n      if (!this.running() || msg.id !== this.#id) {\n        return [this, null]\n      }\n\n      if (msg.tag !== this.#tag) {\n        return [this, null]\n      }\n\n      const next = new StopwatchModel({\n        elapsed: this.#elapsed + this.interval,\n        interval: this.interval,\n        running: this.#running,\n        id: this.#id,\n        tag: this.#tag + 1,\n      })\n\n      return [next, next.tick()]\n    }\n\n    return [this, null]\n  }\n\n  /** Render elapsed time as a human-readable string. */\n  view(): string {\n    return formatDuration(this.#elapsed)\n  }\n\n  /** Command to start the stopwatch. */\n  start(): Cmd<StopwatchMsg> {\n    return sequence(lift(new StartStopMsg(this.#id, true)), this.tick())\n  }\n\n  /** Command to stop the stopwatch. */\n  stop(): Cmd<StopwatchMsg> {\n    return lift(new StartStopMsg(this.#id, false))\n  }\n\n  /** Command to toggle running state. */\n  toggle(): Cmd<StopwatchMsg> {\n    return this.running() ? this.stop() : this.start()\n  }\n\n  /** Command to reset elapsed time. */\n  reset(): Cmd<StopwatchMsg> {\n    return lift(new ResetMsg(this.#id))\n  }\n\n  private tick(): Cmd<StopwatchMsg> {\n    const id = this.#id\n    const tag = this.#tag\n    return tick(this.interval, () => new TickMsg(id, tag))\n  }\n}\n\n// Simple duration formatter (e.g., 1h2m3s)\nfunction formatDuration(ms: number): string {\n  const seconds = Math.floor(ms / 1000) % 60\n  const minutes = Math.floor(ms / 60000) % 60\n  const hours = Math.floor(ms / 3600000)\n\n  if (hours > 0) return `${hours}h${minutes}m${seconds}s`\n  if (minutes > 0) return `${minutes}m${seconds}s`\n  return `${seconds}s`\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,69 @@
+import { Model, Cmd, Msg } from '@boba-cli/tea';
+
+/** Tick message for stopwatch increments. @public */
+declare class TickMsg {
+    /** Unique stopwatch ID */
+    readonly id: number;
+    /** Internal tag for deduplication */
+    readonly tag: number;
+    readonly _tag = "stopwatch-tick";
+    constructor(
+    /** Unique stopwatch ID */
+    id: number, 
+    /** Internal tag for deduplication */
+    tag: number);
+}
+/** Message that starts or stops the stopwatch. @public */
+declare class StartStopMsg {
+    readonly id: number;
+    readonly running: boolean;
+    readonly _tag = "stopwatch-start-stop";
+    constructor(id: number, running: boolean);
+}
+/** Message that resets the stopwatch. @public */
+declare class ResetMsg {
+    readonly id: number;
+    readonly _tag = "stopwatch-reset";
+    constructor(id: number);
+}
+
+/** Options for creating a stopwatch. @public */
+interface StopwatchOptions {
+    /** Tick interval in milliseconds (default: 1000). */
+    interval?: number;
+}
+/** Stopwatch messages. @public */
+type StopwatchMsg = TickMsg | StartStopMsg | ResetMsg;
+/** Stopwatch model. @public */
+declare class StopwatchModel implements Model<StopwatchMsg, StopwatchModel> {
+    #private;
+    readonly interval: number;
+    private constructor();
+    /** Create a new stopwatch. */
+    static new(options?: StopwatchOptions): StopwatchModel;
+    /** Create a new stopwatch with explicit interval. */
+    static withInterval(interval: number): StopwatchModel;
+    /** Unique ID for message routing. */
+    id(): number;
+    /** Whether the stopwatch is running. */
+    running(): boolean;
+    /** Milliseconds elapsed. */
+    elapsed(): number;
+    /** Start the stopwatch on init. */
+    init(): Cmd<StopwatchMsg>;
+    /** Update the stopwatch in response to a message. */
+    update(msg: Msg): [StopwatchModel, Cmd<StopwatchMsg>];
+    /** Render elapsed time as a human-readable string. */
+    view(): string;
+    /** Command to start the stopwatch. */
+    start(): Cmd<StopwatchMsg>;
+    /** Command to stop the stopwatch. */
+    stop(): Cmd<StopwatchMsg>;
+    /** Command to toggle running state. */
+    toggle(): Cmd<StopwatchMsg>;
+    /** Command to reset elapsed time. */
+    reset(): Cmd<StopwatchMsg>;
+    private tick;
+}
+
+export { ResetMsg, StartStopMsg, StopwatchModel, type StopwatchMsg, type StopwatchOptions, TickMsg };

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+import { Model, Cmd, Msg } from '@boba-cli/tea';
+
+/** Tick message for stopwatch increments. @public */
+declare class TickMsg {
+    /** Unique stopwatch ID */
+    readonly id: number;
+    /** Internal tag for deduplication */
+    readonly tag: number;
+    readonly _tag = "stopwatch-tick";
+    constructor(
+    /** Unique stopwatch ID */
+    id: number, 
+    /** Internal tag for deduplication */
+    tag: number);
+}
+/** Message that starts or stops the stopwatch. @public */
+declare class StartStopMsg {
+    readonly id: number;
+    readonly running: boolean;
+    readonly _tag = "stopwatch-start-stop";
+    constructor(id: number, running: boolean);
+}
+/** Message that resets the stopwatch. @public */
+declare class ResetMsg {
+    readonly id: number;
+    readonly _tag = "stopwatch-reset";
+    constructor(id: number);
+}
+
+/** Options for creating a stopwatch. @public */
+interface StopwatchOptions {
+    /** Tick interval in milliseconds (default: 1000). */
+    interval?: number;
+}
+/** Stopwatch messages. @public */
+type StopwatchMsg = TickMsg | StartStopMsg | ResetMsg;
+/** Stopwatch model. @public */
+declare class StopwatchModel implements Model<StopwatchMsg, StopwatchModel> {
+    #private;
+    readonly interval: number;
+    private constructor();
+    /** Create a new stopwatch. */
+    static new(options?: StopwatchOptions): StopwatchModel;
+    /** Create a new stopwatch with explicit interval. */
+    static withInterval(interval: number): StopwatchModel;
+    /** Unique ID for message routing. */
+    id(): number;
+    /** Whether the stopwatch is running. */
+    running(): boolean;
+    /** Milliseconds elapsed. */
+    elapsed(): number;
+    /** Start the stopwatch on init. */
+    init(): Cmd<StopwatchMsg>;
+    /** Update the stopwatch in response to a message. */
+    update(msg: Msg): [StopwatchModel, Cmd<StopwatchMsg>];
+    /** Render elapsed time as a human-readable string. */
+    view(): string;
+    /** Command to start the stopwatch. */
+    start(): Cmd<StopwatchMsg>;
+    /** Command to stop the stopwatch. */
+    stop(): Cmd<StopwatchMsg>;
+    /** Command to toggle running state. */
+    toggle(): Cmd<StopwatchMsg>;
+    /** Command to reset elapsed time. */
+    reset(): Cmd<StopwatchMsg>;
+    private tick;
+}
+
+export { ResetMsg, StartStopMsg, StopwatchModel, type StopwatchMsg, type StopwatchOptions, TickMsg };

package/dist/index.js

@@ -0,0 +1,155 @@
+import { sequence, msg, tick } from '@boba-cli/tea';
+
+// src/messages.ts
+var TickMsg = class {
+  constructor(id, tag) {
+    this.id = id;
+    this.tag = tag;
+  }
+  _tag = "stopwatch-tick";
+};
+var StartStopMsg = class {
+  constructor(id, running) {
+    this.id = id;
+    this.running = running;
+  }
+  _tag = "stopwatch-start-stop";
+};
+var ResetMsg = class {
+  constructor(id) {
+    this.id = id;
+  }
+  _tag = "stopwatch-reset";
+};
+var lastId = 0;
+function nextId() {
+  return ++lastId;
+}
+var StopwatchModel = class _StopwatchModel {
+  interval;
+  #elapsed;
+  #id;
+  #tag;
+  #running;
+  constructor(options) {
+    this.interval = options.interval;
+    this.#elapsed = options.elapsed;
+    this.#running = options.running;
+    this.#id = options.id;
+    this.#tag = options.tag;
+  }
+  /** Create a new stopwatch. */
+  static new(options = {}) {
+    const interval = options.interval ?? 1e3;
+    return new _StopwatchModel({
+      elapsed: 0,
+      interval,
+      running: false,
+      id: nextId(),
+      tag: 0
+    });
+  }
+  /** Create a new stopwatch with explicit interval. */
+  static withInterval(interval) {
+    return _StopwatchModel.new({ interval });
+  }
+  /** Unique ID for message routing. */
+  id() {
+    return this.#id;
+  }
+  /** Whether the stopwatch is running. */
+  running() {
+    return this.#running;
+  }
+  /** Milliseconds elapsed. */
+  elapsed() {
+    return this.#elapsed;
+  }
+  /** Start the stopwatch on init. */
+  init() {
+    return this.start();
+  }
+  /** Update the stopwatch in response to a message. */
+  update(msg) {
+    if (msg instanceof StartStopMsg) {
+      if (msg.id !== this.#id) {
+        return [this, null];
+      }
+      const next = new _StopwatchModel({
+        elapsed: this.#elapsed,
+        interval: this.interval,
+        running: msg.running,
+        id: this.#id,
+        tag: this.#tag
+      });
+      return [next, null];
+    }
+    if (msg instanceof ResetMsg) {
+      if (msg.id !== this.#id) {
+        return [this, null];
+      }
+      const next = new _StopwatchModel({
+        elapsed: 0,
+        interval: this.interval,
+        running: this.#running,
+        id: this.#id,
+        tag: this.#tag
+      });
+      return [next, null];
+    }
+    if (msg instanceof TickMsg) {
+      if (!this.running() || msg.id !== this.#id) {
+        return [this, null];
+      }
+      if (msg.tag !== this.#tag) {
+        return [this, null];
+      }
+      const next = new _StopwatchModel({
+        elapsed: this.#elapsed + this.interval,
+        interval: this.interval,
+        running: this.#running,
+        id: this.#id,
+        tag: this.#tag + 1
+      });
+      return [next, next.tick()];
+    }
+    return [this, null];
+  }
+  /** Render elapsed time as a human-readable string. */
+  view() {
+    return formatDuration(this.#elapsed);
+  }
+  /** Command to start the stopwatch. */
+  start() {
+    return sequence(msg(new StartStopMsg(this.#id, true)), this.tick());
+  }
+  /** Command to stop the stopwatch. */
+  stop() {
+    return msg(new StartStopMsg(this.#id, false));
+  }
+  /** Command to toggle running state. */
+  toggle() {
+    return this.running() ? this.stop() : this.start();
+  }
+  /** Command to reset elapsed time. */
+  reset() {
+    return msg(new ResetMsg(this.#id));
+  }
+  tick() {
+    const id = this.#id;
+    const tag = this.#tag;
+    return tick(this.interval, () => new TickMsg(id, tag));
+  }
+};
+function formatDuration(ms) {
+  const seconds = Math.floor(ms / 1e3) % 60;
+  const minutes = Math.floor(ms / 6e4) % 60;
+  const hours = Math.floor(ms / 36e5);
+  if (hours > 0) return `${hours}h${minutes}m${seconds}s`;
+  if (minutes > 0) return `${minutes}m${seconds}s`;
+  return `${seconds}s`;
+}
+
+export { ResetMsg, StartStopMsg, StopwatchModel, TickMsg };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/messages.ts","../src/model.ts"],"names":["lift"],"mappings":"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","file":"index.js","sourcesContent":["/** Tick message for stopwatch increments. @public */\nexport class TickMsg {\n  readonly _tag = 'stopwatch-tick'\n\n  constructor(\n    /** Unique stopwatch ID */\n    public readonly id: number,\n    /** Internal tag for deduplication */\n    public readonly tag: number,\n  ) {}\n}\n\n/** Message that starts or stops the stopwatch. @public */\nexport class StartStopMsg {\n  readonly _tag = 'stopwatch-start-stop'\n\n  constructor(\n    public readonly id: number,\n    public readonly running: boolean,\n  ) {}\n}\n\n/** Message that resets the stopwatch. @public */\nexport class ResetMsg {\n  readonly _tag = 'stopwatch-reset'\n\n  constructor(public readonly id: number) {}\n}\n","import {\n  msg as lift,\n  sequence,\n  tick,\n  type Cmd,\n  type Msg as TeaMsg,\n  type Model as TeaModel,\n} from '@boba-cli/tea'\nimport { ResetMsg, StartStopMsg, TickMsg } from './messages.js'\n\n// Module-level ID counter for unique stopwatches\nlet lastId = 0\nfunction nextId(): number {\n  return ++lastId\n}\n\n/** Options for creating a stopwatch. @public */\nexport interface StopwatchOptions {\n  /** Tick interval in milliseconds (default: 1000). */\n  interval?: number\n}\n\n/** Stopwatch messages. @public */\nexport type StopwatchMsg = TickMsg | StartStopMsg | ResetMsg\n\n/** Stopwatch model. @public */\nexport class StopwatchModel implements TeaModel<StopwatchMsg, StopwatchModel> {\n  readonly interval: number\n  readonly #elapsed: number\n  readonly #id: number\n  readonly #tag: number\n  readonly #running: boolean\n\n  private constructor(options: {\n    elapsed: number\n    interval: number\n    running: boolean\n    id: number\n    tag: number\n  }) {\n    this.interval = options.interval\n    this.#elapsed = options.elapsed\n    this.#running = options.running\n    this.#id = options.id\n    this.#tag = options.tag\n  }\n\n  /** Create a new stopwatch. */\n  static new(options: StopwatchOptions = {}): StopwatchModel {\n    const interval = options.interval ?? 1000\n    return new StopwatchModel({\n      elapsed: 0,\n      interval,\n      running: false,\n      id: nextId(),\n      tag: 0,\n    })\n  }\n\n  /** Create a new stopwatch with explicit interval. */\n  static withInterval(interval: number): StopwatchModel {\n    return StopwatchModel.new({ interval })\n  }\n\n  /** Unique ID for message routing. */\n  id(): number {\n    return this.#id\n  }\n\n  /** Whether the stopwatch is running. */\n  running(): boolean {\n    return this.#running\n  }\n\n  /** Milliseconds elapsed. */\n  elapsed(): number {\n    return this.#elapsed\n  }\n\n  /** Start the stopwatch on init. */\n  init(): Cmd<StopwatchMsg> {\n    return this.start()\n  }\n\n  /** Update the stopwatch in response to a message. */\n  update(msg: TeaMsg): [StopwatchModel, Cmd<StopwatchMsg>] {\n    if (msg instanceof StartStopMsg) {\n      if (msg.id !== this.#id) {\n        return [this, null]\n      }\n      const next = new StopwatchModel({\n        elapsed: this.#elapsed,\n        interval: this.interval,\n        running: msg.running,\n        id: this.#id,\n        tag: this.#tag,\n      })\n      return [next, null]\n    }\n\n    if (msg instanceof ResetMsg) {\n      if (msg.id !== this.#id) {\n        return [this, null]\n      }\n      const next = new StopwatchModel({\n        elapsed: 0,\n        interval: this.interval,\n        running: this.#running,\n        id: this.#id,\n        tag: this.#tag,\n      })\n      return [next, null]\n    }\n\n    if (msg instanceof TickMsg) {\n      if (!this.running() || msg.id !== this.#id) {\n        return [this, null]\n      }\n\n      if (msg.tag !== this.#tag) {\n        return [this, null]\n      }\n\n      const next = new StopwatchModel({\n        elapsed: this.#elapsed + this.interval,\n        interval: this.interval,\n        running: this.#running,\n        id: this.#id,\n        tag: this.#tag + 1,\n      })\n\n      return [next, next.tick()]\n    }\n\n    return [this, null]\n  }\n\n  /** Render elapsed time as a human-readable string. */\n  view(): string {\n    return formatDuration(this.#elapsed)\n  }\n\n  /** Command to start the stopwatch. */\n  start(): Cmd<StopwatchMsg> {\n    return sequence(lift(new StartStopMsg(this.#id, true)), this.tick())\n  }\n\n  /** Command to stop the stopwatch. */\n  stop(): Cmd<StopwatchMsg> {\n    return lift(new StartStopMsg(this.#id, false))\n  }\n\n  /** Command to toggle running state. */\n  toggle(): Cmd<StopwatchMsg> {\n    return this.running() ? this.stop() : this.start()\n  }\n\n  /** Command to reset elapsed time. */\n  reset(): Cmd<StopwatchMsg> {\n    return lift(new ResetMsg(this.#id))\n  }\n\n  private tick(): Cmd<StopwatchMsg> {\n    const id = this.#id\n    const tag = this.#tag\n    return tick(this.interval, () => new TickMsg(id, tag))\n  }\n}\n\n// Simple duration formatter (e.g., 1h2m3s)\nfunction formatDuration(ms: number): string {\n  const seconds = Math.floor(ms / 1000) % 60\n  const minutes = Math.floor(ms / 60000) % 60\n  const hours = Math.floor(ms / 3600000)\n\n  if (hours > 0) return `${hours}h${minutes}m${seconds}s`\n  if (minutes > 0) return `${minutes}m${seconds}s`\n  return `${seconds}s`\n}\n"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@boba-cli/stopwatch",
+  "description": "Stopwatch component for Boba terminal UIs",
+  "version": "0.1.0-alpha.1",
+  "dependencies": {
+    "@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"
+  }
+}