@promptctl/rich-js 0.1.0

package/dist/widgets/focus-manager.js

@@ -0,0 +1,179 @@
+/**
+ * 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 { makeObservable, observable, action } from "mobx";
+let DefaultFocusManager = (() => {
+    var _a, _b;
+    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 = [(_a = observable).shallow.bind(_a)];
+            _currentWidget_decorators = [(_b = observable).ref.bind(_b)];
+            _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());
+        constructor() {
+            makeObservable(this);
+        }
+        get current() {
+            return this.currentWidget;
+        }
+        get widgets() {
+            return this.widgetList;
+        }
+        register(widget) {
+            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) {
+                widget.blur();
+                widget.handleFocus({ type: "blur" });
+                const next = this.widgetList.find((w) => w.focusable && !w.disabled) ?? null;
+                if (next) {
+                    next.focus();
+                    next.handleFocus({ type: "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;
+            this.currentWidget.blur();
+            this.currentWidget.handleFocus({ type: "blur" });
+            this.currentWidget = null;
+            this.emitChange();
+        }
+        onChange(handler) {
+            this.changeHandlers.add(handler);
+            return () => this.changeHandlers.delete(handler);
+        }
+        // --- Private ---
+        focusableWidgets() {
+            return this.widgetList.filter((w) => w.focusable && !w.disabled);
+        }
+        setFocus(widget) {
+            if (this.currentWidget === widget)
+                return;
+            if (this.currentWidget) {
+                this.currentWidget.blur();
+                this.currentWidget.handleFocus({ type: "blur" });
+            }
+            this.currentWidget = widget;
+            widget.focus();
+            widget.handleFocus({ type: "focus" });
+            this.emitChange();
+        }
+        emitChange() {
+            for (const handler of this.changeHandlers) {
+                handler(this.currentWidget);
+            }
+        }
+    };
+})();
+export { DefaultFocusManager };
+//# sourceMappingURL=focus-manager.js.map

package/dist/widgets/focus-manager.js.map

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

package/dist/widgets/index.d.ts

@@ -0,0 +1,23 @@
+export type { KeyEvent, WidgetMouseEvent, WidgetFocusEvent, WidgetBounds, InteractiveWidget, OverlayRenderable, FocusManager, Screen, MountEntry, Placement, Unsubscribe, } from "./types.js";
+export { FLOW, hasOverlay } 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 } from "./text-input.js";
+export type { TextInputOptions } 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";
+//# sourceMappingURL=index.d.ts.map

package/dist/widgets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/widgets/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,MAAM,EACN,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/widgets/index.js

@@ -0,0 +1,13 @@
+export { FLOW, hasOverlay } 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 } from "./text-input.js";
+export { Dropdown } from "./dropdown.js";
+export { Slider } from "./slider.js";
+export { EventRouter } from "./event-router.js";
+//# sourceMappingURL=index.js.map

package/dist/widgets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/widgets/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/widgets/screen.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 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";
+export type ColorSystemSpec = ColorDepth | "auto" | "truecolor" | "256" | "ansi" | "none" | null;
+export interface ScreenOptions {
+    out?: NodeJS.WritableStream;
+    width?: number;
+    colorSystem?: ColorSystemSpec;
+    focusManager?: FocusManager;
+    /**
+     * When true (default when stdout is a TTY), 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 _running;
+    private autorunDispose;
+    private renderScheduled;
+    private lastLineCount;
+    private readonly out;
+    private readonly widthOverride;
+    private readonly colorSystem;
+    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;
+}
+//# sourceMappingURL=screen.d.ts.map

package/dist/widgets/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../src/widgets/screen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAKH,OAAO,EAAE,UAAU,EAAsB,MAAM,kBAAkB,CAAC;AAIlE,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,UAAU,EAGX,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,MAAM,GACN,WAAW,GACX,KAAK,GACL,MAAM,GACN,MAAM,GACN,IAAI,CAAC;AAET,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AASD,qBAAa,aAAc,YAAW,MAAM;IAC1C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAKpC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,CAAM;IAM9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2C;IAEtE,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;gBAE3B,OAAO,GAAE,aAAkB;IAYvC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,IAAI,SAAS,iBAAiB,EAAE,CAE1C;IAID,KAAK,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAcrC,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAUxC,KAAK,IAAI,IAAI;IAgBb,IAAI,IAAI,IAAI;IAeZ,OAAO,KAAK,KAAK,GAIhB;IAED,OAAO,CAAC,YAAY;IA+GpB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,IAAI;CAsCb"}