@dungle-scrubs/tallow 0.8.21 → 0.8.23

package/packages/tallow-tui/dist/components/loader.js

@@ -0,0 +1,146 @@
+import { Text } from "./text.js";
+/** Default braille spinner frames used when no custom frames are provided. */
+const DEFAULT_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+/** Default animation interval in milliseconds. */
+const DEFAULT_INTERVAL_MS = 80;
+/**
+ * Loader component that updates with a spinning animation.
+ *
+ * @param ui - TUI instance for rendering
+ * @param spinnerColorFn - Color function applied to the spinner frame
+ * @param messageColorFn - Color function applied to the message text
+ * @param message - Text shown next to the spinner (default: "Loading...")
+ * @param options - Optional frames and interval override
+ */
+export class Loader extends Text {
+    spinnerColorFn;
+    messageColorFn;
+    message;
+    frames;
+    intervalMs;
+    currentFrame = 0;
+    intervalId = null;
+    _transformIntervalId = null;
+    ui = null;
+    /** Per-instance tick counter for message transform animations. */
+    _transformTick = 0;
+    /** Tracks whether setMessage() has been called since construction. */
+    _messageChanged = false;
+    constructor(ui, spinnerColorFn, messageColorFn, message = "Loading...", options) {
+        super("", 1, 0);
+        this.spinnerColorFn = spinnerColorFn;
+        this.messageColorFn = messageColorFn;
+        this.message = message;
+        this.frames = options?.frames ?? Loader.defaultFrames ?? DEFAULT_FRAMES;
+        this.intervalMs = options?.intervalMs ?? Loader.defaultIntervalMs ?? DEFAULT_INTERVAL_MS;
+        this.ui = ui;
+        this.start();
+    }
+    /**
+     * Global default spinner frames — set once, applies to all new Loader instances.
+     * Extensions can set this at session_start to override the braille default.
+     */
+    static defaultFrames;
+    /**
+     * Global default interval — set once, applies to all new Loader instances.
+     */
+    static defaultIntervalMs;
+    /**
+     * Global message transform — called each tick to modify the displayed message.
+     * Extensions use this to animate or replace the loader text.
+     * Return the string to display. The transform is applied before messageColorFn.
+     */
+    static defaultMessageTransform;
+    /**
+     * Interval (ms) for the message transform tick — independent of the spinner frame rate.
+     * When set to a value faster than the spinner interval, a separate timer drives
+     * the transform tick and re-renders, giving animations higher
+     * frame rates without affecting the spinner animation speed.
+     */
+    static defaultTransformIntervalMs;
+    /** Whether the loader is hidden (renders as empty space). */
+    hidden = false;
+    /**
+     * Hide the loader — renders nothing but keeps the interval alive.
+     * Call show() to restore.
+     */
+    hide() {
+        this.hidden = true;
+        this.setText("");
+        this.ui?.requestRender();
+    }
+    /**
+     * Show the loader after a hide() call.
+     */
+    show() {
+        this.hidden = false;
+        this.updateDisplay();
+    }
+    render(width) {
+        if (this.hidden)
+            return [];
+        return ["", ...super.render(width)];
+    }
+    start() {
+        this.updateDisplay();
+        const transformMs = Loader.defaultTransformIntervalMs;
+        const hasFastTransform = Loader.defaultMessageTransform != null &&
+            transformMs != null &&
+            transformMs < this.intervalMs;
+        this.intervalId = setInterval(() => {
+            this.currentFrame = (this.currentFrame + 1) % this.frames.length;
+            this._transformTick++;
+            this.updateDisplay();
+        }, this.intervalMs);
+        // Separate faster interval for message transform re-renders only.
+        // Does NOT advance _transformTick — just re-rolls random visuals.
+        if (hasFastTransform) {
+            this._transformIntervalId = setInterval(() => {
+                this.updateDisplay();
+            }, transformMs);
+        }
+    }
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        if (this._transformIntervalId) {
+            clearInterval(this._transformIntervalId);
+            this._transformIntervalId = null;
+        }
+    }
+    /** Sentinel value — pass to setWorkingMessage() to hide the loader. */
+    static HIDE = "\u200B";
+    /**
+     * Set the loader message. Pass Loader.HIDE to hide, any other string to show.
+     * @param message - Message text or Loader.HIDE sentinel
+     */
+    setMessage(message) {
+        if (message === Loader.HIDE) {
+            this.hide();
+            return;
+        }
+        if (this.hidden)
+            this.show();
+        this._messageChanged = true;
+        this.message = message;
+        this.updateDisplay();
+    }
+    updateDisplay() {
+        const frame = this.frames[this.currentFrame];
+        let displayMessage = this.message;
+        if (Loader.defaultMessageTransform) {
+            displayMessage = Loader.defaultMessageTransform({
+                message: this.message,
+                tick: this._transformTick,
+                isInitialMessage: !this._messageChanged,
+            });
+        }
+        this.setText(`${this.spinnerColorFn(frame)} ${this.messageColorFn(displayMessage)}`);
+        if (this.ui) {
+            this.ui.requestRender();
+        }
+    }
+}
+//# sourceMappingURL=loader.js.map

package/packages/tallow-tui/dist/components/loader.js.map

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

package/packages/tallow-tui/dist/components/markdown.d.ts

@@ -0,0 +1,95 @@
+import type { Component } from "../tui.js";
+/**
+ * Default text styling for markdown content.
+ * Applied to all text unless overridden by markdown formatting.
+ */
+export interface DefaultTextStyle {
+    /** Foreground color function */
+    color?: (text: string) => string;
+    /** Background color function */
+    bgColor?: (text: string) => string;
+    /** Bold text */
+    bold?: boolean;
+    /** Italic text */
+    italic?: boolean;
+    /** Strikethrough text */
+    strikethrough?: boolean;
+    /** Underline text */
+    underline?: boolean;
+}
+/**
+ * Theme functions for markdown elements.
+ * Each function takes text and returns styled text with ANSI codes.
+ */
+export interface MarkdownTheme {
+    heading: (text: string) => string;
+    link: (text: string) => string;
+    linkUrl: (text: string) => string;
+    code: (text: string) => string;
+    codeBlock: (text: string) => string;
+    codeBlockBorder: (text: string) => string;
+    quote: (text: string) => string;
+    quoteBorder: (text: string) => string;
+    hr: (text: string) => string;
+    listBullet: (text: string) => string;
+    bold: (text: string) => string;
+    italic: (text: string) => string;
+    strikethrough: (text: string) => string;
+    underline: (text: string) => string;
+    highlightCode?: (code: string, lang?: string) => string[];
+    /** Prefix applied to each rendered code block line (default: "  ") */
+    codeBlockIndent?: string;
+}
+export declare class Markdown implements Component {
+    private text;
+    private paddingX;
+    private paddingY;
+    private defaultTextStyle?;
+    private theme;
+    private defaultStylePrefix?;
+    private cachedText?;
+    private cachedWidth?;
+    private cachedLines?;
+    constructor(text: string, paddingX: number, paddingY: number, theme: MarkdownTheme, defaultTextStyle?: DefaultTextStyle);
+    setText(text: string): void;
+    invalidate(): void;
+    render(width: number): string[];
+    /**
+     * Apply default text style to a string.
+     * This is the base styling applied to all text content.
+     * NOTE: Background color is NOT applied here - it's applied at the padding stage
+     * to ensure it extends to the full line width.
+     */
+    private applyDefaultStyle;
+    private getDefaultStylePrefix;
+    private getStylePrefix;
+    private getDefaultInlineStyleContext;
+    private renderToken;
+    private renderInlineTokens;
+    /**
+     * Render a list with proper nesting support
+     */
+    private renderList;
+    /**
+     * Render list item tokens, handling nested lists
+     * Returns lines WITHOUT the parent indent (renderList will add it)
+     */
+    private renderListItem;
+    /**
+     * Get the visible width of the longest word in a string.
+     */
+    private getLongestWordWidth;
+    /**
+     * Wrap a table cell to fit into a column.
+     *
+     * Delegates to wrapTextWithAnsi() so ANSI codes + long tokens are handled
+     * consistently with the rest of the renderer.
+     */
+    private wrapCellText;
+    /**
+     * Render a table with width-aware cell wrapping.
+     * Cells that don't fit are wrapped to multiple lines.
+     */
+    private renderTable;
+}
+//# sourceMappingURL=markdown.d.ts.map

package/packages/tallow-tui/dist/components/markdown.d.ts.map

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