@boba-cli/timer 0.1.0-alpha.1

package/README.md

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

package/dist/index.cjs

@@ -0,0 +1,154 @@
+'use strict';
+
+var tea = require('@boba-cli/tea');
+
+// src/messages.ts
+var TickMsg = class {
+  constructor(id, tag, timeout) {
+    this.id = id;
+    this.tag = tag;
+    this.timeout = timeout;
+  }
+  _tag = "timer-tick";
+};
+var TimeoutMsg = class {
+  constructor(id) {
+    this.id = id;
+  }
+  _tag = "timer-timeout";
+};
+var StartStopMsg = class {
+  constructor(id, running) {
+    this.id = id;
+    this.running = running;
+  }
+  _tag = "timer-start-stop";
+};
+var lastId = 0;
+function nextId() {
+  return ++lastId;
+}
+var TimerModel = class _TimerModel {
+  timeout;
+  interval;
+  #id;
+  #tag;
+  #running;
+  constructor(options) {
+    this.timeout = options.timeout;
+    this.interval = options.interval;
+    this.#running = options.running;
+    this.#id = options.id;
+    this.#tag = options.tag;
+  }
+  /** Create a new timer with the given options. */
+  static new(options) {
+    const interval = options.interval ?? 1e3;
+    return new _TimerModel({
+      timeout: options.timeout,
+      interval,
+      running: true,
+      id: nextId(),
+      tag: 0
+    });
+  }
+  /** Create a new timer with explicit timeout and interval. */
+  static withInterval(timeout, interval) {
+    return _TimerModel.new({ timeout, interval });
+  }
+  /** Unique ID for message routing. */
+  id() {
+    return this.#id;
+  }
+  /** Whether the timer is currently running (false once timed out). */
+  running() {
+    if (this.timedOut()) {
+      return false;
+    }
+    return this.#running;
+  }
+  /** Whether the timer has expired. */
+  timedOut() {
+    return this.timeout <= 0;
+  }
+  /** Start ticking. */
+  init() {
+    return this.tick();
+  }
+  /** Update the timer in response to a message. */
+  update(msg) {
+    if (msg instanceof StartStopMsg) {
+      if (msg.id !== 0 && msg.id !== this.#id) {
+        return [this, null];
+      }
+      const next = new _TimerModel({
+        timeout: this.timeout,
+        interval: this.interval,
+        running: msg.running,
+        id: this.#id,
+        tag: this.#tag
+      });
+      return [next, next.tick()];
+    }
+    if (msg instanceof TickMsg) {
+      if (!this.running() || msg.id !== 0 && msg.id !== this.#id) {
+        return [this, null];
+      }
+      if (msg.tag > 0 && msg.tag !== this.#tag) {
+        return [this, null];
+      }
+      const nextTimeout = this.timeout - this.interval;
+      const nextTag = this.#tag + 1;
+      const next = new _TimerModel({
+        timeout: nextTimeout,
+        interval: this.interval,
+        running: this.#running,
+        id: this.#id,
+        tag: nextTag
+      });
+      const timeoutCmd = next.timedOut() ? tea.msg(new TimeoutMsg(this.#id)) : null;
+      const tickCmd = next.timedOut() ? null : next.tick();
+      return [next, tea.batch(tickCmd, timeoutCmd)];
+    }
+    return [this, null];
+  }
+  /** Render remaining time as a human-readable string. */
+  view() {
+    return formatDuration(Math.max(0, this.timeout));
+  }
+  /** Command to start the timer. */
+  start() {
+    return this.startStop(true);
+  }
+  /** Command to stop/pause the timer. */
+  stop() {
+    return this.startStop(false);
+  }
+  /** Command to toggle running state. */
+  toggle() {
+    return this.startStop(!this.running());
+  }
+  tick() {
+    const id = this.#id;
+    const tag = this.#tag;
+    return tea.tick(this.interval, () => new TickMsg(id, tag, this.timedOut()));
+  }
+  startStop(running) {
+    return tea.msg(new StartStopMsg(this.#id, running));
+  }
+};
+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.StartStopMsg = StartStopMsg;
+exports.TickMsg = TickMsg;
+exports.TimeoutMsg = TimeoutMsg;
+exports.TimerModel = TimerModel;
+//# 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":["lift","batch","tick"],"mappings":"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","file":"index.cjs","sourcesContent":["/** Tick message for timer countdown. @public */\nexport class TickMsg {\n  readonly _tag = 'timer-tick'\n\n  constructor(\n    /** Unique timer ID */\n    public readonly id: number,\n    /** Internal tag for deduplication */\n    public readonly tag: number,\n    /** Whether this tick indicates the timer expired */\n    public readonly timeout: boolean,\n  ) {}\n}\n\n/** Message emitted once when the timer times out. @public */\nexport class TimeoutMsg {\n  readonly _tag = 'timer-timeout'\n\n  constructor(public readonly id: number) {}\n}\n\n/** Message that starts or stops the timer. @public */\nexport class StartStopMsg {\n  readonly _tag = 'timer-start-stop'\n\n  constructor(\n    /** Unique timer ID */\n    public readonly id: number,\n    /** True to run, false to pause */\n    public readonly running: boolean,\n  ) {}\n}\n","import {\n  batch,\n  msg as lift,\n  tick,\n  type Cmd,\n  type Msg as TeaMsg,\n  type Model as TeaModel,\n} from '@boba-cli/tea'\nimport { StartStopMsg, TickMsg, TimeoutMsg } from './messages.js'\n\n// Module-level ID counter for unique timers\nlet lastId = 0\nfunction nextId(): number {\n  return ++lastId\n}\n\n/** Options for creating a timer. @public */\nexport interface TimerOptions {\n  /** Milliseconds until the timer expires. */\n  timeout: number\n  /** Tick interval in milliseconds (default: 1000). */\n  interval?: number\n}\n\n/** Timer messages. @public */\nexport type TimerMsg = TickMsg | TimeoutMsg | StartStopMsg\n\n/** Countdown timer model. @public */\nexport class TimerModel implements TeaModel<TimerMsg, TimerModel> {\n  readonly timeout: number\n  readonly interval: number\n  readonly #id: number\n  readonly #tag: number\n  readonly #running: boolean\n\n  private constructor(options: {\n    timeout: number\n    interval: number\n    running: boolean\n    id: number\n    tag: number\n  }) {\n    this.timeout = options.timeout\n    this.interval = options.interval\n    this.#running = options.running\n    this.#id = options.id\n    this.#tag = options.tag\n  }\n\n  /** Create a new timer with the given options. */\n  static new(options: TimerOptions): TimerModel {\n    const interval = options.interval ?? 1000\n    return new TimerModel({\n      timeout: options.timeout,\n      interval,\n      running: true,\n      id: nextId(),\n      tag: 0,\n    })\n  }\n\n  /** Create a new timer with explicit timeout and interval. */\n  static withInterval(timeout: number, interval: number): TimerModel {\n    return TimerModel.new({ timeout, interval })\n  }\n\n  /** Unique ID for message routing. */\n  id(): number {\n    return this.#id\n  }\n\n  /** Whether the timer is currently running (false once timed out). */\n  running(): boolean {\n    if (this.timedOut()) {\n      return false\n    }\n    return this.#running\n  }\n\n  /** Whether the timer has expired. */\n  timedOut(): boolean {\n    return this.timeout <= 0\n  }\n\n  /** Start ticking. */\n  init(): Cmd<TimerMsg> {\n    return this.tick()\n  }\n\n  /** Update the timer in response to a message. */\n  update(msg: TeaMsg): [TimerModel, Cmd<TimerMsg>] {\n    if (msg instanceof StartStopMsg) {\n      if (msg.id !== 0 && msg.id !== this.#id) {\n        return [this, null]\n      }\n      const next = new TimerModel({\n        timeout: this.timeout,\n        interval: this.interval,\n        running: msg.running,\n        id: this.#id,\n        tag: this.#tag,\n      })\n      return [next, next.tick()]\n    }\n\n    if (msg instanceof TickMsg) {\n      if (!this.running() || (msg.id !== 0 && msg.id !== this.#id)) {\n        return [this, null]\n      }\n\n      if (msg.tag > 0 && msg.tag !== this.#tag) {\n        return [this, null]\n      }\n\n      const nextTimeout = this.timeout - this.interval\n      const nextTag = this.#tag + 1\n\n      const next = new TimerModel({\n        timeout: nextTimeout,\n        interval: this.interval,\n        running: this.#running,\n        id: this.#id,\n        tag: nextTag,\n      })\n\n      const timeoutCmd = next.timedOut() ? lift(new TimeoutMsg(this.#id)) : null\n      const tickCmd = next.timedOut() ? null : next.tick()\n\n      return [next, batch(tickCmd, timeoutCmd)]\n    }\n\n    return [this, null]\n  }\n\n  /** Render remaining time as a human-readable string. */\n  view(): string {\n    return formatDuration(Math.max(0, this.timeout))\n  }\n\n  /** Command to start the timer. */\n  start(): Cmd<TimerMsg> {\n    return this.startStop(true)\n  }\n\n  /** Command to stop/pause the timer. */\n  stop(): Cmd<TimerMsg> {\n    return this.startStop(false)\n  }\n\n  /** Command to toggle running state. */\n  toggle(): Cmd<TimerMsg> {\n    return this.startStop(!this.running())\n  }\n\n  private tick(): Cmd<TimerMsg> {\n    const id = this.#id\n    const tag = this.#tag\n    return tick(this.interval, () => new TickMsg(id, tag, this.timedOut()))\n  }\n\n  private startStop(running: boolean): Cmd<TimerMsg> {\n    return lift(new StartStopMsg(this.#id, running))\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,81 @@
+import { Model, Cmd, Msg } from '@boba-cli/tea';
+
+/** Tick message for timer countdown. @public */
+declare class TickMsg {
+    /** Unique timer ID */
+    readonly id: number;
+    /** Internal tag for deduplication */
+    readonly tag: number;
+    /** Whether this tick indicates the timer expired */
+    readonly timeout: boolean;
+    readonly _tag = "timer-tick";
+    constructor(
+    /** Unique timer ID */
+    id: number, 
+    /** Internal tag for deduplication */
+    tag: number, 
+    /** Whether this tick indicates the timer expired */
+    timeout: boolean);
+}
+/** Message emitted once when the timer times out. @public */
+declare class TimeoutMsg {
+    readonly id: number;
+    readonly _tag = "timer-timeout";
+    constructor(id: number);
+}
+/** Message that starts or stops the timer. @public */
+declare class StartStopMsg {
+    /** Unique timer ID */
+    readonly id: number;
+    /** True to run, false to pause */
+    readonly running: boolean;
+    readonly _tag = "timer-start-stop";
+    constructor(
+    /** Unique timer ID */
+    id: number, 
+    /** True to run, false to pause */
+    running: boolean);
+}
+
+/** Options for creating a timer. @public */
+interface TimerOptions {
+    /** Milliseconds until the timer expires. */
+    timeout: number;
+    /** Tick interval in milliseconds (default: 1000). */
+    interval?: number;
+}
+/** Timer messages. @public */
+type TimerMsg = TickMsg | TimeoutMsg | StartStopMsg;
+/** Countdown timer model. @public */
+declare class TimerModel implements Model<TimerMsg, TimerModel> {
+    #private;
+    readonly timeout: number;
+    readonly interval: number;
+    private constructor();
+    /** Create a new timer with the given options. */
+    static new(options: TimerOptions): TimerModel;
+    /** Create a new timer with explicit timeout and interval. */
+    static withInterval(timeout: number, interval: number): TimerModel;
+    /** Unique ID for message routing. */
+    id(): number;
+    /** Whether the timer is currently running (false once timed out). */
+    running(): boolean;
+    /** Whether the timer has expired. */
+    timedOut(): boolean;
+    /** Start ticking. */
+    init(): Cmd<TimerMsg>;
+    /** Update the timer in response to a message. */
+    update(msg: Msg): [TimerModel, Cmd<TimerMsg>];
+    /** Render remaining time as a human-readable string. */
+    view(): string;
+    /** Command to start the timer. */
+    start(): Cmd<TimerMsg>;
+    /** Command to stop/pause the timer. */
+    stop(): Cmd<TimerMsg>;
+    /** Command to toggle running state. */
+    toggle(): Cmd<TimerMsg>;
+    private tick;
+    private startStop;
+}
+
+export { StartStopMsg, TickMsg, TimeoutMsg, TimerModel, type TimerMsg, type TimerOptions };

package/dist/index.d.ts

@@ -0,0 +1,81 @@
+import { Model, Cmd, Msg } from '@boba-cli/tea';
+
+/** Tick message for timer countdown. @public */
+declare class TickMsg {
+    /** Unique timer ID */
+    readonly id: number;
+    /** Internal tag for deduplication */
+    readonly tag: number;
+    /** Whether this tick indicates the timer expired */
+    readonly timeout: boolean;
+    readonly _tag = "timer-tick";
+    constructor(
+    /** Unique timer ID */
+    id: number, 
+    /** Internal tag for deduplication */
+    tag: number, 
+    /** Whether this tick indicates the timer expired */
+    timeout: boolean);
+}
+/** Message emitted once when the timer times out. @public */
+declare class TimeoutMsg {
+    readonly id: number;
+    readonly _tag = "timer-timeout";
+    constructor(id: number);
+}
+/** Message that starts or stops the timer. @public */
+declare class StartStopMsg {
+    /** Unique timer ID */
+    readonly id: number;
+    /** True to run, false to pause */
+    readonly running: boolean;
+    readonly _tag = "timer-start-stop";
+    constructor(
+    /** Unique timer ID */
+    id: number, 
+    /** True to run, false to pause */
+    running: boolean);
+}
+
+/** Options for creating a timer. @public */
+interface TimerOptions {
+    /** Milliseconds until the timer expires. */
+    timeout: number;
+    /** Tick interval in milliseconds (default: 1000). */
+    interval?: number;
+}
+/** Timer messages. @public */
+type TimerMsg = TickMsg | TimeoutMsg | StartStopMsg;
+/** Countdown timer model. @public */
+declare class TimerModel implements Model<TimerMsg, TimerModel> {
+    #private;
+    readonly timeout: number;
+    readonly interval: number;
+    private constructor();
+    /** Create a new timer with the given options. */
+    static new(options: TimerOptions): TimerModel;
+    /** Create a new timer with explicit timeout and interval. */
+    static withInterval(timeout: number, interval: number): TimerModel;
+    /** Unique ID for message routing. */
+    id(): number;
+    /** Whether the timer is currently running (false once timed out). */
+    running(): boolean;
+    /** Whether the timer has expired. */
+    timedOut(): boolean;
+    /** Start ticking. */
+    init(): Cmd<TimerMsg>;
+    /** Update the timer in response to a message. */
+    update(msg: Msg): [TimerModel, Cmd<TimerMsg>];
+    /** Render remaining time as a human-readable string. */
+    view(): string;
+    /** Command to start the timer. */
+    start(): Cmd<TimerMsg>;
+    /** Command to stop/pause the timer. */
+    stop(): Cmd<TimerMsg>;
+    /** Command to toggle running state. */
+    toggle(): Cmd<TimerMsg>;
+    private tick;
+    private startStop;
+}
+
+export { StartStopMsg, TickMsg, TimeoutMsg, TimerModel, type TimerMsg, type TimerOptions };

package/dist/index.js

@@ -0,0 +1,149 @@
+import { msg, batch, tick } from '@boba-cli/tea';
+
+// src/messages.ts
+var TickMsg = class {
+  constructor(id, tag, timeout) {
+    this.id = id;
+    this.tag = tag;
+    this.timeout = timeout;
+  }
+  _tag = "timer-tick";
+};
+var TimeoutMsg = class {
+  constructor(id) {
+    this.id = id;
+  }
+  _tag = "timer-timeout";
+};
+var StartStopMsg = class {
+  constructor(id, running) {
+    this.id = id;
+    this.running = running;
+  }
+  _tag = "timer-start-stop";
+};
+var lastId = 0;
+function nextId() {
+  return ++lastId;
+}
+var TimerModel = class _TimerModel {
+  timeout;
+  interval;
+  #id;
+  #tag;
+  #running;
+  constructor(options) {
+    this.timeout = options.timeout;
+    this.interval = options.interval;
+    this.#running = options.running;
+    this.#id = options.id;
+    this.#tag = options.tag;
+  }
+  /** Create a new timer with the given options. */
+  static new(options) {
+    const interval = options.interval ?? 1e3;
+    return new _TimerModel({
+      timeout: options.timeout,
+      interval,
+      running: true,
+      id: nextId(),
+      tag: 0
+    });
+  }
+  /** Create a new timer with explicit timeout and interval. */
+  static withInterval(timeout, interval) {
+    return _TimerModel.new({ timeout, interval });
+  }
+  /** Unique ID for message routing. */
+  id() {
+    return this.#id;
+  }
+  /** Whether the timer is currently running (false once timed out). */
+  running() {
+    if (this.timedOut()) {
+      return false;
+    }
+    return this.#running;
+  }
+  /** Whether the timer has expired. */
+  timedOut() {
+    return this.timeout <= 0;
+  }
+  /** Start ticking. */
+  init() {
+    return this.tick();
+  }
+  /** Update the timer in response to a message. */
+  update(msg$1) {
+    if (msg$1 instanceof StartStopMsg) {
+      if (msg$1.id !== 0 && msg$1.id !== this.#id) {
+        return [this, null];
+      }
+      const next = new _TimerModel({
+        timeout: this.timeout,
+        interval: this.interval,
+        running: msg$1.running,
+        id: this.#id,
+        tag: this.#tag
+      });
+      return [next, next.tick()];
+    }
+    if (msg$1 instanceof TickMsg) {
+      if (!this.running() || msg$1.id !== 0 && msg$1.id !== this.#id) {
+        return [this, null];
+      }
+      if (msg$1.tag > 0 && msg$1.tag !== this.#tag) {
+        return [this, null];
+      }
+      const nextTimeout = this.timeout - this.interval;
+      const nextTag = this.#tag + 1;
+      const next = new _TimerModel({
+        timeout: nextTimeout,
+        interval: this.interval,
+        running: this.#running,
+        id: this.#id,
+        tag: nextTag
+      });
+      const timeoutCmd = next.timedOut() ? msg(new TimeoutMsg(this.#id)) : null;
+      const tickCmd = next.timedOut() ? null : next.tick();
+      return [next, batch(tickCmd, timeoutCmd)];
+    }
+    return [this, null];
+  }
+  /** Render remaining time as a human-readable string. */
+  view() {
+    return formatDuration(Math.max(0, this.timeout));
+  }
+  /** Command to start the timer. */
+  start() {
+    return this.startStop(true);
+  }
+  /** Command to stop/pause the timer. */
+  stop() {
+    return this.startStop(false);
+  }
+  /** Command to toggle running state. */
+  toggle() {
+    return this.startStop(!this.running());
+  }
+  tick() {
+    const id = this.#id;
+    const tag = this.#tag;
+    return tick(this.interval, () => new TickMsg(id, tag, this.timedOut()));
+  }
+  startStop(running) {
+    return msg(new StartStopMsg(this.#id, running));
+  }
+};
+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 { StartStopMsg, TickMsg, TimeoutMsg, TimerModel };
+//# 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":["msg","lift"],"mappings":";;;AACO,IAAM,UAAN,MAAc;AAAA,EAGnB,WAAA,CAEkB,EAAA,EAEA,GAAA,EAEA,OAAA,EAChB;AALgB,IAAA,IAAA,CAAA,EAAA,GAAA,EAAA;AAEA,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AAEA,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAAA,EACf;AAAA,EATM,IAAA,GAAO,YAAA;AAUlB;AAGO,IAAM,aAAN,MAAiB;AAAA,EAGtB,YAA4B,EAAA,EAAY;AAAZ,IAAA,IAAA,CAAA,EAAA,GAAA,EAAA;AAAA,EAAa;AAAA,EAFhC,IAAA,GAAO,eAAA;AAGlB;AAGO,IAAM,eAAN,MAAmB;AAAA,EAGxB,WAAA,CAEkB,IAEA,OAAA,EAChB;AAHgB,IAAA,IAAA,CAAA,EAAA,GAAA,EAAA;AAEA,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAAA,EACf;AAAA,EAPM,IAAA,GAAO,kBAAA;AAQlB;ACpBA,IAAI,MAAA,GAAS,CAAA;AACb,SAAS,MAAA,GAAiB;AACxB,EAAA,OAAO,EAAE,MAAA;AACX;AAcO,IAAM,UAAA,GAAN,MAAM,WAAA,CAAqD;AAAA,EACvD,OAAA;AAAA,EACA,QAAA;AAAA,EACA,GAAA;AAAA,EACA,IAAA;AAAA,EACA,QAAA;AAAA,EAED,YAAY,OAAA,EAMjB;AACD,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,OAAA;AACvB,IAAA,IAAA,CAAK,WAAW,OAAA,CAAQ,QAAA;AACxB,IAAA,IAAA,CAAK,WAAW,OAAA,CAAQ,OAAA;AACxB,IAAA,IAAA,CAAK,MAAM,OAAA,CAAQ,EAAA;AACnB,IAAA,IAAA,CAAK,OAAO,OAAA,CAAQ,GAAA;AAAA,EACtB;AAAA;AAAA,EAGA,OAAO,IAAI,OAAA,EAAmC;AAC5C,IAAA,MAAM,QAAA,GAAW,QAAQ,QAAA,IAAY,GAAA;AACrC,IAAA,OAAO,IAAI,WAAA,CAAW;AAAA,MACpB,SAAS,OAAA,CAAQ,OAAA;AAAA,MACjB,QAAA;AAAA,MACA,OAAA,EAAS,IAAA;AAAA,MACT,IAAI,MAAA,EAAO;AAAA,MACX,GAAA,EAAK;AAAA,KACN,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,OAAO,YAAA,CAAa,OAAA,EAAiB,QAAA,EAA8B;AACjE,IAAA,OAAO,WAAA,CAAW,GAAA,CAAI,EAAE,OAAA,EAAS,UAAU,CAAA;AAAA,EAC7C;AAAA;AAAA,EAGA,EAAA,GAAa;AACX,IAAA,OAAO,IAAA,CAAK,GAAA;AAAA,EACd;AAAA;AAAA,EAGA,OAAA,GAAmB;AACjB,IAAA,IAAI,IAAA,CAAK,UAAS,EAAG;AACnB,MAAA,OAAO,KAAA;AAAA,IACT;AACA,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA;AAAA,EAGA,QAAA,GAAoB;AAClB,IAAA,OAAO,KAAK,OAAA,IAAW,CAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAA,GAAsB;AACpB,IAAA,OAAO,KAAK,IAAA,EAAK;AAAA,EACnB;AAAA;AAAA,EAGA,OAAOA,KAAA,EAA0C;AAC/C,IAAA,IAAIA,iBAAe,YAAA,EAAc;AAC/B,MAAA,IAAIA,MAAI,EAAA,KAAO,CAAA,IAAKA,KAAA,CAAI,EAAA,KAAO,KAAK,GAAA,EAAK;AACvC,QAAA,OAAO,CAAC,MAAM,IAAI,CAAA;AAAA,MACpB;AACA,MAAA,MAAM,IAAA,GAAO,IAAI,WAAA,CAAW;AAAA,QAC1B,SAAS,IAAA,CAAK,OAAA;AAAA,QACd,UAAU,IAAA,CAAK,QAAA;AAAA,QACf,SAASA,KAAA,CAAI,OAAA;AAAA,QACb,IAAI,IAAA,CAAK,GAAA;AAAA,QACT,KAAK,IAAA,CAAK;AAAA,OACX,CAAA;AACD,MAAA,OAAO,CAAC,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,CAAA;AAAA,IAC3B;AAEA,IAAA,IAAIA,iBAAe,OAAA,EAAS;AAC1B,MAAA,IAAI,CAAC,IAAA,CAAK,OAAA,EAAQ,IAAMA,KAAA,CAAI,OAAO,CAAA,IAAKA,KAAA,CAAI,EAAA,KAAO,IAAA,CAAK,GAAA,EAAM;AAC5D,QAAA,OAAO,CAAC,MAAM,IAAI,CAAA;AAAA,MACpB;AAEA,MAAA,IAAIA,MAAI,GAAA,GAAM,CAAA,IAAKA,KAAA,CAAI,GAAA,KAAQ,KAAK,IAAA,EAAM;AACxC,QAAA,OAAO,CAAC,MAAM,IAAI,CAAA;AAAA,MACpB;AAEA,MAAA,MAAM,WAAA,GAAc,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,QAAA;AACxC,MAAA,MAAM,OAAA,GAAU,KAAK,IAAA,GAAO,CAAA;AAE5B,MAAA,MAAM,IAAA,GAAO,IAAI,WAAA,CAAW;AAAA,QAC1B,OAAA,EAAS,WAAA;AAAA,QACT,UAAU,IAAA,CAAK,QAAA;AAAA,QACf,SAAS,IAAA,CAAK,QAAA;AAAA,QACd,IAAI,IAAA,CAAK,GAAA;AAAA,QACT,GAAA,EAAK;AAAA,OACN,CAAA;AAED,MAAA,MAAM,UAAA,GAAa,IAAA,CAAK,QAAA,EAAS,GAAIC,GAAA,CAAK,IAAI,UAAA,CAAW,IAAA,CAAK,GAAG,CAAC,CAAA,GAAI,IAAA;AACtE,MAAA,MAAM,UAAU,IAAA,CAAK,QAAA,EAAS,GAAI,IAAA,GAAO,KAAK,IAAA,EAAK;AAEnD,MAAA,OAAO,CAAC,IAAA,EAAM,KAAA,CAAM,OAAA,EAAS,UAAU,CAAC,CAAA;AAAA,IAC1C;AAEA,IAAA,OAAO,CAAC,MAAM,IAAI,CAAA;AAAA,EACpB;AAAA;AAAA,EAGA,IAAA,GAAe;AACb,IAAA,OAAO,eAAe,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,OAAO,CAAC,CAAA;AAAA,EACjD;AAAA;AAAA,EAGA,KAAA,GAAuB;AACrB,IAAA,OAAO,IAAA,CAAK,UAAU,IAAI,CAAA;AAAA,EAC5B;AAAA;AAAA,EAGA,IAAA,GAAsB;AACpB,IAAA,OAAO,IAAA,CAAK,UAAU,KAAK,CAAA;AAAA,EAC7B;AAAA;AAAA,EAGA,MAAA,GAAwB;AACtB,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,CAAC,IAAA,CAAK,SAAS,CAAA;AAAA,EACvC;AAAA,EAEQ,IAAA,GAAsB;AAC5B,IAAA,MAAM,KAAK,IAAA,CAAK,GAAA;AAChB,IAAA,MAAM,MAAM,IAAA,CAAK,IAAA;AACjB,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,QAAA,EAAU,MAAM,IAAI,OAAA,CAAQ,EAAA,EAAI,GAAA,EAAK,IAAA,CAAK,QAAA,EAAU,CAAC,CAAA;AAAA,EACxE;AAAA,EAEQ,UAAU,OAAA,EAAiC;AACjD,IAAA,OAAOA,IAAK,IAAI,YAAA,CAAa,IAAA,CAAK,GAAA,EAAK,OAAO,CAAC,CAAA;AAAA,EACjD;AACF;AAGA,SAAS,eAAe,EAAA,EAAoB;AAC1C,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAM,EAAA,GAAK,GAAI,CAAA,GAAI,EAAA;AACxC,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAM,EAAA,GAAK,GAAK,CAAA,GAAI,EAAA;AACzC,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,EAAA,GAAK,IAAO,CAAA;AAErC,EAAA,IAAI,KAAA,GAAQ,GAAG,OAAO,CAAA,EAAG,KAAK,CAAA,CAAA,EAAI,OAAO,IAAI,OAAO,CAAA,CAAA,CAAA;AACpD,EAAA,IAAI,UAAU,CAAA,EAAG,OAAO,CAAA,EAAG,OAAO,IAAI,OAAO,CAAA,CAAA,CAAA;AAC7C,EAAA,OAAO,GAAG,OAAO,CAAA,CAAA,CAAA;AACnB","file":"index.js","sourcesContent":["/** Tick message for timer countdown. @public */\nexport class TickMsg {\n  readonly _tag = 'timer-tick'\n\n  constructor(\n    /** Unique timer ID */\n    public readonly id: number,\n    /** Internal tag for deduplication */\n    public readonly tag: number,\n    /** Whether this tick indicates the timer expired */\n    public readonly timeout: boolean,\n  ) {}\n}\n\n/** Message emitted once when the timer times out. @public */\nexport class TimeoutMsg {\n  readonly _tag = 'timer-timeout'\n\n  constructor(public readonly id: number) {}\n}\n\n/** Message that starts or stops the timer. @public */\nexport class StartStopMsg {\n  readonly _tag = 'timer-start-stop'\n\n  constructor(\n    /** Unique timer ID */\n    public readonly id: number,\n    /** True to run, false to pause */\n    public readonly running: boolean,\n  ) {}\n}\n","import {\n  batch,\n  msg as lift,\n  tick,\n  type Cmd,\n  type Msg as TeaMsg,\n  type Model as TeaModel,\n} from '@boba-cli/tea'\nimport { StartStopMsg, TickMsg, TimeoutMsg } from './messages.js'\n\n// Module-level ID counter for unique timers\nlet lastId = 0\nfunction nextId(): number {\n  return ++lastId\n}\n\n/** Options for creating a timer. @public */\nexport interface TimerOptions {\n  /** Milliseconds until the timer expires. */\n  timeout: number\n  /** Tick interval in milliseconds (default: 1000). */\n  interval?: number\n}\n\n/** Timer messages. @public */\nexport type TimerMsg = TickMsg | TimeoutMsg | StartStopMsg\n\n/** Countdown timer model. @public */\nexport class TimerModel implements TeaModel<TimerMsg, TimerModel> {\n  readonly timeout: number\n  readonly interval: number\n  readonly #id: number\n  readonly #tag: number\n  readonly #running: boolean\n\n  private constructor(options: {\n    timeout: number\n    interval: number\n    running: boolean\n    id: number\n    tag: number\n  }) {\n    this.timeout = options.timeout\n    this.interval = options.interval\n    this.#running = options.running\n    this.#id = options.id\n    this.#tag = options.tag\n  }\n\n  /** Create a new timer with the given options. */\n  static new(options: TimerOptions): TimerModel {\n    const interval = options.interval ?? 1000\n    return new TimerModel({\n      timeout: options.timeout,\n      interval,\n      running: true,\n      id: nextId(),\n      tag: 0,\n    })\n  }\n\n  /** Create a new timer with explicit timeout and interval. */\n  static withInterval(timeout: number, interval: number): TimerModel {\n    return TimerModel.new({ timeout, interval })\n  }\n\n  /** Unique ID for message routing. */\n  id(): number {\n    return this.#id\n  }\n\n  /** Whether the timer is currently running (false once timed out). */\n  running(): boolean {\n    if (this.timedOut()) {\n      return false\n    }\n    return this.#running\n  }\n\n  /** Whether the timer has expired. */\n  timedOut(): boolean {\n    return this.timeout <= 0\n  }\n\n  /** Start ticking. */\n  init(): Cmd<TimerMsg> {\n    return this.tick()\n  }\n\n  /** Update the timer in response to a message. */\n  update(msg: TeaMsg): [TimerModel, Cmd<TimerMsg>] {\n    if (msg instanceof StartStopMsg) {\n      if (msg.id !== 0 && msg.id !== this.#id) {\n        return [this, null]\n      }\n      const next = new TimerModel({\n        timeout: this.timeout,\n        interval: this.interval,\n        running: msg.running,\n        id: this.#id,\n        tag: this.#tag,\n      })\n      return [next, next.tick()]\n    }\n\n    if (msg instanceof TickMsg) {\n      if (!this.running() || (msg.id !== 0 && msg.id !== this.#id)) {\n        return [this, null]\n      }\n\n      if (msg.tag > 0 && msg.tag !== this.#tag) {\n        return [this, null]\n      }\n\n      const nextTimeout = this.timeout - this.interval\n      const nextTag = this.#tag + 1\n\n      const next = new TimerModel({\n        timeout: nextTimeout,\n        interval: this.interval,\n        running: this.#running,\n        id: this.#id,\n        tag: nextTag,\n      })\n\n      const timeoutCmd = next.timedOut() ? lift(new TimeoutMsg(this.#id)) : null\n      const tickCmd = next.timedOut() ? null : next.tick()\n\n      return [next, batch(tickCmd, timeoutCmd)]\n    }\n\n    return [this, null]\n  }\n\n  /** Render remaining time as a human-readable string. */\n  view(): string {\n    return formatDuration(Math.max(0, this.timeout))\n  }\n\n  /** Command to start the timer. */\n  start(): Cmd<TimerMsg> {\n    return this.startStop(true)\n  }\n\n  /** Command to stop/pause the timer. */\n  stop(): Cmd<TimerMsg> {\n    return this.startStop(false)\n  }\n\n  /** Command to toggle running state. */\n  toggle(): Cmd<TimerMsg> {\n    return this.startStop(!this.running())\n  }\n\n  private tick(): Cmd<TimerMsg> {\n    const id = this.#id\n    const tag = this.#tag\n    return tick(this.interval, () => new TickMsg(id, tag, this.timedOut()))\n  }\n\n  private startStop(running: boolean): Cmd<TimerMsg> {\n    return lift(new StartStopMsg(this.#id, running))\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/timer",
+  "description": "Countdown timer 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"
+  }
+}