@shoru/spindle 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aymane Shoru
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,239 @@
+<div align="center">
+
+# Spindle
+
+A lightweight, singleton-based CLI multi-spinner library for Node.js. Run multiple spinners simultaneously without visual corruption, with automatic console interception.
+
+[![Node.js](https://img.shields.io/badge/Node.js-18+-339933?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org/)
+[![Downloads](https://img.shields.io/npm/d18m/@shoru/spindle.svg?style=for-the-badge)](https://www.npmjs.com/package/@shoru/spindle)
+[![npm](https://img.shields.io/npm/v/@shoru/spindle.svg?style=for-the-badge)](https://www.npmjs.com/package/@shoru/spindle)
+[![Types](https://img.shields.io/badge/types-included-blue?style=for-the-badge&logo=typescript)](https://github.com/Mangaka-bot/spindle/tree/main/src)
+
+[Installation](#-installation) · [Quick Start](#-quick-start) · [API](#-api)
+
+</div>
+
+---
+
+## ✨ Features
+
+- 🔄 **Multiple Concurrent Spinners** - Run as many spinners as you need
+- 🎨 **Customizable Colors** - 17 color options for spinner customization
+- 📝 **Console Interception** - `console.log` and friends work seamlessly without breaking spinners
+- ✨ **Final States** - Complete spinners with success, failure, warning, or info icons
+- 🧹 **Automatic Cleanup** - Graceful handling of process exit, SIGINT, and SIGTERM
+- 📦 **Singleton Architecture** - Centralized render management for flicker-free output
+
+## Installation
+
+```bash
+npm install @shoru/spindle
+```
+
+</div>
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @shoru/spindle
+```
+
+> Requires Node.js 18+
+
+---
+
+## Quick Start
+
+```javascript
+import { spindle } from '@shoru/spindle';
+
+const spinner = spindle('Loading...').start();
+
+// Do some async work
+await someAsyncTask();
+
+spinner.succeed('Done!');
+```
+
+## API
+
+### Creating a Spindle
+
+```javascript
+import { spindle, Spindle } from '@shoru/spindle';
+
+// Using factory function (recommended)
+const spinner = spindle('Initial text');
+
+// Using constructor
+const spinner = new Spindle('Initial text');
+```
+
+### Methods
+
+#### `.start(text?)`
+
+Starts the spinner. Optionally updates the text.
+
+```javascript
+spinner.start();
+spinner.start('New loading message...');
+```
+
+#### `.stop()`
+
+Stops the spinner without displaying a final message.
+
+```javascript
+spinner.stop();
+```
+
+#### `.succeed(text?)`
+
+Stops with a green checkmark (✔).
+
+```javascript
+spinner.succeed('Task completed successfully');
+```
+
+#### `.fail(text?)`
+
+Stops with a red cross (✖).
+
+```javascript
+spinner.fail('Task failed');
+```
+
+#### `.warn(text?)`
+
+Stops with a yellow warning sign (⚠).
+
+```javascript
+spinner.warn('Task completed with warnings');
+```
+
+#### `.info(text?)`
+
+Stops with a blue info icon (ℹ).
+
+```javascript
+spinner.info('Additional information');
+```
+
+### Properties
+
+#### `.text` / `.title`
+
+Get or set the spinner text. Both properties are interchangeable.
+
+```javascript
+spinner.text = 'Downloading files...';
+console.log(spinner.text); // 'Downloading files...'
+```
+
+#### `.color`
+
+Get or set the spinner color.
+
+```javascript
+spinner.color = 'magenta';
+```
+
+#### `.isSpinning`
+
+Check if the spinner is currently active.
+
+```javascript
+if (spinner.isSpinning) {
+  spinner.succeed('Finished');
+}
+```
+
+### Available Colors
+
+| Standard | Bright |
+|----------|--------|
+| `black` | `gray`/`grey` |
+| `red` | `redBright` |
+| `green` | `greenBright` |
+| `yellow` | `yellowBright` |
+| `blue` | `blueBright` |
+| `magenta` | `magentaBright` |
+| `cyan` | `cyanBright` |
+| `white` | `whiteBright` |
+
+> Default: `cyan`
+
+### RendererManager
+
+The `RendererManager` singleton coordinates all active spinners. You typically don't need to interact with it directly, but it's available for advanced use cases.
+
+```javascript
+import { RendererManager } from '@shoru/spindle';
+
+// Check if any spinners are active
+if (RendererManager.isActive()) {
+  console.log('Spinners are running');
+}
+
+// Get count of active spinners
+const count = RendererManager.getActiveCount();
+
+// Force reset all spinners (use with caution)
+RendererManager.reset(true);
+```
+
+## TypeScript Support
+
+Full TypeScript support with exported types:
+
+```typescript
+import { 
+  Spindle, 
+  spindle, 
+  SpinnerColor, 
+  FinalState, 
+  TaskState,
+  Renderable 
+} from '@shoru/spindle';
+
+const color: SpinnerColor = 'cyan';
+const state: FinalState = 'completed';
+```
+
+## How It Works
+
+1. **Singleton Renderer**: A single `RendererManager` coordinates all spinner instances
+2. **Console Interception**: When spinners are active, console methods are intercepted and buffered
+3. **Unified Rendering**: All spinners render to a single output using `log-update`
+4. **Clean Output**: Buffered logs are flushed above the spinner display
+5. **Graceful Cleanup**: Process signals trigger proper cleanup to restore console state
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create feature branch `git checkout -b feature/amazing-feature`
+3. Commit changes `git commit -m 'Add amazing feature'`
+4. Push `git push origin feature/amazing-feature`
+5. Open Pull Request
+
+---
+
+<div align="center">
+
+[![License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](LICENSE)
+<br>
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.
+
+<br>
+
+**Made with ❤️ for the Node.js CLI community**
+
+[⬆ Back to Top](#-spindle)
+</div>

package/dist/constants.d.ts

@@ -0,0 +1,7 @@
+import type { SpinnerColor, StateConfig, FinalState } from './types.js';
+export declare const SPINNER_FRAMES: readonly ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+export declare const SPINNER_INTERVAL: 80;
+export declare const DEFAULT_COLOR: SpinnerColor;
+export declare const VALID_COLORS: ReadonlySet<string>;
+export declare const STATE_CONFIG: Readonly<Record<FinalState | 'default', StateConfig>>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExE,eAAO,MAAM,cAAc,6DAEjB,CAAC;AAEX,eAAO,MAAM,gBAAgB,EAAG,EAAW,CAAC;AAC5C,eAAO,MAAM,aAAa,EAAE,YAAqB,CAAC;AAElD,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAI3C,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,GAAG,SAAS,EAAE,WAAW,CAAC,CAM9E,CAAC"}

package/dist/constants.js

@@ -0,0 +1,18 @@
+export const SPINNER_FRAMES = [
+    '⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'
+];
+export const SPINNER_INTERVAL = 80;
+export const DEFAULT_COLOR = 'cyan';
+export const VALID_COLORS = new Set([
+    'black', 'red', 'green', 'yellow', 'blue', 'magenta', 'cyan', 'white',
+    'gray', 'grey', 'redBright', 'greenBright', 'yellowBright', 'blueBright',
+    'magentaBright', 'cyanBright', 'whiteBright'
+]);
+export const STATE_CONFIG = {
+    completed: { icon: '✔', iconColor: 'green', textColor: 'white' },
+    failed: { icon: '✖', iconColor: 'red', textColor: 'red' },
+    warning: { icon: '⚠', iconColor: 'yellow', textColor: 'yellow' },
+    info: { icon: 'ℹ', iconColor: 'blue', textColor: 'blue' },
+    default: { icon: '○', iconColor: 'gray', textColor: 'white' }
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CACxC,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAW,CAAC;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAiB,MAAM,CAAC;AAElD,MAAM,CAAC,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAe;IACrE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO;IACrE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY;IACxE,eAAe,EAAE,YAAY,EAAE,aAAa;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAA0D;IACjF,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAG,SAAS,EAAE,OAAO,EAAG;IAClE,MAAM,EAAK,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAK,SAAS,EAAE,KAAK,EAAK;IAClE,OAAO,EAAI,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;IAClE,IAAI,EAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAI,SAAS,EAAE,MAAM,EAAI;IAClE,OAAO,EAAI,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAI,SAAS,EAAE,OAAO,EAAG;CACnE,CAAC"}

package/dist/helpers.d.ts

@@ -0,0 +1,6 @@
+import type { SpinnerColor, FinalState, StateFormatters } from './types.js';
+type ChalkFn = (text: string) => string;
+export declare const getChalkColor: (color: SpinnerColor) => ChalkFn;
+export declare const getStateFormatters: (state: FinalState) => StateFormatters;
+export {};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5E,KAAK,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAKxC,eAAO,MAAM,aAAa,GAAI,OAAO,YAAY,KAAG,OACS,CAAC;AAE9D,eAAO,MAAM,kBAAkB,GAAI,OAAO,UAAU,KAAG,eAStD,CAAC"}

package/dist/helpers.js

@@ -0,0 +1,14 @@
+import chalk from 'chalk';
+import { VALID_COLORS, DEFAULT_COLOR, STATE_CONFIG } from './constants.js';
+const getColorFn = (color) => chalk[color];
+export const getChalkColor = (color) => getColorFn(VALID_COLORS.has(color) ? color : DEFAULT_COLOR);
+export const getStateFormatters = (state) => {
+    const config = STATE_CONFIG[state] ?? STATE_CONFIG.default;
+    const iconFn = getColorFn(config.iconColor);
+    const textFn = getColorFn(config.textColor);
+    return {
+        icon: iconFn(config.icon),
+        text: textFn
+    };
+};
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK3E,MAAM,UAAU,GAAG,CAAC,KAAmB,EAAW,EAAE,CAClD,KAAK,CAAC,KAAK,CAAY,CAAC;AAE1B,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAmB,EAAW,EAAE,CAC5D,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAiB,EAAmB,EAAE;IACvE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,EAAE,MAAM;KACb,CAAC;AACJ,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import type { SpinnerColor, Renderable } from './types.js';
+export type { SpinnerColor, FinalState, TaskState, TaskConfig, Renderable } from './types.js';
+export { RendererManager } from './renderer-manager.js';
+export declare class Spindle implements Renderable {
+    #private;
+    constructor(text?: string);
+    start(text?: string): this;
+    stop(): this;
+    succeed(text?: string): this;
+    fail(text?: string): this;
+    warn(text?: string): this;
+    info(text?: string): this;
+    get text(): string;
+    set text(value: string);
+    get title(): string;
+    set title(value: string);
+    get color(): SpinnerColor;
+    set color(value: SpinnerColor);
+    get isSpinning(): boolean;
+    renderToString(): string;
+}
+export declare function spindle(text?: string): Spindle;
+export default Spindle;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAc,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,qBAAa,OAAQ,YAAW,UAAU;;gBAO5B,IAAI,SAAK;IAIrB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAW1B,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IACzB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IACzB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IA0BzB,IAAI,IAAI,IAAI,MAAM,CAAuB;IACzC,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,EAGrB;IAED,IAAI,KAAK,IAAI,MAAM,CAAuB;IAC1C,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAAwB;IAE/C,IAAI,KAAK,IAAI,YAAY,CAAwB;IACjD,IAAI,KAAK,CAAC,KAAK,EAAE,YAAY,EAG5B;IAED,IAAI,UAAU,IAAI,OAAO,CAA2B;IAEpD,cAAc,IAAI,MAAM;CAMzB;AAED,wBAAgB,OAAO,CAAC,IAAI,SAAK,GAAG,OAAO,CAE1C;AAED,eAAe,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,80 @@
+import chalk from 'chalk';
+import { RendererManager } from './renderer-manager.js';
+import { getChalkColor, getStateFormatters } from './helpers.js';
+export { RendererManager } from './renderer-manager.js';
+export class Spindle {
+    #text;
+    #color = 'cyan';
+    #isActive = false;
+    #finalState = null;
+    #manager = null;
+    constructor(text = '') {
+        this.#text = text;
+    }
+    start(text) {
+        if (text !== undefined)
+            this.#text = text;
+        if (this.#isActive)
+            return this;
+        this.#isActive = true;
+        this.#finalState = null;
+        this.#manager = RendererManager.getInstance();
+        this.#manager.register(this);
+        return this;
+    }
+    stop() {
+        if (!this.#isActive)
+            return this;
+        this.#isActive = false;
+        this.#manager?.unregister(this);
+        this.#manager = null;
+        return this;
+    }
+    succeed(text) { return this.#complete('completed', text); }
+    fail(text) { return this.#complete('failed', text); }
+    warn(text) { return this.#complete('warning', text); }
+    info(text) { return this.#complete('info', text); }
+    #complete(state, text) {
+        this.#finalState = state;
+        const finalText = text ?? this.#text;
+        const { icon, text: colorText } = getStateFormatters(state);
+        const line = `${icon} ${colorText(finalText)}`;
+        if (!this.#isActive) {
+            console.log(line);
+            return this;
+        }
+        this.#isActive = false;
+        this.#manager?.scheduleRender();
+        setImmediate(() => {
+            console.log(line);
+            this.#manager?.unregister(this);
+            this.#manager = null;
+            this.#finalState = null;
+        });
+        return this;
+    }
+    get text() { return this.#text; }
+    set text(value) {
+        this.#text = value;
+        this.#manager?.scheduleRender();
+    }
+    get title() { return this.#text; }
+    set title(value) { this.text = value; }
+    get color() { return this.#color; }
+    set color(value) {
+        this.#color = value;
+        this.#manager?.scheduleRender();
+    }
+    get isSpinning() { return this.#isActive; }
+    renderToString() {
+        if (this.#finalState)
+            return '';
+        const frame = RendererManager.getInstance().getSpinnerFrame();
+        return `${getChalkColor(this.#color)(frame)} ${chalk.white(this.#text)}`;
+    }
+}
+export function spindle(text = '') {
+    return new Spindle(text);
+}
+export default Spindle;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAIjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,OAAO,OAAO;IAClB,KAAK,CAAS;IACd,MAAM,GAAiB,MAAM,CAAC;IAC9B,SAAS,GAAG,KAAK,CAAC;IAClB,WAAW,GAAsB,IAAI,CAAC;IACtC,QAAQ,GAA2B,IAAI,CAAC;IAExC,YAAY,IAAI,GAAG,EAAE;QACnB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,IAAa;QACjB,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAC1C,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAEhC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAEjC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,IAAa,IAAU,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1E,IAAI,CAAC,IAAa,IAAU,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC,IAAa,IAAU,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,IAAa,IAAU,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAElE,SAAS,CAAC,KAAiB,EAAE,IAAa;QACxC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC;QACrC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QAE/C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC;QAEhC,YAAY,CAAC,GAAG,EAAE;YAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,KAAK,KAAa,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,KAAa,IAAI,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;IAE/C,IAAI,KAAK,KAAmB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,KAAmB;QAC3B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,UAAU,KAAc,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAEpD,cAAc;QACZ,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,EAAE,CAAC;QAEhC,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC,eAAe,EAAE,CAAC;QAC9D,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAC3E,CAAC;CACF;AAED,MAAM,UAAU,OAAO,CAAC,IAAI,GAAG,EAAE;IAC/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,eAAe,OAAO,CAAC"}

package/dist/renderer-manager.d.ts

@@ -0,0 +1,16 @@
+import type { Renderable } from './types.js';
+export declare class RendererManager {
+    #private;
+    private constructor();
+    static getInstance(): RendererManager;
+    static isActive(): boolean;
+    static getActiveCount(): number;
+    static reset(force?: boolean): void;
+    get isDisposed(): boolean;
+    getSpinnerFrame(): string;
+    register(renderer: Renderable): void;
+    unregister(renderer: Renderable): void;
+    scheduleRender(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=renderer-manager.d.ts.map

package/dist/renderer-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-manager.d.ts","sourceRoot":"","sources":["../src/renderer-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAuC,MAAM,YAAY,CAAC;AAclF,qBAAa,eAAe;;IAe1B,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,eAAe;IASrC,MAAM,CAAC,QAAQ,IAAI,OAAO;IAK1B,MAAM,CAAC,cAAc,IAAI,MAAM;IAK/B,MAAM,CAAC,KAAK,CAAC,KAAK,UAAQ,GAAG,IAAI;IAejC,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,eAAe,IAAI,MAAM;IAKzB,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;IAUpC,UAAU,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;IAYtC,cAAc,IAAI,IAAI;IAWtB,OAAO,IAAI,IAAI;CA4KhB"}

package/dist/renderer-manager.js

@@ -0,0 +1,252 @@
+import logUpdate from 'log-update';
+import { SPINNER_FRAMES, SPINNER_INTERVAL } from './constants.js';
+const CONSOLE_METHODS = {
+    log: 'stdout', info: 'stdout', debug: 'stdout', warn: 'stderr', error: 'stderr'
+};
+const CONSOLE_METHOD_KEYS = Object.keys(CONSOLE_METHODS);
+// Default frame as fallback (satisfies noUncheckedIndexedAccess)
+const DEFAULT_FRAME = '⠋';
+export class RendererManager {
+    static #instance = null;
+    #activeRenderers = new Set();
+    #originalConsole = {};
+    #originalStdoutWrite = null;
+    #originalStderrWrite = null;
+    #logBuffer = [];
+    #isInternalWrite = false;
+    #intercepted = false;
+    #renderScheduled = false;
+    #spinnerIndex = 0;
+    #spinnerInterval = null;
+    #isDisposed = false;
+    constructor() { }
+    static getInstance() {
+        let inst = RendererManager.#instance;
+        if (!inst || inst.#isDisposed) {
+            inst = new RendererManager();
+            RendererManager.#instance = inst;
+        }
+        return inst;
+    }
+    static isActive() {
+        const inst = RendererManager.#instance;
+        return Boolean(inst && !inst.#isDisposed && inst.#activeRenderers.size);
+    }
+    static getActiveCount() {
+        const inst = RendererManager.#instance;
+        return inst && !inst.#isDisposed ? inst.#activeRenderers.size : 0;
+    }
+    static reset(force = false) {
+        const inst = RendererManager.#instance;
+        if (!inst)
+            return;
+        if (!force && inst.#activeRenderers.size > 0) {
+            console.warn(`RendererManager: ${inst.#activeRenderers.size} active renderers. Use reset(true) to force.`);
+            return;
+        }
+        inst.dispose();
+        RendererManager.#instance = null;
+    }
+    get isDisposed() {
+        return this.#isDisposed;
+    }
+    getSpinnerFrame() {
+        // FIX 1: Provide fallback for noUncheckedIndexedAccess
+        return SPINNER_FRAMES[this.#spinnerIndex] ?? DEFAULT_FRAME;
+    }
+    register(renderer) {
+        if (this.#isDisposed)
+            throw new Error('RendererManager disposed');
+        const wasEmpty = this.#activeRenderers.size === 0;
+        this.#activeRenderers.add(renderer);
+        if (wasEmpty)
+            this.#startManaging();
+        this.scheduleRender();
+    }
+    unregister(renderer) {
+        if (this.#isDisposed)
+            return;
+        this.#activeRenderers.delete(renderer);
+        if (this.#activeRenderers.size === 0) {
+            this.#stopManaging();
+        }
+        else {
+            this.scheduleRender();
+        }
+    }
+    scheduleRender() {
+        if (this.#isDisposed || this.#renderScheduled || !this.#activeRenderers.size)
+            return;
+        this.#renderScheduled = true;
+        setImmediate(() => {
+            if (this.#isDisposed)
+                return;
+            this.#renderScheduled = false;
+            this.#render();
+        });
+    }
+    dispose() {
+        if (this.#isDisposed)
+            return;
+        this.#isDisposed = true;
+        this.#stopManaging();
+        this.#activeRenderers.clear();
+        this.#logBuffer.length = 0;
+    }
+    #startManaging() {
+        if (this.#intercepted || this.#isDisposed)
+            return;
+        this.#interceptConsole();
+        this.#interceptStreams();
+        this.#intercepted = true;
+        this.#spinnerInterval = setInterval(() => {
+            if (this.#isDisposed)
+                return this.#stopManaging();
+            this.#spinnerIndex = (this.#spinnerIndex + 1) % SPINNER_FRAMES.length;
+            this.#render();
+        }, SPINNER_INTERVAL);
+        this.#spinnerInterval.unref?.();
+    }
+    #stopManaging() {
+        this.#flushLogBuffer();
+        if (this.#spinnerInterval) {
+            clearInterval(this.#spinnerInterval);
+            this.#spinnerInterval = null;
+        }
+        if (this.#intercepted) {
+            this.#restoreConsole();
+            this.#restoreStreams();
+            this.#intercepted = false;
+            try {
+                logUpdate.done();
+            }
+            catch { /* noop */ }
+        }
+        this.#spinnerIndex = 0;
+    }
+    #render() {
+        if (this.#isDisposed || !this.#activeRenderers.size)
+            return;
+        this.#flushLogBuffer();
+        const outputs = [];
+        for (const renderer of this.#activeRenderers) {
+            try {
+                const output = renderer.renderToString();
+                if (output)
+                    outputs.push(output);
+            }
+            catch { /* noop */ }
+        }
+        if (outputs.length) {
+            this.#internalWrite(() => logUpdate(outputs.join('\n\n')));
+        }
+    }
+    #interceptConsole() {
+        for (const method of CONSOLE_METHOD_KEYS) {
+            const stream = CONSOLE_METHODS[method];
+            this.#originalConsole[method] = console[method].bind(console);
+            console[method] = (...args) => {
+                if (this.#isDisposed) {
+                    this.#originalConsole[method]?.(...args);
+                    return;
+                }
+                this.#logBuffer.push({ method, args, stream });
+                this.scheduleRender();
+            };
+        }
+    }
+    #interceptStreams() {
+        this.#originalStdoutWrite = process.stdout.write.bind(process.stdout);
+        this.#originalStderrWrite = process.stderr.write.bind(process.stderr);
+        const createInterceptor = (stream, original) => {
+            return ((chunk, encodingOrCb, callback) => {
+                if (this.#isInternalWrite || this.#isDisposed) {
+                    return original.call(stream === 'stdout' ? process.stdout : process.stderr, chunk, encodingOrCb, callback);
+                }
+                const encoding = typeof encodingOrCb === 'string' ? encodingOrCb : 'utf8';
+                const cb = typeof encodingOrCb === 'function' ? encodingOrCb : callback;
+                // FIX 2: Uint8Array.toString() takes no arguments
+                // Use Buffer.from() or TextDecoder for proper encoding support
+                let str;
+                if (typeof chunk === 'string') {
+                    str = chunk;
+                }
+                else {
+                    // Convert Uint8Array to string with proper encoding
+                    str = Buffer.from(chunk).toString(encoding);
+                }
+                if (str.trim()) {
+                    this.#logBuffer.push({ method: 'raw', args: [str], stream });
+                    this.scheduleRender();
+                }
+                cb?.();
+                return true;
+            });
+        };
+        process.stdout.write = createInterceptor('stdout', this.#originalStdoutWrite);
+        process.stderr.write = createInterceptor('stderr', this.#originalStderrWrite);
+    }
+    #restoreConsole() {
+        for (const method of CONSOLE_METHOD_KEYS) {
+            const fn = this.#originalConsole[method];
+            if (fn)
+                console[method] = fn;
+        }
+        this.#originalConsole = {};
+    }
+    #restoreStreams() {
+        if (this.#originalStdoutWrite)
+            process.stdout.write = this.#originalStdoutWrite;
+        if (this.#originalStderrWrite)
+            process.stderr.write = this.#originalStderrWrite;
+        this.#originalStdoutWrite = null;
+        this.#originalStderrWrite = null;
+    }
+    #flushLogBuffer() {
+        if (!this.#logBuffer.length)
+            return;
+        const buffer = this.#logBuffer.splice(0);
+        this.#internalWrite(() => { try {
+            logUpdate.clear();
+        }
+        catch { /* noop */ } });
+        for (const { method, args, stream } of buffer) {
+            this.#internalWrite(() => {
+                try {
+                    if (method === 'raw') {
+                        const writer = stream === 'stderr'
+                            ? this.#originalStderrWrite
+                            : this.#originalStdoutWrite;
+                        // Safe access with type guard
+                        const text = args[0];
+                        if (writer && typeof text === 'string') {
+                            const output = text.endsWith('\n') ? text : `${text}\n`;
+                            writer.call(stream === 'stderr' ? process.stderr : process.stdout, output);
+                        }
+                    }
+                    else {
+                        this.#originalConsole[method]?.(...args);
+                    }
+                }
+                catch { /* noop */ }
+            });
+        }
+    }
+    #internalWrite(fn) {
+        this.#isInternalWrite = true;
+        try {
+            fn();
+        }
+        finally {
+            this.#isInternalWrite = false;
+        }
+    }
+}
+// Process cleanup handlers
+if (typeof process !== 'undefined') {
+    const cleanup = () => RendererManager.reset(true);
+    process.once('exit', cleanup);
+    process.once('SIGINT', () => { cleanup(); process.exit(130); });
+    process.once('SIGTERM', () => { cleanup(); process.exit(143); });
+}
+//# sourceMappingURL=renderer-manager.js.map

package/dist/renderer-manager.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+export type SpinnerColor = 'black' | 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan' | 'white' | 'gray' | 'grey' | 'redBright' | 'greenBright' | 'yellowBright' | 'blueBright' | 'magentaBright' | 'cyanBright' | 'whiteBright';
+export type FinalState = 'completed' | 'failed' | 'warning' | 'info';
+export type TaskState = 'pending' | 'processing' | 'skipped' | FinalState;
+export type ExecutionType = 'initial' | 'auto' | 'retry';
+export type ConsoleMethod = 'log' | 'info' | 'debug' | 'warn' | 'error';
+export type StreamType = 'stdout' | 'stderr';
+export interface StateConfig {
+    readonly icon: string;
+    readonly iconColor: SpinnerColor;
+    readonly textColor: SpinnerColor;
+}
+export interface StateFormatters {
+    readonly icon: string;
+    readonly text: (t: string) => string;
+}
+export interface Renderable {
+    renderToString(): string;
+}
+export interface LogEntry {
+    readonly method: ConsoleMethod | 'raw';
+    readonly args: readonly unknown[];
+    readonly stream: StreamType;
+}
+export interface TaskNode {
+    title: string;
+    state: TaskState;
+}
+export interface RetryConfig {
+    readonly tries: number;
+    readonly delay?: number;
+}
+export interface RendererOptions {
+    readonly renderer?: 'default' | 'simple' | 'silent';
+}
+export interface TaskOptions {
+    readonly concurrent?: boolean;
+    readonly exitOnError?: boolean;
+}
+export interface TaskConfig {
+    readonly title: string;
+    readonly setup?: (ctx: Record<string, unknown>, task: TaskNode) => Promise<unknown>;
+    readonly task?: (ctx: Record<string, unknown>, task: TaskNode, type: ExecutionType) => Promise<unknown>;
+    readonly afterEach?: (ctx: Record<string, unknown>, completedSubtask: TaskNode, mainTask: TaskNode) => Promise<void>;
+    readonly finally?: (ctx: Record<string, unknown>, task: TaskNode) => Promise<void>;
+    readonly options?: TaskOptions;
+    readonly autoExecute?: number;
+    readonly autoComplete?: number;
+    readonly rollback?: (ctx: Record<string, unknown>, task: TaskNode) => Promise<void>;
+    readonly skip?: (ctx: Record<string, unknown>) => boolean | string;
+    readonly retry?: RetryConfig;
+    readonly showTimer?: boolean;
+    readonly batchDebounceMs?: number;
+    readonly defaultSubtaskOptions?: Record<string, unknown>;
+    readonly rendererOptions?: RendererOptions;
+    readonly spinnerColor?: SpinnerColor;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@shoru/spindle",
+  "version": "1.0.0",
+  "description": "A lightweight, singleton-based CLI multi-spinner library for Node.js",
+  "type": "module",
+  "main": "./dist/index.js",
+  "repository": {
+    "url": "git+https://github.com/Mangaka-bot/ListrX.git"
+  },
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [ "dist" ],
+  "keywords": [
+    "cli",
+    "console",
+    "terminal",
+    "task",
+    "listr",
+    "listr2",
+    "spinner",
+    "ora",
+    "loader",
+    "progress",
+    "subtask",
+    "async",
+    "concurrent",
+    "workflow",
+    "pipeline",
+    "task-runner",
+    "command-line",
+    "log-update",
+    "animation",
+    "tree",
+    "rxjs",
+    "chalk",
+    "interactive",
+    "dynamic",
+    "retry",
+    "rollback",
+    "automation"
+  ],
+  "author": "Shoru",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "log-update": "^7.0.2",
+    "rxjs": "^7.8.2"
+  }
+}