@promptctl/rich-js 0.17.0 → 0.18.0

package/dist/widgets/focus-manager.js

@@ -1,193 +0,0 @@
-/**
- * FocusManager — flat focus cycling over registered widgets.
- * [LAW:one-source-of-truth] single authority for which widget has focus.
- * [LAW:dataflow-not-control-flow] focus transitions are observable state;
- * widgets react to focus/blur events, the manager never skips dispatch.
- */
-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;
-};
-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;
-};
-import { action, observableRef, observableShallow } from "mobx";
-let DefaultFocusManager = (() => {
-    let _instanceExtraInitializers = [];
-    let _widgetList_decorators;
-    let _widgetList_initializers = [];
-    let _widgetList_extraInitializers = [];
-    let _currentWidget_decorators;
-    let _currentWidget_initializers = [];
-    let _currentWidget_extraInitializers = [];
-    let _register_decorators;
-    let _unregister_decorators;
-    let _next_decorators;
-    let _prev_decorators;
-    let _focus_decorators;
-    let _blur_decorators;
-    let _setFocus_decorators;
-    return class DefaultFocusManager {
-        static {
-            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
-            _widgetList_decorators = [observableShallow];
-            _currentWidget_decorators = [observableRef];
-            _register_decorators = [action];
-            _unregister_decorators = [action];
-            _next_decorators = [action];
-            _prev_decorators = [action];
-            _focus_decorators = [action];
-            _blur_decorators = [action];
-            _setFocus_decorators = [action];
-            __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);
-            __esDecorate(this, null, _currentWidget_decorators, { kind: "accessor", name: "currentWidget", static: false, private: false, access: { has: obj => "currentWidget" in obj, get: obj => obj.currentWidget, set: (obj, value) => { obj.currentWidget = value; } }, metadata: _metadata }, _currentWidget_initializers, _currentWidget_extraInitializers);
-            __esDecorate(this, null, _register_decorators, { kind: "method", name: "register", static: false, private: false, access: { has: obj => "register" in obj, get: obj => obj.register }, metadata: _metadata }, null, _instanceExtraInitializers);
-            __esDecorate(this, null, _unregister_decorators, { kind: "method", name: "unregister", static: false, private: false, access: { has: obj => "unregister" in obj, get: obj => obj.unregister }, metadata: _metadata }, null, _instanceExtraInitializers);
-            __esDecorate(this, null, _next_decorators, { kind: "method", name: "next", static: false, private: false, access: { has: obj => "next" in obj, get: obj => obj.next }, metadata: _metadata }, null, _instanceExtraInitializers);
-            __esDecorate(this, null, _prev_decorators, { kind: "method", name: "prev", static: false, private: false, access: { has: obj => "prev" in obj, get: obj => obj.prev }, metadata: _metadata }, null, _instanceExtraInitializers);
-            __esDecorate(this, null, _focus_decorators, { kind: "method", name: "focus", static: false, private: false, access: { has: obj => "focus" in obj, get: obj => obj.focus }, metadata: _metadata }, null, _instanceExtraInitializers);
-            __esDecorate(this, null, _blur_decorators, { kind: "method", name: "blur", static: false, private: false, access: { has: obj => "blur" in obj, get: obj => obj.blur }, metadata: _metadata }, null, _instanceExtraInitializers);
-            __esDecorate(this, null, _setFocus_decorators, { kind: "method", name: "setFocus", static: false, private: false, access: { has: obj => "setFocus" in obj, get: obj => obj.setFocus }, metadata: _metadata }, null, _instanceExtraInitializers);
-            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-        }
-        #widgetList_accessor_storage = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _widgetList_initializers, []));
-        get widgetList() { return this.#widgetList_accessor_storage; }
-        set widgetList(value) { this.#widgetList_accessor_storage = value; }
-        #currentWidget_accessor_storage = (__runInitializers(this, _widgetList_extraInitializers), __runInitializers(this, _currentWidget_initializers, null));
-        get currentWidget() { return this.#currentWidget_accessor_storage; }
-        set currentWidget(value) { this.#currentWidget_accessor_storage = value; }
-        changeHandlers = (__runInitializers(this, _currentWidget_extraInitializers), new Set());
-        get current() {
-            return this.currentWidget;
-        }
-        get widgets() {
-            return this.widgetList;
-        }
-        register(widget) {
-            // [LAW:one-source-of-truth] register is idempotent — the widgetList is
-            // a set in spirit, not a multiset. Without this guard, double-registration
-            // would duplicate the widget so next/prev cycle through it twice and
-            // unregister only removes one copy.
-            if (this.widgetList.includes(widget))
-                return;
-            this.widgetList = [...this.widgetList, widget];
-            if (!this.currentWidget && widget.focusable && !widget.disabled) {
-                this.setFocus(widget);
-            }
-        }
-        unregister(widget) {
-            const idx = this.widgetList.indexOf(widget);
-            if (idx === -1)
-                return;
-            this.widgetList = this.widgetList.filter((w) => w !== widget);
-            if (this.currentWidget === widget) {
-                // [LAW:single-enforcer] WidgetBase.focus()/blur() already route through
-                // handleFocus, so calling both would double-dispatch and trigger any
-                // subclass side effect (e.g. Dropdown clearing filter/overlay) twice.
-                widget.blur();
-                const next = this.widgetList.find((w) => w.focusable && !w.disabled) ?? null;
-                if (next)
-                    next.focus();
-                this.currentWidget = next;
-                this.emitChange();
-            }
-        }
-        next() {
-            const focusable = this.focusableWidgets();
-            if (focusable.length === 0)
-                return;
-            const currentIdx = this.currentWidget ? focusable.indexOf(this.currentWidget) : -1;
-            const nextIdx = (currentIdx + 1) % focusable.length;
-            this.setFocus(focusable[nextIdx]);
-        }
-        prev() {
-            const focusable = this.focusableWidgets();
-            if (focusable.length === 0)
-                return;
-            const currentIdx = this.currentWidget ? focusable.indexOf(this.currentWidget) : -1;
-            const prevIdx = currentIdx <= 0 ? focusable.length - 1 : currentIdx - 1;
-            this.setFocus(focusable[prevIdx]);
-        }
-        focus(widget) {
-            if (!widget.focusable || widget.disabled)
-                return;
-            if (!this.widgetList.includes(widget))
-                return;
-            this.setFocus(widget);
-        }
-        blur() {
-            if (!this.currentWidget)
-                return;
-            // [LAW:single-enforcer] blur() already dispatches handleFocus on
-            // WidgetBase — see unregister() for the rationale.
-            this.currentWidget.blur();
-            this.currentWidget = null;
-            this.emitChange();
-        }
-        onChange(handler) {
-            this.changeHandlers.add(handler);
-            return () => this.changeHandlers.delete(handler);
-        }
-        // [LAW:single-enforcer] FocusManager owns Tab/Shift+Tab semantics. The
-        // router registers this as a normal-priority handler at construction —
-        // it runs after the focused widget, so a widget can `event.stop()`
-        // to suppress traversal (e.g. Dropdown when its overlay is open).
-        handleKey(event) {
-            if (event.key !== "tab")
-                return;
-            if (event.shift)
-                this.prev();
-            else
-                this.next();
-            event.stop();
-        }
-        // --- Private ---
-        focusableWidgets() {
-            return this.widgetList.filter((w) => w.focusable && !w.disabled);
-        }
-        setFocus(widget) {
-            if (this.currentWidget === widget)
-                return;
-            // [LAW:single-enforcer] focus()/blur() already dispatch handleFocus —
-            // see unregister() for the rationale.
-            if (this.currentWidget)
-                this.currentWidget.blur();
-            this.currentWidget = widget;
-            widget.focus();
-            this.emitChange();
-        }
-        emitChange() {
-            for (const handler of this.changeHandlers) {
-                handler(this.currentWidget);
-            }
-        }
-    };
-})();
-export { DefaultFocusManager };

package/dist/widgets/index.d.ts

@@ -1,22 +0,0 @@
-export type { KeyEventInit, KeyHandlerPriority, KeyHandlerOptions, WidgetMouseEvent, WidgetFocusEvent, WidgetBounds, InteractiveWidget, OverlayRenderable, FocusManager, Screen, MountEntry, Placement, } from "./types.js";
-export { FLOW, hasOverlay, KeyEvent } from "./types.js";
-export { StaticItem } from "./static-item.js";
-export type { StaticItemOptions } from "./static-item.js";
-export { WidgetBase } from "./widget-base.js";
-export { DefaultFocusManager } from "./focus-manager.js";
-export { DefaultScreen } from "./screen.js";
-export type { ScreenOptions, ColorSystemSpec } from "./screen.js";
-export { Button } from "./button.js";
-export type { ButtonVariant, ButtonOptions } from "./button.js";
-export { Checkbox } from "./checkbox.js";
-export type { CheckboxOptions } from "./checkbox.js";
-export { Toggle } from "./toggle.js";
-export type { ToggleVariant, ToggleOptions } from "./toggle.js";
-export { TextInput, charGreedyWrap } from "./text-input.js";
-export type { TextInputOptions, WrapStrategy, WrapRow } from "./text-input.js";
-export { Dropdown } from "./dropdown.js";
-export type { DropdownOptions } from "./dropdown.js";
-export { Slider } from "./slider.js";
-export type { SliderOptions } from "./slider.js";
-export { EventRouter } from "./event-router.js";
-export type { EventRouterOptions } from "./event-router.js";

package/dist/widgets/index.js

@@ -1,15 +0,0 @@
-export { FLOW, hasOverlay, KeyEvent } from "./types.js";
-export { StaticItem } from "./static-item.js";
-export { WidgetBase } from "./widget-base.js";
-export { DefaultFocusManager } from "./focus-manager.js";
-export { DefaultScreen } from "./screen.js";
-export { Button } from "./button.js";
-export { Checkbox } from "./checkbox.js";
-export { Toggle } from "./toggle.js";
-export { TextInput, charGreedyWrap } from "./text-input.js";
-export { Dropdown } from "./dropdown.js";
-export { Slider } from "./slider.js";
-export { EventRouter } from "./event-router.js";
-// The terminal seam is not re-exported here. It lives on the `host` subpath,
-// and a second path to `TerminalHost` would be the two-clocks problem the
-// subpath split exists to remove.

package/dist/widgets/screen.d.ts

@@ -1,98 +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.
- */
-import { ColorDepth } from "../core/color.js";
-import type { Screen, InteractiveWidget, FocusManager, MountEntry } from "./types.js";
-import type { TerminalHost } from "../host/terminal-host.js";
-export type ColorSystemSpec = ColorDepth | "auto" | "truecolor" | "256" | "ansi" | "none" | null;
-export interface ScreenOptions {
-    /**
-     * The I/O capability the screen renders against. Construct a
-     * `NodeTerminalHost` for production node demos, or pass a host that
-     * wraps mock streams for tests. The seam is the type — Screen never
-     * reaches for `process.*`.
-     */
-    host: TerminalHost;
-    width?: number;
-    colorSystem?: ColorSystemSpec;
-    focusManager?: FocusManager;
-    /**
-     * When true (default when the host reports `isTTY`), hide the cursor
-     * on start and restore it on stop. Disable for non-TTY output and tests.
-     */
-    manageCursor?: boolean;
-}
-export declare class DefaultScreen implements Screen {
-    readonly focusManager: FocusManager;
-    accessor widgetList: InteractiveWidget[];
-    private readonly placements;
-    private _activeOverlays;
-    private _running;
-    private autorunDispose;
-    private renderScheduled;
-    private pendingFrame;
-    private lastLineCount;
-    private readonly host;
-    private readonly widthOverride;
-    private readonly destination;
-    private readonly manageCursor;
-    constructor(options: ScreenOptions);
-    get running(): boolean;
-    get widgets(): readonly InteractiveWidget[];
-    mount(...entries: MountEntry[]): void;
-    unmount(widget: InteractiveWidget): void;
-    start(): void;
-    stop(): void;
-    private get width();
-    private computeFrame;
-    private scheduleRender;
-    private draw;
-}