@promptctl/rich-js 0.16.0 → 0.18.0

package/dist/widgets/screen.js

@@ -1,542 +0,0 @@
-/**
- * Screen — owns the render loop and ANSI output for interactive widgets.
- *
- * [LAW:dataflow-not-control-flow] Same pipeline runs every frame: render
- * widgets to Segment[], split into lines, encode to ANSI, write to stdout
- * with cursor-up + overwrite. Variability lives in the values (which widgets
- * are visible, what they render), never in whether the pipeline runs.
- *
- * [LAW:one-source-of-truth] Layout (widget bounds) is computed here and
- * written to widget.bounds. Mouse hit-testing reads the same bounds — the
- * Screen is the single authority on where each widget is drawn.
- *
- * [LAW:single-enforcer] Cursor management lives in one place: `draw()`
- * tracks `lastLineCount` and emits a single `\x1b[<n>A` to reposition.
- * Per-line `\x1b[K` (erase to end of line) overwrites old content without
- * flicker — no clear-and-redraw cycle.
- *
- * Reactivity: `mobx.autorun` re-fires on any observable read during render
- * (label, focused, hovered, active, disabled, visible, the widget list
- * itself). Renders are debounced to a microtask so a burst of state changes
- * within one tick produces one frame.
- *
- * Layout (per-widget Placement):
- *
- *   flow   — vertical stack at x=0; advances the layout cursor by the
- *            widget's measured height. Default placement; preserves the
- *            historical single-column behavior so existing consumers
- *            (and the screen tests) need no migration.
- *   inline — same row as the preceding flow/inline neighbor; x packs
- *            after that neighbor's right edge plus a one-cell gap. The
- *            row's height is the max of its members; the cursor advances
- *            past the tallest member when the next non-inline item is
- *            placed (or at end of frame).
- *   fixed  — absolute (x, y); independent of the cursor. Used for
- *            anchored content like status/log rows that the host wants
- *            placed at a known coordinate regardless of flow growth.
- *
- * The overlay pass (single enforcer) runs after base layout: any widget
- * implementing OverlayRenderable contributes overlay segments anchored
- * directly below its inline footprint, and Screen unions the overlay
- * area into the widget's bounds for hit-testing.
- *
- * Design alternatives considered:
- *   1. Per-widget Placement (chosen) — smallest type that covers the legal
- *      variability; one total switch in computeFrame; back-compat default.
- *   2. Named regions (header/body/status as flow containers) — adds a
- *      two-step API surface (declare regions, then mount into them) and
- *      another concept; rejected as larger than the problem requires.
- *   3. Host-supplied layout function — pushes layout out of Screen,
- *      defeating single-enforcer; rejected.
- */
-var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
-    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
-    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
-    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
-    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
-    var _, done = false;
-    for (var i = decorators.length - 1; i >= 0; i--) {
-        var context = {};
-        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
-        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
-        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
-        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
-        if (kind === "accessor") {
-            if (result === void 0) continue;
-            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
-            if (_ = accept(result.get)) descriptor.get = _;
-            if (_ = accept(result.set)) descriptor.set = _;
-            if (_ = accept(result.init)) initializers.unshift(_);
-        }
-        else if (_ = accept(result)) {
-            if (kind === "field") initializers.unshift(_);
-            else descriptor[key] = _;
-        }
-    }
-    if (target) Object.defineProperty(target, contextIn.name, descriptor);
-    done = true;
-};
-var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
-    var useValue = arguments.length > 2;
-    for (var i = 0; i < initializers.length; i++) {
-        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
-    }
-    return useValue ? value : void 0;
-};
-import { autorun, observableShallow, runInAction } from "mobx";
-import { Segment } from "../core/segment.js";
-import { asCellCol } from "../core/cells.js";
-import { segmentsToString } from "../core/render.js";
-import { resolveColorSystem } from "../core/color.js";
-import { DefaultFocusManager } from "./focus-manager.js";
-import { FLOW, hasOverlay } from "./types.js";
-let DefaultScreen = (() => {
-    let _widgetList_decorators;
-    let _widgetList_initializers = [];
-    let _widgetList_extraInitializers = [];
-    return class DefaultScreen {
-        static {
-            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
-            _widgetList_decorators = [observableShallow];
-            __esDecorate(this, null, _widgetList_decorators, { kind: "accessor", name: "widgetList", static: false, private: false, access: { has: obj => "widgetList" in obj, get: obj => obj.widgetList, set: (obj, value) => { obj.widgetList = value; } }, metadata: _metadata }, _widgetList_initializers, _widgetList_extraInitializers);
-            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-        }
-        focusManager;
-        #widgetList_accessor_storage = __runInitializers(this, _widgetList_initializers, []);
-        // [LAW:one-source-of-truth] The mounted widget list is observable so
-        // mount/unmount triggers the render autorun without an extra subscription.
-        get widgetList() { return this.#widgetList_accessor_storage; }
-        set widgetList(value) { this.#widgetList_accessor_storage = value; }
-        // [LAW:one-source-of-truth] Placements live in a parallel Map keyed by
-        // widget. Placements are immutable per mount — Screen sets them and never
-        // mutates them, so they don't need to be observable. The observable
-        // `widgetList` above already fires reactivity on mount/unmount.
-        placements = (__runInitializers(this, _widgetList_extraInitializers), new Map());
-        // [LAW:single-enforcer] Set of widgets whose overlay rendered visible
-        // rows in the most recent frame. Updated by draw() from FrameLayout;
-        // consumed by the `widgets` getter to expose hit-test z-order to
-        // EventRouter. Mount/unmount don't touch this — it's a per-frame
-        // derivation, not mount state.
-        _activeOverlays = new Set();
-        _running = false;
-        autorunDispose;
-        renderScheduled = false;
-        // [LAW:one-source-of-truth] The autorun computes the next frame once and
-        // stores it here; draw() reads and clears. Not observable — only the
-        // autorun writes, only draw reads, both run in the same single-threaded
-        // event loop.
-        pendingFrame = null;
-        lastLineCount = 0;
-        host;
-        widthOverride;
-        colorSystem;
-        manageCursor;
-        constructor(options) {
-            this.host = options.host;
-            this.widthOverride = options.width;
-            this.focusManager = options.focusManager ?? new DefaultFocusManager();
-            const isTTY = this.host.isTTY;
-            this.colorSystem = resolveSpec(options.colorSystem, isTTY);
-            this.manageCursor = options.manageCursor ?? isTTY;
-        }
-        get running() {
-            return this._running;
-        }
-        // [LAW:types-are-the-program] `widgets` is the *output* of layout: the
-        // list EventRouter uses for hit-testing, in z-order — non-overlay widgets
-        // first (in mount order), overlay-active widgets last. `topmostHit`
-        // iterates this in reverse and returns the first containing widget, so
-        // overlay-active widgets win against anything mounted under them.
-        // [LAW:single-enforcer] Screen is the sole authority on z-order; the
-        // router consumes the result, never derives it itself.
-        get widgets() {
-            if (this._activeOverlays.size === 0)
-                return this.widgetList;
-            const base = [];
-            const top = [];
-            for (const w of this.widgetList) {
-                (this._activeOverlays.has(w) ? top : base).push(w);
-            }
-            return [...base, ...top];
-        }
-        // --- Lifecycle ---
-        mount(...entries) {
-            runInAction(() => {
-                const next = [...this.widgetList];
-                for (const entry of entries) {
-                    const { widget, placement } = normalizeEntry(entry);
-                    if (next.includes(widget))
-                        continue;
-                    next.push(widget);
-                    this.placements.set(widget, placement);
-                    this.focusManager.register(widget);
-                }
-                this.widgetList = next;
-            });
-        }
-        unmount(widget) {
-            runInAction(() => {
-                const idx = this.widgetList.indexOf(widget);
-                if (idx === -1)
-                    return;
-                this.widgetList = this.widgetList.filter((w) => w !== widget);
-                this.placements.delete(widget);
-                this.focusManager.unregister(widget);
-                // [LAW:one-source-of-truth] Drop any z-order entry for the removed
-                // widget so a later getter doesn't return a dangling reference.
-                // The next draw will rebuild this from scratch.
-                this._activeOverlays.delete(widget);
-            });
-        }
-        start() {
-            if (this._running)
-                return;
-            this._running = true;
-            this.lastLineCount = 0;
-            if (this.manageCursor)
-                this.host.write("\x1b[?25l");
-            // [LAW:dataflow-not-control-flow] One reactive pipeline. The autorun
-            // computes the frame (which reads observables; MobX subscribes to
-            // exactly what was read so only relevant state changes trigger redraws),
-            // caches it as `pendingFrame`, and schedules a microtask to paint it.
-            // draw() consumes the cached frame instead of recomputing — without the
-            // cache, every tick laid the frame out twice (once for subscription,
-            // once for paint).
-            this.autorunDispose = autorun(() => {
-                this.pendingFrame = this.computeFrame();
-                this.scheduleRender();
-            });
-        }
-        stop() {
-            if (!this._running)
-                return;
-            this._running = false;
-            if (this.autorunDispose) {
-                this.autorunDispose();
-                this.autorunDispose = undefined;
-            }
-            // [LAW:one-source-of-truth] stop() returns the screen to a clean
-            // baseline. Without these resets a stopped screen would retain the
-            // last FrameLayout (segments + bounds) — unnecessary memory and a
-            // restart hazard where the first frame after restart could leak the
-            // pre-stop layout. Same idempotent-cleanup pattern as EventRouter.stop.
-            this.pendingFrame = null;
-            this.renderScheduled = false;
-            this._activeOverlays = new Set();
-            if (this.manageCursor)
-                this.host.write("\x1b[?25h");
-            if (this.lastLineCount > 0)
-                this.host.write("\n");
-        }
-        // --- Internal: layout + draw ---
-        get width() {
-            if (this.widthOverride !== undefined)
-                return this.widthOverride;
-            return this.host.size().cols;
-        }
-        computeFrame() {
-            // [LAW:one-source-of-truth] Snapshot the width ONCE at the top of
-            // the frame so layout, per-widget clipping, per-line clipping, and
-            // the final paint all see the same value. Reading `this.width`
-            // multiple times can drift across a microtask boundary if the
-            // terminal is resized between compute and draw.
-            const width = this.width;
-            const renderOptions = {
-                maxWidth: width,
-                isTerminal: true,
-                encoding: "utf-8",
-                // [LAW:one-source-of-truth] The depth the frame is encoded at (below,
-                // `segmentsToString`), so a renderable that decides on drawn colours
-                // decides on the ones this screen draws.
-                colorSystem: this.colorSystem,
-            };
-            const lines = [];
-            const boundsList = [];
-            // [LAW:single-enforcer] Populated by pass 2 below. Pass 2 is the only
-            // place that decides whether a widget's overlay produced visible rows
-            // this frame — exactly where the z-order discriminator belongs.
-            const activeOverlays = new Set();
-            // Layout cursor for flow placement. `cursorY` is the next free row.
-            // `lastFlowRow` tracks the most recent flow/inline row so that a
-            // following inline placement can pack against its right edge.
-            let cursorY = 0;
-            let lastFlowRow = null;
-            // Pass 1 — base layout. Each widget contributes its inline footprint
-            // (Renderable.render). Position is determined by the widget's Placement.
-            for (const widget of this.widgetList) {
-                // [LAW:dataflow-not-control-flow] Hidden widgets still pass through the
-                // pipeline — their data just produces zero rows and zero-size bounds.
-                // The same operations execute every iteration.
-                const visible = widget.visible;
-                const segments = visible ? Array.from(widget.render(renderOptions)) : [];
-                const rawLines = visible ? Segment.splitLines(segments) : [];
-                const placement = this.placements.get(widget) ?? FLOW;
-                // [LAW:types-are-the-program] Single total switch on the discriminated
-                // union: every legal placement gets exactly one branch, the compiler
-                // enforces exhaustiveness, and the rest of the pipeline (clip to the
-                // remaining screen width, paint into `lines`, record bounds) is
-                // identical for every kind. x/y come from the placement; the available
-                // width comes from `this.width - x`.
-                let x;
-                let y;
-                let prevAtPlacement = null;
-                switch (placement.kind) {
-                    case "flow":
-                        x = 0;
-                        y = cursorY;
-                        break;
-                    case "inline": {
-                        // Pack onto the most recent flow/inline row. If there is no prior
-                        // row (inline used as the first item), fall back to flow at x=0.
-                        prevAtPlacement = lastFlowRow;
-                        if (prevAtPlacement === null) {
-                            x = 0;
-                            y = cursorY;
-                        }
-                        else {
-                            x = prevAtPlacement.rightX + (prevAtPlacement.rightX > 0 ? 1 : 0);
-                            y = prevAtPlacement.startY;
-                        }
-                        break;
-                    }
-                    case "fixed":
-                        x = placement.x;
-                        y = placement.y;
-                        break;
-                }
-                // [LAW:single-enforcer] Clip widget lines to the remaining screen
-                // width here so widget bounds match what actually gets painted. A
-                // renderable that emits more cells than its allotted slot (rogue
-                // widget, or an inline placement overflowing the screen edge) would
-                // otherwise compute bounds wider than reality, breaking hit-testing
-                // and the inline rightX that subsequent inline widgets pack against.
-                const available = Math.max(0, width - x);
-                const widgetLines = available > 0
-                    ? rawLines.map((line) => Segment.adjustLineLength(line, available, undefined, false))
-                    : [];
-                const [w, h] = Segment.getShape(widgetLines);
-                paintLines(lines, widgetLines, x, y);
-                if (placement.kind === "flow" && h > 0) {
-                    cursorY = y + h;
-                    lastFlowRow = { startY: y, height: h, rightX: x + w };
-                }
-                else if (placement.kind === "inline" && h > 0) {
-                    const rowStart = prevAtPlacement?.startY ?? y;
-                    const rowHeight = Math.max(prevAtPlacement?.height ?? 0, h);
-                    cursorY = Math.max(cursorY, rowStart + rowHeight);
-                    lastFlowRow = { startY: rowStart, height: rowHeight, rightX: x + w };
-                }
-                // Fixed placements never advance the flow cursor — they are
-                // independent anchors. paintLines grows the canvas as needed.
-                boundsList.push({ widget, bounds: { x, y, width: w, height: h } });
-            }
-            // Pass 2 — overlays. Widgets that implement OverlayRenderable paint
-            // ON TOP of the frame, anchored directly below their inline footprint.
-            // Render order = z-order: the overlay pass runs last, so overlay rows
-            // overwrite anything that was placed below the widget by pass 1.
-            // [LAW:single-enforcer] Overlay placement, bounds-union, AND z-order
-            // for hit-testing all happen here; widgets never draw their own
-            // overlays and the router never re-derives z-order. Each widget that
-            // produces visible overlay rows is added to `activeOverlays` so the
-            // `widgets` getter can surface it as topmost.
-            for (const entry of boundsList) {
-                const widget = entry.widget;
-                if (!widget.visible)
-                    continue;
-                if (!hasOverlay(widget))
-                    continue;
-                const overlaySegs = widget.renderOverlay(renderOptions);
-                if (overlaySegs === null)
-                    continue;
-                const overlayRawLines = Segment.splitLines(Array.from(overlaySegs));
-                if (overlayRawLines.length === 0)
-                    continue;
-                // [LAW:single-enforcer] Same per-line clip as the base pass — bounds
-                // (used for hit-testing the overlay) match the painted output.
-                const overlayAvailable = Math.max(0, width - entry.bounds.x);
-                const overlayLines = overlayAvailable > 0
-                    ? overlayRawLines.map((line) => Segment.adjustLineLength(line, overlayAvailable, undefined, false))
-                    : [];
-                if (overlayLines.length === 0)
-                    continue;
-                const startY = entry.bounds.y + entry.bounds.height;
-                paintLines(lines, overlayLines, entry.bounds.x, startY);
-                const [overlayW] = Segment.getShape(overlayLines);
-                entry.bounds = {
-                    x: entry.bounds.x,
-                    y: entry.bounds.y,
-                    width: Math.max(entry.bounds.width, overlayW),
-                    height: entry.bounds.height + overlayLines.length,
-                };
-                activeOverlays.add(widget);
-            }
-            return { width, lines, bounds: boundsList, activeOverlays };
-        }
-        scheduleRender() {
-            if (this.renderScheduled)
-                return;
-            this.renderScheduled = true;
-            queueMicrotask(() => {
-                this.renderScheduled = false;
-                if (this._running)
-                    this.draw();
-            });
-        }
-        draw() {
-            // [LAW:single-enforcer] One frame per tick. The autorun populates
-            // `pendingFrame`; we consume it here. Fall back to a fresh compute if
-            // draw is reached without a pending frame (test paths that call draw
-            // outside the autorun, or the very first frame before autorun fired).
-            const frame = this.pendingFrame ?? this.computeFrame();
-            this.pendingFrame = null;
-            const { width, lines, bounds, activeOverlays } = frame;
-            // [LAW:single-enforcer] Bounds are written here, the only place that
-            // computes layout. `bounds` is a plain field (see widget-base.ts) — no
-            // MobX action required.
-            for (const { widget, bounds: b } of bounds)
-                widget.bounds = b;
-            // [LAW:single-enforcer] Hit-test z-order is published by the same
-            // pass that wrote the bounds. The `widgets` getter reads this set to
-            // partition `widgetList` into [base, overlay-active] so EventRouter's
-            // topmostHit sees overlay owners as topmost.
-            this._activeOverlays = activeOverlays;
-            const newCount = lines.length;
-            const drawCount = Math.max(newCount, this.lastLineCount);
-            // [LAW:types-are-the-program] After the previous frame wrote N lines
-            // with N-1 newlines between them, the cursor sits at end-of-row-N (no
-            // trailing newline). Rewinding to the top of the frame is N-1 rows up
-            // plus a CR. `\x1b[0A` is still one row up on some terminals, so we
-            // skip the CSI entirely when there's only one row to overwrite.
-            let buf = "";
-            if (this.lastLineCount > 1) {
-                buf += `\x1b[${this.lastLineCount - 1}A`;
-            }
-            buf += "\r";
-            for (let i = 0; i < drawCount; i++) {
-                const line = lines[i];
-                if (line) {
-                    // [LAW:single-enforcer] Clip each line to terminal width so wide
-                    // content can't soft-wrap and break the "1 frame row = 1 terminal
-                    // row" invariant the redraw loop depends on. Without this, a wrapped
-                    // line shifts every later row down by one terminal cell, which
-                    // misaligns overlays and leaves wrap-continuation residue when later
-                    // frames write narrower content over the same logical row.
-                    // Use the frame's captured width, not a re-read of this.width —
-                    // see FrameLayout for the rationale.
-                    const clipped = Segment.adjustLineLength(line, width, undefined, false);
-                    buf += segmentsToString(clipped, this.colorSystem);
-                }
-                // [LAW:single-enforcer] Erase-to-end-of-line is the single mechanism
-                // for overwriting stale content. We do not pre-clear lines.
-                buf += "\x1b[K";
-                if (i < drawCount - 1)
-                    buf += "\n";
-            }
-            this.host.write(buf);
-            this.lastLineCount = drawCount;
-        }
-    };
-})();
-export { DefaultScreen };
-// [LAW:single-enforcer] One function resolves the color-system spec into a
-// ColorDepth (or null). String specs route through resolveColorSystem; enum
-// values pass through; null/`"none"` strip color.
-function resolveSpec(spec, isTTY) {
-    if (spec === null)
-        return null;
-    if (spec === undefined)
-        return resolveColorSystem("auto", { isTTY });
-    if (typeof spec === "string")
-        return resolveColorSystem(spec, { isTTY });
-    return spec;
-}
-// Normalize a MountEntry into its internal { widget, placement } form.
-// Bare widgets default to flow placement so existing call sites (and tests)
-// that pass `mount(a, b, c)` keep working unchanged.
-function normalizeEntry(entry) {
-    if ("widget" in entry && "placement" in entry) {
-        validatePlacement(entry.placement);
-        return { widget: entry.widget, placement: entry.placement };
-    }
-    return { widget: entry, placement: FLOW };
-}
-// [LAW:types-are-the-program] mount() is the trust boundary for placements.
-// `x` and `y` are typed as `number` but the layout pipeline assumes
-// non-negative integers — negative coordinates would index out of bounds in
-// paintLines and either crash on bang-asserts or silently skip rows. Reject
-// at construction so the rest of the pipeline can assume validity.
-function validatePlacement(p) {
-    if (p.kind !== "fixed")
-        return;
-    if (!Number.isInteger(p.x) || !Number.isInteger(p.y) || p.x < 0 || p.y < 0) {
-        throw new RangeError(`fixed Placement requires non-negative integer x and y; got (${p.x}, ${p.y})`);
-    }
-}
-// Paint `widgetLines` into the frame `lines` at top-left (x, y). Grows the
-// frame as needed and uses cell-accurate splice semantics so a fixed
-// placement or overlay overwrites whatever was painted earlier underneath.
-//
-// [LAW:single-enforcer] All compositing into the frame buffer goes through
-// this function. flow/inline/fixed placements and the overlay pass all call
-// it, so the rules for "how characters land at (x, y)" live in one place.
-function paintLines(lines, widgetLines, x, y) {
-    if (widgetLines.length === 0)
-        return;
-    while (lines.length < y + widgetLines.length)
-        lines.push([]);
-    for (let i = 0; i < widgetLines.length; i++) {
-        const target = lines[y + i];
-        const source = widgetLines[i];
-        const sourceWidth = lineCellLength(source);
-        if (sourceWidth === 0)
-            continue;
-        if (x === 0 && target.length === 0) {
-            lines[y + i] = source.slice();
-            continue;
-        }
-        lines[y + i] = spliceCells(target, asCellCol(x), sourceWidth, source);
-    }
-}
-function lineCellLength(line) {
-    let total = 0;
-    for (const s of line)
-        total += s.cellLength;
-    return asCellCol(total);
-}
-// Return a new row with cells [start, start+length) replaced by
-// `replacement`. Pads the prefix with spaces if `row` is shorter than
-// `start`. Honors wide characters and styled segments by splitting at cell
-// boundaries.
-function spliceCells(row, start, length, replacement) {
-    const rowWidth = lineCellLength(row);
-    const padded = row.slice();
-    if (rowWidth < start) {
-        padded.push(new Segment(" ".repeat(start - rowWidth)));
-    }
-    const prefix = [];
-    const suffix = [];
-    let cursor = 0;
-    for (const seg of padded) {
-        const segEnd = cursor + seg.cellLength;
-        if (segEnd <= start) {
-            prefix.push(seg);
-        }
-        else if (cursor >= start + length) {
-            suffix.push(seg);
-        }
-        else {
-            if (cursor < start) {
-                const [head] = seg.splitCells(asCellCol(start - cursor));
-                if (head.hasText)
-                    prefix.push(head);
-            }
-            if (segEnd > start + length) {
-                const [, tail] = seg.splitCells(asCellCol(start + length - cursor));
-                if (tail.hasText)
-                    suffix.push(tail);
-            }
-        }
-        cursor = segEnd;
-    }
-    return [...prefix, ...replacement, ...suffix];
-}

package/dist/widgets/slider.d.ts

@@ -1,57 +0,0 @@
-/**
- * Slider widget — numeric value within [min, max] with step increments.
- * [LAW:dataflow-not-control-flow] every render emits exactly `width`
- * track cells; the marker cell index is data, not a branch.
- * [LAW:one-type-per-behavior] shared infrastructure inherited from
- * WidgetBase.
- *
- * Visual:
- *   track    — `width` cells of "─" (ASCII fallback "-")
- *   marker   — "●" (ASCII fallback "*") at round((value - min) / range * (width - 1))
- *   filled   — cells left of and including the marker use primary fg
- *              on the default terminal bg
- *   unfilled — cells right of the marker use surface fg on the default
- *              terminal bg (no explicit bgcolor — the unfilled track
- *              should sit transparently against whatever the panel /
- *              parent paints underneath)
- *   focused  — underline on the segments
- *   disabled — dim
- */
-import { Segment } from "../core/segment.js";
-import type { RenderOptions } from "../core/protocol.js";
-import type { TerminalTheme } from "../core/color.js";
-import { WidgetBase } from "./widget-base.js";
-import type { KeyEvent, WidgetMouseEvent } from "./types.js";
-export interface SliderOptions {
-    value?: number;
-    min?: number;
-    max?: number;
-    step?: number;
-    width?: number;
-    id?: string;
-    disabled?: boolean;
-    theme?: TerminalTheme;
-}
-export declare class Slider extends WidgetBase {
-    readonly id: string;
-    readonly focusable = true;
-    accessor value: number;
-    accessor min: number;
-    accessor max: number;
-    accessor step: number;
-    accessor width: number;
-    private accessor _theme;
-    private _dragging;
-    constructor(options?: SliderOptions);
-    setTheme(theme: TerminalTheme): void;
-    handleKey(event: KeyEvent): void;
-    handleMouse(event: WidgetMouseEvent): void;
-    private setValue;
-    private setValueFromMouseX;
-    render(options: RenderOptions): Iterable<Segment>;
-    measure(_options: RenderOptions): {
-        minimum: number;
-        maximum: number;
-    };
-    private resolvePalette;
-}