@effect-tui/core 0.1.0-alpha.1

package/dist/ui/primitives/spacer.js

@@ -0,0 +1,16 @@
+import { View } from "../core/view.js";
+// Spacer (flexible in stacks)
+export class Spacer extends View {
+    minLength;
+    constructor(minLength = 0) {
+        super();
+        this.minLength = minLength;
+    }
+    measureContent(_maxW, _maxH) {
+        return { w: 0, h: 0 };
+    }
+    renderContent(_s, _pal, _rect) {
+        // Spacers render nothing
+    }
+}
+//# sourceMappingURL=spacer.js.map

package/dist/ui/primitives/spacer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacer.js","sourceRoot":"","sources":["../../../src/ui/primitives/spacer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAGtC,8BAA8B;AAC9B,MAAM,OAAO,MAAO,SAAQ,IAAI;IACT;IAArB,YAAqB,YAAY,CAAC;QAChC,KAAK,EAAE,CAAA;QADY,cAAS,GAAT,SAAS,CAAI;IAElC,CAAC;IAES,cAAc,CAAC,KAAa,EAAE,KAAa;QACnD,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;IACvB,CAAC;IAES,aAAa,CAAC,EAAW,EAAE,IAAa,EAAE,KAAW;QAC7D,yBAAyB;IAC3B,CAAC;CACF"}

package/dist/ui/primitives/text.d.ts

@@ -0,0 +1,15 @@
+import type { Palette, Surface } from "../../render/surface.js";
+import { View } from "../core/view.js";
+import type { Rect } from "../core/geometry.js";
+export declare class Text extends View {
+    readonly text: string;
+    readonly wrap?: boolean | undefined;
+    constructor(text: string, wrap?: boolean | undefined);
+    protected measureContent(maxW: number, maxH: number): {
+        w: number;
+        h: number;
+    };
+    protected renderContent(s: Surface, pal: Palette, rect: Rect): void;
+    private wrapText;
+}
+//# sourceMappingURL=text.d.ts.map

package/dist/ui/primitives/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/ui/primitives/text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAE/D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAE/C,qBAAa,IAAK,SAAQ,IAAI;IAE1B,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO;gBADd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,YAAA;IAKzB,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;;IAgBnD,SAAS,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI;IAgB5D,OAAO,CAAC,QAAQ;CAuCjB"}

package/dist/ui/primitives/text.js

@@ -0,0 +1,79 @@
+import { displayWidth } from "../../render/measure.js";
+import { View } from "../core/view.js";
+export class Text extends View {
+    text;
+    wrap;
+    constructor(text, wrap) {
+        super();
+        this.text = text;
+        this.wrap = wrap;
+    }
+    measureContent(maxW, maxH) {
+        if (!this.wrap) {
+            const w = Math.min(maxW, displayWidth(this.text));
+            return { w, h: 1 };
+        }
+        // Wrapped text measurement
+        const lines = this.wrapText(maxW);
+        const height = Math.min(maxH, lines.length);
+        let width = 0;
+        for (let i = 0; i < height; i++) {
+            width = Math.max(width, Math.min(maxW, displayWidth(lines[i])));
+        }
+        return { w: width, h: height };
+    }
+    renderContent(s, pal, rect) {
+        const id = pal.id();
+        if (this.wrap) {
+            // Use wrapping logic for rendering
+            const lines = this.wrapText(rect.w);
+            for (let i = 0; i < Math.min(lines.length, rect.h); i++) {
+                const line = lines[i];
+                if (line.length > 0) {
+                    s.drawText(rect.x, rect.y + i, line, id, rect.w);
+                }
+            }
+        }
+        else {
+            s.drawText(rect.x, rect.y, this.text, id, rect.w);
+        }
+    }
+    wrapText(maxWidth) {
+        if (maxWidth <= 0)
+            return [""];
+        if (!this.text)
+            return [""];
+        const lines = this.text.split("\n");
+        const result = [];
+        for (const line of lines) {
+            if (line.length === 0) {
+                result.push("");
+                continue;
+            }
+            const words = line.split(" ");
+            let currentLine = "";
+            for (const word of words) {
+                const testLine = currentLine + (currentLine ? " " : "") + word;
+                if (displayWidth(testLine) <= maxWidth) {
+                    currentLine = testLine;
+                }
+                else {
+                    if (currentLine) {
+                        result.push(currentLine);
+                        currentLine = word;
+                    }
+                    else {
+                        // Single word longer than maxWidth
+                        result.push(word.slice(0, maxWidth));
+                        currentLine = word.slice(maxWidth);
+                    }
+                }
+            }
+            if (currentLine) {
+                result.push(currentLine);
+            }
+        }
+        return result.length > 0 ? result : [""];
+    }
+}
+//# sourceMappingURL=text.js.map

package/dist/ui/primitives/text.js.map

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

package/dist/ui/primitives/wrapped-text.d.ts

@@ -0,0 +1,30 @@
+import type { Palette, Surface } from "../../render/surface.js";
+import type { Rect } from "../core/geometry.js";
+import { View } from "../core/view.js";
+export type WrappingOptions = {
+    wordWrap?: boolean;
+    breakWords?: boolean;
+};
+export declare class WrappedText extends View {
+    readonly text: string;
+    readonly options: WrappingOptions;
+    constructor(text: string, options?: WrappingOptions);
+    /**
+     * Split text into lines, respecting wrapping rules
+     */
+    private wrapText;
+    /**
+     * Wrap a line by word boundaries
+     */
+    private wrapLineByWords;
+    /**
+     * Wrap a line by character boundaries
+     */
+    private wrapLineByCharacters;
+    protected measureContent(maxW: number, maxH: number): {
+        w: number;
+        h: number;
+    };
+    protected renderContent(s: Surface, pal: Palette, rect: Rect): void;
+}
+//# sourceMappingURL=wrapped-text.d.ts.map

package/dist/ui/primitives/wrapped-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapped-text.d.ts","sourceRoot":"","sources":["../../../src/ui/primitives/wrapped-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAGtC,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,qBAAa,WAAY,SAAQ,IAAI;IAEjC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,eAAe;gBADxB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,eAAoB;IAKxC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAgChB;;OAEG;IACH,OAAO,CAAC,eAAe;IA0CvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAQ9E,SAAS,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI;CAWpE"}

package/dist/ui/primitives/wrapped-text.js

@@ -0,0 +1,117 @@
+import { View } from "../core/view.js";
+import { displayWidth, sliceByWidth } from "../../render/measure.js";
+export class WrappedText extends View {
+    text;
+    options;
+    constructor(text, options = {}) {
+        super();
+        this.text = text;
+        this.options = options;
+    }
+    /**
+     * Split text into lines, respecting wrapping rules
+     */
+    wrapText(maxWidth) {
+        if (maxWidth <= 0)
+            return [""];
+        if (!this.text)
+            return [];
+        const { wordWrap = true, breakWords = false } = this.options;
+        // First split on explicit line breaks
+        const inputLines = this.text.split("\n");
+        const wrappedLines = [];
+        for (const line of inputLines) {
+            if (line.length === 0) {
+                wrappedLines.push("");
+                continue;
+            }
+            if (line.length <= maxWidth) {
+                wrappedLines.push(line);
+                continue;
+            }
+            // Line needs wrapping
+            if (wordWrap) {
+                this.wrapLineByWords(line, maxWidth, breakWords, wrappedLines);
+            }
+            else {
+                this.wrapLineByCharacters(line, maxWidth, wrappedLines);
+            }
+        }
+        return wrappedLines;
+    }
+    /**
+     * Wrap a line by word boundaries
+     */
+    wrapLineByWords(line, maxWidth, breakWords, output) {
+        const words = line.split(/(\s+)/); // Keep whitespace in results
+        let currentLine = "";
+        for (const word of words) {
+            // Skip empty strings
+            if (word.length === 0)
+                continue;
+            // If this is whitespace and we're at the start of a line, skip it
+            if (/^\s+$/.test(word) && currentLine.length === 0)
+                continue;
+            // If adding this word would exceed width
+            if (displayWidth(currentLine + word) > maxWidth) {
+                // If we have content on current line, save it and start new line
+                if (currentLine.length > 0) {
+                    output.push(currentLine.trimEnd());
+                    currentLine = "";
+                }
+                // Handle long words
+                if (displayWidth(word.trim()) > maxWidth) {
+                    if (breakWords) {
+                        this.wrapLineByCharacters(word.trim(), maxWidth, output);
+                    }
+                    else {
+                        // Don't break the word, just put it on its own line (may overflow)
+                        output.push(word.trim());
+                    }
+                }
+                else if (word.trim().length > 0) {
+                    // Start new line with this word (skip leading whitespace)
+                    currentLine = word.trim();
+                }
+            }
+            else {
+                currentLine += word;
+            }
+        }
+        // Add remaining content
+        if (currentLine.length > 0) {
+            output.push(currentLine.trimEnd());
+        }
+    }
+    /**
+     * Wrap a line by character boundaries
+     */
+    wrapLineByCharacters(line, maxWidth, output) {
+        let rest = line;
+        while (rest.length > 0) {
+            const { text } = sliceByWidth(rest, maxWidth);
+            if (text.length === 0)
+                break;
+            output.push(text);
+            rest = rest.slice(text.length);
+        }
+    }
+    measureContent(maxW, maxH) {
+        const lines = this.wrapText(maxW);
+        const h = Math.min(maxH, Math.max(1, lines.length));
+        // WrappedText is greedy horizontally - takes full available width when content exists
+        const w = maxW;
+        return { w, h };
+    }
+    renderContent(s, pal, rect) {
+        const lines = this.wrapText(rect.w);
+        const styleId = pal.id();
+        for (let i = 0; i < Math.min(lines.length, rect.h); i++) {
+            const line = lines[i];
+            if (line.length > 0) {
+                s.drawText(rect.x, rect.y + i, line, styleId, rect.w);
+            }
+        }
+    }
+}
+//# sourceMappingURL=wrapped-text.js.map

package/dist/ui/primitives/wrapped-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapped-text.js","sourceRoot":"","sources":["../../../src/ui/primitives/wrapped-text.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAOpE,MAAM,OAAO,WAAY,SAAQ,IAAI;IAExB;IACA;IAFX,YACW,IAAY,EACZ,UAA2B,EAAE;QAEtC,KAAK,EAAE,CAAA;QAHE,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAsB;IAGxC,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,QAAgB;QAC/B,IAAI,QAAQ,IAAI,CAAC;YAAE,OAAO,CAAC,EAAE,CAAC,CAAA;QAC9B,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAA;QAEzB,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,CAAA;QAE5D,sCAAsC;QACtC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACxC,MAAM,YAAY,GAAa,EAAE,CAAA;QAEjC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACrB,SAAQ;YACV,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC5B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACvB,SAAQ;YACV,CAAC;YAED,sBAAsB;YACtB,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,CAAA;YAChE,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAA;YACzD,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAA;IACrB,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,IAAY,EAAE,QAAgB,EAAE,UAAmB,EAAE,MAAgB;QAC3F,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA,CAAC,6BAA6B;QAC/D,IAAI,WAAW,GAAG,EAAE,CAAA;QAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,qBAAqB;YACrB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YAE/B,kEAAkE;YAClE,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YAE5D,yCAAyC;YACzC,IAAI,YAAY,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC;gBAChD,iEAAiE;gBACjE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3B,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;oBAClC,WAAW,GAAG,EAAE,CAAA;gBAClB,CAAC;gBAED,oBAAoB;gBACpB,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC;oBACzC,IAAI,UAAU,EAAE,CAAC;wBACf,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;oBAC1D,CAAC;yBAAM,CAAC;wBACN,mEAAmE;wBACnE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;oBAC1B,CAAC;gBACH,CAAC;qBAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAClC,0DAA0D;oBAC1D,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;gBAC3B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,WAAW,IAAI,IAAI,CAAA;YACrB,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,IAAY,EAAE,QAAgB,EAAE,MAAgB;QAC3E,IAAI,IAAI,GAAG,IAAI,CAAA;QACf,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YAC7C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAK;YAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACjB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IAES,cAAc,CAAC,IAAY,EAAE,IAAY;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;QACnD,sFAAsF;QACtF,MAAM,CAAC,GAAG,IAAI,CAAA;QACd,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;IACjB,CAAC;IAES,aAAa,CAAC,CAAU,EAAE,GAAY,EAAE,IAAU;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACnC,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,EAAE,CAAA;QAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACxD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YACrB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;YACvD,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/ui/shinytext.d.ts

@@ -0,0 +1,66 @@
+import type { Palette, Surface } from "../render/surface.js";
+import type { Rect } from "./core/geometry.js";
+import { type Stepper } from "../anim.js";
+import { View } from "./core/view.js";
+export type ShineTextOptions = {
+    /**
+     * Center position of the shine in character coordinates (can be fractional).
+     * 0 = before first char, length-1 = last char. Values outside are fine for overscan.
+     */
+    center?: number;
+    /**
+     * Alternative to center: normalized progress 0..1 across the text.
+     * If provided, takes precedence and maps to center internally.
+     */
+    progress?: number;
+    /** Gaussian falloff spread; larger = wider shine. Default 2.25 */
+    spread?: number;
+    /** Base gray level (0..23). Default 12 */
+    baseGray?: number;
+    /** Max additional gray levels added at peak (0..23). Default 8 */
+    boost?: number;
+    /** Bold threshold on intensity (0..1). Default 0.75 */
+    boldThreshold?: number;
+};
+export declare class ShinyText extends View {
+    readonly text: string;
+    readonly opts?: ShineTextOptions | undefined;
+    constructor(text: string, opts?: ShineTextOptions | undefined);
+    private getChars;
+    protected measureContent(maxW: number, _maxH: number): {
+        w: number;
+        h: number;
+    };
+    protected renderContent(s: Surface, pal: Palette, rect: Rect): void;
+}
+export type ViewShinyTextExt = {
+    shineText(text: string, opts?: ShineTextOptions): View;
+};
+export declare const viewShinyText: ViewShinyTextExt;
+export type ShinyTextModel = {
+    text: string;
+    step: Stepper;
+    speedMs: number;
+    overscan: number;
+    shine?: Omit<ShineTextOptions, "center" | "progress">;
+};
+export type InitShinyOptions = {
+    speedMs?: number;
+    overscan?: number;
+    shine?: Omit<ShineTextOptions, "center" | "progress">;
+};
+export declare function initShinyText(text: string, opts?: InitShinyOptions): ShinyTextModel;
+export declare function tickShinyText(state: ShinyTextModel, nowMs: number): ShinyTextModel;
+export declare function setShinySpeed(state: ShinyTextModel, speedMs: number): ShinyTextModel;
+/** Create a ShinyText node from state. Use with chainers like .frame/.padding. */
+export declare function shinyText(state: ShinyTextModel): View;
+export declare namespace ShinyText {
+    type Model = ShinyTextModel;
+    type Options = ShineTextOptions;
+    type MakeOptions = InitShinyOptions;
+    const make: typeof initShinyText;
+    const tick: typeof tickShinyText;
+    const setSpeed: typeof setShinySpeed;
+    const view: typeof shinyText;
+}
+//# sourceMappingURL=shinytext.d.ts.map

package/dist/ui/shinytext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shinytext.d.ts","sourceRoot":"","sources":["../../src/ui/shinytext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAErC,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,qBAAa,SAAU,SAAQ,IAAI;IAE/B,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB;gBADvB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,gBAAgB,YAAA;IAKlC,OAAO,CAAC,QAAQ;IAIhB,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAKpD,SAAS,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI;CA+C7D;AAGD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;CACvD,CAAA;AACD,eAAO,MAAM,aAAa,EAAE,gBAI3B,CAAA;AAMD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAA;CACtD,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAA;CACtD,CAAA;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,cAAc,CAMnF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAGlF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAIpF;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAGrD;AAGD,yBAAiB,SAAS,CAAC;IACzB,KAAY,KAAK,GAAG,cAAc,CAAA;IAClC,KAAY,OAAO,GAAG,gBAAgB,CAAA;IACtC,KAAY,WAAW,GAAG,gBAAgB,CAAA;IAEnC,MAAM,IAAI,sBAAgB,CAAA;IAC1B,MAAM,IAAI,sBAAgB,CAAA;IAC1B,MAAM,QAAQ,sBAAgB,CAAA;IAC9B,MAAM,IAAI,kBAAY,CAAA;CAC9B"}

package/dist/ui/shinytext.js

@@ -0,0 +1,99 @@
+/* shinytext.ts — reusable shining text component */
+import { Colors } from "../render/surface.js";
+import { Step } from "../anim.js";
+import { View } from "./core/view.js";
+export class ShinyText extends View {
+    text;
+    opts;
+    constructor(text, opts) {
+        super();
+        this.text = text;
+        this.opts = opts;
+    }
+    getChars() {
+        return [...this.text];
+    }
+    measureContent(maxW, _maxH) {
+        const w = Math.min(maxW, this.getChars().length);
+        return { w, h: 1 };
+    }
+    renderContent(s, pal, rect) {
+        const chars = this.getChars();
+        const n = Math.min(rect.w, chars.length);
+        if (rect.h <= 0 || n <= 0)
+            return;
+        const spread = this.opts?.spread ?? 2.25;
+        const base = Math.max(0, Math.min(23, (this.opts?.baseGray ?? 12) | 0));
+        const boost = Math.max(0, Math.min(23, (this.opts?.boost ?? 8) | 0));
+        const boldTh = this.opts?.boldThreshold ?? 0.75;
+        const progress = this.opts?.progress;
+        const center = progress != null ? progress * (chars.length - 1) : (this.opts?.center ?? 0);
+        const styleFor = (i) => {
+            const d = (i - center) / Math.max(1e-3, spread);
+            const intensity = Math.exp(-d * d);
+            const level = Math.max(0, Math.min(23, base + Math.round(intensity * boost)));
+            const bold = intensity > boldTh;
+            return pal.id({ fg: Colors.gray(level), bold });
+        };
+        // Emit minimal runs per style id
+        const y = rect.y;
+        let x = rect.x;
+        let runStyle = -1;
+        let runStart = x;
+        let runText = "";
+        const flush = () => {
+            if (runText.length > 0) {
+                const maxW = Math.max(0, rect.x + rect.w - runStart);
+                if (maxW > 0)
+                    s.drawText(runStart, y, runText, runStyle, maxW);
+                runText = "";
+            }
+        };
+        for (let i = 0; i < n; i++) {
+            const ch = chars[i];
+            const id = styleFor(i);
+            if (id !== runStyle) {
+                flush();
+                runStyle = id;
+                runStart = x;
+            }
+            runText += ch;
+            x++;
+        }
+        flush();
+    }
+}
+export const viewShinyText = {
+    shineText(text, opts) {
+        return new ShinyText(text, opts);
+    },
+};
+export function initShinyText(text, opts) {
+    const speedMs = Math.max(1, (opts?.speedMs ?? 40) | 0);
+    const overscan = Math.max(0, (opts?.overscan ?? 6) | 0);
+    const width = [...text].length;
+    const step = Step.init(width + overscan * 2, speedMs, 0);
+    return { text, step, speedMs, overscan, shine: opts?.shine };
+}
+export function tickShinyText(state, nowMs) {
+    const step = Step.tick(state.step, nowMs);
+    return { ...state, step };
+}
+export function setShinySpeed(state, speedMs) {
+    const ms = Math.max(1, speedMs | 0);
+    const step = { ...state.step, intervalMs: ms };
+    return { ...state, speedMs: ms, step };
+}
+/** Create a ShinyText node from state. Use with chainers like .frame/.padding. */
+export function shinyText(state) {
+    const center = state.step.index - state.overscan;
+    return new ShinyText(state.text, { ...state.shine, center });
+}
+// Merged namespace to expose a cohesive API: ShinyText.make(), ShinyText.tick(), ShinyText.setSpeed(), ShinyText.view()
+(function (ShinyText) {
+    ShinyText.make = initShinyText;
+    ShinyText.tick = tickShinyText;
+    ShinyText.setSpeed = setShinySpeed;
+    ShinyText.view = shinyText;
+})(ShinyText || (ShinyText = {}));
+//# sourceMappingURL=shinytext.js.map

package/dist/ui/shinytext.js.map

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

package/dist/ui/text/layout.d.ts

@@ -0,0 +1,35 @@
+export type WrappedLine = {
+    text: string;
+    graphemes: string[];
+    start: number;
+    width: number;
+};
+export type Wrapped = {
+    lines: Array<WrappedLine>;
+};
+export type WrapOptions = {
+    widthFirst: number;
+    widthOther: number;
+    wordWrap: boolean;
+    breakWords: boolean;
+};
+/** Compute wrapped lines with widths and grapheme start offsets (soft + hard breaks). */
+export declare function wrapText(value: string, opts: WrapOptions): Wrapped;
+/** Locate the visual line and column within that line for a grapheme cursor. */
+export declare function findVisualPos(wrap: Wrapped, cursor: number): {
+    lineIdx: number;
+    colInLine: number;
+};
+/** Sum display widths of graphemes up to a column to get visual cell X. */
+export declare function cellXWithinLine(wrap: Wrapped, lineIdx: number, colInLine: number): number;
+/** Map a visual cell X back to a cursor index on a given line (nearest-left by centers). */
+export declare function cursorFromCellX(wrap: Wrapped, lineIdx: number, x: number): number;
+/** Map cursor index to absolute caret coordinates using provided anchors. */
+export declare function caretXYFromCursor(wrap: Wrapped, cursor: number, anchors: {
+    xFirst: number;
+    xOther: number;
+}): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=layout.d.ts.map

package/dist/ui/text/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/ui/text/layout.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAC7F,MAAM,MAAM,OAAO,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;CAAE,CAAA;AAEnD,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAkClE;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAoBnG;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMzF;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAWjF;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAM1B"}

package/dist/ui/text/layout.js

@@ -0,0 +1,102 @@
+/* text/layout.ts — Shared text layout utilities for wrapping and caret mapping
+ *
+ * Single source of truth for:
+ * - Computing wrapped visual lines (first-line width vs subsequent)
+ * - Mapping between grapheme cursor index and visual caret coordinates
+ * - Mapping from visual cell X back to cursor index (for vertical nav)
+ *
+ * These helpers mirror renderer behavior by delegating to render/measure.ts
+ * (displayWidth, graphemes, sliceByWidth), ensuring edit-time and render-time
+ * wrapping boundaries are identical.
+ */
+import { displayWidth, graphemes, sliceByWidth } from "../../render/measure.js";
+/** Compute wrapped lines with widths and grapheme start offsets (soft + hard breaks). */
+export function wrapText(value, opts) {
+    const lines = [];
+    const widthFor = (isFirstVisual) => Math.max(0, isFirstVisual ? opts.widthFirst : opts.widthOther);
+    let gOffset = 0; // grapheme index from start of whole value
+    let isFirstVisual = true;
+    // Split logical lines by explicit newlines
+    const logicals = value.split("\n");
+    for (let li = 0; li < logicals.length; li++) {
+        const logical = logicals[li];
+        let rest = logical;
+        // Even for empty logical lines, emit one visual line (empty)
+        if (rest.length === 0) {
+            lines.push({ graphemes: [], start: gOffset, width: 0 });
+            if (li < logicals.length - 1)
+                gOffset += 1; // the "\n" grapheme
+            isFirstVisual = false;
+            continue;
+        }
+        while (rest.length > 0) {
+            const maxW = widthFor(isFirstVisual);
+            const { text } = sliceByWidth(rest, maxW);
+            const used = text.length > 0 ? text : rest.slice(0, 1); // ensure progress even when maxW == 0
+            const usedGs = graphemes(used);
+            const w = displayWidth(used);
+            lines.push({ graphemes: usedGs, start: gOffset, width: w });
+            gOffset += usedGs.length;
+            rest = rest.slice(used.length);
+            isFirstVisual = false;
+            if (used.length === 0)
+                break;
+        }
+        if (li < logicals.length - 1)
+            gOffset += 1; // account for newline between logical segments
+    }
+    return { lines: lines.map((l) => ({ ...l, text: l.graphemes.join("") })) };
+}
+/** Locate the visual line and column within that line for a grapheme cursor. */
+export function findVisualPos(wrap, cursor) {
+    for (let i = 0; i < wrap.lines.length; i++) {
+        const ln = wrap.lines[i];
+        const start = ln.start;
+        // Use next line's start as upper bound (accounts for newline gaps)
+        const nextStart = i + 1 < wrap.lines.length ? wrap.lines[i + 1].start : Infinity;
+        // Cursor in range [start, nextStart) belongs to this line
+        if (cursor >= start && cursor < nextStart) {
+            // For empty lines, cursor must be exactly at start
+            if (ln.graphemes.length === 0) {
+                return { lineIdx: i, colInLine: 0 };
+            }
+            const col = Math.min(cursor - start, ln.graphemes.length);
+            return { lineIdx: i, colInLine: col };
+        }
+    }
+    // Fallback: end of last line
+    const last = wrap.lines[wrap.lines.length - 1];
+    return { lineIdx: wrap.lines.length - 1, colInLine: last.graphemes.length };
+}
+/** Sum display widths of graphemes up to a column to get visual cell X. */
+export function cellXWithinLine(wrap, lineIdx, colInLine) {
+    const ln = wrap.lines[lineIdx];
+    const gs = ln.graphemes;
+    let x = 0;
+    for (let i = 0; i < Math.min(colInLine, gs.length); i++)
+        x += displayWidth(gs[i]);
+    return x;
+}
+/** Map a visual cell X back to a cursor index on a given line (nearest-left by centers). */
+export function cursorFromCellX(wrap, lineIdx, x) {
+    const ln = wrap.lines[lineIdx];
+    const gs = ln.graphemes;
+    let acc = 0;
+    for (let i = 0; i < gs.length; i++) {
+        const w = displayWidth(gs[i]);
+        const center = acc + w / 2;
+        if (x < center)
+            return ln.start + i;
+        acc += w;
+    }
+    return ln.start + gs.length;
+}
+/** Map cursor index to absolute caret coordinates using provided anchors. */
+export function caretXYFromCursor(wrap, cursor, anchors) {
+    const { lineIdx, colInLine } = findVisualPos(wrap, cursor);
+    const baseX = lineIdx === 0 ? anchors.xFirst : anchors.xOther;
+    const x = baseX + cellXWithinLine(wrap, lineIdx, colInLine);
+    const y = lineIdx;
+    return { x, y };
+}
+//# sourceMappingURL=layout.js.map

package/dist/ui/text/layout.js.map

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