xonecas.io
70160
Ce

cel-tui / files

cel-tui / packages / components / src / spinner.test.ts

3.6 KB
1import { afterEach, describe, expect, jest, test } from "bun:test";
2import { visibleWidth } from "@cel-tui/core";
3import { Spinner } from "./spinner.js";
4
5describe("Spinner", () => {
6  afterEach(() => {
7    jest.useRealTimers();
8  });
9
10  test("renders the first frame with Text styling", () => {
11    const spinner = Spinner({
12      frames: ["a", "b"],
13      fgColor: "color06",
14      bold: true,
15    });
16
17    expect(spinner()).toEqual({
18      type: "text",
19      content: "a",
20      props: { fgColor: "color06", bold: true },
21    });
22    spinner.dispose();
23  });
24
25  test("supports per-render style overrides and exposes current content", () => {
26    const spinner = Spinner({ frames: ["x"], fgColor: "color06" });
27
28    expect(spinner.current).toBe("x");
29    expect(spinner({ fgColor: "color02", italic: true }).props).toEqual({
30      fgColor: "color02",
31      italic: true,
32    });
33    spinner.dispose();
34  });
35
36  test("advances only while running", () => {
37    jest.useFakeTimers();
38    jest.setSystemTime(new Date(0));
39    const spinner = Spinner({
40      frames: ["a", "b", "c"],
41      maxFps: 10,
42      requestRender: () => {},
43    });
44
45    jest.advanceTimersByTime(500);
46    expect(spinner().content).toBe("a");
47
48    spinner.start();
49    jest.advanceTimersByTime(100);
50    expect(spinner().content).toBe("b");
51    expect(spinner.frame).toBe(1);
52
53    spinner.stop();
54    jest.advanceTimersByTime(500);
55    expect(spinner().content).toBe("b");
56    spinner.dispose();
57  });
58
59  test("supports explicitly requested auto-start and reset", () => {
60    jest.useFakeTimers();
61    jest.setSystemTime(new Date(0));
62    let renders = 0;
63    const spinner = Spinner({
64      frames: ["0", "1", "2"],
65      maxFps: 5,
66      autoStart: true,
67      requestRender: () => renders++,
68    });
69
70    expect(spinner.running).toBe(true);
71    jest.advanceTimersByTime(400);
72    expect(spinner().content).toBe("2");
73
74    spinner.reset();
75    expect(spinner().content).toBe("0");
76    expect(renders).toBe(3);
77    spinner.dispose();
78  });
79
80  test("dispose cancels animation permanently", () => {
81    jest.useFakeTimers();
82    jest.setSystemTime(new Date(0));
83    const spinner = Spinner({
84      frames: ["a", "b"],
85      maxFps: 10,
86      requestRender: () => {},
87    });
88    spinner.start();
89
90    spinner.dispose();
91
92    expect(spinner.disposed).toBe(true);
93    expect(spinner.running).toBe(false);
94    expect(jest.getTimerCount()).toBe(0);
95    expect(() => spinner.start()).toThrow("disposed");
96  });
97
98  test("pads frames to a stable terminal width by default", () => {
99    jest.useFakeTimers();
100    jest.setSystemTime(new Date(0));
101    const spinner = Spinner({
102      frames: ["·", "界", "go"],
103      maxFps: 10,
104      requestRender: () => {},
105    });
106
107    const widths = [visibleWidth(spinner().content)];
108    spinner.start();
109    jest.advanceTimersByTime(100);
110    widths.push(visibleWidth(spinner().content));
111    jest.advanceTimersByTime(100);
112    widths.push(visibleWidth(spinner().content));
113
114    expect(widths).toEqual([2, 2, 2]);
115    spinner.dispose();
116  });
117
118  test("can preserve frames verbatim when padding is disabled", () => {
119    jest.useFakeTimers();
120    jest.setSystemTime(new Date(0));
121    const spinner = Spinner({
122      frames: [".", "wide"],
123      maxFps: 10,
124      padFrames: false,
125      requestRender: () => {},
126    });
127
128    expect(spinner().content).toBe(".");
129    spinner.start();
130    jest.advanceTimersByTime(100);
131    expect(spinner().content).toBe("wide");
132    spinner.dispose();
133  });
134
135  test("validates custom frames", () => {
136    expect(() => Spinner({ frames: [] })).toThrow("frame");
137    expect(() => Spinner({ frames: [""] })).toThrow("frame");
138  });
139});